@milaboratories/pl-middle-layer 1.66.19 → 1.67.0

package/dist/model/args.cjs

@@ -1,4 +1,5 @@
 let _milaboratories_ts_helpers = require("@milaboratories/ts-helpers");
+let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
 //#region src/model/args.ts
 function outputRef(blockId, name, requireEnrichments) {
 	if (requireEnrichments) return {
@@ -35,43 +36,23 @@ function addAllReferencedBlocks(result, node, allowed) {
 		case "boolean":
 		case "symbol":
 		case "undefined": return;
-		case "string":
-			unwrapEmbeddedRef(node, (parsed) => addAllReferencedBlocks(result, parsed, allowed));
+		case "string": {
+			const peeled = (0, _milaboratories_pl_model_common.peelJsonLayers)(node);
+			if (peeled !== void 0) addAllReferencedBlocks(result, peeled.value, allowed);
 			return;
+		}
 		case "object":
 			if (node === null) return;
 			if (isBlockOutputReference(node)) recordRef(result, node.blockId, node.requireEnrichments === true, allowed);
 			else if (Array.isArray(node)) for (const child of node) addAllReferencedBlocks(result, child, allowed);
-			else for (const [, child] of Object.entries(node)) addAllReferencedBlocks(result, child, allowed);
+			else for (const [key, child] of Object.entries(node)) {
+				addAllReferencedBlocks(result, key, allowed);
+				addAllReferencedBlocks(result, child, allowed);
+			}
 			return;
 		default: (0, _milaboratories_ts_helpers.assertNever)(type);
 	}
 }
-/**
-* Detect a PlRef carried inside a string and hand the decoded value to `onParsed`.
-*
-* A PlRef-as-string is canonical `{...}` optionally wrapped by N `JSON.stringify`
-* passes. Each pass adds a symmetric prefix/suffix made only of `"` and `\`
-* chars (the escape padding) of equal length. The regex below is the strict
-* shape gate — non-ref strings fail at the very first character, so we never
-* scan their body. One pass is peeled per call; deeper nesting is unwrapped
-* via recursion in the caller.
-*/
-const EMBEDDED_REF_RE = /^(?<pre>[\\"]*)\{[\s\S]*?__isRef[\s\S]*\}(?<suf>[\\"]*)$/;
-function unwrapEmbeddedRef(s, onParsed) {
-	const c0 = s.charCodeAt(0);
-	if (c0 !== 123 && c0 !== 34) return;
-	const m = EMBEDDED_REF_RE.exec(s);
-	if (m === null) return;
-	if (m.groups.pre.length !== m.groups.suf.length) return;
-	let parsed;
-	try {
-		parsed = JSON.parse(s);
-	} catch {
-		return;
-	}
-	if (parsed !== s) onParsed(parsed);
-}
 function recordRef(result, blockId, requireEnrichments, allowed) {
 	if (allowed === void 0 || allowed.has(blockId)) {
 		result.upstreams.add(blockId);

package/dist/model/args.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"args.cjs","names":[],"sources":["../../src/model/args.ts"],"sourcesContent":["import { assertNever } from \"@milaboratories/ts-helpers\";\nimport type { PlRef } from \"@platforma-sdk/model\";\n\nexport function outputRef(blockId: string, name: string, requireEnrichments?: boolean): PlRef {\n  if (requireEnrichments) return { __isRef: true, blockId, name, requireEnrichments };\n  else return { __isRef: true, blockId, name };\n}\n\nexport function isBlockOutputReference(obj: unknown): obj is PlRef {\n  return (\n    typeof obj === \"object\" &&\n    obj !== null &&\n    \"__isRef\" in obj &&\n    obj.__isRef === true &&\n    \"blockId\" in obj &&\n    \"name\" in obj\n  );\n}\n\nexport interface BlockUpstreams {\n  /** All direct block dependencies */\n  upstreams: Set<string>;\n  /** Direct block dependencies which enrichments are also required by current block */\n  upstreamsRequiringEnrichments: Set<string>;\n  /** True if not-allowed references was encountered */\n  missingReferences: boolean;\n}\n\n/** Extracts all resource ids referenced by args object. */\nexport function inferAllReferencedBlocks(args: unknown, allowed?: Set<string>): BlockUpstreams {\n  const result = {\n    upstreams: new Set<string>(),\n    upstreamsRequiringEnrichments: new Set<string>(),\n    missingReferences: false,\n  };\n  addAllReferencedBlocks(result, args, allowed);\n  return result;\n}\n\nfunction addAllReferencedBlocks(result: BlockUpstreams, node: unknown, allowed?: Set<string>) {\n  const type = typeof node;\n  switch (type) {\n    case \"function\":\n    case \"bigint\":\n    case \"number\":\n    case \"boolean\":\n    case \"symbol\":\n    case \"undefined\":\n      return;\n    case \"string\": {\n      unwrapEmbeddedRef(node as string, (parsed) =>\n        addAllReferencedBlocks(result, parsed, allowed),\n      );\n      return;\n    }\n    case \"object\": {\n      if (node === null) return;\n      if (isBlockOutputReference(node)) {\n        recordRef(result, node.blockId, node.requireEnrichments === true, allowed);\n      } else if (Array.isArray(node)) {\n        for (const child of node) addAllReferencedBlocks(result, child, allowed);\n      } else {\n        for (const [, child] of Object.entries(node as object))\n          addAllReferencedBlocks(result, child, allowed);\n      }\n\n      return;\n    }\n    default:\n      assertNever(type);\n  }\n}\n\n/**\n * Detect a PlRef carried inside a string and hand the decoded value to `onParsed`.\n *\n * A PlRef-as-string is canonical `{...}` optionally wrapped by N `JSON.stringify`\n * passes. Each pass adds a symmetric prefix/suffix made only of `\"` and `\\`\n * chars (the escape padding) of equal length. The regex below is the strict\n * shape gate — non-ref strings fail at the very first character, so we never\n * scan their body. One pass is peeled per call; deeper nesting is unwrapped\n * via recursion in the caller.\n */\nconst EMBEDDED_REF_RE = /^(?<pre>[\\\\\"]*)\\{[\\s\\S]*?__isRef[\\s\\S]*\\}(?<suf>[\\\\\"]*)$/;\n\nfunction unwrapEmbeddedRef(s: string, onParsed: (value: unknown) => void) {\n  const c0 = s.charCodeAt(0);\n  if (c0 !== 0x7b /* { */ && c0 !== 0x22 /* \" */) return;\n  const m = EMBEDDED_REF_RE.exec(s);\n  if (m === null) return;\n  if (m.groups!.pre.length !== m.groups!.suf.length) return;\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(s);\n  } catch {\n    return;\n  }\n  if (parsed !== s) onParsed(parsed);\n}\n\nfunction recordRef(\n  result: BlockUpstreams,\n  blockId: string,\n  requireEnrichments: boolean,\n  allowed?: Set<string>,\n) {\n  if (allowed === undefined || allowed.has(blockId)) {\n    result.upstreams.add(blockId);\n    if (requireEnrichments) result.upstreamsRequiringEnrichments.add(blockId);\n  } else result.missingReferences = true;\n}\n"],"mappings":";;AAGA,SAAgB,UAAU,SAAiB,MAAc,oBAAqC;CAC5F,IAAI,oBAAoB,OAAO;EAAE,SAAS;EAAM;EAAS;EAAM;CAAmB;MAC7E,OAAO;EAAE,SAAS;EAAM;EAAS;CAAK;AAC7C;AAEA,SAAgB,uBAAuB,KAA4B;CACjE,OACE,OAAO,QAAQ,YACf,QAAQ,QACR,aAAa,OACb,IAAI,YAAY,QAChB,aAAa,OACb,UAAU;AAEd;;AAYA,SAAgB,yBAAyB,MAAe,SAAuC;CAC7F,MAAM,SAAS;EACb,2BAAW,IAAI,IAAY;EAC3B,+CAA+B,IAAI,IAAY;EAC/C,mBAAmB;CACrB;CACA,uBAAuB,QAAQ,MAAM,OAAO;CAC5C,OAAO;AACT;AAEA,SAAS,uBAAuB,QAAwB,MAAe,SAAuB;CAC5F,MAAM,OAAO,OAAO;CACpB,QAAQ,MAAR;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,aACH;EACF,KAAK;GACH,kBAAkB,OAAiB,WACjC,uBAAuB,QAAQ,QAAQ,OAAO,CAChD;GACA;EAEF,KAAK;GACH,IAAI,SAAS,MAAM;GACnB,IAAI,uBAAuB,IAAI,GAC7B,UAAU,QAAQ,KAAK,SAAS,KAAK,uBAAuB,MAAM,OAAO;QACpE,IAAI,MAAM,QAAQ,IAAI,GAC3B,KAAK,MAAM,SAAS,MAAM,uBAAuB,QAAQ,OAAO,OAAO;QAEvE,KAAK,MAAM,GAAG,UAAU,OAAO,QAAQ,IAAc,GACnD,uBAAuB,QAAQ,OAAO,OAAO;GAGjD;EAEF,SACE,CAAA,GAAA,2BAAA,YAAA,CAAY,IAAI;CACpB;AACF;;;;;;;;;;;AAYA,MAAM,kBAAkB;AAExB,SAAS,kBAAkB,GAAW,UAAoC;CACxE,MAAM,KAAK,EAAE,WAAW,CAAC;CACzB,IAAI,OAAO,OAAgB,OAAO,IAAc;CAChD,MAAM,IAAI,gBAAgB,KAAK,CAAC;CAChC,IAAI,MAAM,MAAM;CAChB,IAAI,EAAE,OAAQ,IAAI,WAAW,EAAE,OAAQ,IAAI,QAAQ;CACnD,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,CAAC;CACvB,QAAQ;EACN;CACF;CACA,IAAI,WAAW,GAAG,SAAS,MAAM;AACnC;AAEA,SAAS,UACP,QACA,SACA,oBACA,SACA;CACA,IAAI,YAAY,KAAA,KAAa,QAAQ,IAAI,OAAO,GAAG;EACjD,OAAO,UAAU,IAAI,OAAO;EAC5B,IAAI,oBAAoB,OAAO,8BAA8B,IAAI,OAAO;CAC1E,OAAO,OAAO,oBAAoB;AACpC"}
+{"version":3,"file":"args.cjs","names":[],"sources":["../../src/model/args.ts"],"sourcesContent":["import { assertNever } from \"@milaboratories/ts-helpers\";\nimport type { PlRef } from \"@platforma-sdk/model\";\nimport { peelJsonLayers } from \"@milaboratories/pl-model-common\";\n\nexport function outputRef(blockId: string, name: string, requireEnrichments?: boolean): PlRef {\n  if (requireEnrichments) return { __isRef: true, blockId, name, requireEnrichments };\n  else return { __isRef: true, blockId, name };\n}\n\nexport function isBlockOutputReference(obj: unknown): obj is PlRef {\n  return (\n    typeof obj === \"object\" &&\n    obj !== null &&\n    \"__isRef\" in obj &&\n    obj.__isRef === true &&\n    \"blockId\" in obj &&\n    \"name\" in obj\n  );\n}\n\nexport interface BlockUpstreams {\n  /** All direct block dependencies */\n  upstreams: Set<string>;\n  /** Direct block dependencies which enrichments are also required by current block */\n  upstreamsRequiringEnrichments: Set<string>;\n  /** True if not-allowed references was encountered */\n  missingReferences: boolean;\n}\n\n/** Extracts all resource ids referenced by args object. */\nexport function inferAllReferencedBlocks(args: unknown, allowed?: Set<string>): BlockUpstreams {\n  const result = {\n    upstreams: new Set<string>(),\n    upstreamsRequiringEnrichments: new Set<string>(),\n    missingReferences: false,\n  };\n  addAllReferencedBlocks(result, args, allowed);\n  return result;\n}\n\nfunction addAllReferencedBlocks(result: BlockUpstreams, node: unknown, allowed?: Set<string>) {\n  const type = typeof node;\n  switch (type) {\n    case \"function\":\n    case \"bigint\":\n    case \"number\":\n    case \"boolean\":\n    case \"symbol\":\n    case \"undefined\":\n      return;\n    case \"string\": {\n      // A reference can be hiding inside a string under any number of `JSON.stringify`\n      // passes, and this walk would otherwise never reach it. Peeling is shared with the\n      // column-id remapper so that \"how a value hides inside a string\" has one\n      // definition; what happens at the bottom is not shared, and here it is deliberately\n      // broad — anything the peel produced is walked, including a foreign-schema document\n      // that merely contains a reference. That breadth is what makes this detector usable\n      // as a guard over carriers the template codec declines to touch.\n      const peeled = peelJsonLayers(node as string);\n      if (peeled !== undefined) addAllReferencedBlocks(result, peeled.value, allowed);\n      return;\n    }\n    case \"object\": {\n      if (node === null) return;\n      if (isBlockOutputReference(node)) {\n        recordRef(result, node.blockId, node.requireEnrichments === true, allowed);\n      } else if (Array.isArray(node)) {\n        for (const child of node) addAllReferencedBlocks(result, child, allowed);\n      } else {\n        // Keys as well as values: a discovered column's `queriesQualifications` is keyed BY\n        // column id, so a map key can carry a block id — and dropping the key loses that\n        // upstream edge entirely.\n        for (const [key, child] of Object.entries(node as object)) {\n          addAllReferencedBlocks(result, key, allowed);\n          addAllReferencedBlocks(result, child, allowed);\n        }\n      }\n\n      return;\n    }\n    default:\n      assertNever(type);\n  }\n}\n\nfunction recordRef(\n  result: BlockUpstreams,\n  blockId: string,\n  requireEnrichments: boolean,\n  allowed?: Set<string>,\n) {\n  if (allowed === undefined || allowed.has(blockId)) {\n    result.upstreams.add(blockId);\n    if (requireEnrichments) result.upstreamsRequiringEnrichments.add(blockId);\n  } else result.missingReferences = true;\n}\n"],"mappings":";;;AAIA,SAAgB,UAAU,SAAiB,MAAc,oBAAqC;CAC5F,IAAI,oBAAoB,OAAO;EAAE,SAAS;EAAM;EAAS;EAAM;CAAmB;MAC7E,OAAO;EAAE,SAAS;EAAM;EAAS;CAAK;AAC7C;AAEA,SAAgB,uBAAuB,KAA4B;CACjE,OACE,OAAO,QAAQ,YACf,QAAQ,QACR,aAAa,OACb,IAAI,YAAY,QAChB,aAAa,OACb,UAAU;AAEd;;AAYA,SAAgB,yBAAyB,MAAe,SAAuC;CAC7F,MAAM,SAAS;EACb,2BAAW,IAAI,IAAY;EAC3B,+CAA+B,IAAI,IAAY;EAC/C,mBAAmB;CACrB;CACA,uBAAuB,QAAQ,MAAM,OAAO;CAC5C,OAAO;AACT;AAEA,SAAS,uBAAuB,QAAwB,MAAe,SAAuB;CAC5F,MAAM,OAAO,OAAO;CACpB,QAAQ,MAAR;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,aACH;EACF,KAAK,UAAU;GAQb,MAAM,UAAA,GAAA,gCAAA,eAAA,CAAwB,IAAc;GAC5C,IAAI,WAAW,KAAA,GAAW,uBAAuB,QAAQ,OAAO,OAAO,OAAO;GAC9E;EACF;EACA,KAAK;GACH,IAAI,SAAS,MAAM;GACnB,IAAI,uBAAuB,IAAI,GAC7B,UAAU,QAAQ,KAAK,SAAS,KAAK,uBAAuB,MAAM,OAAO;QACpE,IAAI,MAAM,QAAQ,IAAI,GAC3B,KAAK,MAAM,SAAS,MAAM,uBAAuB,QAAQ,OAAO,OAAO;QAKvE,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAc,GAAG;IACzD,uBAAuB,QAAQ,KAAK,OAAO;IAC3C,uBAAuB,QAAQ,OAAO,OAAO;GAC/C;GAGF;EAEF,SACE,CAAA,GAAA,2BAAA,YAAA,CAAY,IAAI;CACpB;AACF;AAEA,SAAS,UACP,QACA,SACA,oBACA,SACA;CACA,IAAI,YAAY,KAAA,KAAa,QAAQ,IAAI,OAAO,GAAG;EACjD,OAAO,UAAU,IAAI,OAAO;EAC5B,IAAI,oBAAoB,OAAO,8BAA8B,IAAI,OAAO;CAC1E,OAAO,OAAO,oBAAoB;AACpC"}

package/dist/model/args.js

@@ -1,4 +1,5 @@
 import { assertNever } from "@milaboratories/ts-helpers";
+import { peelJsonLayers } from "@milaboratories/pl-model-common";
 //#region src/model/args.ts
 function outputRef(blockId, name, requireEnrichments) {
 	if (requireEnrichments) return {
@@ -35,43 +36,23 @@ function addAllReferencedBlocks(result, node, allowed) {
 		case "boolean":
 		case "symbol":
 		case "undefined": return;
-		case "string":
-			unwrapEmbeddedRef(node, (parsed) => addAllReferencedBlocks(result, parsed, allowed));
+		case "string": {
+			const peeled = peelJsonLayers(node);
+			if (peeled !== void 0) addAllReferencedBlocks(result, peeled.value, allowed);
 			return;
+		}
 		case "object":
 			if (node === null) return;
 			if (isBlockOutputReference(node)) recordRef(result, node.blockId, node.requireEnrichments === true, allowed);
 			else if (Array.isArray(node)) for (const child of node) addAllReferencedBlocks(result, child, allowed);
-			else for (const [, child] of Object.entries(node)) addAllReferencedBlocks(result, child, allowed);
+			else for (const [key, child] of Object.entries(node)) {
+				addAllReferencedBlocks(result, key, allowed);
+				addAllReferencedBlocks(result, child, allowed);
+			}
 			return;
 		default: assertNever(type);
 	}
 }
-/**
-* Detect a PlRef carried inside a string and hand the decoded value to `onParsed`.
-*
-* A PlRef-as-string is canonical `{...}` optionally wrapped by N `JSON.stringify`
-* passes. Each pass adds a symmetric prefix/suffix made only of `"` and `\`
-* chars (the escape padding) of equal length. The regex below is the strict
-* shape gate — non-ref strings fail at the very first character, so we never
-* scan their body. One pass is peeled per call; deeper nesting is unwrapped
-* via recursion in the caller.
-*/
-const EMBEDDED_REF_RE = /^(?<pre>[\\"]*)\{[\s\S]*?__isRef[\s\S]*\}(?<suf>[\\"]*)$/;
-function unwrapEmbeddedRef(s, onParsed) {
-	const c0 = s.charCodeAt(0);
-	if (c0 !== 123 && c0 !== 34) return;
-	const m = EMBEDDED_REF_RE.exec(s);
-	if (m === null) return;
-	if (m.groups.pre.length !== m.groups.suf.length) return;
-	let parsed;
-	try {
-		parsed = JSON.parse(s);
-	} catch {
-		return;
-	}
-	if (parsed !== s) onParsed(parsed);
-}
 function recordRef(result, blockId, requireEnrichments, allowed) {
 	if (allowed === void 0 || allowed.has(blockId)) {
 		result.upstreams.add(blockId);

package/dist/model/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","names":[],"sources":["../../src/model/args.ts"],"sourcesContent":["import { assertNever } from \"@milaboratories/ts-helpers\";\nimport type { PlRef } from \"@platforma-sdk/model\";\n\nexport function outputRef(blockId: string, name: string, requireEnrichments?: boolean): PlRef {\n  if (requireEnrichments) return { __isRef: true, blockId, name, requireEnrichments };\n  else return { __isRef: true, blockId, name };\n}\n\nexport function isBlockOutputReference(obj: unknown): obj is PlRef {\n  return (\n    typeof obj === \"object\" &&\n    obj !== null &&\n    \"__isRef\" in obj &&\n    obj.__isRef === true &&\n    \"blockId\" in obj &&\n    \"name\" in obj\n  );\n}\n\nexport interface BlockUpstreams {\n  /** All direct block dependencies */\n  upstreams: Set<string>;\n  /** Direct block dependencies which enrichments are also required by current block */\n  upstreamsRequiringEnrichments: Set<string>;\n  /** True if not-allowed references was encountered */\n  missingReferences: boolean;\n}\n\n/** Extracts all resource ids referenced by args object. */\nexport function inferAllReferencedBlocks(args: unknown, allowed?: Set<string>): BlockUpstreams {\n  const result = {\n    upstreams: new Set<string>(),\n    upstreamsRequiringEnrichments: new Set<string>(),\n    missingReferences: false,\n  };\n  addAllReferencedBlocks(result, args, allowed);\n  return result;\n}\n\nfunction addAllReferencedBlocks(result: BlockUpstreams, node: unknown, allowed?: Set<string>) {\n  const type = typeof node;\n  switch (type) {\n    case \"function\":\n    case \"bigint\":\n    case \"number\":\n    case \"boolean\":\n    case \"symbol\":\n    case \"undefined\":\n      return;\n    case \"string\": {\n      unwrapEmbeddedRef(node as string, (parsed) =>\n        addAllReferencedBlocks(result, parsed, allowed),\n      );\n      return;\n    }\n    case \"object\": {\n      if (node === null) return;\n      if (isBlockOutputReference(node)) {\n        recordRef(result, node.blockId, node.requireEnrichments === true, allowed);\n      } else if (Array.isArray(node)) {\n        for (const child of node) addAllReferencedBlocks(result, child, allowed);\n      } else {\n        for (const [, child] of Object.entries(node as object))\n          addAllReferencedBlocks(result, child, allowed);\n      }\n\n      return;\n    }\n    default:\n      assertNever(type);\n  }\n}\n\n/**\n * Detect a PlRef carried inside a string and hand the decoded value to `onParsed`.\n *\n * A PlRef-as-string is canonical `{...}` optionally wrapped by N `JSON.stringify`\n * passes. Each pass adds a symmetric prefix/suffix made only of `\"` and `\\`\n * chars (the escape padding) of equal length. The regex below is the strict\n * shape gate — non-ref strings fail at the very first character, so we never\n * scan their body. One pass is peeled per call; deeper nesting is unwrapped\n * via recursion in the caller.\n */\nconst EMBEDDED_REF_RE = /^(?<pre>[\\\\\"]*)\\{[\\s\\S]*?__isRef[\\s\\S]*\\}(?<suf>[\\\\\"]*)$/;\n\nfunction unwrapEmbeddedRef(s: string, onParsed: (value: unknown) => void) {\n  const c0 = s.charCodeAt(0);\n  if (c0 !== 0x7b /* { */ && c0 !== 0x22 /* \" */) return;\n  const m = EMBEDDED_REF_RE.exec(s);\n  if (m === null) return;\n  if (m.groups!.pre.length !== m.groups!.suf.length) return;\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(s);\n  } catch {\n    return;\n  }\n  if (parsed !== s) onParsed(parsed);\n}\n\nfunction recordRef(\n  result: BlockUpstreams,\n  blockId: string,\n  requireEnrichments: boolean,\n  allowed?: Set<string>,\n) {\n  if (allowed === undefined || allowed.has(blockId)) {\n    result.upstreams.add(blockId);\n    if (requireEnrichments) result.upstreamsRequiringEnrichments.add(blockId);\n  } else result.missingReferences = true;\n}\n"],"mappings":";;AAGA,SAAgB,UAAU,SAAiB,MAAc,oBAAqC;CAC5F,IAAI,oBAAoB,OAAO;EAAE,SAAS;EAAM;EAAS;EAAM;CAAmB;MAC7E,OAAO;EAAE,SAAS;EAAM;EAAS;CAAK;AAC7C;AAEA,SAAgB,uBAAuB,KAA4B;CACjE,OACE,OAAO,QAAQ,YACf,QAAQ,QACR,aAAa,OACb,IAAI,YAAY,QAChB,aAAa,OACb,UAAU;AAEd;;AAYA,SAAgB,yBAAyB,MAAe,SAAuC;CAC7F,MAAM,SAAS;EACb,2BAAW,IAAI,IAAY;EAC3B,+CAA+B,IAAI,IAAY;EAC/C,mBAAmB;CACrB;CACA,uBAAuB,QAAQ,MAAM,OAAO;CAC5C,OAAO;AACT;AAEA,SAAS,uBAAuB,QAAwB,MAAe,SAAuB;CAC5F,MAAM,OAAO,OAAO;CACpB,QAAQ,MAAR;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,aACH;EACF,KAAK;GACH,kBAAkB,OAAiB,WACjC,uBAAuB,QAAQ,QAAQ,OAAO,CAChD;GACA;EAEF,KAAK;GACH,IAAI,SAAS,MAAM;GACnB,IAAI,uBAAuB,IAAI,GAC7B,UAAU,QAAQ,KAAK,SAAS,KAAK,uBAAuB,MAAM,OAAO;QACpE,IAAI,MAAM,QAAQ,IAAI,GAC3B,KAAK,MAAM,SAAS,MAAM,uBAAuB,QAAQ,OAAO,OAAO;QAEvE,KAAK,MAAM,GAAG,UAAU,OAAO,QAAQ,IAAc,GACnD,uBAAuB,QAAQ,OAAO,OAAO;GAGjD;EAEF,SACE,YAAY,IAAI;CACpB;AACF;;;;;;;;;;;AAYA,MAAM,kBAAkB;AAExB,SAAS,kBAAkB,GAAW,UAAoC;CACxE,MAAM,KAAK,EAAE,WAAW,CAAC;CACzB,IAAI,OAAO,OAAgB,OAAO,IAAc;CAChD,MAAM,IAAI,gBAAgB,KAAK,CAAC;CAChC,IAAI,MAAM,MAAM;CAChB,IAAI,EAAE,OAAQ,IAAI,WAAW,EAAE,OAAQ,IAAI,QAAQ;CACnD,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,CAAC;CACvB,QAAQ;EACN;CACF;CACA,IAAI,WAAW,GAAG,SAAS,MAAM;AACnC;AAEA,SAAS,UACP,QACA,SACA,oBACA,SACA;CACA,IAAI,YAAY,KAAA,KAAa,QAAQ,IAAI,OAAO,GAAG;EACjD,OAAO,UAAU,IAAI,OAAO;EAC5B,IAAI,oBAAoB,OAAO,8BAA8B,IAAI,OAAO;CAC1E,OAAO,OAAO,oBAAoB;AACpC"}
+{"version":3,"file":"args.js","names":[],"sources":["../../src/model/args.ts"],"sourcesContent":["import { assertNever } from \"@milaboratories/ts-helpers\";\nimport type { PlRef } from \"@platforma-sdk/model\";\nimport { peelJsonLayers } from \"@milaboratories/pl-model-common\";\n\nexport function outputRef(blockId: string, name: string, requireEnrichments?: boolean): PlRef {\n  if (requireEnrichments) return { __isRef: true, blockId, name, requireEnrichments };\n  else return { __isRef: true, blockId, name };\n}\n\nexport function isBlockOutputReference(obj: unknown): obj is PlRef {\n  return (\n    typeof obj === \"object\" &&\n    obj !== null &&\n    \"__isRef\" in obj &&\n    obj.__isRef === true &&\n    \"blockId\" in obj &&\n    \"name\" in obj\n  );\n}\n\nexport interface BlockUpstreams {\n  /** All direct block dependencies */\n  upstreams: Set<string>;\n  /** Direct block dependencies which enrichments are also required by current block */\n  upstreamsRequiringEnrichments: Set<string>;\n  /** True if not-allowed references was encountered */\n  missingReferences: boolean;\n}\n\n/** Extracts all resource ids referenced by args object. */\nexport function inferAllReferencedBlocks(args: unknown, allowed?: Set<string>): BlockUpstreams {\n  const result = {\n    upstreams: new Set<string>(),\n    upstreamsRequiringEnrichments: new Set<string>(),\n    missingReferences: false,\n  };\n  addAllReferencedBlocks(result, args, allowed);\n  return result;\n}\n\nfunction addAllReferencedBlocks(result: BlockUpstreams, node: unknown, allowed?: Set<string>) {\n  const type = typeof node;\n  switch (type) {\n    case \"function\":\n    case \"bigint\":\n    case \"number\":\n    case \"boolean\":\n    case \"symbol\":\n    case \"undefined\":\n      return;\n    case \"string\": {\n      // A reference can be hiding inside a string under any number of `JSON.stringify`\n      // passes, and this walk would otherwise never reach it. Peeling is shared with the\n      // column-id remapper so that \"how a value hides inside a string\" has one\n      // definition; what happens at the bottom is not shared, and here it is deliberately\n      // broad — anything the peel produced is walked, including a foreign-schema document\n      // that merely contains a reference. That breadth is what makes this detector usable\n      // as a guard over carriers the template codec declines to touch.\n      const peeled = peelJsonLayers(node as string);\n      if (peeled !== undefined) addAllReferencedBlocks(result, peeled.value, allowed);\n      return;\n    }\n    case \"object\": {\n      if (node === null) return;\n      if (isBlockOutputReference(node)) {\n        recordRef(result, node.blockId, node.requireEnrichments === true, allowed);\n      } else if (Array.isArray(node)) {\n        for (const child of node) addAllReferencedBlocks(result, child, allowed);\n      } else {\n        // Keys as well as values: a discovered column's `queriesQualifications` is keyed BY\n        // column id, so a map key can carry a block id — and dropping the key loses that\n        // upstream edge entirely.\n        for (const [key, child] of Object.entries(node as object)) {\n          addAllReferencedBlocks(result, key, allowed);\n          addAllReferencedBlocks(result, child, allowed);\n        }\n      }\n\n      return;\n    }\n    default:\n      assertNever(type);\n  }\n}\n\nfunction recordRef(\n  result: BlockUpstreams,\n  blockId: string,\n  requireEnrichments: boolean,\n  allowed?: Set<string>,\n) {\n  if (allowed === undefined || allowed.has(blockId)) {\n    result.upstreams.add(blockId);\n    if (requireEnrichments) result.upstreamsRequiringEnrichments.add(blockId);\n  } else result.missingReferences = true;\n}\n"],"mappings":";;;AAIA,SAAgB,UAAU,SAAiB,MAAc,oBAAqC;CAC5F,IAAI,oBAAoB,OAAO;EAAE,SAAS;EAAM;EAAS;EAAM;CAAmB;MAC7E,OAAO;EAAE,SAAS;EAAM;EAAS;CAAK;AAC7C;AAEA,SAAgB,uBAAuB,KAA4B;CACjE,OACE,OAAO,QAAQ,YACf,QAAQ,QACR,aAAa,OACb,IAAI,YAAY,QAChB,aAAa,OACb,UAAU;AAEd;;AAYA,SAAgB,yBAAyB,MAAe,SAAuC;CAC7F,MAAM,SAAS;EACb,2BAAW,IAAI,IAAY;EAC3B,+CAA+B,IAAI,IAAY;EAC/C,mBAAmB;CACrB;CACA,uBAAuB,QAAQ,MAAM,OAAO;CAC5C,OAAO;AACT;AAEA,SAAS,uBAAuB,QAAwB,MAAe,SAAuB;CAC5F,MAAM,OAAO,OAAO;CACpB,QAAQ,MAAR;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,aACH;EACF,KAAK,UAAU;GAQb,MAAM,SAAS,eAAe,IAAc;GAC5C,IAAI,WAAW,KAAA,GAAW,uBAAuB,QAAQ,OAAO,OAAO,OAAO;GAC9E;EACF;EACA,KAAK;GACH,IAAI,SAAS,MAAM;GACnB,IAAI,uBAAuB,IAAI,GAC7B,UAAU,QAAQ,KAAK,SAAS,KAAK,uBAAuB,MAAM,OAAO;QACpE,IAAI,MAAM,QAAQ,IAAI,GAC3B,KAAK,MAAM,SAAS,MAAM,uBAAuB,QAAQ,OAAO,OAAO;QAKvE,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAc,GAAG;IACzD,uBAAuB,QAAQ,KAAK,OAAO;IAC3C,uBAAuB,QAAQ,OAAO,OAAO;GAC/C;GAGF;EAEF,SACE,YAAY,IAAI;CACpB;AACF;AAEA,SAAS,UACP,QACA,SACA,oBACA,SACA;CACA,IAAI,YAAY,KAAA,KAAa,QAAQ,IAAI,OAAO,GAAG;EACjD,OAAO,UAAU,IAAI,OAAO;EAC5B,IAAI,oBAAoB,OAAO,8BAA8B,IAAI,OAAO;CAC1E,OAAO,OAAO,oBAAoB;AACpC"}

package/dist/model/index.cjs

@@ -1,6 +1,9 @@
 const require_project_model = require("./project_model.cjs");
 const require_block_pack_spec = require("./block_pack_spec.cjs");
 const require_sharing_model = require("./sharing_model.cjs");
+const require_template_parser = require("./template_parser.cjs");
+const require_template_resolve = require("./template_resolve.cjs");
+const require_template_apply = require("./template_apply.cjs");
 exports.AcceptanceFieldPrefix = require_sharing_model.AcceptanceFieldPrefix;
 exports.BlockArgsAuthorKeyPrefix = require_project_model.BlockArgsAuthorKeyPrefix;
 exports.FrontendFromFolderResourceType = require_block_pack_spec.FrontendFromFolderResourceType;
@@ -19,6 +22,7 @@ exports.SharingOutboxField = require_sharing_model.SharingOutboxField;
 exports.SharingOutboxResourceType = require_sharing_model.SharingOutboxResourceType;
 exports.SharingStateField = require_sharing_model.SharingStateField;
 exports.SharingStateResourceType = require_sharing_model.SharingStateResourceType;
+exports.TemplateEntryRejected = require_template_apply.TemplateEntryRejected;
 exports.acceptanceField = require_sharing_model.acceptanceField;
 exports.acceptanceFieldLogin = require_sharing_model.acceptanceFieldLogin;
 exports.asShareId = require_sharing_model.asShareId;
@@ -28,3 +32,6 @@ exports.decisionField = require_sharing_model.decisionField;
 exports.decodeEnvelopeData = require_sharing_model.decodeEnvelopeData;
 exports.isAcceptanceField = require_sharing_model.isAcceptanceField;
 exports.newShareId = require_sharing_model.newShareId;
+exports.parseBlockPackName = require_template_resolve.parseBlockPackName;
+exports.parseProjectTemplateV1Yaml = require_template_parser.parseProjectTemplateV1Yaml;
+exports.resolveTemplateEntries = require_template_resolve.resolveTemplateEntries;

package/dist/model/index.d.ts

@@ -1,4 +1,7 @@
+import { AppliedEntry, TemplateApplyProblem, TemplateApplyReport, TemplateEntryRejected } from "./template_apply.js";
+import { BlockPackProvider, ExactResolution, KindResolution, ResolvedEntry, TemplateResolveOutcome, parseBlockPackName, resolveTemplateEntries } from "./template_resolve.js";
 import { BlockArgsAuthorKeyPrefix, ProjectCreatedTimestamp, ProjectField, ProjectId, ProjectLastModifiedTimestamp, ProjectListEntry, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, SchemaVersionCurrent, SchemaVersionKey } from "./project_model.js";
 import { AcceptanceFieldPrefix, EnvelopeAcceptance, EnvelopeData, EnvelopeMode, EnvelopeProject, ProjectChangeAction, ProjectFieldUuid, ShareId, ShareProjectsOptions, SharedEnvelopeResourceType, SharingDecision, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, acceptanceField, acceptanceFieldLogin, asShareId, canGrantToEveryone, canImpersonate, decisionField, decodeEnvelopeData, isAcceptanceField, newShareId } from "./sharing_model.js";
 import { BlockPackExplicit, BlockPackSpecAny, BlockPackSpecPrepared, FrontendFromFolder, FrontendFromFolderData, FrontendFromFolderResourceType, FrontendFromLocalTgz, FrontendFromLocalTgzData, FrontendFromLocalTgzResourceType, FrontendFromUrl, FrontendFromUrlData, FrontendFromUrlResourceType, FrontendSpec } from "./block_pack_spec.js";
-export { AcceptanceFieldPrefix, BlockArgsAuthorKeyPrefix, BlockPackExplicit, BlockPackSpecAny, BlockPackSpecPrepared, EnvelopeAcceptance, EnvelopeData, EnvelopeMode, EnvelopeProject, FrontendFromFolder, FrontendFromFolderData, FrontendFromFolderResourceType, FrontendFromLocalTgz, FrontendFromLocalTgzData, FrontendFromLocalTgzResourceType, FrontendFromUrl, FrontendFromUrlData, FrontendFromUrlResourceType, FrontendSpec, ProjectChangeAction, ProjectCreatedTimestamp, type ProjectField, ProjectFieldUuid, ProjectLastModifiedTimestamp, type ProjectListEntry, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, SchemaVersionCurrent, SchemaVersionKey, ShareId, ShareProjectsOptions, SharedEnvelopeResourceType, SharingDecision, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, acceptanceField, acceptanceFieldLogin, asShareId, canGrantToEveryone, canImpersonate, decisionField, decodeEnvelopeData, isAcceptanceField, newShareId };
+import { TemplateParseOutcome, parseProjectTemplateV1Yaml } from "./template_parser.js";
+export { AcceptanceFieldPrefix, type AppliedEntry, BlockArgsAuthorKeyPrefix, BlockPackExplicit, type BlockPackProvider, BlockPackSpecAny, BlockPackSpecPrepared, EnvelopeAcceptance, EnvelopeData, EnvelopeMode, EnvelopeProject, type ExactResolution, FrontendFromFolder, FrontendFromFolderData, FrontendFromFolderResourceType, FrontendFromLocalTgz, FrontendFromLocalTgzData, FrontendFromLocalTgzResourceType, FrontendFromUrl, FrontendFromUrlData, FrontendFromUrlResourceType, FrontendSpec, type KindResolution, ProjectChangeAction, ProjectCreatedTimestamp, type ProjectField, ProjectFieldUuid, ProjectLastModifiedTimestamp, type ProjectListEntry, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, type ResolvedEntry, SchemaVersionCurrent, SchemaVersionKey, ShareId, ShareProjectsOptions, SharedEnvelopeResourceType, SharingDecision, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, type TemplateApplyProblem, type TemplateApplyReport, TemplateEntryRejected, type TemplateParseOutcome, type TemplateResolveOutcome, acceptanceField, acceptanceFieldLogin, asShareId, canGrantToEveryone, canImpersonate, decisionField, decodeEnvelopeData, isAcceptanceField, newShareId, parseBlockPackName, parseProjectTemplateV1Yaml, resolveTemplateEntries };

package/dist/model/index.js

@@ -1,4 +1,7 @@
 import { BlockArgsAuthorKeyPrefix, ProjectCreatedTimestamp, ProjectLastModifiedTimestamp, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, SchemaVersionCurrent, SchemaVersionKey } from "./project_model.js";
 import { FrontendFromFolderResourceType, FrontendFromLocalTgzResourceType, FrontendFromUrlResourceType } from "./block_pack_spec.js";
 import { AcceptanceFieldPrefix, SharedEnvelopeResourceType, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, acceptanceField, acceptanceFieldLogin, asShareId, canGrantToEveryone, canImpersonate, decisionField, decodeEnvelopeData, isAcceptanceField, newShareId } from "./sharing_model.js";
-export { AcceptanceFieldPrefix, BlockArgsAuthorKeyPrefix, FrontendFromFolderResourceType, FrontendFromLocalTgzResourceType, FrontendFromUrlResourceType, ProjectCreatedTimestamp, ProjectLastModifiedTimestamp, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, SchemaVersionCurrent, SchemaVersionKey, SharedEnvelopeResourceType, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, acceptanceField, acceptanceFieldLogin, asShareId, canGrantToEveryone, canImpersonate, decisionField, decodeEnvelopeData, isAcceptanceField, newShareId };
+import { parseProjectTemplateV1Yaml } from "./template_parser.js";
+import { parseBlockPackName, resolveTemplateEntries } from "./template_resolve.js";
+import { TemplateEntryRejected } from "./template_apply.js";
+export { AcceptanceFieldPrefix, BlockArgsAuthorKeyPrefix, FrontendFromFolderResourceType, FrontendFromLocalTgzResourceType, FrontendFromUrlResourceType, ProjectCreatedTimestamp, ProjectLastModifiedTimestamp, ProjectMetaKey, ProjectResourceType, ProjectStructureAuthorKey, ProjectStructureKey, SchemaVersionCurrent, SchemaVersionKey, SharedEnvelopeResourceType, SharingOutboxField, SharingOutboxResourceType, SharingStateField, SharingStateResourceType, TemplateEntryRejected, acceptanceField, acceptanceFieldLogin, asShareId, canGrantToEveryone, canImpersonate, decisionField, decodeEnvelopeData, isAcceptanceField, newShareId, parseBlockPackName, parseProjectTemplateV1Yaml, resolveTemplateEntries };

package/dist/model/project_helper.cjs

@@ -56,6 +56,44 @@ var ProjectHelper = class {
 			return;
 		}
 	}
+	/**
+	* Derives this block's template-export params from storage JSON using the VM
+	* callback (`__pl_initializationParams_derive`).
+	*
+	* The template-export counterpart of {@link deriveArgsFromStorage}: instead of
+	* the args a workflow runs on, it returns the params that would recreate the
+	* block — the inverse of the data model's `init`. Params come back exactly as the block
+	* projected them, references included: nothing marks or rewrites them on the way out, so
+	* nothing here has to know a kind's params shape or how a reference is spelled.
+	*
+	* A `{ value: undefined }` result means the block declares no `templateParams`, which only
+	* a block built against an older SDK can do. It does not reach a document: the export walk
+	* requires a mapping and reports anything else as that block's problem, so an entry always
+	* carries params.
+	*
+	* Unlike {@link derivePrerunArgsFromStorage}, a failure here is surfaced rather
+	* than swallowed — a prerun that cannot derive args just skips a block in
+	* staging, whereas an export that silently drops a block produces a template
+	* that does not describe the project.
+	*
+	* @param blockConfig The block configuration (provides the model code)
+	* @param storageJson Storage as JSON string
+	* @returns The derived params with identifiers wrapped, `undefined` if the block declares
+	*   no lambda, or an error if derivation failed
+	*/
+	deriveTemplateParamsFromStorage(blockConfig, storageJson) {
+		if (blockConfig.modelAPIVersion !== _platforma_sdk_model.BLOCK_STORAGE_FACADE_VERSION) return { error: /* @__PURE__ */ new Error("deriveTemplateParamsFromStorage is only supported for model API version 2") };
+		const callback = blockConfig.blockLifecycleCallbacks[_platforma_sdk_model.BlockStorageFacadeCallbacks.InitializationParamsDerive];
+		if (callback === void 0) return { error: /* @__PURE__ */ new Error("This version of the block cannot be written to a template. Update the block to a newer version and export again.") };
+		try {
+			const result = require_index$1.executeSingleLambda(this.quickJs, callback, (0, _platforma_sdk_model.extractCodeWithInfo)(blockConfig), storageJson);
+			if (result.error !== void 0) return { error: new Error(result.error) };
+			return { value: result.value };
+		} catch (e) {
+			const cause = (0, _platforma_sdk_model.ensureError)(e);
+			return { error: new Error(`Template params derivation from storage failed: ${cause.message}`, { cause }) };
+		}
+	}
 	calculateEnrichmentTargets(req) {
 		const blockConfig = req.blockConfig();
 		if (blockConfig.enrichmentTargets === void 0) return void 0;
@@ -91,6 +129,79 @@ var ProjectHelper = class {
 		}
 	}
 	/**
+	* Checks a template entry's params against the block's kind, creating nothing.
+	*
+	* The pre-flight half of {@link getInitialStorageFromParamsInVM}: run once per entry
+	* before a template is applied, so params a kind rejects are reported against the
+	* entry that carries them while there is still no project. Skipping it is safe —
+	* initialization runs the same check — but then the report arrives after earlier
+	* entries have already been created.
+	*
+	* Every kind declares a parser, so a pass here means the params were checked against
+	* the contract — not merely that they were JSON.
+	*
+	* A block whose model predates the callback passes unchecked rather than failing.
+	* Unlike initialization, this method creates nothing, so there is nothing to get wrong
+	* by proceeding, and such a block is refused outright at the point it is applied.
+	*
+	* @param blockConfig The block configuration (provides the model code)
+	* @param params The entry's params. Reference ids may be placeholders: what is being
+	*   checked is the shape of the params, not what they point at
+	* @returns Nothing, or why the params were rejected
+	*/
+	validateTemplateParamsInVM(blockConfig, params) {
+		if (blockConfig.modelAPIVersion !== _platforma_sdk_model.BLOCK_STORAGE_FACADE_VERSION) return { error: /* @__PURE__ */ new Error("validateTemplateParamsInVM is only supported for model API version 2") };
+		const callback = blockConfig.blockLifecycleCallbacks[_platforma_sdk_model.BlockStorageFacadeCallbacks.InitializationParamsValidate];
+		if (callback === void 0) return { value: void 0 };
+		try {
+			const result = require_index$1.executeSingleLambda(this.quickJs, callback, (0, _platforma_sdk_model.extractCodeWithInfo)(blockConfig), JSON.stringify(params ?? {}));
+			if (result.error !== void 0) return { error: new Error(result.error) };
+			return { value: void 0 };
+		} catch (e) {
+			const cause = (0, _platforma_sdk_model.ensureError)(e);
+			return { error: new Error(`Params check failed to run: ${cause.message}`, { cause }) };
+		}
+	}
+	/**
+	* Creates initial BlockStorage for a block being created from template params.
+	*
+	* The inverse of {@link deriveTemplateParamsFromStorage}, and the reason a block
+	* can be created by anything other than the UI: it hands the params to the
+	* block's own init factory inside the model VM, so the resulting storage is
+	* whatever that block considers a correctly-initialized state.
+	*
+	* **Pointing the entry's references at this project happens in the same call**, before the
+	* factory sees them — inside the block's bundle, because recognizing a reference means
+	* knowing the reference system and a template engine deliberately does not. Params reach
+	* here exactly as the file held them.
+	*
+	* One call and not two: every VM call builds a fresh runtime and re-evaluates the whole
+	* model bundle, so asking the block to relocate and then asking it to initialize would parse
+	* it twice per entry, for an intermediate value nothing else reads.
+	*
+	* `blockIds` holds the entries created so far, so an id it does not name is left as it is —
+	* a reference to an entry further down the file keeps pointing at nothing, and the applied
+	* block reports itself as missing references rather than being wired to a block below it.
+	*
+	* @param blockConfig The block configuration (provides the model code)
+	* @param params The entry's params, as the document held them
+	* @param blockIds template-local entry id → the block id that entry was given
+	* @returns The initial storage as JSON string, or why the params yield none
+	*/
+	getInitialStorageFromParamsInVM(blockConfig, params, blockIds) {
+		if (blockConfig.modelAPIVersion !== _platforma_sdk_model.BLOCK_STORAGE_FACADE_VERSION) return { error: /* @__PURE__ */ new Error("getInitialStorageFromParamsInVM is only supported for model API version 2") };
+		const callback = blockConfig.blockLifecycleCallbacks[_platforma_sdk_model.BlockStorageFacadeCallbacks.StorageInitialFromParams];
+		if (callback === void 0) return { error: /* @__PURE__ */ new Error("This version of the block cannot be created from a template. Use a newer version of the block, or remove the pinned block version from the template entry so a supported one is chosen automatically.") };
+		try {
+			const result = require_index$1.executeSingleLambda(this.quickJs, callback, (0, _platforma_sdk_model.extractCodeWithInfo)(blockConfig), JSON.stringify(params ?? {}), JSON.stringify(Object.fromEntries(blockIds)));
+			if (result.error !== void 0) return { error: new Error(result.error) };
+			return { value: result.storageJson };
+		} catch (e) {
+			const cause = (0, _platforma_sdk_model.ensureError)(e);
+			return { error: new Error(`Initial storage creation from params failed: ${cause.message}`, { cause }) };
+		}
+	}
+	/**
 	* Applies a state update using VM-based transformation.
 	* This calls the model's `__pl_storage_applyUpdate` callback which:
 	* - Normalizes current storage

package/dist/model/project_helper.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"project_helper.cjs","names":["LRUCache","ConsoleLoggerAdapter","BLOCK_STORAGE_FACADE_VERSION","executeSingleLambda","BlockStorageFacadeCallbacks","getDebugFlags"],"sources":["../../src/model/project_helper.ts"],"sourcesContent":["import type { ResultOrError, BlockConfig, BlockStorage, PlRef } from \"@platforma-sdk/model\";\nimport type { StringifiedJson } from \"@milaboratories/pl-model-common\";\nimport {\n  extractCodeWithInfo,\n  ensureError,\n  BlockStorageFacadeCallbacks,\n  BLOCK_STORAGE_FACADE_VERSION,\n} from \"@platforma-sdk/model\";\nimport { LRUCache } from \"lru-cache\";\nimport type { QuickJSWASMModule } from \"quickjs-emscripten\";\nimport { executeSingleLambda } from \"../js_render\";\nimport type { SignedResourceId } from \"@milaboratories/pl-client\";\nimport { ConsoleLoggerAdapter, type MiLogger } from \"@milaboratories/ts-helpers\";\nimport type { StorageDebugView } from \"@milaboratories/pl-model-middle-layer\";\nimport { getDebugFlags } from \"../debug\";\n\ntype EnrichmentTargetsRequest = {\n  blockConfig: () => BlockConfig;\n  args: () => unknown;\n};\n\ntype EnrichmentTargetsValue = {\n  value: PlRef[] | undefined;\n};\n\n/**\n * Result of VM-based storage migration.\n * Returned by migrateStorageInVM().\n *\n * - Error result: { error: string } - serious failure (no context, etc.)\n * - Success result: { newStorageJson: StringifiedJson<BlockStorage>, info: string } - migration succeeded\n */\nexport type MigrationResult =\n  | { error: string }\n  | { error?: undefined; newStorageJson: StringifiedJson<BlockStorage>; info: string };\n\n/**\n * Result of args derivation from storage.\n * Returned by __pl_args_derive and __pl_prerunArgs_derive VM callbacks.\n */\ntype ArgsDeriveResult = { error: string } | { error?: undefined; value: unknown };\n\nexport class ProjectHelper {\n  private readonly enrichmentTargetsCache = new LRUCache<\n    string,\n    EnrichmentTargetsValue,\n    EnrichmentTargetsRequest\n  >({\n    max: 256,\n    memoMethod: (_key, _value, { context }) => {\n      return { value: this.calculateEnrichmentTargets(context) };\n    },\n  });\n\n  constructor(\n    private readonly quickJs: QuickJSWASMModule,\n    public readonly logger: MiLogger = new ConsoleLoggerAdapter(),\n  ) {}\n\n  // =============================================================================\n  // Args Derivation from Storage (V3+)\n  // =============================================================================\n\n  /**\n   * Derives args directly from storage JSON using VM callback.\n   * The VM extracts data from storage and calls the block's args() function.\n   *\n   * This allows the middle layer to work only with storage JSON,\n   * without needing to know the underlying data structure.\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param storageJson Storage as JSON string\n   * @returns The derived args object, or error if derivation fails\n   */\n  public deriveArgsFromStorage(\n    blockConfig: BlockConfig,\n    storageJson: string,\n  ): ResultOrError<unknown> {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      return {\n        error: new Error(\"deriveArgsFromStorage is only supported for model API version 2\"),\n      };\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.ArgsDerive],\n        extractCodeWithInfo(blockConfig),\n        storageJson,\n      ) as ArgsDeriveResult;\n\n      if (result.error !== undefined) {\n        return { error: new Error(result.error) };\n      }\n      return { value: result.value };\n    } catch (e) {\n      return { error: new Error(\"Args derivation from storage failed\", { cause: ensureError(e) }) };\n    }\n  }\n\n  /**\n   * Derives prerunArgs directly from storage JSON using VM callback.\n   * Falls back to args() if prerunArgs is not defined in the block model.\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param storageJson Storage as JSON string\n   * @returns The derived prerunArgs, or undefined if derivation fails\n   */\n  public derivePrerunArgsFromStorage(blockConfig: BlockConfig, storageJson: string): unknown {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"derivePrerunArgsFromStorage is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.PrerunArgsDerive],\n        extractCodeWithInfo(blockConfig),\n        storageJson,\n      ) as ArgsDeriveResult;\n\n      if (result.error !== undefined) {\n        // Return undefined if derivation fails (skip block in staging)\n        return undefined;\n      }\n      return result.value;\n    } catch {\n      // Return undefined if derivation fails (skip block in staging)\n      return undefined;\n    }\n  }\n\n  private calculateEnrichmentTargets(req: EnrichmentTargetsRequest): PlRef[] | undefined {\n    const blockConfig = req.blockConfig();\n    if (blockConfig.enrichmentTargets === undefined) return undefined;\n    const args = req.args();\n    const result = executeSingleLambda(\n      this.quickJs,\n      blockConfig.enrichmentTargets,\n      extractCodeWithInfo(blockConfig),\n      args,\n    ) as PlRef[];\n    return result;\n  }\n\n  public getEnrichmentTargets(\n    blockConfig: () => BlockConfig,\n    args: () => unknown,\n    key?: { argsRid: SignedResourceId; blockPackRid: SignedResourceId },\n  ): PlRef[] | undefined {\n    const req = { blockConfig, args };\n    if (key === undefined) return this.calculateEnrichmentTargets(req);\n    const cacheKey = `${key.argsRid}:${key.blockPackRid}`;\n    return this.enrichmentTargetsCache.memo(cacheKey, { context: req }).value;\n  }\n\n  // =============================================================================\n  // VM-based Storage Operations\n  // =============================================================================\n\n  /**\n   * Creates initial BlockStorage for a new block using VM-based transformation.\n   * This calls the '__pl_storage_initial' callback registered by DataModel which:\n   * - Gets initial data from DataModel.getDefaultData()\n   * - Creates BlockStorage with correct version\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @returns Initial storage as JSON string\n   * @throws Error if storage creation fails\n   */\n  public getInitialStorageInVM(blockConfig: BlockConfig): string {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"getInitialStorageInVM is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageInitial],\n        extractCodeWithInfo(blockConfig),\n      ) as string;\n      return result;\n    } catch (e) {\n      this.logger.error(\n        new Error(\"[ProjectHelper.getInitialStorageInVM] Initial storage creation failed\", {\n          cause: e,\n        }),\n      );\n      throw new Error(`Block initial storage creation failed: ${e}`);\n    }\n  }\n\n  /**\n   * Applies a state update using VM-based transformation.\n   * This calls the model's `__pl_storage_applyUpdate` callback which:\n   * - Normalizes current storage\n   * - Updates state while preserving other fields (version, plugins)\n   * - Returns the updated storage as JSON string\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param currentStorageJson Current storage as JSON string (must be defined)\n   * @param newState New state from developer\n   * @returns Updated storage as JSON string\n   * @throws Error if storage update fails\n   */\n  public applyStorageUpdateInVM(\n    blockConfig: BlockConfig,\n    currentStorageJson: string,\n    payload: { operation: string; value: unknown },\n  ): string {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"applyStorageUpdateInVM is only supported for model API version 2\");\n    }\n\n    if (getDebugFlags().logJsExecStat) {\n      this.logger.info(\n        `[ProjectHelper.applyStorageUpdateInVM] currentStorageJson=${currentStorageJson.length}B, payload=${JSON.stringify(payload).length}B, operation=${payload.operation}`,\n      );\n    }\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageApplyUpdate],\n        extractCodeWithInfo(blockConfig),\n        currentStorageJson,\n        payload,\n      ) as string;\n      return result;\n    } catch (e) {\n      const payloadJson = JSON.stringify(payload);\n      this.logger.error(\n        new Error(\n          `[ProjectHelper.applyStorageUpdateInVM] Storage update failed (currentStorageJson=${currentStorageJson.length}B, payload=${payloadJson.length}B, operation=${payload.operation})`,\n          { cause: e },\n        ),\n      );\n      throw new Error(`Block storage update failed: ${e}`);\n    }\n  }\n\n  /**\n   * Gets storage debug view from raw storage data by calling the VM's __pl_storage_debugView callback.\n   * Returns structured debug info about the storage (e.g., dataVersion).\n   *\n   * @param blockConfig Block configuration\n   * @param rawStorageJson Raw storage as JSON string (or undefined)\n   * @returns Storage debug view as JSON string (e.g., '{\"dataVersion\": \"v1\"}')\n   */\n  public getStorageDebugViewInVM(\n    blockConfig: BlockConfig,\n    rawStorageJson: string | undefined,\n  ): StringifiedJson<StorageDebugView> | undefined {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"getStorageDebugViewInVM is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageDebugView],\n        extractCodeWithInfo(blockConfig),\n        rawStorageJson,\n      ) as StringifiedJson<StorageDebugView>;\n      return result;\n    } catch (e) {\n      this.logger.error(\n        new Error(\"[ProjectHelper.getStorageDebugViewInVM] Get storage debug view failed\", {\n          cause: e,\n        }),\n      );\n      return undefined;\n    }\n  }\n\n  // =============================================================================\n  // Block State Migrations\n  // =============================================================================\n\n  /**\n   * Runs block state migrations via VM-based transformation.\n   * This calls the model's `__pl_storage_migrate` callback which:\n   * - Normalizes current storage to get state and version\n   * - Applies DataModel upgrade to reach target version key\n   * - Runs all necessary migrations sequentially\n   * - Returns new storage with updated state and version\n   *\n   * The middle layer doesn't need to know about dataVersion or storage internals.\n   * All migration logic is encapsulated in the model.\n   *\n   * @param blockConfig The NEW block configuration (provides the model code with migrations)\n   * @param currentStorageJson Current storage as JSON string (or undefined)\n   * @returns MigrationResult with new storage or skip/error info\n   */\n  public migrateStorageInVM(\n    blockConfig: BlockConfig,\n    currentStorageJson: string | undefined,\n  ): MigrationResult {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      return { error: \"migrateStorageInVM is only supported for model API version 2\" };\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageMigrate],\n        extractCodeWithInfo(blockConfig),\n        currentStorageJson,\n      ) as MigrationResult;\n      return result;\n    } catch (e) {\n      this.logger.error(\n        new Error(\"[ProjectHelper.migrateStorageInVM] Migration failed\", { cause: e }),\n      );\n      return { error: `VM execution failed: ${e}` };\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"project_helper.cjs","names":["LRUCache","ConsoleLoggerAdapter","BLOCK_STORAGE_FACADE_VERSION","executeSingleLambda","BlockStorageFacadeCallbacks","getDebugFlags"],"sources":["../../src/model/project_helper.ts"],"sourcesContent":["import type { ResultOrError, BlockConfig, BlockStorage, PlRef } from \"@platforma-sdk/model\";\nimport type { StringifiedJson } from \"@milaboratories/pl-model-common\";\nimport {\n  extractCodeWithInfo,\n  ensureError,\n  BlockStorageFacadeCallbacks,\n  BLOCK_STORAGE_FACADE_VERSION,\n} from \"@platforma-sdk/model\";\nimport { LRUCache } from \"lru-cache\";\nimport type { QuickJSWASMModule } from \"quickjs-emscripten\";\nimport { executeSingleLambda } from \"../js_render\";\nimport type { SignedResourceId } from \"@milaboratories/pl-client\";\nimport { ConsoleLoggerAdapter, type MiLogger } from \"@milaboratories/ts-helpers\";\nimport type { StorageDebugView } from \"@milaboratories/pl-model-middle-layer\";\nimport { getDebugFlags } from \"../debug\";\n\ntype EnrichmentTargetsRequest = {\n  blockConfig: () => BlockConfig;\n  args: () => unknown;\n};\n\ntype EnrichmentTargetsValue = {\n  value: PlRef[] | undefined;\n};\n\n/**\n * Result of VM-based storage migration.\n * Returned by migrateStorageInVM().\n *\n * - Error result: { error: string } - serious failure (no context, etc.)\n * - Success result: { newStorageJson: StringifiedJson<BlockStorage>, info: string } - migration succeeded\n */\nexport type MigrationResult =\n  | { error: string }\n  | { error?: undefined; newStorageJson: StringifiedJson<BlockStorage>; info: string };\n\n/**\n * Result of args derivation from storage.\n * Returned by __pl_args_derive and __pl_prerunArgs_derive VM callbacks.\n */\ntype ArgsDeriveResult = { error: string } | { error?: undefined; value: unknown };\n\n/**\n * Result of building initial storage from params.\n * Returned by the __pl_storage_initialFromParams VM callback.\n */\ntype ParamsStorageResult =\n  | { error: string }\n  | { error?: undefined; storageJson: StringifiedJson<BlockStorage> };\n\n/**\n * Result of checking params against their kind.\n * Returned by the __pl_initializationParams_validate VM callback.\n */\ntype InitializationParamsValidateResult = { error: string } | { error?: undefined };\n\nexport class ProjectHelper {\n  private readonly enrichmentTargetsCache = new LRUCache<\n    string,\n    EnrichmentTargetsValue,\n    EnrichmentTargetsRequest\n  >({\n    max: 256,\n    memoMethod: (_key, _value, { context }) => {\n      return { value: this.calculateEnrichmentTargets(context) };\n    },\n  });\n\n  constructor(\n    private readonly quickJs: QuickJSWASMModule,\n    public readonly logger: MiLogger = new ConsoleLoggerAdapter(),\n  ) {}\n\n  // =============================================================================\n  // Args Derivation from Storage (V3+)\n  // =============================================================================\n\n  /**\n   * Derives args directly from storage JSON using VM callback.\n   * The VM extracts data from storage and calls the block's args() function.\n   *\n   * This allows the middle layer to work only with storage JSON,\n   * without needing to know the underlying data structure.\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param storageJson Storage as JSON string\n   * @returns The derived args object, or error if derivation fails\n   */\n  public deriveArgsFromStorage(\n    blockConfig: BlockConfig,\n    storageJson: string,\n  ): ResultOrError<unknown> {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      return {\n        error: new Error(\"deriveArgsFromStorage is only supported for model API version 2\"),\n      };\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.ArgsDerive],\n        extractCodeWithInfo(blockConfig),\n        storageJson,\n      ) as ArgsDeriveResult;\n\n      if (result.error !== undefined) {\n        return { error: new Error(result.error) };\n      }\n      return { value: result.value };\n    } catch (e) {\n      return { error: new Error(\"Args derivation from storage failed\", { cause: ensureError(e) }) };\n    }\n  }\n\n  /**\n   * Derives prerunArgs directly from storage JSON using VM callback.\n   * Falls back to args() if prerunArgs is not defined in the block model.\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param storageJson Storage as JSON string\n   * @returns The derived prerunArgs, or undefined if derivation fails\n   */\n  public derivePrerunArgsFromStorage(blockConfig: BlockConfig, storageJson: string): unknown {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"derivePrerunArgsFromStorage is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.PrerunArgsDerive],\n        extractCodeWithInfo(blockConfig),\n        storageJson,\n      ) as ArgsDeriveResult;\n\n      if (result.error !== undefined) {\n        // Return undefined if derivation fails (skip block in staging)\n        return undefined;\n      }\n      return result.value;\n    } catch {\n      // Return undefined if derivation fails (skip block in staging)\n      return undefined;\n    }\n  }\n\n  /**\n   * Derives this block's template-export params from storage JSON using the VM\n   * callback (`__pl_initializationParams_derive`).\n   *\n   * The template-export counterpart of {@link deriveArgsFromStorage}: instead of\n   * the args a workflow runs on, it returns the params that would recreate the\n   * block — the inverse of the data model's `init`. Params come back exactly as the block\n   * projected them, references included: nothing marks or rewrites them on the way out, so\n   * nothing here has to know a kind's params shape or how a reference is spelled.\n   *\n   * A `{ value: undefined }` result means the block declares no `templateParams`, which only\n   * a block built against an older SDK can do. It does not reach a document: the export walk\n   * requires a mapping and reports anything else as that block's problem, so an entry always\n   * carries params.\n   *\n   * Unlike {@link derivePrerunArgsFromStorage}, a failure here is surfaced rather\n   * than swallowed — a prerun that cannot derive args just skips a block in\n   * staging, whereas an export that silently drops a block produces a template\n   * that does not describe the project.\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param storageJson Storage as JSON string\n   * @returns The derived params with identifiers wrapped, `undefined` if the block declares\n   *   no lambda, or an error if derivation failed\n   */\n  public deriveTemplateParamsFromStorage(\n    blockConfig: BlockConfig,\n    storageJson: string,\n  ): ResultOrError<unknown> {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      return {\n        error: new Error(\n          \"deriveTemplateParamsFromStorage is only supported for model API version 2\",\n        ),\n      };\n    }\n\n    const callback =\n      blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.InitializationParamsDerive];\n\n    // A model built before this callback existed simply has no entry for it. That is\n    // NOT the same as a block declaring no `templateParams`: the block may well have\n    // params, we just have no way to ask for them. Reporting it as `undefined` params\n    // would export the block stripped of its configuration and quietly rebuild a\n    // differently-configured project, so it has to be an error.\n    // The message names the one action available to whoever pressed Export. It\n    // deliberately says nothing about SDKs or callbacks: the person reading it did\n    // not build this block and cannot change how it was built.\n    if (callback === undefined) {\n      return {\n        error: new Error(\n          \"This version of the block cannot be written to a template. Update the block \" +\n            \"to a newer version and export again.\",\n        ),\n      };\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        callback,\n        extractCodeWithInfo(blockConfig),\n        storageJson,\n      ) as ArgsDeriveResult;\n\n      if (result.error !== undefined) {\n        return { error: new Error(result.error) };\n      }\n      return { value: result.value };\n    } catch (e) {\n      const cause = ensureError(e);\n      // The reason goes in the message, not only in `cause`: this error is rendered\n      // into a per-block export problem and shown to whoever triggered the export,\n      // and every layer between here and there carries only `message`.\n      return {\n        error: new Error(`Template params derivation from storage failed: ${cause.message}`, {\n          cause,\n        }),\n      };\n    }\n  }\n\n  private calculateEnrichmentTargets(req: EnrichmentTargetsRequest): PlRef[] | undefined {\n    const blockConfig = req.blockConfig();\n    if (blockConfig.enrichmentTargets === undefined) return undefined;\n    const args = req.args();\n    const result = executeSingleLambda(\n      this.quickJs,\n      blockConfig.enrichmentTargets,\n      extractCodeWithInfo(blockConfig),\n      args,\n    ) as PlRef[];\n    return result;\n  }\n\n  public getEnrichmentTargets(\n    blockConfig: () => BlockConfig,\n    args: () => unknown,\n    key?: { argsRid: SignedResourceId; blockPackRid: SignedResourceId },\n  ): PlRef[] | undefined {\n    const req = { blockConfig, args };\n    if (key === undefined) return this.calculateEnrichmentTargets(req);\n    const cacheKey = `${key.argsRid}:${key.blockPackRid}`;\n    return this.enrichmentTargetsCache.memo(cacheKey, { context: req }).value;\n  }\n\n  // =============================================================================\n  // VM-based Storage Operations\n  // =============================================================================\n\n  /**\n   * Creates initial BlockStorage for a new block using VM-based transformation.\n   * This calls the '__pl_storage_initial' callback registered by DataModel which:\n   * - Gets initial data from DataModel.getDefaultData()\n   * - Creates BlockStorage with correct version\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @returns Initial storage as JSON string\n   * @throws Error if storage creation fails\n   */\n  public getInitialStorageInVM(blockConfig: BlockConfig): string {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"getInitialStorageInVM is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageInitial],\n        extractCodeWithInfo(blockConfig),\n      ) as string;\n      return result;\n    } catch (e) {\n      this.logger.error(\n        new Error(\"[ProjectHelper.getInitialStorageInVM] Initial storage creation failed\", {\n          cause: e,\n        }),\n      );\n      throw new Error(`Block initial storage creation failed: ${e}`);\n    }\n  }\n\n  /**\n   * Checks a template entry's params against the block's kind, creating nothing.\n   *\n   * The pre-flight half of {@link getInitialStorageFromParamsInVM}: run once per entry\n   * before a template is applied, so params a kind rejects are reported against the\n   * entry that carries them while there is still no project. Skipping it is safe —\n   * initialization runs the same check — but then the report arrives after earlier\n   * entries have already been created.\n   *\n   * Every kind declares a parser, so a pass here means the params were checked against\n   * the contract — not merely that they were JSON.\n   *\n   * A block whose model predates the callback passes unchecked rather than failing.\n   * Unlike initialization, this method creates nothing, so there is nothing to get wrong\n   * by proceeding, and such a block is refused outright at the point it is applied.\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param params The entry's params. Reference ids may be placeholders: what is being\n   *   checked is the shape of the params, not what they point at\n   * @returns Nothing, or why the params were rejected\n   */\n  public validateTemplateParamsInVM(\n    blockConfig: BlockConfig,\n    params: unknown,\n  ): ResultOrError<undefined> {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      return {\n        error: new Error(\"validateTemplateParamsInVM is only supported for model API version 2\"),\n      };\n    }\n\n    const callback =\n      blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.InitializationParamsValidate];\n    if (callback === undefined) return { value: undefined };\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        callback,\n        extractCodeWithInfo(blockConfig),\n        JSON.stringify(params ?? {}),\n      ) as InitializationParamsValidateResult;\n\n      if (result.error !== undefined) return { error: new Error(result.error) };\n      return { value: undefined };\n    } catch (e) {\n      const cause = ensureError(e);\n      return { error: new Error(`Params check failed to run: ${cause.message}`, { cause }) };\n    }\n  }\n\n  /**\n   * Creates initial BlockStorage for a block being created from template params.\n   *\n   * The inverse of {@link deriveTemplateParamsFromStorage}, and the reason a block\n   * can be created by anything other than the UI: it hands the params to the\n   * block's own init factory inside the model VM, so the resulting storage is\n   * whatever that block considers a correctly-initialized state.\n   *\n   * **Pointing the entry's references at this project happens in the same call**, before the\n   * factory sees them — inside the block's bundle, because recognizing a reference means\n   * knowing the reference system and a template engine deliberately does not. Params reach\n   * here exactly as the file held them.\n   *\n   * One call and not two: every VM call builds a fresh runtime and re-evaluates the whole\n   * model bundle, so asking the block to relocate and then asking it to initialize would parse\n   * it twice per entry, for an intermediate value nothing else reads.\n   *\n   * `blockIds` holds the entries created so far, so an id it does not name is left as it is —\n   * a reference to an entry further down the file keeps pointing at nothing, and the applied\n   * block reports itself as missing references rather than being wired to a block below it.\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param params The entry's params, as the document held them\n   * @param blockIds template-local entry id → the block id that entry was given\n   * @returns The initial storage as JSON string, or why the params yield none\n   */\n  public getInitialStorageFromParamsInVM(\n    blockConfig: BlockConfig,\n    params: unknown,\n    blockIds: ReadonlyMap<string, string>,\n  ): ResultOrError<string> {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      return {\n        error: new Error(\n          \"getInitialStorageFromParamsInVM is only supported for model API version 2\",\n        ),\n      };\n    }\n\n    const callback =\n      blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageInitialFromParams];\n\n    // A model built before this callback existed has no entry for it. Falling back to the\n    // params-less initializer is not an option: it would produce a default-configured block\n    // that looks like a successful apply, so the block the user gets would silently differ\n    // from the one the template describes. Nor could its params be used as written — they name\n    // the blocks of the project the template came from, and only this callback knows which of\n    // the values in there are references at all.\n    //\n    // The message offers the two actions available to whoever applied the file. The\n    // second one is the reason this branch is reachable at all: kind resolution only\n    // ever returns a block that declares a kind, and such a block is new enough to\n    // support this — but an entry may pin an exact block version instead, bypassing\n    // resolution, and that pin can name anything ever published.\n    if (callback === undefined) {\n      return {\n        error: new Error(\n          \"This version of the block cannot be created from a template. Use a newer \" +\n            \"version of the block, or remove the pinned block version from the template \" +\n            \"entry so a supported one is chosen automatically.\",\n        ),\n      };\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        callback,\n        extractCodeWithInfo(blockConfig),\n        // Params cross the VM boundary as text, like storage does. `undefined` would\n        // stringify to nothing at all, and an entry with no params must go through\n        // the params-less initializer rather than reaching this method.\n        JSON.stringify(params ?? {}),\n        JSON.stringify(Object.fromEntries(blockIds)),\n      ) as ParamsStorageResult;\n\n      if (result.error !== undefined) return { error: new Error(result.error) };\n      return { value: result.storageJson };\n    } catch (e) {\n      const cause = ensureError(e);\n      // The reason goes in the message, not only in `cause`: this error becomes a\n      // per-entry apply problem shown to whoever triggered the import, and every\n      // layer in between carries only `message`.\n      return {\n        error: new Error(`Initial storage creation from params failed: ${cause.message}`, {\n          cause,\n        }),\n      };\n    }\n  }\n\n  /**\n   * Applies a state update using VM-based transformation.\n   * This calls the model's `__pl_storage_applyUpdate` callback which:\n   * - Normalizes current storage\n   * - Updates state while preserving other fields (version, plugins)\n   * - Returns the updated storage as JSON string\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param currentStorageJson Current storage as JSON string (must be defined)\n   * @param newState New state from developer\n   * @returns Updated storage as JSON string\n   * @throws Error if storage update fails\n   */\n  public applyStorageUpdateInVM(\n    blockConfig: BlockConfig,\n    currentStorageJson: string,\n    payload: { operation: string; value: unknown },\n  ): string {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"applyStorageUpdateInVM is only supported for model API version 2\");\n    }\n\n    if (getDebugFlags().logJsExecStat) {\n      this.logger.info(\n        `[ProjectHelper.applyStorageUpdateInVM] currentStorageJson=${currentStorageJson.length}B, payload=${JSON.stringify(payload).length}B, operation=${payload.operation}`,\n      );\n    }\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageApplyUpdate],\n        extractCodeWithInfo(blockConfig),\n        currentStorageJson,\n        payload,\n      ) as string;\n      return result;\n    } catch (e) {\n      const payloadJson = JSON.stringify(payload);\n      this.logger.error(\n        new Error(\n          `[ProjectHelper.applyStorageUpdateInVM] Storage update failed (currentStorageJson=${currentStorageJson.length}B, payload=${payloadJson.length}B, operation=${payload.operation})`,\n          { cause: e },\n        ),\n      );\n      throw new Error(`Block storage update failed: ${e}`);\n    }\n  }\n\n  /**\n   * Gets storage debug view from raw storage data by calling the VM's __pl_storage_debugView callback.\n   * Returns structured debug info about the storage (e.g., dataVersion).\n   *\n   * @param blockConfig Block configuration\n   * @param rawStorageJson Raw storage as JSON string (or undefined)\n   * @returns Storage debug view as JSON string (e.g., '{\"dataVersion\": \"v1\"}')\n   */\n  public getStorageDebugViewInVM(\n    blockConfig: BlockConfig,\n    rawStorageJson: string | undefined,\n  ): StringifiedJson<StorageDebugView> | undefined {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"getStorageDebugViewInVM is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageDebugView],\n        extractCodeWithInfo(blockConfig),\n        rawStorageJson,\n      ) as StringifiedJson<StorageDebugView>;\n      return result;\n    } catch (e) {\n      this.logger.error(\n        new Error(\"[ProjectHelper.getStorageDebugViewInVM] Get storage debug view failed\", {\n          cause: e,\n        }),\n      );\n      return undefined;\n    }\n  }\n\n  // =============================================================================\n  // Block State Migrations\n  // =============================================================================\n\n  /**\n   * Runs block state migrations via VM-based transformation.\n   * This calls the model's `__pl_storage_migrate` callback which:\n   * - Normalizes current storage to get state and version\n   * - Applies DataModel upgrade to reach target version key\n   * - Runs all necessary migrations sequentially\n   * - Returns new storage with updated state and version\n   *\n   * The middle layer doesn't need to know about dataVersion or storage internals.\n   * All migration logic is encapsulated in the model.\n   *\n   * @param blockConfig The NEW block configuration (provides the model code with migrations)\n   * @param currentStorageJson Current storage as JSON string (or undefined)\n   * @returns MigrationResult with new storage or skip/error info\n   */\n  public migrateStorageInVM(\n    blockConfig: BlockConfig,\n    currentStorageJson: string | undefined,\n  ): MigrationResult {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      return { error: \"migrateStorageInVM is only supported for model API version 2\" };\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageMigrate],\n        extractCodeWithInfo(blockConfig),\n        currentStorageJson,\n      ) as MigrationResult;\n      return result;\n    } catch (e) {\n      this.logger.error(\n        new Error(\"[ProjectHelper.migrateStorageInVM] Migration failed\", { cause: e }),\n      );\n      return { error: `VM execution failed: ${e}` };\n    }\n  }\n}\n"],"mappings":";;;;;;AAwDA,IAAa,gBAAb,MAA2B;CAaN;CACD;CAblB,yBAA0C,IAAIA,UAAAA,SAI5C;EACA,KAAK;EACL,aAAa,MAAM,QAAQ,EAAE,cAAc;GACzC,OAAO,EAAE,OAAO,KAAK,2BAA2B,OAAO,EAAE;EAC3D;CACF,CAAC;CAED,YACE,SACA,SAAmC,IAAIC,2BAAAA,qBAAqB,GAC5D;EAFiB,KAAA,UAAA;EACD,KAAA,SAAA;CACf;;;;;;;;;;;;CAiBH,sBACE,aACA,aACwB;EACxB,IAAI,YAAY,oBAAoBC,qBAAAA,8BAClC,OAAO,EACL,uBAAO,IAAI,MAAM,iEAAiE,EACpF;EAGF,IAAI;GACF,MAAM,SAASC,gBAAAA,oBACb,KAAK,SACL,YAAY,wBAAwBC,qBAAAA,4BAA4B,cAAA,GAAA,qBAAA,oBAAA,CAC5C,WAAW,GAC/B,WACF;GAEA,IAAI,OAAO,UAAU,KAAA,GACnB,OAAO,EAAE,OAAO,IAAI,MAAM,OAAO,KAAK,EAAE;GAE1C,OAAO,EAAE,OAAO,OAAO,MAAM;EAC/B,SAAS,GAAG;GACV,OAAO,EAAE,OAAO,IAAI,MAAM,uCAAuC,EAAE,QAAA,GAAA,qBAAA,YAAA,CAAmB,CAAC,EAAE,CAAC,EAAE;EAC9F;CACF;;;;;;;;;CAUA,4BAAmC,aAA0B,aAA8B;EACzF,IAAI,YAAY,oBAAoBF,qBAAAA,8BAClC,MAAM,IAAI,MAAM,uEAAuE;EAGzF,IAAI;GACF,MAAM,SAASC,gBAAAA,oBACb,KAAK,SACL,YAAY,wBAAwBC,qBAAAA,4BAA4B,oBAAA,GAAA,qBAAA,oBAAA,CAC5C,WAAW,GAC/B,WACF;GAEA,IAAI,OAAO,UAAU,KAAA,GAEnB;GAEF,OAAO,OAAO;EAChB,QAAQ;GAEN;EACF;CACF;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BA,gCACE,aACA,aACwB;EACxB,IAAI,YAAY,oBAAoBF,qBAAAA,8BAClC,OAAO,EACL,uBAAO,IAAI,MACT,2EACF,EACF;EAGF,MAAM,WACJ,YAAY,wBAAwBE,qBAAAA,4BAA4B;EAUlE,IAAI,aAAa,KAAA,GACf,OAAO,EACL,uBAAO,IAAI,MACT,kHAEF,EACF;EAGF,IAAI;GACF,MAAM,SAASD,gBAAAA,oBACb,KAAK,SACL,WAAA,GAAA,qBAAA,oBAAA,CACoB,WAAW,GAC/B,WACF;GAEA,IAAI,OAAO,UAAU,KAAA,GACnB,OAAO,EAAE,OAAO,IAAI,MAAM,OAAO,KAAK,EAAE;GAE1C,OAAO,EAAE,OAAO,OAAO,MAAM;EAC/B,SAAS,GAAG;GACV,MAAM,SAAA,GAAA,qBAAA,YAAA,CAAoB,CAAC;GAI3B,OAAO,EACL,OAAO,IAAI,MAAM,mDAAmD,MAAM,WAAW,EACnF,MACF,CAAC,EACH;EACF;CACF;CAEA,2BAAmC,KAAoD;EACrF,MAAM,cAAc,IAAI,YAAY;EACpC,IAAI,YAAY,sBAAsB,KAAA,GAAW,OAAO,KAAA;EACxD,MAAM,OAAO,IAAI,KAAK;EAOtB,OANeA,gBAAAA,oBACb,KAAK,SACL,YAAY,oBAAA,GAAA,qBAAA,oBAAA,CACQ,WAAW,GAC/B,IAEU;CACd;CAEA,qBACE,aACA,MACA,KACqB;EACrB,MAAM,MAAM;GAAE;GAAa;EAAK;EAChC,IAAI,QAAQ,KAAA,GAAW,OAAO,KAAK,2BAA2B,GAAG;EACjE,MAAM,WAAW,GAAG,IAAI,QAAQ,GAAG,IAAI;EACvC,OAAO,KAAK,uBAAuB,KAAK,UAAU,EAAE,SAAS,IAAI,CAAC,CAAC,CAAC;CACtE;;;;;;;;;;;CAgBA,sBAA6B,aAAkC;EAC7D,IAAI,YAAY,oBAAoBD,qBAAAA,8BAClC,MAAM,IAAI,MAAM,iEAAiE;EAGnF,IAAI;GAMF,OALeC,gBAAAA,oBACb,KAAK,SACL,YAAY,wBAAwBC,qBAAAA,4BAA4B,kBAAA,GAAA,qBAAA,oBAAA,CAC5C,WAAW,CAErB;EACd,SAAS,GAAG;GACV,KAAK,OAAO,MACV,IAAI,MAAM,yEAAyE,EACjF,OAAO,EACT,CAAC,CACH;GACA,MAAM,IAAI,MAAM,0CAA0C,GAAG;EAC/D;CACF;;;;;;;;;;;;;;;;;;;;;;CAuBA,2BACE,aACA,QAC0B;EAC1B,IAAI,YAAY,oBAAoBF,qBAAAA,8BAClC,OAAO,EACL,uBAAO,IAAI,MAAM,sEAAsE,EACzF;EAGF,MAAM,WACJ,YAAY,wBAAwBE,qBAAAA,4BAA4B;EAClE,IAAI,aAAa,KAAA,GAAW,OAAO,EAAE,OAAO,KAAA,EAAU;EAEtD,IAAI;GACF,MAAM,SAASD,gBAAAA,oBACb,KAAK,SACL,WAAA,GAAA,qBAAA,oBAAA,CACoB,WAAW,GAC/B,KAAK,UAAU,UAAU,CAAC,CAAC,CAC7B;GAEA,IAAI,OAAO,UAAU,KAAA,GAAW,OAAO,EAAE,OAAO,IAAI,MAAM,OAAO,KAAK,EAAE;GACxE,OAAO,EAAE,OAAO,KAAA,EAAU;EAC5B,SAAS,GAAG;GACV,MAAM,SAAA,GAAA,qBAAA,YAAA,CAAoB,CAAC;GAC3B,OAAO,EAAE,OAAO,IAAI,MAAM,+BAA+B,MAAM,WAAW,EAAE,MAAM,CAAC,EAAE;EACvF;CACF;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BA,gCACE,aACA,QACA,UACuB;EACvB,IAAI,YAAY,oBAAoBD,qBAAAA,8BAClC,OAAO,EACL,uBAAO,IAAI,MACT,2EACF,EACF;EAGF,MAAM,WACJ,YAAY,wBAAwBE,qBAAAA,4BAA4B;EAclE,IAAI,aAAa,KAAA,GACf,OAAO,EACL,uBAAO,IAAI,MACT,uMAGF,EACF;EAGF,IAAI;GACF,MAAM,SAASD,gBAAAA,oBACb,KAAK,SACL,WAAA,GAAA,qBAAA,oBAAA,CACoB,WAAW,GAI/B,KAAK,UAAU,UAAU,CAAC,CAAC,GAC3B,KAAK,UAAU,OAAO,YAAY,QAAQ,CAAC,CAC7C;GAEA,IAAI,OAAO,UAAU,KAAA,GAAW,OAAO,EAAE,OAAO,IAAI,MAAM,OAAO,KAAK,EAAE;GACxE,OAAO,EAAE,OAAO,OAAO,YAAY;EACrC,SAAS,GAAG;GACV,MAAM,SAAA,GAAA,qBAAA,YAAA,CAAoB,CAAC;GAI3B,OAAO,EACL,OAAO,IAAI,MAAM,gDAAgD,MAAM,WAAW,EAChF,MACF,CAAC,EACH;EACF;CACF;;;;;;;;;;;;;;CAeA,uBACE,aACA,oBACA,SACQ;EACR,IAAI,YAAY,oBAAoBD,qBAAAA,8BAClC,MAAM,IAAI,MAAM,kEAAkE;EAGpF,IAAIG,cAAAA,cAAc,CAAC,CAAC,eAClB,KAAK,OAAO,KACV,6DAA6D,mBAAmB,OAAO,aAAa,KAAK,UAAU,OAAO,CAAC,CAAC,OAAO,eAAe,QAAQ,WAC5J;EAEF,IAAI;GAQF,OAPeF,gBAAAA,oBACb,KAAK,SACL,YAAY,wBAAwBC,qBAAAA,4BAA4B,sBAAA,GAAA,qBAAA,oBAAA,CAC5C,WAAW,GAC/B,oBACA,OAEU;EACd,SAAS,GAAG;GACV,MAAM,cAAc,KAAK,UAAU,OAAO;GAC1C,KAAK,OAAO,MACV,IAAI,MACF,oFAAoF,mBAAmB,OAAO,aAAa,YAAY,OAAO,eAAe,QAAQ,UAAU,IAC/K,EAAE,OAAO,EAAE,CACb,CACF;GACA,MAAM,IAAI,MAAM,gCAAgC,GAAG;EACrD;CACF;;;;;;;;;CAUA,wBACE,aACA,gBAC+C;EAC/C,IAAI,YAAY,oBAAoBF,qBAAAA,8BAClC,MAAM,IAAI,MAAM,mEAAmE;EAGrF,IAAI;GAOF,OANeC,gBAAAA,oBACb,KAAK,SACL,YAAY,wBAAwBC,qBAAAA,4BAA4B,oBAAA,GAAA,qBAAA,oBAAA,CAC5C,WAAW,GAC/B,cAEU;EACd,SAAS,GAAG;GACV,KAAK,OAAO,MACV,IAAI,MAAM,yEAAyE,EACjF,OAAO,EACT,CAAC,CACH;GACA;EACF;CACF;;;;;;;;;;;;;;;;CAqBA,mBACE,aACA,oBACiB;EACjB,IAAI,YAAY,oBAAoBF,qBAAAA,8BAClC,OAAO,EAAE,OAAO,+DAA+D;EAGjF,IAAI;GAOF,OANeC,gBAAAA,oBACb,KAAK,SACL,YAAY,wBAAwBC,qBAAAA,4BAA4B,kBAAA,GAAA,qBAAA,oBAAA,CAC5C,WAAW,GAC/B,kBAEU;EACd,SAAS,GAAG;GACV,KAAK,OAAO,MACV,IAAI,MAAM,uDAAuD,EAAE,OAAO,EAAE,CAAC,CAC/E;GACA,OAAO,EAAE,OAAO,wBAAwB,IAAI;EAC9C;CACF;AACF"}

package/dist/model/project_helper.d.ts

@@ -1,9 +1,9 @@
 import { BlockConfig, BlockStorage, PlRef, ResultOrError } from "@platforma-sdk/model";
 import { StorageDebugView } from "@milaboratories/pl-model-middle-layer";
 import { MiLogger } from "@milaboratories/ts-helpers";
+import { StringifiedJson } from "@milaboratories/pl-model-common";
 import { SignedResourceId } from "@milaboratories/pl-client";
 import { QuickJSWASMModule } from "quickjs-emscripten";
-import { StringifiedJson } from "@milaboratories/pl-model-common";
 
 //#region src/model/project_helper.d.ts
 /**
@@ -46,6 +46,32 @@ declare class ProjectHelper {
    * @returns The derived prerunArgs, or undefined if derivation fails
    */
   derivePrerunArgsFromStorage(blockConfig: BlockConfig, storageJson: string): unknown;
+  /**
+   * Derives this block's template-export params from storage JSON using the VM
+   * callback (`__pl_initializationParams_derive`).
+   *
+   * The template-export counterpart of {@link deriveArgsFromStorage}: instead of
+   * the args a workflow runs on, it returns the params that would recreate the
+   * block — the inverse of the data model's `init`. Params come back exactly as the block
+   * projected them, references included: nothing marks or rewrites them on the way out, so
+   * nothing here has to know a kind's params shape or how a reference is spelled.
+   *
+   * A `{ value: undefined }` result means the block declares no `templateParams`, which only
+   * a block built against an older SDK can do. It does not reach a document: the export walk
+   * requires a mapping and reports anything else as that block's problem, so an entry always
+   * carries params.
+   *
+   * Unlike {@link derivePrerunArgsFromStorage}, a failure here is surfaced rather
+   * than swallowed — a prerun that cannot derive args just skips a block in
+   * staging, whereas an export that silently drops a block produces a template
+   * that does not describe the project.
+   *
+   * @param blockConfig The block configuration (provides the model code)
+   * @param storageJson Storage as JSON string
+   * @returns The derived params with identifiers wrapped, `undefined` if the block declares
+   *   no lambda, or an error if derivation failed
+   */
+  deriveTemplateParamsFromStorage(blockConfig: BlockConfig, storageJson: string): ResultOrError<unknown>;
   private calculateEnrichmentTargets;
   getEnrichmentTargets(blockConfig: () => BlockConfig, args: () => unknown, key?: {
     argsRid: SignedResourceId;
@@ -62,6 +88,55 @@ declare class ProjectHelper {
    * @throws Error if storage creation fails
    */
   getInitialStorageInVM(blockConfig: BlockConfig): string;
+  /**
+   * Checks a template entry's params against the block's kind, creating nothing.
+   *
+   * The pre-flight half of {@link getInitialStorageFromParamsInVM}: run once per entry
+   * before a template is applied, so params a kind rejects are reported against the
+   * entry that carries them while there is still no project. Skipping it is safe —
+   * initialization runs the same check — but then the report arrives after earlier
+   * entries have already been created.
+   *
+   * Every kind declares a parser, so a pass here means the params were checked against
+   * the contract — not merely that they were JSON.
+   *
+   * A block whose model predates the callback passes unchecked rather than failing.
+   * Unlike initialization, this method creates nothing, so there is nothing to get wrong
+   * by proceeding, and such a block is refused outright at the point it is applied.
+   *
+   * @param blockConfig The block configuration (provides the model code)
+   * @param params The entry's params. Reference ids may be placeholders: what is being
+   *   checked is the shape of the params, not what they point at
+   * @returns Nothing, or why the params were rejected
+   */
+  validateTemplateParamsInVM(blockConfig: BlockConfig, params: unknown): ResultOrError<undefined>;
+  /**
+   * Creates initial BlockStorage for a block being created from template params.
+   *
+   * The inverse of {@link deriveTemplateParamsFromStorage}, and the reason a block
+   * can be created by anything other than the UI: it hands the params to the
+   * block's own init factory inside the model VM, so the resulting storage is
+   * whatever that block considers a correctly-initialized state.
+   *
+   * **Pointing the entry's references at this project happens in the same call**, before the
+   * factory sees them — inside the block's bundle, because recognizing a reference means
+   * knowing the reference system and a template engine deliberately does not. Params reach
+   * here exactly as the file held them.
+   *
+   * One call and not two: every VM call builds a fresh runtime and re-evaluates the whole
+   * model bundle, so asking the block to relocate and then asking it to initialize would parse
+   * it twice per entry, for an intermediate value nothing else reads.
+   *
+   * `blockIds` holds the entries created so far, so an id it does not name is left as it is —
+   * a reference to an entry further down the file keeps pointing at nothing, and the applied
+   * block reports itself as missing references rather than being wired to a block below it.
+   *
+   * @param blockConfig The block configuration (provides the model code)
+   * @param params The entry's params, as the document held them
+   * @param blockIds template-local entry id → the block id that entry was given
+   * @returns The initial storage as JSON string, or why the params yield none
+   */
+  getInitialStorageFromParamsInVM(blockConfig: BlockConfig, params: unknown, blockIds: ReadonlyMap<string, string>): ResultOrError<string>;
   /**
    * Applies a state update using VM-based transformation.
    * This calls the model's `__pl_storage_applyUpdate` callback which:

package/dist/model/project_helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project_helper.d.ts","names":[],"sources":["../../src/model/project_helper.ts"],"mappings":";;;;;;;;;;AAgCA;;;;;KAAY,eAAA;EACN,KAAA;AAAA;EACA,KAAA;EAAmB,cAAA,EAAgB,eAAe,CAAC,YAAA;EAAe,IAAA;AAAA;AAAA,cAQ3D,aAAA;EAAA,iBAaQ,OAAA;EAAA,SACD,MAAA,EAAQ,QAAA;EAAA,iBAbT,sBAAA;cAYE,OAAA,EAAS,iBAAA,EACV,MAAA,GAAQ,QAAA;EAAA;;;;;;;;;;;EAkBnB,qBAAA,CACL,WAAA,EAAa,WAAA,EACb,WAAA,WACC,aAAA;EA+KA;;;;;;;;EA/II,2BAAA,CAA4B,WAAA,EAAa,WAAA,EAAa,WAAA;EAAA,QAwBrD,0BAAA;EAaD,oBAAA,CACL,WAAA,QAAmB,WAAA,EACnB,IAAA,iBACA,GAAA;IAAQ,OAAA,EAAS,gBAAA;IAAkB,YAAA,EAAc,gBAAA;EAAA,IAChD,KAAA;EA5EI;;;;;;;;;;EAiGA,qBAAA,CAAsB,WAAA,EAAa,WAAA;EAxBrB;;;;;;;;;;;;;EA2Dd,sBAAA,CACL,WAAA,EAAa,WAAA,EACb,kBAAA,UACA,OAAA;IAAW,SAAA;IAAmB,KAAA;EAAA;EAAA;;;;;;;;EAwCzB,uBAAA,CACL,WAAA,EAAa,WAAA,EACb,cAAA,uBACC,eAAA,CAAgB,gBAAA;EA2CJ;;;;;AAEG;;;;;;;;;;EAHX,kBAAA,CACL,WAAA,EAAa,WAAA,EACb,kBAAA,uBACC,eAAA;AAAA"}
+{"version":3,"file":"project_helper.d.ts","names":[],"sources":["../../src/model/project_helper.ts"],"mappings":";;;;;;;;;;AAgCA;;;;;KAAY,eAAA;EACN,KAAA;AAAA;EACA,KAAA;EAAmB,cAAA,EAAgB,eAAe,CAAC,YAAA;EAAe,IAAA;AAAA;AAAA,cAsB3D,aAAA;EAAA,iBAaQ,OAAA;EAAA,SACD,MAAA,EAAQ,QAAA;EAAA,iBAbT,sBAAA;cAYE,OAAA,EAAS,iBAAA,EACV,MAAA,GAAQ,QAAA;EAAA;;;;;;;;;;;EAkBnB,qBAAA,CACL,WAAA,EAAa,WAAA,EACb,WAAA,WACC,aAAA;EA8NA;;;;;;;;EA9LI,2BAAA,CAA4B,WAAA,EAAa,WAAA,EAAa,WAAA;EA4Z1D;;;;;;;;;;;;;;;;;;;;;;;;;EA3WI,+BAAA,CACL,WAAA,EAAa,WAAA,EACb,WAAA,WACC,aAAA;EAAA,QAsDK,0BAAA;EAaD,oBAAA,CACL,WAAA,QAAmB,WAAA,EACnB,IAAA,iBACA,GAAA;IAAQ,OAAA,EAAS,gBAAA;IAAkB,YAAA,EAAc,gBAAA;EAAA,IAChD,KAAA;EADO;;;;;;;;;;EAsBH,qBAAA,CAAsB,WAAA,EAAa,WAAA;EA4CxC;;;;;;;;;;;;;;;;;;;;;EADK,0BAAA,CACL,WAAA,EAAa,WAAA,EACb,MAAA,YACC,aAAA;EAiLgB;;;;;;;AA6CD;;;;;;;;;;;;;;;;;;;EAzKX,+BAAA,CACL,WAAA,EAAa,WAAA,EACb,MAAA,WACA,QAAA,EAAU,WAAA,mBACT,aAAA;;;;;;;;;;;;;;EA0EI,sBAAA,CACL,WAAA,EAAa,WAAA,EACb,kBAAA,UACA,OAAA;IAAW,SAAA;IAAmB,KAAA;EAAA;;;;;;;;;EAwCzB,uBAAA,CACL,WAAA,EAAa,WAAA,EACb,cAAA,uBACC,eAAA,CAAgB,gBAAA;;;;;;;;;;;;;;;;EA0CZ,kBAAA,CACL,WAAA,EAAa,WAAA,EACb,kBAAA,uBACC,eAAA;AAAA"}