@design-token-kit/cli 0.2.1 → 0.3.1

package/bin/index.mjs

@@ -11,9 +11,26 @@ import { Command } from "commander";
 import {
   DtcgTokenValidator
 } from "@design-token-kit/core";
+var EXIT_VALIDATION_ERROR = 2;
+var EXIT_FAILURE = 1;
+var validateCommand = new Command("validate").description("Validate DTCG JSON or HRDT YAML token files.").argument("[files...]", "Paths to DTCG JSON or HRDT YAML token files (reads from stdin when omitted)").addHelpText("after", "\nExit status:\n  0  success\n  1  unexpected error\n  2  validation errors found").action(async (sources) => {
+  try {
+    const validator = new DtcgTokenValidator();
+    const issues = await validator.validate(sources.length > 0 ? sources : ["-"]);
+    printIssues(issues);
+    if (hasErrors(issues)) {
+      process.exit(EXIT_VALIDATION_ERROR);
+    }
+    console.log("Validation passed.");
+  } catch (error) {
+    console.error("Validation error:", error.message);
+    process.exit(EXIT_FAILURE);
+  }
+});
 function formatIssue(issue) {
+  const source = issue.sourcePath === "-" ? "stdin" : issue.sourcePath;
   const location = issue.line === void 0 ? "" : issue.column === void 0 ? `:${issue.line}` : `:${issue.line}:${issue.column}`;
-  return `[${issue.name}] ${issue.severity}: ${issue.sourcePath}${location} - ${issue.message}`;
+  return `[${issue.name}] ${issue.severity}: ${source}${location} - ${issue.message}`;
 }
 function printIssues(issues) {
   for (const issue of issues) {
@@ -24,24 +41,10 @@ function printIssues(issues) {
 function hasErrors(issues) {
   return issues.some((i) => i.severity === "error");
 }
-var validateCommand = new Command("validate").description("Validate DTCG JSON or HRDT YAML token files.").argument("<files...>", "Paths to DTCG JSON or HRDT YAML token files").action(async (sources) => {
-  try {
-    const validator = new DtcgTokenValidator();
-    const issues = await validator.validate(sources);
-    printIssues(issues);
-    if (hasErrors(issues)) {
-      process.exit(2);
-    }
-    console.log("Validation passed.");
-  } catch (error) {
-    console.error("Validation error:", error.message);
-    process.exit(1);
-  }
-});
 
 // src/commands/convert.ts
 import { Command as Command2 } from "commander";
-import { Source } from "@design-token-kit/core";
+import { DtcgListLoader, DtcgTokenCssConverter as DtcgTokenCssConverter2 } from "@design-token-kit/core";
 import { writeFile } from "fs/promises";
 
 // src/commands/formats.ts
@@ -52,20 +55,9 @@ import {
   HrdtTokenReader,
   HrdtTokenWriter
 } from "@design-token-kit/core";
-function getReader(format) {
-  return readers[toDocumentFormat(format)];
-}
 function getWriter(format) {
   return writers[toOutputFormat(format)];
 }
-var readers = {
-  ["dtcg" /* DTCG */]: {
-    read: (content) => new DtcgJsonReader().parse(content)
-  },
-  ["hrdt" /* HRDT */]: {
-    read: (content) => new HrdtTokenReader().parse(content)
-  }
-};
 var writers = {
   ["dtcg" /* DTCG */]: {
     write: (doc) => new DtcgJsonWriter().write(doc)
@@ -89,23 +81,39 @@ function toOutputFormat(format, fallback = "css" /* CSS */) {
 }
 
 // src/commands/convert.ts
-var convertCommand = new Command2("convert").description("Convert a token file to DTCG JSON, HRDT YAML, or CSS.").argument("<file>", "Path to a token file").option("-i, --inform [format]", "Input format: dtcg, hrdt (default: auto-detect)").option("-f, --outform [format]", "Output format: dtcg, hrdt, css (default: css)").option("-o, --out [file]", "Output file (default: stdout)").action(async (file, options) => {
+var EXIT_FAILURE2 = 1;
+var convertCommand = new Command2("convert").description("Convert a token file to DTCG JSON, HRDT YAML, or CSS.").argument("[files...]", "Paths to token files (reads from stdin when omitted or '-')").option("-i, --inform [format]", "Input format: dtcg, hrdt (force all files to this format)").option("-f, --outform [format]", "Output format: dtcg, hrdt, css (default: css)").option("-o, --out [file]", "Output file (default: stdout)").addHelpText("after", "\nExit status:\n  0  success\n  1  conversion failed").action(async (files, options) => {
   try {
-    const reader = getReader(options.inform);
-    const content = await new Source(file).getContent();
-    const doc = reader.read(content);
-    const writer = getWriter(options.outform);
-    const output = writer.write(doc);
-    if (options.out) {
-      await writeFile(options.out, output);
-    } else {
-      process.stdout.write(output);
-    }
+    const outform = options.outform ?? "css" /* CSS */;
+    const forcedFormat = options.inform !== void 0 ? toDocumentFormat(options.inform) : void 0;
+    const list = await loadSources(files, forcedFormat);
+    const output = convertList(list, outform);
+    await writeOutput(output, options.out);
   } catch (error) {
     console.error("Conversion failed:", error.message);
-    process.exit(1);
+    process.exit(EXIT_FAILURE2);
   }
 });
+async function loadSources(files, forcedFormat) {
+  const sources = files.length > 0 ? files : ["-"];
+  return new DtcgListLoader().load(sources, forcedFormat);
+}
+function convertList(list, outform) {
+  if (outform === "css" /* CSS */) {
+    return new DtcgTokenCssConverter2().convertList(list);
+  }
+  if (list.themes.size > 0) {
+    throw new Error(`Multiple files are only supported with --outform css, got ${outform}`);
+  }
+  return getWriter(outform).write(list.base);
+}
+async function writeOutput(output, out) {
+  if (out) {
+    await writeFile(out, output);
+  } else {
+    process.stdout.write(output);
+  }
+}
 
 // src/commands/showcase.ts
 import { Command as Command3 } from "commander";
@@ -113,7 +121,28 @@ import { writeFile as writeFile2 } from "fs/promises";
 import { spawn } from "child_process";
 import path from "path";
 import { tmpdir } from "os";
-import { Source as Source2, createTokenHtmlShowcase } from "@design-token-kit/core";
+import { createTokenHtmlShowcase } from "@design-token-kit/core";
+var EXIT_FAILURE3 = 1;
+var showcaseCommand = new Command3("showcase").description("Create HTML showcase from DTCG JSON, HRDT YAML, or CSS.").argument("[files...]", "Paths to token JSON, HRDT, or CSS files (reads from stdin when omitted)").option("-o, --out <file>", "Output HTML file name or path").option("--open", "Open the generated HTML in browser (only with --out)").addHelpText("after", "\nExit status:\n  0  success\n  1  showcase failed").action(async (files, options) => {
+  try {
+    const showcase = createTokenHtmlShowcase();
+    const sources = files.length > 0 ? files : ["-"];
+    const html = await showcase.showcase(sources);
+    if (options.out) {
+      const targetFile = resolveOutputPath(options.out);
+      await writeFile2(targetFile, html);
+      console.log(`Saved HTML to: ${targetFile}`);
+      if (options.open) {
+        openFile(targetFile);
+      }
+    } else {
+      process.stdout.write(html);
+    }
+  } catch (error) {
+    console.error("Showcase failed:", error.message);
+    process.exit(EXIT_FAILURE3);
+  }
+});
 function resolveOutputPath(output) {
   if (path.isAbsolute(output)) {
     return output;
@@ -135,25 +164,6 @@ function openFile(filePath) {
   }
   spawn("xdg-open", [filePath], { stdio: "ignore", detached: true });
 }
-var showcaseCommand = new Command3("showcase").description("Create HTML showcase from DTCG JSON, HRDT YAML, or CSS.").argument("<files...>", "Paths to token JSON, HRDT, or CSS files").option("-o, --out <file>", "Output HTML file name or path").action(async (files, options) => {
-  try {
-    const showcase = createTokenHtmlShowcase();
-    const sources = files.map((f) => new Source2(f));
-    const filePaths = await Promise.all(sources.map((s) => s.getFile()));
-    const html = await showcase.showcase(filePaths);
-    if (options.out) {
-      const targetFile = resolveOutputPath(options.out);
-      await writeFile2(targetFile, html);
-      console.log(`Saved HTML to: ${targetFile}`);
-      openFile(targetFile);
-    } else {
-      process.stdout.write(html);
-    }
-  } catch (error) {
-    console.error("Showcase failed:", error.message);
-    process.exit(1);
-  }
-});
 
 // src/index.ts
 var packageJsonPath = path2.resolve(path2.dirname(fileURLToPath(import.meta.url)), "../package.json");
@@ -164,9 +174,13 @@ var program = new Command4().name("dtokens").description("CLI for DTCG JSON and
 Examples:
   $ dtokens validate tokens.json
   $ dtokens validate tokens.yaml
+  $ dtokens validate tokens.yaml tokens.dark.yaml
+  $ dtokens validate - tokens.dark.yaml < tokens.yaml
   $ dtokens convert tokens.yaml --inform hrdt --outform css --out ./dist/tokens.css
   $ dtokens convert tokens.json --outform hrdt
+  $ dtokens convert --outform css < tokens.yaml
   $ dtokens showcase tokens.yaml --out ./dist/showcase.html
+  $ dtokens showcase - < tokens.yaml
 ` : "");
 program.parseAsync(process.argv).catch((error) => {
   console.error(error instanceof Error ? error.message : error);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@design-token-kit/cli",
-    "version": "0.2.1",
+    "version": "0.3.1",
     "description": "CLI for Design Token Kit: validate, convert, showcase.",
     "keywords": [
         "design-tokens",
@@ -39,15 +39,16 @@
     "scripts": {
         "build": "tsc --noEmit && tsup",
         "dist": "node ../scripts/stage-package.mjs cli",
-        "test": "exit 0"
+        "test": "vitest run"
     },
     "dependencies": {
-        "@design-token-kit/core": "0.2.1",
+        "@design-token-kit/core": "0.3.1",
         "commander": "14.0.1"
     },
     "devDependencies": {
         "@types/node": "24.10.1",
         "tsup": "8.5.1",
-        "typescript": "5.9.3"
+        "typescript": "5.9.3",
+        "vitest": "^4.1.7"
     }
 }