figma-token 0.1.2 → 0.1.3

package/README.md

@@ -5,18 +5,18 @@
 ## Install
 
 ```bash
-npm install --global figma-token
+npm install -D figma-token
 ```
 
-The Figma Plugin can download all six formats directly. Use this CLI when a project needs those files written to a predictable folder and checked for changes.
+The Figma Plugin can download a ZIP or all six formats directly. Use this optional CLI when a project needs those files written to a predictable folder and checked for changes.
 
 ## Apply Plugin Tokens
 
 ```bash
-figma-token ./figma-tokens.json
+npx figma-token
 ```
 
-This creates the following files in `./figma-token-output/`:
+Without an input path, the CLI reads `./tokens.json` from the current project and creates the following files in `./figma-token-output/`:
 
 ```text
 tokens.json
@@ -30,21 +30,25 @@ tokens.dtcg.json
 Choose a project directory with `--out`:
 
 ```bash
-figma-token ./figma-tokens.json --out ./src/tokens
+npx figma-token --out ./src/tokens
+npx figma-token ./figma-export.json
 ```
 
 Preview all generated files without writing anything:
 
 ```bash
-figma-token ./figma-tokens.json --dry-run
+npx figma-token --dry-run
 ```
 
 Check whether generated files are current:
 
 ```bash
-figma-token check ./figma-tokens.json --out ./src/tokens
+npx figma-token --check
+npx figma-token --check --out ./src/tokens
 ```
 
+`--check` and `--dry-run` cannot be used together. The old `check` subcommand is not supported.
+
 ## Advanced Sync
 
 The hidden `sync` command retains the previous single-format, snapshot, and Figma REST API flow for advanced users. It accepts `--input`, `--output`, `--snapshot`, `--format`, `--export-name`, `--figma-token`, `--file-key`, and `--dry-run`.

package/dist/index.js

@@ -227,6 +227,9 @@ var tokenFileNames = ["tokens.json", "theme.ts", "variables.css", "tokens.scss",
 function defaultOutputDirectory(cwd = process.cwd()) {
   return resolve(cwd, "figma-token-output");
 }
+function defaultInputFile(cwd = process.cwd()) {
+  return resolve(cwd, "tokens.json");
+}
 var outputDirectory = (output) => resolve(output ?? defaultOutputDirectory());
 async function readPluginTokens(input) {
   const inputPath = resolve(input);
@@ -399,11 +402,22 @@ var format = (value) => {
   if (!formats.includes(value)) throw new InvalidArgumentError(`format\uC740 ${formats.join(", ")} \uC911 \uD558\uB098\uC5EC\uC57C \uD569\uB2C8\uB2E4.`);
   return value;
 };
-var program = new Command().name("figma-token").description("Plugin tokens.json\uC744 \uD504\uB85C\uC81D\uD2B8 \uD1A0\uD070 \uD30C\uC77C\uB85C \uC801\uC6A9\uD569\uB2C8\uB2E4.").version("0.1.2").argument("<input>", "Figma Plugin\uC5D0\uC11C \uB2E4\uC6B4\uB85C\uB4DC\uD55C tokens.json").option("--out <directory>", "\uCD9C\uB825 \uD3F4\uB354 (default: ./figma-token-output)").option("--dry-run", "\uD30C\uC77C\uC744 \uC4F0\uC9C0 \uC54A\uACE0 \uC0DD\uC131 \uACB0\uACFC\uB97C \uD655\uC778").action(async (input, options) => {
-  await exportTokenFiles({ input, output: options.out ?? defaultOutputDirectory(), dryRun: options.dryRun });
-});
-program.command("check").description("\uD604\uC7AC \uD1A0\uD070 \uD30C\uC77C\uC774 Plugin tokens.json\uACFC \uC77C\uCE58\uD558\uB294\uC9C0 \uD655\uC778\uD569\uB2C8\uB2E4.").argument("<input>", "Figma Plugin\uC5D0\uC11C \uB2E4\uC6B4\uB85C\uB4DC\uD55C tokens.json").option("--out <directory>", "\uCD9C\uB825 \uD3F4\uB354 (default: ./figma-token-output)").action(async (input, options) => {
-  process.exitCode = await checkTokenFiles({ input, output: options.out ?? defaultOutputDirectory() });
+var program = new Command().name("figma-token").description("Plugin tokens.json\uC744 \uD504\uB85C\uC81D\uD2B8 \uD1A0\uD070 \uD30C\uC77C\uB85C \uC801\uC6A9\uD569\uB2C8\uB2E4.").version("0.1.3").argument("[input]", "Figma Plugin\uC5D0\uC11C \uB2E4\uC6B4\uB85C\uB4DC\uD55C tokens.json (default: ./tokens.json)").option("--out <directory>", "\uCD9C\uB825 \uD3F4\uB354 (default: ./figma-token-output)").option("--dry-run", "\uD30C\uC77C\uC744 \uC4F0\uC9C0 \uC54A\uACE0 \uC0DD\uC131 \uACB0\uACFC\uB97C \uD655\uC778").option("--check", "\uD604\uC7AC \uD1A0\uD070 \uD30C\uC77C\uC774 \uCD5C\uC2E0\uC778\uC9C0 \uD655\uC778").action(async (input, options) => {
+  if (options.check && options.dryRun) throw new Error("--check\uC640 --dry-run\uC740 \uD568\uAED8 \uC0AC\uC6A9\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uD558\uB098\uB9CC \uC0AC\uC6A9\uD558\uC138\uC694.");
+  const defaultInput = !input;
+  const inputPath = input ?? defaultInputFile();
+  try {
+    if (options.check) {
+      process.exitCode = await checkTokenFiles({ input: inputPath, output: options.out ?? defaultOutputDirectory() });
+      return;
+    }
+    await exportTokenFiles({ input: inputPath, output: options.out ?? defaultOutputDirectory(), dryRun: options.dryRun });
+  } catch (error) {
+    if (defaultInput && error instanceof Error && error.message.startsWith("Input file not found:")) {
+      throw new Error("Expected token file: ./tokens.json\nProvide another file with: figma-token <input>");
+    }
+    throw error;
+  }
 });
 program.command("sync", { hidden: true }).option("--input <path>", "\uB85C\uCEEC Figma Variables JSON").option("--output <path>", "\uCD9C\uB825 \uD30C\uC77C", "./tokens.json").option("--snapshot <path>", "snapshot \uD30C\uC77C", ".figma-token/snapshot.json").option("--format <format>", "\uCD9C\uB825 \uD3EC\uB9F7", format, "tokens-json").option("--export-name <name>", "theme.ts export \uC774\uB984", "theme").option("--figma-token <token>", "Figma token").option("--file-key <key>", "Figma file key").option("--dry-run", "\uD30C\uC77C\uC744 \uC4F0\uC9C0 \uC54A\uACE0 diff\uB9CC \uCD9C\uB825", false).action(async (options) => sync({
   ...options,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "figma-token",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Export Figma Variables to design token files.",
   "license": "MIT",
   "type": "module",