@bezel-labs/bezel-kit 0.1.0 → 0.2.0

package/dist/chunk-WLGTZBXW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/node.ts","../src/config.ts","../src/gitignore.ts"],"sourcesContent":["/**\n * bezel/node — Node entry.\n *\n * Re-exports the full isomorphic core, plus the filesystem conveniences:\n * read a DTCG tokens file and write the generated `variables.css` (and optional\n * `contexts.ts`/`fonts.ts`) to disk. This module imports `node:*` and is not\n * browser-safe; for the pure transform use `bezel`.\n */\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\"\nimport { dirname, relative, sep } from \"node:path\"\nimport { resolveOptions, type BezelOptions, type ResolvedOptions } from \"./config\"\nimport { emitCss } from \"./emit\"\nimport { formatContextsModule, getContexts } from \"./contexts\"\nimport { formatFontsModule, getFonts } from \"./fonts\"\nimport { mergeGitignore } from \"./gitignore\"\nimport type { DtcgNode } from \"./types\"\n\nexport * from \"./index\"\nexport { resolveOptions } from \"./config\"\nexport type { BezelOptions, ResolvedOptions } from \"./config\"\n\n/**\n * Generate a scoped `variables.css` from a W3C DTCG tokens file.\n *\n * Reads the tokens file, resolves each configured context (with `$root` fallback\n * and reference resolution), and writes one CSS scope per context — the base\n * context in full, others as override-only blocks. Returns the generated CSS.\n *\n * The tokens file is always read from `design-tokens.json` at the project root\n * (resolved against `cwd`); the name and location are fixed and not configurable.\n *\n * @example\n * // zero-config: ./design-tokens.json → ./variables.css\n * await generateVariablesCss()\n *\n * @example\n * await generateVariablesCss({\n *   variablesOutput: \"packages/ui/src/styles/variables.css\",\n * })\n */\nexport async function generateVariablesCss(options: BezelOptions = {}): Promise<string> {\n  const resolved = resolveOptions(options)\n\n  let raw: string\n  try {\n    raw = await readFile(resolved.inputPath, \"utf8\")\n  } catch (err) {\n    throw new Error(\n      `bezel: could not read tokens file at \"${resolved.inputPath}\". ` +\n        `A \"design-tokens.json\" file must exist at the project root.\\n${(err as Error).message}`,\n    )\n  }\n\n  let tokens: DtcgNode\n  try {\n    tokens = JSON.parse(raw) as DtcgNode\n  } catch (err) {\n    throw new Error(`bezel: \"${resolved.inputPath}\" is not valid JSON.\\n${(err as Error).message}`)\n  }\n\n  const css = emitCss(tokens, resolved)\n\n  if (resolved.write) {\n    await mkdir(dirname(resolved.variablesOutputPath), { recursive: true })\n    await writeFile(resolved.variablesOutputPath, css, \"utf8\")\n\n    if (resolved.contextsOutput) {\n      const contextsModule = formatContextsModule(getContexts(tokens))\n      await mkdir(dirname(resolved.contextsOutput), { recursive: true })\n      await writeFile(resolved.contextsOutput, contextsModule, \"utf8\")\n    }\n\n    if (resolved.fontsOutput) {\n      const fontsModule = formatFontsModule(getFonts(tokens))\n      await mkdir(dirname(resolved.fontsOutput), { recursive: true })\n      await writeFile(resolved.fontsOutput, fontsModule, \"utf8\")\n    }\n\n    if (resolved.gitignore) {\n      await updateGitignore(resolved)\n    }\n  }\n\n  return css\n}\n\n/**\n * Create or update the project `.gitignore` so the generated outputs are ignored.\n * Outputs are written as paths relative to the `.gitignore`, anchored with a leading\n * `/`. Outputs outside the `.gitignore`'s directory can't be anchored from it and are\n * skipped with a warning. The file is only rewritten when its contents actually change.\n */\nasync function updateGitignore(resolved: ResolvedOptions): Promise<void> {\n  const dir = dirname(resolved.gitignorePath)\n  const outputs = [\n    resolved.variablesOutputPath,\n    resolved.contextsOutput,\n    resolved.fontsOutput,\n  ].filter((p): p is string => p !== null)\n\n  const entries: string[] = []\n  for (const output of outputs) {\n    const rel = relative(dir, output)\n    if (rel === \"\" || rel.startsWith(\"..\")) {\n      process.stderr.write(\n        `bezel: skipping .gitignore entry for \"${output}\" — outside ${resolved.gitignorePath}\\n`,\n      )\n      continue\n    }\n    entries.push(`/${rel.split(sep).join(\"/\")}`)\n  }\n\n  if (entries.length === 0) return\n\n  let existing = \"\"\n  try {\n    existing = await readFile(resolved.gitignorePath, \"utf8\")\n  } catch {\n    // No existing .gitignore — create one.\n  }\n\n  const next = mergeGitignore(existing, entries)\n  if (next !== existing) {\n    await mkdir(dir, { recursive: true })\n    await writeFile(resolved.gitignorePath, next, \"utf8\")\n  }\n}\n","import { isAbsolute, resolve } from \"node:path\"\nimport { DEFAULT_INPUT, DEFAULT_VARIABLES_OUTPUT } from \"./defaults\"\nimport { resolveCssOptions, type CssOptions } from \"./options\"\n\nexport { DEFAULT_CONTEXTS, DEFAULT_INPUT, DEFAULT_VARIABLES_OUTPUT, DEFAULT_NAME_EXTENSION } from \"./defaults\"\n\n/**\n * Options for {@link generateVariablesCss} — the Node, file-oriented surface.\n * Extends the pure {@link CssOptions} with input/output paths. All optional;\n * defaults make the zero-config case work.\n */\nexport interface BezelOptions extends CssOptions {\n  /** Path to write the generated CSS. Default: `\"variables.css\"` (resolved from `cwd`). */\n  variablesOutput?: string\n  /** Base directory paths are resolved against. Default: `process.cwd()`. */\n  cwd?: string\n  /**\n   * When set, also write a generated TypeScript module exporting `CONTEXTS` (the list of\n   * context names derived from the tokens). Path resolved against `cwd`. Default: none.\n   */\n  contextsOutput?: string\n  /**\n   * When set, also write a generated TypeScript module exporting `FONTS` (the web fonts\n   * derived from the tokens). Path resolved against `cwd`. Default: none.\n   */\n  fontsOutput?: string\n  /** When `false`, return the CSS string without touching the filesystem. Default: `true`. */\n  write?: boolean\n  /**\n   * Create/update a project `.gitignore` so the generated outputs are ignored. The\n   * entries live in a marked block, rewritten on each run so renamed outputs are\n   * cleaned up. Default: `true`.\n   */\n  gitignore?: boolean\n  /** Path to the `.gitignore` to manage. Default: `\".gitignore\"` (resolved from `cwd`). */\n  gitignorePath?: string\n}\n\n/** Fully-resolved options (no `undefined`), produced by {@link resolveOptions}. */\nexport interface ResolvedOptions {\n  inputPath: string\n  variablesOutputPath: string\n  contexts: Record<string, string>\n  colorFormat: \"oklch\" | \"hex\"\n  dimensionUnit: \"preserve\" | \"rem\"\n  nameExtension: string\n  contextsOutput: string | null\n  fontsOutput: string | null\n  write: boolean\n  gitignore: boolean\n  gitignorePath: string\n}\n\n/** Apply defaults and resolve input/output paths against `cwd`. */\nexport function resolveOptions(options: BezelOptions = {}): ResolvedOptions {\n  const cwd = options.cwd ?? process.cwd()\n  const toAbs = (p: string) => (isAbsolute(p) ? p : resolve(cwd, p))\n\n  const css = resolveCssOptions(options)\n\n  return {\n    // The tokens file is always `design-tokens.json` at the project root — not configurable.\n    inputPath: toAbs(DEFAULT_INPUT),\n    variablesOutputPath: toAbs(options.variablesOutput ?? DEFAULT_VARIABLES_OUTPUT),\n    ...css,\n    contextsOutput: options.contextsOutput ? toAbs(options.contextsOutput) : null,\n    fontsOutput: options.fontsOutput ? toAbs(options.fontsOutput) : null,\n    write: options.write ?? true,\n    gitignore: options.gitignore ?? true,\n    gitignorePath: toAbs(options.gitignorePath ?? \".gitignore\"),\n  }\n}\n","/**\n * bezel — `.gitignore` managed-block merging.\n *\n * Pure string transforms (no `node:fs`): given the existing `.gitignore` contents\n * and the list of generated outputs to ignore, produce the new contents. Bezel's\n * entries live inside a marked block so repeated runs rewrite just that span —\n * renamed/removed outputs drop out automatically and entries never duplicate, while\n * the user's own rules outside the markers are preserved.\n */\n\n/** Opening marker for the Bezel-managed block. */\nexport const START = \"# bezel:start (generated — do not edit)\"\n/** Closing marker for the Bezel-managed block. */\nexport const END = \"# bezel:end\"\n\n/**\n * Merge Bezel's managed block into existing `.gitignore` contents.\n *\n * - Empty `existing` → just the block.\n * - An existing block (delimited by {@link START}…{@link END}) → replaced in place,\n *   preserving everything before and after.\n * - No block → appended after the existing content, separated by a blank line.\n *\n * The result always ends with a single trailing newline.\n */\nexport function mergeGitignore(existing: string, entries: string[]): string {\n  const block = [START, ...entries, END].join(\"\\n\")\n\n  if (existing.trim() === \"\") return `${block}\\n`\n\n  const start = existing.indexOf(START)\n  if (start !== -1) {\n    const endMarker = existing.indexOf(END, start)\n    if (endMarker !== -1) {\n      const before = existing.slice(0, start).replace(/\\n+$/, \"\")\n      const after = existing.slice(endMarker + END.length).replace(/^\\n+/, \"\")\n      const head = before === \"\" ? \"\" : `${before}\\n\\n`\n      const tail = after === \"\" ? \"\" : `\\n\\n${after.replace(/\\n+$/, \"\")}`\n      return `${head}${block}${tail}\\n`\n    }\n  }\n\n  return `${existing.replace(/\\n+$/, \"\")}\\n\\n${block}\\n`\n}\n"],"mappings":"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","names":[]}