@milaboratories/pl-model-common 1.24.11 → 1.25.1

package/dist/block_state.d.ts

@@ -1,6 +1,7 @@
 import type { BlockOutputsBase } from "./common_types";
 import type { NavigationState } from "./navigation";
 import type { AuthorMarker } from "./author_marker";
+import { StringifiedJson } from "./json";
 /**
  * @template Args    sets type of block arguments passed to the workflow
  * @template Outputs type of the outputs returned by the workflow and rendered
@@ -21,9 +22,9 @@ 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}`> = {
+export type BlockStateV3<_Data = unknown, Outputs extends BlockOutputsBase = BlockOutputsBase, Href extends `/${string}` = `/${string}`> = {
     /** Block storage persisted in the block state */
-    blockStorage: unknown;
+    blockStorage: StringifiedJson;
     /** Outputs rendered with block config */
     outputs: Outputs;
     /** Current navigation state */

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;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"}
+{"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;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC;;;;;;;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,KAAK,GAAG,OAAO,EACf,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EACnD,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,IACtC;IACF,iDAAiD;IACjD,YAAY,EAAE,eAAe,CAAC;IAE9B,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.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 * 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<\n    string,\n    BroadActiveHandleDescriptor\n  >,\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<\n    string,\n    BroadActiveHandleDescriptor\n  >,\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;AA8JM,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;;;;"}
+{"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 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<\n    string,\n    BroadActiveHandleDescriptor\n  >,\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 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  /** Config code bundle */\n  readonly code?: Code;\n\n  /** Feature flags for the block Model and UI code. */\n  readonly featureFlags?: BlockCodeFeatureFlags;\n\n  /** Facade callbacks supported by this block (for pre-execution validation) */\n  readonly blockLifecycleCallbacks: Record<string, NarrowActiveHandleDescriptor>;\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<\n    string,\n    BroadActiveHandleDescriptor\n  >,\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;AAmIM,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,15 +1,6 @@
 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
@@ -22,16 +13,6 @@ export type BlockConfigV4Generic<_Args = unknown, _Data extends Record<string, u
     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 */
@@ -47,16 +28,12 @@ export type BlockConfigV4Generic<_Args = unknown, _Data extends Record<string, u
     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;
+    /** Facade callbacks supported by this block (for pre-execution validation) */
+    readonly blockLifecycleCallbacks: Record<string, NarrowActiveHandleDescriptor>;
 };
 /**
  * BroadActiveHandleDescriptor = TypedConfigOrConfigLambda,

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":"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"}
+{"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.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 * 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<\n    string,\n    BroadActiveHandleDescriptor\n  >,\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<\n    string,\n    BroadActiveHandleDescriptor\n  >,\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;AA8JM,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;;;;"}
+{"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 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<\n    string,\n    BroadActiveHandleDescriptor\n  >,\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 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  /** Config code bundle */\n  readonly code?: Code;\n\n  /** Feature flags for the block Model and UI code. */\n  readonly featureFlags?: BlockCodeFeatureFlags;\n\n  /** Facade callbacks supported by this block (for pre-execution validation) */\n  readonly blockLifecycleCallbacks: Record<string, NarrowActiveHandleDescriptor>;\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<\n    string,\n    BroadActiveHandleDescriptor\n  >,\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;AAmIM,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/normalization.cjs

@@ -16,22 +16,21 @@ function upgradeCfgOrLambda(data) {
 function extractConfigGeneric(cfg) {
     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 { outputs, renderingMode, sdkVersion, featureFlags, sections, title, subtitle, tags, enrichmentTargets, blockLifecycleCallbacks = {}, } = cfg.v4;
         const { code } = cfg;
         return {
             configVersion: 4,
             modelAPIVersion: 2,
-            args,
-            prerunArgs,
-            initialData,
             outputs,
             renderingMode,
             sdkVersion,
             featureFlags,
             sections,
             title,
+            subtitle,
+            tags,
             enrichmentTargets,
-            migrations,
+            blockLifecycleCallbacks,
             code,
         };
     }

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(data: unknown | undefined): unknown | undefined;\nfunction upgradeCfgOrLambda(data: unknown | undefined): 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 {\n      args,\n      prerunArgs,\n      initialData,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      enrichmentTargets,\n      migrations,\n    } = 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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"}
+{"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(data: unknown | undefined): unknown | undefined;\nfunction upgradeCfgOrLambda(data: unknown | undefined): 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 {\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      subtitle,\n      tags,\n      enrichmentTargets,\n      blockLifecycleCallbacks = {},\n    } = cfg.v4;\n    const { code } = cfg;\n    return {\n      configVersion: 4,\n      modelAPIVersion: 2,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      subtitle,\n      tags,\n      enrichmentTargets,\n      blockLifecycleCallbacks,\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/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;AAUxD;;;;;KAKK;AACL,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,oBAAoB,GAAG,kBAAkB,CAmIlF"}
+{"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;AAUxD;;;;;KAKK;AACL,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,oBAAoB,GAAG,kBAAkB,CAiIlF"}

package/dist/bmodel/normalization.js

@@ -14,22 +14,21 @@ function upgradeCfgOrLambda(data) {
 function extractConfigGeneric(cfg) {
     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 { outputs, renderingMode, sdkVersion, featureFlags, sections, title, subtitle, tags, enrichmentTargets, blockLifecycleCallbacks = {}, } = cfg.v4;
         const { code } = cfg;
         return {
             configVersion: 4,
             modelAPIVersion: 2,
-            args,
-            prerunArgs,
-            initialData,
             outputs,
             renderingMode,
             sdkVersion,
             featureFlags,
             sections,
             title,
+            subtitle,
+            tags,
             enrichmentTargets,
-            migrations,
+            blockLifecycleCallbacks,
             code,
         };
     }

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(data: unknown | undefined): unknown | undefined;\nfunction upgradeCfgOrLambda(data: unknown | undefined): 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 {\n      args,\n      prerunArgs,\n      initialData,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      enrichmentTargets,\n      migrations,\n    } = 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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"}
+{"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(data: unknown | undefined): unknown | undefined;\nfunction upgradeCfgOrLambda(data: unknown | undefined): 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 {\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      subtitle,\n      tags,\n      enrichmentTargets,\n      blockLifecycleCallbacks = {},\n    } = cfg.v4;\n    const { code } = cfg;\n    return {\n      configVersion: 4,\n      modelAPIVersion: 2,\n      outputs,\n      renderingMode,\n      sdkVersion,\n      featureFlags,\n      sections,\n      title,\n      subtitle,\n      tags,\n      enrichmentTargets,\n      blockLifecycleCallbacks,\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/flags/block_flags.cjs

@@ -3,7 +3,7 @@
 const AllSupportsFeatureFlags = ["supportsLazyState"];
 const AllRequiresFeatureFlags = [
     "requiresUIAPIVersion",
-    "requiresCreatePTableV2",
+    "requiresCreatePTable",
     "requiresModelAPIVersion",
 ];
 

package/dist/flags/block_flags.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"block_flags.cjs","sources":["../../src/flags/block_flags.ts"],"sourcesContent":["import type { ArrayTypeUnion, Assert, Is, IsSubtypeOf } from \"./type_utils\";\n\n/**\n * Block-specific feature flags. Define flags that are interpreted by the desktop app to select\n * appropriate API to expose into Model and UI runtimes.\n *\n * Flags are split into two categories:\n *   - supports... - those flags tells the desktop app that the block supports certain APIs, but can without them as well\n *   - requires... - those flags tells the desktop app that the block requires certain APIs, and if desktop app doesn't support it, it can't be used in the block\n */\nexport type BlockCodeFeatureFlags = Record<`supports${string}`, boolean | number | undefined> &\n  Record<`requires${string}`, boolean | number | undefined>;\n\n/**\n * Known block flags. Flags are set during model compilation, see `BlockModel.create` for more details and for initial values.\n */\nexport type BlockCodeKnownFeatureFlags = {\n  readonly supportsLazyState?: boolean;\n  readonly requiresModelAPIVersion?: number;\n  readonly requiresUIAPIVersion?: number;\n  readonly requiresCreatePTableV2?: boolean;\n};\n\nexport const AllSupportsFeatureFlags = [\"supportsLazyState\"] as const;\n\nexport const AllRequiresFeatureFlags = [\n  \"requiresUIAPIVersion\",\n  \"requiresCreatePTableV2\",\n  \"requiresModelAPIVersion\",\n] as const;\n\n//\n// Assertions\n//\n\n// This assertion ensures that BlockConfigV3KnownFeatureFlags is a subtype of BlockConfigV3FeatureFlags.\n// It will produce a compile-time error if there's a mismatch.\ntype _KnownFlagsAreValidFlags = Assert<\n  IsSubtypeOf<BlockCodeKnownFeatureFlags, BlockCodeFeatureFlags>\n>;\n\n// This check ensures that all keys in BlockConfigV3FeatureFlags are covered in the arrays above.\n// It will produce a compile-time error if there's a mismatch.\ntype _AllFlagsAreCovered = Assert<\n  Is<\n    keyof BlockCodeKnownFeatureFlags,\n    ArrayTypeUnion<typeof AllRequiresFeatureFlags, typeof AllSupportsFeatureFlags>\n  >\n>;\n"],"names":[],"mappings":";;AAuBO,MAAM,uBAAuB,GAAG,CAAC,mBAAmB;AAEpD,MAAM,uBAAuB,GAAG;IACrC,sBAAsB;IACtB,wBAAwB;IACxB,yBAAyB;;;;;;"}
+{"version":3,"file":"block_flags.cjs","sources":["../../src/flags/block_flags.ts"],"sourcesContent":["import type { ArrayTypeUnion, Assert, Is, IsSubtypeOf } from \"./type_utils\";\n\n/**\n * Block-specific feature flags. Define flags that are interpreted by the desktop app to select\n * appropriate API to expose into Model and UI runtimes.\n *\n * Flags are split into two categories:\n *   - supports... - those flags tells the desktop app that the block supports certain APIs, but can without them as well\n *   - requires... - those flags tells the desktop app that the block requires certain APIs, and if desktop app doesn't support it, it can't be used in the block\n */\nexport type BlockCodeFeatureFlags = Record<`supports${string}`, boolean | number | undefined> &\n  Record<`requires${string}`, boolean | number | undefined>;\n\n/**\n * Known block flags. Flags are set during model compilation, see `BlockModel.create` for more details and for initial values.\n */\nexport type BlockCodeKnownFeatureFlags = {\n  readonly supportsLazyState?: boolean;\n  readonly requiresModelAPIVersion?: number;\n  readonly requiresUIAPIVersion?: number;\n  readonly requiresCreatePTable?: number;\n};\n\nexport const AllSupportsFeatureFlags = [\"supportsLazyState\"] as const;\n\nexport const AllRequiresFeatureFlags = [\n  \"requiresUIAPIVersion\",\n  \"requiresCreatePTable\",\n  \"requiresModelAPIVersion\",\n] as const;\n\n//\n// Assertions\n//\n\n// This assertion ensures that BlockConfigV3KnownFeatureFlags is a subtype of BlockConfigV3FeatureFlags.\n// It will produce a compile-time error if there's a mismatch.\ntype _KnownFlagsAreValidFlags = Assert<\n  IsSubtypeOf<BlockCodeKnownFeatureFlags, BlockCodeFeatureFlags>\n>;\n\n// This check ensures that all keys in BlockConfigV3FeatureFlags are covered in the arrays above.\n// It will produce a compile-time error if there's a mismatch.\ntype _AllFlagsAreCovered = Assert<\n  Is<\n    keyof BlockCodeKnownFeatureFlags,\n    ArrayTypeUnion<typeof AllRequiresFeatureFlags, typeof AllSupportsFeatureFlags>\n  >\n>;\n"],"names":[],"mappings":";;AAuBO,MAAM,uBAAuB,GAAG,CAAC,mBAAmB;AAEpD,MAAM,uBAAuB,GAAG;IACrC,sBAAsB;IACtB,sBAAsB;IACtB,yBAAyB;;;;;;"}

package/dist/flags/block_flags.d.ts

@@ -14,8 +14,8 @@ export type BlockCodeKnownFeatureFlags = {
     readonly supportsLazyState?: boolean;
     readonly requiresModelAPIVersion?: number;
     readonly requiresUIAPIVersion?: number;
-    readonly requiresCreatePTableV2?: boolean;
+    readonly requiresCreatePTable?: number;
 };
 export declare const AllSupportsFeatureFlags: readonly ["supportsLazyState"];
-export declare const AllRequiresFeatureFlags: readonly ["requiresUIAPIVersion", "requiresCreatePTableV2", "requiresModelAPIVersion"];
+export declare const AllRequiresFeatureFlags: readonly ["requiresUIAPIVersion", "requiresCreatePTable", "requiresModelAPIVersion"];
 //# sourceMappingURL=block_flags.d.ts.map

package/dist/flags/block_flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block_flags.d.ts","sourceRoot":"","sources":["../../src/flags/block_flags.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,WAAW,MAAM,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,GAC3F,MAAM,CAAC,WAAW,MAAM,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAC3C,CAAC;AAEF,eAAO,MAAM,uBAAuB,gCAAiC,CAAC;AAEtE,eAAO,MAAM,uBAAuB,wFAI1B,CAAC"}
+{"version":3,"file":"block_flags.d.ts","sourceRoot":"","sources":["../../src/flags/block_flags.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,WAAW,MAAM,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,GAC3F,MAAM,CAAC,WAAW,MAAM,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC,CAAC;AAEF,eAAO,MAAM,uBAAuB,gCAAiC,CAAC;AAEtE,eAAO,MAAM,uBAAuB,sFAI1B,CAAC"}

package/dist/flags/block_flags.js

@@ -1,7 +1,7 @@
 const AllSupportsFeatureFlags = ["supportsLazyState"];
 const AllRequiresFeatureFlags = [
     "requiresUIAPIVersion",
-    "requiresCreatePTableV2",
+    "requiresCreatePTable",
     "requiresModelAPIVersion",
 ];
 

package/dist/flags/block_flags.js.map

@@ -1 +1 @@
-{"version":3,"file":"block_flags.js","sources":["../../src/flags/block_flags.ts"],"sourcesContent":["import type { ArrayTypeUnion, Assert, Is, IsSubtypeOf } from \"./type_utils\";\n\n/**\n * Block-specific feature flags. Define flags that are interpreted by the desktop app to select\n * appropriate API to expose into Model and UI runtimes.\n *\n * Flags are split into two categories:\n *   - supports... - those flags tells the desktop app that the block supports certain APIs, but can without them as well\n *   - requires... - those flags tells the desktop app that the block requires certain APIs, and if desktop app doesn't support it, it can't be used in the block\n */\nexport type BlockCodeFeatureFlags = Record<`supports${string}`, boolean | number | undefined> &\n  Record<`requires${string}`, boolean | number | undefined>;\n\n/**\n * Known block flags. Flags are set during model compilation, see `BlockModel.create` for more details and for initial values.\n */\nexport type BlockCodeKnownFeatureFlags = {\n  readonly supportsLazyState?: boolean;\n  readonly requiresModelAPIVersion?: number;\n  readonly requiresUIAPIVersion?: number;\n  readonly requiresCreatePTableV2?: boolean;\n};\n\nexport const AllSupportsFeatureFlags = [\"supportsLazyState\"] as const;\n\nexport const AllRequiresFeatureFlags = [\n  \"requiresUIAPIVersion\",\n  \"requiresCreatePTableV2\",\n  \"requiresModelAPIVersion\",\n] as const;\n\n//\n// Assertions\n//\n\n// This assertion ensures that BlockConfigV3KnownFeatureFlags is a subtype of BlockConfigV3FeatureFlags.\n// It will produce a compile-time error if there's a mismatch.\ntype _KnownFlagsAreValidFlags = Assert<\n  IsSubtypeOf<BlockCodeKnownFeatureFlags, BlockCodeFeatureFlags>\n>;\n\n// This check ensures that all keys in BlockConfigV3FeatureFlags are covered in the arrays above.\n// It will produce a compile-time error if there's a mismatch.\ntype _AllFlagsAreCovered = Assert<\n  Is<\n    keyof BlockCodeKnownFeatureFlags,\n    ArrayTypeUnion<typeof AllRequiresFeatureFlags, typeof AllSupportsFeatureFlags>\n  >\n>;\n"],"names":[],"mappings":"AAuBO,MAAM,uBAAuB,GAAG,CAAC,mBAAmB;AAEpD,MAAM,uBAAuB,GAAG;IACrC,sBAAsB;IACtB,wBAAwB;IACxB,yBAAyB;;;;;"}
+{"version":3,"file":"block_flags.js","sources":["../../src/flags/block_flags.ts"],"sourcesContent":["import type { ArrayTypeUnion, Assert, Is, IsSubtypeOf } from \"./type_utils\";\n\n/**\n * Block-specific feature flags. Define flags that are interpreted by the desktop app to select\n * appropriate API to expose into Model and UI runtimes.\n *\n * Flags are split into two categories:\n *   - supports... - those flags tells the desktop app that the block supports certain APIs, but can without them as well\n *   - requires... - those flags tells the desktop app that the block requires certain APIs, and if desktop app doesn't support it, it can't be used in the block\n */\nexport type BlockCodeFeatureFlags = Record<`supports${string}`, boolean | number | undefined> &\n  Record<`requires${string}`, boolean | number | undefined>;\n\n/**\n * Known block flags. Flags are set during model compilation, see `BlockModel.create` for more details and for initial values.\n */\nexport type BlockCodeKnownFeatureFlags = {\n  readonly supportsLazyState?: boolean;\n  readonly requiresModelAPIVersion?: number;\n  readonly requiresUIAPIVersion?: number;\n  readonly requiresCreatePTable?: number;\n};\n\nexport const AllSupportsFeatureFlags = [\"supportsLazyState\"] as const;\n\nexport const AllRequiresFeatureFlags = [\n  \"requiresUIAPIVersion\",\n  \"requiresCreatePTable\",\n  \"requiresModelAPIVersion\",\n] as const;\n\n//\n// Assertions\n//\n\n// This assertion ensures that BlockConfigV3KnownFeatureFlags is a subtype of BlockConfigV3FeatureFlags.\n// It will produce a compile-time error if there's a mismatch.\ntype _KnownFlagsAreValidFlags = Assert<\n  IsSubtypeOf<BlockCodeKnownFeatureFlags, BlockCodeFeatureFlags>\n>;\n\n// This check ensures that all keys in BlockConfigV3FeatureFlags are covered in the arrays above.\n// It will produce a compile-time error if there's a mismatch.\ntype _AllFlagsAreCovered = Assert<\n  Is<\n    keyof BlockCodeKnownFeatureFlags,\n    ArrayTypeUnion<typeof AllRequiresFeatureFlags, typeof AllSupportsFeatureFlags>\n  >\n>;\n"],"names":[],"mappings":"AAuBO,MAAM,uBAAuB,GAAG,CAAC,mBAAmB;AAEpD,MAAM,uBAAuB,GAAG;IACrC,sBAAsB;IACtB,sBAAsB;IACtB,yBAAyB;;;;;"}

package/dist/flags/flag_utils.cjs

@@ -29,6 +29,26 @@ function extractAllSupports(flags) {
         .filter(([key, value]) => key.startsWith("supports") && value === true)
         .map(([key]) => key));
 }
+/**
+ * Merges two feature flag objects with type-aware logic:
+ * - `supports*` (boolean): OR — `true` if either side is `true`
+ * - `requires*` (numeric): MAX — take the higher version requirement
+ */
+function mergeFeatureFlags(base, override) {
+    const result = { ...base };
+    for (const [key, value] of Object.entries(override)) {
+        if (value === undefined)
+            continue;
+        const existing = result[key];
+        if (typeof value === "boolean") {
+            result[key] = existing || value;
+        }
+        else if (typeof value === "number") {
+            result[key] = Math.max(existing ?? 0, value);
+        }
+    }
+    return result;
+}
 class IncompatibleFlagsError extends Error {
     incompatibleFlags;
     name = "IncompatibleFlagsError";
@@ -99,4 +119,5 @@ exports.RuntimeCapabilities = RuntimeCapabilities;
 exports.checkBlockFlag = checkBlockFlag;
 exports.extractAllRequirements = extractAllRequirements;
 exports.extractAllSupports = extractAllSupports;
+exports.mergeFeatureFlags = mergeFeatureFlags;
 //# sourceMappingURL=flag_utils.cjs.map

package/dist/flags/flag_utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"flag_utils.cjs","sources":["../../src/flags/flag_utils.ts"],"sourcesContent":["import type { BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags } from \"./block_flags\";\nimport type { FilterKeysByPrefix } from \"./type_utils\";\n\nexport function checkBlockFlag(\n  flags: BlockCodeFeatureFlags | undefined,\n  flag: keyof BlockCodeKnownFeatureFlags,\n  flagValue: boolean | number = true,\n): boolean {\n  if (flags === undefined) return false;\n  return flags[flag] === flagValue;\n}\n\n/**\n * Extracts all requirements from the feature flags.\n * @param flags - The feature flags.\n * @returns A set of requirements.\n */\nexport function extractAllRequirements(\n  flags: BlockCodeFeatureFlags | undefined,\n): Set<`requires${string}`> {\n  if (flags === undefined) return new Set();\n  return new Set(\n    Object.entries(flags)\n      .filter(([key, value]) => key.startsWith(\"requires\") && value === true)\n      .map(([key]) => key as `requires${string}`),\n  );\n}\n\n/**\n * Extracts all supports from the feature flags.\n * @param flags - The feature flags.\n * @returns A set of supports.\n */\nexport function extractAllSupports(\n  flags: BlockCodeFeatureFlags | undefined,\n): Set<`supports${string}`> {\n  if (flags === undefined) return new Set();\n  return new Set(\n    Object.entries(flags)\n      .filter(([key, value]) => key.startsWith(\"supports\") && value === true)\n      .map(([key]) => key as `supports${string}`),\n  );\n}\n\nexport class IncompatibleFlagsError extends Error {\n  name = \"IncompatibleFlagsError\";\n  constructor(public readonly incompatibleFlags: Map<`requires${string}`, number | boolean>) {\n    super(\n      `Some of the block requirements are not supported by the runtime: ${Array.from(\n        incompatibleFlags.entries(),\n      )\n        .map(([key, value]) => `${key}: ${value}`)\n        .join(\", \")}`,\n    );\n  }\n}\n\n/**\n * A type that represents a supported requirement.\n * @remarks\n * This type is used to represent a supported requirement.\n * It is a subtype of `BlockCodeKnownFeatureFlags` and is used to represent a supported requirement.\n * It is used to represent a supported requirement.\n */\nexport type SupportedRequirement = FilterKeysByPrefix<BlockCodeKnownFeatureFlags, \"requires\">;\n\nexport class RuntimeCapabilities {\n  private readonly supportedRequirements: Map<`requires${string}`, Set<number | boolean>> =\n    new Map();\n\n  /**\n   * Adds a supported requirement to the runtime capabilities.\n   * @param requirement - The requirement.\n   * @param value - The value of the requirement. If not provided, defaults to true.\n   */\n  public addSupportedRequirement(\n    requirement: SupportedRequirement,\n    value: number | boolean = true,\n  ): this {\n    if (!this.supportedRequirements.has(requirement)) {\n      this.supportedRequirements.set(requirement, new Set());\n    }\n    this.supportedRequirements.get(requirement)!.add(value);\n    return this;\n  }\n\n  /**\n   * Returns a map of incompatible flags. If the block flags are compatible, returns undefined.\n   * @param blockFlags - The block flags.\n   * @returns A map of incompatible flags, or undefined if the block flags are compatible.\n   */\n  public getIncompatibleFlags(\n    blockFlags: BlockCodeFeatureFlags | undefined,\n  ): Map<`requires${string}`, number | boolean> | undefined {\n    if (blockFlags === undefined) return undefined;\n    const incompatibleFlags = new Map<`requires${string}`, number | boolean>();\n    for (const [key, value] of Object.entries(blockFlags)) {\n      if (key.startsWith(\"requires\")) {\n        if (value === undefined) continue;\n        const supportedValues = this.supportedRequirements.get(key as `requires${string}`);\n        if (supportedValues === undefined || !supportedValues.has(value as number | boolean)) {\n          incompatibleFlags.set(key as `requires${string}`, value as number | boolean);\n        }\n      }\n    }\n    return incompatibleFlags.size === 0 ? undefined : incompatibleFlags;\n  }\n\n  /**\n   * Checks if the block flags are compatible with the runtime capabilities.\n   * @param blockFlags - The block flags.\n   * @returns True if the block flags are compatible, false otherwise.\n   */\n  public checkCompatibility(blockFlags: BlockCodeFeatureFlags | undefined): boolean {\n    return this.getIncompatibleFlags(blockFlags) === undefined;\n  }\n\n  /**\n   * Throws an error if the block flags are incompatible with the runtime capabilities.\n   * @param blockFlags - The block flags.\n   * @throws IncompatibleFlagsError if the block flags are incompatible with the runtime capabilities.\n   */\n  public throwIfIncompatible(blockFlags: BlockCodeFeatureFlags | undefined) {\n    const incompatibleFlags = this.getIncompatibleFlags(blockFlags);\n    if (incompatibleFlags !== undefined) throw new IncompatibleFlagsError(incompatibleFlags);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"flag_utils.cjs","sources":["../../src/flags/flag_utils.ts"],"sourcesContent":["import type { BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags } from \"./block_flags\";\nimport type { FilterKeysByPrefix } from \"./type_utils\";\n\nexport function checkBlockFlag(\n  flags: BlockCodeFeatureFlags | undefined,\n  flag: keyof BlockCodeKnownFeatureFlags,\n  flagValue: boolean | number = true,\n): boolean {\n  if (flags === undefined) return false;\n  return flags[flag] === flagValue;\n}\n\n/**\n * Extracts all requirements from the feature flags.\n * @param flags - The feature flags.\n * @returns A set of requirements.\n */\nexport function extractAllRequirements(\n  flags: BlockCodeFeatureFlags | undefined,\n): Set<`requires${string}`> {\n  if (flags === undefined) return new Set();\n  return new Set(\n    Object.entries(flags)\n      .filter(([key, value]) => key.startsWith(\"requires\") && value === true)\n      .map(([key]) => key as `requires${string}`),\n  );\n}\n\n/**\n * Extracts all supports from the feature flags.\n * @param flags - The feature flags.\n * @returns A set of supports.\n */\nexport function extractAllSupports(\n  flags: BlockCodeFeatureFlags | undefined,\n): Set<`supports${string}`> {\n  if (flags === undefined) return new Set();\n  return new Set(\n    Object.entries(flags)\n      .filter(([key, value]) => key.startsWith(\"supports\") && value === true)\n      .map(([key]) => key as `supports${string}`),\n  );\n}\n\n/**\n * Merges two feature flag objects with type-aware logic:\n * - `supports*` (boolean): OR — `true` if either side is `true`\n * - `requires*` (numeric): MAX — take the higher version requirement\n */\nexport function mergeFeatureFlags(\n  base: BlockCodeKnownFeatureFlags,\n  override: BlockCodeKnownFeatureFlags,\n): BlockCodeKnownFeatureFlags {\n  const result: Record<string, boolean | number | undefined> = { ...base };\n  for (const [key, value] of Object.entries(override)) {\n    if (value === undefined) continue;\n    const existing = result[key];\n    if (typeof value === \"boolean\") {\n      result[key] = (existing as boolean | undefined) || value;\n    } else if (typeof value === \"number\") {\n      result[key] = Math.max((existing as number) ?? 0, value);\n    }\n  }\n  return result as BlockCodeKnownFeatureFlags;\n}\n\nexport class IncompatibleFlagsError extends Error {\n  name = \"IncompatibleFlagsError\";\n  constructor(public readonly incompatibleFlags: Map<`requires${string}`, number | boolean>) {\n    super(\n      `Some of the block requirements are not supported by the runtime: ${Array.from(\n        incompatibleFlags.entries(),\n      )\n        .map(([key, value]) => `${key}: ${value}`)\n        .join(\", \")}`,\n    );\n  }\n}\n\n/**\n * A type that represents a supported requirement.\n * @remarks\n * This type is used to represent a supported requirement.\n * It is a subtype of `BlockCodeKnownFeatureFlags` and is used to represent a supported requirement.\n * It is used to represent a supported requirement.\n */\nexport type SupportedRequirement = FilterKeysByPrefix<BlockCodeKnownFeatureFlags, \"requires\">;\n\nexport class RuntimeCapabilities {\n  private readonly supportedRequirements: Map<`requires${string}`, Set<number | boolean>> =\n    new Map();\n\n  /**\n   * Adds a supported requirement to the runtime capabilities.\n   * @param requirement - The requirement.\n   * @param value - The value of the requirement. If not provided, defaults to true.\n   */\n  public addSupportedRequirement(\n    requirement: SupportedRequirement,\n    value: number | boolean = true,\n  ): this {\n    if (!this.supportedRequirements.has(requirement)) {\n      this.supportedRequirements.set(requirement, new Set());\n    }\n    this.supportedRequirements.get(requirement)!.add(value);\n    return this;\n  }\n\n  /**\n   * Returns a map of incompatible flags. If the block flags are compatible, returns undefined.\n   * @param blockFlags - The block flags.\n   * @returns A map of incompatible flags, or undefined if the block flags are compatible.\n   */\n  public getIncompatibleFlags(\n    blockFlags: BlockCodeFeatureFlags | undefined,\n  ): Map<`requires${string}`, number | boolean> | undefined {\n    if (blockFlags === undefined) return undefined;\n    const incompatibleFlags = new Map<`requires${string}`, number | boolean>();\n    for (const [key, value] of Object.entries(blockFlags)) {\n      if (key.startsWith(\"requires\")) {\n        if (value === undefined) continue;\n        const supportedValues = this.supportedRequirements.get(key as `requires${string}`);\n        if (supportedValues === undefined || !supportedValues.has(value as number | boolean)) {\n          incompatibleFlags.set(key as `requires${string}`, value as number | boolean);\n        }\n      }\n    }\n    return incompatibleFlags.size === 0 ? undefined : incompatibleFlags;\n  }\n\n  /**\n   * Checks if the block flags are compatible with the runtime capabilities.\n   * @param blockFlags - The block flags.\n   * @returns True if the block flags are compatible, false otherwise.\n   */\n  public checkCompatibility(blockFlags: BlockCodeFeatureFlags | undefined): boolean {\n    return this.getIncompatibleFlags(blockFlags) === undefined;\n  }\n\n  /**\n   * Throws an error if the block flags are incompatible with the runtime capabilities.\n   * @param blockFlags - The block flags.\n   * @throws IncompatibleFlagsError if the block flags are incompatible with the runtime capabilities.\n   */\n  public throwIfIncompatible(blockFlags: BlockCodeFeatureFlags | undefined) {\n    const incompatibleFlags = this.getIncompatibleFlags(blockFlags);\n    if (incompatibleFlags !== undefined) throw new IncompatibleFlagsError(incompatibleFlags);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/flags/flag_utils.d.ts

@@ -13,6 +13,12 @@ export declare function extractAllRequirements(flags: BlockCodeFeatureFlags | un
  * @returns A set of supports.
  */
 export declare function extractAllSupports(flags: BlockCodeFeatureFlags | undefined): Set<`supports${string}`>;
+/**
+ * Merges two feature flag objects with type-aware logic:
+ * - `supports*` (boolean): OR — `true` if either side is `true`
+ * - `requires*` (numeric): MAX — take the higher version requirement
+ */
+export declare function mergeFeatureFlags(base: BlockCodeKnownFeatureFlags, override: BlockCodeKnownFeatureFlags): BlockCodeKnownFeatureFlags;
 export declare class IncompatibleFlagsError extends Error {
     readonly incompatibleFlags: Map<`requires${string}`, number | boolean>;
     name: string;

package/dist/flags/flag_utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flag_utils.d.ts","sourceRoot":"","sources":["../../src/flags/flag_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,qBAAqB,GAAG,SAAS,EACxC,IAAI,EAAE,MAAM,0BAA0B,EACtC,SAAS,GAAE,OAAO,GAAG,MAAa,GACjC,OAAO,CAGT;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,qBAAqB,GAAG,SAAS,GACvC,GAAG,CAAC,WAAW,MAAM,EAAE,CAAC,CAO1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,qBAAqB,GAAG,SAAS,GACvC,GAAG,CAAC,WAAW,MAAM,EAAE,CAAC,CAO1B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;aAEnB,iBAAiB,EAAE,GAAG,CAAC,WAAW,MAAM,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IADzF,IAAI,SAA4B;gBACJ,iBAAiB,EAAE,GAAG,CAAC,WAAW,MAAM,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAS1F;AAED;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAC;AAE9F,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAC1B;IAEZ;;;;OAIG;IACI,uBAAuB,CAC5B,WAAW,EAAE,oBAAoB,EACjC,KAAK,GAAE,MAAM,GAAG,OAAc,GAC7B,IAAI;IAQP;;;;OAIG;IACI,oBAAoB,CACzB,UAAU,EAAE,qBAAqB,GAAG,SAAS,GAC5C,GAAG,CAAC,WAAW,MAAM,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS;IAezD;;;;OAIG;IACI,kBAAkB,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,GAAG,OAAO;IAIjF;;;;OAIG;IACI,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS;CAIzE"}
+{"version":3,"file":"flag_utils.d.ts","sourceRoot":"","sources":["../../src/flags/flag_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,qBAAqB,GAAG,SAAS,EACxC,IAAI,EAAE,MAAM,0BAA0B,EACtC,SAAS,GAAE,OAAO,GAAG,MAAa,GACjC,OAAO,CAGT;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,qBAAqB,GAAG,SAAS,GACvC,GAAG,CAAC,WAAW,MAAM,EAAE,CAAC,CAO1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,qBAAqB,GAAG,SAAS,GACvC,GAAG,CAAC,WAAW,MAAM,EAAE,CAAC,CAO1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,0BAA0B,EAChC,QAAQ,EAAE,0BAA0B,GACnC,0BAA0B,CAY5B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;aAEnB,iBAAiB,EAAE,GAAG,CAAC,WAAW,MAAM,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IADzF,IAAI,SAA4B;gBACJ,iBAAiB,EAAE,GAAG,CAAC,WAAW,MAAM,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAS1F;AAED;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAC;AAE9F,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAC1B;IAEZ;;;;OAIG;IACI,uBAAuB,CAC5B,WAAW,EAAE,oBAAoB,EACjC,KAAK,GAAE,MAAM,GAAG,OAAc,GAC7B,IAAI;IAQP;;;;OAIG;IACI,oBAAoB,CACzB,UAAU,EAAE,qBAAqB,GAAG,SAAS,GAC5C,GAAG,CAAC,WAAW,MAAM,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS;IAezD;;;;OAIG;IACI,kBAAkB,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,GAAG,OAAO;IAIjF;;;;OAIG;IACI,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS;CAIzE"}

package/dist/flags/flag_utils.js

@@ -27,6 +27,26 @@ function extractAllSupports(flags) {
         .filter(([key, value]) => key.startsWith("supports") && value === true)
         .map(([key]) => key));
 }
+/**
+ * Merges two feature flag objects with type-aware logic:
+ * - `supports*` (boolean): OR — `true` if either side is `true`
+ * - `requires*` (numeric): MAX — take the higher version requirement
+ */
+function mergeFeatureFlags(base, override) {
+    const result = { ...base };
+    for (const [key, value] of Object.entries(override)) {
+        if (value === undefined)
+            continue;
+        const existing = result[key];
+        if (typeof value === "boolean") {
+            result[key] = existing || value;
+        }
+        else if (typeof value === "number") {
+            result[key] = Math.max(existing ?? 0, value);
+        }
+    }
+    return result;
+}
 class IncompatibleFlagsError extends Error {
     incompatibleFlags;
     name = "IncompatibleFlagsError";
@@ -92,5 +112,5 @@ class RuntimeCapabilities {
     }
 }
 
-export { IncompatibleFlagsError, RuntimeCapabilities, checkBlockFlag, extractAllRequirements, extractAllSupports };
+export { IncompatibleFlagsError, RuntimeCapabilities, checkBlockFlag, extractAllRequirements, extractAllSupports, mergeFeatureFlags };
 //# sourceMappingURL=flag_utils.js.map

package/dist/flags/flag_utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"flag_utils.js","sources":["../../src/flags/flag_utils.ts"],"sourcesContent":["import type { BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags } from \"./block_flags\";\nimport type { FilterKeysByPrefix } from \"./type_utils\";\n\nexport function checkBlockFlag(\n  flags: BlockCodeFeatureFlags | undefined,\n  flag: keyof BlockCodeKnownFeatureFlags,\n  flagValue: boolean | number = true,\n): boolean {\n  if (flags === undefined) return false;\n  return flags[flag] === flagValue;\n}\n\n/**\n * Extracts all requirements from the feature flags.\n * @param flags - The feature flags.\n * @returns A set of requirements.\n */\nexport function extractAllRequirements(\n  flags: BlockCodeFeatureFlags | undefined,\n): Set<`requires${string}`> {\n  if (flags === undefined) return new Set();\n  return new Set(\n    Object.entries(flags)\n      .filter(([key, value]) => key.startsWith(\"requires\") && value === true)\n      .map(([key]) => key as `requires${string}`),\n  );\n}\n\n/**\n * Extracts all supports from the feature flags.\n * @param flags - The feature flags.\n * @returns A set of supports.\n */\nexport function extractAllSupports(\n  flags: BlockCodeFeatureFlags | undefined,\n): Set<`supports${string}`> {\n  if (flags === undefined) return new Set();\n  return new Set(\n    Object.entries(flags)\n      .filter(([key, value]) => key.startsWith(\"supports\") && value === true)\n      .map(([key]) => key as `supports${string}`),\n  );\n}\n\nexport class IncompatibleFlagsError extends Error {\n  name = \"IncompatibleFlagsError\";\n  constructor(public readonly incompatibleFlags: Map<`requires${string}`, number | boolean>) {\n    super(\n      `Some of the block requirements are not supported by the runtime: ${Array.from(\n        incompatibleFlags.entries(),\n      )\n        .map(([key, value]) => `${key}: ${value}`)\n        .join(\", \")}`,\n    );\n  }\n}\n\n/**\n * A type that represents a supported requirement.\n * @remarks\n * This type is used to represent a supported requirement.\n * It is a subtype of `BlockCodeKnownFeatureFlags` and is used to represent a supported requirement.\n * It is used to represent a supported requirement.\n */\nexport type SupportedRequirement = FilterKeysByPrefix<BlockCodeKnownFeatureFlags, \"requires\">;\n\nexport class RuntimeCapabilities {\n  private readonly supportedRequirements: Map<`requires${string}`, Set<number | boolean>> =\n    new Map();\n\n  /**\n   * Adds a supported requirement to the runtime capabilities.\n   * @param requirement - The requirement.\n   * @param value - The value of the requirement. If not provided, defaults to true.\n   */\n  public addSupportedRequirement(\n    requirement: SupportedRequirement,\n    value: number | boolean = true,\n  ): this {\n    if (!this.supportedRequirements.has(requirement)) {\n      this.supportedRequirements.set(requirement, new Set());\n    }\n    this.supportedRequirements.get(requirement)!.add(value);\n    return this;\n  }\n\n  /**\n   * Returns a map of incompatible flags. If the block flags are compatible, returns undefined.\n   * @param blockFlags - The block flags.\n   * @returns A map of incompatible flags, or undefined if the block flags are compatible.\n   */\n  public getIncompatibleFlags(\n    blockFlags: BlockCodeFeatureFlags | undefined,\n  ): Map<`requires${string}`, number | boolean> | undefined {\n    if (blockFlags === undefined) return undefined;\n    const incompatibleFlags = new Map<`requires${string}`, number | boolean>();\n    for (const [key, value] of Object.entries(blockFlags)) {\n      if (key.startsWith(\"requires\")) {\n        if (value === undefined) continue;\n        const supportedValues = this.supportedRequirements.get(key as `requires${string}`);\n        if (supportedValues === undefined || !supportedValues.has(value as number | boolean)) {\n          incompatibleFlags.set(key as `requires${string}`, value as number | boolean);\n        }\n      }\n    }\n    return incompatibleFlags.size === 0 ? undefined : incompatibleFlags;\n  }\n\n  /**\n   * Checks if the block flags are compatible with the runtime capabilities.\n   * @param blockFlags - The block flags.\n   * @returns True if the block flags are compatible, false otherwise.\n   */\n  public checkCompatibility(blockFlags: BlockCodeFeatureFlags | undefined): boolean {\n    return this.getIncompatibleFlags(blockFlags) === undefined;\n  }\n\n  /**\n   * Throws an error if the block flags are incompatible with the runtime capabilities.\n   * @param blockFlags - The block flags.\n   * @throws IncompatibleFlagsError if the block flags are incompatible with the runtime capabilities.\n   */\n  public throwIfIncompatible(blockFlags: BlockCodeFeatureFlags | undefined) {\n    const incompatibleFlags = this.getIncompatibleFlags(blockFlags);\n    if (incompatibleFlags !== undefined) throw new IncompatibleFlagsError(incompatibleFlags);\n  }\n}\n"],"names":[],"mappings":"AAGM,SAAU,cAAc,CAC5B,KAAwC,EACxC,IAAsC,EACtC,YAA8B,IAAI,EAAA;IAElC,IAAI,KAAK,KAAK,SAAS;AAAE,QAAA,OAAO,KAAK;AACrC,IAAA,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS;AAClC;AAEA;;;;AAIG;AACG,SAAU,sBAAsB,CACpC,KAAwC,EAAA;IAExC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,GAAG,EAAE;IACzC,OAAO,IAAI,GAAG,CACZ,MAAM,CAAC,OAAO,CAAC,KAAK;SACjB,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,KAAK,KAAK,IAAI;SACrE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAA0B,CAAC,CAC9C;AACH;AAEA;;;;AAIG;AACG,SAAU,kBAAkB,CAChC,KAAwC,EAAA;IAExC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,GAAG,EAAE;IACzC,OAAO,IAAI,GAAG,CACZ,MAAM,CAAC,OAAO,CAAC,KAAK;SACjB,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,KAAK,KAAK,IAAI;SACrE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAA0B,CAAC,CAC9C;AACH;AAEM,MAAO,sBAAuB,SAAQ,KAAK,CAAA;AAEnB,IAAA,iBAAA;IAD5B,IAAI,GAAG,wBAAwB;AAC/B,IAAA,WAAA,CAA4B,iBAA6D,EAAA;QACvF,KAAK,CACH,CAAA,iEAAA,EAAoE,KAAK,CAAC,IAAI,CAC5E,iBAAiB,CAAC,OAAO,EAAE;AAE1B,aAAA,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAA,EAAG,GAAG,CAAA,EAAA,EAAK,KAAK,EAAE;AACxC,aAAA,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CAChB;QAPyB,IAAA,CAAA,iBAAiB,GAAjB,iBAAiB;IAQ7C;AACD;MAWY,mBAAmB,CAAA;AACb,IAAA,qBAAqB,GACpC,IAAI,GAAG,EAAE;AAEX;;;;AAIG;AACI,IAAA,uBAAuB,CAC5B,WAAiC,EACjC,KAAA,GAA0B,IAAI,EAAA;QAE9B,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;YAChD,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,EAAE,CAAC;QACxD;AACA,QAAA,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC,GAAG,CAAC,KAAK,CAAC;AACvD,QAAA,OAAO,IAAI;IACb;AAEA;;;;AAIG;AACI,IAAA,oBAAoB,CACzB,UAA6C,EAAA;QAE7C,IAAI,UAAU,KAAK,SAAS;AAAE,YAAA,OAAO,SAAS;AAC9C,QAAA,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAyC;AAC1E,QAAA,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;AACrD,YAAA,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;gBAC9B,IAAI,KAAK,KAAK,SAAS;oBAAE;gBACzB,MAAM,eAAe,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,GAA0B,CAAC;AAClF,gBAAA,IAAI,eAAe,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAyB,CAAC,EAAE;AACpF,oBAAA,iBAAiB,CAAC,GAAG,CAAC,GAA0B,EAAE,KAAyB,CAAC;gBAC9E;YACF;QACF;AACA,QAAA,OAAO,iBAAiB,CAAC,IAAI,KAAK,CAAC,GAAG,SAAS,GAAG,iBAAiB;IACrE;AAEA;;;;AAIG;AACI,IAAA,kBAAkB,CAAC,UAA6C,EAAA;QACrE,OAAO,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,KAAK,SAAS;IAC5D;AAEA;;;;AAIG;AACI,IAAA,mBAAmB,CAAC,UAA6C,EAAA;QACtE,MAAM,iBAAiB,GAAG,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC;QAC/D,IAAI,iBAAiB,KAAK,SAAS;AAAE,YAAA,MAAM,IAAI,sBAAsB,CAAC,iBAAiB,CAAC;IAC1F;AACD;;;;"}
+{"version":3,"file":"flag_utils.js","sources":["../../src/flags/flag_utils.ts"],"sourcesContent":["import type { BlockCodeFeatureFlags, BlockCodeKnownFeatureFlags } from \"./block_flags\";\nimport type { FilterKeysByPrefix } from \"./type_utils\";\n\nexport function checkBlockFlag(\n  flags: BlockCodeFeatureFlags | undefined,\n  flag: keyof BlockCodeKnownFeatureFlags,\n  flagValue: boolean | number = true,\n): boolean {\n  if (flags === undefined) return false;\n  return flags[flag] === flagValue;\n}\n\n/**\n * Extracts all requirements from the feature flags.\n * @param flags - The feature flags.\n * @returns A set of requirements.\n */\nexport function extractAllRequirements(\n  flags: BlockCodeFeatureFlags | undefined,\n): Set<`requires${string}`> {\n  if (flags === undefined) return new Set();\n  return new Set(\n    Object.entries(flags)\n      .filter(([key, value]) => key.startsWith(\"requires\") && value === true)\n      .map(([key]) => key as `requires${string}`),\n  );\n}\n\n/**\n * Extracts all supports from the feature flags.\n * @param flags - The feature flags.\n * @returns A set of supports.\n */\nexport function extractAllSupports(\n  flags: BlockCodeFeatureFlags | undefined,\n): Set<`supports${string}`> {\n  if (flags === undefined) return new Set();\n  return new Set(\n    Object.entries(flags)\n      .filter(([key, value]) => key.startsWith(\"supports\") && value === true)\n      .map(([key]) => key as `supports${string}`),\n  );\n}\n\n/**\n * Merges two feature flag objects with type-aware logic:\n * - `supports*` (boolean): OR — `true` if either side is `true`\n * - `requires*` (numeric): MAX — take the higher version requirement\n */\nexport function mergeFeatureFlags(\n  base: BlockCodeKnownFeatureFlags,\n  override: BlockCodeKnownFeatureFlags,\n): BlockCodeKnownFeatureFlags {\n  const result: Record<string, boolean | number | undefined> = { ...base };\n  for (const [key, value] of Object.entries(override)) {\n    if (value === undefined) continue;\n    const existing = result[key];\n    if (typeof value === \"boolean\") {\n      result[key] = (existing as boolean | undefined) || value;\n    } else if (typeof value === \"number\") {\n      result[key] = Math.max((existing as number) ?? 0, value);\n    }\n  }\n  return result as BlockCodeKnownFeatureFlags;\n}\n\nexport class IncompatibleFlagsError extends Error {\n  name = \"IncompatibleFlagsError\";\n  constructor(public readonly incompatibleFlags: Map<`requires${string}`, number | boolean>) {\n    super(\n      `Some of the block requirements are not supported by the runtime: ${Array.from(\n        incompatibleFlags.entries(),\n      )\n        .map(([key, value]) => `${key}: ${value}`)\n        .join(\", \")}`,\n    );\n  }\n}\n\n/**\n * A type that represents a supported requirement.\n * @remarks\n * This type is used to represent a supported requirement.\n * It is a subtype of `BlockCodeKnownFeatureFlags` and is used to represent a supported requirement.\n * It is used to represent a supported requirement.\n */\nexport type SupportedRequirement = FilterKeysByPrefix<BlockCodeKnownFeatureFlags, \"requires\">;\n\nexport class RuntimeCapabilities {\n  private readonly supportedRequirements: Map<`requires${string}`, Set<number | boolean>> =\n    new Map();\n\n  /**\n   * Adds a supported requirement to the runtime capabilities.\n   * @param requirement - The requirement.\n   * @param value - The value of the requirement. If not provided, defaults to true.\n   */\n  public addSupportedRequirement(\n    requirement: SupportedRequirement,\n    value: number | boolean = true,\n  ): this {\n    if (!this.supportedRequirements.has(requirement)) {\n      this.supportedRequirements.set(requirement, new Set());\n    }\n    this.supportedRequirements.get(requirement)!.add(value);\n    return this;\n  }\n\n  /**\n   * Returns a map of incompatible flags. If the block flags are compatible, returns undefined.\n   * @param blockFlags - The block flags.\n   * @returns A map of incompatible flags, or undefined if the block flags are compatible.\n   */\n  public getIncompatibleFlags(\n    blockFlags: BlockCodeFeatureFlags | undefined,\n  ): Map<`requires${string}`, number | boolean> | undefined {\n    if (blockFlags === undefined) return undefined;\n    const incompatibleFlags = new Map<`requires${string}`, number | boolean>();\n    for (const [key, value] of Object.entries(blockFlags)) {\n      if (key.startsWith(\"requires\")) {\n        if (value === undefined) continue;\n        const supportedValues = this.supportedRequirements.get(key as `requires${string}`);\n        if (supportedValues === undefined || !supportedValues.has(value as number | boolean)) {\n          incompatibleFlags.set(key as `requires${string}`, value as number | boolean);\n        }\n      }\n    }\n    return incompatibleFlags.size === 0 ? undefined : incompatibleFlags;\n  }\n\n  /**\n   * Checks if the block flags are compatible with the runtime capabilities.\n   * @param blockFlags - The block flags.\n   * @returns True if the block flags are compatible, false otherwise.\n   */\n  public checkCompatibility(blockFlags: BlockCodeFeatureFlags | undefined): boolean {\n    return this.getIncompatibleFlags(blockFlags) === undefined;\n  }\n\n  /**\n   * Throws an error if the block flags are incompatible with the runtime capabilities.\n   * @param blockFlags - The block flags.\n   * @throws IncompatibleFlagsError if the block flags are incompatible with the runtime capabilities.\n   */\n  public throwIfIncompatible(blockFlags: BlockCodeFeatureFlags | undefined) {\n    const incompatibleFlags = this.getIncompatibleFlags(blockFlags);\n    if (incompatibleFlags !== undefined) throw new IncompatibleFlagsError(incompatibleFlags);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -145,6 +145,7 @@ exports.RuntimeCapabilities = flag_utils.RuntimeCapabilities;
 exports.checkBlockFlag = flag_utils.checkBlockFlag;
 exports.extractAllRequirements = flag_utils.extractAllRequirements;
 exports.extractAllSupports = flag_utils.extractAllSupports;
+exports.mergeFeatureFlags = flag_utils.mergeFeatureFlags;
 exports.bigintReplacer = json.bigintReplacer;
 exports.canonicalizeJson = json.canonicalizeJson;
 exports.parseJson = json.parseJson;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.js

@@ -20,7 +20,7 @@ export { LinkerMap } from './drivers/pframe/linker_columns.js';
 export { ChunkedStreamReader } from './drivers/ChunkedStreamReader.js';
 export { AbortError, PFrameDriverError, PFrameError, UiError, deserializeError, deserializeResult, ensureError, hasAbortError, isAbortError, isAggregateError, isPFrameDriverError, isPFrameError, serializeError, serializeResult, unwrapResult, wrapAndSerialize, wrapAndSerializeAsync, wrapAsyncCallback, wrapCallback } from './errors.js';
 export { AllRequiresFeatureFlags, AllSupportsFeatureFlags } from './flags/block_flags.js';
-export { IncompatibleFlagsError, RuntimeCapabilities, checkBlockFlag, extractAllRequirements, extractAllSupports } from './flags/flag_utils.js';
+export { IncompatibleFlagsError, RuntimeCapabilities, checkBlockFlag, extractAllRequirements, extractAllSupports, mergeFeatureFlags } from './flags/flag_utils.js';
 export { bigintReplacer, canonicalizeJson, parseJson, stringifyJson } from './json.js';
 export { DefaultNavigationState } from './navigation.js';
 export { PlId, PlIdBytes, PlIdLength, digestPlId, plId, uniquePlId } from './plid.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-model-common",
-  "version": "1.24.11",
+  "version": "1.25.1",
   "description": "Platforma SDK Model",
   "files": [
     "./dist/**/*",
@@ -22,12 +22,12 @@
     "@milaboratories/pl-error-like": "1.12.8"
   },
   "devDependencies": {
-    "@vitest/coverage-istanbul": "^4.0.16",
+    "@vitest/coverage-istanbul": "^4.0.18",
     "typescript": "~5.6.3",
-    "vitest": "^4.0.16",
-    "@milaboratories/build-configs": "1.4.4",
-    "@milaboratories/ts-builder": "1.2.10",
-    "@milaboratories/ts-configs": "1.2.1"
+    "vitest": "^4.0.18",
+    "@milaboratories/ts-builder": "1.2.11",
+    "@milaboratories/ts-configs": "1.2.1",
+    "@milaboratories/build-configs": "1.5.0"
   },
   "scripts": {
     "build": "ts-builder build --target node",

package/src/block_state.ts

@@ -1,6 +1,7 @@
 import type { BlockOutputsBase } from "./common_types";
 import type { NavigationState } from "./navigation";
 import type { AuthorMarker } from "./author_marker";
+import { StringifiedJson } from "./json";
 
 /**
  * @template Args    sets type of block arguments passed to the workflow
@@ -33,12 +34,12 @@ export type BlockState<
 };
 
 export type BlockStateV3<
-  Outputs extends BlockOutputsBase = BlockOutputsBase,
   _Data = unknown,
+  Outputs extends BlockOutputsBase = BlockOutputsBase,
   Href extends `/${string}` = `/${string}`,
 > = {
   /** Block storage persisted in the block state */
-  blockStorage: unknown;
+  blockStorage: StringifiedJson;
 
   /** Outputs rendered with block config */
   outputs: Outputs;

package/src/bmodel/block_config.ts

@@ -4,16 +4,6 @@ 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
@@ -39,19 +29,6 @@ export type BlockConfigV4Generic<
   /** 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;
 
@@ -73,18 +50,14 @@ export type BlockConfigV4Generic<
   /** 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;
+
+  /** Facade callbacks supported by this block (for pre-execution validation) */
+  readonly blockLifecycleCallbacks: Record<string, NarrowActiveHandleDescriptor>;
 };
 
 /**

package/src/bmodel/normalization.ts

@@ -19,33 +19,31 @@ export function extractConfigGeneric(cfg: BlockConfigContainer): BlockConfigGene
   if (cfg.v4 !== undefined) {
     // version 4 (BlockModelV3) - inputsValid is derived from args() success/failure
     const {
-      args,
-      prerunArgs,
-      initialData,
       outputs,
       renderingMode,
       sdkVersion,
       featureFlags,
       sections,
       title,
+      subtitle,
+      tags,
       enrichmentTargets,
-      migrations,
+      blockLifecycleCallbacks = {},
     } = cfg.v4;
     const { code } = cfg;
     return {
       configVersion: 4,
       modelAPIVersion: 2,
-      args,
-      prerunArgs,
-      initialData,
       outputs,
       renderingMode,
       sdkVersion,
       featureFlags,
       sections,
       title,
+      subtitle,
+      tags,
       enrichmentTargets,
-      migrations,
+      blockLifecycleCallbacks,
       code,
     };
   } else if (cfg.v3 !== undefined) {

package/src/flags/block_flags.ts

@@ -18,14 +18,14 @@ export type BlockCodeKnownFeatureFlags = {
   readonly supportsLazyState?: boolean;
   readonly requiresModelAPIVersion?: number;
   readonly requiresUIAPIVersion?: number;
-  readonly requiresCreatePTableV2?: boolean;
+  readonly requiresCreatePTable?: number;
 };
 
 export const AllSupportsFeatureFlags = ["supportsLazyState"] as const;
 
 export const AllRequiresFeatureFlags = [
   "requiresUIAPIVersion",
-  "requiresCreatePTableV2",
+  "requiresCreatePTable",
   "requiresModelAPIVersion",
 ] as const;
 

package/src/flags/flag_utils.ts

@@ -42,6 +42,28 @@ export function extractAllSupports(
   );
 }
 
+/**
+ * Merges two feature flag objects with type-aware logic:
+ * - `supports*` (boolean): OR — `true` if either side is `true`
+ * - `requires*` (numeric): MAX — take the higher version requirement
+ */
+export function mergeFeatureFlags(
+  base: BlockCodeKnownFeatureFlags,
+  override: BlockCodeKnownFeatureFlags,
+): BlockCodeKnownFeatureFlags {
+  const result: Record<string, boolean | number | undefined> = { ...base };
+  for (const [key, value] of Object.entries(override)) {
+    if (value === undefined) continue;
+    const existing = result[key];
+    if (typeof value === "boolean") {
+      result[key] = (existing as boolean | undefined) || value;
+    } else if (typeof value === "number") {
+      result[key] = Math.max((existing as number) ?? 0, value);
+    }
+  }
+  return result as BlockCodeKnownFeatureFlags;
+}
+
 export class IncompatibleFlagsError extends Error {
   name = "IncompatibleFlagsError";
   constructor(public readonly incompatibleFlags: Map<`requires${string}`, number | boolean>) {