@frontmcp/uipack 0.6.1

package/base-template/polyfills.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Platform Polyfills for Base Template
+ *
+ * Provides additional polyfills for MCP session detection and
+ * direct HTTP fallback when not in an OpenAI or ext-apps environment.
+ *
+ * These polyfills complement the existing MCP_BRIDGE_RUNTIME.
+ */
+/**
+ * MCP Session information for HTTP fallback
+ */
+export interface McpSession {
+    /** MCP server URL */
+    mcpUrl: string;
+    /** Session ID for authentication */
+    sessionId: string;
+}
+/**
+ * Render the MCP session detection polyfill script.
+ *
+ * This provides auto-detection of MCP session info from:
+ * 1. Explicit window.__frontmcp.mcpSession
+ * 2. Meta tags (mcp-url, mcp-session-id)
+ * 3. URL query parameters (mcpUrl, sessionId)
+ * 4. Fallback values provided at render time
+ *
+ * @param mcpSession - Optional explicit session to bake into the template
+ * @returns Script tag with polyfill code
+ */
+export declare function renderMcpSessionPolyfill(mcpSession?: McpSession): string;
+//# sourceMappingURL=polyfills.d.ts.map

package/base-template/polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfills.d.ts","sourceRoot":"","sources":["../../src/base-template/polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,CAuJxE"}

package/base-template/theme-styles.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Theme Styles for Base Template
+ *
+ * Composes theme configuration into complete HTML head content
+ * including fonts, scripts, and CSS custom properties.
+ *
+ * Uses existing theme utilities from @frontmcp/ui/theme module.
+ */
+import { type ThemeConfig } from '../theme';
+/**
+ * Options for rendering theme styles.
+ */
+export interface ThemeStylesOptions {
+    /** Theme configuration (default: DEFAULT_THEME) */
+    theme?: ThemeConfig;
+    /** Include Tailwind CSS (default: true) */
+    tailwind?: boolean;
+    /** Include HTMX (default: false) */
+    htmx?: boolean;
+    /** Include Alpine.js (default: false) */
+    alpine?: boolean;
+    /** Include fonts (default: true) */
+    fonts?: boolean;
+    /** Use inline scripts from cache (for blocked network platforms) */
+    inline?: boolean;
+}
+/**
+ * Render complete theme styles for HTML head section.
+ *
+ * This function composes all theme-related HTML including:
+ * 1. Font preconnect links (optional)
+ * 2. Font stylesheets (optional)
+ * 3. Tailwind CSS script (with @theme variables)
+ * 4. Additional framework scripts (HTMX, Alpine.js)
+ *
+ * @param options - Theme styles configuration
+ * @returns HTML string with all style/script tags
+ *
+ * @example
+ * ```typescript
+ * // Default theme with Tailwind only
+ * const styles = renderThemeStyles();
+ *
+ * // Custom theme with HTMX
+ * const styles = renderThemeStyles({
+ *   theme: customTheme,
+ *   htmx: true,
+ * });
+ *
+ * // For blocked-network platforms (Claude Artifacts)
+ * await fetchAndCacheScriptsFromTheme(theme);
+ * const styles = renderThemeStyles({ inline: true });
+ * ```
+ */
+export declare function renderThemeStyles(options?: ThemeStylesOptions): string;
+/**
+ * Render minimal theme styles (Tailwind + @theme only).
+ *
+ * Use this for lightweight widgets that don't need fonts or additional scripts.
+ *
+ * @param theme - Theme configuration (default: DEFAULT_THEME)
+ * @returns HTML string with Tailwind script and @theme style block
+ */
+export declare function renderMinimalThemeStyles(theme?: ThemeConfig): string;
+/**
+ * Render theme CSS variables only (no scripts).
+ *
+ * Use this when Tailwind is already loaded elsewhere.
+ *
+ * @param theme - Theme configuration (default: DEFAULT_THEME)
+ * @returns HTML style block with @theme CSS
+ */
+export declare function renderThemeCssOnly(theme?: ThemeConfig): string;
+//# sourceMappingURL=theme-styles.d.ts.map

package/base-template/theme-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-styles.d.ts","sourceRoot":"","sources":["../../src/base-template/theme-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAML,KAAK,WAAW,EAEjB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAmC1E;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,GAAE,WAA2B,GAAG,MAAM,CASnF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,WAA2B,GAAG,MAAM,CAE7E"}

package/bridge-runtime/iife-generator.d.ts

@@ -0,0 +1,62 @@
+/**
+ * IIFE Generator for FrontMcpBridge Runtime
+ *
+ * Generates vanilla JavaScript IIFE scripts that can be embedded
+ * in HTML templates for runtime platform detection and bridge setup.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Options for generating the bridge IIFE.
+ */
+export interface IIFEGeneratorOptions {
+    /** Include specific adapters (all if not specified) */
+    adapters?: ('openai' | 'ext-apps' | 'claude' | 'gemini' | 'generic')[];
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Trusted origins for ext-apps adapter */
+    trustedOrigins?: string[];
+    /** Minify the output */
+    minify?: boolean;
+}
+/**
+ * Generate the bridge runtime IIFE script.
+ *
+ * This generates a self-contained vanilla JavaScript script that:
+ * 1. Detects the current platform
+ * 2. Initializes the appropriate adapter
+ * 3. Exposes window.FrontMcpBridge global
+ *
+ * @example
+ * ```typescript
+ * import { generateBridgeIIFE } from '@frontmcp/ui/bridge';
+ *
+ * const script = generateBridgeIIFE({ debug: true });
+ * const html = `<script>${script}</script>`;
+ * ```
+ */
+export declare function generateBridgeIIFE(options?: IIFEGeneratorOptions): string;
+/**
+ * Generate platform-specific bundle IIFE.
+ *
+ * @example ChatGPT-specific bundle
+ * ```typescript
+ * const script = generatePlatformBundle('chatgpt');
+ * ```
+ */
+export declare function generatePlatformBundle(platform: 'chatgpt' | 'claude' | 'gemini' | 'universal', options?: Omit<IIFEGeneratorOptions, 'adapters'>): string;
+/**
+ * Pre-generated universal bridge script (includes all adapters).
+ * Use this for the simplest integration.
+ */
+export declare const UNIVERSAL_BRIDGE_SCRIPT: string;
+/**
+ * Pre-generated bridge scripts wrapped in script tags.
+ */
+export declare const BRIDGE_SCRIPT_TAGS: {
+    universal: string;
+    chatgpt: string;
+    claude: string;
+    gemini: string;
+};
+//# sourceMappingURL=iife-generator.d.ts.map

package/bridge-runtime/iife-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iife-generator.d.ts","sourceRoot":"","sources":["../../src/bridge-runtime/iife-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC;IACvE,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,wBAAwB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAyF7E;AAmzBD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,EACvD,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAM,GACnD,MAAM,CAYR;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAAuB,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;CAK9B,CAAC"}

package/bridge-runtime/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bridge Runtime Exports
+ *
+ * IIFE generator and bridge script tags for embedding in HTML templates.
+ * This module is React-free and can be used standalone.
+ *
+ * @packageDocumentation
+ */
+export { generateBridgeIIFE, generatePlatformBundle, UNIVERSAL_BRIDGE_SCRIPT, BRIDGE_SCRIPT_TAGS, type IIFEGeneratorOptions, } from './iife-generator';
+//# sourceMappingURL=index.d.ts.map

package/bridge-runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge-runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC"}