@platforma-sdk/model 1.61.1 → 1.63.0

package/dist/block_model.cjs

@@ -1,3 +1,4 @@
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_plugin_handle = require('./plugin_handle.cjs');
 const require_internal = require('./internal.cjs');
 const require_block_storage_facade = require('./block_storage_facade.cjs');
@@ -7,8 +8,10 @@ const require_version = require('./version.cjs');
 const require_types = require('./bconfig/types.cjs');
 const require_normalization = require('./bconfig/normalization.cjs');
 require('./bconfig/index.cjs');
+const require_block_services = require('./services/block_services.cjs');
 const require_plugin_model = require('./plugin_model.cjs');
 const require_block_storage_callbacks = require('./block_storage_callbacks.cjs');
+let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
 
 //#region src/block_model.ts
 /**
@@ -34,13 +37,16 @@ var BlockModelV3 = class BlockModelV3 {
 	constructor(config) {
 		this.config = config;
 	}
-	static INITIAL_BLOCK_FEATURE_FLAGS = {
+	static FEATURE_FLAGS = {
 		supportsLazyState: true,
 		supportsPframeQueryRanking: true,
 		requiresUIAPIVersion: 3,
 		requiresModelAPIVersion: require_block_storage_facade.BLOCK_STORAGE_FACADE_VERSION,
-		requiresCreatePTable: 2
+		requiresCreatePTable: 2,
+		...require_block_services.BLOCK_SERVICE_FLAGS
 	};
+	/** @deprecated Use FEATURE_FLAGS */
+	static INITIAL_BLOCK_FEATURE_FLAGS = BlockModelV3.FEATURE_FLAGS;
 	/**
 	* Creates a new BlockModelV3 builder with the specified data model.
 	*
@@ -69,7 +75,7 @@ var BlockModelV3 = class BlockModelV3 {
 			subtitle: void 0,
 			tags: void 0,
 			enrichmentTargets: void 0,
-			featureFlags: { ...BlockModelV3.INITIAL_BLOCK_FEATURE_FLAGS },
+			featureFlags: { ...BlockModelV3.FEATURE_FLAGS },
 			argsFunction: void 0,
 			prerunArgsFunction: void 0,
 			plugins: {}
@@ -82,7 +88,7 @@ var BlockModelV3 = class BlockModelV3 {
 				...this.config.outputs,
 				[key]: require_internal.createAndRegisterRenderLambda({
 					handle: `block-output#${key}`,
-					lambda: () => cfgOrRf(new require_api.BlockRenderCtx()),
+					lambda: () => cfgOrRf(new require_api.BlockRenderCtx(require_block_services.blockServiceNames)),
 					...flags
 				})
 			}
@@ -147,7 +153,7 @@ var BlockModelV3 = class BlockModelV3 {
 			...this.config,
 			sections: require_internal.createAndRegisterRenderLambda({
 				handle: "sections",
-				lambda: () => rf(new require_api.BlockRenderCtx())
+				lambda: () => rf(new require_api.BlockRenderCtx(require_block_services.blockServiceNames))
 			}, true)
 		});
 	}
@@ -157,7 +163,7 @@ var BlockModelV3 = class BlockModelV3 {
 			...this.config,
 			title: require_internal.createAndRegisterRenderLambda({
 				handle: "title",
-				lambda: () => rf(new require_api.BlockRenderCtx())
+				lambda: () => rf(new require_api.BlockRenderCtx(require_block_services.blockServiceNames))
 			})
 		});
 	}
@@ -166,7 +172,7 @@ var BlockModelV3 = class BlockModelV3 {
 			...this.config,
 			subtitle: require_internal.createAndRegisterRenderLambda({
 				handle: "subtitle",
-				lambda: () => rf(new require_api.BlockRenderCtx())
+				lambda: () => rf(new require_api.BlockRenderCtx(require_block_services.blockServiceNames))
 			})
 		});
 	}
@@ -175,7 +181,7 @@ var BlockModelV3 = class BlockModelV3 {
 			...this.config,
 			tags: require_internal.createAndRegisterRenderLambda({
 				handle: "tags",
-				lambda: () => rf(new require_api.BlockRenderCtx())
+				lambda: () => rf(new require_api.BlockRenderCtx(require_block_services.blockServiceNames))
 			})
 		});
 	}
@@ -237,6 +243,7 @@ var BlockModelV3 = class BlockModelV3 {
 		const pluginHandles = Object.keys(plugins);
 		for (const handle of pluginHandles) pluginRegistry[handle] = plugins[handle].model.name;
 		const { dataModel, argsFunction, prerunArgsFunction } = this.config;
+		const mergedServiceNames = (0, _milaboratories_pl_model_common.resolveRequiredServices)(this.config.featureFlags);
 		function getPlugin(handle) {
 			const plugin = plugins[handle];
 			if (!plugin) throw new Error(`Plugin model not found for '${handle}'`);
@@ -266,14 +273,14 @@ var BlockModelV3 = class BlockModelV3 {
 		for (const handle of pluginHandles) {
 			const { model, inputs } = plugins[handle];
 			const wrappedInputs = {};
-			for (const [paramKey, paramFn] of Object.entries(inputs)) wrappedInputs[paramKey] = () => paramFn(new require_api.BlockRenderCtx());
+			for (const [paramKey, paramFn] of Object.entries(inputs)) wrappedInputs[paramKey] = () => paramFn(new require_api.BlockRenderCtx(mergedServiceNames));
 			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, mergedServiceNames)),
 					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      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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"}
+{"version":3,"file":"block_model.cjs","names":["BLOCK_STORAGE_FACADE_VERSION","BLOCK_SERVICE_FLAGS","createAndRegisterRenderLambda","BlockRenderCtx","blockServiceNames","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 { resolveRequiredServices } from \"@milaboratories/pl-model-common\";\nimport { getPlatformaInstance, isInUI, createAndRegisterRenderLambda } from \"./internal\";\nimport type { DataModel } from \"./block_migrations\";\nimport type { PlatformaV3 } from \"./platforma\";\nimport type { BlockDefaultUiServices } from \"./services/service_resolve\";\nimport { blockServiceNames, BLOCK_SERVICE_FLAGS } from \"./services/block_services\";\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  ModelServices = unknown,\n  UiServices = unknown,\n> = {\n  readonly model: PluginModel<Data, Params, Outputs, ModelServices, UiServices>;\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 FEATURE_FLAGS = {\n    supportsLazyState: true,\n    supportsPframeQueryRanking: true,\n    requiresUIAPIVersion: 3,\n    requiresModelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n    requiresCreatePTable: 2,\n    ...BLOCK_SERVICE_FLAGS,\n  } satisfies BlockCodeKnownFeatureFlags;\n\n  /** @deprecated Use FEATURE_FLAGS */\n  public static readonly INITIAL_BLOCK_FEATURE_FLAGS = BlockModelV3.FEATURE_FLAGS;\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.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>(blockServiceNames)),\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          {\n            handle: \"sections\",\n            lambda: () => rf(new BlockRenderCtx<Args, Data>(blockServiceNames)),\n          },\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>(blockServiceNames)),\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>(blockServiceNames)),\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>(blockServiceNames)),\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    PluginModelServices,\n    PluginUiServices,\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      PluginModelServices,\n      PluginUiServices\n    >,\n    params?: ParamsInput<PParams, Args, Data>,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg,\n    Data,\n    Href,\n    Plugins & {\n      [K in PluginId]: PluginRecord<\n        PData,\n        PParams,\n        POutputs,\n        PluginModelServices,\n        PluginUiServices\n      >;\n    },\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<\n      Data,\n      Args,\n      InferOutputsFromLambdas<OutputsCfg>,\n      Href,\n      Plugins,\n      BlockDefaultUiServices\n    >\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    const mergedServiceNames = resolveRequiredServices(this.config.featureFlags);\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(mergedServiceNames));\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, mergedServiceNames)),\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.d.ts

@@ -2,6 +2,7 @@ import { DataModel } from "./block_migrations.js";
 import { ConfigRenderLambda, ConfigRenderLambdaFlags, InferOutputsFromLambdas } from "./bconfig/lambdas.js";
 import { DeriveHref } from "./bconfig/util.js";
 import "./bconfig/index.js";
+import { BlockDefaultUiServices } from "./services/service_resolve.js";
 import { InferRenderFunctionReturn, RenderCtxBase, RenderFunction } from "./render/api.js";
 import "./render/index.js";
 import { PluginData, PluginInstance, PluginModel, PluginOutputs, PluginParams } from "./plugin_model.js";
@@ -24,8 +25,8 @@ type ParamsInputErased = Record<string, (ctx: RenderCtxBase) => unknown>;
  * Plugin record: model + param derivation lambdas.
  * Type parameters are carried by PluginModel generic.
  */
-type PluginRecord<Data extends PluginData = PluginData, Params extends PluginParams = undefined, Outputs extends PluginOutputs = PluginOutputs> = {
-  readonly model: PluginModel<Data, Params, Outputs>;
+type PluginRecord<Data extends PluginData = PluginData, Params extends PluginParams = undefined, Outputs extends PluginOutputs = PluginOutputs, ModelServices = unknown, UiServices = unknown> = {
+  readonly model: PluginModel<Data, Params, Outputs, ModelServices, UiServices>;
   readonly inputs: ParamsInputErased;
 };
 /** Main entry point that each block should use in it's "config" module. Don't forget
@@ -35,7 +36,23 @@ type PluginRecord<Data extends PluginData = PluginData, Params extends PluginPar
 declare class BlockModelV3<Args, OutputsCfg extends Record<string, ConfigRenderLambda>, Data extends Record<string, unknown> = Record<string, unknown>, Href extends `/${string}` = "/", Plugins extends Record<string, PluginRecord> = {}, Transfers extends Record<string, unknown> = {}> {
   private readonly config;
   private constructor();
-  static readonly INITIAL_BLOCK_FEATURE_FLAGS: BlockCodeKnownFeatureFlags;
+  static readonly FEATURE_FLAGS: {
+    requiresPFrameSpec: true;
+    supportsLazyState: true;
+    supportsPframeQueryRanking: true;
+    requiresUIAPIVersion: number;
+    requiresModelAPIVersion: number;
+    requiresCreatePTable: number;
+  };
+  /** @deprecated Use FEATURE_FLAGS */
+  static readonly INITIAL_BLOCK_FEATURE_FLAGS: {
+    requiresPFrameSpec: true;
+    supportsLazyState: true;
+    supportsPframeQueryRanking: true;
+    requiresUIAPIVersion: number;
+    requiresModelAPIVersion: number;
+    requiresCreatePTable: number;
+  };
   /**
    * Creates a new BlockModelV3 builder with the specified data model.
    *
@@ -146,7 +163,7 @@ declare class BlockModelV3<Args, OutputsCfg extends Record<string, ConfigRenderL
    *   sourceId: (ctx) => ctx.data.selectedSource,
    * })
    */
-  plugin<const PluginId extends string, PData extends PluginData, PParams extends PluginParams, POutputs extends PluginOutputs, PTransferData>(instance: PluginInstance<PluginId & (PluginId extends keyof Transfers ? Transfers[PluginId] extends PTransferData ? string : never : [PTransferData] extends [never] ? string : never) & (PluginId extends keyof Plugins ? never : string), PData, PParams, POutputs, PTransferData>, params?: ParamsInput<PParams, Args, Data>): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins & { [K in PluginId]: PluginRecord<PData, PParams, POutputs> }, Omit<Transfers, PluginId>>;
+  plugin<const PluginId extends string, PData extends PluginData, PParams extends PluginParams, POutputs extends PluginOutputs, PTransferData, PluginModelServices, PluginUiServices>(instance: PluginInstance<PluginId & (PluginId extends keyof Transfers ? Transfers[PluginId] extends PTransferData ? string : never : [PTransferData] extends [never] ? string : never) & (PluginId extends keyof Plugins ? never : string), PData, PParams, POutputs, PTransferData, PluginModelServices, PluginUiServices>, params?: ParamsInput<PParams, Args, Data>): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins & { [K in PluginId]: PluginRecord<PData, PParams, POutputs, PluginModelServices, PluginUiServices> }, Omit<Transfers, PluginId>>;
   /** Renders all provided block settings into a pre-configured platforma API
    * instance, that can be used in frontend to interact with block data, and
    * other features provided by the platforma to the block.
@@ -156,7 +173,7 @@ declare class BlockModelV3<Args, OutputsCfg extends Record<string, ConfigRenderL
    * producing a compile error. Register all transferred plugins via `.plugin(instance)`
    * before calling `.done()`.
    */
-  done(..._: keyof Transfers extends never ? [] : [never]): PlatformaExtended<PlatformaV3<Data, Args, InferOutputsFromLambdas<OutputsCfg>, Href, Plugins>>;
+  done(..._: keyof Transfers extends never ? [] : [never]): PlatformaExtended<PlatformaV3<Data, Args, InferOutputsFromLambdas<OutputsCfg>, Href, Plugins, BlockDefaultUiServices>>;
 }
 //#endregion
 export { BlockModelV3, ParamsInput, PluginRecord };

package/dist/block_model.js

@@ -7,8 +7,10 @@ import { PlatformaSDKVersion } from "./version.js";
 import { isConfigLambda } from "./bconfig/types.js";
 import { downgradeCfgOrLambda } from "./bconfig/normalization.js";
 import "./bconfig/index.js";
+import { BLOCK_SERVICE_FLAGS, blockServiceNames } from "./services/block_services.js";
 import { CREATE_PLUGIN_MODEL } from "./plugin_model.js";
 import { applyStorageUpdate, createInitialStorage, deriveArgsFromStorage, derivePrerunArgsFromStorage, getStorageDebugView, migrateStorage } from "./block_storage_callbacks.js";
+import { resolveRequiredServices } from "@milaboratories/pl-model-common";
 
 //#region src/block_model.ts
 /**
@@ -34,13 +36,16 @@ var BlockModelV3 = class BlockModelV3 {
 	constructor(config) {
 		this.config = config;
 	}
-	static INITIAL_BLOCK_FEATURE_FLAGS = {
+	static FEATURE_FLAGS = {
 		supportsLazyState: true,
 		supportsPframeQueryRanking: true,
 		requiresUIAPIVersion: 3,
 		requiresModelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,
-		requiresCreatePTable: 2
+		requiresCreatePTable: 2,
+		...BLOCK_SERVICE_FLAGS
 	};
+	/** @deprecated Use FEATURE_FLAGS */
+	static INITIAL_BLOCK_FEATURE_FLAGS = BlockModelV3.FEATURE_FLAGS;
 	/**
 	* Creates a new BlockModelV3 builder with the specified data model.
 	*
@@ -69,7 +74,7 @@ var BlockModelV3 = class BlockModelV3 {
 			subtitle: void 0,
 			tags: void 0,
 			enrichmentTargets: void 0,
-			featureFlags: { ...BlockModelV3.INITIAL_BLOCK_FEATURE_FLAGS },
+			featureFlags: { ...BlockModelV3.FEATURE_FLAGS },
 			argsFunction: void 0,
 			prerunArgsFunction: void 0,
 			plugins: {}
@@ -82,7 +87,7 @@ var BlockModelV3 = class BlockModelV3 {
 				...this.config.outputs,
 				[key]: createAndRegisterRenderLambda({
 					handle: `block-output#${key}`,
-					lambda: () => cfgOrRf(new BlockRenderCtx()),
+					lambda: () => cfgOrRf(new BlockRenderCtx(blockServiceNames)),
 					...flags
 				})
 			}
@@ -147,7 +152,7 @@ var BlockModelV3 = class BlockModelV3 {
 			...this.config,
 			sections: createAndRegisterRenderLambda({
 				handle: "sections",
-				lambda: () => rf(new BlockRenderCtx())
+				lambda: () => rf(new BlockRenderCtx(blockServiceNames))
 			}, true)
 		});
 	}
@@ -157,7 +162,7 @@ var BlockModelV3 = class BlockModelV3 {
 			...this.config,
 			title: createAndRegisterRenderLambda({
 				handle: "title",
-				lambda: () => rf(new BlockRenderCtx())
+				lambda: () => rf(new BlockRenderCtx(blockServiceNames))
 			})
 		});
 	}
@@ -166,7 +171,7 @@ var BlockModelV3 = class BlockModelV3 {
 			...this.config,
 			subtitle: createAndRegisterRenderLambda({
 				handle: "subtitle",
-				lambda: () => rf(new BlockRenderCtx())
+				lambda: () => rf(new BlockRenderCtx(blockServiceNames))
 			})
 		});
 	}
@@ -175,7 +180,7 @@ var BlockModelV3 = class BlockModelV3 {
 			...this.config,
 			tags: createAndRegisterRenderLambda({
 				handle: "tags",
-				lambda: () => rf(new BlockRenderCtx())
+				lambda: () => rf(new BlockRenderCtx(blockServiceNames))
 			})
 		});
 	}
@@ -237,6 +242,7 @@ var BlockModelV3 = class BlockModelV3 {
 		const pluginHandles = Object.keys(plugins);
 		for (const handle of pluginHandles) pluginRegistry[handle] = plugins[handle].model.name;
 		const { dataModel, argsFunction, prerunArgsFunction } = this.config;
+		const mergedServiceNames = resolveRequiredServices(this.config.featureFlags);
 		function getPlugin(handle) {
 			const plugin = plugins[handle];
 			if (!plugin) throw new Error(`Plugin model not found for '${handle}'`);
@@ -266,14 +272,14 @@ var BlockModelV3 = class BlockModelV3 {
 		for (const handle of pluginHandles) {
 			const { model, inputs } = plugins[handle];
 			const wrappedInputs = {};
-			for (const [paramKey, paramFn] of Object.entries(inputs)) wrappedInputs[paramKey] = () => paramFn(new BlockRenderCtx());
+			for (const [paramKey, paramFn] of Object.entries(inputs)) wrappedInputs[paramKey] = () => paramFn(new BlockRenderCtx(mergedServiceNames));
 			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, mergedServiceNames)),
 					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      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":";;;;;;;;;;;;;;;;;;AAgEA,SAAS,kBACP,MACA,UAC4B;CAC5B,MAAM,SAAuD,EAAE,GAAG,MAAM;AACxE,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,EAAE;AACnD,MAAI,UAAU,OAAW;EACzB,MAAM,WAAW,OAAO;AACxB,MAAI,OAAO,UAAU,UACnB,QAAO,OAAQ,OAAO,aAAa,aAAa,YAAa;WACpD,OAAO,UAAU,SAC1B,QAAO,OAAO,KAAK,IAAI,OAAO,aAAa,WAAW,WAAW,GAAG,MAAM;;AAG9E,QAAO;;;;;;AAwCT,IAAa,eAAb,MAAa,aAOX;CACA,AAAQ,YACN,AAAiB,QACjB;EADiB;;CAGnB,OAAuB,8BAA0D;EAC/E,mBAAmB;EACnB,4BAA4B;EAC5B,sBAAsB;EACtB,yBAAyB;EACzB,sBAAsB;EACvB;;;;;;;;;;;;;;;;CAiBD,OAAc,OAGZ,WAAyF;AACzF,SAAO,IAAI,aAAiD;GAC1D,eAAe;GACf;GACA,SAAS,EAAE;GACX,UAAU,8BAA8B;IAAE,QAAQ;IAAY,cAAc,EAAE;IAAE,EAAE,KAAK;GACvF,OAAO;GACP,UAAU;GACV,MAAM;GACN,mBAAmB;GACnB,cAAc,EAAE,GAAG,aAAa,6BAA6B;GAC7D,cAAc;GACd,oBAAoB;GACpB,SAAS,EAAE;GACZ,CAAC;;CAiDJ,AAAO,OACL,KACA,SACA,QAAiC,EAAE,EAC6B;AAChE,SAAO,IAAI,aAAa;GACtB,GAAG,KAAK;GACR,SAAS;IACP,GAAG,KAAK,OAAO;KACd,MAAM,8BAA8B;KACnC,QAAQ,gBAAgB;KACxB,cAAc,QAAQ,IAAI,gBAA4B,CAAC;KACvD,GAAG;KACJ,CAAC;IACH;GACF,CAAC;;;CAIJ,AAAO,gBAIL,KACA,IAUA;AACA,SAAO,KAAK,OAAO,KAAK,IAAI,EAAE,WAAW,MAAM,CAAC;;;CAIlD,AAAO,iBAGL,KAAU,IAAQ;AAClB,SAAO,KAAK,OAAO,KAAK,IAAI,EAAE,YAAY,MAAM,CAAC;;;;;;;;;;;;;;;CAgBnD,AAAO,KACL,QAC6D;AAC7D,SAAO,IAAI,aAA4D;GACrE,GAAG,KAAK;GACR,cAAc;GACf,CAAC;;;;;;;;;;;;;;;;;;;;;;CAuBJ,AAAO,WACL,IACgE;AAChE,SAAO,IAAI,aAA+D;GACxE,GAAG,KAAK;GACR,oBAAoB;GACrB,CAAC;;;CAIJ,AAAO,SAGL,IAA8F;AAC9F,SAAO,IAAI,aACT;GACE,GAAG,KAAK;GAER,UAAU,8BACR;IAAE,QAAQ;IAAY,cAAc,GAAG,IAAI,gBAA4B,CAAC;IAAE,EAC1E,KACD;GACF,CACF;;;CAIH,AAAO,MACL,IACgE;AAChE,SAAO,IAAI,aAA+D;GACxE,GAAG,KAAK;GACR,OAAO,8BAA8B;IACnC,QAAQ;IACR,cAAc,GAAG,IAAI,gBAA4B,CAAC;IACnD,CAAC;GACH,CAAC;;CAGJ,AAAO,SACL,IACgE;AAChE,SAAO,IAAI,aAA+D;GACxE,GAAG,KAAK;GACR,UAAU,8BAA8B;IACtC,QAAQ;IACR,cAAc,GAAG,IAAI,gBAA4B,CAAC;IACnD,CAAC;GACH,CAAC;;CAGJ,AAAO,KACL,IACgE;AAChE,SAAO,IAAI,aAA+D;GACxE,GAAG,KAAK;GACR,MAAM,8BAA8B;IAClC,QAAQ;IACR,cAAc,GAAG,IAAI,gBAA4B,CAAC;IACnD,CAAC;GACH,CAAC;;;CAIJ,AAAO,iBACL,OACgE;AAChE,SAAO,IAAI,aAA+D;GACxE,GAAG,KAAK;GACR,cAAc;IAAE,GAAG,KAAK,OAAO;IAAc,GAAG;IAAO;GACxD,CAAC;;;;;;CAOJ,AAAO,SACL,QACgE;AAChE,SAAO,IAAI,aAA+D;GACxE,GAAG,KAAK;GACR,mBAAmB,8BAA8B;IAC/C,QAAQ;IACA;IACT,CAAC;GACH,CAAC;;CAoDJ,AAAO,OACL,UACA,QAQA;EACA,MAAM,WAAW,SAAS;EAC1B,MAAM,SAAS,SAAS,sBAAsB;EAC9C,MAAM,iBAAkB,UAAU,EAAE;AAEpC,MAAI,YAAY,KAAK,OAAO,QAC1B,OAAM,IAAI,MAAM,WAAW,SAAS,sBAAsB;EAG5D,MAAM,aAA2B;GAC/B,OAAO;GACP,QAAQ;GACT;AAED,SAAO,IAAI,aAAa;GACtB,GAAG,KAAK;GACR,SAAS;IACP,GAAG,KAAK,OAAO;KACd,WAAW;IACb;GACD,cAAc,kBAAkB,KAAK,OAAO,cAAc,OAAO,gBAAgB,EAAE,CAAC;GACrF,CAAC;;;;;;;;;;;CAYJ,AAAO,KACL,GAAG,GAGH;AACA,MAAI,KAAK,OAAO,iBAAiB,OAAW,OAAM,IAAI,MAAM,mCAAmC;EAE/F,MAAM,aAAa;EAGnB,MAAM,EAAE,YAAY,KAAK;EACzB,MAAM,iBAA6C,EAAE;EACrD,MAAM,gBAAgB,OAAO,KAAK,QAAQ;AAC1C,OAAK,MAAM,UAAU,cACnB,gBAAe,UAAU,QAAQ,QAAQ,MAAM;EAGjD,MAAM,EAAE,WAAW,cAAc,uBAAuB,KAAK;EAE7D,SAAS,UAAU,QAAoC;GACrD,MAAM,SAAS,QAAQ;AACvB,OAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,+BAA+B,OAAO,GAAG;AACtE,UAAO;;AAIT,0BAAwB;IACrB,4BAA4B,qBAAqB;IACjD,4BAA4B,mBAAmB;IAC/C,4BAA4B,kBAAkB,uBAC7C,eAAe,oBAAoB;IACjC,mBAAmB,MAAM,UAAU,QAAQ,EAAE;IAC7C,yBAAyB;IACzB,oBAAoB,QAAQ,MAAM,UAAU,OAAO,CAAC,MAAM,UAAU,QAAQ,EAAE;IAC9E,mBAAmB,QAAQ,aAAa;AACtC,SAAI,SAAU,QAAO;AACrB,YAAO,UAAU,OAAO,CAAC,MAAM,gBAAgB;;IAElD,CAAC;IACH,4BAA4B,uBAC3B,qBAAqB;IACnB,2BAA2B,UAAU,gBAAgB;IACrD,yBAAyB;IACzB,mBAAmB,WAAW,UAAU,OAAO,CAAC,MAAM,gBAAgB;IACvE,CAAC;IACH,4BAA4B,cAAc,gBACzC,sBAAsB,aAAa,aAAa;IACjD,4BAA4B,oBAAoB,gBAC/C,4BAA4B,aAAa,cAAc,mBAAmB;GAC7E,CAAC;EAGF,MAAM,gBAAoD,EAAE;AAC5D,OAAK,MAAM,UAAU,eAAe;GAClC,MAAM,EAAE,OAAO,WAAW,QAAQ;GAElC,MAAM,gBAA+C,EAAE;AACvD,QAAK,MAAM,CAAC,UAAU,YAAY,OAAO,QAAQ,OAAO,CACtD,eAAc,kBAAkB,QAAQ,IAAI,gBAAgB,CAAC;GAI/D,MAAM,UAAU,MAAM;GACtB,MAAM,EAAE,gBAAgB;AACxB,QAAK,MAAM,CAAC,WAAW,aAAa,OAAO,QAAQ,QAAQ,EAAE;IAC3D,MAAM,MAAM,gBAAgB,QAAQ,UAAU;AAC9C,kBAAc,OAAO,8BAA8B;KACjD,QAAQ;KACR,cAAc,SAAS,IAAI,gBAAgB,QAAQ,cAAc,CAAC;KAClE,YAAY,YAAY,YAAY;KACrC,CAAC;;;EAGN,MAAM,aAAa;GAAE,GAAG,KAAK,OAAO;GAAS,GAAG;GAAe;AAE/D,aAAW,sBAAsB;AAEjC,MAAI,CAAC,QAAQ,CA6BX,QAAO,EAAE,QA5BiC;GACxC,IAAI;IACF,eAAe;IACf,iBAAiB;IACjB,YAAY;IACZ,eAAe,KAAK,OAAO;IAC3B,UAAU,KAAK,OAAO;IACtB,OAAO,KAAK,OAAO;IACnB,UAAU,KAAK,OAAO;IACtB,MAAM,KAAK,OAAO;IAClB,SAAS;IACT,mBAAmB,KAAK,OAAO;IAC/B,cAAc,KAAK,OAAO;IAC1B,yBAAyB,EAAE,GAAG,2BAA2B;IAC1D;GAGD,YAAY;GACZ,eAAe,KAAK,OAAO;GAC3B,UAAU,KAAK,OAAO;GACtB,SAAS,OAAO,YACd,OAAO,QAAQ,KAAK,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,WAAW,CACxD,KACA,qBAAqB,MAAM,CAC5B,CAAC,CACH;GACF,EAE6B;MAG9B,QAAO;GACL,GAAG,qBAAqB;IACtB,YAAY;IACZ;IACD,CAAC;GACF,gBAAgB;IACd,SAAS,OAAO,YACd,OAAO,QAAQ,WAAW,CAAC,KAAK,CAAC,KAAK,WAAW,CAC/C,KACA,EACE,YAAY,QAAQ,eAAe,MAAM,IAAI,MAAM,WAAW,EAC/D,CACF,CAAC,CACH;IACD,WAAW;IACX,cAAc,KAAK,OAAO;IAC3B;GACF"}
+{"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 { resolveRequiredServices } from \"@milaboratories/pl-model-common\";\nimport { getPlatformaInstance, isInUI, createAndRegisterRenderLambda } from \"./internal\";\nimport type { DataModel } from \"./block_migrations\";\nimport type { PlatformaV3 } from \"./platforma\";\nimport type { BlockDefaultUiServices } from \"./services/service_resolve\";\nimport { blockServiceNames, BLOCK_SERVICE_FLAGS } from \"./services/block_services\";\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  ModelServices = unknown,\n  UiServices = unknown,\n> = {\n  readonly model: PluginModel<Data, Params, Outputs, ModelServices, UiServices>;\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 FEATURE_FLAGS = {\n    supportsLazyState: true,\n    supportsPframeQueryRanking: true,\n    requiresUIAPIVersion: 3,\n    requiresModelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n    requiresCreatePTable: 2,\n    ...BLOCK_SERVICE_FLAGS,\n  } satisfies BlockCodeKnownFeatureFlags;\n\n  /** @deprecated Use FEATURE_FLAGS */\n  public static readonly INITIAL_BLOCK_FEATURE_FLAGS = BlockModelV3.FEATURE_FLAGS;\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.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>(blockServiceNames)),\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          {\n            handle: \"sections\",\n            lambda: () => rf(new BlockRenderCtx<Args, Data>(blockServiceNames)),\n          },\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>(blockServiceNames)),\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>(blockServiceNames)),\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>(blockServiceNames)),\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    PluginModelServices,\n    PluginUiServices,\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      PluginModelServices,\n      PluginUiServices\n    >,\n    params?: ParamsInput<PParams, Args, Data>,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg,\n    Data,\n    Href,\n    Plugins & {\n      [K in PluginId]: PluginRecord<\n        PData,\n        PParams,\n        POutputs,\n        PluginModelServices,\n        PluginUiServices\n      >;\n    },\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<\n      Data,\n      Args,\n      InferOutputsFromLambdas<OutputsCfg>,\n      Href,\n      Plugins,\n      BlockDefaultUiServices\n    >\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    const mergedServiceNames = resolveRequiredServices(this.config.featureFlags);\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(mergedServiceNames));\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, mergedServiceNames)),\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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"}