@supernal/interface 1.0.0

package/dist/cjs/src/exposure/ExposureCollector.js

@@ -0,0 +1,358 @@
+"use strict";
+/**
+ * ExposureCollector - Production-Quality Singleton (REQ-004)
+ *
+ * Collects and manages real-time tool exposure states across the entire application.
+ * Works with 1 tool or 10,000 tools - designed for production use.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExposureCollector = void 0;
+const ExposureState_1 = require("../types/ExposureState");
+class ExposureCollector {
+    constructor() {
+        /** Current state of all registered tools */
+        this.states = new Map();
+        /** Observers for state changes (global and per-tool) */
+        this.globalObservers = new Set();
+        this.toolObservers = new Map();
+        /** IntersectionObserver instances (one per tool element) */
+        this.intersectionObservers = new Map();
+        // Private constructor for singleton
+        this.initializeMutationObserver();
+    }
+    static getInstance() {
+        if (!ExposureCollector.instance) {
+            ExposureCollector.instance = new ExposureCollector();
+        }
+        return ExposureCollector.instance;
+    }
+    /**
+     * Register a tool and start observing its exposure state
+     */
+    registerTool(toolId, element, metadata) {
+        // Check for duplicate toolId
+        if (this.states.has(toolId)) {
+            console.warn(`⚠️  Tool "${toolId}" is already registered. Updating registration.\n` +
+                `   This might indicate duplicate tool IDs in your application.`);
+        }
+        const initialState = {
+            toolId,
+            state: element ? ExposureState_1.ExposureState.PRESENT : ExposureState_1.ExposureState.NOT_PRESENT,
+            element,
+            lastUpdate: Date.now(),
+            metadata,
+        };
+        this.states.set(toolId, initialState);
+        // Start observing if element exists
+        if (element) {
+            this.observeElement(toolId, element);
+        }
+    }
+    /**
+     * Unregister a tool and stop observing
+     */
+    unregisterTool(toolId) {
+        const observer = this.intersectionObservers.get(toolId);
+        if (observer) {
+            observer.disconnect();
+            this.intersectionObservers.delete(toolId);
+        }
+        this.states.delete(toolId);
+        this.toolObservers.delete(toolId);
+    }
+    /**
+     * Get current state of a tool
+     */
+    getToolState(toolId) {
+        return this.states.get(toolId);
+    }
+    /**
+     * Get all registered tools
+     */
+    getAllTools() {
+        return Array.from(this.states.values());
+    }
+    /**
+     * Subscribe to state changes (global or per-tool)
+     */
+    subscribe(observer, toolId) {
+        if (toolId) {
+            // Subscribe to specific tool
+            if (!this.toolObservers.has(toolId)) {
+                this.toolObservers.set(toolId, new Set());
+            }
+            this.toolObservers.get(toolId).add(observer);
+            return () => {
+                this.toolObservers.get(toolId)?.delete(observer);
+            };
+        }
+        else {
+            // Subscribe to all state changes
+            this.globalObservers.add(observer);
+            return () => {
+                this.globalObservers.delete(observer);
+            };
+        }
+    }
+    /**
+     * Wait for a tool to reach a specific state (returns Promise)
+     *
+     * @example
+     * const ready = await collector.waitForState('save-button', ExposureState.INTERACTABLE, 5000);
+     * if (ready) {
+     *   // Execute tool
+     * }
+     */
+    waitForState(toolId, targetState, timeoutMs = 5000) {
+        return new Promise((resolve) => {
+            const currentState = this.states.get(toolId);
+            // Already at target state or higher
+            if (currentState && currentState.state >= targetState) {
+                resolve(true);
+                return;
+            }
+            // Set up timeout
+            const timeout = setTimeout(() => {
+                unsubscribe();
+                resolve(false);
+            }, timeoutMs);
+            // Subscribe to state changes
+            const unsubscribe = this.subscribe((change) => {
+                if (change.newState >= targetState) {
+                    clearTimeout(timeout);
+                    unsubscribe();
+                    resolve(true);
+                }
+            }, toolId);
+        });
+    }
+    /**
+     * Manually update tool state (for external integrations)
+     */
+    updateToolState(toolId, newState, metadata) {
+        const currentState = this.states.get(toolId);
+        if (!currentState) {
+            console.warn(`Cannot update state for unregistered tool: ${toolId}`);
+            return;
+        }
+        if (currentState.state === newState) {
+            return; // No change
+        }
+        const change = {
+            toolId,
+            oldState: currentState.state,
+            newState,
+            timestamp: Date.now(),
+            metadata,
+        };
+        // Update state
+        currentState.state = newState;
+        currentState.lastUpdate = change.timestamp;
+        if (metadata) {
+            currentState.metadata = { ...currentState.metadata, ...metadata };
+        }
+        // Notify observers
+        this.notifyObservers(change);
+    }
+    /**
+     * Initialize DOM mutation observer to detect element additions/removals
+     */
+    initializeMutationObserver() {
+        if (typeof window === 'undefined' || typeof MutationObserver === 'undefined') {
+            return; // Not in browser environment
+        }
+        this.mutationObserver = new MutationObserver((mutations) => {
+            for (const mutation of mutations) {
+                if (mutation.type === 'childList') {
+                    // Check if any registered tools were added/removed
+                    this.handleDOMMutations(mutation);
+                }
+            }
+        });
+        // Observe entire document
+        this.mutationObserver.observe(document.body, {
+            childList: true,
+            subtree: true,
+        });
+    }
+    /**
+     * Handle DOM mutations to detect tool additions/removals
+     */
+    handleDOMMutations(mutation) {
+        // Check removed nodes
+        for (const node of Array.from(mutation.removedNodes)) {
+            if (node instanceof Element) {
+                for (const [toolId, state] of this.states.entries()) {
+                    if (state.element === node || node.contains(state.element)) {
+                        this.updateToolState(toolId, ExposureState_1.ExposureState.NOT_PRESENT, { reason: 'DOM element removed' });
+                    }
+                }
+            }
+        }
+        // Check added nodes (re-register tools that reappeared)
+        for (const node of Array.from(mutation.addedNodes)) {
+            if (node instanceof Element) {
+                for (const [toolId, state] of this.states.entries()) {
+                    if (state.state === ExposureState_1.ExposureState.NOT_PRESENT) {
+                        // Check if tool's element was added back (by data-tool-id or stored reference)
+                        const toolElement = this.findToolElement(toolId);
+                        if (toolElement) {
+                            state.element = toolElement;
+                            this.observeElement(toolId, toolElement);
+                            this.updateToolState(toolId, ExposureState_1.ExposureState.PRESENT, { reason: 'DOM element added' });
+                        }
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Find a tool's element by data-tool-id attribute
+     */
+    findToolElement(toolId) {
+        if (typeof document === 'undefined')
+            return null;
+        return document.querySelector(`[data-tool-id="${toolId}"]`);
+    }
+    /**
+     * Observe an element for visibility and interaction changes
+     */
+    observeElement(toolId, element) {
+        // Clean up existing observer
+        const existingObserver = this.intersectionObservers.get(toolId);
+        if (existingObserver) {
+            existingObserver.disconnect();
+        }
+        // Create IntersectionObserver to detect visibility and viewport exposure
+        const observer = new IntersectionObserver((entries) => {
+            for (const entry of entries) {
+                this.handleIntersectionChange(toolId, entry);
+            }
+        }, { threshold: [0, 0.1] } // Trigger when any part becomes visible
+        );
+        observer.observe(element);
+        this.intersectionObservers.set(toolId, observer);
+        // Initial state check
+        this.checkElementState(toolId, element);
+    }
+    /**
+     * Handle IntersectionObserver changes
+     */
+    handleIntersectionChange(toolId, entry) {
+        const element = entry.target;
+        const isIntersecting = entry.isIntersecting;
+        // Check visibility (hidden, display:none, etc)
+        const computedStyle = window.getComputedStyle(element);
+        const isVisible = computedStyle.display !== 'none' &&
+            computedStyle.visibility !== 'hidden' &&
+            computedStyle.opacity !== '0';
+        // Check if enabled
+        const isEnabled = !element.hasAttribute('disabled') &&
+            element.getAttribute('aria-disabled') !== 'true';
+        // Determine new state
+        let newState;
+        if (!isVisible) {
+            newState = ExposureState_1.ExposureState.PRESENT;
+        }
+        else if (!isIntersecting) {
+            newState = ExposureState_1.ExposureState.VISIBLE;
+        }
+        else if (!isEnabled) {
+            newState = ExposureState_1.ExposureState.EXPOSED;
+        }
+        else {
+            newState = ExposureState_1.ExposureState.INTERACTABLE;
+        }
+        this.updateToolState(toolId, newState, {
+            reason: 'Intersection change',
+            isIntersecting,
+            isVisible,
+            isEnabled,
+        });
+    }
+    /**
+     * Check element state (initial or manual check)
+     */
+    checkElementState(toolId, element) {
+        if (typeof window === 'undefined')
+            return;
+        const computedStyle = window.getComputedStyle(element);
+        const isVisible = computedStyle.display !== 'none' &&
+            computedStyle.visibility !== 'hidden' &&
+            computedStyle.opacity !== '0';
+        const rect = element.getBoundingClientRect();
+        const isInViewport = rect.top >= 0 &&
+            rect.left >= 0 &&
+            rect.bottom <= (window.innerHeight || document.documentElement.clientHeight) &&
+            rect.right <= (window.innerWidth || document.documentElement.clientWidth);
+        const isEnabled = !element.hasAttribute('disabled') &&
+            element.getAttribute('aria-disabled') !== 'true';
+        // Determine state
+        let newState;
+        if (!isVisible) {
+            newState = ExposureState_1.ExposureState.PRESENT;
+        }
+        else if (!isInViewport) {
+            newState = ExposureState_1.ExposureState.VISIBLE;
+        }
+        else if (!isEnabled) {
+            newState = ExposureState_1.ExposureState.EXPOSED;
+        }
+        else {
+            newState = ExposureState_1.ExposureState.INTERACTABLE;
+        }
+        this.updateToolState(toolId, newState, {
+            reason: 'Initial state check',
+            isVisible,
+            isInViewport,
+            isEnabled,
+        });
+    }
+    /**
+     * Notify all observers of a state change
+     */
+    notifyObservers(change) {
+        // Notify global observers
+        for (const observer of this.globalObservers) {
+            try {
+                observer(change);
+            }
+            catch (error) {
+                console.error('Error in exposure observer:', error);
+            }
+        }
+        // Notify tool-specific observers
+        const toolObservers = this.toolObservers.get(change.toolId);
+        if (toolObservers) {
+            for (const observer of toolObservers) {
+                try {
+                    observer(change);
+                }
+                catch (error) {
+                    console.error('Error in tool-specific observer:', error);
+                }
+            }
+        }
+    }
+    /**
+     * Clean up all observers (call on unmount/cleanup)
+     */
+    destroy() {
+        // Disconnect all intersection observers
+        for (const observer of this.intersectionObservers.values()) {
+            observer.disconnect();
+        }
+        this.intersectionObservers.clear();
+        // Disconnect mutation observer
+        if (this.mutationObserver) {
+            this.mutationObserver.disconnect();
+            this.mutationObserver = undefined;
+        }
+        // Clear all state
+        this.states.clear();
+        this.globalObservers.clear();
+        this.toolObservers.clear();
+    }
+}
+exports.ExposureCollector = ExposureCollector;
+//# sourceMappingURL=ExposureCollector.js.map

package/dist/cjs/src/exposure/ExposureCollector.js.map

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

package/dist/cjs/src/exposure/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Export all REQ-004 and REQ-005 APIs
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// REQ-004: Exposure State Detection
+__exportStar(require("../types/ExposureState"), exports);
+__exportStar(require("./ExposureCollector"), exports);
+// REQ-005: Context-Aware Navigation
+__exportStar(require("../types/NavigationGraph"), exports);
+__exportStar(require("../background/navigation/NavigationGraph"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/src/exposure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/exposure/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,oCAAoC;AACpC,yDAAuC;AACvC,sDAAoC;AAEpC,oCAAoC;AACpC,2DAAyC;AACzC,2EAAyD"}

package/dist/cjs/src/index.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * @supernal/interface - Open Source Edition
+ *
+ * Universal AI Interface - Make any application AI-controllable with decorators.
+ * Core framework, basic features, and adapter system.
+ *
+ * Enterprise features (test generation, architecture visualization, story system)
+ * available at https://supernal.ai/enterprise
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.architectureRegistry = exports.createAutoInitializer = exports.initializeArchitecture = exports.ExposureCollector = exports.useToolBinding = exports.DOMExecutor = exports.ComponentScanner = exports.RouteContractGenerator = exports.NameExtractor = exports.NextjsDynamicScanner = exports.RouteScanner = exports.RouteContractScanner = exports.ContractScanner = exports.Names = exports.SystemTools = exports.isStatefulComponent = exports.Component = exports.ComponentRegistry = exports.ToolRegistry = exports.pathPreset = exports.containerPreset = exports.createPreset = exports.PresetTemplates = exports.clearToolPresets = exports.registerPendingPreset = exports.applyPreset = exports.getToolPreset = exports.ToolPreset = exports.OnboardingAndTestTool = exports.AIAndTestTool = exports.NavigationTool = exports.DataWriteTool = exports.DataReadTool = exports.DestructiveTool = exports.DangerousTool = exports.OnboardingTool = exports.TestTool = exports.AITool = exports.FormTool = exports.MultiActionTool = exports.HoverTool = exports.TypeTool = exports.ChangeTool = exports.ClickTool = exports.isToolProvider = exports.getToolProviderConfig = exports.ToolProvider = exports.getStandaloneTool = exports.getStandaloneTools = exports.Tool = void 0;
+exports.PACKAGE_NAME = exports.VERSION = exports.RuntimeTreeBuilder = exports.NavigationGraph = exports.setupBridge = exports.createAuditTrail = exports.registerReadable = exports.bridgeComponentState = exports.bridgeToolRegistry = exports.createNativeAdapter = exports.NativeAdapter = exports.createCopilotKitAdapter = exports.CopilotKitAdapter = exports.withChatUI = exports.useChatUIOptional = exports.useChatUI = exports.ChatUI = exports.ChatUIProvider = exports.isComponentId = exports.getComponentIds = exports.createNames = exports.createContainers = exports.createContainer = exports.inferNavToContainerMap = void 0;
+// Core decorators and registry
+var Tool_1 = require("./decorators/Tool");
+Object.defineProperty(exports, "Tool", { enumerable: true, get: function () { return Tool_1.Tool; } });
+var Tool_2 = require("./decorators/Tool");
+Object.defineProperty(exports, "getStandaloneTools", { enumerable: true, get: function () { return Tool_2.getStandaloneTools; } });
+Object.defineProperty(exports, "getStandaloneTool", { enumerable: true, get: function () { return Tool_2.getStandaloneTool; } });
+var ToolProvider_1 = require("./decorators/ToolProvider");
+Object.defineProperty(exports, "ToolProvider", { enumerable: true, get: function () { return ToolProvider_1.ToolProvider; } });
+Object.defineProperty(exports, "getToolProviderConfig", { enumerable: true, get: function () { return ToolProvider_1.getToolProviderConfig; } });
+Object.defineProperty(exports, "isToolProvider", { enumerable: true, get: function () { return ToolProvider_1.isToolProvider; } });
+var ToolHelpers_1 = require("./decorators/ToolHelpers");
+Object.defineProperty(exports, "ClickTool", { enumerable: true, get: function () { return ToolHelpers_1.ClickTool; } });
+Object.defineProperty(exports, "ChangeTool", { enumerable: true, get: function () { return ToolHelpers_1.ChangeTool; } });
+Object.defineProperty(exports, "TypeTool", { enumerable: true, get: function () { return ToolHelpers_1.TypeTool; } });
+Object.defineProperty(exports, "HoverTool", { enumerable: true, get: function () { return ToolHelpers_1.HoverTool; } });
+Object.defineProperty(exports, "MultiActionTool", { enumerable: true, get: function () { return ToolHelpers_1.MultiActionTool; } });
+Object.defineProperty(exports, "FormTool", { enumerable: true, get: function () { return ToolHelpers_1.FormTool; } });
+// Specialized decorators and presets
+var SpecializedTools_1 = require("./decorators/SpecializedTools");
+Object.defineProperty(exports, "AITool", { enumerable: true, get: function () { return SpecializedTools_1.AITool; } });
+Object.defineProperty(exports, "TestTool", { enumerable: true, get: function () { return SpecializedTools_1.TestTool; } });
+Object.defineProperty(exports, "OnboardingTool", { enumerable: true, get: function () { return SpecializedTools_1.OnboardingTool; } });
+Object.defineProperty(exports, "DangerousTool", { enumerable: true, get: function () { return SpecializedTools_1.DangerousTool; } });
+Object.defineProperty(exports, "DestructiveTool", { enumerable: true, get: function () { return SpecializedTools_1.DestructiveTool; } });
+Object.defineProperty(exports, "DataReadTool", { enumerable: true, get: function () { return SpecializedTools_1.DataReadTool; } });
+Object.defineProperty(exports, "DataWriteTool", { enumerable: true, get: function () { return SpecializedTools_1.DataWriteTool; } });
+Object.defineProperty(exports, "NavigationTool", { enumerable: true, get: function () { return SpecializedTools_1.NavigationTool; } });
+Object.defineProperty(exports, "AIAndTestTool", { enumerable: true, get: function () { return SpecializedTools_1.AIAndTestTool; } });
+Object.defineProperty(exports, "OnboardingAndTestTool", { enumerable: true, get: function () { return SpecializedTools_1.OnboardingAndTestTool; } });
+var ToolPreset_1 = require("./decorators/ToolPreset");
+Object.defineProperty(exports, "ToolPreset", { enumerable: true, get: function () { return ToolPreset_1.ToolPreset; } });
+Object.defineProperty(exports, "getToolPreset", { enumerable: true, get: function () { return ToolPreset_1.getToolPreset; } });
+Object.defineProperty(exports, "applyPreset", { enumerable: true, get: function () { return ToolPreset_1.applyPreset; } });
+Object.defineProperty(exports, "registerPendingPreset", { enumerable: true, get: function () { return ToolPreset_1.registerPendingPreset; } });
+Object.defineProperty(exports, "clearToolPresets", { enumerable: true, get: function () { return ToolPreset_1.clearToolPresets; } });
+Object.defineProperty(exports, "PresetTemplates", { enumerable: true, get: function () { return ToolPreset_1.PresetTemplates; } });
+Object.defineProperty(exports, "createPreset", { enumerable: true, get: function () { return ToolPreset_1.createPreset; } });
+Object.defineProperty(exports, "containerPreset", { enumerable: true, get: function () { return ToolPreset_1.containerPreset; } });
+Object.defineProperty(exports, "pathPreset", { enumerable: true, get: function () { return ToolPreset_1.pathPreset; } });
+// Registries
+var ToolRegistry_1 = require("./background/registry/ToolRegistry");
+Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return ToolRegistry_1.ToolRegistry; } });
+var ComponentRegistry_1 = require("./background/registry/ComponentRegistry");
+Object.defineProperty(exports, "ComponentRegistry", { enumerable: true, get: function () { return ComponentRegistry_1.ComponentRegistry; } });
+// Component decorators
+var Component_1 = require("./decorators/Component");
+Object.defineProperty(exports, "Component", { enumerable: true, get: function () { return Component_1.Component; } });
+// Stateful components
+var StatefulComponent_1 = require("./interfaces/StatefulComponent");
+Object.defineProperty(exports, "isStatefulComponent", { enumerable: true, get: function () { return StatefulComponent_1.isStatefulComponent; } });
+// Storage (basic adapters only - browser/memory)
+__exportStar(require("./storage"), exports);
+// System tools
+var SystemTools_1 = require("./tools/SystemTools");
+Object.defineProperty(exports, "SystemTools", { enumerable: true, get: function () { return SystemTools_1.SystemTools; } });
+// Testing utilities (basic - no generation)
+__exportStar(require("./testing"), exports);
+// Data management
+__exportStar(require("./data"), exports);
+// Name contracts (hierarchical IDs)
+exports.Names = __importStar(require("../names"));
+// Name contract scanning
+var name_contracts_1 = require("./name-contracts");
+Object.defineProperty(exports, "ContractScanner", { enumerable: true, get: function () { return name_contracts_1.ContractScanner; } });
+Object.defineProperty(exports, "RouteContractScanner", { enumerable: true, get: function () { return name_contracts_1.RouteContractScanner; } });
+// Route scanning
+var routes_1 = require("./routes");
+Object.defineProperty(exports, "RouteScanner", { enumerable: true, get: function () { return routes_1.RouteScanner; } });
+Object.defineProperty(exports, "NextjsDynamicScanner", { enumerable: true, get: function () { return routes_1.NextjsDynamicScanner; } });
+Object.defineProperty(exports, "NameExtractor", { enumerable: true, get: function () { return routes_1.NameExtractor; } });
+Object.defineProperty(exports, "RouteContractGenerator", { enumerable: true, get: function () { return routes_1.RouteContractGenerator; } });
+// Component scanning
+var components_1 = require("./components");
+Object.defineProperty(exports, "ComponentScanner", { enumerable: true, get: function () { return components_1.ComponentScanner; } });
+// Execution engines
+var DOMExecutor_1 = require("./execution/DOMExecutor");
+Object.defineProperty(exports, "DOMExecutor", { enumerable: true, get: function () { return DOMExecutor_1.DOMExecutor; } });
+// React hooks
+var react_1 = require("./react");
+Object.defineProperty(exports, "useToolBinding", { enumerable: true, get: function () { return react_1.useToolBinding; } });
+// Types
+__exportStar(require("./types"), exports);
+// AI (basic matching and execution)
+__exportStar(require("./ai"), exports);
+// Exposure API
+var ExposureCollector_1 = require("./exposure/ExposureCollector");
+Object.defineProperty(exports, "ExposureCollector", { enumerable: true, get: function () { return ExposureCollector_1.ExposureCollector; } });
+// Architecture initialization (basic)
+var architecture_1 = require("./background/architecture");
+Object.defineProperty(exports, "initializeArchitecture", { enumerable: true, get: function () { return architecture_1.initializeArchitecture; } });
+Object.defineProperty(exports, "createAutoInitializer", { enumerable: true, get: function () { return architecture_1.createAutoInitializer; } });
+var registry_1 = require("./architecture/registry");
+Object.defineProperty(exports, "architectureRegistry", { enumerable: true, get: function () { return registry_1.architectureRegistry; } });
+Object.defineProperty(exports, "inferNavToContainerMap", { enumerable: true, get: function () { return registry_1.inferNavToContainerMap; } });
+var createContainer_1 = require("./architecture/createContainer");
+Object.defineProperty(exports, "createContainer", { enumerable: true, get: function () { return createContainer_1.createContainer; } });
+Object.defineProperty(exports, "createContainers", { enumerable: true, get: function () { return createContainer_1.createContainers; } });
+// Names
+var createNames_1 = require("./names/createNames");
+Object.defineProperty(exports, "createNames", { enumerable: true, get: function () { return createNames_1.createNames; } });
+Object.defineProperty(exports, "getComponentIds", { enumerable: true, get: function () { return createNames_1.getComponentIds; } });
+Object.defineProperty(exports, "isComponentId", { enumerable: true, get: function () { return createNames_1.isComponentId; } });
+// Chat UI Adapters (ALL OPEN - Key value proposition!)
+var adapters_1 = require("./adapters");
+// Provider
+Object.defineProperty(exports, "ChatUIProvider", { enumerable: true, get: function () { return adapters_1.ChatUIProvider; } });
+Object.defineProperty(exports, "ChatUI", { enumerable: true, get: function () { return adapters_1.ChatUI; } });
+Object.defineProperty(exports, "useChatUI", { enumerable: true, get: function () { return adapters_1.useChatUI; } });
+Object.defineProperty(exports, "useChatUIOptional", { enumerable: true, get: function () { return adapters_1.useChatUIOptional; } });
+Object.defineProperty(exports, "withChatUI", { enumerable: true, get: function () { return adapters_1.withChatUI; } });
+// Adapters
+Object.defineProperty(exports, "CopilotKitAdapter", { enumerable: true, get: function () { return adapters_1.CopilotKitAdapter; } });
+Object.defineProperty(exports, "createCopilotKitAdapter", { enumerable: true, get: function () { return adapters_1.createCopilotKitAdapter; } });
+Object.defineProperty(exports, "NativeAdapter", { enumerable: true, get: function () { return adapters_1.NativeAdapter; } });
+Object.defineProperty(exports, "createNativeAdapter", { enumerable: true, get: function () { return adapters_1.createNativeAdapter; } });
+// Bridge utilities
+Object.defineProperty(exports, "bridgeToolRegistry", { enumerable: true, get: function () { return adapters_1.bridgeToolRegistry; } });
+Object.defineProperty(exports, "bridgeComponentState", { enumerable: true, get: function () { return adapters_1.bridgeComponentState; } });
+Object.defineProperty(exports, "registerReadable", { enumerable: true, get: function () { return adapters_1.registerReadable; } });
+Object.defineProperty(exports, "createAuditTrail", { enumerable: true, get: function () { return adapters_1.createAuditTrail; } });
+Object.defineProperty(exports, "setupBridge", { enumerable: true, get: function () { return adapters_1.setupBridge; } });
+// Enterprise feature stubs (warn users, drive upgrade)
+var NavigationGraph_1 = require("./background/navigation/NavigationGraph");
+Object.defineProperty(exports, "NavigationGraph", { enumerable: true, get: function () { return NavigationGraph_1.NavigationGraph; } });
+var RuntimeTreeBuilder_1 = require("./background/navigation/RuntimeTreeBuilder");
+Object.defineProperty(exports, "RuntimeTreeBuilder", { enumerable: true, get: function () { return RuntimeTreeBuilder_1.RuntimeTreeBuilder; } });
+// Version info
+exports.VERSION = '1.0.0';
+exports.PACKAGE_NAME = '@supernal/interface';
+// Enterprise features not included in open source
+// Available at https://supernal.ai/enterprise:
+// - Test Generation (TestGenerator, ComponentTestGenerator, DocumentationGenerator)
+// - Story System (StoryBuilder, StoryExecutor, StoryRegistry)
+// - Architecture Visualization (ArchitectureGraph, RuntimeGraphTracker)
+// - Advanced AI (LLMProvider, ParameterExtractor, SuggestionEngine)
+// - File Storage Adapter (Node.js)
+// - Navigation Graph (runtime tracking)
+//# sourceMappingURL=index.js.map

package/dist/cjs/src/index.js.map

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

package/dist/cjs/src/interfaces/StatefulComponent.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Stateful Component Interface
+ *
+ * Week 2: State Integration
+ *
+ * Defines the interface that all stateful components must implement
+ * to enable state management through ComponentRegistry and story execution.
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   name: 'counter',
+ *   stateful: true,
+ * })
+ * class CounterComponent implements StatefulComponent<CounterState> {
+ *   private state: CounterState = { count: 0 };
+ *
+ *   getState(): CounterState {
+ *     return { ...this.state };
+ *   }
+ *
+ *   setState(newState: Partial<CounterState>): void {
+ *     this.state = { ...this.state, ...newState };
+ *     this.render();
+ *   }
+ *
+ *   resetState(): void {
+ *     this.state = { count: 0 };
+ *     this.render();
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isStatefulComponent = isStatefulComponent;
+/**
+ * Type guard to check if a component implements StatefulComponent
+ *
+ * @param component - Component to check
+ * @returns True if component implements StatefulComponent interface
+ */
+function isStatefulComponent(component) {
+    return (component !== null &&
+        typeof component === 'object' &&
+        typeof component.getState === 'function' &&
+        typeof component.setState === 'function' &&
+        typeof component.resetState === 'function');
+}
+//# sourceMappingURL=StatefulComponent.js.map

package/dist/cjs/src/interfaces/StatefulComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatefulComponent.js","sourceRoot":"","sources":["../../../../src/interfaces/StatefulComponent.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;AA0CH,kDAQC;AAdD;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,SAAc;IAChD,OAAO,CACL,SAAS,KAAK,IAAI;QAClB,OAAO,SAAS,KAAK,QAAQ;QAC7B,OAAO,SAAS,CAAC,QAAQ,KAAK,UAAU;QACxC,OAAO,SAAS,CAAC,QAAQ,KAAK,UAAU;QACxC,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU,CAC3C,CAAC;AACJ,CAAC"}