@benchkit/chart 0.1.0

package/dist/format-utils.js

@@ -0,0 +1,98 @@
+/**
+ * Shared formatting utilities used across chart components.
+ */
+const compactFormatter = new Intl.NumberFormat("en-US", {
+    notation: "compact",
+    maximumFractionDigits: 1,
+});
+/**
+ * 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 function formatValue(value, compact = false) {
+    if (compact)
+        return compactFormatter.format(value);
+    return value.toLocaleString("en-US", {
+        maximumFractionDigits: value >= 100 ? 0 : 2,
+    });
+}
+/**
+ * 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 function formatFixedValue(value) {
+    if (Number.isInteger(value))
+        return value.toFixed(0);
+    if (Math.abs(value) >= 100)
+        return value.toFixed(1);
+    return value.toFixed(2);
+}
+/**
+ * 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 function formatRef(ref) {
+    if (!ref)
+        return "—";
+    const prMatch = /^refs\/pull\/(\d+)\/merge$/.exec(ref);
+    if (prMatch)
+        return `PR #${prMatch[1]}`;
+    if (ref.startsWith("refs/heads/"))
+        return ref.replace("refs/heads/", "");
+    if (ref.startsWith("refs/tags/"))
+        return `tag ${ref.replace("refs/tags/", "")}`;
+    return ref;
+}
+/**
+ * Format a percentage change with sign.
+ *
+ * Positive values get a `+` prefix, negative values keep their `-`.
+ */
+export function formatPct(pct) {
+    const sign = pct > 0 ? "+" : "";
+    return `${sign}${pct.toFixed(2)}%`;
+}
+/**
+ * Format a run timestamp for compact UI display.
+ *
+ * Returns the original input when it is not a valid date string.
+ */
+export function formatTimestamp(iso) {
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime()))
+        return iso;
+    return date.toLocaleDateString(undefined, {
+        month: "short",
+        day: "numeric",
+        hour: "2-digit",
+        minute: "2-digit",
+    });
+}
+/**
+ * Format a commit SHA as a short display-friendly hash.
+ *
+ * Returns an en dash when no commit is available.
+ */
+export function shortCommit(commit) {
+    return commit ? commit.slice(0, 7) : "–";
+}
+/**
+ * Format metric direction semantics for human-readable UI copy.
+ */
+export function formatDirection(direction) {
+    if (direction === "smaller_is_better") {
+        return "↓ smaller";
+    }
+    if (direction === "bigger_is_better") {
+        return "↑ bigger";
+    }
+    return direction ? `? ${direction}` : "unknown";
+}
+//# sourceMappingURL=format-utils.js.map

package/dist/format-utils.js.map

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

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

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

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

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

package/dist/format-utils.test.js

@@ -0,0 +1,103 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { formatDirection, formatFixedValue, formatPct, formatRef, formatTimestamp, formatValue, shortCommit, } from "./format-utils.js";
+describe("format-utils", () => {
+    describe("formatValue", () => {
+        it("formats large values without decimals", () => {
+            assert.equal(formatValue(1234), "1,234");
+        });
+        it("formats small values with up to 2 decimals", () => {
+            const result = formatValue(3.14159);
+            assert.ok(result.includes("3.14"), `Expected "3.14" in "${result}"`);
+        });
+        it("formats values in compact mode", () => {
+            const result = formatValue(1500, true);
+            assert.ok(result.includes("1.5K") || result.includes("2K"), `Expected compact notation in "${result}"`);
+        });
+        it("formats zero", () => {
+            assert.equal(formatValue(0), "0");
+        });
+    });
+    describe("formatFixedValue", () => {
+        it("shows integers without decimals", () => {
+            assert.equal(formatFixedValue(320), "320");
+        });
+        it("shows 1 decimal for large floats", () => {
+            assert.equal(formatFixedValue(1234.567), "1234.6");
+        });
+        it("shows 2 decimals for small floats", () => {
+            assert.equal(formatFixedValue(3.14159), "3.14");
+        });
+        it("shows 0 decimals for integer zero", () => {
+            assert.equal(formatFixedValue(0), "0");
+        });
+    });
+    describe("formatRef", () => {
+        it("formats PR merge refs", () => {
+            assert.equal(formatRef("refs/pull/42/merge"), "PR #42");
+        });
+        it("strips refs/heads/ prefix", () => {
+            assert.equal(formatRef("refs/heads/main"), "main");
+        });
+        it("formats tag refs", () => {
+            assert.equal(formatRef("refs/tags/v1.0.0"), "tag v1.0.0");
+        });
+        it("returns unknown refs as-is", () => {
+            assert.equal(formatRef("some/other/ref"), "some/other/ref");
+        });
+        it("returns em-dash for undefined", () => {
+            assert.equal(formatRef(undefined), "—");
+        });
+        it("returns em-dash for empty string", () => {
+            assert.equal(formatRef(""), "—");
+        });
+    });
+    describe("formatPct", () => {
+        it("adds + sign for positive values", () => {
+            assert.equal(formatPct(12.345), "+12.35%");
+        });
+        it("preserves - sign for negative values", () => {
+            assert.equal(formatPct(-7.891), "-7.89%");
+        });
+        it("shows no sign for zero", () => {
+            assert.equal(formatPct(0), "0.00%");
+        });
+    });
+    describe("formatTimestamp", () => {
+        it("returns a formatted string for valid ISO dates", () => {
+            const result = formatTimestamp("2026-04-01T10:30:00Z");
+            assert.ok(typeof result === "string");
+            assert.ok(result.length > 0);
+            assert.notEqual(result, "2026-04-01T10:30:00Z");
+        });
+        it("returns raw input for invalid dates", () => {
+            assert.equal(formatTimestamp("not-a-date"), "not-a-date");
+        });
+    });
+    describe("shortCommit", () => {
+        it("truncates to 7 characters", () => {
+            assert.equal(shortCommit("abc123def456"), "abc123d");
+        });
+        it("returns a dash for undefined", () => {
+            assert.equal(shortCommit(undefined), "–");
+        });
+        it("handles short commits", () => {
+            assert.equal(shortCommit("abc"), "abc");
+        });
+    });
+    describe("formatDirection", () => {
+        it("formats smaller-is-better directions", () => {
+            assert.equal(formatDirection("smaller_is_better"), "↓ smaller");
+        });
+        it("formats bigger-is-better directions", () => {
+            assert.equal(formatDirection("bigger_is_better"), "↑ bigger");
+        });
+        it("shows a clear fallback for unknown directions", () => {
+            assert.equal(formatDirection("sideways_is_better"), "? sideways_is_better");
+        });
+        it("shows unknown when no direction is provided", () => {
+            assert.equal(formatDirection(""), "unknown");
+        });
+    });
+});
+//# sourceMappingURL=format-utils.test.js.map

package/dist/format-utils.test.js.map

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

package/dist/hooks/useChartLifecycle.d.ts

@@ -0,0 +1,20 @@
+import type { RefObject } from "preact";
+import { type ChartType, type ChartConfiguration } from "chart.js";
+import { type ChartTheme } from "../theme.js";
+export interface ChartLifecycleResult {
+    canvasRef: RefObject<HTMLCanvasElement>;
+    wrapperRef: RefObject<HTMLDivElement>;
+}
+/**
+ * Shared Chart.js lifecycle hook.
+ *
+ * Manages canvas/wrapper refs, chart creation, updates, and cleanup.
+ * The caller provides a builder function that receives the theme and
+ * returns `null` (skip render) or a chart configuration.
+ *
+ * @param builder - Called on each effect run. Return null to destroy the chart,
+ *   or return { type, data, options } to create/update it.
+ * @param deps - Dependency array for the effect (same semantics as useEffect).
+ */
+export declare function useChartLifecycle<T extends ChartType>(builder: (theme: ChartTheme) => ChartConfiguration<T> | null, deps: unknown[]): ChartLifecycleResult;
+//# sourceMappingURL=useChartLifecycle.d.ts.map

package/dist/hooks/useChartLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChartLifecycle.d.ts","sourceRoot":"","sources":["../../src/hooks/useChartLifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,kBAAkB,EACxB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IACxC,UAAU,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,SAAS,EACnD,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI,EAC5D,IAAI,EAAE,OAAO,EAAE,GACd,oBAAoB,CAiCtB"}

package/dist/hooks/useChartLifecycle.js

@@ -0,0 +1,46 @@
+import { useRef, useEffect } from "preact/hooks";
+import { Chart, } from "chart.js";
+import { getChartTheme } from "../theme.js";
+/**
+ * Shared Chart.js lifecycle hook.
+ *
+ * Manages canvas/wrapper refs, chart creation, updates, and cleanup.
+ * The caller provides a builder function that receives the theme and
+ * returns `null` (skip render) or a chart configuration.
+ *
+ * @param builder - Called on each effect run. Return null to destroy the chart,
+ *   or return { type, data, options } to create/update it.
+ * @param deps - Dependency array for the effect (same semantics as useEffect).
+ */
+export function useChartLifecycle(builder, deps) {
+    const wrapperRef = useRef(null);
+    const canvasRef = useRef(null);
+    const chartRef = useRef(null);
+    useEffect(() => {
+        if (!canvasRef.current || !wrapperRef.current)
+            return;
+        const theme = getChartTheme(wrapperRef.current);
+        const config = builder(theme);
+        if (!config) {
+            chartRef.current?.destroy();
+            chartRef.current = null;
+            return;
+        }
+        if (chartRef.current) {
+            chartRef.current.data = config.data;
+            if (config.options)
+                chartRef.current.options = config.options;
+            chartRef.current.update();
+        }
+        else {
+            chartRef.current = new Chart(canvasRef.current, config);
+        }
+        return () => {
+            chartRef.current?.destroy();
+            chartRef.current = null;
+        };
+        // eslint-disable-next-line
+    }, deps);
+    return { canvasRef, wrapperRef };
+}
+//# sourceMappingURL=useChartLifecycle.js.map

package/dist/hooks/useChartLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChartLifecycle.js","sourceRoot":"","sources":["../../src/hooks/useChartLifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EACL,KAAK,GAGN,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAmB,MAAM,aAAa,CAAC;AAO7D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA4D,EAC5D,IAAe;IAEf,MAAM,UAAU,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,MAAM,CAAoB,IAAI,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,MAAM,CAAkB,IAAI,CAAC,CAAC;IAE/C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO;YAAE,OAAO;QAEtD,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAE9B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;YAC5B,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,OAAO;QACT,CAAC;QAED,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACpC,IAAI,MAAM,CAAC,OAAO;gBAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAgB,CAAC;YACvE,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,OAAO,GAAG,IAAI,KAAK,CAAI,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;YAC5B,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,CAAC,CAAC;QACF,2BAA2B;IAC7B,CAAC,EAAE,IAAI,CAAC,CAAC;IAET,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AACnC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export { TrendChart, type TrendChartProps } from "./components/TrendChart.js";
+export { ComparisonChart, type ComparisonChartProps } from "./components/ComparisonChart.js";
+export { SampleChart, type SampleChartProps } from "./components/SampleChart.js";
+export { ComparisonBar, type ComparisonBarProps } from "./components/ComparisonBar.js";
+export { RunTable, type RunTableProps } from "./components/RunTable.js";
+export { MonitorSection, type MonitorSectionProps } from "./components/MonitorSection.js";
+export { TagFilter, type TagFilterProps, extractTags, filterSeriesFile } from "./components/TagFilter.js";
+export { DateRangeFilter, type DateRangeFilterProps, type DateRangePreset, type DateRange, presetToDateRange, filterSeriesFileByDateRange } from "./components/DateRangeFilter.js";
+export { Leaderboard, type LeaderboardProps } from "./components/Leaderboard.js";
+export { VerdictBanner, type VerdictBannerProps } from "./components/VerdictBanner.js";
+export { ComparisonSummaryTable, type ComparisonSummaryTableProps } from "./components/ComparisonSummaryTable.js";
+export { RunSelector, type RunSelectorProps } from "./components/RunSelector.js";
+export { Dashboard, type DashboardProps } from "./Dashboard.js";
+export { RunDashboard, type RunDashboardProps } from "./RunDashboard.js";
+export { RunDetail, type RunDetailProps, type MetricSnapshotCardProps, MetricSnapshotCard } from "./RunDetail.js";
+export { type DashboardLabels, defaultDashboardLabels, resolveLabels } from "./dashboard-labels.js";
+export { formatValue, formatFixedValue, formatRef, formatPct, formatTimestamp, shortCommit, formatDirection, } from "./format-utils.js";
+export { fetchIndex, fetchSeries, fetchRun, fetchPrIndex, fetchRefIndex, fetchMetricSummary, fetchRunDetail, compareRuns, type DataSource } from "./fetch.js";
+export { rankSeries, getWinner, type RankedEntry } from "./leaderboard.js";
+export { useChartLifecycle, type ChartLifecycleResult } from "./hooks/useChartLifecycle.js";
+export { detectRegressions, regressionTooltip, type RegressionResult } from "./utils.js";
+export { defaultMetricLabel, defaultMonitorMetricLabel, isMonitorMetric } from "./labels.js";
+export { samplesToDataPoints, dataPointsToComparisonData } from "./comparison-transforms.js";
+export { extractSampleMetrics } from "./sample-utils.js";
+export { transformSeriesDataset, partitionSeriesMap, applyDateRangeToMap, detectAllRegressions, partitionSnapshots, type DatasetAggregate, type DatasetFilter, type TransformSeriesDatasetOptions, } from "./dataset-transforms.js";
+export { mount, type EmbedOptions, type EmbedMode } from "./embed.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC1G,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AACnL,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,KAAK,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAClH,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGlH,OAAO,EAAE,KAAK,eAAe,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGpG,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,eAAe,EACf,WAAW,EACX,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAG9J,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,6BAA6B,GACnC,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+// Components
+export { TrendChart } from "./components/TrendChart.js";
+export { ComparisonChart } from "./components/ComparisonChart.js";
+export { SampleChart } from "./components/SampleChart.js";
+export { ComparisonBar } from "./components/ComparisonBar.js";
+export { RunTable } from "./components/RunTable.js";
+export { MonitorSection } from "./components/MonitorSection.js";
+export { TagFilter, extractTags, filterSeriesFile } from "./components/TagFilter.js";
+export { DateRangeFilter, presetToDateRange, filterSeriesFileByDateRange } from "./components/DateRangeFilter.js";
+export { Leaderboard } from "./components/Leaderboard.js";
+export { VerdictBanner } from "./components/VerdictBanner.js";
+export { ComparisonSummaryTable } from "./components/ComparisonSummaryTable.js";
+export { RunSelector } from "./components/RunSelector.js";
+export { Dashboard } from "./Dashboard.js";
+export { RunDashboard } from "./RunDashboard.js";
+export { RunDetail, MetricSnapshotCard } from "./RunDetail.js";
+// Label customization
+export { defaultDashboardLabels, resolveLabels } from "./dashboard-labels.js";
+// Shared formatting utilities
+export { formatValue, formatFixedValue, formatRef, formatPct, formatTimestamp, shortCommit, formatDirection, } from "./format-utils.js";
+// Data fetching
+export { fetchIndex, fetchSeries, fetchRun, fetchPrIndex, fetchRefIndex, fetchMetricSummary, fetchRunDetail, compareRuns } from "./fetch.js";
+// Ranking utilities
+export { rankSeries, getWinner } from "./leaderboard.js";
+// Hooks
+export { useChartLifecycle } from "./hooks/useChartLifecycle.js";
+// Utilities
+export { detectRegressions, regressionTooltip } from "./utils.js";
+export { defaultMetricLabel, defaultMonitorMetricLabel, isMonitorMetric } from "./labels.js";
+export { samplesToDataPoints, dataPointsToComparisonData } from "./comparison-transforms.js";
+export { extractSampleMetrics } from "./sample-utils.js";
+// Dataset-local transform layer
+export { transformSeriesDataset, partitionSeriesMap, applyDateRangeToMap, detectAllRegressions, partitionSnapshots, } from "./dataset-transforms.js";
+// Embed API (also available via @benchkit/chart/embed)
+export { mount } from "./embed.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAAE,UAAU,EAAwB,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,eAAe,EAA6B,MAAM,iCAAiC,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAsB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,cAAc,EAA4B,MAAM,gCAAgC,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAuB,WAAW,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC1G,OAAO,EAAE,eAAe,EAAmE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AACnL,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,aAAa,EAA2B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAoC,MAAM,wCAAwC,CAAC;AAClH,OAAO,EAAE,WAAW,EAAyB,MAAM,6BAA6B,CAAC;AACjF,OAAO,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAqD,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAElH,sBAAsB;AACtB,OAAO,EAAwB,sBAAsB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEpG,8BAA8B;AAC9B,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,eAAe,EACf,WAAW,EACX,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,gBAAgB;AAChB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,cAAc,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAE9J,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAoB,MAAM,kBAAkB,CAAC;AAC3E,QAAQ;AACR,OAAO,EAAE,iBAAiB,EAA6B,MAAM,8BAA8B,CAAC;AAC5F,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAyB,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,gCAAgC;AAChC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GAInB,MAAM,yBAAyB,CAAC;AAEjC,uDAAuD;AACvD,OAAO,EAAE,KAAK,EAAqC,MAAM,YAAY,CAAC"}

package/dist/index.test.d.ts

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

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

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

package/dist/index.test.js

@@ -0,0 +1,10 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { formatDirection } from "./index.js";
+describe("package root exports", () => {
+    it("exports formatDirection", () => {
+        assert.equal(formatDirection("smaller_is_better"), "↓ smaller");
+        assert.equal(formatDirection("bigger_is_better"), "↑ bigger");
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,mBAAmB,CAAC,EAAE,WAAW,CAAC,CAAC;QAChE,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,kBAAkB,CAAC,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/labels.d.ts

@@ -0,0 +1,5 @@
+export declare function defaultMetricLabel(metric: string): string;
+/** Returns true when the metric name belongs to the monitor action's output. */
+export declare function isMonitorMetric(metric: string): boolean;
+export declare function defaultMonitorMetricLabel(metric: string): string;
+//# sourceMappingURL=labels.d.ts.map

package/dist/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"AAoBA,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWhE"}

package/dist/labels.js

@@ -0,0 +1,41 @@
+const MONITOR_METRIC_LABELS = {
+    cpu_system_ms: "CPU system time (ms)",
+    cpu_system_pct: "CPU system %",
+    cpu_user_ms: "CPU user time (ms)",
+    cpu_user_pct: "CPU user %",
+    final_rss_kb: "Final RSS (KB)",
+    involuntary_ctx_switches: "Involuntary context switches",
+    io_read_bytes: "I/O read bytes",
+    io_write_bytes: "I/O write bytes",
+    load_avg_1m_max: "Peak load average (1m)",
+    mem_available_min_mb: "Lowest available memory (MB)",
+    peak_rss_kb: "Peak RSS (KB)",
+    voluntary_ctx_switches: "Voluntary context switches",
+    wall_clock_ms: "Wall clock time (ms)",
+};
+function titleCase(input) {
+    return input.replace(/\b[a-z]/g, (match) => match.toUpperCase());
+}
+export function defaultMetricLabel(metric) {
+    if (metric.startsWith("_monitor/")) {
+        return defaultMonitorMetricLabel(metric);
+    }
+    return metric
+        .replace(/_per_/g, "/")
+        .replace(/_/g, " ");
+}
+/** Returns true when the metric name belongs to the monitor action's output. */
+export function isMonitorMetric(metric) {
+    return metric.startsWith("_monitor/");
+}
+export function defaultMonitorMetricLabel(metric) {
+    const raw = metric.replace(/^_monitor\//, "");
+    if (MONITOR_METRIC_LABELS[raw]) {
+        return MONITOR_METRIC_LABELS[raw];
+    }
+    if (raw.startsWith("process/")) {
+        return `Process ${titleCase(raw.replace(/^process\//, "").replace(/_/g, " "))}`;
+    }
+    return titleCase(raw.replace(/\//g, " ").replace(/_/g, " "));
+}
+//# sourceMappingURL=labels.js.map

package/dist/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,GAA2B;IACpD,aAAa,EAAE,sBAAsB;IACrC,cAAc,EAAE,cAAc;IAC9B,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,YAAY;IAC1B,YAAY,EAAE,gBAAgB;IAC9B,wBAAwB,EAAE,8BAA8B;IACxD,aAAa,EAAE,gBAAgB;IAC/B,cAAc,EAAE,iBAAiB;IACjC,eAAe,EAAE,wBAAwB;IACzC,oBAAoB,EAAE,8BAA8B;IACpD,WAAW,EAAE,eAAe;IAC5B,sBAAsB,EAAE,4BAA4B;IACpD,aAAa,EAAE,sBAAsB;CACtC,CAAC;AAEF,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,IAAI,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,OAAO,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,MAAM;SACV,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACxB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,WAAW,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;IAClF,CAAC;IAED,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/labels.test.d.ts

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

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

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

package/dist/labels.test.js

@@ -0,0 +1,28 @@
+import { describe, it } from "node:test";
+import * as assert from "node:assert/strict";
+import { defaultMetricLabel, defaultMonitorMetricLabel } from "./labels.js";
+describe("defaultMetricLabel", () => {
+    it("formats common benchmark metrics into readable labels", () => {
+        assert.equal(defaultMetricLabel("ns_per_op"), "ns/op");
+        assert.equal(defaultMetricLabel("bytes_per_op"), "bytes/op");
+        assert.equal(defaultMetricLabel("allocs_per_op"), "allocs/op");
+    });
+    it("falls back to replacing underscores for custom metrics", () => {
+        assert.equal(defaultMetricLabel("requests_per_second"), "requests/second");
+        assert.equal(defaultMetricLabel("cache_hit_rate"), "cache hit rate");
+    });
+    it("delegates monitor metrics to the monitor label formatter", () => {
+        assert.equal(defaultMetricLabel("_monitor/cpu_user_pct"), "CPU user %");
+    });
+});
+describe("defaultMonitorMetricLabel", () => {
+    it("uses friendly labels for known monitor metrics", () => {
+        assert.equal(defaultMonitorMetricLabel("_monitor/wall_clock_ms"), "Wall clock time (ms)");
+        assert.equal(defaultMonitorMetricLabel("_monitor/mem_available_min_mb"), "Lowest available memory (MB)");
+    });
+    it("formats unknown monitor metrics into title case", () => {
+        assert.equal(defaultMonitorMetricLabel("_monitor/process/background_worker"), "Process Background Worker");
+        assert.equal(defaultMonitorMetricLabel("_monitor/custom_probe"), "Custom Probe");
+    });
+});
+//# sourceMappingURL=labels.test.js.map

package/dist/labels.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.test.js","sourceRoot":"","sources":["../src/labels.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE5E,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,CAAC;QAC7D,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,WAAW,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAC3E,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,EAAE,YAAY,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,wBAAwB,CAAC,EAAE,sBAAsB,CAAC,CAAC;QAC1F,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,+BAA+B,CAAC,EAAE,8BAA8B,CAAC,CAAC;IAC3G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,oCAAoC,CAAC,EAAE,2BAA2B,CAAC,CAAC;QAC3G,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,uBAAuB,CAAC,EAAE,cAAc,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/leaderboard.d.ts

@@ -0,0 +1,29 @@
+import type { SeriesFile, SeriesEntry } from "@octo11y/core";
+/** A single ranked entry in the leaderboard. */
+export interface RankedEntry {
+    name: string;
+    entry: SeriesEntry;
+    latestValue: number;
+    previousValue: number | undefined;
+    /** latestValue - previousValue, undefined when no previous point exists */
+    delta: number | undefined;
+    /** 1-based rank */
+    rank: number;
+    isWinner: boolean;
+}
+/**
+ * Rank all series in a SeriesFile by latest value, direction-aware.
+ *
+ * - `smaller_is_better`: rank 1 = lowest value
+ * - `bigger_is_better`: rank 1 = highest value
+ * - no direction: rank 1 = lowest value (neutral)
+ *
+ * Series with no data points are excluded from the ranking.
+ */
+export declare function rankSeries(sf: SeriesFile): RankedEntry[];
+/**
+ * Return the name of the winning series (rank 1), or undefined when there are
+ * no series with data points.
+ */
+export declare function getWinner(sf: SeriesFile): string | undefined;
+//# sourceMappingURL=leaderboard.d.ts.map

package/dist/leaderboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard.d.ts","sourceRoot":"","sources":["../src/leaderboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE7D,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,2EAA2E;IAC3E,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,GAAG,WAAW,EAAE,CAuBxD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAG5D"}

package/dist/leaderboard.js

@@ -0,0 +1,40 @@
+/**
+ * Rank all series in a SeriesFile by latest value, direction-aware.
+ *
+ * - `smaller_is_better`: rank 1 = lowest value
+ * - `bigger_is_better`: rank 1 = highest value
+ * - no direction: rank 1 = lowest value (neutral)
+ *
+ * Series with no data points are excluded from the ranking.
+ */
+export function rankSeries(sf) {
+    const entries = [];
+    for (const [name, entry] of Object.entries(sf.series)) {
+        const pts = entry.points;
+        if (pts.length === 0)
+            continue;
+        const latestValue = pts[pts.length - 1].value;
+        const previousValue = pts.length >= 2 ? pts[pts.length - 2].value : undefined;
+        entries.push({ name, entry, latestValue, previousValue });
+    }
+    const descending = sf.direction === "bigger_is_better";
+    entries.sort((a, b) => descending ? b.latestValue - a.latestValue : a.latestValue - b.latestValue);
+    return entries.map((e, idx) => ({
+        name: e.name,
+        entry: e.entry,
+        latestValue: e.latestValue,
+        previousValue: e.previousValue,
+        delta: e.previousValue !== undefined ? e.latestValue - e.previousValue : undefined,
+        rank: idx + 1,
+        isWinner: idx === 0,
+    }));
+}
+/**
+ * Return the name of the winning series (rank 1), or undefined when there are
+ * no series with data points.
+ */
+export function getWinner(sf) {
+    const ranked = rankSeries(sf);
+    return ranked.length > 0 ? ranked[0].name : undefined;
+}
+//# sourceMappingURL=leaderboard.js.map

package/dist/leaderboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard.js","sourceRoot":"","sources":["../src/leaderboard.ts"],"names":[],"mappings":"AAeA;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,EAAc;IACvC,MAAM,OAAO,GAAwG,EAAE,CAAC;IAExH,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;QACzB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC/B,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9C,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,UAAU,GAAG,EAAE,CAAC,SAAS,KAAK,kBAAkB,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;IAEnG,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,KAAK,EAAE,CAAC,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;QAClF,IAAI,EAAE,GAAG,GAAG,CAAC;QACb,QAAQ,EAAE,GAAG,KAAK,CAAC;KACpB,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EAAc;IACtC,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC"}

package/dist/leaderboard.test.d.ts

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

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

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