@supernal/interface 1.0.0

package/dist/cjs/src/name-contracts/ContractScanner.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Abstract Contract Scanner Interface
+ *
+ * All name contract scanners (components, routes, API, CLI) implement this interface
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContractScanner = void 0;
+/**
+ * Base interface that all contract scanners must implement
+ */
+class ContractScanner {
+}
+exports.ContractScanner = ContractScanner;
+//# sourceMappingURL=ContractScanner.js.map

package/dist/cjs/src/name-contracts/ContractScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContractScanner.js","sourceRoot":"","sources":["../../../../src/name-contracts/ContractScanner.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAmCH;;GAEG;AACH,MAAsB,eAAe;CA4BpC;AA5BD,0CA4BC"}

package/dist/cjs/src/name-contracts/RouteContractScanner.js

@@ -0,0 +1,225 @@
+"use strict";
+/**
+ * Route Contract Scanner
+ *
+ * Scans codebase for route patterns and generates type-safe route contracts
+ *
+ * Integrates with existing route scanning system:
+ * - NextjsDynamicScanner for route discovery
+ * - RouteContractGenerator for contract generation
+ */
+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 __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.RouteContractScanner = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs/promises"));
+const ContractScanner_1 = require("./ContractScanner");
+const NextjsDynamicScanner_1 = require("../routes/scanners/NextjsDynamicScanner");
+const RouteContractGenerator_1 = require("../routes/RouteContractGenerator");
+class RouteContractScanner extends ContractScanner_1.ContractScanner {
+    constructor(projectRoot, config) {
+        super();
+        this.type = 'routes';
+        this.description = 'Next.js route patterns (Views + API)';
+        this.projectRoot = projectRoot;
+        this.config = config || this.loadConfigFromSupernal();
+    }
+    loadConfigFromSupernal() {
+        const supernalYamlPath = path.join(this.projectRoot, 'supernal.yaml');
+        try {
+            const yaml = require('js-yaml');
+            const fs = require('fs');
+            const supernalConfig = yaml.load(fs.readFileSync(supernalYamlPath, 'utf8'));
+            if (supernalConfig?.name_contracts?.routes) {
+                const routesConfig = supernalConfig.name_contracts.routes;
+                return {
+                    routingSystem: routesConfig.routing_system || 'nextjs-dynamic',
+                    scanPaths: {
+                        routes: routesConfig.scan_paths?.routes || [],
+                        components: routesConfig.scan_paths?.components || [],
+                    },
+                    output: {
+                        contractsPath: routesConfig.output?.contracts_path || 'src/lib/routing/Routes.ts',
+                        testUtilsPath: routesConfig.output?.test_utils_path,
+                    },
+                    generation: {
+                        includeJsDocs: routesConfig.generation?.include_jsdocs !== false,
+                        includeValidation: routesConfig.generation?.include_validation || false,
+                        includeTypeGuards: routesConfig.generation?.include_type_guards || false,
+                    },
+                };
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // eslint-disable-next-line no-console
+            console.warn(`⚠️ Could not load route contracts config from supernal.yaml: ${errorMessage}`);
+            // eslint-disable-next-line no-console
+            console.warn('   Using default configuration');
+        }
+        return this.getDefaultConfig();
+    }
+    getDefaultConfig() {
+        return {
+            routingSystem: 'nextjs-name-extraction',
+            scanPaths: {
+                routes: ['apps/supernal-dashboard/src/app'],
+                components: ['apps/supernal-dashboard/src/lib/routing/slugService.ts'],
+            },
+            output: {
+                contractsPath: 'apps/supernal-dashboard/src/lib/routing/Routes.ts',
+                testUtilsPath: 'apps/supernal-dashboard/tests/utils/routes.ts',
+            },
+            generation: {
+                includeJsDocs: true,
+            },
+        };
+    }
+    async scan() {
+        const scanner = new NextjsDynamicScanner_1.NextjsDynamicScanner(this.config);
+        const routeScanResult = await scanner.scan();
+        // Convert RouteInfo[] to ContractEntry map
+        const contracts = new Map();
+        for (const route of routeScanResult.routes) {
+            contracts.set(route.id, {
+                name: route.id,
+                value: route.pattern,
+                category: route.metadata?.category || 'General',
+                files: [route.metadata?.source || 'generated'],
+                metadata: {
+                    params: route.params,
+                    methods: route.metadata?.methods, // Preserve HTTP methods
+                    description: route.metadata?.description,
+                },
+            });
+        }
+        return {
+            contracts,
+            metadata: {
+                routingSystem: this.config.routingSystem,
+                totalRoutes: contracts.size,
+            },
+        };
+    }
+    async generate(result, options) {
+        // Convert back to RouteInfo[] for generator
+        const routes = Array.from(result.contracts.values()).map(entry => ({
+            id: entry.name,
+            pattern: entry.value,
+            params: entry.metadata?.params || [],
+            metadata: {
+                category: entry.category,
+                methods: entry.metadata?.methods, // Restore HTTP methods
+                description: entry.metadata?.description,
+            },
+        }));
+        const generator = new RouteContractGenerator_1.RouteContractGenerator();
+        const content = generator.generate({
+            routes,
+            metadata: {
+                timestamp: new Date().toISOString(),
+                scannedPaths: this.config.scanPaths.routes || [],
+                routingSystem: this.config.routingSystem,
+            },
+        });
+        if (!options.dryRun) {
+            const outputPath = path.join(this.projectRoot, options.outputPath);
+            await fs.mkdir(path.dirname(outputPath), { recursive: true });
+            await fs.writeFile(outputPath, content, 'utf-8');
+        }
+        return content;
+    }
+    async migrate(_options) {
+        // TODO: Implement route migration
+        // For now, return empty result
+        // eslint-disable-next-line no-console
+        console.log('⚠️  Route migration not yet implemented');
+        // eslint-disable-next-line no-console
+        console.log('   Use test utilities in tests/utils/TestRoutes.ts instead');
+        return {
+            changes: 0,
+            skipped: 0,
+            files: [],
+        };
+    }
+    async validate() {
+        const errors = [];
+        // Check if generated contracts exist
+        const contractsPath = path.join(this.projectRoot, this.config.output.contractsPath);
+        try {
+            await fs.access(contractsPath);
+        }
+        catch {
+            errors.push(`Contracts file not found: ${this.config.output.contractsPath}`);
+            errors.push('Run: sc code generate --type=routes');
+            return errors;
+        }
+        // Scan current routes
+        const scanResult = await this.scan();
+        // Read generated contracts
+        const contractsContent = await fs.readFile(contractsPath, 'utf-8');
+        // Basic validation: check if route counts match
+        const generatedRouteCount = (contractsContent.match(/:\s*'\/[^']+'/g) || []).length;
+        if (generatedRouteCount !== scanResult.contracts.size) {
+            errors.push(`Route count mismatch: Generated has ${generatedRouteCount}, codebase has ${scanResult.contracts.size}`);
+            errors.push('Run: sc code generate --type=routes');
+        }
+        return errors;
+    }
+    getDefaultOutputPath() {
+        return this.config.output.contractsPath;
+    }
+    /**
+     * Load config from file if exists
+     */
+    static async loadConfig(configPath) {
+        try {
+            const fullPath = path.isAbsolute(configPath)
+                ? configPath
+                : path.join(process.cwd(), configPath);
+            // Use dynamic import for TypeScript config files
+            if (configPath.endsWith('.ts')) {
+                require('ts-node/register');
+            }
+            const config = require(fullPath);
+            return config.default || config;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.RouteContractScanner = RouteContractScanner;
+//# sourceMappingURL=RouteContractScanner.js.map

package/dist/cjs/src/name-contracts/RouteContractScanner.js.map

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

package/dist/cjs/src/name-contracts/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Name Contracts - Abstract Base
+ *
+ * Provides base classes and interfaces for scanning codebases
+ * and generating type-safe name contracts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteContractScanner = exports.ContractScanner = void 0;
+var ContractScanner_1 = require("./ContractScanner");
+Object.defineProperty(exports, "ContractScanner", { enumerable: true, get: function () { return ContractScanner_1.ContractScanner; } });
+// Route Contract Scanner (uses ContractScanner as base)
+var RouteContractScanner_1 = require("./RouteContractScanner");
+Object.defineProperty(exports, "RouteContractScanner", { enumerable: true, get: function () { return RouteContractScanner_1.RouteContractScanner; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/src/name-contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/name-contracts/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AAGxB,wDAAwD;AACxD,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA"}

package/dist/cjs/src/names/createNames.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Create Component Names Helper
+ *
+ * Creates a component namespace with automatic kebab-case conversion and registry.
+ *
+ * Supports multiple formats for maximum flexibility:
+ *
+ * @example Minimal array format (fastest to write)
+ * ```typescript
+ * export const Blog = createNames('blog', ['container', 'searchInput', 'postCard']);
+ * // Result: { container: 'blog-container', searchInput: 'blog-search-input', postCard: 'blog-post-card' }
+ * ```
+ *
+ * @example Object format (same as current)
+ * ```typescript
+ * export const Blog = createNames('blog', {
+ *   container: 'container',
+ *   searchInput: 'searchInput',
+ *   postCard: 'postCard',
+ * });
+ * ```
+ *
+ * @example Custom suffixes (for special cases)
+ * ```typescript
+ * export const Blog = createNames('blog', {
+ *   container: 'main-wrapper',  // Becomes 'blog-main-wrapper'
+ *   searchInput: 'search',       // Becomes 'blog-search'
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNames = createNames;
+exports.getComponentIds = getComponentIds;
+exports.isComponentId = isComponentId;
+const registry_1 = require("../architecture/registry");
+/**
+ * Convert camelCase to kebab-case
+ */
+function camelToKebab(str) {
+    return str
+        .replace(/([A-Z])/g, '-$1')
+        .toLowerCase()
+        .replace(/^-/, ''); // Remove leading dash if first char was uppercase
+}
+/**
+ * Create component names with automatic prefixing and kebab-case conversion
+ *
+ * @param prefix - The prefix for all component IDs (e.g., 'blog', 'demo')
+ * @param names - Array of keys or object mapping keys to suffixes
+ * @returns Object with fully qualified component IDs (prefix-suffix in kebab-case)
+ */
+// eslint-disable-next-line no-redeclare
+function createNames(prefix, names) {
+    const result = {};
+    if (Array.isArray(names)) {
+        // Array format: ['container', 'searchInput'] -> { container: 'blog-container', searchInput: 'blog-search-input' }
+        for (const key of names) {
+            const kebab = camelToKebab(key);
+            result[key] = `${prefix}-${kebab}`;
+        }
+    }
+    else {
+        // Object format: { container: 'container' } -> { container: 'blog-container' }
+        for (const [key, value] of Object.entries(names)) {
+            const kebab = camelToKebab(value);
+            result[key] = `${prefix}-${kebab}`;
+        }
+    }
+    // Register with architecture registry
+    registry_1.architectureRegistry.registerComponent(prefix, result);
+    return result;
+}
+/**
+ * Get all component IDs from a namespace as a flat array
+ */
+function getComponentIds(namespace) {
+    return Object.values(namespace);
+}
+/**
+ * Validate that a string is a valid component ID in a namespace
+ */
+function isComponentId(namespace, id) {
+    return Object.values(namespace).includes(id);
+}
+//# sourceMappingURL=createNames.js.map

package/dist/cjs/src/names/createNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNames.js","sourceRoot":"","sources":["../../../../src/names/createNames.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;AAmCH,kCAwBC;AAUD,0CAIC;AAKD,sCAKC;AAjFD,uDAAgE;AAEhE;;GAEG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG;SACP,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;SAC1B,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,kDAAkD;AAC1E,CAAC;AAeD;;;;;;GAMG;AACH,wCAAwC;AACxC,SAAgB,WAAW,CACzB,MAAS,EACT,KAAiD;IAEjD,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,kHAAkH;QAClH,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;QACrC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,+EAA+E;QAC/E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YAClC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;QACrC,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,+BAAoB,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvD,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD;;GAEG;AACH,SAAgB,eAAe,CAC7B,SAAY;IAEZ,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAC3B,SAAY,EACZ,EAAU;IAEV,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/cjs/src/react/hooks/useChatWithContext.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * useChatWithContext - Hook for integrating AI chat with application context
+ *
+ * Provides chat capabilities that can be plugged into any UI:
+ * - Automatic context injection (current view, available tools, app state)
+ * - Tool execution
+ * - Prompt building with context
+ * - Message handling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChatWithContext = useChatWithContext;
+const react_1 = require("react");
+const ToolRegistry_1 = require("../../background/registry/ToolRegistry");
+function useChatWithContext(config = {}) {
+    const [messages, setMessages] = (0, react_1.useState)([]);
+    const [isProcessing, setIsProcessing] = (0, react_1.useState)(false);
+    // Get available tools for current container
+    const availableTools = (0, react_1.useMemo)(() => {
+        if (!config.containerId) {
+            return Array.from(ToolRegistry_1.ToolRegistry.getAllTools().values())
+                .filter(t => t.aiEnabled);
+        }
+        return ToolRegistry_1.ToolRegistry.searchScoped('', config.containerId);
+    }, [config.containerId]);
+    // Build context object
+    const getCurrentContext = (0, react_1.useCallback)(() => {
+        return {
+            containerId: config.containerId,
+            userId: config.userId,
+            appState: config.getAppState?.(),
+            metadata: {
+                timestamp: new Date().toISOString(),
+                toolCount: availableTools.length
+            }
+        };
+    }, [config.containerId, config.userId, config.getAppState, availableTools.length]);
+    // Build prompt with context
+    const buildPromptWithContext = (0, react_1.useCallback)((userMessage) => {
+        const context = getCurrentContext();
+        const toolNames = availableTools.map(t => t.name || `${t.componentName}.${t.methodName}`);
+        const systemPrompt = config.systemPrompt || `You are an AI assistant with access to application tools.
+
+Current Context:
+- Container: ${context.containerId || 'global'}
+- Available Tools: ${toolNames.join(', ')}
+${context.appState ? `- Application State: ${JSON.stringify(context.appState, null, 2)}` : ''}
+
+When the user asks you to do something:
+1. Identify the appropriate tool from available tools
+2. Extract any required parameters from the user's message
+3. Return the tool name and parameters in your response
+4. Confirm the action after execution
+
+Be concise and helpful.`;
+        return {
+            userMessage,
+            context,
+            availableTools: toolNames,
+            systemPrompt
+        };
+    }, [getCurrentContext, availableTools, config.systemPrompt]);
+    // Execute a tool
+    const executeTool = (0, react_1.useCallback)(async (toolId, args = {}) => {
+        try {
+            // Get tool metadata
+            const tool = ToolRegistry_1.ToolRegistry.getTool(toolId);
+            if (!tool || !tool.method) {
+                throw new Error(`Tool not found or has no method: ${toolId}`);
+            }
+            // Convert args object to parameters array based on inputSchema
+            const parameters = [];
+            if (tool.inputSchema) {
+                for (const [paramName, paramDef] of Object.entries(tool.inputSchema)) {
+                    const def = paramDef;
+                    parameters.push(args[paramName] ?? def.default);
+                }
+            }
+            // Execute the tool method
+            const result = await tool.method(...parameters);
+            config.onToolExecute?.(toolId, args, result);
+            return {
+                success: true,
+                result,
+                error: undefined
+            };
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            config.onError?.(err);
+            return {
+                success: false,
+                result: undefined,
+                error: err.message
+            };
+        }
+    }, [config]);
+    // Add a message
+    const addMessage = (0, react_1.useCallback)((content, role = 'user') => {
+        const message = {
+            id: `msg-${Date.now()}-${Math.random()}`,
+            role,
+            content,
+            timestamp: new Date(),
+            context: role === 'user' ? getCurrentContext() : undefined
+        };
+        setMessages(prev => [...prev, message]);
+        config.onMessage?.(message);
+        return message;
+    }, [getCurrentContext, config]);
+    // Send a message (user -> AI -> tool execution)
+    const sendMessage = (0, react_1.useCallback)(async (content) => {
+        if (!content.trim())
+            return;
+        // Add user message
+        addMessage(content, 'user');
+        setIsProcessing(true);
+        try {
+            // Build prompt with context
+            const _prompt = buildPromptWithContext(content);
+            // Simple fuzzy matching for demo purposes
+            // In production, this would call an LLM API
+            const lowerContent = content.toLowerCase();
+            let responseContent = "I understand. ";
+            let toolExecuted = false;
+            // Try to match and execute tools
+            for (const tool of availableTools) {
+                const toolName = tool.name || `${tool.componentName}.${tool.methodName}`;
+                const keywords = tool.examples?.join(' ').toLowerCase() || '';
+                // Simple keyword matching
+                if (keywords.includes(lowerContent) ||
+                    toolName.toLowerCase().includes(lowerContent.split(' ')[0])) {
+                    // Extract simple arguments (in production, LLM would do this)
+                    const args = extractSimpleArgs(content, tool);
+                    // Execute tool
+                    const result = await executeTool(tool.toolId || '', args);
+                    if (result.success) {
+                        responseContent += `Executed ${toolName}. `;
+                        toolExecuted = true;
+                    }
+                    else {
+                        responseContent += `Failed to execute ${toolName}: ${result.error}`;
+                    }
+                    break;
+                }
+            }
+            if (!toolExecuted) {
+                responseContent = `I couldn't find a matching tool. Available tools: ${availableTools.map(t => t.name || t.methodName).join(', ')}`;
+            }
+            // Add AI response
+            addMessage(responseContent, 'assistant');
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            config.onError?.(err);
+            addMessage(`Error: ${err.message}`, 'system');
+        }
+        finally {
+            setIsProcessing(false);
+        }
+    }, [addMessage, buildPromptWithContext, availableTools, executeTool, config]);
+    // Clear messages
+    const clearMessages = (0, react_1.useCallback)(() => {
+        setMessages([]);
+    }, []);
+    // Suggest tools based on query
+    const suggestTools = (0, react_1.useCallback)((query) => {
+        if (!query.trim())
+            return availableTools;
+        const lowerQuery = query.toLowerCase();
+        return availableTools.filter(tool => {
+            const toolName = (tool.name || tool.methodName).toLowerCase();
+            const description = tool.description?.toLowerCase() || '';
+            const examples = tool.examples?.join(' ').toLowerCase() || '';
+            return toolName.includes(lowerQuery) ||
+                description.includes(lowerQuery) ||
+                examples.includes(lowerQuery);
+        });
+    }, [availableTools]);
+    return {
+        // State
+        messages,
+        isProcessing,
+        availableTools,
+        currentContext: getCurrentContext(),
+        // Actions
+        sendMessage,
+        addMessage,
+        clearMessages,
+        executeTool,
+        // Helpers
+        buildPromptWithContext,
+        suggestTools
+    };
+}
+// Simple argument extraction (in production, LLM would handle this)
+function extractSimpleArgs(query, tool) {
+    const args = {};
+    const lowerQuery = query.toLowerCase();
+    // Extract numbers
+    const numMatch = query.match(/\d+/);
+    if (numMatch && tool.inputSchema) {
+        const numParam = Object.keys(tool.inputSchema).find(key => tool.inputSchema[key].type === 'number');
+        if (numParam) {
+            args[numParam] = parseInt(numMatch[0], 10);
+        }
+    }
+    // Extract common keywords
+    if (lowerQuery.includes('dark'))
+        args.theme = 'dark';
+    if (lowerQuery.includes('light'))
+        args.theme = 'light';
+    if (lowerQuery.includes('high'))
+        args.priority = 'high';
+    if (lowerQuery.includes('medium'))
+        args.priority = 'medium';
+    if (lowerQuery.includes('low'))
+        args.priority = 'low';
+    return args;
+}
+//# sourceMappingURL=useChatWithContext.js.map

package/dist/cjs/src/react/hooks/useChatWithContext.js.map

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

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

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * React Components - Open Source Edition
+ *
+ * Basic React hooks. Architecture visualization components (ArchitectureGraph,
+ * LiveArchitectureGraph, RuntimeGraphTracker) available in enterprise edition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChatWithContext = exports.useNavigationHandler = exports.usePersistedState = exports.useToolBinding = void 0;
+// Basic hooks (open source)
+var useToolBinding_1 = require("./useToolBinding");
+Object.defineProperty(exports, "useToolBinding", { enumerable: true, get: function () { return useToolBinding_1.useToolBinding; } });
+var usePersistedState_1 = require("./usePersistedState");
+Object.defineProperty(exports, "usePersistedState", { enumerable: true, get: function () { return usePersistedState_1.usePersistedState; } });
+var useNavigationHandler_1 = require("./useNavigationHandler");
+Object.defineProperty(exports, "useNavigationHandler", { enumerable: true, get: function () { return useNavigationHandler_1.useNavigationHandler; } });
+// Chat integration hook
+var useChatWithContext_1 = require("./hooks/useChatWithContext");
+Object.defineProperty(exports, "useChatWithContext", { enumerable: true, get: function () { return useChatWithContext_1.useChatWithContext; } });
+// Enterprise features - available at https://supernal.ai/enterprise:
+// - ArchitectureGraph (visual component tree)
+// - LiveArchitectureGraph (real-time visualization)
+// - RuntimeGraphTracker (execution tracking)
+// - GraphLayout (layout engine)
+// - TreeValidator (validation)
+// - StatePanel (state visualization)
+// - ContainerNode, ComponentNode, ToolNode (graph nodes)
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/react/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,4BAA4B;AAC5B,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAE7B,wBAAwB;AACxB,iEAAgE;AAAvD,wHAAA,kBAAkB,OAAA;AAQ3B,qEAAqE;AACrE,8CAA8C;AAC9C,oDAAoD;AACpD,6CAA6C;AAC7C,gCAAgC;AAChC,+BAA+B;AAC/B,qCAAqC;AACrC,yDAAyD"}