@chipmobilesdk/rn-chart 0.4.0 → 0.5.0

package/lib/module/geometry/distribution.js

@@ -0,0 +1,193 @@
+"use strict";
+
+/**
+ * Distribution geometry: proportions between groups.
+ *
+ * Segments that do not sum to the whole are **not** rescaled to force a full
+ * circle (FR-024). The arc stops short and the geometry reports `incomplete`,
+ * so the chart can say the data is partial rather than quietly implying it is
+ * complete.
+ *
+ * PURE. No React, no SVG.
+ */
+
+import { resolveDistributionValues } from "../contract/distribution.js";
+import { segmentKey } from "../contract/theme.js";
+import { isKnown, isWithheld, sumKnown } from "../contract/value.js";
+import { arcPath, rectSubpath } from "./path.js";
+const TAU = Math.PI * 2;
+export function buildDistributionGeometry(datasource, input, options = {}) {
+  const {
+    plot
+  } = input;
+  const shape = options.shape ?? 'donut';
+  const segments = datasource.series.flatMap(series => series.points.map(point => ({
+    series,
+    point
+  })));
+  if (segments.length === 0 || plot.width <= 0 || plot.height <= 0) {
+    return {
+      plot,
+      paths: [],
+      markers: [],
+      labels: [],
+      xTicks: [],
+      yTicks: [],
+      hitRegions: [],
+      incomplete: false
+    };
+  }
+  const total = sumKnown(segments.map(s => s.point.value));
+  // Nothing known: there is no distribution to draw, and drawing a full grey
+  // circle would imply a shape the data does not support.
+  if (total.countedPoints === 0 || total.total <= 0) {
+    return {
+      plot,
+      paths: [],
+      markers: [],
+      labels: [],
+      xTicks: [],
+      yTicks: [],
+      hitRegions: [],
+      incomplete: true
+    };
+  }
+
+  // Proportions supplied directly (each in 0..1, summing to ~1) are honoured
+  // as given; absolute values are normalised by their own total. Either way we
+  // never stretch a short sum to fill the circle.
+  const suppliedAsProportions = resolveDistributionValues(datasource, options.valuesAre) === 'proportions';
+  // Shares declared as proportions that add up past the whole are normalised
+  // rather than drawn over one another.
+  const denominator = suppliedAsProportions ? Math.max(1, total.total) : total.total;
+  const coverage = total.total / denominator;
+  const incomplete = total.incomplete || coverage < 0.999;
+  const paths = [];
+  const labels = [];
+  const hitRegions = [];
+  const colorOf = (seriesId, pointId) => input.segmentColors?.[segmentKey(seriesId, pointId)] ?? input.seriesColors[seriesId];
+  if (shape === 'segmentedBar') {
+    const barHeight = Math.min(plot.height, 28);
+    const barY = plot.y + (plot.height - barHeight) / 2;
+    let cursor = plot.x;
+    for (const {
+      series,
+      point
+    } of segments) {
+      if (!isKnown(point.value) || point.value.value < 0) {
+        continue;
+      }
+      const fraction = point.value.value / denominator;
+      const width = plot.width * fraction;
+      paths.push({
+        key: `seg-${series.id}-${point.id}`,
+        seriesId: series.id,
+        d: rectSubpath({
+          x: cursor,
+          y: barY,
+          width,
+          height: barHeight
+        }),
+        color: colorOf(series.id, point.id),
+        pattern: 'solid',
+        filled: true
+      });
+      hitRegions.push({
+        seriesId: series.id,
+        pointId: point.id,
+        x: cursor + width / 2,
+        y: barY + barHeight / 2,
+        bounds: {
+          x: cursor,
+          y: barY,
+          width,
+          height: barHeight
+        },
+        selectable: !isWithheld(point.value)
+      });
+      cursor += width;
+    }
+    return {
+      plot,
+      paths,
+      markers: [],
+      labels,
+      xTicks: [],
+      yTicks: [],
+      hitRegions,
+      incomplete
+    };
+  }
+  const cx = plot.x + plot.width / 2;
+  const cy = plot.y + plot.height / 2;
+  const outerRadius = Math.min(plot.width, plot.height) / 2;
+  const innerRadius = shape === 'pie' ? 0 : outerRadius * (options.innerRadiusRatio ?? 0.6);
+  let angle = 0;
+  for (const {
+    series,
+    point
+  } of segments) {
+    if (!isKnown(point.value) || point.value.value < 0) {
+      continue;
+    }
+    const fraction = point.value.value / denominator;
+    const sweep = fraction * TAU;
+    const start = angle;
+    const end = angle + sweep;
+    angle = end;
+    paths.push({
+      key: `arc-${series.id}-${point.id}`,
+      seriesId: series.id,
+      d: arcPath({
+        cx,
+        cy,
+        outerRadius,
+        innerRadius,
+        startAngle: start,
+        endAngle: end
+      }),
+      color: colorOf(series.id, point.id),
+      pattern: 'solid',
+      filled: true
+    });
+
+    // Label at the segment's midpoint, on the ring between the two radii.
+    const mid = start + sweep / 2 - Math.PI / 2;
+    const labelRadius = (outerRadius + innerRadius) / 2;
+    labels.push({
+      key: `arc-label-${series.id}-${point.id}`,
+      text: `${Math.round(fraction * 100)}%`,
+      x: cx + labelRadius * Math.cos(mid),
+      y: cy + labelRadius * Math.sin(mid),
+      anchor: 'middle',
+      // Hide labels on slivers where the text would not fit anyway.
+      muted: fraction < 0.05
+    });
+    hitRegions.push({
+      seriesId: series.id,
+      pointId: point.id,
+      x: cx + labelRadius * Math.cos(mid),
+      y: cy + labelRadius * Math.sin(mid),
+      arc: {
+        cx,
+        cy,
+        innerRadius,
+        outerRadius,
+        startAngle: start,
+        endAngle: end
+      },
+      selectable: !isWithheld(point.value)
+    });
+  }
+  return {
+    plot,
+    paths,
+    markers: [],
+    labels,
+    xTicks: [],
+    yTicks: [],
+    hitRegions,
+    incomplete
+  };
+}
+//# sourceMappingURL=distribution.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["resolveDistributionValues","segmentKey","isKnown","isWithheld","sumKnown","arcPath","rectSubpath","TAU","Math","PI","buildDistributionGeometry","datasource","input","options","plot","shape","segments","series","flatMap","points","map","point","length","width","height","paths","markers","labels","xTicks","yTicks","hitRegions","incomplete","total","s","value","countedPoints","suppliedAsProportions","valuesAre","denominator","max","coverage","colorOf","seriesId","pointId","segmentColors","seriesColors","barHeight","min","barY","y","cursor","x","fraction","push","key","id","d","color","pattern","filled","bounds","selectable","cx","cy","outerRadius","innerRadius","innerRadiusRatio","angle","sweep","start","end","startAngle","endAngle","mid","labelRadius","text","round","cos","sin","anchor","muted","arc"],"sourceRoot":"../../../src","sources":["geometry/distribution.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/geometry/heatmap.js

@@ -0,0 +1,182 @@
+"use strict";
+
+/**
+ * Heatmap geometry: a matrix of cells, batched by intensity bucket.
+ *
+ * This is where batching pays off most. A thousand cells become roughly eight
+ * paths — one per intensity bucket, plus one per non-value class — instead of a
+ * thousand elements. Cell count no longer drives element count at all
+ * (research.md R2).
+ *
+ * Empty, zero, and unavailable cells are distinct by construction (FR-027): a
+ * genuine zero lands in the lowest ramp bucket, while unknown, not-applicable,
+ * and withheld each get their own texture.
+ *
+ * PURE. No React, no SVG.
+ */
+
+import { isKnown, isWithheld } from "../contract/value.js";
+import { insetForAxes } from "./layout.js";
+import { rectBatchPath } from "./path.js";
+import { thinTicks } from "./ticks.js";
+export function buildHeatmapGeometry(datasource, input, options = {}) {
+  const rows = [];
+  const columns = [];
+  const rowSeen = new Set();
+  const colSeen = new Set();
+  for (const series of datasource.series) {
+    for (const point of series.points) {
+      if (point.position.kind !== 'matrix') {
+        continue;
+      }
+      if (!rowSeen.has(point.position.row)) {
+        rowSeen.add(point.position.row);
+        rows.push(point.position.row);
+      }
+      if (!colSeen.has(point.position.column)) {
+        colSeen.add(point.position.column);
+        columns.push(point.position.column);
+      }
+    }
+  }
+  if (rows.length === 0 || columns.length === 0 || input.plot.width <= 0) {
+    return {
+      plot: input.plot,
+      paths: [],
+      markers: [],
+      labels: [],
+      xTicks: [],
+      yTicks: [],
+      hitRegions: [],
+      incomplete: false
+    };
+  }
+
+  // Row and column names are the heatmap's axes. The plot makes room for
+  // them; they were computed before and never drawn (CHT-15).
+  const columnLabels = columns.map(input.formatCategory);
+  const rowLabels = rows.map(input.formatCategory);
+  const plot = insetForAxes(input.plot, {
+    xLabels: columnLabels,
+    yLabels: rowLabels,
+    fontSize: input.fontSize
+  });
+  const columnIndex = new Map(columns.map((column, index) => [column, index]));
+  const rowIndex = new Map(rows.map((row, index) => [row, index]));
+  const gap = options.cellGap ?? 2;
+  const cellWidth = plot.width / columns.length;
+  const cellHeight = plot.height / rows.length;
+  const ramp = input.heatmapRamp;
+  const bucketCount = Math.max(2, Math.min(options.buckets ?? ramp.length, ramp.length));
+  let min = Infinity;
+  let max = -Infinity;
+  for (const series of datasource.series) {
+    for (const point of series.points) {
+      if (isKnown(point.value)) {
+        min = Math.min(min, point.value.value);
+        max = Math.max(max, point.value.value);
+      }
+    }
+  }
+  const hasKnown = Number.isFinite(min) && Number.isFinite(max);
+  const span = max - min;
+
+  // Rects grouped by the path they will join.
+  const byBucket = new Map();
+  const byTexture = new Map();
+  const hitRegions = [];
+  let excluded = 0;
+  for (const series of datasource.series) {
+    if (series.hidden) {
+      continue;
+    }
+    for (const point of series.points) {
+      if (point.position.kind !== 'matrix') {
+        continue;
+      }
+      const col = columnIndex.get(point.position.column);
+      const row = rowIndex.get(point.position.row);
+      if (col === undefined || row === undefined) {
+        continue;
+      }
+      const rect = {
+        x: plot.x + col * cellWidth + gap / 2,
+        y: plot.y + row * cellHeight + gap / 2,
+        width: Math.max(0, cellWidth - gap),
+        height: Math.max(0, cellHeight - gap),
+        radius: options.cellRadius ?? input.radius?.cell
+      };
+      if (isKnown(point.value)) {
+        // A zero lands in bucket 0 rather than being treated as absent —
+        // "logged nothing" and "we do not know" must not look alike.
+        const t = hasKnown && span > 0 ? (point.value.value - min) / span : 0;
+        const bucket = Math.min(bucketCount - 1, Math.floor(t * (bucketCount - 1) + 0.5));
+        const list = byBucket.get(bucket) ?? [];
+        list.push(rect);
+        byBucket.set(bucket, list);
+      } else {
+        excluded += 1;
+        const kind = point.value.kind;
+        const list = byTexture.get(kind) ?? [];
+        list.push(rect);
+        byTexture.set(kind, list);
+      }
+      hitRegions.push({
+        seriesId: series.id,
+        pointId: point.id,
+        x: rect.x + rect.width / 2,
+        y: rect.y + rect.height / 2,
+        bounds: rect,
+        selectable: !isWithheld(point.value)
+      });
+    }
+  }
+  const paths = [];
+  for (const [bucket, rects] of byBucket) {
+    paths.push({
+      key: `cells-${bucket}`,
+      seriesId: datasource.series[0]?.id ?? 'heatmap',
+      d: rectBatchPath(rects),
+      color: ramp[Math.min(bucket, ramp.length - 1)],
+      pattern: 'solid',
+      filled: true
+    });
+  }
+  for (const [kind, rects] of byTexture) {
+    paths.push({
+      key: `cells-${kind}`,
+      seriesId: datasource.series[0]?.id ?? 'heatmap',
+      d: rectBatchPath(rects),
+      color: ramp[0],
+      pattern: 'solid',
+      filled: true,
+      texture: input.nonValueTextures[kind]
+    });
+  }
+  return {
+    plot,
+    paths,
+    markers: [],
+    labels: [],
+    xTicks: thinTicks(columnLabels.map((label, i) => ({
+      value: i,
+      position: plot.x + i * cellWidth + cellWidth / 2,
+      label
+    })), input.fontSize, plot.width),
+    yTicks: rowLabels.map((label, i) => ({
+      value: i,
+      position: plot.y + i * cellHeight + cellHeight / 2,
+      label
+    })),
+    hitRegions,
+    ...(hasKnown ? {
+      colorScale: {
+        min,
+        max,
+        colors: ramp.slice(0, bucketCount)
+      }
+    } : {}),
+    incomplete: excluded > 0
+  };
+}
+//# sourceMappingURL=heatmap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["isKnown","isWithheld","insetForAxes","rectBatchPath","thinTicks","buildHeatmapGeometry","datasource","input","options","rows","columns","rowSeen","Set","colSeen","series","point","points","position","kind","has","row","add","push","column","length","plot","width","paths","markers","labels","xTicks","yTicks","hitRegions","incomplete","columnLabels","map","formatCategory","rowLabels","xLabels","yLabels","fontSize","columnIndex","Map","index","rowIndex","gap","cellGap","cellWidth","cellHeight","height","ramp","heatmapRamp","bucketCount","Math","max","min","buckets","Infinity","value","hasKnown","Number","isFinite","span","byBucket","byTexture","excluded","hidden","col","get","undefined","rect","x","y","radius","cellRadius","cell","t","bucket","floor","list","set","seriesId","id","pointId","bounds","selectable","rects","key","d","color","pattern","filled","texture","nonValueTextures","label","i","colorScale","colors","slice"],"sourceRoot":"../../../src","sources":["geometry/heatmap.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/geometry/hitTest.js

@@ -0,0 +1,110 @@
+"use strict";
+
+/**
+ * Hit-testing for batched marks.
+ *
+ * Because marks are batched into one path per series, there are no per-element
+ * press handlers to rely on — a touch is resolved against geometry instead.
+ * That work would be needed anyway (a mobile time-series chart needs
+ * nearest-point search regardless of how it is drawn), and doing it in one
+ * place means a single implementation serves every family.
+ *
+ * PURE. No React, no SVG.
+ */
+
+/** Touch slop: how far from a mark a tap still counts, in px. */
+export const DEFAULT_HIT_RADIUS = 44;
+function inBounds(region, x, y) {
+  const b = region.bounds;
+  if (!b) {
+    return false;
+  }
+  return x >= b.x && x <= b.x + b.width && y >= b.y && y <= b.y + b.height;
+}
+const TAU = Math.PI * 2;
+function inArc(arc, x, y) {
+  const dx = x - arc.cx;
+  const dy = y - arc.cy;
+  const radius = Math.sqrt(dx * dx + dy * dy);
+  if (radius < arc.innerRadius || radius > arc.outerRadius) {
+    return false;
+  }
+  // Clockwise from the top, the convention the arcs are drawn in.
+  const angle = (Math.atan2(dy, dx) + Math.PI / 2 + TAU) % TAU;
+  return angle >= arc.startAngle && angle < arc.endAngle;
+}
+
+/**
+ * Resolves a touch to a mark.
+ *
+ * Containment wins over proximity where bounds exist — tapping inside a bar
+ * should select that bar even if a neighbouring bar's centre happens to be
+ * closer. Otherwise the nearest selectable mark within the hit radius wins.
+ */
+export function hitTest(regions, x, y, hitRadius = DEFAULT_HIT_RADIUS) {
+  let best = null;
+  for (const region of regions) {
+    if (!region.selectable) {
+      continue;
+    }
+    if (inBounds(region, x, y)) {
+      return {
+        seriesId: region.seriesId,
+        pointId: region.pointId,
+        distance: 0
+      };
+    }
+    if (region.arc) {
+      // A large segment's edge is far from its midpoint, and a neighbour's
+      // midpoint can be nearer: only the segment under the finger counts.
+      if (inArc(region.arc, x, y)) {
+        return {
+          seriesId: region.seriesId,
+          pointId: region.pointId,
+          distance: 0
+        };
+      }
+      continue;
+    }
+    const dx = region.x - x;
+    const dy = region.y - y;
+    const distance = Math.sqrt(dx * dx + dy * dy);
+    if (distance <= hitRadius && (best === null || distance < best.distance)) {
+      best = {
+        seriesId: region.seriesId,
+        pointId: region.pointId,
+        distance
+      };
+    }
+  }
+  return best;
+}
+
+/**
+ * Nearest mark by horizontal distance only.
+ *
+ * The right model for a time-series chart: a user aiming at "that Tuesday
+ * spike" cares about the x position, and demanding vertical accuracy on a line
+ * that may sit anywhere in the plot makes selection frustrating.
+ */
+export function hitTestByX(regions, x) {
+  let best = null;
+  for (const region of regions) {
+    if (!region.selectable) {
+      continue;
+    }
+    const distance = Math.abs(region.x - x);
+    if (best === null || distance < best.distance) {
+      best = {
+        seriesId: region.seriesId,
+        pointId: region.pointId,
+        distance
+      };
+    }
+  }
+  return best;
+}
+export function findRegion(regions, seriesId, pointId) {
+  return regions.find(r => r.seriesId === seriesId && (pointId === undefined || r.pointId === pointId));
+}
+//# sourceMappingURL=hitTest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_HIT_RADIUS","inBounds","region","x","y","b","bounds","width","height","TAU","Math","PI","inArc","arc","dx","cx","dy","cy","radius","sqrt","innerRadius","outerRadius","angle","atan2","startAngle","endAngle","hitTest","regions","hitRadius","best","selectable","seriesId","pointId","distance","hitTestByX","abs","findRegion","find","r","undefined"],"sourceRoot":"../../../src","sources":["geometry/hitTest.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/geometry/layout.js

@@ -0,0 +1,122 @@
+"use strict";
+
+/**
+ * Plot layout: turning a container size into a drawable plot rectangle.
+ *
+ * Font scale arrives as a parameter rather than being read from `PixelRatio`
+ * here, so this module stays pure and testable at any scale without mocking a
+ * platform API. The React layer reads the real value and passes it in.
+ *
+ * PURE. No React, no SVG.
+ */
+import { estimateTextWidth, reserveAxisSpace } from "./ticks.js";
+/**
+ * Ceiling on how far system text scaling may inflate chart labels.
+ *
+ * Beyond this the plot area collapses faster than the labels become useful, so
+ * we cap the growth rather than let the chart squeeze itself out of existence.
+ * The cap is documented in the README as the supported dynamic-type range.
+ */
+export const MAX_FONT_SCALE = 1.6;
+export function effectiveFontSize(baseFontSize, fontScale) {
+  const clamped = Math.max(1, Math.min(fontScale, MAX_FONT_SCALE));
+  return Math.round(baseFontSize * clamped);
+}
+
+/** A container that has not been measured yet, or has collapsed (FR-078). */
+export function isMeasurable(size) {
+  return Number.isFinite(size.width) && Number.isFinite(size.height) && size.width > 0 && size.height > 0;
+}
+export const EMPTY_PLOT = {
+  x: 0,
+  y: 0,
+  width: 0,
+  height: 0
+};
+
+/**
+ * Reserves axis space from estimated label widths, then hands back what is
+ * left for the marks.
+ *
+ * If the reservations would leave nothing to draw on, they are scaled back:
+ * a cramped axis beats a zero-area plot.
+ */
+export function resolvePlotRect(options) {
+  if (!isMeasurable(options.container)) {
+    return EMPTY_PLOT;
+  }
+  const pad = options.padding ?? 0;
+  const fontSize = effectiveFontSize(options.baseFontSize, options.fontScale);
+  let left = pad;
+  let bottom = pad;
+  if (options.yLabels && options.yLabels.length > 0) {
+    left += reserveAxisSpace(options.yLabels, fontSize, 'vertical');
+  }
+  if (options.xLabels && options.xLabels.length > 0) {
+    bottom += reserveAxisSpace(options.xLabels, fontSize, 'horizontal');
+  }
+  const availableWidth = options.container.width - pad;
+  const availableHeight = options.container.height - pad;
+
+  // Never let axis reservations consume more than 40% of either dimension.
+  const maxLeft = availableWidth * 0.4;
+  const maxBottom = availableHeight * 0.4;
+  left = Math.min(left, maxLeft);
+  bottom = Math.min(bottom, maxBottom);
+  return {
+    x: left,
+    y: pad,
+    width: Math.max(0, options.container.width - left - pad),
+    height: Math.max(0, options.container.height - bottom - pad)
+  };
+}
+/**
+ * Shrinks a plot so its own axis labels fit inside the container.
+ *
+ * Builders call this once they know their tick labels (which depend only on
+ * the data domain) and before projecting anything, so the reservation costs no
+ * second pass. Without it the frame handed every builder the full container:
+ * Y labels, drawn right-aligned left of the plot, landed at negative x, and X
+ * labels below the baseline fell past the bottom of the SVG (CHT-01).
+ *
+ * - left: the widest Y label plus a gutter, and at least half the widest X
+ *   label, because the first X label is centred on the plot's left edge;
+ * - right: half the widest X label, for the last one;
+ * - top: the part of the topmost Y label that rises above its tick;
+ * - bottom: one line of X labels plus a gutter.
+ *
+ * Each side is capped so labels can never squeeze the plot out of existence.
+ */
+export function insetForAxes(outer, labels) {
+  const {
+    fontSize
+  } = labels;
+  let widestX = 0;
+  for (const label of labels.xLabels) {
+    widestX = Math.max(widestX, estimateTextWidth(label, fontSize));
+  }
+  const hasY = labels.yLabels.length > 0;
+  const hasX = labels.xLabels.length > 0;
+  const left = Math.min(Math.max(hasY ? reserveAxisSpace(labels.yLabels, fontSize, 'vertical') : 0, widestX / 2), outer.width * 0.4);
+  const right = Math.min(widestX / 2, outer.width * 0.25);
+  // Y labels sit on their tick at `position + fontSize / 3`, so two thirds of
+  // the glyph box rise above it.
+  const top = hasY ? Math.min(Math.ceil(fontSize * 2 / 3), outer.height * 0.2) : 0;
+  const bottom = hasX ? Math.min(reserveAxisSpace(labels.xLabels, fontSize, 'horizontal'), outer.height * 0.4) : 0;
+  return {
+    x: outer.x + left,
+    y: outer.y + top,
+    width: Math.max(0, outer.width - left - right),
+    height: Math.max(0, outer.height - top - bottom)
+  };
+}
+export function plotBottom(plot) {
+  return plot.y + plot.height;
+}
+export function plotRight(plot) {
+  return plot.x + plot.width;
+}
+export function containsPoint(plot, x, y) {
+  return x >= plot.x && x <= plotRight(plot) && y >= plot.y && y <= plotBottom(plot);
+}
+//# sourceMappingURL=layout.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["estimateTextWidth","reserveAxisSpace","MAX_FONT_SCALE","effectiveFontSize","baseFontSize","fontScale","clamped","Math","max","min","round","isMeasurable","size","Number","isFinite","width","height","EMPTY_PLOT","x","y","resolvePlotRect","options","container","pad","padding","fontSize","left","bottom","yLabels","length","xLabels","availableWidth","availableHeight","maxLeft","maxBottom","insetForAxes","outer","labels","widestX","label","hasY","hasX","right","top","ceil","plotBottom","plot","plotRight","containsPoint"],"sourceRoot":"../../../src","sources":["geometry/layout.ts"],"mappings":"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","ignoreList":[]}