@benchkit/chart 0.1.0

package/dist/date-range.test.js

@@ -0,0 +1,116 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { presetToDateRange, filterSeriesFileByDateRange, } from "./components/DateRangeFilter.js";
+function makeSeries(timestamps) {
+    return {
+        metric: "latency_ms",
+        unit: "ms",
+        direction: "smaller_is_better",
+        series: {
+            "series-a": {
+                points: timestamps.map((ts) => ({ timestamp: ts, value: 10 })),
+            },
+        },
+    };
+}
+describe("presetToDateRange", () => {
+    const now = new Date("2026-03-15T12:00:00Z");
+    it("returns 7 days back for '7d'", () => {
+        const range = presetToDateRange("7d", now);
+        assert.ok(range.start);
+        assert.equal(range.end, null);
+        const start = new Date(range.start);
+        assert.equal(start.toISOString(), "2026-03-08T12:00:00.000Z");
+    });
+    it("returns 30 days back for '30d'", () => {
+        const range = presetToDateRange("30d", now);
+        assert.ok(range.start);
+        const start = new Date(range.start);
+        assert.equal(start.toISOString(), "2026-02-13T12:00:00.000Z");
+    });
+    it("returns 90 days back for '90d'", () => {
+        const range = presetToDateRange("90d", now);
+        assert.ok(range.start);
+        const start = new Date(range.start);
+        assert.equal(start.toISOString(), "2025-12-15T12:00:00.000Z");
+    });
+    it("returns null start/end for 'all'", () => {
+        const range = presetToDateRange("all", now);
+        assert.equal(range.start, null);
+        assert.equal(range.end, null);
+    });
+});
+describe("filterSeriesFileByDateRange", () => {
+    it("returns all data when range is 'all' (null start/end)", () => {
+        const sf = makeSeries(["2026-01-01T00:00:00Z", "2026-03-01T00:00:00Z"]);
+        const filtered = filterSeriesFileByDateRange(sf, { start: null, end: null });
+        assert.equal(Object.keys(filtered.series).length, 1);
+        assert.equal(filtered.series["series-a"].points.length, 2);
+    });
+    it("filters points before the start date", () => {
+        const sf = makeSeries([
+            "2026-01-01T00:00:00Z",
+            "2026-02-01T00:00:00Z",
+            "2026-03-01T00:00:00Z",
+            "2026-03-10T00:00:00Z",
+        ]);
+        const range = { start: "2026-02-15T00:00:00Z", end: null };
+        const filtered = filterSeriesFileByDateRange(sf, range);
+        assert.equal(filtered.series["series-a"].points.length, 2);
+        assert.equal(filtered.series["series-a"].points[0].timestamp, "2026-03-01T00:00:00Z");
+    });
+    it("filters points after the end date", () => {
+        const sf = makeSeries([
+            "2026-01-01T00:00:00Z",
+            "2026-02-01T00:00:00Z",
+            "2026-03-01T00:00:00Z",
+        ]);
+        const range = { start: null, end: "2026-01-15T00:00:00Z" };
+        const filtered = filterSeriesFileByDateRange(sf, range);
+        assert.equal(filtered.series["series-a"].points.length, 1);
+    });
+    it("removes series entirely if all points are outside the range", () => {
+        const sf = makeSeries(["2025-01-01T00:00:00Z", "2025-06-01T00:00:00Z"]);
+        const range = { start: "2026-01-01T00:00:00Z", end: null };
+        const filtered = filterSeriesFileByDateRange(sf, range);
+        assert.equal(Object.keys(filtered.series).length, 0);
+    });
+    it("preserves the original series file metadata", () => {
+        const sf = makeSeries(["2026-03-01T00:00:00Z"]);
+        const filtered = filterSeriesFileByDateRange(sf, { start: "2026-01-01T00:00:00Z", end: null });
+        assert.equal(filtered.metric, "latency_ms");
+        assert.equal(filtered.unit, "ms");
+        assert.equal(filtered.direction, "smaller_is_better");
+    });
+    it("does not mutate the original series file", () => {
+        const sf = makeSeries(["2025-01-01T00:00:00Z", "2026-03-01T00:00:00Z"]);
+        const range = { start: "2026-01-01T00:00:00Z", end: null };
+        filterSeriesFileByDateRange(sf, range);
+        assert.equal(sf.series["series-a"].points.length, 2);
+    });
+    it("handles multiple series independently", () => {
+        const sf = {
+            metric: "latency_ms",
+            unit: "ms",
+            direction: "smaller_is_better",
+            series: {
+                "series-a": {
+                    points: [
+                        { timestamp: "2026-01-01T00:00:00Z", value: 10 },
+                        { timestamp: "2026-03-01T00:00:00Z", value: 20 },
+                    ],
+                },
+                "series-b": {
+                    points: [
+                        { timestamp: "2026-03-05T00:00:00Z", value: 30 },
+                    ],
+                },
+            },
+        };
+        const range = { start: "2026-02-01T00:00:00Z", end: null };
+        const filtered = filterSeriesFileByDateRange(sf, range);
+        assert.equal(filtered.series["series-a"].points.length, 1);
+        assert.equal(filtered.series["series-b"].points.length, 1);
+    });
+});
+//# sourceMappingURL=date-range.test.js.map

package/dist/date-range.test.js.map

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

package/dist/embed.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Standalone embed entry point for @benchkit/chart.
+ *
+ * Include via `<script>` tag with data attributes:
+ *
+ * ```html
+ * <div id="benchkit-chart"></div>
+ * <script
+ *   type="module"
+ *   src="https://cdn.example.com/@benchkit/chart/embed.js"
+ *   data-target="#benchkit-chart"
+ *   data-owner="strawgate"
+ *   data-repo="benchkit"
+ *   data-branch="bench-data"
+ *   data-mode="dashboard"
+ * ></script>
+ * ```
+ *
+ * Supported modes: "dashboard" (default), "trend", "leaderboard"
+ *
+ * This module does NOT handle cross-file joins or arbitrary queries.
+ * It renders a single chart surface from the configured data source.
+ */
+import { type DataSource } from "./fetch.js";
+export type EmbedMode = "dashboard" | "trend" | "leaderboard";
+export interface EmbedOptions {
+    /** CSS selector or HTMLElement for the mount target. */
+    target: string | HTMLElement;
+    /** Data source configuration. */
+    source: DataSource;
+    /** Which surface to render. Default: "dashboard". */
+    mode?: EmbedMode;
+    /** Metric name (required for "trend" and "leaderboard" modes). */
+    metric?: string;
+    /** Maximum data points for trend charts. Default: 30. */
+    maxPoints?: number;
+    /** Regression threshold percentage. Default: 10. */
+    regressionThreshold?: number;
+}
+/**
+ * Mount a benchkit chart into the given target element.
+ * Returns a dispose function that unmounts the component.
+ */
+export declare function mount(options: EmbedOptions): () => void;
+//# sourceMappingURL=embed.d.ts.map

package/dist/embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAI1D,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,aAAa,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7B,iCAAiC;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB,qDAAqD;IACrD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI,CA2CvD"}

package/dist/embed.js

@@ -0,0 +1,170 @@
+/**
+ * Standalone embed entry point for @benchkit/chart.
+ *
+ * Include via `<script>` tag with data attributes:
+ *
+ * ```html
+ * <div id="benchkit-chart"></div>
+ * <script
+ *   type="module"
+ *   src="https://cdn.example.com/@benchkit/chart/embed.js"
+ *   data-target="#benchkit-chart"
+ *   data-owner="strawgate"
+ *   data-repo="benchkit"
+ *   data-branch="bench-data"
+ *   data-mode="dashboard"
+ * ></script>
+ * ```
+ *
+ * Supported modes: "dashboard" (default), "trend", "leaderboard"
+ *
+ * This module does NOT handle cross-file joins or arbitrary queries.
+ * It renders a single chart surface from the configured data source.
+ */
+import { render, h } from "preact";
+import { useState, useEffect } from "preact/hooks";
+import { Dashboard } from "./Dashboard.js";
+import { fetchSeries } from "./fetch.js";
+import { TrendChart } from "./components/TrendChart.js";
+import { Leaderboard } from "./components/Leaderboard.js";
+/**
+ * Mount a benchkit chart into the given target element.
+ * Returns a dispose function that unmounts the component.
+ */
+export function mount(options) {
+    const el = typeof options.target === "string"
+        ? document.querySelector(options.target)
+        : options.target;
+    if (!el || !(el instanceof HTMLElement)) {
+        throw new Error(`benchkit embed: target "${options.target}" not found or not an HTMLElement`);
+    }
+    const source = options.source;
+    const mode = options.mode ?? "dashboard";
+    let vnode;
+    if (mode === "dashboard") {
+        vnode = h(Dashboard, {
+            source,
+            maxPoints: options.maxPoints ?? 30,
+            regressionThreshold: options.regressionThreshold ?? 10,
+        });
+    }
+    else if (mode === "trend") {
+        vnode = h(EmbedTrend, {
+            source,
+            metric: options.metric ?? "",
+            maxPoints: options.maxPoints ?? 30,
+        });
+    }
+    else if (mode === "leaderboard") {
+        vnode = h(EmbedLeaderboard, {
+            source,
+            metric: options.metric ?? "",
+        });
+    }
+    else {
+        throw new Error(`benchkit embed: unknown mode "${mode}"`);
+    }
+    render(vnode, el);
+    return () => {
+        render(null, el);
+    };
+}
+// ── Internal wrapper components for single-metric embeds ─────────────
+function EmbedTrend({ source, metric, maxPoints, }) {
+    const [seriesFile, setSeriesFile] = useState(null);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        if (!metric) {
+            setError("No metric specified for trend chart");
+            return;
+        }
+        const ctrl = new AbortController();
+        fetchSeries(source, metric, ctrl.signal)
+            .then((sf) => {
+            if (!ctrl.signal.aborted)
+                setSeriesFile(sf);
+        })
+            .catch((err) => {
+            if (!ctrl.signal.aborted)
+                setError(String(err));
+        });
+        return () => ctrl.abort();
+    }, [source.owner, source.repo, source.branch, source.baseUrl, metric]);
+    if (error)
+        return h("div", { class: "bk-state" }, error);
+    if (!seriesFile)
+        return h("div", { class: "bk-loading" }, "Loading…");
+    return h(TrendChart, {
+        series: seriesFile,
+        maxPoints,
+    });
+}
+function EmbedLeaderboard({ source, metric, }) {
+    const [seriesFile, setSeriesFile] = useState(null);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        if (!metric) {
+            setError("No metric specified for leaderboard");
+            return;
+        }
+        const ctrl = new AbortController();
+        fetchSeries(source, metric, ctrl.signal)
+            .then((sf) => {
+            if (!ctrl.signal.aborted)
+                setSeriesFile(sf);
+        })
+            .catch((err) => {
+            if (!ctrl.signal.aborted)
+                setError(String(err));
+        });
+        return () => ctrl.abort();
+    }, [source.owner, source.repo, source.branch, source.baseUrl, metric]);
+    if (error)
+        return h("div", { class: "bk-state" }, error);
+    if (!seriesFile)
+        return h("div", { class: "bk-loading" }, "Loading…");
+    return h(Leaderboard, { series: seriesFile });
+}
+// ── Auto-mount from script tag ───────────────────────────────────────
+/**
+ * Parse data attributes from the current `<script>` tag and auto-mount.
+ * Called automatically when loaded as a `<script type="module">`.
+ */
+function autoMount() {
+    const script = document.currentScript;
+    if (!script)
+        return;
+    const target = script.getAttribute("data-target");
+    if (!target)
+        return;
+    const source = {};
+    const owner = script.getAttribute("data-owner");
+    const repo = script.getAttribute("data-repo");
+    const branch = script.getAttribute("data-branch");
+    const baseUrl = script.getAttribute("data-base-url");
+    if (owner)
+        source.owner = owner;
+    if (repo)
+        source.repo = repo;
+    if (branch)
+        source.branch = branch;
+    if (baseUrl)
+        source.baseUrl = baseUrl;
+    const mode = (script.getAttribute("data-mode") ?? "dashboard");
+    const metric = script.getAttribute("data-metric") ?? undefined;
+    const maxPoints = script.getAttribute("data-max-points");
+    const threshold = script.getAttribute("data-regression-threshold");
+    mount({
+        target,
+        source,
+        mode,
+        metric,
+        maxPoints: maxPoints ? parseInt(maxPoints, 10) : undefined,
+        regressionThreshold: threshold ? parseFloat(threshold) : undefined,
+    });
+}
+// Auto-mount when loaded as a module script in the browser.
+if (typeof document !== "undefined") {
+    autoMount();
+}
+//# sourceMappingURL=embed.js.map

package/dist/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,MAAM,EAAuB,CAAC,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAmB1D;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,OAAqB;IACzC,MAAM,EAAE,GACN,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;QAChC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC;QACxC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAErB,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,YAAY,WAAW,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,2BAA2B,OAAO,CAAC,MAAM,mCAAmC,CAC7E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IAEzC,IAAI,KAAqB,CAAC;IAE1B,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,KAAK,GAAG,CAAC,CAAC,SAAS,EAAE;YACnB,MAAM;YACN,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;YAClC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,EAAE;SACvD,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,KAAK,GAAG,CAAC,CAAC,UAAU,EAAE;YACpB,MAAM;YACN,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;SACnC,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAClC,KAAK,GAAG,CAAC,CAAC,gBAAgB,EAAE;YAC1B,MAAM;YACN,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAElB,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC;AAED,wEAAwE;AAExE,SAAS,UAAU,CAAC,EAClB,MAAM,EACN,MAAM,EACN,SAAS,GAKV;IACC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAoB,IAAI,CAAC,CAAC;IACtE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAExD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,QAAQ,CAAC,qCAAqC,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;aACrC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;YACX,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,aAAa,CAAC,EAAE,CAAC,CAAC;QAC9C,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAEvE,IAAI,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU;QAAE,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,UAAU,CAAC,CAAC;IAEtE,OAAO,CAAC,CAAC,UAAU,EAAE;QACnB,MAAM,EAAE,UAAU;QAClB,SAAS;KACV,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,EACxB,MAAM,EACN,MAAM,GAIP;IACC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAoB,IAAI,CAAC,CAAC;IACtE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAExD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,QAAQ,CAAC,qCAAqC,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;aACrC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;YACX,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,aAAa,CAAC,EAAE,CAAC,CAAC;QAC9C,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QACL,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAEvE,IAAI,KAAK;QAAE,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU;QAAE,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,UAAU,CAAC,CAAC;IAEtE,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,wEAAwE;AAExE;;;GAGG;AACH,SAAS,SAAS;IAChB,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAErD,IAAI,KAAK;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAChC,IAAI,IAAI;QAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAC7B,IAAI,MAAM;QAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACnC,IAAI,OAAO;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAEtC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,WAAW,CAAc,CAAC;IAC5E,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,SAAS,CAAC;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,2BAA2B,CAAC,CAAC;IAEnE,KAAK,CAAC;QACJ,MAAM;QACN,MAAM;QACN,IAAI;QACJ,MAAM;QACN,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QAC1D,mBAAmB,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;KACnE,CAAC,CAAC;AACL,CAAC;AAED,4DAA4D;AAC5D,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;IACpC,SAAS,EAAE,CAAC;AACd,CAAC"}

package/dist/embed.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=embed.test.d.ts.map

package/dist/embed.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.test.d.ts","sourceRoot":"","sources":["../src/embed.test.ts"],"names":[],"mappings":""}

package/dist/embed.test.js

@@ -0,0 +1,15 @@
+import { describe, it } from "node:test";
+import * as assert from "node:assert/strict";
+/**
+ * The embed module is designed for browser execution (uses `document`,
+ * `render()`, etc.), so we test the exported API shape and types here.
+ * Full integration tests require a browser environment.
+ */
+describe("embed module exports", () => {
+    it("exports mount function and types", async () => {
+        // Verify the module can be imported and has the expected shape.
+        const mod = await import("./embed.js");
+        assert.equal(typeof mod.mount, "function");
+    });
+});
+//# sourceMappingURL=embed.test.js.map

package/dist/embed.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.test.js","sourceRoot":"","sources":["../src/embed.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAE7C;;;;GAIG;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,gEAAgE;QAChE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/fetch.d.ts

@@ -0,0 +1,27 @@
+import type { IndexFile, SeriesFile, PrIndexEntry, RefIndexEntry, MetricSummaryEntry, OtlpMetricsDocument } from "@octo11y/core";
+import type { RunDetailView, ComparisonResult, ThresholdConfig } from "@benchkit/format";
+export interface DataSource {
+    owner?: string;
+    repo?: string;
+    branch?: string;
+    /** Absolute URL override — if set, owner/repo/branch are ignored. */
+    baseUrl?: string;
+}
+export declare function rawUrl(ds: DataSource, filePath: string): string;
+export declare function fetchIndex(ds: DataSource, signal?: AbortSignal): Promise<IndexFile>;
+export declare function fetchSeries(ds: DataSource, metric: string, signal?: AbortSignal): Promise<SeriesFile>;
+export declare function fetchRun(ds: DataSource, runId: string, signal?: AbortSignal): Promise<OtlpMetricsDocument>;
+export declare function fetchPrIndex(ds: DataSource, signal?: AbortSignal): Promise<PrIndexEntry[]>;
+export declare function fetchRefIndex(ds: DataSource, signal?: AbortSignal): Promise<RefIndexEntry[]>;
+export declare function fetchMetricSummary(ds: DataSource, signal?: AbortSignal): Promise<MetricSummaryEntry[]>;
+export declare function fetchRunDetail(ds: DataSource, runId: string, signal?: AbortSignal): Promise<RunDetailView>;
+/**
+ * Fetch two run detail views, convert to BenchmarkResult, and compare.
+ * Returns the comparison result plus both detail views for downstream use.
+ */
+export declare function compareRuns(ds: DataSource, currentRunId: string, baselineRunId: string, threshold?: ThresholdConfig, signal?: AbortSignal): Promise<{
+    comparison: ComparisonResult;
+    currentDetail: RunDetailView;
+    baselineDetail: RunDetailView;
+}>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACjI,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGzF,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAa/D;AASD,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAEnF;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAErG;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAE1G;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAE1F;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAE5F;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAEtG;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAE1G;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,EAAE,EAAE,UAAU,EACd,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,eAAe,EAC3B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,UAAU,EAAE,gBAAgB,CAAC;IAAC,aAAa,EAAE,aAAa,CAAC;IAAC,cAAc,EAAE,aAAa,CAAA;CAAE,CAAC,CASxG"}

package/dist/fetch.js

@@ -0,0 +1,73 @@
+import { compareRuns as compare, buildOtlpResult, MetricsBatch, DEFAULT_DATA_BRANCH } from "@benchkit/format";
+export function rawUrl(ds, filePath) {
+    if (ds.baseUrl) {
+        let base = ds.baseUrl;
+        while (base.endsWith("/"))
+            base = base.slice(0, -1);
+        let path = filePath;
+        while (path.startsWith("/"))
+            path = path.slice(1);
+        return `${base}/${path}`;
+    }
+    if (!ds.owner || !ds.repo) {
+        throw new Error("DataSource must have either baseUrl or owner+repo");
+    }
+    const branch = ds.branch ?? DEFAULT_DATA_BRANCH;
+    return `https://raw.githubusercontent.com/${ds.owner}/${ds.repo}/${branch}/${filePath}`;
+}
+async function fetchJson(ds, filePath, signal) {
+    const url = rawUrl(ds, filePath);
+    const res = await fetch(url, { signal });
+    if (!res.ok)
+        throw new Error(`Failed to fetch ${url}: ${res.status}`);
+    return res.json();
+}
+export function fetchIndex(ds, signal) {
+    return fetchJson(ds, "data/index.json", signal);
+}
+export function fetchSeries(ds, metric, signal) {
+    return fetchJson(ds, `data/series/${metric}.json`, signal);
+}
+export function fetchRun(ds, runId, signal) {
+    return fetchJson(ds, `data/runs/${runId}.json`, signal);
+}
+export function fetchPrIndex(ds, signal) {
+    return fetchJson(ds, "data/index/prs.json", signal);
+}
+export function fetchRefIndex(ds, signal) {
+    return fetchJson(ds, "data/index/refs.json", signal);
+}
+export function fetchMetricSummary(ds, signal) {
+    return fetchJson(ds, "data/index/metrics.json", signal);
+}
+export function fetchRunDetail(ds, runId, signal) {
+    return fetchJson(ds, `data/views/runs/${runId}/detail.json`, signal);
+}
+/**
+ * Fetch two run detail views, convert to BenchmarkResult, and compare.
+ * Returns the comparison result plus both detail views for downstream use.
+ */
+export async function compareRuns(ds, currentRunId, baselineRunId, threshold, signal) {
+    const [currentDetail, baselineDetail] = await Promise.all([
+        fetchRunDetail(ds, currentRunId, signal),
+        fetchRunDetail(ds, baselineRunId, signal),
+    ]);
+    const currentBatch = detailViewToBatch(currentDetail);
+    const baselineBatch = detailViewToBatch(baselineDetail);
+    const comparison = compare(currentBatch, [baselineBatch], threshold);
+    return { comparison, currentDetail, baselineDetail };
+}
+/** Convert a RunDetailView directly to MetricsBatch. */
+function detailViewToBatch(detail) {
+    const benchmarks = detail.metricSnapshots.flatMap((snap) => snap.values.map((v) => ({
+        name: v.name,
+        tags: v.tags,
+        metrics: { [snap.metric]: { value: v.value, unit: v.unit, direction: v.direction } },
+    })));
+    const doc = buildOtlpResult({
+        benchmarks,
+        context: { sourceFormat: "otlp" },
+    });
+    return MetricsBatch.fromOtlp(doc);
+}
+//# sourceMappingURL=fetch.js.map

package/dist/fetch.js.map

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

package/dist/fetch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fetch.test.d.ts.map

package/dist/fetch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.test.d.ts","sourceRoot":"","sources":["../src/fetch.test.ts"],"names":[],"mappings":""}

package/dist/fetch.test.js

@@ -0,0 +1,75 @@
+import { describe, it } from "node:test";
+import * as assert from "node:assert/strict";
+import { rawUrl } from "./fetch.js";
+import { DEFAULT_DATA_BRANCH } from "@benchkit/format";
+describe("fetch", () => {
+    it("constructs correct raw URLs", () => {
+        const ds = { owner: "strawgate", repo: "benchkit", branch: "bench-data" };
+        const url = rawUrl(ds, "data/index.json");
+        assert.equal(url, "https://raw.githubusercontent.com/strawgate/benchkit/bench-data/data/index.json");
+    });
+    it("defaults to bench-data branch", () => {
+        const ds = { owner: "foo", repo: "bar" };
+        const url = rawUrl(ds, "data/index.json");
+        assert.equal(url, `https://raw.githubusercontent.com/foo/bar/${DEFAULT_DATA_BRANCH}/data/index.json`);
+    });
+    it("baseUrl overrides GitHub raw URL construction", () => {
+        const ds = { baseUrl: "https://my-server.example.com/data" };
+        const url = rawUrl(ds, "data/index.json");
+        assert.equal(url, "https://my-server.example.com/data/data/index.json");
+    });
+    it("baseUrl ignores owner/repo/branch when set", () => {
+        const ds = {
+            owner: "strawgate",
+            repo: "benchkit",
+            branch: "main",
+            baseUrl: "https://custom.host/files",
+        };
+        const url = rawUrl(ds, "data/series/ns_per_op.json");
+        assert.equal(url, "https://custom.host/files/data/series/ns_per_op.json");
+    });
+    it("baseUrl with trailing slashes is normalized", () => {
+        const ds = { baseUrl: "https://my-server.example.com/data///" };
+        const url = rawUrl(ds, "data/index.json");
+        assert.equal(url, "https://my-server.example.com/data/data/index.json");
+    });
+    it("throws when neither baseUrl nor owner+repo provided", () => {
+        const ds = {};
+        assert.throws(() => rawUrl(ds, "data/index.json"), { message: "DataSource must have either baseUrl or owner+repo" });
+    });
+    it("throws when only owner is provided without repo", () => {
+        const ds = { owner: "foo" };
+        assert.throws(() => rawUrl(ds, "data/index.json"), { message: "DataSource must have either baseUrl or owner+repo" });
+    });
+    it("constructs correct URL for prs index", () => {
+        const ds = { owner: "strawgate", repo: "benchkit", branch: "bench-data" };
+        const url = rawUrl(ds, "data/index/prs.json");
+        assert.equal(url, "https://raw.githubusercontent.com/strawgate/benchkit/bench-data/data/index/prs.json");
+    });
+    it("constructs correct URL for refs index", () => {
+        const ds = { owner: "strawgate", repo: "benchkit", branch: "bench-data" };
+        const url = rawUrl(ds, "data/index/refs.json");
+        assert.equal(url, "https://raw.githubusercontent.com/strawgate/benchkit/bench-data/data/index/refs.json");
+    });
+    it("constructs correct URL for metrics index", () => {
+        const ds = { owner: "strawgate", repo: "benchkit", branch: "bench-data" };
+        const url = rawUrl(ds, "data/index/metrics.json");
+        assert.equal(url, "https://raw.githubusercontent.com/strawgate/benchkit/bench-data/data/index/metrics.json");
+    });
+    it("constructs correct URL for run detail view", () => {
+        const ds = { owner: "strawgate", repo: "benchkit", branch: "bench-data" };
+        const url = rawUrl(ds, "data/views/runs/123456789-1/detail.json");
+        assert.equal(url, "https://raw.githubusercontent.com/strawgate/benchkit/bench-data/data/views/runs/123456789-1/detail.json");
+    });
+    it("constructs correct URL for prs index with baseUrl", () => {
+        const ds = { baseUrl: "https://my-server.example.com/data" };
+        const url = rawUrl(ds, "data/index/prs.json");
+        assert.equal(url, "https://my-server.example.com/data/data/index/prs.json");
+    });
+    it("constructs correct URL for run detail view with baseUrl", () => {
+        const ds = { baseUrl: "https://my-server.example.com/data" };
+        const url = rawUrl(ds, "data/views/runs/abc-1/detail.json");
+        assert.equal(url, "https://my-server.example.com/data/data/views/runs/abc-1/detail.json");
+    });
+});
+//# sourceMappingURL=fetch.test.js.map

package/dist/fetch.test.js.map

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

package/dist/format-utils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Shared formatting utilities used across chart components.
+ */
+/**
+ * Format a numeric value for display.
+ *
+ * When `compact` is true, large numbers are abbreviated (e.g. 1.2K).
+ * Otherwise values ≥ 100 show no decimals, smaller values show up to 2.
+ */
+export declare function formatValue(value: number, compact?: boolean): string;
+/**
+ * Format a numeric value with fixed decimal places.
+ *
+ * Integers get no decimals, values ≥ 100 get 1 decimal, others get 2.
+ * Unlike {@link formatValue} this uses `toFixed` so trailing zeros are
+ * preserved (useful in tabular data where column alignment matters).
+ */
+export declare function formatFixedValue(value: number): string;
+/**
+ * Format a git ref for human-readable display.
+ *
+ * Strips common prefixes (`refs/heads/`, `refs/tags/`, `refs/pull/…/merge`)
+ * and returns a short label. Returns `"—"` for undefined/empty refs.
+ */
+export declare function formatRef(ref: string | undefined): string;
+/**
+ * Format a percentage change with sign.
+ *
+ * Positive values get a `+` prefix, negative values keep their `-`.
+ */
+export declare function formatPct(pct: number): string;
+/**
+ * Format a run timestamp for compact UI display.
+ *
+ * Returns the original input when it is not a valid date string.
+ */
+export declare function formatTimestamp(iso: string): string;
+/**
+ * Format a commit SHA as a short display-friendly hash.
+ *
+ * Returns an en dash when no commit is available.
+ */
+export declare function shortCommit(commit?: string): string;
+/**
+ * Format metric direction semantics for human-readable UI copy.
+ */
+export declare function formatDirection(direction: string): string;
+//# sourceMappingURL=format-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format-utils.d.ts","sourceRoot":"","sources":["../src/format-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,MAAM,CAKlE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAItD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQzD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASnD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAUzD"}