@bezel-labs/bezel-kit 0.1.0

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import {
+  generateVariablesCss
+} from "./chunk-WLGTZBXW.js";
+import "./chunk-5EW7EW3R.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";
+var USAGE = `bezel \u2014 convert a W3C Design Tokens (DTCG) file into a scoped variables.css
+
+Usage:
+  bezel build [options]
+
+Reads design-tokens.json from the project root (the working directory).
+
+Options:
+  -c, --config <path>           Config file (.json or .js exporting BezelOptions)
+      --variables-output <path> Output CSS file (default: variables.css)
+      --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.
+`;
+var DEFAULT_CONFIG_FILE = "bezel.json";
+async function loadConfig(path) {
+  const abs = resolve(process.cwd(), path);
+  if (/\.json$/.test(abs)) {
+    return JSON.parse(await readFile(abs, "utf8"));
+  }
+  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" }
+    }
+  });
+  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}`);
+    process.exitCode = 1;
+    return;
+  }
+  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 };
+  if (values["variables-output"]) options.variablesOutput = values["variables-output"];
+  if (values["contexts-output"]) options.contextsOutput = values["contexts-output"];
+  if (values["fonts-output"]) options.fontsOutput = values["fonts-output"];
+  if (values.color) options.colorFormat = values.color;
+  if (values.unit) options.dimensionUnit = values.unit;
+  if (values.stdout) options.write = false;
+  if (values["no-gitignore"]) options.gitignore = false;
+  const css = await generateVariablesCss(options);
+  if (values.stdout) {
+    process.stdout.write(css);
+  } else {
+    process.stderr.write(`bezel: wrote ${options.variablesOutput ?? "variables.css"}
+`);
+  }
+}
+main(process.argv.slice(2)).catch((err) => {
+  process.stderr.write(`${err instanceof Error ? err.message : String(err)}
+`);
+  process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +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":[]}

package/dist/index.cjs

@@ -0,0 +1,401 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_CONTEXTS: () => DEFAULT_CONTEXTS,
+  DEFAULT_CONTEXT_NAME: () => DEFAULT_CONTEXT_NAME,
+  DEFAULT_NAME_EXTENSION: () => DEFAULT_NAME_EXTENSION,
+  emitCss: () => emitCss,
+  formatContextsModule: () => formatContextsModule,
+  formatFontsModule: () => formatFontsModule,
+  getContexts: () => getContexts,
+  getFonts: () => getFonts,
+  resolveCssOptions: () => resolveCssOptions,
+  tokensToCss: () => tokensToCss
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/collapse.ts
+var ROOT_CONTEXT = "$root";
+function isObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isContextWrapper(v) {
+  return isObject(v) && "$value" in v;
+}
+function isMetaKey(key) {
+  return key === "$type" || key === "$description" || key === "$extensions" || key === "$value";
+}
+function flattenForContext(tokens, context) {
+  const out = /* @__PURE__ */ new Map();
+  const walk = (node, path, inheritedType) => {
+    const type = typeof node.$type === "string" ? node.$type : inheritedType;
+    if ("$value" in node) {
+      out.set(path, {
+        path,
+        value: node.$value,
+        type,
+        extensions: node.$extensions
+      });
+      return;
+    }
+    const wrapperKeys = Object.keys(node).filter((k) => !isMetaKey(k) && isContextWrapper(node[k]));
+    if (wrapperKeys.length > 0) {
+      const chosen = node[context] ?? node[ROOT_CONTEXT] ?? node[wrapperKeys[0]];
+      out.set(path, {
+        path,
+        value: chosen.$value,
+        type,
+        extensions: node.$extensions
+      });
+      return;
+    }
+    for (const key of Object.keys(node)) {
+      if (isMetaKey(key)) continue;
+      const child = node[key];
+      if (isObject(child)) {
+        walk(child, path ? `${path}.${key}` : key, type);
+      }
+    }
+  };
+  walk(tokens, "", void 0);
+  return out;
+}
+
+// src/name.ts
+var DROPPED_PREFIXES = /* @__PURE__ */ new Set(["base", "semantic"]);
+var DROPPED_SUFFIXES = /* @__PURE__ */ new Set(["default", "$root"]);
+function exportNames(token, nameExtension) {
+  const ext = token.extensions?.[nameExtension];
+  if (ext && typeof ext === "object" && "exportName" in ext) {
+    const names = ext.exportName;
+    if (Array.isArray(names)) return names.filter((n) => typeof n === "string");
+  }
+  return void 0;
+}
+function usesExportNames(tokens, nameExtension) {
+  for (const token of tokens) {
+    if (exportNames(token, nameExtension) !== void 0) return true;
+  }
+  return false;
+}
+function nameFromPath(path) {
+  const segments = path.split(".");
+  while (segments.length > 1 && DROPPED_PREFIXES.has(segments[0])) segments.shift();
+  while (segments.length > 1 && DROPPED_SUFFIXES.has(segments[segments.length - 1])) {
+    segments.pop();
+  }
+  return segments.join("-");
+}
+function cssNames(token, nameExtension, useExportName) {
+  if (useExportName) {
+    const names = exportNames(token, nameExtension);
+    if (!names) return [];
+    return names.filter((n) => n.length > 0);
+  }
+  return [nameFromPath(token.path)];
+}
+
+// src/resolve.ts
+var REFERENCE_RE = /^\{([^{}]+)\}$/;
+function aliasTarget(value) {
+  if (typeof value !== "string") return null;
+  const match = REFERENCE_RE.exec(value.trim());
+  return match ? match[1].trim() : null;
+}
+function resolveReferences(tokens) {
+  const resolved = /* @__PURE__ */ new Map();
+  const resolveValue = (value, seen) => {
+    const target = aliasTarget(value);
+    if (target === null) return value;
+    if (resolved.has(target)) return resolved.get(target);
+    if (seen.has(target)) {
+      throw new Error(`bezel: circular token reference detected at "{${target}}".`);
+    }
+    const token = tokens.get(target);
+    if (!token) {
+      throw new Error(`bezel: unresolved token reference "{${target}}".`);
+    }
+    seen.add(target);
+    const value2 = resolveValue(token.value, seen);
+    seen.delete(target);
+    resolved.set(target, value2);
+    return value2;
+  };
+  for (const token of tokens.values()) {
+    token.value = resolveValue(token.value, /* @__PURE__ */ new Set());
+  }
+  return tokens;
+}
+
+// src/serialize.ts
+function isObject2(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isColor(v) {
+  return isObject2(v) && "colorSpace" in v && Array.isArray(v["components"]);
+}
+function isDimension(v) {
+  return isObject2(v) && typeof v["value"] === "number" && "unit" in v;
+}
+function round(n, dp) {
+  const f = 10 ** dp;
+  return Math.round(n * f) / f;
+}
+function serializeColor(color, format) {
+  if (format === "hex" && color.hex) return color.hex.toLowerCase();
+  if (color.colorSpace === "oklch") {
+    const [l = 0, c = 0, h = 0] = color.components;
+    const base = `oklch(${round(l, 4)} ${round(c, 4)} ${round(h, 3)})`;
+    if (color.alpha !== void 0 && color.alpha < 1) {
+      return `oklch(${round(l, 4)} ${round(c, 4)} ${round(h, 3)} / ${round(color.alpha, 4)})`;
+    }
+    return base;
+  }
+  if (color.hex) return color.hex.toLowerCase();
+  return `color(${color.colorSpace} ${color.components.map((n) => round(n, 4)).join(" ")})`;
+}
+function serializeDimension(dim, unit) {
+  if (unit === "rem" && dim.unit === "px") {
+    return `${round(dim.value / 16, 4)}rem`;
+  }
+  return `${dim.value}${dim.unit}`;
+}
+function quoteFamily(name) {
+  const trimmed = name.trim();
+  if (/^['"].*['"]$/.test(trimmed)) return trimmed;
+  return /\s/.test(trimmed) ? `"${trimmed}"` : trimmed;
+}
+function serializeValue(value, options) {
+  if (isColor(value)) return serializeColor(value, options.colorFormat);
+  if (isDimension(value)) return serializeDimension(value, options.dimensionUnit);
+  if (Array.isArray(value)) {
+    return value.map((v) => quoteFamily(String(v))).join(", ");
+  }
+  if (typeof value === "number") return String(value);
+  const str = String(value);
+  if (/\s/.test(str) && !str.includes(",") && !/[()]/.test(str)) {
+    return quoteFamily(str);
+  }
+  return str;
+}
+
+// src/emit.ts
+function buildContextVars(tokens, context, useExportName, options) {
+  const flat = resolveReferences(flattenForContext(tokens, context));
+  const vars = /* @__PURE__ */ new Map();
+  for (const token of flat.values()) {
+    const names = cssNames(token, options.nameExtension, useExportName);
+    if (names.length === 0) continue;
+    const value = serializeValue(token.value, options);
+    for (const name of names) vars.set(name, value);
+  }
+  return vars;
+}
+function renderBlock(selector, vars) {
+  const lines = [...vars].map(([name, value]) => `  --${name}: ${value};`);
+  if (lines.length === 0) return "";
+  return `${selector} {
+${lines.join("\n")}
+}`;
+}
+function emitCss(tokens, options) {
+  const contextNames = Object.keys(options.contexts);
+  const useExportName = usesExportNames(
+    flattenForContext(tokens, contextNames[0]).values(),
+    options.nameExtension
+  );
+  const [baseContext, ...overrideContexts] = contextNames;
+  const baseVars = buildContextVars(tokens, baseContext, useExportName, options);
+  const blocks = [renderBlock(options.contexts[baseContext], baseVars)];
+  for (const context of overrideContexts) {
+    const vars = buildContextVars(tokens, context, useExportName, options);
+    const overrides = [...vars].filter(([name, value]) => baseVars.get(name) !== value);
+    const block = renderBlock(options.contexts[context], overrides);
+    if (block) blocks.push(block);
+  }
+  const header = "/* Generated by bezel \u2014 do not edit by hand. */\n/* Run `npm run tokens` (or `bezel build`) to regenerate. */\n";
+  return `${header}
+${blocks.filter(Boolean).join("\n\n")}
+`;
+}
+
+// src/defaults.ts
+var DEFAULT_CONTEXTS = {
+  $root: ":root",
+  dark: ".dark",
+  light: ".light"
+};
+var DEFAULT_NAME_EXTENSION = "com.tokendesigner.app";
+
+// src/options.ts
+function resolveCssOptions(options = {}) {
+  const contexts = options.contexts ?? DEFAULT_CONTEXTS;
+  if (Object.keys(contexts).length === 0) {
+    throw new Error("bezel: `contexts` must define at least one context.");
+  }
+  return {
+    contexts,
+    colorFormat: options.colorFormat ?? "oklch",
+    dimensionUnit: options.dimensionUnit ?? "preserve",
+    nameExtension: options.nameExtension ?? DEFAULT_NAME_EXTENSION
+  };
+}
+
+// src/contexts.ts
+var DEFAULT_CONTEXT_NAME = "default";
+function isObject3(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isContextWrapper2(v) {
+  return isObject3(v) && "$value" in v;
+}
+function getContexts(tokens, rootName = DEFAULT_CONTEXT_NAME) {
+  const order = [];
+  const seen = /* @__PURE__ */ new Set();
+  const walk = (node) => {
+    if (ROOT_CONTEXT in node && isContextWrapper2(node[ROOT_CONTEXT])) {
+      for (const key of Object.keys(node)) {
+        if (key.startsWith("$") && key !== ROOT_CONTEXT) continue;
+        if (isContextWrapper2(node[key]) && !seen.has(key)) {
+          seen.add(key);
+          order.push(key);
+        }
+      }
+      return;
+    }
+    for (const key of Object.keys(node)) {
+      if (key.startsWith("$")) continue;
+      const child = node[key];
+      if (isObject3(child)) walk(child);
+    }
+  };
+  walk(tokens);
+  const mapped = order.map((k) => k === ROOT_CONTEXT ? rootName : k);
+  return [.../* @__PURE__ */ new Set([rootName, ...mapped])];
+}
+function formatContextsModule(contexts) {
+  const list = contexts.map((c) => JSON.stringify(c)).join(", ");
+  return `/* Generated by bezel \u2014 do not edit by hand. */
+/* Run \`npm run tokens\` (or \`bezel build\`) to regenerate. */
+
+export const CONTEXTS = [${list}] as const
+
+export type Context = (typeof CONTEXTS)[number]
+`;
+}
+
+// src/fonts.ts
+var GENERIC_FAMILIES = /* @__PURE__ */ new Set([
+  "serif",
+  "sans-serif",
+  "monospace",
+  "cursive",
+  "fantasy",
+  "system-ui",
+  "ui-serif",
+  "ui-sans-serif",
+  "ui-monospace",
+  "ui-rounded",
+  "math",
+  "emoji",
+  "fangsong",
+  "inherit",
+  "initial",
+  "unset"
+]);
+var DEFAULT_WEIGHT = 400;
+function primaryFamily(value) {
+  const candidates = Array.isArray(value) ? value : [value];
+  for (const candidate of candidates) {
+    if (typeof candidate !== "string") continue;
+    const name = candidate.trim().replace(/^['"]|['"]$/g, "");
+    if (name && !GENERIC_FAMILIES.has(name.toLowerCase())) return name;
+  }
+  return null;
+}
+function parentPath(path) {
+  const i = path.lastIndexOf(".");
+  return i === -1 ? "" : path.slice(0, i);
+}
+function getFonts(tokens) {
+  const flat = resolveReferences(flattenForContext(tokens, ROOT_CONTEXT));
+  const families = /* @__PURE__ */ new Set();
+  const familyByParent = /* @__PURE__ */ new Map();
+  const weightByParent = /* @__PURE__ */ new Map();
+  for (const token of flat.values()) {
+    if (token.type === "fontFamily") {
+      const family = primaryFamily(token.value);
+      if (family) {
+        families.add(family);
+        familyByParent.set(parentPath(token.path), family);
+      }
+    } else if (token.type === "fontWeight" && typeof token.value === "number") {
+      weightByParent.set(parentPath(token.path), token.value);
+    }
+  }
+  const weightsByFamily = /* @__PURE__ */ new Map();
+  for (const [parent, family] of familyByParent) {
+    const weight = weightByParent.get(parent);
+    if (weight === void 0) continue;
+    const set = weightsByFamily.get(family) ?? /* @__PURE__ */ new Set();
+    set.add(weight);
+    weightsByFamily.set(family, set);
+  }
+  return [...families].sort().map((family) => {
+    const weights = weightsByFamily.get(family);
+    return {
+      family,
+      weights: weights ? [...weights].sort((a, b) => a - b) : [DEFAULT_WEIGHT]
+    };
+  });
+}
+function formatFontsModule(fonts) {
+  const entries = fonts.map((f) => `  { family: ${JSON.stringify(f.family)}, weights: [${f.weights.join(", ")}] },`).join("\n");
+  return `/* Generated by bezel \u2014 do not edit by hand. */
+/* Run \`npm run tokens\` (or \`bezel build\`) to regenerate. */
+
+export const FONTS = [
+${entries}
+] as const
+
+export type FontDef = { family: string; weights: number[] }
+`;
+}
+
+// src/index.ts
+function tokensToCss(tokens, options = {}) {
+  return emitCss(tokens, resolveCssOptions(options));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_CONTEXTS,
+  DEFAULT_CONTEXT_NAME,
+  DEFAULT_NAME_EXTENSION,
+  emitCss,
+  formatContextsModule,
+  formatFontsModule,
+  getContexts,
+  getFonts,
+  resolveCssOptions,
+  tokensToCss
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/collapse.ts","../src/name.ts","../src/resolve.ts","../src/serialize.ts","../src/emit.ts","../src/defaults.ts","../src/options.ts","../src/contexts.ts","../src/fonts.ts"],"sourcesContent":["/**\n * bezel — isomorphic entry.\n *\n * The pure transform core: convert an in-memory W3C Design Tokens (DTCG) object\n * into a scoped `variables.css` string. Imports no `node:*`, so it runs anywhere\n * — browser, edge, Node. For the filesystem/CLI conveniences (reading a tokens\n * file, writing outputs), import from `bezel/node`.\n */\nimport { emitCss } from \"./emit\"\nimport { resolveCssOptions, type CssOptions } from \"./options\"\nimport type { DtcgNode } from \"./types\"\n\nexport type { CssOptions, ResolvedCssOptions } from \"./options\"\nexport type { DtcgNode, FlatToken, TokenValue, ColorValue, DimensionValue } from \"./types\"\nexport { DEFAULT_CONTEXTS, DEFAULT_NAME_EXTENSION } from \"./defaults\"\nexport { emitCss } from \"./emit\"\nexport { resolveCssOptions } from \"./options\"\nexport { getContexts, formatContextsModule, DEFAULT_CONTEXT_NAME } from \"./contexts\"\nexport { getFonts, formatFontsModule } from \"./fonts\"\nexport type { FontDef } from \"./fonts\"\n\n/**\n * Convert a DTCG token object into a scoped `variables.css` string.\n *\n * Resolves each configured context (with `$root` fallback and reference\n * resolution) and emits one CSS scope per context — the base context in full,\n * others as override-only blocks. Pure: no filesystem access.\n *\n * @example\n * const css = tokensToCss(tokens)\n *\n * @example\n * const css = tokensToCss(tokens, { colorFormat: \"hex\", contexts: { $root: \":root\" } })\n */\nexport function tokensToCss(tokens: DtcgNode, options: CssOptions = {}): string {\n  return emitCss(tokens, resolveCssOptions(options))\n}\n","import type { DtcgNode, FlatToken, TokenValue } from \"./types\"\n\n/** The W3C \"root token\" key — the base value of a group / logical token. */\nexport const ROOT_CONTEXT = \"$root\"\n\nfunction isObject(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null && !Array.isArray(v)\n}\n\n/** A \"context wrapper\" is a child object that directly holds a `$value` (e.g. `dark`, `light`, `$root`). */\nfunction isContextWrapper(v: unknown): v is DtcgNode {\n  return isObject(v) && \"$value\" in v\n}\n\n/** Keys that are DTCG metadata, never traversed as child tokens/contexts. */\nfunction isMetaKey(key: string): boolean {\n  return key === \"$type\" || key === \"$description\" || key === \"$extensions\" || key === \"$value\"\n}\n\n/**\n * Collapse a DTCG token tree to the single value that applies for `context`, and\n * flatten it to a map of dot-path → {@link FlatToken}.\n *\n * Handles three node shapes:\n *  - **Simple token** — a node with a direct `$value` (context-invariant).\n *  - **Logical token** — a node whose children include context wrappers (one of\n *    which is `$root`). The value for `context` is picked, falling back to `$root`.\n *  - **Group** — anything else; recursed into.\n *\n * `$type` is inherited from the nearest ancestor that declares one.\n */\nexport function flattenForContext(tokens: DtcgNode, context: string): Map<string, FlatToken> {\n  const out = new Map<string, FlatToken>()\n\n  const walk = (node: DtcgNode, path: string, inheritedType: string | undefined): void => {\n    const type = typeof node.$type === \"string\" ? node.$type : inheritedType\n\n    // Simple token: direct $value.\n    if (\"$value\" in node) {\n      out.set(path, {\n        path,\n        value: node.$value as TokenValue,\n        type,\n        extensions: node.$extensions,\n      })\n      return\n    }\n\n    // Logical token: has context-wrapper children (dark/light/$root).\n    const wrapperKeys = Object.keys(node).filter((k) => !isMetaKey(k) && isContextWrapper(node[k]))\n    if (wrapperKeys.length > 0) {\n      const chosen =\n        (node[context] as DtcgNode | undefined) ??\n        (node[ROOT_CONTEXT] as DtcgNode | undefined) ??\n        (node[wrapperKeys[0]!] as DtcgNode)\n      out.set(path, {\n        path,\n        value: chosen.$value as TokenValue,\n        type,\n        extensions: node.$extensions,\n      })\n      return\n    }\n\n    // Group: recurse into non-meta children.\n    for (const key of Object.keys(node)) {\n      if (isMetaKey(key)) continue\n      const child = node[key]\n      if (isObject(child)) {\n        walk(child as DtcgNode, path ? `${path}.${key}` : key, type)\n      }\n    }\n  }\n\n  walk(tokens, \"\", undefined)\n  return out\n}\n","import type { FlatToken } from \"./types\"\n\n/** Leading path segments dropped when deriving a CSS name from a token path. */\nconst DROPPED_PREFIXES = new Set([\"base\", \"semantic\"])\n/** Trailing path segments dropped (a group's \"default\"/root token maps to the bare group name). */\nconst DROPPED_SUFFIXES = new Set([\"default\", \"$root\"])\n\nfunction exportNames(token: FlatToken, nameExtension: string): string[] | undefined {\n  const ext = token.extensions?.[nameExtension]\n  if (ext && typeof ext === \"object\" && \"exportName\" in ext) {\n    const names = (ext as { exportName: unknown }).exportName\n    if (Array.isArray(names)) return names.filter((n): n is string => typeof n === \"string\")\n  }\n  return undefined\n}\n\n/** True if any token in the map declares an `exportName` under `nameExtension`. */\nexport function usesExportNames(\n  tokens: Iterable<FlatToken>,\n  nameExtension: string,\n): boolean {\n  for (const token of tokens) {\n    if (exportNames(token, nameExtension) !== undefined) return true\n  }\n  return false\n}\n\n/** Derive a CSS variable name from a dot-path (fallback when no `exportName` exists). */\nexport function nameFromPath(path: string): string {\n  const segments = path.split(\".\")\n  while (segments.length > 1 && DROPPED_PREFIXES.has(segments[0]!)) segments.shift()\n  while (segments.length > 1 && DROPPED_SUFFIXES.has(segments[segments.length - 1]!)) {\n    segments.pop()\n  }\n  return segments.join(\"-\")\n}\n\n/**\n * Resolve the CSS variable name(s) a token emits (without the leading `--`).\n *\n * - In **exportName mode** (`useExportName`), names come solely from the token's\n *   `exportName` array. A token without one — or with only empty strings — emits\n *   nothing (it exists purely as a reference target). One token may emit many names.\n * - Otherwise (generic DTCG), the name is derived from the token's path.\n */\nexport function cssNames(\n  token: FlatToken,\n  nameExtension: string,\n  useExportName: boolean,\n): string[] {\n  if (useExportName) {\n    const names = exportNames(token, nameExtension)\n    if (!names) return []\n    return names.filter((n) => n.length > 0)\n  }\n  return [nameFromPath(token.path)]\n}\n","import type { FlatToken, TokenValue } from \"./types\"\n\nconst REFERENCE_RE = /^\\{([^{}]+)\\}$/\n\n/** Returns the referenced path if `value` is a whole-value DTCG alias `\"{a.b.c}\"`, else `null`. */\nexport function aliasTarget(value: TokenValue): string | null {\n  if (typeof value !== \"string\") return null\n  const match = REFERENCE_RE.exec(value.trim())\n  return match ? match[1]!.trim() : null\n}\n\n/**\n * Resolve whole-value references (`\"{a.b.c}\"`) in a flattened, single-context token\n * map, in place. Because the map was collapsed for one context, following an alias\n * yields that context's value (with `$root` fallback already applied during collapse).\n *\n * Multi-hop aliases are followed, results memoized, and cycles guarded against.\n */\nexport function resolveReferences(tokens: Map<string, FlatToken>): Map<string, FlatToken> {\n  const resolved = new Map<string, TokenValue>()\n\n  const resolveValue = (value: TokenValue, seen: Set<string>): TokenValue => {\n    const target = aliasTarget(value)\n    if (target === null) return value\n\n    if (resolved.has(target)) return resolved.get(target)!\n    if (seen.has(target)) {\n      throw new Error(`bezel: circular token reference detected at \"{${target}}\".`)\n    }\n\n    const token = tokens.get(target)\n    if (!token) {\n      throw new Error(`bezel: unresolved token reference \"{${target}}\".`)\n    }\n\n    seen.add(target)\n    const value2 = resolveValue(token.value, seen)\n    seen.delete(target)\n    resolved.set(target, value2)\n    return value2\n  }\n\n  for (const token of tokens.values()) {\n    token.value = resolveValue(token.value, new Set())\n  }\n  return tokens\n}\n","import type { ResolvedCssOptions } from \"./options\"\nimport type {\n  ColorValue,\n  DimensionValue,\n  TokenValue,\n} from \"./types\"\n\nfunction isObject(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null && !Array.isArray(v)\n}\n\nfunction isColor(v: unknown): v is ColorValue {\n  return isObject(v) && \"colorSpace\" in v && Array.isArray(v[\"components\"])\n}\n\nfunction isDimension(v: unknown): v is DimensionValue {\n  return isObject(v) && typeof v[\"value\"] === \"number\" && \"unit\" in v\n}\n\n/** Round to at most `dp` decimals without trailing zeros. */\nfunction round(n: number, dp: number): number {\n  const f = 10 ** dp\n  return Math.round(n * f) / f\n}\n\nfunction serializeColor(color: ColorValue, format: ResolvedCssOptions[\"colorFormat\"]): string {\n  if (format === \"hex\" && color.hex) return color.hex.toLowerCase()\n\n  if (color.colorSpace === \"oklch\") {\n    const [l = 0, c = 0, h = 0] = color.components\n    const base = `oklch(${round(l, 4)} ${round(c, 4)} ${round(h, 3)})`\n    if (color.alpha !== undefined && color.alpha < 1) {\n      return `oklch(${round(l, 4)} ${round(c, 4)} ${round(h, 3)} / ${round(color.alpha, 4)})`\n    }\n    return base\n  }\n\n  // Unknown color space: prefer hex fallback, else CSS color() function.\n  if (color.hex) return color.hex.toLowerCase()\n  return `color(${color.colorSpace} ${color.components.map((n) => round(n, 4)).join(\" \")})`\n}\n\nfunction serializeDimension(dim: DimensionValue, unit: ResolvedCssOptions[\"dimensionUnit\"]): string {\n  if (unit === \"rem\" && dim.unit === \"px\") {\n    return `${round(dim.value / 16, 4)}rem`\n  }\n  return `${dim.value}${dim.unit}`\n}\n\n/** Quote a font-family name if it contains whitespace and isn't already quoted. */\nfunction quoteFamily(name: string): string {\n  const trimmed = name.trim()\n  if (/^['\"].*['\"]$/.test(trimmed)) return trimmed\n  return /\\s/.test(trimmed) ? `\"${trimmed}\"` : trimmed\n}\n\n/** Serialize a resolved token value to a CSS declaration value. */\nexport function serializeValue(value: TokenValue, options: ResolvedCssOptions): string {\n  if (isColor(value)) return serializeColor(value, options.colorFormat)\n  if (isDimension(value)) return serializeDimension(value, options.dimensionUnit)\n\n  // fontFamily as an array of names.\n  if (Array.isArray(value)) {\n    return value.map((v) => quoteFamily(String(v))).join(\", \")\n  }\n\n  if (typeof value === \"number\") return String(value)\n\n  // Strings: could be a single font-family name or an already-formatted value.\n  // Quote multi-word family names; leave comma-lists and plain values untouched.\n  const str = String(value)\n  if (/\\s/.test(str) && !str.includes(\",\") && !/[()]/.test(str)) {\n    return quoteFamily(str)\n  }\n  return str\n}\n","import { flattenForContext } from \"./collapse\"\nimport { cssNames, usesExportNames } from \"./name\"\nimport { resolveReferences } from \"./resolve\"\nimport { serializeValue } from \"./serialize\"\nimport type { ResolvedCssOptions } from \"./options\"\nimport type { DtcgNode } from \"./types\"\n\n/** An ordered map of CSS variable name → serialized value for one context. */\ntype VarMap = Map<string, string>\n\n/** Build the `name → cssValue` map for a single context. */\nfunction buildContextVars(\n  tokens: DtcgNode,\n  context: string,\n  useExportName: boolean,\n  options: ResolvedCssOptions,\n): VarMap {\n  const flat = resolveReferences(flattenForContext(tokens, context))\n  const vars: VarMap = new Map()\n  for (const token of flat.values()) {\n    const names = cssNames(token, options.nameExtension, useExportName)\n    if (names.length === 0) continue\n    const value = serializeValue(token.value, options)\n    for (const name of names) vars.set(name, value)\n  }\n  return vars\n}\n\nfunction renderBlock(selector: string, vars: Iterable<[string, string]>): string {\n  const lines = [...vars].map(([name, value]) => `  --${name}: ${value};`)\n  if (lines.length === 0) return \"\"\n  return `${selector} {\\n${lines.join(\"\\n\")}\\n}`\n}\n\n/**\n * Convert a DTCG token tree into a scoped CSS string. The first context in\n * `options.contexts` is the base (emitted in full); every other context emits\n * only the variables whose value differs from the base.\n */\nexport function emitCss(tokens: DtcgNode, options: ResolvedCssOptions): string {\n  const contextNames = Object.keys(options.contexts)\n  const useExportName = usesExportNames(\n    flattenForContext(tokens, contextNames[0]!).values(),\n    options.nameExtension,\n  )\n\n  const [baseContext, ...overrideContexts] = contextNames\n  const baseVars = buildContextVars(tokens, baseContext!, useExportName, options)\n\n  const blocks: string[] = [renderBlock(options.contexts[baseContext!]!, baseVars)]\n\n  for (const context of overrideContexts) {\n    const vars = buildContextVars(tokens, context, useExportName, options)\n    const overrides = [...vars].filter(([name, value]) => baseVars.get(name) !== value)\n    const block = renderBlock(options.contexts[context]!, overrides)\n    if (block) blocks.push(block)\n  }\n\n  const header =\n    \"/* Generated by bezel — do not edit by hand. */\\n\" +\n    \"/* Run `npm run tokens` (or `bezel build`) to regenerate. */\\n\"\n  return `${header}\\n${blocks.filter(Boolean).join(\"\\n\\n\")}\\n`\n}\n","/**\n * Pure default constants shared by the isomorphic core and the Node layer.\n * Kept free of `node:*` imports so the browser/edge entry can use them.\n */\n\n/** Default context → selector mapping. The first key is the base context. */\nexport const DEFAULT_CONTEXTS: Record<string, string> = {\n  $root: \":root\",\n  dark: \".dark\",\n  light: \".light\",\n}\n\n/**\n * The DTCG input file the CLI reads from the project root. This is a cross-system\n * contract: it MUST stay in sync with the platform's `TOKENS_FILE_NAME` constant\n * (gundam: libs/keypuncher/data/constants/src/lib/tokens-file.ts) so any repo/app\n * the platform connects to resolves its tokens at the same name + location.\n */\nexport const DEFAULT_INPUT = \"design-tokens.json\"\nexport const DEFAULT_VARIABLES_OUTPUT = \"variables.css\"\nexport const DEFAULT_NAME_EXTENSION = \"com.tokendesigner.app\"\n","import { DEFAULT_CONTEXTS, DEFAULT_NAME_EXTENSION } from \"./defaults\"\n\n/**\n * Options for the pure CSS transform ({@link tokensToCss}/{@link emitCss}),\n * decoupled from any filesystem concern so they work in any environment.\n * All optional; defaults make the zero-config case work.\n */\nexport interface CssOptions {\n  /**\n   * Map of context name → CSS selector. The first entry is the base context (full\n   * output); every other context emits only the variables that differ from the base.\n   * Default: `{ \"$root\": \":root\", \"dark\": \".dark\", \"light\": \".light\" }`.\n   */\n  contexts?: Record<string, string>\n  /** Color serialization. Default: `\"oklch\"`. */\n  colorFormat?: \"oklch\" | \"hex\"\n  /** Dimension handling: keep the authored unit, or convert `px` → `rem`. Default: `\"preserve\"`. */\n  dimensionUnit?: \"preserve\" | \"rem\"\n  /** `$extensions` key holding the `exportName` array. Default: `\"com.tokendesigner.app\"`. */\n  nameExtension?: string\n}\n\n/** Fully-resolved CSS-transform options (no `undefined`). */\nexport interface ResolvedCssOptions {\n  contexts: Record<string, string>\n  colorFormat: \"oklch\" | \"hex\"\n  dimensionUnit: \"preserve\" | \"rem\"\n  nameExtension: string\n}\n\n/** Apply defaults to {@link CssOptions}. Pure — no path resolution, no `node:*`. */\nexport function resolveCssOptions(options: CssOptions = {}): ResolvedCssOptions {\n  const contexts = options.contexts ?? DEFAULT_CONTEXTS\n  if (Object.keys(contexts).length === 0) {\n    throw new Error(\"bezel: `contexts` must define at least one context.\")\n  }\n\n  return {\n    contexts,\n    colorFormat: options.colorFormat ?? \"oklch\",\n    dimensionUnit: options.dimensionUnit ?? \"preserve\",\n    nameExtension: options.nameExtension ?? DEFAULT_NAME_EXTENSION,\n  }\n}\n","import { ROOT_CONTEXT } from \"./collapse\"\nimport type { DtcgNode } from \"./types\"\n\n/** Name the `$root` context maps to in generated output (matches the `:root` CSS scope). */\nexport const DEFAULT_CONTEXT_NAME = \"default\"\n\nfunction isObject(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null && !Array.isArray(v)\n}\n\nfunction isContextWrapper(v: unknown): boolean {\n  return isObject(v) && \"$value\" in v\n}\n\n/**\n * Extract the distinct context names declared anywhere in a DTCG token tree.\n *\n * Walks to each logical token (a node with a `$root` context wrapper) and collects the\n * context keys it declares (`$root`, `dark`, `light`, …). `$root` is mapped to\n * `\"default\"` and placed first; the rest follow in first-seen order, deduped.\n */\nexport function getContexts(tokens: DtcgNode, rootName: string = DEFAULT_CONTEXT_NAME): string[] {\n  const order: string[] = []\n  const seen = new Set<string>()\n\n  const walk = (node: DtcgNode): void => {\n    if (ROOT_CONTEXT in node && isContextWrapper(node[ROOT_CONTEXT])) {\n      for (const key of Object.keys(node)) {\n        if (key.startsWith(\"$\") && key !== ROOT_CONTEXT) continue\n        if (isContextWrapper(node[key]) && !seen.has(key)) {\n          seen.add(key)\n          order.push(key)\n        }\n      }\n      return\n    }\n    for (const key of Object.keys(node)) {\n      if (key.startsWith(\"$\")) continue\n      const child = node[key]\n      if (isObject(child)) walk(child as DtcgNode)\n    }\n  }\n\n  walk(tokens)\n\n  const mapped = order.map((k) => (k === ROOT_CONTEXT ? rootName : k))\n  return [...new Set([rootName, ...mapped])]\n}\n\n/** Render the generated `contexts.ts` module emitted alongside `variables.css`. */\nexport function formatContextsModule(contexts: string[]): string {\n  const list = contexts.map((c) => JSON.stringify(c)).join(\", \")\n  return (\n    \"/* Generated by bezel — do not edit by hand. */\\n\" +\n    \"/* Run `npm run tokens` (or `bezel build`) to regenerate. */\\n\\n\" +\n    `export const CONTEXTS = [${list}] as const\\n\\n` +\n    \"export type Context = (typeof CONTEXTS)[number]\\n\"\n  )\n}\n","import { flattenForContext, ROOT_CONTEXT } from \"./collapse\"\nimport { resolveReferences } from \"./resolve\"\nimport type { DtcgNode, TokenValue } from \"./types\"\n\n/** A web font to load: a family name and the weights it is used at. */\nexport interface FontDef {\n  family: string\n  weights: number[]\n}\n\n/** Generic CSS family keywords that are never loaded as web fonts. */\nconst GENERIC_FAMILIES = new Set([\n  \"serif\",\n  \"sans-serif\",\n  \"monospace\",\n  \"cursive\",\n  \"fantasy\",\n  \"system-ui\",\n  \"ui-serif\",\n  \"ui-sans-serif\",\n  \"ui-monospace\",\n  \"ui-rounded\",\n  \"math\",\n  \"emoji\",\n  \"fangsong\",\n  \"inherit\",\n  \"initial\",\n  \"unset\",\n])\n\nconst DEFAULT_WEIGHT = 400\n\n/** Resolve a fontFamily token value to a primary family name (first non-generic), or null. */\nfunction primaryFamily(value: TokenValue): string | null {\n  const candidates = Array.isArray(value) ? value : [value]\n  for (const candidate of candidates) {\n    if (typeof candidate !== \"string\") continue\n    const name = candidate.trim().replace(/^['\"]|['\"]$/g, \"\")\n    if (name && !GENERIC_FAMILIES.has(name.toLowerCase())) return name\n  }\n  return null\n}\n\nfunction parentPath(path: string): string {\n  const i = path.lastIndexOf(\".\")\n  return i === -1 ? \"\" : path.slice(0, i)\n}\n\n/**\n * Extract the web fonts referenced by a DTCG token tree.\n *\n * Collects every distinct `fontFamily` value (references resolved), then derives each\n * family's weights from the semantic typography composites — a group whose `font-family`\n * resolves to that family contributes its sibling `font-weight`. Families used without an\n * accompanying weight default to `[400]`. Result is sorted by family for determinism.\n */\nexport function getFonts(tokens: DtcgNode): FontDef[] {\n  const flat = resolveReferences(flattenForContext(tokens, ROOT_CONTEXT))\n\n  const families = new Set<string>()\n  const familyByParent = new Map<string, string>()\n  const weightByParent = new Map<string, number>()\n\n  for (const token of flat.values()) {\n    if (token.type === \"fontFamily\") {\n      const family = primaryFamily(token.value)\n      if (family) {\n        families.add(family)\n        familyByParent.set(parentPath(token.path), family)\n      }\n    } else if (token.type === \"fontWeight\" && typeof token.value === \"number\") {\n      weightByParent.set(parentPath(token.path), token.value)\n    }\n  }\n\n  const weightsByFamily = new Map<string, Set<number>>()\n  for (const [parent, family] of familyByParent) {\n    const weight = weightByParent.get(parent)\n    if (weight === undefined) continue\n    const set = weightsByFamily.get(family) ?? new Set<number>()\n    set.add(weight)\n    weightsByFamily.set(family, set)\n  }\n\n  return [...families].sort().map((family) => {\n    const weights = weightsByFamily.get(family)\n    return {\n      family,\n      weights: weights ? [...weights].sort((a, b) => a - b) : [DEFAULT_WEIGHT],\n    }\n  })\n}\n\n/** Render the generated `fonts.ts` module emitted alongside `variables.css`. */\nexport function formatFontsModule(fonts: FontDef[]): string {\n  const entries = fonts\n    .map((f) => `  { family: ${JSON.stringify(f.family)}, weights: [${f.weights.join(\", \")}] },`)\n    .join(\"\\n\")\n  return (\n    \"/* Generated by bezel — do not edit by hand. */\\n\" +\n    \"/* Run `npm run tokens` (or `bezel build`) to regenerate. */\\n\\n\" +\n    `export const FONTS = [\\n${entries}\\n] as const\\n\\n` +\n    \"export type FontDef = { family: string; weights: number[] }\\n\"\n  )\n}\n"],"mappings":"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","names":["isObject","isObject","isContextWrapper"]}