@classic-homes/charts-core 0.3.0 → 0.3.2

package/README.md

@@ -0,0 +1,43 @@
+# @classic-homes/charts-core
+
+Framework-agnostic utilities, types, and ECharts themes for Classic Theme chart components. This package is the shared foundation for `@classic-homes/charts-react` and `@classic-homes/charts-svelte`.
+
+## Installation
+
+```bash
+npm install @classic-homes/charts-core echarts
+```
+
+Peer dependency: `echarts@^5.5.0`.
+
+## Exports
+
+| Import                             | Contents                                                                                                                                                                     |
+| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@classic-homes/charts-core`       | Themes, chart color helpers, prop and data types, formatting and data utilities                                                                                              |
+| `@classic-homes/charts-core/theme` | `generateLightTheme`, `generateDarkTheme`, `lightTheme`, `darkTheme`, `THEME_LIGHT`, `THEME_DARK`, `lightChartColors`, `darkChartColors`, `getChartColors`, `colorWithAlpha` |
+| `@classic-homes/charts-core/types` | Chart prop, data, and event types (`LineChartData`, `BarChartProps`, `ChartEventHandlers`, ...)                                                                              |
+
+## Usage
+
+### Themes
+
+```typescript
+import { lightTheme, darkTheme } from '@classic-homes/charts-core/theme';
+```
+
+### Types
+
+```typescript
+import type { LineChartData, BarChartData, PieSliceData } from '@classic-homes/charts-core/types';
+
+const revenue: LineChartData = {
+  categories: ['Jan', 'Feb', 'Mar'],
+  series: [{ name: '2025', data: [120, 132, 101] }],
+};
+```
+
+## Related Packages
+
+- `@classic-homes/charts-react`: React ECharts components
+- `@classic-homes/charts-svelte`: Svelte ECharts components

package/dist/index.cjs

@@ -1290,10 +1290,11 @@ function toSliceData(rows, options) {
     nullLabel = "Unknown",
     colors: colors3
   } = options;
+  const effective = value === void 0 ? "count" : aggregate;
   const { categories, series } = fromRecords(rows, {
     category: name,
     value,
-    aggregate: value === void 0 ? "count" : aggregate,
+    aggregate: effective,
     nullLabel
   });
   const values = series[0]?.data ?? [];
@@ -1307,7 +1308,12 @@ function toSliceData(rows, options) {
     const rest = slices.slice(topN);
     slices = slices.slice(0, topN);
     if (otherLabel !== void 0) {
-      slices.push({ name: otherLabel, value: rest.reduce((sum, slice) => sum + slice.value, 0) });
+      const folded = new Set(rest.map((slice) => slice.name));
+      const other = fromRecords(
+        (rows ?? []).filter((row) => folded.has(toLabel(read(row, name), nullLabel))),
+        { category: () => otherLabel, value, aggregate: effective }
+      ).series[0]?.data[0];
+      slices.push({ name: otherLabel, value: other ?? 0 });
     }
   }
   return slices.map(
@@ -1468,15 +1474,17 @@ function formatTableCell(table, cell, column, format) {
       return formatValue(cell, format);
   }
 }
-function csvCell(cell) {
+var FORMULA_START = /^[=+\-@\t\r]/;
+function csvCell(cell, raw = cell) {
   if (cell == null) return "";
-  const text = String(cell);
+  let text = String(cell);
+  if (typeof raw === "string" && FORMULA_START.test(text)) text = `'${text}`;
   return /[",\r\n]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
 }
 function tableToCsv(table, format) {
   const lines = [table.headers, ...table.rows].map(
     (row, rowIndex) => row.map(
-      (cell, column) => csvCell(rowIndex > 0 && format ? formatTableCell(table, cell, column, format) : cell)
+      (cell, column) => csvCell(rowIndex > 0 && format ? formatTableCell(table, cell, column, format) : cell, cell)
     ).join(",")
   );
   return lines.join("\r\n");

package/dist/index.d.cts

@@ -536,7 +536,11 @@ interface ToSliceDataOptions<T> {
     sort?: 'desc' | 'asc' | 'none';
     /** Keep only the largest N slices */
     topN?: number;
-    /** Fold slices beyond `topN` into one with this label; omit to drop them */
+    /**
+     * Fold slices beyond `topN` into one with this label; omit to drop them.
+     * The folded slice aggregates the folded records, so with 'avg' it is their
+     * average rather than a sum of averages.
+     */
     otherLabel?: string;
     /** Label for a missing name (defaults to 'Unknown') */
     nullLabel?: string;

package/dist/index.d.ts

@@ -536,7 +536,11 @@ interface ToSliceDataOptions<T> {
     sort?: 'desc' | 'asc' | 'none';
     /** Keep only the largest N slices */
     topN?: number;
-    /** Fold slices beyond `topN` into one with this label; omit to drop them */
+    /**
+     * Fold slices beyond `topN` into one with this label; omit to drop them.
+     * The folded slice aggregates the folded records, so with 'avg' it is their
+     * average rather than a sum of averages.
+     */
     otherLabel?: string;
     /** Label for a missing name (defaults to 'Unknown') */
     nullLabel?: string;

package/dist/index.js

@@ -969,10 +969,11 @@ function toSliceData(rows, options) {
     nullLabel = "Unknown",
     colors
   } = options;
+  const effective = value === void 0 ? "count" : aggregate;
   const { categories, series } = fromRecords(rows, {
     category: name,
     value,
-    aggregate: value === void 0 ? "count" : aggregate,
+    aggregate: effective,
     nullLabel
   });
   const values = series[0]?.data ?? [];
@@ -986,7 +987,12 @@ function toSliceData(rows, options) {
     const rest = slices.slice(topN);
     slices = slices.slice(0, topN);
     if (otherLabel !== void 0) {
-      slices.push({ name: otherLabel, value: rest.reduce((sum, slice) => sum + slice.value, 0) });
+      const folded = new Set(rest.map((slice) => slice.name));
+      const other = fromRecords(
+        (rows ?? []).filter((row) => folded.has(toLabel(read(row, name), nullLabel))),
+        { category: () => otherLabel, value, aggregate: effective }
+      ).series[0]?.data[0];
+      slices.push({ name: otherLabel, value: other ?? 0 });
     }
   }
   return slices.map(
@@ -1147,15 +1153,17 @@ function formatTableCell(table, cell, column, format) {
       return formatValue(cell, format);
   }
 }
-function csvCell(cell) {
+var FORMULA_START = /^[=+\-@\t\r]/;
+function csvCell(cell, raw = cell) {
   if (cell == null) return "";
-  const text = String(cell);
+  let text = String(cell);
+  if (typeof raw === "string" && FORMULA_START.test(text)) text = `'${text}`;
   return /[",\r\n]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
 }
 function tableToCsv(table, format) {
   const lines = [table.headers, ...table.rows].map(
     (row, rowIndex) => row.map(
-      (cell, column) => csvCell(rowIndex > 0 && format ? formatTableCell(table, cell, column, format) : cell)
+      (cell, column) => csvCell(rowIndex > 0 && format ? formatTableCell(table, cell, column, format) : cell, cell)
     ).join(",")
   );
   return lines.join("\r\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classic-homes/charts-core",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Core utilities and theme for Classic Theme charts",
   "type": "module",
   "main": "dist/index.cjs",
@@ -8,19 +8,34 @@
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./theme": {
-      "types": "./dist/theme/index.d.ts",
-      "import": "./dist/theme/index.js",
-      "require": "./dist/theme/index.cjs"
+      "import": {
+        "types": "./dist/theme/index.d.ts",
+        "default": "./dist/theme/index.js"
+      },
+      "require": {
+        "types": "./dist/theme/index.d.cts",
+        "default": "./dist/theme/index.cjs"
+      }
     },
     "./types": {
-      "types": "./dist/types/index.d.ts",
-      "import": "./dist/types/index.js",
-      "require": "./dist/types/index.cjs"
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/types/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.cts",
+        "default": "./dist/types/index.cjs"
+      }
     }
   },
   "sideEffects": false,