@benchkit/chart 0.1.0

package/dist/leaderboard.test.js

@@ -0,0 +1,105 @@
+import { describe, it } from "node:test";
+import * as assert from "node:assert/strict";
+import { rankSeries, getWinner } from "./leaderboard.js";
+function makeSeriesFile(direction, entries) {
+    const series = {};
+    for (const [name, values] of Object.entries(entries)) {
+        series[name] = {
+            points: values.map((v, i) => ({ timestamp: `2025-01-0${i + 1}T00:00:00Z`, value: v })),
+        };
+    }
+    return { metric: "test", direction, series };
+}
+describe("rankSeries", () => {
+    it("smaller_is_better: lowest value is rank 1", () => {
+        const sf = makeSeriesFile("smaller_is_better", {
+            fast: [100, 90],
+            slow: [200, 210],
+            medium: [150, 140],
+        });
+        const ranked = rankSeries(sf);
+        assert.equal(ranked[0].name, "fast");
+        assert.equal(ranked[0].rank, 1);
+        assert.equal(ranked[0].isWinner, true);
+        assert.equal(ranked[1].name, "medium");
+        assert.equal(ranked[2].name, "slow");
+    });
+    it("bigger_is_better: highest value is rank 1", () => {
+        const sf = makeSeriesFile("bigger_is_better", {
+            low: [10, 12],
+            high: [50, 55],
+            mid: [30, 35],
+        });
+        const ranked = rankSeries(sf);
+        assert.equal(ranked[0].name, "high");
+        assert.equal(ranked[0].rank, 1);
+        assert.equal(ranked[0].isWinner, true);
+        assert.equal(ranked[1].name, "mid");
+        assert.equal(ranked[2].name, "low");
+    });
+    it("no direction: lowest value is rank 1 (neutral)", () => {
+        const sf = makeSeriesFile(undefined, {
+            a: [30],
+            b: [10],
+            c: [20],
+        });
+        const ranked = rankSeries(sf);
+        assert.equal(ranked[0].name, "b");
+        assert.equal(ranked[0].rank, 1);
+    });
+    it("calculates delta from previous point", () => {
+        const sf = makeSeriesFile("smaller_is_better", {
+            series1: [100, 80],
+        });
+        const [r] = rankSeries(sf);
+        assert.equal(r.latestValue, 80);
+        assert.equal(r.previousValue, 100);
+        assert.equal(r.delta, -20);
+    });
+    it("delta is undefined for series with a single point", () => {
+        const sf = makeSeriesFile("smaller_is_better", {
+            series1: [100],
+        });
+        const [r] = rankSeries(sf);
+        assert.equal(r.previousValue, undefined);
+        assert.equal(r.delta, undefined);
+    });
+    it("excludes series with no data points", () => {
+        const sf = {
+            metric: "test",
+            series: {
+                empty: { points: [] },
+                filled: { points: [{ timestamp: "2025-01-01T00:00:00Z", value: 42 }] },
+            },
+        };
+        const ranked = rankSeries(sf);
+        assert.equal(ranked.length, 1);
+        assert.equal(ranked[0].name, "filled");
+    });
+    it("returns empty array when all series are empty", () => {
+        const sf = { metric: "test", series: {} };
+        const ranked = rankSeries(sf);
+        assert.deepEqual(ranked, []);
+    });
+    it("single series returns rank 1 with isWinner true", () => {
+        const sf = makeSeriesFile("smaller_is_better", { only: [42] });
+        const [r] = rankSeries(sf);
+        assert.equal(r.rank, 1);
+        assert.equal(r.isWinner, true);
+    });
+});
+describe("getWinner", () => {
+    it("returns the name of the rank-1 series", () => {
+        const sf = makeSeriesFile("smaller_is_better", {
+            a: [100],
+            b: [50],
+            c: [200],
+        });
+        assert.equal(getWinner(sf), "b");
+    });
+    it("returns undefined when no series have data", () => {
+        const sf = { metric: "test", series: {} };
+        assert.equal(getWinner(sf), undefined);
+    });
+});
+//# sourceMappingURL=leaderboard.test.js.map

package/dist/leaderboard.test.js.map

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

package/dist/sample-utils.d.ts

@@ -0,0 +1,4 @@
+import type { Sample } from "@benchkit/format";
+/** Returns every metric key present in the sample array (all keys except `t`). */
+export declare function extractSampleMetrics(samples: Sample[]): string[];
+//# sourceMappingURL=sample-utils.d.ts.map

package/dist/sample-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample-utils.d.ts","sourceRoot":"","sources":["../src/sample-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAQhE"}

package/dist/sample-utils.js

@@ -0,0 +1,12 @@
+/** Returns every metric key present in the sample array (all keys except `t`). */
+export function extractSampleMetrics(samples) {
+    const keys = new Set();
+    for (const sample of samples) {
+        for (const key of Object.keys(sample)) {
+            if (key !== "t")
+                keys.add(key);
+        }
+    }
+    return [...keys];
+}
+//# sourceMappingURL=sample-utils.js.map

package/dist/sample-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sample-utils.js","sourceRoot":"","sources":["../src/sample-utils.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,UAAU,oBAAoB,CAAC,OAAiB;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,IAAI,GAAG,KAAK,GAAG;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC"}