@chronon-sim/engine 0.1.0

package/dist/schema/validate.js.map

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

package/dist/stats/index.d.ts

@@ -0,0 +1,6 @@
+export { TimeWeightedStat } from "./time-weighted.js";
+export { ExactPercentileTracker, Tally } from "./percentile.js";
+export type { PercentileTracker } from "./percentile.js";
+export { summarize, tQuantile975 } from "./summary.js";
+export type { SampleSummary } from "./summary.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stats/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAChE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/stats/index.js

@@ -0,0 +1,4 @@
+export { TimeWeightedStat } from "./time-weighted.js";
+export { ExactPercentileTracker, Tally } from "./percentile.js";
+export { summarize, tQuantile975 } from "./summary.js";
+//# sourceMappingURL=index.js.map

package/dist/stats/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stats/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/stats/percentile.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Collects observations and answers mean/percentile queries. Implementations may be exact or
+ * approximate (e.g. a future t-digest or HDR histogram) behind this interface.
+ */
+export interface PercentileTracker {
+    /** Record one observation. */
+    add(value: number): void;
+    /** Number of observations recorded. */
+    readonly count: number;
+    /** Arithmetic mean, or NaN if empty. */
+    mean(): number;
+    /** The p-th percentile for p in [0, 100], or NaN if empty. */
+    percentile(p: number): number;
+    /** Discard all observations. */
+    reset(): void;
+}
+/** Exact tracker: stores every sample and sorts lazily at query time (linear interpolation). */
+export declare class ExactPercentileTracker implements PercentileTracker {
+    private samples;
+    private sum;
+    private sorted;
+    add(value: number): void;
+    get count(): number;
+    mean(): number;
+    percentile(p: number): number;
+    reset(): void;
+}
+/** Running count/mean/min/max of observations (no storage). */
+export declare class Tally {
+    count: number;
+    private sum;
+    min: number;
+    max: number;
+    add(value: number): void;
+    mean(): number;
+    reset(): void;
+}
+//# sourceMappingURL=percentile.d.ts.map

package/dist/stats/percentile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"percentile.d.ts","sourceRoot":"","sources":["../../src/stats/percentile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,IAAI,IAAI,MAAM,CAAC;IACf,8DAA8D;IAC9D,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,gCAAgC;IAChC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,gGAAgG;AAChG,qBAAa,sBAAuB,YAAW,iBAAiB;IAC9D,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,MAAM,CAAQ;IAEtB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMxB,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,IAAI,MAAM;IAId,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAe7B,KAAK,IAAI,IAAI;CAKd;AAED,+DAA+D;AAC/D,qBAAa,KAAK;IAChB,KAAK,SAAK;IACV,OAAO,CAAC,GAAG,CAAK;IAChB,GAAG,SAA4B;IAC/B,GAAG,SAA4B;IAE/B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOxB,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,IAAI;CAMd"}

package/dist/stats/percentile.js

@@ -0,0 +1,62 @@
+/** Exact tracker: stores every sample and sorts lazily at query time (linear interpolation). */
+export class ExactPercentileTracker {
+    samples = [];
+    sum = 0;
+    sorted = true;
+    add(value) {
+        this.samples.push(value);
+        this.sum += value;
+        this.sorted = false;
+    }
+    get count() {
+        return this.samples.length;
+    }
+    mean() {
+        return this.samples.length === 0 ? NaN : this.sum / this.samples.length;
+    }
+    percentile(p) {
+        const n = this.samples.length;
+        if (n === 0 || !(p >= 0 && p <= 100))
+            return NaN;
+        if (!this.sorted) {
+            this.samples.sort((a, b) => a - b);
+            this.sorted = true;
+        }
+        const rank = (p / 100) * (n - 1);
+        const lo = Math.floor(rank);
+        const hi = Math.ceil(rank);
+        const a = this.samples[lo];
+        const b = this.samples[hi];
+        return a + (b - a) * (rank - lo);
+    }
+    reset() {
+        this.samples = [];
+        this.sum = 0;
+        this.sorted = true;
+    }
+}
+/** Running count/mean/min/max of observations (no storage). */
+export class Tally {
+    count = 0;
+    sum = 0;
+    min = Number.POSITIVE_INFINITY;
+    max = Number.NEGATIVE_INFINITY;
+    add(value) {
+        this.count++;
+        this.sum += value;
+        if (value < this.min)
+            this.min = value;
+        if (value > this.max)
+            this.max = value;
+    }
+    mean() {
+        return this.count === 0 ? NaN : this.sum / this.count;
+    }
+    reset() {
+        this.count = 0;
+        this.sum = 0;
+        this.min = Number.POSITIVE_INFINITY;
+        this.max = Number.NEGATIVE_INFINITY;
+    }
+}
+//# sourceMappingURL=percentile.js.map

package/dist/stats/percentile.js.map

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

package/dist/stats/summary.d.ts

@@ -0,0 +1,20 @@
+/** The 0.975 quantile of Student's t distribution with `df` degrees of freedom. */
+export declare function tQuantile975(df: number): number;
+/** Summary of a sample of per-replication values. */
+export interface SampleSummary {
+    /** Number of finite values summarised. */
+    n: number;
+    /** Sample mean, or null if n = 0. */
+    mean: number | null;
+    /** Sample standard deviation, or null if n < 2. */
+    stdDev: number | null;
+    /** 95% confidence interval for the mean (Student t), or null if n < 2. */
+    ci95: {
+        low: number;
+        high: number;
+        halfWidth: number;
+    } | null;
+}
+/** Mean, standard deviation and 95% t-confidence interval of `values` (non-finite values ignored). */
+export declare function summarize(values: readonly number[]): SampleSummary;
+//# sourceMappingURL=summary.d.ts.map

package/dist/stats/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/stats/summary.ts"],"names":[],"mappings":"AAOA,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAe/C;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,CAAC,EAAE,MAAM,CAAC;IACV,qCAAqC;IACrC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0EAA0E;IAC1E,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC/D;AAED,sGAAsG;AACtG,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CAUlE"}

package/dist/stats/summary.js

@@ -0,0 +1,38 @@
+/** Two-sided 95% critical values of Student's t for df = 1..30. */
+const T_975 = [
+    12.7062, 4.3027, 3.1824, 2.7764, 2.5706, 2.4469, 2.3646, 2.306, 2.2622, 2.2281, 2.201, 2.1788,
+    2.1604, 2.1448, 2.1314, 2.1199, 2.1098, 2.1009, 2.093, 2.086, 2.0796, 2.0739, 2.0687, 2.0639,
+    2.0595, 2.0555, 2.0518, 2.0484, 2.0452, 2.0423,
+];
+/** The 0.975 quantile of Student's t distribution with `df` degrees of freedom. */
+export function tQuantile975(df) {
+    if (!(df >= 1))
+        return NaN;
+    const d = Math.floor(df);
+    if (d <= 30)
+        return T_975[d - 1];
+    // Cornish–Fisher expansion around the normal quantile; error < 1e-4 for df > 30.
+    const z = 1.959964;
+    const z3 = z ** 3;
+    const z5 = z ** 5;
+    const z7 = z ** 7;
+    return (z +
+        (z3 + z) / (4 * d) +
+        (5 * z5 + 16 * z3 + 3 * z) / (96 * d * d) +
+        (3 * z7 + 19 * z5 + 17 * z3 - 15 * z) / (384 * d ** 3));
+}
+/** Mean, standard deviation and 95% t-confidence interval of `values` (non-finite values ignored). */
+export function summarize(values) {
+    const xs = values.filter((v) => Number.isFinite(v));
+    const n = xs.length;
+    if (n === 0)
+        return { n, mean: null, stdDev: null, ci95: null };
+    const mean = xs.reduce((a, b) => a + b, 0) / n;
+    if (n < 2)
+        return { n, mean, stdDev: null, ci95: null };
+    const variance = xs.reduce((a, b) => a + (b - mean) ** 2, 0) / (n - 1);
+    const stdDev = Math.sqrt(variance);
+    const halfWidth = tQuantile975(n - 1) * (stdDev / Math.sqrt(n));
+    return { n, mean, stdDev, ci95: { low: mean - halfWidth, high: mean + halfWidth, halfWidth } };
+}
+//# sourceMappingURL=summary.js.map

package/dist/stats/summary.js.map

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

package/dist/stats/time-weighted.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Time-weighted statistic of a piecewise-constant signal (e.g. queue length, busy workers).
+ *
+ * The mean is the integral of the value over time divided by elapsed time — not an average of
+ * samples. Call {@link set} whenever the value changes.
+ */
+export declare class TimeWeightedStat {
+    private value;
+    private lastTick;
+    private startTick;
+    private area;
+    private maxValue;
+    constructor(startTick?: number, initialValue?: number);
+    /** The current value of the signal. */
+    get current(): number;
+    /** Record that the signal changes to `value` at time `tick` (ticks must not decrease). */
+    set(tick: number, value: number): void;
+    /** Change the value by `delta` at time `tick`. */
+    add(tick: number, delta: number): void;
+    /** Time-weighted mean over [start, tick]. Returns the current value if no time has elapsed. */
+    mean(tick: number): number;
+    /** Integral of the signal over [start, tick] in value-ticks (e.g. busy-worker-ticks). */
+    integral(tick: number): number;
+    /** Largest value that persisted for a positive duration, up to `tick` (or the current value if none). */
+    max(tick: number): number;
+    /** Total time (ticks) covered since the last reset, up to `tick`. */
+    elapsed(tick: number): number;
+    /** Restart accumulation at `tick`, keeping the current value. */
+    reset(tick: number): void;
+}
+//# sourceMappingURL=time-weighted.d.ts.map

package/dist/stats/time-weighted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-weighted.d.ts","sourceRoot":"","sources":["../../src/stats/time-weighted.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,QAAQ,CAAS;gBAEb,SAAS,SAAI,EAAE,YAAY,SAAI;IAO3C,uCAAuC;IACvC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,0FAA0F;IAC1F,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAWtC,kDAAkD;IAClD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAItC,+FAA+F;IAC/F,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAM1B,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,yGAAyG;IACzG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMzB,qEAAqE;IACrE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI7B,iEAAiE;IACjE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAM1B"}

package/dist/stats/time-weighted.js

@@ -0,0 +1,69 @@
+/**
+ * Time-weighted statistic of a piecewise-constant signal (e.g. queue length, busy workers).
+ *
+ * The mean is the integral of the value over time divided by elapsed time — not an average of
+ * samples. Call {@link set} whenever the value changes.
+ */
+export class TimeWeightedStat {
+    value;
+    lastTick;
+    startTick;
+    area = 0;
+    maxValue;
+    constructor(startTick = 0, initialValue = 0) {
+        this.value = initialValue;
+        this.lastTick = startTick;
+        this.startTick = startTick;
+        this.maxValue = Number.NEGATIVE_INFINITY;
+    }
+    /** The current value of the signal. */
+    get current() {
+        return this.value;
+    }
+    /** Record that the signal changes to `value` at time `tick` (ticks must not decrease). */
+    set(tick, value) {
+        if (tick > this.lastTick) {
+            this.area += this.value * (tick - this.lastTick);
+            // Only values that persisted for a positive duration count towards the maximum, so
+            // transient same-tick values (e.g. enqueue-then-immediately-dequeue) are ignored.
+            if (this.value > this.maxValue)
+                this.maxValue = this.value;
+            this.lastTick = tick;
+        }
+        this.value = value;
+    }
+    /** Change the value by `delta` at time `tick`. */
+    add(tick, delta) {
+        this.set(tick, this.value + delta);
+    }
+    /** Time-weighted mean over [start, tick]. Returns the current value if no time has elapsed. */
+    mean(tick) {
+        const elapsed = tick - this.startTick;
+        if (elapsed <= 0)
+            return this.value;
+        return (this.area + this.value * (tick - this.lastTick)) / elapsed;
+    }
+    /** Integral of the signal over [start, tick] in value-ticks (e.g. busy-worker-ticks). */
+    integral(tick) {
+        return this.area + this.value * Math.max(0, tick - this.lastTick);
+    }
+    /** Largest value that persisted for a positive duration, up to `tick` (or the current value if none). */
+    max(tick) {
+        let m = this.maxValue;
+        if (tick > this.lastTick && this.value > m)
+            m = this.value;
+        return m === Number.NEGATIVE_INFINITY ? this.value : m;
+    }
+    /** Total time (ticks) covered since the last reset, up to `tick`. */
+    elapsed(tick) {
+        return Math.max(0, tick - this.startTick);
+    }
+    /** Restart accumulation at `tick`, keeping the current value. */
+    reset(tick) {
+        this.startTick = tick;
+        this.lastTick = tick;
+        this.area = 0;
+        this.maxValue = Number.NEGATIVE_INFINITY;
+    }
+}
+//# sourceMappingURL=time-weighted.js.map

package/dist/stats/time-weighted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-weighted.js","sourceRoot":"","sources":["../../src/stats/time-weighted.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IACnB,KAAK,CAAS;IACd,QAAQ,CAAS;IACjB,SAAS,CAAS;IAClB,IAAI,GAAG,CAAC,CAAC;IACT,QAAQ,CAAS;IAEzB,YAAY,SAAS,GAAG,CAAC,EAAE,YAAY,GAAG,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAC3C,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,0FAA0F;IAC1F,GAAG,CAAC,IAAY,EAAE,KAAa;QAC7B,IAAI,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjD,mFAAmF;YACnF,kFAAkF;YAClF,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;YAC3D,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,kDAAkD;IAClD,GAAG,CAAC,IAAY,EAAE,KAAa;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,+FAA+F;IAC/F,IAAI,CAAC,IAAY;QACf,MAAM,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QACtC,IAAI,OAAO,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC;IACrE,CAAC;IAED,yFAAyF;IACzF,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpE,CAAC;IAED,yGAAyG;IACzG,GAAG,CAAC,IAAY;QACd,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACtB,IAAI,IAAI,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC;YAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QAC3D,OAAO,CAAC,KAAK,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,qEAAqE;IACrE,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAC3C,CAAC;CACF"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@chronon-sim/engine",
+  "version": "0.1.0",
+  "description": "Chronon Sim engine: a discrete event simulator for cloud and distributed systems (queues, worker pools, retries, autoscaling). No DOM or Node APIs, no runtime dependencies.",
+  "keywords": [
+    "simulation",
+    "discrete-event",
+    "queueing",
+    "capacity-planning",
+    "sqs",
+    "lambda",
+    "autoscaling"
+  ],
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/NiloyBhattacharjee/chronon-sim#readme",
+  "bugs": {
+    "url": "https://github.com/NiloyBhattacharjee/chronon-sim/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NiloyBhattacharjee/chronon-sim.git",
+    "directory": "packages/engine"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {}
+}