@platforma-sdk/model 1.63.0 → 1.63.12

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, 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":"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"}
+{"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":"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"}

package/dist/raw_globals.cjs

@@ -1,6 +1,5 @@
-const require_internal = require('./internal.cjs');
-const require_version = require('./version.cjs');
-
+const require_internal = require("./internal.cjs");
+const require_version = require("./version.cjs");
 //#region src/raw_globals.ts
 function getPlatformaApiVersion() {
 	return platformaApiVersion ?? 1;
@@ -12,8 +11,8 @@ function getRawPlatformaInstance() {
 	});
 }
 /** Returns a global platforma instance or a provided fallback if it's not available. */
-
 //#endregion
 exports.getPlatformaApiVersion = getPlatformaApiVersion;
 exports.getRawPlatformaInstance = getRawPlatformaInstance;
+
 //# sourceMappingURL=raw_globals.cjs.map

package/dist/raw_globals.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"raw_globals.cjs","names":["getPlatformaInstance","PlatformaSDKVersion"],"sources":["../src/raw_globals.ts"],"sourcesContent":["import type { OutputWithStatus } from \"@milaboratories/pl-model-common\";\nimport { getPlatformaInstance } from \"./internal\";\nimport type { Platforma, PlatformaApiVersion } from \"./platforma\";\nimport { PlatformaSDKVersion } from \"./version\";\n\nexport function getPlatformaApiVersion(): PlatformaApiVersion {\n  return platformaApiVersion ?? 1; // undefined means 1 for backward compatibility\n}\n\nexport function getRawPlatformaInstance<\n  Args = unknown,\n  Outputs extends Record<string, OutputWithStatus<unknown>> = Record<\n    string,\n    OutputWithStatus<unknown>\n  >,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n>(): Platforma<Args, Outputs, UiState, Href> {\n  return getPlatformaInstance<Args, Outputs, UiState, Href>({\n    sdkVersion: PlatformaSDKVersion,\n    apiVersion: platformaApiVersion,\n  });\n}\n\n/** Returns a global platforma instance or a provided fallback if it's not available. */\n// export function getPlatformaOrDefault<\n//   Args = unknown,\n//   Outputs extends Record<string, ValueOrErrors<unknown>> = Record<string, ValueOrErrors<unknown>>,\n//   UiState = unknown,\n//   Href extends `/${string}` = `/${string}`,\n// >(): PlatformaV1<Args, Outputs, UiState, Href> | PlatformaV2<Args, Outputs, UiState, Href> {\n//   try {\n//     return getRawPlatformaInstance<Args, Outputs, UiState, Href>();\n//   } catch {\n//     return platforma;\n//   }\n// }\n"],"mappings":";;;;AAKA,SAAgB,yBAA8C;AAC5D,QAAO,uBAAuB;;AAGhC,SAAgB,0BAQ6B;AAC3C,QAAOA,sCAAmD;EACxD,YAAYC;EACZ,YAAY;EACb,CAAC"}
+{"version":3,"file":"raw_globals.cjs","names":["getPlatformaInstance","PlatformaSDKVersion"],"sources":["../src/raw_globals.ts"],"sourcesContent":["import type { OutputWithStatus } from \"@milaboratories/pl-model-common\";\nimport { getPlatformaInstance } from \"./internal\";\nimport type { Platforma, PlatformaApiVersion } from \"./platforma\";\nimport { PlatformaSDKVersion } from \"./version\";\n\nexport function getPlatformaApiVersion(): PlatformaApiVersion {\n  return platformaApiVersion ?? 1; // undefined means 1 for backward compatibility\n}\n\nexport function getRawPlatformaInstance<\n  Args = unknown,\n  Outputs extends Record<string, OutputWithStatus<unknown>> = Record<\n    string,\n    OutputWithStatus<unknown>\n  >,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n>(): Platforma<Args, Outputs, UiState, Href> {\n  return getPlatformaInstance<Args, Outputs, UiState, Href>({\n    sdkVersion: PlatformaSDKVersion,\n    apiVersion: platformaApiVersion,\n  });\n}\n\n/** Returns a global platforma instance or a provided fallback if it's not available. */\n// export function getPlatformaOrDefault<\n//   Args = unknown,\n//   Outputs extends Record<string, ValueOrErrors<unknown>> = Record<string, ValueOrErrors<unknown>>,\n//   UiState = unknown,\n//   Href extends `/${string}` = `/${string}`,\n// >(): PlatformaV1<Args, Outputs, UiState, Href> | PlatformaV2<Args, Outputs, UiState, Href> {\n//   try {\n//     return getRawPlatformaInstance<Args, Outputs, UiState, Href>();\n//   } catch {\n//     return platforma;\n//   }\n// }\n"],"mappings":";;;AAKA,SAAgB,yBAA8C;AAC5D,QAAO,uBAAuB;;AAGhC,SAAgB,0BAQ6B;AAC3C,QAAOA,iBAAAA,qBAAmD;EACxD,YAAYC,gBAAAA;EACZ,YAAY;EACb,CAAC"}

package/dist/raw_globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw_globals.d.ts","names":[],"sources":["../src/raw_globals.ts"],"mappings":";;;;iBAKgB,sBAAA,CAAA,GAA0B,mBAAA;AAAA,iBAI1B,uBAAA,iCAEE,MAAA,SAAe,gBAAA,aAA6B,MAAA,SAE1D,gBAAA,wEAAA,CAAA,GAIC,SAAA,CAAU,IAAA,EAAM,OAAA,EAAS,OAAA,EAAS,IAAA"}

package/dist/raw_globals.js

@@ -1,6 +1,5 @@
 import { getPlatformaInstance } from "./internal.js";
 import { PlatformaSDKVersion } from "./version.js";
-
 //#region src/raw_globals.ts
 function getPlatformaApiVersion() {
 	return platformaApiVersion ?? 1;
@@ -12,7 +11,7 @@ function getRawPlatformaInstance() {
 	});
 }
 /** Returns a global platforma instance or a provided fallback if it's not available. */
-
 //#endregion
 export { getPlatformaApiVersion, getRawPlatformaInstance };
+
 //# sourceMappingURL=raw_globals.js.map

package/dist/raw_globals.js.map

@@ -1 +1 @@
-{"version":3,"file":"raw_globals.js","names":[],"sources":["../src/raw_globals.ts"],"sourcesContent":["import type { OutputWithStatus } from \"@milaboratories/pl-model-common\";\nimport { getPlatformaInstance } from \"./internal\";\nimport type { Platforma, PlatformaApiVersion } from \"./platforma\";\nimport { PlatformaSDKVersion } from \"./version\";\n\nexport function getPlatformaApiVersion(): PlatformaApiVersion {\n  return platformaApiVersion ?? 1; // undefined means 1 for backward compatibility\n}\n\nexport function getRawPlatformaInstance<\n  Args = unknown,\n  Outputs extends Record<string, OutputWithStatus<unknown>> = Record<\n    string,\n    OutputWithStatus<unknown>\n  >,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n>(): Platforma<Args, Outputs, UiState, Href> {\n  return getPlatformaInstance<Args, Outputs, UiState, Href>({\n    sdkVersion: PlatformaSDKVersion,\n    apiVersion: platformaApiVersion,\n  });\n}\n\n/** Returns a global platforma instance or a provided fallback if it's not available. */\n// export function getPlatformaOrDefault<\n//   Args = unknown,\n//   Outputs extends Record<string, ValueOrErrors<unknown>> = Record<string, ValueOrErrors<unknown>>,\n//   UiState = unknown,\n//   Href extends `/${string}` = `/${string}`,\n// >(): PlatformaV1<Args, Outputs, UiState, Href> | PlatformaV2<Args, Outputs, UiState, Href> {\n//   try {\n//     return getRawPlatformaInstance<Args, Outputs, UiState, Href>();\n//   } catch {\n//     return platforma;\n//   }\n// }\n"],"mappings":";;;;AAKA,SAAgB,yBAA8C;AAC5D,QAAO,uBAAuB;;AAGhC,SAAgB,0BAQ6B;AAC3C,QAAO,qBAAmD;EACxD,YAAY;EACZ,YAAY;EACb,CAAC"}
+{"version":3,"file":"raw_globals.js","names":[],"sources":["../src/raw_globals.ts"],"sourcesContent":["import type { OutputWithStatus } from \"@milaboratories/pl-model-common\";\nimport { getPlatformaInstance } from \"./internal\";\nimport type { Platforma, PlatformaApiVersion } from \"./platforma\";\nimport { PlatformaSDKVersion } from \"./version\";\n\nexport function getPlatformaApiVersion(): PlatformaApiVersion {\n  return platformaApiVersion ?? 1; // undefined means 1 for backward compatibility\n}\n\nexport function getRawPlatformaInstance<\n  Args = unknown,\n  Outputs extends Record<string, OutputWithStatus<unknown>> = Record<\n    string,\n    OutputWithStatus<unknown>\n  >,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n>(): Platforma<Args, Outputs, UiState, Href> {\n  return getPlatformaInstance<Args, Outputs, UiState, Href>({\n    sdkVersion: PlatformaSDKVersion,\n    apiVersion: platformaApiVersion,\n  });\n}\n\n/** Returns a global platforma instance or a provided fallback if it's not available. */\n// export function getPlatformaOrDefault<\n//   Args = unknown,\n//   Outputs extends Record<string, ValueOrErrors<unknown>> = Record<string, ValueOrErrors<unknown>>,\n//   UiState = unknown,\n//   Href extends `/${string}` = `/${string}`,\n// >(): PlatformaV1<Args, Outputs, UiState, Href> | PlatformaV2<Args, Outputs, UiState, Href> {\n//   try {\n//     return getRawPlatformaInstance<Args, Outputs, UiState, Href>();\n//   } catch {\n//     return platforma;\n//   }\n// }\n"],"mappings":";;;AAKA,SAAgB,yBAA8C;AAC5D,QAAO,uBAAuB;;AAGhC,SAAgB,0BAQ6B;AAC3C,QAAO,qBAAmD;EACxD,YAAY;EACZ,YAAY;EACb,CAAC"}

package/dist/ref_util.cjs

@@ -1,6 +1,5 @@
-const require_actions = require('./config/actions.cjs');
-require('./config/index.cjs');
-
+const require_actions = require("./config/actions.cjs");
+require("./config/index.cjs");
 //#region src/ref_util.ts
 function fromPlRef(source) {
 	return require_actions.makeObject({
@@ -15,8 +14,8 @@ function fromPlOption(source) {
 		label: require_actions.getJsonField(source, "label")
 	});
 }
-
 //#endregion
 exports.fromPlOption = fromPlOption;
 exports.fromPlRef = fromPlRef;
+
 //# sourceMappingURL=ref_util.cjs.map

package/dist/ref_util.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ref_util.cjs","names":["makeObject","getJsonField"],"sources":["../src/ref_util.ts"],"sourcesContent":["import type { TypedConfig } from \"./config\";\nimport { getJsonField, makeObject } from \"./config\";\n\nexport function fromPlRef<Source extends TypedConfig>(source: Source) {\n  return makeObject({\n    __isRef: true,\n    blockId: getJsonField(source, \"blockId\"),\n    name: getJsonField(source, \"name\"),\n  });\n}\n\nexport function fromPlOption<Source extends TypedConfig>(source: Source) {\n  return makeObject({\n    ref: fromPlRef(getJsonField(source, \"ref\")),\n    label: getJsonField(source, \"label\"),\n  });\n}\n"],"mappings":";;;;AAGA,SAAgB,UAAsC,QAAgB;AACpE,QAAOA,2BAAW;EAChB,SAAS;EACT,SAASC,6BAAa,QAAQ,UAAU;EACxC,MAAMA,6BAAa,QAAQ,OAAO;EACnC,CAAC;;AAGJ,SAAgB,aAAyC,QAAgB;AACvE,QAAOD,2BAAW;EAChB,KAAK,UAAUC,6BAAa,QAAQ,MAAM,CAAC;EAC3C,OAAOA,6BAAa,QAAQ,QAAQ;EACrC,CAAC"}
+{"version":3,"file":"ref_util.cjs","names":["makeObject","getJsonField"],"sources":["../src/ref_util.ts"],"sourcesContent":["import type { TypedConfig } from \"./config\";\nimport { getJsonField, makeObject } from \"./config\";\n\nexport function fromPlRef<Source extends TypedConfig>(source: Source) {\n  return makeObject({\n    __isRef: true,\n    blockId: getJsonField(source, \"blockId\"),\n    name: getJsonField(source, \"name\"),\n  });\n}\n\nexport function fromPlOption<Source extends TypedConfig>(source: Source) {\n  return makeObject({\n    ref: fromPlRef(getJsonField(source, \"ref\")),\n    label: getJsonField(source, \"label\"),\n  });\n}\n"],"mappings":";;;AAGA,SAAgB,UAAsC,QAAgB;AACpE,QAAOA,gBAAAA,WAAW;EAChB,SAAS;EACT,SAASC,gBAAAA,aAAa,QAAQ,UAAU;EACxC,MAAMA,gBAAAA,aAAa,QAAQ,OAAO;EACnC,CAAC;;AAGJ,SAAgB,aAAyC,QAAgB;AACvE,QAAOD,gBAAAA,WAAW;EAChB,KAAK,UAAUC,gBAAAA,aAAa,QAAQ,MAAM,CAAC;EAC3C,OAAOA,gBAAAA,aAAa,QAAQ,QAAQ;EACrC,CAAC"}

package/dist/ref_util.d.ts

@@ -1,7 +1,5 @@
 import { POCExtractAction, TypedConfig } from "./config/type_engine.js";
 import { ActGetField, ActGetImmediate, ActMakeObject } from "./config/actions_kinds.js";
-import "./config/index.js";
-
 //#region src/ref_util.d.ts
 declare function fromPlRef<Source extends TypedConfig>(source: Source): TypedConfig<ActMakeObject<{
   readonly __isRef: ActGetImmediate<true>;

package/dist/ref_util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref_util.d.ts","names":[],"sources":["../src/ref_util.ts"],"mappings":";;;iBAGgB,SAAA,gBAAyB,WAAA,CAAA,CAAa,MAAA,EAAQ,MAAA,GAAM,WAAA;oBAAA,eAAA;EAAA;;;iBAQpD,YAAA,gBAA4B,WAAA,CAAA,CAAa,MAAA,EAAQ,MAAA,GAAM,WAAA;;sBAAA,eAAA;IAAA"}

package/dist/ref_util.js

@@ -1,6 +1,5 @@
 import { getJsonField, makeObject } from "./config/actions.js";
 import "./config/index.js";
-
 //#region src/ref_util.ts
 function fromPlRef(source) {
 	return makeObject({
@@ -15,7 +14,7 @@ function fromPlOption(source) {
 		label: getJsonField(source, "label")
 	});
 }
-
 //#endregion
 export { fromPlOption, fromPlRef };
+
 //# sourceMappingURL=ref_util.js.map

package/dist/ref_util.js.map

@@ -1 +1 @@
-{"version":3,"file":"ref_util.js","names":[],"sources":["../src/ref_util.ts"],"sourcesContent":["import type { TypedConfig } from \"./config\";\nimport { getJsonField, makeObject } from \"./config\";\n\nexport function fromPlRef<Source extends TypedConfig>(source: Source) {\n  return makeObject({\n    __isRef: true,\n    blockId: getJsonField(source, \"blockId\"),\n    name: getJsonField(source, \"name\"),\n  });\n}\n\nexport function fromPlOption<Source extends TypedConfig>(source: Source) {\n  return makeObject({\n    ref: fromPlRef(getJsonField(source, \"ref\")),\n    label: getJsonField(source, \"label\"),\n  });\n}\n"],"mappings":";;;;AAGA,SAAgB,UAAsC,QAAgB;AACpE,QAAO,WAAW;EAChB,SAAS;EACT,SAAS,aAAa,QAAQ,UAAU;EACxC,MAAM,aAAa,QAAQ,OAAO;EACnC,CAAC;;AAGJ,SAAgB,aAAyC,QAAgB;AACvE,QAAO,WAAW;EAChB,KAAK,UAAU,aAAa,QAAQ,MAAM,CAAC;EAC3C,OAAO,aAAa,QAAQ,QAAQ;EACrC,CAAC"}
+{"version":3,"file":"ref_util.js","names":[],"sources":["../src/ref_util.ts"],"sourcesContent":["import type { TypedConfig } from \"./config\";\nimport { getJsonField, makeObject } from \"./config\";\n\nexport function fromPlRef<Source extends TypedConfig>(source: Source) {\n  return makeObject({\n    __isRef: true,\n    blockId: getJsonField(source, \"blockId\"),\n    name: getJsonField(source, \"name\"),\n  });\n}\n\nexport function fromPlOption<Source extends TypedConfig>(source: Source) {\n  return makeObject({\n    ref: fromPlRef(getJsonField(source, \"ref\")),\n    label: getJsonField(source, \"label\"),\n  });\n}\n"],"mappings":";;;AAGA,SAAgB,UAAsC,QAAgB;AACpE,QAAO,WAAW;EAChB,SAAS;EACT,SAAS,aAAa,QAAQ,UAAU;EACxC,MAAM,aAAa,QAAQ,OAAO;EACnC,CAAC;;AAGJ,SAAgB,aAAyC,QAAgB;AACvE,QAAO,WAAW;EAChB,KAAK,UAAU,aAAa,QAAQ,MAAM,CAAC;EAC3C,OAAO,aAAa,QAAQ,QAAQ;EACrC,CAAC"}

package/dist/render/accessor.cjs

@@ -1,8 +1,7 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-const require_internal = require('../internal.cjs');
-const require_future = require('./future.cjs');
+require("../_virtual/_rolldown/runtime.cjs");
+const require_internal = require("../internal.cjs");
+const require_future = require("./future.cjs");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
-
 //#region src/render/accessor.ts
 function ifDef(value, cb) {
 	return value === void 0 ? void 0 : cb(value);
@@ -213,8 +212,8 @@ var TreeNodeAccessor = class TreeNodeAccessor {
 		return fieldEntries.map(([name, value]) => mapping(name, value));
 	}
 };
-
 //#endregion
 exports.TreeNodeAccessor = TreeNodeAccessor;
 exports.ifDef = ifDef;
+
 //# sourceMappingURL=accessor.cjs.map

package/dist/render/accessor.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"accessor.cjs","names":["getCfgRenderCtx","FutureRef"],"sources":["../../src/render/accessor.ts"],"sourcesContent":["import type {\n  AnyLogHandle,\n  ImportProgress,\n  LocalBlobHandleAndSize,\n  PColumn,\n  PObject,\n  RemoteBlobHandleAndSize,\n  FolderURL,\n  ArchiveFormat,\n  ProgressLogWithInfo,\n  RangeBytes,\n} from \"@milaboratories/pl-model-common\";\nimport { isPColumn, mapPObjectData } from \"@milaboratories/pl-model-common\";\nimport { getCfgRenderCtx } from \"../internal\";\nimport { FutureRef } from \"./future\";\nimport type { AccessorHandle } from \"./internal\";\nimport type { CommonFieldTraverseOps, FieldTraversalStep, ResourceType } from \"./traversal_ops\";\n\nexport function ifDef<T, R>(value: T | undefined, cb: (value: T) => R): R | undefined {\n  return value === undefined ? undefined : cb(value);\n}\n\ntype FieldMapOps = {\n  /**\n   * Type of fields to iterate over.\n   * (default 'Input')\n   * */\n  readonly fieldType?: \"Input\" | \"Output\" | \"Dynamic\";\n  /**\n   * If not locked, `undefined` value will be returned. Do nothing if mapping `Dynamic` fields.\n   * (default true)\n   * */\n  readonly requireLocked?: boolean;\n  /**\n   * Will skip unresolved fields.\n   * (default false)\n   * */\n  readonly skipUnresolved?: boolean;\n};\n\n/** Represent resource tree node accessor */\nexport class TreeNodeAccessor {\n  constructor(\n    public readonly handle: AccessorHandle,\n    public readonly resolvePath: string[],\n  ) {}\n\n  /** Shortcut for {@link resolveInput} */\n  public resolve(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  /** Shortcut for {@link resolveInput} */\n  public resolve(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolve(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    const transformedSteps = steps.map(\n      (s) =>\n        ({\n          assertFieldType: \"Input\",\n          ...(typeof s === \"string\" ? { field: s } : s),\n        }) satisfies FieldTraversalStep,\n    );\n    return this.resolveWithCommon({}, ...transformedSteps);\n  }\n\n  /** If field type assertion is not specified for the step, default is Output. */\n  public resolveOutput(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  /** If field type assertion is not specified for the step, default is Output. */\n  public resolveOutput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolveOutput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    const transformedSteps = steps.map(\n      (s) =>\n        ({\n          assertFieldType: \"Output\",\n          ...(typeof s === \"string\" ? { field: s } : s),\n        }) satisfies FieldTraversalStep,\n    );\n    return this.resolveWithCommon({}, ...transformedSteps);\n  }\n\n  /** If field type assertion is not specified for the step, default is Input. */\n  public resolveInput(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  /** If field type assertion is not specified for the step, default is Input. */\n  public resolveInput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolveInput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    const transformedSteps = steps.map(\n      (s) =>\n        ({\n          assertFieldType: \"Input\",\n          ...(typeof s === \"string\" ? { field: s } : s),\n        }) satisfies FieldTraversalStep,\n    );\n    return this.resolveWithCommon({}, ...transformedSteps);\n  }\n\n  public resolveAny(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  public resolveAny(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolveAny(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    return this.resolveWithCommon({}, ...steps);\n  }\n\n  public resolveWithCommon(\n    commonOptions: CommonFieldTraverseOps,\n    ...steps: (FieldTraversalStep | string)[]\n  ): TreeNodeAccessor | undefined {\n    const resolvePath = [\n      ...this.resolvePath,\n      ...steps.map((step) => (typeof step === \"string\" ? step : step.field)),\n    ];\n    return ifDef(\n      getCfgRenderCtx().resolveWithCommon(this.handle, commonOptions, ...steps),\n      (accessor) => new TreeNodeAccessor(accessor, resolvePath),\n    );\n  }\n\n  public get resourceType(): ResourceType {\n    return getCfgRenderCtx().getResourceType(this.handle);\n  }\n\n  public getInputsLocked(): boolean {\n    return getCfgRenderCtx().getInputsLocked(this.handle);\n  }\n\n  public getOutputsLocked(): boolean {\n    return getCfgRenderCtx().getOutputsLocked(this.handle);\n  }\n\n  public getIsReadyOrError(): boolean {\n    return getCfgRenderCtx().getIsReadyOrError(this.handle);\n  }\n\n  public getIsFinal(): boolean {\n    return getCfgRenderCtx().getIsFinal(this.handle);\n  }\n\n  public getError(): TreeNodeAccessor | undefined {\n    const resolvePath = [...this.resolvePath, \"error\"];\n    return ifDef(\n      getCfgRenderCtx().getError(this.handle),\n      (accsessor) => new TreeNodeAccessor(accsessor, resolvePath),\n    );\n  }\n\n  public listInputFields(): string[] {\n    return getCfgRenderCtx().listInputFields(this.handle);\n  }\n\n  public listOutputFields(): string[] {\n    return getCfgRenderCtx().listOutputFields(this.handle);\n  }\n\n  public listDynamicFields(): string[] {\n    return getCfgRenderCtx().listDynamicFields(this.handle);\n  }\n\n  public getKeyValueBase64(key: string): string | undefined {\n    return getCfgRenderCtx().getKeyValueBase64(this.handle, key);\n  }\n\n  public getKeyValueAsString(key: string): string | undefined {\n    return getCfgRenderCtx().getKeyValueAsString(this.handle, key);\n  }\n\n  public getKeyValueAsJson<T>(key: string): T {\n    const content = this.getKeyValueAsString(key);\n    if (content == undefined) throw new Error(\"Resource has no content.\");\n    return JSON.parse(content);\n  }\n\n  public getDataBase64(): string | undefined {\n    return getCfgRenderCtx().getDataBase64(this.handle);\n  }\n\n  public getDataAsString(): string | undefined {\n    return getCfgRenderCtx().getDataAsString(this.handle);\n  }\n\n  public getDataAsJson<T>(): T {\n    const content = this.getDataAsString();\n    if (content == undefined) throw new Error(\"Resource has no content.\");\n    return JSON.parse(content);\n  }\n\n  /**\n   *\n   */\n  public getPColumns(\n    errorOnUnknownField: boolean = false,\n    prefix: string = \"\",\n  ): PColumn<TreeNodeAccessor>[] | undefined {\n    const result = this.parsePObjectCollection(errorOnUnknownField, prefix);\n    if (result === undefined) return undefined;\n\n    const pf = Object.entries(result).map(([, obj]) => {\n      if (!isPColumn(obj)) throw new Error(`not a PColumn (kind = ${obj.spec.kind})`);\n      return obj;\n    });\n\n    return pf;\n  }\n\n  /**\n   *\n   */\n  public parsePObjectCollection(\n    errorOnUnknownField: boolean = false,\n    prefix: string = \"\",\n  ): Record<string, PObject<TreeNodeAccessor>> | undefined {\n    const pObjects = getCfgRenderCtx().parsePObjectCollection(\n      this.handle,\n      errorOnUnknownField,\n      prefix,\n      ...this.resolvePath,\n    );\n    if (pObjects === undefined) return undefined;\n    const result: Record<string, PObject<TreeNodeAccessor>> = {};\n    for (const [key, value] of Object.entries(pObjects)) {\n      const resolvePath = [...this.resolvePath, key];\n      result[key] = mapPObjectData(value, (c) => new TreeNodeAccessor(c, resolvePath));\n    }\n    return result;\n  }\n\n  public getFileContentAsBase64(range?: RangeBytes): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getBlobContentAsBase64(this.handle, range));\n  }\n\n  public getFileContentAsString(range?: RangeBytes): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getBlobContentAsString(this.handle, range));\n  }\n\n  public getFileContentAsJson<T>(range?: RangeBytes): FutureRef<T | undefined> {\n    return new FutureRef<string | undefined>(\n      getCfgRenderCtx().getBlobContentAsString(this.handle, range),\n    ).mapDefined((v) => JSON.parse(v) as T);\n  }\n\n  /**\n   * @deprecated use getFileContentAsBase64\n   */\n  public getBlobContentAsBase64(): FutureRef<string | undefined> {\n    return this.getFileContentAsBase64();\n  }\n\n  /**\n   * @deprecated use getFileContentAsString\n   */\n  public getBlobContentAsString(): FutureRef<string | undefined> {\n    return this.getFileContentAsString();\n  }\n\n  /**\n   * @returns downloaded file handle\n   */\n  public getFileHandle(): FutureRef<LocalBlobHandleAndSize | undefined> {\n    return new FutureRef(getCfgRenderCtx().getDownloadedBlobContentHandle(this.handle));\n  }\n\n  /**\n   * @deprecated use getFileHandle\n   */\n  public getDownloadedBlobHandle(): FutureRef<LocalBlobHandleAndSize | undefined> {\n    return this.getFileHandle();\n  }\n\n  /**\n   * @returns downloaded file handle\n   */\n  public getRemoteFileHandle(): FutureRef<RemoteBlobHandleAndSize | undefined> {\n    return new FutureRef(getCfgRenderCtx().getOnDemandBlobContentHandle(this.handle));\n  }\n\n  /**\n   * @deprecated use getRemoteFileHandle\n   */\n  public getOnDemandBlobHandle(): FutureRef<RemoteBlobHandleAndSize | undefined> {\n    return this.getRemoteFileHandle();\n  }\n\n  /**\n   * @returns the url to the extracted folder\n   */\n  public extractArchiveAndGetURL(format: ArchiveFormat): FutureRef<FolderURL | undefined> {\n    return new FutureRef(getCfgRenderCtx().extractArchiveAndGetURL(this.handle, format));\n  }\n\n  public getImportProgress(): FutureRef<ImportProgress> {\n    return new FutureRef(getCfgRenderCtx().getImportProgress(this.handle));\n  }\n\n  public getLastLogs(nLines: number): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getLastLogs(this.handle, nLines));\n  }\n\n  public getProgressLog(patternToSearch: string): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getProgressLog(this.handle, patternToSearch));\n  }\n\n  public getProgressLogWithInfo(\n    patternToSearch: string,\n  ): FutureRef<ProgressLogWithInfo | undefined> {\n    return new FutureRef(getCfgRenderCtx().getProgressLogWithInfo(this.handle, patternToSearch));\n  }\n\n  public getLogHandle(): FutureRef<AnyLogHandle | undefined> {\n    return new FutureRef(getCfgRenderCtx().getLogHandle(this.handle));\n  }\n\n  public allFieldsResolved(fieldType: \"Input\" | \"Output\" = \"Input\"): boolean {\n    switch (fieldType) {\n      case \"Input\":\n        return (\n          this.getInputsLocked() &&\n          this.listInputFields().every(\n            (field) => this.resolve({ field, assertFieldType: \"Input\" }) !== undefined,\n          )\n        );\n      case \"Output\":\n        return (\n          this.getOutputsLocked() &&\n          this.listOutputFields().every(\n            (field) => this.resolve({ field, assertFieldType: \"Output\" }) !== undefined,\n          )\n        );\n    }\n  }\n\n  public mapFields<T>(\n    _mapping: (name: string, value: TreeNodeAccessor) => T,\n    _ops: FieldMapOps & { skipUnresolved: true },\n  ): T[] | undefined;\n  public mapFields<T>(\n    _mapping: (name: string, value: TreeNodeAccessor | undefined) => T,\n    _ops?: FieldMapOps,\n  ): T[] | undefined;\n  public mapFields<T>(\n    _mapping: (name: string, value: TreeNodeAccessor) => T,\n    _ops?: FieldMapOps,\n  ): T[] | undefined {\n    const { fieldType, requireLocked, skipUnresolved } = {\n      fieldType: \"Input\" as const,\n      requireLocked: true,\n      skipUnresolved: false,\n      ..._ops,\n    };\n    const mapping = _mapping as (name: string, value: TreeNodeAccessor | undefined) => T;\n    if (requireLocked) {\n      if (fieldType === \"Input\" && !this.getInputsLocked()) return undefined;\n      if (fieldType === \"Output\" && !this.getOutputsLocked()) return undefined;\n    }\n    const fieldList =\n      fieldType === \"Input\"\n        ? this.listInputFields()\n        : fieldType === \"Output\"\n          ? this.listOutputFields()\n          : this.listDynamicFields();\n    let fieldEntries = fieldList.map(\n      (field) => [field, this.resolve({ field, assertFieldType: fieldType })] as const,\n    );\n    if (skipUnresolved) fieldEntries = fieldEntries.filter((e) => e[1] !== undefined);\n    return fieldEntries.map(([name, value]) => mapping(name, value));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"accessor.cjs","names":["getCfgRenderCtx","FutureRef"],"sources":["../../src/render/accessor.ts"],"sourcesContent":["import type {\n  AnyLogHandle,\n  ImportProgress,\n  LocalBlobHandleAndSize,\n  PColumn,\n  PObject,\n  RemoteBlobHandleAndSize,\n  FolderURL,\n  ArchiveFormat,\n  ProgressLogWithInfo,\n  RangeBytes,\n} from \"@milaboratories/pl-model-common\";\nimport { isPColumn, mapPObjectData } from \"@milaboratories/pl-model-common\";\nimport { getCfgRenderCtx } from \"../internal\";\nimport { FutureRef } from \"./future\";\nimport type { AccessorHandle } from \"./internal\";\nimport type { CommonFieldTraverseOps, FieldTraversalStep, ResourceType } from \"./traversal_ops\";\n\nexport function ifDef<T, R>(value: T | undefined, cb: (value: T) => R): R | undefined {\n  return value === undefined ? undefined : cb(value);\n}\n\ntype FieldMapOps = {\n  /**\n   * Type of fields to iterate over.\n   * (default 'Input')\n   * */\n  readonly fieldType?: \"Input\" | \"Output\" | \"Dynamic\";\n  /**\n   * If not locked, `undefined` value will be returned. Do nothing if mapping `Dynamic` fields.\n   * (default true)\n   * */\n  readonly requireLocked?: boolean;\n  /**\n   * Will skip unresolved fields.\n   * (default false)\n   * */\n  readonly skipUnresolved?: boolean;\n};\n\n/** Represent resource tree node accessor */\nexport class TreeNodeAccessor {\n  constructor(\n    public readonly handle: AccessorHandle,\n    public readonly resolvePath: string[],\n  ) {}\n\n  /** Shortcut for {@link resolveInput} */\n  public resolve(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  /** Shortcut for {@link resolveInput} */\n  public resolve(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolve(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    const transformedSteps = steps.map(\n      (s) =>\n        ({\n          assertFieldType: \"Input\",\n          ...(typeof s === \"string\" ? { field: s } : s),\n        }) satisfies FieldTraversalStep,\n    );\n    return this.resolveWithCommon({}, ...transformedSteps);\n  }\n\n  /** If field type assertion is not specified for the step, default is Output. */\n  public resolveOutput(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  /** If field type assertion is not specified for the step, default is Output. */\n  public resolveOutput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolveOutput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    const transformedSteps = steps.map(\n      (s) =>\n        ({\n          assertFieldType: \"Output\",\n          ...(typeof s === \"string\" ? { field: s } : s),\n        }) satisfies FieldTraversalStep,\n    );\n    return this.resolveWithCommon({}, ...transformedSteps);\n  }\n\n  /** If field type assertion is not specified for the step, default is Input. */\n  public resolveInput(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  /** If field type assertion is not specified for the step, default is Input. */\n  public resolveInput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolveInput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    const transformedSteps = steps.map(\n      (s) =>\n        ({\n          assertFieldType: \"Input\",\n          ...(typeof s === \"string\" ? { field: s } : s),\n        }) satisfies FieldTraversalStep,\n    );\n    return this.resolveWithCommon({}, ...transformedSteps);\n  }\n\n  public resolveAny(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  public resolveAny(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolveAny(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    return this.resolveWithCommon({}, ...steps);\n  }\n\n  public resolveWithCommon(\n    commonOptions: CommonFieldTraverseOps,\n    ...steps: (FieldTraversalStep | string)[]\n  ): TreeNodeAccessor | undefined {\n    const resolvePath = [\n      ...this.resolvePath,\n      ...steps.map((step) => (typeof step === \"string\" ? step : step.field)),\n    ];\n    return ifDef(\n      getCfgRenderCtx().resolveWithCommon(this.handle, commonOptions, ...steps),\n      (accessor) => new TreeNodeAccessor(accessor, resolvePath),\n    );\n  }\n\n  public get resourceType(): ResourceType {\n    return getCfgRenderCtx().getResourceType(this.handle);\n  }\n\n  public getInputsLocked(): boolean {\n    return getCfgRenderCtx().getInputsLocked(this.handle);\n  }\n\n  public getOutputsLocked(): boolean {\n    return getCfgRenderCtx().getOutputsLocked(this.handle);\n  }\n\n  public getIsReadyOrError(): boolean {\n    return getCfgRenderCtx().getIsReadyOrError(this.handle);\n  }\n\n  public getIsFinal(): boolean {\n    return getCfgRenderCtx().getIsFinal(this.handle);\n  }\n\n  public getError(): TreeNodeAccessor | undefined {\n    const resolvePath = [...this.resolvePath, \"error\"];\n    return ifDef(\n      getCfgRenderCtx().getError(this.handle),\n      (accsessor) => new TreeNodeAccessor(accsessor, resolvePath),\n    );\n  }\n\n  public listInputFields(): string[] {\n    return getCfgRenderCtx().listInputFields(this.handle);\n  }\n\n  public listOutputFields(): string[] {\n    return getCfgRenderCtx().listOutputFields(this.handle);\n  }\n\n  public listDynamicFields(): string[] {\n    return getCfgRenderCtx().listDynamicFields(this.handle);\n  }\n\n  public getKeyValueBase64(key: string): string | undefined {\n    return getCfgRenderCtx().getKeyValueBase64(this.handle, key);\n  }\n\n  public getKeyValueAsString(key: string): string | undefined {\n    return getCfgRenderCtx().getKeyValueAsString(this.handle, key);\n  }\n\n  public getKeyValueAsJson<T>(key: string): T {\n    const content = this.getKeyValueAsString(key);\n    if (content == undefined) throw new Error(\"Resource has no content.\");\n    return JSON.parse(content);\n  }\n\n  public getDataBase64(): string | undefined {\n    return getCfgRenderCtx().getDataBase64(this.handle);\n  }\n\n  public getDataAsString(): string | undefined {\n    return getCfgRenderCtx().getDataAsString(this.handle);\n  }\n\n  public getDataAsJson<T>(): T {\n    const content = this.getDataAsString();\n    if (content == undefined) throw new Error(\"Resource has no content.\");\n    return JSON.parse(content);\n  }\n\n  /**\n   *\n   */\n  public getPColumns(\n    errorOnUnknownField: boolean = false,\n    prefix: string = \"\",\n  ): PColumn<TreeNodeAccessor>[] | undefined {\n    const result = this.parsePObjectCollection(errorOnUnknownField, prefix);\n    if (result === undefined) return undefined;\n\n    const pf = Object.entries(result).map(([, obj]) => {\n      if (!isPColumn(obj)) throw new Error(`not a PColumn (kind = ${obj.spec.kind})`);\n      return obj;\n    });\n\n    return pf;\n  }\n\n  /**\n   *\n   */\n  public parsePObjectCollection(\n    errorOnUnknownField: boolean = false,\n    prefix: string = \"\",\n  ): Record<string, PObject<TreeNodeAccessor>> | undefined {\n    const pObjects = getCfgRenderCtx().parsePObjectCollection(\n      this.handle,\n      errorOnUnknownField,\n      prefix,\n      ...this.resolvePath,\n    );\n    if (pObjects === undefined) return undefined;\n    const result: Record<string, PObject<TreeNodeAccessor>> = {};\n    for (const [key, value] of Object.entries(pObjects)) {\n      const resolvePath = [...this.resolvePath, key];\n      result[key] = mapPObjectData(value, (c) => new TreeNodeAccessor(c, resolvePath));\n    }\n    return result;\n  }\n\n  public getFileContentAsBase64(range?: RangeBytes): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getBlobContentAsBase64(this.handle, range));\n  }\n\n  public getFileContentAsString(range?: RangeBytes): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getBlobContentAsString(this.handle, range));\n  }\n\n  public getFileContentAsJson<T>(range?: RangeBytes): FutureRef<T | undefined> {\n    return new FutureRef<string | undefined>(\n      getCfgRenderCtx().getBlobContentAsString(this.handle, range),\n    ).mapDefined((v) => JSON.parse(v) as T);\n  }\n\n  /**\n   * @deprecated use getFileContentAsBase64\n   */\n  public getBlobContentAsBase64(): FutureRef<string | undefined> {\n    return this.getFileContentAsBase64();\n  }\n\n  /**\n   * @deprecated use getFileContentAsString\n   */\n  public getBlobContentAsString(): FutureRef<string | undefined> {\n    return this.getFileContentAsString();\n  }\n\n  /**\n   * @returns downloaded file handle\n   */\n  public getFileHandle(): FutureRef<LocalBlobHandleAndSize | undefined> {\n    return new FutureRef(getCfgRenderCtx().getDownloadedBlobContentHandle(this.handle));\n  }\n\n  /**\n   * @deprecated use getFileHandle\n   */\n  public getDownloadedBlobHandle(): FutureRef<LocalBlobHandleAndSize | undefined> {\n    return this.getFileHandle();\n  }\n\n  /**\n   * @returns downloaded file handle\n   */\n  public getRemoteFileHandle(): FutureRef<RemoteBlobHandleAndSize | undefined> {\n    return new FutureRef(getCfgRenderCtx().getOnDemandBlobContentHandle(this.handle));\n  }\n\n  /**\n   * @deprecated use getRemoteFileHandle\n   */\n  public getOnDemandBlobHandle(): FutureRef<RemoteBlobHandleAndSize | undefined> {\n    return this.getRemoteFileHandle();\n  }\n\n  /**\n   * @returns the url to the extracted folder\n   */\n  public extractArchiveAndGetURL(format: ArchiveFormat): FutureRef<FolderURL | undefined> {\n    return new FutureRef(getCfgRenderCtx().extractArchiveAndGetURL(this.handle, format));\n  }\n\n  public getImportProgress(): FutureRef<ImportProgress> {\n    return new FutureRef(getCfgRenderCtx().getImportProgress(this.handle));\n  }\n\n  public getLastLogs(nLines: number): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getLastLogs(this.handle, nLines));\n  }\n\n  public getProgressLog(patternToSearch: string): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getProgressLog(this.handle, patternToSearch));\n  }\n\n  public getProgressLogWithInfo(\n    patternToSearch: string,\n  ): FutureRef<ProgressLogWithInfo | undefined> {\n    return new FutureRef(getCfgRenderCtx().getProgressLogWithInfo(this.handle, patternToSearch));\n  }\n\n  public getLogHandle(): FutureRef<AnyLogHandle | undefined> {\n    return new FutureRef(getCfgRenderCtx().getLogHandle(this.handle));\n  }\n\n  public allFieldsResolved(fieldType: \"Input\" | \"Output\" = \"Input\"): boolean {\n    switch (fieldType) {\n      case \"Input\":\n        return (\n          this.getInputsLocked() &&\n          this.listInputFields().every(\n            (field) => this.resolve({ field, assertFieldType: \"Input\" }) !== undefined,\n          )\n        );\n      case \"Output\":\n        return (\n          this.getOutputsLocked() &&\n          this.listOutputFields().every(\n            (field) => this.resolve({ field, assertFieldType: \"Output\" }) !== undefined,\n          )\n        );\n    }\n  }\n\n  public mapFields<T>(\n    _mapping: (name: string, value: TreeNodeAccessor) => T,\n    _ops: FieldMapOps & { skipUnresolved: true },\n  ): T[] | undefined;\n  public mapFields<T>(\n    _mapping: (name: string, value: TreeNodeAccessor | undefined) => T,\n    _ops?: FieldMapOps,\n  ): T[] | undefined;\n  public mapFields<T>(\n    _mapping: (name: string, value: TreeNodeAccessor) => T,\n    _ops?: FieldMapOps,\n  ): T[] | undefined {\n    const { fieldType, requireLocked, skipUnresolved } = {\n      fieldType: \"Input\" as const,\n      requireLocked: true,\n      skipUnresolved: false,\n      ..._ops,\n    };\n    const mapping = _mapping as (name: string, value: TreeNodeAccessor | undefined) => T;\n    if (requireLocked) {\n      if (fieldType === \"Input\" && !this.getInputsLocked()) return undefined;\n      if (fieldType === \"Output\" && !this.getOutputsLocked()) return undefined;\n    }\n    const fieldList =\n      fieldType === \"Input\"\n        ? this.listInputFields()\n        : fieldType === \"Output\"\n          ? this.listOutputFields()\n          : this.listDynamicFields();\n    let fieldEntries = fieldList.map(\n      (field) => [field, this.resolve({ field, assertFieldType: fieldType })] as const,\n    );\n    if (skipUnresolved) fieldEntries = fieldEntries.filter((e) => e[1] !== undefined);\n    return fieldEntries.map(([name, value]) => mapping(name, value));\n  }\n}\n"],"mappings":"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"}

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

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

package/dist/render/accessor.js

@@ -1,7 +1,6 @@
 import { getCfgRenderCtx } from "../internal.js";
 import { FutureRef } from "./future.js";
 import { isPColumn, mapPObjectData } from "@milaboratories/pl-model-common";
-
 //#region src/render/accessor.ts
 function ifDef(value, cb) {
 	return value === void 0 ? void 0 : cb(value);
@@ -212,7 +211,7 @@ var TreeNodeAccessor = class TreeNodeAccessor {
 		return fieldEntries.map(([name, value]) => mapping(name, value));
 	}
 };
-
 //#endregion
 export { TreeNodeAccessor, ifDef };
+
 //# sourceMappingURL=accessor.js.map

package/dist/render/accessor.js.map

@@ -1 +1 @@
-{"version":3,"file":"accessor.js","names":[],"sources":["../../src/render/accessor.ts"],"sourcesContent":["import type {\n  AnyLogHandle,\n  ImportProgress,\n  LocalBlobHandleAndSize,\n  PColumn,\n  PObject,\n  RemoteBlobHandleAndSize,\n  FolderURL,\n  ArchiveFormat,\n  ProgressLogWithInfo,\n  RangeBytes,\n} from \"@milaboratories/pl-model-common\";\nimport { isPColumn, mapPObjectData } from \"@milaboratories/pl-model-common\";\nimport { getCfgRenderCtx } from \"../internal\";\nimport { FutureRef } from \"./future\";\nimport type { AccessorHandle } from \"./internal\";\nimport type { CommonFieldTraverseOps, FieldTraversalStep, ResourceType } from \"./traversal_ops\";\n\nexport function ifDef<T, R>(value: T | undefined, cb: (value: T) => R): R | undefined {\n  return value === undefined ? undefined : cb(value);\n}\n\ntype FieldMapOps = {\n  /**\n   * Type of fields to iterate over.\n   * (default 'Input')\n   * */\n  readonly fieldType?: \"Input\" | \"Output\" | \"Dynamic\";\n  /**\n   * If not locked, `undefined` value will be returned. Do nothing if mapping `Dynamic` fields.\n   * (default true)\n   * */\n  readonly requireLocked?: boolean;\n  /**\n   * Will skip unresolved fields.\n   * (default false)\n   * */\n  readonly skipUnresolved?: boolean;\n};\n\n/** Represent resource tree node accessor */\nexport class TreeNodeAccessor {\n  constructor(\n    public readonly handle: AccessorHandle,\n    public readonly resolvePath: string[],\n  ) {}\n\n  /** Shortcut for {@link resolveInput} */\n  public resolve(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  /** Shortcut for {@link resolveInput} */\n  public resolve(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolve(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    const transformedSteps = steps.map(\n      (s) =>\n        ({\n          assertFieldType: \"Input\",\n          ...(typeof s === \"string\" ? { field: s } : s),\n        }) satisfies FieldTraversalStep,\n    );\n    return this.resolveWithCommon({}, ...transformedSteps);\n  }\n\n  /** If field type assertion is not specified for the step, default is Output. */\n  public resolveOutput(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  /** If field type assertion is not specified for the step, default is Output. */\n  public resolveOutput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolveOutput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    const transformedSteps = steps.map(\n      (s) =>\n        ({\n          assertFieldType: \"Output\",\n          ...(typeof s === \"string\" ? { field: s } : s),\n        }) satisfies FieldTraversalStep,\n    );\n    return this.resolveWithCommon({}, ...transformedSteps);\n  }\n\n  /** If field type assertion is not specified for the step, default is Input. */\n  public resolveInput(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  /** If field type assertion is not specified for the step, default is Input. */\n  public resolveInput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolveInput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    const transformedSteps = steps.map(\n      (s) =>\n        ({\n          assertFieldType: \"Input\",\n          ...(typeof s === \"string\" ? { field: s } : s),\n        }) satisfies FieldTraversalStep,\n    );\n    return this.resolveWithCommon({}, ...transformedSteps);\n  }\n\n  public resolveAny(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  public resolveAny(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolveAny(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    return this.resolveWithCommon({}, ...steps);\n  }\n\n  public resolveWithCommon(\n    commonOptions: CommonFieldTraverseOps,\n    ...steps: (FieldTraversalStep | string)[]\n  ): TreeNodeAccessor | undefined {\n    const resolvePath = [\n      ...this.resolvePath,\n      ...steps.map((step) => (typeof step === \"string\" ? step : step.field)),\n    ];\n    return ifDef(\n      getCfgRenderCtx().resolveWithCommon(this.handle, commonOptions, ...steps),\n      (accessor) => new TreeNodeAccessor(accessor, resolvePath),\n    );\n  }\n\n  public get resourceType(): ResourceType {\n    return getCfgRenderCtx().getResourceType(this.handle);\n  }\n\n  public getInputsLocked(): boolean {\n    return getCfgRenderCtx().getInputsLocked(this.handle);\n  }\n\n  public getOutputsLocked(): boolean {\n    return getCfgRenderCtx().getOutputsLocked(this.handle);\n  }\n\n  public getIsReadyOrError(): boolean {\n    return getCfgRenderCtx().getIsReadyOrError(this.handle);\n  }\n\n  public getIsFinal(): boolean {\n    return getCfgRenderCtx().getIsFinal(this.handle);\n  }\n\n  public getError(): TreeNodeAccessor | undefined {\n    const resolvePath = [...this.resolvePath, \"error\"];\n    return ifDef(\n      getCfgRenderCtx().getError(this.handle),\n      (accsessor) => new TreeNodeAccessor(accsessor, resolvePath),\n    );\n  }\n\n  public listInputFields(): string[] {\n    return getCfgRenderCtx().listInputFields(this.handle);\n  }\n\n  public listOutputFields(): string[] {\n    return getCfgRenderCtx().listOutputFields(this.handle);\n  }\n\n  public listDynamicFields(): string[] {\n    return getCfgRenderCtx().listDynamicFields(this.handle);\n  }\n\n  public getKeyValueBase64(key: string): string | undefined {\n    return getCfgRenderCtx().getKeyValueBase64(this.handle, key);\n  }\n\n  public getKeyValueAsString(key: string): string | undefined {\n    return getCfgRenderCtx().getKeyValueAsString(this.handle, key);\n  }\n\n  public getKeyValueAsJson<T>(key: string): T {\n    const content = this.getKeyValueAsString(key);\n    if (content == undefined) throw new Error(\"Resource has no content.\");\n    return JSON.parse(content);\n  }\n\n  public getDataBase64(): string | undefined {\n    return getCfgRenderCtx().getDataBase64(this.handle);\n  }\n\n  public getDataAsString(): string | undefined {\n    return getCfgRenderCtx().getDataAsString(this.handle);\n  }\n\n  public getDataAsJson<T>(): T {\n    const content = this.getDataAsString();\n    if (content == undefined) throw new Error(\"Resource has no content.\");\n    return JSON.parse(content);\n  }\n\n  /**\n   *\n   */\n  public getPColumns(\n    errorOnUnknownField: boolean = false,\n    prefix: string = \"\",\n  ): PColumn<TreeNodeAccessor>[] | undefined {\n    const result = this.parsePObjectCollection(errorOnUnknownField, prefix);\n    if (result === undefined) return undefined;\n\n    const pf = Object.entries(result).map(([, obj]) => {\n      if (!isPColumn(obj)) throw new Error(`not a PColumn (kind = ${obj.spec.kind})`);\n      return obj;\n    });\n\n    return pf;\n  }\n\n  /**\n   *\n   */\n  public parsePObjectCollection(\n    errorOnUnknownField: boolean = false,\n    prefix: string = \"\",\n  ): Record<string, PObject<TreeNodeAccessor>> | undefined {\n    const pObjects = getCfgRenderCtx().parsePObjectCollection(\n      this.handle,\n      errorOnUnknownField,\n      prefix,\n      ...this.resolvePath,\n    );\n    if (pObjects === undefined) return undefined;\n    const result: Record<string, PObject<TreeNodeAccessor>> = {};\n    for (const [key, value] of Object.entries(pObjects)) {\n      const resolvePath = [...this.resolvePath, key];\n      result[key] = mapPObjectData(value, (c) => new TreeNodeAccessor(c, resolvePath));\n    }\n    return result;\n  }\n\n  public getFileContentAsBase64(range?: RangeBytes): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getBlobContentAsBase64(this.handle, range));\n  }\n\n  public getFileContentAsString(range?: RangeBytes): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getBlobContentAsString(this.handle, range));\n  }\n\n  public getFileContentAsJson<T>(range?: RangeBytes): FutureRef<T | undefined> {\n    return new FutureRef<string | undefined>(\n      getCfgRenderCtx().getBlobContentAsString(this.handle, range),\n    ).mapDefined((v) => JSON.parse(v) as T);\n  }\n\n  /**\n   * @deprecated use getFileContentAsBase64\n   */\n  public getBlobContentAsBase64(): FutureRef<string | undefined> {\n    return this.getFileContentAsBase64();\n  }\n\n  /**\n   * @deprecated use getFileContentAsString\n   */\n  public getBlobContentAsString(): FutureRef<string | undefined> {\n    return this.getFileContentAsString();\n  }\n\n  /**\n   * @returns downloaded file handle\n   */\n  public getFileHandle(): FutureRef<LocalBlobHandleAndSize | undefined> {\n    return new FutureRef(getCfgRenderCtx().getDownloadedBlobContentHandle(this.handle));\n  }\n\n  /**\n   * @deprecated use getFileHandle\n   */\n  public getDownloadedBlobHandle(): FutureRef<LocalBlobHandleAndSize | undefined> {\n    return this.getFileHandle();\n  }\n\n  /**\n   * @returns downloaded file handle\n   */\n  public getRemoteFileHandle(): FutureRef<RemoteBlobHandleAndSize | undefined> {\n    return new FutureRef(getCfgRenderCtx().getOnDemandBlobContentHandle(this.handle));\n  }\n\n  /**\n   * @deprecated use getRemoteFileHandle\n   */\n  public getOnDemandBlobHandle(): FutureRef<RemoteBlobHandleAndSize | undefined> {\n    return this.getRemoteFileHandle();\n  }\n\n  /**\n   * @returns the url to the extracted folder\n   */\n  public extractArchiveAndGetURL(format: ArchiveFormat): FutureRef<FolderURL | undefined> {\n    return new FutureRef(getCfgRenderCtx().extractArchiveAndGetURL(this.handle, format));\n  }\n\n  public getImportProgress(): FutureRef<ImportProgress> {\n    return new FutureRef(getCfgRenderCtx().getImportProgress(this.handle));\n  }\n\n  public getLastLogs(nLines: number): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getLastLogs(this.handle, nLines));\n  }\n\n  public getProgressLog(patternToSearch: string): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getProgressLog(this.handle, patternToSearch));\n  }\n\n  public getProgressLogWithInfo(\n    patternToSearch: string,\n  ): FutureRef<ProgressLogWithInfo | undefined> {\n    return new FutureRef(getCfgRenderCtx().getProgressLogWithInfo(this.handle, patternToSearch));\n  }\n\n  public getLogHandle(): FutureRef<AnyLogHandle | undefined> {\n    return new FutureRef(getCfgRenderCtx().getLogHandle(this.handle));\n  }\n\n  public allFieldsResolved(fieldType: \"Input\" | \"Output\" = \"Input\"): boolean {\n    switch (fieldType) {\n      case \"Input\":\n        return (\n          this.getInputsLocked() &&\n          this.listInputFields().every(\n            (field) => this.resolve({ field, assertFieldType: \"Input\" }) !== undefined,\n          )\n        );\n      case \"Output\":\n        return (\n          this.getOutputsLocked() &&\n          this.listOutputFields().every(\n            (field) => this.resolve({ field, assertFieldType: \"Output\" }) !== undefined,\n          )\n        );\n    }\n  }\n\n  public mapFields<T>(\n    _mapping: (name: string, value: TreeNodeAccessor) => T,\n    _ops: FieldMapOps & { skipUnresolved: true },\n  ): T[] | undefined;\n  public mapFields<T>(\n    _mapping: (name: string, value: TreeNodeAccessor | undefined) => T,\n    _ops?: FieldMapOps,\n  ): T[] | undefined;\n  public mapFields<T>(\n    _mapping: (name: string, value: TreeNodeAccessor) => T,\n    _ops?: FieldMapOps,\n  ): T[] | undefined {\n    const { fieldType, requireLocked, skipUnresolved } = {\n      fieldType: \"Input\" as const,\n      requireLocked: true,\n      skipUnresolved: false,\n      ..._ops,\n    };\n    const mapping = _mapping as (name: string, value: TreeNodeAccessor | undefined) => T;\n    if (requireLocked) {\n      if (fieldType === \"Input\" && !this.getInputsLocked()) return undefined;\n      if (fieldType === \"Output\" && !this.getOutputsLocked()) return undefined;\n    }\n    const fieldList =\n      fieldType === \"Input\"\n        ? this.listInputFields()\n        : fieldType === \"Output\"\n          ? this.listOutputFields()\n          : this.listDynamicFields();\n    let fieldEntries = fieldList.map(\n      (field) => [field, this.resolve({ field, assertFieldType: fieldType })] as const,\n    );\n    if (skipUnresolved) fieldEntries = fieldEntries.filter((e) => e[1] !== undefined);\n    return fieldEntries.map(([name, value]) => mapping(name, value));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"accessor.js","names":[],"sources":["../../src/render/accessor.ts"],"sourcesContent":["import type {\n  AnyLogHandle,\n  ImportProgress,\n  LocalBlobHandleAndSize,\n  PColumn,\n  PObject,\n  RemoteBlobHandleAndSize,\n  FolderURL,\n  ArchiveFormat,\n  ProgressLogWithInfo,\n  RangeBytes,\n} from \"@milaboratories/pl-model-common\";\nimport { isPColumn, mapPObjectData } from \"@milaboratories/pl-model-common\";\nimport { getCfgRenderCtx } from \"../internal\";\nimport { FutureRef } from \"./future\";\nimport type { AccessorHandle } from \"./internal\";\nimport type { CommonFieldTraverseOps, FieldTraversalStep, ResourceType } from \"./traversal_ops\";\n\nexport function ifDef<T, R>(value: T | undefined, cb: (value: T) => R): R | undefined {\n  return value === undefined ? undefined : cb(value);\n}\n\ntype FieldMapOps = {\n  /**\n   * Type of fields to iterate over.\n   * (default 'Input')\n   * */\n  readonly fieldType?: \"Input\" | \"Output\" | \"Dynamic\";\n  /**\n   * If not locked, `undefined` value will be returned. Do nothing if mapping `Dynamic` fields.\n   * (default true)\n   * */\n  readonly requireLocked?: boolean;\n  /**\n   * Will skip unresolved fields.\n   * (default false)\n   * */\n  readonly skipUnresolved?: boolean;\n};\n\n/** Represent resource tree node accessor */\nexport class TreeNodeAccessor {\n  constructor(\n    public readonly handle: AccessorHandle,\n    public readonly resolvePath: string[],\n  ) {}\n\n  /** Shortcut for {@link resolveInput} */\n  public resolve(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  /** Shortcut for {@link resolveInput} */\n  public resolve(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolve(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    const transformedSteps = steps.map(\n      (s) =>\n        ({\n          assertFieldType: \"Input\",\n          ...(typeof s === \"string\" ? { field: s } : s),\n        }) satisfies FieldTraversalStep,\n    );\n    return this.resolveWithCommon({}, ...transformedSteps);\n  }\n\n  /** If field type assertion is not specified for the step, default is Output. */\n  public resolveOutput(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  /** If field type assertion is not specified for the step, default is Output. */\n  public resolveOutput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolveOutput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    const transformedSteps = steps.map(\n      (s) =>\n        ({\n          assertFieldType: \"Output\",\n          ...(typeof s === \"string\" ? { field: s } : s),\n        }) satisfies FieldTraversalStep,\n    );\n    return this.resolveWithCommon({}, ...transformedSteps);\n  }\n\n  /** If field type assertion is not specified for the step, default is Input. */\n  public resolveInput(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  /** If field type assertion is not specified for the step, default is Input. */\n  public resolveInput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolveInput(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    const transformedSteps = steps.map(\n      (s) =>\n        ({\n          assertFieldType: \"Input\",\n          ...(typeof s === \"string\" ? { field: s } : s),\n        }) satisfies FieldTraversalStep,\n    );\n    return this.resolveWithCommon({}, ...transformedSteps);\n  }\n\n  public resolveAny(\n    ...steps: [\n      Omit<FieldTraversalStep, \"errorIfFieldNotSet\"> & {\n        errorIfFieldNotAssigned: true;\n      },\n    ]\n  ): TreeNodeAccessor;\n  public resolveAny(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined;\n  public resolveAny(...steps: (FieldTraversalStep | string)[]): TreeNodeAccessor | undefined {\n    return this.resolveWithCommon({}, ...steps);\n  }\n\n  public resolveWithCommon(\n    commonOptions: CommonFieldTraverseOps,\n    ...steps: (FieldTraversalStep | string)[]\n  ): TreeNodeAccessor | undefined {\n    const resolvePath = [\n      ...this.resolvePath,\n      ...steps.map((step) => (typeof step === \"string\" ? step : step.field)),\n    ];\n    return ifDef(\n      getCfgRenderCtx().resolveWithCommon(this.handle, commonOptions, ...steps),\n      (accessor) => new TreeNodeAccessor(accessor, resolvePath),\n    );\n  }\n\n  public get resourceType(): ResourceType {\n    return getCfgRenderCtx().getResourceType(this.handle);\n  }\n\n  public getInputsLocked(): boolean {\n    return getCfgRenderCtx().getInputsLocked(this.handle);\n  }\n\n  public getOutputsLocked(): boolean {\n    return getCfgRenderCtx().getOutputsLocked(this.handle);\n  }\n\n  public getIsReadyOrError(): boolean {\n    return getCfgRenderCtx().getIsReadyOrError(this.handle);\n  }\n\n  public getIsFinal(): boolean {\n    return getCfgRenderCtx().getIsFinal(this.handle);\n  }\n\n  public getError(): TreeNodeAccessor | undefined {\n    const resolvePath = [...this.resolvePath, \"error\"];\n    return ifDef(\n      getCfgRenderCtx().getError(this.handle),\n      (accsessor) => new TreeNodeAccessor(accsessor, resolvePath),\n    );\n  }\n\n  public listInputFields(): string[] {\n    return getCfgRenderCtx().listInputFields(this.handle);\n  }\n\n  public listOutputFields(): string[] {\n    return getCfgRenderCtx().listOutputFields(this.handle);\n  }\n\n  public listDynamicFields(): string[] {\n    return getCfgRenderCtx().listDynamicFields(this.handle);\n  }\n\n  public getKeyValueBase64(key: string): string | undefined {\n    return getCfgRenderCtx().getKeyValueBase64(this.handle, key);\n  }\n\n  public getKeyValueAsString(key: string): string | undefined {\n    return getCfgRenderCtx().getKeyValueAsString(this.handle, key);\n  }\n\n  public getKeyValueAsJson<T>(key: string): T {\n    const content = this.getKeyValueAsString(key);\n    if (content == undefined) throw new Error(\"Resource has no content.\");\n    return JSON.parse(content);\n  }\n\n  public getDataBase64(): string | undefined {\n    return getCfgRenderCtx().getDataBase64(this.handle);\n  }\n\n  public getDataAsString(): string | undefined {\n    return getCfgRenderCtx().getDataAsString(this.handle);\n  }\n\n  public getDataAsJson<T>(): T {\n    const content = this.getDataAsString();\n    if (content == undefined) throw new Error(\"Resource has no content.\");\n    return JSON.parse(content);\n  }\n\n  /**\n   *\n   */\n  public getPColumns(\n    errorOnUnknownField: boolean = false,\n    prefix: string = \"\",\n  ): PColumn<TreeNodeAccessor>[] | undefined {\n    const result = this.parsePObjectCollection(errorOnUnknownField, prefix);\n    if (result === undefined) return undefined;\n\n    const pf = Object.entries(result).map(([, obj]) => {\n      if (!isPColumn(obj)) throw new Error(`not a PColumn (kind = ${obj.spec.kind})`);\n      return obj;\n    });\n\n    return pf;\n  }\n\n  /**\n   *\n   */\n  public parsePObjectCollection(\n    errorOnUnknownField: boolean = false,\n    prefix: string = \"\",\n  ): Record<string, PObject<TreeNodeAccessor>> | undefined {\n    const pObjects = getCfgRenderCtx().parsePObjectCollection(\n      this.handle,\n      errorOnUnknownField,\n      prefix,\n      ...this.resolvePath,\n    );\n    if (pObjects === undefined) return undefined;\n    const result: Record<string, PObject<TreeNodeAccessor>> = {};\n    for (const [key, value] of Object.entries(pObjects)) {\n      const resolvePath = [...this.resolvePath, key];\n      result[key] = mapPObjectData(value, (c) => new TreeNodeAccessor(c, resolvePath));\n    }\n    return result;\n  }\n\n  public getFileContentAsBase64(range?: RangeBytes): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getBlobContentAsBase64(this.handle, range));\n  }\n\n  public getFileContentAsString(range?: RangeBytes): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getBlobContentAsString(this.handle, range));\n  }\n\n  public getFileContentAsJson<T>(range?: RangeBytes): FutureRef<T | undefined> {\n    return new FutureRef<string | undefined>(\n      getCfgRenderCtx().getBlobContentAsString(this.handle, range),\n    ).mapDefined((v) => JSON.parse(v) as T);\n  }\n\n  /**\n   * @deprecated use getFileContentAsBase64\n   */\n  public getBlobContentAsBase64(): FutureRef<string | undefined> {\n    return this.getFileContentAsBase64();\n  }\n\n  /**\n   * @deprecated use getFileContentAsString\n   */\n  public getBlobContentAsString(): FutureRef<string | undefined> {\n    return this.getFileContentAsString();\n  }\n\n  /**\n   * @returns downloaded file handle\n   */\n  public getFileHandle(): FutureRef<LocalBlobHandleAndSize | undefined> {\n    return new FutureRef(getCfgRenderCtx().getDownloadedBlobContentHandle(this.handle));\n  }\n\n  /**\n   * @deprecated use getFileHandle\n   */\n  public getDownloadedBlobHandle(): FutureRef<LocalBlobHandleAndSize | undefined> {\n    return this.getFileHandle();\n  }\n\n  /**\n   * @returns downloaded file handle\n   */\n  public getRemoteFileHandle(): FutureRef<RemoteBlobHandleAndSize | undefined> {\n    return new FutureRef(getCfgRenderCtx().getOnDemandBlobContentHandle(this.handle));\n  }\n\n  /**\n   * @deprecated use getRemoteFileHandle\n   */\n  public getOnDemandBlobHandle(): FutureRef<RemoteBlobHandleAndSize | undefined> {\n    return this.getRemoteFileHandle();\n  }\n\n  /**\n   * @returns the url to the extracted folder\n   */\n  public extractArchiveAndGetURL(format: ArchiveFormat): FutureRef<FolderURL | undefined> {\n    return new FutureRef(getCfgRenderCtx().extractArchiveAndGetURL(this.handle, format));\n  }\n\n  public getImportProgress(): FutureRef<ImportProgress> {\n    return new FutureRef(getCfgRenderCtx().getImportProgress(this.handle));\n  }\n\n  public getLastLogs(nLines: number): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getLastLogs(this.handle, nLines));\n  }\n\n  public getProgressLog(patternToSearch: string): FutureRef<string | undefined> {\n    return new FutureRef(getCfgRenderCtx().getProgressLog(this.handle, patternToSearch));\n  }\n\n  public getProgressLogWithInfo(\n    patternToSearch: string,\n  ): FutureRef<ProgressLogWithInfo | undefined> {\n    return new FutureRef(getCfgRenderCtx().getProgressLogWithInfo(this.handle, patternToSearch));\n  }\n\n  public getLogHandle(): FutureRef<AnyLogHandle | undefined> {\n    return new FutureRef(getCfgRenderCtx().getLogHandle(this.handle));\n  }\n\n  public allFieldsResolved(fieldType: \"Input\" | \"Output\" = \"Input\"): boolean {\n    switch (fieldType) {\n      case \"Input\":\n        return (\n          this.getInputsLocked() &&\n          this.listInputFields().every(\n            (field) => this.resolve({ field, assertFieldType: \"Input\" }) !== undefined,\n          )\n        );\n      case \"Output\":\n        return (\n          this.getOutputsLocked() &&\n          this.listOutputFields().every(\n            (field) => this.resolve({ field, assertFieldType: \"Output\" }) !== undefined,\n          )\n        );\n    }\n  }\n\n  public mapFields<T>(\n    _mapping: (name: string, value: TreeNodeAccessor) => T,\n    _ops: FieldMapOps & { skipUnresolved: true },\n  ): T[] | undefined;\n  public mapFields<T>(\n    _mapping: (name: string, value: TreeNodeAccessor | undefined) => T,\n    _ops?: FieldMapOps,\n  ): T[] | undefined;\n  public mapFields<T>(\n    _mapping: (name: string, value: TreeNodeAccessor) => T,\n    _ops?: FieldMapOps,\n  ): T[] | undefined {\n    const { fieldType, requireLocked, skipUnresolved } = {\n      fieldType: \"Input\" as const,\n      requireLocked: true,\n      skipUnresolved: false,\n      ..._ops,\n    };\n    const mapping = _mapping as (name: string, value: TreeNodeAccessor | undefined) => T;\n    if (requireLocked) {\n      if (fieldType === \"Input\" && !this.getInputsLocked()) return undefined;\n      if (fieldType === \"Output\" && !this.getOutputsLocked()) return undefined;\n    }\n    const fieldList =\n      fieldType === \"Input\"\n        ? this.listInputFields()\n        : fieldType === \"Output\"\n          ? this.listOutputFields()\n          : this.listDynamicFields();\n    let fieldEntries = fieldList.map(\n      (field) => [field, this.resolve({ field, assertFieldType: fieldType })] as const,\n    );\n    if (skipUnresolved) fieldEntries = fieldEntries.filter((e) => e[1] !== undefined);\n    return fieldEntries.map(([name, value]) => mapping(name, value));\n  }\n}\n"],"mappings":"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"}

package/dist/render/api.cjs

@@ -1,16 +1,15 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-const require_block_storage = require('../block_storage.cjs');
-const require_internal = require('../internal.cjs');
-const require_accessor = require('./accessor.cjs');
-const require_internal$1 = require('./internal.cjs');
-const require_label = require('./util/label.cjs');
-const require_pcolumn_data = require('./util/pcolumn_data.cjs');
-const require_column_collection = require('./util/column_collection.cjs');
-const require_pframe_upgraders = require('./util/pframe_upgraders.cjs');
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_block_storage = require("../block_storage.cjs");
+const require_internal = require("../internal.cjs");
+const require_accessor = require("./accessor.cjs");
+const require_internal$1 = require("./internal.cjs");
+const require_label = require("./util/label.cjs");
+const require_pcolumn_data = require("./util/pcolumn_data.cjs");
+const require_column_collection = require("./util/column_collection.cjs");
+const require_pframe_upgraders = require("./util/pframe_upgraders.cjs");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
 let canonicalize = require("canonicalize");
 canonicalize = require_runtime.__toESM(canonicalize);
-
 //#region src/render/api.ts
 /**
 * Helper function to match domain objects
@@ -494,11 +493,11 @@ var PluginRenderCtx = class extends RenderCtxBase {
 		return this.paramsCache.v;
 	}
 };
-
 //#endregion
 exports.BlockRenderCtx = BlockRenderCtx;
 exports.PluginRenderCtx = PluginRenderCtx;
 exports.RenderCtxBase = RenderCtxBase;
 exports.RenderCtxLegacy = RenderCtxLegacy;
 exports.ResultPool = ResultPool;
+
 //# sourceMappingURL=api.cjs.map