@bezel-labs/bezel-kit 0.1.0

package/dist/node.d.cts

@@ -0,0 +1,73 @@
+import { CssOptions } from './index.cjs';
+export { ColorValue, DEFAULT_CONTEXTS, DEFAULT_CONTEXT_NAME, DEFAULT_NAME_EXTENSION, DimensionValue, DtcgNode, FlatToken, FontDef, ResolvedCssOptions, TokenValue, emitCss, formatContextsModule, formatFontsModule, getContexts, getFonts, resolveCssOptions, tokensToCss } from './index.cjs';
+
+/**
+ * Options for {@link generateVariablesCss} — the Node, file-oriented surface.
+ * Extends the pure {@link CssOptions} with input/output paths. All optional;
+ * defaults make the zero-config case work.
+ */
+interface BezelOptions extends CssOptions {
+    /** Path to write the generated CSS. Default: `"variables.css"` (resolved from `cwd`). */
+    variablesOutput?: string;
+    /** Base directory paths are resolved against. Default: `process.cwd()`. */
+    cwd?: string;
+    /**
+     * When set, also write a generated TypeScript module exporting `CONTEXTS` (the list of
+     * context names derived from the tokens). Path resolved against `cwd`. Default: none.
+     */
+    contextsOutput?: string;
+    /**
+     * When set, also write a generated TypeScript module exporting `FONTS` (the web fonts
+     * derived from the tokens). Path resolved against `cwd`. Default: none.
+     */
+    fontsOutput?: string;
+    /** When `false`, return the CSS string without touching the filesystem. Default: `true`. */
+    write?: boolean;
+    /**
+     * Create/update a project `.gitignore` so the generated outputs are ignored. The
+     * entries live in a marked block, rewritten on each run so renamed outputs are
+     * cleaned up. Default: `true`.
+     */
+    gitignore?: boolean;
+    /** Path to the `.gitignore` to manage. Default: `".gitignore"` (resolved from `cwd`). */
+    gitignorePath?: string;
+}
+/** Fully-resolved options (no `undefined`), produced by {@link resolveOptions}. */
+interface ResolvedOptions {
+    inputPath: string;
+    variablesOutputPath: string;
+    contexts: Record<string, string>;
+    colorFormat: "oklch" | "hex";
+    dimensionUnit: "preserve" | "rem";
+    nameExtension: string;
+    contextsOutput: string | null;
+    fontsOutput: string | null;
+    write: boolean;
+    gitignore: boolean;
+    gitignorePath: string;
+}
+/** Apply defaults and resolve input/output paths against `cwd`. */
+declare function resolveOptions(options?: BezelOptions): ResolvedOptions;
+
+/**
+ * Generate a scoped `variables.css` from a W3C DTCG tokens file.
+ *
+ * Reads the tokens file, resolves each configured context (with `$root` fallback
+ * and reference resolution), and writes one CSS scope per context — the base
+ * context in full, others as override-only blocks. Returns the generated CSS.
+ *
+ * The tokens file is always read from `design-tokens.json` at the project root
+ * (resolved against `cwd`); the name and location are fixed and not configurable.
+ *
+ * @example
+ * // zero-config: ./design-tokens.json → ./variables.css
+ * await generateVariablesCss()
+ *
+ * @example
+ * await generateVariablesCss({
+ *   variablesOutput: "packages/ui/src/styles/variables.css",
+ * })
+ */
+declare function generateVariablesCss(options?: BezelOptions): Promise<string>;
+
+export { type BezelOptions, CssOptions, type ResolvedOptions, generateVariablesCss, resolveOptions };

package/dist/node.d.ts

@@ -0,0 +1,73 @@
+import { CssOptions } from './index.js';
+export { ColorValue, DEFAULT_CONTEXTS, DEFAULT_CONTEXT_NAME, DEFAULT_NAME_EXTENSION, DimensionValue, DtcgNode, FlatToken, FontDef, ResolvedCssOptions, TokenValue, emitCss, formatContextsModule, formatFontsModule, getContexts, getFonts, resolveCssOptions, tokensToCss } from './index.js';
+
+/**
+ * Options for {@link generateVariablesCss} — the Node, file-oriented surface.
+ * Extends the pure {@link CssOptions} with input/output paths. All optional;
+ * defaults make the zero-config case work.
+ */
+interface BezelOptions extends CssOptions {
+    /** Path to write the generated CSS. Default: `"variables.css"` (resolved from `cwd`). */
+    variablesOutput?: string;
+    /** Base directory paths are resolved against. Default: `process.cwd()`. */
+    cwd?: string;
+    /**
+     * When set, also write a generated TypeScript module exporting `CONTEXTS` (the list of
+     * context names derived from the tokens). Path resolved against `cwd`. Default: none.
+     */
+    contextsOutput?: string;
+    /**
+     * When set, also write a generated TypeScript module exporting `FONTS` (the web fonts
+     * derived from the tokens). Path resolved against `cwd`. Default: none.
+     */
+    fontsOutput?: string;
+    /** When `false`, return the CSS string without touching the filesystem. Default: `true`. */
+    write?: boolean;
+    /**
+     * Create/update a project `.gitignore` so the generated outputs are ignored. The
+     * entries live in a marked block, rewritten on each run so renamed outputs are
+     * cleaned up. Default: `true`.
+     */
+    gitignore?: boolean;
+    /** Path to the `.gitignore` to manage. Default: `".gitignore"` (resolved from `cwd`). */
+    gitignorePath?: string;
+}
+/** Fully-resolved options (no `undefined`), produced by {@link resolveOptions}. */
+interface ResolvedOptions {
+    inputPath: string;
+    variablesOutputPath: string;
+    contexts: Record<string, string>;
+    colorFormat: "oklch" | "hex";
+    dimensionUnit: "preserve" | "rem";
+    nameExtension: string;
+    contextsOutput: string | null;
+    fontsOutput: string | null;
+    write: boolean;
+    gitignore: boolean;
+    gitignorePath: string;
+}
+/** Apply defaults and resolve input/output paths against `cwd`. */
+declare function resolveOptions(options?: BezelOptions): ResolvedOptions;
+
+/**
+ * Generate a scoped `variables.css` from a W3C DTCG tokens file.
+ *
+ * Reads the tokens file, resolves each configured context (with `$root` fallback
+ * and reference resolution), and writes one CSS scope per context — the base
+ * context in full, others as override-only blocks. Returns the generated CSS.
+ *
+ * The tokens file is always read from `design-tokens.json` at the project root
+ * (resolved against `cwd`); the name and location are fixed and not configurable.
+ *
+ * @example
+ * // zero-config: ./design-tokens.json → ./variables.css
+ * await generateVariablesCss()
+ *
+ * @example
+ * await generateVariablesCss({
+ *   variablesOutput: "packages/ui/src/styles/variables.css",
+ * })
+ */
+declare function generateVariablesCss(options?: BezelOptions): Promise<string>;
+
+export { type BezelOptions, CssOptions, type ResolvedOptions, generateVariablesCss, resolveOptions };

package/dist/node.js

@@ -0,0 +1,31 @@
+import {
+  generateVariablesCss,
+  resolveOptions
+} from "./chunk-WLGTZBXW.js";
+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,
+  generateVariablesCss,
+  getContexts,
+  getFonts,
+  resolveCssOptions,
+  resolveOptions,
+  tokensToCss
+};
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@bezel-labs/bezel-kit",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Convert a W3C Design Tokens (DTCG) file into a scoped variables.css, with one CSS scope per context.",
+  "keywords": [
+    "design-tokens",
+    "dtcg",
+    "css-variables",
+    "css-custom-properties",
+    "theming",
+    "style-dictionary"
+  ],
+  "license": "PolyForm-Shield-1.0.0",
+  "author": "Bezel (https://bezel.new)",
+  "homepage": "https://github.com/bezel-labs/bezel-kit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bezel-labs/bezel-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bezel-labs/bezel-kit/issues"
+  },
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "require": "./dist/node.cjs"
+    }
+  },
+  "bin": {
+    "bezel": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.6.0",
+    "@commitlint/config-conventional": "^19.6.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.0",
+    "husky": "^9.1.7",
+    "jest": "^29.7.0",
+    "semantic-release": "^24.2.0",
+    "ts-jest": "^29.2.5",
+    "tsup": "^8.3.5",
+    "typescript": "5.9.3"
+  }
+}