@adminiumjs/charts 0.1.0-rc.1

package/dist/demo/generators.d.ts

@@ -0,0 +1,44 @@
+/** Fixed anchor so demo timeseries are reproducible (last point lands here). */
+export declare const DEMO_EPOCH_MS: number;
+export interface DemoTimeseriesOptions {
+    /** Number of points (default 30 — one month of dailies). */
+    points?: number;
+    /** Baseline magnitude (default 1200). */
+    base?: number;
+    /** Additive drift per step as a fraction of base (default +0.6%). */
+    drift?: number;
+    /** Random-walk volatility as a fraction of base (default 12%). */
+    volatility?: number;
+    /** Timestamp of the LAST point (default DEMO_EPOCH_MS). */
+    endMs?: number;
+    /** Milliseconds between points (default one day). */
+    stepMs?: number;
+}
+export interface DemoPoint {
+    x: Date;
+    y: number;
+}
+/** Random-walk daily series with weekday seasonality. */
+export declare function demoTimeseries(seed: number, options?: DemoTimeseriesOptions): DemoPoint[];
+/** Prior-period comparison for a series: same shape, dampened and offset. */
+export declare function demoComparisonSeries(series: readonly DemoPoint[], seed: number): DemoPoint[];
+export interface DemoCategory {
+    label: string;
+    value: number;
+}
+/** Categorical values in a plausible 40–140 band. */
+export declare function demoCategorical(seed: number, categories?: readonly string[]): DemoCategory[];
+export interface DemoGroupedBars {
+    categories: string[];
+    series: {
+        name: string;
+        values: number[];
+    }[];
+}
+/** Two-series grouped bars (this period vs prior, prior slightly lower). */
+export declare function demoGroupedBars(seed: number, categories?: readonly string[]): DemoGroupedBars;
+/** Part-to-whole slices with descending plausible weights. */
+export declare function demoDonut(seed: number, labels?: readonly string[]): DemoCategory[];
+/** 6–12 point micro-series for sparklines. */
+export declare function demoSparkline(seed: number, points?: number): number[];
+//# sourceMappingURL=generators.d.ts.map

package/dist/demo/generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../src/demo/generators.ts"],"names":[],"mappings":"AAQA,gFAAgF;AAChF,eAAO,MAAM,aAAa,QAAwB,CAAC;AAMnD,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,IAAI,CAAC;IACR,CAAC,EAAE,MAAM,CAAC;CACX;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,SAAS,EAAE,CAmB7F;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAI5F;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAID,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,SAAS,MAAM,EAAuB,GAAG,YAAY,EAAE,CAGhH;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;CAC9C;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,SAAS,MAAM,EAAuB,GAAG,eAAe,CAWjH;AAID,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,SAAS,MAAM,EAAe,GAAG,YAAY,EAAE,CAQ9F;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM,EAAE,CAOhE"}

package/dist/demo/generators.js

@@ -0,0 +1,72 @@
+/**
+ * Deterministic demo-data generators (workplan/04-widget-registry.md §7.7).
+ * Same seed → identical payload, across processes and reloads: the time base
+ * is a fixed epoch, never `Date.now()`. Plausible ranges + weekday
+ * seasonality for timeseries.
+ */
+import { mulberry32 } from './mulberry32.js';
+/** Fixed anchor so demo timeseries are reproducible (last point lands here). */
+export const DEMO_EPOCH_MS = Date.UTC(2026, 5, 30); // 2026-06-30T00:00:00Z
+const DAY_MS = 86_400_000;
+/** Sun..Sat traffic multipliers — weekend dip, midweek peak. */
+const WEEKDAY_FACTOR = [0.62, 1.0, 1.06, 1.1, 1.08, 1.02, 0.7];
+/** Random-walk daily series with weekday seasonality. */
+export function demoTimeseries(seed, options = {}) {
+    const { points = 30, base = 1200, drift = 0.006, volatility = 0.12, endMs = DEMO_EPOCH_MS, stepMs = DAY_MS, } = options;
+    const random = mulberry32(seed);
+    const out = [];
+    let level = base;
+    for (let i = 0; i < points; i += 1) {
+        const date = new Date(endMs - (points - 1 - i) * stepMs);
+        level = Math.max(base * 0.15, level + (random() - 0.5) * 2 * volatility * base + drift * base);
+        const factor = stepMs === DAY_MS ? (WEEKDAY_FACTOR[date.getUTCDay()] ?? 1) : 1;
+        out.push({ x: date, y: Math.round(level * factor) });
+    }
+    return out;
+}
+/** Prior-period comparison for a series: same shape, dampened and offset. */
+export function demoComparisonSeries(series, seed) {
+    const random = mulberry32(seed ^ 0x9e3779b9);
+    const scale = 0.72 + random() * 0.18;
+    return series.map((p) => ({ x: p.x, y: Math.round(p.y * scale * (0.9 + random() * 0.2)) }));
+}
+const DEFAULT_CATEGORIES = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun'];
+/** Categorical values in a plausible 40–140 band. */
+export function demoCategorical(seed, categories = DEFAULT_CATEGORIES) {
+    const random = mulberry32(seed);
+    return categories.map((label) => ({ label, value: Math.round(40 + random() * 100) }));
+}
+/** Two-series grouped bars (this period vs prior, prior slightly lower). */
+export function demoGroupedBars(seed, categories = DEFAULT_CATEGORIES) {
+    const random = mulberry32(seed);
+    const current = categories.map(() => Math.round(60 + random() * 90));
+    const previous = current.map((v) => Math.round(v * (0.62 + random() * 0.3)));
+    return {
+        categories: [...categories],
+        series: [
+            { name: 'Current', values: current },
+            { name: 'Previous', values: previous },
+        ],
+    };
+}
+const DEMO_PLANS = ['Free', 'Pro', 'Business', 'Enterprise'];
+/** Part-to-whole slices with descending plausible weights. */
+export function demoDonut(seed, labels = DEMO_PLANS) {
+    const random = mulberry32(seed);
+    let weight = 400 + random() * 300;
+    return labels.map((label) => {
+        const value = Math.round(weight);
+        weight *= 0.45 + random() * 0.25;
+        return { label, value };
+    });
+}
+/** 6–12 point micro-series for sparklines. */
+export function demoSparkline(seed, points = 8) {
+    const random = mulberry32(seed);
+    let level = 40 + random() * 30;
+    return Array.from({ length: points }, () => {
+        level = Math.min(100, Math.max(8, level + (random() - 0.45) * 22));
+        return Math.round(level);
+    });
+}
+//# sourceMappingURL=generators.js.map

package/dist/demo/generators.js.map

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

package/dist/demo/mulberry32.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Deterministic seeded PRNG + hash per workplan/04-widget-registry.md §7.7:
+ * seed = FNV-1a hash of the widget instance id → previews are stable across
+ * reloads and screenshot tests are reproducible.
+ */
+/** Mulberry32 — tiny, fast, deterministic PRNG. Returns floats in [0, 1). */
+export declare function mulberry32(seed: number): () => number;
+/** FNV-1a 32-bit hash — maps widget instance ids to PRNG seeds. */
+export declare function fnv1a(input: string): number;
+//# sourceMappingURL=mulberry32.d.ts.map

package/dist/demo/mulberry32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mulberry32.d.ts","sourceRoot":"","sources":["../../src/demo/mulberry32.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,MAAM,CASrD;AAED,mEAAmE;AACnE,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO3C"}

package/dist/demo/mulberry32.js

@@ -0,0 +1,26 @@
+/**
+ * Deterministic seeded PRNG + hash per workplan/04-widget-registry.md §7.7:
+ * seed = FNV-1a hash of the widget instance id → previews are stable across
+ * reloads and screenshot tests are reproducible.
+ */
+/** Mulberry32 — tiny, fast, deterministic PRNG. Returns floats in [0, 1). */
+export function mulberry32(seed) {
+    let a = seed >>> 0;
+    return () => {
+        a = (a + 0x6d2b79f5) >>> 0;
+        let t = a;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/** FNV-1a 32-bit hash — maps widget instance ids to PRNG seeds. */
+export function fnv1a(input) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < input.length; i += 1) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return hash >>> 0;
+}
+//# sourceMappingURL=mulberry32.js.map

package/dist/demo/mulberry32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mulberry32.js","sourceRoot":"","sources":["../../src/demo/mulberry32.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6EAA6E;AAC7E,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IACnB,OAAO,GAAG,EAAE;QACV,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,CAAC;AACpB,CAAC"}

package/dist/geometry/anomaly.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Anomaly-detection geometry (`chart-anomaly`, research/widget-registry.md §2):
+ * a centered moving-average "expected" line, a symmetric expected-range band
+ * from the residual spread, and z-score anomaly flags. Pure + DOM-free and
+ * fully deterministic (04 §7.1); `sensitivity` is the z-threshold.
+ */
+export interface AnomalyModel {
+    /** Expected (smoothed) value per index. */
+    mid: number[];
+    /** Lower / upper expected-range edges (`mid ∓ sensitivity·σ`). */
+    lo: number[];
+    hi: number[];
+    /** Indices whose value lies outside the expected range. */
+    anomalies: number[];
+}
+/**
+ * `mid` = centered moving average (window `window`, default 7). σ = standard
+ * deviation of the residuals `value − mid`. A point is anomalous when its
+ * absolute residual exceeds `sensitivity·σ`.
+ */
+export declare function anomalyModel(values: readonly number[], sensitivity?: number, window?: number): AnomalyModel;
+//# sourceMappingURL=anomaly.d.ts.map

package/dist/geometry/anomaly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly.d.ts","sourceRoot":"","sources":["../../src/geometry/anomaly.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,kEAAkE;IAClE,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,2DAA2D;IAC3D,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAmBD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,WAAW,SAAI,EACf,MAAM,SAAI,GACT,YAAY,CAuBd"}

package/dist/geometry/anomaly.js

@@ -0,0 +1,52 @@
+/**
+ * Anomaly-detection geometry (`chart-anomaly`, research/widget-registry.md §2):
+ * a centered moving-average "expected" line, a symmetric expected-range band
+ * from the residual spread, and z-score anomaly flags. Pure + DOM-free and
+ * fully deterministic (04 §7.1); `sensitivity` is the z-threshold.
+ */
+/** Centered moving average with a clamped window at the series ends. */
+function centeredMovingAverage(values, window) {
+    const n = values.length;
+    const half = Math.floor(window / 2);
+    const out = [];
+    for (let i = 0; i < n; i += 1) {
+        let sum = 0;
+        let count = 0;
+        for (let j = Math.max(0, i - half); j <= Math.min(n - 1, i + half); j += 1) {
+            sum += values[j] ?? 0;
+            count += 1;
+        }
+        out.push(count === 0 ? 0 : sum / count);
+    }
+    return out;
+}
+/**
+ * `mid` = centered moving average (window `window`, default 7). σ = standard
+ * deviation of the residuals `value − mid`. A point is anomalous when its
+ * absolute residual exceeds `sensitivity·σ`.
+ */
+export function anomalyModel(values, sensitivity = 2, window = 7) {
+    const n = values.length;
+    if (n === 0)
+        return { mid: [], lo: [], hi: [], anomalies: [] };
+    const mid = centeredMovingAverage(values, window);
+    let sse = 0;
+    for (let i = 0; i < n; i += 1) {
+        const residual = (values[i] ?? 0) - (mid[i] ?? 0);
+        sse += residual * residual;
+    }
+    const sigma = Math.sqrt(sse / n);
+    const spread = sensitivity * sigma;
+    const lo = [];
+    const hi = [];
+    const anomalies = [];
+    for (let i = 0; i < n; i += 1) {
+        const m = mid[i] ?? 0;
+        lo.push(m - spread);
+        hi.push(m + spread);
+        if (sigma > 0 && Math.abs((values[i] ?? 0) - m) > spread)
+            anomalies.push(i);
+    }
+    return { mid, lo, hi, anomalies };
+}
+//# sourceMappingURL=anomaly.js.map

package/dist/geometry/anomaly.js.map

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

package/dist/geometry/bars.d.ts

@@ -0,0 +1,46 @@
+export interface BarRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    categoryIndex: number;
+    seriesIndex: number;
+    value: number;
+}
+export interface CategoryCenter {
+    label: string;
+    x: number;
+}
+export interface BarLayout {
+    bars: BarRect[];
+    categoryCenters: CategoryCenter[];
+    /** Nice y tick values (ascending). */
+    yTicks: number[];
+    /** Pixel y for a value (for gridlines/labels). */
+    yFor: (value: number) => number;
+    /** Pixel y of the zero baseline. */
+    baselineY: number;
+}
+export interface BarLayoutOptions {
+    categories: readonly string[];
+    /** One series = plain columns; two = grouped mode. */
+    series: readonly (readonly number[])[];
+    width: number;
+    height: number;
+    rtl: boolean;
+    paddingInner?: number;
+    paddingOuter?: number;
+    /** Gap between grouped bars within a category, px (default 3). */
+    groupGap?: number;
+    tickCount?: number;
+}
+/**
+ * Categorical column layout. In RTL the category order mirrors (first
+ * category at inline-start) via the band-scale range flip; grouped series
+ * order also mirrors inside each band so series[0] stays at inline-start.
+ */
+export declare function layoutBars(options: BarLayoutOptions): BarLayout;
+export type HighlightMode = 'max' | 'current' | 'none';
+/** Index of the highlighted category: max value, last bucket, or none (-1). */
+export declare function highlightIndex(values: readonly number[], mode: HighlightMode): number;
+//# sourceMappingURL=bars.d.ts.map

package/dist/geometry/bars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bars.d.ts","sourceRoot":"","sources":["../../src/geometry/bars.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,sCAAsC;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kDAAkD;IAClD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,sDAAsD;IACtD,MAAM,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA0D/D;AAED,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvD,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAQrF"}

package/dist/geometry/bars.js

@@ -0,0 +1,68 @@
+/** Pure bar/column layout — no DOM, reusable by server-side report rendering. */
+import { categoricalBandScale } from './scales.js';
+import { extent, niceTicks } from '../utils/stats.js';
+/**
+ * Categorical column layout. In RTL the category order mirrors (first
+ * category at inline-start) via the band-scale range flip; grouped series
+ * order also mirrors inside each band so series[0] stays at inline-start.
+ */
+export function layoutBars(options) {
+    const { categories, series, width, height, rtl, paddingInner = 0.3, paddingOuter = 0.15, groupGap = 3, tickCount = 3, } = options;
+    const all = series.flatMap((s) => [...s]);
+    const [minValue, maxValue] = extent(all) ?? [0, 1];
+    const lo = Math.min(0, minValue);
+    const hi = Math.max(0, maxValue);
+    const yTicks = lo === hi ? [lo, lo + 1] : niceTicks(lo, hi, tickCount);
+    const domainLo = yTicks[0] ?? lo;
+    const domainHi = yTicks.at(-1) ?? hi;
+    const span = domainHi - domainLo || 1;
+    const yFor = (value) => height - ((value - domainLo) / span) * height;
+    const baselineY = yFor(0);
+    const band = categoricalBandScale(categories, width, rtl, { paddingInner, paddingOuter });
+    const bandwidth = band.bandwidth();
+    const seriesCount = Math.max(1, series.length);
+    const slotWidth = seriesCount === 1 ? bandwidth : (bandwidth - groupGap * (seriesCount - 1)) / seriesCount;
+    const bars = [];
+    categories.forEach((category, categoryIndex) => {
+        const bandStart = band(category);
+        if (bandStart === undefined)
+            return;
+        series.forEach((values, seriesIndex) => {
+            const value = values[categoryIndex];
+            if (value === undefined)
+                return;
+            // Mirror series order inside the group in RTL so series[0] stays at inline-start.
+            const slot = rtl ? seriesCount - 1 - seriesIndex : seriesIndex;
+            const x = bandStart + slot * (slotWidth + groupGap);
+            const yValue = yFor(value);
+            bars.push({
+                x,
+                y: Math.min(yValue, baselineY),
+                width: Math.max(0, slotWidth),
+                height: Math.abs(yValue - baselineY),
+                categoryIndex,
+                seriesIndex,
+                value,
+            });
+        });
+    });
+    const categoryCenters = categories.map((label) => ({
+        label,
+        x: (band(label) ?? 0) + bandwidth / 2,
+    }));
+    return { bars, categoryCenters, yTicks, yFor, baselineY };
+}
+/** Index of the highlighted category: max value, last bucket, or none (-1). */
+export function highlightIndex(values, mode) {
+    if (mode === 'none' || values.length === 0)
+        return -1;
+    if (mode === 'current')
+        return values.length - 1;
+    let best = 0;
+    values.forEach((v, i) => {
+        if (v > (values[best] ?? -Infinity))
+            best = i;
+    });
+    return best;
+}
+//# sourceMappingURL=bars.js.map

package/dist/geometry/bars.js.map

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

package/dist/geometry/bullet.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Pure bullet-graph layout (`chart-bullet`, research/widget-registry.md §2):
+ * per row a stack of qualitative bands + a measure bar + a target tick. DOM-free.
+ * The horizontal value axis mirrors in RTL (annex §7.4): bands/measure anchor at
+ * inline-start (the right edge under `rtl`) and grow toward inline-end.
+ */
+export interface BulletInput {
+    label: string;
+    measure: number;
+    target: number;
+    /** Axis maximum; defaults to the largest of measure/target/cutoffs. */
+    max?: number;
+    /** Ascending band boundaries in value units, e.g. [40, 75] → 3 zones. */
+    bandCutoffs?: readonly number[];
+}
+export interface BulletBand {
+    index: number;
+    /** Band inline-start x. */
+    x: number;
+    width: number;
+    /** 0..1 intensity, lightest → strongest. */
+    level: number;
+}
+export interface BulletRow {
+    index: number;
+    label: string;
+    measure: number;
+    target: number;
+    max: number;
+    rowY: number;
+    /** Track (bands) rect. */
+    trackY: number;
+    trackHeight: number;
+    bands: BulletBand[];
+    /** Measure bar (inline-start anchored). */
+    measureX: number;
+    measureWidth: number;
+    measureY: number;
+    measureHeight: number;
+    /** Target tick x. */
+    targetX: number;
+}
+export interface BulletLayout {
+    rows: BulletRow[];
+    rowHeight: number;
+}
+export interface BulletLayoutOptions {
+    width: number;
+    height: number;
+    rtl: boolean;
+}
+export declare function layoutBullet(items: readonly BulletInput[], options: BulletLayoutOptions): BulletLayout;
+//# sourceMappingURL=bullet.d.ts.map

package/dist/geometry/bullet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullet.d.ts","sourceRoot":"","sources":["../../src/geometry/bullet.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd;AAcD,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAoDtG"}

package/dist/geometry/bullet.js

@@ -0,0 +1,67 @@
+/**
+ * Pure bullet-graph layout (`chart-bullet`, research/widget-registry.md §2):
+ * per row a stack of qualitative bands + a measure bar + a target tick. DOM-free.
+ * The horizontal value axis mirrors in RTL (annex §7.4): bands/measure anchor at
+ * inline-start (the right edge under `rtl`) and grow toward inline-end.
+ */
+/** Map a value in [0, max] to an inline-start-anchored pixel length. */
+function lengthFor(value, max, width) {
+    if (max <= 0)
+        return 0;
+    return (Math.max(0, Math.min(value, max)) / max) * width;
+}
+/** Map a value to a pixel x honoring the RTL axis flip. */
+function xFor(value, max, width, rtl) {
+    const len = lengthFor(value, max, width);
+    return rtl ? width - len : len;
+}
+export function layoutBullet(items, options) {
+    const { width, height, rtl } = options;
+    const n = items.length;
+    if (n === 0 || width <= 0 || height <= 0)
+        return { rows: [], rowHeight: 0 };
+    const rowHeight = height / n;
+    const trackHeight = Math.max(6, rowHeight * 0.55);
+    const measureHeight = Math.max(3, trackHeight * 0.34);
+    const rows = items.map((item, index) => {
+        const cutoffs = [...(item.bandCutoffs ?? [])].filter((c) => c > 0).sort((a, b) => a - b);
+        const max = item.max ?? Math.max(item.measure, item.target, cutoffs.at(-1) ?? 0, 1);
+        const rowY = index * rowHeight;
+        const trackY = rowY + (rowHeight - trackHeight) / 2;
+        // Band edges: 0, ...cutoffs, max → contiguous zones.
+        const edges = [0, ...cutoffs.filter((c) => c < max), max];
+        const zoneCount = edges.length - 1;
+        const bands = [];
+        for (let i = 0; i < zoneCount; i += 1) {
+            const lo = edges[i] ?? 0;
+            const hi = edges[i + 1] ?? max;
+            const xLo = xFor(lo, max, width, rtl);
+            const xHi = xFor(hi, max, width, rtl);
+            bands.push({
+                index: i,
+                x: Math.min(xLo, xHi),
+                width: Math.abs(xHi - xLo),
+                level: zoneCount <= 1 ? 1 : i / (zoneCount - 1),
+            });
+        }
+        const measureLen = lengthFor(item.measure, max, width);
+        return {
+            index,
+            label: item.label,
+            measure: item.measure,
+            target: item.target,
+            max,
+            rowY,
+            trackY,
+            trackHeight,
+            bands,
+            measureX: rtl ? width - measureLen : 0,
+            measureWidth: measureLen,
+            measureY: rowY + (rowHeight - measureHeight) / 2,
+            measureHeight,
+            targetX: xFor(item.target, max, width, rtl),
+        };
+    });
+    return { rows, rowHeight };
+}
+//# sourceMappingURL=bullet.js.map

package/dist/geometry/bullet.js.map

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

package/dist/geometry/bump.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Bump-chart geometry (`chart-bump`, research/widget-registry.md §2): rank
+ * over ordered periods, rank 1 pinned to the top. Ranks are a discrete
+ * categorical/ordinal axis, so the period axis MIRRORS in RTL (04 §7.4 —
+ * "rankings mirror"). Pure + DOM-free.
+ */
+import type { XYPoint } from './lineArea.js';
+export interface BumpSeries {
+    key: string;
+    label: string;
+    /** Rank per period (1 = best). `null` = the entity is absent that period. */
+    ranks: readonly (number | null)[];
+}
+export interface BumpLine {
+    key: string;
+    label: string;
+    /** Plotted points (null ranks skipped). */
+    points: XYPoint[];
+    /** First / last present points — anchors for start/end labels + dots. */
+    start: (XYPoint & {
+        rank: number;
+    }) | null;
+    end: (XYPoint & {
+        rank: number;
+    }) | null;
+}
+export interface BumpLayout {
+    lines: BumpLine[];
+    /** Period index → pixel x (mirrored in RTL). */
+    xForPeriod: (index: number) => number;
+    /** Rank → pixel y (rank 1 at top). */
+    yForRank: (rank: number) => number;
+    periods: number;
+    maxRank: number;
+}
+/**
+ * Lay out one polyline per entity. `periods` and `maxRank` fix the axes so
+ * every series shares a grid even when some are absent in a period. In RTL the
+ * period axis reverses (period 0 at inline-start / the right edge).
+ */
+export declare function layoutBump(series: readonly BumpSeries[], periods: number, maxRank: number, width: number, height: number, rtl: boolean): BumpLayout;
+//# sourceMappingURL=bump.d.ts.map

package/dist/geometry/bump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bump.d.ts","sourceRoot":"","sources":["../../src/geometry/bump.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,KAAK,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,yEAAyE;IACzE,KAAK,EAAE,CAAC,OAAO,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IAC3C,GAAG,EAAE,CAAC,OAAO,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,gDAAgD;IAChD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,sCAAsC;IACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,OAAO,GACX,UAAU,CAuBZ"}

package/dist/geometry/bump.js

@@ -0,0 +1,29 @@
+/**
+ * Lay out one polyline per entity. `periods` and `maxRank` fix the axes so
+ * every series shares a grid even when some are absent in a period. In RTL the
+ * period axis reverses (period 0 at inline-start / the right edge).
+ */
+export function layoutBump(series, periods, maxRank, width, height, rtl) {
+    const step = periods > 1 ? width / (periods - 1) : 0;
+    const xForPeriod = (index) => (rtl ? width - index * step : index * step);
+    // Rank 1 → top row center; rank maxRank → bottom row center (band per rank).
+    const rowHeight = maxRank > 0 ? height / maxRank : height;
+    const yForRank = (rank) => (rank - 0.5) * rowHeight;
+    const lines = series.map((entity) => {
+        const points = [];
+        entity.ranks.forEach((rank, index) => {
+            if (rank === null || index >= periods)
+                return;
+            points.push({ x: xForPeriod(index), y: yForRank(rank), rank });
+        });
+        return {
+            key: entity.key,
+            label: entity.label,
+            points: points.map(({ x, y }) => ({ x, y })),
+            start: points[0] ?? null,
+            end: points.at(-1) ?? null,
+        };
+    });
+    return { lines, xForPeriod, yForRank, periods, maxRank };
+}
+//# sourceMappingURL=bump.js.map

package/dist/geometry/bump.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bump.js","sourceRoot":"","sources":["../../src/geometry/bump.ts"],"names":[],"mappings":"AAmCA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,MAA6B,EAC7B,OAAe,EACf,OAAe,EACf,KAAa,EACb,MAAc,EACd,GAAY;IAEZ,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAClF,6EAA6E;IAC7E,MAAM,SAAS,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1D,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC;IAE5D,MAAM,KAAK,GAAe,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC9C,MAAM,MAAM,GAAmC,EAAE,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACnC,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,IAAI,OAAO;gBAAE,OAAO;YAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QACH,OAAO;YACL,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAC5C,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI;YACxB,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI;SAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC3D,CAAC"}