@chartts/json 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,105 @@
+'use strict';
+
+// src/index.ts
+function isChartData(input) {
+  if (typeof input !== "object" || input === null) return false;
+  const obj = input;
+  return Array.isArray(obj["series"]) && obj["series"].length > 0 && typeof obj["series"][0]?.["name"] === "string" && Array.isArray(obj["series"][0]?.["values"]);
+}
+function isColumnar(input) {
+  const values = Object.values(input);
+  return values.length > 0 && values.every((v) => Array.isArray(v));
+}
+function isNumericArray(arr) {
+  return arr.length > 0 && arr.every((v) => typeof v === "number" || typeof v === "string" && !isNaN(Number(v)));
+}
+function fromJSON(input, options) {
+  const data = typeof input === "string" ? JSON.parse(input) : input;
+  if (isChartData(data)) return data;
+  if (Array.isArray(data) && data.length > 0 && typeof data[0] === "object" && data[0] !== null) {
+    return fromRowArray(data, options);
+  }
+  if (typeof data === "object" && data !== null && !Array.isArray(data) && isColumnar(data)) {
+    return fromColumnar(data, options);
+  }
+  throw new Error("Unrecognized JSON shape. Expected array of objects, columnar object, or ChartData.");
+}
+function fromRowArray(rows, options) {
+  if (rows.length === 0) return { series: [] };
+  const keys = Object.keys(rows[0]);
+  let labelKey = options?.labelKey;
+  if (!labelKey) {
+    labelKey = keys.find(
+      (k) => rows.some((row) => typeof row[k] === "string" && isNaN(Number(row[k])))
+    ) ?? keys[0];
+  }
+  let seriesKeys = options?.seriesKeys;
+  if (!seriesKeys) {
+    seriesKeys = keys.filter((k) => {
+      if (k === labelKey) return false;
+      return rows.every((row) => {
+        const v = row[k];
+        return typeof v === "number" || typeof v === "string" && !isNaN(Number(v)) || v == null;
+      });
+    });
+  }
+  const labels = rows.map((row) => String(row[labelKey] ?? ""));
+  const series = seriesKeys.map((key) => ({
+    name: key,
+    values: rows.map((row) => {
+      const v = row[key];
+      if (v == null) return 0;
+      return typeof v === "number" ? v : Number(v);
+    })
+  }));
+  return { labels, series };
+}
+function fromColumnar(data, options) {
+  const keys = Object.keys(data);
+  let labelKey = options?.labelKey;
+  if (!labelKey) {
+    labelKey = keys.find((k) => k === "labels") ?? keys.find((k) => !isNumericArray(data[k])) ?? keys[0];
+  }
+  let seriesKeys = options?.seriesKeys;
+  if (!seriesKeys) {
+    seriesKeys = keys.filter((k) => k !== labelKey && isNumericArray(data[k]));
+  }
+  const labels = (data[labelKey] ?? []).map((v) => String(v));
+  const series = seriesKeys.map((key) => ({
+    name: key,
+    values: (data[key] ?? []).map((v) => Number(v))
+  }));
+  return { labels, series };
+}
+function toJSON(data, options) {
+  const format = options?.format ?? "rows";
+  if (format === "columnar") {
+    const result = {};
+    if (data.labels) {
+      result["labels"] = data.labels.map((l) => l instanceof Date ? l.toISOString() : l);
+    }
+    for (const s of data.series) {
+      result[s.name] = [...s.values];
+    }
+    return result;
+  }
+  const rowCount = data.series[0]?.values.length ?? 0;
+  const rows = [];
+  for (let i = 0; i < rowCount; i++) {
+    const row = {};
+    if (data.labels) {
+      const label = data.labels[i];
+      row["label"] = label instanceof Date ? label.toISOString() : label;
+    }
+    for (const s of data.series) {
+      row[s.name] = s.values[i];
+    }
+    rows.push(row);
+  }
+  return rows;
+}
+
+exports.fromJSON = fromJSON;
+exports.toJSON = toJSON;
+//# 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 FromJSONOptions {\n  /** Key to use as labels. Default: auto-detect first string-valued key */\n  labelKey?: string\n  /** Keys to use as series. Default: all numeric-valued keys */\n  seriesKeys?: string[]\n}\n\nexport type ToJSONFormat = 'rows' | 'columnar'\n\nexport interface ToJSONOptions {\n  /** Output format. Default: 'rows' (array of objects) */\n  format?: ToJSONFormat\n}\n\nfunction isChartData(input: unknown): input is ChartData {\n  if (typeof input !== 'object' || input === null) return false\n  const obj = input as Record<string, unknown>\n  return Array.isArray(obj['series']) &&\n    obj['series'].length > 0 &&\n    typeof (obj['series'] as Record<string, unknown>[])[0]?.['name'] === 'string' &&\n    Array.isArray((obj['series'] as Record<string, unknown>[])[0]?.['values'])\n}\n\nfunction isColumnar(input: Record<string, unknown>): boolean {\n  const values = Object.values(input)\n  return values.length > 0 && values.every(v => Array.isArray(v))\n}\n\nfunction isNumericArray(arr: unknown[]): boolean {\n  return arr.length > 0 && arr.every(v => typeof v === 'number' || (typeof v === 'string' && !isNaN(Number(v))))\n}\n\nexport function fromJSON(input: string | unknown, options?: FromJSONOptions): ChartData {\n  const data = typeof input === 'string' ? JSON.parse(input) as unknown : input\n\n  // Direct ChartData passthrough\n  if (isChartData(data)) return data as ChartData\n\n  // Array of objects: [{month:\"Jan\", sales:10}, ...]\n  if (Array.isArray(data) && data.length > 0 && typeof data[0] === 'object' && data[0] !== null) {\n    return fromRowArray(data as Record<string, unknown>[], options)\n  }\n\n  // Columnar: {labels:[\"Jan\"], sales:[10], costs:[5]}\n  if (typeof data === 'object' && data !== null && !Array.isArray(data) && isColumnar(data as Record<string, unknown>)) {\n    return fromColumnar(data as Record<string, unknown[]>, options)\n  }\n\n  throw new Error('Unrecognized JSON shape. Expected array of objects, columnar object, or ChartData.')\n}\n\nfunction fromRowArray(rows: Record<string, unknown>[], options?: FromJSONOptions): ChartData {\n  if (rows.length === 0) return { series: [] }\n\n  const keys = Object.keys(rows[0]!)\n\n  // Determine label key\n  let labelKey = options?.labelKey\n  if (!labelKey) {\n    // Auto-detect: first key whose values are not all numbers\n    labelKey = keys.find(k =>\n      rows.some(row => typeof row[k] === 'string' && isNaN(Number(row[k])))\n    ) ?? keys[0]!\n  }\n\n  // Determine series keys\n  let seriesKeys = options?.seriesKeys\n  if (!seriesKeys) {\n    seriesKeys = keys.filter(k => {\n      if (k === labelKey) return false\n      return rows.every(row => {\n        const v = row[k]\n        return typeof v === 'number' || (typeof v === 'string' && !isNaN(Number(v))) || v == null\n      })\n    })\n  }\n\n  const labels = rows.map(row => String(row[labelKey!] ?? ''))\n  const series: Series[] = seriesKeys.map(key => ({\n    name: key,\n    values: rows.map(row => {\n      const v = row[key]\n      if (v == null) return 0\n      return typeof v === 'number' ? v : Number(v)\n    }),\n  }))\n\n  return { labels, series }\n}\n\nfunction fromColumnar(data: Record<string, unknown[]>, options?: FromJSONOptions): ChartData {\n  const keys = Object.keys(data)\n\n  let labelKey = options?.labelKey\n  if (!labelKey) {\n    // Auto-detect: 'labels' key, or first non-numeric array\n    labelKey = keys.find(k => k === 'labels')\n      ?? keys.find(k => !isNumericArray(data[k]!))\n      ?? keys[0]!\n  }\n\n  let seriesKeys = options?.seriesKeys\n  if (!seriesKeys) {\n    seriesKeys = keys.filter(k => k !== labelKey && isNumericArray(data[k]!))\n  }\n\n  const labels = (data[labelKey] ?? []).map(v => String(v))\n  const series: Series[] = seriesKeys.map(key => ({\n    name: key,\n    values: (data[key] ?? []).map(v => Number(v)),\n  }))\n\n  return { labels, series }\n}\n\nexport function toJSON(data: ChartData, options?: ToJSONOptions): unknown {\n  const format = options?.format ?? 'rows'\n\n  if (format === 'columnar') {\n    const result: Record<string, unknown[]> = {}\n    if (data.labels) {\n      result['labels'] = data.labels.map(l => l instanceof Date ? l.toISOString() : l)\n    }\n    for (const s of data.series) {\n      result[s.name] = [...s.values]\n    }\n    return result\n  }\n\n  // rows format: array of objects\n  const rowCount = data.series[0]?.values.length ?? 0\n  const rows: Record<string, unknown>[] = []\n  for (let i = 0; i < rowCount; i++) {\n    const row: Record<string, unknown> = {}\n    if (data.labels) {\n      const label = data.labels[i]\n      row['label'] = label instanceof Date ? label.toISOString() : label\n    }\n    for (const s of data.series) {\n      row[s.name] = s.values[i]\n    }\n    rows.push(row)\n  }\n  return rows\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,17 @@
+import { ChartData } from '@chartts/core';
+
+interface FromJSONOptions {
+    /** Key to use as labels. Default: auto-detect first string-valued key */
+    labelKey?: string;
+    /** Keys to use as series. Default: all numeric-valued keys */
+    seriesKeys?: string[];
+}
+type ToJSONFormat = 'rows' | 'columnar';
+interface ToJSONOptions {
+    /** Output format. Default: 'rows' (array of objects) */
+    format?: ToJSONFormat;
+}
+declare function fromJSON(input: string | unknown, options?: FromJSONOptions): ChartData;
+declare function toJSON(data: ChartData, options?: ToJSONOptions): unknown;
+
+export { type FromJSONOptions, type ToJSONFormat, type ToJSONOptions, fromJSON, toJSON };

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import { ChartData } from '@chartts/core';
+
+interface FromJSONOptions {
+    /** Key to use as labels. Default: auto-detect first string-valued key */
+    labelKey?: string;
+    /** Keys to use as series. Default: all numeric-valued keys */
+    seriesKeys?: string[];
+}
+type ToJSONFormat = 'rows' | 'columnar';
+interface ToJSONOptions {
+    /** Output format. Default: 'rows' (array of objects) */
+    format?: ToJSONFormat;
+}
+declare function fromJSON(input: string | unknown, options?: FromJSONOptions): ChartData;
+declare function toJSON(data: ChartData, options?: ToJSONOptions): unknown;
+
+export { type FromJSONOptions, type ToJSONFormat, type ToJSONOptions, fromJSON, toJSON };

package/dist/index.js

@@ -0,0 +1,102 @@
+// src/index.ts
+function isChartData(input) {
+  if (typeof input !== "object" || input === null) return false;
+  const obj = input;
+  return Array.isArray(obj["series"]) && obj["series"].length > 0 && typeof obj["series"][0]?.["name"] === "string" && Array.isArray(obj["series"][0]?.["values"]);
+}
+function isColumnar(input) {
+  const values = Object.values(input);
+  return values.length > 0 && values.every((v) => Array.isArray(v));
+}
+function isNumericArray(arr) {
+  return arr.length > 0 && arr.every((v) => typeof v === "number" || typeof v === "string" && !isNaN(Number(v)));
+}
+function fromJSON(input, options) {
+  const data = typeof input === "string" ? JSON.parse(input) : input;
+  if (isChartData(data)) return data;
+  if (Array.isArray(data) && data.length > 0 && typeof data[0] === "object" && data[0] !== null) {
+    return fromRowArray(data, options);
+  }
+  if (typeof data === "object" && data !== null && !Array.isArray(data) && isColumnar(data)) {
+    return fromColumnar(data, options);
+  }
+  throw new Error("Unrecognized JSON shape. Expected array of objects, columnar object, or ChartData.");
+}
+function fromRowArray(rows, options) {
+  if (rows.length === 0) return { series: [] };
+  const keys = Object.keys(rows[0]);
+  let labelKey = options?.labelKey;
+  if (!labelKey) {
+    labelKey = keys.find(
+      (k) => rows.some((row) => typeof row[k] === "string" && isNaN(Number(row[k])))
+    ) ?? keys[0];
+  }
+  let seriesKeys = options?.seriesKeys;
+  if (!seriesKeys) {
+    seriesKeys = keys.filter((k) => {
+      if (k === labelKey) return false;
+      return rows.every((row) => {
+        const v = row[k];
+        return typeof v === "number" || typeof v === "string" && !isNaN(Number(v)) || v == null;
+      });
+    });
+  }
+  const labels = rows.map((row) => String(row[labelKey] ?? ""));
+  const series = seriesKeys.map((key) => ({
+    name: key,
+    values: rows.map((row) => {
+      const v = row[key];
+      if (v == null) return 0;
+      return typeof v === "number" ? v : Number(v);
+    })
+  }));
+  return { labels, series };
+}
+function fromColumnar(data, options) {
+  const keys = Object.keys(data);
+  let labelKey = options?.labelKey;
+  if (!labelKey) {
+    labelKey = keys.find((k) => k === "labels") ?? keys.find((k) => !isNumericArray(data[k])) ?? keys[0];
+  }
+  let seriesKeys = options?.seriesKeys;
+  if (!seriesKeys) {
+    seriesKeys = keys.filter((k) => k !== labelKey && isNumericArray(data[k]));
+  }
+  const labels = (data[labelKey] ?? []).map((v) => String(v));
+  const series = seriesKeys.map((key) => ({
+    name: key,
+    values: (data[key] ?? []).map((v) => Number(v))
+  }));
+  return { labels, series };
+}
+function toJSON(data, options) {
+  const format = options?.format ?? "rows";
+  if (format === "columnar") {
+    const result = {};
+    if (data.labels) {
+      result["labels"] = data.labels.map((l) => l instanceof Date ? l.toISOString() : l);
+    }
+    for (const s of data.series) {
+      result[s.name] = [...s.values];
+    }
+    return result;
+  }
+  const rowCount = data.series[0]?.values.length ?? 0;
+  const rows = [];
+  for (let i = 0; i < rowCount; i++) {
+    const row = {};
+    if (data.labels) {
+      const label = data.labels[i];
+      row["label"] = label instanceof Date ? label.toISOString() : label;
+    }
+    for (const s of data.series) {
+      row[s.name] = s.values[i];
+    }
+    rows.push(row);
+  }
+  return rows;
+}
+
+export { fromJSON, toJSON };
+//# 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 FromJSONOptions {\n  /** Key to use as labels. Default: auto-detect first string-valued key */\n  labelKey?: string\n  /** Keys to use as series. Default: all numeric-valued keys */\n  seriesKeys?: string[]\n}\n\nexport type ToJSONFormat = 'rows' | 'columnar'\n\nexport interface ToJSONOptions {\n  /** Output format. Default: 'rows' (array of objects) */\n  format?: ToJSONFormat\n}\n\nfunction isChartData(input: unknown): input is ChartData {\n  if (typeof input !== 'object' || input === null) return false\n  const obj = input as Record<string, unknown>\n  return Array.isArray(obj['series']) &&\n    obj['series'].length > 0 &&\n    typeof (obj['series'] as Record<string, unknown>[])[0]?.['name'] === 'string' &&\n    Array.isArray((obj['series'] as Record<string, unknown>[])[0]?.['values'])\n}\n\nfunction isColumnar(input: Record<string, unknown>): boolean {\n  const values = Object.values(input)\n  return values.length > 0 && values.every(v => Array.isArray(v))\n}\n\nfunction isNumericArray(arr: unknown[]): boolean {\n  return arr.length > 0 && arr.every(v => typeof v === 'number' || (typeof v === 'string' && !isNaN(Number(v))))\n}\n\nexport function fromJSON(input: string | unknown, options?: FromJSONOptions): ChartData {\n  const data = typeof input === 'string' ? JSON.parse(input) as unknown : input\n\n  // Direct ChartData passthrough\n  if (isChartData(data)) return data as ChartData\n\n  // Array of objects: [{month:\"Jan\", sales:10}, ...]\n  if (Array.isArray(data) && data.length > 0 && typeof data[0] === 'object' && data[0] !== null) {\n    return fromRowArray(data as Record<string, unknown>[], options)\n  }\n\n  // Columnar: {labels:[\"Jan\"], sales:[10], costs:[5]}\n  if (typeof data === 'object' && data !== null && !Array.isArray(data) && isColumnar(data as Record<string, unknown>)) {\n    return fromColumnar(data as Record<string, unknown[]>, options)\n  }\n\n  throw new Error('Unrecognized JSON shape. Expected array of objects, columnar object, or ChartData.')\n}\n\nfunction fromRowArray(rows: Record<string, unknown>[], options?: FromJSONOptions): ChartData {\n  if (rows.length === 0) return { series: [] }\n\n  const keys = Object.keys(rows[0]!)\n\n  // Determine label key\n  let labelKey = options?.labelKey\n  if (!labelKey) {\n    // Auto-detect: first key whose values are not all numbers\n    labelKey = keys.find(k =>\n      rows.some(row => typeof row[k] === 'string' && isNaN(Number(row[k])))\n    ) ?? keys[0]!\n  }\n\n  // Determine series keys\n  let seriesKeys = options?.seriesKeys\n  if (!seriesKeys) {\n    seriesKeys = keys.filter(k => {\n      if (k === labelKey) return false\n      return rows.every(row => {\n        const v = row[k]\n        return typeof v === 'number' || (typeof v === 'string' && !isNaN(Number(v))) || v == null\n      })\n    })\n  }\n\n  const labels = rows.map(row => String(row[labelKey!] ?? ''))\n  const series: Series[] = seriesKeys.map(key => ({\n    name: key,\n    values: rows.map(row => {\n      const v = row[key]\n      if (v == null) return 0\n      return typeof v === 'number' ? v : Number(v)\n    }),\n  }))\n\n  return { labels, series }\n}\n\nfunction fromColumnar(data: Record<string, unknown[]>, options?: FromJSONOptions): ChartData {\n  const keys = Object.keys(data)\n\n  let labelKey = options?.labelKey\n  if (!labelKey) {\n    // Auto-detect: 'labels' key, or first non-numeric array\n    labelKey = keys.find(k => k === 'labels')\n      ?? keys.find(k => !isNumericArray(data[k]!))\n      ?? keys[0]!\n  }\n\n  let seriesKeys = options?.seriesKeys\n  if (!seriesKeys) {\n    seriesKeys = keys.filter(k => k !== labelKey && isNumericArray(data[k]!))\n  }\n\n  const labels = (data[labelKey] ?? []).map(v => String(v))\n  const series: Series[] = seriesKeys.map(key => ({\n    name: key,\n    values: (data[key] ?? []).map(v => Number(v)),\n  }))\n\n  return { labels, series }\n}\n\nexport function toJSON(data: ChartData, options?: ToJSONOptions): unknown {\n  const format = options?.format ?? 'rows'\n\n  if (format === 'columnar') {\n    const result: Record<string, unknown[]> = {}\n    if (data.labels) {\n      result['labels'] = data.labels.map(l => l instanceof Date ? l.toISOString() : l)\n    }\n    for (const s of data.series) {\n      result[s.name] = [...s.values]\n    }\n    return result\n  }\n\n  // rows format: array of objects\n  const rowCount = data.series[0]?.values.length ?? 0\n  const rows: Record<string, unknown>[] = []\n  for (let i = 0; i < rowCount; i++) {\n    const row: Record<string, unknown> = {}\n    if (data.labels) {\n      const label = data.labels[i]\n      row['label'] = label instanceof Date ? label.toISOString() : label\n    }\n    for (const s of data.series) {\n      row[s.name] = s.values[i]\n    }\n    rows.push(row)\n  }\n  return rows\n}\n"]}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@chartts/json",
+  "version": "0.1.3",
+  "description": "JSON 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"
+  }
+}