@platforma-sdk/model 1.79.27 → 1.80.2

package/dist/components/PlDataTable/createPlDataTable/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/PlDataTable/createPlDataTable/index.ts"],"sourcesContent":["import type { RenderCtxBase } from \"../../../render\";\nimport type { PlDataTableModel } from \"../typesV7\";\nimport { createPlDataTableOptionsV2, createPlDataTableV2 } from \"./createPlDataTableV2\";\nimport { createPlDataTableV3 } from \"./createPlDataTableV3\";\nimport type { createPlDataTableOptionsV3 } from \"./createPlDataTableV3\";\n\nexport function createPlDataTable<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  options: { version: \"v2\" } & createPlDataTableOptionsV2,\n): ReturnType<typeof createPlDataTableV2>;\nexport function createPlDataTable<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  options: { version?: \"v3\" } & createPlDataTableOptionsV3,\n): ReturnType<typeof createPlDataTableV3>;\nexport function createPlDataTable<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  options:\n    | ({ version: \"v2\" } & createPlDataTableOptionsV2)\n    | ({ version?: \"v3\" } & createPlDataTableOptionsV3),\n): PlDataTableModel | undefined {\n  if (options.version === \"v2\") {\n    return createPlDataTableV2(ctx, options.columns, options.tableState, options.options);\n  } else {\n    // default version is last (v3 at the moment)\n    return createPlDataTableV3(ctx, options);\n  }\n}\n\nexport { discoverTableColumnSnaphots } from \"./discoverColumns\";\n"],"mappings":";;;;AAcA,SAAgB,kBACd,KACA,SAG8B;CAC9B,IAAI,QAAQ,YAAY,MACtB,OAAO,oBAAoB,KAAK,QAAQ,SAAS,QAAQ,YAAY,QAAQ,OAAO;MAGpF,OAAO,oBAAoB,KAAK,OAAO;AAE3C"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/PlDataTable/createPlDataTable/index.ts"],"sourcesContent":["import type { RenderCtxBase } from \"../../../render\";\nimport type { PlDataTableModel } from \"../typesV8\";\nimport { createPlDataTableOptionsV2, createPlDataTableV2 } from \"./createPlDataTableV2\";\nimport { createPlDataTableV3 } from \"./createPlDataTableV3\";\nimport type { createPlDataTableOptionsV3 } from \"./createPlDataTableV3\";\n\nexport function createPlDataTable<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  options: { version: \"v2\" } & createPlDataTableOptionsV2,\n): ReturnType<typeof createPlDataTableV2>;\nexport function createPlDataTable<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  options: { version?: \"v3\" } & createPlDataTableOptionsV3,\n): ReturnType<typeof createPlDataTableV3>;\nexport function createPlDataTable<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  options:\n    | ({ version: \"v2\" } & createPlDataTableOptionsV2)\n    | ({ version?: \"v3\" } & createPlDataTableOptionsV3),\n): PlDataTableModel | undefined {\n  if (options.version === \"v2\") {\n    return createPlDataTableV2(ctx, options.columns, options.tableState, options.options);\n  } else {\n    // default version is last (v3 at the moment)\n    return createPlDataTableV3(ctx, options);\n  }\n}\n\nexport { discoverTableColumns as discoverTableColumnSnaphots } from \"./discoverColumns\";\n"],"mappings":";;;;AAcA,SAAgB,kBACd,KACA,SAG8B;CAC9B,IAAI,QAAQ,YAAY,MACtB,OAAO,oBAAoB,KAAK,QAAQ,SAAS,QAAQ,YAAY,QAAQ,OAAO;MAGpF,OAAO,oBAAoB,KAAK,OAAO;AAE3C"}

package/dist/components/PlDataTable/createPlDataTable/utils.cjs

@@ -1,12 +1,19 @@
 const require_derive_distinct_labels = require("../../../labels/derive_distinct_labels.cjs");
-const require_column_snapshot_provider = require("../../../columns/column_snapshot_provider.cjs");
-const require_column_collection_builder = require("../../../columns/column_collection_builder.cjs");
+const require_columns_collection = require("../../../columns/columns_collection.cjs");
+const require_utils = require("../../../columns/utils.cjs");
 require("../../../columns/index.cjs");
-const require_derive_distinct_tooltips = require("../../../labels/derive_distinct_tooltips.cjs");
+require("../../../labels/derive_distinct_tooltips.cjs");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
-let _milaboratories_helpers = require("@milaboratories/helpers");
+require("@milaboratories/helpers");
 let es_toolkit = require("es-toolkit");
 //#region src/components/PlDataTable/createPlDataTable/utils.ts
+/** Adapt a {@link ColumnRecipe} to the plain {@link RuleColumn} shape. */
+function toRuleColumn(col) {
+	return {
+		id: (0, _milaboratories_pl_model_common.extractPObjectId)(col.id),
+		spec: col.getSpec()
+	};
+}
 /** Check if column should be omitted from the table */
 function isColumnHidden(spec) {
 	return (0, _milaboratories_pl_model_common.readAnnotation)(spec, _milaboratories_pl_model_common.Annotation.Table.Visibility) === "hidden";
@@ -34,151 +41,58 @@ function getOrderPriority(col, orderByColId) {
 * (first-match-wins, preserving original rule order).
 *
 * Predicate-based rules (`ColumnMatcher`) are evaluated directly on the spec.
-* Selector-based rules (`ColumnSelector`) are matched via `PFrameSpecDriver.discoverColumns`
-* using the same engine as `ColumnCollection.findColumns` — no client-side matcher.
+* Selector-based rules (`ColumnSelector`) are matched via the
+* `columnsCollection` service — the inline column ids must be resolvable in
+* the active render ctx for the host to read their specs.
 */
-function evaluateRules(rules, columns, pframeSpec) {
+function evaluateRules(rules, columns) {
 	const result = /* @__PURE__ */ new Map();
 	if (rules.length === 0 || columns.length === 0) return result;
-	const hasSelectorRules = rules.some((rule) => typeof rule.match !== "function");
+	const selectorRules = rules.filter((rule) => typeof rule.match !== "function");
 	const selectorHitsByRule = /* @__PURE__ */ new Map();
-	if (hasSelectorRules) {
-		const pColumns = dedupeById(columns).map((c) => ({
-			id: c.id,
-			spec: c.spec,
-			data: void 0
-		}));
-		const collection = new require_column_collection_builder.ColumnCollectionBuilder(pframeSpec).addSource(new require_column_snapshot_provider.ArrayColumnProvider(pColumns)).build();
-		if (collection === void 0) return result;
-		try {
-			for (const rule of rules) {
-				if (typeof rule.match === "function") continue;
-				const hits = collection.findColumns({ include: rule.match });
-				selectorHitsByRule.set(rule, new Set(hits.map((h) => h.id)));
-			}
-		} finally {
-			collection.dispose();
+	if (selectorRules.length > 0) {
+		const baseCollection = require_columns_collection.ColumnsCollection([{
+			columns: (0, es_toolkit.uniqBy)(columns, (col) => col.id),
+			isFinal: true
+		}]);
+		for (const rule of selectorRules) {
+			const hitIds = baseCollection.filter({ include: rule.match }).getColumnIds();
+			if (hitIds.length === 0) return result;
+			selectorHitsByRule.set(rule, new Set(hitIds.map((id) => (0, _milaboratories_pl_model_common.extractPObjectId)(id))));
 		}
 	}
-	for (const col of columns) for (const rule of rules) if (typeof rule.match === "function" ? rule.match(col.spec) : selectorHitsByRule.get(rule)?.has(col.id) ?? false) {
-		result.set(col.id, rule);
-		break;
-	}
-	return result;
-}
-function dedupeById(columns) {
-	const seen = /* @__PURE__ */ new Set();
-	const result = [];
 	for (const col of columns) {
-		if (seen.has(col.id)) continue;
-		seen.add(col.id);
-		result.push(col);
+		const colKey = (0, _milaboratories_pl_model_common.extractPObjectId)(col.id);
+		for (const rule of rules) if (selectorHitsByRule.get(rule)?.has(colKey) ?? false) {
+			result.set(colKey, rule);
+			break;
+		}
 	}
 	return result;
 }
 /**
-* Writes derived labels into column and axis annotations.
-* Returns new column objects with modified specs — original columns are not mutated.
+* Build a sidecar map `columnId → AnnotationDataStatus` derived from each
+* recipe's own status. This is *rendering* metadata — kept out of the spec
+* so it cannot perturb column identity (id-bearing spec overrides would
+* diverge the visible PTable's column ids from the full table / pframe).
 *
-* For each column: writes derived label into Annotation.Label (if present in derivedLabels).
-* For each axis in column specs: writes derived axis label into AxisSpec annotations.
-*/
-function withLabelAnnotations(derivedLabels, columns) {
-	if (derivedLabels === void 0) return columns;
-	return columns.map((col) => {
-		const colLabel = derivedLabels[col.id];
-		return {
-			...col,
-			spec: {
-				...col.spec,
-				...(0, es_toolkit.isNil)(colLabel) ? {} : { annotations: {
-					...col.spec.annotations,
-					[_milaboratories_pl_model_common.Annotation.Label]: colLabel
-				} },
-				axesSpec: col.spec.axesSpec.map((axis) => {
-					const label = derivedLabels[(0, _milaboratories_pl_model_common.canonicalizeAxisId)(axis)];
-					return (0, es_toolkit.isNil)(label) ? axis : {
-						...axis,
-						annotations: {
-							...axis.annotations,
-							[_milaboratories_pl_model_common.Annotation.Label]: label
-						}
-					};
-				})
-			}
-		};
-	});
-}
-function withDataStatusAnnotations(columns) {
-	return columns.map((col) => {
-		return {
-			...col,
-			spec: {
-				...col.spec,
-				annotations: {
-					...col.spec.annotations,
-					[_milaboratories_pl_model_common.Annotation.DataStatus]: col.dataStatus
-				}
-			}
-		};
-	});
-}
-/**
-* Writes effective display properties (OrderPriority, Visibility) from precomputed rule maps
-* into column annotations. Returns new column objects — originals are not mutated.
-*/
-function withTableVisualAnnotations(visibilityByColId, orderByColId, columns) {
-	if (visibilityByColId === void 0 && orderByColId === void 0) return columns;
-	return columns.map((col) => {
-		const annotations = { ...col.spec.annotations };
-		const visibility = getEffectiveVisibility(col, visibilityByColId);
-		if (!(0, es_toolkit.isNil)(visibility)) annotations[_milaboratories_pl_model_common.Annotation.Table.Visibility] = visibility;
-		const orderPriority = getOrderPriority(col, orderByColId);
-		if (!(0, es_toolkit.isNil)(orderPriority)) annotations[_milaboratories_pl_model_common.Annotation.Table.OrderPriority] = String(orderPriority);
-		return {
-			...col,
-			spec: {
-				...col.spec,
-				annotations
-			}
-		};
-	});
-}
-/**
-* Writes derived info annotations into column annotations.
-* Columns without an info entry are passed through unchanged.
+* Mapping `ColumnFieldStatus` × actual byte-presence → `AnnotationDataStatus`:
+*   - `absent`                       → `"absent"`
+*   - `resolving`                    → `"computing"`
+*   - `present` + `hasColumnData()`  → `"ready"`
+*   - `present` + no bytes yet       → `"computing"`
+*
+* Intentionally scoped to visible columns — the probe is meaningful only for
+* what the user will actually see.
 */
-function withInfoAnnotations(infoById, columns) {
-	if ((0, es_toolkit.isNil)(infoById)) return columns;
-	return columns.map((col) => {
-		const info = infoById[col.id];
-		if ((0, es_toolkit.isNil)(info)) return col;
-		return {
-			...col,
-			spec: {
-				...col.spec,
-				annotations: {
-					...col.spec.annotations,
-					[_milaboratories_pl_model_common.Annotation.Table.Info]: info
-				}
-			}
-		};
-	});
+function buildDataStatusMap(columns, opts = {}) {
+	return columns.reduce((acc, c) => (acc[c.id] = deriveDataStatus(c, opts), acc), {});
 }
-function withHidenAxesAnnotations(columns) {
-	return columns.map((col) => ({
-		...col,
-		spec: {
-			...col.spec,
-			axesSpec: col.spec.axesSpec.map((axis) => ({
-				...axis,
-				annotations: {
-					...axis.annotations,
-					[_milaboratories_pl_model_common.Annotation.Table.Visibility]: "hidden"
-				}
-			}))
-		}
-	}));
+function deriveDataStatus(column, opts) {
+	const field = column.getDataStatus();
+	if (field === "absent") return "absent";
+	if (field === "resolving") return "computing";
+	return require_utils.hasColumnData(column, opts) ? "ready" : "computing";
 }
 /** Derive labels for all table elements: columns via deriveDistinctLabels, axes from label columns. */
 function deriveAllLabels(options) {
@@ -189,46 +103,14 @@ function deriveAllLabels(options) {
 		qualifications: c.qualifications
 	})), deriveLabelsOptions).reduce((acc, label, index) => (acc[columns[index].id] = label, acc), {});
 }
-/** Derive origin tooltips for columns whose qualifications or linker path carry info. */
-function deriveAllTooltips(options) {
-	const { columns } = options;
-	const variantCountByOriginal = columns.reduce((acc, c) => {
-		return acc.set((0, _milaboratories_helpers.getField)(c, "originalId") ?? c.id, (acc.get(c.originalId ?? c.id) ?? 0) + 1);
-	}, /* @__PURE__ */ new Map());
-	const { entries } = columns.reduce(({ entries, variantSeen }, c) => {
-		const id = (0, _milaboratories_helpers.getField)(c, "originalId") ?? c.id;
-		const variantCount = variantCountByOriginal.get(id);
-		const variantIndex = (variantSeen.set(id, (variantSeen.get(id) ?? 0) + 1), variantSeen.get(id));
-		entries.push({
-			spec: c.spec,
-			linkerPath: c.linkerPath,
-			qualifications: c.qualifications,
-			variantIndex,
-			variantCount
-		});
-		return {
-			entries,
-			variantSeen
-		};
-	}, {
-		entries: [],
-		variantSeen: /* @__PURE__ */ new Map()
-	});
-	const tooltips = require_derive_distinct_tooltips.deriveDistinctTooltips(entries);
-	return Object.fromEntries(tooltips.flatMap((t, i) => (0, es_toolkit.isNil)(t) ? [] : [[columns[i].id, t]]));
-}
 //#endregion
+exports.buildDataStatusMap = buildDataStatusMap;
 exports.deriveAllLabels = deriveAllLabels;
-exports.deriveAllTooltips = deriveAllTooltips;
 exports.evaluateRules = evaluateRules;
 exports.getEffectiveVisibility = getEffectiveVisibility;
 exports.getOrderPriority = getOrderPriority;
 exports.isColumnHidden = isColumnHidden;
 exports.isColumnOptional = isColumnOptional;
-exports.withDataStatusAnnotations = withDataStatusAnnotations;
-exports.withHidenAxesAnnotations = withHidenAxesAnnotations;
-exports.withInfoAnnotations = withInfoAnnotations;
-exports.withLabelAnnotations = withLabelAnnotations;
-exports.withTableVisualAnnotations = withTableVisualAnnotations;
+exports.toRuleColumn = toRuleColumn;
 
 //# sourceMappingURL=utils.cjs.map

package/dist/components/PlDataTable/createPlDataTable/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","names":["Annotation","ColumnCollectionBuilder","ArrayColumnProvider","deriveDistinctLabels","deriveDistinctTooltips"],"sources":["../../../../src/components/PlDataTable/createPlDataTable/utils.ts"],"sourcesContent":["import {\n  type PColumn,\n  type PColumnSpec,\n  type PFrameSpecDriver,\n  type PObjectId,\n  Annotation,\n  canonicalizeAxisId,\n  DiscoveredPColumnId,\n  readAnnotation,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  deriveDistinctLabels,\n  type DeriveLabelsOptions,\n} from \"../../../labels/derive_distinct_labels\";\nimport {\n  deriveDistinctTooltips,\n  type TooltipEntry,\n} from \"../../../labels/derive_distinct_tooltips\";\nimport type { ColumnDataStatus, MatchQualifications, MatchVariant } from \"../../../columns\";\nimport type { ColumnMatcher, ColumnOrderRule, ColumnVisibilityRule } from \"./createPlDataTableV3\";\nimport type { ColumnSelector } from \"../../../columns\";\nimport { ArrayColumnProvider, ColumnCollectionBuilder } from \"../../../columns\";\nimport { isNil } from \"es-toolkit\";\nimport { getField } from \"@milaboratories/helpers\";\n\n/** Check if column should be omitted from the table */\nexport function isColumnHidden(spec: { annotations?: Annotation }): boolean {\n  return readAnnotation(spec, Annotation.Table.Visibility) === \"hidden\";\n}\n\n/** Check if column is hidden by default */\nexport function isColumnOptional(spec: { annotations?: Annotation }): boolean {\n  return readAnnotation(spec, Annotation.Table.Visibility) === \"optional\";\n}\n\n/** Column shape consumed by rule evaluation. */\nexport type RuleColumn = Pick<PColumn<PObjectId>, \"id\" | \"spec\">;\n\n/** Get effective visibility for a column. Rule map lookup first, then annotation fallback. */\nexport function getEffectiveVisibility(\n  col: RuleColumn,\n  visibilityByColId?: Map<PObjectId, ColumnVisibilityRule>,\n): undefined | \"default\" | \"optional\" | \"hidden\" {\n  const rule = visibilityByColId?.get(col.id);\n  if (rule !== undefined) return rule.visibility;\n  if (isColumnHidden(col.spec)) return \"hidden\";\n  if (isColumnOptional(col.spec)) return \"optional\";\n  return undefined;\n}\n\n/** Get ordering priority for a column. Rule map lookup first, then annotation fallback. */\nexport function getOrderPriority(\n  col: RuleColumn,\n  orderByColId?: Map<PObjectId, ColumnOrderRule>,\n): undefined | number {\n  const rule = orderByColId?.get(col.id);\n  if (rule !== undefined) return rule.priority;\n  const annotation = Number(readAnnotation(col.spec, Annotation.Table.OrderPriority));\n  return isNaN(annotation) ? undefined : annotation;\n}\n\n/**\n * Evaluate display rules against a set of columns and return a map of `colId → winning rule`\n * (first-match-wins, preserving original rule order).\n *\n * Predicate-based rules (`ColumnMatcher`) are evaluated directly on the spec.\n * Selector-based rules (`ColumnSelector`) are matched via `PFrameSpecDriver.discoverColumns`\n * using the same engine as `ColumnCollection.findColumns` — no client-side matcher.\n */\nexport function evaluateRules<R extends { match: ColumnMatcher | ColumnSelector }>(\n  rules: R[],\n  columns: RuleColumn[],\n  pframeSpec: PFrameSpecDriver,\n): Map<PObjectId, R> {\n  const result = new Map<PObjectId, R>();\n  if (rules.length === 0 || columns.length === 0) return result;\n\n  const hasSelectorRules = rules.some((rule) => typeof rule.match !== \"function\");\n  const selectorHitsByRule = new Map<R, Set<PObjectId>>();\n\n  if (hasSelectorRules) {\n    const dedupedColumns = dedupeById(columns);\n    const pColumns = dedupedColumns.map((c) => ({ id: c.id, spec: c.spec, data: undefined }));\n    const collection = new ColumnCollectionBuilder(pframeSpec)\n      .addSource(new ArrayColumnProvider(pColumns))\n      .build();\n    if (collection === undefined) return result;\n\n    try {\n      for (const rule of rules) {\n        if (typeof rule.match === \"function\") continue;\n        const hits = collection.findColumns({ include: rule.match });\n        selectorHitsByRule.set(rule, new Set(hits.map((h) => h.id)));\n      }\n    } finally {\n      collection.dispose();\n    }\n  }\n\n  for (const col of columns) {\n    for (const rule of rules) {\n      const matches =\n        typeof rule.match === \"function\"\n          ? rule.match(col.spec)\n          : (selectorHitsByRule.get(rule)?.has(col.id) ?? false);\n      if (matches) {\n        result.set(col.id, rule);\n        break;\n      }\n    }\n  }\n  return result;\n}\n\nfunction dedupeById(columns: RuleColumn[]): RuleColumn[] {\n  const seen = new Set<PObjectId>();\n  const result: RuleColumn[] = [];\n  for (const col of columns) {\n    if (seen.has(col.id)) continue;\n    seen.add(col.id);\n    result.push(col);\n  }\n  return result;\n}\n\n/**\n * Writes derived labels into column and axis annotations.\n * Returns new column objects with modified specs — original columns are not mutated.\n *\n * For each column: writes derived label into Annotation.Label (if present in derivedLabels).\n * For each axis in column specs: writes derived axis label into AxisSpec annotations.\n */\nexport function withLabelAnnotations<\n  T extends {\n    readonly id: PObjectId;\n    readonly spec: PColumnSpec;\n  },\n>(derivedLabels: undefined | Record<string, string>, columns: T[]): T[] {\n  if (derivedLabels === undefined) return columns;\n  return columns.map((col) => {\n    const colLabel = derivedLabels[col.id];\n    return {\n      ...col,\n      spec: {\n        ...col.spec,\n        ...(isNil(colLabel)\n          ? {}\n          : { annotations: { ...col.spec.annotations, [Annotation.Label]: colLabel } }),\n        axesSpec: col.spec.axesSpec.map((axis) => {\n          const label = derivedLabels[canonicalizeAxisId(axis)];\n          return isNil(label)\n            ? axis\n            : { ...axis, annotations: { ...axis.annotations, [Annotation.Label]: label } };\n        }),\n      },\n    } as T;\n  });\n}\n\nexport function withDataStatusAnnotations<\n  T extends {\n    readonly spec: PColumnSpec;\n    readonly dataStatus: ColumnDataStatus;\n  },\n>(columns: T[]): T[] {\n  return columns.map((col) => {\n    return {\n      ...col,\n      spec: {\n        ...col.spec,\n        annotations: {\n          ...col.spec.annotations,\n          [Annotation.DataStatus]: col.dataStatus,\n        },\n      },\n    } as T;\n  });\n}\n\n/**\n * Writes effective display properties (OrderPriority, Visibility) from precomputed rule maps\n * into column annotations. Returns new column objects — originals are not mutated.\n */\nexport function withTableVisualAnnotations<\n  T extends { readonly id: PObjectId; readonly spec: PColumnSpec },\n>(\n  visibilityByColId: undefined | Map<PObjectId, ColumnVisibilityRule>,\n  orderByColId: undefined | Map<PObjectId, ColumnOrderRule>,\n  columns: T[],\n): T[] {\n  if (visibilityByColId === undefined && orderByColId === undefined) return columns;\n  return columns.map((col) => {\n    const annotations = { ...col.spec.annotations };\n\n    const visibility = getEffectiveVisibility(col, visibilityByColId);\n    if (!isNil(visibility)) annotations[Annotation.Table.Visibility] = visibility;\n\n    const orderPriority = getOrderPriority(col, orderByColId);\n    if (!isNil(orderPriority)) annotations[Annotation.Table.OrderPriority] = String(orderPriority);\n\n    return {\n      ...col,\n      spec: {\n        ...col.spec,\n        annotations: annotations,\n      },\n    } as T;\n  });\n}\n\n/**\n * Writes derived info annotations into column annotations.\n * Columns without an info entry are passed through unchanged.\n */\nexport function withInfoAnnotations<\n  T extends { readonly id: PObjectId; readonly spec: PColumnSpec },\n>(infoById: undefined | Record<string, string>, columns: T[]): T[] {\n  if (isNil(infoById)) return columns;\n  return columns.map((col) => {\n    const info = infoById[col.id];\n    if (isNil(info)) return col;\n    return {\n      ...col,\n      spec: {\n        ...col.spec,\n        annotations: { ...col.spec.annotations, [Annotation.Table.Info]: info },\n      },\n    } as T;\n  });\n}\n\nexport function withHidenAxesAnnotations<T extends { readonly spec: PColumnSpec }>(\n  columns: T[],\n): T[] {\n  return columns.map(\n    (col) =>\n      ({\n        ...col,\n        spec: {\n          ...col.spec,\n          axesSpec: col.spec.axesSpec.map((axis) => ({\n            ...axis,\n            annotations: { ...axis.annotations, [Annotation.Table.Visibility]: \"hidden\" },\n          })),\n        },\n      }) as T,\n  );\n}\n\n/** Column shape required by label derivation. */\nexport type LabelableColumn = {\n  readonly id: PObjectId;\n  readonly spec: PColumnSpec;\n  readonly linkerPath?: MatchVariant[\"path\"];\n  readonly qualifications?: MatchQualifications;\n};\n\n/** Derive labels for all table elements: columns via deriveDistinctLabels, axes from label columns. */\nexport function deriveAllLabels(options: {\n  columns: LabelableColumn[];\n  deriveLabelsOptions?: DeriveLabelsOptions;\n}): Record<string, string> {\n  const { columns, deriveLabelsOptions } = options;\n  const entries = columns.map((c) => ({\n    spec: c.spec,\n    linkerPath: c.linkerPath?.map((step) => ({\n      spec: step.linker.spec,\n    })),\n    qualifications: c.qualifications,\n  }));\n  const columnLabels = deriveDistinctLabels(entries, deriveLabelsOptions).reduce(\n    (acc, label, index) => ((acc[columns[index].id] = label), acc),\n    {} as Record<string, string>,\n  );\n  return columnLabels;\n}\n\n/** Column shape required by tooltip derivation. */\nexport type TooltipableColumn = {\n  readonly id: PObjectId | DiscoveredPColumnId;\n  readonly spec: PColumnSpec;\n  readonly originalId?: PObjectId;\n  readonly linkerPath?: MatchVariant[\"path\"];\n  readonly qualifications?: MatchQualifications;\n};\n\n/** Derive origin tooltips for columns whose qualifications or linker path carry info. */\nexport function deriveAllTooltips(options: {\n  columns: TooltipableColumn[];\n}): Record<DiscoveredPColumnId, string> {\n  const { columns } = options;\n\n  const variantCountByOriginal = columns.reduce<Map<PObjectId, number>>((acc, c) => {\n    return acc.set(getField(c, \"originalId\") ?? c.id, (acc.get(c.originalId ?? c.id) ?? 0) + 1);\n  }, new Map());\n\n  const { entries } = columns.reduce(\n    ({ entries, variantSeen }, c) => {\n      const id = getField(c, \"originalId\") ?? c.id;\n      const variantCount = variantCountByOriginal.get(id);\n      const variantIndex =\n        (variantSeen.set(id, (variantSeen.get(id) ?? 0) + 1), variantSeen.get(id));\n\n      entries.push({\n        spec: c.spec,\n        linkerPath: c.linkerPath,\n        qualifications: c.qualifications,\n        variantIndex,\n        variantCount,\n      });\n\n      return { entries, variantSeen };\n    },\n    { entries: [] as TooltipEntry[], variantSeen: new Map<PObjectId, number>() },\n  );\n\n  const tooltips = deriveDistinctTooltips(entries);\n\n  return Object.fromEntries(\n    tooltips.flatMap((t, i) => (isNil(t) ? [] : [[columns[i].id, t] as const])),\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils.cjs","names":["Annotation","ColumnsCollection","hasColumnData","deriveDistinctLabels"],"sources":["../../../../src/components/PlDataTable/createPlDataTable/utils.ts"],"sourcesContent":["import {\n  type AnnotationDataStatus,\n  type ColumnUniversalId,\n  type PColumn,\n  type PColumnSpec,\n  type PObjectId,\n  Annotation,\n  extractPObjectId,\n  readAnnotation,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  deriveDistinctLabels,\n  type DeriveLabelsOptions,\n} from \"../../../labels/derive_distinct_labels\";\nimport {\n  deriveDistinctTooltips,\n  type TooltipEntry,\n} from \"../../../labels/derive_distinct_tooltips\";\nimport type { ColumnOrderRule, ColumnVisibilityRule } from \"./createPlDataTableV3\";\nimport type { ColumnSelector, MatchQualifications } from \"@milaboratories/pl-model-common\";\nimport { ColumnsCollection, hasColumnData, type ColumnRecipe } from \"../../../columns\";\nimport type { GlobalCfgRenderCtx } from \"../../../render/internal\";\nimport { isNil, uniqBy } from \"es-toolkit\";\nimport { getField } from \"@milaboratories/helpers\";\n\n/** Adapt a {@link ColumnRecipe} to the plain {@link RuleColumn} shape. */\nexport function toRuleColumn(col: ColumnRecipe): RuleColumn {\n  return { id: extractPObjectId(col.id), spec: col.getSpec() };\n}\n\n/** Check if column should be omitted from the table */\nexport function isColumnHidden(spec: { annotations?: Annotation }): boolean {\n  return readAnnotation(spec, Annotation.Table.Visibility) === \"hidden\";\n}\n\n/** Check if column is hidden by default */\nexport function isColumnOptional(spec: { annotations?: Annotation }): boolean {\n  return readAnnotation(spec, Annotation.Table.Visibility) === \"optional\";\n}\n\n/** Column shape consumed by rule evaluation. */\nexport type RuleColumn = Pick<PColumn<PObjectId>, \"id\" | \"spec\">;\n\n/** Get effective visibility for a column. Rule map lookup first, then annotation fallback. */\nexport function getEffectiveVisibility(\n  col: RuleColumn,\n  visibilityByColId?: Map<PObjectId, ColumnVisibilityRule>,\n): undefined | \"default\" | \"optional\" | \"hidden\" {\n  const rule = visibilityByColId?.get(col.id);\n  if (rule !== undefined) return rule.visibility;\n  if (isColumnHidden(col.spec)) return \"hidden\";\n  if (isColumnOptional(col.spec)) return \"optional\";\n  return undefined;\n}\n\n/** Get ordering priority for a column. Rule map lookup first, then annotation fallback. */\nexport function getOrderPriority(\n  col: RuleColumn,\n  orderByColId?: Map<PObjectId, ColumnOrderRule>,\n): undefined | number {\n  const rule = orderByColId?.get(col.id);\n  if (rule !== undefined) return rule.priority;\n  const annotation = Number(readAnnotation(col.spec, Annotation.Table.OrderPriority));\n  return isNaN(annotation) ? undefined : annotation;\n}\n\n/**\n * Evaluate display rules against a set of columns and return a map of `colId → winning rule`\n * (first-match-wins, preserving original rule order).\n *\n * Predicate-based rules (`ColumnMatcher`) are evaluated directly on the spec.\n * Selector-based rules (`ColumnSelector`) are matched via the\n * `columnsCollection` service — the inline column ids must be resolvable in\n * the active render ctx for the host to read their specs.\n */\nexport function evaluateRules<R extends { match: ColumnSelector }>(\n  rules: R[],\n  columns: ColumnRecipe[],\n): Map<PObjectId, R> {\n  const result = new Map<PObjectId, R>();\n  if (rules.length === 0 || columns.length === 0) return result;\n\n  const selectorRules = rules.filter((rule) => typeof rule.match !== \"function\");\n  const selectorHitsByRule = new Map<R, Set<PObjectId>>();\n\n  if (selectorRules.length > 0) {\n    const baseColumns = uniqBy(columns, (col) => col.id);\n    const baseCollection = ColumnsCollection([{ columns: baseColumns, isFinal: true }]);\n    for (const rule of selectorRules) {\n      const hitIds = baseCollection.filter({ include: rule.match }).getColumnIds();\n      if (hitIds.length === 0) return result;\n      selectorHitsByRule.set(rule, new Set(hitIds.map((id) => extractPObjectId(id))));\n    }\n  }\n\n  for (const col of columns) {\n    const colKey = extractPObjectId(col.id);\n    for (const rule of rules) {\n      const matches = selectorHitsByRule.get(rule)?.has(colKey) ?? false;\n      if (matches) {\n        result.set(colKey, rule);\n        break;\n      }\n    }\n  }\n  return result;\n}\n\n/**\n * Build a sidecar map `columnId → AnnotationDataStatus` derived from each\n * recipe's own status. This is *rendering* metadata — kept out of the spec\n * so it cannot perturb column identity (id-bearing spec overrides would\n * diverge the visible PTable's column ids from the full table / pframe).\n *\n * Mapping `ColumnFieldStatus` × actual byte-presence → `AnnotationDataStatus`:\n *   - `absent`                       → `\"absent\"`\n *   - `resolving`                    → `\"computing\"`\n *   - `present` + `hasColumnData()`  → `\"ready\"`\n *   - `present` + no bytes yet       → `\"computing\"`\n *\n * Intentionally scoped to visible columns — the probe is meaningful only for\n * what the user will actually see.\n */\nexport function buildDataStatusMap(\n  columns: ColumnRecipe[],\n  opts: { ctx?: GlobalCfgRenderCtx } = {},\n): Record<ColumnUniversalId, AnnotationDataStatus> {\n  return columns.reduce(\n    (acc, c) => ((acc[c.id] = deriveDataStatus(c, opts)), acc),\n    {} as Record<ColumnUniversalId, AnnotationDataStatus>,\n  );\n}\n\nfunction deriveDataStatus(\n  column: ColumnRecipe,\n  opts: { ctx?: GlobalCfgRenderCtx },\n): AnnotationDataStatus {\n  const field = column.getDataStatus();\n  if (field === \"absent\") return \"absent\";\n  if (field === \"resolving\") return \"computing\";\n  return hasColumnData(column, opts) ? \"ready\" : \"computing\";\n}\n\n/** Column shape required by label derivation. */\nexport type LabelableColumn = {\n  readonly id: ColumnUniversalId;\n  readonly spec: PColumnSpec;\n  readonly linkerPath?: ReadonlyArray<{ readonly linker: { readonly spec: PColumnSpec } }>;\n  readonly qualifications?: MatchQualifications;\n};\n\n/** Derive labels for all table elements: columns via deriveDistinctLabels, axes from label columns. */\nexport function deriveAllLabels(options: {\n  columns: LabelableColumn[];\n  deriveLabelsOptions?: DeriveLabelsOptions;\n}): Record<string, string> {\n  const { columns, deriveLabelsOptions } = options;\n  const entries = columns.map((c) => ({\n    spec: c.spec,\n    linkerPath: c.linkerPath?.map((step) => ({ spec: step.linker.spec })),\n    qualifications: c.qualifications,\n  }));\n  const columnLabels = deriveDistinctLabels(entries, deriveLabelsOptions).reduce(\n    (acc, label, index) => ((acc[columns[index].id] = label), acc),\n    {} as Record<string, string>,\n  );\n  return columnLabels;\n}\n\n/** Column shape required by tooltip derivation. */\nexport type TooltipableColumn = {\n  readonly id: ColumnUniversalId;\n  readonly spec: PColumnSpec;\n  readonly originalId?: PObjectId;\n  readonly linkerPath?: ReadonlyArray<{ readonly linker: { readonly spec: PColumnSpec } }>;\n  readonly qualifications?: MatchQualifications;\n};\n\n/** Derive origin tooltips for columns whose qualifications or linker path carry info. */\nexport function deriveAllTooltips(options: {\n  columns: TooltipableColumn[];\n}): Record<ColumnUniversalId, string> {\n  const { columns } = options;\n\n  const variantCountByOriginal = columns.reduce<Map<ColumnUniversalId, number>>((acc, c) => {\n    return acc.set(getField(c, \"originalId\") ?? c.id, (acc.get(c.originalId ?? c.id) ?? 0) + 1);\n  }, new Map());\n\n  const { entries } = columns.reduce(\n    ({ entries, variantSeen }, c) => {\n      const id = getField(c, \"originalId\") ?? c.id;\n      const variantCount = variantCountByOriginal.get(id);\n      const variantIndex =\n        (variantSeen.set(id, (variantSeen.get(id) ?? 0) + 1), variantSeen.get(id));\n\n      entries.push({\n        spec: c.spec,\n        linkerPath: c.linkerPath,\n        qualifications: c.qualifications,\n        variantIndex,\n        variantCount,\n      });\n\n      return { entries, variantSeen };\n    },\n    { entries: [] as TooltipEntry[], variantSeen: new Map<ColumnUniversalId, number>() },\n  );\n\n  const tooltips = deriveDistinctTooltips(entries);\n\n  return Object.fromEntries(\n    tooltips.flatMap((t, i) => (isNil(t) ? [] : [[columns[i].id, t] as const])),\n  );\n}\n"],"mappings":"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"}

package/dist/components/PlDataTable/createPlDataTable/utils.d.ts

@@ -1,5 +1,5 @@
 import { ColumnOrderRule, ColumnVisibilityRule } from "./createPlDataTableV3.js";
-import { Annotation, DiscoveredPColumnId, PColumn, PColumnSpec, PFrameSpecDriver, PObjectId } from "@milaboratories/pl-model-common";
+import { Annotation, AnnotationDataStatus, ColumnSelector, ColumnUniversalId, MatchQualifications, PColumn, PColumnSpec, PObjectId } from "@milaboratories/pl-model-common";
 
 //#region src/components/PlDataTable/createPlDataTable/utils.d.ts
 /** Check if column should be omitted from the table */

package/dist/components/PlDataTable/createPlDataTable/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","names":[],"sources":["../../../../src/components/PlDataTable/createPlDataTable/utils.ts"],"mappings":";;;;;iBA0BgB,cAAA,CAAe,IAAA;EAAQ,WAAA,GAAc,UAAU;AAAA;;iBAK/C,gBAAA,CAAiB,IAAA;EAAQ,WAAA,GAAc,UAAU;AAAA;;KAKrD,UAAA,GAAa,IAAA,CAAK,OAAA,CAAQ,SAAA;AALtC;AAAA,iBAQgB,sBAAA,CACd,GAAA,EAAK,UAAA,EACL,iBAAA,GAAoB,GAAA,CAAI,SAAA,EAAW,oBAAA;;iBAUrB,gBAAA,CACd,GAAA,EAAK,UAAA,EACL,YAAA,GAAe,GAAA,CAAI,SAAA,EAAW,eAAA"}
+{"version":3,"file":"utils.d.ts","names":[],"sources":["../../../../src/components/PlDataTable/createPlDataTable/utils.ts"],"mappings":";;;;;iBA+BgB,cAAA,CAAe,IAAA;EAAQ,WAAA,GAAc,UAAU;AAAA;;iBAK/C,gBAAA,CAAiB,IAAA;EAAQ,WAAA,GAAc,UAAU;AAAA;AAAjE;AAAA,KAKY,UAAA,GAAa,IAAA,CAAK,OAAA,CAAQ,SAAA;;iBAGtB,sBAAA,CACd,GAAA,EAAK,UAAA,EACL,iBAAA,GAAoB,GAAA,CAAI,SAAA,EAAW,oBAAA;;iBAUrB,gBAAA,CACd,GAAA,EAAK,UAAA,EACL,YAAA,GAAe,GAAA,CAAI,SAAA,EAAW,eAAA"}

package/dist/components/PlDataTable/createPlDataTable/utils.js

@@ -1,12 +1,19 @@
 import { deriveDistinctLabels } from "../../../labels/derive_distinct_labels.js";
-import { ArrayColumnProvider } from "../../../columns/column_snapshot_provider.js";
-import { ColumnCollectionBuilder } from "../../../columns/column_collection_builder.js";
+import { ColumnsCollection } from "../../../columns/columns_collection.js";
+import { hasColumnData } from "../../../columns/utils.js";
 import "../../../columns/index.js";
-import { deriveDistinctTooltips } from "../../../labels/derive_distinct_tooltips.js";
-import { Annotation, canonicalizeAxisId, readAnnotation } from "@milaboratories/pl-model-common";
-import { getField } from "@milaboratories/helpers";
-import { isNil as isNil$1 } from "es-toolkit";
+import "../../../labels/derive_distinct_tooltips.js";
+import { Annotation, extractPObjectId, readAnnotation } from "@milaboratories/pl-model-common";
+import "@milaboratories/helpers";
+import { uniqBy } from "es-toolkit";
 //#region src/components/PlDataTable/createPlDataTable/utils.ts
+/** Adapt a {@link ColumnRecipe} to the plain {@link RuleColumn} shape. */
+function toRuleColumn(col) {
+	return {
+		id: extractPObjectId(col.id),
+		spec: col.getSpec()
+	};
+}
 /** Check if column should be omitted from the table */
 function isColumnHidden(spec) {
 	return readAnnotation(spec, Annotation.Table.Visibility) === "hidden";
@@ -34,151 +41,58 @@ function getOrderPriority(col, orderByColId) {
 * (first-match-wins, preserving original rule order).
 *
 * Predicate-based rules (`ColumnMatcher`) are evaluated directly on the spec.
-* Selector-based rules (`ColumnSelector`) are matched via `PFrameSpecDriver.discoverColumns`
-* using the same engine as `ColumnCollection.findColumns` — no client-side matcher.
+* Selector-based rules (`ColumnSelector`) are matched via the
+* `columnsCollection` service — the inline column ids must be resolvable in
+* the active render ctx for the host to read their specs.
 */
-function evaluateRules(rules, columns, pframeSpec) {
+function evaluateRules(rules, columns) {
 	const result = /* @__PURE__ */ new Map();
 	if (rules.length === 0 || columns.length === 0) return result;
-	const hasSelectorRules = rules.some((rule) => typeof rule.match !== "function");
+	const selectorRules = rules.filter((rule) => typeof rule.match !== "function");
 	const selectorHitsByRule = /* @__PURE__ */ new Map();
-	if (hasSelectorRules) {
-		const pColumns = dedupeById(columns).map((c) => ({
-			id: c.id,
-			spec: c.spec,
-			data: void 0
-		}));
-		const collection = new ColumnCollectionBuilder(pframeSpec).addSource(new ArrayColumnProvider(pColumns)).build();
-		if (collection === void 0) return result;
-		try {
-			for (const rule of rules) {
-				if (typeof rule.match === "function") continue;
-				const hits = collection.findColumns({ include: rule.match });
-				selectorHitsByRule.set(rule, new Set(hits.map((h) => h.id)));
-			}
-		} finally {
-			collection.dispose();
+	if (selectorRules.length > 0) {
+		const baseCollection = ColumnsCollection([{
+			columns: uniqBy(columns, (col) => col.id),
+			isFinal: true
+		}]);
+		for (const rule of selectorRules) {
+			const hitIds = baseCollection.filter({ include: rule.match }).getColumnIds();
+			if (hitIds.length === 0) return result;
+			selectorHitsByRule.set(rule, new Set(hitIds.map((id) => extractPObjectId(id))));
 		}
 	}
-	for (const col of columns) for (const rule of rules) if (typeof rule.match === "function" ? rule.match(col.spec) : selectorHitsByRule.get(rule)?.has(col.id) ?? false) {
-		result.set(col.id, rule);
-		break;
-	}
-	return result;
-}
-function dedupeById(columns) {
-	const seen = /* @__PURE__ */ new Set();
-	const result = [];
 	for (const col of columns) {
-		if (seen.has(col.id)) continue;
-		seen.add(col.id);
-		result.push(col);
+		const colKey = extractPObjectId(col.id);
+		for (const rule of rules) if (selectorHitsByRule.get(rule)?.has(colKey) ?? false) {
+			result.set(colKey, rule);
+			break;
+		}
 	}
 	return result;
 }
 /**
-* Writes derived labels into column and axis annotations.
-* Returns new column objects with modified specs — original columns are not mutated.
+* Build a sidecar map `columnId → AnnotationDataStatus` derived from each
+* recipe's own status. This is *rendering* metadata — kept out of the spec
+* so it cannot perturb column identity (id-bearing spec overrides would
+* diverge the visible PTable's column ids from the full table / pframe).
 *
-* For each column: writes derived label into Annotation.Label (if present in derivedLabels).
-* For each axis in column specs: writes derived axis label into AxisSpec annotations.
-*/
-function withLabelAnnotations(derivedLabels, columns) {
-	if (derivedLabels === void 0) return columns;
-	return columns.map((col) => {
-		const colLabel = derivedLabels[col.id];
-		return {
-			...col,
-			spec: {
-				...col.spec,
-				...isNil$1(colLabel) ? {} : { annotations: {
-					...col.spec.annotations,
-					[Annotation.Label]: colLabel
-				} },
-				axesSpec: col.spec.axesSpec.map((axis) => {
-					const label = derivedLabels[canonicalizeAxisId(axis)];
-					return isNil$1(label) ? axis : {
-						...axis,
-						annotations: {
-							...axis.annotations,
-							[Annotation.Label]: label
-						}
-					};
-				})
-			}
-		};
-	});
-}
-function withDataStatusAnnotations(columns) {
-	return columns.map((col) => {
-		return {
-			...col,
-			spec: {
-				...col.spec,
-				annotations: {
-					...col.spec.annotations,
-					[Annotation.DataStatus]: col.dataStatus
-				}
-			}
-		};
-	});
-}
-/**
-* Writes effective display properties (OrderPriority, Visibility) from precomputed rule maps
-* into column annotations. Returns new column objects — originals are not mutated.
-*/
-function withTableVisualAnnotations(visibilityByColId, orderByColId, columns) {
-	if (visibilityByColId === void 0 && orderByColId === void 0) return columns;
-	return columns.map((col) => {
-		const annotations = { ...col.spec.annotations };
-		const visibility = getEffectiveVisibility(col, visibilityByColId);
-		if (!isNil$1(visibility)) annotations[Annotation.Table.Visibility] = visibility;
-		const orderPriority = getOrderPriority(col, orderByColId);
-		if (!isNil$1(orderPriority)) annotations[Annotation.Table.OrderPriority] = String(orderPriority);
-		return {
-			...col,
-			spec: {
-				...col.spec,
-				annotations
-			}
-		};
-	});
-}
-/**
-* Writes derived info annotations into column annotations.
-* Columns without an info entry are passed through unchanged.
+* Mapping `ColumnFieldStatus` × actual byte-presence → `AnnotationDataStatus`:
+*   - `absent`                       → `"absent"`
+*   - `resolving`                    → `"computing"`
+*   - `present` + `hasColumnData()`  → `"ready"`
+*   - `present` + no bytes yet       → `"computing"`
+*
+* Intentionally scoped to visible columns — the probe is meaningful only for
+* what the user will actually see.
 */
-function withInfoAnnotations(infoById, columns) {
-	if (isNil$1(infoById)) return columns;
-	return columns.map((col) => {
-		const info = infoById[col.id];
-		if (isNil$1(info)) return col;
-		return {
-			...col,
-			spec: {
-				...col.spec,
-				annotations: {
-					...col.spec.annotations,
-					[Annotation.Table.Info]: info
-				}
-			}
-		};
-	});
+function buildDataStatusMap(columns, opts = {}) {
+	return columns.reduce((acc, c) => (acc[c.id] = deriveDataStatus(c, opts), acc), {});
 }
-function withHidenAxesAnnotations(columns) {
-	return columns.map((col) => ({
-		...col,
-		spec: {
-			...col.spec,
-			axesSpec: col.spec.axesSpec.map((axis) => ({
-				...axis,
-				annotations: {
-					...axis.annotations,
-					[Annotation.Table.Visibility]: "hidden"
-				}
-			}))
-		}
-	}));
+function deriveDataStatus(column, opts) {
+	const field = column.getDataStatus();
+	if (field === "absent") return "absent";
+	if (field === "resolving") return "computing";
+	return hasColumnData(column, opts) ? "ready" : "computing";
 }
 /** Derive labels for all table elements: columns via deriveDistinctLabels, axes from label columns. */
 function deriveAllLabels(options) {
@@ -189,35 +103,7 @@ function deriveAllLabels(options) {
 		qualifications: c.qualifications
 	})), deriveLabelsOptions).reduce((acc, label, index) => (acc[columns[index].id] = label, acc), {});
 }
-/** Derive origin tooltips for columns whose qualifications or linker path carry info. */
-function deriveAllTooltips(options) {
-	const { columns } = options;
-	const variantCountByOriginal = columns.reduce((acc, c) => {
-		return acc.set(getField(c, "originalId") ?? c.id, (acc.get(c.originalId ?? c.id) ?? 0) + 1);
-	}, /* @__PURE__ */ new Map());
-	const { entries } = columns.reduce(({ entries, variantSeen }, c) => {
-		const id = getField(c, "originalId") ?? c.id;
-		const variantCount = variantCountByOriginal.get(id);
-		const variantIndex = (variantSeen.set(id, (variantSeen.get(id) ?? 0) + 1), variantSeen.get(id));
-		entries.push({
-			spec: c.spec,
-			linkerPath: c.linkerPath,
-			qualifications: c.qualifications,
-			variantIndex,
-			variantCount
-		});
-		return {
-			entries,
-			variantSeen
-		};
-	}, {
-		entries: [],
-		variantSeen: /* @__PURE__ */ new Map()
-	});
-	const tooltips = deriveDistinctTooltips(entries);
-	return Object.fromEntries(tooltips.flatMap((t, i) => isNil$1(t) ? [] : [[columns[i].id, t]]));
-}
 //#endregion
-export { deriveAllLabels, deriveAllTooltips, evaluateRules, getEffectiveVisibility, getOrderPriority, isColumnHidden, isColumnOptional, withDataStatusAnnotations, withHidenAxesAnnotations, withInfoAnnotations, withLabelAnnotations, withTableVisualAnnotations };
+export { buildDataStatusMap, deriveAllLabels, evaluateRules, getEffectiveVisibility, getOrderPriority, isColumnHidden, isColumnOptional, toRuleColumn };
 
 //# sourceMappingURL=utils.js.map