@chronon-sim/engine 0.1.0

package/dist/kernel/kernel.d.ts

@@ -0,0 +1,104 @@
+/** Conventional event priorities. Lower numbers run first among events at the same tick. */
+export declare const Priority: {
+    readonly HIGHEST: 0;
+    readonly HIGH: 2;
+    readonly DEFAULT: 5;
+    readonly LOW: 8;
+    readonly LOWEST: 10;
+};
+/** Default simulation resolution: microseconds. */
+export declare const DEFAULT_TICKS_PER_SECOND = 1000000;
+/**
+ * How many events may run in a row without the clock advancing before the run is declared stuck.
+ * A legitimate burst (thousands of simultaneous arrivals) is far below this; a zero-delay loop hits it in seconds.
+ */
+export declare const DEFAULT_MAX_EVENTS_PER_TICK = 10000000;
+/** Safety limits for a kernel. Both are optional. */
+export interface KernelLimits {
+    /** Largest number of events allowed at one instant (default {@link DEFAULT_MAX_EVENTS_PER_TICK}). */
+    maxEventsPerTick?: number;
+    /** Largest total number of events in a run (default unlimited). */
+    maxEvents?: number;
+}
+/** Thrown when a simulation hits a safety limit, such as a zero-delay loop that would never end. */
+export declare class SimulationLimitError extends Error {
+    constructor(message: string);
+}
+/** A handle to a scheduled event or registered condition. */
+export interface EventHandle {
+    /** Cancel the event. No effect if it already fired or was cancelled. */
+    cancel(): void;
+    /** True while the event is waiting to fire (not fired, not cancelled). */
+    isScheduled(): boolean;
+}
+/** Options for {@link Kernel.schedule}. */
+export interface ScheduleOptions {
+    /** Insert ahead of other events with the same tick and priority (default: FIFO, i.e. behind them). */
+    lifo?: boolean;
+}
+/**
+ * The discrete event kernel. Time is an integer number of ticks (a JS number, safe to 2^53).
+ *
+ * Events are ordered by (tick, priority, insertion sequence), which makes execution fully
+ * deterministic. Conditional events ({@link Kernel.waitUntil}) are evaluated only when the next
+ * event would advance the clock, never mid-tick.
+ */
+export declare class Kernel {
+    /** Ticks per simulated second. */
+    readonly ticksPerSecond: number;
+    private tick;
+    private readonly heap;
+    private nextSeq;
+    private nextLifoSeq;
+    private pendingEvents;
+    private conditions;
+    private processed;
+    /** How many events in a row have run without the clock moving. */
+    private sameTickStreak;
+    private readonly maxEventsPerTick;
+    private readonly maxEvents;
+    constructor(ticksPerSecond?: number, limits?: KernelLimits);
+    /** The current simulation time in ticks. */
+    get currentTick(): number;
+    /** The current simulation time in seconds. */
+    get currentSeconds(): number;
+    /** Number of events waiting to fire (excludes cancelled events and unsatisfied conditions). */
+    get pendingCount(): number;
+    /** Total number of events executed so far. */
+    get eventsProcessed(): number;
+    /**
+     * Convert seconds to the nearest whole tick. Results are capped at the largest exactly representable
+     * tick count: a delay that long (about 285 years at the default resolution) means "never within this
+     * run", and an uncapped absurd value would overflow to Infinity and be rejected by {@link Kernel.schedule}.
+     */
+    secondsToTicks(seconds: number): number;
+    /** Convert ticks to seconds. */
+    ticksToSeconds(ticks: number): number;
+    /**
+     * Schedule `callback` to run `delayTicks` ticks from now.
+     * @param delayTicks non-negative integer
+     * @param priority lower runs first among events at the same tick (see {@link Priority})
+     */
+    schedule(delayTicks: number, priority: number, callback: () => void, options?: ScheduleOptions): EventHandle;
+    /**
+     * Register a condition. When `predicate()` first returns true — checked only when the clock is
+     * about to advance — `callback` is scheduled at the current tick with the given priority.
+     */
+    waitUntil(predicate: () => boolean, callback: () => void, priority?: number): EventHandle;
+    /** Execute the next event (advancing the clock if needed). Returns false if nothing is left to run. */
+    step(): boolean;
+    /** Execute all events with tick <= `tick`, then set the clock to `tick`. */
+    runUntil(tick: number): void;
+    /** Run for `durationSeconds` of simulated time from now. */
+    run(durationSeconds: number): void;
+    private peekLive;
+    private stepUpTo;
+    /**
+     * Stop a model that can never finish. Events that keep scheduling more events at the same instant
+     * (a zero-delay loop) would otherwise run forever without the clock moving, so the run neither ends
+     * nor reports anything. The limits turn that into a clear error.
+     */
+    private guardAgainstRunaway;
+    private fireReadyConditions;
+}
+//# sourceMappingURL=kernel.d.ts.map

package/dist/kernel/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/kernel/kernel.ts"],"names":[],"mappings":"AAEA,4FAA4F;AAC5F,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX,mDAAmD;AACnD,eAAO,MAAM,wBAAwB,UAAY,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,WAAa,CAAC;AAEtD,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,qGAAqG;IACrG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oGAAoG;AACpG,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,MAAM,IAAI,IAAI,CAAC;IACf,0EAA0E;IAC1E,WAAW,IAAI,OAAO,CAAC;CACxB;AAED,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B,sGAAsG;IACtG,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAgDD;;;;;;GAMG;AACH,qBAAa,MAAM;IACjB,kCAAkC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiD;IACtE,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,SAAS,CAAK;IACtB,kEAAkE;IAClE,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,cAAc,GAAE,MAAiC,EAAE,MAAM,GAAE,YAAiB;IASxF,4CAA4C;IAC5C,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,8CAA8C;IAC9C,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,+FAA+F;IAC/F,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,8CAA8C;IAC9C,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIvC,gCAAgC;IAChC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIrC;;;;OAIG;IACH,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,IAAI,EACpB,OAAO,GAAE,eAAoB,GAC5B,WAAW;IAad;;;OAGG;IACH,SAAS,CACP,SAAS,EAAE,MAAM,OAAO,EACxB,QAAQ,EAAE,MAAM,IAAI,EACpB,QAAQ,GAAE,MAAyB,GAClC,WAAW;IAMd,uGAAuG;IACvG,IAAI,IAAI,OAAO;IAIf,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU5B,4DAA4D;IAC5D,GAAG,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAIlC,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,QAAQ;IAiBhB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,mBAAmB;CAmB5B"}

package/dist/kernel/kernel.js

@@ -0,0 +1,236 @@
+import { BinaryHeap } from "./heap.js";
+/** Conventional event priorities. Lower numbers run first among events at the same tick. */
+export const Priority = {
+    HIGHEST: 0,
+    HIGH: 2,
+    DEFAULT: 5,
+    LOW: 8,
+    LOWEST: 10,
+};
+/** Default simulation resolution: microseconds. */
+export const DEFAULT_TICKS_PER_SECOND = 1_000_000;
+/**
+ * How many events may run in a row without the clock advancing before the run is declared stuck.
+ * A legitimate burst (thousands of simultaneous arrivals) is far below this; a zero-delay loop hits it in seconds.
+ */
+export const DEFAULT_MAX_EVENTS_PER_TICK = 10_000_000;
+/** Thrown when a simulation hits a safety limit, such as a zero-delay loop that would never end. */
+export class SimulationLimitError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SimulationLimitError";
+    }
+}
+const PENDING = 0;
+const FIRED = 1;
+const CANCELLED = 2;
+class ScheduledEvent {
+    tick;
+    priority;
+    seq;
+    callback;
+    onCancel;
+    state = PENDING;
+    constructor(tick, priority, seq, callback, onCancel) {
+        this.tick = tick;
+        this.priority = priority;
+        this.seq = seq;
+        this.callback = callback;
+        this.onCancel = onCancel;
+    }
+    cancel() {
+        if (this.state !== PENDING)
+            return;
+        this.state = CANCELLED;
+        this.onCancel();
+    }
+    isScheduled() {
+        return this.state === PENDING;
+    }
+}
+class Condition {
+    predicate;
+    callback;
+    priority;
+    state = PENDING;
+    constructor(predicate, callback, priority) {
+        this.predicate = predicate;
+        this.callback = callback;
+        this.priority = priority;
+    }
+    cancel() {
+        if (this.state === PENDING)
+            this.state = CANCELLED;
+    }
+    isScheduled() {
+        return this.state === PENDING;
+    }
+}
+function compareEvents(a, b) {
+    return a.tick - b.tick || a.priority - b.priority || a.seq - b.seq;
+}
+/**
+ * The discrete event kernel. Time is an integer number of ticks (a JS number, safe to 2^53).
+ *
+ * Events are ordered by (tick, priority, insertion sequence), which makes execution fully
+ * deterministic. Conditional events ({@link Kernel.waitUntil}) are evaluated only when the next
+ * event would advance the clock, never mid-tick.
+ */
+export class Kernel {
+    /** Ticks per simulated second. */
+    ticksPerSecond;
+    tick = 0;
+    heap = new BinaryHeap(compareEvents);
+    nextSeq = 0;
+    nextLifoSeq = -1;
+    pendingEvents = 0;
+    conditions = [];
+    processed = 0;
+    /** How many events in a row have run without the clock moving. */
+    sameTickStreak = 0;
+    maxEventsPerTick;
+    maxEvents;
+    constructor(ticksPerSecond = DEFAULT_TICKS_PER_SECOND, limits = {}) {
+        if (!Number.isInteger(ticksPerSecond) || ticksPerSecond < 1) {
+            throw new RangeError(`ticksPerSecond must be a positive integer, got ${ticksPerSecond}`);
+        }
+        this.ticksPerSecond = ticksPerSecond;
+        this.maxEventsPerTick = limits.maxEventsPerTick ?? DEFAULT_MAX_EVENTS_PER_TICK;
+        this.maxEvents = limits.maxEvents ?? Infinity;
+    }
+    /** The current simulation time in ticks. */
+    get currentTick() {
+        return this.tick;
+    }
+    /** The current simulation time in seconds. */
+    get currentSeconds() {
+        return this.tick / this.ticksPerSecond;
+    }
+    /** Number of events waiting to fire (excludes cancelled events and unsatisfied conditions). */
+    get pendingCount() {
+        return this.pendingEvents;
+    }
+    /** Total number of events executed so far. */
+    get eventsProcessed() {
+        return this.processed;
+    }
+    /**
+     * Convert seconds to the nearest whole tick. Results are capped at the largest exactly representable
+     * tick count: a delay that long (about 285 years at the default resolution) means "never within this
+     * run", and an uncapped absurd value would overflow to Infinity and be rejected by {@link Kernel.schedule}.
+     */
+    secondsToTicks(seconds) {
+        return Math.min(Number.MAX_SAFE_INTEGER, Math.round(seconds * this.ticksPerSecond));
+    }
+    /** Convert ticks to seconds. */
+    ticksToSeconds(ticks) {
+        return ticks / this.ticksPerSecond;
+    }
+    /**
+     * Schedule `callback` to run `delayTicks` ticks from now.
+     * @param delayTicks non-negative integer
+     * @param priority lower runs first among events at the same tick (see {@link Priority})
+     */
+    schedule(delayTicks, priority, callback, options = {}) {
+        if (!Number.isInteger(delayTicks) || delayTicks < 0) {
+            throw new RangeError(`delayTicks must be a non-negative integer, got ${delayTicks}`);
+        }
+        const seq = options.lifo ? this.nextLifoSeq-- : this.nextSeq++;
+        const event = new ScheduledEvent(this.tick + delayTicks, priority, seq, callback, () => {
+            this.pendingEvents--;
+        });
+        this.pendingEvents++;
+        this.heap.push(event);
+        return event;
+    }
+    /**
+     * Register a condition. When `predicate()` first returns true — checked only when the clock is
+     * about to advance — `callback` is scheduled at the current tick with the given priority.
+     */
+    waitUntil(predicate, callback, priority = Priority.DEFAULT) {
+        const condition = new Condition(predicate, callback, priority);
+        this.conditions.push(condition);
+        return condition;
+    }
+    /** Execute the next event (advancing the clock if needed). Returns false if nothing is left to run. */
+    step() {
+        return this.stepUpTo(Infinity);
+    }
+    /** Execute all events with tick <= `tick`, then set the clock to `tick`. */
+    runUntil(tick) {
+        if (!Number.isFinite(tick) || tick < this.tick) {
+            throw new RangeError(`runUntil(${tick}) is before the current tick ${this.tick}`);
+        }
+        while (this.stepUpTo(tick)) {
+            /* keep going */
+        }
+        this.tick = tick;
+    }
+    /** Run for `durationSeconds` of simulated time from now. */
+    run(durationSeconds) {
+        this.runUntil(this.tick + this.secondsToTicks(durationSeconds));
+    }
+    peekLive() {
+        for (;;) {
+            const top = this.heap.peek();
+            if (top === undefined || top.state === PENDING)
+                return top;
+            this.heap.pop(); // discard cancelled
+        }
+    }
+    stepUpTo(limit) {
+        let next = this.peekLive();
+        if (next === undefined || next.tick > this.tick) {
+            // The clock is about to advance (or the queue is empty): evaluate conditions now.
+            if (this.conditions.length > 0 && this.fireReadyConditions())
+                next = this.peekLive();
+        }
+        if (next === undefined || next.tick > limit)
+            return false;
+        this.guardAgainstRunaway(next.tick);
+        this.heap.pop();
+        this.tick = next.tick;
+        next.state = FIRED;
+        this.pendingEvents--;
+        this.processed++;
+        next.callback();
+        return true;
+    }
+    /**
+     * Stop a model that can never finish. Events that keep scheduling more events at the same instant
+     * (a zero-delay loop) would otherwise run forever without the clock moving, so the run neither ends
+     * nor reports anything. The limits turn that into a clear error.
+     */
+    guardAgainstRunaway(nextTick) {
+        this.sameTickStreak = nextTick === this.tick ? this.sameTickStreak + 1 : 1;
+        if (this.sameTickStreak > this.maxEventsPerTick) {
+            throw new SimulationLimitError(`the simulation appears stuck: more than ${this.maxEventsPerTick.toLocaleString("en-US")} events ran at t=${this.ticksToSeconds(this.tick)} s without the clock advancing. ` +
+                "This usually means a loop with no delay in it, for example an interArrivalTime or retry baseDelay of 0 with nothing to stop it (add maxNumber or a delay).");
+        }
+        if (this.processed >= this.maxEvents) {
+            throw new SimulationLimitError(`the simulation reached its limit of ${this.maxEvents.toLocaleString("en-US")} events at t=${this.ticksToSeconds(this.tick)} s`);
+        }
+    }
+    fireReadyConditions() {
+        const current = this.conditions;
+        this.conditions = [];
+        const waiting = [];
+        let fired = false;
+        for (const c of current) {
+            if (c.state !== PENDING)
+                continue;
+            if (c.predicate()) {
+                c.state = FIRED;
+                this.schedule(0, c.priority, c.callback);
+                fired = true;
+            }
+            else {
+                waiting.push(c);
+            }
+        }
+        // Conditions registered by predicates during evaluation were pushed to the fresh array.
+        this.conditions = waiting.concat(this.conditions);
+        return fired;
+    }
+}
+//# sourceMappingURL=kernel.js.map

package/dist/kernel/kernel.js.map

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

package/dist/model/entity.d.ts

@@ -0,0 +1,78 @@
+import type { Kernel } from "../kernel/index.js";
+import { Rng, type SampleProvider, type SamplerSpec } from "../rng/index.js";
+/** A lightweight moving entity (a request or message) flowing through the model. */
+export interface MovingEntity {
+    /** Unique within a run. */
+    readonly id: number;
+    /** Tick at which the entity entered the model. */
+    readonly createdAt: number;
+    /** Free-form attributes for later phases. */
+    attributes: Record<string, unknown>;
+}
+/** Services the model provides to every component. */
+export interface SimContext {
+    readonly kernel: Kernel;
+    /** Create an RNG for the given stream id, derived from the run's seed. */
+    rng(streamId: string): Rng;
+    /** Create a new moving entity stamped with the current tick. */
+    createEntity(): MovingEntity;
+}
+/** What the model hands a component constructor. */
+export interface ComponentInit {
+    name: string;
+    /** Base RNG stream id (defaults to the component name). */
+    stream: string;
+    /** Validated inputs with defaults applied. */
+    inputs: Record<string, unknown>;
+}
+/** Base class: a model object with a unique name, created by the model. */
+export declare class Entity {
+    protected readonly ctx: SimContext;
+    readonly name: string;
+    constructor(ctx: SimContext, name: string);
+}
+/** An entity with a current state that tracks total time in each state since the last statistics reset. */
+export declare class StateEntity extends Entity {
+    private currentState;
+    private stateSince;
+    private readonly timeInState;
+    constructor(ctx: SimContext, name: string, initialState: string);
+    get state(): string;
+    protected setState(state: string): void;
+    /** Total seconds spent in `state` since the last statistics reset (including the ongoing stretch). */
+    secondsInState(state: string): number;
+    /** Clear accumulated statistics (called at the end of warm-up). */
+    resetStatistics(): void;
+}
+/** A component that receives entities and (usually) passes them on via `next`. */
+export declare class LinkedComponent extends StateEntity {
+    /** Downstream component, if linked. */
+    next: LinkedComponent | null;
+    protected readonly stream: string;
+    private added;
+    private completed;
+    private inProgress;
+    constructor(ctx: SimContext, init: ComponentInit, initialState: string);
+    /** Entities accepted since the last statistics reset. */
+    get numberAdded(): number;
+    /** Entities finished with (passed on, consumed or recorded) since the last statistics reset. */
+    get numberCompleted(): number;
+    /** Entities currently held by this component. */
+    get numberInProgress(): number;
+    /** Receive an entity. Components that do not accept pushed entities keep this default. */
+    addEntity(_entity: MovingEntity): void;
+    /** Wire a named link (see the component schema's `links`). Default handles `next`. */
+    setLink(key: string, target: LinkedComponent): void;
+    /** Called once after all links are wired, before the run starts. Schedule initial events here. */
+    start(): void;
+    protected noteAdded(): void;
+    protected noteCompleted(): void;
+    /** Mark `entity` completed here and hand it to `next` (it leaves the model if there is none). */
+    protected sendToNext(entity: MovingEntity): void;
+    /** A sampler on its own RNG stream, `<stream>/<purpose>`, so samplers never share numbers. */
+    protected makeSampler(spec: SamplerSpec, purpose: string): SampleProvider;
+    /** Convert a sampled time in seconds to whole ticks (negative samples clamp to 0). */
+    protected secondsToTicks(seconds: number): number;
+    resetStatistics(): void;
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/model/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/model/entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,GAAG,EAAiB,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE5F,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;IAC3B,gEAAgE;IAChE,YAAY,IAAI,YAAY,CAAC;CAC9B;AAED,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,2EAA2E;AAC3E,qBAAa,MAAM;IAEf,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBADF,GAAG,EAAE,UAAU,EACzB,IAAI,EAAE,MAAM;CAExB;AAED,2GAA2G;AAC3G,qBAAa,WAAY,SAAQ,MAAM;IACrC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;gBAE7C,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAM/D,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAWvC,sGAAsG;IACtG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAOrC,mEAAmE;IACnE,eAAe,IAAI,IAAI;CAIxB;AAED,kFAAkF;AAClF,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,uCAAuC;IACvC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAQ;IACpC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;gBAEX,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM;IAKtE,yDAAyD;IACzD,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,gGAAgG;IAChG,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,iDAAiD;IACjD,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,0FAA0F;IAC1F,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAItC,sFAAsF;IACtF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAInD,kGAAkG;IAClG,KAAK,IAAI,IAAI;IAEb,SAAS,CAAC,SAAS,IAAI,IAAI;IAK3B,SAAS,CAAC,aAAa,IAAI,IAAI;IAK/B,iGAAiG;IACjG,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAKhD,8FAA8F;IAC9F,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc;IAIzE,sFAAsF;IACtF,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIxC,eAAe,IAAI,IAAI;CAKjC"}

package/dist/model/entity.js

@@ -0,0 +1,108 @@
+import { createSampler } from "../rng/index.js";
+/** Base class: a model object with a unique name, created by the model. */
+export class Entity {
+    ctx;
+    name;
+    constructor(ctx, name) {
+        this.ctx = ctx;
+        this.name = name;
+    }
+}
+/** An entity with a current state that tracks total time in each state since the last statistics reset. */
+export class StateEntity extends Entity {
+    currentState;
+    stateSince;
+    timeInState = new Map();
+    constructor(ctx, name, initialState) {
+        super(ctx, name);
+        this.currentState = initialState;
+        this.stateSince = ctx.kernel.currentTick;
+    }
+    get state() {
+        return this.currentState;
+    }
+    setState(state) {
+        if (state === this.currentState)
+            return;
+        const now = this.ctx.kernel.currentTick;
+        this.timeInState.set(this.currentState, (this.timeInState.get(this.currentState) ?? 0) + (now - this.stateSince));
+        this.currentState = state;
+        this.stateSince = now;
+    }
+    /** Total seconds spent in `state` since the last statistics reset (including the ongoing stretch). */
+    secondsInState(state) {
+        const now = this.ctx.kernel.currentTick;
+        let ticks = this.timeInState.get(state) ?? 0;
+        if (state === this.currentState)
+            ticks += now - this.stateSince;
+        return this.ctx.kernel.ticksToSeconds(ticks);
+    }
+    /** Clear accumulated statistics (called at the end of warm-up). */
+    resetStatistics() {
+        this.timeInState.clear();
+        this.stateSince = this.ctx.kernel.currentTick;
+    }
+}
+/** A component that receives entities and (usually) passes them on via `next`. */
+export class LinkedComponent extends StateEntity {
+    /** Downstream component, if linked. */
+    next = null;
+    stream;
+    added = 0;
+    completed = 0;
+    inProgress = 0;
+    constructor(ctx, init, initialState) {
+        super(ctx, init.name, initialState);
+        this.stream = init.stream;
+    }
+    /** Entities accepted since the last statistics reset. */
+    get numberAdded() {
+        return this.added;
+    }
+    /** Entities finished with (passed on, consumed or recorded) since the last statistics reset. */
+    get numberCompleted() {
+        return this.completed;
+    }
+    /** Entities currently held by this component. */
+    get numberInProgress() {
+        return this.inProgress;
+    }
+    /** Receive an entity. Components that do not accept pushed entities keep this default. */
+    addEntity(_entity) {
+        throw new Error(`${this.name} does not accept entities directly`);
+    }
+    /** Wire a named link (see the component schema's `links`). Default handles `next`. */
+    setLink(key, target) {
+        if (key === "next")
+            this.next = target;
+    }
+    /** Called once after all links are wired, before the run starts. Schedule initial events here. */
+    start() { }
+    noteAdded() {
+        this.added++;
+        this.inProgress++;
+    }
+    noteCompleted() {
+        this.completed++;
+        this.inProgress--;
+    }
+    /** Mark `entity` completed here and hand it to `next` (it leaves the model if there is none). */
+    sendToNext(entity) {
+        this.noteCompleted();
+        this.next?.addEntity(entity);
+    }
+    /** A sampler on its own RNG stream, `<stream>/<purpose>`, so samplers never share numbers. */
+    makeSampler(spec, purpose) {
+        return createSampler(spec, this.ctx.rng(`${this.stream}/${purpose}`));
+    }
+    /** Convert a sampled time in seconds to whole ticks (negative samples clamp to 0). */
+    secondsToTicks(seconds) {
+        return Math.max(0, this.ctx.kernel.secondsToTicks(seconds));
+    }
+    resetStatistics() {
+        super.resetStatistics();
+        this.added = 0;
+        this.completed = 0;
+    }
+}
+//# sourceMappingURL=entity.js.map

package/dist/model/entity.js.map

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

package/dist/model/fifo.d.ts

@@ -0,0 +1,9 @@
+/** O(1) amortised FIFO buffer. @internal */
+export declare class FifoBuffer<T> {
+    private items;
+    private head;
+    get length(): number;
+    push(item: T): void;
+    shift(): T | undefined;
+}
+//# sourceMappingURL=fifo.d.ts.map

package/dist/model/fifo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fifo.d.ts","sourceRoot":"","sources":["../../src/model/fifo.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,IAAI,CAAK;IAEjB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAInB,KAAK,IAAI,CAAC,GAAG,SAAS;CAWvB"}

package/dist/model/fifo.js

@@ -0,0 +1,24 @@
+/** O(1) amortised FIFO buffer. @internal */
+export class FifoBuffer {
+    items = [];
+    head = 0;
+    get length() {
+        return this.items.length - this.head;
+    }
+    push(item) {
+        this.items.push(item);
+    }
+    shift() {
+        if (this.head >= this.items.length)
+            return undefined;
+        const item = this.items[this.head];
+        this.items[this.head] = undefined;
+        this.head++;
+        if (this.head > 1024 && this.head * 2 > this.items.length) {
+            this.items = this.items.slice(this.head);
+            this.head = 0;
+        }
+        return item;
+    }
+}
+//# sourceMappingURL=fifo.js.map

package/dist/model/fifo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fifo.js","sourceRoot":"","sources":["../../src/model/fifo.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,OAAO,UAAU;IACb,KAAK,GAAQ,EAAE,CAAC;IAChB,IAAI,GAAG,CAAC,CAAC;IAEjB,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC;IACvC,CAAC;IAED,IAAI,CAAC,IAAO;QACV,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,SAAc,CAAC;QACvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC1D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/model/index.d.ts

@@ -0,0 +1,4 @@
+export { Entity, StateEntity, LinkedComponent } from "./entity.js";
+export type { MovingEntity, SimContext, ComponentInit } from "./entity.js";
+export { FifoBuffer } from "./fifo.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/model/index.js

@@ -0,0 +1,3 @@
+export { Entity, StateEntity, LinkedComponent } from "./entity.js";
+export { FifoBuffer } from "./fifo.js";
+//# sourceMappingURL=index.js.map

package/dist/model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}