@platforma-sdk/model 1.63.12 → 1.65.0

package/dist/columns/column_selector.js

@@ -18,7 +18,7 @@ function normalizeRecord(input) {
 function normalizeTypes(input) {
 	return Array.isArray(input) ? input : [input];
 }
-function normalizeAxisSelector(input) {
+function convertRelaxedAxisSelectorToMultiAxisSelector(input) {
 	const result = {};
 	if (input.name !== void 0) result.name = normalizeStringMatchers(input.name);
 	if (input.type !== void 0) result.type = normalizeTypes(input.type);
@@ -27,92 +27,21 @@ function normalizeAxisSelector(input) {
 	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) {
+function convertRelaxedColumnSelectorToMultiColumnSelector(input) {
 	const result = {};
 	if (input.name !== void 0) result.name = normalizeStringMatchers(input.name);
 	if (input.type !== void 0) result.type = normalizeTypes(input.type);
 	if (input.domain !== void 0) result.domain = normalizeRecord(input.domain);
 	if (input.contextDomain !== void 0) result.contextDomain = normalizeRecord(input.contextDomain);
 	if (input.annotations !== void 0) result.annotations = normalizeRecord(input.annotations);
-	if (input.axes !== void 0) result.axes = input.axes.map(normalizeAxisSelector);
+	if (input.axes !== void 0) result.axes = input.axes.map(convertRelaxedAxisSelectorToMultiAxisSelector);
 	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);
+function convertColumnSelectorToMultiColumnSelector(input) {
+	return (Array.isArray(input) ? input : [input]).map(convertRelaxedColumnSelectorToMultiColumnSelector);
 }
 //#endregion
-export { columnSelectorsToPredicate, matchColumn, matchColumnSelectors, normalizeSelectors };
+export { convertColumnSelectorToMultiColumnSelector, convertRelaxedAxisSelectorToMultiAxisSelector, convertRelaxedColumnSelectorToMultiColumnSelector };
 
 //# sourceMappingURL=column_selector.js.map

package/dist/columns/column_selector.js.map

@@ -1 +1 @@
-{"version":3,"file":"column_selector.js","names":[],"sources":["../../src/columns/column_selector.ts"],"sourcesContent":["import type {\n  AxisValueType,\n  ColumnValueType,\n  MultiAxisSelector,\n  MultiColumnSelector,\n  PColumnSpec,\n  StringMatcher,\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?: AxisValueType | AxisValueType[];\n  domain?: RelaxedRecord;\n  contextDomain?: RelaxedRecord;\n  annotations?: RelaxedRecord;\n}\n\n/** Relaxed column selector — convenient hand-written form. */\nexport interface RelaxedColumnSelector {\n  name?: RelaxedStringMatchers;\n  type?: ColumnValueType | ColumnValueType[];\n  domain?: RelaxedRecord;\n  contextDomain?: RelaxedRecord;\n  annotations?: RelaxedRecord;\n  axes?: RelaxedAxisSelector[];\n  partialAxesMatch?: boolean;\n}\n\n/** 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<T>(input: T | T[]): T[] {\n  return Array.isArray(input) ? input : [input];\n}\n\ntype Mutable<T> = { -readonly [K in keyof T]: T[K] };\n\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)) 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":";AA4CA,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,eAAkB,OAAqB;AAC9C,QAAO,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM;;AAK/C,SAAS,sBAAsB,OAA+C;CAC5E,MAAM,SAAqC,EAAE;AAC7C,KAAI,MAAM,SAAS,KAAA,EAAW,QAAO,OAAO,wBAAwB,MAAM,KAAK;AAC/E,KAAI,MAAM,SAAS,KAAA,EAAW,QAAO,OAAO,eAAe,MAAM,KAAK;AACtE,KAAI,MAAM,WAAW,KAAA,EAAW,QAAO,SAAS,gBAAgB,MAAM,OAAO;AAC7E,KAAI,MAAM,kBAAkB,KAAA,EAC1B,QAAO,gBAAgB,gBAAgB,MAAM,cAAc;AAC7D,KAAI,MAAM,gBAAgB,KAAA,EAAW,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,KAAA,EAAW,QAAO,OAAO,wBAAwB,MAAM,KAAK;AAC/E,KAAI,MAAM,SAAS,KAAA,EAAW,QAAO,OAAO,eAAe,MAAM,KAAK;AACtE,KAAI,MAAM,WAAW,KAAA,EAAW,QAAO,SAAS,gBAAgB,MAAM,OAAO;AAC7E,KAAI,MAAM,kBAAkB,KAAA,EAC1B,QAAO,gBAAgB,gBAAgB,MAAM,cAAc;AAC7D,KAAI,MAAM,gBAAgB,KAAA,EAAW,QAAO,cAAc,gBAAgB,MAAM,YAAY;AAC5F,KAAI,MAAM,SAAS,KAAA,EAAW,QAAO,OAAO,MAAM,KAAK,IAAI,sBAAsB;AACjF,KAAI,MAAM,qBAAqB,KAAA,EAAW,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,KAAA,EAAW,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,KAAA,KAAa,CAAC,iBAAiB,KAAK,MAAM,SAAS,KAAK,CAAE,QAAO;AACvF,KAAI,SAAS,SAAS,KAAA,KAAa,CAAC,SAAS,KAAK,SAAS,KAAK,KAAK,CAAE,QAAO;AAC9E,KAAI,SAAS,WAAW,KAAA,KAAa,CAAC,iBAAiB,KAAK,QAAQ,SAAS,OAAO,CAClF,QAAO;AACT,KACE,SAAS,kBAAkB,KAAA,KAC3B,CAAC,iBACC,mBAAmB,OAAQ,KAAK,gBAA2C,KAAA,GAC3E,SAAS,cACV,CAED,QAAO;AACT,KACE,SAAS,gBAAgB,KAAA,KACzB,CAAC,iBAAiB,KAAK,aAAa,SAAS,YAAY,CAEzD,QAAO;AACT,QAAO;;;AAIT,SAAgB,YAAY,MAAmB,UAAwC;AACrF,KAAI,SAAS,SAAS,KAAA,KAAa,CAAC,iBAAiB,KAAK,MAAM,SAAS,KAAK,CAAE,QAAO;AACvF,KAAI,SAAS,SAAS,KAAA,KAAa,CAAC,SAAS,KAAK,SAAS,KAAK,UAAU,CAAE,QAAO;AAEnF,KAAI,SAAS,WAAW,KAAA;MAElB,CAAC,iBADY,kBAAkB,KAAK,EACR,SAAS,OAAO,CAAE,QAAO;;AAG3D,KAAI,SAAS,kBAAkB,KAAA;MAEzB,CAAC,iBADY,yBAAyB,KAAK,EACf,SAAS,cAAc,CAAE,QAAO;;AAGlE,KAAI,SAAS,gBAAgB,KAAA;MACvB,CAAC,iBAAiB,KAAK,aAAa,SAAS,YAAY,CAAE,QAAO;;AAGxE,KAAI,SAAS,SAAS,KAAA,EAEpB,KADqB,SAAS,oBAAoB;OAE3C,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"}
+{"version":3,"file":"column_selector.js","names":[],"sources":["../../src/columns/column_selector.ts"],"sourcesContent":["import type {\n  AxisValueType,\n  ColumnValueType,\n  MultiAxisSelector,\n  MultiColumnSelector,\n  StringMatcher,\n} from \"@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?: AxisValueType | AxisValueType[];\n  domain?: RelaxedRecord;\n  contextDomain?: RelaxedRecord;\n  annotations?: RelaxedRecord;\n}\n\n/** Relaxed column selector — convenient hand-written form. */\nexport interface RelaxedColumnSelector {\n  name?: RelaxedStringMatchers;\n  type?: ColumnValueType | ColumnValueType[];\n  domain?: RelaxedRecord;\n  contextDomain?: RelaxedRecord;\n  annotations?: RelaxedRecord;\n  axes?: RelaxedAxisSelector[];\n  partialAxesMatch?: boolean;\n}\n\n/** Input that normalizes to ColumnSelector[]. */\nexport type ColumnSelector = RelaxedColumnSelector | RelaxedColumnSelector[];\n\n// --- Normalization ---\n\nfunction normalizeStringMatchers(input: RelaxedStringMatchers): StringMatcher[] {\n  if (typeof input === \"string\") return [{ type: \"regex\", value: input }];\n  if (!Array.isArray(input)) return [input];\n  return input.map((v) =>\n    typeof v === \"string\" ? ({ type: \"regex\", value: v } satisfies StringMatcher) : v,\n  );\n}\n\nfunction normalizeRecord(input: RelaxedRecord): Record<string, StringMatcher[]> {\n  const result: Record<string, StringMatcher[]> = {};\n  for (const [key, value] of Object.entries(input)) {\n    result[key] = normalizeStringMatchers(value);\n  }\n  return result;\n}\n\nfunction normalizeTypes<T>(input: T | T[]): T[] {\n  return Array.isArray(input) ? input : [input];\n}\n\ntype Mutable<T> = { -readonly [K in keyof T]: T[K] };\n\nexport function convertRelaxedAxisSelectorToMultiAxisSelector(\n  input: RelaxedAxisSelector,\n): MultiAxisSelector {\n  const result: Mutable<MultiAxisSelector> = {};\n  if (input.name !== undefined) result.name = normalizeStringMatchers(input.name);\n  if (input.type !== undefined) result.type = normalizeTypes(input.type);\n  if (input.domain !== undefined) result.domain = normalizeRecord(input.domain);\n  if (input.contextDomain !== undefined)\n    result.contextDomain = normalizeRecord(input.contextDomain);\n  if (input.annotations !== undefined) result.annotations = normalizeRecord(input.annotations);\n  return result;\n}\n\nexport function convertRelaxedColumnSelectorToMultiColumnSelector(\n  input: RelaxedColumnSelector,\n): MultiColumnSelector {\n  const result: Mutable<MultiColumnSelector> = {};\n  if (input.name !== undefined) result.name = normalizeStringMatchers(input.name);\n  if (input.type !== undefined) result.type = normalizeTypes(input.type);\n  if (input.domain !== undefined) result.domain = normalizeRecord(input.domain);\n  if (input.contextDomain !== undefined)\n    result.contextDomain = normalizeRecord(input.contextDomain);\n  if (input.annotations !== undefined) result.annotations = normalizeRecord(input.annotations);\n  if (input.axes !== undefined)\n    result.axes = input.axes.map(convertRelaxedAxisSelectorToMultiAxisSelector);\n  if (input.partialAxesMatch !== undefined) result.partialAxesMatch = input.partialAxesMatch;\n  return result;\n}\n\nexport function convertColumnSelectorToMultiColumnSelector(\n  input: ColumnSelector,\n): MultiColumnSelector[] {\n  const arr = Array.isArray(input) ? input : [input];\n  return arr.map(convertRelaxedColumnSelectorToMultiColumnSelector);\n}\n"],"mappings":";AA2CA,SAAS,wBAAwB,OAA+C;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,eAAkB,OAAqB;AAC9C,QAAO,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM;;AAK/C,SAAgB,8CACd,OACmB;CACnB,MAAM,SAAqC,EAAE;AAC7C,KAAI,MAAM,SAAS,KAAA,EAAW,QAAO,OAAO,wBAAwB,MAAM,KAAK;AAC/E,KAAI,MAAM,SAAS,KAAA,EAAW,QAAO,OAAO,eAAe,MAAM,KAAK;AACtE,KAAI,MAAM,WAAW,KAAA,EAAW,QAAO,SAAS,gBAAgB,MAAM,OAAO;AAC7E,KAAI,MAAM,kBAAkB,KAAA,EAC1B,QAAO,gBAAgB,gBAAgB,MAAM,cAAc;AAC7D,KAAI,MAAM,gBAAgB,KAAA,EAAW,QAAO,cAAc,gBAAgB,MAAM,YAAY;AAC5F,QAAO;;AAGT,SAAgB,kDACd,OACqB;CACrB,MAAM,SAAuC,EAAE;AAC/C,KAAI,MAAM,SAAS,KAAA,EAAW,QAAO,OAAO,wBAAwB,MAAM,KAAK;AAC/E,KAAI,MAAM,SAAS,KAAA,EAAW,QAAO,OAAO,eAAe,MAAM,KAAK;AACtE,KAAI,MAAM,WAAW,KAAA,EAAW,QAAO,SAAS,gBAAgB,MAAM,OAAO;AAC7E,KAAI,MAAM,kBAAkB,KAAA,EAC1B,QAAO,gBAAgB,gBAAgB,MAAM,cAAc;AAC7D,KAAI,MAAM,gBAAgB,KAAA,EAAW,QAAO,cAAc,gBAAgB,MAAM,YAAY;AAC5F,KAAI,MAAM,SAAS,KAAA,EACjB,QAAO,OAAO,MAAM,KAAK,IAAI,8CAA8C;AAC7E,KAAI,MAAM,qBAAqB,KAAA,EAAW,QAAO,mBAAmB,MAAM;AAC1E,QAAO;;AAGT,SAAgB,2CACd,OACuB;AAEvB,SADY,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM,EACvC,IAAI,kDAAkD"}

package/dist/columns/column_snapshot.cjs

@@ -4,12 +4,12 @@ function createReadyColumnData(getData) {
 	return { get: getData };
 }
 /** Creates a ColumnSnapshot from parts. */
-function createColumnSnapshot(id, spec, dataStatus, data) {
+function createColumnSnapshot(id, spec, data, dataStatus) {
 	return {
 		id,
 		spec,
-		dataStatus,
-		data
+		data,
+		dataStatus
 	};
 }
 //#endregion

package/dist/columns/column_snapshot.cjs.map

@@ -1 +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"}
+{"version":3,"file":"column_snapshot.cjs","names":[],"sources":["../../src/columns/column_snapshot.ts"],"sourcesContent":["import type { PColumnSpec, PObjectId, SUniversalPColumnId } 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 | SUniversalPColumnId> {\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>(\n  id: Id,\n  spec: PColumnSpec,\n  data: undefined | ColumnData,\n  dataStatus: ColumnDataStatus,\n): ColumnSnapshot<Id> {\n  return { id, spec, data, dataStatus };\n}\n"],"mappings":";;AAwCA,SAAgB,sBAAsB,SAA6D;AACjG,QAAO,EAAE,KAAK,SAAS;;;AAMzB,SAAgB,qBACd,IACA,MACA,MACA,YACoB;AACpB,QAAO;EAAE;EAAI;EAAM;EAAM;EAAY"}

package/dist/columns/column_snapshot.d.ts

@@ -1,5 +1,5 @@
 import { PColumnDataUniversal } from "../render/internal.js";
-import { PColumnSpec, PObjectId } from "@milaboratories/pl-model-common";
+import { PColumnSpec, PObjectId, SUniversalPColumnId } from "@milaboratories/pl-model-common";
 
 //#region src/columns/column_snapshot.d.ts
 /** Data status of a column snapshot. */
@@ -11,7 +11,7 @@ type ColumnDataStatus = "ready" | "computing" | "absent";
  * - `data` holds an active object when data exists (ready or computing),
  *   or `undefined` when data is permanently absent.
  */
-interface ColumnSnapshot<Id extends PObjectId = PObjectId> {
+interface ColumnSnapshot<Id extends PObjectId | SUniversalPColumnId> {
   readonly id: Id;
   readonly spec: PColumnSpec;
   readonly dataStatus: ColumnDataStatus;
@@ -33,7 +33,7 @@ interface ColumnData {
 /** 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>;
+declare function createColumnSnapshot<Id extends PObjectId>(id: Id, spec: PColumnSpec, data: undefined | ColumnData, dataStatus: ColumnDataStatus): ColumnSnapshot<Id>;
 //#endregion
 export { ColumnData, ColumnDataStatus, ColumnSnapshot, createColumnSnapshot, createReadyColumnData };
 //# sourceMappingURL=column_snapshot.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"column_snapshot.d.ts","names":[],"sources":["../../src/columns/column_snapshot.ts"],"mappings":";;;;;KAMY,gBAAA;AAAZ;;;;;AASA;;AATA,UASiB,cAAA,YAA0B,SAAA,GAAY,SAAA;EAAA,SAC5C,EAAA,EAAI,EAAA;EAAA,SACJ,IAAA,EAAM,WAAA;EAAA,SACN,UAAA,EAAY,gBAAA;EADN;;;;;;EAAA,SASN,IAAA,EAAM,UAAA;AAAA;;;;;UASA,UAAA;EACf,GAAA,IAAO,oBAAA;AAAA;;iBAIO,qBAAA,CAAsB,OAAA,QAAe,oBAAA,eAAmC,UAAA;;iBAOxE,oBAAA,YAAgC,SAAA,GAAY,SAAA,CAAA,CAC1D,EAAA,EAAI,EAAA,EACJ,IAAA,EAAM,WAAA,EACN,UAAA,EAAY,gBAAA,EACZ,IAAA,EAAM,UAAA,eACL,cAAA,CAAe,EAAA"}
+{"version":3,"file":"column_snapshot.d.ts","names":[],"sources":["../../src/columns/column_snapshot.ts"],"mappings":";;;;;KAMY,gBAAA;AAAZ;;;;;AASA;;AATA,UASiB,cAAA,YAA0B,SAAA,GAAY,mBAAA;EAAA,SAC5C,EAAA,EAAI,EAAA;EAAA,SACJ,IAAA,EAAM,WAAA;EAAA,SACN,UAAA,EAAY,gBAAA;EADN;;;;;;EAAA,SASN,IAAA,EAAM,UAAA;AAAA;;;;;UASA,UAAA;EACf,GAAA,IAAO,oBAAA;AAAA;;iBAIO,qBAAA,CAAsB,OAAA,QAAe,oBAAA,eAAmC,UAAA;;iBAOxE,oBAAA,YAAgC,SAAA,CAAA,CAC9C,EAAA,EAAI,EAAA,EACJ,IAAA,EAAM,WAAA,EACN,IAAA,cAAkB,UAAA,EAClB,UAAA,EAAY,gBAAA,GACX,cAAA,CAAe,EAAA"}

package/dist/columns/column_snapshot.js

@@ -4,12 +4,12 @@ function createReadyColumnData(getData) {
 	return { get: getData };
 }
 /** Creates a ColumnSnapshot from parts. */
-function createColumnSnapshot(id, spec, dataStatus, data) {
+function createColumnSnapshot(id, spec, data, dataStatus) {
 	return {
 		id,
 		spec,
-		dataStatus,
-		data
+		data,
+		dataStatus
 	};
 }
 //#endregion

package/dist/columns/column_snapshot.js.map

@@ -1 +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"}
+{"version":3,"file":"column_snapshot.js","names":[],"sources":["../../src/columns/column_snapshot.ts"],"sourcesContent":["import type { PColumnSpec, PObjectId, SUniversalPColumnId } 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 | SUniversalPColumnId> {\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>(\n  id: Id,\n  spec: PColumnSpec,\n  data: undefined | ColumnData,\n  dataStatus: ColumnDataStatus,\n): ColumnSnapshot<Id> {\n  return { id, spec, data, dataStatus };\n}\n"],"mappings":";;AAwCA,SAAgB,sBAAsB,SAA6D;AACjG,QAAO,EAAE,KAAK,SAAS;;;AAMzB,SAAgB,qBACd,IACA,MACA,MACA,YACoB;AACpB,QAAO;EAAE;EAAI;EAAM;EAAM;EAAY"}

package/dist/columns/column_snapshot_provider.cjs

@@ -92,7 +92,7 @@ function isColumnSnapshotArray(source) {
 /**
 * Normalize any ColumnSource into a ColumnSnapshotProvider.
 * - ColumnSnapshotProvider → returned as-is
-* - ColumnSnapshot[] → wrapped in SnapshotColumnProvider
+* - ColumnSnapshot<PObjectId>[] → wrapped in SnapshotColumnProvider
 * - PColumn[] → wrapped in ArrayColumnProvider
 */
 function toColumnSnapshotProvider(source) {

package/dist/columns/column_snapshot_provider.cjs.map

@@ -1 +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;CAEA,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,WAA8C;AAA7B,OAAA,YAAA;;CAE7B,gBAAkC;AAChC,SAAO,KAAK;;CAGd,uBAAgC;AAC9B,SAAO;;;;;;;AAeX,IAAa,uBAAb,MAAoE;CAClE,YACE,UACA,MACA;AAFiB,OAAA,WAAA;AACA,OAAA,OAAA;;CAGnB,gBAAkC;AAChC,SAAO,KAAK,YAAY;;CAG1B,uBAAgC;AAC9B,SAAO,KAAK,SAAS,iBAAiB;;CAGxC,aAAuC;EACrC,MAAM,WAAW,KAAK,SAAS,aAAa;AAC5C,MAAI,aAAa,KAAA,EAAW,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,KAAA,GAAY;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"}
+{"version":3,"file":"column_snapshot_provider.cjs","names":[],"sources":["../../src/columns/column_snapshot_provider.ts"],"sourcesContent":["import type { PObjectId } from \"@milaboratories/pl-model-common\";\nimport { 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<PObjectId>[];\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<PObjectId>[]\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<PObjectId>[];\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<PObjectId>[] {\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<PObjectId>[]) {}\n\n  getAllColumns(): ColumnSnapshot<PObjectId>[] {\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<PObjectId>[] {\n    return this.getColumns();\n  }\n\n  isColumnListComplete(): boolean {\n    return this.accessor.getInputsLocked();\n  }\n\n  private getColumns(): ColumnSnapshot<PObjectId>[] {\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<PObjectId>[] {\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<PObjectId>[] → 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":";;;;;AAyCA,IAAa,sBAAb,MAAmE;CACjE;CAEA,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,gBAA6C;AAC3C,SAAO,KAAK;;CAGd,uBAAgC;AAC9B,SAAO;;;;;;;AAUX,IAAa,yBAAb,MAAsE;CACpE,YAAY,WAAyD;AAAxC,OAAA,YAAA;;CAE7B,gBAA6C;AAC3C,SAAO,KAAK;;CAGd,uBAAgC;AAC9B,SAAO;;;;;;;AAeX,IAAa,uBAAb,MAAoE;CAClE,YACE,UACA,MACA;AAFiB,OAAA,WAAA;AACA,OAAA,OAAA;;CAGnB,gBAA6C;AAC3C,SAAO,KAAK,YAAY;;CAG1B,uBAAgC;AAC9B,SAAO,KAAK,SAAS,iBAAiB;;CAGxC,aAAkD;EAChD,MAAM,WAAW,KAAK,SAAS,aAAa;AAC5C,MAAI,aAAa,KAAA,EAAW,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,KAAA,GAAY;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,QAAwD;AACrF,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

@@ -1,7 +1,7 @@
 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";
+import { PColumn, PObjectId } from "@milaboratories/pl-model-common";
 
 //#region src/columns/column_snapshot_provider.d.ts
 /**
@@ -12,7 +12,7 @@ import { PColumn } from "@milaboratories/pl-model-common";
  */
 interface ColumnSnapshotProvider {
   /** Returns all currently known columns. */
-  getAllColumns(): ColumnSnapshot[];
+  getAllColumns(): ColumnSnapshot<PObjectId>[];
   /** 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. */
@@ -22,7 +22,7 @@ interface ColumnSnapshotProvider {
  * 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>[];
+type ColumnSource = ColumnSnapshotProvider | ColumnSnapshot<PObjectId>[] | PColumn<PColumnDataUniversal | undefined>[];
 /**
  * Simple provider wrapping an array of PColumns.
  * Always complete, data status always 'ready'.
@@ -30,7 +30,7 @@ type ColumnSource = ColumnSnapshotProvider | ColumnSnapshot[] | PColumn<PColumnD
 declare class ArrayColumnProvider implements ColumnSnapshotProvider {
   private readonly columns;
   constructor(columns: PColumn<PColumnDataUniversal | undefined>[]);
-  getAllColumns(): ColumnSnapshot[];
+  getAllColumns(): ColumnSnapshot<PObjectId>[];
   isColumnListComplete(): boolean;
 }
 /**
@@ -39,8 +39,8 @@ declare class ArrayColumnProvider implements ColumnSnapshotProvider {
  */
 declare class SnapshotColumnProvider implements ColumnSnapshotProvider {
   private readonly snapshots;
-  constructor(snapshots: ColumnSnapshot[]);
-  getAllColumns(): ColumnSnapshot[];
+  constructor(snapshots: ColumnSnapshot<PObjectId>[]);
+  getAllColumns(): ColumnSnapshot<PObjectId>[];
   isColumnListComplete(): boolean;
 }
 interface OutputColumnProviderOpts {
@@ -55,7 +55,7 @@ declare class OutputColumnProvider implements ColumnSnapshotProvider {
   private readonly accessor;
   private readonly opts?;
   constructor(accessor: TreeNodeAccessor, opts?: OutputColumnProviderOpts | undefined);
-  getAllColumns(): ColumnSnapshot[];
+  getAllColumns(): ColumnSnapshot<PObjectId>[];
   isColumnListComplete(): boolean;
   private getColumns;
 }
@@ -64,7 +64,7 @@ declare function isColumnSnapshotProvider(source: unknown): source is ColumnSnap
 /**
  * Normalize any ColumnSource into a ColumnSnapshotProvider.
  * - ColumnSnapshotProvider → returned as-is
- * - ColumnSnapshot[] → wrapped in SnapshotColumnProvider
+ * - ColumnSnapshot<PObjectId>[] → wrapped in SnapshotColumnProvider
  * - PColumn[] → wrapped in ArrayColumnProvider
  */
 declare function toColumnSnapshotProvider(source: ColumnSource): ColumnSnapshotProvider;

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

@@ -1 +1 @@
-{"version":3,"file":"column_snapshot_provider.d.ts","names":[],"sources":["../../src/columns/column_snapshot_provider.ts"],"mappings":";;;;;;;;AAaA;;;;UAAiB,sBAAA;EAEE;EAAjB,aAAA,IAAiB,cAAA;EAKG;;AAStB;EATE,oBAAA;AAAA;;;;;KASU,YAAA,GACR,sBAAA,GACA,cAAA,KACA,OAAA,CAAQ,oBAAA;;;;;cAQC,mBAAA,YAA+B,sBAAA;EAAA,iBACzB,OAAA;cAEL,OAAA,EAAS,OAAA,CAAQ,oBAAA;EAS7B,aAAA,CAAA,GAAiB,cAAA;EAIjB,oBAAA,CAAA;AAAA;;;;;cAWW,sBAAA,YAAkC,sBAAA;EAAA,iBAChB,SAAA;cAAA,SAAA,EAAW,cAAA;EAExC,aAAA,CAAA,GAAiB,cAAA;EAIjB,oBAAA,CAAA;AAAA;AAAA,UAOe,wBAAA;EAtCH;EAwCZ,qBAAA;AAAA;;;;AAhBF;cAuBa,oBAAA,YAAgC,sBAAA;EAAA,iBAExB,QAAA;EAAA,iBACA,IAAA;cADA,QAAA,EAAU,gBAAA,EACV,IAAA,GAAO,wBAAA;EAG1B,aAAA,CAAA,GAAiB,cAAA;EAIjB,oBAAA,CAAA;EAAA,QAIQ,UAAA;AAAA;;iBAiCM,wBAAA,CAAyB,MAAA,YAAkB,MAAA,IAAU,sBAAA;;;;;;;iBAiCrD,wBAAA,CAAyB,MAAA,EAAQ,YAAA,GAAe,sBAAA"}
+{"version":3,"file":"column_snapshot_provider.d.ts","names":[],"sources":["../../src/columns/column_snapshot_provider.ts"],"mappings":";;;;;;;AAcA;;;;;UAAiB,sBAAA;EAEiB;EAAhC,aAAA,IAAiB,cAAA,CAAe,SAAA;EAKZ;;AAStB;EATE,oBAAA;AAAA;;;;;KASU,YAAA,GACR,sBAAA,GACA,cAAA,CAAe,SAAA,MACf,OAAA,CAAQ,oBAAA;;;;;cAQC,mBAAA,YAA+B,sBAAA;EAAA,iBACzB,OAAA;cAEL,OAAA,EAAS,OAAA,CAAQ,oBAAA;EAS7B,aAAA,CAAA,GAAiB,cAAA,CAAe,SAAA;EAIhC,oBAAA,CAAA;AAAA;;;;;cAWW,sBAAA,YAAkC,sBAAA;EAAA,iBAChB,SAAA;cAAA,SAAA,EAAW,cAAA,CAAe,SAAA;EAEvD,aAAA,CAAA,GAAiB,cAAA,CAAe,SAAA;EAIhC,oBAAA,CAAA;AAAA;AAAA,UAOe,wBAAA;;EAEf,qBAAA;AAAA;;;;;cAOW,oBAAA,YAAgC,sBAAA;EAAA,iBAExB,QAAA;EAAA,iBACA,IAAA;cADA,QAAA,EAAU,gBAAA,EACV,IAAA,GAAO,wBAAA;EAG1B,aAAA,CAAA,GAAiB,cAAA,CAAe,SAAA;EAIhC,oBAAA,CAAA;EAAA,QAIQ,UAAA;AAAA;;iBAiCM,wBAAA,CAAyB,MAAA,YAAkB,MAAA,IAAU,sBAAA;;;;;;;iBAiCrD,wBAAA,CAAyB,MAAA,EAAQ,YAAA,GAAe,sBAAA"}

package/dist/columns/column_snapshot_provider.js

@@ -92,7 +92,7 @@ function isColumnSnapshotArray(source) {
 /**
 * Normalize any ColumnSource into a ColumnSnapshotProvider.
 * - ColumnSnapshotProvider → returned as-is
-* - ColumnSnapshot[] → wrapped in SnapshotColumnProvider
+* - ColumnSnapshot<PObjectId>[] → wrapped in SnapshotColumnProvider
 * - PColumn[] → wrapped in ArrayColumnProvider
 */
 function toColumnSnapshotProvider(source) {

package/dist/columns/column_snapshot_provider.js.map

@@ -1 +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;CAEA,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,WAA8C;AAA7B,OAAA,YAAA;;CAE7B,gBAAkC;AAChC,SAAO,KAAK;;CAGd,uBAAgC;AAC9B,SAAO;;;;;;;AAeX,IAAa,uBAAb,MAAoE;CAClE,YACE,UACA,MACA;AAFiB,OAAA,WAAA;AACA,OAAA,OAAA;;CAGnB,gBAAkC;AAChC,SAAO,KAAK,YAAY;;CAG1B,uBAAgC;AAC9B,SAAO,KAAK,SAAS,iBAAiB;;CAGxC,aAAuC;EACrC,MAAM,WAAW,KAAK,SAAS,aAAa;AAC5C,MAAI,aAAa,KAAA,EAAW,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,KAAA,GAAY;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"}
+{"version":3,"file":"column_snapshot_provider.js","names":[],"sources":["../../src/columns/column_snapshot_provider.ts"],"sourcesContent":["import type { PObjectId } from \"@milaboratories/pl-model-common\";\nimport { 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<PObjectId>[];\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<PObjectId>[]\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<PObjectId>[];\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<PObjectId>[] {\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<PObjectId>[]) {}\n\n  getAllColumns(): ColumnSnapshot<PObjectId>[] {\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<PObjectId>[] {\n    return this.getColumns();\n  }\n\n  isColumnListComplete(): boolean {\n    return this.accessor.getInputsLocked();\n  }\n\n  private getColumns(): ColumnSnapshot<PObjectId>[] {\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<PObjectId>[] {\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<PObjectId>[] → 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":";;;;;AAyCA,IAAa,sBAAb,MAAmE;CACjE;CAEA,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,gBAA6C;AAC3C,SAAO,KAAK;;CAGd,uBAAgC;AAC9B,SAAO;;;;;;;AAUX,IAAa,yBAAb,MAAsE;CACpE,YAAY,WAAyD;AAAxC,OAAA,YAAA;;CAE7B,gBAA6C;AAC3C,SAAO,KAAK;;CAGd,uBAAgC;AAC9B,SAAO;;;;;;;AAeX,IAAa,uBAAb,MAAoE;CAClE,YACE,UACA,MACA;AAFiB,OAAA,WAAA;AACA,OAAA,OAAA;;CAGnB,gBAA6C;AAC3C,SAAO,KAAK,YAAY;;CAG1B,uBAAgC;AAC9B,SAAO,KAAK,SAAS,iBAAiB;;CAGxC,aAAkD;EAChD,MAAM,WAAW,KAAK,SAAS,aAAa;AAC5C,MAAI,aAAa,KAAA,EAAW,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,KAAA,GAAY;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,QAAwD;AACrF,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.map

@@ -1 +1 @@
-{"version":3,"file":"ctx_column_sources.cjs","names":["ResourceTypeName","OutputColumnProvider"],"sources":["../../src/columns/ctx_column_sources.ts"],"sourcesContent":["import type { PColumnSpec, PObjectId } from \"@milaboratories/pl-model-common\";\nimport { TreeNodeAccessor } from \"../render/accessor\";\nimport type { RenderCtxBase, ResultPool } from \"../render\";\nimport type { ColumnSnapshot } from \"./column_snapshot\";\nimport type { ColumnDataStatus } from \"./column_snapshot\";\nimport type { ColumnSnapshotProvider } from \"./column_snapshot_provider\";\nimport { OutputColumnProvider } from \"./column_snapshot_provider\";\nimport { ResourceTypeName } from \"@milaboratories/pl-model-common\";\nimport type { ValueOf } from \"@milaboratories/helpers\";\n\n/**\n * Collect ColumnSnapshotProviders from all render context sources:\n *\n * - **resultPool** — all upstream columns (always included)\n * - **outputs** — PFrame fields from block execution outputs\n * - **prerun** — PFrame fields from prerun/staging results\n *\n * Returns an array of providers suitable for `ColumnCollectionBuilder.addSource()`.\n */\nexport function collectCtxColumnSnapshotProviders<A, U, S>(\n  ctx: RenderCtxBase<A, U, S>,\n): ColumnSnapshotProvider[] {\n  const providers: ColumnSnapshotProvider[] = [];\n\n  // ResultPool — all upstream columns\n  providers.push(new ResultPoolColumnSnapshotProvider(ctx.resultPool));\n\n  // Outputs — each PFrame-like output field becomes a provider\n  const outputs = ctx.outputs;\n  if (outputs) {\n    providers.push(...collectPFrameProviders(outputs));\n  }\n\n  // Prerun — same treatment as outputs\n  const prerun = ctx.prerun;\n  if (prerun) {\n    providers.push(...collectPFrameProviders(prerun));\n  }\n\n  return providers;\n}\n\n/**\n * Adapter wrapping ResultPool into the new ColumnSnapshotProvider interface.\n *\n * - `isColumnListComplete()` always returns true — the result pool\n *   is a stable snapshot within a single render cycle.\n * - Data status is derived from the underlying TreeNodeAccessor:\n *   ready (getIsReadyOrError), computing, or absent (no data resource).\n */\nexport class ResultPoolColumnSnapshotProvider implements ColumnSnapshotProvider {\n  constructor(private readonly pool: ResultPool) {}\n\n  getAllColumns(): ColumnSnapshot[] {\n    const pColumns = this.pool.selectColumns(() => true);\n    return pColumns.map((col) => toSnapshot(col.id, col.spec, col.data));\n  }\n\n  isColumnListComplete(): boolean {\n    return true;\n  }\n}\n\nfunction toSnapshot(\n  id: PObjectId,\n  spec: PColumnSpec,\n  accessor: TreeNodeAccessor | undefined,\n): ColumnSnapshot {\n  if (accessor === undefined) {\n    return { id, spec, dataStatus: \"absent\" as ColumnDataStatus, data: undefined };\n  }\n  const isReady = accessor.getIsReadyOrError();\n  return {\n    id,\n    spec,\n    dataStatus: (isReady ? \"ready\" : \"computing\") as ColumnDataStatus,\n    data: { get: () => (isReady ? accessor : undefined) },\n  };\n}\n\n/**\n * Recursively walk the output tree starting from `accessor`.\n * - If a node's resourceType is PFrame → wrap it as OutputColumnProvider.\n * - If a node's resourceType is StdMap/std/map → recurse into its output fields.\n * - Otherwise → skip (leaf of unknown type).\n */\nfunction collectPFrameProviders(accessor: TreeNodeAccessor): ColumnSnapshotProvider[] {\n  const out: ColumnSnapshotProvider[] = [];\n  walkTree(accessor, out);\n  return out;\n}\n\nfunction walkTree(node: TreeNodeAccessor, out: ColumnSnapshotProvider[]): void {\n  const typeName = node.resourceType.name as ValueOf<typeof ResourceTypeName>;\n\n  if (typeName === ResourceTypeName.PFrame) {\n    out.push(new OutputColumnProvider(node));\n    return;\n  }\n\n  if (typeName === ResourceTypeName.StdMap || typeName === ResourceTypeName.StdMapSlash) {\n    for (const field of node.listInputFields()) {\n      const child = node.resolve(field);\n      if (child) walkTree(child, out);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAmBA,SAAgB,kCACd,KAC0B;CAC1B,MAAM,YAAsC,EAAE;AAG9C,WAAU,KAAK,IAAI,iCAAiC,IAAI,WAAW,CAAC;CAGpE,MAAM,UAAU,IAAI;AACpB,KAAI,QACF,WAAU,KAAK,GAAG,uBAAuB,QAAQ,CAAC;CAIpD,MAAM,SAAS,IAAI;AACnB,KAAI,OACF,WAAU,KAAK,GAAG,uBAAuB,OAAO,CAAC;AAGnD,QAAO;;;;;;;;;;AAWT,IAAa,mCAAb,MAAgF;CAC9E,YAAY,MAAmC;AAAlB,OAAA,OAAA;;CAE7B,gBAAkC;AAEhC,SADiB,KAAK,KAAK,oBAAoB,KAAK,CACpC,KAAK,QAAQ,WAAW,IAAI,IAAI,IAAI,MAAM,IAAI,KAAK,CAAC;;CAGtE,uBAAgC;AAC9B,SAAO;;;AAIX,SAAS,WACP,IACA,MACA,UACgB;AAChB,KAAI,aAAa,KAAA,EACf,QAAO;EAAE;EAAI;EAAM,YAAY;EAA8B,MAAM,KAAA;EAAW;CAEhF,MAAM,UAAU,SAAS,mBAAmB;AAC5C,QAAO;EACL;EACA;EACA,YAAa,UAAU,UAAU;EACjC,MAAM,EAAE,WAAY,UAAU,WAAW,KAAA,GAAY;EACtD;;;;;;;;AASH,SAAS,uBAAuB,UAAsD;CACpF,MAAM,MAAgC,EAAE;AACxC,UAAS,UAAU,IAAI;AACvB,QAAO;;AAGT,SAAS,SAAS,MAAwB,KAAqC;CAC7E,MAAM,WAAW,KAAK,aAAa;AAEnC,KAAI,aAAaA,gCAAAA,iBAAiB,QAAQ;AACxC,MAAI,KAAK,IAAIC,iCAAAA,qBAAqB,KAAK,CAAC;AACxC;;AAGF,KAAI,aAAaD,gCAAAA,iBAAiB,UAAU,aAAaA,gCAAAA,iBAAiB,YACxE,MAAK,MAAM,SAAS,KAAK,iBAAiB,EAAE;EAC1C,MAAM,QAAQ,KAAK,QAAQ,MAAM;AACjC,MAAI,MAAO,UAAS,OAAO,IAAI"}
+{"version":3,"file":"ctx_column_sources.cjs","names":["ResourceTypeName","OutputColumnProvider"],"sources":["../../src/columns/ctx_column_sources.ts"],"sourcesContent":["import type { PColumnSpec, PObjectId } from \"@milaboratories/pl-model-common\";\nimport { TreeNodeAccessor } from \"../render/accessor\";\nimport type { RenderCtxBase, ResultPool } from \"../render\";\nimport type { ColumnSnapshot } from \"./column_snapshot\";\nimport type { ColumnDataStatus } from \"./column_snapshot\";\nimport type { ColumnSnapshotProvider } from \"./column_snapshot_provider\";\nimport { OutputColumnProvider } from \"./column_snapshot_provider\";\nimport { ResourceTypeName } from \"@milaboratories/pl-model-common\";\nimport type { ValueOf } from \"@milaboratories/helpers\";\n\n/**\n * Collect ColumnSnapshotProviders from all render context sources:\n *\n * - **resultPool** — all upstream columns (always included)\n * - **outputs** — PFrame fields from block execution outputs\n * - **prerun** — PFrame fields from prerun/staging results\n *\n * Returns an array of providers suitable for `ColumnCollectionBuilder.addSource()`.\n */\nexport function collectCtxColumnSnapshotProviders<A, U, S>(\n  ctx: RenderCtxBase<A, U, S>,\n): ColumnSnapshotProvider[] {\n  const providers: ColumnSnapshotProvider[] = [];\n\n  // ResultPool — all upstream columns\n  providers.push(new ResultPoolColumnSnapshotProvider(ctx.resultPool));\n\n  // Outputs — each PFrame-like output field becomes a provider\n  const outputs = ctx.outputs;\n  if (outputs) {\n    providers.push(...collectPFrameProviders(outputs));\n  }\n\n  // Prerun — same treatment as outputs\n  const prerun = ctx.prerun;\n  if (prerun) {\n    providers.push(...collectPFrameProviders(prerun));\n  }\n\n  return providers;\n}\n\n/**\n * Adapter wrapping ResultPool into the new ColumnSnapshotProvider interface.\n *\n * - `isColumnListComplete()` always returns true — the result pool\n *   is a stable snapshot within a single render cycle.\n * - Data status is derived from the underlying TreeNodeAccessor:\n *   ready (getIsReadyOrError), computing, or absent (no data resource).\n */\nexport class ResultPoolColumnSnapshotProvider implements ColumnSnapshotProvider {\n  constructor(private readonly pool: ResultPool) {}\n\n  getAllColumns(): ColumnSnapshot<PObjectId>[] {\n    const pColumns = this.pool.selectColumns(() => true);\n    return pColumns.map((col) => toSnapshot(col.id, col.spec, col.data));\n  }\n\n  isColumnListComplete(): boolean {\n    return true;\n  }\n}\n\nfunction toSnapshot(\n  id: PObjectId,\n  spec: PColumnSpec,\n  accessor: TreeNodeAccessor | undefined,\n): ColumnSnapshot<PObjectId> {\n  if (accessor === undefined) {\n    return { id, spec, dataStatus: \"absent\" as ColumnDataStatus, data: undefined };\n  }\n  const isReady = accessor.getIsReadyOrError();\n  return {\n    id,\n    spec,\n    dataStatus: (isReady ? \"ready\" : \"computing\") as ColumnDataStatus,\n    data: { get: () => (isReady ? accessor : undefined) },\n  };\n}\n\n/**\n * Recursively walk the output tree starting from `accessor`.\n * - If a node's resourceType is PFrame → wrap it as OutputColumnProvider.\n * - If a node's resourceType is StdMap/std/map → recurse into its output fields.\n * - Otherwise → skip (leaf of unknown type).\n */\nfunction collectPFrameProviders(accessor: TreeNodeAccessor): ColumnSnapshotProvider[] {\n  const out: ColumnSnapshotProvider[] = [];\n  walkTree(accessor, out);\n  return out;\n}\n\nfunction walkTree(node: TreeNodeAccessor, out: ColumnSnapshotProvider[]): void {\n  const typeName = node.resourceType.name as ValueOf<typeof ResourceTypeName>;\n\n  if (typeName === ResourceTypeName.PFrame) {\n    out.push(new OutputColumnProvider(node));\n    return;\n  }\n\n  if (typeName === ResourceTypeName.StdMap || typeName === ResourceTypeName.StdMapSlash) {\n    for (const field of node.listInputFields()) {\n      const child = node.resolve(field);\n      if (child) walkTree(child, out);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAmBA,SAAgB,kCACd,KAC0B;CAC1B,MAAM,YAAsC,EAAE;AAG9C,WAAU,KAAK,IAAI,iCAAiC,IAAI,WAAW,CAAC;CAGpE,MAAM,UAAU,IAAI;AACpB,KAAI,QACF,WAAU,KAAK,GAAG,uBAAuB,QAAQ,CAAC;CAIpD,MAAM,SAAS,IAAI;AACnB,KAAI,OACF,WAAU,KAAK,GAAG,uBAAuB,OAAO,CAAC;AAGnD,QAAO;;;;;;;;;;AAWT,IAAa,mCAAb,MAAgF;CAC9E,YAAY,MAAmC;AAAlB,OAAA,OAAA;;CAE7B,gBAA6C;AAE3C,SADiB,KAAK,KAAK,oBAAoB,KAAK,CACpC,KAAK,QAAQ,WAAW,IAAI,IAAI,IAAI,MAAM,IAAI,KAAK,CAAC;;CAGtE,uBAAgC;AAC9B,SAAO;;;AAIX,SAAS,WACP,IACA,MACA,UAC2B;AAC3B,KAAI,aAAa,KAAA,EACf,QAAO;EAAE;EAAI;EAAM,YAAY;EAA8B,MAAM,KAAA;EAAW;CAEhF,MAAM,UAAU,SAAS,mBAAmB;AAC5C,QAAO;EACL;EACA;EACA,YAAa,UAAU,UAAU;EACjC,MAAM,EAAE,WAAY,UAAU,WAAW,KAAA,GAAY;EACtD;;;;;;;;AASH,SAAS,uBAAuB,UAAsD;CACpF,MAAM,MAAgC,EAAE;AACxC,UAAS,UAAU,IAAI;AACvB,QAAO;;AAGT,SAAS,SAAS,MAAwB,KAAqC;CAC7E,MAAM,WAAW,KAAK,aAAa;AAEnC,KAAI,aAAaA,gCAAAA,iBAAiB,QAAQ;AACxC,MAAI,KAAK,IAAIC,iCAAAA,qBAAqB,KAAK,CAAC;AACxC;;AAGF,KAAI,aAAaD,gCAAAA,iBAAiB,UAAU,aAAaA,gCAAAA,iBAAiB,YACxE,MAAK,MAAM,SAAS,KAAK,iBAAiB,EAAE;EAC1C,MAAM,QAAQ,KAAK,QAAQ,MAAM;AACjC,MAAI,MAAO,UAAS,OAAO,IAAI"}

package/dist/columns/ctx_column_sources.d.ts

@@ -1,6 +1,7 @@
 import { RenderCtxBase, ResultPool } from "../render/api.js";
 import { ColumnSnapshot } from "./column_snapshot.js";
 import { ColumnSnapshotProvider } from "./column_snapshot_provider.js";
+import { PObjectId } from "@milaboratories/pl-model-common";
 
 //#region src/columns/ctx_column_sources.d.ts
 /**
@@ -24,7 +25,7 @@ declare function collectCtxColumnSnapshotProviders<A, U, S>(ctx: RenderCtxBase<A
 declare class ResultPoolColumnSnapshotProvider implements ColumnSnapshotProvider {
   private readonly pool;
   constructor(pool: ResultPool);
-  getAllColumns(): ColumnSnapshot[];
+  getAllColumns(): ColumnSnapshot<PObjectId>[];
   isColumnListComplete(): boolean;
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"ctx_column_sources.d.ts","names":[],"sources":["../../src/columns/ctx_column_sources.ts"],"mappings":";;;;;;;;AAmBA;;;;;;iBAAgB,iCAAA,SAAA,CACd,GAAA,EAAK,aAAA,CAAc,CAAA,EAAG,CAAA,EAAG,CAAA,IACxB,sBAAA;;;;;;;;;cA6BU,gCAAA,YAA4C,sBAAA;EAAA,iBAC1B,IAAA;cAAA,IAAA,EAAM,UAAA;EAEnC,aAAA,CAAA,GAAiB,cAAA;EAKjB,oBAAA,CAAA;AAAA"}
+{"version":3,"file":"ctx_column_sources.d.ts","names":[],"sources":["../../src/columns/ctx_column_sources.ts"],"mappings":";;;;;;;;;AAmBA;;;;;;iBAAgB,iCAAA,SAAA,CACd,GAAA,EAAK,aAAA,CAAc,CAAA,EAAG,CAAA,EAAG,CAAA,IACxB,sBAAA;;;;;;;;;cA6BU,gCAAA,YAA4C,sBAAA;EAAA,iBAC1B,IAAA;cAAA,IAAA,EAAM,UAAA;EAEnC,aAAA,CAAA,GAAiB,cAAA,CAAe,SAAA;EAKhC,oBAAA,CAAA;AAAA"}

package/dist/columns/ctx_column_sources.js.map

@@ -1 +1 @@
-{"version":3,"file":"ctx_column_sources.js","names":[],"sources":["../../src/columns/ctx_column_sources.ts"],"sourcesContent":["import type { PColumnSpec, PObjectId } from \"@milaboratories/pl-model-common\";\nimport { TreeNodeAccessor } from \"../render/accessor\";\nimport type { RenderCtxBase, ResultPool } from \"../render\";\nimport type { ColumnSnapshot } from \"./column_snapshot\";\nimport type { ColumnDataStatus } from \"./column_snapshot\";\nimport type { ColumnSnapshotProvider } from \"./column_snapshot_provider\";\nimport { OutputColumnProvider } from \"./column_snapshot_provider\";\nimport { ResourceTypeName } from \"@milaboratories/pl-model-common\";\nimport type { ValueOf } from \"@milaboratories/helpers\";\n\n/**\n * Collect ColumnSnapshotProviders from all render context sources:\n *\n * - **resultPool** — all upstream columns (always included)\n * - **outputs** — PFrame fields from block execution outputs\n * - **prerun** — PFrame fields from prerun/staging results\n *\n * Returns an array of providers suitable for `ColumnCollectionBuilder.addSource()`.\n */\nexport function collectCtxColumnSnapshotProviders<A, U, S>(\n  ctx: RenderCtxBase<A, U, S>,\n): ColumnSnapshotProvider[] {\n  const providers: ColumnSnapshotProvider[] = [];\n\n  // ResultPool — all upstream columns\n  providers.push(new ResultPoolColumnSnapshotProvider(ctx.resultPool));\n\n  // Outputs — each PFrame-like output field becomes a provider\n  const outputs = ctx.outputs;\n  if (outputs) {\n    providers.push(...collectPFrameProviders(outputs));\n  }\n\n  // Prerun — same treatment as outputs\n  const prerun = ctx.prerun;\n  if (prerun) {\n    providers.push(...collectPFrameProviders(prerun));\n  }\n\n  return providers;\n}\n\n/**\n * Adapter wrapping ResultPool into the new ColumnSnapshotProvider interface.\n *\n * - `isColumnListComplete()` always returns true — the result pool\n *   is a stable snapshot within a single render cycle.\n * - Data status is derived from the underlying TreeNodeAccessor:\n *   ready (getIsReadyOrError), computing, or absent (no data resource).\n */\nexport class ResultPoolColumnSnapshotProvider implements ColumnSnapshotProvider {\n  constructor(private readonly pool: ResultPool) {}\n\n  getAllColumns(): ColumnSnapshot[] {\n    const pColumns = this.pool.selectColumns(() => true);\n    return pColumns.map((col) => toSnapshot(col.id, col.spec, col.data));\n  }\n\n  isColumnListComplete(): boolean {\n    return true;\n  }\n}\n\nfunction toSnapshot(\n  id: PObjectId,\n  spec: PColumnSpec,\n  accessor: TreeNodeAccessor | undefined,\n): ColumnSnapshot {\n  if (accessor === undefined) {\n    return { id, spec, dataStatus: \"absent\" as ColumnDataStatus, data: undefined };\n  }\n  const isReady = accessor.getIsReadyOrError();\n  return {\n    id,\n    spec,\n    dataStatus: (isReady ? \"ready\" : \"computing\") as ColumnDataStatus,\n    data: { get: () => (isReady ? accessor : undefined) },\n  };\n}\n\n/**\n * Recursively walk the output tree starting from `accessor`.\n * - If a node's resourceType is PFrame → wrap it as OutputColumnProvider.\n * - If a node's resourceType is StdMap/std/map → recurse into its output fields.\n * - Otherwise → skip (leaf of unknown type).\n */\nfunction collectPFrameProviders(accessor: TreeNodeAccessor): ColumnSnapshotProvider[] {\n  const out: ColumnSnapshotProvider[] = [];\n  walkTree(accessor, out);\n  return out;\n}\n\nfunction walkTree(node: TreeNodeAccessor, out: ColumnSnapshotProvider[]): void {\n  const typeName = node.resourceType.name as ValueOf<typeof ResourceTypeName>;\n\n  if (typeName === ResourceTypeName.PFrame) {\n    out.push(new OutputColumnProvider(node));\n    return;\n  }\n\n  if (typeName === ResourceTypeName.StdMap || typeName === ResourceTypeName.StdMapSlash) {\n    for (const field of node.listInputFields()) {\n      const child = node.resolve(field);\n      if (child) walkTree(child, out);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAmBA,SAAgB,kCACd,KAC0B;CAC1B,MAAM,YAAsC,EAAE;AAG9C,WAAU,KAAK,IAAI,iCAAiC,IAAI,WAAW,CAAC;CAGpE,MAAM,UAAU,IAAI;AACpB,KAAI,QACF,WAAU,KAAK,GAAG,uBAAuB,QAAQ,CAAC;CAIpD,MAAM,SAAS,IAAI;AACnB,KAAI,OACF,WAAU,KAAK,GAAG,uBAAuB,OAAO,CAAC;AAGnD,QAAO;;;;;;;;;;AAWT,IAAa,mCAAb,MAAgF;CAC9E,YAAY,MAAmC;AAAlB,OAAA,OAAA;;CAE7B,gBAAkC;AAEhC,SADiB,KAAK,KAAK,oBAAoB,KAAK,CACpC,KAAK,QAAQ,WAAW,IAAI,IAAI,IAAI,MAAM,IAAI,KAAK,CAAC;;CAGtE,uBAAgC;AAC9B,SAAO;;;AAIX,SAAS,WACP,IACA,MACA,UACgB;AAChB,KAAI,aAAa,KAAA,EACf,QAAO;EAAE;EAAI;EAAM,YAAY;EAA8B,MAAM,KAAA;EAAW;CAEhF,MAAM,UAAU,SAAS,mBAAmB;AAC5C,QAAO;EACL;EACA;EACA,YAAa,UAAU,UAAU;EACjC,MAAM,EAAE,WAAY,UAAU,WAAW,KAAA,GAAY;EACtD;;;;;;;;AASH,SAAS,uBAAuB,UAAsD;CACpF,MAAM,MAAgC,EAAE;AACxC,UAAS,UAAU,IAAI;AACvB,QAAO;;AAGT,SAAS,SAAS,MAAwB,KAAqC;CAC7E,MAAM,WAAW,KAAK,aAAa;AAEnC,KAAI,aAAa,iBAAiB,QAAQ;AACxC,MAAI,KAAK,IAAI,qBAAqB,KAAK,CAAC;AACxC;;AAGF,KAAI,aAAa,iBAAiB,UAAU,aAAa,iBAAiB,YACxE,MAAK,MAAM,SAAS,KAAK,iBAAiB,EAAE;EAC1C,MAAM,QAAQ,KAAK,QAAQ,MAAM;AACjC,MAAI,MAAO,UAAS,OAAO,IAAI"}
+{"version":3,"file":"ctx_column_sources.js","names":[],"sources":["../../src/columns/ctx_column_sources.ts"],"sourcesContent":["import type { PColumnSpec, PObjectId } from \"@milaboratories/pl-model-common\";\nimport { TreeNodeAccessor } from \"../render/accessor\";\nimport type { RenderCtxBase, ResultPool } from \"../render\";\nimport type { ColumnSnapshot } from \"./column_snapshot\";\nimport type { ColumnDataStatus } from \"./column_snapshot\";\nimport type { ColumnSnapshotProvider } from \"./column_snapshot_provider\";\nimport { OutputColumnProvider } from \"./column_snapshot_provider\";\nimport { ResourceTypeName } from \"@milaboratories/pl-model-common\";\nimport type { ValueOf } from \"@milaboratories/helpers\";\n\n/**\n * Collect ColumnSnapshotProviders from all render context sources:\n *\n * - **resultPool** — all upstream columns (always included)\n * - **outputs** — PFrame fields from block execution outputs\n * - **prerun** — PFrame fields from prerun/staging results\n *\n * Returns an array of providers suitable for `ColumnCollectionBuilder.addSource()`.\n */\nexport function collectCtxColumnSnapshotProviders<A, U, S>(\n  ctx: RenderCtxBase<A, U, S>,\n): ColumnSnapshotProvider[] {\n  const providers: ColumnSnapshotProvider[] = [];\n\n  // ResultPool — all upstream columns\n  providers.push(new ResultPoolColumnSnapshotProvider(ctx.resultPool));\n\n  // Outputs — each PFrame-like output field becomes a provider\n  const outputs = ctx.outputs;\n  if (outputs) {\n    providers.push(...collectPFrameProviders(outputs));\n  }\n\n  // Prerun — same treatment as outputs\n  const prerun = ctx.prerun;\n  if (prerun) {\n    providers.push(...collectPFrameProviders(prerun));\n  }\n\n  return providers;\n}\n\n/**\n * Adapter wrapping ResultPool into the new ColumnSnapshotProvider interface.\n *\n * - `isColumnListComplete()` always returns true — the result pool\n *   is a stable snapshot within a single render cycle.\n * - Data status is derived from the underlying TreeNodeAccessor:\n *   ready (getIsReadyOrError), computing, or absent (no data resource).\n */\nexport class ResultPoolColumnSnapshotProvider implements ColumnSnapshotProvider {\n  constructor(private readonly pool: ResultPool) {}\n\n  getAllColumns(): ColumnSnapshot<PObjectId>[] {\n    const pColumns = this.pool.selectColumns(() => true);\n    return pColumns.map((col) => toSnapshot(col.id, col.spec, col.data));\n  }\n\n  isColumnListComplete(): boolean {\n    return true;\n  }\n}\n\nfunction toSnapshot(\n  id: PObjectId,\n  spec: PColumnSpec,\n  accessor: TreeNodeAccessor | undefined,\n): ColumnSnapshot<PObjectId> {\n  if (accessor === undefined) {\n    return { id, spec, dataStatus: \"absent\" as ColumnDataStatus, data: undefined };\n  }\n  const isReady = accessor.getIsReadyOrError();\n  return {\n    id,\n    spec,\n    dataStatus: (isReady ? \"ready\" : \"computing\") as ColumnDataStatus,\n    data: { get: () => (isReady ? accessor : undefined) },\n  };\n}\n\n/**\n * Recursively walk the output tree starting from `accessor`.\n * - If a node's resourceType is PFrame → wrap it as OutputColumnProvider.\n * - If a node's resourceType is StdMap/std/map → recurse into its output fields.\n * - Otherwise → skip (leaf of unknown type).\n */\nfunction collectPFrameProviders(accessor: TreeNodeAccessor): ColumnSnapshotProvider[] {\n  const out: ColumnSnapshotProvider[] = [];\n  walkTree(accessor, out);\n  return out;\n}\n\nfunction walkTree(node: TreeNodeAccessor, out: ColumnSnapshotProvider[]): void {\n  const typeName = node.resourceType.name as ValueOf<typeof ResourceTypeName>;\n\n  if (typeName === ResourceTypeName.PFrame) {\n    out.push(new OutputColumnProvider(node));\n    return;\n  }\n\n  if (typeName === ResourceTypeName.StdMap || typeName === ResourceTypeName.StdMapSlash) {\n    for (const field of node.listInputFields()) {\n      const child = node.resolve(field);\n      if (child) walkTree(child, out);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAmBA,SAAgB,kCACd,KAC0B;CAC1B,MAAM,YAAsC,EAAE;AAG9C,WAAU,KAAK,IAAI,iCAAiC,IAAI,WAAW,CAAC;CAGpE,MAAM,UAAU,IAAI;AACpB,KAAI,QACF,WAAU,KAAK,GAAG,uBAAuB,QAAQ,CAAC;CAIpD,MAAM,SAAS,IAAI;AACnB,KAAI,OACF,WAAU,KAAK,GAAG,uBAAuB,OAAO,CAAC;AAGnD,QAAO;;;;;;;;;;AAWT,IAAa,mCAAb,MAAgF;CAC9E,YAAY,MAAmC;AAAlB,OAAA,OAAA;;CAE7B,gBAA6C;AAE3C,SADiB,KAAK,KAAK,oBAAoB,KAAK,CACpC,KAAK,QAAQ,WAAW,IAAI,IAAI,IAAI,MAAM,IAAI,KAAK,CAAC;;CAGtE,uBAAgC;AAC9B,SAAO;;;AAIX,SAAS,WACP,IACA,MACA,UAC2B;AAC3B,KAAI,aAAa,KAAA,EACf,QAAO;EAAE;EAAI;EAAM,YAAY;EAA8B,MAAM,KAAA;EAAW;CAEhF,MAAM,UAAU,SAAS,mBAAmB;AAC5C,QAAO;EACL;EACA;EACA,YAAa,UAAU,UAAU;EACjC,MAAM,EAAE,WAAY,UAAU,WAAW,KAAA,GAAY;EACtD;;;;;;;;AASH,SAAS,uBAAuB,UAAsD;CACpF,MAAM,MAAgC,EAAE;AACxC,UAAS,UAAU,IAAI;AACvB,QAAO;;AAGT,SAAS,SAAS,MAAwB,KAAqC;CAC7E,MAAM,WAAW,KAAK,aAAa;AAEnC,KAAI,aAAa,iBAAiB,QAAQ;AACxC,MAAI,KAAK,IAAI,qBAAqB,KAAK,CAAC;AACxC;;AAGF,KAAI,aAAa,iBAAiB,UAAU,aAAa,iBAAiB,YACxE,MAAK,MAAM,SAAS,KAAK,iBAAiB,EAAE;EAC1C,MAAM,QAAQ,KAAK,QAAQ,MAAM;AACjC,MAAI,MAAO,UAAS,OAAO,IAAI"}

package/dist/columns/expand_by_partition.cjs

@@ -0,0 +1,106 @@
+require("../_virtual/_rolldown/runtime.cjs");
+const require_axis_filtering = require("../render/util/axis_filtering.cjs");
+const require_pcolumn_data = require("../render/util/pcolumn_data.cjs");
+const require_column_snapshot = require("./column_snapshot.cjs");
+let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
+//#region src/columns/expand_by_partition.ts
+/**
+* Expand snapshots by splitting along partition axes.
+*
+* For each snapshot, reads partition data, enumerates unique keys on the
+* split axes, and produces one output snapshot per key combination —
+* with the split axes removed from `axesSpec` and a `pl7.app/trace`
+* annotation recording the split origin.
+*
+* Returns `{ items: [], complete: false }` when any snapshot's data
+* is not ready (status !== 'ready' or partition data unavailable).
+*/
+function expandByPartition(snapshots, splitAxes, opts) {
+	if (splitAxes.length === 0) return {
+		items: snapshots,
+		complete: true
+	};
+	const splitAxisIdxs = splitAxes.map((a) => a.idx).sort((a, b) => a - b);
+	const result = [];
+	for (const snapshot of snapshots) {
+		if (snapshot.dataStatus !== "ready" || snapshot.data === void 0) return {
+			items: [],
+			complete: false
+		};
+		const dataEntries = require_pcolumn_data.convertOrParsePColumnData(snapshot.data.get());
+		if (dataEntries === void 0) return {
+			items: [],
+			complete: false
+		};
+		if (!(0, _milaboratories_pl_model_common.isPartitionedDataInfoEntries)(dataEntries)) throw new Error(`Splitting requires Partitioned DataInfoEntries, but got ${dataEntries.type} for column ${String(snapshot.id)}`);
+		const uniqueKeys = require_pcolumn_data.getUniquePartitionKeys(dataEntries);
+		const maxSplitIdx = splitAxisIdxs[splitAxisIdxs.length - 1];
+		if (maxSplitIdx >= dataEntries.partitionKeyLength) throw new Error(`Not enough partition keys (${dataEntries.partitionKeyLength}) for requested split axes (max index ${maxSplitIdx}) in column ${snapshot.spec.name}`);
+		const axesLabels = splitAxisIdxs.map((idx) => opts?.axisLabels?.((0, _milaboratories_pl_model_common.getAxisId)(snapshot.spec.axesSpec[idx])));
+		const keyCombinations = generateKeyCombinations(uniqueKeys, splitAxisIdxs);
+		if (keyCombinations.length === 0) continue;
+		const newAxesSpec = [...snapshot.spec.axesSpec];
+		for (let i = splitAxisIdxs.length - 1; i >= 0; i--) newAxesSpec.splice(splitAxisIdxs[i], 1);
+		for (const keyCombo of keyCombinations) {
+			const axisFilters = keyCombo.map((value, sAxisIdx) => [splitAxisIdxs[sAxisIdx], value]);
+			const traceEntries = keyCombo.map((value, sAxisIdx) => {
+				const axisIdx = splitAxisIdxs[sAxisIdx];
+				const axisId = (0, _milaboratories_pl_model_common.getAxisId)(snapshot.spec.axesSpec[axisIdx]);
+				const label = axesLabels[sAxisIdx]?.[value] ?? String(value);
+				return {
+					type: `split:${(0, _milaboratories_pl_model_common.canonicalizeAxisId)(axisId)}`,
+					label,
+					importance: 1e6
+				};
+			});
+			const filteredData = require_axis_filtering.filterDataInfoEntries(dataEntries, axisFilters);
+			const adjustedSpec = {
+				...snapshot.spec,
+				axesSpec: newAxesSpec,
+				annotations: {
+					...snapshot.spec.annotations,
+					"pl7.app/trace": JSON.stringify(traceEntries)
+				}
+			};
+			result.push({
+				id: snapshot.id,
+				spec: adjustedSpec,
+				dataStatus: "ready",
+				data: require_column_snapshot.createReadyColumnData(() => (0, _milaboratories_pl_model_common.entriesToDataInfo)(filteredData))
+			});
+		}
+	}
+	return {
+		items: result,
+		complete: true
+	};
+}
+const MAX_KEY_COMBINATIONS = 1e4;
+function generateKeyCombinations(uniqueKeys, splitAxisIdxs) {
+	const combinations = [];
+	function generate(currentCombo, sAxisIdx) {
+		if (sAxisIdx >= splitAxisIdxs.length) {
+			combinations.push([...currentCombo]);
+			if (combinations.length > MAX_KEY_COMBINATIONS) throw new Error("Too many key combinations, aborting.");
+			return;
+		}
+		const axisIdx = splitAxisIdxs[sAxisIdx];
+		if (axisIdx >= uniqueKeys.length) throw new Error(`Axis index ${axisIdx} out of bounds for unique keys array (length ${uniqueKeys.length})`);
+		const axisValues = uniqueKeys[axisIdx];
+		if (!axisValues || axisValues.length === 0) {
+			combinations.length = 0;
+			return;
+		}
+		for (const val of axisValues) {
+			currentCombo.push(val);
+			generate(currentCombo, sAxisIdx + 1);
+			currentCombo.pop();
+		}
+	}
+	generate([], 0);
+	return combinations;
+}
+//#endregion
+exports.expandByPartition = expandByPartition;
+
+//# sourceMappingURL=expand_by_partition.cjs.map