@frontmcp/ui 0.5.0

package/src/build/index.d.ts

@@ -0,0 +1,294 @@
+/**
+ * Build-Time API for Tool UI
+ *
+ * Provides pre-compilation capabilities for tool UI templates.
+ * Produces a **universal HTML document** that works across all platforms:
+ * - OpenAI ChatGPT (Apps SDK)
+ * - Anthropic Claude
+ * - MCP Apps (ext-apps / SEP-1865)
+ * - Google Gemini
+ * - Any MCP-compatible host
+ *
+ * The build embeds the FrontMCP Bridge which auto-detects the host
+ * at runtime and adapts its communication protocol accordingly.
+ *
+ * @packageDocumentation
+ */
+import type { UITemplateConfig } from '../types';
+import type { ThemeConfig, DeepPartial } from '../theme';
+/**
+ * Network access mode for the target environment.
+ *
+ * - `'open'`: Can fetch external resources (CDN scripts, fonts)
+ * - `'blocked'`: Network is sandboxed, must inline everything
+ */
+export type NetworkMode = 'open' | 'blocked';
+/**
+ * Script loading strategy.
+ *
+ * - `'cdn'`: Load scripts from CDN (smaller HTML, requires network)
+ * - `'inline'`: Embed scripts in HTML (larger, works offline)
+ * - `'auto'`: Choose based on network mode
+ */
+export type ScriptStrategy = 'cdn' | 'inline' | 'auto';
+/**
+ * Build configuration options.
+ * Capability-based rather than platform-specific.
+ */
+export interface BuildConfig {
+    /**
+     * Network access mode.
+     * @default 'open'
+     */
+    network?: NetworkMode;
+    /**
+     * Script loading strategy.
+     * @default 'auto' (uses 'inline' if network is 'blocked')
+     */
+    scripts?: ScriptStrategy;
+    /**
+     * Whether to include the FrontMCP Bridge runtime.
+     * The bridge auto-detects the host platform at runtime.
+     * @default true
+     */
+    includeBridge?: boolean;
+    /**
+     * Whether to minify the output HTML.
+     * @default false
+     */
+    minify?: boolean;
+}
+/**
+ * Options for building a tool UI template.
+ *
+ * @example
+ * ```typescript
+ * const result = await buildToolUI({
+ *   template: {
+ *     template: (ctx) => `<div>${ctx.output.value}</div>`,
+ *     widgetAccessible: true,
+ *   },
+ *   toolName: 'my_tool',
+ *   input: { query: 'hello' },
+ *   output: { value: 'world' },
+ * });
+ *
+ * // Universal HTML that works on any platform
+ * console.log(result.html);
+ * ```
+ */
+export interface BuildOptions<In = unknown, Out = unknown> {
+    /**
+     * UI template configuration.
+     */
+    template: UITemplateConfig<In, Out>;
+    /**
+     * Name of the tool this UI is for.
+     */
+    toolName: string;
+    /**
+     * Tool input arguments.
+     */
+    input?: In;
+    /**
+     * Tool output/result data.
+     */
+    output?: Out;
+    /**
+     * Theme configuration override.
+     */
+    theme?: DeepPartial<ThemeConfig>;
+    /**
+     * Build configuration.
+     * Controls network mode, script strategy, etc.
+     */
+    config?: BuildConfig;
+    /**
+     * Title for the HTML document.
+     */
+    title?: string;
+    /** @deprecated Use `input` instead */
+    sampleInput?: In;
+    /** @deprecated Use `output` instead */
+    sampleOutput?: Out;
+    /** @deprecated Use `config.includeBridge` instead */
+    injectAdapters?: boolean;
+    /** @deprecated Use `config.minify` instead */
+    minify?: boolean;
+    /** @deprecated Platform is now auto-detected at runtime */
+    platform?: string;
+}
+/**
+ * MIME types for different host platforms.
+ * Returned as suggestions - the MCP server response layer decides which to use.
+ */
+export interface MimeTypes {
+    /** For OpenAI ChatGPT Apps SDK */
+    openai: 'text/html+skybridge';
+    /** For Claude, MCP Apps, and standard MCP hosts */
+    mcp: 'text/html+mcp';
+    /** Generic HTML (fallback) */
+    html: 'text/html';
+}
+/**
+ * Result of building a tool UI template.
+ */
+export interface BuildResult {
+    /**
+     * Complete HTML document string.
+     * This is universal - works on all platforms.
+     */
+    html: string;
+    /**
+     * Size of the HTML in bytes.
+     */
+    size: number;
+    /**
+     * Size of the gzipped HTML in bytes (estimated).
+     */
+    gzipSize: number;
+    /**
+     * SHA-256 hash of the HTML content.
+     */
+    hash: string;
+    /**
+     * Suggested MIME types for different hosts.
+     * The MCP server response layer should select based on detected client.
+     */
+    mimeTypes: MimeTypes;
+    /**
+     * Renderer type used (html, react, mdx).
+     */
+    rendererType: string;
+    /**
+     * Build timestamp (ISO 8601).
+     */
+    buildTime: string;
+    /**
+     * Build configuration used.
+     */
+    config: Required<BuildConfig>;
+}
+/**
+ * Build a tool UI template into a universal HTML document.
+ *
+ * The output HTML:
+ * - Works on ALL platforms (OpenAI, Claude, MCP Apps, Gemini, etc.)
+ * - Includes FrontMCP Bridge that auto-detects the host at runtime
+ * - Adapts communication protocol based on detected platform
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { buildToolUI } from '@frontmcp/ui/build';
+ *
+ * const result = await buildToolUI({
+ *   template: { template: WeatherWidget },
+ *   toolName: 'get_weather',
+ *   output: { temperature: 72, conditions: 'sunny' },
+ * });
+ *
+ * // Upload to CDN - works everywhere
+ * await uploadToCDN('widgets/get_weather.html', result.html);
+ * ```
+ *
+ * @example With blocked network (for Claude Artifacts)
+ * ```typescript
+ * const result = await buildToolUI({
+ *   template: { template: WeatherWidget },
+ *   toolName: 'get_weather',
+ *   config: { network: 'blocked' }, // Inlines all scripts
+ * });
+ * ```
+ *
+ * @example MCP server response
+ * ```typescript
+ * const result = await buildToolUI({ template, toolName, output });
+ *
+ * // In MCP server - choose MIME type based on client
+ * const mimeType = isOpenAIClient(clientInfo)
+ *   ? result.mimeTypes.openai  // 'text/html+skybridge'
+ *   : result.mimeTypes.mcp;    // 'text/html+mcp'
+ *
+ * return { content: [{ type: mimeType, data: result.html }] };
+ * ```
+ */
+export declare function buildToolUI<In = unknown, Out = unknown>(options: BuildOptions<In, Out>): Promise<BuildResult>;
+/**
+ * Options for building a static widget that reads from host at runtime.
+ */
+export interface StaticWidgetOptions<In = unknown, Out = unknown> {
+    /**
+     * UI template configuration.
+     */
+    template: UITemplateConfig<In, Out>;
+    /**
+     * Name of the tool this UI is for.
+     */
+    toolName: string;
+    /**
+     * Theme configuration override.
+     */
+    theme?: DeepPartial<ThemeConfig>;
+    /**
+     * Build configuration.
+     */
+    config?: BuildConfig;
+    /**
+     * Title for the HTML document.
+     */
+    title?: string;
+}
+/**
+ * Build a static widget that reads data from the host platform at runtime.
+ *
+ * Unlike buildToolUI which pre-renders with data, this creates a widget
+ * that waits for data from the host platform via the FrontMCP Bridge.
+ *
+ * @example
+ * ```typescript
+ * import { buildStaticWidget } from '@frontmcp/ui/build';
+ *
+ * const widget = await buildStaticWidget({
+ *   template: {
+ *     template: (ctx) => `<div id="weather">${ctx.output?.temperature || 'Loading...'}</div>`,
+ *   },
+ *   toolName: 'get_weather',
+ * });
+ *
+ * // This widget will receive data via FrontMCP Bridge
+ * await uploadToCDN('widgets/get_weather.html', widget.html);
+ * ```
+ */
+export declare function buildStaticWidget<In = unknown, Out = unknown>(options: StaticWidgetOptions<In, Out>): Promise<BuildResult>;
+/**
+ * @deprecated Use BuildConfig instead
+ */
+export type BuildTargetPlatform = 'chatgpt' | 'claude' | 'mcp-apps' | 'universal';
+/**
+ * @deprecated Use BuildOptions with config instead
+ */
+export interface MultiBuildOptions<In = unknown, Out = unknown> extends Omit<BuildOptions<In, Out>, 'platform'> {
+    platforms?: BuildTargetPlatform[];
+}
+/**
+ * @deprecated Use BuildResult instead (same result for all platforms now)
+ */
+export interface MultiBuildResult {
+    bundles: Record<string, BuildResult>;
+    totalTime: number;
+}
+/**
+ * @deprecated Use buildToolUI with config.network instead
+ */
+export declare function buildToolUIMulti<In = unknown, Out = unknown>(options: MultiBuildOptions<In, Out>): Promise<MultiBuildResult>;
+export { createTemplateHelpers } from '../runtime/wrapper';
+export type { UITemplateConfig, UITemplate, TemplateContext, TemplateHelpers, TemplateBuilderFn, UIContentSecurityPolicy, WidgetServingMode, WidgetDisplayMode, } from '../types';
+export type { ThemeConfig, PlatformCapabilities, DeepPartial } from '../theme';
+export { DEFAULT_THEME, OPENAI_PLATFORM, CLAUDE_PLATFORM } from '../theme';
+export { buildToolWidgetManifest, batchBuildWidgets, detectUIType, buildCSPForType, buildCSPMetaContent, getRendererAssets, buildToolResponseMeta, getOutputModeForClient, } from './widget-manifest';
+export type { BatchBuildOptions, BatchBuildResult, BuildMetaOptions } from './widget-manifest';
+export type { UIType, BundlingMode, DisplayMode, OutputMode, CSPDirectives, RendererAssets, WidgetManifest, WidgetConfig, BuildManifestResult, BuildManifestOptions, UIMetaFields, OpenAIMetaFields, ToolResponseMeta, RuntimePayload, } from '../types/ui-runtime';
+export { DEFAULT_CSP_BY_TYPE, DEFAULT_RENDERER_ASSETS, isUIType, isBundlingMode, isDisplayMode, isResourceMode, isOutputMode, } from '../types/ui-runtime';
+export type { ResourceMode, CDNResource } from '../types/ui-runtime';
+export { REACT_CDN, REACT_DOM_CDN, MARKED_CDN, HANDLEBARS_CDN, MDX_RUNTIME_CDN, TAILWIND_CDN, getDefaultAssets, buildCDNScriptTag, buildScriptsForUIType, buildTailwindScriptTag, hasInlineScripts, getURLsToPreFetch, buildCDNInfoForUIType, } from './cdn-resources';
+export type { CDNInfo } from './cdn-resources';

package/src/build/index.js

@@ -0,0 +1,325 @@
+"use strict";
+/**
+ * Build-Time API for Tool UI
+ *
+ * Provides pre-compilation capabilities for tool UI templates.
+ * Produces a **universal HTML document** that works across all platforms:
+ * - OpenAI ChatGPT (Apps SDK)
+ * - Anthropic Claude
+ * - MCP Apps (ext-apps / SEP-1865)
+ * - Google Gemini
+ * - Any MCP-compatible host
+ *
+ * The build embeds the FrontMCP Bridge which auto-detects the host
+ * at runtime and adapts its communication protocol accordingly.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCDNInfoForUIType = exports.getURLsToPreFetch = exports.hasInlineScripts = exports.buildTailwindScriptTag = exports.buildScriptsForUIType = exports.buildCDNScriptTag = exports.getDefaultAssets = exports.TAILWIND_CDN = exports.MDX_RUNTIME_CDN = exports.HANDLEBARS_CDN = exports.MARKED_CDN = exports.REACT_DOM_CDN = exports.REACT_CDN = exports.isOutputMode = exports.isResourceMode = exports.isDisplayMode = exports.isBundlingMode = exports.isUIType = exports.DEFAULT_RENDERER_ASSETS = exports.DEFAULT_CSP_BY_TYPE = exports.getOutputModeForClient = exports.buildToolResponseMeta = exports.getRendererAssets = exports.buildCSPMetaContent = exports.buildCSPForType = exports.detectUIType = exports.batchBuildWidgets = exports.buildToolWidgetManifest = exports.CLAUDE_PLATFORM = exports.OPENAI_PLATFORM = exports.DEFAULT_THEME = exports.createTemplateHelpers = void 0;
+exports.buildToolUI = buildToolUI;
+exports.buildStaticWidget = buildStaticWidget;
+exports.buildToolUIMulti = buildToolUIMulti;
+const wrapper_1 = require("../runtime/wrapper");
+const registry_1 = require("../renderers/registry");
+const renderers_1 = require("../renderers");
+// ============================================
+// Build Functions
+// ============================================
+/**
+ * Build a tool UI template into a universal HTML document.
+ *
+ * The output HTML:
+ * - Works on ALL platforms (OpenAI, Claude, MCP Apps, Gemini, etc.)
+ * - Includes FrontMCP Bridge that auto-detects the host at runtime
+ * - Adapts communication protocol based on detected platform
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { buildToolUI } from '@frontmcp/ui/build';
+ *
+ * const result = await buildToolUI({
+ *   template: { template: WeatherWidget },
+ *   toolName: 'get_weather',
+ *   output: { temperature: 72, conditions: 'sunny' },
+ * });
+ *
+ * // Upload to CDN - works everywhere
+ * await uploadToCDN('widgets/get_weather.html', result.html);
+ * ```
+ *
+ * @example With blocked network (for Claude Artifacts)
+ * ```typescript
+ * const result = await buildToolUI({
+ *   template: { template: WeatherWidget },
+ *   toolName: 'get_weather',
+ *   config: { network: 'blocked' }, // Inlines all scripts
+ * });
+ * ```
+ *
+ * @example MCP server response
+ * ```typescript
+ * const result = await buildToolUI({ template, toolName, output });
+ *
+ * // In MCP server - choose MIME type based on client
+ * const mimeType = isOpenAIClient(clientInfo)
+ *   ? result.mimeTypes.openai  // 'text/html+skybridge'
+ *   : result.mimeTypes.mcp;    // 'text/html+mcp'
+ *
+ * return { content: [{ type: mimeType, data: result.html }] };
+ * ```
+ */
+async function buildToolUI(options) {
+    const startTime = Date.now();
+    // Normalize options (handle legacy aliases)
+    const { template: uiConfig, toolName, input = options.sampleInput ?? {}, output = options.sampleOutput ?? {}, theme, title, config: userConfig = {}, injectAdapters, minify: legacyMinify, } = options;
+    // Build final config with defaults
+    const config = {
+        network: userConfig.network ?? 'open',
+        scripts: userConfig.scripts ?? 'auto',
+        includeBridge: userConfig.includeBridge ?? injectAdapters ?? true,
+        minify: userConfig.minify ?? legacyMinify ?? false,
+    };
+    // Resolve script strategy
+    const useInlineScripts = config.scripts === 'inline' || (config.scripts === 'auto' && config.network === 'blocked');
+    // Build template context
+    const ctx = buildTemplateContext(input, output);
+    // Render the template content
+    const { html: content, rendererType } = await renderTemplate(uiConfig.template, ctx, {
+        mdxComponents: uiConfig.mdxComponents,
+    });
+    // Wrap in universal HTML document
+    const html = (0, wrapper_1.wrapToolUIUniversal)({
+        content,
+        toolName,
+        input: input,
+        output,
+        csp: uiConfig.csp,
+        widgetAccessible: uiConfig.widgetAccessible,
+        title: title || `${toolName} Widget`,
+        theme,
+        includeBridge: config.includeBridge,
+        inlineScripts: useInlineScripts,
+        rendererType,
+    });
+    // Optionally minify
+    const finalHtml = config.minify ? minifyHtml(html) : html;
+    // Calculate size and hash
+    const size = Buffer.byteLength(finalHtml, 'utf8');
+    const gzipSize = estimateGzipSize(finalHtml);
+    const hash = await calculateHash(finalHtml);
+    return {
+        html: finalHtml,
+        size,
+        gzipSize,
+        hash,
+        mimeTypes: {
+            openai: 'text/html+skybridge',
+            mcp: 'text/html+mcp',
+            html: 'text/html',
+        },
+        rendererType,
+        buildTime: new Date(startTime).toISOString(),
+        config,
+    };
+}
+// ============================================
+// Helper Functions
+// ============================================
+/**
+ * Build template context from input/output.
+ */
+function buildTemplateContext(input, output, structuredContent) {
+    return {
+        input,
+        output,
+        structuredContent,
+        helpers: (0, wrapper_1.createTemplateHelpers)(),
+    };
+}
+/**
+ * Render a template using the appropriate renderer.
+ */
+async function renderTemplate(template, ctx, options) {
+    // Detect template type
+    const detection = (0, renderers_1.detectTemplateType)(template);
+    // For simple HTML templates, use direct execution (sync, faster)
+    if (detection.type === 'html-function' || detection.type === 'html-string') {
+        const html = typeof template === 'function'
+            ? template(ctx)
+            : template;
+        return { html, rendererType: 'html' };
+    }
+    // For React/MDX, use the renderer registry
+    try {
+        const result = await registry_1.rendererRegistry.render(template, ctx, {
+            mdxComponents: options?.mdxComponents,
+        });
+        return { html: result.html, rendererType: result.rendererType };
+    }
+    catch (error) {
+        // Fallback to HTML if renderer fails
+        console.warn(`[@frontmcp/ui/build] Renderer failed for ${detection.type}, falling back to HTML:`, error instanceof Error ? error.message : error);
+        if (typeof template === 'function') {
+            try {
+                const html = template(ctx);
+                return { html, rendererType: 'html-fallback' };
+            }
+            catch {
+                return {
+                    html: `<div class="error">Template rendering failed</div>`,
+                    rendererType: 'error',
+                };
+            }
+        }
+        return { html: String(template), rendererType: 'html-fallback' };
+    }
+}
+/**
+ * Simple HTML minification (remove whitespace between tags).
+ */
+function minifyHtml(html) {
+    return html
+        .replace(/>\s+</g, '><') // Remove whitespace between tags
+        .replace(/\s{2,}/g, ' ') // Collapse multiple spaces
+        .trim();
+}
+/**
+ * Estimate gzipped size (rough approximation).
+ */
+function estimateGzipSize(content) {
+    // Rough estimate: gzip typically achieves 70-90% compression on HTML
+    // We use 75% as a middle ground
+    return Math.round(Buffer.byteLength(content, 'utf8') * 0.25);
+}
+/**
+ * Calculate SHA-256 hash of content.
+ */
+async function calculateHash(content) {
+    // Use Web Crypto API if available, otherwise fallback to simple hash
+    if (typeof crypto !== 'undefined' && crypto.subtle) {
+        const encoder = new TextEncoder();
+        const data = encoder.encode(content);
+        const hashBuffer = await crypto.subtle.digest('SHA-256', data);
+        const hashArray = Array.from(new Uint8Array(hashBuffer));
+        return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
+    }
+    // Simple fallback hash (not cryptographically secure, but good enough for cache keys)
+    let hash = 0;
+    for (let i = 0; i < content.length; i++) {
+        const char = content.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash; // Convert to 32-bit integer
+    }
+    return Math.abs(hash).toString(16).padStart(8, '0');
+}
+/**
+ * Build a static widget that reads data from the host platform at runtime.
+ *
+ * Unlike buildToolUI which pre-renders with data, this creates a widget
+ * that waits for data from the host platform via the FrontMCP Bridge.
+ *
+ * @example
+ * ```typescript
+ * import { buildStaticWidget } from '@frontmcp/ui/build';
+ *
+ * const widget = await buildStaticWidget({
+ *   template: {
+ *     template: (ctx) => `<div id="weather">${ctx.output?.temperature || 'Loading...'}</div>`,
+ *   },
+ *   toolName: 'get_weather',
+ * });
+ *
+ * // This widget will receive data via FrontMCP Bridge
+ * await uploadToCDN('widgets/get_weather.html', widget.html);
+ * ```
+ */
+async function buildStaticWidget(options) {
+    const { template, toolName, theme, config, title } = options;
+    // Build with empty data - the widget will receive data from host at runtime
+    return buildToolUI({
+        template,
+        toolName,
+        input: {},
+        output: {},
+        theme,
+        config,
+        title: title || `${toolName} Widget`,
+    });
+}
+/**
+ * @deprecated Use buildToolUI with config.network instead
+ */
+async function buildToolUIMulti(options) {
+    const startTime = Date.now();
+    const { platforms = ['chatgpt', 'claude'], ...buildOptions } = options;
+    // For backwards compatibility, build once and return same result for all platforms
+    const result = await buildToolUI(buildOptions);
+    const bundles = {};
+    for (const platform of platforms) {
+        bundles[platform] = {
+            ...result,
+            // Add legacy mimeType field for compatibility
+            mimeType: platform === 'chatgpt' ? 'text/html+skybridge' : 'text/html+mcp',
+        };
+    }
+    return {
+        bundles,
+        totalTime: Date.now() - startTime,
+    };
+}
+// ============================================
+// Re-exports for Convenience
+// ============================================
+var wrapper_2 = require("../runtime/wrapper");
+Object.defineProperty(exports, "createTemplateHelpers", { enumerable: true, get: function () { return wrapper_2.createTemplateHelpers; } });
+var theme_1 = require("../theme");
+Object.defineProperty(exports, "DEFAULT_THEME", { enumerable: true, get: function () { return theme_1.DEFAULT_THEME; } });
+Object.defineProperty(exports, "OPENAI_PLATFORM", { enumerable: true, get: function () { return theme_1.OPENAI_PLATFORM; } });
+Object.defineProperty(exports, "CLAUDE_PLATFORM", { enumerable: true, get: function () { return theme_1.CLAUDE_PLATFORM; } });
+// ============================================
+// Widget Manifest Builder (New API)
+// ============================================
+var widget_manifest_1 = require("./widget-manifest");
+// Main builder
+Object.defineProperty(exports, "buildToolWidgetManifest", { enumerable: true, get: function () { return widget_manifest_1.buildToolWidgetManifest; } });
+Object.defineProperty(exports, "batchBuildWidgets", { enumerable: true, get: function () { return widget_manifest_1.batchBuildWidgets; } });
+// Detection utilities
+Object.defineProperty(exports, "detectUIType", { enumerable: true, get: function () { return widget_manifest_1.detectUIType; } });
+// CSP utilities
+Object.defineProperty(exports, "buildCSPForType", { enumerable: true, get: function () { return widget_manifest_1.buildCSPForType; } });
+Object.defineProperty(exports, "buildCSPMetaContent", { enumerable: true, get: function () { return widget_manifest_1.buildCSPMetaContent; } });
+// Asset utilities
+Object.defineProperty(exports, "getRendererAssets", { enumerable: true, get: function () { return widget_manifest_1.getRendererAssets; } });
+// _meta field builders (NEW)
+Object.defineProperty(exports, "buildToolResponseMeta", { enumerable: true, get: function () { return widget_manifest_1.buildToolResponseMeta; } });
+Object.defineProperty(exports, "getOutputModeForClient", { enumerable: true, get: function () { return widget_manifest_1.getOutputModeForClient; } });
+var ui_runtime_1 = require("../types/ui-runtime");
+Object.defineProperty(exports, "DEFAULT_CSP_BY_TYPE", { enumerable: true, get: function () { return ui_runtime_1.DEFAULT_CSP_BY_TYPE; } });
+Object.defineProperty(exports, "DEFAULT_RENDERER_ASSETS", { enumerable: true, get: function () { return ui_runtime_1.DEFAULT_RENDERER_ASSETS; } });
+Object.defineProperty(exports, "isUIType", { enumerable: true, get: function () { return ui_runtime_1.isUIType; } });
+Object.defineProperty(exports, "isBundlingMode", { enumerable: true, get: function () { return ui_runtime_1.isBundlingMode; } });
+Object.defineProperty(exports, "isDisplayMode", { enumerable: true, get: function () { return ui_runtime_1.isDisplayMode; } });
+Object.defineProperty(exports, "isResourceMode", { enumerable: true, get: function () { return ui_runtime_1.isResourceMode; } });
+Object.defineProperty(exports, "isOutputMode", { enumerable: true, get: function () { return ui_runtime_1.isOutputMode; } });
+// ============================================
+// CDN Resource Utilities
+// ============================================
+var cdn_resources_1 = require("./cdn-resources");
+// CDN URL Constants
+Object.defineProperty(exports, "REACT_CDN", { enumerable: true, get: function () { return cdn_resources_1.REACT_CDN; } });
+Object.defineProperty(exports, "REACT_DOM_CDN", { enumerable: true, get: function () { return cdn_resources_1.REACT_DOM_CDN; } });
+Object.defineProperty(exports, "MARKED_CDN", { enumerable: true, get: function () { return cdn_resources_1.MARKED_CDN; } });
+Object.defineProperty(exports, "HANDLEBARS_CDN", { enumerable: true, get: function () { return cdn_resources_1.HANDLEBARS_CDN; } });
+Object.defineProperty(exports, "MDX_RUNTIME_CDN", { enumerable: true, get: function () { return cdn_resources_1.MDX_RUNTIME_CDN; } });
+Object.defineProperty(exports, "TAILWIND_CDN", { enumerable: true, get: function () { return cdn_resources_1.TAILWIND_CDN; } });
+// Helper Functions
+Object.defineProperty(exports, "getDefaultAssets", { enumerable: true, get: function () { return cdn_resources_1.getDefaultAssets; } });
+Object.defineProperty(exports, "buildCDNScriptTag", { enumerable: true, get: function () { return cdn_resources_1.buildCDNScriptTag; } });
+Object.defineProperty(exports, "buildScriptsForUIType", { enumerable: true, get: function () { return cdn_resources_1.buildScriptsForUIType; } });
+Object.defineProperty(exports, "buildTailwindScriptTag", { enumerable: true, get: function () { return cdn_resources_1.buildTailwindScriptTag; } });
+Object.defineProperty(exports, "hasInlineScripts", { enumerable: true, get: function () { return cdn_resources_1.hasInlineScripts; } });
+Object.defineProperty(exports, "getURLsToPreFetch", { enumerable: true, get: function () { return cdn_resources_1.getURLsToPreFetch; } });
+// CDN Info for tools/list _meta
+Object.defineProperty(exports, "buildCDNInfoForUIType", { enumerable: true, get: function () { return cdn_resources_1.buildCDNInfoForUIType; } });
+//# sourceMappingURL=index.js.map

package/src/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/build/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Build-Time API for Tool UI\n *\n * Provides pre-compilation capabilities for tool UI templates.\n * Produces a **universal HTML document** that works across all platforms:\n * - OpenAI ChatGPT (Apps SDK)\n * - Anthropic Claude\n * - MCP Apps (ext-apps / SEP-1865)\n * - Google Gemini\n * - Any MCP-compatible host\n *\n * The build embeds the FrontMCP Bridge which auto-detects the host\n * at runtime and adapts its communication protocol accordingly.\n *\n * @packageDocumentation\n */\n\nimport type { UITemplateConfig, TemplateContext } from '../types';\nimport type { ThemeConfig, DeepPartial } from '../theme';\nimport { wrapToolUIUniversal, createTemplateHelpers } from '../runtime/wrapper';\nimport { rendererRegistry } from '../renderers/registry';\nimport { detectTemplateType } from '../renderers';\nimport type { TemplateBuilderFn } from '../types';\n\n// ============================================\n// Build Types\n// ============================================\n\n/**\n * Network access mode for the target environment.\n *\n * - `'open'`: Can fetch external resources (CDN scripts, fonts)\n * - `'blocked'`: Network is sandboxed, must inline everything\n */\nexport type NetworkMode = 'open' | 'blocked';\n\n/**\n * Script loading strategy.\n *\n * - `'cdn'`: Load scripts from CDN (smaller HTML, requires network)\n * - `'inline'`: Embed scripts in HTML (larger, works offline)\n * - `'auto'`: Choose based on network mode\n */\nexport type ScriptStrategy = 'cdn' | 'inline' | 'auto';\n\n/**\n * Build configuration options.\n * Capability-based rather than platform-specific.\n */\nexport interface BuildConfig {\n  /**\n   * Network access mode.\n   * @default 'open'\n   */\n  network?: NetworkMode;\n\n  /**\n   * Script loading strategy.\n   * @default 'auto' (uses 'inline' if network is 'blocked')\n   */\n  scripts?: ScriptStrategy;\n\n  /**\n   * Whether to include the FrontMCP Bridge runtime.\n   * The bridge auto-detects the host platform at runtime.\n   * @default true\n   */\n  includeBridge?: boolean;\n\n  /**\n   * Whether to minify the output HTML.\n   * @default false\n   */\n  minify?: boolean;\n}\n\n/**\n * Options for building a tool UI template.\n *\n * @example\n * ```typescript\n * const result = await buildToolUI({\n *   template: {\n *     template: (ctx) => `<div>${ctx.output.value}</div>`,\n *     widgetAccessible: true,\n *   },\n *   toolName: 'my_tool',\n *   input: { query: 'hello' },\n *   output: { value: 'world' },\n * });\n *\n * // Universal HTML that works on any platform\n * console.log(result.html);\n * ```\n */\nexport interface BuildOptions<In = unknown, Out = unknown> {\n  /**\n   * UI template configuration.\n   */\n  template: UITemplateConfig<In, Out>;\n\n  /**\n   * Name of the tool this UI is for.\n   */\n  toolName: string;\n\n  /**\n   * Tool input arguments.\n   */\n  input?: In;\n\n  /**\n   * Tool output/result data.\n   */\n  output?: Out;\n\n  /**\n   * Theme configuration override.\n   */\n  theme?: DeepPartial<ThemeConfig>;\n\n  /**\n   * Build configuration.\n   * Controls network mode, script strategy, etc.\n   */\n  config?: BuildConfig;\n\n  /**\n   * Title for the HTML document.\n   */\n  title?: string;\n\n  // Legacy aliases for backwards compatibility\n  /** @deprecated Use `input` instead */\n  sampleInput?: In;\n  /** @deprecated Use `output` instead */\n  sampleOutput?: Out;\n  /** @deprecated Use `config.includeBridge` instead */\n  injectAdapters?: boolean;\n  /** @deprecated Use `config.minify` instead */\n  minify?: boolean;\n  /** @deprecated Platform is now auto-detected at runtime */\n  platform?: string;\n}\n\n/**\n * MIME types for different host platforms.\n * Returned as suggestions - the MCP server response layer decides which to use.\n */\nexport interface MimeTypes {\n  /** For OpenAI ChatGPT Apps SDK */\n  openai: 'text/html+skybridge';\n  /** For Claude, MCP Apps, and standard MCP hosts */\n  mcp: 'text/html+mcp';\n  /** Generic HTML (fallback) */\n  html: 'text/html';\n}\n\n/**\n * Result of building a tool UI template.\n */\nexport interface BuildResult {\n  /**\n   * Complete HTML document string.\n   * This is universal - works on all platforms.\n   */\n  html: string;\n\n  /**\n   * Size of the HTML in bytes.\n   */\n  size: number;\n\n  /**\n   * Size of the gzipped HTML in bytes (estimated).\n   */\n  gzipSize: number;\n\n  /**\n   * SHA-256 hash of the HTML content.\n   */\n  hash: string;\n\n  /**\n   * Suggested MIME types for different hosts.\n   * The MCP server response layer should select based on detected client.\n   */\n  mimeTypes: MimeTypes;\n\n  /**\n   * Renderer type used (html, react, mdx).\n   */\n  rendererType: string;\n\n  /**\n   * Build timestamp (ISO 8601).\n   */\n  buildTime: string;\n\n  /**\n   * Build configuration used.\n   */\n  config: Required<BuildConfig>;\n}\n\n// ============================================\n// Build Functions\n// ============================================\n\n/**\n * Build a tool UI template into a universal HTML document.\n *\n * The output HTML:\n * - Works on ALL platforms (OpenAI, Claude, MCP Apps, Gemini, etc.)\n * - Includes FrontMCP Bridge that auto-detects the host at runtime\n * - Adapts communication protocol based on detected platform\n *\n * @example Basic usage\n * ```typescript\n * import { buildToolUI } from '@frontmcp/ui/build';\n *\n * const result = await buildToolUI({\n *   template: { template: WeatherWidget },\n *   toolName: 'get_weather',\n *   output: { temperature: 72, conditions: 'sunny' },\n * });\n *\n * // Upload to CDN - works everywhere\n * await uploadToCDN('widgets/get_weather.html', result.html);\n * ```\n *\n * @example With blocked network (for Claude Artifacts)\n * ```typescript\n * const result = await buildToolUI({\n *   template: { template: WeatherWidget },\n *   toolName: 'get_weather',\n *   config: { network: 'blocked' }, // Inlines all scripts\n * });\n * ```\n *\n * @example MCP server response\n * ```typescript\n * const result = await buildToolUI({ template, toolName, output });\n *\n * // In MCP server - choose MIME type based on client\n * const mimeType = isOpenAIClient(clientInfo)\n *   ? result.mimeTypes.openai  // 'text/html+skybridge'\n *   : result.mimeTypes.mcp;    // 'text/html+mcp'\n *\n * return { content: [{ type: mimeType, data: result.html }] };\n * ```\n */\nexport async function buildToolUI<In = unknown, Out = unknown>(\n  options: BuildOptions<In, Out>\n): Promise<BuildResult> {\n  const startTime = Date.now();\n\n  // Normalize options (handle legacy aliases)\n  const {\n    template: uiConfig,\n    toolName,\n    input = options.sampleInput ?? ({} as In),\n    output = options.sampleOutput ?? ({} as Out),\n    theme,\n    title,\n    config: userConfig = {},\n    injectAdapters,\n    minify: legacyMinify,\n  } = options;\n\n  // Build final config with defaults\n  const config: Required<BuildConfig> = {\n    network: userConfig.network ?? 'open',\n    scripts: userConfig.scripts ?? 'auto',\n    includeBridge: userConfig.includeBridge ?? injectAdapters ?? true,\n    minify: userConfig.minify ?? legacyMinify ?? false,\n  };\n\n  // Resolve script strategy\n  const useInlineScripts =\n    config.scripts === 'inline' || (config.scripts === 'auto' && config.network === 'blocked');\n\n  // Build template context\n  const ctx = buildTemplateContext(input, output);\n\n  // Render the template content\n  const { html: content, rendererType } = await renderTemplate(uiConfig.template, ctx, {\n    mdxComponents: uiConfig.mdxComponents,\n  });\n\n  // Wrap in universal HTML document\n  const html = wrapToolUIUniversal({\n    content,\n    toolName,\n    input: input as Record<string, unknown>,\n    output,\n    csp: uiConfig.csp,\n    widgetAccessible: uiConfig.widgetAccessible,\n    title: title || `${toolName} Widget`,\n    theme,\n    includeBridge: config.includeBridge,\n    inlineScripts: useInlineScripts,\n    rendererType,\n  });\n\n  // Optionally minify\n  const finalHtml = config.minify ? minifyHtml(html) : html;\n\n  // Calculate size and hash\n  const size = Buffer.byteLength(finalHtml, 'utf8');\n  const gzipSize = estimateGzipSize(finalHtml);\n  const hash = await calculateHash(finalHtml);\n\n  return {\n    html: finalHtml,\n    size,\n    gzipSize,\n    hash,\n    mimeTypes: {\n      openai: 'text/html+skybridge',\n      mcp: 'text/html+mcp',\n      html: 'text/html',\n    },\n    rendererType,\n    buildTime: new Date(startTime).toISOString(),\n    config,\n  };\n}\n\n// ============================================\n// Helper Functions\n// ============================================\n\n/**\n * Build template context from input/output.\n */\nfunction buildTemplateContext<In = unknown, Out = unknown>(\n  input: In,\n  output: Out,\n  structuredContent?: unknown\n): TemplateContext<In, Out> {\n  return {\n    input,\n    output,\n    structuredContent,\n    helpers: createTemplateHelpers(),\n  };\n}\n\n/**\n * Render a template using the appropriate renderer.\n */\nasync function renderTemplate<In = unknown, Out = unknown>(\n  template: UITemplateConfig<In, Out>['template'],\n  ctx: TemplateContext<In, Out>,\n  options?: {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    mdxComponents?: Record<string, any>;\n  }\n): Promise<{ html: string; rendererType: string }> {\n  // Detect template type\n  const detection = detectTemplateType(template);\n\n  // For simple HTML templates, use direct execution (sync, faster)\n  if (detection.type === 'html-function' || detection.type === 'html-string') {\n    const html =\n      typeof template === 'function'\n        ? (template as TemplateBuilderFn<In, Out>)(ctx)\n        : (template as string);\n\n    return { html, rendererType: 'html' };\n  }\n\n  // For React/MDX, use the renderer registry\n  try {\n    const result = await rendererRegistry.render(template, ctx, {\n      mdxComponents: options?.mdxComponents,\n    });\n\n    return { html: result.html, rendererType: result.rendererType };\n  } catch (error) {\n    // Fallback to HTML if renderer fails\n    console.warn(\n      `[@frontmcp/ui/build] Renderer failed for ${detection.type}, falling back to HTML:`,\n      error instanceof Error ? error.message : error\n    );\n\n    if (typeof template === 'function') {\n      try {\n        const html = (template as TemplateBuilderFn<In, Out>)(ctx);\n        return { html, rendererType: 'html-fallback' };\n      } catch {\n        return {\n          html: `<div class=\"error\">Template rendering failed</div>`,\n          rendererType: 'error',\n        };\n      }\n    }\n\n    return { html: String(template), rendererType: 'html-fallback' };\n  }\n}\n\n/**\n * Simple HTML minification (remove whitespace between tags).\n */\nfunction minifyHtml(html: string): string {\n  return html\n    .replace(/>\\s+</g, '><') // Remove whitespace between tags\n    .replace(/\\s{2,}/g, ' ') // Collapse multiple spaces\n    .trim();\n}\n\n/**\n * Estimate gzipped size (rough approximation).\n */\nfunction estimateGzipSize(content: string): number {\n  // Rough estimate: gzip typically achieves 70-90% compression on HTML\n  // We use 75% as a middle ground\n  return Math.round(Buffer.byteLength(content, 'utf8') * 0.25);\n}\n\n/**\n * Calculate SHA-256 hash of content.\n */\nasync function calculateHash(content: string): Promise<string> {\n  // Use Web Crypto API if available, otherwise fallback to simple hash\n  if (typeof crypto !== 'undefined' && crypto.subtle) {\n    const encoder = new TextEncoder();\n    const data = encoder.encode(content);\n    const hashBuffer = await crypto.subtle.digest('SHA-256', data);\n    const hashArray = Array.from(new Uint8Array(hashBuffer));\n    return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');\n  }\n\n  // Simple fallback hash (not cryptographically secure, but good enough for cache keys)\n  let hash = 0;\n  for (let i = 0; i < content.length; i++) {\n    const char = content.charCodeAt(i);\n    hash = (hash << 5) - hash + char;\n    hash = hash & hash; // Convert to 32-bit integer\n  }\n  return Math.abs(hash).toString(16).padStart(8, '0');\n}\n\n// ============================================\n// Static Widget Builder\n// ============================================\n\n/**\n * Options for building a static widget that reads from host at runtime.\n */\nexport interface StaticWidgetOptions<In = unknown, Out = unknown> {\n  /**\n   * UI template configuration.\n   */\n  template: UITemplateConfig<In, Out>;\n\n  /**\n   * Name of the tool this UI is for.\n   */\n  toolName: string;\n\n  /**\n   * Theme configuration override.\n   */\n  theme?: DeepPartial<ThemeConfig>;\n\n  /**\n   * Build configuration.\n   */\n  config?: BuildConfig;\n\n  /**\n   * Title for the HTML document.\n   */\n  title?: string;\n}\n\n/**\n * Build a static widget that reads data from the host platform at runtime.\n *\n * Unlike buildToolUI which pre-renders with data, this creates a widget\n * that waits for data from the host platform via the FrontMCP Bridge.\n *\n * @example\n * ```typescript\n * import { buildStaticWidget } from '@frontmcp/ui/build';\n *\n * const widget = await buildStaticWidget({\n *   template: {\n *     template: (ctx) => `<div id=\"weather\">${ctx.output?.temperature || 'Loading...'}</div>`,\n *   },\n *   toolName: 'get_weather',\n * });\n *\n * // This widget will receive data via FrontMCP Bridge\n * await uploadToCDN('widgets/get_weather.html', widget.html);\n * ```\n */\nexport async function buildStaticWidget<In = unknown, Out = unknown>(\n  options: StaticWidgetOptions<In, Out>\n): Promise<BuildResult> {\n  const { template, toolName, theme, config, title } = options;\n\n  // Build with empty data - the widget will receive data from host at runtime\n  return buildToolUI({\n    template,\n    toolName,\n    input: {} as In,\n    output: {} as Out,\n    theme,\n    config,\n    title: title || `${toolName} Widget`,\n  });\n}\n\n// ============================================\n// Legacy Compatibility\n// ============================================\n\n/**\n * @deprecated Use BuildConfig instead\n */\nexport type BuildTargetPlatform = 'chatgpt' | 'claude' | 'mcp-apps' | 'universal';\n\n/**\n * @deprecated Use BuildOptions with config instead\n */\nexport interface MultiBuildOptions<In = unknown, Out = unknown>\n  extends Omit<BuildOptions<In, Out>, 'platform'> {\n  platforms?: BuildTargetPlatform[];\n}\n\n/**\n * @deprecated Use BuildResult instead (same result for all platforms now)\n */\nexport interface MultiBuildResult {\n  bundles: Record<string, BuildResult>;\n  totalTime: number;\n}\n\n/**\n * @deprecated Use buildToolUI with config.network instead\n */\nexport async function buildToolUIMulti<In = unknown, Out = unknown>(\n  options: MultiBuildOptions<In, Out>\n): Promise<MultiBuildResult> {\n  const startTime = Date.now();\n  const { platforms = ['chatgpt', 'claude'], ...buildOptions } = options;\n\n  // For backwards compatibility, build once and return same result for all platforms\n  const result = await buildToolUI(buildOptions);\n\n  const bundles: Record<string, BuildResult> = {};\n  for (const platform of platforms) {\n    bundles[platform] = {\n      ...result,\n      // Add legacy mimeType field for compatibility\n      mimeType: platform === 'chatgpt' ? 'text/html+skybridge' : 'text/html+mcp',\n    } as BuildResult & { mimeType: string };\n  }\n\n  return {\n    bundles,\n    totalTime: Date.now() - startTime,\n  };\n}\n\n// ============================================\n// Re-exports for Convenience\n// ============================================\n\nexport { createTemplateHelpers } from '../runtime/wrapper';\nexport type {\n  UITemplateConfig,\n  UITemplate,\n  TemplateContext,\n  TemplateHelpers,\n  TemplateBuilderFn,\n  UIContentSecurityPolicy,\n  WidgetServingMode,\n  WidgetDisplayMode,\n} from '../types';\nexport type { ThemeConfig, PlatformCapabilities, DeepPartial } from '../theme';\nexport { DEFAULT_THEME, OPENAI_PLATFORM, CLAUDE_PLATFORM } from '../theme';\n\n// ============================================\n// Widget Manifest Builder (New API)\n// ============================================\n\nexport {\n  // Main builder\n  buildToolWidgetManifest,\n  batchBuildWidgets,\n  // Detection utilities\n  detectUIType,\n  // CSP utilities\n  buildCSPForType,\n  buildCSPMetaContent,\n  // Asset utilities\n  getRendererAssets,\n  // _meta field builders (NEW)\n  buildToolResponseMeta,\n  getOutputModeForClient,\n} from './widget-manifest';\n\nexport type { BatchBuildOptions, BatchBuildResult, BuildMetaOptions } from './widget-manifest';\n\n// Re-export runtime types for convenience\nexport type {\n  UIType,\n  BundlingMode,\n  DisplayMode,\n  OutputMode,\n  CSPDirectives,\n  RendererAssets,\n  WidgetManifest,\n  WidgetConfig,\n  BuildManifestResult,\n  BuildManifestOptions,\n  // _meta field types (NEW)\n  UIMetaFields,\n  OpenAIMetaFields,\n  ToolResponseMeta,\n  // Deprecated\n  RuntimePayload,\n} from '../types/ui-runtime';\n\nexport {\n  DEFAULT_CSP_BY_TYPE,\n  DEFAULT_RENDERER_ASSETS,\n  isUIType,\n  isBundlingMode,\n  isDisplayMode,\n  isResourceMode,\n  isOutputMode,\n} from '../types/ui-runtime';\n\nexport type { ResourceMode, CDNResource } from '../types/ui-runtime';\n\n// ============================================\n// CDN Resource Utilities\n// ============================================\n\nexport {\n  // CDN URL Constants\n  REACT_CDN,\n  REACT_DOM_CDN,\n  MARKED_CDN,\n  HANDLEBARS_CDN,\n  MDX_RUNTIME_CDN,\n  TAILWIND_CDN,\n  // Helper Functions\n  getDefaultAssets,\n  buildCDNScriptTag,\n  buildScriptsForUIType,\n  buildTailwindScriptTag,\n  hasInlineScripts,\n  getURLsToPreFetch,\n  // CDN Info for tools/list _meta\n  buildCDNInfoForUIType,\n} from './cdn-resources';\n\nexport type { CDNInfo } from './cdn-resources';\n"]}