@platforma-sdk/model 1.65.10 → 1.66.2

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

@@ -1 +1 @@
-{"version":3,"file":"createPlDataTableV3.d.ts","names":[],"sources":["../../../../src/components/PlDataTable/createPlDataTable/createPlDataTableV3.ts"],"mappings":";;;;;;;;;;;KA0CY,0BAAA;EAEN,qBAAA,EAAuB,4BAAA;AAAA;EAGvB,OAAA,EAAS,GAAA,GAAM,mBAAA,CAAoB,mBAAA;AAAA;EAGvC,OAAA,GAAU,kBAAA;EACV,OAAA,GAAU,aAAA;EACV,eAAA;EAEA,UAAA,GAAa,kBAAA;EACb,aAAA,GAAgB,mBAAA;EAChB,qBAAA,GAAwB,qBAAA;AAAA;;KAId,qBAAA;EACV,OAAA,GAAU,mBAAA,GAAsB,mBAAA;EAChC,OAAA,GAAU,mBAAA,GAAsB,mBAAA;EAChC,IAAA,GAAO,YAAA;EACP,OAAA;AAAA;AAAA,KAGU,qBAAA;EApBN,uFAsBJ,QAAA,GAAW,eAAA,IAtBQ;EAwBnB,UAAA,GAAa,oBAAA;AAAA;AAAA,KAGH,eAAA;EACV,KAAA,EAAO,aAAA,EAxBG;EA0BV,QAAA;AAAA;AAAA,KAGU,oBAAA;EACV,KAAA,EAAO,aAAA;EACP,UAAA;AAAA;AAAA,KAGU,aAAA,IAAiB,IAAA,EAAM,WAAA;AAAA,iBAInB,mBAAA,iBAAoC,eAAA,QAAuB,QAAA,CAAS,UAAA,EAAA,CAClF,GAAA,EAAK,aAAA,CAAc,CAAA,EAAG,CAAA,EAAG,CAAA,GACzB,OAAA,EAAS,0BAAA,GACR,gBAAA;;KA0HS,mBAAA,YAA+B,SAAA,GAAY,mBAAA,IAAuB,cAAA,CAAe,EAAA;EAAA,SAClF,SAAA;EAAA,SACA,UAAA,GAAa,SAAA;EAAA,SACb,UAAA,GAAa,WAAA;AAAA"}
+{"version":3,"file":"createPlDataTableV3.d.ts","names":[],"sources":["../../../../src/components/PlDataTable/createPlDataTable/createPlDataTableV3.ts"],"mappings":";;;;;;;;;;;;KA+CY,0BAAA;EACV,UAAA,GAAa,kBAAA;EAEb,OAAA,EAAS,GAAA,GAAM,0BAAA,GAA6B,mBAAA;EAC5C,OAAA,GAAU,kBAAA;EACV,OAAA,GAAU,aAAA;EACV,eAAA;EAEA,aAAA,GAAgB,mBAAA;EAChB,cAAA,GAAiB,qBAAA;AAAA;;KAIP,qBAAA;EACV,OAAA,GAAU,mBAAA,GAAsB,mBAAA;EAChC,OAAA,GAAU,mBAAA,GAAsB,mBAAA;EAChC,IAAA,GAAO,YAAA;EACP,OAAA;AAAA;AAAA,KAGU,qBAAA;EAX4B,uFAatC,QAAA,GAAW,eAAA,IArBX;EAuBA,UAAA,GAAa,oBAAA;AAAA;AAAA,KAGH,eAAA;EACV,KAAA,EAAO,aAAA,GAAgB,cAAA,EAzBqB;EA2B5C,QAAA;AAAA;AAAA,KAGU,oBAAA;EACV,KAAA,EAAO,aAAA,GAAgB,cAAA;EACvB,UAAA;AAAA;AAAA,KAGU,aAAA,IAAiB,IAAA,EAAM,WAAA;AAAA,iBAInB,mBAAA,MAAA,CACd,GAAA,EAAK,aAAA,CAAc,CAAA,EAAG,CAAA,GACtB,OAAA,EAAS,0BAAA,GACR,gBAAA;;KA+HS,mBAAA,GAAsB,cAAA,CAAe,mBAAA;EAAA,SACtC,UAAA,EAAY,SAAA;EAAA,SACZ,SAAA;EAAA,SACA,UAAA,GAAa,YAAA;EAAA,SACb,cAAA,GAAiB,mBAAA;EAAA,SACjB,yBAAA,GAA4B,mBAAA;AAAA"}

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

@@ -2,20 +2,21 @@ import { collectFilterSpecColumns, traverseFilterSpec } from "../../../filters/t
 import { upgradePlDataTableStateV2 } from "../state-migration.js";
 import { getAllLabelColumns, getMatchingLabelColumns } from "../labels.js";
 import { createPTableDefV3 } from "./createPTableDefV3.js";
-import { deriveAllLabels, isColumnHidden, isColumnOptional, withLabelAnnotations, withTableVisualAnnotations } from "./utils.js";
+import { deriveAllLabels, deriveAllTooltips, evaluateRules, isColumnHidden, isColumnOptional, withHidenAxesAnnotations, withInfoAnnotations, withLabelAnnotations, withTableVisualAnnotations } from "./utils.js";
 import { discoverTableColumnSnaphots } from "./discoverColumns.js";
-import { canonicalizeJson, getAxisId, getColumnIdAndSpec, parseJson, uniqueBy } from "@milaboratories/pl-model-common";
-import { isNil, throwError } from "@milaboratories/helpers";
+import { canonicalizeJson, getAxisId, parseJson, uniqueBy } from "@milaboratories/pl-model-common";
+import { isNil, isPlainObject, throwError } from "@milaboratories/helpers";
 import { isEmpty } from "es-toolkit/compat";
 //#region src/components/PlDataTable/createPlDataTable/createPlDataTableV3.ts
 function createPlDataTableV3(ctx, options) {
+	const pframeSpec = ctx.getService("pframeSpec");
 	const state = upgradePlDataTableStateV2(options.tableState);
 	const primaryJoinType = options.primaryJoinType ?? "full";
-	const discovered = "discoverColumnOptions" in options ? discoverTableColumnSnaphots(ctx, options.discoverColumnOptions) : options.columns;
+	const discovered = isPlainObject(options.columns) ? discoverTableColumnSnaphots(ctx, options.columns) : options.columns;
 	if (isNil(discovered) || discovered.length === 0) return void 0;
-	const resolved = resolveDiscoveredColumns(splitDiscoveredColumns(discovered), discovered);
-	const labelColumns = getMatchingLabelColumns(resolved.all, getAllLabelColumns(ctx));
-	const annotated = annotateColumnGroups(resolved, labelColumns, deriveAllLabels({
+	const splited = splitDiscoveredColumns(discovered);
+	const labelColumns = getMatchingLabelColumns([...splited.direct, ...splited.linked], getAllLabelColumns(ctx));
+	const derivedLabels = deriveAllLabels({
 		columns: discovered.map((dc) => ({
 			id: dc.id,
 			spec: dc.spec,
@@ -26,14 +27,29 @@ function createPlDataTableV3(ctx, options) {
 			includeNativeLabel: true,
 			...options.labelsOptions
 		}
-	}), options.columnsDisplayOptions);
-	const primaryColumnIds = new Set(discovered.filter((dc) => dc.isPrimary).map((dc) => dc.id));
-	const primaryColumns = annotated.direct.filter((c) => primaryColumnIds.has(c.id));
-	const secondaryColumns = annotated.direct.filter((c) => !primaryColumnIds.has(c.id));
-	if (primaryColumns.length === 0) return void 0;
+	});
+	const derivedTooltips = deriveAllTooltips({ columns: discovered.map((dc) => ({
+		id: dc.id,
+		originalId: dc.originalId,
+		spec: dc.spec,
+		linkerPath: dc.linkerPath,
+		qualifications: dc.qualifications,
+		distinctiveQualifications: dc.distinctiveQualifications
+	})) });
+	const annotated = annotateColumnGroups({
+		pframeSpec,
+		...splited,
+		labelColumns,
+		derivedLabels,
+		derivedTooltips,
+		displayOptions: options.displayOptions
+	});
+	const primarySnapshots = annotated.direct.filter((c) => c.isPrimary);
+	const secondarySnapshots = annotated.direct.filter((c) => !c.isPrimary);
+	if (primarySnapshots.length === 0) return void 0;
 	const columnIsAvailable = createColumnValidationById([
 		...annotated.direct,
-		...annotated.linked.flatMap((lc) => [...annotated.linkers.get(lc.id) ?? [], lc]),
+		...annotated.linked.flatMap((lc) => [...(lc.linkerPath ?? []).map((s) => s.linker), lc]),
 		...annotated.labels
 	]);
 	const remapedDefaultFilters = remapFilterColumnIds(options.filters, discovered);
@@ -41,37 +57,27 @@ function createPlDataTableV3(ctx, options) {
 	validateFilters(filters, columnIsAvailable);
 	const sorting = resolveSorting(state.pTableParams.sorting, remapSortingColumnIds(options.sorting, discovered));
 	validateSorting(sorting, columnIsAvailable);
+	const primaryEntries = primarySnapshots.map((snap) => ({ column: resolveSnapshot(snap) }));
 	const fullDef = createPTableDefV3({
 		primaryJoinType,
-		primaryColumns,
-		secondaryGroups: [
-			...secondaryColumns.map((c) => [c]),
-			...annotated.linked.map((lc) => [...annotated.linkers.get(lc.id) ?? [], lc]),
-			...annotated.labels.map((c) => [c])
-		],
+		primary: primaryEntries,
+		secondary: buildSecondaryGroups(secondarySnapshots, annotated.linked, annotated.labels),
 		filters,
 		sorting
 	});
 	const fullHandle = ctx.createPTableV2(fullDef);
 	const pframeHandle = ctx.createPFrame([
-		...annotated.direct,
-		...annotated.linked,
+		...annotated.direct.map(resolveSnapshot),
+		...annotated.linked.map(resolveSnapshot),
 		...annotated.labels,
-		...uniqueBy([...annotated.linkers.values()].flat(), (c) => c.id)
+		...collectLinkerSnapshots(annotated.linked).map(resolveSnapshot)
 	]);
 	const hiddenSpecs = state.pTableParams.hiddenColIds;
-	const hiddenColumnIds = computeHiddenColumns([...annotated.direct, ...annotated.linked], sorting, filters, hiddenSpecs);
-	const visible = buildVisibleColumns(annotated, hiddenColumnIds, labelColumns);
-	const visibleNonCoreDirect = secondaryColumns.filter((c) => !hiddenColumnIds.has(c.id));
-	const visibleLinkedGroups = buildVisibleLinkedGroups(visible.direct, visible.linked, annotated.linkers, hiddenSpecs);
+	const visible = buildVisibleColumns(annotated, computeHiddenColumns([...annotated.direct, ...annotated.linked], sorting, filters, hiddenSpecs), labelColumns);
 	const visibleDef = createPTableDefV3({
 		primaryJoinType,
-		primaryColumns,
-		secondaryGroups: [
-			...visibleNonCoreDirect.map((c) => [c]),
-			...visibleLinkedGroups,
-			...visible.labels.map((c) => [c])
-		],
+		primary: primaryEntries,
+		secondary: buildSecondaryGroups(visible.direct.filter((c) => !c.isPrimary), visible.linked, visible.labels),
 		filters,
 		sorting
 	});
@@ -91,26 +97,52 @@ function splitDiscoveredColumns(columns) {
 		linked: columns.filter((dc) => !isNil(dc.linkerPath) && dc.linkerPath.length > 0)
 	};
 }
-/** Resolve DiscoveredColumn snapshots into PColumn objects with lazily-evaluated data. */
-function resolveDiscoveredColumns(split, allDiscovered) {
-	const linked = split.linked.map(resolveSnapshot);
-	const linkers = new Map(split.linked.filter((dc) => !isNil(dc.linkerPath)).map((dc, i) => [linked[i].id, dc.linkerPath.map((s) => resolveSnapshot(s.linker))]));
-	return {
-		all: allDiscovered.map(resolveSnapshot),
-		direct: split.direct.map(resolveSnapshot),
-		linked,
-		linkers
-	};
+/** All linker snapshots across the given linked columns, deduped by id. */
+function collectLinkerSnapshots(linked) {
+	return uniqueBy(linked.flatMap((lc) => (lc.linkerPath ?? []).map((s) => s.linker)), (c) => c.id);
 }
-/** Annotate all column groups with derived labels and display options. */
-function annotateColumnGroups(resolved, labelColumns, derivedLabels, displayOptions) {
+/**
+* Annotate all column groups with derived labels and display-rule annotations.
+* Evaluates `displayOptions` rules against all discovered columns (direct,
+* linked, labels, linkers) and writes the winning visibility/priority into
+* column annotations via `withTableVisualAnnotations`.
+*/
+function annotateColumnGroups(params) {
+	const { direct, linked, labelColumns, derivedLabels, derivedTooltips, displayOptions, pframeSpec } = params;
+	const allColumnsForRules = [
+		...direct,
+		...linked,
+		...labelColumns,
+		...collectLinkerSnapshots(linked)
+	];
+	const visibilityByColId = evaluateRules(displayOptions?.visibility ?? [], allColumnsForRules, pframeSpec);
+	const orderByColId = evaluateRules(displayOptions?.ordering ?? [], allColumnsForRules, pframeSpec);
 	return {
-		direct: withTableVisualAnnotations(displayOptions, withLabelAnnotations(derivedLabels, resolved.direct)),
-		linked: withTableVisualAnnotations(displayOptions, withLabelAnnotations(derivedLabels, resolved.linked)),
-		linkers: new Map([...resolved.linkers].map(([id, cols]) => [id, withLabelAnnotations(derivedLabels, cols)])),
+		direct: [
+			withLabelAnnotations.bind(null, derivedLabels),
+			withInfoAnnotations.bind(null, derivedTooltips),
+			withTableVisualAnnotations.bind(null, visibilityByColId, orderByColId)
+		].reduce((cols, fn) => fn(cols), direct),
+		linked: [
+			withLabelAnnotations.bind(null, derivedLabels),
+			withInfoAnnotations.bind(null, derivedTooltips),
+			withTableVisualAnnotations.bind(null, visibilityByColId, orderByColId),
+			(cols) => cols.map((lc) => ({
+				...lc,
+				linkerPath: annotateLinkerPath(derivedLabels, lc.linkerPath)
+			}))
+		].reduce((cols, fn) => fn(cols), linked),
 		labels: withLabelAnnotations(derivedLabels, labelColumns)
 	};
 }
+function annotateLinkerPath(derivedLabels, path) {
+	if (isNil(path) || path.length === 0) return path;
+	const annotatedLinkers = withHidenAxesAnnotations(withLabelAnnotations(derivedLabels, path.map((s) => s.linker)));
+	return path.map((s, i) => ({
+		...s,
+		linker: annotatedLinkers[i]
+	}));
+}
 /** Build an index of all valid column IDs (axes + columns) for filter/sorting validation. */
 function createColumnValidationById(fullColumns) {
 	const allIds = [...uniqueBy(fullColumns.flatMap((c) => c.spec.axesSpec.map(getAxisId)), (a) => canonicalizeJson(a)).map((a) => ({
@@ -149,6 +181,28 @@ function validateSorting(sorting, isValidColumnId) {
 	const firstInvalid = sorting.find((s) => !isValidColumnId(canonicalizeJson(s.column)));
 	if (firstInvalid !== void 0) throw new Error(`Invalid sorting column ${JSON.stringify(firstInvalid.column)}: column reference does not match the table columns`);
 }
+function buildSecondaryGroups(direct, linked, labels) {
+	return [
+		...direct.map((c) => ({
+			entries: [{
+				column: resolveSnapshot(c),
+				qualifications: c.qualifications?.forHit
+			}],
+			primaryQualifications: c.qualifications?.forQueries
+		})),
+		...linked.map((lc) => ({
+			entries: [...(lc.linkerPath ?? []).map((s) => ({
+				column: resolveSnapshot(s.linker),
+				qualifications: s.qualifications
+			})), {
+				column: resolveSnapshot(lc),
+				qualifications: lc.qualifications?.forHit
+			}],
+			primaryQualifications: lc.qualifications?.forQueries
+		})),
+		...labels.map((c) => ({ entries: [{ column: c }] }))
+	];
+}
 /** Determine which columns should be hidden based on state or optional-column defaults. */
 function computeHiddenColumns(columns, sorting, filters, hiddenSpecs) {
 	const alwaysHidden = columns.filter((c) => isColumnHidden(c.spec)).map((c) => c.id);
@@ -157,52 +211,6 @@ function computeHiddenColumns(columns, sorting, filters, hiddenSpecs) {
 	const preserved = collectPreservedColumnIds(sorting, filters);
 	return new Set(initial.filter((id) => !preserved.has(id)));
 }
-/**
-* Build visible linked column groups. Non-hidden groups are included fully;
-* hidden groups are trimmed to only the prefix that brings axes not yet
-* covered by earlier groups (visible or previously trimmed).
-*/
-function buildVisibleLinkedGroups(direct, linked, linkers, hiddenSpecs) {
-	const result = [];
-	const coveredAxisIds = /* @__PURE__ */ new Set();
-	const collectAxes = (group) => {
-		for (const col of group) for (const as of col.spec.axesSpec) coveredAxisIds.add(canonicalizeJson(getAxisId(as)));
-	};
-	collectAxes(direct);
-	for (const lc of linked) {
-		const group = [...linkers.get(lc.id) ?? [], lc];
-		result.push(group);
-		collectAxes(group);
-	}
-	for (const group of linkers.values()) {
-		const trimmed = trimGroupByVisibleAxes(group, hiddenSpecs, coveredAxisIds);
-		if (trimmed.length > 0) {
-			result.push(trimmed);
-			collectAxes(trimmed);
-		}
-	}
-	return result;
-}
-/**
-* For a linked column group [linker1, ..., linkerN, column], find the rightmost
-* element that has at least one non-hidden and not-yet-covered axis.
-* Return the prefix up to and including that element.
-* If no element has such an axis, return empty array.
-*/
-function trimGroupByVisibleAxes(group, hiddenSpecs, coveredAxisIds) {
-	if (hiddenSpecs === null) return group;
-	const hiddenAxisIds = new Set(hiddenSpecs.filter((s) => s.type === "axis").map((s) => canonicalizeJson(s.id)));
-	const uncoveredAxisIds = new Set(group.flatMap((c) => c.spec.axesSpec.map((as) => canonicalizeJson(getAxisId(as)))).filter((id) => !hiddenAxisIds.has(id) && !coveredAxisIds.has(id)));
-	let lastNeeded = -1;
-	for (let i = 0; i < group.length; i++) {
-		const newAxes = group[i].spec.axesSpec.map((as) => canonicalizeJson(getAxisId(as))).filter((id) => uncoveredAxisIds.has(id));
-		if (newAxes.length > 0) {
-			for (const id of newAxes) uncoveredAxisIds.delete(id);
-			lastNeeded = i;
-		}
-	}
-	return lastNeeded === -1 ? [] : group.slice(0, lastNeeded + 1);
-}
 /** Collect IDs of columns that must remain visible (sorted, filtered). */
 function collectPreservedColumnIds(sorting, filters) {
 	const sortedIds = (sorting ?? []).map((s) => s.column).filter((c) => c.type === "column").map((c) => c.id);
@@ -219,7 +227,7 @@ function buildVisibleColumns(annotated, hiddenColumns, originalLabelColumns) {
 	return {
 		direct,
 		linked,
-		labels: getMatchingLabelColumns([...direct, ...linked].map(getColumnIdAndSpec), originalLabelColumns)
+		labels: getMatchingLabelColumns([...direct, ...linked], originalLabelColumns)
 	};
 }
 /** Resolve a ColumnSnapshot to a PColumn with lazily-evaluated data. */

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

@@ -1 +1 @@
-{"version":3,"file":"createPlDataTableV3.js","names":[],"sources":["../../../../src/components/PlDataTable/createPlDataTable/createPlDataTableV3.ts"],"sourcesContent":["import type {\n  AxisId,\n  CanonicalizedJson,\n  FilterSpecNode,\n  PColumn,\n  PObjectId,\n  PTableColumnId,\n  PTableColumnIdAxis,\n  PTableColumnIdColumn,\n  PTableSorting,\n  PColumnSpec,\n  MultiColumnSelector,\n  SUniversalPColumnId,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  canonicalizeJson,\n  getAxisId,\n  getColumnIdAndSpec,\n  parseJson,\n  uniqueBy,\n} from \"@milaboratories/pl-model-common\";\nimport { collectFilterSpecColumns, traverseFilterSpec } from \"../../../filters/traverse\";\nimport type { RenderCtxBase, PColumnDataUniversal } from \"../../../render\";\nimport { isEmpty } from \"es-toolkit/compat\";\nimport type { PlDataTableFilters, PlDataTableFilterSpecLeaf, PlDataTableModel } from \"../typesV5\";\nimport { upgradePlDataTableStateV2 } from \"../state-migration\";\nimport type { PlDataTableStateV2 } from \"../state-migration\";\nimport type { ColumnMatch, ColumnSnapshot, MatchingMode } from \"../../../columns\";\nimport { Services, type RequireServices } from \"@milaboratories/pl-model-common\";\nimport { getAllLabelColumns, getMatchingLabelColumns } from \"../labels\";\nimport type { DeriveLabelsOptions } from \"../../../labels/derive_distinct_labels\";\nimport {\n  deriveAllLabels,\n  isColumnHidden,\n  isColumnOptional,\n  withLabelAnnotations,\n  withTableVisualAnnotations,\n} from \"./utils\";\nimport { createPTableDefV3 } from \"./createPTableDefV3\";\nimport { discoverTableColumnSnaphots, type DiscoveredTableColumnOptions } from \"./discoverColumns\";\nimport { isNil, RequiredBy, throwError, type Nil } from \"@milaboratories/helpers\";\n\nexport type createPlDataTableOptionsV3 = (\n  | {\n      discoverColumnOptions: DiscoveredTableColumnOptions;\n    }\n  | {\n      columns: Nil | TableColumnSnapshot<SUniversalPColumnId>[];\n    }\n) & {\n  filters?: PlDataTableFilters;\n  sorting?: PTableSorting[];\n  primaryJoinType?: \"inner\" | \"full\";\n\n  tableState?: PlDataTableStateV2;\n  labelsOptions?: DeriveLabelsOptions;\n  columnsDisplayOptions?: ColumnsDisplayOptions;\n};\n\n/** Structured source config — selectors/anchors instead of raw ColumnSource. */\nexport type ColumnsSelectorConfig = {\n  include?: MultiColumnSelector | MultiColumnSelector[];\n  exclude?: MultiColumnSelector | MultiColumnSelector[];\n  mode?: MatchingMode;\n  maxHops?: number;\n};\n\nexport type ColumnsDisplayOptions = {\n  /** Column ordering rules. Higher priority = further left. First matching rule wins. */\n  ordering?: ColumnOrderRule[];\n  /** Column visibility rules. First matching rule wins. Unmatched columns use default visibility. */\n  visibility?: ColumnVisibilityRule[];\n};\n\nexport type ColumnOrderRule = {\n  match: ColumnMatcher;\n  /** Higher number = further left in table */\n  priority: number;\n};\n\nexport type ColumnVisibilityRule = {\n  match: ColumnMatcher;\n  visibility: \"default\" | \"optional\" | \"hidden\";\n};\n\nexport type ColumnMatcher = (spec: PColumnSpec) => boolean;\n\n// Main Function\n\nexport function createPlDataTableV3<A, U, S extends RequireServices<typeof Services.PFrameSpec>>(\n  ctx: RenderCtxBase<A, U, S>,\n  options: createPlDataTableOptionsV3,\n): PlDataTableModel | undefined {\n  const state = upgradePlDataTableStateV2(options.tableState);\n  const primaryJoinType = options.primaryJoinType ?? \"full\";\n\n  const discovered =\n    \"discoverColumnOptions\" in options\n      ? discoverTableColumnSnaphots(ctx, options.discoverColumnOptions)\n      : options.columns;\n  if (isNil(discovered) || discovered.length === 0) return undefined;\n\n  const splited = splitDiscoveredColumns(discovered);\n  const resolved = resolveDiscoveredColumns(splited, discovered);\n\n  const labelColumns = getMatchingLabelColumns(resolved.all, getAllLabelColumns(ctx));\n\n  const derivedLabels = deriveAllLabels({\n    columns: discovered.map((dc) => ({\n      id: dc.id,\n      spec: dc.spec,\n      linkerPath: dc.linkerPath?.map((lp) => ({ spec: lp.linker.spec })),\n    })),\n    labelColumns,\n    deriveLabelsOptions: {\n      includeNativeLabel: true,\n      ...options.labelsOptions,\n    },\n  });\n\n  const annotated = annotateColumnGroups(\n    resolved,\n    labelColumns,\n    derivedLabels,\n    options.columnsDisplayOptions,\n  );\n\n  const primaryColumnIds = new Set<PObjectId>(\n    discovered.filter((dc) => dc.isPrimary).map((dc) => dc.id),\n  );\n  const primaryColumns = annotated.direct.filter((c) => primaryColumnIds.has(c.id));\n  const secondaryColumns = annotated.direct.filter((c) => !primaryColumnIds.has(c.id));\n\n  if (primaryColumns.length === 0) return undefined;\n\n  const columnIsAvailable = createColumnValidationById([\n    ...annotated.direct,\n    ...annotated.linked.flatMap((lc) => [...(annotated.linkers.get(lc.id) ?? []), lc]),\n    ...annotated.labels,\n  ]);\n\n  const remapedDefaultFilters = remapFilterColumnIds(options.filters, discovered);\n  const filters = concatFilters(\n    state.pTableParams.filters,\n    state.pTableParams.defaultFilters ?? remapedDefaultFilters,\n  );\n  validateFilters(filters, columnIsAvailable);\n\n  const sorting = resolveSorting(\n    state.pTableParams.sorting,\n    remapSortingColumnIds(options.sorting, discovered),\n  );\n  validateSorting(sorting, columnIsAvailable);\n\n  const fullDef = createPTableDefV3({\n    primaryJoinType,\n    primaryColumns,\n    secondaryGroups: [\n      ...secondaryColumns.map((c) => [c]),\n      ...annotated.linked.map((lc) => [...(annotated.linkers.get(lc.id) ?? []), lc]),\n      ...annotated.labels.map((c) => [c]),\n    ],\n    filters,\n    sorting,\n  });\n\n  const fullHandle = ctx.createPTableV2(fullDef);\n  const pframeHandle = ctx.createPFrame([\n    ...annotated.direct,\n    ...annotated.linked,\n    ...annotated.labels,\n    ...uniqueBy([...annotated.linkers.values()].flat(), (c) => c.id),\n  ]);\n\n  const hiddenSpecs = state.pTableParams.hiddenColIds;\n  const hiddenColumnIds = computeHiddenColumns(\n    [...annotated.direct, ...annotated.linked],\n    sorting,\n    filters,\n    hiddenSpecs,\n  );\n\n  const visible = buildVisibleColumns(annotated, hiddenColumnIds, labelColumns);\n  const visibleNonCoreDirect = secondaryColumns.filter((c) => !hiddenColumnIds.has(c.id));\n  const visibleLinkedGroups = buildVisibleLinkedGroups(\n    visible.direct,\n    visible.linked,\n    annotated.linkers,\n    hiddenSpecs,\n  );\n\n  const visibleDef = createPTableDefV3({\n    primaryJoinType,\n    primaryColumns,\n    secondaryGroups: [\n      ...visibleNonCoreDirect.map((c) => [c]),\n      ...visibleLinkedGroups,\n      ...visible.labels.map((c) => [c]),\n    ],\n    filters,\n    sorting,\n  });\n  const visibleHandle = ctx.createPTableV2(visibleDef);\n\n  return {\n    sourceId: state.pTableParams.sourceId,\n    fullTableHandle: fullHandle,\n    fullPframeHandle: pframeHandle,\n    visibleTableHandle: visibleHandle,\n    defaultFilters: remapedDefaultFilters,\n  } satisfies PlDataTableModel;\n}\n\n/** A single column discovered from sources — normalized from raw ColumnSnapshot/ColumnMatch. */\nexport type TableColumnSnapshot<Id extends PObjectId | SUniversalPColumnId> = ColumnSnapshot<Id> & {\n  readonly isPrimary?: boolean;\n  readonly originalId?: PObjectId;\n  readonly linkerPath?: ColumnMatch[\"path\"];\n};\n\ntype TableColumn = PColumn<undefined | PColumnDataUniversal>;\n\ntype SplitDiscoveredColumns = {\n  readonly direct: TableColumnSnapshot<SUniversalPColumnId>[];\n  readonly linked: TableColumnSnapshot<SUniversalPColumnId>[];\n};\n\ntype ResolvedColumns = {\n  readonly direct: TableColumn[];\n  readonly linked: TableColumn[];\n  readonly linkers: Map<PObjectId, TableColumn[]>;\n  readonly all: TableColumn[];\n};\n\ntype AnnotatedColumnGroups = {\n  readonly direct: TableColumn[];\n  readonly linked: TableColumn[];\n  readonly linkers: Map<PObjectId, TableColumn[]>;\n  readonly labels: TableColumn[];\n};\n\ntype VisibleColumns = {\n  readonly direct: TableColumn[];\n  readonly linked: TableColumn[];\n  readonly labels: PColumn<PColumnDataUniversal>[];\n};\n\n/** Split discovered columns into direct (no linker path) and linked (with linker path). */\nfunction splitDiscoveredColumns(\n  columns: TableColumnSnapshot<SUniversalPColumnId>[],\n): SplitDiscoveredColumns {\n  return {\n    direct: columns.filter((dc) => isNil(dc.linkerPath) || dc.linkerPath.length === 0),\n    linked: columns.filter((dc) => !isNil(dc.linkerPath) && dc.linkerPath.length > 0),\n  };\n}\n\n/** Resolve DiscoveredColumn snapshots into PColumn objects with lazily-evaluated data. */\nfunction resolveDiscoveredColumns(\n  split: SplitDiscoveredColumns,\n  allDiscovered: TableColumnSnapshot<SUniversalPColumnId>[],\n): ResolvedColumns {\n  const linked = split.linked.map(resolveSnapshot);\n  const linkers = new Map<PObjectId, TableColumn[]>(\n    split.linked\n      .filter(\n        (dc): dc is RequiredBy<TableColumnSnapshot<SUniversalPColumnId>, \"linkerPath\"> =>\n          !isNil(dc.linkerPath),\n      )\n      .map((dc, i) => [linked[i].id, dc.linkerPath.map((s) => resolveSnapshot(s.linker))]),\n  );\n\n  return {\n    all: allDiscovered.map(resolveSnapshot),\n    direct: split.direct.map(resolveSnapshot),\n    linked,\n    linkers,\n  };\n}\n\n/** Annotate all column groups with derived labels and display options. */\nfunction annotateColumnGroups(\n  resolved: ResolvedColumns,\n  labelColumns: PColumn<PColumnDataUniversal>[],\n  derivedLabels: Record<string, string>,\n  displayOptions: ColumnsDisplayOptions | undefined,\n): AnnotatedColumnGroups {\n  const direct = withTableVisualAnnotations(\n    displayOptions,\n    withLabelAnnotations(derivedLabels, resolved.direct),\n  );\n  const linked = withTableVisualAnnotations(\n    displayOptions,\n    withLabelAnnotations(derivedLabels, resolved.linked),\n  );\n  const linkers = new Map<PObjectId, TableColumn[]>(\n    [...resolved.linkers].map(([id, cols]) => [id, withLabelAnnotations(derivedLabels, cols)]),\n  );\n  const labels = withLabelAnnotations(derivedLabels, labelColumns);\n\n  return { direct, linked, linkers, labels };\n}\n\n/** Build an index of all valid column IDs (axes + columns) for filter/sorting validation. */\nfunction createColumnValidationById(fullColumns: TableColumn[]) {\n  const axisIds = uniqueBy(\n    fullColumns.flatMap((c) => c.spec.axesSpec.map(getAxisId)),\n    (a) => canonicalizeJson<AxisId>(a),\n  );\n\n  const allIds: PTableColumnId[] = [\n    ...axisIds.map((a) => ({ type: \"axis\", id: a }) satisfies PTableColumnIdAxis),\n    ...fullColumns.map((c) => ({ type: \"column\", id: c.id }) satisfies PTableColumnIdColumn),\n  ];\n\n  const validIdSet = new Set(allIds.map((c) => canonicalizeJson<PTableColumnId>(c)));\n\n  return (id: string): boolean => {\n    return validIdSet.has(id as CanonicalizedJson<PTableColumnId>);\n  };\n}\n\n/** Validate that all column references in filters exist in the table. */\nfunction validateFilters(\n  filters: Nil | PlDataTableFilters,\n  isValidColumnId: (id: string) => boolean,\n): void {\n  if (filters == null) return;\n  const filterColumns = collectFilterSpecColumns(filters);\n  const firstInvalid = filterColumns.find((col) => !isValidColumnId(col));\n  if (firstInvalid !== undefined) {\n    throw new Error(\n      `Invalid filter column ${firstInvalid}: column reference does not match the table columns`,\n    );\n  }\n}\n\n/** Merge two filter trees into one AND-combined tree. Returns the non-nil one if the other is nil. */\nfunction concatFilters(\n  a: Nil | PlDataTableFilters,\n  b: Nil | PlDataTableFilters,\n): Nil | PlDataTableFilters {\n  if (isNil(a)) return b;\n  if (isNil(b)) return a;\n  return { ...a, filters: [...a.filters, ...b.filters] };\n}\n\n/** Pick user sorting from state if non-empty, otherwise fall back to options default. */\nfunction resolveSorting(\n  userSorting: PTableSorting[],\n  defaultSorting: Nil | PTableSorting[],\n): PTableSorting[] {\n  return (isEmpty(userSorting) ? defaultSorting : userSorting) ?? [];\n}\n\n/** Validate that all column references in sorting exist in the table. */\nfunction validateSorting(sorting: PTableSorting[], isValidColumnId: (id: string) => boolean): void {\n  const firstInvalid = sorting.find(\n    (s) => !isValidColumnId(canonicalizeJson<PTableColumnId>(s.column)),\n  );\n  if (firstInvalid !== undefined) {\n    throw new Error(\n      `Invalid sorting column ${JSON.stringify(firstInvalid.column)}: column reference does not match the table columns`,\n    );\n  }\n}\n\n/** Determine which columns should be hidden based on state or optional-column defaults. */\nfunction computeHiddenColumns(\n  columns: TableColumn[],\n  sorting: Nil | PTableSorting[],\n  filters: Nil | PlDataTableFilters,\n  hiddenSpecs: Nil | PTableColumnId[],\n): Set<PObjectId> {\n  const alwaysHidden = columns.filter((c) => isColumnHidden(c.spec)).map((c) => c.id);\n  const optionalHidden = !isNil(hiddenSpecs)\n    ? hiddenSpecs.filter((s): s is PTableColumnIdColumn => s.type === \"column\").map((s) => s.id)\n    : columns.filter((c) => isColumnOptional(c.spec)).map((c) => c.id);\n  const initial = [...alwaysHidden, ...optionalHidden];\n  const preserved = collectPreservedColumnIds(sorting, filters);\n\n  return new Set(initial.filter((id) => !preserved.has(id)));\n}\n\n/**\n * Build visible linked column groups. Non-hidden groups are included fully;\n * hidden groups are trimmed to only the prefix that brings axes not yet\n * covered by earlier groups (visible or previously trimmed).\n */\nfunction buildVisibleLinkedGroups(\n  direct: TableColumn[],\n  linked: TableColumn[],\n  linkers: Map<PObjectId, TableColumn[]>,\n  hiddenSpecs: PTableColumnId[] | null,\n): TableColumn[][] {\n  const result: TableColumn[][] = [];\n  const coveredAxisIds = new Set<CanonicalizedJson<AxisId>>();\n\n  const collectAxes = (group: TableColumn[]) => {\n    for (const col of group) {\n      for (const as of col.spec.axesSpec) {\n        coveredAxisIds.add(canonicalizeJson(getAxisId(as)));\n      }\n    }\n  };\n\n  collectAxes(direct);\n\n  for (const lc of linked) {\n    const group = [...(linkers.get(lc.id) ?? []), lc];\n    result.push(group);\n    collectAxes(group);\n  }\n\n  for (const group of linkers.values()) {\n    const trimmed = trimGroupByVisibleAxes(group, hiddenSpecs, coveredAxisIds);\n    if (trimmed.length > 0) {\n      result.push(trimmed);\n      collectAxes(trimmed);\n    }\n  }\n\n  return result;\n}\n\n/**\n * For a linked column group [linker1, ..., linkerN, column], find the rightmost\n * element that has at least one non-hidden and not-yet-covered axis.\n * Return the prefix up to and including that element.\n * If no element has such an axis, return empty array.\n */\nfunction trimGroupByVisibleAxes(\n  group: TableColumn[],\n  hiddenSpecs: PTableColumnId[] | null,\n  coveredAxisIds: Set<CanonicalizedJson<AxisId>>,\n): TableColumn[] {\n  if (hiddenSpecs === null) return group;\n\n  const hiddenAxisIds = new Set(\n    hiddenSpecs\n      .filter((s): s is PTableColumnIdAxis => s.type === \"axis\")\n      .map((s) => canonicalizeJson(s.id)),\n  );\n\n  const uncoveredAxisIds = new Set(\n    group\n      .flatMap((c) => c.spec.axesSpec.map((as) => canonicalizeJson(getAxisId(as))))\n      .filter((id) => !hiddenAxisIds.has(id) && !coveredAxisIds.has(id)),\n  );\n\n  let lastNeeded = -1;\n  for (let i = 0; i < group.length; i++) {\n    const newAxes = group[i].spec.axesSpec\n      .map((as) => canonicalizeJson(getAxisId(as)))\n      .filter((id) => uncoveredAxisIds.has(id));\n    if (newAxes.length > 0) {\n      for (const id of newAxes) uncoveredAxisIds.delete(id);\n      lastNeeded = i;\n    }\n  }\n  return lastNeeded === -1 ? [] : group.slice(0, lastNeeded + 1);\n}\n\n/** Collect IDs of columns that must remain visible (sorted, filtered). */\nfunction collectPreservedColumnIds(\n  sorting: Nil | PTableSorting[],\n  filters: Nil | PlDataTableFilters,\n): Set<PObjectId> {\n  const sortedIds = (sorting ?? [])\n    .map((s) => s.column)\n    .filter((c): c is PTableColumnIdColumn => c.type === \"column\")\n    .map((c) => c.id);\n\n  const filterIds = !isNil(filters)\n    ? collectFilterSpecColumns(filters).flatMap((c) => {\n        const obj = parseJson(c);\n        return obj.type === \"column\" ? [obj.id] : [];\n      })\n    : [];\n\n  return new Set<PObjectId>([...sortedIds, ...filterIds]);\n}\n\n/** Filter annotated columns to only visible ones, re-matching label columns for the visible subset. */\nfunction buildVisibleColumns(\n  annotated: AnnotatedColumnGroups,\n  hiddenColumns: Set<PObjectId>,\n  originalLabelColumns: PColumn<PColumnDataUniversal>[],\n): VisibleColumns {\n  const direct = annotated.direct.filter((c) => !hiddenColumns.has(c.id));\n  const linked = annotated.linked.filter((c) => !hiddenColumns.has(c.id));\n  const labels = getMatchingLabelColumns(\n    [...direct, ...linked].map(getColumnIdAndSpec),\n    originalLabelColumns,\n  );\n  return { direct, linked, labels };\n}\n\n/** Resolve a ColumnSnapshot to a PColumn with lazily-evaluated data. */\nfunction resolveSnapshot(\n  snap: ColumnSnapshot<PObjectId>,\n): PColumn<undefined | PColumnDataUniversal> {\n  return { id: snap.id, spec: snap.spec, data: snap.data?.get() };\n}\n\n/** Remap column references in sorting entries. */\nfunction remapSortingColumnIds(\n  sorting: Nil | PTableSorting[],\n  columns: TableColumnSnapshot<PObjectId | SUniversalPColumnId>[],\n): Nil | PTableSorting[] {\n  return sorting?.map((s) => {\n    if (s.column.type === \"axis\") return s; // Axis references are unaffected by column ID remapping\n\n    const id = s.column.id;\n    const column =\n      columns.find((c) => (c.originalId ?? c.id) === id) ??\n      throwError(`Column ID \"${id}\" in sorting does not match any discovered column`);\n\n    return {\n      ...s,\n      column: {\n        type: \"column\",\n        id: column.id,\n      },\n    };\n  });\n}\n\ntype PlDataTableFilterNode = FilterSpecNode<PlDataTableFilterSpecLeaf>;\n\n/** Remap column references in a filter tree. */\nfunction remapFilterColumnIds(\n  filters: Nil | PlDataTableFilters,\n  columns: TableColumnSnapshot<PObjectId | SUniversalPColumnId>[],\n): Nil | PlDataTableFilters {\n  if (isNil(filters)) return filters;\n\n  const map = (\n    tableColumnId: CanonicalizedJson<PTableColumnId>,\n  ): CanonicalizedJson<PTableColumnId> => {\n    const parsed = parseJson<PTableColumnId>(tableColumnId);\n    if (parsed.type === \"axis\") return tableColumnId; // Axis references are unaffected by column ID remapping\n\n    const originalId = parsed.id;\n    const column =\n      columns.find((c) => (c.originalId ?? c.id) === originalId) ??\n      throwError(`Column ID \"${parsed.id}\" in filters does not match any discovered column`);\n\n    return canonicalizeJson<PTableColumnId>({\n      type: \"column\",\n      id: column.id,\n    });\n  };\n\n  return traverseFilterSpec(filters, {\n    leaf: (leaf): PlDataTableFilterNode => {\n      if (leaf.type === undefined) return leaf;\n      const result = { ...leaf };\n      if (\"column\" in result) result.column = map(result.column);\n      if (\"rhs\" in result) result.rhs = map(result.rhs);\n      return result;\n    },\n    and: (results): PlDataTableFilterNode => ({ type: \"and\", filters: results }),\n    or: (results): PlDataTableFilterNode => ({ type: \"or\", filters: results }),\n    not: (result): PlDataTableFilterNode => ({ type: \"not\", filter: result }),\n  }) as PlDataTableFilters;\n}\n"],"mappings":"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"}
+{"version":3,"file":"createPlDataTableV3.js","names":[],"sources":["../../../../src/components/PlDataTable/createPlDataTable/createPlDataTableV3.ts"],"sourcesContent":["import type {\n  AxisId,\n  CanonicalizedJson,\n  FilterSpecNode,\n  PColumn,\n  PObjectId,\n  PTableColumnId,\n  PTableColumnIdAxis,\n  PTableColumnIdColumn,\n  PTableSorting,\n  PColumnSpec,\n  MultiColumnSelector,\n  PFrameSpecDriver,\n  DiscoveredPColumnId,\n} from \"@milaboratories/pl-model-common\";\nimport { canonicalizeJson, getAxisId, parseJson, uniqueBy } from \"@milaboratories/pl-model-common\";\nimport { collectFilterSpecColumns, traverseFilterSpec } from \"../../../filters/traverse\";\nimport type { RenderCtxBase, PColumnDataUniversal } from \"../../../render\";\nimport { isEmpty } from \"es-toolkit/compat\";\nimport type { PlDataTableFilters, PlDataTableFilterSpecLeaf, PlDataTableModel } from \"../typesV5\";\nimport { upgradePlDataTableStateV2 } from \"../state-migration\";\nimport type { PlDataTableStateV2 } from \"../state-migration\";\nimport type {\n  ColumnSelector,\n  ColumnSnapshot,\n  MatchingMode,\n  MatchQualifications,\n  MatchVariant,\n} from \"../../../columns\";\nimport { getAllLabelColumns, getMatchingLabelColumns } from \"../labels\";\nimport type { DeriveLabelsOptions } from \"../../../labels/derive_distinct_labels\";\nimport {\n  deriveAllLabels,\n  deriveAllTooltips,\n  evaluateRules,\n  isColumnHidden,\n  isColumnOptional,\n  withHidenAxesAnnotations,\n  withLabelAnnotations,\n  withTableVisualAnnotations,\n  withInfoAnnotations,\n} from \"./utils\";\nimport type { PrimaryEntry, SecondaryGroup } from \"./createPTableDefV3\";\nimport { createPTableDefV3 } from \"./createPTableDefV3\";\nimport { discoverTableColumnSnaphots, type DiscoverTableColumnOptions } from \"./discoverColumns\";\nimport { isNil, isPlainObject, throwError, type Nil } from \"@milaboratories/helpers\";\n\nexport type createPlDataTableOptionsV3 = {\n  tableState?: PlDataTableStateV2;\n\n  columns: Nil | DiscoverTableColumnOptions | TableColumnSnapshot[];\n  filters?: PlDataTableFilters;\n  sorting?: PTableSorting[];\n  primaryJoinType?: \"inner\" | \"full\";\n\n  labelsOptions?: DeriveLabelsOptions;\n  displayOptions?: ColumnsDisplayOptions;\n};\n\n/** Structured source config — selectors/anchors instead of raw ColumnSource. */\nexport type ColumnsSelectorConfig = {\n  include?: MultiColumnSelector | MultiColumnSelector[];\n  exclude?: MultiColumnSelector | MultiColumnSelector[];\n  mode?: MatchingMode;\n  maxHops?: number;\n};\n\nexport type ColumnsDisplayOptions = {\n  /** Column ordering rules. Higher priority = further left. First matching rule wins. */\n  ordering?: ColumnOrderRule[];\n  /** Column visibility rules. First matching rule wins. Unmatched columns use default visibility. */\n  visibility?: ColumnVisibilityRule[];\n};\n\nexport type ColumnOrderRule = {\n  match: ColumnMatcher | ColumnSelector;\n  /** Higher number = further left in table */\n  priority: number;\n};\n\nexport type ColumnVisibilityRule = {\n  match: ColumnMatcher | ColumnSelector;\n  visibility: \"default\" | \"optional\" | \"hidden\";\n};\n\nexport type ColumnMatcher = (spec: PColumnSpec) => boolean;\n\n// Main Function\n\nexport function createPlDataTableV3<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  options: createPlDataTableOptionsV3,\n): PlDataTableModel | undefined {\n  const pframeSpec = ctx.getService(\"pframeSpec\");\n  const state = upgradePlDataTableStateV2(options.tableState);\n  const primaryJoinType = options.primaryJoinType ?? \"full\";\n\n  const discovered = isPlainObject(options.columns)\n    ? discoverTableColumnSnaphots(ctx, options.columns)\n    : options.columns;\n  if (isNil(discovered) || discovered.length === 0) return undefined;\n\n  const splited = splitDiscoveredColumns(discovered);\n\n  const labelColumns = getMatchingLabelColumns(\n    [...splited.direct, ...splited.linked],\n    getAllLabelColumns(ctx),\n  );\n\n  const derivedLabels = deriveAllLabels({\n    columns: discovered.map((dc) => ({\n      id: dc.id,\n      spec: dc.spec,\n      linkerPath: dc.linkerPath?.map((lp) => ({ spec: lp.linker.spec })),\n    })),\n    labelColumns,\n    deriveLabelsOptions: {\n      includeNativeLabel: true,\n      ...options.labelsOptions,\n    },\n  });\n\n  const derivedTooltips = deriveAllTooltips({\n    columns: discovered.map((dc) => ({\n      id: dc.id,\n      originalId: dc.originalId,\n      spec: dc.spec,\n      linkerPath: dc.linkerPath,\n      qualifications: dc.qualifications,\n      distinctiveQualifications: dc.distinctiveQualifications,\n    })),\n  });\n\n  const annotated = annotateColumnGroups({\n    pframeSpec,\n    ...splited,\n    labelColumns,\n    derivedLabels,\n    derivedTooltips,\n    displayOptions: options.displayOptions,\n  });\n\n  const primarySnapshots = annotated.direct.filter((c) => c.isPrimary);\n  const secondarySnapshots = annotated.direct.filter((c) => !c.isPrimary);\n\n  if (primarySnapshots.length === 0) return undefined;\n\n  const columnIsAvailable = createColumnValidationById([\n    ...annotated.direct,\n    ...annotated.linked.flatMap((lc) => [...(lc.linkerPath ?? []).map((s) => s.linker), lc]),\n    ...annotated.labels,\n  ]);\n\n  const remapedDefaultFilters = remapFilterColumnIds(options.filters, discovered);\n  const filters = concatFilters(\n    state.pTableParams.filters,\n    state.pTableParams.defaultFilters ?? remapedDefaultFilters,\n  );\n  validateFilters(filters, columnIsAvailable);\n\n  const sorting = resolveSorting(\n    state.pTableParams.sorting,\n    remapSortingColumnIds(options.sorting, discovered),\n  );\n  validateSorting(sorting, columnIsAvailable);\n\n  const primaryEntries: PrimaryEntry<undefined | PColumnDataUniversal>[] = primarySnapshots.map(\n    (snap) => ({ column: resolveSnapshot(snap) }),\n  );\n  const fullDef = createPTableDefV3({\n    primaryJoinType,\n    primary: primaryEntries,\n    secondary: buildSecondaryGroups(secondarySnapshots, annotated.linked, annotated.labels),\n    filters,\n    sorting,\n  });\n\n  const fullHandle = ctx.createPTableV2(fullDef);\n  // TODO: is workaround for dropdown suggestions.\n  // Pframe have not equivalent data for columns relativly to Ptable\n  const pframeHandle = ctx.createPFrame([\n    ...annotated.direct.map(resolveSnapshot),\n    ...annotated.linked.map(resolveSnapshot),\n    ...annotated.labels,\n    ...collectLinkerSnapshots(annotated.linked).map(resolveSnapshot),\n  ]);\n\n  const hiddenSpecs = state.pTableParams.hiddenColIds;\n  const hiddenColumnIds = computeHiddenColumns(\n    [...annotated.direct, ...annotated.linked],\n    sorting,\n    filters,\n    hiddenSpecs,\n  );\n\n  const visible = buildVisibleColumns(annotated, hiddenColumnIds, labelColumns);\n  const visibleDef = createPTableDefV3({\n    primaryJoinType,\n    primary: primaryEntries,\n    secondary: buildSecondaryGroups(\n      visible.direct.filter((c) => !c.isPrimary),\n      visible.linked,\n      visible.labels,\n    ),\n    filters,\n    sorting,\n  });\n  const visibleHandle = ctx.createPTableV2(visibleDef);\n\n  return {\n    sourceId: state.pTableParams.sourceId,\n    fullTableHandle: fullHandle,\n    fullPframeHandle: pframeHandle,\n    visibleTableHandle: visibleHandle,\n    defaultFilters: remapedDefaultFilters,\n  } satisfies PlDataTableModel;\n}\n\n/** A single column discovered from sources — normalized from raw ColumnSnapshot/ColumnMatch. */\nexport type TableColumnSnapshot = ColumnSnapshot<DiscoveredPColumnId> & {\n  readonly originalId: PObjectId;\n  readonly isPrimary?: boolean;\n  readonly linkerPath?: MatchVariant[\"path\"];\n  readonly qualifications?: MatchQualifications;\n  readonly distinctiveQualifications?: MatchQualifications;\n};\n\ntype SplitDiscoveredColumns = {\n  readonly direct: TableColumnSnapshot[];\n  readonly linked: TableColumnSnapshot[];\n};\n\ntype AnnotatedColumnGroups = {\n  readonly direct: TableColumnSnapshot[];\n  readonly linked: TableColumnSnapshot[];\n  readonly labels: PColumn<PColumnDataUniversal>[];\n};\n\ntype VisibleColumns = {\n  readonly direct: TableColumnSnapshot[];\n  readonly linked: TableColumnSnapshot[];\n  readonly labels: PColumn<PColumnDataUniversal>[];\n};\n\n/** Split discovered columns into direct (no linker path) and linked (with linker path). */\nfunction splitDiscoveredColumns(columns: TableColumnSnapshot[]): SplitDiscoveredColumns {\n  const direct = columns.filter((dc) => isNil(dc.linkerPath) || dc.linkerPath.length === 0);\n  const linked = columns.filter((dc) => !isNil(dc.linkerPath) && dc.linkerPath.length > 0);\n  return { direct, linked };\n}\n\n/** All linker snapshots across the given linked columns, deduped by id. */\nfunction collectLinkerSnapshots(linked: TableColumnSnapshot[]): ColumnSnapshot<PObjectId>[] {\n  return uniqueBy(\n    linked.flatMap((lc) => (lc.linkerPath ?? []).map((s) => s.linker)),\n    (c) => c.id,\n  );\n}\n\n/**\n * Annotate all column groups with derived labels and display-rule annotations.\n * Evaluates `displayOptions` rules against all discovered columns (direct,\n * linked, labels, linkers) and writes the winning visibility/priority into\n * column annotations via `withTableVisualAnnotations`.\n */\nfunction annotateColumnGroups(params: {\n  direct: TableColumnSnapshot[];\n  linked: TableColumnSnapshot[];\n  labelColumns: PColumn<PColumnDataUniversal>[];\n  derivedLabels: Record<string, string>;\n  derivedTooltips: Record<string, string>;\n  displayOptions?: ColumnsDisplayOptions;\n  pframeSpec: PFrameSpecDriver;\n}): AnnotatedColumnGroups {\n  const {\n    direct,\n    linked,\n    labelColumns,\n    derivedLabels,\n    derivedTooltips,\n    displayOptions,\n    pframeSpec,\n  } = params;\n\n  const allColumnsForRules = [\n    ...direct,\n    ...linked,\n    ...labelColumns,\n    ...collectLinkerSnapshots(linked),\n  ];\n  const visibilityByColId = evaluateRules(\n    displayOptions?.visibility ?? [],\n    allColumnsForRules,\n    pframeSpec,\n  );\n  const orderByColId = evaluateRules(\n    displayOptions?.ordering ?? [],\n    allColumnsForRules,\n    pframeSpec,\n  );\n\n  const directAnnotated = [\n    withLabelAnnotations.bind(null, derivedLabels),\n    withInfoAnnotations.bind(null, derivedTooltips),\n    withTableVisualAnnotations.bind(null, visibilityByColId, orderByColId),\n  ].reduce((cols, fn) => fn(cols) as TableColumnSnapshot[], direct);\n\n  const linkedAnnotated = [\n    withLabelAnnotations.bind(null, derivedLabels),\n    withInfoAnnotations.bind(null, derivedTooltips),\n    withTableVisualAnnotations.bind(null, visibilityByColId, orderByColId),\n    (cols: TableColumnSnapshot[]) =>\n      cols.map((lc) => ({ ...lc, linkerPath: annotateLinkerPath(derivedLabels, lc.linkerPath) })),\n  ].reduce((cols, fn) => fn(cols) as TableColumnSnapshot[], linked);\n\n  const labelColumnsAnnotated = withLabelAnnotations(derivedLabels, labelColumns);\n\n  return {\n    direct: directAnnotated,\n    linked: linkedAnnotated,\n    labels: labelColumnsAnnotated,\n  };\n}\nfunction annotateLinkerPath(\n  derivedLabels: Record<string, string>,\n  path: TableColumnSnapshot[\"linkerPath\"],\n): TableColumnSnapshot[\"linkerPath\"] {\n  if (isNil(path) || path.length === 0) return path;\n  const annotatedLinkers = withHidenAxesAnnotations(\n    withLabelAnnotations(\n      derivedLabels,\n      path.map((s) => s.linker),\n    ),\n  );\n  return path.map((s, i) => ({ ...s, linker: annotatedLinkers[i] }));\n}\n\n/** Build an index of all valid column IDs (axes + columns) for filter/sorting validation. */\nfunction createColumnValidationById(\n  fullColumns: { readonly id: PObjectId; readonly spec: PColumnSpec }[],\n) {\n  const axisIds = uniqueBy(\n    fullColumns.flatMap((c) => c.spec.axesSpec.map(getAxisId)),\n    (a) => canonicalizeJson<AxisId>(a),\n  );\n\n  const allIds: PTableColumnId[] = [\n    ...axisIds.map((a) => ({ type: \"axis\", id: a }) satisfies PTableColumnIdAxis),\n    ...fullColumns.map((c) => ({ type: \"column\", id: c.id }) satisfies PTableColumnIdColumn),\n  ];\n\n  const validIdSet = new Set(allIds.map((c) => canonicalizeJson<PTableColumnId>(c)));\n\n  return (id: string): boolean => {\n    return validIdSet.has(id as CanonicalizedJson<PTableColumnId>);\n  };\n}\n\n/** Validate that all column references in filters exist in the table. */\nfunction validateFilters(\n  filters: Nil | PlDataTableFilters,\n  isValidColumnId: (id: string) => boolean,\n): void {\n  if (filters == null) return;\n  const filterColumns = collectFilterSpecColumns(filters);\n  const firstInvalid = filterColumns.find((col) => !isValidColumnId(col));\n  if (firstInvalid !== undefined) {\n    throw new Error(\n      `Invalid filter column ${firstInvalid}: column reference does not match the table columns`,\n    );\n  }\n}\n\n/** Merge two filter trees into one AND-combined tree. Returns the non-nil one if the other is nil. */\nfunction concatFilters(\n  a: Nil | PlDataTableFilters,\n  b: Nil | PlDataTableFilters,\n): Nil | PlDataTableFilters {\n  if (isNil(a)) return b;\n  if (isNil(b)) return a;\n  return { ...a, filters: [...a.filters, ...b.filters] };\n}\n\n/** Pick user sorting from state if non-empty, otherwise fall back to options default. */\nfunction resolveSorting(\n  userSorting: PTableSorting[],\n  defaultSorting: Nil | PTableSorting[],\n): PTableSorting[] {\n  return (isEmpty(userSorting) ? defaultSorting : userSorting) ?? [];\n}\n\n/** Validate that all column references in sorting exist in the table. */\nfunction validateSorting(sorting: PTableSorting[], isValidColumnId: (id: string) => boolean): void {\n  const firstInvalid = sorting.find(\n    (s) => !isValidColumnId(canonicalizeJson<PTableColumnId>(s.column)),\n  );\n  if (firstInvalid !== undefined) {\n    throw new Error(\n      `Invalid sorting column ${JSON.stringify(firstInvalid.column)}: column reference does not match the table columns`,\n    );\n  }\n}\n\nfunction buildSecondaryGroups(\n  direct: TableColumnSnapshot[],\n  linked: TableColumnSnapshot[],\n  labels: PColumn<PColumnDataUniversal>[],\n): SecondaryGroup<undefined | PColumnDataUniversal>[] {\n  return [\n    ...direct.map(\n      (c): SecondaryGroup<undefined | PColumnDataUniversal> => ({\n        entries: [{ column: resolveSnapshot(c), qualifications: c.qualifications?.forHit }],\n        primaryQualifications: c.qualifications?.forQueries,\n      }),\n    ),\n    ...linked.map(\n      (lc): SecondaryGroup<undefined | PColumnDataUniversal> => ({\n        entries: [\n          ...(lc.linkerPath ?? []).map((s) => ({\n            column: resolveSnapshot(s.linker),\n            qualifications: s.qualifications,\n          })),\n          { column: resolveSnapshot(lc), qualifications: lc.qualifications?.forHit },\n        ],\n        primaryQualifications: lc.qualifications?.forQueries,\n      }),\n    ),\n    ...labels.map(\n      (c): SecondaryGroup<undefined | PColumnDataUniversal> => ({ entries: [{ column: c }] }),\n    ),\n  ];\n}\n\n/** Determine which columns should be hidden based on state or optional-column defaults. */\nfunction computeHiddenColumns(\n  columns: { readonly id: PObjectId; readonly spec: PColumnSpec }[],\n  sorting: Nil | PTableSorting[],\n  filters: Nil | PlDataTableFilters,\n  hiddenSpecs: Nil | PTableColumnId[],\n): Set<PObjectId> {\n  const alwaysHidden = columns.filter((c) => isColumnHidden(c.spec)).map((c) => c.id);\n  const optionalHidden = !isNil(hiddenSpecs)\n    ? hiddenSpecs.filter((s): s is PTableColumnIdColumn => s.type === \"column\").map((s) => s.id)\n    : columns.filter((c) => isColumnOptional(c.spec)).map((c) => c.id);\n  const initial = [...alwaysHidden, ...optionalHidden];\n  const preserved = collectPreservedColumnIds(sorting, filters);\n\n  return new Set(initial.filter((id) => !preserved.has(id)));\n}\n\n/** Collect IDs of columns that must remain visible (sorted, filtered). */\nfunction collectPreservedColumnIds(\n  sorting: Nil | PTableSorting[],\n  filters: Nil | PlDataTableFilters,\n): Set<PObjectId> {\n  const sortedIds = (sorting ?? [])\n    .map((s) => s.column)\n    .filter((c): c is PTableColumnIdColumn => c.type === \"column\")\n    .map((c) => c.id);\n\n  const filterIds = !isNil(filters)\n    ? collectFilterSpecColumns(filters).flatMap((c) => {\n        const obj = parseJson(c);\n        return obj.type === \"column\" ? [obj.id] : [];\n      })\n    : [];\n\n  return new Set<PObjectId>([...sortedIds, ...filterIds]);\n}\n\n/** Filter annotated columns to only visible ones, re-matching label columns for the visible subset. */\nfunction buildVisibleColumns(\n  annotated: AnnotatedColumnGroups,\n  hiddenColumns: Set<PObjectId>,\n  originalLabelColumns: PColumn<PColumnDataUniversal>[],\n): VisibleColumns {\n  const direct = annotated.direct.filter((c) => !hiddenColumns.has(c.id));\n  const linked = annotated.linked.filter((c) => !hiddenColumns.has(c.id));\n  const labels = getMatchingLabelColumns([...direct, ...linked], originalLabelColumns);\n  return { direct, linked, labels };\n}\n\n/** Resolve a ColumnSnapshot to a PColumn with lazily-evaluated data. */\nfunction resolveSnapshot(\n  snap: ColumnSnapshot<PObjectId>,\n): PColumn<undefined | PColumnDataUniversal> {\n  return { id: snap.id, spec: snap.spec, data: snap.data?.get() };\n}\n\n/** Remap column references in sorting entries. */\nfunction remapSortingColumnIds(\n  sorting: Nil | PTableSorting[],\n  columns: TableColumnSnapshot[],\n): Nil | PTableSorting[] {\n  return sorting?.map((s) => {\n    if (s.column.type === \"axis\") return s; // Axis references are unaffected by column ID remapping\n\n    const id = s.column.id;\n    const column =\n      columns.find((c) => (c.originalId ?? c.id) === id) ??\n      throwError(`Column ID \"${id}\" in sorting does not match any discovered column`);\n\n    return {\n      ...s,\n      column: {\n        type: \"column\",\n        id: column.id,\n      },\n    };\n  });\n}\n\ntype PlDataTableFilterNode = FilterSpecNode<PlDataTableFilterSpecLeaf>;\n\n/** Remap column references in a filter tree. */\nfunction remapFilterColumnIds(\n  filters: Nil | PlDataTableFilters,\n  columns: TableColumnSnapshot[],\n): Nil | PlDataTableFilters {\n  if (isNil(filters)) return filters;\n\n  const map = (\n    tableColumnId: CanonicalizedJson<PTableColumnId>,\n  ): CanonicalizedJson<PTableColumnId> => {\n    const parsed = parseJson<PTableColumnId>(tableColumnId);\n    if (parsed.type === \"axis\") return tableColumnId; // Axis references are unaffected by column ID remapping\n\n    const originalId = parsed.id;\n    const column =\n      columns.find((c) => (c.originalId ?? c.id) === originalId) ??\n      throwError(`Column ID \"${parsed.id}\" in filters does not match any discovered column`);\n\n    return canonicalizeJson<PTableColumnId>({\n      type: \"column\",\n      id: column.id,\n    });\n  };\n\n  return traverseFilterSpec(filters, {\n    leaf: (leaf): PlDataTableFilterNode => {\n      if (leaf.type === undefined) return leaf;\n      const result = { ...leaf };\n      if (\"column\" in result) result.column = map(result.column);\n      if (\"rhs\" in result) result.rhs = map(result.rhs);\n      return result;\n    },\n    and: (results): PlDataTableFilterNode => ({ type: \"and\", filters: results }),\n    or: (results): PlDataTableFilterNode => ({ type: \"or\", filters: results }),\n    not: (result): PlDataTableFilterNode => ({ type: \"not\", filter: result }),\n  }) as PlDataTableFilters;\n}\n"],"mappings":"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"}

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

@@ -5,6 +5,7 @@ const require_ctx_column_sources = require("../../../columns/ctx_column_sources.
 require("../../../columns/index.cjs");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
 let _milaboratories_helpers = require("@milaboratories/helpers");
+let es_toolkit = require("es-toolkit");
 //#region src/components/PlDataTable/createPlDataTable/discoverColumns.ts
 /** Discover columns from sources/anchors and normalize into a flat DiscoveredColumn list. */
 function discoverTableColumnSnaphots(ctx, options) {
@@ -14,12 +15,13 @@ function discoverTableColumnSnaphots(ctx, options) {
 	};
 	const providers = resolveProviders(ctx, resolvedOptions.sources);
 	if (providers.length === 0) return void 0;
-	const collection = new require_column_collection_builder.ColumnCollectionBuilder(ctx.services.pframeSpec ?? (0, _milaboratories_helpers.throwError)("PFrameSpec service is required for column discovery.")).addSources(providers).build(resolvedOptions);
+	const collection = new require_column_collection_builder.ColumnCollectionBuilder(ctx.getService("pframeSpec")).addSources(providers).build(resolvedOptions);
 	if (collection === void 0) return void 0;
 	try {
-		const matched = collection.findColumns(resolvedOptions.columnsSelector ?? void 0);
-		const anchors = collection.getAnchors();
-		return mapToDiscoveredColumns(matched, Array.from(Array.from(anchors.values()).map((v) => v.columnId)));
+		return mapToDiscoveredColumns(collection.findColumns({
+			...resolvedOptions.selector ?? {},
+			exclude: [...Array.isArray(resolvedOptions.selector?.exclude) ? resolvedOptions.selector.exclude : !(0, es_toolkit.isNil)(resolvedOptions.selector.exclude) ? [resolvedOptions.selector.exclude] : [], { name: "pl7.app/label" }]
+		}), collection.getAnchors());
 	} finally {
 		collection.dispose();
 	}
@@ -36,26 +38,33 @@ function resolveProviders(ctx, sources) {
 	return sources !== void 0 ? sources.map(require_column_snapshot_provider.toColumnSnapshotProvider) : require_ctx_column_sources.collectCtxColumnSnapshotProviders(ctx);
 }
 /** Map matched columns into a flat DiscoveredColumn list with deduped IDs. */
-function mapToDiscoveredColumns(matched, anchorColumnIds) {
-	const hitCounts = matched.reduce((acc, match) => acc.set(match.originalId, (acc.get(match.originalId) ?? 0) + 1), /* @__PURE__ */ new Map());
-	const hitIndices = /* @__PURE__ */ new Map();
-	return matched.map((match) => {
+function mapToDiscoveredColumns(matched, anchors) {
+	const columnIdToAnchorName = new Map(Array.from(anchors.entries(), ([key, { id }]) => [id, key]));
+	return matched.flatMap((match) => {
 		const snap = match.column;
-		let id = snap.id;
-		if ((hitCounts.get(match.originalId) ?? 0) > 1) {
-			const idx = hitIndices.get(match.originalId) ?? 0;
-			hitIndices.set(match.originalId, idx + 1);
-			id = `${snap.id}#q${idx}`;
-		}
-		return {
-			id,
-			originalId: match.originalId,
-			spec: snap.spec,
-			data: snap.data,
-			dataStatus: snap.dataStatus,
-			isPrimary: anchorColumnIds.some((anchor) => snap.id === anchor || match.originalId === anchor),
-			linkerPath: match.path
-		};
+		const isPrimary = columnIdToAnchorName.get(match.column.id) !== void 0;
+		return match.variants.map((variant) => {
+			return {
+				id: (0, _milaboratories_pl_model_common.createDiscoveredPColumnId)({
+					column: snap.id,
+					path: variant.path.map((p) => ({
+						type: "linker",
+						column: p.linker.id,
+						qualifications: p.qualifications
+					})),
+					columnQualifications: variant.qualifications.forHit,
+					queriesQualifications: variant.qualifications.forQueries
+				}),
+				isPrimary,
+				originalId: snap.id,
+				spec: snap.spec,
+				data: snap.data,
+				dataStatus: snap.dataStatus,
+				linkerPath: variant.path,
+				qualifications: variant.qualifications,
+				distinctiveQualifications: variant.distinctiveQualifications
+			};
+		});
 	});
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"discoverColumns.cjs","names":["ColumnCollectionBuilder","toColumnSnapshotProvider","collectCtxColumnSnapshotProviders"],"sources":["../../../../src/components/PlDataTable/createPlDataTable/discoverColumns.ts"],"sourcesContent":["import type {\n  PColumnSpec,\n  PlRef,\n  PObjectId,\n  RequireServices,\n  Services,\n  SUniversalPColumnId,\n} from \"@milaboratories/pl-model-common\";\nimport { isPlRef } from \"@milaboratories/pl-model-common\";\nimport type { RenderCtxBase } from \"../../../render\";\nimport type { ColumnSource, ColumnMatch, RelaxedColumnSelector } from \"../../../columns\";\nimport { ColumnCollectionBuilder } from \"../../../columns\";\nimport { toColumnSnapshotProvider } from \"../../../columns/column_snapshot_provider\";\nimport { collectCtxColumnSnapshotProviders } from \"../../../columns/ctx_column_sources\";\nimport { throwError } from \"@milaboratories/helpers\";\nimport type { ColumnsSelectorConfig, TableColumnSnapshot } from \"./createPlDataTableV3\";\n\nexport type DiscoveredTableColumnOptions = {\n  sources?: ColumnSource[];\n  anchors: Record<string, PlRef | PObjectId | PColumnSpec | RelaxedColumnSelector>;\n  columnsSelector: ColumnsSelectorConfig;\n};\n\n/** Discover columns from sources/anchors and normalize into a flat DiscoveredColumn list. */\nexport function discoverTableColumnSnaphots<\n  A,\n  U,\n  S extends RequireServices<typeof Services.PFrameSpec>,\n>(\n  ctx: RenderCtxBase<A, U, S>,\n  options: DiscoveredTableColumnOptions,\n): TableColumnSnapshot<SUniversalPColumnId>[] | undefined {\n  // Resolve PlRef anchors to PColumnSpec\n  const resolvedOptions = { ...options, anchors: resolveAnchors(ctx, options.anchors) };\n\n  // Resolve providers\n  const providers = resolveProviders(ctx, resolvedOptions.sources);\n  if (providers.length === 0) return undefined;\n\n  // Build collection (anchored or plain)\n  const pframeSpec =\n    ctx.services.pframeSpec ?? throwError(\"PFrameSpec service is required for column discovery.\");\n  const collection = new ColumnCollectionBuilder(pframeSpec)\n    .addSources(providers)\n    .build(resolvedOptions);\n  if (collection === undefined) return undefined;\n\n  try {\n    const matched = collection.findColumns(resolvedOptions.columnsSelector ?? undefined);\n    const anchors = collection.getAnchors();\n    return mapToDiscoveredColumns(\n      matched,\n      Array.from(Array.from(anchors.values()).map((v) => v.columnId)),\n    );\n  } finally {\n    collection.dispose();\n  }\n}\n\n// --- Pure helper functions ---\n\n/** Resolve PlRef values in anchors to PColumnSpec via the result pool. */\nfunction resolveAnchors<A, U>(\n  ctx: RenderCtxBase<A, U>,\n  anchors: Record<string, PlRef | PObjectId | PColumnSpec | RelaxedColumnSelector>,\n): Record<string, PObjectId | PColumnSpec | RelaxedColumnSelector> {\n  const result: Record<string, PObjectId | PColumnSpec | RelaxedColumnSelector> = {};\n  for (const [key, value] of Object.entries(anchors)) {\n    if (isPlRef(value)) {\n      result[key] =\n        ctx.resultPool.getPColumnSpecByRef(value) ??\n        throwError(\n          `Anchor ${key} with ref ${JSON.stringify(value)} could not be resolved to a PColumnSpec`,\n        );\n    } else {\n      result[key] = value;\n    }\n  }\n  return result;\n}\n\n/** Resolve column snapshot providers from explicit sources or context. */\nfunction resolveProviders<A, U>(ctx: RenderCtxBase<A, U>, sources: undefined | ColumnSource[]) {\n  return sources !== undefined\n    ? sources.map(toColumnSnapshotProvider)\n    : collectCtxColumnSnapshotProviders(ctx);\n}\n\n/** Map matched columns into a flat DiscoveredColumn list with deduped IDs. */\nfunction mapToDiscoveredColumns(\n  matched: readonly ColumnMatch[],\n  anchorColumnIds: readonly PObjectId[],\n): TableColumnSnapshot<SUniversalPColumnId>[] {\n  const hitCounts = matched.reduce(\n    (acc, match) => acc.set(match.originalId, (acc.get(match.originalId) ?? 0) + 1),\n    new Map<PObjectId, number>(),\n  );\n\n  const hitIndices = new Map<PObjectId, number>();\n  return matched.map((match) => {\n    const snap = match.column;\n\n    let id = snap.id;\n    if ((hitCounts.get(match.originalId) ?? 0) > 1) {\n      const idx = hitIndices.get(match.originalId) ?? 0;\n      hitIndices.set(match.originalId, idx + 1);\n      id = `${snap.id}#q${idx}` as SUniversalPColumnId;\n    }\n\n    return {\n      id,\n      originalId: match.originalId,\n      spec: snap.spec,\n      data: snap.data,\n      dataStatus: snap.dataStatus,\n      isPrimary: anchorColumnIds.some(\n        (anchor) => snap.id === anchor || match.originalId === anchor,\n      ),\n      linkerPath: match.path,\n    };\n  });\n}\n"],"mappings":";;;;;;;;;AAwBA,SAAgB,4BAKd,KACA,SACwD;CAExD,MAAM,kBAAkB;EAAE,GAAG;EAAS,SAAS,eAAe,KAAK,QAAQ,QAAQ;EAAE;CAGrF,MAAM,YAAY,iBAAiB,KAAK,gBAAgB,QAAQ;AAChE,KAAI,UAAU,WAAW,EAAG,QAAO,KAAA;CAKnC,MAAM,aAAa,IAAIA,kCAAAA,wBADrB,IAAI,SAAS,eAAA,GAAA,wBAAA,YAAyB,uDAAuD,CACrC,CACvD,WAAW,UAAU,CACrB,MAAM,gBAAgB;AACzB,KAAI,eAAe,KAAA,EAAW,QAAO,KAAA;AAErC,KAAI;EACF,MAAM,UAAU,WAAW,YAAY,gBAAgB,mBAAmB,KAAA,EAAU;EACpF,MAAM,UAAU,WAAW,YAAY;AACvC,SAAO,uBACL,SACA,MAAM,KAAK,MAAM,KAAK,QAAQ,QAAQ,CAAC,CAAC,KAAK,MAAM,EAAE,SAAS,CAAC,CAChE;WACO;AACR,aAAW,SAAS;;;;AAOxB,SAAS,eACP,KACA,SACiE;CACjE,MAAM,SAA0E,EAAE;AAClF,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,CAChD,MAAA,GAAA,gCAAA,SAAY,MAAM,CAChB,QAAO,OACL,IAAI,WAAW,oBAAoB,MAAM,KAAA,GAAA,wBAAA,YAEvC,UAAU,IAAI,YAAY,KAAK,UAAU,MAAM,CAAC,yCACjD;KAEH,QAAO,OAAO;AAGlB,QAAO;;;AAIT,SAAS,iBAAuB,KAA0B,SAAqC;AAC7F,QAAO,YAAY,KAAA,IACf,QAAQ,IAAIC,iCAAAA,yBAAyB,GACrCC,2BAAAA,kCAAkC,IAAI;;;AAI5C,SAAS,uBACP,SACA,iBAC4C;CAC5C,MAAM,YAAY,QAAQ,QACvB,KAAK,UAAU,IAAI,IAAI,MAAM,aAAa,IAAI,IAAI,MAAM,WAAW,IAAI,KAAK,EAAE,kBAC/E,IAAI,KAAwB,CAC7B;CAED,MAAM,6BAAa,IAAI,KAAwB;AAC/C,QAAO,QAAQ,KAAK,UAAU;EAC5B,MAAM,OAAO,MAAM;EAEnB,IAAI,KAAK,KAAK;AACd,OAAK,UAAU,IAAI,MAAM,WAAW,IAAI,KAAK,GAAG;GAC9C,MAAM,MAAM,WAAW,IAAI,MAAM,WAAW,IAAI;AAChD,cAAW,IAAI,MAAM,YAAY,MAAM,EAAE;AACzC,QAAK,GAAG,KAAK,GAAG,IAAI;;AAGtB,SAAO;GACL;GACA,YAAY,MAAM;GAClB,MAAM,KAAK;GACX,MAAM,KAAK;GACX,YAAY,KAAK;GACjB,WAAW,gBAAgB,MACxB,WAAW,KAAK,OAAO,UAAU,MAAM,eAAe,OACxD;GACD,YAAY,MAAM;GACnB;GACD"}
+{"version":3,"file":"discoverColumns.cjs","names":["ColumnCollectionBuilder","toColumnSnapshotProvider","collectCtxColumnSnapshotProviders"],"sources":["../../../../src/components/PlDataTable/createPlDataTable/discoverColumns.ts"],"sourcesContent":["import type { PColumnSpec, PlRef, PObjectId } from \"@milaboratories/pl-model-common\";\nimport { createDiscoveredPColumnId, isPlRef } from \"@milaboratories/pl-model-common\";\nimport type { RenderCtxBase } from \"../../../render\";\nimport type {\n  ColumnSource,\n  ColumnMatch,\n  RelaxedColumnSelector,\n  ColumnSnapshotProvider,\n  ColumnSnapshot,\n} from \"../../../columns\";\nimport { ColumnCollectionBuilder } from \"../../../columns\";\nimport { toColumnSnapshotProvider } from \"../../../columns/column_snapshot_provider\";\nimport { collectCtxColumnSnapshotProviders } from \"../../../columns/ctx_column_sources\";\nimport { throwError } from \"@milaboratories/helpers\";\nimport type { ColumnsSelectorConfig, TableColumnSnapshot } from \"./createPlDataTableV3\";\nimport { isNil } from \"es-toolkit\";\n\nexport type DiscoverTableColumnOptions = {\n  sources?: ColumnSource[];\n  anchors: Record<string, PlRef | PObjectId | PColumnSpec | RelaxedColumnSelector>;\n  selector: ColumnsSelectorConfig;\n};\n\n/** Discover columns from sources/anchors and normalize into a flat DiscoveredColumn list. */\nexport function discoverTableColumnSnaphots(\n  ctx: RenderCtxBase,\n  options: DiscoverTableColumnOptions,\n): TableColumnSnapshot[] | undefined {\n  // Resolve PlRef anchors to PColumnSpec\n  const resolvedOptions = {\n    ...options,\n    anchors: resolveAnchors(ctx, options.anchors),\n  };\n\n  // Resolve providers\n  const providers = resolveProviders(ctx, resolvedOptions.sources);\n  if (providers.length === 0) return undefined;\n\n  // Build collection (anchored or plain)\n  const collection = new ColumnCollectionBuilder(ctx.getService(\"pframeSpec\"))\n    .addSources(providers)\n    .build(resolvedOptions);\n  if (collection === undefined) return undefined;\n\n  try {\n    const columns = collection.findColumns({\n      ...(resolvedOptions.selector ?? {}),\n      exclude: [\n        ...(Array.isArray(resolvedOptions.selector?.exclude)\n          ? resolvedOptions.selector.exclude\n          : !isNil(resolvedOptions.selector.exclude)\n            ? [resolvedOptions.selector.exclude]\n            : []),\n        { name: \"pl7.app/label\" },\n      ],\n    });\n    const anchors = collection.getAnchors();\n    return mapToDiscoveredColumns(columns, anchors);\n  } finally {\n    collection.dispose();\n  }\n}\n\n// --- Pure helper functions ---\n\n/** Resolve PlRef values in anchors to PColumnSpec via the result pool. */\nfunction resolveAnchors(\n  ctx: RenderCtxBase,\n  anchors: Record<string, PlRef | PObjectId | PColumnSpec | RelaxedColumnSelector>,\n): Record<string, PObjectId | PColumnSpec | RelaxedColumnSelector> {\n  const result: Record<string, PObjectId | PColumnSpec | RelaxedColumnSelector> = {};\n  for (const [key, value] of Object.entries(anchors)) {\n    if (isPlRef(value)) {\n      result[key] =\n        ctx.resultPool.getPColumnSpecByRef(value) ??\n        throwError(\n          `Anchor ${key} with ref ${JSON.stringify(value)} could not be resolved to a PColumnSpec`,\n        );\n    } else {\n      result[key] = value;\n    }\n  }\n  return result;\n}\n\n/** Resolve column snapshot providers from explicit sources or context. */\nfunction resolveProviders(\n  ctx: RenderCtxBase,\n  sources: undefined | ColumnSource[],\n): ColumnSnapshotProvider[] {\n  return sources !== undefined\n    ? sources.map(toColumnSnapshotProvider)\n    : collectCtxColumnSnapshotProviders(ctx);\n}\n\n/** Map matched columns into a flat DiscoveredColumn list with deduped IDs. */\nfunction mapToDiscoveredColumns(\n  matched: readonly ColumnMatch[],\n  anchors: Map<string, ColumnSnapshot<PObjectId>>,\n): TableColumnSnapshot[] {\n  const columnIdToAnchorName = new Map<PObjectId, string>(\n    Array.from(anchors.entries(), ([key, { id }]) => [id, key] as const),\n  );\n\n  return matched.flatMap((match) => {\n    const snap = match.column;\n    const isPrimary = columnIdToAnchorName.get(match.column.id) !== undefined;\n\n    return match.variants.map((variant): TableColumnSnapshot => {\n      const discoveredId = createDiscoveredPColumnId({\n        column: snap.id,\n        path: variant.path.map((p) => ({\n          type: \"linker\",\n          column: p.linker.id,\n          qualifications: p.qualifications,\n        })),\n        columnQualifications: variant.qualifications.forHit,\n        queriesQualifications: variant.qualifications.forQueries,\n      });\n      return {\n        id: discoveredId,\n        isPrimary,\n\n        originalId: snap.id,\n        spec: snap.spec,\n        data: snap.data,\n        dataStatus: snap.dataStatus,\n\n        linkerPath: variant.path,\n        qualifications: variant.qualifications,\n        distinctiveQualifications: variant.distinctiveQualifications,\n      };\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;AAwBA,SAAgB,4BACd,KACA,SACmC;CAEnC,MAAM,kBAAkB;EACtB,GAAG;EACH,SAAS,eAAe,KAAK,QAAQ,QAAQ;EAC9C;CAGD,MAAM,YAAY,iBAAiB,KAAK,gBAAgB,QAAQ;AAChE,KAAI,UAAU,WAAW,EAAG,QAAO,KAAA;CAGnC,MAAM,aAAa,IAAIA,kCAAAA,wBAAwB,IAAI,WAAW,aAAa,CAAC,CACzE,WAAW,UAAU,CACrB,MAAM,gBAAgB;AACzB,KAAI,eAAe,KAAA,EAAW,QAAO,KAAA;AAErC,KAAI;AAaF,SAAO,uBAZS,WAAW,YAAY;GACrC,GAAI,gBAAgB,YAAY,EAAE;GAClC,SAAS,CACP,GAAI,MAAM,QAAQ,gBAAgB,UAAU,QAAQ,GAChD,gBAAgB,SAAS,UACzB,EAAA,GAAA,WAAA,OAAO,gBAAgB,SAAS,QAAQ,GACtC,CAAC,gBAAgB,SAAS,QAAQ,GAClC,EAAE,EACR,EAAE,MAAM,iBAAiB,CAC1B;GACF,CAAC,EACc,WAAW,YAAY,CACQ;WACvC;AACR,aAAW,SAAS;;;;AAOxB,SAAS,eACP,KACA,SACiE;CACjE,MAAM,SAA0E,EAAE;AAClF,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,CAChD,MAAA,GAAA,gCAAA,SAAY,MAAM,CAChB,QAAO,OACL,IAAI,WAAW,oBAAoB,MAAM,KAAA,GAAA,wBAAA,YAEvC,UAAU,IAAI,YAAY,KAAK,UAAU,MAAM,CAAC,yCACjD;KAEH,QAAO,OAAO;AAGlB,QAAO;;;AAIT,SAAS,iBACP,KACA,SAC0B;AAC1B,QAAO,YAAY,KAAA,IACf,QAAQ,IAAIC,iCAAAA,yBAAyB,GACrCC,2BAAAA,kCAAkC,IAAI;;;AAI5C,SAAS,uBACP,SACA,SACuB;CACvB,MAAM,uBAAuB,IAAI,IAC/B,MAAM,KAAK,QAAQ,SAAS,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,IAAI,CAAU,CACrE;AAED,QAAO,QAAQ,SAAS,UAAU;EAChC,MAAM,OAAO,MAAM;EACnB,MAAM,YAAY,qBAAqB,IAAI,MAAM,OAAO,GAAG,KAAK,KAAA;AAEhE,SAAO,MAAM,SAAS,KAAK,YAAiC;AAW1D,UAAO;IACL,KAAA,GAAA,gCAAA,2BAX6C;KAC7C,QAAQ,KAAK;KACb,MAAM,QAAQ,KAAK,KAAK,OAAO;MAC7B,MAAM;MACN,QAAQ,EAAE,OAAO;MACjB,gBAAgB,EAAE;MACnB,EAAE;KACH,sBAAsB,QAAQ,eAAe;KAC7C,uBAAuB,QAAQ,eAAe;KAC/C,CAAC;IAGA;IAEA,YAAY,KAAK;IACjB,MAAM,KAAK;IACX,MAAM,KAAK;IACX,YAAY,KAAK;IAEjB,YAAY,QAAQ;IACpB,gBAAgB,QAAQ;IACxB,2BAA2B,QAAQ;IACpC;IACD;GACF"}

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

@@ -2,16 +2,16 @@ import { RenderCtxBase } from "../../../render/api.js";
 import { ColumnSource } from "../../../columns/column_snapshot_provider.js";
 import { RelaxedColumnSelector } from "../../../columns/column_selector.js";
 import { ColumnsSelectorConfig, TableColumnSnapshot } from "./createPlDataTableV3.js";
-import { PColumnSpec, PObjectId, PlRef, RequireServices, SUniversalPColumnId, Services } from "@milaboratories/pl-model-common";
+import { PColumnSpec, PObjectId, PlRef } from "@milaboratories/pl-model-common";
 
 //#region src/components/PlDataTable/createPlDataTable/discoverColumns.d.ts
-type DiscoveredTableColumnOptions = {
+type DiscoverTableColumnOptions = {
   sources?: ColumnSource[];
   anchors: Record<string, PlRef | PObjectId | PColumnSpec | RelaxedColumnSelector>;
-  columnsSelector: ColumnsSelectorConfig;
+  selector: ColumnsSelectorConfig;
 };
 /** Discover columns from sources/anchors and normalize into a flat DiscoveredColumn list. */
-declare function discoverTableColumnSnaphots<A, U, S extends RequireServices<typeof Services.PFrameSpec>>(ctx: RenderCtxBase<A, U, S>, options: DiscoveredTableColumnOptions): TableColumnSnapshot<SUniversalPColumnId>[] | undefined;
+declare function discoverTableColumnSnaphots(ctx: RenderCtxBase, options: DiscoverTableColumnOptions): TableColumnSnapshot[] | undefined;
 //#endregion
-export { DiscoveredTableColumnOptions, discoverTableColumnSnaphots };
+export { DiscoverTableColumnOptions, discoverTableColumnSnaphots };
 //# sourceMappingURL=discoverColumns.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"discoverColumns.d.ts","names":[],"sources":["../../../../src/components/PlDataTable/createPlDataTable/discoverColumns.ts"],"mappings":";;;;;;;KAiBY,4BAAA;EACV,OAAA,GAAU,YAAA;EACV,OAAA,EAAS,MAAA,SAAe,KAAA,GAAQ,SAAA,GAAY,WAAA,GAAc,qBAAA;EAC1D,eAAA,EAAiB,qBAAA;AAAA;AAHnB;AAAA,iBAOgB,2BAAA,iBAGJ,eAAA,QAAuB,QAAA,CAAS,UAAA,EAAA,CAE1C,GAAA,EAAK,aAAA,CAAc,CAAA,EAAG,CAAA,EAAG,CAAA,GACzB,OAAA,EAAS,4BAAA,GACR,mBAAA,CAAoB,mBAAA"}
+{"version":3,"file":"discoverColumns.d.ts","names":[],"sources":["../../../../src/components/PlDataTable/createPlDataTable/discoverColumns.ts"],"mappings":";;;;;;;KAiBY,0BAAA;EACV,OAAA,GAAU,YAAA;EACV,OAAA,EAAS,MAAA,SAAe,KAAA,GAAQ,SAAA,GAAY,WAAA,GAAc,qBAAA;EAC1D,QAAA,EAAU,qBAAA;AAAA;AAHZ;AAAA,iBAOgB,2BAAA,CACd,GAAA,EAAK,aAAA,EACL,OAAA,EAAS,0BAAA,GACR,mBAAA"}