Skip to content

docs: clarify tsdown-migrate skill and deprecated options#835

Merged
sxzz merged 2 commits into
mainfrom
sxzz/migrate-skill
Mar 16, 2026
Merged

docs: clarify tsdown-migrate skill and deprecated options#835
sxzz merged 2 commits into
mainfrom
sxzz/migrate-skill

Conversation

@sxzz

@sxzz sxzz commented Mar 16, 2026

Copy link
Copy Markdown
Member

Summary

Completed the tsdown-migrate skill with comprehensive migration guidance for AI agents. Clarified which tsup options are deprecated-but-compatible (still work in tsdown) versus truly unsupported.

Key changes:

  • New tsdown-migrate skill with config transformation rules, default differences, and package.json migration guidance for AI-driven migrations
  • Deprecated-but-compatible options clearly distinguished (entryPoints, publicDir, bundle, removeNodeProtocol, injectStyle, external, noExternal, skipNodeModulesBundle)
  • Property renames simplified to actual renames only (cjsInterop, esbuildPlugins)
  • Removed shims from new features (exists in tsup too)
  • Updated both EN and CN docs to match skill guidance
  • Added migration guide links to main skills documentation

The skill teaches AI agents HOW to migrate (option mappings, config transforms, defaults to preserve) rather than running a CLI tool, enabling more intelligent migrations.

Distinguish between deprecated-but-compatible options (still work but emit warnings and will be removed) and truly unsupported options.

Changes:
- Categorize entryPoints, publicDir, bundle, removeNodeProtocol, injectStyle, external, noExternal, skipNodeModulesBundle as "deprecated but compatible" (still work in tsdown but will be removed)
- Note that entryPoints is also deprecated in tsup itself
- Remove shims from new features (exists in tsup too)
- Add skipNodeModulesBundle to migration guide (was missing)
- Simplify property renames section to only include actual renames (cjsInterop, esbuildPlugins)
- Update both English and Chinese documentation and skill files

This clarifies the migration path for users moving from tsup to tsdown.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
@netlify

netlify Bot commented Mar 16, 2026

Copy link
Copy Markdown

Deploy Preview for tsdown-main ready!

Name Link
🔨 Latest commit 0209c82
🔍 Latest deploy log https://app.netlify.com/projects/tsdown-main/deploys/69b811bc18c324000803c35d
😎 Deploy Preview https://deploy-preview-835--tsdown-main.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@pkg-pr-new

pkg-pr-new Bot commented Mar 16, 2026

Copy link
Copy Markdown

Open in StackBlitz

tsdown

pnpm add https://pkg.pr.new/tsdown@835 -D
npm i https://pkg.pr.new/tsdown@835 -D
yarn add https://pkg.pr.new/tsdown@835.tgz -D

create-tsdown

pnpm add https://pkg.pr.new/create-tsdown@835 -D
npm i https://pkg.pr.new/create-tsdown@835 -D
yarn add https://pkg.pr.new/create-tsdown@835.tgz -D

@tsdown/css

pnpm add https://pkg.pr.new/@tsdown/css@835 -D
npm i https://pkg.pr.new/@tsdown/css@835 -D
yarn add https://pkg.pr.new/@tsdown/css@835.tgz -D

@tsdown/exe

pnpm add https://pkg.pr.new/@tsdown/exe@835 -D
npm i https://pkg.pr.new/@tsdown/exe@835 -D
yarn add https://pkg.pr.new/@tsdown/exe@835.tgz -D

tsdown-migrate

pnpm add https://pkg.pr.new/tsdown-migrate@835 -D
npm i https://pkg.pr.new/tsdown-migrate@835 -D
yarn add https://pkg.pr.new/tsdown-migrate@835.tgz -D

commit: 0209c82

@sxzz sxzz merged commit d622ca5 into main Mar 16, 2026
15 checks passed
@sxzz sxzz deleted the sxzz/migrate-skill branch March 16, 2026 14:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant