@chipmobilesdk/rn-chart 0.3.0 → 0.5.0

package/lib/commonjs/render/Marks.js

@@ -0,0 +1,184 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.GeometryLabels = GeometryLabels;
+exports.MarkerLines = MarkerLines;
+exports.Marks = Marks;
+exports.NonValueTextures = NonValueTextures;
+exports.SelectionHighlight = SelectionHighlight;
+exports.dashArrayFor = dashArrayFor;
+var _react = _interopRequireDefault(require("react"));
+var _reactNativeSvg = require("react-native-svg");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * Private SVG adapter for resolved geometry.
+ *
+ * Everything here consumes plain data produced by `geometry/`. Swapping the
+ * drawing substrate means rewriting this directory and nothing else.
+ */
+
+/**
+ * Dash patterns give series a second, non-colour identity (FR-064). `undefined`
+ * means a solid stroke.
+ */
+function dashArrayFor(pattern) {
+  switch (pattern) {
+    case 'dashed':
+      return '6,4';
+    case 'dotted':
+      return '1,4';
+    case 'dashDot':
+      return '8,3,1,3';
+    default:
+      return undefined;
+  }
+}
+const TEXTURE_IDS = {
+  gap: 'rnchart-texture-gap',
+  hatch: 'rnchart-texture-hatch',
+  lockedHatch: 'rnchart-texture-locked'
+};
+
+/**
+ * Texture definitions for the three non-value classes.
+ *
+ * Deliberately shape-based rather than colour-based: a reader in greyscale, or
+ * with reduced colour perception, must still tell a gap from a hatch from a
+ * locked cell (FR-064, SC-012).
+ */
+function NonValueTextures({
+  theme
+}) {
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNativeSvg.Defs, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNativeSvg.Pattern, {
+      id: TEXTURE_IDS.gap,
+      patternUnits: "userSpaceOnUse",
+      width: "6",
+      height: "6",
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Rect, {
+        width: "6",
+        height: "6",
+        fill: theme.surface
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Rect, {
+        x: "2",
+        y: "2",
+        width: "1.5",
+        height: "1.5",
+        fill: theme.muted
+      })]
+    }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNativeSvg.Pattern, {
+      id: TEXTURE_IDS.hatch,
+      patternUnits: "userSpaceOnUse",
+      width: "8",
+      height: "8",
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Rect, {
+        width: "8",
+        height: "8",
+        fill: theme.surface
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Path, {
+        d: "M0 8L8 0",
+        stroke: theme.muted,
+        strokeWidth: "1"
+      })]
+    }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNativeSvg.Pattern, {
+      id: TEXTURE_IDS.lockedHatch,
+      patternUnits: "userSpaceOnUse",
+      width: "8",
+      height: "8",
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Rect, {
+        width: "8",
+        height: "8",
+        fill: theme.surface
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Path, {
+        d: "M0 8L8 0M0 0L8 8",
+        stroke: theme.muted,
+        strokeWidth: "1"
+      })]
+    })]
+  });
+}
+function fillFor(mark) {
+  if (mark.texture) {
+    return `url(#${TEXTURE_IDS[mark.texture]})`;
+  }
+  return mark.filled ? mark.color : 'none';
+}
+function Marks({
+  paths
+}) {
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.G, {
+    children: paths.map(mark => {
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Path, {
+        d: mark.d,
+        fill: fillFor(mark),
+        stroke: mark.filled ? 'none' : mark.color,
+        strokeWidth: mark.filled ? 0 : 2,
+        strokeDasharray: mark.filled ? undefined : dashArrayFor(mark.pattern),
+        strokeLinejoin: "round",
+        strokeLinecap: "round",
+        opacity: mark.opacity ?? 1
+      }, mark.key);
+    })
+  });
+}
+function MarkerLines({
+  markers,
+  theme
+}) {
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.G, {
+    children: markers.map(marker => /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Path, {
+      d: marker.d,
+      stroke: theme.onSurface,
+      strokeWidth: 1,
+      strokeDasharray: "4,3",
+      fill: "none"
+    }, marker.id))
+  });
+}
+function GeometryLabels({
+  labels,
+  theme,
+  fontSize
+}) {
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.G, {
+    children: labels.filter(label => !label.muted).map(label => /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Text, {
+      x: label.x,
+      y: label.y,
+      fill: theme.typography.valueLabel.color,
+      fontSize: fontSize,
+      fontWeight: theme.typography.valueLabel.fontWeight,
+      textAnchor: label.anchor,
+      children: label.text
+    }, label.key))
+  });
+}
+
+/** Marks the currently selected point, when it still resolves. */
+function SelectionHighlight({
+  x,
+  y,
+  color
+}) {
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNativeSvg.G, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Rect, {
+      x: x - 6,
+      y: y - 6,
+      width: 12,
+      height: 12,
+      rx: 6,
+      fill: color,
+      opacity: 0.25
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeSvg.Rect, {
+      x: x - 3,
+      y: y - 3,
+      width: 6,
+      height: 6,
+      rx: 3,
+      fill: color
+    })]
+  });
+}
+//# sourceMappingURL=Marks.js.map

package/lib/commonjs/render/Marks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireDefault","require","_reactNativeSvg","_jsxRuntime","e","__esModule","default","dashArrayFor","pattern","undefined","TEXTURE_IDS","gap","hatch","lockedHatch","NonValueTextures","theme","jsxs","Defs","children","Pattern","id","patternUnits","width","height","jsx","Rect","fill","surface","x","y","muted","Path","d","stroke","strokeWidth","fillFor","mark","texture","filled","color","Marks","paths","G","map","strokeDasharray","strokeLinejoin","strokeLinecap","opacity","key","MarkerLines","markers","marker","onSurface","GeometryLabels","labels","fontSize","filter","label","Text","typography","valueLabel","fontWeight","textAnchor","anchor","text","SelectionHighlight","rx"],"sourceRoot":"../../../src","sources":["render/Marks.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/validation/budgets.js

@@ -0,0 +1,106 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DATASET_BUDGETS = void 0;
+exports.__resetBudgetWarnings = __resetBudgetWarnings;
+exports.checkBudget = checkBudget;
+exports.releaseBudgetWarning = releaseBudgetWarning;
+exports.warnIfOverBudget = warnIfOverBudget;
+var _rnCore = require("@chipmobilesdk/rn-core");
+/**
+ * Dataset budgets (FR-074, FR-075, FR-076).
+ *
+ * Over budget, the chart **still renders**. Degrading silently would break the
+ * "never present a reduced picture as complete" rule, and refusing to draw
+ * would turn a performance hint into an outage. Instead we warn the developer
+ * once, in dev builds only.
+ *
+ * The `__DEV__` gate matters: it makes the check dead code that Metro strips
+ * from release bundles, which is what makes "never in production" verifiable
+ * rather than merely intended.
+ *
+ * The figures were validated against emitted element counts in
+ * specs/007-rn-chart-package/research.md R2 — element count scales with series,
+ * not with points, so these budgets are about JS work rather than view count.
+ */
+
+const DATASET_BUDGETS = exports.DATASET_BUDGETS = {
+  timeSeries: {
+    maxSeries: 5,
+    maxPointsPerSeries: 500
+  },
+  bar: {
+    maxSeries: 5,
+    maxPointsPerSeries: 60
+  },
+  distribution: {
+    maxSeries: 1,
+    maxPointsPerSeries: 12
+  },
+  progress: {
+    maxSeries: 1,
+    maxPointsPerSeries: 8
+  },
+  heatmap: {
+    maxSeries: 1,
+    maxCells: 1000
+  }
+};
+function checkBudget(datasource, family) {
+  const budget = DATASET_BUDGETS[family];
+  const seriesCount = datasource.series.length;
+  let maxPoints = 0;
+  let totalPoints = 0;
+  for (const series of datasource.series) {
+    maxPoints = Math.max(maxPoints, series.points.length);
+    totalPoints += series.points.length;
+  }
+  const overSeries = seriesCount > budget.maxSeries;
+  const overPoints = budget.maxPointsPerSeries !== undefined && maxPoints > budget.maxPointsPerSeries;
+  const overCells = budget.maxCells !== undefined && totalPoints > budget.maxCells;
+  return {
+    withinBudget: !overSeries && !overPoints && !overCells,
+    seriesCount,
+    maxPointsInAnySeries: maxPoints,
+    totalPoints
+  };
+}
+const warnedCharts = new Set();
+
+/** Chart diagnostics also reach the app's SDK sinks (`installSdkSink`, CORE-08). */
+const channel = (0, _rnCore.createDiagnosticChannel)('rn-chart');
+
+/**
+ * Warns once per chart instance per mount. De-duplicating matters: a scrolling
+ * dashboard would otherwise flood the console on every frame.
+ */
+function warnIfOverBudget(datasource, family, instanceKey) {
+  // Counting the dataset is dev work too: a release build skips it entirely.
+  if (!__DEV__ || warnedCharts.has(instanceKey)) {
+    return;
+  }
+  const check = checkBudget(datasource, family);
+  if (!check.withinBudget) {
+    warnedCharts.add(instanceKey);
+    channel.emit('over_budget', 'warn', {
+      family,
+      series: check.seriesCount,
+      maxPoints: check.maxPointsInAnySeries
+    });
+    const budget = DATASET_BUDGETS[family];
+    console.warn(`[rn-chart] ${family} chart "${instanceKey}" exceeds its documented dataset budget ` + `(${check.seriesCount} series x up to ${check.maxPointsInAnySeries} points; ` + `budget is ${budget.maxSeries} series` + (budget.maxPointsPerSeries ? ` x ${budget.maxPointsPerSeries} points` : '') + (budget.maxCells ? `, ${budget.maxCells} cells` : '') + '). The chart still renders and drops nothing — aggregate or downsample ' + 'upstream if it feels slow. This warning appears once per chart and never ' + 'in production builds.');
+  }
+}
+
+/** Called on unmount so a remounted chart can warn again. */
+function releaseBudgetWarning(instanceKey) {
+  warnedCharts.delete(instanceKey);
+}
+
+/** Test-only reset. */
+function __resetBudgetWarnings() {
+  warnedCharts.clear();
+}
+//# sourceMappingURL=budgets.js.map

package/lib/commonjs/validation/budgets.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_rnCore","require","DATASET_BUDGETS","exports","timeSeries","maxSeries","maxPointsPerSeries","bar","distribution","progress","heatmap","maxCells","checkBudget","datasource","family","budget","seriesCount","series","length","maxPoints","totalPoints","Math","max","points","overSeries","overPoints","undefined","overCells","withinBudget","maxPointsInAnySeries","warnedCharts","Set","channel","createDiagnosticChannel","warnIfOverBudget","instanceKey","__DEV__","has","check","add","emit","console","warn","releaseBudgetWarning","delete","__resetBudgetWarnings","clear"],"sourceRoot":"../../../src","sources":["validation/budgets.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/validation/validateDatasource.js

@@ -0,0 +1,189 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.validateDatasource = validateDatasource;
+var _datasource = require("../contract/datasource.js");
+var _distribution = require("../contract/distribution.js");
+var _errors = require("../contract/errors.js");
+var _value = require("../contract/value.js");
+/**
+ * Datasource validation (FR-015, FR-017, FR-007a).
+ *
+ * Rules V1-V8 from specs/007-rn-chart-package/data-model.md §6. Every failure
+ * returns a `ChartError` built from the fixed message catalogue, so validation
+ * output can never carry a data value or a series label.
+ *
+ * Note V8: an empty datasource is **not** an error. It resolves to the empty
+ * state, which is a first-class outcome rather than a failure.
+ */
+
+function validateDatasource(datasource, family, chartId, /** What a distribution's values mean, when the app says; inferred otherwise. */
+distributionValues) {
+  const base = {
+    isEmpty: true,
+    isPartial: false,
+    totalIncomplete: false
+  };
+
+  // V4 — the receiving family must accept the declared position kind. Checked
+  // first because a mismatch here makes everything downstream meaningless.
+  if (!(0, _datasource.familyAcceptsPositionKind)(family, datasource.positionKind)) {
+    return {
+      ...base,
+      isEmpty: false,
+      error: (0, _errors.validationError)('familyPositionKindUnsupported', {
+        chartId,
+        family,
+        detail: {
+          actualKind: datasource.positionKind
+        }
+      })
+    };
+  }
+
+  // V1 — series ids unique.
+  const seenSeriesIds = new Set();
+  for (const series of datasource.series) {
+    if (seenSeriesIds.has(series.id)) {
+      return {
+        ...base,
+        isEmpty: false,
+        error: (0, _errors.validationError)('duplicateSeriesId', {
+          chartId,
+          family,
+          detail: {
+            occurrences: seenSeriesIds.size
+          }
+        })
+      };
+    }
+    seenSeriesIds.add(series.id);
+  }
+  let totalPoints = 0;
+  let knownPoints = 0;
+  const matrixRows = new Set();
+  const matrixColumns = new Set();
+  for (const series of datasource.series) {
+    // V2 — point ids unique within their series.
+    const seenPointIds = new Set();
+    for (const point of series.points) {
+      if (seenPointIds.has(point.id)) {
+        return {
+          ...base,
+          isEmpty: false,
+          error: (0, _errors.validationError)('duplicatePointId', {
+            chartId,
+            family,
+            detail: {
+              occurrences: seenPointIds.size
+            }
+          })
+        };
+      }
+      seenPointIds.add(point.id);
+
+      // V3 — every point matches the declared position kind.
+      if (point.position.kind !== datasource.positionKind) {
+        return {
+          ...base,
+          isEmpty: false,
+          error: (0, _errors.validationError)('positionKindMismatch', {
+            chartId,
+            family,
+            detail: {
+              expectedKind: datasource.positionKind,
+              actualKind: point.position.kind
+            }
+          })
+        };
+      }
+      if (point.position.kind === 'matrix') {
+        matrixRows.add(point.position.row);
+        matrixColumns.add(point.position.column);
+      }
+
+      // V9 — a known value is a finite number, and so is an instant. NaN or
+      // Infinity used to be drawn at the origin without a word (CHT-10).
+      const finite = (!(0, _value.isKnown)(point.value) || Number.isFinite(point.value.value)) && (point.position.kind !== 'instant' || Number.isFinite(point.position.at));
+      if (!finite) {
+        return {
+          ...base,
+          isEmpty: false,
+          error: (0, _errors.validationError)('nonFiniteValue', {
+            chartId,
+            family
+          })
+        };
+      }
+      // V10 — a share of a whole cannot be negative.
+      if (family === 'distribution' && (0, _value.isKnown)(point.value) && point.value.value < 0) {
+        return {
+          ...base,
+          isEmpty: false,
+          error: (0, _errors.validationError)('negativeDistributionValue', {
+            chartId,
+            family
+          })
+        };
+      }
+      totalPoints += 1;
+      if ((0, _value.isKnown)(point.value)) {
+        knownPoints += 1;
+      }
+    }
+  }
+
+  // V5 — a matrix must be rectangular: every row/column pair accounted for.
+  if (datasource.positionKind === 'matrix' && totalPoints > 0) {
+    const expected = matrixRows.size * matrixColumns.size;
+    if (totalPoints !== expected) {
+      return {
+        ...base,
+        isEmpty: false,
+        error: (0, _errors.validationError)('inconsistentMatrix', {
+          chartId,
+          family,
+          detail: {
+            occurrences: Math.abs(expected - totalPoints)
+          }
+        })
+      };
+    }
+  }
+
+  // V6 — distribution segments that do not sum to the whole are flagged, never
+  // rescaled. This is a flag rather than a rejection: the chart still renders
+  // and marks the total incomplete.
+  let totalIncomplete = knownPoints < totalPoints;
+  if (family === 'distribution' && totalPoints > 0) {
+    totalIncomplete = totalIncomplete || !distributionSumsToWhole(datasource, distributionValues);
+  }
+  return {
+    isEmpty: totalPoints === 0,
+    isPartial: totalPoints > 0 && knownPoints > 0 && knownPoints < totalPoints,
+    totalIncomplete
+  };
+}
+
+/**
+ * Only proportions can be checked for wholeness, and only when every point is
+ * known. Absolute values are a whole by definition once they sum to something.
+ */
+function distributionSumsToWhole(datasource, declared) {
+  let sum = 0;
+  for (const series of datasource.series) {
+    for (const point of series.points) {
+      if (!(0, _value.isKnown)(point.value)) {
+        return false;
+      }
+      sum += point.value.value;
+    }
+  }
+  if ((0, _distribution.resolveDistributionValues)(datasource, declared) === 'absolute') {
+    return sum > 0;
+  }
+  return Math.abs(sum - 1) <= _distribution.DISTRIBUTION_SUM_TOLERANCE;
+}
+//# sourceMappingURL=validateDatasource.js.map

package/lib/commonjs/validation/validateDatasource.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_datasource","require","_distribution","_errors","_value","validateDatasource","datasource","family","chartId","distributionValues","base","isEmpty","isPartial","totalIncomplete","familyAcceptsPositionKind","positionKind","error","validationError","detail","actualKind","seenSeriesIds","Set","series","has","id","occurrences","size","add","totalPoints","knownPoints","matrixRows","matrixColumns","seenPointIds","point","points","position","kind","expectedKind","row","column","finite","isKnown","value","Number","isFinite","at","expected","Math","abs","distributionSumsToWhole","declared","sum","resolveDistributionValues","DISTRIBUTION_SUM_TOLERANCE"],"sourceRoot":"../../../src","sources":["validation/validateDatasource.ts"],"mappings":"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","ignoreList":[]}