@frontmcp/ui 0.5.0 → 0.6.0

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

@@ -1,241 +0,0 @@
-"use strict";
-/**
- * MDX Renderer Adapter
- *
- * Client-side adapter for rendering MDX (Markdown + JSX) content.
- * Builds on top of the React adapter for component rendering.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MdxRendererAdapter = void 0;
-exports.createMdxAdapter = createMdxAdapter;
-exports.loadMdxAdapter = loadMdxAdapter;
-/**
- * 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
- */
-class MdxRendererAdapter {
-    type = 'mdx';
-    // Lazy-loaded MDX runtime
-    mdxRuntime = null;
-    loadPromise = null;
-    /**
-     * Check if this adapter can handle the given content.
-     */
-    canHandle(content) {
-        if (typeof content !== 'string') {
-            return false;
-        }
-        // MDX patterns:
-        // - Contains JSX-like syntax in markdown
-        // - Contains import/export statements
-        // - Contains frontmatter (---)
-        // - Has MDX file extension markers
-        return (/^---[\s\S]*?---/.test(content) || // Frontmatter
-            /<[A-Z][a-zA-Z0-9]*[\s/>]/.test(content) || // JSX component tags
-            /^import\s+/.test(content) || // Import statements
-            /^export\s+/.test(content) || // Export statements
-            content.includes('```jsx') || // Code blocks with JSX
-            content.includes('```tsx'));
-    }
-    /**
-     * Render MDX content to a string.
-     */
-    async render(content, context, _options) {
-        try {
-            await this.ensureMdxLoaded();
-            if (!this.mdxRuntime) {
-                // Fall back to basic markdown rendering
-                return this.renderMarkdown(content, context);
-            }
-            // Compile and render MDX
-            const compiled = await this.compileMdx(content, context);
-            return compiled;
-        }
-        catch (error) {
-            console.error('[FrontMCP] MDX render failed:', error);
-            // Fall back to markdown
-            return this.renderMarkdown(content, context);
-        }
-    }
-    /**
-     * Render MDX content directly to the DOM.
-     */
-    async renderToDOM(content, target, context, _options) {
-        try {
-            const html = await this.render(content, context);
-            target.innerHTML = html;
-            // Dispatch event
-            target.dispatchEvent(new CustomEvent('frontmcp:rendered', {
-                bubbles: true,
-                detail: { type: 'mdx', toolName: context.toolName },
-            }));
-            return { success: true, html };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            console.error('[FrontMCP] MDX render to DOM failed:', message);
-            return { success: false, error: message };
-        }
-    }
-    /**
-     * Hydrate existing SSR content.
-     * MDX hydration follows React patterns.
-     */
-    async hydrate(target, context, options) {
-        // MDX hydration would require the React adapter
-        // For now, just update the content
-        const content = target.getAttribute('data-mdx-source');
-        if (content) {
-            return this.renderToDOM(content, target, context, options);
-        }
-        return { success: true }; // Already rendered, nothing to hydrate
-    }
-    /**
-     * Update rendered MDX content with new data.
-     */
-    async update(target, context) {
-        const source = target.getAttribute('data-mdx-source');
-        if (source) {
-            return this.renderToDOM(source, target, context);
-        }
-        return { success: false, error: 'No MDX source stored for update' };
-    }
-    /**
-     * Clean up (no-op for MDX adapter).
-     */
-    destroy(_target) {
-        // MDX doesn't need cleanup unless using React hydration
-    }
-    /**
-     * Ensure MDX runtime is loaded.
-     */
-    async ensureMdxLoaded() {
-        if (this.mdxRuntime) {
-            return;
-        }
-        if (this.loadPromise) {
-            return this.loadPromise;
-        }
-        this.loadPromise = this.loadMdx();
-        return this.loadPromise;
-    }
-    /**
-     * Load MDX runtime.
-     */
-    async loadMdx() {
-        try {
-            // Try to load @mdx-js/mdx for compilation
-            const mdxModule = await import(/* webpackIgnore: true */ '@mdx-js/mdx');
-            this.mdxRuntime = {
-                run: async () => ({ default: null }),
-                compile: mdxModule.compile,
-            };
-        }
-        catch {
-            // MDX not available
-            console.warn('[FrontMCP] MDX runtime not available. ' + 'Install @mdx-js/mdx for full MDX support, or use pre-compiled MDX.');
-        }
-    }
-    /**
-     * Compile MDX content.
-     */
-    async compileMdx(source, context) {
-        if (!this.mdxRuntime?.compile) {
-            return this.renderMarkdown(source, context);
-        }
-        try {
-            // Compile MDX to JS
-            const compiled = await this.mdxRuntime.compile(source, {
-                outputFormat: 'function-body',
-                development: false,
-            });
-            // For now, return the compiled code as-is
-            // Full execution would require React runtime
-            return `<div class="mdx-content" data-compiled="true">${this.renderMarkdown(source, context)}</div>`;
-        }
-        catch (error) {
-            console.warn('[FrontMCP] MDX compilation failed, falling back to markdown:', error);
-            return this.renderMarkdown(source, context);
-        }
-    }
-    /**
-     * Basic markdown rendering (fallback).
-     */
-    renderMarkdown(source, context) {
-        // Very basic markdown-to-HTML conversion
-        // For production, use a proper markdown library
-        let html = source;
-        // Escape HTML first for safety
-        html = html.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
-        // Strip frontmatter
-        html = html.replace(/^---[\s\S]*?---\n?/, '');
-        // Headers
-        html = html.replace(/^######\s+(.+)$/gm, '<h6>$1</h6>');
-        html = html.replace(/^#####\s+(.+)$/gm, '<h5>$1</h5>');
-        html = html.replace(/^####\s+(.+)$/gm, '<h4>$1</h4>');
-        html = html.replace(/^###\s+(.+)$/gm, '<h3>$1</h3>');
-        html = html.replace(/^##\s+(.+)$/gm, '<h2>$1</h2>');
-        html = html.replace(/^#\s+(.+)$/gm, '<h1>$1</h1>');
-        // Bold and italic
-        html = html.replace(/\*\*\*(.+?)\*\*\*/g, '<strong><em>$1</em></strong>');
-        html = html.replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>');
-        html = html.replace(/\*(.+?)\*/g, '<em>$1</em>');
-        html = html.replace(/___(.+?)___/g, '<strong><em>$1</em></strong>');
-        html = html.replace(/__(.+?)__/g, '<strong>$1</strong>');
-        html = html.replace(/_(.+?)_/g, '<em>$1</em>');
-        // Code blocks
-        html = html.replace(/```(\w+)?\n([\s\S]*?)```/g, '<pre><code class="language-$1">$2</code></pre>');
-        html = html.replace(/`([^`]+)`/g, '<code>$1</code>');
-        // Links
-        html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
-        // Lists
-        html = html.replace(/^\s*[-*]\s+(.+)$/gm, '<li>$1</li>');
-        html = html.replace(/(<li>.*<\/li>\n?)+/g, '<ul>$&</ul>');
-        html = html.replace(/^\s*\d+\.\s+(.+)$/gm, '<li>$1</li>');
-        // Paragraphs
-        html = html
-            .split(/\n\n+/)
-            .map((para) => {
-            const trimmed = para.trim();
-            if (!trimmed ||
-                trimmed.startsWith('<h') ||
-                trimmed.startsWith('<ul') ||
-                trimmed.startsWith('<ol') ||
-                trimmed.startsWith('<pre')) {
-                return trimmed;
-            }
-            return `<p>${trimmed}</p>`;
-        })
-            .join('\n');
-        // Interpolate context data (basic {{variable}} support)
-        html = html.replace(/\{\{output\.(\w+)\}\}/g, (_match, key) => {
-            const value = context.output?.[key];
-            return value !== undefined ? String(value) : '';
-        });
-        html = html.replace(/\{\{input\.(\w+)\}\}/g, (_match, key) => {
-            const value = context.input?.[key];
-            return value !== undefined ? String(value) : '';
-        });
-        return `<div class="markdown-content">${html}</div>`;
-    }
-}
-exports.MdxRendererAdapter = MdxRendererAdapter;
-/**
- * Create a new MDX renderer adapter.
- */
-function createMdxAdapter() {
-    return new MdxRendererAdapter();
-}
-/**
- * Adapter loader for lazy loading.
- */
-async function loadMdxAdapter() {
-    return createMdxAdapter();
-}
-//# sourceMappingURL=mdx.adapter.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"mdx.adapter.js","sourceRoot":"","sources":["../../../../src/runtime/adapters/mdx.adapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MDX Renderer Adapter\n *\n * Client-side adapter for rendering MDX (Markdown + JSX) content.\n * Builds on top of the React adapter for component rendering.\n *\n * @packageDocumentation\n */\n\nimport type { RendererAdapter, RenderContext, RenderOptions, RenderResult } from './types';\nimport type { UIType } from '../../types/ui-runtime';\n\n/**\n * MDX runtime interface.\n * Uses permissive types to support various @mdx-js versions.\n */\ninterface MDXRuntime {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  run: (code: string, options: Record<string, unknown>) => Promise<{ default: unknown }>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  compile?: (source: string, options?: Record<string, unknown>) => Promise<any>;\n}\n\n/**\n * MDX Renderer Adapter.\n *\n * Renders MDX content to the DOM with support for:\n * - Pre-compiled MDX (recommended)\n * - Runtime MDX compilation (if mdx-js available)\n * - Custom component injection\n */\nexport class MdxRendererAdapter implements RendererAdapter {\n  readonly type: UIType = 'mdx';\n\n  // Lazy-loaded MDX runtime\n  private mdxRuntime: MDXRuntime | null = null;\n  private loadPromise: Promise<void> | null = null;\n\n  /**\n   * Check if this adapter can handle the given content.\n   */\n  canHandle(content: string | unknown): boolean {\n    if (typeof content !== 'string') {\n      return false;\n    }\n\n    // MDX patterns:\n    // - Contains JSX-like syntax in markdown\n    // - Contains import/export statements\n    // - Contains frontmatter (---)\n    // - Has MDX file extension markers\n    return (\n      /^---[\\s\\S]*?---/.test(content) || // Frontmatter\n      /<[A-Z][a-zA-Z0-9]*[\\s/>]/.test(content) || // JSX component tags\n      /^import\\s+/.test(content) || // Import statements\n      /^export\\s+/.test(content) || // Export statements\n      content.includes('```jsx') || // Code blocks with JSX\n      content.includes('```tsx')\n    );\n  }\n\n  /**\n   * Render MDX content to a string.\n   */\n  async render(content: string, context: RenderContext, _options?: RenderOptions): Promise<string> {\n    try {\n      await this.ensureMdxLoaded();\n\n      if (!this.mdxRuntime) {\n        // Fall back to basic markdown rendering\n        return this.renderMarkdown(content, context);\n      }\n\n      // Compile and render MDX\n      const compiled = await this.compileMdx(content, context);\n      return compiled;\n    } catch (error) {\n      console.error('[FrontMCP] MDX render failed:', error);\n      // Fall back to markdown\n      return this.renderMarkdown(content, context);\n    }\n  }\n\n  /**\n   * Render MDX 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\n      target.dispatchEvent(\n        new CustomEvent('frontmcp:rendered', {\n          bubbles: true,\n          detail: { type: 'mdx', 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] MDX render to DOM failed:', message);\n      return { success: false, error: message };\n    }\n  }\n\n  /**\n   * Hydrate existing SSR content.\n   * MDX hydration follows React patterns.\n   */\n  async hydrate(target: HTMLElement, context: RenderContext, options?: RenderOptions): Promise<RenderResult> {\n    // MDX hydration would require the React adapter\n    // For now, just update the content\n    const content = target.getAttribute('data-mdx-source');\n    if (content) {\n      return this.renderToDOM(content, target, context, options);\n    }\n\n    return { success: true }; // Already rendered, nothing to hydrate\n  }\n\n  /**\n   * Update rendered MDX content with new data.\n   */\n  async update(target: HTMLElement, context: RenderContext): Promise<RenderResult> {\n    const source = target.getAttribute('data-mdx-source');\n    if (source) {\n      return this.renderToDOM(source, target, context);\n    }\n\n    return { success: false, error: 'No MDX source stored for update' };\n  }\n\n  /**\n   * Clean up (no-op for MDX adapter).\n   */\n  destroy(_target: HTMLElement): void {\n    // MDX doesn't need cleanup unless using React hydration\n  }\n\n  /**\n   * Ensure MDX runtime is loaded.\n   */\n  private async ensureMdxLoaded(): Promise<void> {\n    if (this.mdxRuntime) {\n      return;\n    }\n\n    if (this.loadPromise) {\n      return this.loadPromise;\n    }\n\n    this.loadPromise = this.loadMdx();\n    return this.loadPromise;\n  }\n\n  /**\n   * Load MDX runtime.\n   */\n  private async loadMdx(): Promise<void> {\n    try {\n      // Try to load @mdx-js/mdx for compilation\n      const mdxModule = await import(/* webpackIgnore: true */ '@mdx-js/mdx');\n      this.mdxRuntime = {\n        run: async () => ({ default: null }),\n        compile: mdxModule.compile,\n      };\n    } catch {\n      // MDX not available\n      console.warn(\n        '[FrontMCP] MDX runtime not available. ' + 'Install @mdx-js/mdx for full MDX support, or use pre-compiled MDX.',\n      );\n    }\n  }\n\n  /**\n   * Compile MDX content.\n   */\n  private async compileMdx(source: string, context: RenderContext): Promise<string> {\n    if (!this.mdxRuntime?.compile) {\n      return this.renderMarkdown(source, context);\n    }\n\n    try {\n      // Compile MDX to JS\n      const compiled = await this.mdxRuntime.compile(source, {\n        outputFormat: 'function-body',\n        development: false,\n      });\n\n      // For now, return the compiled code as-is\n      // Full execution would require React runtime\n      return `<div class=\"mdx-content\" data-compiled=\"true\">${this.renderMarkdown(source, context)}</div>`;\n    } catch (error) {\n      console.warn('[FrontMCP] MDX compilation failed, falling back to markdown:', error);\n      return this.renderMarkdown(source, context);\n    }\n  }\n\n  /**\n   * Basic markdown rendering (fallback).\n   */\n  private renderMarkdown(source: string, context: RenderContext): string {\n    // Very basic markdown-to-HTML conversion\n    // For production, use a proper markdown library\n    let html = source;\n\n    // Escape HTML first for safety\n    html = html.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');\n\n    // Strip frontmatter\n    html = html.replace(/^---[\\s\\S]*?---\\n?/, '');\n\n    // Headers\n    html = html.replace(/^######\\s+(.+)$/gm, '<h6>$1</h6>');\n    html = html.replace(/^#####\\s+(.+)$/gm, '<h5>$1</h5>');\n    html = html.replace(/^####\\s+(.+)$/gm, '<h4>$1</h4>');\n    html = html.replace(/^###\\s+(.+)$/gm, '<h3>$1</h3>');\n    html = html.replace(/^##\\s+(.+)$/gm, '<h2>$1</h2>');\n    html = html.replace(/^#\\s+(.+)$/gm, '<h1>$1</h1>');\n\n    // Bold and italic\n    html = html.replace(/\\*\\*\\*(.+?)\\*\\*\\*/g, '<strong><em>$1</em></strong>');\n    html = html.replace(/\\*\\*(.+?)\\*\\*/g, '<strong>$1</strong>');\n    html = html.replace(/\\*(.+?)\\*/g, '<em>$1</em>');\n    html = html.replace(/___(.+?)___/g, '<strong><em>$1</em></strong>');\n    html = html.replace(/__(.+?)__/g, '<strong>$1</strong>');\n    html = html.replace(/_(.+?)_/g, '<em>$1</em>');\n\n    // Code blocks\n    html = html.replace(/```(\\w+)?\\n([\\s\\S]*?)```/g, '<pre><code class=\"language-$1\">$2</code></pre>');\n    html = html.replace(/`([^`]+)`/g, '<code>$1</code>');\n\n    // Links\n    html = html.replace(/\\[([^\\]]+)\\]\\(([^)]+)\\)/g, '<a href=\"$2\">$1</a>');\n\n    // Lists\n    html = html.replace(/^\\s*[-*]\\s+(.+)$/gm, '<li>$1</li>');\n    html = html.replace(/(<li>.*<\\/li>\\n?)+/g, '<ul>$&</ul>');\n    html = html.replace(/^\\s*\\d+\\.\\s+(.+)$/gm, '<li>$1</li>');\n\n    // Paragraphs\n    html = html\n      .split(/\\n\\n+/)\n      .map((para) => {\n        const trimmed = para.trim();\n        if (\n          !trimmed ||\n          trimmed.startsWith('<h') ||\n          trimmed.startsWith('<ul') ||\n          trimmed.startsWith('<ol') ||\n          trimmed.startsWith('<pre')\n        ) {\n          return trimmed;\n        }\n        return `<p>${trimmed}</p>`;\n      })\n      .join('\\n');\n\n    // Interpolate context data (basic {{variable}} support)\n    html = html.replace(/\\{\\{output\\.(\\w+)\\}\\}/g, (_match, key) => {\n      const value = (context.output as Record<string, unknown>)?.[key];\n      return value !== undefined ? String(value) : '';\n    });\n    html = html.replace(/\\{\\{input\\.(\\w+)\\}\\}/g, (_match, key) => {\n      const value = context.input?.[key];\n      return value !== undefined ? String(value) : '';\n    });\n\n    return `<div class=\"markdown-content\">${html}</div>`;\n  }\n}\n\n/**\n * Create a new MDX renderer adapter.\n */\nexport function createMdxAdapter(): MdxRendererAdapter {\n  return new MdxRendererAdapter();\n}\n\n/**\n * Adapter loader for lazy loading.\n */\nexport async function loadMdxAdapter(): Promise<RendererAdapter> {\n  return createMdxAdapter();\n}\n"]}

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

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

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

@@ -1,245 +0,0 @@
-"use strict";
-/**
- * React Renderer Adapter
- *
- * Client-side adapter for rendering React components.
- * Handles hydration, client-side rendering, and updates.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReactRendererAdapter = void 0;
-exports.createReactAdapter = createReactAdapter;
-exports.loadReactAdapter = loadReactAdapter;
-/**
- * Map of mounted roots for cleanup.
- */
-const mountedRoots = new WeakMap();
-/**
- * React Renderer Adapter.
- *
- * Renders React components to the DOM with support for:
- * - Server-side rendering (SSR)
- * - Client-side hydration
- * - Dynamic updates when data changes
- */
-class ReactRendererAdapter {
-    type = 'react';
-    // Lazy-loaded React runtime
-    react = null;
-    reactDOM = null;
-    loadPromise = null;
-    /**
-     * Check if this adapter can handle the given content.
-     */
-    canHandle(content) {
-        // React adapter handles:
-        // - Functions (React components)
-        // - Strings that look like JSX
-        if (typeof content === 'function') {
-            return true;
-        }
-        if (typeof content === 'string') {
-            // Check for JSX patterns
-            return (content.includes('React.createElement') ||
-                content.includes('jsx(') ||
-                content.includes('jsxs(') ||
-                /function\s+\w+\s*\([^)]*\)\s*\{[\s\S]*return\s*[\s\S]*</.test(content));
-        }
-        return false;
-    }
-    /**
-     * Render React component to a string.
-     * This is a client-side fallback - SSR should be done at build time.
-     */
-    async render(content, context, _options) {
-        // For client-side, we can't SSR React
-        // Return a placeholder that will be hydrated
-        return `<div data-frontmcp-react data-tool="${context.toolName}">${content}</div>`;
-    }
-    /**
-     * Render React component directly to the DOM.
-     */
-    async renderToDOM(content, target, context, options) {
-        try {
-            await this.ensureReactLoaded();
-            if (!this.react || !this.reactDOM) {
-                throw new Error('React runtime not available');
-            }
-            // Try to get component from registered components
-            const componentName = target.getAttribute('data-component');
-            const component = this.getComponent(componentName, content);
-            if (!component) {
-                // Fall back to HTML rendering
-                target.innerHTML = content;
-                return { success: true };
-            }
-            // Create React element with context as props
-            const element = this.react.createElement(component, {
-                input: context.input,
-                output: context.output,
-                structuredContent: context.structuredContent,
-                toolName: context.toolName,
-            });
-            // Render or hydrate
-            if (options?.hydrate && this.reactDOM.hydrateRoot) {
-                const root = this.reactDOM.hydrateRoot(target, element);
-                mountedRoots.set(target, root);
-            }
-            else if (this.reactDOM.createRoot) {
-                const root = this.reactDOM.createRoot(target);
-                root.render(element);
-                mountedRoots.set(target, root);
-            }
-            else if (this.reactDOM.render) {
-                // Legacy React 17 API
-                this.reactDOM.render(element, target);
-                mountedRoots.set(target, {
-                    unmount: () => this.reactDOM?.unmountComponentAtNode?.(target),
-                });
-            }
-            else {
-                throw new Error('No suitable React render method available');
-            }
-            // Dispatch event
-            target.dispatchEvent(new CustomEvent('frontmcp:rendered', {
-                bubbles: true,
-                detail: { type: 'react', toolName: context.toolName },
-            }));
-            return { success: true };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            console.error('[FrontMCP] React render failed:', message);
-            return { success: false, error: message };
-        }
-    }
-    /**
-     * Hydrate existing SSR content with React.
-     */
-    async hydrate(target, context, options) {
-        return this.renderToDOM('', target, context, { ...options, hydrate: true });
-    }
-    /**
-     * Update rendered React component with new data.
-     */
-    async update(target, context) {
-        try {
-            await this.ensureReactLoaded();
-            if (!this.react) {
-                throw new Error('React runtime not available');
-            }
-            const existingRoot = mountedRoots.get(target);
-            const componentName = target.getAttribute('data-component');
-            const component = this.getComponent(componentName, '');
-            if (!component) {
-                return { success: false, error: 'No component found for update' };
-            }
-            // Create new element with updated props
-            const element = this.react.createElement(component, {
-                input: context.input,
-                output: context.output,
-                structuredContent: context.structuredContent,
-                toolName: context.toolName,
-            });
-            if (existingRoot && 'render' in existingRoot) {
-                existingRoot.render(element);
-                return { success: true };
-            }
-            // No existing root - do a fresh render
-            return this.renderToDOM('', target, context);
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            console.error('[FrontMCP] React update failed:', message);
-            return { success: false, error: message };
-        }
-    }
-    /**
-     * Clean up React root.
-     */
-    destroy(target) {
-        const root = mountedRoots.get(target);
-        if (root) {
-            root.unmount();
-            mountedRoots.delete(target);
-        }
-    }
-    /**
-     * Ensure React is loaded.
-     */
-    async ensureReactLoaded() {
-        if (this.react && this.reactDOM) {
-            return;
-        }
-        if (this.loadPromise) {
-            return this.loadPromise;
-        }
-        this.loadPromise = this.loadReact();
-        return this.loadPromise;
-    }
-    /**
-     * Load React runtime.
-     */
-    async loadReact() {
-        // Check if React is already available globally
-        const win = typeof window !== 'undefined' ? window : globalThis;
-        if (win.React) {
-            this.react = win.React;
-        }
-        if (win.ReactDOM) {
-            this.reactDOM = win.ReactDOM;
-        }
-        if (this.react && this.reactDOM) {
-            return;
-        }
-        // Try to dynamically import React
-        try {
-            if (!this.react) {
-                const reactModule = await import(/* webpackIgnore: true */ 'react');
-                this.react = reactModule.default || reactModule;
-            }
-            if (!this.reactDOM) {
-                const reactDOMModule = await import(/* webpackIgnore: true */ 'react-dom/client');
-                this.reactDOM = reactDOMModule.default || reactDOMModule;
-            }
-        }
-        catch {
-            // React not available via import - rely on global
-            if (!this.react || !this.reactDOM) {
-                console.warn('[FrontMCP] React runtime not available. ' + 'Ensure React is loaded via CDN or bundled.');
-            }
-        }
-    }
-    /**
-     * Get a React component by name or from content.
-     */
-    getComponent(componentName, content) {
-        const win = typeof window !== 'undefined' ? window : globalThis;
-        if (componentName && win.__frontmcp_components) {
-            const registered = win.__frontmcp_components?.[componentName];
-            if (registered) {
-                return registered;
-            }
-        }
-        // Try to evaluate content as a component (unsafe - should be pre-bundled)
-        if (content && typeof content === 'function') {
-            return content;
-        }
-        return null;
-    }
-}
-exports.ReactRendererAdapter = ReactRendererAdapter;
-/**
- * Create a new React renderer adapter.
- */
-function createReactAdapter() {
-    return new ReactRendererAdapter();
-}
-/**
- * Adapter loader for lazy loading.
- */
-async function loadReactAdapter() {
-    return createReactAdapter();
-}
-//# sourceMappingURL=react.adapter.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"react.adapter.js","sourceRoot":"","sources":["../../../../src/runtime/adapters/react.adapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * React Renderer Adapter\n *\n * Client-side adapter for rendering React components.\n * Handles hydration, client-side rendering, and updates.\n *\n * @packageDocumentation\n */\n\nimport type { RendererAdapter, RenderContext, RenderOptions, RenderResult } from './types';\nimport type { UIType } from '../../types/ui-runtime';\n\n/**\n * React runtime interface.\n * Uses permissive types to support various React versions.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ninterface ReactRuntime {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  createElement: (...args: any[]) => any;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  Component?: any;\n}\n\n/**\n * ReactDOM runtime interface.\n * Uses permissive types to support React 17 and 18+.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ninterface ReactDOMRuntime {\n  createRoot?: (container: Element) => {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    render: (element: any) => void;\n    unmount: () => void;\n  };\n  hydrateRoot?: (\n    container: Element,\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    element: any,\n  ) => {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    render: (element: any) => void;\n    unmount: () => void;\n  };\n  // Legacy APIs (React 17)\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  render?: (element: any, container: Element) => void;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  hydrate?: (element: any, container: Element) => void;\n  unmountComponentAtNode?: (container: Element) => boolean;\n}\n\n/**\n * Root reference for cleanup.\n */\ninterface RootRef {\n  unmount: () => void;\n}\n\n/**\n * Map of mounted roots for cleanup.\n */\nconst mountedRoots = new WeakMap<HTMLElement, RootRef>();\n\n/**\n * React Renderer Adapter.\n *\n * Renders React components to the DOM with support for:\n * - Server-side rendering (SSR)\n * - Client-side hydration\n * - Dynamic updates when data changes\n */\nexport class ReactRendererAdapter implements RendererAdapter {\n  readonly type: UIType = 'react';\n\n  // Lazy-loaded React runtime\n  private react: ReactRuntime | null = null;\n  private reactDOM: ReactDOMRuntime | null = null;\n  private loadPromise: Promise<void> | null = null;\n\n  /**\n   * Check if this adapter can handle the given content.\n   */\n  canHandle(content: string | unknown): boolean {\n    // React adapter handles:\n    // - Functions (React components)\n    // - Strings that look like JSX\n    if (typeof content === 'function') {\n      return true;\n    }\n\n    if (typeof content === 'string') {\n      // Check for JSX patterns\n      return (\n        content.includes('React.createElement') ||\n        content.includes('jsx(') ||\n        content.includes('jsxs(') ||\n        /function\\s+\\w+\\s*\\([^)]*\\)\\s*\\{[\\s\\S]*return\\s*[\\s\\S]*</.test(content)\n      );\n    }\n\n    return false;\n  }\n\n  /**\n   * Render React component to a string.\n   * This is a client-side fallback - SSR should be done at build time.\n   */\n  async render(content: string, context: RenderContext, _options?: RenderOptions): Promise<string> {\n    // For client-side, we can't SSR React\n    // Return a placeholder that will be hydrated\n    return `<div data-frontmcp-react data-tool=\"${context.toolName}\">${content}</div>`;\n  }\n\n  /**\n   * Render React component 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      await this.ensureReactLoaded();\n\n      if (!this.react || !this.reactDOM) {\n        throw new Error('React runtime not available');\n      }\n\n      // Try to get component from registered components\n      const componentName = target.getAttribute('data-component');\n      const component = this.getComponent(componentName, content);\n\n      if (!component) {\n        // Fall back to HTML rendering\n        target.innerHTML = content;\n        return { success: true };\n      }\n\n      // Create React element with context as props\n      const element = this.react.createElement(component, {\n        input: context.input,\n        output: context.output,\n        structuredContent: context.structuredContent,\n        toolName: context.toolName,\n      });\n\n      // Render or hydrate\n      if (options?.hydrate && this.reactDOM.hydrateRoot) {\n        const root = this.reactDOM.hydrateRoot(target, element);\n        mountedRoots.set(target, root);\n      } else if (this.reactDOM.createRoot) {\n        const root = this.reactDOM.createRoot(target);\n        root.render(element);\n        mountedRoots.set(target, root);\n      } else if (this.reactDOM.render) {\n        // Legacy React 17 API\n        this.reactDOM.render(element, target);\n        mountedRoots.set(target, {\n          unmount: () => this.reactDOM?.unmountComponentAtNode?.(target),\n        });\n      } else {\n        throw new Error('No suitable React render method available');\n      }\n\n      // Dispatch event\n      target.dispatchEvent(\n        new CustomEvent('frontmcp:rendered', {\n          bubbles: true,\n          detail: { type: 'react', toolName: context.toolName },\n        }),\n      );\n\n      return { success: true };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      console.error('[FrontMCP] React render failed:', message);\n      return { success: false, error: message };\n    }\n  }\n\n  /**\n   * Hydrate existing SSR content with React.\n   */\n  async hydrate(target: HTMLElement, context: RenderContext, options?: RenderOptions): Promise<RenderResult> {\n    return this.renderToDOM('', target, context, { ...options, hydrate: true });\n  }\n\n  /**\n   * Update rendered React component with new data.\n   */\n  async update(target: HTMLElement, context: RenderContext): Promise<RenderResult> {\n    try {\n      await this.ensureReactLoaded();\n\n      if (!this.react) {\n        throw new Error('React runtime not available');\n      }\n\n      const existingRoot = mountedRoots.get(target);\n      const componentName = target.getAttribute('data-component');\n      const component = this.getComponent(componentName, '');\n\n      if (!component) {\n        return { success: false, error: 'No component found for update' };\n      }\n\n      // Create new element with updated props\n      const element = this.react.createElement(component, {\n        input: context.input,\n        output: context.output,\n        structuredContent: context.structuredContent,\n        toolName: context.toolName,\n      });\n\n      if (existingRoot && 'render' in existingRoot) {\n        (existingRoot as { render: (el: unknown) => void }).render(element);\n        return { success: true };\n      }\n\n      // No existing root - do a fresh render\n      return this.renderToDOM('', target, context);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      console.error('[FrontMCP] React update failed:', message);\n      return { success: false, error: message };\n    }\n  }\n\n  /**\n   * Clean up React root.\n   */\n  destroy(target: HTMLElement): void {\n    const root = mountedRoots.get(target);\n    if (root) {\n      root.unmount();\n      mountedRoots.delete(target);\n    }\n  }\n\n  /**\n   * Ensure React is loaded.\n   */\n  private async ensureReactLoaded(): Promise<void> {\n    if (this.react && this.reactDOM) {\n      return;\n    }\n\n    if (this.loadPromise) {\n      return this.loadPromise;\n    }\n\n    this.loadPromise = this.loadReact();\n    return this.loadPromise;\n  }\n\n  /**\n   * Load React runtime.\n   */\n  private async loadReact(): Promise<void> {\n    // Check if React is already available globally\n    const win = typeof window !== 'undefined' ? window : (globalThis as unknown as Window);\n\n    if ((win as unknown as { React?: ReactRuntime }).React) {\n      this.react = (win as unknown as { React: ReactRuntime }).React;\n    }\n\n    if ((win as unknown as { ReactDOM?: ReactDOMRuntime }).ReactDOM) {\n      this.reactDOM = (win as unknown as { ReactDOM: ReactDOMRuntime }).ReactDOM;\n    }\n\n    if (this.react && this.reactDOM) {\n      return;\n    }\n\n    // Try to dynamically import React\n    try {\n      if (!this.react) {\n        const reactModule = await import(/* webpackIgnore: true */ 'react');\n        this.react = reactModule.default || reactModule;\n      }\n\n      if (!this.reactDOM) {\n        const reactDOMModule = await import(/* webpackIgnore: true */ 'react-dom/client');\n        this.reactDOM = reactDOMModule.default || reactDOMModule;\n      }\n    } catch {\n      // React not available via import - rely on global\n      if (!this.react || !this.reactDOM) {\n        console.warn('[FrontMCP] React runtime not available. ' + 'Ensure React is loaded via CDN or bundled.');\n      }\n    }\n  }\n\n  /**\n   * Get a React component by name or from content.\n   */\n  private getComponent(componentName: string | null, content: string): React.ComponentType<unknown> | null {\n    const win = typeof window !== 'undefined' ? window : (globalThis as unknown as Window);\n\n    // Check registered components\n    type ComponentRegistry = {\n      __frontmcp_components?: Record<string, React.ComponentType<unknown>>;\n    };\n\n    if (componentName && (win as ComponentRegistry).__frontmcp_components) {\n      const registered = (win as ComponentRegistry).__frontmcp_components?.[componentName];\n      if (registered) {\n        return registered;\n      }\n    }\n\n    // Try to evaluate content as a component (unsafe - should be pre-bundled)\n    if (content && typeof content === 'function') {\n      return content as React.ComponentType<unknown>;\n    }\n\n    return null;\n  }\n}\n\n/**\n * Create a new React renderer adapter.\n */\nexport function createReactAdapter(): ReactRendererAdapter {\n  return new ReactRendererAdapter();\n}\n\n/**\n * Adapter loader for lazy loading.\n */\nexport async function loadReactAdapter(): Promise<RendererAdapter> {\n  return createReactAdapter();\n}\n"]}