tokvista 1.9.0 → 1.10.0

package/README.md

@@ -147,6 +147,22 @@ npx tokvista convert tokens.json --to supernova --output tokens-sn.json
 npx tokvista convert tokens.json --to w3c
 ```
 
+### Build All Formats
+
+```bash
+# Build everything in one command
+npx tokvista build tokens.json --output-dir ./dist
+
+# Creates:
+# - tokens.css
+# - tokens.scss
+# - tokens.js
+# - tailwind.config.js
+
+# Skip validation for faster builds
+npx tokvista build tokens.json --output-dir ./dist --skip-validation
+```
+
 ### Interactive Setup
 
 ```bash
@@ -179,6 +195,7 @@ Then run `npx tokvista` to use your config.
 | `tokvista validate <file>` | Validate token structure and values |
 | `tokvista diff <old> <new>` | Compare two token files |
 | `tokvista convert <file> --to <format>` | Convert between token formats |
+| `tokvista build <file> --output-dir <dir>` | Build all formats (validate + export) |
 | `--config`, `-c` | Config file path |
 | `--port`, `-p` | Server port (default: `3000`) |
 | `--format` | Export format (export only) |

package/dist/bin/tokvista.js

@@ -1122,6 +1122,7 @@ Usage:
   tokvista validate <tokens.json>
   tokvista diff <old.json> <new.json>
   tokvista convert <tokens.json> --to <w3c|style-dictionary|supernova> [--output <file>]
+  tokvista build <tokens.json> --output-dir <dir> [--skip-validation]
 
 Arguments:
   tokens.json       Path to your tokens file (overrides config.tokens)
@@ -1257,6 +1258,9 @@ function parseArgs(args) {
   if (args[0] === "convert") {
     return parseConvertArgs(args.slice(1));
   }
+  if (args[0] === "build") {
+    return parseBuildArgs(args.slice(1));
+  }
   return parseServeArgs(args);
 }
 function parseValidateArgs(args) {
@@ -1353,6 +1357,43 @@ function parseConvertArgs(args) {
   if (!to) throw new Error("--to is required (w3c, style-dictionary, supernova, or token-studio)");
   return { command: "convert", tokenFileArg, to, output };
 }
+function parseBuildArgs(args) {
+  let tokenFileArg;
+  let outputDir;
+  let skipValidation = false;
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "-h" || arg === "--help") {
+      printHelp();
+      process.exit(0);
+    }
+    if (arg === "--output-dir" || arg === "-o") {
+      const next = args[index + 1];
+      if (!next) throw new Error("Missing value for --output-dir");
+      outputDir = next;
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--output-dir=")) {
+      outputDir = arg.slice("--output-dir=".length);
+      continue;
+    }
+    if (arg === "--skip-validation") {
+      skipValidation = true;
+      continue;
+    }
+    if (arg.startsWith("-")) {
+      throw new Error(`Unknown option: ${arg}`);
+    }
+    if (tokenFileArg) {
+      throw new Error(`Only one token file is supported. Unexpected value: "${arg}"`);
+    }
+    tokenFileArg = arg;
+  }
+  if (!tokenFileArg) throw new Error("Token file is required for build");
+  if (!outputDir) throw new Error("--output-dir is required");
+  return { command: "build", tokenFileArg, outputDir, skipValidation };
+}
 function parseExportArgs(args) {
   let tokenFileArg;
   let format;
@@ -2125,6 +2166,49 @@ async function runConvertCommand(cwd, options) {
     console.log(output);
   }
 }
+async function runBuildCommand(cwd, options) {
+  const resolvedTokenPath = path.resolve(cwd, options.tokenFileArg);
+  const outputDir = path.resolve(cwd, options.outputDir);
+  if (!existsSync(resolvedTokenPath)) {
+    throw new Error(`Token file not found: ${resolvedTokenPath}`);
+  }
+  if (!existsSync(outputDir)) {
+    await import("fs/promises").then((fs) => fs.mkdir(outputDir, { recursive: true }));
+  }
+  const tokens = await readTokens(resolvedTokenPath);
+  if (!options.skipValidation) {
+    console.log("\nValidating tokens...");
+    const result = validateTokens(tokens);
+    if (!result.valid) {
+      console.log(`\u274C Found ${result.errors.length} errors`);
+      result.errors.slice(0, 5).forEach((err) => {
+        console.log(`  ${err.path}: ${err.message}`);
+      });
+      if (result.errors.length > 5) {
+        console.log(`  ... and ${result.errors.length - 5} more errors`);
+      }
+      throw new Error("Validation failed. Fix errors or use --skip-validation");
+    }
+    console.log("\u2705 Validation passed\n");
+  }
+  console.log("Building tokens...");
+  const formats = [
+    { name: "CSS", ext: "css", generator: generateCSS },
+    { name: "SCSS", ext: "scss", generator: generateSCSS },
+    { name: "JavaScript", ext: "js", generator: generateJS },
+    { name: "Tailwind", ext: "tailwind.config.js", generator: generateTailwind }
+  ];
+  for (const format of formats) {
+    const content = format.generator(tokens);
+    const filename = format.ext.includes(".") ? format.ext : `tokens.${format.ext}`;
+    const outputPath = path.join(outputDir, filename);
+    await writeFile(outputPath, content, "utf8");
+    console.log(`  \u2713 ${format.name} \u2192 ${filename}`);
+  }
+  console.log(`
+\u2705 Build complete: ${outputDir}
+`);
+}
 async function main() {
   try {
     const options = parseArgs(process.argv.slice(2));
@@ -2152,6 +2236,10 @@ async function main() {
       await runConvertCommand(cwd, options);
       return;
     }
+    if (options.command === "build") {
+      await runBuildCommand(cwd, options);
+      return;
+    }
     await runServeCommand(cwd, options);
   } catch (error) {
     console.error(error.message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokvista",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Interactive visual documentation for design tokens.",
   "type": "module",
   "main": "./dist/index.cjs",