@chipmobilesdk/rn-chart 0.4.0 → 0.5.0

package/lib/typescript/module/geometry/layout.d.ts

@@ -0,0 +1,67 @@
+export interface PlotRect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface ContainerSize {
+    readonly width: number;
+    readonly height: number;
+}
+export interface LayoutOptions {
+    readonly container: ContainerSize;
+    /** Axis label text, used to reserve exactly as much space as is needed. */
+    readonly xLabels?: readonly string[];
+    readonly yLabels?: readonly string[];
+    readonly baseFontSize: number;
+    /** System text-size multiplier, from `PixelRatio.getFontScale()` (FR-071). */
+    readonly fontScale: number;
+    readonly padding?: number;
+}
+/**
+ * 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 declare const MAX_FONT_SCALE = 1.6;
+export declare function effectiveFontSize(baseFontSize: number, fontScale: number): number;
+/** A container that has not been measured yet, or has collapsed (FR-078). */
+export declare function isMeasurable(size: ContainerSize): boolean;
+export declare const EMPTY_PLOT: PlotRect;
+/**
+ * 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 declare function resolvePlotRect(options: LayoutOptions): PlotRect;
+export interface AxisLabels {
+    readonly xLabels: readonly string[];
+    readonly yLabels: readonly string[];
+    readonly fontSize: number;
+}
+/**
+ * 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 declare function insetForAxes(outer: PlotRect, labels: AxisLabels): PlotRect;
+export declare function plotBottom(plot: PlotRect): number;
+export declare function plotRight(plot: PlotRect): number;
+export declare function containsPoint(plot: PlotRect, x: number, y: number): boolean;
+//# sourceMappingURL=layout.d.ts.map

package/lib/typescript/module/geometry/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../src/geometry/layout.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGjF;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAIzD;AAED,eAAO,MAAM,UAAU,EAAE,QAA8C,CAAC;AAExE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAiChE;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,QAAQ,CA2B1E;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEjD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEhD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAE3E"}

package/lib/typescript/module/geometry/markers.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Reference markers on a value axis: thresholds, baselines and targets drawn
+ * as horizontal lines across the plot (FR-008, FR-072).
+ *
+ * Every builder used to return `markers: []`, so a threshold the app supplied
+ * reached the accessibility summary and nowhere else (CHT-03).
+ *
+ * PURE. No React, no SVG.
+ */
+import type { ReferenceMarker } from '../contract/marker.js';
+import { type PlotRect } from './layout.js';
+import type { GeometryLabel, MarkerLine } from './types.js';
+type PlacedMarker = ReferenceMarker & {
+    readonly value: {
+        kind: 'known';
+        value: number;
+    };
+};
+/** Markers that can be placed on a value axis: those with a known value. */
+export declare function placeableMarkers(markers: readonly ReferenceMarker[] | undefined): PlacedMarker[];
+/** Values the domain must include so every marker lands inside the plot. */
+export declare function markerDomainValues(markers: readonly ReferenceMarker[] | undefined): number[];
+/** One line per marker across the plot, plus its label when it has one. */
+export declare function horizontalMarkers(markers: readonly ReferenceMarker[] | undefined, plot: PlotRect, project: (value: number) => number): {
+    lines: MarkerLine[];
+    labels: GeometryLabel[];
+};
+export {};
+//# sourceMappingURL=markers.d.ts.map

package/lib/typescript/module/geometry/markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../../../src/geometry/markers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAoB,CAAC;AAE1D,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,aAAU,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAS,CAAC;AAEzD,KAAK,YAAY,GAAG,eAAe,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE3F,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GAAG,YAAY,EAAE,CAEhG;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAE5F;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,EAC/C,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAChC;IAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,MAAM,EAAE,aAAa,EAAE,CAAA;CAAE,CAuBlD"}

package/lib/typescript/module/geometry/path.d.ts

@@ -0,0 +1,66 @@
+/**
+ * SVG path-string builders.
+ *
+ * This is where the "never bridge a gap" guarantee (FR-012) becomes
+ * structural rather than a rule someone has to remember. A missing value does
+ * not produce a coordinate — it ends the current subpath. The next known value
+ * starts a fresh one with an `M` command. There is physically no line segment
+ * spanning the gap, so no amount of downstream carelessness can draw one.
+ *
+ * Batching into path data is also what keeps element counts flat: one `Path`
+ * per series regardless of point count (research.md R2).
+ *
+ * PURE. No React, no SVG imports — this module emits strings.
+ */
+export interface Pt {
+    readonly x: number;
+    readonly y: number;
+}
+/** A point that may be absent, mirroring the value contract. */
+export type MaybePt = Pt | null;
+/**
+ * Polyline through the known points, broken at every gap.
+ *
+ * `null` entries are missing values. They terminate the current subpath; they
+ * are never interpolated, carried forward, or skipped over.
+ */
+export declare function linePath(points: readonly MaybePt[]): string;
+/**
+ * Filled area between the polyline and a baseline, broken at gaps in the same
+ * way: each contiguous run of known points becomes its own closed shape.
+ */
+export declare function areaPath(points: readonly MaybePt[], baselineY: number): string;
+export interface RectSpec {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly radius?: number;
+}
+/** One rectangle as a subpath, with optional corner rounding. */
+export declare function rectSubpath(r: RectSpec): string;
+/**
+ * Many rectangles batched into one path — how bars and heatmap cells stay at
+ * one element per series or per intensity bucket.
+ */
+export declare function rectBatchPath(rects: readonly RectSpec[]): string;
+export interface ArcSpec {
+    readonly cx: number;
+    readonly cy: number;
+    readonly outerRadius: number;
+    readonly innerRadius: number;
+    /** Radians, clockwise from 12 o'clock. */
+    readonly startAngle: number;
+    readonly endAngle: number;
+}
+/**
+ * Donut or pie segment. An inner radius of 0 yields a pie wedge.
+ *
+ * A full-circle segment is drawn as two half-arcs, because SVG cannot express
+ * a 360-degree arc in a single command — start and end would coincide and
+ * nothing would be drawn.
+ */
+export declare function arcPath(spec: ArcSpec): string;
+/** Straight line, for axes, baselines, and threshold markers. */
+export declare function linearSegment(from: Pt, to: Pt): string;
+//# sourceMappingURL=path.d.ts.map

package/lib/typescript/module/geometry/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../../src/geometry/path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,EAAE;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gEAAgE;AAChE,MAAM,MAAM,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC;AAQhC;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAmB3D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA0B9E;AAED,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAmB/C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAMhE;AAED,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AASD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAiC7C;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,MAAM,CAEtD"}

package/lib/typescript/module/geometry/progress.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Progress geometry: current value against an optional target.
+ *
+ * The rule that matters (FR-021, FR-022): with no usable target there is **no
+ * proportion**. The chart shows the current value and nothing else. And a value
+ * beyond its target renders as overshoot rather than a clamped full bar that
+ * hides the excess.
+ *
+ * PURE. No React, no SVG.
+ */
+import type { ChartDatasource } from '../contract/datasource.js';
+import type { GeometryInput, ResolvedGeometry } from './types.js';
+export interface ProgressOptions {
+    readonly trackRadius?: number;
+}
+export declare function buildProgressGeometry<M>(datasource: ChartDatasource<M>, input: GeometryInput, options?: ProgressOptions): ResolvedGeometry;
+//# sourceMappingURL=progress.d.ts.map

package/lib/typescript/module/geometry/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../../src/geometry/progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAAwB,CAAC;AAM9D,OAAO,KAAK,EAAE,aAAa,EAAuC,gBAAgB,EAAE,MAAM,YAAS,CAAC;AAEpG,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAKD,wBAAgB,qBAAqB,CAAC,CAAC,EACtC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,eAAoB,GAC3B,gBAAgB,CAgMlB"}

package/lib/typescript/module/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/module/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/module/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.js';
+/**
+ * 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/module/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,YAAS,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/module/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.js';
+import type { GeometryInput, ResolvedGeometry } from './types.js';
+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/module/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,2BAAwB,CAAC;AAQtE,OAAO,KAAK,EAAE,aAAa,EAAY,gBAAgB,EAAE,MAAM,YAAS,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/module/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.js';
+import type { NonValueTexture } from '../contract/theme.js';
+import type { HitRegion } from './hitTest.js';
+import type { PlotRect } from './layout.js';
+import type { Tick } from './ticks.js';
+/** 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/module/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/module/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.js';
+export { isKnown, isWithheld, known, notApplicable, participatesInTotals, sumKnown, unknown, withheld, } from './contract/value.js';
+export type { CategoryPosition, ChartDatasource, ChartFamily, DataPoint, InstantPosition, MatrixPosition, Position, PositionKind, Series, SeriesPattern, } from './contract/datasource.js';
+export { FAMILY_POSITION_KINDS, familyAcceptsPositionKind, resolveFormat, resolveUnit, } from './contract/datasource.js';
+export type { DistributionValues } from './contract/distribution.js';
+export type { MarkerKind, ProgressReading, ReferenceMarker } from './contract/marker.js';
+export { findTarget, isUsableTarget, readProgress } from './contract/marker.js';
+export type { ChartFormatters, FormatContext, FormatHint, SeriesRef } from './contract/format.js';
+export { NON_VALUE_TEXT, formatLegendDefault, formatPositionDefault, formatValueDefault, seriesRef, } from './contract/format.js';
+export type { ChartStateContent, ChartStatus, DeclarableChartStatus, StatusInputs, } from './contract/state.js';
+export { STATUS_PRECEDENCE, drawsData, resolveStatus, suppressesInteraction, } from './contract/state.js';
+export type { ChartError, ChartErrorCategory, ChartErrorCode, ChartFailureHandler, ChartFailureReport, } from './contract/errors.js';
+export { isChartError } from './contract/errors.js';
+export type { ChartInteractionEvent, InteractionProps, PointInteractionEvent, SelectionRef, SeriesInteractionEvent, } from './contract/interaction.js';
+export { sameSelection } from './contract/interaction.js';
+export type { ChartTheme, LegendEntry, NonValueTexture, TextStyleTokens } from './contract/theme.js';
+export { defaultChartTheme, resolveSeriesColor } from './contract/theme.js';
+export type { BaseChartProps, ChartAccessibility, ValueFormatter } from './contract/props.js';
+export type { BudgetCheck, DatasetBudget } from './validation/budgets.js';
+export { DATASET_BUDGETS, checkBudget } from './validation/budgets.js';
+export type { BarChartProps, DistributionChartProps, HeatmapChartProps, ProgressChartProps, TimeSeriesChartProps, } from './react/charts.js';
+export { BarChart, DistributionChart, HeatmapChart, ProgressChart, TimeSeriesChart, } from './react/charts.js';
+export { ChartLegend, ColorScaleLegend, buildLegendEntries } from './react/ChartLegend.js';
+export type { ColorScale } from './geometry/types.js';
+export { ChartThemeProvider, useChartTheme } from './react/ChartThemeProvider.js';
+export { buildChartSummary, buildPointAnnouncement, buildTotalAnnouncement } from './a11y/summary.js';
+export { chartStrings } from './contract/strings.js';
+export type { ChartStringKey, ChartStrings } from './contract/strings.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/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/module/package.json

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

package/lib/typescript/module/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.js';
+import { type ChartError, type ChartFailureHandler } from '../contract/errors.js';
+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/module/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,2BAAwB,CAAC;AAC1D,OAAO,EAIN,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,MAAM,uBAAoB,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/module/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.js';
+import type { DistributionValues } from '../contract/distribution.js';
+import type { BaseChartProps } from '../contract/props.js';
+import type { GeometryInput, ResolvedGeometry } from '../geometry/types.js';
+import { type ChartAxes } from './ChartPlot.js';
+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/module/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,2BAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAmB,CAAC;AAKxD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAmB,CAAC;AAKzE,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,gBAAa,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/module/react/ChartLegend.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import type { ChartDatasource, ChartFamily } from '../contract/datasource.js';
+import type { SeriesRef } from '../contract/format.js';
+import { type ChartStrings } from '../contract/strings.js';
+import { type ChartTheme, type LegendEntry } from '../contract/theme.js';
+import type { ColorScale } from '../geometry/types.js';
+/**
+ * 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/module/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,2BAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAoB,CAAC;AACpD,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,wBAAqB,CAAC;AACtE,OAAO,EAIN,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,MAAM,sBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAmB,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"}