@cloudflare/kumo 1.0.0

package/dist/src/catalog/catalog.d.ts

@@ -0,0 +1,75 @@
+import { KumoCatalog, CatalogConfig, UIElement } from './types';
+interface SchemasModule {
+    KUMO_COMPONENT_NAMES: readonly string[];
+    UIElementBaseSchema: {
+        safeParse: (data: unknown) => {
+            success: boolean;
+            data?: unknown;
+            error?: {
+                issues: Array<{
+                    message: string;
+                    path: (string | number)[];
+                }>;
+            };
+        };
+    };
+    validateElementProps: (element: UIElement) => {
+        success: boolean;
+        error?: {
+            issues: Array<{
+                message: string;
+                path: (string | number)[];
+            }>;
+        };
+    };
+    validateUITree: (tree: unknown) => {
+        success: boolean;
+        data?: unknown;
+        error?: {
+            issues: Array<{
+                message: string;
+                path: (string | number)[];
+            }>;
+        };
+    };
+}
+/**
+ * Load the generated schemas module.
+ * This is called automatically when needed.
+ */
+export declare function loadSchemas(): Promise<SchemasModule>;
+/**
+ * Create a Kumo catalog for runtime validation.
+ *
+ * The catalog:
+ * - Uses auto-generated Zod schemas from component-registry.json
+ * - Validates UI elements and trees at runtime
+ * - Generates AI prompts describing available components
+ *
+ * @example
+ * import { createKumoCatalog, initCatalog } from '@cloudflare/kumo/catalog';
+ *
+ * const catalog = createKumoCatalog({
+ *   actions: {
+ *     submit_form: { description: 'Submit the form' },
+ *     delete_item: { description: 'Delete selected item' },
+ *   },
+ * });
+ *
+ * // Initialize schemas (required before sync validation)
+ * await initCatalog(catalog);
+ *
+ * // Validate AI-generated tree
+ * const result = catalog.validateTree(aiGeneratedJson);
+ * if (result.success) {
+ *   // Render the tree
+ * }
+ */
+export declare function createKumoCatalog(config?: CatalogConfig): KumoCatalog;
+/**
+ * Initialize the catalog by loading schemas.
+ * Call this before using synchronous validation methods.
+ */
+export declare function initCatalog(catalog: KumoCatalog): Promise<void>;
+export {};
+//# sourceMappingURL=catalog.d.ts.map

package/dist/src/catalog/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/catalog/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EAIb,SAAS,EACV,MAAM,SAAS,CAAC;AAGjB,UAAU,aAAa;IACrB,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,mBAAmB,EAAE;QACnB,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;YAC5B,OAAO,EAAE,OAAO,CAAC;YACjB,IAAI,CAAC,EAAE,OAAO,CAAC;YACf,KAAK,CAAC,EAAE;gBAAE,MAAM,EAAE,KAAK,CAAC;oBAAE,OAAO,EAAE,MAAM,CAAC;oBAAC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;iBAAE,CAAC,CAAA;aAAE,CAAC;SAC3E,CAAC;KACH,CAAC;IACF,oBAAoB,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK;QAC5C,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE;YAAE,MAAM,EAAE,KAAK,CAAC;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;KAC3E,CAAC;IACF,cAAc,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;QACjC,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE;YAAE,MAAM,EAAE,KAAK,CAAC;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;KAC3E,CAAC;CACH;AAMD;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC,CAU1D;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,aAAkB,GAAG,WAAW,CA8KzE;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrE"}

package/dist/src/catalog/data.d.ts

@@ -0,0 +1,44 @@
+import { DataModel, DynamicValue } from './types';
+/**
+ * Get a value from an object by JSON Pointer path.
+ *
+ * @example
+ * const data = { user: { name: "John", profile: { age: 30 } } };
+ * getByPath(data, "/user/name") // "John"
+ * getByPath(data, "/user/profile/age") // 30
+ * getByPath(data, "/missing") // undefined
+ */
+export declare function getByPath(obj: unknown, path: string): unknown;
+/**
+ * Set a value in an object by JSON Pointer path.
+ * Creates intermediate objects as needed.
+ *
+ * @example
+ * const data = {};
+ * setByPath(data, "/user/name", "John");
+ * // data is now { user: { name: "John" } }
+ */
+export declare function setByPath(obj: Record<string, unknown>, path: string, value: unknown): void;
+/**
+ * Check if a value is a dynamic path reference.
+ */
+export declare function isDynamicPath(value: unknown): value is {
+    path: string;
+};
+/**
+ * Resolve a dynamic value against a data model.
+ * If the value is a path reference, look it up in the data model.
+ * Otherwise, return the literal value.
+ *
+ * @example
+ * const data = { user: { name: "John" } };
+ * resolveDynamicValue("Hello", data) // "Hello"
+ * resolveDynamicValue({ path: "/user/name" }, data) // "John"
+ */
+export declare function resolveDynamicValue<T>(value: DynamicValue<T>, dataModel: DataModel): T | undefined;
+/**
+ * Resolve all dynamic values in an object.
+ * Recursively resolves any { path: string } references.
+ */
+export declare function resolveProps(props: Record<string, unknown>, dataModel: DataModel): Record<string, unknown>;
+//# sourceMappingURL=data.d.ts.map

package/dist/src/catalog/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../src/catalog/data.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAwB7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,IAAI,CAmBN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAOvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EACtB,SAAS,EAAE,SAAS,GACnB,CAAC,GAAG,SAAS,CAUf;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,EAAE,SAAS,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB"}

package/dist/src/catalog/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Kumo Catalog Module
+ *
+ * Runtime utilities for JSON-based UI rendering with Kumo components.
+ * Based on the json-render pattern: https://github.com/vercel-labs/json-render
+ *
+ * Features:
+ * - Catalog creation with auto-generated Zod schemas
+ * - UI tree validation
+ * - Dynamic value resolution (data binding)
+ * - Visibility condition evaluation
+ * - Action handling
+ *
+ * @example
+ * import {
+ *   createKumoCatalog,
+ *   initCatalog,
+ *   evaluateVisibility,
+ *   resolveProps,
+ * } from '@cloudflare/kumo/catalog';
+ *
+ * // Create catalog with actions
+ * const catalog = createKumoCatalog({
+ *   actions: {
+ *     submit: { description: 'Submit form' },
+ *   },
+ * });
+ *
+ * // Initialize (loads schemas)
+ * await initCatalog(catalog);
+ *
+ * // Validate AI-generated tree
+ * const result = catalog.validateTree(aiGeneratedJson);
+ */
+export type { UIElement, UITree, DynamicValue, DynamicString, DynamicNumber, DynamicBoolean, VisibilityCondition, LogicExpression, Action, ActionConfirm, ActionHandler, ActionHandlers, ActionDefinition, AuthState, DataModel, KumoCatalog, CatalogConfig, ValidationResult, ComponentRegistry, ComponentSchema, PropSchema, SubComponentSchema, } from './types';
+export { createKumoCatalog, initCatalog, loadSchemas } from './catalog';
+export { getByPath, setByPath, isDynamicPath, resolveDynamicValue, resolveProps, } from './data';
+export { evaluateVisibility, createVisibilityContext, type VisibilityContext, } from './visibility';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/catalog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/catalog/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,YAAY,EAEV,SAAS,EACT,MAAM,EACN,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EAEd,mBAAmB,EACnB,eAAe,EAEf,MAAM,EACN,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAEhB,SAAS,EACT,SAAS,EAET,WAAW,EACX,aAAa,EACb,gBAAgB,EAEhB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxE,OAAO,EACL,SAAS,EACT,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,YAAY,GACb,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC"}

package/dist/src/catalog/types.d.ts

@@ -0,0 +1,226 @@
+/**
+ * Runtime types for Kumo catalog module.
+ *
+ * These types extend the registry types with runtime capabilities
+ * like visibility conditions, actions, and data binding.
+ */
+export type { ComponentRegistry, ComponentSchema, PropSchema, SubComponentSchema, } from '../registry/types';
+/**
+ * A value that can either be a literal or a reference to the data model.
+ * When { path: string }, the value is resolved from the data model at runtime.
+ *
+ * @example
+ * // Literal value
+ * const title: DynamicValue<string> = "Hello World";
+ *
+ * // Dynamic reference
+ * const title: DynamicValue<string> = { path: "/user/name" };
+ */
+export type DynamicValue<T = unknown> = T | {
+    path: string;
+};
+export type DynamicString = DynamicValue<string>;
+export type DynamicNumber = DynamicValue<number>;
+export type DynamicBoolean = DynamicValue<boolean>;
+/**
+ * Logic expression for complex visibility conditions.
+ * Supports boolean logic (and, or, not) and comparisons.
+ */
+export type LogicExpression = {
+    and: LogicExpression[];
+} | {
+    or: LogicExpression[];
+} | {
+    not: LogicExpression;
+} | {
+    path: string;
+} | {
+    eq: [DynamicValue, DynamicValue];
+} | {
+    neq: [DynamicValue, DynamicValue];
+} | {
+    gt: [DynamicValue<number>, DynamicValue<number>];
+} | {
+    gte: [DynamicValue<number>, DynamicValue<number>];
+} | {
+    lt: [DynamicValue<number>, DynamicValue<number>];
+} | {
+    lte: [DynamicValue<number>, DynamicValue<number>];
+};
+/**
+ * Visibility condition for conditional rendering.
+ *
+ * @example
+ * // Always visible
+ * visible: true
+ *
+ * // Visible when data path is truthy
+ * visible: { path: "/user/isAdmin" }
+ *
+ * // Visible when user is signed in
+ * visible: { auth: "signedIn" }
+ *
+ * // Complex condition
+ * visible: { and: [{ path: "/user/isAdmin" }, { auth: "signedIn" }] }
+ */
+export type VisibilityCondition = boolean | {
+    path: string;
+} | {
+    auth: "signedIn" | "signedOut";
+} | LogicExpression;
+/**
+ * Confirmation dialog configuration for destructive actions.
+ */
+export interface ActionConfirm {
+    title: string;
+    message: string;
+    variant?: "default" | "danger";
+    confirmLabel?: string;
+    cancelLabel?: string;
+}
+/**
+ * Action that can be triggered by a component.
+ * AI declares the intent, your handlers execute the logic.
+ *
+ * @example
+ * {
+ *   name: "delete_item",
+ *   params: {
+ *     itemId: { path: "/selected/id" }
+ *   },
+ *   confirm: {
+ *     title: "Delete Item",
+ *     message: "Are you sure?",
+ *     variant: "danger"
+ *   }
+ * }
+ */
+export interface Action {
+    /** Action name (must be registered in catalog) */
+    name: string;
+    /** Parameters to pass to the action handler */
+    params?: Record<string, DynamicValue>;
+    /** Confirmation dialog before executing */
+    confirm?: ActionConfirm;
+    /** Data updates on successful execution */
+    onSuccess?: {
+        set: Record<string, DynamicValue>;
+    };
+    /** Data updates on error */
+    onError?: {
+        set: Record<string, DynamicValue>;
+    };
+}
+/**
+ * A single UI element in the tree.
+ * Represents one component with its props and relationships.
+ */
+export interface UIElement<TType extends string = string, TProps = Record<string, unknown>> {
+    /** Unique key for reconciliation */
+    key: string;
+    /** Component type from the catalog */
+    type: TType;
+    /** Component props (may include dynamic values) */
+    props: TProps;
+    /** Child element keys (flat structure for streaming) */
+    children?: string[];
+    /** Parent element key (null for root) */
+    parentKey?: string | null;
+    /** Visibility condition */
+    visible?: VisibilityCondition;
+    /** Action to trigger on interaction */
+    action?: Action;
+}
+/**
+ * Flat UI tree structure optimized for LLM generation and streaming.
+ *
+ * The flat structure allows:
+ * - Progressive rendering as elements stream in
+ * - Easy updates without deep tree traversal
+ * - Simple serialization/deserialization
+ *
+ * @example
+ * {
+ *   root: "card-1",
+ *   elements: {
+ *     "card-1": { key: "card-1", type: "Surface", props: { variant: "card" }, children: ["text-1"] },
+ *     "text-1": { key: "text-1", type: "Text", props: { children: "Hello" }, parentKey: "card-1" }
+ *   }
+ * }
+ */
+export interface UITree {
+    /** Root element key */
+    root: string;
+    /** Flat map of elements by key */
+    elements: Record<string, UIElement>;
+}
+/**
+ * Authentication state for visibility evaluation.
+ */
+export interface AuthState {
+    isSignedIn: boolean;
+    user?: Record<string, unknown>;
+}
+/**
+ * Data model that backs dynamic values.
+ * Values are accessed via JSON Pointer paths (e.g., "/user/name").
+ */
+export type DataModel = Record<string, unknown>;
+/**
+ * Action handler function signature.
+ */
+export type ActionHandler = (params: Record<string, unknown>) => void | Promise<void>;
+/**
+ * Map of action names to their handlers.
+ */
+export type ActionHandlers = Record<string, ActionHandler>;
+/**
+ * Action definition for the catalog.
+ */
+export interface ActionDefinition {
+    /** Description for AI generation */
+    description: string;
+    /** Parameter schema (optional, for validation) */
+    params?: Record<string, {
+        type: string;
+        description?: string;
+    }>;
+}
+/**
+ * Catalog configuration for createKumoCatalog.
+ */
+export interface CatalogConfig {
+    /** Action definitions (optional) */
+    actions?: Record<string, ActionDefinition>;
+}
+/**
+ * Runtime catalog instance.
+ */
+export interface KumoCatalog {
+    /** Component names in the catalog */
+    readonly componentNames: readonly string[];
+    /** Action names in the catalog */
+    readonly actionNames: readonly string[];
+    /** Check if component type exists */
+    hasComponent(type: string): boolean;
+    /** Check if action exists */
+    hasAction(name: string): boolean;
+    /** Validate a UI element */
+    validateElement(element: unknown): ValidationResult;
+    /** Validate a complete UI tree */
+    validateTree(tree: unknown): ValidationResult<UITree>;
+    /** Generate a prompt describing the catalog for AI */
+    generatePrompt(): string;
+}
+/**
+ * Validation result from schema validation.
+ */
+export interface ValidationResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        message: string;
+        path: (string | number)[];
+    }[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/catalog/types.d.ts.map

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

package/dist/src/catalog/visibility.d.ts

@@ -0,0 +1,37 @@
+import { VisibilityCondition, DataModel, AuthState } from './types';
+/**
+ * Context for evaluating visibility conditions.
+ */
+export interface VisibilityContext {
+    /** Data model for path resolution */
+    data: DataModel;
+    /** Authentication state */
+    auth: AuthState;
+}
+/**
+ * Evaluate a visibility condition.
+ *
+ * @example
+ * // Boolean
+ * evaluateVisibility(true, ctx) // true
+ *
+ * // Path check
+ * evaluateVisibility({ path: "/user/isAdmin" }, ctx) // depends on data
+ *
+ * // Auth check
+ * evaluateVisibility({ auth: "signedIn" }, ctx) // depends on auth state
+ *
+ * // Complex logic
+ * evaluateVisibility({
+ *   and: [
+ *     { path: "/user/isAdmin" },
+ *     { auth: "signedIn" }
+ *   ]
+ * }, ctx)
+ */
+export declare function evaluateVisibility(condition: VisibilityCondition | undefined, ctx: VisibilityContext): boolean;
+/**
+ * Create a default visibility context.
+ */
+export declare function createVisibilityContext(data?: DataModel, auth?: Partial<AuthState>): VisibilityContext;
+//# sourceMappingURL=visibility.d.ts.map

package/dist/src/catalog/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../../src/catalog/visibility.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,mBAAmB,EAEnB,SAAS,EACT,SAAS,EACV,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,IAAI,EAAE,SAAS,CAAC;IAChB,2BAA2B;IAC3B,IAAI,EAAE,SAAS,CAAC;CACjB;AA+FD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,mBAAmB,GAAG,SAAS,EAC1C,GAAG,EAAE,iBAAiB,GACrB,OAAO,CA8BT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,GAAE,SAAc,EACpB,IAAI,GAAE,OAAO,CAAC,SAAS,CAAM,GAC5B,iBAAiB,CAQnB"}

package/dist/src/command-line/build-cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Build script for the Kumo CLI
+ * Compiles TypeScript CLI files to JavaScript in dist/command-line/
+ */
+export {};
+//# sourceMappingURL=build-cli.d.ts.map

package/dist/src/command-line/build-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-cli.d.ts","sourceRoot":"","sources":["../../../src/command-line/build-cli.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/src/command-line/cli.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Kumo CLI - Component registry and blocks distribution
+ *
+ * Usage:
+ *   kumo init                 Initialize kumo.json configuration
+ *   kumo ls                   List all components
+ *   kumo doc <name>           Get documentation for a component
+ *   kumo docs                 Get documentation for all components
+ *   kumo help                 Show this help message
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/command-line/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/command-line/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/src/command-line/commands/add.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Add a Kumo block to the project
+ * Usage: kumo add <block-name>
+ */
+/**
+ * Add a block to the project
+ */
+export declare function add(blockName: string | undefined): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/dist/src/command-line/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/add.ts"],"names":[],"mappings":";AACA;;;GAGG;AAiGH;;GAEG;AACH,wBAAsB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAkJtE"}

package/dist/src/command-line/commands/blocks.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * List all Kumo blocks available for CLI installation
+ * Usage: kumo blocks
+ */
+/**
+ * List all blocks grouped by category
+ */
+export declare function blocks(): void;
+//# sourceMappingURL=blocks.d.ts.map

package/dist/src/command-line/commands/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/blocks.ts"],"names":[],"mappings":";AACA;;;GAGG;AAsCH;;GAEG;AACH,wBAAgB,MAAM,IAAI,IAAI,CAmD7B"}

package/dist/src/command-line/commands/doc.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Get documentation for a specific Kumo component
+ * Usage: kumo doc <ComponentName>
+ */
+/**
+ * Output documentation for all components
+ */
+export declare function docs(): void;
+/**
+ * Get documentation for a specific component
+ */
+export declare function doc(componentName?: string): void;
+//# sourceMappingURL=doc.d.ts.map

package/dist/src/command-line/commands/doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/doc.ts"],"names":[],"mappings":";AACA;;;GAGG;AAoMH;;GAEG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAsB3B;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CA+BhD"}

package/dist/src/command-line/commands/init.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * Initialize kumo.json configuration file
+ * Usage: kumo init
+ */
+/**
+ * Prompt user for input
+ */
+export declare function prompt(question: string, defaultValue?: string): Promise<string>;
+/**
+ * Prompt user for yes/no confirmation
+ */
+export declare function confirm(question: string): Promise<boolean>;
+/**
+ * Initialize kumo.json configuration
+ */
+export declare function init(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/src/command-line/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/init.ts"],"names":[],"mappings":";AACA;;;GAGG;AAUH;;GAEG;AACH,wBAAsB,MAAM,CAC1B,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAajB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYhE;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAyC1C"}

package/dist/src/command-line/commands/ls.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * List all Kumo components
+ * Usage: kumo ls
+ */
+/**
+ * List all components grouped by category
+ */
+export declare function ls(): void;
+//# sourceMappingURL=ls.d.ts.map

package/dist/src/command-line/commands/ls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/ls.ts"],"names":[],"mappings":";AACA;;;GAGG;AAoCH;;GAEG;AACH,wBAAgB,EAAE,IAAI,IAAI,CAwCzB"}

package/dist/src/command-line/commands/migrate.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Kumo CLI migrate command
+ *
+ * For CONSUMERS: Exports the token rename map when Kumo releases breaking changes.
+ * The actual rename map is embedded at build time from the theme-generator config.
+ *
+ * For KUMO MAINTAINERS: Use `pnpm migrate:tokens` for the full migration workflow.
+ */
+export declare function migrate(args: string[]): void;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/src/command-line/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6GH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA2C5C"}

package/dist/src/command-line/utils/config.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Kumo CLI configuration utilities
+ * Handles reading and writing kumo.json config files
+ */
+/**
+ * Configuration schema for kumo.json
+ */
+export interface KumoConfig {
+    /**
+     * Directory where blocks will be installed (relative to project root)
+     * @default "src/components/kumo"
+     */
+    blocksDir: string;
+    /**
+     * Version of the config schema
+     * @default "1.0.0"
+     */
+    version?: string;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: Required<KumoConfig>;
+/**
+ * Read kumo.json from the specified directory
+ * @param projectRoot - Path to project root (defaults to cwd)
+ * @returns Parsed config or null if not found
+ */
+export declare function readConfig(projectRoot?: string): KumoConfig | null;
+/**
+ * Write kumo.json to the specified directory
+ * @param config - Configuration to write
+ * @param projectRoot - Path to project root (defaults to cwd)
+ */
+export declare function writeConfig(config: KumoConfig, projectRoot?: string): void;
+/**
+ * Check if kumo.json exists in the specified directory
+ * @param projectRoot - Path to project root (defaults to cwd)
+ * @returns true if kumo.json exists
+ */
+export declare function configExists(projectRoot?: string): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/command-line/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/command-line/utils/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,UAAU,CAG/C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,WAAW,GAAE,MAAsB,GAClC,UAAU,GAAG,IAAI,CAsBnB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,WAAW,GAAE,MAAsB,GAClC,IAAI,CAkBN;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAGzE"}

package/dist/src/command-line/utils/transformer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Import path transformer for Kumo blocks
+ * Transforms relative imports to package imports when installing blocks via CLI
+ */
+/**
+ * Transforms relative imports in block source code to package imports
+ *
+ * Examples:
+ * - `../../components/tabs` → `@cloudflare/kumo`
+ * - `../../utils/cn` → `@cloudflare/kumo`
+ * - Preserves type imports: `import { type Foo }` correctly
+ *
+ * @param content - The source code content to transform
+ * @returns Transformed source code with package imports
+ */
+export declare function transformImports(content: string): string;
+//# sourceMappingURL=transformer.d.ts.map

package/dist/src/command-line/utils/transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.d.ts","sourceRoot":"","sources":["../../../../src/command-line/utils/transformer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgExD"}