inai-react-components 1.6.1 → 2.0.0

package/dist/commands/init.js

@@ -7,6 +7,7 @@ import { cloneRegistry, getCacheDir } from "../utils/registry-resolver.js";
 import { THEME_NAMES } from "../utils/themes.js";
 import { detectFramework, frameworkLabel, getCssEntryPoint, } from "../utils/framework-detect.js";
 import { detectProjectLayout, } from "../utils/tsconfig-detect.js";
+import { stripRelativeJsExtensions } from "../utils/paths.js";
 const AVAILABLE_THEMES = THEME_NAMES;
 const FONT_PRESETS = [
     // Sans-serif — geometric & modern
@@ -89,6 +90,90 @@ function discoverThemes(registryDir) {
     }
     return [...AVAILABLE_THEMES];
 }
+// User-supplied paths in `--config <init.json>` are written into the
+// consumer project. Reject absolute paths and any `..` segment so a
+// malicious config can't escape the project root.
+function assertSafeRelativePath(value, field) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new Error(`Invalid ${field}: must be a non-empty string`);
+    }
+    if (path.isAbsolute(trimmed)) {
+        throw new Error(`Invalid ${field}: must be a relative path, got "${trimmed}"`);
+    }
+    if (trimmed.split(/[\\/]/).includes("..")) {
+        throw new Error(`Invalid ${field}: must not contain ".." segments`);
+    }
+    return trimmed;
+}
+/**
+ * Load an InitConfig from a JSON file. Used by the `--config <path>` flag
+ * to skip interactive prompts in CI / automated bootstrap flows. Missing
+ * optional fields are filled with sensible defaults; invalid/missing
+ * required fields throw with a clear message.
+ *
+ * The accepted JSON schema lives at `packages/cli/src/schemas/init-config.schema.json`.
+ */
+export function loadInitConfigFromFile(configPath, framework, layout) {
+    const absPath = path.isAbsolute(configPath)
+        ? configPath
+        : path.join(process.cwd(), configPath);
+    if (!fs.existsSync(absPath)) {
+        throw new Error(`Config file not found: ${absPath}`);
+    }
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(absPath, "utf-8"));
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new Error(`Config file is not valid JSON: ${msg}`);
+    }
+    const sourceRoot = layout?.sourceRoot ?? "src";
+    const componentPath = typeof raw.componentPath === "string"
+        ? assertSafeRelativePath(raw.componentPath, "componentPath")
+        : `${sourceRoot}/components/ui`;
+    const blockPath = typeof raw.blockPath === "string"
+        ? assertSafeRelativePath(raw.blockPath, "blockPath")
+        : `${sourceRoot}/components/blocks`;
+    const theme = typeof raw.theme === "string" ? raw.theme : AVAILABLE_THEMES[0] ?? "inai";
+    if (!AVAILABLE_THEMES.includes(theme)) {
+        throw new Error(`Unknown theme "${theme}". Allowed: ${AVAILABLE_THEMES.join(", ")}`);
+    }
+    const fontNames = FONT_PRESETS.map((f) => f.name);
+    const fontBody = typeof raw.fontBody === "string" && fontNames.includes(raw.fontBody)
+        ? raw.fontBody
+        : "outfit";
+    const fontHeading = typeof raw.fontHeading === "string" && fontNames.includes(raw.fontHeading)
+        ? raw.fontHeading
+        : "outfit";
+    const radius = typeof raw.radius === "number" ? raw.radius : 0.5;
+    const tanstackRouter = raw.tanstackRouter === true;
+    const tanstackQuery = raw.tanstackQuery === true;
+    const tanstackForm = raw.tanstackForm === true;
+    const tanstackTable = raw.tanstackTable === true;
+    const resolvedFramework = raw.framework ?? framework;
+    const cssEntryPoint = typeof raw.cssEntryPoint === "string"
+        ? assertSafeRelativePath(raw.cssEntryPoint, "cssEntryPoint")
+        : resolvedFramework
+            ? getCssEntryPoint(resolvedFramework, sourceRoot)
+            : `${sourceRoot}/index.css`;
+    return {
+        componentPath,
+        blockPath,
+        theme,
+        fontBody,
+        fontHeading,
+        radius,
+        tanstackRouter,
+        tanstackQuery,
+        tanstackForm,
+        tanstackTable,
+        framework: resolvedFramework,
+        cssEntryPoint,
+        layout,
+    };
+}
 export async function promptInitConfig(registryDir, framework, layout) {
     const themes = discoverThemes(registryDir);
     const sourceRoot = layout?.sourceRoot ?? "src";
@@ -351,14 +436,41 @@ function copyTokensToProject(registryDir, targetDir, theme, sourceRoot) {
     }
     return copied;
 }
+/**
+ * Read a source file from the registry and write it to the user's lib
+ * directory with imports normalized — `.js` suffixes stripped so the
+ * installed code reads naturally under bundler-style resolution (Vite,
+ * Next.js, TanStack Start, …). Never overwrites a pre-existing file so
+ * user customizations stay intact across re-runs.
+ *
+ * Returns the relative destination path if written, or `null` if skipped
+ * (file missing in registry, or already present in the user project).
+ */
+function copyLibFileNormalized(srcPath, destPath) {
+    if (!fs.existsSync(srcPath))
+        return false;
+    if (fs.existsSync(destPath))
+        return false; // don't clobber user files
+    const raw = fs.readFileSync(srcPath, "utf-8");
+    // Strip `.js` from relative sibling imports so `i18n-context.tsx`'s
+    // `./i18n-types.js` becomes `./i18n-types`. We intentionally DON'T
+    // apply `rewriteLibImports` here — these files live inside the lib
+    // directory already, so their sibling imports are correctly relative
+    // and shouldn't be rerouted through the `@/lib/*` alias.
+    const normalized = stripRelativeJsExtensions(raw);
+    fs.mkdirSync(path.dirname(destPath), { recursive: true });
+    fs.writeFileSync(destPath, normalized);
+    return true;
+}
 /**
  * Copies the i18n base files (context, types, defaults) from the registry
- * to `<sourceRoot>/lib/`. ~75 components import `useUIMessages` from the
- * i18n context; the CLI rewrites those imports at install-time to the
- * unified `aliases.lib` directory, so the files must land there.
+ * to the unified lib directory. ~75 components import `useUIMessages`
+ * from the i18n context; the CLI rewrites those imports at install-time
+ * to the `aliases.lib` directory, so the files must land there.
  *
- * Never overwrites pre-existing files so a user's custom i18n provider
- * stays intact across re-runs.
+ * Normalizes `.js` import suffixes in the process (so the copied
+ * `i18n-context.tsx` reads without bundler-incompatible extensions) and
+ * never overwrites pre-existing files.
  */
 export function copyI18nFiles(registryDir, targetDir, libDirRelative) {
     if (!registryDir)
@@ -366,20 +478,31 @@ export function copyI18nFiles(registryDir, targetDir, libDirRelative) {
     const files = ["i18n-context.tsx", "i18n-types.ts", "i18n-defaults.ts"];
     const srcBase = path.join(registryDir, "packages", "ui", "src", "lib");
     const destBase = path.join(targetDir, libDirRelative);
-    fs.mkdirSync(destBase, { recursive: true });
     const copied = [];
     for (const file of files) {
         const src = path.join(srcBase, file);
-        if (!fs.existsSync(src))
-            continue;
         const dest = path.join(destBase, file);
-        if (fs.existsSync(dest))
-            continue; // don't clobber user files
-        fs.copyFileSync(src, dest);
-        copied.push(`${libDirRelative}/${file}`);
+        if (copyLibFileNormalized(src, dest)) {
+            copied.push(`${libDirRelative}/${file}`);
+        }
     }
     return copied;
 }
+/**
+ * Copies the canonical `cn.ts` from the cached registry to the user's
+ * lib directory. We copy the REAL source file (not a hardcoded template)
+ * because components import extra type exports like `ClassNames` that
+ * any minimal template would miss. Returns `true` if the file was
+ * written, `false` if the registry copy was missing or a user file was
+ * already present.
+ */
+export function copyCnFile(registryDir, targetDir, libDirRelative) {
+    if (!registryDir)
+        return false;
+    const src = path.join(registryDir, "packages", "ui", "src", "lib", "cn.ts");
+    const dest = path.join(targetDir, libDirRelative, "cn.ts");
+    return copyLibFileNormalized(src, dest);
+}
 export async function runInit(config, targetDir, repoUrl) {
     const filesCreated = [];
     const sourceRoot = config.layout?.sourceRoot ?? "src";
@@ -393,27 +516,30 @@ export async function runInit(config, targetDir, repoUrl) {
     fs.mkdirSync(componentDir, { recursive: true });
     const blockDir = path.join(targetDir, config.blockPath);
     fs.mkdirSync(blockDir, { recursive: true });
-    // 3. Create the unified lib directory under `<sourceRoot>/lib/` and
-    //    seed it with `cn.ts`. Every component/block lib file ships here;
-    //    the CLI rewrites all imports at install-time to point at the
-    //    `aliases.lib` alias so there's a single source of truth.
-    //
-    //    Never overwrite an existing `cn.ts` — the user may have their own.
+    // 3. Create the unified lib directory under `<sourceRoot>/lib/`. Every
+    //    component/block lib file ships here; the CLI rewrites all imports
+    //    at install-time to point at the `aliases.lib` alias so there's a
+    //    single source of truth. `cn.ts` is seeded here so `init` users
+    //    can start writing app code immediately — the real file (not a
+    //    hardcoded template) is copied from the registry so secondary
+    //    exports like `ClassNames` stay available to components. Never
+    //    overwrite existing user files.
     const libDirRelative = `${sourceRoot}/lib`;
     const libDir = path.join(targetDir, libDirRelative);
     fs.mkdirSync(libDir, { recursive: true });
-    const cnPath = path.join(libDir, "cn.ts");
-    if (!fs.existsSync(cnPath)) {
-        fs.writeFileSync(cnPath, getCnTemplate());
-        filesCreated.push(`${libDirRelative}/cn.ts`);
-    }
     // 4. Copy tokens and create CSS
     const cssRelPath = config.cssEntryPoint ?? `${sourceRoot}/index.css`;
     const cssPath = path.join(targetDir, cssRelPath);
     fs.mkdirSync(path.dirname(cssPath), { recursive: true });
     if (repoUrl) {
-        // Remote mode: copy tokens from cached registry
+        // Remote mode: copy tokens and canonical lib files from the cached
+        // registry so users get the real `cn.ts` (including type exports
+        // like `ClassNames` that downstream components import) rather than
+        // a minimal hardcoded template.
         const registryDir = getCacheDir();
+        if (copyCnFile(registryDir, targetDir, libDirRelative)) {
+            filesCreated.push(`${libDirRelative}/cn.ts`);
+        }
         const tokenFiles = copyTokensToProject(registryDir, targetDir, config.theme, sourceRoot);
         filesCreated.push(...tokenFiles);
         // Copy i18n base files to the unified lib directory so that components'
@@ -424,13 +550,21 @@ export async function runInit(config, targetDir, repoUrl) {
         fs.writeFileSync(cssPath, getLocalTailwindCssTemplate(config.theme, config.fontBody, config.fontHeading, config.radius));
     }
     else {
-        // Local mode: reference @company/tokens package
+        // Local mode: reference @company/tokens package. Without a registry
+        // to read from, we seed `cn.ts` with a minimal template — users in
+        // this mode are almost always developing the monorepo itself, where
+        // the real `@company/ui` package is resolvable via workspace links.
+        const cnPath = path.join(libDir, "cn.ts");
+        if (!fs.existsSync(cnPath)) {
+            fs.writeFileSync(cnPath, getCnTemplate());
+            filesCreated.push(`${libDirRelative}/cn.ts`);
+        }
         fs.writeFileSync(cssPath, getLegacyTailwindCssTemplate(config.theme, config.fontBody, config.fontHeading, config.radius));
     }
     filesCreated.push(cssRelPath);
     return { success: true, filesCreated };
 }
-export async function initCommand(repoUrl) {
+export async function initCommand(repoUrl, options = {}) {
     console.log(chalk.bold("\nInAI UI - Project Initialization\n"));
     const cwd = process.cwd();
     const detectedFramework = detectFramework(cwd);
@@ -452,7 +586,21 @@ export async function initCommand(repoUrl) {
         }
     }
     const registryDir = repoUrl ? getCacheDir() : undefined;
-    const config = await promptInitConfig(registryDir, detectedFramework, detectedLayout);
+    let config;
+    if (options.config) {
+        try {
+            config = loadInitConfigFromFile(options.config, detectedFramework, detectedLayout);
+            console.log(chalk.dim(`Loaded config from ${options.config} (skipping prompts)`));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\nFailed to load config: ${message}`));
+            process.exit(1);
+        }
+    }
+    else {
+        config = await promptInitConfig(registryDir, detectedFramework, detectedLayout);
+    }
     if (!config) {
         console.log(chalk.yellow("\nInitialization cancelled."));
         process.exit(0);

package/dist/commands/list.js

@@ -11,7 +11,7 @@ function padRight(str, len) {
 export function formatComponentTable(components, filterCategory) {
     let filtered = components;
     if (filterCategory) {
-        filtered = components.filter((c) => c.type.toLowerCase() === filterCategory.toLowerCase());
+        filtered = components.filter((c) => (c.category ?? "").toLowerCase() === filterCategory.toLowerCase());
     }
     if (filtered.length === 0) {
         if (filterCategory) {

package/dist/commands/manifest.d.ts

@@ -0,0 +1,9 @@
+export interface ManifestOptions {
+    /** Output as JSON instead of a human-readable table. */
+    json?: boolean;
+    /** Only show entries where the installed version differs from the
+     *  current registry version. */
+    outdated?: boolean;
+}
+export declare function manifestCommand(options?: ManifestOptions): Promise<void>;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/commands/manifest.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;oCACgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAuGD,wBAAsB,eAAe,CACnC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAiDf"}

package/dist/commands/manifest.js

@@ -0,0 +1,89 @@
+import path from "node:path";
+import chalk from "chalk";
+import { readComponentsJson, readRegistryJson, } from "./status.js";
+import { resolveRegistryDir } from "../utils/registry-resolver.js";
+function buildEntries(installed, registryVersion) {
+    return installed
+        .map((c) => ({
+        name: c.name,
+        installedVersion: c.version,
+        installedAt: c.installedAt,
+        registryVersion,
+        outdated: registryVersion !== null && c.version !== registryVersion,
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+function renderHumanReadable(componentsJson, entries, registryVersion) {
+    const lines = [];
+    lines.push(chalk.bold("\nInAI UI — Component Manifest\n"));
+    if (componentsJson.registrySource) {
+        lines.push(chalk.dim(`Registry: ${componentsJson.registrySource}`));
+    }
+    if (registryVersion) {
+        lines.push(chalk.dim(`Registry version: ${registryVersion}`));
+    }
+    else {
+        lines.push(chalk.dim("Registry version: unknown (no cached registry.json — run `inai-ui status` to refresh)"));
+    }
+    lines.push("");
+    if (entries.length === 0) {
+        lines.push(chalk.yellow("No components installed yet. Run `inai-ui add <name>` to install one."));
+        return lines.join("\n");
+    }
+    const nameWidth = Math.max(...entries.map((e) => e.name.length), 4) + 2;
+    const versionWidth = Math.max(...entries.map((e) => e.installedVersion.length), 7);
+    const dateWidth = 10;
+    lines.push(chalk.bold(`${"Name".padEnd(nameWidth)}${"Version".padEnd(versionWidth + 2)}${"Installed".padEnd(dateWidth + 2)}Status`));
+    lines.push(chalk.dim("─".repeat(nameWidth) +
+        "─".repeat(versionWidth + 2) +
+        "─".repeat(dateWidth + 2) +
+        "──────"));
+    for (const e of entries) {
+        const status = e.outdated
+            ? chalk.yellow(`outdated → ${e.registryVersion}`)
+            : chalk.green("up-to-date");
+        lines.push(`${e.name.padEnd(nameWidth)}${e.installedVersion.padEnd(versionWidth + 2)}${e.installedAt.padEnd(dateWidth + 2)}${status}`);
+    }
+    const outdatedCount = entries.filter((e) => e.outdated).length;
+    lines.push("");
+    if (outdatedCount > 0) {
+        lines.push(chalk.yellow(`${outdatedCount}/${entries.length} components are outdated. Run \`inai-ui update <name>\` or \`inai-ui update --all\` to upgrade.`));
+    }
+    else {
+        lines.push(chalk.green(`All ${entries.length} components are up to date.`));
+    }
+    return lines.join("\n");
+}
+export async function manifestCommand(options = {}) {
+    const rootDir = process.cwd();
+    const componentsJson = readComponentsJson(rootDir);
+    if (!componentsJson) {
+        console.error(chalk.red("\nNo components.json found. Run `inai-ui init` first to initialize the project."));
+        process.exit(1);
+    }
+    const installed = componentsJson.installedComponents ?? [];
+    // Resolve the registry to read its current version (best-effort; if it
+    // fails we still print installed versions, just without a comparison).
+    let registryVersion = null;
+    try {
+        const registryDir = resolveRegistryDir(rootDir);
+        const registryJson = readRegistryJson(path.join(registryDir, "registry.json"));
+        registryVersion = registryJson?.version ?? null;
+    }
+    catch {
+        // Offline / no registry cache yet — fine, just skip the comparison.
+    }
+    let entries = buildEntries(installed, registryVersion);
+    if (options.outdated) {
+        entries = entries.filter((e) => e.outdated);
+    }
+    if (options.json) {
+        console.log(JSON.stringify({
+            registrySource: componentsJson.registrySource ?? null,
+            registryVersion,
+            installed: entries,
+        }, null, 2));
+        return;
+    }
+    console.log(renderHumanReadable(componentsJson, entries, registryVersion));
+}

package/dist/commands/mcp.d.ts

@@ -16,6 +16,15 @@ export declare function handleListComponents(args: {
 export declare function handleViewComponent(args: {
     name?: string;
 } | undefined, cwd: string): Promise<ToolTextResult>;
+/**
+ * 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 declare function handleViewComponentSchema(args: {
+    name?: string;
+} | undefined, cwd: string): Promise<ToolTextResult>;
 export declare function handleAddComponent(args: {
     name?: string;
     force?: boolean;
@@ -30,6 +39,92 @@ export declare function handleListThemes(): Promise<ToolTextResult>;
 export declare function handleStatus(args: {
     json?: boolean;
 } | undefined, cwd: string): Promise<ToolTextResult>;
+/**
+ * Parse the moonshots registry source file as plain text. We intentionally
+ * do *not* `import` the TS file here — the CLI is compiled ahead of time
+ * and cannot transitively load UI sources. Regex is enough because the
+ * file has a stable `{ id: N, slug: "…", title: "…", description: "…",
+ * status: "…", category: "…" }` shape.
+ */
+export interface MoonshotSummary {
+    id: number;
+    slug: string;
+    title: string;
+    description: string;
+    status: string;
+    category?: string;
+    components: string[];
+    demoPath?: string;
+    reducedMotionStrategy?: string;
+}
+export declare function parseMoonshotsFile(sourceText: string): MoonshotSummary[];
+export declare function handleListMoonshots(args: {
+    status?: string;
+    category?: string;
+} | undefined, cwd: string): Promise<ToolTextResult>;
+export interface ScaffoldedPage {
+    targetPath: string;
+    source: string;
+    blocks: {
+        name: string;
+        slug: string;
+        score: number;
+    }[];
+}
+/**
+ * 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 declare function scaffoldPageSource(brief: string, blocks: Array<{
+    name: string;
+    type: string;
+    description: string;
+}>): string;
+/**
+ * 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 declare function handleGenerateTheme(args: {
+    name?: string;
+    hex?: string;
+} | undefined, cwd: string): Promise<ToolTextResult>;
+/**
+ * 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 declare function handleApplyTheme(args: {
+    name?: string;
+} | undefined, cwd: string): Promise<ToolTextResult>;
+/**
+ * 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 declare function handleCaptureMoonshots(args: {
+    slug?: string;
+    force?: boolean;
+} | undefined, cwd: string): Promise<ToolTextResult>;
+export declare function handleScaffoldPage(args: {
+    brief?: string;
+    target_path?: string;
+    limit?: number;
+} | undefined, cwd: string): Promise<ToolTextResult>;
+export declare function handleSuggestBlocks(args: {
+    brief?: string;
+    limit?: number;
+} | undefined, cwd: string): Promise<ToolTextResult>;
 export declare const MCP_TOOLS: readonly [{
     readonly name: "list_components";
     readonly description: "List all available components, blocks and templates in the InAI UI registry.";
@@ -55,6 +150,19 @@ export declare const MCP_TOOLS: readonly [{
         };
         readonly required: readonly ["name"];
     };
+}, {
+    readonly name: "view_component_schema";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Component name";
+            };
+        };
+        readonly required: readonly ["name"];
+    };
 }, {
     readonly name: "add_component";
     readonly description: "Install a component (and its transitive registry dependencies) into the current project.";
@@ -117,6 +225,106 @@ export declare const MCP_TOOLS: readonly [{
             };
         };
     };
+}, {
+    readonly name: "list_moonshots";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly status: {
+                readonly type: "string";
+                readonly description: "Filter by maturity: 'stable' (default returns all).";
+            };
+            readonly category: {
+                readonly type: "string";
+                readonly description: "Filter by thematic category: interaction, typography, layout, dataviz, color, ambient.";
+            };
+        };
+    };
+}, {
+    readonly name: "suggest_blocks";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly brief: {
+                readonly type: "string";
+                readonly description: "Short description of the desired page or section.";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max number of suggestions. Defaults to 6.";
+            };
+        };
+        readonly required: readonly ["brief"];
+    };
+}, {
+    readonly name: "scaffold_page";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly brief: {
+                readonly type: "string";
+                readonly description: "Short description of the desired page (e.g. 'fintech landing with pricing and stats').";
+            };
+            readonly target_path: {
+                readonly type: "string";
+                readonly description: "Relative path where the generated .tsx file will be written (e.g. 'src/pages/client-x-landing.tsx'). Must not exist yet.";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max number of blocks to compose. Defaults to 6, capped at 12.";
+            };
+        };
+        readonly required: readonly ["brief", "target_path"];
+    };
+}, {
+    readonly name: "generate_theme";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Theme slug, used as the CSS filename (e.g. 'client-orbis').";
+            };
+            readonly hex: {
+                readonly type: "string";
+                readonly description: "Brand hex color, e.g. '#6b46c1'.";
+            };
+        };
+        readonly required: readonly ["name", "hex"];
+    };
+}, {
+    readonly name: "apply_theme";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Theme slug to activate (must already exist).";
+            };
+        };
+        readonly required: readonly ["name"];
+    };
+}, {
+    readonly name: "capture_moonshots";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly slug: {
+                readonly type: "string";
+                readonly description: "Optional moonshot slug to record in isolation (e.g. 'gradient-mesh-live').";
+            };
+            readonly force: {
+                readonly type: "boolean";
+                readonly description: "Re-capture slugs that already have a video. Defaults to false.";
+            };
+        };
+    };
 }];
 export declare function runMcp(cwd?: string): Promise<void>;
 export declare function mcpCommand(subcommand?: "init"): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAgCA;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAID,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AASD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EACvC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,CAKzB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EACnC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,CA8BzB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,EACpD,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,CAkBzB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EACnC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,CAmCzB;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EACnC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,CAgBzB;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,cAAc,CAAC,CAEhE;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,EACpC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,CAAC,CAGzB;AAID,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoFZ,CAAC;AAEX,wBAAsB,MAAM,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiEvE;AAED,wBAAsB,UAAU,CAC9B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAMf"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"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"}