@chartts/csv 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,129 @@
+'use strict';
+
+// src/index.ts
+function detectDelimiter(text) {
+  const firstLine = text.split("\n")[0] ?? "";
+  const tabs = (firstLine.match(/\t/g) ?? []).length;
+  const commas = (firstLine.match(/,/g) ?? []).length;
+  return tabs > commas ? "	" : ",";
+}
+function parseCSVLine(line, delimiter) {
+  const fields = [];
+  let current = "";
+  let inQuotes = false;
+  for (let i = 0; i < line.length; i++) {
+    const ch = line[i];
+    if (inQuotes) {
+      if (ch === '"') {
+        if (i + 1 < line.length && line[i + 1] === '"') {
+          current += '"';
+          i++;
+        } else {
+          inQuotes = false;
+        }
+      } else {
+        current += ch;
+      }
+    } else if (ch === '"') {
+      inQuotes = true;
+    } else if (ch === delimiter) {
+      fields.push(current);
+      current = "";
+    } else {
+      current += ch;
+    }
+  }
+  fields.push(current);
+  return fields;
+}
+function isNumeric(value) {
+  if (value === "") return false;
+  return !isNaN(Number(value));
+}
+function fromCSV(text, options) {
+  const delimiter = options?.delimiter ?? detectDelimiter(text);
+  const hasHeaders = options?.headers ?? true;
+  const lines = text.trim().split(/\r?\n/).filter((l) => l.trim() !== "");
+  if (lines.length === 0) return { series: [] };
+  const rows = lines.map((line) => parseCSVLine(line, delimiter));
+  const headerRow = hasHeaders ? rows[0] : void 0;
+  const dataRows = hasHeaders ? rows.slice(1) : rows;
+  if (dataRows.length === 0) return { series: [] };
+  const colCount = rows[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;
+    if (dataRows.length > 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 === "" || isNumeric(val);
+      });
+      if (allNumeric) seriesIndices.push(c);
+    }
+  }
+  const labels = dataRows.map((row) => row[labelIdx] ?? "");
+  const series = seriesIndices.map((colIdx) => ({
+    name: headerRow?.[colIdx] ?? `Column ${colIdx}`,
+    values: dataRows.map((row) => {
+      const val = row[colIdx] ?? "";
+      return val === "" ? 0 : Number(val);
+    })
+  }));
+  return { labels, series };
+}
+function toCSV(data, options) {
+  const delimiter = options?.delimiter ?? ",";
+  const includeHeaders = options?.headers ?? true;
+  const lines = [];
+  if (includeHeaders) {
+    const header = ["Label", ...data.series.map((s) => s.name)];
+    lines.push(header.map((h) => escapeCSVField(h, delimiter)).join(delimiter));
+  }
+  const rowCount = data.series[0]?.values.length ?? 0;
+  for (let i = 0; i < rowCount; i++) {
+    const label = data.labels?.[i] ?? "";
+    const labelStr = label instanceof Date ? label.toISOString() : String(label);
+    const values = data.series.map((s) => String(s.values[i] ?? ""));
+    lines.push([escapeCSVField(labelStr, delimiter), ...values].join(delimiter));
+  }
+  return lines.join("\n");
+}
+function escapeCSVField(field, delimiter) {
+  if (field.includes(delimiter) || field.includes('"') || field.includes("\n")) {
+    return `"${field.replace(/"/g, '""')}"`;
+  }
+  return field;
+}
+
+exports.fromCSV = fromCSV;
+exports.toCSV = toCSV;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ChartData, Series } from '@chartts/core'\n\nexport interface FromCSVOptions {\n  /** Column delimiter. Auto-detects tab vs comma if omitted. */\n  delimiter?: string\n  /** Whether the first row contains headers. Default: true */\n  headers?: boolean\n  /** Which column to use as labels (index or header name). Default: first column (0) */\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 ToCSVOptions {\n  /** Column delimiter. Default: ',' */\n  delimiter?: string\n  /** Include a header row. Default: true */\n  headers?: boolean\n}\n\nfunction detectDelimiter(text: string): string {\n  const firstLine = text.split('\\n')[0] ?? ''\n  const tabs = (firstLine.match(/\\t/g) ?? []).length\n  const commas = (firstLine.match(/,/g) ?? []).length\n  return tabs > commas ? '\\t' : ','\n}\n\nfunction parseCSVLine(line: string, delimiter: string): string[] {\n  const fields: string[] = []\n  let current = ''\n  let inQuotes = false\n\n  for (let i = 0; i < line.length; i++) {\n    const ch = line[i]!\n    if (inQuotes) {\n      if (ch === '\"') {\n        if (i + 1 < line.length && line[i + 1] === '\"') {\n          current += '\"'\n          i++\n        } else {\n          inQuotes = false\n        }\n      } else {\n        current += ch\n      }\n    } else if (ch === '\"') {\n      inQuotes = true\n    } else if (ch === delimiter) {\n      fields.push(current)\n      current = ''\n    } else {\n      current += ch\n    }\n  }\n  fields.push(current)\n  return fields\n}\n\nfunction isNumeric(value: string): boolean {\n  if (value === '') return false\n  return !isNaN(Number(value))\n}\n\nexport function fromCSV(text: string, options?: FromCSVOptions): ChartData {\n  const delimiter = options?.delimiter ?? detectDelimiter(text)\n  const hasHeaders = options?.headers ?? true\n\n  const lines = text.trim().split(/\\r?\\n/).filter(l => l.trim() !== '')\n  if (lines.length === 0) return { series: [] }\n\n  const rows = lines.map(line => parseCSVLine(line, delimiter))\n  const headerRow = hasHeaders ? rows[0]! : undefined\n  const dataRows = hasHeaders ? rows.slice(1) : rows\n\n  if (dataRows.length === 0) return { series: [] }\n\n  const colCount = rows[0]!.length\n\n  // Resolve labelColumn index\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    // Default: first non-numeric column, or column 0\n    labelIdx = 0\n    if (dataRows.length > 0) {\n      for (let c = 0; c < colCount; c++) {\n        if (!isNumeric(dataRows[0]![c] ?? '')) {\n          labelIdx = c\n          break\n        }\n      }\n    }\n  }\n\n  // Resolve series column indices\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    // Auto-detect: all columns with numeric data (excluding label column)\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[c] ?? ''\n        return val === '' || isNumeric(val)\n      })\n      if (allNumeric) seriesIndices.push(c)\n    }\n  }\n\n  const labels = dataRows.map(row => row[labelIdx] ?? '')\n  const series: Series[] = seriesIndices.map(colIdx => ({\n    name: headerRow?.[colIdx] ?? `Column ${colIdx}`,\n    values: dataRows.map(row => {\n      const val = row[colIdx] ?? ''\n      return val === '' ? 0 : Number(val)\n    }),\n  }))\n\n  return { labels, series }\n}\n\nexport function toCSV(data: ChartData, options?: ToCSVOptions): string {\n  const delimiter = options?.delimiter ?? ','\n  const includeHeaders = options?.headers ?? true\n\n  const lines: string[] = []\n\n  if (includeHeaders) {\n    const header = ['Label', ...data.series.map(s => s.name)]\n    lines.push(header.map(h => escapeCSVField(h, delimiter)).join(delimiter))\n  }\n\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 labelStr = label instanceof Date ? label.toISOString() : String(label)\n    const values = data.series.map(s => String(s.values[i] ?? ''))\n    lines.push([escapeCSVField(labelStr, delimiter), ...values].join(delimiter))\n  }\n\n  return lines.join('\\n')\n}\n\nfunction escapeCSVField(field: string, delimiter: string): string {\n  if (field.includes(delimiter) || field.includes('\"') || field.includes('\\n')) {\n    return `\"${field.replace(/\"/g, '\"\"')}\"`\n  }\n  return field\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,22 @@
+import { ChartData } from '@chartts/core';
+
+interface FromCSVOptions {
+    /** Column delimiter. Auto-detects tab vs comma if omitted. */
+    delimiter?: string;
+    /** Whether the first row contains headers. Default: true */
+    headers?: boolean;
+    /** Which column to use as labels (index or header name). Default: first column (0) */
+    labelColumn?: number | string;
+    /** Which columns to use as series (indices or header names). Default: all numeric columns */
+    seriesColumns?: (number | string)[];
+}
+interface ToCSVOptions {
+    /** Column delimiter. Default: ',' */
+    delimiter?: string;
+    /** Include a header row. Default: true */
+    headers?: boolean;
+}
+declare function fromCSV(text: string, options?: FromCSVOptions): ChartData;
+declare function toCSV(data: ChartData, options?: ToCSVOptions): string;
+
+export { type FromCSVOptions, type ToCSVOptions, fromCSV, toCSV };

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { ChartData } from '@chartts/core';
+
+interface FromCSVOptions {
+    /** Column delimiter. Auto-detects tab vs comma if omitted. */
+    delimiter?: string;
+    /** Whether the first row contains headers. Default: true */
+    headers?: boolean;
+    /** Which column to use as labels (index or header name). Default: first column (0) */
+    labelColumn?: number | string;
+    /** Which columns to use as series (indices or header names). Default: all numeric columns */
+    seriesColumns?: (number | string)[];
+}
+interface ToCSVOptions {
+    /** Column delimiter. Default: ',' */
+    delimiter?: string;
+    /** Include a header row. Default: true */
+    headers?: boolean;
+}
+declare function fromCSV(text: string, options?: FromCSVOptions): ChartData;
+declare function toCSV(data: ChartData, options?: ToCSVOptions): string;
+
+export { type FromCSVOptions, type ToCSVOptions, fromCSV, toCSV };

package/dist/index.js

@@ -0,0 +1,126 @@
+// src/index.ts
+function detectDelimiter(text) {
+  const firstLine = text.split("\n")[0] ?? "";
+  const tabs = (firstLine.match(/\t/g) ?? []).length;
+  const commas = (firstLine.match(/,/g) ?? []).length;
+  return tabs > commas ? "	" : ",";
+}
+function parseCSVLine(line, delimiter) {
+  const fields = [];
+  let current = "";
+  let inQuotes = false;
+  for (let i = 0; i < line.length; i++) {
+    const ch = line[i];
+    if (inQuotes) {
+      if (ch === '"') {
+        if (i + 1 < line.length && line[i + 1] === '"') {
+          current += '"';
+          i++;
+        } else {
+          inQuotes = false;
+        }
+      } else {
+        current += ch;
+      }
+    } else if (ch === '"') {
+      inQuotes = true;
+    } else if (ch === delimiter) {
+      fields.push(current);
+      current = "";
+    } else {
+      current += ch;
+    }
+  }
+  fields.push(current);
+  return fields;
+}
+function isNumeric(value) {
+  if (value === "") return false;
+  return !isNaN(Number(value));
+}
+function fromCSV(text, options) {
+  const delimiter = options?.delimiter ?? detectDelimiter(text);
+  const hasHeaders = options?.headers ?? true;
+  const lines = text.trim().split(/\r?\n/).filter((l) => l.trim() !== "");
+  if (lines.length === 0) return { series: [] };
+  const rows = lines.map((line) => parseCSVLine(line, delimiter));
+  const headerRow = hasHeaders ? rows[0] : void 0;
+  const dataRows = hasHeaders ? rows.slice(1) : rows;
+  if (dataRows.length === 0) return { series: [] };
+  const colCount = rows[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;
+    if (dataRows.length > 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 === "" || isNumeric(val);
+      });
+      if (allNumeric) seriesIndices.push(c);
+    }
+  }
+  const labels = dataRows.map((row) => row[labelIdx] ?? "");
+  const series = seriesIndices.map((colIdx) => ({
+    name: headerRow?.[colIdx] ?? `Column ${colIdx}`,
+    values: dataRows.map((row) => {
+      const val = row[colIdx] ?? "";
+      return val === "" ? 0 : Number(val);
+    })
+  }));
+  return { labels, series };
+}
+function toCSV(data, options) {
+  const delimiter = options?.delimiter ?? ",";
+  const includeHeaders = options?.headers ?? true;
+  const lines = [];
+  if (includeHeaders) {
+    const header = ["Label", ...data.series.map((s) => s.name)];
+    lines.push(header.map((h) => escapeCSVField(h, delimiter)).join(delimiter));
+  }
+  const rowCount = data.series[0]?.values.length ?? 0;
+  for (let i = 0; i < rowCount; i++) {
+    const label = data.labels?.[i] ?? "";
+    const labelStr = label instanceof Date ? label.toISOString() : String(label);
+    const values = data.series.map((s) => String(s.values[i] ?? ""));
+    lines.push([escapeCSVField(labelStr, delimiter), ...values].join(delimiter));
+  }
+  return lines.join("\n");
+}
+function escapeCSVField(field, delimiter) {
+  if (field.includes(delimiter) || field.includes('"') || field.includes("\n")) {
+    return `"${field.replace(/"/g, '""')}"`;
+  }
+  return field;
+}
+
+export { fromCSV, toCSV };
+//# 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'\n\nexport interface FromCSVOptions {\n  /** Column delimiter. Auto-detects tab vs comma if omitted. */\n  delimiter?: string\n  /** Whether the first row contains headers. Default: true */\n  headers?: boolean\n  /** Which column to use as labels (index or header name). Default: first column (0) */\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 ToCSVOptions {\n  /** Column delimiter. Default: ',' */\n  delimiter?: string\n  /** Include a header row. Default: true */\n  headers?: boolean\n}\n\nfunction detectDelimiter(text: string): string {\n  const firstLine = text.split('\\n')[0] ?? ''\n  const tabs = (firstLine.match(/\\t/g) ?? []).length\n  const commas = (firstLine.match(/,/g) ?? []).length\n  return tabs > commas ? '\\t' : ','\n}\n\nfunction parseCSVLine(line: string, delimiter: string): string[] {\n  const fields: string[] = []\n  let current = ''\n  let inQuotes = false\n\n  for (let i = 0; i < line.length; i++) {\n    const ch = line[i]!\n    if (inQuotes) {\n      if (ch === '\"') {\n        if (i + 1 < line.length && line[i + 1] === '\"') {\n          current += '\"'\n          i++\n        } else {\n          inQuotes = false\n        }\n      } else {\n        current += ch\n      }\n    } else if (ch === '\"') {\n      inQuotes = true\n    } else if (ch === delimiter) {\n      fields.push(current)\n      current = ''\n    } else {\n      current += ch\n    }\n  }\n  fields.push(current)\n  return fields\n}\n\nfunction isNumeric(value: string): boolean {\n  if (value === '') return false\n  return !isNaN(Number(value))\n}\n\nexport function fromCSV(text: string, options?: FromCSVOptions): ChartData {\n  const delimiter = options?.delimiter ?? detectDelimiter(text)\n  const hasHeaders = options?.headers ?? true\n\n  const lines = text.trim().split(/\\r?\\n/).filter(l => l.trim() !== '')\n  if (lines.length === 0) return { series: [] }\n\n  const rows = lines.map(line => parseCSVLine(line, delimiter))\n  const headerRow = hasHeaders ? rows[0]! : undefined\n  const dataRows = hasHeaders ? rows.slice(1) : rows\n\n  if (dataRows.length === 0) return { series: [] }\n\n  const colCount = rows[0]!.length\n\n  // Resolve labelColumn index\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    // Default: first non-numeric column, or column 0\n    labelIdx = 0\n    if (dataRows.length > 0) {\n      for (let c = 0; c < colCount; c++) {\n        if (!isNumeric(dataRows[0]![c] ?? '')) {\n          labelIdx = c\n          break\n        }\n      }\n    }\n  }\n\n  // Resolve series column indices\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    // Auto-detect: all columns with numeric data (excluding label column)\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[c] ?? ''\n        return val === '' || isNumeric(val)\n      })\n      if (allNumeric) seriesIndices.push(c)\n    }\n  }\n\n  const labels = dataRows.map(row => row[labelIdx] ?? '')\n  const series: Series[] = seriesIndices.map(colIdx => ({\n    name: headerRow?.[colIdx] ?? `Column ${colIdx}`,\n    values: dataRows.map(row => {\n      const val = row[colIdx] ?? ''\n      return val === '' ? 0 : Number(val)\n    }),\n  }))\n\n  return { labels, series }\n}\n\nexport function toCSV(data: ChartData, options?: ToCSVOptions): string {\n  const delimiter = options?.delimiter ?? ','\n  const includeHeaders = options?.headers ?? true\n\n  const lines: string[] = []\n\n  if (includeHeaders) {\n    const header = ['Label', ...data.series.map(s => s.name)]\n    lines.push(header.map(h => escapeCSVField(h, delimiter)).join(delimiter))\n  }\n\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 labelStr = label instanceof Date ? label.toISOString() : String(label)\n    const values = data.series.map(s => String(s.values[i] ?? ''))\n    lines.push([escapeCSVField(labelStr, delimiter), ...values].join(delimiter))\n  }\n\n  return lines.join('\\n')\n}\n\nfunction escapeCSVField(field: string, delimiter: string): string {\n  if (field.includes(delimiter) || field.includes('\"') || field.includes('\\n')) {\n    return `\"${field.replace(/\"/g, '\"\"')}\"`\n  }\n  return field\n}\n"]}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@chartts/csv",
+  "version": "0.1.3",
+  "description": "CSV/TSV 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"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chartts/chartts"
+  },
+  "homepage": "https://chartts.com",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}