@frontmcp/ui 0.5.0 → 0.6.0

package/esm/renderers/types.d.ts.map

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

package/esm/renderers/utils/detect.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Template Type Detection Utilities
+ *
+ * Provides functions to detect whether a template is:
+ * - A React component (imported or inline)
+ * - A JSX string (needs runtime transpilation)
+ * - MDX content
+ * - Plain HTML
+ */
+/**
+ * Check if a value is a React component (FC or class).
+ *
+ * Detection heuristics:
+ * 1. Has $$typeof symbol (React.memo, React.forwardRef, etc.)
+ * 2. Has prototype.isReactComponent (class components)
+ * 3. Is a function with 0-1 parameters (function components)
+ *
+ * @param value - Value to check
+ * @returns True if it's a React component
+ *
+ * @example
+ * ```typescript
+ * const MyComponent = ({ output }) => <div>{output.name}</div>;
+ * isReactComponent(MyComponent); // true
+ *
+ * const htmlFn = (ctx) => `<div>${ctx.output.name}</div>`;
+ * isReactComponent(htmlFn); // false (returns string)
+ * ```
+ */
+export declare function isReactComponent(value: unknown): boolean;
+/**
+ * Check if a function is likely a template builder (returns string).
+ *
+ * This is a heuristic based on function characteristics.
+ *
+ * @param fn - Function to check
+ * @returns True if likely a template builder function
+ */
+export declare function isTemplateBuilderFunction(fn: Function): boolean;
+/**
+ * Check if a string contains JSX syntax.
+ *
+ * Looks for patterns like:
+ * - `<Component` - JSX component tags
+ * - `</Component>` - JSX closing tags
+ * - `<div className=` - JSX attributes
+ * - `return (` followed by JSX
+ *
+ * @param source - String to check
+ * @returns True if string contains JSX
+ *
+ * @example
+ * ```typescript
+ * containsJsx('<div>Hello</div>'); // false (just HTML)
+ * containsJsx('<MyComponent />'); // true (JSX component)
+ * containsJsx('function() { return <div /> }'); // true
+ * ```
+ */
+export declare function containsJsx(source: string): boolean;
+/**
+ * Check if a string contains MDX syntax.
+ *
+ * MDX is Markdown with JSX components. Patterns:
+ * - Frontmatter: `---\ntitle: ...\n---`
+ * - JSX components: `<Component />`
+ * - JSX attributes: `className`, `onClick`, `htmlFor`
+ * - JS expressions: `{variable}` or `{items.map(...)}`
+ * - Import/export statements
+ *
+ * @param source - String to check
+ * @returns True if string contains MDX syntax
+ *
+ * @example
+ * ```typescript
+ * containsMdxSyntax('# Title\n<Card />'); // true
+ * containsMdxSyntax('# Title\n{data.name}'); // true
+ * containsMdxSyntax('<div className="test">...'); // true (JSX attribute)
+ * containsMdxSyntax('# Title\nSome text'); // false (just Markdown)
+ * ```
+ */
+export declare function containsMdxSyntax(source: string): boolean;
+/**
+ * Check if a string is plain HTML (no JSX or MDX).
+ *
+ * @param source - String to check
+ * @returns True if string is plain HTML
+ */
+export declare function isPlainHtml(source: string): boolean;
+/**
+ * Detect the type of a template.
+ *
+ * Priority order:
+ * 1. React component (imported, already transpiled)
+ * 2. MDX string
+ * 3. JSX string (needs transpilation)
+ * 4. HTML template function
+ * 5. Static HTML string
+ *
+ * @param template - Template to analyze
+ * @returns Detected type and confidence
+ */
+export declare function detectTemplateType(template: unknown): {
+    type: 'react' | 'mdx' | 'jsx-string' | 'html-function' | 'html-string';
+    confidence: number;
+    reason: string;
+};
+//# sourceMappingURL=detect.d.ts.map

package/esm/renderers/utils/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../../src/renderers/utils/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAuCxD;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAa/D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAqCnD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAkCzD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,GAAG;IACrD,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,YAAY,GAAG,eAAe,GAAG,aAAa,CAAC;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,CA8DA"}

package/esm/renderers/utils/hash.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Hash Utilities for Renderer Caching
+ *
+ * Fast, non-cryptographic hashing for content-addressable cache keys.
+ */
+/**
+ * Generate a fast hash string from source content.
+ * Uses FNV-1a algorithm for good distribution and speed.
+ *
+ * @param source - String to hash
+ * @returns Base36 encoded hash string
+ *
+ * @example
+ * ```typescript
+ * const hash = hashString('function Component() { return <div>Hello</div> }');
+ * // Returns something like "1a2b3c4d"
+ * ```
+ */
+export declare function hashString(source: string): string;
+/**
+ * Generate a hash combining multiple values.
+ * Useful for creating cache keys from multiple inputs.
+ *
+ * @param values - Values to combine into a hash
+ * @returns Combined hash string
+ *
+ * @example
+ * ```typescript
+ * const key = hashCombined('template-source', { location: 'NYC' }, { temp: 72 });
+ * ```
+ */
+export declare function hashCombined(...values: unknown[]): string;
+/**
+ * Check if a string likely represents a hash (short alphanumeric).
+ *
+ * @param value - Value to check
+ * @returns True if it looks like a hash
+ */
+export declare function isHash(value: string): boolean;
+//# sourceMappingURL=hash.d.ts.map

package/esm/renderers/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../../src/renderers/utils/hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAezD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG7C"}

package/esm/renderers/utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Renderer Utilities
+ *
+ * Utility functions for template detection, hashing, and transpilation.
+ */
+export { isReactComponent, isTemplateBuilderFunction, containsJsx, containsMdxSyntax, isPlainHtml, detectTemplateType, } from './detect';
+export { hashString, hashCombined, isHash } from './hash';
+export { transpileJsx, isSwcAvailable, executeTranspiledCode, transpileAndExecute } from './transpiler';
+//# sourceMappingURL=index.d.ts.map

package/esm/renderers/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/renderers/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/esm/renderers/utils/transpiler.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Runtime JSX/TSX Transpiler
+ *
+ * Uses SWC to transpile JSX/TSX strings to executable JavaScript at runtime.
+ * This enables dynamic React templates without requiring a build step.
+ */
+import type { TranspileResult } from '../types';
+/**
+ * SWC transformation options for JSX.
+ */
+interface SwcTransformOptions {
+    /** Enable TypeScript syntax */
+    typescript?: boolean;
+    /** Enable JSX syntax */
+    jsx?: boolean;
+    /** JSX runtime mode ('automatic' for React 17+, 'classic' for older) */
+    jsxRuntime?: 'automatic' | 'classic';
+    /** Enable development mode (better error messages) */
+    development?: boolean;
+}
+/**
+ * Transpile a JSX/TSX string to executable JavaScript.
+ *
+ * Uses SWC with React 17+ automatic JSX runtime.
+ * Results are cached by content hash.
+ *
+ * @param source - JSX/TSX source code string
+ * @param options - Transpilation options
+ * @returns Transpiled result with code and caching metadata
+ *
+ * @example
+ * ```typescript
+ * const source = `
+ *   function Widget({ output }) {
+ *     return <div>{output.name}</div>;
+ *   }
+ * `;
+ *
+ * const result = await transpileJsx(source);
+ * console.log(result.code); // JavaScript code
+ * console.log(result.cached); // Whether from cache
+ * ```
+ */
+export declare function transpileJsx(source: string, options?: SwcTransformOptions): Promise<TranspileResult>;
+/**
+ * Check if SWC is available for runtime transpilation.
+ *
+ * @returns Promise resolving to true if SWC is available
+ */
+export declare function isSwcAvailable(): Promise<boolean>;
+/**
+ * Execute transpiled JavaScript code and extract the component.
+ *
+ * Creates a sandboxed environment with React available,
+ * executes the code, and returns the exported component.
+ *
+ * @param code - Transpiled JavaScript code
+ * @param context - Additional context to inject
+ * @returns The exported component or default export
+ *
+ * @example
+ * ```typescript
+ * const code = `
+ *   "use strict";
+ *   Object.defineProperty(exports, "__esModule", { value: true });
+ *   const jsx_runtime = require("react/jsx-runtime");
+ *   function Widget(props) {
+ *     return jsx_runtime.jsx("div", { children: props.output.name });
+ *   }
+ *   exports.default = Widget;
+ * `;
+ *
+ * const Component = await executeTranspiledCode(code);
+ * // Component is now a usable React component function
+ * ```
+ */
+export declare function executeTranspiledCode(code: string, context?: Record<string, any>): Promise<any>;
+/**
+ * Transpile and execute a JSX string, returning the component.
+ *
+ * Convenience function that combines transpileJsx and executeTranspiledCode.
+ *
+ * @param source - JSX/TSX source code
+ * @param context - Additional context for execution
+ * @returns The component function
+ */
+export declare function transpileAndExecute(source: string, context?: Record<string, any>): Promise<any>;
+export {};
+//# sourceMappingURL=transpiler.d.ts.map

package/esm/renderers/utils/transpiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transpiler.d.ts","sourceRoot":"","sources":["../../../../src/renderers/utils/transpiler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;GAEG;AACH,UAAU,mBAAmB;IAC3B,+BAA+B;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wBAAwB;IACxB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,wEAAwE;IACxE,UAAU,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACrC,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAyCD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwD9G;AAED;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAGvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EAEZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAEhC,OAAO,CAAC,GAAG,CAAC,CA+Cd;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EAEd,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAEhC,OAAO,CAAC,GAAG,CAAC,CAGd"}

package/esm/runtime/adapters/html.adapter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * HTML Renderer Adapter
+ *
+ * Client-side adapter for rendering HTML templates.
+ * Handles plain HTML and Handlebars-enhanced templates.
+ *
+ * @packageDocumentation
+ */
+import type { RendererAdapter, RenderContext, RenderOptions, RenderResult } from './types';
+import type { UIType } from '../../types/ui-runtime';
+/**
+ * HTML Renderer Adapter.
+ *
+ * Renders HTML templates to the DOM with support for:
+ * - Plain HTML strings
+ * - Handlebars-enhanced templates ({{...}} syntax)
+ * - Template builder functions
+ */
+export declare class HtmlRendererAdapter implements RendererAdapter {
+    readonly type: UIType;
+    private handlebarsRenderer;
+    /**
+     * Check if this adapter can handle the given content.
+     */
+    canHandle(content: string | unknown): boolean;
+    /**
+     * Render HTML content to a string.
+     */
+    render(content: string, context: RenderContext, _options?: RenderOptions): Promise<string>;
+    /**
+     * Render HTML content directly to the DOM.
+     */
+    renderToDOM(content: string, target: HTMLElement, context: RenderContext, _options?: RenderOptions): Promise<RenderResult>;
+    /**
+     * Update rendered content with new data.
+     */
+    update(target: HTMLElement, context: RenderContext): Promise<RenderResult>;
+    /**
+     * Clean up (no-op for HTML adapter).
+     */
+    destroy(_target: HTMLElement): void;
+    /**
+     * Check if content contains Handlebars syntax.
+     */
+    private containsHandlebars;
+    /**
+     * Render Handlebars template.
+     */
+    private renderHandlebars;
+}
+/**
+ * Create a new HTML renderer adapter.
+ */
+export declare function createHtmlAdapter(): HtmlRendererAdapter;
+/**
+ * Adapter loader for lazy loading.
+ */
+export declare function loadHtmlAdapter(): Promise<RendererAdapter>;
+//# sourceMappingURL=html.adapter.d.ts.map

package/esm/runtime/adapters/html.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.adapter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/html.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAU;IAG/B,OAAO,CAAC,kBAAkB,CAGV;IAEhB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO;IAK7C;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAUhG;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,YAAY,CAAC;IAqBxB;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAYhF;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAInC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;YACW,gBAAgB;CA4B/B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,mBAAmB,CAEvD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,CAEhE"}

package/esm/runtime/adapters/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Renderer Adapters
+ *
+ * Client-side adapters for rendering different UI types.
+ *
+ * @packageDocumentation
+ */
+export type { RendererAdapter, RenderContext, RenderOptions, RenderResult, AdapterLoader, AdapterRegistryEntry, } from './types';
+export { HtmlRendererAdapter, createHtmlAdapter, loadHtmlAdapter } from './html.adapter';
+export { ReactRendererAdapter, createReactAdapter, loadReactAdapter } from './react.adapter';
+export { MdxRendererAdapter, createMdxAdapter, loadMdxAdapter } from './mdx.adapter';
+import type { UIType } from '../../types/ui-runtime';
+import type { AdapterLoader, RendererAdapter } from './types';
+/**
+ * Registry of adapter loaders by UI type.
+ */
+export declare const adapterLoaders: Record<UIType, AdapterLoader | undefined>;
+/**
+ * Get an adapter loader for a UI type.
+ */
+export declare function getAdapterLoader(type: UIType): AdapterLoader | undefined;
+/**
+ * Load an adapter for a UI type.
+ */
+export declare function loadAdapter(type: UIType): Promise<RendererAdapter | null>;
+//# sourceMappingURL=index.d.ts.map

package/esm/runtime/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGzF,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAG7F,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGrF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAMpE,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAExE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAM/E"}

package/esm/runtime/adapters/mdx.adapter.d.ts

@@ -0,0 +1,73 @@
+/**
+ * MDX Renderer Adapter
+ *
+ * Client-side adapter for rendering MDX (Markdown + JSX) content.
+ * Builds on top of the React adapter for component rendering.
+ *
+ * @packageDocumentation
+ */
+import type { RendererAdapter, RenderContext, RenderOptions, RenderResult } from './types';
+import type { UIType } from '../../types/ui-runtime';
+/**
+ * MDX Renderer Adapter.
+ *
+ * Renders MDX content to the DOM with support for:
+ * - Pre-compiled MDX (recommended)
+ * - Runtime MDX compilation (if mdx-js available)
+ * - Custom component injection
+ */
+export declare class MdxRendererAdapter implements RendererAdapter {
+    readonly type: UIType;
+    private mdxRuntime;
+    private loadPromise;
+    /**
+     * Check if this adapter can handle the given content.
+     */
+    canHandle(content: string | unknown): boolean;
+    /**
+     * Render MDX content to a string.
+     */
+    render(content: string, context: RenderContext, _options?: RenderOptions): Promise<string>;
+    /**
+     * Render MDX content directly to the DOM.
+     */
+    renderToDOM(content: string, target: HTMLElement, context: RenderContext, _options?: RenderOptions): Promise<RenderResult>;
+    /**
+     * Hydrate existing SSR content.
+     * MDX hydration follows React patterns.
+     */
+    hydrate(target: HTMLElement, context: RenderContext, options?: RenderOptions): Promise<RenderResult>;
+    /**
+     * Update rendered MDX content with new data.
+     */
+    update(target: HTMLElement, context: RenderContext): Promise<RenderResult>;
+    /**
+     * Clean up (no-op for MDX adapter).
+     */
+    destroy(_target: HTMLElement): void;
+    /**
+     * Ensure MDX runtime is loaded.
+     */
+    private ensureMdxLoaded;
+    /**
+     * Load MDX runtime.
+     */
+    private loadMdx;
+    /**
+     * Compile MDX content.
+     */
+    private compileMdx;
+    /**
+     * Basic markdown rendering (fallback).
+     */
+    private renderMarkdown;
+}
+/**
+ * Create a new MDX renderer adapter.
+ */
+export declare function createMdxAdapter(): MdxRendererAdapter;
+/**
+ * Adapter loader for lazy loading.
+ */
+export declare function loadMdxAdapter(): Promise<RendererAdapter>;
+//# sourceMappingURL=mdx.adapter.d.ts.map

package/esm/runtime/adapters/mdx.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx.adapter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/mdx.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAYrD;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAS;IAG9B,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,WAAW,CAA8B;IAEjD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO;IAoB7C;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBhG;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,YAAY,CAAC;IAqBxB;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAW1G;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAShF;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAInC;;OAEG;YACW,eAAe;IAa7B;;OAEG;YACW,OAAO;IAgBrB;;OAEG;YACW,UAAU;IAqBxB;;OAEG;IACH,OAAO,CAAC,cAAc;CAqEvB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,CAErD;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,eAAe,CAAC,CAE/D"}

package/esm/runtime/adapters/react.adapter.d.ts

@@ -0,0 +1,70 @@
+/**
+ * React Renderer Adapter
+ *
+ * Client-side adapter for rendering React components.
+ * Handles hydration, client-side rendering, and updates.
+ *
+ * @packageDocumentation
+ */
+import type { RendererAdapter, RenderContext, RenderOptions, RenderResult } from './types';
+import type { UIType } from '../../types/ui-runtime';
+/**
+ * React Renderer Adapter.
+ *
+ * Renders React components to the DOM with support for:
+ * - Server-side rendering (SSR)
+ * - Client-side hydration
+ * - Dynamic updates when data changes
+ */
+export declare class ReactRendererAdapter implements RendererAdapter {
+    readonly type: UIType;
+    private react;
+    private reactDOM;
+    private loadPromise;
+    /**
+     * Check if this adapter can handle the given content.
+     */
+    canHandle(content: string | unknown): boolean;
+    /**
+     * Render React component to a string.
+     * This is a client-side fallback - SSR should be done at build time.
+     */
+    render(content: string, context: RenderContext, _options?: RenderOptions): Promise<string>;
+    /**
+     * Render React component directly to the DOM.
+     */
+    renderToDOM(content: string, target: HTMLElement, context: RenderContext, options?: RenderOptions): Promise<RenderResult>;
+    /**
+     * Hydrate existing SSR content with React.
+     */
+    hydrate(target: HTMLElement, context: RenderContext, options?: RenderOptions): Promise<RenderResult>;
+    /**
+     * Update rendered React component with new data.
+     */
+    update(target: HTMLElement, context: RenderContext): Promise<RenderResult>;
+    /**
+     * Clean up React root.
+     */
+    destroy(target: HTMLElement): void;
+    /**
+     * Ensure React is loaded.
+     */
+    private ensureReactLoaded;
+    /**
+     * Load React runtime.
+     */
+    private loadReact;
+    /**
+     * Get a React component by name or from content.
+     */
+    private getComponent;
+}
+/**
+ * Create a new React renderer adapter.
+ */
+export declare function createReactAdapter(): ReactRendererAdapter;
+/**
+ * Adapter loader for lazy loading.
+ */
+export declare function loadReactAdapter(): Promise<RendererAdapter>;
+//# sourceMappingURL=react.adapter.d.ts.map

package/esm/runtime/adapters/react.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.adapter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/react.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAsDrD;;;;;;;GAOG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAW;IAGhC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,WAAW,CAA8B;IAEjD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO;IAqB7C;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAMhG;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IA4DxB;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1G;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAsChF;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAQlC;;OAEG;YACW,iBAAiB;IAa/B;;OAEG;YACW,SAAS;IAmCvB;;OAEG;IACH,OAAO,CAAC,YAAY;CAsBrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,oBAAoB,CAEzD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,eAAe,CAAC,CAEjE"}

package/esm/runtime/adapters/types.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Renderer Adapter Types
+ *
+ * Defines the interface for renderer adapters that handle different
+ * UI types (HTML, React, MDX) at runtime.
+ *
+ * @packageDocumentation
+ */
+import type { UIType } from '../../types/ui-runtime';
+/**
+ * Context passed to renderer adapters.
+ */
+export interface RenderContext {
+    /** Tool input arguments */
+    input: Record<string, unknown>;
+    /** Tool output/result */
+    output: unknown;
+    /** Structured content (if schema provided) */
+    structuredContent?: unknown;
+    /** Tool name */
+    toolName: string;
+}
+/**
+ * Options for rendering.
+ */
+export interface RenderOptions {
+    /** Target element to render into */
+    target?: HTMLElement;
+    /** Whether to hydrate existing SSR content */
+    hydrate?: boolean;
+    /** Manifest data from the page */
+    manifest?: Record<string, unknown>;
+}
+/**
+ * Result of a render operation.
+ */
+export interface RenderResult {
+    /** Whether rendering was successful */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** The rendered HTML (for SSR) */
+    html?: string;
+}
+/**
+ * Renderer adapter interface.
+ *
+ * Each adapter handles a specific UI type and provides methods
+ * for rendering templates to the DOM.
+ */
+export interface RendererAdapter {
+    /** The UI type this adapter handles */
+    readonly type: UIType;
+    /**
+     * Check if this adapter can handle the given content.
+     */
+    canHandle(content: string | unknown): boolean;
+    /**
+     * Render content to an HTML string.
+     * Used for SSR and initial page generation.
+     */
+    render(content: string, context: RenderContext, options?: RenderOptions): Promise<string>;
+    /**
+     * Render content directly to the DOM.
+     * Used for client-side rendering.
+     */
+    renderToDOM?(content: string, target: HTMLElement, context: RenderContext, options?: RenderOptions): Promise<RenderResult>;
+    /**
+     * Hydrate existing SSR content with interactivity.
+     * Used for React/MDX components that were server-rendered.
+     */
+    hydrate?(target: HTMLElement, context: RenderContext, options?: RenderOptions): Promise<RenderResult>;
+    /**
+     * Update the rendered content with new data.
+     * Used when tool output changes at runtime.
+     */
+    update?(target: HTMLElement, context: RenderContext): Promise<RenderResult>;
+    /**
+     * Clean up any resources (event listeners, etc.).
+     */
+    destroy?(target: HTMLElement): void;
+}
+/**
+ * Lazy loader function for adapters.
+ */
+export type AdapterLoader = () => Promise<RendererAdapter>;
+/**
+ * Adapter registry entry.
+ */
+export interface AdapterRegistryEntry {
+    type: UIType;
+    loader: AdapterLoader;
+    instance?: RendererAdapter;
+}
+//# sourceMappingURL=types.d.ts.map

package/esm/runtime/adapters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/runtime/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,yBAAyB;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAE9C;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1F;;;OAGG;IACH,WAAW,CAAC,CACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;OAGG;IACH,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEtG;;;OAGG;IACH,MAAM,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE5E;;OAEG;IACH,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B"}