@adminiumjs/charts 0.1.0-rc.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"lineArea.d.ts","sourceRoot":"","sources":["../../src/geometry/lineArea.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,OAAO;IACtB,qBAAqB;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,qBAAqB;IACrB,CAAC,EAAE,MAAM,CAAC;CACX;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,EAAE,MAAM,UAAQ,GAAG,MAAM,GAAG,IAAI,CAMlF;AAED,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM,GAAG,IAAI,CAOrG;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW9E"}

package/dist/geometry/lineArea.js

@@ -0,0 +1,37 @@
+/** Pure, DOM-free line/area path builders (d3-shape only). */
+import { area, curveLinear, curveMonotoneX, line } from 'd3-shape';
+/** SVG path for a polyline through pixel-space points. Null when < 1 point. */
+export function linePath(points, smooth = false) {
+    const generator = line()
+        .x((d) => d.x)
+        .y((d) => d.y)
+        .curve(smooth ? curveMonotoneX : curveLinear);
+    return generator([...points]);
+}
+/** SVG path for the area under the line, closed at `baselineY`. */
+export function areaPath(points, baselineY, smooth = false) {
+    const generator = area()
+        .x((d) => d.x)
+        .y0(baselineY)
+        .y1((d) => d.y)
+        .curve(smooth ? curveMonotoneX : curveLinear);
+    return generator([...points]);
+}
+/**
+ * Index of the point whose pixel x is nearest to `targetX`. Works for both
+ * ascending (LTR) and descending (RTL categorical) x sequences — linear scan,
+ * chart series are small. Returns -1 for empty input.
+ */
+export function nearestIndexByX(xs, targetX) {
+    let best = -1;
+    let bestDistance = Infinity;
+    for (let i = 0; i < xs.length; i += 1) {
+        const distance = Math.abs((xs[i] ?? Infinity) - targetX);
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            best = i;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=lineArea.js.map

package/dist/geometry/lineArea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineArea.js","sourceRoot":"","sources":["../../src/geometry/lineArea.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AASnE,+EAA+E;AAC/E,MAAM,UAAU,QAAQ,CAAC,MAA0B,EAAE,MAAM,GAAG,KAAK;IACjE,MAAM,SAAS,GAAG,IAAI,EAAW;SAC9B,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SACb,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SACb,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAChD,OAAO,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,QAAQ,CAAC,MAA0B,EAAE,SAAiB,EAAE,MAAM,GAAG,KAAK;IACpF,MAAM,SAAS,GAAG,IAAI,EAAW;SAC9B,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SACb,EAAE,CAAC,SAAS,CAAC;SACb,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SACd,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAChD,OAAO,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,EAAqB,EAAE,OAAe;IACpE,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IACd,IAAI,YAAY,GAAG,QAAQ,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,GAAG,OAAO,CAAC,CAAC;QACzD,IAAI,QAAQ,GAAG,YAAY,EAAE,CAAC;YAC5B,YAAY,GAAG,QAAQ,CAAC;YACxB,IAAI,GAAG,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/geometry/marimekko.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Pure Marimekko / Mekko layout (`chart-marimekko`, research/widget-registry.md
+ * §2): column width = outer share, vertical segments = inner mix. DOM-free.
+ * Input is a `matrix` (rowKeys = inner categories, colKeys = outer columns,
+ * cells[row][col] = value). Columns mirror in RTL (first column at inline-start,
+ * the right edge under `rtl`); vertical stacking is direction-invariant.
+ */
+export interface MarimekkoSegment {
+    rowIndex: number;
+    rowKey: string;
+    value: number;
+    /** Share of the column total, 0..1. */
+    share: number;
+    y: number;
+    height: number;
+}
+export interface MarimekkoColumn {
+    colIndex: number;
+    colKey: string;
+    total: number;
+    /** Share of the grand total, 0..1. */
+    share: number;
+    x: number;
+    width: number;
+    segments: MarimekkoSegment[];
+}
+export interface MarimekkoLayout {
+    columns: MarimekkoColumn[];
+    grandTotal: number;
+}
+export interface MarimekkoLayoutOptions {
+    width: number;
+    height: number;
+    rtl: boolean;
+    /** Gap between columns in px (default 2). */
+    gap?: number;
+}
+/**
+ * `cells[rowIndex][colIndex]` — the widget adapts the §3 `matrix` envelope
+ * (rowKeys × colKeys × cells) into this shape.
+ */
+export declare function layoutMarimekko(rowKeys: readonly string[], colKeys: readonly string[], cells: readonly (readonly number[])[], options: MarimekkoLayoutOptions): MarimekkoLayout;
+//# sourceMappingURL=marimekko.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marimekko.d.ts","sourceRoot":"","sources":["../../src/geometry/marimekko.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,KAAK,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,EACrC,OAAO,EAAE,sBAAsB,GAC9B,eAAe,CAuCjB"}

package/dist/geometry/marimekko.js

@@ -0,0 +1,45 @@
+/**
+ * Pure Marimekko / Mekko layout (`chart-marimekko`, research/widget-registry.md
+ * §2): column width = outer share, vertical segments = inner mix. DOM-free.
+ * Input is a `matrix` (rowKeys = inner categories, colKeys = outer columns,
+ * cells[row][col] = value). Columns mirror in RTL (first column at inline-start,
+ * the right edge under `rtl`); vertical stacking is direction-invariant.
+ */
+/**
+ * `cells[rowIndex][colIndex]` — the widget adapts the §3 `matrix` envelope
+ * (rowKeys × colKeys × cells) into this shape.
+ */
+export function layoutMarimekko(rowKeys, colKeys, cells, options) {
+    const { width, height, rtl, gap = 2 } = options;
+    const cols = colKeys.length;
+    if (cols === 0 || rowKeys.length === 0 || width <= 0 || height <= 0) {
+        return { columns: [], grandTotal: 0 };
+    }
+    const columnTotals = colKeys.map((_col, colIndex) => rowKeys.reduce((sum, _row, rowIndex) => sum + Math.max(0, cells[rowIndex]?.[colIndex] ?? 0), 0));
+    const grandTotal = columnTotals.reduce((sum, t) => sum + t, 0);
+    const totalGap = gap * Math.max(0, cols - 1);
+    const usableWidth = Math.max(0, width - totalGap);
+    // Column x positions accumulate inline-start → inline-end; the whole strip
+    // mirrors by reflecting the accumulated inline-start offset in RTL.
+    let cursor = 0;
+    const columns = colKeys.map((colKey, colIndex) => {
+        const total = columnTotals[colIndex] ?? 0;
+        const share = grandTotal > 0 ? total / grandTotal : 1 / cols;
+        const colWidth = usableWidth * share;
+        const inlineStart = cursor;
+        cursor += colWidth + gap;
+        const x = rtl ? width - inlineStart - colWidth : inlineStart;
+        let segCursor = 0;
+        const segments = rowKeys.map((rowKey, rowIndex) => {
+            const value = Math.max(0, cells[rowIndex]?.[colIndex] ?? 0);
+            const segShare = total > 0 ? value / total : 0;
+            const segHeight = segShare * height;
+            const y = segCursor;
+            segCursor += segHeight;
+            return { rowIndex, rowKey, value, share: segShare, y, height: segHeight };
+        });
+        return { colIndex, colKey, total, share, x, width: colWidth, segments };
+    });
+    return { columns, grandTotal };
+}
+//# sourceMappingURL=marimekko.js.map

package/dist/geometry/marimekko.js.map

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

package/dist/geometry/multiLine.d.ts

@@ -0,0 +1,19 @@
+import type { XYPoint } from './lineArea.js';
+export interface PixelSeries {
+    key: string;
+    label: string;
+    /** Pixel-space points; gaps (null values) are pre-filtered by the caller. */
+    points: XYPoint[];
+}
+export interface SeriesPath {
+    key: string;
+    label: string;
+    path: string | null;
+    /** Last plotted point — anchor for end dots + end labels. */
+    end: XYPoint | null;
+}
+/** One SVG path string per series through its pixel points, plus the end anchor. */
+export declare function multiSeriesPaths(series: readonly PixelSeries[], smooth?: boolean): SeriesPath[];
+/** Categorical series color var: series i → `--viz-((i mod 8)+1)` (viz.css order). */
+export declare function seriesColorVar(index: number): string;
+//# sourceMappingURL=multiLine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"multiLine.d.ts","sourceRoot":"","sources":["../../src/geometry/multiLine.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,6DAA6D;IAC7D,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;CACrB;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,EAAE,MAAM,UAAQ,GAAG,UAAU,EAAE,CAW7F;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/geometry/multiLine.js

@@ -0,0 +1,25 @@
+/**
+ * Pure multi-series polyline geometry (d3-shape only) — the core of
+ * `chart-multiline` and `chart-bump` (research/widget-registry.md §2). DOM-free
+ * so scheduled-report workers reuse it; identical path strings in Node and the
+ * browser (04 §7.1, acceptance #10).
+ */
+import { curveLinear, curveMonotoneX, line } from 'd3-shape';
+/** One SVG path string per series through its pixel points, plus the end anchor. */
+export function multiSeriesPaths(series, smooth = false) {
+    const generator = line()
+        .x((d) => d.x)
+        .y((d) => d.y)
+        .curve(smooth ? curveMonotoneX : curveLinear);
+    return series.map((s) => ({
+        key: s.key,
+        label: s.label,
+        path: s.points.length > 0 ? generator([...s.points]) : null,
+        end: s.points.at(-1) ?? null,
+    }));
+}
+/** Categorical series color var: series i → `--viz-((i mod 8)+1)` (viz.css order). */
+export function seriesColorVar(index) {
+    return `var(--viz-${(index % 8) + 1})`;
+}
+//# sourceMappingURL=multiLine.js.map

package/dist/geometry/multiLine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiLine.js","sourceRoot":"","sources":["../../src/geometry/multiLine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAmB7D,oFAAoF;AACpF,MAAM,UAAU,gBAAgB,CAAC,MAA8B,EAAE,MAAM,GAAG,KAAK;IAC7E,MAAM,SAAS,GAAG,IAAI,EAAW;SAC9B,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SACb,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SACb,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxB,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;QAC3D,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI;KAC7B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,aAAa,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;AACzC,CAAC"}

package/dist/geometry/pareto.d.ts

@@ -0,0 +1,44 @@
+import type { XYPoint } from './lineArea.js';
+export interface ParetoInput {
+    label: string;
+    value: number;
+}
+export interface ParetoBar {
+    index: number;
+    label: string;
+    value: number;
+    /** Cumulative share up to and including this bar, 0..1. */
+    cumulative: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Center x (used for the cumulative-line vertex + tick anchor). */
+    centerX: number;
+    /** Cumulative-line vertex y (right axis). */
+    lineY: number;
+}
+export interface ParetoLayout {
+    bars: ParetoBar[];
+    /** Cumulative polyline path (right axis). Null when < 1 bar. */
+    linePath: string | null;
+    linePoints: XYPoint[];
+    /** Nice value ticks for the left axis (ascending). */
+    yTicks: number[];
+    yFor: (value: number) => number;
+    /** Cutline y (right axis) or null when disabled. */
+    cutlineY: number | null;
+    cutline: number;
+    total: number;
+}
+export interface ParetoLayoutOptions {
+    width: number;
+    height: number;
+    rtl: boolean;
+    /** Cumulative cutline fraction, 0..1 (default 0.8); null disables it. */
+    cutline?: number | null;
+    smooth?: boolean;
+    tickCount?: number;
+}
+export declare function layoutPareto(items: readonly ParetoInput[], options: ParetoLayoutOptions): ParetoLayout;
+//# sourceMappingURL=pareto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pareto.d.ts","sourceRoot":"","sources":["../../src/geometry/pareto.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,sDAAsD;IACtD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,oDAAoD;IACpD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE,mBAAmB,GAAG,YAAY,CA6DtG"}

package/dist/geometry/pareto.js

@@ -0,0 +1,65 @@
+/**
+ * Pure Pareto layout (`chart-pareto`, research/widget-registry.md §2): sorted
+ * bars + a cumulative-% line, with an optional cutline (default 80%). DOM-free.
+ * Categorical x mirrors in RTL (band-scale range flip); the cumulative line is
+ * built in the same visual order so it tracks the mirrored bars. Y for bars is
+ * value-scaled (left axis); the line uses the 0..1 cumulative axis (right).
+ */
+import { categoricalBandScale } from './scales.js';
+import { linePath } from './lineArea.js';
+import { niceTicks } from '../utils/stats.js';
+export function layoutPareto(items, options) {
+    const { width, height, rtl, cutline = 0.8, smooth = false, tickCount = 3 } = options;
+    const empty = {
+        bars: [],
+        linePath: null,
+        linePoints: [],
+        yTicks: [],
+        yFor: () => 0,
+        cutlineY: null,
+        cutline: cutline ?? 0.8,
+        total: 0,
+    };
+    if (items.length === 0 || width <= 0 || height <= 0)
+        return empty;
+    const total = items.reduce((sum, item) => sum + Math.max(0, item.value), 0);
+    const peak = items.reduce((m, item) => Math.max(m, item.value), 0);
+    const yTicks = peak <= 0 ? [0, 1] : niceTicks(0, peak, tickCount);
+    const domainHi = yTicks.at(-1) ?? Math.max(peak, 1);
+    const yFor = (value) => height - (Math.max(0, value) / (domainHi || 1)) * height;
+    /** Right (cumulative) axis maps 0..1 → bottom..top. */
+    const cumulativeY = (frac) => height - Math.max(0, Math.min(1, frac)) * height;
+    const band = categoricalBandScale(items.map((item) => item.label), width, rtl, { paddingInner: 0.28, paddingOuter: 0.16 });
+    const bandwidth = band.bandwidth();
+    let running = 0;
+    const bars = items.map((item, index) => {
+        running += Math.max(0, item.value);
+        const cumulative = total > 0 ? running / total : 0;
+        const x = band(item.label) ?? 0;
+        const barTop = yFor(item.value);
+        return {
+            index,
+            label: item.label,
+            value: item.value,
+            cumulative,
+            x,
+            y: barTop,
+            width: bandwidth,
+            height: height - barTop,
+            centerX: x + bandwidth / 2,
+            lineY: cumulativeY(cumulative),
+        };
+    });
+    const linePoints = bars.map((bar) => ({ x: bar.centerX, y: bar.lineY }));
+    return {
+        bars,
+        linePath: linePath(linePoints, smooth),
+        linePoints,
+        yTicks,
+        yFor,
+        cutlineY: cutline === null ? null : cumulativeY(cutline),
+        cutline: cutline ?? 0.8,
+        total,
+    };
+}
+//# sourceMappingURL=pareto.js.map

package/dist/geometry/pareto.js.map

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

package/dist/geometry/radar.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Pure radar geometry (`chart-radar`, research/widget-registry.md §2): N named
+ * axes arranged on a regular polygon, one polygon per series (current vs an
+ * optional target overlay), normalized to a shared max. First axis points up
+ * (12 o'clock); subsequent axes step clockwise (LTR) or counter-clockwise (RTL)
+ * so the categorical axis order mirrors per §7.4. DOM-free + deterministic.
+ */
+export interface RadarSeriesInput {
+    label: string;
+    /** One value per axis, in axis order. */
+    values: readonly number[];
+}
+export interface RadarPoint {
+    x: number;
+    y: number;
+}
+export interface RadarAxis {
+    label: string;
+    /** Outer vertex of the axis spoke (on the unit ring). */
+    point: RadarPoint;
+    angle: number;
+}
+export interface RadarSeries {
+    label: string;
+    points: RadarPoint[];
+    /** Closed polygon path string (`M … Z`). */
+    path: string;
+    colorVar: string;
+}
+export interface RadarGridRing {
+    /** 0..1 level. */
+    level: number;
+    /** Polygon vertices for this concentric level. */
+    points: RadarPoint[];
+    path: string;
+}
+export interface RadarLayout {
+    axes: RadarAxis[];
+    series: RadarSeries[];
+    rings: RadarGridRing[];
+    radius: number;
+    center: RadarPoint;
+    /** Domain max the values were normalized against. */
+    max: number;
+}
+export interface RadarOptions {
+    size: number;
+    /** Concentric grid rings (default 4). */
+    levels?: number;
+    /** Explicit domain max; defaults to the max value across all series (min 1). */
+    max?: number;
+    rtl?: boolean;
+}
+/**
+ * Radar polygons for 1–2 series over `axisLabels`. Series values are truncated
+ * or zero-padded to the axis count. Returns empty axes/series when there are
+ * fewer than 3 axes (a polygon needs ≥3 vertices).
+ */
+export declare function radarLayout(axisLabels: readonly string[], seriesInput: readonly RadarSeriesInput[], options: RadarOptions): RadarLayout;
+//# sourceMappingURL=radar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"radar.d.ts","sourceRoot":"","sources":["../../src/geometry/radar.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAiBD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,WAAW,EAAE,SAAS,gBAAgB,EAAE,EACxC,OAAO,EAAE,YAAY,GACpB,WAAW,CAmDb"}

package/dist/geometry/radar.js

@@ -0,0 +1,67 @@
+/**
+ * Pure radar geometry (`chart-radar`, research/widget-registry.md §2): N named
+ * axes arranged on a regular polygon, one polygon per series (current vs an
+ * optional target overlay), normalized to a shared max. First axis points up
+ * (12 o'clock); subsequent axes step clockwise (LTR) or counter-clockwise (RTL)
+ * so the categorical axis order mirrors per §7.4. DOM-free + deterministic.
+ */
+function vizColor(index) {
+    return `var(--viz-${(index % 8) + 1})`;
+}
+function angleFor(index, count, rtl) {
+    // Start at 12 o'clock (-90°); step clockwise (LTR) or CCW (RTL).
+    const step = (Math.PI * 2) / count;
+    return -Math.PI / 2 + (rtl ? -1 : 1) * index * step;
+}
+function polygonPath(points) {
+    if (points.length === 0)
+        return '';
+    return `${points.map((p, i) => `${i === 0 ? 'M' : 'L'}${p.x.toFixed(3)},${p.y.toFixed(3)}`).join('')}Z`;
+}
+/**
+ * Radar polygons for 1–2 series over `axisLabels`. Series values are truncated
+ * or zero-padded to the axis count. Returns empty axes/series when there are
+ * fewer than 3 axes (a polygon needs ≥3 vertices).
+ */
+export function radarLayout(axisLabels, seriesInput, options) {
+    const { size, levels = 4, rtl = false } = options;
+    const count = axisLabels.length;
+    const radius = Math.max(0, size / 2);
+    const center = { x: radius, y: radius };
+    if (count < 3 || radius <= 0) {
+        return { axes: [], series: [], rings: [], radius, center, max: 1 };
+    }
+    const domainMax = options.max ??
+        Math.max(1, ...seriesInput.flatMap((s) => s.values.map((v) => (Number.isFinite(v) ? v : 0))));
+    const angles = Array.from({ length: count }, (_, i) => angleFor(i, count, rtl));
+    const axes = axisLabels.map((label, i) => {
+        const angle = angles[i];
+        return {
+            label,
+            angle,
+            point: { x: center.x + Math.cos(angle) * radius, y: center.y + Math.sin(angle) * radius },
+        };
+    });
+    const rings = Array.from({ length: levels }, (_, l) => {
+        const level = (l + 1) / levels;
+        const points = angles.map((angle) => ({
+            x: center.x + Math.cos(angle) * radius * level,
+            y: center.y + Math.sin(angle) * radius * level,
+        }));
+        return { level, points, path: polygonPath(points) };
+    });
+    const series = seriesInput.map((s, si) => {
+        const points = angles.map((angle, i) => {
+            const raw = s.values[i];
+            const v = Number.isFinite(raw) ? Math.max(0, raw) : 0;
+            const norm = Math.min(1, v / domainMax);
+            return {
+                x: center.x + Math.cos(angle) * radius * norm,
+                y: center.y + Math.sin(angle) * radius * norm,
+            };
+        });
+        return { label: s.label, points, path: polygonPath(points), colorVar: vizColor(si) };
+    });
+    return { axes, series, rings, radius, center, max: domainMax };
+}
+//# sourceMappingURL=radar.js.map

package/dist/geometry/radar.js.map

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

package/dist/geometry/radialBar.d.ts

@@ -0,0 +1,31 @@
+export interface RadialBarInput {
+    label: string;
+    /** Percent 0..100 (values are clamped). */
+    value: number;
+}
+export interface RadialBarRing {
+    label: string;
+    value: number;
+    /** 0..1 clamped fraction. */
+    fraction: number;
+    radius: number;
+    /** Background track arc (full ring), centered on (0,0). */
+    trackPath: string;
+    /** Foreground value arc from 12 o'clock clockwise. */
+    valuePath: string;
+    colorVar: string;
+}
+export interface RadialBarOptions {
+    /** Outer diameter in px. */
+    size: number;
+    thickness?: number;
+    /** Gap between concentric rings in px (default 6). */
+    gap?: number;
+}
+/**
+ * Concentric rings from the outside in, in input order. An empty input (or
+ * non-positive size) yields []. Each ring's value arc sweeps clockwise from the
+ * top; a zero-percent ring has an empty value path.
+ */
+export declare function radialBarRings(input: readonly RadialBarInput[], options: RadialBarOptions): RadialBarRing[];
+//# sourceMappingURL=radialBar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"radialBar.d.ts","sourceRoot":"","sources":["../../src/geometry/radialBar.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAWD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,aAAa,EAAE,CA8B3G"}

package/dist/geometry/radialBar.js

@@ -0,0 +1,53 @@
+/**
+ * Pure radial-bar geometry (`chart-radial-bar`, research/widget-registry.md §2):
+ * concentric progress rings, one per category (≤4), each a stroke-dashoffset
+ * sweep of its percent from 12 o'clock clockwise. DOM-free + deterministic so
+ * the same arc paths render in Node and the browser (04 §7.1).
+ *
+ * Rings never mirror in RTL (clockwise rotation is direction-neutral, like the
+ * donut §7.4) — only the surrounding legend flips, which is plain flex CSS.
+ */
+import { arc } from 'd3-shape';
+const TAU = Math.PI * 2;
+function vizColor(index) {
+    return `var(--viz-${(index % 8) + 1})`;
+}
+function clampFraction(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.min(1, Math.max(0, value / 100));
+}
+/**
+ * Concentric rings from the outside in, in input order. An empty input (or
+ * non-positive size) yields []. Each ring's value arc sweeps clockwise from the
+ * top; a zero-percent ring has an empty value path.
+ */
+export function radialBarRings(input, options) {
+    const { size, thickness = 12, gap = 6 } = options;
+    if (size <= 0 || input.length === 0)
+        return [];
+    const outer = size / 2;
+    return input.map((item, index) => {
+        const radius = outer - index * (thickness + gap) - thickness / 2;
+        const r = Math.max(0, radius);
+        const inner = Math.max(0, r - thickness / 2);
+        const outerR = r + thickness / 2;
+        const fraction = clampFraction(item.value);
+        const track = arc()
+            .innerRadius(inner)
+            .outerRadius(outerR)
+            .cornerRadius(thickness / 2);
+        const trackPath = track({ startAngle: 0, endAngle: TAU }) ?? '';
+        const valuePath = fraction > 0 ? (track({ startAngle: 0, endAngle: fraction * TAU }) ?? '') : '';
+        return {
+            label: item.label,
+            value: item.value,
+            fraction,
+            radius: r,
+            trackPath,
+            valuePath,
+            colorVar: vizColor(index),
+        };
+    });
+}
+//# sourceMappingURL=radialBar.js.map

package/dist/geometry/radialBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radialBar.js","sourceRoot":"","sources":["../../src/geometry/radialBar.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;AA6BxB,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,aAAa,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;AACzC,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAgC,EAAE,OAAyB;IACxF,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAClD,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE/C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;QACjE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE3C,MAAM,KAAK,GAAG,GAAG,EAA4C;aAC1D,WAAW,CAAC,KAAK,CAAC;aAClB,WAAW,CAAC,MAAM,CAAC;aACnB,YAAY,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QAC/B,MAAM,SAAS,GAAG,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;QAChE,MAAM,SAAS,GACb,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEjF,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ;YACR,MAAM,EAAE,CAAC;YACT,SAAS;YACT,SAAS;YACT,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC;SAC1B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/geometry/ranking.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Pure ranking-bar layout (`chart-ranking-bars`, research/widget-registry.md
+ * §2): label + proportional horizontal bar (leader solid, rest dimmed) + mono
+ * value. DOM-free so scheduled-report workers reuse it. Horizontal value axis
+ * mirrors in RTL (annex §7.4: categorical/ranking scales flip; bars anchor at
+ * inline-start, which is the right edge under `rtl`).
+ */
+export interface RankingInput {
+    label: string;
+    value: number;
+}
+export interface RankingBar {
+    index: number;
+    label: string;
+    value: number;
+    /** Row top y. */
+    rowY: number;
+    /** Bar top y (centered in the row). */
+    y: number;
+    /** Bar inline-start x (left in LTR, right-anchored in RTL). */
+    x: number;
+    /** Bar length in px. */
+    width: number;
+    barHeight: number;
+    /** True for the single largest value (the leader). */
+    isLeader: boolean;
+}
+export interface RankingLayout {
+    bars: RankingBar[];
+    rowHeight: number;
+}
+export interface RankingLayoutOptions {
+    width: number;
+    height: number;
+    rtl: boolean;
+    /** Fraction of the row occupied by the bar (default 0.5). */
+    barRatio?: number;
+    /** Cap the number of rows (top-N). */
+    max?: number;
+}
+/**
+ * Lay out top-N horizontal bars. Input is assumed pre-sorted descending (the
+ * server returns sorted `categorical`); the leader is whichever row holds the
+ * maximum value. Bar length is proportional to the maximum value so the leader
+ * fills the track.
+ */
+export declare function layoutRanking(items: readonly RankingInput[], options: RankingLayoutOptions): RankingLayout;
+//# sourceMappingURL=ranking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ranking.d.ts","sourceRoot":"","sources":["../../src/geometry/ranking.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,CAAC,EAAE,MAAM,CAAC;IACV,+DAA+D;IAC/D,CAAC,EAAE,MAAM,CAAC;IACV,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA6B1G"}