@supernal/interface 1.0.0

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

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Tools Types - Index File
+ *
+ * This is the main entry point for all tool-related types.
+ * It re-exports all tool types from their specialized modules.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionType = exports.ElementType = void 0;
+// Export tool types
+__exportStar(require("./Tool"), exports);
+__exportStar(require("./ToolPermissions"), exports);
+__exportStar(require("./ToolResult"), exports);
+__exportStar(require("./ExposureState"), exports);
+__exportStar(require("./NavigationGraph"), exports);
+__exportStar(require("./ClassifiedTool"), exports);
+__exportStar(require("./DiscoverableToolProvider"), exports);
+// Export state system types
+__exportStar(require("./StateManagers"), exports);
+__exportStar(require("./OperationType"), exports);
+__exportStar(require("./ComponentState"), exports);
+var ElementType;
+(function (ElementType) {
+    ElementType["BUTTON"] = "button";
+    ElementType["INPUT"] = "input";
+    ElementType["SELECT"] = "select";
+    ElementType["TEXTAREA"] = "textarea";
+    ElementType["LINK"] = "link";
+    ElementType["DIV"] = "div";
+})(ElementType || (exports.ElementType = ElementType = {}));
+var ActionType;
+(function (ActionType) {
+    ActionType["CLICK"] = "click";
+    ActionType["TYPE"] = "type";
+    ActionType["SELECT"] = "select";
+    ActionType["NAVIGATE"] = "navigate";
+    ActionType["HOVER"] = "hover";
+    ActionType["SCROLL"] = "scroll";
+})(ActionType || (exports.ActionType = ActionType = {}));
+/**
+ * Tools Types
+ *
+ * Export of all tool-related types, interfaces and constants
+ */
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;AAEH,oBAAoB;AACpB,yCAAuB;AACvB,oDAAkC;AAClC,+CAA6B;AAC7B,kDAAgC;AAChC,oDAAkC;AAClC,mDAAiC;AACjC,6DAA2C;AAE3C,4BAA4B;AAC5B,kDAAgC;AAChC,kDAAgC;AAChC,mDAAiC;AAajC,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,8BAAe,CAAA;IACf,gCAAiB,CAAA;IACjB,oCAAqB,CAAA;IACrB,4BAAa,CAAA;IACb,0BAAW,CAAA;AACb,CAAC,EAPW,WAAW,2BAAX,WAAW,QAOtB;AAED,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,6BAAe,CAAA;IACf,2BAAa,CAAA;IACb,+BAAiB,CAAA;IACjB,mCAAqB,CAAA;IACrB,6BAAe,CAAA;IACf,+BAAiB,CAAA;AACnB,CAAC,EAPW,UAAU,0BAAV,UAAU,QAOrB;AAED;;;;GAIG"}

package/dist/cjs/src/ui/react/chat/ChatBubble.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Persistent Chat Bubble Component
+ *
+ * Fixed position chat bubble in lower right corner that:
+ * - Appears on every page
+ * - Expands/collapses without blocking content
+ * - Provides AI interface for tool execution
+ */
+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.ChatBubble = void 0;
+const react_1 = __importStar(require("react"));
+const Components_1 = require("../../../../names/Components");
+// Chat component names (use the flat Components namespace)
+const ChatNames = {
+    bubble: Components_1.Components.ChatToggleButton,
+    input: Components_1.Components.ChatInput,
+    sendButton: Components_1.Components.ChatSendButton,
+    clearButton: Components_1.Components.ChatClearButton,
+};
+// Mock useChatInput for now - this should be injected via props or context
+const useChatInput = () => ({
+    registerInput: (callback) => { }
+});
+const CHAT_EXPANDED_KEY = 'supernal-chat-expanded';
+const ChatBubble = ({ messages, onSendMessage, onClearChat }) => {
+    // Initialize with default value (true) for both server and client to prevent hydration mismatch
+    const [isExpanded, setIsExpanded] = (0, react_1.useState)(true);
+    const [inputValue, setInputValue] = (0, react_1.useState)('');
+    const [lastReadMessageCount, setLastReadMessageCount] = (0, react_1.useState)(0);
+    const [showWelcome, setShowWelcome] = (0, react_1.useState)(messages.length === 0);
+    const messagesEndRef = (0, react_1.useRef)(null);
+    const inputRef = (0, react_1.useRef)(null);
+    // Load expanded state from localStorage after hydration
+    (0, react_1.useEffect)(() => {
+        try {
+            const stored = localStorage.getItem(CHAT_EXPANDED_KEY);
+            if (stored !== null) {
+                setIsExpanded(JSON.parse(stored));
+            }
+        }
+        catch {
+            // Keep default value
+        }
+    }, []);
+    // Register with chat input context
+    const { registerInput } = useChatInput();
+    (0, react_1.useEffect)(() => {
+        registerInput((text, submit = false) => {
+            setInputValue(text);
+            if (!isExpanded) {
+                setIsExpanded(true);
+            }
+            // Auto-focus and submit if requested
+            setTimeout(() => {
+                inputRef.current?.focus();
+                if (submit) {
+                    onSendMessage(text);
+                    setInputValue('');
+                }
+            }, 100);
+        });
+    }, [registerInput, onSendMessage, isExpanded]);
+    // Track unread messages
+    const unreadCount = Math.max(0, messages.length - lastReadMessageCount);
+    const hasUnread = unreadCount > 0 && !isExpanded;
+    (0, react_1.useEffect)(() => {
+        if (isExpanded) {
+            // Position at bottom without scrolling animation
+            messagesEndRef.current?.scrollIntoView({ behavior: 'auto' });
+            // Mark all messages as read when chat is expanded
+            setLastReadMessageCount(messages.length);
+            // Hide welcome if messages exist
+            if (messages.length > 0) {
+                setShowWelcome(false);
+            }
+            // Auto-focus input when expanded
+            inputRef.current?.focus();
+        }
+    }, [messages, isExpanded]);
+    // Auto-focus on mount
+    (0, react_1.useEffect)(() => {
+        if (isExpanded) {
+            inputRef.current?.focus();
+        }
+    }, [isExpanded]);
+    // Command+/ keyboard shortcut to focus input
+    (0, react_1.useEffect)(() => {
+        const handleKeyDown = (e) => {
+            if ((e.metaKey || e.ctrlKey) && e.key === '/') {
+                e.preventDefault();
+                if (!isExpanded) {
+                    setIsExpanded(true);
+                }
+                inputRef.current?.focus();
+            }
+        };
+        window.addEventListener('keydown', handleKeyDown);
+        return () => window.removeEventListener('keydown', handleKeyDown);
+    }, [isExpanded]);
+    const handleSend = (e) => {
+        e.preventDefault();
+        if (!inputValue.trim())
+            return;
+        onSendMessage(inputValue.trim());
+        setInputValue('');
+        // Re-focus input after sending
+        setTimeout(() => inputRef.current?.focus(), 0);
+    };
+    const handleToggle = () => {
+        const newExpandedState = !isExpanded;
+        setIsExpanded(newExpandedState);
+        // Persist the expanded state to localStorage
+        try {
+            localStorage.setItem(CHAT_EXPANDED_KEY, JSON.stringify(newExpandedState));
+        }
+        catch (error) {
+            console.error('Failed to save chat expanded state:', error);
+        }
+    };
+    return (react_1.default.createElement(react_1.default.Fragment, null,
+        react_1.default.createElement("div", { className: "fixed bottom-4 right-4 sm:bottom-6 sm:right-6 z-50" },
+            isExpanded && (react_1.default.createElement("div", { className: "absolute bottom-16 right-0 w-[calc(100vw-2rem)] sm:w-[500px] lg:w-[600px] h-[calc(100vh-10rem)] sm:h-[600px] lg:h-[700px] bg-white rounded-lg shadow-2xl border border-gray-200 flex flex-col" },
+                react_1.default.createElement("div", { className: "flex items-center justify-between p-3 sm:p-4 border-b border-gray-200 bg-gradient-to-r from-blue-50 to-purple-50 rounded-t-lg" },
+                    react_1.default.createElement("div", { className: "flex items-center space-x-2 sm:space-x-3" },
+                        react_1.default.createElement("div", { className: "relative" },
+                            react_1.default.createElement("div", { className: "w-8 h-8 sm:w-10 sm:h-10 bg-gradient-to-br from-blue-500 to-purple-600 rounded-full flex items-center justify-center" },
+                                react_1.default.createElement("span", { className: "text-white text-base sm:text-lg" }, "\uD83E\uDD16")),
+                            react_1.default.createElement("div", { className: "absolute -bottom-1 -right-1 w-3 h-3 sm:w-4 sm:h-4 bg-green-500 rounded-full border-2 border-white" })),
+                        react_1.default.createElement("div", null,
+                            react_1.default.createElement("h3", { className: "font-bold text-gray-900 text-sm sm:text-base" }, "Supernal AI Interface"),
+                            react_1.default.createElement("p", { className: "text-xs text-gray-600 hidden sm:block" }, "I'm a TOOL system AI can use to control this site"))),
+                    react_1.default.createElement("div", { className: "flex items-center space-x-1" },
+                        onClearChat && (react_1.default.createElement("button", { onClick: onClearChat, className: "p-1 text-gray-400 hover:text-gray-600 transition-colors", title: "Clear chat", "data-testid": ChatNames.clearButton },
+                            react_1.default.createElement("svg", { className: "w-4 h-4", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24" },
+                                react_1.default.createElement("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16" })))),
+                        react_1.default.createElement("button", { onClick: handleToggle, className: "p-1 text-gray-400 hover:text-gray-600 transition-colors", title: "Minimize chat" },
+                            react_1.default.createElement("svg", { className: "w-4 h-4", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24" },
+                                react_1.default.createElement("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M19 9l-7 7-7-7" }))))),
+                react_1.default.createElement("div", { className: "flex-1 overflow-y-auto p-3 sm:p-4 space-y-3" },
+                    showWelcome && messages.length === 0 && (react_1.default.createElement("div", { className: "bg-gradient-to-br from-blue-50 to-purple-50 p-3 sm:p-4 rounded-lg border border-blue-200 mb-4" },
+                        react_1.default.createElement("h4", { className: "font-bold text-gray-900 mb-2 text-xs sm:text-sm" }, "\uD83D\uDC4B Welcome! I'm NOT an AI"),
+                        react_1.default.createElement("p", { className: "text-xs text-gray-700 mb-3" },
+                            "I'm a ",
+                            react_1.default.createElement("strong", null, "tool system"),
+                            " that AI assistants (like Claude, GPT) can use to navigate and control this site. This enables ",
+                            react_1.default.createElement("strong", null, "agentic UX"),
+                            " \u2014 instead of clicking around, you tell an AI what you want, and it uses me to do it."),
+                        react_1.default.createElement("div", { className: "bg-white p-2 sm:p-3 rounded border border-gray-200 mb-3" },
+                            react_1.default.createElement("p", { className: "text-xs font-medium text-gray-900 mb-2" }, "Try these commands:"),
+                            react_1.default.createElement("div", { className: "space-y-1" }, [
+                                { text: 'open the docs', desc: 'Navigate to documentation' },
+                                { text: 'show me the story system', desc: 'View story system guide' },
+                                { text: 'go to examples', desc: 'Browse code examples' },
+                            ].map((cmd, idx) => (react_1.default.createElement("button", { key: idx, onClick: () => {
+                                    setInputValue(cmd.text);
+                                    setShowWelcome(false);
+                                    setTimeout(() => inputRef.current?.focus(), 0);
+                                }, className: "w-full text-left px-2 py-1.5 rounded hover:bg-blue-50 transition-colors group" },
+                                react_1.default.createElement("div", { className: "text-xs font-mono text-blue-700 group-hover:text-blue-900" },
+                                    "\"",
+                                    cmd.text,
+                                    "\""),
+                                react_1.default.createElement("div", { className: "text-xs text-gray-500 hidden sm:block" }, cmd.desc)))))),
+                        react_1.default.createElement("p", { className: "text-xs text-gray-600 italic" }, "Type a command or click a suggestion above to start"))),
+                    messages.map((message) => (react_1.default.createElement("div", { key: message.id, className: "flex flex-col" },
+                        react_1.default.createElement("div", { className: `inline-block px-3 py-2 rounded-lg max-w-[85%] sm:max-w-xs text-xs sm:text-sm ${message.type === 'user'
+                                ? 'bg-blue-600 text-white ml-auto'
+                                : message.type === 'ai'
+                                    ? 'bg-gray-200 text-gray-800'
+                                    : 'bg-yellow-100 text-yellow-800 text-xs'}`, "data-testid": `chat-message-${message.type}` }, message.text),
+                        react_1.default.createElement("div", { className: "text-xs text-gray-400 mt-1 px-1" }, typeof window !== 'undefined' ? new Date(message.timestamp).toLocaleTimeString() : '')))),
+                    react_1.default.createElement("div", { ref: messagesEndRef })),
+                react_1.default.createElement("form", { onSubmit: handleSend, className: "p-3 sm:p-4 border-t border-gray-200" },
+                    react_1.default.createElement("div", { className: "flex space-x-2" },
+                        react_1.default.createElement("input", { ref: inputRef, type: "text", value: inputValue, onChange: (e) => setInputValue(e.target.value), placeholder: "Try: toggle notifications", className: "flex-1 px-3 py-2 text-xs sm:text-sm border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-transparent text-gray-800", "data-testid": ChatNames.input }),
+                        react_1.default.createElement("button", { type: "submit", disabled: !inputValue.trim(), className: "px-3 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 disabled:bg-gray-300 disabled:cursor-not-allowed transition-colors text-xs sm:text-sm font-medium", "data-testid": ChatNames.sendButton }, "Execute")),
+                    react_1.default.createElement("div", { className: "mt-2 text-xs text-gray-500 hidden sm:block" },
+                        react_1.default.createElement("strong", null, "Demo:"),
+                        " Commands execute @Tool methods and update widgets above")))),
+            react_1.default.createElement("button", { onClick: handleToggle, className: "absolute bottom-0 right-0 w-12 h-12 sm:w-14 sm:h-14 bg-blue-600 hover:bg-blue-700 text-white rounded-full shadow-lg transition-all duration-200 flex items-center justify-center", "data-testid": ChatNames.bubble, title: isExpanded ? 'Minimize chat' : 'Open AI chat' }, isExpanded ? (react_1.default.createElement("svg", { className: "w-5 h-5 sm:w-6 sm:h-6", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24" },
+                react_1.default.createElement("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M19 9l-7 7-7-7" }))) : (react_1.default.createElement("svg", { className: "w-5 h-5 sm:w-6 sm:h-6", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24" },
+                react_1.default.createElement("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z" })))),
+            hasUnread && (react_1.default.createElement("div", { className: "absolute -top-1 -right-1 w-4 h-4 sm:w-5 sm:h-5 bg-red-500 rounded-full flex items-center justify-center animate-pulse", "data-testid": "unread-indicator" },
+                react_1.default.createElement("span", { className: "text-xs text-white font-bold" }, unreadCount > 9 ? '9+' : unreadCount))))));
+};
+exports.ChatBubble = ChatBubble;
+//# sourceMappingURL=ChatBubble.js.map

package/dist/cjs/src/ui/react/chat/ChatBubble.js.map

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

package/dist/esm/names/API.d.ts

@@ -0,0 +1,77 @@
+/**
+ * API Endpoint Names - Hierarchical ID Contracts
+ *
+ * This file defines stable, hierarchical ID constants for API endpoints.
+ * Services import these IDs before tools are generated, establishing
+ * a contract between the API layer and the tool system.
+ *
+ * Pattern: API.Resource.Action
+ */
+export declare const API: {
+    /**
+     * User Management Endpoints
+     */
+    readonly Users: {
+        readonly list: "api-users-list";
+        readonly get: "api-users-get";
+        readonly create: "api-users-create";
+        readonly update: "api-users-update";
+        readonly delete: "api-users-delete";
+        readonly search: "api-users-search";
+    };
+    /**
+     * Authentication Endpoints
+     */
+    readonly Auth: {
+        readonly login: "api-auth-login";
+        readonly logout: "api-auth-logout";
+        readonly register: "api-auth-register";
+        readonly refreshToken: "api-auth-refresh-token";
+        readonly verifyEmail: "api-auth-verify-email";
+        readonly resetPassword: "api-auth-reset-password";
+    };
+    /**
+     * Data Management Endpoints
+     */
+    readonly Data: {
+        readonly fetch: "api-data-fetch";
+        readonly save: "api-data-save";
+        readonly sync: "api-data-sync";
+        readonly export: "api-data-export";
+        readonly import: "api-data-import";
+    };
+    /**
+     * Settings Endpoints
+     */
+    readonly Settings: {
+        readonly get: "api-settings-get";
+        readonly update: "api-settings-update";
+        readonly reset: "api-settings-reset";
+    };
+    /**
+     * Notification Endpoints
+     */
+    readonly Notifications: {
+        readonly list: "api-notifications-list";
+        readonly markRead: "api-notifications-mark-read";
+        readonly markAllRead: "api-notifications-mark-all-read";
+        readonly delete: "api-notifications-delete";
+    };
+};
+/**
+ * Helper function to get all API IDs as a flat array
+ */
+export declare function getAllAPIIds(): string[];
+/**
+ * Helper function to validate API ID uniqueness
+ */
+export declare function validateAPIIds(): {
+    valid: boolean;
+    duplicates: string[];
+};
+/**
+ * Type-safe API ID access
+ */
+export type APIPath = typeof API;
+export type APIId = ReturnType<typeof getAllAPIIds>[number];
+//# sourceMappingURL=API.d.ts.map

package/dist/esm/names/API.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"API.d.ts","sourceRoot":"","sources":["../../../names/API.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,GAAG;IACd;;OAEG;;;;;;;;;IAUH;;OAEG;;;;;;;;;IAUH;;OAEG;;;;;;;;IASH;;OAEG;;;;;;IAOH;;OAEG;;;;;;;CAOK,CAAC;AAEX;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAevC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBzE;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC;AACjC,MAAM,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/esm/names/API.js

@@ -0,0 +1,99 @@
+/**
+ * API Endpoint Names - Hierarchical ID Contracts
+ *
+ * This file defines stable, hierarchical ID constants for API endpoints.
+ * Services import these IDs before tools are generated, establishing
+ * a contract between the API layer and the tool system.
+ *
+ * Pattern: API.Resource.Action
+ */
+export const API = {
+    /**
+     * User Management Endpoints
+     */
+    Users: {
+        list: 'api-users-list',
+        get: 'api-users-get',
+        create: 'api-users-create',
+        update: 'api-users-update',
+        delete: 'api-users-delete',
+        search: 'api-users-search',
+    },
+    /**
+     * Authentication Endpoints
+     */
+    Auth: {
+        login: 'api-auth-login',
+        logout: 'api-auth-logout',
+        register: 'api-auth-register',
+        refreshToken: 'api-auth-refresh-token',
+        verifyEmail: 'api-auth-verify-email',
+        resetPassword: 'api-auth-reset-password',
+    },
+    /**
+     * Data Management Endpoints
+     */
+    Data: {
+        fetch: 'api-data-fetch',
+        save: 'api-data-save',
+        sync: 'api-data-sync',
+        export: 'api-data-export',
+        import: 'api-data-import',
+    },
+    /**
+     * Settings Endpoints
+     */
+    Settings: {
+        get: 'api-settings-get',
+        update: 'api-settings-update',
+        reset: 'api-settings-reset',
+    },
+    /**
+     * Notification Endpoints
+     */
+    Notifications: {
+        list: 'api-notifications-list',
+        markRead: 'api-notifications-mark-read',
+        markAllRead: 'api-notifications-mark-all-read',
+        delete: 'api-notifications-delete',
+    },
+};
+/**
+ * Helper function to get all API IDs as a flat array
+ */
+export function getAllAPIIds() {
+    const ids = [];
+    function collectIds(obj) {
+        for (const key in obj) {
+            if (typeof obj[key] === 'string') {
+                ids.push(obj[key]);
+            }
+            else if (typeof obj[key] === 'object') {
+                collectIds(obj[key]);
+            }
+        }
+    }
+    collectIds(API);
+    return ids;
+}
+/**
+ * Helper function to validate API ID uniqueness
+ */
+export function validateAPIIds() {
+    const ids = getAllAPIIds();
+    const seen = new Set();
+    const duplicates = [];
+    for (const id of ids) {
+        if (seen.has(id)) {
+            duplicates.push(id);
+        }
+        else {
+            seen.add(id);
+        }
+    }
+    return {
+        valid: duplicates.length === 0,
+        duplicates,
+    };
+}
+//# sourceMappingURL=API.js.map

package/dist/esm/names/API.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"API.js","sourceRoot":"","sources":["../../../names/API.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB;;OAEG;IACH,KAAK,EAAE;QACL,IAAI,EAAE,gBAAgB;QACtB,GAAG,EAAE,eAAe;QACpB,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,kBAAkB;KAC3B;IAED;;OAEG;IACH,IAAI,EAAE;QACJ,KAAK,EAAE,gBAAgB;QACvB,MAAM,EAAE,iBAAiB;QACzB,QAAQ,EAAE,mBAAmB;QAC7B,YAAY,EAAE,wBAAwB;QACtC,WAAW,EAAE,uBAAuB;QACpC,aAAa,EAAE,yBAAyB;KACzC;IAED;;OAEG;IACH,IAAI,EAAE;QACJ,KAAK,EAAE,gBAAgB;QACvB,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,iBAAiB;KAC1B;IAED;;OAEG;IACH,QAAQ,EAAE;QACR,GAAG,EAAE,kBAAkB;QACvB,MAAM,EAAE,qBAAqB;QAC7B,KAAK,EAAE,oBAAoB;KAC5B;IAED;;OAEG;IACH,aAAa,EAAE;QACb,IAAI,EAAE,wBAAwB;QAC9B,QAAQ,EAAE,6BAA6B;QACvC,WAAW,EAAE,iCAAiC;QAC9C,MAAM,EAAE,0BAA0B;KACnC;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAa,EAAE,CAAC;IAEzB,SAAS,UAAU,CAAC,GAAQ;QAC1B,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,IAAI,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACjC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACrB,CAAC;iBAAM,IAAI,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACxC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACjB,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;QAC9B,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/esm/names/Components.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Component Names - Atomic UI Element IDs
+ *
+ * Components are individual UI elements (buttons, inputs, etc.) that tools interact with.
+ * These are flat, reusable identifiers that can appear in multiple containers.
+ *
+ * Containers define WHICH components they contain (see Containers.ts).
+ * ToolProviders operate within a Container namespace and act on Components.
+ *
+ * Pattern: Components.ElementName = 'element-id'
+ */
+export declare const Components: {
+    readonly ChatInput: "chat-message-input";
+    readonly ChatSendButton: "chat-send-button";
+    readonly ChatClearButton: "chat-clear-button";
+    readonly ChatToggleButton: "chat-bubble-toggle";
+    readonly ChatMessageList: "chat-message-list";
+    readonly ChatTypingIndicator: "chat-typing-indicator";
+    readonly OpenMenuButton: "open-main-menu";
+    readonly CloseMenuButton: "close-main-menu";
+    readonly FeatureToggle: "feature-toggle";
+    readonly NotificationsToggle: "notification-toggle";
+    readonly PriorityHighRadio: "priority-high";
+    readonly PriorityMediumRadio: "priority-medium";
+    readonly PriorityLowRadio: "priority-low";
+    readonly StatusSelect: "status-dropdown";
+    readonly ThemeSelect: "theme-toggle";
+    readonly FormNameInput: "form-name";
+    readonly DemoFormSubmitButton: "form-submit";
+    readonly WidgetButton: "widget-button";
+    readonly WidgetInput: "widget-input";
+    readonly WidgetSelect: "widget-select";
+    readonly WidgetCheckbox: "widget-checkbox";
+    readonly WidgetRadio: "widget-radio";
+    readonly WidgetTextarea: "widget-textarea";
+    readonly ToolCommandsList: "tool-commands-list";
+    readonly ToolExecuteButton: "tool-execute-button";
+    readonly ToolApprovalButton: "tool-approval-button";
+    readonly ToolMetadataDisplay: "tool-metadata-display";
+    readonly NavMainMenu: "nav-main-menu";
+    readonly NavHomeLink: "nav-home-link";
+    readonly NavToolsLink: "nav-tools-link";
+    readonly NavSettingsLink: "nav-settings-link";
+    readonly NavBackButton: "nav-back-button";
+    readonly FormSubmitButton: "form-submit-button";
+    readonly FormCancelButton: "form-cancel-button";
+    readonly FormResetButton: "form-reset-button";
+    readonly FormTextInput: "form-text-input";
+    readonly FormEmailInput: "form-email-input";
+    readonly FormPasswordInput: "form-password-input";
+    readonly ModalCloseButton: "modal-close-button";
+    readonly ModalConfirmButton: "modal-confirm-button";
+    readonly ModalCancelButton: "modal-cancel-button";
+    readonly ModalOverlay: "modal-overlay";
+    readonly StatusSuccessMessage: "status-success-message";
+    readonly StatusErrorMessage: "status-error-message";
+    readonly StatusWarningMessage: "status-warning-message";
+    readonly StatusLoadingSpinner: "status-loading-spinner";
+    readonly StatusProgressBar: "status-progress-bar";
+};
+/**
+ * Helper function to get all component IDs as a flat array
+ */
+export declare function getAllComponentIds(): string[];
+/**
+ * Helper function to validate component ID uniqueness
+ */
+export declare function validateComponentIds(): {
+    valid: boolean;
+    duplicates: string[];
+};
+/**
+ * Type-safe component ID access
+ */
+export type ComponentPath = typeof Components;
+export type ComponentId = (typeof Components)[keyof typeof Components];
+//# sourceMappingURL=Components.d.ts.map

package/dist/esm/names/Components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Components.d.ts","sourceRoot":"","sources":["../../../names/Components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEb,CAAC;AAEX;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAiB/E;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,UAAU,CAAC;AAC9C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC"}