@milaboratories/pl-model-common 1.22.0 → 1.24.0

package/dist/block_state.d.ts

@@ -21,4 +21,13 @@ export type BlockState<Args = unknown, Outputs extends BlockOutputsBase = BlockO
     navigationState: NavigationState<Href>;
     readonly author: AuthorMarker | undefined;
 };
+export type BlockStateV3<Outputs extends BlockOutputsBase = BlockOutputsBase, _Data = unknown, Href extends `/${string}` = `/${string}`> = {
+    /** Block storage persisted in the block state */
+    blockStorage: unknown;
+    /** Outputs rendered with block config */
+    outputs: Outputs;
+    /** Current navigation state */
+    navigationState: NavigationState<Href>;
+    readonly author: AuthorMarker | undefined;
+};
 //# sourceMappingURL=block_state.d.ts.map

package/dist/block_state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block_state.d.ts","sourceRoot":"","sources":["../src/block_state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,CACpB,IAAI,GAAG,OAAO,EACd,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,OAAO,GAAG,OAAO,EACjB,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,IACtC;IACF,6CAA6C;IAC7C,IAAI,EAAE,IAAI,CAAC;IAEX;kBACc;IACd,EAAE,EAAE,OAAO,CAAC;IAEZ,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,eAAe,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IAEvC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;CAC3C,CAAC"}
+{"version":3,"file":"block_state.d.ts","sourceRoot":"","sources":["../src/block_state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,CACpB,IAAI,GAAG,OAAO,EACd,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,OAAO,GAAG,OAAO,EACjB,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,IACtC;IACF,6CAA6C;IAC7C,IAAI,EAAE,IAAI,CAAC;IAEX;kBACc;IACd,EAAE,EAAE,OAAO,CAAC;IAEZ,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,eAAe,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IAEvC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,YAAY,CACtB,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,KAAK,GAAG,OAAO,EACf,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,IACtC;IACF,iDAAiD;IACjD,YAAY,EAAE,OAAO,CAAC;IAEtB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,eAAe,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IAEvC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;CAC3C,CAAC"}

package/dist/bmodel/block_config.cjs

@@ -3,7 +3,7 @@
 // TODO BroadActiveHandleDescriptor must be removed
 function extractCodeWithInfo(cfg) {
     if (cfg.code === undefined)
-        throw new Error('No code bundle');
+        throw new Error('extractCodeWithInfo: No code bundle');
     return {
         code: cfg.code,
         sdkVersion: cfg.sdkVersion,

package/dist/bmodel/block_config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"block_config.cjs","sources":["../../src/bmodel/block_config.ts"],"sourcesContent":["// TODO BroadActiveHandleDescriptor must be removed\n\nimport type { BlockCodeFeatureFlags } from '../flags';\nimport type { BlockCodeWithInfo, Code } from './code';\nimport type { BlockRenderingMode } from './types';\n\n/**\n * BroadActiveHandleDescriptor = TypedConfigOrConfigLambda,\n * NarrowActiveHandleDescriptor = ConfigRenderLambda\n */\nexport type BlockConfigV3Generic<\n  Args = unknown,\n  UiState = unknown,\n  BroadActiveHandleDescriptor = unknown,\n  NarrowActiveHandleDescriptor extends BroadActiveHandleDescriptor = BroadActiveHandleDescriptor,\n  Outputs extends Record<string, BroadActiveHandleDescriptor> = Record<string, BroadActiveHandleDescriptor>,\n> = {\n  /** SDK version used by the block */\n  readonly sdkVersion: string;\n\n  /** Main rendering mode for the block */\n  readonly renderingMode: BlockRenderingMode;\n\n  /** Initial value for the args when block is added to the project */\n  readonly initialArgs: Args;\n\n  /** Initial value for the args when block is added to the project */\n  readonly initialUiState: UiState;\n\n  /**\n   * Config to determine whether the block can be executed with current\n   * arguments.\n   *\n   * Optional to support earlier SDK version configs.\n   */\n  readonly inputsValid: BroadActiveHandleDescriptor;\n\n  /** Configuration to derive list of section for the left overview panel */\n  readonly sections: BroadActiveHandleDescriptor;\n\n  /** Lambda to derive block title */\n  readonly title?: NarrowActiveHandleDescriptor;\n\n  /** Lambda to derive block subtitle, shown below the title */\n  readonly subtitle?: NarrowActiveHandleDescriptor;\n\n  /** Lambda returning array of tags for search functionality */\n  readonly tags?: BroadActiveHandleDescriptor;\n\n  /**\n   * Lambda returning list of upstream blocks this block enriches with its exports,\n   * influences dependency graph construction\n   */\n  readonly enrichmentTargets?: NarrowActiveHandleDescriptor;\n\n  /** Configuration for the output cells */\n  readonly outputs: Outputs;\n\n  /** Config code bundle */\n  readonly code?: Code;\n\n  /** Feature flags for the block Model and UI code. */\n  readonly featureFlags?: BlockCodeFeatureFlags;\n};\n\nexport type BlockConfigGeneric = BlockConfigV3Generic;\n\nexport function extractCodeWithInfo(cfg: BlockConfigV3Generic): BlockCodeWithInfo {\n  if (cfg.code === undefined) throw new Error('No code bundle');\n  return {\n    code: cfg.code,\n    sdkVersion: cfg.sdkVersion,\n    featureFlags: cfg.featureFlags,\n  };\n}\n"],"names":[],"mappings":";;AAAA;AAmEM,SAAU,mBAAmB,CAAC,GAAyB,EAAA;AAC3D,IAAA,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC;IAC7D,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,YAAY,EAAE,GAAG,CAAC,YAAY;KAC/B;AACH;;;;"}
+{"version":3,"file":"block_config.cjs","sources":["../../src/bmodel/block_config.ts"],"sourcesContent":["// TODO BroadActiveHandleDescriptor must be removed\n\nimport type { BlockCodeFeatureFlags } from '../flags';\nimport type { BlockCodeWithInfo, Code } from './code';\nimport type { BlockRenderingMode } from './types';\n\n/**\n * Descriptor for a state migration function.\n * Unlike ConfigRenderLambda, migrations are not rendered reactively -\n * they are one-time synchronous transformations called during block pack updates.\n */\nexport type MigrationDescriptor = {\n  /** Index of this migration in the migrations callback array */\n  readonly index: number;\n};\n\n/**\n * BroadActiveHandleDescriptor = TypedConfigOrConfigLambda,\n * NarrowActiveHandleDescriptor = ConfigRenderLambda\n */\nexport type BlockConfigV4Generic<\n  _Args = unknown,\n  _Data extends Record<string, unknown> = Record<string, unknown>,\n  BroadActiveHandleDescriptor = unknown,\n  NarrowActiveHandleDescriptor extends BroadActiveHandleDescriptor = BroadActiveHandleDescriptor,\n  Outputs extends Record<string, BroadActiveHandleDescriptor> = Record<string, BroadActiveHandleDescriptor>,\n> = {\n  /** Discriminator to identify config version */\n  readonly configVersion: 4;\n\n  readonly modelAPIVersion: 2;\n\n  /** SDK version used by the block */\n  readonly sdkVersion: string;\n\n  /** Main rendering mode for the block */\n  readonly renderingMode: BlockRenderingMode;\n\n  /** Lambda to derive block args from state */\n  readonly args: NarrowActiveHandleDescriptor;\n\n  /**\n   * Lambda to derive prerun args from state (optional).\n   * If not defined, defaults to using the args() result.\n   * Used for staging/prerun phase.\n   */\n  readonly prerunArgs?: NarrowActiveHandleDescriptor;\n\n  /** Lambda to get initial data when block is added to the project */\n  readonly initialData: NarrowActiveHandleDescriptor;\n\n  /** Lambda to derive list of sections for the left overview panel */\n  readonly sections: NarrowActiveHandleDescriptor;\n\n  /** Lambda to derive block title */\n  readonly title?: NarrowActiveHandleDescriptor;\n\n  /** Lambda to derive block subtitle, shown below the title */\n  readonly subtitle?: NarrowActiveHandleDescriptor;\n\n  /** Lambda returning array of tags for search functionality */\n  readonly tags?: BroadActiveHandleDescriptor;\n\n  /**\n   * Lambda returning list of upstream blocks this block enriches with its exports,\n   * influences dependency graph construction\n   * */\n  readonly enrichmentTargets?: NarrowActiveHandleDescriptor;\n\n  /** Configuration for the output cells */\n  readonly outputs: Outputs;\n\n  /**\n   * Array of migration descriptors for state version upgrades.\n   * Each migration transforms state from version N to N+1.\n   * Migrations are NOT rendered reactively - they run synchronously during block pack updates.\n   */\n  readonly migrations?: MigrationDescriptor[];\n\n  /** Config code bundle */\n  readonly code?: Code;\n\n  /** Feature flags for the block Model and UI code. */\n  readonly featureFlags?: BlockCodeFeatureFlags;\n};\n\n/**\n * BroadActiveHandleDescriptor = TypedConfigOrConfigLambda,\n * NarrowActiveHandleDescriptor = ConfigRenderLambda\n */\nexport type BlockConfigV3Generic<\n  Args = unknown,\n  UiState = unknown,\n  BroadActiveHandleDescriptor = unknown,\n  NarrowActiveHandleDescriptor extends BroadActiveHandleDescriptor = BroadActiveHandleDescriptor,\n  Outputs extends Record<string, BroadActiveHandleDescriptor> = Record<string, BroadActiveHandleDescriptor>,\n> = {\n  /** Discriminator to identify config version */\n  readonly configVersion: 3;\n\n  readonly modelAPIVersion: 1;\n\n  /** SDK version used by the block */\n  readonly sdkVersion: string;\n\n  /** Main rendering mode for the block */\n  readonly renderingMode: BlockRenderingMode;\n\n  /** Initial value for the args when block is added to the project */\n  readonly initialArgs: Args;\n\n  /** Initial value for the args when block is added to the project */\n  readonly initialUiState: UiState;\n\n  /**\n   * Config to determine whether the block can be executed with current\n   * arguments.\n   *\n   * Optional to support earlier SDK version configs.\n   */\n  readonly inputsValid: BroadActiveHandleDescriptor;\n\n  /** Configuration to derive list of section for the left overview panel */\n  readonly sections: BroadActiveHandleDescriptor;\n\n  /** Lambda to derive block title */\n  readonly title?: NarrowActiveHandleDescriptor;\n\n  /** Lambda to derive block subtitle, shown below the title */\n  readonly subtitle?: NarrowActiveHandleDescriptor;\n\n  /** Lambda returning array of tags for search functionality */\n  readonly tags?: BroadActiveHandleDescriptor;\n\n  /**\n   * Lambda returning list of upstream blocks this block enriches with its exports,\n   * influences dependency graph construction\n   */\n  readonly enrichmentTargets?: NarrowActiveHandleDescriptor;\n\n  /** Configuration for the output cells */\n  readonly outputs: Outputs;\n\n  /** Config code bundle */\n  readonly code?: Code;\n\n  /** Feature flags for the block Model and UI code. */\n  readonly featureFlags?: BlockCodeFeatureFlags;\n};\n\nexport type BlockConfigGeneric = BlockConfigV3Generic | BlockConfigV4Generic;\n\nexport function extractCodeWithInfo(cfg: BlockConfigGeneric): BlockCodeWithInfo {\n  if (cfg.code === undefined) throw new Error('extractCodeWithInfo: No code bundle');\n  return {\n    code: cfg.code,\n    sdkVersion: cfg.sdkVersion,\n    featureFlags: cfg.featureFlags,\n  };\n}\n"],"names":[],"mappings":";;AAAA;AAwJM,SAAU,mBAAmB,CAAC,GAAuB,EAAA;AACzD,IAAA,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC;IAClF,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,YAAY,EAAE,GAAG,CAAC,YAAY;KAC/B;AACH;;;;"}

package/dist/bmodel/block_config.d.ts

@@ -1,11 +1,71 @@
 import type { BlockCodeFeatureFlags } from '../flags';
 import type { BlockCodeWithInfo, Code } from './code';
 import type { BlockRenderingMode } from './types';
+/**
+ * Descriptor for a state migration function.
+ * Unlike ConfigRenderLambda, migrations are not rendered reactively -
+ * they are one-time synchronous transformations called during block pack updates.
+ */
+export type MigrationDescriptor = {
+    /** Index of this migration in the migrations callback array */
+    readonly index: number;
+};
+/**
+ * BroadActiveHandleDescriptor = TypedConfigOrConfigLambda,
+ * NarrowActiveHandleDescriptor = ConfigRenderLambda
+ */
+export type BlockConfigV4Generic<_Args = unknown, _Data extends Record<string, unknown> = Record<string, unknown>, BroadActiveHandleDescriptor = unknown, NarrowActiveHandleDescriptor extends BroadActiveHandleDescriptor = BroadActiveHandleDescriptor, Outputs extends Record<string, BroadActiveHandleDescriptor> = Record<string, BroadActiveHandleDescriptor>> = {
+    /** Discriminator to identify config version */
+    readonly configVersion: 4;
+    readonly modelAPIVersion: 2;
+    /** SDK version used by the block */
+    readonly sdkVersion: string;
+    /** Main rendering mode for the block */
+    readonly renderingMode: BlockRenderingMode;
+    /** Lambda to derive block args from state */
+    readonly args: NarrowActiveHandleDescriptor;
+    /**
+     * Lambda to derive prerun args from state (optional).
+     * If not defined, defaults to using the args() result.
+     * Used for staging/prerun phase.
+     */
+    readonly prerunArgs?: NarrowActiveHandleDescriptor;
+    /** Lambda to get initial data when block is added to the project */
+    readonly initialData: NarrowActiveHandleDescriptor;
+    /** Lambda to derive list of sections for the left overview panel */
+    readonly sections: NarrowActiveHandleDescriptor;
+    /** Lambda to derive block title */
+    readonly title?: NarrowActiveHandleDescriptor;
+    /** Lambda to derive block subtitle, shown below the title */
+    readonly subtitle?: NarrowActiveHandleDescriptor;
+    /** Lambda returning array of tags for search functionality */
+    readonly tags?: BroadActiveHandleDescriptor;
+    /**
+     * Lambda returning list of upstream blocks this block enriches with its exports,
+     * influences dependency graph construction
+     * */
+    readonly enrichmentTargets?: NarrowActiveHandleDescriptor;
+    /** Configuration for the output cells */
+    readonly outputs: Outputs;
+    /**
+     * Array of migration descriptors for state version upgrades.
+     * Each migration transforms state from version N to N+1.
+     * Migrations are NOT rendered reactively - they run synchronously during block pack updates.
+     */
+    readonly migrations?: MigrationDescriptor[];
+    /** Config code bundle */
+    readonly code?: Code;
+    /** Feature flags for the block Model and UI code. */
+    readonly featureFlags?: BlockCodeFeatureFlags;
+};
 /**
  * BroadActiveHandleDescriptor = TypedConfigOrConfigLambda,
  * NarrowActiveHandleDescriptor = ConfigRenderLambda
  */
 export type BlockConfigV3Generic<Args = unknown, UiState = unknown, BroadActiveHandleDescriptor = unknown, NarrowActiveHandleDescriptor extends BroadActiveHandleDescriptor = BroadActiveHandleDescriptor, Outputs extends Record<string, BroadActiveHandleDescriptor> = Record<string, BroadActiveHandleDescriptor>> = {
+    /** Discriminator to identify config version */
+    readonly configVersion: 3;
+    readonly modelAPIVersion: 1;
     /** SDK version used by the block */
     readonly sdkVersion: string;
     /** Main rendering mode for the block */
@@ -41,6 +101,6 @@ export type BlockConfigV3Generic<Args = unknown, UiState = unknown, BroadActiveH
     /** Feature flags for the block Model and UI code. */
     readonly featureFlags?: BlockCodeFeatureFlags;
 };
-export type BlockConfigGeneric = BlockConfigV3Generic;
-export declare function extractCodeWithInfo(cfg: BlockConfigV3Generic): BlockCodeWithInfo;
+export type BlockConfigGeneric = BlockConfigV3Generic | BlockConfigV4Generic;
+export declare function extractCodeWithInfo(cfg: BlockConfigGeneric): BlockCodeWithInfo;
 //# sourceMappingURL=block_config.d.ts.map

package/dist/bmodel/block_config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block_config.d.ts","sourceRoot":"","sources":["../../src/bmodel/block_config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAC9B,IAAI,GAAG,OAAO,EACd,OAAO,GAAG,OAAO,EACjB,2BAA2B,GAAG,OAAO,EACrC,4BAA4B,SAAS,2BAA2B,GAAG,2BAA2B,EAC9F,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,IACvG;IACF,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,wCAAwC;IACxC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAE3C,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAE3B,oEAAoE;IACpE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IAEjC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;IAElD,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAE/C,mCAAmC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,4BAA4B,CAAC;IAE9C,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,4BAA4B,CAAC;IAEjD,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,2BAA2B,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;IAE1D,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,yBAAyB;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IAErB,qDAAqD;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEtD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,oBAAoB,GAAG,iBAAiB,CAOhF"}
+{"version":3,"file":"block_config.d.ts","sourceRoot":"","sources":["../../src/bmodel/block_config.ts"],"names":[],"mappings":"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"}

package/dist/bmodel/block_config.js

@@ -1,7 +1,7 @@
 // TODO BroadActiveHandleDescriptor must be removed
 function extractCodeWithInfo(cfg) {
     if (cfg.code === undefined)
-        throw new Error('No code bundle');
+        throw new Error('extractCodeWithInfo: No code bundle');
     return {
         code: cfg.code,
         sdkVersion: cfg.sdkVersion,

package/dist/bmodel/block_config.js.map

@@ -1 +1 @@
-{"version":3,"file":"block_config.js","sources":["../../src/bmodel/block_config.ts"],"sourcesContent":["// TODO BroadActiveHandleDescriptor must be removed\n\nimport type { BlockCodeFeatureFlags } from '../flags';\nimport type { BlockCodeWithInfo, Code } from './code';\nimport type { BlockRenderingMode } from './types';\n\n/**\n * BroadActiveHandleDescriptor = TypedConfigOrConfigLambda,\n * NarrowActiveHandleDescriptor = ConfigRenderLambda\n */\nexport type BlockConfigV3Generic<\n  Args = unknown,\n  UiState = unknown,\n  BroadActiveHandleDescriptor = unknown,\n  NarrowActiveHandleDescriptor extends BroadActiveHandleDescriptor = BroadActiveHandleDescriptor,\n  Outputs extends Record<string, BroadActiveHandleDescriptor> = Record<string, BroadActiveHandleDescriptor>,\n> = {\n  /** SDK version used by the block */\n  readonly sdkVersion: string;\n\n  /** Main rendering mode for the block */\n  readonly renderingMode: BlockRenderingMode;\n\n  /** Initial value for the args when block is added to the project */\n  readonly initialArgs: Args;\n\n  /** Initial value for the args when block is added to the project */\n  readonly initialUiState: UiState;\n\n  /**\n   * Config to determine whether the block can be executed with current\n   * arguments.\n   *\n   * Optional to support earlier SDK version configs.\n   */\n  readonly inputsValid: BroadActiveHandleDescriptor;\n\n  /** Configuration to derive list of section for the left overview panel */\n  readonly sections: BroadActiveHandleDescriptor;\n\n  /** Lambda to derive block title */\n  readonly title?: NarrowActiveHandleDescriptor;\n\n  /** Lambda to derive block subtitle, shown below the title */\n  readonly subtitle?: NarrowActiveHandleDescriptor;\n\n  /** Lambda returning array of tags for search functionality */\n  readonly tags?: BroadActiveHandleDescriptor;\n\n  /**\n   * Lambda returning list of upstream blocks this block enriches with its exports,\n   * influences dependency graph construction\n   */\n  readonly enrichmentTargets?: NarrowActiveHandleDescriptor;\n\n  /** Configuration for the output cells */\n  readonly outputs: Outputs;\n\n  /** Config code bundle */\n  readonly code?: Code;\n\n  /** Feature flags for the block Model and UI code. */\n  readonly featureFlags?: BlockCodeFeatureFlags;\n};\n\nexport type BlockConfigGeneric = BlockConfigV3Generic;\n\nexport function extractCodeWithInfo(cfg: BlockConfigV3Generic): BlockCodeWithInfo {\n  if (cfg.code === undefined) throw new Error('No code bundle');\n  return {\n    code: cfg.code,\n    sdkVersion: cfg.sdkVersion,\n    featureFlags: cfg.featureFlags,\n  };\n}\n"],"names":[],"mappings":"AAAA;AAmEM,SAAU,mBAAmB,CAAC,GAAyB,EAAA;AAC3D,IAAA,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC;IAC7D,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,YAAY,EAAE,GAAG,CAAC,YAAY;KAC/B;AACH;;;;"}
+{"version":3,"file":"block_config.js","sources":["../../src/bmodel/block_config.ts"],"sourcesContent":["// TODO BroadActiveHandleDescriptor must be removed\n\nimport type { BlockCodeFeatureFlags } from '../flags';\nimport type { BlockCodeWithInfo, Code } from './code';\nimport type { BlockRenderingMode } from './types';\n\n/**\n * Descriptor for a state migration function.\n * Unlike ConfigRenderLambda, migrations are not rendered reactively -\n * they are one-time synchronous transformations called during block pack updates.\n */\nexport type MigrationDescriptor = {\n  /** Index of this migration in the migrations callback array */\n  readonly index: number;\n};\n\n/**\n * BroadActiveHandleDescriptor = TypedConfigOrConfigLambda,\n * NarrowActiveHandleDescriptor = ConfigRenderLambda\n */\nexport type BlockConfigV4Generic<\n  _Args = unknown,\n  _Data extends Record<string, unknown> = Record<string, unknown>,\n  BroadActiveHandleDescriptor = unknown,\n  NarrowActiveHandleDescriptor extends BroadActiveHandleDescriptor = BroadActiveHandleDescriptor,\n  Outputs extends Record<string, BroadActiveHandleDescriptor> = Record<string, BroadActiveHandleDescriptor>,\n> = {\n  /** Discriminator to identify config version */\n  readonly configVersion: 4;\n\n  readonly modelAPIVersion: 2;\n\n  /** SDK version used by the block */\n  readonly sdkVersion: string;\n\n  /** Main rendering mode for the block */\n  readonly renderingMode: BlockRenderingMode;\n\n  /** Lambda to derive block args from state */\n  readonly args: NarrowActiveHandleDescriptor;\n\n  /**\n   * Lambda to derive prerun args from state (optional).\n   * If not defined, defaults to using the args() result.\n   * Used for staging/prerun phase.\n   */\n  readonly prerunArgs?: NarrowActiveHandleDescriptor;\n\n  /** Lambda to get initial data when block is added to the project */\n  readonly initialData: NarrowActiveHandleDescriptor;\n\n  /** Lambda to derive list of sections for the left overview panel */\n  readonly sections: NarrowActiveHandleDescriptor;\n\n  /** Lambda to derive block title */\n  readonly title?: NarrowActiveHandleDescriptor;\n\n  /** Lambda to derive block subtitle, shown below the title */\n  readonly subtitle?: NarrowActiveHandleDescriptor;\n\n  /** Lambda returning array of tags for search functionality */\n  readonly tags?: BroadActiveHandleDescriptor;\n\n  /**\n   * Lambda returning list of upstream blocks this block enriches with its exports,\n   * influences dependency graph construction\n   * */\n  readonly enrichmentTargets?: NarrowActiveHandleDescriptor;\n\n  /** Configuration for the output cells */\n  readonly outputs: Outputs;\n\n  /**\n   * Array of migration descriptors for state version upgrades.\n   * Each migration transforms state from version N to N+1.\n   * Migrations are NOT rendered reactively - they run synchronously during block pack updates.\n   */\n  readonly migrations?: MigrationDescriptor[];\n\n  /** Config code bundle */\n  readonly code?: Code;\n\n  /** Feature flags for the block Model and UI code. */\n  readonly featureFlags?: BlockCodeFeatureFlags;\n};\n\n/**\n * BroadActiveHandleDescriptor = TypedConfigOrConfigLambda,\n * NarrowActiveHandleDescriptor = ConfigRenderLambda\n */\nexport type BlockConfigV3Generic<\n  Args = unknown,\n  UiState = unknown,\n  BroadActiveHandleDescriptor = unknown,\n  NarrowActiveHandleDescriptor extends BroadActiveHandleDescriptor = BroadActiveHandleDescriptor,\n  Outputs extends Record<string, BroadActiveHandleDescriptor> = Record<string, BroadActiveHandleDescriptor>,\n> = {\n  /** Discriminator to identify config version */\n  readonly configVersion: 3;\n\n  readonly modelAPIVersion: 1;\n\n  /** SDK version used by the block */\n  readonly sdkVersion: string;\n\n  /** Main rendering mode for the block */\n  readonly renderingMode: BlockRenderingMode;\n\n  /** Initial value for the args when block is added to the project */\n  readonly initialArgs: Args;\n\n  /** Initial value for the args when block is added to the project */\n  readonly initialUiState: UiState;\n\n  /**\n   * Config to determine whether the block can be executed with current\n   * arguments.\n   *\n   * Optional to support earlier SDK version configs.\n   */\n  readonly inputsValid: BroadActiveHandleDescriptor;\n\n  /** Configuration to derive list of section for the left overview panel */\n  readonly sections: BroadActiveHandleDescriptor;\n\n  /** Lambda to derive block title */\n  readonly title?: NarrowActiveHandleDescriptor;\n\n  /** Lambda to derive block subtitle, shown below the title */\n  readonly subtitle?: NarrowActiveHandleDescriptor;\n\n  /** Lambda returning array of tags for search functionality */\n  readonly tags?: BroadActiveHandleDescriptor;\n\n  /**\n   * Lambda returning list of upstream blocks this block enriches with its exports,\n   * influences dependency graph construction\n   */\n  readonly enrichmentTargets?: NarrowActiveHandleDescriptor;\n\n  /** Configuration for the output cells */\n  readonly outputs: Outputs;\n\n  /** Config code bundle */\n  readonly code?: Code;\n\n  /** Feature flags for the block Model and UI code. */\n  readonly featureFlags?: BlockCodeFeatureFlags;\n};\n\nexport type BlockConfigGeneric = BlockConfigV3Generic | BlockConfigV4Generic;\n\nexport function extractCodeWithInfo(cfg: BlockConfigGeneric): BlockCodeWithInfo {\n  if (cfg.code === undefined) throw new Error('extractCodeWithInfo: No code bundle');\n  return {\n    code: cfg.code,\n    sdkVersion: cfg.sdkVersion,\n    featureFlags: cfg.featureFlags,\n  };\n}\n"],"names":[],"mappings":"AAAA;AAwJM,SAAU,mBAAmB,CAAC,GAAuB,EAAA;AACzD,IAAA,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC;IAClF,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,YAAY,EAAE,GAAG,CAAC,YAAY;KAC/B;AACH;;;;"}

package/dist/bmodel/container.d.ts

@@ -1,10 +1,11 @@
-import type { BlockConfigV3Generic } from './block_config';
+import type { BlockConfigV3Generic, BlockConfigV4Generic } from './block_config';
 import type { Code } from './code';
 import type { BlockRenderingMode } from './types';
 /** Container simplifying maintenance of forward and backward compatibility */
 export type BlockConfigContainer = {
+    readonly v4?: Omit<BlockConfigV4Generic, 'code'>;
     /** Actual config */
-    readonly v3: Omit<BlockConfigV3Generic, 'code'>;
+    readonly v3?: Omit<BlockConfigV3Generic, 'code'>;
     /** Config code bundle. Actually is required, but we keep it optional for backward compatibility */
     readonly code?: Code;
     /**

package/dist/bmodel/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/bmodel/container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,8EAA8E;AAC9E,MAAM,MAAM,oBAAoB,GAAG;IACjC,oBAAoB;IACpB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAEhD,mGAAmG;IACnG,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IAMrB;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C,CAAC"}
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/bmodel/container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,8EAA8E;AAC9E,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IACjD,oBAAoB;IACpB,QAAQ,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAEjD,mGAAmG;IACnG,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IAMrB;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C,CAAC"}

package/dist/bmodel/normalization.cjs

@@ -10,15 +10,38 @@ function upgradeCfgOrLambda(data) {
 /**
  * Takes universal config, and converts it into latest config structure.
  *
- * **Important**: This operation is not meant to be executed recusively.
+ * **Important**: This operation is not meant to be executed recursively.
  *                In no circumstance result of this function should be persisted!
  * */
 function extractConfigGeneric(cfg) {
-    if (cfg.v3 !== undefined) {
-        // version 3
+    if (cfg.v4 !== undefined) {
+        // version 4 (BlockModelV3) - inputsValid is derived from args() success/failure
+        const { args, prerunArgs, initialData, outputs, renderingMode, sdkVersion, featureFlags, sections, title, enrichmentTargets, migrations } = cfg.v4;
+        const { code } = cfg;
+        return {
+            configVersion: 4,
+            modelAPIVersion: 2,
+            args,
+            prerunArgs,
+            initialData,
+            outputs,
+            renderingMode,
+            sdkVersion,
+            featureFlags,
+            sections,
+            title,
+            enrichmentTargets,
+            migrations,
+            code,
+        };
+    }
+    else if (cfg.v3 !== undefined) {
+        // version 3 (BlockModel v1)
         const { initialArgs, initialUiState, inputsValid, outputs, renderingMode, sdkVersion, featureFlags, sections, title, subtitle, tags, enrichmentTargets, } = cfg.v3;
         const { code } = cfg;
         return {
+            configVersion: 3,
+            modelAPIVersion: 1,
             initialArgs,
             initialUiState,
             inputsValid,
@@ -35,7 +58,7 @@ function extractConfigGeneric(cfg) {
         };
     }
     else if (cfg.inputsValid !== undefined) {
-        // version 2
+        // version 2 (legacy) - normalize to v3 format
         const { sdkVersion, renderingMode, outputs, inputsValid, sections, initialArgs, code } = cfg;
         const fields = Object.keys(cfg);
         if (sdkVersion === undefined
@@ -46,6 +69,8 @@ function extractConfigGeneric(cfg) {
             || initialArgs === undefined)
             throw new Error(`Malformed config v2. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`);
         return {
+            configVersion: 3,
+            modelAPIVersion: 1,
             sdkVersion,
             renderingMode,
             initialArgs,
@@ -57,7 +82,7 @@ function extractConfigGeneric(cfg) {
         };
     }
     else if (cfg.renderingMode !== undefined) {
-        // version 1
+        // version 1 (legacy) - normalize to v3 format
         const { sdkVersion, canRun, renderingMode, outputs, sections, initialArgs, code } = cfg;
         const fields = Object.keys(cfg);
         if (renderingMode === undefined
@@ -67,6 +92,8 @@ function extractConfigGeneric(cfg) {
             || initialArgs === undefined)
             throw new Error(`Malformed config v1. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`);
         return {
+            configVersion: 3,
+            modelAPIVersion: 1,
             sdkVersion: sdkVersion ?? 'unknown',
             renderingMode,
             initialArgs,

package/dist/bmodel/normalization.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"normalization.cjs","sources":["../../src/bmodel/normalization.ts"],"sourcesContent":["import type { BlockConfigGeneric } from './block_config';\nimport type { BlockConfigContainer } from './container';\n\nfunction upgradeCfgOrLambda(data: unknown): unknown;\nfunction upgradeCfgOrLambda(\n  data: unknown | undefined\n): unknown | undefined;\nfunction upgradeCfgOrLambda(\n  data: unknown | undefined,\n): unknown | undefined {\n  if (data === undefined) return undefined;\n  if (typeof data === 'string') return { __renderLambda: true, handle: data, retentive: false };\n  return data;\n}\n\n/**\n * Takes universal config, and converts it into latest config structure.\n *\n * **Important**: This operation is not meant to be executed recusively.\n *                In no circumstance result of this function should be persisted!\n * */\nexport function extractConfigGeneric(cfg: BlockConfigContainer): BlockConfigGeneric {\n  if (cfg.v3 !== undefined) {\n    // version 3\n    const {\n      initialArgs,\n      initialUiState,\n      inputsValid,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      subtitle,\n      tags,\n      enrichmentTargets,\n    } = cfg.v3;\n    const { code } = cfg;\n    return {\n      initialArgs,\n      initialUiState,\n      inputsValid,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      subtitle,\n      tags,\n      code,\n      enrichmentTargets,\n    };\n  } else if (cfg.inputsValid !== undefined) {\n    // version 2\n    const { sdkVersion, renderingMode, outputs, inputsValid, sections, initialArgs, code } = cfg;\n    const fields = Object.keys(cfg);\n    if (\n      sdkVersion === undefined\n      || renderingMode === undefined\n      || outputs === undefined\n      || inputsValid === undefined\n      || sections === undefined\n      || initialArgs === undefined\n    )\n      throw new Error(\n        `Malformed config v2. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`,\n      );\n    return {\n      sdkVersion,\n      renderingMode,\n      initialArgs,\n      outputs: Object.fromEntries(\n        Object.entries(outputs).map(([key, value]) => [key, upgradeCfgOrLambda(value)]),\n      ),\n      inputsValid: upgradeCfgOrLambda(inputsValid),\n      sections: upgradeCfgOrLambda(sections),\n      initialUiState: undefined,\n      code,\n    };\n  } else if (cfg.renderingMode !== undefined) {\n    // version 1\n    const { sdkVersion, canRun, renderingMode, outputs, sections, initialArgs, code } = cfg;\n    const fields = Object.keys(cfg);\n    if (\n      renderingMode === undefined\n      || outputs === undefined\n      || canRun === undefined\n      || sections === undefined\n      || initialArgs === undefined\n    )\n      throw new Error(\n        `Malformed config v1. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`,\n      );\n    return {\n      sdkVersion: sdkVersion ?? 'unknown',\n      renderingMode,\n      initialArgs,\n      outputs: Object.fromEntries(\n        Object.entries(outputs).map(([key, value]) => [key, upgradeCfgOrLambda(value)]),\n      ),\n      inputsValid: upgradeCfgOrLambda(canRun),\n      sections: upgradeCfgOrLambda(sections),\n      initialUiState: undefined,\n      code,\n    };\n  } else {\n    const { sdkVersion } = cfg;\n    const fields = Object.keys(cfg);\n    throw new Error(\n      `Config format not supported: SDK = ${sdkVersion}; Fields = ${fields.join(', ')}`,\n    );\n  }\n}\n"],"names":[],"mappings":";;AAOA,SAAS,kBAAkB,CACzB,IAAyB,EAAA;IAEzB,IAAI,IAAI,KAAK,SAAS;AAAE,QAAA,OAAO,SAAS;IACxC,IAAI,OAAO,IAAI,KAAK,QAAQ;AAAE,QAAA,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE;AAC7F,IAAA,OAAO,IAAI;AACb;AAEA;;;;;AAKK;AACC,SAAU,oBAAoB,CAAC,GAAyB,EAAA;AAC5D,IAAA,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,EAAE;;AAExB,QAAA,MAAM,EACJ,WAAW,EACX,cAAc,EACd,WAAW,EACX,OAAO,EACP,aAAa,EACb,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,iBAAiB,GAClB,GAAG,GAAG,CAAC,EAAE;AACV,QAAA,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG;QACpB,OAAO;YACL,WAAW;YACX,cAAc;YACd,WAAW;YACX,OAAO;YACP,aAAa;YACb,UAAU;YACV,YAAY;YACZ,QAAQ;YACR,KAAK;YACL,QAAQ;YACR,IAAI;YACJ,IAAI;YACJ,iBAAiB;SAClB;IACH;AAAO,SAAA,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,EAAE;;AAExC,QAAA,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG;QAC5F,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/B,IACE,UAAU,KAAK;AACZ,eAAA,aAAa,KAAK;AAClB,eAAA,OAAO,KAAK;AACZ,eAAA,WAAW,KAAK;AAChB,eAAA,QAAQ,KAAK;AACb,eAAA,WAAW,KAAK,SAAS;AAE5B,YAAA,MAAM,IAAI,KAAK,CACb,CAAA,iCAAA,EAAoC,UAAU,CAAA,WAAA,EAAc,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CAChF;QACH,OAAO;YACL,UAAU;YACV,aAAa;YACb,WAAW;AACX,YAAA,OAAO,EAAE,MAAM,CAAC,WAAW,CACzB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAChF;AACD,YAAA,WAAW,EAAE,kBAAkB,CAAC,WAAW,CAAC;AAC5C,YAAA,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC;AACtC,YAAA,cAAc,EAAE,SAAS;YACzB,IAAI;SACL;IACH;AAAO,SAAA,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS,EAAE;;AAE1C,QAAA,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG;QACvF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/B,IACE,aAAa,KAAK;AACf,eAAA,OAAO,KAAK;AACZ,eAAA,MAAM,KAAK;AACX,eAAA,QAAQ,KAAK;AACb,eAAA,WAAW,KAAK,SAAS;AAE5B,YAAA,MAAM,IAAI,KAAK,CACb,CAAA,iCAAA,EAAoC,UAAU,CAAA,WAAA,EAAc,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CAChF;QACH,OAAO;YACL,UAAU,EAAE,UAAU,IAAI,SAAS;YACnC,aAAa;YACb,WAAW;AACX,YAAA,OAAO,EAAE,MAAM,CAAC,WAAW,CACzB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAChF;AACD,YAAA,WAAW,EAAE,kBAAkB,CAAC,MAAM,CAAC;AACvC,YAAA,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC;AACtC,YAAA,cAAc,EAAE,SAAS;YACzB,IAAI;SACL;IACH;SAAO;AACL,QAAA,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;AAC/B,QAAA,MAAM,IAAI,KAAK,CACb,CAAA,mCAAA,EAAsC,UAAU,CAAA,WAAA,EAAc,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CAClF;IACH;AACF;;;;"}
+{"version":3,"file":"normalization.cjs","sources":["../../src/bmodel/normalization.ts"],"sourcesContent":["import type { BlockConfigGeneric } from './block_config';\nimport type { BlockConfigContainer } from './container';\n\nfunction upgradeCfgOrLambda(data: unknown): unknown;\nfunction upgradeCfgOrLambda(\n  data: unknown | undefined\n): unknown | undefined;\nfunction upgradeCfgOrLambda(\n  data: unknown | undefined,\n): unknown | undefined {\n  if (data === undefined) return undefined;\n  if (typeof data === 'string') return { __renderLambda: true, handle: data, retentive: false };\n  return data;\n}\n\n/**\n * Takes universal config, and converts it into latest config structure.\n *\n * **Important**: This operation is not meant to be executed recursively.\n *                In no circumstance result of this function should be persisted!\n * */\nexport function extractConfigGeneric(cfg: BlockConfigContainer): BlockConfigGeneric {\n  if (cfg.v4 !== undefined) {\n    // version 4 (BlockModelV3) - inputsValid is derived from args() success/failure\n    const { args, prerunArgs, initialData, outputs, renderingMode, sdkVersion, featureFlags, sections, title, enrichmentTargets, migrations } = cfg.v4;\n    const { code } = cfg;\n    return {\n      configVersion: 4,\n      modelAPIVersion: 2,\n      args,\n      prerunArgs,\n      initialData,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      enrichmentTargets,\n      migrations,\n      code,\n    };\n  } else if (cfg.v3 !== undefined) {\n    // version 3 (BlockModel v1)\n    const {\n      initialArgs,\n      initialUiState,\n      inputsValid,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      subtitle,\n      tags,\n      enrichmentTargets,\n    } = cfg.v3;\n    const { code } = cfg;\n    return {\n      configVersion: 3,\n      modelAPIVersion: 1,\n      initialArgs,\n      initialUiState,\n      inputsValid,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      subtitle,\n      tags,\n      code,\n      enrichmentTargets,\n    };\n  } else if (cfg.inputsValid !== undefined) {\n    // version 2 (legacy) - normalize to v3 format\n    const { sdkVersion, renderingMode, outputs, inputsValid, sections, initialArgs, code } = cfg;\n    const fields = Object.keys(cfg);\n    if (\n      sdkVersion === undefined\n      || renderingMode === undefined\n      || outputs === undefined\n      || inputsValid === undefined\n      || sections === undefined\n      || initialArgs === undefined\n    )\n      throw new Error(\n        `Malformed config v2. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`,\n      );\n    return {\n      configVersion: 3,\n      modelAPIVersion: 1,\n      sdkVersion,\n      renderingMode,\n      initialArgs,\n      outputs: Object.fromEntries(\n        Object.entries(outputs).map(([key, value]) => [key, upgradeCfgOrLambda(value)]),\n      ),\n      inputsValid: upgradeCfgOrLambda(inputsValid),\n      sections: upgradeCfgOrLambda(sections),\n      initialUiState: undefined,\n      code,\n    };\n  } else if (cfg.renderingMode !== undefined) {\n    // version 1 (legacy) - normalize to v3 format\n    const { sdkVersion, canRun, renderingMode, outputs, sections, initialArgs, code } = cfg;\n    const fields = Object.keys(cfg);\n    if (\n      renderingMode === undefined\n      || outputs === undefined\n      || canRun === undefined\n      || sections === undefined\n      || initialArgs === undefined\n    )\n      throw new Error(\n        `Malformed config v1. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`,\n      );\n    return {\n      configVersion: 3,\n      modelAPIVersion: 1,\n      sdkVersion: sdkVersion ?? 'unknown',\n      renderingMode,\n      initialArgs,\n      outputs: Object.fromEntries(\n        Object.entries(outputs).map(([key, value]) => [key, upgradeCfgOrLambda(value)]),\n      ),\n      inputsValid: upgradeCfgOrLambda(canRun),\n      sections: upgradeCfgOrLambda(sections),\n      initialUiState: undefined,\n      code,\n    };\n  } else {\n    const { sdkVersion } = cfg;\n    const fields = Object.keys(cfg);\n    throw new Error(\n      `Config format not supported: SDK = ${sdkVersion}; Fields = ${fields.join(', ')}`,\n    );\n  }\n}\n"],"names":[],"mappings":";;AAOA,SAAS,kBAAkB,CACzB,IAAyB,EAAA;IAEzB,IAAI,IAAI,KAAK,SAAS;AAAE,QAAA,OAAO,SAAS;IACxC,IAAI,OAAO,IAAI,KAAK,QAAQ;AAAE,QAAA,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE;AAC7F,IAAA,OAAO,IAAI;AACb;AAEA;;;;;AAKK;AACC,SAAU,oBAAoB,CAAC,GAAyB,EAAA;AAC5D,IAAA,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,EAAE;;QAExB,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,EAAE;AAClJ,QAAA,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG;QACpB,OAAO;AACL,YAAA,aAAa,EAAE,CAAC;AAChB,YAAA,eAAe,EAAE,CAAC;YAClB,IAAI;YACJ,UAAU;YACV,WAAW;YACX,OAAO;YACP,aAAa;YACb,UAAU;YACV,YAAY;YACZ,QAAQ;YACR,KAAK;YACL,iBAAiB;YACjB,UAAU;YACV,IAAI;SACL;IACH;AAAO,SAAA,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,EAAE;;AAE/B,QAAA,MAAM,EACJ,WAAW,EACX,cAAc,EACd,WAAW,EACX,OAAO,EACP,aAAa,EACb,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,iBAAiB,GAClB,GAAG,GAAG,CAAC,EAAE;AACV,QAAA,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG;QACpB,OAAO;AACL,YAAA,aAAa,EAAE,CAAC;AAChB,YAAA,eAAe,EAAE,CAAC;YAClB,WAAW;YACX,cAAc;YACd,WAAW;YACX,OAAO;YACP,aAAa;YACb,UAAU;YACV,YAAY;YACZ,QAAQ;YACR,KAAK;YACL,QAAQ;YACR,IAAI;YACJ,IAAI;YACJ,iBAAiB;SAClB;IACH;AAAO,SAAA,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,EAAE;;AAExC,QAAA,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG;QAC5F,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/B,IACE,UAAU,KAAK;AACZ,eAAA,aAAa,KAAK;AAClB,eAAA,OAAO,KAAK;AACZ,eAAA,WAAW,KAAK;AAChB,eAAA,QAAQ,KAAK;AACb,eAAA,WAAW,KAAK,SAAS;AAE5B,YAAA,MAAM,IAAI,KAAK,CACb,CAAA,iCAAA,EAAoC,UAAU,CAAA,WAAA,EAAc,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CAChF;QACH,OAAO;AACL,YAAA,aAAa,EAAE,CAAC;AAChB,YAAA,eAAe,EAAE,CAAC;YAClB,UAAU;YACV,aAAa;YACb,WAAW;AACX,YAAA,OAAO,EAAE,MAAM,CAAC,WAAW,CACzB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAChF;AACD,YAAA,WAAW,EAAE,kBAAkB,CAAC,WAAW,CAAC;AAC5C,YAAA,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC;AACtC,YAAA,cAAc,EAAE,SAAS;YACzB,IAAI;SACL;IACH;AAAO,SAAA,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS,EAAE;;AAE1C,QAAA,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG;QACvF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/B,IACE,aAAa,KAAK;AACf,eAAA,OAAO,KAAK;AACZ,eAAA,MAAM,KAAK;AACX,eAAA,QAAQ,KAAK;AACb,eAAA,WAAW,KAAK,SAAS;AAE5B,YAAA,MAAM,IAAI,KAAK,CACb,CAAA,iCAAA,EAAoC,UAAU,CAAA,WAAA,EAAc,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CAChF;QACH,OAAO;AACL,YAAA,aAAa,EAAE,CAAC;AAChB,YAAA,eAAe,EAAE,CAAC;YAClB,UAAU,EAAE,UAAU,IAAI,SAAS;YACnC,aAAa;YACb,WAAW;AACX,YAAA,OAAO,EAAE,MAAM,CAAC,WAAW,CACzB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAChF;AACD,YAAA,WAAW,EAAE,kBAAkB,CAAC,MAAM,CAAC;AACvC,YAAA,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC;AACtC,YAAA,cAAc,EAAE,SAAS;YACzB,IAAI;SACL;IACH;SAAO;AACL,QAAA,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;AAC/B,QAAA,MAAM,IAAI,KAAK,CACb,CAAA,mCAAA,EAAsC,UAAU,CAAA,WAAA,EAAc,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CAClF;IACH;AACF;;;;"}

package/dist/bmodel/normalization.d.ts

@@ -3,7 +3,7 @@ import type { BlockConfigContainer } from './container';
 /**
  * Takes universal config, and converts it into latest config structure.
  *
- * **Important**: This operation is not meant to be executed recusively.
+ * **Important**: This operation is not meant to be executed recursively.
  *                In no circumstance result of this function should be persisted!
  * */
 export declare function extractConfigGeneric(cfg: BlockConfigContainer): BlockConfigGeneric;

package/dist/bmodel/normalization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalization.d.ts","sourceRoot":"","sources":["../../src/bmodel/normalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAcxD;;;;;KAKK;AACL,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,oBAAoB,GAAG,kBAAkB,CA6FlF"}
+{"version":3,"file":"normalization.d.ts","sourceRoot":"","sources":["../../src/bmodel/normalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAcxD;;;;;KAKK;AACL,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,oBAAoB,GAAG,kBAAkB,CAuHlF"}

package/dist/bmodel/normalization.js

@@ -8,15 +8,38 @@ function upgradeCfgOrLambda(data) {
 /**
  * Takes universal config, and converts it into latest config structure.
  *
- * **Important**: This operation is not meant to be executed recusively.
+ * **Important**: This operation is not meant to be executed recursively.
  *                In no circumstance result of this function should be persisted!
  * */
 function extractConfigGeneric(cfg) {
-    if (cfg.v3 !== undefined) {
-        // version 3
+    if (cfg.v4 !== undefined) {
+        // version 4 (BlockModelV3) - inputsValid is derived from args() success/failure
+        const { args, prerunArgs, initialData, outputs, renderingMode, sdkVersion, featureFlags, sections, title, enrichmentTargets, migrations } = cfg.v4;
+        const { code } = cfg;
+        return {
+            configVersion: 4,
+            modelAPIVersion: 2,
+            args,
+            prerunArgs,
+            initialData,
+            outputs,
+            renderingMode,
+            sdkVersion,
+            featureFlags,
+            sections,
+            title,
+            enrichmentTargets,
+            migrations,
+            code,
+        };
+    }
+    else if (cfg.v3 !== undefined) {
+        // version 3 (BlockModel v1)
         const { initialArgs, initialUiState, inputsValid, outputs, renderingMode, sdkVersion, featureFlags, sections, title, subtitle, tags, enrichmentTargets, } = cfg.v3;
         const { code } = cfg;
         return {
+            configVersion: 3,
+            modelAPIVersion: 1,
             initialArgs,
             initialUiState,
             inputsValid,
@@ -33,7 +56,7 @@ function extractConfigGeneric(cfg) {
         };
     }
     else if (cfg.inputsValid !== undefined) {
-        // version 2
+        // version 2 (legacy) - normalize to v3 format
         const { sdkVersion, renderingMode, outputs, inputsValid, sections, initialArgs, code } = cfg;
         const fields = Object.keys(cfg);
         if (sdkVersion === undefined
@@ -44,6 +67,8 @@ function extractConfigGeneric(cfg) {
             || initialArgs === undefined)
             throw new Error(`Malformed config v2. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`);
         return {
+            configVersion: 3,
+            modelAPIVersion: 1,
             sdkVersion,
             renderingMode,
             initialArgs,
@@ -55,7 +80,7 @@ function extractConfigGeneric(cfg) {
         };
     }
     else if (cfg.renderingMode !== undefined) {
-        // version 1
+        // version 1 (legacy) - normalize to v3 format
         const { sdkVersion, canRun, renderingMode, outputs, sections, initialArgs, code } = cfg;
         const fields = Object.keys(cfg);
         if (renderingMode === undefined
@@ -65,6 +90,8 @@ function extractConfigGeneric(cfg) {
             || initialArgs === undefined)
             throw new Error(`Malformed config v1. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`);
         return {
+            configVersion: 3,
+            modelAPIVersion: 1,
             sdkVersion: sdkVersion ?? 'unknown',
             renderingMode,
             initialArgs,

package/dist/bmodel/normalization.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalization.js","sources":["../../src/bmodel/normalization.ts"],"sourcesContent":["import type { BlockConfigGeneric } from './block_config';\nimport type { BlockConfigContainer } from './container';\n\nfunction upgradeCfgOrLambda(data: unknown): unknown;\nfunction upgradeCfgOrLambda(\n  data: unknown | undefined\n): unknown | undefined;\nfunction upgradeCfgOrLambda(\n  data: unknown | undefined,\n): unknown | undefined {\n  if (data === undefined) return undefined;\n  if (typeof data === 'string') return { __renderLambda: true, handle: data, retentive: false };\n  return data;\n}\n\n/**\n * Takes universal config, and converts it into latest config structure.\n *\n * **Important**: This operation is not meant to be executed recusively.\n *                In no circumstance result of this function should be persisted!\n * */\nexport function extractConfigGeneric(cfg: BlockConfigContainer): BlockConfigGeneric {\n  if (cfg.v3 !== undefined) {\n    // version 3\n    const {\n      initialArgs,\n      initialUiState,\n      inputsValid,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      subtitle,\n      tags,\n      enrichmentTargets,\n    } = cfg.v3;\n    const { code } = cfg;\n    return {\n      initialArgs,\n      initialUiState,\n      inputsValid,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      subtitle,\n      tags,\n      code,\n      enrichmentTargets,\n    };\n  } else if (cfg.inputsValid !== undefined) {\n    // version 2\n    const { sdkVersion, renderingMode, outputs, inputsValid, sections, initialArgs, code } = cfg;\n    const fields = Object.keys(cfg);\n    if (\n      sdkVersion === undefined\n      || renderingMode === undefined\n      || outputs === undefined\n      || inputsValid === undefined\n      || sections === undefined\n      || initialArgs === undefined\n    )\n      throw new Error(\n        `Malformed config v2. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`,\n      );\n    return {\n      sdkVersion,\n      renderingMode,\n      initialArgs,\n      outputs: Object.fromEntries(\n        Object.entries(outputs).map(([key, value]) => [key, upgradeCfgOrLambda(value)]),\n      ),\n      inputsValid: upgradeCfgOrLambda(inputsValid),\n      sections: upgradeCfgOrLambda(sections),\n      initialUiState: undefined,\n      code,\n    };\n  } else if (cfg.renderingMode !== undefined) {\n    // version 1\n    const { sdkVersion, canRun, renderingMode, outputs, sections, initialArgs, code } = cfg;\n    const fields = Object.keys(cfg);\n    if (\n      renderingMode === undefined\n      || outputs === undefined\n      || canRun === undefined\n      || sections === undefined\n      || initialArgs === undefined\n    )\n      throw new Error(\n        `Malformed config v1. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`,\n      );\n    return {\n      sdkVersion: sdkVersion ?? 'unknown',\n      renderingMode,\n      initialArgs,\n      outputs: Object.fromEntries(\n        Object.entries(outputs).map(([key, value]) => [key, upgradeCfgOrLambda(value)]),\n      ),\n      inputsValid: upgradeCfgOrLambda(canRun),\n      sections: upgradeCfgOrLambda(sections),\n      initialUiState: undefined,\n      code,\n    };\n  } else {\n    const { sdkVersion } = cfg;\n    const fields = Object.keys(cfg);\n    throw new Error(\n      `Config format not supported: SDK = ${sdkVersion}; Fields = ${fields.join(', ')}`,\n    );\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"normalization.js","sources":["../../src/bmodel/normalization.ts"],"sourcesContent":["import type { BlockConfigGeneric } from './block_config';\nimport type { BlockConfigContainer } from './container';\n\nfunction upgradeCfgOrLambda(data: unknown): unknown;\nfunction upgradeCfgOrLambda(\n  data: unknown | undefined\n): unknown | undefined;\nfunction upgradeCfgOrLambda(\n  data: unknown | undefined,\n): unknown | undefined {\n  if (data === undefined) return undefined;\n  if (typeof data === 'string') return { __renderLambda: true, handle: data, retentive: false };\n  return data;\n}\n\n/**\n * Takes universal config, and converts it into latest config structure.\n *\n * **Important**: This operation is not meant to be executed recursively.\n *                In no circumstance result of this function should be persisted!\n * */\nexport function extractConfigGeneric(cfg: BlockConfigContainer): BlockConfigGeneric {\n  if (cfg.v4 !== undefined) {\n    // version 4 (BlockModelV3) - inputsValid is derived from args() success/failure\n    const { args, prerunArgs, initialData, outputs, renderingMode, sdkVersion, featureFlags, sections, title, enrichmentTargets, migrations } = cfg.v4;\n    const { code } = cfg;\n    return {\n      configVersion: 4,\n      modelAPIVersion: 2,\n      args,\n      prerunArgs,\n      initialData,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      enrichmentTargets,\n      migrations,\n      code,\n    };\n  } else if (cfg.v3 !== undefined) {\n    // version 3 (BlockModel v1)\n    const {\n      initialArgs,\n      initialUiState,\n      inputsValid,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      subtitle,\n      tags,\n      enrichmentTargets,\n    } = cfg.v3;\n    const { code } = cfg;\n    return {\n      configVersion: 3,\n      modelAPIVersion: 1,\n      initialArgs,\n      initialUiState,\n      inputsValid,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      subtitle,\n      tags,\n      code,\n      enrichmentTargets,\n    };\n  } else if (cfg.inputsValid !== undefined) {\n    // version 2 (legacy) - normalize to v3 format\n    const { sdkVersion, renderingMode, outputs, inputsValid, sections, initialArgs, code } = cfg;\n    const fields = Object.keys(cfg);\n    if (\n      sdkVersion === undefined\n      || renderingMode === undefined\n      || outputs === undefined\n      || inputsValid === undefined\n      || sections === undefined\n      || initialArgs === undefined\n    )\n      throw new Error(\n        `Malformed config v2. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`,\n      );\n    return {\n      configVersion: 3,\n      modelAPIVersion: 1,\n      sdkVersion,\n      renderingMode,\n      initialArgs,\n      outputs: Object.fromEntries(\n        Object.entries(outputs).map(([key, value]) => [key, upgradeCfgOrLambda(value)]),\n      ),\n      inputsValid: upgradeCfgOrLambda(inputsValid),\n      sections: upgradeCfgOrLambda(sections),\n      initialUiState: undefined,\n      code,\n    };\n  } else if (cfg.renderingMode !== undefined) {\n    // version 1 (legacy) - normalize to v3 format\n    const { sdkVersion, canRun, renderingMode, outputs, sections, initialArgs, code } = cfg;\n    const fields = Object.keys(cfg);\n    if (\n      renderingMode === undefined\n      || outputs === undefined\n      || canRun === undefined\n      || sections === undefined\n      || initialArgs === undefined\n    )\n      throw new Error(\n        `Malformed config v1. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`,\n      );\n    return {\n      configVersion: 3,\n      modelAPIVersion: 1,\n      sdkVersion: sdkVersion ?? 'unknown',\n      renderingMode,\n      initialArgs,\n      outputs: Object.fromEntries(\n        Object.entries(outputs).map(([key, value]) => [key, upgradeCfgOrLambda(value)]),\n      ),\n      inputsValid: upgradeCfgOrLambda(canRun),\n      sections: upgradeCfgOrLambda(sections),\n      initialUiState: undefined,\n      code,\n    };\n  } else {\n    const { sdkVersion } = cfg;\n    const fields = Object.keys(cfg);\n    throw new Error(\n      `Config format not supported: SDK = ${sdkVersion}; Fields = ${fields.join(', ')}`,\n    );\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/common_types.d.ts

@@ -1,17 +1,17 @@
 import type { ErrorLike } from '@milaboratories/pl-error-like';
 /** Use this as constraint instead of `Function` */
 export type AnyFunction = (...args: any[]) => any;
-/** Value or errors */
-export type ValueOrErrors<T> = {
+export type OutputWithStatus<T> = {
     ok: true;
     value: T;
+    stable: boolean;
 } | {
     ok: false;
     errors: ErrorLike[];
     moreErrors: boolean;
 };
 /** Base type for block outputs */
-export type BlockOutputsBase = Record<string, ValueOrErrors<unknown>>;
+export type BlockOutputsBase = Record<string, OutputWithStatus<unknown>>;
 export type ListOptionBase<T = unknown> = {
     label: string;
     description?: string;

package/dist/common_types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common_types.d.ts","sourceRoot":"","sources":["../src/common_types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,mDAAmD;AAEnD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAElD,sBAAsB;AACtB,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5D,kCAAkC;AAClC,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAEtE,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}
+{"version":3,"file":"common_types.d.ts","sourceRoot":"","sources":["../src/common_types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,mDAAmD;AAEnD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAElD,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACvC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5D,kCAAkC;AAClC,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AAEzE,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-model-common",
-  "version": "1.22.0",
+  "version": "1.24.0",
   "description": "Platforma SDK Model",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -26,10 +26,10 @@
     "typescript": "~5.6.3",
     "vitest": "^4.0.16",
     "@vitest/coverage-istanbul": "^4.0.16",
-    "@milaboratories/build-configs": "1.2.1",
-    "@milaboratories/ts-configs": "1.2.0",
+    "@milaboratories/build-configs": "1.2.2",
     "@milaboratories/eslint-config": "1.0.5",
-    "@milaboratories/ts-builder": "1.2.1"
+    "@milaboratories/ts-configs": "1.2.0",
+    "@milaboratories/ts-builder": "1.2.2"
   },
   "scripts": {
     "type-check": "ts-builder types --target node",

package/src/block_state.ts

@@ -31,3 +31,20 @@ export type BlockState<
 
   readonly author: AuthorMarker | undefined;
 };
+
+export type BlockStateV3<
+  Outputs extends BlockOutputsBase = BlockOutputsBase,
+  _Data = unknown,
+  Href extends `/${string}` = `/${string}`,
+> = {
+  /** Block storage persisted in the block state */
+  blockStorage: unknown;
+
+  /** Outputs rendered with block config */
+  outputs: Outputs;
+
+  /** Current navigation state */
+  navigationState: NavigationState<Href>;
+
+  readonly author: AuthorMarker | undefined;
+};

package/src/bmodel/block_config.ts

@@ -4,6 +4,86 @@ import type { BlockCodeFeatureFlags } from '../flags';
 import type { BlockCodeWithInfo, Code } from './code';
 import type { BlockRenderingMode } from './types';
 
+/**
+ * Descriptor for a state migration function.
+ * Unlike ConfigRenderLambda, migrations are not rendered reactively -
+ * they are one-time synchronous transformations called during block pack updates.
+ */
+export type MigrationDescriptor = {
+  /** Index of this migration in the migrations callback array */
+  readonly index: number;
+};
+
+/**
+ * BroadActiveHandleDescriptor = TypedConfigOrConfigLambda,
+ * NarrowActiveHandleDescriptor = ConfigRenderLambda
+ */
+export type BlockConfigV4Generic<
+  _Args = unknown,
+  _Data extends Record<string, unknown> = Record<string, unknown>,
+  BroadActiveHandleDescriptor = unknown,
+  NarrowActiveHandleDescriptor extends BroadActiveHandleDescriptor = BroadActiveHandleDescriptor,
+  Outputs extends Record<string, BroadActiveHandleDescriptor> = Record<string, BroadActiveHandleDescriptor>,
+> = {
+  /** Discriminator to identify config version */
+  readonly configVersion: 4;
+
+  readonly modelAPIVersion: 2;
+
+  /** SDK version used by the block */
+  readonly sdkVersion: string;
+
+  /** Main rendering mode for the block */
+  readonly renderingMode: BlockRenderingMode;
+
+  /** Lambda to derive block args from state */
+  readonly args: NarrowActiveHandleDescriptor;
+
+  /**
+   * Lambda to derive prerun args from state (optional).
+   * If not defined, defaults to using the args() result.
+   * Used for staging/prerun phase.
+   */
+  readonly prerunArgs?: NarrowActiveHandleDescriptor;
+
+  /** Lambda to get initial data when block is added to the project */
+  readonly initialData: NarrowActiveHandleDescriptor;
+
+  /** Lambda to derive list of sections for the left overview panel */
+  readonly sections: NarrowActiveHandleDescriptor;
+
+  /** Lambda to derive block title */
+  readonly title?: NarrowActiveHandleDescriptor;
+
+  /** Lambda to derive block subtitle, shown below the title */
+  readonly subtitle?: NarrowActiveHandleDescriptor;
+
+  /** Lambda returning array of tags for search functionality */
+  readonly tags?: BroadActiveHandleDescriptor;
+
+  /**
+   * Lambda returning list of upstream blocks this block enriches with its exports,
+   * influences dependency graph construction
+   * */
+  readonly enrichmentTargets?: NarrowActiveHandleDescriptor;
+
+  /** Configuration for the output cells */
+  readonly outputs: Outputs;
+
+  /**
+   * Array of migration descriptors for state version upgrades.
+   * Each migration transforms state from version N to N+1.
+   * Migrations are NOT rendered reactively - they run synchronously during block pack updates.
+   */
+  readonly migrations?: MigrationDescriptor[];
+
+  /** Config code bundle */
+  readonly code?: Code;
+
+  /** Feature flags for the block Model and UI code. */
+  readonly featureFlags?: BlockCodeFeatureFlags;
+};
+
 /**
  * BroadActiveHandleDescriptor = TypedConfigOrConfigLambda,
  * NarrowActiveHandleDescriptor = ConfigRenderLambda
@@ -15,6 +95,11 @@ export type BlockConfigV3Generic<
   NarrowActiveHandleDescriptor extends BroadActiveHandleDescriptor = BroadActiveHandleDescriptor,
   Outputs extends Record<string, BroadActiveHandleDescriptor> = Record<string, BroadActiveHandleDescriptor>,
 > = {
+  /** Discriminator to identify config version */
+  readonly configVersion: 3;
+
+  readonly modelAPIVersion: 1;
+
   /** SDK version used by the block */
   readonly sdkVersion: string;
 
@@ -63,10 +148,10 @@ export type BlockConfigV3Generic<
   readonly featureFlags?: BlockCodeFeatureFlags;
 };
 
-export type BlockConfigGeneric = BlockConfigV3Generic;
+export type BlockConfigGeneric = BlockConfigV3Generic | BlockConfigV4Generic;
 
-export function extractCodeWithInfo(cfg: BlockConfigV3Generic): BlockCodeWithInfo {
-  if (cfg.code === undefined) throw new Error('No code bundle');
+export function extractCodeWithInfo(cfg: BlockConfigGeneric): BlockCodeWithInfo {
+  if (cfg.code === undefined) throw new Error('extractCodeWithInfo: No code bundle');
   return {
     code: cfg.code,
     sdkVersion: cfg.sdkVersion,

package/src/bmodel/container.ts

@@ -1,11 +1,12 @@
-import type { BlockConfigV3Generic } from './block_config';
+import type { BlockConfigV3Generic, BlockConfigV4Generic } from './block_config';
 import type { Code } from './code';
 import type { BlockRenderingMode } from './types';
 
 /** Container simplifying maintenance of forward and backward compatibility */
 export type BlockConfigContainer = {
+  readonly v4?: Omit<BlockConfigV4Generic, 'code'>;
   /** Actual config */
-  readonly v3: Omit<BlockConfigV3Generic, 'code'>;
+  readonly v3?: Omit<BlockConfigV3Generic, 'code'>;
 
   /** Config code bundle. Actually is required, but we keep it optional for backward compatibility */
   readonly code?: Code;

package/src/bmodel/normalization.ts

@@ -16,12 +16,32 @@ function upgradeCfgOrLambda(
 /**
  * Takes universal config, and converts it into latest config structure.
  *
- * **Important**: This operation is not meant to be executed recusively.
+ * **Important**: This operation is not meant to be executed recursively.
  *                In no circumstance result of this function should be persisted!
  * */
 export function extractConfigGeneric(cfg: BlockConfigContainer): BlockConfigGeneric {
-  if (cfg.v3 !== undefined) {
-    // version 3
+  if (cfg.v4 !== undefined) {
+    // version 4 (BlockModelV3) - inputsValid is derived from args() success/failure
+    const { args, prerunArgs, initialData, outputs, renderingMode, sdkVersion, featureFlags, sections, title, enrichmentTargets, migrations } = cfg.v4;
+    const { code } = cfg;
+    return {
+      configVersion: 4,
+      modelAPIVersion: 2,
+      args,
+      prerunArgs,
+      initialData,
+      outputs,
+      renderingMode,
+      sdkVersion,
+      featureFlags,
+      sections,
+      title,
+      enrichmentTargets,
+      migrations,
+      code,
+    };
+  } else if (cfg.v3 !== undefined) {
+    // version 3 (BlockModel v1)
     const {
       initialArgs,
       initialUiState,
@@ -38,6 +58,8 @@ export function extractConfigGeneric(cfg: BlockConfigContainer): BlockConfigGene
     } = cfg.v3;
     const { code } = cfg;
     return {
+      configVersion: 3,
+      modelAPIVersion: 1,
       initialArgs,
       initialUiState,
       inputsValid,
@@ -53,7 +75,7 @@ export function extractConfigGeneric(cfg: BlockConfigContainer): BlockConfigGene
       enrichmentTargets,
     };
   } else if (cfg.inputsValid !== undefined) {
-    // version 2
+    // version 2 (legacy) - normalize to v3 format
     const { sdkVersion, renderingMode, outputs, inputsValid, sections, initialArgs, code } = cfg;
     const fields = Object.keys(cfg);
     if (
@@ -68,6 +90,8 @@ export function extractConfigGeneric(cfg: BlockConfigContainer): BlockConfigGene
         `Malformed config v2. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`,
       );
     return {
+      configVersion: 3,
+      modelAPIVersion: 1,
       sdkVersion,
       renderingMode,
       initialArgs,
@@ -80,7 +104,7 @@ export function extractConfigGeneric(cfg: BlockConfigContainer): BlockConfigGene
       code,
     };
   } else if (cfg.renderingMode !== undefined) {
-    // version 1
+    // version 1 (legacy) - normalize to v3 format
     const { sdkVersion, canRun, renderingMode, outputs, sections, initialArgs, code } = cfg;
     const fields = Object.keys(cfg);
     if (
@@ -94,6 +118,8 @@ export function extractConfigGeneric(cfg: BlockConfigContainer): BlockConfigGene
         `Malformed config v1. SDK version ${sdkVersion}; Fields = ${fields.join(', ')}`,
       );
     return {
+      configVersion: 3,
+      modelAPIVersion: 1,
       sdkVersion: sdkVersion ?? 'unknown',
       renderingMode,
       initialArgs,

package/src/common_types.ts

@@ -4,13 +4,12 @@ import type { ErrorLike } from '@milaboratories/pl-error-like';
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export type AnyFunction = (...args: any[]) => any;
 
-/** Value or errors */
-export type ValueOrErrors<T> =
-  | { ok: true; value: T }
+export type OutputWithStatus<T> =
+  | { ok: true; value: T; stable: boolean }
   | { ok: false; errors: ErrorLike[]; moreErrors: boolean };
 
 /** Base type for block outputs */
-export type BlockOutputsBase = Record<string, ValueOrErrors<unknown>>;
+export type BlockOutputsBase = Record<string, OutputWithStatus<unknown>>;
 
 export type ListOptionBase<T = unknown> = {
   label: string;