@forthix/forthic 0.7.1 → 0.7.2

package/dist/esm/websocket/remote_module.d.ts

@@ -0,0 +1,68 @@
+/**
+ * WebSocketRemoteModule - Module that wraps runtime-specific words from a remote runtime
+ * Mirrors RemoteModule from gRPC implementation
+ */
+import { Module } from '../forthic/module.js';
+import { Interpreter } from '../forthic/interpreter.js';
+import { ActionCableClient, type ModuleInfo } from './action_cable_client.js';
+/**
+ * WebSocketRemoteModule - Module containing proxy words that execute in a remote runtime
+ *
+ * This module discovers words from a remote runtime (e.g., pandas module in Ruby)
+ * and creates WebSocketRemoteWord proxies for each discovered word. When used in TypeScript
+ * Forthic code, these words execute in the remote runtime via ActionCable.
+ *
+ * Example usage:
+ * ```typescript
+ * const client = new ActionCableClient({ url: 'ws://localhost:3000/cable' });
+ * const pandasModule = new WebSocketRemoteModule('pandas', client, 'rails');
+ * await pandasModule.initialize();
+ * interp.register_module(pandasModule);
+ * interp.use_modules(['pandas']);
+ *
+ * // Now pandas words execute in Rails runtime
+ * await interp.run(`
+ *   [ [[.name "Alice"]  [.age 30]] REC]
+ *   DF-FROM-RECORDS  # Executes in Rails!
+ * `);
+ * ```
+ */
+export declare class WebSocketRemoteModule extends Module {
+    private client;
+    private runtimeName;
+    private initialized;
+    private moduleInfo;
+    /**
+     * @param moduleName - Name of the module in the remote runtime (e.g., "pandas")
+     * @param client - ActionCable client connected to the remote runtime
+     * @param runtimeName - Name of the runtime (e.g., "rails") for debugging
+     */
+    constructor(moduleName: string, client: ActionCableClient, runtimeName?: string);
+    /**
+     * Initialize the module by discovering words from the remote runtime
+     *
+     * This must be called before the module is registered with an interpreter.
+     * It fetches the module metadata and creates WebSocketRemoteWord proxies for each word.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Override set_interp to ensure module is initialized
+     */
+    set_interp(interp: Interpreter): void;
+    /**
+     * Get the module metadata from the remote runtime
+     */
+    getModuleInfo(): ModuleInfo | null;
+    /**
+     * Get runtime name for debugging
+     */
+    getRuntimeName(): string;
+    /**
+     * Check if module is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get count of discovered words
+     */
+    getWordCount(): number;
+}

package/dist/esm/websocket/remote_module.js

@@ -0,0 +1,103 @@
+/**
+ * WebSocketRemoteModule - Module that wraps runtime-specific words from a remote runtime
+ * Mirrors RemoteModule from gRPC implementation
+ */
+import { Module } from '../forthic/module.js';
+import { WebSocketRemoteWord } from './remote_word.js';
+/**
+ * WebSocketRemoteModule - Module containing proxy words that execute in a remote runtime
+ *
+ * This module discovers words from a remote runtime (e.g., pandas module in Ruby)
+ * and creates WebSocketRemoteWord proxies for each discovered word. When used in TypeScript
+ * Forthic code, these words execute in the remote runtime via ActionCable.
+ *
+ * Example usage:
+ * ```typescript
+ * const client = new ActionCableClient({ url: 'ws://localhost:3000/cable' });
+ * const pandasModule = new WebSocketRemoteModule('pandas', client, 'rails');
+ * await pandasModule.initialize();
+ * interp.register_module(pandasModule);
+ * interp.use_modules(['pandas']);
+ *
+ * // Now pandas words execute in Rails runtime
+ * await interp.run(`
+ *   [ [[.name "Alice"]  [.age 30]] REC]
+ *   DF-FROM-RECORDS  # Executes in Rails!
+ * `);
+ * ```
+ */
+export class WebSocketRemoteModule extends Module {
+    client;
+    runtimeName;
+    initialized = false;
+    moduleInfo = null;
+    /**
+     * @param moduleName - Name of the module in the remote runtime (e.g., "pandas")
+     * @param client - ActionCable client connected to the remote runtime
+     * @param runtimeName - Name of the runtime (e.g., "rails") for debugging
+     */
+    constructor(moduleName, client, runtimeName = 'remote') {
+        super(moduleName);
+        this.client = client;
+        this.runtimeName = runtimeName;
+    }
+    /**
+     * Initialize the module by discovering words from the remote runtime
+     *
+     * This must be called before the module is registered with an interpreter.
+     * It fetches the module metadata and creates WebSocketRemoteWord proxies for each word.
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        try {
+            // Discover module info from remote runtime
+            this.moduleInfo = await this.client.getModuleInfo(this.name);
+            // Create WebSocketRemoteWord for each discovered word
+            for (const wordInfo of this.moduleInfo.words) {
+                const remoteWord = new WebSocketRemoteWord(wordInfo.name, this.client, this.runtimeName, this.name, wordInfo.stack_effect, wordInfo.description);
+                // Add as exportable word (visible when module is imported)
+                this.add_exportable_word(remoteWord);
+            }
+            this.initialized = true;
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize remote module '${this.name}' from ${this.runtimeName} runtime: ${error.message}`);
+        }
+    }
+    /**
+     * Override set_interp to ensure module is initialized
+     */
+    set_interp(interp) {
+        if (!this.initialized) {
+            throw new Error(`WebSocketRemoteModule '${this.name}' must be initialized before being registered with an interpreter. Call await module.initialize() first.`);
+        }
+        super.set_interp(interp);
+    }
+    /**
+     * Get the module metadata from the remote runtime
+     */
+    getModuleInfo() {
+        return this.moduleInfo;
+    }
+    /**
+     * Get runtime name for debugging
+     */
+    getRuntimeName() {
+        return this.runtimeName;
+    }
+    /**
+     * Check if module is initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Get count of discovered words
+     */
+    getWordCount() {
+        return this.moduleInfo?.words?.length || 0;
+    }
+}
+//# sourceMappingURL=remote_module.js.map

package/dist/esm/websocket/remote_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote_module.js","sourceRoot":"","sources":["../../../src/websocket/remote_module.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAG9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,qBAAsB,SAAQ,MAAM;IACvC,MAAM,CAAoB;IAC1B,WAAW,CAAS;IACpB,WAAW,GAAY,KAAK,CAAC;IAC7B,UAAU,GAAsB,IAAI,CAAC;IAE7C;;;;OAIG;IACH,YAAY,UAAkB,EAAE,MAAyB,EAAE,cAAsB,QAAQ;QACvF,KAAK,CAAC,UAAU,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,2CAA2C;YAC3C,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE7D,sDAAsD;YACtD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBAC7C,MAAM,UAAU,GAAG,IAAI,mBAAmB,CACxC,QAAQ,CAAC,IAAI,EACb,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,IAAI,EACT,QAAQ,CAAC,YAAY,EACrB,QAAQ,CAAC,WAAW,CACrB,CAAC;gBAEF,2DAA2D;gBAC3D,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;YACvC,CAAC;YAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,uCAAuC,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,WAAW,aAAc,KAAe,CAAC,OAAO,EAAE,CAClH,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,MAAmB;QAC5B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,CAAC,IAAI,0GAA0G,CAC9I,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/esm/websocket/remote_word.d.ts

@@ -0,0 +1,53 @@
+/**
+ * WebSocketRemoteWord - Word that executes in a remote runtime via ActionCable
+ * Mirrors RemoteWord from gRPC implementation
+ */
+import { Word, RuntimeInfo } from '../forthic/module.js';
+import { Interpreter } from '../forthic/interpreter.js';
+import { ActionCableClient } from './action_cable_client.js';
+/**
+ * WebSocketRemoteWord - Proxy word that delegates execution to a remote runtime
+ *
+ * When executed:
+ * 1. Captures current interpreter stack
+ * 2. Sends word name + stack to remote runtime via ActionCable
+ * 3. Replaces local stack with result stack from remote execution
+ *
+ * This allows seamless integration of remote runtime words
+ * into the local TypeScript interpreter.
+ */
+export declare class WebSocketRemoteWord extends Word {
+    private client;
+    private runtimeName;
+    private moduleName;
+    stackEffect: string;
+    description: string;
+    /**
+     * @param name - Word name (e.g., "DF_FROM_RECORDS")
+     * @param client - ActionCable client connected to remote runtime
+     * @param runtimeName - Name of remote runtime (e.g., "rails", "ruby")
+     * @param moduleName - Module name (e.g., "pandas")
+     * @param stackEffect - Stack notation (e.g., "( records:array -- df:DataFrame )")
+     * @param description - Human-readable description
+     */
+    constructor(name: string, client: ActionCableClient, runtimeName: string, moduleName: string, stackEffect?: string, description?: string);
+    /**
+     * Execute word in remote runtime
+     *
+     * Captures entire stack, sends to remote runtime, and replaces stack with result.
+     */
+    execute(interp: Interpreter): Promise<void>;
+    /**
+     * Get runtime name for debugging/introspection
+     */
+    getRuntimeName(): string;
+    /**
+     * Get module name for debugging/introspection
+     */
+    getModuleName(): string;
+    /**
+     * Get runtime execution information
+     * RemoteWords are runtime-specific and can only execute in their designated runtime
+     */
+    getRuntimeInfo(): RuntimeInfo;
+}

package/dist/esm/websocket/remote_word.js

@@ -0,0 +1,89 @@
+/**
+ * WebSocketRemoteWord - Word that executes in a remote runtime via ActionCable
+ * Mirrors RemoteWord from gRPC implementation
+ */
+import { Word } from '../forthic/module.js';
+/**
+ * WebSocketRemoteWord - Proxy word that delegates execution to a remote runtime
+ *
+ * When executed:
+ * 1. Captures current interpreter stack
+ * 2. Sends word name + stack to remote runtime via ActionCable
+ * 3. Replaces local stack with result stack from remote execution
+ *
+ * This allows seamless integration of remote runtime words
+ * into the local TypeScript interpreter.
+ */
+export class WebSocketRemoteWord extends Word {
+    client;
+    runtimeName;
+    moduleName;
+    stackEffect;
+    description;
+    /**
+     * @param name - Word name (e.g., "DF_FROM_RECORDS")
+     * @param client - ActionCable client connected to remote runtime
+     * @param runtimeName - Name of remote runtime (e.g., "rails", "ruby")
+     * @param moduleName - Module name (e.g., "pandas")
+     * @param stackEffect - Stack notation (e.g., "( records:array -- df:DataFrame )")
+     * @param description - Human-readable description
+     */
+    constructor(name, client, runtimeName, moduleName, stackEffect = '( -- )', description = '') {
+        super(name);
+        this.client = client;
+        this.runtimeName = runtimeName;
+        this.moduleName = moduleName;
+        this.stackEffect = stackEffect;
+        this.description = description;
+    }
+    /**
+     * Execute word in remote runtime
+     *
+     * Captures entire stack, sends to remote runtime, and replaces stack with result.
+     */
+    async execute(interp) {
+        try {
+            // Capture current stack state
+            const stack = interp.get_stack();
+            const stackItems = stack.get_items();
+            // Execute word in remote runtime
+            const resultStack = await this.client.executeWord(this.name, stackItems);
+            // Clear local stack and replace with result
+            while (interp.get_stack().length > 0) {
+                interp.stack_pop();
+            }
+            // Push all result items
+            for (const item of resultStack) {
+                interp.stack_push(item);
+            }
+        }
+        catch (error) {
+            throw new Error(`Error executing remote word ${this.moduleName}.${this.name} in ${this.runtimeName} runtime: ${error.message}`);
+        }
+    }
+    /**
+     * Get runtime name for debugging/introspection
+     */
+    getRuntimeName() {
+        return this.runtimeName;
+    }
+    /**
+     * Get module name for debugging/introspection
+     */
+    getModuleName() {
+        return this.moduleName;
+    }
+    /**
+     * Get runtime execution information
+     * RemoteWords are runtime-specific and can only execute in their designated runtime
+     */
+    getRuntimeInfo() {
+        return {
+            runtime: this.runtimeName,
+            isRemote: true,
+            isStandard: false,
+            availableIn: [this.runtimeName]
+        };
+    }
+}
+//# sourceMappingURL=remote_word.js.map

package/dist/esm/websocket/remote_word.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote_word.js","sourceRoot":"","sources":["../../../src/websocket/remote_word.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAe,MAAM,sBAAsB,CAAC;AAIzD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,mBAAoB,SAAQ,IAAI;IACnC,MAAM,CAAoB;IAC1B,WAAW,CAAS;IACpB,UAAU,CAAS;IACpB,WAAW,CAAS;IACpB,WAAW,CAAS;IAE3B;;;;;;;OAOG;IACH,YACE,IAAY,EACZ,MAAyB,EACzB,WAAmB,EACnB,UAAkB,EAClB,cAAsB,QAAQ,EAC9B,cAAsB,EAAE;QAExB,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,MAAmB;QAC/B,IAAI,CAAC;YACH,8BAA8B;YAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YAErC,iCAAiC;YACjC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAEzE,4CAA4C;YAC5C,OAAO,MAAM,CAAC,SAAS,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,CAAC;YAED,wBAAwB;YACxB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC/B,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,WAAW,aAAc,KAAe,CAAC,OAAO,EAAE,CAC1H,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,WAAW;YACzB,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;SAChC,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/websocket/runtime_manager.d.ts

@@ -0,0 +1,69 @@
+/**
+ * WebSocketRuntimeManager - Singleton for managing ActionCable connections to remote runtimes
+ *
+ * Provides centralized access to ActionCable clients for different runtimes
+ * Mirrors the gRPC RuntimeManager API for compatibility
+ */
+import { ActionCableClient, ActionCableClientConfig } from './action_cable_client.js';
+/**
+ * WebSocketRuntimeManager - Manages ActionCable connections to remote Forthic runtimes
+ */
+export declare class WebSocketRuntimeManager {
+    private static instance;
+    private clients;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): WebSocketRuntimeManager;
+    /**
+     * Connect to a runtime and register the client
+     *
+     * @param runtimeName - Name of the runtime (e.g., "rails", "ruby")
+     * @param url - ActionCable URL (e.g., "ws://localhost:3000/cable")
+     * @param config - Optional additional configuration
+     * @returns ActionCableClient instance
+     */
+    connectRuntime(runtimeName: string, url: string, config?: Partial<ActionCableClientConfig>): ActionCableClient;
+    /**
+     * Register an ActionCable client for a specific runtime
+     *
+     * @param runtimeName - Name of the runtime (e.g., "rails", "ruby")
+     * @param client - ActionCableClient instance connected to that runtime
+     */
+    registerClient(runtimeName: string, client: ActionCableClient): void;
+    /**
+     * Get the ActionCable client for a specific runtime
+     *
+     * @param runtimeName - Name of the runtime
+     * @returns ActionCableClient instance or undefined if not registered
+     */
+    getClient(runtimeName: string): ActionCableClient | undefined;
+    /**
+     * Check if a runtime has a registered client
+     *
+     * @param runtimeName - Name of the runtime
+     * @returns True if client is registered
+     */
+    hasClient(runtimeName: string): boolean;
+    /**
+     * Get all registered runtime names
+     *
+     * @returns Array of runtime names
+     */
+    getRegisteredRuntimes(): string[];
+    /**
+     * Disconnect a specific runtime
+     *
+     * @param runtimeName - Name of the runtime to disconnect
+     */
+    disconnectRuntime(runtimeName: string): void;
+    /**
+     * Clear all registered clients (useful for testing)
+     */
+    clearAll(): void;
+    /**
+     * Reset the singleton (useful for testing)
+     */
+    static reset(): void;
+}

package/dist/esm/websocket/runtime_manager.js

@@ -0,0 +1,108 @@
+/**
+ * WebSocketRuntimeManager - Singleton for managing ActionCable connections to remote runtimes
+ *
+ * Provides centralized access to ActionCable clients for different runtimes
+ * Mirrors the gRPC RuntimeManager API for compatibility
+ */
+import { ActionCableClient } from './action_cable_client.js';
+/**
+ * WebSocketRuntimeManager - Manages ActionCable connections to remote Forthic runtimes
+ */
+export class WebSocketRuntimeManager {
+    static instance = null;
+    clients;
+    constructor() {
+        this.clients = new Map();
+    }
+    /**
+     * Get the singleton instance
+     */
+    static getInstance() {
+        if (!WebSocketRuntimeManager.instance) {
+            WebSocketRuntimeManager.instance = new WebSocketRuntimeManager();
+        }
+        return WebSocketRuntimeManager.instance;
+    }
+    /**
+     * Connect to a runtime and register the client
+     *
+     * @param runtimeName - Name of the runtime (e.g., "rails", "ruby")
+     * @param url - ActionCable URL (e.g., "ws://localhost:3000/cable")
+     * @param config - Optional additional configuration
+     * @returns ActionCableClient instance
+     */
+    connectRuntime(runtimeName, url, config) {
+        // Create a new client for the runtime
+        const client = new ActionCableClient({ url, ...config });
+        // Register it
+        this.clients.set(runtimeName, client);
+        return client;
+    }
+    /**
+     * Register an ActionCable client for a specific runtime
+     *
+     * @param runtimeName - Name of the runtime (e.g., "rails", "ruby")
+     * @param client - ActionCableClient instance connected to that runtime
+     */
+    registerClient(runtimeName, client) {
+        this.clients.set(runtimeName, client);
+    }
+    /**
+     * Get the ActionCable client for a specific runtime
+     *
+     * @param runtimeName - Name of the runtime
+     * @returns ActionCableClient instance or undefined if not registered
+     */
+    getClient(runtimeName) {
+        return this.clients.get(runtimeName);
+    }
+    /**
+     * Check if a runtime has a registered client
+     *
+     * @param runtimeName - Name of the runtime
+     * @returns True if client is registered
+     */
+    hasClient(runtimeName) {
+        return this.clients.has(runtimeName);
+    }
+    /**
+     * Get all registered runtime names
+     *
+     * @returns Array of runtime names
+     */
+    getRegisteredRuntimes() {
+        return Array.from(this.clients.keys());
+    }
+    /**
+     * Disconnect a specific runtime
+     *
+     * @param runtimeName - Name of the runtime to disconnect
+     */
+    disconnectRuntime(runtimeName) {
+        const client = this.clients.get(runtimeName);
+        if (client) {
+            client.close();
+            this.clients.delete(runtimeName);
+        }
+    }
+    /**
+     * Clear all registered clients (useful for testing)
+     */
+    clearAll() {
+        // Close all clients
+        for (const client of this.clients.values()) {
+            client.close();
+        }
+        this.clients.clear();
+    }
+    /**
+     * Reset the singleton (useful for testing)
+     */
+    static reset() {
+        if (WebSocketRuntimeManager.instance) {
+            WebSocketRuntimeManager.instance.clearAll();
+            WebSocketRuntimeManager.instance = null;
+        }
+    }
+}
+//# sourceMappingURL=runtime_manager.js.map

package/dist/esm/websocket/runtime_manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime_manager.js","sourceRoot":"","sources":["../../../src/websocket/runtime_manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAA2B,MAAM,0BAA0B,CAAC;AAEtF;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAC1B,MAAM,CAAC,QAAQ,GAAmC,IAAI,CAAC;IACvD,OAAO,CAAiC;IAEhD;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,uBAAuB,CAAC,QAAQ,EAAE,CAAC;YACtC,uBAAuB,CAAC,QAAQ,GAAG,IAAI,uBAAuB,EAAE,CAAC;QACnE,CAAC;QACD,OAAO,uBAAuB,CAAC,QAAQ,CAAC;IAC1C,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CACZ,WAAmB,EACnB,GAAW,EACX,MAAyC;QAEzC,sCAAsC;QACtC,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAEzD,cAAc;QACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAEtC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,WAAmB,EAAE,MAAyB;QAC3D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,WAAmB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,WAAmB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,qBAAqB;QACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,WAAmB;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,oBAAoB;QACpB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,IAAI,uBAAuB,CAAC,QAAQ,EAAE,CAAC;YACrC,uBAAuB,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC5C,uBAAuB,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC1C,CAAC;IACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forthix/forthic",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Stack-based, concatenative language for composable transformations - TypeScript/JavaScript runtime",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

package/dist/cjs/forthic/decorators/schemaUtils.d.ts

@@ -1,70 +0,0 @@
-import { z } from "zod";
-/**
- * Registry metadata types for stack objects and class instances.
- */
-type StackObjectMetadata = {
-    objectType: "stackObject";
-    stackObjectType: string;
-    className?: undefined;
-    OriginalClass?: undefined;
-} | {
-    objectType: "class";
-    OriginalClass: new (...args: any[]) => any;
-    className: string;
-    stackObjectType?: undefined;
-};
-/**
- * Track metadata for schema comparison in tests and documentation.
- * Only required for schemas that can't be compared out of the box,
- * like custom schemas or instanceof schemas.
- */
-export declare const stackObjectRegistry: z.core.$ZodRegistry<StackObjectMetadata, z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
-/**
- * Creates a Zod schema for stack objects that have a stackObjectType property.
- * This is a helper to reduce boilerplate when creating custom stack object schemas.
- * It also ensures the schema is registered in stackObjectRegistry, which enables
- * proper type string generation in stack effects.
- *
- * Use this instead of z.custom() directly for stack objects.
- *
- * @example
- * ```ts
- * interface StackEmail {
- *   stackObjectType: "email";
- *   to: string;
- *   subject: string;
- *   body: string;
- * }
- *
- * const stackEmailSchema = createStackObjectSchema<StackEmail>("email");
- *
- * // Use in stack effect:
- * @ForthicWord(se`(email:${stackEmailSchema} -- sent:${z.boolean()})`, "Send email")
- * async SEND(email: StackEmail): Promise<boolean> { ... }
- * ```
- */
-export declare function createStackObjectSchema<T extends {
-    stackObjectType: string;
-}>(stackObjectType: string, errorMessage?: string): z.ZodCustom<T>;
-/**
- * Creates a Zod instanceof schema with automatic metadata registration.
- * This ensures the schema is registered in stackObjectRegistry, which enables
- * proper type string generation in stack effects.
- *
- * Use this instead of z.instanceof() directly.
- *
- * @example
- * ```ts
- * import { Temporal } from "temporal-polyfill";
- *
- * const plainDateSchema = createInstanceOfSchema(Temporal.PlainDate);
- *
- * // Use in stack effect:
- * @ForthicWord(se`(date:${plainDateSchema} -- formatted:${z.string()})`, "Format date")
- * async FORMAT(date: Temporal.PlainDate): Promise<string> { ... }
- * ```
- */
-export declare function createInstanceOfSchema<T extends abstract new (...args: any[]) => any>(ClassToSchematize: T, 
-/** If not passed, falls back to class.name */
-className?: string): z.ZodType<InstanceType<T>>;
-export {};

package/dist/cjs/forthic/decorators/schemaUtils.js

@@ -1,77 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.stackObjectRegistry = void 0;
-exports.createStackObjectSchema = createStackObjectSchema;
-exports.createInstanceOfSchema = createInstanceOfSchema;
-const zod_1 = require("zod");
-/**
- * Track metadata for schema comparison in tests and documentation.
- * Only required for schemas that can't be compared out of the box,
- * like custom schemas or instanceof schemas.
- */
-exports.stackObjectRegistry = zod_1.z.registry();
-/**
- * Creates a Zod schema for stack objects that have a stackObjectType property.
- * This is a helper to reduce boilerplate when creating custom stack object schemas.
- * It also ensures the schema is registered in stackObjectRegistry, which enables
- * proper type string generation in stack effects.
- *
- * Use this instead of z.custom() directly for stack objects.
- *
- * @example
- * ```ts
- * interface StackEmail {
- *   stackObjectType: "email";
- *   to: string;
- *   subject: string;
- *   body: string;
- * }
- *
- * const stackEmailSchema = createStackObjectSchema<StackEmail>("email");
- *
- * // Use in stack effect:
- * @ForthicWord(se`(email:${stackEmailSchema} -- sent:${z.boolean()})`, "Send email")
- * async SEND(email: StackEmail): Promise<boolean> { ... }
- * ```
- */
-function createStackObjectSchema(stackObjectType, errorMessage) {
-    const schema = zod_1.z.custom((maybeStackObject) => maybeStackObject?.stackObjectType === stackObjectType, errorMessage ?? `expected ${stackObjectType} stackObjectType`);
-    // Register schema with metadata
-    exports.stackObjectRegistry.add(schema, {
-        objectType: "stackObject",
-        stackObjectType,
-    });
-    return schema;
-}
-/**
- * Creates a Zod instanceof schema with automatic metadata registration.
- * This ensures the schema is registered in stackObjectRegistry, which enables
- * proper type string generation in stack effects.
- *
- * Use this instead of z.instanceof() directly.
- *
- * @example
- * ```ts
- * import { Temporal } from "temporal-polyfill";
- *
- * const plainDateSchema = createInstanceOfSchema(Temporal.PlainDate);
- *
- * // Use in stack effect:
- * @ForthicWord(se`(date:${plainDateSchema} -- formatted:${z.string()})`, "Format date")
- * async FORMAT(date: Temporal.PlainDate): Promise<string> { ... }
- * ```
- */
-function createInstanceOfSchema(ClassToSchematize, 
-/** If not passed, falls back to class.name */
-className) {
-    const schema = zod_1.z.instanceof(ClassToSchematize);
-    // Register schema with metadata
-    const resolvedClassName = className ?? ClassToSchematize.name;
-    exports.stackObjectRegistry.add(schema, {
-        objectType: "class",
-        OriginalClass: ClassToSchematize,
-        className: resolvedClassName,
-    });
-    return schema;
-}
-//# sourceMappingURL=schemaUtils.js.map

package/dist/cjs/forthic/decorators/schemaUtils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schemaUtils.js","sourceRoot":"","sources":["../../../../src/forthic/decorators/schemaUtils.ts"],"names":[],"mappings":";;;AAkDA,0DAgBC;AAoBD,wDAgBC;AAtGD,6BAAwB;AAmBxB;;;;GAIG;AACU,QAAA,mBAAmB,GAAG,OAAC,CAAC,QAAQ,EAAuB,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,uBAAuB,CACrC,eAAuB,EACvB,YAAqB;IAErB,MAAM,MAAM,GAAG,OAAC,CAAC,MAAM,CACrB,CAAC,gBAAgB,EAAE,EAAE,CAAE,gBAAkC,EAAE,eAAe,KAAK,eAAe,EAC9F,YAAY,IAAI,YAAY,eAAe,kBAAkB,CAC9D,CAAC;IAEF,gCAAgC;IAChC,2BAAmB,CAAC,GAAG,CAAC,MAAM,EAAE;QAC9B,UAAU,EAAE,aAAa;QACzB,eAAe;KAChB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,sBAAsB,CACpC,iBAAoB;AACpB,8CAA8C;AAC9C,SAAkB;IAElB,MAAM,MAAM,GAAG,OAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAE/C,gCAAgC;IAChC,MAAM,iBAAiB,GAAG,SAAS,IAAI,iBAAiB,CAAC,IAAI,CAAC;IAC9D,2BAAmB,CAAC,GAAG,CAAC,MAAM,EAAE;QAC9B,UAAU,EAAE,OAAO;QACnB,aAAa,EAAE,iBAAiB;QAChC,SAAS,EAAE,iBAAiB;KAC7B,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}