@bezel-labs/bezel-kit 0.1.0 → 0.3.0

package/dist/index.cjs.map

@@ -1 +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"]}
+{"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 * so any repo/app the platform connects to resolves its tokens at the same name\n * and location.\n */\nexport const DEFAULT_INPUT = \"design-tokens.json\";\n\n/**\n * Directory generated outputs are written to, relative to the project root.\n *\n * Everything Bezel emits is generated and gitignored, and `bezel build` overwrites\n * without asking — so outputs live in their own directory rather than alongside\n * hand-written files, where a generic name like `variables.css` or `fonts.ts` could\n * silently clobber something the user wrote. {@link FALLBACK_OUTPUT_DIR} is used by\n * `bezel init` for projects with no `src/`.\n */\nexport const DEFAULT_OUTPUT_DIR = \"src/bezel\";\n/** Output directory `bezel init` picks when the project has no `src/`. */\nexport const FALLBACK_OUTPUT_DIR = \"bezel\";\n\n/** Generated output filenames, joined onto the output directory. */\nexport const VARIABLES_FILE = \"variables.css\";\nexport const CONTEXTS_FILE = \"contexts.ts\";\nexport const FONTS_FILE = \"fonts.ts\";\n\nexport const DEFAULT_VARIABLES_OUTPUT = `${DEFAULT_OUTPUT_DIR}/${VARIABLES_FILE}`;\nexport const DEFAULT_NAME_EXTENSION = \"com.bezel.app\";\n\n/** The config file `bezel init` writes and `bezel build` auto-loads from the project root. */\nexport const DEFAULT_CONFIG_FILE = \"bezel.json\";\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.bezel.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"]}

package/dist/index.d.cts

@@ -1,133 +1 @@
-/**
- * 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.tokendesigner.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>;
-declare const DEFAULT_NAME_EXTENSION = "com.tokendesigner.app";
-
-/**
- * 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 ColorValue, type CssOptions, DEFAULT_CONTEXTS, DEFAULT_CONTEXT_NAME, DEFAULT_NAME_EXTENSION, type DimensionValue, type DtcgNode, type FlatToken, type FontDef, type ResolvedCssOptions, type TokenValue, emitCss, formatContextsModule, formatFontsModule, getContexts, getFonts, resolveCssOptions, tokensToCss };
+export { a as ColorValue, C as CssOptions, b as DEFAULT_CONTEXTS, c as DEFAULT_CONTEXT_NAME, d as DEFAULT_NAME_EXTENSION, f as DimensionValue, g as DtcgNode, h as FlatToken, i as FontDef, R as ResolvedCssOptions, T as TokenValue, j as emitCss, k as formatContextsModule, l as formatFontsModule, m as getContexts, n as getFonts, r as resolveCssOptions, t as tokensToCss } from './index-GGPx58oG.cjs';

package/dist/index.d.ts

@@ -1,133 +1 @@
-/**
- * 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.tokendesigner.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>;
-declare const DEFAULT_NAME_EXTENSION = "com.tokendesigner.app";
-
-/**
- * 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 ColorValue, type CssOptions, DEFAULT_CONTEXTS, DEFAULT_CONTEXT_NAME, DEFAULT_NAME_EXTENSION, type DimensionValue, type DtcgNode, type FlatToken, type FontDef, type ResolvedCssOptions, type TokenValue, emitCss, formatContextsModule, formatFontsModule, getContexts, getFonts, resolveCssOptions, tokensToCss };
+export { a as ColorValue, C as CssOptions, b as DEFAULT_CONTEXTS, c as DEFAULT_CONTEXT_NAME, d as DEFAULT_NAME_EXTENSION, f as DimensionValue, g as DtcgNode, h as FlatToken, i as FontDef, R as ResolvedCssOptions, T as TokenValue, j as emitCss, k as formatContextsModule, l as formatFontsModule, m as getContexts, n as getFonts, r as resolveCssOptions, t as tokensToCss } from './index-GGPx58oG.js';

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   getFonts,
   resolveCssOptions,
   tokensToCss
-} from "./chunk-5EW7EW3R.js";
+} from "./chunk-T6DKROBI.js";
 export {
   DEFAULT_CONTEXTS,
   DEFAULT_CONTEXT_NAME,

package/dist/node.cjs

@@ -20,22 +20,27 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/node.ts
 var node_exports = {};
 __export(node_exports, {
+  DEFAULT_CONFIG_FILE: () => DEFAULT_CONFIG_FILE,
   DEFAULT_CONTEXTS: () => DEFAULT_CONTEXTS,
   DEFAULT_CONTEXT_NAME: () => DEFAULT_CONTEXT_NAME,
   DEFAULT_NAME_EXTENSION: () => DEFAULT_NAME_EXTENSION,
+  DEFAULT_OUTPUT_DIR: () => DEFAULT_OUTPUT_DIR,
+  FALLBACK_OUTPUT_DIR: () => FALLBACK_OUTPUT_DIR,
   emitCss: () => emitCss,
   formatContextsModule: () => formatContextsModule,
   formatFontsModule: () => formatFontsModule,
   generateVariablesCss: () => generateVariablesCss,
   getContexts: () => getContexts,
   getFonts: () => getFonts,
+  initConfig: () => initConfig,
+  readPackageScripts: () => readPackageScripts,
   resolveCssOptions: () => resolveCssOptions,
   resolveOptions: () => resolveOptions,
   tokensToCss: () => tokensToCss
 });
 module.exports = __toCommonJS(node_exports);
-var import_promises = require("fs/promises");
-var import_node_path2 = require("path");
+var import_promises2 = require("fs/promises");
+var import_node_path3 = require("path");
 
 // src/config.ts
 var import_node_path = require("path");
@@ -47,8 +52,14 @@ var DEFAULT_CONTEXTS = {
   light: ".light"
 };
 var DEFAULT_INPUT = "design-tokens.json";
-var DEFAULT_VARIABLES_OUTPUT = "variables.css";
-var DEFAULT_NAME_EXTENSION = "com.tokendesigner.app";
+var DEFAULT_OUTPUT_DIR = "src/bezel";
+var FALLBACK_OUTPUT_DIR = "bezel";
+var VARIABLES_FILE = "variables.css";
+var CONTEXTS_FILE = "contexts.ts";
+var FONTS_FILE = "fonts.ts";
+var DEFAULT_VARIABLES_OUTPUT = `${DEFAULT_OUTPUT_DIR}/${VARIABLES_FILE}`;
+var DEFAULT_NAME_EXTENSION = "com.bezel.app";
+var DEFAULT_CONFIG_FILE = "bezel.json";
 
 // src/options.ts
 function resolveCssOptions(options = {}) {
@@ -442,12 +453,55 @@ function tokensToCss(tokens, options = {}) {
   return emitCss(tokens, resolveCssOptions(options));
 }
 
+// src/init.ts
+var import_node_fs = require("fs");
+var import_promises = require("fs/promises");
+var import_node_path2 = require("path");
+var joinPath = (dir, file) => dir === "" ? file : `${dir.replace(/\/+$/, "")}/${file}`;
+async function initConfig(options = {}) {
+  const cwd = options.cwd ?? process.cwd();
+  const toAbs = (p) => (0, import_node_path2.isAbsolute)(p) ? p : (0, import_node_path2.resolve)(cwd, p);
+  const configPath = toAbs(DEFAULT_CONFIG_FILE);
+  const hasTokensFile = (0, import_node_fs.existsSync)(toAbs(DEFAULT_INPUT));
+  const isTypeScript = (0, import_node_fs.existsSync)(toAbs("tsconfig.json"));
+  const hasSrc = (0, import_node_fs.existsSync)(toAbs("src"));
+  const outputDir = options.outputDir ?? (hasSrc ? DEFAULT_OUTPUT_DIR : FALLBACK_OUTPUT_DIR);
+  const wantsContexts = options.contextsOutput !== void 0 || (options.contexts ?? isTypeScript);
+  const wantsFonts = options.fontsOutput !== void 0 || (options.fonts ?? isTypeScript);
+  const config = {
+    variablesOutput: options.variablesOutput ?? joinPath(outputDir, VARIABLES_FILE)
+  };
+  if (wantsContexts) {
+    config.contextsOutput = options.contextsOutput ?? joinPath(outputDir, CONTEXTS_FILE);
+  }
+  if (wantsFonts) {
+    config.fontsOutput = options.fontsOutput ?? joinPath(outputDir, FONTS_FILE);
+  }
+  if (options.colorFormat) config.colorFormat = options.colorFormat;
+  if (options.dimensionUnit) config.dimensionUnit = options.dimensionUnit;
+  if ((0, import_node_fs.existsSync)(configPath) && !options.force) {
+    return { configPath, config, written: false, hasTokensFile, isTypeScript };
+  }
+  await (0, import_promises.writeFile)(configPath, `${JSON.stringify(config, null, 2)}
+`, "utf8");
+  return { configPath, config, written: true, hasTokensFile, isTypeScript };
+}
+async function readPackageScripts(cwd) {
+  try {
+    const raw = await (0, import_promises.readFile)((0, import_node_path2.resolve)(cwd, "package.json"), "utf8");
+    const parsed = JSON.parse(raw);
+    return parsed.scripts ?? {};
+  } catch {
+    return {};
+  }
+}
+
 // src/node.ts
 async function generateVariablesCss(options = {}) {
   const resolved = resolveOptions(options);
   let raw;
   try {
-    raw = await (0, import_promises.readFile)(resolved.inputPath, "utf8");
+    raw = await (0, import_promises2.readFile)(resolved.inputPath, "utf8");
   } catch (err) {
     throw new Error(
       `bezel: could not read tokens file at "${resolved.inputPath}". A "design-tokens.json" file must exist at the project root.
@@ -463,17 +517,17 @@ ${err.message}`);
   }
   const css = emitCss(tokens, resolved);
   if (resolved.write) {
-    await (0, import_promises.mkdir)((0, import_node_path2.dirname)(resolved.variablesOutputPath), { recursive: true });
-    await (0, import_promises.writeFile)(resolved.variablesOutputPath, css, "utf8");
+    await (0, import_promises2.mkdir)((0, import_node_path3.dirname)(resolved.variablesOutputPath), { recursive: true });
+    await (0, import_promises2.writeFile)(resolved.variablesOutputPath, css, "utf8");
     if (resolved.contextsOutput) {
       const contextsModule = formatContextsModule(getContexts(tokens));
-      await (0, import_promises.mkdir)((0, import_node_path2.dirname)(resolved.contextsOutput), { recursive: true });
-      await (0, import_promises.writeFile)(resolved.contextsOutput, contextsModule, "utf8");
+      await (0, import_promises2.mkdir)((0, import_node_path3.dirname)(resolved.contextsOutput), { recursive: true });
+      await (0, import_promises2.writeFile)(resolved.contextsOutput, contextsModule, "utf8");
     }
     if (resolved.fontsOutput) {
       const fontsModule = formatFontsModule(getFonts(tokens));
-      await (0, import_promises.mkdir)((0, import_node_path2.dirname)(resolved.fontsOutput), { recursive: true });
-      await (0, import_promises.writeFile)(resolved.fontsOutput, fontsModule, "utf8");
+      await (0, import_promises2.mkdir)((0, import_node_path3.dirname)(resolved.fontsOutput), { recursive: true });
+      await (0, import_promises2.writeFile)(resolved.fontsOutput, fontsModule, "utf8");
     }
     if (resolved.gitignore) {
       await updateGitignore(resolved);
@@ -482,7 +536,7 @@ ${err.message}`);
   return css;
 }
 async function updateGitignore(resolved) {
-  const dir = (0, import_node_path2.dirname)(resolved.gitignorePath);
+  const dir = (0, import_node_path3.dirname)(resolved.gitignorePath);
   const outputs = [
     resolved.variablesOutputPath,
     resolved.contextsOutput,
@@ -490,7 +544,7 @@ async function updateGitignore(resolved) {
   ].filter((p) => p !== null);
   const entries = [];
   for (const output of outputs) {
-    const rel = (0, import_node_path2.relative)(dir, output);
+    const rel = (0, import_node_path3.relative)(dir, output);
     if (rel === "" || rel.startsWith("..")) {
       process.stderr.write(
         `bezel: skipping .gitignore entry for "${output}" \u2014 outside ${resolved.gitignorePath}
@@ -498,31 +552,36 @@ async function updateGitignore(resolved) {
       );
       continue;
     }
-    entries.push(`/${rel.split(import_node_path2.sep).join("/")}`);
+    entries.push(`/${rel.split(import_node_path3.sep).join("/")}`);
   }
   if (entries.length === 0) return;
   let existing = "";
   try {
-    existing = await (0, import_promises.readFile)(resolved.gitignorePath, "utf8");
+    existing = await (0, import_promises2.readFile)(resolved.gitignorePath, "utf8");
   } catch {
   }
   const next = mergeGitignore(existing, entries);
   if (next !== existing) {
-    await (0, import_promises.mkdir)(dir, { recursive: true });
-    await (0, import_promises.writeFile)(resolved.gitignorePath, next, "utf8");
+    await (0, import_promises2.mkdir)(dir, { recursive: true });
+    await (0, import_promises2.writeFile)(resolved.gitignorePath, next, "utf8");
   }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_CONFIG_FILE,
   DEFAULT_CONTEXTS,
   DEFAULT_CONTEXT_NAME,
   DEFAULT_NAME_EXTENSION,
+  DEFAULT_OUTPUT_DIR,
+  FALLBACK_OUTPUT_DIR,
   emitCss,
   formatContextsModule,
   formatFontsModule,
   generateVariablesCss,
   getContexts,
   getFonts,
+  initConfig,
+  readPackageScripts,
   resolveCssOptions,
   resolveOptions,
   tokensToCss