inai-react-components 1.6.2 → 2.0.0

package/dist/commands/mcp.js

@@ -3,11 +3,13 @@ import path from "node:path";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { spawn } from "node:child_process";
 import { runList } from "./list.js";
 import { runDiff } from "./diff.js";
 import { runAdd } from "./add.js";
 import { runUpdate } from "./update.js";
 import { runStatus } from "./status.js";
+import { runThemeFromHex } from "./theme.js";
 import { THEMES } from "../utils/themes.js";
 import { resolveRegistryDir } from "../utils/registry-resolver.js";
 import { readRegistryJson } from "./status.js";
@@ -75,6 +77,39 @@ export async function handleViewComponent(args, cwd) {
     }
     return textResult(sections.join("\n"));
 }
+/**
+ * Read the prop schema for a component from the registry's generated
+ * `props-data.json` (produced by `scripts/extract-props.ts`). Returns
+ * the schema as JSON text so AI assistants can validate props before
+ * generating JSX.
+ */
+export async function handleViewComponentSchema(args, cwd) {
+    const name = args?.name;
+    if (!name)
+        return textResult("Error: 'name' argument is required.", true);
+    const registryDir = resolveRegistryDir(cwd);
+    const propsDataPath = path.join(registryDir, "apps", "docs", "src", "generated", "props-data.json");
+    if (!fs.existsSync(propsDataPath)) {
+        return textResult(`Error: props-data.json not found at ${propsDataPath}. Run \`pnpm run extract-props\` in the registry repo to generate it.`, true);
+    }
+    let propsData;
+    try {
+        propsData = JSON.parse(fs.readFileSync(propsDataPath, "utf-8"));
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return textResult(`Error: props-data.json is malformed: ${msg}`, true);
+    }
+    const componentSchema = propsData[name];
+    if (!componentSchema) {
+        const available = Object.keys(propsData).slice(0, 20).join(", ");
+        return textResult(`Error: No schema found for "${name}". First 20 available: ${available}, ...`, true);
+    }
+    return textResult(JSON.stringify({
+        name,
+        props: componentSchema.props,
+    }, null, 2));
+}
 export async function handleAddComponent(args, cwd) {
     const name = args?.name;
     if (!name)
@@ -158,6 +193,351 @@ export async function handleStatus(args, cwd) {
     const output = await runStatus(cwd, { json: args?.json ?? true });
     return textResult(output);
 }
+function findWorkspaceRoot(cwd) {
+    let dir = cwd;
+    for (let i = 0; i < 8; i++) {
+        if (fs.existsSync(path.join(dir, "pnpm-workspace.yaml")))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return cwd;
+}
+export function parseMoonshotsFile(sourceText) {
+    const results = [];
+    // Each moonshot entry is a top-level object literal inside the `moonshots`
+    // array. We split on the `{ id: N,` header then read the key/value lines.
+    const blocks = sourceText.split(/\{\s*id:\s*/).slice(1);
+    for (const block of blocks) {
+        const idMatch = block.match(/^(\d+)\s*,/);
+        if (!idMatch)
+            continue;
+        const id = Number.parseInt(idMatch[1], 10);
+        const slug = block.match(/slug:\s*"([^"]+)"/)?.[1] ?? "";
+        const title = block.match(/title:\s*"([^"]+)"/)?.[1] ?? "";
+        const description = block.match(/description:\s*\n?\s*"([^"]+)"/)?.[1] ?? "";
+        const status = block.match(/status:\s*"([^"]+)"/)?.[1] ?? "";
+        const category = block.match(/category:\s*"([^"]+)"/)?.[1];
+        const demoPath = block.match(/demoPath:\s*"([^"]+)"/)?.[1];
+        const reducedMotionStrategy = block.match(/reducedMotionStrategy:\s*\n?\s*"([^"]+)"/)?.[1];
+        const componentsRaw = block.match(/components:\s*\[([^\]]*)\]/)?.[1] ?? "";
+        const components = componentsRaw
+            .split(",")
+            .map((s) => s.trim().replace(/^"|"$/g, ""))
+            .filter(Boolean);
+        results.push({
+            id,
+            slug,
+            title,
+            description,
+            status,
+            components,
+            ...(category ? { category } : {}),
+            ...(demoPath ? { demoPath } : {}),
+            ...(reducedMotionStrategy ? { reducedMotionStrategy } : {}),
+        });
+    }
+    return results;
+}
+export async function handleListMoonshots(args, cwd) {
+    const root = findWorkspaceRoot(cwd);
+    const moonshotsPath = path.join(root, "packages/ui/src/lib/moonshots.ts");
+    if (!fs.existsSync(moonshotsPath)) {
+        return textResult(`Error: moonshots.ts not found at ${moonshotsPath}. Run from inside the InAI UI workspace.`, true);
+    }
+    const src = fs.readFileSync(moonshotsPath, "utf-8");
+    let moonshots = parseMoonshotsFile(src);
+    if (args?.status) {
+        moonshots = moonshots.filter((m) => m.status === args.status);
+    }
+    if (args?.category) {
+        moonshots = moonshots.filter((m) => m.category === args.category);
+    }
+    return textResult(JSON.stringify(moonshots, null, 2));
+}
+/**
+ * Ranks blocks by keyword overlap between the user's brief and each
+ * block's name + description. Intentionally simple — the point is to
+ * surface 5–8 relevant candidates the agent can read in full via
+ * `view_component`, not to replace a proper embedding search.
+ */
+function scoreBlock(query, text) {
+    const terms = query
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length >= 3);
+    if (terms.length === 0)
+        return 0;
+    const haystack = text.toLowerCase();
+    let score = 0;
+    for (const term of terms) {
+        if (haystack.includes(term))
+            score += 1;
+        // Bonus for exact word match.
+        const wordRegex = new RegExp(`\\b${term}\\b`);
+        if (wordRegex.test(haystack))
+            score += 1;
+    }
+    return score;
+}
+/**
+ * Pascalize a kebab/snake block slug so we can use it as an import
+ * identifier in the generated file (e.g. `signature-pricing-table-morph`
+ * → `SignaturePricingTableMorph`).
+ */
+function pascalizeSlug(slug) {
+    return slug
+        .split(/[-_]/)
+        .filter(Boolean)
+        .map((part) => part[0].toUpperCase() + part.slice(1))
+        .join("");
+}
+/**
+ * Given a brief and a target path, compose a React `.tsx` page that
+ * imports the top-matching blocks from the local registry and renders
+ * them in order. Used by the MCP `scaffold_page` tool so an agent can
+ * drop a proposal page into the current project during a live client
+ * demo without hand-typing import boilerplate.
+ *
+ * Exported for unit tests; the CLI command wraps it.
+ */
+export function scaffoldPageSource(brief, blocks) {
+    const lines = [
+        `// Generated by InAI UI MCP scaffold_page for brief:`,
+        `//   "${brief.replace(/\n/g, " ")}"`,
+        `// Edit freely — the generator does not write this file again unless`,
+        `// you delete it.`,
+        ``,
+    ];
+    for (const block of blocks) {
+        const pascal = pascalizeSlug(block.name);
+        lines.push(`import ${pascal} from "./blocks/${block.name}/page";`);
+    }
+    lines.push("");
+    lines.push("export default function GeneratedPage() {");
+    lines.push("  return (");
+    lines.push(`    <div className="flex flex-col">`);
+    for (const block of blocks) {
+        const pascal = pascalizeSlug(block.name);
+        lines.push(`      <${pascal} />`);
+    }
+    lines.push("    </div>");
+    lines.push("  );");
+    lines.push("}");
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * Wrap the CLI's `runThemeFromHex` so an agent can generate a layered
+ * brand override from a single hex value during a live demo. Writes
+ * the CSS layer under `packages/tokens/src/themes/<name>.css` (when
+ * invoked from the monorepo root) or a project-local themes dir.
+ */
+export async function handleGenerateTheme(args, cwd) {
+    const name = args?.name?.trim();
+    const hex = args?.hex?.trim();
+    if (!name) {
+        return textResult("Error: 'name' argument is required.", true);
+    }
+    if (!hex) {
+        return textResult("Error: 'hex' argument is required.", true);
+    }
+    const root = findWorkspaceRoot(cwd);
+    const result = await runThemeFromHex({ name, hex }, root);
+    if (!result.success) {
+        return textResult(result.message, true);
+    }
+    return textResult([
+        `✓ ${result.message}`,
+        "",
+        "Layer it on top of a base theme:",
+        "```css",
+        `@import "@company/tokens/themes/ultimate.css";`,
+        `@import "@company/tokens/themes/${name}.css";`,
+        "```",
+        "",
+        `Then set \`data-theme="${name}"\` on <html> (or use the live theme switcher dock) to activate it.`,
+    ].join("\n"));
+}
+/**
+ * Seed a state file that the docs app's `LiveThemeSwitcher` picks up on
+ * boot, so an agent can say "use the brand theme we just generated" and
+ * the next `pnpm --filter docs dev` run opens already themed.
+ *
+ * Implementation: writes `{ theme: "<slug>" }` JSON to `.inai/state.json`
+ * in the current project (matches the convention used by other CLI
+ * commands). Non-destructive: merges with existing state if present.
+ */
+export async function handleApplyTheme(args, cwd) {
+    const name = args?.name?.trim();
+    if (!name) {
+        return textResult("Error: 'name' argument is required.", true);
+    }
+    const stateDir = path.join(cwd, ".inai");
+    const stateFile = path.join(stateDir, "state.json");
+    fs.mkdirSync(stateDir, { recursive: true });
+    let existing = {};
+    if (fs.existsSync(stateFile)) {
+        try {
+            existing = JSON.parse(fs.readFileSync(stateFile, "utf-8"));
+        }
+        catch {
+            // Corrupt state file — rewrite from scratch.
+            existing = {};
+        }
+    }
+    const merged = { ...existing, theme: name, updatedAt: new Date().toISOString() };
+    fs.writeFileSync(stateFile, JSON.stringify(merged, null, 2));
+    return textResult([
+        `✓ Applied theme "${name}".`,
+        "",
+        `State file: \`${path.relative(cwd, stateFile) || stateFile}\``,
+        "",
+        "Next steps:",
+        "1. Reload the docs app — the pitch mode shell reads this state on mount.",
+        "2. Or open the live theme switcher dock (bottom-right FAB) and click the preset — that also sets the active theme without a reload.",
+    ].join("\n"));
+}
+/**
+ * Spawn `scripts/capture-moonshots.mjs` for the agent. Streams stdout
+ * + stderr back through the MCP result. Intended for the case where
+ * the team wants fresh video loops without dropping to the terminal.
+ */
+export async function handleCaptureMoonshots(args, cwd) {
+    const root = findWorkspaceRoot(cwd);
+    const scriptPath = path.join(root, "scripts/capture-moonshots.mjs");
+    if (!fs.existsSync(scriptPath)) {
+        return textResult(`Error: capture script not found at ${scriptPath}. Run from inside the InAI UI workspace.`, true);
+    }
+    const extra = [];
+    if (args?.slug)
+        extra.push(`--slug=${args.slug}`);
+    if (args?.force)
+        extra.push("--force");
+    return await new Promise((resolve) => {
+        const proc = spawn("node", [scriptPath, ...extra], {
+            cwd: root,
+            env: { ...process.env },
+        });
+        let out = "";
+        let err = "";
+        proc.stdout.on("data", (d) => {
+            out += d.toString();
+        });
+        proc.stderr.on("data", (d) => {
+            err += d.toString();
+        });
+        proc.on("close", (code) => {
+            const body = [
+                `\`node scripts/capture-moonshots.mjs ${extra.join(" ")}\` exited with code ${code ?? "?"}.`,
+                "",
+                "```",
+                out.trim(),
+                err.trim() ? `\n[stderr]\n${err.trim()}` : "",
+                "```",
+            ].join("\n");
+            resolve(textResult(body, (code ?? 0) !== 0));
+        });
+        proc.on("error", (e) => {
+            resolve(textResult(`Spawn failed: ${e.message}`, true));
+        });
+    });
+}
+export async function handleScaffoldPage(args, cwd) {
+    const brief = args?.brief?.trim();
+    if (!brief) {
+        return textResult("Error: 'brief' argument is required.", true);
+    }
+    const targetRel = args?.target_path?.trim();
+    if (!targetRel) {
+        return textResult("Error: 'target_path' argument is required (relative to the current project).", true);
+    }
+    const limit = Math.max(1, Math.min(args?.limit ?? 6, 12));
+    const registryDir = resolveRegistryDir(cwd);
+    const registryPath = path.join(registryDir, "registry.json");
+    const registry = readRegistryJson(registryPath);
+    if (!registry) {
+        return textResult(`Error: Registry not found at ${registryPath}.`, true);
+    }
+    const candidates = [...registry.blocks, ...registry.templates];
+    const scored = candidates
+        .map((item) => {
+        const combined = `${item.name} ${item.description}`;
+        return { item, score: scoreBlock(brief, combined) };
+    })
+        .filter((s) => s.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+    if (scored.length === 0) {
+        return textResult(`No blocks or templates matched brief "${brief}". Nothing scaffolded.`, true);
+    }
+    const targetAbs = path.resolve(cwd, targetRel);
+    if (fs.existsSync(targetAbs)) {
+        return textResult(`Error: target file already exists at ${targetAbs}. Remove it or pick a new path.`, true);
+    }
+    const source = scaffoldPageSource(brief, scored.map((s) => ({
+        name: s.item.name,
+        type: s.item.type,
+        description: s.item.description,
+    })));
+    fs.mkdirSync(path.dirname(targetAbs), { recursive: true });
+    fs.writeFileSync(targetAbs, source, "utf-8");
+    const lines = [
+        `# Scaffolded page at ${targetRel}`,
+        "",
+        `**Brief**: ${brief}`,
+        "",
+        `Composed ${scored.length} block${scored.length === 1 ? "" : "s"}:`,
+        "",
+    ];
+    for (const { item, score } of scored) {
+        lines.push(`- \`${item.name}\` (${item.type}, score ${score}) — ${item.description}`);
+    }
+    lines.push("");
+    lines.push("Next steps:");
+    lines.push("1. Make sure each referenced block is installed in your project (run `inai-ui add <slug>` for any that aren't yet).");
+    lines.push("2. Import the generated page from your router / entry point.");
+    lines.push("3. Theme it with the live theme switcher or `inai-ui theme from-hex` to lock in the client's brand.");
+    return textResult(lines.join("\n"));
+}
+export async function handleSuggestBlocks(args, cwd) {
+    const brief = args?.brief?.trim();
+    if (!brief) {
+        return textResult("Error: 'brief' argument is required.", true);
+    }
+    const limit = Math.max(1, Math.min(args?.limit ?? 6, 20));
+    const registryDir = resolveRegistryDir(cwd);
+    const registryPath = path.join(registryDir, "registry.json");
+    const registry = readRegistryJson(registryPath);
+    if (!registry) {
+        return textResult(`Error: Registry not found at ${registryPath}.`, true);
+    }
+    const candidates = [...registry.blocks, ...registry.templates];
+    const scored = candidates
+        .map((item) => {
+        const combined = `${item.name} ${item.description}`;
+        return { item, score: scoreBlock(brief, combined) };
+    })
+        .filter((s) => s.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+    if (scored.length === 0) {
+        return textResult(`No blocks or templates matched brief "${brief}". Try broader keywords.`);
+    }
+    const lines = [
+        `# ${scored.length} suggestion${scored.length === 1 ? "" : "s"} for: ${brief}`,
+        "",
+    ];
+    for (const { item, score } of scored) {
+        lines.push(`## ${item.name}  (score ${score})`);
+        lines.push(`- type: \`${item.type}\``);
+        lines.push(`- ${item.description}`);
+        lines.push("");
+    }
+    return textResult(lines.join("\n"));
+}
 // ─── MCP server bootstrap ────────────────────────────────────────────
 export const MCP_TOOLS = [
     {
@@ -184,6 +564,17 @@ export const MCP_TOOLS = [
             required: ["name"],
         },
     },
+    {
+        name: "view_component_schema",
+        description: "Return the prop schema (name, type, required, description, default) for a component. Use before generating JSX so prop names, variants and types are correct without reading the source.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Component name" },
+            },
+            required: ["name"],
+        },
+    },
     {
         name: "add_component",
         description: "Install a component (and its transitive registry dependencies) into the current project.",
@@ -236,6 +627,112 @@ export const MCP_TOOLS = [
             },
         },
     },
+    {
+        name: "list_moonshots",
+        description: "List the creative signature moonshots registered in InAI UI (kinetic typography, gradient mesh, magnetic cursor, decrypt text, etc.). Filter by status ('stable' | 'experimental') and/or category ('interaction' | 'typography' | 'layout' | 'dataviz' | 'color' | 'ambient'). Returns JSON metadata including reduced-motion strategy so the agent can choose moonshots responsibly.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                status: {
+                    type: "string",
+                    description: "Filter by maturity: 'stable' (default returns all).",
+                },
+                category: {
+                    type: "string",
+                    description: "Filter by thematic category: interaction, typography, layout, dataviz, color, ambient.",
+                },
+            },
+        },
+    },
+    {
+        name: "suggest_blocks",
+        description: "Given a free-text brief (e.g. 'fintech dashboard with live KPIs and dark hero'), rank the blocks and templates in registry.json by keyword overlap and return the top matches. Use this to scaffold a client proposal page without reading the entire registry.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                brief: {
+                    type: "string",
+                    description: "Short description of the desired page or section.",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max number of suggestions. Defaults to 6.",
+                },
+            },
+            required: ["brief"],
+        },
+    },
+    {
+        name: "scaffold_page",
+        description: "Compose a fresh React .tsx page that imports and renders the top blocks matching a brief. Writes the file to `target_path` (relative to cwd) and returns a Markdown summary. Pair with `suggest_blocks` if the caller wants to preview the picks before writing anything.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                brief: {
+                    type: "string",
+                    description: "Short description of the desired page (e.g. 'fintech landing with pricing and stats').",
+                },
+                target_path: {
+                    type: "string",
+                    description: "Relative path where the generated .tsx file will be written (e.g. 'src/pages/client-x-landing.tsx'). Must not exist yet.",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max number of blocks to compose. Defaults to 6, capped at 12.",
+                },
+            },
+            required: ["brief", "target_path"],
+        },
+    },
+    {
+        name: "generate_theme",
+        description: "Generate a brand override theme from a single hex color. Uses the same hex → OKLCH pipeline as ThemeStudio and the live theme switcher, and writes a layered `.css` file under `packages/tokens/src/themes/` that should be imported after a base theme.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Theme slug, used as the CSS filename (e.g. 'client-orbis').",
+                },
+                hex: {
+                    type: "string",
+                    description: "Brand hex color, e.g. '#6b46c1'.",
+                },
+            },
+            required: ["name", "hex"],
+        },
+    },
+    {
+        name: "apply_theme",
+        description: "Seed `.inai/state.json` with the active theme slug so the next docs app boot picks it up automatically. Non-destructive: merges with existing state. The live theme switcher also honours this state on mount.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Theme slug to activate (must already exist).",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "capture_moonshots",
+        description: "Run `scripts/capture-moonshots.mjs` to regenerate the WebM loops consumed by the gallery. Accepts an optional `slug` filter and a `force` flag to re-record already-captured moonshots. Returns the script's stdout/stderr.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slug: {
+                    type: "string",
+                    description: "Optional moonshot slug to record in isolation (e.g. 'gradient-mesh-live').",
+                },
+                force: {
+                    type: "boolean",
+                    description: "Re-capture slugs that already have a video. Defaults to false.",
+                },
+            },
+        },
+    },
 ];
 export async function runMcp(cwd = process.cwd()) {
     const server = new Server({ name: "inai-ui-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
@@ -251,6 +748,8 @@ export async function runMcp(cwd = process.cwd()) {
                     return await handleListComponents(args, cwd);
                 case "view_component":
                     return await handleViewComponent(args, cwd);
+                case "view_component_schema":
+                    return await handleViewComponentSchema(args, cwd);
                 case "add_component":
                     return await handleAddComponent(args, cwd);
                 case "diff_component":
@@ -261,6 +760,18 @@ export async function runMcp(cwd = process.cwd()) {
                     return await handleListThemes();
                 case "project_status":
                     return await handleStatus(args, cwd);
+                case "list_moonshots":
+                    return await handleListMoonshots(args, cwd);
+                case "suggest_blocks":
+                    return await handleSuggestBlocks(args, cwd);
+                case "scaffold_page":
+                    return await handleScaffoldPage(args, cwd);
+                case "generate_theme":
+                    return await handleGenerateTheme(args, cwd);
+                case "apply_theme":
+                    return await handleApplyTheme(args, cwd);
+                case "capture_moonshots":
+                    return await handleCaptureMoonshots(args, cwd);
                 default:
                     return {
                         content: [{ type: "text", text: `Unknown tool: ${name}` }],

package/dist/commands/status.d.ts

@@ -53,6 +53,13 @@ export interface RegistryJson {
     components: RegistryComponent[];
     blocks: RegistryComponent[];
     templates: RegistryComponent[];
+    /**
+     * Installable theme presets — each one is a plain `.css` file that the
+     * CLI can drop into a consumer project's styles tree and wire into the
+     * user's Tailwind v4 `@theme` layer. Optional for backward-compat with
+     * pre-2.0 registries; v2.0+ registries always populate this.
+     */
+    themes?: RegistryTheme[];
 }
 export interface RegistryComponent {
     name: string;
@@ -64,12 +71,35 @@ export interface RegistryComponent {
     tokenUsage: string[];
     tanstackCompatibility: Record<string, boolean>;
     fieldWrappers?: string[];
+    /**
+     * Thematic category used by `inai-ui list --category <name>`. Optional
+     * because older registry snapshots may not carry it. Common values:
+     * layout, data-display, feedback, overlay, navigation, forms, data-entry,
+     * misc, typography, dataviz.
+     */
+    category?: string;
+    /**
+     * Tags used for fuzzy discovery by `inai-ui list`/`add` search. Optional
+     * because older registry snapshots may not carry them.
+     */
+    tags?: string[];
     /**
      * Names of other registry components this component depends on. Used by
      * `inai-ui add` to install transitive deps automatically. Defaults to [].
      */
     registryDependencies?: string[];
 }
+export interface RegistryTheme {
+    /** Slug used with `inai-ui add theme <name>`. Matches the CSS selector. */
+    name: string;
+    type: "theme";
+    description: string;
+    /** "brand" | "shadcn" | "creative" — drives galleries and grouping. */
+    category: "brand" | "shadcn" | "creative";
+    /** Single `.css` file in `packages/tokens/src/themes/`. */
+    files: string[];
+    tags: string[];
+}
 export declare function readComponentsJson(rootDir: string): ComponentsJsonFile | null;
 export declare function readRegistryJson(registryPath: string): RegistryJson | null;
 export type ComponentHealth = "HEALTHY" | "DRIFT" | "OUTDATED" | "MISSING";

package/dist/commands/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"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"}

package/dist/commands/theme.d.ts

@@ -2,6 +2,12 @@ export interface ThemeCreateOptions {
     name: string;
     base: string;
 }
+export interface ThemeFromHexOptions {
+    /** Theme slug used as filename. */
+    name: string;
+    /** Brand hex string, e.g. "#6b46c1". */
+    hex: string;
+}
 export declare function resolveThemesDir(rootDir: string): string;
 export declare function readBaseTheme(themesDir: string, baseName: string): string | null;
 export declare function generateThemeCss(baseCss: string, newName: string, baseName: string): string;
@@ -10,5 +16,31 @@ export declare function runThemeCreate(options: ThemeCreateOptions, rootDir: str
     filePath: string;
     message: string;
 }>;
+/**
+ * Convert an sRGB hex string to approximate OKLCH. Uses the same
+ * pipeline as `packages/ui/src/lib/color-utils.ts` so themes generated
+ * by the CLI match what ThemeStudio and the live theme switcher pick.
+ *
+ * Kept self-contained so the CLI has no runtime dep on the UI package.
+ */
+export interface OklchTriple {
+    l: number;
+    c: number;
+    h: number;
+}
+export declare function hexToOklch(hex: string): OklchTriple;
+/**
+ * Produce a minimal CSS theme layer that overrides the brand-centric
+ * token slots. It is meant to be stacked on top of an existing theme
+ * (e.g. by `@import`-ing this file after `ultimate.css`) so the rest of
+ * the scheme stays coherent and accessible.
+ */
+export declare function generateThemeFromHexCss(name: string, hex: string, oklch: OklchTriple): string;
+export declare function runThemeFromHex(options: ThemeFromHexOptions, rootDir: string): Promise<{
+    success: boolean;
+    filePath: string;
+    message: string;
+}>;
+export declare function themeFromHexCommand(options: ThemeFromHexOptions): Promise<void>;
 export declare function themeCreateCommand(options: ThemeCreateOptions): Promise<void>;
 //# sourceMappingURL=theme.d.ts.map

package/dist/commands/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/commands/theme.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMhF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgB3F;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAoDlE;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBnF"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/commands/theme.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMhF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgB3F;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAoDlE;AAID;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAOD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAwBnD;AASD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,WAAW,GACjB,MAAM,CAkBR;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA6BlE;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBrF;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBnF"}