@forthix/forthic 0.7.0 → 0.7.2

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/dist/esm/websocket/serializer.js

@@ -4,7 +4,6 @@
  * Handles: int, float, string, bool, null, array, record, temporal types
  * Uses shared type detection from common/type_utils
  */
-import { Temporal } from "temporal-polyfill";
 import { getForthicType } from "../common/type_utils.js";
 /**
  * Serialize a JavaScript value to a JSON StackValue

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forthix/forthic",
-  "version": "0.7.0",
+  "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",
@@ -81,7 +81,6 @@
   },
   "homepage": "https://github.com/forthix/forthic-ts#readme",
   "dependencies": {
-    "temporal-polyfill": "^0.3.0",
     "yaml": "^2.8.1"
   },
   "optionalDependencies": {
@@ -104,6 +103,8 @@
     "ts-node": "^10.9.0",
     "tsx": "^4.20.6",
     "typescript": "^5.7.2",
+    "temporal-polyfill": "^0.3.0",
+    "temporal-spec": "^0.3.0",
     "typescript-eslint": "^8.45.0"
   },
   "browserslist": {

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"}

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

@@ -1,63 +0,0 @@
-import { z } from "zod";
-import type { util as zodUtil } from "zod/v4/core";
-/**
- * Map the set of Zod types to the strings we use in Forthic stack effects.
- * Uses Zod's internal def.type for comprehensive type detection.
- */
-export declare const mapZodToStackEffectType: (zodType: z.ZodTypeAny) => string;
-type InferTupleTypes<T extends zodUtil.TupleItems> = {
-    [K in keyof T]: T[K] extends z.ZodTypeAny ? z.infer<T[K]> : never;
-};
-/**
- * Represents a type-safe stack effect with Zod schemas for validation.
- *
- * @template Args - Tuple of Zod schemas for input parameters
- * @template Return - Zod schema for the return type
- */
-export type TaggedStackEffect<Args extends zodUtil.TupleItems, Return extends z.core.$ZodFunctionOut = z.core.$ZodFunctionOut> = {
-    /** The human-readable stack effect string (e.g., "( a:number b:string -- result:string )") */
-    stackEffect: string;
-    /** Zod schemas for runtime validation */
-    schema: {
-        inputSchemas: z.ZodTypeAny[];
-        outputSchema: z.ZodTypeAny;
-    };
-    /**
-     * Phantom property to convey the expected function signature, constructed from the input + output types.
-     * DO NOT USE AT RUNTIME - it's only used for type inference.
-     */
-    _implType: (...args: InferTupleTypes<Args>) => Promise<z.infer<Return>>;
-};
-/**
- * Tagged template literal for stack effects. Use with the @ForthicWord decorator to
- * create a type-safe stack effect.
- *
- * @example
- * ```ts
- * // Type-safe stack effect with Zod validation
- * @ForthicWord(se`(a:${z.number()} b:${z.string()} -- result:${z.string()})`, "Concatenate number and string")
- * async CONCAT(a: number, b: string): Promise<string> {
- *   return `${a}${b}`;
- * }
- * ```
- *
- * @example
- * ```ts
- * // No parameters, returns string
- * @ForthicWord(se`( -- message:${z.string()})`, "Get greeting")
- * async GREET(): Promise<string> {
- *   return "Hello!";
- * }
- * ```
- *
- * @example
- * ```ts
- * // Takes string, no return (void)
- * @ForthicWord(se`(input:${z.string()} -- ${z.void()})`, "Log to console")
- * async LOG(input: string): Promise<void> {
- *   console.log(input);
- * }
- * ```
- */
-export declare const se: <Args extends zodUtil.TupleItems, Return extends z.core.$ZodFunctionOut>(template: TemplateStringsArray, ...values: [...Args, Return]) => TaggedStackEffect<Args, Return>;
-export {};