@celox-sim/celox 0.1.12 → 0.1.14

package/src/index.ts

@@ -8,59 +8,59 @@
  * @packageDocumentation
  */
 
-// Core types
-export type {
-  ModuleDefinition,
-  PortInfo,
-  SimulatorOptions,
-  ParamOverride,
-  EventHandle,
-  FourStateValue,
-  LoopBreak,
-  TrueLoopSpec,
-} from "./types.js";
-
 /** @internal */
-export type {
-  SignalLayout,
-  CreateResult,
-  NativeHandle,
-  NativeSimulatorHandle,
-  NativeSimulationHandle,
-} from "./types.js";
-
-// 4-state helpers
-export { X, FourState, isFourStateValue } from "./types.js";
-
-// Error types
-export { SimulationTimeoutError } from "./types.js";
-
-// Simulator (event-based)
-export { Simulator } from "./simulator.js";
-
-// Simulation (time-based)
-export { Simulation } from "./simulation.js";
-
+export type { DirtyState } from "./dut.js";
 /** @internal */
-export { createDut, createChildDut, readFourState } from "./dut.js";
+export { createChildDut, createDut, readFourState } from "./dut.js";
 /** @internal */
-export type { DirtyState } from "./dut.js";
-
+export type {
+	HierarchyNode,
+	RawNapiAddon,
+	RawNapiSimulationHandle,
+	RawNapiSimulatorHandle,
+} from "./napi-helpers.js";
 /** @internal */
 export {
-  loadNativeAddon,
-  parseNapiLayout,
-  parseHierarchyLayout,
-  buildPortsFromLayout,
-  wrapDirectSimulatorHandle,
-  wrapDirectSimulationHandle,
-  createSimulatorBridge,
-  createSimulationBridge,
-  parseSignalPath,
-  buildNapiOpts,
+	buildNapiOpts,
+	buildPortsFromLayout,
+	createSimulationBridge,
+	createSimulatorBridge,
+	loadNativeAddon,
+	parseHierarchyLayout,
+	parseNapiLayout,
+	parseSignalPath,
+	wrapDirectSimulationHandle,
+	wrapDirectSimulatorHandle,
 } from "./napi-helpers.js";
+// Simulation (time-based)
+export { Simulation } from "./simulation.js";
+// Simulator (event-based)
+export { Simulator } from "./simulator.js";
+// Core types
 /** @internal */
-export type { HierarchyNode, RawNapiAddon, RawNapiSimulatorHandle, RawNapiSimulationHandle } from "./napi-helpers.js";
+export type {
+	CreateResult,
+	EventHandle,
+	FourStateValue,
+	LoopBreak,
+	ModuleDefinition,
+	NativeHandle,
+	NativeSimulationHandle,
+	NativeSimulatorHandle,
+	ParamOverride,
+	PortInfo,
+	SignalLayout,
+	SimulatorOptions,
+	TrueLoopSpec,
+} from "./types.js";
+// 4-state helpers
+// Error types
+export {
+	FourState,
+	isFourStateValue,
+	SimulationTimeoutError,
+	X,
+} from "./types.js";
 
 // NAPI bridge (backward compat — re-exports from napi-helpers)
 // Consumers that import from "./napi-bridge.js" still work.

package/src/matchers.ts

@@ -9,28 +9,28 @@
  *   expect(dut.y).not.toBeZ();
  */
 
-import type { SignalLayout } from "./types.js";
 import { readFourState } from "./dut.js";
+import type { SignalLayout } from "./types.js";
 
 // ---------------------------------------------------------------------------
 // Matcher declarations (augment vitest's Assertion interface)
 // ---------------------------------------------------------------------------
 
 declare module "vitest" {
-  interface Assertion {
-    /** Assert that the value has any X bits (mask !== 0). */
-    toBeX(): void;
-    /** Assert that the value is all-X (mask === all-ones). */
-    toBeAllX(): void;
-    /** Assert that the value has no X bits (mask === 0). */
-    toBeNotX(): void;
-  }
+	interface Assertion {
+		/** Assert that the value has any X bits (mask !== 0). */
+		toBeX(): void;
+		/** Assert that the value is all-X (mask === all-ones). */
+		toBeAllX(): void;
+		/** Assert that the value has no X bits (mask === 0). */
+		toBeNotX(): void;
+	}
 
-  interface AsymmetricMatchersContaining {
-    toBeX(): void;
-    toBeAllX(): void;
-    toBeNotX(): void;
-  }
+	interface AsymmetricMatchersContaining {
+		toBeX(): void;
+		toBeAllX(): void;
+		toBeNotX(): void;
+	}
 }
 
 // ---------------------------------------------------------------------------
@@ -46,24 +46,24 @@ declare module "vitest" {
  *   expect(ref).toBeX();
  */
 export interface FourStateRef {
-  readonly __fourStateRef: true;
-  readonly buffer: SharedArrayBuffer;
-  readonly layout: SignalLayout;
+	readonly __fourStateRef: true;
+	readonly buffer: SharedArrayBuffer;
+	readonly layout: SignalLayout;
 }
 
 export function fourStateRef(
-  buffer: SharedArrayBuffer,
-  layout: SignalLayout,
+	buffer: SharedArrayBuffer,
+	layout: SignalLayout,
 ): FourStateRef {
-  return { __fourStateRef: true, buffer, layout };
+	return { __fourStateRef: true, buffer, layout };
 }
 
 function isFourStateRef(v: unknown): v is FourStateRef {
-  return (
-    typeof v === "object" &&
-    v !== null &&
-    (v as FourStateRef).__fourStateRef === true
-  );
+	return (
+		typeof v === "object" &&
+		v !== null &&
+		(v as FourStateRef).__fourStateRef === true
+	);
 }
 
 // ---------------------------------------------------------------------------
@@ -71,57 +71,57 @@ function isFourStateRef(v: unknown): v is FourStateRef {
 // ---------------------------------------------------------------------------
 
 function getMask(received: unknown): bigint {
-  if (!isFourStateRef(received)) {
-    throw new TypeError(
-      "toBeX/toBeAllX/toBeNotX matchers require a FourStateRef. " +
-        "Use sim.fourStateRef(name) to get one.",
-    );
-  }
-  const [, mask] = readFourState(received.buffer, received.layout);
-  return mask;
+	if (!isFourStateRef(received)) {
+		throw new TypeError(
+			"toBeX/toBeAllX/toBeNotX matchers require a FourStateRef. " +
+				"Use sim.fourStateRef(name) to get one.",
+		);
+	}
+	const [, mask] = readFourState(received.buffer, received.layout);
+	return mask;
 }
 
 const customMatchers = {
-  toBeX(received: unknown) {
-    const mask = getMask(received);
-    const pass = mask !== 0n;
-    return {
-      pass,
-      message: () =>
-        pass
-          ? `expected signal NOT to have X bits, but mask = ${mask}`
-          : `expected signal to have X bits, but mask = 0`,
-    };
-  },
+	toBeX(received: unknown) {
+		const mask = getMask(received);
+		const pass = mask !== 0n;
+		return {
+			pass,
+			message: () =>
+				pass
+					? `expected signal NOT to have X bits, but mask = ${mask}`
+					: `expected signal to have X bits, but mask = 0`,
+		};
+	},
 
-  toBeAllX(received: unknown) {
-    if (!isFourStateRef(received)) {
-      throw new TypeError("toBeAllX requires a FourStateRef");
-    }
-    const [, mask] = readFourState(received.buffer, received.layout);
-    const width = received.layout.width;
-    const allOnes = (1n << BigInt(width)) - 1n;
-    const pass = mask === allOnes;
-    return {
-      pass,
-      message: () =>
-        pass
-          ? `expected signal NOT to be all-X`
-          : `expected signal to be all-X, but mask = ${mask}`,
-    };
-  },
+	toBeAllX(received: unknown) {
+		if (!isFourStateRef(received)) {
+			throw new TypeError("toBeAllX requires a FourStateRef");
+		}
+		const [, mask] = readFourState(received.buffer, received.layout);
+		const width = received.layout.width;
+		const allOnes = (1n << BigInt(width)) - 1n;
+		const pass = mask === allOnes;
+		return {
+			pass,
+			message: () =>
+				pass
+					? `expected signal NOT to be all-X`
+					: `expected signal to be all-X, but mask = ${mask}`,
+		};
+	},
 
-  toBeNotX(received: unknown) {
-    const mask = getMask(received);
-    const pass = mask === 0n;
-    return {
-      pass,
-      message: () =>
-        pass
-          ? `expected signal to have X bits, but mask = 0`
-          : `expected signal NOT to have X bits, but mask = ${mask}`,
-    };
-  },
+	toBeNotX(received: unknown) {
+		const mask = getMask(received);
+		const pass = mask === 0n;
+		return {
+			pass,
+			message: () =>
+				pass
+					? `expected signal to have X bits, but mask = 0`
+					: `expected signal NOT to have X bits, but mask = ${mask}`,
+		};
+	},
 };
 
 // ---------------------------------------------------------------------------
@@ -138,14 +138,14 @@ const customMatchers = {
  * ```
  */
 export function setupMatchers(): void {
-  // Dynamic import to keep vitest as an optional peer dependency
-  try {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const { expect } = require("vitest");
-    expect.extend(customMatchers);
-  } catch {
-    throw new Error(
-      "vitest is required for setupMatchers(). Install it as a dev dependency.",
-    );
-  }
+	// Dynamic import to keep vitest as an optional peer dependency
+	try {
+		// eslint-disable-next-line @typescript-eslint/no-require-imports
+		const { expect } = require("vitest");
+		expect.extend(customMatchers);
+	} catch {
+		throw new Error(
+			"vitest is required for setupMatchers(). Install it as a dev dependency.",
+		);
+	}
 }

package/src/napi-bridge.ts

@@ -5,9 +5,9 @@
  */
 
 export {
-  createSimulatorBridge,
-  createSimulationBridge,
-  type RawNapiAddon,
-  type RawNapiSimulatorHandle,
-  type RawNapiSimulationHandle,
+	createSimulationBridge,
+	createSimulatorBridge,
+	type RawNapiAddon,
+	type RawNapiSimulationHandle,
+	type RawNapiSimulatorHandle,
 } from "./napi-helpers.js";