Skip to content

chore: remove deprecated APIs - #4657

Draft
cixzhang wants to merge 5 commits into
mainfrom
chore/remove-deprecated-apis
Draft

chore: remove deprecated APIs#4657
cixzhang wants to merge 5 commits into
mainfrom
chore/remove-deprecated-apis

Conversation

@cixzhang

@cixzhang cixzhang commented Aug 2, 2026

Copy link
Copy Markdown
Contributor

Summary

Removes long-deprecated compatibility APIs across core and CLI now that the replacement surfaces and codemods have been available for a release cycle.

What changed

  • Drops deprecated core aliases/props for authoring types, theme transition shorthands, flat theme CSS output, TopNavHeading links, Grid responsive columns, Switch label spacing, Dialog positions, NavMenu item aliases, Calendar date formatting, and Table root props.
  • Keeps the deprecated Table row-expansion hooks/docs/templates in place; that API is being handled separately.
  • Removes the lab CodeBlock compatibility re-export; CodeBlock remains available from core.
  • Removes deprecated CLI compatibility helpers from component discovery and template list JSON responses.
  • Stages follow-up codemods in transforms/next for the newly removed APIs that still needed migration coverage.
  • Updates internal stories, sandbox examples, docs, and tests to use the supported replacements.

Migration

Run astryx upgrade before updating to migrate the supported replacement paths for authoring imports, Dialog logical positions, Switch label spacing, Table root props, TopNavHeading heading links, Grid responsive columns, NavMenu item aliases, lab CodeBlock imports, and deprecated theme transition token imports.

Testing

  • pnpm -F @astryxdesign/core typecheck
  • pnpm exec vitest run packages/core/src/Dialog/Dialog.test.tsx packages/core/src/TopNav/TopNav.test.tsx packages/core/src/Grid/Grid.test.tsx packages/core/src/Switch/Switch.test.tsx packages/core/src/Table/Table.test.tsx packages/core/src/NavMenu/NavHeadingMenu.test.tsx packages/core/src/theme/defineTheme.test.ts
  • pnpm exec vitest run packages/cli/foundation/discovery/component-discovery.test.mjs packages/cli/clients/cli/commands/component.test.mjs packages/cli/clients/cli/commands/json-contract.test.mjs
  • pnpm exec vitest run packages/cli/assets/codemods/transforms/next/__tests__/next-codemods.test.mjs packages/cli/clients/cli/commands/json-contract.test.mjs
  • pnpm exec vitest run packages/core/src/Table/plugins/rowExpansion/useTableRowExpansion.test.tsx packages/cli/assets/codemods/transforms/next/__tests__/next-codemods.test.mjs
  • node scripts/check-changesets.mjs && node scripts/sync-exports.js --check && node scripts/check-package-boundaries.js

Note: pnpm -F @astryxdesign/cli typecheck:strict currently reports unrelated theme-build API type errors on main after the rebase; the removed-template prop errors from this PR are fixed.

@vercel

vercel Bot commented Aug 2, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
astryx Ready Ready Preview Aug 4, 2026 2:18am

Request Review

@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Meta Open Source bot. label Aug 2, 2026
@github-actions github-actions Bot added the needs:design-review Affects visuals — Design should review label Aug 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Meta Open Source bot. needs:design-review Affects visuals — Design should review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant