@chipmobilesdk/rn-chart 0.4.0 → 0.5.0

package/lib/typescript/commonjs/contract/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../src/contract/props.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC9C,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC;IAC3F,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IACvE;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAExC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAE1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAEzC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,GAAG,QAAQ,CAAA;KAAE,CAAC;IAEpE,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzC,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,CAAC"}

package/lib/typescript/commonjs/contract/state.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Chart status contract (FR-029 to FR-038).
+ *
+ * Ownership is split on a simple principle: the package derives what only the
+ * data can determine, and the app declares what only the app can know.
+ *
+ *   empty, partial     -> derived from the datasource
+ *   loading, stale,    -> declared by the app: it alone knows about its own
+ *   noPermission,         fetches, cache age, access rules, and failures
+ *   error
+ */
+import type { ReactNode } from 'react';
+import type { ChartError } from './errors';
+export type ChartStatus = 'loading' | 'empty' | 'ready' | 'error' | 'stale' | 'noPermission' | 'partial';
+/** The statuses an app may declare. `empty` and `partial` are derived. */
+export type DeclarableChartStatus = Exclude<ChartStatus, 'empty' | 'partial'>;
+/**
+ * Resolution precedence, highest first.
+ *
+ * `noPermission` outranks everything so restricted values can never slip
+ * through some other state. `stale` and `partial` sit below the blocking
+ * states because they are modifiers on a chart that still draws its data.
+ */
+export declare const STATUS_PRECEDENCE: readonly ChartStatus[];
+export interface StatusInputs {
+    /** What the app declared, if anything. */
+    readonly declared?: DeclarableChartStatus;
+    /** True when the datasource carries no points at all. */
+    readonly isEmpty: boolean;
+    /** True when some points are valid and others are unknown/n-a/withheld. */
+    readonly isPartial: boolean;
+    /** A validation failure or a contained render exception. */
+    readonly error?: ChartError;
+}
+export declare function resolveStatus(inputs: StatusInputs): ChartStatus;
+/** Statuses in which the chart draws its data (possibly with an indicator). */
+export declare function drawsData(status: ChartStatus): boolean;
+/**
+ * Statuses in which no data-selection callback may fire, because the chart is
+ * not displaying the values a callback would carry (FR-053).
+ */
+export declare function suppressesInteraction(status: ChartStatus): boolean;
+/** Per-status content the app supplies, replacing any package wording (FR-035). */
+export type ChartStateContent = Partial<Record<ChartStatus, ReactNode>>;
+//# sourceMappingURL=state.d.ts.map

package/lib/typescript/commonjs/contract/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/contract/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,MAAM,WAAW,GACtB,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,cAAc,GAAG,SAAS,CAAC;AAEhF,0EAA0E;AAC1E,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;AAE9E;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,WAAW,EAQnD,CAAC;AAEF,MAAM,WAAW,YAAY;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAC1C,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAsB/D;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAEtD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAElE;AAED,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC"}

package/lib/typescript/commonjs/contract/strings.d.ts

@@ -0,0 +1,39 @@
+export declare const chartStrings: import("@chipmobilesdk/rn-core").MessageSet<{
+    'chart.family.progress': string;
+    'chart.family.distribution': string;
+    'chart.family.timeSeries': string;
+    'chart.family.bar': string;
+    'chart.family.heatmap': string;
+    'chart.status.loading': string;
+    'chart.status.empty': string;
+    'chart.status.error': string;
+    'chart.status.stale': string;
+    'chart.status.noPermission': string;
+    'chart.status.partial': string;
+    'chart.summary.heading': string;
+    'chart.summary.headingUntitled': string;
+    'chart.summary.scale': string;
+    'chart.summary.scaleSingle': string;
+    'chart.summary.single': string;
+    'chart.summary.extremes': string;
+    'chart.summary.marker': string;
+    'chart.summary.incomplete': string;
+    'chart.point.withheld': string;
+    'chart.point.noData': string;
+    'chart.point.value': string;
+    'chart.total': string;
+    'chart.total.incomplete': string;
+    'chart.action.next': string;
+    'chart.action.previous': string;
+    'chart.state.loading': string;
+    'chart.state.empty': string;
+    'chart.state.error': string;
+    'chart.state.noPermission': string;
+    'chart.legend.hide': string;
+    'chart.legend.show': string;
+    'chart.legend.scale': string;
+    'chart.note.incomplete': string;
+}, Record<never, string>>;
+export type ChartStrings = typeof chartStrings.defaults;
+export type ChartStringKey = keyof ChartStrings;
+//# sourceMappingURL=strings.d.ts.map

package/lib/typescript/commonjs/contract/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../../../src/contract/strings.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAqCvB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,QAAQ,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC"}

package/lib/typescript/commonjs/contract/theme.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Theme contract (FR-060 to FR-065).
+ *
+ * A plain value type rather than a dependency. The package declares what it
+ * needs and any design system can satisfy it — which is what keeps
+ * `@chipmobilesdk/rn-theme` and `react-native-unistyles` out of this package's
+ * dependency list entirely. The demo app owns the mapping adapter.
+ *
+ * Non-colour encodings are first-class here, because meaning must never ride on
+ * hue alone (FR-064).
+ */
+import type { ValueKind } from './value';
+export interface TextStyleTokens {
+    readonly fontSize: number;
+    readonly fontWeight?: '400' | '500' | '600' | '700';
+    readonly color: string;
+    readonly letterSpacing?: number;
+}
+/** How the three non-value classes are drawn: texture, never a hue difference. */
+export type NonValueTexture = 'gap' | 'hatch' | 'lockedHatch';
+export interface ChartTheme {
+    readonly colorScheme: 'light' | 'dark';
+    /** Categorical fallback, at least 8 entries, distinguishable in greyscale. */
+    readonly palette: readonly string[];
+    readonly surface: string;
+    readonly onSurface: string;
+    readonly axis: string;
+    readonly grid: string;
+    readonly muted: string;
+    readonly typography: {
+        readonly axisLabel: TextStyleTokens;
+        readonly legendLabel: TextStyleTokens;
+        readonly valueLabel: TextStyleTokens;
+    };
+    readonly spacing: {
+        readonly xs: number;
+        readonly sm: number;
+        readonly md: number;
+    };
+    readonly radius: {
+        readonly bar: number;
+        readonly cell: number;
+    };
+    readonly nonValue: Readonly<Record<Exclude<ValueKind, 'known'>, NonValueTexture>>;
+    /** Ramp for heatmap intensity, low to high. */
+    readonly heatmapRamp: readonly string[];
+}
+export interface LegendEntry {
+    readonly seriesId: string;
+    /** Set on distribution entries, which describe one segment rather than a series. */
+    readonly pointId?: string;
+    readonly label: string;
+    readonly color: string;
+    readonly pattern: 'solid' | 'dashed' | 'dotted' | 'dashDot';
+    readonly visible: boolean;
+    readonly toggleable: boolean;
+}
+export declare function defaultChartTheme(colorScheme?: 'light' | 'dark'): ChartTheme;
+/**
+ * Assigns a colour to a series: explicit override wins, otherwise the palette
+ * cycles by index so the remaining series stay distinguishable (FR-062, FR-063).
+ */
+export declare function resolveSeriesColor(theme: ChartTheme, index: number, override?: string): string;
+/** Key of one distribution segment: point ids are only unique within a series. */
+export declare function segmentKey(seriesId: string, pointId: string): string;
+/**
+ * Colours for distribution segments, keyed by `segmentKey`. The single source
+ * for both the arcs and the legend, so the two cannot disagree (CHT-02).
+ *
+ * Segments take palette entries in order across the whole datasource, so one
+ * series of four points and four series of one point both give four colours.
+ * A point's own `color` wins; a series with a single point is that segment, so
+ * the series `color` applies to it.
+ */
+export declare function resolveSegmentColors(datasource: {
+    readonly series: readonly {
+        readonly id: string;
+        readonly color?: string;
+        readonly points: readonly {
+            readonly id: string;
+            readonly color?: string;
+        }[];
+    }[];
+}, theme: ChartTheme): Record<string, string>;
+//# sourceMappingURL=theme.d.ts.map

package/lib/typescript/commonjs/contract/theme.d.ts.map

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

package/lib/typescript/commonjs/contract/value.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Value semantics for @chipmobilesdk/rn-chart.
+ *
+ * The foundation of the whole contract. Four value classes, carried as a
+ * discriminated union with **no numeric field on the three non-value cases**.
+ *
+ * That shape is deliberate: with a nullable `number`, `value ?? 0` would
+ * compile, and turning a gap into a zero is the single most damaging thing a
+ * charting library can do to someone's data. Here there is simply no number to
+ * read unless the value is known.
+ *
+ * See specs/007-rn-chart-package/data-model.md §1 (FR-011, FR-012).
+ */
+/** A real observation, including a genuine `0`. */
+export interface KnownValue {
+    readonly kind: 'known';
+    readonly value: number;
+}
+/** We do not know this value. Never rendered as zero, never interpolated. */
+export interface UnknownValue {
+    readonly kind: 'unknown';
+}
+/** This value does not apply here. Excluded from totals and proportions. */
+export interface NotApplicableValue {
+    readonly kind: 'notApplicable';
+}
+/** Hidden from this viewer: permission, or not enough data to disclose. */
+export interface WithheldValue {
+    readonly kind: 'withheld';
+}
+export type ValueState = KnownValue | UnknownValue | NotApplicableValue | WithheldValue;
+export type ValueKind = ValueState['kind'];
+export declare function known(value: number): KnownValue;
+/**
+ * Note: shadows the `unknown` *type* keyword in value position only. TypeScript
+ * keeps type and value namespaces separate, so `x: unknown` still means the
+ * type even in modules that import this helper.
+ */
+export declare function unknown(): UnknownValue;
+export declare function notApplicable(): NotApplicableValue;
+export declare function withheld(): WithheldValue;
+export declare function isKnown(v: ValueState): v is KnownValue;
+/**
+ * True when the value must never reach a rendering, a label, a summary, or an
+ * interaction callback (FR-033, FR-053). Withheld values carry no number at
+ * all, so this is about intent rather than data hiding.
+ */
+export declare function isWithheld(v: ValueState): v is WithheldValue;
+/**
+ * True when the point takes part in totals, proportions, and axis domains.
+ * `notApplicable` and `withheld` are excluded; excluding either makes a total
+ * incomplete (FR-013).
+ */
+export declare function participatesInTotals(v: ValueState): boolean;
+export interface TotalResult {
+    readonly total: number;
+    /** True when any point was excluded, so the total is not the whole picture. */
+    readonly incomplete: boolean;
+    readonly countedPoints: number;
+    readonly excludedPoints: number;
+}
+/**
+ * Sums known values and reports whether anything was left out (FR-013).
+ *
+ * `unknown` also excludes and marks the total incomplete: we cannot claim a sum
+ * is complete when part of the data is missing.
+ */
+export declare function sumKnown(values: readonly ValueState[]): TotalResult;
+//# sourceMappingURL=value.d.ts.map

package/lib/typescript/commonjs/contract/value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../../../src/contract/value.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,mDAAmD;AACnD,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CACzB;AAED,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAC/B;AAED,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC1B;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAExF,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;AAM3C,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,YAAY,CAEtC;AAED,wBAAgB,aAAa,IAAI,kBAAkB,CAElD;AAED,wBAAgB,QAAQ,IAAI,aAAa,CAExC;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,IAAI,UAAU,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,IAAI,aAAa,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAE3D;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,WAAW,CAoBnE"}

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

@@ -0,0 +1,18 @@
+/**
+ * Bar geometry: one batched path per series, grouped or stacked.
+ *
+ * Bars measure length from zero, so the domain always includes it — otherwise
+ * a bar's length means nothing. Negative values place the baseline correctly
+ * rather than clamping to the plot floor.
+ *
+ * PURE. No React, no SVG.
+ */
+import type { ChartDatasource } from '../contract/datasource';
+import type { GeometryInput, ResolvedGeometry } from './types';
+export type BarGrouping = 'grouped' | 'stacked';
+export interface BarOptions {
+    readonly grouping?: BarGrouping;
+    readonly radius?: number;
+}
+export declare function buildBarGeometry<M>(datasource: ChartDatasource<M>, input: GeometryInput, options?: BarOptions): ResolvedGeometry;
+//# sourceMappingURL=bar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bar.d.ts","sourceRoot":"","sources":["../../../../src/geometry/bar.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,wBAAwB,CAAC;AAQhF,OAAO,KAAK,EAAE,aAAa,EAAY,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEzE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhD,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AA8GD,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,UAAe,GACtB,gBAAgB,CA+IlB"}

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

@@ -0,0 +1,23 @@
+/**
+ * Distribution geometry: proportions between groups.
+ *
+ * Segments that do not sum to the whole are **not** rescaled to force a full
+ * circle (FR-024). The arc stops short and the geometry reports `incomplete`,
+ * so the chart can say the data is partial rather than quietly implying it is
+ * complete.
+ *
+ * PURE. No React, no SVG.
+ */
+import type { ChartDatasource } from '../contract/datasource';
+import { type DistributionValues } from '../contract/distribution';
+import type { GeometryInput, ResolvedGeometry } from './types';
+export type DistributionShape = 'donut' | 'pie' | 'segmentedBar';
+export interface DistributionOptions {
+    readonly shape?: DistributionShape;
+    /** Donut hole as a fraction of the outer radius. */
+    readonly innerRadiusRatio?: number;
+    /** What the values mean; inferred from the data when omitted. */
+    readonly valuesAre?: DistributionValues;
+}
+export declare function buildDistributionGeometry<M>(datasource: ChartDatasource<M>, input: GeometryInput, options?: DistributionOptions): ResolvedGeometry;
+//# sourceMappingURL=distribution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../../../src/geometry/distribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAK9F,OAAO,KAAK,EAAE,aAAa,EAA2B,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAExF,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,KAAK,GAAG,cAAc,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,oDAAoD;IACpD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;CACxC;AAID,wBAAgB,yBAAyB,CAAC,CAAC,EAC1C,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,mBAAwB,GAC/B,gBAAgB,CAuKlB"}

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

@@ -0,0 +1,24 @@
+/**
+ * Heatmap geometry: a matrix of cells, batched by intensity bucket.
+ *
+ * This is where batching pays off most. A thousand cells become roughly eight
+ * paths — one per intensity bucket, plus one per non-value class — instead of a
+ * thousand elements. Cell count no longer drives element count at all
+ * (research.md R2).
+ *
+ * Empty, zero, and unavailable cells are distinct by construction (FR-027): a
+ * genuine zero lands in the lowest ramp bucket, while unknown, not-applicable,
+ * and withheld each get their own texture.
+ *
+ * PURE. No React, no SVG.
+ */
+import type { ChartDatasource } from '../contract/datasource';
+import type { GeometryInput, ResolvedGeometry } from './types';
+export interface HeatmapOptions {
+    /** Intensity buckets. More buckets means finer shading, more paths. */
+    readonly buckets?: number;
+    readonly cellGap?: number;
+    readonly cellRadius?: number;
+}
+export declare function buildHeatmapGeometry<M>(datasource: ChartDatasource<M>, input: GeometryInput, options?: HeatmapOptions): ResolvedGeometry;
+//# sourceMappingURL=heatmap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heatmap.d.ts","sourceRoot":"","sources":["../../../../src/geometry/heatmap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAM9D,OAAO,KAAK,EAAE,aAAa,EAAY,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACrC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,cAAmB,GAC1B,gBAAgB,CA4KlB"}

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

@@ -0,0 +1,68 @@
+/**
+ * Hit-testing for batched marks.
+ *
+ * Because marks are batched into one path per series, there are no per-element
+ * press handlers to rely on — a touch is resolved against geometry instead.
+ * That work would be needed anyway (a mobile time-series chart needs
+ * nearest-point search regardless of how it is drawn), and doing it in one
+ * place means a single implementation serves every family.
+ *
+ * PURE. No React, no SVG.
+ */
+export interface HitRegion {
+    readonly seriesId: string;
+    readonly pointId: string;
+    /** Mark centre, used for nearest-point search and for highlight placement. */
+    readonly x: number;
+    readonly y: number;
+    /** Optional bounds, for marks where containment beats proximity. */
+    readonly bounds?: {
+        readonly x: number;
+        readonly y: number;
+        readonly width: number;
+        readonly height: number;
+    };
+    /**
+     * An arc segment: containment by radius and angle. Angles are radians,
+     * clockwise from twelve o'clock, as the distribution geometry draws them.
+     * A region with an arc is hit only inside it, never by proximity.
+     */
+    readonly arc?: {
+        readonly cx: number;
+        readonly cy: number;
+        readonly innerRadius: number;
+        readonly outerRadius: number;
+        readonly startAngle: number;
+        readonly endAngle: number;
+    };
+    /**
+     * False for points that must never be selectable: withheld values, and
+     * anything the chart is not currently drawing (FR-053).
+     */
+    readonly selectable: boolean;
+}
+export interface HitResult {
+    readonly seriesId: string;
+    readonly pointId: string;
+    readonly distance: number;
+}
+/** Touch slop: how far from a mark a tap still counts, in px. */
+export declare const DEFAULT_HIT_RADIUS = 44;
+/**
+ * Resolves a touch to a mark.
+ *
+ * Containment wins over proximity where bounds exist — tapping inside a bar
+ * should select that bar even if a neighbouring bar's centre happens to be
+ * closer. Otherwise the nearest selectable mark within the hit radius wins.
+ */
+export declare function hitTest(regions: readonly HitRegion[], x: number, y: number, hitRadius?: number): HitResult | null;
+/**
+ * Nearest mark by horizontal distance only.
+ *
+ * The right model for a time-series chart: a user aiming at "that Tuesday
+ * spike" cares about the x position, and demanding vertical accuracy on a line
+ * that may sit anywhere in the plot makes selection frustrating.
+ */
+export declare function hitTestByX(regions: readonly HitRegion[], x: number): HitResult | null;
+export declare function findRegion(regions: readonly HitRegion[], seriesId: string, pointId?: string): HitRegion | undefined;
+//# sourceMappingURL=hitTest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hitTest.d.ts","sourceRoot":"","sources":["../../../../src/geometry/hitTest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE;QACjB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACxB,CAAC;IACF;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE;QACd,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAwBrC;;;;;;GAMG;AACH,wBAAgB,OAAO,CACtB,OAAO,EAAE,SAAS,SAAS,EAAE,EAC7B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,SAAS,SAAqB,GAC5B,SAAS,GAAG,IAAI,CA8BlB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAcrF;AAED,wBAAgB,UAAU,CACzB,OAAO,EAAE,SAAS,SAAS,EAAE,EAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACd,SAAS,GAAG,SAAS,CAIvB"}

package/lib/typescript/commonjs/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/commonjs/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/commonjs/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';
+import { type PlotRect } from './layout';
+import type { GeometryLabel, MarkerLine } from './types';
+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/commonjs/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,oBAAoB,CAAC;AAE1D,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,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/commonjs/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/commonjs/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/commonjs/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';
+import type { GeometryInput, ResolvedGeometry } from './types';
+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/commonjs/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,wBAAwB,CAAC;AAM9D,OAAO,KAAK,EAAE,aAAa,EAAuC,gBAAgB,EAAE,MAAM,SAAS,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"}