@bezel-labs/bezel-kit 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,133 @@
+/**
+ * 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 };

package/dist/index.d.ts

@@ -0,0 +1,133 @@
+/**
+ * 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 };

package/dist/index.js

@@ -0,0 +1,25 @@
+import {
+  DEFAULT_CONTEXTS,
+  DEFAULT_CONTEXT_NAME,
+  DEFAULT_NAME_EXTENSION,
+  emitCss,
+  formatContextsModule,
+  formatFontsModule,
+  getContexts,
+  getFonts,
+  resolveCssOptions,
+  tokensToCss
+} from "./chunk-5EW7EW3R.js";
+export {
+  DEFAULT_CONTEXTS,
+  DEFAULT_CONTEXT_NAME,
+  DEFAULT_NAME_EXTENSION,
+  emitCss,
+  formatContextsModule,
+  formatFontsModule,
+  getContexts,
+  getFonts,
+  resolveCssOptions,
+  tokensToCss
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}