@adminiumjs/charts 0.1.0-rc.1

package/dist/geometry/streamStack.js

@@ -0,0 +1,56 @@
+/**
+ * Streamgraph stacking geometry (`chart-stream`, research/widget-registry.md
+ * §2): centered ("silhouette") stacked bands over time. Pure + DOM-free; the
+ * component supplies the pixel x/y scales, this returns value-space band edges
+ * and a golden-testable pixel area-path builder.
+ */
+import { area, curveBasis, curveLinear } from 'd3-shape';
+/**
+ * Stack series into bands. `silhouette` centers the total thickness on zero at
+ * each x (the classic streamgraph); `zero` stacks upward from a flat baseline.
+ * Negative inputs are clamped to zero (thicknesses are non-negative).
+ */
+export function stackStream(series, offset = 'silhouette') {
+    const n = series.reduce((max, s) => Math.max(max, s.values.length), 0);
+    const bands = series.map((s) => ({
+        key: s.key,
+        label: s.label,
+        low: Array.from({ length: n }, () => 0),
+        high: Array.from({ length: n }, () => 0),
+    }));
+    let min = 0;
+    let max = 0;
+    for (let i = 0; i < n; i += 1) {
+        const total = series.reduce((sum, s) => sum + Math.max(0, s.values[i] ?? 0), 0);
+        let running = offset === 'silhouette' ? -total / 2 : 0;
+        for (let s = 0; s < series.length; s += 1) {
+            const value = Math.max(0, series[s]?.values[i] ?? 0);
+            const band = bands[s];
+            if (band === undefined)
+                continue;
+            const low = running;
+            running += value;
+            band.low[i] = low;
+            band.high[i] = running;
+            if (running > max)
+                max = running;
+            if (low < min)
+                min = low;
+        }
+    }
+    return { bands, min, max };
+}
+/**
+ * Closed area path between per-index lower/upper PIXEL edges. `xs`, `low`,
+ * `high` are parallel pixel arrays; `smooth` uses a basis spline for the
+ * organic stream look.
+ */
+export function bandAreaPath(xs, low, high, smooth = true) {
+    const generator = area()
+        .x((_, i) => xs[i] ?? 0)
+        .y0((_, i) => low[i] ?? 0)
+        .y1((_, i) => high[i] ?? 0)
+        .curve(smooth ? curveBasis : curveLinear);
+    return generator(high.map(() => 0));
+}
+//# sourceMappingURL=streamStack.js.map

package/dist/geometry/streamStack.js.map

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

package/dist/geometry/sunburst.d.ts

@@ -0,0 +1,37 @@
+export interface SunburstChildInput {
+    label: string;
+    value: number;
+}
+export interface SunburstParentInput {
+    label: string;
+    children: readonly SunburstChildInput[];
+}
+export interface SunburstArc {
+    label: string;
+    parentLabel?: string;
+    value: number;
+    /** Fraction of the grand total, 0..1. */
+    share: number;
+    depth: 0 | 1;
+    startAngle: number;
+    endAngle: number;
+    path: string;
+    colorVar: string;
+}
+export interface SunburstLayout {
+    arcs: SunburstArc[];
+    total: number;
+}
+export interface SunburstOptions {
+    size: number;
+    /** Ring thickness in px (default derived from size). */
+    ringThickness?: number;
+    /** Radius of the empty center hole (default 0). */
+    innerRadius?: number;
+}
+/**
+ * Two-ring sunburst arcs (parents then their children, in input order). Empty
+ * parents (no positive children) are skipped; a non-positive total yields [].
+ */
+export declare function sunburstArcs(parents: readonly SunburstParentInput[], options: SunburstOptions): SunburstLayout;
+//# sourceMappingURL=sunburst.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sunburst.d.ts","sourceRoot":"","sources":["../../src/geometry/sunburst.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,EAAE,OAAO,EAAE,eAAe,GAAG,cAAc,CAiE9G"}

package/dist/geometry/sunburst.js

@@ -0,0 +1,84 @@
+/**
+ * Pure sunburst geometry (`chart-sunburst`, research/widget-registry.md §2): two
+ * nested rings from a 2-level hierarchy — inner ring = parents (angle ∝ subtree
+ * total), outer ring = children (angle ∝ child value within the parent span).
+ * Arcs sweep clockwise from 12 o'clock and do NOT mirror in RTL (rotation is
+ * direction-neutral, §7.4). DOM-free + deterministic (04 §7.1).
+ */
+import { arc } from 'd3-shape';
+const TAU = Math.PI * 2;
+function vizColor(index) {
+    return `var(--viz-${(index % 8) + 1})`;
+}
+/** Blend a parent color toward the surface for its children (lighter band). */
+function childColor(index) {
+    return `color-mix(in srgb, var(--viz-${(index % 8) + 1}) 62%, var(--surface))`;
+}
+/**
+ * Two-ring sunburst arcs (parents then their children, in input order). Empty
+ * parents (no positive children) are skipped; a non-positive total yields [].
+ */
+export function sunburstArcs(parents, options) {
+    const { size } = options;
+    const outer = Math.max(0, size / 2);
+    const innerHole = options.innerRadius ?? 0;
+    const band = options.ringThickness ?? (outer - innerHole) / 2;
+    if (outer <= 0)
+        return { arcs: [], total: 0 };
+    const normalized = parents.map((p, i) => {
+        const children = p.children
+            .map((c) => ({ label: c.label, value: Number.isFinite(c.value) ? Math.max(0, c.value) : 0 }))
+            .filter((c) => c.value > 0);
+        const total = children.reduce((s, c) => s + c.value, 0);
+        return { label: p.label, index: i, children, total };
+    });
+    const grandTotal = normalized.reduce((s, p) => s + p.total, 0);
+    if (grandTotal <= 0)
+        return { arcs: [], total: 0 };
+    const innerArc = arc()
+        .innerRadius(innerHole)
+        .outerRadius(innerHole + band);
+    const outerArc = arc()
+        .innerRadius(innerHole + band)
+        .outerRadius(outer);
+    const arcs = [];
+    let angle = 0;
+    for (const parent of normalized) {
+        if (parent.total <= 0)
+            continue;
+        const parentSpan = (parent.total / grandTotal) * TAU;
+        const parentStart = angle;
+        const parentEnd = angle + parentSpan;
+        arcs.push({
+            label: parent.label,
+            value: parent.total,
+            share: parent.total / grandTotal,
+            depth: 0,
+            startAngle: parentStart,
+            endAngle: parentEnd,
+            path: innerArc({ startAngle: parentStart, endAngle: parentEnd }) ?? '',
+            colorVar: vizColor(parent.index),
+        });
+        let childAngle = parentStart;
+        for (const child of parent.children) {
+            const childSpan = (child.value / grandTotal) * TAU;
+            const cStart = childAngle;
+            const cEnd = childAngle + childSpan;
+            childAngle = cEnd;
+            arcs.push({
+                label: child.label,
+                parentLabel: parent.label,
+                value: child.value,
+                share: child.value / grandTotal,
+                depth: 1,
+                startAngle: cStart,
+                endAngle: cEnd,
+                path: outerArc({ startAngle: cStart, endAngle: cEnd }) ?? '',
+                colorVar: childColor(parent.index),
+            });
+        }
+        angle = parentEnd;
+    }
+    return { arcs, total: grandTotal };
+}
+//# sourceMappingURL=sunburst.js.map

package/dist/geometry/sunburst.js.map

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

package/dist/geometry/timelineLanes.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Swimlane timeline geometry (`chart-timeline-lanes`, research/widget-registry.md
+ * §2): stacked horizontal lanes with events positioned along a shared time
+ * axis. The time axis is an LTR island (04 §7.4 — time axes never mirror), so
+ * event x-positions are LTR here; the component flips only the lane-label
+ * gutter side under RTL. Pure + DOM-free.
+ */
+export interface LaneEvent {
+    lane: string;
+    /** Normalized position along the time axis, 0 (oldest) … 1 (newest). */
+    position: number;
+    label: string;
+    tone?: string;
+}
+export interface PositionedEvent {
+    x: number;
+    label: string;
+    tone?: string | undefined;
+}
+export interface LaneRow {
+    lane: string;
+    index: number;
+    /** Top y of the lane band. */
+    y: number;
+    height: number;
+    /** Vertical center — the event pill baseline. */
+    centerY: number;
+    events: PositionedEvent[];
+}
+export interface LaneLayoutOptions {
+    /** Vertical gap between lane bands (px, default 8). */
+    laneGap?: number;
+}
+/**
+ * One row per lane (in the given order), each carrying its events at pixel x =
+ * `clamp(position, 0, 1) · width`. Events keep input order within a lane.
+ */
+export declare function layoutLanes(lanes: readonly string[], events: readonly LaneEvent[], width: number, height: number, options?: LaneLayoutOptions): LaneRow[];
+/** Normalize timestamped events to lane positions over a [min, max] time span. */
+export declare function positionByTime(events: readonly {
+    lane: string;
+    ms: number;
+    label: string;
+    tone?: string | undefined;
+}[]): LaneEvent[];
+//# sourceMappingURL=timelineLanes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timelineLanes.d.ts","sourceRoot":"","sources":["../../src/geometry/timelineLanes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iBAAsB,GAC9B,OAAO,EAAE,CAwBX;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAAE,GACxF,SAAS,EAAE,CAYb"}

package/dist/geometry/timelineLanes.js

@@ -0,0 +1,52 @@
+/**
+ * Swimlane timeline geometry (`chart-timeline-lanes`, research/widget-registry.md
+ * §2): stacked horizontal lanes with events positioned along a shared time
+ * axis. The time axis is an LTR island (04 §7.4 — time axes never mirror), so
+ * event x-positions are LTR here; the component flips only the lane-label
+ * gutter side under RTL. Pure + DOM-free.
+ */
+/**
+ * One row per lane (in the given order), each carrying its events at pixel x =
+ * `clamp(position, 0, 1) · width`. Events keep input order within a lane.
+ */
+export function layoutLanes(lanes, events, width, height, options = {}) {
+    const { laneGap = 8 } = options;
+    const count = lanes.length;
+    if (count === 0)
+        return [];
+    const laneHeight = Math.max(0, (height - laneGap * (count - 1)) / count);
+    return lanes.map((lane, index) => {
+        const y = index * (laneHeight + laneGap);
+        const laneEvents = events
+            .filter((event) => event.lane === lane)
+            .map((event) => ({
+            x: Math.min(1, Math.max(0, event.position)) * width,
+            label: event.label,
+            tone: event.tone,
+        }));
+        return {
+            lane,
+            index,
+            y,
+            height: laneHeight,
+            centerY: y + laneHeight / 2,
+            events: laneEvents,
+        };
+    });
+}
+/** Normalize timestamped events to lane positions over a [min, max] time span. */
+export function positionByTime(events) {
+    if (events.length === 0)
+        return [];
+    const times = events.map((event) => event.ms);
+    const min = Math.min(...times);
+    const max = Math.max(...times);
+    const span = max - min || 1;
+    return events.map((event) => ({
+        lane: event.lane,
+        position: (event.ms - min) / span,
+        label: event.label,
+        ...(event.tone !== undefined ? { tone: event.tone } : {}),
+    }));
+}
+//# sourceMappingURL=timelineLanes.js.map

package/dist/geometry/timelineLanes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timelineLanes.js","sourceRoot":"","sources":["../../src/geometry/timelineLanes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgCH;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,KAAwB,EACxB,MAA4B,EAC5B,KAAa,EACb,MAAc,EACd,UAA6B,EAAE;IAE/B,MAAM,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IAEzE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC;QACzC,MAAM,UAAU,GAAsB,MAAM;aACzC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;aACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACf,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,KAAK;YACnD,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC,CAAC;QACN,OAAO;YACL,IAAI;YACJ,KAAK;YACL,CAAC;YACD,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,CAAC,GAAG,UAAU,GAAG,CAAC;YAC3B,MAAM,EAAE,UAAU;SACnB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAC5B,MAAyF;IAEzF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG,IAAI;QACjC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1D,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/geometry/treemap.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Pure treemap geometry (`chart-treemap`, research/widget-registry.md §2):
+ * squarified slice-and-dice layout (Bruls/Huizing/van Wijk) over a flat,
+ * value-weighted category list. DOM-free and deterministic so scheduled-report
+ * workers rasterize the identical layout the browser renders (04 §7.1).
+ *
+ * RTL: the caller mirrors the x axis (`mirrorTiles`) — the layout math itself
+ * stays orientation-neutral (categorical part-to-whole mirrors per §7.4).
+ */
+export interface TreemapInput {
+    label: string;
+    value: number;
+}
+export interface TreemapTile {
+    label: string;
+    value: number;
+    /** Fraction of the total, 0..1. */
+    share: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** `var(--viz-N)` cycling by input order. */
+    colorVar: string;
+    /** Sequential alpha ramp step for area intensity (var(--viz-ramp-N)). */
+    rampVar: string;
+}
+export interface TreemapOptions {
+    width: number;
+    height: number;
+    /** Slices beyond this fold into a trailing "other" tile (default Infinity). */
+    maxTiles?: number;
+    otherLabel?: string;
+}
+/**
+ * Squarified treemap tiles in input order (color cycles by order; area alpha
+ * ramps by value rank). Non-positive and non-finite values are dropped.
+ */
+export declare function treemapTiles(input: readonly TreemapInput[], options: TreemapOptions): TreemapTile[];
+/** Mirror tiles across the vertical axis for RTL rendering. */
+export declare function mirrorTiles(tiles: readonly TreemapTile[], width: number): TreemapTile[];
+//# sourceMappingURL=treemap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treemap.d.ts","sourceRoot":"","sources":["../../src/geometry/treemap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmCD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,OAAO,EAAE,cAAc,GACtB,WAAW,EAAE,CA4Ff;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAEvF"}

package/dist/geometry/treemap.js

@@ -0,0 +1,134 @@
+/**
+ * Pure treemap geometry (`chart-treemap`, research/widget-registry.md §2):
+ * squarified slice-and-dice layout (Bruls/Huizing/van Wijk) over a flat,
+ * value-weighted category list. DOM-free and deterministic so scheduled-report
+ * workers rasterize the identical layout the browser renders (04 §7.1).
+ *
+ * RTL: the caller mirrors the x axis (`mirrorTiles`) — the layout math itself
+ * stays orientation-neutral (categorical part-to-whole mirrors per §7.4).
+ */
+function vizColor(index) {
+    return `var(--viz-${(index % 8) + 1})`;
+}
+/** Ramp step 1..6 by descending rank (largest tile = strongest). */
+function rampColor(rank, count) {
+    if (count <= 1)
+        return 'var(--viz-ramp-6)';
+    const step = 6 - Math.round((rank / (count - 1)) * 5); // rank 0 → 6, last → 1
+    return `var(--viz-ramp-${Math.min(6, Math.max(1, step))})`;
+}
+function worstRatio(row, length) {
+    if (length <= 0 || row.length === 0)
+        return Infinity;
+    let min = Infinity;
+    let max = -Infinity;
+    let sum = 0;
+    for (const area of row) {
+        if (area < min)
+            min = area;
+        if (area > max)
+            max = area;
+        sum += area;
+    }
+    const side2 = length * length;
+    const sum2 = sum * sum;
+    return Math.max((side2 * max) / sum2, sum2 / (side2 * min));
+}
+/**
+ * Squarified treemap tiles in input order (color cycles by order; area alpha
+ * ramps by value rank). Non-positive and non-finite values are dropped.
+ */
+export function treemapTiles(input, options) {
+    const { width, height, maxTiles = Infinity, otherLabel = 'Other' } = options;
+    if (width <= 0 || height <= 0)
+        return [];
+    // Fold overflow into an "other" tile, preserving input order/color indices.
+    let items = input.filter((d) => Number.isFinite(d.value) && d.value > 0);
+    const colorIndex = new Map();
+    items.forEach((item, i) => colorIndex.set(item, i));
+    if (Number.isFinite(maxTiles) && items.length > maxTiles) {
+        const kept = items.slice(0, maxTiles);
+        const rest = items.slice(maxTiles).reduce((sum, d) => sum + d.value, 0);
+        const other = { label: otherLabel, value: rest };
+        colorIndex.set(other, maxTiles);
+        items = [...kept, other];
+    }
+    const total = items.reduce((sum, d) => sum + d.value, 0);
+    if (total <= 0)
+        return [];
+    const area = width * height;
+    // Descending scaled areas drive squarify; original index rides along for order.
+    const scaled = items
+        .map((item, index) => ({ item, index, area: (item.value / total) * area }))
+        .sort((a, b) => b.area - a.area || a.index - b.index);
+    const placed = [];
+    const cursor = { x: 0, y: 0, width, height };
+    let row = [];
+    const shortSide = () => Math.min(cursor.width, cursor.height);
+    const layoutRow = () => {
+        if (row.length === 0)
+            return;
+        const rowArea = row.reduce((sum, r) => sum + r.area, 0);
+        const horizontal = cursor.width >= cursor.height;
+        if (horizontal) {
+            const rowWidth = rowArea / cursor.height;
+            let offset = cursor.y;
+            for (const cell of row) {
+                const cellHeight = (cell.area / rowArea) * cursor.height;
+                placed.push({ index: cell.index, x: cursor.x, y: offset, width: rowWidth, height: cellHeight });
+                offset += cellHeight;
+            }
+            cursor.x += rowWidth;
+            cursor.width -= rowWidth;
+        }
+        else {
+            const rowHeight = rowArea / cursor.width;
+            let offset = cursor.x;
+            for (const cell of row) {
+                const cellWidth = (cell.area / rowArea) * cursor.width;
+                placed.push({ index: cell.index, x: offset, y: cursor.y, width: cellWidth, height: rowHeight });
+                offset += cellWidth;
+            }
+            cursor.y += rowHeight;
+            cursor.height -= rowHeight;
+        }
+        row = [];
+    };
+    for (const cell of scaled) {
+        const length = shortSide();
+        const current = row.map((r) => r.area);
+        const withCell = [...current, cell.area];
+        if (row.length === 0 || worstRatio(withCell, length) <= worstRatio(current, length)) {
+            row.push({ index: cell.index, area: cell.area });
+        }
+        else {
+            layoutRow();
+            row.push({ index: cell.index, area: cell.area });
+        }
+    }
+    layoutRow();
+    // Rank by value (descending) for the alpha ramp.
+    const rankByIndex = new Map();
+    [...scaled].forEach((cell, rank) => rankByIndex.set(cell.index, rank));
+    return placed
+        .sort((a, b) => a.index - b.index)
+        .map((p) => {
+        const source = items[p.index];
+        return {
+            label: source.label,
+            value: source.value,
+            share: source.value / total,
+            x: p.x,
+            y: p.y,
+            width: p.width,
+            height: p.height,
+            colorVar: vizColor(colorIndex.get(source) ?? p.index),
+            rampVar: rampColor(rankByIndex.get(p.index) ?? 0, placed.length),
+        };
+    });
+}
+/** Mirror tiles across the vertical axis for RTL rendering. */
+export function mirrorTiles(tiles, width) {
+    return tiles.map((tile) => ({ ...tile, x: width - tile.x - tile.width }));
+}
+//# sourceMappingURL=treemap.js.map

package/dist/geometry/treemap.js.map

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

package/dist/geometry/waterfall.d.ts

@@ -0,0 +1,40 @@
+export type WaterfallStepType = 'up' | 'down' | 'total';
+export interface WaterfallInput {
+    label: string;
+    /** Magnitude (non-negative). Sign is implied by `type`. */
+    value: number;
+    type: WaterfallStepType;
+}
+export interface WaterfallBar {
+    index: number;
+    label: string;
+    value: number;
+    type: WaterfallStepType;
+    /** Running level after this step (the connector level to the next bar). */
+    exitLevel: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    centerX: number;
+}
+export interface WaterfallConnector {
+    fromIndex: number;
+    x1: number;
+    x2: number;
+    y: number;
+}
+export interface WaterfallLayout {
+    bars: WaterfallBar[];
+    connectors: WaterfallConnector[];
+    yTicks: number[];
+    yFor: (value: number) => number;
+}
+export interface WaterfallLayoutOptions {
+    width: number;
+    height: number;
+    rtl: boolean;
+    tickCount?: number;
+}
+export declare function layoutWaterfall(items: readonly WaterfallInput[], options: WaterfallLayoutOptions): WaterfallLayout;
+//# sourceMappingURL=waterfall.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"waterfall.d.ts","sourceRoot":"","sources":["../../src/geometry/waterfall.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC;IACxB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,EAAE,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA6ElH"}

package/dist/geometry/waterfall.js

@@ -0,0 +1,80 @@
+/**
+ * Pure waterfall / bridge layout (`chart-waterfall`, research/widget-registry.md
+ * §2): floating bars for signed steps plus total anchors, with connector
+ * segments riding the running level. DOM-free. Categorical x mirrors in RTL
+ * (band-scale flip); connectors bridge adjacent bars on the correct logical
+ * side so they read left→right in LTR and right→left in RTL.
+ */
+import { categoricalBandScale } from './scales.js';
+import { niceTicks } from '../utils/stats.js';
+export function layoutWaterfall(items, options) {
+    const { width, height, rtl, tickCount = 3 } = options;
+    if (items.length === 0 || width <= 0 || height <= 0) {
+        return { bars: [], connectors: [], yTicks: [], yFor: () => 0 };
+    }
+    // First pass in value-space: resolve each bar's low/high band and exit level.
+    let running = 0;
+    const spans = items.map((item) => {
+        const magnitude = Math.max(0, item.value);
+        let low;
+        let high;
+        if (item.type === 'total') {
+            running = item.value;
+            low = Math.min(0, item.value);
+            high = Math.max(0, item.value);
+        }
+        else if (item.type === 'down') {
+            high = running;
+            running -= magnitude;
+            low = running;
+        }
+        else {
+            low = running;
+            running += magnitude;
+            high = running;
+        }
+        return { low, high, exitLevel: running };
+    });
+    const highest = spans.reduce((m, s) => Math.max(m, s.high), 0);
+    const lowest = spans.reduce((m, s) => Math.min(m, s.low), 0);
+    const ticks = niceTicks(Math.min(0, lowest), Math.max(1, highest), tickCount);
+    const domainLo = ticks[0] ?? Math.min(0, lowest);
+    const domainHi = ticks.at(-1) ?? Math.max(1, highest);
+    const span = domainHi - domainLo || 1;
+    const yFor = (value) => height - ((value - domainLo) / span) * height;
+    const band = categoricalBandScale(items.map((item) => item.label), width, rtl, { paddingInner: 0.34, paddingOuter: 0.18 });
+    const bandwidth = band.bandwidth();
+    const bars = items.map((item, index) => {
+        const s = spans[index] ?? { low: 0, high: 0, exitLevel: 0 };
+        const x = band(item.label) ?? 0;
+        const yHigh = yFor(s.high);
+        const yLow = yFor(s.low);
+        return {
+            index,
+            label: item.label,
+            value: item.value,
+            type: item.type,
+            exitLevel: s.exitLevel,
+            x,
+            y: Math.min(yHigh, yLow),
+            width: bandwidth,
+            height: Math.max(0, Math.abs(yLow - yHigh)),
+            centerX: x + bandwidth / 2,
+        };
+    });
+    const connectors = [];
+    for (let i = 0; i < bars.length - 1; i += 1) {
+        const a = bars[i];
+        const b = bars[i + 1];
+        if (a === undefined || b === undefined)
+            continue;
+        connectors.push({
+            fromIndex: i,
+            x1: rtl ? a.x : a.x + a.width,
+            x2: rtl ? b.x + b.width : b.x,
+            y: yFor(a.exitLevel),
+        });
+    }
+    return { bars, connectors, yTicks: ticks, yFor };
+}
+//# sourceMappingURL=waterfall.js.map

package/dist/geometry/waterfall.js.map

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