@platforma-sdk/model 1.58.0 → 1.58.1

package/dist/block_migrations.js

@@ -1,7 +1,16 @@
+import { DATA_MODEL_LEGACY_VERSION } from './block_storage.js';
+
 /** Create a DataVersioned wrapper with correct shape */
 function makeDataVersioned(version, data) {
     return { version, data };
 }
+/** Thrown when a migration step fails. */
+class DataMigrationError extends Error {
+    name = "DataMigrationError";
+    constructor(message) {
+        super(message);
+    }
+}
 /** Thrown by recover() to signal unrecoverable data. */
 class DataUnrecoverableError extends Error {
     name = "DataUnrecoverableError";
@@ -91,19 +100,16 @@ class MigrationChainBase {
 class DataModelMigrationChainWithRecover extends MigrationChainBase {
     recoverFn;
     recoverFromIndex;
-    upgradeLegacyFn;
     /** @internal */
     constructor(state) {
         super(state);
         this.recoverFn = state.recoverFn;
         this.recoverFromIndex = state.recoverFromIndex;
-        this.upgradeLegacyFn = state.upgradeLegacyFn;
     }
     recoverState() {
         return {
             recoverFn: this.recoverFn,
             recoverFromIndex: this.recoverFromIndex,
-            upgradeLegacyFn: this.upgradeLegacyFn,
         };
     }
     /**
@@ -117,7 +123,6 @@ class DataModelMigrationChainWithRecover extends MigrationChainBase {
             steps,
             recoverFn: this.recoverFn,
             recoverFromIndex: this.recoverFromIndex,
-            upgradeLegacyFn: this.upgradeLegacyFn,
         });
     }
 }
@@ -158,10 +163,9 @@ class DataModelMigrationChain extends MigrationChainBase {
      * steps added after recover() will then run on the recovered data.
      *
      * Can only be called once — the returned chain has no recover() method.
-     * Mutually exclusive with upgradeLegacy().
      *
      * @param fn - Recovery function returning Current (the type at this chain position)
-     * @returns Builder with migrate() and init() but without recover() or upgradeLegacy()
+     * @returns Builder with migrate() and init() but without recover()
      *
      * @example
      * // Recover between migrations — recovered data goes through v3 migration
@@ -182,18 +186,27 @@ class DataModelMigrationChain extends MigrationChainBase {
             recoverFromIndex: this.migrationSteps.length,
         });
     }
+}
+/**
+ * Initial migration chain returned by `.from()`.
+ * Extends DataModelMigrationChain with `upgradeLegacy()` — available only before
+ * any `.migrate()` calls, since legacy data always arrives at the initial version.
+ *
+ * @typeParam Current - Data type at the initial version
+ * @internal
+ */
+class DataModelInitialChain extends DataModelMigrationChain {
     /**
      * Handle legacy V1 model state ({ args, uiState }) when upgrading a block from
      * BlockModel V1 to BlockModelV3.
      *
-     * When a V1 block is upgraded, its stored state `{ args, uiState }` arrives at the
-     * initial version (DATA_MODEL_DEFAULT_VERSION) in the migration chain. This method
-     * detects the legacy shape and transforms it to the current chain type using the
-     * provided typed callback. Non-legacy data passes through unchanged.
+     * When a V1 block is upgraded, its stored state `{ args, uiState }` is normalized
+     * to the internal default version. This method inserts a migration step from that
+     * internal version to the version specified in `.from()`, using the provided typed
+     * callback to transform the legacy shape. Non-legacy data passes through unchanged.
      *
-     * Should be called right after `.from()` (before any `.migrate()` calls), since legacy
-     * data always arrives at the initial version. Any `.migrate()` steps added after
-     * `upgradeLegacy()` will run on the transformed result.
+     * Must be called right after `.from()` — not available after `.migrate()` calls.
+     * Any `.migrate()` steps added after `upgradeLegacy()` will run on the transformed result.
      *
      * Can only be called once — the returned chain has no upgradeLegacy() method.
      * Mutually exclusive with recover().
@@ -209,7 +222,7 @@ class DataModelMigrationChain extends MigrationChainBase {
      * type BlockData = { inputFile: string; threshold: number; selectedTab: string };
      *
      * const dataModel = new DataModelBuilder()
-     *   .from<BlockData>(DATA_MODEL_DEFAULT_VERSION)
+     *   .from<BlockData>("v1")
      *   .upgradeLegacy<OldArgs, OldUiState>(({ args, uiState }) => ({
      *     inputFile: args.inputFile,
      *     threshold: args.threshold,
@@ -224,10 +237,17 @@ class DataModelMigrationChain extends MigrationChainBase {
             }
             return data;
         };
+        // Insert DATA_MODEL_LEGACY_VERSION as the true first version
+        // with a migration step that transforms legacy data to the user's initial version.
+        const initialVersion = this.versionChain[0];
+        const step = {
+            fromVersion: DATA_MODEL_LEGACY_VERSION,
+            toVersion: initialVersion,
+            migrate: wrappedFn,
+        };
         return new DataModelMigrationChainWithRecover({
-            versionChain: this.versionChain,
-            steps: this.migrationSteps,
-            upgradeLegacyFn: wrappedFn,
+            versionChain: [DATA_MODEL_LEGACY_VERSION, ...this.versionChain],
+            steps: [step, ...this.migrationSteps],
         });
     }
 }
@@ -237,13 +257,13 @@ class DataModelMigrationChain extends MigrationChainBase {
  * @example
  * // Simple (no migrations):
  * const dataModel = new DataModelBuilder()
- *   .from<BlockData>(DATA_MODEL_DEFAULT_VERSION)
+ *   .from<BlockData>("v1")
  *   .init(() => ({ numbers: [] }));
  *
  * @example
  * // With migrations:
  * const dataModel = new DataModelBuilder()
- *   .from<BlockDataV1>(DATA_MODEL_DEFAULT_VERSION)
+ *   .from<BlockDataV1>("v1")
  *   .migrate<BlockDataV2>("v2", (v1) => ({ ...v1, labels: [] }))
  *   .migrate<BlockDataV3>("v3", (v2) => ({ ...v2, description: '' }))
  *   .init(() => ({ numbers: [], labels: [], description: '' }));
@@ -251,7 +271,7 @@ class DataModelMigrationChain extends MigrationChainBase {
  * @example
  * // With recover() between migrations — recovered data goes through remaining migrations:
  * const dataModelChain = new DataModelBuilder()
- *   .from<BlockDataV1>(DATA_MODEL_DEFAULT_VERSION)
+ *   .from<BlockDataV1>("v1")
  *   .migrate<BlockDataV2>("v2", (v1) => ({ ...v1, labels: [] }));
  *
  * // recover() placed before the v3 migration: recovered data goes through v3
@@ -270,7 +290,7 @@ class DataModelMigrationChain extends MigrationChainBase {
  * type BlockData = { inputFile: string; selectedTab: string };
  *
  * const dataModel = new DataModelBuilder()
- *   .from<BlockData>(DATA_MODEL_DEFAULT_VERSION)
+ *   .from<BlockData>("v1")
  *   .upgradeLegacy<OldArgs, OldUiState>(({ args, uiState }) => ({
  *     inputFile: args.inputFile,
  *     selectedTab: uiState.selectedTab,
@@ -282,11 +302,11 @@ class DataModelBuilder {
      * Start the migration chain with the given initial data type and version key.
      *
      * @typeParam T - Data type for the initial version
-     * @param initialVersion - Version key string (e.g. DATA_MODEL_DEFAULT_VERSION or "v1")
+     * @param initialVersion - Version key string (e.g. "v1")
      * @returns Migration chain builder
      */
     from(initialVersion) {
-        return new DataModelMigrationChain({ versionChain: [initialVersion] });
+        return new DataModelInitialChain({ versionChain: [initialVersion] });
     }
 }
 /**
@@ -299,7 +319,7 @@ class DataModelBuilder {
  * // With recover() between migrations:
  * // Recovered data (V2) goes through the v2→v3 migration automatically.
  * const dataModel = new DataModelBuilder()
- *   .from<V1>(DATA_MODEL_DEFAULT_VERSION)
+ *   .from<V1>("v1")
  *   .migrate<V2>("v2", (v1) => ({ ...v1, label: "" }))
  *   .recover((version, data) => {
  *     if (version === "legacy") return transformLegacy(data); // returns V2
@@ -317,9 +337,7 @@ class DataModel {
     initialDataFn;
     recoverFn;
     recoverFromIndex;
-    /** Transforms legacy V1 model data at the initial version before running migrations. */
-    upgradeLegacyFn;
-    constructor({ versionChain, steps, initialDataFn, recoverFn = defaultRecover, recoverFromIndex, upgradeLegacyFn, }) {
+    constructor({ versionChain, steps, initialDataFn, recoverFn = defaultRecover, recoverFromIndex, }) {
         if (versionChain.length === 0) {
             throw new Error("DataModel requires at least one version key");
         }
@@ -329,7 +347,6 @@ class DataModel {
         this.initialDataFn = initialDataFn;
         this.recoverFn = recoverFn;
         this.recoverFromIndex = recoverFromIndex ?? steps.length;
-        this.upgradeLegacyFn = upgradeLegacyFn;
     }
     /**
      * Internal method for creating DataModel from builder.
@@ -360,33 +377,12 @@ class DataModel {
     }
     recoverFrom(data, version) {
         // Step 1: call the recover function to get data at the recover point
-        let currentData;
-        try {
-            currentData = this.recoverFn(version, data);
-        }
-        catch (error) {
-            if (isDataUnrecoverableError(error)) {
-                return { ...this.getDefaultData(), warning: error.message };
-            }
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            return {
-                ...this.getDefaultData(),
-                warning: `Recover failed for version '${version}': ${errorMessage}`,
-            };
-        }
+        // Let errors (including DataUnrecoverableError) propagate to the caller.
+        let currentData = this.recoverFn(version, data);
         // Step 2: run any migrations that were added after recover() in the chain
         for (let i = this.recoverFromIndex; i < this.steps.length; i++) {
             const step = this.steps[i];
-            try {
-                currentData = step.migrate(currentData);
-            }
-            catch (error) {
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                return {
-                    ...this.getDefaultData(),
-                    warning: `Migration ${step.fromVersion}→${step.toVersion} failed: ${errorMessage}`,
-                };
-            }
+            currentData = step.migrate(currentData);
         }
         return { version: this.latestVersion, data: currentData };
     }
@@ -394,11 +390,12 @@ class DataModel {
      * Migrate versioned data from any version to the latest.
      *
      * - If version is in chain, applies needed migrations (O(1) lookup)
-     * - If version is unknown, calls recover function then runs remaining migrations
-     * - If migration/recovery fails, returns default data with warning
+     * - If version is unknown, attempts recovery; falls back to initial data
+     * - If a migration step fails, throws so the caller can preserve original data
      *
      * @param versioned - Data with version tag
-     * @returns Migration result with data at latest version
+     * @returns Migrated data at the latest version
+     * @throws If a migration step from a known version fails
      */
     migrate(versioned) {
         const { version: fromVersion, data } = versioned;
@@ -407,38 +404,23 @@ class DataModel {
         }
         const startIndex = this.stepsByFromVersion.get(fromVersion);
         if (startIndex === undefined) {
-            return this.recoverFrom(data, fromVersion);
-        }
-        let currentData = data;
-        // Legacy V1 upgrade: detect and transform { args, uiState } at the initial version
-        if (startIndex === 0 && this.upgradeLegacyFn) {
             try {
-                currentData = this.upgradeLegacyFn(currentData);
+                return this.recoverFrom(data, fromVersion);
             }
-            catch (error) {
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                return {
-                    ...this.getDefaultData(),
-                    warning: `Legacy upgrade failed: ${errorMessage}`,
-                };
+            catch {
+                // Recovery failed (unknown version, recover fn threw, or post-recover
+                // migration failed) — reset to initial data rather than blocking the update.
+                return this.getDefaultData();
             }
         }
+        let currentData = data;
         for (let i = startIndex; i < this.steps.length; i++) {
             const step = this.steps[i];
-            try {
-                currentData = step.migrate(currentData);
-            }
-            catch (error) {
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                return {
-                    ...this.getDefaultData(),
-                    warning: `Migration ${step.fromVersion}→${step.toVersion} failed: ${errorMessage}`,
-                };
-            }
+            currentData = step.migrate(currentData);
         }
         return { version: this.latestVersion, data: currentData };
     }
 }
 
-export { DataModel, DataModelBuilder, DataUnrecoverableError, defaultRecover, isDataUnrecoverableError, makeDataVersioned };
+export { DataMigrationError, DataModel, DataModelBuilder, DataUnrecoverableError, defaultRecover, isDataUnrecoverableError, makeDataVersioned };
 //# sourceMappingURL=block_migrations.js.map

package/dist/block_migrations.js.map

@@ -1 +1 @@
-{"version":3,"file":"block_migrations.js","sources":["../src/block_migrations.ts"],"sourcesContent":["export type DataVersionKey = string;\nexport type DataMigrateFn<From, To> = (prev: Readonly<From>) => To;\nexport type DataCreateFn<T> = () => T;\nexport type DataRecoverFn<T> = (version: DataVersionKey, data: unknown) => T;\n\n/** Versioned data wrapper for persistence */\nexport type DataVersioned<T> = {\n  version: DataVersionKey;\n  data: T;\n};\n\n/** Create a DataVersioned wrapper with correct shape */\nexport function makeDataVersioned<T>(version: DataVersionKey, data: T): DataVersioned<T> {\n  return { version, data };\n}\n\n/** Result of migration operation, may include warning if migration failed */\nexport type DataMigrationResult<T> = DataVersioned<T> & {\n  warning?: string;\n};\n\n/** Thrown by recover() to signal unrecoverable data. */\nexport class DataUnrecoverableError extends Error {\n  name = \"DataUnrecoverableError\";\n  constructor(dataVersion: DataVersionKey) {\n    super(`Unknown version '${dataVersion}'`);\n  }\n}\n\nexport function isDataUnrecoverableError(error: unknown): error is DataUnrecoverableError {\n  return error instanceof Error && error.name === \"DataUnrecoverableError\";\n}\n\ntype MigrationStep = {\n  fromVersion: DataVersionKey;\n  toVersion: DataVersionKey;\n  migrate: (data: unknown) => unknown;\n};\n\n/**\n * Default recover function for unknown versions.\n * Use as fallback at the end of custom recover functions.\n *\n * @example\n * .recover((version, data) => {\n *   if (version === 'legacy') {\n *     return transformLegacyData(data);\n *   }\n *   return defaultRecover(version, data);\n * })\n */\nexport const defaultRecover: DataRecoverFn<never> = (version, _data) => {\n  throw new DataUnrecoverableError(version);\n};\n\n/** Symbol for internal builder creation method */\nconst FROM_BUILDER = Symbol(\"fromBuilder\");\n\n/** Legacy V1 model state shape: { args, uiState } */\nexport type LegacyV1State<Args, UiState> = { args: Args; uiState: UiState };\n\n/** Internal state passed from builder to DataModel */\ntype BuilderState<S> = {\n  versionChain: DataVersionKey[];\n  steps: MigrationStep[];\n  initialDataFn: () => S;\n  recoverFn?: (version: DataVersionKey, data: unknown) => unknown;\n  /** Index of the first step to run after recovery. Equals the number of steps\n   *  present at the time recover() was called. */\n  recoverFromIndex?: number;\n  /** Transforms legacy V1 model data ({ args, uiState }) at the initial version. */\n  upgradeLegacyFn?: (data: unknown) => unknown;\n};\n\ntype RecoverState = {\n  recoverFn?: (version: DataVersionKey, data: unknown) => unknown;\n  recoverFromIndex?: number;\n  upgradeLegacyFn?: (data: unknown) => unknown;\n};\n\n/**\n * Abstract base for both migration chain types.\n * Holds shared state, buildStep() helper, and init().\n * migrate() cannot be shared due to a TypeScript limitation: when the base class\n * migrate() return type is abstract, subclasses cannot narrow it without losing type safety.\n * Each subclass therefore owns its migrate() with the correct concrete return type.\n *\n * @internal\n */\nabstract class MigrationChainBase<Current> {\n  protected readonly versionChain: DataVersionKey[];\n  protected readonly migrationSteps: MigrationStep[];\n\n  protected constructor(state: { versionChain: DataVersionKey[]; steps: MigrationStep[] }) {\n    this.versionChain = state.versionChain;\n    this.migrationSteps = state.steps;\n  }\n\n  /** Appends a migration step and returns the new versionChain and steps arrays. */\n  protected buildStep<Next>(\n    nextVersion: string,\n    fn: DataMigrateFn<Current, Next>,\n  ): { versionChain: DataVersionKey[]; steps: MigrationStep[] } {\n    if (this.versionChain.includes(nextVersion)) {\n      throw new Error(`Duplicate version '${nextVersion}' in migration chain`);\n    }\n    const fromVersion = this.versionChain[this.versionChain.length - 1];\n    const step: MigrationStep = {\n      fromVersion,\n      toVersion: nextVersion,\n      migrate: fn as (data: unknown) => unknown,\n    };\n    return {\n      versionChain: [...this.versionChain, nextVersion],\n      steps: [...this.migrationSteps, step],\n    };\n  }\n\n  /** Returns recover-specific fields for DataModel construction. Overridden by WithRecover. */\n  protected recoverState(): RecoverState {\n    return {};\n  }\n\n  /**\n   * Finalize the DataModel with initial data factory.\n   *\n   * @param initialData - Factory function returning the initial state\n   * @returns Finalized DataModel instance\n   */\n  init(initialData: DataCreateFn<Current>): DataModel<Current> {\n    return DataModel[FROM_BUILDER]<Current>({\n      versionChain: this.versionChain,\n      steps: this.migrationSteps,\n      initialDataFn: initialData,\n      ...this.recoverState(),\n    });\n  }\n}\n\n/**\n * Migration chain after recover() or upgradeLegacy() has been called.\n * Further migrate() calls are allowed; recover() and upgradeLegacy() are not\n * (enforced by type — no such methods on this class).\n *\n * @typeParam Current - Data type at the current point in the chain\n * @internal\n */\nclass DataModelMigrationChainWithRecover<Current> extends MigrationChainBase<Current> {\n  private readonly recoverFn?: (version: DataVersionKey, data: unknown) => unknown;\n  private readonly recoverFromIndex?: number;\n  private readonly upgradeLegacyFn?: (data: unknown) => unknown;\n\n  /** @internal */\n  constructor(state: {\n    versionChain: DataVersionKey[];\n    steps: MigrationStep[];\n    recoverFn?: (version: DataVersionKey, data: unknown) => unknown;\n    recoverFromIndex?: number;\n    upgradeLegacyFn?: (data: unknown) => unknown;\n  }) {\n    super(state);\n    this.recoverFn = state.recoverFn;\n    this.recoverFromIndex = state.recoverFromIndex;\n    this.upgradeLegacyFn = state.upgradeLegacyFn;\n  }\n\n  protected override recoverState(): RecoverState {\n    return {\n      recoverFn: this.recoverFn,\n      recoverFromIndex: this.recoverFromIndex,\n      upgradeLegacyFn: this.upgradeLegacyFn,\n    };\n  }\n\n  /**\n   * Add a migration step. Same semantics as on the base chain.\n   * recover() and upgradeLegacy() are not available — one has already been called.\n   */\n  migrate<Next>(\n    nextVersion: string,\n    fn: DataMigrateFn<Current, Next>,\n  ): DataModelMigrationChainWithRecover<Next> {\n    const { versionChain, steps } = this.buildStep(nextVersion, fn);\n    return new DataModelMigrationChainWithRecover<Next>({\n      versionChain,\n      steps,\n      recoverFn: this.recoverFn,\n      recoverFromIndex: this.recoverFromIndex,\n      upgradeLegacyFn: this.upgradeLegacyFn,\n    });\n  }\n}\n\n/**\n * Migration chain builder.\n * Each migrate() call advances the current data type. recover() can be called once\n * at any point — it removes itself from the returned chain so it cannot be called again.\n * Duplicate version keys throw at runtime.\n *\n * @typeParam Current - Data type at the current point in the migration chain\n * @internal\n */\nclass DataModelMigrationChain<Current> extends MigrationChainBase<Current> {\n  /** @internal */\n  constructor({\n    versionChain,\n    steps = [],\n  }: {\n    versionChain: DataVersionKey[];\n    steps?: MigrationStep[];\n  }) {\n    super({ versionChain, steps });\n  }\n\n  /**\n   * Add a migration step transforming data from the current version to the next.\n   *\n   * @typeParam Next - Data type of the next version\n   * @param nextVersion - Version key to migrate to (must be unique in the chain)\n   * @param fn - Migration function\n   * @returns Builder with the next version as current\n   *\n   * @example\n   * .migrate<BlockDataV2>(\"v2\", (v1) => ({ ...v1, labels: [] }))\n   */\n  migrate<Next>(\n    nextVersion: string,\n    fn: DataMigrateFn<Current, Next>,\n  ): DataModelMigrationChain<Next> {\n    const { versionChain, steps } = this.buildStep(nextVersion, fn);\n    return new DataModelMigrationChain<Next>({ versionChain, steps });\n  }\n\n  /**\n   * Set a recovery handler for unknown or legacy versions.\n   *\n   * The recover function is called when data has a version not in the migration chain.\n   * It must return data of the type at this point in the chain (Current). Any migrate()\n   * steps added after recover() will then run on the recovered data.\n   *\n   * Can only be called once — the returned chain has no recover() method.\n   * Mutually exclusive with upgradeLegacy().\n   *\n   * @param fn - Recovery function returning Current (the type at this chain position)\n   * @returns Builder with migrate() and init() but without recover() or upgradeLegacy()\n   *\n   * @example\n   * // Recover between migrations — recovered data goes through v3 migration\n   * new DataModelBuilder<V1>(\"v1\")\n   *   .migrate<V2>(\"v2\", (v1) => ({ ...v1, label: \"\" }))\n   *   .recover((version, data) => {\n   *     if (version === 'legacy') return transformLegacy(data); // returns V2\n   *     return defaultRecover(version, data);\n   *   })\n   *   .migrate<V3>(\"v3\", (v2) => ({ ...v2, description: \"\" }))\n   *   .init(() => ({ count: 0, label: \"\", description: \"\" }));\n   */\n  recover(fn: DataRecoverFn<Current>): DataModelMigrationChainWithRecover<Current> {\n    return new DataModelMigrationChainWithRecover<Current>({\n      versionChain: this.versionChain,\n      steps: this.migrationSteps,\n      recoverFn: fn as (version: DataVersionKey, data: unknown) => unknown,\n      recoverFromIndex: this.migrationSteps.length,\n    });\n  }\n\n  /**\n   * Handle legacy V1 model state ({ args, uiState }) when upgrading a block from\n   * BlockModel V1 to BlockModelV3.\n   *\n   * When a V1 block is upgraded, its stored state `{ args, uiState }` arrives at the\n   * initial version (DATA_MODEL_DEFAULT_VERSION) in the migration chain. This method\n   * detects the legacy shape and transforms it to the current chain type using the\n   * provided typed callback. Non-legacy data passes through unchanged.\n   *\n   * Should be called right after `.from()` (before any `.migrate()` calls), since legacy\n   * data always arrives at the initial version. Any `.migrate()` steps added after\n   * `upgradeLegacy()` will run on the transformed result.\n   *\n   * Can only be called once — the returned chain has no upgradeLegacy() method.\n   * Mutually exclusive with recover().\n   *\n   * @typeParam Args - Type of the legacy block args\n   * @typeParam UiState - Type of the legacy block uiState\n   * @param fn - Typed transform from { args, uiState } to Current\n   * @returns Builder with migrate() and init() but without recover() or upgradeLegacy()\n   *\n   * @example\n   * type OldArgs = { inputFile: string; threshold: number };\n   * type OldUiState = { selectedTab: string };\n   * type BlockData = { inputFile: string; threshold: number; selectedTab: string };\n   *\n   * const dataModel = new DataModelBuilder()\n   *   .from<BlockData>(DATA_MODEL_DEFAULT_VERSION)\n   *   .upgradeLegacy<OldArgs, OldUiState>(({ args, uiState }) => ({\n   *     inputFile: args.inputFile,\n   *     threshold: args.threshold,\n   *     selectedTab: uiState.selectedTab,\n   *   }))\n   *   .init(() => ({ inputFile: '', threshold: 0, selectedTab: 'main' }));\n   */\n  upgradeLegacy<Args, UiState = unknown>(\n    fn: (legacy: LegacyV1State<Args, UiState>) => Current,\n  ): DataModelMigrationChainWithRecover<Current> {\n    const wrappedFn = (data: unknown): unknown => {\n      if (data !== null && typeof data === \"object\" && \"args\" in data) {\n        return fn(data as LegacyV1State<Args, UiState>);\n      }\n      return data;\n    };\n    return new DataModelMigrationChainWithRecover<Current>({\n      versionChain: this.versionChain,\n      steps: this.migrationSteps,\n      upgradeLegacyFn: wrappedFn,\n    });\n  }\n}\n\n/**\n * Builder entry point for creating DataModel with type-safe migrations.\n *\n * @example\n * // Simple (no migrations):\n * const dataModel = new DataModelBuilder()\n *   .from<BlockData>(DATA_MODEL_DEFAULT_VERSION)\n *   .init(() => ({ numbers: [] }));\n *\n * @example\n * // With migrations:\n * const dataModel = new DataModelBuilder()\n *   .from<BlockDataV1>(DATA_MODEL_DEFAULT_VERSION)\n *   .migrate<BlockDataV2>(\"v2\", (v1) => ({ ...v1, labels: [] }))\n *   .migrate<BlockDataV3>(\"v3\", (v2) => ({ ...v2, description: '' }))\n *   .init(() => ({ numbers: [], labels: [], description: '' }));\n *\n * @example\n * // With recover() between migrations — recovered data goes through remaining migrations:\n * const dataModelChain = new DataModelBuilder()\n *   .from<BlockDataV1>(DATA_MODEL_DEFAULT_VERSION)\n *   .migrate<BlockDataV2>(\"v2\", (v1) => ({ ...v1, labels: [] }));\n *\n * // recover() placed before the v3 migration: recovered data goes through v3\n * const dataModel = dataModelChain\n *   .recover((version, data) => {\n *     if (version === 'legacy' && isLegacyData(data)) return transformLegacy(data); // returns V2\n *     return defaultRecover(version, data);\n *   })\n *   .migrate<BlockDataV3>(\"v3\", (v2) => ({ ...v2, description: '' }))\n *   .init(() => ({ numbers: [], labels: [], description: '' }));\n *\n * @example\n * // With upgradeLegacy() — typed upgrade from BlockModel V1 state:\n * type OldArgs = { inputFile: string };\n * type OldUiState = { selectedTab: string };\n * type BlockData = { inputFile: string; selectedTab: string };\n *\n * const dataModel = new DataModelBuilder()\n *   .from<BlockData>(DATA_MODEL_DEFAULT_VERSION)\n *   .upgradeLegacy<OldArgs, OldUiState>(({ args, uiState }) => ({\n *     inputFile: args.inputFile,\n *     selectedTab: uiState.selectedTab,\n *   }))\n *   .init(() => ({ inputFile: '', selectedTab: 'main' }));\n */\nexport class DataModelBuilder {\n  /**\n   * Start the migration chain with the given initial data type and version key.\n   *\n   * @typeParam T - Data type for the initial version\n   * @param initialVersion - Version key string (e.g. DATA_MODEL_DEFAULT_VERSION or \"v1\")\n   * @returns Migration chain builder\n   */\n  from<T>(initialVersion: string): DataModelMigrationChain<T> {\n    return new DataModelMigrationChain<T>({ versionChain: [initialVersion] });\n  }\n}\n\n/**\n * DataModel defines the block's data structure, initial values, and migrations.\n * Used by BlockModelV3 to manage data state.\n *\n * Use `new DataModelBuilder()` to create a DataModel.\n *\n * @example\n * // With recover() between migrations:\n * // Recovered data (V2) goes through the v2→v3 migration automatically.\n * const dataModel = new DataModelBuilder()\n *   .from<V1>(DATA_MODEL_DEFAULT_VERSION)\n *   .migrate<V2>(\"v2\", (v1) => ({ ...v1, label: \"\" }))\n *   .recover((version, data) => {\n *     if (version === \"legacy\") return transformLegacy(data); // returns V2\n *     return defaultRecover(version, data);\n *   })\n *   .migrate<V3>(\"v3\", (v2) => ({ ...v2, description: \"\" }))\n *   .init(() => ({ count: 0, label: \"\", description: \"\" }));\n */\nexport class DataModel<State> {\n  /** Latest version key — O(1) access for the common \"already current\" check. */\n  private readonly latestVersion: DataVersionKey;\n  /** Maps each known version key to the index of the first step to run from it. O(1) lookup. */\n  private readonly stepsByFromVersion: ReadonlyMap<DataVersionKey, number>;\n  private readonly steps: MigrationStep[];\n  private readonly initialDataFn: () => State;\n  private readonly recoverFn: (version: DataVersionKey, data: unknown) => unknown;\n  private readonly recoverFromIndex: number;\n  /** Transforms legacy V1 model data at the initial version before running migrations. */\n  private readonly upgradeLegacyFn?: (data: unknown) => unknown;\n\n  private constructor({\n    versionChain,\n    steps,\n    initialDataFn,\n    recoverFn = defaultRecover,\n    recoverFromIndex,\n    upgradeLegacyFn,\n  }: BuilderState<State>) {\n    if (versionChain.length === 0) {\n      throw new Error(\"DataModel requires at least one version key\");\n    }\n    this.latestVersion = versionChain[versionChain.length - 1];\n    this.stepsByFromVersion = new Map(versionChain.map((v, i) => [v, i]));\n    this.steps = steps;\n    this.initialDataFn = initialDataFn;\n    this.recoverFn = recoverFn;\n    this.recoverFromIndex = recoverFromIndex ?? steps.length;\n    this.upgradeLegacyFn = upgradeLegacyFn;\n  }\n\n  /**\n   * Internal method for creating DataModel from builder.\n   * Uses Symbol key to prevent external access.\n   * @internal\n   */\n  static [FROM_BUILDER]<S>(state: BuilderState<S>): DataModel<S> {\n    return new DataModel<S>(state);\n  }\n\n  /**\n   * The latest (current) version key in the migration chain.\n   */\n  get version(): DataVersionKey {\n    return this.latestVersion;\n  }\n\n  /**\n   * Get a fresh copy of the initial data.\n   */\n  initialData(): State {\n    return this.initialDataFn();\n  }\n\n  /**\n   * Get initial data wrapped with current version.\n   * Used when creating new blocks or resetting to defaults.\n   */\n  getDefaultData(): DataVersioned<State> {\n    return makeDataVersioned(this.latestVersion, this.initialDataFn());\n  }\n\n  private recoverFrom(data: unknown, version: DataVersionKey): DataMigrationResult<State> {\n    // Step 1: call the recover function to get data at the recover point\n    let currentData: unknown;\n    try {\n      currentData = this.recoverFn(version, data);\n    } catch (error) {\n      if (isDataUnrecoverableError(error)) {\n        return { ...this.getDefaultData(), warning: error.message };\n      }\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      return {\n        ...this.getDefaultData(),\n        warning: `Recover failed for version '${version}': ${errorMessage}`,\n      };\n    }\n\n    // Step 2: run any migrations that were added after recover() in the chain\n    for (let i = this.recoverFromIndex; i < this.steps.length; i++) {\n      const step = this.steps[i];\n      try {\n        currentData = step.migrate(currentData);\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        return {\n          ...this.getDefaultData(),\n          warning: `Migration ${step.fromVersion}→${step.toVersion} failed: ${errorMessage}`,\n        };\n      }\n    }\n\n    return { version: this.latestVersion, data: currentData as State };\n  }\n\n  /**\n   * Migrate versioned data from any version to the latest.\n   *\n   * - If version is in chain, applies needed migrations (O(1) lookup)\n   * - If version is unknown, calls recover function then runs remaining migrations\n   * - If migration/recovery fails, returns default data with warning\n   *\n   * @param versioned - Data with version tag\n   * @returns Migration result with data at latest version\n   */\n  migrate(versioned: DataVersioned<unknown>): DataMigrationResult<State> {\n    const { version: fromVersion, data } = versioned;\n\n    if (fromVersion === this.latestVersion) {\n      return { version: this.latestVersion, data: data as State };\n    }\n\n    const startIndex = this.stepsByFromVersion.get(fromVersion);\n    if (startIndex === undefined) {\n      return this.recoverFrom(data, fromVersion);\n    }\n\n    let currentData: unknown = data;\n\n    // Legacy V1 upgrade: detect and transform { args, uiState } at the initial version\n    if (startIndex === 0 && this.upgradeLegacyFn) {\n      try {\n        currentData = this.upgradeLegacyFn(currentData);\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        return {\n          ...this.getDefaultData(),\n          warning: `Legacy upgrade failed: ${errorMessage}`,\n        };\n      }\n    }\n\n    for (let i = startIndex; i < this.steps.length; i++) {\n      const step = this.steps[i];\n      try {\n        currentData = step.migrate(currentData);\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        return {\n          ...this.getDefaultData(),\n          warning: `Migration ${step.fromVersion}→${step.toVersion} failed: ${errorMessage}`,\n        };\n      }\n    }\n\n    return { version: this.latestVersion, data: currentData as State };\n  }\n}\n"],"names":[],"mappings":"AAWA;AACM,SAAU,iBAAiB,CAAI,OAAuB,EAAE,IAAO,EAAA;AACnE,IAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;AAC1B;AAOA;AACM,MAAO,sBAAuB,SAAQ,KAAK,CAAA;IAC/C,IAAI,GAAG,wBAAwB;AAC/B,IAAA,WAAA,CAAY,WAA2B,EAAA;AACrC,QAAA,KAAK,CAAC,CAAA,iBAAA,EAAoB,WAAW,CAAA,CAAA,CAAG,CAAC;IAC3C;AACD;AAEK,SAAU,wBAAwB,CAAC,KAAc,EAAA;IACrD,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,wBAAwB;AAC1E;AAQA;;;;;;;;;;;AAWG;MACU,cAAc,GAAyB,CAAC,OAAO,EAAE,KAAK,KAAI;AACrE,IAAA,MAAM,IAAI,sBAAsB,CAAC,OAAO,CAAC;AAC3C;AAEA;AACA,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC;AAwB1C;;;;;;;;AAQG;AACH,MAAe,kBAAkB,CAAA;AACZ,IAAA,YAAY;AACZ,IAAA,cAAc;AAEjC,IAAA,WAAA,CAAsB,KAAiE,EAAA;AACrF,QAAA,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY;AACtC,QAAA,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,KAAK;IACnC;;IAGU,SAAS,CACjB,WAAmB,EACnB,EAAgC,EAAA;QAEhC,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE;AAC3C,YAAA,MAAM,IAAI,KAAK,CAAC,sBAAsB,WAAW,CAAA,oBAAA,CAAsB,CAAC;QAC1E;AACA,QAAA,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;AACnE,QAAA,MAAM,IAAI,GAAkB;YAC1B,WAAW;AACX,YAAA,SAAS,EAAE,WAAW;AACtB,YAAA,OAAO,EAAE,EAAgC;SAC1C;QACD,OAAO;YACL,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC;YACjD,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC;SACtC;IACH;;IAGU,YAAY,GAAA;AACpB,QAAA,OAAO,EAAE;IACX;AAEA;;;;;AAKG;AACH,IAAA,IAAI,CAAC,WAAkC,EAAA;AACrC,QAAA,OAAO,SAAS,CAAC,YAAY,CAAC,CAAU;YACtC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI,CAAC,cAAc;AAC1B,YAAA,aAAa,EAAE,WAAW;YAC1B,GAAG,IAAI,CAAC,YAAY,EAAE;AACvB,SAAA,CAAC;IACJ;AACD;AAED;;;;;;;AAOG;AACH,MAAM,kCAA4C,SAAQ,kBAA2B,CAAA;AAClE,IAAA,SAAS;AACT,IAAA,gBAAgB;AAChB,IAAA,eAAe;;AAGhC,IAAA,WAAA,CAAY,KAMX,EAAA;QACC,KAAK,CAAC,KAAK,CAAC;AACZ,QAAA,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS;AAChC,QAAA,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB;AAC9C,QAAA,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe;IAC9C;IAEmB,YAAY,GAAA;QAC7B,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC;IACH;AAEA;;;AAGG;IACH,OAAO,CACL,WAAmB,EACnB,EAAgC,EAAA;AAEhC,QAAA,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;QAC/D,OAAO,IAAI,kCAAkC,CAAO;YAClD,YAAY;YACZ,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,eAAe,EAAE,IAAI,CAAC,eAAe;AACtC,SAAA,CAAC;IACJ;AACD;AAED;;;;;;;;AAQG;AACH,MAAM,uBAAiC,SAAQ,kBAA2B,CAAA;;AAExE,IAAA,WAAA,CAAY,EACV,YAAY,EACZ,KAAK,GAAG,EAAE,GAIX,EAAA;AACC,QAAA,KAAK,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IAChC;AAEA;;;;;;;;;;AAUG;IACH,OAAO,CACL,WAAmB,EACnB,EAAgC,EAAA;AAEhC,QAAA,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;QAC/D,OAAO,IAAI,uBAAuB,CAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IACnE;AAEA;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACH,IAAA,OAAO,CAAC,EAA0B,EAAA;QAChC,OAAO,IAAI,kCAAkC,CAAU;YACrD,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI,CAAC,cAAc;AAC1B,YAAA,SAAS,EAAE,EAAyD;AACpE,YAAA,gBAAgB,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM;AAC7C,SAAA,CAAC;IACJ;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCG;AACH,IAAA,aAAa,CACX,EAAqD,EAAA;AAErD,QAAA,MAAM,SAAS,GAAG,CAAC,IAAa,KAAa;AAC3C,YAAA,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAI,IAAI,EAAE;AAC/D,gBAAA,OAAO,EAAE,CAAC,IAAoC,CAAC;YACjD;AACA,YAAA,OAAO,IAAI;AACb,QAAA,CAAC;QACD,OAAO,IAAI,kCAAkC,CAAU;YACrD,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI,CAAC,cAAc;AAC1B,YAAA,eAAe,EAAE,SAAS;AAC3B,SAAA,CAAC;IACJ;AACD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CG;MACU,gBAAgB,CAAA;AAC3B;;;;;;AAMG;AACH,IAAA,IAAI,CAAI,cAAsB,EAAA;QAC5B,OAAO,IAAI,uBAAuB,CAAI,EAAE,YAAY,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC;IAC3E;AACD;AAED;;;;;;;;;;;;;;;;;;AAkBG;MACU,SAAS,CAAA;;AAEH,IAAA,aAAa;;AAEb,IAAA,kBAAkB;AAClB,IAAA,KAAK;AACL,IAAA,aAAa;AACb,IAAA,SAAS;AACT,IAAA,gBAAgB;;AAEhB,IAAA,eAAe;AAEhC,IAAA,WAAA,CAAoB,EAClB,YAAY,EACZ,KAAK,EACL,aAAa,EACb,SAAS,GAAG,cAAc,EAC1B,gBAAgB,EAChB,eAAe,GACK,EAAA;AACpB,QAAA,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE;AAC7B,YAAA,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC;QAChE;QACA,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1D,IAAI,CAAC,kBAAkB,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACrE,QAAA,IAAI,CAAC,KAAK,GAAG,KAAK;AAClB,QAAA,IAAI,CAAC,aAAa,GAAG,aAAa;AAClC,QAAA,IAAI,CAAC,SAAS,GAAG,SAAS;QAC1B,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,IAAI,KAAK,CAAC,MAAM;AACxD,QAAA,IAAI,CAAC,eAAe,GAAG,eAAe;IACxC;AAEA;;;;AAIG;AACH,IAAA,QAAQ,YAAY,CAAC,CAAI,KAAsB,EAAA;AAC7C,QAAA,OAAO,IAAI,SAAS,CAAI,KAAK,CAAC;IAChC;AAEA;;AAEG;AACH,IAAA,IAAI,OAAO,GAAA;QACT,OAAO,IAAI,CAAC,aAAa;IAC3B;AAEA;;AAEG;IACH,WAAW,GAAA;AACT,QAAA,OAAO,IAAI,CAAC,aAAa,EAAE;IAC7B;AAEA;;;AAGG;IACH,cAAc,GAAA;QACZ,OAAO,iBAAiB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;IACpE;IAEQ,WAAW,CAAC,IAAa,EAAE,OAAuB,EAAA;;AAExD,QAAA,IAAI,WAAoB;AACxB,QAAA,IAAI;YACF,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC;QAC7C;QAAE,OAAO,KAAK,EAAE;AACd,YAAA,IAAI,wBAAwB,CAAC,KAAK,CAAC,EAAE;AACnC,gBAAA,OAAO,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;YAC7D;AACA,YAAA,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;YAC3E,OAAO;gBACL,GAAG,IAAI,CAAC,cAAc,EAAE;AACxB,gBAAA,OAAO,EAAE,CAAA,4BAAA,EAA+B,OAAO,CAAA,GAAA,EAAM,YAAY,CAAA,CAAE;aACpE;QACH;;AAGA,QAAA,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1B,YAAA,IAAI;AACF,gBAAA,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;YACzC;YAAE,OAAO,KAAK,EAAE;AACd,gBAAA,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;gBAC3E,OAAO;oBACL,GAAG,IAAI,CAAC,cAAc,EAAE;oBACxB,OAAO,EAAE,CAAA,UAAA,EAAa,IAAI,CAAC,WAAW,CAAA,CAAA,EAAI,IAAI,CAAC,SAAS,CAAA,SAAA,EAAY,YAAY,CAAA,CAAE;iBACnF;YACH;QACF;QAEA,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,WAAoB,EAAE;IACpE;AAEA;;;;;;;;;AASG;AACH,IAAA,OAAO,CAAC,SAAiC,EAAA;QACvC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,SAAS;AAEhD,QAAA,IAAI,WAAW,KAAK,IAAI,CAAC,aAAa,EAAE;YACtC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,IAAa,EAAE;QAC7D;QAEA,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,WAAW,CAAC;AAC3D,QAAA,IAAI,UAAU,KAAK,SAAS,EAAE;YAC5B,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC;QAC5C;QAEA,IAAI,WAAW,GAAY,IAAI;;QAG/B,IAAI,UAAU,KAAK,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE;AAC5C,YAAA,IAAI;AACF,gBAAA,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC;YACjD;YAAE,OAAO,KAAK,EAAE;AACd,gBAAA,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;gBAC3E,OAAO;oBACL,GAAG,IAAI,CAAC,cAAc,EAAE;oBACxB,OAAO,EAAE,CAAA,uBAAA,EAA0B,YAAY,CAAA,CAAE;iBAClD;YACH;QACF;AAEA,QAAA,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACnD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1B,YAAA,IAAI;AACF,gBAAA,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;YACzC;YAAE,OAAO,KAAK,EAAE;AACd,gBAAA,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;gBAC3E,OAAO;oBACL,GAAG,IAAI,CAAC,cAAc,EAAE;oBACxB,OAAO,EAAE,CAAA,UAAA,EAAa,IAAI,CAAC,WAAW,CAAA,CAAA,EAAI,IAAI,CAAC,SAAS,CAAA,SAAA,EAAY,YAAY,CAAA,CAAE;iBACnF;YACH;QACF;QAEA,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,WAAoB,EAAE;IACpE;AACD;;;;"}
+{"version":3,"file":"block_migrations.js","sources":["../src/block_migrations.ts"],"sourcesContent":["import { DATA_MODEL_LEGACY_VERSION } from \"./block_storage\";\n\nexport type DataVersionKey = string;\nexport type DataMigrateFn<From, To> = (prev: Readonly<From>) => To;\nexport type DataCreateFn<T> = () => T;\nexport type DataRecoverFn<T> = (version: DataVersionKey, data: unknown) => T;\n\n/** Versioned data wrapper for persistence */\nexport type DataVersioned<T> = {\n  version: DataVersionKey;\n  data: T;\n};\n\n/** Create a DataVersioned wrapper with correct shape */\nexport function makeDataVersioned<T>(version: DataVersionKey, data: T): DataVersioned<T> {\n  return { version, data };\n}\n\n/** Thrown when a migration step fails. */\nexport class DataMigrationError extends Error {\n  name = \"DataMigrationError\";\n  constructor(message: string) {\n    super(message);\n  }\n}\n\n/** Thrown by recover() to signal unrecoverable data. */\nexport class DataUnrecoverableError extends Error {\n  name = \"DataUnrecoverableError\";\n  constructor(dataVersion: DataVersionKey) {\n    super(`Unknown version '${dataVersion}'`);\n  }\n}\n\nexport function isDataUnrecoverableError(error: unknown): error is DataUnrecoverableError {\n  return error instanceof Error && error.name === \"DataUnrecoverableError\";\n}\n\ntype MigrationStep = {\n  fromVersion: DataVersionKey;\n  toVersion: DataVersionKey;\n  migrate: (data: unknown) => unknown;\n};\n\n/**\n * Default recover function for unknown versions.\n * Use as fallback at the end of custom recover functions.\n *\n * @example\n * .recover((version, data) => {\n *   if (version === 'legacy') {\n *     return transformLegacyData(data);\n *   }\n *   return defaultRecover(version, data);\n * })\n */\nexport const defaultRecover: DataRecoverFn<never> = (version, _data) => {\n  throw new DataUnrecoverableError(version);\n};\n\n/** Symbol for internal builder creation method */\nconst FROM_BUILDER = Symbol(\"fromBuilder\");\n\n/** Legacy V1 model state shape: { args, uiState } */\nexport type LegacyV1State<Args, UiState> = { args: Args; uiState: UiState };\n\n/** Internal state passed from builder to DataModel */\ntype BuilderState<S> = {\n  versionChain: DataVersionKey[];\n  steps: MigrationStep[];\n  initialDataFn: () => S;\n  recoverFn?: (version: DataVersionKey, data: unknown) => unknown;\n  /** Index of the first step to run after recovery. Equals the number of steps\n   *  present at the time recover() was called. */\n  recoverFromIndex?: number;\n};\n\ntype RecoverState = {\n  recoverFn?: (version: DataVersionKey, data: unknown) => unknown;\n  recoverFromIndex?: number;\n};\n\n/**\n * Abstract base for both migration chain types.\n * Holds shared state, buildStep() helper, and init().\n * migrate() cannot be shared due to a TypeScript limitation: when the base class\n * migrate() return type is abstract, subclasses cannot narrow it without losing type safety.\n * Each subclass therefore owns its migrate() with the correct concrete return type.\n *\n * @internal\n */\nabstract class MigrationChainBase<Current> {\n  protected readonly versionChain: DataVersionKey[];\n  protected readonly migrationSteps: MigrationStep[];\n\n  protected constructor(state: { versionChain: DataVersionKey[]; steps: MigrationStep[] }) {\n    this.versionChain = state.versionChain;\n    this.migrationSteps = state.steps;\n  }\n\n  /** Appends a migration step and returns the new versionChain and steps arrays. */\n  protected buildStep<Next>(\n    nextVersion: string,\n    fn: DataMigrateFn<Current, Next>,\n  ): { versionChain: DataVersionKey[]; steps: MigrationStep[] } {\n    if (this.versionChain.includes(nextVersion)) {\n      throw new Error(`Duplicate version '${nextVersion}' in migration chain`);\n    }\n    const fromVersion = this.versionChain[this.versionChain.length - 1];\n    const step: MigrationStep = {\n      fromVersion,\n      toVersion: nextVersion,\n      migrate: fn as (data: unknown) => unknown,\n    };\n    return {\n      versionChain: [...this.versionChain, nextVersion],\n      steps: [...this.migrationSteps, step],\n    };\n  }\n\n  /** Returns recover-specific fields for DataModel construction. Overridden by WithRecover. */\n  protected recoverState(): RecoverState {\n    return {};\n  }\n\n  /**\n   * Finalize the DataModel with initial data factory.\n   *\n   * @param initialData - Factory function returning the initial state\n   * @returns Finalized DataModel instance\n   */\n  init(initialData: DataCreateFn<Current>): DataModel<Current> {\n    return DataModel[FROM_BUILDER]<Current>({\n      versionChain: this.versionChain,\n      steps: this.migrationSteps,\n      initialDataFn: initialData,\n      ...this.recoverState(),\n    });\n  }\n}\n\n/**\n * Migration chain after recover() or upgradeLegacy() has been called.\n * Further migrate() calls are allowed; recover() and upgradeLegacy() are not\n * (enforced by type — no such methods on this class).\n *\n * @typeParam Current - Data type at the current point in the chain\n * @internal\n */\nclass DataModelMigrationChainWithRecover<Current> extends MigrationChainBase<Current> {\n  private readonly recoverFn?: (version: DataVersionKey, data: unknown) => unknown;\n  private readonly recoverFromIndex?: number;\n\n  /** @internal */\n  constructor(state: {\n    versionChain: DataVersionKey[];\n    steps: MigrationStep[];\n    recoverFn?: (version: DataVersionKey, data: unknown) => unknown;\n    recoverFromIndex?: number;\n  }) {\n    super(state);\n    this.recoverFn = state.recoverFn;\n    this.recoverFromIndex = state.recoverFromIndex;\n  }\n\n  protected override recoverState(): RecoverState {\n    return {\n      recoverFn: this.recoverFn,\n      recoverFromIndex: this.recoverFromIndex,\n    };\n  }\n\n  /**\n   * Add a migration step. Same semantics as on the base chain.\n   * recover() and upgradeLegacy() are not available — one has already been called.\n   */\n  migrate<Next>(\n    nextVersion: string,\n    fn: DataMigrateFn<Current, Next>,\n  ): DataModelMigrationChainWithRecover<Next> {\n    const { versionChain, steps } = this.buildStep(nextVersion, fn);\n    return new DataModelMigrationChainWithRecover<Next>({\n      versionChain,\n      steps,\n      recoverFn: this.recoverFn,\n      recoverFromIndex: this.recoverFromIndex,\n    });\n  }\n}\n\n/**\n * Migration chain builder.\n * Each migrate() call advances the current data type. recover() can be called once\n * at any point — it removes itself from the returned chain so it cannot be called again.\n * Duplicate version keys throw at runtime.\n *\n * @typeParam Current - Data type at the current point in the migration chain\n * @internal\n */\nclass DataModelMigrationChain<Current> extends MigrationChainBase<Current> {\n  /** @internal */\n  constructor({\n    versionChain,\n    steps = [],\n  }: {\n    versionChain: DataVersionKey[];\n    steps?: MigrationStep[];\n  }) {\n    super({ versionChain, steps });\n  }\n\n  /**\n   * Add a migration step transforming data from the current version to the next.\n   *\n   * @typeParam Next - Data type of the next version\n   * @param nextVersion - Version key to migrate to (must be unique in the chain)\n   * @param fn - Migration function\n   * @returns Builder with the next version as current\n   *\n   * @example\n   * .migrate<BlockDataV2>(\"v2\", (v1) => ({ ...v1, labels: [] }))\n   */\n  migrate<Next>(\n    nextVersion: string,\n    fn: DataMigrateFn<Current, Next>,\n  ): DataModelMigrationChain<Next> {\n    const { versionChain, steps } = this.buildStep(nextVersion, fn);\n    return new DataModelMigrationChain<Next>({ versionChain, steps });\n  }\n\n  /**\n   * Set a recovery handler for unknown or legacy versions.\n   *\n   * The recover function is called when data has a version not in the migration chain.\n   * It must return data of the type at this point in the chain (Current). Any migrate()\n   * steps added after recover() will then run on the recovered data.\n   *\n   * Can only be called once — the returned chain has no recover() method.\n   *\n   * @param fn - Recovery function returning Current (the type at this chain position)\n   * @returns Builder with migrate() and init() but without recover()\n   *\n   * @example\n   * // Recover between migrations — recovered data goes through v3 migration\n   * new DataModelBuilder<V1>(\"v1\")\n   *   .migrate<V2>(\"v2\", (v1) => ({ ...v1, label: \"\" }))\n   *   .recover((version, data) => {\n   *     if (version === 'legacy') return transformLegacy(data); // returns V2\n   *     return defaultRecover(version, data);\n   *   })\n   *   .migrate<V3>(\"v3\", (v2) => ({ ...v2, description: \"\" }))\n   *   .init(() => ({ count: 0, label: \"\", description: \"\" }));\n   */\n  recover(fn: DataRecoverFn<Current>): DataModelMigrationChainWithRecover<Current> {\n    return new DataModelMigrationChainWithRecover<Current>({\n      versionChain: this.versionChain,\n      steps: this.migrationSteps,\n      recoverFn: fn as (version: DataVersionKey, data: unknown) => unknown,\n      recoverFromIndex: this.migrationSteps.length,\n    });\n  }\n}\n\n/**\n * Initial migration chain returned by `.from()`.\n * Extends DataModelMigrationChain with `upgradeLegacy()` — available only before\n * any `.migrate()` calls, since legacy data always arrives at the initial version.\n *\n * @typeParam Current - Data type at the initial version\n * @internal\n */\nclass DataModelInitialChain<Current> extends DataModelMigrationChain<Current> {\n  /**\n   * Handle legacy V1 model state ({ args, uiState }) when upgrading a block from\n   * BlockModel V1 to BlockModelV3.\n   *\n   * When a V1 block is upgraded, its stored state `{ args, uiState }` is normalized\n   * to the internal default version. This method inserts a migration step from that\n   * internal version to the version specified in `.from()`, using the provided typed\n   * callback to transform the legacy shape. Non-legacy data passes through unchanged.\n   *\n   * Must be called right after `.from()` — not available after `.migrate()` calls.\n   * Any `.migrate()` steps added after `upgradeLegacy()` will run on the transformed result.\n   *\n   * Can only be called once — the returned chain has no upgradeLegacy() method.\n   * Mutually exclusive with recover().\n   *\n   * @typeParam Args - Type of the legacy block args\n   * @typeParam UiState - Type of the legacy block uiState\n   * @param fn - Typed transform from { args, uiState } to Current\n   * @returns Builder with migrate() and init() but without recover() or upgradeLegacy()\n   *\n   * @example\n   * type OldArgs = { inputFile: string; threshold: number };\n   * type OldUiState = { selectedTab: string };\n   * type BlockData = { inputFile: string; threshold: number; selectedTab: string };\n   *\n   * const dataModel = new DataModelBuilder()\n   *   .from<BlockData>(\"v1\")\n   *   .upgradeLegacy<OldArgs, OldUiState>(({ args, uiState }) => ({\n   *     inputFile: args.inputFile,\n   *     threshold: args.threshold,\n   *     selectedTab: uiState.selectedTab,\n   *   }))\n   *   .init(() => ({ inputFile: '', threshold: 0, selectedTab: 'main' }));\n   */\n  upgradeLegacy<Args, UiState = unknown>(\n    fn: (legacy: LegacyV1State<Args, UiState>) => Current,\n  ): DataModelMigrationChainWithRecover<Current> {\n    const wrappedFn = (data: unknown): unknown => {\n      if (data !== null && typeof data === \"object\" && \"args\" in data) {\n        return fn(data as LegacyV1State<Args, UiState>);\n      }\n      return data;\n    };\n\n    // Insert DATA_MODEL_LEGACY_VERSION as the true first version\n    // with a migration step that transforms legacy data to the user's initial version.\n    const initialVersion = this.versionChain[0];\n    const step: MigrationStep = {\n      fromVersion: DATA_MODEL_LEGACY_VERSION,\n      toVersion: initialVersion,\n      migrate: wrappedFn,\n    };\n    return new DataModelMigrationChainWithRecover<Current>({\n      versionChain: [DATA_MODEL_LEGACY_VERSION, ...this.versionChain],\n      steps: [step, ...this.migrationSteps],\n    });\n  }\n}\n\n/**\n * Builder entry point for creating DataModel with type-safe migrations.\n *\n * @example\n * // Simple (no migrations):\n * const dataModel = new DataModelBuilder()\n *   .from<BlockData>(\"v1\")\n *   .init(() => ({ numbers: [] }));\n *\n * @example\n * // With migrations:\n * const dataModel = new DataModelBuilder()\n *   .from<BlockDataV1>(\"v1\")\n *   .migrate<BlockDataV2>(\"v2\", (v1) => ({ ...v1, labels: [] }))\n *   .migrate<BlockDataV3>(\"v3\", (v2) => ({ ...v2, description: '' }))\n *   .init(() => ({ numbers: [], labels: [], description: '' }));\n *\n * @example\n * // With recover() between migrations — recovered data goes through remaining migrations:\n * const dataModelChain = new DataModelBuilder()\n *   .from<BlockDataV1>(\"v1\")\n *   .migrate<BlockDataV2>(\"v2\", (v1) => ({ ...v1, labels: [] }));\n *\n * // recover() placed before the v3 migration: recovered data goes through v3\n * const dataModel = dataModelChain\n *   .recover((version, data) => {\n *     if (version === 'legacy' && isLegacyData(data)) return transformLegacy(data); // returns V2\n *     return defaultRecover(version, data);\n *   })\n *   .migrate<BlockDataV3>(\"v3\", (v2) => ({ ...v2, description: '' }))\n *   .init(() => ({ numbers: [], labels: [], description: '' }));\n *\n * @example\n * // With upgradeLegacy() — typed upgrade from BlockModel V1 state:\n * type OldArgs = { inputFile: string };\n * type OldUiState = { selectedTab: string };\n * type BlockData = { inputFile: string; selectedTab: string };\n *\n * const dataModel = new DataModelBuilder()\n *   .from<BlockData>(\"v1\")\n *   .upgradeLegacy<OldArgs, OldUiState>(({ args, uiState }) => ({\n *     inputFile: args.inputFile,\n *     selectedTab: uiState.selectedTab,\n *   }))\n *   .init(() => ({ inputFile: '', selectedTab: 'main' }));\n */\nexport class DataModelBuilder {\n  /**\n   * Start the migration chain with the given initial data type and version key.\n   *\n   * @typeParam T - Data type for the initial version\n   * @param initialVersion - Version key string (e.g. \"v1\")\n   * @returns Migration chain builder\n   */\n  from<T>(initialVersion: string): DataModelInitialChain<T> {\n    return new DataModelInitialChain<T>({ versionChain: [initialVersion] });\n  }\n}\n\n/**\n * DataModel defines the block's data structure, initial values, and migrations.\n * Used by BlockModelV3 to manage data state.\n *\n * Use `new DataModelBuilder()` to create a DataModel.\n *\n * @example\n * // With recover() between migrations:\n * // Recovered data (V2) goes through the v2→v3 migration automatically.\n * const dataModel = new DataModelBuilder()\n *   .from<V1>(\"v1\")\n *   .migrate<V2>(\"v2\", (v1) => ({ ...v1, label: \"\" }))\n *   .recover((version, data) => {\n *     if (version === \"legacy\") return transformLegacy(data); // returns V2\n *     return defaultRecover(version, data);\n *   })\n *   .migrate<V3>(\"v3\", (v2) => ({ ...v2, description: \"\" }))\n *   .init(() => ({ count: 0, label: \"\", description: \"\" }));\n */\nexport class DataModel<State> {\n  /** Latest version key — O(1) access for the common \"already current\" check. */\n  private readonly latestVersion: DataVersionKey;\n  /** Maps each known version key to the index of the first step to run from it. O(1) lookup. */\n  private readonly stepsByFromVersion: ReadonlyMap<DataVersionKey, number>;\n  private readonly steps: MigrationStep[];\n  private readonly initialDataFn: () => State;\n  private readonly recoverFn: (version: DataVersionKey, data: unknown) => unknown;\n  private readonly recoverFromIndex: number;\n\n  private constructor({\n    versionChain,\n    steps,\n    initialDataFn,\n    recoverFn = defaultRecover,\n    recoverFromIndex,\n  }: BuilderState<State>) {\n    if (versionChain.length === 0) {\n      throw new Error(\"DataModel requires at least one version key\");\n    }\n    this.latestVersion = versionChain[versionChain.length - 1];\n    this.stepsByFromVersion = new Map(versionChain.map((v, i) => [v, i]));\n    this.steps = steps;\n    this.initialDataFn = initialDataFn;\n    this.recoverFn = recoverFn;\n    this.recoverFromIndex = recoverFromIndex ?? steps.length;\n  }\n\n  /**\n   * Internal method for creating DataModel from builder.\n   * Uses Symbol key to prevent external access.\n   * @internal\n   */\n  static [FROM_BUILDER]<S>(state: BuilderState<S>): DataModel<S> {\n    return new DataModel<S>(state);\n  }\n\n  /**\n   * The latest (current) version key in the migration chain.\n   */\n  get version(): DataVersionKey {\n    return this.latestVersion;\n  }\n\n  /**\n   * Get a fresh copy of the initial data.\n   */\n  initialData(): State {\n    return this.initialDataFn();\n  }\n\n  /**\n   * Get initial data wrapped with current version.\n   * Used when creating new blocks or resetting to defaults.\n   */\n  getDefaultData(): DataVersioned<State> {\n    return makeDataVersioned(this.latestVersion, this.initialDataFn());\n  }\n\n  private recoverFrom(data: unknown, version: DataVersionKey): DataVersioned<State> {\n    // Step 1: call the recover function to get data at the recover point\n    // Let errors (including DataUnrecoverableError) propagate to the caller.\n    let currentData: unknown = this.recoverFn(version, data);\n\n    // Step 2: run any migrations that were added after recover() in the chain\n    for (let i = this.recoverFromIndex; i < this.steps.length; i++) {\n      const step = this.steps[i];\n      currentData = step.migrate(currentData);\n    }\n\n    return { version: this.latestVersion, data: currentData as State };\n  }\n\n  /**\n   * Migrate versioned data from any version to the latest.\n   *\n   * - If version is in chain, applies needed migrations (O(1) lookup)\n   * - If version is unknown, attempts recovery; falls back to initial data\n   * - If a migration step fails, throws so the caller can preserve original data\n   *\n   * @param versioned - Data with version tag\n   * @returns Migrated data at the latest version\n   * @throws If a migration step from a known version fails\n   */\n  migrate(versioned: DataVersioned<unknown>): DataVersioned<State> {\n    const { version: fromVersion, data } = versioned;\n\n    if (fromVersion === this.latestVersion) {\n      return { version: this.latestVersion, data: data as State };\n    }\n\n    const startIndex = this.stepsByFromVersion.get(fromVersion);\n    if (startIndex === undefined) {\n      try {\n        return this.recoverFrom(data, fromVersion);\n      } catch {\n        // Recovery failed (unknown version, recover fn threw, or post-recover\n        // migration failed) — reset to initial data rather than blocking the update.\n        return this.getDefaultData();\n      }\n    }\n\n    let currentData: unknown = data;\n\n    for (let i = startIndex; i < this.steps.length; i++) {\n      const step = this.steps[i];\n      currentData = step.migrate(currentData);\n    }\n\n    return { version: this.latestVersion, data: currentData as State };\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/block_model.cjs

@@ -32,7 +32,7 @@ class BlockModelV3 {
      *
      * @example
      * const dataModel = new DataModelBuilder()
-     *   .from<BlockData>(DATA_MODEL_DEFAULT_VERSION)
+     *   .from<BlockData>("v1")
      *   .init(() => ({ numbers: [], labels: [] }));
      *
      * BlockModelV3.create(dataModel)

package/dist/block_model.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"block_model.cjs","sources":["../src/block_model.ts"],"sourcesContent":["import type {\n  BlockRenderingMode,\n  BlockSection,\n  OutputWithStatus,\n  PlRef,\n  BlockCodeKnownFeatureFlags,\n  BlockConfigContainer,\n} from \"@milaboratories/pl-model-common\";\nimport { mergeFeatureFlags } from \"@milaboratories/pl-model-common\";\nimport { getPlatformaInstance, isInUI, createAndRegisterRenderLambda } from \"./internal\";\nimport type { DataModel } from \"./block_migrations\";\nimport type { PlatformaV3 } from \"./platforma\";\nimport type { InferRenderFunctionReturn, RenderFunction } from \"./render\";\nimport { BlockRenderCtx, PluginRenderCtx } from \"./render\";\nimport type { PluginData, PluginModel, PluginOutputs, PluginParams } from \"./plugin_model\";\nimport { type PluginHandle, pluginOutputKey } from \"./plugin_handle\";\nimport type { RenderCtxBase } from \"./render\";\nimport { PlatformaSDKVersion } from \"./version\";\nimport {\n  applyStorageUpdate,\n  getStorageDebugView,\n  migrateStorage,\n  createInitialStorage,\n  deriveArgsFromStorage,\n  derivePrerunArgsFromStorage,\n} from \"./block_storage_callbacks\";\nimport { type PluginName } from \"./block_storage\";\nimport type {\n  ConfigRenderLambda,\n  DeriveHref,\n  ConfigRenderLambdaFlags,\n  InferOutputsFromLambdas,\n} from \"./bconfig\";\nimport { downgradeCfgOrLambda, isConfigLambda } from \"./bconfig\";\nimport type { PlatformaExtended } from \"./platforma\";\nimport {\n  BLOCK_STORAGE_FACADE_VERSION,\n  BlockStorageFacadeCallbacks,\n  BlockStorageFacadeHandles,\n  registerFacadeCallbacks,\n} from \"./block_storage_facade\";\n\ntype SectionsExpectedType = readonly BlockSection[];\n\ntype NoOb = Record<string, never>;\n\n/**\n * Per-property lambdas for deriving plugin params from block render context.\n * Each property is a function that receives the block's RenderCtxBase and returns the param value.\n */\nexport type ParamsInput<Params, BArgs = unknown, BData = unknown> = {\n  [K in keyof Params]: (ctx: RenderCtxBase<BArgs, BData>) => Params[K];\n};\n\n/**\n * Type-erased version of ParamsInput for internal storage.\n */\ntype ParamsInputErased = Record<string, (ctx: RenderCtxBase) => unknown>;\n\n/**\n * Registered plugin: model + param derivation lambdas.\n * Type parameters are carried by PluginModel generic.\n */\nexport type PluginInstance<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n> = {\n  readonly model: PluginModel<Data, Params, Outputs>;\n  readonly inputs: ParamsInputErased;\n};\n\ninterface BlockModelV3Config<\n  OutputsCfg extends Record<string, ConfigRenderLambda>,\n  Data,\n  Plugins extends Record<string, PluginInstance> = {},\n> {\n  renderingMode: BlockRenderingMode;\n  dataModel: DataModel<Data>;\n  outputs: OutputsCfg;\n  sections: ConfigRenderLambda;\n  title: ConfigRenderLambda | undefined;\n  subtitle: ConfigRenderLambda | undefined;\n  tags: ConfigRenderLambda | undefined;\n  enrichmentTargets: ConfigRenderLambda | undefined;\n  featureFlags: BlockCodeKnownFeatureFlags;\n  argsFunction: ((data: unknown) => unknown) | undefined;\n  prerunArgsFunction: ((data: unknown) => unknown) | undefined;\n  plugins: Plugins;\n}\n\n/** Main entry point that each block should use in it's \"config\" module. Don't forget\n * to call {@link done()} at the end of configuration. Value returned by this builder must be\n * exported as constant with name \"platforma\" from the \"config\" module.\n * API version is 3 (for UI) and 2 (for model) */\nexport class BlockModelV3<\n  Args,\n  OutputsCfg extends Record<string, ConfigRenderLambda>,\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Href extends `/${string}` = \"/\",\n  Plugins extends Record<string, PluginInstance> = {},\n> {\n  private constructor(private readonly config: BlockModelV3Config<OutputsCfg, Data, Plugins>) {}\n\n  public static readonly INITIAL_BLOCK_FEATURE_FLAGS: BlockCodeKnownFeatureFlags = {\n    supportsLazyState: true,\n    requiresUIAPIVersion: 3,\n    requiresModelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n    requiresCreatePTable: 2,\n  };\n\n  /**\n   * Creates a new BlockModelV3 builder with the specified data model.\n   *\n   * @example\n   * const dataModel = new DataModelBuilder()\n   *   .from<BlockData>(DATA_MODEL_DEFAULT_VERSION)\n   *   .init(() => ({ numbers: [], labels: [] }));\n   *\n   * BlockModelV3.create(dataModel)\n   *   .args((data) => ({ numbers: data.numbers }))\n   *   .sections(() => [{ type: 'link', href: '/', label: 'Main' }])\n   *   .done();\n   *\n   * @param dataModel The data model that defines initial data and migrations\n   */\n  public static create<Data extends Record<string, unknown>>(\n    dataModel: DataModel<Data>,\n  ): BlockModelV3<NoOb, {}, Data> {\n    return new BlockModelV3<NoOb, {}, Data>({\n      renderingMode: \"Heavy\",\n      dataModel,\n      outputs: {},\n      sections: createAndRegisterRenderLambda({ handle: \"sections\", lambda: () => [] }, true),\n      title: undefined,\n      subtitle: undefined,\n      tags: undefined,\n      enrichmentTargets: undefined,\n      featureFlags: { ...BlockModelV3.INITIAL_BLOCK_FEATURE_FLAGS },\n      argsFunction: undefined,\n      prerunArgsFunction: undefined,\n      plugins: {},\n    });\n  }\n\n  /**\n   * Add output cell wrapped with additional status information to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunction<Args, Data, unknown>>(\n    key: Key,\n    rf: RF,\n    flags: ConfigRenderLambdaFlags & { withStatus: true },\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> & {\n        withStatus: true;\n      };\n    },\n    Data,\n    Href,\n    Plugins\n  >;\n  /**\n   * Add output cell to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunction<Args, Data, unknown>>(\n    key: Key,\n    rf: RF,\n    flags?: ConfigRenderLambdaFlags,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>>;\n    },\n    Data,\n    Href,\n    Plugins\n  >;\n  public output(\n    key: string,\n    cfgOrRf: RenderFunction<Args, Data, unknown>,\n    flags: ConfigRenderLambdaFlags = {},\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3({\n      ...this.config,\n      outputs: {\n        ...this.config.outputs,\n        [key]: createAndRegisterRenderLambda({\n          handle: `block-output#${key}`,\n          lambda: () => cfgOrRf(new BlockRenderCtx<Args, Data>()),\n          ...flags,\n        }),\n      },\n    });\n  }\n\n  /** Shortcut for {@link output} with retentive flag set to true. */\n  public retentiveOutput<\n    const Key extends string,\n    const RF extends RenderFunction<Args, Data, unknown>,\n  >(\n    key: Key,\n    rf: RF,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>>;\n    },\n    Data,\n    Href,\n    Plugins\n  > {\n    return this.output(key, rf, { retentive: true });\n  }\n\n  /** Shortcut for {@link output} with withStatus flag set to true. */\n  public outputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunction<Args, Data, unknown>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { withStatus: true });\n  }\n\n  /**\n   * Sets a function to derive block args from data.\n   * This is called during setData to compute the args that will be used for block execution.\n   *\n   * @example\n   * .args<BlockArgs>((data) => ({ numbers: data.numbers }))\n   *\n   * @example\n   * .args<BlockArgs>((data) => {\n   *   if (data.numbers.length === 0) throw new Error('Numbers required'); // block not ready\n   *   return { numbers: data.numbers };\n   * })\n   */\n  public args<Args>(\n    lambda: (data: Data) => Args,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      argsFunction: lambda as (data: unknown) => unknown,\n    });\n  }\n\n  /**\n   * Sets a function to derive pre-run args from data (optional).\n   * This is called during setData to compute the args that will be used for staging/pre-run phase.\n   *\n   * If not defined, defaults to using the args() function result.\n   * If defined, uses its return value for the staging / prerun phase.\n   *\n   * The staging / prerun phase runs only if currentPrerunArgs differs from the executed\n   * version of prerunArgs (same comparison logic as currentArgs vs prodArgs).\n   *\n   * @example\n   * .prerunArgs((data) => ({ numbers: data.numbers }))\n   *\n   * @example\n   * .prerunArgs((data) => {\n   *   // Return undefined to skip staging for this block\n   *   if (!data.isReady) return undefined;\n   *   return { numbers: data.numbers };\n   * })\n   */\n  public prerunArgs(\n    fn: (data: Data) => unknown,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      prerunArgsFunction: fn as (data: unknown) => unknown,\n    });\n  }\n\n  /** Sets the lambda to generate list of sections in the left block overviews panel. */\n  public sections<\n    const Ret extends SectionsExpectedType,\n    const RF extends RenderFunction<Args, Data, Ret>,\n  >(rf: RF): BlockModelV3<Args, OutputsCfg, Data, DeriveHref<ReturnType<RF>>, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, DeriveHref<ReturnType<RF>>, Plugins>({\n      ...this.config,\n      // Replace the default sections callback with the user-provided one\n      sections: createAndRegisterRenderLambda(\n        { handle: \"sections\", lambda: () => rf(new BlockRenderCtx<Args, Data>()) },\n        true,\n      ),\n    });\n  }\n\n  /** Sets a rendering function to derive block title, shown for the block in the left blocks-overview panel. */\n  public title(\n    rf: RenderFunction<Args, Data, string>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      title: createAndRegisterRenderLambda({\n        handle: \"title\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  public subtitle(\n    rf: RenderFunction<Args, Data, string>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      subtitle: createAndRegisterRenderLambda({\n        handle: \"subtitle\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  public tags(\n    rf: RenderFunction<Args, Data, string[]>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      tags: createAndRegisterRenderLambda({\n        handle: \"tags\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  /** Sets or overrides feature flags for the block. */\n  public withFeatureFlags(\n    flags: Partial<BlockCodeKnownFeatureFlags>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      featureFlags: { ...this.config.featureFlags, ...flags },\n    });\n  }\n\n  /**\n   * Defines how to derive list of upstream references this block is meant to enrich with its exports from block args.\n   * Influences dependency graph construction.\n   */\n  public enriches(\n    lambda: (args: Args) => PlRef[],\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      enrichmentTargets: createAndRegisterRenderLambda({\n        handle: \"enrichmentTargets\",\n        lambda: lambda,\n      }),\n    });\n  }\n\n  /**\n   * Registers a plugin instance with the block.\n   *\n   * Plugins are UI components with their own model logic and persistent state.\n   * Each plugin must have a unique pluginId within the block.\n   *\n   * @param pluginId - Unique identifier for this plugin instance within the block\n   * @param plugin - Configured PluginModel instance (created via factory.create(config))\n   * @param params - Per-property lambdas deriving plugin params from block RenderCtx\n   *\n   * @example\n   * .plugin('mainTable', dataTablePlugin.create({ defaultOps: {...} }), {\n   *   columns: (ctx) => ctx.outputs?.resolve(\"data\")?.getPColumns(),\n   *   sourceId: (ctx) => ctx.data.selectedSource,\n   * })\n   */\n  public plugin<\n    const PluginId extends string,\n    PData extends PluginData,\n    PParams extends PluginParams,\n    POutputs extends PluginOutputs,\n  >(\n    pluginId: PluginId,\n    plugin: PluginModel<PData, PParams, POutputs>,\n    params?: ParamsInput<PParams, Args, Data>,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg,\n    Data,\n    Href,\n    Plugins & { [K in PluginId]: PluginInstance<PData, PParams, POutputs> }\n  > {\n    // Validate pluginId uniqueness\n    if (pluginId in this.config.plugins) {\n      throw new Error(`Plugin '${pluginId}' already registered`);\n    }\n\n    const instance: PluginInstance<PData, PParams, POutputs> = {\n      model: plugin,\n      inputs: (params ?? {}) as ParamsInputErased,\n    };\n\n    return new BlockModelV3({\n      ...this.config,\n      plugins: {\n        ...this.config.plugins,\n        [pluginId]: instance,\n      },\n      featureFlags: mergeFeatureFlags(this.config.featureFlags, plugin.featureFlags ?? {}),\n    });\n  }\n\n  /** Renders all provided block settings into a pre-configured platforma API\n   * instance, that can be used in frontend to interact with block data, and\n   * other features provided by the platforma to the block. */\n  public done(): PlatformaExtended<\n    PlatformaV3<Data, Args, InferOutputsFromLambdas<OutputsCfg>, Href, Plugins>\n  > {\n    return this.withFeatureFlags({\n      ...this.config.featureFlags,\n    })._done();\n  }\n\n  public _done(): PlatformaExtended<\n    PlatformaV3<Data, Args, InferOutputsFromLambdas<OutputsCfg>, Href, Plugins>\n  > {\n    if (this.config.argsFunction === undefined) throw new Error(\"Args rendering function not set.\");\n\n    const apiVersion = 3;\n\n    // Build plugin registry\n    const { plugins } = this.config;\n    const pluginRegistry: Record<string, PluginName> = {};\n    const pluginHandles = Object.keys(plugins) as PluginHandle[];\n    for (const handle of pluginHandles) {\n      pluginRegistry[handle] = plugins[handle].model.name;\n    }\n\n    const { dataModel, argsFunction, prerunArgsFunction } = this.config;\n\n    function getPlugin(handle: PluginHandle): PluginInstance {\n      const plugin = plugins[handle];\n      if (!plugin) throw new Error(`Plugin model not found for '${handle}'`);\n      return plugin;\n    }\n\n    // Register ALL facade callbacks here, with dependencies captured via closures\n    registerFacadeCallbacks({\n      [BlockStorageFacadeCallbacks.StorageApplyUpdate]: applyStorageUpdate,\n      [BlockStorageFacadeCallbacks.StorageDebugView]: getStorageDebugView,\n      [BlockStorageFacadeCallbacks.StorageMigrate]: (currentStorageJson) =>\n        migrateStorage(currentStorageJson, {\n          migrateBlockData: (v) => dataModel.migrate(v),\n          getPluginRegistry: () => pluginRegistry,\n          migratePluginData: (handle, v) => getPlugin(handle).model.dataModel.migrate(v),\n          createPluginData: (handle) => getPlugin(handle).model.dataModel.getDefaultData(),\n        }),\n      [BlockStorageFacadeCallbacks.StorageInitial]: () =>\n        createInitialStorage({\n          getDefaultBlockData: () => dataModel.getDefaultData(),\n          getPluginRegistry: () => pluginRegistry,\n          createPluginData: (handle) => getPlugin(handle).model.dataModel.getDefaultData(),\n        }),\n      [BlockStorageFacadeCallbacks.ArgsDerive]: (storageJson) =>\n        deriveArgsFromStorage(storageJson, argsFunction),\n      [BlockStorageFacadeCallbacks.PrerunArgsDerive]: (storageJson) =>\n        derivePrerunArgsFromStorage(storageJson, argsFunction, prerunArgsFunction),\n    });\n\n    // Register plugin input and output lambdas\n    const pluginOutputs: Record<string, ConfigRenderLambda> = {};\n    for (const handle of pluginHandles) {\n      const { model, inputs } = plugins[handle];\n      // Wrap plugin param lambdas: close over BlockRenderCtx creation\n      const wrappedInputs: Record<string, () => unknown> = {};\n      for (const [paramKey, paramFn] of Object.entries(inputs)) {\n        wrappedInputs[paramKey] = () => paramFn(new BlockRenderCtx());\n      }\n\n      // Register plugin outputs (in config pack, evaluated by middle layer)\n      const outputs = model.outputs as Record<string, (ctx: PluginRenderCtx) => unknown>;\n      for (const [outputKey, outputFn] of Object.entries(outputs)) {\n        const key = pluginOutputKey(handle, outputKey);\n        pluginOutputs[key] = createAndRegisterRenderLambda({\n          handle: key,\n          lambda: () => outputFn(new PluginRenderCtx(handle, wrappedInputs)),\n        });\n      }\n    }\n    const allOutputs = { ...this.config.outputs, ...pluginOutputs };\n\n    const blockConfig: BlockConfigContainer = {\n      v4: {\n        configVersion: 4,\n        modelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n        sdkVersion: PlatformaSDKVersion,\n        renderingMode: this.config.renderingMode,\n        sections: this.config.sections,\n        title: this.config.title,\n        subtitle: this.config.subtitle,\n        tags: this.config.tags,\n        outputs: allOutputs,\n        enrichmentTargets: this.config.enrichmentTargets,\n        featureFlags: this.config.featureFlags,\n        blockLifecycleCallbacks: { ...BlockStorageFacadeHandles },\n      },\n\n      // fields below are added to allow previous desktop versions read generated configs\n      sdkVersion: PlatformaSDKVersion,\n      renderingMode: this.config.renderingMode,\n      sections: this.config.sections,\n      outputs: Object.fromEntries(\n        Object.entries(this.config.outputs).map(([key, value]) => [\n          key,\n          downgradeCfgOrLambda(value),\n        ]),\n      ),\n    };\n\n    globalThis.platformaApiVersion = apiVersion;\n\n    if (!isInUI())\n      // we are in the configuration rendering routine, not in actual UI\n      return { config: blockConfig } as any;\n    // normal operation inside the UI\n    else\n      return {\n        ...getPlatformaInstance({\n          sdkVersion: PlatformaSDKVersion,\n          apiVersion,\n        }),\n        blockModelInfo: {\n          outputs: Object.fromEntries(\n            Object.entries(allOutputs).map(([key, value]) => [\n              key,\n              {\n                withStatus: Boolean(isConfigLambda(value) && value.withStatus),\n              },\n            ]),\n          ),\n          pluginIds: pluginHandles,\n        },\n      } as any;\n  }\n}\n\n// Type tests for BlockModelV3\n\nexport type Expect<T extends true> = T;\n\nexport type Equal<X, Y> =\n  (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;\n\nexport type Merge<A, B> = {\n  [K in keyof A | keyof B]: K extends keyof B ? B[K] : K extends keyof A ? A[K] : never;\n};\n\n// Helper types for testing\ntype _TestArgs = { inputFile: string; threshold: number };\ntype _TestData = { selectedTab: string };\ntype _TestOutputs = {\n  result: ConfigRenderLambda<string>;\n  count: ConfigRenderLambda<number>;\n};\n\n// Test: Merge type works correctly\ntype _MergeTest1 = Expect<Equal<Merge<{ a: 1 }, { b: 2 }>, { a: 1; b: 2 }>>;\ntype _MergeTest2 = Expect<Equal<Merge<{ a: 1 }, { a: 2 }>, { a: 2 }>>;\ntype _MergeTest3 = Expect<Equal<Merge<{ a: 1; b: 1 }, { b: 2; c: 3 }>, { a: 1; b: 2; c: 3 }>>;\n\n// Test: create() returns a BlockModelV3 instance\n// Note: Due to function overloads, ReturnType uses the last overload signature.\n// We verify the structure is correct using a simpler assignability test.\ntype _CreateResult = ReturnType<typeof BlockModelV3.create>;\ntype _CreateIsBlockModelV3 =\n  _CreateResult extends BlockModelV3<infer _A, infer _O, infer _S> ? true : false;\ntype _CreateTest = Expect<_CreateIsBlockModelV3>;\n\n// Test: BlockModelV3Config interface structure\ntype _ConfigTest = Expect<\n  Equal<\n    BlockModelV3Config<_TestOutputs, _TestData>,\n    {\n      renderingMode: BlockRenderingMode;\n      argsFunction: ((data: unknown) => unknown) | undefined;\n      prerunArgsFunction: ((data: unknown) => unknown) | undefined;\n      dataModel: DataModel<_TestData>;\n      outputs: _TestOutputs;\n      sections: ConfigRenderLambda;\n      title: ConfigRenderLambda | undefined;\n      subtitle: ConfigRenderLambda | undefined;\n      tags: ConfigRenderLambda | undefined;\n      enrichmentTargets: ConfigRenderLambda | undefined;\n      featureFlags: BlockCodeKnownFeatureFlags;\n      plugins: {};\n    }\n  >\n>;\n\n// Test: Default Href is '/'\ntype _HrefDefaultTest =\n  BlockModelV3<_TestArgs, {}, _TestData> extends BlockModelV3<_TestArgs, {}, _TestData, \"/\">\n    ? true\n    : false;\ntype _VerifyHrefDefault = Expect<_HrefDefaultTest>;\n\n// Test: Custom Href can be specified\ntype _CustomHref = \"/settings\" | \"/main\";\ntype _HrefCustomBuilder = BlockModelV3<_TestArgs, {}, _TestData, _CustomHref>;\ntype _HrefCustomTest =\n  _HrefCustomBuilder extends BlockModelV3<_TestArgs, {}, _TestData, _CustomHref> ? true : false;\ntype _VerifyHrefCustom = Expect<_HrefCustomTest>;\n\n// Test: Output type accumulation with & intersection\ntype _OutputsAccumulation = { a: ConfigRenderLambda<string> } & {\n  b: ConfigRenderLambda<number>;\n};\ntype _VerifyOutputsHaveKeys = Expect<Equal<keyof _OutputsAccumulation, \"a\" | \"b\">>;\n\n// Test: Builder with all type parameters specified compiles\ntype _FullBuilder = BlockModelV3<_TestArgs, _TestOutputs, _TestData, \"/main\">;\ntype _FullBuilderTest =\n  _FullBuilder extends BlockModelV3<_TestArgs, _TestOutputs, _TestData, \"/main\"> ? true : false;\ntype _VerifyFullBuilder = Expect<_FullBuilderTest>;\n\n// Test: InferOutputsFromLambdas maps outputs correctly\ntype _InferOutputsTest = InferOutputsFromLambdas<{\n  myOutput: ConfigRenderLambda<number>;\n}>;\ntype _VerifyInferOutputs = Expect<\n  Equal<_InferOutputsTest, { myOutput: OutputWithStatus<number> & { __unwrap: true } }>\n>;\n"],"names":["BLOCK_STORAGE_FACADE_VERSION","createAndRegisterRenderLambda","BlockRenderCtx","mergeFeatureFlags","registerFacadeCallbacks","BlockStorageFacadeCallbacks","applyStorageUpdate","getStorageDebugView","migrateStorage","createInitialStorage","deriveArgsFromStorage","derivePrerunArgsFromStorage","pluginOutputKey","PluginRenderCtx","PlatformaSDKVersion","BlockStorageFacadeHandles","downgradeCfgOrLambda","isInUI","getPlatformaInstance","isConfigLambda"],"mappings":"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"}
+{"version":3,"file":"block_model.cjs","sources":["../src/block_model.ts"],"sourcesContent":["import type {\n  BlockRenderingMode,\n  BlockSection,\n  OutputWithStatus,\n  PlRef,\n  BlockCodeKnownFeatureFlags,\n  BlockConfigContainer,\n} from \"@milaboratories/pl-model-common\";\nimport { mergeFeatureFlags } from \"@milaboratories/pl-model-common\";\nimport { getPlatformaInstance, isInUI, createAndRegisterRenderLambda } from \"./internal\";\nimport type { DataModel } from \"./block_migrations\";\nimport type { PlatformaV3 } from \"./platforma\";\nimport type { InferRenderFunctionReturn, RenderFunction } from \"./render\";\nimport { BlockRenderCtx, PluginRenderCtx } from \"./render\";\nimport type { PluginData, PluginModel, PluginOutputs, PluginParams } from \"./plugin_model\";\nimport { type PluginHandle, pluginOutputKey } from \"./plugin_handle\";\nimport type { RenderCtxBase } from \"./render\";\nimport { PlatformaSDKVersion } from \"./version\";\nimport {\n  applyStorageUpdate,\n  getStorageDebugView,\n  migrateStorage,\n  createInitialStorage,\n  deriveArgsFromStorage,\n  derivePrerunArgsFromStorage,\n} from \"./block_storage_callbacks\";\nimport { type PluginName } from \"./block_storage\";\nimport type {\n  ConfigRenderLambda,\n  DeriveHref,\n  ConfigRenderLambdaFlags,\n  InferOutputsFromLambdas,\n} from \"./bconfig\";\nimport { downgradeCfgOrLambda, isConfigLambda } from \"./bconfig\";\nimport type { PlatformaExtended } from \"./platforma\";\nimport {\n  BLOCK_STORAGE_FACADE_VERSION,\n  BlockStorageFacadeCallbacks,\n  BlockStorageFacadeHandles,\n  registerFacadeCallbacks,\n} from \"./block_storage_facade\";\n\ntype SectionsExpectedType = readonly BlockSection[];\n\ntype NoOb = Record<string, never>;\n\n/**\n * Per-property lambdas for deriving plugin params from block render context.\n * Each property is a function that receives the block's RenderCtxBase and returns the param value.\n */\nexport type ParamsInput<Params, BArgs = unknown, BData = unknown> = {\n  [K in keyof Params]: (ctx: RenderCtxBase<BArgs, BData>) => Params[K];\n};\n\n/**\n * Type-erased version of ParamsInput for internal storage.\n */\ntype ParamsInputErased = Record<string, (ctx: RenderCtxBase) => unknown>;\n\n/**\n * Registered plugin: model + param derivation lambdas.\n * Type parameters are carried by PluginModel generic.\n */\nexport type PluginInstance<\n  Data extends PluginData = PluginData,\n  Params extends PluginParams = undefined,\n  Outputs extends PluginOutputs = PluginOutputs,\n> = {\n  readonly model: PluginModel<Data, Params, Outputs>;\n  readonly inputs: ParamsInputErased;\n};\n\ninterface BlockModelV3Config<\n  OutputsCfg extends Record<string, ConfigRenderLambda>,\n  Data,\n  Plugins extends Record<string, PluginInstance> = {},\n> {\n  renderingMode: BlockRenderingMode;\n  dataModel: DataModel<Data>;\n  outputs: OutputsCfg;\n  sections: ConfigRenderLambda;\n  title: ConfigRenderLambda | undefined;\n  subtitle: ConfigRenderLambda | undefined;\n  tags: ConfigRenderLambda | undefined;\n  enrichmentTargets: ConfigRenderLambda | undefined;\n  featureFlags: BlockCodeKnownFeatureFlags;\n  argsFunction: ((data: unknown) => unknown) | undefined;\n  prerunArgsFunction: ((data: unknown) => unknown) | undefined;\n  plugins: Plugins;\n}\n\n/** Main entry point that each block should use in it's \"config\" module. Don't forget\n * to call {@link done()} at the end of configuration. Value returned by this builder must be\n * exported as constant with name \"platforma\" from the \"config\" module.\n * API version is 3 (for UI) and 2 (for model) */\nexport class BlockModelV3<\n  Args,\n  OutputsCfg extends Record<string, ConfigRenderLambda>,\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Href extends `/${string}` = \"/\",\n  Plugins extends Record<string, PluginInstance> = {},\n> {\n  private constructor(private readonly config: BlockModelV3Config<OutputsCfg, Data, Plugins>) {}\n\n  public static readonly INITIAL_BLOCK_FEATURE_FLAGS: BlockCodeKnownFeatureFlags = {\n    supportsLazyState: true,\n    requiresUIAPIVersion: 3,\n    requiresModelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n    requiresCreatePTable: 2,\n  };\n\n  /**\n   * Creates a new BlockModelV3 builder with the specified data model.\n   *\n   * @example\n   * const dataModel = new DataModelBuilder()\n   *   .from<BlockData>(\"v1\")\n   *   .init(() => ({ numbers: [], labels: [] }));\n   *\n   * BlockModelV3.create(dataModel)\n   *   .args((data) => ({ numbers: data.numbers }))\n   *   .sections(() => [{ type: 'link', href: '/', label: 'Main' }])\n   *   .done();\n   *\n   * @param dataModel The data model that defines initial data and migrations\n   */\n  public static create<Data extends Record<string, unknown>>(\n    dataModel: DataModel<Data>,\n  ): BlockModelV3<NoOb, {}, Data> {\n    return new BlockModelV3<NoOb, {}, Data>({\n      renderingMode: \"Heavy\",\n      dataModel,\n      outputs: {},\n      sections: createAndRegisterRenderLambda({ handle: \"sections\", lambda: () => [] }, true),\n      title: undefined,\n      subtitle: undefined,\n      tags: undefined,\n      enrichmentTargets: undefined,\n      featureFlags: { ...BlockModelV3.INITIAL_BLOCK_FEATURE_FLAGS },\n      argsFunction: undefined,\n      prerunArgsFunction: undefined,\n      plugins: {},\n    });\n  }\n\n  /**\n   * Add output cell wrapped with additional status information to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunction<Args, Data, unknown>>(\n    key: Key,\n    rf: RF,\n    flags: ConfigRenderLambdaFlags & { withStatus: true },\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> & {\n        withStatus: true;\n      };\n    },\n    Data,\n    Href,\n    Plugins\n  >;\n  /**\n   * Add output cell to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunction<Args, Data, unknown>>(\n    key: Key,\n    rf: RF,\n    flags?: ConfigRenderLambdaFlags,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>>;\n    },\n    Data,\n    Href,\n    Plugins\n  >;\n  public output(\n    key: string,\n    cfgOrRf: RenderFunction<Args, Data, unknown>,\n    flags: ConfigRenderLambdaFlags = {},\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3({\n      ...this.config,\n      outputs: {\n        ...this.config.outputs,\n        [key]: createAndRegisterRenderLambda({\n          handle: `block-output#${key}`,\n          lambda: () => cfgOrRf(new BlockRenderCtx<Args, Data>()),\n          ...flags,\n        }),\n      },\n    });\n  }\n\n  /** Shortcut for {@link output} with retentive flag set to true. */\n  public retentiveOutput<\n    const Key extends string,\n    const RF extends RenderFunction<Args, Data, unknown>,\n  >(\n    key: Key,\n    rf: RF,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>>;\n    },\n    Data,\n    Href,\n    Plugins\n  > {\n    return this.output(key, rf, { retentive: true });\n  }\n\n  /** Shortcut for {@link output} with withStatus flag set to true. */\n  public outputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunction<Args, Data, unknown>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { withStatus: true });\n  }\n\n  /**\n   * Sets a function to derive block args from data.\n   * This is called during setData to compute the args that will be used for block execution.\n   *\n   * @example\n   * .args<BlockArgs>((data) => ({ numbers: data.numbers }))\n   *\n   * @example\n   * .args<BlockArgs>((data) => {\n   *   if (data.numbers.length === 0) throw new Error('Numbers required'); // block not ready\n   *   return { numbers: data.numbers };\n   * })\n   */\n  public args<Args>(\n    lambda: (data: Data) => Args,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      argsFunction: lambda as (data: unknown) => unknown,\n    });\n  }\n\n  /**\n   * Sets a function to derive pre-run args from data (optional).\n   * This is called during setData to compute the args that will be used for staging/pre-run phase.\n   *\n   * If not defined, defaults to using the args() function result.\n   * If defined, uses its return value for the staging / prerun phase.\n   *\n   * The staging / prerun phase runs only if currentPrerunArgs differs from the executed\n   * version of prerunArgs (same comparison logic as currentArgs vs prodArgs).\n   *\n   * @example\n   * .prerunArgs((data) => ({ numbers: data.numbers }))\n   *\n   * @example\n   * .prerunArgs((data) => {\n   *   // Return undefined to skip staging for this block\n   *   if (!data.isReady) return undefined;\n   *   return { numbers: data.numbers };\n   * })\n   */\n  public prerunArgs(\n    fn: (data: Data) => unknown,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      prerunArgsFunction: fn as (data: unknown) => unknown,\n    });\n  }\n\n  /** Sets the lambda to generate list of sections in the left block overviews panel. */\n  public sections<\n    const Ret extends SectionsExpectedType,\n    const RF extends RenderFunction<Args, Data, Ret>,\n  >(rf: RF): BlockModelV3<Args, OutputsCfg, Data, DeriveHref<ReturnType<RF>>, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, DeriveHref<ReturnType<RF>>, Plugins>({\n      ...this.config,\n      // Replace the default sections callback with the user-provided one\n      sections: createAndRegisterRenderLambda(\n        { handle: \"sections\", lambda: () => rf(new BlockRenderCtx<Args, Data>()) },\n        true,\n      ),\n    });\n  }\n\n  /** Sets a rendering function to derive block title, shown for the block in the left blocks-overview panel. */\n  public title(\n    rf: RenderFunction<Args, Data, string>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      title: createAndRegisterRenderLambda({\n        handle: \"title\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  public subtitle(\n    rf: RenderFunction<Args, Data, string>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      subtitle: createAndRegisterRenderLambda({\n        handle: \"subtitle\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  public tags(\n    rf: RenderFunction<Args, Data, string[]>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      tags: createAndRegisterRenderLambda({\n        handle: \"tags\",\n        lambda: () => rf(new BlockRenderCtx<Args, Data>()),\n      }),\n    });\n  }\n\n  /** Sets or overrides feature flags for the block. */\n  public withFeatureFlags(\n    flags: Partial<BlockCodeKnownFeatureFlags>,\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      featureFlags: { ...this.config.featureFlags, ...flags },\n    });\n  }\n\n  /**\n   * Defines how to derive list of upstream references this block is meant to enrich with its exports from block args.\n   * Influences dependency graph construction.\n   */\n  public enriches(\n    lambda: (args: Args) => PlRef[],\n  ): BlockModelV3<Args, OutputsCfg, Data, Href, Plugins> {\n    return new BlockModelV3<Args, OutputsCfg, Data, Href, Plugins>({\n      ...this.config,\n      enrichmentTargets: createAndRegisterRenderLambda({\n        handle: \"enrichmentTargets\",\n        lambda: lambda,\n      }),\n    });\n  }\n\n  /**\n   * Registers a plugin instance with the block.\n   *\n   * Plugins are UI components with their own model logic and persistent state.\n   * Each plugin must have a unique pluginId within the block.\n   *\n   * @param pluginId - Unique identifier for this plugin instance within the block\n   * @param plugin - Configured PluginModel instance (created via factory.create(config))\n   * @param params - Per-property lambdas deriving plugin params from block RenderCtx\n   *\n   * @example\n   * .plugin('mainTable', dataTablePlugin.create({ defaultOps: {...} }), {\n   *   columns: (ctx) => ctx.outputs?.resolve(\"data\")?.getPColumns(),\n   *   sourceId: (ctx) => ctx.data.selectedSource,\n   * })\n   */\n  public plugin<\n    const PluginId extends string,\n    PData extends PluginData,\n    PParams extends PluginParams,\n    POutputs extends PluginOutputs,\n  >(\n    pluginId: PluginId,\n    plugin: PluginModel<PData, PParams, POutputs>,\n    params?: ParamsInput<PParams, Args, Data>,\n  ): BlockModelV3<\n    Args,\n    OutputsCfg,\n    Data,\n    Href,\n    Plugins & { [K in PluginId]: PluginInstance<PData, PParams, POutputs> }\n  > {\n    // Validate pluginId uniqueness\n    if (pluginId in this.config.plugins) {\n      throw new Error(`Plugin '${pluginId}' already registered`);\n    }\n\n    const instance: PluginInstance<PData, PParams, POutputs> = {\n      model: plugin,\n      inputs: (params ?? {}) as ParamsInputErased,\n    };\n\n    return new BlockModelV3({\n      ...this.config,\n      plugins: {\n        ...this.config.plugins,\n        [pluginId]: instance,\n      },\n      featureFlags: mergeFeatureFlags(this.config.featureFlags, plugin.featureFlags ?? {}),\n    });\n  }\n\n  /** Renders all provided block settings into a pre-configured platforma API\n   * instance, that can be used in frontend to interact with block data, and\n   * other features provided by the platforma to the block. */\n  public done(): PlatformaExtended<\n    PlatformaV3<Data, Args, InferOutputsFromLambdas<OutputsCfg>, Href, Plugins>\n  > {\n    return this.withFeatureFlags({\n      ...this.config.featureFlags,\n    })._done();\n  }\n\n  public _done(): PlatformaExtended<\n    PlatformaV3<Data, Args, InferOutputsFromLambdas<OutputsCfg>, Href, Plugins>\n  > {\n    if (this.config.argsFunction === undefined) throw new Error(\"Args rendering function not set.\");\n\n    const apiVersion = 3;\n\n    // Build plugin registry\n    const { plugins } = this.config;\n    const pluginRegistry: Record<string, PluginName> = {};\n    const pluginHandles = Object.keys(plugins) as PluginHandle[];\n    for (const handle of pluginHandles) {\n      pluginRegistry[handle] = plugins[handle].model.name;\n    }\n\n    const { dataModel, argsFunction, prerunArgsFunction } = this.config;\n\n    function getPlugin(handle: PluginHandle): PluginInstance {\n      const plugin = plugins[handle];\n      if (!plugin) throw new Error(`Plugin model not found for '${handle}'`);\n      return plugin;\n    }\n\n    // Register ALL facade callbacks here, with dependencies captured via closures\n    registerFacadeCallbacks({\n      [BlockStorageFacadeCallbacks.StorageApplyUpdate]: applyStorageUpdate,\n      [BlockStorageFacadeCallbacks.StorageDebugView]: getStorageDebugView,\n      [BlockStorageFacadeCallbacks.StorageMigrate]: (currentStorageJson) =>\n        migrateStorage(currentStorageJson, {\n          migrateBlockData: (v) => dataModel.migrate(v),\n          getPluginRegistry: () => pluginRegistry,\n          migratePluginData: (handle, v) => getPlugin(handle).model.dataModel.migrate(v),\n          createPluginData: (handle) => getPlugin(handle).model.dataModel.getDefaultData(),\n        }),\n      [BlockStorageFacadeCallbacks.StorageInitial]: () =>\n        createInitialStorage({\n          getDefaultBlockData: () => dataModel.getDefaultData(),\n          getPluginRegistry: () => pluginRegistry,\n          createPluginData: (handle) => getPlugin(handle).model.dataModel.getDefaultData(),\n        }),\n      [BlockStorageFacadeCallbacks.ArgsDerive]: (storageJson) =>\n        deriveArgsFromStorage(storageJson, argsFunction),\n      [BlockStorageFacadeCallbacks.PrerunArgsDerive]: (storageJson) =>\n        derivePrerunArgsFromStorage(storageJson, argsFunction, prerunArgsFunction),\n    });\n\n    // Register plugin input and output lambdas\n    const pluginOutputs: Record<string, ConfigRenderLambda> = {};\n    for (const handle of pluginHandles) {\n      const { model, inputs } = plugins[handle];\n      // Wrap plugin param lambdas: close over BlockRenderCtx creation\n      const wrappedInputs: Record<string, () => unknown> = {};\n      for (const [paramKey, paramFn] of Object.entries(inputs)) {\n        wrappedInputs[paramKey] = () => paramFn(new BlockRenderCtx());\n      }\n\n      // Register plugin outputs (in config pack, evaluated by middle layer)\n      const outputs = model.outputs as Record<string, (ctx: PluginRenderCtx) => unknown>;\n      for (const [outputKey, outputFn] of Object.entries(outputs)) {\n        const key = pluginOutputKey(handle, outputKey);\n        pluginOutputs[key] = createAndRegisterRenderLambda({\n          handle: key,\n          lambda: () => outputFn(new PluginRenderCtx(handle, wrappedInputs)),\n        });\n      }\n    }\n    const allOutputs = { ...this.config.outputs, ...pluginOutputs };\n\n    const blockConfig: BlockConfigContainer = {\n      v4: {\n        configVersion: 4,\n        modelAPIVersion: BLOCK_STORAGE_FACADE_VERSION,\n        sdkVersion: PlatformaSDKVersion,\n        renderingMode: this.config.renderingMode,\n        sections: this.config.sections,\n        title: this.config.title,\n        subtitle: this.config.subtitle,\n        tags: this.config.tags,\n        outputs: allOutputs,\n        enrichmentTargets: this.config.enrichmentTargets,\n        featureFlags: this.config.featureFlags,\n        blockLifecycleCallbacks: { ...BlockStorageFacadeHandles },\n      },\n\n      // fields below are added to allow previous desktop versions read generated configs\n      sdkVersion: PlatformaSDKVersion,\n      renderingMode: this.config.renderingMode,\n      sections: this.config.sections,\n      outputs: Object.fromEntries(\n        Object.entries(this.config.outputs).map(([key, value]) => [\n          key,\n          downgradeCfgOrLambda(value),\n        ]),\n      ),\n    };\n\n    globalThis.platformaApiVersion = apiVersion;\n\n    if (!isInUI())\n      // we are in the configuration rendering routine, not in actual UI\n      return { config: blockConfig } as any;\n    // normal operation inside the UI\n    else\n      return {\n        ...getPlatformaInstance({\n          sdkVersion: PlatformaSDKVersion,\n          apiVersion,\n        }),\n        blockModelInfo: {\n          outputs: Object.fromEntries(\n            Object.entries(allOutputs).map(([key, value]) => [\n              key,\n              {\n                withStatus: Boolean(isConfigLambda(value) && value.withStatus),\n              },\n            ]),\n          ),\n          pluginIds: pluginHandles,\n        },\n      } as any;\n  }\n}\n\n// Type tests for BlockModelV3\n\nexport type Expect<T extends true> = T;\n\nexport type Equal<X, Y> =\n  (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;\n\nexport type Merge<A, B> = {\n  [K in keyof A | keyof B]: K extends keyof B ? B[K] : K extends keyof A ? A[K] : never;\n};\n\n// Helper types for testing\ntype _TestArgs = { inputFile: string; threshold: number };\ntype _TestData = { selectedTab: string };\ntype _TestOutputs = {\n  result: ConfigRenderLambda<string>;\n  count: ConfigRenderLambda<number>;\n};\n\n// Test: Merge type works correctly\ntype _MergeTest1 = Expect<Equal<Merge<{ a: 1 }, { b: 2 }>, { a: 1; b: 2 }>>;\ntype _MergeTest2 = Expect<Equal<Merge<{ a: 1 }, { a: 2 }>, { a: 2 }>>;\ntype _MergeTest3 = Expect<Equal<Merge<{ a: 1; b: 1 }, { b: 2; c: 3 }>, { a: 1; b: 2; c: 3 }>>;\n\n// Test: create() returns a BlockModelV3 instance\n// Note: Due to function overloads, ReturnType uses the last overload signature.\n// We verify the structure is correct using a simpler assignability test.\ntype _CreateResult = ReturnType<typeof BlockModelV3.create>;\ntype _CreateIsBlockModelV3 =\n  _CreateResult extends BlockModelV3<infer _A, infer _O, infer _S> ? true : false;\ntype _CreateTest = Expect<_CreateIsBlockModelV3>;\n\n// Test: BlockModelV3Config interface structure\ntype _ConfigTest = Expect<\n  Equal<\n    BlockModelV3Config<_TestOutputs, _TestData>,\n    {\n      renderingMode: BlockRenderingMode;\n      argsFunction: ((data: unknown) => unknown) | undefined;\n      prerunArgsFunction: ((data: unknown) => unknown) | undefined;\n      dataModel: DataModel<_TestData>;\n      outputs: _TestOutputs;\n      sections: ConfigRenderLambda;\n      title: ConfigRenderLambda | undefined;\n      subtitle: ConfigRenderLambda | undefined;\n      tags: ConfigRenderLambda | undefined;\n      enrichmentTargets: ConfigRenderLambda | undefined;\n      featureFlags: BlockCodeKnownFeatureFlags;\n      plugins: {};\n    }\n  >\n>;\n\n// Test: Default Href is '/'\ntype _HrefDefaultTest =\n  BlockModelV3<_TestArgs, {}, _TestData> extends BlockModelV3<_TestArgs, {}, _TestData, \"/\">\n    ? true\n    : false;\ntype _VerifyHrefDefault = Expect<_HrefDefaultTest>;\n\n// Test: Custom Href can be specified\ntype _CustomHref = \"/settings\" | \"/main\";\ntype _HrefCustomBuilder = BlockModelV3<_TestArgs, {}, _TestData, _CustomHref>;\ntype _HrefCustomTest =\n  _HrefCustomBuilder extends BlockModelV3<_TestArgs, {}, _TestData, _CustomHref> ? true : false;\ntype _VerifyHrefCustom = Expect<_HrefCustomTest>;\n\n// Test: Output type accumulation with & intersection\ntype _OutputsAccumulation = { a: ConfigRenderLambda<string> } & {\n  b: ConfigRenderLambda<number>;\n};\ntype _VerifyOutputsHaveKeys = Expect<Equal<keyof _OutputsAccumulation, \"a\" | \"b\">>;\n\n// Test: Builder with all type parameters specified compiles\ntype _FullBuilder = BlockModelV3<_TestArgs, _TestOutputs, _TestData, \"/main\">;\ntype _FullBuilderTest =\n  _FullBuilder extends BlockModelV3<_TestArgs, _TestOutputs, _TestData, \"/main\"> ? true : false;\ntype _VerifyFullBuilder = Expect<_FullBuilderTest>;\n\n// Test: InferOutputsFromLambdas maps outputs correctly\ntype _InferOutputsTest = InferOutputsFromLambdas<{\n  myOutput: ConfigRenderLambda<number>;\n}>;\ntype _VerifyInferOutputs = Expect<\n  Equal<_InferOutputsTest, { myOutput: OutputWithStatus<number> & { __unwrap: true } }>\n>;\n"],"names":["BLOCK_STORAGE_FACADE_VERSION","createAndRegisterRenderLambda","BlockRenderCtx","mergeFeatureFlags","registerFacadeCallbacks","BlockStorageFacadeCallbacks","applyStorageUpdate","getStorageDebugView","migrateStorage","createInitialStorage","deriveArgsFromStorage","derivePrerunArgsFromStorage","pluginOutputKey","PluginRenderCtx","PlatformaSDKVersion","BlockStorageFacadeHandles","downgradeCfgOrLambda","isInUI","getPlatformaInstance","isConfigLambda"],"mappings":"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"}

package/dist/block_model.d.ts

@@ -40,7 +40,7 @@ export declare class BlockModelV3<Args, OutputsCfg extends Record<string, Config
      *
      * @example
      * const dataModel = new DataModelBuilder()
-     *   .from<BlockData>(DATA_MODEL_DEFAULT_VERSION)
+     *   .from<BlockData>("v1")
      *   .init(() => ({ numbers: [], labels: [] }));
      *
      * BlockModelV3.create(dataModel)

package/dist/block_model.js

@@ -30,7 +30,7 @@ class BlockModelV3 {
      *
      * @example
      * const dataModel = new DataModelBuilder()
-     *   .from<BlockData>(DATA_MODEL_DEFAULT_VERSION)
+     *   .from<BlockData>("v1")
      *   .init(() => ({ numbers: [], labels: [] }));
      *
      * BlockModelV3.create(dataModel)