@celox-sim/celox 0.1.14 → 0.1.16

package/src/simulator.ts

@@ -23,6 +23,7 @@ import type {
 	NativeSimulatorHandle,
 	SignalLayout,
 	SimulatorOptions,
+	SourceFile,
 } from "./types.js";
 
 /**
@@ -33,7 +34,7 @@ import type {
  * @internal
  */
 export type NativeCreateFn = (
-	source: string,
+	sources: ReadonlyArray<SourceFile>,
 	moduleName: string,
 	options: SimulatorOptions,
 ) => CreateResult<NativeSimulatorHandle>;
@@ -61,6 +62,7 @@ export class Simulator<P = Record<string, unknown>> {
 	private readonly _state: DirtyState;
 	private readonly _buffer: ArrayBuffer | SharedArrayBuffer;
 	private readonly _layout: Record<string, SignalLayout>;
+	private readonly _warnings: readonly string[];
 	private _disposed = false;
 
 	private constructor(
@@ -70,6 +72,7 @@ export class Simulator<P = Record<string, unknown>> {
 		state: DirtyState,
 		buffer: ArrayBuffer | SharedArrayBuffer,
 		layout: Record<string, SignalLayout>,
+		warnings: string[],
 	) {
 		this._handle = handle;
 		this._dut = dut;
@@ -77,6 +80,7 @@ export class Simulator<P = Record<string, unknown>> {
 		this._state = state;
 		this._buffer = buffer;
 		this._layout = layout;
+		this._warnings = warnings;
 		const keys = Object.keys(events);
 		this._defaultEventId = keys.length > 0 ? events[keys[0]!]! : -1;
 	}
@@ -122,7 +126,7 @@ export class Simulator<P = Record<string, unknown>> {
 			parameters,
 			deadStorePolicy,
 		} = merged ?? {};
-		const result = createFn(module.source, module.name, {
+		const result = createFn(module.sources, module.name, {
 			fourState,
 			vcd,
 			optimize,
@@ -159,6 +163,7 @@ export class Simulator<P = Record<string, unknown>> {
 			state,
 			result.buffer,
 			result.layout,
+			result.warnings ?? [],
 		);
 	}
 
@@ -183,12 +188,19 @@ export class Simulator<P = Record<string, unknown>> {
 	): Simulator<P> {
 		const addon = loadNativeAddon(options?.nativeAddonPath);
 		const napiOpts = buildNapiOpts(options);
-		const raw = new addon.NativeSimulatorHandle(source, top, napiOpts);
+		const raw = new addon.NativeSimulatorHandle(
+			[{ content: source, path: "" }],
+			top,
+			napiOpts,
+		);
 
 		const layout = parseNapiLayout(raw.layoutJson);
 		const events: Record<string, number> = JSON.parse(raw.eventsJson);
 		const rawHierarchy = parseHierarchyLayout(raw.hierarchyJson, events);
-		const hierarchy = filterHierarchyForDse(rawHierarchy, options?.deadStorePolicy);
+		const hierarchy = filterHierarchyForDse(
+			rawHierarchy,
+			options?.deadStorePolicy,
+		);
 
 		const ports = buildPortsFromLayout(hierarchy.signals, events);
 
@@ -205,7 +217,17 @@ export class Simulator<P = Record<string, unknown>> {
 			hierarchy,
 		);
 
-		return new Simulator<P>(handle, dut, events, state, buf, layout.forDut);
+		const warnings: string[] = JSON.parse(raw.warningsJson ?? "[]");
+
+		return new Simulator<P>(
+			handle,
+			dut,
+			events,
+			state,
+			buf,
+			layout.forDut,
+			warnings,
+		);
 	}
 
 	/**
@@ -235,7 +257,10 @@ export class Simulator<P = Record<string, unknown>> {
 		const layout = parseNapiLayout(raw.layoutJson);
 		const events: Record<string, number> = JSON.parse(raw.eventsJson);
 		const rawHierarchy = parseHierarchyLayout(raw.hierarchyJson, events);
-		const hierarchy = filterHierarchyForDse(rawHierarchy, options?.deadStorePolicy);
+		const hierarchy = filterHierarchyForDse(
+			rawHierarchy,
+			options?.deadStorePolicy,
+		);
 
 		const ports = buildPortsFromLayout(hierarchy.signals, events);
 
@@ -252,7 +277,17 @@ export class Simulator<P = Record<string, unknown>> {
 			hierarchy,
 		);
 
-		return new Simulator<P>(handle, dut, events, state, buf, layout.forDut);
+		const warnings: string[] = JSON.parse(raw.warningsJson ?? "[]");
+
+		return new Simulator<P>(
+			handle,
+			dut,
+			events,
+			state,
+			buf,
+			layout.forDut,
+			warnings,
+		);
 	}
 
 	/** The DUT accessor object — read/write ports as plain properties. */
@@ -260,6 +295,11 @@ export class Simulator<P = Record<string, unknown>> {
 		return this._dut;
 	}
 
+	/** Analyzer warnings emitted during compilation. */
+	get warnings(): readonly string[] {
+		return this._warnings;
+	}
+
 	/**
 	 * Trigger a clock edge.
 	 *

package/src/types.ts

@@ -11,6 +11,12 @@
 // Module definition (produced by Stream A's `celox-gen-ts`)
 // ---------------------------------------------------------------------------
 
+/** A source file with its path and content. */
+export interface SourceFile {
+	readonly path: string;
+	readonly content: string;
+}
+
 /**
  * A compiled module descriptor emitted by `celox-gen-ts`.
  * The type parameter `Ports` carries the generated port interface
@@ -20,7 +26,7 @@
 export interface ModuleDefinition<Ports = Record<string, unknown>> {
 	readonly __celox_module: true;
 	readonly name: string;
-	readonly source: string;
+	readonly sources: ReadonlyArray<SourceFile>;
 	readonly ports: Record<string, PortInfo>;
 	readonly events: string[];
 	/** Absolute path to the Veryl project directory (set by Vite plugin). */
@@ -119,6 +125,8 @@ export interface CreateResult<H extends NativeHandle = NativeHandle> {
 	readonly handle: H;
 	/** Full instance hierarchy (optional — present when NAPI provides it). */
 	readonly hierarchy?: import("./napi-helpers.js").HierarchyNode;
+	/** Analyzer warnings emitted during compilation. */
+	readonly warnings?: string[];
 }
 
 // ---------------------------------------------------------------------------