@supernal/interface 1.0.0

package/dist/cjs/src/architecture/initialize.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * Zero-Config Architecture Initialization
+ *
+ * Automatically discovers and initializes architecture from registered components and containers.
+ * Uses convention over configuration to eliminate boilerplate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeArchitecture = initializeArchitecture;
+exports.createAutoInitializer = createAutoInitializer;
+const registry_1 = require("./registry");
+const NavigationGraph_1 = require("../background/navigation/NavigationGraph");
+/**
+ * Initialize architecture from registered components and containers
+ *
+ * @example
+ * ```typescript
+ * // After importing component/container definitions:
+ * export const DemoArchitecture = initializeArchitecture({
+ *   autoInferEdges: true,
+ * });
+ *
+ * // In your app:
+ * DemoArchitecture.initialize();
+ * ```
+ */
+function initializeArchitecture(options = {}) {
+    const components = registry_1.architectureRegistry.getComponents();
+    const containers = registry_1.architectureRegistry.getContainers();
+    // Auto-infer navigation mapping if not provided
+    const navToContainerMap = options.navToContainerMap ||
+        (0, registry_1.inferNavToContainerMap)(components.GlobalNav || {}, containers);
+    const graph = NavigationGraph_1.NavigationGraph.getInstance();
+    let initialized = false;
+    return {
+        initialize() {
+            if (initialized) {
+                // eslint-disable-next-line no-console
+                console.warn('Architecture already initialized');
+                return;
+            }
+            // Register containers as navigation contexts
+            for (const container of Object.values(containers)) {
+                graph.registerContext({
+                    id: container.id,
+                    name: container.name,
+                    children: [],
+                    tools: [],
+                    metadata: {
+                        type: container.type,
+                        route: container.route,
+                        description: container.description,
+                        ...container.metadata,
+                    },
+                });
+            }
+            // Register navigation edges (GlobalNav → Containers)
+            if (components.GlobalNav) {
+                for (const [navKey] of Object.entries(components.GlobalNav)) {
+                    const containerName = navToContainerMap[navKey];
+                    if (containerName && containers[containerName]) {
+                        graph.registerEdge({
+                            from: 'global',
+                            to: containers[containerName].id,
+                            navigationTool: `navigate-to-${containers[containerName].id}`,
+                        });
+                    }
+                }
+            }
+            // Custom initialization logic
+            if (options.onInitialize) {
+                options.onInitialize(graph);
+            }
+            initialized = true;
+            // eslint-disable-next-line no-console
+            console.log('✓ Architecture initialized', {
+                components: Object.keys(components).length,
+                containers: Object.keys(containers).length,
+                navMappings: Object.keys(navToContainerMap).length,
+            });
+        },
+        createNavigationHandler(router) {
+            return (page) => {
+                const containerName = navToContainerMap[page.toLowerCase()];
+                if (containerName && containers[containerName]) {
+                    const route = containers[containerName].route;
+                    if (route) {
+                        router.push(route);
+                    }
+                }
+            };
+        },
+        getGraph() {
+            return graph;
+        },
+        getComponents() {
+            return components;
+        },
+        getContainers() {
+            return containers;
+        },
+    };
+}
+/**
+ * Create an auto-initializer with explicit configuration (legacy support)
+ *
+ * @deprecated Use initializeArchitecture() for zero-config approach
+ */
+function createAutoInitializer(config) {
+    // Register provided components and containers
+    for (const [namespace, names] of Object.entries(config.components)) {
+        const prefix = namespace.toLowerCase();
+        registry_1.architectureRegistry.registerComponent(prefix, names);
+    }
+    for (const [name, container] of Object.entries(config.containers)) {
+        registry_1.architectureRegistry.registerContainer(name, container);
+    }
+    // Use standard initialization
+    return initializeArchitecture({
+        navToContainerMap: config.navToContainerMap,
+        autoInferEdges: config.autoInferEdges,
+        mirrorTools: config.mirrorTools,
+    });
+}
+//# sourceMappingURL=initialize.js.map

package/dist/cjs/src/architecture/initialize.js.map

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

package/dist/cjs/src/architecture/registry.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * Architecture Registry
+ *
+ * Global registry for auto-discovery of components, containers, and their relationships.
+ * Enables zero-config initialization through convention over configuration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.architectureRegistry = void 0;
+exports.inferNavToContainerMap = inferNavToContainerMap;
+class ArchitectureRegistry {
+    constructor() {
+        this.components = new Map();
+        this.containers = new Map();
+    }
+    /**
+     * Register a component namespace
+     */
+    registerComponent(prefix, names) {
+        this.components.set(prefix, { prefix, names });
+    }
+    /**
+     * Register a container
+     */
+    registerContainer(name, config) {
+        this.containers.set(name, { name, config });
+    }
+    /**
+     * Get all registered components
+     */
+    getComponents() {
+        const result = {};
+        this.components.forEach(({ prefix, names }) => {
+            // Use PascalCase for namespace (Blog, Demo, etc.)
+            const namespace = prefix.charAt(0).toUpperCase() + prefix.slice(1);
+            result[namespace] = names;
+        });
+        return result;
+    }
+    /**
+     * Get all registered containers
+     */
+    getContainers() {
+        const result = {};
+        this.containers.forEach(({ name, config }) => {
+            result[name] = config;
+        });
+        return result;
+    }
+    /**
+     * Get all registered data
+     */
+    getAll() {
+        return {
+            components: this.getComponents(),
+            containers: this.getContainers(),
+        };
+    }
+    /**
+     * Clear all registrations (useful for testing)
+     */
+    clear() {
+        this.components.clear();
+        this.containers.clear();
+    }
+    /**
+     * Check if a component namespace is registered
+     */
+    hasComponent(prefix) {
+        return this.components.has(prefix);
+    }
+    /**
+     * Check if a container is registered
+     */
+    hasContainer(name) {
+        return this.containers.has(name);
+    }
+}
+/**
+ * Singleton registry instance
+ */
+exports.architectureRegistry = new ArchitectureRegistry();
+/**
+ * Infer navigation-to-container mapping from registered containers
+ * Convention: lowercase nav key → PascalCase container name
+ *
+ * Examples:
+ * - 'blog' → 'Blog'
+ * - 'demo' → 'Demo'
+ * - 'examples' → 'Examples'
+ */
+function inferNavToContainerMap(navKeys, containers) {
+    const map = {};
+    for (const navKey of Object.keys(navKeys)) {
+        // Try direct PascalCase match
+        const pascalKey = navKey.charAt(0).toUpperCase() + navKey.slice(1);
+        if (containers[pascalKey]) {
+            map[navKey] = pascalKey;
+            continue;
+        }
+        // Try finding by route match
+        for (const [containerName, container] of Object.entries(containers)) {
+            if (container.route && container.route.includes(navKey)) {
+                map[navKey] = containerName;
+                break;
+            }
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=registry.js.map

package/dist/cjs/src/architecture/registry.js.map

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

package/dist/cjs/src/background/architecture/ArchitectureInitializer.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * Architecture Initializer - Core Pattern
+ *
+ * Generic initialization pattern for any application using Supernal Interface.
+ * Takes container definitions and automatically:
+ * 1. Registers them in NavigationGraph
+ * 2. Creates navigation tools for each container
+ * 3. Infers navigation edges from component names
+ * 4. Provides a centralized navigation handler
+ *
+ * This is the CORE pattern - apps just provide their container definitions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeArchitecture = initializeArchitecture;
+exports.createAutoInitializer = createAutoInitializer;
+const NavigationGraph_1 = require("../navigation/NavigationGraph");
+/**
+ * Initialize application architecture
+ *
+ * Call this once on app startup to register containers and create navigation tools.
+ *
+ * @example
+ * ```typescript
+ * // In your app's architecture/index.ts
+ * import { initializeArchitecture } from '@supernal-interface/core';
+ * import { MyContainers } from './MyContainers';
+ * import { Components } from './MyComponentNames';
+ *
+ * export const { createNavigationHandler } = initializeArchitecture({
+ *   containers: MyContainers,
+ *   components: { GlobalNav: Components.GlobalNav },
+ *   autoInferEdges: true
+ * });
+ * ```
+ */
+function initializeArchitecture(config) {
+    const graph = NavigationGraph_1.NavigationGraph.getInstance();
+    let initialized = false;
+    return {
+        /**
+         * Initialize the architecture (call once)
+         * Returns true if this was the first initialization
+         */
+        initialize() {
+            if (initialized)
+                return false;
+            initialized = true;
+            // 1. Register all containers as navigation contexts
+            const containers = Object.values(config.containers);
+            for (const container of containers) {
+                graph.registerContext({
+                    id: container.id,
+                    name: container.name,
+                    parent: 'parent' in container ? container.parent : undefined,
+                    children: [],
+                    tools: [...container.components],
+                    metadata: {
+                        type: container.type,
+                        route: 'route' in container ? container.route : undefined,
+                        description: container.description
+                    }
+                });
+                console.log(`📦 [Architecture] Registered container: ${container.name}`);
+            }
+            // 2. Mirror tools between containers (if specified)
+            if (config.mirrorTools) {
+                for (const { from, to } of config.mirrorTools) {
+                    const sourceContext = graph.getContext(from);
+                    if (sourceContext && sourceContext.tools) {
+                        for (const toolId of sourceContext.tools) {
+                            graph.registerToolInContext(toolId, to);
+                        }
+                        console.log(`🔄 [Architecture] Mirrored ${sourceContext.tools.length} tools: ${from} → ${to}`);
+                    }
+                }
+            }
+            // 3. Auto-infer navigation edges (if enabled)
+            if (config.autoInferEdges && config.components?.GlobalNav && config.navToContainerMap) {
+                const edges = inferNavigationEdges(containers, config.components.GlobalNav, config.navToContainerMap, config.containers);
+                for (const edge of edges) {
+                    graph.registerEdge(edge);
+                }
+                console.log(`✅ [Architecture] Initialized with ${containers.length} containers, ${edges.length} edges`);
+            }
+            return true;
+        },
+        /**
+         * Create a navigation handler that uses the registered routes
+         *
+         * @param router - Next.js router or any router with a push method
+         * @returns Navigation handler function
+         */
+        createNavigationHandler(router) {
+            return (pageName) => {
+                console.log(`🗺️  [Navigation] Request: ${pageName}`);
+                // Use NavigationGraph to resolve route
+                const routeInfo = graph.getRouteByName(pageName);
+                if (!routeInfo) {
+                    console.warn(`⚠️  [Navigation] No route found for: ${pageName}`);
+                    // Try treating as a path (e.g., "blog/type-safe")
+                    if (pageName.includes('/')) {
+                        const attemptedPath = pageName.startsWith('/') ? pageName : `/${pageName}`;
+                        console.log(`🗺️  [Navigation] Attempting path: ${attemptedPath}`);
+                        if (router?.push) {
+                            router.push(attemptedPath);
+                        }
+                        else if (typeof window !== 'undefined') {
+                            window.location.href = attemptedPath;
+                        }
+                    }
+                    return;
+                }
+                // Extract path from RouteInfo
+                const route = routeInfo.path || routeInfo.name || pageName;
+                console.log(`🗺️  [Navigation] Resolved: ${pageName} → ${route}`);
+                // Navigate using provided router or fallback to window.location
+                if (router?.push) {
+                    router.push(route);
+                }
+                else if (typeof window !== 'undefined') {
+                    window.location.href = route;
+                }
+            };
+        },
+        /**
+         * Get the NavigationGraph instance (for advanced usage)
+         */
+        getGraph() {
+            return graph;
+        }
+    };
+}
+/**
+ * Infer navigation edges from global navigation components
+ *
+ * @internal
+ */
+function inferNavigationEdges(containers, globalNav, navToContainerMap, containerMap) {
+    const edges = [];
+    // Create edges FROM every container TO every other container via GlobalNav
+    for (const [navKey, navButtonId] of Object.entries(globalNav)) {
+        const targetContainerName = navToContainerMap[navKey];
+        const targetContainer = containerMap[targetContainerName];
+        if (targetContainer) {
+            // From every container (except target) to target
+            for (const sourceContainer of containers) {
+                if (sourceContainer.id !== targetContainer.id) {
+                    edges.push({
+                        from: sourceContainer.id,
+                        to: targetContainer.id,
+                        navigationTool: navButtonId,
+                        cost: 1
+                    });
+                }
+            }
+        }
+    }
+    return edges;
+}
+/**
+ * Auto-initialize on module load (for convenience)
+ * Apps can call this manually if they prefer explicit initialization
+ */
+function createAutoInitializer(config) {
+    let hasInitialized = false;
+    const { initialize, ...rest } = initializeArchitecture(config);
+    // Auto-initialize on first access
+    if (!hasInitialized) {
+        hasInitialized = initialize();
+    }
+    return { initialize, ...rest };
+}
+//# sourceMappingURL=ArchitectureInitializer.js.map

package/dist/cjs/src/background/architecture/ArchitectureInitializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchitectureInitializer.js","sourceRoot":"","sources":["../../../../../src/background/architecture/ArchitectureInitializer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AA+CH,wDAoHC;AA0CD,sDAaC;AAxND,mEAAgE;AA0BhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,sBAAsB,CACpC,MAA6B;IAE7B,MAAM,KAAK,GAAG,iCAAe,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,OAAO;QACL;;;WAGG;QACH,UAAU;YACR,IAAI,WAAW;gBAAE,OAAO,KAAK,CAAC;YAC9B,WAAW,GAAG,IAAI,CAAC;YAEnB,oDAAoD;YACpD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACpD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,KAAK,CAAC,eAAe,CAAC;oBACpB,EAAE,EAAE,SAAS,CAAC,EAAE;oBAChB,IAAI,EAAE,SAAS,CAAC,IAAI;oBACpB,MAAM,EAAE,QAAQ,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;oBAC5D,QAAQ,EAAE,EAAE;oBACZ,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC;oBAChC,QAAQ,EAAE;wBACR,IAAI,EAAE,SAAS,CAAC,IAAI;wBACpB,KAAK,EAAE,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;wBACzD,WAAW,EAAE,SAAS,CAAC,WAAW;qBACnC;iBACF,CAAC,CAAC;gBAEH,OAAO,CAAC,GAAG,CAAC,2CAA2C,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3E,CAAC;YAED,oDAAoD;YACpD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,KAAK,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;oBAC9C,MAAM,aAAa,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;oBAC7C,IAAI,aAAa,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;wBACzC,KAAK,MAAM,MAAM,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;4BACzC,KAAK,CAAC,qBAAqB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;wBAC1C,CAAC;wBACD,OAAO,CAAC,GAAG,CAAC,8BAA8B,aAAa,CAAC,KAAK,CAAC,MAAM,WAAW,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;oBACjG,CAAC;gBACH,CAAC;YACH,CAAC;YAED,8CAA8C;YAC9C,IAAI,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,UAAU,EAAE,SAAS,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;gBACtF,MAAM,KAAK,GAAG,oBAAoB,CAChC,UAAU,EACV,MAAM,CAAC,UAAU,CAAC,SAAS,EAC3B,MAAM,CAAC,iBAAiB,EACxB,MAAM,CAAC,UAAU,CAClB,CAAC;gBAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;gBAC3B,CAAC;gBAED,OAAO,CAAC,GAAG,CAAC,qCAAqC,UAAU,CAAC,MAAM,gBAAgB,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;YAC1G,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAED;;;;;WAKG;QACH,uBAAuB,CAAC,MAA0D;YAChF,OAAO,CAAC,QAAgB,EAAE,EAAE;gBAC1B,OAAO,CAAC,GAAG,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;gBAEtD,uCAAuC;gBACvC,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;gBAEjD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,wCAAwC,QAAQ,EAAE,CAAC,CAAC;oBAEjE,kDAAkD;oBAClD,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC3B,MAAM,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;wBAC3E,OAAO,CAAC,GAAG,CAAC,sCAAsC,aAAa,EAAE,CAAC,CAAC;wBAEnE,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;4BACjB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;wBAC7B,CAAC;6BAAM,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;4BACzC,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,aAAa,CAAC;wBACvC,CAAC;oBACH,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,8BAA8B;gBAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,IAAI,QAAQ,CAAC;gBAC3D,OAAO,CAAC,GAAG,CAAC,+BAA+B,QAAQ,MAAM,KAAK,EAAE,CAAC,CAAC;gBAElE,gEAAgE;gBAChE,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC;oBACjB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACrB,CAAC;qBAAM,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;oBACzC,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC;gBAC/B,CAAC;YACH,CAAC,CAAC;QACJ,CAAC;QAED;;WAEG;QACH,QAAQ;YACN,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAC3B,UAAiC,EACjC,SAAiC,EACjC,iBAAyC,EACzC,YAAiD;IAEjD,MAAM,KAAK,GAA8E,EAAE,CAAC;IAE5F,2EAA2E;IAC3E,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9D,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,eAAe,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;QAE1D,IAAI,eAAe,EAAE,CAAC;YACpB,iDAAiD;YACjD,KAAK,MAAM,eAAe,IAAI,UAAU,EAAE,CAAC;gBACzC,IAAI,eAAe,CAAC,EAAE,KAAK,eAAe,CAAC,EAAE,EAAE,CAAC;oBAC9C,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,eAAe,CAAC,EAAE;wBACxB,EAAE,EAAE,eAAe,CAAC,EAAE;wBACtB,cAAc,EAAE,WAAW;wBAC3B,IAAI,EAAE,CAAC;qBACR,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CACnC,MAA6B;IAE7B,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/D,kCAAkC;IAClC,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,UAAU,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,CAAC;AACjC,CAAC"}

package/dist/cjs/src/background/architecture/Containers.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Architecture Definition: Containers
+ *
+ * Single source of truth for application containers (pages, modals, sections).
+ * This file defines the navigation graph structure of the application.
+ *
+ * Pattern: Like ComponentNames, but for high-level navigation boundaries.
+ *
+ * NOTE: This is the CORE library. Applications should define their own containers
+ * in their own codebase and register them with NavigationGraph.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContainer = getContainer;
+exports.getAllContainers = getAllContainers;
+exports.isComponentInContainer = isComponentInContainer;
+exports.findComponentContainers = findComponentContainers;
+/**
+ * Get container definition by ID
+ */
+function getContainer(containers, id) {
+    return containers[id];
+}
+/**
+ * Get all container definitions
+ */
+function getAllContainers(containers) {
+    return Object.values(containers);
+}
+/**
+ * Check if a component belongs to a container
+ */
+function isComponentInContainer(containers, componentId, containerId) {
+    const container = containers[containerId];
+    return container?.components.includes(componentId) || false;
+}
+/**
+ * Find which container(s) a component belongs to
+ */
+function findComponentContainers(containers, componentId) {
+    return Object.keys(containers).filter(key => {
+        const container = containers[key];
+        return container.components.includes(componentId);
+    });
+}
+//# sourceMappingURL=Containers.js.map

package/dist/cjs/src/background/architecture/Containers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Containers.js","sourceRoot":"","sources":["../../../../../src/background/architecture/Containers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAqCH,oCAEC;AAKD,4CAEC;AAKD,wDAOC;AAKD,0DAQC;AArCD;;GAEG;AACH,SAAgB,YAAY,CAAC,UAA+C,EAAE,EAAU;IACtF,OAAO,UAAU,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,UAA+C;IAC9E,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CACpC,UAA+C,EAC/C,WAAmB,EACnB,WAAmB;IAEnB,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAC1C,OAAO,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CACrC,UAA+C,EAC/C,WAAmB;IAEnB,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;QAC1C,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cjs/src/background/architecture/DataContractTypes.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * DataContractTypes - Enterprise Feature Stub
+ *
+ * Basic types for data contracts. Full story system and validation
+ * available in @supernal/interface-enterprise.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataContractRegistry = void 0;
+exports.isComponentState = isComponentState;
+exports.isComponentContract = isComponentContract;
+class DataContractRegistry {
+    static register(id, contract) {
+        // Enterprise feature - no-op
+    }
+    static get(id) {
+        return undefined;
+    }
+}
+exports.DataContractRegistry = DataContractRegistry;
+// Type guards
+function isComponentState(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isComponentContract(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=DataContractTypes.js.map

package/dist/cjs/src/background/architecture/DataContractTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataContractTypes.js","sourceRoot":"","sources":["../../../../../src/background/architecture/DataContractTypes.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAiCH,4CAEC;AAED,kDAEC;AArBD,MAAa,oBAAoB;IAC/B,MAAM,CAAC,QAAQ,CAAC,EAAU,EAAE,QAAsB;QAChD,6BAA6B;IAC/B,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,EAAU;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AARD,oDAQC;AAMD,cAAc;AACd,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAgB,mBAAmB,CAAC,KAAc;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

package/dist/cjs/src/background/architecture/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Architecture Module
+ *
+ * Provides generic types and utilities for defining application architecture.
+ * Applications should create their own component names, containers, and navigation connections.
+ *
+ * This is the CORE library - it provides the infrastructure, not the content.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isComponentContract = exports.isComponentState = exports.createAutoInitializer = exports.initializeArchitecture = exports.findComponentContainers = exports.isComponentInContainer = exports.getAllContainers = exports.getContainer = void 0;
+var Containers_1 = require("./Containers");
+Object.defineProperty(exports, "getContainer", { enumerable: true, get: function () { return Containers_1.getContainer; } });
+Object.defineProperty(exports, "getAllContainers", { enumerable: true, get: function () { return Containers_1.getAllContainers; } });
+Object.defineProperty(exports, "isComponentInContainer", { enumerable: true, get: function () { return Containers_1.isComponentInContainer; } });
+Object.defineProperty(exports, "findComponentContainers", { enumerable: true, get: function () { return Containers_1.findComponentContainers; } });
+var ArchitectureInitializer_1 = require("./ArchitectureInitializer");
+Object.defineProperty(exports, "initializeArchitecture", { enumerable: true, get: function () { return ArchitectureInitializer_1.initializeArchitecture; } });
+Object.defineProperty(exports, "createAutoInitializer", { enumerable: true, get: function () { return ArchitectureInitializer_1.createAutoInitializer; } });
+// Data Contract Types (NEW - Week 1)
+var DataContractTypes_1 = require("./DataContractTypes");
+Object.defineProperty(exports, "isComponentState", { enumerable: true, get: function () { return DataContractTypes_1.isComponentState; } });
+Object.defineProperty(exports, "isComponentContract", { enumerable: true, get: function () { return DataContractTypes_1.isComponentContract; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/background/architecture/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,2CAOsB;AANpB,0GAAA,YAAY,OAAA;AACZ,8GAAA,gBAAgB,OAAA;AAChB,oHAAA,sBAAsB,OAAA;AACtB,qHAAA,uBAAuB,OAAA;AAKzB,qEAImC;AAHjC,iIAAA,sBAAsB,OAAA;AACtB,gIAAA,qBAAqB,OAAA;AAIvB,qCAAqC;AACrC,yDAS6B;AAF3B,qHAAA,gBAAgB,OAAA;AAChB,wHAAA,mBAAmB,OAAA"}

package/dist/cjs/src/background/navigation/NavigationGraph.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * NavigationGraph - Enterprise Feature Stub
+ *
+ * This is a stub implementation for the open source edition.
+ * Full runtime navigation tracking available in @supernal/interface-enterprise.
+ *
+ * Visit https://supernal.ai/enterprise for more information.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NavigationGraph = void 0;
+class NavigationGraph {
+    constructor() {
+        this.warned = false;
+    }
+    warnOnce() {
+        if (!this.warned && typeof console !== 'undefined') {
+            console.warn('⚠️  NavigationGraph is an enterprise feature. ' +
+                'Full runtime tracking available at https://supernal.ai/enterprise');
+            this.warned = true;
+        }
+    }
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new NavigationGraph();
+        }
+        return this.instance;
+    }
+    // Stub methods - no-op implementations
+    trackComponent(id, parent) {
+        this.warnOnce();
+    }
+    getTree() {
+        this.warnOnce();
+        return [];
+    }
+    trackNavigation(from, to) {
+        this.warnOnce();
+    }
+    reset() {
+        this.warnOnce();
+    }
+    // Accept object or string for registerContext
+    registerContext(idOrData, data) {
+        this.warnOnce();
+    }
+    // Accept multiple types for registerEdge - very flexible signature
+    registerEdge(from, to, metadata) {
+        this.warnOnce();
+    }
+    getContext(id) {
+        this.warnOnce();
+        return { id, tools: [] };
+    }
+    registerToolInContext(toolId, contextId, extra) {
+        this.warnOnce();
+    }
+    getRouteByName(name) {
+        this.warnOnce();
+        return undefined;
+    }
+    setCurrentContext(contextId) {
+        this.warnOnce();
+    }
+    setNavigationHandler(handler) {
+        this.warnOnce();
+    }
+}
+exports.NavigationGraph = NavigationGraph;
+NavigationGraph.instance = null;
+//# sourceMappingURL=NavigationGraph.js.map

package/dist/cjs/src/background/navigation/NavigationGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationGraph.js","sourceRoot":"","sources":["../../../../../src/background/navigation/NavigationGraph.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA2BH,MAAa,eAAe;IAA5B;QAEU,WAAM,GAAG,KAAK,CAAC;IAoEzB,CAAC;IAlES,QAAQ;QACd,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;YACnD,OAAO,CAAC,IAAI,CACV,gDAAgD;gBAChD,mEAAmE,CACpE,CAAC;YACF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACxC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,uCAAuC;IACvC,cAAc,CAAC,EAAU,EAAE,MAAe;QACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,eAAe,CAAC,IAAY,EAAE,EAAU;QACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,8CAA8C;IAC9C,eAAe,CAAC,QAA8B,EAAE,IAAc;QAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,mEAAmE;IACnE,YAAY,CAAC,IAAwB,EAAE,EAAuB,EAAE,QAAkB;QAChF,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,UAAU,CAAC,EAAU;QACnB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;IAED,qBAAqB,CAAC,MAAc,EAAE,SAAkB,EAAE,KAAe;QACvE,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,iBAAiB,CAAC,SAA6B;QAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,oBAAoB,CAAC,OAA2C;QAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;;AArEH,0CAsEC;AArEgB,wBAAQ,GAA2B,IAAI,AAA/B,CAAgC"}