@supernal/interface 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Supernal AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,165 @@
+# @supernal/interface
+
+**Universal AI Interface** - Make any application AI-controllable with decorators.
+
+Open source core framework for creating AI-friendly applications. Decorate your functions with `@Tool` and automatically expose them to AI assistants with full type safety.
+
+## Features
+
+### ✅ Core Framework (Open Source)
+
+- **Decorator System** - `@Tool`, `@ToolProvider`, `@Component` decorators
+- **Tool Registry** - Automatic tool discovery and registration  
+- **Adapter System** - Swap chat UI providers (CopilotKit, native, custom)
+- **Storage** - LocalStorage, Chrome extension, memory adapters
+- **Testing Utilities** - Playwright helpers, Gherkin parsing, test runners
+- **Type Safety** - Full TypeScript support with inference
+- **React Hooks** - `useToolBinding`, `usePersistedState`, `useChatWithContext`
+
+### 🚀 Enterprise Features
+
+Advanced capabilities available at [https://supernal.ai/enterprise](https://supernal.ai/enterprise):
+
+- **Test Generation** - Auto-generate tests from decorators
+- **Story System** - 50-80% performance boost via test composition
+- **Architecture Visualization** - Real-time component trees
+- **Advanced AI** - Multi-model routing, parameter extraction
+- **File Storage** - Node.js filesystem adapters
+- **Audit & Compliance** - Enterprise logging and tracking
+
+## Installation
+
+```bash
+npm install @supernal/interface
+```
+
+## Quick Start
+
+### 1. Decorate Your Functions
+
+```typescript
+import { Tool } from '@supernal/interface';
+
+class TodoList {
+  @Tool({
+    name: 'add_todo',
+    description: 'Add a new todo item',
+    category: 'productivity'
+  })
+  async addTodo(text: string) {
+    // Your implementation
+  }
+}
+```
+
+### 2. Choose an Adapter
+
+```typescript
+import { CopilotKitAdapter, ChatUIProvider } from '@supernal/interface';
+
+const adapter = createCopilotKitAdapter({
+  autoRegisterTools: true
+});
+
+function App() {
+  return (
+    <ChatUIProvider adapter={adapter}>
+      <YourApp />
+    </ChatUIProvider>
+  );
+}
+```
+
+### 3. AI Can Now Call Your Functions
+
+That's it! Your decorated functions are now accessible to AI assistants with full type checking.
+
+## Adapters
+
+### CopilotKit
+
+```typescript
+import { createCopilotKitAdapter } from '@supernal/interface';
+
+const adapter = createCopilotKitAdapter({
+  autoRegisterTools: true,
+  autoRegisterReadables: true
+});
+```
+
+### Custom Adapter
+
+```typescript
+import { ChatUIAdapter } from '@supernal/interface';
+
+class MyCustomAdapter implements ChatUIAdapter {
+  name = 'my-adapter';
+  
+  registerTools(tools) {
+    // Convert to your format
+  }
+  
+  render(props) {
+    return <MyChat {...props} />;
+  }
+}
+```
+
+## Testing
+
+```typescript
+import { GherkinParser, TestRunner } from '@supernal/interface/testing';
+
+// Parse Gherkin features
+const feature = GherkinParser.parseFeature(featureText);
+
+// Generate tests
+const tests = await TestRunner.generateTests({
+  includeGherkin: true,
+  framework: 'jest'
+});
+```
+
+## Storage
+
+```typescript
+import { StateManager, LocalStorageAdapter } from '@supernal/interface/storage';
+
+const storage = StateManager.getInstance('myapp', new LocalStorageAdapter());
+
+await storage.setState('user', { name: 'Alice' });
+const user = await storage.getState('user');
+```
+
+## Documentation
+
+- [Full Documentation](https://supernal.ai/docs)
+- [API Reference](https://supernal.ai/docs/api)
+- [Examples](https://github.com/supernalintelligence/supernal-interface/tree/main/examples)
+
+## Community
+
+- [Discord](https://discord.gg/supernal-ai)
+- [GitHub Discussions](https://github.com/supernalintelligence/supernal-interface/discussions)
+- [Twitter](https://twitter.com/supernal_ai)
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](https://github.com/supernalintelligence/supernal-interface/blob/main/CONTRIBUTING.md).
+
+## License
+
+MIT © 2025 Supernal AI
+
+See [LICENSE](LICENSE) for details.
+
+## Enterprise Edition
+
+Need advanced features like test generation, architecture visualization, or enterprise support?
+
+Visit [https://supernal.ai/enterprise](https://supernal.ai/enterprise)
+
+---
+
+**Open source core • Enterprise features available • Built with TypeScript**
+

package/dist/cjs/names/API.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.API = void 0;
+exports.getAllAPIIds = getAllAPIIds;
+exports.validateAPIIds = validateAPIIds;
+exports.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
+ */
+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(exports.API);
+    return ids;
+}
+/**
+ * Helper function to validate API ID uniqueness
+ */
+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/cjs/names/API.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"API.js","sourceRoot":"","sources":["../../../names/API.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA6DH,oCAeC;AAKD,wCAiBC;AAhGY,QAAA,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,SAAgB,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,WAAG,CAAC,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAgB,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/cjs/names/Components.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * 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'
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Components = void 0;
+exports.getAllComponentIds = getAllComponentIds;
+exports.validateComponentIds = validateComponentIds;
+exports.Components = {
+    // Chat components
+    ChatInput: 'chat-message-input',
+    ChatSendButton: 'chat-send-button',
+    ChatClearButton: 'chat-clear-button',
+    ChatToggleButton: 'chat-bubble-toggle',
+    ChatMessageList: 'chat-message-list',
+    ChatTypingIndicator: 'chat-typing-indicator',
+    // Demo widget components - buttons
+    OpenMenuButton: 'open-main-menu',
+    CloseMenuButton: 'close-main-menu',
+    // Demo widget components - checkboxes
+    FeatureToggle: 'feature-toggle',
+    NotificationsToggle: 'notification-toggle',
+    // Demo widget components - radios
+    PriorityHighRadio: 'priority-high',
+    PriorityMediumRadio: 'priority-medium',
+    PriorityLowRadio: 'priority-low',
+    // Demo widget components - selects
+    StatusSelect: 'status-dropdown',
+    ThemeSelect: 'theme-toggle',
+    // Demo widget components - form
+    FormNameInput: 'form-name',
+    DemoFormSubmitButton: 'form-submit',
+    // Generic widget components
+    WidgetButton: 'widget-button',
+    WidgetInput: 'widget-input',
+    WidgetSelect: 'widget-select',
+    WidgetCheckbox: 'widget-checkbox',
+    WidgetRadio: 'widget-radio',
+    WidgetTextarea: 'widget-textarea',
+    // Tool command components
+    ToolCommandsList: 'tool-commands-list',
+    ToolExecuteButton: 'tool-execute-button',
+    ToolApprovalButton: 'tool-approval-button',
+    ToolMetadataDisplay: 'tool-metadata-display',
+    // Navigation components
+    NavMainMenu: 'nav-main-menu',
+    NavHomeLink: 'nav-home-link',
+    NavToolsLink: 'nav-tools-link',
+    NavSettingsLink: 'nav-settings-link',
+    NavBackButton: 'nav-back-button',
+    // Form components
+    FormSubmitButton: 'form-submit-button',
+    FormCancelButton: 'form-cancel-button',
+    FormResetButton: 'form-reset-button',
+    FormTextInput: 'form-text-input',
+    FormEmailInput: 'form-email-input',
+    FormPasswordInput: 'form-password-input',
+    // Modal components
+    ModalCloseButton: 'modal-close-button',
+    ModalConfirmButton: 'modal-confirm-button',
+    ModalCancelButton: 'modal-cancel-button',
+    ModalOverlay: 'modal-overlay',
+    // Status/Feedback components
+    StatusSuccessMessage: 'status-success-message',
+    StatusErrorMessage: 'status-error-message',
+    StatusWarningMessage: 'status-warning-message',
+    StatusLoadingSpinner: 'status-loading-spinner',
+    StatusProgressBar: 'status-progress-bar',
+};
+/**
+ * Helper function to get all component IDs as a flat array
+ */
+function getAllComponentIds() {
+    return Object.values(exports.Components);
+}
+/**
+ * Helper function to validate component ID uniqueness
+ */
+function validateComponentIds() {
+    const ids = getAllComponentIds();
+    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=Components.js.map

package/dist/cjs/names/Components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Components.js","sourceRoot":"","sources":["../../../names/Components.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AA8EH,gDAEC;AAKD,oDAiBC;AApGY,QAAA,UAAU,GAAG;IACxB,kBAAkB;IAClB,SAAS,EAAE,oBAAoB;IAC/B,cAAc,EAAE,kBAAkB;IAClC,eAAe,EAAE,mBAAmB;IACpC,gBAAgB,EAAE,oBAAoB;IACtC,eAAe,EAAE,mBAAmB;IACpC,mBAAmB,EAAE,uBAAuB;IAE5C,mCAAmC;IACnC,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAElC,sCAAsC;IACtC,aAAa,EAAE,gBAAgB;IAC/B,mBAAmB,EAAE,qBAAqB;IAE1C,kCAAkC;IAClC,iBAAiB,EAAE,eAAe;IAClC,mBAAmB,EAAE,iBAAiB;IACtC,gBAAgB,EAAE,cAAc;IAEhC,mCAAmC;IACnC,YAAY,EAAE,iBAAiB;IAC/B,WAAW,EAAE,cAAc;IAE3B,gCAAgC;IAChC,aAAa,EAAE,WAAW;IAC1B,oBAAoB,EAAE,aAAa;IAEnC,4BAA4B;IAC5B,YAAY,EAAE,eAAe;IAC7B,WAAW,EAAE,cAAc;IAC3B,YAAY,EAAE,eAAe;IAC7B,cAAc,EAAE,iBAAiB;IACjC,WAAW,EAAE,cAAc;IAC3B,cAAc,EAAE,iBAAiB;IAEjC,0BAA0B;IAC1B,gBAAgB,EAAE,oBAAoB;IACtC,iBAAiB,EAAE,qBAAqB;IACxC,kBAAkB,EAAE,sBAAsB;IAC1C,mBAAmB,EAAE,uBAAuB;IAE5C,wBAAwB;IACxB,WAAW,EAAE,eAAe;IAC5B,WAAW,EAAE,eAAe;IAC5B,YAAY,EAAE,gBAAgB;IAC9B,eAAe,EAAE,mBAAmB;IACpC,aAAa,EAAE,iBAAiB;IAEhC,kBAAkB;IAClB,gBAAgB,EAAE,oBAAoB;IACtC,gBAAgB,EAAE,oBAAoB;IACtC,eAAe,EAAE,mBAAmB;IACpC,aAAa,EAAE,iBAAiB;IAChC,cAAc,EAAE,kBAAkB;IAClC,iBAAiB,EAAE,qBAAqB;IAExC,mBAAmB;IACnB,gBAAgB,EAAE,oBAAoB;IACtC,kBAAkB,EAAE,sBAAsB;IAC1C,iBAAiB,EAAE,qBAAqB;IACxC,YAAY,EAAE,eAAe;IAE7B,6BAA6B;IAC7B,oBAAoB,EAAE,wBAAwB;IAC9C,kBAAkB,EAAE,sBAAsB;IAC1C,oBAAoB,EAAE,wBAAwB;IAC9C,oBAAoB,EAAE,wBAAwB;IAC9C,iBAAiB,EAAE,qBAAqB;CAChC,CAAC;AAEX;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,kBAAU,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB;IAClC,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;IACjC,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/cjs/names/Containers.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Container Names - Context Boundary IDs
+ *
+ * Containers define the namespace/scope where ToolProviders operate.
+ * Each ToolProvider is bound to a container, which represents a modal, page, or section.
+ *
+ * Hierarchy: ToolProvider → Container (namespace) → Tools → Components
+ *
+ * Pattern: Containers.ContainerName = 'container-id'
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Containers = void 0;
+exports.getAllContainerIds = getAllContainerIds;
+exports.validateContainerIds = validateContainerIds;
+exports.Containers = {
+    /**
+     * Chat container/modal
+     * Used by: ChatTools provider
+     */
+    Chat: 'chat-container',
+    /**
+     * Widget gallery container
+     * Used by: WidgetTools provider
+     */
+    Widgets: 'widgets-container',
+    /**
+     * Tool commands container
+     * Used by: ToolCommandTools provider
+     */
+    ToolCommands: 'tool-commands-container',
+    /**
+     * Main modal container
+     * Used by: ModalTools provider
+     */
+    Modal: 'modal-container',
+    /**
+     * Sidebar container
+     * Used by: SidebarTools provider
+     */
+    Sidebar: 'sidebar-container',
+    /**
+     * Main application container
+     * Used by: AppTools provider
+     */
+    App: 'app-container',
+    /**
+     * Settings container
+     * Used by: SettingsTools provider
+     */
+    Settings: 'settings-container',
+    /**
+     * Dashboard container
+     * Used by: DashboardTools provider
+     */
+    Dashboard: 'dashboard-container',
+    /**
+     * Workspace container
+     * Used by: WorkspaceTools provider
+     */
+    Workspace: 'workspace-container',
+    /**
+     * Home/Landing page container
+     * Used by: HomePageTools provider
+     */
+    HomePage: 'homepage-container',
+    /**
+     * Stories page container
+     * Used by: Story execution and visualization
+     */
+    StoriesPage: 'stories-page-container',
+};
+/**
+ * Helper to get all container IDs
+ */
+function getAllContainerIds() {
+    return Object.values(exports.Containers);
+}
+/**
+ * Helper to validate container ID uniqueness
+ */
+function validateContainerIds() {
+    const ids = getAllContainerIds();
+    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=Containers.js.map

package/dist/cjs/names/Containers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Containers.js","sourceRoot":"","sources":["../../../names/Containers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAyEH,gDAEC;AAKD,oDAiBC;AA/FY,QAAA,UAAU,GAAG;IACxB;;;OAGG;IACH,IAAI,EAAE,gBAAgB;IAEtB;;;OAGG;IACH,OAAO,EAAE,mBAAmB;IAE5B;;;OAGG;IACH,YAAY,EAAE,yBAAyB;IAEvC;;;OAGG;IACH,KAAK,EAAE,iBAAiB;IAExB;;;OAGG;IACH,OAAO,EAAE,mBAAmB;IAE5B;;;OAGG;IACH,GAAG,EAAE,eAAe;IAEpB;;;OAGG;IACH,QAAQ,EAAE,oBAAoB;IAE9B;;;OAGG;IACH,SAAS,EAAE,qBAAqB;IAEhC;;;OAGG;IACH,SAAS,EAAE,qBAAqB;IAEhC;;;OAGG;IACH,QAAQ,EAAE,oBAAoB;IAE9B;;;OAGG;IACH,WAAW,EAAE,wBAAwB;CAC7B,CAAC;AAEX;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,kBAAU,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB;IAClC,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;IACjC,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/cjs/names/Functions.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Function Names - Hierarchical ID Contracts
+ *
+ * This file defines stable, hierarchical ID constants for pure functions.
+ * Utilities import these IDs before tools are generated, establishing
+ * a contract between computational functions and the tool system.
+ *
+ * Pattern: Functions.Category.Operation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Functions = void 0;
+exports.getAllFunctionIds = getAllFunctionIds;
+exports.validateFunctionIds = validateFunctionIds;
+exports.Functions = {
+    /**
+     * Mathematical Operations
+     */
+    Math: {
+        add: 'func-math-add',
+        subtract: 'func-math-subtract',
+        multiply: 'func-math-multiply',
+        divide: 'func-math-divide',
+        calculate: 'func-math-calculate',
+    },
+    /**
+     * String Operations
+     */
+    String: {
+        format: 'func-string-format',
+        capitalize: 'func-string-capitalize',
+        truncate: 'func-string-truncate',
+        slugify: 'func-string-slugify',
+        sanitize: 'func-string-sanitize',
+    },
+    /**
+     * Array Operations
+     */
+    Array: {
+        filter: 'func-array-filter',
+        map: 'func-array-map',
+        reduce: 'func-array-reduce',
+        sort: 'func-array-sort',
+        deduplicate: 'func-array-deduplicate',
+    },
+    /**
+     * Date Operations
+     */
+    Date: {
+        format: 'func-date-format',
+        parse: 'func-date-parse',
+        diff: 'func-date-diff',
+        add: 'func-date-add',
+        isValid: 'func-date-is-valid',
+    },
+    /**
+     * Validation Operations
+     */
+    Validation: {
+        email: 'func-validation-email',
+        url: 'func-validation-url',
+        phone: 'func-validation-phone',
+        zipCode: 'func-validation-zip-code',
+        creditCard: 'func-validation-credit-card',
+    },
+    /**
+     * Transformation Operations
+     */
+    Transform: {
+        camelToSnake: 'func-transform-camel-to-snake',
+        snakeToCamel: 'func-transform-snake-to-camel',
+        jsonToCsv: 'func-transform-json-to-csv',
+        csvToJson: 'func-transform-csv-to-json',
+    },
+};
+/**
+ * Helper function to get all function IDs as a flat array
+ */
+function getAllFunctionIds() {
+    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(exports.Functions);
+    return ids;
+}
+/**
+ * Helper function to validate function ID uniqueness
+ */
+function validateFunctionIds() {
+    const ids = getAllFunctionIds();
+    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=Functions.js.map

package/dist/cjs/names/Functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Functions.js","sourceRoot":"","sources":["../../../names/Functions.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAwEH,8CAeC;AAKD,kDAiBC;AA3GY,QAAA,SAAS,GAAG;IACvB;;OAEG;IACH,IAAI,EAAE;QACJ,GAAG,EAAE,eAAe;QACpB,QAAQ,EAAE,oBAAoB;QAC9B,QAAQ,EAAE,oBAAoB;QAC9B,MAAM,EAAE,kBAAkB;QAC1B,SAAS,EAAE,qBAAqB;KACjC;IAED;;OAEG;IACH,MAAM,EAAE;QACN,MAAM,EAAE,oBAAoB;QAC5B,UAAU,EAAE,wBAAwB;QACpC,QAAQ,EAAE,sBAAsB;QAChC,OAAO,EAAE,qBAAqB;QAC9B,QAAQ,EAAE,sBAAsB;KACjC;IAED;;OAEG;IACH,KAAK,EAAE;QACL,MAAM,EAAE,mBAAmB;QAC3B,GAAG,EAAE,gBAAgB;QACrB,MAAM,EAAE,mBAAmB;QAC3B,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,wBAAwB;KACtC;IAED;;OAEG;IACH,IAAI,EAAE;QACJ,MAAM,EAAE,kBAAkB;QAC1B,KAAK,EAAE,iBAAiB;QACxB,IAAI,EAAE,gBAAgB;QACtB,GAAG,EAAE,eAAe;QACpB,OAAO,EAAE,oBAAoB;KAC9B;IAED;;OAEG;IACH,UAAU,EAAE;QACV,KAAK,EAAE,uBAAuB;QAC9B,GAAG,EAAE,qBAAqB;QAC1B,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,0BAA0B;QACnC,UAAU,EAAE,6BAA6B;KAC1C;IAED;;OAEG;IACH,SAAS,EAAE;QACT,YAAY,EAAE,+BAA+B;QAC7C,YAAY,EAAE,+BAA+B;QAC7C,SAAS,EAAE,4BAA4B;QACvC,SAAS,EAAE,4BAA4B;KACxC;CACO,CAAC;AAEX;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,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,iBAAS,CAAC,CAAC;IACtB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB;IACjC,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,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"}