@chipmobilesdk/rn-chart 0.3.0 → 0.5.0

package/lib/typescript/commonjs/react/useChartFormatters.d.ts

@@ -0,0 +1,21 @@
+import type { Position } from '../contract/datasource';
+import { type ChartFormatters, type FormatHint, type SeriesRef } from '../contract/format';
+import type { ValueState } from '../contract/value';
+export interface GeometryFormatters {
+    readonly formatValue: (value: number) => string;
+    readonly formatCategory: (raw: string) => string;
+    readonly formatInstant: (at: number) => string;
+}
+export interface ResolvedFormatters {
+    /** A value as the chart draws it. */
+    readonly formatValue: (value: ValueState) => string;
+    /** A value as the chart speaks it; the app's `summary` formatter when given. */
+    readonly formatSummaryValue: (value: ValueState) => string;
+    /** A position as the chart speaks it; the app's `axisLabel` formatter when given. */
+    readonly formatPosition: (position: Position) => string;
+    /** Present only when the app supplies `legendLabel`. */
+    readonly legendLabel?: (series: SeriesRef) => string;
+    readonly geometry: GeometryFormatters;
+}
+export declare function useChartFormatters(formatters: ChartFormatters | undefined, hint: FormatHint | undefined, instanceKey: string): ResolvedFormatters;
+//# sourceMappingURL=useChartFormatters.d.ts.map

package/lib/typescript/commonjs/react/useChartFormatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChartFormatters.d.ts","sourceRoot":"","sources":["../../../../src/react/useChartFormatters.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAIN,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IAClC,qCAAqC;IACrC,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,CAAC;IACpD,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,CAAC;IAC3D,qFAAqF;IACrF,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,MAAM,CAAC;IACxD,wDAAwD;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;CACtC;AAED,wBAAgB,kBAAkB,CACjC,UAAU,EAAE,eAAe,GAAG,SAAS,EACvC,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,WAAW,EAAE,MAAM,GACjB,kBAAkB,CA2DpB"}

package/lib/typescript/commonjs/react/useChartLayout.d.ts

@@ -0,0 +1,27 @@
+import { type LayoutChangeEvent } from 'react-native';
+import type { ChartDatasource, ChartFamily } from '../contract/datasource';
+import { type ChartTheme } from '../contract/theme';
+import { type ContainerSize, type PlotRect } from '../geometry/layout';
+import type { GeometryInput } from '../geometry/types';
+export interface ChartLayout {
+    readonly onLayout: (event: LayoutChangeEvent) => void;
+    readonly size: ContainerSize;
+    readonly measured: boolean;
+    readonly plot: PlotRect;
+    readonly fontSize: number;
+}
+export declare function useChartLayout(theme: ChartTheme, options?: {
+    readonly height?: number;
+    readonly xLabels?: readonly string[];
+    readonly yLabels?: readonly string[];
+}): ChartLayout;
+/**
+ * Builds the geometry input, resolving per-series colours once so geometry
+ * modules never reach into the theme themselves.
+ */
+export declare function useGeometryInput<M>(datasource: ChartDatasource<M>, theme: ChartTheme, layout: ChartLayout, formatters: {
+    readonly formatValue: (value: number) => string;
+    readonly formatCategory: (raw: string) => string;
+    readonly formatInstant: (at: number) => string;
+}, family?: ChartFamily): GeometryInput;
+//# sourceMappingURL=useChartLayout.d.ts.map

package/lib/typescript/commonjs/react/useChartLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChartLayout.d.ts","sourceRoot":"","sources":["../../../../src/react/useChartLayout.ts"],"names":[],"mappings":"AAaA,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE3E,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAA4C,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAIN,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAC7B,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE;IACR,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,GACJ,WAAW,CA6Cb;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE;IACX,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C,EACD,MAAM,CAAC,EAAE,WAAW,GAClB,aAAa,CAuBf"}

package/lib/typescript/commonjs/react/useChartSelection.d.ts

@@ -0,0 +1,52 @@
+import type { PointInteractionEvent, SelectionRef, SeriesInteractionEvent } from '../contract/interaction';
+import { type HitRegion } from '../geometry/hitTest';
+export interface UseChartSelectionArgs<M> {
+    /** Present (including `null`) means the app owns the selection. */
+    readonly controlled?: SelectionRef | null;
+    readonly onSelectionChange?: (next: SelectionRef | null, event: PointInteractionEvent<M> | null) => void;
+    readonly onSelectionUnresolvable?: (ref: SelectionRef) => void;
+    readonly hitRegions: readonly HitRegion[];
+    /** Non-ready statuses suppress selection entirely (FR-053). */
+    readonly interactionSuppressed: boolean;
+    /**
+     * False until the container has been measured and geometry exists.
+     *
+     * Without this, a chart that has not laid out yet has no hit regions, and a
+     * perfectly valid app-controlled selection would be reported as
+     * unresolvable on first paint — telling the app its state is wrong when it
+     * is not.
+     */
+    readonly geometryReady: boolean;
+}
+export interface SelectOptions {
+    /**
+     * Selecting what is already selected clears it — the touch gesture. False
+     * for screen-reader stepping, where landing on the same point again (a chart
+     * with one point) must not switch the selection off and on (CHT-06).
+     */
+    readonly toggle?: boolean;
+}
+export interface ChartSelectionApi<M> {
+    /** What to draw. Never a reference the datasource cannot resolve. */
+    readonly resolved: HitRegion | undefined;
+    readonly selection: SelectionRef | null;
+    readonly select: (ref: SelectionRef | null, event: PointInteractionEvent<M> | null, options?: SelectOptions) => void;
+}
+export declare function useChartSelection<M>(args: UseChartSelectionArgs<M>): ChartSelectionApi<M>;
+export interface UseSeriesVisibilityArgs<M> {
+    /** Present means the app owns visibility. */
+    readonly controlled?: readonly string[];
+    readonly onVisibilityChange?: (event: SeriesInteractionEvent<M>) => void;
+    /** Toggling stays off unless the app opts in (FR-049). */
+    readonly enabled: boolean;
+    /** Series marked hidden in the datasource itself. */
+    readonly initiallyHidden: readonly string[];
+}
+export interface SeriesVisibilityApi {
+    /** The same Set until the hidden ids change, so memos may depend on it. */
+    readonly hidden: ReadonlySet<string>;
+    readonly toggle: (seriesId: string, metadata?: unknown) => void;
+    readonly enabled: boolean;
+}
+export declare function useSeriesVisibility<M>(args: UseSeriesVisibilityArgs<M>): SeriesVisibilityApi;
+//# sourceMappingURL=useChartSelection.d.ts.map

package/lib/typescript/commonjs/react/useChartSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChartSelection.d.ts","sourceRoot":"","sources":["../../../../src/react/useChartSelection.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACX,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACvC,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAC5B,IAAI,EAAE,YAAY,GAAG,IAAI,EACzB,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,KAClC,IAAI,CAAC;IACV,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IAC/D,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,+DAA+D;IAC/D,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IACnC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAChB,GAAG,EAAE,YAAY,GAAG,IAAI,EACxB,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,IAAI,EACtC,OAAO,CAAC,EAAE,aAAa,KACnB,IAAI,CAAC;CACV;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CA+DzF;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACzC,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACzE,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IACnC,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAChE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAKD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAoC5F"}

package/lib/typescript/commonjs/react/useChartStatus.d.ts

@@ -0,0 +1,22 @@
+import type { ChartDatasource, ChartFamily } from '../contract/datasource';
+import type { DistributionValues } from '../contract/distribution';
+import { type ChartError, type ChartFailureHandler } from '../contract/errors';
+import { type ChartStatus, type DeclarableChartStatus } from '../contract/state';
+import { type ValidationResult } from '../validation/validateDatasource';
+export interface UseChartStatusArgs<M> {
+    readonly datasource: ChartDatasource<M>;
+    readonly family: ChartFamily;
+    readonly chartId?: string;
+    /** `chartId`, or a generated id: what a once-per-chart warning is keyed on. */
+    readonly instanceKey: string;
+    readonly declared?: DeclarableChartStatus;
+    readonly onFailure?: ChartFailureHandler;
+    readonly distributionValues?: DistributionValues;
+}
+export interface ChartStatusResult {
+    readonly validation: ValidationResult;
+    readonly error: ChartError | undefined;
+    readonly status: ChartStatus;
+}
+export declare function useChartStatus<M>(args: UseChartStatusArgs<M>): ChartStatusResult;
+//# sourceMappingURL=useChartStatus.d.ts.map

package/lib/typescript/commonjs/react/useChartStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChartStatus.d.ts","sourceRoot":"","sources":["../../../../src/react/useChartStatus.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAc,KAAK,UAAU,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAiB,KAAK,WAAW,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAEhG,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAE7F,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACjD;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC7B;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAsDhF"}

package/lib/typescript/commonjs/render/Axis.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Axis and grid rendering. Private SVG adapter.
+ *
+ * Ticks arrive already thinned by `geometry/ticks.ts`, so nothing here decides
+ * what fits — this module only draws what the geometry chose.
+ */
+import React from 'react';
+import type { ChartTheme } from '../contract/theme';
+import type { PlotRect } from '../geometry/layout';
+import type { Tick } from '../geometry/ticks';
+export declare function Grid({ plot, yTicks, theme, }: {
+    readonly plot: PlotRect;
+    readonly yTicks: readonly Tick[];
+    readonly theme: ChartTheme;
+}): React.JSX.Element;
+export declare function XAxis({ plot, ticks, theme, fontSize, line, }: {
+    readonly plot: PlotRect;
+    readonly ticks: readonly Tick[];
+    readonly theme: ChartTheme;
+    readonly fontSize: number;
+    /** False for a heatmap: its columns are named, but there is no axis to draw. */
+    readonly line?: boolean;
+}): React.JSX.Element;
+export declare function YAxis({ plot, ticks, theme, fontSize, line, }: {
+    readonly plot: PlotRect;
+    readonly ticks: readonly Tick[];
+    readonly theme: ChartTheme;
+    readonly fontSize: number;
+    readonly line?: boolean;
+}): React.JSX.Element;
+//# sourceMappingURL=Axis.d.ts.map

package/lib/typescript/commonjs/render/Axis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Axis.d.ts","sourceRoot":"","sources":["../../../../src/render/Axis.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,wBAAgB,IAAI,CAAC,EACpB,IAAI,EACJ,MAAM,EACN,KAAK,GACL,EAAE;IACF,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC3B,qBAgBA;AAED,wBAAgB,KAAK,CAAC,EACrB,IAAI,EACJ,KAAK,EACL,KAAK,EACL,QAAQ,EACR,IAAW,GACX,EAAE;IACF,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACxB,qBA6BA;AAED,wBAAgB,KAAK,CAAC,EACrB,IAAI,EACJ,KAAK,EACL,KAAK,EACL,QAAQ,EACR,IAAW,GACX,EAAE;IACF,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACxB,qBA2BA"}

package/lib/typescript/commonjs/render/Marks.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Private SVG adapter for resolved geometry.
+ *
+ * Everything here consumes plain data produced by `geometry/`. Swapping the
+ * drawing substrate means rewriting this directory and nothing else.
+ */
+import React from 'react';
+import type { SeriesPattern } from '../contract/datasource';
+import type { ChartTheme } from '../contract/theme';
+import type { GeometryLabel, MarkPath, MarkerLine } from '../geometry/types';
+/**
+ * Dash patterns give series a second, non-colour identity (FR-064). `undefined`
+ * means a solid stroke.
+ */
+export declare function dashArrayFor(pattern: SeriesPattern): string | undefined;
+/**
+ * Texture definitions for the three non-value classes.
+ *
+ * Deliberately shape-based rather than colour-based: a reader in greyscale, or
+ * with reduced colour perception, must still tell a gap from a hatch from a
+ * locked cell (FR-064, SC-012).
+ */
+export declare function NonValueTextures({ theme }: {
+    readonly theme: ChartTheme;
+}): React.JSX.Element;
+export declare function Marks({ paths }: {
+    readonly paths: readonly MarkPath[];
+}): React.JSX.Element;
+export declare function MarkerLines({ markers, theme, }: {
+    readonly markers: readonly MarkerLine[];
+    readonly theme: ChartTheme;
+}): React.JSX.Element;
+export declare function GeometryLabels({ labels, theme, fontSize, }: {
+    readonly labels: readonly GeometryLabel[];
+    readonly theme: ChartTheme;
+    readonly fontSize: number;
+}): React.JSX.Element;
+/** Marks the currently selected point, when it still resolves. */
+export declare function SelectionHighlight({ x, y, color, }: {
+    readonly x: number;
+    readonly y: number;
+    readonly color: string;
+}): React.JSX.Element;
+//# sourceMappingURL=Marks.d.ts.map

package/lib/typescript/commonjs/render/Marks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Marks.d.ts","sourceRoot":"","sources":["../../../../src/render/Marks.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE7E;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAWvE;AAQD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,qBAsBzE;AASD,wBAAgB,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;CAAE,qBAoBvE;AAED,wBAAgB,WAAW,CAAC,EAC3B,OAAO,EACP,KAAK,GACL,EAAE;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC3B,qBAeA;AAED,wBAAgB,cAAc,CAAC,EAC9B,MAAM,EACN,KAAK,EACL,QAAQ,GACR,EAAE;IACF,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B,qBAoBA;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,EAClC,CAAC,EACD,CAAC,EACD,KAAK,GACL,EAAE;IACF,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB,qBAOA"}

package/lib/typescript/commonjs/validation/budgets.d.ts

@@ -0,0 +1,24 @@
+import type { ChartDatasource, ChartFamily } from '../contract/datasource';
+export interface DatasetBudget {
+    readonly maxSeries: number;
+    readonly maxPointsPerSeries?: number;
+    readonly maxCells?: number;
+}
+export declare const DATASET_BUDGETS: Readonly<Record<ChartFamily, DatasetBudget>>;
+export interface BudgetCheck {
+    readonly withinBudget: boolean;
+    readonly seriesCount: number;
+    readonly maxPointsInAnySeries: number;
+    readonly totalPoints: number;
+}
+export declare function checkBudget<M>(datasource: ChartDatasource<M>, family: ChartFamily): BudgetCheck;
+/**
+ * Warns once per chart instance per mount. De-duplicating matters: a scrolling
+ * dashboard would otherwise flood the console on every frame.
+ */
+export declare function warnIfOverBudget<M>(datasource: ChartDatasource<M>, family: ChartFamily, instanceKey: string): void;
+/** Called on unmount so a remounted chart can warn again. */
+export declare function releaseBudgetWarning(instanceKey: string): void;
+/** Test-only reset. */
+export declare function __resetBudgetWarnings(): void;
+//# sourceMappingURL=budgets.d.ts.map

package/lib/typescript/commonjs/validation/budgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../../../../src/validation/budgets.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAMxE,CAAC;AAEF,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,WAAW,CAsB/F;AAOD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,GACjB,IAAI,CA0BN;AAED,6DAA6D;AAC7D,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAE9D;AAED,uBAAuB;AACvB,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/lib/typescript/commonjs/validation/validateDatasource.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Datasource validation (FR-015, FR-017, FR-007a).
+ *
+ * Rules V1-V8 from specs/007-rn-chart-package/data-model.md §6. Every failure
+ * returns a `ChartError` built from the fixed message catalogue, so validation
+ * output can never carry a data value or a series label.
+ *
+ * Note V8: an empty datasource is **not** an error. It resolves to the empty
+ * state, which is a first-class outcome rather than a failure.
+ */
+import { type ChartDatasource, type ChartFamily } from '../contract/datasource';
+import { type DistributionValues } from '../contract/distribution';
+import { type ChartError } from '../contract/errors';
+export interface ValidationResult {
+    readonly error?: ChartError;
+    /** No points at all across every series (V8). */
+    readonly isEmpty: boolean;
+    /** Some points are known and others are not (FR-032). */
+    readonly isPartial: boolean;
+    /** Distribution segments that do not sum to the whole (V6, FR-024). */
+    readonly totalIncomplete: boolean;
+}
+export declare function validateDatasource<M>(datasource: ChartDatasource<M>, family: ChartFamily, chartId?: string, 
+/** What a distribution's values mean, when the app says; inferred otherwise. */
+distributionValues?: DistributionValues): ValidationResult;
+//# sourceMappingURL=validateDatasource.d.ts.map

package/lib/typescript/commonjs/validation/validateDatasource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateDatasource.d.ts","sourceRoot":"","sources":["../../../../src/validation/validateDatasource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAEN,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGN,KAAK,kBAAkB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGtE,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CAClC;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EACnC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,MAAM;AAChB,gFAAgF;AAChF,kBAAkB,CAAC,EAAE,kBAAkB,GACrC,gBAAgB,CAuIlB"}

package/lib/typescript/module/a11y/summary.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Composed accessible summaries (FR-067, FR-068, FR-069, FR-072).
+ *
+ * Exposing 2,500 individual points to a screen reader would be unusable even
+ * if it were cheap. A composed summary covers the same need: what the chart is,
+ * what it shows, where the extremes are, and what any target says.
+ *
+ * Withheld values never enter a summary — that would leak exactly what the
+ * withheld class exists to protect (FR-033).
+ */
+import type { ChartDatasource, ChartFamily, Position } from '../contract/datasource.js';
+import type { ChartStatus } from '../contract/state.js';
+import { type ChartStrings } from '../contract/strings.js';
+import { type ValueState } from '../contract/value.js';
+export interface SummaryInput<M = unknown> {
+    readonly datasource: ChartDatasource<M>;
+    readonly family: ChartFamily;
+    readonly status: ChartStatus;
+    readonly title?: string;
+    readonly formatValue: (value: ValueState) => string;
+    /** How a position is spoken; the app's axis formatter when it has one. */
+    readonly formatPosition?: (position: Position) => string;
+    readonly incomplete?: boolean;
+    /** The texts to speak; the English defaults when omitted. */
+    readonly strings?: ChartStrings;
+}
+/**
+ * Builds the label read aloud for the chart as a whole.
+ *
+ * Non-ready statuses replace the data description rather than appending to it,
+ * so a loading chart never announces figures it is not showing.
+ */
+export declare function buildChartSummary<M>(input: SummaryInput<M>): string;
+/** Announced for the currently selected point on an adjustable chart. */
+export declare function buildPointAnnouncement(seriesLabel: string, positionLabel: string, value: ValueState, formatValue: (v: ValueState) => string, strings?: ChartStrings): string;
+/** Total plus an explicit note when it is not the whole picture (FR-013). */
+export declare function buildTotalAnnouncement<M>(datasource: ChartDatasource<M>, formatValue: (v: ValueState) => string, strings?: ChartStrings): string;
+//# sourceMappingURL=summary.d.ts.map

package/lib/typescript/module/a11y/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../../src/a11y/summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,2BAAwB,CAAC;AAGrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAmB,CAAC;AAGrD,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,wBAAqB,CAAC;AACtE,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,sBAAmB,CAAC;AAwBvE,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACxC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,CAAC;IACpD,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,MAAM,CAAC;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CAChC;AAkFD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,CAoCnE;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CACrC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,EACtC,OAAO,GAAE,YAAoC,GAC3C,MAAM,CASR;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CAAC,CAAC,EACvC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,WAAW,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,EACtC,OAAO,GAAE,YAAoC,GAC3C,MAAM,CAOR"}

package/lib/typescript/module/contract/datasource.d.ts

@@ -0,0 +1,94 @@
+/**
+ * The shared datasource contract (FR-007, FR-007a).
+ *
+ * One contract spans every chart family: each point carries the same envelope —
+ * identity, value state, optional unit and format hint, opaque metadata — and
+ * only its **position** varies by kind. Families that accept the same position
+ * kind consume one another's datasources unchanged; anything else is a
+ * validation error rather than a rendering guess.
+ *
+ * See specs/007-rn-chart-package/data-model.md §2–§6.
+ */
+import type { FormatHint } from './format.js';
+import type { ReferenceMarker } from './marker.js';
+import type { ValueState } from './value.js';
+export type ChartFamily = 'progress' | 'distribution' | 'timeSeries' | 'bar' | 'heatmap';
+/** A named bucket: a category axis, a distribution segment, a progress metric. */
+export interface CategoryPosition {
+    readonly kind: 'category';
+    readonly category: string;
+}
+/**
+ * An absolute instant as epoch milliseconds, UTC.
+ *
+ * A number rather than a `Date` or an ISO string: cheap to compare and
+ * memoize, no per-render parsing across hundreds of points, no identity churn
+ * that would defeat the re-render guarantee, and no ambiguous offset. All
+ * date wording comes from app formatters (FR-016).
+ */
+export interface InstantPosition {
+    readonly kind: 'instant';
+    readonly at: number;
+}
+/** A cell in a row-by-column matrix, for heatmaps. */
+export interface MatrixPosition {
+    readonly kind: 'matrix';
+    readonly row: string;
+    readonly column: string;
+}
+export type Position = CategoryPosition | InstantPosition | MatrixPosition;
+export type PositionKind = Position['kind'];
+/** Non-colour encoding for a series, so meaning never rides on hue alone (FR-064). */
+export type SeriesPattern = 'solid' | 'dashed' | 'dotted' | 'dashDot';
+export interface DataPoint<M = unknown> {
+    /** Stable and unique within its series. Duplicates are a validation error. */
+    readonly id: string;
+    readonly position: Position;
+    readonly value: ValueState;
+    /** Overrides the series unit. */
+    readonly unit?: string;
+    /** Overrides the series format hint. */
+    readonly format?: FormatHint;
+    /** Colour of this point's segment in a distribution chart. Ignored elsewhere. */
+    readonly color?: string;
+    /** Opaque to the package: never read, never logged, returned unchanged. */
+    readonly metadata?: M;
+}
+export interface Series<M = unknown> {
+    /** Stable and unique within the datasource. */
+    readonly id: string;
+    readonly label: string;
+    readonly points: readonly DataPoint<M>[];
+    readonly unit?: string;
+    readonly format?: FormatHint;
+    /** Explicit colour override; otherwise the theme palette assigns one. */
+    readonly color?: string;
+    readonly pattern?: SeriesPattern;
+    /** Initial visibility. Runtime toggling is controlled separately. */
+    readonly hidden?: boolean;
+    readonly metadata?: M;
+}
+export interface ChartDatasource<M = unknown> {
+    /** Declared once, then validated against every point and the receiving family. */
+    readonly positionKind: PositionKind;
+    readonly series: readonly Series<M>[];
+    readonly markers?: readonly ReferenceMarker[];
+    readonly unit?: string;
+    readonly format?: FormatHint;
+    readonly metadata?: M;
+}
+/**
+ * Which position kinds each family accepts.
+ *
+ * Bar accepting both `category` and `instant` is what makes swapping a
+ * time-series chart for a bar chart free — the datasource does not change.
+ */
+export declare const FAMILY_POSITION_KINDS: Readonly<Record<ChartFamily, readonly PositionKind[]>>;
+export declare function familyAcceptsPositionKind(family: ChartFamily, kind: PositionKind): boolean;
+/**
+ * Resolves unit and format through the documented precedence:
+ * point -> series -> datasource -> undefined (caller falls back to its default).
+ */
+export declare function resolveFormat<M>(point: DataPoint<M> | undefined, series: Series<M> | undefined, datasource: ChartDatasource<M>): FormatHint | undefined;
+export declare function resolveUnit<M>(point: DataPoint<M> | undefined, series: Series<M> | undefined, datasource: ChartDatasource<M>): string | undefined;
+//# sourceMappingURL=datasource.d.ts.map

package/lib/typescript/module/contract/datasource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasource.d.ts","sourceRoot":"","sources":["../../../../src/contract/datasource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAU,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAS,CAAC;AAE1C,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,cAAc,GAAG,YAAY,GAAG,KAAK,GAAG,SAAS,CAAC;AAEzF,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACpB;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,QAAQ,GAAG,gBAAgB,GAAG,eAAe,GAAG,cAAc,CAAC;AAC3E,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;AAE5C,sFAAsF;AACtF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtE,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACrC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,OAAO;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC3C,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;CACtB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,YAAY,EAAE,CAAC,CAMxF,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAE1F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC9B,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,EAC/B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,EAC7B,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,GAC5B,UAAU,GAAG,SAAS,CAExB;AAED,wBAAgB,WAAW,CAAC,CAAC,EAC5B,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,EAC/B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,EAC7B,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,GAC5B,MAAM,GAAG,SAAS,CAEpB"}

package/lib/typescript/module/contract/distribution.d.ts

@@ -0,0 +1,17 @@
+/**
+ * What the numbers of a distribution mean (CHT-10).
+ *
+ * `proportions`: each value is already a share of the whole, in 0..1. A sum
+ * short of 1 is drawn short and reported incomplete. `absolute`: counts or
+ * amounts, normalised by their own total.
+ *
+ * Until 0.4.0 this was guessed from the values alone: anything in 0..1 was a
+ * proportion, so two segments counting 1 each drew two full circles on top of
+ * one another. The guess now also requires the shares to fit in one whole, and
+ * an app that knows can say so.
+ */
+import type { ChartDatasource } from './datasource.js';
+export type DistributionValues = 'proportions' | 'absolute';
+export declare const DISTRIBUTION_SUM_TOLERANCE = 0.001;
+export declare function resolveDistributionValues<M>(datasource: ChartDatasource<M>, declared?: DistributionValues): DistributionValues;
+//# sourceMappingURL=distribution.d.ts.map

package/lib/typescript/module/contract/distribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../../../src/contract/distribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAc,CAAC;AAGpD,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,UAAU,CAAC;AAE5D,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAEhD,wBAAgB,yBAAyB,CAAC,CAAC,EAC1C,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,QAAQ,CAAC,EAAE,kBAAkB,GAC3B,kBAAkB,CAqBpB"}

package/lib/typescript/module/contract/errors.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Typed error taxonomy and failure reporting (FR-038, FR-038a, FR-038b).
+ *
+ * Messages come from a **fixed catalogue with no interpolated data**. That is
+ * what makes the redaction guarantee structural rather than a rule someone has
+ * to remember: because the package never builds a message out of a value or a
+ * label, a failure report cannot carry patient data or account balances into a
+ * consuming app's crash reporting.
+ */
+import type { ChartFamily, PositionKind } from './datasource.js';
+export type ChartErrorCategory = 'validation' | 'declared' | 'render';
+export type ChartErrorCode = 'duplicateSeriesId' | 'duplicatePointId' | 'positionKindMismatch' | 'familyPositionKindUnsupported' | 'inconsistentMatrix' | 'distributionNotWhole' | 'nonFiniteValue' | 'negativeDistributionValue' | 'declaredByApp' | 'renderException';
+export interface ChartError {
+    readonly category: ChartErrorCategory;
+    readonly code: ChartErrorCode;
+    readonly message: string;
+    readonly chartId?: string;
+    readonly family?: ChartFamily;
+    /**
+     * Structural detail that is safe to expose: counts and kinds only, never a
+     * value or a label.
+     */
+    readonly detail?: {
+        readonly expectedKind?: PositionKind;
+        readonly actualKind?: PositionKind;
+        readonly occurrences?: number;
+    };
+}
+export interface ChartFailureReport {
+    readonly chartId?: string;
+    readonly family: ChartFamily;
+    readonly error: ChartError;
+    readonly componentStack?: string;
+}
+export type ChartFailureHandler = (report: ChartFailureReport) => void;
+export declare function chartError(category: ChartErrorCategory, code: ChartErrorCode, extra?: Omit<ChartError, 'category' | 'code' | 'message'>): ChartError;
+export declare function validationError(code: ChartErrorCode, extra?: Omit<ChartError, 'category' | 'code' | 'message'>): ChartError;
+export declare function isChartError(e: unknown): e is ChartError;
+/**
+ * Builds the report handed to the app after a contained render exception.
+ *
+ * A `ChartError` thrown by the package keeps its catalogue message. Anything
+ * else — a defect in the rendering library, say — is reported under the generic
+ * `renderException` message. We do **not** copy a third-party exception's own
+ * message into the report, because we cannot promise it is free of data.
+ */
+export declare function toFailureReport(family: ChartFamily, thrown: unknown, chartId?: string, componentStack?: string): ChartFailureReport;
+/**
+ * Stable identity for a failure, used to de-duplicate reports so an unrelated
+ * parent re-render does not re-report the same problem.
+ */
+export declare function failureSignature(report: ChartFailureReport): string;
+//# sourceMappingURL=errors.d.ts.map

package/lib/typescript/module/contract/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/contract/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAc,CAAC;AAE9D,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtE,MAAM,MAAM,cAAc,GACvB,mBAAmB,GACnB,kBAAkB,GAClB,sBAAsB,GACtB,+BAA+B,GAC/B,oBAAoB,GACpB,sBAAsB,GACtB,gBAAgB,GAChB,2BAA2B,GAC3B,eAAe,GACf,iBAAiB,CAAC;AAwBrB,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE;QACjB,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;QACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC;QACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;CACF;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAEvE,wBAAgB,UAAU,CACzB,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,cAAc,EACpB,KAAK,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC,GACvD,UAAU,CAOZ;AAED,wBAAgB,eAAe,CAC9B,IAAI,EAAE,cAAc,EACpB,KAAK,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC,GACvD,UAAU,CAEZ;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,UAAU,CAYxD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC9B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,GACrB,kBAAkB,CAMpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAEnE"}

package/lib/typescript/module/contract/format.d.ts

@@ -0,0 +1,63 @@
+import type { Position, Series } from './datasource.js';
+import { type ValueState } from './value.js';
+export type FormatHint = {
+    readonly kind: 'number';
+    readonly decimals?: number;
+} | {
+    readonly kind: 'percent';
+    readonly decimals?: number;
+} | {
+    readonly kind: 'currency';
+    readonly currency: string;
+} | {
+    readonly kind: 'duration';
+    readonly unit: 'ms' | 's' | 'min' | 'h';
+} | {
+    readonly kind: 'count';
+} | {
+    readonly kind: 'custom';
+    readonly unit: string;
+};
+export interface FormatContext {
+    readonly hint?: FormatHint;
+    readonly unit?: string;
+    /** Where the text will appear, so a formatter can adapt its verbosity. */
+    readonly slot: 'axis' | 'value' | 'legend' | 'summary';
+}
+export interface SeriesRef {
+    readonly id: string;
+    readonly label: string;
+}
+export interface ChartFormatters {
+    readonly axisLabel?: (v: ValueState | Position, ctx: FormatContext) => string;
+    readonly value?: (v: ValueState, ctx: FormatContext) => string;
+    readonly legendLabel?: (series: SeriesRef, ctx: FormatContext) => string;
+    readonly summary?: (v: ValueState, ctx: FormatContext) => string;
+}
+/**
+ * Placeholders for the three non-value classes. Deliberately not "0" and not
+ * an empty string, so a reader can tell a gap from a zero at a glance.
+ */
+export declare const NON_VALUE_TEXT: Readonly<Record<string, string>>;
+/**
+ * Locale-neutral default formatting (FR-057).
+ *
+ * Deliberately plain: no thousands separators, no currency symbol lookup, no
+ * month names. Anything locale-dependent belongs to the consuming app, which
+ * owns an i18n system the package does not.
+ */
+export declare function formatValueDefault(v: ValueState, ctx?: FormatContext): string;
+export declare function formatPositionDefault(p: Position): string;
+export declare function formatLegendDefault(series: SeriesRef): string;
+/**
+ * Runs an app formatter, falling back to the package default for that single
+ * label if it throws (FR-059). One bad formatter must not take down a screen.
+ *
+ * The dev-only warning is intentionally value-free: it names the slot, never
+ * the data.
+ */
+export declare function safeFormat(run: () => string, fallback: () => string, slot: FormatContext['slot'], onceKey?: string): string;
+/** Test-only reset so warning-once behaviour can be asserted repeatedly. */
+export declare function __resetFormatterWarnings(): void;
+export declare function seriesRef<M>(series: Series<M>): SeriesRef;
+//# sourceMappingURL=format.d.ts.map

package/lib/typescript/module/contract/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../src/contract/format.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAc,CAAC;AACrD,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,YAAS,CAAC;AAKnD,MAAM,MAAM,UAAU,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxD;IACA,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC;CACvC,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;CACvD;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,GAAG,QAAQ,EAAE,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC;CACjE;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI3D,CAAC;AAMF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,GAAE,aAAiC,GAAG,MAAM,CA8BhG;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAYzD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACzB,GAAG,EAAE,MAAM,MAAM,EACjB,QAAQ,EAAE,MAAM,MAAM,EACtB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,OAAO,CAAC,EAAE,MAAM,GACd,MAAM,CASR;AAuBD,4EAA4E;AAC5E,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAEzD"}