@platforma-sdk/model 1.70.0 → 1.71.0

package/dist/render/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","names":[],"sources":["../../src/render/api.ts"],"mappings":"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"}
+{"version":3,"file":"api.d.ts","names":[],"sources":["../../src/render/api.ts"],"mappings":"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"}

package/dist/render/api.js

@@ -8,7 +8,8 @@ import { PColumnCollection } from "./util/column_collection.js";
 import { patchInSetFilters } from "./util/pframe_upgraders.js";
 import { getService } from "../services/get_services.js";
 import "../services/index.js";
-import { AnchoredIdDeriver, PColumnName, collectSpecQueryColumns, ensurePColumn, extractAllColumns, isDataInfo, isPColumn, isPColumnSpec, isPlRef, legacyColumnSelectorsToPredicate, mapDataInfo, mapPObjectData, mapPTableDef, mapPTableDefV2, mapValueInVOE, parseJson, readAnnotation, withEnrichments } from "@milaboratories/pl-model-common";
+import "./util/index.js";
+import { AnchoredIdDeriver, PColumnName, ensurePColumn, extractAllColumns, isDataInfo, isPColumn, isPColumnSpec, isPlRef, legacyColumnSelectorsToPredicate, mapDataInfo, mapPObjectData, mapPTableDef, mapPTableDefV2, mapValueInVOE, parseJson, readAnnotation, withEnrichments } from "@milaboratories/pl-model-common";
 import canonicalize from "canonicalize";
 //#region src/render/api.ts
 /**
@@ -32,7 +33,7 @@ function transformPColumnData(data) {
 	return mapPObjectData(data, (d) => {
 		if (d instanceof TreeNodeAccessor) return d.handle;
 		else if (isDataInfo(d)) return mapDataInfo(d, (accessor) => accessor.handle);
-		else return d;
+		else return d ?? [];
 	});
 }
 var ResultPool = class {
@@ -372,8 +373,6 @@ var RenderCtxBase = class {
 		return def;
 	}
 	createPFrame(def) {
-		if (!allPColumnsReady(def)) return void 0;
-		this.verifyInlineAndExplicitColumnsSupport(def);
 		return this.ctx.createPFrame(def.map((c) => transformPColumnData(c)));
 	}
 	createPTable(def) {
@@ -397,17 +396,7 @@ var RenderCtxBase = class {
 		return this.ctx.createPTable(mapPTableDef(rawDef, (po) => transformPColumnData(po)));
 	}
 	createPTableV2(def) {
-		const columns = collectSpecQueryColumns(def.query);
-		if (!allPColumnsReady(columns)) return void 0;
-		this.verifyInlineAndExplicitColumnsSupport(columns);
-		return this.ctx.createPTableV2(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(mapPTableDefV2(def, (po) => transformPColumnData(po)));
 	}
 	/** @deprecated scheduled for removal from SDK */
 	getBlockLabel(blockId) {

package/dist/render/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","names":[],"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.js","names":[],"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":";;;;;;;;;;;;;;;;;;;;AAiFA,SAAS,YAAY,OAAgC,QAAiC;AACpF,KAAI,UAAU,KAAA,EAAW,QAAO,WAAW,KAAA;AAC3C,KAAI,WAAW,KAAA,EAAW,QAAO;AACjC,MAAK,MAAM,KAAK,OACd,KAAI,MAAM,OAAO,OAAO,GAAI,QAAO;AAErC,QAAO;;;;;;;AAUT,SAAS,qBACP,MACoE;AACpE,QAAO,eAAe,OAAO,MAAM;AACjC,MAAI,aAAa,iBACf,QAAO,EAAE;WACA,WAAW,EAAE,CACtB,QAAO,YAAY,IAAI,aAAa,SAAS,OAAO;MAEpD,QAAO,KAAK,EAAE;GAEhB;;AAwBJ,IAAa,aAAb,MAAqE;CACnE,MAA2C,iBAAiB;;;;CAK5D,iBAAwB,WAAqC;AAC3D,SAAO,KAAK,IAAI,iBAAiB,UAAU;;CAY7C,WACE,qBACA,MACU;EACV,MAAM,YACJ,OAAO,wBAAwB,aAC3B,sBACA,iCAAiC,oBAAoB;EAC3D,MAAM,WAAW,KAAK,UAAU,CAAC,QAAQ,QAAQ,MAAM,UAAU,EAAE,IAAI,CAAC;EAExE,IAAI,WAA6E,EAAE;EACnF,IAAI,sBAA+B;AACnC,MAAI,OAAO,SAAS;OACd,OAAO,SAAS,WAClB,YAAW;YACF,OAAO,SAAS,SACzB,KAAI,wBAAwB,QAAQ,eAAe,QAAQ,sBAAsB,KAC/E,YAAW;QACN;AACL,WAAO;AACP,eAAW,KAAK,SAAS,EAAE;AAC3B,0BAAsB,KAAK,uBAAuB;;;AAKxD,MAAI,OAAO,aAAa,SACtB,QAAO,aAAa,WAAW,MAAM,EAAE,KAAK,YAAY,EAAE,CAAC,CAAC,KACzD,EAAE,OAAO,EAAE,OAAO,aAAa;GAC9B,KAAK,gBAAgB,KAAK,oBAAoB;GAC9C;GACD,EACF;MAED,QAAO,SAAS,KAAK,EAAE,KAAK,WAAW;GACrC,KAAK,gBAAgB,KAAK,oBAAoB;GAC9C,OAAO,SAAS,KAAK,IAAI;GAC1B,EAAE;;CAGP,iBACE,cAC+B;AAC/B,MAAI,wBAAwB,kBAAmB,QAAO;EACtD,MAAM,kBAA+C,EAAE;AACvD,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,aAAa,CACrD,KAAI,QAAQ,MAAM,EAAE;GAClB,MAAM,eAAe,KAAK,oBAAoB,MAAM;AACpD,OAAI,CAAC,aAAc,QAAO,KAAA;AAC1B,mBAAgB,OAAO;QAEvB,iBAAgB,OAAO;AAG3B,SAAO,IAAI,kBAAkB,gBAAgB;;;;;;;;;;CAW/C,oBACE,cACA,sBAIA,MAC6C;EAC7C,MAAM,YAAY,KAAK,iBAAiB,aAAa;AACrD,MAAI,CAAC,UAAW,QAAO,KAAA;AACvB,SAAO,IAAI,mBAAmB,CAC3B,kBAAkB,KAAK,CACvB,qBAAqB,KAAK,CAC1B,WAAW,sBAAsB;GAChC,GAAG;GACH;GACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCN,oBACE,cACA,sBAIA,MAC6D;EAC7D,MAAM,YAAY,KAAK,iBAAiB,aAAa;AACrD,MAAI,CAAC,UAAW,QAAO,KAAA;EACvB,MAAM,UAAU,IAAI,mBAAmB,CACpC,kBAAkB,KAAK,CACvB,qBAAqB,KAAK,CAC1B,oBAAoB,sBAAsB;GACzC,GAAG;GACH;GACD,CAAC;AACJ,MAAI,CAAC,QAAS,QAAO,KAAA;AACrB,SAAO,QAAQ,KAAK,UAAU;GAC5B,OAAO,KAAK;GACZ,OAAO,KAAK;GACb,EAAE;;;;;CAML,wBAA4E;AAC1E,SAAO,KAAK,SAAS;;CAGvB,UAA8D;EAC5D,MAAM,SAAS,KAAK,IAAI,uBAAuB;AAC/C,SAAO;GACL,YAAY,OAAO;GACnB,SAAS,OAAO,QAAQ,KAAK,OAAO;IAClC,KAAK,EAAE;IACP,KAAK;KACH,GAAG,EAAE;KACL,MAAM,IAAI,iBAAiB,EAAE,IAAI,MAAM,CAAC,EAAE,IAAI,SAAS,EAAE,IAAI,KAAK,CAAC;KACpE;IACF,EAAE;GACJ;;;;;CAMH,kCAEE;AACA,SAAO,KAAK,mBAAmB;;CAGjC,oBAEE;EACA,MAAM,SAAS,KAAK,IAAI,iCAAiC;AACzD,SAAO;GACL,YAAY,OAAO;GACnB,SAAS,OAAO,QAAQ,KAAK,OAAO;IAClC,KAAK,EAAE;IACP,KAAK;KACH,GAAG,EAAE;KACL,MAAM,cACJ,EAAE,IAAI,OACL,WAAW,IAAI,iBAAiB,QAAQ,CAAC,EAAE,IAAI,SAAS,EAAE,IAAI,KAAK,CAAC,CACtE;KACF;IACF,EAAE;GACJ;;;;;CAMH,yBAA+D;AAC7D,SAAO,KAAK,UAAU;;CAGxB,WAAiD;AAC/C,SAAO,KAAK,IAAI,wBAAwB;;;;;;CAO1C,aAAoB,KAAmD;AAErE,MAAI,OAAO,KAAK,IAAI,+BAA+B,YACjD,QAAO,KAAK,SAAS,CAAC,QAAQ,MAC3B,MAAM,EAAE,IAAI,YAAY,IAAI,WAAW,EAAE,IAAI,SAAS,IAAI,KAC5D,EAAE;EACL,MAAM,OAAO,KAAK,IAAI,2BAA2B,IAAI,SAAS,IAAI,KAAK;AAEvE,MAAI,CAAC,KAAM,QAAO,KAAA;AAClB,SAAO,eAAe,OAAO,WAAW,IAAI,iBAAiB,QAAQ,CAAC,IAAI,SAAS,IAAI,KAAK,CAAC,CAAC;;;;;;;CAQhG,gBAAuB,KAAmD;EACxE,MAAM,OAAO,KAAK,aAAa,IAAI;AACnC,MAAI,CAAC,KAAM,QAAO,KAAA;AAClB,SAAO,cAAc,KAAK;;;;;;;CAQ5B,oBAA2B,KAAqC;EAC9D,MAAM,OAAO,KAAK,aAAa,IAAI;AACnC,MAAI,CAAC,KAAM,QAAO,KAAA;AAClB,MAAI,CAAC,cAAc,KAAK,CAAE,OAAM,IAAI,MAAM,8BAA8B,KAAK,KAAK,GAAG;AACrF,SAAO;;;;;;CAOT,aAAoB,KAAqC;AACvD,SAAO,KAAK,IAAI,2BAA2B,IAAI,SAAS,IAAI,KAAK;;;;;;;CAQnE,2BAAkC,MAAgD;EAChF,MAAM,SAAsC,EAAE;AAE9C,MAAK,MAAK,MAAM,QAAQ,KAAK,SAAS,CAAC,SAAS;AAC9C,OAAI,CAAC,cAAc,KAAK,IAAI,KAAK,CAC/B;GAGF,MAAM,MAAM,KAAK,IAAI;AAErB,OAAI,KAAK,SAAS,IAAI,KACpB;AAGF,OAAI,KAAK,cAAc,IAAI,UACzB;AAGF,OAAI,KAAK,SAAS,WAAW,IAAI,SAAS,OACxC;AAGF,OAAI,CAAC,YAAY,KAAK,QAAQ,IAAI,OAAO,CACvC;AAGF,OAAI,CAAC,YAAY,KAAK,eAAe,IAAI,cAAc,CACrD;AAGF,QAAK,IAAI,IAAI,GAAG,IAAI,KAAK,SAAS,QAAQ,EAAE,GAAG;IAC7C,MAAM,MAAM,KAAK,SAAS;IAC1B,MAAM,MAAM,IAAI,SAAS;AACzB,QAAI,IAAI,SAAS,IAAI,KACnB,UAAS;AAEX,QAAI,IAAI,SAAS,IAAI,KACnB,UAAS;AAEX,QAAI,CAAC,YAAY,IAAI,QAAQ,IAAI,OAAO,CACtC,UAAS;AAEX,QAAI,CAAC,YAAY,IAAI,eAAe,IAAI,cAAc,CACpD,UAAS;;AAIb,UAAO,KAAK,KAAK,IAAI;;AAEvB,SAAO;;;;;;CAOT,WAAkB,MAA2D;EAC3E,MAAM,WAAW,KAAK,SAAS;AAC/B,OAAK,MAAM,UAAU,SAAS,SAAS;AACrC,OAAI,CAAC,UAAU,OAAO,IAAI,CAAE;GAE5B,MAAM,OAAO,OAAO,IAAI;AACxB,OACE,KAAK,SAAS,YAAY,SAC1B,KAAK,SAAS,WAAW,KACzB,KAAK,SAAS,GAAG,SAAS,KAAK,QAC/B,KAAK,SAAS,GAAG,SAAS,KAAK,QAC/B,YAAY,KAAK,QAAQ,KAAK,SAAS,GAAG,OAAO,IACjD,YAAY,KAAK,eAAe,KAAK,SAAS,GAAG,cAAc,EAC/D;AACA,QAAI,OAAO,IAAI,KAAK,aAAa,SAAS,mBACxC,OAAM,MAAM,yCAAyC,OAAO,IAAI,KAAK,aAAa,OAAO;AAU3F,WARgD,OAAO,YACrD,OAAO,QACL,OAAO,IAAI,KAAK,eAEZ,CAAC,KACN,CAAC,KAAK,MAAM,CAAC,KAAK,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAC1C;;;;;;;;;;;CAeP,cACE,WACyC;EACzC,MAAM,YACJ,OAAO,cAAc,aAAa,YAAY,iCAAiC,UAAU;AAQ3F,SANqB,KAAK,UAAU,CAAC,QAAQ,QAAQ,EAAE,KAAK,WAAW;AACrE,OAAI,CAAC,cAAc,KAAK,CAAE,QAAO;AACjC,UAAO,UAAU,KAAK;IACtB,CAGkB,KAAK,EAAE,KAAK,KAAK,WAAW;GAE9C,MAAM,cAAc;GACpB,IAAI,cAAmD;GAEvD,MAAM,OAAO;AAEb,UAAO;IACL,IAAI,aAAa,IAAI;IACrB,MAAM;IACN,IAAI,OAAqC;AACvC,SAAI,gBAAgB,KAClB,QAAO;AAGT,mBAAc,KAAK,gBAAgB,IAAI,EAAE;AACzC,YAAO;;IAEV;IACD;;;;;;CAOJ,wBACE,QACA,SAC6C;EAC7C,MAAM,SAAS,KAAK,WAAW,OAAO,SAAS,SAAS;AACxD,MAAI,CAAC,OAAQ,QAAO,KAAA;EACpB,MAAM,WAAW,eAAe,QAAQ,oBAAoB,UAAU;AACtE,MAAI,aAAa,KAAA,GAAW;GAC1B,MAAM,OAAO,KAAK,MAAM,SAAS;AACjC,UAAO,OAAO,YACZ,KAAK,KAAK,QAAQ;AAChB,WAAO,CAAC,KAAK,OAAO,QAAQ,aAAa;KACzC,CACH;QAED,QAAO;;;;AAMb,IAAsB,gBAAtB,MAAoE;CAClE;CAEA,cAAc;AACZ,OAAK,MAAM,iBAAiB;;CAG9B;CAEA,IAAW,OAAa;AACtB,MAAI,KAAK,cAAc,KAAA,GAAW;GAChC,MAAM,MAAM,KAAK,IAAI;GACrB,MAAM,QAAQ,OAAO,QAAQ,aAAa,KAAK,GAAG;AAClD,QAAK,YAAY,EAAE,GAAG,QAAQ,KAAK,MAAM,MAAM,GAAI,EAAE,EAAW;;AAElE,SAAO,KAAK,UAAU;;CAIxB;;;;;CAMA,IAAW,aAA+B;AACxC,MAAI,KAAK,oBAAoB,KAAA,GAAW;GACtC,MAAM,MAAM,KAAK,IAAI;GACrB,MAAM,QAAQ,OAAO,QAAQ,aAAa,KAAK,GAAG;AAClD,QAAK,kBAAkB,EACrB,GAAG,QAAQ,KAAK,MAAM,MAAM,GAAG,KAAA,GAChC;;AAEH,SAAO,KAAK,gBAAgB;;CAG9B,WAAiD,MAA2B;AAC1E,SAAO,WAAW,KAAK;;CAQzB,iBAAyB,MAA4C;AACnE,SAAO,MACL,KAAK,IAAI,wBAAwB,KAAK,GACrC,aAAa,IAAI,iBAAiB,UAAU,CAAC,KAAK,CAAC,CACrD;;CAGH,IAAW,SAAuC;AAChD,SAAO,KAAK,iBAAiB,oBAAoB;;CAGnD,IAAW,UAAwC;AACjD,SAAO,KAAK,iBAAiB,iBAAiB;;CAGhD,aAA6B,IAAI,YAAY;;;;;;CAO7C,WAAkB,MAA2D;AAC3E,SAAO,KAAK,WAAW,WAAW,KAAK;;CAGzC,sCACE,SACA;EACA,MAAM,mBAAmB,QAAQ,MAC9B,MAAM,EAAE,EAAE,gBAAgB,qBAAqB,WAAW,EAAE,KAAK,CACnE;EACD,MAAM,uBAAuB,KAAK,IAAI,cAAc,yBAAyB;AAC7E,MAAI,oBAAoB,CAAC,qBACvB,OAAM,MAAM,2CAA2C;;CAK3D,eACE,KAC0C;AAC1C,MAAI,CAAC,KAAK,IAAI,cAAc,8BAE1B,OAAM;GACJ,GAAG;GACH,kBAAkB,EAAE;GACpB,SAAS,CAAC,GAAG,IAAI,kBAAkB,GAAG,IAAI,QAAQ;GACnD;AAEH,MAAI,CAAC,KAAK,IAAI,cAAc,yBAC1B,OAAM;GACJ,GAAG;GACH,kBAAkB,kBAAkB,IAAI,iBAAiB;GACzD,SAAS,kBAAkB,IAAI,QAAQ;GACxC;AAEH,SAAO;;CAIT,aACE,KAG0B;AAC1B,SAAO,KAAK,IAAI,aAAa,IAAI,KAAK,MAAM,qBAAqB,EAAE,CAAC,CAAC;;CAWvE,aACE,KAQ0B;EAC1B,IAAI;AACJ,MAAI,aAAa,IACf,UAAS,KAAK,eAAe;GAC3B,KAAK;IACH,MAAM;IACN,SAAS,IAAI,QAAQ,KAAK,OAAO;KAAE,MAAM;KAAU,QAAQ;KAAG,EAAE;IACjE;GACD,kBAAkB,IAAI,WAAW,EAAE;GACnC,SAAS,EAAE;GACX,SAAS,IAAI,WAAW,EAAE;GAC3B,CAAC;MAEF,UAAS,KAAK,eAAe,IAAI;EAEnC,MAAM,UAAU,kBAAkB,OAAO,IAAI;AAC7C,OAAK,sCAAsC,QAAQ;AACnD,MAAI,CAAC,iBAAiB,QAAQ,CAAE,QAAO,KAAA;AACvC,SAAO,KAAK,IAAI,aAAa,aAAa,SAAS,OAAO,qBAAqB,GAAG,CAAC,CAAC;;CAGtF,eACE,KAC0B;AAC1B,SAAO,KAAK,IAAI,eAAe,eAAe,MAAM,OAAO,qBAAqB,GAAG,CAAC,CAAC;;;CAIvF,cAAqB,SAAyB;AAC5C,SAAO,KAAK,IAAI,cAAc,QAAQ;;CAGxC,2BAAsD;AACpD,SAAO,KAAK,IAAI,0BAA0B;;CAG5C,QAAe,KAAmB;AAChC,OAAK,IAAI,QAAQ,IAAI;;CAGvB,QAAe,KAAmB;AAChC,OAAK,IAAI,QAAQ,IAAI;;CAGvB,SAAgB,KAAmB;AACjC,OAAK,IAAI,SAAS,IAAI;;;;AAK1B,IAAa,iBAAb,cAAoE,cAA0B;CAC5F;CACA,IAAW,OAAyB;AAClC,MAAI,KAAK,cAAc,KAAA,GAAW;GAChC,MAAM,MAAM,KAAK,IAAI;GACrB,MAAM,QAAQ,OAAO,QAAQ,aAAa,KAAK,GAAG;AAClD,QAAK,YAAY,EAAE,GAAG,UAAU,KAAA,IAAY,KAAA,IAAY,KAAK,MAAM,MAAM,EAAE;;AAE7E,SAAO,KAAK,UAAU;;;;AAK1B,IAAa,kBAAb,cAAwE,cAGtE;CACA;CAEA,IAAW,OAAa;AACtB,MAAI,KAAK,cAAc,KAAA,GAAW;GAChC,MAAM,MAAM,KAAK,IAAI;GACrB,MAAM,QAAQ,OAAO,QAAQ,aAAa,KAAK,GAAG;AAClD,QAAK,YAAY,EAAE,GAAG,KAAK,MAAM,MAAM,EAAE;;AAE3C,SAAO,KAAK,UAAU;;CAGxB;CAEA,IAAW,UAAmB;AAC5B,MAAI,KAAK,iBAAiB,KAAA,GAAW;GACnC,MAAM,MAAM,KAAK,IAAI;GACrB,MAAM,QAAQ,OAAO,QAAQ,aAAa,KAAK,GAAG;AAClD,QAAK,eAAe,EAAE,GAAG,QAAQ,KAAK,MAAM,MAAM,GAAI,EAAE,EAAc;;AAExE,SAAO,KAAK,aAAa;;;;;;;;;;;;AAa7B,IAAa,kBAAb,cAAsF,cAGpF;CACA;CACA;CAEA,YAAY,QAAyB,eAA8C;AACjF,SAAO;AACP,OAAK,SAAS;AACd,OAAK,gBAAgB;;CAGvB;;CAGA,IAAoB,OAA4B;AAC9C,MAAI,KAAK,oBAAoB,KAAA,EAE3B,MAAK,kBAAkB,EAAE,GAAG,cAAc,UAD9B,KAAK,IAAI,cAAc,CACqB,EAAE,KAAK,OAAO,EAAE;AAE1E,SAAO,KAAK,gBAAgB;;CAG9B;;CAGA,IAAW,SAAgC;AACzC,MAAI,KAAK,gBAAgB,KAAA,GAAW;GAClC,MAAM,SAAkC,EAAE;AAC1C,QAAK,MAAM,CAAC,KAAK,OAAO,OAAO,QAAQ,KAAK,cAAc,CACxD,QAAO,OAAO,IAAI;AAEpB,QAAK,cAAc,EAAE,GAAG,QAAiC;;AAE3D,SAAO,KAAK,YAAY"}

package/dist/render/index.cjs

@@ -4,5 +4,5 @@ require("./util/axis_filtering.cjs");
 require("./util/label.cjs");
 require("./util/pcolumn_data.cjs");
 require("./util/column_collection.cjs");
-require("./api.cjs");
 require("./util/index.cjs");
+require("./api.cjs");

package/dist/render/index.js

@@ -4,5 +4,5 @@ import "./util/axis_filtering.js";
 import "./util/label.js";
 import "./util/pcolumn_data.js";
 import "./util/column_collection.js";
-import "./api.js";
 import "./util/index.js";
+import "./api.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-sdk/model",
-  "version": "1.70.0",
+  "version": "1.71.0",
   "description": "Platforma.bio SDK / Block Model",
   "files": [
     "./dist/**/*",
@@ -30,22 +30,22 @@
     "fast-json-patch": "^3.1.1",
     "utility-types": "^3.11.0",
     "zod": "~3.25.76",
-    "@milaboratories/ptabler-expression-js": "1.2.18",
-    "@milaboratories/pl-model-middle-layer": "1.18.8",
     "@milaboratories/helpers": "1.14.1",
     "@milaboratories/pl-error-like": "1.12.10",
-    "@milaboratories/pl-model-common": "1.37.0"
+    "@milaboratories/pl-model-middle-layer": "1.18.9",
+    "@milaboratories/ptabler-expression-js": "1.2.19",
+    "@milaboratories/pl-model-common": "1.38.0"
   },
   "devDependencies": {
     "@vitest/coverage-istanbul": "^4.1.3",
     "fast-json-patch": "^3.1.1",
     "typescript": "~5.9.3",
     "vitest": "^4.1.3",
-    "@milaboratories/pf-spec-driver": "1.3.7",
-    "@milaboratories/pf-driver": "1.4.3",
-    "@milaboratories/build-configs": "2.0.0",
+    "@milaboratories/ts-configs": "1.2.3",
     "@milaboratories/ts-builder": "1.3.2",
-    "@milaboratories/ts-configs": "1.2.3"
+    "@milaboratories/pf-spec-driver": "1.3.8",
+    "@milaboratories/build-configs": "2.0.0",
+    "@milaboratories/pf-driver": "1.4.4"
   },
   "scripts": {
     "build": "ts-builder build --target node",

package/src/columns/column_snapshot_provider.ts

@@ -1,11 +1,9 @@
 import type { PObjectId } from "@milaboratories/pl-model-common";
-import { PColumn } from "@milaboratories/pl-model-common";
+import { isDataInfo, PColumn, visitDataInfo } from "@milaboratories/pl-model-common";
 import { TreeNodeAccessor } from "../render/accessor";
 import type { PColumnDataUniversal } from "../render/internal";
 import type { ColumnDataStatus, ColumnSnapshot } from "./column_snapshot";
 
-// --- ColumnProvider ---
-
 /**
  * Data source interface for column enumeration.
  *
@@ -22,8 +20,6 @@ export interface ColumnSnapshotProvider {
   isColumnListComplete(): boolean;
 }
 
-// --- ColumnSource ---
-
 /**
  * Union of types that can serve as column sources for helpers and builders.
  * Does NOT include TreeNodeAccessor — call `.toColumnSource()` on it first.
@@ -33,8 +29,6 @@ export type ColumnSource =
   | ColumnSnapshot<PObjectId>[]
   | PColumn<PColumnDataUniversal | undefined>[];
 
-// --- ArrayColumnProvider ---
-
 /**
  * Simple provider wrapping an array of PColumns.
  * Always complete, data status always 'ready'.
@@ -46,8 +40,8 @@ export class ArrayColumnProvider implements ColumnSnapshotProvider {
     this.columns = columns.map((col) => ({
       id: col.id,
       spec: col.spec,
-      dataStatus: "ready" as const,
       data: { get: () => col.data },
+      dataStatus: this.getStatus(col.data),
     }));
   }
 
@@ -58,9 +52,35 @@ export class ArrayColumnProvider implements ColumnSnapshotProvider {
   isColumnListComplete(): boolean {
     return true;
   }
-}
 
-// --- SnapshotColumnProvider ---
+  protected getStatus(
+    d: undefined | PColumnDataUniversal | (() => undefined | PColumnDataUniversal),
+  ): ColumnDataStatus {
+    if (d == null) {
+      return "absent";
+    }
+    if (typeof d === "function") {
+      return this.getStatus(d());
+    }
+    if (d instanceof TreeNodeAccessor) {
+      if (d.getIsReadyOrError()) return "ready";
+      if (d.getIsFinal()) return "absent";
+      return "computing";
+    }
+    if (isDataInfo(d)) {
+      let ready = true;
+      let final = true;
+      visitDataInfo(d, (v) => {
+        ready &&= v.getIsReadyOrError();
+        final &&= v.getIsFinal();
+      });
+      if (ready) return "ready";
+      if (final) return "absent";
+      return "computing";
+    }
+    return "ready";
+  }
+}
 
 /**
  * Provider wrapping an array of ColumnSnapshots.
@@ -78,8 +98,6 @@ export class SnapshotColumnProvider implements ColumnSnapshotProvider {
   }
 }
 
-// --- OutputColumnProvider ---
-
 export interface OutputColumnProviderOpts {
   /** When true and the accessor is final, columns with no ready data get status 'absent'. */
   allowPermanentAbsence?: boolean;
@@ -133,8 +151,6 @@ export class OutputColumnProvider implements ColumnSnapshotProvider {
   }
 }
 
-// --- Source normalization ---
-
 /** Checks if a value is a ColumnSnapshotProvider (duck-typing). */
 export function isColumnSnapshotProvider(source: unknown): source is ColumnSnapshotProvider {
   return (

package/src/components/PlDataTable/createPlDataTable/createPlDataTableV3.ts

@@ -32,6 +32,7 @@ import {
   withLabelAnnotations,
   withTableVisualAnnotations,
   withInfoAnnotations,
+  withDataStatusAnnotations,
 } from "./utils";
 import type { PrimaryEntry, SecondaryGroup } from "./createPTableDefV3";
 import { createPTableDefV3 } from "./createPTableDefV3";
@@ -79,8 +80,6 @@ export type ColumnVisibilityRule = {
 
 export type ColumnMatcher = (spec: PColumnSpec) => boolean;
 
-// Main Function
-
 export function createPlDataTableV3<A, U>(
   ctx: RenderCtxBase<A, U>,
   options: createPlDataTableOptionsV3,
@@ -138,17 +137,18 @@ export function createPlDataTableV3<A, U>(
   ]);
 
   const remapedDefaultFilters = remapFilterColumnIds(options.filters, discovered);
-  const filters = concatFilters(
-    state.pTableParams.filters,
-    state.pTableParams.defaultFilters ?? remapedDefaultFilters,
+  const filters = filterFilters(
+    concatFilters(
+      state.pTableParams.filters,
+      state.pTableParams.defaultFilters ?? remapedDefaultFilters,
+    ),
+    columnIsAvailable,
   );
-  validateFilters(filters, columnIsAvailable);
 
-  const sorting = resolveSorting(
-    state.pTableParams.sorting,
-    remapSortingColumnIds(options.sorting, discovered),
+  const sorting = filterSorting(
+    resolveSorting(state.pTableParams.sorting, remapSortingColumnIds(options.sorting, discovered)),
+    columnIsAvailable,
   );
-  validateSorting(sorting, columnIsAvailable);
 
   const primaryEntries: PrimaryEntry<undefined | PColumnDataUniversal>[] = primarySnapshots.map(
     (v) => ({ column: resolveSnapshot(v.column) }),
@@ -274,6 +274,7 @@ function annotateColumnGroups(params: {
   const directAnnotated = liftToVariantColumns(
     direct,
     flow(
+      (cols) => withDataStatusAnnotations(cols),
       (cols) => withLabelAnnotations(derivedLabels, cols),
       (cols) => withInfoAnnotations(derivedTooltips, cols),
       (cols) => withTableVisualAnnotations(visibilityByColId, orderByColId, cols),
@@ -283,6 +284,7 @@ function annotateColumnGroups(params: {
   const linkedAnnotated = liftToVariantColumns(
     linked,
     flow(
+      (cols) => withDataStatusAnnotations(cols),
       (cols) => withHidenAxesAnnotations(cols),
       (cols) => withLabelAnnotations(derivedLabels, cols),
       (cols) => withInfoAnnotations(derivedTooltips, cols),
@@ -344,19 +346,35 @@ function createColumnValidationById(
   };
 }
 
-/** Validate that all column references in filters exist in the table. */
-function validateFilters(
+/** Drop filter leaves whose column references are not available in the table. */
+function filterFilters(
   filters: Nil | PlDataTableFilters,
   isValidColumnId: (id: string) => boolean,
-): void {
-  if (filters == null) return;
-  const filterColumns = collectFilterSpecColumns(filters);
-  const firstInvalid = filterColumns.find((col) => !isValidColumnId(col));
-  if (firstInvalid !== undefined) {
-    throw new Error(
-      `Invalid filter column ${firstInvalid}: column reference does not match the table columns`,
-    );
-  }
+): Nil | PlDataTableFilters {
+  if (isNil(filters)) return filters;
+
+  const isLeafValid = (leaf: PlDataTableFilterSpecLeaf): boolean => {
+    if (leaf.type === undefined) return true;
+    if ("column" in leaf && !isValidColumnId(leaf.column)) return false;
+    if ("rhs" in leaf && !isValidColumnId(leaf.rhs)) return false;
+    return true;
+  };
+
+  const prune = (node: PlDataTableFilterNode): Nil | PlDataTableFilterNode => {
+    if (node.type === "and" || node.type === "or") {
+      const kept = node.filters
+        .map((f) => prune(f))
+        .filter((f): f is PlDataTableFilterNode => !isNil(f));
+      return { type: node.type, filters: kept };
+    }
+    if (node.type === "not") {
+      const inner = prune(node.filter);
+      return isNil(inner) ? undefined : { type: "not", filter: inner };
+    }
+    return isLeafValid(node) ? node : undefined;
+  };
+
+  return prune(filters) as Nil | PlDataTableFilters;
 }
 
 /** Merge two filter trees into one AND-combined tree. Returns the non-nil one if the other is nil. */
@@ -377,16 +395,12 @@ function resolveSorting(
   return (isEmpty(userSorting) ? defaultSorting : userSorting) ?? [];
 }
 
-/** Validate that all column references in sorting exist in the table. */
-function validateSorting(sorting: PTableSorting[], isValidColumnId: (id: string) => boolean): void {
-  const firstInvalid = sorting.find(
-    (s) => !isValidColumnId(canonicalizeJson<PTableColumnId>(s.column)),
-  );
-  if (firstInvalid !== undefined) {
-    throw new Error(
-      `Invalid sorting column ${JSON.stringify(firstInvalid.column)}: column reference does not match the table columns`,
-    );
-  }
+/** Drop sorting entries whose column is not available in the table. */
+function filterSorting(
+  sorting: PTableSorting[],
+  isValidColumnId: (id: string) => boolean,
+): PTableSorting[] {
+  return sorting.filter((s) => isValidColumnId(canonicalizeJson<PTableColumnId>(s.column)));
 }
 
 function buildSecondaryGroups(
@@ -473,21 +487,22 @@ function remapSortingColumnIds(
   sorting: Nil | PTableSorting[],
   columns: TableColumnVariant[],
 ): Nil | PTableSorting[] {
-  return sorting?.map((s) => {
-    if (s.column.type === "axis") return s; // Axis references are unaffected by column ID remapping
+  return sorting?.flatMap((s) => {
+    if (s.column.type === "axis") return [s]; // Axis references are unaffected by column ID remapping
 
     const id = s.column.id;
-    const column =
-      columns.find((c) => (c.originalId ?? c.column.id) === id) ??
-      throwError(`Column ID "${id}" in sorting does not match any discovered column`);
-
-    return {
-      ...s,
-      column: {
-        type: "column",
-        id: column.column.id,
+    const column = columns.find((c) => (c.originalId ?? c.column.id) === id);
+    if (column === undefined) return [];
+
+    return [
+      {
+        ...s,
+        column: {
+          type: "column" as const,
+          id: column.column.id,
+        },
       },
-    };
+    ];
   });
 }
 

package/src/components/PlDataTable/createPlDataTable/utils.ts

@@ -17,7 +17,7 @@ import {
   deriveDistinctTooltips,
   type TooltipEntry,
 } from "../../../labels/derive_distinct_tooltips";
-import type { MatchQualifications, MatchVariant } from "../../../columns";
+import type { ColumnDataStatus, MatchQualifications, MatchVariant } from "../../../columns";
 import type { ColumnMatcher, ColumnOrderRule, ColumnVisibilityRule } from "./createPlDataTableV3";
 import type { ColumnSelector } from "../../../columns";
 import { ArrayColumnProvider, ColumnCollectionBuilder } from "../../../columns";
@@ -130,7 +130,10 @@ function dedupeById(columns: RuleColumn[]): RuleColumn[] {
  * For each axis in column specs: writes derived axis label into AxisSpec annotations.
  */
 export function withLabelAnnotations<
-  T extends { readonly id: PObjectId; readonly spec: PColumnSpec },
+  T extends {
+    readonly id: PObjectId;
+    readonly spec: PColumnSpec;
+  },
 >(derivedLabels: undefined | Record<string, string>, columns: T[]): T[] {
   if (derivedLabels === undefined) return columns;
   return columns.map((col) => {
@@ -153,6 +156,26 @@ export function withLabelAnnotations<
   });
 }
 
+export function withDataStatusAnnotations<
+  T extends {
+    readonly spec: PColumnSpec;
+    readonly dataStatus: ColumnDataStatus;
+  },
+>(columns: T[]): T[] {
+  return columns.map((col) => {
+    return {
+      ...col,
+      spec: {
+        ...col.spec,
+        annotations: {
+          ...col.spec.annotations,
+          [Annotation.DataStatus]: col.dataStatus,
+        },
+      },
+    } as T;
+  });
+}
+
 /**
  * Writes effective display properties (OrderPriority, Visibility) from precomputed rule maps
  * into column annotations. Returns new column objects — originals are not mutated.