@chipmobilesdk/rn-chart 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,116 @@
 # @chipmobilesdk/rn-chart
 
+## 0.5.0
+
+### Minor Changes
+
+- Every package now ships built JavaScript with declaration files, instead of asking the
+  app to compile its TypeScript. ([#22](https://github.com/operationd8979/chip-mobile-sdk/pull/22))
+
+  Each tarball carries `lib/commonjs`, `lib/module` and `lib/typescript` (built with
+  `react-native-builder-bob`), and `src/` alongside them. What that changes for a
+  consumer:
+
+  - **Nothing to add to `transformIgnorePatterns`.** `require` resolves to the CommonJS
+    build, so an app's Jest loads this package without being told to transform it. That
+    was the one thing every consuming app had to know about us (DEP-04).
+  - **Typechecking reads our `.d.ts`** rather than compiling our source under our
+    `tsconfig`. A consumer's stricter — or looser — settings no longer meet our code.
+  - **`import` resolves to ESM**, so a bundler can tree-shake what it does not use.
+
+  No exported name changed, and no subpath moved: `.`, `./testing`, `./push`,
+  `./advanced`, `./app-auth`, `./keychain` and rn-core's twelve subpaths resolve exactly
+  as before, each now with its own declarations for both module systems. publint and
+  `attw --profile node16` pass on all twelve packages, which they could not before.
+
+  Inside the monorepo nothing changed either, and that is deliberate: every subpath also
+  declares a private `chipmobilesdk-source` condition pointing at its TypeScript, and
+  Metro, Jest and `tsc` here ask for that condition first. The demo app bundles 371
+  modules straight from `packages/*/src`, so editing a package still changes the app with
+  no build step, and coverage is still measured on the source. The condition is named for
+  this organization rather than using the conventional `source` because third-party
+  packages declare that one too — `@dr.pogodin/react-native-fs` does — and asking for it
+  pulled their sources into our stricter compile.
+
+  `npm run build:packages` builds everything, `prepack` rebuilds before any `npm pack`,
+  and `lib/` is git-ignored: the published bytes are produced by the release, never
+  committed. `npm run check:manifests` now fails a package whose `main`, `module`,
+  `types`, `source` condition, `files`, build script or `prepack` do not match this shape.
+
+### Patch Changes
+
+- Every peer range has an upper bound, and no package declares a peer it does not use. ([#21](https://github.com/operationd8979/chip-mobile-sdk/pull/21))
+
+  A peer range is now a caret, a tilde or an explicit `<`, except for `react` and
+  `react-native`: an app brings exactly one of each, so a floor is the only useful thing
+  to say about them. Every other peer is a library the app installs beside us, and an
+  open `>=` was a promise about versions nobody had run — mmkv 3→4 lost entitlements and
+  pending purchases exactly that way.
+
+  **Four of the new ceilings exclude a version that is already published**, so an app
+  that took the open range at its word may now see a peer warning. The new bound is the
+  major this release is tested against, which is the thing the old range failed to say:
+
+  | Peer | Was | Now | Published above the ceiling |
+  |---|---|---|---|
+  | `react-native-app-auth` (rn-auth) | `>=8` | `^8.0.0` | 9.0.0 |
+  | `react-native-keychain` (rn-auth) | `>=10` | `^10.0.0` | 11.0.0 |
+  | `@op-engineering/op-sqlite` (rn-local-db) | `>=17.1.0` | `^17.1.0` | 18.x, 19.x |
+  | `@react-native-firebase/messaging` (rn-notification) | `>=26.0.0` | `^26.0.0` | 27.x |
+
+  The others — `react-native-vision-camera` `^5.1.1`, `react-native-svg` `^15.15.0`,
+  `react-native-unistyles` `^3.2.0`, `@dr.pogodin/react-native-fs` `^2.39.2`,
+  `react-native-quick-crypto` `^1.0.0`, `react-native-notify-kit` `^10.5.0`,
+  `react-native-localize` `^3.7.0`, `react-native-mmkv` `^4.0.0` — exclude nothing that
+  exists today. rn-payment's mmkv range was already bounded (`>=4.0.0 <5`) and is now
+  written as the caret that means the same thing.
+
+  Peers nothing imports are gone. `rn-theme`, `rn-local-db` and `rn-notification` asked
+  for `react` without having a component or a hook between them; `rn-auth`, `rn-ai` and
+  `rn-i18n` asked for `react-native` without touching a React Native API (rn-auth reaches
+  both native modules through `lazyPeer`, rn-i18n formats on `Intl`); `rn-notification`
+  asked for `@react-native-firebase/app`, which messaging declares itself. `rn-ai` no
+  longer peers on `@chipmobilesdk/rn-auth` at all — it asks for a `TokenProvider`, a
+  two-method interface rn-auth's `auth` satisfies, so an app with its own token source
+  installs nothing extra. An app that enables push or signs in through rn-auth installs
+  the same packages as before; it is the manifest that stopped overstating.
+
+  `react-native-localize` is declared optional, which is what the code already did: the
+  time-zone reader goes through `lazyPeer` and falls back to `Intl` without it. The
+  `peerDependenciesMeta` entries that said `optional: false` are gone — that is npm's
+  default, and writing it down only invited the question of which peers were undecided.
+
+  `npm run check:manifests` now fails on an unbounded peer range, a peer nothing in
+  `src/` imports, and a `peerDependenciesMeta` entry for either, so the policy holds
+  without anyone remembering it.
+
+- Each package's public API and its weight are now recorded in the repository, so a change
+  to either is reviewed rather than discovered. ([#23](https://github.com/operationd8979/chip-mobile-sdk/pull/23))
+
+  `packages/<pkg>/etc/*.api.md` is an api-extractor report per entrypoint — twenty-seven
+  of them, generated from the declarations the package publishes and committed. A renamed
+  type, a widened union, one more optional field: all of it shows up in a pull request's
+  diff. `npm run check:api` fails when a report is out of date and `npm run api:update`
+  rewrites them.
+
+  A report that moves now needs a **minor or major** changeset for that package.
+  `check:changesets` enforces it, because the report is generated from what the package
+  publishes, and a patch release that moves the public surface is how a consumer's build
+  breaks on `npm update`. A report added for the first time is a baseline, not a change.
+  `./testing` deliberately has no report: test doubles are not a surface a release is
+  gated on.
+
+  `npm run check:size` holds every entrypoint to a budget in `.size-limit.json`, measured
+  on the ESM build with peers and rn-core treated as external — they are what an app
+  installs beside us, not our weight. Each budget started at today's measurement plus five
+  per cent, so growth becomes a decision someone makes instead of a drift nobody sees. The
+  current figures run from 500 B (`rn-core/lazy`) to 19 kB (rn-notification).
+
+  No behaviour or API changed in this release; the entry is here so the changelog records
+  when the reports and the budgets began.
+- Updated dependencies ([#22](https://github.com/operationd8979/chip-mobile-sdk/pull/22), [#23](https://github.com/operationd8979/chip-mobile-sdk/pull/23)):
+  - @chipmobilesdk/rn-core@0.2.0
+
 ## 0.4.0
 
 ### Minor Changes

package/README.md

@@ -43,7 +43,7 @@ app-level data-access concept, not an operating-system permission.
 |---|---|
 | React | 19.2+ |
 | React Native | 0.85+ |
-| `react-native-svg` | 15.15+ |
+| `react-native-svg` | `^15.15.0` |
 | Android | `minSdkVersion` 24, `targetSdkVersion` 36 |
 | iOS | 15.1+ |
 

package/lib/commonjs/a11y/summary.js

@@ -0,0 +1,190 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildChartSummary = buildChartSummary;
+exports.buildPointAnnouncement = buildPointAnnouncement;
+exports.buildTotalAnnouncement = buildTotalAnnouncement;
+var _format = require("../contract/format.js");
+var _rnCore = require("@chipmobilesdk/rn-core");
+var _strings = require("../contract/strings.js");
+var _value = require("../contract/value.js");
+/**
+ * Composed accessible summaries (FR-067, FR-068, FR-069, FR-072).
+ *
+ * Exposing 2,500 individual points to a screen reader would be unusable even
+ * if it were cheap. A composed summary covers the same need: what the chart is,
+ * what it shows, where the extremes are, and what any target says.
+ *
+ * Withheld values never enter a summary — that would leak exactly what the
+ * withheld class exists to protect (FR-033).
+ */
+
+const FAMILY_NOUN = {
+  progress: 'chart.family.progress',
+  distribution: 'chart.family.distribution',
+  timeSeries: 'chart.family.timeSeries',
+  bar: 'chart.family.bar',
+  heatmap: 'chart.family.heatmap'
+};
+
+/**
+ * What a screen reader hears when the chart is not showing data. Announcing
+ * the state beats silence, and beats announcing a stale value as if current.
+ */
+const STATUS_PHRASE = {
+  loading: 'chart.status.loading',
+  empty: 'chart.status.empty',
+  error: 'chart.status.error',
+  stale: 'chart.status.stale',
+  noPermission: 'chart.status.noPermission',
+  partial: 'chart.status.partial',
+  ready: undefined
+};
+function describeExtremes(datasource, formatValue, strings, formatPosition) {
+  let min;
+  let max;
+  const several = datasource.series.length > 1;
+  for (const series of datasource.series) {
+    for (const point of series.points) {
+      // Withheld and unknown values are skipped entirely.
+      if (!(0, _value.isKnown)(point.value)) {
+        continue;
+      }
+      // Named by where the point is. A time series used to name both
+      // extremes after the series, so a one-series chart reported a single
+      // value and lost its lowest (CHT-07). Built lazily: only two are read.
+      const label = () => {
+        if (point.position.kind === 'category') {
+          return point.position.category;
+        }
+        if (point.position.kind === 'matrix') {
+          return `${point.position.row} ${point.position.column}`;
+        }
+        const at = formatPosition(point.position);
+        return several ? `${series.label} ${at}` : at;
+      };
+      if (!min || point.value.value < min.value) {
+        min = {
+          label,
+          value: point.value.value,
+          point
+        };
+      }
+      if (!max || point.value.value > max.value) {
+        max = {
+          label,
+          value: point.value.value,
+          point
+        };
+      }
+    }
+  }
+  if (!min || !max) {
+    return '';
+  }
+  const maxText = formatValue({
+    kind: 'known',
+    value: max.value
+  });
+  // One figure only when the highest and the lowest are the same point.
+  if (min.point === max.point) {
+    return (0, _rnCore.formatMessage)(strings['chart.summary.single'], {
+      value: maxText
+    });
+  }
+  return (0, _rnCore.formatMessage)(strings['chart.summary.extremes'], {
+    maxLabel: max.label(),
+    max: maxText,
+    minLabel: min.label(),
+    min: formatValue({
+      kind: 'known',
+      value: min.value
+    })
+  });
+}
+function describeMarkers(markers, formatValue, strings) {
+  if (!markers || markers.length === 0) {
+    return '';
+  }
+  const parts = [];
+  for (const marker of markers) {
+    if (!(0, _value.isKnown)(marker.value)) {
+      continue;
+    }
+    const name = marker.label ?? marker.kind;
+    parts.push((0, _rnCore.formatMessage)(strings['chart.summary.marker'], {
+      name,
+      value: formatValue(marker.value)
+    }));
+  }
+  return parts.length > 0 ? `${parts.join('. ')}.` : '';
+}
+
+/**
+ * Builds the label read aloud for the chart as a whole.
+ *
+ * Non-ready statuses replace the data description rather than appending to it,
+ * so a loading chart never announces figures it is not showing.
+ */
+function buildChartSummary(input) {
+  const strings = input.strings ?? _strings.chartStrings.defaults;
+  const noun = strings[FAMILY_NOUN[input.family]];
+  const heading = input.title ? (0, _rnCore.formatMessage)(strings['chart.summary.heading'], {
+    title: input.title,
+    noun
+  }) : (0, _rnCore.formatMessage)(strings['chart.summary.headingUntitled'], {
+    noun
+  });
+  const statusKey = STATUS_PHRASE[input.status];
+  const statusPhrase = statusKey ? strings[statusKey] : undefined;
+  if (input.status !== 'ready' && input.status !== 'partial' && input.status !== 'stale') {
+    return `${heading} ${statusPhrase ?? ''}`.trim();
+  }
+  const seriesCount = input.datasource.series.length;
+  const pointCount = input.datasource.series.reduce((acc, s) => acc + s.points.length, 0);
+  const scale = seriesCount > 1 ? (0, _rnCore.formatMessage)(strings['chart.summary.scale'], {
+    series: seriesCount,
+    points: pointCount
+  }) : (0, _rnCore.formatMessage)(strings['chart.summary.scaleSingle'], {
+    points: pointCount
+  });
+  const parts = [heading, statusPhrase, scale, describeExtremes(input.datasource, input.formatValue, strings, input.formatPosition ?? _format.formatPositionDefault), describeMarkers(input.datasource.markers, input.formatValue, strings), input.incomplete ? strings['chart.summary.incomplete'] : ''];
+  return parts.filter(Boolean).join(' ').replace(/\s+/g, ' ').trim();
+}
+
+/** Announced for the currently selected point on an adjustable chart. */
+function buildPointAnnouncement(seriesLabel, positionLabel, value, formatValue, strings = _strings.chartStrings.defaults) {
+  const vars = {
+    position: positionLabel,
+    series: seriesLabel
+  };
+  if (value.kind === 'withheld') {
+    return (0, _rnCore.formatMessage)(strings['chart.point.withheld'], vars);
+  }
+  if (!(0, _value.isKnown)(value)) {
+    return (0, _rnCore.formatMessage)(strings['chart.point.noData'], vars);
+  }
+  return (0, _rnCore.formatMessage)(strings['chart.point.value'], {
+    ...vars,
+    value: formatValue(value)
+  });
+}
+
+/** Total plus an explicit note when it is not the whole picture (FR-013). */
+function buildTotalAnnouncement(datasource, formatValue, strings = _strings.chartStrings.defaults) {
+  const values = datasource.series.flatMap(s => s.points.map(p => p.value));
+  const total = (0, _value.sumKnown)(values);
+  const value = formatValue({
+    kind: 'known',
+    value: total.total
+  });
+  return total.incomplete ? (0, _rnCore.formatMessage)(strings['chart.total.incomplete'], {
+    value,
+    count: total.excludedPoints
+  }) : (0, _rnCore.formatMessage)(strings['chart.total'], {
+    value
+  });
+}
+//# sourceMappingURL=summary.js.map

package/lib/commonjs/a11y/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_format","require","_rnCore","_strings","_value","FAMILY_NOUN","progress","distribution","timeSeries","bar","heatmap","STATUS_PHRASE","loading","empty","error","stale","noPermission","partial","ready","undefined","describeExtremes","datasource","formatValue","strings","formatPosition","min","max","several","series","length","point","points","isKnown","value","label","position","kind","category","row","column","at","maxText","formatMessage","maxLabel","minLabel","describeMarkers","markers","parts","marker","name","push","join","buildChartSummary","input","chartStrings","defaults","noun","family","heading","title","statusKey","status","statusPhrase","trim","seriesCount","pointCount","reduce","acc","s","scale","formatPositionDefault","incomplete","filter","Boolean","replace","buildPointAnnouncement","seriesLabel","positionLabel","vars","buildTotalAnnouncement","values","flatMap","map","p","total","sumKnown","count","excludedPoints"],"sourceRoot":"../../../src","sources":["a11y/summary.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/contract/datasource.js

@@ -0,0 +1,64 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FAMILY_POSITION_KINDS = void 0;
+exports.familyAcceptsPositionKind = familyAcceptsPositionKind;
+exports.resolveFormat = resolveFormat;
+exports.resolveUnit = resolveUnit;
+/**
+ * The shared datasource contract (FR-007, FR-007a).
+ *
+ * One contract spans every chart family: each point carries the same envelope —
+ * identity, value state, optional unit and format hint, opaque metadata — and
+ * only its **position** varies by kind. Families that accept the same position
+ * kind consume one another's datasources unchanged; anything else is a
+ * validation error rather than a rendering guess.
+ *
+ * See specs/007-rn-chart-package/data-model.md §2–§6.
+ */
+
+/** A named bucket: a category axis, a distribution segment, a progress metric. */
+
+/**
+ * An absolute instant as epoch milliseconds, UTC.
+ *
+ * A number rather than a `Date` or an ISO string: cheap to compare and
+ * memoize, no per-render parsing across hundreds of points, no identity churn
+ * that would defeat the re-render guarantee, and no ambiguous offset. All
+ * date wording comes from app formatters (FR-016).
+ */
+
+/** A cell in a row-by-column matrix, for heatmaps. */
+
+/** Non-colour encoding for a series, so meaning never rides on hue alone (FR-064). */
+
+/**
+ * Which position kinds each family accepts.
+ *
+ * Bar accepting both `category` and `instant` is what makes swapping a
+ * time-series chart for a bar chart free — the datasource does not change.
+ */
+const FAMILY_POSITION_KINDS = exports.FAMILY_POSITION_KINDS = {
+  progress: ['category'],
+  distribution: ['category'],
+  bar: ['category', 'instant'],
+  timeSeries: ['instant'],
+  heatmap: ['matrix']
+};
+function familyAcceptsPositionKind(family, kind) {
+  return FAMILY_POSITION_KINDS[family].includes(kind);
+}
+
+/**
+ * Resolves unit and format through the documented precedence:
+ * point -> series -> datasource -> undefined (caller falls back to its default).
+ */
+function resolveFormat(point, series, datasource) {
+  return point?.format ?? series?.format ?? datasource.format;
+}
+function resolveUnit(point, series, datasource) {
+  return point?.unit ?? series?.unit ?? datasource.unit;
+}
+//# sourceMappingURL=datasource.js.map

package/lib/commonjs/contract/datasource.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["FAMILY_POSITION_KINDS","exports","progress","distribution","bar","timeSeries","heatmap","familyAcceptsPositionKind","family","kind","includes","resolveFormat","point","series","datasource","format","resolveUnit","unit"],"sourceRoot":"../../../src","sources":["contract/datasource.ts"],"mappings":";;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;;AAUA;;AA2CA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,qBAA6E,GAAAC,OAAA,CAAAD,qBAAA,GAAG;EAC5FE,QAAQ,EAAE,CAAC,UAAU,CAAC;EACtBC,YAAY,EAAE,CAAC,UAAU,CAAC;EAC1BC,GAAG,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;EAC5BC,UAAU,EAAE,CAAC,SAAS,CAAC;EACvBC,OAAO,EAAE,CAAC,QAAQ;AACnB,CAAC;AAEM,SAASC,yBAAyBA,CAACC,MAAmB,EAAEC,IAAkB,EAAW;EAC3F,OAAOT,qBAAqB,CAACQ,MAAM,CAAC,CAACE,QAAQ,CAACD,IAAI,CAAC;AACpD;;AAEA;AACA;AACA;AACA;AACO,SAASE,aAAaA,CAC5BC,KAA+B,EAC/BC,MAA6B,EAC7BC,UAA8B,EACL;EACzB,OAAOF,KAAK,EAAEG,MAAM,IAAIF,MAAM,EAAEE,MAAM,IAAID,UAAU,CAACC,MAAM;AAC5D;AAEO,SAASC,WAAWA,CAC1BJ,KAA+B,EAC/BC,MAA6B,EAC7BC,UAA8B,EACT;EACrB,OAAOF,KAAK,EAAEK,IAAI,IAAIJ,MAAM,EAAEI,IAAI,IAAIH,UAAU,CAACG,IAAI;AACtD","ignoreList":[]}

package/lib/commonjs/contract/distribution.js

@@ -0,0 +1,45 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DISTRIBUTION_SUM_TOLERANCE = void 0;
+exports.resolveDistributionValues = resolveDistributionValues;
+var _value = require("./value.js");
+/**
+ * What the numbers of a distribution mean (CHT-10).
+ *
+ * `proportions`: each value is already a share of the whole, in 0..1. A sum
+ * short of 1 is drawn short and reported incomplete. `absolute`: counts or
+ * amounts, normalised by their own total.
+ *
+ * Until 0.4.0 this was guessed from the values alone: anything in 0..1 was a
+ * proportion, so two segments counting 1 each drew two full circles on top of
+ * one another. The guess now also requires the shares to fit in one whole, and
+ * an app that knows can say so.
+ */
+
+const DISTRIBUTION_SUM_TOLERANCE = exports.DISTRIBUTION_SUM_TOLERANCE = 0.001;
+function resolveDistributionValues(datasource, declared) {
+  if (declared !== undefined) {
+    return declared;
+  }
+  if (datasource.format?.kind === 'percent') {
+    return 'proportions';
+  }
+  let sum = 0;
+  for (const series of datasource.series) {
+    for (const point of series.points) {
+      if (!(0, _value.isKnown)(point.value)) {
+        continue;
+      }
+      const value = point.value.value;
+      if (value < 0 || value > 1) {
+        return 'absolute';
+      }
+      sum += value;
+    }
+  }
+  return sum <= 1 + DISTRIBUTION_SUM_TOLERANCE ? 'proportions' : 'absolute';
+}
+//# sourceMappingURL=distribution.js.map

package/lib/commonjs/contract/distribution.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_value","require","DISTRIBUTION_SUM_TOLERANCE","exports","resolveDistributionValues","datasource","declared","undefined","format","kind","sum","series","point","points","isKnown","value"],"sourceRoot":"../../../src","sources":["contract/distribution.ts"],"mappings":";;;;;;;AAaA,IAAAA,MAAA,GAAAC,OAAA;AAbA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMO,MAAMC,0BAA0B,GAAAC,OAAA,CAAAD,0BAAA,GAAG,KAAK;AAExC,SAASE,yBAAyBA,CACxCC,UAA8B,EAC9BC,QAA6B,EACR;EACrB,IAAIA,QAAQ,KAAKC,SAAS,EAAE;IAC3B,OAAOD,QAAQ;EAChB;EACA,IAAID,UAAU,CAACG,MAAM,EAAEC,IAAI,KAAK,SAAS,EAAE;IAC1C,OAAO,aAAa;EACrB;EACA,IAAIC,GAAG,GAAG,CAAC;EACX,KAAK,MAAMC,MAAM,IAAIN,UAAU,CAACM,MAAM,EAAE;IACvC,KAAK,MAAMC,KAAK,IAAID,MAAM,CAACE,MAAM,EAAE;MAClC,IAAI,CAAC,IAAAC,cAAO,EAACF,KAAK,CAACG,KAAK,CAAC,EAAE;QAC1B;MACD;MACA,MAAMA,KAAK,GAAGH,KAAK,CAACG,KAAK,CAACA,KAAK;MAC/B,IAAIA,KAAK,GAAG,CAAC,IAAIA,KAAK,GAAG,CAAC,EAAE;QAC3B,OAAO,UAAU;MAClB;MACAL,GAAG,IAAIK,KAAK;IACb;EACD;EACA,OAAOL,GAAG,IAAI,CAAC,GAAGR,0BAA0B,GAAG,aAAa,GAAG,UAAU;AAC1E","ignoreList":[]}

package/lib/commonjs/contract/errors.js

@@ -0,0 +1,88 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.chartError = chartError;
+exports.failureSignature = failureSignature;
+exports.isChartError = isChartError;
+exports.toFailureReport = toFailureReport;
+exports.validationError = validationError;
+/**
+ * Typed error taxonomy and failure reporting (FR-038, FR-038a, FR-038b).
+ *
+ * Messages come from a **fixed catalogue with no interpolated data**. That is
+ * what makes the redaction guarantee structural rather than a rule someone has
+ * to remember: because the package never builds a message out of a value or a
+ * label, a failure report cannot carry patient data or account balances into a
+ * consuming app's crash reporting.
+ */
+
+/**
+ * Fixed message catalogue. Every entry is a constant string — no template
+ * holes, so no data can leak through a message.
+ */
+const MESSAGES = {
+  duplicateSeriesId: 'Datasource contains duplicate series identifiers. Series ids must be unique.',
+  duplicatePointId: 'A series contains duplicate point identifiers. Point ids must be unique within their series.',
+  positionKindMismatch: 'A data point position kind does not match the datasource positionKind.',
+  familyPositionKindUnsupported: 'This chart family does not accept the datasource position kind.',
+  inconsistentMatrix: 'Matrix datasource rows and columns are inconsistent across points.',
+  distributionNotWhole: 'Distribution segments do not sum to the whole. The chart marks the total incomplete rather than rescaling.',
+  nonFiniteValue: 'A known value or an instant is not a finite number. Use an unknown value for missing data.',
+  negativeDistributionValue: 'A distribution segment has a negative value. A share of a whole cannot be negative.',
+  declaredByApp: 'The application declared this chart to be in an error state.',
+  renderException: 'The chart failed while rendering and was contained. See the report for details.'
+};
+function chartError(category, code, extra) {
+  return {
+    category,
+    code,
+    message: MESSAGES[code],
+    ...extra
+  };
+}
+function validationError(code, extra) {
+  return chartError('validation', code, extra);
+}
+function isChartError(e) {
+  if (typeof e !== 'object' || e === null) {
+    return false;
+  }
+  const candidate = e;
+  return typeof candidate.code === 'string' && typeof candidate.message === 'string' && (candidate.category === 'validation' || candidate.category === 'declared' || candidate.category === 'render');
+}
+
+/**
+ * Builds the report handed to the app after a contained render exception.
+ *
+ * A `ChartError` thrown by the package keeps its catalogue message. Anything
+ * else — a defect in the rendering library, say — is reported under the generic
+ * `renderException` message. We do **not** copy a third-party exception's own
+ * message into the report, because we cannot promise it is free of data.
+ */
+function toFailureReport(family, thrown, chartId, componentStack) {
+  const error = isChartError(thrown) ? {
+    ...thrown,
+    chartId,
+    family
+  } : chartError('render', 'renderException', {
+    chartId,
+    family
+  });
+  return {
+    chartId,
+    family,
+    error,
+    componentStack
+  };
+}
+
+/**
+ * Stable identity for a failure, used to de-duplicate reports so an unrelated
+ * parent re-render does not re-report the same problem.
+ */
+function failureSignature(report) {
+  return `${report.chartId ?? 'anon'}:${report.family}:${report.error.code}`;
+}
+//# sourceMappingURL=errors.js.map

package/lib/commonjs/contract/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MESSAGES","duplicateSeriesId","duplicatePointId","positionKindMismatch","familyPositionKindUnsupported","inconsistentMatrix","distributionNotWhole","nonFiniteValue","negativeDistributionValue","declaredByApp","renderException","chartError","category","code","extra","message","validationError","isChartError","e","candidate","toFailureReport","family","thrown","chartId","componentStack","error","failureSignature","report"],"sourceRoot":"../../../src","sources":["contract/errors.ts"],"mappings":";;;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAiBA;AACA;AACA;AACA;AACA,MAAMA,QAAkD,GAAG;EAC1DC,iBAAiB,EAAE,8EAA8E;EACjGC,gBAAgB,EACf,8FAA8F;EAC/FC,oBAAoB,EAAE,wEAAwE;EAC9FC,6BAA6B,EAAE,iEAAiE;EAChGC,kBAAkB,EAAE,oEAAoE;EACxFC,oBAAoB,EACnB,4GAA4G;EAC7GC,cAAc,EACb,4FAA4F;EAC7FC,yBAAyB,EACxB,qFAAqF;EACtFC,aAAa,EAAE,8DAA8D;EAC7EC,eAAe,EACd;AACF,CAAC;AA4BM,SAASC,UAAUA,CACzBC,QAA4B,EAC5BC,IAAoB,EACpBC,KAAyD,EAC5C;EACb,OAAO;IACNF,QAAQ;IACRC,IAAI;IACJE,OAAO,EAAEf,QAAQ,CAACa,IAAI,CAAC;IACvB,GAAGC;EACJ,CAAC;AACF;AAEO,SAASE,eAAeA,CAC9BH,IAAoB,EACpBC,KAAyD,EAC5C;EACb,OAAOH,UAAU,CAAC,YAAY,EAAEE,IAAI,EAAEC,KAAK,CAAC;AAC7C;AAEO,SAASG,YAAYA,CAACC,CAAU,EAAmB;EACzD,IAAI,OAAOA,CAAC,KAAK,QAAQ,IAAIA,CAAC,KAAK,IAAI,EAAE;IACxC,OAAO,KAAK;EACb;EACA,MAAMC,SAAS,GAAGD,CAAwB;EAC1C,OACC,OAAOC,SAAS,CAACN,IAAI,KAAK,QAAQ,IAClC,OAAOM,SAAS,CAACJ,OAAO,KAAK,QAAQ,KACpCI,SAAS,CAACP,QAAQ,KAAK,YAAY,IACnCO,SAAS,CAACP,QAAQ,KAAK,UAAU,IACjCO,SAAS,CAACP,QAAQ,KAAK,QAAQ,CAAC;AAEnC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASQ,eAAeA,CAC9BC,MAAmB,EACnBC,MAAe,EACfC,OAAgB,EAChBC,cAAuB,EACF;EACrB,MAAMC,KAAiB,GAAGR,YAAY,CAACK,MAAM,CAAC,GAC3C;IAAE,GAAGA,MAAM;IAAEC,OAAO;IAAEF;EAAO,CAAC,GAC9BV,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE;IAAEY,OAAO;IAAEF;EAAO,CAAC,CAAC;EAE/D,OAAO;IAAEE,OAAO;IAAEF,MAAM;IAAEI,KAAK;IAAED;EAAe,CAAC;AAClD;;AAEA;AACA;AACA;AACA;AACO,SAASE,gBAAgBA,CAACC,MAA0B,EAAU;EACpE,OAAO,GAAGA,MAAM,CAACJ,OAAO,IAAI,MAAM,IAAII,MAAM,CAACN,MAAM,IAAIM,MAAM,CAACF,KAAK,CAACZ,IAAI,EAAE;AAC3E","ignoreList":[]}