@milaboratories/pl-middle-layer 1.74.10 → 1.74.12

package/dist/mutator/block-pack/block_pack.js.map

@@ -1 +1 @@
-{"version":3,"file":"block_pack.js","names":[],"sources":["../../../src/mutator/block-pack/block_pack.ts"],"sourcesContent":["import type { AnyResourceRef, PlTransaction, ResourceType } from \"@milaboratories/pl-client\";\nimport { field } from \"@milaboratories/pl-client\";\nimport { loadTemplate } from \"../template/template_loading\";\nimport type { BlockPackExplicit, BlockPackSpecAny, BlockPackSpecPrepared } from \"../../model\";\nimport type { Signer } from \"@milaboratories/ts-helpers\";\nimport { assertNever } from \"@milaboratories/ts-helpers\";\nimport type { Branded } from \"@milaboratories/pl-model-common\";\nimport fs from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport type { Dispatcher } from \"undici\";\nimport { request } from \"undici\";\nimport { createFrontend } from \"./frontend\";\nimport { requiredCapabilitiesFromTemplate } from \"./required_capabilities\";\nimport type { BlockConfigContainer } from \"@platforma-sdk/model\";\nimport { Code } from \"@platforma-sdk/model\";\nimport {\n  loadPackDescription,\n  loadPackDescriptionFromManifest,\n  RegistryV1,\n} from \"@platforma-sdk/block-tools\";\nimport type { BlockPackInfo } from \"../../model/block_pack\";\nimport { resolveDevPacket } from \"../../dev_env\";\nimport { getDevV2PacketMtime, getFromPackV2Mtime } from \"../../block_registry\";\nimport type { V2RegistryProvider } from \"../../block_registry/registry-v2-provider\";\nimport { LRUCache } from \"lru-cache\";\nimport canonicalize from \"canonicalize\";\nimport type { BlockPackSpec } from \"@milaboratories/pl-model-middle-layer\";\nimport { WorkerManager } from \"../../worker/WorkerManager\";\nimport { z } from \"zod\";\n\ntype PreparedCacheKey = Branded<string, \"PreparedCacheKey\">;\n\nexport const BlockPackCustomType: ResourceType = { name: \"BlockPackCustom\", version: \"1\" };\nexport const BlockPackTemplateField = \"template\";\nexport const BlockPackFrontendField = \"frontend\";\n\n/** Ensure trailing slash */\nfunction tSlash(str: string): string {\n  if (str.endsWith(\"/\")) return str;\n  else return `${str}/`;\n}\n\nfunction parseStringConfig(configContent: string): BlockConfigContainer {\n  const res = z.record(z.string(), z.unknown()).safeParse(JSON.parse(configContent));\n\n  if (!res.success) {\n    throw new Error(\"Invalid config content\");\n  }\n\n  if (!Code.safeParse(res.data.code).success) {\n    throw new Error(\"parseStringConfig:No code bundle\");\n  }\n\n  return res.data as BlockConfigContainer;\n}\n\nfunction parseBufferConfig(buffer: ArrayBuffer): BlockConfigContainer {\n  return parseStringConfig(Buffer.from(buffer).toString(\"utf8\"));\n}\n\nexport class BlockPackPreparer {\n  constructor(\n    private readonly v2RegistryProvider: V2RegistryProvider,\n    private readonly signer: Signer,\n    private readonly http?: Dispatcher,\n  ) {}\n\n  private readonly remoteContentCache = new LRUCache<string, ArrayBuffer>({\n    max: 500,\n    maxSize: 128 * 1024 * 1024,\n    fetchMethod: async (key) => {\n      const httpOptions = this.http !== undefined ? { dispatcher: this.http } : {};\n      return await (await request(key, httpOptions)).body.arrayBuffer();\n    },\n    sizeCalculation: (value) => value.byteLength,\n  });\n\n  /** Cache of prepared block packs for registry specs (immutable by version). */\n  private readonly preparedCache = new LRUCache<PreparedCacheKey, BlockPackSpecPrepared>({\n    max: 50,\n  });\n\n  public async getBlockConfigContainer(spec: BlockPackSpecAny): Promise<BlockConfigContainer> {\n    switch (spec.type) {\n      case \"explicit\":\n        return spec.config;\n\n      case \"prepared\":\n        return spec.config;\n\n      case \"dev-v1\": {\n        const devPaths = await resolveDevPacket(spec.folder, false);\n        const configContent = await fs.promises.readFile(devPaths.config, { encoding: \"utf-8\" });\n        return JSON.parse(configContent);\n      }\n\n      case \"dev-v2\": {\n        const description = await loadPackDescription(spec.folder);\n        const configContent = await fs.promises.readFile(description.components.model.file, {\n          encoding: \"utf-8\",\n        });\n        return parseStringConfig(configContent);\n      }\n\n      case \"from-pack-v2\": {\n        // packUrl is a file: URL (the facade emits URLs, not paths); convert at\n        // this Node boundary before touching the filesystem.\n        const packDir = fileURLToPath(spec.packUrl);\n        const description = await loadPackDescriptionFromManifest(packDir);\n        const configContent = await fs.promises.readFile(description.components.model.file, {\n          encoding: \"utf-8\",\n        });\n        return parseStringConfig(configContent);\n      }\n\n      case \"from-registry-v1\": {\n        const urlPrefix = `${tSlash(spec.registryUrl)}${RegistryV1.packageContentPrefix({ organization: spec.id.organization, package: spec.id.name, version: spec.id.version })}`;\n\n        const configResponse = await this.remoteContentCache.forceFetch(`${urlPrefix}/config.json`);\n        return JSON.parse(Buffer.from(configResponse).toString(\"utf8\"));\n      }\n\n      case \"from-registry-v2\": {\n        const registry = this.v2RegistryProvider.getRegistry(spec.registryUrl);\n        const components = await registry.getComponents(spec.id);\n        const configResponse = await this.remoteContentCache.forceFetch(components.model.url);\n        return parseBufferConfig(configResponse);\n      }\n\n      default:\n        return assertNever(spec);\n    }\n  }\n\n  /** Returns a stable cache key for registry specs (immutable by version). Dev specs return undefined. */\n  private specKey(spec: BlockPackSpecAny): PreparedCacheKey | undefined {\n    switch (spec.type) {\n      case \"from-registry-v1\":\n        return `v1:${spec.registryUrl}:${spec.id.organization}:${spec.id.name}:${spec.id.version}` as PreparedCacheKey;\n      case \"from-registry-v2\":\n        return `v2:${spec.registryUrl}:${canonicalize(spec.id)}` as PreparedCacheKey;\n      default:\n        return undefined; // dev, explicit, prepared — not cacheable\n    }\n  }\n\n  public async prepare(spec: BlockPackSpecAny): Promise<BlockPackSpecPrepared> {\n    if (spec.type === \"prepared\") {\n      return spec;\n    }\n\n    // Check prepare cache for registry specs\n    const key = this.specKey(spec);\n    if (key) {\n      const cached = this.preparedCache.get(key);\n      if (cached) return cached;\n    }\n\n    const explicit = await this.prepareWithoutUnpacking(spec);\n\n    await using workerManager = new WorkerManager();\n\n    const parsed = await workerManager.process(\"parseTemplate\", explicit.template.content);\n\n    const result: BlockPackSpecPrepared = {\n      ...explicit,\n      type: \"prepared\",\n      template: {\n        type: \"prepared\",\n        data: parsed,\n      },\n      requiredCapabilities: requiredCapabilitiesFromTemplate(parsed),\n    };\n\n    if (key) {\n      this.preparedCache.set(key, result);\n    }\n\n    return result;\n  }\n\n  private async prepareWithoutUnpacking(\n    spec: BlockPackExplicit | BlockPackSpec,\n  ): Promise<BlockPackExplicit> {\n    switch (spec.type) {\n      case \"explicit\":\n        return spec;\n\n      case \"dev-v1\": {\n        const devPaths = await resolveDevPacket(spec.folder, false);\n\n        // template\n        const templateContent = await fs.promises.readFile(devPaths.workflow);\n\n        // config\n        const config = JSON.parse(await fs.promises.readFile(devPaths.config, \"utf-8\"));\n\n        // frontend\n        const frontendPath = devPaths.ui;\n\n        return {\n          type: \"explicit\",\n          template: {\n            type: \"explicit\",\n            content: templateContent,\n          },\n          config,\n          frontend: {\n            type: \"local\",\n            path: frontendPath,\n            signature: this.signer.sign(frontendPath),\n          },\n          source: spec,\n        };\n      }\n\n      case \"dev-v2\": {\n        const description = await loadPackDescription(spec.folder);\n        const config = parseStringConfig(\n          await fs.promises.readFile(description.components.model.file, {\n            encoding: \"utf-8\",\n          }),\n        );\n        const workflowContent = await fs.promises.readFile(\n          description.components.workflow.main.file,\n        );\n        const frontendPath = description.components.ui.folder;\n        const source = { ...spec };\n        if (spec.mtime === undefined)\n          // if absent, calculating the mtime here, so the block will correctly show whether it can be updated\n          source.mtime = await getDevV2PacketMtime(description);\n        return {\n          type: \"explicit\",\n          template: {\n            type: \"explicit\",\n            content: workflowContent,\n          },\n          config,\n          frontend: {\n            type: \"local\",\n            path: frontendPath,\n            signature: this.signer.sign(frontendPath),\n          },\n          source,\n        };\n      }\n\n      case \"from-pack-v2\": {\n        // packUrl is a file: URL (the facade emits URLs, not paths); convert at\n        // this Node boundary before touching the filesystem.\n        const packDir = fileURLToPath(spec.packUrl);\n        const description = await loadPackDescriptionFromManifest(packDir);\n        const config = parseStringConfig(\n          await fs.promises.readFile(description.components.model.file, {\n            encoding: \"utf-8\",\n          }),\n        );\n        const workflowContent = await fs.promises.readFile(\n          description.components.workflow.main.file,\n        );\n        // UI ships as ui.tgz inside block-pack/; its absolute path is carried\n        // in the ui folder slot. The tarball is unpacked lazily at serve-time by\n        // the download driver (local-tgz frontend), not eagerly here — so it\n        // inherits the driver's usage-tracking and space recycling.\n        const uiTgzPath = description.components.ui.folder;\n        const source = { ...spec };\n        let mtime = spec.mtime;\n        if (mtime === undefined) {\n          // No explicit mtime: derive one so the frontend cache key invalidates\n          // when the block changes.\n          mtime = await getFromPackV2Mtime(packDir, uiTgzPath);\n          source.mtime = mtime;\n        }\n        return {\n          type: \"explicit\",\n          template: {\n            type: \"explicit\",\n            content: workflowContent,\n          },\n          config,\n          frontend: {\n            type: \"local-tgz\",\n            path: uiTgzPath,\n            mtime,\n            signature: this.signer.sign(`${uiTgzPath}:${mtime}`),\n          },\n          source,\n        };\n      }\n\n      case \"from-registry-v1\": {\n        const urlPrefix = `${tSlash(spec.registryUrl)}${RegistryV1.packageContentPrefix({ organization: spec.id.organization, package: spec.id.name, version: spec.id.version })}`;\n\n        const templateUrl = `${urlPrefix}/template.plj.gz`;\n        // template\n        const templateResponse = await this.remoteContentCache.forceFetch(templateUrl);\n        const templateContent = new Uint8Array(templateResponse);\n\n        // config\n        const configResponse = await this.remoteContentCache.forceFetch(`${urlPrefix}/config.json`);\n        const config = JSON.parse(\n          Buffer.from(configResponse).toString(\"utf8\"),\n        ) as BlockConfigContainer;\n\n        return {\n          type: \"explicit\",\n          template: {\n            type: \"explicit\",\n            content: templateContent,\n          },\n          config,\n          frontend: {\n            type: \"url\",\n            url: `${urlPrefix}/frontend.tgz`,\n          },\n          source: spec,\n        };\n      }\n\n      case \"from-registry-v2\": {\n        const registry = this.v2RegistryProvider.getRegistry(spec.registryUrl);\n        const components = await registry.getComponents(spec.id);\n        const getModel = async () =>\n          parseBufferConfig(await this.remoteContentCache.forceFetch(components.model.url));\n        const getWorkflow = async () =>\n          await this.remoteContentCache.forceFetch(components.workflow.main.url);\n\n        const [model, workflow] = await Promise.all([getModel(), getWorkflow()]);\n        const workflowContent = Buffer.from(workflow);\n\n        return {\n          type: \"explicit\",\n          template: {\n            type: \"explicit\",\n            content: workflowContent,\n          },\n          config: model,\n          frontend: {\n            type: \"url\",\n            url: components.ui.url,\n          },\n          source: spec,\n        };\n      }\n\n      default:\n        return assertNever(spec);\n    }\n  }\n}\n\nfunction createCustomBlockPack(tx: PlTransaction, spec: BlockPackSpecPrepared): AnyResourceRef {\n  const blockPackInfo: BlockPackInfo = { config: spec.config, source: spec.source };\n  const bp = tx.createStruct(BlockPackCustomType, JSON.stringify(blockPackInfo));\n  tx.createField(field(bp, BlockPackTemplateField), \"Input\", loadTemplate(tx, spec.template));\n  tx.createField(field(bp, BlockPackFrontendField), \"Input\", createFrontend(tx, spec.frontend));\n  tx.lock(bp);\n\n  return bp;\n}\n\nexport function createBlockPack(tx: PlTransaction, spec: BlockPackSpecPrepared): AnyResourceRef {\n  switch (spec.type) {\n    case \"prepared\":\n      return createCustomBlockPack(tx, spec);\n    default:\n      return assertNever(spec.type);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"block_pack.js","names":[],"sources":["../../../src/mutator/block-pack/block_pack.ts"],"sourcesContent":["import type { AnyResourceRef, PlTransaction, ResourceType } from \"@milaboratories/pl-client\";\nimport { field } from \"@milaboratories/pl-client\";\nimport { loadTemplate } from \"../template/template_loading\";\nimport type { BlockPackExplicit, BlockPackSpecAny, BlockPackSpecPrepared } from \"../../model\";\nimport type { Signer } from \"@milaboratories/ts-helpers\";\nimport { assertNever } from \"@milaboratories/ts-helpers\";\nimport type { Branded } from \"@milaboratories/pl-model-common\";\nimport fs from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport type { Dispatcher } from \"undici\";\nimport { request } from \"undici\";\nimport { createFrontend } from \"./frontend\";\nimport { requiredCapabilitiesFromTemplate } from \"./required_capabilities\";\nimport type { BlockConfigContainer } from \"@platforma-sdk/model\";\nimport { Code } from \"@platforma-sdk/model\";\nimport {\n  loadPackDescription,\n  loadPackDescriptionFromManifest,\n  RegistryV1,\n} from \"@platforma-sdk/block-tools\";\nimport type { BlockPackInfo } from \"../../model/block_pack\";\nimport { resolveDevPacket } from \"../../dev_env\";\nimport { getDevV2PacketMtime, getFromPackV2Mtime } from \"../../block_registry\";\nimport type { V2RegistryProvider } from \"../../block_registry/registry-v2-provider\";\nimport { LRUCache } from \"lru-cache\";\nimport canonicalize from \"canonicalize\";\nimport type { BlockPackSpec } from \"@milaboratories/pl-model-middle-layer\";\nimport { WorkerManager } from \"../../worker/WorkerManager\";\nimport { z } from \"zod\";\n\ntype PreparedCacheKey = Branded<string, \"PreparedCacheKey\">;\n\nexport const BlockPackCustomType: ResourceType = { name: \"BlockPackCustom\", version: \"1\" };\nexport const BlockPackTemplateField = \"template\";\nexport const BlockPackFrontendField = \"frontend\";\n\n/** Ensure trailing slash */\nfunction tSlash(str: string): string {\n  if (str.endsWith(\"/\")) return str;\n  else return `${str}/`;\n}\n\nfunction parseStringConfig(configContent: string): BlockConfigContainer {\n  const res = z.record(z.string(), z.unknown()).safeParse(JSON.parse(configContent));\n\n  if (!res.success) {\n    throw new Error(\"Invalid config content\");\n  }\n\n  if (!Code.safeParse(res.data.code).success) {\n    throw new Error(\"parseStringConfig:No code bundle\");\n  }\n\n  return res.data as BlockConfigContainer;\n}\n\nfunction parseBufferConfig(buffer: ArrayBuffer): BlockConfigContainer {\n  return parseStringConfig(Buffer.from(buffer).toString(\"utf8\"));\n}\n\nexport class BlockPackPreparer {\n  constructor(\n    private readonly v2RegistryProvider: V2RegistryProvider,\n    private readonly signer: Signer,\n    private readonly http?: Dispatcher,\n  ) {}\n\n  private readonly remoteContentCache = new LRUCache<string, ArrayBuffer>({\n    max: 500,\n    maxSize: 128 * 1024 * 1024,\n    fetchMethod: async (key) => {\n      const httpOptions = this.http !== undefined ? { dispatcher: this.http } : {};\n      return await (await request(key, httpOptions)).body.arrayBuffer();\n    },\n    sizeCalculation: (value) => value.byteLength,\n  });\n\n  /** Cache of prepared block packs for registry specs (immutable by version). */\n  private readonly preparedCache = new LRUCache<PreparedCacheKey, BlockPackSpecPrepared>({\n    max: 50,\n  });\n\n  public async getBlockConfigContainer(spec: BlockPackSpecAny): Promise<BlockConfigContainer> {\n    switch (spec.type) {\n      case \"explicit\":\n        return spec.config;\n\n      case \"prepared\":\n        return spec.config;\n\n      case \"dev-v1\": {\n        const devPaths = await resolveDevPacket(spec.folder, false);\n        const configContent = await fs.promises.readFile(devPaths.config, { encoding: \"utf-8\" });\n        return JSON.parse(configContent);\n      }\n\n      case \"dev-v2\": {\n        const description = await loadPackDescription(spec.folder);\n        const configContent = await fs.promises.readFile(description.components.model.file, {\n          encoding: \"utf-8\",\n        });\n        return parseStringConfig(configContent);\n      }\n\n      case \"from-pack-v2\": {\n        // packUrl is a file: URL (the facade emits URLs, not paths); convert at\n        // this Node boundary before touching the filesystem.\n        const packDir = fileURLToPath(spec.packUrl);\n        const description = await loadPackDescriptionFromManifest(packDir);\n        const configContent = await fs.promises.readFile(description.components.model.file, {\n          encoding: \"utf-8\",\n        });\n        return parseStringConfig(configContent);\n      }\n\n      case \"from-registry-v1\": {\n        const urlPrefix = `${tSlash(spec.registryUrl)}${RegistryV1.packageContentPrefix({ organization: spec.id.organization, package: spec.id.name, version: spec.id.version })}`;\n\n        const configResponse = await this.remoteContentCache.forceFetch(`${urlPrefix}/config.json`);\n        return JSON.parse(Buffer.from(configResponse).toString(\"utf8\"));\n      }\n\n      case \"from-registry-v2\": {\n        const registry = this.v2RegistryProvider.getRegistry(spec.registryUrl);\n        const components = await registry.getComponents(spec.id);\n        const configResponse = await this.remoteContentCache.forceFetch(components.model.url);\n        return parseBufferConfig(configResponse);\n      }\n\n      default:\n        return assertNever(spec);\n    }\n  }\n\n  /** Returns a stable cache key for registry specs (immutable by version). Dev specs return undefined. */\n  private specKey(spec: BlockPackSpecAny): PreparedCacheKey | undefined {\n    switch (spec.type) {\n      case \"from-registry-v1\":\n        return `v1:${spec.registryUrl}:${spec.id.organization}:${spec.id.name}:${spec.id.version}` as PreparedCacheKey;\n      case \"from-registry-v2\":\n        return `v2:${spec.registryUrl}:${canonicalize(spec.id)}` as PreparedCacheKey;\n      default:\n        return undefined; // dev, explicit, prepared — not cacheable\n    }\n  }\n\n  public async prepare(spec: BlockPackSpecAny): Promise<BlockPackSpecPrepared> {\n    if (spec.type === \"prepared\") {\n      return spec;\n    }\n\n    // Check prepare cache for registry specs\n    const key = this.specKey(spec);\n    if (key) {\n      const cached = this.preparedCache.get(key);\n      if (cached) return cached;\n    }\n\n    const explicit = await this.prepareWithoutUnpacking(spec);\n\n    await using workerManager = new WorkerManager();\n\n    const parsed = await workerManager.process(\"parseTemplate\", explicit.template.content);\n\n    const result: BlockPackSpecPrepared = {\n      ...explicit,\n      type: \"prepared\",\n      template: {\n        type: \"prepared\",\n        data: parsed,\n      },\n      requiredCapabilities: requiredCapabilitiesFromTemplate(parsed),\n    };\n\n    if (key) {\n      this.preparedCache.set(key, result);\n    }\n\n    return result;\n  }\n\n  private async prepareWithoutUnpacking(\n    spec: BlockPackExplicit | BlockPackSpec,\n  ): Promise<BlockPackExplicit> {\n    switch (spec.type) {\n      case \"explicit\":\n        return spec;\n\n      case \"dev-v1\": {\n        const devPaths = await resolveDevPacket(spec.folder, false);\n\n        // template\n        const templateContent = await fs.promises.readFile(devPaths.workflow);\n\n        // config\n        const config = JSON.parse(await fs.promises.readFile(devPaths.config, \"utf-8\"));\n\n        // frontend\n        const frontendPath = devPaths.ui;\n\n        return {\n          type: \"explicit\",\n          template: {\n            type: \"explicit\",\n            content: templateContent,\n          },\n          config,\n          frontend: {\n            type: \"local\",\n            path: frontendPath,\n            signature: this.signer.sign(frontendPath),\n          },\n          source: spec,\n        };\n      }\n\n      case \"dev-v2\": {\n        const description = await loadPackDescription(spec.folder);\n        const config = parseStringConfig(\n          await fs.promises.readFile(description.components.model.file, {\n            encoding: \"utf-8\",\n          }),\n        );\n        const workflowContent = await fs.promises.readFile(\n          description.components.workflow.main.file,\n        );\n        const frontendPath = description.components.ui.folder;\n        const source = { ...spec };\n        if (spec.mtime === undefined)\n          // if absent, calculating the mtime here, so the block will correctly show whether it can be updated\n          source.mtime = await getDevV2PacketMtime(description);\n        return {\n          type: \"explicit\",\n          template: {\n            type: \"explicit\",\n            content: workflowContent,\n          },\n          config,\n          frontend: {\n            type: \"local\",\n            path: frontendPath,\n            signature: this.signer.sign(frontendPath),\n          },\n          source,\n        };\n      }\n\n      case \"from-pack-v2\": {\n        // packUrl is a file: URL (the facade emits URLs, not paths); convert at\n        // this Node boundary before touching the filesystem.\n        const packDir = fileURLToPath(spec.packUrl);\n        const description = await loadPackDescriptionFromManifest(packDir);\n        const config = parseStringConfig(\n          await fs.promises.readFile(description.components.model.file, {\n            encoding: \"utf-8\",\n          }),\n        );\n        const workflowContent = await fs.promises.readFile(\n          description.components.workflow.main.file,\n        );\n        // UI ships as ui.tgz inside block-pack/; its absolute path is carried\n        // in the ui folder slot. The tarball is unpacked lazily at serve-time by\n        // the download driver (local-tgz frontend), not eagerly here — so it\n        // inherits the driver's usage-tracking and space recycling.\n        const uiTgzPath = description.components.ui.folder;\n        const source = { ...spec };\n        let mtime = spec.mtime;\n        if (mtime === undefined) {\n          // No explicit mtime: derive one so the frontend cache key invalidates\n          // when the block changes.\n          mtime = await getFromPackV2Mtime(packDir, uiTgzPath);\n          source.mtime = mtime;\n        }\n        return {\n          type: \"explicit\",\n          template: {\n            type: \"explicit\",\n            content: workflowContent,\n          },\n          config,\n          frontend: {\n            type: \"local-tgz\",\n            path: uiTgzPath,\n            mtime,\n            signature: this.signer.sign(`${uiTgzPath}:${mtime}`),\n          },\n          source,\n        };\n      }\n\n      case \"from-registry-v1\": {\n        const urlPrefix = `${tSlash(spec.registryUrl)}${RegistryV1.packageContentPrefix({ organization: spec.id.organization, package: spec.id.name, version: spec.id.version })}`;\n\n        const templateUrl = `${urlPrefix}/template.plj.gz`;\n        // template\n        const templateResponse = await this.remoteContentCache.forceFetch(templateUrl);\n        const templateContent = new Uint8Array(templateResponse);\n\n        // config\n        const configResponse = await this.remoteContentCache.forceFetch(`${urlPrefix}/config.json`);\n        const config = JSON.parse(\n          Buffer.from(configResponse).toString(\"utf8\"),\n        ) as BlockConfigContainer;\n\n        return {\n          type: \"explicit\",\n          template: {\n            type: \"explicit\",\n            content: templateContent,\n          },\n          config,\n          frontend: {\n            type: \"url\",\n            url: `${urlPrefix}/frontend.tgz`,\n          },\n          source: spec,\n        };\n      }\n\n      case \"from-registry-v2\": {\n        const registry = this.v2RegistryProvider.getRegistry(spec.registryUrl);\n        const components = await registry.getComponents(spec.id);\n        const getModel = async () =>\n          parseBufferConfig(await this.remoteContentCache.forceFetch(components.model.url));\n        const getWorkflow = async () =>\n          await this.remoteContentCache.forceFetch(components.workflow.main.url);\n\n        const [model, workflow] = await Promise.all([getModel(), getWorkflow()]);\n        const workflowContent = Buffer.from(workflow);\n\n        return {\n          type: \"explicit\",\n          template: {\n            type: \"explicit\",\n            content: workflowContent,\n          },\n          config: model,\n          frontend: {\n            type: \"url\",\n            url: components.ui.url,\n          },\n          source: spec,\n        };\n      }\n\n      default:\n        return assertNever(spec);\n    }\n  }\n}\n\nfunction createCustomBlockPack(tx: PlTransaction, spec: BlockPackSpecPrepared): AnyResourceRef {\n  const blockPackInfo: BlockPackInfo = { config: spec.config, source: spec.source };\n  const bp = tx.createStruct(BlockPackCustomType, JSON.stringify(blockPackInfo));\n  tx.createField(field(bp, BlockPackTemplateField), \"Input\", loadTemplate(tx, spec.template));\n  tx.createField(field(bp, BlockPackFrontendField), \"Input\", createFrontend(tx, spec.frontend));\n  tx.lock(bp);\n\n  return bp;\n}\n\nexport function createBlockPack(tx: PlTransaction, spec: BlockPackSpecPrepared): AnyResourceRef {\n  switch (spec.type) {\n    case \"prepared\":\n      return createCustomBlockPack(tx, spec);\n    default:\n      return assertNever(spec.type);\n  }\n}\n"],"mappings":"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"}

package/dist/mutator/block-pack/frontend.cjs

@@ -1,7 +1,7 @@
 const require_block_pack_spec = require("../../model/block_pack_spec.cjs");
 require("../../model/index.cjs");
 let _milaboratories_ts_helpers = require("@milaboratories/ts-helpers");
-//#region src/mutator/block-pack/frontend.ts
+// src/mutator/block-pack/frontend.ts
 function createFrontend(tx, spec) {
 	switch (spec.type) {
 		case "url": return tx.createValue(require_block_pack_spec.FrontendFromUrlResourceType, JSON.stringify({ url: spec.url }));
@@ -17,7 +17,6 @@ function createFrontend(tx, spec) {
 		default: return (0, _milaboratories_ts_helpers.assertNever)(spec);
 	}
 }
-//#endregion
 exports.createFrontend = createFrontend;
 
 //# sourceMappingURL=frontend.cjs.map

package/dist/mutator/block-pack/frontend.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"frontend.cjs","names":["FrontendFromUrlResourceType","FrontendFromFolderResourceType","FrontendFromLocalTgzResourceType"],"sources":["../../../src/mutator/block-pack/frontend.ts"],"sourcesContent":["import type { AnyResourceRef, PlTransaction } from \"@milaboratories/pl-client\";\nimport type {\n  FrontendFromFolderData,\n  FrontendFromLocalTgzData,\n  FrontendFromUrlData,\n  FrontendSpec,\n} from \"../../model\";\nimport {\n  FrontendFromFolderResourceType,\n  FrontendFromLocalTgzResourceType,\n  FrontendFromUrlResourceType,\n} from \"../../model\";\nimport { assertNever } from \"@milaboratories/ts-helpers\";\n\nexport function createFrontend(tx: PlTransaction, spec: FrontendSpec): AnyResourceRef {\n  switch (spec.type) {\n    case \"url\":\n      return tx.createValue(\n        FrontendFromUrlResourceType,\n        JSON.stringify({ url: spec.url } as FrontendFromUrlData),\n      );\n    case \"local\":\n      return tx.createValue(\n        FrontendFromFolderResourceType,\n        JSON.stringify({\n          path: spec.path,\n          signature: spec.signature,\n        } as FrontendFromFolderData),\n      );\n    case \"local-tgz\":\n      return tx.createValue(\n        FrontendFromLocalTgzResourceType,\n        JSON.stringify({\n          path: spec.path,\n          mtime: spec.mtime,\n          signature: spec.signature,\n        } as FrontendFromLocalTgzData),\n      );\n    default:\n      return assertNever(spec);\n  }\n}\n"],"mappings":";;;;AAcA,SAAgB,eAAe,IAAmB,MAAoC;CACpF,QAAQ,KAAK,MAAb;EACE,KAAK,OACH,OAAO,GAAG,YACRA,wBAAAA,6BACA,KAAK,UAAU,EAAE,KAAK,KAAK,IAAI,CAAwB,CACzD;EACF,KAAK,SACH,OAAO,GAAG,YACRC,wBAAAA,gCACA,KAAK,UAAU;GACb,MAAM,KAAK;GACX,WAAW,KAAK;EAClB,CAA2B,CAC7B;EACF,KAAK,aACH,OAAO,GAAG,YACRC,wBAAAA,kCACA,KAAK,UAAU;GACb,MAAM,KAAK;GACX,OAAO,KAAK;GACZ,WAAW,KAAK;EAClB,CAA6B,CAC/B;EACF,SACE,QAAA,GAAA,2BAAA,YAAA,CAAmB,IAAI;CAC3B;AACF"}
+{"version":3,"file":"frontend.cjs","names":["FrontendFromUrlResourceType","FrontendFromFolderResourceType","FrontendFromLocalTgzResourceType","assertNever"],"sources":["../../../src/mutator/block-pack/frontend.ts"],"sourcesContent":["import type { AnyResourceRef, PlTransaction } from \"@milaboratories/pl-client\";\nimport type {\n  FrontendFromFolderData,\n  FrontendFromLocalTgzData,\n  FrontendFromUrlData,\n  FrontendSpec,\n} from \"../../model\";\nimport {\n  FrontendFromFolderResourceType,\n  FrontendFromLocalTgzResourceType,\n  FrontendFromUrlResourceType,\n} from \"../../model\";\nimport { assertNever } from \"@milaboratories/ts-helpers\";\n\nexport function createFrontend(tx: PlTransaction, spec: FrontendSpec): AnyResourceRef {\n  switch (spec.type) {\n    case \"url\":\n      return tx.createValue(\n        FrontendFromUrlResourceType,\n        JSON.stringify({ url: spec.url } as FrontendFromUrlData),\n      );\n    case \"local\":\n      return tx.createValue(\n        FrontendFromFolderResourceType,\n        JSON.stringify({\n          path: spec.path,\n          signature: spec.signature,\n        } as FrontendFromFolderData),\n      );\n    case \"local-tgz\":\n      return tx.createValue(\n        FrontendFromLocalTgzResourceType,\n        JSON.stringify({\n          path: spec.path,\n          mtime: spec.mtime,\n          signature: spec.signature,\n        } as FrontendFromLocalTgzData),\n      );\n    default:\n      return assertNever(spec);\n  }\n}\n"],"mappings":";;;;AAcA,SAAgB,eAAe,IAAmB,MAAoC;CACpF,QAAQ,KAAK,MAAb;EACE,KAAK,OACH,OAAO,GAAG,YACRA,wBAAAA,6BACA,KAAK,UAAU,EAAE,KAAK,KAAK,IAAI,CAAwB,CACzD;EACF,KAAK,SACH,OAAO,GAAG,YACRC,wBAAAA,gCACA,KAAK,UAAU;GACb,MAAM,KAAK;GACX,WAAW,KAAK;EAClB,CAA2B,CAC7B;EACF,KAAK,aACH,OAAO,GAAG,YACRC,wBAAAA,kCACA,KAAK,UAAU;GACb,MAAM,KAAK;GACX,OAAO,KAAK;GACZ,WAAW,KAAK;EAClB,CAA6B,CAC/B;EACF,SACE,QAAA,GAAOC,2BAAAA,YAAAA,CAAY,IAAI;CAC3B;AACF"}

package/dist/mutator/block-pack/frontend.js

@@ -1,7 +1,7 @@
 import { FrontendFromFolderResourceType, FrontendFromLocalTgzResourceType, FrontendFromUrlResourceType } from "../../model/block_pack_spec.js";
 import "../../model/index.js";
 import { assertNever } from "@milaboratories/ts-helpers";
-//#region src/mutator/block-pack/frontend.ts
+// src/mutator/block-pack/frontend.ts
 function createFrontend(tx, spec) {
 	switch (spec.type) {
 		case "url": return tx.createValue(FrontendFromUrlResourceType, JSON.stringify({ url: spec.url }));
@@ -17,7 +17,6 @@ function createFrontend(tx, spec) {
 		default: return assertNever(spec);
 	}
 }
-//#endregion
 export { createFrontend };
 
 //# sourceMappingURL=frontend.js.map

package/dist/mutator/block-pack/required_capabilities.cjs

@@ -1,5 +1,5 @@
 let node_zlib = require("node:zlib");
-//#region src/mutator/block-pack/required_capabilities.ts
+// src/mutator/block-pack/required_capabilities.ts
 /**
 * Reads the capability tokens a template declares it requires via
 * `TemplateDataV3.requiredCapabilities` (populated by `tengo-builder` at
@@ -36,7 +36,6 @@ function deriveRequiredCapabilities(workflowContent) {
 	}
 	return requiredCapabilitiesFromTemplate(parsed);
 }
-//#endregion
 exports.deriveRequiredCapabilities = deriveRequiredCapabilities;
 exports.requiredCapabilitiesFromTemplate = requiredCapabilitiesFromTemplate;
 

package/dist/mutator/block-pack/required_capabilities.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"required_capabilities.cjs","names":[],"sources":["../../../src/mutator/block-pack/required_capabilities.ts"],"sourcesContent":["import { gunzipSync } from \"node:zlib\";\nimport type { CompiledTemplateV3, TemplateData } from \"@milaboratories/pl-model-backend\";\n\n/**\n * Reads the capability tokens a template declares it requires via\n * `TemplateDataV3.requiredCapabilities` (populated by `tengo-builder` at\n * compile time).\n *\n * Use this on the install path: `BlockPackPreparer.prepare` parses the\n * workflow off-thread via the worker, and the parsed result feeds\n * straight into this function — no second gunzip+JSON.parse on the main\n * thread, no recursive walk to re-derive what the compiler already wrote\n * down.\n *\n * Returns `undefined` for v2 templates (no compile-time capability\n * field) and for v3 templates that declare no requirements; otherwise\n * the array as the compiler wrote it.\n */\nexport function requiredCapabilitiesFromTemplate(\n  parsed: TemplateData | CompiledTemplateV3,\n): string[] | undefined {\n  if (parsed.type !== \"pl.tengo-template.v3\") return undefined;\n  return parsed.template.requiredCapabilities;\n}\n\n/**\n * Same lookup, starting from raw `main.plj.gz` bytes. Used only at\n * catalog-listing time for local-dev blocks where the worker pipeline\n * isn't in play (`block_registry/registry.ts`). Install paths go through\n * `requiredCapabilitiesFromTemplate` instead to avoid parsing the\n * workflow twice.\n */\nexport function deriveRequiredCapabilities(\n  workflowContent: Uint8Array | Buffer,\n): string[] | undefined {\n  let parsed: unknown;\n  try {\n    const json = gunzipSync(workflowContent).toString(\"utf-8\");\n    parsed = JSON.parse(json);\n  } catch {\n    return undefined;\n  }\n  return requiredCapabilitiesFromTemplate(parsed as TemplateData | CompiledTemplateV3);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,SAAgB,iCACd,QACsB;CACtB,IAAI,OAAO,SAAS,wBAAwB,OAAO,KAAA;CACnD,OAAO,OAAO,SAAS;AACzB;;;;;;;;AASA,SAAgB,2BACd,iBACsB;CACtB,IAAI;CACJ,IAAI;EACF,MAAM,QAAA,GAAA,UAAA,WAAA,CAAkB,eAAe,CAAC,CAAC,SAAS,OAAO;EACzD,SAAS,KAAK,MAAM,IAAI;CAC1B,QAAQ;EACN;CACF;CACA,OAAO,iCAAiC,MAA2C;AACrF"}
+{"version":3,"file":"required_capabilities.cjs","names":["gunzipSync"],"sources":["../../../src/mutator/block-pack/required_capabilities.ts"],"sourcesContent":["import { gunzipSync } from \"node:zlib\";\nimport type { CompiledTemplateV3, TemplateData } from \"@milaboratories/pl-model-backend\";\n\n/**\n * Reads the capability tokens a template declares it requires via\n * `TemplateDataV3.requiredCapabilities` (populated by `tengo-builder` at\n * compile time).\n *\n * Use this on the install path: `BlockPackPreparer.prepare` parses the\n * workflow off-thread via the worker, and the parsed result feeds\n * straight into this function — no second gunzip+JSON.parse on the main\n * thread, no recursive walk to re-derive what the compiler already wrote\n * down.\n *\n * Returns `undefined` for v2 templates (no compile-time capability\n * field) and for v3 templates that declare no requirements; otherwise\n * the array as the compiler wrote it.\n */\nexport function requiredCapabilitiesFromTemplate(\n  parsed: TemplateData | CompiledTemplateV3,\n): string[] | undefined {\n  if (parsed.type !== \"pl.tengo-template.v3\") return undefined;\n  return parsed.template.requiredCapabilities;\n}\n\n/**\n * Same lookup, starting from raw `main.plj.gz` bytes. Used only at\n * catalog-listing time for local-dev blocks where the worker pipeline\n * isn't in play (`block_registry/registry.ts`). Install paths go through\n * `requiredCapabilitiesFromTemplate` instead to avoid parsing the\n * workflow twice.\n */\nexport function deriveRequiredCapabilities(\n  workflowContent: Uint8Array | Buffer,\n): string[] | undefined {\n  let parsed: unknown;\n  try {\n    const json = gunzipSync(workflowContent).toString(\"utf-8\");\n    parsed = JSON.parse(json);\n  } catch {\n    return undefined;\n  }\n  return requiredCapabilitiesFromTemplate(parsed as TemplateData | CompiledTemplateV3);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,SAAgB,iCACd,QACsB;CACtB,IAAI,OAAO,SAAS,wBAAwB,OAAO,KAAA;CACnD,OAAO,OAAO,SAAS;AACzB;;;;;;;;AASA,SAAgB,2BACd,iBACsB;CACtB,IAAI;CACJ,IAAI;EACF,MAAM,QAAA,GAAOA,UAAAA,WAAAA,CAAW,eAAe,CAAC,CAAC,SAAS,OAAO;EACzD,SAAS,KAAK,MAAM,IAAI;CAC1B,QAAQ;EACN;CACF;CACA,OAAO,iCAAiC,MAA2C;AACrF"}

package/dist/mutator/block-pack/required_capabilities.js

@@ -1,5 +1,5 @@
 import { gunzipSync } from "node:zlib";
-//#region src/mutator/block-pack/required_capabilities.ts
+// src/mutator/block-pack/required_capabilities.ts
 /**
 * Reads the capability tokens a template declares it requires via
 * `TemplateDataV3.requiredCapabilities` (populated by `tengo-builder` at
@@ -36,7 +36,6 @@ function deriveRequiredCapabilities(workflowContent) {
 	}
 	return requiredCapabilitiesFromTemplate(parsed);
 }
-//#endregion
 export { deriveRequiredCapabilities, requiredCapabilitiesFromTemplate };
 
 //# sourceMappingURL=required_capabilities.js.map

package/dist/mutator/context_export.cjs

@@ -2,7 +2,7 @@ const require_render_template = require("./template/render_template.cjs");
 const require_template_loading = require("./template/template_loading.cjs");
 let node_crypto = require("node:crypto");
 let _platforma_sdk_workflow_tengo = require("@platforma-sdk/workflow-tengo");
-//#region src/mutator/context_export.ts
+// src/mutator/context_export.ts
 let preparedTemplateEnvelop;
 async function getPreparedExportTemplateEnvelope() {
 	if (preparedTemplateEnvelop === void 0) {
@@ -18,7 +18,6 @@ async function getPreparedExportTemplateEnvelope() {
 function exportContext(tx, exportTpl, ctx) {
 	return require_render_template.createRenderTemplate(tx, exportTpl, true, { pf: ctx }, ["result"]).result;
 }
-//#endregion
 exports.exportContext = exportContext;
 exports.getPreparedExportTemplateEnvelope = getPreparedExportTemplateEnvelope;
 

package/dist/mutator/context_export.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"context_export.cjs","names":["prepareTemplateSpec","SdkTemplates","createRenderTemplate"],"sources":["../../src/mutator/context_export.ts"],"sourcesContent":["import type { AnyRef, PlTransaction } from \"@milaboratories/pl-client\";\nimport { createRenderTemplate } from \"./template/render_template\";\nimport { prepareTemplateSpec } from \"./template/template_loading\";\nimport type { TemplateSpecPrepared } from \"../model/template_spec\";\nimport { createHash } from \"node:crypto\";\n\n// Workaround to prevent bundling of @platforma-sdk/workflow-tengo\n// if bundling happens import.meta.dirname will be transfered as is without transferring corresponding assets\n// Construct like new URL(…, import.meta.url) also does not work properly.\n// const require = createRequire(import.meta.url);\n// const SdkTemplates = require('@platforma-sdk/workflow-tengo').Templates;\n\nimport { Templates as SdkTemplates } from \"@platforma-sdk/workflow-tengo\";\n\nexport type TemplateEnvelop = { spec: TemplateSpecPrepared; hash: string };\n\nlet preparedTemplateEnvelop: TemplateEnvelop | undefined;\n\nexport async function getPreparedExportTemplateEnvelope(): Promise<TemplateEnvelop> {\n  if (preparedTemplateEnvelop === undefined) {\n    // (await import('@platforma-sdk/workflow-tengo')).Templates['pframes.export-pframe']\n    const preparedTemplate = await prepareTemplateSpec(\n      SdkTemplates[\"pframes.export-pframe-for-ui\"],\n    );\n    if (preparedTemplate.type !== \"explicit\") throw new Error(\"Unexpected prepared template type.\");\n    const hash = createHash(\"sha256\").update(preparedTemplate.content).digest(\"hex\");\n    preparedTemplateEnvelop = { spec: preparedTemplate, hash };\n  }\n\n  return preparedTemplateEnvelop;\n}\n\nexport function exportContext(tx: PlTransaction, exportTpl: AnyRef, ctx: AnyRef) {\n  return createRenderTemplate(tx, exportTpl, true, { pf: ctx }, [\"result\"]).result;\n}\n"],"mappings":";;;;;AAgBA,IAAI;AAEJ,eAAsB,oCAA8D;CAClF,IAAI,4BAA4B,KAAA,GAAW;EAEzC,MAAM,mBAAmB,MAAMA,yBAAAA,oBAC7BC,8BAAAA,UAAa,+BACf;EACA,IAAI,iBAAiB,SAAS,YAAY,MAAM,IAAI,MAAM,oCAAoC;EAE9F,0BAA0B;GAAE,MAAM;GAAkB,OAAA,GAAA,YAAA,WAAA,CAD5B,QAAQ,CAAC,CAAC,OAAO,iBAAiB,OAAO,CAAC,CAAC,OAAO,KACnB;EAAE;CAC3D;CAEA,OAAO;AACT;AAEA,SAAgB,cAAc,IAAmB,WAAmB,KAAa;CAC/E,OAAOC,wBAAAA,qBAAqB,IAAI,WAAW,MAAM,EAAE,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC5E"}
+{"version":3,"file":"context_export.cjs","names":["prepareTemplateSpec","SdkTemplates","createHash","createRenderTemplate"],"sources":["../../src/mutator/context_export.ts"],"sourcesContent":["import type { AnyRef, PlTransaction } from \"@milaboratories/pl-client\";\nimport { createRenderTemplate } from \"./template/render_template\";\nimport { prepareTemplateSpec } from \"./template/template_loading\";\nimport type { TemplateSpecPrepared } from \"../model/template_spec\";\nimport { createHash } from \"node:crypto\";\n\n// Workaround to prevent bundling of @platforma-sdk/workflow-tengo\n// if bundling happens import.meta.dirname will be transfered as is without transferring corresponding assets\n// Construct like new URL(…, import.meta.url) also does not work properly.\n// const require = createRequire(import.meta.url);\n// const SdkTemplates = require('@platforma-sdk/workflow-tengo').Templates;\n\nimport { Templates as SdkTemplates } from \"@platforma-sdk/workflow-tengo\";\n\nexport type TemplateEnvelop = { spec: TemplateSpecPrepared; hash: string };\n\nlet preparedTemplateEnvelop: TemplateEnvelop | undefined;\n\nexport async function getPreparedExportTemplateEnvelope(): Promise<TemplateEnvelop> {\n  if (preparedTemplateEnvelop === undefined) {\n    // (await import('@platforma-sdk/workflow-tengo')).Templates['pframes.export-pframe']\n    const preparedTemplate = await prepareTemplateSpec(\n      SdkTemplates[\"pframes.export-pframe-for-ui\"],\n    );\n    if (preparedTemplate.type !== \"explicit\") throw new Error(\"Unexpected prepared template type.\");\n    const hash = createHash(\"sha256\").update(preparedTemplate.content).digest(\"hex\");\n    preparedTemplateEnvelop = { spec: preparedTemplate, hash };\n  }\n\n  return preparedTemplateEnvelop;\n}\n\nexport function exportContext(tx: PlTransaction, exportTpl: AnyRef, ctx: AnyRef) {\n  return createRenderTemplate(tx, exportTpl, true, { pf: ctx }, [\"result\"]).result;\n}\n"],"mappings":";;;;;AAgBA,IAAI;AAEJ,eAAsB,oCAA8D;CAClF,IAAI,4BAA4B,KAAA,GAAW;EAEzC,MAAM,mBAAmB,MAAMA,yBAAAA,oBAC7BC,8BAAAA,UAAa,+BACf;EACA,IAAI,iBAAiB,SAAS,YAAY,MAAM,IAAI,MAAM,oCAAoC;EAE9F,0BAA0B;GAAE,MAAM;GAAkB,OAAA,GADvCC,YAAAA,WAAAA,CAAW,QAAQ,CAAC,CAAC,OAAO,iBAAiB,OAAO,CAAC,CAAC,OAAO,KACnB;EAAE;CAC3D;CAEA,OAAO;AACT;AAEA,SAAgB,cAAc,IAAmB,WAAmB,KAAa;CAC/E,OAAOC,wBAAAA,qBAAqB,IAAI,WAAW,MAAM,EAAE,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC5E"}

package/dist/mutator/context_export.js

@@ -2,7 +2,7 @@ import { createRenderTemplate } from "./template/render_template.js";
 import { prepareTemplateSpec } from "./template/template_loading.js";
 import { createHash } from "node:crypto";
 import { Templates } from "@platforma-sdk/workflow-tengo";
-//#region src/mutator/context_export.ts
+// src/mutator/context_export.ts
 let preparedTemplateEnvelop;
 async function getPreparedExportTemplateEnvelope() {
 	if (preparedTemplateEnvelop === void 0) {
@@ -18,7 +18,6 @@ async function getPreparedExportTemplateEnvelope() {
 function exportContext(tx, exportTpl, ctx) {
 	return createRenderTemplate(tx, exportTpl, true, { pf: ctx }, ["result"]).result;
 }
-//#endregion
 export { exportContext, getPreparedExportTemplateEnvelope };
 
 //# sourceMappingURL=context_export.js.map

package/dist/mutator/list.cjs

@@ -1,5 +1,5 @@
 let _milaboratories_pl_client = require("@milaboratories/pl-client");
-//#region src/mutator/list.ts
+// src/mutator/list.ts
 /**
 * Every entry of a list resource — the project list or the template list — keyed by the string
 * form of the resource id it points at, which is what a project or template id is.
@@ -23,7 +23,6 @@ async function listedById(tx, listRid) {
 function notListedError(kind, id) {
 	return /* @__PURE__ */ new Error(`${kind} ${id} not found in the ${kind.toLowerCase()} list.`);
 }
-//#endregion
 exports.listedById = listedById;
 exports.notListedError = notListedError;
 

package/dist/mutator/list.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"list.cjs","names":[],"sources":["../../src/mutator/list.ts"],"sourcesContent":["import type { PlTransaction, SignedResourceId } from \"@milaboratories/pl-client\";\nimport { isNullSignedResourceId, resourceIdToString } from \"@milaboratories/pl-client\";\n\n/** One entry of a list resource: the field holding it and the resource that field points at. */\nexport interface ListedEntry {\n  readonly fieldName: string;\n  readonly rid: SignedResourceId;\n}\n\n/** The kinds of list a root keeps, as a not-found message names them. */\nexport type ListedKind = \"Project\" | \"Template\";\n\n/**\n * Every entry of a list resource — the project list or the template list — keyed by the string\n * form of the resource id it points at, which is what a project or template id is.\n *\n * A list field's name is a uuid unrelated to the id of what it holds, so an entry is only ever\n * found by value. Fields that point at nothing yet are left out.\n */\nexport async function listedById(\n  tx: PlTransaction,\n  listRid: SignedResourceId,\n): Promise<Map<string, ListedEntry>> {\n  const data = await tx.getResourceData(listRid, true);\n  const entries = new Map<string, ListedEntry>();\n  for (const f of data.fields) {\n    if (isNullSignedResourceId(f.value)) continue;\n    entries.set(resourceIdToString(f.value), { fieldName: f.name, rid: f.value });\n  }\n  return entries;\n}\n\n/** What is thrown for an id the list does not hold, worded the same for every list. */\nexport function notListedError(kind: ListedKind, id: string): Error {\n  return new Error(`${kind} ${id} not found in the ${kind.toLowerCase()} list.`);\n}\n"],"mappings":";;;;;;;;;AAmBA,eAAsB,WACpB,IACA,SACmC;CACnC,MAAM,OAAO,MAAM,GAAG,gBAAgB,SAAS,IAAI;CACnD,MAAM,0BAAU,IAAI,IAAyB;CAC7C,KAAK,MAAM,KAAK,KAAK,QAAQ;EAC3B,KAAA,GAAA,0BAAA,uBAAA,CAA2B,EAAE,KAAK,GAAG;EACrC,QAAQ,KAAA,GAAA,0BAAA,mBAAA,CAAuB,EAAE,KAAK,GAAG;GAAE,WAAW,EAAE;GAAM,KAAK,EAAE;EAAM,CAAC;CAC9E;CACA,OAAO;AACT;;AAGA,SAAgB,eAAe,MAAkB,IAAmB;CAClE,uBAAO,IAAI,MAAM,GAAG,KAAK,GAAG,GAAG,oBAAoB,KAAK,YAAY,EAAE,OAAO;AAC/E"}
+{"version":3,"file":"list.cjs","names":["isNullSignedResourceId","resourceIdToString"],"sources":["../../src/mutator/list.ts"],"sourcesContent":["import type { PlTransaction, SignedResourceId } from \"@milaboratories/pl-client\";\nimport { isNullSignedResourceId, resourceIdToString } from \"@milaboratories/pl-client\";\n\n/** One entry of a list resource: the field holding it and the resource that field points at. */\nexport interface ListedEntry {\n  readonly fieldName: string;\n  readonly rid: SignedResourceId;\n}\n\n/** The kinds of list a root keeps, as a not-found message names them. */\nexport type ListedKind = \"Project\" | \"Template\";\n\n/**\n * Every entry of a list resource — the project list or the template list — keyed by the string\n * form of the resource id it points at, which is what a project or template id is.\n *\n * A list field's name is a uuid unrelated to the id of what it holds, so an entry is only ever\n * found by value. Fields that point at nothing yet are left out.\n */\nexport async function listedById(\n  tx: PlTransaction,\n  listRid: SignedResourceId,\n): Promise<Map<string, ListedEntry>> {\n  const data = await tx.getResourceData(listRid, true);\n  const entries = new Map<string, ListedEntry>();\n  for (const f of data.fields) {\n    if (isNullSignedResourceId(f.value)) continue;\n    entries.set(resourceIdToString(f.value), { fieldName: f.name, rid: f.value });\n  }\n  return entries;\n}\n\n/** What is thrown for an id the list does not hold, worded the same for every list. */\nexport function notListedError(kind: ListedKind, id: string): Error {\n  return new Error(`${kind} ${id} not found in the ${kind.toLowerCase()} list.`);\n}\n"],"mappings":";;;;;;;;;AAmBA,eAAsB,WACpB,IACA,SACmC;CACnC,MAAM,OAAO,MAAM,GAAG,gBAAgB,SAAS,IAAI;CACnD,MAAM,0BAAU,IAAI,IAAyB;CAC7C,KAAK,MAAM,KAAK,KAAK,QAAQ;EAC3B,KAAA,GAAIA,0BAAAA,uBAAAA,CAAuB,EAAE,KAAK,GAAG;EACrC,QAAQ,KAAA,GAAIC,0BAAAA,mBAAAA,CAAmB,EAAE,KAAK,GAAG;GAAE,WAAW,EAAE;GAAM,KAAK,EAAE;EAAM,CAAC;CAC9E;CACA,OAAO;AACT;;AAGA,SAAgB,eAAe,MAAkB,IAAmB;CAClE,uBAAO,IAAI,MAAM,GAAG,KAAK,GAAG,GAAG,oBAAoB,KAAK,YAAY,EAAE,OAAO;AAC/E"}

package/dist/mutator/list.js

@@ -1,5 +1,5 @@
 import { isNullSignedResourceId, resourceIdToString } from "@milaboratories/pl-client";
-//#region src/mutator/list.ts
+// src/mutator/list.ts
 /**
 * Every entry of a list resource — the project list or the template list — keyed by the string
 * form of the resource id it points at, which is what a project or template id is.
@@ -23,7 +23,6 @@ async function listedById(tx, listRid) {
 function notListedError(kind, id) {
 	return /* @__PURE__ */ new Error(`${kind} ${id} not found in the ${kind.toLowerCase()} list.`);
 }
-//#endregion
 export { listedById, notListedError };
 
 //# sourceMappingURL=list.js.map

package/dist/mutator/migration.cjs

@@ -4,7 +4,7 @@ const require_project_model_v1 = require("../model/project_model_v1.cjs");
 let _milaboratories_ts_helpers = require("@milaboratories/ts-helpers");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
 let _milaboratories_pl_client = require("@milaboratories/pl-client");
-//#region src/mutator/migration.ts
+// src/mutator/migration.ts
 /**
 * Migrates the project to the latest schema version.
 *
@@ -95,7 +95,6 @@ async function migrateV2ToV3(tx, rid) {
 		}
 	}
 }
-//#endregion
 exports.applyProjectMigrations = applyProjectMigrations;
 
 //# sourceMappingURL=migration.cjs.map

package/dist/mutator/migration.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"migration.cjs","names":["SchemaVersionKey","UiError","ProjectStructureKey","allBlocks","BlockFrontendStateKeyPrefixV1","projectFieldName"],"sources":["../../src/mutator/migration.ts"],"sourcesContent":["import { UiError } from \"@milaboratories/pl-model-common\";\nimport type { PlClient, PlTransaction, SignedResourceId } from \"@milaboratories/pl-client\";\nimport type { ProjectField, ProjectStructure } from \"../model/project_model\";\nimport {\n  projectFieldName,\n  ProjectStructureKey,\n  SchemaVersionCurrent,\n  SchemaVersionKey,\n  SchemaVersionV2,\n  SchemaVersionV3,\n} from \"../model/project_model\";\nimport { BlockFrontendStateKeyPrefixV1, SchemaVersionV1 } from \"../model/project_model_v1\";\nimport { field, isNullSignedResourceId } from \"@milaboratories/pl-client\";\nimport { cachedDeserialize } from \"@milaboratories/ts-helpers\";\nimport { allBlocks } from \"../model/project_model_util\";\n\n/**\n * Migrates the project to the latest schema version.\n *\n * @param pl - The client to use.\n * @param rid - The resource id of the project.\n */\nexport async function applyProjectMigrations(pl: PlClient, rid: SignedResourceId) {\n  await pl.withWriteTx(\"ProjectMigration\", async (tx) => {\n    let schemaVersion = await tx.getKValueJson<string>(rid, SchemaVersionKey);\n    if (schemaVersion === SchemaVersionCurrent) return;\n\n    // Apply migrations in sequence\n    if (schemaVersion === SchemaVersionV1) {\n      await migrateV1ToV2(tx, rid);\n      schemaVersion = SchemaVersionV2;\n    }\n\n    if (schemaVersion === SchemaVersionV2) {\n      await migrateV2ToV3(tx, rid);\n      schemaVersion = SchemaVersionV3;\n    }\n\n    if (schemaVersion === SchemaVersionV3) {\n      // V3 → V4: production context chain + staging re-render.\n      // The actual chain building and staging reset happens in fixProblemsAndMigrate()\n      // (called from ProjectMutator.load). This migration step just bumps the schema\n      // to prevent older clients from operating on the new project structure.\n      schemaVersion = SchemaVersionCurrent;\n    }\n\n    if (schemaVersion !== SchemaVersionCurrent) {\n      throw new UiError(\n        `This project was created with a newer version of Platforma. Please update to the latest version to open it.`,\n      );\n    }\n\n    tx.setKValue(rid, SchemaVersionKey, JSON.stringify(SchemaVersionCurrent));\n    await tx.commit();\n  });\n}\n\n/**\n * Migrates the project from schema version 1 to 2.\n *\n * Summary of changes:\n * - uiState is now stored in a field instead of a KV\n *\n * @param tx - The transaction to use.\n * @param rid - The resource id of the project.\n */\nasync function migrateV1ToV2(tx: PlTransaction, rid: SignedResourceId) {\n  const [structure, allKV] = await Promise.all([\n    tx.getKValueJson<ProjectStructure>(rid, ProjectStructureKey),\n    tx.listKeyValues(rid),\n  ]);\n  const kvMap = new Map<string, Uint8Array>(allKV.map((kv) => [kv.key, kv.value]));\n  for (const block of allBlocks(structure)) {\n    const kvKey = BlockFrontendStateKeyPrefixV1 + block.id;\n    const uiState = kvMap.get(kvKey);\n    const valueJson = uiState ? cachedDeserialize(uiState) : {};\n    const uiStateR = tx.createJsonGzValue(valueJson);\n    const uiStateF = field(rid, projectFieldName(block.id, \"blockStorage\"));\n    tx.createField(uiStateF, \"Dynamic\", uiStateR);\n    tx.deleteKValue(rid, kvKey);\n  }\n}\n\n/**\n * Migrates the project from schema version 2 to 3.\n *\n * Summary of changes:\n * - Introduces unified 'blockStorage' field containing { args, uiState }\n * - Adds 'currentPrerunArgs' field for staging/prerun rendering\n * - For each block:\n *   1. Read existing 'blockStorage' field (contains uiState in v2)\n *   2. Read existing 'currentArgs' field (contains args)\n *   3. Create unified state = { args: currentArgs, uiState: oldState }\n *   4. Write to new {blockId}-blockStorage field (overwrites)\n *   5. Initialize {blockId}-currentPrerunArgs (same as prodArgs for v1/v2 blocks)\n * - Note: currentArgs and prodArgs fields remain for compatibility layer\n *\n * @param tx - The transaction to use.\n * @param rid - The resource id of the project.\n */\nasync function migrateV2ToV3(tx: PlTransaction, rid: SignedResourceId) {\n  const [structure, fullResourceState] = await Promise.all([\n    tx.getKValueJson<ProjectStructure>(rid, ProjectStructureKey),\n    tx.getResourceData(rid, true),\n  ]);\n\n  // Build a map of field name -> resource id for quick lookup\n  const fieldMap = new Map<string, SignedResourceId>();\n  for (const f of fullResourceState.fields) {\n    if (!isNullSignedResourceId(f.value)) {\n      fieldMap.set(f.name, f.value);\n    }\n  }\n\n  for (const block of allBlocks(structure)) {\n    // Read existing field values\n    const uiStateFieldName = projectFieldName(block.id, \"uiState\" as ProjectField[\"fieldName\"]);\n    const currentArgsFieldName = projectFieldName(block.id, \"currentArgs\");\n\n    const uiStateRid = fieldMap.get(uiStateFieldName);\n    const currentArgsRid = fieldMap.get(currentArgsFieldName);\n\n    // Read field data in parallel where available\n    const [uiStateData, currentArgsData] = await Promise.all([\n      uiStateRid ? tx.getResourceData(uiStateRid, false) : Promise.resolve(undefined),\n      currentArgsRid ? tx.getResourceData(currentArgsRid, false) : Promise.resolve(undefined),\n    ]);\n\n    // Extract values - in v2, 'blockStorage' contains raw uiState, not wrapped\n    const uiState = uiStateData?.data ? cachedDeserialize(uiStateData.data) : {};\n    const args = currentArgsData?.data ? cachedDeserialize(currentArgsData.data) : {};\n\n    // Create unified state: { args, uiState }\n    const unifiedState = {\n      args,\n      uiState,\n    };\n\n    const blockStorageFieldName = projectFieldName(block.id, \"blockStorage\");\n\n    // Write new unified blockStorage field (overwrite existing)\n    const stateR = tx.createJsonGzValue(unifiedState);\n    const stateF = field(rid, blockStorageFieldName);\n    tx.createField(stateF, \"Dynamic\", stateR);\n\n    // Initialize currentPrerunArgs from currentArgs (for legacy blocks, prerunArgs = args)\n    if (currentArgsRid) {\n      const prerunArgsR = tx.createJsonGzValue(args);\n      const prerunArgsF = field(rid, projectFieldName(block.id, \"currentPrerunArgs\"));\n      tx.createField(prerunArgsF, \"Dynamic\", prerunArgsR);\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"migration.cjs","names":["SchemaVersionKey","UiError","ProjectStructureKey","allBlocks","BlockFrontendStateKeyPrefixV1","cachedDeserialize","field","projectFieldName","isNullSignedResourceId"],"sources":["../../src/mutator/migration.ts"],"sourcesContent":["import { UiError } from \"@milaboratories/pl-model-common\";\nimport type { PlClient, PlTransaction, SignedResourceId } from \"@milaboratories/pl-client\";\nimport type { ProjectField, ProjectStructure } from \"../model/project_model\";\nimport {\n  projectFieldName,\n  ProjectStructureKey,\n  SchemaVersionCurrent,\n  SchemaVersionKey,\n  SchemaVersionV2,\n  SchemaVersionV3,\n} from \"../model/project_model\";\nimport { BlockFrontendStateKeyPrefixV1, SchemaVersionV1 } from \"../model/project_model_v1\";\nimport { field, isNullSignedResourceId } from \"@milaboratories/pl-client\";\nimport { cachedDeserialize } from \"@milaboratories/ts-helpers\";\nimport { allBlocks } from \"../model/project_model_util\";\n\n/**\n * Migrates the project to the latest schema version.\n *\n * @param pl - The client to use.\n * @param rid - The resource id of the project.\n */\nexport async function applyProjectMigrations(pl: PlClient, rid: SignedResourceId) {\n  await pl.withWriteTx(\"ProjectMigration\", async (tx) => {\n    let schemaVersion = await tx.getKValueJson<string>(rid, SchemaVersionKey);\n    if (schemaVersion === SchemaVersionCurrent) return;\n\n    // Apply migrations in sequence\n    if (schemaVersion === SchemaVersionV1) {\n      await migrateV1ToV2(tx, rid);\n      schemaVersion = SchemaVersionV2;\n    }\n\n    if (schemaVersion === SchemaVersionV2) {\n      await migrateV2ToV3(tx, rid);\n      schemaVersion = SchemaVersionV3;\n    }\n\n    if (schemaVersion === SchemaVersionV3) {\n      // V3 → V4: production context chain + staging re-render.\n      // The actual chain building and staging reset happens in fixProblemsAndMigrate()\n      // (called from ProjectMutator.load). This migration step just bumps the schema\n      // to prevent older clients from operating on the new project structure.\n      schemaVersion = SchemaVersionCurrent;\n    }\n\n    if (schemaVersion !== SchemaVersionCurrent) {\n      throw new UiError(\n        `This project was created with a newer version of Platforma. Please update to the latest version to open it.`,\n      );\n    }\n\n    tx.setKValue(rid, SchemaVersionKey, JSON.stringify(SchemaVersionCurrent));\n    await tx.commit();\n  });\n}\n\n/**\n * Migrates the project from schema version 1 to 2.\n *\n * Summary of changes:\n * - uiState is now stored in a field instead of a KV\n *\n * @param tx - The transaction to use.\n * @param rid - The resource id of the project.\n */\nasync function migrateV1ToV2(tx: PlTransaction, rid: SignedResourceId) {\n  const [structure, allKV] = await Promise.all([\n    tx.getKValueJson<ProjectStructure>(rid, ProjectStructureKey),\n    tx.listKeyValues(rid),\n  ]);\n  const kvMap = new Map<string, Uint8Array>(allKV.map((kv) => [kv.key, kv.value]));\n  for (const block of allBlocks(structure)) {\n    const kvKey = BlockFrontendStateKeyPrefixV1 + block.id;\n    const uiState = kvMap.get(kvKey);\n    const valueJson = uiState ? cachedDeserialize(uiState) : {};\n    const uiStateR = tx.createJsonGzValue(valueJson);\n    const uiStateF = field(rid, projectFieldName(block.id, \"blockStorage\"));\n    tx.createField(uiStateF, \"Dynamic\", uiStateR);\n    tx.deleteKValue(rid, kvKey);\n  }\n}\n\n/**\n * Migrates the project from schema version 2 to 3.\n *\n * Summary of changes:\n * - Introduces unified 'blockStorage' field containing { args, uiState }\n * - Adds 'currentPrerunArgs' field for staging/prerun rendering\n * - For each block:\n *   1. Read existing 'blockStorage' field (contains uiState in v2)\n *   2. Read existing 'currentArgs' field (contains args)\n *   3. Create unified state = { args: currentArgs, uiState: oldState }\n *   4. Write to new {blockId}-blockStorage field (overwrites)\n *   5. Initialize {blockId}-currentPrerunArgs (same as prodArgs for v1/v2 blocks)\n * - Note: currentArgs and prodArgs fields remain for compatibility layer\n *\n * @param tx - The transaction to use.\n * @param rid - The resource id of the project.\n */\nasync function migrateV2ToV3(tx: PlTransaction, rid: SignedResourceId) {\n  const [structure, fullResourceState] = await Promise.all([\n    tx.getKValueJson<ProjectStructure>(rid, ProjectStructureKey),\n    tx.getResourceData(rid, true),\n  ]);\n\n  // Build a map of field name -> resource id for quick lookup\n  const fieldMap = new Map<string, SignedResourceId>();\n  for (const f of fullResourceState.fields) {\n    if (!isNullSignedResourceId(f.value)) {\n      fieldMap.set(f.name, f.value);\n    }\n  }\n\n  for (const block of allBlocks(structure)) {\n    // Read existing field values\n    const uiStateFieldName = projectFieldName(block.id, \"uiState\" as ProjectField[\"fieldName\"]);\n    const currentArgsFieldName = projectFieldName(block.id, \"currentArgs\");\n\n    const uiStateRid = fieldMap.get(uiStateFieldName);\n    const currentArgsRid = fieldMap.get(currentArgsFieldName);\n\n    // Read field data in parallel where available\n    const [uiStateData, currentArgsData] = await Promise.all([\n      uiStateRid ? tx.getResourceData(uiStateRid, false) : Promise.resolve(undefined),\n      currentArgsRid ? tx.getResourceData(currentArgsRid, false) : Promise.resolve(undefined),\n    ]);\n\n    // Extract values - in v2, 'blockStorage' contains raw uiState, not wrapped\n    const uiState = uiStateData?.data ? cachedDeserialize(uiStateData.data) : {};\n    const args = currentArgsData?.data ? cachedDeserialize(currentArgsData.data) : {};\n\n    // Create unified state: { args, uiState }\n    const unifiedState = {\n      args,\n      uiState,\n    };\n\n    const blockStorageFieldName = projectFieldName(block.id, \"blockStorage\");\n\n    // Write new unified blockStorage field (overwrite existing)\n    const stateR = tx.createJsonGzValue(unifiedState);\n    const stateF = field(rid, blockStorageFieldName);\n    tx.createField(stateF, \"Dynamic\", stateR);\n\n    // Initialize currentPrerunArgs from currentArgs (for legacy blocks, prerunArgs = args)\n    if (currentArgsRid) {\n      const prerunArgsR = tx.createJsonGzValue(args);\n      const prerunArgsF = field(rid, projectFieldName(block.id, \"currentPrerunArgs\"));\n      tx.createField(prerunArgsF, \"Dynamic\", prerunArgsR);\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/mutator/migration.js

@@ -4,7 +4,7 @@ import { BlockFrontendStateKeyPrefixV1 } from "../model/project_model_v1.js";
 import { cachedDeserialize } from "@milaboratories/ts-helpers";
 import { UiError } from "@milaboratories/pl-model-common";
 import { field, isNullSignedResourceId } from "@milaboratories/pl-client";
-//#region src/mutator/migration.ts
+// src/mutator/migration.ts
 /**
 * Migrates the project to the latest schema version.
 *
@@ -95,7 +95,6 @@ async function migrateV2ToV3(tx, rid) {
 		}
 	}
 }
-//#endregion
 export { applyProjectMigrations };
 
 //# sourceMappingURL=migration.js.map

package/dist/mutator/project.cjs

@@ -15,7 +15,7 @@ let _milaboratories_pl_client = require("@milaboratories/pl-client");
 let _milaboratories_pl_errors = require("@milaboratories/pl-errors");
 let denque = require("denque");
 denque = require_runtime.__toESM(denque, 1);
-//#region src/mutator/project.ts
+// src/mutator/project.ts
 /**
 * A production core field is "settled" once its result is immutable — `Ready` or a finished
 * `Error`. `NotReady` (still computing) is the only unsettled status; a missing field is unsettled.
@@ -703,7 +703,8 @@ var ProjectMutator = class ProjectMutator {
 	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));
+		const newStagingGraph = require_project_model_util.stagingGraph(newStructure);
+		const stagingDiff = require_project_model_util.graphDiff(currentStagingGraph, newStagingGraph);
 		for (const blockId of stagingDiff.onlyInA) {
 			const { fields } = this.getBlockInfo(blockId);
 			this.deleteBlockFields(blockId, ...Object.keys(fields));
@@ -712,7 +713,8 @@ var ProjectMutator = class ProjectMutator {
 		}
 		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)));
+		const newActualProductionGraph = require_project_model_util.productionGraph(newStructure, (blockId) => this.getProductionGraphBlockInfo(blockId, true));
+		const prodDiff = require_project_model_util.graphDiff(currentActualProductionGraph, newActualProductionGraph);
 		currentActualProductionGraph.traverse("downstream", [...prodDiff.different], (node) => {
 			this.resetOrLimboProduction(node.id);
 		});
@@ -812,19 +814,20 @@ var ProjectMutator = class ProjectMutator {
 			if (!deriveArgsResult.error && deriveArgsResult.value !== void 0) this.setBlockFieldObj(blockId, "currentArgs", this.createJsonFieldValue(deriveArgsResult.value));
 			else this.deleteBlockFields(blockId, "currentArgs");
 		};
-		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();
+		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 {
-			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);
@@ -965,8 +968,10 @@ var ProjectMutator = class ProjectMutator {
 		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);
+		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;
@@ -1031,8 +1036,10 @@ var ProjectMutator = class ProjectMutator {
 			structureP,
 			renderingStateP
 		]);
-		if (schema !== "4") if (Number(schema) < 4) 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.`);
+		if (schema !== "4") {
+			if (Number(schema) < 4) 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;
@@ -1047,7 +1054,8 @@ var ProjectMutator = class ProjectMutator {
 			}
 		}
 		for (const [info, response] of blockPackRequests) {
-			const bpInfo = (0, _milaboratories_ts_helpers.cachedDeserialize)((0, _milaboratories_ts_helpers.notEmpty)((await response).data));
+			const result = await response;
+			const bpInfo = (0, _milaboratories_ts_helpers.cachedDeserialize)((0, _milaboratories_ts_helpers.notEmpty)(result.data));
 			info.blockConfig = (0, _platforma_sdk_model.extractConfig)(bpInfo.config);
 			info.blockKind = bpInfo.config.kind;
 			info.blockPack = bpInfo.source;
@@ -1123,7 +1131,8 @@ async function duplicateProject(tx, sourceRid, options, projectHelper) {
 	const isTargetSettled = async (rid) => {
 		if (rid === void 0 || (0, _milaboratories_pl_client.isNullSignedResourceId)(rid)) return false;
 		try {
-			return (0, _milaboratories_pl_client.readyOrDuplicateOrError)(await tx.getResourceData(rid, false));
+			const r = await tx.getResourceData(rid, false);
+			return (0, _milaboratories_pl_client.readyOrDuplicateOrError)(r);
 		} catch {
 			return false;
 		}
@@ -1193,7 +1202,6 @@ async function withProjectAuthored(projectHelper, txOrPl, rid, author, cb, ops =
 		return result;
 	}
 }
-//#endregion
 exports.ProjectMutator = ProjectMutator;
 exports.createProject = createProject;
 exports.duplicateProject = duplicateProject;