@frontmcp/ui 0.5.0 → 0.6.0

package/src/renderers/react.renderer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"react.renderer.js","sourceRoot":"","sources":["../../../src/renderers/react.renderer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * React Renderer\n *\n * Handles React component templates:\n * - Imported React components (already transpiled)\n * - JSX string templates (transpiled at runtime with SWC)\n *\n * Uses react-dom/server for SSR to HTML.\n */\n\nimport type { TemplateContext } from '../runtime/types';\nimport type { PlatformCapabilities } from '../theme';\nimport type {\n  UIRenderer,\n  TranspileResult,\n  TranspileOptions,\n  RenderOptions,\n  RuntimeScripts,\n  ToolUIProps,\n} from './types';\nimport { isReactComponent, containsJsx } from './utils/detect';\nimport { hashString } from './utils/hash';\nimport { transpileJsx, executeTranspiledCode } from './utils/transpiler';\nimport { transpileCache } from './cache';\n\n/**\n * Types this renderer can handle.\n */\ntype ReactTemplate<In = unknown, Out = unknown> =\n  | ((props: ToolUIProps<In, Out>) => unknown) // React component function\n  | string; // JSX string to transpile\n\n/**\n * React runtime CDN URLs.\n * Using esm.sh for React 19 (ES modules).\n */\nconst REACT_CDN = {\n  react: 'https://esm.sh/react@19',\n  reactDom: 'https://esm.sh/react-dom@19/client',\n};\n\n/**\n * Minimal inline React runtime for blocked-network platforms (Claude).\n * This is a placeholder - in production, we'd bundle a minified React.\n */\nconst INLINE_REACT_PLACEHOLDER = `\n// React runtime not available inline yet.\n// For blocked-network platforms, use pre-rendered HTML templates.\nconsole.warn('[FrontMCP] React hydration not available on this platform.');\n`;\n\n/**\n * React Renderer Implementation.\n *\n * Handles:\n * - Imported React components (FC or class)\n * - JSX string templates (transpiled with SWC at runtime)\n *\n * Renders to HTML using react-dom/server's renderToString.\n *\n * @example Imported component\n * ```typescript\n * import { MyWidget } from './my-widget.tsx';\n *\n * @Tool({\n *   ui: { template: MyWidget }\n * })\n * ```\n *\n * @example JSX string (runtime transpilation)\n * ```typescript\n * @Tool({\n *   ui: {\n *     template: `\n *       function Widget({ output }) {\n *         return <div>{output.name}</div>;\n *       }\n *     `\n *   }\n * })\n * ```\n */\nexport class ReactRenderer implements UIRenderer<ReactTemplate> {\n  readonly type = 'react' as const;\n  readonly priority = 20; // Higher priority than HTML\n\n  /**\n   * Lazy-loaded React modules.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private React: any = null;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private ReactDOMServer: any = null;\n\n  /**\n   * Check if this renderer can handle the given template.\n   *\n   * Accepts:\n   * - React component functions (imported, already transpiled)\n   * - Strings containing JSX syntax\n   */\n  canHandle(template: unknown): template is ReactTemplate {\n    // React component function\n    if (typeof template === 'function' && isReactComponent(template)) {\n      return true;\n    }\n\n    // JSX string\n    if (typeof template === 'string' && containsJsx(template)) {\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Transpile the template if needed.\n   *\n   * For imported React components, no transpilation is needed.\n   * For JSX strings, SWC transpilation is performed.\n   */\n  async transpile(template: ReactTemplate, options?: TranspileOptions): Promise<TranspileResult> {\n    // Imported component - no transpilation needed\n    if (typeof template === 'function') {\n      const hash = hashString(template.toString());\n\n      return {\n        code: '', // No transpiled code for already-compiled components\n        hash,\n        cached: true,\n      };\n    }\n\n    // JSX string - transpile with SWC\n    if (typeof template === 'string') {\n      return transpileJsx(template, {\n        development: options?.sourceMaps ?? false,\n      });\n    }\n\n    throw new Error('Invalid template type for ReactRenderer');\n  }\n\n  /**\n   * Render the template to HTML string using react-dom/server.\n   */\n  async render<In, Out>(\n    template: ReactTemplate<In, Out>,\n    context: TemplateContext<In, Out>,\n    options?: RenderOptions,\n  ): Promise<string> {\n    // Ensure React is loaded\n    await this.loadReact();\n\n    // Get the component function\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    let Component: (props: ToolUIProps<In, Out>) => any;\n\n    if (typeof template === 'function') {\n      // Already a component function\n      Component = template;\n    } else if (typeof template === 'string') {\n      // Transpile and execute the JSX string\n      const transpiled = await this.transpile(template);\n\n      // Check cache for the executed component\n      const cached = transpileCache.getByKey(`exec:${transpiled.hash}`);\n      if (cached) {\n        Component = cached.code as unknown as typeof Component;\n      } else {\n        // Execute the transpiled code to get the component\n        Component = await executeTranspiledCode(transpiled.code, {\n          // Provide any additional MDX components if specified\n          ...options?.mdxComponents,\n        });\n\n        // Cache the component function\n        transpileCache.setByKey(`exec:${transpiled.hash}`, {\n          code: Component as unknown as string,\n          hash: transpiled.hash,\n          cached: false,\n        });\n      }\n    } else {\n      throw new Error('Invalid template type for ReactRenderer');\n    }\n\n    // Build props from context\n    const props: ToolUIProps<In, Out> = {\n      input: context.input,\n      output: context.output,\n      structuredContent: context.structuredContent,\n      helpers: context.helpers,\n    };\n\n    // Create React element\n    const element = this.React.createElement(Component, props);\n\n    // Render to HTML string\n    const html = this.ReactDOMServer.renderToString(element);\n\n    // If hydration is enabled, wrap with hydration markers\n    if (options?.hydrate) {\n      const componentName = (Component as { name?: string }).name || 'Component';\n      // Full HTML attribute escaping to prevent XSS\n      const escapedProps = JSON.stringify(props)\n        .replace(/&/g, '&amp;')\n        .replace(/'/g, '&#39;')\n        .replace(/</g, '&lt;')\n        .replace(/>/g, '&gt;');\n      return `<div data-hydrate=\"${componentName}\" data-props='${escapedProps}'>${html}</div>`;\n    }\n\n    return html;\n  }\n\n  /**\n   * Get runtime scripts for client-side functionality.\n   */\n  getRuntimeScripts(platform: PlatformCapabilities): RuntimeScripts {\n    // For blocked-network platforms (Claude), scripts must be inline\n    if (platform.networkMode === 'blocked') {\n      return {\n        headScripts: '',\n        inlineScripts: INLINE_REACT_PLACEHOLDER,\n        isInline: true,\n      };\n    }\n\n    // For platforms with network access, use CDN\n    return {\n      headScripts: `\n        <script crossorigin src=\"${REACT_CDN.react}\"></script>\n        <script crossorigin src=\"${REACT_CDN.reactDom}\"></script>\n      `,\n      isInline: false,\n    };\n  }\n\n  /**\n   * Load React and ReactDOMServer modules.\n   */\n  private async loadReact(): Promise<void> {\n    if (this.React && this.ReactDOMServer) {\n      return;\n    }\n\n    try {\n      this.React = await import('react');\n      this.ReactDOMServer = await import('react-dom/server');\n    } catch {\n      throw new Error('React is required for ReactRenderer. Install react and react-dom: npm install react react-dom');\n    }\n  }\n}\n\n/**\n * Singleton instance of the React renderer.\n */\nexport const reactRenderer = new ReactRenderer();\n\n/**\n * Build React hydration script for client-side interactivity.\n *\n * This script finds elements with data-hydrate attributes and\n * hydrates them with the corresponding React component.\n */\nexport function buildHydrationScript(): string {\n  return `\n<script>\n(function() {\n  // Wait for React to be available\n  if (typeof React === 'undefined' || typeof ReactDOM === 'undefined') {\n    console.warn('[FrontMCP] React not available for hydration');\n    return;\n  }\n\n  // Find all elements marked for hydration\n  document.querySelectorAll('[data-hydrate]').forEach(function(root) {\n    var componentName = root.getAttribute('data-hydrate');\n    var propsJson = root.getAttribute('data-props');\n    var props = propsJson ? JSON.parse(propsJson) : {};\n\n    // Look for the component in the global scope\n    if (window.__frontmcp_components && window.__frontmcp_components[componentName]) {\n      try {\n        ReactDOM.hydrateRoot(root, React.createElement(\n          window.__frontmcp_components[componentName],\n          props\n        ));\n      } catch (e) {\n        console.error('[FrontMCP] Hydration failed for', componentName, e);\n      }\n    }\n  });\n})();\n</script>\n`;\n}\n"]}

package/src/renderers/registry.d.ts

@@ -1,133 +0,0 @@
-/**
- * Renderer Registry
- *
- * Global registry for template renderers with auto-detection.
- * Manages registration, detection, and rendering of templates.
- */
-import type { TemplateContext } from '../runtime/types';
-import type { UIRenderer, RendererType, RendererRegistryOptions, DetectionResult, RenderResult, RenderOptions } from './types';
-/**
- * Renderer Registry.
- *
- * Manages a collection of renderers and provides:
- * - Registration of custom renderers
- * - Auto-detection of template types
- * - Unified rendering interface
- *
- * @example
- * ```typescript
- * // Register a custom renderer
- * registry.register(myCustomRenderer);
- *
- * // Auto-detect and render
- * const result = await registry.render(template, context);
- * ```
- */
-export declare class RendererRegistry {
-    private renderers;
-    private sortedRenderers;
-    private defaultRenderer;
-    private debug;
-    constructor(options?: RendererRegistryOptions);
-    /**
-     * Register a renderer.
-     *
-     * Renderers are sorted by priority (highest first) for detection.
-     *
-     * @param renderer - Renderer to register
-     */
-    register(renderer: UIRenderer): void;
-    /**
-     * Unregister a renderer.
-     *
-     * @param type - Type of renderer to remove
-     * @returns True if renderer was removed
-     */
-    unregister(type: RendererType): boolean;
-    /**
-     * Get a renderer by type.
-     *
-     * @param type - Renderer type
-     * @returns Renderer or undefined if not found
-     */
-    get(type: RendererType): UIRenderer | undefined;
-    /**
-     * Check if a renderer type is registered.
-     *
-     * @param type - Renderer type
-     * @returns True if registered
-     */
-    has(type: RendererType): boolean;
-    /**
-     * Get all registered renderer types.
-     *
-     * @returns Array of renderer types
-     */
-    getTypes(): RendererType[];
-    /**
-     * Auto-detect the renderer for a template.
-     *
-     * Checks renderers in priority order (highest first).
-     * Returns HTML renderer as fallback.
-     *
-     * @param template - Template to detect
-     * @returns Detection result with renderer and confidence
-     */
-    detect(template: unknown): DetectionResult;
-    /**
-     * Render a template with auto-detection.
-     *
-     * @param template - Template to render (React, MDX, or HTML)
-     * @param context - Template context with input/output
-     * @param options - Render options
-     * @returns Rendered result with HTML and metadata
-     */
-    render<In, Out>(template: unknown, context: TemplateContext<In, Out>, options?: RenderOptions): Promise<RenderResult>;
-    /**
-     * Render with a specific renderer type.
-     *
-     * @param type - Renderer type to use
-     * @param template - Template to render
-     * @param context - Template context
-     * @param options - Render options
-     * @returns Rendered result
-     */
-    renderWith<In, Out>(type: RendererType, template: unknown, context: TemplateContext<In, Out>, options?: RenderOptions): Promise<RenderResult>;
-    /**
-     * Update the sorted renderer list by priority.
-     */
-    private updateSortedList;
-    /**
-     * Set the default renderer type.
-     *
-     * @param type - Renderer type to use as default
-     */
-    setDefault(type: RendererType): void;
-    /**
-     * Get registry statistics.
-     */
-    getStats(): {
-        registeredRenderers: RendererType[];
-        defaultRenderer: RendererType;
-        priorityOrder: Array<{
-            type: RendererType;
-            priority: number;
-        }>;
-    };
-}
-/**
- * Global renderer registry instance.
- *
- * Pre-configured with the HTML renderer.
- * React and MDX renderers can be added:
- *
- * ```typescript
- * import { rendererRegistry } from '@frontmcp/ui';
- * import { reactRenderer } from '@frontmcp/ui';
- * import { mdxRenderer } from '@frontmcp/ui';
- *
- * rendererRegistry.register(reactRenderer);
- * rendererRegistry.register(mdxRenderer);
- * ```
- */
-export declare const rendererRegistry: RendererRegistry;

package/src/renderers/registry.js

@@ -1,232 +0,0 @@
-"use strict";
-/**
- * Renderer Registry
- *
- * Global registry for template renderers with auto-detection.
- * Manages registration, detection, and rendering of templates.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.rendererRegistry = exports.RendererRegistry = void 0;
-const theme_1 = require("../theme");
-const html_renderer_1 = require("./html.renderer");
-/**
- * Renderer Registry.
- *
- * Manages a collection of renderers and provides:
- * - Registration of custom renderers
- * - Auto-detection of template types
- * - Unified rendering interface
- *
- * @example
- * ```typescript
- * // Register a custom renderer
- * registry.register(myCustomRenderer);
- *
- * // Auto-detect and render
- * const result = await registry.render(template, context);
- * ```
- */
-class RendererRegistry {
-    renderers = new Map();
-    sortedRenderers = [];
-    defaultRenderer = 'html';
-    debug;
-    constructor(options = {}) {
-        this.debug = options.debug ?? false;
-        // Register built-in HTML renderer
-        this.register(html_renderer_1.htmlRenderer);
-    }
-    /**
-     * Register a renderer.
-     *
-     * Renderers are sorted by priority (highest first) for detection.
-     *
-     * @param renderer - Renderer to register
-     */
-    register(renderer) {
-        this.renderers.set(renderer.type, renderer);
-        this.updateSortedList();
-        if (this.debug) {
-            console.log(`[RendererRegistry] Registered renderer: ${renderer.type} (priority: ${renderer.priority})`);
-        }
-    }
-    /**
-     * Unregister a renderer.
-     *
-     * @param type - Type of renderer to remove
-     * @returns True if renderer was removed
-     */
-    unregister(type) {
-        const removed = this.renderers.delete(type);
-        if (removed) {
-            this.updateSortedList();
-        }
-        return removed;
-    }
-    /**
-     * Get a renderer by type.
-     *
-     * @param type - Renderer type
-     * @returns Renderer or undefined if not found
-     */
-    get(type) {
-        return this.renderers.get(type);
-    }
-    /**
-     * Check if a renderer type is registered.
-     *
-     * @param type - Renderer type
-     * @returns True if registered
-     */
-    has(type) {
-        return this.renderers.has(type);
-    }
-    /**
-     * Get all registered renderer types.
-     *
-     * @returns Array of renderer types
-     */
-    getTypes() {
-        return Array.from(this.renderers.keys());
-    }
-    /**
-     * Auto-detect the renderer for a template.
-     *
-     * Checks renderers in priority order (highest first).
-     * Returns HTML renderer as fallback.
-     *
-     * @param template - Template to detect
-     * @returns Detection result with renderer and confidence
-     */
-    detect(template) {
-        // Check each renderer in priority order
-        for (const renderer of this.sortedRenderers) {
-            if (renderer.canHandle(template)) {
-                const result = {
-                    renderer,
-                    confidence: renderer.priority / 100, // Normalize to 0-1
-                    reason: `Matched by ${renderer.type} renderer`,
-                };
-                if (this.debug) {
-                    console.log(`[RendererRegistry] Detected template as ${renderer.type} (confidence: ${result.confidence})`);
-                }
-                return result;
-            }
-        }
-        // Fallback to HTML renderer (should always match strings/functions)
-        const fallback = this.renderers.get(this.defaultRenderer);
-        if (!fallback) {
-            throw new Error(`Default renderer '${this.defaultRenderer}' not found`);
-        }
-        return {
-            renderer: fallback,
-            confidence: 0.5,
-            reason: 'Fallback to default HTML renderer',
-        };
-    }
-    /**
-     * Render a template with auto-detection.
-     *
-     * @param template - Template to render (React, MDX, or HTML)
-     * @param context - Template context with input/output
-     * @param options - Render options
-     * @returns Rendered result with HTML and metadata
-     */
-    async render(template, context, options = {}) {
-        const platform = options.platform ?? theme_1.OPENAI_PLATFORM;
-        // Detect renderer
-        const detection = this.detect(template);
-        const renderer = detection.renderer;
-        if (this.debug) {
-            console.log(`[RendererRegistry] Rendering with ${renderer.type} renderer`);
-        }
-        // Transpile if needed
-        const transpileResult = await renderer.transpile(template);
-        // Render to HTML
-        const html = await renderer.render(template, context, options);
-        // Get runtime scripts
-        const runtimeScripts = renderer.getRuntimeScripts(platform);
-        return {
-            html,
-            rendererType: renderer.type,
-            transpileCached: transpileResult.cached,
-            runtimeScripts,
-        };
-    }
-    /**
-     * Render with a specific renderer type.
-     *
-     * @param type - Renderer type to use
-     * @param template - Template to render
-     * @param context - Template context
-     * @param options - Render options
-     * @returns Rendered result
-     */
-    async renderWith(type, template, context, options = {}) {
-        const renderer = this.renderers.get(type);
-        if (!renderer) {
-            throw new Error(`Renderer '${type}' not registered`);
-        }
-        const platform = options.platform ?? theme_1.OPENAI_PLATFORM;
-        // Transpile
-        const transpileResult = await renderer.transpile(template);
-        // Render
-        const html = await renderer.render(template, context, options);
-        // Runtime scripts
-        const runtimeScripts = renderer.getRuntimeScripts(platform);
-        return {
-            html,
-            rendererType: type,
-            transpileCached: transpileResult.cached,
-            runtimeScripts,
-        };
-    }
-    /**
-     * Update the sorted renderer list by priority.
-     */
-    updateSortedList() {
-        this.sortedRenderers = Array.from(this.renderers.values()).sort((a, b) => b.priority - a.priority);
-    }
-    /**
-     * Set the default renderer type.
-     *
-     * @param type - Renderer type to use as default
-     */
-    setDefault(type) {
-        if (!this.renderers.has(type)) {
-            throw new Error(`Cannot set default to unregistered renderer '${type}'`);
-        }
-        this.defaultRenderer = type;
-    }
-    /**
-     * Get registry statistics.
-     */
-    getStats() {
-        return {
-            registeredRenderers: this.getTypes(),
-            defaultRenderer: this.defaultRenderer,
-            priorityOrder: this.sortedRenderers.map((r) => ({
-                type: r.type,
-                priority: r.priority,
-            })),
-        };
-    }
-}
-exports.RendererRegistry = RendererRegistry;
-/**
- * Global renderer registry instance.
- *
- * Pre-configured with the HTML renderer.
- * React and MDX renderers can be added:
- *
- * ```typescript
- * import { rendererRegistry } from '@frontmcp/ui';
- * import { reactRenderer } from '@frontmcp/ui';
- * import { mdxRenderer } from '@frontmcp/ui';
- *
- * rendererRegistry.register(reactRenderer);
- * rendererRegistry.register(mdxRenderer);
- * ```
- */
-exports.rendererRegistry = new RendererRegistry();
-//# sourceMappingURL=registry.js.map

package/src/renderers/registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/renderers/registry.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH,oCAA2C;AAS3C,mDAA+C;AAE/C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,gBAAgB;IACnB,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;IAChD,eAAe,GAAiB,EAAE,CAAC;IACnC,eAAe,GAAiB,MAAM,CAAC;IACvC,KAAK,CAAU;IAEvB,YAAY,UAAmC,EAAE;QAC/C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QAEpC,kCAAkC;QAClC,IAAI,CAAC,QAAQ,CAAC,4BAAY,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,QAAoB;QAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAExB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,2CAA2C,QAAQ,CAAC,IAAI,eAAe,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC3G,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAkB;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAkB;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAkB;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAiB;QACtB,wCAAwC;QACxC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,IAAI,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,MAAM,MAAM,GAAoB;oBAC9B,QAAQ;oBACR,UAAU,EAAE,QAAQ,CAAC,QAAQ,GAAG,GAAG,EAAE,mBAAmB;oBACxD,MAAM,EAAE,cAAc,QAAQ,CAAC,IAAI,WAAW;iBAC/C,CAAC;gBAEF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,GAAG,CAAC,2CAA2C,QAAQ,CAAC,IAAI,iBAAiB,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC;gBAC7G,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,oEAAoE;QACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,eAAe,aAAa,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,mCAAmC;SAC5C,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,QAAiB,EACjB,OAAiC,EACjC,UAAyB,EAAE;QAE3B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,uBAAe,CAAC;QAErD,kBAAkB;QAClB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QAEpC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,qCAAqC,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC;QAC7E,CAAC;QAED,sBAAsB;QACtB,MAAM,eAAe,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE3D,iBAAiB;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE/D,sBAAsB;QACtB,MAAM,cAAc,GAAG,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAE5D,OAAO;YACL,IAAI;YACJ,YAAY,EAAE,QAAQ,CAAC,IAAI;YAC3B,eAAe,EAAE,eAAe,CAAC,MAAM;YACvC,cAAc;SACf,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU,CACd,IAAkB,EAClB,QAAiB,EACjB,OAAiC,EACjC,UAAyB,EAAE;QAE3B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,kBAAkB,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,uBAAe,CAAC;QAErD,YAAY;QACZ,MAAM,eAAe,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE3D,SAAS;QACT,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE/D,kBAAkB;QAClB,MAAM,cAAc,GAAG,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAE5D,OAAO;YACL,IAAI;YACJ,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,eAAe,CAAC,MAAM;YACvC,cAAc;SACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrG,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,IAAkB;QAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,gDAAgD,IAAI,GAAG,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,QAAQ;QAKN,OAAO;YACL,mBAAmB,EAAE,IAAI,CAAC,QAAQ,EAAE;YACpC,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,aAAa,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9C,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;aACrB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;CACF;AAnOD,4CAmOC;AAED;;;;;;;;;;;;;;GAcG;AACU,QAAA,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC","sourcesContent":["/**\n * Renderer Registry\n *\n * Global registry for template renderers with auto-detection.\n * Manages registration, detection, and rendering of templates.\n */\n\nimport type { TemplateContext } from '../runtime/types';\nimport type { PlatformCapabilities } from '../theme';\nimport { OPENAI_PLATFORM } from '../theme';\nimport type {\n  UIRenderer,\n  RendererType,\n  RendererRegistryOptions,\n  DetectionResult,\n  RenderResult,\n  RenderOptions,\n} from './types';\nimport { htmlRenderer } from './html.renderer';\n\n/**\n * Renderer Registry.\n *\n * Manages a collection of renderers and provides:\n * - Registration of custom renderers\n * - Auto-detection of template types\n * - Unified rendering interface\n *\n * @example\n * ```typescript\n * // Register a custom renderer\n * registry.register(myCustomRenderer);\n *\n * // Auto-detect and render\n * const result = await registry.render(template, context);\n * ```\n */\nexport class RendererRegistry {\n  private renderers = new Map<RendererType, UIRenderer>();\n  private sortedRenderers: UIRenderer[] = [];\n  private defaultRenderer: RendererType = 'html';\n  private debug: boolean;\n\n  constructor(options: RendererRegistryOptions = {}) {\n    this.debug = options.debug ?? false;\n\n    // Register built-in HTML renderer\n    this.register(htmlRenderer);\n  }\n\n  /**\n   * Register a renderer.\n   *\n   * Renderers are sorted by priority (highest first) for detection.\n   *\n   * @param renderer - Renderer to register\n   */\n  register(renderer: UIRenderer): void {\n    this.renderers.set(renderer.type, renderer);\n    this.updateSortedList();\n\n    if (this.debug) {\n      console.log(`[RendererRegistry] Registered renderer: ${renderer.type} (priority: ${renderer.priority})`);\n    }\n  }\n\n  /**\n   * Unregister a renderer.\n   *\n   * @param type - Type of renderer to remove\n   * @returns True if renderer was removed\n   */\n  unregister(type: RendererType): boolean {\n    const removed = this.renderers.delete(type);\n    if (removed) {\n      this.updateSortedList();\n    }\n    return removed;\n  }\n\n  /**\n   * Get a renderer by type.\n   *\n   * @param type - Renderer type\n   * @returns Renderer or undefined if not found\n   */\n  get(type: RendererType): UIRenderer | undefined {\n    return this.renderers.get(type);\n  }\n\n  /**\n   * Check if a renderer type is registered.\n   *\n   * @param type - Renderer type\n   * @returns True if registered\n   */\n  has(type: RendererType): boolean {\n    return this.renderers.has(type);\n  }\n\n  /**\n   * Get all registered renderer types.\n   *\n   * @returns Array of renderer types\n   */\n  getTypes(): RendererType[] {\n    return Array.from(this.renderers.keys());\n  }\n\n  /**\n   * Auto-detect the renderer for a template.\n   *\n   * Checks renderers in priority order (highest first).\n   * Returns HTML renderer as fallback.\n   *\n   * @param template - Template to detect\n   * @returns Detection result with renderer and confidence\n   */\n  detect(template: unknown): DetectionResult {\n    // Check each renderer in priority order\n    for (const renderer of this.sortedRenderers) {\n      if (renderer.canHandle(template)) {\n        const result: DetectionResult = {\n          renderer,\n          confidence: renderer.priority / 100, // Normalize to 0-1\n          reason: `Matched by ${renderer.type} renderer`,\n        };\n\n        if (this.debug) {\n          console.log(`[RendererRegistry] Detected template as ${renderer.type} (confidence: ${result.confidence})`);\n        }\n\n        return result;\n      }\n    }\n\n    // Fallback to HTML renderer (should always match strings/functions)\n    const fallback = this.renderers.get(this.defaultRenderer);\n    if (!fallback) {\n      throw new Error(`Default renderer '${this.defaultRenderer}' not found`);\n    }\n\n    return {\n      renderer: fallback,\n      confidence: 0.5,\n      reason: 'Fallback to default HTML renderer',\n    };\n  }\n\n  /**\n   * Render a template with auto-detection.\n   *\n   * @param template - Template to render (React, MDX, or HTML)\n   * @param context - Template context with input/output\n   * @param options - Render options\n   * @returns Rendered result with HTML and metadata\n   */\n  async render<In, Out>(\n    template: unknown,\n    context: TemplateContext<In, Out>,\n    options: RenderOptions = {},\n  ): Promise<RenderResult> {\n    const platform = options.platform ?? OPENAI_PLATFORM;\n\n    // Detect renderer\n    const detection = this.detect(template);\n    const renderer = detection.renderer;\n\n    if (this.debug) {\n      console.log(`[RendererRegistry] Rendering with ${renderer.type} renderer`);\n    }\n\n    // Transpile if needed\n    const transpileResult = await renderer.transpile(template);\n\n    // Render to HTML\n    const html = await renderer.render(template, context, options);\n\n    // Get runtime scripts\n    const runtimeScripts = renderer.getRuntimeScripts(platform);\n\n    return {\n      html,\n      rendererType: renderer.type,\n      transpileCached: transpileResult.cached,\n      runtimeScripts,\n    };\n  }\n\n  /**\n   * Render with a specific renderer type.\n   *\n   * @param type - Renderer type to use\n   * @param template - Template to render\n   * @param context - Template context\n   * @param options - Render options\n   * @returns Rendered result\n   */\n  async renderWith<In, Out>(\n    type: RendererType,\n    template: unknown,\n    context: TemplateContext<In, Out>,\n    options: RenderOptions = {},\n  ): Promise<RenderResult> {\n    const renderer = this.renderers.get(type);\n    if (!renderer) {\n      throw new Error(`Renderer '${type}' not registered`);\n    }\n\n    const platform = options.platform ?? OPENAI_PLATFORM;\n\n    // Transpile\n    const transpileResult = await renderer.transpile(template);\n\n    // Render\n    const html = await renderer.render(template, context, options);\n\n    // Runtime scripts\n    const runtimeScripts = renderer.getRuntimeScripts(platform);\n\n    return {\n      html,\n      rendererType: type,\n      transpileCached: transpileResult.cached,\n      runtimeScripts,\n    };\n  }\n\n  /**\n   * Update the sorted renderer list by priority.\n   */\n  private updateSortedList(): void {\n    this.sortedRenderers = Array.from(this.renderers.values()).sort((a, b) => b.priority - a.priority);\n  }\n\n  /**\n   * Set the default renderer type.\n   *\n   * @param type - Renderer type to use as default\n   */\n  setDefault(type: RendererType): void {\n    if (!this.renderers.has(type)) {\n      throw new Error(`Cannot set default to unregistered renderer '${type}'`);\n    }\n    this.defaultRenderer = type;\n  }\n\n  /**\n   * Get registry statistics.\n   */\n  getStats(): {\n    registeredRenderers: RendererType[];\n    defaultRenderer: RendererType;\n    priorityOrder: Array<{ type: RendererType; priority: number }>;\n  } {\n    return {\n      registeredRenderers: this.getTypes(),\n      defaultRenderer: this.defaultRenderer,\n      priorityOrder: this.sortedRenderers.map((r) => ({\n        type: r.type,\n        priority: r.priority,\n      })),\n    };\n  }\n}\n\n/**\n * Global renderer registry instance.\n *\n * Pre-configured with the HTML renderer.\n * React and MDX renderers can be added:\n *\n * ```typescript\n * import { rendererRegistry } from '@frontmcp/ui';\n * import { reactRenderer } from '@frontmcp/ui';\n * import { mdxRenderer } from '@frontmcp/ui';\n *\n * rendererRegistry.register(reactRenderer);\n * rendererRegistry.register(mdxRenderer);\n * ```\n */\nexport const rendererRegistry = new RendererRegistry();\n"]}