@chartts/excel 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 chartts
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,125 @@
+'use strict';
+
+var XLSX = require('xlsx');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var XLSX__namespace = /*#__PURE__*/_interopNamespace(XLSX);
+
+// src/index.ts
+function getWorksheet(workbook, sheet) {
+  let sheetName;
+  if (typeof sheet === "string") {
+    sheetName = sheet;
+  } else {
+    const idx = sheet ?? 0;
+    sheetName = workbook.SheetNames[idx] ?? workbook.SheetNames[0];
+  }
+  const ws = workbook.Sheets[sheetName];
+  if (!ws) throw new Error(`Sheet "${sheetName}" not found`);
+  return ws;
+}
+function isNumeric(value) {
+  if (typeof value === "number") return true;
+  if (typeof value === "string" && value !== "") return !isNaN(Number(value));
+  return false;
+}
+function fromExcel(buffer, options) {
+  const workbook = XLSX__namespace.read(buffer, { type: "array" });
+  const ws = getWorksheet(workbook, options?.sheet);
+  const readOpts = { header: 1, defval: "" };
+  if (options?.range) readOpts.range = options.range;
+  const raw = XLSX__namespace.utils.sheet_to_json(ws, readOpts);
+  if (raw.length === 0) return { series: [] };
+  const hasHeaders = options?.headers ?? true;
+  const headerRow = hasHeaders ? raw[0].map(String) : void 0;
+  const dataRows = hasHeaders ? raw.slice(1) : raw;
+  if (dataRows.length === 0) return { series: [] };
+  const colCount = raw[0].length;
+  let labelIdx;
+  if (options?.labelColumn != null) {
+    if (typeof options.labelColumn === "string" && headerRow) {
+      labelIdx = headerRow.indexOf(options.labelColumn);
+      if (labelIdx === -1) labelIdx = 0;
+    } else {
+      labelIdx = Number(options.labelColumn);
+    }
+  } else {
+    labelIdx = 0;
+    for (let c = 0; c < colCount; c++) {
+      if (!isNumeric(dataRows[0][c])) {
+        labelIdx = c;
+        break;
+      }
+    }
+  }
+  let seriesIndices;
+  if (options?.seriesColumns) {
+    seriesIndices = options.seriesColumns.map((col) => {
+      if (typeof col === "string" && headerRow) {
+        const idx = headerRow.indexOf(col);
+        return idx === -1 ? -1 : idx;
+      }
+      return Number(col);
+    }).filter((i) => i >= 0 && i !== labelIdx);
+  } else {
+    seriesIndices = [];
+    for (let c = 0; c < colCount; c++) {
+      if (c === labelIdx) continue;
+      const allNumeric = dataRows.every((row) => {
+        const val = row[c];
+        return val === "" || val == null || isNumeric(val);
+      });
+      if (allNumeric) seriesIndices.push(c);
+    }
+  }
+  const labels = dataRows.map((row) => String(row[labelIdx] ?? ""));
+  const series = seriesIndices.map((colIdx) => ({
+    name: headerRow?.[colIdx] ?? `Column ${colIdx}`,
+    values: dataRows.map((row) => {
+      const val = row[colIdx];
+      if (val == null || val === "") return 0;
+      return Number(val);
+    })
+  }));
+  return { labels, series };
+}
+function toExcel(data, options) {
+  const sheetName = options?.sheetName ?? "Sheet1";
+  const aoa = [];
+  const header = ["Label", ...data.series.map((s) => s.name)];
+  aoa.push(header);
+  const rowCount = data.series[0]?.values.length ?? 0;
+  for (let i = 0; i < rowCount; i++) {
+    const label = data.labels?.[i] ?? "";
+    const labelVal = label instanceof Date ? label.toISOString() : label;
+    const row = [labelVal, ...data.series.map((s) => s.values[i] ?? 0)];
+    aoa.push(row);
+  }
+  const ws = XLSX__namespace.utils.aoa_to_sheet(aoa);
+  const wb = XLSX__namespace.utils.book_new();
+  XLSX__namespace.utils.book_append_sheet(wb, ws, sheetName);
+  const out = XLSX__namespace.write(wb, { type: "array", bookType: "xlsx" });
+  return out;
+}
+
+exports.fromExcel = fromExcel;
+exports.toExcel = toExcel;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["XLSX"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ChartData, Series } from '@chartts/core'\nimport * as XLSX from 'xlsx'\n\nexport interface FromExcelOptions {\n  /** Sheet name or index. Default: 0 (first sheet) */\n  sheet?: string | number\n  /** Whether the first row contains headers. Default: true */\n  headers?: boolean\n  /** Cell range to read, e.g. \"A1:D10\" */\n  range?: string\n  /** Which column to use as labels (index or header name). Default: first column */\n  labelColumn?: number | string\n  /** Which columns to use as series (indices or header names). Default: all numeric columns */\n  seriesColumns?: (number | string)[]\n}\n\nexport interface ToExcelOptions {\n  /** Sheet name. Default: 'Sheet1' */\n  sheetName?: string\n}\n\nfunction getWorksheet(workbook: XLSX.WorkBook, sheet?: string | number): XLSX.WorkSheet {\n  let sheetName: string\n  if (typeof sheet === 'string') {\n    sheetName = sheet\n  } else {\n    const idx = sheet ?? 0\n    sheetName = workbook.SheetNames[idx] ?? workbook.SheetNames[0]!\n  }\n  const ws = workbook.Sheets[sheetName]\n  if (!ws) throw new Error(`Sheet \"${sheetName}\" not found`)\n  return ws\n}\n\nfunction isNumeric(value: unknown): boolean {\n  if (typeof value === 'number') return true\n  if (typeof value === 'string' && value !== '') return !isNaN(Number(value))\n  return false\n}\n\nexport function fromExcel(buffer: ArrayBuffer | Uint8Array, options?: FromExcelOptions): ChartData {\n  const workbook = XLSX.read(buffer, { type: 'array' })\n  const ws = getWorksheet(workbook, options?.sheet)\n\n  const readOpts: XLSX.Sheet2JSONOpts = { header: 1, defval: '' }\n  if (options?.range) readOpts.range = options.range\n\n  const raw = XLSX.utils.sheet_to_json<unknown[]>(ws, readOpts)\n  if (raw.length === 0) return { series: [] }\n\n  const hasHeaders = options?.headers ?? true\n  const headerRow = hasHeaders ? (raw[0] as unknown[]).map(String) : undefined\n  const dataRows = hasHeaders ? raw.slice(1) : raw\n\n  if (dataRows.length === 0) return { series: [] }\n\n  const colCount = (raw[0] as unknown[]).length\n\n  // Resolve label column\n  let labelIdx: number\n  if (options?.labelColumn != null) {\n    if (typeof options.labelColumn === 'string' && headerRow) {\n      labelIdx = headerRow.indexOf(options.labelColumn)\n      if (labelIdx === -1) labelIdx = 0\n    } else {\n      labelIdx = Number(options.labelColumn)\n    }\n  } else {\n    labelIdx = 0\n    for (let c = 0; c < colCount; c++) {\n      if (!isNumeric((dataRows[0] as unknown[])[c])) {\n        labelIdx = c\n        break\n      }\n    }\n  }\n\n  // Resolve series columns\n  let seriesIndices: number[]\n  if (options?.seriesColumns) {\n    seriesIndices = options.seriesColumns.map(col => {\n      if (typeof col === 'string' && headerRow) {\n        const idx = headerRow.indexOf(col)\n        return idx === -1 ? -1 : idx\n      }\n      return Number(col)\n    }).filter(i => i >= 0 && i !== labelIdx)\n  } else {\n    seriesIndices = []\n    for (let c = 0; c < colCount; c++) {\n      if (c === labelIdx) continue\n      const allNumeric = dataRows.every(row => {\n        const val = (row as unknown[])[c]\n        return val === '' || val == null || isNumeric(val)\n      })\n      if (allNumeric) seriesIndices.push(c)\n    }\n  }\n\n  const labels = dataRows.map(row => String((row as unknown[])[labelIdx] ?? ''))\n  const series: Series[] = seriesIndices.map(colIdx => ({\n    name: headerRow?.[colIdx] ?? `Column ${colIdx}`,\n    values: dataRows.map(row => {\n      const val = (row as unknown[])[colIdx]\n      if (val == null || val === '') return 0\n      return Number(val)\n    }),\n  }))\n\n  return { labels, series }\n}\n\nexport function toExcel(data: ChartData, options?: ToExcelOptions): ArrayBuffer {\n  const sheetName = options?.sheetName ?? 'Sheet1'\n\n  const aoa: unknown[][] = []\n\n  // Header row\n  const header: unknown[] = ['Label', ...data.series.map(s => s.name)]\n  aoa.push(header)\n\n  // Data rows\n  const rowCount = data.series[0]?.values.length ?? 0\n  for (let i = 0; i < rowCount; i++) {\n    const label = data.labels?.[i] ?? ''\n    const labelVal = label instanceof Date ? label.toISOString() : label\n    const row: unknown[] = [labelVal, ...data.series.map(s => s.values[i] ?? 0)]\n    aoa.push(row)\n  }\n\n  const ws = XLSX.utils.aoa_to_sheet(aoa)\n  const wb = XLSX.utils.book_new()\n  XLSX.utils.book_append_sheet(wb, ws, sheetName)\n\n  const out = XLSX.write(wb, { type: 'array', bookType: 'xlsx' }) as ArrayBuffer\n  return out\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,22 @@
+import { ChartData } from '@chartts/core';
+
+interface FromExcelOptions {
+    /** Sheet name or index. Default: 0 (first sheet) */
+    sheet?: string | number;
+    /** Whether the first row contains headers. Default: true */
+    headers?: boolean;
+    /** Cell range to read, e.g. "A1:D10" */
+    range?: string;
+    /** Which column to use as labels (index or header name). Default: first column */
+    labelColumn?: number | string;
+    /** Which columns to use as series (indices or header names). Default: all numeric columns */
+    seriesColumns?: (number | string)[];
+}
+interface ToExcelOptions {
+    /** Sheet name. Default: 'Sheet1' */
+    sheetName?: string;
+}
+declare function fromExcel(buffer: ArrayBuffer | Uint8Array, options?: FromExcelOptions): ChartData;
+declare function toExcel(data: ChartData, options?: ToExcelOptions): ArrayBuffer;
+
+export { type FromExcelOptions, type ToExcelOptions, fromExcel, toExcel };

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { ChartData } from '@chartts/core';
+
+interface FromExcelOptions {
+    /** Sheet name or index. Default: 0 (first sheet) */
+    sheet?: string | number;
+    /** Whether the first row contains headers. Default: true */
+    headers?: boolean;
+    /** Cell range to read, e.g. "A1:D10" */
+    range?: string;
+    /** Which column to use as labels (index or header name). Default: first column */
+    labelColumn?: number | string;
+    /** Which columns to use as series (indices or header names). Default: all numeric columns */
+    seriesColumns?: (number | string)[];
+}
+interface ToExcelOptions {
+    /** Sheet name. Default: 'Sheet1' */
+    sheetName?: string;
+}
+declare function fromExcel(buffer: ArrayBuffer | Uint8Array, options?: FromExcelOptions): ChartData;
+declare function toExcel(data: ChartData, options?: ToExcelOptions): ArrayBuffer;
+
+export { type FromExcelOptions, type ToExcelOptions, fromExcel, toExcel };

package/dist/index.js

@@ -0,0 +1,102 @@
+import * as XLSX from 'xlsx';
+
+// src/index.ts
+function getWorksheet(workbook, sheet) {
+  let sheetName;
+  if (typeof sheet === "string") {
+    sheetName = sheet;
+  } else {
+    const idx = sheet ?? 0;
+    sheetName = workbook.SheetNames[idx] ?? workbook.SheetNames[0];
+  }
+  const ws = workbook.Sheets[sheetName];
+  if (!ws) throw new Error(`Sheet "${sheetName}" not found`);
+  return ws;
+}
+function isNumeric(value) {
+  if (typeof value === "number") return true;
+  if (typeof value === "string" && value !== "") return !isNaN(Number(value));
+  return false;
+}
+function fromExcel(buffer, options) {
+  const workbook = XLSX.read(buffer, { type: "array" });
+  const ws = getWorksheet(workbook, options?.sheet);
+  const readOpts = { header: 1, defval: "" };
+  if (options?.range) readOpts.range = options.range;
+  const raw = XLSX.utils.sheet_to_json(ws, readOpts);
+  if (raw.length === 0) return { series: [] };
+  const hasHeaders = options?.headers ?? true;
+  const headerRow = hasHeaders ? raw[0].map(String) : void 0;
+  const dataRows = hasHeaders ? raw.slice(1) : raw;
+  if (dataRows.length === 0) return { series: [] };
+  const colCount = raw[0].length;
+  let labelIdx;
+  if (options?.labelColumn != null) {
+    if (typeof options.labelColumn === "string" && headerRow) {
+      labelIdx = headerRow.indexOf(options.labelColumn);
+      if (labelIdx === -1) labelIdx = 0;
+    } else {
+      labelIdx = Number(options.labelColumn);
+    }
+  } else {
+    labelIdx = 0;
+    for (let c = 0; c < colCount; c++) {
+      if (!isNumeric(dataRows[0][c])) {
+        labelIdx = c;
+        break;
+      }
+    }
+  }
+  let seriesIndices;
+  if (options?.seriesColumns) {
+    seriesIndices = options.seriesColumns.map((col) => {
+      if (typeof col === "string" && headerRow) {
+        const idx = headerRow.indexOf(col);
+        return idx === -1 ? -1 : idx;
+      }
+      return Number(col);
+    }).filter((i) => i >= 0 && i !== labelIdx);
+  } else {
+    seriesIndices = [];
+    for (let c = 0; c < colCount; c++) {
+      if (c === labelIdx) continue;
+      const allNumeric = dataRows.every((row) => {
+        const val = row[c];
+        return val === "" || val == null || isNumeric(val);
+      });
+      if (allNumeric) seriesIndices.push(c);
+    }
+  }
+  const labels = dataRows.map((row) => String(row[labelIdx] ?? ""));
+  const series = seriesIndices.map((colIdx) => ({
+    name: headerRow?.[colIdx] ?? `Column ${colIdx}`,
+    values: dataRows.map((row) => {
+      const val = row[colIdx];
+      if (val == null || val === "") return 0;
+      return Number(val);
+    })
+  }));
+  return { labels, series };
+}
+function toExcel(data, options) {
+  const sheetName = options?.sheetName ?? "Sheet1";
+  const aoa = [];
+  const header = ["Label", ...data.series.map((s) => s.name)];
+  aoa.push(header);
+  const rowCount = data.series[0]?.values.length ?? 0;
+  for (let i = 0; i < rowCount; i++) {
+    const label = data.labels?.[i] ?? "";
+    const labelVal = label instanceof Date ? label.toISOString() : label;
+    const row = [labelVal, ...data.series.map((s) => s.values[i] ?? 0)];
+    aoa.push(row);
+  }
+  const ws = XLSX.utils.aoa_to_sheet(aoa);
+  const wb = XLSX.utils.book_new();
+  XLSX.utils.book_append_sheet(wb, ws, sheetName);
+  const out = XLSX.write(wb, { type: "array", bookType: "xlsx" });
+  return out;
+}
+
+export { fromExcel, toExcel };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ChartData, Series } from '@chartts/core'\nimport * as XLSX from 'xlsx'\n\nexport interface FromExcelOptions {\n  /** Sheet name or index. Default: 0 (first sheet) */\n  sheet?: string | number\n  /** Whether the first row contains headers. Default: true */\n  headers?: boolean\n  /** Cell range to read, e.g. \"A1:D10\" */\n  range?: string\n  /** Which column to use as labels (index or header name). Default: first column */\n  labelColumn?: number | string\n  /** Which columns to use as series (indices or header names). Default: all numeric columns */\n  seriesColumns?: (number | string)[]\n}\n\nexport interface ToExcelOptions {\n  /** Sheet name. Default: 'Sheet1' */\n  sheetName?: string\n}\n\nfunction getWorksheet(workbook: XLSX.WorkBook, sheet?: string | number): XLSX.WorkSheet {\n  let sheetName: string\n  if (typeof sheet === 'string') {\n    sheetName = sheet\n  } else {\n    const idx = sheet ?? 0\n    sheetName = workbook.SheetNames[idx] ?? workbook.SheetNames[0]!\n  }\n  const ws = workbook.Sheets[sheetName]\n  if (!ws) throw new Error(`Sheet \"${sheetName}\" not found`)\n  return ws\n}\n\nfunction isNumeric(value: unknown): boolean {\n  if (typeof value === 'number') return true\n  if (typeof value === 'string' && value !== '') return !isNaN(Number(value))\n  return false\n}\n\nexport function fromExcel(buffer: ArrayBuffer | Uint8Array, options?: FromExcelOptions): ChartData {\n  const workbook = XLSX.read(buffer, { type: 'array' })\n  const ws = getWorksheet(workbook, options?.sheet)\n\n  const readOpts: XLSX.Sheet2JSONOpts = { header: 1, defval: '' }\n  if (options?.range) readOpts.range = options.range\n\n  const raw = XLSX.utils.sheet_to_json<unknown[]>(ws, readOpts)\n  if (raw.length === 0) return { series: [] }\n\n  const hasHeaders = options?.headers ?? true\n  const headerRow = hasHeaders ? (raw[0] as unknown[]).map(String) : undefined\n  const dataRows = hasHeaders ? raw.slice(1) : raw\n\n  if (dataRows.length === 0) return { series: [] }\n\n  const colCount = (raw[0] as unknown[]).length\n\n  // Resolve label column\n  let labelIdx: number\n  if (options?.labelColumn != null) {\n    if (typeof options.labelColumn === 'string' && headerRow) {\n      labelIdx = headerRow.indexOf(options.labelColumn)\n      if (labelIdx === -1) labelIdx = 0\n    } else {\n      labelIdx = Number(options.labelColumn)\n    }\n  } else {\n    labelIdx = 0\n    for (let c = 0; c < colCount; c++) {\n      if (!isNumeric((dataRows[0] as unknown[])[c])) {\n        labelIdx = c\n        break\n      }\n    }\n  }\n\n  // Resolve series columns\n  let seriesIndices: number[]\n  if (options?.seriesColumns) {\n    seriesIndices = options.seriesColumns.map(col => {\n      if (typeof col === 'string' && headerRow) {\n        const idx = headerRow.indexOf(col)\n        return idx === -1 ? -1 : idx\n      }\n      return Number(col)\n    }).filter(i => i >= 0 && i !== labelIdx)\n  } else {\n    seriesIndices = []\n    for (let c = 0; c < colCount; c++) {\n      if (c === labelIdx) continue\n      const allNumeric = dataRows.every(row => {\n        const val = (row as unknown[])[c]\n        return val === '' || val == null || isNumeric(val)\n      })\n      if (allNumeric) seriesIndices.push(c)\n    }\n  }\n\n  const labels = dataRows.map(row => String((row as unknown[])[labelIdx] ?? ''))\n  const series: Series[] = seriesIndices.map(colIdx => ({\n    name: headerRow?.[colIdx] ?? `Column ${colIdx}`,\n    values: dataRows.map(row => {\n      const val = (row as unknown[])[colIdx]\n      if (val == null || val === '') return 0\n      return Number(val)\n    }),\n  }))\n\n  return { labels, series }\n}\n\nexport function toExcel(data: ChartData, options?: ToExcelOptions): ArrayBuffer {\n  const sheetName = options?.sheetName ?? 'Sheet1'\n\n  const aoa: unknown[][] = []\n\n  // Header row\n  const header: unknown[] = ['Label', ...data.series.map(s => s.name)]\n  aoa.push(header)\n\n  // Data rows\n  const rowCount = data.series[0]?.values.length ?? 0\n  for (let i = 0; i < rowCount; i++) {\n    const label = data.labels?.[i] ?? ''\n    const labelVal = label instanceof Date ? label.toISOString() : label\n    const row: unknown[] = [labelVal, ...data.series.map(s => s.values[i] ?? 0)]\n    aoa.push(row)\n  }\n\n  const ws = XLSX.utils.aoa_to_sheet(aoa)\n  const wb = XLSX.utils.book_new()\n  XLSX.utils.book_append_sheet(wb, ws, sheetName)\n\n  const out = XLSX.write(wb, { type: 'array', bookType: 'xlsx' }) as ArrayBuffer\n  return out\n}\n"]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@chartts/excel",
+  "version": "0.1.3",
+  "description": "Excel import and export for Chartts",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "@chartts/core": "0.1.3"
+  },
+  "dependencies": {
+    "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chartts/chartts"
+  },
+  "homepage": "https://chartts.com",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}