@platforma-sdk/model 1.80.17 → 1.81.0

package/dist/columns/derive_axis_values_labels.cjs

@@ -1,7 +1,7 @@
 const require_accessor = require("../render/accessor.cjs");
 require("../render/index.cjs");
-const require_column_lazy = require("./column_lazy.cjs");
 const require_columns_collection = require("./columns_collection.cjs");
+const require_utils = require("./utils.cjs");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
 //#region src/columns/derive_axis_values_labels.ts
 const RT_JSON = "PColumnData/Json";
@@ -15,11 +15,11 @@ const RT_JSON_PARTITIONED = "PColumnData/JsonPartitioned";
 * column-access mechanism (filtered {@link ColumnsCollection}) instead of
 * walking the raw result pool.
 *
-* Pair with {@link expandByPartition} (or any consumer expecting the
+* Pair with {@link splitByAxes} (or any consumer expecting the
 * `(axisId) => Record<axisValue, label>` shape).
 *
 * Skips:
-*  - non-leaf recipes (only direct `ColumnLazy` data is read);
+*  - recipes whose data is not directly readable (see `hasReachableData`);
 *  - label columns whose `axesSpec.length !== 1`;
 *  - label columns whose data resource type isn't `PColumnData/Json` /
 *    `PColumnData/JsonPartitioned`.
@@ -29,7 +29,7 @@ function deriveAxisValuesLabels(source, opts) {
 		type: "exact",
 		value: _milaboratories_pl_model_common.PColumnName.Label
 	}] } }).getColumns().reduce((map, col) => {
-		if (!require_column_lazy.isColumnLazy(col)) return map;
+		if (!require_utils.hasReachableData(col)) return map;
 		const spec = col.getSpec();
 		if (spec.axesSpec.length !== 1) return map;
 		const data = col.getData();

package/dist/columns/derive_axis_values_labels.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"derive_axis_values_labels.cjs","names":["ColumnsCollection","isColumnsCollection","PColumnName","isColumnLazy","TreeNodeAccessor"],"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,IACPA,2BAAAA,kBAAkB,KAAA,GAAW,IAAI,IACjCC,2BAAAA,oBAAoB,MAAM,IACxB,SACAD,2BAAAA,kBAAkB,QAAQ,IAAI,EAAA,CAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;EAAE,MAAM;EAAS,OAAOE,gCAAAA,YAAY;CAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAC5E,WAEoB,CAAC,CAAC,QAAsD,KAAK,QAAQ;EAC1F,IAAI,CAACC,oBAAAA,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,gBAAgBC,iBAAAA,mBAAmB,OAAO;EAEhD,MAAM,WAAW,aAAa,IAAI;EAClC,IAAI,CAAC,UAAU,OAAO;EAEtB,IAAI,KAAA,GAAA,gCAAA,mBAAA,EAAA,GAAA,gCAAA,UAAA,CAAiC,KAAK,SAAS,EAAE,CAAC,GAAG,QAAQ;EACjE,OAAO;CACT,mBAAG,IAAI,IAAI,CAAC;CAEZ,QAAQ,WAAW,OAAO,KAAA,GAAA,gCAAA,mBAAA,CAAuB,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"}
+{"version":3,"file":"derive_axis_values_labels.cjs","names":["ColumnsCollection","isColumnsCollection","PColumnName","hasReachableData","TreeNodeAccessor"],"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 { hasReachableData } from \"./utils\";\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 splitByAxes} (or any consumer expecting the\n * `(axisId) => Record<axisValue, label>` shape).\n *\n * Skips:\n *  - recipes whose data is not directly readable (see `hasReachableData`);\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 (!hasReachableData(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,IACPA,2BAAAA,kBAAkB,KAAA,GAAW,IAAI,IACjCC,2BAAAA,oBAAoB,MAAM,IACxB,SACAD,2BAAAA,kBAAkB,QAAQ,IAAI,EAAA,CAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;EAAE,MAAM;EAAS,OAAOE,gCAAAA,YAAY;CAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAC5E,WAEoB,CAAC,CAAC,QAAsD,KAAK,QAAQ;EAC1F,IAAI,CAACC,cAAAA,iBAAiB,GAAG,GAAG,OAAO;EACnC,MAAM,OAAO,IAAI,QAAQ;EACzB,IAAI,KAAK,SAAS,WAAW,GAAG,OAAO;EAEvC,MAAM,OAAO,IAAI,QAAQ;EACzB,IAAI,EAAE,gBAAgBC,iBAAAA,mBAAmB,OAAO;EAEhD,MAAM,WAAW,aAAa,IAAI;EAClC,IAAI,CAAC,UAAU,OAAO;EAEtB,IAAI,KAAA,GAAA,gCAAA,mBAAA,EAAA,GAAA,gCAAA,UAAA,CAAiC,KAAK,SAAS,EAAE,CAAC,GAAG,QAAQ;EACjE,OAAO;CACT,mBAAG,IAAI,IAAI,CAAC;CAEZ,QAAQ,WAAW,OAAO,KAAA,GAAA,gCAAA,mBAAA,CAAuB,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/derive_axis_values_labels.d.ts

@@ -13,11 +13,11 @@ import { AxisId } from "@milaboratories/pl-model-common";
  * column-access mechanism (filtered {@link ColumnsCollection}) instead of
  * walking the raw result pool.
  *
- * Pair with {@link expandByPartition} (or any consumer expecting the
+ * Pair with {@link splitByAxes} (or any consumer expecting the
  * `(axisId) => Record<axisValue, label>` shape).
  *
  * Skips:
- *  - non-leaf recipes (only direct `ColumnLazy` data is read);
+ *  - recipes whose data is not directly readable (see `hasReachableData`);
  *  - label columns whose `axesSpec.length !== 1`;
  *  - label columns whose data resource type isn't `PColumnData/Json` /
  *    `PColumnData/JsonPartitioned`.

package/dist/columns/derive_axis_values_labels.js

@@ -1,7 +1,7 @@
 import { TreeNodeAccessor } from "../render/accessor.js";
 import "../render/index.js";
-import { isColumnLazy } from "./column_lazy.js";
 import { ColumnsCollection, isColumnsCollection } from "./columns_collection.js";
+import { hasReachableData } from "./utils.js";
 import { PColumnName, canonicalizeAxisId, getAxisId } from "@milaboratories/pl-model-common";
 //#region src/columns/derive_axis_values_labels.ts
 const RT_JSON = "PColumnData/Json";
@@ -15,11 +15,11 @@ const RT_JSON_PARTITIONED = "PColumnData/JsonPartitioned";
 * column-access mechanism (filtered {@link ColumnsCollection}) instead of
 * walking the raw result pool.
 *
-* Pair with {@link expandByPartition} (or any consumer expecting the
+* Pair with {@link splitByAxes} (or any consumer expecting the
 * `(axisId) => Record<axisValue, label>` shape).
 *
 * Skips:
-*  - non-leaf recipes (only direct `ColumnLazy` data is read);
+*  - recipes whose data is not directly readable (see `hasReachableData`);
 *  - label columns whose `axesSpec.length !== 1`;
 *  - label columns whose data resource type isn't `PColumnData/Json` /
 *    `PColumnData/JsonPartitioned`.
@@ -29,7 +29,7 @@ function deriveAxisValuesLabels(source, opts) {
 		type: "exact",
 		value: PColumnName.Label
 	}] } }).getColumns().reduce((map, col) => {
-		if (!isColumnLazy(col)) return map;
+		if (!hasReachableData(col)) return map;
 		const spec = col.getSpec();
 		if (spec.axesSpec.length !== 1) return map;
 		const data = col.getData();

package/dist/columns/derive_axis_values_labels.js.map

@@ -1 +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"}
+{"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 { hasReachableData } from \"./utils\";\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 splitByAxes} (or any consumer expecting the\n * `(axisId) => Record<axisValue, label>` shape).\n *\n * Skips:\n *  - recipes whose data is not directly readable (see `hasReachableData`);\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 (!hasReachableData(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,iBAAiB,GAAG,GAAG,OAAO;EACnC,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/index.cjs

@@ -3,27 +3,27 @@ const require_column_discovered_recipe = require("./column_recipes/column_discov
 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_data_column = require("./data_column.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");
 const require_derive_axis_values_labels = require("./derive_axis_values_labels.cjs");
+const require_split_by_axes = require("./split_by_axes.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.ColumnAbsentError = require_data_column.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.DataColumn = require_data_column.DataColumn;
+exports.DataColumnImpl = require_data_column.DataColumnImpl;
 exports.ResultPoolColumnsProvider = require_providers.ResultPoolColumnsProvider;
 exports.ResultPoolColumnsProviderImpl = require_providers.ResultPoolColumnsProviderImpl;
 exports._ctxProvidersCache = require_index$1._ctxProvidersCache;
@@ -31,16 +31,16 @@ 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.getCtxProviders = require_index$1.getCtxProviders;
-exports.getLeafColumnData = require_utils.getLeafColumnData;
 exports.hasColumnData = require_utils.hasColumnData;
+exports.hasReachableData = require_utils.hasReachableData;
+exports.hasSingleDataColumn = require_utils.hasSingleDataColumn;
 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.isDataColumn = require_data_column.isDataColumn;
 exports.isLeafColumn = require_utils.isLeafColumn;
 exports.queriesQualifications = require_utils.queriesQualifications;
+exports.splitByAxes = require_split_by_axes.splitByAxes;
 exports.toColumnProvider = require_index$1.toColumnProvider;

package/dist/columns/index.d.ts

@@ -1,15 +1,15 @@
 import { ColumnFieldStatus, ColumnRecipeId, ColumnResolutionStatus, SpecQuery } from "./column_recipes/types.js";
-import { ColumnAbsentError, ColumnLazy, ColumnLazyData, ColumnLazyId, ColumnLazyImpl, isColumnLazy } from "./column_lazy.js";
+import { ColumnAbsentError, ColumnData, DataColumn, DataColumnId, DataColumnImpl, DataColumnRecipe, DataColumnSource, isDataColumn } from "./data_column.js";
 import { ColumnDiscoveredRecipe } from "./column_recipes/column_discovered_recipe.js";
 import { ColumnFilteredRecipe } from "./column_recipes/column_filtered_recipe.js";
 import { Column, ColumnSource, isColumn } from "./column.js";
 import { ColumnOverriddenRecipe } from "./column_recipes/column_overrided_recipe.js";
-import { ColumnRecipe, isColumnRecipe } from "./column_recipes/index.js";
+import { ColumnRecipe } from "./column_recipes/index.js";
 import { AccessorColumnsProvider, AccessorColumnsProviderImpl, ArrayColumnsProvider, ColumnsProvider, ResultPoolColumnsProvider, ResultPoolColumnsProviderImpl } from "./column_providers/providers.js";
 import { ColumnsSource } from "./column_providers/types.js";
 import { _ctxProvidersCache, getCtxProviders, isColumnProvider, toColumnProvider } from "./column_providers/index.js";
-import { ExpandByPartitionOpts, SplitAxis, expandByPartition } from "./expand_by_partition.js";
+import { SplitAxis, SplitByAxesOpts, splitByAxes } from "./split_by_axes.js";
 import { ColumnsCollection, ColumnsCollectionDeps, ColumnsCollectionImpl, ColumnsSourceShorthand, isColumnsCollection } from "./columns_collection.js";
 import { deriveAxisValuesLabels } from "./derive_axis_values_labels.js";
-import { ColumnOption, collectLinkerColumns, collectLinkerIds, deriveColumnOptions, getLeafColumnData, hasColumnData, hitQualifications, isLeafColumn, queriesQualifications } from "./utils.js";
-export { AccessorColumnsProvider, AccessorColumnsProviderImpl, ArrayColumnsProvider, Column, ColumnAbsentError, ColumnDiscoveredRecipe, type ColumnFieldStatus, ColumnFilteredRecipe, ColumnLazy, ColumnLazyData, ColumnLazyId, ColumnLazyImpl, ColumnOption, ColumnOverriddenRecipe, ColumnRecipe, type ColumnRecipeId, type ColumnResolutionStatus, ColumnSource, ColumnsCollection, ColumnsCollectionDeps, ColumnsCollectionImpl, ColumnsProvider, ColumnsSource, ColumnsSourceShorthand, ExpandByPartitionOpts, ResultPoolColumnsProvider, ResultPoolColumnsProviderImpl, type SpecQuery, SplitAxis, _ctxProvidersCache, collectLinkerColumns, collectLinkerIds, deriveAxisValuesLabels, deriveColumnOptions, expandByPartition, getCtxProviders, getLeafColumnData, hasColumnData, hitQualifications, isColumn, isColumnLazy, isColumnProvider, isColumnRecipe, isColumnsCollection, isLeafColumn, queriesQualifications, toColumnProvider };
+import { ColumnOption, collectLinkerColumns, collectLinkerIds, deriveColumnOptions, hasColumnData, hasReachableData, hasSingleDataColumn, hitQualifications, isLeafColumn, queriesQualifications } from "./utils.js";
+export { AccessorColumnsProvider, AccessorColumnsProviderImpl, ArrayColumnsProvider, Column, ColumnAbsentError, ColumnData, ColumnDiscoveredRecipe, type ColumnFieldStatus, ColumnFilteredRecipe, ColumnOption, ColumnOverriddenRecipe, ColumnRecipe, type ColumnRecipeId, type ColumnResolutionStatus, ColumnSource, ColumnsCollection, ColumnsCollectionDeps, ColumnsCollectionImpl, ColumnsProvider, ColumnsSource, ColumnsSourceShorthand, DataColumn, DataColumnId, DataColumnImpl, DataColumnRecipe, DataColumnSource, ResultPoolColumnsProvider, ResultPoolColumnsProviderImpl, type SpecQuery, SplitAxis, SplitByAxesOpts, _ctxProvidersCache, collectLinkerColumns, collectLinkerIds, deriveAxisValuesLabels, deriveColumnOptions, getCtxProviders, hasColumnData, hasReachableData, hasSingleDataColumn, hitQualifications, isColumn, isColumnProvider, isColumnsCollection, isDataColumn, isLeafColumn, queriesQualifications, splitByAxes, toColumnProvider };

package/dist/columns/index.js

@@ -1,13 +1,13 @@
 import { Column, isColumn } from "./column.js";
 import { ColumnDiscoveredRecipe } from "./column_recipes/column_discovered_recipe.js";
 import { ColumnFilteredRecipe } from "./column_recipes/column_filtered_recipe.js";
-import { ColumnRecipe, isColumnRecipe } from "./column_recipes/index.js";
+import { ColumnRecipe } from "./column_recipes/index.js";
 import { ColumnOverriddenRecipe } from "./column_recipes/column_overrided_recipe.js";
-import { ColumnAbsentError, ColumnLazy, ColumnLazyImpl, isColumnLazy } from "./column_lazy.js";
+import { ColumnAbsentError, DataColumn, DataColumnImpl, isDataColumn } from "./data_column.js";
 import { AccessorColumnsProvider, AccessorColumnsProviderImpl, ArrayColumnsProvider, ColumnsProvider, ResultPoolColumnsProvider, ResultPoolColumnsProviderImpl } from "./column_providers/providers.js";
 import { _ctxProvidersCache, getCtxProviders, isColumnProvider, toColumnProvider } from "./column_providers/index.js";
 import { ColumnsCollection, ColumnsCollectionImpl, isColumnsCollection } from "./columns_collection.js";
-import { collectLinkerColumns, collectLinkerIds, deriveColumnOptions, getLeafColumnData, hasColumnData, hitQualifications, isLeafColumn, queriesQualifications } from "./utils.js";
-import { expandByPartition } from "./expand_by_partition.js";
+import { collectLinkerColumns, collectLinkerIds, deriveColumnOptions, hasColumnData, hasReachableData, hasSingleDataColumn, hitQualifications, isLeafColumn, queriesQualifications } from "./utils.js";
 import { deriveAxisValuesLabels } from "./derive_axis_values_labels.js";
-export { AccessorColumnsProvider, AccessorColumnsProviderImpl, ArrayColumnsProvider, Column, ColumnAbsentError, ColumnDiscoveredRecipe, ColumnFilteredRecipe, ColumnLazy, ColumnLazyImpl, ColumnOverriddenRecipe, ColumnRecipe, ColumnsCollection, ColumnsCollectionImpl, ColumnsProvider, ResultPoolColumnsProvider, ResultPoolColumnsProviderImpl, _ctxProvidersCache, collectLinkerColumns, collectLinkerIds, deriveAxisValuesLabels, deriveColumnOptions, expandByPartition, getCtxProviders, getLeafColumnData, hasColumnData, hitQualifications, isColumn, isColumnLazy, isColumnProvider, isColumnRecipe, isColumnsCollection, isLeafColumn, queriesQualifications, toColumnProvider };
+import { splitByAxes } from "./split_by_axes.js";
+export { AccessorColumnsProvider, AccessorColumnsProviderImpl, ArrayColumnsProvider, Column, ColumnAbsentError, ColumnDiscoveredRecipe, ColumnFilteredRecipe, ColumnOverriddenRecipe, ColumnRecipe, ColumnsCollection, ColumnsCollectionImpl, ColumnsProvider, DataColumn, DataColumnImpl, ResultPoolColumnsProvider, ResultPoolColumnsProviderImpl, _ctxProvidersCache, collectLinkerColumns, collectLinkerIds, deriveAxisValuesLabels, deriveColumnOptions, getCtxProviders, hasColumnData, hasReachableData, hasSingleDataColumn, hitQualifications, isColumn, isColumnProvider, isColumnsCollection, isDataColumn, isLeafColumn, queriesQualifications, splitByAxes, toColumnProvider };

package/dist/columns/{expand_by_partition.cjs → split_by_axes.cjs}

@@ -3,12 +3,16 @@ const require_pcolumn_data = require("../render/util/pcolumn_data.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");
+const require_derive_axis_values_labels = require("./derive_axis_values_labels.cjs");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
-//#region src/columns/expand_by_partition.ts
+//#region src/columns/split_by_axes.ts
 const MAX_KEY_COMBINATIONS = 1e4;
 /**
-* Expand each input column along the requested partition axes into one
-* {@link ColumnRecipe} per Cartesian combination of unique partition values.
+* Split each input column along the requested axes into one
+* {@link ColumnRecipe} per Cartesian combination of the axes' distinct values.
+*
+* The split axes must be partition-key axes of the input's data — the distinct
+* values are read off the partition keys.
 *
 * Each split is produced as `ColumnOverriddenRecipe.wrap(ColumnFilteredRecipe.wrap(inner, axisFilters), { domain, annotations })`:
 *   - `ColumnFilteredRecipe` pins all split axes at once (one wrap call with
@@ -26,13 +30,14 @@ const MAX_KEY_COMBINATIONS = 1e4;
 * Returns `undefined` when any input's `getData()` is not a
 * {@link TreeNodeAccessor} — partition inspection is not yet possible.
 */
-function expandByPartition(inputs, splitAxes, opts) {
+function splitByAxes(inputs, splitAxes, opts) {
 	if (splitAxes.length === 0) return [...inputs];
+	const axisValuesLabels = opts?.axisValuesLabels ?? require_derive_axis_values_labels.deriveAxisValuesLabels();
 	const splitAxisIdxs = splitAxes.map((a) => a.idx).sort((a, b) => a - b);
 	const maxSplitIdx = splitAxisIdxs[splitAxisIdxs.length - 1];
 	const result = [];
 	for (const inner of inputs) {
-		const data = require_utils.getLeafColumnData(inner);
+		const data = require_utils.hasReachableData(inner) ? inner.getData() : void 0;
 		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;
@@ -41,7 +46,7 @@ function expandByPartition(inputs, splitAxes, opts) {
 		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 axesLabels = splitAxisIds.map((axisId) => 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);
@@ -97,6 +102,6 @@ function generateKeyCombinations(uniqueKeys, splitAxisIdxs) {
 	return combinations;
 }
 //#endregion
-exports.expandByPartition = expandByPartition;
+exports.splitByAxes = splitByAxes;
 
-//# sourceMappingURL=expand_by_partition.cjs.map
+//# sourceMappingURL=split_by_axes.cjs.map

package/dist/columns/split_by_axes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"split_by_axes.cjs","names":["deriveAxisValuesLabels","hasReachableData","TreeNodeAccessor","getUniquePartitionKeys","Annotation","ColumnFilteredRecipe","ColumnOverriddenRecipe"],"sources":["../../src/columns/split_by_axes.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 { deriveAxisValuesLabels } from \"./derive_axis_values_labels\";\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 { hasReachableData } 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 SplitByAxesOpts {\n  /**\n   * Resolve axis values to human-readable labels.\n   *\n   * Defaults to {@link deriveAxisValuesLabels} over the ambient render ctx\n   * (current block outputs + result pool), resolved lazily on the first\n   * lookup. Pass an explicit callback to narrow the label source, or\n   * `() => undefined` to keep raw axis values.\n   */\n  axisValuesLabels?: (axisId: AxisId) => undefined | Record<string | number, string>;\n}\n\n// --- Implementation ---\n\nconst MAX_KEY_COMBINATIONS = 10_000;\n\n/**\n * Split each input column along the requested axes into one\n * {@link ColumnRecipe} per Cartesian combination of the axes' distinct values.\n *\n * The split axes must be partition-key axes of the input's data — the distinct\n * values are read off the partition keys.\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 splitByAxes(\n  inputs: Column[],\n  splitAxes: SplitAxis[],\n  opts?: SplitByAxesOpts,\n): ColumnRecipe[] | undefined {\n  if (splitAxes.length === 0) {\n    return [...inputs];\n  }\n\n  const axisValuesLabels = opts?.axisValuesLabels ?? deriveAxisValuesLabels();\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 = hasReachableData(inner) ? inner.getData() : undefined;\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) => 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 → split_by_axes.d.ts}

@@ -2,18 +2,28 @@ 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
+//#region src/columns/split_by_axes.d.ts
 interface SplitAxis {
   /** Index of the axis in the column's axesSpec to split by. */
   readonly idx: number;
 }
-interface ExpandByPartitionOpts {
-  /** Resolve axis values to human-readable labels. */
+interface SplitByAxesOpts {
+  /**
+   * Resolve axis values to human-readable labels.
+   *
+   * Defaults to {@link deriveAxisValuesLabels} over the ambient render ctx
+   * (current block outputs + result pool), resolved lazily on the first
+   * lookup. Pass an explicit callback to narrow the label source, or
+   * `() => undefined` to keep raw axis values.
+   */
   axisValuesLabels?: (axisId: AxisId) => undefined | Record<string | number, string>;
 }
 /**
- * Expand each input column along the requested partition axes into one
- * {@link ColumnRecipe} per Cartesian combination of unique partition values.
+ * Split each input column along the requested axes into one
+ * {@link ColumnRecipe} per Cartesian combination of the axes' distinct values.
+ *
+ * The split axes must be partition-key axes of the input's data — the distinct
+ * values are read off the partition keys.
  *
  * Each split is produced as `ColumnOverriddenRecipe.wrap(ColumnFilteredRecipe.wrap(inner, axisFilters), { domain, annotations })`:
  *   - `ColumnFilteredRecipe` pins all split axes at once (one wrap call with
@@ -31,7 +41,7 @@ interface ExpandByPartitionOpts {
  * Returns `undefined` when any input's `getData()` is not a
  * {@link TreeNodeAccessor} — partition inspection is not yet possible.
  */
-declare function expandByPartition(inputs: Column[], splitAxes: SplitAxis[], opts?: ExpandByPartitionOpts): ColumnRecipe[] | undefined;
+declare function splitByAxes(inputs: Column[], splitAxes: SplitAxis[], opts?: SplitByAxesOpts): ColumnRecipe[] | undefined;
 //#endregion
-export { ExpandByPartitionOpts, SplitAxis, expandByPartition };
-//# sourceMappingURL=expand_by_partition.d.ts.map
+export { SplitAxis, SplitByAxesOpts, splitByAxes };
+//# sourceMappingURL=split_by_axes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"split_by_axes.d.ts","names":[],"sources":["../../src/columns/split_by_axes.ts"],"mappings":";;;;;UAwBiB,SAAA;;WAEN,GAAG;AAAA;AAAA,UAGG,eAAA;EAHH;AAAA;AAGd;;;;;;EASE,gBAAA,IAAoB,MAAA,EAAQ,MAAA,iBAAuB,MAAM;AAAA;;AAAA;AA8B3D;;;;;;;;;;;;;;;;;AAIe;;;;iBAJC,WAAA,CACd,MAAA,EAAQ,MAAA,IACR,SAAA,EAAW,SAAA,IACX,IAAA,GAAO,eAAA,GACN,YAAA"}

package/dist/columns/{expand_by_partition.js → split_by_axes.js}

@@ -2,13 +2,17 @@ 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 { hasReachableData } from "./utils.js";
+import { deriveAxisValuesLabels } from "./derive_axis_values_labels.js";
 import { Annotation, canonicalizeAxisId, getAxisId, isDataInfoEntries, readAnnotation } from "@milaboratories/pl-model-common";
-//#region src/columns/expand_by_partition.ts
+//#region src/columns/split_by_axes.ts
 const MAX_KEY_COMBINATIONS = 1e4;
 /**
-* Expand each input column along the requested partition axes into one
-* {@link ColumnRecipe} per Cartesian combination of unique partition values.
+* Split each input column along the requested axes into one
+* {@link ColumnRecipe} per Cartesian combination of the axes' distinct values.
+*
+* The split axes must be partition-key axes of the input's data — the distinct
+* values are read off the partition keys.
 *
 * Each split is produced as `ColumnOverriddenRecipe.wrap(ColumnFilteredRecipe.wrap(inner, axisFilters), { domain, annotations })`:
 *   - `ColumnFilteredRecipe` pins all split axes at once (one wrap call with
@@ -26,13 +30,14 @@ const MAX_KEY_COMBINATIONS = 1e4;
 * Returns `undefined` when any input's `getData()` is not a
 * {@link TreeNodeAccessor} — partition inspection is not yet possible.
 */
-function expandByPartition(inputs, splitAxes, opts) {
+function splitByAxes(inputs, splitAxes, opts) {
 	if (splitAxes.length === 0) return [...inputs];
+	const axisValuesLabels = opts?.axisValuesLabels ?? deriveAxisValuesLabels();
 	const splitAxisIdxs = splitAxes.map((a) => a.idx).sort((a, b) => a - b);
 	const maxSplitIdx = splitAxisIdxs[splitAxisIdxs.length - 1];
 	const result = [];
 	for (const inner of inputs) {
-		const data = getLeafColumnData(inner);
+		const data = hasReachableData(inner) ? inner.getData() : void 0;
 		if (!(data instanceof TreeNodeAccessor) && !isDataInfoEntries(data)) return;
 		const uniqueKeys = getUniquePartitionKeys(data);
 		if (uniqueKeys === void 0) return void 0;
@@ -41,7 +46,7 @@ function expandByPartition(inputs, splitAxes, opts) {
 		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 axesLabels = splitAxisIds.map((axisId) => axisValuesLabels(axisId));
 		const existingTraceRaw = readAnnotation(spec, Annotation.Trace);
 		const baseTrace = existingTraceRaw ? JSON.parse(existingTraceRaw) ?? [] : [];
 		const keyCombinations = generateKeyCombinations(uniqueKeys, splitAxisIdxs);
@@ -97,6 +102,6 @@ function generateKeyCombinations(uniqueKeys, splitAxisIdxs) {
 	return combinations;
 }
 //#endregion
-export { expandByPartition };
+export { splitByAxes };
 
-//# sourceMappingURL=expand_by_partition.js.map
+//# sourceMappingURL=split_by_axes.js.map

package/dist/columns/split_by_axes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split_by_axes.js","names":[],"sources":["../../src/columns/split_by_axes.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 { deriveAxisValuesLabels } from \"./derive_axis_values_labels\";\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 { hasReachableData } 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 SplitByAxesOpts {\n  /**\n   * Resolve axis values to human-readable labels.\n   *\n   * Defaults to {@link deriveAxisValuesLabels} over the ambient render ctx\n   * (current block outputs + result pool), resolved lazily on the first\n   * lookup. Pass an explicit callback to narrow the label source, or\n   * `() => undefined` to keep raw axis values.\n   */\n  axisValuesLabels?: (axisId: AxisId) => undefined | Record<string | number, string>;\n}\n\n// --- Implementation ---\n\nconst MAX_KEY_COMBINATIONS = 10_000;\n\n/**\n * Split each input column along the requested axes into one\n * {@link ColumnRecipe} per Cartesian combination of the axes' distinct values.\n *\n * The split axes must be partition-key axes of the input's data — the distinct\n * values are read off the partition keys.\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 splitByAxes(\n  inputs: Column[],\n  splitAxes: SplitAxis[],\n  opts?: SplitByAxesOpts,\n): ColumnRecipe[] | undefined {\n  if (splitAxes.length === 0) {\n    return [...inputs];\n  }\n\n  const axisValuesLabels = opts?.axisValuesLabels ?? deriveAxisValuesLabels();\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 = hasReachableData(inner) ? inner.getData() : undefined;\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) => 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/utils.cjs

@@ -4,7 +4,7 @@ require("../render/index.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_column_overrided_recipe = require("./column_recipes/column_overrided_recipe.cjs");
-const require_column_lazy = require("./column_lazy.cjs");
+const require_data_column = require("./data_column.cjs");
 const require_columns_collection = require("./columns_collection.cjs");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
 let _milaboratories_helpers = require("@milaboratories/helpers");
@@ -16,7 +16,7 @@ let _milaboratories_helpers = require("@milaboratories/helpers");
 * other engine-consumed column.
 *
 * Pure query walk — no registry access. Use {@link collectLinkerColumns} for
-* the resolved {@link ColumnLazy} variant.
+* the resolved {@link DataColumnRecipe} variant.
 */
 function collectLinkerIds(recipe) {
 	const hit = (0, _milaboratories_pl_model_common.extractPObjectId)(recipe.id);
@@ -33,11 +33,11 @@ function collectLinkerIds(recipe) {
 }
 /**
 * {@link collectLinkerIds} resolved against the ambient context as
-* {@link ColumnLazy} instances. Throws if any id fails to resolve —
+* {@link DataColumnRecipe} leaves. Throws if any id fails to resolve —
 * matches the contract of the legacy `resolveLinkers` it replaces.
 */
 function collectLinkerColumns(recipe, opts = {}) {
-	return collectLinkerIds(recipe).map((id) => require_column_lazy.ColumnLazyImpl.fromId(id, opts) ?? (0, _milaboratories_helpers.throwError)(`materializeLinkers: linker ${id} not resolvable`));
+	return collectLinkerIds(recipe).map((id) => require_data_column.DataColumnImpl.fromId(id, opts) ?? (0, _milaboratories_helpers.throwError)(`materializeLinkers: linker ${id} not resolvable`));
 }
 /**
 * Hit-side axis qualifications for the recipe — the ones that should land on
@@ -67,7 +67,7 @@ function queriesQualifications(recipe) {
 *
 * Walks every physical leaf the recipe depends on via
 * {@link ColumnRecipe.getReferencedIds} (resolves each id back to a
-* {@link ColumnLazy} through the ambient ctx) and ANDs `hasData()` across
+* {@link DataColumnRecipe} through the ambient ctx) and ANDs `hasData()` across
 * all of them. Inline {@link PColumnValues} payloads count as present.
 *
 * Returns `false` if any leaf cannot be re-resolved in `opts.ctx` (treat as
@@ -76,14 +76,14 @@ function queriesQualifications(recipe) {
 */
 function hasColumnData(recipe, opts = {}) {
 	for (const id of recipe.getReferencedIds()) {
-		const lazy = require_column_lazy.ColumnLazyImpl.fromId(id, opts);
-		if (lazy === void 0) return false;
-		if (lazy.getDataStatus() !== "present") return false;
-		if (!isLazyDataPresent(lazy.getData())) return false;
+		const leaf = require_data_column.DataColumnImpl.fromId(id, opts);
+		if (leaf === void 0) return false;
+		if (leaf.getDataStatus() !== "present") return false;
+		if (!isLeafDataPresent(leaf.getData())) return false;
 	}
 	return true;
 }
-function isLazyDataPresent(data) {
+function isLeafDataPresent(data) {
 	if (data === void 0) return false;
 	if (Array.isArray(data)) return true;
 	if (data instanceof require_accessor.TreeNodeAccessor) return data.hasData();
@@ -117,45 +117,51 @@ function findDiscovered(recipe) {
 	}
 }
 /**
-* A recipe is a "leaf" (directly co-indexed on the anchor, reached without a
-* linker chain) iff its wrapper chain contains no {@link ColumnDiscoveredRecipe}.
+* Whether the recipe reads exactly one data column — its own — rather than
+* reaching through others.
 *
-* `Filtered` / `Overridden` over a bare leaf stay leaves; anything wrapping a
-* `Discovered` (e.g. `Overridden(Discovered(...))`) is linked. Use this — not an
-* `instanceof ColumnLazyImpl` check — to split direct vs. linker-joined columns,
-* since projections over a plain leaf are still direct.
+* True for a bare leaf and for projections over one (spec overrides, axis
+* slicing): those add layers but no new columns. False when the recipe gets at
+* its data through further columns, which happens when discovery reached it via
+* a linker chain.
+*
+* **Why callers care.** A recipe over a single data column is co-indexed by its
+* own axes, so its spec is the whole truth about them. One that needs other
+* columns only lines up after they are joined in, and therefore drags axes into
+* the join that its own spec never mentions — which is why it cannot serve as a
+* primary column, and why `createPlDataTableV3` splits on this.
+*
+* The count comes from {@link ColumnRecipe.getReferencedIds}, which resolves
+* through the whole wrapper chain, so no class walk is involved and foreign
+* `ColumnRecipe` implementations are handled too.
 */
-function isLeafColumn(recipe) {
-	return findDiscovered(recipe) === void 0;
+function hasSingleDataColumn(recipe) {
+	return recipe.getReferencedIds().length === 1;
 }
 /**
-* Data of the bare leaf a "leaf" recipe bottoms out at — reads the leaf-only
-* {@link ColumnLazy.getData} after walking the wrapper chain down via
-* {@link extractLeafColumn}. Returns `undefined` when the recipe is not a leaf (its
-* chain reaches a {@link ColumnDiscoveredRecipe}); the symmetric counterpart
-* of {@link isLeafColumn} returning `false`.
+* @deprecated Renamed to {@link hasSingleDataColumn} — "leaf" read as "you can
+* get data out of it", which is a different question (see
+* {@link hasReachableData}). Same semantics.
 */
-function getLeafColumnData(recipe) {
-	if (!isLeafColumn(recipe)) throw new Error(`getLeafColumnData: recipe ${recipe.id} is not a leaf column`);
-	return extractLeafColumn(recipe)?.getData();
-}
+const isLeafColumn = hasSingleDataColumn;
 /**
-* Walk wrapper layers (Overridden, Filtered) down to the bare {@link ColumnLazy}
-* leaf the chain bottoms out at. Returns `undefined` if the chain reaches a
-* {@link ColumnDiscoveredRecipe} instead — i.e. the recipe is not a leaf
-* ({@link isLeafColumn} would return `false`). Mirror of {@link findDiscovered}.
+* Whether the column's data can be read here and now, consistent with its
+* spec — narrows to {@link DataColumnRecipe}, which exposes `getData()`.
+*
+* True for a bare leaf and for a spec-override over a bare leaf. False for an
+* axis-filtered recipe (its spec has dropped axes the underlying data still
+* carries, so the two no longer line up) and for anything reached through
+* other columns (nothing to read until the engine joins them). In both of
+* those cases the data exists only engine-side: pass `recipe.id` to
+* `createPFrame` / `createPTable` instead of trying to read it.
+*
+* The distinction is settled when the recipe is built, not here — recipes that
+* carry data are instances of a class that declares `getData`. So a `true`
+* result narrows to a value that really has the method, and there is no
+* throwing path behind the guard.
 */
-function extractLeafColumn(recipe) {
-	let current = recipe;
-	while (true) {
-		if (current instanceof require_column_lazy.ColumnLazyImpl) return current;
-		if (current instanceof require_column_overrided_recipe.ColumnOverriddenRecipe || current instanceof require_column_filtered_recipe.ColumnFilteredRecipe) {
-			current = current.getInner();
-			continue;
-		}
-		if (current instanceof require_column_discovered_recipe.ColumnDiscoveredRecipe) throw new Error(`extractLeafColumn: recipe ${recipe.id} is not a leaf column`);
-		throw new Error(`extractLeafColumn: unrecognized recipe layer for ${recipe.id}`);
-	}
+function hasReachableData(recipe) {
+	return recipe instanceof require_data_column.DataColumnImpl || recipe instanceof require_column_overrided_recipe.DataColumnOverriddenRecipe;
 }
 /**
 * Enumerates every column already in `source` and renders distinct labels
@@ -177,8 +183,9 @@ function deriveColumnOptions(source, labelOptions = {}) {
 exports.collectLinkerColumns = collectLinkerColumns;
 exports.collectLinkerIds = collectLinkerIds;
 exports.deriveColumnOptions = deriveColumnOptions;
-exports.getLeafColumnData = getLeafColumnData;
 exports.hasColumnData = hasColumnData;
+exports.hasReachableData = hasReachableData;
+exports.hasSingleDataColumn = hasSingleDataColumn;
 exports.hitQualifications = hitQualifications;
 exports.isLeafColumn = isLeafColumn;
 exports.queriesQualifications = queriesQualifications;