@celox-sim/celox 0.0.1 → 0.1.3

package/dist/dut.d.ts

@@ -0,0 +1,35 @@
+/**
+ * DUT (Device Under Test) accessor factory.
+ *
+ * Builds a plain object with Object.defineProperty getter/setters that
+ * read and write directly via DataView on a SharedArrayBuffer.
+ * No Proxy is used — every port becomes a concrete property whose
+ * accessors are fully visible to V8 inline caches.
+ */
+import type { NativeHandle, PortInfo, SignalLayout } from "./types.js";
+/**
+ * Mutable state shared between the DUT accessor and its owning
+ * Simulator/Simulation instance.  The Simulator clears `dirty` after
+ * tick()/runUntil(); the DUT sets it on any input write and checks it
+ * before any output read.
+ * @internal
+ */
+export interface DirtyState {
+    dirty: boolean;
+}
+/**
+ * Create a DUT accessor object with defineProperty-based getters/setters.
+ *
+ * @param buffer   SharedArrayBuffer from NAPI create()
+ * @param layout   Per-signal byte layout within the buffer
+ * @param portDefs Port metadata from the ModuleDefinition
+ * @param handle   Native handle (for evalComb calls)
+ * @param state    Shared dirty-tracking state
+ */
+export declare function createDut<P>(buffer: ArrayBuffer | SharedArrayBuffer, layout: Record<string, SignalLayout>, portDefs: Record<string, PortInfo>, handle: NativeHandle, state: DirtyState): P;
+/**
+ * Read the raw 4-state (value, mask) pair for a signal.
+ * Mask bits set to 1 indicate X/Z.
+ */
+export declare function readFourState(buffer: ArrayBuffer | SharedArrayBuffer, sig: SignalLayout): [value: number | bigint, mask: number | bigint];
+//# sourceMappingURL=dut.d.ts.map

package/dist/dut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dut.d.ts","sourceRoot":"","sources":["../src/dut.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACR,YAAY,EAEb,MAAM,YAAY,CAAC;AAOpB;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAC;CAChB;AAwJD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,MAAM,EAAE,WAAW,GAAG,iBAAiB,EACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAClC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,UAAU,GAChB,CAAC,CAiDH;AAoLD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,GAAG,iBAAiB,EACvC,GAAG,EAAE,YAAY,GAChB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,CAejD"}

package/dist/dut.js

@@ -0,0 +1,342 @@
+/**
+ * DUT (Device Under Test) accessor factory.
+ *
+ * Builds a plain object with Object.defineProperty getter/setters that
+ * read and write directly via DataView on a SharedArrayBuffer.
+ * No Proxy is used — every port becomes a concrete property whose
+ * accessors are fully visible to V8 inline caches.
+ */
+import { isFourStateValue } from "./types.js";
+// ---------------------------------------------------------------------------
+// DataView helpers
+// ---------------------------------------------------------------------------
+/** Read an unsigned integer of the given byte-size (little-endian), masked to width. */
+function readNumber(view, offset, width) {
+    if (width <= 8) {
+        const raw = view.getUint8(offset);
+        return width === 8 ? raw : raw & ((1 << width) - 1);
+    }
+    if (width <= 16) {
+        const raw = view.getUint16(offset, true);
+        return width === 16 ? raw : raw & ((1 << width) - 1);
+    }
+    if (width <= 32) {
+        const raw = view.getUint32(offset, true);
+        return width === 32 ? raw : (raw & ((1 << width) - 1)) >>> 0;
+    }
+    // 33..53 bits — fits safely in a JS number
+    const lo = view.getUint32(offset, true);
+    const hi = view.getUint32(offset + 4, true) & ((1 << (width - 32)) - 1);
+    return lo + hi * 0x1_0000_0000;
+}
+/** Write an unsigned integer of the given byte-size (little-endian). */
+function writeNumber(view, offset, width, value) {
+    if (width <= 8) {
+        view.setUint8(offset, value & ((1 << width) - 1));
+    }
+    else if (width <= 16) {
+        view.setUint16(offset, value & ((1 << width) - 1), true);
+    }
+    else if (width <= 32) {
+        view.setUint32(offset, value >>> 0, true);
+    }
+    else {
+        // 33..53 bits
+        view.setUint32(offset, value >>> 0, true);
+        view.setUint32(offset + 4, Math.floor(value / 0x1_0000_0000) >>> 0, true);
+    }
+}
+/** Read a wide value (≥ 54 bits) as BigInt, little-endian. */
+function readBigInt(view, offset, byteSize) {
+    let result = 0n;
+    // Read 8 bytes at a time, then remaining bytes
+    const fullWords = Math.floor(byteSize / 8);
+    for (let i = 0; i < fullWords; i++) {
+        const word = view.getBigUint64(offset + i * 8, true);
+        result |= word << BigInt(i * 64);
+    }
+    const remaining = byteSize % 8;
+    if (remaining > 0) {
+        const base = offset + fullWords * 8;
+        for (let i = 0; i < remaining; i++) {
+            result |= BigInt(view.getUint8(base + i)) << BigInt(fullWords * 64 + i * 8);
+        }
+    }
+    return result;
+}
+/** Write a wide value (≥ 54 bits) as BigInt, little-endian. */
+function writeBigInt(view, offset, byteSize, value) {
+    const fullWords = Math.floor(byteSize / 8);
+    for (let i = 0; i < fullWords; i++) {
+        view.setBigUint64(offset + i * 8, value & 0xffffffffffffffffn, true);
+        value >>= 64n;
+    }
+    const remaining = byteSize % 8;
+    if (remaining > 0) {
+        const base = offset + fullWords * 8;
+        for (let i = 0; i < remaining; i++) {
+            view.setUint8(base + i, Number(value & 0xffn));
+            value >>= 8n;
+        }
+    }
+}
+/** Read a signal value from the DataView. Returns number or bigint. */
+function readSignal(view, sig) {
+    if (sig.width <= 53) {
+        return readNumber(view, sig.offset, sig.width);
+    }
+    return readBigInt(view, sig.offset, sig.byteSize);
+}
+/** Write a signal value to the DataView. Accepts number or bigint. */
+function writeSignal(view, sig, value) {
+    if (sig.width <= 53 && typeof value === "number") {
+        writeNumber(view, sig.offset, sig.width, value);
+    }
+    else {
+        const bigVal = typeof value === "bigint" ? value : BigInt(value);
+        writeBigInt(view, sig.offset, sig.byteSize, bigVal);
+    }
+}
+/** Write a 4-state value (value + mask) to the DataView. */
+function writeFourState(view, sig, fsv) {
+    writeSignal(view, sig, fsv.value);
+    // Mask is stored immediately after the value bytes
+    const maskLayout = {
+        offset: sig.offset + sig.byteSize,
+        width: sig.width,
+        byteSize: sig.byteSize,
+        is4state: false,
+        direction: sig.direction,
+    };
+    writeSignal(view, maskLayout, fsv.mask);
+}
+/** Write all-X mask for a signal. */
+function writeAllX(view, sig) {
+    // Value = 0, mask = all 1s
+    writeSignal(view, sig, sig.width <= 53 ? 0 : 0n);
+    const allOnes = sig.width <= 53
+        ? (sig.width === 53 ? Number.MAX_SAFE_INTEGER : (1 << sig.width) - 1)
+        : (1n << BigInt(sig.width)) - 1n;
+    const maskLayout = {
+        offset: sig.offset + sig.byteSize,
+        width: sig.width,
+        byteSize: sig.byteSize,
+        is4state: false,
+        direction: sig.direction,
+    };
+    writeSignal(view, maskLayout, allOnes);
+}
+// ---------------------------------------------------------------------------
+// DUT factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a DUT accessor object with defineProperty-based getters/setters.
+ *
+ * @param buffer   SharedArrayBuffer from NAPI create()
+ * @param layout   Per-signal byte layout within the buffer
+ * @param portDefs Port metadata from the ModuleDefinition
+ * @param handle   Native handle (for evalComb calls)
+ * @param state    Shared dirty-tracking state
+ */
+export function createDut(buffer, layout, portDefs, handle, state) {
+    const view = new DataView(buffer);
+    const obj = Object.create(null);
+    // Iterate portDefs (not layout) so that interface ports are discovered
+    // even though their individual members are the ones that appear in layout.
+    for (const [name, port] of Object.entries(portDefs)) {
+        // Skip clock ports — they are controlled via tick()/addClock()
+        if (port.type === "clock")
+            continue;
+        // Check for nested interface
+        if (port.interface) {
+            const nestedObj = createNestedDut(view, layout, port.interface, name, handle, state);
+            Object.defineProperty(obj, name, {
+                value: nestedObj,
+                enumerable: true,
+                configurable: false,
+                writable: false,
+            });
+            continue;
+        }
+        const sig = layout[name];
+        if (!sig)
+            continue;
+        // Check for array port
+        if (port.arrayDims && port.arrayDims.length > 0) {
+            const arrayObj = createArrayDut(view, sig, port, handle, state);
+            Object.defineProperty(obj, name, {
+                value: arrayObj,
+                enumerable: true,
+                configurable: false,
+                writable: false,
+            });
+            continue;
+        }
+        // Scalar port — define getter/setter
+        defineSignalProperty(obj, name, view, sig, port, handle, state);
+    }
+    return obj;
+}
+/** Define a single scalar signal property on the target object. */
+function defineSignalProperty(target, name, view, sig, port, handle, state) {
+    const isOutput = port?.direction === "output";
+    const isInput = port?.direction === "input";
+    Object.defineProperty(target, name, {
+        get() {
+            // Output reads: lazy evalComb if dirty
+            if (state.dirty && !isInput) {
+                handle.evalComb();
+                state.dirty = false;
+            }
+            return readSignal(view, sig);
+        },
+        set(value) {
+            if (isOutput) {
+                throw new Error(`Cannot write to output port '${name}'`);
+            }
+            if (value === Symbol.for("veryl:X")) {
+                if (!sig.is4state) {
+                    throw new Error(`Port '${name}' is not 4-state; cannot assign X`);
+                }
+                writeAllX(view, sig);
+            }
+            else if (isFourStateValue(value)) {
+                if (!sig.is4state) {
+                    throw new Error(`Port '${name}' is not 4-state; cannot assign FourState`);
+                }
+                writeFourState(view, sig, value);
+            }
+            else {
+                writeSignal(view, sig, value);
+                // Clear mask when writing a defined value to a 4-state signal
+                if (sig.is4state) {
+                    const maskLayout = {
+                        offset: sig.offset + sig.byteSize,
+                        width: sig.width,
+                        byteSize: sig.byteSize,
+                        is4state: false,
+                        direction: sig.direction,
+                    };
+                    writeSignal(view, maskLayout, sig.width <= 53 ? 0 : 0n);
+                }
+            }
+            state.dirty = true;
+        },
+        enumerable: true,
+        configurable: false,
+    });
+}
+// ---------------------------------------------------------------------------
+// Nested interface accessor
+// ---------------------------------------------------------------------------
+function createNestedDut(view, layout, members, prefix, handle, state) {
+    const obj = Object.create(null);
+    for (const [memberName, memberPort] of Object.entries(members)) {
+        const qualifiedName = `${prefix}.${memberName}`;
+        const sig = layout[qualifiedName];
+        if (!sig)
+            continue;
+        if (memberPort.interface) {
+            const nested = createNestedDut(view, layout, memberPort.interface, qualifiedName, handle, state);
+            Object.defineProperty(obj, memberName, {
+                value: nested,
+                enumerable: true,
+                configurable: false,
+                writable: false,
+            });
+        }
+        else {
+            defineSignalProperty(obj, memberName, view, sig, memberPort, handle, state);
+        }
+    }
+    return obj;
+}
+// ---------------------------------------------------------------------------
+// Array port accessor
+// ---------------------------------------------------------------------------
+function createArrayDut(view, baseSig, port, handle, state) {
+    const dims = port.arrayDims;
+    const elementWidth = port.width;
+    const elementByteSize = Math.ceil(elementWidth / 8);
+    const totalElements = dims.reduce((a, b) => a * b, 1);
+    const isOutput = port.direction === "output";
+    const isInput = port.direction === "input";
+    const baseOffset = baseSig.offset;
+    const is4state = baseSig.is4state;
+    return {
+        length: totalElements,
+        at(i) {
+            if (state.dirty && !isInput) {
+                handle.evalComb();
+                state.dirty = false;
+            }
+            const offset = baseOffset + i * elementByteSize;
+            if (elementWidth <= 53) {
+                return readNumber(view, offset, elementWidth);
+            }
+            return readBigInt(view, offset, elementByteSize);
+        },
+        set(i, value) {
+            if (isOutput) {
+                throw new Error("Cannot write to output array port");
+            }
+            const offset = baseOffset + i * elementByteSize;
+            if (value === Symbol.for("veryl:X")) {
+                if (!is4state) {
+                    throw new Error("Array port is not 4-state; cannot assign X");
+                }
+                const elemSig = {
+                    offset, width: elementWidth, byteSize: elementByteSize,
+                    is4state, direction: baseSig.direction,
+                };
+                writeAllX(view, elemSig);
+            }
+            else if (isFourStateValue(value)) {
+                if (!is4state) {
+                    throw new Error("Array port is not 4-state; cannot assign FourState");
+                }
+                const elemSig = {
+                    offset, width: elementWidth, byteSize: elementByteSize,
+                    is4state, direction: baseSig.direction,
+                };
+                writeFourState(view, elemSig, value);
+            }
+            else if (elementWidth <= 53 && typeof value === "number") {
+                writeNumber(view, offset, elementWidth, value);
+                if (is4state)
+                    writeNumber(view, offset + elementByteSize, elementWidth, 0);
+            }
+            else {
+                const bigVal = typeof value === "bigint" ? value : BigInt(value);
+                writeBigInt(view, offset, elementByteSize, bigVal);
+                if (is4state)
+                    writeBigInt(view, offset + elementByteSize, elementByteSize, 0n);
+            }
+            state.dirty = true;
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// 4-state read helper (exported for advanced use)
+// ---------------------------------------------------------------------------
+/**
+ * Read the raw 4-state (value, mask) pair for a signal.
+ * Mask bits set to 1 indicate X/Z.
+ */
+export function readFourState(buffer, sig) {
+    if (!sig.is4state) {
+        throw new Error("Signal is not 4-state");
+    }
+    const view = new DataView(buffer);
+    const value = readSignal(view, sig);
+    const maskSig = {
+        offset: sig.offset + sig.byteSize,
+        width: sig.width,
+        byteSize: sig.byteSize,
+        is4state: false,
+        direction: sig.direction,
+    };
+    const mask = readSignal(view, maskSig);
+    return [value, mask];
+}
+//# sourceMappingURL=dut.js.map

package/dist/dut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dut.js","sourceRoot":"","sources":["../src/dut.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiB9C,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,wFAAwF;AACxF,SAAS,UAAU,CAAC,IAAc,EAAE,MAAc,EAAE,KAAa;IAC/D,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACzC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACzC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC;IACD,2CAA2C;IAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxE,OAAO,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC;AACjC,CAAC;AAED,wEAAwE;AACxE,SAAS,WAAW,CAClB,IAAc,EACd,MAAc,EACd,KAAa,EACb,KAAa;IAEb,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;SAAM,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QACvB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;SAAM,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QACvB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,cAAc;QACd,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,SAAS,UAAU,CAAC,IAAc,EAAE,MAAc,EAAE,QAAgB;IAClE,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,+CAA+C;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QACrD,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,SAAS,GAAG,QAAQ,GAAG,CAAC,CAAC;IAC/B,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+DAA+D;AAC/D,SAAS,WAAW,CAClB,IAAc,EACd,MAAc,EACd,QAAgB,EAChB,KAAa;IAEb,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,mBAAsB,EAAE,IAAI,CAAC,CAAC;QACxE,KAAK,KAAK,GAAG,CAAC;IAChB,CAAC;IACD,MAAM,SAAS,GAAG,QAAQ,GAAG,CAAC,CAAC;IAC/B,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;YAC/C,KAAK,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,SAAS,UAAU,CACjB,IAAc,EACd,GAAiB;IAEjB,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACpB,OAAO,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED,sEAAsE;AACtE,SAAS,WAAW,CAClB,IAAc,EACd,GAAiB,EACjB,KAAsB;IAEtB,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACjD,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjE,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,4DAA4D;AAC5D,SAAS,cAAc,CACrB,IAAc,EACd,GAAiB,EACjB,GAAmB;IAEnB,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,mDAAmD;IACnD,MAAM,UAAU,GAAiB;QAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ;QACjC,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;IACF,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,qCAAqC;AACrC,SAAS,SAAS,CAAC,IAAc,EAAE,GAAiB;IAClD,2BAA2B;IAC3B,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjD,MAAM,OAAO,GACX,GAAG,CAAC,KAAK,IAAI,EAAE;QACb,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC;IACrC,MAAM,UAAU,GAAiB;QAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ;QACjC,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;IACF,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CACvB,MAAuC,EACvC,MAAoC,EACpC,QAAkC,EAClC,MAAoB,EACpB,KAAiB;IAEjB,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAM,CAAC;IAErC,uEAAuE;IACvE,2EAA2E;IAC3E,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,+DAA+D;QAC/D,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;YAAE,SAAS;QAEpC,6BAA6B;QAC7B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,eAAe,CAC/B,IAAI,EACJ,MAAM,EACN,IAAI,CAAC,SAAS,EACd,IAAI,EACJ,MAAM,EACN,KAAK,CACN,CAAC;YACF,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE;gBAC/B,KAAK,EAAE,SAAS;gBAChB,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,KAAK;gBACnB,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG;YAAE,SAAS;QAEnB,uBAAuB;QACvB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAChE,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE;gBAC/B,KAAK,EAAE,QAAQ;gBACf,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,KAAK;gBACnB,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,qCAAqC;QACrC,oBAAoB,CAAC,GAAa,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mEAAmE;AACnE,SAAS,oBAAoB,CAC3B,MAAc,EACd,IAAY,EACZ,IAAc,EACd,GAAiB,EACjB,IAA0B,EAC1B,MAAoB,EACpB,KAAiB;IAEjB,MAAM,QAAQ,GAAG,IAAI,EAAE,SAAS,KAAK,QAAQ,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC;IAE5C,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE;QAClC,GAAG;YACD,uCAAuC;YACvC,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC5B,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAClB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;YACtB,CAAC;YACD,OAAO,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QAED,GAAG,CAAC,KAAgD;YAClD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,GAAG,CAAC,CAAC;YAC3D,CAAC;YAED,IAAI,KAAK,KAAK,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,mCAAmC,CAAC,CAAC;gBACpE,CAAC;gBACD,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACvB,CAAC;iBAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,2CAA2C,CAAC,CAAC;gBAC5E,CAAC;gBACD,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,KAAwB,CAAC,CAAC;gBACjD,8DAA8D;gBAC9D,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;oBACjB,MAAM,UAAU,GAAiB;wBAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ;wBACjC,KAAK,EAAE,GAAG,CAAC,KAAK;wBAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;wBACtB,QAAQ,EAAE,KAAK;wBACf,SAAS,EAAE,GAAG,CAAC,SAAS;qBACzB,CAAC;oBACF,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC;YAED,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;QACrB,CAAC;QAED,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,SAAS,eAAe,CACtB,IAAc,EACd,MAAoC,EACpC,OAAiC,EACjC,MAAc,EACd,MAAoB,EACpB,KAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEhC,KAAK,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,MAAM,aAAa,GAAG,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG;YAAE,SAAS;QAEnB,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,eAAe,CAC5B,IAAI,EACJ,MAAM,EACN,UAAU,CAAC,SAAS,EACpB,aAAa,EACb,MAAM,EACN,KAAK,CACN,CAAC;YACF,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE;gBACrC,KAAK,EAAE,MAAM;gBACb,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,KAAK;gBACnB,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,oBAAoB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,SAAS,cAAc,CACrB,IAAc,EACd,OAAqB,EACrB,IAAc,EACd,MAAoB,EACpB,KAAiB;IAEjB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAU,CAAC;IAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC;IAChC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAElC,OAAO;QACL,MAAM,EAAE,aAAa;QAErB,EAAE,CAAC,CAAS;YACV,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC5B,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAClB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;YACtB,CAAC;YACD,MAAM,MAAM,GAAG,UAAU,GAAG,CAAC,GAAG,eAAe,CAAC;YAChD,IAAI,YAAY,IAAI,EAAE,EAAE,CAAC;gBACvB,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;QACnD,CAAC;QAED,GAAG,CAAC,CAAS,EAAE,KAAgD;YAC7D,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,MAAM,GAAG,UAAU,GAAG,CAAC,GAAG,eAAe,CAAC;YAChD,IAAI,KAAK,KAAK,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;gBAChE,CAAC;gBACD,MAAM,OAAO,GAAiB;oBAC5B,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe;oBACtD,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS;iBACvC,CAAC;gBACF,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC3B,CAAC;iBAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;gBACxE,CAAC;gBACD,MAAM,OAAO,GAAiB;oBAC5B,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe;oBACtD,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS;iBACvC,CAAC;gBACF,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACvC,CAAC;iBAAM,IAAI,YAAY,IAAI,EAAE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC3D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;gBAC/C,IAAI,QAAQ;oBAAE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;YAC7E,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;gBAC3E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;gBACnD,IAAI,QAAQ;oBAAE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;YACjF,CAAC;YACD,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAuC,EACvC,GAAiB;IAEjB,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACpC,MAAM,OAAO,GAAiB;QAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ;QACjC,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;IACF,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACvB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @celox-sim/celox
+ *
+ * TypeScript runtime for Celox HDL simulation.
+ * Provides zero-FFI signal I/O via SharedArrayBuffer + DataView,
+ * with NAPI calls only for control operations (tick, runUntil, etc.).
+ *
+ * @packageDocumentation
+ */
+export type { ModuleDefinition, PortInfo, SimulatorOptions, EventHandle, FourStateValue, } from "./types.js";
+/** @internal */
+export type { SignalLayout, CreateResult, NativeHandle, NativeSimulatorHandle, NativeSimulationHandle, } from "./types.js";
+export { X, FourState, isFourStateValue } from "./types.js";
+export { Simulator } from "./simulator.js";
+export { Simulation } from "./simulation.js";
+/** @internal */
+export { createDut, readFourState } from "./dut.js";
+/** @internal */
+export type { DirtyState } from "./dut.js";
+/** @internal */
+export { loadNativeAddon, parseNapiLayout, buildPortsFromLayout, wrapDirectSimulatorHandle, wrapDirectSimulationHandle, createSimulatorBridge, createSimulationBridge, } from "./napi-helpers.js";
+/** @internal */
+export type { RawNapiAddon, RawNapiSimulatorHandle, RawNapiSimulationHandle } from "./napi-helpers.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACV,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,EAChB,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,gBAAgB;AAChB,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,gBAAgB;AAChB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACpD,gBAAgB;AAChB,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,gBAAgB;AAChB,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,gBAAgB;AAChB,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * @celox-sim/celox
+ *
+ * TypeScript runtime for Celox HDL simulation.
+ * Provides zero-FFI signal I/O via SharedArrayBuffer + DataView,
+ * with NAPI calls only for control operations (tick, runUntil, etc.).
+ *
+ * @packageDocumentation
+ */
+// 4-state helpers
+export { X, FourState, isFourStateValue } from "./types.js";
+// Simulator (event-based)
+export { Simulator } from "./simulator.js";
+// Simulation (time-based)
+export { Simulation } from "./simulation.js";
+/** @internal */
+export { createDut, readFourState } from "./dut.js";
+/** @internal */
+export { loadNativeAddon, parseNapiLayout, buildPortsFromLayout, wrapDirectSimulatorHandle, wrapDirectSimulationHandle, createSimulatorBridge, createSimulationBridge, } from "./napi-helpers.js";
+// NAPI bridge (backward compat — re-exports from napi-helpers)
+// Consumers that import from "./napi-bridge.js" still work.
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH,kBAAkB;AAClB,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE5D,0BAA0B;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,0BAA0B;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,gBAAgB;AAChB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIpD,gBAAgB;AAChB,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAI3B,+DAA+D;AAC/D,4DAA4D"}

package/dist/napi-bridge.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Backward-compatibility re-exports from napi-helpers.ts.
+ *
+ * New code should import from "./napi-helpers.js" directly.
+ */
+export { createSimulatorBridge, createSimulationBridge, type RawNapiAddon, type RawNapiSimulatorHandle, type RawNapiSimulationHandle, } from "./napi-helpers.js";
+//# sourceMappingURL=napi-bridge.d.ts.map

package/dist/napi-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"napi-bridge.d.ts","sourceRoot":"","sources":["../src/napi-bridge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,mBAAmB,CAAC"}

package/dist/napi-bridge.js

@@ -0,0 +1,7 @@
+/**
+ * Backward-compatibility re-exports from napi-helpers.ts.
+ *
+ * New code should import from "./napi-helpers.js" directly.
+ */
+export { createSimulatorBridge, createSimulationBridge, } from "./napi-helpers.js";
+//# sourceMappingURL=napi-bridge.js.map

package/dist/napi-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"napi-bridge.js","sourceRoot":"","sources":["../src/napi-bridge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAIvB,MAAM,mBAAmB,CAAC"}

package/dist/napi-helpers.d.ts

@@ -0,0 +1,104 @@
+/**
+ * NAPI helper utilities for the @celox-sim/celox TypeScript runtime.
+ *
+ * Provides reusable functions for:
+ *   - Loading the native addon
+ *   - Parsing NAPI layout JSON into SignalLayout
+ *   - Building PortInfo from NAPI layout (auto-detect ports)
+ *   - Wrapping NAPI handles with zero-copy direct operations
+ *   - Creating bridge functions for Simulator.create() / Simulation.create()
+ */
+import type { NativeSimulatorHandle, NativeSimulationHandle, PortInfo, SignalLayout } from "./types.js";
+import type { NativeCreateFn } from "./simulator.js";
+import type { NativeCreateSimulationFn } from "./simulation.js";
+export interface RawNapiSimulatorHandle {
+    readonly layoutJson: string;
+    readonly eventsJson: string;
+    readonly stableSize: number;
+    readonly totalSize: number;
+    tick(eventId: number): void;
+    tickN(eventId: number, count: number): void;
+    evalComb(): void;
+    dump(timestamp: number): void;
+    sharedMemory(): Uint8Array;
+    dispose(): void;
+}
+export interface RawNapiSimulationHandle {
+    readonly layoutJson: string;
+    readonly eventsJson: string;
+    readonly stableSize: number;
+    readonly totalSize: number;
+    addClock(eventId: number, period: number, initialDelay: number): void;
+    schedule(eventId: number, time: number, value: number): void;
+    runUntil(endTime: number): void;
+    step(): number | null;
+    time(): number;
+    evalComb(): void;
+    dump(timestamp: number): void;
+    sharedMemory(): Uint8Array;
+    dispose(): void;
+}
+export interface NapiOptions {
+    fourState?: boolean;
+}
+export interface RawNapiAddon {
+    NativeSimulatorHandle: {
+        new (code: string, top: string, options?: NapiOptions): RawNapiSimulatorHandle;
+        fromProject(projectPath: string, top: string, options?: NapiOptions): RawNapiSimulatorHandle;
+    };
+    NativeSimulationHandle: {
+        new (code: string, top: string, options?: NapiOptions): RawNapiSimulationHandle;
+        fromProject(projectPath: string, top: string, options?: NapiOptions): RawNapiSimulationHandle;
+    };
+    genTs(projectPath: string): string;
+}
+/**
+ * Load the native NAPI addon.
+ *
+ * Resolution: `@celox-sim/celox-napi` package (works both in workspace dev
+ * and when installed from npm — napi-rs generated index.js handles platform
+ * detection). An explicit path can override this.
+ *
+ * @param addonPath  Explicit path to the `.node` file (overrides auto-detection).
+ */
+export declare function loadNativeAddon(addonPath?: string): RawNapiAddon;
+/**
+ * Parse the NAPI layout JSON into SignalLayout records.
+ * Returns both the full layout (with type_kind for port detection) and
+ * the DUT-compatible layout (without type_kind).
+ */
+export declare function parseNapiLayout(json: string): {
+    signals: Record<string, SignalLayout & {
+        typeKind: string;
+        arrayDims?: number[];
+    }>;
+    forDut: Record<string, SignalLayout>;
+};
+/**
+ * Build PortInfo records from the NAPI layout signals.
+ * This auto-detects port metadata so users don't need to hand-write ModuleDefinition.
+ */
+export declare function buildPortsFromLayout(signals: Record<string, SignalLayout & {
+    typeKind: string;
+    arrayDims?: number[];
+}>, _events: Record<string, number>): Record<string, PortInfo>;
+/**
+ * Wrap a raw NAPI simulator handle with direct (zero-copy) operations.
+ * The buffer is shared between JS and Rust — no copies per tick.
+ */
+export declare function wrapDirectSimulatorHandle(raw: RawNapiSimulatorHandle): NativeSimulatorHandle;
+/**
+ * Wrap a raw NAPI simulation handle with direct (zero-copy) operations.
+ */
+export declare function wrapDirectSimulationHandle(raw: RawNapiSimulationHandle): NativeSimulationHandle;
+/**
+ * Create a `NativeCreateFn` from a raw NAPI addon, suitable for
+ * `Simulator.create(module, { __nativeCreate: ... })`.
+ */
+export declare function createSimulatorBridge(addon: RawNapiAddon): NativeCreateFn;
+/**
+ * Create a `NativeCreateSimulationFn` from a raw NAPI addon, suitable for
+ * `Simulation.create(module, { __nativeCreate: ... })`.
+ */
+export declare function createSimulationBridge(addon: RawNapiAddon): NativeCreateSimulationFn;
+//# sourceMappingURL=napi-helpers.d.ts.map

package/dist/napi-helpers.d.ts.map

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