@frontmcp/ui 0.5.1 → 0.6.1

package/esm/universal/renderers/html.renderer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * HTML Renderer
+ *
+ * Renders raw HTML strings using dangerouslySetInnerHTML.
+ * Used for pre-rendered or server-side generated HTML content.
+ */
+import type { ClientRenderer } from '../types';
+/**
+ * HTML renderer implementation.
+ *
+ * Renders HTML strings directly to the DOM using dangerouslySetInnerHTML.
+ * This is the lowest priority renderer (fallback).
+ *
+ * @example
+ * ```tsx
+ * const content: UniversalContent = {
+ *   type: 'html',
+ *   source: '<div class="card"><h1>Hello</h1></div>',
+ * };
+ *
+ * // Renders: <div class="card"><h1>Hello</h1></div>
+ * ```
+ */
+export declare const htmlRenderer: ClientRenderer;
+/**
+ * Sanitize HTML string (basic XSS protection).
+ * For production use, consider using a library like DOMPurify.
+ *
+ * @param html - HTML string to sanitize
+ * @returns Sanitized HTML string
+ */
+export declare function sanitizeHtml(html: string): string;
+/**
+ * Create a safe HTML renderer that sanitizes content.
+ */
+export declare const safeHtmlRenderer: ClientRenderer;
+//# sourceMappingURL=html.renderer.d.ts.map

package/esm/universal/renderers/html.renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.renderer.d.ts","sourceRoot":"","sources":["../../../../src/universal/renderers/html.renderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,UAAU,CAAC;AAEhF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,EAAE,cAsB1B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYjD;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAsB9B,CAAC"}

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

@@ -0,0 +1,112 @@
+/**
+ * Renderer Registry
+ *
+ * Central registry for client-side renderers with auto-detection.
+ * Manages registration and selection of renderers based on content type.
+ */
+import type { ClientRenderer, UniversalContent, RenderContext, ContentType } from '../types';
+/**
+ * Client-side renderer registry.
+ *
+ * Manages renderers and provides auto-detection based on content type.
+ *
+ * @example
+ * ```typescript
+ * const registry = new RendererRegistry();
+ *
+ * // Auto-detect and get renderer
+ * const renderer = registry.detect({ type: 'markdown', source: '# Hello' });
+ *
+ * // Register custom renderer
+ * registry.register(myCustomRenderer);
+ * ```
+ */
+export declare class RendererRegistry {
+    private renderers;
+    private sortedRenderers;
+    constructor();
+    /**
+     * Register a renderer.
+     * Renderers are sorted by priority (highest first) for auto-detection.
+     */
+    register(renderer: ClientRenderer): void;
+    /**
+     * Unregister a renderer by type.
+     */
+    unregister(type: ContentType): boolean;
+    /**
+     * Get a renderer by type.
+     */
+    get(type: ContentType): ClientRenderer | undefined;
+    /**
+     * Check if a renderer type is registered.
+     */
+    has(type: ContentType): boolean;
+    /**
+     * Get all registered renderer types.
+     */
+    getTypes(): ContentType[];
+    /**
+     * Auto-detect the best renderer for content.
+     *
+     * Checks renderers in priority order (highest first).
+     * Falls back to HTML renderer if no match.
+     */
+    detect(content: UniversalContent): ClientRenderer;
+    /**
+     * Render content using auto-detection.
+     */
+    render(content: UniversalContent, context: RenderContext): React.ReactNode;
+    /**
+     * Render with a specific renderer type.
+     */
+    renderWith(type: ContentType, content: UniversalContent, context: RenderContext): React.ReactNode;
+    /**
+     * Get registry statistics.
+     */
+    getStats(): {
+        registeredTypes: ContentType[];
+        priorityOrder: Array<{
+            type: ContentType;
+            priority: number;
+        }>;
+    };
+    /**
+     * Update the sorted renderer list by priority.
+     */
+    private updateSortedList;
+}
+/**
+ * Global renderer registry instance.
+ *
+ * Pre-configured with HTML, Markdown, React, and MDX renderers.
+ */
+export declare const rendererRegistry: RendererRegistry;
+/**
+ * Detect the best renderer for content.
+ *
+ * @param content - Content to analyze
+ * @returns Best matching renderer
+ */
+export declare function detectRenderer(content: UniversalContent): ClientRenderer;
+/**
+ * Render content with auto-detection.
+ *
+ * @param content - Content to render
+ * @param context - Render context
+ * @returns Rendered React node
+ */
+export declare function renderContent(content: UniversalContent, context: RenderContext): React.ReactNode;
+/**
+ * Create content object from source with auto-detected type.
+ *
+ * @param source - Content source (string or component)
+ * @param options - Additional options
+ * @returns Content object
+ */
+export declare function createContent(source: UniversalContent['source'], options?: Partial<Omit<UniversalContent, 'source'>>): UniversalContent;
+export { htmlRenderer, safeHtmlRenderer } from './html.renderer';
+export { markdownRenderer, createMarkdownRenderer } from './markdown.renderer';
+export { reactRenderer, isReactComponent } from './react.renderer';
+export { mdxRenderer, isMdxSupported, createMdxRenderer } from './mdx.renderer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/universal/renderers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAW7F;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,eAAe,CAAwB;;IAU/C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAKxC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAQtC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS;IAIlD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAI/B;;OAEG;IACH,QAAQ,IAAI,WAAW,EAAE;IAIzB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc;IAoBjD;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,GAAG,KAAK,CAAC,SAAS;IAK1E;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,GAAG,KAAK,CAAC,SAAS;IAQjG;;OAEG;IACH,QAAQ,IAAI;QACV,eAAe,EAAE,WAAW,EAAE,CAAC;QAC/B,aAAa,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,WAAW,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/D;IAUD;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAGzB;AAMD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,kBAAyB,CAAC;AAMvD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,GAAG,KAAK,CAAC,SAAS,CAEhG;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAClC,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,GAClD,gBAAgB,CAOlB;AAOD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/esm/universal/renderers/markdown.renderer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Markdown Renderer
+ *
+ * Renders Markdown content using react-markdown.
+ * Supports custom components for enhanced rendering.
+ */
+import React from 'react';
+import type { ClientRenderer } from '../types';
+/**
+ * Markdown renderer implementation.
+ *
+ * Uses react-markdown when available, falls back to minimal inline parser.
+ *
+ * @example
+ * ```tsx
+ * const content: UniversalContent = {
+ *   type: 'markdown',
+ *   source: '# Hello\n\nThis is **bold** text.',
+ *   components: { a: CustomLink },
+ * };
+ *
+ * // Renders: <h1>Hello</h1><p>This is <strong>bold</strong> text.</p>
+ * ```
+ */
+export declare const markdownRenderer: ClientRenderer;
+/**
+ * Create a markdown renderer with custom default components.
+ *
+ * @param defaultComponents - Default components to use
+ * @returns Configured markdown renderer
+ */
+export declare function createMarkdownRenderer(defaultComponents: Record<string, React.ComponentType<any>>): ClientRenderer;
+//# sourceMappingURL=markdown.renderer.d.ts.map

package/esm/universal/renderers/markdown.renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.renderer.d.ts","sourceRoot":"","sources":["../../../../src/universal/renderers/markdown.renderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,UAAU,CAAC;AAqGhF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,EAAE,cA2D9B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAEpC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,GAC1D,cAAc,CAgBhB"}

package/esm/universal/renderers/mdx.renderer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * MDX Renderer
+ *
+ * Renders MDX content (Markdown + JSX) using @mdx-js/react.
+ * Supports custom components for enhanced rendering.
+ */
+import React from 'react';
+import type { ClientRenderer } from '../types';
+/**
+ * MDX renderer implementation.
+ *
+ * Uses @mdx-js/react when available. Falls back to warning when MDX
+ * cannot be rendered (e.g., on Claude which only supports cdnjs).
+ *
+ * @example
+ * ```tsx
+ * const content: UniversalContent = {
+ *   type: 'mdx',
+ *   source: '# Hello\n\n<WeatherCard temp={72} />',
+ *   components: { WeatherCard },
+ * };
+ * ```
+ */
+export declare const mdxRenderer: ClientRenderer;
+/**
+ * Check if MDX rendering is supported on the current platform.
+ *
+ * @returns True if MDX can be rendered
+ */
+export declare function isMdxSupported(): boolean;
+/**
+ * Create an MDX renderer with pre-configured components.
+ *
+ * @param defaultComponents - Default components for MDX
+ * @returns Configured MDX renderer
+ */
+export declare function createMdxRenderer(defaultComponents: Record<string, React.ComponentType<any>>): ClientRenderer;
+//# sourceMappingURL=mdx.renderer.d.ts.map

package/esm/universal/renderers/mdx.renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx.renderer.d.ts","sourceRoot":"","sources":["../../../../src/universal/renderers/mdx.renderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,UAAU,CAAC;AA4ChF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,EAAE,cA+FzB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAE/B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,GAC1D,cAAc,CAehB"}

package/esm/universal/renderers/react.renderer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * React Renderer
+ *
+ * Renders React components directly.
+ * Used for pre-compiled or imported React components.
+ */
+import React from 'react';
+import type { ClientRenderer } from '../types';
+/**
+ * React renderer implementation.
+ *
+ * Renders React components by creating elements with the provided props.
+ * This is the highest priority renderer when a function is provided.
+ *
+ * @example
+ * ```tsx
+ * const WeatherCard = ({ output }) => (
+ *   <div className="card">{output.temperature}°F</div>
+ * );
+ *
+ * const content: UniversalContent = {
+ *   type: 'react',
+ *   source: WeatherCard,
+ *   props: { output: { temperature: 72 } },
+ * };
+ *
+ * // Renders: <div class="card">72°F</div>
+ * ```
+ */
+export declare const reactRenderer: ClientRenderer;
+/**
+ * Check if a value is a React component.
+ *
+ * @param value - Value to check
+ * @returns True if the value is a React component
+ */
+export declare function isReactComponent(value: unknown): boolean;
+/**
+ * Wrap a component with error boundary behavior.
+ *
+ * @param Component - Component to wrap
+ * @param fallback - Fallback to render on error
+ * @returns Wrapped component
+ */
+export declare function withErrorBoundary(Component: React.ComponentType<any>, fallback?: React.ReactNode): React.ComponentType<any>;
+//# sourceMappingURL=react.renderer.d.ts.map

package/esm/universal/renderers/react.renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.renderer.d.ts","sourceRoot":"","sources":["../../../../src/universal/renderers/react.renderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,UAAU,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,aAAa,EAAE,cAgC3B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA8BxD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAE/B,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,EACnC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAEzB,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAkB1B"}

package/esm/universal/runtime-builder.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Universal Runtime Builder
+ *
+ * Generates inline JavaScript for the universal renderer.
+ * Used by bundleToStaticHTML to create self-contained HTML documents.
+ */
+import type { UniversalRuntimeOptions, UniversalRuntimeResult } from './types';
+/**
+ * Build the complete universal runtime script.
+ *
+ * @param options - Build options
+ * @returns Runtime result with script and CDN imports
+ *
+ * @example
+ * ```typescript
+ * const result = buildUniversalRuntime({
+ *   cdnType: 'esm',
+ *   includeMarkdown: true,
+ * });
+ *
+ * // result.script = complete inline runtime
+ * // result.cdnImports = CDN script tags to include in head
+ * ```
+ */
+export declare function buildUniversalRuntime(options: UniversalRuntimeOptions): UniversalRuntimeResult;
+/**
+ * Build a minimal runtime (store + basic rendering only).
+ *
+ * @param options - Build options
+ * @returns Minimal runtime script
+ */
+export declare function buildMinimalRuntime(options: Pick<UniversalRuntimeOptions, 'minify'>): string;
+//# sourceMappingURL=runtime-builder.d.ts.map

package/esm/universal/runtime-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-builder.d.ts","sourceRoot":"","sources":["../../../src/universal/runtime-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,sBAAsB,EAAW,MAAM,SAAS,CAAC;AAmZxF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CA6C9F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,GAAG,MAAM,CAa5F"}

package/esm/universal/store.d.ts

@@ -0,0 +1,135 @@
+/**
+ * FrontMCP Store
+ *
+ * Simple observable store for managing tool context and state.
+ * Uses React 18's useSyncExternalStore for subscription.
+ *
+ * @example
+ * ```typescript
+ * // Create store
+ * const store = createFrontMCPStore();
+ *
+ * // Update state
+ * store.setState({ toolName: 'get_weather', output: { temp: 72 } });
+ *
+ * // In React component
+ * const state = useFrontMCPStore();
+ * console.log(state.output);
+ * ```
+ */
+import type { FrontMCPState, FrontMCPStore, UniversalContent } from './types';
+/**
+ * Create a new FrontMCP store instance.
+ *
+ * @param initialState - Initial state values
+ * @returns Store instance with subscription support
+ */
+export declare function createFrontMCPStore(initialState?: Partial<FrontMCPState>): FrontMCPStore;
+/**
+ * Get or create the global store instance.
+ */
+export declare function getGlobalStore(): FrontMCPStore;
+/**
+ * Set the global store instance.
+ * Used for testing or custom store injection.
+ */
+export declare function setGlobalStore(store: FrontMCPStore): void;
+/**
+ * Reset the global store to a new instance.
+ */
+export declare function resetGlobalStore(initialState?: Partial<FrontMCPState>): void;
+/**
+ * Hook to access the FrontMCP store state.
+ *
+ * @param store - Optional store instance (uses global if not provided)
+ * @returns Current store state
+ *
+ * @example
+ * ```tsx
+ * function MyWidget() {
+ *   const { output, loading, error } = useFrontMCPStore();
+ *
+ *   if (loading) return <Spinner />;
+ *   if (error) return <Error message={error} />;
+ *
+ *   return <div>{output?.message}</div>;
+ * }
+ * ```
+ */
+export declare function useFrontMCPStore(store?: FrontMCPStore): FrontMCPState;
+/**
+ * Hook to access the tool output data.
+ *
+ * @param store - Optional store instance
+ * @returns Tool output (typed as T) or null
+ *
+ * @example
+ * ```tsx
+ * interface WeatherData {
+ *   temperature: number;
+ *   conditions: string;
+ * }
+ *
+ * function Weather() {
+ *   const output = useToolOutput<WeatherData>();
+ *   return <div>{output?.temperature}°F</div>;
+ * }
+ * ```
+ */
+export declare function useToolOutput<T = unknown>(store?: FrontMCPStore): T | null;
+/**
+ * Hook to access the tool input arguments.
+ *
+ * @param store - Optional store instance
+ * @returns Tool input or null
+ */
+export declare function useToolInput<T extends Record<string, unknown> = Record<string, unknown>>(store?: FrontMCPStore): T | null;
+/**
+ * Hook to access the content configuration.
+ *
+ * @param store - Optional store instance
+ * @returns Content configuration or null
+ */
+export declare function useContent(store?: FrontMCPStore): UniversalContent | null;
+/**
+ * Hook to access the tool name.
+ *
+ * @param store - Optional store instance
+ * @returns Tool name or null
+ */
+export declare function useToolName(store?: FrontMCPStore): string | null;
+/**
+ * Hook to access loading and error states.
+ *
+ * @param store - Optional store instance
+ * @returns Loading and error state
+ */
+export declare function useLoadingState(store?: FrontMCPStore): {
+    loading: boolean;
+    error: string | null;
+};
+/**
+ * Initialize store from window.__frontmcp data.
+ * Used by the inline runtime to hydrate the store.
+ *
+ * @param store - Store instance to initialize
+ */
+export declare function initializeStoreFromWindow(store?: FrontMCPStore): void;
+/**
+ * Create a store selector for derived state.
+ *
+ * @param selector - Function to select derived state
+ * @returns Hook that returns the selected state
+ *
+ * @example
+ * ```tsx
+ * const useTemperature = createStoreSelector((state) => state.output?.temperature);
+ *
+ * function Temperature() {
+ *   const temp = useTemperature();
+ *   return <div>{temp}°F</div>;
+ * }
+ * ```
+ */
+export declare function createStoreSelector<T>(selector: (state: FrontMCPState) => T): (store?: FrontMCPStore) => T;
+//# sourceMappingURL=store.d.ts.map

package/esm/universal/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/universal/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAO9E;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CA6CxF;AAYD;;GAEG;AACH,wBAAgB,cAAc,IAAI,aAAa,CAK9C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAE5E;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,aAAa,CAIrE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,CAAC,GAAG,IAAI,CAG1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtF,KAAK,CAAC,EAAE,aAAa,GACpB,CAAC,GAAG,IAAI,CAGV;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,gBAAgB,GAAG,IAAI,CAGzE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAGjG;AAMD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAiBrE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,aAAa,KAAK,CAAC,CAK1G"}

package/esm/universal/types.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Universal Renderer Types
+ *
+ * Core types for the multi-format client-side rendering system.
+ * Supports HTML, Markdown, React, and MDX content types with
+ * auto-detection and custom component injection.
+ */
+/**
+ * Supported content types for the universal renderer.
+ *
+ * - 'html': Raw HTML string (rendered with dangerouslySetInnerHTML)
+ * - 'markdown': Markdown content (rendered with react-markdown)
+ * - 'react': React component (rendered directly)
+ * - 'mdx': MDX content (rendered with @mdx-js/react)
+ */
+export type ContentType = 'html' | 'markdown' | 'react' | 'mdx';
+/**
+ * Content configuration for the universal renderer.
+ */
+export interface UniversalContent {
+    /** Content type for auto-detection override */
+    type: ContentType;
+    /** Source content - string for HTML/Markdown/MDX, component for React */
+    source: string | React.ComponentType<any>;
+    /** Props to pass to React/MDX components */
+    props?: Record<string, unknown>;
+    /** Custom components available in Markdown/MDX content */
+    components?: Record<string, React.ComponentType<any>>;
+}
+/**
+ * FrontMCP store state shape.
+ * Provides tool context and loading/error states.
+ */
+export interface FrontMCPState {
+    /** Tool name from MCP context */
+    toolName: string | null;
+    /** Tool input arguments */
+    input: Record<string, unknown> | null;
+    /** Tool output data */
+    output: unknown | null;
+    /** Content configuration for rendering */
+    content: UniversalContent | null;
+    /** Structured content parsed from output */
+    structuredContent: unknown | null;
+    /** Whether data is currently loading */
+    loading: boolean;
+    /** Error message if loading failed */
+    error: string | null;
+}
+/**
+ * Default initial state for the FrontMCP store.
+ */
+export declare const DEFAULT_FRONTMCP_STATE: FrontMCPState;
+/**
+ * Store interface with subscription support.
+ */
+export interface FrontMCPStore {
+    /** Get current state snapshot */
+    getState(): FrontMCPState;
+    /** Get server-side state (for SSR) */
+    getServerState(): FrontMCPState;
+    /** Update state with partial values */
+    setState(partial: Partial<FrontMCPState>): void;
+    /** Subscribe to state changes */
+    subscribe(listener: () => void): () => void;
+    /** Reset state to initial values */
+    reset(): void;
+}
+/**
+ * Render context passed to client-side renderers.
+ */
+export interface RenderContext {
+    /** Tool output data */
+    output: unknown;
+    /** Tool input data */
+    input: Record<string, unknown> | null;
+    /** Custom components available for rendering */
+    components: Record<string, React.ComponentType<any>>;
+    /** Full store state */
+    state: FrontMCPState;
+}
+/**
+ * Client-side renderer interface.
+ * Each renderer handles a specific content type.
+ */
+export interface ClientRenderer {
+    /** Content type this renderer handles */
+    readonly type: ContentType;
+    /** Priority for auto-detection (higher = checked first) */
+    readonly priority: number;
+    /**
+     * Check if this renderer can handle the given content.
+     */
+    canHandle(content: UniversalContent): boolean;
+    /**
+     * Render the content to React elements.
+     */
+    render(content: UniversalContent, context: RenderContext): React.ReactNode;
+}
+/**
+ * Props for the UniversalApp component.
+ */
+export interface UniversalAppProps {
+    /** Content to render (overrides store content) */
+    content?: UniversalContent;
+    /** Custom components available for rendering */
+    components?: Record<string, React.ComponentType<any>>;
+    /** Loading fallback component */
+    fallback?: React.ReactNode;
+    /** Error fallback component */
+    errorFallback?: React.ComponentType<{
+        error: string;
+    }>;
+}
+/**
+ * Props for the FrontMCPProvider component.
+ */
+export interface FrontMCPProviderProps {
+    /** Store instance to provide */
+    store?: FrontMCPStore;
+    /** Initial state override */
+    initialState?: Partial<FrontMCPState>;
+    /** Children to render (optional when using React.createElement) */
+    children?: React.ReactNode;
+}
+/**
+ * CDN type for runtime script loading.
+ */
+export type CDNType = 'esm' | 'umd';
+/**
+ * Content security options for XSS protection.
+ */
+export interface ContentSecurityOptions {
+    /**
+     * Allow unsafe URL schemes (javascript:, data:, vbscript:) in links.
+     * @default false
+     */
+    allowUnsafeLinks?: boolean;
+    /**
+     * Allow inline <script> tags and event handlers.
+     * @default false
+     */
+    allowInlineScripts?: boolean;
+    /**
+     * Bypass all sanitization (dangerous!).
+     * @default false
+     */
+    bypassSanitization?: boolean;
+}
+/**
+ * Options for building the universal runtime script.
+ */
+export interface UniversalRuntimeOptions {
+    /** CDN type to use for external dependencies */
+    cdnType: CDNType;
+    /** Include markdown renderer (react-markdown) */
+    includeMarkdown?: boolean;
+    /** Include MDX renderer (@mdx-js/react) */
+    includeMdx?: boolean;
+    /** Custom components to include (as inline JavaScript) */
+    customComponents?: string;
+    /** Minify the output */
+    minify?: boolean;
+    /** Content security / XSS protection options */
+    contentSecurity?: ContentSecurityOptions;
+}
+/**
+ * Result from building the universal runtime.
+ */
+export interface UniversalRuntimeResult {
+    /** Complete runtime script (including store, renderers, app) */
+    script: string;
+    /** CDN imports to include in head */
+    cdnImports: string;
+    /** Size of the runtime in bytes */
+    size: number;
+}
+/**
+ * CDN URLs for universal renderer dependencies.
+ */
+export declare const UNIVERSAL_CDN: {
+    readonly esm: {
+        readonly reactMarkdown: "https://esm.sh/react-markdown@9";
+        readonly mdxReact: "https://esm.sh/@mdx-js/react@3";
+        readonly remarkGfm: "https://esm.sh/remark-gfm@4";
+    };
+};
+/**
+ * Detect content type from source content.
+ *
+ * Detection priority:
+ * 1. React component function -> 'react'
+ * 2. Module code (import/export) with JSX -> 'react' (needs transpilation)
+ * 3. Markdown with JSX components -> 'mdx' (render with MDX renderer)
+ * 4. Pure markdown -> 'markdown'
+ * 5. Default -> 'html'
+ */
+export declare function detectContentType(source: unknown): ContentType;
+//# sourceMappingURL=types.d.ts.map

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

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