@chipmobilesdk/rn-chart 0.3.0 → 0.4.0

package/src/geometry/hitTest.ts

@@ -23,6 +23,19 @@ export interface HitRegion {
 		readonly width: number;
 		readonly height: number;
 	};
+	/**
+	 * An arc segment: containment by radius and angle. Angles are radians,
+	 * clockwise from twelve o'clock, as the distribution geometry draws them.
+	 * A region with an arc is hit only inside it, never by proximity.
+	 */
+	readonly arc?: {
+		readonly cx: number;
+		readonly cy: number;
+		readonly innerRadius: number;
+		readonly outerRadius: number;
+		readonly startAngle: number;
+		readonly endAngle: number;
+	};
 	/**
 	 * False for points that must never be selectable: withheld values, and
 	 * anything the chart is not currently drawing (FR-053).
@@ -47,6 +60,20 @@ function inBounds(region: HitRegion, x: number, y: number): boolean {
 	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: NonNullable<HitRegion['arc']>, x: number, y: number): boolean {
+	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.
  *
@@ -70,6 +97,14 @@ export function hitTest(
 		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;

package/src/geometry/progress.ts

@@ -17,7 +17,6 @@ import { rectSubpath } from './path';
 import type { GeometryInput, GeometryLabel, MarkerLine, MarkPath, ResolvedGeometry } from './types';
 
 export interface ProgressOptions {
-	readonly orientation?: 'horizontal' | 'vertical';
 	readonly trackRadius?: number;
 }
 

package/src/geometry/ticks.ts

@@ -130,16 +130,3 @@ export function reserveAxisSpace(
 	}
 	return widest + LABEL_GUTTER;
 }
-
-/**
- * Shortens a label that cannot fit, signalling the truncation with an ellipsis.
- * Callers must expose the full value through an accessible label (FR-070).
- */
-export function truncateToWidth(text: string, fontSize: number, maxWidthPx: number): string {
-	if (estimateTextWidth(text, fontSize) <= maxWidthPx) {
-		return text;
-	}
-	const perChar = fontSize * AVERAGE_ADVANCE_RATIO;
-	const fits = Math.max(1, Math.floor(maxWidthPx / perChar) - 1);
-	return `${text.slice(0, fits)}…`;
-}

package/src/geometry/timeSeries.ts

@@ -50,8 +50,13 @@ export function buildTimeSeriesGeometry<M>(
 	const values: number[] = [];
 	let excluded = 0;
 
+	// Sorted and windowed once per series; both passes below read the result.
+	const ordered = new Map(
+		datasource.series.map(series => [series, visiblePoints(series, options.range)] as const),
+	);
+
 	for (const series of datasource.series) {
-		for (const point of visiblePoints(series, options.range)) {
+		for (const point of ordered.get(series) ?? []) {
 			if (point.position.kind === 'instant') {
 				instants.push(point.position.at);
 			}
@@ -104,7 +109,7 @@ export function buildTimeSeriesGeometry<M>(
 
 		const pts: MaybePt[] = [];
 
-		for (const point of visiblePoints(series, options.range)) {
+		for (const point of ordered.get(series) ?? []) {
 			const at = point.position.kind === 'instant' ? point.position.at : 0;
 			const px = x.project(at);
 

package/src/geometry/types.ts

@@ -46,6 +46,13 @@ export interface GeometryLabel {
 	readonly muted?: boolean;
 }
 
+/** What a colour ramp runs from and to, for the legend that explains it. */
+export interface ColorScale {
+	readonly min: number;
+	readonly max: number;
+	readonly colors: readonly string[];
+}
+
 export interface ResolvedGeometry {
 	readonly plot: PlotRect;
 	readonly paths: readonly MarkPath[];
@@ -54,6 +61,8 @@ export interface ResolvedGeometry {
 	readonly xTicks: readonly Tick[];
 	readonly yTicks: readonly Tick[];
 	readonly hitRegions: readonly HitRegion[];
+	/** Present when colour encodes a value, as in a heatmap. */
+	readonly colorScale?: ColorScale;
 	/**
 	 * True when something was excluded from a total or proportion, so the chart
 	 * can say so rather than presenting a partial figure as whole (FR-013).
@@ -88,6 +97,8 @@ export interface GeometryInput {
 		Record<'unknown' | 'notApplicable' | 'withheld', NonValueTexture>
 	>;
 	readonly heatmapRamp: readonly string[];
+	/** Corner radii from the theme, for bars and heatmap cells. */
+	readonly radius?: { readonly bar: number; readonly cell: number };
 	readonly formatValue: (value: number) => string;
 	readonly formatCategory: (raw: string) => string;
 	readonly formatInstant: (at: number) => string;

package/src/index.ts

@@ -62,6 +62,8 @@ export {
 	resolveUnit,
 } from './contract/datasource';
 
+export type { DistributionValues } from './contract/distribution';
+
 export type { MarkerKind, ProgressReading, ReferenceMarker } from './contract/marker';
 export { findTarget, isUsableTarget, readProgress } from './contract/marker';
 
@@ -149,7 +151,8 @@ export {
 	TimeSeriesChart,
 } from './react/charts';
 
-export { ChartLegend, buildLegendEntries } from './react/ChartLegend';
+export { ChartLegend, ColorScaleLegend, buildLegendEntries } from './react/ChartLegend';
+export type { ColorScale } from './geometry/types';
 export { ChartThemeProvider, useChartTheme } from './react/ChartThemeProvider';
 
 // ---------------------------------------------------------------------------