@frontmcp/ui 0.5.0 → 0.6.0

package/src/bridge/adapters/base-adapter.js

@@ -1,314 +0,0 @@
-"use strict";
-/**
- * Base Platform Adapter
- *
- * Abstract base class for platform adapters with default implementations.
- * Extend this class to create custom adapters for new platforms.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseAdapter = exports.DEFAULT_SAFE_AREA = exports.DEFAULT_CAPABILITIES = void 0;
-/**
- * Default adapter capabilities (most features disabled).
- */
-exports.DEFAULT_CAPABILITIES = {
-    canCallTools: false,
-    canSendMessages: false,
-    canOpenLinks: false,
-    canPersistState: true, // localStorage fallback
-    hasNetworkAccess: true,
-    supportsDisplayModes: false,
-    supportsTheme: true,
-};
-/**
- * Default safe area insets (no insets).
- */
-exports.DEFAULT_SAFE_AREA = {
-    top: 0,
-    bottom: 0,
-    left: 0,
-    right: 0,
-};
-/**
- * Abstract base class for platform adapters.
- * Provides default implementations that can be overridden.
- */
-class BaseAdapter {
-    _capabilities = { ...exports.DEFAULT_CAPABILITIES };
-    _hostContext;
-    _widgetState = {};
-    _toolInput = {};
-    _toolOutput = undefined;
-    _structuredContent = undefined;
-    _initialized = false;
-    _contextListeners = new Set();
-    _toolResultListeners = new Set();
-    constructor() {
-        this._hostContext = this._createDefaultHostContext();
-    }
-    get capabilities() {
-        return this._capabilities;
-    }
-    async initialize() {
-        if (this._initialized)
-            return;
-        // Load persisted widget state
-        this._loadWidgetState();
-        // Read injected tool data
-        this._readInjectedData();
-        this._initialized = true;
-    }
-    dispose() {
-        this._contextListeners.clear();
-        this._toolResultListeners.clear();
-        this._initialized = false;
-    }
-    // ============================================
-    // Data Access
-    // ============================================
-    getTheme() {
-        return this._hostContext.theme;
-    }
-    getDisplayMode() {
-        return this._hostContext.displayMode;
-    }
-    getUserAgent() {
-        return this._hostContext.userAgent;
-    }
-    getLocale() {
-        return this._hostContext.locale;
-    }
-    getToolInput() {
-        return this._toolInput;
-    }
-    getToolOutput() {
-        return this._toolOutput;
-    }
-    getStructuredContent() {
-        return this._structuredContent;
-    }
-    getWidgetState() {
-        return this._widgetState;
-    }
-    getSafeArea() {
-        return this._hostContext.safeArea;
-    }
-    getViewport() {
-        return this._hostContext.viewport;
-    }
-    getHostContext() {
-        return { ...this._hostContext };
-    }
-    // ============================================
-    // Actions (override in subclasses for real functionality)
-    // ============================================
-    async callTool(_name, _args) {
-        if (!this._capabilities.canCallTools) {
-            throw new Error(`Tool calls are not supported by ${this.name} adapter`);
-        }
-        throw new Error('callTool not implemented');
-    }
-    async sendMessage(_content) {
-        if (!this._capabilities.canSendMessages) {
-            throw new Error(`Sending messages is not supported by ${this.name} adapter`);
-        }
-        throw new Error('sendMessage not implemented');
-    }
-    async openLink(url) {
-        if (!this._capabilities.canOpenLinks) {
-            // Fallback: try window.open
-            if (typeof window !== 'undefined') {
-                window.open(url, '_blank', 'noopener,noreferrer');
-                return;
-            }
-            throw new Error(`Opening links is not supported by ${this.name} adapter`);
-        }
-        throw new Error('openLink not implemented');
-    }
-    async requestDisplayMode(_mode) {
-        if (!this._capabilities.supportsDisplayModes) {
-            // Silently ignore on unsupported platforms
-            return;
-        }
-        throw new Error('requestDisplayMode not implemented');
-    }
-    async requestClose() {
-        // Default: no-op (host controls widget lifecycle)
-    }
-    setWidgetState(state) {
-        this._widgetState = { ...this._widgetState, ...state };
-        this._persistWidgetState();
-    }
-    // ============================================
-    // Events
-    // ============================================
-    onContextChange(callback) {
-        this._contextListeners.add(callback);
-        return () => {
-            this._contextListeners.delete(callback);
-        };
-    }
-    onToolResult(callback) {
-        this._toolResultListeners.add(callback);
-        return () => {
-            this._toolResultListeners.delete(callback);
-        };
-    }
-    // ============================================
-    // Protected Helpers
-    // ============================================
-    /**
-     * Create default host context from environment detection.
-     */
-    _createDefaultHostContext() {
-        return {
-            theme: this._detectTheme(),
-            displayMode: 'inline',
-            locale: this._detectLocale(),
-            userAgent: this._detectUserAgent(),
-            safeArea: exports.DEFAULT_SAFE_AREA,
-            viewport: this._detectViewport(),
-        };
-    }
-    /**
-     * Detect theme from CSS media query.
-     */
-    _detectTheme() {
-        if (typeof window !== 'undefined' && window.matchMedia) {
-            return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
-        }
-        return 'light';
-    }
-    /**
-     * Detect locale from navigator.
-     */
-    _detectLocale() {
-        if (typeof navigator !== 'undefined') {
-            return navigator.language || 'en-US';
-        }
-        return 'en-US';
-    }
-    /**
-     * Detect user agent capabilities.
-     */
-    _detectUserAgent() {
-        if (typeof navigator === 'undefined') {
-            return { type: 'web', hover: true, touch: false };
-        }
-        const ua = navigator.userAgent || '';
-        const isMobile = /iPhone|iPad|iPod|Android/i.test(ua);
-        const hasTouch = 'ontouchstart' in window || navigator.maxTouchPoints > 0;
-        const hasHover = typeof window !== 'undefined' && window.matchMedia && window.matchMedia('(hover: hover)').matches;
-        return {
-            type: isMobile ? 'mobile' : 'web',
-            hover: hasHover !== false,
-            touch: hasTouch,
-        };
-    }
-    /**
-     * Detect viewport dimensions.
-     */
-    _detectViewport() {
-        if (typeof window !== 'undefined') {
-            return {
-                width: window.innerWidth,
-                height: window.innerHeight,
-            };
-        }
-        return undefined;
-    }
-    /**
-     * Read injected tool data from window globals.
-     */
-    _readInjectedData() {
-        if (typeof window === 'undefined')
-            return;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const win = window;
-        if (win.__mcpToolInput) {
-            this._toolInput = win.__mcpToolInput;
-        }
-        if (win.__mcpToolOutput) {
-            this._toolOutput = win.__mcpToolOutput;
-        }
-        if (win.__mcpStructuredContent) {
-            this._structuredContent = win.__mcpStructuredContent;
-        }
-        if (win.__mcpHostContext) {
-            this._hostContext = { ...this._hostContext, ...win.__mcpHostContext };
-        }
-    }
-    /**
-     * Load widget state from localStorage.
-     */
-    _loadWidgetState() {
-        if (typeof localStorage === 'undefined')
-            return;
-        try {
-            const key = this._getStateKey();
-            const stored = localStorage.getItem(key);
-            if (stored) {
-                this._widgetState = JSON.parse(stored);
-            }
-        }
-        catch {
-            // Ignore storage errors
-        }
-    }
-    /**
-     * Persist widget state to localStorage.
-     */
-    _persistWidgetState() {
-        if (typeof localStorage === 'undefined')
-            return;
-        try {
-            const key = this._getStateKey();
-            localStorage.setItem(key, JSON.stringify(this._widgetState));
-        }
-        catch {
-            // Ignore storage errors
-        }
-    }
-    /**
-     * Get localStorage key for widget state.
-     */
-    _getStateKey() {
-        if (typeof window !== 'undefined') {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const toolName = window.__mcpToolName || 'unknown';
-            return `frontmcp:widget:${toolName}`;
-        }
-        return 'frontmcp:widget:unknown';
-    }
-    /**
-     * Notify context change listeners.
-     */
-    _notifyContextChange(changes) {
-        this._hostContext = { ...this._hostContext, ...changes };
-        this._contextListeners.forEach((cb) => {
-            try {
-                cb(changes);
-            }
-            catch (e) {
-                console.error('[FrontMcpBridge] Context change listener error:', e);
-            }
-        });
-    }
-    /**
-     * Notify tool result listeners.
-     */
-    _notifyToolResult(result) {
-        this._toolOutput = result;
-        this._toolResultListeners.forEach((cb) => {
-            try {
-                cb(result);
-            }
-            catch (e) {
-                console.error('[FrontMcpBridge] Tool result listener error:', e);
-            }
-        });
-    }
-}
-exports.BaseAdapter = BaseAdapter;
-//# sourceMappingURL=base-adapter.js.map

package/src/bridge/adapters/base-adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-adapter.js","sourceRoot":"","sources":["../../../../src/bridge/adapters/base-adapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Base Platform Adapter\n *\n * Abstract base class for platform adapters with default implementations.\n * Extend this class to create custom adapters for new platforms.\n *\n * @packageDocumentation\n */\n\nimport type {\n  PlatformAdapter,\n  AdapterCapabilities,\n  DisplayMode,\n  UserAgentInfo,\n  SafeAreaInsets,\n  ViewportInfo,\n  HostContext,\n} from '../types';\n\n/**\n * Default adapter capabilities (most features disabled).\n */\nexport const DEFAULT_CAPABILITIES: AdapterCapabilities = {\n  canCallTools: false,\n  canSendMessages: false,\n  canOpenLinks: false,\n  canPersistState: true, // localStorage fallback\n  hasNetworkAccess: true,\n  supportsDisplayModes: false,\n  supportsTheme: true,\n};\n\n/**\n * Default safe area insets (no insets).\n */\nexport const DEFAULT_SAFE_AREA: SafeAreaInsets = {\n  top: 0,\n  bottom: 0,\n  left: 0,\n  right: 0,\n};\n\n/**\n * Abstract base class for platform adapters.\n * Provides default implementations that can be overridden.\n */\nexport abstract class BaseAdapter implements PlatformAdapter {\n  abstract readonly id: string;\n  abstract readonly name: string;\n  abstract readonly priority: number;\n\n  protected _capabilities: AdapterCapabilities = { ...DEFAULT_CAPABILITIES };\n  protected _hostContext: HostContext;\n  protected _widgetState: Record<string, unknown> = {};\n  protected _toolInput: Record<string, unknown> = {};\n  protected _toolOutput: unknown = undefined;\n  protected _structuredContent: unknown = undefined;\n  protected _initialized = false;\n\n  protected _contextListeners: Set<(changes: Partial<HostContext>) => void> = new Set();\n  protected _toolResultListeners: Set<(result: unknown) => void> = new Set();\n\n  constructor() {\n    this._hostContext = this._createDefaultHostContext();\n  }\n\n  get capabilities(): AdapterCapabilities {\n    return this._capabilities;\n  }\n\n  // ============================================\n  // Lifecycle (override in subclasses)\n  // ============================================\n\n  abstract canHandle(): boolean;\n\n  async initialize(): Promise<void> {\n    if (this._initialized) return;\n\n    // Load persisted widget state\n    this._loadWidgetState();\n\n    // Read injected tool data\n    this._readInjectedData();\n\n    this._initialized = true;\n  }\n\n  dispose(): void {\n    this._contextListeners.clear();\n    this._toolResultListeners.clear();\n    this._initialized = false;\n  }\n\n  // ============================================\n  // Data Access\n  // ============================================\n\n  getTheme(): 'light' | 'dark' {\n    return this._hostContext.theme;\n  }\n\n  getDisplayMode(): DisplayMode {\n    return this._hostContext.displayMode;\n  }\n\n  getUserAgent(): UserAgentInfo {\n    return this._hostContext.userAgent;\n  }\n\n  getLocale(): string {\n    return this._hostContext.locale;\n  }\n\n  getToolInput(): Record<string, unknown> {\n    return this._toolInput;\n  }\n\n  getToolOutput(): unknown {\n    return this._toolOutput;\n  }\n\n  getStructuredContent(): unknown {\n    return this._structuredContent;\n  }\n\n  getWidgetState(): Record<string, unknown> {\n    return this._widgetState;\n  }\n\n  getSafeArea(): SafeAreaInsets {\n    return this._hostContext.safeArea;\n  }\n\n  getViewport(): ViewportInfo | undefined {\n    return this._hostContext.viewport;\n  }\n\n  getHostContext(): HostContext {\n    return { ...this._hostContext };\n  }\n\n  // ============================================\n  // Actions (override in subclasses for real functionality)\n  // ============================================\n\n  async callTool(_name: string, _args: Record<string, unknown>): Promise<unknown> {\n    if (!this._capabilities.canCallTools) {\n      throw new Error(`Tool calls are not supported by ${this.name} adapter`);\n    }\n    throw new Error('callTool not implemented');\n  }\n\n  async sendMessage(_content: string): Promise<void> {\n    if (!this._capabilities.canSendMessages) {\n      throw new Error(`Sending messages is not supported by ${this.name} adapter`);\n    }\n    throw new Error('sendMessage not implemented');\n  }\n\n  async openLink(url: string): Promise<void> {\n    if (!this._capabilities.canOpenLinks) {\n      // Fallback: try window.open\n      if (typeof window !== 'undefined') {\n        window.open(url, '_blank', 'noopener,noreferrer');\n        return;\n      }\n      throw new Error(`Opening links is not supported by ${this.name} adapter`);\n    }\n    throw new Error('openLink not implemented');\n  }\n\n  async requestDisplayMode(_mode: DisplayMode): Promise<void> {\n    if (!this._capabilities.supportsDisplayModes) {\n      // Silently ignore on unsupported platforms\n      return;\n    }\n    throw new Error('requestDisplayMode not implemented');\n  }\n\n  async requestClose(): Promise<void> {\n    // Default: no-op (host controls widget lifecycle)\n  }\n\n  setWidgetState(state: Record<string, unknown>): void {\n    this._widgetState = { ...this._widgetState, ...state };\n    this._persistWidgetState();\n  }\n\n  // ============================================\n  // Events\n  // ============================================\n\n  onContextChange(callback: (changes: Partial<HostContext>) => void): () => void {\n    this._contextListeners.add(callback);\n    return () => {\n      this._contextListeners.delete(callback);\n    };\n  }\n\n  onToolResult(callback: (result: unknown) => void): () => void {\n    this._toolResultListeners.add(callback);\n    return () => {\n      this._toolResultListeners.delete(callback);\n    };\n  }\n\n  // ============================================\n  // Protected Helpers\n  // ============================================\n\n  /**\n   * Create default host context from environment detection.\n   */\n  protected _createDefaultHostContext(): HostContext {\n    return {\n      theme: this._detectTheme(),\n      displayMode: 'inline',\n      locale: this._detectLocale(),\n      userAgent: this._detectUserAgent(),\n      safeArea: DEFAULT_SAFE_AREA,\n      viewport: this._detectViewport(),\n    };\n  }\n\n  /**\n   * Detect theme from CSS media query.\n   */\n  protected _detectTheme(): 'light' | 'dark' {\n    if (typeof window !== 'undefined' && window.matchMedia) {\n      return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';\n    }\n    return 'light';\n  }\n\n  /**\n   * Detect locale from navigator.\n   */\n  protected _detectLocale(): string {\n    if (typeof navigator !== 'undefined') {\n      return navigator.language || 'en-US';\n    }\n    return 'en-US';\n  }\n\n  /**\n   * Detect user agent capabilities.\n   */\n  protected _detectUserAgent(): UserAgentInfo {\n    if (typeof navigator === 'undefined') {\n      return { type: 'web', hover: true, touch: false };\n    }\n\n    const ua = navigator.userAgent || '';\n    const isMobile = /iPhone|iPad|iPod|Android/i.test(ua);\n    const hasTouch = 'ontouchstart' in window || navigator.maxTouchPoints > 0;\n    const hasHover = typeof window !== 'undefined' && window.matchMedia && window.matchMedia('(hover: hover)').matches;\n\n    return {\n      type: isMobile ? 'mobile' : 'web',\n      hover: hasHover !== false,\n      touch: hasTouch,\n    };\n  }\n\n  /**\n   * Detect viewport dimensions.\n   */\n  protected _detectViewport(): ViewportInfo | undefined {\n    if (typeof window !== 'undefined') {\n      return {\n        width: window.innerWidth,\n        height: window.innerHeight,\n      };\n    }\n    return undefined;\n  }\n\n  /**\n   * Read injected tool data from window globals.\n   */\n  protected _readInjectedData(): void {\n    if (typeof window === 'undefined') return;\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const win = window as any;\n\n    if (win.__mcpToolInput) {\n      this._toolInput = win.__mcpToolInput;\n    }\n    if (win.__mcpToolOutput) {\n      this._toolOutput = win.__mcpToolOutput;\n    }\n    if (win.__mcpStructuredContent) {\n      this._structuredContent = win.__mcpStructuredContent;\n    }\n    if (win.__mcpHostContext) {\n      this._hostContext = { ...this._hostContext, ...win.__mcpHostContext };\n    }\n  }\n\n  /**\n   * Load widget state from localStorage.\n   */\n  protected _loadWidgetState(): void {\n    if (typeof localStorage === 'undefined') return;\n\n    try {\n      const key = this._getStateKey();\n      const stored = localStorage.getItem(key);\n      if (stored) {\n        this._widgetState = JSON.parse(stored);\n      }\n    } catch {\n      // Ignore storage errors\n    }\n  }\n\n  /**\n   * Persist widget state to localStorage.\n   */\n  protected _persistWidgetState(): void {\n    if (typeof localStorage === 'undefined') return;\n\n    try {\n      const key = this._getStateKey();\n      localStorage.setItem(key, JSON.stringify(this._widgetState));\n    } catch {\n      // Ignore storage errors\n    }\n  }\n\n  /**\n   * Get localStorage key for widget state.\n   */\n  protected _getStateKey(): string {\n    if (typeof window !== 'undefined') {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const toolName = (window as any).__mcpToolName || 'unknown';\n      return `frontmcp:widget:${toolName}`;\n    }\n    return 'frontmcp:widget:unknown';\n  }\n\n  /**\n   * Notify context change listeners.\n   */\n  protected _notifyContextChange(changes: Partial<HostContext>): void {\n    this._hostContext = { ...this._hostContext, ...changes };\n    this._contextListeners.forEach((cb) => {\n      try {\n        cb(changes);\n      } catch (e) {\n        console.error('[FrontMcpBridge] Context change listener error:', e);\n      }\n    });\n  }\n\n  /**\n   * Notify tool result listeners.\n   */\n  protected _notifyToolResult(result: unknown): void {\n    this._toolOutput = result;\n    this._toolResultListeners.forEach((cb) => {\n      try {\n        cb(result);\n      } catch (e) {\n        console.error('[FrontMcpBridge] Tool result listener error:', e);\n      }\n    });\n  }\n}\n"]}

package/src/bridge/adapters/claude.adapter.d.ts

@@ -1,66 +0,0 @@
-/**
- * Claude Platform Adapter
- *
- * Adapter for Claude (Anthropic) artifacts and widgets.
- * Claude artifacts have network restrictions - external fetches are blocked.
- * This adapter relies on injected data and localStorage for state.
- *
- * @packageDocumentation
- */
-import type { DisplayMode } from '../types';
-import { BaseAdapter } from './base-adapter';
-/**
- * Claude adapter for Anthropic's Claude AI.
- *
- * Features:
- * - Theme detection from system preferences
- * - Injected tool data via window globals
- * - LocalStorage persistence for widget state
- * - No external network access (blocked by Claude)
- *
- * @example
- * ```typescript
- * import { ClaudeAdapter } from '@frontmcp/ui/bridge';
- *
- * const adapter = new ClaudeAdapter();
- * if (adapter.canHandle()) {
- *   await adapter.initialize();
- *   const input = adapter.getToolInput();
- * }
- * ```
- */
-export declare class ClaudeAdapter extends BaseAdapter {
-    readonly id = "claude";
-    readonly name = "Claude (Anthropic)";
-    readonly priority = 60;
-    constructor();
-    /**
-     * Check if we're running in a Claude artifact/widget context.
-     */
-    canHandle(): boolean;
-    /**
-     * Initialize the Claude adapter.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Open a link in a new tab.
-     * This is one of the few actions available in Claude artifacts.
-     */
-    openLink(url: string): Promise<void>;
-    /**
-     * Request display mode change (no-op for Claude).
-     */
-    requestDisplayMode(_mode: DisplayMode): Promise<void>;
-    /**
-     * Request close (no-op for Claude).
-     */
-    requestClose(): Promise<void>;
-    /**
-     * Setup listener for system theme changes.
-     */
-    private _setupThemeListener;
-}
-/**
- * Factory function for creating Claude adapter instances.
- */
-export declare function createClaudeAdapter(): ClaudeAdapter;

package/src/bridge/adapters/claude.adapter.js

@@ -1,145 +0,0 @@
-"use strict";
-/**
- * Claude Platform Adapter
- *
- * Adapter for Claude (Anthropic) artifacts and widgets.
- * Claude artifacts have network restrictions - external fetches are blocked.
- * This adapter relies on injected data and localStorage for state.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ClaudeAdapter = void 0;
-exports.createClaudeAdapter = createClaudeAdapter;
-const base_adapter_1 = require("./base-adapter");
-/**
- * Claude adapter for Anthropic's Claude AI.
- *
- * Features:
- * - Theme detection from system preferences
- * - Injected tool data via window globals
- * - LocalStorage persistence for widget state
- * - No external network access (blocked by Claude)
- *
- * @example
- * ```typescript
- * import { ClaudeAdapter } from '@frontmcp/ui/bridge';
- *
- * const adapter = new ClaudeAdapter();
- * if (adapter.canHandle()) {
- *   await adapter.initialize();
- *   const input = adapter.getToolInput();
- * }
- * ```
- */
-class ClaudeAdapter extends base_adapter_1.BaseAdapter {
-    id = 'claude';
-    name = 'Claude (Anthropic)';
-    priority = 60;
-    constructor() {
-        super();
-        this._capabilities = {
-            ...base_adapter_1.DEFAULT_CAPABILITIES,
-            canCallTools: false, // Claude artifacts can't call tools
-            canSendMessages: false, // Can't send messages back to conversation
-            canOpenLinks: true, // Can open links via window.open
-            canPersistState: true, // localStorage works
-            hasNetworkAccess: false, // Network is blocked
-            supportsDisplayModes: false, // No display mode control
-            supportsTheme: true, // Can detect system theme
-        };
-    }
-    /**
-     * Check if we're running in a Claude artifact/widget context.
-     */
-    canHandle() {
-        if (typeof window === 'undefined')
-            return false;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const win = window;
-        // Check explicit platform marker
-        if (win.__mcpPlatform === 'claude')
-            return true;
-        // Check for Claude-specific global
-        if (win.claude)
-            return true;
-        // Check for Claude artifact markers
-        if (win.__claudeArtifact)
-            return true;
-        // Check URL patterns for Claude
-        if (typeof location !== 'undefined') {
-            const href = location.href;
-            if (href.includes('claude.ai') || href.includes('anthropic.com')) {
-                return true;
-            }
-        }
-        return false;
-    }
-    /**
-     * Initialize the Claude adapter.
-     */
-    async initialize() {
-        if (this._initialized)
-            return;
-        // Call base initialization (loads state, reads injected data)
-        await super.initialize();
-        // Setup theme detection listener
-        this._setupThemeListener();
-    }
-    /**
-     * Open a link in a new tab.
-     * This is one of the few actions available in Claude artifacts.
-     */
-    async openLink(url) {
-        if (typeof window !== 'undefined') {
-            window.open(url, '_blank', 'noopener,noreferrer');
-        }
-    }
-    /**
-     * Request display mode change (no-op for Claude).
-     */
-    async requestDisplayMode(_mode) {
-        // Claude doesn't support display mode changes
-        // Silently ignore
-    }
-    /**
-     * Request close (no-op for Claude).
-     */
-    async requestClose() {
-        // Claude artifacts can't close themselves
-        // Silently ignore
-    }
-    // ============================================
-    // Private Helpers
-    // ============================================
-    /**
-     * Setup listener for system theme changes.
-     */
-    _setupThemeListener() {
-        if (typeof window === 'undefined' || !window.matchMedia)
-            return;
-        const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
-        const handleChange = (e) => {
-            const newTheme = e.matches ? 'dark' : 'light';
-            if (newTheme !== this._hostContext.theme) {
-                this._notifyContextChange({ theme: newTheme });
-            }
-        };
-        // Use addEventListener if available (newer API)
-        if (mediaQuery.addEventListener) {
-            mediaQuery.addEventListener('change', handleChange);
-        }
-        else if (mediaQuery.addListener) {
-            // Fallback for older browsers
-            mediaQuery.addListener(handleChange);
-        }
-    }
-}
-exports.ClaudeAdapter = ClaudeAdapter;
-/**
- * Factory function for creating Claude adapter instances.
- */
-function createClaudeAdapter() {
-    return new ClaudeAdapter();
-}
-//# sourceMappingURL=claude.adapter.js.map

package/src/bridge/adapters/claude.adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"claude.adapter.js","sourceRoot":"","sources":["../../../../src/bridge/adapters/claude.adapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Claude Platform Adapter\n *\n * Adapter for Claude (Anthropic) artifacts and widgets.\n * Claude artifacts have network restrictions - external fetches are blocked.\n * This adapter relies on injected data and localStorage for state.\n *\n * @packageDocumentation\n */\n\nimport type { DisplayMode } from '../types';\nimport { BaseAdapter, DEFAULT_CAPABILITIES } from './base-adapter';\n\n/**\n * Claude adapter for Anthropic's Claude AI.\n *\n * Features:\n * - Theme detection from system preferences\n * - Injected tool data via window globals\n * - LocalStorage persistence for widget state\n * - No external network access (blocked by Claude)\n *\n * @example\n * ```typescript\n * import { ClaudeAdapter } from '@frontmcp/ui/bridge';\n *\n * const adapter = new ClaudeAdapter();\n * if (adapter.canHandle()) {\n *   await adapter.initialize();\n *   const input = adapter.getToolInput();\n * }\n * ```\n */\nexport class ClaudeAdapter extends BaseAdapter {\n  readonly id = 'claude';\n  readonly name = 'Claude (Anthropic)';\n  readonly priority = 60;\n\n  constructor() {\n    super();\n    this._capabilities = {\n      ...DEFAULT_CAPABILITIES,\n      canCallTools: false, // Claude artifacts can't call tools\n      canSendMessages: false, // Can't send messages back to conversation\n      canOpenLinks: true, // Can open links via window.open\n      canPersistState: true, // localStorage works\n      hasNetworkAccess: false, // Network is blocked\n      supportsDisplayModes: false, // No display mode control\n      supportsTheme: true, // Can detect system theme\n    };\n  }\n\n  /**\n   * Check if we're running in a Claude artifact/widget context.\n   */\n  canHandle(): boolean {\n    if (typeof window === 'undefined') return false;\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const win = window as any;\n\n    // Check explicit platform marker\n    if (win.__mcpPlatform === 'claude') return true;\n\n    // Check for Claude-specific global\n    if (win.claude) return true;\n\n    // Check for Claude artifact markers\n    if (win.__claudeArtifact) return true;\n\n    // Check URL patterns for Claude\n    if (typeof location !== 'undefined') {\n      const href = location.href;\n      if (href.includes('claude.ai') || href.includes('anthropic.com')) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * Initialize the Claude adapter.\n   */\n  override async initialize(): Promise<void> {\n    if (this._initialized) return;\n\n    // Call base initialization (loads state, reads injected data)\n    await super.initialize();\n\n    // Setup theme detection listener\n    this._setupThemeListener();\n  }\n\n  /**\n   * Open a link in a new tab.\n   * This is one of the few actions available in Claude artifacts.\n   */\n  override async openLink(url: string): Promise<void> {\n    if (typeof window !== 'undefined') {\n      window.open(url, '_blank', 'noopener,noreferrer');\n    }\n  }\n\n  /**\n   * Request display mode change (no-op for Claude).\n   */\n  override async requestDisplayMode(_mode: DisplayMode): Promise<void> {\n    // Claude doesn't support display mode changes\n    // Silently ignore\n  }\n\n  /**\n   * Request close (no-op for Claude).\n   */\n  override async requestClose(): Promise<void> {\n    // Claude artifacts can't close themselves\n    // Silently ignore\n  }\n\n  // ============================================\n  // Private Helpers\n  // ============================================\n\n  /**\n   * Setup listener for system theme changes.\n   */\n  private _setupThemeListener(): void {\n    if (typeof window === 'undefined' || !window.matchMedia) return;\n\n    const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');\n\n    const handleChange = (e: MediaQueryListEvent | MediaQueryList) => {\n      const newTheme = e.matches ? 'dark' : 'light';\n      if (newTheme !== this._hostContext.theme) {\n        this._notifyContextChange({ theme: newTheme });\n      }\n    };\n\n    // Use addEventListener if available (newer API)\n    if (mediaQuery.addEventListener) {\n      mediaQuery.addEventListener('change', handleChange);\n    } else if (mediaQuery.addListener) {\n      // Fallback for older browsers\n      mediaQuery.addListener(handleChange);\n    }\n  }\n}\n\n/**\n * Factory function for creating Claude adapter instances.\n */\nexport function createClaudeAdapter(): ClaudeAdapter {\n  return new ClaudeAdapter();\n}\n"]}