@platforma-sdk/model 1.61.0 → 1.62.0

package/dist/plugin_model.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin_model.js","names":[],"sources":["../src/plugin_model.ts"],"sourcesContent":["/**\n * PluginModel - Builder for creating plugin types with data model and outputs.\n *\n * Plugins are UI components with their own model logic and persistent state.\n * Block developers register plugin instances via BlockModelV3.plugin() method.\n *\n * @module plugin_model\n */\n\nimport type { BlockCodeKnownFeatureFlags } from \"@milaboratories/pl-model-common\";\nimport {\n  type DataModel,\n  DataModelBuilder,\n  type DataRecoverFn,\n  type DataVersioned,\n  type TransferTarget,\n} from \"./block_migrations\";\nimport { type PluginName, DATA_MODEL_LEGACY_VERSION } from \"./block_storage\";\nimport type { PluginFactoryLike } from \"./plugin_handle\";\nimport type { PluginRenderCtx } from \"./render\";\n\n/** Symbol for internal builder creation method */\nconst FROM_BUILDER = Symbol(\"fromBuilder\");\n\n/** Symbol for internal plugin model creation — not accessible to external consumers */\nexport const CREATE_PLUGIN_MODEL = Symbol(\"createPluginModel\");\n\n/** Sentinel for PluginInstance without transferAt — no transfer possible. */\nconst NO_TRANSFER_VERSION = \"\";\n\nexport type PluginData = Record<string, unknown>;\nexport type PluginParams = undefined | Record<string, unknown>;\nexport type PluginOutputs = Record<string, unknown>;\nexport type PluginConfig = undefined | Record<string, unknown>;\n\n/**\n * Plugin data model with typed migration chain and config-aware initialization.\n *\n * @typeParam Data - Current (latest) plugin data type\n * @typeParam Versions - Map of version keys to their data types (accumulated by the chain)\n * @typeParam Config - Config type passed to init function (undefined if none)\n */\nexport class PluginDataModel<\n  Data extends PluginData,\n  Versions extends Record<string, unknown> = {},\n  Config = undefined,\n> {\n  readonly dataModel: DataModel<Data>;\n  private readonly configInitFn: (config?: Config) => Data;\n\n  /** @internal Phantom field to anchor the Versions type parameter. */\n  declare readonly __versions?: Versions;\n\n  private constructor(dataModel: DataModel<Data>, configInitFn: (config?: Config) => Data) {\n    this.dataModel = dataModel;\n    this.configInitFn = configInitFn;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>, Config>(\n    dataModel: DataModel<Data>,\n    configInitFn: (config?: Config) => Data,\n  ): PluginDataModel<Data, Versions, Config> {\n    return new PluginDataModel<Data, Versions, Config>(dataModel, configInitFn);\n  }\n\n  /** Create fresh data with optional config. */\n  getDefaultData(config?: Config): DataVersioned<Data> {\n    const data = this.configInitFn(config);\n    return { version: this.dataModel.version, data };\n  }\n}\n\n/** Internal state for plugin data model chain. */\ntype PluginChainState = {\n  initialVersion: string;\n  migrations: Array<{ toVersion: string; fn: (data: unknown) => unknown }>;\n  recoverFn?: (version: string, data: unknown) => unknown;\n  recoverAtIndex?: number;\n};\n\n/**\n * Builder for creating PluginDataModel with type-safe migrations.\n * Mirrors DataModelBuilder — same .from(), .migrate(), .recover(), .init() chain.\n *\n * @example\n * const pluginData = new PluginDataModelBuilder()\n *   .from<TableData>(\"v1\")\n *   .migrate<FilteredTableData>(\"v2\", (v1) => ({ ...v1, filters: [] }))\n *   .init<TableConfig>((config?) => ({\n *     state: createDefaultState(config?.ops),\n *     filters: [],\n *   }));\n */\nexport class PluginDataModelBuilder {\n  from<Data extends PluginData, const V extends string>(\n    version: V,\n  ): PluginDataModelInitialChain<Data, Record<V, Data>> {\n    return PluginDataModelInitialChain[FROM_BUILDER]<Data, Record<V, Data>>({\n      initialVersion: version,\n      migrations: [],\n    });\n  }\n}\n\n/**\n * Chain returned by .migrate(). Supports .migrate(), .recover(), .init().\n * No .upgradeLegacy() — that is only available on the initial chain.\n */\nexport class PluginDataModelChain<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n> {\n  protected constructor(protected readonly state: PluginChainState) {}\n\n  /** @internal */\n  static [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>>(\n    state: PluginChainState,\n  ): PluginDataModelChain<Data, Versions> {\n    return new PluginDataModelChain(state);\n  }\n\n  /**\n   * Add a migration step transforming data from the current version to the next.\n   */\n  migrate<Next extends PluginData, const NextV extends string>(\n    version: NextV,\n    fn: (current: Data) => Next,\n  ): PluginDataModelChain<Next, Versions & Record<NextV, Next>> {\n    return PluginDataModelChain[FROM_BUILDER]<Next, Versions & Record<NextV, Next>>({\n      ...this.state,\n      migrations: [\n        ...this.state.migrations,\n        { toVersion: version, fn: fn as (data: unknown) => unknown },\n      ],\n    });\n  }\n\n  /**\n   * Set a recovery handler for unknown or legacy versions.\n   * Can only be called once — the returned chain has no recover() method.\n   */\n  recover(fn: DataRecoverFn<Data>): PluginDataModelWithRecover<Data, Versions> {\n    return PluginDataModelWithRecover[FROM_BUILDER]<Data, Versions>({\n      ...this.state,\n      recoverFn: fn as (version: string, data: unknown) => unknown,\n      recoverAtIndex: this.state.migrations.length,\n    });\n  }\n\n  /** Finalize the PluginDataModel. */\n  init<Config = undefined>(fn: (config?: Config) => Data): PluginDataModel<Data, Versions, Config> {\n    return buildPluginDataModel(this.state, fn);\n  }\n}\n\n/**\n * Initial chain returned by new PluginDataModelBuilder().from().\n * Extends PluginDataModelChain with .upgradeLegacy() — available only before\n * any .migrate() calls, matching the block's DataModelInitialChain pattern.\n */\nexport class PluginDataModelInitialChain<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n> extends PluginDataModelChain<Data, Versions> {\n  /** @internal */\n  static override [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>>(\n    state: PluginChainState,\n  ): PluginDataModelInitialChain<Data, Versions> {\n    return new PluginDataModelInitialChain(state);\n  }\n\n  /**\n   * Handle data from a previous plugin type occupying this slot.\n   * Prepends a migration from DATA_MODEL_LEGACY_VERSION to the initial version.\n   * When a plugin type changes, the old data arrives with DATA_MODEL_LEGACY_VERSION —\n   * this function transforms it into the initial version, then the normal chain runs.\n   *\n   * Must be called right after .from() — not available after .migrate().\n   * Mutually exclusive with recover().\n   *\n   * @param fn - Transform from old plugin's raw data to this plugin's initial data type\n   */\n  upgradeLegacy(fn: (data: unknown) => Data): PluginDataModelWithRecover<Data, Versions> {\n    return PluginDataModelWithRecover[FROM_BUILDER]<Data, Versions>({\n      ...this.state,\n      migrations: [\n        { toVersion: this.state.initialVersion, fn: fn as (data: unknown) => unknown },\n        ...this.state.migrations,\n      ],\n      initialVersion: DATA_MODEL_LEGACY_VERSION,\n    });\n  }\n}\n\n/**\n * Chain after .recover() — supports .migrate(), .init(). No second recover().\n */\nexport class PluginDataModelWithRecover<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n> {\n  private constructor(private readonly state: PluginChainState) {}\n\n  /** @internal */\n  static [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>>(\n    state: PluginChainState,\n  ): PluginDataModelWithRecover<Data, Versions> {\n    return new PluginDataModelWithRecover(state);\n  }\n\n  migrate<Next extends PluginData, const NextV extends string>(\n    version: NextV,\n    fn: (current: Data) => Next,\n  ): PluginDataModelWithRecover<Next, Versions & Record<NextV, Next>> {\n    return PluginDataModelWithRecover[FROM_BUILDER]<Next, Versions & Record<NextV, Next>>({\n      ...this.state,\n      migrations: [\n        ...this.state.migrations,\n        { toVersion: version, fn: fn as (data: unknown) => unknown },\n      ],\n    });\n  }\n\n  init<Config = undefined>(fn: (config?: Config) => Data): PluginDataModel<Data, Versions, Config> {\n    return buildPluginDataModel(this.state, fn);\n  }\n}\n\n/**\n * Builds a PluginDataModel by replaying the stored chain state through DataModelBuilder.\n * @internal\n */\nfunction buildPluginDataModel<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n  Config,\n>(\n  state: PluginChainState,\n  configInitFn: (config?: Config) => Data,\n): PluginDataModel<Data, Versions, Config> {\n  // Build inner DataModel by replaying migrations through DataModelBuilder chain.\n  // Uses `any` internally — type safety is maintained by the public chain types.\n  let chain: any = new DataModelBuilder().from(state.initialVersion);\n\n  for (let i = 0; i < state.migrations.length; i++) {\n    if (state.recoverFn !== undefined && state.recoverAtIndex === i) {\n      chain = chain.recover(state.recoverFn);\n    }\n    chain = chain.migrate(state.migrations[i].toVersion, state.migrations[i].fn);\n  }\n\n  // If recover was placed at or after the last migration\n  if (state.recoverFn !== undefined && state.recoverAtIndex === state.migrations.length) {\n    chain = chain.recover(state.recoverFn);\n  }\n\n  const dataModel: DataModel<Data> = chain.init(() => configInitFn());\n\n  return PluginDataModel[FROM_BUILDER]<Data, Versions, Config>(dataModel, configInitFn);\n}\n\n/**\n * A named plugin instance created by `factory.create({ pluginId, ... })`.\n * Passed to both `.transfer()` (on migration chain) and `.plugin()` (on BlockModelV3).\n * Implements TransferTarget so the migration chain can accept it.\n *\n * @typeParam Id - Plugin instance ID literal type\n * @typeParam Data - Plugin data type\n * @typeParam Params - Plugin params type\n * @typeParam Outputs - Plugin outputs type\n * @typeParam TransferData - Type of data entering the plugin via transfer (never if no transfer)\n */\nexport class PluginInstance<\n  Id extends string = string,\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  TransferData = never,\n> implements TransferTarget<Id, TransferData> {\n  readonly id: Id;\n  readonly transferVersion: string;\n  /** @internal */\n  readonly __transferBrand?: TransferData;\n  private readonly factory: PluginModelFactory<Data, Params, Outputs, any, any>;\n  private readonly config: any;\n\n  private constructor(\n    id: Id,\n    factory: PluginModelFactory<Data, Params, Outputs, any, any>,\n    transferVersion: string,\n    config?: any,\n  ) {\n    this.id = id;\n    this.factory = factory;\n    this.transferVersion = transferVersion;\n    this.config = config;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<\n    Id extends string,\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    TransferData,\n  >(\n    id: Id,\n    factory: PluginModelFactory<Data, Params, Outputs, any, any>,\n    transferVersion: string,\n    config?: any,\n  ): PluginInstance<Id, Data, Params, Outputs, TransferData> {\n    return new PluginInstance(id, factory, transferVersion, config);\n  }\n\n  /** @internal Create a PluginModel from this instance. Used by BlockModelV3.plugin(). */\n  [CREATE_PLUGIN_MODEL](): PluginModel<Data, Params, Outputs> {\n    return this.factory[CREATE_PLUGIN_MODEL](this.config);\n  }\n}\n\n/**\n * Configured plugin instance returned by PluginModelFactory[CREATE_PLUGIN_MODEL]().\n * Contains the plugin's name, data model, and output definitions.\n */\nexport class PluginModel<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n> {\n  /** Globally unique plugin name */\n  readonly name: PluginName;\n  /** Data model instance for this plugin */\n  readonly dataModel: DataModel<Data>;\n  /** Output definitions - functions that compute outputs from plugin context */\n  readonly outputs: {\n    [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n  };\n  /** Feature flags declared by this plugin */\n  readonly featureFlags?: BlockCodeKnownFeatureFlags;\n  /** Create fresh default data. Config (if any) is captured at creation time. */\n  readonly getDefaultData: () => DataVersioned<Data>;\n\n  private constructor(options: {\n    name: PluginName;\n    dataModel: DataModel<Data>;\n    outputs: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n    getDefaultData: () => DataVersioned<Data>;\n  }) {\n    this.name = options.name;\n    this.dataModel = options.dataModel;\n    this.outputs = options.outputs;\n    this.featureFlags = options.featureFlags;\n    this.getDefaultData = options.getDefaultData;\n  }\n\n  /**\n   * Internal method for creating PluginModel from factory.\n   * Uses Symbol key to prevent external access.\n   * @internal\n   */\n  static [FROM_BUILDER]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n  >(options: {\n    name: PluginName;\n    dataModel: DataModel<Data>;\n    outputs: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n    getDefaultData: () => DataVersioned<Data>;\n  }): PluginModel<Data, Params, Outputs> {\n    return new PluginModel<Data, Params, Outputs>(options);\n  }\n\n  /**\n   * Creates a new PluginModelBuilder with a PluginDataModel (supports transfer / config).\n   *\n   * @example\n   * const pluginData = new PluginDataModelBuilder().from<TableData>(\"v1\")\n   *   .migrate<FilteredTableData>(\"v2\", (v1) => ({ ...v1, filters: [] }))\n   *   .init<TableConfig>((config?) => ({\n   *     state: createDefaultState(config?.ops),\n   *     filters: [],\n   *   }));\n   *\n   * const myPlugin = PluginModel.define({\n   *   name: 'myPlugin' as PluginName,\n   *   data: pluginData,\n   * }).build();\n   */\n  static define<\n    Data extends PluginData,\n    Params extends PluginParams = undefined,\n    Versions extends Record<string, unknown> = {},\n    Config extends PluginConfig = undefined,\n  >(options: {\n    name: PluginName;\n    data: PluginDataModel<Data, Versions, Config>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder<Data, Params, {}, Config, Versions>;\n  /**\n   * Creates a new PluginModelBuilder with a data model factory function (backward compatible).\n   *\n   * @example\n   * const myPlugin = PluginModel.define({\n   *   name: 'myPlugin' as PluginName,\n   *   data: (cfg) => dataModelChain.init(() => ({ value: cfg.defaultValue })),\n   * }).build();\n   */\n  static define<\n    Data extends PluginData,\n    Params extends PluginParams = undefined,\n    Config extends PluginConfig = undefined,\n  >(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder<Data, Params, {}, Config, {}>;\n  static define(options: {\n    name: PluginName;\n    data: PluginDataModel<any, any, any> | ((config?: any) => DataModel<any>);\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder {\n    if (options.data instanceof PluginDataModel) {\n      const pdm = options.data;\n      return PluginModelBuilder[FROM_BUILDER]({\n        name: options.name,\n        dataFn: () => pdm.dataModel,\n        getDefaultDataFn: (config: any) => pdm.getDefaultData(config),\n        featureFlags: options.featureFlags,\n      });\n    }\n    return PluginModelBuilder[FROM_BUILDER]({\n      name: options.name,\n      dataFn: options.data,\n      featureFlags: options.featureFlags,\n    });\n  }\n}\n\n/** Plugin factory returned by PluginModelBuilder.build(). */\nexport interface PluginFactory<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  Config extends PluginConfig = undefined,\n  Versions extends Record<string, unknown> = {},\n> extends PluginFactoryLike<Data, Params, Outputs> {\n  /** Create a named plugin instance, optionally with transfer at a specific version. */\n  create<const Id extends string, const V extends string & keyof Versions = never>(options: {\n    pluginId: Id;\n    transferAt?: V;\n    config?: Config;\n  }): PluginInstance<Id, Data, Params, Outputs, Versions[V]>;\n\n  /**\n   * @internal Phantom field for structural type extraction.\n   * Enables InferFactoryData/InferFactoryOutputs to work via PluginFactoryLike.\n   */\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n    config: Config;\n    versions: Versions;\n  };\n}\n\nclass PluginModelFactory<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  Config extends PluginConfig = undefined,\n  Versions extends Record<string, unknown> = {},\n> implements PluginFactory<Data, Params, Outputs, Config, Versions> {\n  private readonly name: PluginName;\n  private readonly dataFn: (config?: Config) => DataModel<Data>;\n  private readonly getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n  readonly outputs: {\n    [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n  };\n  private readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  private constructor(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.dataFn = options.dataFn;\n    this.getDefaultDataFn = options.getDefaultDataFn;\n    this.outputs = options.outputs;\n    this.featureFlags = options.featureFlags;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    Config extends PluginConfig,\n    Versions extends Record<string, unknown>,\n  >(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelFactory<Data, Params, Outputs, Config, Versions> {\n    return new PluginModelFactory(options);\n  }\n\n  create<const Id extends string, const V extends string & keyof Versions = never>(options: {\n    pluginId: Id;\n    transferAt?: V;\n    config?: Config;\n  }): PluginInstance<Id, Data, Params, Outputs, Versions[V]> {\n    const transferVersion = options.transferAt ?? NO_TRANSFER_VERSION;\n    return PluginInstance[FROM_BUILDER]<Id, Data, Params, Outputs, Versions[V]>(\n      options.pluginId as Id,\n      this as any,\n      transferVersion,\n      options.config,\n    );\n  }\n\n  /** @internal Create a PluginModel from config. Config is captured in getDefaultData closure. */\n  [CREATE_PLUGIN_MODEL](config?: Config): PluginModel<Data, Params, Outputs> {\n    const dataModel = this.dataFn(config);\n    const getDefaultDataFn = this.getDefaultDataFn;\n    return PluginModel[FROM_BUILDER]<Data, Params, Outputs>({\n      name: this.name,\n      dataModel,\n      outputs: this.outputs,\n      featureFlags: this.featureFlags,\n      getDefaultData: getDefaultDataFn\n        ? () => getDefaultDataFn(config)\n        : () => dataModel.getDefaultData(),\n    });\n  }\n}\n\n/**\n * Builder for creating PluginType with type-safe output definitions.\n *\n * Use `PluginModel.define()` to create a builder instance.\n *\n * @typeParam Data - Plugin's persistent data type\n * @typeParam Params - Params derived from block's RenderCtx (optional)\n * @typeParam Config - Static configuration passed to plugin factory (optional)\n * @typeParam Outputs - Accumulated output types\n * @typeParam Versions - Version map from PluginDataModel (empty for function-based data)\n *\n * @example\n * const dataTable = PluginModel.define({\n *     name: 'dataTable' as PluginName,\n *     data: pluginDataModel,\n *   })\n *   .output('model', (ctx) => createTableModel(ctx))\n *   .build();\n */\nclass PluginModelBuilder<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  Config extends PluginConfig = undefined,\n  Versions extends Record<string, unknown> = {},\n> {\n  private readonly name: PluginName;\n  private readonly dataFn: (config?: Config) => DataModel<Data>;\n  private readonly getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n  private readonly outputs: {\n    [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n  };\n  private readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  private constructor(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs?: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.dataFn = options.dataFn;\n    this.getDefaultDataFn = options.getDefaultDataFn;\n    this.outputs =\n      options.outputs ??\n      ({} as {\n        [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n      });\n    this.featureFlags = options.featureFlags;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    Config extends PluginConfig,\n    Versions extends Record<string, unknown> = {},\n  >(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs?: {\n      [K in keyof Outputs]: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => Outputs[K];\n    };\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder<Data, Params, Outputs, Config, Versions> {\n    return new PluginModelBuilder(options);\n  }\n\n  /**\n   * Adds an output to the plugin.\n   *\n   * @param key - Output name\n   * @param fn - Function that computes the output value from plugin context\n   * @returns PluginModel with the new output added\n   *\n   * @example\n   * .output('model', (ctx) => createModel(ctx.params.columns, ctx.data.state))\n   * .output('isReady', (ctx) => ctx.params.columns !== undefined)\n   */\n  output<const Key extends string, T>(\n    key: Key,\n    fn: (ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>) => T,\n  ): PluginModelBuilder<Data, Params, Outputs & { [K in Key]: T }, Config, Versions> {\n    return new PluginModelBuilder<Data, Params, Outputs & { [K in Key]: T }, Config, Versions>({\n      name: this.name,\n      dataFn: this.dataFn,\n      getDefaultDataFn: this.getDefaultDataFn,\n      featureFlags: this.featureFlags,\n      outputs: {\n        ...this.outputs,\n        [key]: fn,\n      } as {\n        [K in keyof (Outputs & { [P in Key]: T })]: (\n          ctx: PluginRenderCtx<PluginFactoryLike<Data, Params>>,\n        ) => (Outputs & { [P in Key]: T })[K];\n      },\n    });\n  }\n\n  /**\n   * Finalizes the plugin definition and returns a PluginFactory.\n   *\n   * @returns Plugin factory that creates named plugin instances via .create()\n   *\n   * @example\n   * const myPlugin = PluginModel.define({ ... })\n   *   .output('value', (ctx) => ctx.data.value)\n   *   .build();\n   *\n   * // Create a named instance:\n   * const table = myPlugin.create({ pluginId: 'mainTable', config: { ... } });\n   */\n  build(): PluginFactory<Data, Params, Outputs, Config, Versions> {\n    return PluginModelFactory[FROM_BUILDER]<Data, Params, Outputs, Config, Versions>({\n      name: this.name,\n      dataFn: this.dataFn,\n      getDefaultDataFn: this.getDefaultDataFn,\n      outputs: this.outputs,\n      featureFlags: this.featureFlags,\n    });\n  }\n}\n"],"mappings":";;;;;AAsBA,MAAM,eAAe,OAAO,cAAc;;AAG1C,MAAa,sBAAsB,OAAO,oBAAoB;;AAG9D,MAAM,sBAAsB;;;;;;;;AAc5B,IAAa,kBAAb,MAAa,gBAIX;CACA,AAAS;CACT,AAAiB;CAKjB,AAAQ,YAAY,WAA4B,cAAyC;AACvF,OAAK,YAAY;AACjB,OAAK,eAAe;;;CAItB,QAAQ,cACN,WACA,cACyC;AACzC,SAAO,IAAI,gBAAwC,WAAW,aAAa;;;CAI7E,eAAe,QAAsC;EACnD,MAAM,OAAO,KAAK,aAAa,OAAO;AACtC,SAAO;GAAE,SAAS,KAAK,UAAU;GAAS;GAAM;;;;;;;;;;;;;;;;AAyBpD,IAAa,yBAAb,MAAoC;CAClC,KACE,SACoD;AACpD,SAAO,4BAA4B,cAAqC;GACtE,gBAAgB;GAChB,YAAY,EAAE;GACf,CAAC;;;;;;;AAQN,IAAa,uBAAb,MAAa,qBAGX;CACA,AAAU,YAAY,AAAmB,OAAyB;EAAzB;;;CAGzC,QAAQ,cACN,OACsC;AACtC,SAAO,IAAI,qBAAqB,MAAM;;;;;CAMxC,QACE,SACA,IAC4D;AAC5D,SAAO,qBAAqB,cAAoD;GAC9E,GAAG,KAAK;GACR,YAAY,CACV,GAAG,KAAK,MAAM,YACd;IAAE,WAAW;IAAa;IAAkC,CAC7D;GACF,CAAC;;;;;;CAOJ,QAAQ,IAAqE;AAC3E,SAAO,2BAA2B,cAA8B;GAC9D,GAAG,KAAK;GACR,WAAW;GACX,gBAAgB,KAAK,MAAM,WAAW;GACvC,CAAC;;;CAIJ,KAAyB,IAAwE;AAC/F,SAAO,qBAAqB,KAAK,OAAO,GAAG;;;;;;;;AAS/C,IAAa,8BAAb,MAAa,oCAGH,qBAAqC;;CAE7C,QAAiB,cACf,OAC6C;AAC7C,SAAO,IAAI,4BAA4B,MAAM;;;;;;;;;;;;;CAc/C,cAAc,IAAyE;AACrF,SAAO,2BAA2B,cAA8B;GAC9D,GAAG,KAAK;GACR,YAAY,CACV;IAAE,WAAW,KAAK,MAAM;IAAoB;IAAkC,EAC9E,GAAG,KAAK,MAAM,WACf;GACD,gBAAgB;GACjB,CAAC;;;;;;AAON,IAAa,6BAAb,MAAa,2BAGX;CACA,AAAQ,YAAY,AAAiB,OAAyB;EAAzB;;;CAGrC,QAAQ,cACN,OAC4C;AAC5C,SAAO,IAAI,2BAA2B,MAAM;;CAG9C,QACE,SACA,IACkE;AAClE,SAAO,2BAA2B,cAAoD;GACpF,GAAG,KAAK;GACR,YAAY,CACV,GAAG,KAAK,MAAM,YACd;IAAE,WAAW;IAAa;IAAkC,CAC7D;GACF,CAAC;;CAGJ,KAAyB,IAAwE;AAC/F,SAAO,qBAAqB,KAAK,OAAO,GAAG;;;;;;;AAQ/C,SAAS,qBAKP,OACA,cACyC;CAGzC,IAAI,QAAa,IAAI,kBAAkB,CAAC,KAAK,MAAM,eAAe;AAElE,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,WAAW,QAAQ,KAAK;AAChD,MAAI,MAAM,cAAc,UAAa,MAAM,mBAAmB,EAC5D,SAAQ,MAAM,QAAQ,MAAM,UAAU;AAExC,UAAQ,MAAM,QAAQ,MAAM,WAAW,GAAG,WAAW,MAAM,WAAW,GAAG,GAAG;;AAI9E,KAAI,MAAM,cAAc,UAAa,MAAM,mBAAmB,MAAM,WAAW,OAC7E,SAAQ,MAAM,QAAQ,MAAM,UAAU;CAGxC,MAAM,YAA6B,MAAM,WAAW,cAAc,CAAC;AAEnE,QAAO,gBAAgB,cAAsC,WAAW,aAAa;;;;;;;;;;;;;AAcvF,IAAa,iBAAb,MAAa,eAMiC;CAC5C,AAAS;CACT,AAAS;;CAET,AAAS;CACT,AAAiB;CACjB,AAAiB;CAEjB,AAAQ,YACN,IACA,SACA,iBACA,QACA;AACA,OAAK,KAAK;AACV,OAAK,UAAU;AACf,OAAK,kBAAkB;AACvB,OAAK,SAAS;;;CAIhB,QAAQ,cAON,IACA,SACA,iBACA,QACyD;AACzD,SAAO,IAAI,eAAe,IAAI,SAAS,iBAAiB,OAAO;;;CAIjE,CAAC,uBAA2D;AAC1D,SAAO,KAAK,QAAQ,qBAAqB,KAAK,OAAO;;;;;;;AAQzD,IAAa,cAAb,MAAa,YAIX;;CAEA,AAAS;;CAET,AAAS;;CAET,AAAS;;CAIT,AAAS;;CAET,AAAS;CAET,AAAQ,YAAY,SAQjB;AACD,OAAK,OAAO,QAAQ;AACpB,OAAK,YAAY,QAAQ;AACzB,OAAK,UAAU,QAAQ;AACvB,OAAK,eAAe,QAAQ;AAC5B,OAAK,iBAAiB,QAAQ;;;;;;;CAQhC,QAAQ,cAIN,SAQqC;AACrC,SAAO,IAAI,YAAmC,QAAQ;;CA+CxD,OAAO,OAAO,SAIS;AACrB,MAAI,QAAQ,gBAAgB,iBAAiB;GAC3C,MAAM,MAAM,QAAQ;AACpB,UAAO,mBAAmB,cAAc;IACtC,MAAM,QAAQ;IACd,cAAc,IAAI;IAClB,mBAAmB,WAAgB,IAAI,eAAe,OAAO;IAC7D,cAAc,QAAQ;IACvB,CAAC;;AAEJ,SAAO,mBAAmB,cAAc;GACtC,MAAM,QAAQ;GACd,QAAQ,QAAQ;GAChB,cAAc,QAAQ;GACvB,CAAC;;;AAgCN,IAAM,qBAAN,MAAM,mBAM8D;CAClE,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAS;CAGT,AAAiB;CAEjB,AAAQ,YAAY,SAQjB;AACD,OAAK,OAAO,QAAQ;AACpB,OAAK,SAAS,QAAQ;AACtB,OAAK,mBAAmB,QAAQ;AAChC,OAAK,UAAU,QAAQ;AACvB,OAAK,eAAe,QAAQ;;;CAI9B,QAAQ,cAMN,SAQ8D;AAC9D,SAAO,IAAI,mBAAmB,QAAQ;;CAGxC,OAAiF,SAItB;EACzD,MAAM,kBAAkB,QAAQ,cAAc;AAC9C,SAAO,eAAe,cACpB,QAAQ,UACR,MACA,iBACA,QAAQ,OACT;;;CAIH,CAAC,qBAAqB,QAAqD;EACzE,MAAM,YAAY,KAAK,OAAO,OAAO;EACrC,MAAM,mBAAmB,KAAK;AAC9B,SAAO,YAAY,cAAqC;GACtD,MAAM,KAAK;GACX;GACA,SAAS,KAAK;GACd,cAAc,KAAK;GACnB,gBAAgB,yBACN,iBAAiB,OAAO,SACxB,UAAU,gBAAgB;GACrC,CAAC;;;;;;;;;;;;;;;;;;;;;;AAuBN,IAAM,qBAAN,MAAM,mBAMJ;CACA,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAGjB,AAAiB;CAEjB,AAAQ,YAAY,SAQjB;AACD,OAAK,OAAO,QAAQ;AACpB,OAAK,SAAS,QAAQ;AACtB,OAAK,mBAAmB,QAAQ;AAChC,OAAK,UACH,QAAQ,WACP,EAAE;AAGL,OAAK,eAAe,QAAQ;;;CAI9B,QAAQ,cAMN,SAQ8D;AAC9D,SAAO,IAAI,mBAAmB,QAAQ;;;;;;;;;;;;;CAcxC,OACE,KACA,IACiF;AACjF,SAAO,IAAI,mBAAgF;GACzF,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,kBAAkB,KAAK;GACvB,cAAc,KAAK;GACnB,SAAS;IACP,GAAG,KAAK;KACP,MAAM;IACR;GAKF,CAAC;;;;;;;;;;;;;;;CAgBJ,QAAgE;AAC9D,SAAO,mBAAmB,cAAuD;GAC/E,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,kBAAkB,KAAK;GACvB,SAAS,KAAK;GACd,cAAc,KAAK;GACpB,CAAC"}
+{"version":3,"file":"plugin_model.js","names":[],"sources":["../src/plugin_model.ts"],"sourcesContent":["/**\n * PluginModel - Builder for creating plugin types with data model and outputs.\n *\n * Plugins are UI components with their own model logic and persistent state.\n * Block developers register plugin instances via BlockModelV3.plugin() method.\n *\n * @module plugin_model\n */\n\nimport type { BlockCodeKnownFeatureFlags, OutputWithStatus } from \"@milaboratories/pl-model-common\";\nimport type { ResolveModelServices, ResolveUiServices } from \"./services/service_resolve\";\nimport {\n  type DataModel,\n  DataModelBuilder,\n  type DataRecoverFn,\n  type DataVersioned,\n  type TransferTarget,\n} from \"./block_migrations\";\nimport { type PluginName, DATA_MODEL_LEGACY_VERSION } from \"./block_storage\";\nimport type { PluginFactoryLike } from \"./plugin_handle\";\nimport type { PluginRenderCtx } from \"./render\";\n\n/** Symbol for internal builder creation method */\nconst FROM_BUILDER = Symbol(\"fromBuilder\");\n\n/** Output function signature for plugin render context. */\ntype PluginOutputFn<\n  Data extends PluginData,\n  Params extends PluginParams,\n  ModelServices,\n  UiServices,\n  T,\n> = (\n  ctx: PluginRenderCtx<\n    PluginFactoryLike<Data, Params, Record<string, unknown>, ModelServices, UiServices>\n  >,\n) => T;\n\n/** Mapped output functions for a plugin's outputs. */\ntype PluginOutputFns<\n  Data extends PluginData,\n  Params extends PluginParams,\n  Outputs extends PluginOutputs,\n  ModelServices,\n  UiServices,\n> = {\n  [K in keyof Outputs]: PluginOutputFn<Data, Params, ModelServices, UiServices, Outputs[K]>;\n};\n\n/** Symbol for internal plugin model creation — not accessible to external consumers */\nexport const CREATE_PLUGIN_MODEL = Symbol(\"createPluginModel\");\n\n/** Sentinel for PluginInstance without transferAt — no transfer possible. */\nconst NO_TRANSFER_VERSION = \"\";\n\nexport type PluginData = Record<string, unknown>;\nexport type PluginParams = undefined | Record<string, unknown>;\nexport type PluginOutputs = Record<string, unknown>;\nexport type PluginConfig = undefined | Record<string, unknown>;\n\n/**\n * Plugin data model with typed migration chain and config-aware initialization.\n *\n * @typeParam Data - Current (latest) plugin data type\n * @typeParam Versions - Map of version keys to their data types (accumulated by the chain)\n * @typeParam Config - Config type passed to init function (undefined if none)\n */\nexport class PluginDataModel<\n  Data extends PluginData,\n  Versions extends Record<string, unknown> = {},\n  Config = undefined,\n> {\n  readonly dataModel: DataModel<Data>;\n  private readonly configInitFn: (config?: Config) => Data;\n\n  /** @internal Phantom field to anchor the Versions type parameter. */\n  declare readonly __versions?: Versions;\n\n  private constructor(dataModel: DataModel<Data>, configInitFn: (config?: Config) => Data) {\n    this.dataModel = dataModel;\n    this.configInitFn = configInitFn;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>, Config>(\n    dataModel: DataModel<Data>,\n    configInitFn: (config?: Config) => Data,\n  ): PluginDataModel<Data, Versions, Config> {\n    return new PluginDataModel<Data, Versions, Config>(dataModel, configInitFn);\n  }\n\n  /** Create fresh data with optional config. */\n  getDefaultData(config?: Config): DataVersioned<Data> {\n    const data = this.configInitFn(config);\n    return { version: this.dataModel.version, data };\n  }\n}\n\n/** Internal state for plugin data model chain. */\ntype PluginChainState = {\n  initialVersion: string;\n  migrations: Array<{ toVersion: string; fn: (data: unknown) => unknown }>;\n  recoverFn?: (version: string, data: unknown) => unknown;\n  recoverAtIndex?: number;\n};\n\n/** Version → persisted data shape for each migration step (third generic of `PluginModel.define` when `data` is a `PluginDataModel`). */\nexport type PluginDataModelVersions<\n  M extends PluginDataModel<PluginData, Record<string, unknown>, unknown>,\n> = M extends PluginDataModel<PluginData, infer Versions, unknown> ? Versions : never;\n\n/**\n * Builder for creating PluginDataModel with type-safe migrations.\n * Mirrors DataModelBuilder — same .from(), .migrate(), .recover(), .init() chain.\n *\n * @example\n * const pluginData = new PluginDataModelBuilder()\n *   .from<TableData>(\"v1\")\n *   .migrate<FilteredTableData>(\"v2\", (v1) => ({ ...v1, filters: [] }))\n *   .init<TableConfig>((config?) => ({\n *     state: createDefaultState(config?.ops),\n *     filters: [],\n *   }));\n */\nexport class PluginDataModelBuilder {\n  from<Data extends PluginData, const V extends string>(\n    version: V,\n  ): PluginDataModelInitialChain<Data, Record<V, Data>> {\n    return PluginDataModelInitialChain[FROM_BUILDER]<Data, Record<V, Data>>({\n      initialVersion: version,\n      migrations: [],\n    });\n  }\n}\n\n/**\n * Chain returned by .migrate(). Supports .migrate(), .recover(), .init().\n * No .upgradeLegacy() — that is only available on the initial chain.\n */\nexport class PluginDataModelChain<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n> {\n  protected constructor(protected readonly state: PluginChainState) {}\n\n  /** @internal */\n  static [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>>(\n    state: PluginChainState,\n  ): PluginDataModelChain<Data, Versions> {\n    return new PluginDataModelChain(state);\n  }\n\n  /**\n   * Add a migration step transforming data from the current version to the next.\n   */\n  migrate<Next extends PluginData, const NextV extends string>(\n    version: NextV,\n    fn: (current: Data) => Next,\n  ): PluginDataModelChain<Next, Versions & Record<NextV, Next>> {\n    return PluginDataModelChain[FROM_BUILDER]<Next, Versions & Record<NextV, Next>>({\n      ...this.state,\n      migrations: [\n        ...this.state.migrations,\n        { toVersion: version, fn: fn as (data: unknown) => unknown },\n      ],\n    });\n  }\n\n  /**\n   * Set a recovery handler for unknown or legacy versions.\n   * Can only be called once — the returned chain has no recover() method.\n   */\n  recover(fn: DataRecoverFn<Data>): PluginDataModelWithRecover<Data, Versions> {\n    return PluginDataModelWithRecover[FROM_BUILDER]<Data, Versions>({\n      ...this.state,\n      recoverFn: fn as (version: string, data: unknown) => unknown,\n      recoverAtIndex: this.state.migrations.length,\n    });\n  }\n\n  /** Finalize the PluginDataModel. */\n  init<Config = undefined>(fn: (config?: Config) => Data): PluginDataModel<Data, Versions, Config> {\n    return buildPluginDataModel(this.state, fn);\n  }\n}\n\n/**\n * Initial chain returned by new PluginDataModelBuilder().from().\n * Extends PluginDataModelChain with .upgradeLegacy() — available only before\n * any .migrate() calls, matching the block's DataModelInitialChain pattern.\n */\nexport class PluginDataModelInitialChain<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n> extends PluginDataModelChain<Data, Versions> {\n  /** @internal */\n  static override [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>>(\n    state: PluginChainState,\n  ): PluginDataModelInitialChain<Data, Versions> {\n    return new PluginDataModelInitialChain(state);\n  }\n\n  /**\n   * Handle data from a previous plugin type occupying this slot.\n   * Prepends a migration from DATA_MODEL_LEGACY_VERSION to the initial version.\n   * When a plugin type changes, the old data arrives with DATA_MODEL_LEGACY_VERSION —\n   * this function transforms it into the initial version, then the normal chain runs.\n   *\n   * Must be called right after .from() — not available after .migrate().\n   * Mutually exclusive with recover().\n   *\n   * @param fn - Transform from old plugin's raw data to this plugin's initial data type\n   */\n  upgradeLegacy(fn: (data: unknown) => Data): PluginDataModelWithRecover<Data, Versions> {\n    return PluginDataModelWithRecover[FROM_BUILDER]<Data, Versions>({\n      ...this.state,\n      migrations: [\n        { toVersion: this.state.initialVersion, fn: fn as (data: unknown) => unknown },\n        ...this.state.migrations,\n      ],\n      initialVersion: DATA_MODEL_LEGACY_VERSION,\n    });\n  }\n}\n\n/**\n * Chain after .recover() — supports .migrate(), .init(). No second recover().\n */\nexport class PluginDataModelWithRecover<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n> {\n  private constructor(private readonly state: PluginChainState) {}\n\n  /** @internal */\n  static [FROM_BUILDER]<Data extends PluginData, Versions extends Record<string, unknown>>(\n    state: PluginChainState,\n  ): PluginDataModelWithRecover<Data, Versions> {\n    return new PluginDataModelWithRecover(state);\n  }\n\n  migrate<Next extends PluginData, const NextV extends string>(\n    version: NextV,\n    fn: (current: Data) => Next,\n  ): PluginDataModelWithRecover<Next, Versions & Record<NextV, Next>> {\n    return PluginDataModelWithRecover[FROM_BUILDER]<Next, Versions & Record<NextV, Next>>({\n      ...this.state,\n      migrations: [\n        ...this.state.migrations,\n        { toVersion: version, fn: fn as (data: unknown) => unknown },\n      ],\n    });\n  }\n\n  init<Config = undefined>(fn: (config?: Config) => Data): PluginDataModel<Data, Versions, Config> {\n    return buildPluginDataModel(this.state, fn);\n  }\n}\n\n/**\n * Builds a PluginDataModel by replaying the stored chain state through DataModelBuilder.\n * @internal\n */\nfunction buildPluginDataModel<\n  Data extends PluginData,\n  Versions extends Record<string, unknown>,\n  Config,\n>(\n  state: PluginChainState,\n  configInitFn: (config?: Config) => Data,\n): PluginDataModel<Data, Versions, Config> {\n  // Build inner DataModel by replaying migrations through DataModelBuilder chain.\n  // Uses `any` internally — type safety is maintained by the public chain types.\n  let chain: any = new DataModelBuilder().from(state.initialVersion);\n\n  for (let i = 0; i < state.migrations.length; i++) {\n    if (state.recoverFn !== undefined && state.recoverAtIndex === i) {\n      chain = chain.recover(state.recoverFn);\n    }\n    chain = chain.migrate(state.migrations[i].toVersion, state.migrations[i].fn);\n  }\n\n  // If recover was placed at or after the last migration\n  if (state.recoverFn !== undefined && state.recoverAtIndex === state.migrations.length) {\n    chain = chain.recover(state.recoverFn);\n  }\n\n  const dataModel: DataModel<Data> = chain.init(() => configInitFn());\n\n  return PluginDataModel[FROM_BUILDER]<Data, Versions, Config>(dataModel, configInitFn);\n}\n\n/**\n * A named plugin instance created by `factory.create({ pluginId, ... })`.\n * Passed to both `.transfer()` (on migration chain) and `.plugin()` (on BlockModelV3).\n * Implements TransferTarget so the migration chain can accept it.\n *\n * @typeParam Id - Plugin instance ID literal type\n * @typeParam Data - Plugin data type\n * @typeParam Params - Plugin params type\n * @typeParam Outputs - Plugin outputs type\n * @typeParam TransferData - Type of data entering the plugin via transfer (never if no transfer)\n */\nexport class PluginInstance<\n  Id extends string = string,\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  TransferData = never,\n  ModelServices = unknown,\n  UiServices = unknown,\n> implements TransferTarget<Id, TransferData> {\n  readonly id: Id;\n  readonly transferVersion: string;\n  /** @internal Phantom for type inference; never set at runtime. */\n  readonly __instanceTypes?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n    modelServices: ModelServices;\n    uiServices: UiServices;\n  };\n  /** Bound closure that creates the PluginModel. Config is captured at factory.create() time. */\n  private readonly createPluginModel: () => PluginModel<\n    Data,\n    Params,\n    Outputs,\n    ModelServices,\n    UiServices\n  >;\n\n  private constructor(\n    id: Id,\n    createPluginModel: () => PluginModel<Data, Params, Outputs, ModelServices, UiServices>,\n    transferVersion: string,\n  ) {\n    this.id = id;\n    this.createPluginModel = createPluginModel;\n    this.transferVersion = transferVersion;\n  }\n\n  /** @internal Accepts concrete Config — binds it into a closure, avoiding Config variance issues. */\n  static [FROM_BUILDER]<\n    Id extends string,\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    TransferData,\n    Config extends PluginConfig = PluginConfig,\n    ModelServices = unknown,\n    UiServices = unknown,\n  >(\n    id: Id,\n    factory: PluginModelFactory<\n      Data,\n      Params,\n      Outputs,\n      Config,\n      Record<string, unknown>,\n      ModelServices,\n      UiServices\n    >,\n    transferVersion: string,\n    config?: Config,\n  ): PluginInstance<Id, Data, Params, Outputs, TransferData, ModelServices, UiServices> {\n    return new PluginInstance(id, () => factory[CREATE_PLUGIN_MODEL](config), transferVersion);\n  }\n\n  /** @internal Create a PluginModel from this instance. Used by BlockModelV3.plugin(). */\n  [CREATE_PLUGIN_MODEL](): PluginModel<Data, Params, Outputs, ModelServices, UiServices> {\n    return this.createPluginModel();\n  }\n}\n\n/**\n * Configured plugin instance returned by PluginModelFactory[CREATE_PLUGIN_MODEL]().\n * Contains the plugin's name, data model, and output definitions.\n */\nexport class PluginModel<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  ModelServices = {},\n  UiServices = {},\n> {\n  /** Globally unique plugin name */\n  readonly name: PluginName;\n  /** Data model instance for this plugin */\n  readonly dataModel: DataModel<Data>;\n  /** Output definitions - functions that compute outputs from plugin context */\n  readonly outputs: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n  /** Per-output flags (e.g. withStatus) */\n  readonly outputFlags: Record<string, { withStatus: boolean }>;\n  /** Feature flags declared by this plugin */\n  readonly featureFlags?: BlockCodeKnownFeatureFlags;\n  /** Create fresh default data. Config (if any) is captured at creation time. */\n  readonly getDefaultData: () => DataVersioned<Data>;\n\n  private constructor(options: {\n    name: PluginName;\n    dataModel: DataModel<Data>;\n    outputs: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n    outputFlags: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n    getDefaultData: () => DataVersioned<Data>;\n  }) {\n    this.name = options.name;\n    this.dataModel = options.dataModel;\n    this.outputs = options.outputs;\n    this.outputFlags = options.outputFlags;\n    this.featureFlags = options.featureFlags;\n    this.getDefaultData = options.getDefaultData;\n  }\n\n  /**\n   * Internal method for creating PluginModel from factory.\n   * Uses Symbol key to prevent external access.\n   * @internal\n   */\n  static [FROM_BUILDER]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    ModelServices = {},\n    UiServices = {},\n  >(options: {\n    name: PluginName;\n    dataModel: DataModel<Data>;\n    outputs: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n    outputFlags: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n    getDefaultData: () => DataVersioned<Data>;\n  }): PluginModel<Data, Params, Outputs, ModelServices, UiServices> {\n    return new PluginModel<Data, Params, Outputs, ModelServices, UiServices>(options);\n  }\n\n  /**\n   * Creates a new PluginModelBuilder with a PluginDataModel (supports transfer / config).\n   *\n   * @example\n   * const pluginData = new PluginDataModelBuilder().from<TableData>(\"v1\")\n   *   .migrate<FilteredTableData>(\"v2\", (v1) => ({ ...v1, filters: [] }))\n   *   .init<TableConfig>((config?) => ({\n   *     state: createDefaultState(config?.ops),\n   *     filters: [],\n   *   }));\n   *\n   * const myPlugin = PluginModel.define({\n   *   name: 'myPlugin' as PluginName,\n   *   data: pluginData,\n   * }).build();\n   */\n  static define<\n    Data extends PluginData,\n    Params extends PluginParams = undefined,\n    Versions extends Record<string, unknown> = {},\n    Config extends PluginConfig = undefined,\n    Flags extends BlockCodeKnownFeatureFlags = {},\n  >(options: {\n    name: PluginName;\n    data: PluginDataModel<Data, Versions, Config>;\n    featureFlags?: Flags;\n  }): PluginModelInitialBuilder<\n    Data,\n    Params,\n    Config,\n    Versions,\n    ResolveModelServices<Flags>,\n    ResolveUiServices<Flags>\n  >;\n  /**\n   * Creates a new PluginModelBuilder with a data model factory function (backward compatible).\n   *\n   * @example\n   * const myPlugin = PluginModel.define({\n   *   name: 'myPlugin' as PluginName,\n   *   data: (cfg) => dataModelChain.init(() => ({ value: cfg.defaultValue })),\n   * }).build();\n   */\n  static define<\n    Data extends PluginData,\n    Params extends PluginParams = undefined,\n    Config extends PluginConfig = undefined,\n    Flags extends BlockCodeKnownFeatureFlags = {},\n  >(options: {\n    name: PluginName;\n    data: (config?: Config) => DataModel<Data>;\n    featureFlags?: Flags;\n  }): PluginModelInitialBuilder<\n    Data,\n    Params,\n    Config,\n    {},\n    ResolveModelServices<Flags>,\n    ResolveUiServices<Flags>\n  >;\n  static define(options: {\n    name: PluginName;\n    data: PluginDataModel<any, any, any> | ((config?: any) => DataModel<any>);\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelInitialBuilder {\n    if (options.data instanceof PluginDataModel) {\n      const pdm = options.data;\n      return PluginModelInitialBuilder.create({\n        name: options.name,\n        dataFn: () => pdm.dataModel,\n        getDefaultDataFn: (config: any) => pdm.getDefaultData(config),\n        featureFlags: options.featureFlags,\n      });\n    }\n    return PluginModelInitialBuilder.create({\n      name: options.name,\n      dataFn: options.data,\n      featureFlags: options.featureFlags,\n    });\n  }\n}\n\n/** Plugin factory returned by PluginModelBuilder.build(). */\nexport interface PluginFactory<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  Config extends PluginConfig = undefined,\n  Versions extends Record<string, unknown> = {},\n  ModelServices = {},\n  UiServices = {},\n> extends PluginFactoryLike<Data, Params, Outputs, ModelServices, UiServices> {\n  /** Create a named plugin instance, optionally with transfer at a specific version. */\n  create<const Id extends string, const V extends string & keyof Versions = never>(options: {\n    pluginId: Id;\n    transferAt?: V;\n    config?: Config;\n  }): PluginInstance<Id, Data, Params, Outputs, Versions[V], ModelServices, UiServices>;\n\n  /**\n   * @internal Phantom field for structural type extraction.\n   * Enables InferFactoryData/InferFactoryOutputs to work via PluginFactoryLike.\n   */\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n    modelServices: ModelServices;\n    uiServices: UiServices;\n    config: Config;\n    versions: Versions;\n  };\n}\n\nclass PluginModelFactory<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  Config extends PluginConfig = undefined,\n  Versions extends Record<string, unknown> = {},\n  ModelServices = {},\n  UiServices = {},\n> implements PluginFactory<Data, Params, Outputs, Config, Versions, ModelServices, UiServices> {\n  private readonly name: PluginName;\n  private readonly dataFn: (config?: Config) => DataModel<Data>;\n  private readonly getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n  readonly outputs: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n  private readonly outputFlags: Record<string, { withStatus: boolean }>;\n  private readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  private constructor(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n    outputFlags: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.dataFn = options.dataFn;\n    this.getDefaultDataFn = options.getDefaultDataFn;\n    this.outputs = options.outputs;\n    this.outputFlags = options.outputFlags;\n    this.featureFlags = options.featureFlags;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    Config extends PluginConfig,\n    Versions extends Record<string, unknown>,\n    ModelServices = {},\n    UiServices = {},\n  >(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n    outputFlags: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelFactory<Data, Params, Outputs, Config, Versions, ModelServices, UiServices> {\n    return new PluginModelFactory(options);\n  }\n\n  create<const Id extends string, const V extends string & keyof Versions = never>(options: {\n    pluginId: Id;\n    transferAt?: V;\n    config?: Config;\n  }): PluginInstance<Id, Data, Params, Outputs, Versions[V], ModelServices, UiServices> {\n    const transferVersion = options.transferAt ?? NO_TRANSFER_VERSION;\n    return PluginInstance[FROM_BUILDER]<\n      Id,\n      Data,\n      Params,\n      Outputs,\n      Versions[V],\n      Config,\n      ModelServices,\n      UiServices\n    >(options.pluginId as Id, this, transferVersion, options.config);\n  }\n\n  /** @internal Create a PluginModel from config. Config is captured in getDefaultData closure. */\n  [CREATE_PLUGIN_MODEL](\n    config?: Config,\n  ): PluginModel<Data, Params, Outputs, ModelServices, UiServices> {\n    const dataModel = this.dataFn(config);\n    const getDefaultDataFn = this.getDefaultDataFn;\n    return PluginModel[FROM_BUILDER]<Data, Params, Outputs, ModelServices, UiServices>({\n      name: this.name,\n      dataModel,\n      outputs: this.outputs,\n      outputFlags: this.outputFlags,\n      featureFlags: this.featureFlags,\n      getDefaultData: getDefaultDataFn\n        ? () => getDefaultDataFn(config)\n        : () => dataModel.getDefaultData(),\n    });\n  }\n}\n\n/**\n * Builder for creating PluginType with type-safe output definitions.\n *\n * Use `PluginModel.define()` to create a builder instance.\n *\n * @typeParam Data - Plugin's persistent data type\n * @typeParam Params - Params derived from block's RenderCtx (optional)\n * @typeParam Config - Static configuration passed to plugin factory (optional)\n * @typeParam Outputs - Accumulated output types\n * @typeParam Versions - Version map from PluginDataModel (empty for function-based data)\n *\n * @example\n * const dataTable = PluginModel.define({\n *     name: 'dataTable' as PluginName,\n *     data: pluginDataModel,\n *   })\n *   .output('model', (ctx) => createTableModel(ctx))\n *   .build();\n */\nclass PluginModelBuilder<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n  Config extends PluginConfig = undefined,\n  Versions extends Record<string, unknown> = {},\n  ModelServices = {},\n  UiServices = {},\n> {\n  protected readonly name: PluginName;\n  protected readonly dataFn: (config?: Config) => DataModel<Data>;\n  protected readonly getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n  private readonly outputs: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n  private readonly outputFlags: Record<string, { withStatus: boolean }>;\n  protected readonly featureFlags?: BlockCodeKnownFeatureFlags;\n\n  protected constructor(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs?: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n    outputFlags?: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }) {\n    this.name = options.name;\n    this.dataFn = options.dataFn;\n    this.getDefaultDataFn = options.getDefaultDataFn;\n    this.outputs =\n      options.outputs ?? ({} as PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>);\n    this.outputFlags = options.outputFlags ?? {};\n    this.featureFlags = options.featureFlags;\n  }\n\n  /** @internal */\n  static [FROM_BUILDER]<\n    Data extends PluginData,\n    Params extends PluginParams,\n    Outputs extends PluginOutputs,\n    Config extends PluginConfig,\n    Versions extends Record<string, unknown> = {},\n    ModelServices = {},\n    UiServices = {},\n  >(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    outputs?: PluginOutputFns<Data, Params, Outputs, ModelServices, UiServices>;\n    outputFlags?: Record<string, { withStatus: boolean }>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelBuilder<Data, Params, Outputs, Config, Versions, ModelServices, UiServices> {\n    return new PluginModelBuilder(options);\n  }\n\n  /**\n   * Adds an output to the plugin.\n   *\n   * @param key - Output name\n   * @param fn - Function that computes the output value from plugin context\n   * @returns PluginModel with the new output added\n   *\n   * @example\n   * .output('model', (ctx) => createModel(ctx.params.columns, ctx.data.state))\n   * .output('isReady', (ctx) => ctx.params.columns !== undefined)\n   */\n  output<const Key extends string, T>(\n    key: Key,\n    fn: (\n      ctx: PluginRenderCtx<\n        PluginFactoryLike<Data, Params, Record<string, unknown>, ModelServices, UiServices>\n      >,\n    ) => T,\n  ): PluginModelBuilder<\n    Data,\n    Params,\n    Outputs & { [K in Key]: T },\n    Config,\n    Versions,\n    ModelServices,\n    UiServices\n  > {\n    return new PluginModelBuilder<\n      Data,\n      Params,\n      Outputs & { [K in Key]: T },\n      Config,\n      Versions,\n      ModelServices,\n      UiServices\n    >({\n      name: this.name,\n      dataFn: this.dataFn,\n      getDefaultDataFn: this.getDefaultDataFn,\n      featureFlags: this.featureFlags,\n      outputs: {\n        ...this.outputs,\n        [key]: fn,\n      } as {\n        [K in keyof (Outputs & { [P in Key]: T })]: (\n          ctx: PluginRenderCtx<\n            PluginFactoryLike<Data, Params, Record<string, unknown>, ModelServices, UiServices>\n          >,\n        ) => (Outputs & { [P in Key]: T })[K];\n      },\n      outputFlags: { ...this.outputFlags, [key]: { withStatus: false } },\n    });\n  }\n\n  /**\n   * Adds an output wrapped with status information to the plugin.\n   *\n   * The UI receives the full {@link OutputWithStatus} object instead of an unwrapped value,\n   * allowing it to distinguish between pending, success, and error states.\n   *\n   * @param key - Output name\n   * @param fn - Function that computes the output value from plugin context\n   * @returns PluginModel with the new status-wrapped output added\n   *\n   * @example\n   * .outputWithStatus('table', (ctx) => {\n   *   const pCols = ctx.params.pFrame?.getPColumns();\n   *   if (pCols === undefined) return undefined;\n   *   return createPlDataTableV2(ctx, pCols, ctx.data.tableState);\n   * })\n   */\n  outputWithStatus<const Key extends string, T>(\n    key: Key,\n    fn: (\n      ctx: PluginRenderCtx<\n        PluginFactoryLike<Data, Params, Record<string, unknown>, ModelServices, UiServices>\n      >,\n    ) => T,\n  ): PluginModelBuilder<\n    Data,\n    Params,\n    Outputs & { [K in Key]: OutputWithStatus<T> },\n    Config,\n    Versions,\n    ModelServices,\n    UiServices\n  > {\n    return new PluginModelBuilder<\n      Data,\n      Params,\n      Outputs & { [K in Key]: OutputWithStatus<T> },\n      Config,\n      Versions,\n      ModelServices,\n      UiServices\n    >({\n      name: this.name,\n      dataFn: this.dataFn,\n      getDefaultDataFn: this.getDefaultDataFn,\n      featureFlags: this.featureFlags,\n      outputs: {\n        ...this.outputs,\n        [key]: fn,\n      } as {\n        [K in keyof (Outputs & { [P in Key]: OutputWithStatus<T> })]: (\n          ctx: PluginRenderCtx<\n            PluginFactoryLike<Data, Params, Record<string, unknown>, ModelServices, UiServices>\n          >,\n        ) => (Outputs & { [P in Key]: OutputWithStatus<T> })[K];\n      },\n      outputFlags: { ...this.outputFlags, [key]: { withStatus: true } },\n    });\n  }\n\n  /**\n   * Finalizes the plugin definition and returns a PluginFactory.\n   *\n   * @returns Plugin factory that creates named plugin instances via .create()\n   *\n   * @example\n   * const myPlugin = PluginModel.define({ ... })\n   *   .output('value', (ctx) => ctx.data.value)\n   *   .build();\n   *\n   * // Create a named instance:\n   * const table = myPlugin.create({ pluginId: 'mainTable', config: { ... } });\n   */\n  build(): PluginFactory<Data, Params, Outputs, Config, Versions, ModelServices, UiServices> {\n    return PluginModelFactory[FROM_BUILDER]<\n      Data,\n      Params,\n      Outputs,\n      Config,\n      Versions,\n      ModelServices,\n      UiServices\n    >({\n      name: this.name,\n      dataFn: this.dataFn,\n      getDefaultDataFn: this.getDefaultDataFn,\n      outputs: this.outputs,\n      outputFlags: this.outputFlags,\n      featureFlags: this.featureFlags,\n    });\n  }\n}\n\n/**\n * Initial builder returned by PluginModel.define(). Extends PluginModelBuilder with .params().\n * Once .params() or .output() is called, transitions to PluginModelBuilder (no second .params()).\n */\nclass PluginModelInitialBuilder<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Config extends PluginConfig = undefined,\n  Versions extends Record<string, unknown> = {},\n  ModelServices = {},\n  UiServices = {},\n> extends PluginModelBuilder<Data, Params, {}, Config, Versions, ModelServices, UiServices> {\n  /** @internal */\n  static create<\n    Data extends PluginData,\n    Config extends PluginConfig,\n    Versions extends Record<string, unknown> = {},\n    ModelServices = {},\n    UiServices = {},\n  >(options: {\n    name: PluginName;\n    dataFn: (config?: Config) => DataModel<Data>;\n    getDefaultDataFn?: (config?: Config) => DataVersioned<Data>;\n    featureFlags?: BlockCodeKnownFeatureFlags;\n  }): PluginModelInitialBuilder<Data, undefined, Config, Versions, ModelServices, UiServices> {\n    return new PluginModelInitialBuilder(options);\n  }\n\n  /**\n   * Sets the Params type for this plugin — the shape of data derived from the block's\n   * render context and passed into plugin output functions via `ctx.params`.\n   * Must be called before .output(). Available only on the initial builder.\n   *\n   * @example\n   * .params<{ title: string }>()\n   * .output('displayText', (ctx) => ctx.params.title)\n   */\n  params<P extends PluginParams>(): PluginModelBuilder<\n    Data,\n    P,\n    {},\n    Config,\n    Versions,\n    ModelServices,\n    UiServices\n  > {\n    return PluginModelBuilder[FROM_BUILDER]<\n      Data,\n      P,\n      {},\n      Config,\n      Versions,\n      ModelServices,\n      UiServices\n    >({\n      name: this.name,\n      dataFn: this.dataFn,\n      getDefaultDataFn: this.getDefaultDataFn,\n      featureFlags: this.featureFlags,\n    });\n  }\n}\n"],"mappings":";;;;;AAuBA,MAAM,eAAe,OAAO,cAAc;;AA2B1C,MAAa,sBAAsB,OAAO,oBAAoB;;AAG9D,MAAM,sBAAsB;;;;;;;;AAc5B,IAAa,kBAAb,MAAa,gBAIX;CACA,AAAS;CACT,AAAiB;CAKjB,AAAQ,YAAY,WAA4B,cAAyC;AACvF,OAAK,YAAY;AACjB,OAAK,eAAe;;;CAItB,QAAQ,cACN,WACA,cACyC;AACzC,SAAO,IAAI,gBAAwC,WAAW,aAAa;;;CAI7E,eAAe,QAAsC;EACnD,MAAM,OAAO,KAAK,aAAa,OAAO;AACtC,SAAO;GAAE,SAAS,KAAK,UAAU;GAAS;GAAM;;;;;;;;;;;;;;;;AA8BpD,IAAa,yBAAb,MAAoC;CAClC,KACE,SACoD;AACpD,SAAO,4BAA4B,cAAqC;GACtE,gBAAgB;GAChB,YAAY,EAAE;GACf,CAAC;;;;;;;AAQN,IAAa,uBAAb,MAAa,qBAGX;CACA,AAAU,YAAY,AAAmB,OAAyB;EAAzB;;;CAGzC,QAAQ,cACN,OACsC;AACtC,SAAO,IAAI,qBAAqB,MAAM;;;;;CAMxC,QACE,SACA,IAC4D;AAC5D,SAAO,qBAAqB,cAAoD;GAC9E,GAAG,KAAK;GACR,YAAY,CACV,GAAG,KAAK,MAAM,YACd;IAAE,WAAW;IAAa;IAAkC,CAC7D;GACF,CAAC;;;;;;CAOJ,QAAQ,IAAqE;AAC3E,SAAO,2BAA2B,cAA8B;GAC9D,GAAG,KAAK;GACR,WAAW;GACX,gBAAgB,KAAK,MAAM,WAAW;GACvC,CAAC;;;CAIJ,KAAyB,IAAwE;AAC/F,SAAO,qBAAqB,KAAK,OAAO,GAAG;;;;;;;;AAS/C,IAAa,8BAAb,MAAa,oCAGH,qBAAqC;;CAE7C,QAAiB,cACf,OAC6C;AAC7C,SAAO,IAAI,4BAA4B,MAAM;;;;;;;;;;;;;CAc/C,cAAc,IAAyE;AACrF,SAAO,2BAA2B,cAA8B;GAC9D,GAAG,KAAK;GACR,YAAY,CACV;IAAE,WAAW,KAAK,MAAM;IAAoB;IAAkC,EAC9E,GAAG,KAAK,MAAM,WACf;GACD,gBAAgB;GACjB,CAAC;;;;;;AAON,IAAa,6BAAb,MAAa,2BAGX;CACA,AAAQ,YAAY,AAAiB,OAAyB;EAAzB;;;CAGrC,QAAQ,cACN,OAC4C;AAC5C,SAAO,IAAI,2BAA2B,MAAM;;CAG9C,QACE,SACA,IACkE;AAClE,SAAO,2BAA2B,cAAoD;GACpF,GAAG,KAAK;GACR,YAAY,CACV,GAAG,KAAK,MAAM,YACd;IAAE,WAAW;IAAa;IAAkC,CAC7D;GACF,CAAC;;CAGJ,KAAyB,IAAwE;AAC/F,SAAO,qBAAqB,KAAK,OAAO,GAAG;;;;;;;AAQ/C,SAAS,qBAKP,OACA,cACyC;CAGzC,IAAI,QAAa,IAAI,kBAAkB,CAAC,KAAK,MAAM,eAAe;AAElE,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,WAAW,QAAQ,KAAK;AAChD,MAAI,MAAM,cAAc,UAAa,MAAM,mBAAmB,EAC5D,SAAQ,MAAM,QAAQ,MAAM,UAAU;AAExC,UAAQ,MAAM,QAAQ,MAAM,WAAW,GAAG,WAAW,MAAM,WAAW,GAAG,GAAG;;AAI9E,KAAI,MAAM,cAAc,UAAa,MAAM,mBAAmB,MAAM,WAAW,OAC7E,SAAQ,MAAM,QAAQ,MAAM,UAAU;CAGxC,MAAM,YAA6B,MAAM,WAAW,cAAc,CAAC;AAEnE,QAAO,gBAAgB,cAAsC,WAAW,aAAa;;;;;;;;;;;;;AAcvF,IAAa,iBAAb,MAAa,eAQiC;CAC5C,AAAS;CACT,AAAS;;CAET,AAAS;;CAQT,AAAiB;CAQjB,AAAQ,YACN,IACA,mBACA,iBACA;AACA,OAAK,KAAK;AACV,OAAK,oBAAoB;AACzB,OAAK,kBAAkB;;;CAIzB,QAAQ,cAUN,IACA,SASA,iBACA,QACoF;AACpF,SAAO,IAAI,eAAe,UAAU,QAAQ,qBAAqB,OAAO,EAAE,gBAAgB;;;CAI5F,CAAC,uBAAsF;AACrF,SAAO,KAAK,mBAAmB;;;;;;;AAQnC,IAAa,cAAb,MAAa,YAMX;;CAEA,AAAS;;CAET,AAAS;;CAET,AAAS;;CAET,AAAS;;CAET,AAAS;;CAET,AAAS;CAET,AAAQ,YAAY,SAOjB;AACD,OAAK,OAAO,QAAQ;AACpB,OAAK,YAAY,QAAQ;AACzB,OAAK,UAAU,QAAQ;AACvB,OAAK,cAAc,QAAQ;AAC3B,OAAK,eAAe,QAAQ;AAC5B,OAAK,iBAAiB,QAAQ;;;;;;;CAQhC,QAAQ,cAMN,SAOgE;AAChE,SAAO,IAAI,YAA8D,QAAQ;;CA+DnF,OAAO,OAAO,SAIgB;AAC5B,MAAI,QAAQ,gBAAgB,iBAAiB;GAC3C,MAAM,MAAM,QAAQ;AACpB,UAAO,0BAA0B,OAAO;IACtC,MAAM,QAAQ;IACd,cAAc,IAAI;IAClB,mBAAmB,WAAgB,IAAI,eAAe,OAAO;IAC7D,cAAc,QAAQ;IACvB,CAAC;;AAEJ,SAAO,0BAA0B,OAAO;GACtC,MAAM,QAAQ;GACd,QAAQ,QAAQ;GAChB,cAAc,QAAQ;GACvB,CAAC;;;AAoCN,IAAM,qBAAN,MAAM,mBAQyF;CAC7F,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAS;CACT,AAAiB;CACjB,AAAiB;CAEjB,AAAQ,YAAY,SAOjB;AACD,OAAK,OAAO,QAAQ;AACpB,OAAK,SAAS,QAAQ;AACtB,OAAK,mBAAmB,QAAQ;AAChC,OAAK,UAAU,QAAQ;AACvB,OAAK,cAAc,QAAQ;AAC3B,OAAK,eAAe,QAAQ;;;CAI9B,QAAQ,cAQN,SAOyF;AACzF,SAAO,IAAI,mBAAmB,QAAQ;;CAGxC,OAAiF,SAIK;EACpF,MAAM,kBAAkB,QAAQ,cAAc;AAC9C,SAAO,eAAe,cASpB,QAAQ,UAAgB,MAAM,iBAAiB,QAAQ,OAAO;;;CAIlE,CAAC,qBACC,QAC+D;EAC/D,MAAM,YAAY,KAAK,OAAO,OAAO;EACrC,MAAM,mBAAmB,KAAK;AAC9B,SAAO,YAAY,cAAgE;GACjF,MAAM,KAAK;GACX;GACA,SAAS,KAAK;GACd,aAAa,KAAK;GAClB,cAAc,KAAK;GACnB,gBAAgB,yBACN,iBAAiB,OAAO,SACxB,UAAU,gBAAgB;GACrC,CAAC;;;;;;;;;;;;;;;;;;;;;;AAuBN,IAAM,qBAAN,MAAM,mBAQJ;CACA,AAAmB;CACnB,AAAmB;CACnB,AAAmB;CACnB,AAAiB;CACjB,AAAiB;CACjB,AAAmB;CAEnB,AAAU,YAAY,SAOnB;AACD,OAAK,OAAO,QAAQ;AACpB,OAAK,SAAS,QAAQ;AACtB,OAAK,mBAAmB,QAAQ;AAChC,OAAK,UACH,QAAQ,WAAY,EAAE;AACxB,OAAK,cAAc,QAAQ,eAAe,EAAE;AAC5C,OAAK,eAAe,QAAQ;;;CAI9B,QAAQ,cAQN,SAOyF;AACzF,SAAO,IAAI,mBAAmB,QAAQ;;;;;;;;;;;;;CAcxC,OACE,KACA,IAaA;AACA,SAAO,IAAI,mBAQT;GACA,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,kBAAkB,KAAK;GACvB,cAAc,KAAK;GACnB,SAAS;IACP,GAAG,KAAK;KACP,MAAM;IACR;GAOD,aAAa;IAAE,GAAG,KAAK;KAAc,MAAM,EAAE,YAAY,OAAO;IAAE;GACnE,CAAC;;;;;;;;;;;;;;;;;;;CAoBJ,iBACE,KACA,IAaA;AACA,SAAO,IAAI,mBAQT;GACA,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,kBAAkB,KAAK;GACvB,cAAc,KAAK;GACnB,SAAS;IACP,GAAG,KAAK;KACP,MAAM;IACR;GAOD,aAAa;IAAE,GAAG,KAAK;KAAc,MAAM,EAAE,YAAY,MAAM;IAAE;GAClE,CAAC;;;;;;;;;;;;;;;CAgBJ,QAA2F;AACzF,SAAO,mBAAmB,cAQxB;GACA,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,kBAAkB,KAAK;GACvB,SAAS,KAAK;GACd,aAAa,KAAK;GAClB,cAAc,KAAK;GACpB,CAAC;;;;;;;AAQN,IAAM,4BAAN,MAAM,kCAOI,mBAAkF;;CAE1F,OAAO,OAML,SAK0F;AAC1F,SAAO,IAAI,0BAA0B,QAAQ;;;;;;;;;;;CAY/C,SAQE;AACA,SAAO,mBAAmB,cAQxB;GACA,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,kBAAkB,KAAK;GACvB,cAAc,KAAK;GACpB,CAAC"}

package/dist/render/api.cjs

@@ -308,8 +308,18 @@ var ResultPool = class {
 /** Main entry point to the API available within model lambdas (like outputs, sections, etc..) */
 var RenderCtxBase = class {
 	ctx;
-	constructor() {
+	requiredServiceNames;
+	cachedServices;
+	constructor(requiredServiceNames = []) {
 		this.ctx = require_internal.getCfgRenderCtx();
+		this.requiredServiceNames = requiredServiceNames;
+	}
+	get services() {
+		if (this.cachedServices) return this.cachedServices;
+		const ctx = this.ctx;
+		const services = Object.freeze(Object.fromEntries(this.requiredServiceNames.map((id) => [id, Object.freeze(Object.fromEntries(ctx.getServiceMethods(id).map((method) => [method, (...args) => ctx.callServiceMethod(id, method, ...args)])))])));
+		this.cachedServices = services;
+		return services;
 	}
 	dataCache;
 	get data() {
@@ -404,27 +414,6 @@ var RenderCtxBase = class {
 	getBlockLabel(blockId) {
 		return this.ctx.getBlockLabel(blockId);
 	}
-	createSpecFrame(specs) {
-		return this.ctx.createSpecFrame(specs);
-	}
-	specFrameDiscoverColumns(handle, request) {
-		return this.ctx.specFrameDiscoverColumns(handle, request);
-	}
-	disposeSpecFrame(handle) {
-		this.ctx.disposeSpecFrame(handle);
-	}
-	expandAxes(spec) {
-		return this.ctx.expandAxes(spec);
-	}
-	collapseAxes(ids) {
-		return this.ctx.collapseAxes(ids);
-	}
-	findAxis(spec, selector) {
-		return this.ctx.findAxis(spec, selector);
-	}
-	findTableColumn(tableSpec, selector) {
-		return this.ctx.findTableColumn(tableSpec, selector);
-	}
 	getCurrentUnstableMarker() {
 		return this.ctx.getCurrentUnstableMarker();
 	}
@@ -480,20 +469,19 @@ var RenderCtxLegacy = class extends RenderCtxBase {
 *
 * @typeParam F - PluginFactoryLike phantom carrying data/params/outputs types
 */
-var PluginRenderCtx = class {
-	ctx;
+var PluginRenderCtx = class extends RenderCtxBase {
 	handle;
 	wrappedInputs;
-	constructor(handle, wrappedInputs) {
-		this.ctx = require_internal.getCfgRenderCtx();
+	constructor(handle, wrappedInputs, requiredServiceNames = []) {
+		super(requiredServiceNames);
 		this.handle = handle;
 		this.wrappedInputs = wrappedInputs;
 	}
-	dataCache;
+	pluginDataCache;
 	/** Plugin's persistent data from blockStorage.__plugins.{pluginId}.__data */
 	get data() {
-		if (this.dataCache === void 0) this.dataCache = { v: require_block_storage.getPluginData((0, _milaboratories_pl_model_common.parseJson)(this.ctx.blockStorage()), this.handle) };
-		return this.dataCache.v;
+		if (this.pluginDataCache === void 0) this.pluginDataCache = { v: require_block_storage.getPluginData((0, _milaboratories_pl_model_common.parseJson)(this.ctx.blockStorage()), this.handle) };
+		return this.pluginDataCache.v;
 	}
 	paramsCache;
 	/** Params derived from block context via pre-wrapped input callbacks */
@@ -505,8 +493,6 @@ var PluginRenderCtx = class {
 		}
 		return this.paramsCache.v;
 	}
-	/** Result pool — same as block, from cfgRenderCtx methods */
-	resultPool = new ResultPool();
 };
 
 //#endregion

package/dist/render/api.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"api.cjs","names":["TreeNodeAccessor","getCfgRenderCtx","deriveLabels","AnchoredIdDeriver","PColumnCollection","PColumnName","ifDef","StagingAccessorName","MainAccessorName","patchInSetFilters","allPColumnsReady","getPluginData"],"sources":["../../src/render/api.ts"],"sourcesContent":["import type {\n  AnchoredPColumnSelector,\n  AnyFunction,\n  AxesId,\n  AxesSpec,\n  AxisId,\n  DataInfo,\n  DiscoverColumnsRequest,\n  DiscoverColumnsResponse,\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  PTableColumnId,\n  PTableColumnSpec,\n  PTableDef,\n  PTableDefV2,\n  PTableHandle,\n  PTableRecordFilter,\n  PTableSorting,\n  PlRef,\n  ResolveAnchorsOptions,\n  ResultCollection,\n  SingleAxisSelector,\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\";\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  // /** 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<PColumn<PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>>,\n  ): PFrameHandle | undefined {\n    this.verifyInlineAndExplicitColumnsSupport(def);\n    if (!allPColumnsReady(def)) return 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(def: PTableDefV2<PColumn<PColumnDataUniversal>>): PTableHandle | undefined {\n    const columns = collectSpecQueryColumns(def.query);\n    this.verifyInlineAndExplicitColumnsSupport(columns);\n    if (!allPColumnsReady(columns)) return 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  //\n  // Spec Frames\n  //\n\n  public createSpecFrame(specs: Record<string, PColumnSpec>): string {\n    return this.ctx.createSpecFrame(specs);\n  }\n\n  public specFrameDiscoverColumns(\n    handle: string,\n    request: DiscoverColumnsRequest,\n  ): DiscoverColumnsResponse {\n    return this.ctx.specFrameDiscoverColumns(handle, request);\n  }\n\n  public disposeSpecFrame(handle: string): void {\n    this.ctx.disposeSpecFrame(handle);\n  }\n\n  public expandAxes(spec: AxesSpec): AxesId {\n    return this.ctx.expandAxes(spec);\n  }\n\n  public collapseAxes(ids: AxesId): AxesSpec {\n    return this.ctx.collapseAxes(ids);\n  }\n\n  public findAxis(spec: AxesSpec, selector: SingleAxisSelector): number {\n    return this.ctx.findAxis(spec, selector);\n  }\n\n  public findTableColumn(tableSpec: PTableColumnSpec[], selector: PTableColumnId): number {\n    return this.ctx.findTableColumn(tableSpec, selector);\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> {\n  private readonly ctx: GlobalCfgRenderCtx;\n  private readonly handle: PluginHandle<F>;\n  private readonly wrappedInputs: Record<string, () => unknown>;\n\n  constructor(handle: PluginHandle<F>, wrappedInputs: Record<string, () => unknown>) {\n    this.ctx = getCfgRenderCtx();\n    this.handle = handle;\n    this.wrappedInputs = wrappedInputs;\n  }\n\n  private dataCache?: { v: InferFactoryData<F> };\n\n  /** Plugin's persistent data from blockStorage.__plugins.{pluginId}.__data */\n  public get data(): InferFactoryData<F> {\n    if (this.dataCache === undefined) {\n      const raw = this.ctx.blockStorage();\n      this.dataCache = { v: getPluginData(parseJson(raw), this.handle) };\n    }\n    return this.dataCache.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  /** Result pool — same as block, from cfgRenderCtx methods */\n  public readonly resultPool = new ResultPool();\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","ifDef","StagingAccessorName","MainAccessorName","patchInSetFilters","allPColumnsReady","getPluginData"],"sources":["../../src/render/api.ts"],"sourcesContent":["import type {\n  AnchoredPColumnSelector,\n  AnyFunction,\n  AxisId,\n  DataInfo,\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  ServiceName,\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  InferFactoryModelServices,\n  InferFactoryParams,\n} from \"../plugin_handle\";\nimport type { BlockDefaultModelServices } from \"../services/service_resolve\";\nimport type { ModelServices as AllModelServices } from \"@milaboratories/pl-model-common\";\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\";\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<\n  Args = unknown,\n  Data = unknown,\n  ModelServices = Partial<AllModelServices>,\n> {\n  protected readonly ctx: GlobalCfgRenderCtx;\n  private readonly requiredServiceNames: ServiceName[];\n  private cachedServices?: ModelServices;\n\n  constructor(requiredServiceNames: ServiceName[] = []) {\n    this.ctx = getCfgRenderCtx();\n    this.requiredServiceNames = requiredServiceNames;\n  }\n\n  get services(): ModelServices {\n    if (this.cachedServices) return this.cachedServices;\n    const ctx = this.ctx;\n    const services = Object.freeze(\n      Object.fromEntries(\n        this.requiredServiceNames.map((id) => [\n          id,\n          Object.freeze(\n            Object.fromEntries(\n              (ctx.getServiceMethods(id) as string[]).map((method) => [\n                method,\n                (...args: unknown[]) => ctx.callServiceMethod(id, method, ...args),\n              ]),\n            ),\n          ),\n        ]),\n      ),\n    ) as ModelServices;\n    this.cachedServices = services;\n    return services;\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  // /** 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<PColumn<PColumnDataUniversal> | PColumnLazy<undefined | PColumnDataUniversal>>,\n  ): PFrameHandle | undefined {\n    this.verifyInlineAndExplicitColumnsSupport(def);\n    if (!allPColumnsReady(def)) return 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(def: PTableDefV2<PColumn<PColumnDataUniversal>>): PTableHandle | undefined {\n    const columns = collectSpecQueryColumns(def.query);\n    this.verifyInlineAndExplicitColumnsSupport(columns);\n    if (!allPColumnsReady(columns)) return 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<\n  Args = unknown,\n  Data = unknown,\n  ModelServices = BlockDefaultModelServices,\n> extends RenderCtxBase<Args, Data, ModelServices> {\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<\n  F extends PluginFactoryLike = PluginFactoryLike,\n  ModelServices = InferFactoryModelServices<F>,\n> extends RenderCtxBase<unknown, InferFactoryData<F>, ModelServices> {\n  private readonly handle: PluginHandle<F>;\n  private readonly wrappedInputs: Record<string, () => unknown>;\n\n  constructor(\n    handle: PluginHandle<F>,\n    wrappedInputs: Record<string, () => unknown>,\n    requiredServiceNames: ServiceName[] = [],\n  ) {\n    super(requiredServiceNames);\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":";;;;;;;;;;;;;;;;;;;;AAoFA,SAAS,YAAY,OAAgC,QAAiC;AACpF,KAAI,UAAU,OAAW,QAAO,WAAW;AAC3C,KAAI,WAAW,OAAW,QAAO;AACjC,MAAK,MAAM,KAAK,OACd,KAAI,MAAM,OAAO,OAAO,GAAI,QAAO;AAErC,QAAO;;;;;;;AAUT,SAAS,qBACP,MACoE;AACpE,4DAAsB,OAAO,MAAM;AACjC,MAAI,aAAaA,kCACf,QAAO,EAAE;2DACW,EAAE,CACtB,yDAAmB,IAAI,aAAa,SAAS,OAAO;MAEpD,QAAO;GAET;;AAwBJ,IAAa,aAAb,MAAqE;CACnE,AAAiB,MAA0BC,kCAAiB;;;;CAK5D,AAAO,iBAAiB,WAAqC;AAC3D,SAAO,KAAK,IAAI,iBAAiB,UAAU;;CAY7C,AAAO,WACL,qBACA,MACU;EACV,MAAM,YACJ,OAAO,wBAAwB,aAC3B,4FACiC,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,aAClB;OAAI,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,QAAOC,2BAAa,WAAW,MAAM,EAAE,KAAK,YAAY,EAAE,CAAC,CAAC,KACzD,EAAE,OAAO,EAAE,OAAO,aAAa;GAC9B,0DAAqB,KAAK,oBAAoB;GAC9C;GACD,EACF;MAED,QAAO,SAAS,KAAK,EAAE,KAAK,WAAW;GACrC,0DAAqB,KAAK,oBAAoB;GAC9C,OAAO,SAAS,KAAK,IAAI;GAC1B,EAAE;;CAGP,AAAO,iBACL,cAC+B;AAC/B,MAAI,wBAAwBC,kDAAmB,QAAO;EACtD,MAAM,kBAA+C,EAAE;AACvD,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,aAAa,CACrD,kDAAY,MAAM,EAAE;GAClB,MAAM,eAAe,KAAK,oBAAoB,MAAM;AACpD,OAAI,CAAC,aAAc,QAAO;AAC1B,mBAAgB,OAAO;QAEvB,iBAAgB,OAAO;AAG3B,SAAO,IAAIA,kDAAkB,gBAAgB;;;;;;;;;;CAW/C,AAAO,oBACL,cACA,sBAIA,MAC6C;EAC7C,MAAM,YAAY,KAAK,iBAAiB,aAAa;AACrD,MAAI,CAAC,UAAW,QAAO;AACvB,SAAO,IAAIC,6CAAmB,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;EACvB,MAAM,UAAU,IAAIA,6CAAmB,CACpC,kBAAkB,KAAK,CACvB,qBAAqB,KAAK,CAC1B,oBAAoB,sBAAsB;GACzC,GAAG;GACH;GACD,CAAC;AACJ,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,QAAQ,KAAK,UAAU;GAC5B,OAAO,KAAK;GACZ,OAAO,KAAK;GACb,EAAE;;;;;CAML,AAAO,wBAAqE;AAC1E,SAAO,KAAK,SAAS;;CAGvB,AAAO,UAAuD;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,IAAIJ,kCAAiB,EAAE,IAAI,MAAM,CAAC,EAAE,IAAI,SAAS,EAAE,IAAI,KAAK,CAAC;KACpE;IACF,EAAE;GACJ;;;;;CAMH,AAAO,kCAEL;AACA,SAAO,KAAK,mBAAmB;;CAGjC,AAAO,oBAEL;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,yDACE,EAAE,IAAI,OACL,WAAW,IAAIA,kCAAiB,QAAQ,CAAC,EAAE,IAAI,SAAS,EAAE,IAAI,KAAK,CAAC,CACtE;KACF;IACF,EAAE;GACJ;;;;;CAMH,AAAO,yBAAwD;AAC7D,SAAO,KAAK,UAAU;;CAGxB,AAAO,WAA0C;AAC/C,SAAO,KAAK,IAAI,wBAAwB;;;;;;CAO1C,AAAO,aAAa,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;AAClB,6DAAsB,OAAO,WAAW,IAAIA,kCAAiB,QAAQ,CAAC,IAAI,SAAS,IAAI,KAAK,CAAC,CAAC;;;;;;;CAQhG,AAAO,gBAAgB,KAAmD;EACxE,MAAM,OAAO,KAAK,aAAa,IAAI;AACnC,MAAI,CAAC,KAAM,QAAO;AAClB,4DAAqB,KAAK;;;;;;;CAQ5B,AAAO,oBAAoB,KAAqC;EAC9D,MAAM,OAAO,KAAK,aAAa,IAAI;AACnC,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,oDAAe,KAAK,CAAE,OAAM,IAAI,MAAM,8BAA8B,KAAK,KAAK,GAAG;AACrF,SAAO;;;;;;CAOT,AAAO,aAAa,KAAqC;AACvD,SAAO,KAAK,IAAI,2BAA2B,IAAI,SAAS,IAAI,KAAK;;;;;;;CAQnE,AAAO,2BAA2B,MAAgD;EAChF,MAAM,SAAsC,EAAE;AAE9C,MAAK,MAAK,MAAM,QAAQ,KAAK,SAAS,CAAC,SAAS;AAC9C,OAAI,oDAAe,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,AAAO,WAAW,MAA2D;EAC3E,MAAM,WAAW,KAAK,SAAS;AAC/B,OAAK,MAAM,UAAU,SAAS,SAAS;AACrC,OAAI,gDAAW,OAAO,IAAI,CAAE;GAE5B,MAAM,OAAO,OAAO,IAAI;AACxB,OACE,KAAK,SAASK,4CAAY,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,AAAO,cACL,WACyC;EACzC,MAAM,YACJ,OAAO,cAAc,aAAa,kFAA6C,UAAU;AAQ3F,SANqB,KAAK,UAAU,CAAC,QAAQ,QAAQ,EAAE,KAAK,WAAW;AACrE,OAAI,oDAAe,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,8BAAiB,IAAI;IACrB,MAAM;IACN,IAAI,OAAqC;AACvC,SAAI,gBAAgB,KAClB,QAAO;AAGT,mBAAc,KAAK,gBAAgB,IAAI,EAAE;AACzC,YAAO;;IAEV;IACD;;;;;;CAOJ,AAAO,wBACL,QACA,SAC6C;EAC7C,MAAM,SAAS,KAAK,WAAW,OAAO,SAAS,SAAS;AACxD,MAAI,CAAC,OAAQ,QAAO;EACpB,MAAM,+DAA0B,QAAQ,oBAAoB,UAAU;AACtE,MAAI,aAAa,QAAW;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,MAIE;CACA,AAAmB;CACnB,AAAiB;CACjB,AAAQ;CAER,YAAY,uBAAsC,EAAE,EAAE;AACpD,OAAK,MAAMJ,kCAAiB;AAC5B,OAAK,uBAAuB;;CAG9B,IAAI,WAA0B;AAC5B,MAAI,KAAK,eAAgB,QAAO,KAAK;EACrC,MAAM,MAAM,KAAK;EACjB,MAAM,WAAW,OAAO,OACtB,OAAO,YACL,KAAK,qBAAqB,KAAK,OAAO,CACpC,IACA,OAAO,OACL,OAAO,YACJ,IAAI,kBAAkB,GAAG,CAAc,KAAK,WAAW,CACtD,SACC,GAAG,SAAoB,IAAI,kBAAkB,IAAI,QAAQ,GAAG,KAAK,CACnE,CAAC,CACH,CACF,CACF,CAAC,CACH,CACF;AACD,OAAK,iBAAiB;AACtB,SAAO;;CAGT,AAAQ;CAER,IAAW,OAAa;AACtB,MAAI,KAAK,cAAc,QAAW;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,AAAQ;;;;;CAMR,IAAW,aAA+B;AACxC,MAAI,KAAK,oBAAoB,QAAW;GACtC,MAAM,MAAM,KAAK,IAAI;GACrB,MAAM,QAAQ,OAAO,QAAQ,aAAa,KAAK,GAAG;AAClD,QAAK,kBAAkB,EACrB,GAAG,QAAQ,KAAK,MAAM,MAAM,GAAG,QAChC;;AAEH,SAAO,KAAK,gBAAgB;;CAQ9B,AAAQ,iBAAiB,MAA4C;AACnE,SAAOK,uBACL,KAAK,IAAI,wBAAwB,KAAK,GACrC,aAAa,IAAIN,kCAAiB,UAAU,CAAC,KAAK,CAAC,CACrD;;CAGH,IAAW,SAAuC;AAChD,SAAO,KAAK,iBAAiBO,uCAAoB;;CAGnD,IAAW,UAAwC;AACjD,SAAO,KAAK,iBAAiBC,oCAAiB;;CAGhD,AAAgB,aAAa,IAAI,YAAY;;;;;;CAO7C,AAAO,WAAW,MAA2D;AAC3E,SAAO,KAAK,WAAW,WAAW,KAAK;;CAGzC,AAAQ,sCACN,SACA;EACA,MAAM,mBAAmB,QAAQ,MAC9B,MAAM,EAAE,EAAE,gBAAgBR,sFAAgC,EAAE,KAAK,CACnE;EACD,MAAM,uBAAuB,KAAK,IAAI,cAAc,yBAAyB;AAC7E,MAAI,oBAAoB,CAAC,qBACvB,OAAM,MAAM,2CAA2C;;CAK3D,AAAQ,eACN,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,kBAAkBS,2CAAkB,IAAI,iBAAiB;GACzD,SAASA,2CAAkB,IAAI,QAAQ;GACxC;AAEH,SAAO;;CAIT,AAAO,aACL,KAC0B;AAC1B,OAAK,sCAAsC,IAAI;AAC/C,MAAI,CAACC,sCAAiB,IAAI,CAAE,QAAO;AACnC,SAAO,KAAK,IAAI,aAAa,IAAI,KAAK,MAAM,qBAAqB,EAAE,CAAC,CAAC;;CAWvE,AAAO,aACL,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,iEAA4B,OAAO,IAAI;AAC7C,OAAK,sCAAsC,QAAQ;AACnD,MAAI,CAACA,sCAAiB,QAAQ,CAAE,QAAO;AACvC,SAAO,KAAK,IAAI,+DAA0B,SAAS,OAAO,qBAAqB,GAAG,CAAC,CAAC;;CAGtF,AAAO,eAAe,KAA2E;EAC/F,MAAM,uEAAkC,IAAI,MAAM;AAClD,OAAK,sCAAsC,QAAQ;AACnD,MAAI,CAACA,sCAAiB,QAAQ,CAAE,QAAO;AACvC,SAAO,KAAK,IAAI,mEAA8B,MAAM,OAAO,qBAAqB,GAAG,CAAC,CAAC;;;CAIvF,AAAO,cAAc,SAAyB;AAC5C,SAAO,KAAK,IAAI,cAAc,QAAQ;;CAGxC,AAAO,2BAA+C;AACpD,SAAO,KAAK,IAAI,0BAA0B;;CAG5C,AAAO,QAAQ,KAAmB;AAChC,OAAK,IAAI,QAAQ,IAAI;;CAGvB,AAAO,QAAQ,KAAmB;AAChC,OAAK,IAAI,QAAQ,IAAI;;CAGvB,AAAO,SAAS,KAAmB;AACjC,OAAK,IAAI,SAAS,IAAI;;;;AAK1B,IAAa,iBAAb,cAIU,cAAyC;CACjD,AAAQ;CACR,IAAW,OAAyB;AAClC,MAAI,KAAK,cAAc,QAAW;GAChC,MAAM,MAAM,KAAK,IAAI;GACrB,MAAM,QAAQ,OAAO,QAAQ,aAAa,KAAK,GAAG;AAClD,QAAK,YAAY,EAAE,GAAG,UAAU,SAAY,SAAY,KAAK,MAAM,MAAM,EAAE;;AAE7E,SAAO,KAAK,UAAU;;;;AAK1B,IAAa,kBAAb,cAAwE,cAGtE;CACA,AAAQ;CAER,IAAW,OAAa;AACtB,MAAI,KAAK,cAAc,QAAW;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,AAAQ;CAER,IAAW,UAAmB;AAC5B,MAAI,KAAK,iBAAiB,QAAW;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,cAGU,cAA2D;CACnE,AAAiB;CACjB,AAAiB;CAEjB,YACE,QACA,eACA,uBAAsC,EAAE,EACxC;AACA,QAAM,qBAAqB;AAC3B,OAAK,SAAS;AACd,OAAK,gBAAgB;;CAGvB,AAAQ;;CAGR,IAAoB,OAA4B;AAC9C,MAAI,KAAK,oBAAoB,OAE3B,MAAK,kBAAkB,EAAE,GAAGC,mFADhB,KAAK,IAAI,cAAc,CACqB,EAAE,KAAK,OAAO,EAAE;AAE1E,SAAO,KAAK,gBAAgB;;CAG9B,AAAQ;;CAGR,IAAW,SAAgC;AACzC,MAAI,KAAK,gBAAgB,QAAW;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/api.d.ts

@@ -1,4 +1,5 @@
-import { InferFactoryData, InferFactoryParams, PluginFactoryLike, PluginHandle } from "../plugin_handle.js";
+import { InferFactoryData, InferFactoryModelServices, InferFactoryParams, PluginFactoryLike, PluginHandle } from "../plugin_handle.js";
+import { BlockDefaultModelServices } from "../services/service_resolve.js";
 import { GlobalCfgRenderCtx, PColumnDataUniversal } from "./internal.js";
 import { FutureRef } from "./future.js";
 import { TreeNodeAccessor } from "./accessor.js";
@@ -6,7 +7,7 @@ import { DeriveLabelsOptions } from "../labels/derive_distinct_labels.js";
 import "./util/label.js";
 import { APColumnSelectorWithSplit } from "./util/split_selectors.js";
 import { AxisLabelProvider, ColumnProvider } from "./util/column_collection.js";
-import { AnchoredIdDeriver, AnchoredPColumnSelector, AnyFunction, AxesId, AxesSpec, AxisId, DiscoverColumnsRequest, DiscoverColumnsResponse, Option, PColumn, PColumnLazy, PColumnSelector, PColumnSpec, PFrameDef, PFrameHandle, PObject, PObjectSpec, PSpecPredicate, PTableColumnId, PTableColumnSpec, PTableDef, PTableDefV2, PTableHandle, PTableRecordFilter, PTableSorting, PlRef, ResolveAnchorsOptions, ResultCollection, SUniversalPColumnId, SingleAxisSelector, ValueOrError } from "@milaboratories/pl-model-common";
+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, ServiceName, ValueOrError } from "@milaboratories/pl-model-common";
 import { Optional } from "utility-types";
 
 //#region src/render/api.d.ts
@@ -148,9 +149,12 @@ declare class ResultPool implements ColumnProvider, AxisLabelProvider {
   findLabelsForColumnAxis(column: PColumnSpec, axisIdx: number): Record<string | number, string> | undefined;
 }
 /** Main entry point to the API available within model lambdas (like outputs, sections, etc..) */
-declare abstract class RenderCtxBase<Args = unknown, Data = unknown> {
+declare abstract class RenderCtxBase<Args = unknown, Data = unknown, ModelServices$1 = Partial<ModelServices>> {
   protected readonly ctx: GlobalCfgRenderCtx;
-  constructor();
+  private readonly requiredServiceNames;
+  private cachedServices?;
+  constructor(requiredServiceNames?: ServiceName[]);
+  get services(): ModelServices$1;
   private dataCache?;
   get data(): Data;
   private activeArgsCache?;
@@ -181,20 +185,13 @@ declare abstract class RenderCtxBase<Args = unknown, Data = unknown> {
   createPTableV2(def: PTableDefV2<PColumn<PColumnDataUniversal>>): PTableHandle | undefined;
   /** @deprecated scheduled for removal from SDK */
   getBlockLabel(blockId: string): string;
-  createSpecFrame(specs: Record<string, PColumnSpec>): string;
-  specFrameDiscoverColumns(handle: string, request: DiscoverColumnsRequest): DiscoverColumnsResponse;
-  disposeSpecFrame(handle: string): void;
-  expandAxes(spec: AxesSpec): AxesId;
-  collapseAxes(ids: AxesId): AxesSpec;
-  findAxis(spec: AxesSpec, selector: SingleAxisSelector): number;
-  findTableColumn(tableSpec: PTableColumnSpec[], selector: PTableColumnId): number;
   getCurrentUnstableMarker(): string | undefined;
   logInfo(msg: string): void;
   logWarn(msg: string): void;
   logError(msg: string): void;
 }
 /** Main entry point to the API available within model lambdas (like outputs, sections, etc..) for v3+ blocks */
-declare class BlockRenderCtx<Args = unknown, Data = unknown> extends RenderCtxBase<Args, Data> {
+declare class BlockRenderCtx<Args = unknown, Data = unknown, ModelServices = BlockDefaultModelServices> extends RenderCtxBase<Args, Data, ModelServices> {
   private argsCache?;
   get args(): Args | undefined;
 }
@@ -214,19 +211,16 @@ declare class RenderCtxLegacy<Args = unknown, UiState = unknown> extends RenderC
  *
  * @typeParam F - PluginFactoryLike phantom carrying data/params/outputs types
  */
-declare class PluginRenderCtx<F extends PluginFactoryLike = PluginFactoryLike> {
-  private readonly ctx;
+declare class PluginRenderCtx<F extends PluginFactoryLike = PluginFactoryLike, ModelServices = InferFactoryModelServices<F>> extends RenderCtxBase<unknown, InferFactoryData<F>, ModelServices> {
   private readonly handle;
   private readonly wrappedInputs;
-  constructor(handle: PluginHandle<F>, wrappedInputs: Record<string, () => unknown>);
-  private dataCache?;
+  constructor(handle: PluginHandle<F>, wrappedInputs: Record<string, () => unknown>, requiredServiceNames?: ServiceName[]);
+  private pluginDataCache?;
   /** Plugin's persistent data from blockStorage.__plugins.{pluginId}.__data */
   get data(): InferFactoryData<F>;
   private paramsCache?;
   /** Params derived from block context via pre-wrapped input callbacks */
   get params(): InferFactoryParams<F>;
-  /** Result pool — same as block, from cfgRenderCtx methods */
-  readonly resultPool: ResultPool;
 }
 /** @deprecated Use BlockRenderCtx instead */
 type RenderCtx<Args = unknown, Data = unknown> = BlockRenderCtx<Args, Data>;

package/dist/render/api.js

@@ -306,8 +306,18 @@ var ResultPool = class {
 /** Main entry point to the API available within model lambdas (like outputs, sections, etc..) */
 var RenderCtxBase = class {
 	ctx;
-	constructor() {
+	requiredServiceNames;
+	cachedServices;
+	constructor(requiredServiceNames = []) {
 		this.ctx = getCfgRenderCtx();
+		this.requiredServiceNames = requiredServiceNames;
+	}
+	get services() {
+		if (this.cachedServices) return this.cachedServices;
+		const ctx = this.ctx;
+		const services = Object.freeze(Object.fromEntries(this.requiredServiceNames.map((id) => [id, Object.freeze(Object.fromEntries(ctx.getServiceMethods(id).map((method) => [method, (...args) => ctx.callServiceMethod(id, method, ...args)])))])));
+		this.cachedServices = services;
+		return services;
 	}
 	dataCache;
 	get data() {
@@ -402,27 +412,6 @@ var RenderCtxBase = class {
 	getBlockLabel(blockId) {
 		return this.ctx.getBlockLabel(blockId);
 	}
-	createSpecFrame(specs) {
-		return this.ctx.createSpecFrame(specs);
-	}
-	specFrameDiscoverColumns(handle, request) {
-		return this.ctx.specFrameDiscoverColumns(handle, request);
-	}
-	disposeSpecFrame(handle) {
-		this.ctx.disposeSpecFrame(handle);
-	}
-	expandAxes(spec) {
-		return this.ctx.expandAxes(spec);
-	}
-	collapseAxes(ids) {
-		return this.ctx.collapseAxes(ids);
-	}
-	findAxis(spec, selector) {
-		return this.ctx.findAxis(spec, selector);
-	}
-	findTableColumn(tableSpec, selector) {
-		return this.ctx.findTableColumn(tableSpec, selector);
-	}
 	getCurrentUnstableMarker() {
 		return this.ctx.getCurrentUnstableMarker();
 	}
@@ -478,20 +467,19 @@ var RenderCtxLegacy = class extends RenderCtxBase {
 *
 * @typeParam F - PluginFactoryLike phantom carrying data/params/outputs types
 */
-var PluginRenderCtx = class {
-	ctx;
+var PluginRenderCtx = class extends RenderCtxBase {
 	handle;
 	wrappedInputs;
-	constructor(handle, wrappedInputs) {
-		this.ctx = getCfgRenderCtx();
+	constructor(handle, wrappedInputs, requiredServiceNames = []) {
+		super(requiredServiceNames);
 		this.handle = handle;
 		this.wrappedInputs = wrappedInputs;
 	}
-	dataCache;
+	pluginDataCache;
 	/** Plugin's persistent data from blockStorage.__plugins.{pluginId}.__data */
 	get data() {
-		if (this.dataCache === void 0) this.dataCache = { v: getPluginData(parseJson(this.ctx.blockStorage()), this.handle) };
-		return this.dataCache.v;
+		if (this.pluginDataCache === void 0) this.pluginDataCache = { v: getPluginData(parseJson(this.ctx.blockStorage()), this.handle) };
+		return this.pluginDataCache.v;
 	}
 	paramsCache;
 	/** Params derived from block context via pre-wrapped input callbacks */
@@ -503,8 +491,6 @@ var PluginRenderCtx = class {
 		}
 		return this.paramsCache.v;
 	}
-	/** Result pool — same as block, from cfgRenderCtx methods */
-	resultPool = new ResultPool();
 };
 
 //#endregion