Skip to content

fix(types): drop accidental BasicUpload public re-export (SD-2893)#3151

Merged
caio-pizzol merged 1 commit intomainfrom
caio-pizzol/SD-2893-stack-4-basicupload
May 5, 2026
Merged

fix(types): drop accidental BasicUpload public re-export (SD-2893)#3151
caio-pizzol merged 1 commit intomainfrom
caio-pizzol/SD-2893-stack-4-basicupload

Conversation

@caio-pizzol
Copy link
Copy Markdown
Contributor

Drains the fourth shim entry by removing the accidental public re-export of BasicUpload. Shim count: 3 to 2.

BasicUpload was re-exported through superdoc/super-editor and superdoc despite being marked @internal at the export site itself (editors/v1/index.js:103). Customer-use audit found:

  • No mention in any README, AGENTS guide, or app docs.
  • No usage in any example app source (only cached/build artifacts).
  • Both internal dev tools (SuperdocDev.vue, DeveloperPlayground.vue) import it directly from @superdoc/common/components/BasicUpload.vue, never via the public re-export.

Dropping the re-export is cleaner than relocating the .vue file because the widget is dev-tooling, not a documented public component. The shim entry for @superdoc/common/components/BasicUpload.vue goes away because nothing on the public surface references it anymore.

The consumer-typecheck customer-scenario.ts fixture was the only place the public re-export was exercised. Removed the assertion there too so the matrix stays green; this is consistent with the SD-2828 contract that public-facing assertions track the actual public surface.

Remaining shims (2): @superdoc/common (5 dist refs, catch-all bin), @superdoc/style-engine/ooxml (10 dist refs). Each needs exploratory work, not the simple dropping or relocation pattern.

Verified:

  • pnpm --filter superdoc build:es clean (audit OK, 8 guarded packages, 2 shim modules)
  • Consumer matrix: 47 passed, 0 failed, 0 warnings
  • Runtime smoke 4/4 against the freshly-packed tarball, including explicit assert.equal(m.BasicUpload, undefined) on both superdoc and superdoc/super-editor entries

BasicUpload was re-exported through `superdoc/super-editor` and
`superdoc` despite being marked `@internal` at the export site
(packages/super-editor/src/editors/v1/index.js:103). It is not
documented in any README, AGENTS guide, or example. The two dev
components that use it (SuperdocDev.vue, DeveloperPlayground.vue)
import it directly from `@superdoc/common/components/BasicUpload.vue`,
not via the public re-export.

Drop the re-export rather than relocating the .vue file. The upload
widget is dev-tooling, not a public API. The bare
`@superdoc/common/components/BasicUpload.vue` shim entry goes away
because no public d.ts file references it anymore.

Also removes the BasicUpload assertion from the consumer-typecheck
customer-scenario fixture so the matrix stays green; the fixture
was the only place the public re-export was exercised.

Shim count: 3 to 2. Remaining: @superdoc/common (5 dist refs,
catch-all bin), @superdoc/style-engine/ooxml (10 dist refs).

Verified: build:es clean (8 guarded packages, 2 shim modules),
consumer matrix 47/0/0, runtime smoke 4/4 with BasicUpload
explicitly asserted absent from main and super-editor entries.
@caio-pizzol caio-pizzol requested a review from a team as a code owner May 5, 2026 11:23
@linear
Copy link
Copy Markdown

linear Bot commented May 5, 2026

@codecov-commenter
Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@caio-pizzol caio-pizzol merged commit ddc751a into main May 5, 2026
71 checks passed
@caio-pizzol caio-pizzol deleted the caio-pizzol/SD-2893-stack-4-basicupload branch May 5, 2026 11:41
@superdoc-bot
Copy link
Copy Markdown
Contributor

superdoc-bot Bot commented May 5, 2026

🎉 This PR is included in @superdoc-dev/mcp v0.3.0-next.50

The release is available on GitHub release

@superdoc-bot
Copy link
Copy Markdown
Contributor

superdoc-bot Bot commented May 5, 2026

🎉 This PR is included in @superdoc-dev/react v1.2.0-next.92

The release is available on GitHub release

@superdoc-bot
Copy link
Copy Markdown
Contributor

superdoc-bot Bot commented May 5, 2026

🎉 This PR is included in vscode-ext v2.3.0-next.94

@superdoc-bot
Copy link
Copy Markdown
Contributor

superdoc-bot Bot commented May 5, 2026

🎉 This PR is included in superdoc-sdk v1.8.0-next.53

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants