@x12i/kit-cli 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 x12i
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,49 @@
-# Temporary Holding Version
+# @x12i/kit-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Command line for the Unified UI Kit. The binary is called `kit`.
+
+```sh
+npx @x12i/kit-cli doctor
+```
+
+| Command | Status |
+| --- | --- |
+| `kit init` | Writes `kit.config.json` (`--theme`, `--density`, `--force`). |
+| `kit doctor [paths...]` | Finds hard-coded hex colors in CSS, TS, JS, HTML, Vue, Svelte and MDX files. Exits with 1 when it finds any, so it can gate CI. |
+| `kit theme [name]` | Lists the built-in themes and densities. Generating a theme is planned. |
+| `kit add <component...>` | Stub. The component registry is planned, so it exits with 1 and says so. |
+
+Exit codes: `0` success, `1` the command ran and found a problem, `2` bad usage
+(unknown command, option, theme or path).
+
+## doctor
+
+`kit doctor` is a minimal scan. It finds `#rgb`, `#rgba`, `#rrggbb` and
+`#rrggbbaa` values. It skips `node_modules`, `dist`, `build`, `coverage` and
+other build folders, minified files and `.d.ts` files. It does not flag URL
+fragments, `href="#anchor"` links or HTML entities.
+
+- Add `kit-ignore` to a line (in a comment) to keep a color on purpose, such as a
+  brand logo.
+- List paths to skip in `kit.config.json`:
+
+```json
+{
+  "version": 1,
+  "theme": "light",
+  "density": "default",
+  "doctor": { "ignore": ["legacy", "src/vendor"] }
+}
+```
+
+- `--json` prints the findings as JSON.
+
+Spacing, font sizes and `rgb()` or `hsl()` colors are not scanned yet.
+
+## API
+
+```ts
+import { scanForHardcodedColors } from "@x12i/kit-cli";
+
+const findings = await scanForHardcodedColors(process.cwd(), ["src"]);
+```

package/dist/cli.js

@@ -0,0 +1,316 @@
+#!/usr/bin/env node
+import { readFileSync } from 'fs';
+import { writeFile, readFile, stat, access, readdir } from 'fs/promises';
+import path2 from 'path';
+import { parseArgs } from 'util';
+import { themeNames, densityNames } from '@x12i/tokens';
+
+var CONFIG_FILE = "kit.config.json";
+var CONFIG_VERSION = 1;
+function isThemeName(value) {
+  return themeNames.includes(value);
+}
+function isDensityName(value) {
+  return densityNames.includes(value);
+}
+function createConfig(options = {}) {
+  return {
+    version: CONFIG_VERSION,
+    theme: options.theme ?? "light",
+    density: options.density ?? "default",
+    doctor: { ignore: [] }
+  };
+}
+async function loadConfig(cwd) {
+  let text;
+  try {
+    text = await readFile(path2.join(cwd, CONFIG_FILE), "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") return null;
+    throw error;
+  }
+  let raw;
+  try {
+    raw = JSON.parse(text);
+  } catch {
+    throw new Error(`${CONFIG_FILE} is not valid JSON.`);
+  }
+  const input = typeof raw === "object" && raw !== null ? raw : {};
+  const defaults = createConfig();
+  const ignore = input.doctor?.ignore;
+  return {
+    version: CONFIG_VERSION,
+    theme: typeof input.theme === "string" && isThemeName(input.theme) ? input.theme : defaults.theme,
+    density: typeof input.density === "string" && isDensityName(input.density) ? input.density : defaults.density,
+    doctor: {
+      ignore: Array.isArray(ignore) ? ignore.filter((item) => typeof item === "string") : []
+    }
+  };
+}
+var SCANNED_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".css",
+  ".scss",
+  ".sass",
+  ".less",
+  ".ts",
+  ".tsx",
+  ".js",
+  ".jsx",
+  ".mjs",
+  ".cjs",
+  ".html",
+  ".vue",
+  ".svelte",
+  ".mdx"
+]);
+var SKIPPED_DIRECTORIES = /* @__PURE__ */ new Set([
+  "node_modules",
+  "dist",
+  "build",
+  "out",
+  "coverage",
+  ".git",
+  ".next",
+  ".turbo",
+  ".svelte-kit"
+]);
+var MAX_FILE_BYTES = 1e6;
+var HEX_COLOR = /(?<![\w&#/-])(?<!\bhref=["'])#(?:[0-9a-fA-F]{8}|[0-9a-fA-F]{6}|[0-9a-fA-F]{3,4})(?![\w-])/g;
+var IGNORE_MARKER = "kit-ignore";
+var toPosix = (value) => value.split(path2.sep).join("/");
+function isIgnored(relativePath, ignore) {
+  return ignore.some((entry) => {
+    const prefix = entry.replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
+    return prefix !== "" && (relativePath === prefix || relativePath.startsWith(`${prefix}/`));
+  });
+}
+function findHexColors(text) {
+  const findings = [];
+  const lines = text.split(/\r?\n/);
+  lines.forEach((line, index) => {
+    if (line.includes(IGNORE_MARKER)) return;
+    for (const found of line.matchAll(HEX_COLOR)) {
+      findings.push({ line: index + 1, column: (found.index ?? 0) + 1, match: found[0] });
+    }
+  });
+  return findings;
+}
+async function* walk(directory) {
+  const entries = await readdir(directory, { withFileTypes: true });
+  entries.sort((a, b) => a.name.localeCompare(b.name));
+  for (const entry of entries) {
+    if (entry.isSymbolicLink()) continue;
+    const full = path2.join(directory, entry.name);
+    if (entry.isDirectory()) {
+      if (!SKIPPED_DIRECTORIES.has(entry.name)) yield* walk(full);
+    } else if (entry.isFile()) {
+      yield full;
+    }
+  }
+}
+function isScannable(file) {
+  const name = path2.basename(file);
+  if (name.includes(".min.") || name.endsWith(".d.ts")) return false;
+  return SCANNED_EXTENSIONS.has(path2.extname(name));
+}
+async function scanForHardcodedColors(cwd, targets = ["."], { ignore = [] } = {}) {
+  const findings = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const target of targets) {
+    const root = path2.resolve(cwd, target);
+    const info = await stat(root);
+    const files = info.isDirectory() ? walk(root) : (async function* () {
+      yield root;
+    })();
+    for await (const file of files) {
+      if (seen.has(file)) continue;
+      seen.add(file);
+      const relative = toPosix(path2.relative(cwd, file));
+      if (isIgnored(relative, ignore) || !isScannable(file)) continue;
+      const { size } = await stat(file);
+      if (size > MAX_FILE_BYTES) continue;
+      const text = await readFile(file, "utf8");
+      for (const finding of findHexColors(text)) {
+        findings.push({ file: relative, ...finding });
+      }
+    }
+  }
+  return findings;
+}
+
+// src/main.ts
+var HELP = `kit: command line for the Unified UI Kit
+
+Usage
+  kit <command> [options]
+
+Commands
+  init [--theme <name>] [--density <name>] [--force]
+        Write ${CONFIG_FILE} in the current folder.
+  add <component...>
+        Add a component to your project. Planned.
+  theme [name]
+        List the themes and densities. Generating a theme is planned.
+  doctor [paths...] [--json]
+        Find hard-coded hex colors that should be --kit- tokens.
+        Exits with 1 when it finds any.
+
+Options
+  -h, --help       Show this help.
+  -v, --version    Show the version.
+`;
+function readVersion() {
+  const file = new URL("../package.json", import.meta.url);
+  return JSON.parse(readFileSync(file, "utf8")).version;
+}
+async function exists(file) {
+  try {
+    await access(file);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function init(values, io) {
+  if (values.theme !== void 0 && !isThemeName(values.theme)) {
+    io.err(`Unknown theme "${values.theme}". Choose one of: ${themeNames.join(", ")}.
+`);
+    return 2;
+  }
+  if (values.density !== void 0 && !isDensityName(values.density)) {
+    io.err(`Unknown density "${values.density}". Choose one of: ${densityNames.join(", ")}.
+`);
+    return 2;
+  }
+  const target = path2.join(io.cwd, CONFIG_FILE);
+  if (!values.force && await exists(target)) {
+    io.err(`${CONFIG_FILE} already exists. Use --force to replace it.
+`);
+    return 1;
+  }
+  const config = createConfig({ theme: values.theme, density: values.density });
+  await writeFile(target, `${JSON.stringify(config, null, 2)}
+`, "utf8");
+  io.out(`Created ${CONFIG_FILE}
+`);
+  return 0;
+}
+function add(components, io) {
+  const wanted = components.length > 0 ? ` (${components.join(", ")})` : "";
+  io.err(
+    `kit add${wanted} is not available yet. The component registry is planned. Until then, import components from @x12i/ui.
+`
+  );
+  return 1;
+}
+function theme(name, io) {
+  if (name === void 0) {
+    io.out(`Themes:    ${themeNames.join(", ")}
+`);
+    io.out(`Densities: ${densityNames.join(", ")}
+`);
+    return 0;
+  }
+  if (isThemeName(name)) {
+    io.out(`"${name}" is built in. Import @x12i/themes/${name}.css, or set data-theme="${name}" on <html>.
+`);
+    return 0;
+  }
+  io.err(
+    `Generating a custom theme is planned and is not available yet. Built-in themes: ${themeNames.join(", ")}.
+`
+  );
+  return 1;
+}
+async function doctor(paths, json, io) {
+  const config = await loadConfig(io.cwd);
+  const targets = paths.length > 0 ? paths : ["."];
+  let findings;
+  try {
+    findings = await scanForHardcodedColors(io.cwd, targets, { ignore: config?.doctor.ignore });
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      io.err(`Path not found: ${error.path ?? targets.join(", ")}
+`);
+      return 2;
+    }
+    throw error;
+  }
+  if (json) {
+    io.out(`${JSON.stringify(findings, null, 2)}
+`);
+    return findings.length > 0 ? 1 : 0;
+  }
+  if (findings.length === 0) {
+    io.out("No hard-coded colors found.\n");
+    return 0;
+  }
+  for (const finding of findings) {
+    io.out(`${finding.file}:${finding.line}:${finding.column}  ${finding.match}  Use a --kit- color token.
+`);
+  }
+  const files = new Set(findings.map((finding) => finding.file)).size;
+  io.out(
+    `
+${findings.length} hard-coded ${findings.length === 1 ? "color" : "colors"} found in ${files} ${files === 1 ? "file" : "files"}.
+`
+  );
+  return 1;
+}
+async function run(argv, io) {
+  let parsed;
+  try {
+    parsed = parseArgs({
+      args: argv,
+      allowPositionals: true,
+      options: {
+        help: { type: "boolean", short: "h" },
+        version: { type: "boolean", short: "v" },
+        force: { type: "boolean" },
+        json: { type: "boolean" },
+        theme: { type: "string" },
+        density: { type: "string" }
+      }
+    });
+  } catch (error) {
+    io.err(`${error.message}
+
+${HELP}`);
+    return 2;
+  }
+  const { values, positionals } = parsed;
+  const [command, ...rest] = positionals;
+  if (values.version) {
+    io.out(`${readVersion()}
+`);
+    return 0;
+  }
+  if (values.help || command === void 0 || command === "help") {
+    io.out(HELP);
+    return 0;
+  }
+  switch (command) {
+    case "init":
+      return init(values, io);
+    case "add":
+      return add(rest, io);
+    case "theme":
+      return theme(rest[0], io);
+    case "doctor":
+      return doctor(rest, values.json ?? false, io);
+    default:
+      io.err(`Unknown command "${command}".
+
+${HELP}`);
+      return 2;
+  }
+}
+
+// src/cli.ts
+process.exitCode = await run(process.argv.slice(2), {
+  cwd: process.cwd(),
+  out: (text) => process.stdout.write(text),
+  err: (text) => process.stderr.write(text)
+});
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/doctor.ts","../src/main.ts","../src/cli.ts"],"names":["path","readFile","themeNames","densityNames"],"mappings":"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","file":"cli.js","sourcesContent":["import { readFile } from \"node:fs/promises\";\r\nimport path from \"node:path\";\r\nimport { densityNames, themeNames, type DensityName, type ThemeName } from \"@x12i/tokens\";\r\n\r\nexport const CONFIG_FILE = \"kit.config.json\";\r\nexport const CONFIG_VERSION = 1;\r\n\r\nexport interface KitConfig {\r\n  version: typeof CONFIG_VERSION;\r\n  /** The theme the project starts with. */\r\n  theme: ThemeName;\r\n  density: DensityName;\r\n  doctor: {\r\n    /** Paths, relative to the config file, that `kit doctor` skips. */\r\n    ignore: string[];\r\n  };\r\n}\r\n\r\nexport function isThemeName(value: string): value is ThemeName {\r\n  return (themeNames as readonly string[]).includes(value);\r\n}\r\n\r\nexport function isDensityName(value: string): value is DensityName {\r\n  return (densityNames as readonly string[]).includes(value);\r\n}\r\n\r\nexport function createConfig(options: { theme?: ThemeName; density?: DensityName } = {}): KitConfig {\r\n  return {\r\n    version: CONFIG_VERSION,\r\n    theme: options.theme ?? \"light\",\r\n    density: options.density ?? \"default\",\r\n    doctor: { ignore: [] },\r\n  };\r\n}\r\n\r\n/** Reads `kit.config.json` from `cwd`. Returns `null` when there is none. */\r\nexport async function loadConfig(cwd: string): Promise<KitConfig | null> {\r\n  let text: string;\r\n  try {\r\n    text = await readFile(path.join(cwd, CONFIG_FILE), \"utf8\");\r\n  } catch (error) {\r\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return null;\r\n    throw error;\r\n  }\r\n\r\n  let raw: unknown;\r\n  try {\r\n    raw = JSON.parse(text);\r\n  } catch {\r\n    throw new Error(`${CONFIG_FILE} is not valid JSON.`);\r\n  }\r\n\r\n  const input = (typeof raw === \"object\" && raw !== null ? raw : {}) as Partial<KitConfig>;\r\n  const defaults = createConfig();\r\n  const ignore = input.doctor?.ignore;\r\n\r\n  return {\r\n    version: CONFIG_VERSION,\r\n    theme: typeof input.theme === \"string\" && isThemeName(input.theme) ? input.theme : defaults.theme,\r\n    density:\r\n      typeof input.density === \"string\" && isDensityName(input.density) ? input.density : defaults.density,\r\n    doctor: {\r\n      ignore: Array.isArray(ignore) ? ignore.filter((item): item is string => typeof item === \"string\") : [],\r\n    },\r\n  };\r\n}\r\n","import { readdir, readFile, stat } from \"node:fs/promises\";\r\nimport path from \"node:path\";\r\n\r\nexport interface Finding {\r\n  /** Path relative to the scan root, with forward slashes. */\r\n  file: string;\r\n  line: number;\r\n  column: number;\r\n  /** The text that matched, such as `#ff0000`. */\r\n  match: string;\r\n}\r\n\r\nexport interface ScanOptions {\r\n  /** Paths, relative to `cwd`, to skip. A prefix skips everything under it. */\r\n  ignore?: string[];\r\n}\r\n\r\nconst SCANNED_EXTENSIONS = new Set([\r\n  \".css\",\r\n  \".scss\",\r\n  \".sass\",\r\n  \".less\",\r\n  \".ts\",\r\n  \".tsx\",\r\n  \".js\",\r\n  \".jsx\",\r\n  \".mjs\",\r\n  \".cjs\",\r\n  \".html\",\r\n  \".vue\",\r\n  \".svelte\",\r\n  \".mdx\",\r\n]);\r\n\r\nconst SKIPPED_DIRECTORIES = new Set([\r\n  \"node_modules\",\r\n  \"dist\",\r\n  \"build\",\r\n  \"out\",\r\n  \"coverage\",\r\n  \".git\",\r\n  \".next\",\r\n  \".turbo\",\r\n  \".svelte-kit\",\r\n]);\r\n\r\nconst MAX_FILE_BYTES = 1_000_000;\r\n\r\n/**\r\n * 3, 4, 6 or 8 hex digits after a `#`. The lookbehind skips URL fragments such\r\n * as `page#abc`, HTML entities such as `&#123456;` and `href=\"#abc\"` anchors.\r\n */\r\nconst HEX_COLOR = /(?<![\\w&#/-])(?<!\\bhref=[\"'])#(?:[0-9a-fA-F]{8}|[0-9a-fA-F]{6}|[0-9a-fA-F]{3,4})(?![\\w-])/g;\r\n\r\n/** A line that contains this text is skipped, for a color that is meant to stay. */\r\nexport const IGNORE_MARKER = \"kit-ignore\";\r\n\r\nconst toPosix = (value: string) => value.split(path.sep).join(\"/\");\r\n\r\nfunction isIgnored(relativePath: string, ignore: string[]): boolean {\r\n  return ignore.some((entry) => {\r\n    const prefix = entry.replace(/\\\\/g, \"/\").replace(/^\\.\\//, \"\").replace(/\\/+$/, \"\");\r\n    return prefix !== \"\" && (relativePath === prefix || relativePath.startsWith(`${prefix}/`));\r\n  });\r\n}\r\n\r\n/** Finds hard-coded hex colors in one piece of text. */\r\nexport function findHexColors(text: string): Array<Omit<Finding, \"file\">> {\r\n  const findings: Array<Omit<Finding, \"file\">> = [];\r\n  const lines = text.split(/\\r?\\n/);\r\n\r\n  lines.forEach((line, index) => {\r\n    if (line.includes(IGNORE_MARKER)) return;\r\n    for (const found of line.matchAll(HEX_COLOR)) {\r\n      findings.push({ line: index + 1, column: (found.index ?? 0) + 1, match: found[0] });\r\n    }\r\n  });\r\n\r\n  return findings;\r\n}\r\n\r\nasync function* walk(directory: string): AsyncGenerator<string> {\r\n  const entries = await readdir(directory, { withFileTypes: true });\r\n  entries.sort((a, b) => a.name.localeCompare(b.name));\r\n\r\n  for (const entry of entries) {\r\n    // Symlinks are skipped so a link back up the tree cannot loop forever.\r\n    if (entry.isSymbolicLink()) continue;\r\n    const full = path.join(directory, entry.name);\r\n\r\n    if (entry.isDirectory()) {\r\n      if (!SKIPPED_DIRECTORIES.has(entry.name)) yield* walk(full);\r\n    } else if (entry.isFile()) {\r\n      yield full;\r\n    }\r\n  }\r\n}\r\n\r\nfunction isScannable(file: string): boolean {\r\n  const name = path.basename(file);\r\n  if (name.includes(\".min.\") || name.endsWith(\".d.ts\")) return false;\r\n  return SCANNED_EXTENSIONS.has(path.extname(name));\r\n}\r\n\r\n/**\r\n * Scans files and folders for hard-coded hex colors. Paths that do not exist\r\n * throw, so a typo in a path is not reported as a clean result.\r\n */\r\nexport async function scanForHardcodedColors(\r\n  cwd: string,\r\n  targets: string[] = [\".\"],\r\n  { ignore = [] }: ScanOptions = {},\r\n): Promise<Finding[]> {\r\n  const findings: Finding[] = [];\r\n  const seen = new Set<string>();\r\n\r\n  for (const target of targets) {\r\n    const root = path.resolve(cwd, target);\r\n    const info = await stat(root);\r\n    const files = info.isDirectory() ? walk(root) : (async function* () { yield root; })();\r\n\r\n    for await (const file of files) {\r\n      if (seen.has(file)) continue;\r\n      seen.add(file);\r\n\r\n      const relative = toPosix(path.relative(cwd, file));\r\n      if (isIgnored(relative, ignore) || !isScannable(file)) continue;\r\n\r\n      const { size } = await stat(file);\r\n      if (size > MAX_FILE_BYTES) continue;\r\n\r\n      const text = await readFile(file, \"utf8\");\r\n      for (const finding of findHexColors(text)) {\r\n        findings.push({ file: relative, ...finding });\r\n      }\r\n    }\r\n  }\r\n\r\n  return findings;\r\n}\r\n","import { readFileSync } from \"node:fs\";\r\nimport { access, writeFile } from \"node:fs/promises\";\r\nimport path from \"node:path\";\r\nimport { parseArgs } from \"node:util\";\r\nimport { densityNames, themeNames } from \"@x12i/tokens\";\r\nimport { CONFIG_FILE, createConfig, isDensityName, isThemeName, loadConfig } from \"./config\";\r\nimport { scanForHardcodedColors } from \"./doctor\";\r\n\r\nexport interface Io {\r\n  cwd: string;\r\n  out: (text: string) => void;\r\n  err: (text: string) => void;\r\n}\r\n\r\n/** Exit codes: 0 success, 1 the command ran and found a problem, 2 bad usage. */\r\ntype ExitCode = 0 | 1 | 2;\r\n\r\nconst HELP = `kit: command line for the Unified UI Kit\r\n\r\nUsage\r\n  kit <command> [options]\r\n\r\nCommands\r\n  init [--theme <name>] [--density <name>] [--force]\r\n        Write ${CONFIG_FILE} in the current folder.\r\n  add <component...>\r\n        Add a component to your project. Planned.\r\n  theme [name]\r\n        List the themes and densities. Generating a theme is planned.\r\n  doctor [paths...] [--json]\r\n        Find hard-coded hex colors that should be --kit- tokens.\r\n        Exits with 1 when it finds any.\r\n\r\nOptions\r\n  -h, --help       Show this help.\r\n  -v, --version    Show the version.\r\n`;\r\n\r\nfunction readVersion(): string {\r\n  const file = new URL(\"../package.json\", import.meta.url);\r\n  return (JSON.parse(readFileSync(file, \"utf8\")) as { version: string }).version;\r\n}\r\n\r\nasync function exists(file: string): Promise<boolean> {\r\n  try {\r\n    await access(file);\r\n    return true;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\nasync function init(values: { theme?: string; density?: string; force?: boolean }, io: Io): Promise<ExitCode> {\r\n  if (values.theme !== undefined && !isThemeName(values.theme)) {\r\n    io.err(`Unknown theme \"${values.theme}\". Choose one of: ${themeNames.join(\", \")}.\\n`);\r\n    return 2;\r\n  }\r\n  if (values.density !== undefined && !isDensityName(values.density)) {\r\n    io.err(`Unknown density \"${values.density}\". Choose one of: ${densityNames.join(\", \")}.\\n`);\r\n    return 2;\r\n  }\r\n\r\n  const target = path.join(io.cwd, CONFIG_FILE);\r\n  if (!values.force && (await exists(target))) {\r\n    io.err(`${CONFIG_FILE} already exists. Use --force to replace it.\\n`);\r\n    return 1;\r\n  }\r\n\r\n  const config = createConfig({ theme: values.theme, density: values.density });\r\n  await writeFile(target, `${JSON.stringify(config, null, 2)}\\n`, \"utf8\");\r\n  io.out(`Created ${CONFIG_FILE}\\n`);\r\n  return 0;\r\n}\r\n\r\nfunction add(components: string[], io: Io): ExitCode {\r\n  const wanted = components.length > 0 ? ` (${components.join(\", \")})` : \"\";\r\n  io.err(\r\n    `kit add${wanted} is not available yet. The component registry is planned. ` +\r\n      `Until then, import components from @x12i/ui.\\n`,\r\n  );\r\n  return 1;\r\n}\r\n\r\nfunction theme(name: string | undefined, io: Io): ExitCode {\r\n  if (name === undefined) {\r\n    io.out(`Themes:    ${themeNames.join(\", \")}\\n`);\r\n    io.out(`Densities: ${densityNames.join(\", \")}\\n`);\r\n    return 0;\r\n  }\r\n\r\n  if (isThemeName(name)) {\r\n    io.out(`\"${name}\" is built in. Import @x12i/themes/${name}.css, or set data-theme=\"${name}\" on <html>.\\n`);\r\n    return 0;\r\n  }\r\n\r\n  io.err(\r\n    `Generating a custom theme is planned and is not available yet. ` +\r\n      `Built-in themes: ${themeNames.join(\", \")}.\\n`,\r\n  );\r\n  return 1;\r\n}\r\n\r\nasync function doctor(paths: string[], json: boolean, io: Io): Promise<ExitCode> {\r\n  const config = await loadConfig(io.cwd);\r\n  const targets = paths.length > 0 ? paths : [\".\"];\r\n\r\n  let findings;\r\n  try {\r\n    findings = await scanForHardcodedColors(io.cwd, targets, { ignore: config?.doctor.ignore });\r\n  } catch (error) {\r\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\r\n      io.err(`Path not found: ${(error as NodeJS.ErrnoException).path ?? targets.join(\", \")}\\n`);\r\n      return 2;\r\n    }\r\n    throw error;\r\n  }\r\n\r\n  if (json) {\r\n    io.out(`${JSON.stringify(findings, null, 2)}\\n`);\r\n    return findings.length > 0 ? 1 : 0;\r\n  }\r\n\r\n  if (findings.length === 0) {\r\n    io.out(\"No hard-coded colors found.\\n\");\r\n    return 0;\r\n  }\r\n\r\n  for (const finding of findings) {\r\n    io.out(`${finding.file}:${finding.line}:${finding.column}  ${finding.match}  Use a --kit- color token.\\n`);\r\n  }\r\n  const files = new Set(findings.map((finding) => finding.file)).size;\r\n  io.out(\r\n    `\\n${findings.length} hard-coded ${findings.length === 1 ? \"color\" : \"colors\"} ` +\r\n      `found in ${files} ${files === 1 ? \"file\" : \"files\"}.\\n`,\r\n  );\r\n  return 1;\r\n}\r\n\r\n/** Runs the command line and returns the exit code. */\r\nexport async function run(argv: string[], io: Io): Promise<ExitCode> {\r\n  let parsed;\r\n  try {\r\n    parsed = parseArgs({\r\n      args: argv,\r\n      allowPositionals: true,\r\n      options: {\r\n        help: { type: \"boolean\", short: \"h\" },\r\n        version: { type: \"boolean\", short: \"v\" },\r\n        force: { type: \"boolean\" },\r\n        json: { type: \"boolean\" },\r\n        theme: { type: \"string\" },\r\n        density: { type: \"string\" },\r\n      },\r\n    });\r\n  } catch (error) {\r\n    io.err(`${(error as Error).message}\\n\\n${HELP}`);\r\n    return 2;\r\n  }\r\n\r\n  const { values, positionals } = parsed;\r\n  const [command, ...rest] = positionals;\r\n\r\n  if (values.version) {\r\n    io.out(`${readVersion()}\\n`);\r\n    return 0;\r\n  }\r\n  if (values.help || command === undefined || command === \"help\") {\r\n    io.out(HELP);\r\n    return 0;\r\n  }\r\n\r\n  switch (command) {\r\n    case \"init\":\r\n      return init(values, io);\r\n    case \"add\":\r\n      return add(rest, io);\r\n    case \"theme\":\r\n      return theme(rest[0], io);\r\n    case \"doctor\":\r\n      return doctor(rest, values.json ?? false, io);\r\n    default:\r\n      io.err(`Unknown command \"${command}\".\\n\\n${HELP}`);\r\n      return 2;\r\n  }\r\n}\r\n","#!/usr/bin/env node\r\nimport { run } from \"./main\";\r\n\r\nprocess.exitCode = await run(process.argv.slice(2), {\r\n  cwd: process.cwd(),\r\n  out: (text) => process.stdout.write(text),\r\n  err: (text) => process.stderr.write(text),\r\n});\r\n"]}

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+import { ThemeName, DensityName } from '@x12i/tokens';
+
+declare const CONFIG_FILE = "kit.config.json";
+declare const CONFIG_VERSION = 1;
+interface KitConfig {
+    version: typeof CONFIG_VERSION;
+    /** The theme the project starts with. */
+    theme: ThemeName;
+    density: DensityName;
+    doctor: {
+        /** Paths, relative to the config file, that `kit doctor` skips. */
+        ignore: string[];
+    };
+}
+declare function createConfig(options?: {
+    theme?: ThemeName;
+    density?: DensityName;
+}): KitConfig;
+/** Reads `kit.config.json` from `cwd`. Returns `null` when there is none. */
+declare function loadConfig(cwd: string): Promise<KitConfig | null>;
+
+interface Finding {
+    /** Path relative to the scan root, with forward slashes. */
+    file: string;
+    line: number;
+    column: number;
+    /** The text that matched, such as `#ff0000`. */
+    match: string;
+}
+interface ScanOptions {
+    /** Paths, relative to `cwd`, to skip. A prefix skips everything under it. */
+    ignore?: string[];
+}
+/** A line that contains this text is skipped, for a color that is meant to stay. */
+declare const IGNORE_MARKER = "kit-ignore";
+/** Finds hard-coded hex colors in one piece of text. */
+declare function findHexColors(text: string): Array<Omit<Finding, "file">>;
+/**
+ * Scans files and folders for hard-coded hex colors. Paths that do not exist
+ * throw, so a typo in a path is not reported as a clean result.
+ */
+declare function scanForHardcodedColors(cwd: string, targets?: string[], { ignore }?: ScanOptions): Promise<Finding[]>;
+
+interface Io {
+    cwd: string;
+    out: (text: string) => void;
+    err: (text: string) => void;
+}
+/** Exit codes: 0 success, 1 the command ran and found a problem, 2 bad usage. */
+type ExitCode = 0 | 1 | 2;
+/** Runs the command line and returns the exit code. */
+declare function run(argv: string[], io: Io): Promise<ExitCode>;
+
+export { CONFIG_FILE, CONFIG_VERSION, IGNORE_MARKER, createConfig, findHexColors, loadConfig, run, scanForHardcodedColors };
+export type { Finding, Io, KitConfig, ScanOptions };

package/dist/index.js

@@ -0,0 +1,309 @@
+import { readFile, stat, readdir, writeFile, access } from 'fs/promises';
+import path2 from 'path';
+import { densityNames, themeNames } from '@x12i/tokens';
+import { readFileSync } from 'fs';
+import { parseArgs } from 'util';
+
+// src/config.ts
+var CONFIG_FILE = "kit.config.json";
+var CONFIG_VERSION = 1;
+function isThemeName(value) {
+  return themeNames.includes(value);
+}
+function isDensityName(value) {
+  return densityNames.includes(value);
+}
+function createConfig(options = {}) {
+  return {
+    version: CONFIG_VERSION,
+    theme: options.theme ?? "light",
+    density: options.density ?? "default",
+    doctor: { ignore: [] }
+  };
+}
+async function loadConfig(cwd) {
+  let text;
+  try {
+    text = await readFile(path2.join(cwd, CONFIG_FILE), "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") return null;
+    throw error;
+  }
+  let raw;
+  try {
+    raw = JSON.parse(text);
+  } catch {
+    throw new Error(`${CONFIG_FILE} is not valid JSON.`);
+  }
+  const input = typeof raw === "object" && raw !== null ? raw : {};
+  const defaults = createConfig();
+  const ignore = input.doctor?.ignore;
+  return {
+    version: CONFIG_VERSION,
+    theme: typeof input.theme === "string" && isThemeName(input.theme) ? input.theme : defaults.theme,
+    density: typeof input.density === "string" && isDensityName(input.density) ? input.density : defaults.density,
+    doctor: {
+      ignore: Array.isArray(ignore) ? ignore.filter((item) => typeof item === "string") : []
+    }
+  };
+}
+var SCANNED_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".css",
+  ".scss",
+  ".sass",
+  ".less",
+  ".ts",
+  ".tsx",
+  ".js",
+  ".jsx",
+  ".mjs",
+  ".cjs",
+  ".html",
+  ".vue",
+  ".svelte",
+  ".mdx"
+]);
+var SKIPPED_DIRECTORIES = /* @__PURE__ */ new Set([
+  "node_modules",
+  "dist",
+  "build",
+  "out",
+  "coverage",
+  ".git",
+  ".next",
+  ".turbo",
+  ".svelte-kit"
+]);
+var MAX_FILE_BYTES = 1e6;
+var HEX_COLOR = /(?<![\w&#/-])(?<!\bhref=["'])#(?:[0-9a-fA-F]{8}|[0-9a-fA-F]{6}|[0-9a-fA-F]{3,4})(?![\w-])/g;
+var IGNORE_MARKER = "kit-ignore";
+var toPosix = (value) => value.split(path2.sep).join("/");
+function isIgnored(relativePath, ignore) {
+  return ignore.some((entry) => {
+    const prefix = entry.replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
+    return prefix !== "" && (relativePath === prefix || relativePath.startsWith(`${prefix}/`));
+  });
+}
+function findHexColors(text) {
+  const findings = [];
+  const lines = text.split(/\r?\n/);
+  lines.forEach((line, index) => {
+    if (line.includes(IGNORE_MARKER)) return;
+    for (const found of line.matchAll(HEX_COLOR)) {
+      findings.push({ line: index + 1, column: (found.index ?? 0) + 1, match: found[0] });
+    }
+  });
+  return findings;
+}
+async function* walk(directory) {
+  const entries = await readdir(directory, { withFileTypes: true });
+  entries.sort((a, b) => a.name.localeCompare(b.name));
+  for (const entry of entries) {
+    if (entry.isSymbolicLink()) continue;
+    const full = path2.join(directory, entry.name);
+    if (entry.isDirectory()) {
+      if (!SKIPPED_DIRECTORIES.has(entry.name)) yield* walk(full);
+    } else if (entry.isFile()) {
+      yield full;
+    }
+  }
+}
+function isScannable(file) {
+  const name = path2.basename(file);
+  if (name.includes(".min.") || name.endsWith(".d.ts")) return false;
+  return SCANNED_EXTENSIONS.has(path2.extname(name));
+}
+async function scanForHardcodedColors(cwd, targets = ["."], { ignore = [] } = {}) {
+  const findings = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const target of targets) {
+    const root = path2.resolve(cwd, target);
+    const info = await stat(root);
+    const files = info.isDirectory() ? walk(root) : (async function* () {
+      yield root;
+    })();
+    for await (const file of files) {
+      if (seen.has(file)) continue;
+      seen.add(file);
+      const relative = toPosix(path2.relative(cwd, file));
+      if (isIgnored(relative, ignore) || !isScannable(file)) continue;
+      const { size } = await stat(file);
+      if (size > MAX_FILE_BYTES) continue;
+      const text = await readFile(file, "utf8");
+      for (const finding of findHexColors(text)) {
+        findings.push({ file: relative, ...finding });
+      }
+    }
+  }
+  return findings;
+}
+var HELP = `kit: command line for the Unified UI Kit
+
+Usage
+  kit <command> [options]
+
+Commands
+  init [--theme <name>] [--density <name>] [--force]
+        Write ${CONFIG_FILE} in the current folder.
+  add <component...>
+        Add a component to your project. Planned.
+  theme [name]
+        List the themes and densities. Generating a theme is planned.
+  doctor [paths...] [--json]
+        Find hard-coded hex colors that should be --kit- tokens.
+        Exits with 1 when it finds any.
+
+Options
+  -h, --help       Show this help.
+  -v, --version    Show the version.
+`;
+function readVersion() {
+  const file = new URL("../package.json", import.meta.url);
+  return JSON.parse(readFileSync(file, "utf8")).version;
+}
+async function exists(file) {
+  try {
+    await access(file);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function init(values, io) {
+  if (values.theme !== void 0 && !isThemeName(values.theme)) {
+    io.err(`Unknown theme "${values.theme}". Choose one of: ${themeNames.join(", ")}.
+`);
+    return 2;
+  }
+  if (values.density !== void 0 && !isDensityName(values.density)) {
+    io.err(`Unknown density "${values.density}". Choose one of: ${densityNames.join(", ")}.
+`);
+    return 2;
+  }
+  const target = path2.join(io.cwd, CONFIG_FILE);
+  if (!values.force && await exists(target)) {
+    io.err(`${CONFIG_FILE} already exists. Use --force to replace it.
+`);
+    return 1;
+  }
+  const config = createConfig({ theme: values.theme, density: values.density });
+  await writeFile(target, `${JSON.stringify(config, null, 2)}
+`, "utf8");
+  io.out(`Created ${CONFIG_FILE}
+`);
+  return 0;
+}
+function add(components, io) {
+  const wanted = components.length > 0 ? ` (${components.join(", ")})` : "";
+  io.err(
+    `kit add${wanted} is not available yet. The component registry is planned. Until then, import components from @x12i/ui.
+`
+  );
+  return 1;
+}
+function theme(name, io) {
+  if (name === void 0) {
+    io.out(`Themes:    ${themeNames.join(", ")}
+`);
+    io.out(`Densities: ${densityNames.join(", ")}
+`);
+    return 0;
+  }
+  if (isThemeName(name)) {
+    io.out(`"${name}" is built in. Import @x12i/themes/${name}.css, or set data-theme="${name}" on <html>.
+`);
+    return 0;
+  }
+  io.err(
+    `Generating a custom theme is planned and is not available yet. Built-in themes: ${themeNames.join(", ")}.
+`
+  );
+  return 1;
+}
+async function doctor(paths, json, io) {
+  const config = await loadConfig(io.cwd);
+  const targets = paths.length > 0 ? paths : ["."];
+  let findings;
+  try {
+    findings = await scanForHardcodedColors(io.cwd, targets, { ignore: config?.doctor.ignore });
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      io.err(`Path not found: ${error.path ?? targets.join(", ")}
+`);
+      return 2;
+    }
+    throw error;
+  }
+  if (json) {
+    io.out(`${JSON.stringify(findings, null, 2)}
+`);
+    return findings.length > 0 ? 1 : 0;
+  }
+  if (findings.length === 0) {
+    io.out("No hard-coded colors found.\n");
+    return 0;
+  }
+  for (const finding of findings) {
+    io.out(`${finding.file}:${finding.line}:${finding.column}  ${finding.match}  Use a --kit- color token.
+`);
+  }
+  const files = new Set(findings.map((finding) => finding.file)).size;
+  io.out(
+    `
+${findings.length} hard-coded ${findings.length === 1 ? "color" : "colors"} found in ${files} ${files === 1 ? "file" : "files"}.
+`
+  );
+  return 1;
+}
+async function run(argv, io) {
+  let parsed;
+  try {
+    parsed = parseArgs({
+      args: argv,
+      allowPositionals: true,
+      options: {
+        help: { type: "boolean", short: "h" },
+        version: { type: "boolean", short: "v" },
+        force: { type: "boolean" },
+        json: { type: "boolean" },
+        theme: { type: "string" },
+        density: { type: "string" }
+      }
+    });
+  } catch (error) {
+    io.err(`${error.message}
+
+${HELP}`);
+    return 2;
+  }
+  const { values, positionals } = parsed;
+  const [command, ...rest] = positionals;
+  if (values.version) {
+    io.out(`${readVersion()}
+`);
+    return 0;
+  }
+  if (values.help || command === void 0 || command === "help") {
+    io.out(HELP);
+    return 0;
+  }
+  switch (command) {
+    case "init":
+      return init(values, io);
+    case "add":
+      return add(rest, io);
+    case "theme":
+      return theme(rest[0], io);
+    case "doctor":
+      return doctor(rest, values.json ?? false, io);
+    default:
+      io.err(`Unknown command "${command}".
+
+${HELP}`);
+      return 2;
+  }
+}
+
+export { CONFIG_FILE, CONFIG_VERSION, IGNORE_MARKER, createConfig, findHexColors, loadConfig, run, scanForHardcodedColors };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/doctor.ts","../src/main.ts"],"names":["path","readFile","themeNames","densityNames"],"mappings":"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","file":"index.js","sourcesContent":["import { readFile } from \"node:fs/promises\";\r\nimport path from \"node:path\";\r\nimport { densityNames, themeNames, type DensityName, type ThemeName } from \"@x12i/tokens\";\r\n\r\nexport const CONFIG_FILE = \"kit.config.json\";\r\nexport const CONFIG_VERSION = 1;\r\n\r\nexport interface KitConfig {\r\n  version: typeof CONFIG_VERSION;\r\n  /** The theme the project starts with. */\r\n  theme: ThemeName;\r\n  density: DensityName;\r\n  doctor: {\r\n    /** Paths, relative to the config file, that `kit doctor` skips. */\r\n    ignore: string[];\r\n  };\r\n}\r\n\r\nexport function isThemeName(value: string): value is ThemeName {\r\n  return (themeNames as readonly string[]).includes(value);\r\n}\r\n\r\nexport function isDensityName(value: string): value is DensityName {\r\n  return (densityNames as readonly string[]).includes(value);\r\n}\r\n\r\nexport function createConfig(options: { theme?: ThemeName; density?: DensityName } = {}): KitConfig {\r\n  return {\r\n    version: CONFIG_VERSION,\r\n    theme: options.theme ?? \"light\",\r\n    density: options.density ?? \"default\",\r\n    doctor: { ignore: [] },\r\n  };\r\n}\r\n\r\n/** Reads `kit.config.json` from `cwd`. Returns `null` when there is none. */\r\nexport async function loadConfig(cwd: string): Promise<KitConfig | null> {\r\n  let text: string;\r\n  try {\r\n    text = await readFile(path.join(cwd, CONFIG_FILE), \"utf8\");\r\n  } catch (error) {\r\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return null;\r\n    throw error;\r\n  }\r\n\r\n  let raw: unknown;\r\n  try {\r\n    raw = JSON.parse(text);\r\n  } catch {\r\n    throw new Error(`${CONFIG_FILE} is not valid JSON.`);\r\n  }\r\n\r\n  const input = (typeof raw === \"object\" && raw !== null ? raw : {}) as Partial<KitConfig>;\r\n  const defaults = createConfig();\r\n  const ignore = input.doctor?.ignore;\r\n\r\n  return {\r\n    version: CONFIG_VERSION,\r\n    theme: typeof input.theme === \"string\" && isThemeName(input.theme) ? input.theme : defaults.theme,\r\n    density:\r\n      typeof input.density === \"string\" && isDensityName(input.density) ? input.density : defaults.density,\r\n    doctor: {\r\n      ignore: Array.isArray(ignore) ? ignore.filter((item): item is string => typeof item === \"string\") : [],\r\n    },\r\n  };\r\n}\r\n","import { readdir, readFile, stat } from \"node:fs/promises\";\r\nimport path from \"node:path\";\r\n\r\nexport interface Finding {\r\n  /** Path relative to the scan root, with forward slashes. */\r\n  file: string;\r\n  line: number;\r\n  column: number;\r\n  /** The text that matched, such as `#ff0000`. */\r\n  match: string;\r\n}\r\n\r\nexport interface ScanOptions {\r\n  /** Paths, relative to `cwd`, to skip. A prefix skips everything under it. */\r\n  ignore?: string[];\r\n}\r\n\r\nconst SCANNED_EXTENSIONS = new Set([\r\n  \".css\",\r\n  \".scss\",\r\n  \".sass\",\r\n  \".less\",\r\n  \".ts\",\r\n  \".tsx\",\r\n  \".js\",\r\n  \".jsx\",\r\n  \".mjs\",\r\n  \".cjs\",\r\n  \".html\",\r\n  \".vue\",\r\n  \".svelte\",\r\n  \".mdx\",\r\n]);\r\n\r\nconst SKIPPED_DIRECTORIES = new Set([\r\n  \"node_modules\",\r\n  \"dist\",\r\n  \"build\",\r\n  \"out\",\r\n  \"coverage\",\r\n  \".git\",\r\n  \".next\",\r\n  \".turbo\",\r\n  \".svelte-kit\",\r\n]);\r\n\r\nconst MAX_FILE_BYTES = 1_000_000;\r\n\r\n/**\r\n * 3, 4, 6 or 8 hex digits after a `#`. The lookbehind skips URL fragments such\r\n * as `page#abc`, HTML entities such as `&#123456;` and `href=\"#abc\"` anchors.\r\n */\r\nconst HEX_COLOR = /(?<![\\w&#/-])(?<!\\bhref=[\"'])#(?:[0-9a-fA-F]{8}|[0-9a-fA-F]{6}|[0-9a-fA-F]{3,4})(?![\\w-])/g;\r\n\r\n/** A line that contains this text is skipped, for a color that is meant to stay. */\r\nexport const IGNORE_MARKER = \"kit-ignore\";\r\n\r\nconst toPosix = (value: string) => value.split(path.sep).join(\"/\");\r\n\r\nfunction isIgnored(relativePath: string, ignore: string[]): boolean {\r\n  return ignore.some((entry) => {\r\n    const prefix = entry.replace(/\\\\/g, \"/\").replace(/^\\.\\//, \"\").replace(/\\/+$/, \"\");\r\n    return prefix !== \"\" && (relativePath === prefix || relativePath.startsWith(`${prefix}/`));\r\n  });\r\n}\r\n\r\n/** Finds hard-coded hex colors in one piece of text. */\r\nexport function findHexColors(text: string): Array<Omit<Finding, \"file\">> {\r\n  const findings: Array<Omit<Finding, \"file\">> = [];\r\n  const lines = text.split(/\\r?\\n/);\r\n\r\n  lines.forEach((line, index) => {\r\n    if (line.includes(IGNORE_MARKER)) return;\r\n    for (const found of line.matchAll(HEX_COLOR)) {\r\n      findings.push({ line: index + 1, column: (found.index ?? 0) + 1, match: found[0] });\r\n    }\r\n  });\r\n\r\n  return findings;\r\n}\r\n\r\nasync function* walk(directory: string): AsyncGenerator<string> {\r\n  const entries = await readdir(directory, { withFileTypes: true });\r\n  entries.sort((a, b) => a.name.localeCompare(b.name));\r\n\r\n  for (const entry of entries) {\r\n    // Symlinks are skipped so a link back up the tree cannot loop forever.\r\n    if (entry.isSymbolicLink()) continue;\r\n    const full = path.join(directory, entry.name);\r\n\r\n    if (entry.isDirectory()) {\r\n      if (!SKIPPED_DIRECTORIES.has(entry.name)) yield* walk(full);\r\n    } else if (entry.isFile()) {\r\n      yield full;\r\n    }\r\n  }\r\n}\r\n\r\nfunction isScannable(file: string): boolean {\r\n  const name = path.basename(file);\r\n  if (name.includes(\".min.\") || name.endsWith(\".d.ts\")) return false;\r\n  return SCANNED_EXTENSIONS.has(path.extname(name));\r\n}\r\n\r\n/**\r\n * Scans files and folders for hard-coded hex colors. Paths that do not exist\r\n * throw, so a typo in a path is not reported as a clean result.\r\n */\r\nexport async function scanForHardcodedColors(\r\n  cwd: string,\r\n  targets: string[] = [\".\"],\r\n  { ignore = [] }: ScanOptions = {},\r\n): Promise<Finding[]> {\r\n  const findings: Finding[] = [];\r\n  const seen = new Set<string>();\r\n\r\n  for (const target of targets) {\r\n    const root = path.resolve(cwd, target);\r\n    const info = await stat(root);\r\n    const files = info.isDirectory() ? walk(root) : (async function* () { yield root; })();\r\n\r\n    for await (const file of files) {\r\n      if (seen.has(file)) continue;\r\n      seen.add(file);\r\n\r\n      const relative = toPosix(path.relative(cwd, file));\r\n      if (isIgnored(relative, ignore) || !isScannable(file)) continue;\r\n\r\n      const { size } = await stat(file);\r\n      if (size > MAX_FILE_BYTES) continue;\r\n\r\n      const text = await readFile(file, \"utf8\");\r\n      for (const finding of findHexColors(text)) {\r\n        findings.push({ file: relative, ...finding });\r\n      }\r\n    }\r\n  }\r\n\r\n  return findings;\r\n}\r\n","import { readFileSync } from \"node:fs\";\r\nimport { access, writeFile } from \"node:fs/promises\";\r\nimport path from \"node:path\";\r\nimport { parseArgs } from \"node:util\";\r\nimport { densityNames, themeNames } from \"@x12i/tokens\";\r\nimport { CONFIG_FILE, createConfig, isDensityName, isThemeName, loadConfig } from \"./config\";\r\nimport { scanForHardcodedColors } from \"./doctor\";\r\n\r\nexport interface Io {\r\n  cwd: string;\r\n  out: (text: string) => void;\r\n  err: (text: string) => void;\r\n}\r\n\r\n/** Exit codes: 0 success, 1 the command ran and found a problem, 2 bad usage. */\r\ntype ExitCode = 0 | 1 | 2;\r\n\r\nconst HELP = `kit: command line for the Unified UI Kit\r\n\r\nUsage\r\n  kit <command> [options]\r\n\r\nCommands\r\n  init [--theme <name>] [--density <name>] [--force]\r\n        Write ${CONFIG_FILE} in the current folder.\r\n  add <component...>\r\n        Add a component to your project. Planned.\r\n  theme [name]\r\n        List the themes and densities. Generating a theme is planned.\r\n  doctor [paths...] [--json]\r\n        Find hard-coded hex colors that should be --kit- tokens.\r\n        Exits with 1 when it finds any.\r\n\r\nOptions\r\n  -h, --help       Show this help.\r\n  -v, --version    Show the version.\r\n`;\r\n\r\nfunction readVersion(): string {\r\n  const file = new URL(\"../package.json\", import.meta.url);\r\n  return (JSON.parse(readFileSync(file, \"utf8\")) as { version: string }).version;\r\n}\r\n\r\nasync function exists(file: string): Promise<boolean> {\r\n  try {\r\n    await access(file);\r\n    return true;\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\nasync function init(values: { theme?: string; density?: string; force?: boolean }, io: Io): Promise<ExitCode> {\r\n  if (values.theme !== undefined && !isThemeName(values.theme)) {\r\n    io.err(`Unknown theme \"${values.theme}\". Choose one of: ${themeNames.join(\", \")}.\\n`);\r\n    return 2;\r\n  }\r\n  if (values.density !== undefined && !isDensityName(values.density)) {\r\n    io.err(`Unknown density \"${values.density}\". Choose one of: ${densityNames.join(\", \")}.\\n`);\r\n    return 2;\r\n  }\r\n\r\n  const target = path.join(io.cwd, CONFIG_FILE);\r\n  if (!values.force && (await exists(target))) {\r\n    io.err(`${CONFIG_FILE} already exists. Use --force to replace it.\\n`);\r\n    return 1;\r\n  }\r\n\r\n  const config = createConfig({ theme: values.theme, density: values.density });\r\n  await writeFile(target, `${JSON.stringify(config, null, 2)}\\n`, \"utf8\");\r\n  io.out(`Created ${CONFIG_FILE}\\n`);\r\n  return 0;\r\n}\r\n\r\nfunction add(components: string[], io: Io): ExitCode {\r\n  const wanted = components.length > 0 ? ` (${components.join(\", \")})` : \"\";\r\n  io.err(\r\n    `kit add${wanted} is not available yet. The component registry is planned. ` +\r\n      `Until then, import components from @x12i/ui.\\n`,\r\n  );\r\n  return 1;\r\n}\r\n\r\nfunction theme(name: string | undefined, io: Io): ExitCode {\r\n  if (name === undefined) {\r\n    io.out(`Themes:    ${themeNames.join(\", \")}\\n`);\r\n    io.out(`Densities: ${densityNames.join(\", \")}\\n`);\r\n    return 0;\r\n  }\r\n\r\n  if (isThemeName(name)) {\r\n    io.out(`\"${name}\" is built in. Import @x12i/themes/${name}.css, or set data-theme=\"${name}\" on <html>.\\n`);\r\n    return 0;\r\n  }\r\n\r\n  io.err(\r\n    `Generating a custom theme is planned and is not available yet. ` +\r\n      `Built-in themes: ${themeNames.join(\", \")}.\\n`,\r\n  );\r\n  return 1;\r\n}\r\n\r\nasync function doctor(paths: string[], json: boolean, io: Io): Promise<ExitCode> {\r\n  const config = await loadConfig(io.cwd);\r\n  const targets = paths.length > 0 ? paths : [\".\"];\r\n\r\n  let findings;\r\n  try {\r\n    findings = await scanForHardcodedColors(io.cwd, targets, { ignore: config?.doctor.ignore });\r\n  } catch (error) {\r\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\r\n      io.err(`Path not found: ${(error as NodeJS.ErrnoException).path ?? targets.join(\", \")}\\n`);\r\n      return 2;\r\n    }\r\n    throw error;\r\n  }\r\n\r\n  if (json) {\r\n    io.out(`${JSON.stringify(findings, null, 2)}\\n`);\r\n    return findings.length > 0 ? 1 : 0;\r\n  }\r\n\r\n  if (findings.length === 0) {\r\n    io.out(\"No hard-coded colors found.\\n\");\r\n    return 0;\r\n  }\r\n\r\n  for (const finding of findings) {\r\n    io.out(`${finding.file}:${finding.line}:${finding.column}  ${finding.match}  Use a --kit- color token.\\n`);\r\n  }\r\n  const files = new Set(findings.map((finding) => finding.file)).size;\r\n  io.out(\r\n    `\\n${findings.length} hard-coded ${findings.length === 1 ? \"color\" : \"colors\"} ` +\r\n      `found in ${files} ${files === 1 ? \"file\" : \"files\"}.\\n`,\r\n  );\r\n  return 1;\r\n}\r\n\r\n/** Runs the command line and returns the exit code. */\r\nexport async function run(argv: string[], io: Io): Promise<ExitCode> {\r\n  let parsed;\r\n  try {\r\n    parsed = parseArgs({\r\n      args: argv,\r\n      allowPositionals: true,\r\n      options: {\r\n        help: { type: \"boolean\", short: \"h\" },\r\n        version: { type: \"boolean\", short: \"v\" },\r\n        force: { type: \"boolean\" },\r\n        json: { type: \"boolean\" },\r\n        theme: { type: \"string\" },\r\n        density: { type: \"string\" },\r\n      },\r\n    });\r\n  } catch (error) {\r\n    io.err(`${(error as Error).message}\\n\\n${HELP}`);\r\n    return 2;\r\n  }\r\n\r\n  const { values, positionals } = parsed;\r\n  const [command, ...rest] = positionals;\r\n\r\n  if (values.version) {\r\n    io.out(`${readVersion()}\\n`);\r\n    return 0;\r\n  }\r\n  if (values.help || command === undefined || command === \"help\") {\r\n    io.out(HELP);\r\n    return 0;\r\n  }\r\n\r\n  switch (command) {\r\n    case \"init\":\r\n      return init(values, io);\r\n    case \"add\":\r\n      return add(rest, io);\r\n    case \"theme\":\r\n      return theme(rest[0], io);\r\n    case \"doctor\":\r\n      return doctor(rest, values.json ?? false, io);\r\n    default:\r\n      io.err(`Unknown command \"${command}\".\\n\\n${HELP}`);\r\n      return 2;\r\n  }\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@x12i/kit-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "Command line for the Unified UI Kit: init, doctor, and stubs for add and theme.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/x12i/unified-ui-kit.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/x12i/unified-ui-kit/tree/main/packages/cli#readme",
+  "bugs": {
+    "url": "https://github.com/x12i/unified-ui-kit/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "bin": {
+    "kit": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@x12i/tokens": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run"
+  }
 }