@celox-sim/celox 0.0.1 → 0.1.4

package/dist/simulator.js

@@ -0,0 +1,171 @@
+/**
+ * Event-based Simulator.
+ *
+ * Wraps a NativeSimulatorHandle and provides a high-level TypeScript API
+ * for manually controlling clock edges via `tick()`.
+ */
+import { createDut } from "./dut.js";
+import { loadNativeAddon, parseNapiLayout, buildPortsFromLayout, wrapDirectSimulatorHandle, } from "./napi-helpers.js";
+let _nativeCreate;
+/**
+ * Register the NAPI binding at module load time.
+ * Called once by the package entry point after loading the native addon.
+ * @internal
+ */
+export function setNativeSimulatorCreate(fn) {
+    _nativeCreate = fn;
+}
+// ---------------------------------------------------------------------------
+// Simulator
+// ---------------------------------------------------------------------------
+export class Simulator {
+    _handle;
+    _dut;
+    _events;
+    _defaultEventId;
+    _state;
+    _disposed = false;
+    constructor(handle, dut, events, state) {
+        this._handle = handle;
+        this._dut = dut;
+        this._events = events;
+        this._state = state;
+        const keys = Object.keys(events);
+        this._defaultEventId = keys.length > 0 ? events[keys[0]] : -1;
+    }
+    /**
+     * Create a Simulator for the given module.
+     *
+     * ```ts
+     * import { Adder } from "./generated/Adder.js";
+     * const sim = Simulator.create(Adder);
+     * ```
+     */
+    static create(module, options) {
+        // When the module was produced by the Vite plugin, delegate to fromProject()
+        if (module.projectPath && !options?.__nativeCreate) {
+            return Simulator.fromProject(module.projectPath, module.name, options);
+        }
+        const createFn = options?.__nativeCreate ?? _nativeCreate;
+        if (!createFn) {
+            throw new Error("Native simulator binding not loaded. " +
+                "Ensure @celox-sim/celox-napi is installed.");
+        }
+        const { fourState, vcd } = options ?? {};
+        const result = createFn(module.source, module.name, { fourState, vcd });
+        const state = { dirty: false };
+        const dut = createDut(result.buffer, result.layout, module.ports, result.handle, state);
+        return new Simulator(result.handle, dut, result.events, state);
+    }
+    /**
+     * Create a Simulator directly from Veryl source code.
+     *
+     * Automatically discovers ports from the NAPI layout — no
+     * `ModuleDefinition` needed.
+     *
+     * ```ts
+     * const sim = Simulator.fromSource<AdderPorts>(ADDER_SOURCE, "Adder");
+     * sim.dut.a = 100;
+     * sim.dut.b = 200;
+     * sim.tick();
+     * expect(sim.dut.sum).toBe(300);
+     * ```
+     */
+    static fromSource(source, top, options) {
+        const addon = loadNativeAddon(options?.nativeAddonPath);
+        const napiOpts = options?.fourState ? { fourState: options.fourState } : undefined;
+        const raw = new addon.NativeSimulatorHandle(source, top, napiOpts);
+        const layout = parseNapiLayout(raw.layoutJson);
+        const events = JSON.parse(raw.eventsJson);
+        const ports = buildPortsFromLayout(layout.signals, events);
+        const buf = raw.sharedMemory().buffer;
+        const state = { dirty: false };
+        const handle = wrapDirectSimulatorHandle(raw);
+        const dut = createDut(buf, layout.forDut, ports, handle, state);
+        return new Simulator(handle, dut, events, state);
+    }
+    /**
+     * Create a Simulator from a Veryl project directory.
+     *
+     * Searches upward from `projectPath` for `Veryl.toml`, gathers all
+     * `.veryl` source files, and builds the simulator using the project's
+     * clock/reset settings.
+     *
+     * ```ts
+     * const sim = Simulator.fromProject<MyPorts>("./my-project", "Top");
+     * ```
+     */
+    static fromProject(projectPath, top, options) {
+        const addon = loadNativeAddon(options?.nativeAddonPath);
+        const napiOpts = options?.fourState ? { fourState: options.fourState } : undefined;
+        const raw = addon.NativeSimulatorHandle.fromProject(projectPath, top, napiOpts);
+        const layout = parseNapiLayout(raw.layoutJson);
+        const events = JSON.parse(raw.eventsJson);
+        const ports = buildPortsFromLayout(layout.signals, events);
+        const buf = raw.sharedMemory().buffer;
+        const state = { dirty: false };
+        const handle = wrapDirectSimulatorHandle(raw);
+        const dut = createDut(buf, layout.forDut, ports, handle, state);
+        return new Simulator(handle, dut, events, state);
+    }
+    /** The DUT accessor object — read/write ports as plain properties. */
+    get dut() {
+        return this._dut;
+    }
+    tick(eventOrCount, count) {
+        this.ensureAlive();
+        let eventId;
+        let ticks;
+        if (typeof eventOrCount === "object" && eventOrCount !== null) {
+            // tick(eventHandle, count?)
+            eventId = eventOrCount.id;
+            ticks = count ?? 1;
+        }
+        else if (typeof eventOrCount === "number") {
+            // tick(count) — default event
+            eventId = this._defaultEventId;
+            ticks = eventOrCount;
+        }
+        else {
+            // tick() — default event, 1 tick
+            eventId = this._defaultEventId;
+            ticks = 1;
+        }
+        if (ticks === 1) {
+            this._handle.tick(eventId);
+        }
+        else if (ticks > 1) {
+            this._handle.tickN(eventId, ticks);
+        }
+        this._state.dirty = false;
+    }
+    /** Resolve an event name to a handle for use with `tick()`. */
+    event(name) {
+        const id = this._events[name];
+        if (id === undefined) {
+            throw new Error(`Unknown event '${name}'. Available: ${Object.keys(this._events).join(", ")}`);
+        }
+        return { name, id };
+    }
+    /** Write current signal values to VCD at the given timestamp. */
+    dump(timestamp) {
+        this.ensureAlive();
+        this._handle.dump(timestamp);
+    }
+    /** Release native resources. */
+    dispose() {
+        if (!this._disposed) {
+            this._disposed = true;
+            this._handle.dispose();
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    ensureAlive() {
+        if (this._disposed) {
+            throw new Error("Simulator has been disposed");
+        }
+    }
+}
+//# sourceMappingURL=simulator.js.map

package/dist/simulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulator.js","sourceRoot":"","sources":["../src/simulator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAAE,SAAS,EAAmB,MAAM,UAAU,CAAC;AACtD,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAe3B,IAAI,aAAyC,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,EAAkB;IACzD,aAAa,GAAG,EAAE,CAAC;AACrB,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,OAAO,SAAS;IACH,OAAO,CAAwB;IAC/B,IAAI,CAAI;IACR,OAAO,CAAyB;IAChC,eAAe,CAAS;IACxB,MAAM,CAAa;IAC5B,SAAS,GAAG,KAAK,CAAC;IAE1B,YACE,MAA6B,EAC7B,GAAM,EACN,MAA8B,EAC9B,KAAiB;QAEjB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CACX,MAA2B,EAC3B,OAGC;QAED,6EAA6E;QAC7E,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;YACnD,OAAO,SAAS,CAAC,WAAW,CAAI,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,EAAE,cAAc,IAAI,aAAa,CAAC;QAC1D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACb,uCAAuC;gBACrC,4CAA4C,CAC/C,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QACxE,MAAM,KAAK,GAAe,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAE3C,MAAM,GAAG,GAAG,SAAS,CACnB,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,MAAM,EACb,KAAK,CACN,CAAC;QAEF,OAAO,IAAI,SAAS,CAAI,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,UAAU,CACf,MAAc,EACd,GAAW,EACX,OAAyD;QAEzD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,qBAAqB,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAEnE,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,MAAM,GAA2B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAElE,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAE3D,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC;QAEtC,MAAM,KAAK,GAAe,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,SAAS,CAAI,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAEnE,OAAO,IAAI,SAAS,CAAI,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,WAAW,CAChB,WAAmB,EACnB,GAAW,EACX,OAAyD;QAEzD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,MAAM,GAAG,GAAG,KAAK,CAAC,qBAAqB,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAEhF,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,MAAM,GAA2B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAElE,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAE3D,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC;QAEtC,MAAM,KAAK,GAAe,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,SAAS,CAAI,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAEnE,OAAO,IAAI,SAAS,CAAI,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IAED,sEAAsE;IACtE,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAWD,IAAI,CACF,YAAmC,EACnC,KAAc;QAEd,IAAI,CAAC,WAAW,EAAE,CAAC;QAEnB,IAAI,OAAe,CAAC;QACpB,IAAI,KAAa,CAAC;QAElB,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC9D,4BAA4B;YAC5B,OAAO,GAAI,YAA4B,CAAC,EAAE,CAAC;YAC3C,KAAK,GAAG,KAAK,IAAI,CAAC,CAAC;QACrB,CAAC;aAAM,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YAC5C,8BAA8B;YAC9B,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC;YAC/B,KAAK,GAAG,YAAY,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,iCAAiC;YACjC,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC;YAC/B,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;QAED,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,IAAY;QAChB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,kBAAkB,IAAI,iBAAiB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9E,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACtB,CAAC;IAED,iEAAiE;IACjE,IAAI,CAAC,SAAiB;QACpB,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAED,gCAAgC;IAChC,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,WAAW;IACX,0EAA0E;IAElE,WAAW;QACjB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @celox-sim/celox — Core type definitions
+ *
+ * These types define the contract between:
+ *   - Stream A (type generator): produces ModuleDefinition
+ *   - Stream B (NAPI bindings): produces CreateResult / NativeHandles
+ *   - Stream C (this package): consumes both
+ */
+/**
+ * A compiled module descriptor emitted by `celox-gen-ts`.
+ * The type parameter `Ports` carries the generated port interface
+ * (e.g. `AdderPorts`) so that `Simulator.create(Adder)` returns
+ * a correctly-typed DUT accessor.
+ */
+export interface ModuleDefinition<Ports = Record<string, unknown>> {
+    readonly __celox_module: true;
+    readonly name: string;
+    readonly source: string;
+    readonly ports: Record<string, PortInfo>;
+    readonly events: string[];
+    /** Absolute path to the Veryl project directory (set by Vite plugin). */
+    readonly projectPath?: string;
+    /** Phantom field — never set at runtime. Carries the `Ports` type. */
+    readonly __ports?: Ports;
+}
+/** Metadata for a single port / interface member. */
+export interface PortInfo {
+    readonly direction: "input" | "output" | "inout";
+    readonly type: "clock" | "reset" | "logic" | "bit";
+    readonly width: number;
+    readonly arrayDims?: readonly number[];
+    readonly is4state?: boolean;
+    /** Nested interface members (recursive). */
+    readonly interface?: Record<string, PortInfo>;
+}
+/**
+ * Byte-level location of a signal inside the SharedArrayBuffer.
+ * @internal
+ */
+export interface SignalLayout {
+    /** Byte offset within the STABLE region. */
+    readonly offset: number;
+    /** Bit width of the signal. */
+    readonly width: number;
+    /** Number of bytes occupied (ceil(width/8)). */
+    readonly byteSize: number;
+    /** If true, an equal-sized mask follows immediately after the value. */
+    readonly is4state: boolean;
+    readonly direction: "input" | "output" | "inout";
+}
+/**
+ * Opaque handle returned by NAPI for event-based simulation.
+ * @internal
+ */
+export interface NativeSimulatorHandle {
+    tick(eventId: number): void;
+    tickN(eventId: number, count: number): void;
+    evalComb(): void;
+    dump(timestamp: number): void;
+    dispose(): void;
+}
+/**
+ * Opaque handle returned by NAPI for time-based simulation.
+ * @internal
+ */
+export interface NativeSimulationHandle {
+    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;
+    dispose(): void;
+}
+/**
+ * Union of both handle types for code that is handle-agnostic.
+ * @internal
+ */
+export type NativeHandle = NativeSimulatorHandle | NativeSimulationHandle;
+/**
+ * Result returned by NAPI `create()`.
+ * @internal
+ */
+export interface CreateResult<H extends NativeHandle = NativeHandle> {
+    /** The simulator's internal memory buffer shared zero-copy. */
+    readonly buffer: ArrayBuffer | SharedArrayBuffer;
+    /** Per-signal byte layout within `buffer`. */
+    readonly layout: Record<string, SignalLayout>;
+    /** Event name → internal event ID mapping. */
+    readonly events: Record<string, number>;
+    /** Native control handle. */
+    readonly handle: H;
+}
+export interface SimulatorOptions {
+    /** Enable 4-state (X/Z) simulation. Default: false. */
+    fourState?: boolean;
+    /** Path to write VCD waveform output. */
+    vcd?: string;
+}
+/** A resolved event reference for use with `tick()`. */
+export interface EventHandle {
+    readonly name: string;
+    readonly id: number;
+}
+/** Sentinel representing all-X. */
+export declare const X: unique symbol;
+/** A 4-state value with explicit bit-level mask. */
+export interface FourStateValue {
+    readonly __fourState: true;
+    readonly value: number | bigint;
+    readonly mask: number | bigint;
+}
+/** Construct a 4-state value. Mask bits set to 1 indicate X. */
+export declare function FourState(value: number | bigint, mask: number | bigint): FourStateValue;
+export declare function isFourStateValue(v: unknown): v is FourStateValue;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,23 @@
+/**
+ * @celox-sim/celox — Core type definitions
+ *
+ * These types define the contract between:
+ *   - Stream A (type generator): produces ModuleDefinition
+ *   - Stream B (NAPI bindings): produces CreateResult / NativeHandles
+ *   - Stream C (this package): consumes both
+ */
+// ---------------------------------------------------------------------------
+// 4-state helpers
+// ---------------------------------------------------------------------------
+/** Sentinel representing all-X. */
+export const X = Symbol.for("veryl:X");
+/** Construct a 4-state value. Mask bits set to 1 indicate X. */
+export function FourState(value, mask) {
+    return { __fourState: true, value, mask };
+}
+export function isFourStateValue(v) {
+    return (typeof v === "object" &&
+        v !== null &&
+        v.__fourState === true);
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgIH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,mCAAmC;AACnC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AASvC,gEAAgE;AAChE,MAAM,UAAU,SAAS,CACvB,KAAsB,EACtB,IAAqB;IAErB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAAU;IACzC,OAAO,CACL,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI;QACT,CAAoB,CAAC,WAAW,KAAK,IAAI,CAC3C,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,10 +1,53 @@
 {
   "name": "@celox-sim/celox",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @celox-sim/celox",
+  "version": "0.1.4",
+  "description": "TypeScript runtime for Celox HDL simulation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+    "celox",
+    "hdl",
+    "simulator",
+    "testbench",
+    "hardware"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/celox-sim/celox",
+    "directory": "packages/celox"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@celox-sim/celox-napi": "0.0.0"
+  },
+  "peerDependencies": {
+    "vitest": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.2",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "bench": "vitest bench"
+  }
+}