@platforma-sdk/model 1.79.27 → 1.80.0

package/dist/columns/derive_axis_values_labels.js

@@ -0,0 +1,76 @@
+import { TreeNodeAccessor } from "../render/accessor.js";
+import "../render/index.js";
+import { isColumnLazy } from "./column_lazy.js";
+import { ColumnsCollection, isColumnsCollection } from "./columns_collection.js";
+import { PColumnName, canonicalizeAxisId, getAxisId } from "@milaboratories/pl-model-common";
+//#region src/columns/derive_axis_values_labels.ts
+const RT_JSON = "PColumnData/Json";
+const RT_JSON_PARTITIONED = "PColumnData/JsonPartitioned";
+/**
+* Build an `axisValuesLabels` callback by discovering `pl7.app/label` columns
+* from the given source, eagerly materialising their value→label maps, and
+* keying them by canonical axis id.
+*
+* Modern replacement for `ctx.resultPool.findLabels` — uses the new
+* column-access mechanism (filtered {@link ColumnsCollection}) instead of
+* walking the raw result pool.
+*
+* Pair with {@link expandByPartition} (or any consumer expecting the
+* `(axisId) => Record<axisValue, label>` shape).
+*
+* Skips:
+*  - non-leaf recipes (only direct `ColumnLazy` data is read);
+*  - label columns whose `axesSpec.length !== 1`;
+*  - label columns whose data resource type isn't `PColumnData/Json` /
+*    `PColumnData/JsonPartitioned`.
+*/
+function deriveAxisValuesLabels(source, opts) {
+	const byAxis = (source === void 0 ? ColumnsCollection(void 0, opts) : isColumnsCollection(source) ? source : ColumnsCollection(source, opts)).filter({ include: { name: [{
+		type: "exact",
+		value: PColumnName.Label
+	}] } }).getColumns().reduce((map, col) => {
+		if (!isColumnLazy(col)) return map;
+		const spec = col.getSpec();
+		if (spec.axesSpec.length !== 1) return map;
+		const data = col.getData();
+		if (!(data instanceof TreeNodeAccessor)) return map;
+		const labelMap = readLabelMap(data);
+		if (!labelMap) return map;
+		map.set(canonicalizeAxisId(getAxisId(spec.axesSpec[0])), labelMap);
+		return map;
+	}, /* @__PURE__ */ new Map());
+	return (axisId) => byAxis.get(canonicalizeAxisId(axisId));
+}
+function readLabelMap(acc) {
+	const rt = acc.resourceType.name;
+	if (rt === RT_JSON) {
+		const json = acc.getDataAsJson();
+		return json?.data ? parseLabelKeys(json.data) : void 0;
+	}
+	if (rt === RT_JSON_PARTITIONED) return acc.listInputFields().reduce((merged, partKey) => {
+		const part = acc.resolve({
+			field: partKey,
+			assertFieldType: "Input",
+			ignoreError: true
+		});
+		if (!part) return merged;
+		const json = part.getDataAsJson();
+		if (!json?.data) return merged;
+		return Object.assign(merged, parseLabelKeys(json.data));
+	}, {});
+}
+function parseLabelKeys(raw) {
+	return Object.entries(raw).reduce((acc, [k, v]) => {
+		try {
+			const parsed = JSON.parse(k);
+			acc[Array.isArray(parsed) ? parsed[0] : parsed] = v;
+		} catch {
+			acc[k] = v;
+		}
+		return acc;
+	}, {});
+}
+//#endregion
+export { deriveAxisValuesLabels };
+
+//# sourceMappingURL=derive_axis_values_labels.js.map

package/dist/columns/derive_axis_values_labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive_axis_values_labels.js","names":[],"sources":["../../src/columns/derive_axis_values_labels.ts"],"sourcesContent":["import type { AxisId } from \"@milaboratories/pl-model-common\";\nimport { canonicalizeAxisId, getAxisId, PColumnName } from \"@milaboratories/pl-model-common\";\nimport type { ColumnsSource } from \"./column_providers\";\nimport { ColumnsCollection, isColumnsCollection } from \"./columns_collection\";\nimport type { GlobalCfgRenderCtx } from \"../render/internal\";\nimport { TreeNodeAccessor } from \"../render\";\nimport { isColumnLazy } from \"./column_lazy\";\n\nconst RT_JSON = \"PColumnData/Json\";\nconst RT_JSON_PARTITIONED = \"PColumnData/JsonPartitioned\";\n\n/**\n * Build an `axisValuesLabels` callback by discovering `pl7.app/label` columns\n * from the given source, eagerly materialising their value→label maps, and\n * keying them by canonical axis id.\n *\n * Modern replacement for `ctx.resultPool.findLabels` — uses the new\n * column-access mechanism (filtered {@link ColumnsCollection}) instead of\n * walking the raw result pool.\n *\n * Pair with {@link expandByPartition} (or any consumer expecting the\n * `(axisId) => Record<axisValue, label>` shape).\n *\n * Skips:\n *  - non-leaf recipes (only direct `ColumnLazy` data is read);\n *  - label columns whose `axesSpec.length !== 1`;\n *  - label columns whose data resource type isn't `PColumnData/Json` /\n *    `PColumnData/JsonPartitioned`.\n */\nexport function deriveAxisValuesLabels(\n  source?: ColumnsCollection | (ColumnsCollection | ColumnsSource)[],\n  opts?: { ctx?: GlobalCfgRenderCtx },\n): (axisId: AxisId) => Record<string | number, string> | undefined {\n  const collection =\n    source === undefined\n      ? ColumnsCollection(undefined, opts)\n      : isColumnsCollection(source)\n        ? source\n        : ColumnsCollection(source, opts);\n\n  const labelCols = collection\n    .filter({ include: { name: [{ type: \"exact\", value: PColumnName.Label }] } })\n    .getColumns();\n\n  const byAxis = labelCols.reduce<Map<string, Record<string | number, string>>>((map, col) => {\n    if (!isColumnLazy(col)) return map;\n    const spec = col.getSpec();\n    if (spec.axesSpec.length !== 1) return map;\n\n    const data = col.getData();\n    if (!(data instanceof TreeNodeAccessor)) return map;\n\n    const labelMap = readLabelMap(data);\n    if (!labelMap) return map;\n\n    map.set(canonicalizeAxisId(getAxisId(spec.axesSpec[0])), labelMap);\n    return map;\n  }, new Map());\n\n  return (axisId) => byAxis.get(canonicalizeAxisId(axisId));\n}\n\nfunction readLabelMap(acc: TreeNodeAccessor): undefined | Record<string | number, string> {\n  const rt = acc.resourceType.name;\n\n  if (rt === RT_JSON) {\n    const json = acc.getDataAsJson<{ data?: Record<string, string> }>();\n    return json?.data ? parseLabelKeys(json.data) : undefined;\n  }\n\n  if (rt === RT_JSON_PARTITIONED) {\n    return acc.listInputFields().reduce<Record<string | number, string>>((merged, partKey) => {\n      const part = acc.resolve({\n        field: partKey,\n        assertFieldType: \"Input\",\n        ignoreError: true,\n      });\n      if (!part) return merged;\n      const json = part.getDataAsJson<{ data?: Record<string, string> }>();\n      if (!json?.data) return merged;\n      return Object.assign(merged, parseLabelKeys(json.data));\n    }, {});\n  }\n\n  return undefined;\n}\n\nfunction parseLabelKeys(raw: Record<string, string>): Record<string | number, string> {\n  return Object.entries(raw).reduce<Record<string | number, string>>((acc, [k, v]) => {\n    try {\n      const parsed = JSON.parse(k);\n      acc[Array.isArray(parsed) ? parsed[0] : parsed] = v;\n    } catch {\n      acc[k] = v;\n    }\n    return acc;\n  }, {});\n}\n"],"mappings":";;;;;;AAQA,MAAM,UAAU;AAChB,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;AAoB5B,SAAgB,uBACd,QACA,MACiE;CAYjE,MAAM,UAVJ,WAAW,KAAA,IACP,kBAAkB,KAAA,GAAW,IAAI,IACjC,oBAAoB,MAAM,IACxB,SACA,kBAAkB,QAAQ,IAAI,EAAA,CAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;EAAE,MAAM;EAAS,OAAO,YAAY;CAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAC5E,WAEoB,CAAC,CAAC,QAAsD,KAAK,QAAQ;EAC1F,IAAI,CAAC,aAAa,GAAG,GAAG,OAAO;EAC/B,MAAM,OAAO,IAAI,QAAQ;EACzB,IAAI,KAAK,SAAS,WAAW,GAAG,OAAO;EAEvC,MAAM,OAAO,IAAI,QAAQ;EACzB,IAAI,EAAE,gBAAgB,mBAAmB,OAAO;EAEhD,MAAM,WAAW,aAAa,IAAI;EAClC,IAAI,CAAC,UAAU,OAAO;EAEtB,IAAI,IAAI,mBAAmB,UAAU,KAAK,SAAS,EAAE,CAAC,GAAG,QAAQ;EACjE,OAAO;CACT,mBAAG,IAAI,IAAI,CAAC;CAEZ,QAAQ,WAAW,OAAO,IAAI,mBAAmB,MAAM,CAAC;AAC1D;AAEA,SAAS,aAAa,KAAoE;CACxF,MAAM,KAAK,IAAI,aAAa;CAE5B,IAAI,OAAO,SAAS;EAClB,MAAM,OAAO,IAAI,cAAiD;EAClE,OAAO,MAAM,OAAO,eAAe,KAAK,IAAI,IAAI,KAAA;CAClD;CAEA,IAAI,OAAO,qBACT,OAAO,IAAI,gBAAgB,CAAC,CAAC,QAAyC,QAAQ,YAAY;EACxF,MAAM,OAAO,IAAI,QAAQ;GACvB,OAAO;GACP,iBAAiB;GACjB,aAAa;EACf,CAAC;EACD,IAAI,CAAC,MAAM,OAAO;EAClB,MAAM,OAAO,KAAK,cAAiD;EACnE,IAAI,CAAC,MAAM,MAAM,OAAO;EACxB,OAAO,OAAO,OAAO,QAAQ,eAAe,KAAK,IAAI,CAAC;CACxD,GAAG,CAAC,CAAC;AAIT;AAEA,SAAS,eAAe,KAA8D;CACpF,OAAO,OAAO,QAAQ,GAAG,CAAC,CAAC,QAAyC,KAAK,CAAC,GAAG,OAAO;EAClF,IAAI;GACF,MAAM,SAAS,KAAK,MAAM,CAAC;GAC3B,IAAI,MAAM,QAAQ,MAAM,IAAI,OAAO,KAAK,UAAU;EACpD,QAAQ;GACN,IAAI,KAAK;EACX;EACA,OAAO;CACT,GAAG,CAAC,CAAC;AACP"}

package/dist/columns/expand_by_partition.cjs

@@ -1,80 +1,77 @@
-const require_axis_filtering = require("../render/util/axis_filtering.cjs");
+const require_accessor = require("../render/accessor.cjs");
 const require_pcolumn_data = require("../render/util/pcolumn_data.cjs");
-const require_column_snapshot = require("./column_snapshot.cjs");
+const require_column_filtered_recipe = require("./column_recipes/column_filtered_recipe.cjs");
+const require_column_overrided_recipe = require("./column_recipes/column_overrided_recipe.cjs");
+const require_utils = require("./utils.cjs");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
 //#region src/columns/expand_by_partition.ts
+const MAX_KEY_COMBINATIONS = 1e4;
 /**
-* Expand snapshots by splitting along partition axes.
+* Expand each input column along the requested partition axes into one
+* {@link ColumnRecipe} per Cartesian combination of unique partition values.
+*
+* Each split is produced as `ColumnOverriddenRecipe.wrap(ColumnFilteredRecipe.wrap(inner, axisFilters), { domain, annotations })`:
+*   - `ColumnFilteredRecipe` pins all split axes at once (one wrap call with
+*     every `[idx, value]` pair) and removes them from `axesSpec`. The
+*     engine performs the data slicing via the `sliceAxes` query node.
+*   - `ColumnOverriddenRecipe` overlays a `domain[axisName] = String(value)`
+*     entry per split axis and appends a `split:<canonicalAxisId>` trace
+*     entry per split axis to the existing `pl7.app/trace` annotation.
 *
-* For each snapshot, reads partition data, enumerates unique keys on the
-* split axes, and produces one output snapshot per key combination —
-* with the split axes removed from `axesSpec` and a `pl7.app/trace`
-* annotation recording the split origin.
+* The recipe id is a canonical
+* `ColumnOverriddenId(source: ColumnFilteredId(source: inner.id, axisFilters), specOverrides)`
+* — distinct per split combination, parseable by `extractPObjectId`, and
+* traversable by recipe walkers.
 *
-* Returns `{ items: [], complete: false }` when any snapshot's data
-* is not ready (status !== 'ready' or partition data unavailable).
+* Returns `undefined` when any input's `getData()` is not a
+* {@link TreeNodeAccessor} — partition inspection is not yet possible.
 */
-function expandByPartition(snapshots, splitAxes, opts) {
-	if (splitAxes.length === 0) return {
-		items: snapshots,
-		complete: true
-	};
+function expandByPartition(inputs, splitAxes, opts) {
+	if (splitAxes.length === 0) return [...inputs];
 	const splitAxisIdxs = splitAxes.map((a) => a.idx).sort((a, b) => a - b);
+	const maxSplitIdx = splitAxisIdxs[splitAxisIdxs.length - 1];
 	const result = [];
-	for (const snapshot of snapshots) {
-		if (snapshot.dataStatus !== "ready" || snapshot.data === void 0) return {
-			items: [],
-			complete: false
-		};
-		const dataEntries = require_pcolumn_data.convertOrParsePColumnData(snapshot.data.get());
-		if (dataEntries === void 0) return {
-			items: [],
-			complete: false
-		};
-		if (!(0, _milaboratories_pl_model_common.isPartitionedDataInfoEntries)(dataEntries)) throw new Error(`Splitting requires Partitioned DataInfoEntries, but got ${dataEntries.type} for column ${String(snapshot.id)}`);
-		const uniqueKeys = require_pcolumn_data.getUniquePartitionKeys(dataEntries);
-		const maxSplitIdx = splitAxisIdxs[splitAxisIdxs.length - 1];
-		if (maxSplitIdx >= dataEntries.partitionKeyLength) throw new Error(`Not enough partition keys (${dataEntries.partitionKeyLength}) for requested split axes (max index ${maxSplitIdx}) in column ${snapshot.spec.name}`);
-		const axesLabels = splitAxisIdxs.map((idx) => opts?.axisLabels?.((0, _milaboratories_pl_model_common.getAxisId)(snapshot.spec.axesSpec[idx])));
+	for (const inner of inputs) {
+		const data = require_utils.getLeafColumnData(inner);
+		if (!(data instanceof require_accessor.TreeNodeAccessor) && !(0, _milaboratories_pl_model_common.isDataInfoEntries)(data)) return;
+		const uniqueKeys = require_pcolumn_data.getUniquePartitionKeys(data);
+		if (uniqueKeys === void 0) return void 0;
+		if (maxSplitIdx >= uniqueKeys.length) throw new Error(`Not enough partition keys (${uniqueKeys.length}) for requested split axes (max index ${maxSplitIdx}) in column ${inner.getSpec().name}`);
+		const spec = inner.getSpec();
+		const axesSpec = spec.axesSpec;
+		const splitAxisSpecs = splitAxisIdxs.map((idx) => axesSpec[idx]);
+		const splitAxisIds = splitAxisSpecs.map((axisSpec) => (0, _milaboratories_pl_model_common.getAxisId)(axisSpec));
+		const axesLabels = splitAxisIds.map((axisId) => opts?.axisValuesLabels?.(axisId));
+		const existingTraceRaw = (0, _milaboratories_pl_model_common.readAnnotation)(spec, _milaboratories_pl_model_common.Annotation.Trace);
+		const baseTrace = existingTraceRaw ? JSON.parse(existingTraceRaw) ?? [] : [];
 		const keyCombinations = generateKeyCombinations(uniqueKeys, splitAxisIdxs);
 		if (keyCombinations.length === 0) continue;
-		const newAxesSpec = [...snapshot.spec.axesSpec];
-		for (let i = splitAxisIdxs.length - 1; i >= 0; i--) newAxesSpec.splice(splitAxisIdxs[i], 1);
 		for (const keyCombo of keyCombinations) {
 			const axisFilters = keyCombo.map((value, sAxisIdx) => [splitAxisIdxs[sAxisIdx], value]);
-			const traceEntries = keyCombo.map((value, sAxisIdx) => {
-				const axisIdx = splitAxisIdxs[sAxisIdx];
-				const axisId = (0, _milaboratories_pl_model_common.getAxisId)(snapshot.spec.axesSpec[axisIdx]);
+			const domain = {};
+			const traceEntries = [];
+			for (let sAxisIdx = 0; sAxisIdx < keyCombo.length; sAxisIdx++) {
+				const value = keyCombo[sAxisIdx];
+				const axisSpec = splitAxisSpecs[sAxisIdx];
+				const axisId = splitAxisIds[sAxisIdx];
 				const label = axesLabels[sAxisIdx]?.[value] ?? String(value);
-				return {
+				domain[axisSpec.name] = String(value);
+				traceEntries.push({
 					type: `split:${(0, _milaboratories_pl_model_common.canonicalizeAxisId)(axisId)}`,
 					label,
 					importance: 1e6
-				};
-			});
-			const filteredData = require_axis_filtering.filterDataInfoEntries(dataEntries, axisFilters);
-			const adjustedSpec = {
-				...snapshot.spec,
-				axesSpec: newAxesSpec,
-				annotations: {
-					...snapshot.spec.annotations,
-					"pl7.app/trace": JSON.stringify(traceEntries)
-				}
-			};
-			result.push({
-				id: snapshot.id,
-				spec: adjustedSpec,
-				dataStatus: "ready",
-				data: require_column_snapshot.createReadyColumnData(() => (0, _milaboratories_pl_model_common.entriesToDataInfo)(filteredData))
+				});
+			}
+			const filtered = require_column_filtered_recipe.ColumnFilteredRecipe.wrap(inner, axisFilters);
+			const overrided = require_column_overrided_recipe.ColumnOverriddenRecipe.wrap(filtered, {
+				domain,
+				annotations: { [_milaboratories_pl_model_common.Annotation.Trace]: JSON.stringify([...baseTrace, ...traceEntries]) }
 			});
+			result.push(overrided);
 		}
 	}
-	return {
-		items: result,
-		complete: true
-	};
+	return result;
 }
-const MAX_KEY_COMBINATIONS = 1e4;
 function generateKeyCombinations(uniqueKeys, splitAxisIdxs) {
 	const combinations = [];
 	function generate(currentCombo, sAxisIdx) {

package/dist/columns/expand_by_partition.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"expand_by_partition.cjs","names":["convertOrParsePColumnData","getUniquePartitionKeys","filterDataInfoEntries","createReadyColumnData"],"sources":["../../src/columns/expand_by_partition.ts"],"sourcesContent":["import type {\n  AxisFilterByIdx,\n  AxisFilterValue,\n  AxisId,\n  PartitionedDataInfoEntries,\n  PObjectId,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  canonicalizeAxisId,\n  entriesToDataInfo,\n  getAxisId,\n  isPartitionedDataInfoEntries,\n} from \"@milaboratories/pl-model-common\";\nimport type { TreeNodeAccessor } from \"../render/accessor\";\nimport { filterDataInfoEntries } from \"../render/util/axis_filtering\";\nimport { convertOrParsePColumnData, getUniquePartitionKeys } from \"../render/util/pcolumn_data\";\nimport type { ColumnSnapshot } from \"./column_snapshot\";\nimport { createReadyColumnData } from \"./column_snapshot\";\n\n// --- Types ---\n\nexport interface SplitAxis {\n  /** Index of the axis in the column's axesSpec to split by. */\n  readonly idx: number;\n}\n\nexport interface ExpandByPartitionOpts {\n  /** Resolve axis values to human-readable labels. */\n  axisLabels?: (axisId: AxisId) => undefined | Record<string | number, string>;\n}\n\nexport interface ExpandByPartitionResult {\n  /** Expanded snapshots (one per key combination per original snapshot). */\n  readonly items: ColumnSnapshot<PObjectId>[];\n  /** False if any column's data was not ready for splitting. */\n  readonly complete: boolean;\n}\n\n// --- Implementation ---\n\n/**\n * Expand snapshots by splitting along partition axes.\n *\n * For each snapshot, reads partition data, enumerates unique keys on the\n * split axes, and produces one output snapshot per key combination —\n * with the split axes removed from `axesSpec` and a `pl7.app/trace`\n * annotation recording the split origin.\n *\n * Returns `{ items: [], complete: false }` when any snapshot's data\n * is not ready (status !== 'ready' or partition data unavailable).\n */\nexport function expandByPartition(\n  snapshots: ColumnSnapshot<PObjectId>[],\n  splitAxes: SplitAxis[],\n  opts?: ExpandByPartitionOpts,\n): ExpandByPartitionResult {\n  if (splitAxes.length === 0) {\n    return { items: snapshots, complete: true };\n  }\n\n  const splitAxisIdxs = splitAxes.map((a) => a.idx).sort((a, b) => a - b);\n  const result: ColumnSnapshot<PObjectId>[] = [];\n\n  for (const snapshot of snapshots) {\n    if (snapshot.dataStatus !== \"ready\" || snapshot.data === undefined) {\n      return { items: [], complete: false };\n    }\n\n    const rawData = snapshot.data.get();\n    const dataEntries = convertOrParsePColumnData(rawData as TreeNodeAccessor | undefined);\n\n    if (dataEntries === undefined) {\n      return { items: [], complete: false };\n    }\n\n    if (!isPartitionedDataInfoEntries(dataEntries)) {\n      throw new Error(\n        `Splitting requires Partitioned DataInfoEntries, but got ${dataEntries.type} for column ${String(snapshot.id)}`,\n      );\n    }\n\n    const uniqueKeys = getUniquePartitionKeys(dataEntries);\n\n    const maxSplitIdx = splitAxisIdxs[splitAxisIdxs.length - 1];\n    if (maxSplitIdx >= dataEntries.partitionKeyLength) {\n      throw new Error(\n        `Not enough partition keys (${dataEntries.partitionKeyLength}) for requested split axes (max index ${maxSplitIdx}) in column ${snapshot.spec.name}`,\n      );\n    }\n\n    // Resolve labels for each split axis\n    const axesLabels: (undefined | Record<string | number, string>)[] = splitAxisIdxs.map((idx) =>\n      opts?.axisLabels?.(getAxisId(snapshot.spec.axesSpec[idx])),\n    );\n\n    // Generate all key combinations across split axes\n    const keyCombinations = generateKeyCombinations(uniqueKeys, splitAxisIdxs);\n    if (keyCombinations.length === 0) continue;\n\n    // Build adjusted axesSpec (remove split axes in reverse order)\n    const newAxesSpec = [...snapshot.spec.axesSpec];\n    for (let i = splitAxisIdxs.length - 1; i >= 0; i--) {\n      newAxesSpec.splice(splitAxisIdxs[i], 1);\n    }\n\n    for (const keyCombo of keyCombinations) {\n      const axisFilters: AxisFilterByIdx[] = keyCombo.map(\n        (value, sAxisIdx): AxisFilterByIdx => [splitAxisIdxs[sAxisIdx], value as AxisFilterValue],\n      );\n\n      const traceEntries = keyCombo.map((value, sAxisIdx) => {\n        const axisIdx = splitAxisIdxs[sAxisIdx];\n        const axisId = getAxisId(snapshot.spec.axesSpec[axisIdx]);\n        const labelMap = axesLabels[sAxisIdx];\n        const label = labelMap?.[value] ?? String(value);\n        return {\n          type: `split:${canonicalizeAxisId(axisId)}`,\n          label,\n          importance: 1_000_000,\n        };\n      });\n\n      const filteredData = filterDataInfoEntries(\n        dataEntries as PartitionedDataInfoEntries<TreeNodeAccessor>,\n        axisFilters,\n      );\n\n      const adjustedSpec = {\n        ...snapshot.spec,\n        axesSpec: newAxesSpec,\n        annotations: {\n          ...snapshot.spec.annotations,\n          \"pl7.app/trace\": JSON.stringify(traceEntries),\n        },\n      };\n\n      result.push({\n        id: snapshot.id,\n        spec: adjustedSpec,\n        dataStatus: \"ready\",\n        data: createReadyColumnData(() => entriesToDataInfo(filteredData)),\n      });\n    }\n  }\n\n  return { items: result, complete: true };\n}\n\nconst MAX_KEY_COMBINATIONS = 10_000;\n\nfunction generateKeyCombinations(\n  uniqueKeys: (string | number)[][],\n  splitAxisIdxs: number[],\n): (string | number)[][] {\n  const combinations: (string | number)[][] = [];\n\n  function generate(currentCombo: (string | number)[], sAxisIdx: number): void {\n    if (sAxisIdx >= splitAxisIdxs.length) {\n      combinations.push([...currentCombo]);\n      if (combinations.length > MAX_KEY_COMBINATIONS) {\n        throw new Error(\"Too many key combinations, aborting.\");\n      }\n      return;\n    }\n\n    const axisIdx = splitAxisIdxs[sAxisIdx];\n    if (axisIdx >= uniqueKeys.length) {\n      throw new Error(\n        `Axis index ${axisIdx} out of bounds for unique keys array (length ${uniqueKeys.length})`,\n      );\n    }\n\n    const axisValues = uniqueKeys[axisIdx];\n    if (!axisValues || axisValues.length === 0) {\n      combinations.length = 0;\n      return;\n    }\n\n    for (const val of axisValues) {\n      currentCombo.push(val);\n      generate(currentCombo, sAxisIdx + 1);\n      currentCombo.pop();\n    }\n  }\n\n  generate([], 0);\n  return combinations;\n}\n"],"mappings":"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"}
+{"version":3,"file":"expand_by_partition.cjs","names":["getLeafColumnData","TreeNodeAccessor","getUniquePartitionKeys","Annotation","ColumnFilteredRecipe","ColumnOverriddenRecipe"],"sources":["../../src/columns/expand_by_partition.ts"],"sourcesContent":["import type {\n  AxisFilterByIdx,\n  AxisFilterValue,\n  AxisId,\n  TraceEntry,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  Annotation,\n  canonicalizeAxisId,\n  getAxisId,\n  isDataInfoEntries,\n  readAnnotation,\n} from \"@milaboratories/pl-model-common\";\nimport { TreeNodeAccessor } from \"../render/accessor\";\nimport { getUniquePartitionKeys } from \"../render/util/pcolumn_data\";\nimport type { ColumnRecipe } from \"./column_recipes\";\nimport { ColumnFilteredRecipe } from \"./column_recipes/column_filtered_recipe\";\nimport { ColumnOverriddenRecipe } from \"./column_recipes/column_overrided_recipe\";\nimport { Column } from \"./column\";\nimport { getLeafColumnData } from \"./utils\";\n\n// --- Types ---\n\nexport interface SplitAxis {\n  /** Index of the axis in the column's axesSpec to split by. */\n  readonly idx: number;\n}\n\nexport interface ExpandByPartitionOpts {\n  /** Resolve axis values to human-readable labels. */\n  axisValuesLabels?: (axisId: AxisId) => undefined | Record<string | number, string>;\n}\n\n// --- Implementation ---\n\nconst MAX_KEY_COMBINATIONS = 10_000;\n\n/**\n * Expand each input column along the requested partition axes into one\n * {@link ColumnRecipe} per Cartesian combination of unique partition values.\n *\n * Each split is produced as `ColumnOverriddenRecipe.wrap(ColumnFilteredRecipe.wrap(inner, axisFilters), { domain, annotations })`:\n *   - `ColumnFilteredRecipe` pins all split axes at once (one wrap call with\n *     every `[idx, value]` pair) and removes them from `axesSpec`. The\n *     engine performs the data slicing via the `sliceAxes` query node.\n *   - `ColumnOverriddenRecipe` overlays a `domain[axisName] = String(value)`\n *     entry per split axis and appends a `split:<canonicalAxisId>` trace\n *     entry per split axis to the existing `pl7.app/trace` annotation.\n *\n * The recipe id is a canonical\n * `ColumnOverriddenId(source: ColumnFilteredId(source: inner.id, axisFilters), specOverrides)`\n * — distinct per split combination, parseable by `extractPObjectId`, and\n * traversable by recipe walkers.\n *\n * Returns `undefined` when any input's `getData()` is not a\n * {@link TreeNodeAccessor} — partition inspection is not yet possible.\n */\nexport function expandByPartition(\n  inputs: Column[],\n  splitAxes: SplitAxis[],\n  opts?: ExpandByPartitionOpts,\n): ColumnRecipe[] | undefined {\n  if (splitAxes.length === 0) {\n    return [...inputs];\n  }\n\n  const splitAxisIdxs = splitAxes.map((a) => a.idx).sort((a, b) => a - b);\n  const maxSplitIdx = splitAxisIdxs[splitAxisIdxs.length - 1];\n\n  const result: ColumnRecipe[] = [];\n\n  for (const inner of inputs) {\n    const data = getLeafColumnData(inner);\n    // Partition inspection requires either a live tree-accessor or already\n    // parsed DataInfoEntries. Anything else means the input is not yet ready.\n    if (!(data instanceof TreeNodeAccessor) && !isDataInfoEntries(data)) {\n      return undefined;\n    }\n\n    const uniqueKeys = getUniquePartitionKeys(data);\n    if (uniqueKeys === undefined) return undefined;\n\n    if (maxSplitIdx >= uniqueKeys.length) {\n      throw new Error(\n        `Not enough partition keys (${uniqueKeys.length}) for requested split axes (max index ${maxSplitIdx}) in column ${inner.getSpec().name}`,\n      );\n    }\n\n    const spec = inner.getSpec();\n    const axesSpec = spec.axesSpec;\n    const splitAxisSpecs = splitAxisIdxs.map((idx) => axesSpec[idx]);\n    const splitAxisIds = splitAxisSpecs.map((axisSpec) => getAxisId(axisSpec));\n    const axesLabels = splitAxisIds.map((axisId) => opts?.axisValuesLabels?.(axisId));\n\n    const existingTraceRaw = readAnnotation(spec, Annotation.Trace);\n    const baseTrace: TraceEntry[] = existingTraceRaw\n      ? ((JSON.parse(existingTraceRaw) as TraceEntry[]) ?? [])\n      : [];\n\n    const keyCombinations = generateKeyCombinations(uniqueKeys, splitAxisIdxs);\n    if (keyCombinations.length === 0) continue;\n\n    for (const keyCombo of keyCombinations) {\n      const axisFilters: AxisFilterByIdx[] = keyCombo.map(\n        (value, sAxisIdx): AxisFilterByIdx => [splitAxisIdxs[sAxisIdx], value as AxisFilterValue],\n      );\n\n      const domain: Record<string, string> = {};\n      const traceEntries: TraceEntry[] = [];\n      for (let sAxisIdx = 0; sAxisIdx < keyCombo.length; sAxisIdx++) {\n        const value = keyCombo[sAxisIdx];\n        const axisSpec = splitAxisSpecs[sAxisIdx];\n        const axisId = splitAxisIds[sAxisIdx];\n        const labelMap = axesLabels[sAxisIdx];\n        const label = labelMap?.[value] ?? String(value);\n        domain[axisSpec.name] = String(value);\n        traceEntries.push({\n          type: `split:${canonicalizeAxisId(axisId)}`,\n          label,\n          importance: 1_000_000,\n        });\n      }\n\n      const filtered = ColumnFilteredRecipe.wrap(inner, axisFilters);\n      const overrided = ColumnOverriddenRecipe.wrap(filtered, {\n        domain,\n        annotations: {\n          [Annotation.Trace]: JSON.stringify([...baseTrace, ...traceEntries]),\n        },\n      });\n\n      result.push(overrided);\n    }\n  }\n\n  return result;\n}\n\nfunction generateKeyCombinations(\n  uniqueKeys: (string | number)[][],\n  splitAxisIdxs: number[],\n): (string | number)[][] {\n  const combinations: (string | number)[][] = [];\n\n  function generate(currentCombo: (string | number)[], sAxisIdx: number): void {\n    if (sAxisIdx >= splitAxisIdxs.length) {\n      combinations.push([...currentCombo]);\n      if (combinations.length > MAX_KEY_COMBINATIONS) {\n        throw new Error(\"Too many key combinations, aborting.\");\n      }\n      return;\n    }\n\n    const axisIdx = splitAxisIdxs[sAxisIdx];\n    if (axisIdx >= uniqueKeys.length) {\n      throw new Error(\n        `Axis index ${axisIdx} out of bounds for unique keys array (length ${uniqueKeys.length})`,\n      );\n    }\n\n    const axisValues = uniqueKeys[axisIdx];\n    if (!axisValues || axisValues.length === 0) {\n      combinations.length = 0;\n      return;\n    }\n\n    for (const val of axisValues) {\n      currentCombo.push(val);\n      generate(currentCombo, sAxisIdx + 1);\n      currentCombo.pop();\n    }\n  }\n\n  generate([], 0);\n  return combinations;\n}\n"],"mappings":"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"}

package/dist/columns/expand_by_partition.d.ts

@@ -1,5 +1,6 @@
-import { ColumnSnapshot } from "./column_snapshot.js";
-import { AxisId, PObjectId } from "@milaboratories/pl-model-common";
+import { Column } from "./column.js";
+import { ColumnRecipe } from "./column_recipes/index.js";
+import { AxisId } from "@milaboratories/pl-model-common";
 
 //#region src/columns/expand_by_partition.d.ts
 interface SplitAxis {
@@ -8,26 +9,29 @@ interface SplitAxis {
 }
 interface ExpandByPartitionOpts {
   /** Resolve axis values to human-readable labels. */
-  axisLabels?: (axisId: AxisId) => undefined | Record<string | number, string>;
-}
-interface ExpandByPartitionResult {
-  /** Expanded snapshots (one per key combination per original snapshot). */
-  readonly items: ColumnSnapshot<PObjectId>[];
-  /** False if any column's data was not ready for splitting. */
-  readonly complete: boolean;
+  axisValuesLabels?: (axisId: AxisId) => undefined | Record<string | number, string>;
 }
 /**
- * Expand snapshots by splitting along partition axes.
+ * Expand each input column along the requested partition axes into one
+ * {@link ColumnRecipe} per Cartesian combination of unique partition values.
+ *
+ * Each split is produced as `ColumnOverriddenRecipe.wrap(ColumnFilteredRecipe.wrap(inner, axisFilters), { domain, annotations })`:
+ *   - `ColumnFilteredRecipe` pins all split axes at once (one wrap call with
+ *     every `[idx, value]` pair) and removes them from `axesSpec`. The
+ *     engine performs the data slicing via the `sliceAxes` query node.
+ *   - `ColumnOverriddenRecipe` overlays a `domain[axisName] = String(value)`
+ *     entry per split axis and appends a `split:<canonicalAxisId>` trace
+ *     entry per split axis to the existing `pl7.app/trace` annotation.
  *
- * For each snapshot, reads partition data, enumerates unique keys on the
- * split axes, and produces one output snapshot per key combination —
- * with the split axes removed from `axesSpec` and a `pl7.app/trace`
- * annotation recording the split origin.
+ * The recipe id is a canonical
+ * `ColumnOverriddenId(source: ColumnFilteredId(source: inner.id, axisFilters), specOverrides)`
+ * — distinct per split combination, parseable by `extractPObjectId`, and
+ * traversable by recipe walkers.
  *
- * Returns `{ items: [], complete: false }` when any snapshot's data
- * is not ready (status !== 'ready' or partition data unavailable).
+ * Returns `undefined` when any input's `getData()` is not a
+ * {@link TreeNodeAccessor} — partition inspection is not yet possible.
  */
-declare function expandByPartition(snapshots: ColumnSnapshot<PObjectId>[], splitAxes: SplitAxis[], opts?: ExpandByPartitionOpts): ExpandByPartitionResult;
+declare function expandByPartition(inputs: Column[], splitAxes: SplitAxis[], opts?: ExpandByPartitionOpts): ColumnRecipe[] | undefined;
 //#endregion
-export { ExpandByPartitionOpts, ExpandByPartitionResult, SplitAxis, expandByPartition };
+export { ExpandByPartitionOpts, SplitAxis, expandByPartition };
 //# sourceMappingURL=expand_by_partition.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"expand_by_partition.d.ts","names":[],"sources":["../../src/columns/expand_by_partition.ts"],"mappings":";;;;UAqBiB,SAAA;;WAEN,GAAG;AAAA;AAAA,UAGG,qBAAA;EAHH;EAKZ,UAAA,IAAc,MAAA,EAAQ,MAAA,iBAAuB,MAAM;AAAA;AAAA,UAGpC,uBAAA;;WAEN,KAAA,EAAO,cAAc,CAAC,SAAA;EAL/B;EAAA,SAOS,QAAA;AAAA;;;AAP0C;AAGrD;;;;;;;;iBAoBgB,iBAAA,CACd,SAAA,EAAW,cAAA,CAAe,SAAA,KAC1B,SAAA,EAAW,SAAA,IACX,IAAA,GAAO,qBAAA,GACN,uBAAA"}
+{"version":3,"file":"expand_by_partition.d.ts","names":[],"sources":["../../src/columns/expand_by_partition.ts"],"mappings":";;;;;UAuBiB,SAAA;;WAEN,GAAG;AAAA;AAAA,UAGG,qBAAA;EAHH;EAKZ,gBAAA,IAAoB,MAAA,EAAQ,MAAA,iBAAuB,MAAM;AAAA;;;;;;;;;AAAA;AA2B3D;;;;;;;;;;;iBAAgB,iBAAA,CACd,MAAA,EAAQ,MAAA,IACR,SAAA,EAAW,SAAA,IACX,IAAA,GAAO,qBAAA,GACN,YAAA"}

package/dist/columns/expand_by_partition.js

@@ -1,80 +1,77 @@
-import { filterDataInfoEntries } from "../render/util/axis_filtering.js";
-import { convertOrParsePColumnData, getUniquePartitionKeys } from "../render/util/pcolumn_data.js";
-import { createReadyColumnData } from "./column_snapshot.js";
-import { canonicalizeAxisId, entriesToDataInfo, getAxisId, isPartitionedDataInfoEntries } from "@milaboratories/pl-model-common";
+import { TreeNodeAccessor } from "../render/accessor.js";
+import { getUniquePartitionKeys } from "../render/util/pcolumn_data.js";
+import { ColumnFilteredRecipe } from "./column_recipes/column_filtered_recipe.js";
+import { ColumnOverriddenRecipe } from "./column_recipes/column_overrided_recipe.js";
+import { getLeafColumnData } from "./utils.js";
+import { Annotation, canonicalizeAxisId, getAxisId, isDataInfoEntries, readAnnotation } from "@milaboratories/pl-model-common";
 //#region src/columns/expand_by_partition.ts
+const MAX_KEY_COMBINATIONS = 1e4;
 /**
-* Expand snapshots by splitting along partition axes.
+* Expand each input column along the requested partition axes into one
+* {@link ColumnRecipe} per Cartesian combination of unique partition values.
+*
+* Each split is produced as `ColumnOverriddenRecipe.wrap(ColumnFilteredRecipe.wrap(inner, axisFilters), { domain, annotations })`:
+*   - `ColumnFilteredRecipe` pins all split axes at once (one wrap call with
+*     every `[idx, value]` pair) and removes them from `axesSpec`. The
+*     engine performs the data slicing via the `sliceAxes` query node.
+*   - `ColumnOverriddenRecipe` overlays a `domain[axisName] = String(value)`
+*     entry per split axis and appends a `split:<canonicalAxisId>` trace
+*     entry per split axis to the existing `pl7.app/trace` annotation.
 *
-* For each snapshot, reads partition data, enumerates unique keys on the
-* split axes, and produces one output snapshot per key combination —
-* with the split axes removed from `axesSpec` and a `pl7.app/trace`
-* annotation recording the split origin.
+* The recipe id is a canonical
+* `ColumnOverriddenId(source: ColumnFilteredId(source: inner.id, axisFilters), specOverrides)`
+* — distinct per split combination, parseable by `extractPObjectId`, and
+* traversable by recipe walkers.
 *
-* Returns `{ items: [], complete: false }` when any snapshot's data
-* is not ready (status !== 'ready' or partition data unavailable).
+* Returns `undefined` when any input's `getData()` is not a
+* {@link TreeNodeAccessor} — partition inspection is not yet possible.
 */
-function expandByPartition(snapshots, splitAxes, opts) {
-	if (splitAxes.length === 0) return {
-		items: snapshots,
-		complete: true
-	};
+function expandByPartition(inputs, splitAxes, opts) {
+	if (splitAxes.length === 0) return [...inputs];
 	const splitAxisIdxs = splitAxes.map((a) => a.idx).sort((a, b) => a - b);
+	const maxSplitIdx = splitAxisIdxs[splitAxisIdxs.length - 1];
 	const result = [];
-	for (const snapshot of snapshots) {
-		if (snapshot.dataStatus !== "ready" || snapshot.data === void 0) return {
-			items: [],
-			complete: false
-		};
-		const dataEntries = convertOrParsePColumnData(snapshot.data.get());
-		if (dataEntries === void 0) return {
-			items: [],
-			complete: false
-		};
-		if (!isPartitionedDataInfoEntries(dataEntries)) throw new Error(`Splitting requires Partitioned DataInfoEntries, but got ${dataEntries.type} for column ${String(snapshot.id)}`);
-		const uniqueKeys = getUniquePartitionKeys(dataEntries);
-		const maxSplitIdx = splitAxisIdxs[splitAxisIdxs.length - 1];
-		if (maxSplitIdx >= dataEntries.partitionKeyLength) throw new Error(`Not enough partition keys (${dataEntries.partitionKeyLength}) for requested split axes (max index ${maxSplitIdx}) in column ${snapshot.spec.name}`);
-		const axesLabels = splitAxisIdxs.map((idx) => opts?.axisLabels?.(getAxisId(snapshot.spec.axesSpec[idx])));
+	for (const inner of inputs) {
+		const data = getLeafColumnData(inner);
+		if (!(data instanceof TreeNodeAccessor) && !isDataInfoEntries(data)) return;
+		const uniqueKeys = getUniquePartitionKeys(data);
+		if (uniqueKeys === void 0) return void 0;
+		if (maxSplitIdx >= uniqueKeys.length) throw new Error(`Not enough partition keys (${uniqueKeys.length}) for requested split axes (max index ${maxSplitIdx}) in column ${inner.getSpec().name}`);
+		const spec = inner.getSpec();
+		const axesSpec = spec.axesSpec;
+		const splitAxisSpecs = splitAxisIdxs.map((idx) => axesSpec[idx]);
+		const splitAxisIds = splitAxisSpecs.map((axisSpec) => getAxisId(axisSpec));
+		const axesLabels = splitAxisIds.map((axisId) => opts?.axisValuesLabels?.(axisId));
+		const existingTraceRaw = readAnnotation(spec, Annotation.Trace);
+		const baseTrace = existingTraceRaw ? JSON.parse(existingTraceRaw) ?? [] : [];
 		const keyCombinations = generateKeyCombinations(uniqueKeys, splitAxisIdxs);
 		if (keyCombinations.length === 0) continue;
-		const newAxesSpec = [...snapshot.spec.axesSpec];
-		for (let i = splitAxisIdxs.length - 1; i >= 0; i--) newAxesSpec.splice(splitAxisIdxs[i], 1);
 		for (const keyCombo of keyCombinations) {
 			const axisFilters = keyCombo.map((value, sAxisIdx) => [splitAxisIdxs[sAxisIdx], value]);
-			const traceEntries = keyCombo.map((value, sAxisIdx) => {
-				const axisIdx = splitAxisIdxs[sAxisIdx];
-				const axisId = getAxisId(snapshot.spec.axesSpec[axisIdx]);
+			const domain = {};
+			const traceEntries = [];
+			for (let sAxisIdx = 0; sAxisIdx < keyCombo.length; sAxisIdx++) {
+				const value = keyCombo[sAxisIdx];
+				const axisSpec = splitAxisSpecs[sAxisIdx];
+				const axisId = splitAxisIds[sAxisIdx];
 				const label = axesLabels[sAxisIdx]?.[value] ?? String(value);
-				return {
+				domain[axisSpec.name] = String(value);
+				traceEntries.push({
 					type: `split:${canonicalizeAxisId(axisId)}`,
 					label,
 					importance: 1e6
-				};
-			});
-			const filteredData = filterDataInfoEntries(dataEntries, axisFilters);
-			const adjustedSpec = {
-				...snapshot.spec,
-				axesSpec: newAxesSpec,
-				annotations: {
-					...snapshot.spec.annotations,
-					"pl7.app/trace": JSON.stringify(traceEntries)
-				}
-			};
-			result.push({
-				id: snapshot.id,
-				spec: adjustedSpec,
-				dataStatus: "ready",
-				data: createReadyColumnData(() => entriesToDataInfo(filteredData))
+				});
+			}
+			const filtered = ColumnFilteredRecipe.wrap(inner, axisFilters);
+			const overrided = ColumnOverriddenRecipe.wrap(filtered, {
+				domain,
+				annotations: { [Annotation.Trace]: JSON.stringify([...baseTrace, ...traceEntries]) }
 			});
+			result.push(overrided);
 		}
 	}
-	return {
-		items: result,
-		complete: true
-	};
+	return result;
 }
-const MAX_KEY_COMBINATIONS = 1e4;
 function generateKeyCombinations(uniqueKeys, splitAxisIdxs) {
 	const combinations = [];
 	function generate(currentCombo, sAxisIdx) {

package/dist/columns/expand_by_partition.js.map

@@ -1 +1 @@
-{"version":3,"file":"expand_by_partition.js","names":[],"sources":["../../src/columns/expand_by_partition.ts"],"sourcesContent":["import type {\n  AxisFilterByIdx,\n  AxisFilterValue,\n  AxisId,\n  PartitionedDataInfoEntries,\n  PObjectId,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  canonicalizeAxisId,\n  entriesToDataInfo,\n  getAxisId,\n  isPartitionedDataInfoEntries,\n} from \"@milaboratories/pl-model-common\";\nimport type { TreeNodeAccessor } from \"../render/accessor\";\nimport { filterDataInfoEntries } from \"../render/util/axis_filtering\";\nimport { convertOrParsePColumnData, getUniquePartitionKeys } from \"../render/util/pcolumn_data\";\nimport type { ColumnSnapshot } from \"./column_snapshot\";\nimport { createReadyColumnData } from \"./column_snapshot\";\n\n// --- Types ---\n\nexport interface SplitAxis {\n  /** Index of the axis in the column's axesSpec to split by. */\n  readonly idx: number;\n}\n\nexport interface ExpandByPartitionOpts {\n  /** Resolve axis values to human-readable labels. */\n  axisLabels?: (axisId: AxisId) => undefined | Record<string | number, string>;\n}\n\nexport interface ExpandByPartitionResult {\n  /** Expanded snapshots (one per key combination per original snapshot). */\n  readonly items: ColumnSnapshot<PObjectId>[];\n  /** False if any column's data was not ready for splitting. */\n  readonly complete: boolean;\n}\n\n// --- Implementation ---\n\n/**\n * Expand snapshots by splitting along partition axes.\n *\n * For each snapshot, reads partition data, enumerates unique keys on the\n * split axes, and produces one output snapshot per key combination —\n * with the split axes removed from `axesSpec` and a `pl7.app/trace`\n * annotation recording the split origin.\n *\n * Returns `{ items: [], complete: false }` when any snapshot's data\n * is not ready (status !== 'ready' or partition data unavailable).\n */\nexport function expandByPartition(\n  snapshots: ColumnSnapshot<PObjectId>[],\n  splitAxes: SplitAxis[],\n  opts?: ExpandByPartitionOpts,\n): ExpandByPartitionResult {\n  if (splitAxes.length === 0) {\n    return { items: snapshots, complete: true };\n  }\n\n  const splitAxisIdxs = splitAxes.map((a) => a.idx).sort((a, b) => a - b);\n  const result: ColumnSnapshot<PObjectId>[] = [];\n\n  for (const snapshot of snapshots) {\n    if (snapshot.dataStatus !== \"ready\" || snapshot.data === undefined) {\n      return { items: [], complete: false };\n    }\n\n    const rawData = snapshot.data.get();\n    const dataEntries = convertOrParsePColumnData(rawData as TreeNodeAccessor | undefined);\n\n    if (dataEntries === undefined) {\n      return { items: [], complete: false };\n    }\n\n    if (!isPartitionedDataInfoEntries(dataEntries)) {\n      throw new Error(\n        `Splitting requires Partitioned DataInfoEntries, but got ${dataEntries.type} for column ${String(snapshot.id)}`,\n      );\n    }\n\n    const uniqueKeys = getUniquePartitionKeys(dataEntries);\n\n    const maxSplitIdx = splitAxisIdxs[splitAxisIdxs.length - 1];\n    if (maxSplitIdx >= dataEntries.partitionKeyLength) {\n      throw new Error(\n        `Not enough partition keys (${dataEntries.partitionKeyLength}) for requested split axes (max index ${maxSplitIdx}) in column ${snapshot.spec.name}`,\n      );\n    }\n\n    // Resolve labels for each split axis\n    const axesLabels: (undefined | Record<string | number, string>)[] = splitAxisIdxs.map((idx) =>\n      opts?.axisLabels?.(getAxisId(snapshot.spec.axesSpec[idx])),\n    );\n\n    // Generate all key combinations across split axes\n    const keyCombinations = generateKeyCombinations(uniqueKeys, splitAxisIdxs);\n    if (keyCombinations.length === 0) continue;\n\n    // Build adjusted axesSpec (remove split axes in reverse order)\n    const newAxesSpec = [...snapshot.spec.axesSpec];\n    for (let i = splitAxisIdxs.length - 1; i >= 0; i--) {\n      newAxesSpec.splice(splitAxisIdxs[i], 1);\n    }\n\n    for (const keyCombo of keyCombinations) {\n      const axisFilters: AxisFilterByIdx[] = keyCombo.map(\n        (value, sAxisIdx): AxisFilterByIdx => [splitAxisIdxs[sAxisIdx], value as AxisFilterValue],\n      );\n\n      const traceEntries = keyCombo.map((value, sAxisIdx) => {\n        const axisIdx = splitAxisIdxs[sAxisIdx];\n        const axisId = getAxisId(snapshot.spec.axesSpec[axisIdx]);\n        const labelMap = axesLabels[sAxisIdx];\n        const label = labelMap?.[value] ?? String(value);\n        return {\n          type: `split:${canonicalizeAxisId(axisId)}`,\n          label,\n          importance: 1_000_000,\n        };\n      });\n\n      const filteredData = filterDataInfoEntries(\n        dataEntries as PartitionedDataInfoEntries<TreeNodeAccessor>,\n        axisFilters,\n      );\n\n      const adjustedSpec = {\n        ...snapshot.spec,\n        axesSpec: newAxesSpec,\n        annotations: {\n          ...snapshot.spec.annotations,\n          \"pl7.app/trace\": JSON.stringify(traceEntries),\n        },\n      };\n\n      result.push({\n        id: snapshot.id,\n        spec: adjustedSpec,\n        dataStatus: \"ready\",\n        data: createReadyColumnData(() => entriesToDataInfo(filteredData)),\n      });\n    }\n  }\n\n  return { items: result, complete: true };\n}\n\nconst MAX_KEY_COMBINATIONS = 10_000;\n\nfunction generateKeyCombinations(\n  uniqueKeys: (string | number)[][],\n  splitAxisIdxs: number[],\n): (string | number)[][] {\n  const combinations: (string | number)[][] = [];\n\n  function generate(currentCombo: (string | number)[], sAxisIdx: number): void {\n    if (sAxisIdx >= splitAxisIdxs.length) {\n      combinations.push([...currentCombo]);\n      if (combinations.length > MAX_KEY_COMBINATIONS) {\n        throw new Error(\"Too many key combinations, aborting.\");\n      }\n      return;\n    }\n\n    const axisIdx = splitAxisIdxs[sAxisIdx];\n    if (axisIdx >= uniqueKeys.length) {\n      throw new Error(\n        `Axis index ${axisIdx} out of bounds for unique keys array (length ${uniqueKeys.length})`,\n      );\n    }\n\n    const axisValues = uniqueKeys[axisIdx];\n    if (!axisValues || axisValues.length === 0) {\n      combinations.length = 0;\n      return;\n    }\n\n    for (const val of axisValues) {\n      currentCombo.push(val);\n      generate(currentCombo, sAxisIdx + 1);\n      currentCombo.pop();\n    }\n  }\n\n  generate([], 0);\n  return combinations;\n}\n"],"mappings":"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"}
+{"version":3,"file":"expand_by_partition.js","names":[],"sources":["../../src/columns/expand_by_partition.ts"],"sourcesContent":["import type {\n  AxisFilterByIdx,\n  AxisFilterValue,\n  AxisId,\n  TraceEntry,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  Annotation,\n  canonicalizeAxisId,\n  getAxisId,\n  isDataInfoEntries,\n  readAnnotation,\n} from \"@milaboratories/pl-model-common\";\nimport { TreeNodeAccessor } from \"../render/accessor\";\nimport { getUniquePartitionKeys } from \"../render/util/pcolumn_data\";\nimport type { ColumnRecipe } from \"./column_recipes\";\nimport { ColumnFilteredRecipe } from \"./column_recipes/column_filtered_recipe\";\nimport { ColumnOverriddenRecipe } from \"./column_recipes/column_overrided_recipe\";\nimport { Column } from \"./column\";\nimport { getLeafColumnData } from \"./utils\";\n\n// --- Types ---\n\nexport interface SplitAxis {\n  /** Index of the axis in the column's axesSpec to split by. */\n  readonly idx: number;\n}\n\nexport interface ExpandByPartitionOpts {\n  /** Resolve axis values to human-readable labels. */\n  axisValuesLabels?: (axisId: AxisId) => undefined | Record<string | number, string>;\n}\n\n// --- Implementation ---\n\nconst MAX_KEY_COMBINATIONS = 10_000;\n\n/**\n * Expand each input column along the requested partition axes into one\n * {@link ColumnRecipe} per Cartesian combination of unique partition values.\n *\n * Each split is produced as `ColumnOverriddenRecipe.wrap(ColumnFilteredRecipe.wrap(inner, axisFilters), { domain, annotations })`:\n *   - `ColumnFilteredRecipe` pins all split axes at once (one wrap call with\n *     every `[idx, value]` pair) and removes them from `axesSpec`. The\n *     engine performs the data slicing via the `sliceAxes` query node.\n *   - `ColumnOverriddenRecipe` overlays a `domain[axisName] = String(value)`\n *     entry per split axis and appends a `split:<canonicalAxisId>` trace\n *     entry per split axis to the existing `pl7.app/trace` annotation.\n *\n * The recipe id is a canonical\n * `ColumnOverriddenId(source: ColumnFilteredId(source: inner.id, axisFilters), specOverrides)`\n * — distinct per split combination, parseable by `extractPObjectId`, and\n * traversable by recipe walkers.\n *\n * Returns `undefined` when any input's `getData()` is not a\n * {@link TreeNodeAccessor} — partition inspection is not yet possible.\n */\nexport function expandByPartition(\n  inputs: Column[],\n  splitAxes: SplitAxis[],\n  opts?: ExpandByPartitionOpts,\n): ColumnRecipe[] | undefined {\n  if (splitAxes.length === 0) {\n    return [...inputs];\n  }\n\n  const splitAxisIdxs = splitAxes.map((a) => a.idx).sort((a, b) => a - b);\n  const maxSplitIdx = splitAxisIdxs[splitAxisIdxs.length - 1];\n\n  const result: ColumnRecipe[] = [];\n\n  for (const inner of inputs) {\n    const data = getLeafColumnData(inner);\n    // Partition inspection requires either a live tree-accessor or already\n    // parsed DataInfoEntries. Anything else means the input is not yet ready.\n    if (!(data instanceof TreeNodeAccessor) && !isDataInfoEntries(data)) {\n      return undefined;\n    }\n\n    const uniqueKeys = getUniquePartitionKeys(data);\n    if (uniqueKeys === undefined) return undefined;\n\n    if (maxSplitIdx >= uniqueKeys.length) {\n      throw new Error(\n        `Not enough partition keys (${uniqueKeys.length}) for requested split axes (max index ${maxSplitIdx}) in column ${inner.getSpec().name}`,\n      );\n    }\n\n    const spec = inner.getSpec();\n    const axesSpec = spec.axesSpec;\n    const splitAxisSpecs = splitAxisIdxs.map((idx) => axesSpec[idx]);\n    const splitAxisIds = splitAxisSpecs.map((axisSpec) => getAxisId(axisSpec));\n    const axesLabels = splitAxisIds.map((axisId) => opts?.axisValuesLabels?.(axisId));\n\n    const existingTraceRaw = readAnnotation(spec, Annotation.Trace);\n    const baseTrace: TraceEntry[] = existingTraceRaw\n      ? ((JSON.parse(existingTraceRaw) as TraceEntry[]) ?? [])\n      : [];\n\n    const keyCombinations = generateKeyCombinations(uniqueKeys, splitAxisIdxs);\n    if (keyCombinations.length === 0) continue;\n\n    for (const keyCombo of keyCombinations) {\n      const axisFilters: AxisFilterByIdx[] = keyCombo.map(\n        (value, sAxisIdx): AxisFilterByIdx => [splitAxisIdxs[sAxisIdx], value as AxisFilterValue],\n      );\n\n      const domain: Record<string, string> = {};\n      const traceEntries: TraceEntry[] = [];\n      for (let sAxisIdx = 0; sAxisIdx < keyCombo.length; sAxisIdx++) {\n        const value = keyCombo[sAxisIdx];\n        const axisSpec = splitAxisSpecs[sAxisIdx];\n        const axisId = splitAxisIds[sAxisIdx];\n        const labelMap = axesLabels[sAxisIdx];\n        const label = labelMap?.[value] ?? String(value);\n        domain[axisSpec.name] = String(value);\n        traceEntries.push({\n          type: `split:${canonicalizeAxisId(axisId)}`,\n          label,\n          importance: 1_000_000,\n        });\n      }\n\n      const filtered = ColumnFilteredRecipe.wrap(inner, axisFilters);\n      const overrided = ColumnOverriddenRecipe.wrap(filtered, {\n        domain,\n        annotations: {\n          [Annotation.Trace]: JSON.stringify([...baseTrace, ...traceEntries]),\n        },\n      });\n\n      result.push(overrided);\n    }\n  }\n\n  return result;\n}\n\nfunction generateKeyCombinations(\n  uniqueKeys: (string | number)[][],\n  splitAxisIdxs: number[],\n): (string | number)[][] {\n  const combinations: (string | number)[][] = [];\n\n  function generate(currentCombo: (string | number)[], sAxisIdx: number): void {\n    if (sAxisIdx >= splitAxisIdxs.length) {\n      combinations.push([...currentCombo]);\n      if (combinations.length > MAX_KEY_COMBINATIONS) {\n        throw new Error(\"Too many key combinations, aborting.\");\n      }\n      return;\n    }\n\n    const axisIdx = splitAxisIdxs[sAxisIdx];\n    if (axisIdx >= uniqueKeys.length) {\n      throw new Error(\n        `Axis index ${axisIdx} out of bounds for unique keys array (length ${uniqueKeys.length})`,\n      );\n    }\n\n    const axisValues = uniqueKeys[axisIdx];\n    if (!axisValues || axisValues.length === 0) {\n      combinations.length = 0;\n      return;\n    }\n\n    for (const val of axisValues) {\n      currentCombo.push(val);\n      generate(currentCombo, sAxisIdx + 1);\n      currentCombo.pop();\n    }\n  }\n\n  generate([], 0);\n  return combinations;\n}\n"],"mappings":";;;;;;;AAmCA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;AAsB7B,SAAgB,kBACd,QACA,WACA,MAC4B;CAC5B,IAAI,UAAU,WAAW,GACvB,OAAO,CAAC,GAAG,MAAM;CAGnB,MAAM,gBAAgB,UAAU,KAAK,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC;CACtE,MAAM,cAAc,cAAc,cAAc,SAAS;CAEzD,MAAM,SAAyB,CAAC;CAEhC,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,OAAO,kBAAkB,KAAK;EAGpC,IAAI,EAAE,gBAAgB,qBAAqB,CAAC,kBAAkB,IAAI,GAChE;EAGF,MAAM,aAAa,uBAAuB,IAAI;EAC9C,IAAI,eAAe,KAAA,GAAW,OAAO,KAAA;EAErC,IAAI,eAAe,WAAW,QAC5B,MAAM,IAAI,MACR,8BAA8B,WAAW,OAAO,wCAAwC,YAAY,cAAc,MAAM,QAAQ,CAAC,CAAC,MACpI;EAGF,MAAM,OAAO,MAAM,QAAQ;EAC3B,MAAM,WAAW,KAAK;EACtB,MAAM,iBAAiB,cAAc,KAAK,QAAQ,SAAS,IAAI;EAC/D,MAAM,eAAe,eAAe,KAAK,aAAa,UAAU,QAAQ,CAAC;EACzE,MAAM,aAAa,aAAa,KAAK,WAAW,MAAM,mBAAmB,MAAM,CAAC;EAEhF,MAAM,mBAAmB,eAAe,MAAM,WAAW,KAAK;EAC9D,MAAM,YAA0B,mBAC1B,KAAK,MAAM,gBAAgB,KAAsB,CAAC,IACpD,CAAC;EAEL,MAAM,kBAAkB,wBAAwB,YAAY,aAAa;EACzE,IAAI,gBAAgB,WAAW,GAAG;EAElC,KAAK,MAAM,YAAY,iBAAiB;GACtC,MAAM,cAAiC,SAAS,KAC7C,OAAO,aAA8B,CAAC,cAAc,WAAW,KAAwB,CAC1F;GAEA,MAAM,SAAiC,CAAC;GACxC,MAAM,eAA6B,CAAC;GACpC,KAAK,IAAI,WAAW,GAAG,WAAW,SAAS,QAAQ,YAAY;IAC7D,MAAM,QAAQ,SAAS;IACvB,MAAM,WAAW,eAAe;IAChC,MAAM,SAAS,aAAa;IAE5B,MAAM,QADW,WAAW,SACN,GAAG,UAAU,OAAO,KAAK;IAC/C,OAAO,SAAS,QAAQ,OAAO,KAAK;IACpC,aAAa,KAAK;KAChB,MAAM,SAAS,mBAAmB,MAAM;KACxC;KACA,YAAY;IACd,CAAC;GACH;GAEA,MAAM,WAAW,qBAAqB,KAAK,OAAO,WAAW;GAC7D,MAAM,YAAY,uBAAuB,KAAK,UAAU;IACtD;IACA,aAAa,GACV,WAAW,QAAQ,KAAK,UAAU,CAAC,GAAG,WAAW,GAAG,YAAY,CAAC,EACpE;GACF,CAAC;GAED,OAAO,KAAK,SAAS;EACvB;CACF;CAEA,OAAO;AACT;AAEA,SAAS,wBACP,YACA,eACuB;CACvB,MAAM,eAAsC,CAAC;CAE7C,SAAS,SAAS,cAAmC,UAAwB;EAC3E,IAAI,YAAY,cAAc,QAAQ;GACpC,aAAa,KAAK,CAAC,GAAG,YAAY,CAAC;GACnC,IAAI,aAAa,SAAS,sBACxB,MAAM,IAAI,MAAM,sCAAsC;GAExD;EACF;EAEA,MAAM,UAAU,cAAc;EAC9B,IAAI,WAAW,WAAW,QACxB,MAAM,IAAI,MACR,cAAc,QAAQ,+CAA+C,WAAW,OAAO,EACzF;EAGF,MAAM,aAAa,WAAW;EAC9B,IAAI,CAAC,cAAc,WAAW,WAAW,GAAG;GAC1C,aAAa,SAAS;GACtB;EACF;EAEA,KAAK,MAAM,OAAO,YAAY;GAC5B,aAAa,KAAK,GAAG;GACrB,SAAS,cAAc,WAAW,CAAC;GACnC,aAAa,IAAI;EACnB;CACF;CAEA,SAAS,CAAC,GAAG,CAAC;CACd,OAAO;AACT"}

package/dist/columns/index.cjs

@@ -1,20 +1,46 @@
-const require_column_snapshot = require("./column_snapshot.cjs");
-const require_column_snapshot_provider = require("./column_snapshot_provider.cjs");
-const require_column_selector = require("./column_selector.cjs");
-const require_column_collection_builder = require("./column_collection_builder.cjs");
-const require_ctx_column_sources = require("./ctx_column_sources.cjs");
+const require_column = require("./column.cjs");
+const require_column_discovered_recipe = require("./column_recipes/column_discovered_recipe.cjs");
+const require_column_filtered_recipe = require("./column_recipes/column_filtered_recipe.cjs");
+const require_index = require("./column_recipes/index.cjs");
+const require_column_overrided_recipe = require("./column_recipes/column_overrided_recipe.cjs");
+const require_column_lazy = require("./column_lazy.cjs");
+const require_providers = require("./column_providers/providers.cjs");
+const require_index$1 = require("./column_providers/index.cjs");
+const require_columns_collection = require("./columns_collection.cjs");
+const require_utils = require("./utils.cjs");
 const require_expand_by_partition = require("./expand_by_partition.cjs");
-exports.ArrayColumnProvider = require_column_snapshot_provider.ArrayColumnProvider;
-exports.ColumnCollectionBuilder = require_column_collection_builder.ColumnCollectionBuilder;
-exports.OutputColumnProvider = require_column_snapshot_provider.OutputColumnProvider;
-exports.ResultPoolColumnSnapshotProvider = require_ctx_column_sources.ResultPoolColumnSnapshotProvider;
-exports.SnapshotColumnProvider = require_column_snapshot_provider.SnapshotColumnProvider;
-exports.collectCtxColumnSnapshotProviders = require_ctx_column_sources.collectCtxColumnSnapshotProviders;
-exports.convertColumnSelectorToMultiColumnSelector = require_column_selector.convertColumnSelectorToMultiColumnSelector;
-exports.convertRelaxedAxisSelectorToMultiAxisSelector = require_column_selector.convertRelaxedAxisSelectorToMultiAxisSelector;
-exports.convertRelaxedColumnSelectorToMultiColumnSelector = require_column_selector.convertRelaxedColumnSelectorToMultiColumnSelector;
-exports.createColumnSnapshot = require_column_snapshot.createColumnSnapshot;
-exports.createReadyColumnData = require_column_snapshot.createReadyColumnData;
+const require_derive_axis_values_labels = require("./derive_axis_values_labels.cjs");
+exports.AccessorColumnsProvider = require_providers.AccessorColumnsProvider;
+exports.AccessorColumnsProviderImpl = require_providers.AccessorColumnsProviderImpl;
+exports.ArrayColumnsProvider = require_providers.ArrayColumnsProvider;
+exports.Column = require_column.Column;
+exports.ColumnAbsentError = require_column_lazy.ColumnAbsentError;
+exports.ColumnDiscoveredRecipe = require_column_discovered_recipe.ColumnDiscoveredRecipe;
+exports.ColumnFilteredRecipe = require_column_filtered_recipe.ColumnFilteredRecipe;
+exports.ColumnLazy = require_column_lazy.ColumnLazy;
+exports.ColumnLazyImpl = require_column_lazy.ColumnLazyImpl;
+exports.ColumnOverriddenRecipe = require_column_overrided_recipe.ColumnOverriddenRecipe;
+exports.ColumnRecipe = require_index.ColumnRecipe;
+exports.ColumnsCollection = require_columns_collection.ColumnsCollection;
+exports.ColumnsCollectionImpl = require_columns_collection.ColumnsCollectionImpl;
+exports.ColumnsProvider = require_providers.ColumnsProvider;
+exports.ResultPoolColumnsProvider = require_providers.ResultPoolColumnsProvider;
+exports.ResultPoolColumnsProviderImpl = require_providers.ResultPoolColumnsProviderImpl;
+exports._ctxProvidersCache = require_index$1._ctxProvidersCache;
+exports.collectLinkerColumns = require_utils.collectLinkerColumns;
+exports.collectLinkerIds = require_utils.collectLinkerIds;
+exports.deriveAxisValuesLabels = require_derive_axis_values_labels.deriveAxisValuesLabels;
+exports.deriveColumnOptions = require_utils.deriveColumnOptions;
 exports.expandByPartition = require_expand_by_partition.expandByPartition;
-exports.isColumnSnapshotProvider = require_column_snapshot_provider.isColumnSnapshotProvider;
-exports.toColumnSnapshotProvider = require_column_snapshot_provider.toColumnSnapshotProvider;
+exports.getCtxProviders = require_index$1.getCtxProviders;
+exports.getLeafColumnData = require_utils.getLeafColumnData;
+exports.hasColumnData = require_utils.hasColumnData;
+exports.hitQualifications = require_utils.hitQualifications;
+exports.isColumn = require_column.isColumn;
+exports.isColumnLazy = require_column_lazy.isColumnLazy;
+exports.isColumnProvider = require_index$1.isColumnProvider;
+exports.isColumnRecipe = require_index.isColumnRecipe;
+exports.isColumnsCollection = require_columns_collection.isColumnsCollection;
+exports.isLeafColumn = require_utils.isLeafColumn;
+exports.queriesQualifications = require_utils.queriesQualifications;
+exports.toColumnProvider = require_index$1.toColumnProvider;