@chipmobilesdk/rn-chart 0.4.0 → 0.5.0

package/lib/module/geometry/markers.js

@@ -0,0 +1,53 @@
+"use strict";
+
+/**
+ * Reference markers on a value axis: thresholds, baselines and targets drawn
+ * as horizontal lines across the plot (FR-008, FR-072).
+ *
+ * Every builder used to return `markers: []`, so a threshold the app supplied
+ * reached the accessibility summary and nowhere else (CHT-03).
+ *
+ * PURE. No React, no SVG.
+ */
+
+import { isKnown } from "../contract/value.js";
+import { plotRight } from "./layout.js";
+/** Markers that can be placed on a value axis: those with a known value. */
+export function placeableMarkers(markers) {
+  return (markers ?? []).filter(m => isKnown(m.value));
+}
+
+/** Values the domain must include so every marker lands inside the plot. */
+export function markerDomainValues(markers) {
+  return placeableMarkers(markers).map(m => m.value.value);
+}
+
+/** One line per marker across the plot, plus its label when it has one. */
+export function horizontalMarkers(markers, plot, project) {
+  const lines = [];
+  const labels = [];
+  for (const marker of placeableMarkers(markers)) {
+    const y = project(marker.value.value);
+    lines.push({
+      id: `marker-${marker.id}`,
+      d: `M${plot.x},${y}H${plotRight(plot)}`,
+      label: marker.label,
+      kind: marker.kind
+    });
+    if (marker.label) {
+      labels.push({
+        key: `marker-label-${marker.id}`,
+        text: marker.label,
+        x: plotRight(plot),
+        // Above the line, unless that would leave the plot.
+        y: y - 4 >= plot.y + 8 ? y - 4 : y + 12,
+        anchor: 'end'
+      });
+    }
+  }
+  return {
+    lines,
+    labels
+  };
+}
+//# sourceMappingURL=markers.js.map

package/lib/module/geometry/markers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isKnown","plotRight","placeableMarkers","markers","filter","m","value","markerDomainValues","map","horizontalMarkers","plot","project","lines","labels","marker","y","push","id","d","x","label","kind","key","text","anchor"],"sourceRoot":"../../../src","sources":["geometry/markers.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,OAAO,QAAQ,sBAAmB;AAC3C,SAASC,SAAS,QAAuB,aAAU;AAKnD;AACA,OAAO,SAASC,gBAAgBA,CAACC,OAA+C,EAAkB;EACjG,OAAO,CAACA,OAAO,IAAI,EAAE,EAAEC,MAAM,CAAEC,CAAC,IAAwBL,OAAO,CAACK,CAAC,CAACC,KAAK,CAAC,CAAC;AAC1E;;AAEA;AACA,OAAO,SAASC,kBAAkBA,CAACJ,OAA+C,EAAY;EAC7F,OAAOD,gBAAgB,CAACC,OAAO,CAAC,CAACK,GAAG,CAACH,CAAC,IAAIA,CAAC,CAACC,KAAK,CAACA,KAAK,CAAC;AACzD;;AAEA;AACA,OAAO,SAASG,iBAAiBA,CAChCN,OAA+C,EAC/CO,IAAc,EACdC,OAAkC,EACiB;EACnD,MAAMC,KAAmB,GAAG,EAAE;EAC9B,MAAMC,MAAuB,GAAG,EAAE;EAClC,KAAK,MAAMC,MAAM,IAAIZ,gBAAgB,CAACC,OAAO,CAAC,EAAE;IAC/C,MAAMY,CAAC,GAAGJ,OAAO,CAACG,MAAM,CAACR,KAAK,CAACA,KAAK,CAAC;IACrCM,KAAK,CAACI,IAAI,CAAC;MACVC,EAAE,EAAE,UAAUH,MAAM,CAACG,EAAE,EAAE;MACzBC,CAAC,EAAE,IAAIR,IAAI,CAACS,CAAC,IAAIJ,CAAC,IAAId,SAAS,CAACS,IAAI,CAAC,EAAE;MACvCU,KAAK,EAAEN,MAAM,CAACM,KAAK;MACnBC,IAAI,EAAEP,MAAM,CAACO;IACd,CAAC,CAAC;IACF,IAAIP,MAAM,CAACM,KAAK,EAAE;MACjBP,MAAM,CAACG,IAAI,CAAC;QACXM,GAAG,EAAE,gBAAgBR,MAAM,CAACG,EAAE,EAAE;QAChCM,IAAI,EAAET,MAAM,CAACM,KAAK;QAClBD,CAAC,EAAElB,SAAS,CAACS,IAAI,CAAC;QAClB;QACAK,CAAC,EAAEA,CAAC,GAAG,CAAC,IAAIL,IAAI,CAACK,CAAC,GAAG,CAAC,GAAGA,CAAC,GAAG,CAAC,GAAGA,CAAC,GAAG,EAAE;QACvCS,MAAM,EAAE;MACT,CAAC,CAAC;IACH;EACD;EACA,OAAO;IAAEZ,KAAK;IAAEC;EAAO,CAAC;AACzB","ignoreList":[]}

package/lib/module/geometry/path.js

@@ -0,0 +1,157 @@
+"use strict";
+
+/**
+ * SVG path-string builders.
+ *
+ * This is where the "never bridge a gap" guarantee (FR-012) becomes
+ * structural rather than a rule someone has to remember. A missing value does
+ * not produce a coordinate — it ends the current subpath. The next known value
+ * starts a fresh one with an `M` command. There is physically no line segment
+ * spanning the gap, so no amount of downstream carelessness can draw one.
+ *
+ * Batching into path data is also what keeps element counts flat: one `Path`
+ * per series regardless of point count (research.md R2).
+ *
+ * PURE. No React, no SVG imports — this module emits strings.
+ */
+
+/** A point that may be absent, mirroring the value contract. */
+
+function n(value) {
+  // Two decimals is well below sub-pixel visibility and keeps `d` strings
+  // short, which matters when they cross the bridge on every data change.
+  return Number.isFinite(value) ? value.toFixed(2) : '0';
+}
+
+/**
+ * Polyline through the known points, broken at every gap.
+ *
+ * `null` entries are missing values. They terminate the current subpath; they
+ * are never interpolated, carried forward, or skipped over.
+ */
+export function linePath(points) {
+  let d = '';
+  let penDown = false;
+  for (const p of points) {
+    if (p === null) {
+      // Lift the pen. The gap stays a gap.
+      penDown = false;
+      continue;
+    }
+    if (!penDown) {
+      d += `M${n(p.x)} ${n(p.y)}`;
+      penDown = true;
+    } else {
+      d += `L${n(p.x)} ${n(p.y)}`;
+    }
+  }
+  return d;
+}
+
+/**
+ * Filled area between the polyline and a baseline, broken at gaps in the same
+ * way: each contiguous run of known points becomes its own closed shape.
+ */
+export function areaPath(points, baselineY) {
+  let d = '';
+  let run = [];
+  const flush = () => {
+    if (run.length === 0) {
+      return;
+    }
+    d += `M${n(run[0].x)} ${n(baselineY)}`;
+    for (const p of run) {
+      d += `L${n(p.x)} ${n(p.y)}`;
+    }
+    d += `L${n(run[run.length - 1].x)} ${n(baselineY)}Z`;
+    run = [];
+  };
+  for (const p of points) {
+    if (p === null) {
+      flush();
+    } else {
+      run.push(p);
+    }
+  }
+  flush();
+  return d;
+}
+/** One rectangle as a subpath, with optional corner rounding. */
+export function rectSubpath(r) {
+  const radius = Math.min(r.radius ?? 0, r.width / 2, Math.abs(r.height) / 2);
+  if (radius <= 0) {
+    return `M${n(r.x)} ${n(r.y)}` + `h${n(r.width)}v${n(r.height)}h${n(-r.width)}Z`;
+  }
+  const {
+    x,
+    y,
+    width: w,
+    height: h
+  } = r;
+  return `M${n(x + radius)} ${n(y)}` + `h${n(w - radius * 2)}` + `a${n(radius)} ${n(radius)} 0 0 1 ${n(radius)} ${n(radius)}` + `v${n(h - radius * 2)}` + `a${n(radius)} ${n(radius)} 0 0 1 ${n(-radius)} ${n(radius)}` + `h${n(-(w - radius * 2))}` + `a${n(radius)} ${n(radius)} 0 0 1 ${n(-radius)} ${n(-radius)}` + `v${n(-(h - radius * 2))}` + `a${n(radius)} ${n(radius)} 0 0 1 ${n(radius)} ${n(-radius)}Z`;
+}
+
+/**
+ * Many rectangles batched into one path — how bars and heatmap cells stay at
+ * one element per series or per intensity bucket.
+ */
+export function rectBatchPath(rects) {
+  let d = '';
+  for (const r of rects) {
+    d += rectSubpath(r);
+  }
+  return d;
+}
+function polar(cx, cy, r, angle) {
+  // Offset by -90 degrees so 0 radians is 12 o'clock, which is where users
+  // expect a donut to start.
+  const a = angle - Math.PI / 2;
+  return {
+    x: cx + r * Math.cos(a),
+    y: cy + r * Math.sin(a)
+  };
+}
+
+/**
+ * Donut or pie segment. An inner radius of 0 yields a pie wedge.
+ *
+ * A full-circle segment is drawn as two half-arcs, because SVG cannot express
+ * a 360-degree arc in a single command — start and end would coincide and
+ * nothing would be drawn.
+ */
+export function arcPath(spec) {
+  const {
+    cx,
+    cy,
+    outerRadius: ro,
+    innerRadius: ri
+  } = spec;
+  const sweep = spec.endAngle - spec.startAngle;
+  const full = Math.abs(sweep) >= Math.PI * 2 - 1e-9;
+  if (full) {
+    const mid = spec.startAngle + Math.PI;
+    return arcPath({
+      ...spec,
+      endAngle: mid
+    }) + arcPath({
+      ...spec,
+      startAngle: mid,
+      endAngle: spec.startAngle + Math.PI * 2
+    });
+  }
+  const largeArc = Math.abs(sweep) > Math.PI ? 1 : 0;
+  const o0 = polar(cx, cy, ro, spec.startAngle);
+  const o1 = polar(cx, cy, ro, spec.endAngle);
+  if (ri <= 0) {
+    return `M${n(cx)} ${n(cy)}` + `L${n(o0.x)} ${n(o0.y)}` + `A${n(ro)} ${n(ro)} 0 ${largeArc} 1 ${n(o1.x)} ${n(o1.y)}Z`;
+  }
+  const i1 = polar(cx, cy, ri, spec.endAngle);
+  const i0 = polar(cx, cy, ri, spec.startAngle);
+  return `M${n(o0.x)} ${n(o0.y)}` + `A${n(ro)} ${n(ro)} 0 ${largeArc} 1 ${n(o1.x)} ${n(o1.y)}` + `L${n(i1.x)} ${n(i1.y)}` + `A${n(ri)} ${n(ri)} 0 ${largeArc} 0 ${n(i0.x)} ${n(i0.y)}Z`;
+}
+
+/** Straight line, for axes, baselines, and threshold markers. */
+export function linearSegment(from, to) {
+  return `M${n(from.x)} ${n(from.y)}L${n(to.x)} ${n(to.y)}`;
+}
+//# sourceMappingURL=path.js.map

package/lib/module/geometry/path.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["n","value","Number","isFinite","toFixed","linePath","points","d","penDown","p","x","y","areaPath","baselineY","run","flush","length","push","rectSubpath","r","radius","Math","min","width","abs","height","w","h","rectBatchPath","rects","polar","cx","cy","angle","a","PI","cos","sin","arcPath","spec","outerRadius","ro","innerRadius","ri","sweep","endAngle","startAngle","full","mid","largeArc","o0","o1","i1","i0","linearSegment","from","to"],"sourceRoot":"../../../src","sources":["geometry/path.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/geometry/progress.js

@@ -0,0 +1,199 @@
+"use strict";
+
+/**
+ * Progress geometry: current value against an optional target.
+ *
+ * The rule that matters (FR-021, FR-022): with no usable target there is **no
+ * proportion**. The chart shows the current value and nothing else. And a value
+ * beyond its target renders as overshoot rather than a clamped full bar that
+ * hides the excess.
+ *
+ * PURE. No React, no SVG.
+ */
+
+import { findTarget, readProgress } from "../contract/marker.js";
+import { isKnown, isWithheld } from "../contract/value.js";
+import { plotBottom, plotRight } from "./layout.js";
+import { rectSubpath } from "./path.js";
+/** How far past the target an overshoot bar is allowed to extend visually. */
+const OVERSHOOT_DISPLAY_CAP = 1.25;
+export function buildProgressGeometry(datasource, input, options = {}) {
+  const {
+    plot
+  } = input;
+  const metrics = datasource.series.flatMap(series => series.points.map(point => ({
+    series,
+    point
+  })));
+  if (metrics.length === 0 || plot.width <= 0) {
+    return {
+      plot,
+      paths: [],
+      markers: [],
+      labels: [],
+      xTicks: [],
+      yTicks: [],
+      hitRegions: [],
+      incomplete: false
+    };
+  }
+  const readings = metrics.map(({
+    point
+  }) => readProgress(point.value, findTarget(datasource.markers, point.id) ?? findTarget(datasource.markers)));
+
+  // The track spans 0..displayMax of the target, shared by every row so their
+  // targets line up. With an overshoot the target sits inside the plot and the
+  // excess is drawn to its right — previously the target was the plot's right
+  // edge, so overshoot started there and was clipped by the SVG (CHT-03).
+  const displayMax = readings.reduce((max, r) => r.proportion === undefined ? max : Math.max(max, Math.min(r.proportion, OVERSHOOT_DISPLAY_CAP)), 1);
+  const unit = plot.width / displayMax;
+  const targetX = plot.x + unit;
+  const rowHeight = plot.height / metrics.length;
+  const barHeight = Math.min(rowHeight * 0.45, 24);
+  const radius = options.trackRadius ?? barHeight / 2;
+  const paths = [];
+  const labels = [];
+  const hitRegions = [];
+  const markers = [];
+  let incomplete = false;
+  metrics.forEach(({
+    series,
+    point
+  }, index) => {
+    const rowY = plot.y + index * rowHeight + (rowHeight - barHeight) / 2;
+    const reading = readings[index];
+
+    // Track: the full width, always drawn, so an empty metric still reads as
+    // a metric rather than as blank space.
+    paths.push({
+      key: `track-${series.id}-${point.id}`,
+      seriesId: series.id,
+      d: rectSubpath({
+        x: plot.x,
+        y: rowY,
+        width: plot.width,
+        height: barHeight,
+        radius
+      }),
+      color: input.seriesColors[series.id],
+      pattern: 'solid',
+      filled: true,
+      opacity: 0.15
+    });
+    if (!isKnown(point.value)) {
+      incomplete = true;
+      // No fill at all, and a texture rather than a zero-length bar — a gap
+      // must not look like "none of the target achieved".
+      paths.push({
+        key: `nonvalue-${series.id}-${point.id}`,
+        seriesId: series.id,
+        d: rectSubpath({
+          x: plot.x,
+          y: rowY,
+          width: plot.width,
+          height: barHeight,
+          radius
+        }),
+        color: input.seriesColors[series.id],
+        pattern: 'solid',
+        filled: true,
+        texture: input.nonValueTextures[point.value.kind],
+        opacity: 0.5
+      });
+    } else {
+      const proportion = reading.proportion;
+      // With no usable target there is no proportion to draw, so the fill
+      // shows the value's presence rather than a fabricated percentage.
+      const fillFraction = proportion === undefined ? 1 : Math.min(proportion, OVERSHOOT_DISPLAY_CAP);
+      paths.push({
+        key: `fill-${series.id}-${point.id}`,
+        seriesId: series.id,
+        d: rectSubpath({
+          x: plot.x,
+          y: rowY,
+          width: Math.max(0, unit * Math.min(fillFraction, 1)),
+          height: barHeight,
+          radius
+        }),
+        color: input.seriesColors[series.id],
+        pattern: 'solid',
+        filled: true
+      });
+
+      // Overshoot is drawn beyond the target line rather than clamped away,
+      // so exceeding a goal is visible instead of indistinguishable from
+      // exactly meeting it.
+      if (reading.overshoot && proportion !== undefined) {
+        const overshootWidth = unit * (Math.min(proportion, OVERSHOOT_DISPLAY_CAP) - 1);
+        paths.push({
+          key: `overshoot-${series.id}-${point.id}`,
+          seriesId: series.id,
+          d: rectSubpath({
+            x: targetX,
+            y: rowY + barHeight * 0.2,
+            width: Math.max(0, overshootWidth),
+            height: barHeight * 0.6,
+            radius: radius / 2
+          }),
+          color: input.seriesColors[series.id],
+          pattern: 'dashed',
+          filled: true,
+          opacity: 0.7
+        });
+      }
+    }
+
+    // The target itself, across this row's bar (FR-022, FR-072).
+    if (reading.proportion !== undefined && reading.target) {
+      markers.push({
+        id: `target-${series.id}-${point.id}`,
+        d: `M${targetX},${Math.max(plot.y, rowY - 3)}V${Math.min(plotBottom(plot), rowY + barHeight + 3)}`,
+        label: reading.target.label,
+        kind: 'target'
+      });
+    }
+    const valueText = isKnown(point.value) ? input.formatValue(point.value.value) : '';
+    // Only append a percentage when one is real.
+    const proportionText = reading.proportion === undefined ? '' : ` (${Math.round(reading.proportion * 100)}%)`;
+    labels.push({
+      key: `label-${series.id}-${point.id}`,
+      text: input.formatCategory(point.position.kind === 'category' ? point.position.category : series.label),
+      x: plot.x,
+      y: rowY - 4,
+      anchor: 'start'
+    });
+    if (valueText) {
+      labels.push({
+        key: `value-${series.id}-${point.id}`,
+        text: `${valueText}${proportionText}`,
+        x: plotRight(plot),
+        y: rowY - 4,
+        anchor: 'end'
+      });
+    }
+    hitRegions.push({
+      seriesId: series.id,
+      pointId: point.id,
+      x: plot.x + plot.width / 2,
+      y: rowY + barHeight / 2,
+      bounds: {
+        x: plot.x,
+        y: rowY,
+        width: plot.width,
+        height: barHeight
+      },
+      selectable: !isWithheld(point.value)
+    });
+  });
+  return {
+    plot,
+    paths,
+    markers,
+    labels,
+    xTicks: [],
+    yTicks: [],
+    hitRegions,
+    incomplete
+  };
+}
+//# sourceMappingURL=progress.js.map

package/lib/module/geometry/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["findTarget","readProgress","isKnown","isWithheld","plotBottom","plotRight","rectSubpath","OVERSHOOT_DISPLAY_CAP","buildProgressGeometry","datasource","input","options","plot","metrics","series","flatMap","points","map","point","length","width","paths","markers","labels","xTicks","yTicks","hitRegions","incomplete","readings","value","id","displayMax","reduce","max","r","proportion","undefined","Math","min","unit","targetX","x","rowHeight","height","barHeight","radius","trackRadius","forEach","index","rowY","y","reading","push","key","seriesId","d","color","seriesColors","pattern","filled","opacity","texture","nonValueTextures","kind","fillFraction","overshoot","overshootWidth","target","label","valueText","formatValue","proportionText","round","text","formatCategory","position","category","anchor","pointId","bounds","selectable"],"sourceRoot":"../../../src","sources":["geometry/progress.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,UAAU,EAAEC,YAAY,QAAQ,uBAAoB;AAC7D,SAASC,OAAO,EAAEC,UAAU,QAAQ,sBAAmB;AAEvD,SAASC,UAAU,EAAEC,SAAS,QAAQ,aAAU;AAChD,SAASC,WAAW,QAAQ,WAAQ;AAOpC;AACA,MAAMC,qBAAqB,GAAG,IAAI;AAElC,OAAO,SAASC,qBAAqBA,CACpCC,UAA8B,EAC9BC,KAAoB,EACpBC,OAAwB,GAAG,CAAC,CAAC,EACV;EACnB,MAAM;IAAEC;EAAK,CAAC,GAAGF,KAAK;EACtB,MAAMG,OAAO,GAAGJ,UAAU,CAACK,MAAM,CAACC,OAAO,CAACD,MAAM,IAC/CA,MAAM,CAACE,MAAM,CAACC,GAAG,CAACC,KAAK,KAAK;IAAEJ,MAAM;IAAEI;EAAM,CAAC,CAAC,CAC/C,CAAC;EAED,IAAIL,OAAO,CAACM,MAAM,KAAK,CAAC,IAAIP,IAAI,CAACQ,KAAK,IAAI,CAAC,EAAE;IAC5C,OAAO;MACNR,IAAI;MACJS,KAAK,EAAE,EAAE;MACTC,OAAO,EAAE,EAAE;MACXC,MAAM,EAAE,EAAE;MACVC,MAAM,EAAE,EAAE;MACVC,MAAM,EAAE,EAAE;MACVC,UAAU,EAAE,EAAE;MACdC,UAAU,EAAE;IACb,CAAC;EACF;EAEA,MAAMC,QAAQ,GAAGf,OAAO,CAACI,GAAG,CAAC,CAAC;IAAEC;EAAM,CAAC,KACtCjB,YAAY,CACXiB,KAAK,CAACW,KAAK,EACX7B,UAAU,CAACS,UAAU,CAACa,OAAO,EAAEJ,KAAK,CAACY,EAAE,CAAC,IAAI9B,UAAU,CAACS,UAAU,CAACa,OAAO,CAC1E,CACD,CAAC;;EAED;EACA;EACA;EACA;EACA,MAAMS,UAAU,GAAGH,QAAQ,CAACI,MAAM,CACjC,CAACC,GAAG,EAAEC,CAAC,KACNA,CAAC,CAACC,UAAU,KAAKC,SAAS,GACvBH,GAAG,GACHI,IAAI,CAACJ,GAAG,CAACA,GAAG,EAAEI,IAAI,CAACC,GAAG,CAACJ,CAAC,CAACC,UAAU,EAAE5B,qBAAqB,CAAC,CAAC,EAChE,CACD,CAAC;EACD,MAAMgC,IAAI,GAAG3B,IAAI,CAACQ,KAAK,GAAGW,UAAU;EACpC,MAAMS,OAAO,GAAG5B,IAAI,CAAC6B,CAAC,GAAGF,IAAI;EAE7B,MAAMG,SAAS,GAAG9B,IAAI,CAAC+B,MAAM,GAAG9B,OAAO,CAACM,MAAM;EAC9C,MAAMyB,SAAS,GAAGP,IAAI,CAACC,GAAG,CAACI,SAAS,GAAG,IAAI,EAAE,EAAE,CAAC;EAChD,MAAMG,MAAM,GAAGlC,OAAO,CAACmC,WAAW,IAAIF,SAAS,GAAG,CAAC;EAEnD,MAAMvB,KAAiB,GAAG,EAAE;EAC5B,MAAME,MAAuB,GAAG,EAAE;EAClC,MAAMG,UAAuB,GAAG,EAAE;EAClC,MAAMJ,OAAqB,GAAG,EAAE;EAChC,IAAIK,UAAU,GAAG,KAAK;EAEtBd,OAAO,CAACkC,OAAO,CAAC,CAAC;IAAEjC,MAAM;IAAEI;EAAM,CAAC,EAAE8B,KAAK,KAAK;IAC7C,MAAMC,IAAI,GAAGrC,IAAI,CAACsC,CAAC,GAAGF,KAAK,GAAGN,SAAS,GAAG,CAACA,SAAS,GAAGE,SAAS,IAAI,CAAC;IACrE,MAAMO,OAAO,GAAGvB,QAAQ,CAACoB,KAAK,CAAC;;IAE/B;IACA;IACA3B,KAAK,CAAC+B,IAAI,CAAC;MACVC,GAAG,EAAE,SAASvC,MAAM,CAACgB,EAAE,IAAIZ,KAAK,CAACY,EAAE,EAAE;MACrCwB,QAAQ,EAAExC,MAAM,CAACgB,EAAE;MACnByB,CAAC,EAAEjD,WAAW,CAAC;QACdmC,CAAC,EAAE7B,IAAI,CAAC6B,CAAC;QACTS,CAAC,EAAED,IAAI;QACP7B,KAAK,EAAER,IAAI,CAACQ,KAAK;QACjBuB,MAAM,EAAEC,SAAS;QACjBC;MACD,CAAC,CAAC;MACFW,KAAK,EAAE9C,KAAK,CAAC+C,YAAY,CAAC3C,MAAM,CAACgB,EAAE,CAAC;MACpC4B,OAAO,EAAE,OAAO;MAChBC,MAAM,EAAE,IAAI;MACZC,OAAO,EAAE;IACV,CAAC,CAAC;IAEF,IAAI,CAAC1D,OAAO,CAACgB,KAAK,CAACW,KAAK,CAAC,EAAE;MAC1BF,UAAU,GAAG,IAAI;MACjB;MACA;MACAN,KAAK,CAAC+B,IAAI,CAAC;QACVC,GAAG,EAAE,YAAYvC,MAAM,CAACgB,EAAE,IAAIZ,KAAK,CAACY,EAAE,EAAE;QACxCwB,QAAQ,EAAExC,MAAM,CAACgB,EAAE;QACnByB,CAAC,EAAEjD,WAAW,CAAC;UACdmC,CAAC,EAAE7B,IAAI,CAAC6B,CAAC;UACTS,CAAC,EAAED,IAAI;UACP7B,KAAK,EAAER,IAAI,CAACQ,KAAK;UACjBuB,MAAM,EAAEC,SAAS;UACjBC;QACD,CAAC,CAAC;QACFW,KAAK,EAAE9C,KAAK,CAAC+C,YAAY,CAAC3C,MAAM,CAACgB,EAAE,CAAC;QACpC4B,OAAO,EAAE,OAAO;QAChBC,MAAM,EAAE,IAAI;QACZE,OAAO,EAAEnD,KAAK,CAACoD,gBAAgB,CAAC5C,KAAK,CAACW,KAAK,CAACkC,IAAI,CAAC;QACjDH,OAAO,EAAE;MACV,CAAC,CAAC;IACH,CAAC,MAAM;MACN,MAAMzB,UAAU,GAAGgB,OAAO,CAAChB,UAAU;MACrC;MACA;MACA,MAAM6B,YAAY,GACjB7B,UAAU,KAAKC,SAAS,GAAG,CAAC,GAAGC,IAAI,CAACC,GAAG,CAACH,UAAU,EAAE5B,qBAAqB,CAAC;MAE3Ec,KAAK,CAAC+B,IAAI,CAAC;QACVC,GAAG,EAAE,QAAQvC,MAAM,CAACgB,EAAE,IAAIZ,KAAK,CAACY,EAAE,EAAE;QACpCwB,QAAQ,EAAExC,MAAM,CAACgB,EAAE;QACnByB,CAAC,EAAEjD,WAAW,CAAC;UACdmC,CAAC,EAAE7B,IAAI,CAAC6B,CAAC;UACTS,CAAC,EAAED,IAAI;UACP7B,KAAK,EAAEiB,IAAI,CAACJ,GAAG,CAAC,CAAC,EAAEM,IAAI,GAAGF,IAAI,CAACC,GAAG,CAAC0B,YAAY,EAAE,CAAC,CAAC,CAAC;UACpDrB,MAAM,EAAEC,SAAS;UACjBC;QACD,CAAC,CAAC;QACFW,KAAK,EAAE9C,KAAK,CAAC+C,YAAY,CAAC3C,MAAM,CAACgB,EAAE,CAAC;QACpC4B,OAAO,EAAE,OAAO;QAChBC,MAAM,EAAE;MACT,CAAC,CAAC;;MAEF;MACA;MACA;MACA,IAAIR,OAAO,CAACc,SAAS,IAAI9B,UAAU,KAAKC,SAAS,EAAE;QAClD,MAAM8B,cAAc,GAAG3B,IAAI,IAAIF,IAAI,CAACC,GAAG,CAACH,UAAU,EAAE5B,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAC/Ec,KAAK,CAAC+B,IAAI,CAAC;UACVC,GAAG,EAAE,aAAavC,MAAM,CAACgB,EAAE,IAAIZ,KAAK,CAACY,EAAE,EAAE;UACzCwB,QAAQ,EAAExC,MAAM,CAACgB,EAAE;UACnByB,CAAC,EAAEjD,WAAW,CAAC;YACdmC,CAAC,EAAED,OAAO;YACVU,CAAC,EAAED,IAAI,GAAGL,SAAS,GAAG,GAAG;YACzBxB,KAAK,EAAEiB,IAAI,CAACJ,GAAG,CAAC,CAAC,EAAEiC,cAAc,CAAC;YAClCvB,MAAM,EAAEC,SAAS,GAAG,GAAG;YACvBC,MAAM,EAAEA,MAAM,GAAG;UAClB,CAAC,CAAC;UACFW,KAAK,EAAE9C,KAAK,CAAC+C,YAAY,CAAC3C,MAAM,CAACgB,EAAE,CAAC;UACpC4B,OAAO,EAAE,QAAQ;UACjBC,MAAM,EAAE,IAAI;UACZC,OAAO,EAAE;QACV,CAAC,CAAC;MACH;IACD;;IAEA;IACA,IAAIT,OAAO,CAAChB,UAAU,KAAKC,SAAS,IAAIe,OAAO,CAACgB,MAAM,EAAE;MACvD7C,OAAO,CAAC8B,IAAI,CAAC;QACZtB,EAAE,EAAE,UAAUhB,MAAM,CAACgB,EAAE,IAAIZ,KAAK,CAACY,EAAE,EAAE;QACrCyB,CAAC,EAAE,IAAIf,OAAO,IAAIH,IAAI,CAACJ,GAAG,CAACrB,IAAI,CAACsC,CAAC,EAAED,IAAI,GAAG,CAAC,CAAC,IAAIZ,IAAI,CAACC,GAAG,CAAClC,UAAU,CAACQ,IAAI,CAAC,EAAEqC,IAAI,GAAGL,SAAS,GAAG,CAAC,CAAC,EAAE;QAClGwB,KAAK,EAAEjB,OAAO,CAACgB,MAAM,CAACC,KAAK;QAC3BL,IAAI,EAAE;MACP,CAAC,CAAC;IACH;IAEA,MAAMM,SAAS,GAAGnE,OAAO,CAACgB,KAAK,CAACW,KAAK,CAAC,GAAGnB,KAAK,CAAC4D,WAAW,CAACpD,KAAK,CAACW,KAAK,CAACA,KAAK,CAAC,GAAG,EAAE;IAClF;IACA,MAAM0C,cAAc,GACnBpB,OAAO,CAAChB,UAAU,KAAKC,SAAS,GAAG,EAAE,GAAG,KAAKC,IAAI,CAACmC,KAAK,CAACrB,OAAO,CAAChB,UAAU,GAAG,GAAG,CAAC,IAAI;IAEtFZ,MAAM,CAAC6B,IAAI,CAAC;MACXC,GAAG,EAAE,SAASvC,MAAM,CAACgB,EAAE,IAAIZ,KAAK,CAACY,EAAE,EAAE;MACrC2C,IAAI,EAAE/D,KAAK,CAACgE,cAAc,CACzBxD,KAAK,CAACyD,QAAQ,CAACZ,IAAI,KAAK,UAAU,GAAG7C,KAAK,CAACyD,QAAQ,CAACC,QAAQ,GAAG9D,MAAM,CAACsD,KACvE,CAAC;MACD3B,CAAC,EAAE7B,IAAI,CAAC6B,CAAC;MACTS,CAAC,EAAED,IAAI,GAAG,CAAC;MACX4B,MAAM,EAAE;IACT,CAAC,CAAC;IAEF,IAAIR,SAAS,EAAE;MACd9C,MAAM,CAAC6B,IAAI,CAAC;QACXC,GAAG,EAAE,SAASvC,MAAM,CAACgB,EAAE,IAAIZ,KAAK,CAACY,EAAE,EAAE;QACrC2C,IAAI,EAAE,GAAGJ,SAAS,GAAGE,cAAc,EAAE;QACrC9B,CAAC,EAAEpC,SAAS,CAACO,IAAI,CAAC;QAClBsC,CAAC,EAAED,IAAI,GAAG,CAAC;QACX4B,MAAM,EAAE;MACT,CAAC,CAAC;IACH;IAEAnD,UAAU,CAAC0B,IAAI,CAAC;MACfE,QAAQ,EAAExC,MAAM,CAACgB,EAAE;MACnBgD,OAAO,EAAE5D,KAAK,CAACY,EAAE;MACjBW,CAAC,EAAE7B,IAAI,CAAC6B,CAAC,GAAG7B,IAAI,CAACQ,KAAK,GAAG,CAAC;MAC1B8B,CAAC,EAAED,IAAI,GAAGL,SAAS,GAAG,CAAC;MACvBmC,MAAM,EAAE;QAAEtC,CAAC,EAAE7B,IAAI,CAAC6B,CAAC;QAAES,CAAC,EAAED,IAAI;QAAE7B,KAAK,EAAER,IAAI,CAACQ,KAAK;QAAEuB,MAAM,EAAEC;MAAU,CAAC;MACpEoC,UAAU,EAAE,CAAC7E,UAAU,CAACe,KAAK,CAACW,KAAK;IACpC,CAAC,CAAC;EACH,CAAC,CAAC;EAEF,OAAO;IACNjB,IAAI;IACJS,KAAK;IACLC,OAAO;IACPC,MAAM;IACNC,MAAM,EAAE,EAAE;IACVC,MAAM,EAAE,EAAE;IACVC,UAAU;IACVC;EACD,CAAC;AACF","ignoreList":[]}

package/lib/module/geometry/scale.js

@@ -0,0 +1,119 @@
+"use strict";
+
+/**
+ * Scales: domain values to pixel positions.
+ *
+ * PURE. No React, no SVG — enforced by the ESLint override in `.eslintrc.js`
+ * and by geometryPurity.test.ts.
+ */
+
+/**
+ * Nudges a zero-width domain outward so an all-identical dataset still gets a
+ * usable axis. Without this the projection divides by zero and every point
+ * lands on the same pixel — or on NaN.
+ */
+export function widenDegenerateDomain(domain) {
+  if (domain.max > domain.min) {
+    return domain;
+  }
+  const value = domain.min;
+  // Scale the padding to the magnitude so large values do not get a
+  // meaninglessly tiny window, and zero still gets a sensible one.
+  const pad = value === 0 ? 1 : Math.abs(value) * 0.5;
+  return {
+    min: value - pad,
+    max: value + pad
+  };
+}
+export function linearScale(domain, rangePx) {
+  const safeDomain = widenDegenerateDomain(domain);
+  const domainSpan = safeDomain.max - safeDomain.min;
+  const pxSpan = rangePx.max - rangePx.min;
+  return {
+    domain: safeDomain,
+    rangePx,
+    project: value => rangePx.min + (value - safeDomain.min) / domainSpan * pxSpan,
+    invert: px => safeDomain.min + (px - rangePx.min) / pxSpan * domainSpan
+  };
+}
+/**
+ * Discrete positions for category axes.
+ *
+ * `padding` is the fraction of each step left as gap, so 0.2 means bars occupy
+ * 80% of their slot.
+ */
+export function bandScale(categories, rangePx, padding = 0.2) {
+  const count = Math.max(categories.length, 1);
+  const pxSpan = rangePx.max - rangePx.min;
+  const step = pxSpan / count;
+  const bandWidth = step * (1 - padding);
+  const offset = (step - bandWidth) / 2;
+  const indexOf = new Map();
+  categories.forEach((c, i) => {
+    if (!indexOf.has(c)) {
+      indexOf.set(c, i);
+    }
+  });
+  const project = category => {
+    const i = indexOf.get(category);
+    return i === undefined ? undefined : rangePx.min + i * step + offset;
+  };
+  return {
+    categories,
+    bandWidth,
+    step,
+    project,
+    centerOf: category => {
+      const start = project(category);
+      return start === undefined ? undefined : start + bandWidth / 2;
+    },
+    invert: px => {
+      const i = Math.floor((px - rangePx.min) / step);
+      return i >= 0 && i < categories.length ? categories[i] : undefined;
+    }
+  };
+}
+
+/**
+ * Time is just a linear scale over epoch milliseconds. Kept as a named
+ * function so call sites read clearly and so tick generation can branch on it.
+ */
+export function timeScale(domain, rangePx) {
+  return linearScale(domain, rangePx);
+}
+
+/**
+ * Domain from known values, padded so marks do not touch the plot edges.
+ *
+ * `includeZero` matters for bar charts: a bar's length is only meaningful when
+ * measured from zero. Time-series charts leave it off so a narrow band of
+ * values stays legible.
+ */
+export function domainFrom(values, options = {}) {
+  if (values.length === 0) {
+    return {
+      min: 0,
+      max: 1
+    };
+  }
+  let min = values[0];
+  let max = values[0];
+  for (const v of values) {
+    if (v < min) {
+      min = v;
+    }
+    if (v > max) {
+      max = v;
+    }
+  }
+  if (options.includeZero) {
+    min = Math.min(min, 0);
+    max = Math.max(max, 0);
+  }
+  const pad = (max - min) * (options.padFraction ?? 0);
+  return {
+    min: min - pad,
+    max: max + pad
+  };
+}
+//# sourceMappingURL=scale.js.map

package/lib/module/geometry/scale.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["widenDegenerateDomain","domain","max","min","value","pad","Math","abs","linearScale","rangePx","safeDomain","domainSpan","pxSpan","project","invert","px","bandScale","categories","padding","count","length","step","bandWidth","offset","indexOf","Map","forEach","c","i","has","set","category","get","undefined","centerOf","start","floor","timeScale","domainFrom","values","options","v","includeZero","padFraction"],"sourceRoot":"../../../src","sources":["geometry/scale.ts"],"mappings":"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","ignoreList":[]}