@tamagui/cli 2.7.7 → 3.0.0-beta.1097.1

package/dist/cli.cjs

@@ -5,370 +5,391 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    });
-  }
-  return to;
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: () => from[key],
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-// If the importer is in node compatibility mode or this is not an ESM
-// file that has been converted to a CommonJS file using a Babel-
-// compatible transform (i.e. "__esModule" has not been set), then set
-// "default" to the CommonJS "module.exports" for node compatibility.
-isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-  value: mod,
-  enumerable: true
+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 import_arg = __toESM(require("arg"));
 var import_chalk = __toESM(require("chalk"));
 var import_utils = require("./utils.cjs");
-["exit", "SIGINT"].forEach(_ => {
-  process.on(_, () => {
-    (0, import_utils.disposeAll)();
-    process.exit();
-  });
-});
+process.on("exit", import_utils.disposeAll);
 const COMMAND_MAP = {
-  check: {
-    description: `Checks for inconsistent versions, duplicate installs, lockfile issues, and missing config.`,
-    shorthands: [],
-    flags: {
-      "--help": Boolean,
-      "--debug": Boolean,
-      "--verbose": Boolean
-    },
-    async run() {
-      const {
-        _,
-        ...flags2
-      } = (0, import_arg.default)(this.flags);
-      const options = await (0, import_utils.getOptions)({
-        debug: flags2["--debug"] ? flags2["--verbose"] ? "verbose" : true : false
-      });
-      const {
-        checkDeps
-      } = require("@tamagui/static/checkDeps");
-      await checkDeps(options.paths.root);
-    }
-  },
-  generate: {
-    description: `Builds your entire tamagui configuration and outputs any CSS.`,
-    shorthands: [],
-    flags: {
-      "--help": Boolean,
-      "--debug": Boolean,
-      "--verbose": Boolean
-    },
-    async run() {
-      const {
-        _,
-        ...flags2
-      } = (0, import_arg.default)(this.flags);
-      const options = await (0, import_utils.getOptions)({
-        debug: flags2["--debug"] ? flags2["--verbose"] ? "verbose" : true : false,
-        loadTamaguiOptions: true
-      });
-      const {
-        loadTamagui
-      } = require("@tamagui/static/loadTamagui");
-      process.env.TAMAGUI_KEEP_THEMES = "1";
-      await loadTamagui({
-        ...options.tamaguiOptions,
-        platform: "web"
-      });
-      const {
-        generatePrompt
-      } = require("./generate-prompt.cjs");
-      const {
-        join
-      } = require("node:path");
-      await generatePrompt({
-        ...options,
-        output: join(options.paths.dotDir, "prompt.md")
-      });
-    }
-  },
-  "generate-css": {
-    shorthands: [],
-    description: `Generate the tamagui.generated.css file from your config`,
-    flags: {
-      "--help": Boolean,
-      "--debug": Boolean,
-      "--verbose": Boolean,
-      "--output": String
-    },
-    async run() {
-      const {
-        _,
-        ...flags2
-      } = (0, import_arg.default)(this.flags);
-      const options = await (0, import_utils.getOptions)({
-        debug: flags2["--debug"] ? flags2["--verbose"] ? "verbose" : true : false,
-        loadTamaguiOptions: true
-      });
-      const outputPath = flags2["--output"] || options.tamaguiOptions.outputCSS || "./tamagui.generated.css";
-      const {
-        loadTamagui
-      } = require("@tamagui/static/loadTamagui");
-      process.env.TAMAGUI_KEEP_THEMES = "1";
-      await loadTamagui({
-        ...options.tamaguiOptions,
-        outputCSS: outputPath,
-        platform: "web"
-      });
-      console.info(`Generated CSS to ${outputPath}`);
-    }
-  },
-  "generate-themes": {
-    shorthands: [],
-    description: `Use to pre-build your themes`,
-    flags: {
-      "--help": Boolean,
-      "--debug": Boolean,
-      "--verbose": Boolean
-    },
-    async run() {
-      const {
-        _,
-        ...flags2
-      } = (0, import_arg.default)(this.flags);
-      const options = await (0, import_utils.getOptions)({
-        debug: flags2["--debug"] ? flags2["--verbose"] ? "verbose" : true : false
-      });
-      const [_cmd, inPath, outPath] = _;
-      if (!inPath || !outPath) {
-        throw new Error(`Must supply both input and output paths, missing one (inPath: ${inPath}, outPath: ${outPath})`);
-      }
-      const {
-        generateThemes,
-        writeGeneratedThemes
-      } = require("@tamagui/generate-themes");
-      try {
-        const generated = await generateThemes(inPath);
-        if (generated) {
-          await writeGeneratedThemes(options.paths.dotDir, outPath, generated);
-          console.info(`Successfully generated themes to ${outPath}`);
-        } else {
-          process.exit(1);
-        }
-      } catch (err) {
-        console.error(`Error generating themes: ${err}`);
-        return;
-      }
-    }
-  },
-  add: {
-    shorthands: [],
-    description: `Use to add fonts and icons to your monorepo.`,
-    flags: {
-      "--help": Boolean,
-      "--debug": Boolean,
-      "--verbose": Boolean
-    },
-    async run() {
-      const {
-        _,
-        ...flags2
-      } = (0, import_arg.default)(this.flags);
-      const {
-        installGeneratedPackage
-      } = require("./add.cjs");
-      const [cmd, type, path] = _;
-      await installGeneratedPackage(type, path);
-    }
-  },
-  build: {
-    shorthands: ["b"],
-    description: `Use to pre-build a Tamagui component directory. Use -- to run a command after optimization, then auto-restore files.`,
-    flags: {
-      "--help": Boolean,
-      "--debug": Boolean,
-      "--verbose": Boolean,
-      "--dry-run": Boolean,
-      "--target": String,
-      "--include": String,
-      "--exclude": String,
-      "--output": String,
-      "--output-around": Boolean,
-      "--expect-optimizations": Number
-    },
-    async run() {
-      const argvSeparatorIdx = process.argv.indexOf("--");
-      let runCommand;
-      if (argvSeparatorIdx !== -1) {
-        runCommand = process.argv.slice(argvSeparatorIdx + 1);
-        const argsBeforeSeparator = process.argv.slice(0, argvSeparatorIdx);
-        process.argv = argsBeforeSeparator;
-      }
-      const {
-        _,
-        ...flags2
-      } = (0, import_arg.default)(this.flags);
-      const [_command, dir] = _;
-      const dryRun = flags2["--dry-run"] || false;
-      const debug = flags2["--debug"] ? flags2["--verbose"] ? "verbose" : true : false;
-      const {
-        build
-      } = require("./build.cjs");
-      const options = await (0, import_utils.getOptions)({
-        debug
-      });
-      await build({
-        ...options,
-        dir,
-        include: flags2["--include"],
-        target: flags2["--target"] || "both",
-        exclude: flags2["--exclude"],
-        output: flags2["--output"],
-        outputAround: flags2["--output-around"],
-        expectOptimizations: flags2["--expect-optimizations"],
-        runCommand,
-        dryRun
-      });
-    }
-  },
-  upgrade: {
-    shorthands: ["up"],
-    description: `Upgrade all tamagui packages in your workspace to the latest version`,
-    flags: {
-      "--help": Boolean,
-      "--debug": Boolean,
-      "--from": String,
-      "--to": String,
-      "--changelog-only": Boolean,
-      "--dry-run": Boolean
-    },
-    async run() {
-      const {
-        _,
-        ...flags2
-      } = (0, import_arg.default)(this.flags);
-      const {
-        upgrade
-      } = require("./upgrade.cjs");
-      await upgrade({
-        from: flags2["--from"],
-        to: flags2["--to"],
-        changelogOnly: flags2["--changelog-only"],
-        dryRun: flags2["--dry-run"],
-        debug: flags2["--debug"]
-      });
-    }
-  },
-  "update-template": {
-    shorthands: ["ut"],
-    description: `Used to update your git repo with the source template. (e.g. Takeout)`,
-    flags: {
-      "--help": Boolean,
-      "--template-repo": String,
-      "--ignored-patterns": String
-    },
-    async run() {
-      const {
-        _,
-        ...flags2
-      } = (0, import_arg.default)(this.flags);
-      const {
-        updateTemplate
-      } = require("./update-template.cjs");
-      if (!flags2["--template-repo"]) {
-        throw new Error("--template-repo is required");
-      }
-      await updateTemplate(flags2["--template-repo"], flags2["--ignored-patterns"]?.split(" "));
-    }
-  },
-  "generate-prompt": {
-    shorthands: [],
-    description: `Generate an LLM-friendly markdown file from your Tamagui config`,
-    flags: {
-      "--help": Boolean,
-      "--debug": Boolean,
-      "--output": String
-    },
-    async run() {
-      const {
-        _,
-        ...flags2
-      } = (0, import_arg.default)(this.flags);
-      const {
-        generatePrompt
-      } = require("./generate-prompt.cjs");
-      const options = await (0, import_utils.getOptions)({
-        debug: flags2["--debug"] ? true : false,
-        loadTamaguiOptions: true
-      });
-      await generatePrompt({
-        ...options,
-        output: flags2["--output"]
-      });
-    }
-  }
+	check: {
+		description: `Checks flat style values, inconsistent versions, duplicate installs, lockfile issues, and missing config.`,
+		shorthands: [],
+		flags: {
+			"--help": Boolean,
+			"--debug": Boolean,
+			"--verbose": Boolean,
+			"--styles-only": Boolean,
+			"--deps-only": Boolean,
+			"--strict": Boolean
+		},
+		async run() {
+			const { _, ...flags2 } = (0, import_arg.default)(this.flags);
+			const options = await (0, import_utils.getOptions)({
+				debug: flags2["--debug"] ? flags2["--verbose"] ? "verbose" : true : false,
+				loadTamaguiOptions: flags2["--strict"] && !flags2["--deps-only"]
+			});
+			if (!flags2["--styles-only"]) {
+				const { checkDeps } = require("@tamagui/static/checkDeps");
+				await checkDeps(options.paths.root);
+			}
+			if (flags2["--deps-only"]) return;
+			if (flags2["--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");
+			try {
+				const result = checkStyleFiles({
+					root: options.paths.root,
+					configPath: options.paths.conf,
+					strict: flags2["--strict"]
+				});
+				console.info(formatCheckResults(result));
+				if (result.diagnosticCount > 0) process.exitCode = 1;
+			} catch (error) {
+				if (error instanceof MissingConfigArtifactError && !flags2["--strict"]) {
+					console.warn(import_chalk.default.yellow(`skipping flat value check: ${error.message}`));
+					return;
+				}
+				throw error;
+			}
+		}
+	},
+	generate: {
+		description: `Builds your entire tamagui configuration and outputs any CSS.`,
+		shorthands: [],
+		flags: {
+			"--help": Boolean,
+			"--debug": Boolean,
+			"--verbose": Boolean
+		},
+		async run() {
+			const { _, ...flags2 } = (0, import_arg.default)(this.flags);
+			const options = await (0, import_utils.getOptions)({
+				debug: flags2["--debug"] ? flags2["--verbose"] ? "verbose" : true : false,
+				loadTamaguiOptions: true
+			});
+			const { loadTamagui } = require("@tamagui/static/loadTamagui");
+			process.env.TAMAGUI_KEEP_THEMES = "1";
+			await loadTamagui({
+				...options.tamaguiOptions,
+				platform: "web"
+			});
+			const { generatePrompt } = require("./generate-prompt.cjs");
+			const { join } = require("node:path");
+			await generatePrompt({
+				...options,
+				output: join(options.paths.dotDir, "prompt.md")
+			});
+		}
+	},
+	"generate-css": {
+		shorthands: [],
+		description: `Generate the tamagui.generated.css file from your config`,
+		flags: {
+			"--help": Boolean,
+			"--debug": Boolean,
+			"--verbose": Boolean,
+			"--output": String
+		},
+		async run() {
+			const { _, ...flags2 } = (0, import_arg.default)(this.flags);
+			const options = await (0, import_utils.getOptions)({
+				debug: flags2["--debug"] ? flags2["--verbose"] ? "verbose" : true : false,
+				loadTamaguiOptions: true
+			});
+			const outputPath = flags2["--output"] || options.tamaguiOptions.outputCSS || "./tamagui.generated.css";
+			const { loadTamagui } = require("@tamagui/static/loadTamagui");
+			process.env.TAMAGUI_KEEP_THEMES = "1";
+			await loadTamagui({
+				...options.tamaguiOptions,
+				outputCSS: outputPath,
+				platform: "web"
+			});
+			console.info(`Generated CSS to ${outputPath}`);
+		}
+	},
+	"generate-themes": {
+		shorthands: [],
+		description: `Use to pre-build your themes`,
+		flags: {
+			"--help": Boolean,
+			"--debug": Boolean,
+			"--verbose": Boolean
+		},
+		async run() {
+			const { _, ...flags2 } = (0, import_arg.default)(this.flags);
+			const options = await (0, import_utils.getOptions)({ debug: flags2["--debug"] ? flags2["--verbose"] ? "verbose" : true : false });
+			const [_cmd, inPath, outPath] = _;
+			if (!inPath || !outPath) {
+				throw new Error(`Must supply both input and output paths, missing one (inPath: ${inPath}, outPath: ${outPath})`);
+			}
+			const { generateThemes, writeGeneratedThemes } = require("@tamagui/generate-themes");
+			try {
+				const generated = await generateThemes(inPath);
+				if (generated) {
+					await writeGeneratedThemes(options.paths.dotDir, outPath, generated);
+					console.info(`Successfully generated themes to ${outPath}`);
+				} else {
+					process.exit(1);
+				}
+			} catch (err) {
+				console.error(`Error generating themes: ${err}`);
+				return;
+			}
+		}
+	},
+	add: {
+		shorthands: [],
+		description: `Use to add fonts and icons to your monorepo.`,
+		flags: {
+			"--help": Boolean,
+			"--debug": Boolean,
+			"--verbose": Boolean
+		},
+		async run() {
+			const { _, ...flags2 } = (0, import_arg.default)(this.flags);
+			const { installGeneratedPackage } = require("./add.cjs");
+			const [cmd, type, path] = _;
+			await installGeneratedPackage(type, path);
+		}
+	},
+	build: {
+		shorthands: ["b"],
+		description: `Use to pre-build a Tamagui component directory. Use -- to run a command after optimization, then auto-restore files.`,
+		flags: {
+			"--help": Boolean,
+			"--debug": Boolean,
+			"--verbose": Boolean,
+			"--dry-run": Boolean,
+			"--target": String,
+			"--include": String,
+			"--exclude": String,
+			"--output": String,
+			"--output-around": Boolean,
+			"--expect-optimizations": Number
+		},
+		async run() {
+			const argvSeparatorIdx = process.argv.indexOf("--");
+			let runCommand;
+			if (argvSeparatorIdx !== -1) {
+				runCommand = process.argv.slice(argvSeparatorIdx + 1);
+				const argsBeforeSeparator = process.argv.slice(0, argvSeparatorIdx);
+				process.argv = argsBeforeSeparator;
+			}
+			const { _, ...flags2 } = (0, import_arg.default)(this.flags);
+			const [_command, dir] = _;
+			const dryRun = flags2["--dry-run"] || false;
+			const debug = flags2["--debug"] ? flags2["--verbose"] ? "verbose" : true : false;
+			const { build } = require("./build.cjs");
+			const options = await (0, import_utils.getOptions)({ debug });
+			await build({
+				...options,
+				dir,
+				include: flags2["--include"],
+				target: flags2["--target"] || "both",
+				exclude: flags2["--exclude"],
+				output: flags2["--output"],
+				outputAround: flags2["--output-around"],
+				expectOptimizations: flags2["--expect-optimizations"],
+				runCommand,
+				dryRun
+			});
+		}
+	},
+	upgrade: {
+		shorthands: ["up"],
+		description: `Upgrade all tamagui packages in your workspace to the latest version`,
+		flags: {
+			"--help": Boolean,
+			"--debug": Boolean,
+			"--from": String,
+			"--to": String,
+			"--changelog-only": Boolean,
+			"--dry-run": Boolean
+		},
+		async run() {
+			const { _, ...flags2 } = (0, import_arg.default)(this.flags);
+			const { upgrade } = require("./upgrade.cjs");
+			await upgrade({
+				from: flags2["--from"],
+				to: flags2["--to"],
+				changelogOnly: flags2["--changelog-only"],
+				dryRun: flags2["--dry-run"],
+				debug: flags2["--debug"]
+			});
+		}
+	},
+	setup: {
+		shorthands: [],
+		description: `Print an AI-agent prompt for adding Tamagui to a project for the first time`,
+		usage: `$ tamagui setup`,
+		flags: { "--help": Boolean },
+		async run() {
+			const { printSetupPrompt } = require("./setup-prompt.cjs");
+			printSetupPrompt();
+		}
+	},
+	migrate: {
+		shorthands: [],
+		description: `Print an AI-agent prompt for migrating a Tamagui app to v3`,
+		usage: `$ tamagui migrate --from v2
+$ tamagui migrate --from v1`,
+		flags: {
+			"--help": Boolean,
+			"--from": String
+		},
+		async run() {
+			const { _, ...flags2 } = (0, import_arg.default)(this.flags);
+			const [_cmd, fromArg] = _;
+			const { printMigrationPrompt } = require("./migrate.cjs");
+			printMigrationPrompt({ from: flags2["--from"] || fromArg });
+		}
+	},
+	"to-tailwind": {
+		shorthands: [],
+		description: `Convert Tamagui JSX props in files or globs to Tailwind className syntax`,
+		flags: {
+			"--help": Boolean,
+			"--write": Boolean,
+			"--config": String,
+			"--use-default-config": Boolean,
+			"--rename-dom": Boolean
+		},
+		async run() {
+			const { _, ...flags2 } = (0, import_arg.default)(this.flags);
+			const { toTailwind } = require("./to-tailwind.cjs");
+			const [_cmd, ...patterns] = _;
+			await toTailwind({
+				patterns,
+				write: flags2["--write"],
+				configPath: flags2["--config"],
+				useDefaultConfig: flags2["--use-default-config"],
+				renameDom: flags2["--rename-dom"]
+			});
+		}
+	},
+	"update-template": {
+		shorthands: ["ut"],
+		description: `Used to update your git repo with the source template. (e.g. Takeout)`,
+		flags: {
+			"--help": Boolean,
+			"--template-repo": String,
+			"--ignored-patterns": String
+		},
+		async run() {
+			const { _, ...flags2 } = (0, import_arg.default)(this.flags);
+			const { updateTemplate } = require("./update-template.cjs");
+			if (!flags2["--template-repo"]) {
+				throw new Error("--template-repo is required");
+			}
+			await updateTemplate(flags2["--template-repo"], flags2["--ignored-patterns"]?.split(" "));
+		}
+	},
+	"generate-prompt": {
+		shorthands: [],
+		description: `Generate an LLM-friendly markdown file from your Tamagui config`,
+		flags: {
+			"--help": Boolean,
+			"--debug": Boolean,
+			"--output": String
+		},
+		async run() {
+			const { _, ...flags2 } = (0, import_arg.default)(this.flags);
+			const { generatePrompt } = require("./generate-prompt.cjs");
+			const options = await (0, import_utils.getOptions)({
+				debug: flags2["--debug"] ? true : false,
+				loadTamaguiOptions: true
+			});
+			await generatePrompt({
+				...options,
+				output: flags2["--output"]
+			});
+		}
+	}
 };
-const commandEntries = Object.keys(COMMAND_MAP).flatMap(command2 => {
-  const definition2 = COMMAND_MAP[command2];
-  const entries = [command2, ...definition2.shorthands].map(cmd => {
-    return [cmd, definition2];
-  });
-  return entries;
+const commandEntries = Object.keys(COMMAND_MAP).flatMap((command2) => {
+	const definition2 = COMMAND_MAP[command2];
+	const entries = [command2, ...definition2.shorthands].map((cmd) => {
+		return [cmd, definition2];
+	});
+	return entries;
 });
 const commands = Object.fromEntries(commandEntries);
-const {
-  _: [command],
-  ...flags
-} = (0, import_arg.default)({
-  "--help": Boolean,
-  "--version": Boolean
-}, {
-  permissive: true
-});
+const { _: [command], ...flags } = (0, import_arg.default)({
+	"--help": Boolean,
+	"--version": Boolean
+}, { permissive: true });
 if (flags["--version"]) {
-  console.info(require("../package.json").version);
-  process.exit(0);
+	console.info(require("../package.json").version);
+	process.exit(0);
 }
 if (!command && flags["--help"]) {
-  console.info(`$ tamagui
+	console.info(`$ tamagui
 
 commands:
 
-${Object.keys(COMMAND_MAP).map(key => {
-    return `  ${key}`;
-  }).join("\n")}`);
-  process.exit(0);
+${Object.keys(COMMAND_MAP).map((key) => {
+		return `  ${key}`;
+	}).join("\n")}`);
+	process.exit(0);
 }
 if (!(command in commands)) {
-  console.error();
-  console.warn(import_chalk.default.yellow(`Not a valid command: ${command}`));
-  process.exit(1);
+	console.error();
+	console.warn(import_chalk.default.yellow(`Not a valid command: ${command}`));
+	process.exit(1);
 }
 const definition = commands[command];
 main();
 async function main() {
-  if (flags["--help"]) {
-    console.info(`
+	if (flags["--help"]) {
+		console.info(`
 $ tamagui ${command}: ${definition.description}
 `);
-    console.info(`Flags: ${Object.entries(definition.flags).map(([k, v]) => `${k} (${v.name})`)}`);
-    process.exit(0);
-  }
-  const {
-    _,
-    ...cmdFlags
-  } = (0, import_arg.default)(definition.flags);
-  if (cmdFlags["--help"]) {
-    console.info(`$ tamagui ${_}
+		if ("usage" in definition && definition.usage) {
+			console.info(`Usage:
+${definition.usage}
+`);
+		}
+		console.info(`Flags:
+${Object.entries(definition.flags).map(([k, v]) => `  ${k} (${v.name})`).join("\n")}`);
+		process.exit(0);
+	}
+	const { _, ...cmdFlags } = (0, import_arg.default)(definition.flags);
+	if (cmdFlags["--help"]) {
+		console.info(`$ tamagui ${_}
 
     Flags: ${JSON.stringify(cmdFlags, null, 2)}
 
 `);
-    process.exit(0);
-  }
-  try {
-    await definition.run();
-  } catch (err) {
-    console.error(`Error running command: ${err.message}`);
-  }
-  process.exit(0);
-}
+		process.exit(0);
+	}
+	try {
+		await definition.run();
+	} catch (err) {
+		console.error(`Error running command: ${err.message}`);
+		process.exit(1);
+	}
+	process.exit(process.exitCode ?? 0);
+}