open-mcp-app 0.0.2 → 0.0.4

package/dist/core/index.d.ts

@@ -903,118 +903,49 @@ declare class StandaloneHostClient extends Subscribable implements UnifiedHostCl
 }
 
 /**
- * Environment-Aware Default Styles
+ * SDK Layout Variables
  *
- * This module provides default CSS variable values for MCP Apps and ChatGPT Apps.
- * Import `initDefaultStyles` early in your app entry point to prevent flash of unstyled content.
+ * This module provides SDK-only CSS variables for spacing, containers, and component sizing.
+ * These are NOT part of the MCP Apps spec - they are convenient defaults for clean layouts.
  *
- * The MCP Apps spec defines CSS variable names (e.g., --color-background-primary).
- * This module provides environment-specific VALUES for those variables as sensible
- * defaults until the host injects its own values.
+ * Host-provided spec variables (colors, typography, etc.) are applied automatically
+ * when the app initializes via hostContext.styles.variables. Apps are not shown until
+ * initialization is complete, so there's no need for pre-host defaults.
  *
- * Flow:
- * 1. Detect environment (ChatGPT, MCP Apps, or Standalone)
- * 2. Detect theme (light or dark)
- * 3. Inject defaults immediately on document.documentElement
- * 4. When host connects, host variables override these defaults
- *
- * IMPORTANT: MCP Apps defaults match Creature's actual values exactly.
- * The observer only runs for ChatGPT (MCP Apps hosts handle theme changes themselves).
- */
-
-/**
- * Theme mode for styling.
- */
-type Theme = "light" | "dark";
-/**
- * Options for initializing styles.
- */
-interface InitStylesOptions {
-    /** Whether to set up a MutationObserver for dynamic theme changes. Default: true for ChatGPT only */
-    observeThemeChanges?: boolean;
-}
-/**
- * MCP Apps / Creature default values - DARK mode.
- * These values are extracted directly from Creature's globals.css.
- * They MUST match exactly what Creature sends via hostContext.styles.variables.
- */
-declare const MCP_APPS_DARK_DEFAULTS: Record<string, string>;
-/**
- * MCP Apps / Creature default values - LIGHT mode.
- * These values are extracted directly from Creature's globals.css.
- */
-declare const MCP_APPS_LIGHT_DEFAULTS: Record<string, string>;
-/**
- * Shared MCP Apps / Creature typography and layout tokens (same for light/dark).
- * These values are extracted directly from Creature's globals.css.
- */
-declare const MCP_APPS_SHARED_DEFAULTS: Record<string, string>;
-/**
- * ChatGPT Apps default values - LIGHT mode.
- * Ported from @openai/apps-sdk-ui design tokens.
- */
-declare const CHATGPT_LIGHT_DEFAULTS: Record<string, string>;
-/**
- * ChatGPT Apps default values - DARK mode.
- */
-declare const CHATGPT_DARK_DEFAULTS: Record<string, string>;
-/**
- * Shared ChatGPT typography and layout tokens (same for light/dark).
- */
-declare const CHATGPT_SHARED_DEFAULTS: Record<string, string>;
-/**
- * Get MCP Apps default styles for the specified theme.
- * Returns CSS variable names with their default values.
- * These values match exactly what Creature sends via hostContext.styles.variables.
- *
- * @param theme - The theme to get defaults for
- * @returns Record of CSS variable names to their values
- */
-declare const getMcpAppDefaultStyles: ({ theme }: {
-    theme: Theme;
-}) => Record<string, string>;
-/**
- * Get ChatGPT Apps default styles for the specified theme.
- * Returns CSS variable names with their values matching the @openai/apps-sdk-ui design tokens.
- *
- * @param theme - The theme to get defaults for
- * @returns Record of CSS variable names to their values
+ * Usage:
+ * 1. Import base.css which uses these variables
+ * 2. Or apply them manually via applyLayoutDefaults()
  */
-declare const getChatGptDefaultStyles: ({ theme }: {
-    theme: Theme;
-}) => Record<string, string>;
 /**
- * Detect the current theme from the document.
- * Checks data-theme attribute, dark class (Tailwind), and prefers-color-scheme.
+ * SDK-only layout variables for spacing, containers, and component sizing.
+ * These are NOT part of the MCP Apps spec but provide sensible defaults
+ * for clean layouts.
  *
- * @returns The detected theme
+ * Based on a 4px (0.25rem) base unit, similar to Tailwind's spacing scale.
+ * Component sizing follows patterns from @openai/apps-sdk-ui for consistency.
  */
-declare const detectTheme: () => Theme;
+declare const LAYOUT_DEFAULTS: Record<string, string>;
 /**
- * Apply CSS variables to the document root.
+ * Apply CSS variables to an element (defaults to document root).
  *
  * @param styles - Record of CSS variable names to their values
+ * @param root - Element to apply styles to (defaults to document.documentElement)
  */
-declare const applyStyles: ({ styles }: {
+declare const applyStyles: ({ styles, root, }: {
     styles: Record<string, string>;
+    root?: HTMLElement;
 }) => void;
 /**
- * Initialize default styles based on detected environment and theme.
- * This should be called early in your app entry point to prevent FOUC.
+ * Apply SDK layout defaults to the document.
+ * This applies spacing, container, and control variables.
  *
- * For MCP Apps (Creature): Applies defaults once. The host handles theme changes
- * and sends new styles via hostContext, which override these defaults.
+ * Note: If you import base.css, these variables are already defined via :root.
+ * Only call this manually if you need to apply them programmatically or
+ * to a specific element other than document root.
  *
- * For ChatGPT: Applies defaults and sets up an observer to handle theme changes,
- * since ChatGPT may change theme before sending new hostContext.
- *
- * @param environment - The detected environment (from detectEnvironment)
- * @param options - Configuration options
+ * @param root - Element to apply styles to (defaults to document.documentElement)
  */
-declare const initDefaultStyles: ({ environment, options, }: {
-    environment: Environment;
-    options?: InitStylesOptions;
-}) => void;
+declare const applyLayoutDefaults: (root?: HTMLElement) => void;
 
 /**
  * Create a WebSocket client with automatic reconnection.
@@ -1092,4 +1023,4 @@ declare const createHost: (config: HostClientConfig) => UnifiedHostClient;
  */
 declare const createHostAsync: (config: HostClientConfig) => Promise<UnifiedHostClient>;
 
-export { CHATGPT_DARK_DEFAULTS, CHATGPT_LIGHT_DEFAULTS, CHATGPT_SHARED_DEFAULTS, ChatGptWebHostClient, ClaudeDesktopHostClient, type ContentBlock, CreatureDesktopHostClient, type DisplayMode, type Environment, type ExpHostApi, type HostClientConfig, type HostClientEvents, type HostClientState, type HostContext, type ImageContentBlock, type InitStylesOptions, type LogLevel, MCP_APPS_DARK_DEFAULTS, MCP_APPS_LIGHT_DEFAULTS, MCP_APPS_SHARED_DEFAULTS, type OpenContext, StandaloneHostClient, type StateListener, type StructuredWidgetState, type TextContentBlock, type Theme, type ToolResult, type UnifiedHostClient, type WebSocketClient, type WebSocketClientConfig, type WebSocketStatus, type WidgetState, applyStyles, createHost, createHostAsync, createWebSocket, detectEnvironment, detectTheme, getChatGptDefaultStyles, getMcpAppDefaultStyles, initDefaultStyles };
+export { ChatGptWebHostClient, ClaudeDesktopHostClient, type ContentBlock, CreatureDesktopHostClient, type DisplayMode, type Environment, type ExpHostApi, type HostClientConfig, type HostClientEvents, type HostClientState, type HostContext, type ImageContentBlock, LAYOUT_DEFAULTS, type LogLevel, type OpenContext, StandaloneHostClient, type StateListener, type StructuredWidgetState, type TextContentBlock, type ToolResult, type UnifiedHostClient, type WebSocketClient, type WebSocketClientConfig, type WebSocketStatus, type WidgetState, applyLayoutDefaults, applyStyles, createHost, createHostAsync, createWebSocket, detectEnvironment };