@supernal/interface 1.0.0

package/dist/esm/src/background/architecture/Containers.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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.
+ */
+/**
+ * Container Definition
+ * A container is a distinct navigation context (page, modal, drawer, etc.)
+ */
+export interface ContainerDefinition {
+    /** Unique container identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Container type */
+    type: 'page' | 'modal' | 'drawer' | 'tab' | 'section';
+    /** Optional parent container (for nested contexts) */
+    parent?: string;
+    /** Route/path if applicable */
+    route?: string;
+    /** Component IDs available in this container */
+    components: readonly string[];
+    /** Description for documentation */
+    description?: string;
+}
+/**
+ * Type helper for container IDs (generic version)
+ */
+export type ContainerId = string;
+/**
+ * Get container definition by ID
+ */
+export declare function getContainer(containers: Record<string, ContainerDefinition>, id: string): ContainerDefinition | undefined;
+/**
+ * Get all container definitions
+ */
+export declare function getAllContainers(containers: Record<string, ContainerDefinition>): ContainerDefinition[];
+/**
+ * Check if a component belongs to a container
+ */
+export declare function isComponentInContainer(containers: Record<string, ContainerDefinition>, componentId: string, containerId: string): boolean;
+/**
+ * Find which container(s) a component belongs to
+ */
+export declare function findComponentContainers(containers: Record<string, ContainerDefinition>, componentId: string): string[];
+//# sourceMappingURL=Containers.d.ts.map

package/dist/esm/src/background/architecture/Containers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Containers.d.ts","sourceRoot":"","sources":["../../../../../src/background/architecture/Containers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IAEX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IAEtD,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gDAAgD;IAChD,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAE9B,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAEzH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,mBAAmB,EAAE,CAEvG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAC/C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAC/C,WAAW,EAAE,MAAM,GAClB,MAAM,EAAE,CAKV"}

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

@@ -0,0 +1,40 @@
+/**
+ * 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.
+ */
+/**
+ * Get container definition by ID
+ */
+export function getContainer(containers, id) {
+    return containers[id];
+}
+/**
+ * Get all container definitions
+ */
+export function getAllContainers(containers) {
+    return Object.values(containers);
+}
+/**
+ * Check if a component belongs to a container
+ */
+export function isComponentInContainer(containers, componentId, containerId) {
+    const container = containers[containerId];
+    return container?.components.includes(componentId) || false;
+}
+/**
+ * Find which container(s) a component belongs to
+ */
+export 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/esm/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;AAkCH;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAA+C,EAAE,EAAU;IACtF,OAAO,UAAU,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA+C;IAC9E,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,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,MAAM,UAAU,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/esm/src/background/architecture/DataContractTypes.d.ts

@@ -0,0 +1,33 @@
+/**
+ * DataContractTypes - Enterprise Feature Stub
+ *
+ * Basic types for data contracts. Full story system and validation
+ * available in @supernal/interface-enterprise.
+ */
+export type DataContract = Record<string, unknown>;
+export interface ContractValidation {
+    valid: boolean;
+    errors?: string[];
+}
+export interface ContractSchema {
+    fields: Record<string, {
+        type: string;
+        required?: boolean;
+    }>;
+}
+export type ComponentState = Record<string, unknown>;
+export type StateContract = DataContract;
+export type ComponentContract = DataContract;
+export declare class DataContractRegistry {
+    static register(id: string, contract: DataContract): void;
+    static get(id: string): DataContract | undefined;
+}
+export type ExtractState<T> = T extends {
+    state: infer S;
+} ? S : unknown;
+export type TypedComponentContract<T = unknown> = DataContract & {
+    state?: T;
+};
+export declare function isComponentState(value: unknown): value is ComponentState;
+export declare function isComponentContract(value: unknown): value is ComponentContract;
+//# sourceMappingURL=DataContractTypes.d.ts.map

package/dist/esm/src/background/architecture/DataContractTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataContractTypes.d.ts","sourceRoot":"","sources":["../../../../../src/background/architecture/DataContractTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC9D;AAGD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACrD,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC;AACzC,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAE7C,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAIzD,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;CAGjD;AAGD,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,OAAO,CAAC;AACzE,MAAM,MAAM,sBAAsB,CAAC,CAAC,GAAG,OAAO,IAAI,YAAY,GAAG;IAAE,KAAK,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAG/E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E"}

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

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

package/dist/esm/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;AAkBH,MAAM,OAAO,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;AAMD,cAAc;AACd,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

package/dist/esm/src/background/architecture/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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.
+ */
+export { getContainer, getAllContainers, isComponentInContainer, findComponentContainers, type ContainerDefinition, type ContainerId } from './Containers';
+export { initializeArchitecture, createAutoInitializer, type ArchitectureConfig } from './ArchitectureInitializer';
+export { type ComponentState, type StateContract, type ComponentContract, type DataContractRegistry, type ExtractState, type TypedComponentContract, isComponentState, isComponentContract, } from './DataContractTypes';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/src/background/architecture/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/background/architecture/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * 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.
+ */
+export { getContainer, getAllContainers, isComponentInContainer, findComponentContainers } from './Containers.js';
+export { initializeArchitecture, createAutoInitializer } from './ArchitectureInitializer.js';
+// Data Contract Types (NEW - Week 1)
+export { isComponentState, isComponentContract, } from './DataContractTypes.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/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,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EAGxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EAEtB,MAAM,2BAA2B,CAAC;AAEnC,qCAAqC;AACrC,OAAO,EAOL,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/esm/src/background/navigation/NavigationGraph.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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.
+ */
+export interface NavigationNode {
+    id: string;
+    type: string;
+    children?: NavigationNode[];
+}
+export interface RouteInfo {
+    path?: string;
+    name?: string;
+    from?: string;
+    to?: string;
+    navigationTool?: string;
+    cost?: number;
+    metadata?: unknown;
+}
+export interface ContextData {
+    id: string;
+    name?: string;
+    parent?: string;
+    children?: unknown[];
+    tools?: string[];
+    metadata?: unknown;
+}
+export declare class NavigationGraph {
+    private static instance;
+    private warned;
+    private warnOnce;
+    static getInstance(): NavigationGraph;
+    trackComponent(id: string, parent?: string): void;
+    getTree(): NavigationNode[];
+    trackNavigation(from: string, to: string): void;
+    reset(): void;
+    registerContext(idOrData: string | ContextData, data?: unknown): void;
+    registerEdge(from: string | RouteInfo, to?: string | RouteInfo, metadata?: unknown): void;
+    getContext(id: string): ContextData;
+    registerToolInContext(toolId: string, contextId?: string, extra?: unknown): void;
+    getRouteByName(name: string): RouteInfo | undefined;
+    setCurrentContext(contextId: string | RouteInfo): void;
+    setNavigationHandler(handler: (path: string | RouteInfo) => void): void;
+}
+//# sourceMappingURL=NavigationGraph.d.ts.map

package/dist/esm/src/background/navigation/NavigationGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationGraph.d.ts","sourceRoot":"","sources":["../../../../../src/background/navigation/NavigationGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IACvD,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,QAAQ;IAUhB,MAAM,CAAC,WAAW,IAAI,eAAe;IAQrC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjD,OAAO,IAAI,cAAc,EAAE;IAK3B,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAI/C,KAAK,IAAI,IAAI;IAKb,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAKrE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI;IAIzF,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW;IAKnC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAIhF,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAKnD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAItD,oBAAoB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,GAAG,IAAI;CAGxE"}

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

@@ -0,0 +1,67 @@
+/**
+ * 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.
+ */
+export 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();
+    }
+}
+NavigationGraph.instance = null;
+//# sourceMappingURL=NavigationGraph.js.map

package/dist/esm/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,MAAM,OAAO,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;;AApEc,wBAAQ,GAA2B,IAAI,AAA/B,CAAgC"}

package/dist/esm/src/background/navigation/RuntimeTreeBuilder.d.ts

@@ -0,0 +1,30 @@
+/**
+ * RuntimeTreeBuilder - Enterprise Feature Stub
+ *
+ * This is a stub implementation for the open source edition.
+ * Full runtime tree building and tracking available in @supernal/interface-enterprise.
+ *
+ * Visit https://supernal.ai/enterprise for more information.
+ */
+export interface TreeNode {
+    id: string;
+    type: string;
+    children?: TreeNode[];
+}
+export declare class RuntimeTreeBuilder {
+    private static instance;
+    private static warned;
+    private static warnOnce;
+    static getInstance(): RuntimeTreeBuilder;
+    trackContainer(id: string, parent?: string): void;
+    trackComponent(id: string, containerId?: string): void;
+    buildTree(): TreeNode | null;
+    reset(): void;
+    static enterComponent(id: string, callback?: () => void): void;
+    static exitComponent(id?: string): void;
+    static registerTool(toolId: string, componentName?: string, containerId?: string): void;
+}
+export declare const TreeBuilder: typeof RuntimeTreeBuilder;
+export declare function navigateTo(path: string): void;
+export declare function trackContainerMount(id: string, parent?: string): void;
+//# sourceMappingURL=RuntimeTreeBuilder.d.ts.map

package/dist/esm/src/background/navigation/RuntimeTreeBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeTreeBuilder.d.ts","sourceRoot":"","sources":["../../../../../src/background/navigation/RuntimeTreeBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAC1D,OAAO,CAAC,MAAM,CAAC,MAAM,CAAS;IAE9B,OAAO,CAAC,MAAM,CAAC,QAAQ;IAUvB,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAQxC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjD,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAItD,SAAS,IAAI,QAAQ,GAAG,IAAI;IAK5B,KAAK,IAAI,IAAI;IAKb,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAK9D,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvC,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;CAGxF;AAGD,eAAO,MAAM,WAAW,2BAAqB,CAAC;AAG9C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAErE"}

package/dist/esm/src/background/navigation/RuntimeTreeBuilder.js

@@ -0,0 +1,60 @@
+/**
+ * RuntimeTreeBuilder - Enterprise Feature Stub
+ *
+ * This is a stub implementation for the open source edition.
+ * Full runtime tree building and tracking available in @supernal/interface-enterprise.
+ *
+ * Visit https://supernal.ai/enterprise for more information.
+ */
+export class RuntimeTreeBuilder {
+    static warnOnce() {
+        if (!this.warned && typeof console !== 'undefined') {
+            console.warn('⚠️  RuntimeTreeBuilder is an enterprise feature. ' +
+                'Full tree tracking available at https://supernal.ai/enterprise');
+            this.warned = true;
+        }
+    }
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new RuntimeTreeBuilder();
+        }
+        return this.instance;
+    }
+    // Instance methods
+    trackContainer(id, parent) {
+        RuntimeTreeBuilder.warnOnce();
+    }
+    trackComponent(id, containerId) {
+        RuntimeTreeBuilder.warnOnce();
+    }
+    buildTree() {
+        RuntimeTreeBuilder.warnOnce();
+        return null;
+    }
+    reset() {
+        RuntimeTreeBuilder.warnOnce();
+    }
+    // Static methods for compatibility
+    static enterComponent(id, callback) {
+        this.warnOnce();
+        callback?.();
+    }
+    static exitComponent(id) {
+        this.warnOnce();
+    }
+    static registerTool(toolId, componentName, containerId) {
+        this.warnOnce();
+    }
+}
+RuntimeTreeBuilder.instance = null;
+RuntimeTreeBuilder.warned = false;
+// TreeBuilder alias for compatibility
+export const TreeBuilder = RuntimeTreeBuilder;
+// Helper functions - stubs
+export function navigateTo(path) {
+    // Enterprise feature - no-op in open source
+}
+export function trackContainerMount(id, parent) {
+    // Enterprise feature - no-op in open source
+}
+//# sourceMappingURL=RuntimeTreeBuilder.js.map

package/dist/esm/src/background/navigation/RuntimeTreeBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeTreeBuilder.js","sourceRoot":"","sources":["../../../../../src/background/navigation/RuntimeTreeBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,OAAO,kBAAkB;IAIrB,MAAM,CAAC,QAAQ;QACrB,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;YACnD,OAAO,CAAC,IAAI,CACV,mDAAmD;gBACnD,gEAAgE,CACjE,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,kBAAkB,EAAE,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,mBAAmB;IACnB,cAAc,CAAC,EAAU,EAAE,MAAe;QACxC,kBAAkB,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,cAAc,CAAC,EAAU,EAAE,WAAoB;QAC7C,kBAAkB,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,SAAS;QACP,kBAAkB,CAAC,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,kBAAkB,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,mCAAmC;IACnC,MAAM,CAAC,cAAc,CAAC,EAAU,EAAE,QAAqB;QACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,QAAQ,EAAE,EAAE,CAAC;IACf,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,EAAW;QAC9B,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,MAAc,EAAE,aAAsB,EAAE,WAAoB;QAC9E,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;;AAlDc,2BAAQ,GAA8B,IAAI,CAAC;AAC3C,yBAAM,GAAG,KAAK,CAAC;AAoDhC,sCAAsC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAE9C,2BAA2B;AAC3B,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,4CAA4C;AAC9C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAU,EAAE,MAAe;IAC7D,4CAA4C;AAC9C,CAAC"}

package/dist/esm/src/background/navigation/useComponentTracking.d.ts

@@ -0,0 +1,10 @@
+/**
+ * useComponentTracking - Minimal hook for container components
+ *
+ * Usage: Add ONE LINE to each container component:
+ *   useComponentTracking('ContainerName');
+ *
+ * This tracks the component hierarchy for navigation and tool routing.
+ */
+export declare function useComponentTracking(componentName: string): void;
+//# sourceMappingURL=useComponentTracking.d.ts.map

package/dist/esm/src/background/navigation/useComponentTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComponentTracking.d.ts","sourceRoot":"","sources":["../../../../../src/background/navigation/useComponentTracking.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAKhE"}

package/dist/esm/src/background/navigation/useComponentTracking.js

@@ -0,0 +1,17 @@
+/**
+ * useComponentTracking - Minimal hook for container components
+ *
+ * Usage: Add ONE LINE to each container component:
+ *   useComponentTracking('ContainerName');
+ *
+ * This tracks the component hierarchy for navigation and tool routing.
+ */
+import { useEffect } from 'react';
+import { TreeBuilder } from './RuntimeTreeBuilder.js';
+export function useComponentTracking(componentName) {
+    useEffect(() => {
+        TreeBuilder.enterComponent(componentName);
+        return () => TreeBuilder.exitComponent();
+    }, [componentName]);
+}
+//# sourceMappingURL=useComponentTracking.js.map

package/dist/esm/src/background/navigation/useComponentTracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComponentTracking.js","sourceRoot":"","sources":["../../../../../src/background/navigation/useComponentTracking.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,UAAU,oBAAoB,CAAC,aAAqB;IACxD,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;IAC3C,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;AACtB,CAAC"}

package/dist/esm/src/background/registry/ComponentRegistry.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Component Registry
+ *
+ * Handles two-phase registration for DOM-free decorators:
+ * - Phase A (Decorator): Collect metadata without DOM access
+ * - Phase B (Hydration): Query DOM after it's ready
+ *
+ * This enables SSR/MV3 compatibility.
+ */
+import { ComponentState, HTMLTag, HTMLInputType, HTMLRole } from '../../types/ComponentState';
+import { OperationType } from '../../types/OperationType';
+import { StatefulComponent } from '../../interfaces/StatefulComponent';
+/**
+ * Component metadata collected at decoration time (Phase A)
+ * NO DOM ACCESS
+ */
+export interface ComponentMetadata {
+    /**
+     * Component ID (from decorator)
+     */
+    componentId: string;
+    /**
+     * Component kind
+     */
+    kind: 'ui-component' | 'function-tool';
+    /**
+     * Description
+     */
+    description?: string;
+    /**
+     * Container ID
+     */
+    containerId?: string;
+    /**
+     * HTML semantics (for UI components, SSR-required)
+     */
+    htmlTag?: HTMLTag;
+    htmlType?: HTMLInputType;
+    htmlRole?: HTMLRole;
+    /**
+     * Operation type (for function tools)
+     */
+    operationType?: OperationType;
+    /**
+     * CSS selector for DOM hydration (Phase B)
+     */
+    selector?: string;
+    /**
+     * Provider class name
+     */
+    providerName?: string;
+    /**
+     * Method name
+     */
+    methodName?: string;
+}
+/**
+ * Component Registry with two-phase registration
+ */
+export declare class ComponentRegistry {
+    /**
+     * Registered component metadata (Phase A)
+     */
+    private static metadata;
+    /**
+     * Hydrated components (Phase B)
+     */
+    private static hydrated;
+    /**
+     * Stateful component instances (Week 2 - Story System)
+     * Maps component name to StatefulComponent instance
+     */
+    private static instances;
+    /**
+     * Phase A: Register component metadata (decorator-time, NO DOM)
+     */
+    static register(metadata: ComponentMetadata): void;
+    /**
+     * Phase B: Hydrate component from DOM (user-initiated, after DOM ready)
+     *
+     * For UI components: Queries DOM to extract current state
+     * For function tools: Creates initial state
+     */
+    static hydrate(componentId: string): ComponentState | null;
+    /**
+     * Hydrate UI component from DOM
+     */
+    private static hydrateUIComponent;
+    /**
+     * Extract value from DOM element based on tag
+     */
+    private static extractValueFromDOM;
+    /**
+     * Extract options from DOM (for select, radio, checkbox groups)
+     */
+    private static extractOptionsFromDOM;
+    /**
+     * Hydrate function tool (no DOM access)
+     */
+    private static hydrateFunctionTool;
+    /**
+     * Hydrate all registered components
+     */
+    static hydrateAll(): Map<string, ComponentState>;
+    /**
+     * Get registered metadata (Phase A)
+     */
+    static getMetadata(componentId: string): ComponentMetadata | undefined;
+    /**
+     * Get all registered metadata
+     */
+    static getAllMetadata(): Map<string, ComponentMetadata>;
+    /**
+     * Get hydrated state (Phase B)
+     */
+    static getHydrated(componentId: string): ComponentState | undefined;
+    /**
+     * Get all hydrated states
+     */
+    static getAllHydrated(): Map<string, ComponentState>;
+    /**
+     * Check if component is registered
+     */
+    static isRegistered(componentId: string): boolean;
+    /**
+     * Check if component is hydrated
+     */
+    static isHydrated(componentId: string): boolean;
+    /**
+     * Clear all registrations (useful for testing)
+     */
+    static clear(): void;
+    /**
+     * Unregister a component
+     */
+    static unregister(componentId: string): void;
+    /**
+     * Register a stateful component instance
+     *
+     * @param componentName - Name of the component (from @Component decorator)
+     * @param instance - StatefulComponent instance
+     */
+    static registerInstance(componentName: string, instance: StatefulComponent): void;
+    /**
+     * Get a stateful component instance
+     *
+     * @param componentName - Name of the component
+     * @returns StatefulComponent instance or undefined
+     */
+    static getInstance(componentName: string): StatefulComponent | undefined;
+    /**
+     * Get component state via instance
+     *
+     * @param componentName - Name of the component
+     * @returns Current component state
+     * @throws Error if component not found
+     */
+    static getState(componentName: string): any;
+    /**
+     * Set component state via instance
+     *
+     * @param componentName - Name of the component
+     * @param state - State to set
+     * @throws Error if component not found
+     */
+    static setState(componentName: string, state: any): void;
+    /**
+     * Reset component to initial state
+     *
+     * @param componentName - Name of the component
+     * @throws Error if component not found
+     */
+    static resetComponentState(componentName: string): void;
+    /**
+     * Get all registered stateful component names
+     *
+     * @returns Array of component names
+     */
+    static getAllInstanceNames(): string[];
+    /**
+     * Check if a stateful component instance is registered
+     *
+     * @param componentName - Name of the component
+     * @returns True if instance is registered
+     */
+    static hasInstance(componentName: string): boolean;
+    /**
+     * Clear stateful component instances (for testing)
+     */
+    static clearInstances(): void;
+}
+//# sourceMappingURL=ComponentRegistry.d.ts.map