@platforma-sdk/model 1.70.0 → 1.71.0

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  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 { ColumnSelector, ColumnSnapshot, ColumnVariant, MatchingMode } from \"../../../columns\";\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\";\nimport { flow } from \"es-toolkit\";\n\nexport type createPlDataTableOptionsV3 = {\n  tableState?: PlDataTableStateV2;\n\n  columns: Nil | DiscoverTableColumnOptions | TableColumnVariant[];\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 derivedLabels = deriveAllLabels({\n    columns: discovered.map((dc) => ({\n      id: dc.column.id,\n      spec: dc.column.spec,\n      linkerPath: dc.path,\n      qualifications: dc.qualifications,\n    })),\n    deriveLabelsOptions: {\n      includeNativeLabel: true,\n      ...options.labelsOptions,\n    },\n  });\n\n  const derivedTooltips = deriveAllTooltips({\n    columns: discovered.map((dc) => ({\n      id: dc.column.id,\n      originalId: dc.originalId,\n      spec: dc.column.spec,\n      linkerPath: dc.path,\n      qualifications: dc.qualifications,\n    })),\n  });\n\n  const annotated = annotateColumnGroups({\n    pframeSpec,\n    ...splited,\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.map((v) => v.column),\n    ...annotated.linked.flatMap((lc) => [...lc.path.map((s) => s.linker), lc.column]),\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    (v) => ({ column: resolveSnapshot(v.column) }),\n  );\n  const secondaryGroups: SecondaryGroup<undefined | PColumnDataUniversal>[] = buildSecondaryGroups(\n    secondarySnapshots,\n    annotated.linked,\n  );\n  const fullDef = createPTableDefV3({\n    primaryJoinType,\n    primary: primaryEntries,\n    secondary: secondaryGroups,\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((v) => resolveSnapshot(v.column)),\n    ...annotated.linked.map((v) => resolveSnapshot(v.column)),\n    ...collectLinkerSnapshots(annotated.linked).map(resolveSnapshot),\n  ]);\n\n  const hiddenSpecs = state.pTableParams.hiddenColIds;\n  const hiddenColumnIds = computeHiddenColumns(\n    [...annotated.direct, ...annotated.linked].map((v) => v.column),\n    sorting,\n    filters,\n    hiddenSpecs,\n  );\n\n  const visible = buildVisibleColumns(annotated, hiddenColumnIds);\n  const visibleDef = createPTableDefV3({\n    primaryJoinType,\n    primary: primaryEntries,\n    secondary: buildSecondaryGroups(\n      visible.direct.filter((c) => !c.isPrimary),\n      visible.linked,\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\nexport type TableColumnVariant = ColumnVariant<DiscoveredPColumnId> & {\n  readonly originalId: PObjectId;\n  readonly isPrimary?: boolean;\n};\n\ntype SplitDiscoveredColumns = {\n  readonly direct: TableColumnVariant[];\n  readonly linked: TableColumnVariant[];\n};\n\ntype AnnotatedColumnGroups = {\n  readonly direct: TableColumnVariant[];\n  readonly linked: TableColumnVariant[];\n};\n\ntype VisibleColumns = {\n  readonly direct: TableColumnVariant[];\n  readonly linked: TableColumnVariant[];\n};\n\n/** Split discovered columns into direct (no linker path) and linked (with linker path). */\nfunction splitDiscoveredColumns(columns: TableColumnVariant[]): SplitDiscoveredColumns {\n  const direct = columns.filter((dc) => dc.path.length === 0);\n  const linked = columns.filter((dc) => dc.path.length > 0);\n  return { direct, linked };\n}\n\n/** All linker snapshots across the given linked columns, deduped by id. */\nfunction collectLinkerSnapshots(linked: TableColumnVariant[]): ColumnSnapshot<PObjectId>[] {\n  return uniqueBy(\n    linked.flatMap((lc) => lc.path.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: TableColumnVariant[];\n  linked: TableColumnVariant[];\n  derivedLabels: Record<string, string>;\n  derivedTooltips: Record<string, string>;\n  displayOptions?: ColumnsDisplayOptions;\n  pframeSpec: PFrameSpecDriver;\n}): AnnotatedColumnGroups {\n  const { direct, linked, derivedLabels, derivedTooltips, displayOptions, pframeSpec } = params;\n\n  const allColumnsForRules = [\n    ...direct.map((v) => v.column),\n    ...linked.map((v) => v.column),\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 = liftToVariantColumns(\n    direct,\n    flow(\n      (cols) => withLabelAnnotations(derivedLabels, cols),\n      (cols) => withInfoAnnotations(derivedTooltips, cols),\n      (cols) => withTableVisualAnnotations(visibilityByColId, orderByColId, cols),\n    ),\n  );\n\n  const linkedAnnotated = liftToVariantColumns(\n    linked,\n    flow(\n      (cols) => withHidenAxesAnnotations(cols),\n      (cols) => withLabelAnnotations(derivedLabels, cols),\n      (cols) => withInfoAnnotations(derivedTooltips, cols),\n      (cols) => withTableVisualAnnotations(visibilityByColId, orderByColId, cols),\n    ),\n  ).map((lc) => ({ ...lc, path: annotateLinkerPath(derivedLabels, lc.path) }));\n\n  return {\n    direct: directAnnotated,\n    linked: linkedAnnotated,\n  };\n}\n\n/** Lift a snapshot-array transform so it runs on the inner `column` of each variant. */\nfunction liftToVariantColumns<V extends { readonly column: ColumnSnapshot<DiscoveredPColumnId> }>(\n  variants: V[],\n  fn: (cols: ColumnSnapshot<DiscoveredPColumnId>[]) => ColumnSnapshot<DiscoveredPColumnId>[],\n): V[] {\n  const cols = fn(variants.map((v) => v.column));\n  if (cols.length !== variants.length)\n    throw new Error(\n      `liftToVariantColumns: fn must preserve array length (got ${cols.length}, expected ${variants.length})`,\n    );\n  return variants.map((v, i) => ({ ...v, column: cols[i] }));\n}\n\nfunction annotateLinkerPath(\n  derivedLabels: Record<string, string>,\n  path: TableColumnVariant[\"path\"],\n): TableColumnVariant[\"path\"] {\n  if (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: TableColumnVariant[],\n  linked: TableColumnVariant[],\n): SecondaryGroup<undefined | PColumnDataUniversal>[] {\n  return [\n    ...direct.map(\n      (c): SecondaryGroup<undefined | PColumnDataUniversal> => ({\n        entries: [{ column: resolveSnapshot(c.column), qualifications: c.qualifications.forHit }],\n        primaryQualifications: c.qualifications.forQueries,\n      }),\n    ),\n    ...linked.map(\n      (lc): SecondaryGroup<undefined | PColumnDataUniversal> => ({\n        entries: [\n          ...lc.path.map((s) => ({\n            column: resolveSnapshot(s.linker),\n          })),\n          { column: resolveSnapshot(lc.column), qualifications: lc.qualifications.forHit },\n        ],\n        primaryQualifications: lc.qualifications.forQueries,\n      }),\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): VisibleColumns {\n  const direct = annotated.direct.filter((c) => !hiddenColumns.has(c.column.id));\n  const linked = annotated.linked.filter((c) => !hiddenColumns.has(c.column.id));\n  return { direct, linked };\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: TableColumnVariant[],\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.column.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.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: TableColumnVariant[],\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.column.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.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 { ColumnSelector, ColumnSnapshot, ColumnVariant, MatchingMode } from \"../../../columns\";\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  withDataStatusAnnotations,\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\";\nimport { flow } from \"es-toolkit\";\n\nexport type createPlDataTableOptionsV3 = {\n  tableState?: PlDataTableStateV2;\n\n  columns: Nil | DiscoverTableColumnOptions | TableColumnVariant[];\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\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 derivedLabels = deriveAllLabels({\n    columns: discovered.map((dc) => ({\n      id: dc.column.id,\n      spec: dc.column.spec,\n      linkerPath: dc.path,\n      qualifications: dc.qualifications,\n    })),\n    deriveLabelsOptions: {\n      includeNativeLabel: true,\n      ...options.labelsOptions,\n    },\n  });\n\n  const derivedTooltips = deriveAllTooltips({\n    columns: discovered.map((dc) => ({\n      id: dc.column.id,\n      originalId: dc.originalId,\n      spec: dc.column.spec,\n      linkerPath: dc.path,\n      qualifications: dc.qualifications,\n    })),\n  });\n\n  const annotated = annotateColumnGroups({\n    pframeSpec,\n    ...splited,\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.map((v) => v.column),\n    ...annotated.linked.flatMap((lc) => [...lc.path.map((s) => s.linker), lc.column]),\n  ]);\n\n  const remapedDefaultFilters = remapFilterColumnIds(options.filters, discovered);\n  const filters = filterFilters(\n    concatFilters(\n      state.pTableParams.filters,\n      state.pTableParams.defaultFilters ?? remapedDefaultFilters,\n    ),\n    columnIsAvailable,\n  );\n\n  const sorting = filterSorting(\n    resolveSorting(state.pTableParams.sorting, remapSortingColumnIds(options.sorting, discovered)),\n    columnIsAvailable,\n  );\n\n  const primaryEntries: PrimaryEntry<undefined | PColumnDataUniversal>[] = primarySnapshots.map(\n    (v) => ({ column: resolveSnapshot(v.column) }),\n  );\n  const secondaryGroups: SecondaryGroup<undefined | PColumnDataUniversal>[] = buildSecondaryGroups(\n    secondarySnapshots,\n    annotated.linked,\n  );\n  const fullDef = createPTableDefV3({\n    primaryJoinType,\n    primary: primaryEntries,\n    secondary: secondaryGroups,\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((v) => resolveSnapshot(v.column)),\n    ...annotated.linked.map((v) => resolveSnapshot(v.column)),\n    ...collectLinkerSnapshots(annotated.linked).map(resolveSnapshot),\n  ]);\n\n  const hiddenSpecs = state.pTableParams.hiddenColIds;\n  const hiddenColumnIds = computeHiddenColumns(\n    [...annotated.direct, ...annotated.linked].map((v) => v.column),\n    sorting,\n    filters,\n    hiddenSpecs,\n  );\n\n  const visible = buildVisibleColumns(annotated, hiddenColumnIds);\n  const visibleDef = createPTableDefV3({\n    primaryJoinType,\n    primary: primaryEntries,\n    secondary: buildSecondaryGroups(\n      visible.direct.filter((c) => !c.isPrimary),\n      visible.linked,\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\nexport type TableColumnVariant = ColumnVariant<DiscoveredPColumnId> & {\n  readonly originalId: PObjectId;\n  readonly isPrimary?: boolean;\n};\n\ntype SplitDiscoveredColumns = {\n  readonly direct: TableColumnVariant[];\n  readonly linked: TableColumnVariant[];\n};\n\ntype AnnotatedColumnGroups = {\n  readonly direct: TableColumnVariant[];\n  readonly linked: TableColumnVariant[];\n};\n\ntype VisibleColumns = {\n  readonly direct: TableColumnVariant[];\n  readonly linked: TableColumnVariant[];\n};\n\n/** Split discovered columns into direct (no linker path) and linked (with linker path). */\nfunction splitDiscoveredColumns(columns: TableColumnVariant[]): SplitDiscoveredColumns {\n  const direct = columns.filter((dc) => dc.path.length === 0);\n  const linked = columns.filter((dc) => dc.path.length > 0);\n  return { direct, linked };\n}\n\n/** All linker snapshots across the given linked columns, deduped by id. */\nfunction collectLinkerSnapshots(linked: TableColumnVariant[]): ColumnSnapshot<PObjectId>[] {\n  return uniqueBy(\n    linked.flatMap((lc) => lc.path.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: TableColumnVariant[];\n  linked: TableColumnVariant[];\n  derivedLabels: Record<string, string>;\n  derivedTooltips: Record<string, string>;\n  displayOptions?: ColumnsDisplayOptions;\n  pframeSpec: PFrameSpecDriver;\n}): AnnotatedColumnGroups {\n  const { direct, linked, derivedLabels, derivedTooltips, displayOptions, pframeSpec } = params;\n\n  const allColumnsForRules = [\n    ...direct.map((v) => v.column),\n    ...linked.map((v) => v.column),\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 = liftToVariantColumns(\n    direct,\n    flow(\n      (cols) => withDataStatusAnnotations(cols),\n      (cols) => withLabelAnnotations(derivedLabels, cols),\n      (cols) => withInfoAnnotations(derivedTooltips, cols),\n      (cols) => withTableVisualAnnotations(visibilityByColId, orderByColId, cols),\n    ),\n  );\n\n  const linkedAnnotated = liftToVariantColumns(\n    linked,\n    flow(\n      (cols) => withDataStatusAnnotations(cols),\n      (cols) => withHidenAxesAnnotations(cols),\n      (cols) => withLabelAnnotations(derivedLabels, cols),\n      (cols) => withInfoAnnotations(derivedTooltips, cols),\n      (cols) => withTableVisualAnnotations(visibilityByColId, orderByColId, cols),\n    ),\n  ).map((lc) => ({ ...lc, path: annotateLinkerPath(derivedLabels, lc.path) }));\n\n  return {\n    direct: directAnnotated,\n    linked: linkedAnnotated,\n  };\n}\n\n/** Lift a snapshot-array transform so it runs on the inner `column` of each variant. */\nfunction liftToVariantColumns<V extends { readonly column: ColumnSnapshot<DiscoveredPColumnId> }>(\n  variants: V[],\n  fn: (cols: ColumnSnapshot<DiscoveredPColumnId>[]) => ColumnSnapshot<DiscoveredPColumnId>[],\n): V[] {\n  const cols = fn(variants.map((v) => v.column));\n  if (cols.length !== variants.length)\n    throw new Error(\n      `liftToVariantColumns: fn must preserve array length (got ${cols.length}, expected ${variants.length})`,\n    );\n  return variants.map((v, i) => ({ ...v, column: cols[i] }));\n}\n\nfunction annotateLinkerPath(\n  derivedLabels: Record<string, string>,\n  path: TableColumnVariant[\"path\"],\n): TableColumnVariant[\"path\"] {\n  if (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/** Drop filter leaves whose column references are not available in the table. */\nfunction filterFilters(\n  filters: Nil | PlDataTableFilters,\n  isValidColumnId: (id: string) => boolean,\n): Nil | PlDataTableFilters {\n  if (isNil(filters)) return filters;\n\n  const isLeafValid = (leaf: PlDataTableFilterSpecLeaf): boolean => {\n    if (leaf.type === undefined) return true;\n    if (\"column\" in leaf && !isValidColumnId(leaf.column)) return false;\n    if (\"rhs\" in leaf && !isValidColumnId(leaf.rhs)) return false;\n    return true;\n  };\n\n  const prune = (node: PlDataTableFilterNode): Nil | PlDataTableFilterNode => {\n    if (node.type === \"and\" || node.type === \"or\") {\n      const kept = node.filters\n        .map((f) => prune(f))\n        .filter((f): f is PlDataTableFilterNode => !isNil(f));\n      return { type: node.type, filters: kept };\n    }\n    if (node.type === \"not\") {\n      const inner = prune(node.filter);\n      return isNil(inner) ? undefined : { type: \"not\", filter: inner };\n    }\n    return isLeafValid(node) ? node : undefined;\n  };\n\n  return prune(filters) as Nil | PlDataTableFilters;\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/** Drop sorting entries whose column is not available in the table. */\nfunction filterSorting(\n  sorting: PTableSorting[],\n  isValidColumnId: (id: string) => boolean,\n): PTableSorting[] {\n  return sorting.filter((s) => isValidColumnId(canonicalizeJson<PTableColumnId>(s.column)));\n}\n\nfunction buildSecondaryGroups(\n  direct: TableColumnVariant[],\n  linked: TableColumnVariant[],\n): SecondaryGroup<undefined | PColumnDataUniversal>[] {\n  return [\n    ...direct.map(\n      (c): SecondaryGroup<undefined | PColumnDataUniversal> => ({\n        entries: [{ column: resolveSnapshot(c.column), qualifications: c.qualifications.forHit }],\n        primaryQualifications: c.qualifications.forQueries,\n      }),\n    ),\n    ...linked.map(\n      (lc): SecondaryGroup<undefined | PColumnDataUniversal> => ({\n        entries: [\n          ...lc.path.map((s) => ({\n            column: resolveSnapshot(s.linker),\n          })),\n          { column: resolveSnapshot(lc.column), qualifications: lc.qualifications.forHit },\n        ],\n        primaryQualifications: lc.qualifications.forQueries,\n      }),\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): VisibleColumns {\n  const direct = annotated.direct.filter((c) => !hiddenColumns.has(c.column.id));\n  const linked = annotated.linked.filter((c) => !hiddenColumns.has(c.column.id));\n  return { direct, linked };\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: TableColumnVariant[],\n): Nil | PTableSorting[] {\n  return sorting?.flatMap((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 = columns.find((c) => (c.originalId ?? c.column.id) === id);\n    if (column === undefined) return [];\n\n    return [\n      {\n        ...s,\n        column: {\n          type: \"column\" as const,\n          id: column.column.id,\n        },\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: TableColumnVariant[],\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.column.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.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/utils.cjs

@@ -108,6 +108,20 @@ function withLabelAnnotations(derivedLabels, columns) {
 		};
 	});
 }
+function withDataStatusAnnotations(columns) {
+	return columns.map((col) => {
+		return {
+			...col,
+			spec: {
+				...col.spec,
+				annotations: {
+					...col.spec.annotations,
+					[_milaboratories_pl_model_common.Annotation.DataStatus]: col.dataStatus
+				}
+			}
+		};
+	});
+}
 /**
 * Writes effective display properties (OrderPriority, Visibility) from precomputed rule maps
 * into column annotations. Returns new column objects — originals are not mutated.
@@ -209,6 +223,7 @@ exports.getEffectiveVisibility = getEffectiveVisibility;
 exports.getOrderPriority = getOrderPriority;
 exports.isColumnHidden = isColumnHidden;
 exports.isColumnOptional = isColumnOptional;
+exports.withDataStatusAnnotations = withDataStatusAnnotations;
 exports.withHidenAxesAnnotations = withHidenAxesAnnotations;
 exports.withInfoAnnotations = withInfoAnnotations;
 exports.withLabelAnnotations = withLabelAnnotations;

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

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","names":["Annotation","ColumnCollectionBuilder","ArrayColumnProvider","deriveDistinctLabels","deriveDistinctTooltips"],"sources":["../../../../src/components/PlDataTable/createPlDataTable/utils.ts"],"sourcesContent":["import {\n  type PColumn,\n  type PColumnSpec,\n  type PFrameSpecDriver,\n  type PObjectId,\n  Annotation,\n  canonicalizeAxisId,\n  DiscoveredPColumnId,\n  readAnnotation,\n  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?: MatchVariant[\"path\"];\n  readonly qualifications?: MatchQualifications;\n};\n\n/** Derive labels for all table elements: columns via deriveDistinctLabels, axes from label columns. */\nexport function deriveAllLabels(options: {\n  columns: LabelableColumn[];\n  deriveLabelsOptions?: DeriveLabelsOptions;\n}): Record<string, string> {\n  const { columns, deriveLabelsOptions } = options;\n  const entries = columns.map((c) => ({\n    spec: c.spec,\n    linkerPath: c.linkerPath?.map((step) => ({\n      spec: step.linker.spec,\n    })),\n    qualifications: c.qualifications,\n  }));\n  const columnLabels = deriveDistinctLabels(entries, deriveLabelsOptions).reduce(\n    (acc, label, index) => ((acc[columns[index].id] = label), acc),\n    {} as Record<string, string>,\n  );\n  return columnLabels;\n}\n\n/** Column shape required by tooltip derivation. */\nexport type TooltipableColumn = {\n  readonly id: DiscoveredPColumnId;\n  readonly spec: PColumnSpec;\n  readonly originalId: PObjectId;\n  readonly linkerPath?: MatchVariant[\"path\"];\n  readonly qualifications?: MatchQualifications;\n};\n\n/** Derive origin tooltips for columns whose qualifications or linker path carry info. */\nexport function deriveAllTooltips(options: {\n  columns: TooltipableColumn[];\n}): Record<DiscoveredPColumnId, string> {\n  const { columns } = options;\n\n  const variantCountByOriginal = columns.reduce<Map<PObjectId, number>>((acc, c) => {\n    return acc.set(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        variantIndex,\n        variantCount,\n      });\n\n      return { entries, variantSeen };\n    },\n    { entries: [] as TooltipEntry[], variantSeen: new Map<PObjectId, number>() },\n  );\n\n  const tooltips = deriveDistinctTooltips(entries);\n\n  return Object.fromEntries(\n    tooltips.flatMap((t, i) => (isNil(t) ? [] : [[columns[i].id, t] as const])),\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils.cjs","names":["Annotation","ColumnCollectionBuilder","ArrayColumnProvider","deriveDistinctLabels","deriveDistinctTooltips"],"sources":["../../../../src/components/PlDataTable/createPlDataTable/utils.ts"],"sourcesContent":["import {\n  type PColumn,\n  type PColumnSpec,\n  type PFrameSpecDriver,\n  type PObjectId,\n  Annotation,\n  canonicalizeAxisId,\n  DiscoveredPColumnId,\n  readAnnotation,\n  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 { ColumnDataStatus, MatchQualifications, MatchVariant } from \"../../../columns\";\nimport type { ColumnMatcher, ColumnOrderRule, ColumnVisibilityRule } from \"./createPlDataTableV3\";\nimport type { ColumnSelector } from \"../../../columns\";\nimport { ArrayColumnProvider, ColumnCollectionBuilder } from \"../../../columns\";\nimport { isNil } from \"es-toolkit\";\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 {\n    readonly id: PObjectId;\n    readonly spec: PColumnSpec;\n  },\n>(derivedLabels: undefined | Record<string, string>, columns: T[]): T[] {\n  if (derivedLabels === undefined) return columns;\n  return columns.map((col) => {\n    const colLabel = derivedLabels[col.id];\n    return {\n      ...col,\n      spec: {\n        ...col.spec,\n        ...(isNil(colLabel)\n          ? {}\n          : { annotations: { ...col.spec.annotations, [Annotation.Label]: colLabel } }),\n        axesSpec: col.spec.axesSpec.map((axis) => {\n          const label = derivedLabels[canonicalizeAxisId(axis)];\n          return isNil(label)\n            ? axis\n            : { ...axis, annotations: { ...axis.annotations, [Annotation.Label]: label } };\n        }),\n      },\n    } as T;\n  });\n}\n\nexport function withDataStatusAnnotations<\n  T extends {\n    readonly spec: PColumnSpec;\n    readonly dataStatus: ColumnDataStatus;\n  },\n>(columns: T[]): T[] {\n  return columns.map((col) => {\n    return {\n      ...col,\n      spec: {\n        ...col.spec,\n        annotations: {\n          ...col.spec.annotations,\n          [Annotation.DataStatus]: col.dataStatus,\n        },\n      },\n    } as T;\n  });\n}\n\n/**\n * Writes effective display properties (OrderPriority, Visibility) from precomputed rule maps\n * into column annotations. Returns new column objects — originals are not mutated.\n */\nexport function withTableVisualAnnotations<\n  T extends { readonly id: PObjectId; readonly spec: PColumnSpec },\n>(\n  visibilityByColId: undefined | Map<PObjectId, ColumnVisibilityRule>,\n  orderByColId: undefined | Map<PObjectId, ColumnOrderRule>,\n  columns: T[],\n): T[] {\n  if (visibilityByColId === undefined && orderByColId === undefined) return columns;\n  return columns.map((col) => {\n    const annotations = { ...col.spec.annotations };\n\n    const visibility = getEffectiveVisibility(col, visibilityByColId);\n    if (!isNil(visibility)) annotations[Annotation.Table.Visibility] = visibility;\n\n    const orderPriority = getOrderPriority(col, orderByColId);\n    if (!isNil(orderPriority)) annotations[Annotation.Table.OrderPriority] = String(orderPriority);\n\n    return {\n      ...col,\n      spec: {\n        ...col.spec,\n        annotations: annotations,\n      },\n    } as T;\n  });\n}\n\n/**\n * Writes derived info annotations into column annotations.\n * Columns without an info entry are passed through unchanged.\n */\nexport function withInfoAnnotations<\n  T extends { readonly id: PObjectId; readonly spec: PColumnSpec },\n>(infoById: undefined | Record<string, string>, columns: T[]): T[] {\n  if (isNil(infoById)) return columns;\n  return columns.map((col) => {\n    const info = infoById[col.id];\n    if (isNil(info)) return col;\n    return {\n      ...col,\n      spec: {\n        ...col.spec,\n        annotations: { ...col.spec.annotations, [Annotation.Table.Info]: info },\n      },\n    } as T;\n  });\n}\n\nexport function withHidenAxesAnnotations<T extends { readonly spec: PColumnSpec }>(\n  columns: T[],\n): T[] {\n  return columns.map(\n    (col) =>\n      ({\n        ...col,\n        spec: {\n          ...col.spec,\n          axesSpec: col.spec.axesSpec.map((axis) => ({\n            ...axis,\n            annotations: { ...axis.annotations, [Annotation.Table.Visibility]: \"hidden\" },\n          })),\n        },\n      }) as T,\n  );\n}\n\n/** Column shape required by label derivation. */\nexport type LabelableColumn = {\n  readonly id: PObjectId;\n  readonly spec: PColumnSpec;\n  readonly linkerPath?: MatchVariant[\"path\"];\n  readonly qualifications?: MatchQualifications;\n};\n\n/** Derive labels for all table elements: columns via deriveDistinctLabels, axes from label columns. */\nexport function deriveAllLabels(options: {\n  columns: LabelableColumn[];\n  deriveLabelsOptions?: DeriveLabelsOptions;\n}): Record<string, string> {\n  const { columns, deriveLabelsOptions } = options;\n  const entries = columns.map((c) => ({\n    spec: c.spec,\n    linkerPath: c.linkerPath?.map((step) => ({\n      spec: step.linker.spec,\n    })),\n    qualifications: c.qualifications,\n  }));\n  const columnLabels = deriveDistinctLabels(entries, deriveLabelsOptions).reduce(\n    (acc, label, index) => ((acc[columns[index].id] = label), acc),\n    {} as Record<string, string>,\n  );\n  return columnLabels;\n}\n\n/** Column shape required by tooltip derivation. */\nexport type TooltipableColumn = {\n  readonly id: DiscoveredPColumnId;\n  readonly spec: PColumnSpec;\n  readonly originalId: PObjectId;\n  readonly linkerPath?: MatchVariant[\"path\"];\n  readonly qualifications?: MatchQualifications;\n};\n\n/** Derive origin tooltips for columns whose qualifications or linker path carry info. */\nexport function deriveAllTooltips(options: {\n  columns: TooltipableColumn[];\n}): Record<DiscoveredPColumnId, string> {\n  const { columns } = options;\n\n  const variantCountByOriginal = columns.reduce<Map<PObjectId, number>>((acc, c) => {\n    return acc.set(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        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/createPlDataTable/utils.js

@@ -107,6 +107,20 @@ function withLabelAnnotations(derivedLabels, columns) {
 		};
 	});
 }
+function withDataStatusAnnotations(columns) {
+	return columns.map((col) => {
+		return {
+			...col,
+			spec: {
+				...col.spec,
+				annotations: {
+					...col.spec.annotations,
+					[Annotation.DataStatus]: col.dataStatus
+				}
+			}
+		};
+	});
+}
 /**
 * Writes effective display properties (OrderPriority, Visibility) from precomputed rule maps
 * into column annotations. Returns new column objects — originals are not mutated.
@@ -201,6 +215,6 @@ function deriveAllTooltips(options) {
 	return Object.fromEntries(tooltips.flatMap((t, i) => isNil(t) ? [] : [[columns[i].id, t]]));
 }
 //#endregion
-export { deriveAllLabels, deriveAllTooltips, evaluateRules, getEffectiveVisibility, getOrderPriority, isColumnHidden, isColumnOptional, withHidenAxesAnnotations, withInfoAnnotations, withLabelAnnotations, withTableVisualAnnotations };
+export { deriveAllLabels, deriveAllTooltips, evaluateRules, getEffectiveVisibility, getOrderPriority, isColumnHidden, isColumnOptional, withDataStatusAnnotations, 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 PFrameSpecDriver,\n  type PObjectId,\n  Annotation,\n  canonicalizeAxisId,\n  DiscoveredPColumnId,\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?: MatchVariant[\"path\"];\n  readonly qualifications?: MatchQualifications;\n};\n\n/** Derive labels for all table elements: columns via deriveDistinctLabels, axes from label columns. */\nexport function deriveAllLabels(options: {\n  columns: LabelableColumn[];\n  deriveLabelsOptions?: DeriveLabelsOptions;\n}): Record<string, string> {\n  const { columns, deriveLabelsOptions } = options;\n  const entries = columns.map((c) => ({\n    spec: c.spec,\n    linkerPath: c.linkerPath?.map((step) => ({\n      spec: step.linker.spec,\n    })),\n    qualifications: c.qualifications,\n  }));\n  const columnLabels = deriveDistinctLabels(entries, deriveLabelsOptions).reduce(\n    (acc, label, index) => ((acc[columns[index].id] = label), acc),\n    {} as Record<string, string>,\n  );\n  return columnLabels;\n}\n\n/** Column shape required by tooltip derivation. */\nexport type TooltipableColumn = {\n  readonly id: DiscoveredPColumnId;\n  readonly spec: PColumnSpec;\n  readonly originalId: PObjectId;\n  readonly linkerPath?: MatchVariant[\"path\"];\n  readonly qualifications?: MatchQualifications;\n};\n\n/** Derive origin tooltips for columns whose qualifications or linker path carry info. */\nexport function deriveAllTooltips(options: {\n  columns: TooltipableColumn[];\n}): Record<DiscoveredPColumnId, string> {\n  const { columns } = options;\n\n  const variantCountByOriginal = columns.reduce<Map<PObjectId, number>>((acc, c) => {\n    return acc.set(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        variantIndex,\n        variantCount,\n      });\n\n      return { entries, variantSeen };\n    },\n    { entries: [] as TooltipEntry[], variantSeen: new Map<PObjectId, number>() },\n  );\n\n  const tooltips = deriveDistinctTooltips(entries);\n\n  return Object.fromEntries(\n    tooltips.flatMap((t, i) => (isNil(t) ? [] : [[columns[i].id, t] as const])),\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils.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  DiscoveredPColumnId,\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 { ColumnDataStatus, MatchQualifications, MatchVariant } from \"../../../columns\";\nimport type { ColumnMatcher, ColumnOrderRule, ColumnVisibilityRule } from \"./createPlDataTableV3\";\nimport type { ColumnSelector } from \"../../../columns\";\nimport { ArrayColumnProvider, ColumnCollectionBuilder } from \"../../../columns\";\nimport { isNil } from \"es-toolkit\";\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 {\n    readonly id: PObjectId;\n    readonly spec: PColumnSpec;\n  },\n>(derivedLabels: undefined | Record<string, string>, columns: T[]): T[] {\n  if (derivedLabels === undefined) return columns;\n  return columns.map((col) => {\n    const colLabel = derivedLabels[col.id];\n    return {\n      ...col,\n      spec: {\n        ...col.spec,\n        ...(isNil(colLabel)\n          ? {}\n          : { annotations: { ...col.spec.annotations, [Annotation.Label]: colLabel } }),\n        axesSpec: col.spec.axesSpec.map((axis) => {\n          const label = derivedLabels[canonicalizeAxisId(axis)];\n          return isNil(label)\n            ? axis\n            : { ...axis, annotations: { ...axis.annotations, [Annotation.Label]: label } };\n        }),\n      },\n    } as T;\n  });\n}\n\nexport function withDataStatusAnnotations<\n  T extends {\n    readonly spec: PColumnSpec;\n    readonly dataStatus: ColumnDataStatus;\n  },\n>(columns: T[]): T[] {\n  return columns.map((col) => {\n    return {\n      ...col,\n      spec: {\n        ...col.spec,\n        annotations: {\n          ...col.spec.annotations,\n          [Annotation.DataStatus]: col.dataStatus,\n        },\n      },\n    } as T;\n  });\n}\n\n/**\n * Writes effective display properties (OrderPriority, Visibility) from precomputed rule maps\n * into column annotations. Returns new column objects — originals are not mutated.\n */\nexport function withTableVisualAnnotations<\n  T extends { readonly id: PObjectId; readonly spec: PColumnSpec },\n>(\n  visibilityByColId: undefined | Map<PObjectId, ColumnVisibilityRule>,\n  orderByColId: undefined | Map<PObjectId, ColumnOrderRule>,\n  columns: T[],\n): T[] {\n  if (visibilityByColId === undefined && orderByColId === undefined) return columns;\n  return columns.map((col) => {\n    const annotations = { ...col.spec.annotations };\n\n    const visibility = getEffectiveVisibility(col, visibilityByColId);\n    if (!isNil(visibility)) annotations[Annotation.Table.Visibility] = visibility;\n\n    const orderPriority = getOrderPriority(col, orderByColId);\n    if (!isNil(orderPriority)) annotations[Annotation.Table.OrderPriority] = String(orderPriority);\n\n    return {\n      ...col,\n      spec: {\n        ...col.spec,\n        annotations: annotations,\n      },\n    } as T;\n  });\n}\n\n/**\n * Writes derived info annotations into column annotations.\n * Columns without an info entry are passed through unchanged.\n */\nexport function withInfoAnnotations<\n  T extends { readonly id: PObjectId; readonly spec: PColumnSpec },\n>(infoById: undefined | Record<string, string>, columns: T[]): T[] {\n  if (isNil(infoById)) return columns;\n  return columns.map((col) => {\n    const info = infoById[col.id];\n    if (isNil(info)) return col;\n    return {\n      ...col,\n      spec: {\n        ...col.spec,\n        annotations: { ...col.spec.annotations, [Annotation.Table.Info]: info },\n      },\n    } as T;\n  });\n}\n\nexport function withHidenAxesAnnotations<T extends { readonly spec: PColumnSpec }>(\n  columns: T[],\n): T[] {\n  return columns.map(\n    (col) =>\n      ({\n        ...col,\n        spec: {\n          ...col.spec,\n          axesSpec: col.spec.axesSpec.map((axis) => ({\n            ...axis,\n            annotations: { ...axis.annotations, [Annotation.Table.Visibility]: \"hidden\" },\n          })),\n        },\n      }) as T,\n  );\n}\n\n/** Column shape required by label derivation. */\nexport type LabelableColumn = {\n  readonly id: PObjectId;\n  readonly spec: PColumnSpec;\n  readonly linkerPath?: MatchVariant[\"path\"];\n  readonly qualifications?: MatchQualifications;\n};\n\n/** Derive labels for all table elements: columns via deriveDistinctLabels, axes from label columns. */\nexport function deriveAllLabels(options: {\n  columns: LabelableColumn[];\n  deriveLabelsOptions?: DeriveLabelsOptions;\n}): Record<string, string> {\n  const { columns, deriveLabelsOptions } = options;\n  const entries = columns.map((c) => ({\n    spec: c.spec,\n    linkerPath: c.linkerPath?.map((step) => ({\n      spec: step.linker.spec,\n    })),\n    qualifications: c.qualifications,\n  }));\n  const columnLabels = deriveDistinctLabels(entries, deriveLabelsOptions).reduce(\n    (acc, label, index) => ((acc[columns[index].id] = label), acc),\n    {} as Record<string, string>,\n  );\n  return columnLabels;\n}\n\n/** Column shape required by tooltip derivation. */\nexport type TooltipableColumn = {\n  readonly id: DiscoveredPColumnId;\n  readonly spec: PColumnSpec;\n  readonly originalId: PObjectId;\n  readonly linkerPath?: MatchVariant[\"path\"];\n  readonly qualifications?: MatchQualifications;\n};\n\n/** Derive origin tooltips for columns whose qualifications or linker path carry info. */\nexport function deriveAllTooltips(options: {\n  columns: TooltipableColumn[];\n}): Record<DiscoveredPColumnId, string> {\n  const { columns } = options;\n\n  const variantCountByOriginal = columns.reduce<Map<PObjectId, number>>((acc, c) => {\n    return acc.set(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        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/package.cjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "1.70.0";
+var version = "1.71.0";
 //#endregion
 Object.defineProperty(exports, "version", {
 	enumerable: true,

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "1.70.0";
+var version = "1.71.0";
 //#endregion
 export { version };
 

package/dist/render/api.cjs

@@ -9,6 +9,7 @@ const require_column_collection = require("./util/column_collection.cjs");
 const require_pframe_upgraders = require("./util/pframe_upgraders.cjs");
 const require_get_services = require("../services/get_services.cjs");
 require("../services/index.cjs");
+require("./util/index.cjs");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
 let canonicalize = require("canonicalize");
 canonicalize = require_runtime.__toESM(canonicalize);
@@ -34,7 +35,7 @@ function transformPColumnData(data) {
 	return (0, _milaboratories_pl_model_common.mapPObjectData)(data, (d) => {
 		if (d instanceof require_accessor.TreeNodeAccessor) return d.handle;
 		else if ((0, _milaboratories_pl_model_common.isDataInfo)(d)) return (0, _milaboratories_pl_model_common.mapDataInfo)(d, (accessor) => accessor.handle);
-		else return d;
+		else return d ?? [];
 	});
 }
 var ResultPool = class {
@@ -374,8 +375,6 @@ var RenderCtxBase = class {
 		return def;
 	}
 	createPFrame(def) {
-		if (!require_pcolumn_data.allPColumnsReady(def)) return void 0;
-		this.verifyInlineAndExplicitColumnsSupport(def);
 		return this.ctx.createPFrame(def.map((c) => transformPColumnData(c)));
 	}
 	createPTable(def) {
@@ -399,17 +398,7 @@ var RenderCtxBase = class {
 		return this.ctx.createPTable((0, _milaboratories_pl_model_common.mapPTableDef)(rawDef, (po) => transformPColumnData(po)));
 	}
 	createPTableV2(def) {
-		const columns = (0, _milaboratories_pl_model_common.collectSpecQueryColumns)(def.query);
-		if (!require_pcolumn_data.allPColumnsReady(columns)) return void 0;
-		this.verifyInlineAndExplicitColumnsSupport(columns);
-		return this.ctx.createPTableV2((0, _milaboratories_pl_model_common.mapPTableDefV2)(def, (po) => {
-			if (po.data === void 0) throw new Error("unreachable: column data undefined after readiness check");
-			return transformPColumnData({
-				id: po.id,
-				spec: po.spec,
-				data: po.data
-			});
-		}));
+		return this.ctx.createPTableV2((0, _milaboratories_pl_model_common.mapPTableDefV2)(def, (po) => transformPColumnData(po)));
 	}
 	/** @deprecated scheduled for removal from SDK */
 	getBlockLabel(blockId) {

package/dist/render/api.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"api.cjs","names":["TreeNodeAccessor","getCfgRenderCtx","deriveLabels","AnchoredIdDeriver","PColumnCollection","PColumnName","getService","ifDef","StagingAccessorName","MainAccessorName","patchInSetFilters","allPColumnsReady","getPluginData"],"sources":["../../src/render/api.ts"],"sourcesContent":["import type {\n  AnchoredPColumnSelector,\n  AnyFunction,\n  AxisId,\n  DataInfo,\n  ModelServices,\n  Option,\n  PColumn,\n  PColumnLazy,\n  PColumnSelector,\n  PColumnSpec,\n  PColumnValues,\n  PFrameDef,\n  PFrameHandle,\n  PObject,\n  PObjectId,\n  PObjectSpec,\n  PSpecPredicate,\n  PTableDef,\n  PTableDefV2,\n  PTableHandle,\n  PTableRecordFilter,\n  PTableSorting,\n  PlRef,\n  ResolveAnchorsOptions,\n  ResultCollection,\n  SUniversalPColumnId,\n  ValueOrError,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  AnchoredIdDeriver,\n  collectSpecQueryColumns,\n  ensurePColumn,\n  parseJson,\n  extractAllColumns,\n  isDataInfo,\n  isPColumn,\n  isPColumnSpec,\n  isPlRef,\n  mapDataInfo,\n  mapPObjectData,\n  mapPTableDef,\n  mapPTableDefV2,\n  mapValueInVOE,\n  PColumnName,\n  readAnnotation,\n  withEnrichments,\n  legacyColumnSelectorsToPredicate,\n} from \"@milaboratories/pl-model-common\";\nimport canonicalize from \"canonicalize\";\nimport type { Optional } from \"utility-types\";\nimport { getCfgRenderCtx } from \"../internal\";\nimport { getPluginData } from \"../block_storage\";\nimport type {\n  PluginHandle,\n  PluginFactoryLike,\n  InferFactoryData,\n  InferFactoryParams,\n} from \"../plugin_handle\";\nimport { TreeNodeAccessor, ifDef } from \"./accessor\";\nimport type { FutureRef } from \"./future\";\nimport type { AccessorHandle, GlobalCfgRenderCtx } from \"./internal\";\nimport { MainAccessorName, StagingAccessorName } from \"./internal\";\nimport {\n  PColumnCollection,\n  type AxisLabelProvider,\n  type ColumnProvider,\n} from \"./util/column_collection\";\nimport type { LabelDerivationOps } from \"./util/label\";\nimport { deriveLabels } from \"./util/label\";\nimport type { APColumnSelectorWithSplit } from \"./util/split_selectors\";\nimport { patchInSetFilters } from \"./util/pframe_upgraders\";\nimport { allPColumnsReady } from \"./util/pcolumn_data\";\nimport type { PColumnDataUniversal } from \"./internal\";\nimport { getService } from \"../services\";\n\n/**\n * Helper function to match domain objects\n * @param query Optional domain to match against\n * @param target Optional domain to match\n * @returns true if domains match, false otherwise\n */\nfunction matchDomain(query?: Record<string, string>, target?: Record<string, string>) {\n  if (query === undefined) return target === undefined;\n  if (target === undefined) return true;\n  for (const k in target) {\n    if (query[k] !== target[k]) return false;\n  }\n  return true;\n}\n\nexport type UniversalColumnOption = { label: string; value: SUniversalPColumnId };\n\n/**\n * Transforms PColumn data into the internal representation expected by the platform\n * @param data Data from a PColumn to transform\n * @returns Transformed data compatible with platform API\n */\nfunction transformPColumnData(\n  data: PColumn<PColumnDataUniversal> | PColumnLazy<PColumnDataUniversal>,\n): PColumn<PColumnValues | AccessorHandle | DataInfo<AccessorHandle>> {\n  return mapPObjectData(data, (d) => {\n    if (d instanceof TreeNodeAccessor) {\n      return d.handle;\n    } else if (isDataInfo(d)) {\n      return mapDataInfo(d, (accessor) => accessor.handle);\n    } else {\n      return d;\n    }\n  });\n}\n\ntype UniversalPColumnOpts = {\n  labelOps?: LabelDerivationOps;\n  dontWaitAllData?: boolean;\n  exclude?: AnchoredPColumnSelector | AnchoredPColumnSelector[];\n} & ResolveAnchorsOptions;\n\ntype GetOptionsOpts = {\n  /**\n   * If true, references returned by the method will contain `requireEnrichments` flag set to true.\n   * If this reference is added to the block's args, it will communicate to the platform that the block\n   * expects enrichments of the referenced block to be available in the context of the current block.\n   */\n  refsWithEnrichments?: boolean;\n  /**\n   * Label derivation options.\n   * If provided, it will be used to derive labels for the options.\n   * If not provided, labels will be derived using the default logic.\n   */\n  label?: ((spec: PObjectSpec, ref: PlRef) => string) | LabelDerivationOps;\n};\n\nexport class ResultPool implements ColumnProvider, AxisLabelProvider {\n  private readonly ctx: GlobalCfgRenderCtx = getCfgRenderCtx();\n\n  /**\n   * @deprecated use getOptions()\n   */\n  public calculateOptions(predicate: PSpecPredicate): Option[] {\n    return this.ctx.calculateOptions(predicate);\n  }\n\n  public getOptions(\n    predicateOrSelector: ((spec: PObjectSpec) => boolean) | PColumnSelector | PColumnSelector[],\n    opts?: GetOptionsOpts,\n  ): Option[];\n  /** @deprecated wrap label ops with { label: <...> } */\n  public getOptions(\n    predicateOrSelector: ((spec: PObjectSpec) => boolean) | PColumnSelector | PColumnSelector[],\n    label?: ((spec: PObjectSpec, ref: PlRef) => string) | LabelDerivationOps,\n  ): Option[];\n  public getOptions(\n    predicateOrSelector: ((spec: PObjectSpec) => boolean) | PColumnSelector | PColumnSelector[],\n    opts?: GetOptionsOpts | ((spec: PObjectSpec, ref: PlRef) => string) | LabelDerivationOps,\n  ): Option[] {\n    const predicate =\n      typeof predicateOrSelector === \"function\"\n        ? predicateOrSelector\n        : legacyColumnSelectorsToPredicate(predicateOrSelector);\n    const filtered = this.getSpecs().entries.filter((s) => predicate(s.obj));\n\n    let labelOps: LabelDerivationOps | ((spec: PObjectSpec, ref: PlRef) => string) = {};\n    let refsWithEnrichments: boolean = false;\n    if (typeof opts !== \"undefined\") {\n      if (typeof opts === \"function\") {\n        labelOps = opts;\n      } else if (typeof opts === \"object\") {\n        if (\"includeNativeLabel\" in opts || \"separator\" in opts || \"addLabelAsSuffix\" in opts) {\n          labelOps = opts;\n        } else {\n          opts = opts as GetOptionsOpts;\n          labelOps = opts.label ?? {};\n          refsWithEnrichments = opts.refsWithEnrichments ?? false;\n        }\n      }\n    }\n\n    if (typeof labelOps === \"object\")\n      return deriveLabels(filtered, (o) => o.obj, labelOps ?? {}).map(\n        ({ value: { ref }, label }) => ({\n          ref: withEnrichments(ref, refsWithEnrichments),\n          label,\n        }),\n      );\n    else\n      return filtered.map(({ ref, obj }) => ({\n        ref: withEnrichments(ref, refsWithEnrichments),\n        label: labelOps(obj, ref),\n      }));\n  }\n\n  public resolveAnchorCtx(\n    anchorsOrCtx: AnchoredIdDeriver | Record<string, PColumnSpec | PlRef>,\n  ): AnchoredIdDeriver | undefined {\n    if (anchorsOrCtx instanceof AnchoredIdDeriver) return anchorsOrCtx;\n    const resolvedAnchors: Record<string, PColumnSpec> = {};\n    for (const [key, value] of Object.entries(anchorsOrCtx)) {\n      if (isPlRef(value)) {\n        const resolvedSpec = this.getPColumnSpecByRef(value);\n        if (!resolvedSpec) return undefined;\n        resolvedAnchors[key] = resolvedSpec;\n      } else {\n        resolvedAnchors[key] = value;\n      }\n    }\n    return new AnchoredIdDeriver(resolvedAnchors);\n  }\n\n  /**\n   * Returns columns that match the provided anchors and selectors. It applies axis filters and label derivation.\n   *\n   * @param anchorsOrCtx - Anchor context for column selection (same as in getCanonicalOptions)\n   * @param predicateOrSelectors - Predicate or selectors for filtering columns (same as in getCanonicalOptions)\n   * @param opts - Optional configuration for label generation and data waiting\n   * @returns A PFrameHandle for the created PFrame, or undefined if any required data is missing\n   */\n  public getAnchoredPColumns(\n    anchorsOrCtx: AnchoredIdDeriver | Record<string, PColumnSpec | PlRef>,\n    predicateOrSelectors:\n      | ((spec: PColumnSpec) => boolean)\n      | APColumnSelectorWithSplit\n      | APColumnSelectorWithSplit[],\n    opts?: UniversalPColumnOpts,\n  ): PColumn<PColumnDataUniversal>[] | undefined {\n    const anchorCtx = this.resolveAnchorCtx(anchorsOrCtx);\n    if (!anchorCtx) return undefined;\n    return new PColumnCollection()\n      .addColumnProvider(this)\n      .addAxisLabelProvider(this)\n      .getColumns(predicateOrSelectors, {\n        ...opts,\n        anchorCtx,\n      });\n  }\n\n  /**\n   * Calculates anchored identifier options for columns matching a given predicate and returns their\n   * canonicalized representations.\n   *\n   * This function filters column specifications from the result pool that match the provided predicate,\n   * creates a standardized AnchorCtx from the provided anchors, and generates a list of label-value\n   * pairs for UI components (like dropdowns).\n   *\n   * @param anchorsOrCtx - Either:\n   *                     - An existing AnchorCtx instance\n   *                     - A record mapping anchor IDs to PColumnSpec objects\n   *                     - A record mapping anchor IDs to PlRef objects (which will be resolved to PColumnSpec)\n   * @param predicateOrSelectors - Either:\n   *                            - A predicate function that takes a PColumnSpec and returns a boolean.\n   *                              Only specs that return true will be included.\n   *                            - An APColumnSelector object for declarative filtering, which will be\n   *                              resolved against the provided anchors and matched using matchPColumn.\n   *                            - An array of APColumnSelector objects - columns matching ANY selector\n   *                              in the array will be included (OR operation).\n   * @param opts - Optional configuration for label generation:\n   *                 - labelOps: Optional configuration for label generation:\n   *                   - includeNativeLabel: Whether to include native column labels\n   *                   - separator: String to use between label parts (defaults to \" / \")\n   *                   - addLabelAsSuffix: Whether to add labels as suffix instead of prefix\n   *                 - dontWaitAllData: Whether to skip columns that don't have all data (if not set, will return undefined,\n   *                                    if at least one column that requires splitting is missing data)\n   * @returns An array of objects with `label` (display text) and `value` (anchored ID string) properties,\n   *          or undefined if any PlRef resolution fails.\n   */\n  getCanonicalOptions(\n    anchorsOrCtx: AnchoredIdDeriver | Record<string, PColumnSpec | PlRef>,\n    predicateOrSelectors:\n      | ((spec: PColumnSpec) => boolean)\n      | APColumnSelectorWithSplit\n      | APColumnSelectorWithSplit[],\n    opts?: UniversalPColumnOpts,\n  ): { label: string; value: SUniversalPColumnId }[] | undefined {\n    const anchorCtx = this.resolveAnchorCtx(anchorsOrCtx);\n    if (!anchorCtx) return undefined;\n    const entries = new PColumnCollection()\n      .addColumnProvider(this)\n      .addAxisLabelProvider(this)\n      .getUniversalEntries(predicateOrSelectors, {\n        ...opts,\n        anchorCtx,\n      });\n    if (!entries) return undefined;\n    return entries.map((item) => ({\n      value: item.id,\n      label: item.label,\n    }));\n  }\n\n  /**\n   * @deprecated use getData()\n   */\n  public getDataFromResultPool(): ResultCollection<PObject<TreeNodeAccessor>> {\n    return this.getData();\n  }\n\n  public getData(): ResultCollection<PObject<TreeNodeAccessor>> {\n    const result = this.ctx.getDataFromResultPool();\n    return {\n      isComplete: result.isComplete,\n      entries: result.entries.map((e) => ({\n        ref: e.ref,\n        obj: {\n          ...e.obj,\n          data: new TreeNodeAccessor(e.obj.data, [e.ref.blockId, e.ref.name]),\n        },\n      })),\n    };\n  }\n\n  /**\n   * @deprecated use getDataWithErrors()\n   */\n  public getDataWithErrorsFromResultPool(): ResultCollection<\n    Optional<PObject<ValueOrError<TreeNodeAccessor, Error>>, \"id\">\n  > {\n    return this.getDataWithErrors();\n  }\n\n  public getDataWithErrors(): ResultCollection<\n    Optional<PObject<ValueOrError<TreeNodeAccessor, Error>>, \"id\">\n  > {\n    const result = this.ctx.getDataWithErrorsFromResultPool();\n    return {\n      isComplete: result.isComplete,\n      entries: result.entries.map((e) => ({\n        ref: e.ref,\n        obj: {\n          ...e.obj,\n          data: mapValueInVOE(\n            e.obj.data,\n            (handle) => new TreeNodeAccessor(handle, [e.ref.blockId, e.ref.name]),\n          ),\n        },\n      })),\n    };\n  }\n\n  /**\n   * @deprecated use getSpecs()\n   */\n  public getSpecsFromResultPool(): ResultCollection<PObjectSpec> {\n    return this.getSpecs();\n  }\n\n  public getSpecs(): ResultCollection<PObjectSpec> {\n    return this.ctx.getSpecsFromResultPool();\n  }\n\n  /**\n   * @param ref a Ref\n   * @returns data associated with the ref\n   */\n  public getDataByRef(ref: PlRef): PObject<TreeNodeAccessor> | undefined {\n    // @TODO remove after 1 Jan 2025; forward compatibility\n    if (typeof this.ctx.getDataFromResultPoolByRef === \"undefined\")\n      return this.getData().entries.find(\n        (f) => f.ref.blockId === ref.blockId && f.ref.name === ref.name,\n      )?.obj;\n    const data = this.ctx.getDataFromResultPoolByRef(ref.blockId, ref.name); // Keep original call\n    // Need to handle undefined case before mapping\n    if (!data) return undefined;\n    return mapPObjectData(data, (handle) => new TreeNodeAccessor(handle, [ref.blockId, ref.name]));\n  }\n\n  /**\n   * Returns data associated with the ref ensuring that it is a p-column.\n   * @param ref a Ref\n   * @returns p-column associated with the ref\n   */\n  public getPColumnByRef(ref: PlRef): PColumn<TreeNodeAccessor> | undefined {\n    const data = this.getDataByRef(ref);\n    if (!data) return undefined;\n    return ensurePColumn(data);\n  }\n\n  /**\n   * Returns spec associated with the ref ensuring that it is a p-column spec.\n   * @param ref a Ref\n   * @returns p-column spec associated with the ref\n   */\n  public getPColumnSpecByRef(ref: PlRef): PColumnSpec | undefined {\n    const spec = this.getSpecByRef(ref);\n    if (!spec) return undefined;\n    if (!isPColumnSpec(spec)) throw new Error(`not a PColumn spec (kind = ${spec.kind})`);\n    return spec;\n  }\n\n  /**\n   * @param ref a Ref\n   * @returns object spec associated with the ref\n   */\n  public getSpecByRef(ref: PlRef): PObjectSpec | undefined {\n    return this.ctx.getSpecFromResultPoolByRef(ref.blockId, ref.name);\n  }\n\n  /**\n   * @param spec object specification\n   * @returns array of data objects with compatible specs\n   * @deprecated delete this method after Jan 1, 2025\n   */\n  public findDataWithCompatibleSpec(spec: PColumnSpec): PObject<TreeNodeAccessor>[] {\n    const result: PObject<TreeNodeAccessor>[] = [];\n\n    out: for (const data of this.getData().entries) {\n      if (!isPColumnSpec(data.obj.spec)) {\n        continue;\n      }\n\n      const oth = data.obj.spec;\n\n      if (spec.name !== oth.name) {\n        continue;\n      }\n\n      if (spec.valueType !== oth.valueType) {\n        continue;\n      }\n\n      if (spec.axesSpec.length !== oth.axesSpec.length) {\n        continue;\n      }\n\n      if (!matchDomain(spec.domain, oth.domain)) {\n        continue;\n      }\n\n      if (!matchDomain(spec.contextDomain, oth.contextDomain)) {\n        continue;\n      }\n\n      for (let i = 0; i < spec.axesSpec.length; ++i) {\n        const qAx = spec.axesSpec[i];\n        const tAx = oth.axesSpec[i];\n        if (qAx.name !== tAx.name) {\n          continue out;\n        }\n        if (qAx.type !== tAx.type) {\n          continue out;\n        }\n        if (!matchDomain(qAx.domain, tAx.domain)) {\n          continue out;\n        }\n        if (!matchDomain(qAx.contextDomain, tAx.contextDomain)) {\n          continue out;\n        }\n      }\n\n      result.push(data.obj);\n    }\n    return result;\n  }\n\n  /**\n   * Find labels data for a given axis id. It will search for a label column and return its data as a map.\n   * @returns a map of axis value => label\n   */\n  public findLabels(axis: AxisId): Record<string | number, string> | undefined {\n    const dataPool = this.getData();\n    for (const column of dataPool.entries) {\n      if (!isPColumn(column.obj)) continue;\n\n      const spec = column.obj.spec;\n      if (\n        spec.name === PColumnName.Label &&\n        spec.axesSpec.length === 1 &&\n        spec.axesSpec[0].name === axis.name &&\n        spec.axesSpec[0].type === axis.type &&\n        matchDomain(axis.domain, spec.axesSpec[0].domain) &&\n        matchDomain(axis.contextDomain, spec.axesSpec[0].contextDomain)\n      ) {\n        if (column.obj.data.resourceType.name !== \"PColumnData/Json\") {\n          throw Error(`Expected JSON column for labels, got: ${column.obj.data.resourceType.name}`);\n        }\n        const labels: Record<string | number, string> = Object.fromEntries(\n          Object.entries(\n            column.obj.data.getDataAsJson<{\n              data: Record<string | number, string>;\n            }>().data,\n          ).map((e) => [JSON.parse(e[0])[0], e[1]]),\n        );\n\n        return labels;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Selects columns based on the provided selectors, returning PColumn objects\n   * with lazily loaded data.\n   *\n   * @param selectors - A predicate function, a single selector, or an array of selectors.\n   * @returns An array of PColumn objects matching the selectors. Data is loaded on first access.\n   */\n  public selectColumns(\n    selectors: ((spec: PColumnSpec) => boolean) | PColumnSelector | PColumnSelector[],\n  ): PColumn<TreeNodeAccessor | undefined>[] {\n    const predicate =\n      typeof selectors === \"function\" ? selectors : legacyColumnSelectorsToPredicate(selectors);\n\n    const matchedSpecs = this.getSpecs().entries.filter(({ obj: spec }) => {\n      if (!isPColumnSpec(spec)) return false;\n      return predicate(spec);\n    });\n\n    // Map specs to PColumn objects with lazy data loading\n    return matchedSpecs.map(({ ref, obj: spec }) => {\n      // Type assertion needed because filter ensures it's PColumnSpec\n      const pcolumnSpec = spec as PColumnSpec;\n      let _cachedData: TreeNodeAccessor | undefined | null = null; // Use null to distinguish initial state from undefined result\n      // eslint-disable-next-line @typescript-eslint/no-this-alias\n      const self = this; // Capture 'this' for use inside the getter\n\n      return {\n        id: canonicalize(ref) as PObjectId,\n        spec: pcolumnSpec,\n        get data(): TreeNodeAccessor | undefined {\n          if (_cachedData !== null) {\n            return _cachedData; // Return cached data (could be undefined if fetch failed)\n          }\n\n          _cachedData = self.getPColumnByRef(ref)?.data;\n          return _cachedData;\n        },\n      } satisfies PColumn<TreeNodeAccessor | undefined>; // Cast needed because 'data' is a getter\n    });\n  }\n\n  /**\n   * Find labels data for a given axis id of a p-column.\n   * @returns a map of axis value => label\n   */\n  public findLabelsForColumnAxis(\n    column: PColumnSpec,\n    axisIdx: number,\n  ): Record<string | number, string> | undefined {\n    const labels = this.findLabels(column.axesSpec[axisIdx]);\n    if (!labels) return undefined;\n    const axisKeys = readAnnotation(column, `pl7.app/axisKeys/${axisIdx}`);\n    if (axisKeys !== undefined) {\n      const keys = JSON.parse(axisKeys) as string[];\n      return Object.fromEntries(\n        keys.map((key) => {\n          return [key, labels[key] ?? \"Unlabelled\"];\n        }),\n      );\n    } else {\n      return labels;\n    }\n  }\n}\n\n/** Main entry point to the API available within model lambdas (like outputs, sections, etc..) */\nexport abstract class RenderCtxBase<Args = unknown, Data = unknown> {\n  protected readonly ctx: GlobalCfgRenderCtx;\n\n  constructor() {\n    this.ctx = getCfgRenderCtx();\n  }\n\n  private dataCache?: { v: Data };\n\n  public get data(): Data {\n    if (this.dataCache === undefined) {\n      const raw = this.ctx.data;\n      const value = typeof raw === \"function\" ? raw() : raw;\n      this.dataCache = { v: value ? JSON.parse(value) : ({} as Data) };\n    }\n    return this.dataCache.v;\n  }\n\n  // lazy rendering because this feature is rarely used\n  private activeArgsCache?: { v?: Args };\n\n  /**\n   * Returns args snapshot the block was executed for (i.e. when \"Run\" button was pressed).\n   * Returns undefined, if block was never executed or stopped mid-way execution, so that the result was cleared.\n   * */\n  public get activeArgs(): Args | undefined {\n    if (this.activeArgsCache === undefined) {\n      const raw = this.ctx.activeArgs;\n      const value = typeof raw === \"function\" ? raw() : raw;\n      this.activeArgsCache = {\n        v: value ? JSON.parse(value) : undefined,\n      };\n    }\n    return this.activeArgsCache.v;\n  }\n\n  public getService<T extends keyof ModelServices>(name: T): ModelServices[T] {\n    return getService(name);\n  }\n\n  // /** Can be used to determine features provided by the desktop instance. */\n  // public get featureFlags() {\n  //   return this.ctx.featureFlags;\n  // }\n\n  private getNamedAccessor(name: string): TreeNodeAccessor | undefined {\n    return ifDef(\n      this.ctx.getAccessorHandleByName(name),\n      (accessor) => new TreeNodeAccessor(accessor, [name]),\n    );\n  }\n\n  public get prerun(): TreeNodeAccessor | undefined {\n    return this.getNamedAccessor(StagingAccessorName);\n  }\n\n  public get outputs(): TreeNodeAccessor | undefined {\n    return this.getNamedAccessor(MainAccessorName);\n  }\n\n  public readonly resultPool = new ResultPool();\n\n  /**\n   * Find labels data for a given axis id. It will search for a label column and return its data as a map.\n   * @returns a map of axis value => label\n   * @deprecated Use resultPool.findLabels instead\n   */\n  public findLabels(axis: AxisId): Record<string | number, string> | undefined {\n    return this.resultPool.findLabels(axis);\n  }\n\n  private verifyInlineAndExplicitColumnsSupport(\n    columns: (PColumn<PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>)[],\n  ) {\n    const hasInlineColumns = columns.some(\n      (c) => !(c.data instanceof TreeNodeAccessor) || isDataInfo(c.data),\n    ); // Updated check for DataInfo\n    const inlineColumnsSupport = this.ctx.featureFlags?.inlineColumnsSupport === true;\n    if (hasInlineColumns && !inlineColumnsSupport)\n      throw Error(`Inline or explicit columns not supported`); // Combined check\n\n    // Removed redundant explicitColumns check\n  }\n\n  private patchPTableDef(\n    def: PTableDef<PColumn<PColumnDataUniversal>>,\n  ): PTableDef<PColumn<PColumnDataUniversal>> {\n    if (!this.ctx.featureFlags?.pTablePartitionFiltersSupport) {\n      // For old desktop move all partition filters to filters field as it doesn't read partitionFilters field\n      def = {\n        ...def,\n        partitionFilters: [],\n        filters: [...def.partitionFilters, ...def.filters],\n      };\n    }\n    if (!this.ctx.featureFlags?.pFrameInSetFilterSupport) {\n      def = {\n        ...def,\n        partitionFilters: patchInSetFilters(def.partitionFilters),\n        filters: patchInSetFilters(def.filters),\n      };\n    }\n    return def;\n  }\n\n  // TODO remove all non-PColumn fields\n  public createPFrame(\n    def: PFrameDef<\n      PColumn<undefined | PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>\n    >,\n  ): PFrameHandle | undefined {\n    if (!allPColumnsReady(def)) return undefined;\n    this.verifyInlineAndExplicitColumnsSupport(def);\n    return this.ctx.createPFrame(def.map((c) => transformPColumnData(c)));\n  }\n\n  // TODO remove all non-PColumn fields\n  public createPTable(def: PTableDef<PColumn<PColumnDataUniversal>>): PTableHandle | undefined;\n  public createPTable(def: {\n    columns: PColumn<PColumnDataUniversal>[];\n    filters?: PTableRecordFilter[];\n    /** Table sorting */\n    sorting?: PTableSorting[];\n  }): PTableHandle | undefined;\n  public createPTable(\n    def:\n      | PTableDef<PColumn<PColumnDataUniversal>>\n      | {\n          columns: PColumn<PColumnDataUniversal>[];\n          filters?: PTableRecordFilter[];\n          /** Table sorting */\n          sorting?: PTableSorting[];\n        },\n  ): PTableHandle | undefined {\n    let rawDef: PTableDef<PColumn<PColumnDataUniversal>>;\n    if (\"columns\" in def) {\n      rawDef = this.patchPTableDef({\n        src: {\n          type: \"full\",\n          entries: def.columns.map((c) => ({ type: \"column\", column: c })),\n        },\n        partitionFilters: def.filters ?? [],\n        filters: [],\n        sorting: def.sorting ?? [],\n      });\n    } else {\n      rawDef = this.patchPTableDef(def);\n    }\n    const columns = extractAllColumns(rawDef.src);\n    this.verifyInlineAndExplicitColumnsSupport(columns);\n    if (!allPColumnsReady(columns)) return undefined;\n    return this.ctx.createPTable(mapPTableDef(rawDef, (po) => transformPColumnData(po)));\n  }\n\n  public createPTableV2(\n    def: PTableDefV2<PColumn<undefined | PColumnDataUniversal>>,\n  ): PTableHandle | undefined {\n    const columns = collectSpecQueryColumns(def.query);\n    if (!allPColumnsReady(columns)) return undefined;\n    this.verifyInlineAndExplicitColumnsSupport(columns);\n    return this.ctx.createPTableV2(\n      mapPTableDefV2(def, (po) => {\n        if (po.data === undefined)\n          throw new Error(\"unreachable: column data undefined after readiness check\");\n        return transformPColumnData({ id: po.id, spec: po.spec, data: po.data });\n      }),\n    );\n  }\n\n  /** @deprecated scheduled for removal from SDK */\n  public getBlockLabel(blockId: string): string {\n    return this.ctx.getBlockLabel(blockId);\n  }\n\n  public getCurrentUnstableMarker(): string | undefined {\n    return this.ctx.getCurrentUnstableMarker();\n  }\n\n  public logInfo(msg: string): void {\n    this.ctx.logInfo(msg);\n  }\n\n  public logWarn(msg: string): void {\n    this.ctx.logWarn(msg);\n  }\n\n  public logError(msg: string): void {\n    this.ctx.logError(msg);\n  }\n}\n\n/** Main entry point to the API available within model lambdas (like outputs, sections, etc..) for v3+ blocks */\nexport class BlockRenderCtx<Args = unknown, Data = unknown> extends RenderCtxBase<Args, Data> {\n  private argsCache?: { v: Args | undefined };\n  public get args(): Args | undefined {\n    if (this.argsCache === undefined) {\n      const raw = this.ctx.args;\n      const value = typeof raw === \"function\" ? raw() : raw;\n      this.argsCache = { v: value === undefined ? undefined : JSON.parse(value) };\n    }\n    return this.argsCache.v;\n  }\n}\n\n/** Render context for legacy v1/v2 blocks - provides backward compatibility */\nexport class RenderCtxLegacy<Args = unknown, UiState = unknown> extends RenderCtxBase<\n  Args,\n  UiState\n> {\n  private argsCache?: { v: Args };\n\n  public get args(): Args {\n    if (this.argsCache === undefined) {\n      const raw = this.ctx.args;\n      const value = typeof raw === \"function\" ? raw() : raw;\n      this.argsCache = { v: JSON.parse(value) };\n    }\n    return this.argsCache.v;\n  }\n\n  private uiStateCache?: { v: UiState };\n\n  public get uiState(): UiState {\n    if (this.uiStateCache === undefined) {\n      const raw = this.ctx.uiState!;\n      const value = typeof raw === \"function\" ? raw() : raw;\n      this.uiStateCache = { v: value ? JSON.parse(value) : ({} as UiState) };\n    }\n    return this.uiStateCache.v;\n  }\n}\n\n/**\n * Render context for plugin output functions.\n * Reads plugin data from blockStorage and derives params from pre-wrapped input callbacks.\n *\n * Parameterized on the factory-like phantom F so that getPluginData returns\n * InferFactoryData<F> directly — no casts needed for the data getter.\n *\n * @typeParam F - PluginFactoryLike phantom carrying data/params/outputs types\n */\nexport class PluginRenderCtx<F extends PluginFactoryLike = PluginFactoryLike> extends RenderCtxBase<\n  unknown,\n  InferFactoryData<F>\n> {\n  private readonly handle: PluginHandle<F>;\n  private readonly wrappedInputs: Record<string, () => unknown>;\n\n  constructor(handle: PluginHandle<F>, wrappedInputs: Record<string, () => unknown>) {\n    super();\n    this.handle = handle;\n    this.wrappedInputs = wrappedInputs;\n  }\n\n  private pluginDataCache?: { v: InferFactoryData<F> };\n\n  /** Plugin's persistent data from blockStorage.__plugins.{pluginId}.__data */\n  public override get data(): InferFactoryData<F> {\n    if (this.pluginDataCache === undefined) {\n      const raw = this.ctx.blockStorage();\n      this.pluginDataCache = { v: getPluginData(parseJson(raw), this.handle) };\n    }\n    return this.pluginDataCache.v;\n  }\n\n  private paramsCache?: { v: InferFactoryParams<F> };\n\n  /** Params derived from block context via pre-wrapped input callbacks */\n  public get params(): InferFactoryParams<F> {\n    if (this.paramsCache === undefined) {\n      const result: Record<string, unknown> = {};\n      for (const [key, fn] of Object.entries(this.wrappedInputs)) {\n        result[key] = fn();\n      }\n      this.paramsCache = { v: result as InferFactoryParams<F> };\n    }\n    return this.paramsCache.v;\n  }\n}\n\n/** @deprecated Use BlockRenderCtx instead */\nexport type RenderCtx<Args = unknown, Data = unknown> = BlockRenderCtx<Args, Data>;\n\nexport type RenderFunction<Args = unknown, State = unknown, Ret = unknown> = (\n  rCtx: BlockRenderCtx<Args, State>,\n) => Ret;\n\nexport type RenderFunctionLegacy<Args = unknown, State = unknown, Ret = unknown> = (\n  rCtx: RenderCtxLegacy<Args, State>,\n) => Ret;\n\nexport type UnwrapFutureRef<K> =\n  K extends FutureRef<infer T>\n    ? T\n    : K extends bigint | boolean | null | number | string | symbol | undefined\n      ? K\n      : { [key in keyof K]: UnwrapFutureRef<K[key]> };\n\nexport type InferRenderFunctionReturn<RF extends AnyFunction> = RF extends (...args: any) => infer R\n  ? UnwrapFutureRef<R>\n  : never;\n"],"mappings":"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"}
+{"version":3,"file":"api.cjs","names":["TreeNodeAccessor","getCfgRenderCtx","deriveLabels","AnchoredIdDeriver","PColumnCollection","PColumnName","getService","ifDef","StagingAccessorName","MainAccessorName","patchInSetFilters","allPColumnsReady","getPluginData"],"sources":["../../src/render/api.ts"],"sourcesContent":["import type {\n  AnchoredPColumnSelector,\n  AnyFunction,\n  AxisId,\n  DataInfo,\n  ModelServices,\n  Option,\n  PColumn,\n  PColumnLazy,\n  PColumnSelector,\n  PColumnSpec,\n  PColumnValues,\n  PFrameDef,\n  PFrameHandle,\n  PObject,\n  PObjectId,\n  PObjectSpec,\n  PSpecPredicate,\n  PTableDef,\n  PTableDefV2,\n  PTableHandle,\n  PTableRecordFilter,\n  PTableSorting,\n  PlRef,\n  ResolveAnchorsOptions,\n  ResultCollection,\n  SUniversalPColumnId,\n  ValueOrError,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  AnchoredIdDeriver,\n  ensurePColumn,\n  parseJson,\n  isDataInfo,\n  isPColumn,\n  isPColumnSpec,\n  isPlRef,\n  mapDataInfo,\n  mapPObjectData,\n  mapPTableDef,\n  mapPTableDefV2,\n  mapValueInVOE,\n  PColumnName,\n  readAnnotation,\n  withEnrichments,\n  legacyColumnSelectorsToPredicate,\n  extractAllColumns,\n} from \"@milaboratories/pl-model-common\";\nimport canonicalize from \"canonicalize\";\nimport type { Optional } from \"utility-types\";\nimport { getCfgRenderCtx } from \"../internal\";\nimport { getPluginData } from \"../block_storage\";\nimport type {\n  PluginHandle,\n  PluginFactoryLike,\n  InferFactoryData,\n  InferFactoryParams,\n} from \"../plugin_handle\";\nimport { TreeNodeAccessor, ifDef } from \"./accessor\";\nimport type { FutureRef } from \"./future\";\nimport type { AccessorHandle, GlobalCfgRenderCtx } from \"./internal\";\nimport { MainAccessorName, StagingAccessorName } from \"./internal\";\nimport {\n  PColumnCollection,\n  type AxisLabelProvider,\n  type ColumnProvider,\n} from \"./util/column_collection\";\nimport type { LabelDerivationOps } from \"./util/label\";\nimport { deriveLabels } from \"./util/label\";\nimport type { APColumnSelectorWithSplit } from \"./util/split_selectors\";\nimport { patchInSetFilters } from \"./util/pframe_upgraders\";\nimport type { PColumnDataUniversal } from \"./internal\";\nimport { getService } from \"../services\";\nimport { allPColumnsReady } from \"./util\";\n\n/**\n * Helper function to match domain objects\n * @param query Optional domain to match against\n * @param target Optional domain to match\n * @returns true if domains match, false otherwise\n */\nfunction matchDomain(query?: Record<string, string>, target?: Record<string, string>) {\n  if (query === undefined) return target === undefined;\n  if (target === undefined) return true;\n  for (const k in target) {\n    if (query[k] !== target[k]) return false;\n  }\n  return true;\n}\n\nexport type UniversalColumnOption = { label: string; value: SUniversalPColumnId };\n\n/**\n * Transforms PColumn data into the internal representation expected by the platform\n * @param data Data from a PColumn to transform\n * @returns Transformed data compatible with platform API\n */\nfunction transformPColumnData(\n  data: PColumn<undefined | PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>,\n): PColumn<PColumnValues | AccessorHandle | DataInfo<AccessorHandle>> {\n  return mapPObjectData(data, (d) => {\n    if (d instanceof TreeNodeAccessor) {\n      return d.handle;\n    } else if (isDataInfo(d)) {\n      return mapDataInfo(d, (accessor) => accessor.handle);\n    } else {\n      return d ?? [];\n    }\n  });\n}\n\ntype UniversalPColumnOpts = {\n  labelOps?: LabelDerivationOps;\n  dontWaitAllData?: boolean;\n  exclude?: AnchoredPColumnSelector | AnchoredPColumnSelector[];\n} & ResolveAnchorsOptions;\n\ntype GetOptionsOpts = {\n  /**\n   * If true, references returned by the method will contain `requireEnrichments` flag set to true.\n   * If this reference is added to the block's args, it will communicate to the platform that the block\n   * expects enrichments of the referenced block to be available in the context of the current block.\n   */\n  refsWithEnrichments?: boolean;\n  /**\n   * Label derivation options.\n   * If provided, it will be used to derive labels for the options.\n   * If not provided, labels will be derived using the default logic.\n   */\n  label?: ((spec: PObjectSpec, ref: PlRef) => string) | LabelDerivationOps;\n};\n\nexport class ResultPool implements ColumnProvider, AxisLabelProvider {\n  private readonly ctx: GlobalCfgRenderCtx = getCfgRenderCtx();\n\n  /**\n   * @deprecated use getOptions()\n   */\n  public calculateOptions(predicate: PSpecPredicate): Option[] {\n    return this.ctx.calculateOptions(predicate);\n  }\n\n  public getOptions(\n    predicateOrSelector: ((spec: PObjectSpec) => boolean) | PColumnSelector | PColumnSelector[],\n    opts?: GetOptionsOpts,\n  ): Option[];\n  /** @deprecated wrap label ops with { label: <...> } */\n  public getOptions(\n    predicateOrSelector: ((spec: PObjectSpec) => boolean) | PColumnSelector | PColumnSelector[],\n    label?: ((spec: PObjectSpec, ref: PlRef) => string) | LabelDerivationOps,\n  ): Option[];\n  public getOptions(\n    predicateOrSelector: ((spec: PObjectSpec) => boolean) | PColumnSelector | PColumnSelector[],\n    opts?: GetOptionsOpts | ((spec: PObjectSpec, ref: PlRef) => string) | LabelDerivationOps,\n  ): Option[] {\n    const predicate =\n      typeof predicateOrSelector === \"function\"\n        ? predicateOrSelector\n        : legacyColumnSelectorsToPredicate(predicateOrSelector);\n    const filtered = this.getSpecs().entries.filter((s) => predicate(s.obj));\n\n    let labelOps: LabelDerivationOps | ((spec: PObjectSpec, ref: PlRef) => string) = {};\n    let refsWithEnrichments: boolean = false;\n    if (typeof opts !== \"undefined\") {\n      if (typeof opts === \"function\") {\n        labelOps = opts;\n      } else if (typeof opts === \"object\") {\n        if (\"includeNativeLabel\" in opts || \"separator\" in opts || \"addLabelAsSuffix\" in opts) {\n          labelOps = opts;\n        } else {\n          opts = opts as GetOptionsOpts;\n          labelOps = opts.label ?? {};\n          refsWithEnrichments = opts.refsWithEnrichments ?? false;\n        }\n      }\n    }\n\n    if (typeof labelOps === \"object\")\n      return deriveLabels(filtered, (o) => o.obj, labelOps ?? {}).map(\n        ({ value: { ref }, label }) => ({\n          ref: withEnrichments(ref, refsWithEnrichments),\n          label,\n        }),\n      );\n    else\n      return filtered.map(({ ref, obj }) => ({\n        ref: withEnrichments(ref, refsWithEnrichments),\n        label: labelOps(obj, ref),\n      }));\n  }\n\n  public resolveAnchorCtx(\n    anchorsOrCtx: AnchoredIdDeriver | Record<string, PColumnSpec | PlRef>,\n  ): AnchoredIdDeriver | undefined {\n    if (anchorsOrCtx instanceof AnchoredIdDeriver) return anchorsOrCtx;\n    const resolvedAnchors: Record<string, PColumnSpec> = {};\n    for (const [key, value] of Object.entries(anchorsOrCtx)) {\n      if (isPlRef(value)) {\n        const resolvedSpec = this.getPColumnSpecByRef(value);\n        if (!resolvedSpec) return undefined;\n        resolvedAnchors[key] = resolvedSpec;\n      } else {\n        resolvedAnchors[key] = value;\n      }\n    }\n    return new AnchoredIdDeriver(resolvedAnchors);\n  }\n\n  /**\n   * Returns columns that match the provided anchors and selectors. It applies axis filters and label derivation.\n   *\n   * @param anchorsOrCtx - Anchor context for column selection (same as in getCanonicalOptions)\n   * @param predicateOrSelectors - Predicate or selectors for filtering columns (same as in getCanonicalOptions)\n   * @param opts - Optional configuration for label generation and data waiting\n   * @returns A PFrameHandle for the created PFrame, or undefined if any required data is missing\n   */\n  public getAnchoredPColumns(\n    anchorsOrCtx: AnchoredIdDeriver | Record<string, PColumnSpec | PlRef>,\n    predicateOrSelectors:\n      | ((spec: PColumnSpec) => boolean)\n      | APColumnSelectorWithSplit\n      | APColumnSelectorWithSplit[],\n    opts?: UniversalPColumnOpts,\n  ): PColumn<PColumnDataUniversal>[] | undefined {\n    const anchorCtx = this.resolveAnchorCtx(anchorsOrCtx);\n    if (!anchorCtx) return undefined;\n    return new PColumnCollection()\n      .addColumnProvider(this)\n      .addAxisLabelProvider(this)\n      .getColumns(predicateOrSelectors, {\n        ...opts,\n        anchorCtx,\n      });\n  }\n\n  /**\n   * Calculates anchored identifier options for columns matching a given predicate and returns their\n   * canonicalized representations.\n   *\n   * This function filters column specifications from the result pool that match the provided predicate,\n   * creates a standardized AnchorCtx from the provided anchors, and generates a list of label-value\n   * pairs for UI components (like dropdowns).\n   *\n   * @param anchorsOrCtx - Either:\n   *                     - An existing AnchorCtx instance\n   *                     - A record mapping anchor IDs to PColumnSpec objects\n   *                     - A record mapping anchor IDs to PlRef objects (which will be resolved to PColumnSpec)\n   * @param predicateOrSelectors - Either:\n   *                            - A predicate function that takes a PColumnSpec and returns a boolean.\n   *                              Only specs that return true will be included.\n   *                            - An APColumnSelector object for declarative filtering, which will be\n   *                              resolved against the provided anchors and matched using matchPColumn.\n   *                            - An array of APColumnSelector objects - columns matching ANY selector\n   *                              in the array will be included (OR operation).\n   * @param opts - Optional configuration for label generation:\n   *                 - labelOps: Optional configuration for label generation:\n   *                   - includeNativeLabel: Whether to include native column labels\n   *                   - separator: String to use between label parts (defaults to \" / \")\n   *                   - addLabelAsSuffix: Whether to add labels as suffix instead of prefix\n   *                 - dontWaitAllData: Whether to skip columns that don't have all data (if not set, will return undefined,\n   *                                    if at least one column that requires splitting is missing data)\n   * @returns An array of objects with `label` (display text) and `value` (anchored ID string) properties,\n   *          or undefined if any PlRef resolution fails.\n   */\n  getCanonicalOptions(\n    anchorsOrCtx: AnchoredIdDeriver | Record<string, PColumnSpec | PlRef>,\n    predicateOrSelectors:\n      | ((spec: PColumnSpec) => boolean)\n      | APColumnSelectorWithSplit\n      | APColumnSelectorWithSplit[],\n    opts?: UniversalPColumnOpts,\n  ): { label: string; value: SUniversalPColumnId }[] | undefined {\n    const anchorCtx = this.resolveAnchorCtx(anchorsOrCtx);\n    if (!anchorCtx) return undefined;\n    const entries = new PColumnCollection()\n      .addColumnProvider(this)\n      .addAxisLabelProvider(this)\n      .getUniversalEntries(predicateOrSelectors, {\n        ...opts,\n        anchorCtx,\n      });\n    if (!entries) return undefined;\n    return entries.map((item) => ({\n      value: item.id,\n      label: item.label,\n    }));\n  }\n\n  /**\n   * @deprecated use getData()\n   */\n  public getDataFromResultPool(): ResultCollection<PObject<TreeNodeAccessor>> {\n    return this.getData();\n  }\n\n  public getData(): ResultCollection<PObject<TreeNodeAccessor>> {\n    const result = this.ctx.getDataFromResultPool();\n    return {\n      isComplete: result.isComplete,\n      entries: result.entries.map((e) => ({\n        ref: e.ref,\n        obj: {\n          ...e.obj,\n          data: new TreeNodeAccessor(e.obj.data, [e.ref.blockId, e.ref.name]),\n        },\n      })),\n    };\n  }\n\n  /**\n   * @deprecated use getDataWithErrors()\n   */\n  public getDataWithErrorsFromResultPool(): ResultCollection<\n    Optional<PObject<ValueOrError<TreeNodeAccessor, Error>>, \"id\">\n  > {\n    return this.getDataWithErrors();\n  }\n\n  public getDataWithErrors(): ResultCollection<\n    Optional<PObject<ValueOrError<TreeNodeAccessor, Error>>, \"id\">\n  > {\n    const result = this.ctx.getDataWithErrorsFromResultPool();\n    return {\n      isComplete: result.isComplete,\n      entries: result.entries.map((e) => ({\n        ref: e.ref,\n        obj: {\n          ...e.obj,\n          data: mapValueInVOE(\n            e.obj.data,\n            (handle) => new TreeNodeAccessor(handle, [e.ref.blockId, e.ref.name]),\n          ),\n        },\n      })),\n    };\n  }\n\n  /**\n   * @deprecated use getSpecs()\n   */\n  public getSpecsFromResultPool(): ResultCollection<PObjectSpec> {\n    return this.getSpecs();\n  }\n\n  public getSpecs(): ResultCollection<PObjectSpec> {\n    return this.ctx.getSpecsFromResultPool();\n  }\n\n  /**\n   * @param ref a Ref\n   * @returns data associated with the ref\n   */\n  public getDataByRef(ref: PlRef): PObject<TreeNodeAccessor> | undefined {\n    // @TODO remove after 1 Jan 2025; forward compatibility\n    if (typeof this.ctx.getDataFromResultPoolByRef === \"undefined\")\n      return this.getData().entries.find(\n        (f) => f.ref.blockId === ref.blockId && f.ref.name === ref.name,\n      )?.obj;\n    const data = this.ctx.getDataFromResultPoolByRef(ref.blockId, ref.name); // Keep original call\n    // Need to handle undefined case before mapping\n    if (!data) return undefined;\n    return mapPObjectData(data, (handle) => new TreeNodeAccessor(handle, [ref.blockId, ref.name]));\n  }\n\n  /**\n   * Returns data associated with the ref ensuring that it is a p-column.\n   * @param ref a Ref\n   * @returns p-column associated with the ref\n   */\n  public getPColumnByRef(ref: PlRef): PColumn<TreeNodeAccessor> | undefined {\n    const data = this.getDataByRef(ref);\n    if (!data) return undefined;\n    return ensurePColumn(data);\n  }\n\n  /**\n   * Returns spec associated with the ref ensuring that it is a p-column spec.\n   * @param ref a Ref\n   * @returns p-column spec associated with the ref\n   */\n  public getPColumnSpecByRef(ref: PlRef): PColumnSpec | undefined {\n    const spec = this.getSpecByRef(ref);\n    if (!spec) return undefined;\n    if (!isPColumnSpec(spec)) throw new Error(`not a PColumn spec (kind = ${spec.kind})`);\n    return spec;\n  }\n\n  /**\n   * @param ref a Ref\n   * @returns object spec associated with the ref\n   */\n  public getSpecByRef(ref: PlRef): PObjectSpec | undefined {\n    return this.ctx.getSpecFromResultPoolByRef(ref.blockId, ref.name);\n  }\n\n  /**\n   * @param spec object specification\n   * @returns array of data objects with compatible specs\n   * @deprecated delete this method after Jan 1, 2025\n   */\n  public findDataWithCompatibleSpec(spec: PColumnSpec): PObject<TreeNodeAccessor>[] {\n    const result: PObject<TreeNodeAccessor>[] = [];\n\n    out: for (const data of this.getData().entries) {\n      if (!isPColumnSpec(data.obj.spec)) {\n        continue;\n      }\n\n      const oth = data.obj.spec;\n\n      if (spec.name !== oth.name) {\n        continue;\n      }\n\n      if (spec.valueType !== oth.valueType) {\n        continue;\n      }\n\n      if (spec.axesSpec.length !== oth.axesSpec.length) {\n        continue;\n      }\n\n      if (!matchDomain(spec.domain, oth.domain)) {\n        continue;\n      }\n\n      if (!matchDomain(spec.contextDomain, oth.contextDomain)) {\n        continue;\n      }\n\n      for (let i = 0; i < spec.axesSpec.length; ++i) {\n        const qAx = spec.axesSpec[i];\n        const tAx = oth.axesSpec[i];\n        if (qAx.name !== tAx.name) {\n          continue out;\n        }\n        if (qAx.type !== tAx.type) {\n          continue out;\n        }\n        if (!matchDomain(qAx.domain, tAx.domain)) {\n          continue out;\n        }\n        if (!matchDomain(qAx.contextDomain, tAx.contextDomain)) {\n          continue out;\n        }\n      }\n\n      result.push(data.obj);\n    }\n    return result;\n  }\n\n  /**\n   * Find labels data for a given axis id. It will search for a label column and return its data as a map.\n   * @returns a map of axis value => label\n   */\n  public findLabels(axis: AxisId): Record<string | number, string> | undefined {\n    const dataPool = this.getData();\n    for (const column of dataPool.entries) {\n      if (!isPColumn(column.obj)) continue;\n\n      const spec = column.obj.spec;\n      if (\n        spec.name === PColumnName.Label &&\n        spec.axesSpec.length === 1 &&\n        spec.axesSpec[0].name === axis.name &&\n        spec.axesSpec[0].type === axis.type &&\n        matchDomain(axis.domain, spec.axesSpec[0].domain) &&\n        matchDomain(axis.contextDomain, spec.axesSpec[0].contextDomain)\n      ) {\n        if (column.obj.data.resourceType.name !== \"PColumnData/Json\") {\n          throw Error(`Expected JSON column for labels, got: ${column.obj.data.resourceType.name}`);\n        }\n        const labels: Record<string | number, string> = Object.fromEntries(\n          Object.entries(\n            column.obj.data.getDataAsJson<{\n              data: Record<string | number, string>;\n            }>().data,\n          ).map((e) => [JSON.parse(e[0])[0], e[1]]),\n        );\n\n        return labels;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Selects columns based on the provided selectors, returning PColumn objects\n   * with lazily loaded data.\n   *\n   * @param selectors - A predicate function, a single selector, or an array of selectors.\n   * @returns An array of PColumn objects matching the selectors. Data is loaded on first access.\n   */\n  public selectColumns(\n    selectors: ((spec: PColumnSpec) => boolean) | PColumnSelector | PColumnSelector[],\n  ): PColumn<TreeNodeAccessor | undefined>[] {\n    const predicate =\n      typeof selectors === \"function\" ? selectors : legacyColumnSelectorsToPredicate(selectors);\n\n    const matchedSpecs = this.getSpecs().entries.filter(({ obj: spec }) => {\n      if (!isPColumnSpec(spec)) return false;\n      return predicate(spec);\n    });\n\n    // Map specs to PColumn objects with lazy data loading\n    return matchedSpecs.map(({ ref, obj: spec }) => {\n      // Type assertion needed because filter ensures it's PColumnSpec\n      const pcolumnSpec = spec as PColumnSpec;\n      let _cachedData: TreeNodeAccessor | undefined | null = null; // Use null to distinguish initial state from undefined result\n      // eslint-disable-next-line @typescript-eslint/no-this-alias\n      const self = this; // Capture 'this' for use inside the getter\n\n      return {\n        id: canonicalize(ref) as PObjectId,\n        spec: pcolumnSpec,\n        get data(): TreeNodeAccessor | undefined {\n          if (_cachedData !== null) {\n            return _cachedData; // Return cached data (could be undefined if fetch failed)\n          }\n\n          _cachedData = self.getPColumnByRef(ref)?.data;\n          return _cachedData;\n        },\n      } satisfies PColumn<TreeNodeAccessor | undefined>; // Cast needed because 'data' is a getter\n    });\n  }\n\n  /**\n   * Find labels data for a given axis id of a p-column.\n   * @returns a map of axis value => label\n   */\n  public findLabelsForColumnAxis(\n    column: PColumnSpec,\n    axisIdx: number,\n  ): Record<string | number, string> | undefined {\n    const labels = this.findLabels(column.axesSpec[axisIdx]);\n    if (!labels) return undefined;\n    const axisKeys = readAnnotation(column, `pl7.app/axisKeys/${axisIdx}`);\n    if (axisKeys !== undefined) {\n      const keys = JSON.parse(axisKeys) as string[];\n      return Object.fromEntries(\n        keys.map((key) => {\n          return [key, labels[key] ?? \"Unlabelled\"];\n        }),\n      );\n    } else {\n      return labels;\n    }\n  }\n}\n\n/** Main entry point to the API available within model lambdas (like outputs, sections, etc..) */\nexport abstract class RenderCtxBase<Args = unknown, Data = unknown> {\n  protected readonly ctx: GlobalCfgRenderCtx;\n\n  constructor() {\n    this.ctx = getCfgRenderCtx();\n  }\n\n  private dataCache?: { v: Data };\n\n  public get data(): Data {\n    if (this.dataCache === undefined) {\n      const raw = this.ctx.data;\n      const value = typeof raw === \"function\" ? raw() : raw;\n      this.dataCache = { v: value ? JSON.parse(value) : ({} as Data) };\n    }\n    return this.dataCache.v;\n  }\n\n  // lazy rendering because this feature is rarely used\n  private activeArgsCache?: { v?: Args };\n\n  /**\n   * Returns args snapshot the block was executed for (i.e. when \"Run\" button was pressed).\n   * Returns undefined, if block was never executed or stopped mid-way execution, so that the result was cleared.\n   * */\n  public get activeArgs(): Args | undefined {\n    if (this.activeArgsCache === undefined) {\n      const raw = this.ctx.activeArgs;\n      const value = typeof raw === \"function\" ? raw() : raw;\n      this.activeArgsCache = {\n        v: value ? JSON.parse(value) : undefined,\n      };\n    }\n    return this.activeArgsCache.v;\n  }\n\n  public getService<T extends keyof ModelServices>(name: T): ModelServices[T] {\n    return getService(name);\n  }\n\n  // /** Can be used to determine features provided by the desktop instance. */\n  // public get featureFlags() {\n  //   return this.ctx.featureFlags;\n  // }\n\n  private getNamedAccessor(name: string): TreeNodeAccessor | undefined {\n    return ifDef(\n      this.ctx.getAccessorHandleByName(name),\n      (accessor) => new TreeNodeAccessor(accessor, [name]),\n    );\n  }\n\n  public get prerun(): TreeNodeAccessor | undefined {\n    return this.getNamedAccessor(StagingAccessorName);\n  }\n\n  public get outputs(): TreeNodeAccessor | undefined {\n    return this.getNamedAccessor(MainAccessorName);\n  }\n\n  public readonly resultPool = new ResultPool();\n\n  /**\n   * Find labels data for a given axis id. It will search for a label column and return its data as a map.\n   * @returns a map of axis value => label\n   * @deprecated Use resultPool.findLabels instead\n   */\n  public findLabels(axis: AxisId): Record<string | number, string> | undefined {\n    return this.resultPool.findLabels(axis);\n  }\n\n  private verifyInlineAndExplicitColumnsSupport(\n    columns: (PColumn<PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>)[],\n  ) {\n    const hasInlineColumns = columns.some(\n      (c) => !(c.data instanceof TreeNodeAccessor) || isDataInfo(c.data),\n    ); // Updated check for DataInfo\n    const inlineColumnsSupport = this.ctx.featureFlags?.inlineColumnsSupport === true;\n    if (hasInlineColumns && !inlineColumnsSupport)\n      throw Error(`Inline or explicit columns not supported`); // Combined check\n\n    // Removed redundant explicitColumns check\n  }\n\n  private patchPTableDef(\n    def: PTableDef<PColumn<PColumnDataUniversal>>,\n  ): PTableDef<PColumn<PColumnDataUniversal>> {\n    if (!this.ctx.featureFlags?.pTablePartitionFiltersSupport) {\n      // For old desktop move all partition filters to filters field as it doesn't read partitionFilters field\n      def = {\n        ...def,\n        partitionFilters: [],\n        filters: [...def.partitionFilters, ...def.filters],\n      };\n    }\n    if (!this.ctx.featureFlags?.pFrameInSetFilterSupport) {\n      def = {\n        ...def,\n        partitionFilters: patchInSetFilters(def.partitionFilters),\n        filters: patchInSetFilters(def.filters),\n      };\n    }\n    return def;\n  }\n\n  // TODO remove all non-PColumn fields\n  public createPFrame(\n    def: PFrameDef<\n      PColumn<undefined | PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>\n    >,\n  ): PFrameHandle | undefined {\n    return this.ctx.createPFrame(def.map((c) => transformPColumnData(c)));\n  }\n\n  // TODO remove all non-PColumn fields\n  public createPTable(def: PTableDef<PColumn<PColumnDataUniversal>>): PTableHandle | undefined;\n  public createPTable(def: {\n    columns: PColumn<PColumnDataUniversal>[];\n    filters?: PTableRecordFilter[];\n    /** Table sorting */\n    sorting?: PTableSorting[];\n  }): PTableHandle | undefined;\n  public createPTable(\n    def:\n      | PTableDef<PColumn<PColumnDataUniversal>>\n      | {\n          columns: PColumn<PColumnDataUniversal>[];\n          filters?: PTableRecordFilter[];\n          /** Table sorting */\n          sorting?: PTableSorting[];\n        },\n  ): PTableHandle | undefined {\n    let rawDef: PTableDef<PColumn<PColumnDataUniversal>>;\n    if (\"columns\" in def) {\n      rawDef = this.patchPTableDef({\n        src: {\n          type: \"full\",\n          entries: def.columns.map((c) => ({ type: \"column\", column: c })),\n        },\n        partitionFilters: def.filters ?? [],\n        filters: [],\n        sorting: def.sorting ?? [],\n      });\n    } else {\n      rawDef = this.patchPTableDef(def);\n    }\n    const columns = extractAllColumns(rawDef.src);\n    this.verifyInlineAndExplicitColumnsSupport(columns);\n    if (!allPColumnsReady(columns)) return undefined;\n    return this.ctx.createPTable(mapPTableDef(rawDef, (po) => transformPColumnData(po)));\n  }\n\n  public createPTableV2(\n    def: PTableDefV2<PColumn<undefined | PColumnDataUniversal>>,\n  ): PTableHandle | undefined {\n    return this.ctx.createPTableV2(mapPTableDefV2(def, (po) => transformPColumnData(po)));\n  }\n\n  /** @deprecated scheduled for removal from SDK */\n  public getBlockLabel(blockId: string): string {\n    return this.ctx.getBlockLabel(blockId);\n  }\n\n  public getCurrentUnstableMarker(): string | undefined {\n    return this.ctx.getCurrentUnstableMarker();\n  }\n\n  public logInfo(msg: string): void {\n    this.ctx.logInfo(msg);\n  }\n\n  public logWarn(msg: string): void {\n    this.ctx.logWarn(msg);\n  }\n\n  public logError(msg: string): void {\n    this.ctx.logError(msg);\n  }\n}\n\n/** Main entry point to the API available within model lambdas (like outputs, sections, etc..) for v3+ blocks */\nexport class BlockRenderCtx<Args = unknown, Data = unknown> extends RenderCtxBase<Args, Data> {\n  private argsCache?: { v: Args | undefined };\n  public get args(): Args | undefined {\n    if (this.argsCache === undefined) {\n      const raw = this.ctx.args;\n      const value = typeof raw === \"function\" ? raw() : raw;\n      this.argsCache = { v: value === undefined ? undefined : JSON.parse(value) };\n    }\n    return this.argsCache.v;\n  }\n}\n\n/** Render context for legacy v1/v2 blocks - provides backward compatibility */\nexport class RenderCtxLegacy<Args = unknown, UiState = unknown> extends RenderCtxBase<\n  Args,\n  UiState\n> {\n  private argsCache?: { v: Args };\n\n  public get args(): Args {\n    if (this.argsCache === undefined) {\n      const raw = this.ctx.args;\n      const value = typeof raw === \"function\" ? raw() : raw;\n      this.argsCache = { v: JSON.parse(value) };\n    }\n    return this.argsCache.v;\n  }\n\n  private uiStateCache?: { v: UiState };\n\n  public get uiState(): UiState {\n    if (this.uiStateCache === undefined) {\n      const raw = this.ctx.uiState!;\n      const value = typeof raw === \"function\" ? raw() : raw;\n      this.uiStateCache = { v: value ? JSON.parse(value) : ({} as UiState) };\n    }\n    return this.uiStateCache.v;\n  }\n}\n\n/**\n * Render context for plugin output functions.\n * Reads plugin data from blockStorage and derives params from pre-wrapped input callbacks.\n *\n * Parameterized on the factory-like phantom F so that getPluginData returns\n * InferFactoryData<F> directly — no casts needed for the data getter.\n *\n * @typeParam F - PluginFactoryLike phantom carrying data/params/outputs types\n */\nexport class PluginRenderCtx<F extends PluginFactoryLike = PluginFactoryLike> extends RenderCtxBase<\n  unknown,\n  InferFactoryData<F>\n> {\n  private readonly handle: PluginHandle<F>;\n  private readonly wrappedInputs: Record<string, () => unknown>;\n\n  constructor(handle: PluginHandle<F>, wrappedInputs: Record<string, () => unknown>) {\n    super();\n    this.handle = handle;\n    this.wrappedInputs = wrappedInputs;\n  }\n\n  private pluginDataCache?: { v: InferFactoryData<F> };\n\n  /** Plugin's persistent data from blockStorage.__plugins.{pluginId}.__data */\n  public override get data(): InferFactoryData<F> {\n    if (this.pluginDataCache === undefined) {\n      const raw = this.ctx.blockStorage();\n      this.pluginDataCache = { v: getPluginData(parseJson(raw), this.handle) };\n    }\n    return this.pluginDataCache.v;\n  }\n\n  private paramsCache?: { v: InferFactoryParams<F> };\n\n  /** Params derived from block context via pre-wrapped input callbacks */\n  public get params(): InferFactoryParams<F> {\n    if (this.paramsCache === undefined) {\n      const result: Record<string, unknown> = {};\n      for (const [key, fn] of Object.entries(this.wrappedInputs)) {\n        result[key] = fn();\n      }\n      this.paramsCache = { v: result as InferFactoryParams<F> };\n    }\n    return this.paramsCache.v;\n  }\n}\n\n/** @deprecated Use BlockRenderCtx instead */\nexport type RenderCtx<Args = unknown, Data = unknown> = BlockRenderCtx<Args, Data>;\n\nexport type RenderFunction<Args = unknown, State = unknown, Ret = unknown> = (\n  rCtx: BlockRenderCtx<Args, State>,\n) => Ret;\n\nexport type RenderFunctionLegacy<Args = unknown, State = unknown, Ret = unknown> = (\n  rCtx: RenderCtxLegacy<Args, State>,\n) => Ret;\n\nexport type UnwrapFutureRef<K> =\n  K extends FutureRef<infer T>\n    ? T\n    : K extends bigint | boolean | null | number | string | symbol | undefined\n      ? K\n      : { [key in keyof K]: UnwrapFutureRef<K[key]> };\n\nexport type InferRenderFunctionReturn<RF extends AnyFunction> = RF extends (...args: any) => infer R\n  ? UnwrapFutureRef<R>\n  : never;\n"],"mappings":"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"}