@adminiumjs/charts 0.1.0-rc.1

package/dist/components/AnomalyChart.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `chart-anomaly` primitive (research/widget-registry.md §2): actual line over
+ * an expected-range band + dashed expected line + halo dots on anomalies. A
+ * time axis (never mirrors, 04 §7.4). The expected band + anomaly flags are
+ * computed by the pure `anomalyModel` (z-score). Colors from the viz palette
+ * and the danger token only.
+ */
+import type { ReactNode } from 'react';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface AnomalyPoint {
+    x: Date;
+    y: number;
+}
+export interface AnomalyChartProps {
+    points: readonly AnomalyPoint[];
+    labels: ChartLabels;
+    height?: number;
+    /** z-score threshold for flagging anomalies (default 2). */
+    sensitivity?: number;
+    /** Centered moving-average window for the expected line (default 7). */
+    window?: number;
+    showAxis?: boolean;
+    formatY?: (y: number) => string;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function AnomalyChart({ points, labels, height, sensitivity, window, showAxis, formatY, dir, a11yFallback, className, }: AnomalyChartProps): import("react").JSX.Element;
+//# sourceMappingURL=AnomalyChart.d.ts.map

package/dist/components/AnomalyChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnomalyChart.d.ts","sourceRoot":"","sources":["../../src/components/AnomalyChart.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAInD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,IAAI,CAAC;IACR,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,MAAM,EACN,MAAY,EACZ,WAAe,EACf,MAAU,EACV,QAAe,EACf,OAAuB,EACvB,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,iBAAiB,+BA4FnB"}

package/dist/components/AnomalyChart.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { anomalyModel } from '../geometry/anomaly.js';
+import { confidenceBandPath } from '../geometry/forecast.js';
+import { linePath } from '../geometry/lineArea.js';
+import { linearYScale, timeScale } from '../geometry/scales.js';
+import { extent, niceTicks } from '../utils/stats.js';
+import { formatCompact } from '../utils/format.js';
+import { ChartSurface } from './ChartSurface.js';
+export function AnomalyChart({ points, labels, height = 220, sensitivity = 2, window = 7, showAxis = true, formatY = formatCompact, dir, a11yFallback, className, }) {
+    return (_jsx(ChartSurface, { labels: labels, height: height, ...(dir !== undefined ? { dir } : {}), ...(a11yFallback !== undefined ? { a11yFallback } : {}), ...(className !== undefined ? { className } : {}), padding: { top: 10, bottom: showAxis ? 22 : 8, left: showAxis ? 38 : 6, right: 10 }, children: ({ innerWidth, innerHeight, rtl, mounted }) => {
+            if (points.length === 0 || innerWidth <= 0 || innerHeight <= 0)
+                return null;
+            const dates = points.map((p) => p.x.getTime());
+            const [loT, hiT] = extent(dates) ?? [0, 1];
+            const xScale = timeScale([new Date(loT), new Date(hiT)], innerWidth);
+            const values = points.map((p) => p.y);
+            const model = anomalyModel(values, sensitivity, window);
+            const ys = [...values, ...model.lo, ...model.hi];
+            const [minY, maxY] = extent(ys) ?? [0, 1];
+            const yTicks = niceTicks(Math.min(0, minY), Math.max(1, maxY), 3);
+            const yScale = linearYScale([yTicks[0] ?? 0, yTicks.at(-1) ?? 1], innerHeight);
+            const xAt = (i) => xScale(points[i].x);
+            const upper = points.map((_, i) => ({ x: xAt(i), y: yScale(model.hi[i] ?? 0) }));
+            const lower = points.map((_, i) => ({ x: xAt(i), y: yScale(model.lo[i] ?? 0) }));
+            const bandPath = confidenceBandPath(upper, lower);
+            const midLine = linePath(points.map((_, i) => ({ x: xAt(i), y: yScale(model.mid[i] ?? 0) })), true);
+            const actualLine = linePath(points.map((p, i) => ({ x: xAt(i), y: yScale(p.y) })), false);
+            return (_jsxs("g", { className: "adm-chart-fade", style: { '--adm-fade': mounted ? '1' : '0' }, children: [showAxis &&
+                        yTicks.map((tick) => (_jsxs("g", { children: [_jsx("line", { className: "adm-chart-gridline", x1: 0, x2: innerWidth, y1: yScale(tick), y2: yScale(tick) }), _jsx("text", { className: "adm-chart-axis-label adm-chart-num", x: rtl ? innerWidth + 6 : -6, y: yScale(tick) + 3, textAnchor: rtl ? 'start' : 'end', children: formatY(tick) })] }, tick))), bandPath !== null && (_jsx("path", { d: bandPath, fill: "var(--viz-1)", fillOpacity: 0.12, stroke: "none", "data-band": "expected" })), midLine !== null && (_jsx("path", { d: midLine, fill: "none", stroke: "var(--fg-subtle)", strokeWidth: 1.5, strokeDasharray: "4 4", "data-series": "expected" })), actualLine !== null && (_jsx("path", { d: actualLine, fill: "none", stroke: "var(--viz-1)", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", "data-series": "actual" })), model.anomalies.map((i) => (_jsxs("g", { "data-anomaly": i, children: [_jsx("circle", { cx: xAt(i), cy: yScale(values[i] ?? 0), r: 7, fill: "var(--danger)", fillOpacity: 0.22 }), _jsx("circle", { cx: xAt(i), cy: yScale(values[i] ?? 0), r: 3.5, fill: "var(--danger)", stroke: "var(--surface)", strokeWidth: 1.5 })] }, `anomaly-${i}`)))] }));
+        } }));
+}
+//# sourceMappingURL=AnomalyChart.js.map

package/dist/components/AnomalyChart.js.map

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

package/dist/components/BarChart.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `chart-bar` primitive (research/widget-registry.md §2): categorical columns
+ * with highlight max|current|none, grouped 2-series mode, RTL category
+ * mirroring (band-scale range flip), nb-grow-style mount animation.
+ */
+import type { ReactNode } from 'react';
+import type { HighlightMode } from '../geometry/bars.js';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface BarSeries {
+    name: string;
+    values: readonly number[];
+}
+export interface BarChartProps {
+    categories: readonly string[];
+    /** 1 series = plain columns; 2 series = grouped mode. */
+    series: readonly BarSeries[];
+    labels: ChartLabels;
+    /** Ignored in grouped mode. Default 'max'. */
+    highlight?: HighlightMode;
+    height?: number;
+    /** Show y gridlines + tick labels (default true). */
+    showAxis?: boolean;
+    /** Show category labels under the columns (default true). */
+    showCategoryLabels?: boolean;
+    barRadius?: number;
+    formatY?: (y: number) => string;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function BarChart({ categories, series, labels, highlight, height, showAxis, showCategoryLabels, barRadius, formatY, dir, a11yFallback, className, }: BarChartProps): import("react").JSX.Element;
+//# sourceMappingURL=BarChart.d.ts.map

package/dist/components/BarChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BarChart.d.ts","sourceRoot":"","sources":["../../src/components/BarChart.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,yDAAyD;IACzD,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,wBAAgB,QAAQ,CAAC,EACvB,UAAU,EACV,MAAM,EACN,MAAM,EACN,SAAiB,EACjB,MAAY,EACZ,QAAe,EACf,kBAAyB,EACzB,SAAa,EACb,OAAuB,EACvB,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,aAAa,+BAgGf"}

package/dist/components/BarChart.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { highlightIndex, layoutBars } from '../geometry/bars.js';
+import { formatCompact } from '../utils/format.js';
+import { ChartSurface } from './ChartSurface.js';
+/** Series color assignment: grouped mode viz-1/viz-2; single series uses the
+ * accent ramp with the highlighted column at full accent. */
+const GROUPED_FILLS = ['var(--viz-1)', 'var(--viz-2)'];
+export function BarChart({ categories, series, labels, highlight = 'max', height = 220, showAxis = true, showCategoryLabels = true, barRadius = 3, formatY = formatCompact, dir, a11yFallback, className, }) {
+    const axisPad = {
+        top: 8,
+        bottom: showCategoryLabels ? 22 : 6,
+        near: showAxis ? 38 : 6,
+        far: 8,
+    };
+    const grouped = series.length > 1;
+    return (_jsx(ChartSurface, { labels: labels, height: height, ...(dir !== undefined ? { dir } : {}), ...(a11yFallback !== undefined ? { a11yFallback } : {}), ...(className !== undefined ? { className } : {}), padding: { top: axisPad.top, bottom: axisPad.bottom, left: axisPad.near, right: axisPad.far }, children: ({ innerWidth, innerHeight, rtl, mounted }) => {
+            if (categories.length === 0 || series.length === 0 || innerWidth <= 0 || innerHeight <= 0) {
+                return null;
+            }
+            const layout = layoutBars({
+                categories,
+                series: series.map((s) => s.values),
+                width: innerWidth,
+                height: innerHeight,
+                rtl,
+            });
+            const highlighted = grouped ? -1 : highlightIndex([...(series[0]?.values ?? [])], highlight);
+            return (_jsxs("g", { children: [showAxis &&
+                        layout.yTicks.map((tick) => (_jsxs("g", { children: [_jsx("line", { className: "adm-chart-gridline", x1: 0, x2: innerWidth, y1: layout.yFor(tick), y2: layout.yFor(tick) }), _jsx("text", { className: "adm-chart-axis-label adm-chart-num", x: rtl ? innerWidth + 6 : -6, y: layout.yFor(tick) + 3, textAnchor: rtl ? 'start' : 'end', children: formatY(tick) })] }, tick))), layout.bars.map((bar) => {
+                        const fill = grouped
+                            ? GROUPED_FILLS[bar.seriesIndex % 2]
+                            : bar.categoryIndex === highlighted
+                                ? 'var(--accent)'
+                                : 'var(--viz-ramp-3)';
+                        return (_jsx("rect", { className: "adm-chart-grow", style: { '--adm-grow': mounted ? '1' : '0', '--adm-stagger': `${bar.categoryIndex * 80}ms` }, x: bar.x, y: bar.y, width: bar.width, height: bar.height, rx: barRadius, fill: fill, "data-category-index": bar.categoryIndex, "data-series-index": bar.seriesIndex, "data-highlighted": bar.categoryIndex === highlighted ? '' : undefined }, `${bar.categoryIndex}-${bar.seriesIndex}`));
+                    }), showCategoryLabels &&
+                        layout.categoryCenters.map((center) => (_jsx("text", { className: "adm-chart-axis-label", x: center.x, y: innerHeight + 15, textAnchor: "middle", children: center.label }, center.label)))] }));
+        } }));
+}
+//# sourceMappingURL=BarChart.js.map

package/dist/components/BarChart.js.map

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

package/dist/components/BoxPlotChart.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `chart-boxplot` primitive (research/widget-registry.md §2): whisker/box/median
+ * per category with a y-axis tick scale. Categorical x mirrors in RTL (band
+ * range flip); the value axis stays pixel-down. Token-only colors; fade-in on
+ * mount with the reduced-motion fallback baked into `useMountAnimation`.
+ */
+import type { ReactNode } from 'react';
+import type { BoxplotGroupInput } from '../geometry/distribution.js';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface BoxPlotChartProps {
+    groups: readonly BoxplotGroupInput[];
+    labels: ChartLabels;
+    height?: number;
+    showAxis?: boolean;
+    showCategoryLabels?: boolean;
+    formatY?: (y: number) => string;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function BoxPlotChart({ groups, labels, height, showAxis, showCategoryLabels, formatY, dir, a11yFallback, className, }: BoxPlotChartProps): import("react").JSX.Element;
+//# sourceMappingURL=BoxPlotChart.d.ts.map

package/dist/components/BoxPlotChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxPlotChart.d.ts","sourceRoot":"","sources":["../../src/components/BoxPlotChart.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,MAAM,EACN,MAAY,EACZ,QAAe,EACf,kBAAyB,EACzB,OAAuB,EACvB,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,iBAAiB,+BA6GnB"}

package/dist/components/BoxPlotChart.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { boxplotLayout } from '../geometry/distribution.js';
+import { formatCompact } from '../utils/format.js';
+import { ChartSurface } from './ChartSurface.js';
+export function BoxPlotChart({ groups, labels, height = 260, showAxis = true, showCategoryLabels = true, formatY = formatCompact, dir, a11yFallback, className, }) {
+    const pad = {
+        top: 8,
+        bottom: showCategoryLabels ? 22 : 6,
+        near: showAxis ? 40 : 6,
+        far: 10,
+    };
+    return (_jsx(ChartSurface, { labels: labels, height: height, ...(dir !== undefined ? { dir } : {}), ...(a11yFallback !== undefined ? { a11yFallback } : {}), ...(className !== undefined ? { className } : {}), padding: { top: pad.top, bottom: pad.bottom, left: pad.near, right: pad.far }, children: ({ innerWidth, innerHeight, rtl, mounted }) => {
+            if (groups.length === 0 || innerWidth <= 0 || innerHeight <= 0)
+                return null;
+            const layout = boxplotLayout(groups, { width: innerWidth, height: innerHeight, rtl });
+            return (_jsxs("g", { className: "adm-chart-fade", style: { '--adm-fade': mounted ? '1' : '0' }, children: [showAxis &&
+                        layout.yTicks.map((tick) => (_jsxs("g", { children: [_jsx("line", { className: "adm-chart-gridline", x1: 0, x2: innerWidth, y1: layout.yFor(tick), y2: layout.yFor(tick) }), _jsx("text", { className: "adm-chart-axis-label adm-chart-num", x: rtl ? innerWidth + 6 : -6, y: layout.yFor(tick) + 3, textAnchor: rtl ? 'start' : 'end', children: formatY(tick) })] }, tick))), layout.boxes.map((box) => {
+                        const capHalf = box.boxWidth / 2;
+                        return (_jsxs("g", { "data-box": box.label, children: [_jsx("line", { x1: box.centerX, x2: box.centerX, y1: box.yMax, y2: box.yMin, stroke: "var(--viz-1)", strokeWidth: 1.5 }), _jsx("line", { x1: box.centerX - capHalf / 2, x2: box.centerX + capHalf / 2, y1: box.yMax, y2: box.yMax, stroke: "var(--viz-1)", strokeWidth: 1.5 }), _jsx("line", { x1: box.centerX - capHalf / 2, x2: box.centerX + capHalf / 2, y1: box.yMin, y2: box.yMin, stroke: "var(--viz-1)", strokeWidth: 1.5 }), _jsx("rect", { x: box.boxX, y: box.yQ3, width: box.boxWidth, height: Math.max(0, box.yQ1 - box.yQ3), rx: 2, fill: "var(--accent-area)", stroke: "var(--viz-1)", strokeWidth: 1.5, "data-box-rect": "" }), _jsx("line", { x1: box.boxX, x2: box.boxX + box.boxWidth, y1: box.yMed, y2: box.yMed, stroke: "var(--viz-1)", strokeWidth: 2, "data-median": "" })] }, box.label));
+                    }), showCategoryLabels &&
+                        layout.boxes.map((box) => (_jsx("text", { className: "adm-chart-axis-label", x: box.centerX, y: innerHeight + 15, textAnchor: "middle", children: box.label }, box.label)))] }));
+        } }));
+}
+//# sourceMappingURL=BoxPlotChart.js.map

package/dist/components/BoxPlotChart.js.map

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

package/dist/components/BulletChart.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `chart-bullet` primitive (research/widget-registry.md §2): rows of qualitative
+ * bands + a measure bar + a target tick, with an inline-start label gutter and
+ * an inline-end value. Composed from ChartSurface + pure `layoutBullet` geometry
+ * (identical SVG in Node and browser). Colors resolve from viz/semantic tokens
+ * only; the horizontal value axis mirrors in RTL; entrance fades in on mount
+ * with a reduced-motion final-state fallback.
+ */
+import type { ReactNode } from 'react';
+import type { BulletInput } from '../geometry/bullet.js';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface BulletChartProps {
+    data: readonly BulletInput[];
+    labels: ChartLabels;
+    height?: number;
+    /** Inline-start label gutter width, px (default 92). */
+    labelGutter?: number;
+    /** Inline-end value gutter width, px (default 52). */
+    valueGutter?: number;
+    formatValue?: (value: number) => string;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function BulletChart({ data, labels, height, labelGutter, valueGutter, formatValue, dir, a11yFallback, className, }: BulletChartProps): import("react").JSX.Element;
+//# sourceMappingURL=BulletChart.d.ts.map

package/dist/components/BulletChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BulletChart.d.ts","sourceRoot":"","sources":["../../src/components/BulletChart.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,MAAM,EACN,MAAY,EACZ,WAAgB,EAChB,WAAgB,EAChB,WAA2B,EAC3B,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,gBAAgB,+BAsFlB"}

package/dist/components/BulletChart.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { layoutBullet } from '../geometry/bullet.js';
+import { formatCompact } from '../utils/format.js';
+import { ChartSurface } from './ChartSurface.js';
+/** Band level (0..1) → accent ramp token (ramp-1 lightest → ramp-3). */
+function bandColor(level) {
+    return `var(--viz-ramp-${1 + Math.round(level * 2)})`;
+}
+export function BulletChart({ data, labels, height = 200, labelGutter = 92, valueGutter = 52, formatValue = formatCompact, dir, a11yFallback, className, }) {
+    return (_jsx(ChartSurface, { labels: labels, height: height, ...(dir !== undefined ? { dir } : {}), ...(a11yFallback !== undefined ? { a11yFallback } : {}), ...(className !== undefined ? { className } : {}), padding: { top: 4, bottom: 4, left: 2, right: 2 }, children: ({ innerWidth, innerHeight, rtl, mounted }) => {
+            const trackWidth = Math.max(0, innerWidth - labelGutter - valueGutter);
+            if (data.length === 0 || trackWidth <= 0 || innerHeight <= 0)
+                return null;
+            const trackStart = rtl ? valueGutter : labelGutter;
+            const layout = layoutBullet(data, { width: trackWidth, height: innerHeight, rtl });
+            const labelEdge = rtl ? innerWidth : 0;
+            const valueEdge = rtl ? 0 : innerWidth;
+            return (_jsx("g", { className: "adm-chart-fade", style: { '--adm-fade': mounted ? '1' : '0' }, children: layout.rows.map((row) => {
+                    const midY = row.rowY + layout.rowHeight / 2 + 3;
+                    return (_jsxs("g", { "data-bullet-row": row.index, children: [row.bands.map((bandSeg) => (_jsx("rect", { x: trackStart + bandSeg.x, y: row.trackY, width: bandSeg.width, height: row.trackHeight, rx: 2, fill: bandColor(bandSeg.level), "data-band": bandSeg.index }, bandSeg.index))), _jsx("rect", { x: trackStart + row.measureX, y: row.measureY, width: row.measureWidth, height: row.measureHeight, rx: 1.5, fill: "var(--fg)", "data-measure": "" }), _jsx("rect", { x: trackStart + row.targetX - 1, y: row.trackY - 2, width: 2, height: row.trackHeight + 4, fill: "var(--danger)", "data-target": "" }), _jsx("text", { className: "adm-chart-axis-label", x: labelEdge, y: midY, textAnchor: rtl ? 'end' : 'start', children: row.label }), _jsx("text", { className: "adm-chart-num", x: valueEdge, y: midY, textAnchor: rtl ? 'start' : 'end', fontSize: 11, fontWeight: 700, fill: "var(--fg)", children: formatValue(row.measure) })] }, row.label));
+                }) }));
+        } }));
+}
+//# sourceMappingURL=BulletChart.js.map

package/dist/components/BulletChart.js.map

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

package/dist/components/BumpChart.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `chart-bump` primitive (research/widget-registry.md §2): rank-over-time
+ * polylines with hollow dots and end labels (channel rank). Rank is an ordinal
+ * axis, so the period axis mirrors in RTL (04 §7.4 — rankings mirror) and end
+ * labels sit on the inline-end. Colors from the viz palette only.
+ */
+import type { ReactNode } from 'react';
+import type { BumpSeries } from '../geometry/bump.js';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface BumpChartProps {
+    series: readonly BumpSeries[];
+    labels: ChartLabels;
+    /** Number of ordered periods (x buckets). */
+    periods: number;
+    /** Worst rank shown (y extent). */
+    maxRank: number;
+    /** Period axis tick labels (bottom); defaults to 1…periods. */
+    periodLabels?: readonly string[];
+    height?: number;
+    showEndLabels?: boolean;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function BumpChart({ series, labels, periods, maxRank, periodLabels, height, showEndLabels, dir, a11yFallback, className, }: BumpChartProps): import("react").JSX.Element;
+//# sourceMappingURL=BumpChart.d.ts.map

package/dist/components/BumpChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BumpChart.d.ts","sourceRoot":"","sources":["../../src/components/BumpChart.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,SAAS,CAAC,EACxB,MAAM,EACN,MAAM,EACN,OAAO,EACP,OAAO,EACP,YAAY,EACZ,MAAY,EACZ,aAAoB,EACpB,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,cAAc,+BAoGhB"}

package/dist/components/BumpChart.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { layoutBump } from '../geometry/bump.js';
+import { multiSeriesPaths, seriesColorVar } from '../geometry/multiLine.js';
+import { ChartSurface } from './ChartSurface.js';
+const SIDE_PAD = 54;
+export function BumpChart({ series, labels, periods, maxRank, periodLabels, height = 240, showEndLabels = true, dir, a11yFallback, className, }) {
+    return (_jsx(ChartSurface, { labels: labels, height: height, ...(dir !== undefined ? { dir } : {}), ...(a11yFallback !== undefined ? { a11yFallback } : {}), ...(className !== undefined ? { className } : {}), padding: { top: 10, bottom: 22, left: SIDE_PAD, right: SIDE_PAD }, children: ({ innerWidth, innerHeight, rtl, mounted }) => {
+            if (series.length === 0 || periods <= 0 || maxRank <= 0 || innerWidth <= 0 || innerHeight <= 0) {
+                return null;
+            }
+            const layout = layoutBump(series, periods, maxRank, innerWidth, innerHeight, rtl);
+            const paths = multiSeriesPaths(layout.lines.map((l) => ({ key: l.key, label: l.label, points: l.points })), false);
+            return (_jsxs("g", { className: "adm-chart-fade", style: { '--adm-fade': mounted ? '1' : '0' }, children: [Array.from({ length: maxRank }, (_, r) => (_jsx("line", { className: "adm-chart-gridline", x1: 0, x2: innerWidth, y1: layout.yForRank(r + 1), y2: layout.yForRank(r + 1) }, r))), Array.from({ length: periods }, (_, i) => (_jsx("text", { className: "adm-chart-axis-label", x: layout.xForPeriod(i), y: innerHeight + 15, textAnchor: "middle", children: periodLabels?.[i] ?? String(i + 1) }, `period-${i}`))), paths.map((sp, i) => sp.path === null ? null : (_jsx("path", { d: sp.path, fill: "none", stroke: seriesColorVar(i), strokeWidth: 2.5, strokeLinecap: "round", strokeLinejoin: "round", "data-series": sp.key }, sp.key))), layout.lines.map((line, i) => line.points.map((point, j) => (_jsx("circle", { cx: point.x, cy: point.y, r: 3.5, fill: "var(--surface)", stroke: seriesColorVar(i), strokeWidth: 2, "data-series-dot": line.key }, `${line.key}-${j}`)))), showEndLabels &&
+                        paths.map((sp, i) => sp.end === null ? null : (_jsx("text", { x: sp.end.x + (rtl ? -8 : 8), y: sp.end.y + 3, textAnchor: rtl ? 'end' : 'start', fontSize: 10, fontWeight: 600, fill: seriesColorVar(i), "data-series-label": sp.key, children: sp.label }, `${sp.key}-label`)))] }));
+        } }));
+}
+//# sourceMappingURL=BumpChart.js.map

package/dist/components/BumpChart.js.map

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

package/dist/components/CandlestickChart.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `chart-candlestick` primitive (research/widget-registry.md §2): OHLC candles
+ * colored pos/danger, a dashed last-price line and an optional "live" pill.
+ * The price axis is an LTR island — candles never mirror and the price scale
+ * sits at the inline-end regardless of page direction (04 §7.4 exceptions).
+ * Colors from the pos/danger tokens and neutrals only.
+ */
+import type { ReactNode } from 'react';
+import type { Candle } from '../geometry/candles.js';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface CandlestickChartProps {
+    candles: readonly Candle[];
+    labels: ChartLabels;
+    height?: number;
+    showAxis?: boolean;
+    /** Render the "live" pill in the corner (default false). */
+    livePill?: boolean;
+    livePillLabel?: string;
+    formatPrice?: (value: number) => string;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function CandlestickChart({ candles, labels, height, showAxis, livePill, livePillLabel, formatPrice, dir, a11yFallback, className, }: CandlestickChartProps): import("react").JSX.Element;
+//# sourceMappingURL=CandlestickChart.d.ts.map

package/dist/components/CandlestickChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CandlestickChart.d.ts","sourceRoot":"","sources":["../../src/components/CandlestickChart.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,MAAM,EACN,MAAY,EACZ,QAAe,EACf,QAAgB,EAChB,aAAsB,EACtB,WAA2B,EAC3B,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,qBAAqB,+BA4FvB"}

package/dist/components/CandlestickChart.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { layoutCandles } from '../geometry/candles.js';
+import { formatCompact } from '../utils/format.js';
+import { ChartSurface } from './ChartSurface.js';
+export function CandlestickChart({ candles, labels, height = 260, showAxis = true, livePill = false, livePillLabel = 'Live', formatPrice = formatCompact, dir, a11yFallback, className, }) {
+    return (_jsx(ChartSurface, { labels: labels, height: height, ...(dir !== undefined ? { dir } : {}), ...(a11yFallback !== undefined ? { a11yFallback } : {}), ...(className !== undefined ? { className } : {}), 
+        // Price axis pinned to the right (LTR-island convention), so pad right.
+        padding: { top: 10, bottom: 8, left: 6, right: showAxis ? 44 : 8 }, children: ({ innerWidth, innerHeight, mounted }) => {
+            if (candles.length === 0 || innerWidth <= 0 || innerHeight <= 0)
+                return null;
+            const layout = layoutCandles(candles, innerWidth, innerHeight);
+            const last = candles.at(-1);
+            const lastY = layout.yFor(last.c);
+            const lastUp = last.c >= last.o;
+            return (_jsxs("g", { className: "adm-chart-fade", style: { '--adm-fade': mounted ? '1' : '0' }, children: [showAxis &&
+                        layout.yTicks.map((tick) => (_jsxs("g", { children: [_jsx("line", { className: "adm-chart-gridline", x1: 0, x2: innerWidth, y1: layout.yFor(tick), y2: layout.yFor(tick) }), _jsx("text", { className: "adm-chart-axis-label adm-chart-num", x: innerWidth + 6, y: layout.yFor(tick) + 3, textAnchor: "start", children: formatPrice(tick) })] }, tick))), layout.rects.map((rect) => {
+                        const tone = rect.up ? 'var(--pos)' : 'var(--danger)';
+                        return (_jsxs("g", { "data-candle": rect.index, "data-dir": rect.up ? 'up' : 'down', children: [_jsx("line", { x1: rect.centerX, x2: rect.centerX, y1: rect.highY, y2: rect.lowY, stroke: tone, strokeWidth: 1.25 }), _jsx("rect", { x: rect.x, y: rect.bodyY, width: rect.width, height: rect.bodyHeight, fill: tone, "data-body": "" })] }, rect.index));
+                    }), _jsx("line", { x1: 0, x2: innerWidth, y1: lastY, y2: lastY, stroke: lastUp ? 'var(--pos)' : 'var(--danger)', strokeWidth: 1, strokeDasharray: "3 3", "data-last-price": "" }), showAxis && (_jsx("text", { x: innerWidth + 6, y: lastY + 3, textAnchor: "start", fontSize: 10, fontWeight: 700, fill: lastUp ? 'var(--pos)' : 'var(--danger)', "data-last-price-label": "", children: formatPrice(last.c) })), livePill && (_jsxs("g", { "data-live-pill": "", transform: "translate(4, 2)", children: [_jsx("rect", { x: 0, y: 0, width: 44, height: 16, rx: 8, fill: "var(--pos-soft)" }), _jsx("circle", { cx: 11, cy: 8, r: 3, fill: "var(--pos)" }), _jsx("text", { x: 19, y: 11, fontSize: 9, fontWeight: 700, fill: "var(--pos)", children: livePillLabel })] }))] }));
+        } }));
+}
+//# sourceMappingURL=CandlestickChart.js.map

package/dist/components/CandlestickChart.js.map

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

package/dist/components/ChartSurface.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Responsive SVG viewport shared by every chart (workplan/04-widget-registry.md
+ * §7.2): ResizeObserver-driven width, fixed pixel height, padding model,
+ * direction context, mount-animation flag, a11y contract (role="img" +
+ * aria-label from `labels`, optional visually-hidden table fallback), and the
+ * `data-export-node` marker for the deferred raster-export hooks (§7.6).
+ */
+import type { ReactNode } from 'react';
+import type { ChartDir } from '../hooks/useRtl.js';
+export interface ChartLabels {
+    /** Required accessible name — becomes the SVG aria-label. */
+    label: string;
+    /** Optional longer description — rendered as the SVG <desc>. */
+    description?: string;
+}
+export interface ChartPadding {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+export interface ChartRenderContext {
+    /** Full viewBox width (measured). */
+    width: number;
+    /** Full viewBox height. */
+    height: number;
+    /** Plot-area width (width minus horizontal padding). */
+    innerWidth: number;
+    /** Plot-area height. */
+    innerHeight: number;
+    rtl: boolean;
+    /** Mount-animation gate — false on the first committed frame, then true. */
+    mounted: boolean;
+}
+export interface ChartSurfaceProps {
+    labels: ChartLabels;
+    height: number;
+    children: (context: ChartRenderContext) => ReactNode;
+    /**
+     * Explicit direction. Defaults to the nearest ChartDirectionContext
+     * ('ltr'). Wave B widget wrappers bridge the i18n dir here.
+     */
+    dir?: ChartDir;
+    padding?: Partial<ChartPadding>;
+    /** Width used before the first ResizeObserver measurement (and in SSR/tests). */
+    initialWidth?: number;
+    /** Accessible data-table fallback, rendered visually hidden next to the SVG. */
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function ChartSurface({ labels, height, children, dir, padding, initialWidth, a11yFallback, className, }: ChartSurfaceProps): import("react").JSX.Element;
+//# sourceMappingURL=ChartSurface.d.ts.map

package/dist/components/ChartSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartSurface.d.ts","sourceRoot":"","sources":["../../src/components/ChartSurface.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,SAAS,CAAC;IACrD;;;OAGG;IACH,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAChC,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,MAAM,EACN,QAAQ,EACR,GAAG,EACH,OAAO,EACP,YAAkB,EAClB,YAAY,EACZ,SAAS,GACV,EAAE,iBAAiB,+BA8BnB"}

package/dist/components/ChartSurface.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMeasuredWidth } from '../hooks/useChartSize.js';
+import { useMountAnimation } from '../hooks/useMountAnimation.js';
+import { ChartDirectionContext, useChartDir } from '../hooks/useRtl.js';
+const ZERO_PADDING = { top: 0, right: 0, bottom: 0, left: 0 };
+export function ChartSurface({ labels, height, children, dir, padding, initialWidth = 600, a11yFallback, className, }) {
+    const { ref, width } = useMeasuredWidth(initialWidth);
+    const resolvedDir = useChartDir(dir);
+    const mounted = useMountAnimation();
+    const pad = { ...ZERO_PADDING, ...padding };
+    const innerWidth = Math.max(0, width - pad.left - pad.right);
+    const innerHeight = Math.max(0, height - pad.top - pad.bottom);
+    return (_jsxs("div", { ref: ref, className: className === undefined ? 'adm-chart' : `adm-chart ${className}`, children: [_jsx(ChartDirectionContext.Provider, { value: resolvedDir, children: _jsxs("svg", { className: "adm-chart-svg", role: "img", "aria-label": labels.label, width: "100%", height: height, viewBox: `0 0 ${Math.max(1, width)} ${height}`, "data-export-node": "", children: [labels.description !== undefined && _jsx("desc", { children: labels.description }), _jsx("g", { transform: `translate(${pad.left}, ${pad.top})`, children: children({ width, height, innerWidth, innerHeight, rtl: resolvedDir === 'rtl', mounted }) })] }) }), a11yFallback !== undefined && _jsx("div", { className: "adm-chart-sr", children: a11yFallback })] }));
+}
+//# sourceMappingURL=ChartSurface.js.map

package/dist/components/ChartSurface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartSurface.js","sourceRoot":"","sources":["../../src/components/ChartSurface.tsx"],"names":[],"mappings":";AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgDxE,MAAM,YAAY,GAAiB,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAE5E,MAAM,UAAU,YAAY,CAAC,EAC3B,MAAM,EACN,MAAM,EACN,QAAQ,EACR,GAAG,EACH,OAAO,EACP,YAAY,GAAG,GAAG,EAClB,YAAY,EACZ,SAAS,GACS;IAClB,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAiB,YAAY,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IAEpC,MAAM,GAAG,GAAiB,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,EAAE,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAE/D,OAAO,CACL,eAAK,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,SAAS,EAAE,aACxF,KAAC,qBAAqB,CAAC,QAAQ,IAAC,KAAK,EAAE,WAAW,YAChD,eACE,SAAS,EAAC,eAAe,EACzB,IAAI,EAAC,KAAK,gBACE,MAAM,CAAC,KAAK,EACxB,KAAK,EAAC,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,sBAC7B,EAAE,aAElB,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,yBAAO,MAAM,CAAC,WAAW,GAAQ,EACtE,YAAG,SAAS,EAAE,aAAa,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,GAAG,GAAG,YAC/C,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,KAAK,KAAK,EAAE,OAAO,EAAE,CAAC,GACxF,IACA,GACyB,EAChC,YAAY,KAAK,SAAS,IAAI,cAAK,SAAS,EAAC,cAAc,YAAE,YAAY,GAAO,IAC7E,CACP,CAAC;AACJ,CAAC"}

package/dist/components/Chord.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `chart-chord` primitive (research/widget-registry.md §2): nodes on a ring
+ * sized by total pairwise volume, connected by quadratic-bezier ribbons whose
+ * opacity encodes pair weight, plus a legend of node dots. Node order steps
+ * clockwise (LTR) / CCW (RTL) to mirror per §7.4. Colors are tokens only;
+ * geometry is pure (04 §7.1).
+ */
+import type { ReactNode } from 'react';
+import type { ChordNodeInput } from '../geometry/chord.js';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface ChordLink {
+    from: string;
+    to: string;
+    weight: number;
+}
+export interface ChordChartProps {
+    nodes: readonly ChordNodeInput[];
+    links: readonly ChordLink[];
+    labels: ChartLabels;
+    /** Ring diameter in px (default 220). */
+    size?: number;
+    thickness?: number;
+    showLegend?: boolean;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function Chord({ nodes, links, labels, size, thickness, showLegend, dir, a11yFallback, className, }: ChordChartProps): import("react").JSX.Element;
+//# sourceMappingURL=Chord.d.ts.map

package/dist/components/Chord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chord.d.ts","sourceRoot":"","sources":["../../src/components/Chord.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,KAAK,EACL,MAAM,EACN,IAAU,EACV,SAAc,EACd,UAAiB,EACjB,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,eAAe,+BAuDjB"}

package/dist/components/Chord.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { adjacencyMatrix, chordLayout } from '../geometry/chord.js';
+import { useChartDir } from '../hooks/useRtl.js';
+import { useMountAnimation } from '../hooks/useMountAnimation.js';
+export function Chord({ nodes, links, labels, size = 220, thickness = 12, showLegend = true, dir, a11yFallback, className, }) {
+    const resolvedDir = useChartDir(dir);
+    const mounted = useMountAnimation();
+    const rtl = resolvedDir === 'rtl';
+    const matrix = adjacencyMatrix(nodes.map((n) => n.id), links);
+    const layout = chordLayout(nodes, matrix, { size, thickness, rtl });
+    const maxWeight = layout.ribbons.reduce((m, r) => Math.max(m, r.weight), 0);
+    return (_jsxs("div", { className: className === undefined ? 'adm-donut' : `adm-donut ${className}`, ...(dir !== undefined ? { dir: resolvedDir } : {}), "data-export-node": "", children: [_jsxs("svg", { role: "img", "aria-label": labels.label, width: size, height: size, viewBox: `0 0 ${size} ${size}`, children: [labels.description !== undefined && _jsx("desc", { children: labels.description }), _jsxs("g", { "data-chord": "", children: [layout.ribbons.map((ribbon, i) => (_jsx("path", { className: "adm-chart-fade", style: { '--adm-fade': mounted ? '1' : '0', '--adm-stagger': `${i * 60}ms` }, d: ribbon.path, fill: "none", stroke: ribbon.colorVar, strokeWidth: maxWeight > 0 ? 1.5 + (ribbon.weight / maxWeight) * 5 : 2, strokeOpacity: 0.45, strokeLinecap: "round", "data-ribbon": `${ribbon.from}-${ribbon.to}` }, `${ribbon.from}-${ribbon.to}`))), layout.arcs.map((arc) => (_jsx("path", { d: arc.path, fill: arc.colorVar, "data-node": arc.id, transform: `translate(${layout.center.x}, ${layout.center.y})` }, arc.id)))] })] }), showLegend && (_jsx("ul", { className: "adm-donut-legend", children: layout.arcs.map((arc) => (_jsxs("li", { className: "adm-donut-legend-row", children: [_jsx("span", { className: "adm-donut-legend-dot", style: { '--adm-dot': arc.colorVar }, "aria-hidden": "true" }), _jsx("span", { children: arc.label }), _jsx("span", { className: "adm-donut-legend-value", children: Math.round(arc.total) })] }, arc.id))) })), a11yFallback !== undefined && _jsx("div", { className: "adm-chart-sr", children: a11yFallback })] }));
+}
+//# sourceMappingURL=Chord.js.map

package/dist/components/Chord.js.map

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