@platforma-sdk/model 1.59.3 → 1.60.0

package/dist/columns/column_selector.js

@@ -0,0 +1,118 @@
+//#region src/columns/column_selector.ts
+function normalizeStringMatchers(input) {
+	if (typeof input === "string") return [{
+		type: "regex",
+		value: input
+	}];
+	if (!Array.isArray(input)) return [input];
+	return input.map((v) => typeof v === "string" ? {
+		type: "regex",
+		value: v
+	} : v);
+}
+function normalizeRecord(input) {
+	const result = {};
+	for (const [key, value] of Object.entries(input)) result[key] = normalizeStringMatchers(value);
+	return result;
+}
+function normalizeTypes(input) {
+	return Array.isArray(input) ? input : [input];
+}
+function normalizeAxisSelector(input) {
+	const result = {};
+	if (input.name !== void 0) result.name = normalizeStringMatchers(input.name);
+	if (input.type !== void 0) result.type = normalizeTypes(input.type);
+	if (input.domain !== void 0) result.domain = normalizeRecord(input.domain);
+	if (input.contextDomain !== void 0) result.contextDomain = normalizeRecord(input.contextDomain);
+	if (input.annotations !== void 0) result.annotations = normalizeRecord(input.annotations);
+	return result;
+}
+/** Normalize relaxed input to strict ColumnSelector[]. */
+function normalizeSelectors(input) {
+	return (Array.isArray(input) ? input : [input]).map(normalizeSingleSelector);
+}
+function normalizeSingleSelector(input) {
+	const result = {};
+	if (input.name !== void 0) result.name = normalizeStringMatchers(input.name);
+	if (input.type !== void 0) result.type = normalizeTypes(input.type);
+	if (input.domain !== void 0) result.domain = normalizeRecord(input.domain);
+	if (input.contextDomain !== void 0) result.contextDomain = normalizeRecord(input.contextDomain);
+	if (input.annotations !== void 0) result.annotations = normalizeRecord(input.annotations);
+	if (input.axes !== void 0) result.axes = input.axes.map(normalizeAxisSelector);
+	if (input.partialAxesMatch !== void 0) result.partialAxesMatch = input.partialAxesMatch;
+	return result;
+}
+function matchStringValue(value, matchers) {
+	return matchers.some((m) => {
+		if (m.type === "exact") return value === m.value;
+		return new RegExp(`^(?:${m.value})$`).test(value);
+	});
+}
+function matchRecordField(actual, required) {
+	const record = actual ?? {};
+	for (const [key, matchers] of Object.entries(required)) {
+		const value = record[key];
+		if (value === void 0) return false;
+		if (!matchStringValue(value, matchers)) return false;
+	}
+	return true;
+}
+/** Get combined domain: column's own domain merged with all axis domains. */
+function getCombinedDomain(spec) {
+	const result = {};
+	if (spec.domain) Object.assign(result, spec.domain);
+	for (const axis of spec.axesSpec) if (axis.domain) Object.assign(result, axis.domain);
+	return result;
+}
+/** Get combined context domain: column's own contextDomain merged with all axis contextDomains. */
+function getCombinedContextDomain(spec) {
+	const result = {};
+	if (spec.contextDomain) Object.assign(result, spec.contextDomain);
+	for (const axis of spec.axesSpec) if ("contextDomain" in axis && axis.contextDomain) Object.assign(result, axis.contextDomain);
+	return result;
+}
+function matchAxisSelector(axis, selector) {
+	if (selector.name !== void 0 && !matchStringValue(axis.name, selector.name)) return false;
+	if (selector.type !== void 0 && !selector.type.includes(axis.type)) return false;
+	if (selector.domain !== void 0 && !matchRecordField(axis.domain, selector.domain)) return false;
+	if (selector.contextDomain !== void 0 && !matchRecordField("contextDomain" in axis ? axis.contextDomain : void 0, selector.contextDomain)) return false;
+	if (selector.annotations !== void 0 && !matchRecordField(axis.annotations, selector.annotations)) return false;
+	return true;
+}
+/** Check if a PColumnSpec matches a single strict ColumnSelector. */
+function matchColumn(spec, selector) {
+	if (selector.name !== void 0 && !matchStringValue(spec.name, selector.name)) return false;
+	if (selector.type !== void 0 && !selector.type.includes(spec.valueType)) return false;
+	if (selector.domain !== void 0) {
+		if (!matchRecordField(getCombinedDomain(spec), selector.domain)) return false;
+	}
+	if (selector.contextDomain !== void 0) {
+		if (!matchRecordField(getCombinedContextDomain(spec), selector.contextDomain)) return false;
+	}
+	if (selector.annotations !== void 0) {
+		if (!matchRecordField(spec.annotations, selector.annotations)) return false;
+	}
+	if (selector.axes !== void 0) if (selector.partialAxesMatch ?? true) {
+		for (const axisSel of selector.axes) if (!spec.axesSpec.some((axis) => matchAxisSelector(axis, axisSel))) return false;
+	} else {
+		if (spec.axesSpec.length !== selector.axes.length) return false;
+		for (let i = 0; i < selector.axes.length; i++) if (!matchAxisSelector(spec.axesSpec[i], selector.axes[i])) return false;
+	}
+	return true;
+}
+/** Check if a PColumnSpec matches any of the selectors (OR across array). */
+function matchColumnSelectors(selectors, spec) {
+	return selectors.some((sel) => matchColumn(spec, sel));
+}
+/**
+* Convert selector input to a predicate function.
+* Normalizes relaxed form, then returns a function that OR-matches.
+*/
+function columnSelectorsToPredicate(input) {
+	const selectors = normalizeSelectors(input);
+	return (spec) => matchColumnSelectors(selectors, spec);
+}
+
+//#endregion
+export { columnSelectorsToPredicate, matchColumn, matchColumnSelectors, normalizeSelectors };
+//# sourceMappingURL=column_selector.js.map

package/dist/columns/column_selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column_selector.js","names":[],"sources":["../../src/columns/column_selector.ts"],"sourcesContent":["import type {\n  MultiAxisSelector,\n  MultiColumnSelector,\n  PColumnSpec,\n  StringMatcher,\n  ValueType,\n} from \"@milaboratories/pl-model-common\";\n\nexport type { StringMatcher } from \"@milaboratories/pl-model-common\";\n\n// --- Relaxed types ---\n\n/** Relaxed string matcher input: plain string, single matcher, or array of mixed. */\nexport type RelaxedStringMatchers = string | StringMatcher | (string | StringMatcher)[];\n\n/** Relaxed record matcher: values can be plain strings or relaxed matchers. */\nexport type RelaxedRecord = Record<string, RelaxedStringMatchers>;\n\n/** Relaxed axis selector — accepts plain strings where strict requires StringMatcher[]. */\nexport interface RelaxedAxisSelector {\n  name?: RelaxedStringMatchers;\n  type?: ValueType | ValueType[];\n  domain?: RelaxedRecord;\n  contextDomain?: RelaxedRecord;\n  annotations?: RelaxedRecord;\n}\n\n/** Relaxed column selector — convenient hand-written form. */\nexport interface RelaxedColumnSelector {\n  name?: RelaxedStringMatchers;\n  type?: ValueType | ValueType[];\n  domain?: RelaxedRecord;\n  contextDomain?: RelaxedRecord;\n  annotations?: RelaxedRecord;\n  axes?: RelaxedAxisSelector[];\n  partialAxesMatch?: boolean;\n}\n\n/** Input that normalizes to ColumnSelector[]. */\nexport type ColumnSelectorInput = RelaxedColumnSelector | RelaxedColumnSelector[];\n\n// --- Normalization ---\n\nfunction normalizeStringMatchers(input: RelaxedStringMatchers): StringMatcher[] {\n  if (typeof input === \"string\") return [{ type: \"regex\", value: input }];\n  if (!Array.isArray(input)) return [input];\n  return input.map((v) =>\n    typeof v === \"string\" ? ({ type: \"regex\", value: v } satisfies StringMatcher) : v,\n  );\n}\n\nfunction normalizeRecord(input: RelaxedRecord): Record<string, StringMatcher[]> {\n  const result: Record<string, StringMatcher[]> = {};\n  for (const [key, value] of Object.entries(input)) {\n    result[key] = normalizeStringMatchers(value);\n  }\n  return result;\n}\n\nfunction normalizeTypes(input: ValueType | ValueType[]): ValueType[] {\n  return Array.isArray(input) ? input : [input];\n}\n\ntype Mutable<T> = { -readonly [K in keyof T]: T[K] };\n\nfunction normalizeAxisSelector(input: RelaxedAxisSelector): MultiAxisSelector {\n  const result: Mutable<MultiAxisSelector> = {};\n  if (input.name !== undefined) result.name = normalizeStringMatchers(input.name);\n  if (input.type !== undefined) result.type = normalizeTypes(input.type);\n  if (input.domain !== undefined) result.domain = normalizeRecord(input.domain);\n  if (input.contextDomain !== undefined)\n    result.contextDomain = normalizeRecord(input.contextDomain);\n  if (input.annotations !== undefined) result.annotations = normalizeRecord(input.annotations);\n  return result;\n}\n\n/** Normalize relaxed input to strict ColumnSelector[]. */\nexport function normalizeSelectors(input: ColumnSelectorInput): MultiColumnSelector[] {\n  const arr = Array.isArray(input) ? input : [input];\n  return arr.map(normalizeSingleSelector);\n}\n\nfunction normalizeSingleSelector(input: RelaxedColumnSelector): MultiColumnSelector {\n  const result: Mutable<MultiColumnSelector> = {};\n  if (input.name !== undefined) result.name = normalizeStringMatchers(input.name);\n  if (input.type !== undefined) result.type = normalizeTypes(input.type);\n  if (input.domain !== undefined) result.domain = normalizeRecord(input.domain);\n  if (input.contextDomain !== undefined)\n    result.contextDomain = normalizeRecord(input.contextDomain);\n  if (input.annotations !== undefined) result.annotations = normalizeRecord(input.annotations);\n  if (input.axes !== undefined) result.axes = input.axes.map(normalizeAxisSelector);\n  if (input.partialAxesMatch !== undefined) result.partialAxesMatch = input.partialAxesMatch;\n  return result;\n}\n\n// --- Matching ---\n\nfunction matchStringValue(value: string, matchers: StringMatcher[]): boolean {\n  return matchers.some((m) => {\n    if (m.type === \"exact\") return value === m.value;\n    return new RegExp(`^(?:${m.value})$`).test(value);\n  });\n}\n\nfunction matchRecordField(\n  actual: Record<string, string> | undefined,\n  required: Record<string, StringMatcher[]>,\n): boolean {\n  const record = actual ?? {};\n  for (const [key, matchers] of Object.entries(required)) {\n    const value = record[key];\n    if (value === undefined) return false;\n    if (!matchStringValue(value, matchers)) return false;\n  }\n  return true;\n}\n\n/** Get combined domain: column's own domain merged with all axis domains. */\nfunction getCombinedDomain(spec: PColumnSpec): Record<string, string> {\n  const result: Record<string, string> = {};\n  if (spec.domain) Object.assign(result, spec.domain);\n  for (const axis of spec.axesSpec) {\n    if (axis.domain) Object.assign(result, axis.domain);\n  }\n  return result;\n}\n\n/** Get combined context domain: column's own contextDomain merged with all axis contextDomains. */\nfunction getCombinedContextDomain(spec: PColumnSpec): Record<string, string> {\n  const result: Record<string, string> = {};\n  if (spec.contextDomain) Object.assign(result, spec.contextDomain);\n  for (const axis of spec.axesSpec) {\n    if (\"contextDomain\" in axis && axis.contextDomain) Object.assign(result, axis.contextDomain);\n  }\n  return result;\n}\n\nfunction matchAxisSelector(\n  axis: PColumnSpec[\"axesSpec\"][number],\n  selector: MultiAxisSelector,\n): boolean {\n  if (selector.name !== undefined && !matchStringValue(axis.name, selector.name)) return false;\n  if (selector.type !== undefined && !selector.type.includes(axis.type as ValueType)) return false;\n  if (selector.domain !== undefined && !matchRecordField(axis.domain, selector.domain))\n    return false;\n  if (\n    selector.contextDomain !== undefined &&\n    !matchRecordField(\n      \"contextDomain\" in axis ? (axis.contextDomain as Record<string, string>) : undefined,\n      selector.contextDomain,\n    )\n  )\n    return false;\n  if (\n    selector.annotations !== undefined &&\n    !matchRecordField(axis.annotations, selector.annotations)\n  )\n    return false;\n  return true;\n}\n\n/** Check if a PColumnSpec matches a single strict ColumnSelector. */\nexport function matchColumn(spec: PColumnSpec, selector: MultiColumnSelector): boolean {\n  if (selector.name !== undefined && !matchStringValue(spec.name, selector.name)) return false;\n  if (selector.type !== undefined && !selector.type.includes(spec.valueType)) return false;\n\n  if (selector.domain !== undefined) {\n    const combined = getCombinedDomain(spec);\n    if (!matchRecordField(combined, selector.domain)) return false;\n  }\n\n  if (selector.contextDomain !== undefined) {\n    const combined = getCombinedContextDomain(spec);\n    if (!matchRecordField(combined, selector.contextDomain)) return false;\n  }\n\n  if (selector.annotations !== undefined) {\n    if (!matchRecordField(spec.annotations, selector.annotations)) return false;\n  }\n\n  if (selector.axes !== undefined) {\n    const partialMatch = selector.partialAxesMatch ?? true;\n    if (partialMatch) {\n      for (const axisSel of selector.axes) {\n        if (!spec.axesSpec.some((axis) => matchAxisSelector(axis, axisSel))) return false;\n      }\n    } else {\n      if (spec.axesSpec.length !== selector.axes.length) return false;\n      for (let i = 0; i < selector.axes.length; i++) {\n        if (!matchAxisSelector(spec.axesSpec[i], selector.axes[i])) return false;\n      }\n    }\n  }\n\n  return true;\n}\n\n/** Check if a PColumnSpec matches any of the selectors (OR across array). */\nexport function matchColumnSelectors(selectors: MultiColumnSelector[], spec: PColumnSpec): boolean {\n  return selectors.some((sel) => matchColumn(spec, sel));\n}\n\n/**\n * Convert selector input to a predicate function.\n * Normalizes relaxed form, then returns a function that OR-matches.\n */\nexport function columnSelectorsToPredicate(\n  input: ColumnSelectorInput,\n): (spec: PColumnSpec) => boolean {\n  const selectors = normalizeSelectors(input);\n  return (spec) => matchColumnSelectors(selectors, spec);\n}\n"],"mappings":";AA2CA,SAAS,wBAAwB,OAA+C;AAC9E,KAAI,OAAO,UAAU,SAAU,QAAO,CAAC;EAAE,MAAM;EAAS,OAAO;EAAO,CAAC;AACvE,KAAI,CAAC,MAAM,QAAQ,MAAM,CAAE,QAAO,CAAC,MAAM;AACzC,QAAO,MAAM,KAAK,MAChB,OAAO,MAAM,WAAY;EAAE,MAAM;EAAS,OAAO;EAAG,GAA4B,EACjF;;AAGH,SAAS,gBAAgB,OAAuD;CAC9E,MAAM,SAA0C,EAAE;AAClD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,CAC9C,QAAO,OAAO,wBAAwB,MAAM;AAE9C,QAAO;;AAGT,SAAS,eAAe,OAA6C;AACnE,QAAO,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM;;AAK/C,SAAS,sBAAsB,OAA+C;CAC5E,MAAM,SAAqC,EAAE;AAC7C,KAAI,MAAM,SAAS,OAAW,QAAO,OAAO,wBAAwB,MAAM,KAAK;AAC/E,KAAI,MAAM,SAAS,OAAW,QAAO,OAAO,eAAe,MAAM,KAAK;AACtE,KAAI,MAAM,WAAW,OAAW,QAAO,SAAS,gBAAgB,MAAM,OAAO;AAC7E,KAAI,MAAM,kBAAkB,OAC1B,QAAO,gBAAgB,gBAAgB,MAAM,cAAc;AAC7D,KAAI,MAAM,gBAAgB,OAAW,QAAO,cAAc,gBAAgB,MAAM,YAAY;AAC5F,QAAO;;;AAIT,SAAgB,mBAAmB,OAAmD;AAEpF,SADY,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM,EACvC,IAAI,wBAAwB;;AAGzC,SAAS,wBAAwB,OAAmD;CAClF,MAAM,SAAuC,EAAE;AAC/C,KAAI,MAAM,SAAS,OAAW,QAAO,OAAO,wBAAwB,MAAM,KAAK;AAC/E,KAAI,MAAM,SAAS,OAAW,QAAO,OAAO,eAAe,MAAM,KAAK;AACtE,KAAI,MAAM,WAAW,OAAW,QAAO,SAAS,gBAAgB,MAAM,OAAO;AAC7E,KAAI,MAAM,kBAAkB,OAC1B,QAAO,gBAAgB,gBAAgB,MAAM,cAAc;AAC7D,KAAI,MAAM,gBAAgB,OAAW,QAAO,cAAc,gBAAgB,MAAM,YAAY;AAC5F,KAAI,MAAM,SAAS,OAAW,QAAO,OAAO,MAAM,KAAK,IAAI,sBAAsB;AACjF,KAAI,MAAM,qBAAqB,OAAW,QAAO,mBAAmB,MAAM;AAC1E,QAAO;;AAKT,SAAS,iBAAiB,OAAe,UAAoC;AAC3E,QAAO,SAAS,MAAM,MAAM;AAC1B,MAAI,EAAE,SAAS,QAAS,QAAO,UAAU,EAAE;AAC3C,SAAO,IAAI,OAAO,OAAO,EAAE,MAAM,IAAI,CAAC,KAAK,MAAM;GACjD;;AAGJ,SAAS,iBACP,QACA,UACS;CACT,MAAM,SAAS,UAAU,EAAE;AAC3B,MAAK,MAAM,CAAC,KAAK,aAAa,OAAO,QAAQ,SAAS,EAAE;EACtD,MAAM,QAAQ,OAAO;AACrB,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI,CAAC,iBAAiB,OAAO,SAAS,CAAE,QAAO;;AAEjD,QAAO;;;AAIT,SAAS,kBAAkB,MAA2C;CACpE,MAAM,SAAiC,EAAE;AACzC,KAAI,KAAK,OAAQ,QAAO,OAAO,QAAQ,KAAK,OAAO;AACnD,MAAK,MAAM,QAAQ,KAAK,SACtB,KAAI,KAAK,OAAQ,QAAO,OAAO,QAAQ,KAAK,OAAO;AAErD,QAAO;;;AAIT,SAAS,yBAAyB,MAA2C;CAC3E,MAAM,SAAiC,EAAE;AACzC,KAAI,KAAK,cAAe,QAAO,OAAO,QAAQ,KAAK,cAAc;AACjE,MAAK,MAAM,QAAQ,KAAK,SACtB,KAAI,mBAAmB,QAAQ,KAAK,cAAe,QAAO,OAAO,QAAQ,KAAK,cAAc;AAE9F,QAAO;;AAGT,SAAS,kBACP,MACA,UACS;AACT,KAAI,SAAS,SAAS,UAAa,CAAC,iBAAiB,KAAK,MAAM,SAAS,KAAK,CAAE,QAAO;AACvF,KAAI,SAAS,SAAS,UAAa,CAAC,SAAS,KAAK,SAAS,KAAK,KAAkB,CAAE,QAAO;AAC3F,KAAI,SAAS,WAAW,UAAa,CAAC,iBAAiB,KAAK,QAAQ,SAAS,OAAO,CAClF,QAAO;AACT,KACE,SAAS,kBAAkB,UAC3B,CAAC,iBACC,mBAAmB,OAAQ,KAAK,gBAA2C,QAC3E,SAAS,cACV,CAED,QAAO;AACT,KACE,SAAS,gBAAgB,UACzB,CAAC,iBAAiB,KAAK,aAAa,SAAS,YAAY,CAEzD,QAAO;AACT,QAAO;;;AAIT,SAAgB,YAAY,MAAmB,UAAwC;AACrF,KAAI,SAAS,SAAS,UAAa,CAAC,iBAAiB,KAAK,MAAM,SAAS,KAAK,CAAE,QAAO;AACvF,KAAI,SAAS,SAAS,UAAa,CAAC,SAAS,KAAK,SAAS,KAAK,UAAU,CAAE,QAAO;AAEnF,KAAI,SAAS,WAAW,QAEtB;MAAI,CAAC,iBADY,kBAAkB,KAAK,EACR,SAAS,OAAO,CAAE,QAAO;;AAG3D,KAAI,SAAS,kBAAkB,QAE7B;MAAI,CAAC,iBADY,yBAAyB,KAAK,EACf,SAAS,cAAc,CAAE,QAAO;;AAGlE,KAAI,SAAS,gBAAgB,QAC3B;MAAI,CAAC,iBAAiB,KAAK,aAAa,SAAS,YAAY,CAAE,QAAO;;AAGxE,KAAI,SAAS,SAAS,OAEpB,KADqB,SAAS,oBAAoB,MAEhD;OAAK,MAAM,WAAW,SAAS,KAC7B,KAAI,CAAC,KAAK,SAAS,MAAM,SAAS,kBAAkB,MAAM,QAAQ,CAAC,CAAE,QAAO;QAEzE;AACL,MAAI,KAAK,SAAS,WAAW,SAAS,KAAK,OAAQ,QAAO;AAC1D,OAAK,IAAI,IAAI,GAAG,IAAI,SAAS,KAAK,QAAQ,IACxC,KAAI,CAAC,kBAAkB,KAAK,SAAS,IAAI,SAAS,KAAK,GAAG,CAAE,QAAO;;AAKzE,QAAO;;;AAIT,SAAgB,qBAAqB,WAAkC,MAA4B;AACjG,QAAO,UAAU,MAAM,QAAQ,YAAY,MAAM,IAAI,CAAC;;;;;;AAOxD,SAAgB,2BACd,OACgC;CAChC,MAAM,YAAY,mBAAmB,MAAM;AAC3C,SAAQ,SAAS,qBAAqB,WAAW,KAAK"}

package/dist/columns/column_snapshot.cjs

@@ -0,0 +1,20 @@
+
+//#region src/columns/column_snapshot.ts
+/** Creates a ColumnData active object for a ready column. */
+function createReadyColumnData(getData) {
+	return { get: getData };
+}
+/** Creates a ColumnSnapshot from parts. */
+function createColumnSnapshot(id, spec, dataStatus, data) {
+	return {
+		id,
+		spec,
+		dataStatus,
+		data
+	};
+}
+
+//#endregion
+exports.createColumnSnapshot = createColumnSnapshot;
+exports.createReadyColumnData = createReadyColumnData;
+//# sourceMappingURL=column_snapshot.cjs.map

package/dist/columns/column_snapshot.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"column_snapshot.cjs","names":[],"sources":["../../src/columns/column_snapshot.ts"],"sourcesContent":["import type { PColumnSpec, PObjectId } from \"@milaboratories/pl-model-common\";\nimport type { PColumnDataUniversal } from \"../render/internal\";\n\n// --- ColumnSnapshot ---\n\n/** Data status of a column snapshot. */\nexport type ColumnDataStatus = \"ready\" | \"computing\" | \"absent\";\n\n/**\n * Immutable snapshot of a column: spec, data status, and lazy data accessor.\n *\n * - `dataStatus` is readable without marking the render context unstable.\n * - `data` holds an active object when data exists (ready or computing),\n *   or `undefined` when data is permanently absent.\n */\nexport interface ColumnSnapshot<Id extends PObjectId = PObjectId> {\n  readonly id: Id;\n  readonly spec: PColumnSpec;\n  readonly dataStatus: ColumnDataStatus;\n\n  /**\n   * Lazy data accessor.\n   * - `'ready'`: `data.get()` returns column data, context stays stable.\n   * - `'computing'`: `data.get()` returns `undefined`, marks context unstable.\n   * - `'absent'`: `data` is `undefined` — no active object, no instability.\n   */\n  readonly data: ColumnData | undefined;\n}\n\n// --- ColumnData ---\n\n/**\n * Active object wrapping lazy column data access.\n * Accessing data on a computing column marks the render context unstable.\n */\nexport interface ColumnData {\n  get(): PColumnDataUniversal | undefined;\n}\n\n/** Creates a ColumnData active object for a ready column. */\nexport function createReadyColumnData(getData: () => PColumnDataUniversal | undefined): ColumnData {\n  return { get: getData };\n}\n\n// --- Snapshot construction helpers ---\n\n/** Creates a ColumnSnapshot from parts. */\nexport function createColumnSnapshot<Id extends PObjectId = PObjectId>(\n  id: Id,\n  spec: PColumnSpec,\n  dataStatus: ColumnDataStatus,\n  data: ColumnData | undefined,\n): ColumnSnapshot<Id> {\n  return { id, spec, dataStatus, data };\n}\n"],"mappings":";;;AAwCA,SAAgB,sBAAsB,SAA6D;AACjG,QAAO,EAAE,KAAK,SAAS;;;AAMzB,SAAgB,qBACd,IACA,MACA,YACA,MACoB;AACpB,QAAO;EAAE;EAAI;EAAM;EAAY;EAAM"}

package/dist/columns/column_snapshot.d.ts

@@ -0,0 +1,39 @@
+import { PColumnDataUniversal } from "../render/internal.js";
+import { PColumnSpec, PObjectId } from "@milaboratories/pl-model-common";
+
+//#region src/columns/column_snapshot.d.ts
+/** Data status of a column snapshot. */
+type ColumnDataStatus = "ready" | "computing" | "absent";
+/**
+ * Immutable snapshot of a column: spec, data status, and lazy data accessor.
+ *
+ * - `dataStatus` is readable without marking the render context unstable.
+ * - `data` holds an active object when data exists (ready or computing),
+ *   or `undefined` when data is permanently absent.
+ */
+interface ColumnSnapshot<Id extends PObjectId = PObjectId> {
+  readonly id: Id;
+  readonly spec: PColumnSpec;
+  readonly dataStatus: ColumnDataStatus;
+  /**
+   * Lazy data accessor.
+   * - `'ready'`: `data.get()` returns column data, context stays stable.
+   * - `'computing'`: `data.get()` returns `undefined`, marks context unstable.
+   * - `'absent'`: `data` is `undefined` — no active object, no instability.
+   */
+  readonly data: ColumnData | undefined;
+}
+/**
+ * Active object wrapping lazy column data access.
+ * Accessing data on a computing column marks the render context unstable.
+ */
+interface ColumnData {
+  get(): PColumnDataUniversal | undefined;
+}
+/** Creates a ColumnData active object for a ready column. */
+declare function createReadyColumnData(getData: () => PColumnDataUniversal | undefined): ColumnData;
+/** Creates a ColumnSnapshot from parts. */
+declare function createColumnSnapshot<Id extends PObjectId = PObjectId>(id: Id, spec: PColumnSpec, dataStatus: ColumnDataStatus, data: ColumnData | undefined): ColumnSnapshot<Id>;
+//#endregion
+export { ColumnData, ColumnDataStatus, ColumnSnapshot, createColumnSnapshot, createReadyColumnData };
+//# sourceMappingURL=column_snapshot.d.ts.map

package/dist/columns/column_snapshot.js

@@ -0,0 +1,18 @@
+//#region src/columns/column_snapshot.ts
+/** Creates a ColumnData active object for a ready column. */
+function createReadyColumnData(getData) {
+	return { get: getData };
+}
+/** Creates a ColumnSnapshot from parts. */
+function createColumnSnapshot(id, spec, dataStatus, data) {
+	return {
+		id,
+		spec,
+		dataStatus,
+		data
+	};
+}
+
+//#endregion
+export { createColumnSnapshot, createReadyColumnData };
+//# sourceMappingURL=column_snapshot.js.map

package/dist/columns/column_snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column_snapshot.js","names":[],"sources":["../../src/columns/column_snapshot.ts"],"sourcesContent":["import type { PColumnSpec, PObjectId } from \"@milaboratories/pl-model-common\";\nimport type { PColumnDataUniversal } from \"../render/internal\";\n\n// --- ColumnSnapshot ---\n\n/** Data status of a column snapshot. */\nexport type ColumnDataStatus = \"ready\" | \"computing\" | \"absent\";\n\n/**\n * Immutable snapshot of a column: spec, data status, and lazy data accessor.\n *\n * - `dataStatus` is readable without marking the render context unstable.\n * - `data` holds an active object when data exists (ready or computing),\n *   or `undefined` when data is permanently absent.\n */\nexport interface ColumnSnapshot<Id extends PObjectId = PObjectId> {\n  readonly id: Id;\n  readonly spec: PColumnSpec;\n  readonly dataStatus: ColumnDataStatus;\n\n  /**\n   * Lazy data accessor.\n   * - `'ready'`: `data.get()` returns column data, context stays stable.\n   * - `'computing'`: `data.get()` returns `undefined`, marks context unstable.\n   * - `'absent'`: `data` is `undefined` — no active object, no instability.\n   */\n  readonly data: ColumnData | undefined;\n}\n\n// --- ColumnData ---\n\n/**\n * Active object wrapping lazy column data access.\n * Accessing data on a computing column marks the render context unstable.\n */\nexport interface ColumnData {\n  get(): PColumnDataUniversal | undefined;\n}\n\n/** Creates a ColumnData active object for a ready column. */\nexport function createReadyColumnData(getData: () => PColumnDataUniversal | undefined): ColumnData {\n  return { get: getData };\n}\n\n// --- Snapshot construction helpers ---\n\n/** Creates a ColumnSnapshot from parts. */\nexport function createColumnSnapshot<Id extends PObjectId = PObjectId>(\n  id: Id,\n  spec: PColumnSpec,\n  dataStatus: ColumnDataStatus,\n  data: ColumnData | undefined,\n): ColumnSnapshot<Id> {\n  return { id, spec, dataStatus, data };\n}\n"],"mappings":";;AAwCA,SAAgB,sBAAsB,SAA6D;AACjG,QAAO,EAAE,KAAK,SAAS;;;AAMzB,SAAgB,qBACd,IACA,MACA,YACA,MACoB;AACpB,QAAO;EAAE;EAAI;EAAM;EAAY;EAAM"}

package/dist/columns/column_snapshot_provider.cjs

@@ -0,0 +1,112 @@
+
+//#region src/columns/column_snapshot_provider.ts
+/**
+* Simple provider wrapping an array of PColumns.
+* Always complete, data status always 'ready'.
+*/
+var ArrayColumnProvider = class {
+	columns;
+	constructor(columns) {
+		this.columns = columns.map((col) => ({
+			id: col.id,
+			spec: col.spec,
+			dataStatus: "ready",
+			data: { get: () => col.data }
+		}));
+	}
+	getAllColumns() {
+		return this.columns;
+	}
+	isColumnListComplete() {
+		return true;
+	}
+};
+/**
+* Provider wrapping an array of ColumnSnapshots.
+* Always complete. Data status taken from each snapshot.
+*/
+var SnapshotColumnProvider = class {
+	constructor(snapshots) {
+		this.snapshots = snapshots;
+	}
+	getAllColumns() {
+		return this.snapshots;
+	}
+	isColumnListComplete() {
+		return true;
+	}
+};
+/**
+* Provider wrapping a TreeNodeAccessor (output/prerun resolve result).
+* Detects data status from accessor readiness state.
+*/
+var OutputColumnProvider = class {
+	constructor(accessor, opts) {
+		this.accessor = accessor;
+		this.opts = opts;
+	}
+	getAllColumns() {
+		return this.getColumns();
+	}
+	isColumnListComplete() {
+		return this.accessor.getInputsLocked();
+	}
+	getColumns() {
+		const pColumns = this.accessor.getPColumns();
+		if (pColumns === void 0) return [];
+		const isFinal = this.accessor.getIsFinal();
+		const allowAbsence = this.opts?.allowPermanentAbsence === true;
+		return pColumns.map((col) => {
+			const dataAccessor = col.data;
+			const isReady = dataAccessor.getIsReadyOrError();
+			let dataStatus;
+			if (isReady) dataStatus = "ready";
+			else if (allowAbsence && isFinal) dataStatus = "absent";
+			else dataStatus = "computing";
+			return {
+				id: col.id,
+				spec: col.spec,
+				dataStatus,
+				data: { get: () => isReady ? dataAccessor : void 0 }
+			};
+		});
+	}
+};
+/** Checks if a value is a ColumnSnapshotProvider (duck-typing). */
+function isColumnSnapshotProvider(source) {
+	return typeof source === "object" && source !== null && "getAllColumns" in source && "isColumnListComplete" in source && typeof source.getAllColumns === "function" && typeof source.isColumnListComplete === "function";
+}
+/** Checks if a value looks like a PColumn (has id, spec, data). */
+function isPColumnArray(source) {
+	if (!Array.isArray(source)) return false;
+	if (source.length === 0) return true;
+	const first = source[0];
+	return "id" in first && "spec" in first && "data" in first && !("dataStatus" in first);
+}
+/** Checks if a value looks like a ColumnSnapshot array. */
+function isColumnSnapshotArray(source) {
+	if (!Array.isArray(source)) return false;
+	if (source.length === 0) return true;
+	const first = source[0];
+	return "id" in first && "spec" in first && "dataStatus" in first;
+}
+/**
+* Normalize any ColumnSource into a ColumnSnapshotProvider.
+* - ColumnSnapshotProvider → returned as-is
+* - ColumnSnapshot[] → wrapped in SnapshotColumnProvider
+* - PColumn[] → wrapped in ArrayColumnProvider
+*/
+function toColumnSnapshotProvider(source) {
+	if (isColumnSnapshotProvider(source)) return source;
+	if (isColumnSnapshotArray(source)) return new SnapshotColumnProvider(source);
+	if (isPColumnArray(source)) return new ArrayColumnProvider(source);
+	throw new Error("Unknown ColumnSource type");
+}
+
+//#endregion
+exports.ArrayColumnProvider = ArrayColumnProvider;
+exports.OutputColumnProvider = OutputColumnProvider;
+exports.SnapshotColumnProvider = SnapshotColumnProvider;
+exports.isColumnSnapshotProvider = isColumnSnapshotProvider;
+exports.toColumnSnapshotProvider = toColumnSnapshotProvider;
+//# sourceMappingURL=column_snapshot_provider.cjs.map

package/dist/columns/column_snapshot_provider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"column_snapshot_provider.cjs","names":[],"sources":["../../src/columns/column_snapshot_provider.ts"],"sourcesContent":["import { PColumn } from \"@milaboratories/pl-model-common\";\nimport { TreeNodeAccessor } from \"../render/accessor\";\nimport type { PColumnDataUniversal } from \"../render/internal\";\nimport type { ColumnDataStatus, ColumnSnapshot } from \"./column_snapshot\";\n\n// --- ColumnProvider ---\n\n/**\n * Data source interface for column enumeration.\n *\n * Knows nothing about the render framework, stability tracking, labels,\n * anchoring, or splitting. All that complexity lives in the collection layer.\n */\nexport interface ColumnSnapshotProvider {\n  /** Returns all currently known columns. */\n  getAllColumns(): ColumnSnapshot[];\n\n  /** Whether the provider has finished enumerating all its columns.\n   *  Calling this may mark the render context unstable — it touches\n   *  the reactive tree to check field resolution state. */\n  isColumnListComplete(): boolean;\n}\n\n// --- ColumnSource ---\n\n/**\n * Union of types that can serve as column sources for helpers and builders.\n * Does NOT include TreeNodeAccessor — call `.toColumnSource()` on it first.\n */\nexport type ColumnSource =\n  | ColumnSnapshotProvider\n  | ColumnSnapshot[]\n  | PColumn<PColumnDataUniversal | undefined>[];\n\n// --- ArrayColumnProvider ---\n\n/**\n * Simple provider wrapping an array of PColumns.\n * Always complete, data status always 'ready'.\n */\nexport class ArrayColumnProvider implements ColumnSnapshotProvider {\n  private readonly columns: ColumnSnapshot[];\n\n  constructor(columns: PColumn<PColumnDataUniversal | undefined>[]) {\n    this.columns = columns.map((col) => ({\n      id: col.id,\n      spec: col.spec,\n      dataStatus: \"ready\" as const,\n      data: { get: () => col.data },\n    }));\n  }\n\n  getAllColumns(): ColumnSnapshot[] {\n    return this.columns;\n  }\n\n  isColumnListComplete(): boolean {\n    return true;\n  }\n}\n\n// --- SnapshotColumnProvider ---\n\n/**\n * Provider wrapping an array of ColumnSnapshots.\n * Always complete. Data status taken from each snapshot.\n */\nexport class SnapshotColumnProvider implements ColumnSnapshotProvider {\n  constructor(private readonly snapshots: ColumnSnapshot[]) {}\n\n  getAllColumns(): ColumnSnapshot[] {\n    return this.snapshots;\n  }\n\n  isColumnListComplete(): boolean {\n    return true;\n  }\n}\n\n// --- OutputColumnProvider ---\n\nexport interface OutputColumnProviderOpts {\n  /** When true and the accessor is final, columns with no ready data get status 'absent'. */\n  allowPermanentAbsence?: boolean;\n}\n\n/**\n * Provider wrapping a TreeNodeAccessor (output/prerun resolve result).\n * Detects data status from accessor readiness state.\n */\nexport class OutputColumnProvider implements ColumnSnapshotProvider {\n  constructor(\n    private readonly accessor: TreeNodeAccessor,\n    private readonly opts?: OutputColumnProviderOpts,\n  ) {}\n\n  getAllColumns(): ColumnSnapshot[] {\n    return this.getColumns();\n  }\n\n  isColumnListComplete(): boolean {\n    return this.accessor.getInputsLocked();\n  }\n\n  private getColumns(): ColumnSnapshot[] {\n    const pColumns = this.accessor.getPColumns();\n    if (pColumns === undefined) return [];\n\n    const isFinal = this.accessor.getIsFinal();\n    const allowAbsence = this.opts?.allowPermanentAbsence === true;\n\n    return pColumns.map((col) => {\n      const dataAccessor = col.data;\n      const isReady = dataAccessor.getIsReadyOrError();\n\n      let dataStatus: ColumnDataStatus;\n      if (isReady) {\n        dataStatus = \"ready\";\n      } else if (allowAbsence && isFinal) {\n        dataStatus = \"absent\";\n      } else {\n        dataStatus = \"computing\";\n      }\n\n      return {\n        id: col.id,\n        spec: col.spec,\n        dataStatus,\n        data: { get: () => (isReady ? dataAccessor : undefined) },\n      };\n    });\n  }\n}\n\n// --- Source normalization ---\n\n/** Checks if a value is a ColumnSnapshotProvider (duck-typing). */\nexport function isColumnSnapshotProvider(source: unknown): source is ColumnSnapshotProvider {\n  return (\n    typeof source === \"object\" &&\n    source !== null &&\n    \"getAllColumns\" in source &&\n    \"isColumnListComplete\" in source &&\n    typeof (source as ColumnSnapshotProvider).getAllColumns === \"function\" &&\n    typeof (source as ColumnSnapshotProvider).isColumnListComplete === \"function\"\n  );\n}\n\n/** Checks if a value looks like a PColumn (has id, spec, data). */\nfunction isPColumnArray(source: unknown): source is PColumn<PColumnDataUniversal | undefined>[] {\n  if (!Array.isArray(source)) return false;\n  if (source.length === 0) return true; // empty array — treat as PColumn[]\n  const first = source[0];\n  return \"id\" in first && \"spec\" in first && \"data\" in first && !(\"dataStatus\" in first);\n}\n\n/** Checks if a value looks like a ColumnSnapshot array. */\nfunction isColumnSnapshotArray(source: unknown): source is ColumnSnapshot[] {\n  if (!Array.isArray(source)) return false;\n  if (source.length === 0) return true; // empty array — treat as snapshots\n  const first = source[0];\n  return \"id\" in first && \"spec\" in first && \"dataStatus\" in first;\n}\n\n/**\n * Normalize any ColumnSource into a ColumnSnapshotProvider.\n * - ColumnSnapshotProvider → returned as-is\n * - ColumnSnapshot[] → wrapped in SnapshotColumnProvider\n * - PColumn[] → wrapped in ArrayColumnProvider\n */\nexport function toColumnSnapshotProvider(source: ColumnSource): ColumnSnapshotProvider {\n  if (isColumnSnapshotProvider(source)) return source;\n  if (isColumnSnapshotArray(source)) return new SnapshotColumnProvider(source);\n  if (isPColumnArray(source)) return new ArrayColumnProvider(source);\n  // Should not reach here given the type union, but be safe\n  throw new Error(\"Unknown ColumnSource type\");\n}\n"],"mappings":";;;;;;AAwCA,IAAa,sBAAb,MAAmE;CACjE,AAAiB;CAEjB,YAAY,SAAsD;AAChE,OAAK,UAAU,QAAQ,KAAK,SAAS;GACnC,IAAI,IAAI;GACR,MAAM,IAAI;GACV,YAAY;GACZ,MAAM,EAAE,WAAW,IAAI,MAAM;GAC9B,EAAE;;CAGL,gBAAkC;AAChC,SAAO,KAAK;;CAGd,uBAAgC;AAC9B,SAAO;;;;;;;AAUX,IAAa,yBAAb,MAAsE;CACpE,YAAY,AAAiB,WAA6B;EAA7B;;CAE7B,gBAAkC;AAChC,SAAO,KAAK;;CAGd,uBAAgC;AAC9B,SAAO;;;;;;;AAeX,IAAa,uBAAb,MAAoE;CAClE,YACE,AAAiB,UACjB,AAAiB,MACjB;EAFiB;EACA;;CAGnB,gBAAkC;AAChC,SAAO,KAAK,YAAY;;CAG1B,uBAAgC;AAC9B,SAAO,KAAK,SAAS,iBAAiB;;CAGxC,AAAQ,aAA+B;EACrC,MAAM,WAAW,KAAK,SAAS,aAAa;AAC5C,MAAI,aAAa,OAAW,QAAO,EAAE;EAErC,MAAM,UAAU,KAAK,SAAS,YAAY;EAC1C,MAAM,eAAe,KAAK,MAAM,0BAA0B;AAE1D,SAAO,SAAS,KAAK,QAAQ;GAC3B,MAAM,eAAe,IAAI;GACzB,MAAM,UAAU,aAAa,mBAAmB;GAEhD,IAAI;AACJ,OAAI,QACF,cAAa;YACJ,gBAAgB,QACzB,cAAa;OAEb,cAAa;AAGf,UAAO;IACL,IAAI,IAAI;IACR,MAAM,IAAI;IACV;IACA,MAAM,EAAE,WAAY,UAAU,eAAe,QAAY;IAC1D;IACD;;;;AAON,SAAgB,yBAAyB,QAAmD;AAC1F,QACE,OAAO,WAAW,YAClB,WAAW,QACX,mBAAmB,UACnB,0BAA0B,UAC1B,OAAQ,OAAkC,kBAAkB,cAC5D,OAAQ,OAAkC,yBAAyB;;;AAKvE,SAAS,eAAe,QAAwE;AAC9F,KAAI,CAAC,MAAM,QAAQ,OAAO,CAAE,QAAO;AACnC,KAAI,OAAO,WAAW,EAAG,QAAO;CAChC,MAAM,QAAQ,OAAO;AACrB,QAAO,QAAQ,SAAS,UAAU,SAAS,UAAU,SAAS,EAAE,gBAAgB;;;AAIlF,SAAS,sBAAsB,QAA6C;AAC1E,KAAI,CAAC,MAAM,QAAQ,OAAO,CAAE,QAAO;AACnC,KAAI,OAAO,WAAW,EAAG,QAAO;CAChC,MAAM,QAAQ,OAAO;AACrB,QAAO,QAAQ,SAAS,UAAU,SAAS,gBAAgB;;;;;;;;AAS7D,SAAgB,yBAAyB,QAA8C;AACrF,KAAI,yBAAyB,OAAO,CAAE,QAAO;AAC7C,KAAI,sBAAsB,OAAO,CAAE,QAAO,IAAI,uBAAuB,OAAO;AAC5E,KAAI,eAAe,OAAO,CAAE,QAAO,IAAI,oBAAoB,OAAO;AAElE,OAAM,IAAI,MAAM,4BAA4B"}

package/dist/columns/column_snapshot_provider.d.ts

@@ -0,0 +1,73 @@
+import { PColumnDataUniversal } from "../render/internal.js";
+import { TreeNodeAccessor } from "../render/accessor.js";
+import { ColumnSnapshot } from "./column_snapshot.js";
+import { PColumn } from "@milaboratories/pl-model-common";
+
+//#region src/columns/column_snapshot_provider.d.ts
+/**
+ * Data source interface for column enumeration.
+ *
+ * Knows nothing about the render framework, stability tracking, labels,
+ * anchoring, or splitting. All that complexity lives in the collection layer.
+ */
+interface ColumnSnapshotProvider {
+  /** Returns all currently known columns. */
+  getAllColumns(): ColumnSnapshot[];
+  /** Whether the provider has finished enumerating all its columns.
+   *  Calling this may mark the render context unstable — it touches
+   *  the reactive tree to check field resolution state. */
+  isColumnListComplete(): boolean;
+}
+/**
+ * Union of types that can serve as column sources for helpers and builders.
+ * Does NOT include TreeNodeAccessor — call `.toColumnSource()` on it first.
+ */
+type ColumnSource = ColumnSnapshotProvider | ColumnSnapshot[] | PColumn<PColumnDataUniversal | undefined>[];
+/**
+ * Simple provider wrapping an array of PColumns.
+ * Always complete, data status always 'ready'.
+ */
+declare class ArrayColumnProvider implements ColumnSnapshotProvider {
+  private readonly columns;
+  constructor(columns: PColumn<PColumnDataUniversal | undefined>[]);
+  getAllColumns(): ColumnSnapshot[];
+  isColumnListComplete(): boolean;
+}
+/**
+ * Provider wrapping an array of ColumnSnapshots.
+ * Always complete. Data status taken from each snapshot.
+ */
+declare class SnapshotColumnProvider implements ColumnSnapshotProvider {
+  private readonly snapshots;
+  constructor(snapshots: ColumnSnapshot[]);
+  getAllColumns(): ColumnSnapshot[];
+  isColumnListComplete(): boolean;
+}
+interface OutputColumnProviderOpts {
+  /** When true and the accessor is final, columns with no ready data get status 'absent'. */
+  allowPermanentAbsence?: boolean;
+}
+/**
+ * Provider wrapping a TreeNodeAccessor (output/prerun resolve result).
+ * Detects data status from accessor readiness state.
+ */
+declare class OutputColumnProvider implements ColumnSnapshotProvider {
+  private readonly accessor;
+  private readonly opts?;
+  constructor(accessor: TreeNodeAccessor, opts?: OutputColumnProviderOpts | undefined);
+  getAllColumns(): ColumnSnapshot[];
+  isColumnListComplete(): boolean;
+  private getColumns;
+}
+/** Checks if a value is a ColumnSnapshotProvider (duck-typing). */
+declare function isColumnSnapshotProvider(source: unknown): source is ColumnSnapshotProvider;
+/**
+ * Normalize any ColumnSource into a ColumnSnapshotProvider.
+ * - ColumnSnapshotProvider → returned as-is
+ * - ColumnSnapshot[] → wrapped in SnapshotColumnProvider
+ * - PColumn[] → wrapped in ArrayColumnProvider
+ */
+declare function toColumnSnapshotProvider(source: ColumnSource): ColumnSnapshotProvider;
+//#endregion
+export { ArrayColumnProvider, ColumnSnapshotProvider, ColumnSource, OutputColumnProvider, OutputColumnProviderOpts, SnapshotColumnProvider, isColumnSnapshotProvider, toColumnSnapshotProvider };
+//# sourceMappingURL=column_snapshot_provider.d.ts.map

package/dist/columns/column_snapshot_provider.js

@@ -0,0 +1,107 @@
+//#region src/columns/column_snapshot_provider.ts
+/**
+* Simple provider wrapping an array of PColumns.
+* Always complete, data status always 'ready'.
+*/
+var ArrayColumnProvider = class {
+	columns;
+	constructor(columns) {
+		this.columns = columns.map((col) => ({
+			id: col.id,
+			spec: col.spec,
+			dataStatus: "ready",
+			data: { get: () => col.data }
+		}));
+	}
+	getAllColumns() {
+		return this.columns;
+	}
+	isColumnListComplete() {
+		return true;
+	}
+};
+/**
+* Provider wrapping an array of ColumnSnapshots.
+* Always complete. Data status taken from each snapshot.
+*/
+var SnapshotColumnProvider = class {
+	constructor(snapshots) {
+		this.snapshots = snapshots;
+	}
+	getAllColumns() {
+		return this.snapshots;
+	}
+	isColumnListComplete() {
+		return true;
+	}
+};
+/**
+* Provider wrapping a TreeNodeAccessor (output/prerun resolve result).
+* Detects data status from accessor readiness state.
+*/
+var OutputColumnProvider = class {
+	constructor(accessor, opts) {
+		this.accessor = accessor;
+		this.opts = opts;
+	}
+	getAllColumns() {
+		return this.getColumns();
+	}
+	isColumnListComplete() {
+		return this.accessor.getInputsLocked();
+	}
+	getColumns() {
+		const pColumns = this.accessor.getPColumns();
+		if (pColumns === void 0) return [];
+		const isFinal = this.accessor.getIsFinal();
+		const allowAbsence = this.opts?.allowPermanentAbsence === true;
+		return pColumns.map((col) => {
+			const dataAccessor = col.data;
+			const isReady = dataAccessor.getIsReadyOrError();
+			let dataStatus;
+			if (isReady) dataStatus = "ready";
+			else if (allowAbsence && isFinal) dataStatus = "absent";
+			else dataStatus = "computing";
+			return {
+				id: col.id,
+				spec: col.spec,
+				dataStatus,
+				data: { get: () => isReady ? dataAccessor : void 0 }
+			};
+		});
+	}
+};
+/** Checks if a value is a ColumnSnapshotProvider (duck-typing). */
+function isColumnSnapshotProvider(source) {
+	return typeof source === "object" && source !== null && "getAllColumns" in source && "isColumnListComplete" in source && typeof source.getAllColumns === "function" && typeof source.isColumnListComplete === "function";
+}
+/** Checks if a value looks like a PColumn (has id, spec, data). */
+function isPColumnArray(source) {
+	if (!Array.isArray(source)) return false;
+	if (source.length === 0) return true;
+	const first = source[0];
+	return "id" in first && "spec" in first && "data" in first && !("dataStatus" in first);
+}
+/** Checks if a value looks like a ColumnSnapshot array. */
+function isColumnSnapshotArray(source) {
+	if (!Array.isArray(source)) return false;
+	if (source.length === 0) return true;
+	const first = source[0];
+	return "id" in first && "spec" in first && "dataStatus" in first;
+}
+/**
+* Normalize any ColumnSource into a ColumnSnapshotProvider.
+* - ColumnSnapshotProvider → returned as-is
+* - ColumnSnapshot[] → wrapped in SnapshotColumnProvider
+* - PColumn[] → wrapped in ArrayColumnProvider
+*/
+function toColumnSnapshotProvider(source) {
+	if (isColumnSnapshotProvider(source)) return source;
+	if (isColumnSnapshotArray(source)) return new SnapshotColumnProvider(source);
+	if (isPColumnArray(source)) return new ArrayColumnProvider(source);
+	throw new Error("Unknown ColumnSource type");
+}
+
+//#endregion
+export { ArrayColumnProvider, OutputColumnProvider, SnapshotColumnProvider, isColumnSnapshotProvider, toColumnSnapshotProvider };
+//# sourceMappingURL=column_snapshot_provider.js.map

package/dist/columns/column_snapshot_provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column_snapshot_provider.js","names":[],"sources":["../../src/columns/column_snapshot_provider.ts"],"sourcesContent":["import { PColumn } from \"@milaboratories/pl-model-common\";\nimport { TreeNodeAccessor } from \"../render/accessor\";\nimport type { PColumnDataUniversal } from \"../render/internal\";\nimport type { ColumnDataStatus, ColumnSnapshot } from \"./column_snapshot\";\n\n// --- ColumnProvider ---\n\n/**\n * Data source interface for column enumeration.\n *\n * Knows nothing about the render framework, stability tracking, labels,\n * anchoring, or splitting. All that complexity lives in the collection layer.\n */\nexport interface ColumnSnapshotProvider {\n  /** Returns all currently known columns. */\n  getAllColumns(): ColumnSnapshot[];\n\n  /** Whether the provider has finished enumerating all its columns.\n   *  Calling this may mark the render context unstable — it touches\n   *  the reactive tree to check field resolution state. */\n  isColumnListComplete(): boolean;\n}\n\n// --- ColumnSource ---\n\n/**\n * Union of types that can serve as column sources for helpers and builders.\n * Does NOT include TreeNodeAccessor — call `.toColumnSource()` on it first.\n */\nexport type ColumnSource =\n  | ColumnSnapshotProvider\n  | ColumnSnapshot[]\n  | PColumn<PColumnDataUniversal | undefined>[];\n\n// --- ArrayColumnProvider ---\n\n/**\n * Simple provider wrapping an array of PColumns.\n * Always complete, data status always 'ready'.\n */\nexport class ArrayColumnProvider implements ColumnSnapshotProvider {\n  private readonly columns: ColumnSnapshot[];\n\n  constructor(columns: PColumn<PColumnDataUniversal | undefined>[]) {\n    this.columns = columns.map((col) => ({\n      id: col.id,\n      spec: col.spec,\n      dataStatus: \"ready\" as const,\n      data: { get: () => col.data },\n    }));\n  }\n\n  getAllColumns(): ColumnSnapshot[] {\n    return this.columns;\n  }\n\n  isColumnListComplete(): boolean {\n    return true;\n  }\n}\n\n// --- SnapshotColumnProvider ---\n\n/**\n * Provider wrapping an array of ColumnSnapshots.\n * Always complete. Data status taken from each snapshot.\n */\nexport class SnapshotColumnProvider implements ColumnSnapshotProvider {\n  constructor(private readonly snapshots: ColumnSnapshot[]) {}\n\n  getAllColumns(): ColumnSnapshot[] {\n    return this.snapshots;\n  }\n\n  isColumnListComplete(): boolean {\n    return true;\n  }\n}\n\n// --- OutputColumnProvider ---\n\nexport interface OutputColumnProviderOpts {\n  /** When true and the accessor is final, columns with no ready data get status 'absent'. */\n  allowPermanentAbsence?: boolean;\n}\n\n/**\n * Provider wrapping a TreeNodeAccessor (output/prerun resolve result).\n * Detects data status from accessor readiness state.\n */\nexport class OutputColumnProvider implements ColumnSnapshotProvider {\n  constructor(\n    private readonly accessor: TreeNodeAccessor,\n    private readonly opts?: OutputColumnProviderOpts,\n  ) {}\n\n  getAllColumns(): ColumnSnapshot[] {\n    return this.getColumns();\n  }\n\n  isColumnListComplete(): boolean {\n    return this.accessor.getInputsLocked();\n  }\n\n  private getColumns(): ColumnSnapshot[] {\n    const pColumns = this.accessor.getPColumns();\n    if (pColumns === undefined) return [];\n\n    const isFinal = this.accessor.getIsFinal();\n    const allowAbsence = this.opts?.allowPermanentAbsence === true;\n\n    return pColumns.map((col) => {\n      const dataAccessor = col.data;\n      const isReady = dataAccessor.getIsReadyOrError();\n\n      let dataStatus: ColumnDataStatus;\n      if (isReady) {\n        dataStatus = \"ready\";\n      } else if (allowAbsence && isFinal) {\n        dataStatus = \"absent\";\n      } else {\n        dataStatus = \"computing\";\n      }\n\n      return {\n        id: col.id,\n        spec: col.spec,\n        dataStatus,\n        data: { get: () => (isReady ? dataAccessor : undefined) },\n      };\n    });\n  }\n}\n\n// --- Source normalization ---\n\n/** Checks if a value is a ColumnSnapshotProvider (duck-typing). */\nexport function isColumnSnapshotProvider(source: unknown): source is ColumnSnapshotProvider {\n  return (\n    typeof source === \"object\" &&\n    source !== null &&\n    \"getAllColumns\" in source &&\n    \"isColumnListComplete\" in source &&\n    typeof (source as ColumnSnapshotProvider).getAllColumns === \"function\" &&\n    typeof (source as ColumnSnapshotProvider).isColumnListComplete === \"function\"\n  );\n}\n\n/** Checks if a value looks like a PColumn (has id, spec, data). */\nfunction isPColumnArray(source: unknown): source is PColumn<PColumnDataUniversal | undefined>[] {\n  if (!Array.isArray(source)) return false;\n  if (source.length === 0) return true; // empty array — treat as PColumn[]\n  const first = source[0];\n  return \"id\" in first && \"spec\" in first && \"data\" in first && !(\"dataStatus\" in first);\n}\n\n/** Checks if a value looks like a ColumnSnapshot array. */\nfunction isColumnSnapshotArray(source: unknown): source is ColumnSnapshot[] {\n  if (!Array.isArray(source)) return false;\n  if (source.length === 0) return true; // empty array — treat as snapshots\n  const first = source[0];\n  return \"id\" in first && \"spec\" in first && \"dataStatus\" in first;\n}\n\n/**\n * Normalize any ColumnSource into a ColumnSnapshotProvider.\n * - ColumnSnapshotProvider → returned as-is\n * - ColumnSnapshot[] → wrapped in SnapshotColumnProvider\n * - PColumn[] → wrapped in ArrayColumnProvider\n */\nexport function toColumnSnapshotProvider(source: ColumnSource): ColumnSnapshotProvider {\n  if (isColumnSnapshotProvider(source)) return source;\n  if (isColumnSnapshotArray(source)) return new SnapshotColumnProvider(source);\n  if (isPColumnArray(source)) return new ArrayColumnProvider(source);\n  // Should not reach here given the type union, but be safe\n  throw new Error(\"Unknown ColumnSource type\");\n}\n"],"mappings":";;;;;AAwCA,IAAa,sBAAb,MAAmE;CACjE,AAAiB;CAEjB,YAAY,SAAsD;AAChE,OAAK,UAAU,QAAQ,KAAK,SAAS;GACnC,IAAI,IAAI;GACR,MAAM,IAAI;GACV,YAAY;GACZ,MAAM,EAAE,WAAW,IAAI,MAAM;GAC9B,EAAE;;CAGL,gBAAkC;AAChC,SAAO,KAAK;;CAGd,uBAAgC;AAC9B,SAAO;;;;;;;AAUX,IAAa,yBAAb,MAAsE;CACpE,YAAY,AAAiB,WAA6B;EAA7B;;CAE7B,gBAAkC;AAChC,SAAO,KAAK;;CAGd,uBAAgC;AAC9B,SAAO;;;;;;;AAeX,IAAa,uBAAb,MAAoE;CAClE,YACE,AAAiB,UACjB,AAAiB,MACjB;EAFiB;EACA;;CAGnB,gBAAkC;AAChC,SAAO,KAAK,YAAY;;CAG1B,uBAAgC;AAC9B,SAAO,KAAK,SAAS,iBAAiB;;CAGxC,AAAQ,aAA+B;EACrC,MAAM,WAAW,KAAK,SAAS,aAAa;AAC5C,MAAI,aAAa,OAAW,QAAO,EAAE;EAErC,MAAM,UAAU,KAAK,SAAS,YAAY;EAC1C,MAAM,eAAe,KAAK,MAAM,0BAA0B;AAE1D,SAAO,SAAS,KAAK,QAAQ;GAC3B,MAAM,eAAe,IAAI;GACzB,MAAM,UAAU,aAAa,mBAAmB;GAEhD,IAAI;AACJ,OAAI,QACF,cAAa;YACJ,gBAAgB,QACzB,cAAa;OAEb,cAAa;AAGf,UAAO;IACL,IAAI,IAAI;IACR,MAAM,IAAI;IACV;IACA,MAAM,EAAE,WAAY,UAAU,eAAe,QAAY;IAC1D;IACD;;;;AAON,SAAgB,yBAAyB,QAAmD;AAC1F,QACE,OAAO,WAAW,YAClB,WAAW,QACX,mBAAmB,UACnB,0BAA0B,UAC1B,OAAQ,OAAkC,kBAAkB,cAC5D,OAAQ,OAAkC,yBAAyB;;;AAKvE,SAAS,eAAe,QAAwE;AAC9F,KAAI,CAAC,MAAM,QAAQ,OAAO,CAAE,QAAO;AACnC,KAAI,OAAO,WAAW,EAAG,QAAO;CAChC,MAAM,QAAQ,OAAO;AACrB,QAAO,QAAQ,SAAS,UAAU,SAAS,UAAU,SAAS,EAAE,gBAAgB;;;AAIlF,SAAS,sBAAsB,QAA6C;AAC1E,KAAI,CAAC,MAAM,QAAQ,OAAO,CAAE,QAAO;AACnC,KAAI,OAAO,WAAW,EAAG,QAAO;CAChC,MAAM,QAAQ,OAAO;AACrB,QAAO,QAAQ,SAAS,UAAU,SAAS,gBAAgB;;;;;;;;AAS7D,SAAgB,yBAAyB,QAA8C;AACrF,KAAI,yBAAyB,OAAO,CAAE,QAAO;AAC7C,KAAI,sBAAsB,OAAO,CAAE,QAAO,IAAI,uBAAuB,OAAO;AAC5E,KAAI,eAAe,OAAO,CAAE,QAAO,IAAI,oBAAoB,OAAO;AAElE,OAAM,IAAI,MAAM,4BAA4B"}

package/dist/columns/ctx_column_sources.cjs

@@ -0,0 +1,84 @@
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_column_snapshot_provider = require('./column_snapshot_provider.cjs');
+let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
+
+//#region src/columns/ctx_column_sources.ts
+/**
+* Collect ColumnSnapshotProviders from all render context sources:
+*
+* - **resultPool** — all upstream columns (always included)
+* - **outputs** — PFrame fields from block execution outputs
+* - **prerun** — PFrame fields from prerun/staging results
+*
+* Returns an array of providers suitable for `ColumnCollectionBuilder.addSource()`.
+*/
+function collectCtxColumnSnapshotProviders(ctx) {
+	const providers = [];
+	providers.push(new ResultPoolColumnSnapshotProvider(ctx.resultPool));
+	const outputs = ctx.outputs;
+	if (outputs) providers.push(...collectPFrameProviders(outputs));
+	const prerun = ctx.prerun;
+	if (prerun) providers.push(...collectPFrameProviders(prerun));
+	return providers;
+}
+/**
+* Adapter wrapping ResultPool into the new ColumnSnapshotProvider interface.
+*
+* - `isColumnListComplete()` always returns true — the result pool
+*   is a stable snapshot within a single render cycle.
+* - Data status is derived from the underlying TreeNodeAccessor:
+*   ready (getIsReadyOrError), computing, or absent (no data resource).
+*/
+var ResultPoolColumnSnapshotProvider = class {
+	constructor(pool) {
+		this.pool = pool;
+	}
+	getAllColumns() {
+		return this.pool.selectColumns(() => true).map((col) => toSnapshot(col.id, col.spec, col.data));
+	}
+	isColumnListComplete() {
+		return true;
+	}
+};
+function toSnapshot(id, spec, accessor) {
+	if (accessor === void 0) return {
+		id,
+		spec,
+		dataStatus: "absent",
+		data: void 0
+	};
+	const isReady = accessor.getIsReadyOrError();
+	return {
+		id,
+		spec,
+		dataStatus: isReady ? "ready" : "computing",
+		data: { get: () => isReady ? accessor : void 0 }
+	};
+}
+/**
+* Recursively walk the output tree starting from `accessor`.
+* - If a node's resourceType is PFrame → wrap it as OutputColumnProvider.
+* - If a node's resourceType is StdMap/std/map → recurse into its output fields.
+* - Otherwise → skip (leaf of unknown type).
+*/
+function collectPFrameProviders(accessor) {
+	const out = [];
+	walkTree(accessor, out);
+	return out;
+}
+function walkTree(node, out) {
+	const typeName = node.resourceType.name;
+	if (typeName === _milaboratories_pl_model_common.ResourceTypeName.PFrame) {
+		out.push(new require_column_snapshot_provider.OutputColumnProvider(node));
+		return;
+	}
+	if (typeName === _milaboratories_pl_model_common.ResourceTypeName.StdMap || typeName === _milaboratories_pl_model_common.ResourceTypeName.StdMapSlash) for (const field of node.listInputFields()) {
+		const child = node.resolve(field);
+		if (child) walkTree(child, out);
+	}
+}
+
+//#endregion
+exports.ResultPoolColumnSnapshotProvider = ResultPoolColumnSnapshotProvider;
+exports.collectCtxColumnSnapshotProviders = collectCtxColumnSnapshotProviders;
+//# sourceMappingURL=ctx_column_sources.cjs.map