@milaboratories/pl-model-common 1.47.2 → 1.48.0

package/dist/bmodel/block_kind_ref.cjs

@@ -0,0 +1,45 @@
+//#region src/bmodel/block_kind_ref.ts
+/**
+* Compose a {@link BlockKindReference} from a kind's `name`/`version`.
+*
+* The single place that decides how the reference is assembled. If global
+* uniqueness later requires the name segment to be org-qualified, this is the
+* one line that changes.
+*/
+const formatKindRef = (k) => `${k.name}@${k.version}`;
+/**
+* Split a `{name}@{version}` string on its version separator.
+*
+* The one place that decides where the name ends. Uses the LAST `@` so an
+* org-qualified npm name that itself starts with `@` (e.g.
+* `@platforma-open/pkg.kind`) keeps its whole name. A leading/absent separator
+* (`lastIndexOf("@") <= 0`) means the string carries no version segment —
+* malformed — so this throws rather than returning a silently version-less
+* result.
+*
+* Shared with the template layer, whose `{name}@{selector}` references use the
+* same split and differ only in how the right half is interpreted (see
+* `parseKindSelectorReference`). `what` names the thing being parsed so the
+* error message stays specific to the caller's reference type.
+*/
+const splitVersionedName = (ref, what = "block kind reference", expected = "{name}@{version}") => {
+	const at = ref.lastIndexOf("@");
+	if (at <= 0) throw new Error(`Malformed ${what} (expected '${expected}'): ${ref}`);
+	return {
+		name: ref.slice(0, at),
+		version: ref.slice(at + 1)
+	};
+};
+/**
+* Split a {@link BlockKindReference} back into `{ name, version }`.
+*
+* Throws on a reference with no version segment — see
+* {@link splitVersionedName}, which owns the split rule.
+*/
+const parseKindRef = (ref) => splitVersionedName(ref);
+//#endregion
+exports.formatKindRef = formatKindRef;
+exports.parseKindRef = parseKindRef;
+exports.splitVersionedName = splitVersionedName;
+
+//# sourceMappingURL=block_kind_ref.cjs.map

package/dist/bmodel/block_kind_ref.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_kind_ref.cjs","names":[],"sources":["../../src/bmodel/block_kind_ref.ts"],"sourcesContent":["import type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * On-wire reference to a block kind, canonically the string `{name}@{version}`.\n *\n * A branded string: readers overwhelmingly need identity equality (\"does block\n * X implement kind Y?\"), for which an opaque canonical string is ideal. Any\n * reader that needs the parts calls {@link parseKindRef}; any writer composes\n * the reference through {@link formatKindRef}. Keeping composition in a single\n * function localizes the one open decision — whether the name segment has to be\n * org-qualified for global uniqueness — to one place.\n */\nexport type BlockKindReference = Branded<string, \"BlockKindReference\">;\n\n/**\n * Compose a {@link BlockKindReference} from a kind's `name`/`version`.\n *\n * The single place that decides how the reference is assembled. If global\n * uniqueness later requires the name segment to be org-qualified, this is the\n * one line that changes.\n */\nexport const formatKindRef = (k: { name: string; version: string }): BlockKindReference =>\n  `${k.name}@${k.version}` as BlockKindReference;\n\n/**\n * Split a `{name}@{version}` string on its version separator.\n *\n * The one place that decides where the name ends. Uses the LAST `@` so an\n * org-qualified npm name that itself starts with `@` (e.g.\n * `@platforma-open/pkg.kind`) keeps its whole name. A leading/absent separator\n * (`lastIndexOf(\"@\") <= 0`) means the string carries no version segment —\n * malformed — so this throws rather than returning a silently version-less\n * result.\n *\n * Shared with the template layer, whose `{name}@{selector}` references use the\n * same split and differ only in how the right half is interpreted (see\n * `parseKindSelectorReference`). `what` names the thing being parsed so the\n * error message stays specific to the caller's reference type.\n */\nexport const splitVersionedName = (\n  ref: string,\n  what = \"block kind reference\",\n  expected = \"{name}@{version}\",\n): { name: string; version: string } => {\n  const at = ref.lastIndexOf(\"@\");\n  if (at <= 0) {\n    throw new Error(`Malformed ${what} (expected '${expected}'): ${ref}`);\n  }\n  return { name: ref.slice(0, at), version: ref.slice(at + 1) };\n};\n\n/**\n * Split a {@link BlockKindReference} back into `{ name, version }`.\n *\n * Throws on a reference with no version segment — see\n * {@link splitVersionedName}, which owns the split rule.\n */\nexport const parseKindRef = (ref: BlockKindReference): { name: string; version: string } =>\n  splitVersionedName(ref);\n"],"mappings":";;;;;;;;AAqBA,MAAa,iBAAiB,MAC5B,GAAG,EAAE,KAAK,GAAG,EAAE;;;;;;;;;;;;;;;;AAiBjB,MAAa,sBACX,KACA,OAAO,wBACP,WAAW,uBAC2B;CACtC,MAAM,KAAK,IAAI,YAAY,GAAG;CAC9B,IAAI,MAAM,GACR,MAAM,IAAI,MAAM,aAAa,KAAK,cAAc,SAAS,MAAM,KAAK;CAEtE,OAAO;EAAE,MAAM,IAAI,MAAM,GAAG,EAAE;EAAG,SAAS,IAAI,MAAM,KAAK,CAAC;CAAE;AAC9D;;;;;;;AAQA,MAAa,gBAAgB,QAC3B,mBAAmB,GAAG"}

package/dist/bmodel/block_kind_ref.d.ts

@@ -0,0 +1,57 @@
+import { Branded } from "@milaboratories/helpers";
+
+//#region src/bmodel/block_kind_ref.d.ts
+/**
+ * On-wire reference to a block kind, canonically the string `{name}@{version}`.
+ *
+ * A branded string: readers overwhelmingly need identity equality ("does block
+ * X implement kind Y?"), for which an opaque canonical string is ideal. Any
+ * reader that needs the parts calls {@link parseKindRef}; any writer composes
+ * the reference through {@link formatKindRef}. Keeping composition in a single
+ * function localizes the one open decision — whether the name segment has to be
+ * org-qualified for global uniqueness — to one place.
+ */
+type BlockKindReference = Branded<string, "BlockKindReference">;
+/**
+ * Compose a {@link BlockKindReference} from a kind's `name`/`version`.
+ *
+ * The single place that decides how the reference is assembled. If global
+ * uniqueness later requires the name segment to be org-qualified, this is the
+ * one line that changes.
+ */
+declare const formatKindRef: (k: {
+  name: string;
+  version: string;
+}) => BlockKindReference;
+/**
+ * Split a `{name}@{version}` string on its version separator.
+ *
+ * The one place that decides where the name ends. Uses the LAST `@` so an
+ * org-qualified npm name that itself starts with `@` (e.g.
+ * `@platforma-open/pkg.kind`) keeps its whole name. A leading/absent separator
+ * (`lastIndexOf("@") <= 0`) means the string carries no version segment —
+ * malformed — so this throws rather than returning a silently version-less
+ * result.
+ *
+ * Shared with the template layer, whose `{name}@{selector}` references use the
+ * same split and differ only in how the right half is interpreted (see
+ * `parseKindSelectorReference`). `what` names the thing being parsed so the
+ * error message stays specific to the caller's reference type.
+ */
+declare const splitVersionedName: (ref: string, what?: string, expected?: string) => {
+  name: string;
+  version: string;
+};
+/**
+ * Split a {@link BlockKindReference} back into `{ name, version }`.
+ *
+ * Throws on a reference with no version segment — see
+ * {@link splitVersionedName}, which owns the split rule.
+ */
+declare const parseKindRef: (ref: BlockKindReference) => {
+  name: string;
+  version: string;
+};
+//#endregion
+export { BlockKindReference, formatKindRef, parseKindRef, splitVersionedName };
+//# sourceMappingURL=block_kind_ref.d.ts.map

package/dist/bmodel/block_kind_ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_kind_ref.d.ts","names":[],"sources":["../../src/bmodel/block_kind_ref.ts"],"mappings":";;;;;AAYA;;;;AAAwC;AASxC;;;KATY,kBAAA,GAAqB,OAAO;;;;;;AAUQ;AAiBhD;cAlBa,aAAA,GAAiB,CAAA;EAAK,IAAA;EAAc,OAAA;AAAA,MAAoB,kBACrB;;;;;;AAqBtB;AAc1B;;;;;;;;;cAlBa,kBAAA,GACX,GAAA,UACA,IAAA,WACA,QAAA;EACG,IAAA;EAAc,OAAA;AAAA;;;;;;;cAcN,YAAA,GAAgB,GAAA,EAAK,kBAAkB;EAAK,IAAA;EAAc,OAAA;AAAA"}

package/dist/bmodel/block_kind_ref.js

@@ -0,0 +1,43 @@
+//#region src/bmodel/block_kind_ref.ts
+/**
+* Compose a {@link BlockKindReference} from a kind's `name`/`version`.
+*
+* The single place that decides how the reference is assembled. If global
+* uniqueness later requires the name segment to be org-qualified, this is the
+* one line that changes.
+*/
+const formatKindRef = (k) => `${k.name}@${k.version}`;
+/**
+* Split a `{name}@{version}` string on its version separator.
+*
+* The one place that decides where the name ends. Uses the LAST `@` so an
+* org-qualified npm name that itself starts with `@` (e.g.
+* `@platforma-open/pkg.kind`) keeps its whole name. A leading/absent separator
+* (`lastIndexOf("@") <= 0`) means the string carries no version segment —
+* malformed — so this throws rather than returning a silently version-less
+* result.
+*
+* Shared with the template layer, whose `{name}@{selector}` references use the
+* same split and differ only in how the right half is interpreted (see
+* `parseKindSelectorReference`). `what` names the thing being parsed so the
+* error message stays specific to the caller's reference type.
+*/
+const splitVersionedName = (ref, what = "block kind reference", expected = "{name}@{version}") => {
+	const at = ref.lastIndexOf("@");
+	if (at <= 0) throw new Error(`Malformed ${what} (expected '${expected}'): ${ref}`);
+	return {
+		name: ref.slice(0, at),
+		version: ref.slice(at + 1)
+	};
+};
+/**
+* Split a {@link BlockKindReference} back into `{ name, version }`.
+*
+* Throws on a reference with no version segment — see
+* {@link splitVersionedName}, which owns the split rule.
+*/
+const parseKindRef = (ref) => splitVersionedName(ref);
+//#endregion
+export { formatKindRef, parseKindRef, splitVersionedName };
+
+//# sourceMappingURL=block_kind_ref.js.map

package/dist/bmodel/block_kind_ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_kind_ref.js","names":[],"sources":["../../src/bmodel/block_kind_ref.ts"],"sourcesContent":["import type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * On-wire reference to a block kind, canonically the string `{name}@{version}`.\n *\n * A branded string: readers overwhelmingly need identity equality (\"does block\n * X implement kind Y?\"), for which an opaque canonical string is ideal. Any\n * reader that needs the parts calls {@link parseKindRef}; any writer composes\n * the reference through {@link formatKindRef}. Keeping composition in a single\n * function localizes the one open decision — whether the name segment has to be\n * org-qualified for global uniqueness — to one place.\n */\nexport type BlockKindReference = Branded<string, \"BlockKindReference\">;\n\n/**\n * Compose a {@link BlockKindReference} from a kind's `name`/`version`.\n *\n * The single place that decides how the reference is assembled. If global\n * uniqueness later requires the name segment to be org-qualified, this is the\n * one line that changes.\n */\nexport const formatKindRef = (k: { name: string; version: string }): BlockKindReference =>\n  `${k.name}@${k.version}` as BlockKindReference;\n\n/**\n * Split a `{name}@{version}` string on its version separator.\n *\n * The one place that decides where the name ends. Uses the LAST `@` so an\n * org-qualified npm name that itself starts with `@` (e.g.\n * `@platforma-open/pkg.kind`) keeps its whole name. A leading/absent separator\n * (`lastIndexOf(\"@\") <= 0`) means the string carries no version segment —\n * malformed — so this throws rather than returning a silently version-less\n * result.\n *\n * Shared with the template layer, whose `{name}@{selector}` references use the\n * same split and differ only in how the right half is interpreted (see\n * `parseKindSelectorReference`). `what` names the thing being parsed so the\n * error message stays specific to the caller's reference type.\n */\nexport const splitVersionedName = (\n  ref: string,\n  what = \"block kind reference\",\n  expected = \"{name}@{version}\",\n): { name: string; version: string } => {\n  const at = ref.lastIndexOf(\"@\");\n  if (at <= 0) {\n    throw new Error(`Malformed ${what} (expected '${expected}'): ${ref}`);\n  }\n  return { name: ref.slice(0, at), version: ref.slice(at + 1) };\n};\n\n/**\n * Split a {@link BlockKindReference} back into `{ name, version }`.\n *\n * Throws on a reference with no version segment — see\n * {@link splitVersionedName}, which owns the split rule.\n */\nexport const parseKindRef = (ref: BlockKindReference): { name: string; version: string } =>\n  splitVersionedName(ref);\n"],"mappings":";;;;;;;;AAqBA,MAAa,iBAAiB,MAC5B,GAAG,EAAE,KAAK,GAAG,EAAE;;;;;;;;;;;;;;;;AAiBjB,MAAa,sBACX,KACA,OAAO,wBACP,WAAW,uBAC2B;CACtC,MAAM,KAAK,IAAI,YAAY,GAAG;CAC9B,IAAI,MAAM,GACR,MAAM,IAAI,MAAM,aAAa,KAAK,cAAc,SAAS,MAAM,KAAK;CAEtE,OAAO;EAAE,MAAM,IAAI,MAAM,GAAG,EAAE;EAAG,SAAS,IAAI,MAAM,KAAK,CAAC;CAAE;AAC9D;;;;;;;AAQA,MAAa,gBAAgB,QAC3B,mBAAmB,GAAG"}

package/dist/bmodel/container.d.ts

@@ -1,6 +1,7 @@
 import { Code } from "./code.js";
 import { BlockRenderingMode } from "./types.js";
 import { BlockConfigV3Generic, BlockConfigV4Generic } from "./block_config.js";
+import { BlockKindReference } from "./block_kind_ref.js";
 
 //#region src/bmodel/container.d.ts
 /** Container simplifying maintenance of forward and backward compatibility */
@@ -8,6 +9,13 @@ type BlockConfigContainer = {
   readonly v4?: Omit<BlockConfigV4Generic, "code">; /** Actual config */
   readonly v3?: Omit<BlockConfigV3Generic, "code">; /** Config code bundle. Actually is required, but we keep it optional for backward compatibility */
   readonly code?: Code;
+  /**
+   * Reference to the block kind this config implements, in `{name}@{version}`
+   * form. Version-independent block identity — lives at the container level
+   * beside {@link code}, orthogonal to which render envelope (`v3`/`v4`)
+   * applies. Optional for backward compatibility with kind-less blocks.
+   */
+  readonly kind?: BlockKindReference;
   /**
    * For backward compatibility
    * @deprecated

package/dist/bmodel/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","names":[],"sources":["../../src/bmodel/container.ts"],"mappings":";;;;;;KAKY,oBAAA;EAAA,SACD,EAAA,GAAK,IAAA,CAAK,oBAAA,WADW;EAAA,SAGrB,EAAA,GAAK,IAAA,CAAK,oBAAA,WAFA;EAAA,SAKV,IAAA,GAAO,IAAA;EAHG;;;;EAAA,SAaV,UAAA;EAoCgB;;;;EAAA,SA9BhB,aAAA,GAAgB,kBAAA;EAnBhB;;;;EAAA,SAyBA,WAAA;EAZA;;;;EAAA,SAkBA,MAAA;EAMA;;;;EAAA,SAAA,WAAA;EAYgB;;;;EAAA,SANhB,QAAA;;;;;WAMA,OAAA,GAAU,MAAA;AAAA"}
+{"version":3,"file":"container.d.ts","names":[],"sources":["../../src/bmodel/container.ts"],"mappings":";;;;;;;KAMY,oBAAA;EAAA,SACD,EAAA,GAAK,IAAA,CAAK,oBAAA,WADW;EAAA,SAGrB,EAAA,GAAK,IAAA,CAAK,oBAAA,WAFA;EAAA,SAKV,IAAA,GAAO,IAAA;EAHG;;;;;;EAAA,SAWV,IAAA,GAAO,kBAAA;EA8CS;;;;EAAA,SApChB,UAAA;EArBK;;;;EAAA,SA2BL,aAAA,GAAgB,kBAAA;EAhBT;;;;EAAA,SAsBP,WAAA;EAMA;;;;EAAA,SAAA,MAAA;EAkBgB;AAAA;;;EAAA,SAZhB,WAAA;;;;;WAMA,QAAA;;;;;WAMA,OAAA,GAAU,MAAA;AAAA"}

package/dist/bmodel/index.cjs

@@ -1,6 +1,10 @@
 const require_block_config = require("./block_config.cjs");
 const require_code = require("./code.cjs");
+const require_block_kind_ref = require("./block_kind_ref.cjs");
 const require_normalization = require("./normalization.cjs");
 exports.Code = require_code.Code;
 exports.extractCodeWithInfo = require_block_config.extractCodeWithInfo;
 exports.extractConfigGeneric = require_normalization.extractConfigGeneric;
+exports.formatKindRef = require_block_kind_ref.formatKindRef;
+exports.parseKindRef = require_block_kind_ref.parseKindRef;
+exports.splitVersionedName = require_block_kind_ref.splitVersionedName;

package/dist/bmodel/index.d.ts

@@ -1,6 +1,7 @@
 import { BlockCodeWithInfo, Code } from "./code.js";
 import { BlockRenderingMode } from "./types.js";
 import { BlockConfigGeneric, BlockConfigV3Generic, BlockConfigV4Generic, extractCodeWithInfo } from "./block_config.js";
+import { BlockKindReference, formatKindRef, parseKindRef, splitVersionedName } from "./block_kind_ref.js";
 import { BlockConfigContainer } from "./container.js";
 import { extractConfigGeneric } from "./normalization.js";
-export { BlockCodeWithInfo, BlockConfigContainer, BlockConfigGeneric, BlockConfigV3Generic, BlockConfigV4Generic, BlockRenderingMode, Code, extractCodeWithInfo, extractConfigGeneric };
+export { BlockCodeWithInfo, BlockConfigContainer, BlockConfigGeneric, BlockConfigV3Generic, BlockConfigV4Generic, BlockKindReference, BlockRenderingMode, Code, extractCodeWithInfo, extractConfigGeneric, formatKindRef, parseKindRef, splitVersionedName };

package/dist/bmodel/index.js

@@ -1,4 +1,5 @@
 import { extractCodeWithInfo } from "./block_config.js";
 import { Code } from "./code.js";
+import { formatKindRef, parseKindRef, splitVersionedName } from "./block_kind_ref.js";
 import { extractConfigGeneric } from "./normalization.js";
-export { Code, extractCodeWithInfo, extractConfigGeneric };
+export { Code, extractCodeWithInfo, extractConfigGeneric, formatKindRef, parseKindRef, splitVersionedName };

package/dist/columns/dedup.cjs

@@ -18,7 +18,7 @@ const require_native_id = require("../drivers/pframe/spec/native_id.cjs");
 *
 * Shared by sandbox-side `extractColumns` (column_providers) and host-side
 * `ColumnsCollectionDriverImpl.getColumns` — both layers need identical
-* dedup semantics, but operate on different concrete item types (ColumnLazy
+* dedup semantics, but operate on different concrete item types (DataColumnRecipe
 * vs. raw ColumnUniversalId).
 */
 function dedupColumns(items, getId, getSpec) {

package/dist/columns/dedup.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"dedup.cjs","names":["isPObjectId","deriveNativeId"],"sources":["../../src/columns/dedup.ts"],"sourcesContent":["import type { PColumnSpec } from \"../drivers/pframe/spec/spec\";\nimport type { NativePObjectId } from \"../drivers/pframe/spec/native_id\";\nimport { deriveNativeId } from \"../drivers/pframe/spec/native_id\";\nimport type { ColumnUniversalId } from \"../drivers/pframe/spec/ids\";\nimport { isPObjectId } from \"../pool\";\n\n/**\n * Two-track dedup over an item stream keyed by `ColumnUniversalId`:\n *\n * - **Raw `PObjectId`s** are deduped by `deriveNativeId(spec)`. The same\n *   physical column reached via outputs vs. result_pool has different\n *   id shapes but identical nativeId — first occurrence wins so the\n *   provider order (outputs before pool) decides which id is canonical.\n * - **Non-`PObjectId` ids** (e.g. `SUniversalPColumnUniversalId`,\n *   `ColumnDiscoveredId`) keep raw-id dedup — they legitimately share\n *   nativeId with siblings.\n *\n * When `getSpec` returns `undefined` for a `PObjectId`, falls back to raw-id\n * dedup (so an unresolvable id still survives instead of dropping silently).\n *\n * Shared by sandbox-side `extractColumns` (column_providers) and host-side\n * `ColumnsCollectionDriverImpl.getColumns` — both layers need identical\n * dedup semantics, but operate on different concrete item types (ColumnLazy\n * vs. raw ColumnUniversalId).\n */\nexport function dedupColumns<T>(\n  items: ReadonlyArray<T>,\n  getId: (item: T) => ColumnUniversalId,\n  getSpec: (item: T) => PColumnSpec | undefined,\n): T[] {\n  const seenNative = new Set<NativePObjectId>();\n  const seenId = new Set<ColumnUniversalId>();\n  const out: T[] = [];\n  for (const item of items) {\n    const id = getId(item);\n    if (seenId.has(id)) continue;\n    if (isPObjectId(id)) {\n      const spec = getSpec(item);\n      if (spec !== undefined) {\n        const nativeId = deriveNativeId(spec);\n        if (seenNative.has(nativeId)) continue;\n        seenNative.add(nativeId);\n      }\n    }\n    seenId.add(id);\n    out.push(item);\n  }\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,aACd,OACA,OACA,SACK;CACL,MAAM,6BAAa,IAAI,IAAqB;CAC5C,MAAM,yBAAS,IAAI,IAAuB;CAC1C,MAAM,MAAW,CAAC;CAClB,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,KAAK,MAAM,IAAI;EACrB,IAAI,OAAO,IAAI,EAAE,GAAG;EACpB,IAAIA,aAAAA,YAAY,EAAE,GAAG;GACnB,MAAM,OAAO,QAAQ,IAAI;GACzB,IAAI,SAAS,KAAA,GAAW;IACtB,MAAM,WAAWC,kBAAAA,eAAe,IAAI;IACpC,IAAI,WAAW,IAAI,QAAQ,GAAG;IAC9B,WAAW,IAAI,QAAQ;GACzB;EACF;EACA,OAAO,IAAI,EAAE;EACb,IAAI,KAAK,IAAI;CACf;CACA,OAAO;AACT"}
+{"version":3,"file":"dedup.cjs","names":["isPObjectId","deriveNativeId"],"sources":["../../src/columns/dedup.ts"],"sourcesContent":["import type { PColumnSpec } from \"../drivers/pframe/spec/spec\";\nimport type { NativePObjectId } from \"../drivers/pframe/spec/native_id\";\nimport { deriveNativeId } from \"../drivers/pframe/spec/native_id\";\nimport type { ColumnUniversalId } from \"../drivers/pframe/spec/ids\";\nimport { isPObjectId } from \"../pool\";\n\n/**\n * Two-track dedup over an item stream keyed by `ColumnUniversalId`:\n *\n * - **Raw `PObjectId`s** are deduped by `deriveNativeId(spec)`. The same\n *   physical column reached via outputs vs. result_pool has different\n *   id shapes but identical nativeId — first occurrence wins so the\n *   provider order (outputs before pool) decides which id is canonical.\n * - **Non-`PObjectId` ids** (e.g. `SUniversalPColumnUniversalId`,\n *   `ColumnDiscoveredId`) keep raw-id dedup — they legitimately share\n *   nativeId with siblings.\n *\n * When `getSpec` returns `undefined` for a `PObjectId`, falls back to raw-id\n * dedup (so an unresolvable id still survives instead of dropping silently).\n *\n * Shared by sandbox-side `extractColumns` (column_providers) and host-side\n * `ColumnsCollectionDriverImpl.getColumns` — both layers need identical\n * dedup semantics, but operate on different concrete item types (DataColumnRecipe\n * vs. raw ColumnUniversalId).\n */\nexport function dedupColumns<T>(\n  items: ReadonlyArray<T>,\n  getId: (item: T) => ColumnUniversalId,\n  getSpec: (item: T) => PColumnSpec | undefined,\n): T[] {\n  const seenNative = new Set<NativePObjectId>();\n  const seenId = new Set<ColumnUniversalId>();\n  const out: T[] = [];\n  for (const item of items) {\n    const id = getId(item);\n    if (seenId.has(id)) continue;\n    if (isPObjectId(id)) {\n      const spec = getSpec(item);\n      if (spec !== undefined) {\n        const nativeId = deriveNativeId(spec);\n        if (seenNative.has(nativeId)) continue;\n        seenNative.add(nativeId);\n      }\n    }\n    seenId.add(id);\n    out.push(item);\n  }\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,aACd,OACA,OACA,SACK;CACL,MAAM,6BAAa,IAAI,IAAqB;CAC5C,MAAM,yBAAS,IAAI,IAAuB;CAC1C,MAAM,MAAW,CAAC;CAClB,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,KAAK,MAAM,IAAI;EACrB,IAAI,OAAO,IAAI,EAAE,GAAG;EACpB,IAAIA,aAAAA,YAAY,EAAE,GAAG;GACnB,MAAM,OAAO,QAAQ,IAAI;GACzB,IAAI,SAAS,KAAA,GAAW;IACtB,MAAM,WAAWC,kBAAAA,eAAe,IAAI;IACpC,IAAI,WAAW,IAAI,QAAQ,GAAG;IAC9B,WAAW,IAAI,QAAQ;GACzB;EACF;EACA,OAAO,IAAI,EAAE;EACb,IAAI,KAAK,IAAI;CACf;CACA,OAAO;AACT"}

package/dist/columns/dedup.d.ts

@@ -18,7 +18,7 @@ import { ColumnUniversalId } from "../drivers/pframe/spec/ids.js";
  *
  * Shared by sandbox-side `extractColumns` (column_providers) and host-side
  * `ColumnsCollectionDriverImpl.getColumns` — both layers need identical
- * dedup semantics, but operate on different concrete item types (ColumnLazy
+ * dedup semantics, but operate on different concrete item types (DataColumnRecipe
  * vs. raw ColumnUniversalId).
  */
 declare function dedupColumns<T>(items: ReadonlyArray<T>, getId: (item: T) => ColumnUniversalId, getSpec: (item: T) => PColumnSpec | undefined): T[];

package/dist/columns/dedup.js

@@ -18,7 +18,7 @@ import { deriveNativeId } from "../drivers/pframe/spec/native_id.js";
 *
 * Shared by sandbox-side `extractColumns` (column_providers) and host-side
 * `ColumnsCollectionDriverImpl.getColumns` — both layers need identical
-* dedup semantics, but operate on different concrete item types (ColumnLazy
+* dedup semantics, but operate on different concrete item types (DataColumnRecipe
 * vs. raw ColumnUniversalId).
 */
 function dedupColumns(items, getId, getSpec) {

package/dist/columns/dedup.js.map

@@ -1 +1 @@
-{"version":3,"file":"dedup.js","names":[],"sources":["../../src/columns/dedup.ts"],"sourcesContent":["import type { PColumnSpec } from \"../drivers/pframe/spec/spec\";\nimport type { NativePObjectId } from \"../drivers/pframe/spec/native_id\";\nimport { deriveNativeId } from \"../drivers/pframe/spec/native_id\";\nimport type { ColumnUniversalId } from \"../drivers/pframe/spec/ids\";\nimport { isPObjectId } from \"../pool\";\n\n/**\n * Two-track dedup over an item stream keyed by `ColumnUniversalId`:\n *\n * - **Raw `PObjectId`s** are deduped by `deriveNativeId(spec)`. The same\n *   physical column reached via outputs vs. result_pool has different\n *   id shapes but identical nativeId — first occurrence wins so the\n *   provider order (outputs before pool) decides which id is canonical.\n * - **Non-`PObjectId` ids** (e.g. `SUniversalPColumnUniversalId`,\n *   `ColumnDiscoveredId`) keep raw-id dedup — they legitimately share\n *   nativeId with siblings.\n *\n * When `getSpec` returns `undefined` for a `PObjectId`, falls back to raw-id\n * dedup (so an unresolvable id still survives instead of dropping silently).\n *\n * Shared by sandbox-side `extractColumns` (column_providers) and host-side\n * `ColumnsCollectionDriverImpl.getColumns` — both layers need identical\n * dedup semantics, but operate on different concrete item types (ColumnLazy\n * vs. raw ColumnUniversalId).\n */\nexport function dedupColumns<T>(\n  items: ReadonlyArray<T>,\n  getId: (item: T) => ColumnUniversalId,\n  getSpec: (item: T) => PColumnSpec | undefined,\n): T[] {\n  const seenNative = new Set<NativePObjectId>();\n  const seenId = new Set<ColumnUniversalId>();\n  const out: T[] = [];\n  for (const item of items) {\n    const id = getId(item);\n    if (seenId.has(id)) continue;\n    if (isPObjectId(id)) {\n      const spec = getSpec(item);\n      if (spec !== undefined) {\n        const nativeId = deriveNativeId(spec);\n        if (seenNative.has(nativeId)) continue;\n        seenNative.add(nativeId);\n      }\n    }\n    seenId.add(id);\n    out.push(item);\n  }\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,aACd,OACA,OACA,SACK;CACL,MAAM,6BAAa,IAAI,IAAqB;CAC5C,MAAM,yBAAS,IAAI,IAAuB;CAC1C,MAAM,MAAW,CAAC;CAClB,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,KAAK,MAAM,IAAI;EACrB,IAAI,OAAO,IAAI,EAAE,GAAG;EACpB,IAAI,YAAY,EAAE,GAAG;GACnB,MAAM,OAAO,QAAQ,IAAI;GACzB,IAAI,SAAS,KAAA,GAAW;IACtB,MAAM,WAAW,eAAe,IAAI;IACpC,IAAI,WAAW,IAAI,QAAQ,GAAG;IAC9B,WAAW,IAAI,QAAQ;GACzB;EACF;EACA,OAAO,IAAI,EAAE;EACb,IAAI,KAAK,IAAI;CACf;CACA,OAAO;AACT"}
+{"version":3,"file":"dedup.js","names":[],"sources":["../../src/columns/dedup.ts"],"sourcesContent":["import type { PColumnSpec } from \"../drivers/pframe/spec/spec\";\nimport type { NativePObjectId } from \"../drivers/pframe/spec/native_id\";\nimport { deriveNativeId } from \"../drivers/pframe/spec/native_id\";\nimport type { ColumnUniversalId } from \"../drivers/pframe/spec/ids\";\nimport { isPObjectId } from \"../pool\";\n\n/**\n * Two-track dedup over an item stream keyed by `ColumnUniversalId`:\n *\n * - **Raw `PObjectId`s** are deduped by `deriveNativeId(spec)`. The same\n *   physical column reached via outputs vs. result_pool has different\n *   id shapes but identical nativeId — first occurrence wins so the\n *   provider order (outputs before pool) decides which id is canonical.\n * - **Non-`PObjectId` ids** (e.g. `SUniversalPColumnUniversalId`,\n *   `ColumnDiscoveredId`) keep raw-id dedup — they legitimately share\n *   nativeId with siblings.\n *\n * When `getSpec` returns `undefined` for a `PObjectId`, falls back to raw-id\n * dedup (so an unresolvable id still survives instead of dropping silently).\n *\n * Shared by sandbox-side `extractColumns` (column_providers) and host-side\n * `ColumnsCollectionDriverImpl.getColumns` — both layers need identical\n * dedup semantics, but operate on different concrete item types (DataColumnRecipe\n * vs. raw ColumnUniversalId).\n */\nexport function dedupColumns<T>(\n  items: ReadonlyArray<T>,\n  getId: (item: T) => ColumnUniversalId,\n  getSpec: (item: T) => PColumnSpec | undefined,\n): T[] {\n  const seenNative = new Set<NativePObjectId>();\n  const seenId = new Set<ColumnUniversalId>();\n  const out: T[] = [];\n  for (const item of items) {\n    const id = getId(item);\n    if (seenId.has(id)) continue;\n    if (isPObjectId(id)) {\n      const spec = getSpec(item);\n      if (spec !== undefined) {\n        const nativeId = deriveNativeId(spec);\n        if (seenNative.has(nativeId)) continue;\n        seenNative.add(nativeId);\n      }\n    }\n    seenId.add(id);\n    out.push(item);\n  }\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAgB,aACd,OACA,OACA,SACK;CACL,MAAM,6BAAa,IAAI,IAAqB;CAC5C,MAAM,yBAAS,IAAI,IAAuB;CAC1C,MAAM,MAAW,CAAC;CAClB,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,KAAK,MAAM,IAAI;EACrB,IAAI,OAAO,IAAI,EAAE,GAAG;EACpB,IAAI,YAAY,EAAE,GAAG;GACnB,MAAM,OAAO,QAAQ,IAAI;GACzB,IAAI,SAAS,KAAA,GAAW;IACtB,MAAM,WAAW,eAAe,IAAI;IACpC,IAAI,WAAW,IAAI,QAAQ,GAAG;IAC9B,WAAW,IAAI,QAAQ;GACzB;EACF;EACA,OAAO,IAAI,EAAE;EACb,IAAI,KAAK,IAAI;CACf;CACA,OAAO;AACT"}

package/dist/columns/providers.cjs

@@ -6,7 +6,7 @@ const require_accessor_traversal = require("./accessor_traversal.cjs");
 * exposes `isFinal()` via the root's `getInputsLocked()`.
 *
 * Used directly on the host side; sandbox extends it with `getColumns()`
-* returning {@link ColumnLazy}s — see `AccessorColumnsProvider` in
+* returning {@link DataColumnRecipe}s — see `AccessorColumnsProvider` in
 * `@platforma-sdk/model`.
 */
 var AccessorEntriesProvider = class {

package/dist/columns/providers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"providers.cjs","names":["indexAccessorRoot","indexPoolBlock"],"sources":["../../src/columns/providers.ts"],"sourcesContent":["import type { PObjectId } from \"../pool\";\nimport { indexAccessorRoot, indexPoolBlock } from \"./accessor_traversal\";\nimport type { AccessorLike, ColumnEntriesProvider, LeafEntry, UpstreamBlockCtx } from \"./types\";\n\n/**\n * Generic entries provider over a single accessor root. Walks `<root>` once\n * from the supplied `rootPath`, builds an id → {@link LeafEntry} map and\n * exposes `isFinal()` via the root's `getInputsLocked()`.\n *\n * Used directly on the host side; sandbox extends it with `getColumns()`\n * returning {@link ColumnLazy}s — see `AccessorColumnsProvider` in\n * `@platforma-sdk/model`.\n */\nexport class AccessorEntriesProvider<\n  A extends AccessorLike<A>,\n> implements ColumnEntriesProvider<A> {\n  protected readonly entries: ReadonlyMap<PObjectId, LeafEntry<A>>;\n\n  constructor(\n    protected readonly root: A,\n    rootPath: ReadonlyArray<string>,\n  ) {\n    const map = new Map<PObjectId, LeafEntry<A>>();\n    for (const entry of indexAccessorRoot(root, rootPath)) {\n      if (!map.has(entry.id)) map.set(entry.id, entry);\n    }\n    this.entries = map;\n  }\n\n  getPObjectEntries(): ReadonlyMap<PObjectId, LeafEntry<A>> {\n    return this.entries;\n  }\n\n  isFinal(): boolean {\n    return this.root.getInputsLocked();\n  }\n}\n\n/**\n * Generic entries provider over a list of upstream-block ctx pairs.\n *\n * Per-block merge: iterate `prod` then `staging`, dedupe by name with\n * first-wins semantics (prod takes precedence).\n *\n * `isFinal()` is the AND of `getInputsLocked()` over every present ctx\n * accessor and `!prodIncomplete && !stagingIncomplete` over every block.\n */\nexport class ResultPoolEntriesProvider<\n  A extends AccessorLike<A>,\n> implements ColumnEntriesProvider<A> {\n  protected cachedEntries?: ReadonlyMap<PObjectId, LeafEntry<A>>;\n\n  constructor(protected readonly blocks: ReadonlyArray<UpstreamBlockCtx<A>>) {}\n\n  getPObjectEntries(): ReadonlyMap<PObjectId, LeafEntry<A>> {\n    if (this.cachedEntries !== undefined) return this.cachedEntries;\n    const map = new Map<PObjectId, LeafEntry<A>>();\n    for (const block of this.blocks) {\n      for (const entry of indexPoolBlock(block)) {\n        if (!map.has(entry.id)) map.set(entry.id, entry);\n      }\n    }\n    return (this.cachedEntries = map);\n  }\n\n  isFinal(): boolean {\n    for (const block of this.blocks) {\n      if (block.prodIncomplete || block.stagingIncomplete) return false;\n      if (block.prodCtx && !block.prodCtx.getInputsLocked()) return false;\n      if (block.stagingCtx && !block.stagingCtx.getInputsLocked()) return false;\n    }\n    return true;\n  }\n}\n"],"mappings":";;;;;;;;;;;AAaA,IAAa,0BAAb,MAEsC;CAIf;CAHrB;CAEA,YACE,MACA,UACA;EAFmB,KAAA,OAAA;EAGnB,MAAM,sBAAM,IAAI,IAA6B;EAC7C,KAAK,MAAM,SAASA,2BAAAA,kBAAkB,MAAM,QAAQ,GAClD,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,GAAG,IAAI,IAAI,MAAM,IAAI,KAAK;EAEjD,KAAK,UAAU;CACjB;CAEA,oBAA0D;EACxD,OAAO,KAAK;CACd;CAEA,UAAmB;EACjB,OAAO,KAAK,KAAK,gBAAgB;CACnC;AACF;;;;;;;;;;AAWA,IAAa,4BAAb,MAEsC;CAGL;CAF/B;CAEA,YAAY,QAA+D;EAA5C,KAAA,SAAA;CAA6C;CAE5E,oBAA0D;EACxD,IAAI,KAAK,kBAAkB,KAAA,GAAW,OAAO,KAAK;EAClD,MAAM,sBAAM,IAAI,IAA6B;EAC7C,KAAK,MAAM,SAAS,KAAK,QACvB,KAAK,MAAM,SAASC,2BAAAA,eAAe,KAAK,GACtC,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,GAAG,IAAI,IAAI,MAAM,IAAI,KAAK;EAGnD,OAAQ,KAAK,gBAAgB;CAC/B;CAEA,UAAmB;EACjB,KAAK,MAAM,SAAS,KAAK,QAAQ;GAC/B,IAAI,MAAM,kBAAkB,MAAM,mBAAmB,OAAO;GAC5D,IAAI,MAAM,WAAW,CAAC,MAAM,QAAQ,gBAAgB,GAAG,OAAO;GAC9D,IAAI,MAAM,cAAc,CAAC,MAAM,WAAW,gBAAgB,GAAG,OAAO;EACtE;EACA,OAAO;CACT;AACF"}
+{"version":3,"file":"providers.cjs","names":["indexAccessorRoot","indexPoolBlock"],"sources":["../../src/columns/providers.ts"],"sourcesContent":["import type { PObjectId } from \"../pool\";\nimport { indexAccessorRoot, indexPoolBlock } from \"./accessor_traversal\";\nimport type { AccessorLike, ColumnEntriesProvider, LeafEntry, UpstreamBlockCtx } from \"./types\";\n\n/**\n * Generic entries provider over a single accessor root. Walks `<root>` once\n * from the supplied `rootPath`, builds an id → {@link LeafEntry} map and\n * exposes `isFinal()` via the root's `getInputsLocked()`.\n *\n * Used directly on the host side; sandbox extends it with `getColumns()`\n * returning {@link DataColumnRecipe}s — see `AccessorColumnsProvider` in\n * `@platforma-sdk/model`.\n */\nexport class AccessorEntriesProvider<\n  A extends AccessorLike<A>,\n> implements ColumnEntriesProvider<A> {\n  protected readonly entries: ReadonlyMap<PObjectId, LeafEntry<A>>;\n\n  constructor(\n    protected readonly root: A,\n    rootPath: ReadonlyArray<string>,\n  ) {\n    const map = new Map<PObjectId, LeafEntry<A>>();\n    for (const entry of indexAccessorRoot(root, rootPath)) {\n      if (!map.has(entry.id)) map.set(entry.id, entry);\n    }\n    this.entries = map;\n  }\n\n  getPObjectEntries(): ReadonlyMap<PObjectId, LeafEntry<A>> {\n    return this.entries;\n  }\n\n  isFinal(): boolean {\n    return this.root.getInputsLocked();\n  }\n}\n\n/**\n * Generic entries provider over a list of upstream-block ctx pairs.\n *\n * Per-block merge: iterate `prod` then `staging`, dedupe by name with\n * first-wins semantics (prod takes precedence).\n *\n * `isFinal()` is the AND of `getInputsLocked()` over every present ctx\n * accessor and `!prodIncomplete && !stagingIncomplete` over every block.\n */\nexport class ResultPoolEntriesProvider<\n  A extends AccessorLike<A>,\n> implements ColumnEntriesProvider<A> {\n  protected cachedEntries?: ReadonlyMap<PObjectId, LeafEntry<A>>;\n\n  constructor(protected readonly blocks: ReadonlyArray<UpstreamBlockCtx<A>>) {}\n\n  getPObjectEntries(): ReadonlyMap<PObjectId, LeafEntry<A>> {\n    if (this.cachedEntries !== undefined) return this.cachedEntries;\n    const map = new Map<PObjectId, LeafEntry<A>>();\n    for (const block of this.blocks) {\n      for (const entry of indexPoolBlock(block)) {\n        if (!map.has(entry.id)) map.set(entry.id, entry);\n      }\n    }\n    return (this.cachedEntries = map);\n  }\n\n  isFinal(): boolean {\n    for (const block of this.blocks) {\n      if (block.prodIncomplete || block.stagingIncomplete) return false;\n      if (block.prodCtx && !block.prodCtx.getInputsLocked()) return false;\n      if (block.stagingCtx && !block.stagingCtx.getInputsLocked()) return false;\n    }\n    return true;\n  }\n}\n"],"mappings":";;;;;;;;;;;AAaA,IAAa,0BAAb,MAEsC;CAIf;CAHrB;CAEA,YACE,MACA,UACA;EAFmB,KAAA,OAAA;EAGnB,MAAM,sBAAM,IAAI,IAA6B;EAC7C,KAAK,MAAM,SAASA,2BAAAA,kBAAkB,MAAM,QAAQ,GAClD,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,GAAG,IAAI,IAAI,MAAM,IAAI,KAAK;EAEjD,KAAK,UAAU;CACjB;CAEA,oBAA0D;EACxD,OAAO,KAAK;CACd;CAEA,UAAmB;EACjB,OAAO,KAAK,KAAK,gBAAgB;CACnC;AACF;;;;;;;;;;AAWA,IAAa,4BAAb,MAEsC;CAGL;CAF/B;CAEA,YAAY,QAA+D;EAA5C,KAAA,SAAA;CAA6C;CAE5E,oBAA0D;EACxD,IAAI,KAAK,kBAAkB,KAAA,GAAW,OAAO,KAAK;EAClD,MAAM,sBAAM,IAAI,IAA6B;EAC7C,KAAK,MAAM,SAAS,KAAK,QACvB,KAAK,MAAM,SAASC,2BAAAA,eAAe,KAAK,GACtC,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,GAAG,IAAI,IAAI,MAAM,IAAI,KAAK;EAGnD,OAAQ,KAAK,gBAAgB;CAC/B;CAEA,UAAmB;EACjB,KAAK,MAAM,SAAS,KAAK,QAAQ;GAC/B,IAAI,MAAM,kBAAkB,MAAM,mBAAmB,OAAO;GAC5D,IAAI,MAAM,WAAW,CAAC,MAAM,QAAQ,gBAAgB,GAAG,OAAO;GAC9D,IAAI,MAAM,cAAc,CAAC,MAAM,WAAW,gBAAgB,GAAG,OAAO;EACtE;EACA,OAAO;CACT;AACF"}

package/dist/columns/providers.d.ts

@@ -8,7 +8,7 @@ import { AccessorLike, ColumnEntriesProvider, LeafEntry, UpstreamBlockCtx } from
  * exposes `isFinal()` via the root's `getInputsLocked()`.
  *
  * Used directly on the host side; sandbox extends it with `getColumns()`
- * returning {@link ColumnLazy}s — see `AccessorColumnsProvider` in
+ * returning {@link DataColumnRecipe}s — see `AccessorColumnsProvider` in
  * `@platforma-sdk/model`.
  */
 declare class AccessorEntriesProvider<A extends AccessorLike<A>> implements ColumnEntriesProvider<A> {

package/dist/columns/providers.js

@@ -6,7 +6,7 @@ import { indexAccessorRoot, indexPoolBlock } from "./accessor_traversal.js";
 * exposes `isFinal()` via the root's `getInputsLocked()`.
 *
 * Used directly on the host side; sandbox extends it with `getColumns()`
-* returning {@link ColumnLazy}s — see `AccessorColumnsProvider` in
+* returning {@link DataColumnRecipe}s — see `AccessorColumnsProvider` in
 * `@platforma-sdk/model`.
 */
 var AccessorEntriesProvider = class {

package/dist/columns/providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"providers.js","names":[],"sources":["../../src/columns/providers.ts"],"sourcesContent":["import type { PObjectId } from \"../pool\";\nimport { indexAccessorRoot, indexPoolBlock } from \"./accessor_traversal\";\nimport type { AccessorLike, ColumnEntriesProvider, LeafEntry, UpstreamBlockCtx } from \"./types\";\n\n/**\n * Generic entries provider over a single accessor root. Walks `<root>` once\n * from the supplied `rootPath`, builds an id → {@link LeafEntry} map and\n * exposes `isFinal()` via the root's `getInputsLocked()`.\n *\n * Used directly on the host side; sandbox extends it with `getColumns()`\n * returning {@link ColumnLazy}s — see `AccessorColumnsProvider` in\n * `@platforma-sdk/model`.\n */\nexport class AccessorEntriesProvider<\n  A extends AccessorLike<A>,\n> implements ColumnEntriesProvider<A> {\n  protected readonly entries: ReadonlyMap<PObjectId, LeafEntry<A>>;\n\n  constructor(\n    protected readonly root: A,\n    rootPath: ReadonlyArray<string>,\n  ) {\n    const map = new Map<PObjectId, LeafEntry<A>>();\n    for (const entry of indexAccessorRoot(root, rootPath)) {\n      if (!map.has(entry.id)) map.set(entry.id, entry);\n    }\n    this.entries = map;\n  }\n\n  getPObjectEntries(): ReadonlyMap<PObjectId, LeafEntry<A>> {\n    return this.entries;\n  }\n\n  isFinal(): boolean {\n    return this.root.getInputsLocked();\n  }\n}\n\n/**\n * Generic entries provider over a list of upstream-block ctx pairs.\n *\n * Per-block merge: iterate `prod` then `staging`, dedupe by name with\n * first-wins semantics (prod takes precedence).\n *\n * `isFinal()` is the AND of `getInputsLocked()` over every present ctx\n * accessor and `!prodIncomplete && !stagingIncomplete` over every block.\n */\nexport class ResultPoolEntriesProvider<\n  A extends AccessorLike<A>,\n> implements ColumnEntriesProvider<A> {\n  protected cachedEntries?: ReadonlyMap<PObjectId, LeafEntry<A>>;\n\n  constructor(protected readonly blocks: ReadonlyArray<UpstreamBlockCtx<A>>) {}\n\n  getPObjectEntries(): ReadonlyMap<PObjectId, LeafEntry<A>> {\n    if (this.cachedEntries !== undefined) return this.cachedEntries;\n    const map = new Map<PObjectId, LeafEntry<A>>();\n    for (const block of this.blocks) {\n      for (const entry of indexPoolBlock(block)) {\n        if (!map.has(entry.id)) map.set(entry.id, entry);\n      }\n    }\n    return (this.cachedEntries = map);\n  }\n\n  isFinal(): boolean {\n    for (const block of this.blocks) {\n      if (block.prodIncomplete || block.stagingIncomplete) return false;\n      if (block.prodCtx && !block.prodCtx.getInputsLocked()) return false;\n      if (block.stagingCtx && !block.stagingCtx.getInputsLocked()) return false;\n    }\n    return true;\n  }\n}\n"],"mappings":";;;;;;;;;;;AAaA,IAAa,0BAAb,MAEsC;CAIf;CAHrB;CAEA,YACE,MACA,UACA;EAFmB,KAAA,OAAA;EAGnB,MAAM,sBAAM,IAAI,IAA6B;EAC7C,KAAK,MAAM,SAAS,kBAAkB,MAAM,QAAQ,GAClD,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,GAAG,IAAI,IAAI,MAAM,IAAI,KAAK;EAEjD,KAAK,UAAU;CACjB;CAEA,oBAA0D;EACxD,OAAO,KAAK;CACd;CAEA,UAAmB;EACjB,OAAO,KAAK,KAAK,gBAAgB;CACnC;AACF;;;;;;;;;;AAWA,IAAa,4BAAb,MAEsC;CAGL;CAF/B;CAEA,YAAY,QAA+D;EAA5C,KAAA,SAAA;CAA6C;CAE5E,oBAA0D;EACxD,IAAI,KAAK,kBAAkB,KAAA,GAAW,OAAO,KAAK;EAClD,MAAM,sBAAM,IAAI,IAA6B;EAC7C,KAAK,MAAM,SAAS,KAAK,QACvB,KAAK,MAAM,SAAS,eAAe,KAAK,GACtC,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,GAAG,IAAI,IAAI,MAAM,IAAI,KAAK;EAGnD,OAAQ,KAAK,gBAAgB;CAC/B;CAEA,UAAmB;EACjB,KAAK,MAAM,SAAS,KAAK,QAAQ;GAC/B,IAAI,MAAM,kBAAkB,MAAM,mBAAmB,OAAO;GAC5D,IAAI,MAAM,WAAW,CAAC,MAAM,QAAQ,gBAAgB,GAAG,OAAO;GAC9D,IAAI,MAAM,cAAc,CAAC,MAAM,WAAW,gBAAgB,GAAG,OAAO;EACtE;EACA,OAAO;CACT;AACF"}
+{"version":3,"file":"providers.js","names":[],"sources":["../../src/columns/providers.ts"],"sourcesContent":["import type { PObjectId } from \"../pool\";\nimport { indexAccessorRoot, indexPoolBlock } from \"./accessor_traversal\";\nimport type { AccessorLike, ColumnEntriesProvider, LeafEntry, UpstreamBlockCtx } from \"./types\";\n\n/**\n * Generic entries provider over a single accessor root. Walks `<root>` once\n * from the supplied `rootPath`, builds an id → {@link LeafEntry} map and\n * exposes `isFinal()` via the root's `getInputsLocked()`.\n *\n * Used directly on the host side; sandbox extends it with `getColumns()`\n * returning {@link DataColumnRecipe}s — see `AccessorColumnsProvider` in\n * `@platforma-sdk/model`.\n */\nexport class AccessorEntriesProvider<\n  A extends AccessorLike<A>,\n> implements ColumnEntriesProvider<A> {\n  protected readonly entries: ReadonlyMap<PObjectId, LeafEntry<A>>;\n\n  constructor(\n    protected readonly root: A,\n    rootPath: ReadonlyArray<string>,\n  ) {\n    const map = new Map<PObjectId, LeafEntry<A>>();\n    for (const entry of indexAccessorRoot(root, rootPath)) {\n      if (!map.has(entry.id)) map.set(entry.id, entry);\n    }\n    this.entries = map;\n  }\n\n  getPObjectEntries(): ReadonlyMap<PObjectId, LeafEntry<A>> {\n    return this.entries;\n  }\n\n  isFinal(): boolean {\n    return this.root.getInputsLocked();\n  }\n}\n\n/**\n * Generic entries provider over a list of upstream-block ctx pairs.\n *\n * Per-block merge: iterate `prod` then `staging`, dedupe by name with\n * first-wins semantics (prod takes precedence).\n *\n * `isFinal()` is the AND of `getInputsLocked()` over every present ctx\n * accessor and `!prodIncomplete && !stagingIncomplete` over every block.\n */\nexport class ResultPoolEntriesProvider<\n  A extends AccessorLike<A>,\n> implements ColumnEntriesProvider<A> {\n  protected cachedEntries?: ReadonlyMap<PObjectId, LeafEntry<A>>;\n\n  constructor(protected readonly blocks: ReadonlyArray<UpstreamBlockCtx<A>>) {}\n\n  getPObjectEntries(): ReadonlyMap<PObjectId, LeafEntry<A>> {\n    if (this.cachedEntries !== undefined) return this.cachedEntries;\n    const map = new Map<PObjectId, LeafEntry<A>>();\n    for (const block of this.blocks) {\n      for (const entry of indexPoolBlock(block)) {\n        if (!map.has(entry.id)) map.set(entry.id, entry);\n      }\n    }\n    return (this.cachedEntries = map);\n  }\n\n  isFinal(): boolean {\n    for (const block of this.blocks) {\n      if (block.prodIncomplete || block.stagingIncomplete) return false;\n      if (block.prodCtx && !block.prodCtx.getInputsLocked()) return false;\n      if (block.stagingCtx && !block.stagingCtx.getInputsLocked()) return false;\n    }\n    return true;\n  }\n}\n"],"mappings":";;;;;;;;;;;AAaA,IAAa,0BAAb,MAEsC;CAIf;CAHrB;CAEA,YACE,MACA,UACA;EAFmB,KAAA,OAAA;EAGnB,MAAM,sBAAM,IAAI,IAA6B;EAC7C,KAAK,MAAM,SAAS,kBAAkB,MAAM,QAAQ,GAClD,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,GAAG,IAAI,IAAI,MAAM,IAAI,KAAK;EAEjD,KAAK,UAAU;CACjB;CAEA,oBAA0D;EACxD,OAAO,KAAK;CACd;CAEA,UAAmB;EACjB,OAAO,KAAK,KAAK,gBAAgB;CACnC;AACF;;;;;;;;;;AAWA,IAAa,4BAAb,MAEsC;CAGL;CAF/B;CAEA,YAAY,QAA+D;EAA5C,KAAA,SAAA;CAA6C;CAE5E,oBAA0D;EACxD,IAAI,KAAK,kBAAkB,KAAA,GAAW,OAAO,KAAK;EAClD,MAAM,sBAAM,IAAI,IAA6B;EAC7C,KAAK,MAAM,SAAS,KAAK,QACvB,KAAK,MAAM,SAAS,eAAe,KAAK,GACtC,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,GAAG,IAAI,IAAI,MAAM,IAAI,KAAK;EAGnD,OAAQ,KAAK,gBAAgB;CAC/B;CAEA,UAAmB;EACjB,KAAK,MAAM,SAAS,KAAK,QAAQ;GAC/B,IAAI,MAAM,kBAAkB,MAAM,mBAAmB,OAAO;GAC5D,IAAI,MAAM,WAAW,CAAC,MAAM,QAAQ,gBAAgB,GAAG,OAAO;GAC9D,IAAI,MAAM,cAAc,CAAC,MAAM,WAAW,gBAAgB,GAAG,OAAO;EACtE;EACA,OAAO;CACT;AACF"}

package/dist/drivers/index.cjs

@@ -73,6 +73,8 @@ exports.isColumnDiscoveredKey = require_discovered_column.isColumnDiscoveredKey;
 exports.isColumnFilteredId = require_filtered_column.isColumnFilteredId;
 exports.isColumnFilteredKey = require_filtered_column.isColumnFilteredKey;
 exports.isColumnOverriddenKey = require_overridden.isColumnOverriddenKey;
+exports.isColumnUniversalId = require_ids.isColumnUniversalId;
+exports.isColumnUniversalKey = require_ids.isColumnUniversalKey;
 exports.isDataInfo = require_data_info.isDataInfo;
 exports.isDataInfoEntries = require_data_info.isDataInfoEntries;
 exports.isEmptySpecDelta = require_overridden.isEmptySpecDelta;
@@ -107,6 +109,7 @@ exports.parseColumnDiscoveredId = require_discovered_column.parseColumnDiscovere
 exports.parseColumnId = require_ids.parseColumnId;
 exports.parseColumnIdSafely = require_ids.parseColumnIdSafely;
 exports.parseColumnOverriddenId = require_overridden.parseColumnOverriddenId;
+exports.peelJsonLayers = require_ids.peelJsonLayers;
 exports.readAnnotation = require_spec.readAnnotation;
 exports.readAnnotationJson = require_spec.readAnnotationJson;
 exports.readAnnotationJsonOrThrow = require_spec.readAnnotationJsonOrThrow;
@@ -117,6 +120,7 @@ exports.readMetadata = require_spec.readMetadata;
 exports.readMetadataJson = require_spec.readMetadataJson;
 exports.readMetadataJsonOrThrow = require_spec.readMetadataJsonOrThrow;
 exports.reconstructSpecFromId = require_ids.reconstructSpecFromId;
+exports.remapColumnIdBlockIds = require_ids.remapColumnIdBlockIds;
 exports.resolveAnchors = require_anchored.resolveAnchors;
 exports.resolveAnnotationParents = require_spec.resolveAnnotationParents;
 exports.sortJoinEntry = require_table_calculate.sortJoinEntry;

package/dist/drivers/index.d.ts

@@ -1,7 +1,7 @@
 import { ColumnDiscoveredId, ColumnDiscoveredKey, createColumnDiscoveredId, createColumnDiscoveredKey, distillColumnDiscoveredKey, isColumnDiscoveredId, isColumnDiscoveredKey, parseColumnDiscoveredId, stringifyColumnDiscoveredId } from "./pframe/spec/discovered_column.js";
 import { Annotation, AnnotationDataStatus, AnnotationJson, AxesId, AxesSpec, AxisId, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, ColumnValueType, Domain, DomainJson, Metadata, MetadataJson, PAxisName, PColumn, PColumnIdAndSpec, PColumnName, PColumnSpec, PColumnSpecId, PDataColumnSpec, PUniversalColumnSpec, Trace, TraceEntry, ValueType, canonicalizeAxisId, canonicalizeAxisWithParents, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getNormalizedAxesList, getPColumnSpecId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAxisId, isLabelColumn, isLinkerColumn, matchAxisId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, resolveAnnotationParents } from "./pframe/spec/spec.js";
 import { ColumnOverriddenId, ColumnOverriddenKey, SpecOverrides, applySpecOverrides, createColumnOverriddenId, createColumnOverriddenKey, deriveSpecDelta, distillColumnOverriddenKey, isColumnOverriddenKey, isEmptySpecDelta, mergeSpecOverrides, parseColumnOverriddenId, stringifyColumnOverriddenId, unwrapOverrides } from "./pframe/spec/overridden.js";
-import { AxisPatches, ColumnUniversalId, ColumnUniversalKey, SUniversalPColumnId, UniversalPColumnId, extractPObjectId, parseColumnId, parseColumnIdSafely, reconstructSpecFromId, stringifyColumnId } from "./pframe/spec/ids.js";
+import { AxisPatches, ColumnUniversalId, ColumnUniversalKey, PeeledJsonLayers, SUniversalPColumnId, UniversalPColumnId, extractPObjectId, isColumnUniversalId, isColumnUniversalKey, parseColumnId, parseColumnIdSafely, peelJsonLayers, reconstructSpecFromId, remapColumnIdBlockIds, stringifyColumnId } from "./pframe/spec/ids.js";
 import { AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, ColumnFilteredId, ColumnFilteredKey, FilteredPColumn, FilteredPColumnId, applyAxisFilters, createColumnFilteredId, createColumnFilteredKey, isColumnFilteredId, isColumnFilteredKey, isFilteredPColumn, stringifyColumnFilteredId } from "./pframe/spec/filtered_column.js";
 import { AnchoredIdDeriver, ResolveAnchorsOptions, resolveAnchors } from "./pframe/spec/anchored.js";
 import { NativePObjectId, deriveNativeId } from "./pframe/spec/native_id.js";
@@ -31,4 +31,4 @@ import { FileRange, ImportFileHandle, ImportFileHandleIndex, ImportFileHandleUpl
 import { AnchorEntry, ColumnsDiscoverOptions, ColumnsFilterOptions, DiscoverColumnsOptions, MatchQualifications, MatchingMode, matchingModeToConstraints } from "./columns/discover_columns_options.js";
 import { ChunkedStreamReader, ChunkedStreamReaderOptions, ErrorHandlerStatus } from "./ChunkedStreamReader.js";
 import { CollectionHandle, ColumnsCollectionDriver, ColumnsCollectionDriverHost, ColumnsCollectionDriverModel, SerializedColumnsSource } from "./columns/columns_collection_driver.js";
-export { AAxisSelector, ADomain, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchorEntry, AnchoredColumnMatchStrategy, AnchoredIdDeriver, AnchoredPColumnId, AnchoredPColumnSelector, Annotation, AnnotationDataStatus, AnnotationJson, AnyLogHandle, ArchiveFormat, ArtificialColumnJoinEntry, AxesId, AxesSpec, AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, AxisId, AxisPatches, AxisQualification, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, BinaryChunk, BinaryPartitionedDataInfo, BinaryPartitionedDataInfoEntries, BlobDriver, BlobDriverMetrics, BlobHandleAndSize, BlobLike, BlobToURLDriver, BlockUIURL, BuildQueryInput, CalculateTableDataRequest, CalculateTableDataResponse, ChunkedStreamReader, ChunkedStreamReaderOptions, CollectionHandle, ColumnAxesWithQualifications, ColumnDiscoveredId, ColumnDiscoveredKey, ColumnFilter, ColumnFilteredId, ColumnFilteredKey, ColumnJoinEntry, ColumnOverriddenId, ColumnOverriddenKey, ColumnUniversalId, ColumnUniversalKey, ColumnValueType, ColumnsCollectionDriver, ColumnsCollectionDriverHost, ColumnsCollectionDriverModel, ColumnsDiscoverOptions, ColumnsFilterOptions, CompositeLinkerMap, ConstantAxisFilter, ContentHandler, DataExprAxisRef, DataExprColumnRef, DataInfo, DataInfoEntries, DataQuery, DataQueryBooleanExpression, DataQueryColumn, DataQueryExpression, DataQueryFilter, DataQueryInlineColumn, DataQueryJoinEntry, DataQueryLinkerJoin, DataQueryLinkerJoinLinker, DataQueryOuterJoin, DataQuerySliceAxes, DataQuerySort, DataQuerySparseToDenseColumn, DataQuerySymmetricJoin, DataQueryTransformColumns, DeleteColumnRequest, DeleteColumnResponse, DiscoverColumnsConstraints, DiscoverColumnsFilterStep, DiscoverColumnsLinkerStep, DiscoverColumnsMappingVariant, DiscoverColumnsOptions, DiscoverColumnsRequest, DiscoverColumnsResponse, DiscoverColumnsResponseHit, DiscoverColumnsResponseQualifications, DiscoverColumnsStepInfo, Domain, DomainJson, ErrorHandlerStatus, EvaluateQueryResponse, ExportPTableOptions, FileLike, FileRange, FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, FilteredPColumn, FilteredPColumnId, FindColumnsRequest, FindColumnsResponse, FolderURL, FrontendDriver, FullJoin, FullPTableColumnData, GetContentOptions, ImportFileHandle, ImportFileHandleIndex, ImportFileHandleUpload, ImportProgress, ImportStatus, InferFilterSpecCommonLeaf, InferFilterSpecCommonNode, InferFilterSpecLeaf, InferFilterSpecLeafColumn, InlineColumnJoinEntry, InnerJoin, JoinEntry, JsonDataInfo, JsonDataInfoEntries, JsonPartitionedDataInfo, JsonPartitionedDataInfoEntries, LegacyAxisSelector, LinkerMap, ListFilesResult, LiveLogHandle, LocalBlobHandle, LocalBlobHandleAndSize, LocalImportFileHandle, LogsDriver, LsDriver, LsEntry, MatchQualifications, MatcherMap, MatchingMode, Metadata, MetadataJson, MultiAxisSelector, MultiColumnSelector, NativePObjectId, OpenDialogFilter, OpenDialogOps, OpenMultipleFilesResponse, OpenSingleFileResponse, OuterJoin, PAxisName, PColumn, PColumnDataEntry, PColumnIdAndSpec, PColumnKey, PColumnName, PColumnSelector, PColumnSpec, PColumnSpecId, PColumnValue, PColumnValues, PColumnValuesEntry, PDataColumnSpec, PFrame, PFrameDef, PFrameDriver, PFrameHandle, PFrameModelDriver, PFrameSpecDriver, PTable, PTableColumnId, PTableColumnIdAxis, PTableColumnIdColumn, PTableColumnSpec, PTableColumnSpecAxis, PTableColumnSpecColumn, PTableDef, PTableDefV2, PTableDownloadCompression, PTableDownloadFormat, PTableHandle, PTableNA, PTableRecordFilter, PTableRecordSingleValueFilterV2, PTableShape, PTableSorting, PTableValue, PTableValueAxis, PTableValueBranded, PTableValueData, PTableValueDataBranded, PTableValueDouble, PTableValueFloat, PTableValueInt, PTableValueLong, PTableValueString, PTableVector, PTableVectorTyped, PUniversalColumnSpec, PVectorData, PVectorDataBytes, PVectorDataDouble, PVectorDataFloat, PVectorDataInt, PVectorDataLong, PVectorDataString, PVectorDataTyped, ParquetChunk, ParquetChunkMapping, ParquetChunkMappingAxis, ParquetChunkMappingColumn, ParquetChunkMetadata, ParquetChunkStats, ParquetPartitionedDataInfo, ParquetPartitionedDataInfoEntries, PartitionedDataInfoEntries, ProgressLogWithInfo, RangeBytes, ReadyLogHandle, RemoteBlobHandle, RemoteBlobHandleAndSize, ResolveAnchorsOptions, RootFilterSpec, SUniversalPColumnId, SerializedColumnsSource, SingleAxisSelector, SingleValueAndPredicateV2, SingleValueEqualPredicate, SingleValueGreaterOrEqualPredicate, SingleValueGreaterPredicate, SingleValueIEqualPredicate, SingleValueInSetPredicate, SingleValueIsNAPredicate, SingleValueLessOrEqualPredicate, SingleValueLessPredicate, SingleValueMatchesPredicate, SingleValueNotPredicateV2, SingleValueOrPredicateV2, SingleValuePredicateV2, SingleValueStringContainsFuzzyPredicate, SingleValueStringContainsPredicate, SingleValueStringIContainsFuzzyPredicate, SingleValueStringIContainsPredicate, SlicedColumnJoinEntry, SpecExprAxisRef, SpecExprColumnRef, SpecFrameHandle, SpecOverrides, SpecQuery, SpecQueryBooleanExpression, SpecQueryColumn, SpecQueryExpression, SpecQueryFilter, SpecQueryInlineColumn, SpecQueryJoinEntry, SpecQueryLinkerJoin, SpecQueryOuterJoin, SpecQuerySliceAxes, SpecQuerySort, SpecQuerySparseToDenseColumn, SpecQuerySpecOverride, SpecQuerySymmetricJoin, SpecQueryTransformColumns, StorageEntry, StorageHandle, StorageHandleLocal, StorageHandleRemote, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, StringMatcher, TableRange, Trace, TraceEntry, UniqueValuesRequest, UniqueValuesResponse, UniversalPColumnId, ValueType, ValueTypeSupported, WritePTableToFsOptions, WritePTableToFsResult, XLSX_MAX_ROWS_PER_SHEET, applyAxisFilters, applySpecOverrides, canonicalizeAxisId, canonicalizeAxisWithParents, collectSpecQueryColumns, createColumnDiscoveredId, createColumnDiscoveredKey, createColumnFilteredId, createColumnFilteredKey, createColumnOverriddenId, createColumnOverriddenKey, dataInfoToEntries, deriveNativeId, deriveSpecDelta, distillColumnDiscoveredKey, distillColumnOverriddenKey, entriesToDataInfo, extractPObjectId, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getFileNameFromHandle, getFilePathFromHandle, getNormalizedAxesList, getPColumnSpecId, getPTableColumnId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAnchoredPColumnId, isAnyLogHandle, isAxisId, isBlockUIURL, isBooleanExpression, isColumnDiscoveredId, isColumnDiscoveredKey, isColumnFilteredId, isColumnFilteredKey, isColumnOverriddenKey, isDataInfo, isDataInfoEntries, isEmptySpecDelta, isFilteredPColumn, isFolderURL, isImportFileHandleIndex, isImportFileHandleUpload, isLabelColumn, isLinkerColumn, isLiveLog, isPTableNA, isPartitionedDataInfoEntries, isValueNA, legacyColumnSelectorsToPredicate, mapDataInfo, mapDataInfoEntries, mapJoinEntry, mapPTableDef, mapPTableDefV2, mapSpecQueryColumns, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, matchingModeToConstraints, mergeSpecOverrides, multiColumnSelectorsToPredicate, newRangeBytesOpt, pTableValue, pTableValueBranded, parseColumnDiscoveredId, parseColumnId, parseColumnIdSafely, parseColumnOverriddenId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, reconstructSpecFromId, resolveAnchors, resolveAnnotationParents, sortJoinEntry, sortPTableDef, sortSpecQuery, stringifyColumnDiscoveredId, stringifyColumnFilteredId, stringifyColumnId, stringifyColumnOverriddenId, traverseQuerySpec, unwrapOverrides, validateRangeBytes, visitDataInfo };
+export { AAxisSelector, ADomain, AnchorAxisIdOrRefBasic, AnchorAxisRef, AnchorAxisRefByIdx, AnchorAxisRefByMatcher, AnchorAxisRefByName, AnchorDomainRef, AnchorEntry, AnchoredColumnMatchStrategy, AnchoredIdDeriver, AnchoredPColumnId, AnchoredPColumnSelector, Annotation, AnnotationDataStatus, AnnotationJson, AnyLogHandle, ArchiveFormat, ArtificialColumnJoinEntry, AxesId, AxesSpec, AxisFilter, AxisFilterByIdx, AxisFilterByName, AxisFilterValue, AxisId, AxisPatches, AxisQualification, AxisSpec, AxisSpecNormalized, AxisTree, AxisValueType, BinaryChunk, BinaryPartitionedDataInfo, BinaryPartitionedDataInfoEntries, BlobDriver, BlobDriverMetrics, BlobHandleAndSize, BlobLike, BlobToURLDriver, BlockUIURL, BuildQueryInput, CalculateTableDataRequest, CalculateTableDataResponse, ChunkedStreamReader, ChunkedStreamReaderOptions, CollectionHandle, ColumnAxesWithQualifications, ColumnDiscoveredId, ColumnDiscoveredKey, ColumnFilter, ColumnFilteredId, ColumnFilteredKey, ColumnJoinEntry, ColumnOverriddenId, ColumnOverriddenKey, ColumnUniversalId, ColumnUniversalKey, ColumnValueType, ColumnsCollectionDriver, ColumnsCollectionDriverHost, ColumnsCollectionDriverModel, ColumnsDiscoverOptions, ColumnsFilterOptions, CompositeLinkerMap, ConstantAxisFilter, ContentHandler, DataExprAxisRef, DataExprColumnRef, DataInfo, DataInfoEntries, DataQuery, DataQueryBooleanExpression, DataQueryColumn, DataQueryExpression, DataQueryFilter, DataQueryInlineColumn, DataQueryJoinEntry, DataQueryLinkerJoin, DataQueryLinkerJoinLinker, DataQueryOuterJoin, DataQuerySliceAxes, DataQuerySort, DataQuerySparseToDenseColumn, DataQuerySymmetricJoin, DataQueryTransformColumns, DeleteColumnRequest, DeleteColumnResponse, DiscoverColumnsConstraints, DiscoverColumnsFilterStep, DiscoverColumnsLinkerStep, DiscoverColumnsMappingVariant, DiscoverColumnsOptions, DiscoverColumnsRequest, DiscoverColumnsResponse, DiscoverColumnsResponseHit, DiscoverColumnsResponseQualifications, DiscoverColumnsStepInfo, Domain, DomainJson, ErrorHandlerStatus, EvaluateQueryResponse, ExportPTableOptions, FileLike, FileRange, FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, FilteredPColumn, FilteredPColumnId, FindColumnsRequest, FindColumnsResponse, FolderURL, FrontendDriver, FullJoin, FullPTableColumnData, GetContentOptions, ImportFileHandle, ImportFileHandleIndex, ImportFileHandleUpload, ImportProgress, ImportStatus, InferFilterSpecCommonLeaf, InferFilterSpecCommonNode, InferFilterSpecLeaf, InferFilterSpecLeafColumn, InlineColumnJoinEntry, InnerJoin, JoinEntry, JsonDataInfo, JsonDataInfoEntries, JsonPartitionedDataInfo, JsonPartitionedDataInfoEntries, LegacyAxisSelector, LinkerMap, ListFilesResult, LiveLogHandle, LocalBlobHandle, LocalBlobHandleAndSize, LocalImportFileHandle, LogsDriver, LsDriver, LsEntry, MatchQualifications, MatcherMap, MatchingMode, Metadata, MetadataJson, MultiAxisSelector, MultiColumnSelector, NativePObjectId, OpenDialogFilter, OpenDialogOps, OpenMultipleFilesResponse, OpenSingleFileResponse, OuterJoin, PAxisName, PColumn, PColumnDataEntry, PColumnIdAndSpec, PColumnKey, PColumnName, PColumnSelector, PColumnSpec, PColumnSpecId, PColumnValue, PColumnValues, PColumnValuesEntry, PDataColumnSpec, PFrame, PFrameDef, PFrameDriver, PFrameHandle, PFrameModelDriver, PFrameSpecDriver, PTable, PTableColumnId, PTableColumnIdAxis, PTableColumnIdColumn, PTableColumnSpec, PTableColumnSpecAxis, PTableColumnSpecColumn, PTableDef, PTableDefV2, PTableDownloadCompression, PTableDownloadFormat, PTableHandle, PTableNA, PTableRecordFilter, PTableRecordSingleValueFilterV2, PTableShape, PTableSorting, PTableValue, PTableValueAxis, PTableValueBranded, PTableValueData, PTableValueDataBranded, PTableValueDouble, PTableValueFloat, PTableValueInt, PTableValueLong, PTableValueString, PTableVector, PTableVectorTyped, PUniversalColumnSpec, PVectorData, PVectorDataBytes, PVectorDataDouble, PVectorDataFloat, PVectorDataInt, PVectorDataLong, PVectorDataString, PVectorDataTyped, ParquetChunk, ParquetChunkMapping, ParquetChunkMappingAxis, ParquetChunkMappingColumn, ParquetChunkMetadata, ParquetChunkStats, ParquetPartitionedDataInfo, ParquetPartitionedDataInfoEntries, PartitionedDataInfoEntries, PeeledJsonLayers, ProgressLogWithInfo, RangeBytes, ReadyLogHandle, RemoteBlobHandle, RemoteBlobHandleAndSize, ResolveAnchorsOptions, RootFilterSpec, SUniversalPColumnId, SerializedColumnsSource, SingleAxisSelector, SingleValueAndPredicateV2, SingleValueEqualPredicate, SingleValueGreaterOrEqualPredicate, SingleValueGreaterPredicate, SingleValueIEqualPredicate, SingleValueInSetPredicate, SingleValueIsNAPredicate, SingleValueLessOrEqualPredicate, SingleValueLessPredicate, SingleValueMatchesPredicate, SingleValueNotPredicateV2, SingleValueOrPredicateV2, SingleValuePredicateV2, SingleValueStringContainsFuzzyPredicate, SingleValueStringContainsPredicate, SingleValueStringIContainsFuzzyPredicate, SingleValueStringIContainsPredicate, SlicedColumnJoinEntry, SpecExprAxisRef, SpecExprColumnRef, SpecFrameHandle, SpecOverrides, SpecQuery, SpecQueryBooleanExpression, SpecQueryColumn, SpecQueryExpression, SpecQueryFilter, SpecQueryInlineColumn, SpecQueryJoinEntry, SpecQueryLinkerJoin, SpecQueryOuterJoin, SpecQuerySliceAxes, SpecQuerySort, SpecQuerySparseToDenseColumn, SpecQuerySpecOverride, SpecQuerySymmetricJoin, SpecQueryTransformColumns, StorageEntry, StorageHandle, StorageHandleLocal, StorageHandleRemote, StreamingApiResponse, StreamingApiResponseHandleOutdated, StreamingApiResponseOk, StringMatcher, TableRange, Trace, TraceEntry, UniqueValuesRequest, UniqueValuesResponse, UniversalPColumnId, ValueType, ValueTypeSupported, WritePTableToFsOptions, WritePTableToFsResult, XLSX_MAX_ROWS_PER_SHEET, applyAxisFilters, applySpecOverrides, canonicalizeAxisId, canonicalizeAxisWithParents, collectSpecQueryColumns, createColumnDiscoveredId, createColumnDiscoveredKey, createColumnFilteredId, createColumnFilteredKey, createColumnOverriddenId, createColumnOverriddenKey, dataInfoToEntries, deriveNativeId, deriveSpecDelta, distillColumnDiscoveredKey, distillColumnOverriddenKey, entriesToDataInfo, extractPObjectId, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getFileNameFromHandle, getFilePathFromHandle, getNormalizedAxesList, getPColumnSpecId, getPTableColumnId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAnchoredPColumnId, isAnyLogHandle, isAxisId, isBlockUIURL, isBooleanExpression, isColumnDiscoveredId, isColumnDiscoveredKey, isColumnFilteredId, isColumnFilteredKey, isColumnOverriddenKey, isColumnUniversalId, isColumnUniversalKey, isDataInfo, isDataInfoEntries, isEmptySpecDelta, isFilteredPColumn, isFolderURL, isImportFileHandleIndex, isImportFileHandleUpload, isLabelColumn, isLinkerColumn, isLiveLog, isPTableNA, isPartitionedDataInfoEntries, isValueNA, legacyColumnSelectorsToPredicate, mapDataInfo, mapDataInfoEntries, mapJoinEntry, mapPTableDef, mapPTableDefV2, mapSpecQueryColumns, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, matchingModeToConstraints, mergeSpecOverrides, multiColumnSelectorsToPredicate, newRangeBytesOpt, pTableValue, pTableValueBranded, parseColumnDiscoveredId, parseColumnId, parseColumnIdSafely, parseColumnOverriddenId, peelJsonLayers, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, reconstructSpecFromId, remapColumnIdBlockIds, resolveAnchors, resolveAnnotationParents, sortJoinEntry, sortPTableDef, sortSpecQuery, stringifyColumnDiscoveredId, stringifyColumnFilteredId, stringifyColumnId, stringifyColumnOverriddenId, traverseQuerySpec, unwrapOverrides, validateRangeBytes, visitDataInfo };

package/dist/drivers/index.js

@@ -11,7 +11,7 @@ import { getPTableColumnId } from "./pframe/table_common.js";
 import { applyAxisFilters, createColumnFilteredId, createColumnFilteredKey, isColumnFilteredId, isColumnFilteredKey, isFilteredPColumn, stringifyColumnFilteredId } from "./pframe/spec/filtered_column.js";
 import { createColumnDiscoveredId, createColumnDiscoveredKey, distillColumnDiscoveredKey, isColumnDiscoveredId, isColumnDiscoveredKey, parseColumnDiscoveredId, stringifyColumnDiscoveredId } from "./pframe/spec/discovered_column.js";
 import { applySpecOverrides, createColumnOverriddenId, createColumnOverriddenKey, deriveSpecDelta, distillColumnOverriddenKey, isColumnOverriddenKey, isEmptySpecDelta, mergeSpecOverrides, parseColumnOverriddenId, stringifyColumnOverriddenId, unwrapOverrides } from "./pframe/spec/overridden.js";
-import { extractPObjectId, parseColumnId, parseColumnIdSafely, reconstructSpecFromId, stringifyColumnId } from "./pframe/spec/ids.js";
+import { extractPObjectId, isColumnUniversalId, isColumnUniversalKey, parseColumnId, parseColumnIdSafely, peelJsonLayers, reconstructSpecFromId, remapColumnIdBlockIds, stringifyColumnId } from "./pframe/spec/ids.js";
 import { AnchoredIdDeriver, resolveAnchors } from "./pframe/spec/anchored.js";
 import { isAnchoredPColumnId, legacyColumnSelectorsToPredicate, matchAxis, matchMultiColumnSelector, matchPColumn, multiColumnSelectorsToPredicate } from "./pframe/spec/selectors.js";
 import { deriveNativeId } from "./pframe/spec/native_id.js";
@@ -19,4 +19,4 @@ import { LinkerMap } from "./pframe/linker_columns.js";
 import "./pframe/index.js";
 import { matchingModeToConstraints } from "./columns/discover_columns_options.js";
 import { ChunkedStreamReader } from "./ChunkedStreamReader.js";
-export { AnchoredIdDeriver, Annotation, AnnotationJson, ChunkedStreamReader, Domain, DomainJson, LinkerMap, PAxisName, PColumnName, PTableNA, RangeBytes, ValueType, XLSX_MAX_ROWS_PER_SHEET, applyAxisFilters, applySpecOverrides, canonicalizeAxisId, canonicalizeAxisWithParents, collectSpecQueryColumns, createColumnDiscoveredId, createColumnDiscoveredKey, createColumnFilteredId, createColumnFilteredKey, createColumnOverriddenId, createColumnOverriddenKey, dataInfoToEntries, deriveNativeId, deriveSpecDelta, distillColumnDiscoveredKey, distillColumnOverriddenKey, entriesToDataInfo, extractPObjectId, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getFileNameFromHandle, getFilePathFromHandle, getNormalizedAxesList, getPColumnSpecId, getPTableColumnId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAnchoredPColumnId, isAnyLogHandle, isAxisId, isBlockUIURL, isBooleanExpression, isColumnDiscoveredId, isColumnDiscoveredKey, isColumnFilteredId, isColumnFilteredKey, isColumnOverriddenKey, isDataInfo, isDataInfoEntries, isEmptySpecDelta, isFilteredPColumn, isFolderURL, isImportFileHandleIndex, isImportFileHandleUpload, isLabelColumn, isLinkerColumn, isLiveLog, isPTableNA, isPartitionedDataInfoEntries, isValueNA, legacyColumnSelectorsToPredicate, mapDataInfo, mapDataInfoEntries, mapJoinEntry, mapPTableDef, mapPTableDefV2, mapSpecQueryColumns, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, matchingModeToConstraints, mergeSpecOverrides, multiColumnSelectorsToPredicate, newRangeBytesOpt, pTableValue, pTableValueBranded, parseColumnDiscoveredId, parseColumnId, parseColumnIdSafely, parseColumnOverriddenId, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, reconstructSpecFromId, resolveAnchors, resolveAnnotationParents, sortJoinEntry, sortPTableDef, sortSpecQuery, stringifyColumnDiscoveredId, stringifyColumnFilteredId, stringifyColumnId, stringifyColumnOverriddenId, traverseQuerySpec, unwrapOverrides, validateRangeBytes, visitDataInfo };
+export { AnchoredIdDeriver, Annotation, AnnotationJson, ChunkedStreamReader, Domain, DomainJson, LinkerMap, PAxisName, PColumnName, PTableNA, RangeBytes, ValueType, XLSX_MAX_ROWS_PER_SHEET, applyAxisFilters, applySpecOverrides, canonicalizeAxisId, canonicalizeAxisWithParents, collectSpecQueryColumns, createColumnDiscoveredId, createColumnDiscoveredKey, createColumnFilteredId, createColumnFilteredKey, createColumnOverriddenId, createColumnOverriddenKey, dataInfoToEntries, deriveNativeId, deriveSpecDelta, distillColumnDiscoveredKey, distillColumnOverriddenKey, entriesToDataInfo, extractPObjectId, getArrayFromAxisTree, getAxesId, getAxesTree, getAxisId, getColumnIdAndSpec, getDenormalizedAxesList, getFileNameFromHandle, getFilePathFromHandle, getNormalizedAxesList, getPColumnSpecId, getPTableColumnId, getSetFromAxisTree, getTypeFromPColumnOrAxisSpec, isAnchoredPColumnId, isAnyLogHandle, isAxisId, isBlockUIURL, isBooleanExpression, isColumnDiscoveredId, isColumnDiscoveredKey, isColumnFilteredId, isColumnFilteredKey, isColumnOverriddenKey, isColumnUniversalId, isColumnUniversalKey, isDataInfo, isDataInfoEntries, isEmptySpecDelta, isFilteredPColumn, isFolderURL, isImportFileHandleIndex, isImportFileHandleUpload, isLabelColumn, isLinkerColumn, isLiveLog, isPTableNA, isPartitionedDataInfoEntries, isValueNA, legacyColumnSelectorsToPredicate, mapDataInfo, mapDataInfoEntries, mapJoinEntry, mapPTableDef, mapPTableDefV2, mapSpecQueryColumns, matchAxis, matchAxisId, matchMultiColumnSelector, matchPColumn, matchingModeToConstraints, mergeSpecOverrides, multiColumnSelectorsToPredicate, newRangeBytesOpt, pTableValue, pTableValueBranded, parseColumnDiscoveredId, parseColumnId, parseColumnIdSafely, parseColumnOverriddenId, peelJsonLayers, readAnnotation, readAnnotationJson, readAnnotationJsonOrThrow, readDomain, readDomainJson, readDomainJsonOrThrow, readMetadata, readMetadataJson, readMetadataJsonOrThrow, reconstructSpecFromId, remapColumnIdBlockIds, resolveAnchors, resolveAnnotationParents, sortJoinEntry, sortPTableDef, sortSpecQuery, stringifyColumnDiscoveredId, stringifyColumnFilteredId, stringifyColumnId, stringifyColumnOverriddenId, traverseQuerySpec, unwrapOverrides, validateRangeBytes, visitDataInfo };

package/dist/drivers/pframe/data_types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"data_types.cjs","names":["ValueType"],"sources":["../../../src/drivers/pframe/data_types.ts"],"sourcesContent":["import type { Branded } from \"../../branding\";\nimport { ValueType } from \"./spec/spec\";\n\nexport type PVectorDataInt = Int32Array;\nexport type PVectorDataLong = BigInt64Array;\nexport type PVectorDataFloat = Float32Array;\nexport type PVectorDataDouble = Float64Array;\nexport type PVectorDataString = (null | string)[];\nexport type PVectorDataBytes = (null | Uint8Array)[];\nexport type PVectorDataTyped<DataType extends ValueType> = DataType extends typeof ValueType.Int\n  ? PVectorDataInt\n  : DataType extends typeof ValueType.Long\n    ? PVectorDataLong\n    : DataType extends typeof ValueType.Float\n      ? PVectorDataFloat\n      : DataType extends typeof ValueType.Double\n        ? PVectorDataDouble\n        : DataType extends typeof ValueType.String\n          ? PVectorDataString\n          : DataType extends typeof ValueType.Bytes\n            ? PVectorDataBytes\n            : never;\nexport type PVectorData = PVectorDataTyped<ValueType>;\n\nexport type PTableVectorTyped<DataType extends ValueType> = {\n  /** Stored data type */\n  readonly type: DataType;\n\n  /** Values for present positions */\n  readonly data: PVectorDataTyped<DataType>;\n\n  /**\n   * Encoded bit array marking some elements of this vector as NA,\n   * call {@link bitSet} to read the data.\n   * In old desktop versions NA values are encoded as magic values in data array.\n   * */\n  readonly isNA?: Uint8Array;\n\n  /** @deprecated Always empty. Kept for backwards compatibility with old blocks. */\n  readonly absent?: Uint8Array;\n};\n/** Table column data */\nexport type PTableVector = PTableVectorTyped<ValueType>;\n\nfunction isBitSet(bitVector: Uint8Array, offset: number): boolean {\n  const chunkIndex = Math.floor(offset / 8);\n  const mask = 1 << (7 - (offset % 8));\n  return (bitVector[chunkIndex] & mask) > 0;\n}\n\nexport function isValueNA(vector: PTableVector, row: number): boolean {\n  if (vector.isNA) return isBitSet(vector.isNA, row);\n\n  // Check for legacy magic values to support old desktop versions\n  const valueType = vector.type;\n  const value = vector.data[row];\n  switch (valueType) {\n    case ValueType.Int:\n      return (value as PVectorDataInt[number]) === -2147483648;\n    case ValueType.Long:\n      return (value as PVectorDataLong[number]) === -9007199254740991n;\n    case ValueType.Float:\n      return Number.isNaN(value as PVectorDataFloat[number]);\n    case ValueType.Double:\n      return Number.isNaN(value as PVectorDataDouble[number]);\n    case ValueType.String:\n      return (value as PVectorDataString[number]) === null;\n    case ValueType.Bytes:\n      return (value as PVectorDataBytes[number]) === null;\n    default:\n      throw Error(`unsupported data type: ${valueType satisfies never}`);\n  }\n}\n\nexport const PTableNA = null;\nexport type PTableNA = typeof PTableNA;\n\n/** Type guard for NA value */\nexport function isPTableNA(value: unknown): value is PTableNA {\n  return value === PTableNA;\n}\n\nexport type ValueTypeSupported = Exclude<ValueType, typeof ValueType.Bytes>;\n\nexport type PTableValueInt = number;\nexport type PTableValueLong = number;\nexport type PTableValueFloat = number;\nexport type PTableValueDouble = number;\nexport type PTableValueString = string;\nexport type PTableValueData<DataType extends ValueTypeSupported> =\n  DataType extends typeof ValueType.Int\n    ? PTableValueInt\n    : DataType extends typeof ValueType.Long\n      ? PTableValueLong\n      : DataType extends typeof ValueType.Float\n        ? PTableValueFloat\n        : DataType extends typeof ValueType.Double\n          ? PTableValueDouble\n          : DataType extends typeof ValueType.String\n            ? PTableValueString\n            : never;\nexport type PTableValueDataBranded<DataType extends ValueTypeSupported> = Branded<\n  PTableValueData<DataType>,\n  DataType\n>;\nexport type PTableValue<NA = PTableNA, DataType extends ValueTypeSupported = ValueTypeSupported> =\n  | NA\n  | PTableValueData<DataType>;\nexport type PTableValueBranded<\n  NA = PTableNA,\n  DataType extends ValueTypeSupported = ValueTypeSupported,\n> = NA | PTableValueDataBranded<DataType>;\n\nexport type PTableValueAxis<DataType extends ValueTypeSupported = ValueTypeSupported> =\n  PTableValueData<DataType>;\n\nfunction pTableValueImpl<FillNA = PTableNA, DataType extends ValueType = ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  const valueType = column.type;\n  if (valueType === ValueType.Bytes) {\n    throw Error(\"Bytes not yet supported\");\n  }\n\n  if (\n    options &&\n    \"dataType\" in options &&\n    options.dataType !== undefined &&\n    options.dataType !== valueType\n  ) {\n    throw Error(`expected column of type ${options.dataType}, got ${valueType}`);\n  }\n\n  if (isValueNA(column, row)) {\n    return options?.na !== undefined ? options.na : PTableNA;\n  }\n\n  const value = column.data[row]!;\n  switch (valueType) {\n    case ValueType.Int:\n      return value as PVectorDataInt[number];\n    case ValueType.Long:\n      return Number(value as PVectorDataLong[number]);\n    case ValueType.Float:\n      return value as PVectorDataFloat[number];\n    case ValueType.Double:\n      return value as PVectorDataDouble[number];\n    case ValueType.String:\n      return (value as PVectorDataString[number])!;\n  }\n}\n\n/** Read PTableValue from PTable column at specified row */\nexport function pTableValue<DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n): DataType extends ValueTypeSupported ? PTableValue<PTableNA, DataType> : never;\nexport function pTableValue<FillNA, DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n  options: {\n    na: FillNA;\n  },\n): DataType extends ValueTypeSupported ? PTableValue<FillNA, DataType> : never;\nexport function pTableValue<FillNA, DataType extends ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options: {\n    na: FillNA;\n    dataType: DataType;\n  },\n): PTableValue<FillNA, DataType>;\nexport function pTableValue<FillNA = PTableNA, DataType extends ValueType = ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  return pTableValueImpl(column, row, options);\n}\n\nexport function pTableValueBranded<DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n): DataType extends ValueTypeSupported ? PTableValueBranded<PTableNA, DataType> : never;\nexport function pTableValueBranded<FillNA, DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n  options: {\n    na: FillNA;\n  },\n): DataType extends ValueTypeSupported ? PTableValueBranded<FillNA, DataType> : never;\nexport function pTableValueBranded<FillNA, DataType extends ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options: {\n    na: FillNA;\n    dataType: DataType;\n  },\n): PTableValueBranded<FillNA, DataType>;\nexport function pTableValueBranded<\n  FillNA = PTableNA,\n  DataType extends ValueType = ValueTypeSupported,\n>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  return pTableValueImpl(column, row, options);\n}\n\n/** Used in requests to partially retrieve table's data */\nexport type TableRange = {\n  /** Index of the first record to retrieve */\n  readonly offset: number;\n\n  /** Block length */\n  readonly length: number;\n};\n\n/** Unified information about table shape */\nexport type PTableShape = {\n  /** Number of unified table columns, including all axes and PColumn values */\n  columns: number;\n\n  /** Number of rows */\n  rows: number;\n};\n\n/** Supported formats for PTable file download. */\nexport type PTableDownloadFormat = \"csv\" | \"tsv\";\n\n/** Compression applied to the written file. */\nexport type PTableDownloadCompression = \"none\" | \"gzip\";\n\n/** Options for downloading PTable data to a file. */\nexport interface WritePTableToFsOptions {\n  path: string;\n  format: PTableDownloadFormat;\n  columnIndices: number[];\n  range?: TableRange;\n  chunkSize?: number;\n  includeHeader?: boolean;\n  bom?: boolean;\n  compression?: {\n    type: \"gzip\";\n    level?: number;\n  };\n  signal?: AbortSignal;\n}\n\n/** Result of a PTable file download. */\nexport interface WritePTableToFsResult {\n  path: string;\n  rowsWritten: number;\n  bytesWritten: number;\n}\n\n/**\n * Maximum number of data rows allowed per sheet in an `xlsx` export, kept below\n * Excel's hard limit of 1,048,576. The driver rejects oversized `xlsx` exports\n * (see {@link PFrameDriver.exportPTable}); UIs use it to gate the `xlsx` option.\n */\nexport const XLSX_MAX_ROWS_PER_SHEET = 1_000_000;\n\n/** Options for {@link PFrameDriver.exportPTable}. */\nexport interface ExportPTableOptions {\n  /** Destination file path; its extension selects the output format\n   * (`csv`/`tsv`/`parquet`/`xlsx`). */\n  path: string;\n  /** Unified indices of the columns to export, in output order\n   * (axes first, then data columns). */\n  columnIndices: number[];\n}\n"],"mappings":";;AA4CA,SAAS,SAAS,WAAuB,QAAyB;CAChE,MAAM,aAAa,KAAK,MAAM,SAAS,CAAC;CACxC,MAAM,OAAO,KAAM,IAAK,SAAS;CACjC,QAAQ,UAAU,cAAc,QAAQ;AAC1C;AAEA,SAAgB,UAAU,QAAsB,KAAsB;CACpE,IAAI,OAAO,MAAM,OAAO,SAAS,OAAO,MAAM,GAAG;CAGjD,MAAM,YAAY,OAAO;CACzB,MAAM,QAAQ,OAAO,KAAK;CAC1B,QAAQ,WAAR;EACE,KAAKA,aAAAA,UAAU,KACb,OAAQ,UAAqC;EAC/C,KAAKA,aAAAA,UAAU,MACb,OAAQ,UAAsC,CAAC;EACjD,KAAKA,aAAAA,UAAU,OACb,OAAO,OAAO,MAAM,KAAiC;EACvD,KAAKA,aAAAA,UAAU,QACb,OAAO,OAAO,MAAM,KAAkC;EACxD,KAAKA,aAAAA,UAAU,QACb,OAAQ,UAAwC;EAClD,KAAKA,aAAAA,UAAU,OACb,OAAQ,UAAuC;EACjD,SACE,MAAM,MAAM,0BAA0B,WAA2B;CACrE;AACF;AAEA,MAAa,WAAW;;AAIxB,SAAgB,WAAW,OAAmC;CAC5D,OAAO,UAAA;AACT;AAoCA,SAAS,gBACP,QACA,KACA,SAIA;CACA,MAAM,YAAY,OAAO;CACzB,IAAI,cAAcA,aAAAA,UAAU,OAC1B,MAAM,MAAM,yBAAyB;CAGvC,IACE,WACA,cAAc,WACd,QAAQ,aAAa,KAAA,KACrB,QAAQ,aAAa,WAErB,MAAM,MAAM,2BAA2B,QAAQ,SAAS,QAAQ,WAAW;CAG7E,IAAI,UAAU,QAAQ,GAAG,GACvB,OAAO,SAAS,OAAO,KAAA,IAAY,QAAQ,KAAA;CAG7C,MAAM,QAAQ,OAAO,KAAK;CAC1B,QAAQ,WAAR;EACE,KAAKA,aAAAA,UAAU,KACb,OAAO;EACT,KAAKA,aAAAA,UAAU,MACb,OAAO,OAAO,KAAgC;EAChD,KAAKA,aAAAA,UAAU,OACb,OAAO;EACT,KAAKA,aAAAA,UAAU,QACb,OAAO;EACT,KAAKA,aAAAA,UAAU,QACb,OAAQ;CACZ;AACF;AAsBA,SAAgB,YACd,QACA,KACA,SAIA;CACA,OAAO,gBAAgB,QAAQ,KAAK,OAAO;AAC7C;AAqBA,SAAgB,mBAId,QACA,KACA,SAIA;CACA,OAAO,gBAAgB,QAAQ,KAAK,OAAO;AAC7C;;;;;;AAsDA,MAAa,0BAA0B"}
+{"version":3,"file":"data_types.cjs","names":["ValueType"],"sources":["../../../src/drivers/pframe/data_types.ts"],"sourcesContent":["import type { Branded } from \"../../branding\";\nimport { ValueType } from \"./spec/spec\";\n\nexport type PVectorDataInt = Int32Array;\nexport type PVectorDataLong = BigInt64Array;\nexport type PVectorDataFloat = Float32Array;\nexport type PVectorDataDouble = Float64Array;\nexport type PVectorDataString = (null | string)[];\nexport type PVectorDataBytes = (null | Uint8Array)[];\nexport type PVectorDataTyped<DataType extends ValueType> = DataType extends typeof ValueType.Int\n  ? PVectorDataInt\n  : DataType extends typeof ValueType.Long\n    ? PVectorDataLong\n    : DataType extends typeof ValueType.Float\n      ? PVectorDataFloat\n      : DataType extends typeof ValueType.Double\n        ? PVectorDataDouble\n        : DataType extends typeof ValueType.String\n          ? PVectorDataString\n          : DataType extends typeof ValueType.Bytes\n            ? PVectorDataBytes\n            : never;\nexport type PVectorData = PVectorDataTyped<ValueType>;\n\nexport type PTableVectorTyped<DataType extends ValueType> = {\n  /** Stored data type */\n  readonly type: DataType;\n\n  /** Values for present positions */\n  readonly data: PVectorDataTyped<DataType>;\n\n  /**\n   * Encoded bit array marking some elements of this vector as NA,\n   * call {@link bitSet} to read the data.\n   * In old desktop versions NA values are encoded as magic values in data array.\n   * */\n  readonly isNA?: Uint8Array;\n\n  /** @deprecated Always empty. Kept for backwards compatibility with old blocks. */\n  readonly absent?: Uint8Array;\n};\n/** Table column data */\nexport type PTableVector = PTableVectorTyped<ValueType>;\n\nfunction isBitSet(bitVector: Uint8Array, offset: number): boolean {\n  const chunkIndex = Math.floor(offset / 8);\n  const mask = 1 << (7 - (offset % 8));\n  return (bitVector[chunkIndex] & mask) > 0;\n}\n\nexport function isValueNA(vector: PTableVector, row: number): boolean {\n  if (vector.isNA) return isBitSet(vector.isNA, row);\n\n  // Check for legacy magic values to support old desktop versions\n  const valueType = vector.type;\n  const value = vector.data[row];\n  switch (valueType) {\n    case ValueType.Int:\n      return (value as PVectorDataInt[number]) === -2147483648;\n    case ValueType.Long:\n      return (value as PVectorDataLong[number]) === -9007199254740991n;\n    case ValueType.Float:\n      return Number.isNaN(value as PVectorDataFloat[number]);\n    case ValueType.Double:\n      return Number.isNaN(value as PVectorDataDouble[number]);\n    case ValueType.String:\n      return (value as PVectorDataString[number]) === null;\n    case ValueType.Bytes:\n      return (value as PVectorDataBytes[number]) === null;\n    default:\n      throw Error(`unsupported data type: ${valueType satisfies never}`);\n  }\n}\n\nexport const PTableNA = null;\nexport type PTableNA = typeof PTableNA;\n\n/** Type guard for NA value */\nexport function isPTableNA(value: unknown): value is PTableNA {\n  return value === PTableNA;\n}\n\nexport type ValueTypeSupported = Exclude<ValueType, typeof ValueType.Bytes>;\n\nexport type PTableValueInt = number;\nexport type PTableValueLong = number;\nexport type PTableValueFloat = number;\nexport type PTableValueDouble = number;\nexport type PTableValueString = string;\nexport type PTableValueData<DataType extends ValueTypeSupported> =\n  DataType extends typeof ValueType.Int\n    ? PTableValueInt\n    : DataType extends typeof ValueType.Long\n      ? PTableValueLong\n      : DataType extends typeof ValueType.Float\n        ? PTableValueFloat\n        : DataType extends typeof ValueType.Double\n          ? PTableValueDouble\n          : DataType extends typeof ValueType.String\n            ? PTableValueString\n            : never;\nexport type PTableValueDataBranded<DataType extends ValueTypeSupported> = Branded<\n  PTableValueData<DataType>,\n  DataType\n>;\nexport type PTableValue<NA = PTableNA, DataType extends ValueTypeSupported = ValueTypeSupported> =\n  | NA\n  | PTableValueData<DataType>;\nexport type PTableValueBranded<\n  NA = PTableNA,\n  DataType extends ValueTypeSupported = ValueTypeSupported,\n> = NA | PTableValueDataBranded<DataType>;\n\nexport type PTableValueAxis<DataType extends ValueTypeSupported = ValueTypeSupported> =\n  PTableValueData<DataType>;\n\nfunction pTableValueImpl<FillNA = PTableNA, DataType extends ValueType = ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  const valueType = column.type;\n  if (valueType === ValueType.Bytes) {\n    throw Error(\"Bytes not yet supported\");\n  }\n\n  if (\n    options &&\n    \"dataType\" in options &&\n    options.dataType !== undefined &&\n    options.dataType !== valueType\n  ) {\n    throw Error(`expected column of type ${options.dataType}, got ${valueType}`);\n  }\n\n  if (isValueNA(column, row)) {\n    return options?.na !== undefined ? options.na : PTableNA;\n  }\n\n  const value = column.data[row]!;\n  switch (valueType) {\n    case ValueType.Int:\n      return value as PVectorDataInt[number];\n    case ValueType.Long:\n      return Number(value as PVectorDataLong[number]);\n    case ValueType.Float:\n      return value as PVectorDataFloat[number];\n    case ValueType.Double:\n      return value as PVectorDataDouble[number];\n    case ValueType.String:\n      return (value as PVectorDataString[number])!;\n  }\n}\n\n/** Read PTableValue from PTable column at specified row */\nexport function pTableValue<DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n): DataType extends ValueTypeSupported ? PTableValue<PTableNA, DataType> : never;\nexport function pTableValue<FillNA, DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n  options: {\n    na: FillNA;\n  },\n): DataType extends ValueTypeSupported ? PTableValue<FillNA, DataType> : never;\nexport function pTableValue<FillNA, DataType extends ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options: {\n    na: FillNA;\n    dataType: DataType;\n  },\n): PTableValue<FillNA, DataType>;\nexport function pTableValue<FillNA = PTableNA, DataType extends ValueType = ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  return pTableValueImpl(column, row, options);\n}\n\nexport function pTableValueBranded<DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n): DataType extends ValueTypeSupported ? PTableValueBranded<PTableNA, DataType> : never;\nexport function pTableValueBranded<FillNA, DataType extends ValueType>(\n  column: PTableVectorTyped<DataType>,\n  row: number,\n  options: {\n    na: FillNA;\n  },\n): DataType extends ValueTypeSupported ? PTableValueBranded<FillNA, DataType> : never;\nexport function pTableValueBranded<FillNA, DataType extends ValueTypeSupported>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options: {\n    na: FillNA;\n    dataType: DataType;\n  },\n): PTableValueBranded<FillNA, DataType>;\nexport function pTableValueBranded<\n  FillNA = PTableNA,\n  DataType extends ValueType = ValueTypeSupported,\n>(\n  column: PTableVectorTyped<ValueType>,\n  row: number,\n  options?: {\n    na?: FillNA;\n    dataType?: DataType;\n  },\n) {\n  return pTableValueImpl(column, row, options);\n}\n\n/** Used in requests to partially retrieve table's data */\nexport type TableRange = {\n  /** Index of the first record to retrieve */\n  readonly offset: number;\n\n  /** Block length */\n  readonly length: number;\n};\n\n/** Unified information about table shape */\nexport type PTableShape = {\n  /** Number of unified table columns, including all axes and PColumn values */\n  columns: number;\n\n  /** Number of rows */\n  rows: number;\n};\n\n/** Supported formats for PTable file download. */\nexport type PTableDownloadFormat = \"csv\" | \"tsv\";\n\n/** Compression applied to the written file. */\nexport type PTableDownloadCompression = \"none\" | \"gzip\";\n\n/** Options for downloading PTable data to a file. */\nexport interface WritePTableToFsOptions {\n  path: string;\n  format: PTableDownloadFormat;\n  columnIndices: number[];\n  /**\n   * Optional header names aligned 1:1 with {@link columnIndices}. When provided,\n   * each is written verbatim — letting callers supply disambiguated labels the\n   * spec's intrinsic `pl7.app/label` may not carry. When omitted (or an\n   * individual entry is empty), the header falls back to the column's\n   * spec-derived label.\n   *\n   * Additive on purpose: the UI (ui-vue) and the desktop-app runtime version\n   * independently, so a newer UI must not send a shape an older runtime cannot\n   * read. Older runtimes ignore this field and use {@link columnIndices} alone.\n   */\n  headerNames?: string[];\n  range?: TableRange;\n  chunkSize?: number;\n  includeHeader?: boolean;\n  bom?: boolean;\n  compression?: {\n    type: \"gzip\";\n    level?: number;\n  };\n  signal?: AbortSignal;\n}\n\n/** Result of a PTable file download. */\nexport interface WritePTableToFsResult {\n  path: string;\n  rowsWritten: number;\n  bytesWritten: number;\n}\n\n/**\n * Maximum number of data rows allowed per sheet in an `xlsx` export, kept below\n * Excel's hard limit of 1,048,576. The driver rejects oversized `xlsx` exports\n * (see {@link PFrameDriver.exportPTable}); UIs use it to gate the `xlsx` option.\n */\nexport const XLSX_MAX_ROWS_PER_SHEET = 1_000_000;\n\n/** Options for {@link PFrameDriver.exportPTable}. */\nexport interface ExportPTableOptions {\n  /** Destination file path; its extension selects the output format\n   * (`csv`/`tsv`/`parquet`/`xlsx`). */\n  path: string;\n  /** Unified indices of the columns to export, in output order\n   * (axes first, then data columns). */\n  columnIndices: number[];\n  /**\n   * Optional header names aligned 1:1 with {@link columnIndices}. When provided,\n   * each is written verbatim — letting callers supply disambiguated labels the\n   * spec's intrinsic `pl7.app/label` may not carry. When omitted (or an\n   * individual entry is empty), the header falls back to the column's\n   * spec-derived label.\n   *\n   * Additive on purpose: the UI (ui-vue) and the desktop-app runtime version\n   * independently, so a newer UI must not send a shape an older runtime cannot\n   * read. Older runtimes ignore this field and use {@link columnIndices} alone.\n   */\n  headerNames?: string[];\n}\n"],"mappings":";;AA4CA,SAAS,SAAS,WAAuB,QAAyB;CAChE,MAAM,aAAa,KAAK,MAAM,SAAS,CAAC;CACxC,MAAM,OAAO,KAAM,IAAK,SAAS;CACjC,QAAQ,UAAU,cAAc,QAAQ;AAC1C;AAEA,SAAgB,UAAU,QAAsB,KAAsB;CACpE,IAAI,OAAO,MAAM,OAAO,SAAS,OAAO,MAAM,GAAG;CAGjD,MAAM,YAAY,OAAO;CACzB,MAAM,QAAQ,OAAO,KAAK;CAC1B,QAAQ,WAAR;EACE,KAAKA,aAAAA,UAAU,KACb,OAAQ,UAAqC;EAC/C,KAAKA,aAAAA,UAAU,MACb,OAAQ,UAAsC,CAAC;EACjD,KAAKA,aAAAA,UAAU,OACb,OAAO,OAAO,MAAM,KAAiC;EACvD,KAAKA,aAAAA,UAAU,QACb,OAAO,OAAO,MAAM,KAAkC;EACxD,KAAKA,aAAAA,UAAU,QACb,OAAQ,UAAwC;EAClD,KAAKA,aAAAA,UAAU,OACb,OAAQ,UAAuC;EACjD,SACE,MAAM,MAAM,0BAA0B,WAA2B;CACrE;AACF;AAEA,MAAa,WAAW;;AAIxB,SAAgB,WAAW,OAAmC;CAC5D,OAAO,UAAA;AACT;AAoCA,SAAS,gBACP,QACA,KACA,SAIA;CACA,MAAM,YAAY,OAAO;CACzB,IAAI,cAAcA,aAAAA,UAAU,OAC1B,MAAM,MAAM,yBAAyB;CAGvC,IACE,WACA,cAAc,WACd,QAAQ,aAAa,KAAA,KACrB,QAAQ,aAAa,WAErB,MAAM,MAAM,2BAA2B,QAAQ,SAAS,QAAQ,WAAW;CAG7E,IAAI,UAAU,QAAQ,GAAG,GACvB,OAAO,SAAS,OAAO,KAAA,IAAY,QAAQ,KAAA;CAG7C,MAAM,QAAQ,OAAO,KAAK;CAC1B,QAAQ,WAAR;EACE,KAAKA,aAAAA,UAAU,KACb,OAAO;EACT,KAAKA,aAAAA,UAAU,MACb,OAAO,OAAO,KAAgC;EAChD,KAAKA,aAAAA,UAAU,OACb,OAAO;EACT,KAAKA,aAAAA,UAAU,QACb,OAAO;EACT,KAAKA,aAAAA,UAAU,QACb,OAAQ;CACZ;AACF;AAsBA,SAAgB,YACd,QACA,KACA,SAIA;CACA,OAAO,gBAAgB,QAAQ,KAAK,OAAO;AAC7C;AAqBA,SAAgB,mBAId,QACA,KACA,SAIA;CACA,OAAO,gBAAgB,QAAQ,KAAK,OAAO;AAC7C;;;;;;AAkEA,MAAa,0BAA0B"}

package/dist/drivers/pframe/data_types.d.ts

@@ -75,6 +75,18 @@ interface WritePTableToFsOptions {
   path: string;
   format: PTableDownloadFormat;
   columnIndices: number[];
+  /**
+   * Optional header names aligned 1:1 with {@link columnIndices}. When provided,
+   * each is written verbatim — letting callers supply disambiguated labels the
+   * spec's intrinsic `pl7.app/label` may not carry. When omitted (or an
+   * individual entry is empty), the header falls back to the column's
+   * spec-derived label.
+   *
+   * Additive on purpose: the UI (ui-vue) and the desktop-app runtime version
+   * independently, so a newer UI must not send a shape an older runtime cannot
+   * read. Older runtimes ignore this field and use {@link columnIndices} alone.
+   */
+  headerNames?: string[];
   range?: TableRange;
   chunkSize?: number;
   includeHeader?: boolean;
@@ -105,6 +117,18 @@ interface ExportPTableOptions {
   /** Unified indices of the columns to export, in output order
    * (axes first, then data columns). */
   columnIndices: number[];
+  /**
+   * Optional header names aligned 1:1 with {@link columnIndices}. When provided,
+   * each is written verbatim — letting callers supply disambiguated labels the
+   * spec's intrinsic `pl7.app/label` may not carry. When omitted (or an
+   * individual entry is empty), the header falls back to the column's
+   * spec-derived label.
+   *
+   * Additive on purpose: the UI (ui-vue) and the desktop-app runtime version
+   * independently, so a newer UI must not send a shape an older runtime cannot
+   * read. Older runtimes ignore this field and use {@link columnIndices} alone.
+   */
+  headerNames?: string[];
 }
 //#endregion
 export { ExportPTableOptions, PTableDownloadCompression, PTableDownloadFormat, PTableNA, PTableShape, PTableValue, PTableValueAxis, PTableValueBranded, PTableValueData, PTableValueDataBranded, PTableValueDouble, PTableValueFloat, PTableValueInt, PTableValueLong, PTableValueString, PTableVector, PTableVectorTyped, PVectorData, PVectorDataBytes, PVectorDataDouble, PVectorDataFloat, PVectorDataInt, PVectorDataLong, PVectorDataString, PVectorDataTyped, TableRange, ValueTypeSupported, WritePTableToFsOptions, WritePTableToFsResult, XLSX_MAX_ROWS_PER_SHEET, isPTableNA, isValueNA, pTableValue, pTableValueBranded };

package/dist/drivers/pframe/data_types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data_types.d.ts","names":[],"sources":["../../../src/drivers/pframe/data_types.ts"],"mappings":"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"}
+{"version":3,"file":"data_types.d.ts","names":[],"sources":["../../../src/drivers/pframe/data_types.ts"],"mappings":"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"}