@frontmcp/ui 0.5.1 → 0.6.0

package/esm/build/widget-manifest.d.ts

@@ -0,0 +1,362 @@
+/**
+ * Widget Manifest Builder
+ *
+ * Builds static widget wrappers with embedded manifests for tool UIs.
+ * Produces complete HTML documents with FrontMCP Bridge runtime.
+ *
+ * @packageDocumentation
+ */
+import type { UIType, ResourceMode, OutputMode, CSPDirectives, RendererAssets, WidgetConfig, BuildManifestResult, BuildManifestOptions, ToolResponseMeta } from '../types/ui-runtime';
+import type { ThemeConfig } from '../theme';
+import type { CDNPlatformType, ComponentBuildManifest } from '../dependency/types';
+/**
+ * Check if a template is a file path.
+ *
+ * @param template - Widget template
+ * @returns true if the template is a file path
+ */
+export declare function isFilePathTemplate(template: unknown): template is string;
+/**
+ * Check if a template is a URL.
+ *
+ * @param template - Widget template
+ * @returns true if the template is a URL
+ */
+export declare function isUrlTemplate(template: unknown): template is string;
+/**
+ * Check if a template is file-based (either file path or URL).
+ *
+ * @param template - Widget template
+ * @returns true if the template is file-based
+ */
+export declare function isFileBasedTemplate(template: unknown): template is string;
+/**
+ * Detect the UI type from a template.
+ *
+ * @param template - Widget template
+ * @returns Detected UI type
+ */
+export declare function detectUIType(template: WidgetConfig['template']): UIType;
+/**
+ * Build CSP directives for a UI type.
+ *
+ * @param uiType - UI renderer type
+ * @param userCsp - User-provided CSP overrides
+ * @returns Complete CSP directives
+ */
+export declare function buildCSPForType(uiType: UIType, userCsp?: Partial<CSPDirectives>): CSPDirectives;
+/**
+ * Build CSP meta tag content.
+ */
+export declare function buildCSPMetaContent(csp: CSPDirectives): string;
+/**
+ * Get renderer assets for a UI type.
+ *
+ * @param uiType - UI renderer type
+ * @param resourceMode - Resource loading mode (cdn or inline)
+ * @returns Required renderer assets with CDN URLs or inline placeholders
+ *
+ * @example
+ * ```typescript
+ * // Get CDN-based assets for React
+ * const assets = getRendererAssets('react', 'cdn');
+ * console.log(assets.react?.url);
+ * // "https://unpkg.com/react@18/umd/react.production.min.js"
+ *
+ * // Get inline-mode assets
+ * const inlineAssets = getRendererAssets('react', 'inline');
+ * // inlineAssets.mode === 'inline'
+ * ```
+ */
+export declare function getRendererAssets(uiType: UIType, resourceMode?: ResourceMode): RendererAssets;
+/**
+ * Build a widget manifest for a tool.
+ *
+ * Creates a static widget wrapper with embedded manifest.
+ * The widget can be cached and reused across tool invocations.
+ *
+ * @param options - Build options
+ * @returns Build result with HTML, manifest, and metadata
+ *
+ * @example
+ * ```typescript
+ * import { buildToolWidgetManifest } from '@frontmcp/ui/build';
+ *
+ * const result = await buildToolWidgetManifest({
+ *   toolName: 'weather.get',
+ *   uiConfig: {
+ *     template: WeatherWidget,
+ *     uiType: 'react',
+ *     displayMode: 'inline',
+ *     widgetAccessible: true,
+ *   },
+ *   schema: { type: 'object', properties: { ... } },
+ * });
+ *
+ * // Cache the HTML
+ * cache.set(`ui://widget/${result.manifest.tool}.html`, result.html);
+ * ```
+ */
+export declare function buildToolWidgetManifest<Input = Record<string, unknown>, Output = unknown>(options: BuildManifestOptions<Input, Output>): Promise<BuildManifestResult>;
+/**
+ * Options for batch building multiple widgets.
+ */
+export interface BatchBuildOptions {
+    /**
+     * Array of tool configurations to build.
+     */
+    tools: Array<{
+        toolName: string;
+        uiConfig: WidgetConfig;
+        schema?: object;
+    }>;
+    /**
+     * Theme configuration to apply to all widgets.
+     */
+    theme?: ThemeConfig;
+    /**
+     * Enable parallel building.
+     * @default true
+     */
+    parallel?: boolean;
+}
+/**
+ * Result of batch building.
+ */
+export interface BatchBuildResult {
+    /**
+     * Individual build results keyed by tool name.
+     */
+    results: Map<string, BuildManifestResult>;
+    /**
+     * Total build time in ms.
+     */
+    totalTime: number;
+    /**
+     * Number of successful builds.
+     */
+    successCount: number;
+    /**
+     * Errors encountered (keyed by tool name).
+     */
+    errors: Map<string, Error>;
+}
+/**
+ * Build multiple widget manifests in batch.
+ *
+ * @param options - Batch build options
+ * @returns Batch build results
+ *
+ * @example
+ * ```typescript
+ * const { results, errors } = await batchBuildWidgets({
+ *   tools: [
+ *     { toolName: 'weather.get', uiConfig: weatherConfig },
+ *     { toolName: 'stock.quote', uiConfig: stockConfig },
+ *   ],
+ * });
+ *
+ * for (const [name, result] of results) {
+ *   cache.set(result.manifest.uri, result.html);
+ * }
+ * ```
+ */
+export declare function batchBuildWidgets(options: BatchBuildOptions): Promise<BatchBuildResult>;
+/**
+ * Options for building tool response _meta fields.
+ */
+export interface BuildMetaOptions {
+    /**
+     * Build result from buildToolWidgetManifest.
+     */
+    buildResult: BuildManifestResult;
+    /**
+     * Output mode - determines which content to include.
+     * - 'code-only': Include ui/content (transpiled code only)
+     * - 'full-ssr': Include ui/html (complete HTML document)
+     *
+     * @default 'code-only'
+     */
+    outputMode?: OutputMode;
+    /**
+     * Include OpenAI-specific meta fields.
+     * @default true
+     */
+    includeOpenAI?: boolean;
+}
+/**
+ * Build _meta fields for a tool response.
+ *
+ * This function generates the proper _meta structure for UI widgets.
+ * All UI-related data goes in _meta, NOT in the content array.
+ *
+ * @param options - Build options
+ * @returns _meta fields object to spread into tool response
+ *
+ * @example
+ * ```typescript
+ * const buildResult = await buildToolWidgetManifest({...});
+ *
+ * // For OpenAI (code-only mode)
+ * const meta = buildToolResponseMeta({
+ *   buildResult,
+ *   outputMode: 'code-only',
+ * });
+ *
+ * return {
+ *   content: [{ type: 'text', text: 'Weather retrieved' }],
+ *   _meta: meta,
+ * };
+ *
+ * // For unknown clients (full-ssr mode)
+ * const meta = buildToolResponseMeta({
+ *   buildResult,
+ *   outputMode: 'full-ssr',
+ * });
+ * ```
+ */
+export declare function buildToolResponseMeta(options: BuildMetaOptions): ToolResponseMeta;
+/**
+ * Determine the appropriate output mode based on client info.
+ *
+ * Platform capabilities:
+ * - OpenAI/ChatGPT/Cursor: Can load CDN scripts, use 'code-only' (smaller payload)
+ * - Claude: Sandboxed artifacts block ALL external requests, MUST use 'full-ssr' (embedded HTML)
+ * - Unknown: Default to 'full-ssr' for maximum compatibility
+ *
+ * @param clientInfo - MCP client information
+ * @returns Recommended output mode
+ *
+ * @example
+ * ```typescript
+ * const outputMode = getOutputModeForClient(request.clientInfo);
+ * const meta = buildToolResponseMeta({ buildResult, outputMode });
+ * ```
+ */
+export declare function getOutputModeForClient(clientInfo?: {
+    name?: string;
+    version?: string;
+}): OutputMode;
+/**
+ * Options for building a file-based UI component.
+ */
+export interface FileComponentBuildOptions {
+    /**
+     * File path to the component entry point.
+     * @example './widgets/chart.tsx'
+     */
+    entryPath: string;
+    /**
+     * Tool name for this component.
+     */
+    toolName: string;
+    /**
+     * Packages to load from CDN.
+     */
+    externals?: string[];
+    /**
+     * Explicit CDN dependency overrides.
+     */
+    dependencies?: Record<string, import('../dependency/types').CDNDependency>;
+    /**
+     * Bundle options.
+     */
+    bundleOptions?: import('../dependency/types').FileBundleOptions;
+    /**
+     * Target platform for CDN selection.
+     * @default 'unknown'
+     */
+    platform?: CDNPlatformType;
+    /**
+     * Whether to skip cache lookup.
+     * @default false
+     */
+    skipCache?: boolean;
+}
+/**
+ * Result of a file-based component build.
+ */
+export interface FileComponentBuildResult {
+    /**
+     * The build manifest.
+     */
+    manifest: ComponentBuildManifest;
+    /**
+     * Complete HTML with dependencies and component code.
+     */
+    html: string;
+    /**
+     * Whether the result came from cache.
+     */
+    cached: boolean;
+    /**
+     * Build time in milliseconds.
+     */
+    buildTimeMs: number;
+}
+/**
+ * Build a file-based UI component.
+ *
+ * This function handles the complete build pipeline for file-based templates:
+ * 1. Check cache for existing build
+ * 2. Parse entry file for imports
+ * 3. Resolve external dependencies to CDN URLs
+ * 4. Bundle the component with esbuild
+ * 5. Generate import map for CDN dependencies
+ * 6. Store result in cache
+ *
+ * @param options - Build options
+ * @returns Build result with manifest and HTML
+ *
+ * @example
+ * ```typescript
+ * const result = await buildFileComponent({
+ *   entryPath: './widgets/chart.tsx',
+ *   toolName: 'chart_display',
+ *   externals: ['chart.js', 'react-chartjs-2'],
+ *   platform: 'claude',
+ * });
+ *
+ * // Use the HTML in tool response
+ * return {
+ *   content: [{ type: 'text', text: 'Chart rendered' }],
+ *   _meta: {
+ *     'ui/html': result.html,
+ *     'ui/hash': result.manifest.contentHash,
+ *   },
+ * };
+ * ```
+ */
+export declare function buildFileComponent(options: FileComponentBuildOptions): Promise<FileComponentBuildResult>;
+/**
+ * Build multiple file-based components.
+ *
+ * @param options - Array of build options
+ * @returns Array of build results
+ */
+export declare function buildFileComponents(options: FileComponentBuildOptions[]): Promise<FileComponentBuildResult[]>;
+/**
+ * Check if a file-based component needs rebuilding.
+ *
+ * @param options - Build options (without skipCache)
+ * @returns true if the component needs rebuilding
+ */
+export declare function needsFileComponentRebuild(options: Omit<FileComponentBuildOptions, 'skipCache'>): Promise<boolean>;
+/**
+ * Get a cached file-based component build.
+ *
+ * @param options - Build options
+ * @returns Cached manifest or undefined
+ */
+export declare function getCachedFileComponent(options: Omit<FileComponentBuildOptions, 'skipCache' | 'toolName'>): Promise<ComponentBuildManifest | undefined>;
+/**
+ * Map MCP client info to platform type.
+ *
+ * @param clientInfo - MCP client information
+ * @returns Platform type for CDN selection
+ */
+export declare function getPlatformFromClientInfo(clientInfo?: {
+    name?: string;
+    version?: string;
+}): CDNPlatformType;
+//# sourceMappingURL=widget-manifest.d.ts.map

package/esm/build/widget-manifest.d.ts.map

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

package/esm/bundler/bundler.d.ts

@@ -0,0 +1,208 @@
+/**
+ * In-Memory Bundler
+ *
+ * Fast, secure bundler for JSX/TSX/MDX sources using esbuild.
+ * Provides caching, security validation, and SSR support.
+ *
+ * @packageDocumentation
+ */
+import type { BundleOptions, BundleResult, SSRBundleOptions, SSRResult, BundlerOptions, StaticHTMLOptions, StaticHTMLResult } from './types';
+/**
+ * In-memory bundler for JSX/TSX/MDX sources.
+ *
+ * Features:
+ * - Fast transformation using esbuild (fallback to SWC)
+ * - Content-addressable caching
+ * - Security validation (blocked imports, eval, etc.)
+ * - SSR support for React components
+ *
+ * @example
+ * ```typescript
+ * const bundler = new InMemoryBundler();
+ *
+ * // Bundle JSX source
+ * const result = await bundler.bundle({
+ *   source: 'const App = () => <div>Hello</div>; export default App;',
+ *   sourceType: 'jsx',
+ * });
+ *
+ * console.log(result.code); // Bundled JavaScript
+ * console.log(result.cached); // Whether from cache
+ *
+ * // SSR rendering
+ * const ssrResult = await bundler.bundleSSR({
+ *   source: 'export default ({ data }) => <div>{data.message}</div>',
+ *   sourceType: 'jsx',
+ *   context: { data: { message: 'Hello' } },
+ * });
+ *
+ * console.log(ssrResult.html); // Rendered HTML
+ * ```
+ */
+export declare class InMemoryBundler {
+    private readonly cache;
+    private readonly options;
+    private readonly defaultSecurity;
+    constructor(options?: BundlerOptions);
+    /**
+     * Bundle source code.
+     *
+     * @param options - Bundle options
+     * @returns Bundle result
+     */
+    bundle(options: BundleOptions): Promise<BundleResult>;
+    /**
+     * Bundle and execute for SSR.
+     *
+     * @param options - SSR bundle options
+     * @returns SSR result with rendered HTML
+     */
+    bundleSSR(options: SSRBundleOptions): Promise<SSRResult>;
+    /**
+     * Bundle and execute code, returning the exports.
+     *
+     * @param options - Bundle options
+     * @param context - Execution context
+     * @returns Exported value
+     */
+    bundleAndExecute<T = unknown>(options: BundleOptions, context?: Record<string, unknown>): Promise<T>;
+    /**
+     * Bundle a component to a self-contained static HTML document.
+     *
+     * Creates a complete HTML page with:
+     * - React runtime (CDN or inline based on platform)
+     * - FrontMCP UI hooks and components (always inline)
+     * - Tool data injection (input/output)
+     * - Transpiled component code
+     * - Client-side rendering via createRoot
+     *
+     * @param options - Static HTML options
+     * @returns Static HTML result with complete document
+     *
+     * @example
+     * ```typescript
+     * const result = await bundler.bundleToStaticHTML({
+     *   source: `
+     *     import { Card, useToolOutput } from '@frontmcp/ui/react';
+     *     export default function Weather() {
+     *       const output = useToolOutput();
+     *       return <Card title="Weather">{output?.temperature}°F</Card>;
+     *     }
+     *   `,
+     *   toolName: 'get_weather',
+     *   output: { temperature: 72 },
+     * });
+     *
+     * // result.html contains the complete HTML document
+     * ```
+     */
+    bundleToStaticHTML(options: StaticHTMLOptions): Promise<StaticHTMLResult>;
+    /**
+     * Bundle to static HTML with universal rendering mode.
+     * Uses the universal renderer that can handle multiple content types.
+     *
+     * Optimization: Uses cached runtime (vendor chunk) to avoid rebuilding
+     * static code on every request. Only the user's component is transpiled.
+     */
+    private bundleToStaticHTMLUniversal;
+    /**
+     * Assemble the complete universal static HTML document using cached runtime.
+     *
+     * For ESM mode (OpenAI), scripts must wait for React to load asynchronously.
+     * For UMD mode (Claude), scripts can execute synchronously.
+     */
+    private assembleUniversalStaticHTMLCached;
+    /**
+     * Build the component script for transpiled React/MDX content.
+     * Wraps CommonJS code with module/exports shim to capture the component.
+     */
+    private buildUniversalComponentScript;
+    /**
+     * Build the universal runtime script section.
+     */
+    private buildUniversalRuntimeScript;
+    /**
+     * Build data injection script for universal mode.
+     */
+    private buildUniversalDataScript;
+    /**
+     * Build the universal render script.
+     */
+    private buildUniversalRenderScript;
+    /**
+     * Assemble the complete universal static HTML document.
+     */
+    private assembleUniversalStaticHTML;
+    /**
+     * Get cache statistics.
+     */
+    getCacheStats(): import("./cache").CacheStats;
+    /**
+     * Clear the cache.
+     */
+    clearCache(): void;
+    /**
+     * Clean up expired cache entries.
+     */
+    cleanupCache(): number;
+    /**
+     * Transform source code using esbuild/SWC.
+     */
+    private transform;
+    /**
+     * Get esbuild loader for source type.
+     */
+    private getLoader;
+    /**
+     * Detect source type from content.
+     */
+    private detectSourceType;
+    /**
+     * Merge bundle options with defaults.
+     */
+    private mergeOptions;
+    /**
+     * Build hydration script for client-side React.
+     */
+    private buildHydrationScript;
+    /**
+     * Merge static HTML options with defaults.
+     */
+    private mergeStaticHTMLOptions;
+    /**
+     * Build the <head> section for static HTML.
+     */
+    private buildStaticHTMLHead;
+    /**
+     * Build React runtime scripts for static HTML.
+     */
+    private buildReactRuntimeScripts;
+    /**
+     * Build FrontMCP runtime (hooks and UI components).
+     * Always inlined for reliability across platforms.
+     */
+    private buildFrontMCPRuntime;
+    /**
+     * Build data injection script for tool input/output.
+     */
+    private buildDataInjectionScript;
+    /**
+     * Build component render script.
+     * Wraps CommonJS code with module/exports shim to capture the component.
+     */
+    private buildComponentRenderScript;
+    /**
+     * Assemble the complete static HTML document.
+     */
+    private assembleStaticHTML;
+}
+/**
+ * Create a bundler instance with default options.
+ *
+ * @param options - Bundler configuration
+ * @returns New bundler instance
+ */
+export declare function createBundler(options?: BundlerOptions): InMemoryBundler;
+export { SecurityError } from './sandbox/policy';
+export { ExecutionError } from './sandbox/executor';
+//# sourceMappingURL=bundler.d.ts.map

package/esm/bundler/bundler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../../src/bundler/bundler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,cAAc,EAId,iBAAiB,EACjB,gBAAgB,EAIjB,MAAM,SAAS,CAAC;AAkGjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;gBAErC,OAAO,GAAE,cAAmB;IAkBxC;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAmE3D;;;;;OAKG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IA6D9D;;;;;;OAMG;IACG,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAuB1G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+D/E;;;;;;OAMG;YACW,2BAA2B;IAsGzC;;;;;OAKG;IACH,OAAO,CAAC,iCAAiC;IA+EzC;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAuCrC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAQnC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA2DhC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAuClC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAkCnC;;OAEG;IACH,aAAa;IAIb;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;YACW,SAAS;IAoCvB;;OAEG;IACH,OAAO,CAAC,SAAS;IAejB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsCxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgC5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkD9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwC3B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAqEhC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA+J5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAgChC;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IA6ElC;;OAEG;IACH,OAAO,CAAC,kBAAkB;CA4B3B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,eAAe,CAEvE;AAGD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}