@frontmcp/ui 0.5.0 → 0.6.0

package/src/renderers/utils/transpiler.js

@@ -1,215 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.transpileJsx = transpileJsx;
-exports.isSwcAvailable = isSwcAvailable;
-exports.executeTranspiledCode = executeTranspiledCode;
-exports.transpileAndExecute = transpileAndExecute;
-const cache_1 = require("../cache");
-const hash_1 = require("./hash");
-/**
- * Default SWC options for React JSX transpilation.
- */
-const DEFAULT_SWC_OPTIONS = {
-    typescript: true,
-    jsx: true,
-    jsxRuntime: 'automatic',
-    development: false,
-};
-/**
- * Lazy-loaded SWC transform function.
- * We load @swc/core dynamically to avoid requiring it at startup.
- */
-let swcTransform = null;
-/**
- * Load the SWC transform function.
- * Returns null if @swc/core is not available.
- */
-async function loadSwcTransform() {
-    if (swcTransform !== null) {
-        return swcTransform;
-    }
-    try {
-        // Dynamic import to avoid requiring @swc/core at startup
-        const swc = await import('@swc/core');
-        swcTransform = swc.transform;
-        return swcTransform;
-    }
-    catch {
-        console.warn('[@frontmcp/ui] @swc/core not available. Runtime JSX transpilation disabled. ' +
-            'Install @swc/core to enable: npm install @swc/core');
-        return null;
-    }
-}
-/**
- * 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
- * ```
- */
-async function transpileJsx(source, options = {}) {
-    const hash = (0, hash_1.hashString)(source);
-    // Check cache first
-    const cached = cache_1.transpileCache.getByKey(hash);
-    if (cached) {
-        return { ...cached, cached: true };
-    }
-    // Load SWC
-    const transform = await loadSwcTransform();
-    if (!transform) {
-        throw new Error('Runtime JSX transpilation requires @swc/core. ' +
-            'Either install @swc/core or use pre-compiled React components.');
-    }
-    // Merge options
-    const opts = { ...DEFAULT_SWC_OPTIONS, ...options };
-    // Build SWC configuration
-    const swcOptions = {
-        jsc: {
-            parser: {
-                syntax: opts.typescript ? 'typescript' : 'ecmascript',
-                tsx: opts.jsx,
-                jsx: opts.jsx,
-            },
-            transform: {
-                react: {
-                    runtime: opts.jsxRuntime,
-                    development: opts.development,
-                },
-            },
-            target: 'es2020',
-        },
-        module: {
-            type: 'commonjs',
-        },
-    };
-    // Transpile
-    const result = await transform(source, swcOptions);
-    // Create result
-    const transpileResult = {
-        code: result.code,
-        hash,
-        cached: false,
-    };
-    // Cache the result
-    cache_1.transpileCache.setByKey(hash, transpileResult);
-    return transpileResult;
-}
-/**
- * Check if SWC is available for runtime transpilation.
- *
- * @returns Promise resolving to true if SWC is available
- */
-async function isSwcAvailable() {
-    const transform = await loadSwcTransform();
-    return transform !== null;
-}
-/**
- * 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
- * ```
- */
-async function executeTranspiledCode(code, 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-context = {}) {
-    // Load React dynamically
-    let React;
-    let jsxRuntime;
-    try {
-        React = await import('react');
-        jsxRuntime = await import('react/jsx-runtime');
-    }
-    catch {
-        throw new Error('React is required for JSX templates. Install react: npm install react react-dom');
-    }
-    // Create module-like exports object
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const exports = {};
-    const module = { exports };
-    // Create require function for the sandboxed code
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const require = (id) => {
-        switch (id) {
-            case 'react':
-                return React;
-            case 'react/jsx-runtime':
-                return jsxRuntime;
-            case 'react/jsx-dev-runtime':
-                return jsxRuntime;
-            default:
-                // Check if it's in the context
-                if (context[id]) {
-                    return context[id];
-                }
-                throw new Error(`Module '${id}' not available in JSX template context`);
-        }
-    };
-    // Execute the code in a function scope
-    try {
-        const fn = new Function('exports', 'require', 'module', '__filename', '__dirname', 'React', 'context', code);
-        fn(exports, require, module, 'template.js', '/', React, context);
-        // Return the default export or first export
-        return module.exports['default'] || module.exports[Object.keys(module.exports)[0]] || module.exports;
-    }
-    catch (error) {
-        throw new Error(`Failed to execute transpiled JSX: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-/**
- * 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
- */
-async function transpileAndExecute(source, 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-context = {}) {
-    const result = await transpileJsx(source);
-    return executeTranspiledCode(result.code, context);
-}
-//# sourceMappingURL=transpiler.js.map

package/src/renderers/utils/transpiler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transpiler.js","sourceRoot":"","sources":["../../../../src/renderers/utils/transpiler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Runtime JSX/TSX Transpiler\n *\n * Uses SWC to transpile JSX/TSX strings to executable JavaScript at runtime.\n * This enables dynamic React templates without requiring a build step.\n */\n\nimport { transpileCache } from '../cache';\nimport { hashString } from './hash';\nimport type { TranspileResult } from '../types';\n\n/**\n * SWC transformation options for JSX.\n */\ninterface SwcTransformOptions {\n  /** Enable TypeScript syntax */\n  typescript?: boolean;\n  /** Enable JSX syntax */\n  jsx?: boolean;\n  /** JSX runtime mode ('automatic' for React 17+, 'classic' for older) */\n  jsxRuntime?: 'automatic' | 'classic';\n  /** Enable development mode (better error messages) */\n  development?: boolean;\n}\n\n/**\n * Default SWC options for React JSX transpilation.\n */\nconst DEFAULT_SWC_OPTIONS: SwcTransformOptions = {\n  typescript: true,\n  jsx: true,\n  jsxRuntime: 'automatic',\n  development: false,\n};\n\n/**\n * Lazy-loaded SWC transform function.\n * We load @swc/core dynamically to avoid requiring it at startup.\n */\nlet swcTransform: ((source: string, options: object) => Promise<{ code: string }>) | null = null;\n\n/**\n * Load the SWC transform function.\n * Returns null if @swc/core is not available.\n */\nasync function loadSwcTransform(): Promise<typeof swcTransform> {\n  if (swcTransform !== null) {\n    return swcTransform;\n  }\n\n  try {\n    // Dynamic import to avoid requiring @swc/core at startup\n    const swc = await import('@swc/core');\n    swcTransform = swc.transform;\n    return swcTransform;\n  } catch {\n    console.warn(\n      '[@frontmcp/ui] @swc/core not available. Runtime JSX transpilation disabled. ' +\n        'Install @swc/core to enable: npm install @swc/core',\n    );\n    return null;\n  }\n}\n\n/**\n * Transpile a JSX/TSX string to executable JavaScript.\n *\n * Uses SWC with React 17+ automatic JSX runtime.\n * Results are cached by content hash.\n *\n * @param source - JSX/TSX source code string\n * @param options - Transpilation options\n * @returns Transpiled result with code and caching metadata\n *\n * @example\n * ```typescript\n * const source = `\n *   function Widget({ output }) {\n *     return <div>{output.name}</div>;\n *   }\n * `;\n *\n * const result = await transpileJsx(source);\n * console.log(result.code); // JavaScript code\n * console.log(result.cached); // Whether from cache\n * ```\n */\nexport async function transpileJsx(source: string, options: SwcTransformOptions = {}): Promise<TranspileResult> {\n  const hash = hashString(source);\n\n  // Check cache first\n  const cached = transpileCache.getByKey(hash);\n  if (cached) {\n    return { ...cached, cached: true };\n  }\n\n  // Load SWC\n  const transform = await loadSwcTransform();\n  if (!transform) {\n    throw new Error(\n      'Runtime JSX transpilation requires @swc/core. ' +\n        'Either install @swc/core or use pre-compiled React components.',\n    );\n  }\n\n  // Merge options\n  const opts = { ...DEFAULT_SWC_OPTIONS, ...options };\n\n  // Build SWC configuration\n  const swcOptions = {\n    jsc: {\n      parser: {\n        syntax: opts.typescript ? 'typescript' : 'ecmascript',\n        tsx: opts.jsx,\n        jsx: opts.jsx,\n      },\n      transform: {\n        react: {\n          runtime: opts.jsxRuntime,\n          development: opts.development,\n        },\n      },\n      target: 'es2020',\n    },\n    module: {\n      type: 'commonjs',\n    },\n  };\n\n  // Transpile\n  const result = await transform(source, swcOptions);\n\n  // Create result\n  const transpileResult: TranspileResult = {\n    code: result.code,\n    hash,\n    cached: false,\n  };\n\n  // Cache the result\n  transpileCache.setByKey(hash, transpileResult);\n\n  return transpileResult;\n}\n\n/**\n * Check if SWC is available for runtime transpilation.\n *\n * @returns Promise resolving to true if SWC is available\n */\nexport async function isSwcAvailable(): Promise<boolean> {\n  const transform = await loadSwcTransform();\n  return transform !== null;\n}\n\n/**\n * Execute transpiled JavaScript code and extract the component.\n *\n * Creates a sandboxed environment with React available,\n * executes the code, and returns the exported component.\n *\n * @param code - Transpiled JavaScript code\n * @param context - Additional context to inject\n * @returns The exported component or default export\n *\n * @example\n * ```typescript\n * const code = `\n *   \"use strict\";\n *   Object.defineProperty(exports, \"__esModule\", { value: true });\n *   const jsx_runtime = require(\"react/jsx-runtime\");\n *   function Widget(props) {\n *     return jsx_runtime.jsx(\"div\", { children: props.output.name });\n *   }\n *   exports.default = Widget;\n * `;\n *\n * const Component = await executeTranspiledCode(code);\n * // Component is now a usable React component function\n * ```\n */\nexport async function executeTranspiledCode(\n  code: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  context: Record<string, any> = {},\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Promise<any> {\n  // Load React dynamically\n  let React;\n  let jsxRuntime;\n\n  try {\n    React = await import('react');\n    jsxRuntime = await import('react/jsx-runtime');\n  } catch {\n    throw new Error('React is required for JSX templates. Install react: npm install react react-dom');\n  }\n\n  // Create module-like exports object\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const exports: Record<string, any> = {};\n  const module = { exports };\n\n  // Create require function for the sandboxed code\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const require = (id: string): any => {\n    switch (id) {\n      case 'react':\n        return React;\n      case 'react/jsx-runtime':\n        return jsxRuntime;\n      case 'react/jsx-dev-runtime':\n        return jsxRuntime;\n      default:\n        // Check if it's in the context\n        if (context[id]) {\n          return context[id];\n        }\n        throw new Error(`Module '${id}' not available in JSX template context`);\n    }\n  };\n\n  // Execute the code in a function scope\n  try {\n    const fn = new Function('exports', 'require', 'module', '__filename', '__dirname', 'React', 'context', code);\n\n    fn(exports, require, module, 'template.js', '/', React, context);\n\n    // Return the default export or first export\n    return module.exports['default'] || module.exports[Object.keys(module.exports)[0]] || module.exports;\n  } catch (error) {\n    throw new Error(`Failed to execute transpiled JSX: ${error instanceof Error ? error.message : String(error)}`);\n  }\n}\n\n/**\n * Transpile and execute a JSX string, returning the component.\n *\n * Convenience function that combines transpileJsx and executeTranspiledCode.\n *\n * @param source - JSX/TSX source code\n * @param context - Additional context for execution\n * @returns The component function\n */\nexport async function transpileAndExecute(\n  source: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  context: Record<string, any> = {},\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): Promise<any> {\n  const result = await transpileJsx(source);\n  return executeTranspiledCode(result.code, context);\n}\n"]}

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

@@ -1,58 +0,0 @@
-/**
- * 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>;

package/src/runtime/adapters/html.adapter.js

@@ -1,131 +0,0 @@
-"use strict";
-/**
- * HTML Renderer Adapter
- *
- * Client-side adapter for rendering HTML templates.
- * Handles plain HTML and Handlebars-enhanced templates.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HtmlRendererAdapter = void 0;
-exports.createHtmlAdapter = createHtmlAdapter;
-exports.loadHtmlAdapter = loadHtmlAdapter;
-/**
- * HTML Renderer Adapter.
- *
- * Renders HTML templates to the DOM with support for:
- * - Plain HTML strings
- * - Handlebars-enhanced templates ({{...}} syntax)
- * - Template builder functions
- */
-class HtmlRendererAdapter {
-    type = 'html';
-    // Lazy-loaded Handlebars renderer
-    handlebarsRenderer = null;
-    /**
-     * Check if this adapter can handle the given content.
-     */
-    canHandle(content) {
-        // HTML adapter can handle any string
-        return typeof content === 'string';
-    }
-    /**
-     * Render HTML content to a string.
-     */
-    async render(content, context, _options) {
-        // Check for Handlebars syntax
-        if (this.containsHandlebars(content)) {
-            return this.renderHandlebars(content, context);
-        }
-        // Plain HTML - return as-is
-        return content;
-    }
-    /**
-     * Render HTML content directly to the DOM.
-     */
-    async renderToDOM(content, target, context, _options) {
-        try {
-            const html = await this.render(content, context);
-            target.innerHTML = html;
-            // Dispatch event to notify that content has been rendered
-            target.dispatchEvent(new CustomEvent('frontmcp:rendered', {
-                bubbles: true,
-                detail: { type: 'html', toolName: context.toolName },
-            }));
-            return { success: true, html };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            console.error('[FrontMCP] HTML render failed:', message);
-            return { success: false, error: message };
-        }
-    }
-    /**
-     * Update rendered content with new data.
-     */
-    async update(target, context) {
-        // Get the original template from data attribute
-        const template = target.getAttribute('data-template');
-        if (template) {
-            return this.renderToDOM(template, target, context);
-        }
-        // No template stored - can't update
-        return { success: false, error: 'No template stored for update' };
-    }
-    /**
-     * Clean up (no-op for HTML adapter).
-     */
-    destroy(_target) {
-        // HTML doesn't need cleanup
-    }
-    /**
-     * Check if content contains Handlebars syntax.
-     */
-    containsHandlebars(template) {
-        // Match {{...}} but not {{! comments }}
-        return /\{\{(?!!)[^}]*\}\}/.test(template);
-    }
-    /**
-     * Render Handlebars template.
-     */
-    async renderHandlebars(template, context) {
-        // Lazy-load Handlebars renderer
-        if (!this.handlebarsRenderer) {
-            try {
-                // Try to load from parent module
-                const handlebarsModule = await import('../../handlebars/index.js');
-                const { HandlebarsRenderer } = handlebarsModule;
-                const renderer = new HandlebarsRenderer();
-                this.handlebarsRenderer = {
-                    render: (tmpl, ctx) => renderer.render(tmpl, ctx),
-                    containsHandlebars: (tmpl) => HandlebarsRenderer.containsHandlebars(tmpl),
-                };
-            }
-            catch {
-                // Handlebars not available - return template as-is with warning
-                console.warn('[FrontMCP] Template contains Handlebars syntax but handlebars module not available. ' +
-                    'Ensure @frontmcp/ui/handlebars is properly bundled.');
-                return template;
-            }
-        }
-        return this.handlebarsRenderer.render(template, {
-            input: context.input,
-            output: context.output,
-        });
-    }
-}
-exports.HtmlRendererAdapter = HtmlRendererAdapter;
-/**
- * Create a new HTML renderer adapter.
- */
-function createHtmlAdapter() {
-    return new HtmlRendererAdapter();
-}
-/**
- * Adapter loader for lazy loading.
- */
-async function loadHtmlAdapter() {
-    return createHtmlAdapter();
-}
-//# sourceMappingURL=html.adapter.js.map

package/src/runtime/adapters/html.adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"html.adapter.js","sourceRoot":"","sources":["../../../../src/runtime/adapters/html.adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA0IH,8CAEC;AAKD,0CAEC;AA9ID;;;;;;;GAOG;AACH,MAAa,mBAAmB;IACrB,IAAI,GAAW,MAAM,CAAC;IAE/B,kCAAkC;IAC1B,kBAAkB,GAGf,IAAI,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,OAAyB;QACjC,qCAAqC;QACrC,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,OAAsB,EAAE,QAAwB;QAC5E,8BAA8B;QAC9B,IAAI,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAED,4BAA4B;QAC5B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,OAAe,EACf,MAAmB,EACnB,OAAsB,EACtB,QAAwB;QAExB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;YAExB,0DAA0D;YAC1D,MAAM,CAAC,aAAa,CAClB,IAAI,WAAW,CAAC,mBAAmB,EAAE;gBACnC,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;aACrD,CAAC,CACH,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,OAAO,CAAC,CAAC;YACzD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAAmB,EAAE,OAAsB;QACtD,gDAAgD;QAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;QAEtD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAED,oCAAoC;QACpC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,OAAoB;QAC1B,4BAA4B;IAC9B,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,QAAgB;QACzC,wCAAwC;QACxC,OAAO,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAAC,QAAgB,EAAE,OAAsB;QACrE,gCAAgC;QAChC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,iCAAiC;gBACjC,MAAM,gBAAgB,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;gBACnE,MAAM,EAAE,kBAAkB,EAAE,GAAG,gBAAgB,CAAC;gBAChD,MAAM,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;gBAC1C,IAAI,CAAC,kBAAkB,GAAG;oBACxB,MAAM,EAAE,CAAC,IAAY,EAAE,GAAwD,EAAE,EAAE,CACjF,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC;oBAC5B,kBAAkB,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,IAAI,CAAC;iBAClF,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,gEAAgE;gBAChE,OAAO,CAAC,IAAI,CACV,sFAAsF;oBACpF,qDAAqD,CACxD,CAAC;gBACF,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC9C,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;CACF;AAxHD,kDAwHC;AAED;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,IAAI,mBAAmB,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe;IACnC,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC","sourcesContent":["/**\n * HTML Renderer Adapter\n *\n * Client-side adapter for rendering HTML templates.\n * Handles plain HTML and Handlebars-enhanced templates.\n *\n * @packageDocumentation\n */\n\nimport type { RendererAdapter, RenderContext, RenderOptions, RenderResult } from './types';\nimport type { UIType } from '../../types/ui-runtime';\n\n/**\n * HTML Renderer Adapter.\n *\n * Renders HTML templates to the DOM with support for:\n * - Plain HTML strings\n * - Handlebars-enhanced templates ({{...}} syntax)\n * - Template builder functions\n */\nexport class HtmlRendererAdapter implements RendererAdapter {\n  readonly type: UIType = 'html';\n\n  // Lazy-loaded Handlebars renderer\n  private handlebarsRenderer: {\n    render: (template: string, context: { input: Record<string, unknown>; output: unknown }) => Promise<string>;\n    containsHandlebars: (template: string) => boolean;\n  } | null = null;\n\n  /**\n   * Check if this adapter can handle the given content.\n   */\n  canHandle(content: string | unknown): boolean {\n    // HTML adapter can handle any string\n    return typeof content === 'string';\n  }\n\n  /**\n   * Render HTML content to a string.\n   */\n  async render(content: string, context: RenderContext, _options?: RenderOptions): Promise<string> {\n    // Check for Handlebars syntax\n    if (this.containsHandlebars(content)) {\n      return this.renderHandlebars(content, context);\n    }\n\n    // Plain HTML - return as-is\n    return content;\n  }\n\n  /**\n   * Render HTML content directly to the DOM.\n   */\n  async renderToDOM(\n    content: string,\n    target: HTMLElement,\n    context: RenderContext,\n    _options?: RenderOptions,\n  ): Promise<RenderResult> {\n    try {\n      const html = await this.render(content, context);\n      target.innerHTML = html;\n\n      // Dispatch event to notify that content has been rendered\n      target.dispatchEvent(\n        new CustomEvent('frontmcp:rendered', {\n          bubbles: true,\n          detail: { type: 'html', toolName: context.toolName },\n        }),\n      );\n\n      return { success: true, html };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      console.error('[FrontMCP] HTML render failed:', message);\n      return { success: false, error: message };\n    }\n  }\n\n  /**\n   * Update rendered content with new data.\n   */\n  async update(target: HTMLElement, context: RenderContext): Promise<RenderResult> {\n    // Get the original template from data attribute\n    const template = target.getAttribute('data-template');\n\n    if (template) {\n      return this.renderToDOM(template, target, context);\n    }\n\n    // No template stored - can't update\n    return { success: false, error: 'No template stored for update' };\n  }\n\n  /**\n   * Clean up (no-op for HTML adapter).\n   */\n  destroy(_target: HTMLElement): void {\n    // HTML doesn't need cleanup\n  }\n\n  /**\n   * Check if content contains Handlebars syntax.\n   */\n  private containsHandlebars(template: string): boolean {\n    // Match {{...}} but not {{! comments }}\n    return /\\{\\{(?!!)[^}]*\\}\\}/.test(template);\n  }\n\n  /**\n   * Render Handlebars template.\n   */\n  private async renderHandlebars(template: string, context: RenderContext): Promise<string> {\n    // Lazy-load Handlebars renderer\n    if (!this.handlebarsRenderer) {\n      try {\n        // Try to load from parent module\n        const handlebarsModule = await import('../../handlebars/index.js');\n        const { HandlebarsRenderer } = handlebarsModule;\n        const renderer = new HandlebarsRenderer();\n        this.handlebarsRenderer = {\n          render: (tmpl: string, ctx: { input: Record<string, unknown>; output: unknown }) =>\n            renderer.render(tmpl, ctx),\n          containsHandlebars: (tmpl: string) => HandlebarsRenderer.containsHandlebars(tmpl),\n        };\n      } catch {\n        // Handlebars not available - return template as-is with warning\n        console.warn(\n          '[FrontMCP] Template contains Handlebars syntax but handlebars module not available. ' +\n            'Ensure @frontmcp/ui/handlebars is properly bundled.',\n        );\n        return template;\n      }\n    }\n\n    return this.handlebarsRenderer.render(template, {\n      input: context.input,\n      output: context.output,\n    });\n  }\n}\n\n/**\n * Create a new HTML renderer adapter.\n */\nexport function createHtmlAdapter(): HtmlRendererAdapter {\n  return new HtmlRendererAdapter();\n}\n\n/**\n * Adapter loader for lazy loading.\n */\nexport async function loadHtmlAdapter(): Promise<RendererAdapter> {\n  return createHtmlAdapter();\n}\n"]}

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

@@ -1,25 +0,0 @@
-/**
- * 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>;

package/src/runtime/adapters/index.js

@@ -1,54 +0,0 @@
-"use strict";
-/**
- * Renderer Adapters
- *
- * Client-side adapters for rendering different UI types.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.adapterLoaders = exports.loadMdxAdapter = exports.createMdxAdapter = exports.MdxRendererAdapter = exports.loadReactAdapter = exports.createReactAdapter = exports.ReactRendererAdapter = exports.loadHtmlAdapter = exports.createHtmlAdapter = exports.HtmlRendererAdapter = void 0;
-exports.getAdapterLoader = getAdapterLoader;
-exports.loadAdapter = loadAdapter;
-// HTML Adapter
-var html_adapter_1 = require("./html.adapter");
-Object.defineProperty(exports, "HtmlRendererAdapter", { enumerable: true, get: function () { return html_adapter_1.HtmlRendererAdapter; } });
-Object.defineProperty(exports, "createHtmlAdapter", { enumerable: true, get: function () { return html_adapter_1.createHtmlAdapter; } });
-Object.defineProperty(exports, "loadHtmlAdapter", { enumerable: true, get: function () { return html_adapter_1.loadHtmlAdapter; } });
-// React Adapter
-var react_adapter_1 = require("./react.adapter");
-Object.defineProperty(exports, "ReactRendererAdapter", { enumerable: true, get: function () { return react_adapter_1.ReactRendererAdapter; } });
-Object.defineProperty(exports, "createReactAdapter", { enumerable: true, get: function () { return react_adapter_1.createReactAdapter; } });
-Object.defineProperty(exports, "loadReactAdapter", { enumerable: true, get: function () { return react_adapter_1.loadReactAdapter; } });
-// MDX Adapter
-var mdx_adapter_1 = require("./mdx.adapter");
-Object.defineProperty(exports, "MdxRendererAdapter", { enumerable: true, get: function () { return mdx_adapter_1.MdxRendererAdapter; } });
-Object.defineProperty(exports, "createMdxAdapter", { enumerable: true, get: function () { return mdx_adapter_1.createMdxAdapter; } });
-Object.defineProperty(exports, "loadMdxAdapter", { enumerable: true, get: function () { return mdx_adapter_1.loadMdxAdapter; } });
-/**
- * Registry of adapter loaders by UI type.
- */
-exports.adapterLoaders = {
-    html: () => import(/* webpackIgnore: true */ './html.adapter.js').then((m) => m.createHtmlAdapter()),
-    react: () => import(/* webpackIgnore: true */ './react.adapter.js').then((m) => m.createReactAdapter()),
-    mdx: () => import(/* webpackIgnore: true */ './mdx.adapter.js').then((m) => m.createMdxAdapter()),
-    markdown: () => import(/* webpackIgnore: true */ './mdx.adapter.js').then((m) => m.createMdxAdapter()), // Use MDX for markdown
-    auto: undefined, // Auto-detection handled by runtime
-};
-/**
- * Get an adapter loader for a UI type.
- */
-function getAdapterLoader(type) {
-    return exports.adapterLoaders[type];
-}
-/**
- * Load an adapter for a UI type.
- */
-async function loadAdapter(type) {
-    const loader = getAdapterLoader(type);
-    if (!loader) {
-        return null;
-    }
-    return loader();
-}
-//# sourceMappingURL=index.js.map

package/src/runtime/adapters/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/adapters/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAuCH,4CAEC;AAKD,kCAMC;AAxCD,eAAe;AACf,+CAAyF;AAAhF,mHAAA,mBAAmB,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAAE,+GAAA,eAAe,OAAA;AAEhE,gBAAgB;AAChB,iDAA6F;AAApF,qHAAA,oBAAoB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAAE,iHAAA,gBAAgB,OAAA;AAEnE,cAAc;AACd,6CAAqF;AAA5E,iHAAA,kBAAkB,OAAA;AAAE,+GAAA,gBAAgB,OAAA;AAAE,6GAAA,cAAc,OAAA;AAM7D;;GAEG;AACU,QAAA,cAAc,GAA8C;IACvE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;IACpG,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC;IACvG,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACjG,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,EAAE,uBAAuB;IAC/H,IAAI,EAAE,SAAS,EAAE,oCAAoC;CACtD,CAAC;AAEF;;GAEG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,sBAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,EAAE,CAAC;AAClB,CAAC","sourcesContent":["/**\n * Renderer Adapters\n *\n * Client-side adapters for rendering different UI types.\n *\n * @packageDocumentation\n */\n\n// Types\nexport type {\n  RendererAdapter,\n  RenderContext,\n  RenderOptions,\n  RenderResult,\n  AdapterLoader,\n  AdapterRegistryEntry,\n} from './types';\n\n// HTML Adapter\nexport { HtmlRendererAdapter, createHtmlAdapter, loadHtmlAdapter } from './html.adapter';\n\n// React Adapter\nexport { ReactRendererAdapter, createReactAdapter, loadReactAdapter } from './react.adapter';\n\n// MDX Adapter\nexport { MdxRendererAdapter, createMdxAdapter, loadMdxAdapter } from './mdx.adapter';\n\n// Adapter registry for lazy loading\nimport type { UIType } from '../../types/ui-runtime';\nimport type { AdapterLoader, RendererAdapter } from './types';\n\n/**\n * Registry of adapter loaders by UI type.\n */\nexport const adapterLoaders: Record<UIType, AdapterLoader | undefined> = {\n  html: () => import(/* webpackIgnore: true */ './html.adapter.js').then((m) => m.createHtmlAdapter()),\n  react: () => import(/* webpackIgnore: true */ './react.adapter.js').then((m) => m.createReactAdapter()),\n  mdx: () => import(/* webpackIgnore: true */ './mdx.adapter.js').then((m) => m.createMdxAdapter()),\n  markdown: () => import(/* webpackIgnore: true */ './mdx.adapter.js').then((m) => m.createMdxAdapter()), // Use MDX for markdown\n  auto: undefined, // Auto-detection handled by runtime\n};\n\n/**\n * Get an adapter loader for a UI type.\n */\nexport function getAdapterLoader(type: UIType): AdapterLoader | undefined {\n  return adapterLoaders[type];\n}\n\n/**\n * Load an adapter for a UI type.\n */\nexport async function loadAdapter(type: UIType): Promise<RendererAdapter | null> {\n  const loader = getAdapterLoader(type);\n  if (!loader) {\n    return null;\n  }\n  return loader();\n}\n"]}

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

@@ -1,72 +0,0 @@
-/**
- * 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>;