@koda-sl/baker-cli 0.400.0 → 0.401.0

package/dist/{chunk-UW62VPTH.js → chunk-U4OKU5EF.js}

@@ -617,7 +617,7 @@ ${originalIndentation}`;
 });
 
 // src/engine/index.ts
-import path21 from "path";
+import path22 from "path";
 
 // src/engine/client/http.ts
 var CONTENT_POLICY_CODE = "content_policy_blocked";
@@ -667,17 +667,17 @@ var HttpClient = class {
     this.fetchFn = opts.fetchFn ?? fetch;
     this.sleepFn = opts.sleepFn ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
   }
-  async postJson(path22, body, signal) {
-    return await this.requestJson("POST", path22, body, signal);
+  async postJson(path23, body, signal) {
+    return await this.requestJson("POST", path23, body, signal);
   }
-  async putJson(path22, body, signal) {
-    return await this.requestJson("PUT", path22, body, signal);
+  async putJson(path23, body, signal) {
+    return await this.requestJson("PUT", path23, body, signal);
   }
-  async getJson(path22, signal) {
-    return await this.requestJson("GET", path22, void 0, signal);
+  async getJson(path23, signal) {
+    return await this.requestJson("GET", path23, void 0, signal);
   }
-  async requestJson(method, path22, body, signal) {
-    const url = `${this.baseUrl}${path22.startsWith("/") ? path22 : `/${path22}`}`;
+  async requestJson(method, path23, body, signal) {
+    const url = `${this.baseUrl}${path23.startsWith("/") ? path23 : `/${path23}`}`;
     for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
       const outcome = await this.attempt(method, url, body, attempt, signal);
       if (outcome.kind === "value") return outcome.value;
@@ -869,12 +869,12 @@ var BackendClient = class {
   }
   async pollJob(jobId, signal) {
     const deadline = Date.now() + JOB_POLL_MAX_MS;
-    const path22 = `/api/canvas/jobs/${encodeURIComponent(jobId)}`;
+    const path23 = `/api/canvas/jobs/${encodeURIComponent(jobId)}`;
     for (let attempt = 0; ; attempt++) {
       if (signal?.aborted) {
         throw new BackendHttpError({ kind: "network", cause: signal.reason ?? new Error("aborted") });
       }
-      const job = await this.http.getJson(path22, signal);
+      const job = await this.http.getJson(path23, signal);
       if (job.status === "completed") return job.result;
       if (job.status === "failed") throw failedJobError(job.error);
       if (Date.now() > deadline) {
@@ -953,8 +953,8 @@ var BackendClient = class {
     await this.http.postJson("/api/creatives/definition", payload, signal);
   }
   getArtifact(kind, name, version, signal) {
-    const path22 = version ? `/api/canvas/artifacts/${encodeURIComponent(kind)}/${encodeURIComponent(name)}/${encodeURIComponent(version)}` : `/api/canvas/artifacts/${encodeURIComponent(kind)}/${encodeURIComponent(name)}`;
-    return this.http.getJson(path22, signal);
+    const path23 = version ? `/api/canvas/artifacts/${encodeURIComponent(kind)}/${encodeURIComponent(name)}/${encodeURIComponent(version)}` : `/api/canvas/artifacts/${encodeURIComponent(kind)}/${encodeURIComponent(name)}`;
+    return this.http.getJson(path23, signal);
   }
 };
 
@@ -3279,17 +3279,17 @@ async function mapWithConcurrency(items, limit, fn) {
 function isContainerObject(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
-function forEachString(value, visit, path22 = "") {
+function forEachString(value, visit, path23 = "") {
   if (typeof value === "string") {
-    visit(value, path22);
+    visit(value, path23);
     return;
   }
   if (Array.isArray(value)) {
-    for (let i = 0; i < value.length; i++) forEachString(value[i], visit, path22 ? `${path22}[${i}]` : `[${i}]`);
+    for (let i = 0; i < value.length; i++) forEachString(value[i], visit, path23 ? `${path23}[${i}]` : `[${i}]`);
     return;
   }
   if (isContainerObject(value)) {
-    for (const [k, v] of Object.entries(value)) forEachString(v, visit, path22 ? `${path22}.${k}` : k);
+    for (const [k, v] of Object.entries(value)) forEachString(v, visit, path23 ? `${path23}.${k}` : k);
   }
 }
 function forEachObject(value, visit) {
@@ -4282,6 +4282,7 @@ function nodesBeforeCheckpoint(graph, types, stopKinds) {
 }
 
 // src/engine/engine/validator.ts
+import path5 from "path";
 import { z as z5 } from "zod";
 
 // src/engine/lib/url.ts
@@ -5731,6 +5732,7 @@ async function validateCanvasDeep(input, registry) {
   const issues = [];
   const ctx = { canvas, registry, issues, idToIndex: buildIdToIndex(canvas) };
   const inputKindOf = (value) => staticInputKind(ctx, value);
+  const inputSourceOf = (value) => staticInputSource(ctx, value);
   for (let i = 0; i < canvas.nodes.length; i++) {
     const n = canvas.nodes[i];
     if (!n) continue;
@@ -5738,7 +5740,13 @@ async function validateCanvasDeep(input, registry) {
     if (!def?.validateExtra) continue;
     let extra;
     try {
-      extra = await def.validateExtra({ rawParams: n.params, rawInputs: n.inputs, nodeId: n.id, inputKindOf });
+      extra = await def.validateExtra({
+        rawParams: n.params,
+        rawInputs: n.inputs,
+        nodeId: n.id,
+        inputKindOf,
+        inputSourceOf
+      });
     } catch (e) {
       issues.push({
         path: `nodes[${i}].params`,
@@ -5933,6 +5941,18 @@ function staticInputKind(ctx, value) {
   const plain = outputSchema instanceof z5.ZodString || outputSchema instanceof z5.ZodNumber;
   return plain || outputSchema instanceof z5.ZodBoolean ? "value" : "unknown";
 }
+function staticInputSource(ctx, value) {
+  if (typeof value !== "string" || !value.startsWith(REF_PREFIX)) return void 0;
+  const target = refTarget(ctx, value);
+  if (!target || target.node.type !== "ingest" || target.expr.output !== "asset" || target.expr.index !== void 0)
+    return void 0;
+  const parsed = target.def.params.safeParse(target.node.params ?? {});
+  if (!parsed.success) return void 0;
+  const params = parsed.data;
+  if (params.source === "path" && typeof params.path === "string") return { path: path5.resolve(params.path) };
+  if (params.source === "url" && typeof params.url === "string") return { url: params.url };
+  return void 0;
+}
 function checkOneRef(ctx, n, i, refStr, jsonPath, field) {
   if (!refStr.startsWith(REF_PREFIX)) return;
   const expr = parseRefExpr(refStr);
@@ -6061,9 +6081,9 @@ function checkOutputRef(ctx) {
 function pushZodIssues(issues, err, pathPrefix, code, nodeId, nodeType) {
   for (const issue of err.issues) {
     const tail2 = pathToString(issue.path);
-    const path22 = pathPrefix ? tail2 ? `${pathPrefix}.${tail2}` : pathPrefix : tail2;
+    const path23 = pathPrefix ? tail2 ? `${pathPrefix}.${tail2}` : pathPrefix : tail2;
     issues.push({
-      path: path22,
+      path: path23,
       code,
       message: issue.message,
       received: issue.code === "invalid_type" ? issue.received : void 0,
@@ -6072,12 +6092,12 @@ function pushZodIssues(issues, err, pathPrefix, code, nodeId, nodeType) {
     });
   }
 }
-function pathToString(path22) {
-  return path22.map((p) => typeof p === "number" ? `[${p}]` : `.${String(p)}`).join("").replace(/^\./, "");
+function pathToString(path23) {
+  return path23.map((p) => typeof p === "number" ? `[${p}]` : `.${String(p)}`).join("").replace(/^\./, "");
 }
 function walkRefs(value, cb) {
-  forEachString(value, (s, path22) => {
-    if (s.startsWith(REF_PREFIX)) cb(s, path22);
+  forEachString(value, (s, path23) => {
+    if (s.startsWith(REF_PREFIX)) cb(s, path23);
   });
 }
 function listShapeKeys(schema) {
@@ -6623,7 +6643,7 @@ var NodeRegistry = class {
 import { execFile as execFileCb } from "child_process";
 import { mkdtemp, readFile as readFile5, rm, stat as stat2 } from "fs/promises";
 import { tmpdir } from "os";
-import path7 from "path";
+import path8 from "path";
 import { promisify } from "util";
 import { z as z6 } from "zod";
 
@@ -6944,11 +6964,11 @@ async function fetchExternalBytes(url, options) {
 // src/lib/ytDlp.ts
 import { spawn } from "child_process";
 import { readdir, readFile as readFile4 } from "fs/promises";
-import path6 from "path";
+import path7 from "path";
 
 // src/lib/vimeoCookie.ts
 import { writeFile as writeFile3 } from "fs/promises";
-import path5 from "path";
+import path6 from "path";
 var COOKIE_NAME = "vimeo";
 async function writeVimeoCookieFile(cookie, workDir) {
   const value = cookie?.trim();
@@ -6959,7 +6979,7 @@ async function writeVimeoCookieFile(cookie, workDir) {
     [".vimeo.com", "TRUE", "/", "TRUE", String(expires), COOKIE_NAME, value].join("	"),
     ""
   ].join("\n");
-  const filePath = path5.join(workDir, "vimeo-cookies.txt");
+  const filePath = path6.join(workDir, "vimeo-cookies.txt");
   await writeFile3(filePath, jar, { mode: 384 });
   return filePath;
 }
@@ -7023,8 +7043,8 @@ function tail(text, maxLines) {
   return text.split("\n").slice(-maxLines).join("\n");
 }
 async function runYtDlp(args) {
-  const outTemplate = path6.join(args.workDir, "out.%(ext)s");
-  const infoPath = path6.join(args.workDir, "out.info.json");
+  const outTemplate = path7.join(args.workDir, "out.%(ext)s");
+  const infoPath = path7.join(args.workDir, "out.info.json");
   const argv = [
     args.url,
     "--no-playlist",
@@ -7065,7 +7085,7 @@ async function runYtDlp(args) {
     info = JSON.parse(await readFile4(infoPath, "utf-8"));
   } catch {
   }
-  return { filePath: path6.join(args.workDir, downloaded), info, tier, reducedQuality };
+  return { filePath: path7.join(args.workDir, downloaded), info, tier, reducedQuality };
 }
 async function probeYtDlp(args) {
   const argv = [
@@ -7537,8 +7557,8 @@ function resolveLocalPath(input) {
       `ingest: ~ path expansion is not supported (got "${input}"). Use an absolute path or a cwd-relative path.`
     );
   }
-  if (path7.isAbsolute(input)) return input;
-  return path7.resolve(process.cwd(), input);
+  if (path8.isAbsolute(input)) return input;
+  return path8.resolve(process.cwd(), input);
 }
 var EXT_TO_MIME = {
   png: "image/png",
@@ -7586,7 +7606,7 @@ function sniffSvg(buf) {
   return head.startsWith("<?xml") ? head.includes("<svg") : head.startsWith("<svg");
 }
 function inferMimeFromPath(absPath, sniffBytes) {
-  const ext = path7.extname(absPath).slice(1).toLowerCase();
+  const ext = path8.extname(absPath).slice(1).toLowerCase();
   const fromExt = EXT_TO_MIME[ext];
   if (fromExt) return fromExt;
   const fromBytes = sniffImageMime(sniffBytes);
@@ -7823,7 +7843,7 @@ function localFileMetadata(args) {
     strategy: "local_file",
     ingested_at: (/* @__PURE__ */ new Date()).toISOString(),
     file_size: args.fileSize,
-    original_filename: path7.basename(args.absPath),
+    original_filename: path8.basename(args.absPath),
     ...args.rasterizedFrom ? { rasterized_from: args.rasterizedFrom } : {},
     ...args.durationMs !== void 0 ? { duration_ms: args.durationMs } : {}
   };
@@ -7845,7 +7865,7 @@ async function execYtDlp(params, ctx) {
   if (params.expect !== "video" && params.expect !== "audio") {
     throw new Error(`ingest: yt_dlp only handles video/audio, got expect=${params.expect}`);
   }
-  const workDir = await mkdtemp(path7.join(tmpdir(), "ingest-yt-"));
+  const workDir = await mkdtemp(path8.join(tmpdir(), "ingest-yt-"));
   try {
     const { filePath, info, reducedQuality } = await runYtDlpForNode({
       url: params.url,
@@ -7951,7 +7971,7 @@ import { z as z7 } from "zod";
 import { execFile as execFileCb2, spawn as spawn2 } from "child_process";
 import { copyFile as copyFile2, mkdtemp as mkdtemp2, readFile as readFile6, rm as rm2, stat as stat3 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
-import path8 from "path";
+import path9 from "path";
 import { promisify as promisify2 } from "util";
 var execFile2 = promisify2(execFileCb2);
 var DEFAULT_TIMEOUT_MS2 = 10 * 60 * 1e3;
@@ -7978,7 +7998,7 @@ function mimeForExt(ext) {
 }
 function extForAssetRef(ref) {
   if (ref.path) {
-    const e = path8.extname(ref.path);
+    const e = path9.extname(ref.path);
     if (e) return e;
   }
   const reverse = {
@@ -8000,14 +8020,14 @@ function planArrayInputSlot(tmpDir, slot, values, lookup, stagedInputs) {
     const ref = values[i];
     if (!ref) continue;
     if (!ref.path) throw new Error(`cli-runner: inputs.${slot}[${i}] has no local path`);
-    const dest = path8.join(tmpDir, `in_${slot}_${i}${extForAssetRef(ref)}`);
+    const dest = path9.join(tmpDir, `in_${slot}_${i}${extForAssetRef(ref)}`);
     stagedInputs.push({ srcPath: ref.path, destPath: dest });
     lookup.set(`in.${slot}.${i}`, dest);
   }
 }
 function planSingleInputSlot(tmpDir, slot, ref, lookup, stagedInputs) {
   if (!ref.path) throw new Error(`cli-runner: inputs.${slot} has no local path`);
-  const dest = path8.join(tmpDir, `in_${slot}${extForAssetRef(ref)}`);
+  const dest = path9.join(tmpDir, `in_${slot}${extForAssetRef(ref)}`);
   stagedInputs.push({ srcPath: ref.path, destPath: dest });
   lookup.set(`in.${slot}`, dest);
 }
@@ -8015,7 +8035,7 @@ function planOutputs(tmpDir, outputs, lookup) {
   const outputPaths = [];
   for (const [name, spec] of Object.entries(outputs)) {
     const ext = spec.ext.startsWith(".") ? spec.ext : `.${spec.ext}`;
-    const absPath = path8.join(tmpDir, `out_${name}${ext}`);
+    const absPath = path9.join(tmpDir, `out_${name}${ext}`);
     outputPaths.push({ name, absPath, spec });
     lookup.set(`out.${name}`, absPath);
   }
@@ -8056,8 +8076,8 @@ function rejectRawPaths(substituted, original, stagingDir) {
     throw new Error(`cli-runner: home-relative path "${original}" not allowed in args.`);
   }
   if (substituted.startsWith("/")) {
-    const resolved = path8.resolve(substituted);
-    if (!resolved.startsWith(`${stagingDir}${path8.sep}`) && resolved !== stagingDir) {
+    const resolved = path9.resolve(substituted);
+    if (!resolved.startsWith(`${stagingDir}${path9.sep}`) && resolved !== stagingDir) {
       throw new Error(
         `cli-runner: raw filesystem path "${original}" not allowed \u2014 declare an input slot and use {{in.<slot>}} instead.`
       );
@@ -8107,7 +8127,7 @@ function tailLines(text, maxLines) {
 }
 async function runCli(opts) {
   const { bin, args, inputs, outputs, ctx, timeoutMs = DEFAULT_TIMEOUT_MS2 } = opts;
-  const tmpDir = await mkdtemp2(path8.join(tmpdir2(), `cli-${bin.replace(/[^a-z0-9]/gi, "")}-`));
+  const tmpDir = await mkdtemp2(path9.join(tmpdir2(), `cli-${bin.replace(/[^a-z0-9]/gi, "")}-`));
   try {
     const { lookup, stagedInputs, outputPaths } = planPlaceholders(tmpDir, inputs, outputs);
     await stageInputs(stagedInputs);
@@ -8488,17 +8508,17 @@ var ffmpegNode = defineNode({
 import { mkdtemp as mkdtemp3, rm as rm3, writeFile as writeFile4 } from "fs/promises";
 import { createRequire } from "module";
 import { tmpdir as tmpdir3 } from "os";
-import path10 from "path";
+import path11 from "path";
 import { z as z11 } from "zod";
 
 // src/engine/nodes/local/lib/assets.ts
 import { copyFile as copyFile3, readFile as readFile7 } from "fs/promises";
-import path9 from "path";
+import path10 from "path";
 async function stageAsset(ref, destDir, filename) {
   if (!ref.path) {
     throw new Error(`stageAsset: ref (${ref.kind}/${ref.mime}) has no local path`);
   }
-  const dest = path9.join(destDir, filename);
+  const dest = path10.join(destDir, filename);
   await copyFile3(ref.path, dest);
   return dest;
 }
@@ -8575,11 +8595,11 @@ var fontSpecimenNode = defineNode({
   outputKinds: { image: "image" },
   cost: () => ({ credits: 0, seconds_estimate: 5 }),
   async execute({ inputs, params, ctx }) {
-    const tmp = await mkdtemp3(path10.join(tmpdir3(), "font-specimen-"));
+    const tmp = await mkdtemp3(path11.join(tmpdir3(), "font-specimen-"));
     try {
       const fontFilename = `font.${extForMime(inputs.font.mime)}`;
       await stageAsset(inputs.font, tmp, fontFilename);
-      const entryPath = path10.join(tmp, "index.html");
+      const entryPath = path11.join(tmp, "index.html");
       await writeFile4(entryPath, buildSpecimenHtml(params, fontFilename), "utf-8");
       ctx.log(`rendering specimen (${params.font_size}px, ${params.text.split("\n").length} lines)`);
       const pwSpecifier = ["play", "wright"].join("");
@@ -8663,15 +8683,15 @@ var fontSpecimenNode = defineNode({
 
 // src/engine/nodes/local/hyperframe.ts
 import { execFile as execFile4 } from "child_process";
-import { mkdtemp as mkdtemp5, readFile as readFile12, rm as rm5, stat as stat5, writeFile as writeFile7 } from "fs/promises";
+import { mkdtemp as mkdtemp5, readFile as readFile12, rm as rm5, stat as stat6, writeFile as writeFile7 } from "fs/promises";
 import { cpus, tmpdir as tmpdir5 } from "os";
-import path17 from "path";
+import path18 from "path";
 import { promisify as promisify4 } from "util";
 import { z as z13 } from "zod";
 
 // src/engine/engine/composition-hash.ts
 import { readdir as readdir2, readFile as readFile8, stat as stat4 } from "fs/promises";
-import path11 from "path";
+import path12 from "path";
 var SKIP_DIRS = /* @__PURE__ */ new Set([".cache", ".git", "node_modules", "dist", "build", ".next", ".turbo"]);
 function isSkippedName(name) {
   if (name.startsWith(".")) return true;
@@ -8688,7 +8708,7 @@ async function collectFiles(root, current) {
   const names = await readdir2(current);
   for (const name of names) {
     if (isSkippedName(name)) continue;
-    const abs = path11.join(current, name);
+    const abs = path12.join(current, name);
     const s = await stat4(abs);
     if (s.isDirectory()) {
       out.push(...await collectFiles(root, abs));
@@ -8696,7 +8716,7 @@ async function collectFiles(root, current) {
     }
     if (!s.isFile()) continue;
     const bytes = await readFile8(abs);
-    const relPath = path11.relative(root, abs).split(path11.sep).join("/");
+    const relPath = path12.relative(root, abs).split(path12.sep).join("/");
     out.push({ relPath, contentSha: sha256Hex(bytes) });
   }
   return out;
@@ -8704,7 +8724,7 @@ async function collectFiles(root, current) {
 
 // src/engine/engine/composition-meta.ts
 import { readFile as readFile9 } from "fs/promises";
-import path12 from "path";
+import path13 from "path";
 import { z as z12 } from "zod";
 var InputKind = z12.enum(["video", "image", "audio", "json", "font"]);
 var InputSpec = z12.object({
@@ -8781,7 +8801,7 @@ var CompositionMetaSchema = z12.object({
   params: z12.record(z12.string(), ParamSpec).default({})
 }).strict();
 async function loadCompositionMeta(compositionDir) {
-  const metaPath = path12.join(compositionDir, "meta.json");
+  const metaPath = path13.join(compositionDir, "meta.json");
   let raw;
   try {
     raw = await readFile9(metaPath, "utf-8");
@@ -8864,13 +8884,13 @@ function defaultFilenameForInput(key, kind) {
 // src/engine/nodes/local/lib/composition-stage.ts
 import { copyFile as copyFile4, cp } from "fs/promises";
 import { createRequire as createRequire2 } from "module";
-import path13 from "path";
+import path14 from "path";
 var require_2 = createRequire2(import.meta.url);
 async function copyComposition(srcDir, destDir) {
   await cp(srcDir, destDir, {
     recursive: true,
     filter: (src) => {
-      const name = path13.basename(src);
+      const name = path14.basename(src);
       if (name === ".cache" || name === "node_modules" || name === ".git") return false;
       return true;
     }
@@ -8879,21 +8899,21 @@ async function copyComposition(srcDir, destDir) {
 async function vendorGsap(dir, ctx) {
   try {
     const gsapMin = require_2.resolve("gsap/dist/gsap.min.js");
-    await copyFile4(gsapMin, path13.join(dir, "gsap.min.js"));
+    await copyFile4(gsapMin, path14.join(dir, "gsap.min.js"));
   } catch (e) {
     ctx.log(`warning: could not vendor gsap.min.js (${e.message}); compositions must self-supply`);
   }
 }
 
 // src/engine/nodes/local/lib/composition-static-check.ts
-import { mkdtemp as mkdtemp4, readFile as readFile11, rm as rm4, writeFile as writeFile6 } from "fs/promises";
+import { mkdtemp as mkdtemp4, readFile as readFile11, rm as rm4, stat as stat5, writeFile as writeFile6 } from "fs/promises";
 import { tmpdir as tmpdir4 } from "os";
-import path16 from "path";
+import path17 from "path";
 
 // src/engine/nodes/local/lib/hyperframe-check.ts
 import { execFile as execFile3 } from "child_process";
 import { readFile as readFile10 } from "fs/promises";
-import path14 from "path";
+import path15 from "path";
 import { promisify as promisify3 } from "util";
 
 // src/engine/nodes/local/lib/caption-style.ts
@@ -9076,6 +9096,13 @@ async function lintPreparedComposition(dir, timeoutMs) {
   const lintRaw = await runOne(buildLintArgsNoInstall(dir), timeoutMs);
   return lintRaw === null ? [] : lintBlockers(lintRaw);
 }
+function layoutBlockers(checkRaw) {
+  return classifyGateOutput(checkRaw).blocking.filter((f) => f.source === "layout").map((f) => ({ code: f.code, message: explainGateFinding(f) }));
+}
+async function checkPreparedLayout(dir, timeoutMs) {
+  const checkRaw = await runOne(["--no-install", ...buildCheckArgs(dir, 1)], timeoutMs);
+  return checkRaw === null ? [] : layoutBlockers(checkRaw);
+}
 function buildInspectArgs(dir, samples) {
   return ["hyperframes", "inspect", dir, "--json", "--samples", String(samples)];
 }
@@ -9116,7 +9143,7 @@ async function runSnapshotSmoke(args, timeoutMs) {
 }
 async function runNestedCompositionSmoke(opts) {
   const { dir, nodeId, ctx, timeoutMs, samples } = opts;
-  const indexHtml = await readFile10(path14.join(dir, "index.html"), "utf-8").catch(() => "");
+  const indexHtml = await readFile10(path15.join(dir, "index.html"), "utf-8").catch(() => "");
   if (!indexHtml || !usesNestedCompositions(indexHtml)) return;
   const snap = await runSnapshotSmoke(
     buildSnapshotArgs(dir, Math.min(samples, 3), hasFrameVisionKey()),
@@ -9132,7 +9159,7 @@ async function runNestedCompositionSmoke(opts) {
 ${snap.message}`
     );
   }
-  const described = await readFile10(path14.join(dir, "snapshots", "descriptions.md"), "utf-8").catch(() => "");
+  const described = await readFile10(path15.join(dir, "snapshots", "descriptions.md"), "utf-8").catch(() => "");
   for (const line of condenseFrameDescriptions(described)) {
     ctx.log(`${nodeId}: frame check \u2014 ${line}`);
   }
@@ -9168,7 +9195,7 @@ async function runHyperframesCheck(opts) {
 ${detail}`
     );
   }
-  const composition = await readFile10(path14.join(dir, "index.html"), "utf-8").catch(() => "");
+  const composition = await readFile10(path15.join(dir, "index.html"), "utf-8").catch(() => "");
   const captionComplaint = fragmentedCaptions(captionTextsFrom(composition));
   if (captionComplaint) {
     ctx.log(`${nodeId}: caption style \u2014 ${captionComplaint}`);
@@ -9179,9 +9206,9 @@ ${detail}`
 
 // src/engine/nodes/local/lib/hyperframe-meta.ts
 import { writeFile as writeFile5 } from "fs/promises";
-import path15 from "path";
+import path16 from "path";
 async function ensureHyperframesMetaJson(tmp, nodeId, meta, duration) {
-  const metaPath = path15.join(tmp, "meta.json");
+  const metaPath = path16.join(tmp, "meta.json");
   await writeFile5(
     metaPath,
     JSON.stringify(
@@ -9244,11 +9271,11 @@ function extractReferencedTokens(source) {
 
 // src/engine/nodes/local/lib/composition-static-check.ts
 async function staticCompositionIssues(args) {
-  const html = await readFile11(path16.join(args.dir, "index.html"), "utf-8").catch(() => null);
+  const html = await readFile11(path17.join(args.dir, "index.html"), "utf-8").catch(() => null);
   const issues = inputIssues(args.meta, args.rawInputs, args.inputKindOf);
   if (html === null) return issues;
   issues.push(...undefinedVariableIssues(html, args.meta, args.compositionParams));
-  issues.push(...await lintIssues(args));
+  issues.push(...await gateIssues(args));
   return issues;
 }
 function substitutionValues(meta, compositionParams) {
@@ -9312,33 +9339,91 @@ function kindMismatch(expected, got) {
   if (got === "value") return "got a plain value, not an asset";
   return `got "${got}"`;
 }
-async function lintIssues(args) {
+async function gateIssues(args) {
   if (!await isHyperframesAvailable()) return [];
-  const tmp = await mkdtemp4(path16.join(tmpdir4(), "hf-validate-"));
+  const tmp = await mkdtemp4(path17.join(tmpdir4(), "hf-validate-"));
   try {
-    await copyComposition(args.dir, tmp);
-    await vendorGsap(tmp, { log: () => void 0 });
-    await stagePlaceholderInputs(tmp, args.meta, args.rawInputs);
-    const entry = path16.join(tmp, "index.html");
-    const html = await readFile11(entry, "utf-8");
-    await writeFile6(entry, substituteVariables(html, substitutionValues(args.meta, args.compositionParams)).output);
-    await ensureHyperframesMetaJson(tmp, args.nodeId ?? args.meta.id, args.meta, args.meta.default_duration);
-    const blockers = await lintPreparedComposition(tmp, args.lintTimeoutMs);
-    return blockers.map((b) => ({
-      path: "params.composition",
-      message: `pre-render gate would fail: [${b.code}] ${b.message}`
-    }));
+    const { faithful } = await prepareForGate(tmp, args);
+    const lint = await lintPreparedComposition(tmp, args.lintTimeoutMs);
+    const layout = args.checkLayout && faithful ? await checkPreparedLayout(tmp, LAYOUT_CHECK_TIMEOUT_MS) : [];
+    return [
+      ...lint.map((b) => ({
+        path: "params.composition",
+        message: `pre-render gate would fail: [${b.code}] ${b.message}`
+      })),
+      ...layout.map((b) => ({
+        path: "params.composition",
+        message: `pre-render gate would fail: [layout/${b.code}] ${b.message} Nothing was rendered or billed.`
+      }))
+    ];
   } finally {
     await rm4(tmp, { recursive: true, force: true }).catch(() => void 0);
   }
 }
-async function stagePlaceholderInputs(dir, meta, rawInputs) {
-  const inputs = rawInputs && typeof rawInputs === "object" ? rawInputs : {};
-  for (const [key, spec] of Object.entries(meta.inputs)) {
-    if (!Object.hasOwn(inputs, key)) continue;
-    const filename = spec.staged_as ?? defaultFilenameForInput(key, spec.kind);
-    await writeFile6(path16.join(dir, filename), spec.kind === "json" ? "{}" : "");
+var LAYOUT_CHECK_TIMEOUT_MS = 6e4;
+var MAX_INPUT_BYTES = 20 * 1024 * 1024;
+var STAND_IN_PICTURE = Buffer.from(
+  "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
+  "base64"
+);
+async function readSource(source) {
+  try {
+    if ("path" in source) {
+      const info = await stat5(source.path);
+      return info.isFile() && info.size <= MAX_INPUT_BYTES ? await readFile11(source.path) : null;
+    }
+    return (await fetchExternalBytes(source.url, { maxBytes: MAX_INPUT_BYTES, timeoutMs: 15e3 })).buffer;
+  } catch {
+    return null;
+  }
+}
+function standIn(kind) {
+  if (kind === "image") return STAND_IN_PICTURE;
+  return kind === "json" ? "{}" : "";
+}
+async function prepareForGate(target, args) {
+  await copyComposition(args.dir, target);
+  await vendorGsap(target, { log: () => void 0 });
+  const staged = await stageGateInputs(target, args);
+  const filled = fillParamSlots(args.meta, args.compositionParams, staged.slotTexts);
+  const entry = path17.join(target, "index.html");
+  const html = await readFile11(entry, "utf-8");
+  await writeFile6(entry, substituteVariables(html, substitutionValues(args.meta, filled.params)).output);
+  await ensureHyperframesMetaJson(target, args.meta.id, args.meta, args.meta.default_duration);
+  return { faithful: staged.faithful && filled.faithful };
+}
+async function stageGateInputs(target, args) {
+  const inputs = args.rawInputs && typeof args.rawInputs === "object" ? args.rawInputs : {};
+  const wired = Object.entries(args.meta.inputs).filter(([key]) => Object.hasOwn(inputs, key));
+  const staged = await Promise.all(
+    wired.map(async ([key, spec]) => {
+      const filename = path17.join(target, spec.staged_as ?? defaultFilenameForInput(key, spec.kind));
+      const source = args.inputSourceOf?.(inputs[key]);
+      const bytes = source ? await readSource(source) : null;
+      await writeFile6(filename, bytes ?? standIn(spec.kind));
+      const faithful = bytes !== null || !source && spec.kind === "image";
+      return { key, faithful, text: bytes && spec.kind === "json" ? bytes.toString("utf8") : null };
+    })
+  );
+  const slotTexts = {};
+  for (const { key, text } of staged) if (text !== null) slotTexts[key] = text;
+  return { faithful: staged.every((s) => s.faithful), slotTexts };
+}
+function fillParamSlots(meta, compositionParams, slotTexts) {
+  let faithful = true;
+  const params = {};
+  for (const [name, value] of Object.entries(compositionParams)) {
+    const slots = typeof value === "string" ? extractReferencedTokens(value) : [];
+    if (typeof value !== "string" || slots.length === 0) {
+      params[name] = value;
+    } else if (slots.every((slot) => Object.hasOwn(slotTexts, slot))) {
+      params[name] = renderTemplate(value, slotTexts);
+    } else {
+      faithful = false;
+      params[name] = placeholderFor(meta.params[name]?.kind);
+    }
   }
+  return { faithful, params };
 }
 
 // src/engine/nodes/local/lib/hyperframe-errors.ts
@@ -9430,7 +9515,7 @@ var hyperframeRenderNode = defineNode({
     const compositionDir = await resolveCompositionDir(params.composition);
     const meta = await loadCompositionMeta(compositionDir);
     const compositionParams = validateAndParseDynamicParams(meta, params);
-    const tmp = await mkdtemp5(path17.join(tmpdir5(), "hf-render-"));
+    const tmp = await mkdtemp5(path18.join(tmpdir5(), "hf-render-"));
     try {
       await copyComposition(compositionDir, tmp);
       await vendorGsap(tmp, ctx);
@@ -9440,7 +9525,7 @@ var hyperframeRenderNode = defineNode({
       await substituteCompositionFiles(tmp, substitutionValues2);
       await ensureHyperframesMetaJson(tmp, ctx.nodeId, meta, duration);
       await runHyperframesCheck({ dir: tmp, nodeId: "hyperframe_render", ctx, timeoutMs: params.timeout_ms });
-      const outputPath = path17.join(tmp, `output.${params.format}`);
+      const outputPath = path18.join(tmp, `output.${params.format}`);
       await runRender({ tmp, outputPath, params, meta, ctx });
       const bytes = await readFile12(outputPath);
       ctx.log(`rendered ${bytes.length} bytes`);
@@ -9464,12 +9549,12 @@ var hyperframeRenderNode = defineNode({
   }
 });
 async function resolveCompositionDir(composition) {
-  const compositionPath = path17.isAbsolute(composition) ? composition : path17.resolve(process.cwd(), composition);
-  const s = await stat5(compositionPath);
+  const compositionPath = path18.isAbsolute(composition) ? composition : path18.resolve(process.cwd(), composition);
+  const s = await stat6(compositionPath);
   if (s.isDirectory()) return compositionPath;
-  return path17.dirname(compositionPath);
+  return path18.dirname(compositionPath);
 }
-async function validateCompositionNode(args, ownedKeys) {
+async function validateCompositionNode(args, ownedKeys, options = {}) {
   const issues = await validateCompositionParams(args.rawParams, ownedKeys);
   const params = args.rawParams ?? {};
   if (typeof params.composition !== "string") return issues;
@@ -9485,7 +9570,9 @@ async function validateCompositionNode(args, ownedKeys) {
       compositionParams,
       rawInputs: args.rawInputs,
       inputKindOf: args.inputKindOf,
-      lintTimeoutMs: 2e4
+      inputSourceOf: args.inputSourceOf,
+      lintTimeoutMs: 2e4,
+      checkLayout: options.checkLayout
     })
   );
   return issues;
@@ -9560,7 +9647,7 @@ async function stageInputs2(tmp, inputs, meta, ctx) {
     await stageAsset(ref, tmp, filename);
     ctx.log(`staged ${spec.kind} \u2192 ${filename}`);
     if (spec.kind === "video" && primaryDuration === null) {
-      primaryDuration = await probeDurationSeconds(path17.join(tmp, filename));
+      primaryDuration = await probeDurationSeconds(path18.join(tmp, filename));
     }
   }
   return primaryDuration;
@@ -9606,7 +9693,7 @@ function coerceImageParam(value) {
   throw new Error("hyperframe_render: image param must be a URL string or AssetRef");
 }
 async function substituteCompositionFiles(tmp, values) {
-  const entryPath = path17.join(tmp, "index.html");
+  const entryPath = path18.join(tmp, "index.html");
   const original = await readFile12(entryPath, "utf-8");
   const { output, missing } = substituteVariables(original, values);
   if (missing.length > 0) {
@@ -9623,7 +9710,7 @@ function workerCount() {
 async function runRender(opts) {
   const { tmp, outputPath, params, meta, ctx } = opts;
   const args = buildRenderArgs(tmp, outputPath, meta, params.format);
-  ctx.log(`rendering ${meta.width}x${meta.height}@${meta.fps}fps ${params.format} from ${path17.basename(tmp)}`);
+  ctx.log(`rendering ${meta.width}x${meta.height}@${meta.fps}fps ${params.format} from ${path18.basename(tmp)}`);
   try {
     await execFileAsync2("npx", args, { timeout: params.timeout_ms, maxBuffer: 64 * 1024 * 1024 });
   } catch (e) {
@@ -9670,7 +9757,7 @@ import { execFile as execFile5 } from "child_process";
 import { mkdtemp as mkdtemp6, readFile as readFile13, rm as rm6, writeFile as writeFile8 } from "fs/promises";
 import { createRequire as createRequire3 } from "module";
 import { tmpdir as tmpdir6 } from "os";
-import path18 from "path";
+import path19 from "path";
 import { promisify as promisify5 } from "util";
 import { z as z14 } from "zod";
 var _execFileAsync = promisify5(execFile5);
@@ -9705,7 +9792,9 @@ var hyperframeSnapshotNode = defineNode({
   cost: () => ({ credits: 0, seconds_estimate: 3 }),
   // The snapshot's own keys (`wait_for`) are not composition params: checked against the
   // render node's key set, a canvas that waited on a selector failed validate every time.
-  validateExtra: (args) => validateCompositionNode(args, NODE_OWNED_PARAM_KEYS2),
+  // A still has one frame and its copy is known before the run, so validate lays it out
+  // and refuses colliding lines before a single picture is paid for.
+  validateExtra: (args) => validateCompositionNode(args, NODE_OWNED_PARAM_KEYS2, { checkLayout: true }),
   cacheKeyExtras: async ({ params }) => {
     const out = {};
     const composition = params.composition;
@@ -9719,7 +9808,7 @@ var hyperframeSnapshotNode = defineNode({
     const compositionDir = await resolveCompositionDir(params.composition);
     const meta = await loadCompositionMeta(compositionDir);
     const compositionParams = validateAndParseDynamicParams2(meta, params);
-    const tmp = await mkdtemp6(path18.join(tmpdir6(), "hf-snap-"));
+    const tmp = await mkdtemp6(path19.join(tmpdir6(), "hf-snap-"));
     try {
       await copyComposition(compositionDir, tmp);
       await vendorGsap(tmp, ctx);
@@ -9734,7 +9823,7 @@ var hyperframeSnapshotNode = defineNode({
         timeoutMs: params.timeout_ms,
         samples: 1
       });
-      const entryPath = path18.join(tmp, "index.html");
+      const entryPath = path19.join(tmp, "index.html");
       const entryUrl = `file://${entryPath}`;
       ctx.log(`snapshotting ${meta.width}x${meta.height}@${DEVICE_SCALE_FACTOR2}x wait=${params.wait_for.kind}`);
       const pwSpecifier = ["play", "wright"].join("");
@@ -9819,7 +9908,7 @@ function coerceImageParam2(value) {
   throw new Error("hyperframe_snapshot: image param must be a URL string or AssetRef");
 }
 async function substituteCompositionFiles2(tmp, values) {
-  const entryPath = path18.join(tmp, "index.html");
+  const entryPath = path19.join(tmp, "index.html");
   const original = await readFile13(entryPath, "utf-8");
   const { output, missing } = substituteVariables(original, values);
   if (missing.length > 0) {
@@ -10833,7 +10922,7 @@ var videoLipsyncNode = delegated({
 // src/engine/nodes/remote/videoTranscribe.ts
 import { mkdtemp as mkdtemp7, readFile as readFile14, rm as rm7 } from "fs/promises";
 import { tmpdir as tmpdir7 } from "os";
-import path19 from "path";
+import path20 from "path";
 import { z as z37 } from "zod";
 
 // src/engine/nodes/local/lib/ffmpeg.ts
@@ -11161,8 +11250,8 @@ async function tryExtractAudio(inputs, ctx) {
       ctx.log("video_transcribe: no audio track detected, sending full video");
       return null;
     }
-    tmpDir = await mkdtemp7(path19.join(tmpdir7(), "vtx-"));
-    const audioPath = path19.join(tmpDir, "audio.mp3");
+    tmpDir = await mkdtemp7(path20.join(tmpdir7(), "vtx-"));
+    const audioPath = path20.join(tmpDir, "audio.mp3");
     ctx.log("video_transcribe: extracting audio (mono 16kHz mp3)");
     await runFfmpeg(
       ["-i", video.path, "-vn", "-ac", "1", "-ar", "16000", "-b:a", "64k", "-f", "mp3", "-y", audioPath],
@@ -11360,14 +11449,14 @@ function catalogCost(def) {
 // src/engine/storage/cache-store.ts
 import { randomUUID as randomUUID2 } from "crypto";
 import { mkdir as mkdir3, readFile as readFile15, rename as rename2, writeFile as writeFile9 } from "fs/promises";
-import path20 from "path";
+import path21 from "path";
 var LocalCacheStore = class {
   rootDir;
   constructor(rootDir) {
     this.rootDir = rootDir;
   }
   filePath(cacheKey) {
-    return path20.join(this.rootDir, `${cacheKey}.json`);
+    return path21.join(this.rootDir, `${cacheKey}.json`);
   }
   async get(cacheKey) {
     try {
@@ -11380,7 +11469,7 @@ var LocalCacheStore = class {
   }
   async put(entry) {
     const dest = this.filePath(entry.cacheKey);
-    await mkdir3(path20.dirname(dest), { recursive: true });
+    await mkdir3(path21.dirname(dest), { recursive: true });
     const tmp = `${dest}.tmp-${process.pid}-${randomUUID2()}`;
     await writeFile9(tmp, JSON.stringify(entry, null, 0));
     await rename2(tmp, dest);
@@ -11438,12 +11527,12 @@ function defaultRegistry() {
 }
 function createEngineFromEnv(opts = {}) {
   const cwd = opts.cwd ?? process.cwd();
-  const cacheDir = opts.cacheDir ?? path21.join(cwd, "canvas", ".cache");
-  const outputsDir = opts.outputsDir ?? path21.join(cwd, "canvas");
+  const cacheDir = opts.cacheDir ?? path22.join(cwd, "canvas", ".cache");
+  const outputsDir = opts.outputsDir ?? path22.join(cwd, "canvas");
   const connection = requireConnection();
   const client = new BackendClient({ baseUrl: connection.BAKER_API_URL, apiKey: connection.BAKER_API_KEY });
-  const assets = new LocalAssetStore(path21.join(cacheDir, "assets"));
-  const localCache = new LocalCacheStore(path21.join(cacheDir, "index"));
+  const assets = new LocalAssetStore(path22.join(cacheDir, "assets"));
+  const localCache = new LocalCacheStore(path22.join(cacheDir, "index"));
   const remoteCacheEnabled = opts.remoteCache ?? remoteCacheEnabledFromEnv();
   const cache = remoteCacheEnabled ? new LayeredCacheStore({
     local: localCache,
@@ -11565,4 +11654,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-UW62VPTH.js.map
+//# sourceMappingURL=chunk-U4OKU5EF.js.map