@chipmobilesdk/rn-chart 0.3.0 → 0.5.0

package/lib/commonjs/contract/format.js

@@ -0,0 +1,133 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NON_VALUE_TEXT = void 0;
+exports.__resetFormatterWarnings = __resetFormatterWarnings;
+exports.formatLegendDefault = formatLegendDefault;
+exports.formatPositionDefault = formatPositionDefault;
+exports.formatValueDefault = formatValueDefault;
+exports.safeFormat = safeFormat;
+exports.seriesRef = seriesRef;
+var _rnCore = require("@chipmobilesdk/rn-core");
+var _value = require("./value.js");
+/**
+ * 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.
+ */
+
+/** Chart diagnostics also reach the app's SDK sinks (`installSdkSink`, CORE-08). */
+const channel = (0, _rnCore.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.
+ */
+const NON_VALUE_TEXT = exports.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.
+ */
+function formatValueDefault(v, ctx = {
+  slot: 'value'
+}) {
+  if (!(0, _value.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));
+  }
+}
+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);
+  }
+}
+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.
+ */
+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. */
+function __resetFormatterWarnings() {
+  warnedFormatters.clear();
+}
+function seriesRef(series) {
+  return {
+    id: series.id,
+    label: series.label
+  };
+}
+//# sourceMappingURL=format.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_rnCore","require","_value","channel","createDiagnosticChannel","NON_VALUE_TEXT","exports","unknown","notApplicable","withheld","trimTrailingZeros","text","includes","replace","formatValueDefault","v","ctx","slot","isKnown","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/commonjs/contract/interaction.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.sameSelection = sameSelection;
+/**
+ * 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.
+ */
+
+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/commonjs/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;;AAoDO,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/commonjs/contract/marker.js

@@ -0,0 +1,55 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.findTarget = findTarget;
+exports.isUsableTarget = isUsableTarget;
+exports.readProgress = readProgress;
+var _value = require("./value.js");
+/**
+ * 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.
+ */
+
+/**
+ * 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.
+ */
+function isUsableTarget(marker) {
+  if (!marker || marker.kind !== 'target') {
+    return false;
+  }
+  return (0, _value.isKnown)(marker.value) && marker.value.value > 0;
+}
+function readProgress(current, target) {
+  if (!(0, _value.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
+  };
+}
+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/commonjs/contract/marker.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_value","require","isUsableTarget","marker","kind","isKnown","value","readProgress","current","target","proportion","undefined","overshoot","targetValue","findTarget","markers","id","find","m"],"sourceRoot":"../../../src","sources":["contract/marker.ts"],"mappings":";;;;;;;;AAQA,IAAAA,MAAA,GAAAC,OAAA;AARA;AACA;AACA;AACA;AACA;AACA;AACA;;AAcA;AACA;AACA;AACA;AACA;AACO,SAASC,cAAcA,CAACC,MAAmC,EAAW;EAC5E,IAAI,CAACA,MAAM,IAAIA,MAAM,CAACC,IAAI,KAAK,QAAQ,EAAE;IACxC,OAAO,KAAK;EACb;EACA,OAAO,IAAAC,cAAO,EAACF,MAAM,CAACG,KAAK,CAAC,IAAIH,MAAM,CAACG,KAAK,CAACA,KAAK,GAAG,CAAC;AACvD;AAgBO,SAASC,YAAYA,CAC3BC,OAAmB,EACnBC,MAAmC,EACjB;EAClB,IAAI,CAAC,IAAAJ,cAAO,EAACG,OAAO,CAAC,IAAI,CAACN,cAAc,CAACO,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;AAEO,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,CAACd,IAAI,KAAK,QAAQ,KAAK,CAACY,EAAE,IAAIE,CAAC,CAACF,EAAE,KAAKA,EAAE,CAAC,CAAC;AACtE","ignoreList":[]}

package/lib/commonjs/contract/props.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=props.js.map

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

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

package/lib/commonjs/contract/state.js

@@ -0,0 +1,68 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.STATUS_PRECEDENCE = void 0;
+exports.drawsData = drawsData;
+exports.resolveStatus = resolveStatus;
+exports.suppressesInteraction = suppressesInteraction;
+/**
+ * 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
+ */
+
+/** The statuses an app may declare. `empty` and `partial` are derived. */
+
+/**
+ * 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.
+ */
+const STATUS_PRECEDENCE = exports.STATUS_PRECEDENCE = ['noPermission', 'error', 'loading', 'empty', 'stale', 'partial', 'ready'];
+function resolveStatus(inputs) {
+  const candidates = new Set(['ready']);
+  if (inputs.declared) {
+    candidates.add(inputs.declared);
+  }
+  if (inputs.error) {
+    candidates.add('error');
+  }
+  if (inputs.isEmpty) {
+    candidates.add('empty');
+  }
+  if (inputs.isPartial) {
+    candidates.add('partial');
+  }
+  for (const status of STATUS_PRECEDENCE) {
+    if (candidates.has(status)) {
+      return status;
+    }
+  }
+  return 'ready';
+}
+
+/** Statuses in which the chart draws its data (possibly with an indicator). */
+function drawsData(status) {
+  return status === 'ready' || status === 'stale' || status === 'partial';
+}
+
+/**
+ * Statuses in which no data-selection callback may fire, because the chart is
+ * not displaying the values a callback would carry (FR-053).
+ */
+function suppressesInteraction(status) {
+  return !drawsData(status);
+}
+
+/** Per-status content the app supplies, replacing any package wording (FR-035). */
+//# sourceMappingURL=state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["STATUS_PRECEDENCE","exports","resolveStatus","inputs","candidates","Set","declared","add","error","isEmpty","isPartial","status","has","drawsData","suppressesInteraction"],"sourceRoot":"../../../src","sources":["contract/state.ts"],"mappings":";;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,iBAAyC,GAAAC,OAAA,CAAAD,iBAAA,GAAG,CACxD,cAAc,EACd,OAAO,EACP,SAAS,EACT,OAAO,EACP,OAAO,EACP,SAAS,EACT,OAAO,CACP;AAaM,SAASE,aAAaA,CAACC,MAAoB,EAAe;EAChE,MAAMC,UAAU,GAAG,IAAIC,GAAG,CAAc,CAAC,OAAO,CAAC,CAAC;EAElD,IAAIF,MAAM,CAACG,QAAQ,EAAE;IACpBF,UAAU,CAACG,GAAG,CAACJ,MAAM,CAACG,QAAQ,CAAC;EAChC;EACA,IAAIH,MAAM,CAACK,KAAK,EAAE;IACjBJ,UAAU,CAACG,GAAG,CAAC,OAAO,CAAC;EACxB;EACA,IAAIJ,MAAM,CAACM,OAAO,EAAE;IACnBL,UAAU,CAACG,GAAG,CAAC,OAAO,CAAC;EACxB;EACA,IAAIJ,MAAM,CAACO,SAAS,EAAE;IACrBN,UAAU,CAACG,GAAG,CAAC,SAAS,CAAC;EAC1B;EAEA,KAAK,MAAMI,MAAM,IAAIX,iBAAiB,EAAE;IACvC,IAAII,UAAU,CAACQ,GAAG,CAACD,MAAM,CAAC,EAAE;MAC3B,OAAOA,MAAM;IACd;EACD;EACA,OAAO,OAAO;AACf;;AAEA;AACO,SAASE,SAASA,CAACF,MAAmB,EAAW;EACvD,OAAOA,MAAM,KAAK,OAAO,IAAIA,MAAM,KAAK,OAAO,IAAIA,MAAM,KAAK,SAAS;AACxE;;AAEA;AACA;AACA;AACA;AACO,SAASG,qBAAqBA,CAACH,MAAmB,EAAW;EACnE,OAAO,CAACE,SAAS,CAACF,MAAM,CAAC;AAC1B;;AAEA","ignoreList":[]}

package/lib/commonjs/contract/strings.js

@@ -0,0 +1,54 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.chartStrings = void 0;
+var _rnCore = require("@chipmobilesdk/rn-core");
+/**
+ * Every text the package itself speaks or shows (CHT-05): screen-reader
+ * summaries and announcements, adjustable-action labels, built-in state text and
+ * legend hints. English defaults; an app translates them by passing `strings`
+ * (or by registering `chartStrings.user` with rn-i18n and passing the translated
+ * texts). `{name}` marks a variable.
+ */
+
+const chartStrings = exports.chartStrings = (0, _rnCore.defineMessages)({
+  user: {
+    'chart.family.progress': 'progress chart',
+    'chart.family.distribution': 'distribution chart',
+    'chart.family.timeSeries': 'time series chart',
+    'chart.family.bar': 'bar chart',
+    'chart.family.heatmap': 'heatmap',
+    'chart.status.loading': 'Loading data.',
+    'chart.status.empty': 'No data yet.',
+    'chart.status.error': 'Data could not be shown.',
+    'chart.status.stale': 'Showing data that may be out of date.',
+    'chart.status.noPermission': 'This data is not available to you.',
+    'chart.status.partial': 'Some data is missing.',
+    'chart.summary.heading': '{title}, {noun}.',
+    'chart.summary.headingUntitled': '{noun}.',
+    'chart.summary.scale': '{series} series, {points} points.',
+    'chart.summary.scaleSingle': '{points} points.',
+    'chart.summary.single': 'Value {value}.',
+    'chart.summary.extremes': 'Highest {maxLabel} at {max}. Lowest {minLabel} at {min}.',
+    'chart.summary.marker': '{name} {value}',
+    'chart.summary.incomplete': 'Some values are missing, so totals are incomplete.',
+    'chart.point.withheld': '{position}, {series}, not available.',
+    'chart.point.noData': '{position}, {series}, no data.',
+    'chart.point.value': '{position}, {series}, {value}.',
+    'chart.total': 'Total {value}.',
+    'chart.total.incomplete': 'Total {value}, excluding {count} values that are not available.',
+    'chart.action.next': 'Next data point',
+    'chart.action.previous': 'Previous data point',
+    'chart.state.loading': 'Loading…',
+    'chart.state.empty': 'No data yet',
+    'chart.state.error': 'Unable to show this chart',
+    'chart.state.noPermission': 'Not available',
+    'chart.legend.hide': 'Hides this series',
+    'chart.legend.show': 'Shows this series',
+    'chart.legend.scale': 'Colour scale from {min} to {max}',
+    'chart.note.incomplete': 'Some values are unavailable, so totals are incomplete.'
+  }
+});
+//# sourceMappingURL=strings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_rnCore","require","chartStrings","exports","defineMessages","user"],"sourceRoot":"../../../src","sources":["contract/strings.ts"],"mappings":";;;;;;AAOA,IAAAA,OAAA,GAAAC,OAAA;AAPA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGO,MAAMC,YAAY,GAAAC,OAAA,CAAAD,YAAA,GAAG,IAAAE,sBAAc,EAAC;EAC1CC,IAAI,EAAE;IACL,uBAAuB,EAAE,gBAAgB;IACzC,2BAA2B,EAAE,oBAAoB;IACjD,yBAAyB,EAAE,mBAAmB;IAC9C,kBAAkB,EAAE,WAAW;IAC/B,sBAAsB,EAAE,SAAS;IACjC,sBAAsB,EAAE,eAAe;IACvC,oBAAoB,EAAE,cAAc;IACpC,oBAAoB,EAAE,0BAA0B;IAChD,oBAAoB,EAAE,uCAAuC;IAC7D,2BAA2B,EAAE,oCAAoC;IACjE,sBAAsB,EAAE,uBAAuB;IAC/C,uBAAuB,EAAE,kBAAkB;IAC3C,+BAA+B,EAAE,SAAS;IAC1C,qBAAqB,EAAE,mCAAmC;IAC1D,2BAA2B,EAAE,kBAAkB;IAC/C,sBAAsB,EAAE,gBAAgB;IACxC,wBAAwB,EAAE,0DAA0D;IACpF,sBAAsB,EAAE,gBAAgB;IACxC,0BAA0B,EAAE,oDAAoD;IAChF,sBAAsB,EAAE,sCAAsC;IAC9D,oBAAoB,EAAE,gCAAgC;IACtD,mBAAmB,EAAE,gCAAgC;IACrD,aAAa,EAAE,gBAAgB;IAC/B,wBAAwB,EAAE,iEAAiE;IAC3F,mBAAmB,EAAE,iBAAiB;IACtC,uBAAuB,EAAE,qBAAqB;IAC9C,qBAAqB,EAAE,UAAU;IACjC,mBAAmB,EAAE,aAAa;IAClC,mBAAmB,EAAE,2BAA2B;IAChD,0BAA0B,EAAE,eAAe;IAC3C,mBAAmB,EAAE,mBAAmB;IACxC,mBAAmB,EAAE,mBAAmB;IACxC,oBAAoB,EAAE,kCAAkC;IACxD,uBAAuB,EAAE;EAC1B;AACD,CAAC,CAAC","ignoreList":[]}

package/lib/commonjs/contract/theme.js

@@ -0,0 +1,116 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.defaultChartTheme = defaultChartTheme;
+exports.resolveSegmentColors = resolveSegmentColors;
+exports.resolveSeriesColor = resolveSeriesColor;
+exports.segmentKey = segmentKey;
+/**
+ * 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).
+ */
+
+/** How the three non-value classes are drawn: texture, never a hue difference. */
+
+/**
+ * Eight categorical colours per scheme.
+ *
+ * Chosen for separation in hue *and* lightness, so they stay distinguishable
+ * under both common colour-vision deficiencies and a greyscale review. Colour
+ * is never the only carrier of meaning regardless — series also differ by
+ * legend label and, for lines, by dash pattern.
+ */
+const LIGHT_PALETTE = ['#2563EB', '#D97706', '#059669', '#DB2777', '#7C3AED', '#0891B2', '#B45309', '#4B5563'];
+const DARK_PALETTE = ['#60A5FA', '#FBBF24', '#34D399', '#F472B6', '#A78BFA', '#22D3EE', '#FCD34D', '#9CA3AF'];
+const NON_VALUE_TEXTURES = {
+  unknown: 'gap',
+  notApplicable: 'hatch',
+  withheld: 'lockedHatch'
+};
+function defaultChartTheme(colorScheme = 'light') {
+  const dark = colorScheme === 'dark';
+  const onSurface = dark ? '#F3F4F6' : '#111827';
+  const muted = dark ? '#9CA3AF' : '#6B7280';
+  return {
+    colorScheme,
+    palette: dark ? DARK_PALETTE : LIGHT_PALETTE,
+    surface: dark ? '#111827' : '#FFFFFF',
+    onSurface,
+    axis: dark ? '#4B5563' : '#D1D5DB',
+    grid: dark ? '#374151' : '#E5E7EB',
+    muted,
+    typography: {
+      axisLabel: {
+        fontSize: 11,
+        fontWeight: '400',
+        color: muted
+      },
+      legendLabel: {
+        fontSize: 12,
+        fontWeight: '500',
+        color: onSurface
+      },
+      valueLabel: {
+        fontSize: 13,
+        fontWeight: '600',
+        color: onSurface
+      }
+    },
+    spacing: {
+      xs: 4,
+      sm: 8,
+      md: 16
+    },
+    radius: {
+      bar: 3,
+      cell: 2
+    },
+    nonValue: NON_VALUE_TEXTURES,
+    heatmapRamp: dark ? ['#1F2937', '#1E3A8A', '#1D4ED8', '#3B82F6', '#93C5FD'] : ['#EFF6FF', '#BFDBFE', '#60A5FA', '#2563EB', '#1E3A8A']
+  };
+}
+
+/**
+ * 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).
+ */
+function resolveSeriesColor(theme, index, override) {
+  return override ?? theme.palette[index % theme.palette.length];
+}
+
+/** Key of one distribution segment: point ids are only unique within a series. */
+function segmentKey(seriesId, pointId) {
+  return `${seriesId}/${pointId}`;
+}
+
+/**
+ * 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.
+ */
+function resolveSegmentColors(datasource, theme) {
+  const colors = {};
+  let index = 0;
+  for (const series of datasource.series) {
+    for (const point of series.points) {
+      const override = point.color ?? (series.points.length === 1 ? series.color : undefined);
+      colors[segmentKey(series.id, point.id)] = resolveSeriesColor(theme, index, override);
+      index += 1;
+    }
+  }
+  return colors;
+}
+//# sourceMappingURL=theme.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["LIGHT_PALETTE","DARK_PALETTE","NON_VALUE_TEXTURES","unknown","notApplicable","withheld","defaultChartTheme","colorScheme","dark","onSurface","muted","palette","surface","axis","grid","typography","axisLabel","fontSize","fontWeight","color","legendLabel","valueLabel","spacing","xs","sm","md","radius","bar","cell","nonValue","heatmapRamp","resolveSeriesColor","theme","index","override","length","segmentKey","seriesId","pointId","resolveSegmentColors","datasource","colors","series","point","points","undefined","id"],"sourceRoot":"../../../src","sources":["contract/theme.ts"],"mappings":";;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA;;AA0CA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMA,aAAgC,GAAG,CACxC,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,CACT;AAED,MAAMC,YAA+B,GAAG,CACvC,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,CACT;AAED,MAAMC,kBAAkB,GAAG;EAC1BC,OAAO,EAAE,KAAK;EACdC,aAAa,EAAE,OAAO;EACtBC,QAAQ,EAAE;AACX,CAAU;AAEH,SAASC,iBAAiBA,CAACC,WAA6B,GAAG,OAAO,EAAc;EACtF,MAAMC,IAAI,GAAGD,WAAW,KAAK,MAAM;EAEnC,MAAME,SAAS,GAAGD,IAAI,GAAG,SAAS,GAAG,SAAS;EAC9C,MAAME,KAAK,GAAGF,IAAI,GAAG,SAAS,GAAG,SAAS;EAE1C,OAAO;IACND,WAAW;IACXI,OAAO,EAAEH,IAAI,GAAGP,YAAY,GAAGD,aAAa;IAC5CY,OAAO,EAAEJ,IAAI,GAAG,SAAS,GAAG,SAAS;IACrCC,SAAS;IACTI,IAAI,EAAEL,IAAI,GAAG,SAAS,GAAG,SAAS;IAClCM,IAAI,EAAEN,IAAI,GAAG,SAAS,GAAG,SAAS;IAClCE,KAAK;IACLK,UAAU,EAAE;MACXC,SAAS,EAAE;QAAEC,QAAQ,EAAE,EAAE;QAAEC,UAAU,EAAE,KAAK;QAAEC,KAAK,EAAET;MAAM,CAAC;MAC5DU,WAAW,EAAE;QAAEH,QAAQ,EAAE,EAAE;QAAEC,UAAU,EAAE,KAAK;QAAEC,KAAK,EAAEV;MAAU,CAAC;MAClEY,UAAU,EAAE;QAAEJ,QAAQ,EAAE,EAAE;QAAEC,UAAU,EAAE,KAAK;QAAEC,KAAK,EAAEV;MAAU;IACjE,CAAC;IACDa,OAAO,EAAE;MAAEC,EAAE,EAAE,CAAC;MAAEC,EAAE,EAAE,CAAC;MAAEC,EAAE,EAAE;IAAG,CAAC;IACjCC,MAAM,EAAE;MAAEC,GAAG,EAAE,CAAC;MAAEC,IAAI,EAAE;IAAE,CAAC;IAC3BC,QAAQ,EAAE3B,kBAAkB;IAC5B4B,WAAW,EAAEtB,IAAI,GACd,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,GACvD,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS;EAC1D,CAAC;AACF;;AAEA;AACA;AACA;AACA;AACO,SAASuB,kBAAkBA,CAACC,KAAiB,EAAEC,KAAa,EAAEC,QAAiB,EAAU;EAC/F,OAAOA,QAAQ,IAAIF,KAAK,CAACrB,OAAO,CAACsB,KAAK,GAAGD,KAAK,CAACrB,OAAO,CAACwB,MAAM,CAAC;AAC/D;;AAEA;AACO,SAASC,UAAUA,CAACC,QAAgB,EAAEC,OAAe,EAAU;EACrE,OAAO,GAAGD,QAAQ,IAAIC,OAAO,EAAE;AAChC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,oBAAoBA,CACnCC,UAMC,EACDR,KAAiB,EACQ;EACzB,MAAMS,MAA8B,GAAG,CAAC,CAAC;EACzC,IAAIR,KAAK,GAAG,CAAC;EACb,KAAK,MAAMS,MAAM,IAAIF,UAAU,CAACE,MAAM,EAAE;IACvC,KAAK,MAAMC,KAAK,IAAID,MAAM,CAACE,MAAM,EAAE;MAClC,MAAMV,QAAQ,GAAGS,KAAK,CAACxB,KAAK,KAAKuB,MAAM,CAACE,MAAM,CAACT,MAAM,KAAK,CAAC,GAAGO,MAAM,CAACvB,KAAK,GAAG0B,SAAS,CAAC;MACvFJ,MAAM,CAACL,UAAU,CAACM,MAAM,CAACI,EAAE,EAAEH,KAAK,CAACG,EAAE,CAAC,CAAC,GAAGf,kBAAkB,CAACC,KAAK,EAAEC,KAAK,EAAEC,QAAQ,CAAC;MACpFD,KAAK,IAAI,CAAC;IACX;EACD;EACA,OAAOQ,MAAM;AACd","ignoreList":[]}

package/lib/commonjs/contract/value.js

@@ -0,0 +1,112 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isKnown = isKnown;
+exports.isWithheld = isWithheld;
+exports.known = known;
+exports.notApplicable = notApplicable;
+exports.participatesInTotals = participatesInTotals;
+exports.sumKnown = sumKnown;
+exports.unknown = unknown;
+exports.withheld = withheld;
+/**
+ * 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`. */
+
+/** We do not know this value. Never rendered as zero, never interpolated. */
+
+/** This value does not apply here. Excluded from totals and proportions. */
+
+/** Hidden from this viewer: permission, or not enough data to disclose. */
+
+const UNKNOWN = {
+  kind: 'unknown'
+};
+const NOT_APPLICABLE = {
+  kind: 'notApplicable'
+};
+const WITHHELD = {
+  kind: 'withheld'
+};
+function known(value) {
+  return {
+    kind: 'known',
+    value
+  };
+}
+
+/**
+ * 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.
+ */
+function unknown() {
+  return UNKNOWN;
+}
+function notApplicable() {
+  return NOT_APPLICABLE;
+}
+function withheld() {
+  return WITHHELD;
+}
+function isKnown(v) {
+  return v.kind === 'known';
+}
+
+/**
+ * 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.
+ */
+function isWithheld(v) {
+  return v.kind === 'withheld';
+}
+
+/**
+ * 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).
+ */
+function participatesInTotals(v) {
+  return v.kind === 'known';
+}
+/**
+ * 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.
+ */
+function sumKnown(values) {
+  let total = 0;
+  let counted = 0;
+  let excluded = 0;
+  for (const v of values) {
+    if (v.kind === 'known') {
+      total += v.value;
+      counted += 1;
+    } else {
+      excluded += 1;
+    }
+  }
+  return {
+    total,
+    incomplete: excluded > 0,
+    countedPoints: counted,
+    excludedPoints: excluded
+  };
+}
+//# sourceMappingURL=value.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["UNKNOWN","kind","NOT_APPLICABLE","WITHHELD","known","value","unknown","notApplicable","withheld","isKnown","v","isWithheld","participatesInTotals","sumKnown","values","total","counted","excluded","incomplete","countedPoints","excludedPoints"],"sourceRoot":"../../../src","sources":["contract/value.ts"],"mappings":";;;;;;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAMA;;AAKA;;AAKA;;AASA,MAAMA,OAAqB,GAAG;EAAEC,IAAI,EAAE;AAAU,CAAC;AACjD,MAAMC,cAAkC,GAAG;EAAED,IAAI,EAAE;AAAgB,CAAC;AACpE,MAAME,QAAuB,GAAG;EAAEF,IAAI,EAAE;AAAW,CAAC;AAE7C,SAASG,KAAKA,CAACC,KAAa,EAAc;EAChD,OAAO;IAAEJ,IAAI,EAAE,OAAO;IAAEI;EAAM,CAAC;AAChC;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASC,OAAOA,CAAA,EAAiB;EACvC,OAAON,OAAO;AACf;AAEO,SAASO,aAAaA,CAAA,EAAuB;EACnD,OAAOL,cAAc;AACtB;AAEO,SAASM,QAAQA,CAAA,EAAkB;EACzC,OAAOL,QAAQ;AAChB;AAEO,SAASM,OAAOA,CAACC,CAAa,EAAmB;EACvD,OAAOA,CAAC,CAACT,IAAI,KAAK,OAAO;AAC1B;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASU,UAAUA,CAACD,CAAa,EAAsB;EAC7D,OAAOA,CAAC,CAACT,IAAI,KAAK,UAAU;AAC7B;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASW,oBAAoBA,CAACF,CAAa,EAAW;EAC5D,OAAOA,CAAC,CAACT,IAAI,KAAK,OAAO;AAC1B;AAUA;AACA;AACA;AACA;AACA;AACA;AACO,SAASY,QAAQA,CAACC,MAA6B,EAAe;EACpE,IAAIC,KAAK,GAAG,CAAC;EACb,IAAIC,OAAO,GAAG,CAAC;EACf,IAAIC,QAAQ,GAAG,CAAC;EAEhB,KAAK,MAAMP,CAAC,IAAII,MAAM,EAAE;IACvB,IAAIJ,CAAC,CAACT,IAAI,KAAK,OAAO,EAAE;MACvBc,KAAK,IAAIL,CAAC,CAACL,KAAK;MAChBW,OAAO,IAAI,CAAC;IACb,CAAC,MAAM;MACNC,QAAQ,IAAI,CAAC;IACd;EACD;EAEA,OAAO;IACNF,KAAK;IACLG,UAAU,EAAED,QAAQ,GAAG,CAAC;IACxBE,aAAa,EAAEH,OAAO;IACtBI,cAAc,EAAEH;EACjB,CAAC;AACF","ignoreList":[]}