@supernal/interface 1.0.0

package/dist/esm/src/ai/ToolExecutor.js

@@ -0,0 +1,174 @@
+/**
+ * ToolExecutor - Universal execution engine for tools
+ *
+ * Supports multiple execution strategies:
+ * - Programmatic (direct method call)
+ * - DOM-based (Playwright/browser automation)
+ * - Navigation (route changes)
+ */
+/**
+ * Main ToolExecutor orchestrator
+ */
+export class ToolExecutor {
+    constructor() {
+        this.strategies = [];
+        // Register default strategies (order matters - first match wins)
+        this.registerStrategy(new ProgrammaticExecutor());
+        this.registerStrategy(new NavigationExecutor());
+        this.registerStrategy(new DOMExecutor());
+    }
+    /**
+     * Register a new execution strategy
+     */
+    registerStrategy(strategy) {
+        this.strategies.push(strategy);
+    }
+    /**
+     * Execute a tool using the appropriate strategy
+     */
+    async execute(tool, parameters = []) {
+        const startTime = Date.now();
+        // Find first strategy that can execute this tool
+        for (const strategy of this.strategies) {
+            if (strategy.canExecute(tool)) {
+                // console.log(`🔧 [ToolExecutor] Using strategy: ${strategy.name}`);
+                try {
+                    const result = await strategy.execute(tool, parameters);
+                    result.timing = Date.now() - startTime;
+                    return result;
+                }
+                catch (error) {
+                    // console.error(`[ToolExecutor] Strategy ${strategy.name} failed:`, error);
+                    return {
+                        success: false,
+                        message: `Execution failed: ${error instanceof Error ? error.message : String(error)}`,
+                        error: error instanceof Error ? error : new Error(String(error)),
+                        timing: Date.now() - startTime
+                    };
+                }
+            }
+        }
+        // No strategy could execute
+        return {
+            success: false,
+            message: `No execution strategy available for tool: ${tool.name}`,
+            timing: Date.now() - startTime
+        };
+    }
+}
+/**
+ * Programmatic execution - direct method calls
+ */
+class ProgrammaticExecutor {
+    constructor() {
+        this.name = 'programmatic';
+    }
+    canExecute(tool) {
+        // Can execute if tool has instance and method name
+        return !!(tool.instance && tool.methodName);
+    }
+    async execute(tool, parameters) {
+        // console.log(`🎯 [Programmatic] Executing: ${tool.name}`, parameters);
+        const result = await tool.instance[tool.methodName](...parameters);
+        // Handle different return types
+        if (typeof result === 'object' && result !== null) {
+            if ('success' in result && 'message' in result) {
+                // Already in ExecutionResult format
+                return result;
+            }
+            // Convert to ExecutionResult
+            return {
+                success: true,
+                message: result.message || `${tool.name} executed successfully`,
+                data: result
+            };
+        }
+        // Primitive return value
+        return {
+            success: true,
+            message: `${tool.name} executed successfully`,
+            data: result
+        };
+    }
+}
+/**
+ * Navigation execution - route changes
+ */
+class NavigationExecutor {
+    constructor() {
+        this.name = 'navigation';
+    }
+    canExecute(tool) {
+        // Check if tool is navigation-related
+        const isNavCategory = tool.category === 'navigation';
+        const hasNavKeywords = tool.name.toLowerCase().includes('navigate') ||
+            tool.name.toLowerCase().includes('go to') ||
+            tool.description?.toLowerCase().includes('navigate');
+        return isNavCategory || hasNavKeywords;
+    }
+    async execute(tool, parameters) {
+        // console.log(`🗺️  [Navigation] Executing: ${tool.name}`, parameters);
+        // Use programmatic executor first (navigation tools typically have instance methods)
+        if (tool.instance && tool.methodName) {
+            const programmatic = new ProgrammaticExecutor();
+            return programmatic.execute(tool, parameters);
+        }
+        // Fallback: try to extract route from tool metadata
+        const route = tool.route || tool.elementId;
+        if (route) {
+            // Get NavigationGraph singleton and use its handler
+            const { NavigationGraph } = await import('../background/navigation/NavigationGraph');
+            const graph = NavigationGraph.getInstance();
+            // Use the public getRouteForContext method and the handler
+            const handler = graph.navigationHandler;
+            if (handler) {
+                await handler(route);
+                return {
+                    success: true,
+                    message: `Navigated to ${tool.name}`
+                };
+            }
+        }
+        throw new Error('No navigation method available');
+    }
+}
+/**
+ * DOM execution - browser automation (Playwright, etc.)
+ */
+class DOMExecutor {
+    constructor() {
+        this.name = 'dom';
+    }
+    canExecute(tool) {
+        // Can execute if tool has elementId (DOM target)
+        return !!tool.elementId && !tool.instance;
+    }
+    async execute(tool, _parameters) {
+        // console.log(`🌐 [DOM] Executing: ${tool.name}`, _parameters);
+        // Find element in DOM
+        const element = document.querySelector(`[data-testid="${tool.elementId}"]`);
+        if (!element) {
+            throw new Error(`Could not find element with data-testid="${tool.elementId}"`);
+        }
+        // Determine action type
+        if (element.tagName === 'BUTTON' || element.tagName === 'A') {
+            element.click();
+            return {
+                success: true,
+                message: `Clicked ${tool.name}`
+            };
+        }
+        if (element.tagName === 'INPUT' || element.tagName === 'TEXTAREA') {
+            if (_parameters.length > 0) {
+                element.value = String(_parameters[0]);
+                element.dispatchEvent(new Event('input', { bubbles: true }));
+                return {
+                    success: true,
+                    message: `Entered text into ${tool.name}`
+                };
+            }
+        }
+        throw new Error(`Unsupported element type: ${element.tagName}`);
+    }
+}
+//# sourceMappingURL=ToolExecutor.js.map

package/dist/esm/src/ai/ToolExecutor.js.map

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

package/dist/esm/src/ai/ToolMatcher.d.ts

@@ -0,0 +1,61 @@
+/**
+ * ToolMatcher - Pluggable strategy for matching user queries to tools
+ *
+ * Supports multiple matching strategies with priority-based selection:
+ * - Exact match (priority 100)
+ * - Fuzzy string matching (priority 60)
+ * - LLM-based semantic matching (priority 50)
+ * - Keyword-based heuristics (priority 30)
+ */
+import type { ToolMetadata } from '../decorators/Tool';
+/**
+ * Match result with confidence score and extracted parameters
+ */
+export interface ToolMatch {
+    tool: ToolMetadata;
+    confidence: number;
+    parameters?: any[];
+    reasoning?: string;
+}
+/**
+ * Base interface for all matching strategies
+ */
+export interface MatcherStrategy {
+    name: string;
+    priority: number;
+    /**
+     * Match a query against available tools
+     * @returns Array of matches sorted by confidence (highest first)
+     */
+    match(query: string, tools: ToolMetadata[], context?: MatchContext): Promise<ToolMatch[]>;
+}
+/**
+ * Context passed to matchers for better matching
+ */
+export interface MatchContext {
+    currentContainer?: string;
+    currentPage?: string;
+    conversationHistory?: string[];
+    userPreferences?: Record<string, any>;
+}
+/**
+ * Main ToolMatcher orchestrator
+ */
+export declare class ToolMatcher {
+    private strategies;
+    constructor();
+    /**
+     * Register a new matching strategy
+     */
+    registerStrategy(strategy: MatcherStrategy): void;
+    /**
+     * Find best matches for a query using all strategies
+     * @returns Top N matches sorted by confidence
+     */
+    findMatches(query: string, tools: ToolMetadata[], context?: MatchContext, topN?: number): Promise<ToolMatch[]>;
+    /**
+     * Get suggestions for invalid/ambiguous queries
+     */
+    getSuggestions(query: string, tools: ToolMetadata[], context?: MatchContext): Promise<string[]>;
+}
+//# sourceMappingURL=ToolMatcher.d.ts.map

package/dist/esm/src/ai/ToolMatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolMatcher.d.ts","sourceRoot":"","sources":["../../../../src/ai/ToolMatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CAC3F;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAyB;;IAQ3C;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAMjD;;;OAGG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,CAAC,EAAE,YAAY,EACtB,IAAI,GAAE,MAAU,GACf,OAAO,CAAC,SAAS,EAAE,CAAC;IA8BvB;;OAEG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC;CAiBrB"}

package/dist/esm/src/ai/ToolMatcher.js

@@ -0,0 +1,198 @@
+/**
+ * ToolMatcher - Pluggable strategy for matching user queries to tools
+ *
+ * Supports multiple matching strategies with priority-based selection:
+ * - Exact match (priority 100)
+ * - Fuzzy string matching (priority 60)
+ * - LLM-based semantic matching (priority 50)
+ * - Keyword-based heuristics (priority 30)
+ */
+/**
+ * Main ToolMatcher orchestrator
+ */
+export class ToolMatcher {
+    constructor() {
+        this.strategies = [];
+        // Register default strategies (more added via registerStrategy)
+        this.registerStrategy(new ExactMatcher());
+        this.registerStrategy(new FuzzyMatcher());
+    }
+    /**
+     * Register a new matching strategy
+     */
+    registerStrategy(strategy) {
+        this.strategies.push(strategy);
+        // Sort by priority (highest first)
+        this.strategies.sort((a, b) => b.priority - a.priority);
+    }
+    /**
+     * Find best matches for a query using all strategies
+     * @returns Top N matches sorted by confidence
+     */
+    async findMatches(query, tools, context, topN = 5) {
+        const allMatches = [];
+        // Try each strategy in priority order
+        for (const strategy of this.strategies) {
+            try {
+                const matches = await strategy.match(query, tools, context);
+                allMatches.push(...matches);
+            }
+            catch (error) {
+                console.warn(`[ToolMatcher] Strategy ${strategy.name} failed:`, error);
+            }
+        }
+        // Deduplicate by tool ID and keep highest confidence
+        const deduped = new Map();
+        for (const match of allMatches) {
+            const key = match.tool.elementId || match.tool.name;
+            const existing = deduped.get(key);
+            if (!existing || match.confidence > existing.confidence) {
+                deduped.set(key, match);
+            }
+        }
+        // Sort by confidence and return top N
+        return Array.from(deduped.values())
+            .sort((a, b) => b.confidence - a.confidence)
+            .slice(0, topN);
+    }
+    /**
+     * Get suggestions for invalid/ambiguous queries
+     */
+    async getSuggestions(query, tools, context) {
+        // Find close matches (confidence 30-60%)
+        const matches = await this.findMatches(query, tools, context, 10);
+        const suggestions = matches
+            .filter(m => m.confidence >= 30 && m.confidence < 70)
+            .map(m => {
+            const toolName = m.tool.name;
+            const examples = m.tool.examples;
+            if (examples && examples.length > 0) {
+                return `"${examples[0]}"`;
+            }
+            return `"${toolName}"`;
+        })
+            .slice(0, 5);
+        return suggestions;
+    }
+}
+/**
+ * Exact match strategy - checks for exact tool name or example match
+ */
+class ExactMatcher {
+    constructor() {
+        this.name = 'exact';
+        this.priority = 100;
+    }
+    async match(query, tools) {
+        const lowerQuery = query.toLowerCase().trim();
+        const matches = [];
+        for (const tool of tools) {
+            const toolName = tool.name.toLowerCase();
+            const examples = tool.examples || [];
+            // Check exact name match
+            if (lowerQuery === toolName) {
+                matches.push({
+                    tool,
+                    confidence: 100,
+                    reasoning: 'Exact name match'
+                });
+                continue;
+            }
+            // Check exact example match
+            for (const example of examples) {
+                const exampleLower = example.toLowerCase();
+                if (lowerQuery === exampleLower) {
+                    matches.push({
+                        tool,
+                        confidence: 95,
+                        reasoning: `Exact example match: "${example}"`
+                    });
+                    break;
+                }
+            }
+        }
+        return matches;
+    }
+}
+/**
+ * Fuzzy match strategy - uses Levenshtein distance and keyword matching
+ */
+class FuzzyMatcher {
+    constructor() {
+        this.name = 'fuzzy';
+        this.priority = 60;
+    }
+    async match(query, tools) {
+        const lowerQuery = query.toLowerCase().trim();
+        const matches = [];
+        for (const tool of tools) {
+            let bestScore = 0;
+            let bestMatch = '';
+            // Check tool name similarity
+            const nameScore = this.similarity(lowerQuery, tool.name.toLowerCase());
+            if (nameScore > bestScore) {
+                bestScore = nameScore;
+                bestMatch = tool.name;
+            }
+            // Check examples similarity
+            const examples = tool.examples || [];
+            for (const example of examples) {
+                const exampleScore = this.similarity(lowerQuery, example.toLowerCase());
+                if (exampleScore > bestScore) {
+                    bestScore = exampleScore;
+                    bestMatch = example;
+                }
+            }
+            // Check keyword overlap
+            const keywords = tool.description?.toLowerCase().split(/\s+/) || [];
+            const queryWords = lowerQuery.split(/\s+/);
+            const keywordScore = queryWords.filter(w => keywords.includes(w)).length / queryWords.length;
+            if (keywordScore > bestScore) {
+                bestScore = keywordScore;
+                bestMatch = 'keyword overlap';
+            }
+            // Only include if confidence > 50%
+            if (bestScore > 0.5) {
+                matches.push({
+                    tool,
+                    confidence: Math.round(bestScore * 100),
+                    reasoning: `Fuzzy match: ${bestMatch}`
+                });
+            }
+        }
+        return matches;
+    }
+    /**
+     * Calculate similarity between two strings (0-1)
+     * Uses Levenshtein distance normalized by string length
+     */
+    similarity(a, b) {
+        const distance = this.levenshtein(a, b);
+        const maxLength = Math.max(a.length, b.length);
+        return 1 - (distance / maxLength);
+    }
+    /**
+     * Levenshtein distance algorithm
+     */
+    levenshtein(a, b) {
+        const matrix = [];
+        for (let i = 0; i <= b.length; i++) {
+            matrix[i] = [i];
+        }
+        for (let j = 0; j <= a.length; j++) {
+            matrix[0][j] = j;
+        }
+        for (let i = 1; i <= b.length; i++) {
+            for (let j = 1; j <= a.length; j++) {
+                if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                    matrix[i][j] = matrix[i - 1][j - 1];
+                }
+                else {
+                    matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j] + 1);
+                }
+            }
+        }
+        return matrix[b.length][a.length];
+    }
+}
+//# sourceMappingURL=ToolMatcher.js.map

package/dist/esm/src/ai/ToolMatcher.js.map

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

package/dist/esm/src/ai/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AI Command Interface - Core exports (Open Source Edition)
+ *
+ * Basic AI matching and execution. Advanced features (LLMProvider,
+ * ParameterExtractor, SuggestionEngine) available in enterprise edition.
+ */
+export * from './ToolMatcher';
+export * from './ToolExecutor';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/src/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/esm/src/ai/index.js

@@ -0,0 +1,13 @@
+/**
+ * AI Command Interface - Core exports (Open Source Edition)
+ *
+ * Basic AI matching and execution. Advanced features (LLMProvider,
+ * ParameterExtractor, SuggestionEngine) available in enterprise edition.
+ */
+export * from './ToolMatcher.js';
+export * from './ToolExecutor.js';
+// Enterprise features - available at https://supernal.ai/enterprise
+// export * from './ParameterExtractor.js';
+// export * from './LLMProvider.js';
+// export * from './SuggestionEngine.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/src/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAE/B,oEAAoE;AACpE,wCAAwC;AACxC,iCAAiC;AACjC,sCAAsC"}

package/dist/esm/src/architecture/createContainer.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Create Container Helper
+ *
+ * Creates a container configuration and registers it with the architecture registry.
+ * Supports multiple formats from minimal to fully configured.
+ *
+ * @example Minimal format (infers most fields)
+ * ```typescript
+ * export const BlogContainer = createContainer('Blog', 'page');
+ * // Result: { id: 'blog', name: 'Blog', type: 'page', route: '/blog' }
+ * ```
+ *
+ * @example With route override
+ * ```typescript
+ * export const BlogContainer = createContainer('Blog', 'page', '/posts');
+ * // Result: { id: 'blog', name: 'Blog', type: 'page', route: '/posts' }
+ * ```
+ *
+ * @example Full config object (maximum control)
+ * ```typescript
+ * export const BlogContainer = createContainer({
+ *   id: 'blog-archive',
+ *   name: 'Blog',
+ *   type: 'page',
+ *   route: '/archive',
+ *   description: 'Blog archive page',
+ *   metadata: { category: 'content' }
+ * });
+ * ```
+ */
+export interface ContainerConfig {
+    id: string;
+    name: string;
+    type: 'page' | 'modal' | 'drawer' | 'section';
+    route?: string;
+    description?: string;
+    parent?: string;
+    metadata?: Record<string, any>;
+}
+export declare function createContainer(name: string, type: 'page' | 'modal' | 'drawer' | 'section', route?: string): ContainerConfig;
+export declare function createContainer(config: ContainerConfig): ContainerConfig;
+/**
+ * Create multiple containers at once
+ *
+ * @example
+ * ```typescript
+ * export const Containers = createContainers({
+ *   Blog: { id: 'blog', name: 'Blog', type: 'page', route: '/blog' },
+ *   Demo: { id: 'demo', name: 'Demo', type: 'page', route: '/demo' },
+ * });
+ * ```
+ */
+export declare function createContainers<T extends Record<string, ContainerConfig>>(configs: T): T;
+/**
+ * Type helper for container names
+ */
+export type ContainerName<T> = T extends {
+    name: infer N;
+} ? N : never;
+//# sourceMappingURL=createContainer.d.ts.map

package/dist/esm/src/architecture/createContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContainer.d.ts","sourceRoot":"","sources":["../../../../src/architecture/createContainer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAqBD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,EAC7C,KAAK,CAAC,EAAE,MAAM,GACb,eAAe,CAAC;AAGnB,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAAC;AAkD1E;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACxE,OAAO,EAAE,CAAC,GACT,CAAC,CAQH;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC"}

package/dist/esm/src/architecture/createContainer.js

@@ -0,0 +1,102 @@
+/**
+ * Create Container Helper
+ *
+ * Creates a container configuration and registers it with the architecture registry.
+ * Supports multiple formats from minimal to fully configured.
+ *
+ * @example Minimal format (infers most fields)
+ * ```typescript
+ * export const BlogContainer = createContainer('Blog', 'page');
+ * // Result: { id: 'blog', name: 'Blog', type: 'page', route: '/blog' }
+ * ```
+ *
+ * @example With route override
+ * ```typescript
+ * export const BlogContainer = createContainer('Blog', 'page', '/posts');
+ * // Result: { id: 'blog', name: 'Blog', type: 'page', route: '/posts' }
+ * ```
+ *
+ * @example Full config object (maximum control)
+ * ```typescript
+ * export const BlogContainer = createContainer({
+ *   id: 'blog-archive',
+ *   name: 'Blog',
+ *   type: 'page',
+ *   route: '/archive',
+ *   description: 'Blog archive page',
+ *   metadata: { category: 'content' }
+ * });
+ * ```
+ */
+import { architectureRegistry } from '../architecture/registry.js';
+/**
+ * Convert name to kebab-case ID
+ */
+function nameToId(name) {
+    return name
+        .replace(/([A-Z])/g, '-$1')
+        .toLowerCase()
+        .replace(/^-/, '');
+}
+/**
+ * Convert name to default route
+ */
+function nameToRoute(name) {
+    return '/' + nameToId(name);
+}
+/**
+ * Create and register a container with flexible input formats
+ */
+// eslint-disable-next-line no-redeclare
+export function createContainer(nameOrConfig, type, route) {
+    let config;
+    if (typeof nameOrConfig === 'string') {
+        // Minimal format: createContainer('Blog', 'page', '/custom-route')
+        if (!type) {
+            throw new Error('Type is required when using string format');
+        }
+        const name = nameOrConfig;
+        const id = nameToId(name);
+        const inferredRoute = route || nameToRoute(name);
+        config = {
+            id,
+            name,
+            type,
+            route: inferredRoute,
+        };
+    }
+    else {
+        // Full config object format
+        config = nameOrConfig;
+        // Validate required fields
+        if (!config.id || !config.name || !config.type) {
+            throw new Error('Container must have id, name, and type');
+        }
+        // Infer route if not provided and type is page
+        if (!config.route && config.type === 'page') {
+            config.route = nameToRoute(config.name);
+        }
+    }
+    // Register with architecture
+    architectureRegistry.registerContainer(config.name, config);
+    return config;
+}
+/**
+ * Create multiple containers at once
+ *
+ * @example
+ * ```typescript
+ * export const Containers = createContainers({
+ *   Blog: { id: 'blog', name: 'Blog', type: 'page', route: '/blog' },
+ *   Demo: { id: 'demo', name: 'Demo', type: 'page', route: '/demo' },
+ * });
+ * ```
+ */
+export function createContainers(configs) {
+    const result = {};
+    for (const [key, config] of Object.entries(configs)) {
+        result[key] = createContainer(config);
+    }
+    return result;
+}
+//# sourceMappingURL=createContainer.js.map

package/dist/esm/src/architecture/createContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContainer.js","sourceRoot":"","sources":["../../../../src/architecture/createContainer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAYhE;;GAEG;AACH,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI;SACR,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;SAC1B,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAaD;;GAEG;AACH,wCAAwC;AACxC,MAAM,UAAU,eAAe,CAC7B,YAAsC,EACtC,IAA8C,EAC9C,KAAc;IAEd,IAAI,MAAuB,CAAC;IAE5B,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,mEAAmE;QACnE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,IAAI,GAAG,YAAY,CAAC;QAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,aAAa,GAAG,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QAEjD,MAAM,GAAG;YACP,EAAE;YACF,IAAI;YACJ,IAAI;YACJ,KAAK,EAAE,aAAa;SACrB,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,4BAA4B;QAC5B,MAAM,GAAG,YAAY,CAAC;QAEtB,2BAA2B;QAC3B,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,+CAA+C;QAC/C,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5C,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,oBAAoB,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE5D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAU;IAEV,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}