@clhaas/palette-kit 0.3.0 → 0.4.0

package/dist/cli/args.js

@@ -1,56 +0,0 @@
-export class CliUsageError extends Error {
-    name = "CliUsageError";
-}
-export const HELP_TEXT = `palette-kit <command>
-
-Commands:
-  palette-kit init [--force] [--path <dir>]
-  palette-kit build [--config <path>] [--outDir <dir>] [--report]
-
-Options:
-  -h, --help       Show help
-  -v, --version    Show version
-`;
-export const COMMANDS = ["init", "build"];
-export const parseArgs = (argv) => {
-    const first = argv[0];
-    const command = first && !first.startsWith("-") ? first : undefined;
-    const rest = command ? argv.slice(1) : argv;
-    const flags = {};
-    let i = 0;
-    while (i < rest.length) {
-        const value = rest[i];
-        if (value === undefined)
-            break;
-        if (value === "-h" || value === "--help") {
-            flags.help = true;
-            i += 1;
-            continue;
-        }
-        if (value === "-v" || value === "--version") {
-            flags.version = true;
-            i += 1;
-            continue;
-        }
-        if (value.startsWith("--")) {
-            const key = value.slice(2);
-            const next = rest[i + 1];
-            if (next && !next.startsWith("--")) {
-                flags[key] = next;
-                i += 2;
-            }
-            else {
-                flags[key] = true;
-                i += 1;
-            }
-            continue;
-        }
-        throw new CliUsageError(`Unknown argument: ${value}`);
-    }
-    return {
-        command,
-        help: Boolean(flags.help),
-        version: Boolean(flags.version),
-        flags,
-    };
-};

package/dist/cli/args.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cli/args.test.js

@@ -1,22 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { CliUsageError, parseArgs } from "./args.js";
-describe("cli args", () => {
-    it("parses init command", () => {
-        const parsed = parseArgs(["init"]);
-        expect(parsed.command).toBe("init");
-    });
-    it("parses build command with flags", () => {
-        const parsed = parseArgs(["build", "--config", "custom.ts", "--outDir", "out", "--report"]);
-        expect(parsed.command).toBe("build");
-        expect(parsed.flags.config).toBe("custom.ts");
-        expect(parsed.flags.outDir).toBe("out");
-        expect(parsed.flags.report).toBe(true);
-    });
-    it("recognizes help and version flags", () => {
-        expect(parseArgs(["--help"]).help).toBe(true);
-        expect(parseArgs(["--version"]).version).toBe(true);
-    });
-    it("throws on unknown arguments", () => {
-        expect(() => parseArgs(["build", "wat"])).toThrow(CliUsageError);
-    });
-});

package/dist/cli/codegen/__snapshots__/tokens.test.js.snap

@@ -1,87 +0,0 @@
-// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
-
-exports[`codegen tokens > generates navigable tokens.ts and tokens.d.ts 1`] = `
-"/* This file is generated by palette-kit build (Phase 7). */
-
-export const tokens = {
-bg: {
-  /**
-   * App background.
-   * @token bg.app
-   * @category bg
-   */
-  app: "bg.app",
-  },
-border: {
-  /**
-   * Default border color.
-   * @token border.default
-   * @category border
-   */
-  "default": "border.default",
-  },
-text: {
-  /**
-   * Primary text on standard surfaces.
-   * @token text.primary
-   * @category text
-   * @states hover
-   */
-  primary: "text.primary",
-  },
-} as const;
-
-export const tokenNames = [
-  "bg.app",
-  "border.default",
-  "text.primary"
-] as const;
-
-export type TokenName = (typeof tokenNames)[number];
-
-export type ColorRole = TokenName;
-"
-`;
-
-exports[`codegen tokens > generates navigable tokens.ts and tokens.d.ts 2`] = `
-"/* This file is generated by palette-kit build (Phase 7). */
-
-export declare const tokens: {
-bg: {
-  /**
-   * App background.
-   * @token bg.app
-   * @category bg
-   */
-  app: "bg.app";
-  };
-border: {
-  /**
-   * Default border color.
-   * @token border.default
-   * @category border
-   */
-  "default": "border.default";
-  };
-text: {
-  /**
-   * Primary text on standard surfaces.
-   * @token text.primary
-   * @category text
-   * @states hover
-   */
-  primary: "text.primary";
-  };
-};
-
-export declare const tokenNames: readonly [
-  "bg.app",
-  "border.default",
-  "text.primary"
-];
-
-export type TokenName = (typeof tokenNames)[number];
-
-export type ColorRole = TokenName;
-"
-`;

package/dist/cli/codegen/tokens.d.ts

@@ -1,12 +0,0 @@
-import type { TokenRegistry } from "../../types/index.js";
-export type GeneratedTokens = {
-    tokenNames: string[];
-    tokensTs: string;
-    tokensDts: string;
-};
-/**
- * Generate `dist/palette/tokens.ts` and `dist/palette/tokens.d.ts` sources.
- *
- * Output is deterministic and derived from the token registry.
- */
-export declare const generateTokenArtifacts: (registry: TokenRegistry) => GeneratedTokens;

package/dist/cli/codegen/tokens.js

@@ -1,139 +0,0 @@
-const RESERVED_WORDS = new Set([
-    "break",
-    "case",
-    "catch",
-    "class",
-    "const",
-    "continue",
-    "debugger",
-    "default",
-    "delete",
-    "do",
-    "else",
-    "export",
-    "extends",
-    "finally",
-    "for",
-    "function",
-    "if",
-    "import",
-    "in",
-    "instanceof",
-    "new",
-    "return",
-    "super",
-    "switch",
-    "this",
-    "throw",
-    "try",
-    "typeof",
-    "var",
-    "void",
-    "while",
-    "with",
-    "yield",
-]);
-const isValidIdentifier = (value) => {
-    if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(value))
-        return false;
-    return !RESERVED_WORDS.has(value);
-};
-const toPropertyKey = (key) => (isValidIdentifier(key) ? key : JSON.stringify(key));
-const indentLines = (lines, spaces) => {
-    const prefix = " ".repeat(spaces);
-    return lines.map((line) => (line.length ? `${prefix}${line}` : line));
-};
-const escapeJsDoc = (value) => value.replace(/\*\//g, "*\\/");
-const buildTokenJsDocLines = (tokenName, token) => {
-    const lines = [];
-    if (token.description?.trim()) {
-        lines.push(escapeJsDoc(token.description.trim()));
-    }
-    lines.push(`@token ${tokenName}`);
-    if (token.category?.trim()) {
-        lines.push(`@category ${escapeJsDoc(token.category.trim())}`);
-    }
-    const states = token.states ? Object.keys(token.states).sort() : [];
-    if (states.length > 0) {
-        lines.push(`@states ${states.join(", ")}`);
-    }
-    return ["/**", ...lines.map((line) => ` * ${line}`), " */"];
-};
-const buildTree = (registry) => {
-    const root = { children: new Map() };
-    const entries = Object.entries(registry.tokens).sort(([a], [b]) => a.localeCompare(b));
-    for (const [tokenName, token] of entries) {
-        const segments = tokenName.split(".").filter(Boolean);
-        if (segments.length === 0)
-            continue;
-        let node = root;
-        for (const segment of segments) {
-            let child = node.children.get(segment);
-            if (!child) {
-                child = { children: new Map() };
-                node.children.set(segment, child);
-            }
-            node = child;
-        }
-        node.token = token;
-    }
-    return root;
-};
-const renderTreeTs = (node, tokenNamePrefix) => {
-    const lines = ["{"];
-    const keys = [...node.children.keys()].sort((a, b) => a.localeCompare(b));
-    for (const key of keys) {
-        const child = node.children.get(key);
-        if (!child)
-            continue;
-        const fullTokenName = tokenNamePrefix ? `${tokenNamePrefix}.${key}` : key;
-        const propKey = toPropertyKey(key);
-        if (child.token && child.children.size === 0) {
-            lines.push(...buildTokenJsDocLines(fullTokenName, child.token));
-            lines.push(`${propKey}: "${fullTokenName}",`);
-            continue;
-        }
-        const childLines = renderTreeTs(child, fullTokenName);
-        lines.push(`${propKey}: ${childLines[0]}`);
-        lines.push(...indentLines(childLines.slice(1), 2));
-        lines[lines.length - 1] = `${lines[lines.length - 1]},`;
-    }
-    lines.push("}");
-    return lines;
-};
-const renderTreeDts = (node, tokenNamePrefix) => {
-    const lines = ["{"];
-    const keys = [...node.children.keys()].sort((a, b) => a.localeCompare(b));
-    for (const key of keys) {
-        const child = node.children.get(key);
-        if (!child)
-            continue;
-        const fullTokenName = tokenNamePrefix ? `${tokenNamePrefix}.${key}` : key;
-        const propKey = toPropertyKey(key);
-        if (child.token && child.children.size === 0) {
-            lines.push(...buildTokenJsDocLines(fullTokenName, child.token));
-            lines.push(`${propKey}: "${fullTokenName}";`);
-            continue;
-        }
-        const childLines = renderTreeDts(child, fullTokenName);
-        lines.push(`${propKey}: ${childLines[0]}`);
-        lines.push(...indentLines(childLines.slice(1), 2));
-        lines[lines.length - 1] = `${lines[lines.length - 1]};`;
-    }
-    lines.push("}");
-    return lines;
-};
-/**
- * Generate `dist/palette/tokens.ts` and `dist/palette/tokens.d.ts` sources.
- *
- * Output is deterministic and derived from the token registry.
- */
-export const generateTokenArtifacts = (registry) => {
-    const tokenNames = Object.keys(registry.tokens).sort((a, b) => a.localeCompare(b));
-    const tree = buildTree(registry);
-    const tokensObject = renderTreeTs(tree, "");
-    const tokensDtsObject = renderTreeDts(tree, "");
-    const tokensTs = `/* This file is generated by palette-kit build (Phase 7). */\n\nexport const tokens = ${tokensObject.join("\n")} as const;\n\nexport const tokenNames = ${JSON.stringify(tokenNames, null, 2)} as const;\n\nexport type TokenName = (typeof tokenNames)[number];\n\nexport type ColorRole = TokenName;\n`;
-    const tokensDts = `/* This file is generated by palette-kit build (Phase 7). */\n\nexport declare const tokens: ${tokensDtsObject.join("\n")};\n\nexport declare const tokenNames: readonly ${JSON.stringify(tokenNames, null, 2)};\n\nexport type TokenName = (typeof tokenNames)[number];\n\nexport type ColorRole = TokenName;\n`;
-    return { tokenNames, tokensTs, tokensDts };
-};

package/dist/cli/codegen/tokens.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cli/codegen/tokens.test.js

@@ -1,51 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { generateTokenArtifacts } from "./tokens.js";
-describe("codegen tokens", () => {
-    const registry = {
-        tokens: {
-            "bg.app": {
-                name: "bg.app",
-                description: "App background.",
-                category: "bg",
-                query: { role: "bg.app", usage: "bg", surface: "app" },
-            },
-            "text.primary": {
-                name: "text.primary",
-                description: "Primary text on standard surfaces.",
-                category: "text",
-                query: { role: "text.primary", usage: "text", surface: "surface" },
-                states: { hover: true },
-            },
-            "border.default": {
-                name: "border.default",
-                description: "Default border color.",
-                category: "border",
-                query: { role: "border.default", usage: "border", surface: "surface" },
-            },
-        },
-    };
-    it("generates navigable tokens.ts and tokens.d.ts", () => {
-        const { tokensTs, tokensDts } = generateTokenArtifacts(registry);
-        expect(tokensTs).toContain('export const tokens = {');
-        expect(tokensTs).toContain('bg: {');
-        expect(tokensTs).toContain('app: "bg.app"');
-        expect(tokensTs).toContain('text: {');
-        expect(tokensTs).toContain('primary: "text.primary"');
-        expect(tokensTs).toMatchSnapshot();
-        expect(tokensDts).toMatchSnapshot();
-    });
-    it("is deterministic regardless of registry object order", () => {
-        const shuffled = {
-            tokens: {
-                "text.primary": registry.tokens["text.primary"],
-                "bg.app": registry.tokens["bg.app"],
-                "border.default": registry.tokens["border.default"],
-            },
-        };
-        const a = generateTokenArtifacts(registry);
-        const b = generateTokenArtifacts(shuffled);
-        expect(b.tokenNames).toEqual(a.tokenNames);
-        expect(b.tokensTs).toBe(a.tokensTs);
-        expect(b.tokensDts).toBe(a.tokensDts);
-    });
-});

package/dist/cli/config.d.ts

@@ -1,40 +0,0 @@
-import type { ThemeConfig } from "../engine/resolveBaseColor.js";
-import type { OutputOptions } from "../types/index.js";
-/**
- * Official token preset names supported by Palette Kit tooling.
- *
- * These map to `src/presets/tokens/*` registries.
- */
-export type TokenPresetName = "minimal-ui" | "radixLike-ui" | "modern-ui";
-/**
- * Configuration contract for `palette-kit build`.
- *
- * This file is consumed by the CLI and is intended to be used from
- * `palette.config.ts` created by `palette-kit init`.
- */
-export type PaletteConfig = {
-    /**
-     * Theme inputs for palette generation (seed colors + optional variants).
-     */
-    theme: ThemeConfig;
-    /**
-     * Token preset selection for exporters/CLI.
-     */
-    tokens: {
-        preset: TokenPresetName;
-    };
-    /**
-     * Exporter options (formatting, gamut mapping, precision).
-     */
-    output?: OutputOptions;
-};
-/**
- * Build a `palette.config.ts` template for `palette-kit init`.
- *
- * @param packageName - Import path used for `PaletteConfig` typing (usually the package name).
- */
-export declare const buildConfigTemplate: (packageName: string) => string;
-/**
- * Runtime guard for token preset strings coming from user config.
- */
-export declare const isTokenPresetName: (value: string) => value is TokenPresetName;

package/dist/cli/config.js

@@ -1,34 +0,0 @@
-/**
- * Build a `palette.config.ts` template for `palette-kit init`.
- *
- * @param packageName - Import path used for `PaletteConfig` typing (usually the package name).
- */
-export const buildConfigTemplate = (packageName) => `import type { PaletteConfig } from "${packageName}";
-
-/**
- * Palette Kit configuration.
- * Update seeds, preset, and output options to match your design system.
- */
-const config: PaletteConfig = {
-  theme: {
-    seeds: {
-      light: { neutral: "#8B8D98", accent: "#3D63DD" },
-      dark: { neutral: "#8B8D98", accent: "#3D63DD" },
-    },
-    preset: "modern",
-  },
-  tokens: {
-    preset: "modern-ui",
-  },
-  output: {
-    preferSpace: "oklch",
-    includeSpaces: ["srgb", "p3"],
-  },
-};
-
-export default config;
-`;
-/**
- * Runtime guard for token preset strings coming from user config.
- */
-export const isTokenPresetName = (value) => value === "minimal-ui" || value === "radixLike-ui" || value === "modern-ui";

package/dist/cli/validate.d.ts

@@ -1,2 +0,0 @@
-import { type PaletteConfig } from "./config.js";
-export declare const validateConfig: (config: PaletteConfig) => void;

package/dist/cli/validate.js

@@ -1,33 +0,0 @@
-import { isTokenPresetName } from "./config.js";
-const validateSeed = (context, value) => {
-    if (!value || typeof value !== "object") {
-        throw new Error(`Config.theme.seeds.${context} must be an object`);
-    }
-    const seed = value;
-    if (typeof seed.neutral !== "string") {
-        throw new Error(`Config.theme.seeds.${context}.neutral must be a string color`);
-    }
-    if (typeof seed.accent !== "string") {
-        throw new Error(`Config.theme.seeds.${context}.accent must be a string color`);
-    }
-};
-export const validateConfig = (config) => {
-    if (!config || typeof config !== "object") {
-        throw new Error("Config must export a default object");
-    }
-    if (!config.theme) {
-        throw new Error("Config.theme is required");
-    }
-    const seeds = config.theme.seeds;
-    if (!seeds?.light || !seeds?.dark) {
-        throw new Error("Config.theme.seeds.light and .dark are required");
-    }
-    validateSeed("light", seeds.light);
-    validateSeed("dark", seeds.dark);
-    if (!config.tokens?.preset) {
-        throw new Error("Config.tokens.preset is required");
-    }
-    if (!isTokenPresetName(config.tokens.preset)) {
-        throw new Error(`Unsupported token preset: ${config.tokens.preset}`);
-    }
-};

package/dist/cli/validate.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cli/validate.test.js

@@ -1,40 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { validateConfig } from "./validate.js";
-describe("cli config validation", () => {
-    it("accepts a valid config", () => {
-        const config = {
-            theme: {
-                seeds: {
-                    light: { neutral: "#111827", accent: "#3d63dd" },
-                    dark: { neutral: "#111827", accent: "#3d63dd" },
-                },
-            },
-            tokens: { preset: "modern-ui" },
-        };
-        expect(() => validateConfig(config)).not.toThrow();
-    });
-    it("rejects missing neutral/accent", () => {
-        const config = {
-            theme: {
-                seeds: {
-                    light: { neutral: "#111827" },
-                    dark: { accent: "#3d63dd" },
-                },
-            },
-            tokens: { preset: "modern-ui" },
-        };
-        expect(() => validateConfig(config)).toThrow(/must be a string color/);
-    });
-    it("rejects invalid preset", () => {
-        const config = {
-            theme: {
-                seeds: {
-                    light: { neutral: "#111827", accent: "#3d63dd" },
-                    dark: { neutral: "#111827", accent: "#3d63dd" },
-                },
-            },
-            tokens: { preset: "nope" },
-        };
-        expect(() => validateConfig(config)).toThrow(/Unsupported token preset/);
-    });
-});

package/dist/cli.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};