@classic-homes/charts-core 0.4.0 → 0.4.2

package/dist/index.cjs

@@ -573,14 +573,39 @@ function generateDataTable(headers, rows) {
 }
 
 // src/utils/merge.ts
-var ALWAYS_REPLACE = ["series", "graphic"];
+var ALWAYS_REPLACE = ["graphic"];
 function countComponents(value) {
   if (value == null || value === false) return 0;
   if (Array.isArray(value)) return value.filter((item) => item != null).length;
   return 1;
 }
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function sameShape(a, b) {
+  if (!isRecord(a) || !isRecord(b)) return !isRecord(a) && !isRecord(b);
+  const keys = Object.keys(a).filter((key) => a[key] !== void 0);
+  const other = Object.keys(b).filter((key) => b[key] !== void 0);
+  if (keys.length !== other.length) return false;
+  return keys.every(
+    (key) => key in b && b[key] !== void 0 && (key === "type" || key === "id" ? a[key] === b[key] : sameShape(a[key], b[key]))
+  );
+}
+function asList(value) {
+  if (value == null || value === false) return [];
+  return Array.isArray(value) ? value : [value];
+}
+function sameSeriesShape(prev, next) {
+  const before = asList(prev);
+  const after = asList(next);
+  return before.length === after.length && before.every((item, i) => sameShape(item, after[i]));
+}
 function getReplaceMerge(prev, next, isComponentType) {
   const types = new Set(ALWAYS_REPLACE);
+  const prior = prev;
+  if (!prior || !sameSeriesShape(prior.series, next.series)) {
+    types.add("series");
+  }
   if (prev) {
     const before = prev;
     const after = next;
@@ -1162,6 +1187,12 @@ function buildStackTotalSeries(categories, series, { stacked, position, format,
     }
   }));
 }
+function barCornerRadius(horizontal, stackIds, index, radius = 4) {
+  const stack = stackIds[index];
+  const outer = stack === void 0 || stackIds.lastIndexOf(stack) === index;
+  if (!outer) return [0, 0, 0, 0];
+  return horizontal ? [0, radius, radius, 0] : [radius, radius, 0, 0];
+}
 function withEndLabelInset(inset, labels) {
   const longest = Math.max(0, ...labels.map((label) => label.length));
   if (longest === 0) return inset;
@@ -1561,6 +1592,7 @@ exports.THEME_LIGHT = THEME_LIGHT;
 exports.abbreviateNumber = abbreviateNumber;
 exports.allSeriesEmpty = allSeriesEmpty;
 exports.anchorCenterGraphic = anchorCenterGraphic;
+exports.barCornerRadius = barCornerRadius;
 exports.binValues = binValues;
 exports.boxPlotTable = boxPlotTable;
 exports.boxplotStats = boxplotStats;

package/dist/index.d.cts

@@ -125,8 +125,12 @@ declare function generateDataTable(headers: string[], rows: (string | number)[][
  * rebuilds every component, so legend selection, dataZoom ranges and other
  * interaction state reset on each data update. Instead this replaces only:
  *
- * - `series` and `graphic`, so removed series, mark lines and centre labels
- *   disappear;
+ * - `graphic`, so removed centre labels disappear;
+ * - `series`, unless every series keeps its keys and type and only its
+ *   values change. A replaced series is a new model, which ECharts animates
+ *   in from scratch, so a data refresh with the same shape (often the same
+ *   data) must merge to avoid re-animating the chart; a changed shape is
+ *   replaced so removed series, mark lines and options disappear;
  * - any component type that `next` has fewer of than `prev` (a hidden legend
  *   or tooltip, a dropped volume grid and its axes).
  *
@@ -370,6 +374,12 @@ declare function buildStackTotalSeries(categories: (string | number)[], series:
     data: (number | null)[];
     stack?: string;
 }[], { stacked, position, format, axisType }: StackTotalOptions): AnyObject[];
+/**
+ * Corner radius for one bar series. The theme rounds the top of vertical
+ * bars; horizontal bars round their right end instead. In a stack only the
+ * last series (the segment at the bar's end) is rounded.
+ */
+declare function barCornerRadius(horizontal: boolean, stackIds: (string | undefined)[], index: number, radius?: number): number[];
 /**
  * Widen the grid's right edge for labels drawn past the end of horizontal
  * bars, which `containLabel` does not reserve room for. Width is estimated
@@ -667,4 +677,4 @@ declare function downloadFile(content: string, filename: string, mimeType?: stri
  */
 declare function downloadCsv(table: ChartDataTable, filename: string): void;
 
-export { type Accessor, type Aggregate, type AutoHeightOptions, AxisConfig, BarChartData, type BinValuesOptions, BoxPlotStats, type BuildDataLabelOptions, type BuildLegendOptions, type BuildTooltipOptions, BulletItem, CandlestickData, CategoryChartData, CategorySeriesData, ChartDataTable, ChartFormatter, type ChartFormatterOptions, type ChartFormatters, ChartLegendConfig, type Delta, type FromRecordsOptions, HeatmapData, HistogramBin, HistogramBucket, LabelFormatterParams, LegendItem, LineChartData, PieSliceData, type PointLabelLookup, RadarChartData, RadarIndicator, ReferenceBand, ReferenceLine, type ReferenceMarkOptions, SankeyData, ScatterChartData, type StackTotalOptions, type ToSliceDataOptions, TooltipFormatterParams, TreemapNode, ValueFormat, type WaterfallBar, WaterfallStep, abbreviateNumber, allSeriesEmpty, anchorCenterGraphic, binValues, boxPlotTable, boxplotStats, buildAxis, buildDataLabel, buildDataZoom, buildLegend, buildMarkArea, buildMarkLine, buildStackTotalSeries, buildTooltip, bulletTable, candlestickTable, categoryTable, chartFilename, chartFormatters, computeDelta, createTooltipFormatter, downloadCsv, downloadFile, escapeHtml, formatCurrency, formatDate, formatNumber, formatPercent, formatTableCell, formatTooltipValue, formatValue, fromRecords, generateAreaChartDescription, generateBarChartDescription, generateBoxPlotDescription, generateBulletDescription, generateComboChartDescription, generateDataTable, generateDotPlotDescription, generateHistogramDescription, generateLineChartDescription, generatePieChartDescription, generateScatterChartDescription, generateWaterfallDescription, getLegendItems, getReplaceMerge, gridInset, hasPointLabels, heatmapTable, histogramTable, itemLabelLookup, legendCenter, mergeChartOption, nameLabelLookup, niceStep, pairWithCategories, pointLabel, quantile, radarTable, resolveChartHeight, resolveValueFormatter, sankeyTable, scatterTable, seriesLabelLookup, sliceTable, stackTotals, tableToCsv, toPercentStack, toSliceData, treemapTable, trendLine, valueAxisConfig, valueLabelFormatter, waterfallLayout, waterfallTable, withEndLabelInset, withPointLabels, withReferenceMarks, withZoomInset };
+export { type Accessor, type Aggregate, type AutoHeightOptions, AxisConfig, BarChartData, type BinValuesOptions, BoxPlotStats, type BuildDataLabelOptions, type BuildLegendOptions, type BuildTooltipOptions, BulletItem, CandlestickData, CategoryChartData, CategorySeriesData, ChartDataTable, ChartFormatter, type ChartFormatterOptions, type ChartFormatters, ChartLegendConfig, type Delta, type FromRecordsOptions, HeatmapData, HistogramBin, HistogramBucket, LabelFormatterParams, LegendItem, LineChartData, PieSliceData, type PointLabelLookup, RadarChartData, RadarIndicator, ReferenceBand, ReferenceLine, type ReferenceMarkOptions, SankeyData, ScatterChartData, type StackTotalOptions, type ToSliceDataOptions, TooltipFormatterParams, TreemapNode, ValueFormat, type WaterfallBar, WaterfallStep, abbreviateNumber, allSeriesEmpty, anchorCenterGraphic, barCornerRadius, binValues, boxPlotTable, boxplotStats, buildAxis, buildDataLabel, buildDataZoom, buildLegend, buildMarkArea, buildMarkLine, buildStackTotalSeries, buildTooltip, bulletTable, candlestickTable, categoryTable, chartFilename, chartFormatters, computeDelta, createTooltipFormatter, downloadCsv, downloadFile, escapeHtml, formatCurrency, formatDate, formatNumber, formatPercent, formatTableCell, formatTooltipValue, formatValue, fromRecords, generateAreaChartDescription, generateBarChartDescription, generateBoxPlotDescription, generateBulletDescription, generateComboChartDescription, generateDataTable, generateDotPlotDescription, generateHistogramDescription, generateLineChartDescription, generatePieChartDescription, generateScatterChartDescription, generateWaterfallDescription, getLegendItems, getReplaceMerge, gridInset, hasPointLabels, heatmapTable, histogramTable, itemLabelLookup, legendCenter, mergeChartOption, nameLabelLookup, niceStep, pairWithCategories, pointLabel, quantile, radarTable, resolveChartHeight, resolveValueFormatter, sankeyTable, scatterTable, seriesLabelLookup, sliceTable, stackTotals, tableToCsv, toPercentStack, toSliceData, treemapTable, trendLine, valueAxisConfig, valueLabelFormatter, waterfallLayout, waterfallTable, withEndLabelInset, withPointLabels, withReferenceMarks, withZoomInset };

package/dist/index.d.ts

@@ -125,8 +125,12 @@ declare function generateDataTable(headers: string[], rows: (string | number)[][
  * rebuilds every component, so legend selection, dataZoom ranges and other
  * interaction state reset on each data update. Instead this replaces only:
  *
- * - `series` and `graphic`, so removed series, mark lines and centre labels
- *   disappear;
+ * - `graphic`, so removed centre labels disappear;
+ * - `series`, unless every series keeps its keys and type and only its
+ *   values change. A replaced series is a new model, which ECharts animates
+ *   in from scratch, so a data refresh with the same shape (often the same
+ *   data) must merge to avoid re-animating the chart; a changed shape is
+ *   replaced so removed series, mark lines and options disappear;
  * - any component type that `next` has fewer of than `prev` (a hidden legend
  *   or tooltip, a dropped volume grid and its axes).
  *
@@ -370,6 +374,12 @@ declare function buildStackTotalSeries(categories: (string | number)[], series:
     data: (number | null)[];
     stack?: string;
 }[], { stacked, position, format, axisType }: StackTotalOptions): AnyObject[];
+/**
+ * Corner radius for one bar series. The theme rounds the top of vertical
+ * bars; horizontal bars round their right end instead. In a stack only the
+ * last series (the segment at the bar's end) is rounded.
+ */
+declare function barCornerRadius(horizontal: boolean, stackIds: (string | undefined)[], index: number, radius?: number): number[];
 /**
  * Widen the grid's right edge for labels drawn past the end of horizontal
  * bars, which `containLabel` does not reserve room for. Width is estimated
@@ -667,4 +677,4 @@ declare function downloadFile(content: string, filename: string, mimeType?: stri
  */
 declare function downloadCsv(table: ChartDataTable, filename: string): void;
 
-export { type Accessor, type Aggregate, type AutoHeightOptions, AxisConfig, BarChartData, type BinValuesOptions, BoxPlotStats, type BuildDataLabelOptions, type BuildLegendOptions, type BuildTooltipOptions, BulletItem, CandlestickData, CategoryChartData, CategorySeriesData, ChartDataTable, ChartFormatter, type ChartFormatterOptions, type ChartFormatters, ChartLegendConfig, type Delta, type FromRecordsOptions, HeatmapData, HistogramBin, HistogramBucket, LabelFormatterParams, LegendItem, LineChartData, PieSliceData, type PointLabelLookup, RadarChartData, RadarIndicator, ReferenceBand, ReferenceLine, type ReferenceMarkOptions, SankeyData, ScatterChartData, type StackTotalOptions, type ToSliceDataOptions, TooltipFormatterParams, TreemapNode, ValueFormat, type WaterfallBar, WaterfallStep, abbreviateNumber, allSeriesEmpty, anchorCenterGraphic, binValues, boxPlotTable, boxplotStats, buildAxis, buildDataLabel, buildDataZoom, buildLegend, buildMarkArea, buildMarkLine, buildStackTotalSeries, buildTooltip, bulletTable, candlestickTable, categoryTable, chartFilename, chartFormatters, computeDelta, createTooltipFormatter, downloadCsv, downloadFile, escapeHtml, formatCurrency, formatDate, formatNumber, formatPercent, formatTableCell, formatTooltipValue, formatValue, fromRecords, generateAreaChartDescription, generateBarChartDescription, generateBoxPlotDescription, generateBulletDescription, generateComboChartDescription, generateDataTable, generateDotPlotDescription, generateHistogramDescription, generateLineChartDescription, generatePieChartDescription, generateScatterChartDescription, generateWaterfallDescription, getLegendItems, getReplaceMerge, gridInset, hasPointLabels, heatmapTable, histogramTable, itemLabelLookup, legendCenter, mergeChartOption, nameLabelLookup, niceStep, pairWithCategories, pointLabel, quantile, radarTable, resolveChartHeight, resolveValueFormatter, sankeyTable, scatterTable, seriesLabelLookup, sliceTable, stackTotals, tableToCsv, toPercentStack, toSliceData, treemapTable, trendLine, valueAxisConfig, valueLabelFormatter, waterfallLayout, waterfallTable, withEndLabelInset, withPointLabels, withReferenceMarks, withZoomInset };
+export { type Accessor, type Aggregate, type AutoHeightOptions, AxisConfig, BarChartData, type BinValuesOptions, BoxPlotStats, type BuildDataLabelOptions, type BuildLegendOptions, type BuildTooltipOptions, BulletItem, CandlestickData, CategoryChartData, CategorySeriesData, ChartDataTable, ChartFormatter, type ChartFormatterOptions, type ChartFormatters, ChartLegendConfig, type Delta, type FromRecordsOptions, HeatmapData, HistogramBin, HistogramBucket, LabelFormatterParams, LegendItem, LineChartData, PieSliceData, type PointLabelLookup, RadarChartData, RadarIndicator, ReferenceBand, ReferenceLine, type ReferenceMarkOptions, SankeyData, ScatterChartData, type StackTotalOptions, type ToSliceDataOptions, TooltipFormatterParams, TreemapNode, ValueFormat, type WaterfallBar, WaterfallStep, abbreviateNumber, allSeriesEmpty, anchorCenterGraphic, barCornerRadius, binValues, boxPlotTable, boxplotStats, buildAxis, buildDataLabel, buildDataZoom, buildLegend, buildMarkArea, buildMarkLine, buildStackTotalSeries, buildTooltip, bulletTable, candlestickTable, categoryTable, chartFilename, chartFormatters, computeDelta, createTooltipFormatter, downloadCsv, downloadFile, escapeHtml, formatCurrency, formatDate, formatNumber, formatPercent, formatTableCell, formatTooltipValue, formatValue, fromRecords, generateAreaChartDescription, generateBarChartDescription, generateBoxPlotDescription, generateBulletDescription, generateComboChartDescription, generateDataTable, generateDotPlotDescription, generateHistogramDescription, generateLineChartDescription, generatePieChartDescription, generateScatterChartDescription, generateWaterfallDescription, getLegendItems, getReplaceMerge, gridInset, hasPointLabels, heatmapTable, histogramTable, itemLabelLookup, legendCenter, mergeChartOption, nameLabelLookup, niceStep, pairWithCategories, pointLabel, quantile, radarTable, resolveChartHeight, resolveValueFormatter, sankeyTable, scatterTable, seriesLabelLookup, sliceTable, stackTotals, tableToCsv, toPercentStack, toSliceData, treemapTable, trendLine, valueAxisConfig, valueLabelFormatter, waterfallLayout, waterfallTable, withEndLabelInset, withPointLabels, withReferenceMarks, withZoomInset };

package/dist/index.js

@@ -252,14 +252,39 @@ function generateDataTable(headers, rows) {
 }
 
 // src/utils/merge.ts
-var ALWAYS_REPLACE = ["series", "graphic"];
+var ALWAYS_REPLACE = ["graphic"];
 function countComponents(value) {
   if (value == null || value === false) return 0;
   if (Array.isArray(value)) return value.filter((item) => item != null).length;
   return 1;
 }
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function sameShape(a, b) {
+  if (!isRecord(a) || !isRecord(b)) return !isRecord(a) && !isRecord(b);
+  const keys = Object.keys(a).filter((key) => a[key] !== void 0);
+  const other = Object.keys(b).filter((key) => b[key] !== void 0);
+  if (keys.length !== other.length) return false;
+  return keys.every(
+    (key) => key in b && b[key] !== void 0 && (key === "type" || key === "id" ? a[key] === b[key] : sameShape(a[key], b[key]))
+  );
+}
+function asList(value) {
+  if (value == null || value === false) return [];
+  return Array.isArray(value) ? value : [value];
+}
+function sameSeriesShape(prev, next) {
+  const before = asList(prev);
+  const after = asList(next);
+  return before.length === after.length && before.every((item, i) => sameShape(item, after[i]));
+}
 function getReplaceMerge(prev, next, isComponentType) {
   const types = new Set(ALWAYS_REPLACE);
+  const prior = prev;
+  if (!prior || !sameSeriesShape(prior.series, next.series)) {
+    types.add("series");
+  }
   if (prev) {
     const before = prev;
     const after = next;
@@ -841,6 +866,12 @@ function buildStackTotalSeries(categories, series, { stacked, position, format,
     }
   }));
 }
+function barCornerRadius(horizontal, stackIds, index, radius = 4) {
+  const stack = stackIds[index];
+  const outer = stack === void 0 || stackIds.lastIndexOf(stack) === index;
+  if (!outer) return [0, 0, 0, 0];
+  return horizontal ? [0, radius, radius, 0] : [radius, radius, 0, 0];
+}
 function withEndLabelInset(inset, labels) {
   const longest = Math.max(0, ...labels.map((label) => label.length));
   if (longest === 0) return inset;
@@ -1235,4 +1266,4 @@ function downloadCsv(table, filename) {
   );
 }
 
-export { abbreviateNumber, allSeriesEmpty, anchorCenterGraphic, binValues, boxPlotTable, boxplotStats, buildAxis, buildDataLabel, buildDataZoom, buildLegend, buildMarkArea, buildMarkLine, buildStackTotalSeries, buildTooltip, bulletTable, candlestickTable, categoryTable, chartFilename, chartFormatters, computeDelta, createTooltipFormatter, downloadCsv, downloadFile, escapeHtml, formatCurrency, formatDate, formatNumber, formatPercent, formatTableCell, formatTooltipValue, formatValue, fromRecords, generateAreaChartDescription, generateBarChartDescription, generateBoxPlotDescription, generateBulletDescription, generateComboChartDescription, generateDataTable, generateDotPlotDescription, generateHistogramDescription, generateLineChartDescription, generatePieChartDescription, generateScatterChartDescription, generateWaterfallDescription, getLegendItems, getReplaceMerge, gridInset, hasPointLabels, heatmapTable, histogramTable, itemLabelLookup, legendCenter, mergeChartOption, nameLabelLookup, niceStep, pairWithCategories, pointLabel, quantile, radarTable, resolveChartHeight, resolveValueFormatter, sankeyTable, scatterTable, seriesLabelLookup, sliceTable, stackTotals, tableToCsv, toPercentStack, toSliceData, treemapTable, trendLine, valueAxisConfig, valueLabelFormatter, waterfallLayout, waterfallTable, withEndLabelInset, withPointLabels, withReferenceMarks, withZoomInset };
+export { abbreviateNumber, allSeriesEmpty, anchorCenterGraphic, barCornerRadius, binValues, boxPlotTable, boxplotStats, buildAxis, buildDataLabel, buildDataZoom, buildLegend, buildMarkArea, buildMarkLine, buildStackTotalSeries, buildTooltip, bulletTable, candlestickTable, categoryTable, chartFilename, chartFormatters, computeDelta, createTooltipFormatter, downloadCsv, downloadFile, escapeHtml, formatCurrency, formatDate, formatNumber, formatPercent, formatTableCell, formatTooltipValue, formatValue, fromRecords, generateAreaChartDescription, generateBarChartDescription, generateBoxPlotDescription, generateBulletDescription, generateComboChartDescription, generateDataTable, generateDotPlotDescription, generateHistogramDescription, generateLineChartDescription, generatePieChartDescription, generateScatterChartDescription, generateWaterfallDescription, getLegendItems, getReplaceMerge, gridInset, hasPointLabels, heatmapTable, histogramTable, itemLabelLookup, legendCenter, mergeChartOption, nameLabelLookup, niceStep, pairWithCategories, pointLabel, quantile, radarTable, resolveChartHeight, resolveValueFormatter, sankeyTable, scatterTable, seriesLabelLookup, sliceTable, stackTotals, tableToCsv, toPercentStack, toSliceData, treemapTable, trendLine, valueAxisConfig, valueLabelFormatter, waterfallLayout, waterfallTable, withEndLabelInset, withPointLabels, withReferenceMarks, withZoomInset };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classic-homes/charts-core",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Core utilities and theme for Classic Theme charts",
   "type": "module",
   "main": "dist/index.cjs",