@frontmcp/ui 0.5.0 → 0.6.0

package/src/build/index.d.ts

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

@@ -1,325 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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"]}