@chipmobilesdk/rn-chart 0.4.0 → 0.5.0

package/lib/typescript/commonjs/geometry/scale.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Scales: domain values to pixel positions.
+ *
+ * PURE. No React, no SVG — enforced by the ESLint override in `.eslintrc.js`
+ * and by geometryPurity.test.ts.
+ */
+export interface Range {
+    readonly min: number;
+    readonly max: number;
+}
+export interface LinearScale {
+    readonly domain: Range;
+    readonly rangePx: Range;
+    readonly project: (value: number) => number;
+    readonly invert: (px: number) => number;
+}
+/**
+ * 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 declare function widenDegenerateDomain(domain: Range): Range;
+export declare function linearScale(domain: Range, rangePx: Range): LinearScale;
+export interface BandScale {
+    readonly categories: readonly string[];
+    readonly bandWidth: number;
+    readonly step: number;
+    readonly project: (category: string) => number | undefined;
+    readonly centerOf: (category: string) => number | undefined;
+    readonly invert: (px: number) => string | undefined;
+}
+/**
+ * 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 declare function bandScale(categories: readonly string[], rangePx: Range, padding?: number): BandScale;
+/**
+ * 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 declare function timeScale(domain: Range, rangePx: Range): LinearScale;
+/**
+ * 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 declare function domainFrom(values: readonly number[], options?: {
+    includeZero?: boolean;
+    padFraction?: number;
+}): Range;
+//# sourceMappingURL=scale.d.ts.map

package/lib/typescript/commonjs/geometry/scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale.d.ts","sourceRoot":"","sources":["../../../../src/geometry/scale.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,KAAK;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,CAS1D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,GAAG,WAAW,CAWtE;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACpD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,SAAM,GAAG,SAAS,CAiCjG;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,GAAG,WAAW,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACzB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3D,KAAK,CAuBP"}

package/lib/typescript/commonjs/geometry/ticks.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Tick generation and label thinning (FR-070).
+ *
+ * React Native offers no synchronous text measurement, and an `onLayout`
+ * round-trip per label would cost a second layout pass — enough to breach the
+ * first-paint budget. So we estimate width from character count and thin ticks
+ * to fit.
+ *
+ * The estimate is deliberately generous: over-estimating drops one tick too
+ * many, which is legible. Under-estimating produces overlapping text, which is
+ * the failure FR-070 exists to prevent. See research.md R6.
+ *
+ * PURE. No React, no SVG.
+ */
+import type { Range } from './scale';
+/**
+ * Average glyph advance as a fraction of font size, for the Latin digits and
+ * letters that dominate axis labels. Rounded up from the ~0.5-0.55 typical of
+ * the platform sans-serif faces.
+ */
+export declare const AVERAGE_ADVANCE_RATIO = 0.62;
+/** Minimum breathing room between two adjacent labels, in px. */
+export declare const LABEL_GUTTER = 8;
+export declare function estimateTextWidth(text: string, fontSize: number): number;
+export interface Tick {
+    /** Domain value this tick represents. */
+    readonly value: number;
+    /** Pixel position along the axis. */
+    readonly position: number;
+    readonly label: string;
+}
+export declare function niceTickValues(domain: Range, targetCount: number): number[];
+/**
+ * Drops ticks until no two labels can overlap.
+ *
+ * Thinning is preferred over rotation as the default: rotated labels are harder
+ * to read on a phone and cost vertical space a mobile chart cannot spare.
+ * Rotation stays available as an opt-in for dense category axes.
+ *
+ * The first tick is always kept, so an axis never renders empty.
+ */
+export declare function thinTicks(ticks: readonly Tick[], fontSize: number, axisLengthPx: number): Tick[];
+/**
+ * How much space an axis must reserve for its labels, at the current system
+ * font scale (FR-071).
+ */
+export declare function reserveAxisSpace(labels: readonly string[], fontSize: number, orientation: 'horizontal' | 'vertical'): number;
+//# sourceMappingURL=ticks.d.ts.map

package/lib/typescript/commonjs/geometry/ticks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticks.d.ts","sourceRoot":"","sources":["../../../../src/geometry/ticks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,iEAAiE;AACjE,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,MAAM,WAAW,IAAI;IACpB,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAyBD,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAiB3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,EAAE,CAkBhG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,YAAY,GAAG,UAAU,GACpC,MAAM,CAcR"}

package/lib/typescript/commonjs/geometry/timeSeries.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Time-series geometry: one stroked path per series over an instant domain.
+ *
+ * Gaps are the interesting part. A non-known value contributes `null` to the
+ * point list, `linePath` lifts the pen there, and the line simply does not
+ * exist across the gap (FR-012).
+ *
+ * PURE. No React, no SVG.
+ */
+import type { ChartDatasource } from '../contract/datasource';
+import type { GeometryInput, ResolvedGeometry } from './types';
+export interface TimeSeriesOptions {
+    /** Window supplied by the app. Users cannot draw one (pan/zoom out of scope). */
+    readonly range?: {
+        readonly from: number;
+        readonly to: number;
+    };
+}
+export declare function buildTimeSeriesGeometry<M>(datasource: ChartDatasource<M>, input: GeometryInput, options?: TimeSeriesOptions): ResolvedGeometry;
+//# sourceMappingURL=timeSeries.d.ts.map

package/lib/typescript/commonjs/geometry/timeSeries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeSeries.d.ts","sourceRoot":"","sources":["../../../../src/geometry/timeSeries.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,eAAe,EAAU,MAAM,wBAAwB,CAAC;AAQtE,OAAO,KAAK,EAAE,aAAa,EAAY,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IACjC,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AAqBD,wBAAgB,uBAAuB,CAAC,CAAC,EACxC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,iBAAsB,GAC7B,gBAAgB,CA6HlB"}

package/lib/typescript/commonjs/geometry/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * The single memoized artefact each chart produces.
+ *
+ * `ResolvedGeometry` is keyed on datasource identity, plot rectangle, theme
+ * identity, and formatter identity — and deliberately **not** on selection.
+ * Highlighting a point must repaint the highlight, not recompute every scale
+ * and path string (research.md R3, FR-073).
+ *
+ * PURE. No React, no SVG.
+ */
+import type { SeriesPattern } from '../contract/datasource';
+import type { NonValueTexture } from '../contract/theme';
+import type { HitRegion } from './hitTest';
+import type { PlotRect } from './layout';
+import type { Tick } from './ticks';
+/** One drawable group. Element count scales with these, never with points. */
+export interface MarkPath {
+    readonly key: string;
+    readonly seriesId: string;
+    readonly d: string;
+    readonly color: string;
+    readonly pattern: SeriesPattern;
+    /** Filled shapes (bars, arcs, cells) versus stroked ones (lines). */
+    readonly filled: boolean;
+    /** Set on marks standing in for a non-value class: texture, not hue. */
+    readonly texture?: NonValueTexture;
+    readonly opacity?: number;
+}
+/** A target, baseline, or threshold drawn across the plot. */
+export interface MarkerLine {
+    readonly id: string;
+    readonly d: string;
+    readonly label?: string;
+    readonly kind: 'target' | 'baseline' | 'threshold';
+}
+/** Text the chart draws itself, such as progress values or segment labels. */
+export interface GeometryLabel {
+    readonly key: string;
+    readonly text: string;
+    readonly x: number;
+    readonly y: number;
+    readonly anchor: 'start' | 'middle' | 'end';
+    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[];
+    readonly markers: readonly MarkerLine[];
+    readonly labels: readonly GeometryLabel[];
+    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).
+     */
+    readonly incomplete: boolean;
+}
+export declare const EMPTY_GEOMETRY: ResolvedGeometry;
+/** Inputs every family geometry builder needs. */
+export interface GeometryInput {
+    readonly plot: PlotRect;
+    readonly fontSize: number;
+    /** Resolved per series, so geometry never reaches into the theme itself. */
+    readonly seriesColors: Readonly<Record<string, string>>;
+    /**
+     * Distribution segment colours keyed by `segmentKey(seriesId, pointId)`.
+     * Only resolved for the distribution family. Point colours used to share
+     * `seriesColors`, so a point id equal to a series id overwrote that series.
+     */
+    readonly segmentColors?: Readonly<Record<string, string>>;
+    readonly nonValueTextures: Readonly<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;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/commonjs/geometry/types.d.ts.map

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

package/lib/typescript/commonjs/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @chipmobilesdk/rn-chart — domain-agnostic charting for ChipMobileSdk-family
+ * React Native apps.
+ *
+ * This is the single public entrypoint (LIB-003). Modules under `geometry/`,
+ * `render/`, `validation/`, and the internals of `react/` are private; import
+ * them only through this file. Keeping them private is what lets the geometry,
+ * the layout maths, and the rendering substrate change without a breaking
+ * release.
+ *
+ * The package makes no network request, calls no AI service, reads no
+ * database, persists nothing, and logs no data value or series label. It
+ * renders numeric data and app-supplied labels — nothing else.
+ *
+ * There is deliberately **no insight, message, or narrative surface**: apps
+ * render their own text around a chart, and a chart imposes no outer margin
+ * that would fight that layout.
+ */
+export type { KnownValue, NotApplicableValue, TotalResult, UnknownValue, ValueKind, ValueState, WithheldValue, } from './contract/value';
+export { isKnown, isWithheld, known, notApplicable, participatesInTotals, sumKnown, unknown, withheld, } from './contract/value';
+export type { CategoryPosition, ChartDatasource, ChartFamily, DataPoint, InstantPosition, MatrixPosition, Position, PositionKind, Series, SeriesPattern, } from './contract/datasource';
+export { FAMILY_POSITION_KINDS, familyAcceptsPositionKind, resolveFormat, 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';
+export type { ChartFormatters, FormatContext, FormatHint, SeriesRef } from './contract/format';
+export { NON_VALUE_TEXT, formatLegendDefault, formatPositionDefault, formatValueDefault, seriesRef, } from './contract/format';
+export type { ChartStateContent, ChartStatus, DeclarableChartStatus, StatusInputs, } from './contract/state';
+export { STATUS_PRECEDENCE, drawsData, resolveStatus, suppressesInteraction, } from './contract/state';
+export type { ChartError, ChartErrorCategory, ChartErrorCode, ChartFailureHandler, ChartFailureReport, } from './contract/errors';
+export { isChartError } from './contract/errors';
+export type { ChartInteractionEvent, InteractionProps, PointInteractionEvent, SelectionRef, SeriesInteractionEvent, } from './contract/interaction';
+export { sameSelection } from './contract/interaction';
+export type { ChartTheme, LegendEntry, NonValueTexture, TextStyleTokens } from './contract/theme';
+export { defaultChartTheme, resolveSeriesColor } from './contract/theme';
+export type { BaseChartProps, ChartAccessibility, ValueFormatter } from './contract/props';
+export type { BudgetCheck, DatasetBudget } from './validation/budgets';
+export { DATASET_BUDGETS, checkBudget } from './validation/budgets';
+export type { BarChartProps, DistributionChartProps, HeatmapChartProps, ProgressChartProps, TimeSeriesChartProps, } from './react/charts';
+export { BarChart, DistributionChart, HeatmapChart, ProgressChart, TimeSeriesChart, } from './react/charts';
+export { ChartLegend, ColorScaleLegend, buildLegendEntries } from './react/ChartLegend';
+export type { ColorScale } from './geometry/types';
+export { ChartThemeProvider, useChartTheme } from './react/ChartThemeProvider';
+export { buildChartSummary, buildPointAnnouncement, buildTotalAnnouncement } from './a11y/summary';
+export { chartStrings } from './contract/strings';
+export type { ChartStringKey, ChartStrings } from './contract/strings';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/index.d.ts.map

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

package/lib/typescript/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

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

@@ -0,0 +1,47 @@
+/**
+ * Per-chart render-failure containment (FR-038a, FR-038b).
+ *
+ * React 19 still has no hook equivalent of an error boundary —
+ * `getDerivedStateFromError` and `componentDidCatch` remain class-only — so
+ * this is a class. Forty lines beats adding a dependency for it.
+ *
+ * Three behaviours are deliberate:
+ *
+ *  - **Reset only on a real change.** The boundary clears its error when the
+ *    datasource identity or chart key changes, never on an unrelated parent
+ *    re-render. A deterministic geometry defect therefore cannot pin the CPU in
+ *    a render-fail-render loop.
+ *  - **Report once per distinct failure.** De-duplicated by signature, so a
+ *    chart re-rendered by a sibling's state change does not re-report.
+ *  - **Redact.** The report carries the chart identity and a catalogue message.
+ *    A third-party exception's own text is never copied in, because we cannot
+ *    promise it is free of data (POL-011).
+ */
+import React from 'react';
+import type { ChartFamily } from '../contract/datasource';
+import { type ChartError, type ChartFailureHandler } from '../contract/errors';
+interface Props {
+    readonly family: ChartFamily;
+    readonly chartId?: string;
+    readonly onFailure?: ChartFailureHandler;
+    /** Changing this clears a contained failure. */
+    readonly resetKey: unknown;
+    readonly renderFallback: (error: ChartError) => React.ReactNode;
+    readonly children: React.ReactNode;
+}
+interface State {
+    readonly error?: ChartError;
+    readonly resetKey: unknown;
+    readonly reportedSignature?: string;
+}
+export declare class ChartBoundary extends React.Component<Props, State> {
+    constructor(props: Props);
+    static getDerivedStateFromProps(props: Props, state: State): State | null;
+    static getDerivedStateFromError(): Partial<State>;
+    componentDidCatch(error: unknown, info: {
+        componentStack?: string;
+    }): void;
+    render(): React.ReactNode;
+}
+export {};
+//# sourceMappingURL=ChartBoundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChartBoundary.d.ts","sourceRoot":"","sources":["../../../../src/react/ChartBoundary.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAIN,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,UAAU,KAAK;IACd,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IACzC,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;IAChE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CACnC;AAED,UAAU,KAAK;IACd,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,qBAAa,aAAc,SAAQ,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;gBACnD,KAAK,EAAE,KAAK;IAKxB,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI;IAQzE,MAAM,CAAC,wBAAwB,IAAI,OAAO,CAAC,KAAK,CAAC;IAWxC,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAkB1E,MAAM,IAAI,KAAK,CAAC,SAAS;CAMlC"}

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

@@ -0,0 +1,31 @@
+/**
+ * The shared chart shell.
+ *
+ * Every family routes through here, so validation, status resolution, budget
+ * checks, theming, layout, selection, accessibility, and failure containment
+ * are written once and behave identically across all five. The pieces live in
+ * their own hooks and components; this file is the order they run in.
+ *
+ * Layout note (FR-039): the frame imposes **no outer margin**. Insight text is
+ * out of scope for this package, so apps render their own text directly above
+ * or below a chart and must not have to fight a margin they cannot control.
+ */
+import React from 'react';
+import type { ChartDatasource, ChartFamily } from '../contract/datasource';
+import type { DistributionValues } from '../contract/distribution';
+import type { BaseChartProps } from '../contract/props';
+import type { GeometryInput, ResolvedGeometry } from '../geometry/types';
+import { type ChartAxes } from './ChartPlot';
+export interface ChartFrameProps<M> extends BaseChartProps<M> {
+    readonly family: ChartFamily;
+    readonly buildGeometry: (datasource: ChartDatasource<M>, input: GeometryInput) => ResolvedGeometry;
+    /** Time-series selection tracks the x axis; other families use proximity. */
+    readonly hitTestMode?: 'nearest' | 'byX';
+    /** `full` by default: axis lines, grid and tick labels. */
+    readonly axes?: ChartAxes;
+    readonly defaultLegend?: boolean;
+    /** What a distribution's values mean, when the app says. */
+    readonly distributionValues?: DistributionValues;
+}
+export declare function ChartFrame<M>(props: ChartFrameProps<M>): React.JSX.Element;
+//# sourceMappingURL=ChartFrame.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChartFrame.d.ts","sourceRoot":"","sources":["../../../../src/react/ChartFrame.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAyB,MAAM,OAAO,CAAC;AAI9C,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKxD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAKzE,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAUxD,MAAM,WAAW,eAAe,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,CACvB,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,KAAK,EAAE,aAAa,KAChB,gBAAgB,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,4DAA4D;IAC5D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACjD;AAID,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,qBAiRtD"}

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

@@ -0,0 +1,31 @@
+import React from 'react';
+import type { ChartDatasource, ChartFamily } from '../contract/datasource';
+import type { SeriesRef } from '../contract/format';
+import { type ChartStrings } from '../contract/strings';
+import { type ChartTheme, type LegendEntry } from '../contract/theme';
+import type { ColorScale } from '../geometry/types';
+/**
+ * Legend model. A distribution chart gets one entry per segment, in the colour
+ * its arc is drawn in; it used to get one per series, so a one-series donut of
+ * four segments showed a single entry (CHT-02).
+ */
+export declare function buildLegendEntries<M>(datasource: ChartDatasource<M>, theme: ChartTheme, hidden: ReadonlySet<string>, toggleable: boolean, family?: ChartFamily, 
+/** The app's `legendLabel` formatter, when it has one. */
+formatLabel?: (series: SeriesRef) => string): LegendEntry[];
+export declare function ChartLegend({ entries, theme, onToggle, strings, }: {
+    readonly entries: readonly LegendEntry[];
+    readonly theme: ChartTheme;
+    readonly onToggle?: (seriesId: string) => void;
+    readonly strings?: ChartStrings;
+}): React.JSX.Element | null;
+/**
+ * The key to a colour ramp: its lowest and highest value around the colours
+ * between them. Without it a heatmap's shades meant nothing (CHT-15).
+ */
+export declare function ColorScaleLegend({ scale, theme, formatValue, strings, }: {
+    readonly scale: ColorScale;
+    readonly theme: ChartTheme;
+    readonly formatValue: (value: number) => string;
+    readonly strings?: ChartStrings;
+}): React.JSX.Element;
+//# sourceMappingURL=ChartLegend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChartLegend.d.ts","sourceRoot":"","sources":["../../../../src/react/ChartLegend.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAIN,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EACnC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAC3B,UAAU,EAAE,OAAO,EACnB,MAAM,CAAC,EAAE,WAAW;AACpB,0DAA0D;AAC1D,WAAW,GAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAA+B,GACjE,WAAW,EAAE,CA+Bf;AAkDD,wBAAgB,WAAW,CAAC,EAC3B,OAAO,EACP,KAAK,EACL,QAAQ,EACR,OAA+B,GAC/B,EAAE;IACF,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CAChC,4BAoDA;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAChC,KAAK,EACL,KAAK,EACL,WAAW,EACX,OAA+B,GAC/B,EAAE;IACF,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CAChC,qBAuBA"}

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

@@ -0,0 +1,19 @@
+/**
+ * Everything the chart draws from its geometry.
+ *
+ * Memoized on the geometry: selecting a point re-renders the frame and moves
+ * the highlight, and this subtree — the long path strings — is skipped
+ * (CHT-08). It used to be reconciled again on every tap.
+ */
+import React from 'react';
+import type { ChartTheme } from '../contract/theme';
+import type { ResolvedGeometry } from '../geometry/types';
+/** `labels` names rows and columns without drawing axis lines or a grid. */
+export type ChartAxes = 'full' | 'labels' | 'none';
+export declare const ChartPlot: React.NamedExoticComponent<{
+    readonly geometry: ResolvedGeometry;
+    readonly theme: ChartTheme;
+    readonly fontSize: number;
+    readonly axes: ChartAxes;
+}>;
+//# sourceMappingURL=ChartPlot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChartPlot.d.ts","sourceRoot":"","sources":["../../../../src/react/ChartPlot.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnD,eAAO,MAAM,SAAS;uBAMF,gBAAgB;oBACnB,UAAU;uBACP,MAAM;mBACV,SAAS;EA8BvB,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * What a chart shows in place of data: the app's own content for the state,
+ * or a terse built-in line. Apps are expected to supply their own copy — the
+ * package must not impose product voice.
+ */
+import React from 'react';
+import type { ChartError } from '../contract/errors';
+import type { ChartStatus } from '../contract/state';
+import type { ChartStrings } from '../contract/strings';
+import type { ChartTheme } from '../contract/theme';
+export declare function ChartStateOverlay({ status, supplied, strings, theme, error, }: {
+    readonly status: ChartStatus;
+    /** The app's content for this state, when it gave any. */
+    readonly supplied?: React.ReactNode;
+    readonly strings: ChartStrings;
+    readonly theme: ChartTheme;
+    readonly error?: ChartError;
+}): React.JSX.Element | null;
+/** The message a contained render failure shows where the plot was. */
+export declare function ChartFailureOverlay({ supplied, theme, error, }: {
+    readonly supplied?: React.ReactNode;
+    readonly theme: ChartTheme;
+    readonly error: ChartError;
+}): React.JSX.Element;
+//# sourceMappingURL=ChartStateOverlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChartStateOverlay.d.ts","sourceRoot":"","sources":["../../../../src/react/ChartStateOverlay.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAqBpD,wBAAgB,iBAAiB,CAAC,EACjC,MAAM,EACN,QAAQ,EACR,OAAO,EACP,KAAK,EACL,KAAK,GACL,EAAE;IACF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;CAC5B,4BAeA;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,EACnC,QAAQ,EACR,KAAK,EACL,KAAK,GACL,EAAE;IACF,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC3B,qBAUA"}

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

@@ -0,0 +1,21 @@
+/**
+ * Theme resolution: prop -> context -> built-in default keyed on the OS scheme.
+ *
+ * The dependency is inverted on purpose. The package declares a `ChartTheme`
+ * value type and any design system can satisfy it, which is what keeps
+ * `@chipmobilesdk/rn-theme` and `react-native-unistyles` out of this package
+ * entirely (FR-065, LIB-004).
+ */
+import React from 'react';
+import { type ChartTheme } from '../contract/theme';
+export declare function ChartThemeProvider({ theme, children, }: {
+    readonly theme: ChartTheme;
+    readonly children: React.ReactNode;
+}): React.JSX.Element;
+/**
+ * An explicit prop wins, then context, then the built-in default for the
+ * current OS colour scheme — so a chart renders correctly with no theme
+ * configuration at all.
+ */
+export declare function useChartTheme(explicit?: ChartTheme): ChartTheme;
+//# sourceMappingURL=ChartThemeProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChartThemeProvider.d.ts","sourceRoot":"","sources":["../../../../src/react/ChartThemeProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAA6C,MAAM,OAAO,CAAC;AAGlE,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIvE,wBAAgB,kBAAkB,CAAC,EAClC,KAAK,EACL,QAAQ,GACR,EAAE;IACF,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CACnC,qBAEA;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,UAAU,CAa/D"}

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

@@ -0,0 +1,51 @@
+/**
+ * The five chart family components.
+ *
+ * Each is a thin wrapper over `ChartFrame` plus its own geometry builder, so
+ * validation, state handling, theming, selection, accessibility, and failure
+ * containment behave identically across every family.
+ *
+ * All five are wrapped in `React.memo`: value-identical props stop at the memo
+ * boundary and never reach geometry (FR-073, SC-017).
+ */
+import React from 'react';
+import type { DistributionValues } from '../contract/distribution';
+import type { BaseChartProps } from '../contract/props';
+import { type BarGrouping } from '../geometry/bar';
+import { type DistributionShape } from '../geometry/distribution';
+export type ProgressChartProps<M = unknown> = BaseChartProps<M>;
+export interface DistributionChartProps<M = unknown> extends BaseChartProps<M> {
+    readonly shape?: DistributionShape;
+    readonly innerRadiusRatio?: number;
+    /**
+     * What the values mean. `proportions`: shares of a whole in 0..1, drawn short
+     * and marked incomplete when they do not reach 1. `absolute`: counts or
+     * amounts, normalised by their total. Inferred from the data when omitted;
+     * say it when small counts (1 and 1) could be read as shares.
+     */
+    readonly valuesAre?: DistributionValues;
+}
+export interface TimeSeriesChartProps<M = unknown> extends BaseChartProps<M> {
+    /** A window the app supplies. Users cannot pan or zoom (out of scope). */
+    readonly range?: {
+        readonly from: number;
+        readonly to: number;
+    };
+}
+export interface BarChartProps<M = unknown> extends BaseChartProps<M> {
+    readonly grouping?: BarGrouping;
+}
+export interface HeatmapChartProps<M = unknown> extends BaseChartProps<M> {
+    readonly buckets?: number;
+}
+/**
+ * `React.memo` erases the generic parameter, so each component is re-cast to a
+ * generic function type. This keeps `<BarChart<MyMeta> ... />` working for
+ * consumers while still getting the memo boundary.
+ */
+export declare const ProgressChart: <M = unknown>(props: ProgressChartProps<M>) => React.ReactElement;
+export declare const DistributionChart: <M = unknown>(props: DistributionChartProps<M>) => React.ReactElement;
+export declare const TimeSeriesChart: <M = unknown>(props: TimeSeriesChartProps<M>) => React.ReactElement;
+export declare const BarChart: <M = unknown>(props: BarChartProps<M>) => React.ReactElement;
+export declare const HeatmapChart: <M = unknown>(props: HeatmapChartProps<M>) => React.ReactElement;
+//# sourceMappingURL=charts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"charts.d.ts","sourceRoot":"","sources":["../../../../src/react/charts.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAsB,MAAM,OAAO,CAAC;AAG3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAO7F,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC;AAmBhE,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;CACxC;AAyBD,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAC3E,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AA4BD,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;CAChC;AAYD,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC1B;AAqBD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAoC,CAAC,CAAC,GAAG,OAAO,EACzE,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,KACxB,KAAK,CAAC,YAAY,CAAC;AAExB,eAAO,MAAM,iBAAiB,EAAwC,CAAC,CAAC,GAAG,OAAO,EACjF,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAC5B,KAAK,CAAC,YAAY,CAAC;AAExB,eAAO,MAAM,eAAe,EAAsC,CAAC,CAAC,GAAG,OAAO,EAC7E,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAC1B,KAAK,CAAC,YAAY,CAAC;AAExB,eAAO,MAAM,QAAQ,EAA+B,CAAC,CAAC,GAAG,OAAO,EAC/D,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,KACnB,KAAK,CAAC,YAAY,CAAC;AAExB,eAAO,MAAM,YAAY,EAAmC,CAAC,CAAC,GAAG,OAAO,EACvE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,KACvB,KAAK,CAAC,YAAY,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * The event a selected point is reported with. One place builds it, for a tap
+ * and for a screen-reader step alike.
+ */
+import type { ChartDatasource, DataPoint, Series } from '../contract/datasource';
+import type { PointInteractionEvent } from '../contract/interaction';
+export interface ResolvedPoint<M> {
+    readonly series: Series<M>;
+    readonly point: DataPoint<M>;
+}
+export declare function findPoint<M>(datasource: ChartDatasource<M>, seriesId: string, pointId: string | undefined): ResolvedPoint<M> | undefined;
+export declare function pointEventFor<M>(datasource: ChartDatasource<M>, seriesId: string, pointId: string): PointInteractionEvent<M> | undefined;
+//# sourceMappingURL=pointEvent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pointEvent.d.ts","sourceRoot":"","sources":["../../../../src/react/pointEvent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;CAC7B;AAED,wBAAgB,SAAS,CAAC,CAAC,EAC1B,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,SAAS,GACzB,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAI9B;AAED,wBAAgB,aAAa,CAAC,CAAC,EAC9B,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACb,qBAAqB,CAAC,CAAC,CAAC,GAAG,SAAS,CAatC"}

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

@@ -0,0 +1,37 @@
+import type { ChartDatasource, ChartFamily } from '../contract/datasource';
+import type { ChartAccessibility } from '../contract/props';
+import type { ChartStatus } from '../contract/state';
+import type { ChartStrings } from '../contract/strings';
+import type { HitRegion } from '../geometry/hitTest';
+import type { ResolvedFormatters } from './useChartFormatters';
+import type { ChartSelectionApi } from './useChartSelection';
+export interface UseChartA11yArgs<M> {
+    readonly datasource: ChartDatasource<M>;
+    readonly family: ChartFamily;
+    readonly status: ChartStatus;
+    readonly title?: string;
+    readonly accessibility?: ChartAccessibility<M>;
+    readonly interactive: boolean;
+    readonly incomplete: boolean;
+    readonly hitRegions: readonly HitRegion[];
+    readonly selection: ChartSelectionApi<M>;
+    readonly formatters: ResolvedFormatters;
+    readonly strings: ChartStrings;
+}
+export interface ChartA11y {
+    readonly summary: string;
+    readonly value: {
+        readonly text: string;
+    } | undefined;
+    readonly actions: readonly {
+        readonly name: string;
+        readonly label: string;
+    }[] | undefined;
+    readonly onAction: ((event: {
+        nativeEvent: {
+            actionName: string;
+        };
+    }) => void) | undefined;
+}
+export declare function useChartA11y<M>(args: UseChartA11yArgs<M>): ChartA11y;
+//# sourceMappingURL=useChartA11y.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useChartA11y.d.ts","sourceRoot":"","sources":["../../../../src/react/useChartA11y.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAClC,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,aAAa,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,SAAS,CAAC;IAC3F,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC1F;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,SAAS,CA0EpE"}