@bezel-labs/bezel-kit 0.1.0 → 0.3.0

package/dist/cli.js

@@ -1,36 +1,56 @@
 #!/usr/bin/env node
 import {
-  generateVariablesCss
-} from "./chunk-WLGTZBXW.js";
-import "./chunk-5EW7EW3R.js";
+  generateVariablesCss,
+  initConfig,
+  readPackageScripts
+} from "./chunk-FGX7KW2Z.js";
+import {
+  DEFAULT_CONFIG_FILE,
+  DEFAULT_VARIABLES_OUTPUT
+} from "./chunk-T6DKROBI.js";
 
 // src/cli.ts
 import { existsSync } from "fs";
 import { readFile } from "fs/promises";
 import { pathToFileURL } from "url";
 import { parseArgs } from "util";
-import { resolve } from "path";
+import { relative, resolve } from "path";
 var USAGE = `bezel \u2014 convert a W3C Design Tokens (DTCG) file into a scoped variables.css
 
 Usage:
-  bezel build [options]
+  bezel init [options]     Create a bezel.json for this project
+  bezel build [options]    Generate the outputs (default command)
 
 Reads design-tokens.json from the project root (the working directory).
 
-Options:
+init options:
+      --dir <path>              Directory for all outputs
+                                (default: src/bezel, or bezel with no src/)
+      --variables-output <path> Override just the CSS path
+      --contexts-output <path>  Override just the contexts module path
+      --fonts-output <path>     Override just the fonts module path
+      --no-contexts             Skip the generated CONTEXTS module
+      --no-fonts                Skip the generated FONTS module
+      --color <format>          Color output: oklch | hex (default: oklch)
+      --unit <mode>             Dimension unit: preserve | rem (default: preserve)
+  -f, --force                   Overwrite an existing bezel.json
+
+build options:
   -c, --config <path>           Config file (.json or .js exporting BezelOptions)
-      --variables-output <path> Output CSS file (default: variables.css)
+      --variables-output <path> Output CSS file (default: ${DEFAULT_VARIABLES_OUTPUT})
       --contexts-output <path>  Also write a generated TS module exporting CONTEXTS
       --fonts-output <path>     Also write a generated TS module exporting FONTS
       --color <format>          Color output: oklch | hex (default: oklch)
       --unit <mode>             Dimension unit: preserve | rem (default: preserve)
       --stdout                  Print CSS to stdout instead of writing the file
       --no-gitignore            Don't create/update .gitignore for generated files
+
   -h, --help                    Show this help
 
-A bezel.json file in the working directory is loaded automatically when -c is omitted.
+A ${DEFAULT_CONFIG_FILE} file in the working directory is loaded automatically when -c is omitted.
+The contexts/fonts modules are TypeScript, so init only scaffolds them for a
+TypeScript project unless you pass the paths explicitly.
 `;
-var DEFAULT_CONFIG_FILE = "bezel.json";
 async function loadConfig(path) {
   const abs = resolve(process.cwd(), path);
   if (/\.json$/.test(abs)) {
@@ -39,34 +59,71 @@ async function loadConfig(path) {
   const mod = await import(pathToFileURL(abs).href);
   return mod.default ?? mod;
 }
-async function main(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: {
-      config: { type: "string", short: "c" },
-      "variables-output": { type: "string" },
-      "contexts-output": { type: "string" },
-      "fonts-output": { type: "string" },
-      color: { type: "string" },
-      unit: { type: "string" },
-      stdout: { type: "boolean" },
-      "no-gitignore": { type: "boolean" },
-      help: { type: "boolean", short: "h" }
-    }
+var OPTIONS = {
+  config: { type: "string", short: "c" },
+  dir: { type: "string" },
+  "variables-output": { type: "string" },
+  "contexts-output": { type: "string" },
+  "fonts-output": { type: "string" },
+  color: { type: "string" },
+  unit: { type: "string" },
+  stdout: { type: "boolean" },
+  "no-gitignore": { type: "boolean" },
+  "no-contexts": { type: "boolean" },
+  "no-fonts": { type: "boolean" },
+  force: { type: "boolean", short: "f" },
+  help: { type: "boolean", short: "h" }
+};
+async function runInit(values) {
+  const cwd = process.cwd();
+  const result = await initConfig({
+    cwd,
+    outputDir: values.dir,
+    variablesOutput: values["variables-output"],
+    contextsOutput: values["contexts-output"],
+    fontsOutput: values["fonts-output"],
+    contexts: values["no-contexts"] ? false : void 0,
+    fonts: values["no-fonts"] ? false : void 0,
+    colorFormat: values.color,
+    dimensionUnit: values.unit,
+    force: values.force
   });
-  if (values.help || positionals[0] === "help") {
-    process.stdout.write(USAGE);
-    return;
-  }
-  const command = positionals[0] ?? "build";
-  if (command !== "build") {
-    process.stderr.write(`bezel: unknown command "${command}".
-
-${USAGE}`);
+  const configName = relative(cwd, result.configPath) || DEFAULT_CONFIG_FILE;
+  if (!result.written) {
+    process.stderr.write(
+      `bezel: ${configName} already exists \u2014 leaving it alone. Re-run with --force to overwrite.
+`
+    );
     process.exitCode = 1;
     return;
   }
+  const outputs = [
+    result.config.variablesOutput,
+    result.config.contextsOutput,
+    result.config.fontsOutput
+  ].filter((p) => p !== void 0);
+  process.stderr.write(`bezel: wrote ${configName}
+`);
+  for (const output of outputs) {
+    process.stderr.write(`bezel:   ${output}
+`);
+  }
+  const scripts = await readPackageScripts(cwd);
+  const steps = [];
+  if (!result.hasTokensFile) {
+    steps.push(
+      "Add design-tokens.json to the project root \u2014 ask your AI agent for it via the\n     Bezel MCP, or download it from your project."
+    );
+  }
+  if (!scripts["tokens"]) {
+    steps.push('Add "tokens": "bezel build" to your package.json scripts.');
+  }
+  steps.push(`Run the build, then import ${result.config.variablesOutput} in your entry file.`);
+  process.stderr.write("\nNext:\n");
+  steps.forEach((step, i) => process.stderr.write(`  ${i + 1}. ${step}
+`));
+}
+async function runBuild(values) {
   const configPath = values.config ?? (existsSync(resolve(process.cwd(), DEFAULT_CONFIG_FILE)) ? DEFAULT_CONFIG_FILE : void 0);
   const fileConfig = configPath ? await loadConfig(configPath) : {};
   const options = { ...fileConfig };
@@ -81,10 +138,34 @@ ${USAGE}`);
   if (values.stdout) {
     process.stdout.write(css);
   } else {
-    process.stderr.write(`bezel: wrote ${options.variablesOutput ?? "variables.css"}
+    process.stderr.write(`bezel: wrote ${options.variablesOutput ?? DEFAULT_VARIABLES_OUTPUT}
 `);
   }
 }
+async function main(argv) {
+  const { values, positionals } = parseArgs({
+    args: argv,
+    allowPositionals: true,
+    options: OPTIONS
+  });
+  if (values.help || positionals[0] === "help") {
+    process.stdout.write(USAGE);
+    return;
+  }
+  const command = positionals[0] ?? "build";
+  if (command === "init") {
+    await runInit(values);
+    return;
+  }
+  if (command !== "build") {
+    process.stderr.write(`bezel: unknown command "${command}".
+
+${USAGE}`);
+    process.exitCode = 1;
+    return;
+  }
+  await runBuild(values);
+}
 main(process.argv.slice(2)).catch((err) => {
   process.stderr.write(`${err instanceof Error ? err.message : String(err)}
 `);

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { existsSync } from \"node:fs\"\nimport { readFile } from \"node:fs/promises\"\nimport { pathToFileURL } from \"node:url\"\nimport { parseArgs } from \"node:util\"\nimport { resolve } from \"node:path\"\nimport { generateVariablesCss } from \"./node\"\nimport type { BezelOptions } from \"./config\"\n\nconst USAGE = `bezel — convert a W3C Design Tokens (DTCG) file into a scoped variables.css\n\nUsage:\n  bezel build [options]\n\nReads design-tokens.json from the project root (the working directory).\n\nOptions:\n  -c, --config <path>           Config file (.json or .js exporting BezelOptions)\n      --variables-output <path> Output CSS file (default: variables.css)\n      --contexts-output <path>  Also write a generated TS module exporting CONTEXTS\n      --fonts-output <path>     Also write a generated TS module exporting FONTS\n      --color <format>          Color output: oklch | hex (default: oklch)\n      --unit <mode>             Dimension unit: preserve | rem (default: preserve)\n      --stdout                  Print CSS to stdout instead of writing the file\n      --no-gitignore            Don't create/update .gitignore for generated files\n  -h, --help                    Show this help\n\nA bezel.json file in the working directory is loaded automatically when -c is omitted.\n`\n\n/** Default config file auto-loaded from the working directory when no -c is given. */\nconst DEFAULT_CONFIG_FILE = \"bezel.json\"\n\n/** Load options from a `.json` or `.js`/`.mjs` config file. */\nasync function loadConfig(path: string): Promise<BezelOptions> {\n  const abs = resolve(process.cwd(), path)\n  if (/\\.json$/.test(abs)) {\n    return JSON.parse(await readFile(abs, \"utf8\")) as BezelOptions\n  }\n  const mod = (await import(pathToFileURL(abs).href)) as {\n    default?: BezelOptions\n  } & BezelOptions\n  return (mod.default ?? mod) as BezelOptions\n}\n\nasync function main(argv: string[]): Promise<void> {\n  const { values, positionals } = parseArgs({\n    args: argv,\n    allowPositionals: true,\n    options: {\n      config: { type: \"string\", short: \"c\" },\n      \"variables-output\": { type: \"string\" },\n      \"contexts-output\": { type: \"string\" },\n      \"fonts-output\": { type: \"string\" },\n      color: { type: \"string\" },\n      unit: { type: \"string\" },\n      stdout: { type: \"boolean\" },\n      \"no-gitignore\": { type: \"boolean\" },\n      help: { type: \"boolean\", short: \"h\" },\n    },\n  })\n\n  if (values.help || positionals[0] === \"help\") {\n    process.stdout.write(USAGE)\n    return\n  }\n\n  const command = positionals[0] ?? \"build\"\n  if (command !== \"build\") {\n    process.stderr.write(`bezel: unknown command \"${command}\".\\n\\n${USAGE}`)\n    process.exitCode = 1\n    return\n  }\n\n  const configPath =\n    values.config ??\n    (existsSync(resolve(process.cwd(), DEFAULT_CONFIG_FILE))\n      ? DEFAULT_CONFIG_FILE\n      : undefined)\n  const fileConfig = configPath ? await loadConfig(configPath) : {}\n\n  const options: BezelOptions = { ...fileConfig }\n  if (values[\"variables-output\"]) options.variablesOutput = values[\"variables-output\"]\n  if (values[\"contexts-output\"]) options.contextsOutput = values[\"contexts-output\"]\n  if (values[\"fonts-output\"]) options.fontsOutput = values[\"fonts-output\"]\n  if (values.color) options.colorFormat = values.color as BezelOptions[\"colorFormat\"]\n  if (values.unit) options.dimensionUnit = values.unit as BezelOptions[\"dimensionUnit\"]\n  if (values.stdout) options.write = false\n  if (values[\"no-gitignore\"]) options.gitignore = false\n\n  const css = await generateVariablesCss(options)\n\n  if (values.stdout) {\n    process.stdout.write(css)\n  } else {\n    process.stderr.write(`bezel: wrote ${options.variablesOutput ?? \"variables.css\"}\\n`)\n  }\n}\n\nmain(process.argv.slice(2)).catch((err: unknown) => {\n  process.stderr.write(`${err instanceof Error ? err.message : String(err)}\\n`)\n  process.exitCode = 1\n})\n"],"mappings":";;;;;;;AACA,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB;AACzB,SAAS,qBAAqB;AAC9B,SAAS,iBAAiB;AAC1B,SAAS,eAAe;AAIxB,IAAM,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsBd,IAAM,sBAAsB;AAG5B,eAAe,WAAW,MAAqC;AAC7D,QAAM,MAAM,QAAQ,QAAQ,IAAI,GAAG,IAAI;AACvC,MAAI,UAAU,KAAK,GAAG,GAAG;AACvB,WAAO,KAAK,MAAM,MAAM,SAAS,KAAK,MAAM,CAAC;AAAA,EAC/C;AACA,QAAM,MAAO,MAAM,OAAO,cAAc,GAAG,EAAE;AAG7C,SAAQ,IAAI,WAAW;AACzB;AAEA,eAAe,KAAK,MAA+B;AACjD,QAAM,EAAE,QAAQ,YAAY,IAAI,UAAU;AAAA,IACxC,MAAM;AAAA,IACN,kBAAkB;AAAA,IAClB,SAAS;AAAA,MACP,QAAQ,EAAE,MAAM,UAAU,OAAO,IAAI;AAAA,MACrC,oBAAoB,EAAE,MAAM,SAAS;AAAA,MACrC,mBAAmB,EAAE,MAAM,SAAS;AAAA,MACpC,gBAAgB,EAAE,MAAM,SAAS;AAAA,MACjC,OAAO,EAAE,MAAM,SAAS;AAAA,MACxB,MAAM,EAAE,MAAM,SAAS;AAAA,MACvB,QAAQ,EAAE,MAAM,UAAU;AAAA,MAC1B,gBAAgB,EAAE,MAAM,UAAU;AAAA,MAClC,MAAM,EAAE,MAAM,WAAW,OAAO,IAAI;AAAA,IACtC;AAAA,EACF,CAAC;AAED,MAAI,OAAO,QAAQ,YAAY,CAAC,MAAM,QAAQ;AAC5C,YAAQ,OAAO,MAAM,KAAK;AAC1B;AAAA,EACF;AAEA,QAAM,UAAU,YAAY,CAAC,KAAK;AAClC,MAAI,YAAY,SAAS;AACvB,YAAQ,OAAO,MAAM,2BAA2B,OAAO;AAAA;AAAA,EAAS,KAAK,EAAE;AACvE,YAAQ,WAAW;AACnB;AAAA,EACF;AAEA,QAAM,aACJ,OAAO,WACN,WAAW,QAAQ,QAAQ,IAAI,GAAG,mBAAmB,CAAC,IACnD,sBACA;AACN,QAAM,aAAa,aAAa,MAAM,WAAW,UAAU,IAAI,CAAC;AAEhE,QAAM,UAAwB,EAAE,GAAG,WAAW;AAC9C,MAAI,OAAO,kBAAkB,EAAG,SAAQ,kBAAkB,OAAO,kBAAkB;AACnF,MAAI,OAAO,iBAAiB,EAAG,SAAQ,iBAAiB,OAAO,iBAAiB;AAChF,MAAI,OAAO,cAAc,EAAG,SAAQ,cAAc,OAAO,cAAc;AACvE,MAAI,OAAO,MAAO,SAAQ,cAAc,OAAO;AAC/C,MAAI,OAAO,KAAM,SAAQ,gBAAgB,OAAO;AAChD,MAAI,OAAO,OAAQ,SAAQ,QAAQ;AACnC,MAAI,OAAO,cAAc,EAAG,SAAQ,YAAY;AAEhD,QAAM,MAAM,MAAM,qBAAqB,OAAO;AAE9C,MAAI,OAAO,QAAQ;AACjB,YAAQ,OAAO,MAAM,GAAG;AAAA,EAC1B,OAAO;AACL,YAAQ,OAAO,MAAM,gBAAgB,QAAQ,mBAAmB,eAAe;AAAA,CAAI;AAAA,EACrF;AACF;AAEA,KAAK,QAAQ,KAAK,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,QAAiB;AAClD,UAAQ,OAAO,MAAM,GAAG,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,CAAI;AAC5E,UAAQ,WAAW;AACrB,CAAC;","names":[]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { existsSync } from \"node:fs\"\nimport { readFile } from \"node:fs/promises\"\nimport { pathToFileURL } from \"node:url\"\nimport { parseArgs } from \"node:util\"\nimport { relative, resolve } from \"node:path\"\nimport { generateVariablesCss } from \"./node\"\nimport { initConfig, readPackageScripts } from \"./init\"\nimport type { BezelOptions } from \"./config\"\nimport { DEFAULT_CONFIG_FILE, DEFAULT_VARIABLES_OUTPUT } from \"./defaults\"\n\nconst USAGE = `bezel — convert a W3C Design Tokens (DTCG) file into a scoped variables.css\n\nUsage:\n  bezel init [options]     Create a bezel.json for this project\n  bezel build [options]    Generate the outputs (default command)\n\nReads design-tokens.json from the project root (the working directory).\n\ninit options:\n      --dir <path>              Directory for all outputs\n                                (default: src/bezel, or bezel with no src/)\n      --variables-output <path> Override just the CSS path\n      --contexts-output <path>  Override just the contexts module path\n      --fonts-output <path>     Override just the fonts module path\n      --no-contexts             Skip the generated CONTEXTS module\n      --no-fonts                Skip the generated FONTS module\n      --color <format>          Color output: oklch | hex (default: oklch)\n      --unit <mode>             Dimension unit: preserve | rem (default: preserve)\n  -f, --force                   Overwrite an existing bezel.json\n\nbuild options:\n  -c, --config <path>           Config file (.json or .js exporting BezelOptions)\n      --variables-output <path> Output CSS file (default: ${DEFAULT_VARIABLES_OUTPUT})\n      --contexts-output <path>  Also write a generated TS module exporting CONTEXTS\n      --fonts-output <path>     Also write a generated TS module exporting FONTS\n      --color <format>          Color output: oklch | hex (default: oklch)\n      --unit <mode>             Dimension unit: preserve | rem (default: preserve)\n      --stdout                  Print CSS to stdout instead of writing the file\n      --no-gitignore            Don't create/update .gitignore for generated files\n\n  -h, --help                    Show this help\n\nA ${DEFAULT_CONFIG_FILE} file in the working directory is loaded automatically when -c is omitted.\nThe contexts/fonts modules are TypeScript, so init only scaffolds them for a\nTypeScript project unless you pass the paths explicitly.\n`\n\n/** Load options from a `.json` or `.js`/`.mjs` config file. */\nasync function loadConfig(path: string): Promise<BezelOptions> {\n  const abs = resolve(process.cwd(), path)\n  if (/\\.json$/.test(abs)) {\n    return JSON.parse(await readFile(abs, \"utf8\")) as BezelOptions\n  }\n  const mod = (await import(pathToFileURL(abs).href)) as {\n    default?: BezelOptions\n  } & BezelOptions\n  return (mod.default ?? mod) as BezelOptions\n}\n\ntype Values = ReturnType<typeof parseArgs<{ options: typeof OPTIONS }>>[\"values\"]\n\nconst OPTIONS = {\n  config: { type: \"string\", short: \"c\" },\n  dir: { type: \"string\" },\n  \"variables-output\": { type: \"string\" },\n  \"contexts-output\": { type: \"string\" },\n  \"fonts-output\": { type: \"string\" },\n  color: { type: \"string\" },\n  unit: { type: \"string\" },\n  stdout: { type: \"boolean\" },\n  \"no-gitignore\": { type: \"boolean\" },\n  \"no-contexts\": { type: \"boolean\" },\n  \"no-fonts\": { type: \"boolean\" },\n  force: { type: \"boolean\", short: \"f\" },\n  help: { type: \"boolean\", short: \"h\" },\n} as const\n\n/** `bezel init` — scaffold a bezel.json, then print what to do next. */\nasync function runInit(values: Values): Promise<void> {\n  const cwd = process.cwd()\n  const result = await initConfig({\n    cwd,\n    outputDir: values.dir,\n    variablesOutput: values[\"variables-output\"],\n    contextsOutput: values[\"contexts-output\"],\n    fontsOutput: values[\"fonts-output\"],\n    contexts: values[\"no-contexts\"] ? false : undefined,\n    fonts: values[\"no-fonts\"] ? false : undefined,\n    colorFormat: values.color as BezelOptions[\"colorFormat\"],\n    dimensionUnit: values.unit as BezelOptions[\"dimensionUnit\"],\n    force: values.force,\n  })\n\n  const configName = relative(cwd, result.configPath) || DEFAULT_CONFIG_FILE\n\n  if (!result.written) {\n    process.stderr.write(\n      `bezel: ${configName} already exists — leaving it alone. Re-run with --force to overwrite.\\n`,\n    )\n    process.exitCode = 1\n    return\n  }\n\n  const outputs = [\n    result.config.variablesOutput,\n    result.config.contextsOutput,\n    result.config.fontsOutput,\n  ].filter((p): p is string => p !== undefined)\n\n  process.stderr.write(`bezel: wrote ${configName}\\n`)\n  for (const output of outputs) {\n    process.stderr.write(`bezel:   ${output}\\n`)\n  }\n\n  const scripts = await readPackageScripts(cwd)\n  const steps: string[] = []\n\n  if (!result.hasTokensFile) {\n    steps.push(\n      \"Add design-tokens.json to the project root — ask your AI agent for it via the\\n     Bezel MCP, or download it from your project.\",\n    )\n  }\n  if (!scripts[\"tokens\"]) {\n    steps.push('Add \"tokens\": \"bezel build\" to your package.json scripts.')\n  }\n  steps.push(`Run the build, then import ${result.config.variablesOutput} in your entry file.`)\n\n  process.stderr.write(\"\\nNext:\\n\")\n  steps.forEach((step, i) => process.stderr.write(`  ${i + 1}. ${step}\\n`))\n}\n\n/** `bezel build` — generate the outputs. */\nasync function runBuild(values: Values): Promise<void> {\n  const configPath =\n    values.config ??\n    (existsSync(resolve(process.cwd(), DEFAULT_CONFIG_FILE)) ? DEFAULT_CONFIG_FILE : undefined)\n  const fileConfig = configPath ? await loadConfig(configPath) : {}\n\n  const options: BezelOptions = { ...fileConfig }\n  if (values[\"variables-output\"]) options.variablesOutput = values[\"variables-output\"]\n  if (values[\"contexts-output\"]) options.contextsOutput = values[\"contexts-output\"]\n  if (values[\"fonts-output\"]) options.fontsOutput = values[\"fonts-output\"]\n  if (values.color) options.colorFormat = values.color as BezelOptions[\"colorFormat\"]\n  if (values.unit) options.dimensionUnit = values.unit as BezelOptions[\"dimensionUnit\"]\n  if (values.stdout) options.write = false\n  if (values[\"no-gitignore\"]) options.gitignore = false\n\n  const css = await generateVariablesCss(options)\n\n  if (values.stdout) {\n    process.stdout.write(css)\n  } else {\n    process.stderr.write(`bezel: wrote ${options.variablesOutput ?? DEFAULT_VARIABLES_OUTPUT}\\n`)\n  }\n}\n\nasync function main(argv: string[]): Promise<void> {\n  const { values, positionals } = parseArgs({\n    args: argv,\n    allowPositionals: true,\n    options: OPTIONS,\n  })\n\n  if (values.help || positionals[0] === \"help\") {\n    process.stdout.write(USAGE)\n    return\n  }\n\n  const command = positionals[0] ?? \"build\"\n\n  if (command === \"init\") {\n    await runInit(values)\n    return\n  }\n\n  if (command !== \"build\") {\n    process.stderr.write(`bezel: unknown command \"${command}\".\\n\\n${USAGE}`)\n    process.exitCode = 1\n    return\n  }\n\n  await runBuild(values)\n}\n\nmain(process.argv.slice(2)).catch((err: unknown) => {\n  process.stderr.write(`${err instanceof Error ? err.message : String(err)}\\n`)\n  process.exitCode = 1\n})\n"],"mappings":"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","names":[]}

package/dist/index-GGPx58oG.d.cts

@@ -0,0 +1,147 @@
+/**
+ * Options for the pure CSS transform ({@link tokensToCss}/{@link emitCss}),
+ * decoupled from any filesystem concern so they work in any environment.
+ * All optional; defaults make the zero-config case work.
+ */
+interface CssOptions {
+    /**
+     * Map of context name → CSS selector. The first entry is the base context (full
+     * output); every other context emits only the variables that differ from the base.
+     * Default: `{ "$root": ":root", "dark": ".dark", "light": ".light" }`.
+     */
+    contexts?: Record<string, string>;
+    /** Color serialization. Default: `"oklch"`. */
+    colorFormat?: "oklch" | "hex";
+    /** Dimension handling: keep the authored unit, or convert `px` → `rem`. Default: `"preserve"`. */
+    dimensionUnit?: "preserve" | "rem";
+    /** `$extensions` key holding the `exportName` array. Default: `"com.bezel.app"`. */
+    nameExtension?: string;
+}
+/** Fully-resolved CSS-transform options (no `undefined`). */
+interface ResolvedCssOptions {
+    contexts: Record<string, string>;
+    colorFormat: "oklch" | "hex";
+    dimensionUnit: "preserve" | "rem";
+    nameExtension: string;
+}
+/** Apply defaults to {@link CssOptions}. Pure — no path resolution, no `node:*`. */
+declare function resolveCssOptions(options?: CssOptions): ResolvedCssOptions;
+
+/**
+ * Minimal type surface for the W3C Design Tokens (DTCG) 2025.10 format, plus
+ * the internal shapes the generator passes between stages.
+ *
+ * @see https://www.designtokens.org/tr/2025.10/format/
+ */
+/** A DTCG color value (e.g. `{ colorSpace: "oklch", components: [...], hex, alpha }`). */
+interface ColorValue {
+    colorSpace: string;
+    components: number[];
+    hex?: string;
+    alpha?: number;
+}
+/** A DTCG dimension value (e.g. `{ value: 12, unit: "px" }`). */
+interface DimensionValue {
+    value: number;
+    unit: string;
+}
+/** Any DTCG token value: a literal, a reference string `"{a.b.c}"`, or a typed object. */
+type TokenValue = string | number | ColorValue | DimensionValue | (string | number)[] | Record<string, unknown>;
+/**
+ * An arbitrary DTCG node — either a group (nested nodes) or a token (`$value`).
+ * Indexed loosely because we walk it structurally rather than by a fixed schema.
+ */
+interface DtcgNode {
+    $value?: TokenValue;
+    $type?: string;
+    $description?: string;
+    $extensions?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** A single logical token after the tree has been collapsed + flattened for one context. */
+interface FlatToken {
+    /** Dot-path of the token in the source tree (contexts already stripped). */
+    path: string;
+    /** The token's value for the active context (may still be a `"{ref}"`). */
+    value: TokenValue;
+    /** Resolved/inherited `$type`, if known. */
+    type?: string;
+    /** Vendor extensions carried through from the source token. */
+    extensions?: Record<string, unknown>;
+}
+
+/**
+ * Pure default constants shared by the isomorphic core and the Node layer.
+ * Kept free of `node:*` imports so the browser/edge entry can use them.
+ */
+/** Default context → selector mapping. The first key is the base context. */
+declare const DEFAULT_CONTEXTS: Record<string, string>;
+/**
+ * Directory generated outputs are written to, relative to the project root.
+ *
+ * Everything Bezel emits is generated and gitignored, and `bezel build` overwrites
+ * without asking — so outputs live in their own directory rather than alongside
+ * hand-written files, where a generic name like `variables.css` or `fonts.ts` could
+ * silently clobber something the user wrote. {@link FALLBACK_OUTPUT_DIR} is used by
+ * `bezel init` for projects with no `src/`.
+ */
+declare const DEFAULT_OUTPUT_DIR = "src/bezel";
+/** Output directory `bezel init` picks when the project has no `src/`. */
+declare const FALLBACK_OUTPUT_DIR = "bezel";
+declare const DEFAULT_NAME_EXTENSION = "com.bezel.app";
+/** The config file `bezel init` writes and `bezel build` auto-loads from the project root. */
+declare const DEFAULT_CONFIG_FILE = "bezel.json";
+
+/**
+ * Convert a DTCG token tree into a scoped CSS string. The first context in
+ * `options.contexts` is the base (emitted in full); every other context emits
+ * only the variables whose value differs from the base.
+ */
+declare function emitCss(tokens: DtcgNode, options: ResolvedCssOptions): string;
+
+/** Name the `$root` context maps to in generated output (matches the `:root` CSS scope). */
+declare const DEFAULT_CONTEXT_NAME = "default";
+/**
+ * Extract the distinct context names declared anywhere in a DTCG token tree.
+ *
+ * Walks to each logical token (a node with a `$root` context wrapper) and collects the
+ * context keys it declares (`$root`, `dark`, `light`, …). `$root` is mapped to
+ * `"default"` and placed first; the rest follow in first-seen order, deduped.
+ */
+declare function getContexts(tokens: DtcgNode, rootName?: string): string[];
+/** Render the generated `contexts.ts` module emitted alongside `variables.css`. */
+declare function formatContextsModule(contexts: string[]): string;
+
+/** A web font to load: a family name and the weights it is used at. */
+interface FontDef {
+    family: string;
+    weights: number[];
+}
+/**
+ * Extract the web fonts referenced by a DTCG token tree.
+ *
+ * Collects every distinct `fontFamily` value (references resolved), then derives each
+ * family's weights from the semantic typography composites — a group whose `font-family`
+ * resolves to that family contributes its sibling `font-weight`. Families used without an
+ * accompanying weight default to `[400]`. Result is sorted by family for determinism.
+ */
+declare function getFonts(tokens: DtcgNode): FontDef[];
+/** Render the generated `fonts.ts` module emitted alongside `variables.css`. */
+declare function formatFontsModule(fonts: FontDef[]): string;
+
+/**
+ * Convert a DTCG token object into a scoped `variables.css` string.
+ *
+ * Resolves each configured context (with `$root` fallback and reference
+ * resolution) and emits one CSS scope per context — the base context in full,
+ * others as override-only blocks. Pure: no filesystem access.
+ *
+ * @example
+ * const css = tokensToCss(tokens)
+ *
+ * @example
+ * const css = tokensToCss(tokens, { colorFormat: "hex", contexts: { $root: ":root" } })
+ */
+declare function tokensToCss(tokens: DtcgNode, options?: CssOptions): string;
+
+export { type CssOptions as C, DEFAULT_CONFIG_FILE as D, FALLBACK_OUTPUT_DIR as F, type ResolvedCssOptions as R, type TokenValue as T, type ColorValue as a, DEFAULT_CONTEXTS as b, DEFAULT_CONTEXT_NAME as c, DEFAULT_NAME_EXTENSION as d, DEFAULT_OUTPUT_DIR as e, type DimensionValue as f, type DtcgNode as g, type FlatToken as h, type FontDef as i, emitCss as j, formatContextsModule as k, formatFontsModule as l, getContexts as m, getFonts as n, resolveCssOptions as r, tokensToCss as t };

package/dist/index-GGPx58oG.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Options for the pure CSS transform ({@link tokensToCss}/{@link emitCss}),
+ * decoupled from any filesystem concern so they work in any environment.
+ * All optional; defaults make the zero-config case work.
+ */
+interface CssOptions {
+    /**
+     * Map of context name → CSS selector. The first entry is the base context (full
+     * output); every other context emits only the variables that differ from the base.
+     * Default: `{ "$root": ":root", "dark": ".dark", "light": ".light" }`.
+     */
+    contexts?: Record<string, string>;
+    /** Color serialization. Default: `"oklch"`. */
+    colorFormat?: "oklch" | "hex";
+    /** Dimension handling: keep the authored unit, or convert `px` → `rem`. Default: `"preserve"`. */
+    dimensionUnit?: "preserve" | "rem";
+    /** `$extensions` key holding the `exportName` array. Default: `"com.bezel.app"`. */
+    nameExtension?: string;
+}
+/** Fully-resolved CSS-transform options (no `undefined`). */
+interface ResolvedCssOptions {
+    contexts: Record<string, string>;
+    colorFormat: "oklch" | "hex";
+    dimensionUnit: "preserve" | "rem";
+    nameExtension: string;
+}
+/** Apply defaults to {@link CssOptions}. Pure — no path resolution, no `node:*`. */
+declare function resolveCssOptions(options?: CssOptions): ResolvedCssOptions;
+
+/**
+ * Minimal type surface for the W3C Design Tokens (DTCG) 2025.10 format, plus
+ * the internal shapes the generator passes between stages.
+ *
+ * @see https://www.designtokens.org/tr/2025.10/format/
+ */
+/** A DTCG color value (e.g. `{ colorSpace: "oklch", components: [...], hex, alpha }`). */
+interface ColorValue {
+    colorSpace: string;
+    components: number[];
+    hex?: string;
+    alpha?: number;
+}
+/** A DTCG dimension value (e.g. `{ value: 12, unit: "px" }`). */
+interface DimensionValue {
+    value: number;
+    unit: string;
+}
+/** Any DTCG token value: a literal, a reference string `"{a.b.c}"`, or a typed object. */
+type TokenValue = string | number | ColorValue | DimensionValue | (string | number)[] | Record<string, unknown>;
+/**
+ * An arbitrary DTCG node — either a group (nested nodes) or a token (`$value`).
+ * Indexed loosely because we walk it structurally rather than by a fixed schema.
+ */
+interface DtcgNode {
+    $value?: TokenValue;
+    $type?: string;
+    $description?: string;
+    $extensions?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** A single logical token after the tree has been collapsed + flattened for one context. */
+interface FlatToken {
+    /** Dot-path of the token in the source tree (contexts already stripped). */
+    path: string;
+    /** The token's value for the active context (may still be a `"{ref}"`). */
+    value: TokenValue;
+    /** Resolved/inherited `$type`, if known. */
+    type?: string;
+    /** Vendor extensions carried through from the source token. */
+    extensions?: Record<string, unknown>;
+}
+
+/**
+ * Pure default constants shared by the isomorphic core and the Node layer.
+ * Kept free of `node:*` imports so the browser/edge entry can use them.
+ */
+/** Default context → selector mapping. The first key is the base context. */
+declare const DEFAULT_CONTEXTS: Record<string, string>;
+/**
+ * Directory generated outputs are written to, relative to the project root.
+ *
+ * Everything Bezel emits is generated and gitignored, and `bezel build` overwrites
+ * without asking — so outputs live in their own directory rather than alongside
+ * hand-written files, where a generic name like `variables.css` or `fonts.ts` could
+ * silently clobber something the user wrote. {@link FALLBACK_OUTPUT_DIR} is used by
+ * `bezel init` for projects with no `src/`.
+ */
+declare const DEFAULT_OUTPUT_DIR = "src/bezel";
+/** Output directory `bezel init` picks when the project has no `src/`. */
+declare const FALLBACK_OUTPUT_DIR = "bezel";
+declare const DEFAULT_NAME_EXTENSION = "com.bezel.app";
+/** The config file `bezel init` writes and `bezel build` auto-loads from the project root. */
+declare const DEFAULT_CONFIG_FILE = "bezel.json";
+
+/**
+ * Convert a DTCG token tree into a scoped CSS string. The first context in
+ * `options.contexts` is the base (emitted in full); every other context emits
+ * only the variables whose value differs from the base.
+ */
+declare function emitCss(tokens: DtcgNode, options: ResolvedCssOptions): string;
+
+/** Name the `$root` context maps to in generated output (matches the `:root` CSS scope). */
+declare const DEFAULT_CONTEXT_NAME = "default";
+/**
+ * Extract the distinct context names declared anywhere in a DTCG token tree.
+ *
+ * Walks to each logical token (a node with a `$root` context wrapper) and collects the
+ * context keys it declares (`$root`, `dark`, `light`, …). `$root` is mapped to
+ * `"default"` and placed first; the rest follow in first-seen order, deduped.
+ */
+declare function getContexts(tokens: DtcgNode, rootName?: string): string[];
+/** Render the generated `contexts.ts` module emitted alongside `variables.css`. */
+declare function formatContextsModule(contexts: string[]): string;
+
+/** A web font to load: a family name and the weights it is used at. */
+interface FontDef {
+    family: string;
+    weights: number[];
+}
+/**
+ * Extract the web fonts referenced by a DTCG token tree.
+ *
+ * Collects every distinct `fontFamily` value (references resolved), then derives each
+ * family's weights from the semantic typography composites — a group whose `font-family`
+ * resolves to that family contributes its sibling `font-weight`. Families used without an
+ * accompanying weight default to `[400]`. Result is sorted by family for determinism.
+ */
+declare function getFonts(tokens: DtcgNode): FontDef[];
+/** Render the generated `fonts.ts` module emitted alongside `variables.css`. */
+declare function formatFontsModule(fonts: FontDef[]): string;
+
+/**
+ * Convert a DTCG token object into a scoped `variables.css` string.
+ *
+ * Resolves each configured context (with `$root` fallback and reference
+ * resolution) and emits one CSS scope per context — the base context in full,
+ * others as override-only blocks. Pure: no filesystem access.
+ *
+ * @example
+ * const css = tokensToCss(tokens)
+ *
+ * @example
+ * const css = tokensToCss(tokens, { colorFormat: "hex", contexts: { $root: ":root" } })
+ */
+declare function tokensToCss(tokens: DtcgNode, options?: CssOptions): string;
+
+export { type CssOptions as C, DEFAULT_CONFIG_FILE as D, FALLBACK_OUTPUT_DIR as F, type ResolvedCssOptions as R, type TokenValue as T, type ColorValue as a, DEFAULT_CONTEXTS as b, DEFAULT_CONTEXT_NAME as c, DEFAULT_NAME_EXTENSION as d, DEFAULT_OUTPUT_DIR as e, type DimensionValue as f, type DtcgNode as g, type FlatToken as h, type FontDef as i, emitCss as j, formatContextsModule as k, formatFontsModule as l, getContexts as m, getFonts as n, resolveCssOptions as r, tokensToCss as t };

package/dist/index.cjs

@@ -244,7 +244,10 @@ var DEFAULT_CONTEXTS = {
   dark: ".dark",
   light: ".light"
 };
-var DEFAULT_NAME_EXTENSION = "com.tokendesigner.app";
+var DEFAULT_OUTPUT_DIR = "src/bezel";
+var VARIABLES_FILE = "variables.css";
+var DEFAULT_VARIABLES_OUTPUT = `${DEFAULT_OUTPUT_DIR}/${VARIABLES_FILE}`;
+var DEFAULT_NAME_EXTENSION = "com.bezel.app";
 
 // src/options.ts
 function resolveCssOptions(options = {}) {