@milaboratories/pl-middle-layer 1.48.11 → 1.48.13

package/dist/mutator/project.cjs

@@ -1,1254 +1,917 @@
-'use strict';
-
-var plClient = require('@milaboratories/pl-client');
-var render_block = require('./template/render_block.cjs');
-var project_model = require('../model/project_model.cjs');
-var block_pack = require('./block-pack/block_pack.cjs');
-var project_model_util = require('../model/project_model_util.cjs');
-var plModelMiddleLayer = require('@milaboratories/pl-model-middle-layer');
-var Denque = require('denque');
-var context_export = require('./context_export.cjs');
-var template_loading = require('./template/template_loading.cjs');
-var tsHelpers = require('@milaboratories/ts-helpers');
-var model = require('@platforma-sdk/model');
-var index = require('../debug/index.cjs');
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_project_model = require('../model/project_model.cjs');
+const require_render_block = require('./template/render_block.cjs');
+const require_template_loading = require('./template/template_loading.cjs');
+const require_block_pack = require('./block-pack/block_pack.cjs');
+const require_project_model_util = require('../model/project_model_util.cjs');
+const require_context_export = require('./context_export.cjs');
+const require_index = require('../debug/index.cjs');
+let _platforma_sdk_model = require("@platforma-sdk/model");
+let _milaboratories_pl_model_middle_layer = require("@milaboratories/pl-model-middle-layer");
+let _milaboratories_ts_helpers = require("@milaboratories/ts-helpers");
+let _milaboratories_pl_client = require("@milaboratories/pl-client");
+let denque = require("denque");
+denque = require_runtime.__toESM(denque);
 
+//#region src/mutator/project.ts
 function cached(modIdCb, valueCb) {
-    let initialized = false;
-    let lastModId = undefined;
-    let value = undefined;
-    return () => {
-        if (!initialized) {
-            initialized = true;
-            lastModId = modIdCb();
-            value = valueCb();
-            return value;
-        }
-        const currentModId = modIdCb();
-        if (lastModId !== currentModId) {
-            lastModId = currentModId;
-            value = valueCb();
-        }
-        return valueCb();
-    };
-}
-class BlockInfo {
-    id;
-    fields;
-    config;
-    source;
-    constructor(id, fields, config, source) {
-        this.id = id;
-        this.fields = fields;
-        this.config = config;
-        this.source = source;
-    }
-    check() {
-        // state assertions
-        if ((this.fields.prodOutput === undefined) !== (this.fields.prodCtx === undefined))
-            throw new Error("inconsistent prod fields");
-        if ((this.fields.stagingOutput === undefined) !== (this.fields.stagingCtx === undefined))
-            throw new Error("inconsistent stage fields");
-        if ((this.fields.prodOutputPrevious === undefined) !==
-            (this.fields.prodCtxPrevious === undefined))
-            throw new Error("inconsistent prod cache fields");
-        if ((this.fields.stagingOutputPrevious === undefined) !==
-            (this.fields.stagingCtxPrevious === undefined))
-            throw new Error("inconsistent stage cache fields");
-        if (this.fields.blockPack === undefined)
-            throw new Error("no block pack field");
-        if (this.fields.blockStorage === undefined)
-            throw new Error("no block storage field");
-    }
-    currentArgsC = cached(() => this.fields.currentArgs?.modCount, () => {
-        const bin = this.fields.currentArgs?.value;
-        if (bin === undefined)
-            return undefined;
-        return tsHelpers.cachedDeserialize(bin);
-    });
-    blockStorageC = cached(() => this.fields.blockStorage.modCount, () => {
-        const bin = this.fields.blockStorage?.value;
-        if (bin === undefined)
-            return undefined;
-        return tsHelpers.cachedDeserialize(bin);
-    });
-    blockStorageJ = cached(() => this.fields.blockStorage.modCount, () => {
-        const bin = this.fields.blockStorage?.value;
-        if (bin === undefined)
-            return undefined;
-        return tsHelpers.cachedDecode(bin);
-    });
-    prodArgsC = cached(() => this.fields.prodArgs?.modCount, () => {
-        const bin = this.fields.prodArgs?.value;
-        if (bin === undefined)
-            return undefined;
-        return tsHelpers.cachedDeserialize(bin);
-    });
-    currentPrerunArgsC = cached(() => this.fields.currentPrerunArgs?.modCount, () => {
-        const bin = this.fields.currentPrerunArgs?.value;
-        if (bin === undefined)
-            return undefined;
-        return tsHelpers.cachedDeserialize(bin);
-    });
-    get currentArgs() {
-        return this.currentArgsC();
-    }
-    get blockStorage() {
-        try {
-            return this.blockStorageC();
-        }
-        catch (e) {
-            console.error("Error getting blockStorage:", e);
-            return undefined;
-        }
-    }
-    get blockStorageJson() {
-        return this.blockStorageJ();
-    }
-    get currentPrerunArgs() {
-        return this.currentPrerunArgsC();
-    }
-    get stagingRendered() {
-        return this.fields.stagingCtx !== undefined;
-    }
-    get productionRendered() {
-        return this.fields.prodCtx !== undefined;
-    }
-    get productionHasErrors() {
-        return this.fields.prodUiCtx?.status === "Error";
-    }
-    productionStaleC = cached(() => `${this.fields.currentArgs.modCount}_${this.fields.prodArgs?.modCount}`, () => this.fields.prodArgs === undefined ||
-        Buffer.compare(this.fields.currentArgs.value, this.fields.prodArgs.value) !== 0);
-    get requireProductionRendering() {
-        return !this.productionRendered || this.productionStaleC() || this.productionHasErrors;
-    }
-    /** Returns true if staging should be re-rendered (stagingCtx is not set) */
-    get requireStagingRendering() {
-        // No staging needed if currentPrerunArgs is undefined (args derivation failed)
-        if (this.fields.currentPrerunArgs === undefined)
-            return false;
-        return !this.stagingRendered;
-    }
-    get prodArgs() {
-        return this.prodArgsC();
-    }
-    getTemplate(tx) {
-        return tx.getFutureFieldValue(plClient.Pl.unwrapHolder(tx, this.fields.blockPack.ref), block_pack.BlockPackTemplateField, "Input");
-    }
+	let initialized = false;
+	let lastModId = void 0;
+	let value = void 0;
+	return () => {
+		if (!initialized) {
+			initialized = true;
+			lastModId = modIdCb();
+			value = valueCb();
+			return value;
+		}
+		const currentModId = modIdCb();
+		if (lastModId !== currentModId) {
+			lastModId = currentModId;
+			value = valueCb();
+		}
+		return valueCb();
+	};
 }
+var BlockInfo = class {
+	constructor(id, fields, config, source) {
+		this.id = id;
+		this.fields = fields;
+		this.config = config;
+		this.source = source;
+	}
+	check() {
+		if (this.fields.prodOutput === void 0 !== (this.fields.prodCtx === void 0)) throw new Error("inconsistent prod fields");
+		if (this.fields.stagingOutput === void 0 !== (this.fields.stagingCtx === void 0)) throw new Error("inconsistent stage fields");
+		if (this.fields.prodOutputPrevious === void 0 !== (this.fields.prodCtxPrevious === void 0)) throw new Error("inconsistent prod cache fields");
+		if (this.fields.stagingOutputPrevious === void 0 !== (this.fields.stagingCtxPrevious === void 0)) throw new Error("inconsistent stage cache fields");
+		if (this.fields.blockPack === void 0) throw new Error("no block pack field");
+		if (this.fields.blockStorage === void 0) throw new Error("no block storage field");
+	}
+	currentArgsC = cached(() => this.fields.currentArgs?.modCount, () => {
+		const bin = this.fields.currentArgs?.value;
+		if (bin === void 0) return void 0;
+		return (0, _milaboratories_ts_helpers.cachedDeserialize)(bin);
+	});
+	blockStorageC = cached(() => this.fields.blockStorage.modCount, () => {
+		const bin = this.fields.blockStorage?.value;
+		if (bin === void 0) return void 0;
+		return (0, _milaboratories_ts_helpers.cachedDeserialize)(bin);
+	});
+	blockStorageJ = cached(() => this.fields.blockStorage.modCount, () => {
+		const bin = this.fields.blockStorage?.value;
+		if (bin === void 0) return void 0;
+		return (0, _milaboratories_ts_helpers.cachedDecode)(bin);
+	});
+	prodArgsC = cached(() => this.fields.prodArgs?.modCount, () => {
+		const bin = this.fields.prodArgs?.value;
+		if (bin === void 0) return void 0;
+		return (0, _milaboratories_ts_helpers.cachedDeserialize)(bin);
+	});
+	currentPrerunArgsC = cached(() => this.fields.currentPrerunArgs?.modCount, () => {
+		const bin = this.fields.currentPrerunArgs?.value;
+		if (bin === void 0) return void 0;
+		return (0, _milaboratories_ts_helpers.cachedDeserialize)(bin);
+	});
+	get currentArgs() {
+		return this.currentArgsC();
+	}
+	get blockStorage() {
+		try {
+			return this.blockStorageC();
+		} catch (e) {
+			console.error("Error getting blockStorage:", e);
+			return;
+		}
+	}
+	get blockStorageJson() {
+		return this.blockStorageJ();
+	}
+	get currentPrerunArgs() {
+		return this.currentPrerunArgsC();
+	}
+	get stagingRendered() {
+		return this.fields.stagingCtx !== void 0;
+	}
+	get productionRendered() {
+		return this.fields.prodCtx !== void 0;
+	}
+	get productionHasErrors() {
+		return this.fields.prodUiCtx?.status === "Error";
+	}
+	productionStaleC = cached(() => `${this.fields.currentArgs.modCount}_${this.fields.prodArgs?.modCount}`, () => this.fields.prodArgs === void 0 || Buffer.compare(this.fields.currentArgs.value, this.fields.prodArgs.value) !== 0);
+	get requireProductionRendering() {
+		return !this.productionRendered || this.productionStaleC() || this.productionHasErrors;
+	}
+	/** Returns true if staging should be re-rendered (stagingCtx is not set) */
+	get requireStagingRendering() {
+		if (this.fields.currentPrerunArgs === void 0) return false;
+		return !this.stagingRendered;
+	}
+	get prodArgs() {
+		return this.prodArgsC();
+	}
+	getTemplate(tx) {
+		return tx.getFutureFieldValue(_milaboratories_pl_client.Pl.unwrapHolder(tx, this.fields.blockPack.ref), require_block_pack.BlockPackTemplateField, "Input");
+	}
+};
 const NoNewBlocks = (blockId) => {
-    throw new Error(`No new block info for ${blockId}`);
+	throw new Error(`No new block info for ${blockId}`);
 };
-class ProjectMutator {
-    rid;
-    tx;
-    author;
-    schema;
-    lastModified;
-    meta;
-    struct;
-    renderingState;
-    blocksInLimbo;
-    blockInfos;
-    ctxExportTplHolder;
-    projectHelper;
-    globalModCount = 0;
-    fieldsChanged = false;
-    //
-    // Change trackers
-    //
-    lastModifiedChanged = false;
-    structureChanged = false;
-    metaChanged = false;
-    renderingStateChanged = false;
-    /** Set blocks will be assigned current mutator author marker on save */
-    blocksWithChangedInputs = new Set();
-    constructor(rid, tx, author, schema, lastModified, meta, struct, renderingState, blocksInLimbo, blockInfos, ctxExportTplHolder, projectHelper) {
-        this.rid = rid;
-        this.tx = tx;
-        this.author = author;
-        this.schema = schema;
-        this.lastModified = lastModified;
-        this.meta = meta;
-        this.struct = struct;
-        this.renderingState = renderingState;
-        this.blocksInLimbo = blocksInLimbo;
-        this.blockInfos = blockInfos;
-        this.ctxExportTplHolder = ctxExportTplHolder;
-        this.projectHelper = projectHelper;
-    }
-    fixProblemsAndMigrate() {
-        // Fixing problems introduced by old code
-        this.blockInfos.forEach((blockInfo) => {
-            if (blockInfo.fields.prodArgs === undefined ||
-                blockInfo.fields.prodOutput === undefined ||
-                blockInfo.fields.prodCtx === undefined)
-                this.deleteBlockFields(blockInfo.id, "prodArgs", "prodOutput", "prodCtx");
-        });
-        // Migration for addition of block settings field
-        let initialBlockSettings;
-        this.blockInfos.forEach((blockInfo) => {
-            if (blockInfo.fields.blockSettings === undefined) {
-                if (initialBlockSettings === undefined)
-                    initialBlockSettings = this.createJsonFieldValue(plModelMiddleLayer.InitialBlockSettings);
-                this.setBlockFieldObj(blockInfo.id, "blockSettings", initialBlockSettings);
-            }
-        });
-    }
-    get wasModified() {
-        return (this.lastModifiedChanged ||
-            this.structureChanged ||
-            this.fieldsChanged ||
-            this.metaChanged ||
-            this.renderingStateChanged);
-    }
-    get structure() {
-        return JSON.parse(JSON.stringify(this.struct));
-    }
-    //
-    // Graph calculation
-    //
-    stagingGraph = undefined;
-    pendingProductionGraph = undefined;
-    actualProductionGraph = undefined;
-    getStagingGraph() {
-        if (this.stagingGraph === undefined)
-            this.stagingGraph = project_model_util.stagingGraph(this.struct);
-        return this.stagingGraph;
-    }
-    getProductionGraphBlockInfo(blockId, prod) {
-        const bInfo = this.getBlockInfo(blockId);
-        let argsField;
-        let args;
-        if (prod) {
-            if (bInfo.fields.prodArgs === undefined)
-                return undefined;
-            argsField = bInfo.fields.prodArgs;
-            args = bInfo.prodArgs;
-        }
-        else {
-            argsField = bInfo.fields.currentArgs;
-            args = bInfo.currentArgs;
-        }
-        // Can't compute enrichment targets without args
-        if (argsField === undefined) {
-            return { args, enrichmentTargets: undefined };
-        }
-        const blockPackField = tsHelpers.notEmpty(bInfo.fields.blockPack);
-        if (plClient.isResourceId(argsField.ref) && plClient.isResourceId(blockPackField.ref))
-            return {
-                args,
-                enrichmentTargets: this.projectHelper.getEnrichmentTargets(() => bInfo.config, () => args, { argsRid: argsField.ref, blockPackRid: blockPackField.ref }),
-            };
-        else
-            return {
-                args,
-                enrichmentTargets: this.projectHelper.getEnrichmentTargets(() => bInfo.config, () => args),
-            };
-    }
-    getPendingProductionGraph() {
-        if (this.pendingProductionGraph === undefined)
-            this.pendingProductionGraph = project_model_util.productionGraph(this.struct, (blockId) => this.getProductionGraphBlockInfo(blockId, false));
-        return this.pendingProductionGraph;
-    }
-    getActualProductionGraph() {
-        if (this.actualProductionGraph === undefined)
-            this.actualProductionGraph = project_model_util.productionGraph(this.struct, (blockId) => this.getProductionGraphBlockInfo(blockId, true));
-        return this.actualProductionGraph;
-    }
-    //
-    // Generic helpers to interact with project state
-    //
-    getBlockInfo(blockId) {
-        const info = this.blockInfos.get(blockId);
-        if (info === undefined)
-            throw new Error(`No such block: ${blockId}`);
-        return info;
-    }
-    createJsonFieldValueByContent(content) {
-        if (content === undefined)
-            throw new Error("content is undefined");
-        const value = Buffer.from(content);
-        const ref = this.tx.createValue(plClient.Pl.JsonObject, value);
-        return { ref, value, status: "Ready" };
-    }
-    createJsonFieldValue(obj) {
-        return this.createJsonFieldValueByContent(JSON.stringify(obj));
-    }
-    getBlock(blockId) {
-        for (const block of project_model_util.allBlocks(this.struct))
-            if (block.id === blockId)
-                return block;
-        throw new Error("block not found");
-    }
-    setBlockFieldObj(blockId, fieldName, state) {
-        const fid = plClient.field(this.rid, project_model.projectFieldName(blockId, fieldName));
-        if (state.ref === undefined)
-            throw new Error("Can't set value with empty ref");
-        if (this.getBlockInfo(blockId).fields[fieldName] === undefined)
-            this.tx.createField(fid, "Dynamic", state.ref);
-        else
-            this.tx.setField(fid, state.ref);
-        this.getBlockInfo(blockId).fields[fieldName] = {
-            modCount: this.globalModCount++,
-            ...state,
-        };
-        this.fieldsChanged = true;
-    }
-    setBlockField(blockId, fieldName, ref, status, value) {
-        this.setBlockFieldObj(blockId, fieldName, { ref, status, value });
-    }
-    deleteBlockFields(blockId, ...fieldNames) {
-        let deleted = false;
-        const info = this.getBlockInfo(blockId);
-        for (const fieldName of fieldNames) {
-            const fields = info.fields;
-            if (!(fieldName in fields))
-                continue;
-            this.tx.removeField(plClient.field(this.rid, project_model.projectFieldName(blockId, fieldName)));
-            delete fields[fieldName];
-            this.fieldsChanged = true;
-            deleted = true;
-        }
-        return deleted;
-    }
-    updateLastModified() {
-        this.lastModified = Date.now();
-        this.lastModifiedChanged = true;
-    }
-    //
-    // Main project actions
-    //
-    resetStagingRefreshTimestamp() {
-        this.renderingState.stagingRefreshTimestamp = Date.now();
-        this.renderingStateChanged = true;
-    }
-    resetStaging(blockId) {
-        const fields = this.getBlockInfo(blockId).fields;
-        if (fields.stagingOutput?.status === "Ready" &&
-            fields.stagingCtx?.status === "Ready" &&
-            fields.stagingUiCtx?.status === "Ready") {
-            this.setBlockFieldObj(blockId, "stagingOutputPrevious", fields.stagingOutput);
-            this.setBlockFieldObj(blockId, "stagingCtxPrevious", fields.stagingCtx);
-            this.setBlockFieldObj(blockId, "stagingUiCtxPrevious", fields.stagingUiCtx);
-        }
-        if (this.deleteBlockFields(blockId, "stagingOutput", "stagingCtx", "stagingUiCtx"))
-            this.resetStagingRefreshTimestamp();
-    }
-    resetProduction(blockId) {
-        const fields = this.getBlockInfo(blockId).fields;
-        if (fields.prodOutput?.status === "Ready" &&
-            fields.prodCtx?.status === "Ready" &&
-            fields.prodUiCtx?.status === "Ready") {
-            this.setBlockFieldObj(blockId, "prodOutputPrevious", fields.prodOutput);
-            this.setBlockFieldObj(blockId, "prodCtxPrevious", fields.prodCtx);
-            this.setBlockFieldObj(blockId, "prodUiCtxPrevious", fields.prodUiCtx);
-        }
-        this.deleteBlockFields(blockId, "prodOutput", "prodCtx", "prodUiCtx", "prodArgs");
-    }
-    /** Running blocks are reset, already computed moved to limbo. Returns if
-     * either of the actions were actually performed.
-     * This method ensures the block is left in a consistent state that passes check() constraints. */
-    resetOrLimboProduction(blockId) {
-        const fields = this.getBlockInfo(blockId).fields;
-        // Check if we can safely move to limbo (both core production fields are ready)
-        if (fields.prodOutput?.status === "Ready" && fields.prodCtx?.status === "Ready") {
-            if (this.blocksInLimbo.has(blockId))
-                // we are already in limbo
-                return false;
-            // limbo - keep the ready production results but clean up cache
-            this.blocksInLimbo.add(blockId);
-            this.renderingStateChanged = true;
-            // doing some gc - clean up previous cache fields
-            this.deleteBlockFields(blockId, "prodOutputPrevious", "prodCtxPrevious", "prodUiCtxPrevious");
-            return true;
-        }
-        else {
-            // reset - clean up any partial/inconsistent production stat
-            return this.deleteBlockFields(blockId, "prodOutput", "prodCtx", "prodUiCtx", "prodArgs", "prodOutputPrevious", "prodCtxPrevious", "prodUiCtxPrevious");
-        }
-    }
-    /**
-     * Gets current block state and merges with partial updates.
-     * Used by legacy v1/v2 methods like setBlockArgs and setUiState.
-     *
-     * @param blockId The block to get state for
-     * @param partialUpdate Partial state to merge (e.g. { args } or { uiState })
-     * @returns Merged state in unified format { args, uiState }
-     */
-    mergeBlockState(blockId, partialUpdate) {
-        const info = this.getBlockInfo(blockId);
-        const currentState = info.blockStorage;
-        return { ...currentState, ...partialUpdate };
-    }
-    /**
-     * Sets raw block storage content directly (for testing purposes).
-     * This bypasses all normalization and VM transformations.
-     *
-     * @param blockId The block to set storage for
-     * @param rawStorageJson Raw storage as JSON string
-     */
-    setBlockStorageRaw(blockId, rawStorageJson) {
-        this.setBlockFieldObj(blockId, "blockStorage", this.createJsonFieldValueByContent(rawStorageJson));
-        this.blocksWithChangedInputs.add(blockId);
-        this.updateLastModified();
-    }
-    /**
-     * Resets a v2+ block to its initial storage state.
-     * Gets initial storage from VM and derives args from it.
-     *
-     * For v1 blocks, use setStates() instead.
-     *
-     * @param blockId The block to reset
-     */
-    resetToInitialStorage(blockId) {
-        const info = this.getBlockInfo(blockId);
-        const blockConfig = info.config;
-        if (blockConfig.modelAPIVersion !== model.BLOCK_STORAGE_FACADE_VERSION) {
-            throw new Error("resetToInitialStorage is only supported for model API version 2");
-        }
-        // Get initial storage from VM
-        const initialStorageJson = this.projectHelper.getInitialStorageInVM(blockConfig);
-        this.setBlockStorageRaw(blockId, initialStorageJson);
-        // Derive args from storage - set or clear currentArgs based on derivation result
-        const deriveArgsResult = this.projectHelper.deriveArgsFromStorage(blockConfig, initialStorageJson);
-        if (!deriveArgsResult.error) {
-            this.setBlockFieldObj(blockId, "currentArgs", this.createJsonFieldValue(deriveArgsResult.value));
-            // Derive prerunArgs from storage
-            const prerunArgs = this.projectHelper.derivePrerunArgsFromStorage(blockConfig, initialStorageJson);
-            if (prerunArgs !== undefined) {
-                this.setBlockFieldObj(blockId, "currentPrerunArgs", this.createJsonFieldValue(prerunArgs));
-            }
-        }
-        else {
-            this.deleteBlockFields(blockId, "currentArgs");
-        }
-    }
-    /** Optimally sets inputs for multiple blocks in one go */
-    setStates(requests) {
-        const changedArgs = [];
-        let somethingChanged = false;
-        for (const req of requests) {
-            const info = this.getBlockInfo(req.blockId);
-            let blockChanged = false;
-            const blockConfig = info.config;
-            // modelAPIVersion === 2 means BlockModelV3 with .args() lambda for deriving args
-            if (req.modelAPIVersion !== blockConfig.modelAPIVersion) {
-                throw new Error(`Model API version mismatch for block ${req.blockId}: ${req.modelAPIVersion} !== ${blockConfig.modelAPIVersion}`);
-            }
-            // Derive args from storage using the block's config.args() callback
-            let args;
-            let prerunArgs;
-            if (req.modelAPIVersion === model.BLOCK_STORAGE_FACADE_VERSION) {
-                const currentStorageJson = info.blockStorageJson;
-                if (currentStorageJson === undefined) {
-                    throw new Error(`Block ${req.blockId} has no blockStorage - this should not happen`);
-                }
-                // Apply the state update to storage
-                const updatedStorageJson = this.projectHelper.applyStorageUpdateInVM(blockConfig, currentStorageJson, req.payload);
-                this.setBlockFieldObj(req.blockId, "blockStorage", this.createJsonFieldValueByContent(updatedStorageJson));
-                // Derive args directly from storage (VM extracts data internally)
-                const derivedArgsResult = this.projectHelper.deriveArgsFromStorage(blockConfig, updatedStorageJson);
-                if (derivedArgsResult.error) {
-                    args = undefined;
-                    prerunArgs = undefined;
-                }
-                else {
-                    args = derivedArgsResult.value;
-                    // Derive prerunArgs from storage, or fall back to args
-                    prerunArgs = this.projectHelper.derivePrerunArgsFromStorage(blockConfig, updatedStorageJson);
-                }
-            }
-            else {
-                this.setBlockFieldObj(req.blockId, "blockStorage", this.createJsonFieldValue(req.state));
-                if (req.state !== null && typeof req.state === "object" && "args" in req.state) {
-                    args = req.state.args;
-                }
-                else {
-                    args = req.state;
-                }
-                // For the legacy blocks, prerunArgs = args (same as production args)
-                prerunArgs = args;
-            }
-            // Set or clear currentArgs based on derivation result
-            if (args !== undefined) {
-                const currentArgsData = tsHelpers.canonicalJsonBytes(args);
-                const argsPartRef = this.tx.createValue(plClient.Pl.JsonObject, currentArgsData);
-                this.setBlockField(req.blockId, "currentArgs", argsPartRef, "Ready", currentArgsData);
-            }
-            else {
-                this.deleteBlockFields(req.blockId, "currentArgs");
-            }
-            // Set currentPrerunArgs field and check if it actually changed
-            let prerunArgsChanged = false;
-            if (prerunArgs !== undefined) {
-                const prerunArgsData = tsHelpers.canonicalJsonBytes(prerunArgs);
-                const oldPrerunArgsData = info.fields.currentPrerunArgs?.value;
-                // Check if prerunArgs actually changed
-                if (oldPrerunArgsData === undefined ||
-                    Buffer.compare(oldPrerunArgsData, prerunArgsData) !== 0) {
-                    prerunArgsChanged = true;
-                }
-                const prerunArgsRef = this.tx.createValue(plClient.Pl.JsonObject, prerunArgsData);
-                this.setBlockField(req.blockId, "currentPrerunArgs", prerunArgsRef, "Ready", prerunArgsData);
-            }
-            else {
-                // prerunArgs is undefined - check if we previously had one
-                if (info.fields.currentPrerunArgs !== undefined) {
-                    prerunArgsChanged = true;
-                }
-            }
-            blockChanged = true;
-            // Only add to changedArgs if prerunArgs changed - this controls staging reset
-            if (prerunArgsChanged) {
-                changedArgs.push(req.blockId);
-            }
-            if (blockChanged) {
-                // will be assigned our author marker
-                this.blocksWithChangedInputs.add(req.blockId);
-                somethingChanged = true;
-            }
-        }
-        // resetting staging outputs for all downstream blocks
-        this.getStagingGraph().traverse("downstream", changedArgs, ({ id }) => this.resetStaging(id));
-        if (somethingChanged)
-            this.updateLastModified();
-    }
-    setBlockSettings(blockId, newValue) {
-        this.setBlockFieldObj(blockId, "blockSettings", this.createJsonFieldValue(newValue));
-        this.updateLastModified();
-    }
-    createProdCtx(upstream) {
-        const upstreamContexts = [];
-        upstream.forEach((id) => {
-            const info = this.getBlockInfo(id);
-            if (info.fields["prodCtx"]?.ref === undefined)
-                throw new Error("One of the upstreams staging is not rendered.");
-            upstreamContexts.push(plClient.Pl.unwrapHolder(this.tx, info.fields["prodCtx"].ref));
-        });
-        return render_block.createBContextFromUpstreams(this.tx, upstreamContexts);
-    }
-    createStagingCtx(upstream) {
-        const upstreamContexts = [];
-        upstream.forEach((id) => {
-            const info = this.getBlockInfo(id);
-            if (info.fields["stagingCtx"]?.ref === undefined)
-                throw new Error("One of the upstreams staging is not rendered.");
-            upstreamContexts.push(plClient.Pl.unwrapHolder(this.tx, info.fields["stagingCtx"].ref));
-            if (info.fields["prodCtx"]?.ref !== undefined)
-                upstreamContexts.push(plClient.Pl.unwrapHolder(this.tx, info.fields["prodCtx"].ref));
-        });
-        return render_block.createBContextFromUpstreams(this.tx, upstreamContexts);
-    }
-    exportCtx(ctx) {
-        return context_export.exportContext(this.tx, plClient.Pl.unwrapHolder(this.tx, this.ctxExportTplHolder), ctx);
-    }
-    /**
-     * Renders staging for a block using currentPrerunArgs.
-     * If currentPrerunArgs is not set (prerunArgs returned undefined), skips staging for this block.
-     */
-    renderStagingFor(blockId) {
-        this.resetStaging(blockId);
-        const info = this.getBlockInfo(blockId);
-        // If currentPrerunArgs is not set (prerunArgs returned undefined), skip staging for this block
-        const prerunArgsRef = info.fields.currentPrerunArgs?.ref;
-        if (prerunArgsRef === undefined) {
-            return;
-        }
-        const ctx = this.createStagingCtx(this.getStagingGraph().nodes.get(blockId).upstream);
-        if (this.getBlock(blockId).renderingMode !== "Heavy")
-            throw new Error("not supported yet");
-        const tpl = info.getTemplate(this.tx);
-        // Use currentPrerunArgs for staging rendering
-        const results = render_block.createRenderHeavyBlock(this.tx, tpl, {
-            args: prerunArgsRef,
-            blockId: this.tx.createValue(plClient.Pl.JsonString, JSON.stringify(blockId)),
-            isProduction: this.tx.createValue(plClient.Pl.JsonBool, JSON.stringify(false)),
-            context: ctx,
-        });
-        // Here we set the staging ctx to the input context of the staging workflow, not the output because exports
-        // of one staging context should stay within the same block, and not travel downstream.
-        // We may change this decision in the future if wanted to support traveling staging exports downstream.
-        this.setBlockField(blockId, "stagingCtx", plClient.Pl.wrapInEphHolder(this.tx, ctx), "NotReady");
-        // Yet the staging UI Ctx is the output context of the staging workflow, because it is used to form the result pool
-        // thus creating a certain discrepancy between staging workflow context behavior and desktop's result pool.
-        this.setBlockField(blockId, "stagingUiCtx", this.exportCtx(results.context), "NotReady");
-        this.setBlockField(blockId, "stagingOutput", results.result, "NotReady");
-    }
-    renderProductionFor(blockId) {
-        this.resetProduction(blockId);
-        const info = this.getBlockInfo(blockId);
-        // Can't render production if currentArgs is not set
-        if (info.fields.currentArgs === undefined) {
-            throw new Error(`Can't render production for block ${blockId}: currentArgs not set`);
-        }
-        const ctx = this.createProdCtx(this.getPendingProductionGraph().nodes.get(blockId).upstream);
-        if (this.getBlock(blockId).renderingMode === "Light")
-            throw new Error("Can't render production for light block.");
-        const tpl = info.getTemplate(this.tx);
-        const results = render_block.createRenderHeavyBlock(this.tx, tpl, {
-            args: info.fields.currentArgs.ref,
-            blockId: this.tx.createValue(plClient.Pl.JsonString, JSON.stringify(blockId)),
-            isProduction: this.tx.createValue(plClient.Pl.JsonBool, JSON.stringify(true)),
-            context: ctx,
-        });
-        this.setBlockField(blockId, "prodCtx", plClient.Pl.wrapInEphHolder(this.tx, results.context), "NotReady");
-        this.setBlockField(blockId, "prodUiCtx", this.exportCtx(results.context), "NotReady");
-        this.setBlockField(blockId, "prodOutput", results.result, "NotReady");
-        // saving inputs for which we rendered the production
-        this.setBlockFieldObj(blockId, "prodArgs", info.fields.currentArgs);
-        // removing block from limbo as we juts rendered fresh production for it
-        if (this.blocksInLimbo.delete(blockId))
-            this.renderingStateChanged = true;
-    }
-    //
-    // Structure changes
-    //
-    initializeNewBlock(blockId, spec) {
-        const info = new BlockInfo(blockId, {}, model.extractConfig(spec.blockPack.config), spec.blockPack.source);
-        this.blockInfos.set(blockId, info);
-        // block pack
-        const bp = block_pack.createBlockPack(this.tx, spec.blockPack);
-        this.setBlockField(blockId, "blockPack", plClient.Pl.wrapInHolder(this.tx, bp), "NotReady");
-        // settings
-        this.setBlockFieldObj(blockId, "blockSettings", this.createJsonFieldValue(plModelMiddleLayer.InitialBlockSettings));
-        const blockConfig = info.config;
-        let args;
-        let prerunArgs;
-        let storageToWrite;
-        if (spec.storageMode === "fromModel") {
-            // Model API v2+: get initial storage and derive args from it
-            storageToWrite = this.projectHelper.getInitialStorageInVM(blockConfig);
-            // Derive args directly from storage (VM extracts data internally)
-            const deriveArgsResult = this.projectHelper.deriveArgsFromStorage(blockConfig, storageToWrite);
-            if (deriveArgsResult.error) {
-                args = undefined;
-                prerunArgs = undefined;
-            }
-            else {
-                args = deriveArgsResult.value;
-                prerunArgs = this.projectHelper.derivePrerunArgsFromStorage(blockConfig, storageToWrite);
-            }
-        }
-        else if (spec.storageMode === "legacy") {
-            // Model API v1: use legacyState from spec
-            const parsedState = JSON.parse(spec.legacyState);
-            args = parsedState.args;
-            if (args === undefined) {
-                throw new Error("args is undefined in legacyState");
-            }
-            prerunArgs = args;
-            storageToWrite = spec.legacyState;
-        }
-        else {
-            throw new Error(`Unknown storageMode: ${spec.storageMode}`);
-        }
-        // currentArgs
-        if (args !== undefined) {
-            this.setBlockFieldObj(blockId, "currentArgs", this.createJsonFieldValue(args));
-        }
-        // currentPrerunArgs
-        if (prerunArgs !== undefined) {
-            this.setBlockFieldObj(blockId, "currentPrerunArgs", this.createJsonFieldValue(prerunArgs));
-        }
-        // blockStorage
-        this.setBlockFieldObj(blockId, "blockStorage", this.createJsonFieldValueByContent(storageToWrite));
-        // checking structure
-        info.check();
-    }
-    getFieldNamesToDuplicate(blockId) {
-        const fields = this.getBlockInfo(blockId).fields;
-        const diff = (setA, setB) => new Set([...setA].filter((x) => !setB.has(x)));
-        // Check if we can safely move to limbo (both core production fields are ready)
-        if (fields.prodOutput?.status === "Ready" && fields.prodCtx?.status === "Ready") {
-            if (this.blocksInLimbo.has(blockId))
-                // we are already in limbo
-                return project_model.FieldsToDuplicate;
-            return diff(project_model.FieldsToDuplicate, new Set(["prodOutputPrevious", "prodCtxPrevious", "prodUiCtxPrevious"]));
-        }
-        else {
-            return diff(project_model.FieldsToDuplicate, new Set([
-                "prodOutput",
-                "prodCtx",
-                "prodUiCtx",
-                "prodArgs",
-                "prodOutputPrevious",
-                "prodCtxPrevious",
-                "prodUiCtxPrevious",
-            ]));
-        }
-    }
-    initializeBlockDuplicate(blockId, originalBlockInfo) {
-        const info = new BlockInfo(blockId, {}, originalBlockInfo.config, originalBlockInfo.source);
-        this.blockInfos.set(blockId, info);
-        const fieldNamesToDuplicate = this.getFieldNamesToDuplicate(blockId);
-        // Copy all fields from original block to new block by sharing references
-        for (const [fieldName, fieldState] of Object.entries(originalBlockInfo.fields)) {
-            if (fieldNamesToDuplicate.has(fieldName) &&
-                fieldState &&
-                fieldState.ref) {
-                this.setBlockFieldObj(blockId, fieldName, {
-                    ref: fieldState.ref,
-                    status: fieldState.status,
-                    value: fieldState.value,
-                });
-            }
-        }
-        this.resetOrLimboProduction(blockId);
-        info.check();
-    }
-    /** Very generic method, better check for more specialized case-specific methods first. */
-    updateStructure(newStructure, newBlockInitializer = NoNewBlocks) {
-        const currentStagingGraph = this.getStagingGraph();
-        const currentActualProductionGraph = this.getActualProductionGraph();
-        const newStagingGraph = project_model_util.stagingGraph(newStructure);
-        const stagingDiff = project_model_util.graphDiff(currentStagingGraph, newStagingGraph);
-        // removing blocks
-        for (const blockId of stagingDiff.onlyInA) {
-            const { fields } = this.getBlockInfo(blockId);
-            this.deleteBlockFields(blockId, ...Object.keys(fields));
-            this.blockInfos.delete(blockId);
-            if (this.blocksInLimbo.delete(blockId))
-                this.renderingStateChanged = true;
-        }
-        // creating new blocks
-        for (const blockId of stagingDiff.onlyInB) {
-            newBlockInitializer(blockId);
-        }
-        // resetting stagings affected by topology change
-        for (const blockId of stagingDiff.different)
-            this.resetStaging(blockId);
-        // new actual production graph without new blocks
-        const newActualProductionGraph = project_model_util.productionGraph(newStructure, (blockId) => this.getProductionGraphBlockInfo(blockId, true));
-        const prodDiff = project_model_util.graphDiff(currentActualProductionGraph, newActualProductionGraph);
-        // applying changes due to topology change in production to affected nodes and
-        // all their downstreams
-        currentActualProductionGraph.traverse("downstream", [...prodDiff.different], (node) => {
-            this.resetOrLimboProduction(node.id);
-        });
-        if (stagingDiff.onlyInB.size > 0 ||
-            stagingDiff.onlyInA.size > 0 ||
-            stagingDiff.different.size > 0)
-            this.resetStagingRefreshTimestamp();
-        this.struct = newStructure;
-        this.structureChanged = true;
-        this.stagingGraph = undefined;
-        this.pendingProductionGraph = undefined;
-        this.actualProductionGraph = undefined;
-        this.updateLastModified();
-    }
-    //
-    // Structure change helpers
-    //
-    addBlock(block, spec, before) {
-        const newStruct = this.structure; // copy current structure
-        if (before === undefined) {
-            // adding as a very last block
-            newStruct.groups[newStruct.groups.length - 1].blocks.push(block);
-        }
-        else {
-            let done = false;
-            for (const group of newStruct.groups) {
-                const idx = group.blocks.findIndex((b) => b.id === before);
-                if (idx < 0)
-                    continue;
-                group.blocks.splice(idx, 0, block);
-                done = true;
-                break;
-            }
-            if (!done)
-                throw new Error(`Can't find element with id: ${before}`);
-        }
-        this.updateStructure(newStruct, (blockId) => {
-            if (blockId !== block.id)
-                throw new Error("Unexpected");
-            this.initializeNewBlock(blockId, spec);
-        });
-    }
-    /**
-     * Duplicates an existing block by copying all its fields and structure.
-     * This method creates a deep copy of the block at the mutator level.
-     *
-     * @param originalBlockId id of the block to duplicate
-     * @param newBlockId id for the new duplicated block
-     * @param after id of the block to insert new block after
-     */
-    duplicateBlock(originalBlockId, newBlockId, after) {
-        // Get the original block from structure
-        const originalBlock = this.getBlock(originalBlockId);
-        const originalBlockInfo = this.getBlockInfo(originalBlockId);
-        // Create new block in structure
-        const newBlock = {
-            id: newBlockId,
-            label: originalBlock.label,
-            renderingMode: originalBlock.renderingMode,
-        };
-        // Add the new block to structure
-        const newStruct = this.structure; // copy current structure
-        if (after === undefined) {
-            // adding as a very last block
-            newStruct.groups[newStruct.groups.length - 1].blocks.push(newBlock);
-        }
-        else {
-            let done = false;
-            for (const group of newStruct.groups) {
-                const idx = group.blocks.findIndex((b) => b.id === after);
-                if (idx < 0)
-                    continue;
-                group.blocks.splice(idx + 1, 0, newBlock);
-                done = true;
-                break;
-            }
-            if (!done)
-                throw new Error(`Can't find element with id: ${after}`);
-        }
-        this.updateStructure(newStruct, (blockId) => {
-            if (blockId !== newBlockId)
-                throw new Error("Unexpected");
-            this.initializeBlockDuplicate(blockId, originalBlockInfo);
-        });
-    }
-    deleteBlock(blockId) {
-        const newStruct = this.structure; // copy current structure
-        let done = false;
-        for (const group of newStruct.groups) {
-            const idx = group.blocks.findIndex((b) => b.id === blockId);
-            if (idx < 0)
-                continue;
-            group.blocks.splice(idx, 1);
-            done = true;
-            break;
-        }
-        if (!done)
-            throw new Error(`Can't find element with id: ${blockId}`);
-        this.updateStructure(newStruct);
-    }
-    //
-    // Block-pack migration
-    //
-    migrateBlockPack(blockId, spec, newClearState) {
-        const info = this.getBlockInfo(blockId);
-        const newConfig = model.extractConfig(spec.config);
-        const persistBlockPack = () => {
-            this.setBlockField(blockId, "blockPack", plClient.Pl.wrapInHolder(this.tx, block_pack.createBlockPack(this.tx, spec)), "NotReady");
-        };
-        const applyStorageAndDeriveArgs = (storageJson) => {
-            persistBlockPack();
-            this.setBlockStorageRaw(blockId, storageJson);
-            const deriveArgsResult = this.projectHelper.deriveArgsFromStorage(newConfig, storageJson);
-            if (!deriveArgsResult.error) {
-                this.setBlockFieldObj(blockId, "currentArgs", this.createJsonFieldValue(deriveArgsResult.value));
-                const prerunArgs = this.projectHelper.derivePrerunArgsFromStorage(newConfig, storageJson);
-                if (prerunArgs !== undefined) {
-                    this.setBlockFieldObj(blockId, "currentPrerunArgs", this.createJsonFieldValue(prerunArgs));
-                }
-            }
-        };
-        if (newClearState !== undefined) {
-            // State is being reset - no migration needed
-            const supportsStorageFromVM = newConfig.modelAPIVersion === model.BLOCK_STORAGE_FACADE_VERSION;
-            if (supportsStorageFromVM) {
-                // V2+: Get initial storage directly from VM and derive args from it
-                const initialStorageJson = this.projectHelper.getInitialStorageInVM(newConfig);
-                applyStorageAndDeriveArgs(initialStorageJson);
-                this.blocksWithChangedInputs.add(blockId);
-                this.updateLastModified();
-            }
-            else {
-                // V1: Use setStates with legacy state format
-                persistBlockPack();
-                this.setStates([{ modelAPIVersion: 1, blockId, state: newClearState.state }]);
-            }
-        }
-        else {
-            // State is being preserved - run migrations if needed via VM
-            // Only Model API v2 blocks support migrations
-            const supportsStateMigrations = newConfig.modelAPIVersion === model.BLOCK_STORAGE_FACADE_VERSION;
-            if (supportsStateMigrations) {
-                const currentStorageJson = info.blockStorageJson;
-                // Attempt migration BEFORE persisting block pack — on failure,
-                // block stays on old version (no inconsistent new-code/old-storage state)
-                const migrationResult = this.projectHelper.migrateStorageInVM(newConfig, currentStorageJson);
-                if (migrationResult.error !== undefined) {
-                    throw new Error(`[migrateBlockPack] Block ${blockId} migration failed: ${migrationResult.error}`);
-                }
-                console.log(`[migrateBlockPack] Block ${blockId}: ${migrationResult.info}`);
-                applyStorageAndDeriveArgs(migrationResult.newStorageJson);
-            }
-            else {
-                // Legacy blocks (modelAPIVersion 1): persist block pack, set prerunArgs = currentArgs
-                persistBlockPack();
-                if (info.fields.currentArgs !== undefined) {
-                    this.setBlockFieldObj(blockId, "currentPrerunArgs", info.fields.currentArgs);
-                }
-            }
-            this.blocksWithChangedInputs.add(blockId);
-            // resetting staging outputs for all downstream blocks
-            this.getStagingGraph().traverse("downstream", [blockId], ({ id }) => this.resetStaging(id));
-        }
-        // also reset or limbo all downstream productions
-        if (info.productionRendered)
-            this.getActualProductionGraph().traverse("downstream", [blockId], ({ id }) => this.resetOrLimboProduction(id));
-        this.updateLastModified();
-    }
-    //
-    // Render
-    //
-    renderProduction(blockIds, addUpstreams = false) {
-        const blockIdsSet = new Set(blockIds);
-        const prodGraph = this.getPendingProductionGraph();
-        if (addUpstreams)
-            // adding all upstreams automatically
-            prodGraph.traverse("upstream", blockIds, (node) => {
-                blockIdsSet.add(node.id);
-            });
-        else
-            // checking that targets contain all upstreams
-            for (const blockId of blockIdsSet) {
-                const node = prodGraph.nodes.get(blockId);
-                if (node === undefined)
-                    throw new Error(`Can't find block with id: ${blockId}`);
-                for (const upstream of node.upstream)
-                    if (!blockIdsSet.has(upstream))
-                        throw new Error("Can't render blocks not including all upstreams.");
-            }
-        // traversing in topological order and rendering target blocks
-        const rendered = new Set();
-        for (const block of project_model_util.allBlocks(this.structure)) {
-            if (!blockIdsSet.has(block.id))
-                continue;
-            let render = this.getBlockInfo(block.id).requireProductionRendering || this.blocksInLimbo.has(block.id);
-            if (!render)
-                for (const upstream of prodGraph.nodes.get(block.id).upstream)
-                    if (rendered.has(upstream)) {
-                        render = true;
-                        break;
-                    }
-            if (render) {
-                this.renderProductionFor(block.id);
-                rendered.add(block.id);
-            }
-        }
-        const renderedArray = [...rendered];
-        // sending to limbo all downstream blocks
-        prodGraph.traverse("downstream", renderedArray, (node) => {
-            if (rendered.has(node.id))
-                // don't send to limbo blocks that were just rendered
-                return;
-            this.resetOrLimboProduction(node.id);
-        });
-        // resetting staging outputs for all downstream blocks
-        this.getStagingGraph().traverse("downstream", renderedArray, ({ id }) => {
-            // don't reset staging of the first rendered block
-            if (renderedArray[0] !== id)
-                this.resetStaging(id);
-        });
-        if (rendered.size > 0)
-            this.updateLastModified();
-        return rendered;
-    }
-    /** Stops running blocks from the list and modify states of other blocks
-     * accordingly */
-    stopProduction(...blockIds) {
-        const activeProdGraph = this.getActualProductionGraph();
-        // we will stop all blocks listed in request and all their downstreams
-        const queue = new Denque(blockIds);
-        const queued = new Set(blockIds);
-        const stopped = [];
-        while (!queue.isEmpty()) {
-            const blockId = queue.shift();
-            const fields = this.getBlockInfo(blockId).fields;
-            if (fields.prodOutput?.status === "Ready" && fields.prodCtx?.status === "Ready")
-                // skipping finished blocks
-                continue;
-            if (this.deleteBlockFields(blockId, "prodOutput", "prodCtx", "prodUiCtx", "prodArgs")) {
-                // was actually stopped
-                stopped.push(blockId);
-                // will try to stop all its downstreams
-                for (const downstream of activeProdGraph.traverseIdsExcludingRoots("downstream", blockId)) {
-                    if (queued.has(downstream))
-                        continue;
-                    queue.push(downstream);
-                    queued.add(downstream);
-                }
-            }
-        }
-        // blocks under stopped blocks, but having finished production results, goes to limbo
-        for (const blockId of activeProdGraph.traverseIdsExcludingRoots("downstream", ...stopped))
-            this.resetOrLimboProduction(blockId);
-        // reset staging outputs for all downstream blocks
-        this.getStagingGraph().traverse("downstream", stopped, ({ id }) => this.resetStaging(id));
-    }
-    traverseWithStagingLag(cb) {
-        const lags = new Map();
-        const stagingGraph = this.getStagingGraph();
-        stagingGraph.nodes.forEach((node) => {
-            const info = this.getBlockInfo(node.id);
-            // Use requireStagingRendering to check both: staging exists AND prerunArgs hasn't changed
-            const requiresRendering = info.requireStagingRendering;
-            let lag = requiresRendering ? 1 : 0;
-            node.upstream.forEach((upstream) => {
-                const upstreamLag = lags.get(upstream);
-                if (upstreamLag === 0)
-                    return;
-                lag = Math.max(upstreamLag + 1, lag);
-            });
-            if (!requiresRendering && info.stagingRendered) ;
-            cb(node.id, lag);
-            lags.set(node.id, lag);
-        });
-    }
-    /** @param stagingRenderingRate rate in blocks per second */
-    refreshStagings(stagingRenderingRate) {
-        const elapsed = Date.now() - this.renderingState.stagingRefreshTimestamp;
-        const lagThreshold = stagingRenderingRate === undefined
-            ? undefined
-            : 1 + Math.max(0, (elapsed * stagingRenderingRate) / 1000);
-        let rendered = 0;
-        this.traverseWithStagingLag((blockId, lag) => {
-            if (lag === 0)
-                // meaning staging already rendered
-                return;
-            if (lagThreshold === undefined || lag <= lagThreshold) {
-                // console.log(`[refreshStagings] RENDER staging for ${blockId} (lag=${lag})`);
-                this.renderStagingFor(blockId);
-                rendered++;
-            }
-        });
-        if (rendered > 0)
-            this.resetStagingRefreshTimestamp();
-    }
-    //
-    // Meta
-    //
-    /** Updates project metadata */
-    setMeta(meta) {
-        this.meta = meta;
-        this.metaChanged = true;
-        this.updateLastModified();
-    }
-    //
-    // Maintenance
-    //
-    /** @param stagingRenderingRate rate in blocks per second */
-    doRefresh(stagingRenderingRate) {
-        this.refreshStagings(stagingRenderingRate);
-        this.blockInfos.forEach((blockInfo) => {
-            if (blockInfo.fields.prodCtx?.status === "Ready" &&
-                blockInfo.fields.prodOutput?.status === "Ready")
-                this.deleteBlockFields(blockInfo.id, "prodOutputPrevious", "prodCtxPrevious", "prodUiCtxPrevious");
-            if (blockInfo.fields.stagingCtx?.status === "Ready" &&
-                blockInfo.fields.stagingOutput?.status === "Ready")
-                this.deleteBlockFields(blockInfo.id, "stagingOutputPrevious", "stagingCtxPrevious", "stagingUiCtxPrevious");
-        });
-    }
-    assignAuthorMarkers() {
-        const markerStr = this.author ? JSON.stringify(this.author) : undefined;
-        for (const blockId of this.blocksWithChangedInputs)
-            if (markerStr === undefined)
-                this.tx.deleteKValue(this.rid, project_model.blockArgsAuthorKey(blockId));
-            else
-                this.tx.setKValue(this.rid, project_model.blockArgsAuthorKey(blockId), markerStr);
-        if (this.metaChanged || this.structureChanged) {
-            if (markerStr === undefined)
-                this.tx.deleteKValue(this.rid, project_model.ProjectStructureAuthorKey);
-            else
-                this.tx.setKValue(this.rid, project_model.ProjectStructureAuthorKey, markerStr);
-        }
-    }
-    save() {
-        if (!this.wasModified)
-            return;
-        if (this.lastModifiedChanged)
-            this.tx.setKValue(this.rid, project_model.ProjectLastModifiedTimestamp, JSON.stringify(this.lastModified));
-        if (this.structureChanged)
-            this.tx.setKValue(this.rid, project_model.ProjectStructureKey, JSON.stringify(this.struct));
-        if (this.renderingStateChanged)
-            this.tx.setKValue(this.rid, project_model.BlockRenderingStateKey, JSON.stringify({
-                ...this.renderingState,
-                blocksInLimbo: [...this.blocksInLimbo],
-            }));
-        if (this.metaChanged)
-            this.tx.setKValue(this.rid, project_model.ProjectMetaKey, JSON.stringify(this.meta));
-        this.assignAuthorMarkers();
-    }
-    static async load(projectHelper, tx, rid, author) {
-        //
-        // Sending initial requests to read project state (start of round-trip #1)
-        //
-        const fullResourceStateP = tx.getResourceData(rid, true);
-        const schemaP = tx.getKValueJson(rid, project_model.SchemaVersionKey);
-        const lastModifiedP = tx.getKValueJson(rid, project_model.ProjectLastModifiedTimestamp);
-        const metaP = tx.getKValueJson(rid, project_model.ProjectMetaKey);
-        const structureP = tx.getKValueJson(rid, project_model.ProjectStructureKey);
-        const renderingStateP = tx.getKValueJson(rid, project_model.BlockRenderingStateKey);
-        const fullResourceState = await fullResourceStateP;
-        // loading field information
-        const blockInfoStates = new Map();
-        for (const f of fullResourceState.fields) {
-            const projectField = project_model.parseProjectField(f.name);
-            // processing only fields with known structure
-            if (projectField === undefined)
-                continue;
-            let info = blockInfoStates.get(projectField.blockId);
-            if (info === undefined) {
-                info = {
-                    id: projectField.blockId,
-                    fields: {},
-                };
-                blockInfoStates.set(projectField.blockId, info);
-            }
-            info.fields[projectField.fieldName] = plClient.isNullResourceId(f.value)
-                ? { modCount: 0 }
-                : { modCount: 0, ref: f.value };
-        }
-        //
-        // Roundtrip #1 not yet finished, but as soon as field list is received,
-        // we can start sending requests to read states of referenced resources
-        // (start of round-trip #2)
-        //
-        const blockFieldRequests = [];
-        blockInfoStates.forEach((info) => {
-            const fields = info.fields;
-            for (const [fName, state] of Object.entries(fields)) {
-                if (state.ref === undefined)
-                    continue;
-                if (!plClient.isResource(state.ref) || plClient.isResourceRef(state.ref))
-                    throw new Error("unexpected behaviour");
-                const fieldName = fName;
-                blockFieldRequests.push([
-                    info,
-                    fieldName,
-                    state,
-                    tx.getResourceData(state.ref, fieldName == "blockPack"),
-                ]);
-            }
-        });
-        // loading jsons
-        const [schema, lastModified, meta, structure, { stagingRefreshTimestamp, blocksInLimbo }] = await Promise.all([schemaP, lastModifiedP, metaP, structureP, renderingStateP]);
-        // Checking schema version of the project
-        if (schema !== project_model.SchemaVersionCurrent) {
-            if (Number(schema) < Number(project_model.SchemaVersionCurrent))
-                throw new model.UiError(`Can't perform this action on this project because it has older schema. Try (re)loading the project to update it.`);
-            else
-                throw new model.UiError(`Can't perform this action on this project because it has newer schema. Upgrade your desktop app to the latest version.`);
-        }
-        //
-        // <- at this point we have all the responses from round-trip #1
-        //
-        //
-        // Receiving responses from round-trip #2 and sending requests to read block pack descriptions
-        // (start of round-trip #3)
-        //
-        const blockPackRequests = [];
-        for (const [info, fieldName, state, response] of blockFieldRequests) {
-            const result = await response;
-            state.value = result.data;
-            if (plClient.isNotNullResourceId(result.error))
-                state.status = "Error";
-            else if (result.resourceReady || plClient.isNotNullResourceId(result.originalResourceId))
-                state.status = "Ready";
-            else
-                state.status = "NotReady";
-            // For block pack we need to traverse the ref field from the resource data
-            if (fieldName === "blockPack") {
-                const refField = result.fields.find((f) => f.name === plClient.Pl.HolderRefField);
-                if (refField === undefined)
-                    throw new Error("Block pack ref field is missing");
-                blockPackRequests.push([
-                    info,
-                    tx.getResourceData(plClient.ensureResourceIdNotNull(refField.value), false),
-                ]);
-            }
-        }
-        //
-        // <- at this point we have all the responses from round-trip #2
-        //
-        for (const [info, response] of blockPackRequests) {
-            const result = await response;
-            const bpInfo = tsHelpers.cachedDeserialize(tsHelpers.notEmpty(result.data));
-            info.blockConfig = model.extractConfig(bpInfo.config);
-            info.blockPack = bpInfo.source;
-        }
-        //
-        // <- at this point we have all the responses from round-trip #3
-        //
-        // loading ctx export template to check if we already have cached materialized template in our project
-        const ctxExportTplEnvelope = await context_export.getPreparedExportTemplateEnvelope();
-        // expected field name
-        const ctxExportTplCacheFieldName = project_model.getServiceTemplateField(ctxExportTplEnvelope.hash);
-        const ctxExportTplField = fullResourceState.fields.find((f) => f.name === ctxExportTplCacheFieldName);
-        let ctxExportTplHolder;
-        if (ctxExportTplField !== undefined)
-            ctxExportTplHolder = plClient.ensureResourceIdNotNull(ctxExportTplField.value);
-        else {
-            ctxExportTplHolder = plClient.Pl.wrapInHolder(tx, template_loading.loadTemplate(tx, ctxExportTplEnvelope.spec));
-            tx.createField(plClient.field(rid, project_model.getServiceTemplateField(ctxExportTplEnvelope.hash)), "Dynamic", ctxExportTplHolder);
-        }
-        const renderingState = { stagingRefreshTimestamp };
-        const blocksInLimboSet = new Set(blocksInLimbo);
-        const blockInfos = new Map();
-        blockInfoStates.forEach(({ id, fields, blockConfig, blockPack }) => blockInfos.set(id, new BlockInfo(id, fields, tsHelpers.notEmpty(blockConfig), tsHelpers.notEmpty(blockPack))));
-        // check consistency of project state
-        const blockInStruct = new Set();
-        for (const b of project_model_util.allBlocks(structure)) {
-            if (!blockInfos.has(b.id))
-                throw new Error(`Inconsistent project structure: no inputs for ${b.id}`);
-            blockInStruct.add(b.id);
-        }
-        blockInfos.forEach((info) => {
-            if (!blockInStruct.has(info.id))
-                throw new Error(`Inconsistent project structure: no structure entry for ${info.id}`);
-            // checking structure
-            info.check();
-        });
-        const prj = new ProjectMutator(rid, tx, author, schema, lastModified, meta, structure, renderingState, blocksInLimboSet, blockInfos, ctxExportTplHolder, projectHelper);
-        prj.fixProblemsAndMigrate();
-        return prj;
-    }
-}
-async function createProject(tx, meta = project_model.InitialBlockMeta) {
-    const prj = tx.createEphemeral(project_model.ProjectResourceType);
-    tx.lock(prj);
-    const ts = String(Date.now());
-    tx.setKValue(prj, project_model.SchemaVersionKey, JSON.stringify(project_model.SchemaVersionCurrent));
-    tx.setKValue(prj, project_model.ProjectCreatedTimestamp, ts);
-    tx.setKValue(prj, project_model.ProjectLastModifiedTimestamp, ts);
-    tx.setKValue(prj, project_model.ProjectMetaKey, JSON.stringify(meta));
-    tx.setKValue(prj, project_model.ProjectStructureKey, JSON.stringify(project_model.InitialBlockStructure));
-    tx.setKValue(prj, project_model.BlockRenderingStateKey, JSON.stringify(project_model.InitialProjectRenderingState));
-    const ctxExportTplEnvelope = await context_export.getPreparedExportTemplateEnvelope();
-    tx.createField(plClient.field(prj, project_model.getServiceTemplateField(ctxExportTplEnvelope.hash)), "Dynamic", plClient.Pl.wrapInHolder(tx, template_loading.loadTemplate(tx, ctxExportTplEnvelope.spec)));
-    return prj;
+var ProjectMutator = class ProjectMutator {
+	globalModCount = 0;
+	fieldsChanged = false;
+	lastModifiedChanged = false;
+	structureChanged = false;
+	metaChanged = false;
+	renderingStateChanged = false;
+	/** Set blocks will be assigned current mutator author marker on save */
+	blocksWithChangedInputs = /* @__PURE__ */ new Set();
+	constructor(rid, tx, author, schema, lastModified, meta, struct, renderingState, blocksInLimbo, blockInfos, ctxExportTplHolder, projectHelper) {
+		this.rid = rid;
+		this.tx = tx;
+		this.author = author;
+		this.schema = schema;
+		this.lastModified = lastModified;
+		this.meta = meta;
+		this.struct = struct;
+		this.renderingState = renderingState;
+		this.blocksInLimbo = blocksInLimbo;
+		this.blockInfos = blockInfos;
+		this.ctxExportTplHolder = ctxExportTplHolder;
+		this.projectHelper = projectHelper;
+	}
+	fixProblemsAndMigrate() {
+		this.blockInfos.forEach((blockInfo) => {
+			if (blockInfo.fields.prodArgs === void 0 || blockInfo.fields.prodOutput === void 0 || blockInfo.fields.prodCtx === void 0) this.deleteBlockFields(blockInfo.id, "prodArgs", "prodOutput", "prodCtx");
+		});
+		let initialBlockSettings;
+		this.blockInfos.forEach((blockInfo) => {
+			if (blockInfo.fields.blockSettings === void 0) {
+				if (initialBlockSettings === void 0) initialBlockSettings = this.createJsonFieldValue(_milaboratories_pl_model_middle_layer.InitialBlockSettings);
+				this.setBlockFieldObj(blockInfo.id, "blockSettings", initialBlockSettings);
+			}
+		});
+	}
+	get wasModified() {
+		return this.lastModifiedChanged || this.structureChanged || this.fieldsChanged || this.metaChanged || this.renderingStateChanged;
+	}
+	get structure() {
+		return JSON.parse(JSON.stringify(this.struct));
+	}
+	stagingGraph = void 0;
+	pendingProductionGraph = void 0;
+	actualProductionGraph = void 0;
+	getStagingGraph() {
+		if (this.stagingGraph === void 0) this.stagingGraph = require_project_model_util.stagingGraph(this.struct);
+		return this.stagingGraph;
+	}
+	getProductionGraphBlockInfo(blockId, prod) {
+		const bInfo = this.getBlockInfo(blockId);
+		let argsField;
+		let args;
+		if (prod) {
+			if (bInfo.fields.prodArgs === void 0) return void 0;
+			argsField = bInfo.fields.prodArgs;
+			args = bInfo.prodArgs;
+		} else {
+			argsField = bInfo.fields.currentArgs;
+			args = bInfo.currentArgs;
+		}
+		if (argsField === void 0) return {
+			args,
+			enrichmentTargets: void 0
+		};
+		const blockPackField = (0, _milaboratories_ts_helpers.notEmpty)(bInfo.fields.blockPack);
+		if ((0, _milaboratories_pl_client.isResourceId)(argsField.ref) && (0, _milaboratories_pl_client.isResourceId)(blockPackField.ref)) return {
+			args,
+			enrichmentTargets: this.projectHelper.getEnrichmentTargets(() => bInfo.config, () => args, {
+				argsRid: argsField.ref,
+				blockPackRid: blockPackField.ref
+			})
+		};
+		else return {
+			args,
+			enrichmentTargets: this.projectHelper.getEnrichmentTargets(() => bInfo.config, () => args)
+		};
+	}
+	getPendingProductionGraph() {
+		if (this.pendingProductionGraph === void 0) this.pendingProductionGraph = require_project_model_util.productionGraph(this.struct, (blockId) => this.getProductionGraphBlockInfo(blockId, false));
+		return this.pendingProductionGraph;
+	}
+	getActualProductionGraph() {
+		if (this.actualProductionGraph === void 0) this.actualProductionGraph = require_project_model_util.productionGraph(this.struct, (blockId) => this.getProductionGraphBlockInfo(blockId, true));
+		return this.actualProductionGraph;
+	}
+	getBlockInfo(blockId) {
+		const info = this.blockInfos.get(blockId);
+		if (info === void 0) throw new Error(`No such block: ${blockId}`);
+		return info;
+	}
+	createJsonFieldValueByContent(content) {
+		if (content === void 0) throw new Error("content is undefined");
+		const value = Buffer.from(content);
+		return {
+			ref: this.tx.createValue(_milaboratories_pl_client.Pl.JsonObject, value),
+			value,
+			status: "Ready"
+		};
+	}
+	createJsonFieldValue(obj) {
+		return this.createJsonFieldValueByContent(JSON.stringify(obj));
+	}
+	getBlock(blockId) {
+		for (const block of require_project_model_util.allBlocks(this.struct)) if (block.id === blockId) return block;
+		throw new Error("block not found");
+	}
+	setBlockFieldObj(blockId, fieldName, state) {
+		const fid = (0, _milaboratories_pl_client.field)(this.rid, require_project_model.projectFieldName(blockId, fieldName));
+		if (state.ref === void 0) throw new Error("Can't set value with empty ref");
+		if (this.getBlockInfo(blockId).fields[fieldName] === void 0) this.tx.createField(fid, "Dynamic", state.ref);
+		else this.tx.setField(fid, state.ref);
+		this.getBlockInfo(blockId).fields[fieldName] = {
+			modCount: this.globalModCount++,
+			...state
+		};
+		this.fieldsChanged = true;
+	}
+	setBlockField(blockId, fieldName, ref, status, value) {
+		this.setBlockFieldObj(blockId, fieldName, {
+			ref,
+			status,
+			value
+		});
+	}
+	deleteBlockFields(blockId, ...fieldNames) {
+		let deleted = false;
+		const info = this.getBlockInfo(blockId);
+		for (const fieldName of fieldNames) {
+			const fields = info.fields;
+			if (!(fieldName in fields)) continue;
+			this.tx.removeField((0, _milaboratories_pl_client.field)(this.rid, require_project_model.projectFieldName(blockId, fieldName)));
+			delete fields[fieldName];
+			this.fieldsChanged = true;
+			deleted = true;
+		}
+		return deleted;
+	}
+	updateLastModified() {
+		this.lastModified = Date.now();
+		this.lastModifiedChanged = true;
+	}
+	resetStagingRefreshTimestamp() {
+		this.renderingState.stagingRefreshTimestamp = Date.now();
+		this.renderingStateChanged = true;
+	}
+	resetStaging(blockId) {
+		const fields = this.getBlockInfo(blockId).fields;
+		if (fields.stagingOutput?.status === "Ready" && fields.stagingCtx?.status === "Ready" && fields.stagingUiCtx?.status === "Ready") {
+			this.setBlockFieldObj(blockId, "stagingOutputPrevious", fields.stagingOutput);
+			this.setBlockFieldObj(blockId, "stagingCtxPrevious", fields.stagingCtx);
+			this.setBlockFieldObj(blockId, "stagingUiCtxPrevious", fields.stagingUiCtx);
+		}
+		if (this.deleteBlockFields(blockId, "stagingOutput", "stagingCtx", "stagingUiCtx")) this.resetStagingRefreshTimestamp();
+	}
+	resetProduction(blockId) {
+		const fields = this.getBlockInfo(blockId).fields;
+		if (fields.prodOutput?.status === "Ready" && fields.prodCtx?.status === "Ready" && fields.prodUiCtx?.status === "Ready") {
+			this.setBlockFieldObj(blockId, "prodOutputPrevious", fields.prodOutput);
+			this.setBlockFieldObj(blockId, "prodCtxPrevious", fields.prodCtx);
+			this.setBlockFieldObj(blockId, "prodUiCtxPrevious", fields.prodUiCtx);
+		}
+		this.deleteBlockFields(blockId, "prodOutput", "prodCtx", "prodUiCtx", "prodArgs");
+	}
+	/** Running blocks are reset, already computed moved to limbo. Returns if
+	* either of the actions were actually performed.
+	* This method ensures the block is left in a consistent state that passes check() constraints. */
+	resetOrLimboProduction(blockId) {
+		const fields = this.getBlockInfo(blockId).fields;
+		if (fields.prodOutput?.status === "Ready" && fields.prodCtx?.status === "Ready") {
+			if (this.blocksInLimbo.has(blockId)) return false;
+			this.blocksInLimbo.add(blockId);
+			this.renderingStateChanged = true;
+			this.deleteBlockFields(blockId, "prodOutputPrevious", "prodCtxPrevious", "prodUiCtxPrevious");
+			return true;
+		} else return this.deleteBlockFields(blockId, "prodOutput", "prodCtx", "prodUiCtx", "prodArgs", "prodOutputPrevious", "prodCtxPrevious", "prodUiCtxPrevious");
+	}
+	/**
+	* Gets current block state and merges with partial updates.
+	* Used by legacy v1/v2 methods like setBlockArgs and setUiState.
+	*
+	* @param blockId The block to get state for
+	* @param partialUpdate Partial state to merge (e.g. { args } or { uiState })
+	* @returns Merged state in unified format { args, uiState }
+	*/
+	mergeBlockState(blockId, partialUpdate) {
+		return {
+			...this.getBlockInfo(blockId).blockStorage,
+			...partialUpdate
+		};
+	}
+	/**
+	* Sets raw block storage content directly (for testing purposes).
+	* This bypasses all normalization and VM transformations.
+	*
+	* @param blockId The block to set storage for
+	* @param rawStorageJson Raw storage as JSON string
+	*/
+	setBlockStorageRaw(blockId, rawStorageJson) {
+		this.setBlockFieldObj(blockId, "blockStorage", this.createJsonFieldValueByContent(rawStorageJson));
+		this.blocksWithChangedInputs.add(blockId);
+		this.updateLastModified();
+	}
+	/**
+	* Resets a v2+ block to its initial storage state.
+	* Gets initial storage from VM and derives args from it.
+	*
+	* For v1 blocks, use setStates() instead.
+	*
+	* @param blockId The block to reset
+	*/
+	resetToInitialStorage(blockId) {
+		const blockConfig = this.getBlockInfo(blockId).config;
+		if (blockConfig.modelAPIVersion !== _platforma_sdk_model.BLOCK_STORAGE_FACADE_VERSION) throw new Error("resetToInitialStorage is only supported for model API version 2");
+		const initialStorageJson = this.projectHelper.getInitialStorageInVM(blockConfig);
+		this.setBlockStorageRaw(blockId, initialStorageJson);
+		const deriveArgsResult = this.projectHelper.deriveArgsFromStorage(blockConfig, initialStorageJson);
+		if (!deriveArgsResult.error) {
+			this.setBlockFieldObj(blockId, "currentArgs", this.createJsonFieldValue(deriveArgsResult.value));
+			const prerunArgs = this.projectHelper.derivePrerunArgsFromStorage(blockConfig, initialStorageJson);
+			if (prerunArgs !== void 0) this.setBlockFieldObj(blockId, "currentPrerunArgs", this.createJsonFieldValue(prerunArgs));
+		} else this.deleteBlockFields(blockId, "currentArgs");
+	}
+	/** Optimally sets inputs for multiple blocks in one go */
+	setStates(requests) {
+		const changedArgs = [];
+		let somethingChanged = false;
+		for (const req of requests) {
+			const info = this.getBlockInfo(req.blockId);
+			let blockChanged = false;
+			const blockConfig = info.config;
+			if (req.modelAPIVersion !== blockConfig.modelAPIVersion) throw new Error(`Model API version mismatch for block ${req.blockId}: ${req.modelAPIVersion} !== ${blockConfig.modelAPIVersion}`);
+			let args;
+			let prerunArgs;
+			if (req.modelAPIVersion === _platforma_sdk_model.BLOCK_STORAGE_FACADE_VERSION) {
+				const currentStorageJson = info.blockStorageJson;
+				if (currentStorageJson === void 0) throw new Error(`Block ${req.blockId} has no blockStorage - this should not happen`);
+				const updatedStorageJson = this.projectHelper.applyStorageUpdateInVM(blockConfig, currentStorageJson, req.payload);
+				this.setBlockFieldObj(req.blockId, "blockStorage", this.createJsonFieldValueByContent(updatedStorageJson));
+				const derivedArgsResult = this.projectHelper.deriveArgsFromStorage(blockConfig, updatedStorageJson);
+				if (derivedArgsResult.error) {
+					args = void 0;
+					prerunArgs = void 0;
+				} else {
+					args = derivedArgsResult.value;
+					prerunArgs = this.projectHelper.derivePrerunArgsFromStorage(blockConfig, updatedStorageJson);
+				}
+			} else {
+				this.setBlockFieldObj(req.blockId, "blockStorage", this.createJsonFieldValue(req.state));
+				if (req.state !== null && typeof req.state === "object" && "args" in req.state) args = req.state.args;
+				else args = req.state;
+				prerunArgs = args;
+			}
+			if (args !== void 0) {
+				const currentArgsData = (0, _milaboratories_ts_helpers.canonicalJsonBytes)(args);
+				const argsPartRef = this.tx.createValue(_milaboratories_pl_client.Pl.JsonObject, currentArgsData);
+				this.setBlockField(req.blockId, "currentArgs", argsPartRef, "Ready", currentArgsData);
+			} else this.deleteBlockFields(req.blockId, "currentArgs");
+			let prerunArgsChanged = false;
+			if (prerunArgs !== void 0) {
+				const prerunArgsData = (0, _milaboratories_ts_helpers.canonicalJsonBytes)(prerunArgs);
+				const oldPrerunArgsData = info.fields.currentPrerunArgs?.value;
+				if (oldPrerunArgsData === void 0 || Buffer.compare(oldPrerunArgsData, prerunArgsData) !== 0) prerunArgsChanged = true;
+				const prerunArgsRef = this.tx.createValue(_milaboratories_pl_client.Pl.JsonObject, prerunArgsData);
+				this.setBlockField(req.blockId, "currentPrerunArgs", prerunArgsRef, "Ready", prerunArgsData);
+			} else if (info.fields.currentPrerunArgs !== void 0) prerunArgsChanged = true;
+			blockChanged = true;
+			if (prerunArgsChanged) changedArgs.push(req.blockId);
+			if (blockChanged) {
+				this.blocksWithChangedInputs.add(req.blockId);
+				somethingChanged = true;
+			}
+		}
+		this.getStagingGraph().traverse("downstream", changedArgs, ({ id }) => this.resetStaging(id));
+		if (somethingChanged) this.updateLastModified();
+	}
+	setBlockSettings(blockId, newValue) {
+		this.setBlockFieldObj(blockId, "blockSettings", this.createJsonFieldValue(newValue));
+		this.updateLastModified();
+	}
+	createProdCtx(upstream) {
+		const upstreamContexts = [];
+		upstream.forEach((id) => {
+			const info = this.getBlockInfo(id);
+			if (info.fields["prodCtx"]?.ref === void 0) throw new Error("One of the upstreams staging is not rendered.");
+			upstreamContexts.push(_milaboratories_pl_client.Pl.unwrapHolder(this.tx, info.fields["prodCtx"].ref));
+		});
+		return require_render_block.createBContextFromUpstreams(this.tx, upstreamContexts);
+	}
+	createStagingCtx(upstream) {
+		const upstreamContexts = [];
+		upstream.forEach((id) => {
+			const info = this.getBlockInfo(id);
+			if (info.fields["stagingCtx"]?.ref === void 0) throw new Error("One of the upstreams staging is not rendered.");
+			upstreamContexts.push(_milaboratories_pl_client.Pl.unwrapHolder(this.tx, info.fields["stagingCtx"].ref));
+			if (info.fields["prodCtx"]?.ref !== void 0) upstreamContexts.push(_milaboratories_pl_client.Pl.unwrapHolder(this.tx, info.fields["prodCtx"].ref));
+		});
+		return require_render_block.createBContextFromUpstreams(this.tx, upstreamContexts);
+	}
+	exportCtx(ctx) {
+		return require_context_export.exportContext(this.tx, _milaboratories_pl_client.Pl.unwrapHolder(this.tx, this.ctxExportTplHolder), ctx);
+	}
+	/**
+	* Renders staging for a block using currentPrerunArgs.
+	* If currentPrerunArgs is not set (prerunArgs returned undefined), skips staging for this block.
+	*/
+	renderStagingFor(blockId) {
+		this.resetStaging(blockId);
+		const info = this.getBlockInfo(blockId);
+		const prerunArgsRef = info.fields.currentPrerunArgs?.ref;
+		if (prerunArgsRef === void 0) return;
+		const ctx = this.createStagingCtx(this.getStagingGraph().nodes.get(blockId).upstream);
+		if (this.getBlock(blockId).renderingMode !== "Heavy") throw new Error("not supported yet");
+		const tpl = info.getTemplate(this.tx);
+		const results = require_render_block.createRenderHeavyBlock(this.tx, tpl, {
+			args: prerunArgsRef,
+			blockId: this.tx.createValue(_milaboratories_pl_client.Pl.JsonString, JSON.stringify(blockId)),
+			isProduction: this.tx.createValue(_milaboratories_pl_client.Pl.JsonBool, JSON.stringify(false)),
+			context: ctx
+		});
+		this.setBlockField(blockId, "stagingCtx", _milaboratories_pl_client.Pl.wrapInEphHolder(this.tx, ctx), "NotReady");
+		this.setBlockField(blockId, "stagingUiCtx", this.exportCtx(results.context), "NotReady");
+		this.setBlockField(blockId, "stagingOutput", results.result, "NotReady");
+	}
+	renderProductionFor(blockId) {
+		this.resetProduction(blockId);
+		const info = this.getBlockInfo(blockId);
+		if (info.fields.currentArgs === void 0) throw new Error(`Can't render production for block ${blockId}: currentArgs not set`);
+		const ctx = this.createProdCtx(this.getPendingProductionGraph().nodes.get(blockId).upstream);
+		if (this.getBlock(blockId).renderingMode === "Light") throw new Error("Can't render production for light block.");
+		const tpl = info.getTemplate(this.tx);
+		const results = require_render_block.createRenderHeavyBlock(this.tx, tpl, {
+			args: info.fields.currentArgs.ref,
+			blockId: this.tx.createValue(_milaboratories_pl_client.Pl.JsonString, JSON.stringify(blockId)),
+			isProduction: this.tx.createValue(_milaboratories_pl_client.Pl.JsonBool, JSON.stringify(true)),
+			context: ctx
+		});
+		this.setBlockField(blockId, "prodCtx", _milaboratories_pl_client.Pl.wrapInEphHolder(this.tx, results.context), "NotReady");
+		this.setBlockField(blockId, "prodUiCtx", this.exportCtx(results.context), "NotReady");
+		this.setBlockField(blockId, "prodOutput", results.result, "NotReady");
+		this.setBlockFieldObj(blockId, "prodArgs", info.fields.currentArgs);
+		if (this.blocksInLimbo.delete(blockId)) this.renderingStateChanged = true;
+	}
+	initializeNewBlock(blockId, spec) {
+		const info = new BlockInfo(blockId, {}, (0, _platforma_sdk_model.extractConfig)(spec.blockPack.config), spec.blockPack.source);
+		this.blockInfos.set(blockId, info);
+		const bp = require_block_pack.createBlockPack(this.tx, spec.blockPack);
+		this.setBlockField(blockId, "blockPack", _milaboratories_pl_client.Pl.wrapInHolder(this.tx, bp), "NotReady");
+		this.setBlockFieldObj(blockId, "blockSettings", this.createJsonFieldValue(_milaboratories_pl_model_middle_layer.InitialBlockSettings));
+		const blockConfig = info.config;
+		let args;
+		let prerunArgs;
+		let storageToWrite;
+		if (spec.storageMode === "fromModel") {
+			storageToWrite = this.projectHelper.getInitialStorageInVM(blockConfig);
+			const deriveArgsResult = this.projectHelper.deriveArgsFromStorage(blockConfig, storageToWrite);
+			if (deriveArgsResult.error) {
+				args = void 0;
+				prerunArgs = void 0;
+			} else {
+				args = deriveArgsResult.value;
+				prerunArgs = this.projectHelper.derivePrerunArgsFromStorage(blockConfig, storageToWrite);
+			}
+		} else if (spec.storageMode === "legacy") {
+			args = JSON.parse(spec.legacyState).args;
+			if (args === void 0) throw new Error("args is undefined in legacyState");
+			prerunArgs = args;
+			storageToWrite = spec.legacyState;
+		} else throw new Error(`Unknown storageMode: ${spec.storageMode}`);
+		if (args !== void 0) this.setBlockFieldObj(blockId, "currentArgs", this.createJsonFieldValue(args));
+		if (prerunArgs !== void 0) this.setBlockFieldObj(blockId, "currentPrerunArgs", this.createJsonFieldValue(prerunArgs));
+		this.setBlockFieldObj(blockId, "blockStorage", this.createJsonFieldValueByContent(storageToWrite));
+		info.check();
+	}
+	getFieldNamesToDuplicate(blockId) {
+		const fields = this.getBlockInfo(blockId).fields;
+		const diff = (setA, setB) => new Set([...setA].filter((x) => !setB.has(x)));
+		if (fields.prodOutput?.status === "Ready" && fields.prodCtx?.status === "Ready") {
+			if (this.blocksInLimbo.has(blockId)) return require_project_model.FieldsToDuplicate;
+			return diff(require_project_model.FieldsToDuplicate, new Set([
+				"prodOutputPrevious",
+				"prodCtxPrevious",
+				"prodUiCtxPrevious"
+			]));
+		} else return diff(require_project_model.FieldsToDuplicate, new Set([
+			"prodOutput",
+			"prodCtx",
+			"prodUiCtx",
+			"prodArgs",
+			"prodOutputPrevious",
+			"prodCtxPrevious",
+			"prodUiCtxPrevious"
+		]));
+	}
+	initializeBlockDuplicate(blockId, originalBlockInfo) {
+		const info = new BlockInfo(blockId, {}, originalBlockInfo.config, originalBlockInfo.source);
+		this.blockInfos.set(blockId, info);
+		const fieldNamesToDuplicate = this.getFieldNamesToDuplicate(blockId);
+		for (const [fieldName, fieldState] of Object.entries(originalBlockInfo.fields)) if (fieldNamesToDuplicate.has(fieldName) && fieldState && fieldState.ref) this.setBlockFieldObj(blockId, fieldName, {
+			ref: fieldState.ref,
+			status: fieldState.status,
+			value: fieldState.value
+		});
+		this.resetOrLimboProduction(blockId);
+		info.check();
+	}
+	/** Very generic method, better check for more specialized case-specific methods first. */
+	updateStructure(newStructure, newBlockInitializer = NoNewBlocks) {
+		const currentStagingGraph = this.getStagingGraph();
+		const currentActualProductionGraph = this.getActualProductionGraph();
+		const stagingDiff = require_project_model_util.graphDiff(currentStagingGraph, require_project_model_util.stagingGraph(newStructure));
+		for (const blockId of stagingDiff.onlyInA) {
+			const { fields } = this.getBlockInfo(blockId);
+			this.deleteBlockFields(blockId, ...Object.keys(fields));
+			this.blockInfos.delete(blockId);
+			if (this.blocksInLimbo.delete(blockId)) this.renderingStateChanged = true;
+		}
+		for (const blockId of stagingDiff.onlyInB) newBlockInitializer(blockId);
+		for (const blockId of stagingDiff.different) this.resetStaging(blockId);
+		const prodDiff = require_project_model_util.graphDiff(currentActualProductionGraph, require_project_model_util.productionGraph(newStructure, (blockId) => this.getProductionGraphBlockInfo(blockId, true)));
+		currentActualProductionGraph.traverse("downstream", [...prodDiff.different], (node) => {
+			this.resetOrLimboProduction(node.id);
+		});
+		if (stagingDiff.onlyInB.size > 0 || stagingDiff.onlyInA.size > 0 || stagingDiff.different.size > 0) this.resetStagingRefreshTimestamp();
+		this.struct = newStructure;
+		this.structureChanged = true;
+		this.stagingGraph = void 0;
+		this.pendingProductionGraph = void 0;
+		this.actualProductionGraph = void 0;
+		this.updateLastModified();
+	}
+	addBlock(block, spec, before) {
+		const newStruct = this.structure;
+		if (before === void 0) newStruct.groups[newStruct.groups.length - 1].blocks.push(block);
+		else {
+			let done = false;
+			for (const group of newStruct.groups) {
+				const idx = group.blocks.findIndex((b) => b.id === before);
+				if (idx < 0) continue;
+				group.blocks.splice(idx, 0, block);
+				done = true;
+				break;
+			}
+			if (!done) throw new Error(`Can't find element with id: ${before}`);
+		}
+		this.updateStructure(newStruct, (blockId) => {
+			if (blockId !== block.id) throw new Error("Unexpected");
+			this.initializeNewBlock(blockId, spec);
+		});
+	}
+	/**
+	* Duplicates an existing block by copying all its fields and structure.
+	* This method creates a deep copy of the block at the mutator level.
+	*
+	* @param originalBlockId id of the block to duplicate
+	* @param newBlockId id for the new duplicated block
+	* @param after id of the block to insert new block after
+	*/
+	duplicateBlock(originalBlockId, newBlockId, after) {
+		const originalBlock = this.getBlock(originalBlockId);
+		const originalBlockInfo = this.getBlockInfo(originalBlockId);
+		const newBlock = {
+			id: newBlockId,
+			label: originalBlock.label,
+			renderingMode: originalBlock.renderingMode
+		};
+		const newStruct = this.structure;
+		if (after === void 0) newStruct.groups[newStruct.groups.length - 1].blocks.push(newBlock);
+		else {
+			let done = false;
+			for (const group of newStruct.groups) {
+				const idx = group.blocks.findIndex((b) => b.id === after);
+				if (idx < 0) continue;
+				group.blocks.splice(idx + 1, 0, newBlock);
+				done = true;
+				break;
+			}
+			if (!done) throw new Error(`Can't find element with id: ${after}`);
+		}
+		this.updateStructure(newStruct, (blockId) => {
+			if (blockId !== newBlockId) throw new Error("Unexpected");
+			this.initializeBlockDuplicate(blockId, originalBlockInfo);
+		});
+	}
+	deleteBlock(blockId) {
+		const newStruct = this.structure;
+		let done = false;
+		for (const group of newStruct.groups) {
+			const idx = group.blocks.findIndex((b) => b.id === blockId);
+			if (idx < 0) continue;
+			group.blocks.splice(idx, 1);
+			done = true;
+			break;
+		}
+		if (!done) throw new Error(`Can't find element with id: ${blockId}`);
+		this.updateStructure(newStruct);
+	}
+	migrateBlockPack(blockId, spec, newClearState) {
+		const info = this.getBlockInfo(blockId);
+		const newConfig = (0, _platforma_sdk_model.extractConfig)(spec.config);
+		const persistBlockPack = () => {
+			this.setBlockField(blockId, "blockPack", _milaboratories_pl_client.Pl.wrapInHolder(this.tx, require_block_pack.createBlockPack(this.tx, spec)), "NotReady");
+		};
+		const applyStorageAndDeriveArgs = (storageJson) => {
+			persistBlockPack();
+			this.setBlockStorageRaw(blockId, storageJson);
+			const deriveArgsResult = this.projectHelper.deriveArgsFromStorage(newConfig, storageJson);
+			if (!deriveArgsResult.error) {
+				this.setBlockFieldObj(blockId, "currentArgs", this.createJsonFieldValue(deriveArgsResult.value));
+				const prerunArgs = this.projectHelper.derivePrerunArgsFromStorage(newConfig, storageJson);
+				if (prerunArgs !== void 0) this.setBlockFieldObj(blockId, "currentPrerunArgs", this.createJsonFieldValue(prerunArgs));
+			}
+		};
+		if (newClearState !== void 0) if (newConfig.modelAPIVersion === _platforma_sdk_model.BLOCK_STORAGE_FACADE_VERSION) {
+			applyStorageAndDeriveArgs(this.projectHelper.getInitialStorageInVM(newConfig));
+			this.blocksWithChangedInputs.add(blockId);
+			this.updateLastModified();
+		} else {
+			persistBlockPack();
+			this.setStates([{
+				modelAPIVersion: 1,
+				blockId,
+				state: newClearState.state
+			}]);
+		}
+		else {
+			if (newConfig.modelAPIVersion === _platforma_sdk_model.BLOCK_STORAGE_FACADE_VERSION) {
+				const currentStorageJson = info.blockStorageJson;
+				const migrationResult = this.projectHelper.migrateStorageInVM(newConfig, currentStorageJson);
+				if (migrationResult.error !== void 0) throw new Error(`[migrateBlockPack] Block ${blockId} migration failed: ${migrationResult.error}`);
+				console.log(`[migrateBlockPack] Block ${blockId}: ${migrationResult.info}`);
+				applyStorageAndDeriveArgs(migrationResult.newStorageJson);
+			} else {
+				persistBlockPack();
+				if (info.fields.currentArgs !== void 0) this.setBlockFieldObj(blockId, "currentPrerunArgs", info.fields.currentArgs);
+			}
+			this.blocksWithChangedInputs.add(blockId);
+			this.getStagingGraph().traverse("downstream", [blockId], ({ id }) => this.resetStaging(id));
+		}
+		if (info.productionRendered) this.getActualProductionGraph().traverse("downstream", [blockId], ({ id }) => this.resetOrLimboProduction(id));
+		this.updateLastModified();
+	}
+	renderProduction(blockIds, addUpstreams = false) {
+		const blockIdsSet = new Set(blockIds);
+		const prodGraph = this.getPendingProductionGraph();
+		if (addUpstreams) prodGraph.traverse("upstream", blockIds, (node) => {
+			blockIdsSet.add(node.id);
+		});
+		else for (const blockId of blockIdsSet) {
+			const node = prodGraph.nodes.get(blockId);
+			if (node === void 0) throw new Error(`Can't find block with id: ${blockId}`);
+			for (const upstream of node.upstream) if (!blockIdsSet.has(upstream)) throw new Error("Can't render blocks not including all upstreams.");
+		}
+		const rendered = /* @__PURE__ */ new Set();
+		for (const block of require_project_model_util.allBlocks(this.structure)) {
+			if (!blockIdsSet.has(block.id)) continue;
+			let render = this.getBlockInfo(block.id).requireProductionRendering || this.blocksInLimbo.has(block.id);
+			if (!render) {
+				for (const upstream of prodGraph.nodes.get(block.id).upstream) if (rendered.has(upstream)) {
+					render = true;
+					break;
+				}
+			}
+			if (render) {
+				this.renderProductionFor(block.id);
+				rendered.add(block.id);
+			}
+		}
+		const renderedArray = [...rendered];
+		prodGraph.traverse("downstream", renderedArray, (node) => {
+			if (rendered.has(node.id)) return;
+			this.resetOrLimboProduction(node.id);
+		});
+		this.getStagingGraph().traverse("downstream", renderedArray, ({ id }) => {
+			if (renderedArray[0] !== id) this.resetStaging(id);
+		});
+		if (rendered.size > 0) this.updateLastModified();
+		return rendered;
+	}
+	/** Stops running blocks from the list and modify states of other blocks
+	* accordingly */
+	stopProduction(...blockIds) {
+		const activeProdGraph = this.getActualProductionGraph();
+		const queue = new denque.default(blockIds);
+		const queued = new Set(blockIds);
+		const stopped = [];
+		while (!queue.isEmpty()) {
+			const blockId = queue.shift();
+			const fields = this.getBlockInfo(blockId).fields;
+			if (fields.prodOutput?.status === "Ready" && fields.prodCtx?.status === "Ready") continue;
+			if (this.deleteBlockFields(blockId, "prodOutput", "prodCtx", "prodUiCtx", "prodArgs")) {
+				stopped.push(blockId);
+				for (const downstream of activeProdGraph.traverseIdsExcludingRoots("downstream", blockId)) {
+					if (queued.has(downstream)) continue;
+					queue.push(downstream);
+					queued.add(downstream);
+				}
+			}
+		}
+		for (const blockId of activeProdGraph.traverseIdsExcludingRoots("downstream", ...stopped)) this.resetOrLimboProduction(blockId);
+		this.getStagingGraph().traverse("downstream", stopped, ({ id }) => this.resetStaging(id));
+	}
+	traverseWithStagingLag(cb) {
+		const lags = /* @__PURE__ */ new Map();
+		this.getStagingGraph().nodes.forEach((node) => {
+			const info = this.getBlockInfo(node.id);
+			const requiresRendering = info.requireStagingRendering;
+			let lag = requiresRendering ? 1 : 0;
+			node.upstream.forEach((upstream) => {
+				const upstreamLag = lags.get(upstream);
+				if (upstreamLag === 0) return;
+				lag = Math.max(upstreamLag + 1, lag);
+			});
+			if (!requiresRendering && info.stagingRendered) {}
+			cb(node.id, lag);
+			lags.set(node.id, lag);
+		});
+	}
+	/** @param stagingRenderingRate rate in blocks per second */
+	refreshStagings(stagingRenderingRate) {
+		const elapsed = Date.now() - this.renderingState.stagingRefreshTimestamp;
+		const lagThreshold = stagingRenderingRate === void 0 ? void 0 : 1 + Math.max(0, elapsed * stagingRenderingRate / 1e3);
+		let rendered = 0;
+		this.traverseWithStagingLag((blockId, lag) => {
+			if (lag === 0) return;
+			if (lagThreshold === void 0 || lag <= lagThreshold) {
+				this.renderStagingFor(blockId);
+				rendered++;
+			}
+		});
+		if (rendered > 0) this.resetStagingRefreshTimestamp();
+	}
+	/** Updates project metadata */
+	setMeta(meta) {
+		this.meta = meta;
+		this.metaChanged = true;
+		this.updateLastModified();
+	}
+	/** @param stagingRenderingRate rate in blocks per second */
+	doRefresh(stagingRenderingRate) {
+		this.refreshStagings(stagingRenderingRate);
+		this.blockInfos.forEach((blockInfo) => {
+			if (blockInfo.fields.prodCtx?.status === "Ready" && blockInfo.fields.prodOutput?.status === "Ready") this.deleteBlockFields(blockInfo.id, "prodOutputPrevious", "prodCtxPrevious", "prodUiCtxPrevious");
+			if (blockInfo.fields.stagingCtx?.status === "Ready" && blockInfo.fields.stagingOutput?.status === "Ready") this.deleteBlockFields(blockInfo.id, "stagingOutputPrevious", "stagingCtxPrevious", "stagingUiCtxPrevious");
+		});
+	}
+	assignAuthorMarkers() {
+		const markerStr = this.author ? JSON.stringify(this.author) : void 0;
+		for (const blockId of this.blocksWithChangedInputs) if (markerStr === void 0) this.tx.deleteKValue(this.rid, require_project_model.blockArgsAuthorKey(blockId));
+		else this.tx.setKValue(this.rid, require_project_model.blockArgsAuthorKey(blockId), markerStr);
+		if (this.metaChanged || this.structureChanged) if (markerStr === void 0) this.tx.deleteKValue(this.rid, require_project_model.ProjectStructureAuthorKey);
+		else this.tx.setKValue(this.rid, require_project_model.ProjectStructureAuthorKey, markerStr);
+	}
+	save() {
+		if (!this.wasModified) return;
+		if (this.lastModifiedChanged) this.tx.setKValue(this.rid, require_project_model.ProjectLastModifiedTimestamp, JSON.stringify(this.lastModified));
+		if (this.structureChanged) this.tx.setKValue(this.rid, require_project_model.ProjectStructureKey, JSON.stringify(this.struct));
+		if (this.renderingStateChanged) this.tx.setKValue(this.rid, require_project_model.BlockRenderingStateKey, JSON.stringify({
+			...this.renderingState,
+			blocksInLimbo: [...this.blocksInLimbo]
+		}));
+		if (this.metaChanged) this.tx.setKValue(this.rid, require_project_model.ProjectMetaKey, JSON.stringify(this.meta));
+		this.assignAuthorMarkers();
+	}
+	static async load(projectHelper, tx, rid, author) {
+		const fullResourceStateP = tx.getResourceData(rid, true);
+		const schemaP = tx.getKValueJson(rid, require_project_model.SchemaVersionKey);
+		const lastModifiedP = tx.getKValueJson(rid, require_project_model.ProjectLastModifiedTimestamp);
+		const metaP = tx.getKValueJson(rid, require_project_model.ProjectMetaKey);
+		const structureP = tx.getKValueJson(rid, require_project_model.ProjectStructureKey);
+		const renderingStateP = tx.getKValueJson(rid, require_project_model.BlockRenderingStateKey);
+		const fullResourceState = await fullResourceStateP;
+		const blockInfoStates = /* @__PURE__ */ new Map();
+		for (const f of fullResourceState.fields) {
+			const projectField = require_project_model.parseProjectField(f.name);
+			if (projectField === void 0) continue;
+			let info = blockInfoStates.get(projectField.blockId);
+			if (info === void 0) {
+				info = {
+					id: projectField.blockId,
+					fields: {}
+				};
+				blockInfoStates.set(projectField.blockId, info);
+			}
+			info.fields[projectField.fieldName] = (0, _milaboratories_pl_client.isNullResourceId)(f.value) ? { modCount: 0 } : {
+				modCount: 0,
+				ref: f.value
+			};
+		}
+		const blockFieldRequests = [];
+		blockInfoStates.forEach((info) => {
+			const fields = info.fields;
+			for (const [fName, state] of Object.entries(fields)) {
+				if (state.ref === void 0) continue;
+				if (!(0, _milaboratories_pl_client.isResource)(state.ref) || (0, _milaboratories_pl_client.isResourceRef)(state.ref)) throw new Error("unexpected behaviour");
+				const fieldName = fName;
+				blockFieldRequests.push([
+					info,
+					fieldName,
+					state,
+					tx.getResourceData(state.ref, fieldName == "blockPack")
+				]);
+			}
+		});
+		const [schema, lastModified, meta, structure, { stagingRefreshTimestamp, blocksInLimbo }] = await Promise.all([
+			schemaP,
+			lastModifiedP,
+			metaP,
+			structureP,
+			renderingStateP
+		]);
+		if (schema !== require_project_model.SchemaVersionCurrent) if (Number(schema) < Number(require_project_model.SchemaVersionCurrent)) throw new _platforma_sdk_model.UiError(`Can't perform this action on this project because it has older schema. Try (re)loading the project to update it.`);
+		else throw new _platforma_sdk_model.UiError(`Can't perform this action on this project because it has newer schema. Upgrade your desktop app to the latest version.`);
+		const blockPackRequests = [];
+		for (const [info, fieldName, state, response] of blockFieldRequests) {
+			const result = await response;
+			state.value = result.data;
+			if ((0, _milaboratories_pl_client.isNotNullResourceId)(result.error)) state.status = "Error";
+			else if (result.resourceReady || (0, _milaboratories_pl_client.isNotNullResourceId)(result.originalResourceId)) state.status = "Ready";
+			else state.status = "NotReady";
+			if (fieldName === "blockPack") {
+				const refField = result.fields.find((f) => f.name === _milaboratories_pl_client.Pl.HolderRefField);
+				if (refField === void 0) throw new Error("Block pack ref field is missing");
+				blockPackRequests.push([info, tx.getResourceData((0, _milaboratories_pl_client.ensureResourceIdNotNull)(refField.value), false)]);
+			}
+		}
+		for (const [info, response] of blockPackRequests) {
+			const bpInfo = (0, _milaboratories_ts_helpers.cachedDeserialize)((0, _milaboratories_ts_helpers.notEmpty)((await response).data));
+			info.blockConfig = (0, _platforma_sdk_model.extractConfig)(bpInfo.config);
+			info.blockPack = bpInfo.source;
+		}
+		const ctxExportTplEnvelope = await require_context_export.getPreparedExportTemplateEnvelope();
+		const ctxExportTplCacheFieldName = require_project_model.getServiceTemplateField(ctxExportTplEnvelope.hash);
+		const ctxExportTplField = fullResourceState.fields.find((f) => f.name === ctxExportTplCacheFieldName);
+		let ctxExportTplHolder;
+		if (ctxExportTplField !== void 0) ctxExportTplHolder = (0, _milaboratories_pl_client.ensureResourceIdNotNull)(ctxExportTplField.value);
+		else {
+			ctxExportTplHolder = _milaboratories_pl_client.Pl.wrapInHolder(tx, require_template_loading.loadTemplate(tx, ctxExportTplEnvelope.spec));
+			tx.createField((0, _milaboratories_pl_client.field)(rid, require_project_model.getServiceTemplateField(ctxExportTplEnvelope.hash)), "Dynamic", ctxExportTplHolder);
+		}
+		const renderingState = { stagingRefreshTimestamp };
+		const blocksInLimboSet = new Set(blocksInLimbo);
+		const blockInfos = /* @__PURE__ */ new Map();
+		blockInfoStates.forEach(({ id, fields, blockConfig, blockPack }) => blockInfos.set(id, new BlockInfo(id, fields, (0, _milaboratories_ts_helpers.notEmpty)(blockConfig), (0, _milaboratories_ts_helpers.notEmpty)(blockPack))));
+		const blockInStruct = /* @__PURE__ */ new Set();
+		for (const b of require_project_model_util.allBlocks(structure)) {
+			if (!blockInfos.has(b.id)) throw new Error(`Inconsistent project structure: no inputs for ${b.id}`);
+			blockInStruct.add(b.id);
+		}
+		blockInfos.forEach((info) => {
+			if (!blockInStruct.has(info.id)) throw new Error(`Inconsistent project structure: no structure entry for ${info.id}`);
+			info.check();
+		});
+		const prj = new ProjectMutator(rid, tx, author, schema, lastModified, meta, structure, renderingState, blocksInLimboSet, blockInfos, ctxExportTplHolder, projectHelper);
+		prj.fixProblemsAndMigrate();
+		return prj;
+	}
+};
+async function createProject(tx, meta = require_project_model.InitialBlockMeta) {
+	const prj = tx.createEphemeral(require_project_model.ProjectResourceType);
+	tx.lock(prj);
+	const ts = String(Date.now());
+	tx.setKValue(prj, require_project_model.SchemaVersionKey, JSON.stringify(require_project_model.SchemaVersionCurrent));
+	tx.setKValue(prj, require_project_model.ProjectCreatedTimestamp, ts);
+	tx.setKValue(prj, require_project_model.ProjectLastModifiedTimestamp, ts);
+	tx.setKValue(prj, require_project_model.ProjectMetaKey, JSON.stringify(meta));
+	tx.setKValue(prj, require_project_model.ProjectStructureKey, JSON.stringify(require_project_model.InitialBlockStructure));
+	tx.setKValue(prj, require_project_model.BlockRenderingStateKey, JSON.stringify(require_project_model.InitialProjectRenderingState));
+	const ctxExportTplEnvelope = await require_context_export.getPreparedExportTemplateEnvelope();
+	tx.createField((0, _milaboratories_pl_client.field)(prj, require_project_model.getServiceTemplateField(ctxExportTplEnvelope.hash)), "Dynamic", _milaboratories_pl_client.Pl.wrapInHolder(tx, require_template_loading.loadTemplate(tx, ctxExportTplEnvelope.spec)));
+	return prj;
 }
 async function withProject(projectHelper, txOrPl, rid, cb, ops) {
-    return withProjectAuthored(projectHelper, txOrPl, rid, undefined, cb, ops);
+	return withProjectAuthored(projectHelper, txOrPl, rid, void 0, cb, ops);
 }
 async function withProjectAuthored(projectHelper, txOrPl, rid, author, cb, ops = {}) {
-    if (txOrPl instanceof plClient.PlClient) {
-        return await txOrPl.withWriteTx("ProjectAction" + (ops.name ? `: ${ops.name}` : ""), async (tx) => {
-            const mut = await ProjectMutator.load(projectHelper, tx, rid, author);
-            const result = await cb(mut);
-            if (!mut.wasModified)
-                // skipping save and commit altogether if no modifications were actually made
-                return result;
-            mut.save();
-            await tx.commit();
-            if (index.getDebugFlags().logProjectMutationStat)
-                console.log(JSON.stringify(tx.stat));
-            return result;
-        }, ops);
-    }
-    else {
-        const mut = await ProjectMutator.load(projectHelper, txOrPl, rid, author);
-        const result = await cb(mut);
-        mut.save();
-        return result;
-    }
+	if (txOrPl instanceof _milaboratories_pl_client.PlClient) return await txOrPl.withWriteTx("ProjectAction" + (ops.name ? `: ${ops.name}` : ""), async (tx) => {
+		const mut = await ProjectMutator.load(projectHelper, tx, rid, author);
+		const result = await cb(mut);
+		if (!mut.wasModified) return result;
+		mut.save();
+		await tx.commit();
+		if (require_index.getDebugFlags().logProjectMutationStat) console.log(JSON.stringify(tx.stat));
+		return result;
+	}, ops);
+	else {
+		const mut = await ProjectMutator.load(projectHelper, txOrPl, rid, author);
+		const result = await cb(mut);
+		mut.save();
+		return result;
+	}
 }
 
-exports.ProjectMutator = ProjectMutator;
+//#endregion
 exports.createProject = createProject;
 exports.withProject = withProject;
 exports.withProjectAuthored = withProjectAuthored;
-//# sourceMappingURL=project.cjs.map
+//# sourceMappingURL=project.cjs.map