@forthix/forthic 0.3.0 → 0.5.0

package/dist/cjs/websocket/runtime_manager.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketRuntimeManager = void 0;
+/**
+ * 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
+ */
+const action_cable_client_js_1 = require("./action_cable_client.js");
+/**
+ * WebSocketRuntimeManager - Manages ActionCable connections to remote Forthic runtimes
+ */
+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 action_cable_client_js_1.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;
+        }
+    }
+}
+exports.WebSocketRuntimeManager = WebSocketRuntimeManager;
+//# sourceMappingURL=runtime_manager.js.map

package/dist/cjs/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,qEAAsF;AAEtF;;GAEG;AACH,MAAa,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,0CAAiB,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;;AA/GH,0DAgHC"}

package/dist/cjs/websocket/serializer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * WebSocket JSON Serializer for Forthic
+ * Mirrors gRPC serializer but outputs JSON instead of protobuf
+ * Handles: int, float, string, bool, null, array, record, temporal types
+ * Uses shared type detection from common/type_utils
+ */
+export interface StackValue {
+    type: 'int' | 'float' | 'string' | 'bool' | 'null' | 'array' | 'record' | 'instant' | 'plain_date' | 'zoned_datetime';
+    value: any;
+}
+/**
+ * Serialize a JavaScript value to a JSON StackValue
+ * Uses shared type detection and maps to JSON format
+ */
+export declare function serializeValue(value: any): StackValue;
+/**
+ * Deserialize a JSON StackValue to a JavaScript value
+ */
+export declare function deserializeValue(stackValue: StackValue): any;
+/**
+ * Serialize an array of values (stack)
+ */
+export declare function serializeStack(stack: any[]): StackValue[];
+/**
+ * Deserialize an array of StackValues (stack)
+ */
+export declare function deserializeStack(stackValues: StackValue[]): any[];

package/dist/cjs/websocket/serializer.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * WebSocket JSON Serializer for Forthic
+ * Mirrors gRPC serializer but outputs JSON instead of protobuf
+ * Handles: int, float, string, bool, null, array, record, temporal types
+ * Uses shared type detection from common/type_utils
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeValue = serializeValue;
+exports.deserializeValue = deserializeValue;
+exports.serializeStack = serializeStack;
+exports.deserializeStack = deserializeStack;
+const temporal_polyfill_1 = require("temporal-polyfill");
+const type_utils_js_1 = require("../common/type_utils.js");
+/**
+ * Serialize a JavaScript value to a JSON StackValue
+ * Uses shared type detection and maps to JSON format
+ */
+function serializeValue(value) {
+    const type = (0, type_utils_js_1.getForthicType)(value);
+    switch (type) {
+        case 'null':
+            return { type: 'null', value: null };
+        case 'boolean':
+            return { type: 'bool', value };
+        case 'integer':
+            return { type: 'int', value };
+        case 'float':
+            return { type: 'float', value };
+        case 'string':
+            return { type: 'string', value };
+        case 'array':
+            return {
+                type: 'array',
+                value: value.map((item) => serializeValue(item)),
+            };
+        case 'record':
+            const fields = {};
+            for (const [key, val] of Object.entries(value)) {
+                fields[key] = serializeValue(val);
+            }
+            return {
+                type: 'record',
+                value: fields,
+            };
+        case 'instant':
+            return {
+                type: 'instant',
+                value: value.toString(),
+            };
+        case 'plain_date':
+            return {
+                type: 'plain_date',
+                value: value.toString(),
+            };
+        case 'zoned_datetime':
+            return {
+                type: 'zoned_datetime',
+                value: value.toString(),
+            };
+        default:
+            throw new Error(`Unsupported Forthic type: ${type}`);
+    }
+}
+/**
+ * Deserialize a JSON StackValue to a JavaScript value
+ */
+function deserializeValue(stackValue) {
+    switch (stackValue.type) {
+        case 'int':
+        case 'float':
+        case 'string':
+        case 'bool':
+            return stackValue.value;
+        case 'null':
+            return null;
+        case 'array':
+            return stackValue.value.map((v) => deserializeValue(v));
+        case 'record':
+            return Object.entries(stackValue.value).reduce((acc, [k, v]) => {
+                acc[k] = deserializeValue(v);
+                return acc;
+            }, {});
+        case 'instant':
+            return temporal_polyfill_1.Temporal.Instant.from(stackValue.value);
+        case 'plain_date':
+            return temporal_polyfill_1.Temporal.PlainDate.from(stackValue.value);
+        case 'zoned_datetime':
+            return temporal_polyfill_1.Temporal.ZonedDateTime.from(stackValue.value);
+        default:
+            throw new Error(`Unknown stack value type: ${stackValue.type}`);
+    }
+}
+/**
+ * Serialize an array of values (stack)
+ */
+function serializeStack(stack) {
+    return stack.map((value) => serializeValue(value));
+}
+/**
+ * Deserialize an array of StackValues (stack)
+ */
+function deserializeStack(stackValues) {
+    return stackValues.map((value) => deserializeValue(value));
+}
+//# sourceMappingURL=serializer.js.map

package/dist/cjs/websocket/serializer.js.map

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

package/dist/esm/common/temporal_utils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Temporal Type Utilities
+ *
+ * Provides duck-typing helpers for checking Temporal types.
+ * Uses duck typing instead of instanceof to avoid issues with multiple
+ * instances of temporal-polyfill being loaded.
+ */
+/**
+ * Check if a value is a Temporal.PlainDate
+ * PlainDate has year, month, day properties but no hour property
+ */
+export declare function isPlainDate(value: any): boolean;
+/**
+ * Check if a value is a Temporal.Instant
+ * Instant has epochNanoseconds property as a bigint
+ */
+export declare function isInstant(value: any): boolean;
+/**
+ * Check if a value is a Temporal.ZonedDateTime
+ * ZonedDateTime has a timeZoneId property
+ */
+export declare function isZonedDateTime(value: any): boolean;
+/**
+ * Check if a value is a Temporal.PlainTime
+ * PlainTime has hour and minute properties but no year
+ */
+export declare function isPlainTime(value: any): boolean;
+/**
+ * Check if a value is a Temporal.PlainDateTime
+ * PlainDateTime has year, month, day, hour properties but no timeZoneId
+ */
+export declare function isPlainDateTime(value: any): boolean;
+/**
+ * Check if a value is any Temporal type
+ */
+export declare function isTemporal(value: any): boolean;

package/dist/esm/common/temporal_utils.js

@@ -0,0 +1,72 @@
+/**
+ * Temporal Type Utilities
+ *
+ * Provides duck-typing helpers for checking Temporal types.
+ * Uses duck typing instead of instanceof to avoid issues with multiple
+ * instances of temporal-polyfill being loaded.
+ */
+/**
+ * Check if a value is a Temporal.PlainDate
+ * PlainDate has year, month, day properties but no hour property
+ */
+export function isPlainDate(value) {
+    return value && typeof value === 'object' &&
+        typeof value.year === 'number' &&
+        typeof value.month === 'number' &&
+        typeof value.day === 'number' &&
+        typeof value.toString === 'function' &&
+        !value.hour; // PlainDate doesn't have hour
+}
+/**
+ * Check if a value is a Temporal.Instant
+ * Instant has epochNanoseconds property as a bigint
+ */
+export function isInstant(value) {
+    return value && typeof value === 'object' &&
+        typeof value.epochNanoseconds === 'bigint' &&
+        typeof value.toString === 'function';
+}
+/**
+ * Check if a value is a Temporal.ZonedDateTime
+ * ZonedDateTime has a timeZoneId property
+ */
+export function isZonedDateTime(value) {
+    return value && typeof value === 'object' &&
+        typeof value.timeZoneId === 'string' &&
+        typeof value.toString === 'function';
+}
+/**
+ * Check if a value is a Temporal.PlainTime
+ * PlainTime has hour and minute properties but no year
+ */
+export function isPlainTime(value) {
+    return value && typeof value === 'object' &&
+        typeof value.hour === 'number' &&
+        typeof value.minute === 'number' &&
+        typeof value.toString === 'function' &&
+        !value.year; // PlainTime doesn't have year
+}
+/**
+ * Check if a value is a Temporal.PlainDateTime
+ * PlainDateTime has year, month, day, hour properties but no timeZoneId
+ */
+export function isPlainDateTime(value) {
+    return value && typeof value === 'object' &&
+        typeof value.year === 'number' &&
+        typeof value.month === 'number' &&
+        typeof value.day === 'number' &&
+        typeof value.hour === 'number' &&
+        typeof value.toString === 'function' &&
+        !value.timeZoneId; // PlainDateTime doesn't have timeZoneId
+}
+/**
+ * Check if a value is any Temporal type
+ */
+export function isTemporal(value) {
+    return isPlainDate(value) ||
+        isInstant(value) ||
+        isZonedDateTime(value) ||
+        isPlainTime(value) ||
+        isPlainDateTime(value);
+}
+//# sourceMappingURL=temporal_utils.js.map

package/dist/esm/common/temporal_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal_utils.js","sourceRoot":"","sources":["../../../src/common/temporal_utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAU;IACpC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;QAC7B,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU;QACpC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAE,8BAA8B;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAU;IAClC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,gBAAgB,KAAK,QAAQ;QAC1C,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAU;IACxC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QACpC,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAU;IACpC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU;QACpC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAE,8BAA8B;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAU;IACxC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;QAC7B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU;QACpC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAE,wCAAwC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAU;IACnC,OAAO,WAAW,CAAC,KAAK,CAAC;QAClB,SAAS,CAAC,KAAK,CAAC;QAChB,eAAe,CAAC,KAAK,CAAC;QACtB,WAAW,CAAC,KAAK,CAAC;QAClB,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/esm/common/type_utils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared type detection utilities for Forthic value serialization
+ * Used by both gRPC and WebSocket serializers
+ */
+/**
+ * Forthic value types
+ */
+export type ForthicType = 'null' | 'boolean' | 'integer' | 'float' | 'string' | 'array' | 'record' | 'instant' | 'plain_date' | 'zoned_datetime';
+/**
+ * Get the Forthic type of a JavaScript value
+ * Determines the correct serialization type for a value
+ *
+ * IMPORTANT: Order matters!
+ * - Check temporal types BEFORE primitives (they're objects)
+ * - Check ZonedDateTime BEFORE Instant (ZonedDateTime may match isInstant)
+ * - Check boolean BEFORE number (to avoid typeof confusion)
+ * - Check array BEFORE object (arrays are objects)
+ */
+export declare function getForthicType(value: any): ForthicType;
+/**
+ * Check if a value is a temporal type
+ */
+export declare function isTemporalType(value: any): boolean;
+/**
+ * Check if a value is a primitive type (not array or record)
+ */
+export declare function isPrimitive(value: any): boolean;
+/**
+ * Check if a value is a container type (array or record)
+ */
+export declare function isContainer(value: any): boolean;

package/dist/esm/common/type_utils.js

@@ -0,0 +1,73 @@
+/**
+ * Shared type detection utilities for Forthic value serialization
+ * Used by both gRPC and WebSocket serializers
+ */
+import { isPlainDate, isInstant, isZonedDateTime } from './temporal_utils.js';
+/**
+ * Get the Forthic type of a JavaScript value
+ * Determines the correct serialization type for a value
+ *
+ * IMPORTANT: Order matters!
+ * - Check temporal types BEFORE primitives (they're objects)
+ * - Check ZonedDateTime BEFORE Instant (ZonedDateTime may match isInstant)
+ * - Check boolean BEFORE number (to avoid typeof confusion)
+ * - Check array BEFORE object (arrays are objects)
+ */
+export function getForthicType(value) {
+    // Handle null/undefined
+    if (value === null || value === undefined) {
+        return 'null';
+    }
+    // Handle Temporal types (check ZonedDateTime BEFORE Instant)
+    if (isZonedDateTime(value)) {
+        return 'zoned_datetime';
+    }
+    if (isInstant(value)) {
+        return 'instant';
+    }
+    if (isPlainDate(value)) {
+        return 'plain_date';
+    }
+    // Handle boolean (check before number)
+    if (typeof value === 'boolean') {
+        return 'boolean';
+    }
+    // Handle number (distinguish integer vs float)
+    if (typeof value === 'number') {
+        return Number.isInteger(value) ? 'integer' : 'float';
+    }
+    // Handle string
+    if (typeof value === 'string') {
+        return 'string';
+    }
+    // Handle array (check before object)
+    if (Array.isArray(value)) {
+        return 'array';
+    }
+    // Handle object/record
+    if (typeof value === 'object') {
+        return 'record';
+    }
+    throw new Error(`Unsupported value type: ${typeof value}`);
+}
+/**
+ * Check if a value is a temporal type
+ */
+export function isTemporalType(value) {
+    return isInstant(value) || isPlainDate(value) || isZonedDateTime(value);
+}
+/**
+ * Check if a value is a primitive type (not array or record)
+ */
+export function isPrimitive(value) {
+    const type = getForthicType(value);
+    return type !== 'array' && type !== 'record';
+}
+/**
+ * Check if a value is a container type (array or record)
+ */
+export function isContainer(value) {
+    const type = getForthicType(value);
+    return type === 'array' || type === 'record';
+}
+//# sourceMappingURL=type_utils.js.map

package/dist/esm/common/type_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type_utils.js","sourceRoot":"","sources":["../../../src/common/type_utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAiB9E;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,KAAU;IACvC,wBAAwB;IACxB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6DAA6D;IAC7D,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,+CAA+C;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IACvD,CAAC;IAED,gBAAgB;IAChB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,qCAAqC;IACrC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,uBAAuB;IACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,KAAK,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAU;IACvC,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAU;IACpC,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAU;IACpC,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,CAAC;AAC/C,CAAC"}

package/dist/esm/forthic/decorators/word.d.ts

@@ -10,7 +10,7 @@ export interface ModuleMetadata {
     examples: string[];
 }
 /**
- * @DirectWord Decorator
+ * @ForthicDirectWord Decorator
  *
  * Auto-registers word but does NOT handle stack marshalling.
  * Use this for words that need direct interpreter access to manually manipulate the stack.
@@ -21,16 +21,16 @@ export interface ModuleMetadata {
  * @param customWordName - Optional custom word name (defaults to method name)
  *
  * @example
- * @DirectWord("( item:any forthic:string num:number -- )", "Repeat execution num_times", "<REPEAT")
+ * @ForthicDirectWord("( item:any forthic:string num:number -- )", "Repeat execution num_times", "<REPEAT")
  * async l_REPEAT(interp: Interpreter) {
  *   const num = interp.stack_pop();
  *   const forthic = interp.stack_pop();
  *   // ... manual stack manipulation
  * }
  */
-export declare function DirectWord(stackEffect: string, description?: string, customWordName?: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function ForthicDirectWord(stackEffect: string, description?: string, customWordName?: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 /**
- * @Word Decorator
+ * @ForthicWord Decorator
  *
  * Auto-registers word and handles stack marshalling.
  * Word name defaults to method name, but can be overridden.
@@ -40,18 +40,18 @@ export declare function DirectWord(stackEffect: string, description?: string, cu
  * @param customWordName - Optional custom word name (defaults to method name)
  *
  * @example
- * @Word("( a:number b:number -- sum:number )", "Adds two numbers")
+ * @ForthicWord("( a:number b:number -- sum:number )", "Adds two numbers")
  * async ADD(a: number, b: number) {
  *   return a + b;
  * }
  *
  * @example
- * @Word("( rec:any field:any -- value:any )", "Get value from record", "REC@")
+ * @ForthicWord("( rec:any field:any -- value:any )", "Get value from record", "REC@")
  * async REC_at(rec: any, field: any) {
  *   // Word name will be "REC@" instead of "REC_at"
  * }
  */
-export declare function Word(stackEffect: string, description?: string, customWordName?: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function ForthicWord(stackEffect: string, description?: string, customWordName?: string): (target: any, propertyKey: string, descriptor?: PropertyDescriptor) => PropertyDescriptor;
 /**
  * Helper function to register module documentation
  *
@@ -78,6 +78,14 @@ export declare class DecoratedModule extends Module {
     constructor(name: string);
     set_interp(interp: Interpreter): void;
     private registerDecoratedWords;
+    /**
+     * Add a standard library word that can execute in any runtime
+     *
+     * This creates a word marked with isStandard=true, allowing it to be
+     * included in batched remote execution (e.g., +, MAP, REVERSE can execute
+     * in Python runtime along with Python-specific words).
+     */
+    private add_standard_word;
     /**
      * Get documentation for all words in this module
      *