@platforma-sdk/model 1.65.10 → 1.67.0

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

@@ -1,4 +1,8 @@
 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 "../../../columns/index.js";
+import { deriveDistinctTooltips } from "../../../labels/derive_distinct_tooltips.js";
 import { Annotation, canonicalizeAxisId, canonicalizeJson, getAxisId, readAnnotation, readAnnotationJson } from "@milaboratories/pl-model-common";
 import { isNil } from "es-toolkit";
 //#region src/components/PlDataTable/createPlDataTable/utils.ts
@@ -10,20 +14,65 @@ function isColumnHidden(spec) {
 function isColumnOptional(spec) {
 	return readAnnotation(spec, Annotation.Table.Visibility) === "optional";
 }
-/** Get effective visibility for a column, considering display config rules first, then annotations. */
-function getEffectiveVisibility(spec, displayConfig) {
-	if (displayConfig?.visibility) {
-		for (const rule of displayConfig.visibility) if (rule.match(spec)) return rule.visibility;
+/** Get effective visibility for a column. Rule map lookup first, then annotation fallback. */
+function getEffectiveVisibility(col, visibilityByColId) {
+	const rule = visibilityByColId?.get(col.id);
+	if (rule !== void 0) return rule.visibility;
+	if (isColumnHidden(col.spec)) return "hidden";
+	if (isColumnOptional(col.spec)) return "optional";
+}
+/** Get ordering priority for a column. Rule map lookup first, then annotation fallback. */
+function getOrderPriority(col, orderByColId) {
+	const rule = orderByColId?.get(col.id);
+	if (rule !== void 0) return rule.priority;
+	return readAnnotationJson(col.spec, Annotation.Table.OrderPriority);
+}
+/**
+* Evaluate display rules against a set of columns and return a map of `colId → winning rule`
+* (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.
+*/
+function evaluateRules(rules, columns, pframeSpec) {
+	const result = /* @__PURE__ */ new Map();
+	if (rules.length === 0 || columns.length === 0) return result;
+	const hasSelectorRules = rules.some((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();
+		}
+	}
+	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;
 	}
-	if (isColumnHidden(spec)) return "hidden";
-	if (isColumnOptional(spec)) return "optional";
+	return result;
 }
-/** Get ordering priority for a column. Display config rules first, then annotation fallback. */
-function getOrderPriority(spec, displayConfig) {
-	if (displayConfig?.ordering) {
-		for (const rule of displayConfig.ordering) if (rule.match(spec)) return rule.priority;
+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);
 	}
-	return readAnnotationJson(spec, Annotation.Table.OrderPriority);
+	return result;
 }
 /**
 * Writes derived labels into column and axis annotations.
@@ -59,16 +108,16 @@ function withLabelAnnotations(derivedLabels, columns) {
 	});
 }
 /**
-* Writes effective display properties (OrderPriority, Visibility) from ColumnDisplayOptions
+* Writes effective display properties (OrderPriority, Visibility) from precomputed rule maps
 * into column annotations. Returns new column objects — originals are not mutated.
 */
-function withTableVisualAnnotations(displayOptions, columns) {
-	if (displayOptions === void 0) return columns;
+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.spec, displayOptions);
+		const visibility = getEffectiveVisibility(col, visibilityByColId);
 		if (!isNil(visibility)) annotations[Annotation.Table.Visibility] = visibility;
-		const orderPriority = getOrderPriority(col.spec, displayOptions);
+		const orderPriority = getOrderPriority(col, orderByColId);
 		if (!isNil(orderPriority)) annotations[Annotation.Table.OrderPriority] = String(orderPriority);
 		return {
 			...col,
@@ -79,6 +128,42 @@ function withTableVisualAnnotations(displayOptions, columns) {
 		};
 	});
 }
+/**
+* Writes derived info annotations into column annotations.
+* Columns without an info entry are passed through unchanged.
+*/
+function withInfoAnnotations(infoById, columns) {
+	if (isNil(infoById)) return columns;
+	return columns.map((col) => {
+		const info = infoById[col.id];
+		if (isNil(info)) return col;
+		return {
+			...col,
+			spec: {
+				...col.spec,
+				annotations: {
+					...col.spec.annotations,
+					[Annotation.Table.Info]: info
+				}
+			}
+		};
+	});
+}
+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"
+				}
+			}))
+		}
+	}));
+}
 /** Derive labels for all table elements: columns via deriveDistinctLabels, axes from label columns. */
 function deriveAllLabels(options) {
 	const { columns, labelColumns, deriveLabelsOptions } = options;
@@ -96,7 +181,35 @@ function deriveAxisLabels(columns, labelColumns) {
 	for (const axisKey of axisSpecMap.keys()) result[axisKey] = readAnnotation(labelColumns.find((lc) => canonicalizeJson(getAxisId(lc.spec.axesSpec[0])) === axisKey)?.spec ?? axisSpecMap.get(axisKey) ?? {}, Annotation.Label)?.trim() ?? "Unlabeled";
 	return result;
 }
+/** 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(c.originalId, (acc.get(c.originalId) ?? 0) + 1);
+	}, /* @__PURE__ */ new Map());
+	const { entries } = columns.reduce(({ entries, variantSeen }, c) => {
+		const variantCount = variantCountByOriginal.get(c.originalId);
+		const variantIndex = (variantSeen.set(c.originalId, (variantSeen.get(c.originalId) ?? 0) + 1), variantSeen.get(c.originalId));
+		entries.push({
+			spec: c.spec,
+			linkerPath: c.linkerPath,
+			qualifications: c.qualifications,
+			distinctiveQualifications: c.distinctiveQualifications,
+			variantIndex,
+			variantCount
+		});
+		return {
+			entries,
+			variantSeen
+		};
+	}, {
+		entries: [],
+		variantSeen: /* @__PURE__ */ new Map()
+	});
+	const tooltips = deriveDistinctTooltips(entries);
+	return Object.fromEntries(tooltips.flatMap((t, i) => isNil(t) ? [] : [[columns[i].id, t]]));
+}
 //#endregion
-export { deriveAllLabels, getEffectiveVisibility, getOrderPriority, isColumnHidden, isColumnOptional, withLabelAnnotations, withTableVisualAnnotations };
+export { deriveAllLabels, deriveAllTooltips, evaluateRules, getEffectiveVisibility, getOrderPriority, isColumnHidden, isColumnOptional, withHidenAxesAnnotations, withInfoAnnotations, withLabelAnnotations, withTableVisualAnnotations };
 
 //# sourceMappingURL=utils.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../../../../src/components/PlDataTable/createPlDataTable/utils.ts"],"sourcesContent":["import {\n  type PColumn,\n  type PColumnSpec,\n  type PObjectId,\n  Annotation,\n  canonicalizeAxisId,\n  canonicalizeJson,\n  getAxisId,\n  readAnnotation,\n  readAnnotationJson,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  deriveDistinctLabels,\n  type DeriveLabelsOptions,\n} from \"../../../labels/derive_distinct_labels\";\nimport type { ColumnsDisplayOptions } from \"./createPlDataTableV3\";\nimport { isNil } from \"es-toolkit\";\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/** Get effective visibility for a column, considering display config rules first, then annotations. */\nexport function getEffectiveVisibility(\n  spec: PColumnSpec,\n  displayConfig?: ColumnsDisplayOptions,\n): undefined | \"default\" | \"optional\" | \"hidden\" {\n  if (displayConfig?.visibility) {\n    for (const rule of displayConfig.visibility) {\n      if (rule.match(spec)) {\n        return rule.visibility;\n      }\n    }\n  }\n  if (isColumnHidden(spec)) return \"hidden\";\n  if (isColumnOptional(spec)) return \"optional\";\n  return undefined;\n}\n\n/** Get ordering priority for a column. Display config rules first, then annotation fallback. */\nexport function getOrderPriority(\n  spec: PColumnSpec,\n  displayConfig?: ColumnsDisplayOptions,\n): undefined | number {\n  if (displayConfig?.ordering) {\n    for (const rule of displayConfig.ordering) {\n      if (rule.match(spec)) {\n        return rule.priority;\n      }\n    }\n  }\n  return readAnnotationJson(spec, Annotation.Table.OrderPriority);\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<Data>(\n  derivedLabels: undefined | Record<string, string>,\n  columns: PColumn<Data>[],\n): PColumn<Data>[] {\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    };\n  });\n}\n\n/**\n * Writes effective display properties (OrderPriority, Visibility) from ColumnDisplayOptions\n * into column annotations. Returns new column objects — originals are not mutated.\n */\nexport function withTableVisualAnnotations<Data>(\n  displayOptions: undefined | ColumnsDisplayOptions,\n  columns: PColumn<Data>[],\n): PColumn<Data>[] {\n  if (displayOptions === undefined) return columns;\n  return columns.map((col) => {\n    const annotations = { ...col.spec.annotations };\n\n    const visibility = getEffectiveVisibility(col.spec, displayOptions);\n    if (!isNil(visibility)) annotations[Annotation.Table.Visibility] = visibility;\n\n    const orderPriority = getOrderPriority(col.spec, displayOptions);\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    };\n  });\n}\n\n/** Column shape required by label derivation. */\nexport type LabelableColumn = {\n  readonly id: PObjectId;\n  readonly spec: PColumnSpec;\n  readonly linkerPath?: { spec: PColumnSpec }[];\n};\n\n/** Derive labels for all table elements: columns via deriveDistinctLabels, axes from label columns. */\nexport function deriveAllLabels(options: {\n  columns: LabelableColumn[];\n  labelColumns: { readonly spec: PColumnSpec }[];\n  deriveLabelsOptions?: DeriveLabelsOptions;\n}): Record<string, string> {\n  const { columns, labelColumns, deriveLabelsOptions } = options;\n  const axisLabels = deriveAxisLabels(columns, labelColumns);\n  const columnLabels = deriveDistinctLabels(columns, deriveLabelsOptions).reduce(\n    (acc, label, index) => ((acc[columns[index].id] = label), acc),\n    {} as Record<string, string>,\n  );\n  return { ...axisLabels, ...columnLabels };\n}\n\n/** Derive axis labels from matching label columns, falling back to axis spec annotations. */\nfunction deriveAxisLabels(\n  columns: { readonly spec: PColumnSpec }[],\n  labelColumns: { readonly spec: PColumnSpec }[],\n): Record<string, string> {\n  const axisSpecMap = new Map(\n    columns.flatMap((c) => c.spec.axesSpec).map((a) => [canonicalizeJson(getAxisId(a)), a]),\n  );\n  const result: Record<string, string> = {};\n  for (const axisKey of axisSpecMap.keys()) {\n    const labelCol = labelColumns.find(\n      (lc) => canonicalizeJson(getAxisId(lc.spec.axesSpec[0])) === axisKey,\n    );\n    const source = labelCol?.spec ?? axisSpecMap.get(axisKey);\n    result[axisKey] = readAnnotation(source ?? {}, Annotation.Label)?.trim() ?? \"Unlabeled\";\n  }\n  return result;\n}\n"],"mappings":";;;;;AAmBA,SAAgB,eAAe,MAA6C;AAC1E,QAAO,eAAe,MAAM,WAAW,MAAM,WAAW,KAAK;;;AAI/D,SAAgB,iBAAiB,MAA6C;AAC5E,QAAO,eAAe,MAAM,WAAW,MAAM,WAAW,KAAK;;;AAI/D,SAAgB,uBACd,MACA,eAC+C;AAC/C,KAAI,eAAe;OACZ,MAAM,QAAQ,cAAc,WAC/B,KAAI,KAAK,MAAM,KAAK,CAClB,QAAO,KAAK;;AAIlB,KAAI,eAAe,KAAK,CAAE,QAAO;AACjC,KAAI,iBAAiB,KAAK,CAAE,QAAO;;;AAKrC,SAAgB,iBACd,MACA,eACoB;AACpB,KAAI,eAAe;OACZ,MAAM,QAAQ,cAAc,SAC/B,KAAI,KAAK,MAAM,KAAK,CAClB,QAAO,KAAK;;AAIlB,QAAO,mBAAmB,MAAM,WAAW,MAAM,cAAc;;;;;;;;;AAUjE,SAAgB,qBACd,eACA,SACiB;AACjB,KAAI,kBAAkB,KAAA,EAAW,QAAO;AACxC,QAAO,QAAQ,KAAK,QAAQ;EAC1B,MAAM,WAAW,cAAc,IAAI;AACnC,SAAO;GACL,GAAG;GACH,MAAM;IACJ,GAAG,IAAI;IACP,GAAI,MAAM,SAAS,GACf,EAAE,GACF,EAAE,aAAa;KAAE,GAAG,IAAI,KAAK;MAAc,WAAW,QAAQ;KAAU,EAAE;IAC9E,UAAU,IAAI,KAAK,SAAS,KAAK,SAAS;KACxC,MAAM,QAAQ,cAAc,mBAAmB,KAAK;AACpD,YAAO,MAAM,MAAM,GACf,OACA;MAAE,GAAG;MAAM,aAAa;OAAE,GAAG,KAAK;QAAc,WAAW,QAAQ;OAAO;MAAE;MAChF;IACH;GACF;GACD;;;;;;AAOJ,SAAgB,2BACd,gBACA,SACiB;AACjB,KAAI,mBAAmB,KAAA,EAAW,QAAO;AACzC,QAAO,QAAQ,KAAK,QAAQ;EAC1B,MAAM,cAAc,EAAE,GAAG,IAAI,KAAK,aAAa;EAE/C,MAAM,aAAa,uBAAuB,IAAI,MAAM,eAAe;AACnE,MAAI,CAAC,MAAM,WAAW,CAAE,aAAY,WAAW,MAAM,cAAc;EAEnE,MAAM,gBAAgB,iBAAiB,IAAI,MAAM,eAAe;AAChE,MAAI,CAAC,MAAM,cAAc,CAAE,aAAY,WAAW,MAAM,iBAAiB,OAAO,cAAc;AAE9F,SAAO;GACL,GAAG;GACH,MAAM;IACJ,GAAG,IAAI;IACM;IACd;GACF;GACD;;;AAWJ,SAAgB,gBAAgB,SAIL;CACzB,MAAM,EAAE,SAAS,cAAc,wBAAwB;CACvD,MAAM,aAAa,iBAAiB,SAAS,aAAa;CAC1D,MAAM,eAAe,qBAAqB,SAAS,oBAAoB,CAAC,QACrE,KAAK,OAAO,WAAY,IAAI,QAAQ,OAAO,MAAM,OAAQ,MAC1D,EAAE,CACH;AACD,QAAO;EAAE,GAAG;EAAY,GAAG;EAAc;;;AAI3C,SAAS,iBACP,SACA,cACwB;CACxB,MAAM,cAAc,IAAI,IACtB,QAAQ,SAAS,MAAM,EAAE,KAAK,SAAS,CAAC,KAAK,MAAM,CAAC,iBAAiB,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,CACxF;CACD,MAAM,SAAiC,EAAE;AACzC,MAAK,MAAM,WAAW,YAAY,MAAM,CAKtC,QAAO,WAAW,eAJD,aAAa,MAC3B,OAAO,iBAAiB,UAAU,GAAG,KAAK,SAAS,GAAG,CAAC,KAAK,QAC9D,EACwB,QAAQ,YAAY,IAAI,QAAQ,IACd,EAAE,EAAE,WAAW,MAAM,EAAE,MAAM,IAAI;AAE9E,QAAO"}
+{"version":3,"file":"utils.js","names":[],"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  canonicalizeJson,\n  DiscoveredPColumnId,\n  getAxisId,\n  readAnnotation,\n  readAnnotationJson,\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 { 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\";\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  return readAnnotationJson(col.spec, Annotation.Table.OrderPriority);\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 { readonly id: PObjectId; readonly spec: PColumnSpec },\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\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?: { spec: PColumnSpec }[];\n};\n\n/** Derive labels for all table elements: columns via deriveDistinctLabels, axes from label columns. */\nexport function deriveAllLabels(options: {\n  columns: LabelableColumn[];\n  labelColumns: { readonly spec: PColumnSpec }[];\n  deriveLabelsOptions?: DeriveLabelsOptions;\n}): Record<string, string> {\n  const { columns, labelColumns, deriveLabelsOptions } = options;\n  const axisLabels = deriveAxisLabels(columns, labelColumns);\n  const columnLabels = deriveDistinctLabels(columns, deriveLabelsOptions).reduce(\n    (acc, label, index) => ((acc[columns[index].id] = label), acc),\n    {} as Record<string, string>,\n  );\n  return { ...axisLabels, ...columnLabels };\n}\n\n/** Derive axis labels from matching label columns, falling back to axis spec annotations. */\nfunction deriveAxisLabels(\n  columns: { readonly spec: PColumnSpec }[],\n  labelColumns: { readonly spec: PColumnSpec }[],\n): Record<string, string> {\n  const axisSpecMap = new Map(\n    columns.flatMap((c) => c.spec.axesSpec).map((a) => [canonicalizeJson(getAxisId(a)), a]),\n  );\n  const result: Record<string, string> = {};\n  for (const axisKey of axisSpecMap.keys()) {\n    const labelCol = labelColumns.find(\n      (lc) => canonicalizeJson(getAxisId(lc.spec.axesSpec[0])) === axisKey,\n    );\n    const source = labelCol?.spec ?? axisSpecMap.get(axisKey);\n    result[axisKey] = readAnnotation(source ?? {}, Annotation.Label)?.trim() ?? \"Unlabeled\";\n  }\n  return result;\n}\n\n/** Column shape required by tooltip derivation. */\nexport type TooltipableColumn = {\n  readonly id: DiscoveredPColumnId;\n  readonly spec: PColumnSpec;\n  readonly originalId: PObjectId;\n  readonly linkerPath?: MatchVariant[\"path\"];\n  readonly qualifications?: MatchQualifications;\n  readonly distinctiveQualifications?: 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(c.originalId, (acc.get(c.originalId) ?? 0) + 1);\n  }, new Map());\n\n  const { entries } = columns.reduce(\n    ({ entries, variantSeen }, c) => {\n      const variantCount = variantCountByOriginal.get(c.originalId);\n      const variantIndex =\n        (variantSeen.set(c.originalId, (variantSeen.get(c.originalId) ?? 0) + 1),\n        variantSeen.get(c.originalId));\n\n      entries.push({\n        spec: c.spec,\n        linkerPath: c.linkerPath,\n        qualifications: c.qualifications,\n        distinctiveQualifications: c.distinctiveQualifications,\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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"}

package/dist/components/PlDataTable/labels.cjs

@@ -3,14 +3,13 @@ const require_column_collection_builder = require("../../columns/column_collecti
 const require_ctx_column_sources = require("../../columns/ctx_column_sources.cjs");
 require("../../columns/index.cjs");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
-let _milaboratories_helpers = require("@milaboratories/helpers");
 //#region src/components/PlDataTable/labels.ts
 /**
 * Get all label columns visible in the current render context
 * (result pool + block outputs + prerun).
 */
 function getAllLabelColumns(ctx) {
-	const collection = new require_column_collection_builder.ColumnCollectionBuilder(ctx.services.pframeSpec ?? (0, _milaboratories_helpers.throwError)("PFrameSpec service is required for label discovery.")).addSources(require_ctx_column_sources.collectCtxColumnSnapshotProviders(ctx)).build({ allowPartialColumnList: true });
+	const collection = new require_column_collection_builder.ColumnCollectionBuilder(ctx.getService("pframeSpec")).addSources(require_ctx_column_sources.collectCtxColumnSnapshotProviders(ctx)).build({ allowPartialColumnList: true });
 	try {
 		return collection.findColumns({ include: {
 			name: _milaboratories_pl_model_common.PColumnName.Label,

package/dist/components/PlDataTable/labels.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"labels.cjs","names":["ColumnCollectionBuilder","collectCtxColumnSnapshotProviders","PColumnName"],"sources":["../../../src/components/PlDataTable/labels.ts"],"sourcesContent":["import type { AxisId, PColumn, PColumnSpec, PObjectId } from \"@milaboratories/pl-model-common\";\nimport {\n  getAxisId,\n  isLabelColumn,\n  matchAxisId,\n  PColumnName,\n  Services,\n  type RequireServices,\n} from \"@milaboratories/pl-model-common\";\nimport type { PColumnDataUniversal, RenderCtxBase } from \"../../render\";\nimport { ColumnCollectionBuilder, collectCtxColumnSnapshotProviders } from \"../../columns\";\nimport { throwError } from \"@milaboratories/helpers\";\n\n/**\n * Get all label columns visible in the current render context\n * (result pool + block outputs + prerun).\n */\nexport function getAllLabelColumns<A, U, S extends RequireServices<typeof Services.PFrameSpec>>(\n  ctx: RenderCtxBase<A, U, S>,\n): PColumn<PColumnDataUniversal>[] {\n  const pframeSpec =\n    ctx.services.pframeSpec ?? throwError(\"PFrameSpec service is required for label discovery.\");\n  const collection = new ColumnCollectionBuilder(pframeSpec)\n    .addSources(collectCtxColumnSnapshotProviders(ctx))\n    .build({ allowPartialColumnList: true });\n  try {\n    return collection\n      .findColumns({ include: { name: PColumnName.Label, axes: [] } })\n      .reduce<PColumn<PColumnDataUniversal>[]>((acc, hit) => {\n        const data = hit.data?.get();\n        return data === undefined ? acc : [...acc, { id: hit.id, spec: hit.spec, data }];\n      }, []);\n  } finally {\n    collection.dispose();\n  }\n}\n\n/** Get label columns matching the provided columns from the result pool */\nexport function getMatchingLabelColumns(\n  columns: { spec: PColumnSpec }[],\n  allLabelColumns: PColumn<PColumnDataUniversal>[],\n): PColumn<PColumnDataUniversal>[] {\n  // split input columns into label and value columns\n  const inputLabelColumns: typeof columns = [];\n  const inputValueColumns: typeof columns = [];\n  for (const column of columns) {\n    if (isLabelColumn(column.spec)) {\n      inputLabelColumns.push(column);\n    } else {\n      inputValueColumns.push(column);\n    }\n  }\n\n  // collect distinct axes of value columns\n  const unlabeledAxes: AxisId[] = [];\n  for (const column of inputValueColumns) {\n    for (const axis of column.spec.axesSpec) {\n      const axisId = getAxisId(axis);\n      if (!unlabeledAxes.some((id) => matchAxisId(id, axisId))) {\n        unlabeledAxes.push(axisId);\n      }\n    }\n  }\n\n  // remove axes matched by input label columns\n  for (const labelColumn of inputLabelColumns) {\n    const labelAxisId = getAxisId(labelColumn.spec.axesSpec[0]);\n    const labelMatch = unlabeledAxes.findIndex((axisId) => matchAxisId(axisId, labelAxisId));\n    if (labelMatch !== -1) {\n      unlabeledAxes.splice(labelMatch, 1);\n    }\n  }\n\n  // warning: changing this id will break backward compatibility\n  const colId = (\n    id: PObjectId,\n    domain?: Record<string, string>,\n    contextDomain?: Record<string, string>,\n  ): PObjectId => {\n    let wid = id.toString();\n    if (domain) {\n      for (const k in domain) {\n        wid += k;\n        wid += domain[k];\n      }\n    }\n    if (contextDomain) {\n      for (const k in contextDomain) {\n        wid += k;\n        wid += contextDomain[k];\n      }\n    }\n    return wid as PObjectId;\n  };\n\n  // search label columns for unmatched axes\n  const labelColumns: typeof allLabelColumns = [];\n  for (const labelColumn of allLabelColumns) {\n    const labelAxis = labelColumn.spec.axesSpec[0];\n    const labelAxisId = getAxisId(labelAxis);\n    const labelMatch = unlabeledAxes.findIndex((axisId) => matchAxisId(axisId, labelAxisId));\n    if (labelMatch !== -1) {\n      const axisId = unlabeledAxes[labelMatch];\n      const dataDomainLen =\n        Object.keys(axisId.domain ?? {}).length + Object.keys(axisId.contextDomain ?? {}).length;\n      const labelDomainLen =\n        Object.keys(labelAxis.domain ?? {}).length +\n        Object.keys(labelAxis.contextDomain ?? {}).length;\n      if (dataDomainLen > labelDomainLen) {\n        labelColumns.push({\n          id: colId(labelColumn.id, axisId.domain, axisId.contextDomain),\n          spec: {\n            ...labelColumn.spec,\n            axesSpec: [{ ...axisId, annotations: labelAxis.annotations }],\n          },\n          data: labelColumn.data,\n        });\n      } else {\n        labelColumns.push(labelColumn);\n      }\n      unlabeledAxes.splice(labelMatch, 1);\n    }\n  }\n  return labelColumns;\n}\n"],"mappings":";;;;;;;;;;;AAiBA,SAAgB,mBACd,KACiC;CAGjC,MAAM,aAAa,IAAIA,kCAAAA,wBADrB,IAAI,SAAS,eAAA,GAAA,wBAAA,YAAyB,sDAAsD,CACpC,CACvD,WAAWC,2BAAAA,kCAAkC,IAAI,CAAC,CAClD,MAAM,EAAE,wBAAwB,MAAM,CAAC;AAC1C,KAAI;AACF,SAAO,WACJ,YAAY,EAAE,SAAS;GAAE,MAAMC,gCAAAA,YAAY;GAAO,MAAM,EAAE;GAAE,EAAE,CAAC,CAC/D,QAAyC,KAAK,QAAQ;GACrD,MAAM,OAAO,IAAI,MAAM,KAAK;AAC5B,UAAO,SAAS,KAAA,IAAY,MAAM,CAAC,GAAG,KAAK;IAAE,IAAI,IAAI;IAAI,MAAM,IAAI;IAAM;IAAM,CAAC;KAC/E,EAAE,CAAC;WACA;AACR,aAAW,SAAS;;;;AAKxB,SAAgB,wBACd,SACA,iBACiC;CAEjC,MAAM,oBAAoC,EAAE;CAC5C,MAAM,oBAAoC,EAAE;AAC5C,MAAK,MAAM,UAAU,QACnB,MAAA,GAAA,gCAAA,eAAkB,OAAO,KAAK,CAC5B,mBAAkB,KAAK,OAAO;KAE9B,mBAAkB,KAAK,OAAO;CAKlC,MAAM,gBAA0B,EAAE;AAClC,MAAK,MAAM,UAAU,kBACnB,MAAK,MAAM,QAAQ,OAAO,KAAK,UAAU;EACvC,MAAM,UAAA,GAAA,gCAAA,WAAmB,KAAK;AAC9B,MAAI,CAAC,cAAc,MAAM,QAAA,GAAA,gCAAA,aAAmB,IAAI,OAAO,CAAC,CACtD,eAAc,KAAK,OAAO;;AAMhC,MAAK,MAAM,eAAe,mBAAmB;EAC3C,MAAM,eAAA,GAAA,gCAAA,WAAwB,YAAY,KAAK,SAAS,GAAG;EAC3D,MAAM,aAAa,cAAc,WAAW,YAAA,GAAA,gCAAA,aAAuB,QAAQ,YAAY,CAAC;AACxF,MAAI,eAAe,GACjB,eAAc,OAAO,YAAY,EAAE;;CAKvC,MAAM,SACJ,IACA,QACA,kBACc;EACd,IAAI,MAAM,GAAG,UAAU;AACvB,MAAI,OACF,MAAK,MAAM,KAAK,QAAQ;AACtB,UAAO;AACP,UAAO,OAAO;;AAGlB,MAAI,cACF,MAAK,MAAM,KAAK,eAAe;AAC7B,UAAO;AACP,UAAO,cAAc;;AAGzB,SAAO;;CAIT,MAAM,eAAuC,EAAE;AAC/C,MAAK,MAAM,eAAe,iBAAiB;EACzC,MAAM,YAAY,YAAY,KAAK,SAAS;EAC5C,MAAM,eAAA,GAAA,gCAAA,WAAwB,UAAU;EACxC,MAAM,aAAa,cAAc,WAAW,YAAA,GAAA,gCAAA,aAAuB,QAAQ,YAAY,CAAC;AACxF,MAAI,eAAe,IAAI;GACrB,MAAM,SAAS,cAAc;AAM7B,OAJE,OAAO,KAAK,OAAO,UAAU,EAAE,CAAC,CAAC,SAAS,OAAO,KAAK,OAAO,iBAAiB,EAAE,CAAC,CAAC,SAElF,OAAO,KAAK,UAAU,UAAU,EAAE,CAAC,CAAC,SACpC,OAAO,KAAK,UAAU,iBAAiB,EAAE,CAAC,CAAC,OAE3C,cAAa,KAAK;IAChB,IAAI,MAAM,YAAY,IAAI,OAAO,QAAQ,OAAO,cAAc;IAC9D,MAAM;KACJ,GAAG,YAAY;KACf,UAAU,CAAC;MAAE,GAAG;MAAQ,aAAa,UAAU;MAAa,CAAC;KAC9D;IACD,MAAM,YAAY;IACnB,CAAC;OAEF,cAAa,KAAK,YAAY;AAEhC,iBAAc,OAAO,YAAY,EAAE;;;AAGvC,QAAO"}
+{"version":3,"file":"labels.cjs","names":["ColumnCollectionBuilder","collectCtxColumnSnapshotProviders","PColumnName"],"sources":["../../../src/components/PlDataTable/labels.ts"],"sourcesContent":["import type { AxisId, PColumn, PColumnSpec, PObjectId } from \"@milaboratories/pl-model-common\";\nimport {\n  getAxisId,\n  isLabelColumn,\n  matchAxisId,\n  PColumnName,\n} from \"@milaboratories/pl-model-common\";\nimport type { PColumnDataUniversal, RenderCtxBase } from \"../../render\";\nimport { ColumnCollectionBuilder, collectCtxColumnSnapshotProviders } from \"../../columns\";\n\n/**\n * Get all label columns visible in the current render context\n * (result pool + block outputs + prerun).\n */\nexport function getAllLabelColumns<A, U>(\n  ctx: RenderCtxBase<A, U>,\n): PColumn<PColumnDataUniversal>[] {\n  const pframeSpec = ctx.getService(\"pframeSpec\");\n  const collection = new ColumnCollectionBuilder(pframeSpec)\n    .addSources(collectCtxColumnSnapshotProviders(ctx))\n    .build({ allowPartialColumnList: true });\n  try {\n    return collection\n      .findColumns({ include: { name: PColumnName.Label, axes: [] } })\n      .reduce<PColumn<PColumnDataUniversal>[]>((acc, hit) => {\n        const data = hit.data?.get();\n        return data === undefined ? acc : [...acc, { id: hit.id, spec: hit.spec, data }];\n      }, []);\n  } finally {\n    collection.dispose();\n  }\n}\n\n/** Get label columns matching the provided columns from the result pool */\nexport function getMatchingLabelColumns(\n  columns: { spec: PColumnSpec }[],\n  allLabelColumns: PColumn<PColumnDataUniversal>[],\n): PColumn<PColumnDataUniversal>[] {\n  // split input columns into label and value columns\n  const inputLabelColumns: typeof columns = [];\n  const inputValueColumns: typeof columns = [];\n  for (const column of columns) {\n    if (isLabelColumn(column.spec)) {\n      inputLabelColumns.push(column);\n    } else {\n      inputValueColumns.push(column);\n    }\n  }\n\n  // collect distinct axes of value columns\n  const unlabeledAxes: AxisId[] = [];\n  for (const column of inputValueColumns) {\n    for (const axis of column.spec.axesSpec) {\n      const axisId = getAxisId(axis);\n      if (!unlabeledAxes.some((id) => matchAxisId(id, axisId))) {\n        unlabeledAxes.push(axisId);\n      }\n    }\n  }\n\n  // remove axes matched by input label columns\n  for (const labelColumn of inputLabelColumns) {\n    const labelAxisId = getAxisId(labelColumn.spec.axesSpec[0]);\n    const labelMatch = unlabeledAxes.findIndex((axisId) => matchAxisId(axisId, labelAxisId));\n    if (labelMatch !== -1) {\n      unlabeledAxes.splice(labelMatch, 1);\n    }\n  }\n\n  // warning: changing this id will break backward compatibility\n  const colId = (\n    id: PObjectId,\n    domain?: Record<string, string>,\n    contextDomain?: Record<string, string>,\n  ): PObjectId => {\n    let wid = id.toString();\n    if (domain) {\n      for (const k in domain) {\n        wid += k;\n        wid += domain[k];\n      }\n    }\n    if (contextDomain) {\n      for (const k in contextDomain) {\n        wid += k;\n        wid += contextDomain[k];\n      }\n    }\n    return wid as PObjectId;\n  };\n\n  // search label columns for unmatched axes\n  const labelColumns: typeof allLabelColumns = [];\n  for (const labelColumn of allLabelColumns) {\n    const labelAxis = labelColumn.spec.axesSpec[0];\n    const labelAxisId = getAxisId(labelAxis);\n    const labelMatch = unlabeledAxes.findIndex((axisId) => matchAxisId(axisId, labelAxisId));\n    if (labelMatch !== -1) {\n      const axisId = unlabeledAxes[labelMatch];\n      const dataDomainLen =\n        Object.keys(axisId.domain ?? {}).length + Object.keys(axisId.contextDomain ?? {}).length;\n      const labelDomainLen =\n        Object.keys(labelAxis.domain ?? {}).length +\n        Object.keys(labelAxis.contextDomain ?? {}).length;\n      if (dataDomainLen > labelDomainLen) {\n        labelColumns.push({\n          id: colId(labelColumn.id, axisId.domain, axisId.contextDomain),\n          spec: {\n            ...labelColumn.spec,\n            axesSpec: [{ ...axisId, annotations: labelAxis.annotations }],\n          },\n          data: labelColumn.data,\n        });\n      } else {\n        labelColumns.push(labelColumn);\n      }\n      unlabeledAxes.splice(labelMatch, 1);\n    }\n  }\n  return labelColumns;\n}\n"],"mappings":";;;;;;;;;;AAcA,SAAgB,mBACd,KACiC;CAEjC,MAAM,aAAa,IAAIA,kCAAAA,wBADJ,IAAI,WAAW,aAAa,CACW,CACvD,WAAWC,2BAAAA,kCAAkC,IAAI,CAAC,CAClD,MAAM,EAAE,wBAAwB,MAAM,CAAC;AAC1C,KAAI;AACF,SAAO,WACJ,YAAY,EAAE,SAAS;GAAE,MAAMC,gCAAAA,YAAY;GAAO,MAAM,EAAE;GAAE,EAAE,CAAC,CAC/D,QAAyC,KAAK,QAAQ;GACrD,MAAM,OAAO,IAAI,MAAM,KAAK;AAC5B,UAAO,SAAS,KAAA,IAAY,MAAM,CAAC,GAAG,KAAK;IAAE,IAAI,IAAI;IAAI,MAAM,IAAI;IAAM;IAAM,CAAC;KAC/E,EAAE,CAAC;WACA;AACR,aAAW,SAAS;;;;AAKxB,SAAgB,wBACd,SACA,iBACiC;CAEjC,MAAM,oBAAoC,EAAE;CAC5C,MAAM,oBAAoC,EAAE;AAC5C,MAAK,MAAM,UAAU,QACnB,MAAA,GAAA,gCAAA,eAAkB,OAAO,KAAK,CAC5B,mBAAkB,KAAK,OAAO;KAE9B,mBAAkB,KAAK,OAAO;CAKlC,MAAM,gBAA0B,EAAE;AAClC,MAAK,MAAM,UAAU,kBACnB,MAAK,MAAM,QAAQ,OAAO,KAAK,UAAU;EACvC,MAAM,UAAA,GAAA,gCAAA,WAAmB,KAAK;AAC9B,MAAI,CAAC,cAAc,MAAM,QAAA,GAAA,gCAAA,aAAmB,IAAI,OAAO,CAAC,CACtD,eAAc,KAAK,OAAO;;AAMhC,MAAK,MAAM,eAAe,mBAAmB;EAC3C,MAAM,eAAA,GAAA,gCAAA,WAAwB,YAAY,KAAK,SAAS,GAAG;EAC3D,MAAM,aAAa,cAAc,WAAW,YAAA,GAAA,gCAAA,aAAuB,QAAQ,YAAY,CAAC;AACxF,MAAI,eAAe,GACjB,eAAc,OAAO,YAAY,EAAE;;CAKvC,MAAM,SACJ,IACA,QACA,kBACc;EACd,IAAI,MAAM,GAAG,UAAU;AACvB,MAAI,OACF,MAAK,MAAM,KAAK,QAAQ;AACtB,UAAO;AACP,UAAO,OAAO;;AAGlB,MAAI,cACF,MAAK,MAAM,KAAK,eAAe;AAC7B,UAAO;AACP,UAAO,cAAc;;AAGzB,SAAO;;CAIT,MAAM,eAAuC,EAAE;AAC/C,MAAK,MAAM,eAAe,iBAAiB;EACzC,MAAM,YAAY,YAAY,KAAK,SAAS;EAC5C,MAAM,eAAA,GAAA,gCAAA,WAAwB,UAAU;EACxC,MAAM,aAAa,cAAc,WAAW,YAAA,GAAA,gCAAA,aAAuB,QAAQ,YAAY,CAAC;AACxF,MAAI,eAAe,IAAI;GACrB,MAAM,SAAS,cAAc;AAM7B,OAJE,OAAO,KAAK,OAAO,UAAU,EAAE,CAAC,CAAC,SAAS,OAAO,KAAK,OAAO,iBAAiB,EAAE,CAAC,CAAC,SAElF,OAAO,KAAK,UAAU,UAAU,EAAE,CAAC,CAAC,SACpC,OAAO,KAAK,UAAU,iBAAiB,EAAE,CAAC,CAAC,OAE3C,cAAa,KAAK;IAChB,IAAI,MAAM,YAAY,IAAI,OAAO,QAAQ,OAAO,cAAc;IAC9D,MAAM;KACJ,GAAG,YAAY;KACf,UAAU,CAAC;MAAE,GAAG;MAAQ,aAAa,UAAU;MAAa,CAAC;KAC9D;IACD,MAAM,YAAY;IACnB,CAAC;OAEF,cAAa,KAAK,YAAY;AAEhC,iBAAc,OAAO,YAAY,EAAE;;;AAGvC,QAAO"}

package/dist/components/PlDataTable/labels.js

@@ -2,14 +2,13 @@ import { ColumnCollectionBuilder } from "../../columns/column_collection_builder
 import { collectCtxColumnSnapshotProviders } from "../../columns/ctx_column_sources.js";
 import "../../columns/index.js";
 import { PColumnName, getAxisId, isLabelColumn, matchAxisId } from "@milaboratories/pl-model-common";
-import { throwError } from "@milaboratories/helpers";
 //#region src/components/PlDataTable/labels.ts
 /**
 * Get all label columns visible in the current render context
 * (result pool + block outputs + prerun).
 */
 function getAllLabelColumns(ctx) {
-	const collection = new ColumnCollectionBuilder(ctx.services.pframeSpec ?? throwError("PFrameSpec service is required for label discovery.")).addSources(collectCtxColumnSnapshotProviders(ctx)).build({ allowPartialColumnList: true });
+	const collection = new ColumnCollectionBuilder(ctx.getService("pframeSpec")).addSources(collectCtxColumnSnapshotProviders(ctx)).build({ allowPartialColumnList: true });
 	try {
 		return collection.findColumns({ include: {
 			name: PColumnName.Label,

package/dist/components/PlDataTable/labels.js.map

@@ -1 +1 @@
-{"version":3,"file":"labels.js","names":[],"sources":["../../../src/components/PlDataTable/labels.ts"],"sourcesContent":["import type { AxisId, PColumn, PColumnSpec, PObjectId } from \"@milaboratories/pl-model-common\";\nimport {\n  getAxisId,\n  isLabelColumn,\n  matchAxisId,\n  PColumnName,\n  Services,\n  type RequireServices,\n} from \"@milaboratories/pl-model-common\";\nimport type { PColumnDataUniversal, RenderCtxBase } from \"../../render\";\nimport { ColumnCollectionBuilder, collectCtxColumnSnapshotProviders } from \"../../columns\";\nimport { throwError } from \"@milaboratories/helpers\";\n\n/**\n * Get all label columns visible in the current render context\n * (result pool + block outputs + prerun).\n */\nexport function getAllLabelColumns<A, U, S extends RequireServices<typeof Services.PFrameSpec>>(\n  ctx: RenderCtxBase<A, U, S>,\n): PColumn<PColumnDataUniversal>[] {\n  const pframeSpec =\n    ctx.services.pframeSpec ?? throwError(\"PFrameSpec service is required for label discovery.\");\n  const collection = new ColumnCollectionBuilder(pframeSpec)\n    .addSources(collectCtxColumnSnapshotProviders(ctx))\n    .build({ allowPartialColumnList: true });\n  try {\n    return collection\n      .findColumns({ include: { name: PColumnName.Label, axes: [] } })\n      .reduce<PColumn<PColumnDataUniversal>[]>((acc, hit) => {\n        const data = hit.data?.get();\n        return data === undefined ? acc : [...acc, { id: hit.id, spec: hit.spec, data }];\n      }, []);\n  } finally {\n    collection.dispose();\n  }\n}\n\n/** Get label columns matching the provided columns from the result pool */\nexport function getMatchingLabelColumns(\n  columns: { spec: PColumnSpec }[],\n  allLabelColumns: PColumn<PColumnDataUniversal>[],\n): PColumn<PColumnDataUniversal>[] {\n  // split input columns into label and value columns\n  const inputLabelColumns: typeof columns = [];\n  const inputValueColumns: typeof columns = [];\n  for (const column of columns) {\n    if (isLabelColumn(column.spec)) {\n      inputLabelColumns.push(column);\n    } else {\n      inputValueColumns.push(column);\n    }\n  }\n\n  // collect distinct axes of value columns\n  const unlabeledAxes: AxisId[] = [];\n  for (const column of inputValueColumns) {\n    for (const axis of column.spec.axesSpec) {\n      const axisId = getAxisId(axis);\n      if (!unlabeledAxes.some((id) => matchAxisId(id, axisId))) {\n        unlabeledAxes.push(axisId);\n      }\n    }\n  }\n\n  // remove axes matched by input label columns\n  for (const labelColumn of inputLabelColumns) {\n    const labelAxisId = getAxisId(labelColumn.spec.axesSpec[0]);\n    const labelMatch = unlabeledAxes.findIndex((axisId) => matchAxisId(axisId, labelAxisId));\n    if (labelMatch !== -1) {\n      unlabeledAxes.splice(labelMatch, 1);\n    }\n  }\n\n  // warning: changing this id will break backward compatibility\n  const colId = (\n    id: PObjectId,\n    domain?: Record<string, string>,\n    contextDomain?: Record<string, string>,\n  ): PObjectId => {\n    let wid = id.toString();\n    if (domain) {\n      for (const k in domain) {\n        wid += k;\n        wid += domain[k];\n      }\n    }\n    if (contextDomain) {\n      for (const k in contextDomain) {\n        wid += k;\n        wid += contextDomain[k];\n      }\n    }\n    return wid as PObjectId;\n  };\n\n  // search label columns for unmatched axes\n  const labelColumns: typeof allLabelColumns = [];\n  for (const labelColumn of allLabelColumns) {\n    const labelAxis = labelColumn.spec.axesSpec[0];\n    const labelAxisId = getAxisId(labelAxis);\n    const labelMatch = unlabeledAxes.findIndex((axisId) => matchAxisId(axisId, labelAxisId));\n    if (labelMatch !== -1) {\n      const axisId = unlabeledAxes[labelMatch];\n      const dataDomainLen =\n        Object.keys(axisId.domain ?? {}).length + Object.keys(axisId.contextDomain ?? {}).length;\n      const labelDomainLen =\n        Object.keys(labelAxis.domain ?? {}).length +\n        Object.keys(labelAxis.contextDomain ?? {}).length;\n      if (dataDomainLen > labelDomainLen) {\n        labelColumns.push({\n          id: colId(labelColumn.id, axisId.domain, axisId.contextDomain),\n          spec: {\n            ...labelColumn.spec,\n            axesSpec: [{ ...axisId, annotations: labelAxis.annotations }],\n          },\n          data: labelColumn.data,\n        });\n      } else {\n        labelColumns.push(labelColumn);\n      }\n      unlabeledAxes.splice(labelMatch, 1);\n    }\n  }\n  return labelColumns;\n}\n"],"mappings":";;;;;;;;;;AAiBA,SAAgB,mBACd,KACiC;CAGjC,MAAM,aAAa,IAAI,wBADrB,IAAI,SAAS,cAAc,WAAW,sDAAsD,CACpC,CACvD,WAAW,kCAAkC,IAAI,CAAC,CAClD,MAAM,EAAE,wBAAwB,MAAM,CAAC;AAC1C,KAAI;AACF,SAAO,WACJ,YAAY,EAAE,SAAS;GAAE,MAAM,YAAY;GAAO,MAAM,EAAE;GAAE,EAAE,CAAC,CAC/D,QAAyC,KAAK,QAAQ;GACrD,MAAM,OAAO,IAAI,MAAM,KAAK;AAC5B,UAAO,SAAS,KAAA,IAAY,MAAM,CAAC,GAAG,KAAK;IAAE,IAAI,IAAI;IAAI,MAAM,IAAI;IAAM;IAAM,CAAC;KAC/E,EAAE,CAAC;WACA;AACR,aAAW,SAAS;;;;AAKxB,SAAgB,wBACd,SACA,iBACiC;CAEjC,MAAM,oBAAoC,EAAE;CAC5C,MAAM,oBAAoC,EAAE;AAC5C,MAAK,MAAM,UAAU,QACnB,KAAI,cAAc,OAAO,KAAK,CAC5B,mBAAkB,KAAK,OAAO;KAE9B,mBAAkB,KAAK,OAAO;CAKlC,MAAM,gBAA0B,EAAE;AAClC,MAAK,MAAM,UAAU,kBACnB,MAAK,MAAM,QAAQ,OAAO,KAAK,UAAU;EACvC,MAAM,SAAS,UAAU,KAAK;AAC9B,MAAI,CAAC,cAAc,MAAM,OAAO,YAAY,IAAI,OAAO,CAAC,CACtD,eAAc,KAAK,OAAO;;AAMhC,MAAK,MAAM,eAAe,mBAAmB;EAC3C,MAAM,cAAc,UAAU,YAAY,KAAK,SAAS,GAAG;EAC3D,MAAM,aAAa,cAAc,WAAW,WAAW,YAAY,QAAQ,YAAY,CAAC;AACxF,MAAI,eAAe,GACjB,eAAc,OAAO,YAAY,EAAE;;CAKvC,MAAM,SACJ,IACA,QACA,kBACc;EACd,IAAI,MAAM,GAAG,UAAU;AACvB,MAAI,OACF,MAAK,MAAM,KAAK,QAAQ;AACtB,UAAO;AACP,UAAO,OAAO;;AAGlB,MAAI,cACF,MAAK,MAAM,KAAK,eAAe;AAC7B,UAAO;AACP,UAAO,cAAc;;AAGzB,SAAO;;CAIT,MAAM,eAAuC,EAAE;AAC/C,MAAK,MAAM,eAAe,iBAAiB;EACzC,MAAM,YAAY,YAAY,KAAK,SAAS;EAC5C,MAAM,cAAc,UAAU,UAAU;EACxC,MAAM,aAAa,cAAc,WAAW,WAAW,YAAY,QAAQ,YAAY,CAAC;AACxF,MAAI,eAAe,IAAI;GACrB,MAAM,SAAS,cAAc;AAM7B,OAJE,OAAO,KAAK,OAAO,UAAU,EAAE,CAAC,CAAC,SAAS,OAAO,KAAK,OAAO,iBAAiB,EAAE,CAAC,CAAC,SAElF,OAAO,KAAK,UAAU,UAAU,EAAE,CAAC,CAAC,SACpC,OAAO,KAAK,UAAU,iBAAiB,EAAE,CAAC,CAAC,OAE3C,cAAa,KAAK;IAChB,IAAI,MAAM,YAAY,IAAI,OAAO,QAAQ,OAAO,cAAc;IAC9D,MAAM;KACJ,GAAG,YAAY;KACf,UAAU,CAAC;MAAE,GAAG;MAAQ,aAAa,UAAU;MAAa,CAAC;KAC9D;IACD,MAAM,YAAY;IACnB,CAAC;OAEF,cAAa,KAAK,YAAY;AAEhC,iBAAc,OAAO,YAAY,EAAE;;;AAGvC,QAAO"}
+{"version":3,"file":"labels.js","names":[],"sources":["../../../src/components/PlDataTable/labels.ts"],"sourcesContent":["import type { AxisId, PColumn, PColumnSpec, PObjectId } from \"@milaboratories/pl-model-common\";\nimport {\n  getAxisId,\n  isLabelColumn,\n  matchAxisId,\n  PColumnName,\n} from \"@milaboratories/pl-model-common\";\nimport type { PColumnDataUniversal, RenderCtxBase } from \"../../render\";\nimport { ColumnCollectionBuilder, collectCtxColumnSnapshotProviders } from \"../../columns\";\n\n/**\n * Get all label columns visible in the current render context\n * (result pool + block outputs + prerun).\n */\nexport function getAllLabelColumns<A, U>(\n  ctx: RenderCtxBase<A, U>,\n): PColumn<PColumnDataUniversal>[] {\n  const pframeSpec = ctx.getService(\"pframeSpec\");\n  const collection = new ColumnCollectionBuilder(pframeSpec)\n    .addSources(collectCtxColumnSnapshotProviders(ctx))\n    .build({ allowPartialColumnList: true });\n  try {\n    return collection\n      .findColumns({ include: { name: PColumnName.Label, axes: [] } })\n      .reduce<PColumn<PColumnDataUniversal>[]>((acc, hit) => {\n        const data = hit.data?.get();\n        return data === undefined ? acc : [...acc, { id: hit.id, spec: hit.spec, data }];\n      }, []);\n  } finally {\n    collection.dispose();\n  }\n}\n\n/** Get label columns matching the provided columns from the result pool */\nexport function getMatchingLabelColumns(\n  columns: { spec: PColumnSpec }[],\n  allLabelColumns: PColumn<PColumnDataUniversal>[],\n): PColumn<PColumnDataUniversal>[] {\n  // split input columns into label and value columns\n  const inputLabelColumns: typeof columns = [];\n  const inputValueColumns: typeof columns = [];\n  for (const column of columns) {\n    if (isLabelColumn(column.spec)) {\n      inputLabelColumns.push(column);\n    } else {\n      inputValueColumns.push(column);\n    }\n  }\n\n  // collect distinct axes of value columns\n  const unlabeledAxes: AxisId[] = [];\n  for (const column of inputValueColumns) {\n    for (const axis of column.spec.axesSpec) {\n      const axisId = getAxisId(axis);\n      if (!unlabeledAxes.some((id) => matchAxisId(id, axisId))) {\n        unlabeledAxes.push(axisId);\n      }\n    }\n  }\n\n  // remove axes matched by input label columns\n  for (const labelColumn of inputLabelColumns) {\n    const labelAxisId = getAxisId(labelColumn.spec.axesSpec[0]);\n    const labelMatch = unlabeledAxes.findIndex((axisId) => matchAxisId(axisId, labelAxisId));\n    if (labelMatch !== -1) {\n      unlabeledAxes.splice(labelMatch, 1);\n    }\n  }\n\n  // warning: changing this id will break backward compatibility\n  const colId = (\n    id: PObjectId,\n    domain?: Record<string, string>,\n    contextDomain?: Record<string, string>,\n  ): PObjectId => {\n    let wid = id.toString();\n    if (domain) {\n      for (const k in domain) {\n        wid += k;\n        wid += domain[k];\n      }\n    }\n    if (contextDomain) {\n      for (const k in contextDomain) {\n        wid += k;\n        wid += contextDomain[k];\n      }\n    }\n    return wid as PObjectId;\n  };\n\n  // search label columns for unmatched axes\n  const labelColumns: typeof allLabelColumns = [];\n  for (const labelColumn of allLabelColumns) {\n    const labelAxis = labelColumn.spec.axesSpec[0];\n    const labelAxisId = getAxisId(labelAxis);\n    const labelMatch = unlabeledAxes.findIndex((axisId) => matchAxisId(axisId, labelAxisId));\n    if (labelMatch !== -1) {\n      const axisId = unlabeledAxes[labelMatch];\n      const dataDomainLen =\n        Object.keys(axisId.domain ?? {}).length + Object.keys(axisId.contextDomain ?? {}).length;\n      const labelDomainLen =\n        Object.keys(labelAxis.domain ?? {}).length +\n        Object.keys(labelAxis.contextDomain ?? {}).length;\n      if (dataDomainLen > labelDomainLen) {\n        labelColumns.push({\n          id: colId(labelColumn.id, axisId.domain, axisId.contextDomain),\n          spec: {\n            ...labelColumn.spec,\n            axesSpec: [{ ...axisId, annotations: labelAxis.annotations }],\n          },\n          data: labelColumn.data,\n        });\n      } else {\n        labelColumns.push(labelColumn);\n      }\n      unlabeledAxes.splice(labelMatch, 1);\n    }\n  }\n  return labelColumns;\n}\n"],"mappings":";;;;;;;;;AAcA,SAAgB,mBACd,KACiC;CAEjC,MAAM,aAAa,IAAI,wBADJ,IAAI,WAAW,aAAa,CACW,CACvD,WAAW,kCAAkC,IAAI,CAAC,CAClD,MAAM,EAAE,wBAAwB,MAAM,CAAC;AAC1C,KAAI;AACF,SAAO,WACJ,YAAY,EAAE,SAAS;GAAE,MAAM,YAAY;GAAO,MAAM,EAAE;GAAE,EAAE,CAAC,CAC/D,QAAyC,KAAK,QAAQ;GACrD,MAAM,OAAO,IAAI,MAAM,KAAK;AAC5B,UAAO,SAAS,KAAA,IAAY,MAAM,CAAC,GAAG,KAAK;IAAE,IAAI,IAAI;IAAI,MAAM,IAAI;IAAM;IAAM,CAAC;KAC/E,EAAE,CAAC;WACA;AACR,aAAW,SAAS;;;;AAKxB,SAAgB,wBACd,SACA,iBACiC;CAEjC,MAAM,oBAAoC,EAAE;CAC5C,MAAM,oBAAoC,EAAE;AAC5C,MAAK,MAAM,UAAU,QACnB,KAAI,cAAc,OAAO,KAAK,CAC5B,mBAAkB,KAAK,OAAO;KAE9B,mBAAkB,KAAK,OAAO;CAKlC,MAAM,gBAA0B,EAAE;AAClC,MAAK,MAAM,UAAU,kBACnB,MAAK,MAAM,QAAQ,OAAO,KAAK,UAAU;EACvC,MAAM,SAAS,UAAU,KAAK;AAC9B,MAAI,CAAC,cAAc,MAAM,OAAO,YAAY,IAAI,OAAO,CAAC,CACtD,eAAc,KAAK,OAAO;;AAMhC,MAAK,MAAM,eAAe,mBAAmB;EAC3C,MAAM,cAAc,UAAU,YAAY,KAAK,SAAS,GAAG;EAC3D,MAAM,aAAa,cAAc,WAAW,WAAW,YAAY,QAAQ,YAAY,CAAC;AACxF,MAAI,eAAe,GACjB,eAAc,OAAO,YAAY,EAAE;;CAKvC,MAAM,SACJ,IACA,QACA,kBACc;EACd,IAAI,MAAM,GAAG,UAAU;AACvB,MAAI,OACF,MAAK,MAAM,KAAK,QAAQ;AACtB,UAAO;AACP,UAAO,OAAO;;AAGlB,MAAI,cACF,MAAK,MAAM,KAAK,eAAe;AAC7B,UAAO;AACP,UAAO,cAAc;;AAGzB,SAAO;;CAIT,MAAM,eAAuC,EAAE;AAC/C,MAAK,MAAM,eAAe,iBAAiB;EACzC,MAAM,YAAY,YAAY,KAAK,SAAS;EAC5C,MAAM,cAAc,UAAU,UAAU;EACxC,MAAM,aAAa,cAAc,WAAW,WAAW,YAAY,QAAQ,YAAY,CAAC;AACxF,MAAI,eAAe,IAAI;GACrB,MAAM,SAAS,cAAc;AAM7B,OAJE,OAAO,KAAK,OAAO,UAAU,EAAE,CAAC,CAAC,SAAS,OAAO,KAAK,OAAO,iBAAiB,EAAE,CAAC,CAAC,SAElF,OAAO,KAAK,UAAU,UAAU,EAAE,CAAC,CAAC,SACpC,OAAO,KAAK,UAAU,iBAAiB,EAAE,CAAC,CAAC,OAE3C,cAAa,KAAK;IAChB,IAAI,MAAM,YAAY,IAAI,OAAO,QAAQ,OAAO,cAAc;IAC9D,MAAM;KACJ,GAAG,YAAY;KACf,UAAU,CAAC;MAAE,GAAG;MAAQ,aAAa,UAAU;MAAa,CAAC;KAC9D;IACD,MAAM,YAAY;IACnB,CAAC;OAEF,cAAa,KAAK,YAAY;AAEhC,iBAAc,OAAO,YAAY,EAAE;;;AAGvC,QAAO"}

package/dist/components/PlDatasetSelector/build_dataset_options.cjs

@@ -0,0 +1,41 @@
+const require_filter_discovery = require("./filter_discovery.cjs");
+const require_column_collection_builder = require("../../columns/column_collection_builder.cjs");
+const require_ctx_column_sources = require("../../columns/ctx_column_sources.cjs");
+//#region src/components/PlDatasetSelector/build_dataset_options.ts
+/**
+* Usage:
+* ```ts
+* .output("datasetOptions", (ctx) => buildDatasetOptions(ctx))
+* ```
+*/
+function buildDatasetOptions(ctx, opts) {
+	const predicate = opts?.selector ?? (() => true);
+	const options = ctx.resultPool.getOptions(predicate, { refsWithEnrichments: true });
+	if (options.length === 0) return [];
+	const columnSources = require_ctx_column_sources.collectCtxColumnSnapshotProviders(ctx);
+	const refMap = require_filter_discovery.buildRefMap(ctx.resultPool.getSpecs().entries);
+	const pframeSpec = ctx.getService("pframeSpec");
+	return options.map((o) => {
+		const datasetSpec = ctx.resultPool.getPColumnSpecByRef(o.ref);
+		if (!datasetSpec) return o;
+		const builder = new require_column_collection_builder.ColumnCollectionBuilder(pframeSpec);
+		for (const src of columnSources) builder.addSource(src);
+		const collection = builder.build({ anchors: { main: datasetSpec } });
+		if (!collection) return o;
+		try {
+			const matches = require_filter_discovery.findFilterColumns(collection);
+			if (matches.length === 0) return o;
+			const filters = require_filter_discovery.filterMatchesToOptions(matches, refMap, opts?.labelOptions);
+			return {
+				...o,
+				filters
+			};
+		} finally {
+			collection.dispose();
+		}
+	});
+}
+//#endregion
+exports.buildDatasetOptions = buildDatasetOptions;
+
+//# sourceMappingURL=build_dataset_options.cjs.map

package/dist/components/PlDatasetSelector/build_dataset_options.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build_dataset_options.cjs","names":["collectCtxColumnSnapshotProviders","buildRefMap","ColumnCollectionBuilder","findFilterColumns","filterMatchesToOptions"],"sources":["../../../src/components/PlDatasetSelector/build_dataset_options.ts"],"sourcesContent":["import type {\n  DatasetOption,\n  Option,\n  PColumnSelector,\n  PObjectSpec,\n} from \"@milaboratories/pl-model-common\";\nimport type { DeriveLabelsOptions } from \"../../labels/derive_distinct_labels\";\nimport type { RenderCtxBase } from \"../../render\";\nimport { ColumnCollectionBuilder } from \"../../columns/column_collection_builder\";\nimport { collectCtxColumnSnapshotProviders } from \"../../columns/ctx_column_sources\";\nimport { buildRefMap, filterMatchesToOptions, findFilterColumns } from \"./filter_discovery\";\n\nexport type BuildDatasetOptions = {\n  /** Which result pool columns qualify as datasets. Defaults to all. */\n  selector?: PColumnSelector | PColumnSelector[] | ((spec: PObjectSpec) => boolean);\n  /** Formatting options for filter labels. */\n  labelOptions?: DeriveLabelsOptions;\n};\n\n/**\n * Usage:\n * ```ts\n * .output(\"datasetOptions\", (ctx) => buildDatasetOptions(ctx))\n * ```\n */\nexport function buildDatasetOptions(\n  ctx: RenderCtxBase,\n  opts?: BuildDatasetOptions,\n): DatasetOption[] | undefined {\n  const predicate = opts?.selector ?? (() => true);\n  const options = ctx.resultPool.getOptions(predicate, { refsWithEnrichments: true });\n  if (options.length === 0) return [];\n\n  const columnSources = collectCtxColumnSnapshotProviders(ctx);\n  const refMap = buildRefMap(ctx.resultPool.getSpecs().entries);\n  const pframeSpec = ctx.getService(\"pframeSpec\");\n\n  return options.map((o: Option): DatasetOption => {\n    const datasetSpec = ctx.resultPool.getPColumnSpecByRef(o.ref);\n    if (!datasetSpec) return o;\n\n    const builder = new ColumnCollectionBuilder(pframeSpec);\n    for (const src of columnSources) builder.addSource(src);\n    const collection = builder.build({ anchors: { main: datasetSpec } });\n    if (!collection) return o;\n\n    try {\n      const matches = findFilterColumns(collection);\n      if (matches.length === 0) return o;\n      const filters = filterMatchesToOptions(matches, refMap, opts?.labelOptions);\n      return { ...o, filters };\n    } finally {\n      collection.dispose();\n    }\n  });\n}\n"],"mappings":";;;;;;;;;;AAyBA,SAAgB,oBACd,KACA,MAC6B;CAC7B,MAAM,YAAY,MAAM,mBAAmB;CAC3C,MAAM,UAAU,IAAI,WAAW,WAAW,WAAW,EAAE,qBAAqB,MAAM,CAAC;AACnF,KAAI,QAAQ,WAAW,EAAG,QAAO,EAAE;CAEnC,MAAM,gBAAgBA,2BAAAA,kCAAkC,IAAI;CAC5D,MAAM,SAASC,yBAAAA,YAAY,IAAI,WAAW,UAAU,CAAC,QAAQ;CAC7D,MAAM,aAAa,IAAI,WAAW,aAAa;AAE/C,QAAO,QAAQ,KAAK,MAA6B;EAC/C,MAAM,cAAc,IAAI,WAAW,oBAAoB,EAAE,IAAI;AAC7D,MAAI,CAAC,YAAa,QAAO;EAEzB,MAAM,UAAU,IAAIC,kCAAAA,wBAAwB,WAAW;AACvD,OAAK,MAAM,OAAO,cAAe,SAAQ,UAAU,IAAI;EACvD,MAAM,aAAa,QAAQ,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,EAAE,CAAC;AACpE,MAAI,CAAC,WAAY,QAAO;AAExB,MAAI;GACF,MAAM,UAAUC,yBAAAA,kBAAkB,WAAW;AAC7C,OAAI,QAAQ,WAAW,EAAG,QAAO;GACjC,MAAM,UAAUC,yBAAAA,uBAAuB,SAAS,QAAQ,MAAM,aAAa;AAC3E,UAAO;IAAE,GAAG;IAAG;IAAS;YAChB;AACR,cAAW,SAAS;;GAEtB"}

package/dist/components/PlDatasetSelector/build_dataset_options.d.ts

@@ -0,0 +1,19 @@
+import { DeriveLabelsOptions } from "../../labels/derive_distinct_labels.js";
+import { RenderCtxBase } from "../../render/api.js";
+import { DatasetOption, PColumnSelector, PObjectSpec } from "@milaboratories/pl-model-common";
+
+//#region src/components/PlDatasetSelector/build_dataset_options.d.ts
+type BuildDatasetOptions = {
+  /** Which result pool columns qualify as datasets. Defaults to all. */selector?: PColumnSelector | PColumnSelector[] | ((spec: PObjectSpec) => boolean); /** Formatting options for filter labels. */
+  labelOptions?: DeriveLabelsOptions;
+};
+/**
+ * Usage:
+ * ```ts
+ * .output("datasetOptions", (ctx) => buildDatasetOptions(ctx))
+ * ```
+ */
+declare function buildDatasetOptions(ctx: RenderCtxBase, opts?: BuildDatasetOptions): DatasetOption[] | undefined;
+//#endregion
+export { BuildDatasetOptions, buildDatasetOptions };
+//# sourceMappingURL=build_dataset_options.d.ts.map

package/dist/components/PlDatasetSelector/build_dataset_options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build_dataset_options.d.ts","names":[],"sources":["../../../src/components/PlDatasetSelector/build_dataset_options.ts"],"mappings":";;;;;KAYY,mBAAA;wEAEV,QAAA,GAAW,eAAA,GAAkB,eAAA,OAAsB,IAAA,EAAM,WAAA,eAF/C;EAIV,YAAA,GAAe,mBAAA;AAAA;;;;;;;iBASD,mBAAA,CACd,GAAA,EAAK,aAAA,EACL,IAAA,GAAO,mBAAA,GACN,aAAA"}

package/dist/components/PlDatasetSelector/build_dataset_options.js

@@ -0,0 +1,41 @@
+import { buildRefMap, filterMatchesToOptions, findFilterColumns } from "./filter_discovery.js";
+import { ColumnCollectionBuilder } from "../../columns/column_collection_builder.js";
+import { collectCtxColumnSnapshotProviders } from "../../columns/ctx_column_sources.js";
+//#region src/components/PlDatasetSelector/build_dataset_options.ts
+/**
+* Usage:
+* ```ts
+* .output("datasetOptions", (ctx) => buildDatasetOptions(ctx))
+* ```
+*/
+function buildDatasetOptions(ctx, opts) {
+	const predicate = opts?.selector ?? (() => true);
+	const options = ctx.resultPool.getOptions(predicate, { refsWithEnrichments: true });
+	if (options.length === 0) return [];
+	const columnSources = collectCtxColumnSnapshotProviders(ctx);
+	const refMap = buildRefMap(ctx.resultPool.getSpecs().entries);
+	const pframeSpec = ctx.getService("pframeSpec");
+	return options.map((o) => {
+		const datasetSpec = ctx.resultPool.getPColumnSpecByRef(o.ref);
+		if (!datasetSpec) return o;
+		const builder = new ColumnCollectionBuilder(pframeSpec);
+		for (const src of columnSources) builder.addSource(src);
+		const collection = builder.build({ anchors: { main: datasetSpec } });
+		if (!collection) return o;
+		try {
+			const matches = findFilterColumns(collection);
+			if (matches.length === 0) return o;
+			const filters = filterMatchesToOptions(matches, refMap, opts?.labelOptions);
+			return {
+				...o,
+				filters
+			};
+		} finally {
+			collection.dispose();
+		}
+	});
+}
+//#endregion
+export { buildDatasetOptions };
+
+//# sourceMappingURL=build_dataset_options.js.map

package/dist/components/PlDatasetSelector/build_dataset_options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build_dataset_options.js","names":[],"sources":["../../../src/components/PlDatasetSelector/build_dataset_options.ts"],"sourcesContent":["import type {\n  DatasetOption,\n  Option,\n  PColumnSelector,\n  PObjectSpec,\n} from \"@milaboratories/pl-model-common\";\nimport type { DeriveLabelsOptions } from \"../../labels/derive_distinct_labels\";\nimport type { RenderCtxBase } from \"../../render\";\nimport { ColumnCollectionBuilder } from \"../../columns/column_collection_builder\";\nimport { collectCtxColumnSnapshotProviders } from \"../../columns/ctx_column_sources\";\nimport { buildRefMap, filterMatchesToOptions, findFilterColumns } from \"./filter_discovery\";\n\nexport type BuildDatasetOptions = {\n  /** Which result pool columns qualify as datasets. Defaults to all. */\n  selector?: PColumnSelector | PColumnSelector[] | ((spec: PObjectSpec) => boolean);\n  /** Formatting options for filter labels. */\n  labelOptions?: DeriveLabelsOptions;\n};\n\n/**\n * Usage:\n * ```ts\n * .output(\"datasetOptions\", (ctx) => buildDatasetOptions(ctx))\n * ```\n */\nexport function buildDatasetOptions(\n  ctx: RenderCtxBase,\n  opts?: BuildDatasetOptions,\n): DatasetOption[] | undefined {\n  const predicate = opts?.selector ?? (() => true);\n  const options = ctx.resultPool.getOptions(predicate, { refsWithEnrichments: true });\n  if (options.length === 0) return [];\n\n  const columnSources = collectCtxColumnSnapshotProviders(ctx);\n  const refMap = buildRefMap(ctx.resultPool.getSpecs().entries);\n  const pframeSpec = ctx.getService(\"pframeSpec\");\n\n  return options.map((o: Option): DatasetOption => {\n    const datasetSpec = ctx.resultPool.getPColumnSpecByRef(o.ref);\n    if (!datasetSpec) return o;\n\n    const builder = new ColumnCollectionBuilder(pframeSpec);\n    for (const src of columnSources) builder.addSource(src);\n    const collection = builder.build({ anchors: { main: datasetSpec } });\n    if (!collection) return o;\n\n    try {\n      const matches = findFilterColumns(collection);\n      if (matches.length === 0) return o;\n      const filters = filterMatchesToOptions(matches, refMap, opts?.labelOptions);\n      return { ...o, filters };\n    } finally {\n      collection.dispose();\n    }\n  });\n}\n"],"mappings":";;;;;;;;;;AAyBA,SAAgB,oBACd,KACA,MAC6B;CAC7B,MAAM,YAAY,MAAM,mBAAmB;CAC3C,MAAM,UAAU,IAAI,WAAW,WAAW,WAAW,EAAE,qBAAqB,MAAM,CAAC;AACnF,KAAI,QAAQ,WAAW,EAAG,QAAO,EAAE;CAEnC,MAAM,gBAAgB,kCAAkC,IAAI;CAC5D,MAAM,SAAS,YAAY,IAAI,WAAW,UAAU,CAAC,QAAQ;CAC7D,MAAM,aAAa,IAAI,WAAW,aAAa;AAE/C,QAAO,QAAQ,KAAK,MAA6B;EAC/C,MAAM,cAAc,IAAI,WAAW,oBAAoB,EAAE,IAAI;AAC7D,MAAI,CAAC,YAAa,QAAO;EAEzB,MAAM,UAAU,IAAI,wBAAwB,WAAW;AACvD,OAAK,MAAM,OAAO,cAAe,SAAQ,UAAU,IAAI;EACvD,MAAM,aAAa,QAAQ,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,EAAE,CAAC;AACpE,MAAI,CAAC,WAAY,QAAO;AAExB,MAAI;GACF,MAAM,UAAU,kBAAkB,WAAW;AAC7C,OAAI,QAAQ,WAAW,EAAG,QAAO;GACjC,MAAM,UAAU,uBAAuB,SAAS,QAAQ,MAAM,aAAa;AAC3E,UAAO;IAAE,GAAG;IAAG;IAAS;YAChB;AACR,cAAW,SAAS;;GAEtB"}

package/dist/components/PlDatasetSelector/filter_discovery.cjs

@@ -0,0 +1,60 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_derive_distinct_labels = require("../../labels/derive_distinct_labels.cjs");
+let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
+let canonicalize = require("canonicalize");
+canonicalize = require_runtime.__toESM(canonicalize);
+//#region src/components/PlDatasetSelector/filter_discovery.ts
+/**
+* Matches columns annotated `pl7.app/isSubset: "true"` whose axes ⊆ anchor axes.
+*
+* The axes-subset constraint is enforced by `mode: "enrichment"`, which sets
+* `allowFloatingHitAxes: false` — every axis of the matched column must be
+* present in the anchor's axes. See `matchingModeToConstraints()` in
+* `column_collection_builder.ts`.
+*/
+function findFilterColumns(collection) {
+	return collection.findColumns({
+		mode: "enrichment",
+		include: { annotations: { [_milaboratories_pl_model_common.Annotation.IsSubset]: "true" } }
+	});
+}
+/**
+* Derive labeled options from filter column matches, for use in DatasetOption.filters.
+*
+* @param matches - from findFilterColumns()
+* @param refsByObjectId - from {@link buildRefMap}
+* @param labelOptions - forwarded to deriveDistinctLabels()
+*/
+function filterMatchesToOptions(matches, refsByObjectId, labelOptions) {
+	if (matches.length === 0) return [];
+	const flattened = matches.flatMap((m) => m.variants.map((v) => ({
+		match: m,
+		variant: v
+	})));
+	const labels = require_derive_distinct_labels.deriveDistinctLabels(flattened.map(({ match, variant }) => ({
+		spec: match.column.spec,
+		linkerPath: variant.path.map((p) => ({ spec: p.linker.spec }))
+	})), labelOptions);
+	return flattened.map(({ match }, i) => {
+		const ref = refsByObjectId.get(match.column.id);
+		if (ref === void 0) throw new Error(`no PlRef found for filter column ${match.column.spec.name} (id: ${match.column.id})`);
+		return {
+			ref,
+			label: labels[i]
+		};
+	});
+}
+/**
+* Usage: `buildRefMap(ctx.resultPool.getSpecs().entries)`
+*/
+function buildRefMap(entries) {
+	const map = /* @__PURE__ */ new Map();
+	for (const entry of entries) map.set((0, canonicalize.default)(entry.ref), entry.ref);
+	return map;
+}
+//#endregion
+exports.buildRefMap = buildRefMap;
+exports.filterMatchesToOptions = filterMatchesToOptions;
+exports.findFilterColumns = findFilterColumns;
+
+//# sourceMappingURL=filter_discovery.cjs.map

package/dist/components/PlDatasetSelector/filter_discovery.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter_discovery.cjs","names":["Annotation","deriveDistinctLabels"],"sources":["../../../src/components/PlDatasetSelector/filter_discovery.ts"],"sourcesContent":["import { Annotation } from \"@milaboratories/pl-model-common\";\nimport type { Option, PlRef, PObjectId } from \"@milaboratories/pl-model-common\";\nimport canonicalize from \"canonicalize\";\nimport type {\n  AnchoredColumnCollection,\n  ColumnMatch,\n} from \"../../columns/column_collection_builder\";\nimport {\n  deriveDistinctLabels,\n  type DeriveLabelsOptions,\n  type Entry,\n} from \"../../labels/derive_distinct_labels\";\n\n/**\n * Matches columns annotated `pl7.app/isSubset: \"true\"` whose axes ⊆ anchor axes.\n *\n * The axes-subset constraint is enforced by `mode: \"enrichment\"`, which sets\n * `allowFloatingHitAxes: false` — every axis of the matched column must be\n * present in the anchor's axes. See `matchingModeToConstraints()` in\n * `column_collection_builder.ts`.\n */\nexport function findFilterColumns(collection: AnchoredColumnCollection): ColumnMatch[] {\n  return collection.findColumns({\n    mode: \"enrichment\",\n    include: {\n      annotations: { [Annotation.IsSubset]: \"true\" },\n    },\n  });\n}\n\n/**\n * Derive labeled options from filter column matches, for use in DatasetOption.filters.\n *\n * @param matches - from findFilterColumns()\n * @param refsByObjectId - from {@link buildRefMap}\n * @param labelOptions - forwarded to deriveDistinctLabels()\n */\nexport function filterMatchesToOptions(\n  matches: ColumnMatch[],\n  refsByObjectId: ReadonlyMap<PObjectId, PlRef>,\n  labelOptions?: DeriveLabelsOptions,\n): Option[] {\n  if (matches.length === 0) return [];\n\n  // Each ColumnMatch can be reached via multiple variants (different linker\n  // paths / qualifications). We emit one Option per variant so the user can\n  // pick a specific path — `deriveDistinctLabels` disambiguates labels by\n  // path.\n  const flattened = matches.flatMap((m) => m.variants.map((v) => ({ match: m, variant: v })));\n\n  const entries: Entry[] = flattened.map(({ match, variant }) => ({\n    spec: match.column.spec,\n    linkerPath: variant.path.map((p) => ({ spec: p.linker.spec })),\n  }));\n\n  const labels = deriveDistinctLabels(entries, labelOptions);\n\n  return flattened.map(({ match }, i) => {\n    const ref = refsByObjectId.get(match.column.id);\n    if (ref === undefined)\n      throw new Error(\n        `no PlRef found for filter column ${match.column.spec.name} (id: ${match.column.id})`,\n      );\n    return { ref, label: labels[i] };\n  });\n}\n\n/**\n * Usage: `buildRefMap(ctx.resultPool.getSpecs().entries)`\n */\nexport function buildRefMap(entries: readonly { readonly ref: PlRef }[]): Map<PObjectId, PlRef> {\n  const map = new Map<PObjectId, PlRef>();\n  for (const entry of entries) {\n    map.set(canonicalize(entry.ref)! as PObjectId, entry.ref);\n  }\n  return map;\n}\n"],"mappings":";;;;;;;;;;;;;;AAqBA,SAAgB,kBAAkB,YAAqD;AACrF,QAAO,WAAW,YAAY;EAC5B,MAAM;EACN,SAAS,EACP,aAAa,GAAGA,gCAAAA,WAAW,WAAW,QAAQ,EAC/C;EACF,CAAC;;;;;;;;;AAUJ,SAAgB,uBACd,SACA,gBACA,cACU;AACV,KAAI,QAAQ,WAAW,EAAG,QAAO,EAAE;CAMnC,MAAM,YAAY,QAAQ,SAAS,MAAM,EAAE,SAAS,KAAK,OAAO;EAAE,OAAO;EAAG,SAAS;EAAG,EAAE,CAAC;CAO3F,MAAM,SAASC,+BAAAA,qBALU,UAAU,KAAK,EAAE,OAAO,eAAe;EAC9D,MAAM,MAAM,OAAO;EACnB,YAAY,QAAQ,KAAK,KAAK,OAAO,EAAE,MAAM,EAAE,OAAO,MAAM,EAAE;EAC/D,EAAE,EAE0C,aAAa;AAE1D,QAAO,UAAU,KAAK,EAAE,SAAS,MAAM;EACrC,MAAM,MAAM,eAAe,IAAI,MAAM,OAAO,GAAG;AAC/C,MAAI,QAAQ,KAAA,EACV,OAAM,IAAI,MACR,oCAAoC,MAAM,OAAO,KAAK,KAAK,QAAQ,MAAM,OAAO,GAAG,GACpF;AACH,SAAO;GAAE;GAAK,OAAO,OAAO;GAAI;GAChC;;;;;AAMJ,SAAgB,YAAY,SAAoE;CAC9F,MAAM,sBAAM,IAAI,KAAuB;AACvC,MAAK,MAAM,SAAS,QAClB,KAAI,KAAA,GAAA,aAAA,SAAiB,MAAM,IAAI,EAAgB,MAAM,IAAI;AAE3D,QAAO"}

package/dist/components/PlDatasetSelector/filter_discovery.d.ts

@@ -0,0 +1,31 @@
+import { DeriveLabelsOptions } from "../../labels/derive_distinct_labels.js";
+import { AnchoredColumnCollection, ColumnMatch } from "../../columns/column_collection_builder.js";
+import { Option, PObjectId, PlRef } from "@milaboratories/pl-model-common";
+
+//#region src/components/PlDatasetSelector/filter_discovery.d.ts
+/**
+ * Matches columns annotated `pl7.app/isSubset: "true"` whose axes ⊆ anchor axes.
+ *
+ * The axes-subset constraint is enforced by `mode: "enrichment"`, which sets
+ * `allowFloatingHitAxes: false` — every axis of the matched column must be
+ * present in the anchor's axes. See `matchingModeToConstraints()` in
+ * `column_collection_builder.ts`.
+ */
+declare function findFilterColumns(collection: AnchoredColumnCollection): ColumnMatch[];
+/**
+ * Derive labeled options from filter column matches, for use in DatasetOption.filters.
+ *
+ * @param matches - from findFilterColumns()
+ * @param refsByObjectId - from {@link buildRefMap}
+ * @param labelOptions - forwarded to deriveDistinctLabels()
+ */
+declare function filterMatchesToOptions(matches: ColumnMatch[], refsByObjectId: ReadonlyMap<PObjectId, PlRef>, labelOptions?: DeriveLabelsOptions): Option[];
+/**
+ * Usage: `buildRefMap(ctx.resultPool.getSpecs().entries)`
+ */
+declare function buildRefMap(entries: readonly {
+  readonly ref: PlRef;
+}[]): Map<PObjectId, PlRef>;
+//#endregion
+export { buildRefMap, filterMatchesToOptions, findFilterColumns };
+//# sourceMappingURL=filter_discovery.d.ts.map

package/dist/components/PlDatasetSelector/filter_discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter_discovery.d.ts","names":[],"sources":["../../../src/components/PlDatasetSelector/filter_discovery.ts"],"mappings":";;;;;;;AAqBA;;;;;;iBAAgB,iBAAA,CAAkB,UAAA,EAAY,wBAAA,GAA2B,WAAA;;;AAgBzE;;;;;iBAAgB,sBAAA,CACd,OAAA,EAAS,WAAA,IACT,cAAA,EAAgB,WAAA,CAAY,SAAA,EAAW,KAAA,GACvC,YAAA,GAAe,mBAAA,GACd,MAAA;;;;iBA6Ba,WAAA,CAAY,OAAA;EAAA,SAA6B,GAAA,EAAK,KAAA;AAAA,MAAY,GAAA,CAAI,SAAA,EAAW,KAAA"}