@platforma-sdk/model 1.80.13 → 1.81.0

package/dist/columns/{column_lazy.cjs → data_column.cjs}

@@ -3,7 +3,7 @@ const require_index = require("./column_providers/index.cjs");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
 let es_toolkit = require("es-toolkit");
 let lru_cache = require("lru-cache");
-//#region src/columns/column_lazy.ts
+//#region src/columns/data_column.ts
 /**
 * Thrown by leaf-recipe factories when the requested column is provably
 * absent in the active render ctx — i.e. every relevant accessor reports
@@ -24,13 +24,15 @@ var ColumnAbsentError = class extends Error {
 	}
 };
 /**
-* ColumnLazy is the leaf-recipe building block: a {@link ColumnRecipe} whose
-* `id` is a bare {@link PObjectId} and whose readers are bound to a single
-* tree-accessor leaf. Layered encodings (Overridden / Discovered / Filtered)
-* are reified through their dedicated recipe classes and reference leaf
-* columns by id.
+* The leaf-recipe building block: a {@link DataColumnRecipe} whose `id` is a bare
+* {@link PObjectId} and whose readers are bound to a single tree-accessor
+* leaf. Layered encodings (Overridden / Discovered / Filtered) are reified
+* through their dedicated recipe classes and reference leaf columns by id.
+*
+* Internal — consumers hold the {@link DataColumnRecipe} interface and construct
+* through the {@link DataColumnRecipe} dispatcher.
 */
-var ColumnLazyImpl = class ColumnLazyImpl {
+var DataColumnImpl = class DataColumnImpl {
 	id;
 	options;
 	specCache;
@@ -55,7 +57,6 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 			column: this.id
 		};
 	}
-	/** Leaf-only: not on the recipe interface — only the leaf can read data directly. */
 	getData() {
 		if (this.dataCache === void 0) this.dataCache = { value: this.options.getData() };
 		return this.dataCache.value;
@@ -66,7 +67,7 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 	}
 	/**
 	* Overlay overrides → produces a {@link ColumnOverriddenRecipe} wrapping
-	* this leaf. ColumnLazy itself stays bare (id remains a plain PObjectId);
+	* this leaf. The leaf itself stays bare (id remains a plain PObjectId);
 	* layering lives entirely in the recipe wrappers.
 	*/
 	withSpecs(overrides) {
@@ -92,7 +93,7 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 			return;
 		}
 		if (!spec.hasData()) return void 0;
-		return new ColumnLazyImpl(id, {
+		return new DataColumnImpl(id, {
 			getSpec: () => spec.getDataAsJson(),
 			getData: () => readDataAccessor(leaf),
 			getDataStatus: () => readDataStatus(leaf)
@@ -100,7 +101,7 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 	}
 	/** {@link PlRef} wrapper over {@link fromId}. */
 	static fromPlRef(ref) {
-		return ColumnLazyImpl.fromId((0, _milaboratories_pl_model_common.createGlobalPObjectId)(ref.blockId, ref.name));
+		return DataColumnImpl.fromId((0, _milaboratories_pl_model_common.createGlobalPObjectId)(ref.blockId, ref.name));
 	}
 	/**
 	* Bind directly to an accessor-backed {@link LeafEntry} — no registry.
@@ -114,7 +115,7 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 			return;
 		}
 		if (!spec.hasData()) return void 0;
-		return new ColumnLazyImpl(entry.id, {
+		return new DataColumnImpl(entry.id, {
 			getSpec: () => spec.getDataAsJson(),
 			getData: () => readDataAccessor(entry),
 			getDataStatus: () => readDataStatus(entry)
@@ -122,13 +123,14 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 	}
 	/**
 	* Wrap a materialised {@link PColumn}. If the input is already a
-	* {@link ColumnLazy} it is returned as-is.
+	* {@link DataColumnRecipe} leaf it is returned as-is.
 	*/
 	static fromColumn(column) {
-		if (column instanceof ColumnLazyImpl) return column;
-		return new ColumnLazyImpl(column.id, {
-			getSpec: () => column.spec,
-			getData: () => column.data,
+		if (column instanceof DataColumnImpl) return column;
+		const pColumn = column;
+		return new DataColumnImpl(pColumn.id, {
+			getSpec: () => pColumn.spec,
+			getData: () => pColumn.data,
 			getDataStatus: () => "present"
 		});
 	}
@@ -146,7 +148,7 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 	}
 	/** {@link PlRef} wrapper over {@link getStatusById}. */
 	static getStatusByPlRef(ref, opts = {}) {
-		return ColumnLazyImpl.getStatusById((0, _milaboratories_pl_model_common.createGlobalPObjectId)(ref.blockId, ref.name), opts);
+		return DataColumnImpl.getStatusById((0, _milaboratories_pl_model_common.createGlobalPObjectId)(ref.blockId, ref.name), opts);
 	}
 	/** No registry — reads straight off the entry's accessor. */
 	static getStatusByAccessor(entry) {
@@ -154,50 +156,51 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 	}
 };
 /**
-* Unified dispatcher — picks the right `ColumnLazyImpl.fromX` by source
+* Unified dispatcher — picks the right `DataColumnImpl.fromX` by source
 * shape. For ambiguous inputs callers can still use the explicit factories
-* (also attached as properties: `ColumnLazy.fromId`, `.fromPlRef`,
+* (also attached as properties: `DataColumn.fromId`, `.fromPlRef`,
 * `.fromAccessor`, `.fromColumn`).
 */
-function ColumnLazyDispatch(source, opts = {}) {
-	if (typeof source === "string") return ColumnLazyImpl.fromId(source, opts);
-	if (source instanceof ColumnLazyImpl) return source;
-	if ("accessor" in source) return ColumnLazyImpl.fromAccessor(source);
-	if ((0, _milaboratories_pl_model_common.isPlRef)(source)) return ColumnLazyImpl.fromPlRef(source);
-	if ((0, _milaboratories_pl_model_common.isPColumn)(source)) return ColumnLazyImpl.fromColumn(source);
-	throw new Error("ColumnLazy: unknown source shape");
+function DataColumnDispatch(source, opts = {}) {
+	if (typeof source === "string") return DataColumnImpl.fromId(source, opts);
+	if (source instanceof DataColumnImpl) return source;
+	const rest = source;
+	if ("accessor" in rest) return DataColumnImpl.fromAccessor(rest);
+	if ((0, _milaboratories_pl_model_common.isPlRef)(rest)) return DataColumnImpl.fromPlRef(rest);
+	if ((0, _milaboratories_pl_model_common.isPColumn)(rest)) return DataColumnImpl.fromColumn(rest);
+	throw new Error("DataColumn: unknown source shape");
 }
 /**
-* Polymorphic counterpart to {@link ColumnLazyDispatch}: returns the
+* Polymorphic counterpart to {@link DataColumnDispatch}: returns the
 * {@link ColumnResolutionStatus} for any factory input without constructing
 * the recipe. For already-materialised sources ({@link PColumn} value,
-* existing {@link ColumnLazy}) status is `present` by construction.
+* existing {@link DataColumnRecipe}) status is `present` by construction.
 */
-function ColumnLazyGetStatus(source, opts = {}) {
-	if (typeof source === "string") return ColumnLazyImpl.getStatusById(source, opts);
-	if (source instanceof ColumnLazyImpl) return "present";
-	if ("accessor" in source) return ColumnLazyImpl.getStatusByAccessor(source);
-	if ((0, _milaboratories_pl_model_common.isPlRef)(source)) return ColumnLazyImpl.getStatusByPlRef(source, opts);
-	if ((0, _milaboratories_pl_model_common.isPColumn)(source)) return "present";
-	throw new Error("ColumnLazy.getStatus: unknown source shape");
+function DataColumnGetStatus(source, opts = {}) {
+	if (typeof source === "string") return DataColumnImpl.getStatusById(source, opts);
+	if (source instanceof DataColumnImpl) return "present";
+	const rest = source;
+	if ("accessor" in rest) return DataColumnImpl.getStatusByAccessor(rest);
+	if ((0, _milaboratories_pl_model_common.isPlRef)(rest)) return DataColumnImpl.getStatusByPlRef(rest, opts);
+	if ((0, _milaboratories_pl_model_common.isPColumn)(rest)) return "present";
+	throw new Error("DataColumn.getStatus: unknown source shape");
 }
-const ColumnLazy = Object.assign(ColumnLazyDispatch, {
-	fromId: ColumnLazyImpl.fromId,
-	fromPlRef: ColumnLazyImpl.fromPlRef,
-	fromAccessor: ColumnLazyImpl.fromAccessor,
-	fromColumn: ColumnLazyImpl.fromColumn,
-	getStatus: ColumnLazyGetStatus,
-	getStatusById: ColumnLazyImpl.getStatusById,
-	getStatusByPlRef: ColumnLazyImpl.getStatusByPlRef,
-	getStatusByAccessor: ColumnLazyImpl.getStatusByAccessor
+const DataColumn = Object.assign(DataColumnDispatch, {
+	fromId: DataColumnImpl.fromId,
+	fromPlRef: DataColumnImpl.fromPlRef,
+	fromAccessor: DataColumnImpl.fromAccessor,
+	fromColumn: DataColumnImpl.fromColumn,
+	getStatus: DataColumnGetStatus,
+	getStatusById: DataColumnImpl.getStatusById,
+	getStatusByPlRef: DataColumnImpl.getStatusByPlRef,
+	getStatusByAccessor: DataColumnImpl.getStatusByAccessor
 });
 /**
-* Type-guard narrowing to the leaf recipe. Prefer this over
-* `instanceof ColumnLazyImpl` — `ColumnLazy` (the value) is the dispatcher
-* with statics, not the class, so `instanceof` requires the impl symbol.
+* Type-guard narrowing to a bare leaf — a {@link DataColumnRecipe} whose `id` is a
+* plain {@link PObjectId}.
 */
-function isColumnLazy(value) {
-	return value instanceof ColumnLazyImpl;
+function isDataColumn(value) {
+	return value instanceof DataColumnImpl;
 }
 const readSpecAccessor = memoizeByEntry(({ accessor, name }) => accessor.traverse({
 	field: `${name}.spec`,
@@ -241,8 +244,8 @@ function memoizeByEntry(fn) {
 }
 //#endregion
 exports.ColumnAbsentError = ColumnAbsentError;
-exports.ColumnLazy = ColumnLazy;
-exports.ColumnLazyImpl = ColumnLazyImpl;
-exports.isColumnLazy = isColumnLazy;
+exports.DataColumn = DataColumn;
+exports.DataColumnImpl = DataColumnImpl;
+exports.isDataColumn = isDataColumn;
 
-//# sourceMappingURL=column_lazy.cjs.map
+//# sourceMappingURL=data_column.cjs.map

package/dist/columns/data_column.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data_column.cjs","names":["ColumnOverriddenRecipe","ColumnRegistry","getCtxProviders","LRUCache"],"sources":["../../src/columns/data_column.ts"],"sourcesContent":["import {\n  ColumnRegistry,\n  createGlobalPObjectId,\n  isPColumn,\n  isPlRef,\n  PlRef,\n  PObjectId,\n  type ColumnUniversalId,\n  type LeafEntry,\n  type PColumn,\n  type PColumnSpec,\n  type SpecOverrides,\n  type SpecQuery,\n} from \"@milaboratories/pl-model-common\";\nimport type { GlobalCfgRenderCtx, PColumnDataUniversal } from \"../render/internal\";\nimport { getCtxProviders } from \"./column_providers\";\nimport { isNil } from \"es-toolkit\";\nimport { LRUCache } from \"lru-cache\";\nimport { TreeNodeAccessor } from \"../render\";\nimport type {\n  ColumnFieldStatus,\n  ColumnRecipe,\n  ColumnRecipeId,\n  ColumnResolutionStatus,\n} from \"./column_recipes/types\";\nimport { ColumnOverriddenRecipe } from \"./column_recipes/column_overrided_recipe\";\n\nexport type DataColumnId = PObjectId;\nexport type ColumnData = undefined | PColumnDataUniversal;\nexport type { ColumnFieldStatus, ColumnResolutionStatus } from \"./column_recipes/types\";\n\n/**\n * A {@link ColumnRecipe} that can be read directly in the sandbox: its\n * {@link getData} is guaranteed to be consistent with {@link getSpec}.\n *\n * This is a *capability*, not a class. Only two recipe shapes carry it — a\n * bare leaf and a spec-override over a bare leaf — because those are the only\n * ones whose data still matches their spec. An axis-filtered recipe drops axes\n * from its spec while the underlying data keeps them, and a discovered recipe\n * only materialises after a join; neither can be read here, so neither\n * implements this interface.\n *\n * Narrow to it with `hasReachableData(recipe)` rather than testing for a concrete\n * class — which recipe classes exist is an implementation detail behind\n * `recipe.id`.\n */\nexport interface DataColumnRecipe<\n  ID extends ColumnRecipeId = ColumnRecipeId,\n> extends ColumnRecipe<ID> {\n  /** Column data, consistent with {@link ColumnRecipe.getSpec}. */\n  getData(): ColumnData;\n}\n\n/**\n * Thrown by leaf-recipe factories when the requested column is provably\n * absent in the active render ctx — i.e. every relevant accessor reports\n * `inputsLocked` and the column did not appear. Distinct from the\n * `undefined` return that the factories still use for the \"resolving\" case\n * (the column may still appear later).\n *\n * Catch at the boundary (resolver / filter+sort wiring / data-table assembly)\n * when partial absence should be surfaced to the user rather than silently\n * producing an empty result.\n */\nexport class ColumnAbsentError extends Error {\n  constructor(public readonly id: ColumnUniversalId) {\n    super(`Column is absent in the active render ctx and will not appear: ${id}`);\n    this.name = \"ColumnAbsentError\";\n  }\n}\n\n/**\n * The leaf-recipe building block: a {@link DataColumnRecipe} whose `id` is a bare\n * {@link PObjectId} and whose readers are bound to a single tree-accessor\n * leaf. Layered encodings (Overridden / Discovered / Filtered) are reified\n * through their dedicated recipe classes and reference leaf columns by id.\n *\n * Internal — consumers hold the {@link DataColumnRecipe} interface and construct\n * through the {@link DataColumnRecipe} dispatcher.\n */\nexport class DataColumnImpl implements DataColumnRecipe<PObjectId> {\n  private specCache?: { readonly value: PColumnSpec };\n  private dataCache?: { readonly value: ColumnData };\n  private dataStatusCache?: { readonly value: ColumnFieldStatus };\n\n  private constructor(\n    public readonly id: PObjectId,\n    private readonly options: {\n      getSpec: () => PColumnSpec;\n      getData: () => ColumnData;\n      getDataStatus: () => ColumnFieldStatus;\n    },\n  ) {}\n\n  /** A leaf-recipe references exactly one column — its own id. */\n  getReferencedIds(): PObjectId[] {\n    return [this.id];\n  }\n\n  getSpec(): PColumnSpec {\n    if (this.specCache === undefined) {\n      this.specCache = { value: this.options.getSpec() };\n    }\n    return this.specCache.value;\n  }\n\n  /** Leaf-shaped — points straight at `this.id`. */\n  getQuery(): SpecQuery {\n    return { type: \"column\", column: this.id } as SpecQuery;\n  }\n\n  getData(): ColumnData {\n    if (this.dataCache === undefined) this.dataCache = { value: this.options.getData() };\n    return this.dataCache.value;\n  }\n\n  getDataStatus(): ColumnFieldStatus {\n    if (this.dataStatusCache === undefined) {\n      this.dataStatusCache = { value: this.options.getDataStatus() };\n    }\n    return this.dataStatusCache.value;\n  }\n\n  /**\n   * Overlay overrides → produces a {@link ColumnOverriddenRecipe} wrapping\n   * this leaf. The leaf itself stays bare (id remains a plain PObjectId);\n   * layering lives entirely in the recipe wrappers.\n   */\n  withSpecs(overrides: SpecOverrides): ColumnRecipe {\n    return ColumnOverriddenRecipe.wrap(this, overrides);\n  }\n\n  /**\n   * Resolve via the ambient {@link ColumnRegistry}. Spec is resolved eagerly:\n   * returns `undefined` if the leaf isn't reachable yet (resolving). Throws\n   * {@link ColumnAbsentError} when every relevant accessor is `inputsLocked`\n   * and the column did not appear — the column will not exist in this ctx.\n   * Data and dataStatus stay lazy.\n   */\n  static fromId(\n    id: PObjectId,\n    { ctx }: { ctx?: GlobalCfgRenderCtx } = {},\n  ): undefined | DataColumnRecipe<PObjectId> {\n    const registry = new ColumnRegistry(getCtxProviders({ ctx }));\n    const leaf = registry.resolve(id);\n    if (isNil(leaf)) {\n      if (registry.isFinal()) throw new ColumnAbsentError(id);\n      return undefined;\n    }\n    const spec = readSpecAccessor(leaf);\n    if (isNil(spec)) {\n      if (leaf.accessor.getInputsLocked()) throw new ColumnAbsentError(id);\n      return undefined;\n    }\n    if (!spec.hasData()) return undefined;\n    return new DataColumnImpl(id, {\n      getSpec: () => spec.getDataAsJson<PColumnSpec>(),\n      getData: () => readDataAccessor(leaf),\n      getDataStatus: () => readDataStatus(leaf),\n    });\n  }\n\n  /** {@link PlRef} wrapper over {@link fromId}. */\n  static fromPlRef(ref: PlRef): undefined | DataColumnRecipe<PObjectId> {\n    return DataColumnImpl.fromId(createGlobalPObjectId(ref.blockId, ref.name));\n  }\n\n  /**\n   * Bind directly to an accessor-backed {@link LeafEntry} — no registry.\n   * Throws {@link ColumnAbsentError} if the leaf has no spec field and its\n   * accessor is `inputsLocked`. Returns `undefined` while still resolving.\n   */\n  static fromAccessor(entry: LeafEntry<TreeNodeAccessor>): undefined | DataColumnRecipe<PObjectId> {\n    const spec = readSpecAccessor(entry);\n    if (isNil(spec)) {\n      if (entry.accessor.getInputsLocked()) throw new ColumnAbsentError(entry.id);\n      return undefined;\n    }\n    if (!spec.hasData()) return undefined;\n    return new DataColumnImpl(entry.id, {\n      getSpec: () => spec.getDataAsJson<PColumnSpec>(),\n      getData: () => readDataAccessor(entry),\n      getDataStatus: () => readDataStatus(entry),\n    });\n  }\n\n  /**\n   * Wrap a materialised {@link PColumn}. If the input is already a\n   * {@link DataColumnRecipe} leaf it is returned as-is.\n   */\n  static fromColumn(\n    column: PColumn<ColumnData> | DataColumnRecipe<PObjectId>,\n  ): DataColumnRecipe<PObjectId> {\n    if (column instanceof DataColumnImpl) return column;\n    // `DataColumnRecipe` is an interface, so `instanceof` above does not remove it\n    // from the union. The only implementation carrying a bare `PObjectId` is\n    // `DataColumnImpl` (wrappers expose `ColumnUniversalId`), so anything\n    // reaching here is a materialised `PColumn`.\n    const pColumn = column as PColumn<ColumnData>;\n    return new DataColumnImpl(pColumn.id, {\n      getSpec: () => pColumn.spec,\n      getData: () => pColumn.data,\n      getDataStatus: () => \"present\",\n    });\n  }\n\n  /**\n   * Distinguishes `present` / `resolving` / `absent` for a {@link PObjectId}\n   * in the active render ctx. Falls back to the registry's `isFinal()`\n   * when the id has no entry — only then we can say `absent` instead of\n   * `resolving`.\n   */\n  static getStatusById(\n    id: PObjectId,\n    { ctx }: { ctx?: GlobalCfgRenderCtx } = {},\n  ): ColumnResolutionStatus {\n    const registry = new ColumnRegistry(getCtxProviders({ ctx }));\n    const leaf = registry.resolve(id);\n    if (isNil(leaf)) return registry.isFinal() ? \"absent\" : \"resolving\";\n    return getLeafEntryStatus(leaf);\n  }\n\n  /** {@link PlRef} wrapper over {@link getStatusById}. */\n  static getStatusByPlRef(\n    ref: PlRef,\n    opts: { ctx?: GlobalCfgRenderCtx } = {},\n  ): ColumnResolutionStatus {\n    return DataColumnImpl.getStatusById(createGlobalPObjectId(ref.blockId, ref.name), opts);\n  }\n\n  /** No registry — reads straight off the entry's accessor. */\n  static getStatusByAccessor(entry: LeafEntry<TreeNodeAccessor>): ColumnResolutionStatus {\n    return getLeafEntryStatus(entry);\n  }\n}\n\n/** Anything the {@link DataColumnRecipe} dispatcher can build a leaf from. */\nexport type DataColumnSource =\n  | PObjectId\n  | PlRef\n  | LeafEntry<TreeNodeAccessor>\n  | PColumn<ColumnData>\n  | DataColumnRecipe<PObjectId>;\n\n/**\n * Unified dispatcher — picks the right `DataColumnImpl.fromX` by source\n * shape. For ambiguous inputs callers can still use the explicit factories\n * (also attached as properties: `DataColumn.fromId`, `.fromPlRef`,\n * `.fromAccessor`, `.fromColumn`).\n */\nfunction DataColumnDispatch(\n  source: DataColumnSource,\n  opts: { ctx?: GlobalCfgRenderCtx } = {},\n): undefined | DataColumnRecipe<PObjectId> {\n  if (typeof source === \"string\") return DataColumnImpl.fromId(source, opts);\n  if (source instanceof DataColumnImpl) return source;\n  // `DataColumnRecipe` is an interface — `instanceof` above cannot remove it from\n  // the union, and only `DataColumnImpl` implements it with a bare id.\n  const rest = source as LeafEntry<TreeNodeAccessor> | PlRef | PColumn<ColumnData>;\n  if (\"accessor\" in rest) return DataColumnImpl.fromAccessor(rest);\n  if (isPlRef(rest)) return DataColumnImpl.fromPlRef(rest);\n  if (isPColumn(rest)) return DataColumnImpl.fromColumn(rest);\n  throw new Error(\"DataColumn: unknown source shape\");\n}\n\n/**\n * Polymorphic counterpart to {@link DataColumnDispatch}: returns the\n * {@link ColumnResolutionStatus} for any factory input without constructing\n * the recipe. For already-materialised sources ({@link PColumn} value,\n * existing {@link DataColumnRecipe}) status is `present` by construction.\n */\nfunction DataColumnGetStatus(\n  source: DataColumnSource,\n  opts: { ctx?: GlobalCfgRenderCtx } = {},\n): ColumnResolutionStatus {\n  if (typeof source === \"string\") return DataColumnImpl.getStatusById(source, opts);\n  if (source instanceof DataColumnImpl) return \"present\";\n  const rest = source as LeafEntry<TreeNodeAccessor> | PlRef | PColumn<ColumnData>;\n  if (\"accessor\" in rest) return DataColumnImpl.getStatusByAccessor(rest);\n  if (isPlRef(rest)) return DataColumnImpl.getStatusByPlRef(rest, opts);\n  if (isPColumn(rest)) return \"present\";\n  throw new Error(\"DataColumn.getStatus: unknown source shape\");\n}\n\nexport const DataColumn = Object.assign(DataColumnDispatch, {\n  fromId: DataColumnImpl.fromId,\n  fromPlRef: DataColumnImpl.fromPlRef,\n  fromAccessor: DataColumnImpl.fromAccessor,\n  fromColumn: DataColumnImpl.fromColumn,\n  getStatus: DataColumnGetStatus,\n  getStatusById: DataColumnImpl.getStatusById,\n  getStatusByPlRef: DataColumnImpl.getStatusByPlRef,\n  getStatusByAccessor: DataColumnImpl.getStatusByAccessor,\n});\n\n/**\n * Type-guard narrowing to a bare leaf — a {@link DataColumnRecipe} whose `id` is a\n * plain {@link PObjectId}.\n */\nexport function isDataColumn(value: unknown): value is DataColumnRecipe<PObjectId> {\n  return value instanceof DataColumnImpl;\n}\n\nconst readSpecAccessor = memoizeByEntry(\n  ({ accessor, name }: LeafEntry<TreeNodeAccessor>): undefined | TreeNodeAccessor =>\n    accessor.traverse({ field: `${name}.spec`, assertFieldType: \"Input\", ignoreError: true }),\n);\n\n/**\n * Per-entry counterpart to {@link readDataStatus}: tells whether the leaf's\n * **spec** can be read in this ctx, and — for the negative cases —\n * distinguishes `resolving` from `absent` via `getInputsLocked()`.\n *\n *  - spec field not yet on the entry's accessor + inputs locked → `absent`\n *  - spec field not yet on the entry's accessor + still resolving → `resolving`\n *  - spec resource present but bytes not yet written → `resolving`\n *    (transient — the spec resource is connected, just unfilled)\n *  - spec resource present and `hasData()` → `present`\n */\nfunction getLeafEntryStatus(entry: LeafEntry<TreeNodeAccessor>): ColumnResolutionStatus {\n  const spec = readSpecAccessor(entry);\n  if (isNil(spec)) return entry.accessor.getInputsLocked() ? \"absent\" : \"resolving\";\n  if (!spec.hasData()) return \"resolving\";\n  return \"present\";\n}\n\nconst readDataAccessor = memoizeByEntry(\n  ({ accessor, name }: LeafEntry<TreeNodeAccessor>): undefined | TreeNodeAccessor =>\n    accessor.traverse({ field: `${name}.data`, assertFieldType: \"Input\", ignoreError: true }),\n);\n\nconst readDataStatus = memoizeByEntry(\n  ({ accessor, name }: LeafEntry<TreeNodeAccessor>): ColumnFieldStatus => {\n    if (accessor.listInputFields().includes(`${name}.data`)) return \"present\";\n    return accessor.getInputsLocked() ? \"absent\" : \"resolving\";\n  },\n);\n\nfunction memoizeByEntry<R>(\n  fn: (entry: LeafEntry<TreeNodeAccessor>) => R,\n): (entry: LeafEntry<TreeNodeAccessor>) => R {\n  const cache = new LRUCache<string, { value: R }>({ max: 1000 });\n  return (entry) => {\n    const key = `${entry.accessor.handle}:${entry.name}`;\n    let hit = cache.get(key);\n    if (!hit) cache.set(key, (hit = { value: fn(entry) }));\n    return hit.value;\n  };\n}\n"],"mappings":"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"}

package/dist/columns/data_column.d.ts

@@ -0,0 +1,152 @@
+import { GlobalCfgRenderCtx, PColumnDataUniversal } from "../render/internal.js";
+import { TreeNodeAccessor } from "../render/accessor.js";
+import { ColumnFieldStatus, ColumnRecipe, ColumnRecipeId, ColumnResolutionStatus } from "./column_recipes/types.js";
+import { ColumnUniversalId, LeafEntry, PColumn, PColumnSpec, PObjectId, PlRef, SpecOverrides, SpecQuery } from "@milaboratories/pl-model-common";
+
+//#region src/columns/data_column.d.ts
+type DataColumnId = PObjectId;
+type ColumnData = undefined | PColumnDataUniversal;
+/**
+ * A {@link ColumnRecipe} that can be read directly in the sandbox: its
+ * {@link getData} is guaranteed to be consistent with {@link getSpec}.
+ *
+ * This is a *capability*, not a class. Only two recipe shapes carry it — a
+ * bare leaf and a spec-override over a bare leaf — because those are the only
+ * ones whose data still matches their spec. An axis-filtered recipe drops axes
+ * from its spec while the underlying data keeps them, and a discovered recipe
+ * only materialises after a join; neither can be read here, so neither
+ * implements this interface.
+ *
+ * Narrow to it with `hasReachableData(recipe)` rather than testing for a concrete
+ * class — which recipe classes exist is an implementation detail behind
+ * `recipe.id`.
+ */
+interface DataColumnRecipe<ID extends ColumnRecipeId = ColumnRecipeId> extends ColumnRecipe<ID> {
+  /** Column data, consistent with {@link ColumnRecipe.getSpec}. */
+  getData(): ColumnData;
+}
+/**
+ * Thrown by leaf-recipe factories when the requested column is provably
+ * absent in the active render ctx — i.e. every relevant accessor reports
+ * `inputsLocked` and the column did not appear. Distinct from the
+ * `undefined` return that the factories still use for the "resolving" case
+ * (the column may still appear later).
+ *
+ * Catch at the boundary (resolver / filter+sort wiring / data-table assembly)
+ * when partial absence should be surfaced to the user rather than silently
+ * producing an empty result.
+ */
+declare class ColumnAbsentError extends Error {
+  readonly id: ColumnUniversalId;
+  constructor(id: ColumnUniversalId);
+}
+/**
+ * The leaf-recipe building block: a {@link DataColumnRecipe} whose `id` is a bare
+ * {@link PObjectId} and whose readers are bound to a single tree-accessor
+ * leaf. Layered encodings (Overridden / Discovered / Filtered) are reified
+ * through their dedicated recipe classes and reference leaf columns by id.
+ *
+ * Internal — consumers hold the {@link DataColumnRecipe} interface and construct
+ * through the {@link DataColumnRecipe} dispatcher.
+ */
+declare class DataColumnImpl implements DataColumnRecipe<PObjectId> {
+  readonly id: PObjectId;
+  private readonly options;
+  private specCache?;
+  private dataCache?;
+  private dataStatusCache?;
+  private constructor();
+  /** A leaf-recipe references exactly one column — its own id. */
+  getReferencedIds(): PObjectId[];
+  getSpec(): PColumnSpec;
+  /** Leaf-shaped — points straight at `this.id`. */
+  getQuery(): SpecQuery;
+  getData(): ColumnData;
+  getDataStatus(): ColumnFieldStatus;
+  /**
+   * Overlay overrides → produces a {@link ColumnOverriddenRecipe} wrapping
+   * this leaf. The leaf itself stays bare (id remains a plain PObjectId);
+   * layering lives entirely in the recipe wrappers.
+   */
+  withSpecs(overrides: SpecOverrides): ColumnRecipe;
+  /**
+   * Resolve via the ambient {@link ColumnRegistry}. Spec is resolved eagerly:
+   * returns `undefined` if the leaf isn't reachable yet (resolving). Throws
+   * {@link ColumnAbsentError} when every relevant accessor is `inputsLocked`
+   * and the column did not appear — the column will not exist in this ctx.
+   * Data and dataStatus stay lazy.
+   */
+  static fromId(id: PObjectId, {
+    ctx
+  }?: {
+    ctx?: GlobalCfgRenderCtx;
+  }): undefined | DataColumnRecipe<PObjectId>;
+  /** {@link PlRef} wrapper over {@link fromId}. */
+  static fromPlRef(ref: PlRef): undefined | DataColumnRecipe<PObjectId>;
+  /**
+   * Bind directly to an accessor-backed {@link LeafEntry} — no registry.
+   * Throws {@link ColumnAbsentError} if the leaf has no spec field and its
+   * accessor is `inputsLocked`. Returns `undefined` while still resolving.
+   */
+  static fromAccessor(entry: LeafEntry<TreeNodeAccessor>): undefined | DataColumnRecipe<PObjectId>;
+  /**
+   * Wrap a materialised {@link PColumn}. If the input is already a
+   * {@link DataColumnRecipe} leaf it is returned as-is.
+   */
+  static fromColumn(column: PColumn<ColumnData> | DataColumnRecipe<PObjectId>): DataColumnRecipe<PObjectId>;
+  /**
+   * Distinguishes `present` / `resolving` / `absent` for a {@link PObjectId}
+   * in the active render ctx. Falls back to the registry's `isFinal()`
+   * when the id has no entry — only then we can say `absent` instead of
+   * `resolving`.
+   */
+  static getStatusById(id: PObjectId, {
+    ctx
+  }?: {
+    ctx?: GlobalCfgRenderCtx;
+  }): ColumnResolutionStatus;
+  /** {@link PlRef} wrapper over {@link getStatusById}. */
+  static getStatusByPlRef(ref: PlRef, opts?: {
+    ctx?: GlobalCfgRenderCtx;
+  }): ColumnResolutionStatus;
+  /** No registry — reads straight off the entry's accessor. */
+  static getStatusByAccessor(entry: LeafEntry<TreeNodeAccessor>): ColumnResolutionStatus;
+}
+/** Anything the {@link DataColumnRecipe} dispatcher can build a leaf from. */
+type DataColumnSource = PObjectId | PlRef | LeafEntry<TreeNodeAccessor> | PColumn<ColumnData> | DataColumnRecipe<PObjectId>;
+/**
+ * Unified dispatcher — picks the right `DataColumnImpl.fromX` by source
+ * shape. For ambiguous inputs callers can still use the explicit factories
+ * (also attached as properties: `DataColumn.fromId`, `.fromPlRef`,
+ * `.fromAccessor`, `.fromColumn`).
+ */
+declare function DataColumnDispatch(source: DataColumnSource, opts?: {
+  ctx?: GlobalCfgRenderCtx;
+}): undefined | DataColumnRecipe<PObjectId>;
+/**
+ * Polymorphic counterpart to {@link DataColumnDispatch}: returns the
+ * {@link ColumnResolutionStatus} for any factory input without constructing
+ * the recipe. For already-materialised sources ({@link PColumn} value,
+ * existing {@link DataColumnRecipe}) status is `present` by construction.
+ */
+declare function DataColumnGetStatus(source: DataColumnSource, opts?: {
+  ctx?: GlobalCfgRenderCtx;
+}): ColumnResolutionStatus;
+declare const DataColumn: typeof DataColumnDispatch & {
+  fromId: typeof DataColumnImpl.fromId;
+  fromPlRef: typeof DataColumnImpl.fromPlRef;
+  fromAccessor: typeof DataColumnImpl.fromAccessor;
+  fromColumn: typeof DataColumnImpl.fromColumn;
+  getStatus: typeof DataColumnGetStatus;
+  getStatusById: typeof DataColumnImpl.getStatusById;
+  getStatusByPlRef: typeof DataColumnImpl.getStatusByPlRef;
+  getStatusByAccessor: typeof DataColumnImpl.getStatusByAccessor;
+};
+/**
+ * Type-guard narrowing to a bare leaf — a {@link DataColumnRecipe} whose `id` is a
+ * plain {@link PObjectId}.
+ */
+declare function isDataColumn(value: unknown): value is DataColumnRecipe<PObjectId>;
+//#endregion
+export { ColumnAbsentError, ColumnData, type ColumnFieldStatus, type ColumnResolutionStatus, DataColumn, DataColumnId, DataColumnImpl, DataColumnRecipe, DataColumnSource, isDataColumn };
+//# sourceMappingURL=data_column.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data_column.d.ts","names":[],"sources":["../../src/columns/data_column.ts"],"mappings":";;;;;;KA2BY,YAAA,GAAe,SAAS;AAAA,KACxB,UAAA,eAAyB,oBAAoB;AADzD;;;;AAAoC;AACpC;;;;AAAyD;AAkBzD;;;;;AAnBA,UAmBiB,gBAAA,YACJ,cAAA,GAAiB,cAAA,UACpB,YAAA,CAAa,EAAA;EAEV;EAAX,OAAA,IAAW,UAAA;AAAA;;;;;;;;;;AAAU;AAcvB;cAAa,iBAAA,SAA0B,KAAA;EAAA,SACT,EAAA,EAAI,iBAAA;cAAJ,EAAA,EAAI,iBAAA;AAAA;;;;;;;;;;cAerB,cAAA,YAA0B,gBAAA,CAAiB,SAAA;EAAA,SAMpC,EAAA,EAAI,SAAA;EAAA,iBACH,OAAA;EAAA,QANX,SAAA;EAAA,QACA,SAAA;EAAA,QACA,eAAA;EAAA,QAED,WAAA;EAUa;EAApB,gBAAA,IAAoB,SAAA;EAIpB,OAAA,IAAW,WAAA;EAYA;EAJX,QAAA,IAAY,SAAA;EAIZ,OAAA,IAAW,UAAA;EAKX,aAAA,IAAiB,iBAAA;EAwBX;;;;;EAZN,SAAA,CAAU,SAAA,EAAW,aAAA,GAAgB,YAAA;EAmCsB;;;;;;;EAAA,OAxBpD,MAAA,CACL,EAAA,EAAI,SAAA;IACF;EAAA;IAAS,GAAA,GAAM,kBAAA;EAAA,gBACJ,gBAAA,CAAiB,SAAA;EAkDZ;EAAA,OA7Bb,SAAA,CAAU,GAAA,EAAK,KAAA,eAAoB,gBAAA,CAAiB,SAAA;EAkDrD;;;;;EAAA,OAzCC,YAAA,CAAa,KAAA,EAAO,SAAA,CAAU,gBAAA,gBAAgC,gBAAA,CAAiB,SAAA;EAsDnF;;;;EAAA,OApCI,UAAA,CACL,MAAA,EAAQ,OAAA,CAAQ,UAAA,IAAc,gBAAA,CAAiB,SAAA,IAC9C,gBAAA,CAAiB,SAAA;EAhHiC;;;;;;EAAA,OAoI9C,aAAA,CACL,EAAA,EAAI,SAAA;IACF;EAAA;IAAS,GAAA,GAAM,kBAAA;EAAA,IAChB,sBAAA;EApIK;EAAA,OA4ID,gBAAA,CACL,GAAA,EAAK,KAAA,EACL,IAAA;IAAQ,GAAA,GAAM,kBAAA;EAAA,IACb,sBAAA;EA/HH;EAAA,OAoIO,mBAAA,CAAoB,KAAA,EAAO,SAAA,CAAU,gBAAA,IAAoB,sBAAA;AAAA;;KAMtD,gBAAA,GACR,SAAA,GACA,KAAA,GACA,SAAA,CAAU,gBAAA,IACV,OAAA,CAAQ,UAAA,IACR,gBAAA,CAAiB,SAAA;;;;;;;iBAQZ,kBAAA,CACP,MAAA,EAAQ,gBAAA,EACR,IAAA;EAAQ,GAAA,GAAM,kBAAA;AAAA,gBACD,gBAAA,CAAiB,SAAA;;;;;;;iBAkBvB,mBAAA,CACP,MAAA,EAAQ,gBAAA,EACR,IAAA;EAAQ,GAAA,GAAM,kBAAA;AAAA,IACb,sBAAA;AAAA,cAUU,UAAA,SAAU,kBAAA;;;;;;;;;;;;;;iBAeP,YAAA,CAAa,KAAA,YAAiB,KAAA,IAAS,gBAAgB,CAAC,SAAA"}

package/dist/columns/{column_lazy.js → data_column.js}

@@ -3,7 +3,7 @@ import { getCtxProviders } from "./column_providers/index.js";
 import { ColumnRegistry, createGlobalPObjectId, isPColumn, isPlRef } from "@milaboratories/pl-model-common";
 import { isNil } from "es-toolkit";
 import { LRUCache } from "lru-cache";
-//#region src/columns/column_lazy.ts
+//#region src/columns/data_column.ts
 /**
 * Thrown by leaf-recipe factories when the requested column is provably
 * absent in the active render ctx — i.e. every relevant accessor reports
@@ -24,13 +24,15 @@ var ColumnAbsentError = class extends Error {
 	}
 };
 /**
-* ColumnLazy is the leaf-recipe building block: a {@link ColumnRecipe} whose
-* `id` is a bare {@link PObjectId} and whose readers are bound to a single
-* tree-accessor leaf. Layered encodings (Overridden / Discovered / Filtered)
-* are reified through their dedicated recipe classes and reference leaf
-* columns by id.
+* The leaf-recipe building block: a {@link DataColumnRecipe} whose `id` is a bare
+* {@link PObjectId} and whose readers are bound to a single tree-accessor
+* leaf. Layered encodings (Overridden / Discovered / Filtered) are reified
+* through their dedicated recipe classes and reference leaf columns by id.
+*
+* Internal — consumers hold the {@link DataColumnRecipe} interface and construct
+* through the {@link DataColumnRecipe} dispatcher.
 */
-var ColumnLazyImpl = class ColumnLazyImpl {
+var DataColumnImpl = class DataColumnImpl {
 	id;
 	options;
 	specCache;
@@ -55,7 +57,6 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 			column: this.id
 		};
 	}
-	/** Leaf-only: not on the recipe interface — only the leaf can read data directly. */
 	getData() {
 		if (this.dataCache === void 0) this.dataCache = { value: this.options.getData() };
 		return this.dataCache.value;
@@ -66,7 +67,7 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 	}
 	/**
 	* Overlay overrides → produces a {@link ColumnOverriddenRecipe} wrapping
-	* this leaf. ColumnLazy itself stays bare (id remains a plain PObjectId);
+	* this leaf. The leaf itself stays bare (id remains a plain PObjectId);
 	* layering lives entirely in the recipe wrappers.
 	*/
 	withSpecs(overrides) {
@@ -92,7 +93,7 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 			return;
 		}
 		if (!spec.hasData()) return void 0;
-		return new ColumnLazyImpl(id, {
+		return new DataColumnImpl(id, {
 			getSpec: () => spec.getDataAsJson(),
 			getData: () => readDataAccessor(leaf),
 			getDataStatus: () => readDataStatus(leaf)
@@ -100,7 +101,7 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 	}
 	/** {@link PlRef} wrapper over {@link fromId}. */
 	static fromPlRef(ref) {
-		return ColumnLazyImpl.fromId(createGlobalPObjectId(ref.blockId, ref.name));
+		return DataColumnImpl.fromId(createGlobalPObjectId(ref.blockId, ref.name));
 	}
 	/**
 	* Bind directly to an accessor-backed {@link LeafEntry} — no registry.
@@ -114,7 +115,7 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 			return;
 		}
 		if (!spec.hasData()) return void 0;
-		return new ColumnLazyImpl(entry.id, {
+		return new DataColumnImpl(entry.id, {
 			getSpec: () => spec.getDataAsJson(),
 			getData: () => readDataAccessor(entry),
 			getDataStatus: () => readDataStatus(entry)
@@ -122,13 +123,14 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 	}
 	/**
 	* Wrap a materialised {@link PColumn}. If the input is already a
-	* {@link ColumnLazy} it is returned as-is.
+	* {@link DataColumnRecipe} leaf it is returned as-is.
 	*/
 	static fromColumn(column) {
-		if (column instanceof ColumnLazyImpl) return column;
-		return new ColumnLazyImpl(column.id, {
-			getSpec: () => column.spec,
-			getData: () => column.data,
+		if (column instanceof DataColumnImpl) return column;
+		const pColumn = column;
+		return new DataColumnImpl(pColumn.id, {
+			getSpec: () => pColumn.spec,
+			getData: () => pColumn.data,
 			getDataStatus: () => "present"
 		});
 	}
@@ -146,7 +148,7 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 	}
 	/** {@link PlRef} wrapper over {@link getStatusById}. */
 	static getStatusByPlRef(ref, opts = {}) {
-		return ColumnLazyImpl.getStatusById(createGlobalPObjectId(ref.blockId, ref.name), opts);
+		return DataColumnImpl.getStatusById(createGlobalPObjectId(ref.blockId, ref.name), opts);
 	}
 	/** No registry — reads straight off the entry's accessor. */
 	static getStatusByAccessor(entry) {
@@ -154,50 +156,51 @@ var ColumnLazyImpl = class ColumnLazyImpl {
 	}
 };
 /**
-* Unified dispatcher — picks the right `ColumnLazyImpl.fromX` by source
+* Unified dispatcher — picks the right `DataColumnImpl.fromX` by source
 * shape. For ambiguous inputs callers can still use the explicit factories
-* (also attached as properties: `ColumnLazy.fromId`, `.fromPlRef`,
+* (also attached as properties: `DataColumn.fromId`, `.fromPlRef`,
 * `.fromAccessor`, `.fromColumn`).
 */
-function ColumnLazyDispatch(source, opts = {}) {
-	if (typeof source === "string") return ColumnLazyImpl.fromId(source, opts);
-	if (source instanceof ColumnLazyImpl) return source;
-	if ("accessor" in source) return ColumnLazyImpl.fromAccessor(source);
-	if (isPlRef(source)) return ColumnLazyImpl.fromPlRef(source);
-	if (isPColumn(source)) return ColumnLazyImpl.fromColumn(source);
-	throw new Error("ColumnLazy: unknown source shape");
+function DataColumnDispatch(source, opts = {}) {
+	if (typeof source === "string") return DataColumnImpl.fromId(source, opts);
+	if (source instanceof DataColumnImpl) return source;
+	const rest = source;
+	if ("accessor" in rest) return DataColumnImpl.fromAccessor(rest);
+	if (isPlRef(rest)) return DataColumnImpl.fromPlRef(rest);
+	if (isPColumn(rest)) return DataColumnImpl.fromColumn(rest);
+	throw new Error("DataColumn: unknown source shape");
 }
 /**
-* Polymorphic counterpart to {@link ColumnLazyDispatch}: returns the
+* Polymorphic counterpart to {@link DataColumnDispatch}: returns the
 * {@link ColumnResolutionStatus} for any factory input without constructing
 * the recipe. For already-materialised sources ({@link PColumn} value,
-* existing {@link ColumnLazy}) status is `present` by construction.
+* existing {@link DataColumnRecipe}) status is `present` by construction.
 */
-function ColumnLazyGetStatus(source, opts = {}) {
-	if (typeof source === "string") return ColumnLazyImpl.getStatusById(source, opts);
-	if (source instanceof ColumnLazyImpl) return "present";
-	if ("accessor" in source) return ColumnLazyImpl.getStatusByAccessor(source);
-	if (isPlRef(source)) return ColumnLazyImpl.getStatusByPlRef(source, opts);
-	if (isPColumn(source)) return "present";
-	throw new Error("ColumnLazy.getStatus: unknown source shape");
+function DataColumnGetStatus(source, opts = {}) {
+	if (typeof source === "string") return DataColumnImpl.getStatusById(source, opts);
+	if (source instanceof DataColumnImpl) return "present";
+	const rest = source;
+	if ("accessor" in rest) return DataColumnImpl.getStatusByAccessor(rest);
+	if (isPlRef(rest)) return DataColumnImpl.getStatusByPlRef(rest, opts);
+	if (isPColumn(rest)) return "present";
+	throw new Error("DataColumn.getStatus: unknown source shape");
 }
-const ColumnLazy = Object.assign(ColumnLazyDispatch, {
-	fromId: ColumnLazyImpl.fromId,
-	fromPlRef: ColumnLazyImpl.fromPlRef,
-	fromAccessor: ColumnLazyImpl.fromAccessor,
-	fromColumn: ColumnLazyImpl.fromColumn,
-	getStatus: ColumnLazyGetStatus,
-	getStatusById: ColumnLazyImpl.getStatusById,
-	getStatusByPlRef: ColumnLazyImpl.getStatusByPlRef,
-	getStatusByAccessor: ColumnLazyImpl.getStatusByAccessor
+const DataColumn = Object.assign(DataColumnDispatch, {
+	fromId: DataColumnImpl.fromId,
+	fromPlRef: DataColumnImpl.fromPlRef,
+	fromAccessor: DataColumnImpl.fromAccessor,
+	fromColumn: DataColumnImpl.fromColumn,
+	getStatus: DataColumnGetStatus,
+	getStatusById: DataColumnImpl.getStatusById,
+	getStatusByPlRef: DataColumnImpl.getStatusByPlRef,
+	getStatusByAccessor: DataColumnImpl.getStatusByAccessor
 });
 /**
-* Type-guard narrowing to the leaf recipe. Prefer this over
-* `instanceof ColumnLazyImpl` — `ColumnLazy` (the value) is the dispatcher
-* with statics, not the class, so `instanceof` requires the impl symbol.
+* Type-guard narrowing to a bare leaf — a {@link DataColumnRecipe} whose `id` is a
+* plain {@link PObjectId}.
 */
-function isColumnLazy(value) {
-	return value instanceof ColumnLazyImpl;
+function isDataColumn(value) {
+	return value instanceof DataColumnImpl;
 }
 const readSpecAccessor = memoizeByEntry(({ accessor, name }) => accessor.traverse({
 	field: `${name}.spec`,
@@ -240,6 +243,6 @@ function memoizeByEntry(fn) {
 	};
 }
 //#endregion
-export { ColumnAbsentError, ColumnLazy, ColumnLazyImpl, isColumnLazy };
+export { ColumnAbsentError, DataColumn, DataColumnImpl, isDataColumn };
 
-//# sourceMappingURL=column_lazy.js.map
+//# sourceMappingURL=data_column.js.map

package/dist/columns/data_column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data_column.js","names":[],"sources":["../../src/columns/data_column.ts"],"sourcesContent":["import {\n  ColumnRegistry,\n  createGlobalPObjectId,\n  isPColumn,\n  isPlRef,\n  PlRef,\n  PObjectId,\n  type ColumnUniversalId,\n  type LeafEntry,\n  type PColumn,\n  type PColumnSpec,\n  type SpecOverrides,\n  type SpecQuery,\n} from \"@milaboratories/pl-model-common\";\nimport type { GlobalCfgRenderCtx, PColumnDataUniversal } from \"../render/internal\";\nimport { getCtxProviders } from \"./column_providers\";\nimport { isNil } from \"es-toolkit\";\nimport { LRUCache } from \"lru-cache\";\nimport { TreeNodeAccessor } from \"../render\";\nimport type {\n  ColumnFieldStatus,\n  ColumnRecipe,\n  ColumnRecipeId,\n  ColumnResolutionStatus,\n} from \"./column_recipes/types\";\nimport { ColumnOverriddenRecipe } from \"./column_recipes/column_overrided_recipe\";\n\nexport type DataColumnId = PObjectId;\nexport type ColumnData = undefined | PColumnDataUniversal;\nexport type { ColumnFieldStatus, ColumnResolutionStatus } from \"./column_recipes/types\";\n\n/**\n * A {@link ColumnRecipe} that can be read directly in the sandbox: its\n * {@link getData} is guaranteed to be consistent with {@link getSpec}.\n *\n * This is a *capability*, not a class. Only two recipe shapes carry it — a\n * bare leaf and a spec-override over a bare leaf — because those are the only\n * ones whose data still matches their spec. An axis-filtered recipe drops axes\n * from its spec while the underlying data keeps them, and a discovered recipe\n * only materialises after a join; neither can be read here, so neither\n * implements this interface.\n *\n * Narrow to it with `hasReachableData(recipe)` rather than testing for a concrete\n * class — which recipe classes exist is an implementation detail behind\n * `recipe.id`.\n */\nexport interface DataColumnRecipe<\n  ID extends ColumnRecipeId = ColumnRecipeId,\n> extends ColumnRecipe<ID> {\n  /** Column data, consistent with {@link ColumnRecipe.getSpec}. */\n  getData(): ColumnData;\n}\n\n/**\n * Thrown by leaf-recipe factories when the requested column is provably\n * absent in the active render ctx — i.e. every relevant accessor reports\n * `inputsLocked` and the column did not appear. Distinct from the\n * `undefined` return that the factories still use for the \"resolving\" case\n * (the column may still appear later).\n *\n * Catch at the boundary (resolver / filter+sort wiring / data-table assembly)\n * when partial absence should be surfaced to the user rather than silently\n * producing an empty result.\n */\nexport class ColumnAbsentError extends Error {\n  constructor(public readonly id: ColumnUniversalId) {\n    super(`Column is absent in the active render ctx and will not appear: ${id}`);\n    this.name = \"ColumnAbsentError\";\n  }\n}\n\n/**\n * The leaf-recipe building block: a {@link DataColumnRecipe} whose `id` is a bare\n * {@link PObjectId} and whose readers are bound to a single tree-accessor\n * leaf. Layered encodings (Overridden / Discovered / Filtered) are reified\n * through their dedicated recipe classes and reference leaf columns by id.\n *\n * Internal — consumers hold the {@link DataColumnRecipe} interface and construct\n * through the {@link DataColumnRecipe} dispatcher.\n */\nexport class DataColumnImpl implements DataColumnRecipe<PObjectId> {\n  private specCache?: { readonly value: PColumnSpec };\n  private dataCache?: { readonly value: ColumnData };\n  private dataStatusCache?: { readonly value: ColumnFieldStatus };\n\n  private constructor(\n    public readonly id: PObjectId,\n    private readonly options: {\n      getSpec: () => PColumnSpec;\n      getData: () => ColumnData;\n      getDataStatus: () => ColumnFieldStatus;\n    },\n  ) {}\n\n  /** A leaf-recipe references exactly one column — its own id. */\n  getReferencedIds(): PObjectId[] {\n    return [this.id];\n  }\n\n  getSpec(): PColumnSpec {\n    if (this.specCache === undefined) {\n      this.specCache = { value: this.options.getSpec() };\n    }\n    return this.specCache.value;\n  }\n\n  /** Leaf-shaped — points straight at `this.id`. */\n  getQuery(): SpecQuery {\n    return { type: \"column\", column: this.id } as SpecQuery;\n  }\n\n  getData(): ColumnData {\n    if (this.dataCache === undefined) this.dataCache = { value: this.options.getData() };\n    return this.dataCache.value;\n  }\n\n  getDataStatus(): ColumnFieldStatus {\n    if (this.dataStatusCache === undefined) {\n      this.dataStatusCache = { value: this.options.getDataStatus() };\n    }\n    return this.dataStatusCache.value;\n  }\n\n  /**\n   * Overlay overrides → produces a {@link ColumnOverriddenRecipe} wrapping\n   * this leaf. The leaf itself stays bare (id remains a plain PObjectId);\n   * layering lives entirely in the recipe wrappers.\n   */\n  withSpecs(overrides: SpecOverrides): ColumnRecipe {\n    return ColumnOverriddenRecipe.wrap(this, overrides);\n  }\n\n  /**\n   * Resolve via the ambient {@link ColumnRegistry}. Spec is resolved eagerly:\n   * returns `undefined` if the leaf isn't reachable yet (resolving). Throws\n   * {@link ColumnAbsentError} when every relevant accessor is `inputsLocked`\n   * and the column did not appear — the column will not exist in this ctx.\n   * Data and dataStatus stay lazy.\n   */\n  static fromId(\n    id: PObjectId,\n    { ctx }: { ctx?: GlobalCfgRenderCtx } = {},\n  ): undefined | DataColumnRecipe<PObjectId> {\n    const registry = new ColumnRegistry(getCtxProviders({ ctx }));\n    const leaf = registry.resolve(id);\n    if (isNil(leaf)) {\n      if (registry.isFinal()) throw new ColumnAbsentError(id);\n      return undefined;\n    }\n    const spec = readSpecAccessor(leaf);\n    if (isNil(spec)) {\n      if (leaf.accessor.getInputsLocked()) throw new ColumnAbsentError(id);\n      return undefined;\n    }\n    if (!spec.hasData()) return undefined;\n    return new DataColumnImpl(id, {\n      getSpec: () => spec.getDataAsJson<PColumnSpec>(),\n      getData: () => readDataAccessor(leaf),\n      getDataStatus: () => readDataStatus(leaf),\n    });\n  }\n\n  /** {@link PlRef} wrapper over {@link fromId}. */\n  static fromPlRef(ref: PlRef): undefined | DataColumnRecipe<PObjectId> {\n    return DataColumnImpl.fromId(createGlobalPObjectId(ref.blockId, ref.name));\n  }\n\n  /**\n   * Bind directly to an accessor-backed {@link LeafEntry} — no registry.\n   * Throws {@link ColumnAbsentError} if the leaf has no spec field and its\n   * accessor is `inputsLocked`. Returns `undefined` while still resolving.\n   */\n  static fromAccessor(entry: LeafEntry<TreeNodeAccessor>): undefined | DataColumnRecipe<PObjectId> {\n    const spec = readSpecAccessor(entry);\n    if (isNil(spec)) {\n      if (entry.accessor.getInputsLocked()) throw new ColumnAbsentError(entry.id);\n      return undefined;\n    }\n    if (!spec.hasData()) return undefined;\n    return new DataColumnImpl(entry.id, {\n      getSpec: () => spec.getDataAsJson<PColumnSpec>(),\n      getData: () => readDataAccessor(entry),\n      getDataStatus: () => readDataStatus(entry),\n    });\n  }\n\n  /**\n   * Wrap a materialised {@link PColumn}. If the input is already a\n   * {@link DataColumnRecipe} leaf it is returned as-is.\n   */\n  static fromColumn(\n    column: PColumn<ColumnData> | DataColumnRecipe<PObjectId>,\n  ): DataColumnRecipe<PObjectId> {\n    if (column instanceof DataColumnImpl) return column;\n    // `DataColumnRecipe` is an interface, so `instanceof` above does not remove it\n    // from the union. The only implementation carrying a bare `PObjectId` is\n    // `DataColumnImpl` (wrappers expose `ColumnUniversalId`), so anything\n    // reaching here is a materialised `PColumn`.\n    const pColumn = column as PColumn<ColumnData>;\n    return new DataColumnImpl(pColumn.id, {\n      getSpec: () => pColumn.spec,\n      getData: () => pColumn.data,\n      getDataStatus: () => \"present\",\n    });\n  }\n\n  /**\n   * Distinguishes `present` / `resolving` / `absent` for a {@link PObjectId}\n   * in the active render ctx. Falls back to the registry's `isFinal()`\n   * when the id has no entry — only then we can say `absent` instead of\n   * `resolving`.\n   */\n  static getStatusById(\n    id: PObjectId,\n    { ctx }: { ctx?: GlobalCfgRenderCtx } = {},\n  ): ColumnResolutionStatus {\n    const registry = new ColumnRegistry(getCtxProviders({ ctx }));\n    const leaf = registry.resolve(id);\n    if (isNil(leaf)) return registry.isFinal() ? \"absent\" : \"resolving\";\n    return getLeafEntryStatus(leaf);\n  }\n\n  /** {@link PlRef} wrapper over {@link getStatusById}. */\n  static getStatusByPlRef(\n    ref: PlRef,\n    opts: { ctx?: GlobalCfgRenderCtx } = {},\n  ): ColumnResolutionStatus {\n    return DataColumnImpl.getStatusById(createGlobalPObjectId(ref.blockId, ref.name), opts);\n  }\n\n  /** No registry — reads straight off the entry's accessor. */\n  static getStatusByAccessor(entry: LeafEntry<TreeNodeAccessor>): ColumnResolutionStatus {\n    return getLeafEntryStatus(entry);\n  }\n}\n\n/** Anything the {@link DataColumnRecipe} dispatcher can build a leaf from. */\nexport type DataColumnSource =\n  | PObjectId\n  | PlRef\n  | LeafEntry<TreeNodeAccessor>\n  | PColumn<ColumnData>\n  | DataColumnRecipe<PObjectId>;\n\n/**\n * Unified dispatcher — picks the right `DataColumnImpl.fromX` by source\n * shape. For ambiguous inputs callers can still use the explicit factories\n * (also attached as properties: `DataColumn.fromId`, `.fromPlRef`,\n * `.fromAccessor`, `.fromColumn`).\n */\nfunction DataColumnDispatch(\n  source: DataColumnSource,\n  opts: { ctx?: GlobalCfgRenderCtx } = {},\n): undefined | DataColumnRecipe<PObjectId> {\n  if (typeof source === \"string\") return DataColumnImpl.fromId(source, opts);\n  if (source instanceof DataColumnImpl) return source;\n  // `DataColumnRecipe` is an interface — `instanceof` above cannot remove it from\n  // the union, and only `DataColumnImpl` implements it with a bare id.\n  const rest = source as LeafEntry<TreeNodeAccessor> | PlRef | PColumn<ColumnData>;\n  if (\"accessor\" in rest) return DataColumnImpl.fromAccessor(rest);\n  if (isPlRef(rest)) return DataColumnImpl.fromPlRef(rest);\n  if (isPColumn(rest)) return DataColumnImpl.fromColumn(rest);\n  throw new Error(\"DataColumn: unknown source shape\");\n}\n\n/**\n * Polymorphic counterpart to {@link DataColumnDispatch}: returns the\n * {@link ColumnResolutionStatus} for any factory input without constructing\n * the recipe. For already-materialised sources ({@link PColumn} value,\n * existing {@link DataColumnRecipe}) status is `present` by construction.\n */\nfunction DataColumnGetStatus(\n  source: DataColumnSource,\n  opts: { ctx?: GlobalCfgRenderCtx } = {},\n): ColumnResolutionStatus {\n  if (typeof source === \"string\") return DataColumnImpl.getStatusById(source, opts);\n  if (source instanceof DataColumnImpl) return \"present\";\n  const rest = source as LeafEntry<TreeNodeAccessor> | PlRef | PColumn<ColumnData>;\n  if (\"accessor\" in rest) return DataColumnImpl.getStatusByAccessor(rest);\n  if (isPlRef(rest)) return DataColumnImpl.getStatusByPlRef(rest, opts);\n  if (isPColumn(rest)) return \"present\";\n  throw new Error(\"DataColumn.getStatus: unknown source shape\");\n}\n\nexport const DataColumn = Object.assign(DataColumnDispatch, {\n  fromId: DataColumnImpl.fromId,\n  fromPlRef: DataColumnImpl.fromPlRef,\n  fromAccessor: DataColumnImpl.fromAccessor,\n  fromColumn: DataColumnImpl.fromColumn,\n  getStatus: DataColumnGetStatus,\n  getStatusById: DataColumnImpl.getStatusById,\n  getStatusByPlRef: DataColumnImpl.getStatusByPlRef,\n  getStatusByAccessor: DataColumnImpl.getStatusByAccessor,\n});\n\n/**\n * Type-guard narrowing to a bare leaf — a {@link DataColumnRecipe} whose `id` is a\n * plain {@link PObjectId}.\n */\nexport function isDataColumn(value: unknown): value is DataColumnRecipe<PObjectId> {\n  return value instanceof DataColumnImpl;\n}\n\nconst readSpecAccessor = memoizeByEntry(\n  ({ accessor, name }: LeafEntry<TreeNodeAccessor>): undefined | TreeNodeAccessor =>\n    accessor.traverse({ field: `${name}.spec`, assertFieldType: \"Input\", ignoreError: true }),\n);\n\n/**\n * Per-entry counterpart to {@link readDataStatus}: tells whether the leaf's\n * **spec** can be read in this ctx, and — for the negative cases —\n * distinguishes `resolving` from `absent` via `getInputsLocked()`.\n *\n *  - spec field not yet on the entry's accessor + inputs locked → `absent`\n *  - spec field not yet on the entry's accessor + still resolving → `resolving`\n *  - spec resource present but bytes not yet written → `resolving`\n *    (transient — the spec resource is connected, just unfilled)\n *  - spec resource present and `hasData()` → `present`\n */\nfunction getLeafEntryStatus(entry: LeafEntry<TreeNodeAccessor>): ColumnResolutionStatus {\n  const spec = readSpecAccessor(entry);\n  if (isNil(spec)) return entry.accessor.getInputsLocked() ? \"absent\" : \"resolving\";\n  if (!spec.hasData()) return \"resolving\";\n  return \"present\";\n}\n\nconst readDataAccessor = memoizeByEntry(\n  ({ accessor, name }: LeafEntry<TreeNodeAccessor>): undefined | TreeNodeAccessor =>\n    accessor.traverse({ field: `${name}.data`, assertFieldType: \"Input\", ignoreError: true }),\n);\n\nconst readDataStatus = memoizeByEntry(\n  ({ accessor, name }: LeafEntry<TreeNodeAccessor>): ColumnFieldStatus => {\n    if (accessor.listInputFields().includes(`${name}.data`)) return \"present\";\n    return accessor.getInputsLocked() ? \"absent\" : \"resolving\";\n  },\n);\n\nfunction memoizeByEntry<R>(\n  fn: (entry: LeafEntry<TreeNodeAccessor>) => R,\n): (entry: LeafEntry<TreeNodeAccessor>) => R {\n  const cache = new LRUCache<string, { value: R }>({ max: 1000 });\n  return (entry) => {\n    const key = `${entry.accessor.handle}:${entry.name}`;\n    let hit = cache.get(key);\n    if (!hit) cache.set(key, (hit = { value: fn(entry) }));\n    return hit.value;\n  };\n}\n"],"mappings":"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"}