@platforma-sdk/model 1.54.13 → 1.55.0

package/dist/block_model_legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_model_legacy.d.ts","sourceRoot":"","sources":["../src/block_model_legacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EAEZ,KAAK,EACL,0BAA0B,EAE3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGnE,OAAO,KAAK,EAAkC,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAGhF,OAAO,KAAK,EACV,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,KAAK,oBAAoB,GAAG,SAAS,YAAY,EAAE,CAAC;AAEpD,KAAK,kBAAkB,CAAC,GAAG,SAAS,WAAW,EAAE,IAAI,EAAE,OAAO,IAAI,OAAO,CACvE,GAAG,EACH,YAAY,CAAC,GAAG,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS,oBAAoB,GAAG,IAAI,GAAG,KAAK,CAC7F,CAAC;AAEF,KAAK,uBAAuB,GAAG,OAAO,CAAC;AAEvC,KAAK,qBAAqB,CAAC,GAAG,SAAS,WAAW,EAAE,IAAI,EAAE,OAAO,IAAI,OAAO,CAC1E,GAAG,EACH,YAAY,CAAC,GAAG,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS,uBAAuB,GAAG,IAAI,GAAG,KAAK,CAChG,CAAC;AAEF,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAElC;;0EAE0E;AAC1E,qBAAa,UAAU,CACrB,IAAI,EACJ,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,EAC5D,OAAO,EACP,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,GAAG;;IAG7B,OAAO,CAAC,MAAM;IADhB,OAAO;IAgBP,WAAkB,2BAA2B,IAAI,0BAA0B,CAO1E;IAED,sCAAsC;WACxB,MAAM,CAAC,aAAa,EAAE,kBAAkB,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC;IACnF,sCAAsC;WACxB,MAAM,IAAI,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC;IAClD;;;OAGG;WACW,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,kBAAkB,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC;IACzF;;;OAGG;WACW,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC;IAYxD;;;;;;;SAOK;IACE,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,CAAC,GAAG,SAAS,WAAW,EACnE,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,GACP,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG;SAAG,CAAC,IAAI,GAAG,GAAG,GAAG;KAAE,EAAE,OAAO,EAAE,IAAI,CAAC;IACpE;;;;;;;SAOK;IACE,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,EAC1F,GAAG,EAAE,GAAG,EACR,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,uBAAuB,GAAG;QAAE,UAAU,EAAE,IAAI,CAAA;KAAE,GACpD,UAAU,CACX,IAAI,EACJ,UAAU,GAAG;SACV,CAAC,IAAI,GAAG,GAAG,kBAAkB,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,GAAG;YAAE,UAAU,EAAE,IAAI,CAAA;SAAE;KACrF,EACD,OAAO,EACP,IAAI,CACL;IACD;;;;;;;SAOK;IACE,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,EAC1F,GAAG,EAAE,GAAG,EACR,EAAE,EAAE,EAAE,EACN,KAAK,CAAC,EAAE,uBAAuB,GAC9B,UAAU,CACX,IAAI,EACJ,UAAU,GAAG;SAAG,CAAC,IAAI,GAAG,GAAG,kBAAkB,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;KAAE,EAC9E,OAAO,EACP,IAAI,CACL;IA+BD,mEAAmE;IAC5D,eAAe,CACpB,KAAK,CAAC,GAAG,SAAS,MAAM,EACxB,KAAK,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,EACpD,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,oCAtCA,CAAC;IA0CnB,oEAAoE;IAC7D,gBAAgB,CACrB,KAAK,CAAC,GAAG,SAAS,MAAM,EACxB,KAAK,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,EACpD,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,oCAjEb,CAAC;oBAA4E,IAAI;;IAqEtF,mFAAmF;IAC5E,yBAAyB,CAC9B,KAAK,CAAC,GAAG,SAAS,MAAM,EACxB,KAAK,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,EACpD,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,oCAzEb,CAAC;oBAA4E,IAAI;;IA6EtF;0CACsC;IAC/B,SAAS,CAAC,GAAG,SAAS,WAAW,EACtC,GAAG,EAAE,GAAG,GAAG,qBAAqB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,GACnD,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAC9C,2FAA2F;IACpF,SAAS,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EACtE,EAAE,EAAE,EAAE,GACL,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAqB9C;0CACsC;IAC/B,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,oBAAoB,EAClD,EAAE,EAAE,CAAC,GACJ,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACvD,oFAAoF;IAC7E,QAAQ,CACb,KAAK,CAAC,GAAG,SAAS,oBAAoB,EACtC,KAAK,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EACzD,EAAE,EAAE,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IACrE,QAAQ,CAAC,KAAK,CAAC,GAAG,SAAS,WAAW,EAC3C,GAAG,EAAE,GAAG,GAAG,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,GAChD,UAAU,CACX,IAAI,EACJ,UAAU,EACV,OAAO,EACP,UAAU,CAAC,YAAY,CAAC,GAAG,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAC7D;IAuBD,8GAA8G;IACvG,KAAK,CACV,EAAE,EAAE,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,GAC9C,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAWvC,QAAQ,CACb,EAAE,EAAE,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,GAC9C,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAWvC,IAAI,CACT,EAAE,EAAE,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,GAChD,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAW9C;;;SAGK;IACE,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAI5E,qEAAqE;IAC9D,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAOrF,6DAA6D;IACtD,WAAW,CAAC,OAAO,EACxB,cAAc,EAAE,OAAO,GACtB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAO9C,qDAAqD;IAC9C,gBAAgB,CACrB,KAAK,EAAE,OAAO,CAAC,0BAA0B,CAAC,GACzC,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAU9C;;;OAGG;IACI,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,KAAK,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAWtF,IAAI,CACT,UAAU,CAAC,EAAE,CAAC,GACb,iBAAiB,CAClB,WAAW,CAAC,IAAI,EAAE,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CACrF;IAEM,IAAI,CACT,UAAU,EAAE,CAAC,GACZ,iBAAiB,CAClB,WAAW,CAAC,IAAI,EAAE,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CACrF;CA+EF"}

package/dist/{builder.js → block_model_legacy.js}

@@ -21,7 +21,7 @@ class BlockModel {
             supportsLazyState: true,
             requiresUIAPIVersion: 1,
             requiresModelAPIVersion: 1,
-            requiresCreatePTableV2: true,
+            requiresCreatePTable: 2,
         };
     }
     static create(renderingMode = "Heavy") {
@@ -253,4 +253,4 @@ class BlockModel {
 }
 
 export { BlockModel };
-//# sourceMappingURL=builder.js.map
+//# sourceMappingURL=block_model_legacy.js.map

package/dist/block_model_legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_model_legacy.js","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      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    // normal operation inside the UI\n    else\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        },\n      };\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;AA0CA;;AAE0E;MAC7D,UAAU,CAAA;AAOX,IAAA,MAAA;AADV,IAAA,WAAA,CACU,MAYP,EAAA;QAZO,IAAA,CAAA,MAAM,GAAN,MAAM;IAab;AAEI,IAAA,WAAW,2BAA2B,GAAA;QAC3C,OAAO;AACL,YAAA,iBAAiB,EAAE,IAAI;AACvB,YAAA,oBAAoB,EAAE,CAAC;AACvB,YAAA,uBAAuB,EAAE,CAAC;AAC1B,YAAA,oBAAoB,EAAE,CAAC;SACxB;IACH;AAgBO,IAAA,OAAO,MAAM,CAAC,aAAA,GAAoC,OAAO,EAAA;QAC9D,OAAO,IAAI,UAAU,CAAiB;YACpC,aAAa;AACb,YAAA,cAAc,EAAE,EAAE;AAClB,YAAA,OAAO,EAAE,EAAE;AACX,YAAA,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC;AAC/B,YAAA,QAAQ,EAAE,YAAY,CAAC,EAAE,CAAC;YAC1B,YAAY,EAAE,UAAU,CAAC,2BAA2B;AACrD,SAAA,CAAC;IACJ;AAoDO,IAAA,MAAM,CACX,GAAW,EACX,OAAkC,EAClC,QAAiC,EAAE,EAAA;AAEnC,QAAA,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE;AACjC,YAAA,MAAM,MAAM,GAAG,CAAA,OAAA,EAAU,GAAG,EAAE;AAC9B,YAAA,mBAAmB,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;YACjE,OAAO,IAAI,UAAU,CAAC;gBACpB,GAAG,IAAI,CAAC,MAAM;AACd,gBAAA,OAAO,EAAE;AACP,oBAAA,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO;oBACtB,CAAC,GAAG,GAAG;AACL,wBAAA,cAAc,EAAE,IAAI;wBACpB,MAAM;AACN,wBAAA,GAAG,KAAK;AACT,qBAAA;AACF,iBAAA;AACF,aAAA,CAAC;QACJ;aAAO;YACL,OAAO,IAAI,UAAU,CAAC;gBACpB,GAAG,IAAI,CAAC,MAAM;AACd,gBAAA,OAAO,EAAE;AACP,oBAAA,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO;oBACtB,CAAC,GAAG,GAAG,OAAO;AACf,iBAAA;AACF,aAAA,CAAC;QACJ;IACF;;IAGO,eAAe,CAGpB,GAAQ,EAAE,EAAM,EAAA;AAChB,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAClD;;IAGO,gBAAgB,CAGrB,GAAQ,EAAE,EAAM,EAAA;AAChB,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IACnD;;IAGO,yBAAyB,CAG9B,GAAQ,EAAE,EAAM,EAAA;AAChB,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IACpE;AAWO,IAAA,SAAS,CACd,OAAkC,EAAA;AAElC,QAAA,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE;AACjC,YAAA,mBAAmB,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;YACxE,OAAO,IAAI,UAAU,CAA4B;gBAC/C,GAAG,IAAI,CAAC,MAAM;AACd,gBAAA,WAAW,EAAE;AACX,oBAAA,cAAc,EAAE,IAAI;AACpB,oBAAA,MAAM,EAAE,aAAa;AACtB,iBAAA;AACF,aAAA,CAAC;QACJ;aAAO;YACL,OAAO,IAAI,UAAU,CAA4B;gBAC/C,GAAG,IAAI,CAAC,MAAM;AACd,gBAAA,WAAW,EAAE,OAAO;AACrB,aAAA,CAAC;QACJ;IACF;AAoBO,IAAA,QAAQ,CACb,YAA8D,EAAA;AAE9D,QAAA,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE;YAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QAClD;AAAO,aAAA,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE;AAC7C,YAAA,mBAAmB,CAAC,UAAU,EAAE,MAAM,YAAY,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;YAC1E,OAAO,IAAI,UAAU,CAA4B;gBAC/C,GAAG,IAAI,CAAC,MAAM;AACd,gBAAA,QAAQ,EAAE;AACR,oBAAA,cAAc,EAAE,IAAI;AACpB,oBAAA,MAAM,EAAE,UAAU;AACnB,iBAAA;AACF,aAAA,CAAC;QACJ;aAAO;YACL,OAAO,IAAI,UAAU,CAA4B;gBAC/C,GAAG,IAAI,CAAC,MAAM;AACd,gBAAA,QAAQ,EAAE,YAA2B;AACtC,aAAA,CAAC;QACJ;IACF;;AAGO,IAAA,KAAK,CACV,EAA+C,EAAA;AAE/C,QAAA,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;QAC7D,OAAO,IAAI,UAAU,CAAkC;YACrD,GAAG,IAAI,CAAC,MAAM;AACd,YAAA,KAAK,EAAE;AACL,gBAAA,cAAc,EAAE,IAAI;AACpB,gBAAA,MAAM,EAAE,OAAO;AAChB,aAAA;AACF,SAAA,CAAC;IACJ;AAEO,IAAA,QAAQ,CACb,EAA+C,EAAA;AAE/C,QAAA,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;QAChE,OAAO,IAAI,UAAU,CAAkC;YACrD,GAAG,IAAI,CAAC,MAAM;AACd,YAAA,QAAQ,EAAE;AACR,gBAAA,cAAc,EAAE,IAAI;AACpB,gBAAA,MAAM,EAAE,UAAU;AACnB,aAAA;AACF,SAAA,CAAC;IACJ;AAEO,IAAA,IAAI,CACT,EAAiD,EAAA;AAEjD,QAAA,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;QAC5D,OAAO,IAAI,UAAU,CAAkC;YACrD,GAAG,IAAI,CAAC,MAAM;AACd,YAAA,IAAI,EAAE;AACJ,gBAAA,cAAc,EAAE,IAAI;AACpB,gBAAA,MAAM,EAAE,MAAM;AACf,aAAA;AACF,SAAA,CAAC;IACJ;AAEA;;;AAGK;AACE,IAAA,WAAW,CAAC,KAAW,EAAA;AAC5B,QAAA,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC7B;;AAGO,IAAA,QAAQ,CAAO,WAAiB,EAAA;QACrC,OAAO,IAAI,UAAU,CAAkC;YACrD,GAAG,IAAI,CAAC,MAAM;YACd,WAAW;AACZ,SAAA,CAAC;IACJ;;AAGO,IAAA,WAAW,CAChB,cAAuB,EAAA;QAEvB,OAAO,IAAI,UAAU,CAAkC;YACrD,GAAG,IAAI,CAAC,MAAM;YACd,cAAc;AACf,SAAA,CAAC;IACJ;;AAGO,IAAA,gBAAgB,CACrB,KAA0C,EAAA;QAE1C,OAAO,IAAI,UAAU,CAAkC;YACrD,GAAG,IAAI,CAAC,MAAM;AACd,YAAA,YAAY,EAAE;AACZ,gBAAA,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY;AAC3B,gBAAA,GAAG,KAAK;AACT,aAAA;AACF,SAAA,CAAC;IACJ;AAEA;;;AAGG;AACI,IAAA,QAAQ,CAAC,MAA+B,EAAA;AAC7C,QAAA,mBAAmB,CAAC,mBAAmB,EAAE,MAAM,CAAC;QAChD,OAAO,IAAI,UAAU,CAAkC;YACrD,GAAG,IAAI,CAAC,MAAM;AACd,YAAA,iBAAiB,EAAE;AACjB,gBAAA,cAAc,EAAE,IAAI;AACpB,gBAAA,MAAM,EAAE,mBAAmB;AAC5B,aAAA;AACF,SAAA,CAAC;IACJ;AAcA;;AAE4D;IACrD,IAAI,CACT,aAAkC,CAAC,EAAA;QAInC,OAAO,IAAI,CAAC,gBAAgB,CAAC;AAC3B,YAAA,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY;AAC3B,YAAA,oBAAoB,EAAE,UAAU;SACjC,CAAC,CAAC,KAAK,EAAE;IACZ;IAEA,KAAK,GAAA;AAGH,QAAA,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS;AAAE,YAAA,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC;AAExF,QAAA,MAAM,MAAM,GAAyB;AACnC,YAAA,EAAE,EAAE,SAAS;AACb,YAAA,EAAE,EAAE;AACF,gBAAA,aAAa,EAAE,CAAC;AAChB,gBAAA,eAAe,EAAE,CAAC;AAClB,gBAAA,UAAU,EAAE,mBAAmB;AAC/B,gBAAA,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;AACxC,gBAAA,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;AACpC,gBAAA,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;AAC1C,gBAAA,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;AACpC,gBAAA,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;AAC9B,gBAAA,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;AACxB,gBAAA,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;AAC9B,gBAAA,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;AACtB,gBAAA,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;AAC5B,gBAAA,iBAAiB,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB;AAChD,gBAAA,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;AACvC,aAAA;;AAGD,YAAA,UAAU,EAAE,mBAAmB;AAC/B,YAAA,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;AACxC,YAAA,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;YACpC,WAAW,EAAE,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;YAC1D,QAAQ,EAAE,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YACpD,OAAO,EAAE,MAAM,CAAC,WAAW,CACzB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK;gBACxD,GAAG;gBACH,oBAAoB,CAAC,KAAK,CAAC;AAC5B,aAAA,CAAC,CACH;SACF;AAED,QAAA,UAAU,CAAC,mBAAmB,GAAG,IAAI,CAAC,MAAM,CAAC;AAC1C,aAAA,oBAA2C;QAE9C,IAAI,CAAC,MAAM,EAAE;;YAEX,OAAO,EAAE,MAAM,EAAS;;;YAGxB,OAAO;AACL,gBAAA,GAAG,oBAAoB,CAAC;AACtB,oBAAA,UAAU,EAAE,mBAAmB;AAC/B,oBAAA,UAAU,EAAE,mBAAmB;iBAChC,CAAC;AACF,gBAAA,cAAc,EAAE;oBACd,OAAO,EAAE,MAAM,CAAC,WAAW,CACzB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK;wBACxD,GAAG;AACH,wBAAA;4BACE,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC;AAC/D,yBAAA;AACF,qBAAA,CAAC,CACH;AACF,iBAAA;aACF;IACL;AACD;;;;"}

package/dist/block_state_patch.d.ts

@@ -1,5 +1,15 @@
-import type { Unionize } from "./unionize";
 import type { BlockOutputsBase, BlockState } from "@milaboratories/pl-model-common";
+/** Patch for the structural object */
+export type Patch<K, V> = {
+    /** Field name to patch */
+    readonly key: K;
+    /** New value for the field */
+    readonly value: V;
+};
+/** Creates union type of all possible shallow patches for the given structure */
+export type Unionize<T extends Record<string, unknown>> = {
+    [K in keyof T]: Patch<K, T[K]>;
+}[keyof T];
 /** Patch for the BlockState, pushed by onStateUpdates method in SDK. */
 export type BlockStatePatch<Args = unknown, Outputs extends BlockOutputsBase = BlockOutputsBase, UiState = unknown, Href extends `/${string}` = `/${string}`> = Unionize<BlockState<Args, Outputs, UiState, Href>>;
 //# sourceMappingURL=block_state_patch.d.ts.map

package/dist/block_state_patch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block_state_patch.d.ts","sourceRoot":"","sources":["../src/block_state_patch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAEpF,wEAAwE;AACxE,MAAM,MAAM,eAAe,CACzB,IAAI,GAAG,OAAO,EACd,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,OAAO,GAAG,OAAO,EACjB,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,IACtC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC"}
+{"version":3,"file":"block_state_patch.d.ts","sourceRoot":"","sources":["../src/block_state_patch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAEpF,sCAAsC;AACtC,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI;IACxB,0BAA0B;IAC1B,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;IAChB,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CACnB,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;KACvD,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/B,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,wEAAwE;AACxE,MAAM,MAAM,eAAe,CACzB,IAAI,GAAG,OAAO,EACd,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,OAAO,GAAG,OAAO,EACjB,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,IACtC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC"}

package/dist/block_storage.cjs

@@ -55,11 +55,13 @@ function createBlockStorage(initialData = {}, version = DATA_MODEL_DEFAULT_VERSI
         [BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,
         __dataVersion: version,
         __data: initialData,
+        __pluginRegistry: {},
+        __plugins: {},
     };
 }
 /**
  * Normalizes raw storage data to BlockStorage format.
- * If the input is already a BlockStorage, returns it as-is.
+ * If the input is already a BlockStorage, returns it as-is (with defaults for missing fields).
  * If the input is legacy format (raw state), wraps it in BlockStorage structure.
  *
  * @param raw - Raw storage data (may be legacy format or BlockStorage)
@@ -74,6 +76,9 @@ function normalizeBlockStorage(raw) {
             __dataVersion: typeof storage.__dataVersion === "number"
                 ? DATA_MODEL_DEFAULT_VERSION
                 : storage.__dataVersion,
+            // Ensure plugin fields have defaults
+            __pluginRegistry: storage.__pluginRegistry ?? {},
+            __plugins: storage.__plugins ?? {},
         };
     }
     // Legacy format: raw is the state directly
@@ -116,142 +121,154 @@ function deriveDataFromStorage(rawStorage) {
  */
 function updateStorageData(storage, payload) {
     switch (payload.operation) {
-        case "update-data":
+        case "update-block-data":
             return { ...storage, __data: payload.value };
+        case "update-plugin-data": {
+            const { pluginId, value } = payload;
+            const currentPlugins = storage.__plugins ?? {};
+            const existingEntry = currentPlugins[pluginId];
+            const version = existingEntry?.__dataVersion ?? DATA_MODEL_DEFAULT_VERSION;
+            return {
+                ...storage,
+                __plugins: {
+                    ...currentPlugins,
+                    [pluginId]: {
+                        __dataVersion: version,
+                        __data: value,
+                    },
+                },
+            };
+        }
         default:
             throw new Error(`Unknown storage operation: ${payload.operation}`);
     }
 }
 /**
- * Gets the data version from BlockStorage
+ * Performs atomic migration of block storage including block data and all plugins.
  *
- * @param storage - The BlockStorage instance
- * @returns The data version key
- */
-function getStorageDataVersion(storage) {
-    return storage.__dataVersion;
-}
-/**
- * Updates the data version in BlockStorage (immutable)
+ * Migration is atomic: either everything succeeds and a new storage is returned,
+ * or an error is returned and the original storage is completely untouched.
  *
- * @param storage - The current BlockStorage
- * @param version - The new version key
- * @returns A new BlockStorage with updated version
- */
-function updateStorageDataVersion(storage, version) {
-    return { ...storage, __dataVersion: version };
-}
-// =============================================================================
-// Plugin Data Functions
-// =============================================================================
-/**
- * Gets plugin-specific data from BlockStorage
+ * Migration steps:
+ * 1. Migrate block data
+ * 2. For each plugin in newPluginRegistry:
+ *    - If plugin exists with same name: migrate its data
+ *    - Otherwise (new or type changed): create with initial data
+ *    Plugins not in newPluginRegistry are dropped.
  *
- * @param storage - The BlockStorage instance
- * @param pluginName - The plugin name (without `@plugin/` prefix)
- * @returns The plugin data or undefined if not set
- */
-function getPluginData(storage, pluginName) {
-    const key = `@plugin/${pluginName}`;
-    return storage[key];
-}
-/**
- * Sets plugin-specific data in BlockStorage (immutable)
+ * If any step throws, migration fails and original storage is preserved.
+ * User can then choose to:
+ * - Abort: keep original storage, don't update block
+ * - Reset: call createBlockStorage() to start fresh
  *
- * @param storage - The current BlockStorage
- * @param pluginName - The plugin name (without `@plugin/` prefix)
- * @param data - The plugin data to store
- * @returns A new BlockStorage with updated plugin data
- */
-function setPluginData(storage, pluginName, data) {
-    const key = `@plugin/${pluginName}`;
-    return { ...storage, [key]: data };
-}
-/**
- * Removes plugin-specific data from BlockStorage (immutable)
+ * @param storage - The original storage (will not be modified)
+ * @param config - Migration configuration
+ * @returns Migration result - either success with new storage, or failure with error info
  *
- * @param storage - The current BlockStorage
- * @param pluginName - The plugin name (without `@plugin/` prefix)
- * @returns A new BlockStorage with the plugin data removed
- */
-function removePluginData(storage, pluginName) {
-    const key = `@plugin/${pluginName}`;
-    const { [key]: _, ...rest } = storage;
-    return rest;
-}
-/**
- * Gets all plugin names that have data stored
+ * @example
+ * const result = migrateBlockStorage(storage, {
+ *   migrateBlockData: (versioned) => blockDataModel.migrate(versioned),
+ *   migratePluginData: (pluginId, versioned) => getPluginModel(pluginId).migrate(versioned),
+ *   newPluginRegistry: { table1: 'dataTable' as PluginName },
+ *   createPluginData: (pluginId) => getPluginModel(pluginId).getDefaultData(),
+ * });
  *
- * @param storage - The BlockStorage instance
- * @returns Array of plugin names (without `@plugin/` prefix)
+ * if (result.success) {
+ *   commitStorage(result.storage);
+ * } else {
+ *   const userChoice = await askUser(`Migration failed: ${result.error}. Reset data?`);
+ *   if (userChoice === 'reset') {
+ *     commitStorage(createBlockStorage(initialData, currentVersion));
+ *   }
+ *   // else: abort, keep original
+ * }
  */
-function getPluginNames(storage) {
-    return Object.keys(storage)
-        .filter((key) => key.startsWith("@plugin/"))
-        .map((key) => key.slice("@plugin/".length));
+function migrateBlockStorage(storage, config) {
+    const { migrateBlockData, migratePluginData, newPluginRegistry, createPluginData } = config;
+    // Step 1: Migrate block data
+    let migratedData;
+    let newVersion;
+    try {
+        const result = migrateBlockData({ version: storage.__dataVersion, data: storage.__data });
+        migratedData = result.data;
+        newVersion = result.version;
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+            failedAt: "block",
+        };
+    }
+    // Step 2: Migrate plugins
+    const oldPlugins = storage.__plugins ?? {};
+    const oldRegistry = storage.__pluginRegistry ?? {};
+    const newPlugins = {};
+    for (const [pluginId, pluginName] of Object.entries(newPluginRegistry)) {
+        const existingEntry = oldPlugins[pluginId];
+        const existingName = oldRegistry[pluginId];
+        try {
+            if (existingEntry && existingName === pluginName) {
+                // Plugin exists with same type - migrate its data
+                const migrated = migratePluginData(pluginId, {
+                    version: existingEntry.__dataVersion,
+                    data: existingEntry.__data,
+                });
+                if (migrated) {
+                    newPlugins[pluginId] = { __dataVersion: migrated.version, __data: migrated.data };
+                }
+                // If undefined returned, plugin is intentionally removed
+            }
+            else {
+                // New plugin or type changed - create with initial data
+                const initial = createPluginData(pluginId);
+                newPlugins[pluginId] = { __dataVersion: initial.version, __data: initial.data };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                failedAt: pluginId,
+            };
+        }
+    }
+    // Step 3: Build final storage atomically
+    const migratedStorage = {
+        [BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,
+        __dataVersion: newVersion,
+        __data: migratedData,
+        __pluginRegistry: newPluginRegistry,
+        __plugins: newPlugins,
+    };
+    return {
+        success: true,
+        storage: migratedStorage,
+    };
 }
-// =============================================================================
-// Generic Storage Access
-// =============================================================================
 /**
- * Gets a value from BlockStorage by key
+ * Gets plugin-specific data from BlockStorage (for UI)
  *
  * @param storage - The BlockStorage instance
- * @param key - The key to retrieve
- * @returns The value at the given key
- */
-function getFromStorage(storage, key) {
-    return storage[key];
-}
-/**
- * Updates a value in BlockStorage by key (immutable)
- *
- * @param storage - The current BlockStorage
- * @param key - The key to update
- * @param value - The new value
- * @returns A new BlockStorage with the updated value
- */
-function updateStorage(storage, key, value) {
-    return { ...storage, [key]: value };
-}
-/**
- * Default implementations of storage handlers
- */
-const defaultBlockStorageHandlers = {
-    transformStateForStorage: (storage, newState) => updateStorageData(storage, { operation: "update-data", value: newState }),
-    deriveStateForArgs: (storage) => getStorageData(storage),
-    migrateStorage: (storage, _fromVersion, toVersion) => updateStorageDataVersion(storage, toVersion),
-};
-/**
- * Merges custom handlers with defaults
- *
- * @param customHandlers - Custom handlers to merge
- * @returns Complete handlers with defaults for missing functions
+ * @param pluginId - The plugin instance id
+ * @returns The plugin data or undefined if not set
  */
-function mergeBlockStorageHandlers(customHandlers) {
-    return {
-        ...defaultBlockStorageHandlers,
-        ...customHandlers,
-    };
+function getPluginData(storage, pluginId) {
+    const pluginEntry = storage.__plugins?.[pluginId];
+    if (!pluginEntry)
+        return undefined;
+    return pluginEntry.__data;
 }
 
 exports.BLOCK_STORAGE_KEY = BLOCK_STORAGE_KEY;
 exports.BLOCK_STORAGE_SCHEMA_VERSION = BLOCK_STORAGE_SCHEMA_VERSION;
 exports.DATA_MODEL_DEFAULT_VERSION = DATA_MODEL_DEFAULT_VERSION;
 exports.createBlockStorage = createBlockStorage;
-exports.defaultBlockStorageHandlers = defaultBlockStorageHandlers;
 exports.deriveDataFromStorage = deriveDataFromStorage;
-exports.getFromStorage = getFromStorage;
 exports.getPluginData = getPluginData;
-exports.getPluginNames = getPluginNames;
 exports.getStorageData = getStorageData;
-exports.getStorageDataVersion = getStorageDataVersion;
 exports.isBlockStorage = isBlockStorage;
-exports.mergeBlockStorageHandlers = mergeBlockStorageHandlers;
+exports.migrateBlockStorage = migrateBlockStorage;
 exports.normalizeBlockStorage = normalizeBlockStorage;
-exports.removePluginData = removePluginData;
-exports.setPluginData = setPluginData;
-exports.updateStorage = updateStorage;
 exports.updateStorageData = updateStorageData;
-exports.updateStorageDataVersion = updateStorageDataVersion;
 //# sourceMappingURL=block_storage.cjs.map

package/dist/block_storage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"block_storage.cjs","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\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_DEFAULT_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 * Plugin key type - keys starting with `@plugin/` are reserved for plugin data\n */\nexport type PluginKey = `@plugin/${string}`;\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 * - @plugin/*: Optional plugin-specific data\n */\nexport type BlockStorage<TState = unknown> = {\n  /** Schema version - the key itself is the discriminator */\n  readonly [BLOCK_STORAGE_KEY]: BlockStorageSchemaVersion;\n  /** Version of the block data, used for migrations */\n  __dataVersion: string;\n  /** The block's user-facing data (state) */\n  __data: TState;\n} & {\n  /** Plugin-specific data, keyed by `@plugin/<pluginName>` */\n  [K in PluginKey]?: unknown;\n};\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_DEFAULT_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_DEFAULT_VERSION,\n): BlockStorage<TState> {\n  return {\n    [BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,\n    __dataVersion: version,\n    __data: initialData,\n  };\n}\n\n/**\n * Normalizes raw storage data to BlockStorage format.\n * If the input is already a BlockStorage, returns it as-is.\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_DEFAULT_VERSION\n          : storage.__dataVersion,\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> = { operation: \"update-data\"; value: T };\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-data\":\n      return { ...storage, __data: payload.value };\n    default:\n      throw new Error(`Unknown storage operation: ${(payload as { operation: string }).operation}`);\n  }\n}\n\n/**\n * Gets the data version from BlockStorage\n *\n * @param storage - The BlockStorage instance\n * @returns The data version key\n */\nexport function getStorageDataVersion(storage: BlockStorage): string {\n  return storage.__dataVersion;\n}\n\n/**\n * Updates the data version in BlockStorage (immutable)\n *\n * @param storage - The current BlockStorage\n * @param version - The new version key\n * @returns A new BlockStorage with updated version\n */\nexport function updateStorageDataVersion<TState>(\n  storage: BlockStorage<TState>,\n  version: string,\n): BlockStorage<TState> {\n  return { ...storage, __dataVersion: version };\n}\n\n/**\n * Storage debug view returned by __pl_storage_debugView callback.\n * Used by developer tools to display block storage info.\n */\nexport interface StorageDebugView {\n  /** Current data version key */\n  dataVersion: string;\n  /** Raw data payload stored in BlockStorage */\n  data: unknown;\n}\n\n// =============================================================================\n// Plugin Data Functions\n// =============================================================================\n\n/**\n * Gets plugin-specific data from BlockStorage\n *\n * @param storage - The BlockStorage instance\n * @param pluginName - The plugin name (without `@plugin/` prefix)\n * @returns The plugin data or undefined if not set\n */\nexport function getPluginData<TData = unknown>(\n  storage: BlockStorage,\n  pluginName: string,\n): TData | undefined {\n  const key: PluginKey = `@plugin/${pluginName}`;\n  return storage[key] as TData | undefined;\n}\n\n/**\n * Sets plugin-specific data in BlockStorage (immutable)\n *\n * @param storage - The current BlockStorage\n * @param pluginName - The plugin name (without `@plugin/` prefix)\n * @param data - The plugin data to store\n * @returns A new BlockStorage with updated plugin data\n */\nexport function setPluginData<TState>(\n  storage: BlockStorage<TState>,\n  pluginName: string,\n  data: unknown,\n): BlockStorage<TState> {\n  const key: PluginKey = `@plugin/${pluginName}`;\n  return { ...storage, [key]: data };\n}\n\n/**\n * Removes plugin-specific data from BlockStorage (immutable)\n *\n * @param storage - The current BlockStorage\n * @param pluginName - The plugin name (without `@plugin/` prefix)\n * @returns A new BlockStorage with the plugin data removed\n */\nexport function removePluginData<TState>(\n  storage: BlockStorage<TState>,\n  pluginName: string,\n): BlockStorage<TState> {\n  const key: PluginKey = `@plugin/${pluginName}`;\n  const { [key]: _, ...rest } = storage;\n  return rest as BlockStorage<TState>;\n}\n\n/**\n * Gets all plugin names that have data stored\n *\n * @param storage - The BlockStorage instance\n * @returns Array of plugin names (without `@plugin/` prefix)\n */\nexport function getPluginNames(storage: BlockStorage): string[] {\n  return Object.keys(storage)\n    .filter((key): key is PluginKey => key.startsWith(\"@plugin/\"))\n    .map((key) => key.slice(\"@plugin/\".length));\n}\n\n// =============================================================================\n// Generic Storage Access\n// =============================================================================\n\n/**\n * Gets a value from BlockStorage by key\n *\n * @param storage - The BlockStorage instance\n * @param key - The key to retrieve\n * @returns The value at the given key\n */\nexport function getFromStorage<TState, K extends keyof BlockStorage<TState>>(\n  storage: BlockStorage<TState>,\n  key: K,\n): BlockStorage<TState>[K] {\n  return storage[key];\n}\n\n/**\n * Updates a value in BlockStorage by key (immutable)\n *\n * @param storage - The current BlockStorage\n * @param key - The key to update\n * @param value - The new value\n * @returns A new BlockStorage with the updated value\n */\nexport function updateStorage<TState, K extends keyof BlockStorage<TState>>(\n  storage: BlockStorage<TState>,\n  key: K,\n  value: BlockStorage<TState>[K],\n): BlockStorage<TState> {\n  return { ...storage, [key]: value };\n}\n\n// =============================================================================\n// Storage Handlers (for Phase 2 - Model-Level Customization)\n// =============================================================================\n\n/**\n * Interface for model-configurable storage operations.\n * These handlers allow block models to customize how storage is managed.\n */\nexport interface BlockStorageHandlers<TState = unknown> {\n  /**\n   * Called when setState is invoked - transforms the new state before storing.\n   * Default behavior: replaces the state directly.\n   *\n   * @param currentStorage - The current BlockStorage\n   * @param newState - The new state being set\n   * @returns The updated BlockStorage\n   */\n  transformStateForStorage?: (\n    currentStorage: BlockStorage<TState>,\n    newState: TState,\n  ) => BlockStorage<TState>;\n\n  /**\n   * Called when reading state for args derivation.\n   * Default behavior: returns the state directly.\n   *\n   * @param storage - The current BlockStorage\n   * @returns The state to use for args derivation\n   */\n  deriveStateForArgs?: (storage: BlockStorage<TState>) => TState;\n\n  /**\n   * Called during storage schema migration.\n   * Default behavior: updates stateVersion only.\n   *\n   * @param oldStorage - The storage before migration\n   * @param fromVersion - The version migrating from\n   * @param toVersion - The version migrating to\n   * @returns The migrated BlockStorage\n   */\n  migrateStorage?: (\n    oldStorage: BlockStorage<TState>,\n    fromVersion: string,\n    toVersion: string,\n  ) => BlockStorage<TState>;\n}\n\n/**\n * Default implementations of storage handlers\n */\nexport const defaultBlockStorageHandlers: Required<BlockStorageHandlers<unknown>> = {\n  transformStateForStorage: <TState>(\n    storage: BlockStorage<TState>,\n    newState: TState,\n  ): BlockStorage<TState> =>\n    updateStorageData(storage, { operation: \"update-data\", value: newState }),\n\n  deriveStateForArgs: <TState>(storage: BlockStorage<TState>): TState => getStorageData(storage),\n\n  migrateStorage: <TState>(\n    storage: BlockStorage<TState>,\n    _fromVersion: string,\n    toVersion: string,\n  ): BlockStorage<TState> => updateStorageDataVersion(storage, toVersion),\n};\n\n/**\n * Merges custom handlers with defaults\n *\n * @param customHandlers - Custom handlers to merge\n * @returns Complete handlers with defaults for missing functions\n */\nexport function mergeBlockStorageHandlers<TState>(\n  customHandlers?: BlockStorageHandlers<TState>,\n): Required<BlockStorageHandlers<TState>> {\n  return {\n    ...defaultBlockStorageHandlers,\n    ...customHandlers,\n  } as Required<BlockStorageHandlers<TState>>;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"block_storage.cjs","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 type { DataMigrationResult, DataVersioned } from \"./block_migrations\";\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_DEFAULT_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<string, 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 pluginId */\n  __plugins?: Record<string, 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_DEFAULT_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_DEFAULT_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_DEFAULT_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: string; 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_DEFAULT_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 * Storage debug view returned by __pl_storage_debugView callback.\n * Used by developer tools to display block storage info.\n */\nexport interface StorageDebugView {\n  /** Current data version key */\n  dataVersion: string;\n  /** Raw data payload stored in BlockStorage */\n  data: unknown;\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 */\n  migrateBlockData: (versioned: DataVersioned<unknown>) => DataMigrationResult<unknown>;\n  /** Migrate each plugin's data. Return undefined to remove the plugin. */\n  migratePluginData: (\n    pluginId: string,\n    versioned: DataVersioned<unknown>,\n  ) => DataMigrationResult<unknown> | undefined;\n  /** The new plugin registry after migration (pluginId -> pluginName) */\n  newPluginRegistry: PluginRegistry;\n  /** Factory to create initial data for new plugins */\n  createPluginData: (pluginId: string) => 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\n  let migratedData: unknown;\n  let newVersion: string;\n  try {\n    const result = migrateBlockData({ version: storage.__dataVersion, data: storage.__data });\n    migratedData = result.data;\n    newVersion = result.version;\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<string, VersionedData<unknown>> = {};\n\n  for (const [pluginId, pluginName] of Object.entries(newPluginRegistry)) {\n    const existingEntry = oldPlugins[pluginId];\n    const existingName = oldRegistry[pluginId];\n\n    try {\n      if (existingEntry && existingName === pluginName) {\n        // Plugin exists with same type - migrate its data\n        const migrated = migratePluginData(pluginId, {\n          version: existingEntry.__dataVersion,\n          data: existingEntry.__data,\n        });\n        if (migrated) {\n          newPlugins[pluginId] = { __dataVersion: migrated.version, __data: migrated.data };\n        }\n        // If undefined returned, plugin is intentionally removed\n      } else {\n        // New plugin or type changed - create with initial data\n        const initial = createPluginData(pluginId);\n        newPlugins[pluginId] = { __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: pluginId,\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 BlockStorage (for UI)\n *\n * @param storage - The BlockStorage instance\n * @param pluginId - The plugin instance id\n * @returns The plugin data or undefined if not set\n */\nexport function getPluginData<TData = unknown>(\n  storage: BlockStorage,\n  pluginId: string,\n): TData | undefined {\n  const pluginEntry = storage.__plugins?.[pluginId];\n  if (!pluginEntry) return undefined;\n  return pluginEntry.__data as TData;\n}\n"],"names":[],"mappings":"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"}