@chartts/parquet 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,66 @@
+'use strict';
+
+var hyparquet = require('hyparquet');
+
+// src/index.ts
+function isNumeric(value) {
+  return typeof value === "number" && !isNaN(value);
+}
+async function fromParquet(buffer, options) {
+  let file;
+  if (buffer instanceof Uint8Array) {
+    const copy = new ArrayBuffer(buffer.byteLength);
+    new Uint8Array(copy).set(buffer);
+    file = copy;
+  } else {
+    file = buffer;
+  }
+  let columns;
+  if (options?.seriesColumns || options?.labelColumn) {
+    columns = [];
+    if (options.labelColumn) columns.push(options.labelColumn);
+    if (options.seriesColumns) columns.push(...options.seriesColumns);
+  }
+  let rows = [];
+  await hyparquet.parquetRead({
+    file,
+    rowFormat: "object",
+    columns,
+    rowStart: options?.rowLimit ? 0 : void 0,
+    rowEnd: options?.rowLimit ?? void 0,
+    onComplete(data) {
+      rows = data;
+    }
+  });
+  if (rows.length === 0) return { series: [] };
+  const keys = Object.keys(rows[0]);
+  let labelKey = options?.labelColumn;
+  if (!labelKey) {
+    labelKey = keys.find(
+      (k) => rows.some((row) => !isNumeric(row[k]))
+    ) ?? keys[0];
+  }
+  let seriesKeys = options?.seriesColumns;
+  if (!seriesKeys) {
+    seriesKeys = keys.filter((k) => {
+      if (k === labelKey) return false;
+      return rows.every((row) => {
+        const v = row[k];
+        return v == null || isNumeric(v);
+      });
+    });
+  }
+  const labels = rows.map((row) => String(row[labelKey] ?? ""));
+  const series = seriesKeys.map((key) => ({
+    name: key,
+    values: rows.map((row) => {
+      const v = row[key];
+      return isNumeric(v) ? v : 0;
+    })
+  }));
+  return { labels, series };
+}
+
+exports.fromParquet = fromParquet;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["parquetRead"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ChartData, Series } from '@chartts/core'\nimport { parquetRead } from 'hyparquet'\n\nexport interface FromParquetOptions {\n  /** Which column to use as labels (column name) */\n  labelColumn?: string\n  /** Which columns to use as series (column names). Default: all numeric columns */\n  seriesColumns?: string[]\n  /** Maximum number of rows to read */\n  rowLimit?: number\n}\n\nfunction isNumeric(value: unknown): boolean {\n  return typeof value === 'number' && !isNaN(value)\n}\n\nexport async function fromParquet(buffer: ArrayBuffer | Uint8Array, options?: FromParquetOptions): Promise<ChartData> {\n  let file: ArrayBuffer\n  if (buffer instanceof Uint8Array) {\n    // Copy into a plain ArrayBuffer (Uint8Array.buffer may be SharedArrayBuffer)\n    const copy = new ArrayBuffer(buffer.byteLength)\n    new Uint8Array(copy).set(buffer)\n    file = copy\n  } else {\n    file = buffer\n  }\n\n  let columns: string[] | undefined\n  if (options?.seriesColumns || options?.labelColumn) {\n    columns = []\n    if (options.labelColumn) columns.push(options.labelColumn)\n    if (options.seriesColumns) columns.push(...options.seriesColumns)\n  }\n\n  let rows: Record<string, unknown>[] = []\n\n  await parquetRead({\n    file,\n    rowFormat: 'object',\n    columns,\n    rowStart: options?.rowLimit ? 0 : undefined,\n    rowEnd: options?.rowLimit ?? undefined,\n    onComplete(data: Record<string, unknown>[]) {\n      rows = data\n    },\n  })\n\n  if (rows.length === 0) return { series: [] }\n\n  const keys = Object.keys(rows[0]!)\n\n  // Resolve label column\n  let labelKey = options?.labelColumn\n  if (!labelKey) {\n    labelKey = keys.find(k =>\n      rows.some(row => !isNumeric(row[k]))\n    ) ?? keys[0]!\n  }\n\n  // Resolve series columns\n  let seriesKeys = options?.seriesColumns\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 v == null || isNumeric(v)\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      return isNumeric(v) ? (v as number) : 0\n    }),\n  }))\n\n  return { labels, series }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,13 @@
+import { ChartData } from '@chartts/core';
+
+interface FromParquetOptions {
+    /** Which column to use as labels (column name) */
+    labelColumn?: string;
+    /** Which columns to use as series (column names). Default: all numeric columns */
+    seriesColumns?: string[];
+    /** Maximum number of rows to read */
+    rowLimit?: number;
+}
+declare function fromParquet(buffer: ArrayBuffer | Uint8Array, options?: FromParquetOptions): Promise<ChartData>;
+
+export { type FromParquetOptions, fromParquet };

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import { ChartData } from '@chartts/core';
+
+interface FromParquetOptions {
+    /** Which column to use as labels (column name) */
+    labelColumn?: string;
+    /** Which columns to use as series (column names). Default: all numeric columns */
+    seriesColumns?: string[];
+    /** Maximum number of rows to read */
+    rowLimit?: number;
+}
+declare function fromParquet(buffer: ArrayBuffer | Uint8Array, options?: FromParquetOptions): Promise<ChartData>;
+
+export { type FromParquetOptions, fromParquet };

package/dist/index.js

@@ -0,0 +1,64 @@
+import { parquetRead } from 'hyparquet';
+
+// src/index.ts
+function isNumeric(value) {
+  return typeof value === "number" && !isNaN(value);
+}
+async function fromParquet(buffer, options) {
+  let file;
+  if (buffer instanceof Uint8Array) {
+    const copy = new ArrayBuffer(buffer.byteLength);
+    new Uint8Array(copy).set(buffer);
+    file = copy;
+  } else {
+    file = buffer;
+  }
+  let columns;
+  if (options?.seriesColumns || options?.labelColumn) {
+    columns = [];
+    if (options.labelColumn) columns.push(options.labelColumn);
+    if (options.seriesColumns) columns.push(...options.seriesColumns);
+  }
+  let rows = [];
+  await parquetRead({
+    file,
+    rowFormat: "object",
+    columns,
+    rowStart: options?.rowLimit ? 0 : void 0,
+    rowEnd: options?.rowLimit ?? void 0,
+    onComplete(data) {
+      rows = data;
+    }
+  });
+  if (rows.length === 0) return { series: [] };
+  const keys = Object.keys(rows[0]);
+  let labelKey = options?.labelColumn;
+  if (!labelKey) {
+    labelKey = keys.find(
+      (k) => rows.some((row) => !isNumeric(row[k]))
+    ) ?? keys[0];
+  }
+  let seriesKeys = options?.seriesColumns;
+  if (!seriesKeys) {
+    seriesKeys = keys.filter((k) => {
+      if (k === labelKey) return false;
+      return rows.every((row) => {
+        const v = row[k];
+        return v == null || isNumeric(v);
+      });
+    });
+  }
+  const labels = rows.map((row) => String(row[labelKey] ?? ""));
+  const series = seriesKeys.map((key) => ({
+    name: key,
+    values: rows.map((row) => {
+      const v = row[key];
+      return isNumeric(v) ? v : 0;
+    })
+  }));
+  return { labels, series };
+}
+
+export { fromParquet };
+//# 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 { parquetRead } from 'hyparquet'\n\nexport interface FromParquetOptions {\n  /** Which column to use as labels (column name) */\n  labelColumn?: string\n  /** Which columns to use as series (column names). Default: all numeric columns */\n  seriesColumns?: string[]\n  /** Maximum number of rows to read */\n  rowLimit?: number\n}\n\nfunction isNumeric(value: unknown): boolean {\n  return typeof value === 'number' && !isNaN(value)\n}\n\nexport async function fromParquet(buffer: ArrayBuffer | Uint8Array, options?: FromParquetOptions): Promise<ChartData> {\n  let file: ArrayBuffer\n  if (buffer instanceof Uint8Array) {\n    // Copy into a plain ArrayBuffer (Uint8Array.buffer may be SharedArrayBuffer)\n    const copy = new ArrayBuffer(buffer.byteLength)\n    new Uint8Array(copy).set(buffer)\n    file = copy\n  } else {\n    file = buffer\n  }\n\n  let columns: string[] | undefined\n  if (options?.seriesColumns || options?.labelColumn) {\n    columns = []\n    if (options.labelColumn) columns.push(options.labelColumn)\n    if (options.seriesColumns) columns.push(...options.seriesColumns)\n  }\n\n  let rows: Record<string, unknown>[] = []\n\n  await parquetRead({\n    file,\n    rowFormat: 'object',\n    columns,\n    rowStart: options?.rowLimit ? 0 : undefined,\n    rowEnd: options?.rowLimit ?? undefined,\n    onComplete(data: Record<string, unknown>[]) {\n      rows = data\n    },\n  })\n\n  if (rows.length === 0) return { series: [] }\n\n  const keys = Object.keys(rows[0]!)\n\n  // Resolve label column\n  let labelKey = options?.labelColumn\n  if (!labelKey) {\n    labelKey = keys.find(k =>\n      rows.some(row => !isNumeric(row[k]))\n    ) ?? keys[0]!\n  }\n\n  // Resolve series columns\n  let seriesKeys = options?.seriesColumns\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 v == null || isNumeric(v)\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      return isNumeric(v) ? (v as number) : 0\n    }),\n  }))\n\n  return { labels, series }\n}\n"]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@chartts/parquet",
+  "version": "0.1.3",
+  "description": "Parquet import 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": {
+    "hyparquet": "^1.7.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chartts/chartts"
+  },
+  "homepage": "https://chartts.com",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}