@chipmobilesdk/rn-chart 0.4.0 → 0.5.0

package/lib/module/a11y/summary.js

@@ -0,0 +1,184 @@
+"use strict";
+
+/**
+ * Composed accessible summaries (FR-067, FR-068, FR-069, FR-072).
+ *
+ * Exposing 2,500 individual points to a screen reader would be unusable even
+ * if it were cheap. A composed summary covers the same need: what the chart is,
+ * what it shows, where the extremes are, and what any target says.
+ *
+ * Withheld values never enter a summary — that would leak exactly what the
+ * withheld class exists to protect (FR-033).
+ */
+
+import { formatPositionDefault } from "../contract/format.js";
+import { formatMessage } from '@chipmobilesdk/rn-core';
+import { chartStrings } from "../contract/strings.js";
+import { isKnown, sumKnown } from "../contract/value.js";
+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 (!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 formatMessage(strings['chart.summary.single'], {
+      value: maxText
+    });
+  }
+  return 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 (!isKnown(marker.value)) {
+      continue;
+    }
+    const name = marker.label ?? marker.kind;
+    parts.push(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.
+ */
+export function buildChartSummary(input) {
+  const strings = input.strings ?? chartStrings.defaults;
+  const noun = strings[FAMILY_NOUN[input.family]];
+  const heading = input.title ? formatMessage(strings['chart.summary.heading'], {
+    title: input.title,
+    noun
+  }) : 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 ? formatMessage(strings['chart.summary.scale'], {
+    series: seriesCount,
+    points: pointCount
+  }) : formatMessage(strings['chart.summary.scaleSingle'], {
+    points: pointCount
+  });
+  const parts = [heading, statusPhrase, scale, describeExtremes(input.datasource, input.formatValue, strings, input.formatPosition ?? 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. */
+export function buildPointAnnouncement(seriesLabel, positionLabel, value, formatValue, strings = chartStrings.defaults) {
+  const vars = {
+    position: positionLabel,
+    series: seriesLabel
+  };
+  if (value.kind === 'withheld') {
+    return formatMessage(strings['chart.point.withheld'], vars);
+  }
+  if (!isKnown(value)) {
+    return formatMessage(strings['chart.point.noData'], vars);
+  }
+  return formatMessage(strings['chart.point.value'], {
+    ...vars,
+    value: formatValue(value)
+  });
+}
+
+/** Total plus an explicit note when it is not the whole picture (FR-013). */
+export function buildTotalAnnouncement(datasource, formatValue, strings = chartStrings.defaults) {
+  const values = datasource.series.flatMap(s => s.points.map(p => p.value));
+  const total = sumKnown(values);
+  const value = formatValue({
+    kind: 'known',
+    value: total.total
+  });
+  return total.incomplete ? formatMessage(strings['chart.total.incomplete'], {
+    value,
+    count: total.excludedPoints
+  }) : formatMessage(strings['chart.total'], {
+    value
+  });
+}
+//# sourceMappingURL=summary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["formatPositionDefault","formatMessage","chartStrings","isKnown","sumKnown","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","value","label","position","kind","category","row","column","at","maxText","maxLabel","minLabel","describeMarkers","markers","parts","marker","name","push","join","buildChartSummary","input","defaults","noun","family","heading","title","statusKey","status","statusPhrase","trim","seriesCount","pointCount","reduce","acc","s","scale","incomplete","filter","Boolean","replace","buildPointAnnouncement","seriesLabel","positionLabel","vars","buildTotalAnnouncement","values","flatMap","map","p","total","count","excludedPoints"],"sourceRoot":"../../../src","sources":["a11y/summary.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,qBAAqB,QAAQ,uBAAoB;AAG1D,SAASC,aAAa,QAAQ,wBAAwB;AAEtD,SAASC,YAAY,QAA2B,wBAAqB;AACrE,SAASC,OAAO,EAAEC,QAAQ,QAAyB,sBAAmB;AAEtE,MAAMC,WAAoD,GAAG;EAC5DC,QAAQ,EAAE,uBAAuB;EACjCC,YAAY,EAAE,2BAA2B;EACzCC,UAAU,EAAE,yBAAyB;EACrCC,GAAG,EAAE,kBAAkB;EACvBC,OAAO,EAAE;AACV,CAAC;;AAED;AACA;AACA;AACA;AACA,MAAMC,aAAkE,GAAG;EAC1EC,OAAO,EAAE,sBAAsB;EAC/BC,KAAK,EAAE,oBAAoB;EAC3BC,KAAK,EAAE,oBAAoB;EAC3BC,KAAK,EAAE,oBAAoB;EAC3BC,YAAY,EAAE,2BAA2B;EACzCC,OAAO,EAAE,sBAAsB;EAC/BC,KAAK,EAAEC;AACR,CAAC;AAeD,SAASC,gBAAgBA,CACxBC,UAA8B,EAC9BC,WAAsC,EACtCC,OAAqB,EACrBC,cAA8C,EACrC;EAET,IAAIC,GAAwB;EAC5B,IAAIC,GAAwB;EAC5B,MAAMC,OAAO,GAAGN,UAAU,CAACO,MAAM,CAACC,MAAM,GAAG,CAAC;EAE5C,KAAK,MAAMD,MAAM,IAAIP,UAAU,CAACO,MAAM,EAAE;IACvC,KAAK,MAAME,KAAK,IAAIF,MAAM,CAACG,MAAM,EAAE;MAClC;MACA,IAAI,CAAC5B,OAAO,CAAC2B,KAAK,CAACE,KAAK,CAAC,EAAE;QAC1B;MACD;MACA;MACA;MACA;MACA,MAAMC,KAAK,GAAGA,CAAA,KAAc;QAC3B,IAAIH,KAAK,CAACI,QAAQ,CAACC,IAAI,KAAK,UAAU,EAAE;UACvC,OAAOL,KAAK,CAACI,QAAQ,CAACE,QAAQ;QAC/B;QACA,IAAIN,KAAK,CAACI,QAAQ,CAACC,IAAI,KAAK,QAAQ,EAAE;UACrC,OAAO,GAAGL,KAAK,CAACI,QAAQ,CAACG,GAAG,IAAIP,KAAK,CAACI,QAAQ,CAACI,MAAM,EAAE;QACxD;QACA,MAAMC,EAAE,GAAGf,cAAc,CAACM,KAAK,CAACI,QAAQ,CAAC;QACzC,OAAOP,OAAO,GAAG,GAAGC,MAAM,CAACK,KAAK,IAAIM,EAAE,EAAE,GAAGA,EAAE;MAC9C,CAAC;MAED,IAAI,CAACd,GAAG,IAAIK,KAAK,CAACE,KAAK,CAACA,KAAK,GAAGP,GAAG,CAACO,KAAK,EAAE;QAC1CP,GAAG,GAAG;UAAEQ,KAAK;UAAED,KAAK,EAAEF,KAAK,CAACE,KAAK,CAACA,KAAK;UAAEF;QAAM,CAAC;MACjD;MACA,IAAI,CAACJ,GAAG,IAAII,KAAK,CAACE,KAAK,CAACA,KAAK,GAAGN,GAAG,CAACM,KAAK,EAAE;QAC1CN,GAAG,GAAG;UAAEO,KAAK;UAAED,KAAK,EAAEF,KAAK,CAACE,KAAK,CAACA,KAAK;UAAEF;QAAM,CAAC;MACjD;IACD;EACD;EAEA,IAAI,CAACL,GAAG,IAAI,CAACC,GAAG,EAAE;IACjB,OAAO,EAAE;EACV;EACA,MAAMc,OAAO,GAAGlB,WAAW,CAAC;IAAEa,IAAI,EAAE,OAAO;IAAEH,KAAK,EAAEN,GAAG,CAACM;EAAM,CAAC,CAAC;EAChE;EACA,IAAIP,GAAG,CAACK,KAAK,KAAKJ,GAAG,CAACI,KAAK,EAAE;IAC5B,OAAO7B,aAAa,CAACsB,OAAO,CAAC,sBAAsB,CAAC,EAAE;MAAES,KAAK,EAAEQ;IAAQ,CAAC,CAAC;EAC1E;EAEA,OAAOvC,aAAa,CAACsB,OAAO,CAAC,wBAAwB,CAAC,EAAE;IACvDkB,QAAQ,EAAEf,GAAG,CAACO,KAAK,CAAC,CAAC;IACrBP,GAAG,EAAEc,OAAO;IACZE,QAAQ,EAAEjB,GAAG,CAACQ,KAAK,CAAC,CAAC;IACrBR,GAAG,EAAEH,WAAW,CAAC;MAAEa,IAAI,EAAE,OAAO;MAAEH,KAAK,EAAEP,GAAG,CAACO;IAAM,CAAC;EACrD,CAAC,CAAC;AACH;AAEA,SAASW,eAAeA,CACvBC,OAA+C,EAC/CtB,WAAsC,EACtCC,OAAqB,EACZ;EACT,IAAI,CAACqB,OAAO,IAAIA,OAAO,CAACf,MAAM,KAAK,CAAC,EAAE;IACrC,OAAO,EAAE;EACV;EAEA,MAAMgB,KAAe,GAAG,EAAE;EAC1B,KAAK,MAAMC,MAAM,IAAIF,OAAO,EAAE;IAC7B,IAAI,CAACzC,OAAO,CAAC2C,MAAM,CAACd,KAAK,CAAC,EAAE;MAC3B;IACD;IACA,MAAMe,IAAI,GAAGD,MAAM,CAACb,KAAK,IAAIa,MAAM,CAACX,IAAI;IACxCU,KAAK,CAACG,IAAI,CACT/C,aAAa,CAACsB,OAAO,CAAC,sBAAsB,CAAC,EAAE;MAAEwB,IAAI;MAAEf,KAAK,EAAEV,WAAW,CAACwB,MAAM,CAACd,KAAK;IAAE,CAAC,CAC1F,CAAC;EACF;EAEA,OAAOa,KAAK,CAAChB,MAAM,GAAG,CAAC,GAAG,GAAGgB,KAAK,CAACI,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE;AACtD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAIC,KAAsB,EAAU;EACpE,MAAM5B,OAAO,GAAG4B,KAAK,CAAC5B,OAAO,IAAIrB,YAAY,CAACkD,QAAQ;EACtD,MAAMC,IAAI,GAAG9B,OAAO,CAAClB,WAAW,CAAC8C,KAAK,CAACG,MAAM,CAAC,CAAC;EAC/C,MAAMC,OAAO,GAAGJ,KAAK,CAACK,KAAK,GACxBvD,aAAa,CAACsB,OAAO,CAAC,uBAAuB,CAAC,EAAE;IAAEiC,KAAK,EAAEL,KAAK,CAACK,KAAK;IAAEH;EAAK,CAAC,CAAC,GAC7EpD,aAAa,CAACsB,OAAO,CAAC,+BAA+B,CAAC,EAAE;IAAE8B;EAAK,CAAC,CAAC;EAEpE,MAAMI,SAAS,GAAG9C,aAAa,CAACwC,KAAK,CAACO,MAAM,CAAC;EAC7C,MAAMC,YAAY,GAAGF,SAAS,GAAGlC,OAAO,CAACkC,SAAS,CAAC,GAAGtC,SAAS;EAC/D,IAAIgC,KAAK,CAACO,MAAM,KAAK,OAAO,IAAIP,KAAK,CAACO,MAAM,KAAK,SAAS,IAAIP,KAAK,CAACO,MAAM,KAAK,OAAO,EAAE;IACvF,OAAO,GAAGH,OAAO,IAAII,YAAY,IAAI,EAAE,EAAE,CAACC,IAAI,CAAC,CAAC;EACjD;EAEA,MAAMC,WAAW,GAAGV,KAAK,CAAC9B,UAAU,CAACO,MAAM,CAACC,MAAM;EAClD,MAAMiC,UAAU,GAAGX,KAAK,CAAC9B,UAAU,CAACO,MAAM,CAACmC,MAAM,CAAC,CAACC,GAAG,EAAEC,CAAC,KAAKD,GAAG,GAAGC,CAAC,CAAClC,MAAM,CAACF,MAAM,EAAE,CAAC,CAAC;EAEvF,MAAMqC,KAAK,GACVL,WAAW,GAAG,CAAC,GACZ5D,aAAa,CAACsB,OAAO,CAAC,qBAAqB,CAAC,EAAE;IAAEK,MAAM,EAAEiC,WAAW;IAAE9B,MAAM,EAAE+B;EAAW,CAAC,CAAC,GAC1F7D,aAAa,CAACsB,OAAO,CAAC,2BAA2B,CAAC,EAAE;IAAEQ,MAAM,EAAE+B;EAAW,CAAC,CAAC;EAE/E,MAAMjB,KAAK,GAAG,CACbU,OAAO,EACPI,YAAY,EACZO,KAAK,EACL9C,gBAAgB,CACf+B,KAAK,CAAC9B,UAAU,EAChB8B,KAAK,CAAC7B,WAAW,EACjBC,OAAO,EACP4B,KAAK,CAAC3B,cAAc,IAAIxB,qBACzB,CAAC,EACD2C,eAAe,CAACQ,KAAK,CAAC9B,UAAU,CAACuB,OAAO,EAAEO,KAAK,CAAC7B,WAAW,EAAEC,OAAO,CAAC,EACrE4B,KAAK,CAACgB,UAAU,GAAG5C,OAAO,CAAC,0BAA0B,CAAC,GAAG,EAAE,CAC3D;EAED,OAAOsB,KAAK,CAACuB,MAAM,CAACC,OAAO,CAAC,CAACpB,IAAI,CAAC,GAAG,CAAC,CAACqB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAACV,IAAI,CAAC,CAAC;AACnE;;AAEA;AACA,OAAO,SAASW,sBAAsBA,CACrCC,WAAmB,EACnBC,aAAqB,EACrBzC,KAAiB,EACjBV,WAAsC,EACtCC,OAAqB,GAAGrB,YAAY,CAACkD,QAAQ,EACpC;EACT,MAAMsB,IAAI,GAAG;IAAExC,QAAQ,EAAEuC,aAAa;IAAE7C,MAAM,EAAE4C;EAAY,CAAC;EAC7D,IAAIxC,KAAK,CAACG,IAAI,KAAK,UAAU,EAAE;IAC9B,OAAOlC,aAAa,CAACsB,OAAO,CAAC,sBAAsB,CAAC,EAAEmD,IAAI,CAAC;EAC5D;EACA,IAAI,CAACvE,OAAO,CAAC6B,KAAK,CAAC,EAAE;IACpB,OAAO/B,aAAa,CAACsB,OAAO,CAAC,oBAAoB,CAAC,EAAEmD,IAAI,CAAC;EAC1D;EACA,OAAOzE,aAAa,CAACsB,OAAO,CAAC,mBAAmB,CAAC,EAAE;IAAE,GAAGmD,IAAI;IAAE1C,KAAK,EAAEV,WAAW,CAACU,KAAK;EAAE,CAAC,CAAC;AAC3F;;AAEA;AACA,OAAO,SAAS2C,sBAAsBA,CACrCtD,UAA8B,EAC9BC,WAAsC,EACtCC,OAAqB,GAAGrB,YAAY,CAACkD,QAAQ,EACpC;EACT,MAAMwB,MAAM,GAAGvD,UAAU,CAACO,MAAM,CAACiD,OAAO,CAACZ,CAAC,IAAIA,CAAC,CAAClC,MAAM,CAAC+C,GAAG,CAACC,CAAC,IAAIA,CAAC,CAAC/C,KAAK,CAAC,CAAC;EACzE,MAAMgD,KAAK,GAAG5E,QAAQ,CAACwE,MAAM,CAAC;EAC9B,MAAM5C,KAAK,GAAGV,WAAW,CAAC;IAAEa,IAAI,EAAE,OAAO;IAAEH,KAAK,EAAEgD,KAAK,CAACA;EAAM,CAAC,CAAC;EAChE,OAAOA,KAAK,CAACb,UAAU,GACpBlE,aAAa,CAACsB,OAAO,CAAC,wBAAwB,CAAC,EAAE;IAAES,KAAK;IAAEiD,KAAK,EAAED,KAAK,CAACE;EAAe,CAAC,CAAC,GACxFjF,aAAa,CAACsB,OAAO,CAAC,aAAa,CAAC,EAAE;IAAES;EAAM,CAAC,CAAC;AACpD","ignoreList":[]}

package/lib/module/contract/datasource.js

@@ -0,0 +1,57 @@
+"use strict";
+
+/**
+ * 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.
+ */
+export const FAMILY_POSITION_KINDS = {
+  progress: ['category'],
+  distribution: ['category'],
+  bar: ['category', 'instant'],
+  timeSeries: ['instant'],
+  heatmap: ['matrix']
+};
+export 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).
+ */
+export function resolveFormat(point, series, datasource) {
+  return point?.format ?? series?.format ?? datasource.format;
+}
+export function resolveUnit(point, series, datasource) {
+  return point?.unit ?? series?.unit ?? datasource.unit;
+}
+//# sourceMappingURL=datasource.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["FAMILY_POSITION_KINDS","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;AACA,OAAO,MAAMA,qBAA6E,GAAG;EAC5FC,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;AAED,OAAO,SAASC,yBAAyBA,CAACC,MAAmB,EAAEC,IAAkB,EAAW;EAC3F,OAAOR,qBAAqB,CAACO,MAAM,CAAC,CAACE,QAAQ,CAACD,IAAI,CAAC;AACpD;;AAEA;AACA;AACA;AACA;AACA,OAAO,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;AAEA,OAAO,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/module/contract/distribution.js

@@ -0,0 +1,40 @@
+"use strict";
+
+/**
+ * What the numbers of a distribution mean (CHT-10).
+ *
+ * `proportions`: each value is already a share of the whole, in 0..1. A sum
+ * short of 1 is drawn short and reported incomplete. `absolute`: counts or
+ * amounts, normalised by their own total.
+ *
+ * Until 0.4.0 this was guessed from the values alone: anything in 0..1 was a
+ * proportion, so two segments counting 1 each drew two full circles on top of
+ * one another. The guess now also requires the shares to fit in one whole, and
+ * an app that knows can say so.
+ */
+
+import { isKnown } from "./value.js";
+export const DISTRIBUTION_SUM_TOLERANCE = 0.001;
+export 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 (!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/module/contract/distribution.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isKnown","DISTRIBUTION_SUM_TOLERANCE","resolveDistributionValues","datasource","declared","undefined","format","kind","sum","series","point","points","value"],"sourceRoot":"../../../src","sources":["contract/distribution.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,OAAO,QAAQ,YAAS;AAIjC,OAAO,MAAMC,0BAA0B,GAAG,KAAK;AAE/C,OAAO,SAASC,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,CAACX,OAAO,CAACU,KAAK,CAACE,KAAK,CAAC,EAAE;QAC1B;MACD;MACA,MAAMA,KAAK,GAAGF,KAAK,CAACE,KAAK,CAACA,KAAK;MAC/B,IAAIA,KAAK,GAAG,CAAC,IAAIA,KAAK,GAAG,CAAC,EAAE;QAC3B,OAAO,UAAU;MAClB;MACAJ,GAAG,IAAII,KAAK;IACb;EACD;EACA,OAAOJ,GAAG,IAAI,CAAC,GAAGP,0BAA0B,GAAG,aAAa,GAAG,UAAU;AAC1E","ignoreList":[]}

package/lib/module/contract/errors.js

@@ -0,0 +1,80 @@
+"use strict";
+
+/**
+ * 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.'
+};
+export function chartError(category, code, extra) {
+  return {
+    category,
+    code,
+    message: MESSAGES[code],
+    ...extra
+  };
+}
+export function validationError(code, extra) {
+  return chartError('validation', code, extra);
+}
+export 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.
+ */
+export 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.
+ */
+export function failureSignature(report) {
+  return `${report.chartId ?? 'anon'}:${report.family}:${report.error.code}`;
+}
+//# sourceMappingURL=errors.js.map

package/lib/module/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;AA4BD,OAAO,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;AAEA,OAAO,SAASE,eAAeA,CAC9BH,IAAoB,EACpBC,KAAyD,EAC5C;EACb,OAAOH,UAAU,CAAC,YAAY,EAAEE,IAAI,EAAEC,KAAK,CAAC;AAC7C;AAEA,OAAO,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;AACA,OAAO,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;AACA,OAAO,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":[]}

package/lib/module/contract/format.js

@@ -0,0 +1,123 @@
+"use strict";
+
+/**
+ * Formatting contract (FR-055 to FR-059).
+ *
+ * The package never invents or converts a business unit. It accepts a hint,
+ * applies a documented locale-neutral default, and uses app-supplied formatter
+ * output verbatim whenever one is given.
+ */
+import { createDiagnosticChannel } from '@chipmobilesdk/rn-core';
+import { isKnown } from "./value.js";
+
+/** Chart diagnostics also reach the app's SDK sinks (`installSdkSink`, CORE-08). */
+const channel = createDiagnosticChannel('rn-chart');
+/**
+ * Placeholders for the three non-value classes. Deliberately not "0" and not
+ * an empty string, so a reader can tell a gap from a zero at a glance.
+ */
+export const NON_VALUE_TEXT = {
+  unknown: '—',
+  notApplicable: 'n/a',
+  withheld: '••'
+};
+function trimTrailingZeros(text) {
+  return text.includes('.') ? text.replace(/\.?0+$/, '') : text;
+}
+
+/**
+ * Locale-neutral default formatting (FR-057).
+ *
+ * Deliberately plain: no thousands separators, no currency symbol lookup, no
+ * month names. Anything locale-dependent belongs to the consuming app, which
+ * owns an i18n system the package does not.
+ */
+export function formatValueDefault(v, ctx = {
+  slot: 'value'
+}) {
+  if (!isKnown(v)) {
+    return NON_VALUE_TEXT[v.kind] ?? NON_VALUE_TEXT.unknown;
+  }
+  const hint = ctx.hint;
+  const n = v.value;
+  switch (hint?.kind) {
+    case 'percent':
+      {
+        const decimals = hint.decimals ?? 0;
+        return `${(n * 100).toFixed(decimals)}%`;
+      }
+    case 'currency':
+      // Code rather than symbol: symbol placement is locale-dependent and
+      // therefore the app's decision.
+      return `${n.toFixed(2)} ${hint.currency}`;
+    case 'duration':
+      return `${trimTrailingZeros(n.toFixed(2))}${hint.unit}`;
+    case 'count':
+      return String(Math.round(n));
+    case 'custom':
+      return `${trimTrailingZeros(n.toFixed(2))} ${hint.unit}`;
+    case 'number':
+      return hint.decimals === undefined ? trimTrailingZeros(n.toFixed(2)) : n.toFixed(hint.decimals);
+    default:
+      return trimTrailingZeros(n.toFixed(2));
+  }
+}
+export function formatPositionDefault(p) {
+  switch (p.kind) {
+    case 'category':
+      return p.category;
+    case 'matrix':
+      return `${p.row} / ${p.column}`;
+    case 'instant':
+      // Epoch milliseconds as-is. Any human-readable date belongs to an app
+      // formatter, which alone knows the locale and the display timezone
+      // (FR-016).
+      return String(p.at);
+  }
+}
+export function formatLegendDefault(series) {
+  return series.label;
+}
+
+/**
+ * Runs an app formatter, falling back to the package default for that single
+ * label if it throws (FR-059). One bad formatter must not take down a screen.
+ *
+ * The dev-only warning is intentionally value-free: it names the slot, never
+ * the data.
+ */
+export function safeFormat(run, fallback, slot, onceKey) {
+  try {
+    return run();
+  } catch (e) {
+    if (__DEV__) {
+      warnFormatterFailureOnce(slot, onceKey, e);
+    }
+    return fallback();
+  }
+}
+const warnedFormatters = new Set();
+function warnFormatterFailureOnce(slot, onceKey, error) {
+  const key = `${slot}:${onceKey ?? 'default'}`;
+  if (warnedFormatters.has(key)) {
+    return;
+  }
+  warnedFormatters.add(key);
+  channel.emit('formatter_threw', 'warn', {
+    slot
+  });
+  const reason = error instanceof Error ? error.message : 'unknown error';
+  console.warn(`[rn-chart] A supplied "${slot}" formatter threw (${reason}). ` + 'Falling back to the built-in default for that label. ' + 'This warning appears once per formatter slot and never in production builds.');
+}
+
+/** Test-only reset so warning-once behaviour can be asserted repeatedly. */
+export function __resetFormatterWarnings() {
+  warnedFormatters.clear();
+}
+export function seriesRef(series) {
+  return {
+    id: series.id,
+    label: series.label
+  };
+}
+//# sourceMappingURL=format.js.map

package/lib/module/contract/format.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createDiagnosticChannel","isKnown","channel","NON_VALUE_TEXT","unknown","notApplicable","withheld","trimTrailingZeros","text","includes","replace","formatValueDefault","v","ctx","slot","kind","hint","n","value","decimals","toFixed","currency","unit","String","Math","round","undefined","formatPositionDefault","p","category","row","column","at","formatLegendDefault","series","label","safeFormat","run","fallback","onceKey","e","__DEV__","warnFormatterFailureOnce","warnedFormatters","Set","error","key","has","add","emit","reason","Error","message","console","warn","__resetFormatterWarnings","clear","seriesRef","id"],"sourceRoot":"../../../src","sources":["contract/format.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/contract/interaction.js

@@ -0,0 +1,20 @@
+"use strict";
+
+/**
+ * Interaction contract (FR-048 to FR-054a).
+ *
+ * The package reports what the user touched and does nothing else: no
+ * navigation, no fetching, no datasource mutation, no business rules.
+ *
+ * Selection is **uncontrolled by default and controlled when the app supplies a
+ * value** — the standard React pattern. The same callbacks fire either way, so
+ * a consumer can move between the two without rewriting handlers.
+ */
+
+export function sameSelection(a, b) {
+  if (!a || !b) {
+    return !a && !b;
+  }
+  return a.seriesId === b.seriesId && a.pointId === b.pointId;
+}
+//# sourceMappingURL=interaction.js.map

package/lib/module/contract/interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["sameSelection","a","b","seriesId","pointId"],"sourceRoot":"../../../src","sources":["contract/interaction.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAoDA,OAAO,SAASA,aAAaA,CAC5BC,CAAkC,EAClCC,CAAkC,EACxB;EACV,IAAI,CAACD,CAAC,IAAI,CAACC,CAAC,EAAE;IACb,OAAO,CAACD,CAAC,IAAI,CAACC,CAAC;EAChB;EACA,OAAOD,CAAC,CAACE,QAAQ,KAAKD,CAAC,CAACC,QAAQ,IAAIF,CAAC,CAACG,OAAO,KAAKF,CAAC,CAACE,OAAO;AAC5D","ignoreList":[]}

package/lib/module/contract/marker.js

@@ -0,0 +1,49 @@
+"use strict";
+
+/**
+ * Reference markers: targets, baselines, and thresholds (FR-008, FR-021, FR-022).
+ *
+ * The important rule lives here: a marker whose value is not `known`, or whose
+ * target is zero or negative, produces **no completion proportion**. A chart
+ * shows the current value alone rather than inventing a percentage.
+ */
+
+import { isKnown } from "./value.js";
+/**
+ * A target only supports a proportion when it is known and strictly positive.
+ * Zero and negative targets make "percent complete" meaningless, so we decline
+ * to compute one rather than divide and produce a nonsense figure.
+ */
+export function isUsableTarget(marker) {
+  if (!marker || marker.kind !== 'target') {
+    return false;
+  }
+  return isKnown(marker.value) && marker.value.value > 0;
+}
+export function readProgress(current, target) {
+  if (!isKnown(current) || !isUsableTarget(target) || !target) {
+    return {
+      current,
+      target,
+      proportion: undefined,
+      overshoot: false
+    };
+  }
+
+  // isUsableTarget already proved the target is known and positive.
+  const targetValue = target.value.value;
+  const proportion = current.value / targetValue;
+  return {
+    current,
+    target,
+    proportion,
+    overshoot: proportion > 1
+  };
+}
+export function findTarget(markers, id) {
+  if (!markers) {
+    return undefined;
+  }
+  return markers.find(m => m.kind === 'target' && (!id || m.id === id));
+}
+//# sourceMappingURL=marker.js.map

package/lib/module/contract/marker.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isKnown","isUsableTarget","marker","kind","value","readProgress","current","target","proportion","undefined","overshoot","targetValue","findTarget","markers","id","find","m"],"sourceRoot":"../../../src","sources":["contract/marker.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,OAAO,QAAyB,YAAS;AAYlD;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAACC,MAAmC,EAAW;EAC5E,IAAI,CAACA,MAAM,IAAIA,MAAM,CAACC,IAAI,KAAK,QAAQ,EAAE;IACxC,OAAO,KAAK;EACb;EACA,OAAOH,OAAO,CAACE,MAAM,CAACE,KAAK,CAAC,IAAIF,MAAM,CAACE,KAAK,CAACA,KAAK,GAAG,CAAC;AACvD;AAgBA,OAAO,SAASC,YAAYA,CAC3BC,OAAmB,EACnBC,MAAmC,EACjB;EAClB,IAAI,CAACP,OAAO,CAACM,OAAO,CAAC,IAAI,CAACL,cAAc,CAACM,MAAM,CAAC,IAAI,CAACA,MAAM,EAAE;IAC5D,OAAO;MAAED,OAAO;MAAEC,MAAM;MAAEC,UAAU,EAAEC,SAAS;MAAEC,SAAS,EAAE;IAAM,CAAC;EACpE;;EAEA;EACA,MAAMC,WAAW,GAAIJ,MAAM,CAACH,KAAK,CAAuBA,KAAK;EAC7D,MAAMI,UAAU,GAAGF,OAAO,CAACF,KAAK,GAAGO,WAAW;EAE9C,OAAO;IACNL,OAAO;IACPC,MAAM;IACNC,UAAU;IACVE,SAAS,EAAEF,UAAU,GAAG;EACzB,CAAC;AACF;AAEA,OAAO,SAASI,UAAUA,CACzBC,OAA+C,EAC/CC,EAAW,EACmB;EAC9B,IAAI,CAACD,OAAO,EAAE;IACb,OAAOJ,SAAS;EACjB;EACA,OAAOI,OAAO,CAACE,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACb,IAAI,KAAK,QAAQ,KAAK,CAACW,EAAE,IAAIE,CAAC,CAACF,EAAE,KAAKA,EAAE,CAAC,CAAC;AACtE","ignoreList":[]}

package/lib/module/contract/props.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=props.js.map

package/lib/module/contract/props.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["contract/props.ts"],"mappings":"","ignoreList":[]}