@frontmcp/ui 0.5.1 → 0.6.1

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;AAkzBD;;;;;;;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 Module
+ *
+ * Exports for generating runtime bridge scripts.
+ * Re-exports from @frontmcp/uipack/bridge-runtime for compatibility.
+ *
+ * @packageDocumentation
+ */
+export { generateBridgeIIFE, generatePlatformBundle, UNIVERSAL_BRIDGE_SCRIPT, BRIDGE_SCRIPT_TAGS, type IIFEGeneratorOptions, } from '@frontmcp/uipack';
+//# 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;AAGH,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC"}

package/bridge/types.d.ts

@@ -0,0 +1,386 @@
+/**
+ * FrontMcpBridge Core Types
+ *
+ * Type definitions for the unified multi-platform adapter system.
+ * Supports OpenAI, Claude, ext-apps (SEP-1865), Gemini, and custom adapters.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Widget display mode preference.
+ */
+export type DisplayMode = 'inline' | 'fullscreen' | 'pip' | 'carousel';
+/**
+ * User agent information for device capability detection.
+ */
+export interface UserAgentInfo {
+    /** Device type */
+    type: 'web' | 'mobile' | 'desktop';
+    /** Has hover capability (mouse/trackpad) */
+    hover: boolean;
+    /** Has touch capability */
+    touch: boolean;
+}
+/**
+ * Safe area insets for mobile devices (notch, home indicator, etc.)
+ */
+export interface SafeAreaInsets {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+/**
+ * Viewport information for responsive widgets.
+ */
+export interface ViewportInfo {
+    width?: number;
+    height?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+}
+/**
+ * Host context provided by the AI platform.
+ */
+export interface HostContext {
+    /** Current theme */
+    theme: 'light' | 'dark';
+    /** Current display mode */
+    displayMode: DisplayMode;
+    /** BCP 47 locale */
+    locale: string;
+    /** IANA timezone */
+    timezone?: string;
+    /** User agent capabilities */
+    userAgent: UserAgentInfo;
+    /** Safe area insets */
+    safeArea: SafeAreaInsets;
+    /** Viewport dimensions */
+    viewport?: ViewportInfo;
+    /** Platform identifier */
+    platform?: 'web' | 'desktop' | 'ios' | 'android';
+}
+/**
+ * Capability flags for platform adapters.
+ * Used for feature detection before calling unavailable features.
+ */
+export interface AdapterCapabilities {
+    /** Can invoke server-side MCP tools */
+    canCallTools: boolean;
+    /** Can send follow-up messages to the conversation */
+    canSendMessages: boolean;
+    /** Can open external links */
+    canOpenLinks: boolean;
+    /** Can persist widget state across sessions */
+    canPersistState: boolean;
+    /** Has network access for fetch/XHR */
+    hasNetworkAccess: boolean;
+    /** Supports display mode changes (fullscreen, pip) */
+    supportsDisplayModes: boolean;
+    /** Supports theme detection */
+    supportsTheme: boolean;
+    /** Custom capability extensions */
+    extensions?: Record<string, boolean>;
+}
+/**
+ * Platform adapter interface - implemented by each platform.
+ * Provides a consistent API across OpenAI, Claude, ext-apps, Gemini, etc.
+ */
+export interface PlatformAdapter {
+    /** Unique adapter identifier (e.g., 'openai', 'claude', 'ext-apps') */
+    readonly id: string;
+    /** Human-readable adapter name */
+    readonly name: string;
+    /** Adapter priority for auto-detection (higher = checked first) */
+    readonly priority: number;
+    /** Static capability flags */
+    readonly capabilities: AdapterCapabilities;
+    /**
+     * Check if this adapter can handle the current environment.
+     * Called during auto-detection to find the best adapter.
+     */
+    canHandle(): boolean;
+    /**
+     * Initialize the adapter.
+     * For ext-apps, this performs the ui/initialize handshake.
+     * @returns Promise that resolves when the adapter is ready
+     */
+    initialize(): Promise<void>;
+    /**
+     * Clean up adapter resources.
+     * Called when switching adapters or disposing the bridge.
+     */
+    dispose(): void;
+    /** Get current theme */
+    getTheme(): 'light' | 'dark';
+    /** Get current display mode */
+    getDisplayMode(): DisplayMode;
+    /** Get user agent info */
+    getUserAgent(): UserAgentInfo;
+    /** Get BCP 47 locale */
+    getLocale(): string;
+    /** Get tool input arguments */
+    getToolInput(): Record<string, unknown>;
+    /** Get tool output/result */
+    getToolOutput(): unknown;
+    /** Get structured content (parsed output) */
+    getStructuredContent(): unknown;
+    /** Get persisted widget state */
+    getWidgetState(): Record<string, unknown>;
+    /** Get safe area insets */
+    getSafeArea(): SafeAreaInsets;
+    /** Get viewport info */
+    getViewport(): ViewportInfo | undefined;
+    /** Get full host context */
+    getHostContext(): HostContext;
+    /**
+     * Call a tool on the MCP server.
+     * @param name - Tool name
+     * @param args - Tool arguments
+     * @returns Promise resolving to tool result
+     */
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Send a follow-up message to the conversation.
+     * @param content - Message content
+     */
+    sendMessage(content: string): Promise<void>;
+    /**
+     * Open an external link.
+     * @param url - URL to open
+     */
+    openLink(url: string): Promise<void>;
+    /**
+     * Request a display mode change.
+     * @param mode - Desired display mode
+     */
+    requestDisplayMode(mode: DisplayMode): Promise<void>;
+    /**
+     * Request widget close.
+     */
+    requestClose(): Promise<void>;
+    /**
+     * Set widget state (persisted across sessions).
+     * @param state - State object to persist
+     */
+    setWidgetState(state: Record<string, unknown>): void;
+    /**
+     * Subscribe to host context changes.
+     * @param callback - Called when context changes (theme, displayMode, etc.)
+     * @returns Unsubscribe function
+     */
+    onContextChange(callback: (changes: Partial<HostContext>) => void): () => void;
+    /**
+     * Subscribe to tool result updates.
+     * @param callback - Called when tool result is received
+     * @returns Unsubscribe function
+     */
+    onToolResult(callback: (result: unknown) => void): () => void;
+}
+/**
+ * Per-adapter configuration options.
+ */
+export interface AdapterConfig {
+    /** Enable/disable this adapter */
+    enabled?: boolean;
+    /** Priority override */
+    priority?: number;
+    /** Adapter-specific options */
+    options?: Record<string, unknown>;
+}
+/**
+ * FrontMcpBridge configuration.
+ */
+export interface BridgeConfig {
+    /** Force a specific adapter (skip auto-detection) */
+    forceAdapter?: string;
+    /** Explicitly disable certain adapters */
+    disabledAdapters?: string[];
+    /** Debug mode (verbose logging) */
+    debug?: boolean;
+    /** Timeout for adapter initialization (ms) */
+    initTimeout?: number;
+    /** Trusted origins for postMessage (ext-apps security) */
+    trustedOrigins?: string[];
+    /** Per-adapter configurations */
+    adapterConfigs?: Record<string, AdapterConfig>;
+}
+/**
+ * JSON-RPC 2.0 message base.
+ */
+export interface JsonRpcMessage {
+    jsonrpc: '2.0';
+}
+/**
+ * JSON-RPC request message.
+ */
+export interface JsonRpcRequest extends JsonRpcMessage {
+    id: string | number;
+    method: string;
+    params?: unknown;
+}
+/**
+ * JSON-RPC response message.
+ */
+export interface JsonRpcResponse extends JsonRpcMessage {
+    id: string | number;
+    result?: unknown;
+    error?: JsonRpcError;
+}
+/**
+ * JSON-RPC notification message (no id, no response expected).
+ */
+export interface JsonRpcNotification extends JsonRpcMessage {
+    method: string;
+    params?: unknown;
+}
+/**
+ * JSON-RPC error object.
+ */
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/**
+ * SEP-1865 ui/initialize request params.
+ */
+export interface ExtAppsInitializeParams {
+    appInfo: {
+        name: string;
+        version: string;
+    };
+    appCapabilities: {
+        tools?: {
+            listChanged: boolean;
+        };
+    };
+    protocolVersion: string;
+}
+/**
+ * SEP-1865 ui/initialize response result.
+ */
+export interface ExtAppsInitializeResult {
+    protocolVersion: string;
+    hostInfo: {
+        name: string;
+        version: string;
+    };
+    hostCapabilities: {
+        openLink?: boolean;
+        serverToolProxy?: boolean;
+        resourceRead?: boolean;
+        logging?: boolean;
+    };
+    hostContext: HostContext;
+}
+/**
+ * SEP-1865 tool input notification params.
+ */
+export interface ExtAppsToolInputParams {
+    arguments: Record<string, unknown>;
+}
+/**
+ * SEP-1865 tool result notification params.
+ */
+export interface ExtAppsToolResultParams {
+    content: unknown;
+    structuredContent?: unknown;
+    isError?: boolean;
+}
+/**
+ * SEP-1865 host context change notification params.
+ */
+export interface ExtAppsHostContextChangeParams {
+    theme?: 'light' | 'dark';
+    displayMode?: DisplayMode;
+    viewport?: ViewportInfo;
+    locale?: string;
+    timezone?: string;
+}
+/**
+ * Bridge event types for CustomEvent dispatch.
+ */
+export type BridgeEventType = 'bridge:ready' | 'bridge:error' | 'bridge:adapter-changed' | 'context:change' | 'tool:input' | 'tool:input-partial' | 'tool:result' | 'tool:cancelled';
+/**
+ * Bridge event payload map.
+ */
+export interface BridgeEventPayloads {
+    'bridge:ready': {
+        adapter: string;
+    };
+    'bridge:error': {
+        error: Error;
+        adapter?: string;
+    };
+    'bridge:adapter-changed': {
+        from?: string;
+        to: string;
+    };
+    'context:change': Partial<HostContext>;
+    'tool:input': {
+        arguments: Record<string, unknown>;
+    };
+    'tool:input-partial': {
+        arguments: Record<string, unknown>;
+    };
+    'tool:result': {
+        content: unknown;
+        structuredContent?: unknown;
+    };
+    'tool:cancelled': {
+        reason?: string;
+    };
+}
+/**
+ * Adapter factory function type.
+ */
+export type AdapterFactory = (config?: AdapterConfig) => PlatformAdapter;
+/**
+ * Adapter registration entry.
+ */
+export interface AdapterRegistration {
+    id: string;
+    factory: AdapterFactory;
+    defaultConfig?: AdapterConfig;
+}
+/**
+ * FrontMcpBridge public interface.
+ * Unified entry point for all platform interactions.
+ */
+export interface FrontMcpBridgeInterface {
+    /** Whether the bridge is initialized */
+    readonly initialized: boolean;
+    /** Current adapter ID */
+    readonly adapterId: string | undefined;
+    /** Current adapter capabilities */
+    readonly capabilities: AdapterCapabilities | undefined;
+    /**
+     * Initialize the bridge (auto-detects platform).
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the active adapter.
+     */
+    getAdapter(): PlatformAdapter | undefined;
+    /**
+     * Check if a specific capability is available.
+     */
+    hasCapability(cap: keyof AdapterCapabilities): boolean;
+    /**
+     * Dispose the bridge and release resources.
+     */
+    dispose(): void;
+    getTheme(): 'light' | 'dark';
+    getDisplayMode(): DisplayMode;
+    getToolInput(): Record<string, unknown>;
+    getToolOutput(): unknown;
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+    sendMessage(content: string): Promise<void>;
+    openLink(url: string): Promise<void>;
+    requestDisplayMode(mode: DisplayMode): Promise<void>;
+    setWidgetState(state: Record<string, unknown>): void;
+    onContextChange(callback: (changes: Partial<HostContext>) => void): () => void;
+    onToolResult(callback: (result: unknown) => void): () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/bridge/types.d.ts.map

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

package/bundler/bundler.d.ts

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

package/bundler/bundler.d.ts.map

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