@tamagui/cli 3.0.0-beta.1093.1 → 3.0.0-beta.1097.1

package/dist/migrate.cjs

@@ -324,9 +324,19 @@ Keep importing regular Tamagui components from \`tamagui\` or
 \`@tamagui/core\`. Do not mix utility classes and Tamagui style props on the
 same component; choose the import whose styling language that component uses.
 
+### Required API follow-ups
+
+- Transition values: replace arrays with \`{ preset: 'quick', opacity: 'lazy' }\`, rename the transition object's \`default\` to \`preset\`, and place physics under \`spring\`. Move \`animateOnly\` into \`transition.properties\`. Read the upgrade guide's transition section before converting driver-specific options.
+- Groups and containers: \`group="card"\` enables \`group-hover/card:\` and other group states. Size queries require \`container="card"\` and use \`@sm/card:\`; a group alone no longer enables container measurement.
+- Control sizes: Config v6 uses \`xs | sm | md | lg | xl\` (default \`md\`). Keep numeric token keys while retaining Config v5, then map control sizes when separately adopting v6. Shape and icon geometry still uses size tokens or numbers.
+- Remove top-level \`createTamagui({ defaultProps })\`. Put default styles in \`styled()\` definitions and inherited non-style defaults in \`Component.Props\`.
+- Toast: replace \`useToastController().show(title, { message })\` with \`toast(title, { description: message })\`. Import \`Toast\` and \`toast\` from \`tamagui/toast\`; mount \`Toast.Root\` and \`Toast.List\` with the desired parts once in the app. The old provider/controller API is removed.
+- Replace \`ThemeableStack\` and \`SizableStack\` with \`YStack\` or \`XStack\` plus explicit styles; use \`elevation\` for elevation and border width/color for borders.
+- Checked/selected states: Checkbox, Switch, Tabs and ToggleGroup read \`background-press\`; customize \`activeStyle\` to override it per instance. Audit the resulting active background against the previous app and customize its theme or skin where needed.
+
 ### 15. Verification
 
-- Run \`npx tamagui check\`.
+- Run \`npx tamagui check --strict\`.
 - Run typecheck and build.
 - Start the app and manually test screens using Sheet, Dialog, Popover, Select, FocusScope, icons, and ScrollView.
 - Test Adapt breakpoints where popovers/selects/dialogs become sheets.

package/dist/setup-prompt.cjs

@@ -1,6 +1,8 @@
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
 	for (var name in all) __defProp(target, name, {
@@ -17,17 +19,74 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var setup_prompt_exports = {};
 __export(setup_prompt_exports, {
 	getSetupPrompt: () => getSetupPrompt,
-	printSetupPrompt: () => printSetupPrompt
+	printSetupPrompt: () => printSetupPrompt,
+	resolveStyleValueSyntax: () => resolveStyleValueSyntax,
+	setupPrompt: () => setupPrompt
 });
 module.exports = __toCommonJS(setup_prompt_exports);
-function printSetupPrompt() {
-	process.stdout.write(getSetupPrompt());
+var import_prompts = __toESM(require("prompts"));
+async function resolveStyleValueSyntax(setting) {
+	if (setting === "string" || setting === "object" || setting === "both") {
+		return setting;
+	}
+	if (!process.stdin.isTTY) {
+		return "both";
+	}
+	const response = await (0, import_prompts.default)({
+		type: "select",
+		name: "syntax",
+		message: "Which style value syntax would you like to document?",
+		choices: [
+			{
+				title: "both - document both string and object syntax",
+				value: "both"
+			},
+			{
+				title: "string - e.g. bg=\"red hover:blue\"",
+				value: "string"
+			},
+			{
+				title: "object - e.g. bg={{ default: \"red\", hover: \"blue\" }}",
+				value: "object"
+			}
+		],
+		initial: 0
+	});
+	return response.syntax || "both";
+}
+async function setupPrompt(options) {
+	const { generatePrompt } = require("./generate-prompt.cjs");
+	return await generatePrompt(options);
+}
+function printSetupPrompt(syntax) {
+	if (syntax) {
+		process.stdout.write(getSetupPrompt(syntax));
+		return;
+	}
+	if (!process.stdin.isTTY) {
+		process.stdout.write(getSetupPrompt("both"));
+		return;
+	}
+	resolveStyleValueSyntax().then((chosen) => {
+		process.stdout.write(getSetupPrompt(chosen));
+	});
 }
-function getSetupPrompt() {
+function getSetupPrompt(syntax = "both") {
+	const styleExample = syntax === "string" ? "```tsx\n<View bg=\"background hover:background-hover\" p=\"4 sm:6\" />\n```" : syntax === "object" ? "```tsx\n<View bg={{ default: 'background', hover: 'background-hover' }} p={{ default: '4', sm: '6' }} />\n```" : `\`\`\`tsx
+// string form
+<View bg="background hover:background-hover" p="4 sm:6" />
+
+// object form
+<View bg={{ default: 'background', hover: 'background-hover' }} p={{ default: '4', sm: '6' }} />
+\`\`\``;
 	return `You are adding Tamagui v3 to a project that does not use it yet.
 
 Work like a careful coding agent:
@@ -68,8 +127,10 @@ import { createTamagui } from 'tamagui'
 
 export const config = createTamagui(defaultConfig)
 
+type AppConfig = typeof config
+
 declare module 'tamagui' {
-  interface TamaguiCustomConfig extends typeof config {}
+  interface TamaguiCustomConfig extends AppConfig {}
 }
 \`\`\`
 
@@ -87,7 +148,7 @@ import { config } from './tamagui.config'
 export default function App() {
   return (
     <TamaguiProvider config={config} defaultTheme="light">
-      <View width={200} height={200} bg="background" />
+      <View w={200} h={200} bg="background" />
     </TamaguiProvider>
   )
 }
@@ -113,15 +174,13 @@ first.
 This is the part most likely to be written as if it were v2. In v3, token and
 theme names are bare, and conditions are flat clauses inside the value:
 
-\`\`\`tsx
-<View bg="background hover:background-hover" p="4 sm:6" />
-\`\`\`
+${styleExample}
 
 - No \`$\` sigils: \`bg="background"\`, not \`bg="$background"\`.
 - No condition objects: there is no \`hoverStyle={{ ... }}\` and no \`$sm={{ ... }}\`.
 - Modifiers chain left to right and read as prefixes: \`hover:sm:small\`.
 - Clauses work on variant props too, not just style props, so
-  \`size="large sm:small"\` selects a different variant value per condition.
+  \`size="lg sm:sm"\` selects a different variant value per condition.
 - When two clauses both apply, the winner is decided by specificity, not by
   source order: first by platform (\`ios:\` beats \`native:\` beats unprefixed),
   then by how many conditions the clause carries, then by category
@@ -132,15 +191,15 @@ theme names are bare, and conditions are flat clauses inside the value:
 ## 7. Verify before reporting success
 
 \`\`\`bash
-npx tamagui check
+npx tamagui check --strict
 \`\`\`
 
-\`tamagui check\` reports version mismatches, duplicate installs, lockfile
+\`tamagui check --strict\` reports version mismatches, duplicate installs, lockfile
 problems, a missing config, and any v2 style syntax left in source. Then run the
 project's own typecheck and build, and start the app and confirm a Tamagui
 component renders with its styles applied. A passing typecheck is not sufficient:
-flat values are strings, so a misspelled token compiles cleanly and only shows up
-at runtime.
+single-token values are checked when \`settings.allowedStyleValues\` is enabled,
+but conditional payloads also need the strict checker.
 
 ## 8. Give the agent the project's own vocabulary
 

package/dist/upgrade.cjs

@@ -29,8 +29,8 @@ __export(upgrade_exports, { upgrade: () => upgrade });
 module.exports = __toCommonJS(upgrade_exports);
 var import_chalk = __toESM(require("chalk"));
 var import_node_child_process = require("node:child_process");
+var import_glob = require("glob");
 var import_node_fs = require("node:fs");
-var import_node_path = require("node:path");
 const TAMAGUI_PACKAGES_PATTERN = /^(@tamagui\/|tamagui$)/;
 const COMMIT_TYPE_ORDER = [
 	"feat",
@@ -78,24 +78,18 @@ function parseVersionSpecifier(version) {
 		cleanVersion: version
 	};
 }
-function findPackageJsonFiles(root) {
-	const files = [];
-	const rootPkgPath = (0, import_node_path.join)(root, "package.json");
-	if ((0, import_node_fs.existsSync)(rootPkgPath)) {
-		files.push(rootPkgPath);
-	}
-	try {
-		const result = (0, import_node_child_process.execSync)(`find "${root}" -name "package.json" -not -path "*/node_modules/*" -not -path "*/.git/*" 2>/dev/null`, {
-			encoding: "utf-8",
-			maxBuffer: 10 * 1024 * 1024
-		});
-		const foundFiles = result.trim().split("\n").filter(Boolean);
-		files.push(...foundFiles.filter((f) => !files.includes(f)));
-	} catch {}
-	return files;
-}
 function findTamaguiPackages(root) {
-	const packageJsonFiles = findPackageJsonFiles(root);
+	const packageJsonFiles = (0, import_glob.globSync)("**/package.json", {
+		cwd: root,
+		absolute: true,
+		nodir: true,
+		ignore: [
+			"**/node_modules/**",
+			"**/.git/**",
+			"**/dist/**",
+			"**/build/**"
+		]
+	});
 	const packages = [];
 	for (const filePath of packageJsonFiles) {
 		try {
@@ -129,7 +123,11 @@ function findTamaguiPackages(root) {
 }
 async function getLatestVersion() {
 	try {
-		const result = (0, import_node_child_process.execSync)("npm view tamagui version", { encoding: "utf-8" });
+		const result = (0, import_node_child_process.execFileSync)("npm", [
+			"view",
+			"tamagui",
+			"version"
+		], { encoding: "utf-8" });
 		return result.trim();
 	} catch (err) {
 		throw new Error("Failed to fetch latest tamagui version from npm");
@@ -180,7 +178,7 @@ function getChangelogFromGit(fromVersion, toVersion, debug) {
 	const commits = [];
 	try {
 		try {
-			(0, import_node_child_process.execSync)("git fetch --tags 2>/dev/null", {
+			(0, import_node_child_process.execFileSync)("git", ["fetch", "--tags"], {
 				encoding: "utf-8",
 				stdio: "pipe"
 			});
@@ -192,7 +190,13 @@ function getChangelogFromGit(fromVersion, toVersion, debug) {
 		}
 		let result;
 		try {
-			result = (0, import_node_child_process.execSync)(`git log ${fromTag}..${toTag} --pretty=format:"%H|%ad|%s" --date=short 2>/dev/null`, {
+			result = (0, import_node_child_process.execFileSync)("git", [
+				"log",
+				`${fromTag}..${toTag}`,
+				"--pretty=format:%H|%ad|%s",
+				"--date=short",
+				"--"
+			], {
 				encoding: "utf-8",
 				maxBuffer: 10 * 1024 * 1024
 			});
@@ -395,6 +399,10 @@ async function upgrade(options = {}) {
 	console.log(import_chalk.default.gray(`  Current version: ${import_chalk.default.white(fromVersion)}`));
 	console.log(import_chalk.default.gray(`  Target version:  ${import_chalk.default.white(toVersion)}`));
 	console.log("");
+	if (fromVersion.startsWith("2.") && toVersion.startsWith("3.")) {
+		console.log(import_chalk.default.yellow("Run `tamagui migrate --from v2` for the required API and configuration migration."));
+		console.log("");
+	}
 	if (packages.length > 0 && !changelogOnly) {
 		displayPackageSummary(packages);
 	}

package/package.json

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

package/src/cli.ts

@@ -15,28 +15,45 @@ const COMMAND_MAP = {
       '--verbose': Boolean,
       '--styles-only': Boolean,
       '--deps-only': Boolean,
+      '--strict': Boolean,
     },
     async run() {
       const { _, ...flags } = arg(this.flags)
       const options = await getOptions({
         debug: flags['--debug'] ? (flags['--verbose'] ? 'verbose' : true) : false,
+        loadTamaguiOptions: flags['--strict'] && !flags['--deps-only'],
       })
       if (!flags['--styles-only']) {
         const { checkDeps } = require('@tamagui/static/checkDeps')
         await checkDeps(options.paths.root)
       }
       if (flags['--deps-only']) return
+      if (flags['--strict']) {
+        if (!options.tamaguiOptions.config) {
+          throw new Error('Strict style checking requires a Tamagui config.')
+        }
+        const { loadTamagui } = require('@tamagui/static/loadTamagui')
+        process.env.TAMAGUI_KEEP_THEMES = '1'
+        const loaded = await loadTamagui(
+          { ...options.tamaguiOptions, platform: 'web' },
+          true
+        )
+        if (!loaded?.tamaguiConfig) {
+          throw new Error('Unable to load the Tamagui config for strict style checking.')
+        }
+      }
       const { checkStyleFiles, formatCheckResults, MissingConfigArtifactError } =
         require('@tamagui/language-service/check') as typeof import('@tamagui/language-service/check')
       try {
         const result = checkStyleFiles({
           root: options.paths.root,
           configPath: options.paths.conf,
+          strict: flags['--strict'],
         })
         console.info(formatCheckResults(result))
         if (result.diagnosticCount > 0) process.exitCode = 1
       } catch (error) {
-        if (error instanceof MissingConfigArtifactError) {
+        if (error instanceof MissingConfigArtifactError && !flags['--strict']) {
           console.warn(chalk.yellow(`skipping flat value check: ${error.message}`))
           return
         }