@platforma-sdk/model 1.63.1 → 1.63.12

package/dist/block_model_legacy.cjs

@@ -1,13 +1,12 @@
-const require_internal = require('./internal.cjs');
-const require_actions = require('./config/actions.cjs');
-require('./config/index.cjs');
-const require_api = require('./render/api.cjs');
-require('./render/index.cjs');
-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_internal = require("./internal.cjs");
+const require_actions = require("./config/actions.cjs");
+require("./config/index.cjs");
+const require_api = require("./render/api.cjs");
+require("./render/index.cjs");
+const require_version = require("./version.cjs");
+const require_types = require("./bconfig/types.cjs");
+const require_normalization = require("./bconfig/normalization.cjs");
+require("./bconfig/index.cjs");
 //#region src/block_model_legacy.ts
 /** Main entry point that each block should use in it's "config" module. Don't forget
 * to call {@link done()} at the end of configuration. Value returned by this builder must be
@@ -231,7 +230,7 @@ var BlockModel = class BlockModel {
 		};
 	}
 };
-
 //#endregion
 exports.BlockModel = BlockModel;
+
 //# sourceMappingURL=block_model_legacy.cjs.map

package/dist/block_model_legacy.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"block_model_legacy.cjs","names":["getImmediate","RenderCtxLegacy","#done","PlatformaSDKVersion","downgradeCfgOrLambda","isInUI","getPlatformaInstance","isConfigLambda"],"sources":["../src/block_model_legacy.ts"],"sourcesContent":["import type {\n  BlockRenderingMode,\n  BlockSection,\n  AnyFunction,\n  PlRef,\n  BlockCodeKnownFeatureFlags,\n  BlockConfigContainer,\n} from \"@milaboratories/pl-model-common\";\nimport type { Checked, ConfigResult, TypedConfig } from \"./config\";\nimport { getImmediate } from \"./config\";\nimport { getPlatformaInstance, isInUI, tryRegisterCallback } from \"./internal\";\nimport type { Platforma, PlatformaApiVersion, PlatformaV1, PlatformaV2 } from \"./platforma\";\nimport type { InferRenderFunctionReturn, RenderFunctionLegacy } from \"./render\";\nimport { RenderCtxLegacy } from \"./render\";\nimport { PlatformaSDKVersion } from \"./version\";\nimport type {\n  TypedConfigOrConfigLambda,\n  ConfigRenderLambda,\n  StdCtxArgsOnly,\n  DeriveHref,\n  ConfigRenderLambdaFlags,\n  InferOutputsFromConfigs,\n} from \"./bconfig\";\nimport { downgradeCfgOrLambda, isConfigLambda } from \"./bconfig\";\nimport type { PlatformaExtended } from \"./platforma\";\n\ntype SectionsExpectedType = readonly BlockSection[];\n\ntype SectionsCfgChecked<Cfg extends TypedConfig, Args, UiState> = Checked<\n  Cfg,\n  ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>> extends SectionsExpectedType ? true : false\n>;\n\ntype InputsValidExpectedType = boolean;\n\ntype InputsValidCfgChecked<Cfg extends TypedConfig, Args, UiState> = Checked<\n  Cfg,\n  ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>> extends InputsValidExpectedType ? true : false\n>;\n\ntype NoOb = Record<string, never>;\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. */\nexport class BlockModel<\n  Args,\n  OutputsCfg extends Record<string, TypedConfigOrConfigLambda>,\n  UiState,\n  Href extends `/${string}` = \"/\",\n> {\n  private constructor(\n    private config: {\n      readonly renderingMode: BlockRenderingMode;\n      readonly initialArgs?: Args;\n      readonly initialUiState: UiState;\n      readonly outputs: OutputsCfg;\n      readonly inputsValid: TypedConfigOrConfigLambda;\n      readonly sections: TypedConfigOrConfigLambda;\n      readonly title?: ConfigRenderLambda;\n      readonly subtitle?: ConfigRenderLambda;\n      readonly tags?: ConfigRenderLambda;\n      readonly enrichmentTargets?: ConfigRenderLambda;\n      readonly featureFlags: BlockCodeKnownFeatureFlags;\n    },\n  ) {}\n\n  public static get INITIAL_BLOCK_FEATURE_FLAGS(): BlockCodeKnownFeatureFlags {\n    return {\n      supportsLazyState: true,\n      supportsPframeQueryRanking: true,\n      requiresUIAPIVersion: 1,\n      requiresModelAPIVersion: 1,\n      requiresCreatePTable: 2,\n    };\n  }\n\n  /** Initiates configuration builder */\n  public static create(renderingMode: BlockRenderingMode): BlockModel<NoOb, {}, NoOb>;\n  /** Initiates configuration builder */\n  public static create(): BlockModel<NoOb, {}, NoOb>;\n  /**\n   * Initiates configuration builder\n   * @deprecated use create method without generic parameter\n   */\n  public static create<Args>(renderingMode: BlockRenderingMode): BlockModel<Args, {}, NoOb>;\n  /**\n   * Initiates configuration builder\n   * @deprecated use create method without generic parameter\n   */\n  public static create<Args>(): BlockModel<Args, {}, NoOb>;\n  public static create(renderingMode: BlockRenderingMode = \"Heavy\"): BlockModel<NoOb, {}, NoOb> {\n    return new BlockModel<NoOb, {}, NoOb>({\n      renderingMode,\n      initialUiState: {},\n      outputs: {},\n      inputsValid: getImmediate(true),\n      sections: getImmediate([]),\n      featureFlags: BlockModel.INITIAL_BLOCK_FEATURE_FLAGS,\n    });\n  }\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 cfg configuration describing how to render cell value from the blocks\n   *            workflow outputs\n   * @deprecated use lambda-based API\n   * */\n  public output<const Key extends string, const Cfg extends TypedConfig>(\n    key: Key,\n    cfg: Cfg,\n  ): BlockModel<Args, OutputsCfg & { [K in Key]: Cfg }, UiState, Href>;\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 RenderFunctionLegacy<Args, UiState>>(\n    key: Key,\n    rf: RF,\n    flags: ConfigRenderLambdaFlags & { withStatus: true },\n  ): BlockModel<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> & { withStatus: true };\n    },\n    UiState,\n    Href\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 RenderFunctionLegacy<Args, UiState>>(\n    key: Key,\n    rf: RF,\n    flags?: ConfigRenderLambdaFlags,\n  ): BlockModel<\n    Args,\n    OutputsCfg & { [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> },\n    UiState,\n    Href\n  >;\n  public output(\n    key: string,\n    cfgOrRf: TypedConfig | AnyFunction,\n    flags: ConfigRenderLambdaFlags = {},\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    if (typeof cfgOrRf === \"function\") {\n      const handle = `output#${key}`;\n      tryRegisterCallback(handle, () => cfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel({\n        ...this.config,\n        outputs: {\n          ...this.config.outputs,\n          [key]: {\n            __renderLambda: true,\n            handle,\n            ...flags,\n          },\n        },\n      });\n    } else {\n      return new BlockModel({\n        ...this.config,\n        outputs: {\n          ...this.config.outputs,\n          [key]: cfgOrRf,\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 RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\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 RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { withStatus: true });\n  }\n\n  /** Shortcut for {@link output} with retentive and withStatus flags set to true. */\n  public retentiveOutputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { retentive: true, withStatus: true });\n  }\n\n  /** Sets custom configuration predicate on the block args at which block can be executed\n   * @deprecated use lambda-based API */\n  public argsValid<Cfg extends TypedConfig>(\n    cfg: Cfg & InputsValidCfgChecked<Cfg, Args, UiState>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href>;\n  /** Sets custom configuration predicate on the block args at which block can be executed */\n  public argsValid<RF extends RenderFunctionLegacy<Args, UiState, boolean>>(\n    rf: RF,\n  ): BlockModel<Args, OutputsCfg, UiState, Href>;\n  public argsValid(\n    cfgOrRf: TypedConfig | AnyFunction,\n  ): BlockModel<Args, OutputsCfg, UiState, `/${string}`> {\n    if (typeof cfgOrRf === \"function\") {\n      tryRegisterCallback(\"inputsValid\", () => cfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        inputsValid: {\n          __renderLambda: true,\n          handle: \"inputsValid\",\n        },\n      });\n    } else {\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        inputsValid: cfgOrRf,\n      });\n    }\n  }\n\n  /** Sets the config to generate list of section in the left block overviews panel\n   * @deprecated use lambda-based API */\n  public sections<const S extends SectionsExpectedType>(\n    rf: S,\n  ): BlockModel<Args, OutputsCfg, UiState, DeriveHref<S>>;\n  /** Sets the config to generate list of section in the left block overviews panel */\n  public sections<\n    const Ret extends SectionsExpectedType,\n    const RF extends RenderFunctionLegacy<Args, UiState, Ret>,\n  >(rf: RF): BlockModel<Args, OutputsCfg, UiState, DeriveHref<ReturnType<RF>>>;\n  public sections<const Cfg extends TypedConfig>(\n    cfg: Cfg & SectionsCfgChecked<Cfg, Args, UiState>,\n  ): BlockModel<\n    Args,\n    OutputsCfg,\n    UiState,\n    DeriveHref<ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>>>\n  >;\n  public sections(\n    arrOrCfgOrRf: SectionsExpectedType | TypedConfig | AnyFunction,\n  ): BlockModel<Args, OutputsCfg, UiState, `/${string}`> {\n    if (Array.isArray(arrOrCfgOrRf)) {\n      return this.sections(getImmediate(arrOrCfgOrRf));\n    } else if (typeof arrOrCfgOrRf === \"function\") {\n      tryRegisterCallback(\"sections\", () => arrOrCfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        sections: {\n          __renderLambda: true,\n          handle: \"sections\",\n        },\n      });\n    } else {\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        sections: arrOrCfgOrRf as TypedConfig,\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: RenderFunctionLegacy<Args, UiState, string>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"title\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      title: {\n        __renderLambda: true,\n        handle: \"title\",\n      },\n    });\n  }\n\n  public subtitle(\n    rf: RenderFunctionLegacy<Args, UiState, string>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"subtitle\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      subtitle: {\n        __renderLambda: true,\n        handle: \"subtitle\",\n      },\n    });\n  }\n\n  public tags(\n    rf: RenderFunctionLegacy<Args, UiState, string[]>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"tags\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      tags: {\n        __renderLambda: true,\n        handle: \"tags\",\n      },\n    });\n  }\n\n  /**\n   * Sets initial args for the block, this value must be specified.\n   * @deprecated use {@link withArgs}\n   * */\n  public initialArgs(value: Args): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return this.withArgs(value);\n  }\n\n  /** Sets initial args for the block, this value must be specified. */\n  public withArgs<Args>(initialArgs: Args): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      initialArgs,\n    });\n  }\n\n  /** Defines type and sets initial value for block UiState. */\n  public withUiState<UiState>(\n    initialUiState: UiState,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      initialUiState,\n    });\n  }\n\n  /** Sets or overrides feature flags for the block. */\n  public withFeatureFlags(\n    flags: Partial<BlockCodeKnownFeatureFlags>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      featureFlags: {\n        ...this.config.featureFlags,\n        ...flags,\n      },\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(lambda: (args: Args) => PlRef[]): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"enrichmentTargets\", lambda);\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      enrichmentTargets: {\n        __renderLambda: true,\n        handle: \"enrichmentTargets\",\n      },\n    });\n  }\n\n  public done(\n    apiVersion?: 1,\n  ): PlatformaExtended<\n    PlatformaV1<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  >;\n\n  public done(\n    apiVersion: 2,\n  ): PlatformaExtended<\n    PlatformaV2<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\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 state, and\n   * other features provided by the platforma to the block. */\n  public done(\n    apiVersion: PlatformaApiVersion = 1,\n  ): PlatformaExtended<\n    Platforma<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  > {\n    return this.withFeatureFlags({\n      ...this.config.featureFlags,\n      requiresUIAPIVersion: apiVersion,\n    }).#done();\n  }\n\n  #done(): PlatformaExtended<\n    Platforma<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  > {\n    if (this.config.initialArgs === undefined) throw new Error(\"Initial arguments not set.\");\n\n    const config: BlockConfigContainer = {\n      v4: undefined,\n      v3: {\n        configVersion: 3,\n        modelAPIVersion: 1,\n        sdkVersion: PlatformaSDKVersion,\n        renderingMode: this.config.renderingMode,\n        initialArgs: this.config.initialArgs,\n        initialUiState: this.config.initialUiState,\n        inputsValid: this.config.inputsValid,\n        sections: this.config.sections,\n        title: this.config.title,\n        subtitle: this.config.subtitle,\n        tags: this.config.tags,\n        outputs: this.config.outputs,\n        enrichmentTargets: this.config.enrichmentTargets,\n        featureFlags: this.config.featureFlags,\n      },\n\n      // fields below are added to allow previous desktop versions read generated configs\n      sdkVersion: PlatformaSDKVersion,\n      renderingMode: this.config.renderingMode,\n      initialArgs: this.config.initialArgs,\n      inputsValid: downgradeCfgOrLambda(this.config.inputsValid),\n      sections: downgradeCfgOrLambda(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\n    globalThis.platformaApiVersion = this.config.featureFlags\n      .requiresUIAPIVersion as PlatformaApiVersion;\n\n    if (!isInUI()) {\n      // we are in the configuration rendering routine, not in actual UI\n      return { config } as any;\n    } else {\n      // normal operation inside the UI\n      return {\n        ...getPlatformaInstance({\n          sdkVersion: PlatformaSDKVersion,\n          apiVersion: platformaApiVersion,\n        }),\n        blockModelInfo: {\n          outputs: Object.fromEntries(\n            Object.entries(this.config.outputs).map(([key, value]) => [\n              key,\n              {\n                withStatus: Boolean(isConfigLambda(value) && value.withStatus),\n              },\n            ]),\n          ),\n          pluginIds: [],\n          featureFlags: this.config.featureFlags,\n        },\n      };\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"block_model_legacy.cjs","names":["getImmediate","RenderCtxLegacy","#done","PlatformaSDKVersion","downgradeCfgOrLambda","isInUI","getPlatformaInstance","isConfigLambda"],"sources":["../src/block_model_legacy.ts"],"sourcesContent":["import type {\n  BlockRenderingMode,\n  BlockSection,\n  AnyFunction,\n  PlRef,\n  BlockCodeKnownFeatureFlags,\n  BlockConfigContainer,\n} from \"@milaboratories/pl-model-common\";\nimport type { Checked, ConfigResult, TypedConfig } from \"./config\";\nimport { getImmediate } from \"./config\";\nimport { getPlatformaInstance, isInUI, tryRegisterCallback } from \"./internal\";\nimport type { Platforma, PlatformaApiVersion, PlatformaV1, PlatformaV2 } from \"./platforma\";\nimport type { InferRenderFunctionReturn, RenderFunctionLegacy } from \"./render\";\nimport { RenderCtxLegacy } from \"./render\";\nimport { PlatformaSDKVersion } from \"./version\";\nimport type {\n  TypedConfigOrConfigLambda,\n  ConfigRenderLambda,\n  StdCtxArgsOnly,\n  DeriveHref,\n  ConfigRenderLambdaFlags,\n  InferOutputsFromConfigs,\n} from \"./bconfig\";\nimport { downgradeCfgOrLambda, isConfigLambda } from \"./bconfig\";\nimport type { PlatformaExtended } from \"./platforma\";\n\ntype SectionsExpectedType = readonly BlockSection[];\n\ntype SectionsCfgChecked<Cfg extends TypedConfig, Args, UiState> = Checked<\n  Cfg,\n  ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>> extends SectionsExpectedType ? true : false\n>;\n\ntype InputsValidExpectedType = boolean;\n\ntype InputsValidCfgChecked<Cfg extends TypedConfig, Args, UiState> = Checked<\n  Cfg,\n  ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>> extends InputsValidExpectedType ? true : false\n>;\n\ntype NoOb = Record<string, never>;\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. */\nexport class BlockModel<\n  Args,\n  OutputsCfg extends Record<string, TypedConfigOrConfigLambda>,\n  UiState,\n  Href extends `/${string}` = \"/\",\n> {\n  private constructor(\n    private config: {\n      readonly renderingMode: BlockRenderingMode;\n      readonly initialArgs?: Args;\n      readonly initialUiState: UiState;\n      readonly outputs: OutputsCfg;\n      readonly inputsValid: TypedConfigOrConfigLambda;\n      readonly sections: TypedConfigOrConfigLambda;\n      readonly title?: ConfigRenderLambda;\n      readonly subtitle?: ConfigRenderLambda;\n      readonly tags?: ConfigRenderLambda;\n      readonly enrichmentTargets?: ConfigRenderLambda;\n      readonly featureFlags: BlockCodeKnownFeatureFlags;\n    },\n  ) {}\n\n  public static get INITIAL_BLOCK_FEATURE_FLAGS(): BlockCodeKnownFeatureFlags {\n    return {\n      supportsLazyState: true,\n      supportsPframeQueryRanking: true,\n      requiresUIAPIVersion: 1,\n      requiresModelAPIVersion: 1,\n      requiresCreatePTable: 2,\n    };\n  }\n\n  /** Initiates configuration builder */\n  public static create(renderingMode: BlockRenderingMode): BlockModel<NoOb, {}, NoOb>;\n  /** Initiates configuration builder */\n  public static create(): BlockModel<NoOb, {}, NoOb>;\n  /**\n   * Initiates configuration builder\n   * @deprecated use create method without generic parameter\n   */\n  public static create<Args>(renderingMode: BlockRenderingMode): BlockModel<Args, {}, NoOb>;\n  /**\n   * Initiates configuration builder\n   * @deprecated use create method without generic parameter\n   */\n  public static create<Args>(): BlockModel<Args, {}, NoOb>;\n  public static create(renderingMode: BlockRenderingMode = \"Heavy\"): BlockModel<NoOb, {}, NoOb> {\n    return new BlockModel<NoOb, {}, NoOb>({\n      renderingMode,\n      initialUiState: {},\n      outputs: {},\n      inputsValid: getImmediate(true),\n      sections: getImmediate([]),\n      featureFlags: BlockModel.INITIAL_BLOCK_FEATURE_FLAGS,\n    });\n  }\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 cfg configuration describing how to render cell value from the blocks\n   *            workflow outputs\n   * @deprecated use lambda-based API\n   * */\n  public output<const Key extends string, const Cfg extends TypedConfig>(\n    key: Key,\n    cfg: Cfg,\n  ): BlockModel<Args, OutputsCfg & { [K in Key]: Cfg }, UiState, Href>;\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 RenderFunctionLegacy<Args, UiState>>(\n    key: Key,\n    rf: RF,\n    flags: ConfigRenderLambdaFlags & { withStatus: true },\n  ): BlockModel<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> & { withStatus: true };\n    },\n    UiState,\n    Href\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 RenderFunctionLegacy<Args, UiState>>(\n    key: Key,\n    rf: RF,\n    flags?: ConfigRenderLambdaFlags,\n  ): BlockModel<\n    Args,\n    OutputsCfg & { [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> },\n    UiState,\n    Href\n  >;\n  public output(\n    key: string,\n    cfgOrRf: TypedConfig | AnyFunction,\n    flags: ConfigRenderLambdaFlags = {},\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    if (typeof cfgOrRf === \"function\") {\n      const handle = `output#${key}`;\n      tryRegisterCallback(handle, () => cfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel({\n        ...this.config,\n        outputs: {\n          ...this.config.outputs,\n          [key]: {\n            __renderLambda: true,\n            handle,\n            ...flags,\n          },\n        },\n      });\n    } else {\n      return new BlockModel({\n        ...this.config,\n        outputs: {\n          ...this.config.outputs,\n          [key]: cfgOrRf,\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 RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\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 RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { withStatus: true });\n  }\n\n  /** Shortcut for {@link output} with retentive and withStatus flags set to true. */\n  public retentiveOutputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { retentive: true, withStatus: true });\n  }\n\n  /** Sets custom configuration predicate on the block args at which block can be executed\n   * @deprecated use lambda-based API */\n  public argsValid<Cfg extends TypedConfig>(\n    cfg: Cfg & InputsValidCfgChecked<Cfg, Args, UiState>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href>;\n  /** Sets custom configuration predicate on the block args at which block can be executed */\n  public argsValid<RF extends RenderFunctionLegacy<Args, UiState, boolean>>(\n    rf: RF,\n  ): BlockModel<Args, OutputsCfg, UiState, Href>;\n  public argsValid(\n    cfgOrRf: TypedConfig | AnyFunction,\n  ): BlockModel<Args, OutputsCfg, UiState, `/${string}`> {\n    if (typeof cfgOrRf === \"function\") {\n      tryRegisterCallback(\"inputsValid\", () => cfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        inputsValid: {\n          __renderLambda: true,\n          handle: \"inputsValid\",\n        },\n      });\n    } else {\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        inputsValid: cfgOrRf,\n      });\n    }\n  }\n\n  /** Sets the config to generate list of section in the left block overviews panel\n   * @deprecated use lambda-based API */\n  public sections<const S extends SectionsExpectedType>(\n    rf: S,\n  ): BlockModel<Args, OutputsCfg, UiState, DeriveHref<S>>;\n  /** Sets the config to generate list of section in the left block overviews panel */\n  public sections<\n    const Ret extends SectionsExpectedType,\n    const RF extends RenderFunctionLegacy<Args, UiState, Ret>,\n  >(rf: RF): BlockModel<Args, OutputsCfg, UiState, DeriveHref<ReturnType<RF>>>;\n  public sections<const Cfg extends TypedConfig>(\n    cfg: Cfg & SectionsCfgChecked<Cfg, Args, UiState>,\n  ): BlockModel<\n    Args,\n    OutputsCfg,\n    UiState,\n    DeriveHref<ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>>>\n  >;\n  public sections(\n    arrOrCfgOrRf: SectionsExpectedType | TypedConfig | AnyFunction,\n  ): BlockModel<Args, OutputsCfg, UiState, `/${string}`> {\n    if (Array.isArray(arrOrCfgOrRf)) {\n      return this.sections(getImmediate(arrOrCfgOrRf));\n    } else if (typeof arrOrCfgOrRf === \"function\") {\n      tryRegisterCallback(\"sections\", () => arrOrCfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        sections: {\n          __renderLambda: true,\n          handle: \"sections\",\n        },\n      });\n    } else {\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        sections: arrOrCfgOrRf as TypedConfig,\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: RenderFunctionLegacy<Args, UiState, string>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"title\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      title: {\n        __renderLambda: true,\n        handle: \"title\",\n      },\n    });\n  }\n\n  public subtitle(\n    rf: RenderFunctionLegacy<Args, UiState, string>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"subtitle\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      subtitle: {\n        __renderLambda: true,\n        handle: \"subtitle\",\n      },\n    });\n  }\n\n  public tags(\n    rf: RenderFunctionLegacy<Args, UiState, string[]>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"tags\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      tags: {\n        __renderLambda: true,\n        handle: \"tags\",\n      },\n    });\n  }\n\n  /**\n   * Sets initial args for the block, this value must be specified.\n   * @deprecated use {@link withArgs}\n   * */\n  public initialArgs(value: Args): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return this.withArgs(value);\n  }\n\n  /** Sets initial args for the block, this value must be specified. */\n  public withArgs<Args>(initialArgs: Args): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      initialArgs,\n    });\n  }\n\n  /** Defines type and sets initial value for block UiState. */\n  public withUiState<UiState>(\n    initialUiState: UiState,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      initialUiState,\n    });\n  }\n\n  /** Sets or overrides feature flags for the block. */\n  public withFeatureFlags(\n    flags: Partial<BlockCodeKnownFeatureFlags>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      featureFlags: {\n        ...this.config.featureFlags,\n        ...flags,\n      },\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(lambda: (args: Args) => PlRef[]): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"enrichmentTargets\", lambda);\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      enrichmentTargets: {\n        __renderLambda: true,\n        handle: \"enrichmentTargets\",\n      },\n    });\n  }\n\n  public done(\n    apiVersion?: 1,\n  ): PlatformaExtended<\n    PlatformaV1<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  >;\n\n  public done(\n    apiVersion: 2,\n  ): PlatformaExtended<\n    PlatformaV2<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\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 state, and\n   * other features provided by the platforma to the block. */\n  public done(\n    apiVersion: PlatformaApiVersion = 1,\n  ): PlatformaExtended<\n    Platforma<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  > {\n    return this.withFeatureFlags({\n      ...this.config.featureFlags,\n      requiresUIAPIVersion: apiVersion,\n    }).#done();\n  }\n\n  #done(): PlatformaExtended<\n    Platforma<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  > {\n    if (this.config.initialArgs === undefined) throw new Error(\"Initial arguments not set.\");\n\n    const config: BlockConfigContainer = {\n      v4: undefined,\n      v3: {\n        configVersion: 3,\n        modelAPIVersion: 1,\n        sdkVersion: PlatformaSDKVersion,\n        renderingMode: this.config.renderingMode,\n        initialArgs: this.config.initialArgs,\n        initialUiState: this.config.initialUiState,\n        inputsValid: this.config.inputsValid,\n        sections: this.config.sections,\n        title: this.config.title,\n        subtitle: this.config.subtitle,\n        tags: this.config.tags,\n        outputs: this.config.outputs,\n        enrichmentTargets: this.config.enrichmentTargets,\n        featureFlags: this.config.featureFlags,\n      },\n\n      // fields below are added to allow previous desktop versions read generated configs\n      sdkVersion: PlatformaSDKVersion,\n      renderingMode: this.config.renderingMode,\n      initialArgs: this.config.initialArgs,\n      inputsValid: downgradeCfgOrLambda(this.config.inputsValid),\n      sections: downgradeCfgOrLambda(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\n    globalThis.platformaApiVersion = this.config.featureFlags\n      .requiresUIAPIVersion as PlatformaApiVersion;\n\n    if (!isInUI()) {\n      // we are in the configuration rendering routine, not in actual UI\n      return { config } as any;\n    } else {\n      // normal operation inside the UI\n      return {\n        ...getPlatformaInstance({\n          sdkVersion: PlatformaSDKVersion,\n          apiVersion: platformaApiVersion,\n        }),\n        blockModelInfo: {\n          outputs: Object.fromEntries(\n            Object.entries(this.config.outputs).map(([key, value]) => [\n              key,\n              {\n                withStatus: Boolean(isConfigLambda(value) && value.withStatus),\n              },\n            ]),\n          ),\n          pluginIds: [],\n          featureFlags: this.config.featureFlags,\n        },\n      };\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/block_model_legacy.d.ts

@@ -1,12 +1,9 @@
 import { ConfigResult, TypedConfig } from "./config/type_engine.js";
 import { Checked } from "./config/type_util.js";
-import "./config/index.js";
 import { TypedConfigOrConfigLambda } from "./bconfig/types.js";
 import { ConfigRenderLambda, ConfigRenderLambdaFlags, InferOutputsFromConfigs, StdCtxArgsOnly } from "./bconfig/lambdas.js";
 import { DeriveHref } from "./bconfig/util.js";
-import "./bconfig/index.js";
 import { InferRenderFunctionReturn, RenderFunctionLegacy } from "./render/api.js";
-import "./render/index.js";
 import { PlatformaExtended, PlatformaV1, PlatformaV2 } from "./platforma.js";
 import { BlockCodeKnownFeatureFlags, BlockRenderingMode, BlockSection, PlRef } from "@milaboratories/pl-model-common";
 

package/dist/block_model_legacy.d.ts.map

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

package/dist/block_model_legacy.js

@@ -7,7 +7,6 @@ import { PlatformaSDKVersion } from "./version.js";
 import { isConfigLambda } from "./bconfig/types.js";
 import { downgradeCfgOrLambda } from "./bconfig/normalization.js";
 import "./bconfig/index.js";
-
 //#region src/block_model_legacy.ts
 /** Main entry point that each block should use in it's "config" module. Don't forget
 * to call {@link done()} at the end of configuration. Value returned by this builder must be
@@ -231,7 +230,7 @@ var BlockModel = class BlockModel {
 		};
 	}
 };
-
 //#endregion
 export { BlockModel };
+
 //# sourceMappingURL=block_model_legacy.js.map

package/dist/block_model_legacy.js.map

@@ -1 +1 @@
-{"version":3,"file":"block_model_legacy.js","names":["#done"],"sources":["../src/block_model_legacy.ts"],"sourcesContent":["import type {\n  BlockRenderingMode,\n  BlockSection,\n  AnyFunction,\n  PlRef,\n  BlockCodeKnownFeatureFlags,\n  BlockConfigContainer,\n} from \"@milaboratories/pl-model-common\";\nimport type { Checked, ConfigResult, TypedConfig } from \"./config\";\nimport { getImmediate } from \"./config\";\nimport { getPlatformaInstance, isInUI, tryRegisterCallback } from \"./internal\";\nimport type { Platforma, PlatformaApiVersion, PlatformaV1, PlatformaV2 } from \"./platforma\";\nimport type { InferRenderFunctionReturn, RenderFunctionLegacy } from \"./render\";\nimport { RenderCtxLegacy } from \"./render\";\nimport { PlatformaSDKVersion } from \"./version\";\nimport type {\n  TypedConfigOrConfigLambda,\n  ConfigRenderLambda,\n  StdCtxArgsOnly,\n  DeriveHref,\n  ConfigRenderLambdaFlags,\n  InferOutputsFromConfigs,\n} from \"./bconfig\";\nimport { downgradeCfgOrLambda, isConfigLambda } from \"./bconfig\";\nimport type { PlatformaExtended } from \"./platforma\";\n\ntype SectionsExpectedType = readonly BlockSection[];\n\ntype SectionsCfgChecked<Cfg extends TypedConfig, Args, UiState> = Checked<\n  Cfg,\n  ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>> extends SectionsExpectedType ? true : false\n>;\n\ntype InputsValidExpectedType = boolean;\n\ntype InputsValidCfgChecked<Cfg extends TypedConfig, Args, UiState> = Checked<\n  Cfg,\n  ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>> extends InputsValidExpectedType ? true : false\n>;\n\ntype NoOb = Record<string, never>;\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. */\nexport class BlockModel<\n  Args,\n  OutputsCfg extends Record<string, TypedConfigOrConfigLambda>,\n  UiState,\n  Href extends `/${string}` = \"/\",\n> {\n  private constructor(\n    private config: {\n      readonly renderingMode: BlockRenderingMode;\n      readonly initialArgs?: Args;\n      readonly initialUiState: UiState;\n      readonly outputs: OutputsCfg;\n      readonly inputsValid: TypedConfigOrConfigLambda;\n      readonly sections: TypedConfigOrConfigLambda;\n      readonly title?: ConfigRenderLambda;\n      readonly subtitle?: ConfigRenderLambda;\n      readonly tags?: ConfigRenderLambda;\n      readonly enrichmentTargets?: ConfigRenderLambda;\n      readonly featureFlags: BlockCodeKnownFeatureFlags;\n    },\n  ) {}\n\n  public static get INITIAL_BLOCK_FEATURE_FLAGS(): BlockCodeKnownFeatureFlags {\n    return {\n      supportsLazyState: true,\n      supportsPframeQueryRanking: true,\n      requiresUIAPIVersion: 1,\n      requiresModelAPIVersion: 1,\n      requiresCreatePTable: 2,\n    };\n  }\n\n  /** Initiates configuration builder */\n  public static create(renderingMode: BlockRenderingMode): BlockModel<NoOb, {}, NoOb>;\n  /** Initiates configuration builder */\n  public static create(): BlockModel<NoOb, {}, NoOb>;\n  /**\n   * Initiates configuration builder\n   * @deprecated use create method without generic parameter\n   */\n  public static create<Args>(renderingMode: BlockRenderingMode): BlockModel<Args, {}, NoOb>;\n  /**\n   * Initiates configuration builder\n   * @deprecated use create method without generic parameter\n   */\n  public static create<Args>(): BlockModel<Args, {}, NoOb>;\n  public static create(renderingMode: BlockRenderingMode = \"Heavy\"): BlockModel<NoOb, {}, NoOb> {\n    return new BlockModel<NoOb, {}, NoOb>({\n      renderingMode,\n      initialUiState: {},\n      outputs: {},\n      inputsValid: getImmediate(true),\n      sections: getImmediate([]),\n      featureFlags: BlockModel.INITIAL_BLOCK_FEATURE_FLAGS,\n    });\n  }\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 cfg configuration describing how to render cell value from the blocks\n   *            workflow outputs\n   * @deprecated use lambda-based API\n   * */\n  public output<const Key extends string, const Cfg extends TypedConfig>(\n    key: Key,\n    cfg: Cfg,\n  ): BlockModel<Args, OutputsCfg & { [K in Key]: Cfg }, UiState, Href>;\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 RenderFunctionLegacy<Args, UiState>>(\n    key: Key,\n    rf: RF,\n    flags: ConfigRenderLambdaFlags & { withStatus: true },\n  ): BlockModel<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> & { withStatus: true };\n    },\n    UiState,\n    Href\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 RenderFunctionLegacy<Args, UiState>>(\n    key: Key,\n    rf: RF,\n    flags?: ConfigRenderLambdaFlags,\n  ): BlockModel<\n    Args,\n    OutputsCfg & { [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> },\n    UiState,\n    Href\n  >;\n  public output(\n    key: string,\n    cfgOrRf: TypedConfig | AnyFunction,\n    flags: ConfigRenderLambdaFlags = {},\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    if (typeof cfgOrRf === \"function\") {\n      const handle = `output#${key}`;\n      tryRegisterCallback(handle, () => cfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel({\n        ...this.config,\n        outputs: {\n          ...this.config.outputs,\n          [key]: {\n            __renderLambda: true,\n            handle,\n            ...flags,\n          },\n        },\n      });\n    } else {\n      return new BlockModel({\n        ...this.config,\n        outputs: {\n          ...this.config.outputs,\n          [key]: cfgOrRf,\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 RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\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 RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { withStatus: true });\n  }\n\n  /** Shortcut for {@link output} with retentive and withStatus flags set to true. */\n  public retentiveOutputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { retentive: true, withStatus: true });\n  }\n\n  /** Sets custom configuration predicate on the block args at which block can be executed\n   * @deprecated use lambda-based API */\n  public argsValid<Cfg extends TypedConfig>(\n    cfg: Cfg & InputsValidCfgChecked<Cfg, Args, UiState>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href>;\n  /** Sets custom configuration predicate on the block args at which block can be executed */\n  public argsValid<RF extends RenderFunctionLegacy<Args, UiState, boolean>>(\n    rf: RF,\n  ): BlockModel<Args, OutputsCfg, UiState, Href>;\n  public argsValid(\n    cfgOrRf: TypedConfig | AnyFunction,\n  ): BlockModel<Args, OutputsCfg, UiState, `/${string}`> {\n    if (typeof cfgOrRf === \"function\") {\n      tryRegisterCallback(\"inputsValid\", () => cfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        inputsValid: {\n          __renderLambda: true,\n          handle: \"inputsValid\",\n        },\n      });\n    } else {\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        inputsValid: cfgOrRf,\n      });\n    }\n  }\n\n  /** Sets the config to generate list of section in the left block overviews panel\n   * @deprecated use lambda-based API */\n  public sections<const S extends SectionsExpectedType>(\n    rf: S,\n  ): BlockModel<Args, OutputsCfg, UiState, DeriveHref<S>>;\n  /** Sets the config to generate list of section in the left block overviews panel */\n  public sections<\n    const Ret extends SectionsExpectedType,\n    const RF extends RenderFunctionLegacy<Args, UiState, Ret>,\n  >(rf: RF): BlockModel<Args, OutputsCfg, UiState, DeriveHref<ReturnType<RF>>>;\n  public sections<const Cfg extends TypedConfig>(\n    cfg: Cfg & SectionsCfgChecked<Cfg, Args, UiState>,\n  ): BlockModel<\n    Args,\n    OutputsCfg,\n    UiState,\n    DeriveHref<ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>>>\n  >;\n  public sections(\n    arrOrCfgOrRf: SectionsExpectedType | TypedConfig | AnyFunction,\n  ): BlockModel<Args, OutputsCfg, UiState, `/${string}`> {\n    if (Array.isArray(arrOrCfgOrRf)) {\n      return this.sections(getImmediate(arrOrCfgOrRf));\n    } else if (typeof arrOrCfgOrRf === \"function\") {\n      tryRegisterCallback(\"sections\", () => arrOrCfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        sections: {\n          __renderLambda: true,\n          handle: \"sections\",\n        },\n      });\n    } else {\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        sections: arrOrCfgOrRf as TypedConfig,\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: RenderFunctionLegacy<Args, UiState, string>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"title\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      title: {\n        __renderLambda: true,\n        handle: \"title\",\n      },\n    });\n  }\n\n  public subtitle(\n    rf: RenderFunctionLegacy<Args, UiState, string>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"subtitle\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      subtitle: {\n        __renderLambda: true,\n        handle: \"subtitle\",\n      },\n    });\n  }\n\n  public tags(\n    rf: RenderFunctionLegacy<Args, UiState, string[]>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"tags\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      tags: {\n        __renderLambda: true,\n        handle: \"tags\",\n      },\n    });\n  }\n\n  /**\n   * Sets initial args for the block, this value must be specified.\n   * @deprecated use {@link withArgs}\n   * */\n  public initialArgs(value: Args): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return this.withArgs(value);\n  }\n\n  /** Sets initial args for the block, this value must be specified. */\n  public withArgs<Args>(initialArgs: Args): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      initialArgs,\n    });\n  }\n\n  /** Defines type and sets initial value for block UiState. */\n  public withUiState<UiState>(\n    initialUiState: UiState,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      initialUiState,\n    });\n  }\n\n  /** Sets or overrides feature flags for the block. */\n  public withFeatureFlags(\n    flags: Partial<BlockCodeKnownFeatureFlags>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      featureFlags: {\n        ...this.config.featureFlags,\n        ...flags,\n      },\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(lambda: (args: Args) => PlRef[]): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"enrichmentTargets\", lambda);\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      enrichmentTargets: {\n        __renderLambda: true,\n        handle: \"enrichmentTargets\",\n      },\n    });\n  }\n\n  public done(\n    apiVersion?: 1,\n  ): PlatformaExtended<\n    PlatformaV1<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  >;\n\n  public done(\n    apiVersion: 2,\n  ): PlatformaExtended<\n    PlatformaV2<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\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 state, and\n   * other features provided by the platforma to the block. */\n  public done(\n    apiVersion: PlatformaApiVersion = 1,\n  ): PlatformaExtended<\n    Platforma<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  > {\n    return this.withFeatureFlags({\n      ...this.config.featureFlags,\n      requiresUIAPIVersion: apiVersion,\n    }).#done();\n  }\n\n  #done(): PlatformaExtended<\n    Platforma<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  > {\n    if (this.config.initialArgs === undefined) throw new Error(\"Initial arguments not set.\");\n\n    const config: BlockConfigContainer = {\n      v4: undefined,\n      v3: {\n        configVersion: 3,\n        modelAPIVersion: 1,\n        sdkVersion: PlatformaSDKVersion,\n        renderingMode: this.config.renderingMode,\n        initialArgs: this.config.initialArgs,\n        initialUiState: this.config.initialUiState,\n        inputsValid: this.config.inputsValid,\n        sections: this.config.sections,\n        title: this.config.title,\n        subtitle: this.config.subtitle,\n        tags: this.config.tags,\n        outputs: this.config.outputs,\n        enrichmentTargets: this.config.enrichmentTargets,\n        featureFlags: this.config.featureFlags,\n      },\n\n      // fields below are added to allow previous desktop versions read generated configs\n      sdkVersion: PlatformaSDKVersion,\n      renderingMode: this.config.renderingMode,\n      initialArgs: this.config.initialArgs,\n      inputsValid: downgradeCfgOrLambda(this.config.inputsValid),\n      sections: downgradeCfgOrLambda(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\n    globalThis.platformaApiVersion = this.config.featureFlags\n      .requiresUIAPIVersion as PlatformaApiVersion;\n\n    if (!isInUI()) {\n      // we are in the configuration rendering routine, not in actual UI\n      return { config } as any;\n    } else {\n      // normal operation inside the UI\n      return {\n        ...getPlatformaInstance({\n          sdkVersion: PlatformaSDKVersion,\n          apiVersion: platformaApiVersion,\n        }),\n        blockModelInfo: {\n          outputs: Object.fromEntries(\n            Object.entries(this.config.outputs).map(([key, value]) => [\n              key,\n              {\n                withStatus: Boolean(isConfigLambda(value) && value.withStatus),\n              },\n            ]),\n          ),\n          pluginIds: [],\n          featureFlags: this.config.featureFlags,\n        },\n      };\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AA6CA,IAAa,aAAb,MAAa,WAKX;CACA,AAAQ,YACN,AAAQ,QAaR;EAbQ;;CAeV,WAAkB,8BAA0D;AAC1E,SAAO;GACL,mBAAmB;GACnB,4BAA4B;GAC5B,sBAAsB;GACtB,yBAAyB;GACzB,sBAAsB;GACvB;;CAiBH,OAAc,OAAO,gBAAoC,SAAqC;AAC5F,SAAO,IAAI,WAA2B;GACpC;GACA,gBAAgB,EAAE;GAClB,SAAS,EAAE;GACX,aAAa,aAAa,KAAK;GAC/B,UAAU,aAAa,EAAE,CAAC;GAC1B,cAAc,WAAW;GAC1B,CAAC;;CAqDJ,AAAO,OACL,KACA,SACA,QAAiC,EAAE,EACU;AAC7C,MAAI,OAAO,YAAY,YAAY;GACjC,MAAM,SAAS,UAAU;AACzB,uBAAoB,cAAc,QAAQ,IAAI,iBAAiB,CAAC,CAAC;AACjE,UAAO,IAAI,WAAW;IACpB,GAAG,KAAK;IACR,SAAS;KACP,GAAG,KAAK,OAAO;MACd,MAAM;MACL,gBAAgB;MAChB;MACA,GAAG;MACJ;KACF;IACF,CAAC;QAEF,QAAO,IAAI,WAAW;GACpB,GAAG,KAAK;GACR,SAAS;IACP,GAAG,KAAK,OAAO;KACd,MAAM;IACR;GACF,CAAC;;;CAKN,AAAO,gBAGL,KAAU,IAAQ;AAClB,SAAO,KAAK,OAAO,KAAK,IAAI,EAAE,WAAW,MAAM,CAAC;;;CAIlD,AAAO,iBAGL,KAAU,IAAQ;AAClB,SAAO,KAAK,OAAO,KAAK,IAAI,EAAE,YAAY,MAAM,CAAC;;;CAInD,AAAO,0BAGL,KAAU,IAAQ;AAClB,SAAO,KAAK,OAAO,KAAK,IAAI;GAAE,WAAW;GAAM,YAAY;GAAM,CAAC;;CAYpE,AAAO,UACL,SACqD;AACrD,MAAI,OAAO,YAAY,YAAY;AACjC,uBAAoB,qBAAqB,QAAQ,IAAI,iBAAiB,CAAC,CAAC;AACxE,UAAO,IAAI,WAAsC;IAC/C,GAAG,KAAK;IACR,aAAa;KACX,gBAAgB;KAChB,QAAQ;KACT;IACF,CAAC;QAEF,QAAO,IAAI,WAAsC;GAC/C,GAAG,KAAK;GACR,aAAa;GACd,CAAC;;CAsBN,AAAO,SACL,cACqD;AACrD,MAAI,MAAM,QAAQ,aAAa,CAC7B,QAAO,KAAK,SAAS,aAAa,aAAa,CAAC;WACvC,OAAO,iBAAiB,YAAY;AAC7C,uBAAoB,kBAAkB,aAAa,IAAI,iBAAiB,CAAC,CAAC;AAC1E,UAAO,IAAI,WAAsC;IAC/C,GAAG,KAAK;IACR,UAAU;KACR,gBAAgB;KAChB,QAAQ;KACT;IACF,CAAC;QAEF,QAAO,IAAI,WAAsC;GAC/C,GAAG,KAAK;GACR,UAAU;GACX,CAAC;;;CAKN,AAAO,MACL,IAC6C;AAC7C,sBAAoB,eAAe,GAAG,IAAI,iBAAiB,CAAC,CAAC;AAC7D,SAAO,IAAI,WAA4C;GACrD,GAAG,KAAK;GACR,OAAO;IACL,gBAAgB;IAChB,QAAQ;IACT;GACF,CAAC;;CAGJ,AAAO,SACL,IAC6C;AAC7C,sBAAoB,kBAAkB,GAAG,IAAI,iBAAiB,CAAC,CAAC;AAChE,SAAO,IAAI,WAA4C;GACrD,GAAG,KAAK;GACR,UAAU;IACR,gBAAgB;IAChB,QAAQ;IACT;GACF,CAAC;;CAGJ,AAAO,KACL,IAC6C;AAC7C,sBAAoB,cAAc,GAAG,IAAI,iBAAiB,CAAC,CAAC;AAC5D,SAAO,IAAI,WAA4C;GACrD,GAAG,KAAK;GACR,MAAM;IACJ,gBAAgB;IAChB,QAAQ;IACT;GACF,CAAC;;;;;;CAOJ,AAAO,YAAY,OAA0D;AAC3E,SAAO,KAAK,SAAS,MAAM;;;CAI7B,AAAO,SAAe,aAAgE;AACpF,SAAO,IAAI,WAA4C;GACrD,GAAG,KAAK;GACR;GACD,CAAC;;;CAIJ,AAAO,YACL,gBAC6C;AAC7C,SAAO,IAAI,WAA4C;GACrD,GAAG,KAAK;GACR;GACD,CAAC;;;CAIJ,AAAO,iBACL,OAC6C;AAC7C,SAAO,IAAI,WAA4C;GACrD,GAAG,KAAK;GACR,cAAc;IACZ,GAAG,KAAK,OAAO;IACf,GAAG;IACJ;GACF,CAAC;;;;;;CAOJ,AAAO,SAAS,QAA8E;AAC5F,sBAAoB,qBAAqB,OAAO;AAChD,SAAO,IAAI,WAA4C;GACrD,GAAG,KAAK;GACR,mBAAmB;IACjB,gBAAgB;IAChB,QAAQ;IACT;GACF,CAAC;;;;;CAkBJ,AAAO,KACL,aAAkC,GAGlC;AACA,SAAO,KAAK,iBAAiB;GAC3B,GAAG,KAAK,OAAO;GACf,sBAAsB;GACvB,CAAC,EAACA,MAAO;;CAGZ,QAEE;AACA,MAAI,KAAK,OAAO,gBAAgB,OAAW,OAAM,IAAI,MAAM,6BAA6B;EAExF,MAAM,SAA+B;GACnC,IAAI;GACJ,IAAI;IACF,eAAe;IACf,iBAAiB;IACjB,YAAY;IACZ,eAAe,KAAK,OAAO;IAC3B,aAAa,KAAK,OAAO;IACzB,gBAAgB,KAAK,OAAO;IAC5B,aAAa,KAAK,OAAO;IACzB,UAAU,KAAK,OAAO;IACtB,OAAO,KAAK,OAAO;IACnB,UAAU,KAAK,OAAO;IACtB,MAAM,KAAK,OAAO;IAClB,SAAS,KAAK,OAAO;IACrB,mBAAmB,KAAK,OAAO;IAC/B,cAAc,KAAK,OAAO;IAC3B;GAGD,YAAY;GACZ,eAAe,KAAK,OAAO;GAC3B,aAAa,KAAK,OAAO;GACzB,aAAa,qBAAqB,KAAK,OAAO,YAAY;GAC1D,UAAU,qBAAqB,KAAK,OAAO,SAAS;GACpD,SAAS,OAAO,YACd,OAAO,QAAQ,KAAK,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,WAAW,CACxD,KACA,qBAAqB,MAAM,CAC5B,CAAC,CACH;GACF;AAED,aAAW,sBAAsB,KAAK,OAAO,aAC1C;AAEH,MAAI,CAAC,QAAQ,CAEX,QAAO,EAAE,QAAQ;MAGjB,QAAO;GACL,GAAG,qBAAqB;IACtB,YAAY;IACZ,YAAY;IACb,CAAC;GACF,gBAAgB;IACd,SAAS,OAAO,YACd,OAAO,QAAQ,KAAK,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,WAAW,CACxD,KACA,EACE,YAAY,QAAQ,eAAe,MAAM,IAAI,MAAM,WAAW,EAC/D,CACF,CAAC,CACH;IACD,WAAW,EAAE;IACb,cAAc,KAAK,OAAO;IAC3B;GACF"}
+{"version":3,"file":"block_model_legacy.js","names":["#done"],"sources":["../src/block_model_legacy.ts"],"sourcesContent":["import type {\n  BlockRenderingMode,\n  BlockSection,\n  AnyFunction,\n  PlRef,\n  BlockCodeKnownFeatureFlags,\n  BlockConfigContainer,\n} from \"@milaboratories/pl-model-common\";\nimport type { Checked, ConfigResult, TypedConfig } from \"./config\";\nimport { getImmediate } from \"./config\";\nimport { getPlatformaInstance, isInUI, tryRegisterCallback } from \"./internal\";\nimport type { Platforma, PlatformaApiVersion, PlatformaV1, PlatformaV2 } from \"./platforma\";\nimport type { InferRenderFunctionReturn, RenderFunctionLegacy } from \"./render\";\nimport { RenderCtxLegacy } from \"./render\";\nimport { PlatformaSDKVersion } from \"./version\";\nimport type {\n  TypedConfigOrConfigLambda,\n  ConfigRenderLambda,\n  StdCtxArgsOnly,\n  DeriveHref,\n  ConfigRenderLambdaFlags,\n  InferOutputsFromConfigs,\n} from \"./bconfig\";\nimport { downgradeCfgOrLambda, isConfigLambda } from \"./bconfig\";\nimport type { PlatformaExtended } from \"./platforma\";\n\ntype SectionsExpectedType = readonly BlockSection[];\n\ntype SectionsCfgChecked<Cfg extends TypedConfig, Args, UiState> = Checked<\n  Cfg,\n  ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>> extends SectionsExpectedType ? true : false\n>;\n\ntype InputsValidExpectedType = boolean;\n\ntype InputsValidCfgChecked<Cfg extends TypedConfig, Args, UiState> = Checked<\n  Cfg,\n  ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>> extends InputsValidExpectedType ? true : false\n>;\n\ntype NoOb = Record<string, never>;\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. */\nexport class BlockModel<\n  Args,\n  OutputsCfg extends Record<string, TypedConfigOrConfigLambda>,\n  UiState,\n  Href extends `/${string}` = \"/\",\n> {\n  private constructor(\n    private config: {\n      readonly renderingMode: BlockRenderingMode;\n      readonly initialArgs?: Args;\n      readonly initialUiState: UiState;\n      readonly outputs: OutputsCfg;\n      readonly inputsValid: TypedConfigOrConfigLambda;\n      readonly sections: TypedConfigOrConfigLambda;\n      readonly title?: ConfigRenderLambda;\n      readonly subtitle?: ConfigRenderLambda;\n      readonly tags?: ConfigRenderLambda;\n      readonly enrichmentTargets?: ConfigRenderLambda;\n      readonly featureFlags: BlockCodeKnownFeatureFlags;\n    },\n  ) {}\n\n  public static get INITIAL_BLOCK_FEATURE_FLAGS(): BlockCodeKnownFeatureFlags {\n    return {\n      supportsLazyState: true,\n      supportsPframeQueryRanking: true,\n      requiresUIAPIVersion: 1,\n      requiresModelAPIVersion: 1,\n      requiresCreatePTable: 2,\n    };\n  }\n\n  /** Initiates configuration builder */\n  public static create(renderingMode: BlockRenderingMode): BlockModel<NoOb, {}, NoOb>;\n  /** Initiates configuration builder */\n  public static create(): BlockModel<NoOb, {}, NoOb>;\n  /**\n   * Initiates configuration builder\n   * @deprecated use create method without generic parameter\n   */\n  public static create<Args>(renderingMode: BlockRenderingMode): BlockModel<Args, {}, NoOb>;\n  /**\n   * Initiates configuration builder\n   * @deprecated use create method without generic parameter\n   */\n  public static create<Args>(): BlockModel<Args, {}, NoOb>;\n  public static create(renderingMode: BlockRenderingMode = \"Heavy\"): BlockModel<NoOb, {}, NoOb> {\n    return new BlockModel<NoOb, {}, NoOb>({\n      renderingMode,\n      initialUiState: {},\n      outputs: {},\n      inputsValid: getImmediate(true),\n      sections: getImmediate([]),\n      featureFlags: BlockModel.INITIAL_BLOCK_FEATURE_FLAGS,\n    });\n  }\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 cfg configuration describing how to render cell value from the blocks\n   *            workflow outputs\n   * @deprecated use lambda-based API\n   * */\n  public output<const Key extends string, const Cfg extends TypedConfig>(\n    key: Key,\n    cfg: Cfg,\n  ): BlockModel<Args, OutputsCfg & { [K in Key]: Cfg }, UiState, Href>;\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 RenderFunctionLegacy<Args, UiState>>(\n    key: Key,\n    rf: RF,\n    flags: ConfigRenderLambdaFlags & { withStatus: true },\n  ): BlockModel<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> & { withStatus: true };\n    },\n    UiState,\n    Href\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 RenderFunctionLegacy<Args, UiState>>(\n    key: Key,\n    rf: RF,\n    flags?: ConfigRenderLambdaFlags,\n  ): BlockModel<\n    Args,\n    OutputsCfg & { [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> },\n    UiState,\n    Href\n  >;\n  public output(\n    key: string,\n    cfgOrRf: TypedConfig | AnyFunction,\n    flags: ConfigRenderLambdaFlags = {},\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    if (typeof cfgOrRf === \"function\") {\n      const handle = `output#${key}`;\n      tryRegisterCallback(handle, () => cfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel({\n        ...this.config,\n        outputs: {\n          ...this.config.outputs,\n          [key]: {\n            __renderLambda: true,\n            handle,\n            ...flags,\n          },\n        },\n      });\n    } else {\n      return new BlockModel({\n        ...this.config,\n        outputs: {\n          ...this.config.outputs,\n          [key]: cfgOrRf,\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 RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\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 RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { withStatus: true });\n  }\n\n  /** Shortcut for {@link output} with retentive and withStatus flags set to true. */\n  public retentiveOutputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { retentive: true, withStatus: true });\n  }\n\n  /** Sets custom configuration predicate on the block args at which block can be executed\n   * @deprecated use lambda-based API */\n  public argsValid<Cfg extends TypedConfig>(\n    cfg: Cfg & InputsValidCfgChecked<Cfg, Args, UiState>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href>;\n  /** Sets custom configuration predicate on the block args at which block can be executed */\n  public argsValid<RF extends RenderFunctionLegacy<Args, UiState, boolean>>(\n    rf: RF,\n  ): BlockModel<Args, OutputsCfg, UiState, Href>;\n  public argsValid(\n    cfgOrRf: TypedConfig | AnyFunction,\n  ): BlockModel<Args, OutputsCfg, UiState, `/${string}`> {\n    if (typeof cfgOrRf === \"function\") {\n      tryRegisterCallback(\"inputsValid\", () => cfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        inputsValid: {\n          __renderLambda: true,\n          handle: \"inputsValid\",\n        },\n      });\n    } else {\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        inputsValid: cfgOrRf,\n      });\n    }\n  }\n\n  /** Sets the config to generate list of section in the left block overviews panel\n   * @deprecated use lambda-based API */\n  public sections<const S extends SectionsExpectedType>(\n    rf: S,\n  ): BlockModel<Args, OutputsCfg, UiState, DeriveHref<S>>;\n  /** Sets the config to generate list of section in the left block overviews panel */\n  public sections<\n    const Ret extends SectionsExpectedType,\n    const RF extends RenderFunctionLegacy<Args, UiState, Ret>,\n  >(rf: RF): BlockModel<Args, OutputsCfg, UiState, DeriveHref<ReturnType<RF>>>;\n  public sections<const Cfg extends TypedConfig>(\n    cfg: Cfg & SectionsCfgChecked<Cfg, Args, UiState>,\n  ): BlockModel<\n    Args,\n    OutputsCfg,\n    UiState,\n    DeriveHref<ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>>>\n  >;\n  public sections(\n    arrOrCfgOrRf: SectionsExpectedType | TypedConfig | AnyFunction,\n  ): BlockModel<Args, OutputsCfg, UiState, `/${string}`> {\n    if (Array.isArray(arrOrCfgOrRf)) {\n      return this.sections(getImmediate(arrOrCfgOrRf));\n    } else if (typeof arrOrCfgOrRf === \"function\") {\n      tryRegisterCallback(\"sections\", () => arrOrCfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        sections: {\n          __renderLambda: true,\n          handle: \"sections\",\n        },\n      });\n    } else {\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        sections: arrOrCfgOrRf as TypedConfig,\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: RenderFunctionLegacy<Args, UiState, string>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"title\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      title: {\n        __renderLambda: true,\n        handle: \"title\",\n      },\n    });\n  }\n\n  public subtitle(\n    rf: RenderFunctionLegacy<Args, UiState, string>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"subtitle\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      subtitle: {\n        __renderLambda: true,\n        handle: \"subtitle\",\n      },\n    });\n  }\n\n  public tags(\n    rf: RenderFunctionLegacy<Args, UiState, string[]>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"tags\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      tags: {\n        __renderLambda: true,\n        handle: \"tags\",\n      },\n    });\n  }\n\n  /**\n   * Sets initial args for the block, this value must be specified.\n   * @deprecated use {@link withArgs}\n   * */\n  public initialArgs(value: Args): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return this.withArgs(value);\n  }\n\n  /** Sets initial args for the block, this value must be specified. */\n  public withArgs<Args>(initialArgs: Args): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      initialArgs,\n    });\n  }\n\n  /** Defines type and sets initial value for block UiState. */\n  public withUiState<UiState>(\n    initialUiState: UiState,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      initialUiState,\n    });\n  }\n\n  /** Sets or overrides feature flags for the block. */\n  public withFeatureFlags(\n    flags: Partial<BlockCodeKnownFeatureFlags>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      featureFlags: {\n        ...this.config.featureFlags,\n        ...flags,\n      },\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(lambda: (args: Args) => PlRef[]): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"enrichmentTargets\", lambda);\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      enrichmentTargets: {\n        __renderLambda: true,\n        handle: \"enrichmentTargets\",\n      },\n    });\n  }\n\n  public done(\n    apiVersion?: 1,\n  ): PlatformaExtended<\n    PlatformaV1<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  >;\n\n  public done(\n    apiVersion: 2,\n  ): PlatformaExtended<\n    PlatformaV2<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\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 state, and\n   * other features provided by the platforma to the block. */\n  public done(\n    apiVersion: PlatformaApiVersion = 1,\n  ): PlatformaExtended<\n    Platforma<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  > {\n    return this.withFeatureFlags({\n      ...this.config.featureFlags,\n      requiresUIAPIVersion: apiVersion,\n    }).#done();\n  }\n\n  #done(): PlatformaExtended<\n    Platforma<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  > {\n    if (this.config.initialArgs === undefined) throw new Error(\"Initial arguments not set.\");\n\n    const config: BlockConfigContainer = {\n      v4: undefined,\n      v3: {\n        configVersion: 3,\n        modelAPIVersion: 1,\n        sdkVersion: PlatformaSDKVersion,\n        renderingMode: this.config.renderingMode,\n        initialArgs: this.config.initialArgs,\n        initialUiState: this.config.initialUiState,\n        inputsValid: this.config.inputsValid,\n        sections: this.config.sections,\n        title: this.config.title,\n        subtitle: this.config.subtitle,\n        tags: this.config.tags,\n        outputs: this.config.outputs,\n        enrichmentTargets: this.config.enrichmentTargets,\n        featureFlags: this.config.featureFlags,\n      },\n\n      // fields below are added to allow previous desktop versions read generated configs\n      sdkVersion: PlatformaSDKVersion,\n      renderingMode: this.config.renderingMode,\n      initialArgs: this.config.initialArgs,\n      inputsValid: downgradeCfgOrLambda(this.config.inputsValid),\n      sections: downgradeCfgOrLambda(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\n    globalThis.platformaApiVersion = this.config.featureFlags\n      .requiresUIAPIVersion as PlatformaApiVersion;\n\n    if (!isInUI()) {\n      // we are in the configuration rendering routine, not in actual UI\n      return { config } as any;\n    } else {\n      // normal operation inside the UI\n      return {\n        ...getPlatformaInstance({\n          sdkVersion: PlatformaSDKVersion,\n          apiVersion: platformaApiVersion,\n        }),\n        blockModelInfo: {\n          outputs: Object.fromEntries(\n            Object.entries(this.config.outputs).map(([key, value]) => [\n              key,\n              {\n                withStatus: Boolean(isConfigLambda(value) && value.withStatus),\n              },\n            ]),\n          ),\n          pluginIds: [],\n          featureFlags: this.config.featureFlags,\n        },\n      };\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/block_state_patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_state_patch.d.ts","names":[],"sources":["../src/block_state_patch.ts"],"mappings":";;;;KAGY,KAAA;EAAA,mCAED,GAAA,EAAK,CAAA,EAFC;EAAA,SAIN,KAAA,EAAO,CAAA;AAAA;;KAIN,QAAA,WAAmB,MAAA,mCACjB,CAAA,GAAI,KAAA,CAAM,CAAA,EAAG,CAAA,CAAE,CAAA,WACrB,CAAA;;KAGI,eAAA,iCAEM,gBAAA,GAAmB,gBAAA,iEAGjC,QAAA,CAAS,UAAA,CAAW,IAAA,EAAM,OAAA,EAAS,OAAA,EAAS,IAAA"}

package/dist/block_state_util.cjs

@@ -1,4 +1,3 @@
-
 //#region src/block_state_util.ts
 var OutputError = class extends Error {
 	constructor(errors, moreErrors) {
@@ -16,9 +15,9 @@ function wrapOutputs(outputs) {
 		return readOutput(target[key]);
 	} });
 }
-
 //#endregion
 exports.OutputError = OutputError;
 exports.readOutput = readOutput;
 exports.wrapOutputs = wrapOutputs;
+
 //# sourceMappingURL=block_state_util.cjs.map

package/dist/block_state_util.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"block_state_util.cjs","names":[],"sources":["../src/block_state_util.ts"],"sourcesContent":["import type { BlockOutputsBase, OutputWithStatus } from \"@milaboratories/pl-model-common\";\nimport type { ErrorLike } from \"@milaboratories/pl-error-like\";\n\nexport class OutputError extends Error {\n  constructor(\n    public readonly errors: ErrorLike[],\n    public readonly moreErrors: boolean,\n  ) {\n    super(`${errors.length}${moreErrors ? \"+\" : \"\"} errors, first error: ` + errors[0].message);\n  }\n}\n\nexport function readOutput<T>(outputValue: OutputWithStatus<T>): T {\n  if (!outputValue.ok) throw new OutputError(outputValue.errors, outputValue.moreErrors);\n  return outputValue.value;\n}\n\ntype ExtractValueType<V extends OutputWithStatus<unknown>> = Extract<V, { ok: true }>[\"value\"];\ntype SimpleOutputs<Outputs extends BlockOutputsBase> = {\n  [Key in keyof Outputs]: ExtractValueType<Outputs[Key]>;\n};\n\nexport function wrapOutputs<Outputs extends BlockOutputsBase>(\n  outputs: Outputs,\n): SimpleOutputs<Outputs> {\n  return new Proxy(outputs, {\n    get(target, key: string) {\n      return readOutput(target[key]);\n    },\n  }) as SimpleOutputs<Outputs>;\n}\n"],"mappings":";;AAGA,IAAa,cAAb,cAAiC,MAAM;CACrC,YACE,AAAgB,QAChB,AAAgB,YAChB;AACA,QAAM,GAAG,OAAO,SAAS,aAAa,MAAM,GAAG,0BAA0B,OAAO,GAAG,QAAQ;EAH3E;EACA;;;AAMpB,SAAgB,WAAc,aAAqC;AACjE,KAAI,CAAC,YAAY,GAAI,OAAM,IAAI,YAAY,YAAY,QAAQ,YAAY,WAAW;AACtF,QAAO,YAAY;;AAQrB,SAAgB,YACd,SACwB;AACxB,QAAO,IAAI,MAAM,SAAS,EACxB,IAAI,QAAQ,KAAa;AACvB,SAAO,WAAW,OAAO,KAAK;IAEjC,CAAC"}
+{"version":3,"file":"block_state_util.cjs","names":[],"sources":["../src/block_state_util.ts"],"sourcesContent":["import type { BlockOutputsBase, OutputWithStatus } from \"@milaboratories/pl-model-common\";\nimport type { ErrorLike } from \"@milaboratories/pl-error-like\";\n\nexport class OutputError extends Error {\n  constructor(\n    public readonly errors: ErrorLike[],\n    public readonly moreErrors: boolean,\n  ) {\n    super(`${errors.length}${moreErrors ? \"+\" : \"\"} errors, first error: ` + errors[0].message);\n  }\n}\n\nexport function readOutput<T>(outputValue: OutputWithStatus<T>): T {\n  if (!outputValue.ok) throw new OutputError(outputValue.errors, outputValue.moreErrors);\n  return outputValue.value;\n}\n\ntype ExtractValueType<V extends OutputWithStatus<unknown>> = Extract<V, { ok: true }>[\"value\"];\ntype SimpleOutputs<Outputs extends BlockOutputsBase> = {\n  [Key in keyof Outputs]: ExtractValueType<Outputs[Key]>;\n};\n\nexport function wrapOutputs<Outputs extends BlockOutputsBase>(\n  outputs: Outputs,\n): SimpleOutputs<Outputs> {\n  return new Proxy(outputs, {\n    get(target, key: string) {\n      return readOutput(target[key]);\n    },\n  }) as SimpleOutputs<Outputs>;\n}\n"],"mappings":";AAGA,IAAa,cAAb,cAAiC,MAAM;CACrC,YACE,QACA,YACA;AACA,QAAM,GAAG,OAAO,SAAS,aAAa,MAAM,GAAG,0BAA0B,OAAO,GAAG,QAAQ;AAH3E,OAAA,SAAA;AACA,OAAA,aAAA;;;AAMpB,SAAgB,WAAc,aAAqC;AACjE,KAAI,CAAC,YAAY,GAAI,OAAM,IAAI,YAAY,YAAY,QAAQ,YAAY,WAAW;AACtF,QAAO,YAAY;;AAQrB,SAAgB,YACd,SACwB;AACxB,QAAO,IAAI,MAAM,SAAS,EACxB,IAAI,QAAQ,KAAa;AACvB,SAAO,WAAW,OAAO,KAAK;IAEjC,CAAC"}

package/dist/block_state_util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_state_util.d.ts","names":[],"sources":["../src/block_state_util.ts"],"mappings":";;;;cAGa,WAAA,SAAoB,KAAA;EAAA,SAEb,MAAA,EAAQ,SAAA;EAAA,SACR,UAAA;cADA,MAAA,EAAQ,SAAA,IACR,UAAA;AAAA;AAAA,iBAMJ,UAAA,GAAA,CAAc,WAAA,EAAa,gBAAA,CAAiB,CAAA,IAAK,CAAA;AAAA,KAK5D,gBAAA,WAA2B,gBAAA,aAA6B,OAAA,CAAQ,CAAA;EAAK,EAAA;AAAA;AAAA,KACrE,aAAA,iBAA8B,gBAAA,oBACnB,OAAA,GAAU,gBAAA,CAAiB,OAAA,CAAQ,GAAA;AAAA,iBAGnC,WAAA,iBAA4B,gBAAA,CAAA,CAC1C,OAAA,EAAS,OAAA,GACR,aAAA,CAAc,OAAA"}

package/dist/block_state_util.js

@@ -15,7 +15,7 @@ function wrapOutputs(outputs) {
 		return readOutput(target[key]);
 	} });
 }
-
 //#endregion
 export { OutputError, readOutput, wrapOutputs };
+
 //# sourceMappingURL=block_state_util.js.map

package/dist/block_state_util.js.map

@@ -1 +1 @@
-{"version":3,"file":"block_state_util.js","names":[],"sources":["../src/block_state_util.ts"],"sourcesContent":["import type { BlockOutputsBase, OutputWithStatus } from \"@milaboratories/pl-model-common\";\nimport type { ErrorLike } from \"@milaboratories/pl-error-like\";\n\nexport class OutputError extends Error {\n  constructor(\n    public readonly errors: ErrorLike[],\n    public readonly moreErrors: boolean,\n  ) {\n    super(`${errors.length}${moreErrors ? \"+\" : \"\"} errors, first error: ` + errors[0].message);\n  }\n}\n\nexport function readOutput<T>(outputValue: OutputWithStatus<T>): T {\n  if (!outputValue.ok) throw new OutputError(outputValue.errors, outputValue.moreErrors);\n  return outputValue.value;\n}\n\ntype ExtractValueType<V extends OutputWithStatus<unknown>> = Extract<V, { ok: true }>[\"value\"];\ntype SimpleOutputs<Outputs extends BlockOutputsBase> = {\n  [Key in keyof Outputs]: ExtractValueType<Outputs[Key]>;\n};\n\nexport function wrapOutputs<Outputs extends BlockOutputsBase>(\n  outputs: Outputs,\n): SimpleOutputs<Outputs> {\n  return new Proxy(outputs, {\n    get(target, key: string) {\n      return readOutput(target[key]);\n    },\n  }) as SimpleOutputs<Outputs>;\n}\n"],"mappings":";AAGA,IAAa,cAAb,cAAiC,MAAM;CACrC,YACE,AAAgB,QAChB,AAAgB,YAChB;AACA,QAAM,GAAG,OAAO,SAAS,aAAa,MAAM,GAAG,0BAA0B,OAAO,GAAG,QAAQ;EAH3E;EACA;;;AAMpB,SAAgB,WAAc,aAAqC;AACjE,KAAI,CAAC,YAAY,GAAI,OAAM,IAAI,YAAY,YAAY,QAAQ,YAAY,WAAW;AACtF,QAAO,YAAY;;AAQrB,SAAgB,YACd,SACwB;AACxB,QAAO,IAAI,MAAM,SAAS,EACxB,IAAI,QAAQ,KAAa;AACvB,SAAO,WAAW,OAAO,KAAK;IAEjC,CAAC"}
+{"version":3,"file":"block_state_util.js","names":[],"sources":["../src/block_state_util.ts"],"sourcesContent":["import type { BlockOutputsBase, OutputWithStatus } from \"@milaboratories/pl-model-common\";\nimport type { ErrorLike } from \"@milaboratories/pl-error-like\";\n\nexport class OutputError extends Error {\n  constructor(\n    public readonly errors: ErrorLike[],\n    public readonly moreErrors: boolean,\n  ) {\n    super(`${errors.length}${moreErrors ? \"+\" : \"\"} errors, first error: ` + errors[0].message);\n  }\n}\n\nexport function readOutput<T>(outputValue: OutputWithStatus<T>): T {\n  if (!outputValue.ok) throw new OutputError(outputValue.errors, outputValue.moreErrors);\n  return outputValue.value;\n}\n\ntype ExtractValueType<V extends OutputWithStatus<unknown>> = Extract<V, { ok: true }>[\"value\"];\ntype SimpleOutputs<Outputs extends BlockOutputsBase> = {\n  [Key in keyof Outputs]: ExtractValueType<Outputs[Key]>;\n};\n\nexport function wrapOutputs<Outputs extends BlockOutputsBase>(\n  outputs: Outputs,\n): SimpleOutputs<Outputs> {\n  return new Proxy(outputs, {\n    get(target, key: string) {\n      return readOutput(target[key]);\n    },\n  }) as SimpleOutputs<Outputs>;\n}\n"],"mappings":";AAGA,IAAa,cAAb,cAAiC,MAAM;CACrC,YACE,QACA,YACA;AACA,QAAM,GAAG,OAAO,SAAS,aAAa,MAAM,GAAG,0BAA0B,OAAO,GAAG,QAAQ;AAH3E,OAAA,SAAA;AACA,OAAA,aAAA;;;AAMpB,SAAgB,WAAc,aAAqC;AACjE,KAAI,CAAC,YAAY,GAAI,OAAM,IAAI,YAAY,YAAY,QAAQ,YAAY,WAAW;AACtF,QAAO,YAAY;;AAQrB,SAAgB,YACd,SACwB;AACxB,QAAO,IAAI,MAAM,SAAS,EACxB,IAAI,QAAQ,KAAa;AACvB,SAAO,WAAW,OAAO,KAAK;IAEjC,CAAC"}

package/dist/block_storage.cjs

@@ -1,5 +1,4 @@
-const require_block_migrations = require('./block_migrations.cjs');
-
+const require_block_migrations = require("./block_migrations.cjs");
 //#region src/block_storage.ts
 /**
 * Discriminator key for BlockStorage format detection.
@@ -7,11 +6,6 @@ const require_block_migrations = require('./block_migrations.cjs');
 */
 const BLOCK_STORAGE_KEY = "__pl_a7f3e2b9__";
 /**
-* Current BlockStorage schema version.
-* Increment this when the storage structure itself changes (not block state migrations).
-*/
-const BLOCK_STORAGE_SCHEMA_VERSION = "v1";
-/**
 * Default data version for new blocks without migrations.
 * Unique identifier ensures blocks are created via DataModel API.
 */
@@ -33,7 +27,7 @@ function isBlockStorage(value) {
 */
 function createBlockStorage(initialData = {}, version = DATA_MODEL_LEGACY_VERSION) {
 	return {
-		[BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,
+		[BLOCK_STORAGE_KEY]: "v1",
 		__dataVersion: version,
 		__data: initialData,
 		__pluginRegistry: {},
@@ -99,7 +93,7 @@ function updateStorageData(storage, payload) {
 		case "update-plugin-data": {
 			const { pluginId, value } = payload;
 			const currentPlugins = storage.__plugins ?? {};
-			const version = currentPlugins[pluginId]?.__dataVersion ?? DATA_MODEL_LEGACY_VERSION;
+			const version = currentPlugins[pluginId]?.__dataVersion ?? "__pl_v1_d4e8f2a1__";
 			return {
 				...storage,
 				__plugins: {
@@ -235,7 +229,7 @@ function migrateBlockStorage(storage, config) {
 	return {
 		success: true,
 		storage: {
-			[BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,
+			[BLOCK_STORAGE_KEY]: "v1",
 			__dataVersion: newVersion,
 			__data: migratedData,
 			__pluginRegistry: newPluginRegistry,
@@ -260,10 +254,8 @@ function getPluginData(rawStorage, handle) {
 	if (!pluginEntry) throw new Error(`Plugin '${handle}' not found in block storage`);
 	return pluginEntry.__data;
 }
-
 //#endregion
 exports.BLOCK_STORAGE_KEY = BLOCK_STORAGE_KEY;
-exports.BLOCK_STORAGE_SCHEMA_VERSION = BLOCK_STORAGE_SCHEMA_VERSION;
 exports.DATA_MODEL_LEGACY_VERSION = DATA_MODEL_LEGACY_VERSION;
 exports.createBlockStorage = createBlockStorage;
 exports.deriveDataFromStorage = deriveDataFromStorage;
@@ -273,4 +265,5 @@ exports.isBlockStorage = isBlockStorage;
 exports.migrateBlockStorage = migrateBlockStorage;
 exports.normalizeBlockStorage = normalizeBlockStorage;
 exports.updateStorageData = updateStorageData;
+
 //# sourceMappingURL=block_storage.cjs.map

package/dist/block_storage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"block_storage.cjs","names":["isDataUnrecoverableError"],"sources":["../src/block_storage.ts"],"sourcesContent":["/**\n * BlockStorage - Typed storage abstraction for block persistent data.\n *\n * This module provides:\n * - A typed structure for block storage with versioning and plugin support\n * - Utility functions for manipulating storage\n * - Handler interfaces for model-level customization\n *\n * @module block_storage\n */\n\nimport type { Branded } from \"@milaboratories/pl-model-common\";\nimport {\n  type DataVersioned,\n  type TransferRecord,\n  isDataUnrecoverableError,\n} from \"./block_migrations\";\nimport type { PluginHandle, PluginFactoryLike, InferFactoryData } from \"./plugin_handle\";\n\n// =============================================================================\n// Core Types\n// =============================================================================\n\n/**\n * Discriminator key for BlockStorage format detection.\n * This unique hash-based key identifies data as BlockStorage vs legacy formats.\n */\nexport const BLOCK_STORAGE_KEY = \"__pl_a7f3e2b9__\";\n\n/**\n * Current BlockStorage schema version.\n * Increment this when the storage structure itself changes (not block state migrations).\n */\nexport const BLOCK_STORAGE_SCHEMA_VERSION = \"v1\";\n\n/**\n * Default data version for new blocks without migrations.\n * Unique identifier ensures blocks are created via DataModel API.\n */\nexport const DATA_MODEL_LEGACY_VERSION = \"__pl_v1_d4e8f2a1__\";\n\n/**\n * Type for valid schema versions\n */\nexport type BlockStorageSchemaVersion = \"v1\"; // Add 'v2', 'v3', etc. as schema evolves\n\n/**\n * Branded type for plugin names - globally unique plugin type identifiers.\n * Using a branded type enforces explicit casting (`as PluginName`) which makes\n * it easy to find all plugin name definitions in the codebase and verify uniqueness.\n */\nexport type PluginName = Branded<string, \"PluginName\">;\n\n/**\n * Plugin registry - maps pluginId (unique within a block) to pluginName (globally unique plugin type).\n * Using a Record highlights that pluginIds must be unique within a block.\n */\nexport type PluginRegistry = Record<PluginHandle, PluginName>;\n\n/**\n * Versioned data - used for both block data and plugin data\n */\nexport interface VersionedData<TData = unknown> {\n  /** Version of the data, used for migrations */\n  __dataVersion: string;\n  /** The persistent data */\n  __data: TData;\n}\n\n/**\n * Core BlockStorage type that holds:\n * - __pl_a7f3e2b9__: Schema version (discriminator key identifies BlockStorage format)\n * - __dataVersion: Version key for block data migrations\n * - __data: The block's user-facing data (state)\n * - __pluginRegistry: Map from pluginId to pluginName (optional)\n * - __plugins: Plugin-specific data keyed by pluginId (optional)\n */\nexport type BlockStorage<TState = unknown> = {\n  /** Schema version - the key itself is the discriminator */\n  readonly [BLOCK_STORAGE_KEY]: BlockStorageSchemaVersion;\n  /** Registry of plugins: pluginId -> pluginName */\n  __pluginRegistry?: PluginRegistry;\n  /** Plugin-specific data, keyed by plugin handle */\n  __plugins?: Record<PluginHandle, VersionedData<unknown>>;\n} & VersionedData<TState>;\n\n/**\n * Type guard to check if a value is a valid BlockStorage object.\n * Checks for the discriminator key and valid schema version.\n */\nexport function isBlockStorage(value: unknown): value is BlockStorage {\n  if (value === null || typeof value !== \"object\") return false;\n  const obj = value as Record<string, unknown>;\n  const schemaVersion = obj[BLOCK_STORAGE_KEY];\n  // Currently only 'v1' is valid, but this allows future versions\n  return schemaVersion === \"v1\"; // Add more versions as schema evolves\n}\n\n// =============================================================================\n// Factory Functions\n// =============================================================================\n\n/**\n * Creates a BlockStorage with the given initial data\n *\n * @param initialData - The initial data value (defaults to empty object)\n * @param version - The initial data version key (defaults to DATA_MODEL_LEGACY_VERSION)\n * @returns A new BlockStorage instance with discriminator key\n */\nexport function createBlockStorage<TState = unknown>(\n  initialData: TState = {} as TState,\n  version: string = DATA_MODEL_LEGACY_VERSION,\n): BlockStorage<TState> {\n  return {\n    [BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,\n    __dataVersion: version,\n    __data: initialData,\n    __pluginRegistry: {},\n    __plugins: {},\n  };\n}\n\n/**\n * Normalizes raw storage data to BlockStorage format.\n * If the input is already a BlockStorage, returns it as-is (with defaults for missing fields).\n * If the input is legacy format (raw state), wraps it in BlockStorage structure.\n *\n * @param raw - Raw storage data (may be legacy format or BlockStorage)\n * @returns Normalized BlockStorage\n */\nexport function normalizeBlockStorage<TState = unknown>(raw: unknown): BlockStorage<TState> {\n  if (isBlockStorage(raw)) {\n    const storage = raw as BlockStorage<TState>;\n    return {\n      ...storage,\n      // Fix for early released version where __dataVersion was a number\n      __dataVersion:\n        typeof storage.__dataVersion === \"number\"\n          ? DATA_MODEL_LEGACY_VERSION\n          : storage.__dataVersion,\n      // Ensure plugin fields have defaults\n      __pluginRegistry: storage.__pluginRegistry ?? {},\n      __plugins: storage.__plugins ?? {},\n    };\n  }\n  // Legacy format: raw is the state directly\n  return createBlockStorage(raw as TState);\n}\n\n// =============================================================================\n// Data Access & Update Functions\n// =============================================================================\n\n/**\n * Gets the data from BlockStorage\n *\n * @param storage - The BlockStorage instance\n * @returns The data value\n */\nexport function getStorageData<TState>(storage: BlockStorage<TState>): TState {\n  return storage.__data;\n}\n\n/**\n * Derives data from raw block storage.\n * This function is meant to be called from sdk/ui-vue to extract\n * user-facing data from the raw storage returned by the middle layer.\n *\n * The middle layer returns raw storage (opaque to it), and the UI\n * uses this function to derive the actual data value.\n *\n * @param rawStorage - Raw storage data from middle layer (may be any format)\n * @returns The extracted data value, or undefined if storage is undefined/null\n */\nexport function deriveDataFromStorage<TData = unknown>(rawStorage: unknown): TData {\n  // Normalize to BlockStorage format (handles legacy formats too)\n  const storage = normalizeBlockStorage<TData>(rawStorage);\n  return getStorageData(storage);\n}\n\n/** Payload for storage mutation operations. SDK defines specific operations. */\nexport type MutateStoragePayload<T = unknown> =\n  | { operation: \"update-block-data\"; value: T }\n  | { operation: \"update-plugin-data\"; pluginId: PluginHandle; value: unknown };\n\n/**\n * Updates the data in BlockStorage (immutable)\n *\n * @param storage - The current BlockStorage\n * @param payload - The update payload with operation and value\n * @returns A new BlockStorage with updated data\n */\nexport function updateStorageData<TValue = unknown>(\n  storage: BlockStorage<TValue>,\n  payload: MutateStoragePayload<TValue>,\n): BlockStorage<TValue> {\n  switch (payload.operation) {\n    case \"update-block-data\":\n      return { ...storage, __data: payload.value };\n    case \"update-plugin-data\": {\n      const { pluginId, value } = payload;\n      const currentPlugins = storage.__plugins ?? {};\n      const existingEntry = currentPlugins[pluginId];\n      const version = existingEntry?.__dataVersion ?? DATA_MODEL_LEGACY_VERSION;\n      return {\n        ...storage,\n        __plugins: {\n          ...currentPlugins,\n          [pluginId]: {\n            __dataVersion: version,\n            __data: value,\n          },\n        },\n      };\n    }\n    default:\n      throw new Error(`Unknown storage operation: ${(payload as { operation: string }).operation}`);\n  }\n}\n\n// =============================================================================\n// Atomic Migration\n// =============================================================================\n\n/**\n * Result of a successful atomic migration.\n */\nexport interface MigrationSuccess<TState> {\n  success: true;\n  /** The fully migrated storage - commit this to persist */\n  storage: BlockStorage<TState>;\n}\n\n/**\n * Result of a failed atomic migration.\n * The original storage is untouched - user must choose to abort or reset.\n */\nexport interface MigrationFailure {\n  success: false;\n  /** Description of what failed */\n  error: string;\n  /** Which step failed: 'block' or pluginId */\n  failedAt: string;\n}\n\nexport type MigrationResult<TState> = MigrationSuccess<TState> | MigrationFailure;\n\n/**\n * Configuration for atomic block storage migration.\n * Callbacks use DataVersioned format (the DataModel API format).\n * Conversion to internal VersionedData format is handled by migrateBlockStorage().\n */\nexport interface MigrateBlockStorageConfig {\n  /** Migrate block data from any version to latest. Returns migrated data and transfers. */\n  migrateBlockData: (versioned: DataVersioned<unknown>) => DataVersioned<unknown> & {\n    transfers: TransferRecord;\n  };\n  /** Migrate each plugin's data. Return undefined to remove the plugin. Throws on failure. */\n  migratePluginData: (\n    handle: PluginHandle,\n    versioned: DataVersioned<unknown>,\n  ) => DataVersioned<unknown> | undefined;\n  /** The new plugin registry after migration (pluginId -> pluginName) */\n  newPluginRegistry: PluginRegistry;\n  /** Factory to create initial data for new plugins. Transfer is provided when a\n   *  .transfer() was defined for this plugin in the block's migration chain. */\n  createPluginData: (\n    handle: PluginHandle,\n    transfer?: DataVersioned<unknown>,\n  ) => DataVersioned<unknown>;\n}\n\n/**\n * Performs atomic migration of block storage including block data and all plugins.\n *\n * Migration is atomic: either everything succeeds and a new storage is returned,\n * or an error is returned and the original storage is completely untouched.\n *\n * Migration steps:\n * 1. Migrate block data\n * 2. For each plugin in newPluginRegistry:\n *    - If plugin exists with same name: migrate its data\n *    - Otherwise (new or type changed): create with initial data\n *    Plugins not in newPluginRegistry are dropped.\n *\n * If any step throws, migration fails and original storage is preserved.\n * User can then choose to:\n * - Abort: keep original storage, don't update block\n * - Reset: call createBlockStorage() to start fresh\n *\n * @param storage - The original storage (will not be modified)\n * @param config - Migration configuration\n * @returns Migration result - either success with new storage, or failure with error info\n *\n * @example\n * const result = migrateBlockStorage(storage, {\n *   migrateBlockData: (versioned) => blockDataModel.migrate(versioned),\n *   migratePluginData: (pluginId, versioned) => getPluginModel(pluginId).migrate(versioned),\n *   newPluginRegistry: { table1: 'dataTable' as PluginName },\n *   createPluginData: (pluginId) => getPluginModel(pluginId).getDefaultData(),\n * });\n *\n * if (result.success) {\n *   commitStorage(result.storage);\n * } else {\n *   const userChoice = await askUser(`Migration failed: ${result.error}. Reset data?`);\n *   if (userChoice === 'reset') {\n *     commitStorage(createBlockStorage(initialData, currentVersion));\n *   }\n *   // else: abort, keep original\n * }\n */\nexport function migrateBlockStorage(\n  storage: BlockStorage<unknown>,\n  config: MigrateBlockStorageConfig,\n): MigrationResult<unknown> {\n  const { migrateBlockData, migratePluginData, newPluginRegistry, createPluginData } = config;\n\n  // Step 1: Migrate block data and collect transfers\n  let migratedData: unknown;\n  let newVersion: string;\n  let transfers: TransferRecord;\n  try {\n    const result = migrateBlockData({ version: storage.__dataVersion, data: storage.__data });\n    migratedData = result.data;\n    newVersion = result.version;\n    transfers = result.transfers;\n  } catch (error) {\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n      failedAt: \"block\",\n    };\n  }\n\n  // Step 2: Migrate plugins\n  const oldPlugins = storage.__plugins ?? {};\n  const oldRegistry = storage.__pluginRegistry ?? {};\n  const newPlugins: Record<PluginHandle, VersionedData<unknown>> = {};\n\n  for (const [key, pluginName] of Object.entries(newPluginRegistry)) {\n    const handle = key as PluginHandle;\n    const existingEntry = oldPlugins[handle];\n    const existingName = oldRegistry[handle];\n\n    try {\n      if (existingEntry && existingName === pluginName) {\n        // Plugin exists with same type - migrate its data\n        const migrated = migratePluginData(handle, {\n          version: existingEntry.__dataVersion,\n          data: existingEntry.__data,\n        });\n        if (migrated) {\n          newPlugins[handle] = { __dataVersion: migrated.version, __data: migrated.data };\n        }\n        // If undefined returned, plugin is intentionally removed\n      } else if (existingEntry) {\n        // Plugin type changed — pass old data with DATA_MODEL_LEGACY_VERSION.\n        // If the new plugin has upgradeLegacy(), it migrates the old data.\n        // If not, defaultRecover throws DataUnrecoverableError → fall back to init.\n        let recovered = false;\n        try {\n          const migrated = migratePluginData(handle, {\n            version: DATA_MODEL_LEGACY_VERSION,\n            data: existingEntry.__data,\n          });\n          if (migrated) {\n            newPlugins[handle] = { __dataVersion: migrated.version, __data: migrated.data };\n            recovered = true;\n          }\n        } catch (recoverError) {\n          if (!isDataUnrecoverableError(recoverError)) throw recoverError;\n        }\n        if (!recovered) {\n          const transfer = transfers[handle];\n          const initial = createPluginData(handle, transfer);\n          newPlugins[handle] = { __dataVersion: initial.version, __data: initial.data };\n        }\n      } else {\n        // New plugin - create with initial data, passing transfer if available\n        const transfer = transfers[handle];\n        const initial = createPluginData(handle, transfer);\n        newPlugins[handle] = { __dataVersion: initial.version, __data: initial.data };\n      }\n    } catch (error) {\n      return {\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n        failedAt: handle,\n      };\n    }\n  }\n\n  // Step 3: Build final storage atomically\n  const migratedStorage: BlockStorage = {\n    [BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,\n    __dataVersion: newVersion,\n    __data: migratedData,\n    __pluginRegistry: newPluginRegistry,\n    __plugins: newPlugins,\n  };\n\n  return {\n    success: true,\n    storage: migratedStorage,\n  };\n}\n\n/**\n * Gets plugin-specific data from block storage.\n * Accepts raw storage (any format) and normalizes internally.\n *\n * When called with a typed PluginHandle<F>, the return type is automatically\n * inferred from the factory's phantom `__types.data` field.\n *\n * @param rawStorage - Raw block storage (may be legacy format or BlockStorage)\n * @param handle - The plugin handle (branded plugin instance id)\n * @returns The plugin data, typed via factory inference\n * @throws If plugin is not found in storage\n */\nexport function getPluginData<F extends PluginFactoryLike>(\n  rawStorage: unknown,\n  handle: PluginHandle<F>,\n): InferFactoryData<F> {\n  const storage = normalizeBlockStorage(rawStorage);\n  const pluginEntry = storage.__plugins?.[handle];\n  if (!pluginEntry) throw new Error(`Plugin '${handle}' not found in block storage`);\n  return pluginEntry.__data as InferFactoryData<F>;\n}\n"],"mappings":"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"}
+{"version":3,"file":"block_storage.cjs","names":["isDataUnrecoverableError"],"sources":["../src/block_storage.ts"],"sourcesContent":["/**\n * BlockStorage - Typed storage abstraction for block persistent data.\n *\n * This module provides:\n * - A typed structure for block storage with versioning and plugin support\n * - Utility functions for manipulating storage\n * - Handler interfaces for model-level customization\n *\n * @module block_storage\n */\n\nimport type { Branded } from \"@milaboratories/pl-model-common\";\nimport {\n  type DataVersioned,\n  type TransferRecord,\n  isDataUnrecoverableError,\n} from \"./block_migrations\";\nimport type { PluginHandle, PluginFactoryLike, InferFactoryData } from \"./plugin_handle\";\n\n// =============================================================================\n// Core Types\n// =============================================================================\n\n/**\n * Discriminator key for BlockStorage format detection.\n * This unique hash-based key identifies data as BlockStorage vs legacy formats.\n */\nexport const BLOCK_STORAGE_KEY = \"__pl_a7f3e2b9__\";\n\n/**\n * Current BlockStorage schema version.\n * Increment this when the storage structure itself changes (not block state migrations).\n */\nexport const BLOCK_STORAGE_SCHEMA_VERSION = \"v1\";\n\n/**\n * Default data version for new blocks without migrations.\n * Unique identifier ensures blocks are created via DataModel API.\n */\nexport const DATA_MODEL_LEGACY_VERSION = \"__pl_v1_d4e8f2a1__\";\n\n/**\n * Type for valid schema versions\n */\nexport type BlockStorageSchemaVersion = \"v1\"; // Add 'v2', 'v3', etc. as schema evolves\n\n/**\n * Branded type for plugin names - globally unique plugin type identifiers.\n * Using a branded type enforces explicit casting (`as PluginName`) which makes\n * it easy to find all plugin name definitions in the codebase and verify uniqueness.\n */\nexport type PluginName = Branded<string, \"PluginName\">;\n\n/**\n * Plugin registry - maps pluginId (unique within a block) to pluginName (globally unique plugin type).\n * Using a Record highlights that pluginIds must be unique within a block.\n */\nexport type PluginRegistry = Record<PluginHandle, PluginName>;\n\n/**\n * Versioned data - used for both block data and plugin data\n */\nexport interface VersionedData<TData = unknown> {\n  /** Version of the data, used for migrations */\n  __dataVersion: string;\n  /** The persistent data */\n  __data: TData;\n}\n\n/**\n * Core BlockStorage type that holds:\n * - __pl_a7f3e2b9__: Schema version (discriminator key identifies BlockStorage format)\n * - __dataVersion: Version key for block data migrations\n * - __data: The block's user-facing data (state)\n * - __pluginRegistry: Map from pluginId to pluginName (optional)\n * - __plugins: Plugin-specific data keyed by pluginId (optional)\n */\nexport type BlockStorage<TState = unknown> = {\n  /** Schema version - the key itself is the discriminator */\n  readonly [BLOCK_STORAGE_KEY]: BlockStorageSchemaVersion;\n  /** Registry of plugins: pluginId -> pluginName */\n  __pluginRegistry?: PluginRegistry;\n  /** Plugin-specific data, keyed by plugin handle */\n  __plugins?: Record<PluginHandle, VersionedData<unknown>>;\n} & VersionedData<TState>;\n\n/**\n * Type guard to check if a value is a valid BlockStorage object.\n * Checks for the discriminator key and valid schema version.\n */\nexport function isBlockStorage(value: unknown): value is BlockStorage {\n  if (value === null || typeof value !== \"object\") return false;\n  const obj = value as Record<string, unknown>;\n  const schemaVersion = obj[BLOCK_STORAGE_KEY];\n  // Currently only 'v1' is valid, but this allows future versions\n  return schemaVersion === \"v1\"; // Add more versions as schema evolves\n}\n\n// =============================================================================\n// Factory Functions\n// =============================================================================\n\n/**\n * Creates a BlockStorage with the given initial data\n *\n * @param initialData - The initial data value (defaults to empty object)\n * @param version - The initial data version key (defaults to DATA_MODEL_LEGACY_VERSION)\n * @returns A new BlockStorage instance with discriminator key\n */\nexport function createBlockStorage<TState = unknown>(\n  initialData: TState = {} as TState,\n  version: string = DATA_MODEL_LEGACY_VERSION,\n): BlockStorage<TState> {\n  return {\n    [BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,\n    __dataVersion: version,\n    __data: initialData,\n    __pluginRegistry: {},\n    __plugins: {},\n  };\n}\n\n/**\n * Normalizes raw storage data to BlockStorage format.\n * If the input is already a BlockStorage, returns it as-is (with defaults for missing fields).\n * If the input is legacy format (raw state), wraps it in BlockStorage structure.\n *\n * @param raw - Raw storage data (may be legacy format or BlockStorage)\n * @returns Normalized BlockStorage\n */\nexport function normalizeBlockStorage<TState = unknown>(raw: unknown): BlockStorage<TState> {\n  if (isBlockStorage(raw)) {\n    const storage = raw as BlockStorage<TState>;\n    return {\n      ...storage,\n      // Fix for early released version where __dataVersion was a number\n      __dataVersion:\n        typeof storage.__dataVersion === \"number\"\n          ? DATA_MODEL_LEGACY_VERSION\n          : storage.__dataVersion,\n      // Ensure plugin fields have defaults\n      __pluginRegistry: storage.__pluginRegistry ?? {},\n      __plugins: storage.__plugins ?? {},\n    };\n  }\n  // Legacy format: raw is the state directly\n  return createBlockStorage(raw as TState);\n}\n\n// =============================================================================\n// Data Access & Update Functions\n// =============================================================================\n\n/**\n * Gets the data from BlockStorage\n *\n * @param storage - The BlockStorage instance\n * @returns The data value\n */\nexport function getStorageData<TState>(storage: BlockStorage<TState>): TState {\n  return storage.__data;\n}\n\n/**\n * Derives data from raw block storage.\n * This function is meant to be called from sdk/ui-vue to extract\n * user-facing data from the raw storage returned by the middle layer.\n *\n * The middle layer returns raw storage (opaque to it), and the UI\n * uses this function to derive the actual data value.\n *\n * @param rawStorage - Raw storage data from middle layer (may be any format)\n * @returns The extracted data value, or undefined if storage is undefined/null\n */\nexport function deriveDataFromStorage<TData = unknown>(rawStorage: unknown): TData {\n  // Normalize to BlockStorage format (handles legacy formats too)\n  const storage = normalizeBlockStorage<TData>(rawStorage);\n  return getStorageData(storage);\n}\n\n/** Payload for storage mutation operations. SDK defines specific operations. */\nexport type MutateStoragePayload<T = unknown> =\n  | { operation: \"update-block-data\"; value: T }\n  | { operation: \"update-plugin-data\"; pluginId: PluginHandle; value: unknown };\n\n/**\n * Updates the data in BlockStorage (immutable)\n *\n * @param storage - The current BlockStorage\n * @param payload - The update payload with operation and value\n * @returns A new BlockStorage with updated data\n */\nexport function updateStorageData<TValue = unknown>(\n  storage: BlockStorage<TValue>,\n  payload: MutateStoragePayload<TValue>,\n): BlockStorage<TValue> {\n  switch (payload.operation) {\n    case \"update-block-data\":\n      return { ...storage, __data: payload.value };\n    case \"update-plugin-data\": {\n      const { pluginId, value } = payload;\n      const currentPlugins = storage.__plugins ?? {};\n      const existingEntry = currentPlugins[pluginId];\n      const version = existingEntry?.__dataVersion ?? DATA_MODEL_LEGACY_VERSION;\n      return {\n        ...storage,\n        __plugins: {\n          ...currentPlugins,\n          [pluginId]: {\n            __dataVersion: version,\n            __data: value,\n          },\n        },\n      };\n    }\n    default:\n      throw new Error(`Unknown storage operation: ${(payload as { operation: string }).operation}`);\n  }\n}\n\n// =============================================================================\n// Atomic Migration\n// =============================================================================\n\n/**\n * Result of a successful atomic migration.\n */\nexport interface MigrationSuccess<TState> {\n  success: true;\n  /** The fully migrated storage - commit this to persist */\n  storage: BlockStorage<TState>;\n}\n\n/**\n * Result of a failed atomic migration.\n * The original storage is untouched - user must choose to abort or reset.\n */\nexport interface MigrationFailure {\n  success: false;\n  /** Description of what failed */\n  error: string;\n  /** Which step failed: 'block' or pluginId */\n  failedAt: string;\n}\n\nexport type MigrationResult<TState> = MigrationSuccess<TState> | MigrationFailure;\n\n/**\n * Configuration for atomic block storage migration.\n * Callbacks use DataVersioned format (the DataModel API format).\n * Conversion to internal VersionedData format is handled by migrateBlockStorage().\n */\nexport interface MigrateBlockStorageConfig {\n  /** Migrate block data from any version to latest. Returns migrated data and transfers. */\n  migrateBlockData: (versioned: DataVersioned<unknown>) => DataVersioned<unknown> & {\n    transfers: TransferRecord;\n  };\n  /** Migrate each plugin's data. Return undefined to remove the plugin. Throws on failure. */\n  migratePluginData: (\n    handle: PluginHandle,\n    versioned: DataVersioned<unknown>,\n  ) => DataVersioned<unknown> | undefined;\n  /** The new plugin registry after migration (pluginId -> pluginName) */\n  newPluginRegistry: PluginRegistry;\n  /** Factory to create initial data for new plugins. Transfer is provided when a\n   *  .transfer() was defined for this plugin in the block's migration chain. */\n  createPluginData: (\n    handle: PluginHandle,\n    transfer?: DataVersioned<unknown>,\n  ) => DataVersioned<unknown>;\n}\n\n/**\n * Performs atomic migration of block storage including block data and all plugins.\n *\n * Migration is atomic: either everything succeeds and a new storage is returned,\n * or an error is returned and the original storage is completely untouched.\n *\n * Migration steps:\n * 1. Migrate block data\n * 2. For each plugin in newPluginRegistry:\n *    - If plugin exists with same name: migrate its data\n *    - Otherwise (new or type changed): create with initial data\n *    Plugins not in newPluginRegistry are dropped.\n *\n * If any step throws, migration fails and original storage is preserved.\n * User can then choose to:\n * - Abort: keep original storage, don't update block\n * - Reset: call createBlockStorage() to start fresh\n *\n * @param storage - The original storage (will not be modified)\n * @param config - Migration configuration\n * @returns Migration result - either success with new storage, or failure with error info\n *\n * @example\n * const result = migrateBlockStorage(storage, {\n *   migrateBlockData: (versioned) => blockDataModel.migrate(versioned),\n *   migratePluginData: (pluginId, versioned) => getPluginModel(pluginId).migrate(versioned),\n *   newPluginRegistry: { table1: 'dataTable' as PluginName },\n *   createPluginData: (pluginId) => getPluginModel(pluginId).getDefaultData(),\n * });\n *\n * if (result.success) {\n *   commitStorage(result.storage);\n * } else {\n *   const userChoice = await askUser(`Migration failed: ${result.error}. Reset data?`);\n *   if (userChoice === 'reset') {\n *     commitStorage(createBlockStorage(initialData, currentVersion));\n *   }\n *   // else: abort, keep original\n * }\n */\nexport function migrateBlockStorage(\n  storage: BlockStorage<unknown>,\n  config: MigrateBlockStorageConfig,\n): MigrationResult<unknown> {\n  const { migrateBlockData, migratePluginData, newPluginRegistry, createPluginData } = config;\n\n  // Step 1: Migrate block data and collect transfers\n  let migratedData: unknown;\n  let newVersion: string;\n  let transfers: TransferRecord;\n  try {\n    const result = migrateBlockData({ version: storage.__dataVersion, data: storage.__data });\n    migratedData = result.data;\n    newVersion = result.version;\n    transfers = result.transfers;\n  } catch (error) {\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n      failedAt: \"block\",\n    };\n  }\n\n  // Step 2: Migrate plugins\n  const oldPlugins = storage.__plugins ?? {};\n  const oldRegistry = storage.__pluginRegistry ?? {};\n  const newPlugins: Record<PluginHandle, VersionedData<unknown>> = {};\n\n  for (const [key, pluginName] of Object.entries(newPluginRegistry)) {\n    const handle = key as PluginHandle;\n    const existingEntry = oldPlugins[handle];\n    const existingName = oldRegistry[handle];\n\n    try {\n      if (existingEntry && existingName === pluginName) {\n        // Plugin exists with same type - migrate its data\n        const migrated = migratePluginData(handle, {\n          version: existingEntry.__dataVersion,\n          data: existingEntry.__data,\n        });\n        if (migrated) {\n          newPlugins[handle] = { __dataVersion: migrated.version, __data: migrated.data };\n        }\n        // If undefined returned, plugin is intentionally removed\n      } else if (existingEntry) {\n        // Plugin type changed — pass old data with DATA_MODEL_LEGACY_VERSION.\n        // If the new plugin has upgradeLegacy(), it migrates the old data.\n        // If not, defaultRecover throws DataUnrecoverableError → fall back to init.\n        let recovered = false;\n        try {\n          const migrated = migratePluginData(handle, {\n            version: DATA_MODEL_LEGACY_VERSION,\n            data: existingEntry.__data,\n          });\n          if (migrated) {\n            newPlugins[handle] = { __dataVersion: migrated.version, __data: migrated.data };\n            recovered = true;\n          }\n        } catch (recoverError) {\n          if (!isDataUnrecoverableError(recoverError)) throw recoverError;\n        }\n        if (!recovered) {\n          const transfer = transfers[handle];\n          const initial = createPluginData(handle, transfer);\n          newPlugins[handle] = { __dataVersion: initial.version, __data: initial.data };\n        }\n      } else {\n        // New plugin - create with initial data, passing transfer if available\n        const transfer = transfers[handle];\n        const initial = createPluginData(handle, transfer);\n        newPlugins[handle] = { __dataVersion: initial.version, __data: initial.data };\n      }\n    } catch (error) {\n      return {\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n        failedAt: handle,\n      };\n    }\n  }\n\n  // Step 3: Build final storage atomically\n  const migratedStorage: BlockStorage = {\n    [BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,\n    __dataVersion: newVersion,\n    __data: migratedData,\n    __pluginRegistry: newPluginRegistry,\n    __plugins: newPlugins,\n  };\n\n  return {\n    success: true,\n    storage: migratedStorage,\n  };\n}\n\n/**\n * Gets plugin-specific data from block storage.\n * Accepts raw storage (any format) and normalizes internally.\n *\n * When called with a typed PluginHandle<F>, the return type is automatically\n * inferred from the factory's phantom `__types.data` field.\n *\n * @param rawStorage - Raw block storage (may be legacy format or BlockStorage)\n * @param handle - The plugin handle (branded plugin instance id)\n * @returns The plugin data, typed via factory inference\n * @throws If plugin is not found in storage\n */\nexport function getPluginData<F extends PluginFactoryLike>(\n  rawStorage: unknown,\n  handle: PluginHandle<F>,\n): InferFactoryData<F> {\n  const storage = normalizeBlockStorage(rawStorage);\n  const pluginEntry = storage.__plugins?.[handle];\n  if (!pluginEntry) throw new Error(`Plugin '${handle}' not found in block storage`);\n  return pluginEntry.__data as InferFactoryData<F>;\n}\n"],"mappings":"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"}

package/dist/block_storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_storage.d.ts","names":[],"sources":["../src/block_storage.ts"],"mappings":";;;;;;;AAmDA;;cAxBa,iBAAA;;;;KAiBD,yBAAA;;AAkBZ;;;;KAXY,UAAA,GAAa,OAAA;;;;;KAMb,cAAA,GAAiB,MAAA,CAAO,YAAA,EAAc,UAAA;AAoBlD;;;AAAA,UAfiB,aAAA;EAiBL;EAfV,aAAA;EAmBmB;EAjBnB,MAAA,EAAQ,KAAA;AAAA;;;;;;;;;KAWE,YAAA;EAMV,qEAJU,iBAAA,GAAoB,yBAAA,EAIX;EAFnB,gBAAA,GAAmB,cAAA,EAGjB;EADF,SAAA,GAAY,MAAA,CAAO,YAAA,EAAc,aAAA;AAAA,IAC/B,aAAA,CAAc,MAAA;;AAMlB;;;iBAAgB,cAAA,CAAe,KAAA,YAAiB,KAAA,IAAS,YAAA;;;;;;AAmBzD;;iBAAgB,kBAAA,kBAAA,CACd,WAAA,GAAa,MAAA,EACb,OAAA,YACC,YAAA,CAAa,MAAA;;;;;;;;;iBAkBA,qBAAA,kBAAA,CAAwC,GAAA,YAAe,YAAA,CAAa,MAAA;;;;;AAApF;;iBA6BgB,cAAA,QAAA,CAAuB,OAAA,EAAS,YAAA,CAAa,MAAA,IAAU,MAAA;;;;;;;;AAAvE;;;;iBAegB,qBAAA,iBAAA,CAAuC,UAAA,YAAsB,KAAA;;KAOjE,oBAAA;EACN,SAAA;EAAgC,KAAA,EAAO,CAAA;AAAA;EACvC,SAAA;EAAiC,QAAA,EAAU,YAAA;EAAc,KAAA;AAAA;;AAT/D;;;;;;iBAkBgB,iBAAA,kBAAA,CACd,OAAA,EAAS,YAAA,CAAa,MAAA,GACtB,OAAA,EAAS,oBAAA,CAAqB,MAAA,IAC7B,YAAA,CAAa,MAAA;;;AAdhB;UA8CiB,gBAAA;EACf,OAAA;EA7C2D;EA+C3D,OAAA,EAAS,YAAA,CAAa,MAAA;AAAA;;;;;UAOP,gBAAA;EACf,OAAA;EAvDkE;EAyDlE,KAAA;EAhDc;EAkDd,QAAA;AAAA;AAAA,KAGU,eAAA,WAA0B,gBAAA,CAAiB,MAAA,IAAU,gBAAA;;;;;;UAOhD,yBAAA;EAzDF;EA2Db,gBAAA,GAAmB,SAAA,EAAW,aAAA,cAA2B,aAAA;IACvD,SAAA,EAAW,cAAA;EAAA;EA9Db;EAiEA,iBAAA,GACE,MAAA,EAAQ,YAAA,EACR,SAAA,EAAW,aAAA,cACR,aAAA;EAnEyB;EAqE9B,iBAAA,EAAmB,cAAA;EApElB;;EAuED,gBAAA,GACE,MAAA,EAAQ,YAAA,EACR,QAAA,GAAW,aAAA,cACR,aAAA;AAAA;AA1CP;;;;;;;;;;;AAUA;;;;;;;;;AAQA;;;;;;;;;;;;;;AAOA;;;;;;AAzBA,iBAqFgB,mBAAA,CACd,OAAA,EAAS,YAAA,WACT,MAAA,EAAQ,yBAAA,GACP,eAAA;;;;;;;;;;;;;iBAyGa,aAAA,WAAwB,iBAAA,CAAA,CACtC,UAAA,WACA,MAAA,EAAQ,YAAA,CAAa,CAAA,IACpB,gBAAA,CAAiB,CAAA"}

package/dist/block_storage.js

@@ -1,5 +1,4 @@
 import { isDataUnrecoverableError } from "./block_migrations.js";
-
 //#region src/block_storage.ts
 /**
 * Discriminator key for BlockStorage format detection.
@@ -7,11 +6,6 @@ import { isDataUnrecoverableError } from "./block_migrations.js";
 */
 const BLOCK_STORAGE_KEY = "__pl_a7f3e2b9__";
 /**
-* Current BlockStorage schema version.
-* Increment this when the storage structure itself changes (not block state migrations).
-*/
-const BLOCK_STORAGE_SCHEMA_VERSION = "v1";
-/**
 * Default data version for new blocks without migrations.
 * Unique identifier ensures blocks are created via DataModel API.
 */
@@ -33,7 +27,7 @@ function isBlockStorage(value) {
 */
 function createBlockStorage(initialData = {}, version = DATA_MODEL_LEGACY_VERSION) {
 	return {
-		[BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,
+		[BLOCK_STORAGE_KEY]: "v1",
 		__dataVersion: version,
 		__data: initialData,
 		__pluginRegistry: {},
@@ -99,7 +93,7 @@ function updateStorageData(storage, payload) {
 		case "update-plugin-data": {
 			const { pluginId, value } = payload;
 			const currentPlugins = storage.__plugins ?? {};
-			const version = currentPlugins[pluginId]?.__dataVersion ?? DATA_MODEL_LEGACY_VERSION;
+			const version = currentPlugins[pluginId]?.__dataVersion ?? "__pl_v1_d4e8f2a1__";
 			return {
 				...storage,
 				__plugins: {
@@ -235,7 +229,7 @@ function migrateBlockStorage(storage, config) {
 	return {
 		success: true,
 		storage: {
-			[BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,
+			[BLOCK_STORAGE_KEY]: "v1",
 			__dataVersion: newVersion,
 			__data: migratedData,
 			__pluginRegistry: newPluginRegistry,
@@ -260,7 +254,7 @@ function getPluginData(rawStorage, handle) {
 	if (!pluginEntry) throw new Error(`Plugin '${handle}' not found in block storage`);
 	return pluginEntry.__data;
 }
-
 //#endregion
-export { BLOCK_STORAGE_KEY, BLOCK_STORAGE_SCHEMA_VERSION, DATA_MODEL_LEGACY_VERSION, createBlockStorage, deriveDataFromStorage, getPluginData, getStorageData, isBlockStorage, migrateBlockStorage, normalizeBlockStorage, updateStorageData };
+export { BLOCK_STORAGE_KEY, DATA_MODEL_LEGACY_VERSION, createBlockStorage, deriveDataFromStorage, getPluginData, getStorageData, isBlockStorage, migrateBlockStorage, normalizeBlockStorage, updateStorageData };
+
 //# sourceMappingURL=block_storage.js.map