@platforma-sdk/model 1.61.0 → 1.61.1

package/dist/block_model.cjs

@@ -268,11 +268,13 @@ var BlockModelV3 = class BlockModelV3 {
 			const wrappedInputs = {};
 			for (const [paramKey, paramFn] of Object.entries(inputs)) wrappedInputs[paramKey] = () => paramFn(new require_api.BlockRenderCtx());
 			const outputs = model.outputs;
+			const { outputFlags } = model;
 			for (const [outputKey, outputFn] of Object.entries(outputs)) {
 				const key = require_plugin_handle.pluginOutputKey(handle, outputKey);
 				pluginOutputs[key] = require_internal.createAndRegisterRenderLambda({
 					handle: key,
-					lambda: () => outputFn(new require_api.PluginRenderCtx(handle, wrappedInputs))
+					lambda: () => outputFn(new require_api.PluginRenderCtx(handle, wrappedInputs)),
+					withStatus: outputFlags[outputKey]?.withStatus
 				});
 			}
 		}

package/dist/block_model.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"block_model.cjs","names":["BLOCK_STORAGE_FACADE_VERSION","createAndRegisterRenderLambda","BlockRenderCtx","CREATE_PLUGIN_MODEL","BlockStorageFacadeCallbacks","applyStorageUpdate","getStorageDebugView","migrateStorage","createInitialStorage","deriveArgsFromStorage","derivePrerunArgsFromStorage","pluginOutputKey","PluginRenderCtx","isInUI","PlatformaSDKVersion","BlockStorageFacadeHandles","downgradeCfgOrLambda","getPlatformaInstance","isConfigLambda"],"sources":["../src/block_model.ts"],"sourcesContent":["import type {\n  BlockRenderingMode,\n  BlockSection,\n  OutputWithStatus,\n  PlRef,\n  BlockCodeKnownFeatureFlags,\n  BlockConfigContainer,\n} from \"@milaboratories/pl-model-common\";\nimport { getPlatformaInstance, isInUI, createAndRegisterRenderLambda } from \"./internal\";\nimport type { DataModel } from \"./block_migrations\";\nimport type { PlatformaV3 } from \"./platforma\";\nimport type { InferRenderFunctionReturn, RenderFunction } from \"./render\";\nimport { BlockRenderCtx, PluginRenderCtx } from \"./render\";\nimport type { PluginData, PluginModel, PluginOutputs, PluginParams } from \"./plugin_model\";\nimport { PluginInstance as PluginInstanceClass, CREATE_PLUGIN_MODEL } from \"./plugin_model\";\nimport { type PluginHandle, pluginOutputKey } from \"./plugin_handle\";\nimport type { RenderCtxBase } from \"./render\";\nimport { PlatformaSDKVersion } from \"./version\";\nimport {\n  applyStorageUpdate,\n  getStorageDebugView,\n  migrateStorage,\n  createInitialStorage,\n  deriveArgsFromStorage,\n  derivePrerunArgsFromStorage,\n} from \"./block_storage_callbacks\";\nimport { type PluginName } from \"./block_storage\";\nimport type {\n  ConfigRenderLambda,\n  DeriveHref,\n  ConfigRenderLambdaFlags,\n  InferOutputsFromLambdas,\n} from \"./bconfig\";\nimport { downgradeCfgOrLambda, isConfigLambda } from \"./bconfig\";\nimport type { PlatformaExtended } from \"./platforma\";\nimport {\n  BLOCK_STORAGE_FACADE_VERSION,\n  BlockStorageFacadeCallbacks,\n  BlockStorageFacadeHandles,\n  registerFacadeCallbacks,\n} from \"./block_storage_facade\";\n\ntype SectionsExpectedType = readonly BlockSection[];\n\ntype NoOb = Record<string, never>;\n\n/**\n * Per-property lambdas for deriving plugin params from block render context.\n * Each property is a function that receives the block's RenderCtxBase and returns the param value.\n */\nexport type ParamsInput<Params, BArgs = unknown, BData = unknown> = {\n  [K in keyof Params]: (ctx: RenderCtxBase<BArgs, BData>) => Params[K];\n};\n\n/**\n * Type-erased version of ParamsInput for internal storage.\n */\ntype ParamsInputErased = Record<string, (ctx: RenderCtxBase) => unknown>;\n\n/**\n * Merges two feature flag objects with type-aware logic:\n * - `supports*` (boolean): OR — `true` if either side is `true`\n * - `requires*` (numeric): MAX — take the higher version requirement\n */\nfunction mergeFeatureFlags(\n  base: BlockCodeKnownFeatureFlags,\n  override: BlockCodeKnownFeatureFlags,\n): BlockCodeKnownFeatureFlags {\n  const result: Record<string, boolean | number | undefined> = { ...base };\n  for (const [key, value] of Object.entries(override)) {\n    if (value === undefined) continue;\n    const existing = result[key];\n    if (typeof value === \"boolean\") {\n      result[key] = (typeof existing === \"boolean\" && existing) || value;\n    } else if (typeof value === \"number\") {\n      result[key] = Math.max(typeof existing === \"number\" ? existing : 0, value);\n    }\n  }\n  return result as BlockCodeKnownFeatureFlags;\n}\n\n/**\n * Plugin record: model + param derivation lambdas.\n * Type parameters are carried by PluginModel generic.\n */\nexport type PluginRecord<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n> = {\n  readonly model: PluginModel<Data, Params, Outputs>;\n  readonly inputs: ParamsInputErased;\n};\n\ninterface BlockModelV3Config<\n  OutputsCfg extends Record<string, ConfigRenderLambda>,\n  Data,\n  Plugins extends Record<string, PluginRecord> = {},\n  Transfers extends Record<string, unknown> = {},\n> {\n  renderingMode: BlockRenderingMode;\n  dataModel: DataModel<Data, Transfers>;\n  outputs: OutputsCfg;\n  sections: ConfigRenderLambda;\n  title: ConfigRenderLambda | undefined;\n  subtitle: ConfigRenderLambda | undefined;\n  tags: ConfigRenderLambda | undefined;\n  enrichmentTargets: ConfigRenderLambda | undefined;\n  featureFlags: BlockCodeKnownFeatureFlags;\n  argsFunction: ((data: unknown) => unknown) | undefined;\n  prerunArgsFunction: ((data: unknown) => unknown) | undefined;\n  plugins: Plugins;\n}\n\n/** Main entry point that each block should use in it's \"config\" module. Don't forget\n * to call {@link done()} at the end of configuration. Value returned by this builder must be\n * exported as constant with name \"platforma\" from the \"config\" module.\n * API version is 3 (for UI) and 2 (for model) */\nexport class BlockModelV3<\n  Args,\n  OutputsCfg extends Record<string, ConfigRenderLambda>,\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Href extends `/${string}` = \"/\",\n  Plugins extends Record<string, PluginRecord> = {},\n  Transfers extends Record<string, unknown> = {},\n> {\n  private constructor(\n    private readonly config: BlockModelV3Config<OutputsCfg, Data, Plugins, Transfers>,\n  ) {}\n\n  public static readonly INITIAL_BLOCK_FEATURE_FLAGS: BlockCodeKnownFeatureFlags = {\n    supportsLazyState: true,\n    supportsPframeQueryRanking: true,\n    requiresUIAPIVersion: 3,\n    requiresModelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n    requiresCreatePTable: 2,\n  };\n\n  /**\n   * Creates a new BlockModelV3 builder with the specified data model.\n   *\n   * @example\n   * const dataModel = new DataModelBuilder()\n   *   .from<BlockData>(\"v1\")\n   *   .init(() => ({ numbers: [], labels: [] }));\n   *\n   * BlockModelV3.create(dataModel)\n   *   .args((data) => ({ numbers: data.numbers }))\n   *   .sections(() => [{ type: 'link', href: '/', label: 'Main' }])\n   *   .done();\n   *\n   * @param dataModel The data model that defines initial data and migrations\n   */\n  public static create<\n    Data extends Record<string, unknown>,\n    Transfers extends Record<string, unknown> = {},\n  >(dataModel: DataModel<Data, Transfers>): BlockModelV3<NoOb, {}, Data, \"/\", {}, Transfers> {\n    return new BlockModelV3<NoOb, {}, Data, \"/\", {}, Transfers>({\n      renderingMode: \"Heavy\",\n      dataModel,\n      outputs: {},\n      sections: createAndRegisterRenderLambda({ handle: \"sections\", lambda: () => [] }, true),\n      title: undefined,\n      subtitle: undefined,\n      tags: undefined,\n      enrichmentTargets: undefined,\n      featureFlags: { ...BlockModelV3.INITIAL_BLOCK_FEATURE_FLAGS },\n      argsFunction: undefined,\n      prerunArgsFunction: undefined,\n      plugins: {},\n    });\n  }\n\n  /**\n   * Add output cell wrapped with additional status information to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunction<Args, Data, unknown>>(\n    key: Key,\n    rf: RF,\n    flags: ConfigRenderLambdaFlags & { withStatus: true },\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> & {\n        withStatus: true;\n      };\n    },\n    Data,\n    Href,\n    Plugins,\n    Transfers\n  >;\n  /**\n   * Add output cell to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunction<Args, Data, unknown>>(\n    key: Key,\n    rf: RF,\n    flags?: ConfigRenderLambdaFlags,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>>;\n    },\n    Data,\n    Href,\n    Plugins,\n    Transfers\n  >;\n  public output(\n    key: string,\n    cfgOrRf: RenderFunction<Args, Data, unknown>,\n    flags: ConfigRenderLambdaFlags = {},\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3({\n      ...this.config,\n      outputs: {\n        ...this.config.outputs,\n        [key]: createAndRegisterRenderLambda({\n          handle: `block-output#${key}`,\n          lambda: () => cfgOrRf(new BlockRenderCtx<Args, Data>()),\n          ...flags,\n        }),\n      },\n    });\n  }\n\n  /** Shortcut for {@link output} with retentive flag set to true. */\n  public retentiveOutput<\n    const Key extends string,\n    const RF extends RenderFunction<Args, Data, unknown>,\n  >(\n    key: Key,\n    rf: RF,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>>;\n    },\n    Data,\n    Href,\n    Plugins,\n    Transfers\n  > {\n    return this.output(key, rf, { retentive: true });\n  }\n\n  /** Shortcut for {@link output} with withStatus flag set to true. */\n  public outputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunction<Args, Data, unknown>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { withStatus: true });\n  }\n\n  /**\n   * Sets a function to derive block args from data.\n   * This is called during setData to compute the args that will be used for block execution.\n   *\n   * @example\n   * .args<BlockArgs>((data) => ({ numbers: data.numbers }))\n   *\n   * @example\n   * .args<BlockArgs>((data) => {\n   *   if (data.numbers.length === 0) throw new Error('Numbers required'); // block not ready\n   *   return { numbers: data.numbers };\n   * })\n   */\n  public args<A>(\n    lambda: (data: Data) => A,\n  ): BlockModelV3<A, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<A, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      argsFunction: lambda as (data: unknown) => unknown,\n    });\n  }\n\n  /**\n   * Sets a function to derive pre-run args from data (optional).\n   * This is called during setData to compute the args that will be used for staging/pre-run phase.\n   *\n   * If not defined, defaults to using the args() function result.\n   * If defined, uses its return value for the staging / prerun phase.\n   *\n   * The staging / prerun phase runs only if currentPrerunArgs differs from the executed\n   * version of prerunArgs (same comparison logic as currentArgs vs prodArgs).\n   *\n   * @example\n   * .prerunArgs((data) => ({ numbers: data.numbers }))\n   *\n   * @example\n   * .prerunArgs((data) => {\n   *   // Return undefined to skip staging for this block\n   *   if (!data.isReady) return undefined;\n   *   return { numbers: data.numbers };\n   * })\n   */\n  public prerunArgs(\n    fn: (data: Data) => unknown,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      prerunArgsFunction: fn as (data: unknown) => unknown,\n    });\n  }\n\n  /** Sets the lambda to generate list of sections in the left block overviews panel. */\n  public sections<\n    const Ret extends SectionsExpectedType,\n    const RF extends RenderFunction<Args, Data, Ret>,\n  >(rf: RF): BlockModelV3<Args, OutputsCfg, Data, DeriveHref<ReturnType<RF>>, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, DeriveHref<ReturnType<RF>>, Plugins, Transfers>(\n      {\n        ...this.config,\n        // Replace the default sections callback with the user-provided one\n        sections: createAndRegisterRenderLambda(\n          { handle: \"sections\", lambda: () => rf(new BlockRenderCtx<Args, Data>()) },\n          true,\n        ),\n      },\n    );\n  }\n\n  /** Sets a rendering function to derive block title, shown for the block in the left blocks-overview panel. */\n  public title(\n    rf: RenderFunction<Args, Data, string>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      title: createAndRegisterRenderLambda({\n        handle: \"title\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  public subtitle(\n    rf: RenderFunction<Args, Data, string>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      subtitle: createAndRegisterRenderLambda({\n        handle: \"subtitle\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  public tags(\n    rf: RenderFunction<Args, Data, string[]>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      tags: createAndRegisterRenderLambda({\n        handle: \"tags\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  /** Sets or overrides feature flags for the block. */\n  public withFeatureFlags(\n    flags: Partial<BlockCodeKnownFeatureFlags>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      featureFlags: { ...this.config.featureFlags, ...flags },\n    });\n  }\n\n  /**\n   * Defines how to derive list of upstream references this block is meant to enrich with its exports from block args.\n   * Influences dependency graph construction.\n   */\n  public enriches(\n    lambda: (args: Args) => PlRef[],\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      enrichmentTargets: createAndRegisterRenderLambda({\n        handle: \"enrichmentTargets\",\n        lambda: lambda,\n      }),\n    });\n  }\n\n  /**\n   * Registers a plugin instance with the block.\n   * Consumes a transfer if one was defined for this plugin ID in the migration chain.\n   *\n   * Type checks:\n   * - If Transfers[Id] exists, verifies it extends PTransferData (transfer type compatibility)\n   * - If no Transfers[Id], rejects plugins with transferAt set (missing .transfer() in data model)\n   * - Rejects duplicate plugin IDs (Id already in keyof Plugins)\n   *\n   * @param instance - PluginInstance created via factory.create({ pluginId, ... })\n   * @param params - Per-property lambdas deriving plugin params from block RenderCtx\n   *\n   * @example\n   * .plugin(mainTable, {\n   *   columns: (ctx) => ctx.outputs?.resolve(\"data\")?.getPColumns(),\n   *   sourceId: (ctx) => ctx.data.selectedSource,\n   * })\n   */\n  public plugin<\n    const PluginId extends string,\n    PData extends PluginData,\n    PParams extends PluginParams,\n    POutputs extends PluginOutputs,\n    PTransferData,\n  >(\n    instance: PluginInstanceClass<\n      PluginId &\n        (PluginId extends keyof Transfers\n          ? Transfers[PluginId] extends PTransferData\n            ? string\n            : never\n          : [PTransferData] extends [never]\n            ? string\n            : never) &\n        (PluginId extends keyof Plugins ? never : string),\n      PData,\n      PParams,\n      POutputs,\n      PTransferData\n    >,\n    params?: ParamsInput<PParams, Args, Data>,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg,\n    Data,\n    Href,\n    Plugins & { [K in PluginId]: PluginRecord<PData, PParams, POutputs> },\n    Omit<Transfers, PluginId>\n  >;\n  public plugin(\n    instance: PluginInstanceClass,\n    params?: ParamsInput<Record<string, unknown>, unknown, unknown>,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg,\n    Data,\n    Href,\n    Record<string, PluginRecord>,\n    Record<string, unknown>\n  > {\n    const pluginId = instance.id;\n    const plugin = instance[CREATE_PLUGIN_MODEL]();\n    const resolvedParams = (params ?? {}) as ParamsInputErased;\n\n    if (pluginId in this.config.plugins) {\n      throw new Error(`Plugin '${pluginId}' already registered`);\n    }\n\n    const registered: PluginRecord = {\n      model: plugin,\n      inputs: resolvedParams,\n    };\n\n    return new BlockModelV3({\n      ...this.config,\n      plugins: {\n        ...this.config.plugins,\n        [pluginId]: registered,\n      },\n      featureFlags: mergeFeatureFlags(this.config.featureFlags, plugin.featureFlags ?? {}),\n    });\n  }\n\n  /** Renders all provided block settings into a pre-configured platforma API\n   * instance, that can be used in frontend to interact with block data, and\n   * other features provided by the platforma to the block.\n   *\n   * Type-level check: if there are unconsumed transfers (from `.transfer()` calls\n   * in the migration chain), this method requires an impossible `never` argument,\n   * producing a compile error. Register all transferred plugins via `.plugin(instance)`\n   * before calling `.done()`.\n   */\n  public done(\n    ..._: keyof Transfers extends never ? [] : [never]\n  ): PlatformaExtended<\n    PlatformaV3<Data, Args, InferOutputsFromLambdas<OutputsCfg>, Href, Plugins>\n  > {\n    if (this.config.argsFunction === undefined) throw new Error(\"Args rendering function not set.\");\n\n    const apiVersion = 3;\n\n    // Build plugin registry\n    const { plugins } = this.config;\n    const pluginRegistry: Record<string, PluginName> = {};\n    const pluginHandles = Object.keys(plugins) as PluginHandle[];\n    for (const handle of pluginHandles) {\n      pluginRegistry[handle] = plugins[handle].model.name;\n    }\n\n    const { dataModel, argsFunction, prerunArgsFunction } = this.config;\n\n    function getPlugin(handle: PluginHandle): PluginRecord {\n      const plugin = plugins[handle];\n      if (!plugin) throw new Error(`Plugin model not found for '${handle}'`);\n      return plugin;\n    }\n\n    // Register ALL facade callbacks here, with dependencies captured via closures\n    registerFacadeCallbacks({\n      [BlockStorageFacadeCallbacks.StorageApplyUpdate]: applyStorageUpdate,\n      [BlockStorageFacadeCallbacks.StorageDebugView]: getStorageDebugView,\n      [BlockStorageFacadeCallbacks.StorageMigrate]: (currentStorageJson) =>\n        migrateStorage(currentStorageJson, {\n          migrateBlockData: (v) => dataModel.migrate(v),\n          getPluginRegistry: () => pluginRegistry,\n          migratePluginData: (handle, v) => getPlugin(handle).model.dataModel.migrate(v),\n          createPluginData: (handle, transfer) => {\n            if (transfer) return transfer;\n            return getPlugin(handle).model.getDefaultData();\n          },\n        }),\n      [BlockStorageFacadeCallbacks.StorageInitial]: () =>\n        createInitialStorage({\n          getDefaultBlockData: () => dataModel.getDefaultData(),\n          getPluginRegistry: () => pluginRegistry,\n          createPluginData: (handle) => getPlugin(handle).model.getDefaultData(),\n        }),\n      [BlockStorageFacadeCallbacks.ArgsDerive]: (storageJson) =>\n        deriveArgsFromStorage(storageJson, argsFunction),\n      [BlockStorageFacadeCallbacks.PrerunArgsDerive]: (storageJson) =>\n        derivePrerunArgsFromStorage(storageJson, argsFunction, prerunArgsFunction),\n    });\n\n    // Register plugin input and output lambdas\n    const pluginOutputs: Record<string, ConfigRenderLambda> = {};\n    for (const handle of pluginHandles) {\n      const { model, inputs } = plugins[handle];\n      // Wrap plugin param lambdas: close over BlockRenderCtx creation\n      const wrappedInputs: Record<string, () => unknown> = {};\n      for (const [paramKey, paramFn] of Object.entries(inputs)) {\n        wrappedInputs[paramKey] = () => paramFn(new BlockRenderCtx());\n      }\n\n      // Register plugin outputs (in config pack, evaluated by middle layer)\n      const outputs = model.outputs as Record<string, (ctx: PluginRenderCtx) => unknown>;\n      for (const [outputKey, outputFn] of Object.entries(outputs)) {\n        const key = pluginOutputKey(handle, outputKey);\n        pluginOutputs[key] = createAndRegisterRenderLambda({\n          handle: key,\n          lambda: () => outputFn(new PluginRenderCtx(handle, wrappedInputs)),\n        });\n      }\n    }\n    const allOutputs = { ...this.config.outputs, ...pluginOutputs };\n\n    globalThis.platformaApiVersion = apiVersion;\n\n    if (!isInUI()) {\n      const blockConfig: BlockConfigContainer = {\n        v4: {\n          configVersion: 4,\n          modelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n          sdkVersion: PlatformaSDKVersion,\n          renderingMode: this.config.renderingMode,\n          sections: this.config.sections,\n          title: this.config.title,\n          subtitle: this.config.subtitle,\n          tags: this.config.tags,\n          outputs: allOutputs,\n          enrichmentTargets: this.config.enrichmentTargets,\n          featureFlags: this.config.featureFlags,\n          blockLifecycleCallbacks: { ...BlockStorageFacadeHandles },\n        },\n\n        // fields below are added to allow previous desktop versions read generated configs\n        sdkVersion: PlatformaSDKVersion,\n        renderingMode: this.config.renderingMode,\n        sections: this.config.sections,\n        outputs: Object.fromEntries(\n          Object.entries(this.config.outputs).map(([key, value]) => [\n            key,\n            downgradeCfgOrLambda(value),\n          ]),\n        ),\n      };\n      // we are in the configuration rendering routine, not in actual UI\n      return { config: blockConfig } as any;\n      // normal operation inside the UI\n    } else {\n      return {\n        ...getPlatformaInstance({\n          sdkVersion: PlatformaSDKVersion,\n          apiVersion,\n        }),\n        blockModelInfo: {\n          outputs: Object.fromEntries(\n            Object.entries(allOutputs).map(([key, value]) => [\n              key,\n              {\n                withStatus: Boolean(isConfigLambda(value) && value.withStatus),\n              },\n            ]),\n          ),\n          pluginIds: pluginHandles,\n          featureFlags: this.config.featureFlags,\n        },\n      } as any;\n    }\n  }\n}\n\n// Type tests for BlockModelV3\n\nexport type Expect<T extends true> = T;\n\nexport type Equal<X, Y> =\n  (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;\n\nexport type Merge<A, B> = {\n  [K in keyof A | keyof B]: K extends keyof B ? B[K] : K extends keyof A ? A[K] : never;\n};\n\n// Helper types for testing\ntype _TestArgs = { inputFile: string; threshold: number };\ntype _TestData = { selectedTab: string };\ntype _TestOutputs = {\n  result: ConfigRenderLambda<string>;\n  count: ConfigRenderLambda<number>;\n};\n\n// Test: Merge type works correctly\ntype _MergeTest1 = Expect<Equal<Merge<{ a: 1 }, { b: 2 }>, { a: 1; b: 2 }>>;\ntype _MergeTest2 = Expect<Equal<Merge<{ a: 1 }, { a: 2 }>, { a: 2 }>>;\ntype _MergeTest3 = Expect<Equal<Merge<{ a: 1; b: 1 }, { b: 2; c: 3 }>, { a: 1; b: 2; c: 3 }>>;\n\n// Test: create() returns a BlockModelV3 instance\n// Note: Due to function overloads, ReturnType uses the last overload signature.\n// We verify the structure is correct using a simpler assignability test.\ntype _CreateResult = ReturnType<typeof BlockModelV3.create>;\ntype _CreateIsBlockModelV3 =\n  _CreateResult extends BlockModelV3<infer _A, infer _O, infer _S> ? true : false;\ntype _CreateTest = Expect<_CreateIsBlockModelV3>;\n\n// Test: BlockModelV3Config interface structure (default generics)\ntype _ConfigTest = Expect<\n  Equal<\n    BlockModelV3Config<_TestOutputs, _TestData>,\n    {\n      renderingMode: BlockRenderingMode;\n      argsFunction: ((data: unknown) => unknown) | undefined;\n      prerunArgsFunction: ((data: unknown) => unknown) | undefined;\n      dataModel: DataModel<_TestData, {}>;\n      outputs: _TestOutputs;\n      sections: ConfigRenderLambda;\n      title: ConfigRenderLambda | undefined;\n      subtitle: ConfigRenderLambda | undefined;\n      tags: ConfigRenderLambda | undefined;\n      enrichmentTargets: ConfigRenderLambda | undefined;\n      featureFlags: BlockCodeKnownFeatureFlags;\n      plugins: {};\n    }\n  >\n>;\n\n// Test: Default Href is '/'\ntype _HrefDefaultTest =\n  BlockModelV3<_TestArgs, {}, _TestData> extends BlockModelV3<_TestArgs, {}, _TestData, \"/\">\n    ? true\n    : false;\ntype _VerifyHrefDefault = Expect<_HrefDefaultTest>;\n\n// Test: Custom Href can be specified\ntype _CustomHref = \"/settings\" | \"/main\";\ntype _HrefCustomBuilder = BlockModelV3<_TestArgs, {}, _TestData, _CustomHref>;\ntype _HrefCustomTest =\n  _HrefCustomBuilder extends BlockModelV3<_TestArgs, {}, _TestData, _CustomHref> ? true : false;\ntype _VerifyHrefCustom = Expect<_HrefCustomTest>;\n\n// Test: Output type accumulation with & intersection\ntype _OutputsAccumulation = { a: ConfigRenderLambda<string> } & {\n  b: ConfigRenderLambda<number>;\n};\ntype _VerifyOutputsHaveKeys = Expect<Equal<keyof _OutputsAccumulation, \"a\" | \"b\">>;\n\n// Test: Builder with all type parameters specified compiles\ntype _FullBuilder = BlockModelV3<_TestArgs, _TestOutputs, _TestData, \"/main\">;\ntype _FullBuilderTest =\n  _FullBuilder extends BlockModelV3<_TestArgs, _TestOutputs, _TestData, \"/main\"> ? true : false;\ntype _VerifyFullBuilder = Expect<_FullBuilderTest>;\n\n// Test: InferOutputsFromLambdas maps outputs correctly\ntype _InferOutputsTest = InferOutputsFromLambdas<{\n  myOutput: ConfigRenderLambda<number>;\n}>;\ntype _VerifyInferOutputs = Expect<\n  Equal<_InferOutputsTest, { myOutput: OutputWithStatus<number> & { __unwrap: true } }>\n>;\n"],"mappings":"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"}
+{"version":3,"file":"block_model.cjs","names":["BLOCK_STORAGE_FACADE_VERSION","createAndRegisterRenderLambda","BlockRenderCtx","CREATE_PLUGIN_MODEL","BlockStorageFacadeCallbacks","applyStorageUpdate","getStorageDebugView","migrateStorage","createInitialStorage","deriveArgsFromStorage","derivePrerunArgsFromStorage","pluginOutputKey","PluginRenderCtx","isInUI","PlatformaSDKVersion","BlockStorageFacadeHandles","downgradeCfgOrLambda","getPlatformaInstance","isConfigLambda"],"sources":["../src/block_model.ts"],"sourcesContent":["import type {\n  BlockRenderingMode,\n  BlockSection,\n  OutputWithStatus,\n  PlRef,\n  BlockCodeKnownFeatureFlags,\n  BlockConfigContainer,\n} from \"@milaboratories/pl-model-common\";\nimport { getPlatformaInstance, isInUI, createAndRegisterRenderLambda } from \"./internal\";\nimport type { DataModel } from \"./block_migrations\";\nimport type { PlatformaV3 } from \"./platforma\";\nimport type { InferRenderFunctionReturn, RenderFunction } from \"./render\";\nimport { BlockRenderCtx, PluginRenderCtx } from \"./render\";\nimport type { PluginData, PluginModel, PluginOutputs, PluginParams } from \"./plugin_model\";\nimport { PluginInstance as PluginInstanceClass, CREATE_PLUGIN_MODEL } from \"./plugin_model\";\nimport { type PluginHandle, pluginOutputKey } from \"./plugin_handle\";\nimport type { RenderCtxBase } from \"./render\";\nimport { PlatformaSDKVersion } from \"./version\";\nimport {\n  applyStorageUpdate,\n  getStorageDebugView,\n  migrateStorage,\n  createInitialStorage,\n  deriveArgsFromStorage,\n  derivePrerunArgsFromStorage,\n} from \"./block_storage_callbacks\";\nimport { type PluginName } from \"./block_storage\";\nimport type {\n  ConfigRenderLambda,\n  DeriveHref,\n  ConfigRenderLambdaFlags,\n  InferOutputsFromLambdas,\n} from \"./bconfig\";\nimport { downgradeCfgOrLambda, isConfigLambda } from \"./bconfig\";\nimport type { PlatformaExtended } from \"./platforma\";\nimport {\n  BLOCK_STORAGE_FACADE_VERSION,\n  BlockStorageFacadeCallbacks,\n  BlockStorageFacadeHandles,\n  registerFacadeCallbacks,\n} from \"./block_storage_facade\";\n\ntype SectionsExpectedType = readonly BlockSection[];\n\ntype NoOb = Record<string, never>;\n\n/**\n * Per-property lambdas for deriving plugin params from block render context.\n * Each property is a function that receives the block's RenderCtxBase and returns the param value.\n */\nexport type ParamsInput<Params, BArgs = unknown, BData = unknown> = {\n  [K in keyof Params]: (ctx: RenderCtxBase<BArgs, BData>) => Params[K];\n};\n\n/**\n * Type-erased version of ParamsInput for internal storage.\n */\ntype ParamsInputErased = Record<string, (ctx: RenderCtxBase) => unknown>;\n\n/**\n * Merges two feature flag objects with type-aware logic:\n * - `supports*` (boolean): OR — `true` if either side is `true`\n * - `requires*` (numeric): MAX — take the higher version requirement\n */\nfunction mergeFeatureFlags(\n  base: BlockCodeKnownFeatureFlags,\n  override: BlockCodeKnownFeatureFlags,\n): BlockCodeKnownFeatureFlags {\n  const result: Record<string, boolean | number | undefined> = { ...base };\n  for (const [key, value] of Object.entries(override)) {\n    if (value === undefined) continue;\n    const existing = result[key];\n    if (typeof value === \"boolean\") {\n      result[key] = (typeof existing === \"boolean\" && existing) || value;\n    } else if (typeof value === \"number\") {\n      result[key] = Math.max(typeof existing === \"number\" ? existing : 0, value);\n    }\n  }\n  return result as BlockCodeKnownFeatureFlags;\n}\n\n/**\n * Plugin record: model + param derivation lambdas.\n * Type parameters are carried by PluginModel generic.\n */\nexport type PluginRecord<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n> = {\n  readonly model: PluginModel<Data, Params, Outputs>;\n  readonly inputs: ParamsInputErased;\n};\n\ninterface BlockModelV3Config<\n  OutputsCfg extends Record<string, ConfigRenderLambda>,\n  Data,\n  Plugins extends Record<string, PluginRecord> = {},\n  Transfers extends Record<string, unknown> = {},\n> {\n  renderingMode: BlockRenderingMode;\n  dataModel: DataModel<Data, Transfers>;\n  outputs: OutputsCfg;\n  sections: ConfigRenderLambda;\n  title: ConfigRenderLambda | undefined;\n  subtitle: ConfigRenderLambda | undefined;\n  tags: ConfigRenderLambda | undefined;\n  enrichmentTargets: ConfigRenderLambda | undefined;\n  featureFlags: BlockCodeKnownFeatureFlags;\n  argsFunction: ((data: unknown) => unknown) | undefined;\n  prerunArgsFunction: ((data: unknown) => unknown) | undefined;\n  plugins: Plugins;\n}\n\n/** Main entry point that each block should use in it's \"config\" module. Don't forget\n * to call {@link done()} at the end of configuration. Value returned by this builder must be\n * exported as constant with name \"platforma\" from the \"config\" module.\n * API version is 3 (for UI) and 2 (for model) */\nexport class BlockModelV3<\n  Args,\n  OutputsCfg extends Record<string, ConfigRenderLambda>,\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Href extends `/${string}` = \"/\",\n  Plugins extends Record<string, PluginRecord> = {},\n  Transfers extends Record<string, unknown> = {},\n> {\n  private constructor(\n    private readonly config: BlockModelV3Config<OutputsCfg, Data, Plugins, Transfers>,\n  ) {}\n\n  public static readonly INITIAL_BLOCK_FEATURE_FLAGS: BlockCodeKnownFeatureFlags = {\n    supportsLazyState: true,\n    supportsPframeQueryRanking: true,\n    requiresUIAPIVersion: 3,\n    requiresModelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n    requiresCreatePTable: 2,\n  };\n\n  /**\n   * Creates a new BlockModelV3 builder with the specified data model.\n   *\n   * @example\n   * const dataModel = new DataModelBuilder()\n   *   .from<BlockData>(\"v1\")\n   *   .init(() => ({ numbers: [], labels: [] }));\n   *\n   * BlockModelV3.create(dataModel)\n   *   .args((data) => ({ numbers: data.numbers }))\n   *   .sections(() => [{ type: 'link', href: '/', label: 'Main' }])\n   *   .done();\n   *\n   * @param dataModel The data model that defines initial data and migrations\n   */\n  public static create<\n    Data extends Record<string, unknown>,\n    Transfers extends Record<string, unknown> = {},\n  >(dataModel: DataModel<Data, Transfers>): BlockModelV3<NoOb, {}, Data, \"/\", {}, Transfers> {\n    return new BlockModelV3<NoOb, {}, Data, \"/\", {}, Transfers>({\n      renderingMode: \"Heavy\",\n      dataModel,\n      outputs: {},\n      sections: createAndRegisterRenderLambda({ handle: \"sections\", lambda: () => [] }, true),\n      title: undefined,\n      subtitle: undefined,\n      tags: undefined,\n      enrichmentTargets: undefined,\n      featureFlags: { ...BlockModelV3.INITIAL_BLOCK_FEATURE_FLAGS },\n      argsFunction: undefined,\n      prerunArgsFunction: undefined,\n      plugins: {},\n    });\n  }\n\n  /**\n   * Add output cell wrapped with additional status information to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunction<Args, Data, unknown>>(\n    key: Key,\n    rf: RF,\n    flags: ConfigRenderLambdaFlags & { withStatus: true },\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> & {\n        withStatus: true;\n      };\n    },\n    Data,\n    Href,\n    Plugins,\n    Transfers\n  >;\n  /**\n   * Add output cell to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunction<Args, Data, unknown>>(\n    key: Key,\n    rf: RF,\n    flags?: ConfigRenderLambdaFlags,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>>;\n    },\n    Data,\n    Href,\n    Plugins,\n    Transfers\n  >;\n  public output(\n    key: string,\n    cfgOrRf: RenderFunction<Args, Data, unknown>,\n    flags: ConfigRenderLambdaFlags = {},\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3({\n      ...this.config,\n      outputs: {\n        ...this.config.outputs,\n        [key]: createAndRegisterRenderLambda({\n          handle: `block-output#${key}`,\n          lambda: () => cfgOrRf(new BlockRenderCtx<Args, Data>()),\n          ...flags,\n        }),\n      },\n    });\n  }\n\n  /** Shortcut for {@link output} with retentive flag set to true. */\n  public retentiveOutput<\n    const Key extends string,\n    const RF extends RenderFunction<Args, Data, unknown>,\n  >(\n    key: Key,\n    rf: RF,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>>;\n    },\n    Data,\n    Href,\n    Plugins,\n    Transfers\n  > {\n    return this.output(key, rf, { retentive: true });\n  }\n\n  /** Shortcut for {@link output} with withStatus flag set to true. */\n  public outputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunction<Args, Data, unknown>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { withStatus: true });\n  }\n\n  /**\n   * Sets a function to derive block args from data.\n   * This is called during setData to compute the args that will be used for block execution.\n   *\n   * @example\n   * .args<BlockArgs>((data) => ({ numbers: data.numbers }))\n   *\n   * @example\n   * .args<BlockArgs>((data) => {\n   *   if (data.numbers.length === 0) throw new Error('Numbers required'); // block not ready\n   *   return { numbers: data.numbers };\n   * })\n   */\n  public args<A>(\n    lambda: (data: Data) => A,\n  ): BlockModelV3<A, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<A, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      argsFunction: lambda as (data: unknown) => unknown,\n    });\n  }\n\n  /**\n   * Sets a function to derive pre-run args from data (optional).\n   * This is called during setData to compute the args that will be used for staging/pre-run phase.\n   *\n   * If not defined, defaults to using the args() function result.\n   * If defined, uses its return value for the staging / prerun phase.\n   *\n   * The staging / prerun phase runs only if currentPrerunArgs differs from the executed\n   * version of prerunArgs (same comparison logic as currentArgs vs prodArgs).\n   *\n   * @example\n   * .prerunArgs((data) => ({ numbers: data.numbers }))\n   *\n   * @example\n   * .prerunArgs((data) => {\n   *   // Return undefined to skip staging for this block\n   *   if (!data.isReady) return undefined;\n   *   return { numbers: data.numbers };\n   * })\n   */\n  public prerunArgs(\n    fn: (data: Data) => unknown,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      prerunArgsFunction: fn as (data: unknown) => unknown,\n    });\n  }\n\n  /** Sets the lambda to generate list of sections in the left block overviews panel. */\n  public sections<\n    const Ret extends SectionsExpectedType,\n    const RF extends RenderFunction<Args, Data, Ret>,\n  >(rf: RF): BlockModelV3<Args, OutputsCfg, Data, DeriveHref<ReturnType<RF>>, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, DeriveHref<ReturnType<RF>>, Plugins, Transfers>(\n      {\n        ...this.config,\n        // Replace the default sections callback with the user-provided one\n        sections: createAndRegisterRenderLambda(\n          { handle: \"sections\", lambda: () => rf(new BlockRenderCtx<Args, Data>()) },\n          true,\n        ),\n      },\n    );\n  }\n\n  /** Sets a rendering function to derive block title, shown for the block in the left blocks-overview panel. */\n  public title(\n    rf: RenderFunction<Args, Data, string>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      title: createAndRegisterRenderLambda({\n        handle: \"title\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  public subtitle(\n    rf: RenderFunction<Args, Data, string>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      subtitle: createAndRegisterRenderLambda({\n        handle: \"subtitle\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  public tags(\n    rf: RenderFunction<Args, Data, string[]>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      tags: createAndRegisterRenderLambda({\n        handle: \"tags\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  /** Sets or overrides feature flags for the block. */\n  public withFeatureFlags(\n    flags: Partial<BlockCodeKnownFeatureFlags>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      featureFlags: { ...this.config.featureFlags, ...flags },\n    });\n  }\n\n  /**\n   * Defines how to derive list of upstream references this block is meant to enrich with its exports from block args.\n   * Influences dependency graph construction.\n   */\n  public enriches(\n    lambda: (args: Args) => PlRef[],\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      enrichmentTargets: createAndRegisterRenderLambda({\n        handle: \"enrichmentTargets\",\n        lambda: lambda,\n      }),\n    });\n  }\n\n  /**\n   * Registers a plugin instance with the block.\n   * Consumes a transfer if one was defined for this plugin ID in the migration chain.\n   *\n   * Type checks:\n   * - If Transfers[Id] exists, verifies it extends PTransferData (transfer type compatibility)\n   * - If no Transfers[Id], rejects plugins with transferAt set (missing .transfer() in data model)\n   * - Rejects duplicate plugin IDs (Id already in keyof Plugins)\n   *\n   * @param instance - PluginInstance created via factory.create({ pluginId, ... })\n   * @param params - Per-property lambdas deriving plugin params from block RenderCtx\n   *\n   * @example\n   * .plugin(mainTable, {\n   *   columns: (ctx) => ctx.outputs?.resolve(\"data\")?.getPColumns(),\n   *   sourceId: (ctx) => ctx.data.selectedSource,\n   * })\n   */\n  public plugin<\n    const PluginId extends string,\n    PData extends PluginData,\n    PParams extends PluginParams,\n    POutputs extends PluginOutputs,\n    PTransferData,\n  >(\n    instance: PluginInstanceClass<\n      PluginId &\n        (PluginId extends keyof Transfers\n          ? Transfers[PluginId] extends PTransferData\n            ? string\n            : never\n          : [PTransferData] extends [never]\n            ? string\n            : never) &\n        (PluginId extends keyof Plugins ? never : string),\n      PData,\n      PParams,\n      POutputs,\n      PTransferData\n    >,\n    params?: ParamsInput<PParams, Args, Data>,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg,\n    Data,\n    Href,\n    Plugins & { [K in PluginId]: PluginRecord<PData, PParams, POutputs> },\n    Omit<Transfers, PluginId>\n  >;\n  public plugin(\n    instance: PluginInstanceClass,\n    params?: ParamsInput<Record<string, unknown>, unknown, unknown>,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg,\n    Data,\n    Href,\n    Record<string, PluginRecord>,\n    Record<string, unknown>\n  > {\n    const pluginId = instance.id;\n    const plugin = instance[CREATE_PLUGIN_MODEL]();\n    const resolvedParams = (params ?? {}) as ParamsInputErased;\n\n    if (pluginId in this.config.plugins) {\n      throw new Error(`Plugin '${pluginId}' already registered`);\n    }\n\n    const registered: PluginRecord = {\n      model: plugin,\n      inputs: resolvedParams,\n    };\n\n    return new BlockModelV3({\n      ...this.config,\n      plugins: {\n        ...this.config.plugins,\n        [pluginId]: registered,\n      },\n      featureFlags: mergeFeatureFlags(this.config.featureFlags, plugin.featureFlags ?? {}),\n    });\n  }\n\n  /** Renders all provided block settings into a pre-configured platforma API\n   * instance, that can be used in frontend to interact with block data, and\n   * other features provided by the platforma to the block.\n   *\n   * Type-level check: if there are unconsumed transfers (from `.transfer()` calls\n   * in the migration chain), this method requires an impossible `never` argument,\n   * producing a compile error. Register all transferred plugins via `.plugin(instance)`\n   * before calling `.done()`.\n   */\n  public done(\n    ..._: keyof Transfers extends never ? [] : [never]\n  ): PlatformaExtended<\n    PlatformaV3<Data, Args, InferOutputsFromLambdas<OutputsCfg>, Href, Plugins>\n  > {\n    if (this.config.argsFunction === undefined) throw new Error(\"Args rendering function not set.\");\n\n    const apiVersion = 3;\n\n    // Build plugin registry\n    const { plugins } = this.config;\n    const pluginRegistry: Record<string, PluginName> = {};\n    const pluginHandles = Object.keys(plugins) as PluginHandle[];\n    for (const handle of pluginHandles) {\n      pluginRegistry[handle] = plugins[handle].model.name;\n    }\n\n    const { dataModel, argsFunction, prerunArgsFunction } = this.config;\n\n    function getPlugin(handle: PluginHandle): PluginRecord {\n      const plugin = plugins[handle];\n      if (!plugin) throw new Error(`Plugin model not found for '${handle}'`);\n      return plugin;\n    }\n\n    // Register ALL facade callbacks here, with dependencies captured via closures\n    registerFacadeCallbacks({\n      [BlockStorageFacadeCallbacks.StorageApplyUpdate]: applyStorageUpdate,\n      [BlockStorageFacadeCallbacks.StorageDebugView]: getStorageDebugView,\n      [BlockStorageFacadeCallbacks.StorageMigrate]: (currentStorageJson) =>\n        migrateStorage(currentStorageJson, {\n          migrateBlockData: (v) => dataModel.migrate(v),\n          getPluginRegistry: () => pluginRegistry,\n          migratePluginData: (handle, v) => getPlugin(handle).model.dataModel.migrate(v),\n          createPluginData: (handle, transfer) => {\n            if (transfer) return transfer;\n            return getPlugin(handle).model.getDefaultData();\n          },\n        }),\n      [BlockStorageFacadeCallbacks.StorageInitial]: () =>\n        createInitialStorage({\n          getDefaultBlockData: () => dataModel.getDefaultData(),\n          getPluginRegistry: () => pluginRegistry,\n          createPluginData: (handle) => getPlugin(handle).model.getDefaultData(),\n        }),\n      [BlockStorageFacadeCallbacks.ArgsDerive]: (storageJson) =>\n        deriveArgsFromStorage(storageJson, argsFunction),\n      [BlockStorageFacadeCallbacks.PrerunArgsDerive]: (storageJson) =>\n        derivePrerunArgsFromStorage(storageJson, argsFunction, prerunArgsFunction),\n    });\n\n    // Register plugin input and output lambdas\n    const pluginOutputs: Record<string, ConfigRenderLambda> = {};\n    for (const handle of pluginHandles) {\n      const { model, inputs } = plugins[handle];\n      // Wrap plugin param lambdas: close over BlockRenderCtx creation\n      const wrappedInputs: Record<string, () => unknown> = {};\n      for (const [paramKey, paramFn] of Object.entries(inputs)) {\n        wrappedInputs[paramKey] = () => paramFn(new BlockRenderCtx());\n      }\n\n      // Register plugin outputs (in config pack, evaluated by middle layer)\n      const outputs = model.outputs as Record<string, (ctx: PluginRenderCtx) => unknown>;\n      const { outputFlags } = model;\n      for (const [outputKey, outputFn] of Object.entries(outputs)) {\n        const key = pluginOutputKey(handle, outputKey);\n        pluginOutputs[key] = createAndRegisterRenderLambda({\n          handle: key,\n          lambda: () => outputFn(new PluginRenderCtx(handle, wrappedInputs)),\n          withStatus: outputFlags[outputKey]?.withStatus,\n        });\n      }\n    }\n    const allOutputs = { ...this.config.outputs, ...pluginOutputs };\n\n    globalThis.platformaApiVersion = apiVersion;\n\n    if (!isInUI()) {\n      const blockConfig: BlockConfigContainer = {\n        v4: {\n          configVersion: 4,\n          modelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n          sdkVersion: PlatformaSDKVersion,\n          renderingMode: this.config.renderingMode,\n          sections: this.config.sections,\n          title: this.config.title,\n          subtitle: this.config.subtitle,\n          tags: this.config.tags,\n          outputs: allOutputs,\n          enrichmentTargets: this.config.enrichmentTargets,\n          featureFlags: this.config.featureFlags,\n          blockLifecycleCallbacks: { ...BlockStorageFacadeHandles },\n        },\n\n        // fields below are added to allow previous desktop versions read generated configs\n        sdkVersion: PlatformaSDKVersion,\n        renderingMode: this.config.renderingMode,\n        sections: this.config.sections,\n        outputs: Object.fromEntries(\n          Object.entries(this.config.outputs).map(([key, value]) => [\n            key,\n            downgradeCfgOrLambda(value),\n          ]),\n        ),\n      };\n      // we are in the configuration rendering routine, not in actual UI\n      return { config: blockConfig } as any;\n      // normal operation inside the UI\n    } else {\n      return {\n        ...getPlatformaInstance({\n          sdkVersion: PlatformaSDKVersion,\n          apiVersion,\n        }),\n        blockModelInfo: {\n          outputs: Object.fromEntries(\n            Object.entries(allOutputs).map(([key, value]) => [\n              key,\n              {\n                withStatus: Boolean(isConfigLambda(value) && value.withStatus),\n              },\n            ]),\n          ),\n          pluginIds: pluginHandles,\n          featureFlags: this.config.featureFlags,\n        },\n      } as any;\n    }\n  }\n}\n\n// Type tests for BlockModelV3\n\nexport type Expect<T extends true> = T;\n\nexport type Equal<X, Y> =\n  (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;\n\nexport type Merge<A, B> = {\n  [K in keyof A | keyof B]: K extends keyof B ? B[K] : K extends keyof A ? A[K] : never;\n};\n\n// Helper types for testing\ntype _TestArgs = { inputFile: string; threshold: number };\ntype _TestData = { selectedTab: string };\ntype _TestOutputs = {\n  result: ConfigRenderLambda<string>;\n  count: ConfigRenderLambda<number>;\n};\n\n// Test: Merge type works correctly\ntype _MergeTest1 = Expect<Equal<Merge<{ a: 1 }, { b: 2 }>, { a: 1; b: 2 }>>;\ntype _MergeTest2 = Expect<Equal<Merge<{ a: 1 }, { a: 2 }>, { a: 2 }>>;\ntype _MergeTest3 = Expect<Equal<Merge<{ a: 1; b: 1 }, { b: 2; c: 3 }>, { a: 1; b: 2; c: 3 }>>;\n\n// Test: create() returns a BlockModelV3 instance\n// Note: Due to function overloads, ReturnType uses the last overload signature.\n// We verify the structure is correct using a simpler assignability test.\ntype _CreateResult = ReturnType<typeof BlockModelV3.create>;\ntype _CreateIsBlockModelV3 =\n  _CreateResult extends BlockModelV3<infer _A, infer _O, infer _S> ? true : false;\ntype _CreateTest = Expect<_CreateIsBlockModelV3>;\n\n// Test: BlockModelV3Config interface structure (default generics)\ntype _ConfigTest = Expect<\n  Equal<\n    BlockModelV3Config<_TestOutputs, _TestData>,\n    {\n      renderingMode: BlockRenderingMode;\n      argsFunction: ((data: unknown) => unknown) | undefined;\n      prerunArgsFunction: ((data: unknown) => unknown) | undefined;\n      dataModel: DataModel<_TestData, {}>;\n      outputs: _TestOutputs;\n      sections: ConfigRenderLambda;\n      title: ConfigRenderLambda | undefined;\n      subtitle: ConfigRenderLambda | undefined;\n      tags: ConfigRenderLambda | undefined;\n      enrichmentTargets: ConfigRenderLambda | undefined;\n      featureFlags: BlockCodeKnownFeatureFlags;\n      plugins: {};\n    }\n  >\n>;\n\n// Test: Default Href is '/'\ntype _HrefDefaultTest =\n  BlockModelV3<_TestArgs, {}, _TestData> extends BlockModelV3<_TestArgs, {}, _TestData, \"/\">\n    ? true\n    : false;\ntype _VerifyHrefDefault = Expect<_HrefDefaultTest>;\n\n// Test: Custom Href can be specified\ntype _CustomHref = \"/settings\" | \"/main\";\ntype _HrefCustomBuilder = BlockModelV3<_TestArgs, {}, _TestData, _CustomHref>;\ntype _HrefCustomTest =\n  _HrefCustomBuilder extends BlockModelV3<_TestArgs, {}, _TestData, _CustomHref> ? true : false;\ntype _VerifyHrefCustom = Expect<_HrefCustomTest>;\n\n// Test: Output type accumulation with & intersection\ntype _OutputsAccumulation = { a: ConfigRenderLambda<string> } & {\n  b: ConfigRenderLambda<number>;\n};\ntype _VerifyOutputsHaveKeys = Expect<Equal<keyof _OutputsAccumulation, \"a\" | \"b\">>;\n\n// Test: Builder with all type parameters specified compiles\ntype _FullBuilder = BlockModelV3<_TestArgs, _TestOutputs, _TestData, \"/main\">;\ntype _FullBuilderTest =\n  _FullBuilder extends BlockModelV3<_TestArgs, _TestOutputs, _TestData, \"/main\"> ? true : false;\ntype _VerifyFullBuilder = Expect<_FullBuilderTest>;\n\n// Test: InferOutputsFromLambdas maps outputs correctly\ntype _InferOutputsTest = InferOutputsFromLambdas<{\n  myOutput: ConfigRenderLambda<number>;\n}>;\ntype _VerifyInferOutputs = Expect<\n  Equal<_InferOutputsTest, { myOutput: OutputWithStatus<number> & { __unwrap: true } }>\n>;\n"],"mappings":"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"}

package/dist/block_model.js

@@ -268,11 +268,13 @@ var BlockModelV3 = class BlockModelV3 {
 			const wrappedInputs = {};
 			for (const [paramKey, paramFn] of Object.entries(inputs)) wrappedInputs[paramKey] = () => paramFn(new BlockRenderCtx());
 			const outputs = model.outputs;
+			const { outputFlags } = model;
 			for (const [outputKey, outputFn] of Object.entries(outputs)) {
 				const key = pluginOutputKey(handle, outputKey);
 				pluginOutputs[key] = createAndRegisterRenderLambda({
 					handle: key,
-					lambda: () => outputFn(new PluginRenderCtx(handle, wrappedInputs))
+					lambda: () => outputFn(new PluginRenderCtx(handle, wrappedInputs)),
+					withStatus: outputFlags[outputKey]?.withStatus
 				});
 			}
 		}

package/dist/block_model.js.map

@@ -1 +1 @@
-{"version":3,"file":"block_model.js","names":[],"sources":["../src/block_model.ts"],"sourcesContent":["import type {\n  BlockRenderingMode,\n  BlockSection,\n  OutputWithStatus,\n  PlRef,\n  BlockCodeKnownFeatureFlags,\n  BlockConfigContainer,\n} from \"@milaboratories/pl-model-common\";\nimport { getPlatformaInstance, isInUI, createAndRegisterRenderLambda } from \"./internal\";\nimport type { DataModel } from \"./block_migrations\";\nimport type { PlatformaV3 } from \"./platforma\";\nimport type { InferRenderFunctionReturn, RenderFunction } from \"./render\";\nimport { BlockRenderCtx, PluginRenderCtx } from \"./render\";\nimport type { PluginData, PluginModel, PluginOutputs, PluginParams } from \"./plugin_model\";\nimport { PluginInstance as PluginInstanceClass, CREATE_PLUGIN_MODEL } from \"./plugin_model\";\nimport { type PluginHandle, pluginOutputKey } from \"./plugin_handle\";\nimport type { RenderCtxBase } from \"./render\";\nimport { PlatformaSDKVersion } from \"./version\";\nimport {\n  applyStorageUpdate,\n  getStorageDebugView,\n  migrateStorage,\n  createInitialStorage,\n  deriveArgsFromStorage,\n  derivePrerunArgsFromStorage,\n} from \"./block_storage_callbacks\";\nimport { type PluginName } from \"./block_storage\";\nimport type {\n  ConfigRenderLambda,\n  DeriveHref,\n  ConfigRenderLambdaFlags,\n  InferOutputsFromLambdas,\n} from \"./bconfig\";\nimport { downgradeCfgOrLambda, isConfigLambda } from \"./bconfig\";\nimport type { PlatformaExtended } from \"./platforma\";\nimport {\n  BLOCK_STORAGE_FACADE_VERSION,\n  BlockStorageFacadeCallbacks,\n  BlockStorageFacadeHandles,\n  registerFacadeCallbacks,\n} from \"./block_storage_facade\";\n\ntype SectionsExpectedType = readonly BlockSection[];\n\ntype NoOb = Record<string, never>;\n\n/**\n * Per-property lambdas for deriving plugin params from block render context.\n * Each property is a function that receives the block's RenderCtxBase and returns the param value.\n */\nexport type ParamsInput<Params, BArgs = unknown, BData = unknown> = {\n  [K in keyof Params]: (ctx: RenderCtxBase<BArgs, BData>) => Params[K];\n};\n\n/**\n * Type-erased version of ParamsInput for internal storage.\n */\ntype ParamsInputErased = Record<string, (ctx: RenderCtxBase) => unknown>;\n\n/**\n * Merges two feature flag objects with type-aware logic:\n * - `supports*` (boolean): OR — `true` if either side is `true`\n * - `requires*` (numeric): MAX — take the higher version requirement\n */\nfunction mergeFeatureFlags(\n  base: BlockCodeKnownFeatureFlags,\n  override: BlockCodeKnownFeatureFlags,\n): BlockCodeKnownFeatureFlags {\n  const result: Record<string, boolean | number | undefined> = { ...base };\n  for (const [key, value] of Object.entries(override)) {\n    if (value === undefined) continue;\n    const existing = result[key];\n    if (typeof value === \"boolean\") {\n      result[key] = (typeof existing === \"boolean\" && existing) || value;\n    } else if (typeof value === \"number\") {\n      result[key] = Math.max(typeof existing === \"number\" ? existing : 0, value);\n    }\n  }\n  return result as BlockCodeKnownFeatureFlags;\n}\n\n/**\n * Plugin record: model + param derivation lambdas.\n * Type parameters are carried by PluginModel generic.\n */\nexport type PluginRecord<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n> = {\n  readonly model: PluginModel<Data, Params, Outputs>;\n  readonly inputs: ParamsInputErased;\n};\n\ninterface BlockModelV3Config<\n  OutputsCfg extends Record<string, ConfigRenderLambda>,\n  Data,\n  Plugins extends Record<string, PluginRecord> = {},\n  Transfers extends Record<string, unknown> = {},\n> {\n  renderingMode: BlockRenderingMode;\n  dataModel: DataModel<Data, Transfers>;\n  outputs: OutputsCfg;\n  sections: ConfigRenderLambda;\n  title: ConfigRenderLambda | undefined;\n  subtitle: ConfigRenderLambda | undefined;\n  tags: ConfigRenderLambda | undefined;\n  enrichmentTargets: ConfigRenderLambda | undefined;\n  featureFlags: BlockCodeKnownFeatureFlags;\n  argsFunction: ((data: unknown) => unknown) | undefined;\n  prerunArgsFunction: ((data: unknown) => unknown) | undefined;\n  plugins: Plugins;\n}\n\n/** Main entry point that each block should use in it's \"config\" module. Don't forget\n * to call {@link done()} at the end of configuration. Value returned by this builder must be\n * exported as constant with name \"platforma\" from the \"config\" module.\n * API version is 3 (for UI) and 2 (for model) */\nexport class BlockModelV3<\n  Args,\n  OutputsCfg extends Record<string, ConfigRenderLambda>,\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Href extends `/${string}` = \"/\",\n  Plugins extends Record<string, PluginRecord> = {},\n  Transfers extends Record<string, unknown> = {},\n> {\n  private constructor(\n    private readonly config: BlockModelV3Config<OutputsCfg, Data, Plugins, Transfers>,\n  ) {}\n\n  public static readonly INITIAL_BLOCK_FEATURE_FLAGS: BlockCodeKnownFeatureFlags = {\n    supportsLazyState: true,\n    supportsPframeQueryRanking: true,\n    requiresUIAPIVersion: 3,\n    requiresModelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n    requiresCreatePTable: 2,\n  };\n\n  /**\n   * Creates a new BlockModelV3 builder with the specified data model.\n   *\n   * @example\n   * const dataModel = new DataModelBuilder()\n   *   .from<BlockData>(\"v1\")\n   *   .init(() => ({ numbers: [], labels: [] }));\n   *\n   * BlockModelV3.create(dataModel)\n   *   .args((data) => ({ numbers: data.numbers }))\n   *   .sections(() => [{ type: 'link', href: '/', label: 'Main' }])\n   *   .done();\n   *\n   * @param dataModel The data model that defines initial data and migrations\n   */\n  public static create<\n    Data extends Record<string, unknown>,\n    Transfers extends Record<string, unknown> = {},\n  >(dataModel: DataModel<Data, Transfers>): BlockModelV3<NoOb, {}, Data, \"/\", {}, Transfers> {\n    return new BlockModelV3<NoOb, {}, Data, \"/\", {}, Transfers>({\n      renderingMode: \"Heavy\",\n      dataModel,\n      outputs: {},\n      sections: createAndRegisterRenderLambda({ handle: \"sections\", lambda: () => [] }, true),\n      title: undefined,\n      subtitle: undefined,\n      tags: undefined,\n      enrichmentTargets: undefined,\n      featureFlags: { ...BlockModelV3.INITIAL_BLOCK_FEATURE_FLAGS },\n      argsFunction: undefined,\n      prerunArgsFunction: undefined,\n      plugins: {},\n    });\n  }\n\n  /**\n   * Add output cell wrapped with additional status information to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunction<Args, Data, unknown>>(\n    key: Key,\n    rf: RF,\n    flags: ConfigRenderLambdaFlags & { withStatus: true },\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> & {\n        withStatus: true;\n      };\n    },\n    Data,\n    Href,\n    Plugins,\n    Transfers\n  >;\n  /**\n   * Add output cell to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunction<Args, Data, unknown>>(\n    key: Key,\n    rf: RF,\n    flags?: ConfigRenderLambdaFlags,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>>;\n    },\n    Data,\n    Href,\n    Plugins,\n    Transfers\n  >;\n  public output(\n    key: string,\n    cfgOrRf: RenderFunction<Args, Data, unknown>,\n    flags: ConfigRenderLambdaFlags = {},\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3({\n      ...this.config,\n      outputs: {\n        ...this.config.outputs,\n        [key]: createAndRegisterRenderLambda({\n          handle: `block-output#${key}`,\n          lambda: () => cfgOrRf(new BlockRenderCtx<Args, Data>()),\n          ...flags,\n        }),\n      },\n    });\n  }\n\n  /** Shortcut for {@link output} with retentive flag set to true. */\n  public retentiveOutput<\n    const Key extends string,\n    const RF extends RenderFunction<Args, Data, unknown>,\n  >(\n    key: Key,\n    rf: RF,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>>;\n    },\n    Data,\n    Href,\n    Plugins,\n    Transfers\n  > {\n    return this.output(key, rf, { retentive: true });\n  }\n\n  /** Shortcut for {@link output} with withStatus flag set to true. */\n  public outputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunction<Args, Data, unknown>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { withStatus: true });\n  }\n\n  /**\n   * Sets a function to derive block args from data.\n   * This is called during setData to compute the args that will be used for block execution.\n   *\n   * @example\n   * .args<BlockArgs>((data) => ({ numbers: data.numbers }))\n   *\n   * @example\n   * .args<BlockArgs>((data) => {\n   *   if (data.numbers.length === 0) throw new Error('Numbers required'); // block not ready\n   *   return { numbers: data.numbers };\n   * })\n   */\n  public args<A>(\n    lambda: (data: Data) => A,\n  ): BlockModelV3<A, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<A, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      argsFunction: lambda as (data: unknown) => unknown,\n    });\n  }\n\n  /**\n   * Sets a function to derive pre-run args from data (optional).\n   * This is called during setData to compute the args that will be used for staging/pre-run phase.\n   *\n   * If not defined, defaults to using the args() function result.\n   * If defined, uses its return value for the staging / prerun phase.\n   *\n   * The staging / prerun phase runs only if currentPrerunArgs differs from the executed\n   * version of prerunArgs (same comparison logic as currentArgs vs prodArgs).\n   *\n   * @example\n   * .prerunArgs((data) => ({ numbers: data.numbers }))\n   *\n   * @example\n   * .prerunArgs((data) => {\n   *   // Return undefined to skip staging for this block\n   *   if (!data.isReady) return undefined;\n   *   return { numbers: data.numbers };\n   * })\n   */\n  public prerunArgs(\n    fn: (data: Data) => unknown,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      prerunArgsFunction: fn as (data: unknown) => unknown,\n    });\n  }\n\n  /** Sets the lambda to generate list of sections in the left block overviews panel. */\n  public sections<\n    const Ret extends SectionsExpectedType,\n    const RF extends RenderFunction<Args, Data, Ret>,\n  >(rf: RF): BlockModelV3<Args, OutputsCfg, Data, DeriveHref<ReturnType<RF>>, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, DeriveHref<ReturnType<RF>>, Plugins, Transfers>(\n      {\n        ...this.config,\n        // Replace the default sections callback with the user-provided one\n        sections: createAndRegisterRenderLambda(\n          { handle: \"sections\", lambda: () => rf(new BlockRenderCtx<Args, Data>()) },\n          true,\n        ),\n      },\n    );\n  }\n\n  /** Sets a rendering function to derive block title, shown for the block in the left blocks-overview panel. */\n  public title(\n    rf: RenderFunction<Args, Data, string>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      title: createAndRegisterRenderLambda({\n        handle: \"title\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  public subtitle(\n    rf: RenderFunction<Args, Data, string>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      subtitle: createAndRegisterRenderLambda({\n        handle: \"subtitle\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  public tags(\n    rf: RenderFunction<Args, Data, string[]>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      tags: createAndRegisterRenderLambda({\n        handle: \"tags\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  /** Sets or overrides feature flags for the block. */\n  public withFeatureFlags(\n    flags: Partial<BlockCodeKnownFeatureFlags>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      featureFlags: { ...this.config.featureFlags, ...flags },\n    });\n  }\n\n  /**\n   * Defines how to derive list of upstream references this block is meant to enrich with its exports from block args.\n   * Influences dependency graph construction.\n   */\n  public enriches(\n    lambda: (args: Args) => PlRef[],\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      enrichmentTargets: createAndRegisterRenderLambda({\n        handle: \"enrichmentTargets\",\n        lambda: lambda,\n      }),\n    });\n  }\n\n  /**\n   * Registers a plugin instance with the block.\n   * Consumes a transfer if one was defined for this plugin ID in the migration chain.\n   *\n   * Type checks:\n   * - If Transfers[Id] exists, verifies it extends PTransferData (transfer type compatibility)\n   * - If no Transfers[Id], rejects plugins with transferAt set (missing .transfer() in data model)\n   * - Rejects duplicate plugin IDs (Id already in keyof Plugins)\n   *\n   * @param instance - PluginInstance created via factory.create({ pluginId, ... })\n   * @param params - Per-property lambdas deriving plugin params from block RenderCtx\n   *\n   * @example\n   * .plugin(mainTable, {\n   *   columns: (ctx) => ctx.outputs?.resolve(\"data\")?.getPColumns(),\n   *   sourceId: (ctx) => ctx.data.selectedSource,\n   * })\n   */\n  public plugin<\n    const PluginId extends string,\n    PData extends PluginData,\n    PParams extends PluginParams,\n    POutputs extends PluginOutputs,\n    PTransferData,\n  >(\n    instance: PluginInstanceClass<\n      PluginId &\n        (PluginId extends keyof Transfers\n          ? Transfers[PluginId] extends PTransferData\n            ? string\n            : never\n          : [PTransferData] extends [never]\n            ? string\n            : never) &\n        (PluginId extends keyof Plugins ? never : string),\n      PData,\n      PParams,\n      POutputs,\n      PTransferData\n    >,\n    params?: ParamsInput<PParams, Args, Data>,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg,\n    Data,\n    Href,\n    Plugins & { [K in PluginId]: PluginRecord<PData, PParams, POutputs> },\n    Omit<Transfers, PluginId>\n  >;\n  public plugin(\n    instance: PluginInstanceClass,\n    params?: ParamsInput<Record<string, unknown>, unknown, unknown>,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg,\n    Data,\n    Href,\n    Record<string, PluginRecord>,\n    Record<string, unknown>\n  > {\n    const pluginId = instance.id;\n    const plugin = instance[CREATE_PLUGIN_MODEL]();\n    const resolvedParams = (params ?? {}) as ParamsInputErased;\n\n    if (pluginId in this.config.plugins) {\n      throw new Error(`Plugin '${pluginId}' already registered`);\n    }\n\n    const registered: PluginRecord = {\n      model: plugin,\n      inputs: resolvedParams,\n    };\n\n    return new BlockModelV3({\n      ...this.config,\n      plugins: {\n        ...this.config.plugins,\n        [pluginId]: registered,\n      },\n      featureFlags: mergeFeatureFlags(this.config.featureFlags, plugin.featureFlags ?? {}),\n    });\n  }\n\n  /** Renders all provided block settings into a pre-configured platforma API\n   * instance, that can be used in frontend to interact with block data, and\n   * other features provided by the platforma to the block.\n   *\n   * Type-level check: if there are unconsumed transfers (from `.transfer()` calls\n   * in the migration chain), this method requires an impossible `never` argument,\n   * producing a compile error. Register all transferred plugins via `.plugin(instance)`\n   * before calling `.done()`.\n   */\n  public done(\n    ..._: keyof Transfers extends never ? [] : [never]\n  ): PlatformaExtended<\n    PlatformaV3<Data, Args, InferOutputsFromLambdas<OutputsCfg>, Href, Plugins>\n  > {\n    if (this.config.argsFunction === undefined) throw new Error(\"Args rendering function not set.\");\n\n    const apiVersion = 3;\n\n    // Build plugin registry\n    const { plugins } = this.config;\n    const pluginRegistry: Record<string, PluginName> = {};\n    const pluginHandles = Object.keys(plugins) as PluginHandle[];\n    for (const handle of pluginHandles) {\n      pluginRegistry[handle] = plugins[handle].model.name;\n    }\n\n    const { dataModel, argsFunction, prerunArgsFunction } = this.config;\n\n    function getPlugin(handle: PluginHandle): PluginRecord {\n      const plugin = plugins[handle];\n      if (!plugin) throw new Error(`Plugin model not found for '${handle}'`);\n      return plugin;\n    }\n\n    // Register ALL facade callbacks here, with dependencies captured via closures\n    registerFacadeCallbacks({\n      [BlockStorageFacadeCallbacks.StorageApplyUpdate]: applyStorageUpdate,\n      [BlockStorageFacadeCallbacks.StorageDebugView]: getStorageDebugView,\n      [BlockStorageFacadeCallbacks.StorageMigrate]: (currentStorageJson) =>\n        migrateStorage(currentStorageJson, {\n          migrateBlockData: (v) => dataModel.migrate(v),\n          getPluginRegistry: () => pluginRegistry,\n          migratePluginData: (handle, v) => getPlugin(handle).model.dataModel.migrate(v),\n          createPluginData: (handle, transfer) => {\n            if (transfer) return transfer;\n            return getPlugin(handle).model.getDefaultData();\n          },\n        }),\n      [BlockStorageFacadeCallbacks.StorageInitial]: () =>\n        createInitialStorage({\n          getDefaultBlockData: () => dataModel.getDefaultData(),\n          getPluginRegistry: () => pluginRegistry,\n          createPluginData: (handle) => getPlugin(handle).model.getDefaultData(),\n        }),\n      [BlockStorageFacadeCallbacks.ArgsDerive]: (storageJson) =>\n        deriveArgsFromStorage(storageJson, argsFunction),\n      [BlockStorageFacadeCallbacks.PrerunArgsDerive]: (storageJson) =>\n        derivePrerunArgsFromStorage(storageJson, argsFunction, prerunArgsFunction),\n    });\n\n    // Register plugin input and output lambdas\n    const pluginOutputs: Record<string, ConfigRenderLambda> = {};\n    for (const handle of pluginHandles) {\n      const { model, inputs } = plugins[handle];\n      // Wrap plugin param lambdas: close over BlockRenderCtx creation\n      const wrappedInputs: Record<string, () => unknown> = {};\n      for (const [paramKey, paramFn] of Object.entries(inputs)) {\n        wrappedInputs[paramKey] = () => paramFn(new BlockRenderCtx());\n      }\n\n      // Register plugin outputs (in config pack, evaluated by middle layer)\n      const outputs = model.outputs as Record<string, (ctx: PluginRenderCtx) => unknown>;\n      for (const [outputKey, outputFn] of Object.entries(outputs)) {\n        const key = pluginOutputKey(handle, outputKey);\n        pluginOutputs[key] = createAndRegisterRenderLambda({\n          handle: key,\n          lambda: () => outputFn(new PluginRenderCtx(handle, wrappedInputs)),\n        });\n      }\n    }\n    const allOutputs = { ...this.config.outputs, ...pluginOutputs };\n\n    globalThis.platformaApiVersion = apiVersion;\n\n    if (!isInUI()) {\n      const blockConfig: BlockConfigContainer = {\n        v4: {\n          configVersion: 4,\n          modelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n          sdkVersion: PlatformaSDKVersion,\n          renderingMode: this.config.renderingMode,\n          sections: this.config.sections,\n          title: this.config.title,\n          subtitle: this.config.subtitle,\n          tags: this.config.tags,\n          outputs: allOutputs,\n          enrichmentTargets: this.config.enrichmentTargets,\n          featureFlags: this.config.featureFlags,\n          blockLifecycleCallbacks: { ...BlockStorageFacadeHandles },\n        },\n\n        // fields below are added to allow previous desktop versions read generated configs\n        sdkVersion: PlatformaSDKVersion,\n        renderingMode: this.config.renderingMode,\n        sections: this.config.sections,\n        outputs: Object.fromEntries(\n          Object.entries(this.config.outputs).map(([key, value]) => [\n            key,\n            downgradeCfgOrLambda(value),\n          ]),\n        ),\n      };\n      // we are in the configuration rendering routine, not in actual UI\n      return { config: blockConfig } as any;\n      // normal operation inside the UI\n    } else {\n      return {\n        ...getPlatformaInstance({\n          sdkVersion: PlatformaSDKVersion,\n          apiVersion,\n        }),\n        blockModelInfo: {\n          outputs: Object.fromEntries(\n            Object.entries(allOutputs).map(([key, value]) => [\n              key,\n              {\n                withStatus: Boolean(isConfigLambda(value) && value.withStatus),\n              },\n            ]),\n          ),\n          pluginIds: pluginHandles,\n          featureFlags: this.config.featureFlags,\n        },\n      } as any;\n    }\n  }\n}\n\n// Type tests for BlockModelV3\n\nexport type Expect<T extends true> = T;\n\nexport type Equal<X, Y> =\n  (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;\n\nexport type Merge<A, B> = {\n  [K in keyof A | keyof B]: K extends keyof B ? B[K] : K extends keyof A ? A[K] : never;\n};\n\n// Helper types for testing\ntype _TestArgs = { inputFile: string; threshold: number };\ntype _TestData = { selectedTab: string };\ntype _TestOutputs = {\n  result: ConfigRenderLambda<string>;\n  count: ConfigRenderLambda<number>;\n};\n\n// Test: Merge type works correctly\ntype _MergeTest1 = Expect<Equal<Merge<{ a: 1 }, { b: 2 }>, { a: 1; b: 2 }>>;\ntype _MergeTest2 = Expect<Equal<Merge<{ a: 1 }, { a: 2 }>, { a: 2 }>>;\ntype _MergeTest3 = Expect<Equal<Merge<{ a: 1; b: 1 }, { b: 2; c: 3 }>, { a: 1; b: 2; c: 3 }>>;\n\n// Test: create() returns a BlockModelV3 instance\n// Note: Due to function overloads, ReturnType uses the last overload signature.\n// We verify the structure is correct using a simpler assignability test.\ntype _CreateResult = ReturnType<typeof BlockModelV3.create>;\ntype _CreateIsBlockModelV3 =\n  _CreateResult extends BlockModelV3<infer _A, infer _O, infer _S> ? true : false;\ntype _CreateTest = Expect<_CreateIsBlockModelV3>;\n\n// Test: BlockModelV3Config interface structure (default generics)\ntype _ConfigTest = Expect<\n  Equal<\n    BlockModelV3Config<_TestOutputs, _TestData>,\n    {\n      renderingMode: BlockRenderingMode;\n      argsFunction: ((data: unknown) => unknown) | undefined;\n      prerunArgsFunction: ((data: unknown) => unknown) | undefined;\n      dataModel: DataModel<_TestData, {}>;\n      outputs: _TestOutputs;\n      sections: ConfigRenderLambda;\n      title: ConfigRenderLambda | undefined;\n      subtitle: ConfigRenderLambda | undefined;\n      tags: ConfigRenderLambda | undefined;\n      enrichmentTargets: ConfigRenderLambda | undefined;\n      featureFlags: BlockCodeKnownFeatureFlags;\n      plugins: {};\n    }\n  >\n>;\n\n// Test: Default Href is '/'\ntype _HrefDefaultTest =\n  BlockModelV3<_TestArgs, {}, _TestData> extends BlockModelV3<_TestArgs, {}, _TestData, \"/\">\n    ? true\n    : false;\ntype _VerifyHrefDefault = Expect<_HrefDefaultTest>;\n\n// Test: Custom Href can be specified\ntype _CustomHref = \"/settings\" | \"/main\";\ntype _HrefCustomBuilder = BlockModelV3<_TestArgs, {}, _TestData, _CustomHref>;\ntype _HrefCustomTest =\n  _HrefCustomBuilder extends BlockModelV3<_TestArgs, {}, _TestData, _CustomHref> ? true : false;\ntype _VerifyHrefCustom = Expect<_HrefCustomTest>;\n\n// Test: Output type accumulation with & intersection\ntype _OutputsAccumulation = { a: ConfigRenderLambda<string> } & {\n  b: ConfigRenderLambda<number>;\n};\ntype _VerifyOutputsHaveKeys = Expect<Equal<keyof _OutputsAccumulation, \"a\" | \"b\">>;\n\n// Test: Builder with all type parameters specified compiles\ntype _FullBuilder = BlockModelV3<_TestArgs, _TestOutputs, _TestData, \"/main\">;\ntype _FullBuilderTest =\n  _FullBuilder extends BlockModelV3<_TestArgs, _TestOutputs, _TestData, \"/main\"> ? true : false;\ntype _VerifyFullBuilder = Expect<_FullBuilderTest>;\n\n// Test: InferOutputsFromLambdas maps outputs correctly\ntype _InferOutputsTest = InferOutputsFromLambdas<{\n  myOutput: ConfigRenderLambda<number>;\n}>;\ntype _VerifyInferOutputs = Expect<\n  Equal<_InferOutputsTest, { myOutput: OutputWithStatus<number> & { __unwrap: true } }>\n>;\n"],"mappings":"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"}
+{"version":3,"file":"block_model.js","names":[],"sources":["../src/block_model.ts"],"sourcesContent":["import type {\n  BlockRenderingMode,\n  BlockSection,\n  OutputWithStatus,\n  PlRef,\n  BlockCodeKnownFeatureFlags,\n  BlockConfigContainer,\n} from \"@milaboratories/pl-model-common\";\nimport { getPlatformaInstance, isInUI, createAndRegisterRenderLambda } from \"./internal\";\nimport type { DataModel } from \"./block_migrations\";\nimport type { PlatformaV3 } from \"./platforma\";\nimport type { InferRenderFunctionReturn, RenderFunction } from \"./render\";\nimport { BlockRenderCtx, PluginRenderCtx } from \"./render\";\nimport type { PluginData, PluginModel, PluginOutputs, PluginParams } from \"./plugin_model\";\nimport { PluginInstance as PluginInstanceClass, CREATE_PLUGIN_MODEL } from \"./plugin_model\";\nimport { type PluginHandle, pluginOutputKey } from \"./plugin_handle\";\nimport type { RenderCtxBase } from \"./render\";\nimport { PlatformaSDKVersion } from \"./version\";\nimport {\n  applyStorageUpdate,\n  getStorageDebugView,\n  migrateStorage,\n  createInitialStorage,\n  deriveArgsFromStorage,\n  derivePrerunArgsFromStorage,\n} from \"./block_storage_callbacks\";\nimport { type PluginName } from \"./block_storage\";\nimport type {\n  ConfigRenderLambda,\n  DeriveHref,\n  ConfigRenderLambdaFlags,\n  InferOutputsFromLambdas,\n} from \"./bconfig\";\nimport { downgradeCfgOrLambda, isConfigLambda } from \"./bconfig\";\nimport type { PlatformaExtended } from \"./platforma\";\nimport {\n  BLOCK_STORAGE_FACADE_VERSION,\n  BlockStorageFacadeCallbacks,\n  BlockStorageFacadeHandles,\n  registerFacadeCallbacks,\n} from \"./block_storage_facade\";\n\ntype SectionsExpectedType = readonly BlockSection[];\n\ntype NoOb = Record<string, never>;\n\n/**\n * Per-property lambdas for deriving plugin params from block render context.\n * Each property is a function that receives the block's RenderCtxBase and returns the param value.\n */\nexport type ParamsInput<Params, BArgs = unknown, BData = unknown> = {\n  [K in keyof Params]: (ctx: RenderCtxBase<BArgs, BData>) => Params[K];\n};\n\n/**\n * Type-erased version of ParamsInput for internal storage.\n */\ntype ParamsInputErased = Record<string, (ctx: RenderCtxBase) => unknown>;\n\n/**\n * Merges two feature flag objects with type-aware logic:\n * - `supports*` (boolean): OR — `true` if either side is `true`\n * - `requires*` (numeric): MAX — take the higher version requirement\n */\nfunction mergeFeatureFlags(\n  base: BlockCodeKnownFeatureFlags,\n  override: BlockCodeKnownFeatureFlags,\n): BlockCodeKnownFeatureFlags {\n  const result: Record<string, boolean | number | undefined> = { ...base };\n  for (const [key, value] of Object.entries(override)) {\n    if (value === undefined) continue;\n    const existing = result[key];\n    if (typeof value === \"boolean\") {\n      result[key] = (typeof existing === \"boolean\" && existing) || value;\n    } else if (typeof value === \"number\") {\n      result[key] = Math.max(typeof existing === \"number\" ? existing : 0, value);\n    }\n  }\n  return result as BlockCodeKnownFeatureFlags;\n}\n\n/**\n * Plugin record: model + param derivation lambdas.\n * Type parameters are carried by PluginModel generic.\n */\nexport type PluginRecord<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n> = {\n  readonly model: PluginModel<Data, Params, Outputs>;\n  readonly inputs: ParamsInputErased;\n};\n\ninterface BlockModelV3Config<\n  OutputsCfg extends Record<string, ConfigRenderLambda>,\n  Data,\n  Plugins extends Record<string, PluginRecord> = {},\n  Transfers extends Record<string, unknown> = {},\n> {\n  renderingMode: BlockRenderingMode;\n  dataModel: DataModel<Data, Transfers>;\n  outputs: OutputsCfg;\n  sections: ConfigRenderLambda;\n  title: ConfigRenderLambda | undefined;\n  subtitle: ConfigRenderLambda | undefined;\n  tags: ConfigRenderLambda | undefined;\n  enrichmentTargets: ConfigRenderLambda | undefined;\n  featureFlags: BlockCodeKnownFeatureFlags;\n  argsFunction: ((data: unknown) => unknown) | undefined;\n  prerunArgsFunction: ((data: unknown) => unknown) | undefined;\n  plugins: Plugins;\n}\n\n/** Main entry point that each block should use in it's \"config\" module. Don't forget\n * to call {@link done()} at the end of configuration. Value returned by this builder must be\n * exported as constant with name \"platforma\" from the \"config\" module.\n * API version is 3 (for UI) and 2 (for model) */\nexport class BlockModelV3<\n  Args,\n  OutputsCfg extends Record<string, ConfigRenderLambda>,\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Href extends `/${string}` = \"/\",\n  Plugins extends Record<string, PluginRecord> = {},\n  Transfers extends Record<string, unknown> = {},\n> {\n  private constructor(\n    private readonly config: BlockModelV3Config<OutputsCfg, Data, Plugins, Transfers>,\n  ) {}\n\n  public static readonly INITIAL_BLOCK_FEATURE_FLAGS: BlockCodeKnownFeatureFlags = {\n    supportsLazyState: true,\n    supportsPframeQueryRanking: true,\n    requiresUIAPIVersion: 3,\n    requiresModelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n    requiresCreatePTable: 2,\n  };\n\n  /**\n   * Creates a new BlockModelV3 builder with the specified data model.\n   *\n   * @example\n   * const dataModel = new DataModelBuilder()\n   *   .from<BlockData>(\"v1\")\n   *   .init(() => ({ numbers: [], labels: [] }));\n   *\n   * BlockModelV3.create(dataModel)\n   *   .args((data) => ({ numbers: data.numbers }))\n   *   .sections(() => [{ type: 'link', href: '/', label: 'Main' }])\n   *   .done();\n   *\n   * @param dataModel The data model that defines initial data and migrations\n   */\n  public static create<\n    Data extends Record<string, unknown>,\n    Transfers extends Record<string, unknown> = {},\n  >(dataModel: DataModel<Data, Transfers>): BlockModelV3<NoOb, {}, Data, \"/\", {}, Transfers> {\n    return new BlockModelV3<NoOb, {}, Data, \"/\", {}, Transfers>({\n      renderingMode: \"Heavy\",\n      dataModel,\n      outputs: {},\n      sections: createAndRegisterRenderLambda({ handle: \"sections\", lambda: () => [] }, true),\n      title: undefined,\n      subtitle: undefined,\n      tags: undefined,\n      enrichmentTargets: undefined,\n      featureFlags: { ...BlockModelV3.INITIAL_BLOCK_FEATURE_FLAGS },\n      argsFunction: undefined,\n      prerunArgsFunction: undefined,\n      plugins: {},\n    });\n  }\n\n  /**\n   * Add output cell wrapped with additional status information to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunction<Args, Data, unknown>>(\n    key: Key,\n    rf: RF,\n    flags: ConfigRenderLambdaFlags & { withStatus: true },\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> & {\n        withStatus: true;\n      };\n    },\n    Data,\n    Href,\n    Plugins,\n    Transfers\n  >;\n  /**\n   * Add output cell to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunction<Args, Data, unknown>>(\n    key: Key,\n    rf: RF,\n    flags?: ConfigRenderLambdaFlags,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>>;\n    },\n    Data,\n    Href,\n    Plugins,\n    Transfers\n  >;\n  public output(\n    key: string,\n    cfgOrRf: RenderFunction<Args, Data, unknown>,\n    flags: ConfigRenderLambdaFlags = {},\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3({\n      ...this.config,\n      outputs: {\n        ...this.config.outputs,\n        [key]: createAndRegisterRenderLambda({\n          handle: `block-output#${key}`,\n          lambda: () => cfgOrRf(new BlockRenderCtx<Args, Data>()),\n          ...flags,\n        }),\n      },\n    });\n  }\n\n  /** Shortcut for {@link output} with retentive flag set to true. */\n  public retentiveOutput<\n    const Key extends string,\n    const RF extends RenderFunction<Args, Data, unknown>,\n  >(\n    key: Key,\n    rf: RF,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>>;\n    },\n    Data,\n    Href,\n    Plugins,\n    Transfers\n  > {\n    return this.output(key, rf, { retentive: true });\n  }\n\n  /** Shortcut for {@link output} with withStatus flag set to true. */\n  public outputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunction<Args, Data, unknown>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { withStatus: true });\n  }\n\n  /**\n   * Sets a function to derive block args from data.\n   * This is called during setData to compute the args that will be used for block execution.\n   *\n   * @example\n   * .args<BlockArgs>((data) => ({ numbers: data.numbers }))\n   *\n   * @example\n   * .args<BlockArgs>((data) => {\n   *   if (data.numbers.length === 0) throw new Error('Numbers required'); // block not ready\n   *   return { numbers: data.numbers };\n   * })\n   */\n  public args<A>(\n    lambda: (data: Data) => A,\n  ): BlockModelV3<A, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<A, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      argsFunction: lambda as (data: unknown) => unknown,\n    });\n  }\n\n  /**\n   * Sets a function to derive pre-run args from data (optional).\n   * This is called during setData to compute the args that will be used for staging/pre-run phase.\n   *\n   * If not defined, defaults to using the args() function result.\n   * If defined, uses its return value for the staging / prerun phase.\n   *\n   * The staging / prerun phase runs only if currentPrerunArgs differs from the executed\n   * version of prerunArgs (same comparison logic as currentArgs vs prodArgs).\n   *\n   * @example\n   * .prerunArgs((data) => ({ numbers: data.numbers }))\n   *\n   * @example\n   * .prerunArgs((data) => {\n   *   // Return undefined to skip staging for this block\n   *   if (!data.isReady) return undefined;\n   *   return { numbers: data.numbers };\n   * })\n   */\n  public prerunArgs(\n    fn: (data: Data) => unknown,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      prerunArgsFunction: fn as (data: unknown) => unknown,\n    });\n  }\n\n  /** Sets the lambda to generate list of sections in the left block overviews panel. */\n  public sections<\n    const Ret extends SectionsExpectedType,\n    const RF extends RenderFunction<Args, Data, Ret>,\n  >(rf: RF): BlockModelV3<Args, OutputsCfg, Data, DeriveHref<ReturnType<RF>>, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, DeriveHref<ReturnType<RF>>, Plugins, Transfers>(\n      {\n        ...this.config,\n        // Replace the default sections callback with the user-provided one\n        sections: createAndRegisterRenderLambda(\n          { handle: \"sections\", lambda: () => rf(new BlockRenderCtx<Args, Data>()) },\n          true,\n        ),\n      },\n    );\n  }\n\n  /** Sets a rendering function to derive block title, shown for the block in the left blocks-overview panel. */\n  public title(\n    rf: RenderFunction<Args, Data, string>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      title: createAndRegisterRenderLambda({\n        handle: \"title\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  public subtitle(\n    rf: RenderFunction<Args, Data, string>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      subtitle: createAndRegisterRenderLambda({\n        handle: \"subtitle\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  public tags(\n    rf: RenderFunction<Args, Data, string[]>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      tags: createAndRegisterRenderLambda({\n        handle: \"tags\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  /** Sets or overrides feature flags for the block. */\n  public withFeatureFlags(\n    flags: Partial<BlockCodeKnownFeatureFlags>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      featureFlags: { ...this.config.featureFlags, ...flags },\n    });\n  }\n\n  /**\n   * Defines how to derive list of upstream references this block is meant to enrich with its exports from block args.\n   * Influences dependency graph construction.\n   */\n  public enriches(\n    lambda: (args: Args) => PlRef[],\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins, Transfers>({\n      ...this.config,\n      enrichmentTargets: createAndRegisterRenderLambda({\n        handle: \"enrichmentTargets\",\n        lambda: lambda,\n      }),\n    });\n  }\n\n  /**\n   * Registers a plugin instance with the block.\n   * Consumes a transfer if one was defined for this plugin ID in the migration chain.\n   *\n   * Type checks:\n   * - If Transfers[Id] exists, verifies it extends PTransferData (transfer type compatibility)\n   * - If no Transfers[Id], rejects plugins with transferAt set (missing .transfer() in data model)\n   * - Rejects duplicate plugin IDs (Id already in keyof Plugins)\n   *\n   * @param instance - PluginInstance created via factory.create({ pluginId, ... })\n   * @param params - Per-property lambdas deriving plugin params from block RenderCtx\n   *\n   * @example\n   * .plugin(mainTable, {\n   *   columns: (ctx) => ctx.outputs?.resolve(\"data\")?.getPColumns(),\n   *   sourceId: (ctx) => ctx.data.selectedSource,\n   * })\n   */\n  public plugin<\n    const PluginId extends string,\n    PData extends PluginData,\n    PParams extends PluginParams,\n    POutputs extends PluginOutputs,\n    PTransferData,\n  >(\n    instance: PluginInstanceClass<\n      PluginId &\n        (PluginId extends keyof Transfers\n          ? Transfers[PluginId] extends PTransferData\n            ? string\n            : never\n          : [PTransferData] extends [never]\n            ? string\n            : never) &\n        (PluginId extends keyof Plugins ? never : string),\n      PData,\n      PParams,\n      POutputs,\n      PTransferData\n    >,\n    params?: ParamsInput<PParams, Args, Data>,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg,\n    Data,\n    Href,\n    Plugins & { [K in PluginId]: PluginRecord<PData, PParams, POutputs> },\n    Omit<Transfers, PluginId>\n  >;\n  public plugin(\n    instance: PluginInstanceClass,\n    params?: ParamsInput<Record<string, unknown>, unknown, unknown>,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg,\n    Data,\n    Href,\n    Record<string, PluginRecord>,\n    Record<string, unknown>\n  > {\n    const pluginId = instance.id;\n    const plugin = instance[CREATE_PLUGIN_MODEL]();\n    const resolvedParams = (params ?? {}) as ParamsInputErased;\n\n    if (pluginId in this.config.plugins) {\n      throw new Error(`Plugin '${pluginId}' already registered`);\n    }\n\n    const registered: PluginRecord = {\n      model: plugin,\n      inputs: resolvedParams,\n    };\n\n    return new BlockModelV3({\n      ...this.config,\n      plugins: {\n        ...this.config.plugins,\n        [pluginId]: registered,\n      },\n      featureFlags: mergeFeatureFlags(this.config.featureFlags, plugin.featureFlags ?? {}),\n    });\n  }\n\n  /** Renders all provided block settings into a pre-configured platforma API\n   * instance, that can be used in frontend to interact with block data, and\n   * other features provided by the platforma to the block.\n   *\n   * Type-level check: if there are unconsumed transfers (from `.transfer()` calls\n   * in the migration chain), this method requires an impossible `never` argument,\n   * producing a compile error. Register all transferred plugins via `.plugin(instance)`\n   * before calling `.done()`.\n   */\n  public done(\n    ..._: keyof Transfers extends never ? [] : [never]\n  ): PlatformaExtended<\n    PlatformaV3<Data, Args, InferOutputsFromLambdas<OutputsCfg>, Href, Plugins>\n  > {\n    if (this.config.argsFunction === undefined) throw new Error(\"Args rendering function not set.\");\n\n    const apiVersion = 3;\n\n    // Build plugin registry\n    const { plugins } = this.config;\n    const pluginRegistry: Record<string, PluginName> = {};\n    const pluginHandles = Object.keys(plugins) as PluginHandle[];\n    for (const handle of pluginHandles) {\n      pluginRegistry[handle] = plugins[handle].model.name;\n    }\n\n    const { dataModel, argsFunction, prerunArgsFunction } = this.config;\n\n    function getPlugin(handle: PluginHandle): PluginRecord {\n      const plugin = plugins[handle];\n      if (!plugin) throw new Error(`Plugin model not found for '${handle}'`);\n      return plugin;\n    }\n\n    // Register ALL facade callbacks here, with dependencies captured via closures\n    registerFacadeCallbacks({\n      [BlockStorageFacadeCallbacks.StorageApplyUpdate]: applyStorageUpdate,\n      [BlockStorageFacadeCallbacks.StorageDebugView]: getStorageDebugView,\n      [BlockStorageFacadeCallbacks.StorageMigrate]: (currentStorageJson) =>\n        migrateStorage(currentStorageJson, {\n          migrateBlockData: (v) => dataModel.migrate(v),\n          getPluginRegistry: () => pluginRegistry,\n          migratePluginData: (handle, v) => getPlugin(handle).model.dataModel.migrate(v),\n          createPluginData: (handle, transfer) => {\n            if (transfer) return transfer;\n            return getPlugin(handle).model.getDefaultData();\n          },\n        }),\n      [BlockStorageFacadeCallbacks.StorageInitial]: () =>\n        createInitialStorage({\n          getDefaultBlockData: () => dataModel.getDefaultData(),\n          getPluginRegistry: () => pluginRegistry,\n          createPluginData: (handle) => getPlugin(handle).model.getDefaultData(),\n        }),\n      [BlockStorageFacadeCallbacks.ArgsDerive]: (storageJson) =>\n        deriveArgsFromStorage(storageJson, argsFunction),\n      [BlockStorageFacadeCallbacks.PrerunArgsDerive]: (storageJson) =>\n        derivePrerunArgsFromStorage(storageJson, argsFunction, prerunArgsFunction),\n    });\n\n    // Register plugin input and output lambdas\n    const pluginOutputs: Record<string, ConfigRenderLambda> = {};\n    for (const handle of pluginHandles) {\n      const { model, inputs } = plugins[handle];\n      // Wrap plugin param lambdas: close over BlockRenderCtx creation\n      const wrappedInputs: Record<string, () => unknown> = {};\n      for (const [paramKey, paramFn] of Object.entries(inputs)) {\n        wrappedInputs[paramKey] = () => paramFn(new BlockRenderCtx());\n      }\n\n      // Register plugin outputs (in config pack, evaluated by middle layer)\n      const outputs = model.outputs as Record<string, (ctx: PluginRenderCtx) => unknown>;\n      const { outputFlags } = model;\n      for (const [outputKey, outputFn] of Object.entries(outputs)) {\n        const key = pluginOutputKey(handle, outputKey);\n        pluginOutputs[key] = createAndRegisterRenderLambda({\n          handle: key,\n          lambda: () => outputFn(new PluginRenderCtx(handle, wrappedInputs)),\n          withStatus: outputFlags[outputKey]?.withStatus,\n        });\n      }\n    }\n    const allOutputs = { ...this.config.outputs, ...pluginOutputs };\n\n    globalThis.platformaApiVersion = apiVersion;\n\n    if (!isInUI()) {\n      const blockConfig: BlockConfigContainer = {\n        v4: {\n          configVersion: 4,\n          modelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n          sdkVersion: PlatformaSDKVersion,\n          renderingMode: this.config.renderingMode,\n          sections: this.config.sections,\n          title: this.config.title,\n          subtitle: this.config.subtitle,\n          tags: this.config.tags,\n          outputs: allOutputs,\n          enrichmentTargets: this.config.enrichmentTargets,\n          featureFlags: this.config.featureFlags,\n          blockLifecycleCallbacks: { ...BlockStorageFacadeHandles },\n        },\n\n        // fields below are added to allow previous desktop versions read generated configs\n        sdkVersion: PlatformaSDKVersion,\n        renderingMode: this.config.renderingMode,\n        sections: this.config.sections,\n        outputs: Object.fromEntries(\n          Object.entries(this.config.outputs).map(([key, value]) => [\n            key,\n            downgradeCfgOrLambda(value),\n          ]),\n        ),\n      };\n      // we are in the configuration rendering routine, not in actual UI\n      return { config: blockConfig } as any;\n      // normal operation inside the UI\n    } else {\n      return {\n        ...getPlatformaInstance({\n          sdkVersion: PlatformaSDKVersion,\n          apiVersion,\n        }),\n        blockModelInfo: {\n          outputs: Object.fromEntries(\n            Object.entries(allOutputs).map(([key, value]) => [\n              key,\n              {\n                withStatus: Boolean(isConfigLambda(value) && value.withStatus),\n              },\n            ]),\n          ),\n          pluginIds: pluginHandles,\n          featureFlags: this.config.featureFlags,\n        },\n      } as any;\n    }\n  }\n}\n\n// Type tests for BlockModelV3\n\nexport type Expect<T extends true> = T;\n\nexport type Equal<X, Y> =\n  (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;\n\nexport type Merge<A, B> = {\n  [K in keyof A | keyof B]: K extends keyof B ? B[K] : K extends keyof A ? A[K] : never;\n};\n\n// Helper types for testing\ntype _TestArgs = { inputFile: string; threshold: number };\ntype _TestData = { selectedTab: string };\ntype _TestOutputs = {\n  result: ConfigRenderLambda<string>;\n  count: ConfigRenderLambda<number>;\n};\n\n// Test: Merge type works correctly\ntype _MergeTest1 = Expect<Equal<Merge<{ a: 1 }, { b: 2 }>, { a: 1; b: 2 }>>;\ntype _MergeTest2 = Expect<Equal<Merge<{ a: 1 }, { a: 2 }>, { a: 2 }>>;\ntype _MergeTest3 = Expect<Equal<Merge<{ a: 1; b: 1 }, { b: 2; c: 3 }>, { a: 1; b: 2; c: 3 }>>;\n\n// Test: create() returns a BlockModelV3 instance\n// Note: Due to function overloads, ReturnType uses the last overload signature.\n// We verify the structure is correct using a simpler assignability test.\ntype _CreateResult = ReturnType<typeof BlockModelV3.create>;\ntype _CreateIsBlockModelV3 =\n  _CreateResult extends BlockModelV3<infer _A, infer _O, infer _S> ? true : false;\ntype _CreateTest = Expect<_CreateIsBlockModelV3>;\n\n// Test: BlockModelV3Config interface structure (default generics)\ntype _ConfigTest = Expect<\n  Equal<\n    BlockModelV3Config<_TestOutputs, _TestData>,\n    {\n      renderingMode: BlockRenderingMode;\n      argsFunction: ((data: unknown) => unknown) | undefined;\n      prerunArgsFunction: ((data: unknown) => unknown) | undefined;\n      dataModel: DataModel<_TestData, {}>;\n      outputs: _TestOutputs;\n      sections: ConfigRenderLambda;\n      title: ConfigRenderLambda | undefined;\n      subtitle: ConfigRenderLambda | undefined;\n      tags: ConfigRenderLambda | undefined;\n      enrichmentTargets: ConfigRenderLambda | undefined;\n      featureFlags: BlockCodeKnownFeatureFlags;\n      plugins: {};\n    }\n  >\n>;\n\n// Test: Default Href is '/'\ntype _HrefDefaultTest =\n  BlockModelV3<_TestArgs, {}, _TestData> extends BlockModelV3<_TestArgs, {}, _TestData, \"/\">\n    ? true\n    : false;\ntype _VerifyHrefDefault = Expect<_HrefDefaultTest>;\n\n// Test: Custom Href can be specified\ntype _CustomHref = \"/settings\" | \"/main\";\ntype _HrefCustomBuilder = BlockModelV3<_TestArgs, {}, _TestData, _CustomHref>;\ntype _HrefCustomTest =\n  _HrefCustomBuilder extends BlockModelV3<_TestArgs, {}, _TestData, _CustomHref> ? true : false;\ntype _VerifyHrefCustom = Expect<_HrefCustomTest>;\n\n// Test: Output type accumulation with & intersection\ntype _OutputsAccumulation = { a: ConfigRenderLambda<string> } & {\n  b: ConfigRenderLambda<number>;\n};\ntype _VerifyOutputsHaveKeys = Expect<Equal<keyof _OutputsAccumulation, \"a\" | \"b\">>;\n\n// Test: Builder with all type parameters specified compiles\ntype _FullBuilder = BlockModelV3<_TestArgs, _TestOutputs, _TestData, \"/main\">;\ntype _FullBuilderTest =\n  _FullBuilder extends BlockModelV3<_TestArgs, _TestOutputs, _TestData, \"/main\"> ? true : false;\ntype _VerifyFullBuilder = Expect<_FullBuilderTest>;\n\n// Test: InferOutputsFromLambdas maps outputs correctly\ntype _InferOutputsTest = InferOutputsFromLambdas<{\n  myOutput: ConfigRenderLambda<number>;\n}>;\ntype _VerifyInferOutputs = Expect<\n  Equal<_InferOutputsTest, { myOutput: OutputWithStatus<number> & { __unwrap: true } }>\n>;\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -31,7 +31,7 @@ import { BlockRenderCtx, InferRenderFunctionReturn, PluginRenderCtx, RenderCtx,
 import { PColumnKeyList, PColumnResourceMapData, PColumnResourceMapEntry, RT_BINARY_PARTITIONED, RT_BINARY_SUPER_PARTITIONED, RT_JSON_PARTITIONED, RT_JSON_SUPER_PARTITIONED, RT_PARQUET_PARTITIONED, RT_PARQUET_SUPER_PARTITIONED, RT_RESOURCE_MAP, RT_RESOURCE_MAP_PARTITIONED, allPColumnsReady, convertOrParsePColumnData, getPartitionKeysList, getUniquePartitionKeys, isPColumnReady, parsePColumnData, parseResourceMap } from "./render/util/pcolumn_data.js";
 import { filterDataInfoEntries } from "./render/util/axis_filtering.js";
 import "./render/index.js";
-import { PluginConfig, PluginData, PluginDataModel, PluginDataModelBuilder, PluginFactory, PluginInstance, PluginModel, PluginOutputs, PluginParams } from "./plugin_model.js";
+import { PluginConfig, PluginData, PluginDataModel, PluginDataModelBuilder, PluginDataModelVersions, PluginFactory, PluginInstance, PluginModel, PluginOutputs, PluginParams } from "./plugin_model.js";
 import { BlockModelV3, ParamsInput, PluginRecord } from "./block_model.js";
 import { BlockModelInfo, InferArgsType, InferBlockState, InferBlockStatePatch, InferDataType, InferHrefType, InferOutputsType, InferPluginData, InferPluginHandles, InferPluginNames, InferUiState, Platforma, PlatformaApiVersion, PlatformaExtended, PlatformaFactory, PlatformaV1, PlatformaV2, PlatformaV3 } from "./platforma.js";
 import { BlockModel } from "./block_model_legacy.js";
@@ -72,4 +72,4 @@ import { getAxisUniqueValues, getColumnOrAxisValueLabelsId, getColumnSpecById, g
 import { getEnvironmentValue } from "./env_value.js";
 export * from "@milaboratories/pl-model-common";
 export * from "@milaboratories/pl-error-like";
-export { ActAnd, ActExtractArchiveAndGetURL, ActFlatten, ActGetBlobContent, ActGetBlobContentAsJson, ActGetBlobContentAsString, ActGetDownloadedBlobContent, ActGetField, ActGetFromCtx, ActGetImmediate, ActGetLastLogs, ActGetLogHandle, ActGetOnDemandBlobContent, ActGetProgressLog, ActGetProgressLogWithInfo, ActGetResourceField, ActGetResourceValueAsJson, ActImportProgress, ActIsEmpty, ActIsolate, ActMakeArray, ActMakeObject, ActMapArrayValues, ActMapRecordValues, ActMapResourceFields, ActNot, ActOr, ActionResult, AnchoredBuildOptions, AnchoredColumnCollection, AnchoredFindColumnsOptions, AndFilter, AnnotationFilter, AnnotationMode, AnnotationScript, AnnotationScript2, AnnotationScriptUi, AnnotationSpec, AnnotationSpecUi, AnnotationStep, AnnotationStepUi, AnyForm, Args, ArrayColumnProvider, AxesVault, AxisLabelProvider, BLOCK_STORAGE_FACADE_VERSION, BlockApiV1, BlockApiV2, BlockConfig, BlockConfigV3, BlockConfigV4, BlockModel, BlockModelInfo, BlockModelV3, BlockRenderCtx, BlockStatePatch, type BlockStorage, BlockStorageFacade, BlockStorageFacadeCallbacks, BlockStorageFacadeHandles, type BlockStorageSchemaVersion, BuildOptions, CancelSubscription, Cfg, CfgAnd, CfgBlobContent, CfgBlobContentAsJson, CfgBlobContentAsString, CfgDownloadedBlobContent, CfgExtractArchiveAndGetURL, CfgFlatten, CfgGetFromCtx, CfgGetJsonField, CfgGetResourceField, CfgImmediate, CfgImportProgress, CfgIsEmpty, CfgIsolate, CfgLastLogs, CfgLogHandle, CfgMakeArray, CfgMakeObject, CfgMapArrayValues, CfgMapRecordValues, CfgMapResourceFields, CfgNot, CfgOnDemandBlobContent, CfgOr, CfgProgressLog, CfgProgressLogWithInfo, CfgRenderingMode, CfgResourceValueAsJson, Checked, ColumnCollection, ColumnCollectionBuilder, ColumnData, ColumnDataStatus, ColumnMatch, ColumnProvider, ColumnSelectorInput, ColumnSnapshot, ColumnSnapshotProvider, ColumnSource, CommonFieldTraverseOps, CommonTraversalOps, ConfAction, ConfigRenderLambda, ConfigRenderLambdaFlags, ConfigResult, CurrentSdkInfo, DataModel, DataModelBuilder, DeriveHref, DeriveLabelsOptions, Entry, ExpressionSpec, ExtractAction, ExtractFunctionHandleReturn, ExtractFutureRefType, FieldTraversalStep, FieldType, FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, FilterSpecUi, FilterUi, FilterUiOfType, FilterUiType, FindColumnsOptions, FormField, FutureRef, GetFieldStep, InferArgsType, InferBlockState, InferBlockStatePatch, InferDataType, InferFactoryData, InferFactoryOutputs, InferFactoryParams, InferHrefType, InferOutputType, InferOutputsFromConfigs, InferOutputsFromLambdas, InferOutputsType, InferPluginData, InferPluginHandle, InferPluginHandles, InferPluginNames, InferRenderFunctionReturn, InferUiState, InferVarTypeSafe, IsNA, It, internal_d_exports as JsRenderInternal, DeriveLabelsOptions as LabelDerivationOps, Log10, MainOutputs, MatchQualifications, MatchVariant, MatchingMode, type MigrateBlockStorageConfig, type MigrationFailure, type MigrationResult, type MigrationSuccess, type MutateStoragePayload, NotFilter, NumericalComparisonFilter, OptionalPlResourceEntry, OrFilter, OutputColumnProvider, OutputColumnProviderOpts, OutputError, PColumnCollection, PColumnDataUniversal, PColumnEntryUniversal, PColumnEntryWithLabel, PColumnKeyList, PColumnLazyUniversal, PColumnLazyWithLabel, PColumnPredicate, PColumnResourceMapData, PColumnResourceMapEntry, PFrameImpl, POCExtractAction, PTableKey, PTableParamsV2, type ParamsInput, Patch, PatternFilter, PatternPredicate, PatternPredicateContainSubsequence, PatternPredicateEquals, PlDataTableFilters, PlDataTableFiltersWithMeta, PlDataTableGridStateCore, PlDataTableModel, PlDataTableSheet, PlDataTableSheetState, PlDataTableStateV2, PlDataTableStateV2CacheEntry, PlDataTableStateV2Normalized, PlMultiSequenceAlignmentColorSchemeOption, PlMultiSequenceAlignmentModel, PlMultiSequenceAlignmentSettings, PlMultiSequenceAlignmentWidget, PlResourceEntry, PlSelectionModel, PlTableColumnId, PlTableColumnIdJson, Platforma, PlatformaApiVersion, PlatformaExtended, PlatformaFactory, PlatformaSDKVersion, PlatformaV1, PlatformaV2, PlatformaV3, type PluginConfig, type PluginData, PluginDataModel, PluginDataModelBuilder, type PluginFactory, PluginFactoryLike, PluginHandle, PluginInstance, PluginModel, type PluginName, type PluginOutputs, type PluginParams, type PluginRecord, type PluginRegistry, PluginRenderCtx, PrimitiveOrConfig, PrimitiveToCfg, RT_BINARY_PARTITIONED, RT_BINARY_SUPER_PARTITIONED, RT_JSON_PARTITIONED, RT_JSON_SUPER_PARTITIONED, RT_PARQUET_PARTITIONED, RT_PARQUET_SUPER_PARTITIONED, RT_RESOURCE_MAP, RT_RESOURCE_MAP_PARTITIONED, RelaxedAxisSelector, RelaxedColumnSelector, RelaxedRecord, RelaxedStringMatchers, RenderCtx, RenderCtxBase, RenderCtxLegacy, RenderFunction, RenderFunctionLegacy, ResolveCfgType, ResourceTraversalOps, ResourceType, ResultPool, ResultPoolColumnSnapshotProvider, SdkInfo, SimplifiedPColumnSpec, SimplifiedUniversalPColumnEntry, SnapshotColumnProvider, SortedCumulativeSum, Entry as SpecExtractorResult, StagingOutputs, StdCtx, StdCtxArgsOnly, StringMatcher, Trace, TransformedColumn, TreeNodeAccessor, TypeField, TypeFieldRecord, TypeForm, TypeToLiteral, TypedConfig, TypedConfigOrConfigLambda, TypedConfigOrString, UiState, Unionize, UniversalColumnOption, UnwrapFutureRef, ValueRank, type VersionedData, WithLabel, allPColumnsReady, and, collectCtxColumnSnapshotProviders, columnSelectorsToPredicate, compileAnnotationScript, compileFilter, compileFilters, convertFilterSpecsToExpressionSpecs, convertFilterUiToExpressionImpl, convertFilterUiToExpressions, convertOrParsePColumnData, createBlockStorage, createColumnSnapshot, createDefaultPTableParams, createPFrameForGraphs, createPlDataTable, createPlDataTableSheet, createPlDataTableStateV2, createPlDataTableV2, createPlDataTableV3, createPlSelectionModel, createReadyColumnData, createRowSelectionColumn, deriveDataFromStorage, deriveDistinctLabels, deriveLabels, distillFilterSpec, downgradeCfgOrLambda, enrichCompatible, extractArchiveAndGetURL, extractConfig, filterDataInfoEntries, filterSpecToSpecQueryExpr, flatten, fromPlOption, fromPlRef, getAllRelatedColumns, getAvailableWithLinkersAxes, getAxisUniqueValues, getBlobContent, getBlobContentAsJson, getBlobContentAsString, getColumnOrAxisValueLabelsId, getColumnSpecById, getColumnUniqueValues, getColumnsFull, getDownloadedBlobContent, getEnvironmentValue, getFromCfg, getImmediate, getImportProgress, getJsonField, getLastLogs, getLogHandle, getOnDemandBlobContent, getPartitionKeysList, getPlatformaApiVersion, getPluginData, getProgressLog, getProgressLogWithInfo, getRawPlatformaInstance, getRelatedColumns, getRequestColumnsFromSelectedSources, getResourceField, getResourceValueAsJson, getSingleColumnData, getStorageData, getUniquePartitionKeys, getUniqueSourceValuesWithLabels, ifDef, isBlockStorage, isColumnHidden, isColumnOptional, isColumnSnapshotProvider, isConfigLambda, isEmpty, isHiddenFromGraphColumn, isHiddenFromUIColumn, isPColumnReady, isPluginOutputKey, isolate, makeArray, makeObject, mapArrayValues, mapRecordValues, mapResourceFields, matchColumn, matchColumnSelectors, migrateBlockStorage, normalizeBlockStorage, normalizeSelectors, not, or, parsePColumnData, parseResourceMap, pluginOutputKey, pluginOutputPrefix, readOutput, registerFacadeCallbacks, toColumnSnapshotProvider, unreachable, updateStorageData, upgradePlDataTableStateV2, wrapOutputs, writeLabelsToSpecs };
+export { ActAnd, ActExtractArchiveAndGetURL, ActFlatten, ActGetBlobContent, ActGetBlobContentAsJson, ActGetBlobContentAsString, ActGetDownloadedBlobContent, ActGetField, ActGetFromCtx, ActGetImmediate, ActGetLastLogs, ActGetLogHandle, ActGetOnDemandBlobContent, ActGetProgressLog, ActGetProgressLogWithInfo, ActGetResourceField, ActGetResourceValueAsJson, ActImportProgress, ActIsEmpty, ActIsolate, ActMakeArray, ActMakeObject, ActMapArrayValues, ActMapRecordValues, ActMapResourceFields, ActNot, ActOr, ActionResult, AnchoredBuildOptions, AnchoredColumnCollection, AnchoredFindColumnsOptions, AndFilter, AnnotationFilter, AnnotationMode, AnnotationScript, AnnotationScript2, AnnotationScriptUi, AnnotationSpec, AnnotationSpecUi, AnnotationStep, AnnotationStepUi, AnyForm, Args, ArrayColumnProvider, AxesVault, AxisLabelProvider, BLOCK_STORAGE_FACADE_VERSION, BlockApiV1, BlockApiV2, BlockConfig, BlockConfigV3, BlockConfigV4, BlockModel, BlockModelInfo, BlockModelV3, BlockRenderCtx, BlockStatePatch, type BlockStorage, BlockStorageFacade, BlockStorageFacadeCallbacks, BlockStorageFacadeHandles, type BlockStorageSchemaVersion, BuildOptions, CancelSubscription, Cfg, CfgAnd, CfgBlobContent, CfgBlobContentAsJson, CfgBlobContentAsString, CfgDownloadedBlobContent, CfgExtractArchiveAndGetURL, CfgFlatten, CfgGetFromCtx, CfgGetJsonField, CfgGetResourceField, CfgImmediate, CfgImportProgress, CfgIsEmpty, CfgIsolate, CfgLastLogs, CfgLogHandle, CfgMakeArray, CfgMakeObject, CfgMapArrayValues, CfgMapRecordValues, CfgMapResourceFields, CfgNot, CfgOnDemandBlobContent, CfgOr, CfgProgressLog, CfgProgressLogWithInfo, CfgRenderingMode, CfgResourceValueAsJson, Checked, ColumnCollection, ColumnCollectionBuilder, ColumnData, ColumnDataStatus, ColumnMatch, ColumnProvider, ColumnSelectorInput, ColumnSnapshot, ColumnSnapshotProvider, ColumnSource, CommonFieldTraverseOps, CommonTraversalOps, ConfAction, ConfigRenderLambda, ConfigRenderLambdaFlags, ConfigResult, CurrentSdkInfo, DataModel, DataModelBuilder, DeriveHref, DeriveLabelsOptions, Entry, ExpressionSpec, ExtractAction, ExtractFunctionHandleReturn, ExtractFutureRefType, FieldTraversalStep, FieldType, FilterSpec, FilterSpecLeaf, FilterSpecNode, FilterSpecOfType, FilterSpecType, FilterSpecUi, FilterUi, FilterUiOfType, FilterUiType, FindColumnsOptions, FormField, FutureRef, GetFieldStep, InferArgsType, InferBlockState, InferBlockStatePatch, InferDataType, InferFactoryData, InferFactoryOutputs, InferFactoryParams, InferHrefType, InferOutputType, InferOutputsFromConfigs, InferOutputsFromLambdas, InferOutputsType, InferPluginData, InferPluginHandle, InferPluginHandles, InferPluginNames, InferRenderFunctionReturn, InferUiState, InferVarTypeSafe, IsNA, It, internal_d_exports as JsRenderInternal, DeriveLabelsOptions as LabelDerivationOps, Log10, MainOutputs, MatchQualifications, MatchVariant, MatchingMode, type MigrateBlockStorageConfig, type MigrationFailure, type MigrationResult, type MigrationSuccess, type MutateStoragePayload, NotFilter, NumericalComparisonFilter, OptionalPlResourceEntry, OrFilter, OutputColumnProvider, OutputColumnProviderOpts, OutputError, PColumnCollection, PColumnDataUniversal, PColumnEntryUniversal, PColumnEntryWithLabel, PColumnKeyList, PColumnLazyUniversal, PColumnLazyWithLabel, PColumnPredicate, PColumnResourceMapData, PColumnResourceMapEntry, PFrameImpl, POCExtractAction, PTableKey, PTableParamsV2, type ParamsInput, Patch, PatternFilter, PatternPredicate, PatternPredicateContainSubsequence, PatternPredicateEquals, PlDataTableFilters, PlDataTableFiltersWithMeta, PlDataTableGridStateCore, PlDataTableModel, PlDataTableSheet, PlDataTableSheetState, PlDataTableStateV2, PlDataTableStateV2CacheEntry, PlDataTableStateV2Normalized, PlMultiSequenceAlignmentColorSchemeOption, PlMultiSequenceAlignmentModel, PlMultiSequenceAlignmentSettings, PlMultiSequenceAlignmentWidget, PlResourceEntry, PlSelectionModel, PlTableColumnId, PlTableColumnIdJson, Platforma, PlatformaApiVersion, PlatformaExtended, PlatformaFactory, PlatformaSDKVersion, PlatformaV1, PlatformaV2, PlatformaV3, type PluginConfig, type PluginData, PluginDataModel, PluginDataModelBuilder, type PluginDataModelVersions, type PluginFactory, PluginFactoryLike, PluginHandle, PluginInstance, PluginModel, type PluginName, type PluginOutputs, type PluginParams, type PluginRecord, type PluginRegistry, PluginRenderCtx, PrimitiveOrConfig, PrimitiveToCfg, RT_BINARY_PARTITIONED, RT_BINARY_SUPER_PARTITIONED, RT_JSON_PARTITIONED, RT_JSON_SUPER_PARTITIONED, RT_PARQUET_PARTITIONED, RT_PARQUET_SUPER_PARTITIONED, RT_RESOURCE_MAP, RT_RESOURCE_MAP_PARTITIONED, RelaxedAxisSelector, RelaxedColumnSelector, RelaxedRecord, RelaxedStringMatchers, RenderCtx, RenderCtxBase, RenderCtxLegacy, RenderFunction, RenderFunctionLegacy, ResolveCfgType, ResourceTraversalOps, ResourceType, ResultPool, ResultPoolColumnSnapshotProvider, SdkInfo, SimplifiedPColumnSpec, SimplifiedUniversalPColumnEntry, SnapshotColumnProvider, SortedCumulativeSum, Entry as SpecExtractorResult, StagingOutputs, StdCtx, StdCtxArgsOnly, StringMatcher, Trace, TransformedColumn, TreeNodeAccessor, TypeField, TypeFieldRecord, TypeForm, TypeToLiteral, TypedConfig, TypedConfigOrConfigLambda, TypedConfigOrString, UiState, Unionize, UniversalColumnOption, UnwrapFutureRef, ValueRank, type VersionedData, WithLabel, allPColumnsReady, and, collectCtxColumnSnapshotProviders, columnSelectorsToPredicate, compileAnnotationScript, compileFilter, compileFilters, convertFilterSpecsToExpressionSpecs, convertFilterUiToExpressionImpl, convertFilterUiToExpressions, convertOrParsePColumnData, createBlockStorage, createColumnSnapshot, createDefaultPTableParams, createPFrameForGraphs, createPlDataTable, createPlDataTableSheet, createPlDataTableStateV2, createPlDataTableV2, createPlDataTableV3, createPlSelectionModel, createReadyColumnData, createRowSelectionColumn, deriveDataFromStorage, deriveDistinctLabels, deriveLabels, distillFilterSpec, downgradeCfgOrLambda, enrichCompatible, extractArchiveAndGetURL, extractConfig, filterDataInfoEntries, filterSpecToSpecQueryExpr, flatten, fromPlOption, fromPlRef, getAllRelatedColumns, getAvailableWithLinkersAxes, getAxisUniqueValues, getBlobContent, getBlobContentAsJson, getBlobContentAsString, getColumnOrAxisValueLabelsId, getColumnSpecById, getColumnUniqueValues, getColumnsFull, getDownloadedBlobContent, getEnvironmentValue, getFromCfg, getImmediate, getImportProgress, getJsonField, getLastLogs, getLogHandle, getOnDemandBlobContent, getPartitionKeysList, getPlatformaApiVersion, getPluginData, getProgressLog, getProgressLogWithInfo, getRawPlatformaInstance, getRelatedColumns, getRequestColumnsFromSelectedSources, getResourceField, getResourceValueAsJson, getSingleColumnData, getStorageData, getUniquePartitionKeys, getUniqueSourceValuesWithLabels, ifDef, isBlockStorage, isColumnHidden, isColumnOptional, isColumnSnapshotProvider, isConfigLambda, isEmpty, isHiddenFromGraphColumn, isHiddenFromUIColumn, isPColumnReady, isPluginOutputKey, isolate, makeArray, makeObject, mapArrayValues, mapRecordValues, mapResourceFields, matchColumn, matchColumnSelectors, migrateBlockStorage, normalizeBlockStorage, normalizeSelectors, not, or, parsePColumnData, parseResourceMap, pluginOutputKey, pluginOutputPrefix, readOutput, registerFacadeCallbacks, toColumnSnapshotProvider, unreachable, updateStorageData, upgradePlDataTableStateV2, wrapOutputs, writeLabelsToSpecs };

package/dist/package.cjs

@@ -1,6 +1,6 @@
 
 //#region package.json
-var version = "1.61.0";
+var version = "1.61.1";
 
 //#endregion
 Object.defineProperty(exports, 'version', {

package/dist/package.js

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

package/dist/platforma.d.ts

@@ -58,7 +58,9 @@ type InferPluginData<Pl, PluginId extends string> = Pl extends PlatformaV3<unkno
  * Uses the same brand structure as InferPluginHandle — only data/params/outputs, no config —
  * because PluginRecord doesn't carry Config (lost after factory.create()).
  */
-type InferPluginHandles<T extends Record<string, unknown>> = { readonly [K in keyof T]: T[K] extends PluginRecord<infer Data, infer Params, infer Outputs> ? PluginHandle<PluginFactoryLike<Data, Params, Outputs>> : never };
+type InferPluginHandles<T extends Record<string, unknown>> = { readonly [K in keyof T]: T[K] extends PluginRecord<infer Data, infer Params, infer Outputs> ? {
+  handle: PluginHandle<PluginFactoryLike<Data, Params, Outputs>>;
+} : never };
 //#endregion
 export { BlockModelInfo, InferArgsType, InferBlockState, InferBlockStatePatch, InferDataType, InferHrefType, InferOutputsType, InferPluginData, InferPluginHandles, InferPluginNames, InferUiState, Platforma, PlatformaApiVersion, PlatformaExtended, PlatformaFactory, PlatformaV1, PlatformaV2, PlatformaV3 };
 //# sourceMappingURL=platforma.d.ts.map

package/dist/plugin_model.cjs

@@ -180,8 +180,8 @@ function buildPluginDataModel(state, configInitFn) {
 var PluginInstance = class PluginInstance {
 	id;
 	transferVersion;
-	/** @internal */
-	__transferBrand;
+	/** @internal Phantom for type inference of Data/Params/Outputs; never set at runtime. */
+	__instanceTypes;
 	factory;
 	config;
 	constructor(id, factory, transferVersion, config) {
@@ -210,6 +210,8 @@ var PluginModel = class PluginModel {
 	dataModel;
 	/** Output definitions - functions that compute outputs from plugin context */
 	outputs;
+	/** Per-output flags (e.g. withStatus) */
+	outputFlags;
 	/** Feature flags declared by this plugin */
 	featureFlags;
 	/** Create fresh default data. Config (if any) is captured at creation time. */
@@ -218,6 +220,7 @@ var PluginModel = class PluginModel {
 		this.name = options.name;
 		this.dataModel = options.dataModel;
 		this.outputs = options.outputs;
+		this.outputFlags = options.outputFlags;
 		this.featureFlags = options.featureFlags;
 		this.getDefaultData = options.getDefaultData;
 	}
@@ -251,12 +254,14 @@ var PluginModelFactory = class PluginModelFactory {
 	dataFn;
 	getDefaultDataFn;
 	outputs;
+	outputFlags;
 	featureFlags;
 	constructor(options) {
 		this.name = options.name;
 		this.dataFn = options.dataFn;
 		this.getDefaultDataFn = options.getDefaultDataFn;
 		this.outputs = options.outputs;
+		this.outputFlags = options.outputFlags;
 		this.featureFlags = options.featureFlags;
 	}
 	/** @internal */
@@ -275,6 +280,7 @@ var PluginModelFactory = class PluginModelFactory {
 			name: this.name,
 			dataModel,
 			outputs: this.outputs,
+			outputFlags: this.outputFlags,
 			featureFlags: this.featureFlags,
 			getDefaultData: getDefaultDataFn ? () => getDefaultDataFn(config) : () => dataModel.getDefaultData()
 		});
@@ -304,12 +310,14 @@ var PluginModelBuilder = class PluginModelBuilder {
 	dataFn;
 	getDefaultDataFn;
 	outputs;
+	outputFlags;
 	featureFlags;
 	constructor(options) {
 		this.name = options.name;
 		this.dataFn = options.dataFn;
 		this.getDefaultDataFn = options.getDefaultDataFn;
 		this.outputs = options.outputs ?? {};
+		this.outputFlags = options.outputFlags ?? {};
 		this.featureFlags = options.featureFlags;
 	}
 	/** @internal */
@@ -336,6 +344,43 @@ var PluginModelBuilder = class PluginModelBuilder {
 			outputs: {
 				...this.outputs,
 				[key]: fn
+			},
+			outputFlags: {
+				...this.outputFlags,
+				[key]: { withStatus: false }
+			}
+		});
+	}
+	/**
+	* Adds an output wrapped with status information to the plugin.
+	*
+	* The UI receives the full {@link OutputWithStatus} object instead of an unwrapped value,
+	* allowing it to distinguish between pending, success, and error states.
+	*
+	* @param key - Output name
+	* @param fn - Function that computes the output value from plugin context
+	* @returns PluginModel with the new status-wrapped output added
+	*
+	* @example
+	* .outputWithStatus('table', (ctx) => {
+	*   const pCols = ctx.params.pFrame?.getPColumns();
+	*   if (pCols === undefined) return undefined;
+	*   return createPlDataTableV2(ctx, pCols, ctx.data.tableState);
+	* })
+	*/
+	outputWithStatus(key, fn) {
+		return new PluginModelBuilder({
+			name: this.name,
+			dataFn: this.dataFn,
+			getDefaultDataFn: this.getDefaultDataFn,
+			featureFlags: this.featureFlags,
+			outputs: {
+				...this.outputs,
+				[key]: fn
+			},
+			outputFlags: {
+				...this.outputFlags,
+				[key]: { withStatus: true }
 			}
 		});
 	}
@@ -358,6 +403,7 @@ var PluginModelBuilder = class PluginModelBuilder {
 			dataFn: this.dataFn,
 			getDefaultDataFn: this.getDefaultDataFn,
 			outputs: this.outputs,
+			outputFlags: this.outputFlags,
 			featureFlags: this.featureFlags
 		});
 	}