@milaboratories/pl-middle-layer 1.74.11 → 1.74.12

package/dist/model/template_parser.d.ts

@@ -1,5 +1,4 @@
 import { ProjectTemplateV1 } from "@milaboratories/pl-model-common";
-//#region src/model/template_parser.d.ts
 /**
  * A template file read, or why it could not be.
  *
@@ -37,5 +36,4 @@ export type TemplateParseOutcome = {
  * those are later stages, and both need more than the file to answer.
  */
 export declare function parseProjectTemplateV1Yaml(text: string): TemplateParseOutcome;
-//#endregion
 //# sourceMappingURL=template_parser.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"template_parser.d.ts","names":[],"sources":["../../src/model/template_parser.ts"],"mappings":";;;;;;;;;;;YAiBY;WACG;WAAmB,UAAU;;WAC7B;WAAoB;;;;;;;;;;;;;;;;;;;;;;wBAsBnB,2BAA2B,eAAe"}
+{"version":3,"file":"template_parser.d.ts","names":[],"sources":["../../src/model/template_parser.ts"],"mappings":";;;;;;;;;;YAiBY;WACG;WAAmB,UAAU;;WAC7B;WAAoB;;;;;;;;;;;;;;;;;;;;;;wBAsBnB,2BAA2B,eAAe"}

package/dist/model/template_parser.js

@@ -1,6 +1,6 @@
 import YAML from "yaml";
 import { PROJECT_TEMPLATE_SCHEMA_V1, formatTemplateParseIssue, readProjectTemplateV1 } from "@milaboratories/pl-model-common";
-//#region src/model/template_parser.ts
+// src/model/template_parser.ts
 /**
 * Read `template-v1` YAML text into a document.
 *
@@ -66,7 +66,6 @@ function describeIssues(issues) {
 	const lines = issues.map((issue) => `- ${formatTemplateParseIssue(issue)}`);
 	return [lines.length === 1 ? "The template file has a problem:" : `The template file has ${lines.length} problems:`, ...lines].join("\n");
 }
-//#endregion
 export { parseProjectTemplateV1Yaml };
 
 //# sourceMappingURL=template_parser.js.map

package/dist/model/template_resolve.cjs

@@ -1,5 +1,5 @@
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
-//#region src/model/template_resolve.ts
+// src/model/template_resolve.ts
 /**
 * Resolve every entry in a template document to a concrete block pack.
 *
@@ -127,7 +127,6 @@ function parseBlockPackName(npmName) {
 function messageOf(e) {
 	return e instanceof Error ? e.message : String(e);
 }
-//#endregion
 exports.parseBlockPackName = parseBlockPackName;
 exports.resolveTemplateEntries = resolveTemplateEntries;
 

package/dist/model/template_resolve.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"template_resolve.cjs","names":[],"sources":["../../src/model/template_resolve.ts"],"sourcesContent":["import type {\n  BlockKindSelectorReference,\n  BlockPackLocationReference,\n  ProjectTemplateV1,\n  ProjectTemplateV1Entry,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  parseBlockPackReference,\n  parseKindSelectorReference,\n} from \"@milaboratories/pl-model-common\";\nimport type { BlockPackId, BlockPackSpec } from \"@milaboratories/pl-model-middle-layer\";\nimport type { TemplateApplyProblem } from \"./template_apply\";\n\n/**\n * Where a template entry's block comes from.\n *\n * All three of an entry's paths to an implementation go through this one interface, and\n * all three come back as the same `BlockPackSpec` — the shape the existing add-block\n * path already consumes — plus the block's published title. That convergence is the\n * point: everything downstream of resolution treats a kind-resolved entry, a\n * version-pinned one and a filesystem-located one identically, which is why a locally\n * built block travels the same preparation and construction path as a published one.\n *\n * Registry knowledge sits deliberately on the far side of this interface. A template\n * file names no registry, so choosing which one (or ones) to consult is a property\n * of the environment applying the file, not of the file — and keeping it out here is\n * what lets resolution be tested with no registry at all.\n *\n * The title is required rather than optional for the same reason: an implementation\n * always has one to hand — a registry adapter reads it off the block's manifest, and\n * anything else names the blocks it serves — while a caller downstream has no source\n * for it at all, and the fallbacks it could invent are all wrong. See\n * {@link ResolvedEntry}'s `title`.\n */\nexport type BlockPackProvider = {\n  /**\n   * Find the block implementing a kind selector.\n   *\n   * @param kind The entry's `{name}@{selector}` reference\n   * @param options `allowUnstable` widens the search from stable implementations to\n   *   every published one, for the whole apply\n   */\n  byKind: (\n    kind: BlockKindSelectorReference,\n    options: { allowUnstable: boolean },\n  ) => Promise<KindResolution>;\n\n  /**\n   * Find one exact block package version, named directly.\n   *\n   * This is the `block` override's path, and it bypasses kinds entirely — the\n   * override exists precisely to pin an implementation that resolution would not\n   * have chosen.\n   */\n  byExactVersion: (id: BlockPackId) => Promise<ExactResolution>;\n\n  /**\n   * Read the implementation sitting at one location.\n   *\n   * The `location` override's path, for a block that no registry knows because it was\n   * built and never published. Nothing is searched: the entry says where, so either\n   * that place holds a block or the entry is wrong.\n   *\n   * Answers \"is there a block here\", not \"is it the right one\". Whether the block found\n   * implements the kind the entry asks for is settled once it has been prepared, from the\n   * compiled model — the one place all three routes have it. This reader could answer it\n   * too, since it reads the block's description anyway, and answering it here as well would\n   * make two homes for one invariant while leaving the pinned-version route uncovered.\n   */\n  byLocation: (location: BlockPackLocationReference) => Promise<LocationResolution>;\n};\n\n/**\n * The outcome of resolving one kind selector.\n *\n * The three failure reasons are distinct because each has a different way out, and\n * a caller that collapsed them would leave the reader guessing which:\n *\n * - `no-matching-kind-version` — the selector matches no published version of the\n *   kind at all. The file, or the registry, is wrong.\n * - `no-implementation` — the kind version exists, but nothing implements it. The\n *   kind was published ahead of any block.\n * - `no-stable-implementation` — implementations exist but none is stable, and the\n *   apply did not allow unstable ones. This is the only reason the user can act on\n *   without editing anything.\n */\nexport type KindResolution =\n  | { readonly ok: true; readonly spec: BlockPackSpec; readonly title: string }\n  | {\n      readonly ok: false;\n      readonly reason:\n        | \"no-matching-kind-version\"\n        | \"no-implementation\"\n        | \"no-stable-implementation\";\n    };\n\n/** The outcome of locating one exact block version. */\nexport type ExactResolution =\n  | { readonly ok: true; readonly spec: BlockPackSpec; readonly title: string }\n  | { readonly ok: false; readonly reason: \"no-such-block-version\" };\n\n/**\n * The outcome of reading the implementation at one location.\n *\n * The three failure reasons separate three different mistakes, and each is fixed\n * differently:\n *\n * - `unsupported-scheme` — the URI is well-formed but names a way of fetching that\n *   this environment has no reader for. A property of the environment, not the file.\n * - `not-found` — nothing is at that location. Usually a template carried to another\n *   machine, or a folder that moved.\n * - `not-a-block` — something is there, but it is not a block. Usually a path pointing\n *   one directory off, which is why the message has to say what was looked for.\n */\nexport type LocationResolution =\n  | {\n      readonly ok: true;\n      readonly spec: BlockPackSpec;\n      readonly title: string;\n    }\n  | {\n      readonly ok: false;\n      readonly reason: \"unsupported-scheme\" | \"not-found\" | \"not-a-block\";\n    };\n\n/** Where one entry's block will come from. */\nexport type ResolvedEntry = {\n  /** The entry's template-local id. */\n  readonly entryId: string;\n  readonly spec: BlockPackSpec;\n  /**\n   * The block package's own title, as its author published it — `meta.title` for a\n   * registry block.\n   *\n   * Carried here because resolution is the only stage that talks to a registry, and a\n   * registry is the only thing that knows it. Nothing downstream can recover it: a\n   * prepared block pack holds the model, the workflow and the frontend, none of which\n   * names the block.\n   *\n   * It becomes the created block's label, which is what the user sees for any block\n   * whose model derives no title of its own — `graph-maker`, `table` and seven other\n   * shipped blocks. Deriving it from the entry instead is specifically wrong: an\n   * exported template names its entries by the source project's block ids, so a\n   * round-tripped project would show UUIDs in the sidebar.\n   */\n  readonly title: string;\n  /**\n   * True when the entry named its own implementation — an exact version or a location —\n   * rather than letting its kind choose one.\n   *\n   * Both overrides count, because what this records is that the choice was the file's\n   * and not the registry's, which is the same fact for either of them.\n   */\n  readonly pinned: boolean;\n};\n\n/**\n * What resolution found for a whole document.\n *\n * `resolved` is in file order and holds only the entries that resolved, so\n * `problems.length > 0` means it is incomplete. A caller must not apply a partial\n * resolution: the point of resolving before construction is that nothing is created\n * until every entry has an implementation.\n */\nexport type TemplateResolveOutcome = {\n  readonly resolved: readonly ResolvedEntry[];\n  readonly problems: readonly TemplateApplyProblem[];\n};\n\n/**\n * Resolve every entry in a template document to a concrete block pack.\n *\n * The first stage of an apply, and the only one that touches the network. It runs\n * before the project exists, which is what makes \"no block for this entry\" a message\n * about a file rather than a half-built project — and it is also why the whole\n * construction API downstream can be synchronous.\n *\n * Every entry is attempted, and every failure collected: an unapplicable file should\n * take one pass to fix, not one pass per bad entry. The one exception is that a\n * problem short-circuits nothing, so `resolved` may be shorter than the document.\n *\n * @param document A parsed template document\n * @param provider Where blocks come from\n * @param options `allowUnstable` applies to the whole document, not per entry\n */\nexport async function resolveTemplateEntries(\n  document: ProjectTemplateV1,\n  provider: BlockPackProvider,\n  options: { allowUnstable: boolean },\n): Promise<TemplateResolveOutcome> {\n  const resolved: ResolvedEntry[] = [];\n  const problems: TemplateApplyProblem[] = [];\n\n  // Sequential, not concurrent. Entries commonly share a kind, and a provider\n  // caching its reads can only dedupe them if the second request happens after the\n  // first has landed. A template holds a handful of entries, so there is nothing to\n  // win by overlapping the reads.\n  for (const entry of document.blocks) {\n    const outcome = await resolveEntry(entry, provider, options);\n    if (outcome.ok) resolved.push(outcome.entry);\n    else problems.push(outcome.problem);\n  }\n\n  return { resolved, problems };\n}\n\ntype EntryOutcome =\n  | { ok: true; entry: ResolvedEntry }\n  | { ok: false; problem: TemplateApplyProblem };\n\nasync function resolveEntry(\n  entry: ProjectTemplateV1Entry,\n  provider: BlockPackProvider,\n  options: { allowUnstable: boolean },\n): Promise<EntryOutcome> {\n  const problem = (error: string): EntryOutcome => ({\n    ok: false,\n    problem: { entryId: entry.id, error },\n  });\n\n  if (entry.location !== undefined) {\n    const outcome = await provider.byLocation(entry.location);\n\n    if (!outcome.ok) {\n      switch (outcome.reason) {\n        case \"unsupported-scheme\":\n          return problem(\n            `This entry says its block is at '${entry.location}', which this application ` +\n              `cannot read. Only a local path ('file:') is supported here.`,\n          );\n        case \"not-found\":\n          return problem(\n            `Nothing is at '${entry.location}', where this entry says its block is. A ` +\n              `template that pins a folder only works on the machine that folder is on.`,\n          );\n        case \"not-a-block\":\n          return problem(\n            `'${entry.location}' is not a block: it holds neither a built block package ` +\n              `nor a block's manifest. Point the entry at the folder holding the block's ` +\n              `package.json.`,\n          );\n      }\n    }\n\n    return {\n      ok: true,\n      entry: { entryId: entry.id, spec: outcome.spec, title: outcome.title, pinned: true },\n    };\n  }\n\n  if (entry.block !== undefined) {\n    let id: BlockPackId;\n    try {\n      const { name, version } = parseBlockPackReference(entry.block);\n      id = { ...parseBlockPackName(name), version };\n    } catch (e) {\n      // The document's parser already checked the `{name}@X.Y.Z` grammar, but not\n      // that the name carries an organization, so this is reachable from a\n      // hand-written file. Reported rather than thrown, so one malformed entry cannot\n      // hide the state of the rest.\n      return problem(`Pinned block version is not readable: ${messageOf(e)}`);\n    }\n\n    const outcome = await provider.byExactVersion(id);\n    if (outcome.ok)\n      return {\n        ok: true,\n        entry: { entryId: entry.id, spec: outcome.spec, title: outcome.title, pinned: true },\n      };\n\n    return problem(\n      `Block '${id.organization}/${id.name}' version ${id.version} was not found. Correct ` +\n        `the pinned version in this entry, or remove it so a version is chosen ` +\n        `automatically.`,\n    );\n  }\n\n  let kindName: string;\n  try {\n    kindName = parseKindSelectorReference(entry.kind).name;\n  } catch (e) {\n    return problem(`Block kind is not readable: ${messageOf(e)}`);\n  }\n\n  const outcome = await provider.byKind(entry.kind, options);\n  if (outcome.ok)\n    return {\n      ok: true,\n      entry: { entryId: entry.id, spec: outcome.spec, title: outcome.title, pinned: false },\n    };\n\n  switch (outcome.reason) {\n    case \"no-matching-kind-version\":\n      return problem(\n        `No published version of '${kindName}' matches what this entry asks for ` +\n          `(${entry.kind}). Check the version, or update the block registry.`,\n      );\n    case \"no-implementation\":\n      return problem(\n        `'${kindName}' has no block implementing the version this entry asks for ` +\n          `(${entry.kind}). Nothing can be installed for it yet.`,\n      );\n    case \"no-stable-implementation\":\n      // The one failure with a way out that changes nothing in the file, so the\n      // message names it.\n      return problem(\n        `The only blocks implementing '${kindName}' for this entry (${entry.kind}) are ` +\n          `pre-release versions. Import again with unstable versions allowed to use them.`,\n      );\n  }\n}\n\n/**\n * Split a block package's npm name into the organization and name a registry knows\n * it by: `@npm-scope/organization.name` → `{ organization, name }`.\n *\n * The npm scope and the organization are different things, and only the second one\n * reaches the registry — `@milaboratories/milaboratories.test-download-file` is\n * published as organization `milaboratories`, name `test-download-file`. The split is\n * on the FIRST dot, so a name may contain further dots.\n *\n * Kind names follow the same convention, which is why a template can carry both in\n * the same npm-ish form.\n *\n * @throws if the name has no npm scope or no organization segment\n */\nexport function parseBlockPackName(npmName: string): { organization: string; name: string } {\n  const slash = npmName.indexOf(\"/\");\n  if (!npmName.startsWith(\"@\") || slash < 0) {\n    throw new Error(`expected '@npm-scope/organization.name', got '${npmName}'`);\n  }\n\n  const base = npmName.slice(slash + 1);\n  const dot = base.indexOf(\".\");\n  if (dot <= 0 || dot === base.length - 1) {\n    throw new Error(\n      `'${base}' does not separate an organization from a name with '.' in '${npmName}'`,\n    );\n  }\n\n  return { organization: base.slice(0, dot), name: base.slice(dot + 1) };\n}\n\nfunction messageOf(e: unknown): string {\n  return e instanceof Error ? e.message : String(e);\n}\n"],"mappings":"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"}
+{"version":3,"file":"template_resolve.cjs","names":["parseBlockPackReference","parseKindSelectorReference"],"sources":["../../src/model/template_resolve.ts"],"sourcesContent":["import type {\n  BlockKindSelectorReference,\n  BlockPackLocationReference,\n  ProjectTemplateV1,\n  ProjectTemplateV1Entry,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  parseBlockPackReference,\n  parseKindSelectorReference,\n} from \"@milaboratories/pl-model-common\";\nimport type { BlockPackId, BlockPackSpec } from \"@milaboratories/pl-model-middle-layer\";\nimport type { TemplateApplyProblem } from \"./template_apply\";\n\n/**\n * Where a template entry's block comes from.\n *\n * All three of an entry's paths to an implementation go through this one interface, and\n * all three come back as the same `BlockPackSpec` — the shape the existing add-block\n * path already consumes — plus the block's published title. That convergence is the\n * point: everything downstream of resolution treats a kind-resolved entry, a\n * version-pinned one and a filesystem-located one identically, which is why a locally\n * built block travels the same preparation and construction path as a published one.\n *\n * Registry knowledge sits deliberately on the far side of this interface. A template\n * file names no registry, so choosing which one (or ones) to consult is a property\n * of the environment applying the file, not of the file — and keeping it out here is\n * what lets resolution be tested with no registry at all.\n *\n * The title is required rather than optional for the same reason: an implementation\n * always has one to hand — a registry adapter reads it off the block's manifest, and\n * anything else names the blocks it serves — while a caller downstream has no source\n * for it at all, and the fallbacks it could invent are all wrong. See\n * {@link ResolvedEntry}'s `title`.\n */\nexport type BlockPackProvider = {\n  /**\n   * Find the block implementing a kind selector.\n   *\n   * @param kind The entry's `{name}@{selector}` reference\n   * @param options `allowUnstable` widens the search from stable implementations to\n   *   every published one, for the whole apply\n   */\n  byKind: (\n    kind: BlockKindSelectorReference,\n    options: { allowUnstable: boolean },\n  ) => Promise<KindResolution>;\n\n  /**\n   * Find one exact block package version, named directly.\n   *\n   * This is the `block` override's path, and it bypasses kinds entirely — the\n   * override exists precisely to pin an implementation that resolution would not\n   * have chosen.\n   */\n  byExactVersion: (id: BlockPackId) => Promise<ExactResolution>;\n\n  /**\n   * Read the implementation sitting at one location.\n   *\n   * The `location` override's path, for a block that no registry knows because it was\n   * built and never published. Nothing is searched: the entry says where, so either\n   * that place holds a block or the entry is wrong.\n   *\n   * Answers \"is there a block here\", not \"is it the right one\". Whether the block found\n   * implements the kind the entry asks for is settled once it has been prepared, from the\n   * compiled model — the one place all three routes have it. This reader could answer it\n   * too, since it reads the block's description anyway, and answering it here as well would\n   * make two homes for one invariant while leaving the pinned-version route uncovered.\n   */\n  byLocation: (location: BlockPackLocationReference) => Promise<LocationResolution>;\n};\n\n/**\n * The outcome of resolving one kind selector.\n *\n * The three failure reasons are distinct because each has a different way out, and\n * a caller that collapsed them would leave the reader guessing which:\n *\n * - `no-matching-kind-version` — the selector matches no published version of the\n *   kind at all. The file, or the registry, is wrong.\n * - `no-implementation` — the kind version exists, but nothing implements it. The\n *   kind was published ahead of any block.\n * - `no-stable-implementation` — implementations exist but none is stable, and the\n *   apply did not allow unstable ones. This is the only reason the user can act on\n *   without editing anything.\n */\nexport type KindResolution =\n  | { readonly ok: true; readonly spec: BlockPackSpec; readonly title: string }\n  | {\n      readonly ok: false;\n      readonly reason:\n        | \"no-matching-kind-version\"\n        | \"no-implementation\"\n        | \"no-stable-implementation\";\n    };\n\n/** The outcome of locating one exact block version. */\nexport type ExactResolution =\n  | { readonly ok: true; readonly spec: BlockPackSpec; readonly title: string }\n  | { readonly ok: false; readonly reason: \"no-such-block-version\" };\n\n/**\n * The outcome of reading the implementation at one location.\n *\n * The three failure reasons separate three different mistakes, and each is fixed\n * differently:\n *\n * - `unsupported-scheme` — the URI is well-formed but names a way of fetching that\n *   this environment has no reader for. A property of the environment, not the file.\n * - `not-found` — nothing is at that location. Usually a template carried to another\n *   machine, or a folder that moved.\n * - `not-a-block` — something is there, but it is not a block. Usually a path pointing\n *   one directory off, which is why the message has to say what was looked for.\n */\nexport type LocationResolution =\n  | {\n      readonly ok: true;\n      readonly spec: BlockPackSpec;\n      readonly title: string;\n    }\n  | {\n      readonly ok: false;\n      readonly reason: \"unsupported-scheme\" | \"not-found\" | \"not-a-block\";\n    };\n\n/** Where one entry's block will come from. */\nexport type ResolvedEntry = {\n  /** The entry's template-local id. */\n  readonly entryId: string;\n  readonly spec: BlockPackSpec;\n  /**\n   * The block package's own title, as its author published it — `meta.title` for a\n   * registry block.\n   *\n   * Carried here because resolution is the only stage that talks to a registry, and a\n   * registry is the only thing that knows it. Nothing downstream can recover it: a\n   * prepared block pack holds the model, the workflow and the frontend, none of which\n   * names the block.\n   *\n   * It becomes the created block's label, which is what the user sees for any block\n   * whose model derives no title of its own — `graph-maker`, `table` and seven other\n   * shipped blocks. Deriving it from the entry instead is specifically wrong: an\n   * exported template names its entries by the source project's block ids, so a\n   * round-tripped project would show UUIDs in the sidebar.\n   */\n  readonly title: string;\n  /**\n   * True when the entry named its own implementation — an exact version or a location —\n   * rather than letting its kind choose one.\n   *\n   * Both overrides count, because what this records is that the choice was the file's\n   * and not the registry's, which is the same fact for either of them.\n   */\n  readonly pinned: boolean;\n};\n\n/**\n * What resolution found for a whole document.\n *\n * `resolved` is in file order and holds only the entries that resolved, so\n * `problems.length > 0` means it is incomplete. A caller must not apply a partial\n * resolution: the point of resolving before construction is that nothing is created\n * until every entry has an implementation.\n */\nexport type TemplateResolveOutcome = {\n  readonly resolved: readonly ResolvedEntry[];\n  readonly problems: readonly TemplateApplyProblem[];\n};\n\n/**\n * Resolve every entry in a template document to a concrete block pack.\n *\n * The first stage of an apply, and the only one that touches the network. It runs\n * before the project exists, which is what makes \"no block for this entry\" a message\n * about a file rather than a half-built project — and it is also why the whole\n * construction API downstream can be synchronous.\n *\n * Every entry is attempted, and every failure collected: an unapplicable file should\n * take one pass to fix, not one pass per bad entry. The one exception is that a\n * problem short-circuits nothing, so `resolved` may be shorter than the document.\n *\n * @param document A parsed template document\n * @param provider Where blocks come from\n * @param options `allowUnstable` applies to the whole document, not per entry\n */\nexport async function resolveTemplateEntries(\n  document: ProjectTemplateV1,\n  provider: BlockPackProvider,\n  options: { allowUnstable: boolean },\n): Promise<TemplateResolveOutcome> {\n  const resolved: ResolvedEntry[] = [];\n  const problems: TemplateApplyProblem[] = [];\n\n  // Sequential, not concurrent. Entries commonly share a kind, and a provider\n  // caching its reads can only dedupe them if the second request happens after the\n  // first has landed. A template holds a handful of entries, so there is nothing to\n  // win by overlapping the reads.\n  for (const entry of document.blocks) {\n    const outcome = await resolveEntry(entry, provider, options);\n    if (outcome.ok) resolved.push(outcome.entry);\n    else problems.push(outcome.problem);\n  }\n\n  return { resolved, problems };\n}\n\ntype EntryOutcome =\n  | { ok: true; entry: ResolvedEntry }\n  | { ok: false; problem: TemplateApplyProblem };\n\nasync function resolveEntry(\n  entry: ProjectTemplateV1Entry,\n  provider: BlockPackProvider,\n  options: { allowUnstable: boolean },\n): Promise<EntryOutcome> {\n  const problem = (error: string): EntryOutcome => ({\n    ok: false,\n    problem: { entryId: entry.id, error },\n  });\n\n  if (entry.location !== undefined) {\n    const outcome = await provider.byLocation(entry.location);\n\n    if (!outcome.ok) {\n      switch (outcome.reason) {\n        case \"unsupported-scheme\":\n          return problem(\n            `This entry says its block is at '${entry.location}', which this application ` +\n              `cannot read. Only a local path ('file:') is supported here.`,\n          );\n        case \"not-found\":\n          return problem(\n            `Nothing is at '${entry.location}', where this entry says its block is. A ` +\n              `template that pins a folder only works on the machine that folder is on.`,\n          );\n        case \"not-a-block\":\n          return problem(\n            `'${entry.location}' is not a block: it holds neither a built block package ` +\n              `nor a block's manifest. Point the entry at the folder holding the block's ` +\n              `package.json.`,\n          );\n      }\n    }\n\n    return {\n      ok: true,\n      entry: { entryId: entry.id, spec: outcome.spec, title: outcome.title, pinned: true },\n    };\n  }\n\n  if (entry.block !== undefined) {\n    let id: BlockPackId;\n    try {\n      const { name, version } = parseBlockPackReference(entry.block);\n      id = { ...parseBlockPackName(name), version };\n    } catch (e) {\n      // The document's parser already checked the `{name}@X.Y.Z` grammar, but not\n      // that the name carries an organization, so this is reachable from a\n      // hand-written file. Reported rather than thrown, so one malformed entry cannot\n      // hide the state of the rest.\n      return problem(`Pinned block version is not readable: ${messageOf(e)}`);\n    }\n\n    const outcome = await provider.byExactVersion(id);\n    if (outcome.ok)\n      return {\n        ok: true,\n        entry: { entryId: entry.id, spec: outcome.spec, title: outcome.title, pinned: true },\n      };\n\n    return problem(\n      `Block '${id.organization}/${id.name}' version ${id.version} was not found. Correct ` +\n        `the pinned version in this entry, or remove it so a version is chosen ` +\n        `automatically.`,\n    );\n  }\n\n  let kindName: string;\n  try {\n    kindName = parseKindSelectorReference(entry.kind).name;\n  } catch (e) {\n    return problem(`Block kind is not readable: ${messageOf(e)}`);\n  }\n\n  const outcome = await provider.byKind(entry.kind, options);\n  if (outcome.ok)\n    return {\n      ok: true,\n      entry: { entryId: entry.id, spec: outcome.spec, title: outcome.title, pinned: false },\n    };\n\n  switch (outcome.reason) {\n    case \"no-matching-kind-version\":\n      return problem(\n        `No published version of '${kindName}' matches what this entry asks for ` +\n          `(${entry.kind}). Check the version, or update the block registry.`,\n      );\n    case \"no-implementation\":\n      return problem(\n        `'${kindName}' has no block implementing the version this entry asks for ` +\n          `(${entry.kind}). Nothing can be installed for it yet.`,\n      );\n    case \"no-stable-implementation\":\n      // The one failure with a way out that changes nothing in the file, so the\n      // message names it.\n      return problem(\n        `The only blocks implementing '${kindName}' for this entry (${entry.kind}) are ` +\n          `pre-release versions. Import again with unstable versions allowed to use them.`,\n      );\n  }\n}\n\n/**\n * Split a block package's npm name into the organization and name a registry knows\n * it by: `@npm-scope/organization.name` → `{ organization, name }`.\n *\n * The npm scope and the organization are different things, and only the second one\n * reaches the registry — `@milaboratories/milaboratories.test-download-file` is\n * published as organization `milaboratories`, name `test-download-file`. The split is\n * on the FIRST dot, so a name may contain further dots.\n *\n * Kind names follow the same convention, which is why a template can carry both in\n * the same npm-ish form.\n *\n * @throws if the name has no npm scope or no organization segment\n */\nexport function parseBlockPackName(npmName: string): { organization: string; name: string } {\n  const slash = npmName.indexOf(\"/\");\n  if (!npmName.startsWith(\"@\") || slash < 0) {\n    throw new Error(`expected '@npm-scope/organization.name', got '${npmName}'`);\n  }\n\n  const base = npmName.slice(slash + 1);\n  const dot = base.indexOf(\".\");\n  if (dot <= 0 || dot === base.length - 1) {\n    throw new Error(\n      `'${base}' does not separate an organization from a name with '.' in '${npmName}'`,\n    );\n  }\n\n  return { organization: base.slice(0, dot), name: base.slice(dot + 1) };\n}\n\nfunction messageOf(e: unknown): string {\n  return e instanceof Error ? e.message : String(e);\n}\n"],"mappings":"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"}

package/dist/model/template_resolve.d.ts

@@ -1,7 +1,6 @@
 import { TemplateApplyProblem } from "./template_apply.js";
 import { BlockPackId, BlockPackSpec } from "@milaboratories/pl-model-middle-layer";
 import { BlockKindSelectorReference, BlockPackLocationReference, ProjectTemplateV1 } from "@milaboratories/pl-model-common";
-//#region src/model/template_resolve.d.ts
 /**
  * Where a template entry's block comes from.
  *
@@ -188,5 +187,4 @@ export declare function parseBlockPackName(npmName: string): {
   organization: string;
   name: string;
 };
-//#endregion
 //# sourceMappingURL=template_resolve.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"template_resolve.d.ts","names":[],"sources":["../../src/model/template_resolve.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;YAkCY;;;;;;;;EAQV,SACE,MAAM,4BACN;IAAW;QACR,QAAQ;;;;;;;;EASb,iBAAiB,IAAI,gBAAgB,QAAQ;;;;;;;;;;;;;;EAe7C,aAAa,UAAU,+BAA+B,QAAQ;;;;;;;;;;;;;;;;YAiBpD;WACG;WAAmB,MAAM;WAAwB;;WAEjD;WACA;;;YAOH;WACG;WAAmB,MAAM;WAAwB;;WACjD;WAAoB;;;;;;;;;;;;;;;YAevB;WAEG;WACA,MAAM;WACN;;WAGA;WACA;;;YAIH;;WAED;WACA,MAAM;;;;;;;;;;;;;;;;WAgBN;;;;;;;;WAQA;;;;;;;;;;YAWC;WACD,mBAAmB;WACnB,mBAAmB;;;;;;;;;;;;;;;;;;wBAmBR,uBACpB,UAAU,mBACV,UAAU,mBACV;EAAW;IACV,QAAQ;;;;;;;;;;;;;;;wBAyIK,mBAAmB;EAAoB;EAAsB"}
+{"version":3,"file":"template_resolve.d.ts","names":[],"sources":["../../src/model/template_resolve.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;YAkCY;;;;;;;;EAQV,SACE,MAAM,4BACN;IAAW;QACR,QAAQ;;;;;;;;EASb,iBAAiB,IAAI,gBAAgB,QAAQ;;;;;;;;;;;;;;EAe7C,aAAa,UAAU,+BAA+B,QAAQ;;;;;;;;;;;;;;;;YAiBpD;WACG;WAAmB,MAAM;WAAwB;;WAEjD;WACA;;;YAOH;WACG;WAAmB,MAAM;WAAwB;;WACjD;WAAoB;;;;;;;;;;;;;;;YAevB;WAEG;WACA,MAAM;WACN;;WAGA;WACA;;;YAIH;;WAED;WACA,MAAM;;;;;;;;;;;;;;;;WAgBN;;;;;;;;WAQA;;;;;;;;;;YAWC;WACD,mBAAmB;WACnB,mBAAmB;;;;;;;;;;;;;;;;;;wBAmBR,uBACpB,UAAU,mBACV,UAAU,mBACV;EAAW;IACV,QAAQ;;;;;;;;;;;;;;;wBAyIK,mBAAmB;EAAoB;EAAsB"}

package/dist/model/template_resolve.js

@@ -1,5 +1,5 @@
 import { parseBlockPackReference, parseKindSelectorReference } from "@milaboratories/pl-model-common";
-//#region src/model/template_resolve.ts
+// src/model/template_resolve.ts
 /**
 * Resolve every entry in a template document to a concrete block pack.
 *
@@ -127,7 +127,6 @@ function parseBlockPackName(npmName) {
 function messageOf(e) {
 	return e instanceof Error ? e.message : String(e);
 }
-//#endregion
 export { parseBlockPackName, resolveTemplateEntries };
 
 //# sourceMappingURL=template_resolve.js.map

package/dist/model/template_serializer.cjs

@@ -4,7 +4,7 @@ let yaml = require("yaml");
 yaml = require_runtime.__toESM(yaml, 1);
 let node_url = require("node:url");
 let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
-//#region src/model/template_serializer.ts
+// src/model/template_serializer.ts
 /**
 * The `location` to write for a block installed from the filesystem, or `undefined`
 * for one that came from a registry and therefore needs no locator.
@@ -155,7 +155,6 @@ function exportProjectAsTemplateV1(structure, paramsProvider, kindProvider, spec
 		document
 	};
 }
-//#endregion
 exports.assembleProjectTemplateV1 = assembleProjectTemplateV1;
 exports.exportProjectAsTemplateV1 = exportProjectAsTemplateV1;
 exports.locationOf = locationOf;

package/dist/model/template_serializer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"template_serializer.cjs","names":["PROJECT_TEMPLATE_SCHEMA_V1","YAML","walkProjectForTemplateExport"],"sources":["../../src/model/template_serializer.ts"],"sourcesContent":["import YAML from \"yaml\";\nimport { pathToFileURL } from \"node:url\";\nimport type {\n  BlockKindReference,\n  BlockKindSelectorReference,\n  BlockPackLocationReference,\n  ProjectTemplateV1,\n  ProjectTemplateV1Entry,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  PROJECT_TEMPLATE_SCHEMA_V1,\n  kindReferenceToSelectorReference,\n  parseProjectTemplateV1,\n} from \"@milaboratories/pl-model-common\";\nimport type { BlockPackSpec } from \"@milaboratories/pl-model-middle-layer\";\nimport type { ProjectStructure } from \"./project_model\";\nimport type {\n  TemplateExportProblem,\n  TemplateExportWalk,\n  TemplateParamsResult,\n} from \"./template_export\";\nimport { walkProjectForTemplateExport } from \"./template_export\";\n\n/** A block's exact kind reference, or `undefined` for a block that declares no kind. */\nexport type BlockKindProvider = (blockId: string) => BlockKindReference | undefined;\n\n/**\n * A block's origin spec — where the installed block came from — or `undefined` when\n * it is not known for that block.\n *\n * The project stores this next to the kind reference, so both are read from the same\n * place and neither costs an extra round-trip.\n */\nexport type BlockPackSpecProvider = (blockId: string) => BlockPackSpec | undefined;\n\n/** What the caller gets back for a whole project. */\nexport type ProjectTemplateExportOutcome =\n  | {\n      readonly ok: true;\n      readonly yaml: string;\n      /** The document the YAML was rendered from, already validated. */\n      readonly document: ProjectTemplateV1;\n    }\n  | {\n      readonly ok: false;\n      /** Every block that stands in the way, not just the first. */\n      readonly problems: readonly TemplateExportProblem[];\n    };\n\n/**\n * The `location` to write for a block installed from the filesystem, or `undefined`\n * for one that came from a registry and therefore needs no locator.\n *\n * Both filesystem spec shapes are emitted, and they anchor at different directories\n * — a dev block at its facade package, an npm-consumed one at its block-pack folder.\n * The document does not distinguish them: one URI is written either way, and telling\n * the two layouts apart is done by looking at what is actually there, by the side\n * that has the filesystem anyway. Encoding the layout in the file instead would\n * freeze today's two shapes into the format.\n *\n * A dev spec carries an OS path and is converted here, which also percent-encodes a\n * path containing spaces. An npm-consumed spec already carries a `file:` URL and is\n * passed through: it is the locator the block itself emitted, and reconstructing one\n * from it could only lose information.\n */\nexport function locationOf(spec: BlockPackSpec): BlockPackLocationReference | undefined {\n  switch (spec.type) {\n    case \"dev-v2\":\n      return pathToFileURL(spec.folder).href as BlockPackLocationReference;\n    case \"from-pack-v2\":\n      return spec.packUrl as BlockPackLocationReference;\n    // A registry block is found by name, which is what makes the entry portable —\n    // writing where this machine happened to cache it would take that away. `dev-v1`\n    // predates kinds entirely, so such a block has no kind and never reaches here.\n    case \"dev-v1\":\n    case \"from-registry-v1\":\n    case \"from-registry-v2\":\n      return undefined;\n  }\n}\n\n/**\n * Turn a project into a template document.\n *\n * Assembly is deliberately dull — the entry is the block's id, its widened kind\n * reference, and the params the walk already collected. The interesting decisions\n * were made upstream; what is left here is the two things only this layer can\n * check, both of which produce problems rather than a broken file:\n *\n * - **A block with no kind cannot be written.** An entry's `kind` is required — it\n *   is the params contract the entry is typed against — while a block's kind is\n *   optional, so a block that predates kinds, or that uses the deprecated\n *   kind-less model overload, has no legal entry. Reported per block. This is not\n *   an edge case today: it is what most existing projects will hit until their\n *   blocks are republished.\n * - **References must point at an entry declared earlier.** Verbatim id reuse\n *   means a reference to a deleted block survives into the file naming nothing:\n *   deleting a block only removes it from the structure and does not rewrite\n *   downstream args, so a live project holds such references routinely.\n *\n * `block` is never emitted. That override exists to pin an implementation against\n * a kind's version range, and export always writes the exact version the block\n * implements, so there is nothing left for it to pin.\n *\n * `location` IS emitted, for every block that was installed from the filesystem. Such\n * a block is not in any registry, so the kind reference alone names nothing the\n * importer could find, and a file that omitted the one usable answer would describe a\n * project that cannot be recreated. It costs portability, and nothing says so: such a\n * file is the debugging path, read by the developer who wrote it on the machine that\n * wrote it.\n *\n * Problems from `walk` are carried through, so a caller can hand a walk straight\n * in and get one combined list.\n */\nexport function assembleProjectTemplateV1(\n  walk: TemplateExportWalk,\n  kindProvider: BlockKindProvider,\n  specProvider: BlockPackSpecProvider,\n): { document: ProjectTemplateV1; problems: readonly TemplateExportProblem[] } {\n  const problems: TemplateExportProblem[] = [...walk.problems];\n  const blocks: ProjectTemplateV1Entry[] = [];\n\n  for (const entry of walk.entries) {\n    const kind = kindProvider(entry.blockId);\n\n    if (kind === undefined) {\n      problems.push({\n        blockId: entry.blockId,\n        blockLabel: entry.blockLabel,\n        error:\n          \"Block declares no kind, so it cannot be written to a template: an entry's kind \" +\n          \"carries the params contract the entry is typed against\",\n      });\n      continue;\n    }\n\n    let selector: BlockKindSelectorReference;\n    try {\n      // Widening validates, and therefore throws — which is why it happens here\n      // and not where the reference is read: every read site sits inside a\n      // recomputed project overview, where one malformed stored reference must not\n      // be able to break unrelated blocks.\n      selector = kindReferenceToSelectorReference(kind);\n    } catch (e) {\n      problems.push({\n        blockId: entry.blockId,\n        blockLabel: entry.blockLabel,\n        error: `Block's stored kind reference is malformed: ${e instanceof Error ? e.message : String(e)}`,\n      });\n      continue;\n    }\n\n    const spec = specProvider(entry.blockId);\n    const location = spec === undefined ? undefined : locationOf(spec);\n\n    blocks.push({\n      id: entry.blockId,\n      kind: selector,\n      params: entry.params,\n      ...(location !== undefined ? { location } : {}),\n    });\n  }\n\n  // References are not examined. A project's structure is topological by construction, so an\n  // entry cannot legally reference one below it — and checking would mean reading the params,\n  // which only the block that wrote them can do.\n  const document: ProjectTemplateV1 = { schema: PROJECT_TEMPLATE_SCHEMA_V1, blocks };\n\n  return { document, problems };\n}\n\n/**\n * Render a template document to YAML text.\n *\n * Two non-default emitter settings, both about the file being read by someone\n * else's code:\n *\n * - **No line folding.** A wrapped scalar still parses, but it makes a diff between\n *   two exported templates unreadable, which is most of the reason to prefer YAML\n *   over JSON here.\n * - **Quote as if the reader were YAML 1.1**, while still parsing as 1.2. YAML 1.2\n *   dropped `yes`/`no`/`on`/`off`/`y`/`n` as booleans and dropped sexagesimal\n *   integers, so a 1.2 emitter leaves a params value of `\"yes\"` or `\"1:30\"` bare —\n *   which a 1.1 reader (PyYAML's default, and Go's yaml.v2) turns into `true` and\n *   `90`. A template is a contract for a second implementation, so the safe\n *   combination is to quote against the stricter ruleset and read with the looser\n *   one: a quoted scalar means the same thing under both. This adds no `%YAML`\n *   directive — it only changes which scalars get quotes.\n */\nexport function stringifyProjectTemplateV1(document: ProjectTemplateV1): string {\n  return YAML.stringify(document, { lineWidth: 0, version: \"1.1\" });\n}\n\n/**\n * Export a project as `template-v1` YAML, or report every reason it cannot be.\n *\n * All-or-nothing on purpose. A partial template silently drops blocks and the\n * surviving entries may reference the dropped ones, so what looks like a\n * successful export would produce a project missing pieces the user never chose\n * to leave out. Reporting everything at once instead of failing on the first\n * problem is the other half of that: fixing an export should take one pass.\n *\n * @param structure The project structure, which supplies both membership and order\n * @param paramsProvider A block's derived template params, in live form\n * @param kindProvider A block's exact kind reference, read from its stored config\n * @param specProvider A block's origin spec, read from the same stored container\n */\nexport function exportProjectAsTemplateV1(\n  structure: ProjectStructure,\n  paramsProvider: (blockId: string) => TemplateParamsResult | undefined,\n  kindProvider: BlockKindProvider,\n  specProvider: BlockPackSpecProvider,\n): ProjectTemplateExportOutcome {\n  const walk = walkProjectForTemplateExport(structure, paramsProvider);\n  const { document, problems } = assembleProjectTemplateV1(walk, kindProvider, specProvider);\n\n  if (problems.length > 0) return { ok: false, problems };\n\n  // Export must emit exactly what import parses, so that is asserted on every\n  // export rather than only in tests — running the import-side parser over the\n  // document we are about to write is the cheapest possible proof of it. Nothing\n  // user-facing is expected to fail here: the kind grammar was checked by the\n  // widening above, params were checked to be a mapping by the walk, and the\n  // reference rules by the assembler. A throw means a bug in the assembler, with\n  // one known exception: a project structure holding two blocks with the same id,\n  // which is reachable through the mutator and produces duplicate entry ids.\n  parseProjectTemplateV1(document);\n\n  return {\n    ok: true,\n    yaml: stringifyProjectTemplateV1(document),\n    document,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAiEA,SAAgB,WAAW,MAA6D;CACtF,QAAQ,KAAK,MAAb;EACE,KAAK,UACH,QAAA,GAAA,SAAA,cAAA,CAAqB,KAAK,MAAM,CAAC,CAAC;EACpC,KAAK,gBACH,OAAO,KAAK;EAId,KAAK;EACL,KAAK;EACL,KAAK,oBACH;CACJ;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,0BACd,MACA,cACA,cAC6E;CAC7E,MAAM,WAAoC,CAAC,GAAG,KAAK,QAAQ;CAC3D,MAAM,SAAmC,CAAC;CAE1C,KAAK,MAAM,SAAS,KAAK,SAAS;EAChC,MAAM,OAAO,aAAa,MAAM,OAAO;EAEvC,IAAI,SAAS,KAAA,GAAW;GACtB,SAAS,KAAK;IACZ,SAAS,MAAM;IACf,YAAY,MAAM;IAClB,OACE;GAEJ,CAAC;GACD;EACF;EAEA,IAAI;EACJ,IAAI;GAKF,YAAA,GAAA,gCAAA,iCAAA,CAA4C,IAAI;EAClD,SAAS,GAAG;GACV,SAAS,KAAK;IACZ,SAAS,MAAM;IACf,YAAY,MAAM;IAClB,OAAO,+CAA+C,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;GACjG,CAAC;GACD;EACF;EAEA,MAAM,OAAO,aAAa,MAAM,OAAO;EACvC,MAAM,WAAW,SAAS,KAAA,IAAY,KAAA,IAAY,WAAW,IAAI;EAEjE,OAAO,KAAK;GACV,IAAI,MAAM;GACV,MAAM;GACN,QAAQ,MAAM;GACd,GAAI,aAAa,KAAA,IAAY,EAAE,SAAS,IAAI,CAAC;EAC/C,CAAC;CACH;CAOA,OAAO;EAAE,UAAA;GAF6B,QAAQA,gCAAAA;GAA4B;EAE1D;EAAG;CAAS;AAC9B;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,2BAA2B,UAAqC;CAC9E,OAAOC,KAAAA,QAAK,UAAU,UAAU;EAAE,WAAW;EAAG,SAAS;CAAM,CAAC;AAClE;;;;;;;;;;;;;;;AAgBA,SAAgB,0BACd,WACA,gBACA,cACA,cAC8B;CAE9B,MAAM,EAAE,UAAU,aAAa,0BADlBC,wBAAAA,6BAA6B,WAAW,cACO,GAAG,cAAc,YAAY;CAEzF,IAAI,SAAS,SAAS,GAAG,OAAO;EAAE,IAAI;EAAO;CAAS;CAUtD,CAAA,GAAA,gCAAA,uBAAA,CAAuB,QAAQ;CAE/B,OAAO;EACL,IAAI;EACJ,MAAM,2BAA2B,QAAQ;EACzC;CACF;AACF"}
+{"version":3,"file":"template_serializer.cjs","names":["pathToFileURL","kindReferenceToSelectorReference","PROJECT_TEMPLATE_SCHEMA_V1","YAML","walkProjectForTemplateExport"],"sources":["../../src/model/template_serializer.ts"],"sourcesContent":["import YAML from \"yaml\";\nimport { pathToFileURL } from \"node:url\";\nimport type {\n  BlockKindReference,\n  BlockKindSelectorReference,\n  BlockPackLocationReference,\n  ProjectTemplateV1,\n  ProjectTemplateV1Entry,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  PROJECT_TEMPLATE_SCHEMA_V1,\n  kindReferenceToSelectorReference,\n  parseProjectTemplateV1,\n} from \"@milaboratories/pl-model-common\";\nimport type { BlockPackSpec } from \"@milaboratories/pl-model-middle-layer\";\nimport type { ProjectStructure } from \"./project_model\";\nimport type {\n  TemplateExportProblem,\n  TemplateExportWalk,\n  TemplateParamsResult,\n} from \"./template_export\";\nimport { walkProjectForTemplateExport } from \"./template_export\";\n\n/** A block's exact kind reference, or `undefined` for a block that declares no kind. */\nexport type BlockKindProvider = (blockId: string) => BlockKindReference | undefined;\n\n/**\n * A block's origin spec — where the installed block came from — or `undefined` when\n * it is not known for that block.\n *\n * The project stores this next to the kind reference, so both are read from the same\n * place and neither costs an extra round-trip.\n */\nexport type BlockPackSpecProvider = (blockId: string) => BlockPackSpec | undefined;\n\n/** What the caller gets back for a whole project. */\nexport type ProjectTemplateExportOutcome =\n  | {\n      readonly ok: true;\n      readonly yaml: string;\n      /** The document the YAML was rendered from, already validated. */\n      readonly document: ProjectTemplateV1;\n    }\n  | {\n      readonly ok: false;\n      /** Every block that stands in the way, not just the first. */\n      readonly problems: readonly TemplateExportProblem[];\n    };\n\n/**\n * The `location` to write for a block installed from the filesystem, or `undefined`\n * for one that came from a registry and therefore needs no locator.\n *\n * Both filesystem spec shapes are emitted, and they anchor at different directories\n * — a dev block at its facade package, an npm-consumed one at its block-pack folder.\n * The document does not distinguish them: one URI is written either way, and telling\n * the two layouts apart is done by looking at what is actually there, by the side\n * that has the filesystem anyway. Encoding the layout in the file instead would\n * freeze today's two shapes into the format.\n *\n * A dev spec carries an OS path and is converted here, which also percent-encodes a\n * path containing spaces. An npm-consumed spec already carries a `file:` URL and is\n * passed through: it is the locator the block itself emitted, and reconstructing one\n * from it could only lose information.\n */\nexport function locationOf(spec: BlockPackSpec): BlockPackLocationReference | undefined {\n  switch (spec.type) {\n    case \"dev-v2\":\n      return pathToFileURL(spec.folder).href as BlockPackLocationReference;\n    case \"from-pack-v2\":\n      return spec.packUrl as BlockPackLocationReference;\n    // A registry block is found by name, which is what makes the entry portable —\n    // writing where this machine happened to cache it would take that away. `dev-v1`\n    // predates kinds entirely, so such a block has no kind and never reaches here.\n    case \"dev-v1\":\n    case \"from-registry-v1\":\n    case \"from-registry-v2\":\n      return undefined;\n  }\n}\n\n/**\n * Turn a project into a template document.\n *\n * Assembly is deliberately dull — the entry is the block's id, its widened kind\n * reference, and the params the walk already collected. The interesting decisions\n * were made upstream; what is left here is the two things only this layer can\n * check, both of which produce problems rather than a broken file:\n *\n * - **A block with no kind cannot be written.** An entry's `kind` is required — it\n *   is the params contract the entry is typed against — while a block's kind is\n *   optional, so a block that predates kinds, or that uses the deprecated\n *   kind-less model overload, has no legal entry. Reported per block. This is not\n *   an edge case today: it is what most existing projects will hit until their\n *   blocks are republished.\n * - **References must point at an entry declared earlier.** Verbatim id reuse\n *   means a reference to a deleted block survives into the file naming nothing:\n *   deleting a block only removes it from the structure and does not rewrite\n *   downstream args, so a live project holds such references routinely.\n *\n * `block` is never emitted. That override exists to pin an implementation against\n * a kind's version range, and export always writes the exact version the block\n * implements, so there is nothing left for it to pin.\n *\n * `location` IS emitted, for every block that was installed from the filesystem. Such\n * a block is not in any registry, so the kind reference alone names nothing the\n * importer could find, and a file that omitted the one usable answer would describe a\n * project that cannot be recreated. It costs portability, and nothing says so: such a\n * file is the debugging path, read by the developer who wrote it on the machine that\n * wrote it.\n *\n * Problems from `walk` are carried through, so a caller can hand a walk straight\n * in and get one combined list.\n */\nexport function assembleProjectTemplateV1(\n  walk: TemplateExportWalk,\n  kindProvider: BlockKindProvider,\n  specProvider: BlockPackSpecProvider,\n): { document: ProjectTemplateV1; problems: readonly TemplateExportProblem[] } {\n  const problems: TemplateExportProblem[] = [...walk.problems];\n  const blocks: ProjectTemplateV1Entry[] = [];\n\n  for (const entry of walk.entries) {\n    const kind = kindProvider(entry.blockId);\n\n    if (kind === undefined) {\n      problems.push({\n        blockId: entry.blockId,\n        blockLabel: entry.blockLabel,\n        error:\n          \"Block declares no kind, so it cannot be written to a template: an entry's kind \" +\n          \"carries the params contract the entry is typed against\",\n      });\n      continue;\n    }\n\n    let selector: BlockKindSelectorReference;\n    try {\n      // Widening validates, and therefore throws — which is why it happens here\n      // and not where the reference is read: every read site sits inside a\n      // recomputed project overview, where one malformed stored reference must not\n      // be able to break unrelated blocks.\n      selector = kindReferenceToSelectorReference(kind);\n    } catch (e) {\n      problems.push({\n        blockId: entry.blockId,\n        blockLabel: entry.blockLabel,\n        error: `Block's stored kind reference is malformed: ${e instanceof Error ? e.message : String(e)}`,\n      });\n      continue;\n    }\n\n    const spec = specProvider(entry.blockId);\n    const location = spec === undefined ? undefined : locationOf(spec);\n\n    blocks.push({\n      id: entry.blockId,\n      kind: selector,\n      params: entry.params,\n      ...(location !== undefined ? { location } : {}),\n    });\n  }\n\n  // References are not examined. A project's structure is topological by construction, so an\n  // entry cannot legally reference one below it — and checking would mean reading the params,\n  // which only the block that wrote them can do.\n  const document: ProjectTemplateV1 = { schema: PROJECT_TEMPLATE_SCHEMA_V1, blocks };\n\n  return { document, problems };\n}\n\n/**\n * Render a template document to YAML text.\n *\n * Two non-default emitter settings, both about the file being read by someone\n * else's code:\n *\n * - **No line folding.** A wrapped scalar still parses, but it makes a diff between\n *   two exported templates unreadable, which is most of the reason to prefer YAML\n *   over JSON here.\n * - **Quote as if the reader were YAML 1.1**, while still parsing as 1.2. YAML 1.2\n *   dropped `yes`/`no`/`on`/`off`/`y`/`n` as booleans and dropped sexagesimal\n *   integers, so a 1.2 emitter leaves a params value of `\"yes\"` or `\"1:30\"` bare —\n *   which a 1.1 reader (PyYAML's default, and Go's yaml.v2) turns into `true` and\n *   `90`. A template is a contract for a second implementation, so the safe\n *   combination is to quote against the stricter ruleset and read with the looser\n *   one: a quoted scalar means the same thing under both. This adds no `%YAML`\n *   directive — it only changes which scalars get quotes.\n */\nexport function stringifyProjectTemplateV1(document: ProjectTemplateV1): string {\n  return YAML.stringify(document, { lineWidth: 0, version: \"1.1\" });\n}\n\n/**\n * Export a project as `template-v1` YAML, or report every reason it cannot be.\n *\n * All-or-nothing on purpose. A partial template silently drops blocks and the\n * surviving entries may reference the dropped ones, so what looks like a\n * successful export would produce a project missing pieces the user never chose\n * to leave out. Reporting everything at once instead of failing on the first\n * problem is the other half of that: fixing an export should take one pass.\n *\n * @param structure The project structure, which supplies both membership and order\n * @param paramsProvider A block's derived template params, in live form\n * @param kindProvider A block's exact kind reference, read from its stored config\n * @param specProvider A block's origin spec, read from the same stored container\n */\nexport function exportProjectAsTemplateV1(\n  structure: ProjectStructure,\n  paramsProvider: (blockId: string) => TemplateParamsResult | undefined,\n  kindProvider: BlockKindProvider,\n  specProvider: BlockPackSpecProvider,\n): ProjectTemplateExportOutcome {\n  const walk = walkProjectForTemplateExport(structure, paramsProvider);\n  const { document, problems } = assembleProjectTemplateV1(walk, kindProvider, specProvider);\n\n  if (problems.length > 0) return { ok: false, problems };\n\n  // Export must emit exactly what import parses, so that is asserted on every\n  // export rather than only in tests — running the import-side parser over the\n  // document we are about to write is the cheapest possible proof of it. Nothing\n  // user-facing is expected to fail here: the kind grammar was checked by the\n  // widening above, params were checked to be a mapping by the walk, and the\n  // reference rules by the assembler. A throw means a bug in the assembler, with\n  // one known exception: a project structure holding two blocks with the same id,\n  // which is reachable through the mutator and produces duplicate entry ids.\n  parseProjectTemplateV1(document);\n\n  return {\n    ok: true,\n    yaml: stringifyProjectTemplateV1(document),\n    document,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAiEA,SAAgB,WAAW,MAA6D;CACtF,QAAQ,KAAK,MAAb;EACE,KAAK,UACH,QAAA,GAAOA,SAAAA,cAAAA,CAAc,KAAK,MAAM,CAAC,CAAC;EACpC,KAAK,gBACH,OAAO,KAAK;EAId,KAAK;EACL,KAAK;EACL,KAAK,oBACH;CACJ;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,0BACd,MACA,cACA,cAC6E;CAC7E,MAAM,WAAoC,CAAC,GAAG,KAAK,QAAQ;CAC3D,MAAM,SAAmC,CAAC;CAE1C,KAAK,MAAM,SAAS,KAAK,SAAS;EAChC,MAAM,OAAO,aAAa,MAAM,OAAO;EAEvC,IAAI,SAAS,KAAA,GAAW;GACtB,SAAS,KAAK;IACZ,SAAS,MAAM;IACf,YAAY,MAAM;IAClB,OACE;GAEJ,CAAC;GACD;EACF;EAEA,IAAI;EACJ,IAAI;GAKF,YAAA,GAAWC,gCAAAA,iCAAAA,CAAiC,IAAI;EAClD,SAAS,GAAG;GACV,SAAS,KAAK;IACZ,SAAS,MAAM;IACf,YAAY,MAAM;IAClB,OAAO,+CAA+C,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;GACjG,CAAC;GACD;EACF;EAEA,MAAM,OAAO,aAAa,MAAM,OAAO;EACvC,MAAM,WAAW,SAAS,KAAA,IAAY,KAAA,IAAY,WAAW,IAAI;EAEjE,OAAO,KAAK;GACV,IAAI,MAAM;GACV,MAAM;GACN,QAAQ,MAAM;GACd,GAAI,aAAa,KAAA,IAAY,EAAE,SAAS,IAAI,CAAC;EAC/C,CAAC;CACH;CAOA,OAAO;EAAE,UAAA;GAF6B,QAAQC,gCAAAA;GAA4B;EAE1D;EAAG;CAAS;AAC9B;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,2BAA2B,UAAqC;CAC9E,OAAOC,KAAAA,QAAK,UAAU,UAAU;EAAE,WAAW;EAAG,SAAS;CAAM,CAAC;AAClE;;;;;;;;;;;;;;;AAgBA,SAAgB,0BACd,WACA,gBACA,cACA,cAC8B;CAE9B,MAAM,EAAE,UAAU,aAAa,0BADlBC,wBAAAA,6BAA6B,WAAW,cACO,GAAG,cAAc,YAAY;CAEzF,IAAI,SAAS,SAAS,GAAG,OAAO;EAAE,IAAI;EAAO;CAAS;CAUtD,CAAA,GAAA,gCAAA,uBAAA,CAAuB,QAAQ;CAE/B,OAAO;EACL,IAAI;EACJ,MAAM,2BAA2B,QAAQ;EACzC;CACF;AACF"}

package/dist/model/template_serializer.d.ts

@@ -2,7 +2,6 @@ import "./project_model.js";
 import { TemplateExportProblem } from "./template_export.js";
 import { BlockPackSpec } from "@milaboratories/pl-model-middle-layer";
 import { BlockKindReference, BlockPackLocationReference, ProjectTemplateV1 } from "@milaboratories/pl-model-common";
-//#region src/model/template_serializer.d.ts
 /** What the caller gets back for a whole project. */
 export type ProjectTemplateExportOutcome = {
   readonly ok: true;
@@ -50,5 +49,4 @@ export declare function locationOf(spec: BlockPackSpec): BlockPackLocationRefere
  *   directive — it only changes which scalars get quotes.
  */
 export declare function stringifyProjectTemplateV1(document: ProjectTemplateV1): string;
-//#endregion
 //# sourceMappingURL=template_serializer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"template_serializer.d.ts","names":[],"sources":["../../src/model/template_serializer.ts"],"mappings":";;;;;;YAoCY;WAEG;WACA;;WAEA,UAAU;;WAGV;;WAEA,mBAAmB;;;;;;;;;;;;;;;;;;wBAmBlB,WAAW,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;wBA4HjC,2BAA2B,UAAU"}
+{"version":3,"file":"template_serializer.d.ts","names":[],"sources":["../../src/model/template_serializer.ts"],"mappings":";;;;;YAoCY;WAEG;WACA;;WAEA,UAAU;;WAGV;;WAEA,mBAAmB;;;;;;;;;;;;;;;;;;wBAmBlB,WAAW,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;wBA4HjC,2BAA2B,UAAU"}

package/dist/model/template_serializer.js

@@ -2,7 +2,7 @@ import { walkProjectForTemplateExport } from "./template_export.js";
 import YAML from "yaml";
 import { pathToFileURL } from "node:url";
 import { PROJECT_TEMPLATE_SCHEMA_V1, kindReferenceToSelectorReference, parseProjectTemplateV1 } from "@milaboratories/pl-model-common";
-//#region src/model/template_serializer.ts
+// src/model/template_serializer.ts
 /**
 * The `location` to write for a block installed from the filesystem, or `undefined`
 * for one that came from a registry and therefore needs no locator.
@@ -153,7 +153,6 @@ function exportProjectAsTemplateV1(structure, paramsProvider, kindProvider, spec
 		document
 	};
 }
-//#endregion
 export { assembleProjectTemplateV1, exportProjectAsTemplateV1, locationOf, stringifyProjectTemplateV1 };
 
 //# sourceMappingURL=template_serializer.js.map

package/dist/model/template_spec.d.ts

@@ -1,6 +1,5 @@
 import { SignedResourceId } from "@milaboratories/pl-client";
 import { CompiledTemplateV3, TemplateData } from "@milaboratories/pl-model-backend";
-//#region src/model/template_spec.d.ts
 export interface TemplateFromRegistry {
   readonly type: "from-registry";
   registry: string;
@@ -24,5 +23,4 @@ export interface TemplateFromFile {
 }
 export type TemplateSpecPrepared = TemplateFromRegistry | ExplicitTemplate | PreparedTemplate | CachedTemplate;
 export type TemplateSpecAny = TemplateSpecPrepared | TemplateFromFile;
-//#endregion
 //# sourceMappingURL=template_spec.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"template_spec.d.ts","names":[],"sources":["../../src/model/template_spec.ts"],"mappings":";;;iBAGiB;WACN;EACT;EACA;;iBAGe;WACN;EACT,SAAS;;iBAGM;WACN;EACT,MAAM,eAAe;;iBAGN;WACN;WACA,YAAY;;iBAGN;WACN;EACT;;YAGU,uBACR,uBACA,mBACA,mBACA;YACQ,kBAAkB,uBAAuB"}
+{"version":3,"file":"template_spec.d.ts","names":[],"sources":["../../src/model/template_spec.ts"],"mappings":";;iBAGiB;WACN;EACT;EACA;;iBAGe;WACN;EACT,SAAS;;iBAGM;WACN;EACT,MAAM,eAAe;;iBAGN;WACN;WACA,YAAY;;iBAGN;WACN;EACT;;YAGU,uBACR,uBACA,mBACA,mBACA;YACQ,kBAAkB,uBAAuB"}

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

@@ -6,7 +6,7 @@ require("../../block_registry/index.cjs");
 const require_template_loading = require("../template/template_loading.cjs");
 const require_frontend = require("./frontend.cjs");
 const require_WorkerManager = require("../../worker/WorkerManager.cjs");
-const require_usingCtx = require("../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/usingCtx.cjs");
+const require_usingCtx = require("../../_virtual/_@oxc-project_runtime@0.155.0/helpers/esm/usingCtx.cjs");
 let _platforma_sdk_model = require("@platforma-sdk/model");
 let undici = require("undici");
 let _platforma_sdk_block_tools = require("@platforma-sdk/block-tools");
@@ -19,7 +19,7 @@ let lru_cache = require("lru-cache");
 let canonicalize = require("canonicalize");
 canonicalize = require_runtime.__toESM(canonicalize, 1);
 let zod = require("zod");
-//#region src/mutator/block-pack/block_pack.ts
+// src/mutator/block-pack/block_pack.ts
 const BlockPackCustomType = {
 	name: "BlockPackCustom",
 	version: "1"
@@ -51,9 +51,10 @@ var BlockPackPreparer = class {
 	}
 	remoteContentCache = new lru_cache.LRUCache({
 		max: 500,
-		maxSize: 128 * 1024 * 1024,
+		maxSize: 134217728,
 		fetchMethod: async (key) => {
-			return await (await (0, undici.request)(key, this.http !== void 0 ? { dispatcher: this.http } : {})).body.arrayBuffer();
+			const httpOptions = this.http !== void 0 ? { dispatcher: this.http } : {};
+			return await (await (0, undici.request)(key, httpOptions)).body.arrayBuffer();
 		},
 		sizeCalculation: (value) => value.byteLength
 	});
@@ -73,7 +74,8 @@ var BlockPackPreparer = class {
 				return parseStringConfig(await node_fs.default.promises.readFile(description.components.model.file, { encoding: "utf-8" }));
 			}
 			case "from-pack-v2": {
-				const description = await (0, _platforma_sdk_block_tools.loadPackDescriptionFromManifest)((0, node_url.fileURLToPath)(spec.packUrl));
+				const packDir = (0, node_url.fileURLToPath)(spec.packUrl);
+				const description = await (0, _platforma_sdk_block_tools.loadPackDescriptionFromManifest)(packDir);
 				return parseStringConfig(await node_fs.default.promises.readFile(description.components.model.file, { encoding: "utf-8" }));
 			}
 			case "from-registry-v1": {
@@ -266,7 +268,6 @@ function createBlockPack(tx, spec) {
 		default: return (0, _milaboratories_ts_helpers.assertNever)(spec.type);
 	}
 }
-//#endregion
 exports.BlockPackCustomType = BlockPackCustomType;
 exports.BlockPackFrontendField = BlockPackFrontendField;
 exports.BlockPackPreparer = BlockPackPreparer;

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

@@ -1 +1 @@
-{"version":3,"file":"block_pack.cjs","names":["z","Code","LRUCache","resolveDevPacket","fs","RegistryV1","WorkerManager","requiredCapabilitiesFromTemplate","getDevV2PacketMtime","getFromPackV2Mtime","loadTemplate","createFrontend"],"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.cjs","names":["z","Code","LRUCache","request","resolveDevPacket","fs","loadPackDescription","fileURLToPath","loadPackDescriptionFromManifest","RegistryV1","assertNever","WorkerManager","requiredCapabilitiesFromTemplate","getDevV2PacketMtime","getFromPackV2Mtime","field","loadTemplate","createFrontend"],"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/block_pack.d.ts

@@ -5,7 +5,6 @@ import { BlockConfigContainer } from "@platforma-sdk/model";
 import { Dispatcher } from "undici";
 import { Signer } from "@milaboratories/ts-helpers";
 import { AnyResourceRef, PlTransaction, ResourceType } from "@milaboratories/pl-client";
-//#region src/mutator/block-pack/block_pack.d.ts
 export declare class BlockPackPreparer {
   private readonly v2RegistryProvider;
   private readonly signer;
@@ -20,5 +19,4 @@ export declare class BlockPackPreparer {
   prepare(spec: BlockPackSpecAny): Promise<BlockPackSpecPrepared>;
   private prepareWithoutUnpacking;
 }
-//#endregion
 //# sourceMappingURL=block_pack.d.ts.map

package/dist/mutator/block-pack/block_pack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block_pack.d.ts","names":[],"sources":["../../../src/mutator/block-pack/block_pack.ts"],"mappings":";;;;;;;;qBA4Da;mBAEQ;mBACA;mBACA;EAHnB,YACmB,oBAAoB,oBACpB,QAAQ,QACR,OAAO;mBAGT;;mBAWA;EAIJ,wBAAwB,MAAM,mBAAmB,QAAQ;;UAqD9D;EAWK,QAAQ,MAAM,mBAAmB,QAAQ;UAmCxC"}
+{"version":3,"file":"block_pack.d.ts","names":[],"sources":["../../../src/mutator/block-pack/block_pack.ts"],"mappings":";;;;;;;qBA4Da;mBAEQ;mBACA;mBACA;EAHnB,YACmB,oBAAoB,oBACpB,QAAQ,QACR,OAAO;mBAGT;;mBAWA;EAIJ,wBAAwB,MAAM,mBAAmB,QAAQ;;UAqD9D;EAWK,QAAQ,MAAM,mBAAmB,QAAQ;UAmCxC"}

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

@@ -5,7 +5,7 @@ import "../../block_registry/index.js";
 import { loadTemplate } from "../template/template_loading.js";
 import { createFrontend } from "./frontend.js";
 import { WorkerManager } from "../../worker/WorkerManager.js";
-import _usingCtx from "../../_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/usingCtx.js";
+import _usingCtx from "../../_virtual/_@oxc-project_runtime@0.155.0/helpers/esm/usingCtx.js";
 import { Code } from "@platforma-sdk/model";
 import { request } from "undici";
 import { RegistryV1, loadPackDescription, loadPackDescriptionFromManifest } from "@platforma-sdk/block-tools";
@@ -16,7 +16,7 @@ import { field } from "@milaboratories/pl-client";
 import { LRUCache } from "lru-cache";
 import canonicalize from "canonicalize";
 import { z } from "zod";
-//#region src/mutator/block-pack/block_pack.ts
+// src/mutator/block-pack/block_pack.ts
 const BlockPackCustomType = {
 	name: "BlockPackCustom",
 	version: "1"
@@ -48,9 +48,10 @@ var BlockPackPreparer = class {
 	}
 	remoteContentCache = new LRUCache({
 		max: 500,
-		maxSize: 128 * 1024 * 1024,
+		maxSize: 134217728,
 		fetchMethod: async (key) => {
-			return await (await request(key, this.http !== void 0 ? { dispatcher: this.http } : {})).body.arrayBuffer();
+			const httpOptions = this.http !== void 0 ? { dispatcher: this.http } : {};
+			return await (await request(key, httpOptions)).body.arrayBuffer();
 		},
 		sizeCalculation: (value) => value.byteLength
 	});
@@ -70,7 +71,8 @@ var BlockPackPreparer = class {
 				return parseStringConfig(await fs.promises.readFile(description.components.model.file, { encoding: "utf-8" }));
 			}
 			case "from-pack-v2": {
-				const description = await loadPackDescriptionFromManifest(fileURLToPath(spec.packUrl));
+				const packDir = fileURLToPath(spec.packUrl);
+				const description = await loadPackDescriptionFromManifest(packDir);
 				return parseStringConfig(await fs.promises.readFile(description.components.model.file, { encoding: "utf-8" }));
 			}
 			case "from-registry-v1": {
@@ -263,7 +265,6 @@ function createBlockPack(tx, spec) {
 		default: return assertNever(spec.type);
 	}
 }
-//#endregion
 export { BlockPackCustomType, BlockPackFrontendField, BlockPackPreparer, BlockPackTemplateField, createBlockPack };
 
 //# sourceMappingURL=block_pack.js.map