@milaboratories/pf-driver 1.8.4 → 1.9.0

package/src/csv_writer.ts

@@ -21,7 +21,9 @@ export interface PTableDataSource {
 
 /** Format a CSV/TSV header row from column specs. Line ending is CRLF. */
 export function formatHeader(specs: PTableColumnSpec[], separator: string): string {
-  return specs.map((spec) => escapeField(columnLabel(spec), separator)).join(separator) + "\r\n";
+  return (
+    specs.map((spec) => escapeField(getNativeColumnLabel(spec), separator)).join(separator) + "\r\n"
+  );
 }
 
 /** Format a single data row from parallel vectors. Line ending is CRLF. */
@@ -44,6 +46,13 @@ export interface StreamPTableRowsOptions {
   pTable: PTableDataSource;
   specs: PTableColumnSpec[];
   columnIndices: number[];
+  /**
+   * Header names aligned 1:1 with `columnIndices`. When provided they are
+   * written verbatim, letting callers supply disambiguated labels the spec's
+   * intrinsic `pl7.app/label` may not carry. When omitted the header is derived
+   * from `specs` via {@link getNativeColumnLabel}.
+   */
+  headerNames?: string[];
   range?: TableRange;
   chunkSize: number;
   separator: string;
@@ -52,16 +61,27 @@ export interface StreamPTableRowsOptions {
   signal?: AbortSignal;
 }
 export async function* streamPTableRows(options: StreamPTableRowsOptions): AsyncIterable<string> {
-  const { pTable, columnIndices, range, chunkSize, separator, signal, specs, includeHeader, bom } =
+  const { pTable, columnIndices, headerNames, range, chunkSize, separator, signal, specs } =
     options;
+  const { includeHeader, bom } = options;
+
+  if (headerNames !== undefined && headerNames.length !== columnIndices.length) {
+    throw new Error(
+      `headerNames length (${headerNames.length}) must match columnIndices length (${columnIndices.length})`,
+    );
+  }
 
   if (bom) {
     yield "\uFEFF";
   }
 
   if (includeHeader) {
-    const selectedSpecs = columnIndices.map((index) => specs[index]);
-    yield formatHeader(selectedSpecs, separator);
+    yield headerNames !== undefined
+      ? headerNames.map((name) => escapeField(name, separator)).join(separator) + "\r\n"
+      : formatHeader(
+          columnIndices.map((index) => specs[index]),
+          separator,
+        );
   }
 
   if (isNil(range)) {
@@ -89,7 +109,7 @@ export async function* streamPTableRows(options: StreamPTableRowsOptions): Async
 // ── Helpers (low-level) ──────────────────────────────────────────────
 
 /** Extract a human-readable label from a PTableColumnSpec. */
-export function columnLabel(spec: PTableColumnSpec): string {
+export function getNativeColumnLabel(spec: PTableColumnSpec): string {
   const annotation = readAnnotation(spec.spec, Annotation.Label);
   return isNil(annotation) ? spec.spec.name : annotation.trim();
 }

package/src/driver_decl.ts

@@ -105,8 +105,9 @@ export interface AbstractInternalPFrameDriver<PColumnData> extends PFrameDriver,
   /**
    * Export the table to a file, selecting the format from the extension of
    * `options.path` (`csv`/`tsv`/`parquet`/`xlsx`). `options.columnIndices`
-   * selects the columns to export (output order); headers are derived from
-   * each field's label annotation (falling back to the spec name).
+   * selects the columns to export (output order); optional
+   * `options.headerNames` (aligned 1:1) names them, with a missing or empty
+   * entry falling back to the field's label annotation (then the spec name).
    */
   exportPTable(
     handle: PTableHandle,

package/src/driver_double.test.ts

@@ -527,7 +527,11 @@ test("exportPTable writes a CSV with derived headers", async ({ expect }) => {
   try {
     const filePath = join(tempDir, "table.csv");
 
-    await uiDriver.exportPTable(pTable.key, { path: filePath, columnIndices: [0, 1] });
+    // Omitted headerNames fall back to labels derived from the column/axis specs.
+    await uiDriver.exportPTable(pTable.key, {
+      path: filePath,
+      columnIndices: [0, 1],
+    });
 
     const content = fs.readFileSync(filePath, "utf-8");
     const lines = content.split(/\r?\n/).filter((l) => l.length > 0);
@@ -540,3 +544,109 @@ test("exportPTable writes a CSV with derived headers", async ({ expect }) => {
     fs.rmSync(tempDir, { recursive: true, force: true });
   }
 });
+
+test("exportPTable writes caller-supplied header names verbatim", async ({ expect }) => {
+  await using driver = await createPFrameDriverDouble({});
+
+  const columnId = "column1" as PObjectId;
+  const column = {
+    id: columnId,
+    spec: {
+      kind: "PColumn" as const,
+      axesSpec: [
+        {
+          name: "axis1",
+          type: "String" as const,
+          annotations: { "pl7.app/label": "Sample" },
+        },
+      ],
+      name: "column1",
+      valueType: "Int" as const,
+      annotations: { "pl7.app/label": "Score" },
+    },
+    data: [
+      { key: ["a"], val: 10 },
+      { key: ["b"], val: 20 },
+      { key: ["c"], val: 30 },
+    ],
+  };
+
+  const uiDriver: PFrameDriver = driver;
+
+  using pTable = driver.createPTableV2({ query: { type: "column", column } });
+
+  const tempDir = fs.mkdtempSync(join(os.tmpdir(), "pf-export-"));
+  try {
+    const filePath = join(tempDir, "table.csv");
+
+    // Caller-supplied names (the disambiguated labels the UI shows) win over the
+    // spec's intrinsic `pl7.app/label`.
+    await uiDriver.exportPTable(pTable.key, {
+      path: filePath,
+      columnIndices: [0, 1],
+      headerNames: ["Sample id", "Score (disambiguated)"],
+    });
+
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split(/\r?\n/).filter((l) => l.length > 0);
+
+    expect(lines[0]).toBe("Sample id,Score (disambiguated)");
+    expect(lines.slice(1)).toEqual(["a,10", "b,20", "c,30"]);
+  } finally {
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  }
+});
+
+test("writePTableToFs writes caller-supplied header names verbatim", async ({ expect }) => {
+  await using driver = await createPFrameDriverDouble({});
+
+  const columnId = "column1" as PObjectId;
+  const column = {
+    id: columnId,
+    spec: {
+      kind: "PColumn" as const,
+      axesSpec: [
+        {
+          name: "axis1",
+          type: "String" as const,
+          annotations: { "pl7.app/label": "Sample" },
+        },
+      ],
+      name: "column1",
+      valueType: "Int" as const,
+      annotations: { "pl7.app/label": "Score" },
+    },
+    data: [
+      { key: ["a"], val: 10 },
+      { key: ["b"], val: 20 },
+      { key: ["c"], val: 30 },
+    ],
+  };
+
+  const uiDriver: PFrameDriver = driver;
+
+  using pTable = driver.createPTableV2({ query: { type: "column", column } });
+
+  const tempDir = fs.mkdtempSync(join(os.tmpdir(), "pf-export-"));
+  try {
+    const filePath = join(tempDir, "table.csv");
+
+    // Fallback path (writePTableToFs): caller-supplied names win over the spec
+    // labels, mirroring the native exportPTable path.
+    await uiDriver.writePTableToFs(pTable.key, {
+      path: filePath,
+      format: "csv",
+      columnIndices: [0, 1],
+      headerNames: ["Sample id", "Score (disambiguated)"],
+    });
+
+    // Strip the leading BOM the CSV writer emits by default.
+    const content = fs.readFileSync(filePath, "utf-8").replace(/^/, "");
+    const lines = content.split(/\r?\n/).filter((l) => l.length > 0);
+
+    expect(lines[0]).toBe("Sample id,Score (disambiguated)");
+    expect(lines.slice(1)).toEqual(["a,10", "b,20", "c,30"]);
+  } finally {
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  }
+});

package/src/driver_impl.ts

@@ -44,13 +44,13 @@ import {
 } from "@milaboratories/ts-helpers";
 import { isNil, PoolEntryGuard, type PoolEntry } from "@milaboratories/helpers";
 import { PFrameFactory } from "@milaboratories/pframes-rs-node";
-import { expandAxes, findTableColumn, rewriteLegacyFilters } from "@milaboratories/pframes-rs-wasm";
+import { expandAxes, findTableColumn, rewriteLegacyFilters } from "@milaboratories/pf-spec";
 import { tmpdir } from "node:os";
 import * as fs from "node:fs";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import * as zlib from "node:zlib";
-import { columnLabel, streamPTableRows } from "./csv_writer";
+import { getNativeColumnLabel, streamPTableRows } from "./csv_writer";
 import type {
   AbstractInternalPFrameDriver,
   WritePTableToFsOptions,
@@ -297,6 +297,14 @@ export class AbstractPFrameDriver<
     const { pTablePromise, disposeSignal } = tableGuard.resource;
     const pTable = await pTablePromise;
 
+    // Caller-supplied header names win (they carry the disambiguated labels the
+    // UI shows); a missing or empty name falls back to the spec-derived label.
+    const { columnIndices } = options;
+    const headerNames = columnIndices.map((index, i) => {
+      const name = options.headerNames?.[i];
+      return name !== undefined && name !== "" ? name : getNativeColumnLabel(def.tableSpec[index]);
+    });
+
     const combinedSignal = AbortSignal.any(
       [options.signal, disposeSignal].filter((s): s is AbortSignal => !isNil(s)),
     );
@@ -316,7 +324,8 @@ export class AbstractPFrameDriver<
       const iterable = streamPTableRows({
         pTable,
         specs,
-        columnIndices: options.columnIndices,
+        columnIndices,
+        headerNames,
         range: clippedRange,
         chunkSize: options.chunkSize ?? 50_000,
         separator,
@@ -354,7 +363,7 @@ export class AbstractPFrameDriver<
         const durationMs = Math.round(performance.now() - startTime);
         this.logger(
           "info",
-          `[WritePTableToFs] complete (handle = ${handle}, columns = ${options.columnIndices.length}, rows = ${rowsWritten}, bytes = ${bytesWritten}, duration = ${durationMs}ms)`,
+          `[WritePTableToFs] complete (handle = ${handle}, columns = ${columnIndices.length}, rows = ${rowsWritten}, bytes = ${bytesWritten}, duration = ${durationMs}ms)`,
         );
       }
 
@@ -384,10 +393,15 @@ export class AbstractPFrameDriver<
       [signal, disposeSignal].filter((s): s is AbortSignal => !isNil(s)),
     );
 
-    const headers: [number, string][] = columnIndices.map((index): [number, string] => [
-      index,
-      columnLabel(def.tableSpec[index]),
-    ]);
+    // Caller-supplied header names win (they carry the disambiguated labels the
+    // UI shows); a missing or empty name falls back to the spec-derived label.
+    const headers: [number, string][] = columnIndices.map((index, i): [number, string] => {
+      const name = options.headerNames?.[i];
+      return [
+        index,
+        name !== undefined && name !== "" ? name : getNativeColumnLabel(def.tableSpec[index]),
+      ];
+    });
 
     // keep()/cache live outside the limiter task: on abort `run` rejects and they are
     // skipped, so an abandoned (detached) operation never caches its result nor touches

package/src/pframe_pool.ts

@@ -16,7 +16,7 @@ import {
 import { hashJson, PFrameInternal } from "@milaboratories/pl-model-middle-layer";
 import { RefCountPoolBase, type PoolEntry } from "@milaboratories/helpers";
 import { PFrameFactory } from "@milaboratories/pframes-rs-node";
-import { createPFrame as createPFrameSpec } from "@milaboratories/pframes-rs-wasm";
+import { createPFrame as createPFrameSpec, type PFrame } from "@milaboratories/pf-spec";
 import { mapValues } from "es-toolkit";
 import { logPFrames } from "./logging";
 
@@ -37,7 +37,7 @@ export class PFrameHolder<TreeEntry extends JsonSerializable> implements Disposa
    * for spec-side operations: column discovery, selector resolution,
    * legacy-query lowering.
    */
-  public readonly pFrameSpec: PFrameInternal.PFrameWasmV3;
+  public readonly pFrameSpec: PFrame;
   public readonly columnSpecs: Readonly<Record<PObjectId, PColumnSpec>>;
   private readonly abortController = new AbortController();
 

package/src/ptable_def_pool.ts

@@ -6,6 +6,7 @@ import {
   type PTableHandle,
 } from "@milaboratories/pl-model-common";
 import type { PFrameInternal } from "@milaboratories/pl-model-middle-layer";
+import type { PFrame } from "@milaboratories/pf-spec";
 import { RefCountPoolBase, type PoolEntry } from "@milaboratories/helpers";
 import { logPFrames } from "./logging";
 import type { FullPTableDef } from "./ptable_shared";
@@ -70,7 +71,7 @@ export class PTableDefPool extends RefCountPoolBase<FullPTableDef, PTableHandle,
   public acquireFromLegacy(opts: {
     pFrameHandle: PFrameHandle;
     def: PTableDef<PObjectId>;
-    pFrameSpec: PFrameInternal.PFrameWasmV3;
+    pFrameSpec: PFrame;
   }): { def: FullPTableDef; entry: PoolEntry<PTableHandle> } {
     const def = buildFullPTableDefFromLegacy(opts);
     return { def, entry: this.acquire(def) };

package/src/ptable_pool.ts

@@ -8,6 +8,7 @@ import {
   type PObjectId,
 } from "@milaboratories/pl-model-common";
 import type { PFrameInternal } from "@milaboratories/pl-model-middle-layer";
+import type { PFrame } from "@milaboratories/pf-spec";
 import { RefCountPoolBase, type PoolEntry } from "@milaboratories/helpers";
 import { logPFrames } from "./logging";
 import type { PFramePool } from "./pframe_pool";
@@ -117,7 +118,7 @@ export class PTablePool<TreeEntry extends JsonSerializable> extends RefCountPool
   public acquireFromLegacy(opts: {
     pFrameHandle: PFrameHandle;
     def: PTableDef<PObjectId>;
-    pFrameSpec: PFrameInternal.PFrameWasmV3;
+    pFrameSpec: PFrame;
   }): { def: FullPTableDef; entry: PoolEntry<PTableHandle, PTableHolder> } {
     const def = buildFullPTableDefFromLegacy(opts);
     return { def, entry: this.acquire(def) };

package/src/ptable_shared.ts

@@ -10,6 +10,7 @@ import type {
 } from "@milaboratories/pl-model-common";
 import { traverseQuerySpec } from "@milaboratories/pl-model-common";
 import { hashJson, PFrameInternal } from "@milaboratories/pl-model-middle-layer";
+import type { LegacyQuery, PFrame } from "@milaboratories/pf-spec";
 
 /**
  * Make every inline column in a `SpecQuery` self-contained by embedding its
@@ -54,10 +55,10 @@ export function stableKeyFromFullPTableDef(data: FullPTableDef): PTableHandle {
  * WASM-spec frame.
  */
 export function lowerLegacyPTableDef(
-  pFrameSpec: PFrameInternal.PFrameWasmV3,
+  pFrameSpec: PFrame,
   legacyDef: PTableDef<PObjectId>,
 ): { tableSpec: PTableColumnSpec[]; dataQuery: DataQuery } {
-  const legacy: PFrameInternal.LegacyQuery = {
+  const legacy: LegacyQuery = {
     src: legacyDef.src,
     filters: [...legacyDef.partitionFilters, ...legacyDef.filters],
     sorting: legacyDef.sorting,
@@ -75,7 +76,7 @@ export function lowerLegacyPTableDef(
 export function buildFullPTableDefFromLegacy(opts: {
   pFrameHandle: PFrameHandle;
   def: PTableDef<PObjectId>;
-  pFrameSpec: PFrameInternal.PFrameWasmV3;
+  pFrameSpec: PFrame;
 }): FullPTableDef {
   return {
     pFrameHandle: opts.pFrameHandle,

package/dist/_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/usingCtx.cjs

@@ -1,57 +0,0 @@
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/usingCtx.js
-function _usingCtx() {
-	var r = "function" == typeof SuppressedError ? SuppressedError : function(r, e) {
-		var n = Error();
-		return n.name = "SuppressedError", n.error = r, n.suppressed = e, n;
-	}, e = {}, n = [];
-	function using(r, e) {
-		if (null != e) {
-			if (Object(e) !== e) throw new TypeError("using declarations can only be used with objects, functions, null, or undefined.");
-			if (r) var o = e[Symbol.asyncDispose || Symbol["for"]("Symbol.asyncDispose")];
-			if (void 0 === o && (o = e[Symbol.dispose || Symbol["for"]("Symbol.dispose")], r)) var t = o;
-			if ("function" != typeof o) throw new TypeError("Object is not disposable.");
-			t && (o = function o() {
-				try {
-					t.call(e);
-				} catch (r) {
-					return Promise.reject(r);
-				}
-			}), n.push({
-				v: e,
-				d: o,
-				a: r
-			});
-		} else r && n.push({
-			d: e,
-			a: r
-		});
-		return e;
-	}
-	return {
-		e,
-		u: using.bind(null, !1),
-		a: using.bind(null, !0),
-		d: function d() {
-			var o, t = this.e, s = 0;
-			function next() {
-				for (; o = n.pop();) try {
-					if (!o.a && 1 === s) return s = 0, n.push(o), Promise.resolve().then(next);
-					if (o.d) {
-						var r = o.d.call(o.v);
-						if (o.a) return s |= 2, Promise.resolve(r).then(next, err);
-					} else s |= 1;
-				} catch (r) {
-					return err(r);
-				}
-				if (1 === s) return t !== e ? Promise.reject(t) : Promise.resolve();
-				if (t !== e) throw t;
-			}
-			function err(n) {
-				return t = t !== e ? new r(n, t) : n, next();
-			}
-			return next();
-		}
-	};
-}
-//#endregion
-exports.default = _usingCtx;

package/dist/_virtual/_rolldown/runtime.cjs

@@ -1,23 +0,0 @@
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
-exports.__toESM = __toESM;

package/dist/csv_writer.cjs

@@ -1,81 +0,0 @@
-let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
-let _milaboratories_helpers = require("@milaboratories/helpers");
-//#region src/csv_writer.ts
-/** Format a CSV/TSV header row from column specs. Line ending is CRLF. */
-function formatHeader(specs, separator) {
-	return specs.map((spec) => escapeField(columnLabel(spec), separator)).join(separator) + "\r\n";
-}
-/** Format a single data row from parallel vectors. Line ending is CRLF. */
-function formatRow(vectors, rowIndex, separator) {
-	return vectors.map((vector) => escapeField(serializeValue(vector, rowIndex), separator)).join(separator) + "\r\n";
-}
-async function* streamPTableRows(options) {
-	const { pTable, columnIndices, range, chunkSize, separator, signal, specs, includeHeader, bom } = options;
-	if (bom) yield "";
-	if (includeHeader) yield formatHeader(columnIndices.map((index) => specs[index]), separator);
-	if ((0, _milaboratories_helpers.isNil)(range)) return;
-	const end = range.offset + range.length;
-	for (let from = range.offset; from < end; from += chunkSize) {
-		signal?.throwIfAborted();
-		const length = Math.min(chunkSize, end - from);
-		const subRange = {
-			offset: from,
-			length
-		};
-		const vectors = await pTable.getData(columnIndices, {
-			range: subRange,
-			signal
-		});
-		const rows = [];
-		for (let rowIndex = 0; rowIndex < length; rowIndex++) rows.push(formatRow(vectors, rowIndex, separator));
-		yield rows.join("");
-	}
-}
-/** Extract a human-readable label from a PTableColumnSpec. */
-function columnLabel(spec) {
-	const annotation = (0, _milaboratories_pl_model_common.readAnnotation)(spec.spec, _milaboratories_pl_model_common.Annotation.Label);
-	return (0, _milaboratories_helpers.isNil)(annotation) ? spec.spec.name : annotation.trim();
-}
-/**
-* RFC 4180 field escaping.
-* Quote if the field contains the separator, a double-quote, CR, or LF.
-* Embedded `"` are doubled.
-*/
-function escapeField(value, separator) {
-	return needsQuoting(value, separator) ? "\"" + value.replace(/"/g, "\"\"") + "\"" : value;
-}
-/** Returns true when the value must be wrapped in double-quotes. */
-function needsQuoting(value, separator) {
-	return value.includes(separator) || value.includes("\"") || value.includes("\r") || value.includes("\n");
-}
-/**
-* Serialize one cell value from a typed vector to its string representation.
-*
-* - `null` / `undefined`  -> `""`
-* - `bigint`              -> `String(x)`
-* - `NaN` / `+Inf` / `-Inf` -> `""`
-*/
-function serializeValue(vector, rowIndex) {
-	const rawValue = vector.data[rowIndex];
-	if ((0, _milaboratories_helpers.isNil)(rawValue)) return "";
-	if ((0, _milaboratories_pl_model_common.isValueNA)(vector, rowIndex)) return "";
-	switch (vector.type) {
-		case _milaboratories_pl_model_common.ValueType.Long: return String(rawValue);
-		case _milaboratories_pl_model_common.ValueType.Float:
-		case _milaboratories_pl_model_common.ValueType.Double: {
-			const numeric = rawValue;
-			return Number.isNaN(numeric) || !Number.isFinite(numeric) ? "" : String(numeric);
-		}
-		case _milaboratories_pl_model_common.ValueType.Int: return String(rawValue);
-		case _milaboratories_pl_model_common.ValueType.String: return rawValue;
-		case _milaboratories_pl_model_common.ValueType.Bytes: return "";
-		default: return String(rawValue);
-	}
-}
-//#endregion
-exports.columnLabel = columnLabel;
-exports.formatHeader = formatHeader;
-exports.formatRow = formatRow;
-exports.streamPTableRows = streamPTableRows;
-
-//# sourceMappingURL=csv_writer.cjs.map

package/dist/csv_writer.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"csv_writer.cjs","names":["Annotation","ValueType"],"sources":["../src/csv_writer.ts"],"sourcesContent":["import {\n  Annotation,\n  isValueNA,\n  readAnnotation,\n  ValueType,\n  type PTableColumnSpec,\n  type PTableVector,\n  type TableRange,\n} from \"@milaboratories/pl-model-common\";\nimport { isNil } from \"@milaboratories/helpers\";\n\n/** Minimal subset of PTable required by streamPTableRows. */\nexport interface PTableDataSource {\n  getData(\n    columnIndices: number[],\n    options?: { range?: TableRange; signal?: AbortSignal },\n  ): Promise<PTableVector[]>;\n}\n\n// ── Public API (high-level → low-level) ──────────────────────────────\n\n/** Format a CSV/TSV header row from column specs. Line ending is CRLF. */\nexport function formatHeader(specs: PTableColumnSpec[], separator: string): string {\n  return specs.map((spec) => escapeField(columnLabel(spec), separator)).join(separator) + \"\\r\\n\";\n}\n\n/** Format a single data row from parallel vectors. Line ending is CRLF. */\nexport function formatRow(vectors: PTableVector[], rowIndex: number, separator: string): string {\n  return (\n    vectors\n      .map((vector) => escapeField(serializeValue(vector, rowIndex), separator))\n      .join(separator) + \"\\r\\n\"\n  );\n}\n\n/**\n * Async generator that streams CSV/TSV content chunk by chunk.\n *\n * The caller is responsible for providing a concrete `range` (already clipped\n * to the table shape). When `range` is undefined the generator does nothing\n * beyond emitting an optional BOM and header.\n */\nexport interface StreamPTableRowsOptions {\n  pTable: PTableDataSource;\n  specs: PTableColumnSpec[];\n  columnIndices: number[];\n  range?: TableRange;\n  chunkSize: number;\n  separator: string;\n  includeHeader: boolean;\n  bom: boolean;\n  signal?: AbortSignal;\n}\nexport async function* streamPTableRows(options: StreamPTableRowsOptions): AsyncIterable<string> {\n  const { pTable, columnIndices, range, chunkSize, separator, signal, specs, includeHeader, bom } =\n    options;\n\n  if (bom) {\n    yield \"\\uFEFF\";\n  }\n\n  if (includeHeader) {\n    const selectedSpecs = columnIndices.map((index) => specs[index]);\n    yield formatHeader(selectedSpecs, separator);\n  }\n\n  if (isNil(range)) {\n    return;\n  }\n\n  const end = range.offset + range.length;\n\n  for (let from = range.offset; from < end; from += chunkSize) {\n    signal?.throwIfAborted();\n\n    const length = Math.min(chunkSize, end - from);\n    const subRange: TableRange = { offset: from, length };\n\n    const vectors = await pTable.getData(columnIndices, { range: subRange, signal });\n\n    const rows: string[] = [];\n    for (let rowIndex = 0; rowIndex < length; rowIndex++) {\n      rows.push(formatRow(vectors, rowIndex, separator));\n    }\n    yield rows.join(\"\");\n  }\n}\n\n// ── Helpers (low-level) ──────────────────────────────────────────────\n\n/** Extract a human-readable label from a PTableColumnSpec. */\nexport function columnLabel(spec: PTableColumnSpec): string {\n  const annotation = readAnnotation(spec.spec, Annotation.Label);\n  return isNil(annotation) ? spec.spec.name : annotation.trim();\n}\n\n/**\n * RFC 4180 field escaping.\n * Quote if the field contains the separator, a double-quote, CR, or LF.\n * Embedded `\"` are doubled.\n */\nfunction escapeField(value: string, separator: string): string {\n  return needsQuoting(value, separator) ? '\"' + value.replace(/\"/g, '\"\"') + '\"' : value;\n}\n\n/** Returns true when the value must be wrapped in double-quotes. */\nfunction needsQuoting(value: string, separator: string): boolean {\n  return (\n    value.includes(separator) || value.includes('\"') || value.includes(\"\\r\") || value.includes(\"\\n\")\n  );\n}\n\n/**\n * Serialize one cell value from a typed vector to its string representation.\n *\n * - `null` / `undefined`  -> `\"\"`\n * - `bigint`              -> `String(x)`\n * - `NaN` / `+Inf` / `-Inf` -> `\"\"`\n */\nfunction serializeValue(vector: PTableVector, rowIndex: number): string {\n  const rawValue = vector.data[rowIndex];\n\n  if (isNil(rawValue)) {\n    return \"\";\n  }\n\n  if (isValueNA(vector, rowIndex)) {\n    return \"\";\n  }\n\n  switch (vector.type) {\n    case ValueType.Long: {\n      // BigInt64Array element — may be stored as bigint\n      return String(rawValue);\n    }\n    case ValueType.Float:\n    case ValueType.Double: {\n      const numeric = rawValue as number;\n      return Number.isNaN(numeric) || !Number.isFinite(numeric) ? \"\" : String(numeric);\n    }\n    case ValueType.Int: {\n      return String(rawValue);\n    }\n    case ValueType.String: {\n      return rawValue as string;\n    }\n    case ValueType.Bytes: {\n      return \"\";\n    }\n    default: {\n      return String(rawValue);\n    }\n  }\n}\n"],"mappings":";;;;AAsBA,SAAgB,aAAa,OAA2B,WAA2B;CACjF,OAAO,MAAM,KAAK,SAAS,YAAY,YAAY,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI;AAC1F;;AAGA,SAAgB,UAAU,SAAyB,UAAkB,WAA2B;CAC9F,OACE,QACG,KAAK,WAAW,YAAY,eAAe,QAAQ,QAAQ,GAAG,SAAS,CAAC,CAAC,CACzE,KAAK,SAAS,IAAI;AAEzB;AAoBA,gBAAuB,iBAAiB,SAAyD;CAC/F,MAAM,EAAE,QAAQ,eAAe,OAAO,WAAW,WAAW,QAAQ,OAAO,eAAe,QACxF;CAEF,IAAI,KACF,MAAM;CAGR,IAAI,eAEF,MAAM,aADgB,cAAc,KAAK,UAAU,MAAM,MAC1B,GAAG,SAAS;CAG7C,KAAA,GAAA,wBAAA,MAAA,CAAU,KAAK,GACb;CAGF,MAAM,MAAM,MAAM,SAAS,MAAM;CAEjC,KAAK,IAAI,OAAO,MAAM,QAAQ,OAAO,KAAK,QAAQ,WAAW;EAC3D,QAAQ,eAAe;EAEvB,MAAM,SAAS,KAAK,IAAI,WAAW,MAAM,IAAI;EAC7C,MAAM,WAAuB;GAAE,QAAQ;GAAM;EAAO;EAEpD,MAAM,UAAU,MAAM,OAAO,QAAQ,eAAe;GAAE,OAAO;GAAU;EAAO,CAAC;EAE/E,MAAM,OAAiB,CAAC;EACxB,KAAK,IAAI,WAAW,GAAG,WAAW,QAAQ,YACxC,KAAK,KAAK,UAAU,SAAS,UAAU,SAAS,CAAC;EAEnD,MAAM,KAAK,KAAK,EAAE;CACpB;AACF;;AAKA,SAAgB,YAAY,MAAgC;CAC1D,MAAM,cAAA,GAAA,gCAAA,eAAA,CAA4B,KAAK,MAAMA,gCAAAA,WAAW,KAAK;CAC7D,QAAA,GAAA,wBAAA,MAAA,CAAa,UAAU,IAAI,KAAK,KAAK,OAAO,WAAW,KAAK;AAC9D;;;;;;AAOA,SAAS,YAAY,OAAe,WAA2B;CAC7D,OAAO,aAAa,OAAO,SAAS,IAAI,OAAM,MAAM,QAAQ,MAAM,MAAI,IAAI,OAAM;AAClF;;AAGA,SAAS,aAAa,OAAe,WAA4B;CAC/D,OACE,MAAM,SAAS,SAAS,KAAK,MAAM,SAAS,IAAG,KAAK,MAAM,SAAS,IAAI,KAAK,MAAM,SAAS,IAAI;AAEnG;;;;;;;;AASA,SAAS,eAAe,QAAsB,UAA0B;CACtE,MAAM,WAAW,OAAO,KAAK;CAE7B,KAAA,GAAA,wBAAA,MAAA,CAAU,QAAQ,GAChB,OAAO;CAGT,KAAA,GAAA,gCAAA,UAAA,CAAc,QAAQ,QAAQ,GAC5B,OAAO;CAGT,QAAQ,OAAO,MAAf;EACE,KAAKC,gCAAAA,UAAU,MAEb,OAAO,OAAO,QAAQ;EAExB,KAAKA,gCAAAA,UAAU;EACf,KAAKA,gCAAAA,UAAU,QAAQ;GACrB,MAAM,UAAU;GAChB,OAAO,OAAO,MAAM,OAAO,KAAK,CAAC,OAAO,SAAS,OAAO,IAAI,KAAK,OAAO,OAAO;EACjF;EACA,KAAKA,gCAAAA,UAAU,KACb,OAAO,OAAO,QAAQ;EAExB,KAAKA,gCAAAA,UAAU,QACb,OAAO;EAET,KAAKA,gCAAAA,UAAU,OACb,OAAO;EAET,SACE,OAAO,OAAO,QAAQ;CAE1B;AACF"}

package/dist/data_info_helpers.cjs

@@ -1,23 +0,0 @@
-let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
-//#region src/data_info_helpers.ts
-function makeJsonDataInfo(spec, data) {
-	const keyLength = spec.axesSpec.length;
-	const jsonData = {};
-	for (const { key, val } of data) {
-		if (key.length !== keyLength) {
-			const error = new _milaboratories_pl_model_common.PFrameDriverError(`Inconsistent inline column key length`);
-			error.cause = /* @__PURE__ */ new Error(`Inline column key length ${key.length} differs from axes count ${keyLength}`);
-			throw error;
-		}
-		jsonData[JSON.stringify(key)] = val;
-	}
-	return {
-		type: "Json",
-		keyLength,
-		data: jsonData
-	};
-}
-//#endregion
-exports.makeJsonDataInfo = makeJsonDataInfo;
-
-//# sourceMappingURL=data_info_helpers.cjs.map

package/dist/data_info_helpers.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"data_info_helpers.cjs","names":["PFrameDriverError"],"sources":["../src/data_info_helpers.ts"],"sourcesContent":["import {\n  PFrameDriverError,\n  type PColumnSpec,\n  type PColumnValues,\n  type JsonDataInfo,\n  type PColumnValue,\n} from \"@milaboratories/pl-model-common\";\n\nexport function makeJsonDataInfo(spec: PColumnSpec, data: PColumnValues): JsonDataInfo {\n  const keyLength = spec.axesSpec.length;\n  const jsonData: Record<string, PColumnValue> = {};\n  for (const { key, val } of data) {\n    if (key.length !== keyLength) {\n      const error = new PFrameDriverError(`Inconsistent inline column key length`);\n      error.cause = new Error(\n        `Inline column key length ${key.length} differs from axes count ${keyLength}`,\n      );\n      throw error;\n    }\n    jsonData[JSON.stringify(key)] = val;\n  }\n\n  return {\n    type: \"Json\",\n    keyLength,\n    data: jsonData,\n  };\n}\n"],"mappings":";;AAQA,SAAgB,iBAAiB,MAAmB,MAAmC;CACrF,MAAM,YAAY,KAAK,SAAS;CAChC,MAAM,WAAyC,CAAC;CAChD,KAAK,MAAM,EAAE,KAAK,SAAS,MAAM;EAC/B,IAAI,IAAI,WAAW,WAAW;GAC5B,MAAM,QAAQ,IAAIA,gCAAAA,kBAAkB,uCAAuC;GAC3E,MAAM,wBAAQ,IAAI,MAChB,4BAA4B,IAAI,OAAO,2BAA2B,WACpE;GACA,MAAM;EACR;EACA,SAAS,KAAK,UAAU,GAAG,KAAK;CAClC;CAEA,OAAO;EACL,MAAM;EACN;EACA,MAAM;CACR;AACF"}