@adminiumjs/charts 0.1.0-rc.1

package/dist/components/ChoroplethGridChart.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `chart-choropleth-grid` primitive (research/widget-registry.md §2): a US
+ * tilegram (49 state tiles) or compact region grid, tinted by the active metric,
+ * label text flipping on dark tiles, a low→high legend + per-tile tooltips.
+ * Token-only colors, mount fade with reduced-motion fallback, `data-export-node`
+ * raster marker. The tilegram is a geographic LTR island; the `grid` layout
+ * mirrors columns in RTL (04 §7.4).
+ */
+import type { ReactNode } from 'react';
+import type { ChoroplethLayoutKind, RegionPoint } from '../geometry/choropleth.js';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface ChoroplethGridChartProps {
+    points: readonly RegionPoint[];
+    /** Value key read from each point's `values` map. */
+    metric: string;
+    labels: ChartLabels;
+    layout?: ChoroplethLayoutKind;
+    columns?: number;
+    levels?: number;
+    cellSize?: number;
+    legendLabels?: {
+        low: string;
+        high: string;
+    };
+    format?: (value: number) => string;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function ChoroplethGridChart({ points, metric, labels, layout, columns, levels, cellSize, legendLabels, format, dir, a11yFallback, className, }: ChoroplethGridChartProps): import("react").JSX.Element;
+//# sourceMappingURL=ChoroplethGridChart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChoroplethGridChart.d.ts","sourceRoot":"","sources":["../../src/components/ChoroplethGridChart.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGnF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAsB,EACtB,OAAW,EACX,MAAU,EACV,QAAa,EACb,YAA2C,EAC3C,MAAe,EACf,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,wBAAwB,+BAiF1B"}

package/dist/components/ChoroplethGridChart.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { choroplethLayout } from '../geometry/choropleth.js';
+import { rampColorVar } from '../geometry/heat.js';
+import { useChartDir } from '../hooks/useRtl.js';
+import { useMountAnimation } from '../hooks/useMountAnimation.js';
+export function ChoroplethGridChart({ points, metric, labels, layout = 'us-tilegram', columns = 6, levels = 5, cellSize = 34, legendLabels = { low: 'Low', high: 'High' }, format = String, dir, a11yFallback, className, }) {
+    const resolvedDir = useChartDir(dir);
+    const mounted = useMountAnimation();
+    const rtl = resolvedDir === 'rtl';
+    const geo = choroplethLayout(points, { metric, layout, columns, levels, cellSize, rtl });
+    const legendHeight = 24;
+    const svgHeight = geo.height + legendHeight;
+    return (_jsxs("div", { className: className === undefined ? 'adm-choropleth' : `adm-choropleth ${className}`, ...(dir !== undefined ? { dir: resolvedDir } : {}), children: [_jsxs("svg", { role: "img", "aria-label": labels.label, width: geo.width, height: svgHeight, viewBox: `0 0 ${Math.max(1, geo.width)} ${Math.max(1, svgHeight)}`, "data-export-node": "", children: [labels.description !== undefined && _jsx("desc", { children: labels.description }), _jsx("g", { className: "adm-chart-fade", style: { '--adm-fade': mounted ? '1' : '0' }, children: geo.tiles.map((tile) => (_jsxs("g", { children: [_jsx("rect", { x: tile.x, y: tile.y, width: tile.size, height: tile.size, rx: 4, fill: tile.colorVar, stroke: "var(--border)", strokeWidth: 1, "data-region-tile": tile.code, "data-level": tile.level, children: _jsx("title", { children: `${tile.name}: ${format(tile.value)}` }) }), _jsx("text", { className: "adm-chart-num", x: tile.x + tile.size / 2, y: tile.y + tile.size / 2 + 3, textAnchor: "middle", fontSize: 9, fontWeight: 700, fill: tile.textLight ? 'var(--accent-fg)' : 'var(--fg-muted)', children: tile.code })] }, `${tile.code}-${tile.row}-${tile.col}`))) }), _jsxs("g", { transform: `translate(0, ${geo.height + 8})`, children: [_jsx("text", { className: "adm-chart-axis-label", x: 0, y: 11, textAnchor: "start", children: legendLabels.low }), Array.from({ length: levels }, (_, level) => (_jsx("rect", { x: 30 + level * 16, y: 2, width: 14, height: 12, rx: 2, fill: rampColorVar(level, levels) }, `lg${level}`))), _jsx("text", { className: "adm-chart-axis-label", x: 30 + levels * 16 + 4, y: 11, textAnchor: "start", children: legendLabels.high })] })] }), a11yFallback !== undefined && _jsx("div", { className: "adm-chart-sr", children: a11yFallback })] }));
+}
+//# sourceMappingURL=ChoroplethGridChart.js.map

package/dist/components/ChoroplethGridChart.js.map

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

package/dist/components/CohortMatrixChart.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `chart-cohort-matrix` primitive (research/widget-registry.md §2): cohort rows
+ * × period columns, accent-alpha cells, triangular nulls transparent, in-cell
+ * value labels that flip to the on-accent color past ~55%. Fixed cell geometry
+ * with an intrinsic size (the widget wrapper adds horizontal scroll) — the
+ * DonutChart precedent for non-responsive charts. Token-only colors, mount fade
+ * with a reduced-motion final-state fallback, `data-export-node` raster marker.
+ */
+import type { ReactNode } from 'react';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface CohortMatrixChartProps {
+    rowKeys: readonly string[];
+    colKeys: readonly string[];
+    /** cells[row][col]; null renders a triangular gap. */
+    cells: readonly (readonly (number | null)[])[];
+    labels: ChartLabels;
+    cellSize?: number;
+    /** Value at/above which the label flips to the on-accent color (default 55). */
+    flipThreshold?: number;
+    /** Value mapped to the darkest ramp step (default 100, i.e. a percent scale). */
+    maxValue?: number;
+    /** Format a non-null cell value for its label + tooltip (default `${v}%`). */
+    format?: (value: number) => string;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function CohortMatrixChart({ rowKeys, colKeys, cells, labels, cellSize, flipThreshold, maxValue, format, dir, a11yFallback, className, }: CohortMatrixChartProps): import("react").JSX.Element;
+//# sourceMappingURL=CohortMatrixChart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CohortMatrixChart.d.ts","sourceRoot":"","sources":["../../src/components/CohortMatrixChart.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,sDAAsD;IACtD,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAC/C,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,OAAO,EACP,KAAK,EACL,MAAM,EACN,QAAa,EACb,aAAkB,EAClB,QAAc,EACd,MAAsB,EACtB,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,sBAAsB,+BAmFxB"}

package/dist/components/CohortMatrixChart.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cohortLayout } from '../geometry/cohort.js';
+import { useChartDir } from '../hooks/useRtl.js';
+import { useMountAnimation } from '../hooks/useMountAnimation.js';
+const defaultFormat = (value) => `${Math.round(value)}%`;
+export function CohortMatrixChart({ rowKeys, colKeys, cells, labels, cellSize = 40, flipThreshold = 55, maxValue = 100, format = defaultFormat, dir, a11yFallback, className, }) {
+    const resolvedDir = useChartDir(dir);
+    const mounted = useMountAnimation();
+    const rtl = resolvedDir === 'rtl';
+    const layout = cohortLayout(rowKeys, colKeys, cells, { cellSize, flipThreshold, maxValue, rtl });
+    return (_jsxs("div", { className: className === undefined ? 'adm-cohort' : `adm-cohort ${className}`, ...(dir !== undefined ? { dir: resolvedDir } : {}), children: [_jsxs("svg", { role: "img", "aria-label": labels.label, width: layout.width, height: layout.height, viewBox: `0 0 ${Math.max(1, layout.width)} ${Math.max(1, layout.height)}`, "data-export-node": "", children: [labels.description !== undefined && _jsx("desc", { children: labels.description }), layout.colLabels.map((col) => (_jsx("text", { className: "adm-chart-axis-label", x: col.pos, y: 12, textAnchor: "middle", children: col.label }, `c${col.index}`))), layout.rowLabels.map((row) => (_jsx("text", { className: "adm-chart-axis-label", x: layout.rowLabelX, y: row.pos + 3, textAnchor: layout.rowLabelAnchor, children: row.label }, `r${row.index}`))), _jsx("g", { className: "adm-chart-fade", style: { '--adm-fade': mounted ? '1' : '0' }, children: layout.cells.map((cell) => (_jsxs("g", { children: [_jsx("rect", { x: cell.x, y: cell.y, width: cell.size, height: cell.size, rx: 4, fill: cell.colorVar, "data-cohort-cell": "", "data-gap": cell.value === null ? '' : undefined, children: cell.value !== null && (_jsx("title", { children: `${rowKeys[cell.row] ?? ''} · ${colKeys[cell.col] ?? ''}: ${format(cell.value)}` })) }), cell.value !== null && cell.size >= 24 && (_jsx("text", { className: "adm-chart-num", x: cell.x + cell.size / 2, y: cell.y + cell.size / 2 + 3, textAnchor: "middle", fontSize: 10, fontWeight: 600, fill: cell.textLight ? 'var(--accent-fg)' : 'var(--fg)', children: format(cell.value) }))] }, `${cell.row}-${cell.col}`))) })] }), a11yFallback !== undefined && _jsx("div", { className: "adm-chart-sr", children: a11yFallback })] }));
+}
+//# sourceMappingURL=CohortMatrixChart.js.map

package/dist/components/CohortMatrixChart.js.map

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

package/dist/components/CorrelationMatrixChart.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `chart-correlation-matrix` primitive (research/widget-registry.md §2): n×n grid
+ * of Pearson r, accent for positive / danger for negative, fill opacity by |r|,
+ * mono values that flip to the accent foreground past a strong threshold.
+ * Column order mirrors in RTL. Fade-in on mount.
+ */
+import type { ReactNode } from 'react';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface CorrelationMatrixChartProps {
+    /** Square correlation grid: cells[row][col] ∈ [-1, 1] (null = blank). */
+    cells: readonly (readonly (number | null)[])[];
+    columns: readonly string[];
+    labels: ChartLabels;
+    height?: number;
+    showLabels?: boolean;
+    /** |r| above which cell text uses the accent foreground (default 0.55). */
+    strongThreshold?: number;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function CorrelationMatrixChart({ cells, columns, labels, height, showLabels, strongThreshold, dir, a11yFallback, className, }: CorrelationMatrixChartProps): import("react").JSX.Element;
+//# sourceMappingURL=CorrelationMatrixChart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CorrelationMatrixChart.d.ts","sourceRoot":"","sources":["../../src/components/CorrelationMatrixChart.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,2BAA2B;IAC1C,yEAAyE;IACzE,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IAC/C,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,EACL,OAAO,EACP,MAAM,EACN,MAAY,EACZ,UAAiB,EACjB,eAAsB,EACtB,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,2BAA2B,+BAuF7B"}

package/dist/components/CorrelationMatrixChart.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { matrixGridLayout } from '../geometry/correlation.js';
+import { ChartSurface } from './ChartSurface.js';
+function formatR(value) {
+    const fixed = value.toFixed(2);
+    return fixed === '-0.00' ? '0.00' : fixed;
+}
+export function CorrelationMatrixChart({ cells, columns, labels, height = 260, showLabels = true, strongThreshold = 0.55, dir, a11yFallback, className, }) {
+    const rows = cells.length;
+    const cols = columns.length;
+    const pad = { top: showLabels ? 18 : 6, bottom: 6, near: showLabels ? 68 : 6, far: 8 };
+    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 (rows === 0 || cols === 0 || innerWidth <= 0 || innerHeight <= 0)
+                return null;
+            const layout = matrixGridLayout({ rows, cols, width: innerWidth, height: innerHeight, rtl });
+            const showText = layout.cellW >= 26 && layout.cellH >= 18;
+            return (_jsxs("g", { className: "adm-chart-fade", style: { '--adm-fade': mounted ? '1' : '0' }, children: [layout.cells.map((cell) => {
+                        const r = cells[cell.row]?.[cell.col];
+                        if (typeof r !== 'number')
+                            return null;
+                        const magnitude = Math.min(1, Math.abs(r));
+                        const strong = magnitude >= strongThreshold;
+                        return (_jsxs("g", { "data-cell-row": cell.row, "data-cell-col": cell.col, children: [_jsx("rect", { x: cell.x, y: cell.y, width: cell.w, height: cell.h, rx: 3, fill: r >= 0 ? 'var(--accent)' : 'var(--danger)', fillOpacity: 0.12 + magnitude * 0.88, "data-sign": r >= 0 ? 'pos' : 'neg' }), showText && (_jsx("text", { className: "adm-chart-num", x: cell.x + cell.w / 2, y: cell.y + cell.h / 2 + 3, textAnchor: "middle", fontSize: 10, fontWeight: 600, fill: strong ? 'var(--accent-fg)' : 'var(--fg-muted)', children: formatR(r) }))] }, `${cell.row}-${cell.col}`));
+                    }), showLabels &&
+                        columns.map((label, col) => (_jsx("text", { className: "adm-chart-axis-label", x: layout.colX(col) + layout.cellW / 2, y: -6, textAnchor: "middle", children: label }, `col-${label}`))), showLabels &&
+                        columns.map((label, row) => row < rows ? (_jsx("text", { className: "adm-chart-axis-label", x: rtl ? innerWidth + 6 : -6, y: layout.rowY(row) + layout.cellH / 2 + 3, textAnchor: rtl ? 'start' : 'end', children: label }, `row-${label}`)) : null)] }));
+        } }));
+}
+//# sourceMappingURL=CorrelationMatrixChart.js.map

package/dist/components/CorrelationMatrixChart.js.map

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

package/dist/components/DonutChart.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `chart-donut` primitive (research/widget-registry.md §2): SVG arcs via
+ * d3-shape, inner total slot, legend rows (color dot, label, mono value),
+ * maxSlices + "other" bucket. Rotation stays clockwise in RTL; the legend and
+ * center layout mirror via flex + logical properties (10-i18n-theming.md §5.5).
+ */
+import type { ReactNode } from 'react';
+import type { DonutSliceInput } from '../geometry/donut.js';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface DonutChartProps {
+    data: readonly DonutSliceInput[];
+    labels: ChartLabels;
+    /** Slices beyond this collapse into a trailing "other" bucket (default 5). */
+    maxSlices?: number;
+    otherLabel?: string;
+    /** Caption under the center total (e.g. "Total"). */
+    centerLabel?: string;
+    /** Override the auto center value (defaults to the formatted total). */
+    centerValue?: string;
+    /** Ring diameter in px (default 160). */
+    size?: number;
+    thickness?: number;
+    showLegend?: boolean;
+    format?: (value: number) => string;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function DonutChart({ data, labels, maxSlices, otherLabel, centerLabel, centerValue, size, thickness, showLegend, format, dir, a11yFallback, className, }: DonutChartProps): import("react").JSX.Element;
+//# sourceMappingURL=DonutChart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DonutChart.d.ts","sourceRoot":"","sources":["../../src/components/DonutChart.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,MAAM,EACN,SAAa,EACb,UAAoB,EACpB,WAAW,EACX,WAAW,EACX,IAAU,EACV,SAAc,EACd,UAAiB,EACjB,MAAsB,EACtB,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,eAAe,+BAiEjB"}

package/dist/components/DonutChart.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { donutArcs } from '../geometry/donut.js';
+import { useChartDir } from '../hooks/useRtl.js';
+import { useMountAnimation } from '../hooks/useMountAnimation.js';
+import { formatCompact } from '../utils/format.js';
+export function DonutChart({ data, labels, maxSlices = 5, otherLabel = 'Other', centerLabel, centerValue, size = 160, thickness = 20, showLegend = true, format = formatCompact, dir, a11yFallback, className, }) {
+    const resolvedDir = useChartDir(dir);
+    const mounted = useMountAnimation();
+    const arcs = donutArcs(data, {
+        outerRadius: size / 2,
+        thickness,
+        maxSlices,
+        otherLabel,
+    });
+    const total = data.reduce((sum, s) => sum + Math.max(0, s.value), 0);
+    const shownCenterValue = centerValue ?? format(total);
+    return (_jsxs("div", { className: className === undefined ? 'adm-donut' : `adm-donut ${className}`, ...(dir !== undefined ? { dir: resolvedDir } : {}), children: [_jsxs("svg", { role: "img", "aria-label": labels.label, width: size, height: size, viewBox: `0 0 ${size} ${size}`, "data-export-node": "", children: [labels.description !== undefined && _jsx("desc", { children: labels.description }), _jsxs("g", { transform: `translate(${size / 2}, ${size / 2})`, children: [arcs.map((slice, i) => (_jsx("path", { className: "adm-chart-fade", style: { '--adm-fade': mounted ? '1' : '0', '--adm-stagger': `${i * 80}ms` }, d: slice.path, fill: slice.colorVar, "data-slice": slice.label, "data-other": slice.isOther ? '' : undefined }, slice.label))), _jsx("text", { className: "adm-donut-center-value", textAnchor: "middle", dy: centerLabel !== undefined ? '0.1em' : '0.35em', children: shownCenterValue }), centerLabel !== undefined && (_jsx("text", { className: "adm-donut-center-label", textAnchor: "middle", dy: "1.6em", children: centerLabel }))] })] }), showLegend && (_jsx("ul", { className: "adm-donut-legend", children: arcs.map((slice) => (_jsxs("li", { className: "adm-donut-legend-row", children: [_jsx("span", { className: "adm-donut-legend-dot", style: { '--adm-dot': slice.colorVar }, "aria-hidden": "true" }), _jsx("span", { children: slice.label }), _jsx("span", { className: "adm-donut-legend-value", children: format(slice.value) })] }, slice.label))) })), a11yFallback !== undefined && _jsx("div", { className: "adm-chart-sr", children: a11yFallback })] }));
+}
+//# sourceMappingURL=DonutChart.js.map

package/dist/components/DonutChart.js.map

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

package/dist/components/ForecastChart.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `chart-forecast` primitive (research/widget-registry.md §2): history line +
+ * dashed forecast + widening confidence polygon + "now" divider + projected
+ * footer legend. A time axis, so it never mirrors (04 §7.4 LTR island); the
+ * footer legend follows reading direction. Colors from the viz palette only.
+ */
+import type { ReactNode } from 'react';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface ForecastPoint {
+    x: Date;
+    y: number;
+}
+export interface ForecastBandPoint {
+    lo: number;
+    hi: number;
+}
+export interface ForecastChartProps {
+    history: readonly ForecastPoint[];
+    forecast: readonly ForecastPoint[];
+    /** Confidence edges aligned 1:1 to `forecast`. */
+    band: readonly ForecastBandPoint[];
+    labels: ChartLabels;
+    height?: number;
+    showAxis?: boolean;
+    /** Divider caption (default "Now"). */
+    nowLabel?: string;
+    /** Footer legend caption for the projection (default "Forecast"). */
+    forecastLabel?: string;
+    actualLabel?: string;
+    formatY?: (y: number) => string;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function ForecastChart({ history, forecast, band, labels, height, showAxis, nowLabel, forecastLabel, actualLabel, formatY, dir, a11yFallback, className, }: ForecastChartProps): import("react").JSX.Element;
+//# sourceMappingURL=ForecastChart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ForecastChart.d.ts","sourceRoot":"","sources":["../../src/components/ForecastChart.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAInD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,IAAI,CAAC;IACR,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IACnC,kDAAkD;IAClD,IAAI,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,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,aAAa,CAAC,EAC5B,OAAO,EACP,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,MAAY,EACZ,QAAe,EACf,QAAgB,EAChB,aAA0B,EAC1B,WAAsB,EACtB,OAAuB,EACvB,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,kBAAkB,+BA0JpB"}

package/dist/components/ForecastChart.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+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 ForecastChart({ history, forecast, band, labels, height = 260, showAxis = true, nowLabel = 'Now', forecastLabel = 'Forecast', actualLabel = 'Actual', 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 ? 24 : 8, left: showAxis ? 38 : 6, right: 10 }, children: ({ innerWidth, innerHeight, rtl, mounted }) => {
+            if (history.length === 0 || innerWidth <= 0 || innerHeight <= 0)
+                return null;
+            const allDates = [...history, ...forecast].map((p) => p.x.getTime());
+            const [loT, hiT] = extent(allDates) ?? [0, 1];
+            const xScale = timeScale([new Date(loT), new Date(hiT)], innerWidth);
+            const ys = [
+                ...history.map((p) => p.y),
+                ...forecast.map((p) => p.y),
+                ...band.map((b) => b.lo),
+                ...band.map((b) => b.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 now = history.at(-1);
+            const nowX = xScale(now.x);
+            const nowPix = { x: nowX, y: yScale(now.y) };
+            const historyPix = history.map((p) => ({ x: xScale(p.x), y: yScale(p.y) }));
+            const forecastPix = forecast.map((p) => ({ x: xScale(p.x), y: yScale(p.y) }));
+            const upper = [nowPix, ...forecast.map((p, i) => ({ x: xScale(p.x), y: yScale(band[i]?.hi ?? p.y) }))];
+            const lower = [nowPix, ...forecast.map((p, i) => ({ x: xScale(p.x), y: yScale(band[i]?.lo ?? p.y) }))];
+            const historyLine = linePath(historyPix, true);
+            const forecastLine = linePath([nowPix, ...forecastPix], true);
+            const bandPath = confidenceBandPath(upper, lower);
+            const legendStart = rtl ? innerWidth : 0;
+            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.15, stroke: "none", "data-band": "confidence" })), _jsx("line", { x1: nowX, x2: nowX, y1: 0, y2: innerHeight, stroke: "var(--border-strong)", strokeWidth: 1, strokeDasharray: "3 3", "data-now-divider": "" }), _jsx("text", { x: nowX + (rtl ? -4 : 4), y: 10, textAnchor: rtl ? 'end' : 'start', fontSize: 9.5, fontWeight: 600, fill: "var(--fg-subtle)", "data-now-label": "", children: nowLabel }), forecastLine !== null && (_jsx("path", { d: forecastLine, fill: "none", stroke: "var(--viz-1)", strokeWidth: 2, strokeDasharray: "5 4", strokeLinecap: "round", "data-series": "forecast" })), historyLine !== null && (_jsx("path", { d: historyLine, fill: "none", stroke: "var(--viz-1)", strokeWidth: 2, strokeLinecap: "round", "data-series": "history" })), _jsx("circle", { cx: nowPix.x, cy: nowPix.y, r: 3, fill: "var(--viz-1)", stroke: "var(--surface)", strokeWidth: 1.5 }), _jsxs("g", { "data-footer-legend": "", transform: `translate(0, ${innerHeight + (showAxis ? 16 : 4)})`, children: [_jsx("line", { x1: rtl ? legendStart : legendStart, x2: rtl ? legendStart - 16 : legendStart + 16, y1: 0, y2: 0, stroke: "var(--viz-1)", strokeWidth: 2 }), _jsx("text", { x: rtl ? legendStart - 20 : legendStart + 20, y: 3, textAnchor: rtl ? 'end' : 'start', fontSize: 9.5, fontWeight: 600, fill: "var(--fg-muted)", children: actualLabel }), _jsx("line", { x1: rtl ? legendStart - 96 : legendStart + 96, x2: rtl ? legendStart - 112 : legendStart + 112, y1: 0, y2: 0, stroke: "var(--viz-1)", strokeWidth: 2, strokeDasharray: "4 3" }), _jsx("text", { x: rtl ? legendStart - 116 : legendStart + 116, y: 3, textAnchor: rtl ? 'end' : 'start', fontSize: 9.5, fontWeight: 600, fill: "var(--fg-muted)", children: forecastLabel })] })] }));
+        } }));
+}
+//# sourceMappingURL=ForecastChart.js.map

package/dist/components/ForecastChart.js.map

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

package/dist/components/Funnel.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `chart-funnel` primitive (research/widget-registry.md §2): ordered shrinking
+ * stages in two layouts — `horizontal` (start-aligned bars) and `stepped`
+ * (centered bars with "N% continue" step rows) — plus an overall-conversion
+ * footer. Bars mirror in RTL (categorical part-to-whole, §7.4); the fading
+ * accent-alpha ramp keeps in-bar labels readable in both themes. Tokens only.
+ */
+import type { ReactNode } from 'react';
+import type { FunnelStageInput } from '../geometry/funnel.js';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface FunnelChartProps {
+    data: readonly FunnelStageInput[];
+    labels: ChartLabels;
+    variant?: 'horizontal' | 'stepped';
+    /** Show the per-step "N% continue" retention between stages. */
+    showStepConversion?: boolean;
+    /** Show the overall first→last conversion footer. */
+    overallFooter?: boolean;
+    height?: number;
+    format?: (value: number) => string;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function Funnel({ data, labels, variant, showStepConversion, overallFooter, height, format, dir, a11yFallback, className, }: FunnelChartProps): import("react").JSX.Element;
+//# sourceMappingURL=Funnel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Funnel.d.ts","sourceRoot":"","sources":["../../src/components/Funnel.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,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,gBAAgB,EAAE,CAAC;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qDAAqD;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,MAAM,EACN,OAAmB,EACnB,kBAAyB,EACzB,aAAoB,EACpB,MAAY,EACZ,MAAsB,EACtB,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,gBAAgB,+BAoFlB"}

package/dist/components/Funnel.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { funnelLayout } from '../geometry/funnel.js';
+import { formatCompact } from '../utils/format.js';
+import { ChartSurface } from './ChartSurface.js';
+export function Funnel({ data, labels, variant = 'stepped', showStepConversion = true, overallFooter = true, height = 240, format = formatCompact, dir, a11yFallback, className, }) {
+    return (_jsx(ChartSurface, { labels: labels, height: height, ...(dir !== undefined ? { dir } : {}), ...(a11yFallback !== undefined ? { a11yFallback } : {}), ...(className !== undefined ? { className } : {}), padding: { top: 2, right: 2, bottom: overallFooter ? 24 : 2, left: 2 }, children: ({ innerWidth, innerHeight, rtl, mounted }) => {
+            if (innerWidth <= 0 || innerHeight <= 0)
+                return null;
+            const { stages, overallConversion } = funnelLayout(data);
+            if (stages.length === 0)
+                return null;
+            const rowHeight = innerHeight / stages.length;
+            const barHeight = Math.max(6, rowHeight * (showStepConversion ? 0.54 : 0.72));
+            return (_jsxs("g", { "data-funnel": "", children: [stages.map((stage, i) => {
+                        const barWidth = stage.widthFrac * innerWidth;
+                        const startX = variant === 'stepped' ? stage.offsetFrac * innerWidth : 0;
+                        const x = rtl ? innerWidth - startX - barWidth : startX;
+                        const y = i * rowHeight + (rowHeight - barHeight) / 2;
+                        const textX = rtl ? innerWidth - 8 : 8;
+                        const anchor = rtl ? 'end' : 'start';
+                        return (_jsxs("g", { className: "adm-chart-fade", style: { '--adm-fade': mounted ? '1' : '0', '--adm-stagger': `${i * 70}ms` }, "data-stage": stage.label, children: [_jsx("rect", { x: x, y: y, width: Math.max(0, barWidth), height: barHeight, rx: 4, fill: stage.colorVar }), _jsx("text", { className: "adm-chart-axis-label", x: textX, y: y + barHeight / 2 - 3, textAnchor: anchor, dominantBaseline: "middle", children: stage.label }), _jsx("text", { className: "adm-chart-axis-label adm-chart-num", x: textX, y: y + barHeight / 2 + 10, textAnchor: anchor, dominantBaseline: "middle", children: `${format(stage.value)} · ${Math.round(stage.overallPct)}%` }), showStepConversion && i > 0 && (_jsx("text", { className: "adm-chart-axis-label", x: innerWidth / 2, y: i * rowHeight, textAnchor: "middle", dominantBaseline: "middle", "data-step-conversion": "", children: `${Math.round(stage.stepPct)}% continue` }))] }, stage.label));
+                    }), overallFooter && (_jsx("text", { className: "adm-chart-tooltip-value", x: innerWidth / 2, y: innerHeight + 16, textAnchor: "middle", "data-overall-conversion": "", children: `${Math.round(overallConversion)}% overall` }))] }));
+        } }));
+}
+//# sourceMappingURL=Funnel.js.map

package/dist/components/Funnel.js.map

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

package/dist/components/HeatCalendarChart.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `chart-heatmap-calendar` primitive (research/widget-registry.md §2): GitHub-
+ * style week×day contribution grid with intensity levels, month markers, a
+ * weekday gutter, a less→more legend and per-day native tooltips. Intrinsic cell
+ * geometry (the widget wrapper adds horizontal scroll, annex "horizontal
+ * scroll"). Token-only colors, mount fade with reduced-motion fallback,
+ * `data-export-node` raster marker. Week columns run right→left in RTL (04 §7.4).
+ */
+import type { ReactNode } from 'react';
+import type { HeatPoint } from '../geometry/heatCalendar.js';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface HeatCalendarChartProps {
+    points: readonly HeatPoint[];
+    labels: ChartLabels;
+    weeks?: number;
+    /** First weekday of the column, 0=Sun..6=Sat (locale-aware). Default 0. */
+    startWeekday?: number;
+    /** Intensity levels incl. 0 (default 5). */
+    levels?: number;
+    cellSize?: number;
+    /** Weekday short labels indexed 0=Sun..6=Sat. */
+    weekdayLabels?: readonly string[];
+    /** Month short labels indexed 0=Jan..11=Dec. */
+    monthLabels?: readonly string[];
+    legendLabels?: {
+        less: string;
+        more: string;
+    };
+    /** Format the tooltip count (default `${v}`). */
+    format?: (value: number) => string;
+    /** Format the tooltip date (default ISO key). */
+    formatDate?: (date: Date) => string;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function HeatCalendarChart({ points, labels, weeks, startWeekday, levels, cellSize, weekdayLabels, monthLabels, legendLabels, format, formatDate, dir, a11yFallback, className, }: HeatCalendarChartProps): import("react").JSX.Element;
+//# sourceMappingURL=HeatCalendarChart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HeatCalendarChart.d.ts","sourceRoot":"","sources":["../../src/components/HeatCalendarChart.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAG7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,gDAAgD;IAChD,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,iDAAiD;IACjD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,iDAAiD;IACjD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;IACpC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,MAAM,EACN,KAAU,EACV,YAAgB,EAChB,MAAU,EACV,QAAa,EACb,aAAgC,EAChC,WAA4B,EAC5B,YAA6C,EAC7C,MAAe,EACf,UAAU,EACV,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,sBAAsB,+BAmHxB"}

package/dist/components/HeatCalendarChart.js

@@ -0,0 +1,37 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { heatCalendarLayout } from '../geometry/heatCalendar.js';
+import { rampColorVar } from '../geometry/heat.js';
+import { useChartDir } from '../hooks/useRtl.js';
+import { useMountAnimation } from '../hooks/useMountAnimation.js';
+/** Sun..Sat short weekday labels — English defaults, overridable per locale. */
+const DEFAULT_WEEKDAYS = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+const DEFAULT_MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+export function HeatCalendarChart({ points, labels, weeks = 53, startWeekday = 0, levels = 5, cellSize = 12, weekdayLabels = DEFAULT_WEEKDAYS, monthLabels = DEFAULT_MONTHS, legendLabels = { less: 'Less', more: 'More' }, format = String, formatDate, dir, a11yFallback, className, }) {
+    const resolvedDir = useChartDir(dir);
+    const mounted = useMountAnimation();
+    const rtl = resolvedDir === 'rtl';
+    const gap = 3;
+    const layout = heatCalendarLayout(points, { weeks, startWeekday, cellSize, gap, levels, rtl });
+    const monthHeader = 16;
+    const gutter = 30;
+    const legendHeight = 22;
+    const gridX = rtl ? 0 : gutter;
+    const svgWidth = gutter + layout.width;
+    const svgHeight = monthHeader + layout.height + legendHeight;
+    // Month markers at each column where the month changes (data order oldest→newest).
+    const monthMarks = [];
+    let prevMonth = -1;
+    for (let col = 0; col < layout.weeks; col += 1) {
+        const cell = layout.days.find((d) => d.weekIndex === col);
+        if (cell === undefined)
+            continue;
+        const month = cell.date.getUTCMonth();
+        if (month !== prevMonth) {
+            monthMarks.push({ x: cell.x, label: monthLabels[month] ?? '' });
+            prevMonth = month;
+        }
+    }
+    const dateLabel = (date) => (formatDate ? formatDate(date) : date.toISOString().slice(0, 10));
+    return (_jsxs("div", { className: className === undefined ? 'adm-heatcal' : `adm-heatcal ${className}`, ...(dir !== undefined ? { dir: resolvedDir } : {}), children: [_jsxs("svg", { role: "img", "aria-label": labels.label, width: svgWidth, height: svgHeight, viewBox: `0 0 ${Math.max(1, svgWidth)} ${Math.max(1, svgHeight)}`, "data-export-node": "", children: [labels.description !== undefined && _jsx("desc", { children: labels.description }), layout.weekdayRows.map((weekday, row) => row % 2 === 1 ? (_jsx("text", { className: "adm-chart-axis-label", x: rtl ? layout.width + 6 : gutter - 6, y: monthHeader + row * (cellSize + gap) + cellSize, textAnchor: rtl ? 'start' : 'end', children: weekdayLabels[weekday] ?? '' }, `wd${row}`)) : null), _jsxs("g", { transform: `translate(${gridX}, ${monthHeader})`, children: [monthMarks.map((mark, i) => (_jsx("text", { className: "adm-chart-axis-label", x: mark.x, y: -4, textAnchor: "start", children: mark.label }, `m${i}`))), _jsx("g", { className: "adm-chart-fade", style: { '--adm-fade': mounted ? '1' : '0' }, children: layout.days.map((day) => (_jsx("rect", { x: day.x, y: day.y, width: day.size, height: day.size, rx: 2, fill: rampColorVar(day.level, levels), "data-heat-cell": "", "data-level": day.level, children: _jsx("title", { children: `${dateLabel(day.date)}: ${format(day.value)}` }) }, day.key))) })] }), _jsxs("g", { transform: `translate(${gridX}, ${monthHeader + layout.height + 8})`, children: [_jsx("text", { className: "adm-chart-axis-label", x: 0, y: 9, textAnchor: "start", children: legendLabels.less }), Array.from({ length: levels }, (_, level) => (_jsx("rect", { x: 26 + level * (cellSize + 2), y: 0, width: cellSize, height: cellSize, rx: 2, fill: rampColorVar(level, levels) }, `lg${level}`))), _jsx("text", { className: "adm-chart-axis-label", x: 26 + levels * (cellSize + 2) + 4, y: 9, textAnchor: "start", children: legendLabels.more })] })] }), a11yFallback !== undefined && _jsx("div", { className: "adm-chart-sr", children: a11yFallback })] }));
+}
+//# sourceMappingURL=HeatCalendarChart.js.map

package/dist/components/HeatCalendarChart.js.map

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

package/dist/components/HeatMonthChart.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `chart-heat-month` primitive (research/widget-registry.md §2): a 7-column
+ * month grid with day numbers and up to 5 intensity levels + a day-of-week
+ * header. Intrinsic cell geometry (DonutChart precedent). Token-only colors,
+ * mount fade with reduced-motion fallback, `data-export-node` raster marker.
+ * Day-of-week columns mirror in RTL (04 §7.4).
+ */
+import type { ReactNode } from 'react';
+import type { HeatMonthPoint } from '../geometry/heatMonth.js';
+import type { ChartDir } from '../hooks/useRtl.js';
+import type { ChartLabels } from './ChartSurface.js';
+export interface HeatMonthChartProps {
+    year: number;
+    /** 0-based month. */
+    month: number;
+    points: readonly HeatMonthPoint[];
+    labels: ChartLabels;
+    /** First weekday of the row, 0=Sun..6=Sat (locale-aware). Default 0. */
+    startWeekday?: number;
+    levels?: number;
+    cellSize?: number;
+    /** Weekday short labels indexed 0=Sun..6=Sat. */
+    weekdayLabels?: readonly string[];
+    format?: (value: number) => string;
+    dir?: ChartDir;
+    a11yFallback?: ReactNode;
+    className?: string;
+}
+export declare function HeatMonthChart({ year, month, points, labels, startWeekday, levels, cellSize, weekdayLabels, format, dir, a11yFallback, className, }: HeatMonthChartProps): import("react").JSX.Element;
+//# sourceMappingURL=HeatMonthChart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HeatMonthChart.d.ts","sourceRoot":"","sources":["../../src/components/HeatMonthChart.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,KAAK,EACL,MAAM,EACN,MAAM,EACN,YAAgB,EAChB,MAAU,EACV,QAAa,EACb,aAAgC,EAChC,MAAe,EACf,GAAG,EACH,YAAY,EACZ,SAAS,GACV,EAAE,mBAAmB,+BAwErB"}