@frontmcp/ui 0.12.2 → 1.0.0-beta.1

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

@@ -1,36 +0,0 @@
-/**
- * HTML Renderer
- *
- * Renders raw HTML strings using dangerouslySetInnerHTML.
- * Used for pre-rendered or server-side generated HTML content.
- */
-import type { ClientRenderer } from '../types';
-import { sanitizeHtmlContent } from '@frontmcp/uipack/runtime';
-/**
- * Re-export sanitizeHtmlContent as sanitizeHtml for backward compatibility.
- * Uses DOMPurify in browser environments for robust sanitization.
- */
-export declare const sanitizeHtml: typeof sanitizeHtmlContent;
-/**
- * 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;
-/**
- * Create a safe HTML renderer that sanitizes content.
- * Uses DOMPurify in browser environments for robust protection against XSS.
- */
-export declare const safeHtmlRenderer: ClientRenderer;
-//# sourceMappingURL=html.renderer.d.ts.map

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

@@ -1 +0,0 @@
-{"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;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,YAAY,4BAAsB,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,EAAE,cAsB1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAsB9B,CAAC"}

package/universal/renderers/index.d.ts

@@ -1,112 +0,0 @@
-/**
- * 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/universal/renderers/index.d.ts.map

@@ -1 +0,0 @@
-{"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/universal/renderers/markdown.renderer.d.ts

@@ -1,33 +0,0 @@
-/**
- * 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/universal/renderers/markdown.renderer.d.ts.map

@@ -1 +0,0 @@
-{"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/universal/renderers/mdx.renderer.d.ts

@@ -1,38 +0,0 @@
-/**
- * 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/universal/renderers/mdx.renderer.d.ts.map

@@ -1 +0,0 @@
-{"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/universal/renderers/react.renderer.d.ts

@@ -1,46 +0,0 @@
-/**
- * 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/universal/renderers/react.renderer.d.ts.map

@@ -1 +0,0 @@
-{"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/universal/runtime-builder.d.ts

@@ -1,33 +0,0 @@
-/**
- * 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/universal/runtime-builder.d.ts.map

@@ -1 +0,0 @@
-{"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,EAAE,MAAM,SAAS,CAAC;AAmZ/E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAgD9F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,GAAG,MAAM,CAe5F"}

package/universal/store.d.ts

@@ -1,135 +0,0 @@
-/**
- * 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/universal/store.d.ts.map

@@ -1 +0,0 @@
-{"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/universal/types.d.ts

@@ -1,199 +0,0 @@
-/**
- * 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/universal/types.d.ts.map

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