@milaboratories/pl-model-common 1.46.3 → 1.47.0

package/dist/columns/accessor_traversal.cjs

@@ -0,0 +1,119 @@
+const require_spec = require("../pool/spec.cjs");
+require("../pool/index.cjs");
+const require_resource_types = require("../resource_types.cjs");
+//#region src/columns/accessor_traversal.ts
+/** Resource types that hold column collections — DFS stops here and collects. */
+const COLLECT_TYPES = [require_resource_types.ResourceTypeName.PFrame];
+/** Resource types DFS descends through when looking for PFrames. */
+const DESCEND_TYPES = [require_resource_types.ResourceTypeName.StdMap, require_resource_types.ResourceTypeName.StdMapSlash];
+/**
+* Enumerate column names backing a PFrame accessor — derived from
+* `<name>.spec` field names, without resolving the spec resources.
+*/
+function listColumnNames(accessor, prefix = "") {
+	if (accessor.resourceType.name !== require_resource_types.ResourceTypeName.PFrame) return [];
+	const out = [];
+	for (const field of accessor.listInputFields()) {
+		if (!field.endsWith(".spec")) continue;
+		const raw = field.slice(0, -5);
+		if (!raw.startsWith(prefix)) continue;
+		out.push(raw.slice(prefix.length));
+	}
+	return out;
+}
+/**
+* DFS over the input-field subtree of `root`. Collects nodes whose resource
+* type ∈ `collectTypes`. Descends only through `descendTypes`
+* (default: StdMap / StdMapSlash). Collected nodes are not descended into.
+*
+* Threads the field-name path from `rootPath` to each hit, so callers can
+* build canonical {@link createLocalPObjectId}s without relying on the
+* accessor itself to remember its path.
+*
+* Includes `root` itself in the walk.
+*/
+function findDescendantsByType(opts) {
+	const { root, rootPath, collectTypes, descendTypes = DESCEND_TYPES } = opts;
+	const collectSet = new Set(collectTypes);
+	const descendSet = new Set(descendTypes);
+	const result = [];
+	const stack = [{
+		node: root,
+		path: rootPath
+	}];
+	while (stack.length > 0) {
+		const { node, path } = stack.pop();
+		const typeName = node.resourceType.name;
+		if (collectSet.has(typeName)) {
+			result.push({
+				node,
+				path
+			});
+			continue;
+		}
+		if (!descendSet.has(typeName)) continue;
+		const fields = node.listInputFields();
+		for (let i = fields.length - 1; i >= 0; i--) {
+			const child = node.traverse({
+				field: fields[i],
+				assertFieldType: "Input",
+				ignoreError: true
+			});
+			if (child !== void 0) stack.push({
+				node: child,
+				path: [...path, fields[i]]
+			});
+		}
+	}
+	return result;
+}
+/**
+* Walk an accessor root and return one {@link LeafEntry} per discovered column.
+* Ids are {@link createLocalPObjectId}-shaped: `{resolvePath, name}`. The
+* `resolvePath` is derived from `rootPath` extended by the DFS traversal.
+*/
+function indexAccessorRoot(root, rootPath) {
+	const result = [];
+	for (const { node, path } of findDescendantsByType({
+		root,
+		rootPath,
+		collectTypes: COLLECT_TYPES,
+		descendTypes: DESCEND_TYPES
+	})) for (const name of listColumnNames(node)) result.push({
+		accessor: node,
+		name,
+		id: require_spec.createLocalPObjectId([...path], name)
+	});
+	return result;
+}
+/**
+* Walk one upstream-block ctx pair (`prodCtx` then `stagingCtx`) and return one
+* {@link LeafEntry} per column. First-wins dedup by name (prod precedes staging).
+* Ids are {@link createGlobalPObjectId}-shaped — `resolvePath` is not involved.
+*/
+function indexPoolBlock(block) {
+	const accessors = [];
+	if (block.prodCtx) accessors.push(block.prodCtx);
+	if (block.stagingCtx) accessors.push(block.stagingCtx);
+	const result = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const accessor of accessors) for (const name of listColumnNames(accessor)) {
+		if (seen.has(name)) continue;
+		seen.add(name);
+		result.push({
+			accessor,
+			name,
+			id: require_spec.createGlobalPObjectId(block.blockId, name)
+		});
+	}
+	return result;
+}
+//#endregion
+exports.COLLECT_TYPES = COLLECT_TYPES;
+exports.DESCEND_TYPES = DESCEND_TYPES;
+exports.findDescendantsByType = findDescendantsByType;
+exports.indexAccessorRoot = indexAccessorRoot;
+exports.indexPoolBlock = indexPoolBlock;
+exports.listColumnNames = listColumnNames;
+
+//# sourceMappingURL=accessor_traversal.cjs.map

package/dist/columns/accessor_traversal.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessor_traversal.cjs","names":["ResourceTypeName","createLocalPObjectId","createGlobalPObjectId"],"sources":["../../src/columns/accessor_traversal.ts"],"sourcesContent":["import { createGlobalPObjectId, createLocalPObjectId } from \"../pool\";\nimport { ResourceTypeName } from \"../resource_types\";\nimport type { AccessorLike, LeafEntry, UpstreamBlockCtx } from \"./types\";\n\n/** Resource types that hold column collections — DFS stops here and collects. */\nexport const COLLECT_TYPES: ReadonlyArray<string> = [ResourceTypeName.PFrame];\n\n/** Resource types DFS descends through when looking for PFrames. */\nexport const DESCEND_TYPES: ReadonlyArray<string> = [\n  ResourceTypeName.StdMap,\n  ResourceTypeName.StdMapSlash,\n];\n\n/**\n * Enumerate column names backing a PFrame accessor — derived from\n * `<name>.spec` field names, without resolving the spec resources.\n */\nexport function listColumnNames<A extends AccessorLike<A>>(\n  accessor: A,\n  prefix: string = \"\",\n): string[] {\n  if (accessor.resourceType.name !== ResourceTypeName.PFrame) return [];\n  const out: string[] = [];\n  for (const field of accessor.listInputFields()) {\n    if (!field.endsWith(\".spec\")) continue;\n    const raw = field.slice(0, -\".spec\".length);\n    if (!raw.startsWith(prefix)) continue;\n    out.push(raw.slice(prefix.length));\n  }\n  return out;\n}\n\n/**\n * One DFS hit — the accessor whose resource-type matched `collectTypes`, and\n * the field-name path from the DFS root used to reach it.\n */\ntype DescendantHit<A extends AccessorLike<A>> = {\n  readonly node: A;\n  readonly path: ReadonlyArray<string>;\n};\n\n/**\n * DFS over the input-field subtree of `root`. Collects nodes whose resource\n * type ∈ `collectTypes`. Descends only through `descendTypes`\n * (default: StdMap / StdMapSlash). Collected nodes are not descended into.\n *\n * Threads the field-name path from `rootPath` to each hit, so callers can\n * build canonical {@link createLocalPObjectId}s without relying on the\n * accessor itself to remember its path.\n *\n * Includes `root` itself in the walk.\n */\nexport function findDescendantsByType<A extends AccessorLike<A>>(opts: {\n  root: A;\n  rootPath: ReadonlyArray<string>;\n  collectTypes: ReadonlyArray<string>;\n  descendTypes?: ReadonlyArray<string>;\n}): DescendantHit<A>[] {\n  const { root, rootPath, collectTypes, descendTypes = DESCEND_TYPES } = opts;\n  const collectSet = new Set(collectTypes);\n  const descendSet = new Set(descendTypes);\n  const result: DescendantHit<A>[] = [];\n\n  const stack: DescendantHit<A>[] = [{ node: root, path: rootPath }];\n  while (stack.length > 0) {\n    const { node, path } = stack.pop()!;\n    const typeName = node.resourceType.name;\n    if (collectSet.has(typeName)) {\n      result.push({ node, path });\n      continue;\n    }\n    if (!descendSet.has(typeName)) continue;\n    const fields = node.listInputFields();\n    for (let i = fields.length - 1; i >= 0; i--) {\n      const child = node.traverse({\n        field: fields[i],\n        assertFieldType: \"Input\",\n        ignoreError: true,\n      });\n      if (child !== undefined) stack.push({ node: child, path: [...path, fields[i]] });\n    }\n  }\n  return result;\n}\n\n/**\n * Walk an accessor root and return one {@link LeafEntry} per discovered column.\n * Ids are {@link createLocalPObjectId}-shaped: `{resolvePath, name}`. The\n * `resolvePath` is derived from `rootPath` extended by the DFS traversal.\n */\nexport function indexAccessorRoot<A extends AccessorLike<A>>(\n  root: A,\n  rootPath: ReadonlyArray<string>,\n): LeafEntry<A>[] {\n  const result: LeafEntry<A>[] = [];\n  for (const { node, path } of findDescendantsByType({\n    root,\n    rootPath,\n    collectTypes: COLLECT_TYPES,\n    descendTypes: DESCEND_TYPES,\n  })) {\n    for (const name of listColumnNames(node)) {\n      result.push({\n        accessor: node,\n        name,\n        id: createLocalPObjectId([...path], name),\n      });\n    }\n  }\n  return result;\n}\n\n/**\n * Walk one upstream-block ctx pair (`prodCtx` then `stagingCtx`) and return one\n * {@link LeafEntry} per column. First-wins dedup by name (prod precedes staging).\n * Ids are {@link createGlobalPObjectId}-shaped — `resolvePath` is not involved.\n */\nexport function indexPoolBlock<A extends AccessorLike<A>>(\n  block: UpstreamBlockCtx<A>,\n): LeafEntry<A>[] {\n  const accessors: A[] = [];\n  if (block.prodCtx) accessors.push(block.prodCtx);\n  if (block.stagingCtx) accessors.push(block.stagingCtx);\n\n  const result: LeafEntry<A>[] = [];\n  const seen = new Set<string>();\n  for (const accessor of accessors) {\n    for (const name of listColumnNames(accessor)) {\n      if (seen.has(name)) continue;\n      seen.add(name);\n      result.push({\n        accessor,\n        name,\n        id: createGlobalPObjectId(block.blockId, name),\n      });\n    }\n  }\n  return result;\n}\n"],"mappings":";;;;;AAKA,MAAa,gBAAuC,CAACA,uBAAAA,iBAAiB,MAAM;;AAG5E,MAAa,gBAAuC,CAClDA,uBAAAA,iBAAiB,QACjBA,uBAAAA,iBAAiB,WACnB;;;;;AAMA,SAAgB,gBACd,UACA,SAAiB,IACP;CACV,IAAI,SAAS,aAAa,SAASA,uBAAAA,iBAAiB,QAAQ,OAAO,CAAC;CACpE,MAAM,MAAgB,CAAC;CACvB,KAAK,MAAM,SAAS,SAAS,gBAAgB,GAAG;EAC9C,IAAI,CAAC,MAAM,SAAS,OAAO,GAAG;EAC9B,MAAM,MAAM,MAAM,MAAM,GAAG,EAAe;EAC1C,IAAI,CAAC,IAAI,WAAW,MAAM,GAAG;EAC7B,IAAI,KAAK,IAAI,MAAM,OAAO,MAAM,CAAC;CACnC;CACA,OAAO;AACT;;;;;;;;;;;;AAsBA,SAAgB,sBAAiD,MAK1C;CACrB,MAAM,EAAE,MAAM,UAAU,cAAc,eAAe,kBAAkB;CACvE,MAAM,aAAa,IAAI,IAAI,YAAY;CACvC,MAAM,aAAa,IAAI,IAAI,YAAY;CACvC,MAAM,SAA6B,CAAC;CAEpC,MAAM,QAA4B,CAAC;EAAE,MAAM;EAAM,MAAM;CAAS,CAAC;CACjE,OAAO,MAAM,SAAS,GAAG;EACvB,MAAM,EAAE,MAAM,SAAS,MAAM,IAAI;EACjC,MAAM,WAAW,KAAK,aAAa;EACnC,IAAI,WAAW,IAAI,QAAQ,GAAG;GAC5B,OAAO,KAAK;IAAE;IAAM;GAAK,CAAC;GAC1B;EACF;EACA,IAAI,CAAC,WAAW,IAAI,QAAQ,GAAG;EAC/B,MAAM,SAAS,KAAK,gBAAgB;EACpC,KAAK,IAAI,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;GAC3C,MAAM,QAAQ,KAAK,SAAS;IAC1B,OAAO,OAAO;IACd,iBAAiB;IACjB,aAAa;GACf,CAAC;GACD,IAAI,UAAU,KAAA,GAAW,MAAM,KAAK;IAAE,MAAM;IAAO,MAAM,CAAC,GAAG,MAAM,OAAO,EAAE;GAAE,CAAC;EACjF;CACF;CACA,OAAO;AACT;;;;;;AAOA,SAAgB,kBACd,MACA,UACgB;CAChB,MAAM,SAAyB,CAAC;CAChC,KAAK,MAAM,EAAE,MAAM,UAAU,sBAAsB;EACjD;EACA;EACA,cAAc;EACd,cAAc;CAChB,CAAC,GACC,KAAK,MAAM,QAAQ,gBAAgB,IAAI,GACrC,OAAO,KAAK;EACV,UAAU;EACV;EACA,IAAIC,aAAAA,qBAAqB,CAAC,GAAG,IAAI,GAAG,IAAI;CAC1C,CAAC;CAGL,OAAO;AACT;;;;;;AAOA,SAAgB,eACd,OACgB;CAChB,MAAM,YAAiB,CAAC;CACxB,IAAI,MAAM,SAAS,UAAU,KAAK,MAAM,OAAO;CAC/C,IAAI,MAAM,YAAY,UAAU,KAAK,MAAM,UAAU;CAErD,MAAM,SAAyB,CAAC;CAChC,MAAM,uBAAO,IAAI,IAAY;CAC7B,KAAK,MAAM,YAAY,WACrB,KAAK,MAAM,QAAQ,gBAAgB,QAAQ,GAAG;EAC5C,IAAI,KAAK,IAAI,IAAI,GAAG;EACpB,KAAK,IAAI,IAAI;EACb,OAAO,KAAK;GACV;GACA;GACA,IAAIC,aAAAA,sBAAsB,MAAM,SAAS,IAAI;EAC/C,CAAC;CACH;CAEF,OAAO;AACT"}

package/dist/columns/accessor_traversal.d.ts

@@ -0,0 +1,52 @@
+import { AccessorLike, LeafEntry, UpstreamBlockCtx } from "./types.js";
+
+//#region src/columns/accessor_traversal.d.ts
+/** Resource types that hold column collections — DFS stops here and collects. */
+declare const COLLECT_TYPES: ReadonlyArray<string>;
+/** Resource types DFS descends through when looking for PFrames. */
+declare const DESCEND_TYPES: ReadonlyArray<string>;
+/**
+ * Enumerate column names backing a PFrame accessor — derived from
+ * `<name>.spec` field names, without resolving the spec resources.
+ */
+declare function listColumnNames<A extends AccessorLike<A>>(accessor: A, prefix?: string): string[];
+/**
+ * One DFS hit — the accessor whose resource-type matched `collectTypes`, and
+ * the field-name path from the DFS root used to reach it.
+ */
+type DescendantHit<A extends AccessorLike<A>> = {
+  readonly node: A;
+  readonly path: ReadonlyArray<string>;
+};
+/**
+ * DFS over the input-field subtree of `root`. Collects nodes whose resource
+ * type ∈ `collectTypes`. Descends only through `descendTypes`
+ * (default: StdMap / StdMapSlash). Collected nodes are not descended into.
+ *
+ * Threads the field-name path from `rootPath` to each hit, so callers can
+ * build canonical {@link createLocalPObjectId}s without relying on the
+ * accessor itself to remember its path.
+ *
+ * Includes `root` itself in the walk.
+ */
+declare function findDescendantsByType<A extends AccessorLike<A>>(opts: {
+  root: A;
+  rootPath: ReadonlyArray<string>;
+  collectTypes: ReadonlyArray<string>;
+  descendTypes?: ReadonlyArray<string>;
+}): DescendantHit<A>[];
+/**
+ * Walk an accessor root and return one {@link LeafEntry} per discovered column.
+ * Ids are {@link createLocalPObjectId}-shaped: `{resolvePath, name}`. The
+ * `resolvePath` is derived from `rootPath` extended by the DFS traversal.
+ */
+declare function indexAccessorRoot<A extends AccessorLike<A>>(root: A, rootPath: ReadonlyArray<string>): LeafEntry<A>[];
+/**
+ * Walk one upstream-block ctx pair (`prodCtx` then `stagingCtx`) and return one
+ * {@link LeafEntry} per column. First-wins dedup by name (prod precedes staging).
+ * Ids are {@link createGlobalPObjectId}-shaped — `resolvePath` is not involved.
+ */
+declare function indexPoolBlock<A extends AccessorLike<A>>(block: UpstreamBlockCtx<A>): LeafEntry<A>[];
+//#endregion
+export { COLLECT_TYPES, DESCEND_TYPES, findDescendantsByType, indexAccessorRoot, indexPoolBlock, listColumnNames };
+//# sourceMappingURL=accessor_traversal.d.ts.map

package/dist/columns/accessor_traversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessor_traversal.d.ts","names":[],"sources":["../../src/columns/accessor_traversal.ts"],"mappings":";;;;cAKa,aAAA,EAAe,aAAa;AAAzC;AAAA,cAGa,aAAA,EAAe,aAAa;;;AAHA;AAGzC;iBASgB,eAAA,WAA0B,YAAA,CAAa,CAAA,GACrD,QAAA,EAAU,CAAA,EACV,MAAA;;;AAXuC;AASzC;KAmBK,aAAA,WAAwB,YAAA,CAAa,CAAA;EAAA,SAC/B,IAAA,EAAM,CAAA;EAAA,SACN,IAAA,EAAM,aAAA;AAAA;;;;;;;;;;;AAnBI;iBAiCL,qBAAA,WAAgC,YAAA,CAAa,CAAA,GAAI,IAAA;EAC/D,IAAA,EAAM,CAAA;EACN,QAAA,EAAU,aAAA;EACV,YAAA,EAAc,aAAA;EACd,YAAA,GAAe,aAAA;AAAA,IACb,aAAA,CAAc,CAAA;;;;;;iBAiCF,iBAAA,WAA4B,YAAA,CAAa,CAAA,GACvD,IAAA,EAAM,CAAA,EACN,QAAA,EAAU,aAAA,WACT,SAAA,CAAU,CAAA;;;;;;iBAwBG,cAAA,WAAyB,YAAA,CAAa,CAAA,GACpD,KAAA,EAAO,gBAAA,CAAiB,CAAA,IACvB,SAAA,CAAU,CAAA"}

package/dist/columns/accessor_traversal.js

@@ -0,0 +1,114 @@
+import { createGlobalPObjectId, createLocalPObjectId } from "../pool/spec.js";
+import "../pool/index.js";
+import { ResourceTypeName } from "../resource_types.js";
+//#region src/columns/accessor_traversal.ts
+/** Resource types that hold column collections — DFS stops here and collects. */
+const COLLECT_TYPES = [ResourceTypeName.PFrame];
+/** Resource types DFS descends through when looking for PFrames. */
+const DESCEND_TYPES = [ResourceTypeName.StdMap, ResourceTypeName.StdMapSlash];
+/**
+* Enumerate column names backing a PFrame accessor — derived from
+* `<name>.spec` field names, without resolving the spec resources.
+*/
+function listColumnNames(accessor, prefix = "") {
+	if (accessor.resourceType.name !== ResourceTypeName.PFrame) return [];
+	const out = [];
+	for (const field of accessor.listInputFields()) {
+		if (!field.endsWith(".spec")) continue;
+		const raw = field.slice(0, -5);
+		if (!raw.startsWith(prefix)) continue;
+		out.push(raw.slice(prefix.length));
+	}
+	return out;
+}
+/**
+* DFS over the input-field subtree of `root`. Collects nodes whose resource
+* type ∈ `collectTypes`. Descends only through `descendTypes`
+* (default: StdMap / StdMapSlash). Collected nodes are not descended into.
+*
+* Threads the field-name path from `rootPath` to each hit, so callers can
+* build canonical {@link createLocalPObjectId}s without relying on the
+* accessor itself to remember its path.
+*
+* Includes `root` itself in the walk.
+*/
+function findDescendantsByType(opts) {
+	const { root, rootPath, collectTypes, descendTypes = DESCEND_TYPES } = opts;
+	const collectSet = new Set(collectTypes);
+	const descendSet = new Set(descendTypes);
+	const result = [];
+	const stack = [{
+		node: root,
+		path: rootPath
+	}];
+	while (stack.length > 0) {
+		const { node, path } = stack.pop();
+		const typeName = node.resourceType.name;
+		if (collectSet.has(typeName)) {
+			result.push({
+				node,
+				path
+			});
+			continue;
+		}
+		if (!descendSet.has(typeName)) continue;
+		const fields = node.listInputFields();
+		for (let i = fields.length - 1; i >= 0; i--) {
+			const child = node.traverse({
+				field: fields[i],
+				assertFieldType: "Input",
+				ignoreError: true
+			});
+			if (child !== void 0) stack.push({
+				node: child,
+				path: [...path, fields[i]]
+			});
+		}
+	}
+	return result;
+}
+/**
+* Walk an accessor root and return one {@link LeafEntry} per discovered column.
+* Ids are {@link createLocalPObjectId}-shaped: `{resolvePath, name}`. The
+* `resolvePath` is derived from `rootPath` extended by the DFS traversal.
+*/
+function indexAccessorRoot(root, rootPath) {
+	const result = [];
+	for (const { node, path } of findDescendantsByType({
+		root,
+		rootPath,
+		collectTypes: COLLECT_TYPES,
+		descendTypes: DESCEND_TYPES
+	})) for (const name of listColumnNames(node)) result.push({
+		accessor: node,
+		name,
+		id: createLocalPObjectId([...path], name)
+	});
+	return result;
+}
+/**
+* Walk one upstream-block ctx pair (`prodCtx` then `stagingCtx`) and return one
+* {@link LeafEntry} per column. First-wins dedup by name (prod precedes staging).
+* Ids are {@link createGlobalPObjectId}-shaped — `resolvePath` is not involved.
+*/
+function indexPoolBlock(block) {
+	const accessors = [];
+	if (block.prodCtx) accessors.push(block.prodCtx);
+	if (block.stagingCtx) accessors.push(block.stagingCtx);
+	const result = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const accessor of accessors) for (const name of listColumnNames(accessor)) {
+		if (seen.has(name)) continue;
+		seen.add(name);
+		result.push({
+			accessor,
+			name,
+			id: createGlobalPObjectId(block.blockId, name)
+		});
+	}
+	return result;
+}
+//#endregion
+export { COLLECT_TYPES, DESCEND_TYPES, findDescendantsByType, indexAccessorRoot, indexPoolBlock, listColumnNames };
+
+//# sourceMappingURL=accessor_traversal.js.map

package/dist/columns/accessor_traversal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessor_traversal.js","names":[],"sources":["../../src/columns/accessor_traversal.ts"],"sourcesContent":["import { createGlobalPObjectId, createLocalPObjectId } from \"../pool\";\nimport { ResourceTypeName } from \"../resource_types\";\nimport type { AccessorLike, LeafEntry, UpstreamBlockCtx } from \"./types\";\n\n/** Resource types that hold column collections — DFS stops here and collects. */\nexport const COLLECT_TYPES: ReadonlyArray<string> = [ResourceTypeName.PFrame];\n\n/** Resource types DFS descends through when looking for PFrames. */\nexport const DESCEND_TYPES: ReadonlyArray<string> = [\n  ResourceTypeName.StdMap,\n  ResourceTypeName.StdMapSlash,\n];\n\n/**\n * Enumerate column names backing a PFrame accessor — derived from\n * `<name>.spec` field names, without resolving the spec resources.\n */\nexport function listColumnNames<A extends AccessorLike<A>>(\n  accessor: A,\n  prefix: string = \"\",\n): string[] {\n  if (accessor.resourceType.name !== ResourceTypeName.PFrame) return [];\n  const out: string[] = [];\n  for (const field of accessor.listInputFields()) {\n    if (!field.endsWith(\".spec\")) continue;\n    const raw = field.slice(0, -\".spec\".length);\n    if (!raw.startsWith(prefix)) continue;\n    out.push(raw.slice(prefix.length));\n  }\n  return out;\n}\n\n/**\n * One DFS hit — the accessor whose resource-type matched `collectTypes`, and\n * the field-name path from the DFS root used to reach it.\n */\ntype DescendantHit<A extends AccessorLike<A>> = {\n  readonly node: A;\n  readonly path: ReadonlyArray<string>;\n};\n\n/**\n * DFS over the input-field subtree of `root`. Collects nodes whose resource\n * type ∈ `collectTypes`. Descends only through `descendTypes`\n * (default: StdMap / StdMapSlash). Collected nodes are not descended into.\n *\n * Threads the field-name path from `rootPath` to each hit, so callers can\n * build canonical {@link createLocalPObjectId}s without relying on the\n * accessor itself to remember its path.\n *\n * Includes `root` itself in the walk.\n */\nexport function findDescendantsByType<A extends AccessorLike<A>>(opts: {\n  root: A;\n  rootPath: ReadonlyArray<string>;\n  collectTypes: ReadonlyArray<string>;\n  descendTypes?: ReadonlyArray<string>;\n}): DescendantHit<A>[] {\n  const { root, rootPath, collectTypes, descendTypes = DESCEND_TYPES } = opts;\n  const collectSet = new Set(collectTypes);\n  const descendSet = new Set(descendTypes);\n  const result: DescendantHit<A>[] = [];\n\n  const stack: DescendantHit<A>[] = [{ node: root, path: rootPath }];\n  while (stack.length > 0) {\n    const { node, path } = stack.pop()!;\n    const typeName = node.resourceType.name;\n    if (collectSet.has(typeName)) {\n      result.push({ node, path });\n      continue;\n    }\n    if (!descendSet.has(typeName)) continue;\n    const fields = node.listInputFields();\n    for (let i = fields.length - 1; i >= 0; i--) {\n      const child = node.traverse({\n        field: fields[i],\n        assertFieldType: \"Input\",\n        ignoreError: true,\n      });\n      if (child !== undefined) stack.push({ node: child, path: [...path, fields[i]] });\n    }\n  }\n  return result;\n}\n\n/**\n * Walk an accessor root and return one {@link LeafEntry} per discovered column.\n * Ids are {@link createLocalPObjectId}-shaped: `{resolvePath, name}`. The\n * `resolvePath` is derived from `rootPath` extended by the DFS traversal.\n */\nexport function indexAccessorRoot<A extends AccessorLike<A>>(\n  root: A,\n  rootPath: ReadonlyArray<string>,\n): LeafEntry<A>[] {\n  const result: LeafEntry<A>[] = [];\n  for (const { node, path } of findDescendantsByType({\n    root,\n    rootPath,\n    collectTypes: COLLECT_TYPES,\n    descendTypes: DESCEND_TYPES,\n  })) {\n    for (const name of listColumnNames(node)) {\n      result.push({\n        accessor: node,\n        name,\n        id: createLocalPObjectId([...path], name),\n      });\n    }\n  }\n  return result;\n}\n\n/**\n * Walk one upstream-block ctx pair (`prodCtx` then `stagingCtx`) and return one\n * {@link LeafEntry} per column. First-wins dedup by name (prod precedes staging).\n * Ids are {@link createGlobalPObjectId}-shaped — `resolvePath` is not involved.\n */\nexport function indexPoolBlock<A extends AccessorLike<A>>(\n  block: UpstreamBlockCtx<A>,\n): LeafEntry<A>[] {\n  const accessors: A[] = [];\n  if (block.prodCtx) accessors.push(block.prodCtx);\n  if (block.stagingCtx) accessors.push(block.stagingCtx);\n\n  const result: LeafEntry<A>[] = [];\n  const seen = new Set<string>();\n  for (const accessor of accessors) {\n    for (const name of listColumnNames(accessor)) {\n      if (seen.has(name)) continue;\n      seen.add(name);\n      result.push({\n        accessor,\n        name,\n        id: createGlobalPObjectId(block.blockId, name),\n      });\n    }\n  }\n  return result;\n}\n"],"mappings":";;;;;AAKA,MAAa,gBAAuC,CAAC,iBAAiB,MAAM;;AAG5E,MAAa,gBAAuC,CAClD,iBAAiB,QACjB,iBAAiB,WACnB;;;;;AAMA,SAAgB,gBACd,UACA,SAAiB,IACP;CACV,IAAI,SAAS,aAAa,SAAS,iBAAiB,QAAQ,OAAO,CAAC;CACpE,MAAM,MAAgB,CAAC;CACvB,KAAK,MAAM,SAAS,SAAS,gBAAgB,GAAG;EAC9C,IAAI,CAAC,MAAM,SAAS,OAAO,GAAG;EAC9B,MAAM,MAAM,MAAM,MAAM,GAAG,EAAe;EAC1C,IAAI,CAAC,IAAI,WAAW,MAAM,GAAG;EAC7B,IAAI,KAAK,IAAI,MAAM,OAAO,MAAM,CAAC;CACnC;CACA,OAAO;AACT;;;;;;;;;;;;AAsBA,SAAgB,sBAAiD,MAK1C;CACrB,MAAM,EAAE,MAAM,UAAU,cAAc,eAAe,kBAAkB;CACvE,MAAM,aAAa,IAAI,IAAI,YAAY;CACvC,MAAM,aAAa,IAAI,IAAI,YAAY;CACvC,MAAM,SAA6B,CAAC;CAEpC,MAAM,QAA4B,CAAC;EAAE,MAAM;EAAM,MAAM;CAAS,CAAC;CACjE,OAAO,MAAM,SAAS,GAAG;EACvB,MAAM,EAAE,MAAM,SAAS,MAAM,IAAI;EACjC,MAAM,WAAW,KAAK,aAAa;EACnC,IAAI,WAAW,IAAI,QAAQ,GAAG;GAC5B,OAAO,KAAK;IAAE;IAAM;GAAK,CAAC;GAC1B;EACF;EACA,IAAI,CAAC,WAAW,IAAI,QAAQ,GAAG;EAC/B,MAAM,SAAS,KAAK,gBAAgB;EACpC,KAAK,IAAI,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;GAC3C,MAAM,QAAQ,KAAK,SAAS;IAC1B,OAAO,OAAO;IACd,iBAAiB;IACjB,aAAa;GACf,CAAC;GACD,IAAI,UAAU,KAAA,GAAW,MAAM,KAAK;IAAE,MAAM;IAAO,MAAM,CAAC,GAAG,MAAM,OAAO,EAAE;GAAE,CAAC;EACjF;CACF;CACA,OAAO;AACT;;;;;;AAOA,SAAgB,kBACd,MACA,UACgB;CAChB,MAAM,SAAyB,CAAC;CAChC,KAAK,MAAM,EAAE,MAAM,UAAU,sBAAsB;EACjD;EACA;EACA,cAAc;EACd,cAAc;CAChB,CAAC,GACC,KAAK,MAAM,QAAQ,gBAAgB,IAAI,GACrC,OAAO,KAAK;EACV,UAAU;EACV;EACA,IAAI,qBAAqB,CAAC,GAAG,IAAI,GAAG,IAAI;CAC1C,CAAC;CAGL,OAAO;AACT;;;;;;AAOA,SAAgB,eACd,OACgB;CAChB,MAAM,YAAiB,CAAC;CACxB,IAAI,MAAM,SAAS,UAAU,KAAK,MAAM,OAAO;CAC/C,IAAI,MAAM,YAAY,UAAU,KAAK,MAAM,UAAU;CAErD,MAAM,SAAyB,CAAC;CAChC,MAAM,uBAAO,IAAI,IAAY;CAC7B,KAAK,MAAM,YAAY,WACrB,KAAK,MAAM,QAAQ,gBAAgB,QAAQ,GAAG;EAC5C,IAAI,KAAK,IAAI,IAAI,GAAG;EACpB,KAAK,IAAI,IAAI;EACb,OAAO,KAAK;GACV;GACA;GACA,IAAI,sBAAsB,MAAM,SAAS,IAAI;EAC/C,CAAC;CACH;CAEF,OAAO;AACT"}

package/dist/columns/column_registry.cjs

@@ -0,0 +1,40 @@
+//#region src/columns/column_registry.ts
+/**
+* Id-index over a set of {@link ColumnEntriesProvider}s. Sole job:
+* {@link PObjectId} → {@link LeafEntry}. Generic over the accessor flavour, so
+* the same class backs both sandbox (`TreeNodeAccessor`) and host
+* (`PlTreeNodeAccessor`) usage.
+*
+* Stateless beyond the provider list — every lookup goes through each
+* provider's `getPObjectEntries()` (cached inside the provider). Instantiate
+* directly at the call site that has the providers; there is no ambient
+* singleton.
+*/
+var ColumnRegistry = class {
+	providers;
+	constructor(providers) {
+		this.providers = providers;
+	}
+	/**
+	* Resolve a {@link PObjectId} to its backing {@link LeafEntry}. Returns
+	* `undefined` if the column is not reachable from any provider — caller
+	* decides whether that's `absent` or `resolving` via {@link isFinal}.
+	*/
+	resolve(id) {
+		return this.lookupById(id);
+	}
+	/** Whether every indexed source has finished enumerating its columns. */
+	isFinal() {
+		return this.providers.every((p) => p.isFinal());
+	}
+	lookupById(id) {
+		for (const p of this.providers) {
+			const hit = p.getPObjectEntries().get(id);
+			if (hit !== void 0) return hit;
+		}
+	}
+};
+//#endregion
+exports.ColumnRegistry = ColumnRegistry;
+
+//# sourceMappingURL=column_registry.cjs.map

package/dist/columns/column_registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"column_registry.cjs","names":[],"sources":["../../src/columns/column_registry.ts"],"sourcesContent":["import type { PObjectId } from \"../pool\";\nimport type { AccessorLike, ColumnEntriesProvider, LeafEntry } from \"./types\";\n\n/**\n * Id-index over a set of {@link ColumnEntriesProvider}s. Sole job:\n * {@link PObjectId} → {@link LeafEntry}. Generic over the accessor flavour, so\n * the same class backs both sandbox (`TreeNodeAccessor`) and host\n * (`PlTreeNodeAccessor`) usage.\n *\n * Stateless beyond the provider list — every lookup goes through each\n * provider's `getPObjectEntries()` (cached inside the provider). Instantiate\n * directly at the call site that has the providers; there is no ambient\n * singleton.\n */\nexport class ColumnRegistry<A extends AccessorLike<A>> {\n  constructor(private readonly providers: ReadonlyArray<ColumnEntriesProvider<A>>) {}\n\n  /**\n   * Resolve a {@link PObjectId} to its backing {@link LeafEntry}. Returns\n   * `undefined` if the column is not reachable from any provider — caller\n   * decides whether that's `absent` or `resolving` via {@link isFinal}.\n   */\n  resolve(id: PObjectId): LeafEntry<A> | undefined {\n    return this.lookupById(id);\n  }\n\n  /** Whether every indexed source has finished enumerating its columns. */\n  isFinal(): boolean {\n    return this.providers.every((p) => p.isFinal());\n  }\n\n  private lookupById(id: PObjectId): LeafEntry<A> | undefined {\n    // First-wins across providers — caller controls precedence via the\n    // construction order of `providers`.\n    for (const p of this.providers) {\n      const hit = p.getPObjectEntries().get(id);\n      if (hit !== undefined) return hit;\n    }\n    return undefined;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAcA,IAAa,iBAAb,MAAuD;CACxB;CAA7B,YAAY,WAAqE;EAApD,KAAA,YAAA;CAAqD;;;;;;CAOlF,QAAQ,IAAyC;EAC/C,OAAO,KAAK,WAAW,EAAE;CAC3B;;CAGA,UAAmB;EACjB,OAAO,KAAK,UAAU,OAAO,MAAM,EAAE,QAAQ,CAAC;CAChD;CAEA,WAAmB,IAAyC;EAG1D,KAAK,MAAM,KAAK,KAAK,WAAW;GAC9B,MAAM,MAAM,EAAE,kBAAkB,CAAC,CAAC,IAAI,EAAE;GACxC,IAAI,QAAQ,KAAA,GAAW,OAAO;EAChC;CAEF;AACF"}

package/dist/columns/column_registry.d.ts

@@ -0,0 +1,31 @@
+import { PObjectId } from "../pool/spec.js";
+import { AccessorLike, ColumnEntriesProvider, LeafEntry } from "./types.js";
+
+//#region src/columns/column_registry.d.ts
+/**
+ * Id-index over a set of {@link ColumnEntriesProvider}s. Sole job:
+ * {@link PObjectId} → {@link LeafEntry}. Generic over the accessor flavour, so
+ * the same class backs both sandbox (`TreeNodeAccessor`) and host
+ * (`PlTreeNodeAccessor`) usage.
+ *
+ * Stateless beyond the provider list — every lookup goes through each
+ * provider's `getPObjectEntries()` (cached inside the provider). Instantiate
+ * directly at the call site that has the providers; there is no ambient
+ * singleton.
+ */
+declare class ColumnRegistry<A extends AccessorLike<A>> {
+  private readonly providers;
+  constructor(providers: ReadonlyArray<ColumnEntriesProvider<A>>);
+  /**
+   * Resolve a {@link PObjectId} to its backing {@link LeafEntry}. Returns
+   * `undefined` if the column is not reachable from any provider — caller
+   * decides whether that's `absent` or `resolving` via {@link isFinal}.
+   */
+  resolve(id: PObjectId): LeafEntry<A> | undefined;
+  /** Whether every indexed source has finished enumerating its columns. */
+  isFinal(): boolean;
+  private lookupById;
+}
+//#endregion
+export { ColumnRegistry };
+//# sourceMappingURL=column_registry.d.ts.map

package/dist/columns/column_registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column_registry.d.ts","names":[],"sources":["../../src/columns/column_registry.ts"],"mappings":";;;;;;;AAcA;;;;;;;;cAAa,cAAA,WAAyB,YAAA,CAAa,CAAA;EAAA,iBACpB,SAAA;cAAA,SAAA,EAAW,aAAA,CAAc,qBAAA,CAAsB,CAAA;EAO3C;;;;;EAAjC,OAAA,CAAQ,EAAA,EAAI,SAAA,GAAY,SAAA,CAAU,CAAA;;EAKlC,OAAA;EAAA,QAIQ,UAAA;AAAA"}

package/dist/columns/column_registry.js

@@ -0,0 +1,40 @@
+//#region src/columns/column_registry.ts
+/**
+* Id-index over a set of {@link ColumnEntriesProvider}s. Sole job:
+* {@link PObjectId} → {@link LeafEntry}. Generic over the accessor flavour, so
+* the same class backs both sandbox (`TreeNodeAccessor`) and host
+* (`PlTreeNodeAccessor`) usage.
+*
+* Stateless beyond the provider list — every lookup goes through each
+* provider's `getPObjectEntries()` (cached inside the provider). Instantiate
+* directly at the call site that has the providers; there is no ambient
+* singleton.
+*/
+var ColumnRegistry = class {
+	providers;
+	constructor(providers) {
+		this.providers = providers;
+	}
+	/**
+	* Resolve a {@link PObjectId} to its backing {@link LeafEntry}. Returns
+	* `undefined` if the column is not reachable from any provider — caller
+	* decides whether that's `absent` or `resolving` via {@link isFinal}.
+	*/
+	resolve(id) {
+		return this.lookupById(id);
+	}
+	/** Whether every indexed source has finished enumerating its columns. */
+	isFinal() {
+		return this.providers.every((p) => p.isFinal());
+	}
+	lookupById(id) {
+		for (const p of this.providers) {
+			const hit = p.getPObjectEntries().get(id);
+			if (hit !== void 0) return hit;
+		}
+	}
+};
+//#endregion
+export { ColumnRegistry };
+
+//# sourceMappingURL=column_registry.js.map

package/dist/columns/column_registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column_registry.js","names":[],"sources":["../../src/columns/column_registry.ts"],"sourcesContent":["import type { PObjectId } from \"../pool\";\nimport type { AccessorLike, ColumnEntriesProvider, LeafEntry } from \"./types\";\n\n/**\n * Id-index over a set of {@link ColumnEntriesProvider}s. Sole job:\n * {@link PObjectId} → {@link LeafEntry}. Generic over the accessor flavour, so\n * the same class backs both sandbox (`TreeNodeAccessor`) and host\n * (`PlTreeNodeAccessor`) usage.\n *\n * Stateless beyond the provider list — every lookup goes through each\n * provider's `getPObjectEntries()` (cached inside the provider). Instantiate\n * directly at the call site that has the providers; there is no ambient\n * singleton.\n */\nexport class ColumnRegistry<A extends AccessorLike<A>> {\n  constructor(private readonly providers: ReadonlyArray<ColumnEntriesProvider<A>>) {}\n\n  /**\n   * Resolve a {@link PObjectId} to its backing {@link LeafEntry}. Returns\n   * `undefined` if the column is not reachable from any provider — caller\n   * decides whether that's `absent` or `resolving` via {@link isFinal}.\n   */\n  resolve(id: PObjectId): LeafEntry<A> | undefined {\n    return this.lookupById(id);\n  }\n\n  /** Whether every indexed source has finished enumerating its columns. */\n  isFinal(): boolean {\n    return this.providers.every((p) => p.isFinal());\n  }\n\n  private lookupById(id: PObjectId): LeafEntry<A> | undefined {\n    // First-wins across providers — caller controls precedence via the\n    // construction order of `providers`.\n    for (const p of this.providers) {\n      const hit = p.getPObjectEntries().get(id);\n      if (hit !== undefined) return hit;\n    }\n    return undefined;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAcA,IAAa,iBAAb,MAAuD;CACxB;CAA7B,YAAY,WAAqE;EAApD,KAAA,YAAA;CAAqD;;;;;;CAOlF,QAAQ,IAAyC;EAC/C,OAAO,KAAK,WAAW,EAAE;CAC3B;;CAGA,UAAmB;EACjB,OAAO,KAAK,UAAU,OAAO,MAAM,EAAE,QAAQ,CAAC;CAChD;CAEA,WAAmB,IAAyC;EAG1D,KAAK,MAAM,KAAK,KAAK,WAAW;GAC9B,MAAM,MAAM,EAAE,kBAAkB,CAAC,CAAC,IAAI,EAAE;GACxC,IAAI,QAAQ,KAAA,GAAW,OAAO;EAChC;CAEF;AACF"}

package/dist/columns/column_selector.cjs

@@ -0,0 +1,49 @@
+//#region src/columns/column_selector.ts
+function normalizeStringMatchers(input) {
+	if (typeof input === "string") return [{
+		type: "regex",
+		value: input
+	}];
+	if (!Array.isArray(input)) return [input];
+	return input.map((v) => typeof v === "string" ? {
+		type: "regex",
+		value: v
+	} : v);
+}
+function normalizeRecord(input) {
+	const result = {};
+	for (const [key, value] of Object.entries(input)) result[key] = normalizeStringMatchers(value);
+	return result;
+}
+function normalizeTypes(input) {
+	return Array.isArray(input) ? input : [input];
+}
+function convertRelaxedAxisSelectorToMultiAxisSelector(input) {
+	const result = {};
+	if (input.name !== void 0) result.name = normalizeStringMatchers(input.name);
+	if (input.type !== void 0) result.type = normalizeTypes(input.type);
+	if (input.domain !== void 0) result.domain = normalizeRecord(input.domain);
+	if (input.contextDomain !== void 0) result.contextDomain = normalizeRecord(input.contextDomain);
+	if (input.annotations !== void 0) result.annotations = normalizeRecord(input.annotations);
+	return result;
+}
+function convertRelaxedColumnSelectorToMultiColumnSelector(input) {
+	const result = {};
+	if (input.name !== void 0) result.name = normalizeStringMatchers(input.name);
+	if (input.type !== void 0) result.type = normalizeTypes(input.type);
+	if (input.domain !== void 0) result.domain = normalizeRecord(input.domain);
+	if (input.contextDomain !== void 0) result.contextDomain = normalizeRecord(input.contextDomain);
+	if (input.annotations !== void 0) result.annotations = normalizeRecord(input.annotations);
+	if (input.axes !== void 0) result.axes = input.axes.map(convertRelaxedAxisSelectorToMultiAxisSelector);
+	if (input.partialAxesMatch !== void 0) result.partialAxesMatch = input.partialAxesMatch;
+	return result;
+}
+function convertColumnSelectorToMultiColumnSelector(input) {
+	return (Array.isArray(input) ? input : [input]).map(convertRelaxedColumnSelectorToMultiColumnSelector);
+}
+//#endregion
+exports.convertColumnSelectorToMultiColumnSelector = convertColumnSelectorToMultiColumnSelector;
+exports.convertRelaxedAxisSelectorToMultiAxisSelector = convertRelaxedAxisSelectorToMultiAxisSelector;
+exports.convertRelaxedColumnSelectorToMultiColumnSelector = convertRelaxedColumnSelectorToMultiColumnSelector;
+
+//# sourceMappingURL=column_selector.cjs.map

package/dist/columns/column_selector.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"column_selector.cjs","names":[],"sources":["../../src/columns/column_selector.ts"],"sourcesContent":["import type {\n  AxisValueType,\n  ColumnValueType,\n  MultiAxisSelector,\n  MultiColumnSelector,\n  StringMatcher,\n} from \"../drivers/pframe\";\n\nexport type { StringMatcher } from \"../drivers/pframe\";\n\n// --- Relaxed types ---\n\n/** Relaxed string matcher input: plain string, single matcher, or array of mixed. */\nexport type RelaxedStringMatchers = string | StringMatcher | (string | StringMatcher)[];\n\n/** Relaxed record matcher: values can be plain strings or relaxed matchers. */\nexport type RelaxedRecord = Record<string, RelaxedStringMatchers>;\n\n/** Relaxed axis selector — accepts plain strings where strict requires StringMatcher[]. */\nexport interface RelaxedAxisSelector {\n  name?: RelaxedStringMatchers;\n  type?: AxisValueType | AxisValueType[];\n  domain?: RelaxedRecord;\n  contextDomain?: RelaxedRecord;\n  annotations?: RelaxedRecord;\n}\n\n/** Relaxed column selector — convenient hand-written form. */\nexport interface RelaxedColumnSelector {\n  name?: RelaxedStringMatchers;\n  type?: ColumnValueType | ColumnValueType[];\n  domain?: RelaxedRecord;\n  contextDomain?: RelaxedRecord;\n  annotations?: RelaxedRecord;\n  axes?: RelaxedAxisSelector[];\n  partialAxesMatch?: boolean;\n}\n\n/** One or many relaxed column selectors; normalizes to MultiColumnSelector[]. */\nexport type ColumnSelector = RelaxedColumnSelector | RelaxedColumnSelector[];\n\n// --- Normalization ---\n\nfunction normalizeStringMatchers(input: RelaxedStringMatchers): StringMatcher[] {\n  if (typeof input === \"string\") return [{ type: \"regex\", value: input }];\n  if (!Array.isArray(input)) return [input];\n  return input.map((v) =>\n    typeof v === \"string\" ? ({ type: \"regex\", value: v } satisfies StringMatcher) : v,\n  );\n}\n\nfunction normalizeRecord(input: RelaxedRecord): Record<string, StringMatcher[]> {\n  const result: Record<string, StringMatcher[]> = {};\n  for (const [key, value] of Object.entries(input)) {\n    result[key] = normalizeStringMatchers(value);\n  }\n  return result;\n}\n\nfunction normalizeTypes<T>(input: T | T[]): T[] {\n  return Array.isArray(input) ? input : [input];\n}\n\ntype Mutable<T> = { -readonly [K in keyof T]: T[K] };\n\nexport function convertRelaxedAxisSelectorToMultiAxisSelector(\n  input: RelaxedAxisSelector,\n): MultiAxisSelector {\n  const result: Mutable<MultiAxisSelector> = {};\n  if (input.name !== undefined) result.name = normalizeStringMatchers(input.name);\n  if (input.type !== undefined) result.type = normalizeTypes(input.type);\n  if (input.domain !== undefined) result.domain = normalizeRecord(input.domain);\n  if (input.contextDomain !== undefined)\n    result.contextDomain = normalizeRecord(input.contextDomain);\n  if (input.annotations !== undefined) result.annotations = normalizeRecord(input.annotations);\n  return result;\n}\n\nexport function convertRelaxedColumnSelectorToMultiColumnSelector(\n  input: RelaxedColumnSelector,\n): MultiColumnSelector {\n  const result: Mutable<MultiColumnSelector> = {};\n  if (input.name !== undefined) result.name = normalizeStringMatchers(input.name);\n  if (input.type !== undefined) result.type = normalizeTypes(input.type);\n  if (input.domain !== undefined) result.domain = normalizeRecord(input.domain);\n  if (input.contextDomain !== undefined)\n    result.contextDomain = normalizeRecord(input.contextDomain);\n  if (input.annotations !== undefined) result.annotations = normalizeRecord(input.annotations);\n  if (input.axes !== undefined)\n    result.axes = input.axes.map(convertRelaxedAxisSelectorToMultiAxisSelector);\n  if (input.partialAxesMatch !== undefined) result.partialAxesMatch = input.partialAxesMatch;\n  return result;\n}\n\nexport function convertColumnSelectorToMultiColumnSelector(\n  input: ColumnSelector,\n): MultiColumnSelector[] {\n  const arr = Array.isArray(input) ? input : [input];\n  return arr.map(convertRelaxedColumnSelectorToMultiColumnSelector);\n}\n"],"mappings":";AA2CA,SAAS,wBAAwB,OAA+C;CAC9E,IAAI,OAAO,UAAU,UAAU,OAAO,CAAC;EAAE,MAAM;EAAS,OAAO;CAAM,CAAC;CACtE,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,CAAC,KAAK;CACxC,OAAO,MAAM,KAAK,MAChB,OAAO,MAAM,WAAY;EAAE,MAAM;EAAS,OAAO;CAAE,IAA6B,CAClF;AACF;AAEA,SAAS,gBAAgB,OAAuD;CAC9E,MAAM,SAA0C,CAAC;CACjD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,OAAO,OAAO,wBAAwB,KAAK;CAE7C,OAAO;AACT;AAEA,SAAS,eAAkB,OAAqB;CAC9C,OAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AAC9C;AAIA,SAAgB,8CACd,OACmB;CACnB,MAAM,SAAqC,CAAC;CAC5C,IAAI,MAAM,SAAS,KAAA,GAAW,OAAO,OAAO,wBAAwB,MAAM,IAAI;CAC9E,IAAI,MAAM,SAAS,KAAA,GAAW,OAAO,OAAO,eAAe,MAAM,IAAI;CACrE,IAAI,MAAM,WAAW,KAAA,GAAW,OAAO,SAAS,gBAAgB,MAAM,MAAM;CAC5E,IAAI,MAAM,kBAAkB,KAAA,GAC1B,OAAO,gBAAgB,gBAAgB,MAAM,aAAa;CAC5D,IAAI,MAAM,gBAAgB,KAAA,GAAW,OAAO,cAAc,gBAAgB,MAAM,WAAW;CAC3F,OAAO;AACT;AAEA,SAAgB,kDACd,OACqB;CACrB,MAAM,SAAuC,CAAC;CAC9C,IAAI,MAAM,SAAS,KAAA,GAAW,OAAO,OAAO,wBAAwB,MAAM,IAAI;CAC9E,IAAI,MAAM,SAAS,KAAA,GAAW,OAAO,OAAO,eAAe,MAAM,IAAI;CACrE,IAAI,MAAM,WAAW,KAAA,GAAW,OAAO,SAAS,gBAAgB,MAAM,MAAM;CAC5E,IAAI,MAAM,kBAAkB,KAAA,GAC1B,OAAO,gBAAgB,gBAAgB,MAAM,aAAa;CAC5D,IAAI,MAAM,gBAAgB,KAAA,GAAW,OAAO,cAAc,gBAAgB,MAAM,WAAW;CAC3F,IAAI,MAAM,SAAS,KAAA,GACjB,OAAO,OAAO,MAAM,KAAK,IAAI,6CAA6C;CAC5E,IAAI,MAAM,qBAAqB,KAAA,GAAW,OAAO,mBAAmB,MAAM;CAC1E,OAAO;AACT;AAEA,SAAgB,2CACd,OACuB;CAEvB,QADY,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAA,CACtC,IAAI,iDAAiD;AAClE"}

package/dist/columns/column_selector.d.ts

@@ -0,0 +1,33 @@
+import { AxisValueType, ColumnValueType } from "../drivers/pframe/spec/spec.js";
+import { MultiAxisSelector, MultiColumnSelector, StringMatcher } from "../drivers/pframe/spec_driver.js";
+//#region src/columns/column_selector.d.ts
+/** Relaxed string matcher input: plain string, single matcher, or array of mixed. */
+type RelaxedStringMatchers = string | StringMatcher | (string | StringMatcher)[];
+/** Relaxed record matcher: values can be plain strings or relaxed matchers. */
+type RelaxedRecord = Record<string, RelaxedStringMatchers>;
+/** Relaxed axis selector — accepts plain strings where strict requires StringMatcher[]. */
+interface RelaxedAxisSelector {
+  name?: RelaxedStringMatchers;
+  type?: AxisValueType | AxisValueType[];
+  domain?: RelaxedRecord;
+  contextDomain?: RelaxedRecord;
+  annotations?: RelaxedRecord;
+}
+/** Relaxed column selector — convenient hand-written form. */
+interface RelaxedColumnSelector {
+  name?: RelaxedStringMatchers;
+  type?: ColumnValueType | ColumnValueType[];
+  domain?: RelaxedRecord;
+  contextDomain?: RelaxedRecord;
+  annotations?: RelaxedRecord;
+  axes?: RelaxedAxisSelector[];
+  partialAxesMatch?: boolean;
+}
+/** One or many relaxed column selectors; normalizes to MultiColumnSelector[]. */
+type ColumnSelector = RelaxedColumnSelector | RelaxedColumnSelector[];
+declare function convertRelaxedAxisSelectorToMultiAxisSelector(input: RelaxedAxisSelector): MultiAxisSelector;
+declare function convertRelaxedColumnSelectorToMultiColumnSelector(input: RelaxedColumnSelector): MultiColumnSelector;
+declare function convertColumnSelectorToMultiColumnSelector(input: ColumnSelector): MultiColumnSelector[];
+//#endregion
+export { ColumnSelector, RelaxedAxisSelector, RelaxedColumnSelector, RelaxedRecord, RelaxedStringMatchers, convertColumnSelectorToMultiColumnSelector, convertRelaxedAxisSelectorToMultiAxisSelector, convertRelaxedColumnSelectorToMultiColumnSelector };
+//# sourceMappingURL=column_selector.d.ts.map

package/dist/columns/column_selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column_selector.d.ts","names":[],"sources":["../../src/columns/column_selector.ts"],"mappings":";;;;KAaY,qBAAA,YAAiC,aAAA,aAA0B,aAAa;;KAGxE,aAAA,GAAgB,MAAM,SAAS,qBAAA;;UAG1B,mBAAA;EACf,IAAA,GAAO,qBAAA;EACP,IAAA,GAAO,aAAA,GAAgB,aAAA;EACvB,MAAA,GAAS,aAAA;EACT,aAAA,GAAgB,aAAA;EAChB,WAAA,GAAc,aAAA;AAAA;AARgD;AAAA,UAY/C,qBAAA;EACf,IAAA,GAAO,qBAAA;EACP,IAAA,GAAO,eAAA,GAAkB,eAAA;EACzB,MAAA,GAAS,aAAA;EACT,aAAA,GAAgB,aAAA;EAChB,WAAA,GAAc,aAAA;EACd,IAAA,GAAO,mBAAA;EACP,gBAAA;AAAA;;KAIU,cAAA,GAAiB,qBAAA,GAAwB,qBAAqB;AAAA,iBA0B1D,6CAAA,CACd,KAAA,EAAO,mBAAA,GACN,iBAAiB;AAAA,iBAWJ,iDAAA,CACd,KAAA,EAAO,qBAAA,GACN,mBAAmB;AAAA,iBAcN,0CAAA,CACd,KAAA,EAAO,cAAA,GACN,mBAAmB"}

package/dist/columns/column_selector.js

@@ -0,0 +1,47 @@
+//#region src/columns/column_selector.ts
+function normalizeStringMatchers(input) {
+	if (typeof input === "string") return [{
+		type: "regex",
+		value: input
+	}];
+	if (!Array.isArray(input)) return [input];
+	return input.map((v) => typeof v === "string" ? {
+		type: "regex",
+		value: v
+	} : v);
+}
+function normalizeRecord(input) {
+	const result = {};
+	for (const [key, value] of Object.entries(input)) result[key] = normalizeStringMatchers(value);
+	return result;
+}
+function normalizeTypes(input) {
+	return Array.isArray(input) ? input : [input];
+}
+function convertRelaxedAxisSelectorToMultiAxisSelector(input) {
+	const result = {};
+	if (input.name !== void 0) result.name = normalizeStringMatchers(input.name);
+	if (input.type !== void 0) result.type = normalizeTypes(input.type);
+	if (input.domain !== void 0) result.domain = normalizeRecord(input.domain);
+	if (input.contextDomain !== void 0) result.contextDomain = normalizeRecord(input.contextDomain);
+	if (input.annotations !== void 0) result.annotations = normalizeRecord(input.annotations);
+	return result;
+}
+function convertRelaxedColumnSelectorToMultiColumnSelector(input) {
+	const result = {};
+	if (input.name !== void 0) result.name = normalizeStringMatchers(input.name);
+	if (input.type !== void 0) result.type = normalizeTypes(input.type);
+	if (input.domain !== void 0) result.domain = normalizeRecord(input.domain);
+	if (input.contextDomain !== void 0) result.contextDomain = normalizeRecord(input.contextDomain);
+	if (input.annotations !== void 0) result.annotations = normalizeRecord(input.annotations);
+	if (input.axes !== void 0) result.axes = input.axes.map(convertRelaxedAxisSelectorToMultiAxisSelector);
+	if (input.partialAxesMatch !== void 0) result.partialAxesMatch = input.partialAxesMatch;
+	return result;
+}
+function convertColumnSelectorToMultiColumnSelector(input) {
+	return (Array.isArray(input) ? input : [input]).map(convertRelaxedColumnSelectorToMultiColumnSelector);
+}
+//#endregion
+export { convertColumnSelectorToMultiColumnSelector, convertRelaxedAxisSelectorToMultiAxisSelector, convertRelaxedColumnSelectorToMultiColumnSelector };
+
+//# sourceMappingURL=column_selector.js.map

package/dist/columns/column_selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column_selector.js","names":[],"sources":["../../src/columns/column_selector.ts"],"sourcesContent":["import type {\n  AxisValueType,\n  ColumnValueType,\n  MultiAxisSelector,\n  MultiColumnSelector,\n  StringMatcher,\n} from \"../drivers/pframe\";\n\nexport type { StringMatcher } from \"../drivers/pframe\";\n\n// --- Relaxed types ---\n\n/** Relaxed string matcher input: plain string, single matcher, or array of mixed. */\nexport type RelaxedStringMatchers = string | StringMatcher | (string | StringMatcher)[];\n\n/** Relaxed record matcher: values can be plain strings or relaxed matchers. */\nexport type RelaxedRecord = Record<string, RelaxedStringMatchers>;\n\n/** Relaxed axis selector — accepts plain strings where strict requires StringMatcher[]. */\nexport interface RelaxedAxisSelector {\n  name?: RelaxedStringMatchers;\n  type?: AxisValueType | AxisValueType[];\n  domain?: RelaxedRecord;\n  contextDomain?: RelaxedRecord;\n  annotations?: RelaxedRecord;\n}\n\n/** Relaxed column selector — convenient hand-written form. */\nexport interface RelaxedColumnSelector {\n  name?: RelaxedStringMatchers;\n  type?: ColumnValueType | ColumnValueType[];\n  domain?: RelaxedRecord;\n  contextDomain?: RelaxedRecord;\n  annotations?: RelaxedRecord;\n  axes?: RelaxedAxisSelector[];\n  partialAxesMatch?: boolean;\n}\n\n/** One or many relaxed column selectors; normalizes to MultiColumnSelector[]. */\nexport type ColumnSelector = RelaxedColumnSelector | RelaxedColumnSelector[];\n\n// --- Normalization ---\n\nfunction normalizeStringMatchers(input: RelaxedStringMatchers): StringMatcher[] {\n  if (typeof input === \"string\") return [{ type: \"regex\", value: input }];\n  if (!Array.isArray(input)) return [input];\n  return input.map((v) =>\n    typeof v === \"string\" ? ({ type: \"regex\", value: v } satisfies StringMatcher) : v,\n  );\n}\n\nfunction normalizeRecord(input: RelaxedRecord): Record<string, StringMatcher[]> {\n  const result: Record<string, StringMatcher[]> = {};\n  for (const [key, value] of Object.entries(input)) {\n    result[key] = normalizeStringMatchers(value);\n  }\n  return result;\n}\n\nfunction normalizeTypes<T>(input: T | T[]): T[] {\n  return Array.isArray(input) ? input : [input];\n}\n\ntype Mutable<T> = { -readonly [K in keyof T]: T[K] };\n\nexport function convertRelaxedAxisSelectorToMultiAxisSelector(\n  input: RelaxedAxisSelector,\n): MultiAxisSelector {\n  const result: Mutable<MultiAxisSelector> = {};\n  if (input.name !== undefined) result.name = normalizeStringMatchers(input.name);\n  if (input.type !== undefined) result.type = normalizeTypes(input.type);\n  if (input.domain !== undefined) result.domain = normalizeRecord(input.domain);\n  if (input.contextDomain !== undefined)\n    result.contextDomain = normalizeRecord(input.contextDomain);\n  if (input.annotations !== undefined) result.annotations = normalizeRecord(input.annotations);\n  return result;\n}\n\nexport function convertRelaxedColumnSelectorToMultiColumnSelector(\n  input: RelaxedColumnSelector,\n): MultiColumnSelector {\n  const result: Mutable<MultiColumnSelector> = {};\n  if (input.name !== undefined) result.name = normalizeStringMatchers(input.name);\n  if (input.type !== undefined) result.type = normalizeTypes(input.type);\n  if (input.domain !== undefined) result.domain = normalizeRecord(input.domain);\n  if (input.contextDomain !== undefined)\n    result.contextDomain = normalizeRecord(input.contextDomain);\n  if (input.annotations !== undefined) result.annotations = normalizeRecord(input.annotations);\n  if (input.axes !== undefined)\n    result.axes = input.axes.map(convertRelaxedAxisSelectorToMultiAxisSelector);\n  if (input.partialAxesMatch !== undefined) result.partialAxesMatch = input.partialAxesMatch;\n  return result;\n}\n\nexport function convertColumnSelectorToMultiColumnSelector(\n  input: ColumnSelector,\n): MultiColumnSelector[] {\n  const arr = Array.isArray(input) ? input : [input];\n  return arr.map(convertRelaxedColumnSelectorToMultiColumnSelector);\n}\n"],"mappings":";AA2CA,SAAS,wBAAwB,OAA+C;CAC9E,IAAI,OAAO,UAAU,UAAU,OAAO,CAAC;EAAE,MAAM;EAAS,OAAO;CAAM,CAAC;CACtE,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,CAAC,KAAK;CACxC,OAAO,MAAM,KAAK,MAChB,OAAO,MAAM,WAAY;EAAE,MAAM;EAAS,OAAO;CAAE,IAA6B,CAClF;AACF;AAEA,SAAS,gBAAgB,OAAuD;CAC9E,MAAM,SAA0C,CAAC;CACjD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,OAAO,OAAO,wBAAwB,KAAK;CAE7C,OAAO;AACT;AAEA,SAAS,eAAkB,OAAqB;CAC9C,OAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AAC9C;AAIA,SAAgB,8CACd,OACmB;CACnB,MAAM,SAAqC,CAAC;CAC5C,IAAI,MAAM,SAAS,KAAA,GAAW,OAAO,OAAO,wBAAwB,MAAM,IAAI;CAC9E,IAAI,MAAM,SAAS,KAAA,GAAW,OAAO,OAAO,eAAe,MAAM,IAAI;CACrE,IAAI,MAAM,WAAW,KAAA,GAAW,OAAO,SAAS,gBAAgB,MAAM,MAAM;CAC5E,IAAI,MAAM,kBAAkB,KAAA,GAC1B,OAAO,gBAAgB,gBAAgB,MAAM,aAAa;CAC5D,IAAI,MAAM,gBAAgB,KAAA,GAAW,OAAO,cAAc,gBAAgB,MAAM,WAAW;CAC3F,OAAO;AACT;AAEA,SAAgB,kDACd,OACqB;CACrB,MAAM,SAAuC,CAAC;CAC9C,IAAI,MAAM,SAAS,KAAA,GAAW,OAAO,OAAO,wBAAwB,MAAM,IAAI;CAC9E,IAAI,MAAM,SAAS,KAAA,GAAW,OAAO,OAAO,eAAe,MAAM,IAAI;CACrE,IAAI,MAAM,WAAW,KAAA,GAAW,OAAO,SAAS,gBAAgB,MAAM,MAAM;CAC5E,IAAI,MAAM,kBAAkB,KAAA,GAC1B,OAAO,gBAAgB,gBAAgB,MAAM,aAAa;CAC5D,IAAI,MAAM,gBAAgB,KAAA,GAAW,OAAO,cAAc,gBAAgB,MAAM,WAAW;CAC3F,IAAI,MAAM,SAAS,KAAA,GACjB,OAAO,OAAO,MAAM,KAAK,IAAI,6CAA6C;CAC5E,IAAI,MAAM,qBAAqB,KAAA,GAAW,OAAO,mBAAmB,MAAM;CAC1E,OAAO;AACT;AAEA,SAAgB,2CACd,OACuB;CAEvB,QADY,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAA,CACtC,IAAI,iDAAiD;AAClE"}