@tamagui/cli 3.0.0-beta.889.1 → 3.0.0-beta.901.1

package/dist/migrate.cjs

@@ -109,6 +109,7 @@ add a compatibility setting or restore condition-object parsing.
 - Import animations from \`@tamagui/config/animations-css\`, \`animations-rn\`, \`animations-reanimated\`, or \`animations-motion\`.
 - Apps using Sheet or animated-number hooks with the CSS driver must import \`createAnimations\` from \`@tamagui/animations-css/extras\`. The root entry omits those hooks.
 - Remove \`@tamagui/theme-builder\` and any V5 builder imports. Static \`@tamagui/themes/v5\`, \`/v5-subtle\`, and \`/v5-tokens\` imports remain supported.
+- An app that GENERATES its v5 themes (\`createV5Theme\`, \`subtleChildrenThemes\`, \`createPalettes\`) has two ways to stay on v5 for this migration: run the builder once and serialize the result to a static literal, or import the same builders from \`@tamagui/config-v5\` (and \`@tamagui/config-v5/builder\`), the opt-in package that carries them. Take one of those when the themes are built from values the app only knows at runtime; the v6 recipe move below is a separate migration.
 - Use \`createThemes\`, \`levels\`, scales, and the other recipe helpers from \`@tamagui/themes/builder\`.
 - Remove \`componentThemes\`, \`templates\`, \`masks\`, \`childrenThemes\`, and \`grandChildrenThemes\`. Express hierarchy in the recipe tree, semantic values in scales, and exact one-theme overrides in \`values\`.
 - Component names no longer select uppercase theme segments automatically. Replace component themes with explicit normal theme or \`level2\` boundaries in component skins.
@@ -140,19 +141,10 @@ rg "@tamagui/theme-builder|v5-builder|createV5Theme|componentThemes|grandChildre
 
 ### 4. Migrate Sheet anatomy
 
-The v3 package does not ship a Sheet codemod. Migrate each callsite using the
-rules below.
-
-When working inside a Tamagui source checkout, you can run its source-only
-codemod first. Pass expanded file paths because the script does not expand a
-quoted glob:
-
-\`\`\`bash
-rg --files src -g '*.ts' -g '*.tsx' -0 \\
-  | xargs -0 node ./scripts/codemods/sheet-frame-to-container.js
-\`\`\`
-
-Migration rules:
+The flat-values codemod from step 1 rewrites every provable \`Sheet.Frame\` to
+\`Sheet.Container\` with a \`Sheet.Background\` first child carrying the surface
+props, and reports spreads and \`styled(Sheet.Frame, \u2026)\` targets for review.
+Check each rewritten callsite against these rules:
 
 - Replace \`Sheet.Frame\` with \`Sheet.Container\` plus \`Sheet.Background\`.
 - Keep layout props such as \`padding\`, \`gap\`, \`height\`, \`maxHeight\`, and flex props on \`Sheet.Container\`.
@@ -231,8 +223,9 @@ when behavior itself needs active responsive or theme state.
 ### 6. Replace true tokens
 
 - Default v3 configs no longer export the legacy \`$true\` token key.
-- Component default size resolves to bare \`4\`.
-- Replace authored \`$true\` tokens with real bare keys such as \`4\`.
+- The codemod writes \`$true\` on style props as \`4\` and reports a \`legacy-true-token\` warning; confirm the app's config aliased it there.
+- On \`size\`, \`elevation\`, and \`iconSize\` it writes the boolean \`true\`, which resolves to the component default size.
+- Token definitions and custom variants are not edited; search them for the alias by hand.
 - Do not change unrelated boolean props or boolean variant values.
 
 ### 7. Replace token stepping

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tamagui/cli",
-  "version": "3.0.0-beta.889.1",
+  "version": "3.0.0-beta.901.1",
   "bin": {
     "tama": "dist/index.cjs",
     "tamagui": "dist/index.cjs"
@@ -51,12 +51,12 @@
     "test:web": "bun run test"
   },
   "dependencies": {
-    "@tamagui/generate-themes": "3.0.0-beta.889.1",
-    "@tamagui/metro-plugin": "3.0.0-beta.889.1",
-    "@tamagui/static": "3.0.0-beta.889.1",
-    "@tamagui/to-tailwind": "3.0.0-beta.889.1",
-    "@tamagui/types": "3.0.0-beta.889.1",
-    "@tamagui/vite-plugin": "3.0.0-beta.889.1",
+    "@tamagui/generate-themes": "3.0.0-beta.901.1",
+    "@tamagui/metro-plugin": "3.0.0-beta.901.1",
+    "@tamagui/static": "3.0.0-beta.901.1",
+    "@tamagui/to-tailwind": "3.0.0-beta.901.1",
+    "@tamagui/types": "3.0.0-beta.901.1",
+    "@tamagui/vite-plugin": "3.0.0-beta.901.1",
     "arg": "^5.0.2",
     "chalk": "^4.1.2",
     "change-case": "^4.1.2",
@@ -75,10 +75,10 @@
     "ts-morph": "^28.0.0",
     "typescript": "~6.0.3",
     "url": "^0.11.0",
-    "@tamagui/language-service": "3.0.0-beta.889.1"
+    "@tamagui/language-service": "3.0.0-beta.901.1"
   },
   "devDependencies": {
-    "@tamagui/build": "3.0.0-beta.889.1",
+    "@tamagui/build": "3.0.0-beta.901.1",
     "@types/chokidar": "^2.1.3",
     "@types/marked": "^5.0.0",
     "vitest": "4.1.0"

package/src/migrate.ts

@@ -93,6 +93,7 @@ add a compatibility setting or restore condition-object parsing.
 - Import animations from \`@tamagui/config/animations-css\`, \`animations-rn\`, \`animations-reanimated\`, or \`animations-motion\`.
 - Apps using Sheet or animated-number hooks with the CSS driver must import \`createAnimations\` from \`@tamagui/animations-css/extras\`. The root entry omits those hooks.
 - Remove \`@tamagui/theme-builder\` and any V5 builder imports. Static \`@tamagui/themes/v5\`, \`/v5-subtle\`, and \`/v5-tokens\` imports remain supported.
+- An app that GENERATES its v5 themes (\`createV5Theme\`, \`subtleChildrenThemes\`, \`createPalettes\`) has two ways to stay on v5 for this migration: run the builder once and serialize the result to a static literal, or import the same builders from \`@tamagui/config-v5\` (and \`@tamagui/config-v5/builder\`), the opt-in package that carries them. Take one of those when the themes are built from values the app only knows at runtime; the v6 recipe move below is a separate migration.
 - Use \`createThemes\`, \`levels\`, scales, and the other recipe helpers from \`@tamagui/themes/builder\`.
 - Remove \`componentThemes\`, \`templates\`, \`masks\`, \`childrenThemes\`, and \`grandChildrenThemes\`. Express hierarchy in the recipe tree, semantic values in scales, and exact one-theme overrides in \`values\`.
 - Component names no longer select uppercase theme segments automatically. Replace component themes with explicit normal theme or \`level2\` boundaries in component skins.
@@ -124,19 +125,10 @@ rg "@tamagui/theme-builder|v5-builder|createV5Theme|componentThemes|grandChildre
 
 ### 4. Migrate Sheet anatomy
 
-The v3 package does not ship a Sheet codemod. Migrate each callsite using the
-rules below.
-
-When working inside a Tamagui source checkout, you can run its source-only
-codemod first. Pass expanded file paths because the script does not expand a
-quoted glob:
-
-\`\`\`bash
-rg --files src -g '*.ts' -g '*.tsx' -0 \\
-  | xargs -0 node ./scripts/codemods/sheet-frame-to-container.js
-\`\`\`
-
-Migration rules:
+The flat-values codemod from step 1 rewrites every provable \`Sheet.Frame\` to
+\`Sheet.Container\` with a \`Sheet.Background\` first child carrying the surface
+props, and reports spreads and \`styled(Sheet.Frame, …)\` targets for review.
+Check each rewritten callsite against these rules:
 
 - Replace \`Sheet.Frame\` with \`Sheet.Container\` plus \`Sheet.Background\`.
 - Keep layout props such as \`padding\`, \`gap\`, \`height\`, \`maxHeight\`, and flex props on \`Sheet.Container\`.
@@ -215,8 +207,9 @@ when behavior itself needs active responsive or theme state.
 ### 6. Replace true tokens
 
 - Default v3 configs no longer export the legacy \`$true\` token key.
-- Component default size resolves to bare \`4\`.
-- Replace authored \`$true\` tokens with real bare keys such as \`4\`.
+- The codemod writes \`$true\` on style props as \`4\` and reports a \`legacy-true-token\` warning; confirm the app's config aliased it there.
+- On \`size\`, \`elevation\`, and \`iconSize\` it writes the boolean \`true\`, which resolves to the component default size.
+- Token definitions and custom variants are not edited; search them for the alias by hand.
 - Do not change unrelated boolean props or boolean variant values.
 
 ### 7. Replace token stepping