@adminiumjs/charts 0.1.0-rc.1

package/dist/geometry/donut.js

@@ -0,0 +1,46 @@
+/** Pure donut geometry — d3-shape pie/arc, maxSlices + "other" bucketing. */
+import { arc, pie } from 'd3-shape';
+/** Aggregate slices beyond `maxSlices` into a trailing "other" bucket. */
+export function bucketSlices(slices, maxSlices, otherLabel = 'Other') {
+    if (maxSlices <= 0 || slices.length <= maxSlices) {
+        return { slices: [...slices], otherIndex: -1 };
+    }
+    const kept = slices.slice(0, maxSlices);
+    const rest = slices.slice(maxSlices).reduce((sum, s) => sum + s.value, 0);
+    return { slices: [...kept, { label: otherLabel, value: rest }], otherIndex: maxSlices };
+}
+/**
+ * Donut arcs in input order (no value sort — legend order matches data).
+ * Rotation is always clockwise from 12 o'clock; per the RTL rules
+ * (10-i18n-theming.md §5.5) rotation direction does NOT change in RTL — only
+ * the surrounding legend/center layout mirrors, which is plain flex/logical CSS.
+ */
+export function donutArcs(slices, options) {
+    const { outerRadius, thickness, padAngle = 0.02, cornerRadius = 2, maxSlices = Infinity, otherLabel } = options;
+    const bucketed = Number.isFinite(maxSlices)
+        ? bucketSlices(slices, maxSlices, otherLabel)
+        : { slices: [...slices], otherIndex: -1 };
+    const total = bucketed.slices.reduce((sum, s) => sum + Math.max(0, s.value), 0);
+    if (total <= 0)
+        return [];
+    const pieLayout = pie()
+        .value((d) => Math.max(0, d.value))
+        .sort(null)
+        .padAngle(padAngle);
+    const arcGenerator = arc()
+        .innerRadius(Math.max(0, outerRadius - thickness))
+        .outerRadius(outerRadius)
+        .cornerRadius(cornerRadius);
+    return pieLayout(bucketed.slices).map((piece, i) => {
+        const isOther = i === bucketed.otherIndex;
+        return {
+            label: piece.data.label,
+            value: piece.data.value,
+            share: Math.max(0, piece.data.value) / total,
+            path: arcGenerator(piece) ?? '',
+            colorVar: isOther ? 'var(--fg-subtle)' : `var(--viz-${(i % 8) + 1})`,
+            isOther,
+        };
+    });
+}
+//# sourceMappingURL=donut.js.map

package/dist/geometry/donut.js.map

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

package/dist/geometry/forecast.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Forecast geometry (`chart-forecast`, research/widget-registry.md §2): a pure
+ * linear-projection model plus a closed confidence-polygon path builder. Both
+ * are DOM-free and deterministic (04 §7.1). z-multipliers cover the common
+ * confidence levels; anything else falls back to the 90% multiplier.
+ */
+import type { XYPoint } from './lineArea.js';
+export declare function zForConfidence(confidence: number): number;
+export interface ForecastModel {
+    /** Projected point values, one per horizon step. */
+    forecast: number[];
+    /** Lower confidence edge per horizon step. */
+    lo: number[];
+    /** Upper confidence edge per horizon step. */
+    hi: number[];
+}
+/**
+ * Ordinary-least-squares trend over the history indices, projected `horizon`
+ * steps forward. The band widens with the square root of the step distance
+ * (classic prediction-interval growth), scaled by the in-sample residual
+ * standard deviation and the confidence z-multiplier.
+ */
+export declare function linearForecast(history: readonly number[], horizon: number, confidence?: number): ForecastModel;
+/**
+ * Closed polygon path for a confidence band: forward along the upper pixel
+ * edge, back along the lower. `upper` and `lower` are parallel same-length
+ * pixel-point arrays (lower typically the reverse-domain of upper's x).
+ */
+export declare function confidenceBandPath(upper: readonly XYPoint[], lower: readonly XYPoint[]): string | null;
+//# sourceMappingURL=forecast.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forecast.d.ts","sourceRoot":"","sources":["../../src/geometry/forecast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAU7C,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8CAA8C;IAC9C,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,8CAA8C;IAC9C,EAAE,EAAE,MAAM,EAAE,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,MAAM,EACf,UAAU,SAAM,GACf,aAAa,CAoCf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,GAAG,IAAI,CAYtG"}

package/dist/geometry/forecast.js

@@ -0,0 +1,75 @@
+/** Two-sided normal z-multipliers for the confidence levels the UI exposes. */
+const Z_BY_CONFIDENCE = {
+    '0.8': 1.281_552,
+    '0.9': 1.644_854,
+    '0.95': 1.959_964,
+    '0.99': 2.575_829,
+};
+export function zForConfidence(confidence) {
+    return Z_BY_CONFIDENCE[String(confidence)] ?? Z_BY_CONFIDENCE['0.9'];
+}
+/**
+ * Ordinary-least-squares trend over the history indices, projected `horizon`
+ * steps forward. The band widens with the square root of the step distance
+ * (classic prediction-interval growth), scaled by the in-sample residual
+ * standard deviation and the confidence z-multiplier.
+ */
+export function linearForecast(history, horizon, confidence = 0.9) {
+    const n = history.length;
+    if (n === 0 || horizon <= 0)
+        return { forecast: [], lo: [], hi: [] };
+    const meanX = (n - 1) / 2;
+    const meanY = history.reduce((sum, v) => sum + v, 0) / n;
+    let sxx = 0;
+    let sxy = 0;
+    for (let i = 0; i < n; i += 1) {
+        const dx = i - meanX;
+        sxx += dx * dx;
+        sxy += dx * ((history[i] ?? 0) - meanY);
+    }
+    const slope = sxx === 0 ? 0 : sxy / sxx;
+    const intercept = meanY - slope * meanX;
+    let sse = 0;
+    for (let i = 0; i < n; i += 1) {
+        const fitted = intercept + slope * i;
+        const residual = (history[i] ?? 0) - fitted;
+        sse += residual * residual;
+    }
+    const residualStd = Math.sqrt(sse / Math.max(1, n - 2));
+    const z = zForConfidence(confidence);
+    const forecast = [];
+    const lo = [];
+    const hi = [];
+    for (let step = 1; step <= horizon; step += 1) {
+        const value = intercept + slope * (n - 1 + step);
+        const spread = z * residualStd * Math.sqrt(step);
+        forecast.push(value);
+        lo.push(value - spread);
+        hi.push(value + spread);
+    }
+    return { forecast, lo, hi };
+}
+/**
+ * Closed polygon path for a confidence band: forward along the upper pixel
+ * edge, back along the lower. `upper` and `lower` are parallel same-length
+ * pixel-point arrays (lower typically the reverse-domain of upper's x).
+ */
+export function confidenceBandPath(upper, lower) {
+    if (upper.length === 0 || lower.length !== upper.length)
+        return null;
+    const parts = [];
+    upper.forEach((p, i) => {
+        parts.push(`${i === 0 ? 'M' : 'L'}${fmt(p.x)},${fmt(p.y)}`);
+    });
+    for (let i = lower.length - 1; i >= 0; i -= 1) {
+        const p = lower[i];
+        parts.push(`L${fmt(p.x)},${fmt(p.y)}`);
+    }
+    parts.push('Z');
+    return parts.join('');
+}
+/** Trim float noise so Node and browser emit byte-identical path strings. */
+function fmt(value) {
+    return Number(value.toFixed(3)).toString();
+}
+//# sourceMappingURL=forecast.js.map

package/dist/geometry/forecast.js.map

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

package/dist/geometry/funnel.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Pure funnel geometry (`chart-funnel`, research/widget-registry.md §2):
+ * ordered shrinking stages with two layouts —
+ *   - `horizontal`: left-aligned bars, width = value / firstValue;
+ *   - `stepped`: centered bars with "N% continue" step-conversion rows.
+ * Percentages are of the first stage (overall) and of the previous stage
+ * (per-step). DOM-free + deterministic (04 §7.1).
+ */
+export interface FunnelStageInput {
+    label: string;
+    value: number;
+}
+export interface FunnelStage {
+    label: string;
+    value: number;
+    /** Width fraction relative to the FIRST stage (0..1). */
+    widthFrac: number;
+    /** Percent of the first stage, 0..100. */
+    overallPct: number;
+    /** Percent retained vs the PREVIOUS stage, 0..100 (first stage = 100). */
+    stepPct: number;
+    /** Inline-start offset fraction for centered (stepped) layout (0..0.5). */
+    offsetFrac: number;
+    colorVar: string;
+}
+export interface FunnelLayout {
+    stages: FunnelStage[];
+    /** Overall conversion first→last, 0..100. */
+    overallConversion: number;
+}
+/**
+ * Funnel stages in input order. Non-finite values clamp to 0; the first
+ * positive value is the 100% reference. Returns [] when there is no positive
+ * head stage.
+ */
+export declare function funnelLayout(input: readonly FunnelStageInput[]): FunnelLayout;
+//# sourceMappingURL=funnel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"funnel.d.ts","sourceRoot":"","sources":["../../src/geometry/funnel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,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,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,6CAA6C;IAC7C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AASD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,YAAY,CAqB7E"}

package/dist/geometry/funnel.js

@@ -0,0 +1,42 @@
+/**
+ * Pure funnel geometry (`chart-funnel`, research/widget-registry.md §2):
+ * ordered shrinking stages with two layouts —
+ *   - `horizontal`: left-aligned bars, width = value / firstValue;
+ *   - `stepped`: centered bars with "N% continue" step-conversion rows.
+ * Percentages are of the first stage (overall) and of the previous stage
+ * (per-step). DOM-free + deterministic (04 §7.1).
+ */
+function vizAlphaVar(index, count) {
+    // Fade the accent alpha ramp down the funnel (annex "fading accent alpha").
+    if (count <= 1)
+        return 'var(--viz-ramp-6)';
+    const step = 6 - Math.round((index / (count - 1)) * 4); // 6 → 2 across stages
+    return `var(--viz-ramp-${Math.min(6, Math.max(2, step))})`;
+}
+/**
+ * Funnel stages in input order. Non-finite values clamp to 0; the first
+ * positive value is the 100% reference. Returns [] when there is no positive
+ * head stage.
+ */
+export function funnelLayout(input) {
+    const stages = input.map((s) => ({ label: s.label, value: Number.isFinite(s.value) ? Math.max(0, s.value) : 0 }));
+    const head = stages[0]?.value ?? 0;
+    if (stages.length === 0 || head <= 0)
+        return { stages: [], overallConversion: 0 };
+    const out = stages.map((stage, i) => {
+        const prev = stages[i - 1]?.value ?? head;
+        const widthFrac = stage.value / head;
+        return {
+            label: stage.label,
+            value: stage.value,
+            widthFrac,
+            overallPct: widthFrac * 100,
+            stepPct: prev > 0 ? (stage.value / prev) * 100 : 0,
+            offsetFrac: (1 - widthFrac) / 2,
+            colorVar: vizAlphaVar(i, stages.length),
+        };
+    });
+    const tail = stages.at(-1)?.value ?? 0;
+    return { stages: out, overallConversion: (tail / head) * 100 };
+}
+//# sourceMappingURL=funnel.js.map

package/dist/geometry/funnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"funnel.js","sourceRoot":"","sources":["../../src/geometry/funnel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2BH,SAAS,WAAW,CAAC,KAAa,EAAE,KAAa;IAC/C,4EAA4E;IAC5E,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,mBAAmB,CAAC;IAC3C,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB;IAC9E,OAAO,kBAAkB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAkC;IAC7D,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;IAElF,MAAM,GAAG,GAAkB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACjD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;QAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;QACrC,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS;YACT,UAAU,EAAE,SAAS,GAAG,GAAG;YAC3B,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YAClD,UAAU,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC;YAC/B,QAAQ,EAAE,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;SACxC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;AACjE,CAAC"}

package/dist/geometry/heat.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared heat-intensity helpers for the matrix/calendar/geo charts (Track E).
+ * Pure and DOM-free (workplan/04-widget-registry.md §7.1) so scheduled-report
+ * workers reuse them. Sequential intensity maps onto the accent alpha ramp
+ * `--viz-ramp-1..6` (research/design-system.md §1.3 / tokens viz.css); zero maps
+ * to the neutral `--surface-2` empty cell. No hex literals — colors are var()
+ * expressions only (acceptance #8).
+ */
+/** Number of steps in the accent alpha ramp exposed by @adminium/tokens. */
+export declare const RAMP_STEPS = 6;
+/**
+ * Ramp index (1..RAMP_STEPS) for a heat `level` within a scale of `levels`
+ * total levels (level 0 excluded — it is the empty cell). Level `levels-1`
+ * always lands on the darkest ramp step.
+ */
+export declare function rampIndex(level: number, levels: number): number;
+/**
+ * CSS color for a heat `level`: level 0 → neutral empty cell (`--surface-2`);
+ * levels 1..levels-1 → `--viz-ramp-N` accent-alpha steps.
+ */
+export declare function rampColorVar(level: number, levels: number): string;
+/**
+ * Discrete heat level 0..levels-1 for a `value` over `[0, maxValue]`. Zero (or
+ * non-positive) values are level 0 (empty); positive values span 1..levels-1
+ * linearly, with `maxValue` landing on the top level. `levels` must be ≥ 2.
+ */
+export declare function heatLevel(value: number, maxValue: number, levels: number): number;
+/**
+ * Whether tile label text should flip to the on-accent color (`--accent-fg`):
+ * true once the ramp step is dark enough (≥ 65% alpha, ramp index ≥ 4) to lose
+ * contrast against the default foreground.
+ */
+export declare function heatTextLight(level: number, levels: number): boolean;
+//# sourceMappingURL=heat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heat.d.ts","sourceRoot":"","sources":["../../src/geometry/heat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKjF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpE"}

package/dist/geometry/heat.js

@@ -0,0 +1,50 @@
+/**
+ * Shared heat-intensity helpers for the matrix/calendar/geo charts (Track E).
+ * Pure and DOM-free (workplan/04-widget-registry.md §7.1) so scheduled-report
+ * workers reuse them. Sequential intensity maps onto the accent alpha ramp
+ * `--viz-ramp-1..6` (research/design-system.md §1.3 / tokens viz.css); zero maps
+ * to the neutral `--surface-2` empty cell. No hex literals — colors are var()
+ * expressions only (acceptance #8).
+ */
+/** Number of steps in the accent alpha ramp exposed by @adminium/tokens. */
+export const RAMP_STEPS = 6;
+/**
+ * Ramp index (1..RAMP_STEPS) for a heat `level` within a scale of `levels`
+ * total levels (level 0 excluded — it is the empty cell). Level `levels-1`
+ * always lands on the darkest ramp step.
+ */
+export function rampIndex(level, levels) {
+    if (level <= 0)
+        return 0;
+    const span = Math.max(1, levels - 1);
+    return Math.min(RAMP_STEPS, Math.max(1, Math.round((level / span) * RAMP_STEPS)));
+}
+/**
+ * CSS color for a heat `level`: level 0 → neutral empty cell (`--surface-2`);
+ * levels 1..levels-1 → `--viz-ramp-N` accent-alpha steps.
+ */
+export function rampColorVar(level, levels) {
+    const index = rampIndex(level, levels);
+    return index === 0 ? 'var(--surface-2)' : `var(--viz-ramp-${index})`;
+}
+/**
+ * Discrete heat level 0..levels-1 for a `value` over `[0, maxValue]`. Zero (or
+ * non-positive) values are level 0 (empty); positive values span 1..levels-1
+ * linearly, with `maxValue` landing on the top level. `levels` must be ≥ 2.
+ */
+export function heatLevel(value, maxValue, levels) {
+    if (value <= 0 || maxValue <= 0 || levels < 2)
+        return 0;
+    const frac = Math.min(1, value / maxValue);
+    const bucket = Math.min(levels - 2, Math.floor(frac * (levels - 1)));
+    return 1 + bucket;
+}
+/**
+ * Whether tile label text should flip to the on-accent color (`--accent-fg`):
+ * true once the ramp step is dark enough (≥ 65% alpha, ramp index ≥ 4) to lose
+ * contrast against the default foreground.
+ */
+export function heatTextLight(level, levels) {
+    return rampIndex(level, levels) >= 4;
+}
+//# sourceMappingURL=heat.js.map

package/dist/geometry/heat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heat.js","sourceRoot":"","sources":["../../src/geometry/heat.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAE5B;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,MAAc;IACrD,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,MAAc;IACxD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,KAAK,GAAG,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,QAAgB,EAAE,MAAc;IACvE,IAAI,KAAK,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,MAAM,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,MAAc;IACzD,OAAO,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/geometry/heatCalendar.d.ts

@@ -0,0 +1,43 @@
+export interface HeatDay {
+    weekIndex: number;
+    dayIndex: number;
+    x: number;
+    y: number;
+    size: number;
+    /** UTC midnight of the day. */
+    date: Date;
+    /** ISO date key (YYYY-MM-DD). */
+    key: string;
+    value: number;
+    level: number;
+}
+export interface HeatCalendarLayout {
+    days: HeatDay[];
+    weeks: number;
+    /** Day-of-week row order actually used (0=Sun..6=Sat), rotated by startWeekday. */
+    weekdayRows: number[];
+    maxValue: number;
+    width: number;
+    height: number;
+}
+export interface HeatCalendarOptions {
+    /** Number of week columns (default 53). */
+    weeks?: number;
+    /** First weekday of the column, 0=Sun..6=Sat (locale-aware). Default 0. */
+    startWeekday?: number;
+    cellSize?: number;
+    gap?: number;
+    /** Intensity levels incl. 0 (default 5). */
+    levels?: number;
+    rtl?: boolean;
+}
+export interface HeatPoint {
+    t: string | number | Date;
+    v: number;
+}
+/**
+ * Lay out daily counts into a week×day grid ending at the latest point's week.
+ * Days after the latest point (future cells in the final week) are omitted.
+ */
+export declare function heatCalendarLayout(points: readonly HeatPoint[], options?: HeatCalendarOptions): HeatCalendarLayout;
+//# sourceMappingURL=heatCalendar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heatCalendar.d.ts","sourceRoot":"","sources":["../../src/geometry/heatCalendar.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,EAAE,IAAI,CAAC;IACX,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAcD,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1B,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CAuDpB"}

package/dist/geometry/heatCalendar.js

@@ -0,0 +1,82 @@
+/**
+ * Pure GitHub-style contribution-calendar geometry (research/widget-registry.md
+ * §2 `chart-heatmap-calendar`): up to 53 week columns × 7 day rows of per-day
+ * counts, discrete intensity levels, a less→more legend. DOM-free and
+ * deterministic (workplan/04 §7.1) — UTC-only date math, no `Date.now()`.
+ *
+ * RTL policy (04 §7.4, explicit): the week columns run right→left under `rtl`
+ * (newest week on the inline-start edge); the day rows never move.
+ */
+import { heatLevel } from './heat.js';
+const DAY_MS = 86_400_000;
+/** UTC midnight for an ISO/date input; invalid → null. */
+function utcMidnight(input) {
+    const d = input instanceof Date ? input : new Date(input);
+    const ms = d.getTime();
+    if (Number.isNaN(ms))
+        return null;
+    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
+}
+function isoKey(date) {
+    return date.toISOString().slice(0, 10);
+}
+/**
+ * Lay out daily counts into a week×day grid ending at the latest point's week.
+ * Days after the latest point (future cells in the final week) are omitted.
+ */
+export function heatCalendarLayout(points, options = {}) {
+    const { weeks = 53, startWeekday = 0, cellSize = 12, gap = 3, levels = 5, rtl = false } = options;
+    const step = cellSize + gap;
+    const counts = new Map();
+    let end = null;
+    let maxValue = 0;
+    for (const point of points) {
+        const date = utcMidnight(point.t);
+        if (date === null)
+            continue;
+        const key = isoKey(date);
+        const v = Number.isFinite(point.v) ? point.v : 0;
+        counts.set(key, v);
+        if (v > maxValue)
+            maxValue = v;
+        if (end === null || date.getTime() > end.getTime())
+            end = date;
+    }
+    const endDate = end ?? new Date(Date.UTC(1970, 0, 1));
+    // Row index of a date within a column that starts on `startWeekday`.
+    const rowOf = (date) => (date.getUTCDay() - startWeekday + 7) % 7;
+    const endRow = rowOf(endDate);
+    const days = [];
+    for (let col = 0; col < weeks; col += 1) {
+        for (let row = 0; row < 7; row += 1) {
+            // Days back from the end date: whole weeks + within-week row delta.
+            const daysFromEnd = (weeks - 1 - col) * 7 + (endRow - row);
+            if (daysFromEnd < 0)
+                continue; // future cell in the final week
+            const date = new Date(endDate.getTime() - daysFromEnd * DAY_MS);
+            const key = isoKey(date);
+            const value = counts.get(key) ?? 0;
+            days.push({
+                weekIndex: col,
+                dayIndex: row,
+                x: (rtl ? weeks - 1 - col : col) * step,
+                y: row * step,
+                size: cellSize,
+                date,
+                key,
+                value,
+                level: heatLevel(value, maxValue, levels),
+            });
+        }
+    }
+    const weekdayRows = Array.from({ length: 7 }, (_, i) => (startWeekday + i) % 7);
+    return {
+        days,
+        weeks,
+        weekdayRows,
+        maxValue,
+        width: weeks > 0 ? weeks * step - gap : 0,
+        height: 7 * step - gap,
+    };
+}
+//# sourceMappingURL=heatCalendar.js.map

package/dist/geometry/heatCalendar.js.map

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

package/dist/geometry/heatMonth.d.ts

@@ -0,0 +1,47 @@
+export interface HeatMonthCell {
+    row: number;
+    col: number;
+    x: number;
+    y: number;
+    size: number;
+    /** Day of month (1..31) or null for padding cells outside the month. */
+    day: number | null;
+    /** ISO date key for in-month cells. */
+    key: string | null;
+    value: number;
+    level: number;
+}
+export interface HeatMonthLayout {
+    cells: HeatMonthCell[];
+    /** Header column order (0=Sun..6=Sat) rotated by startWeekday, in draw order. */
+    headerCols: {
+        col: number;
+        weekday: number;
+        x: number;
+    }[];
+    rows: number;
+    maxValue: number;
+    headerHeight: number;
+    width: number;
+    height: number;
+}
+export interface HeatMonthOptions {
+    /** First weekday of the row, 0=Sun..6=Sat (locale-aware). Default 0. */
+    startWeekday?: number;
+    cellSize?: number;
+    gap?: number;
+    headerHeight?: number;
+    /** Intensity levels incl. 0 (default 5). */
+    levels?: number;
+    rtl?: boolean;
+}
+export interface HeatMonthPoint {
+    t: string | number | Date;
+    v: number;
+}
+/**
+ * Lay out one calendar month (0-based `month`) of daily counts. Padding cells
+ * before the 1st and after the last day carry `day: null`.
+ */
+export declare function heatMonthLayout(year: number, month: number, points: readonly HeatMonthPoint[], options?: HeatMonthOptions): HeatMonthLayout;
+//# sourceMappingURL=heatMonth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heatMonth.d.ts","sourceRoot":"","sources":["../../src/geometry/heatMonth.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,uCAAuC;IACvC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,iFAAiF;IACjF,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1B,CAAC,EAAE,MAAM,CAAC;CACX;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAgEjB"}

package/dist/geometry/heatMonth.js

@@ -0,0 +1,72 @@
+/**
+ * Pure single-month heat-grid geometry (research/widget-registry.md §2
+ * `chart-heat-month`): a 7-column month calendar with day numbers and up to 5
+ * intensity levels + a day-of-week header. DOM-free and deterministic
+ * (workplan/04 §7.1) — UTC-only date math.
+ *
+ * RTL policy (04 §7.4): the day-of-week columns are a horizontal categorical
+ * scale and mirror under `rtl`; the week rows never move.
+ */
+import { heatLevel } from './heat.js';
+function pad2(n) {
+    return n < 10 ? `0${n}` : String(n);
+}
+/**
+ * Lay out one calendar month (0-based `month`) of daily counts. Padding cells
+ * before the 1st and after the last day carry `day: null`.
+ */
+export function heatMonthLayout(year, month, points, options = {}) {
+    const { startWeekday = 0, cellSize = 40, gap = 4, headerHeight = 20, levels = 5, rtl = false, } = options;
+    const step = cellSize + gap;
+    const counts = new Map();
+    let maxValue = 0;
+    for (const point of points) {
+        const d = point.t instanceof Date ? point.t : new Date(point.t);
+        if (Number.isNaN(d.getTime()))
+            continue;
+        const key = `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}`;
+        const v = Number.isFinite(point.v) ? point.v : 0;
+        counts.set(key, v);
+        if (v > maxValue)
+            maxValue = v;
+    }
+    const firstDow = (new Date(Date.UTC(year, month, 1)).getUTCDay() - startWeekday + 7) % 7;
+    const daysInMonth = new Date(Date.UTC(year, month + 1, 0)).getUTCDate();
+    const rows = Math.ceil((firstDow + daysInMonth) / 7);
+    const colX = (col) => (rtl ? 6 - col : col) * step;
+    const cells = [];
+    for (let row = 0; row < rows; row += 1) {
+        for (let col = 0; col < 7; col += 1) {
+            const day = row * 7 + col - firstDow + 1;
+            const inMonth = day >= 1 && day <= daysInMonth;
+            const key = inMonth ? `${year}-${pad2(month + 1)}-${pad2(day)}` : null;
+            const value = key !== null ? (counts.get(key) ?? 0) : 0;
+            cells.push({
+                row,
+                col,
+                x: colX(col),
+                y: headerHeight + row * step,
+                size: cellSize,
+                day: inMonth ? day : null,
+                key,
+                value,
+                level: inMonth ? heatLevel(value, maxValue, levels) : 0,
+            });
+        }
+    }
+    const headerCols = Array.from({ length: 7 }, (_, col) => ({
+        col,
+        weekday: (startWeekday + col) % 7,
+        x: colX(col) + cellSize / 2,
+    }));
+    return {
+        cells,
+        headerCols,
+        rows,
+        maxValue,
+        headerHeight,
+        width: 7 * step - gap,
+        height: headerHeight + rows * step - gap,
+    };
+}
+//# sourceMappingURL=heatMonth.js.map

package/dist/geometry/heatMonth.js.map

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

package/dist/geometry/lineArea.d.ts

@@ -0,0 +1,17 @@
+export interface XYPoint {
+    /** Pixel-space x. */
+    x: number;
+    /** Pixel-space y. */
+    y: number;
+}
+/** SVG path for a polyline through pixel-space points. Null when < 1 point. */
+export declare function linePath(points: readonly XYPoint[], smooth?: boolean): string | null;
+/** SVG path for the area under the line, closed at `baselineY`. */
+export declare function areaPath(points: readonly XYPoint[], baselineY: number, smooth?: boolean): string | null;
+/**
+ * Index of the point whose pixel x is nearest to `targetX`. Works for both
+ * ascending (LTR) and descending (RTL categorical) x sequences — linear scan,
+ * chart series are small. Returns -1 for empty input.
+ */
+export declare function nearestIndexByX(xs: readonly number[], targetX: number): number;
+//# sourceMappingURL=lineArea.d.ts.map