jsonstat-io 0.1.0

package/dist/chunk-62NIY7ML.js

@@ -0,0 +1,191 @@
+// src/sources/csv.ts
+var CsvSourceError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CsvSourceError";
+  }
+};
+function parseCsv(input, delimiter = ",") {
+  const rows = [];
+  let row = [];
+  let field = "";
+  let inQuotes = false;
+  const delim = delimiter.charCodeAt(0);
+  for (let i = 0; i < input.length; i++) {
+    const c = input.charCodeAt(i);
+    if (inQuotes) {
+      if (c === 34) {
+        if (input.charCodeAt(i + 1) === 34) {
+          field += '"';
+          i++;
+        } else {
+          inQuotes = false;
+        }
+      } else {
+        field += input[i];
+      }
+    } else {
+      if (c === 34) {
+        inQuotes = true;
+      } else if (c === delim) {
+        row.push(field);
+        field = "";
+      } else if (c === 13) {
+        if (input.charCodeAt(i + 1) === 10) i++;
+        row.push(field);
+        rows.push(row);
+        row = [];
+        field = "";
+      } else if (c === 10) {
+        row.push(field);
+        rows.push(row);
+        row = [];
+        field = "";
+      } else {
+        field += input[i];
+      }
+    }
+  }
+  if (field.length > 0 || row.length > 0) {
+    row.push(field);
+    rows.push(row);
+  }
+  return rows;
+}
+function isAllNumeric(values) {
+  let any = false;
+  for (const v of values) {
+    if (v === "") continue;
+    any = true;
+    const n = Number(v);
+    if (!Number.isFinite(n)) return false;
+  }
+  return any;
+}
+function csvToCube(text, options = {}) {
+  const delimiter = options.delimiter ?? ",";
+  const header = options.header ?? true;
+  const rows = parseCsv(text, delimiter);
+  if (rows.length === 0) throw new CsvSourceError("CSV has no rows");
+  let headerNames;
+  let dataRows;
+  if (header) {
+    headerNames = rows[0];
+    dataRows = rows.slice(1);
+  } else {
+    headerNames = rows[0].map((_, i) => `col${i}`);
+    dataRows = rows;
+  }
+  if (headerNames.length === 0) throw new CsvSourceError("CSV header is empty");
+  if (dataRows.length === 0) throw new CsvSourceError("CSV has no data rows");
+  const colCount = headerNames.length;
+  const columns = headerNames.map(() => []);
+  for (const r of dataRows) {
+    for (let c = 0; c < colCount; c++) columns[c].push(r[c] ?? "");
+  }
+  let measureIdx = headerNames.findIndex((n2) => n2 === options.measure);
+  if (measureIdx === -1) {
+    measureIdx = columns.findIndex((col) => isAllNumeric(col));
+    if (measureIdx === -1) {
+      throw new CsvSourceError(
+        "No measure column found: no column is fully numeric. Pass options.measure to name one (values will be parsed with Number())."
+      );
+    }
+  }
+  let statusIdx = headerNames.findIndex((n2) => n2 === options.status);
+  if (statusIdx === -1 && !options.status) {
+    statusIdx = headerNames.findIndex((n2) => n2.toLowerCase() === "status");
+    if (statusIdx === measureIdx) statusIdx = -1;
+  }
+  let dimensionIdxs;
+  if (options.dimensions) {
+    dimensionIdxs = options.dimensions.map((n2) => {
+      const idx = headerNames.indexOf(n2);
+      if (idx === -1) throw new CsvSourceError(`Dimension column "${n2}" not found in CSV header`);
+      return idx;
+    });
+  } else {
+    dimensionIdxs = headerNames.map((_, i) => i).filter((i) => i !== measureIdx && i !== statusIdx);
+    if (dimensionIdxs.length === 0) {
+      throw new CsvSourceError("No dimension columns remain after measure/status selection");
+    }
+  }
+  dataRows.length;
+  const dimensions = {};
+  for (const idx of dimensionIdxs) {
+    const name = headerNames[idx];
+    dimensions[name] = {
+      id: name,
+      values: columns[idx].map((v) => v === "" ? "" : v)
+    };
+  }
+  const measure = {
+    name: headerNames[measureIdx],
+    values: columns[measureIdx].map((v) => v === "" ? null : Number(v))
+  };
+  let status;
+  if (statusIdx !== -1) {
+    status = { values: columns[statusIdx].map((v) => v) };
+  }
+  const observations = {
+    dimensions,
+    measure,
+    status,
+    model: {
+      dimensionIds: dimensionIdxs.map((i) => headerNames[i]),
+      roles: options.roles,
+      valueForm: options.valueForm ?? "auto",
+      statusForm: status ? "auto" : "none"
+    }
+  };
+  return observations;
+}
+async function csvToDataset(text, options) {
+  const { toDataset } = await import('./cubeBuilder-BEGA4C5Y.js');
+  return toDataset(csvToCube(text, options));
+}
+function cubeColumns(obs) {
+  const dimIds = obs.model.dimensionIds;
+  const measureName = obs.measure.name ?? "value";
+  const hasStatus = obs.status !== void 0;
+  const header = [...dimIds, measureName];
+  if (hasStatus) header.push("status");
+  const n = obs.measure.values.length;
+  const rows = new Array(n);
+  for (let i = 0; i < n; i++) {
+    const cells = [];
+    for (const id of dimIds) {
+      const col = obs.dimensions[id];
+      cells.push(col ? col.values[i] : "");
+    }
+    const v = obs.measure.values[i];
+    cells.push(v === null ? "" : String(v));
+    if (hasStatus) cells.push(obs.status.values[i] ?? "");
+    rows[i] = cells.join("\0");
+  }
+  return { header, rows };
+}
+function quoteCsvField(value, delimiter, force = false) {
+  const needsQuoting = force || value.includes(delimiter) || value.includes('"') || value.includes("\r") || value.includes("\n");
+  if (!needsQuoting) return value;
+  return `"${value.replace(/"/g, '""')}"`;
+}
+function serializeRows(header, rows, options = {}) {
+  const delimiter = options.delimiter ?? ",";
+  const eol = options.lineTerminator ?? "\r\n";
+  const parts = [];
+  parts.push(header.map((h) => quoteCsvField(h, delimiter)).join(delimiter));
+  for (const row of rows) {
+    const cells = row.split("\0");
+    parts.push(cells.map((c) => quoteCsvField(c, delimiter)).join(delimiter));
+  }
+  return parts.join(eol) + eol;
+}
+function cubeToCsv(obs, options = {}) {
+  const { header, rows } = cubeColumns(obs);
+  return serializeRows(header, rows, options);
+}
+
+export { CsvSourceError, csvToCube, csvToDataset, cubeColumns, cubeToCsv, parseCsv, quoteCsvField, serializeRows };
+//# sourceMappingURL=chunk-62NIY7ML.js.map
+//# sourceMappingURL=chunk-62NIY7ML.js.map

package/dist/chunk-62NIY7ML.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sources/csv.ts"],"names":["n"],"mappings":"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","file":"chunk-62NIY7ML.js","sourcesContent":["/**\n * CSV adapter — `jsonstat-io/csv`.\n *\n * **Import:** unlike Parquet/DuckDB/Polars (which funnel through the Arrow\n * hub), plain CSV has no native Arrow producer in this package, so this adapter\n * builds the [`Observations`](../model/ir.ts) IR **directly** from parsed rows.\n *\n * **Export:** [`cubeToCsv`] writes the [`Observations`] IR to RFC-4180-style\n * CSV text (dimension columns + measure column + optional status column).\n *\n * ## Mapping heuristics (no metadata)\n *\n * Without a schema, the adapter infers:\n *  - The **measure** is the first column that parses as a number for every\n *    non-empty row (or the one named by `options.measure`).\n *  - Every other column is a **dimension** (string-typed), in file order.\n *  - A column named `status` (case-insensitive) is treated as the status\n *    column unless `options.status` overrides it.\n *\n * Empty cells become `null` in the measure and `\"\"` in dimensions (then\n * rejected by the builder; sources should pre-clean). For richer, lossless\n * mapping with declared types/labels/roles, use CSVW (see [`csvw`](./csvw.ts)).\n */\n\nimport type {\n  DimensionColumn,\n  MeasureColumn,\n  Observations,\n  RoleMap,\n  StatusColumn,\n} from \"../model/ir\";\nimport type { JsonStatDataset } from \"../model/jsonstat\";\n\n// ---------------------------------------------------------------------------\n// Errors & options\n// ---------------------------------------------------------------------------\n\nexport class CsvSourceError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CsvSourceError\";\n  }\n}\n\nexport interface CsvToCubeOptions {\n  /** Explicit measure column name. Overrides inference. */\n  measure?: string;\n  /** Explicit dimension column names, in order. */\n  dimensions?: string[];\n  /** Explicit status column name. Overrides the `status`-name heuristic. */\n  status?: string;\n  /** Role assignments. */\n  roles?: RoleMap;\n  /** Value-form hint. */\n  valueForm?: \"auto\" | \"dense\" | \"sparse\";\n  /** CSV delimiter (default \",\"). */\n  delimiter?: string;\n  /** Treat the first row as a header (default true). */\n  header?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Minimal CSV parser\n// ---------------------------------------------------------------------------\n\n/**\n * A tiny, dependency-free RFC-4180-ish CSV parser. Handles quoted fields,\n * embedded quotes (doubled), and embedded newlines. Sufficient for the\n * importer's needs; for heavy CSV work, prefer piping through DuckDB/Polars.\n */\nexport function parseCsv(input: string, delimiter = \",\"): string[][] {\n  const rows: string[][] = [];\n  let row: string[] = [];\n  let field = \"\";\n  let inQuotes = false;\n  const delim = delimiter.charCodeAt(0);\n\n  for (let i = 0; i < input.length; i++) {\n    const c = input.charCodeAt(i);\n    if (inQuotes) {\n      if (c === 34 /* \" */) {\n        // Doubled quote → literal quote; otherwise end quote.\n        if (input.charCodeAt(i + 1) === 34) {\n          field += '\"';\n          i++;\n        } else {\n          inQuotes = false;\n        }\n      } else {\n        field += input[i];\n      }\n    } else {\n      if (c === 34) {\n        inQuotes = true;\n      } else if (c === delim) {\n        row.push(field);\n        field = \"\";\n      } else if (c === 13 /* \\r */) {\n        // swallow; handle \\n\n        if (input.charCodeAt(i + 1) === 10) i++;\n        row.push(field);\n        rows.push(row);\n        row = [];\n        field = \"\";\n      } else if (c === 10 /* \\n */) {\n        row.push(field);\n        rows.push(row);\n        row = [];\n        field = \"\";\n      } else {\n        field += input[i];\n      }\n    }\n  }\n  // Flush trailing field/row.\n  if (field.length > 0 || row.length > 0) {\n    row.push(field);\n    rows.push(row);\n  }\n  return rows;\n}\n\n// ---------------------------------------------------------------------------\n// Type inference\n// ---------------------------------------------------------------------------\n\n/** Does every non-empty value parse as a finite number? */\nfunction isAllNumeric(values: string[]): boolean {\n  let any = false;\n  for (const v of values) {\n    if (v === \"\") continue;\n    any = true;\n    const n = Number(v);\n    if (!Number.isFinite(n)) return false;\n  }\n  return any;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Parse CSV text into the [`Observations`] IR.\n *\n * @throws [`CsvSourceError`] on structural problems.\n */\nexport function csvToCube(text: string, options: CsvToCubeOptions = {}): Observations {\n  const delimiter = options.delimiter ?? \",\";\n  const header = options.header ?? true;\n  const rows = parseCsv(text, delimiter);\n  if (rows.length === 0) throw new CsvSourceError(\"CSV has no rows\");\n\n  let headerNames: string[];\n  let dataRows: string[][];\n  if (header) {\n    headerNames = rows[0];\n    dataRows = rows.slice(1);\n  } else {\n    headerNames = rows[0].map((_, i) => `col${i}`);\n    dataRows = rows;\n  }\n  if (headerNames.length === 0) throw new CsvSourceError(\"CSV header is empty\");\n  if (dataRows.length === 0) throw new CsvSourceError(\"CSV has no data rows\");\n\n  const colCount = headerNames.length;\n\n  // Transpose into columnar arrays for inference.\n  const columns: string[][] = headerNames.map(() => []);\n  for (const r of dataRows) {\n    // Pad/truncate to header length.\n    for (let c = 0; c < colCount; c++) columns[c].push(r[c] ?? \"\");\n  }\n\n  // Resolve measure column.\n  let measureIdx = headerNames.findIndex((n) => n === options.measure);\n  if (measureIdx === -1) {\n    // Inference: first all-numeric column.\n    measureIdx = columns.findIndex((col) => isAllNumeric(col));\n    if (measureIdx === -1) {\n      throw new CsvSourceError(\n        \"No measure column found: no column is fully numeric. \" +\n          \"Pass options.measure to name one (values will be parsed with Number()).\",\n      );\n    }\n  }\n\n  // Resolve status column.\n  let statusIdx = headerNames.findIndex((n) => n === options.status);\n  if (statusIdx === -1 && !options.status) {\n    statusIdx = headerNames.findIndex((n) => n.toLowerCase() === \"status\");\n    if (statusIdx === measureIdx) statusIdx = -1;\n  }\n\n  // Resolve dimensions: everything that's not measure or status.\n  let dimensionIdxs: number[];\n  if (options.dimensions) {\n    dimensionIdxs = options.dimensions.map((n) => {\n      const idx = headerNames.indexOf(n);\n      if (idx === -1) throw new CsvSourceError(`Dimension column \"${n}\" not found in CSV header`);\n      return idx;\n    });\n  } else {\n    dimensionIdxs = headerNames\n      .map((_, i) => i)\n      .filter((i) => i !== measureIdx && i !== statusIdx);\n    if (dimensionIdxs.length === 0) {\n      throw new CsvSourceError(\"No dimension columns remain after measure/status selection\");\n    }\n  }\n\n  const n = dataRows.length;\n  const dimensions: Record<string, DimensionColumn> = {};\n  for (const idx of dimensionIdxs) {\n    const name = headerNames[idx];\n    dimensions[name] = {\n      id: name,\n      values: columns[idx].map((v) => (v === \"\" ? \"\" : v)),\n    };\n  }\n\n  const measure: MeasureColumn = {\n    name: headerNames[measureIdx],\n    values: columns[measureIdx].map((v) => (v === \"\" ? null : Number(v))),\n  };\n\n  let status: StatusColumn | undefined;\n  if (statusIdx !== -1) {\n    status = { values: columns[statusIdx].map((v) => v) };\n  }\n\n  const observations: Observations = {\n    dimensions,\n    measure,\n    status,\n    model: {\n      dimensionIds: dimensionIdxs.map((i) => headerNames[i]),\n      roles: options.roles,\n      valueForm: options.valueForm ?? \"auto\",\n      statusForm: status ? \"auto\" : \"none\",\n    },\n  };\n  // n unused guard (kept for clarity; columns already encode length).\n  void n;\n\n  return observations;\n}\n\n/** Convenience: CSV text → JSON-stat [`Dataset`]. */\nexport async function csvToDataset(\n  text: string,\n  options?: CsvToCubeOptions,\n): Promise<JsonStatDataset> {\n  const { toDataset } = await import(\"../core/cubeBuilder\");\n  return toDataset(csvToCube(text, options));\n}\n\n// ---------------------------------------------------------------------------\n// Export: Observations IR → CSV text\n// ---------------------------------------------------------------------------\n\nexport interface CubeToCsvOptions {\n  /** CSV delimiter (default \",\"). */\n  delimiter?: string;\n  /** Line terminator: \"\\r\\n\" (RFC-4180 default) or \"\\n\". */\n  lineTerminator?: string;\n}\n\n/**\n * Resolve the ordered list of (column name, row value extractor) pairs for a\n * dataset IR. Shared by [`cubeToCsv`] and [`cubeToCsvw`] so the two writers\n * agree on column layout.\n *\n * Column order: dimension IDs (in `model.dimensionIds` order) → measure\n * (named `measure.name ?? \"value\"`) → status (`\"status\"`, if present).\n *\n * @internal\n */\nexport function cubeColumns(obs: Observations): {\n  header: string[];\n  rows: string[];\n} {\n  const dimIds = obs.model.dimensionIds;\n  const measureName = obs.measure.name ?? \"value\";\n  const hasStatus = obs.status !== undefined;\n\n  const header: string[] = [...dimIds, measureName];\n  if (hasStatus) header.push(\"status\");\n\n  const n = obs.measure.values.length;\n  const rows: string[] = new Array(n);\n  for (let i = 0; i < n; i++) {\n    const cells: string[] = [];\n    for (const id of dimIds) {\n      const col = obs.dimensions[id];\n      cells.push(col ? col.values[i] : \"\");\n    }\n    const v = obs.measure.values[i];\n    cells.push(v === null ? \"\" : String(v));\n    if (hasStatus) cells.push(obs.status!.values[i] ?? \"\");\n    rows[i] = cells.join(\"\\u0000\"); // placeholder; real delimiter applied later\n  }\n  return { header, rows };\n}\n\n/**\n * Quote a single CSV field per RFC-4180. A field needs quoting if it contains\n * the delimiter, a double quote, a CR, or an LF. Embedded quotes are doubled.\n */\nexport function quoteCsvField(\n  value: string,\n  delimiter: string,\n  force = false,\n): string {\n  const needsQuoting =\n    force ||\n    value.includes(delimiter) ||\n    value.includes('\"') ||\n    value.includes(\"\\r\") ||\n    value.includes(\"\\n\");\n  if (!needsQuoting) return value;\n  return `\"${value.replace(/\"/g, '\"\"')}\"`;\n}\n\n/**\n * Serialize a CSV header + rows (as produced by [`cubeColumns`]) into RFC-4180\n * text. Extracted so CSV and CSVW writers share one escaping path.\n *\n * @internal\n */\nexport function serializeRows(\n  header: string[],\n  rows: string[],\n  options: CubeToCsvOptions = {},\n): string {\n  const delimiter = options.delimiter ?? \",\";\n  const eol = options.lineTerminator ?? \"\\r\\n\";\n  const parts: string[] = [];\n  parts.push(header.map((h) => quoteCsvField(h, delimiter)).join(delimiter));\n  for (const row of rows) {\n    const cells = row.split(\"\\u0000\");\n    parts.push(cells.map((c) => quoteCsvField(c, delimiter)).join(delimiter));\n  }\n  return parts.join(eol) + eol;\n}\n\n/**\n * Write the [`Observations`](../model/ir.ts) IR to RFC-4180-style CSV text.\n *\n * The output is a tidy long table: one header row + one row per observation.\n * Columns are the dimension IDs (in `model.dimensionIds` order), then the\n * measure column (`measure.name ?? \"value\"`), then an optional `status`\n * column. Null measures are emitted as empty cells.\n *\n * This is the lossy inverse of [`csvToCube`]: labels, roles, and category\n * metadata are not preserved (use [`cubeToCsvw`] for a lossless export).\n *\n * @example\n * ```ts\n * import { cubeToCsv } from \"jsonstat-io/csv\";\n * const csv = cubeToCsv(observations);\n * ```\n */\nexport function cubeToCsv(\n  obs: Observations,\n  options: CubeToCsvOptions = {},\n): string {\n  const { header, rows } = cubeColumns(obs);\n  return serializeRows(header, rows, options);\n}\n\n"]}

package/dist/chunk-AXUZF6O5.cjs

@@ -0,0 +1,352 @@
+'use strict';
+
+var chunkGDKDYLZ4_cjs = require('./chunk-GDKDYLZ4.cjs');
+var chunkPHLCWTHB_cjs = require('./chunk-PHLCWTHB.cjs');
+var apacheArrow = require('apache-arrow');
+
+// src/model/jsonstat.ts
+function isDataset(r) {
+  return r.class === "dataset";
+}
+function isCollection(r) {
+  return r.class === "collection";
+}
+function isDimensionResponse(r) {
+  return r.class === "dimension";
+}
+
+// src/model/ir.ts
+function observationCount(obs) {
+  return obs.measure.values.length;
+}
+
+// src/sink/serialize.ts
+var KEY_ORDER = [
+  "version",
+  "class",
+  "label",
+  "href",
+  "source",
+  "updated",
+  "id",
+  "size",
+  "dimension",
+  "role",
+  "value",
+  "status",
+  "extension",
+  "link",
+  "note",
+  "error"
+];
+function serialize(response, options = {}) {
+  const pretty = options.pretty ?? true;
+  const canonical = options.canonicalKeys ?? true;
+  let value = response;
+  if (pretty && canonical) {
+    value = reorderKeys(response, KEY_ORDER);
+  }
+  return pretty ? JSON.stringify(value, null, 2) : JSON.stringify(value);
+}
+function serializeToBytes(response, options) {
+  return new TextEncoder().encode(serialize(response, options));
+}
+function reorderKeys(obj, order) {
+  const source = obj;
+  const out = {};
+  const known = /* @__PURE__ */ new Set();
+  for (const k of order) {
+    if (k in source) {
+      out[k] = source[k];
+      known.add(k);
+    }
+  }
+  const rest = Object.keys(source).filter((k) => !known.has(k)).sort();
+  for (const k of rest) out[k] = source[k];
+  return out;
+}
+
+// src/util/detect.ts
+var PARQUET_MAGIC = [80, 65, 82, 49];
+var ARROW_MAGIC = [65, 82, 82, 79, 87, 49];
+function bytesStartWith(bytes, magic) {
+  if (bytes.length < magic.length) return false;
+  for (let i = 0; i < magic.length; i++) {
+    if (bytes[i] !== magic[i]) return false;
+  }
+  return true;
+}
+function detectFromBytes(bytes) {
+  const view = bytes instanceof ArrayBuffer ? new Uint8Array(bytes) : bytes;
+  if (bytesStartWith(view, PARQUET_MAGIC)) return "parquet";
+  if (bytesStartWith(view, ARROW_MAGIC)) return "arrow";
+  const head = view.slice(0, Math.min(64, view.length));
+  const text = new TextDecoder().decode(head).trimStart();
+  if (text.startsWith("{") || text.startsWith("[")) {
+    if (text.includes("json-stat") || text.includes('"class"') && text.includes('"version"')) {
+      return "jsonstat";
+    }
+    return "json";
+  }
+  if (text.includes(",") || text.includes(";") || text.includes("	")) return "csv";
+  return "unknown";
+}
+function detectFromExtension(ext) {
+  const e = ext.toLowerCase().replace(/^\./, "");
+  switch (e) {
+    case "parquet":
+      return "parquet";
+    case "arrow":
+    case "ipc":
+    case "feather":
+      return "arrow";
+    case "csv":
+      return "csv";
+    case "csvw":
+    case "csv-metadata":
+      return "csvw";
+    case "json-stat":
+    case "jsonstat":
+      return "jsonstat";
+    case "json":
+      return "jsonstat";
+    // assume JSON-stat by default for .json
+    default:
+      return "unknown";
+  }
+}
+function extensionOf(path) {
+  const clean = path.split("?")[0]?.split("#")[0] ?? path;
+  const dot = clean.lastIndexOf(".");
+  const slash = Math.max(clean.lastIndexOf("/"), clean.lastIndexOf("\\"));
+  if (dot === -1 || dot < slash) return void 0;
+  return clean.slice(dot + 1);
+}
+function detectFormat(pathOrUrl, bytes) {
+  if (pathOrUrl) {
+    const ext = extensionOf(pathOrUrl);
+    if (ext) {
+      const byExt = detectFromExtension(ext);
+      if (byExt !== "unknown") return byExt;
+    }
+  }
+  if (bytes) return detectFromBytes(bytes);
+  return "unknown";
+}
+
+// src/util/density.ts
+function decideDensity(values, requested = "auto", options = {}) {
+  const total = values.length;
+  const threshold = options.threshold ?? 0.5;
+  let nullCount = 0;
+  for (const v of values) {
+    if (v === null) nullCount++;
+  }
+  const nullRatio = total === 0 ? 0 : nullCount / total;
+  let form;
+  if (requested === "dense") form = "dense";
+  else if (requested === "sparse") form = "sparse";
+  else form = nullRatio > threshold ? "sparse" : "dense";
+  return { form, nullRatio, nullCount, total };
+}
+
+// src/util/fetch.ts
+function isNode() {
+  return typeof process !== "undefined" && typeof process.versions !== "undefined" && typeof process.versions.node === "string";
+}
+async function loadInput(source) {
+  if (source instanceof Uint8Array) {
+    return { bytes: source };
+  }
+  if (typeof Blob !== "undefined" && source instanceof Blob) {
+    const buf = await source.arrayBuffer();
+    return { bytes: new Uint8Array(buf), source: source.name };
+  }
+  if (typeof source !== "string") {
+    throw new TypeError(`loadInput: unsupported source type ${typeof source}`);
+  }
+  if (source === "-") {
+    if (!isNode()) {
+      throw new Error('loadInput: stdin ("-") is only supported in Node');
+    }
+    const bytes = await readStdin();
+    return { bytes, fromStdin: true };
+  }
+  if (/^https?:\/\//i.test(source) || /^file:\/\//i.test(source)) {
+    const res = await fetch(source);
+    if (!res.ok) {
+      throw new Error(`loadInput: fetch ${source} failed: ${res.status} ${res.statusText}`);
+    }
+    const buf = await res.arrayBuffer();
+    return { bytes: new Uint8Array(buf), source };
+  }
+  if (isNode()) {
+    const bytes = await readFileNode(source);
+    return { bytes, source };
+  }
+  throw new Error(
+    `loadInput: cannot resolve "${source}" in a browser without a URL scheme`
+  );
+}
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk instanceof Uint8Array ? chunk : new Uint8Array(chunk));
+  }
+  const total = chunks.reduce((n, c) => n + c.length, 0);
+  const out = new Uint8Array(total);
+  let off = 0;
+  for (const c of chunks) {
+    out.set(c, off);
+    off += c.length;
+  }
+  return out;
+}
+async function readFileNode(path) {
+  const { readFile } = await import('fs/promises');
+  const buf = await readFile(path);
+  return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+}
+var ImporterError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ImporterError";
+  }
+};
+async function importToCube(source, options = {}) {
+  const loaded = await loadInput(source);
+  let format;
+  if (options.from && options.from !== "auto") {
+    format = options.from;
+  } else if (loaded.source) {
+    format = detectFormat(loaded.source, loaded.bytes);
+  } else {
+    format = detectFromBytes(loaded.bytes);
+  }
+  switch (format) {
+    case "arrow": {
+      const table = apacheArrow.tableFromIPC(loaded.bytes);
+      return chunkPHLCWTHB_cjs.arrowToCube(table, options);
+    }
+    case "parquet": {
+      const { parquetToCube } = await import('./sources/parquet.cjs');
+      return parquetToCube(loaded.bytes, options);
+    }
+    case "csv": {
+      const { csvToCube } = await import('./sources/csv.cjs');
+      const text = new TextDecoder().decode(loaded.bytes);
+      return csvToCube(text, {
+        measure: options.measure,
+        dimensions: options.dimensions,
+        status: options.status,
+        roles: options.roles,
+        delimiter: options.delimiter
+      });
+    }
+    case "csvw": {
+      const { csvwToCube, parseCsvwMetadata } = await import('./sources/csvw.cjs');
+      const text = new TextDecoder().decode(loaded.bytes);
+      let metadata;
+      if (options.csvwMetadata !== void 0) {
+        metadata = parseCsvwMetadata(options.csvwMetadata);
+      } else if (loaded.source) {
+        try {
+          const metaPath = siblingMetadataPath(loaded.source);
+          const metaBytes = await loadInput(metaPath);
+          metadata = parseCsvwMetadata(
+            JSON.parse(new TextDecoder().decode(metaBytes.bytes))
+          );
+        } catch {
+          throw new ImporterError(
+            `CSVW metadata not supplied and could not be auto-loaded next to "${loaded.source}". Pass options.csvwMetadata or set options.from = "csv".`
+          );
+        }
+      }
+      if (metadata === void 0) {
+        throw new ImporterError(
+          "CSVW source requires metadata. Pass options.csvwMetadata."
+        );
+      }
+      return csvwToCube(text, metadata, {
+        measure: options.measure,
+        dimensions: options.dimensions,
+        status: options.status,
+        roles: options.roles
+      });
+    }
+    case "jsonstat":
+    case "json": {
+      const { readDataset: readDataset2 } = await import('./cubeReader-UN2BHQWK.cjs');
+      const parsed = JSON.parse(new TextDecoder().decode(loaded.bytes));
+      return readDataset2(parsed, { dropNulls: false });
+    }
+    default:
+      throw new ImporterError(
+        `Could not detect the source format. Set options.from explicitly (e.g. "parquet", "arrow", "csv", "csvw", "jsonstat"). DuckDB and Polars require a live connection/DataFrame \u2014 use the dedicated subpath import (e.g. import { duckdbToCube } from "jsonstat-io/duckdb").`
+      );
+  }
+}
+async function importToDataset(source, options = {}) {
+  const obs = await importToCube(source, options);
+  const result = chunkGDKDYLZ4_cjs.buildDataset(obs, options.build);
+  return result.dataset;
+}
+function siblingMetadataPath(csvPath) {
+  const dot = csvPath.lastIndexOf(".");
+  const base = dot > 0 ? csvPath.slice(0, dot) : csvPath;
+  return `${base}-metadata.json`;
+}
+async function exportDataset(dataset, options) {
+  const { readDataset: readDataset2 } = await import('./cubeReader-UN2BHQWK.cjs');
+  const obs = readDataset2(dataset, { dropNulls: false });
+  switch (options.to) {
+    case "arrow": {
+      return chunkPHLCWTHB_cjs.cubeToArrow(obs);
+    }
+    case "parquet": {
+      const { cubeToParquet } = await import('./sources/parquet.cjs');
+      return cubeToParquet(obs, {
+        init: options.init,
+        compression: options.compression
+      });
+    }
+    case "csv": {
+      const { cubeToCsv } = await import('./sources/csv.cjs');
+      return cubeToCsv(obs, {
+        delimiter: options.delimiter,
+        lineTerminator: options.lineTerminator
+      });
+    }
+    case "csvw": {
+      const { cubeToCsvw } = await import('./sources/csvw.cjs');
+      return cubeToCsvw(obs, {
+        delimiter: options.delimiter,
+        lineTerminator: options.lineTerminator,
+        url: options.url
+      });
+    }
+    default:
+      throw new ImporterError(
+        `Unsupported export target "${options.to}". Use one of: "arrow", "parquet", "csv", "csvw". For DuckDB/Polars, use the dedicated subpath writers.`
+      );
+  }
+}
+
+exports.ImporterError = ImporterError;
+exports.decideDensity = decideDensity;
+exports.detectFormat = detectFormat;
+exports.detectFromBytes = detectFromBytes;
+exports.detectFromExtension = detectFromExtension;
+exports.exportDataset = exportDataset;
+exports.extensionOf = extensionOf;
+exports.importToCube = importToCube;
+exports.importToDataset = importToDataset;
+exports.isCollection = isCollection;
+exports.isDataset = isDataset;
+exports.isDimensionResponse = isDimensionResponse;
+exports.loadInput = loadInput;
+exports.observationCount = observationCount;
+exports.serialize = serialize;
+exports.serializeToBytes = serializeToBytes;
+//# sourceMappingURL=chunk-AXUZF6O5.cjs.map
+//# sourceMappingURL=chunk-AXUZF6O5.cjs.map