@platforma-sdk/model 1.79.27 → 1.80.2

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  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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"}
+{"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  PColumnSelector,\n  PColumnSpec,\n  PColumnValues,\n  PFrameDef,\n  PFrameHandle,\n  ColumnUniversalId,\n  PObject,\n  PObjectId,\n  PObjectSpec,\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  visitDataInfo,\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\";\nimport { throwError } from \"@milaboratories/helpers\";\nimport { isString } from \"es-toolkit\";\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 column Data from a PColumn to transform\n * @returns Transformed data compatible with platform API\n */\nexport function finalizePColumnData(\n  column: PColumn<PColumnDataUniversal<undefined | TreeNodeAccessor>>,\n): PColumn<PColumnValues | AccessorHandle | DataInfo<AccessorHandle>> {\n  return mapPObjectData(column, (data) => {\n    if (data instanceof TreeNodeAccessor) {\n      return data.handle;\n    } else if (isDataInfo(data)) {\n      let ready = true;\n      visitDataInfo(data, (accessor) => (ready &&= accessor?.getIsReadyOrError() ?? false));\n      if (!ready) return [];\n      return mapDataInfo(\n        data,\n        (accessor) => accessor?.handle ?? throwError(\"Accessor handle is undefined\"),\n      );\n    } else {\n      return data ?? [];\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\n/**\n * @deprecated use the direct `ctx.*` methods on `RenderCtxBase` instead.\n *\n * Migration map:\n * - `getSpecs` → `ctx.getSpecs`\n * - `getSpecByRef` / `getPColumnSpecByRef` → `ctx.getSpecByRef` / `ctx.getPColumnSpecByRef`\n * - `getDataByRef` / `getPColumnByRef` → `ctx.getDataByRef` / `ctx.getPColumnByRef`\n * - `getOptions` → `ctx.getOptions`\n *\n * Eager methods `selectColumns` / `getData` / `getDataWithErrors` should be\n * replaced by `ctx.getSpecs` + on-demand `ctx.getStatusByRef` /\n * `ctx.getPColumnByRef` so that the data resource is not subscribed up-front.\n */\nexport class ResultPool implements ColumnProvider, AxisLabelProvider {\n  private readonly ctx: GlobalCfgRenderCtx = getCfgRenderCtx();\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  ): undefined | PColumn<undefined | PColumnDataUniversal>[] {\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    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   * @deprecated use `RenderCtxBase.rawResultPool` + `ResultPoolColumnsProvider` +\n   * `discoverColumns` instead. This eager path materializes column data\n   * unnecessarily for callers that only filter by spec.\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  public 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  /** @deprecated use `rawResultPool` + `ResultPoolColumnsProvider` instead. */\n  public readonly resultPool = new ResultPool();\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  public createPFrame(\n    def: PFrameDef<PObjectId | SUniversalPColumnId | PColumn<undefined | PColumnDataUniversal>>,\n  ): PFrameHandle | undefined {\n    return this.ctx.createPFrame(def.map((v) => (isString(v) ? v : finalizePColumnData(v))));\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    if (!allPColumnsReady(columns)) return undefined;\n    return this.ctx.createPTable(mapPTableDef(rawDef, finalizePColumnData));\n  }\n\n  public createPTableV2(\n    def: PTableDefV2<ColumnUniversalId | PColumn<undefined | PColumnDataUniversal>>,\n  ): PTableHandle | undefined {\n    return this.ctx.createPTableV2(\n      mapPTableDefV2(def, { column: (v) => (isString(v) ? v : finalizePColumnData(v)) }),\n    );\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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"}

package/dist/render/api.d.ts

@@ -1,11 +1,11 @@
 import { InferFactoryData, InferFactoryParams, PluginFactoryLike, PluginHandle } from "../plugin_handle.js";
-import { GlobalCfgRenderCtx, PColumnDataUniversal } from "./internal.js";
+import { AccessorHandle, GlobalCfgRenderCtx, PColumnDataUniversal } from "./internal.js";
 import { FutureRef } from "./future.js";
 import { TreeNodeAccessor } from "./accessor.js";
 import { DeriveLabelsOptions } from "../labels/derive_distinct_labels.js";
 import { APColumnSelectorWithSplit } from "./util/split_selectors.js";
 import { AxisLabelProvider, ColumnProvider } from "./util/column_collection.js";
-import { AnchoredIdDeriver, AnchoredPColumnSelector, AnyFunction, AxisId, ModelServices, Option, PColumn, PColumnLazy, PColumnSelector, PColumnSpec, PFrameDef, PFrameHandle, PObject, PObjectSpec, PSpecPredicate, PTableDef, PTableDefV2, PTableHandle, PTableRecordFilter, PTableSorting, PlRef, ResolveAnchorsOptions, ResultCollection, SUniversalPColumnId, ValueOrError } from "@milaboratories/pl-model-common";
+import { AnchoredIdDeriver, AnchoredPColumnSelector, AnyFunction, AxisId, ColumnUniversalId, DataInfo, ModelServices, Option, PColumn, PColumnSelector, PColumnSpec, PColumnValues, PFrameDef, PFrameHandle, PObject, PObjectId, PObjectSpec, PTableDef, PTableDefV2, PTableHandle, PTableRecordFilter, PTableSorting, PlRef, ResolveAnchorsOptions, ResultCollection, SUniversalPColumnId, ValueOrError } from "@milaboratories/pl-model-common";
 import { Optional } from "utility-types";
 
 //#region src/render/api.d.ts
@@ -13,6 +13,12 @@ type UniversalColumnOption = {
   label: string;
   value: SUniversalPColumnId;
 };
+/**
+ * Transforms PColumn data into the internal representation expected by the platform
+ * @param column Data from a PColumn to transform
+ * @returns Transformed data compatible with platform API
+ */
+declare function finalizePColumnData(column: PColumn<PColumnDataUniversal<undefined | TreeNodeAccessor>>): PColumn<PColumnValues | AccessorHandle | DataInfo<AccessorHandle>>;
 type UniversalPColumnOpts = {
   labelOps?: DeriveLabelsOptions;
   dontWaitAllData?: boolean;
@@ -32,12 +38,21 @@ type GetOptionsOpts = {
    */
   label?: ((spec: PObjectSpec, ref: PlRef) => string) | DeriveLabelsOptions;
 };
+/**
+ * @deprecated use the direct `ctx.*` methods on `RenderCtxBase` instead.
+ *
+ * Migration map:
+ * - `getSpecs` → `ctx.getSpecs`
+ * - `getSpecByRef` / `getPColumnSpecByRef` → `ctx.getSpecByRef` / `ctx.getPColumnSpecByRef`
+ * - `getDataByRef` / `getPColumnByRef` → `ctx.getDataByRef` / `ctx.getPColumnByRef`
+ * - `getOptions` → `ctx.getOptions`
+ *
+ * Eager methods `selectColumns` / `getData` / `getDataWithErrors` should be
+ * replaced by `ctx.getSpecs` + on-demand `ctx.getStatusByRef` /
+ * `ctx.getPColumnByRef` so that the data resource is not subscribed up-front.
+ */
 declare class ResultPool implements ColumnProvider, AxisLabelProvider {
   private readonly ctx;
-  /**
-   * @deprecated use getOptions()
-   */
-  calculateOptions(predicate: PSpecPredicate): Option[];
   getOptions(predicateOrSelector: ((spec: PObjectSpec) => boolean) | PColumnSelector | PColumnSelector[], opts?: GetOptionsOpts): Option[];
   /** @deprecated wrap label ops with { label: <...> } */
   getOptions(predicateOrSelector: ((spec: PObjectSpec) => boolean) | PColumnSelector | PColumnSelector[], label?: ((spec: PObjectSpec, ref: PlRef) => string) | DeriveLabelsOptions): Option[];
@@ -50,7 +65,7 @@ declare class ResultPool implements ColumnProvider, AxisLabelProvider {
    * @param opts - Optional configuration for label generation and data waiting
    * @returns A PFrameHandle for the created PFrame, or undefined if any required data is missing
    */
-  getAnchoredPColumns(anchorsOrCtx: AnchoredIdDeriver | Record<string, PColumnSpec | PlRef>, predicateOrSelectors: ((spec: PColumnSpec) => boolean) | APColumnSelectorWithSplit | APColumnSelectorWithSplit[], opts?: UniversalPColumnOpts): PColumn<PColumnDataUniversal>[] | undefined;
+  getAnchoredPColumns(anchorsOrCtx: AnchoredIdDeriver | Record<string, PColumnSpec | PlRef>, predicateOrSelectors: ((spec: PColumnSpec) => boolean) | APColumnSelectorWithSplit | APColumnSelectorWithSplit[], opts?: UniversalPColumnOpts): undefined | PColumn<undefined | PColumnDataUniversal>[];
   /**
    * Calculates anchored identifier options for columns matching a given predicate and returns their
    * canonicalized representations.
@@ -138,6 +153,9 @@ declare class ResultPool implements ColumnProvider, AxisLabelProvider {
    *
    * @param selectors - A predicate function, a single selector, or an array of selectors.
    * @returns An array of PColumn objects matching the selectors. Data is loaded on first access.
+   * @deprecated use `RenderCtxBase.rawResultPool` + `ResultPoolColumnsProvider` +
+   * `discoverColumns` instead. This eager path materializes column data
+   * unnecessarily for callers that only filter by spec.
    */
   selectColumns(selectors: ((spec: PColumnSpec) => boolean) | PColumnSelector | PColumnSelector[]): PColumn<TreeNodeAccessor | undefined>[];
   /**
@@ -148,7 +166,7 @@ declare class ResultPool implements ColumnProvider, AxisLabelProvider {
 }
 /** Main entry point to the API available within model lambdas (like outputs, sections, etc..) */
 declare abstract class RenderCtxBase<Args = unknown, Data = unknown> {
-  protected readonly ctx: GlobalCfgRenderCtx;
+  readonly ctx: GlobalCfgRenderCtx;
   constructor();
   private dataCache?;
   get data(): Data;
@@ -162,25 +180,17 @@ declare abstract class RenderCtxBase<Args = unknown, Data = unknown> {
   private getNamedAccessor;
   get prerun(): TreeNodeAccessor | undefined;
   get outputs(): TreeNodeAccessor | undefined;
+  /** @deprecated use `rawResultPool` + `ResultPoolColumnsProvider` instead. */
   readonly resultPool: ResultPool;
-  /**
-   * Find labels data for a given axis id. It will search for a label column and return its data as a map.
-   * @returns a map of axis value => label
-   * @deprecated Use resultPool.findLabels instead
-   */
-  findLabels(axis: AxisId): Record<string | number, string> | undefined;
-  private verifyInlineAndExplicitColumnsSupport;
   private patchPTableDef;
-  createPFrame(def: PFrameDef<PColumn<undefined | PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>>): PFrameHandle | undefined;
+  createPFrame(def: PFrameDef<PObjectId | SUniversalPColumnId | PColumn<undefined | PColumnDataUniversal>>): PFrameHandle | undefined;
   createPTable(def: PTableDef<PColumn<PColumnDataUniversal>>): PTableHandle | undefined;
   createPTable(def: {
     columns: PColumn<PColumnDataUniversal>[];
     filters?: PTableRecordFilter[]; /** Table sorting */
     sorting?: PTableSorting[];
   }): PTableHandle | undefined;
-  createPTableV2(def: PTableDefV2<PColumn<undefined | PColumnDataUniversal>>): PTableHandle | undefined;
-  /** @deprecated scheduled for removal from SDK */
-  getBlockLabel(blockId: string): string;
+  createPTableV2(def: PTableDefV2<ColumnUniversalId | PColumn<undefined | PColumnDataUniversal>>): PTableHandle | undefined;
   getCurrentUnstableMarker(): string | undefined;
   logInfo(msg: string): void;
   logWarn(msg: string): void;
@@ -225,5 +235,5 @@ type RenderFunctionLegacy<Args = unknown, State = unknown, Ret = unknown> = (rCt
 type UnwrapFutureRef<K> = K extends FutureRef<infer T> ? T : K extends bigint | boolean | null | number | string | symbol | undefined ? K : { [key in keyof K]: UnwrapFutureRef<K[key]> };
 type InferRenderFunctionReturn<RF extends AnyFunction> = RF extends ((...args: any) => infer R) ? UnwrapFutureRef<R> : never;
 //#endregion
-export { BlockRenderCtx, InferRenderFunctionReturn, PluginRenderCtx, RenderCtx, RenderCtxBase, RenderCtxLegacy, RenderFunction, RenderFunctionLegacy, ResultPool, UniversalColumnOption, UnwrapFutureRef };
+export { BlockRenderCtx, InferRenderFunctionReturn, PluginRenderCtx, RenderCtx, RenderCtxBase, RenderCtxLegacy, RenderFunction, RenderFunctionLegacy, ResultPool, UniversalColumnOption, UnwrapFutureRef, finalizePColumnData };
 //# sourceMappingURL=api.d.ts.map

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

@@ -9,8 +9,10 @@ import { patchInSetFilters } from "./util/pframe_upgraders.js";
 import { getService } from "../services/get_services.js";
 import "../services/index.js";
 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 { AnchoredIdDeriver, PColumnName, ensurePColumn, extractAllColumns, isDataInfo, isPColumn, isPColumnSpec, isPlRef, legacyColumnSelectorsToPredicate, mapDataInfo, mapPObjectData, mapPTableDef, mapPTableDefV2, mapValueInVOE, parseJson, readAnnotation, visitDataInfo, withEnrichments } from "@milaboratories/pl-model-common";
 import canonicalize from "canonicalize";
+import { throwError } from "@milaboratories/helpers";
+import { isString } from "es-toolkit";
 //#region src/render/api.ts
 /**
 * Helper function to match domain objects
@@ -26,24 +28,35 @@ function matchDomain(query, target) {
 }
 /**
 * Transforms PColumn data into the internal representation expected by the platform
-* @param data Data from a PColumn to transform
+* @param column Data from a PColumn to transform
 * @returns Transformed data compatible with platform API
 */
-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 ?? [];
+function finalizePColumnData(column) {
+	return mapPObjectData(column, (data) => {
+		if (data instanceof TreeNodeAccessor) return data.handle;
+		else if (isDataInfo(data)) {
+			let ready = true;
+			visitDataInfo(data, (accessor) => ready &&= accessor?.getIsReadyOrError() ?? false);
+			if (!ready) return [];
+			return mapDataInfo(data, (accessor) => accessor?.handle ?? throwError("Accessor handle is undefined"));
+		} else return data ?? [];
 	});
 }
+/**
+* @deprecated use the direct `ctx.*` methods on `RenderCtxBase` instead.
+*
+* Migration map:
+* - `getSpecs` → `ctx.getSpecs`
+* - `getSpecByRef` / `getPColumnSpecByRef` → `ctx.getSpecByRef` / `ctx.getPColumnSpecByRef`
+* - `getDataByRef` / `getPColumnByRef` → `ctx.getDataByRef` / `ctx.getPColumnByRef`
+* - `getOptions` → `ctx.getOptions`
+*
+* Eager methods `selectColumns` / `getData` / `getDataWithErrors` should be
+* replaced by `ctx.getSpecs` + on-demand `ctx.getStatusByRef` /
+* `ctx.getPColumnByRef` so that the data resource is not subscribed up-front.
+*/
 var ResultPool = class {
 	ctx = getCfgRenderCtx();
-	/**
-	* @deprecated use getOptions()
-	*/
-	calculateOptions(predicate) {
-		return this.ctx.calculateOptions(predicate);
-	}
 	getOptions(predicateOrSelector, opts) {
 		const predicate = typeof predicateOrSelector === "function" ? predicateOrSelector : legacyColumnSelectorsToPredicate(predicateOrSelector);
 		const filtered = this.getSpecs().entries.filter((s) => predicate(s.obj));
@@ -187,7 +200,6 @@ var ResultPool = class {
 	* @returns data associated with the ref
 	*/
 	getDataByRef(ref) {
-		if (typeof this.ctx.getDataFromResultPoolByRef === "undefined") return this.getData().entries.find((f) => f.ref.blockId === ref.blockId && f.ref.name === ref.name)?.obj;
 		const data = this.ctx.getDataFromResultPoolByRef(ref.blockId, ref.name);
 		if (!data) return void 0;
 		return mapPObjectData(data, (handle) => new TreeNodeAccessor(handle, [ref.blockId, ref.name]));
@@ -268,6 +280,9 @@ var ResultPool = class {
 	*
 	* @param selectors - A predicate function, a single selector, or an array of selectors.
 	* @returns An array of PColumn objects matching the selectors. Data is loaded on first access.
+	* @deprecated use `RenderCtxBase.rawResultPool` + `ResultPoolColumnsProvider` +
+	* `discoverColumns` instead. This eager path materializes column data
+	* unnecessarily for callers that only filter by spec.
 	*/
 	selectColumns(selectors) {
 		const predicate = typeof selectors === "function" ? selectors : legacyColumnSelectorsToPredicate(selectors);
@@ -345,20 +360,8 @@ var RenderCtxBase = class {
 	get outputs() {
 		return this.getNamedAccessor(MainAccessorName);
 	}
+	/** @deprecated use `rawResultPool` + `ResultPoolColumnsProvider` instead. */
 	resultPool = new ResultPool();
-	/**
-	* Find labels data for a given axis id. It will search for a label column and return its data as a map.
-	* @returns a map of axis value => label
-	* @deprecated Use resultPool.findLabels instead
-	*/
-	findLabels(axis) {
-		return this.resultPool.findLabels(axis);
-	}
-	verifyInlineAndExplicitColumnsSupport(columns) {
-		const hasInlineColumns = columns.some((c) => !(c.data instanceof TreeNodeAccessor) || isDataInfo(c.data));
-		const inlineColumnsSupport = this.ctx.featureFlags?.inlineColumnsSupport === true;
-		if (hasInlineColumns && !inlineColumnsSupport) throw Error(`Inline or explicit columns not supported`);
-	}
 	patchPTableDef(def) {
 		if (!this.ctx.featureFlags?.pTablePartitionFiltersSupport) def = {
 			...def,
@@ -373,7 +376,7 @@ var RenderCtxBase = class {
 		return def;
 	}
 	createPFrame(def) {
-		return this.ctx.createPFrame(def.map((c) => transformPColumnData(c)));
+		return this.ctx.createPFrame(def.map((v) => isString(v) ? v : finalizePColumnData(v)));
 	}
 	createPTable(def) {
 		let rawDef;
@@ -390,17 +393,11 @@ var RenderCtxBase = class {
 			sorting: def.sorting ?? []
 		});
 		else rawDef = this.patchPTableDef(def);
-		const columns = extractAllColumns(rawDef.src);
-		this.verifyInlineAndExplicitColumnsSupport(columns);
-		if (!allPColumnsReady(columns)) return void 0;
-		return this.ctx.createPTable(mapPTableDef(rawDef, (po) => transformPColumnData(po)));
+		if (!allPColumnsReady(extractAllColumns(rawDef.src))) return void 0;
+		return this.ctx.createPTable(mapPTableDef(rawDef, finalizePColumnData));
 	}
 	createPTableV2(def) {
-		return this.ctx.createPTableV2(mapPTableDefV2(def, (po) => transformPColumnData(po)));
-	}
-	/** @deprecated scheduled for removal from SDK */
-	getBlockLabel(blockId) {
-		return this.ctx.getBlockLabel(blockId);
+		return this.ctx.createPTableV2(mapPTableDefV2(def, { column: (v) => isString(v) ? v : finalizePColumnData(v) }));
 	}
 	getCurrentUnstableMarker() {
 		return this.ctx.getCurrentUnstableMarker();
@@ -486,6 +483,6 @@ var PluginRenderCtx = class extends RenderCtxBase {
 	}
 };
 //#endregion
-export { BlockRenderCtx, PluginRenderCtx, RenderCtxBase, RenderCtxLegacy, ResultPool };
+export { BlockRenderCtx, PluginRenderCtx, RenderCtxBase, RenderCtxLegacy, ResultPool, finalizePColumnData };
 
 //# sourceMappingURL=api.js.map