@vosjs/cli 0.16.0 → 0.17.0

package/dist/{chunk-PKHORUJ2.js → chunk-Q5NF5EN2.js}

@@ -6,9 +6,9 @@ import {
 } from "./chunk-NHKHTIDR.js";
 
 // src/plugin/run.ts
-import { mkdir as mkdir8, readFile as readFile12, rm as rm4 } from "fs/promises";
-import { existsSync as existsSync12 } from "fs";
-import { join as join15, resolve as resolve7 } from "path";
+import { mkdir as mkdir9, readFile as readFile13, rm as rm4 } from "fs/promises";
+import { existsSync as existsSync13 } from "fs";
+import { join as join16, resolve as resolve8 } from "path";
 import { totalDuration as totalDuration2 } from "@vosjs/timeline";
 import { migrateHostedDoc as migrateHostedDoc4, ratedSegments as ratedSegments6 } from "@vosjs/studio-core";
 
@@ -1279,6 +1279,11 @@ var MIME = {
   ".json": "application/json",
   ".jpg": "image/jpeg",
   ".png": "image/png",
+  // A brand mark or an image overlay: an <img> refuses an SVG served as an
+  // octet stream, so the kinds a doc can key are named.
+  ".svg": "image/svg+xml",
+  ".webp": "image/webp",
+  ".gif": "image/gif",
   ".webm": "video/webm",
   ".mp4": "video/mp4",
   // Take-dir audio (doc.audio keys like "/music.mp3") — decode goes through
@@ -1347,10 +1352,10 @@ function startTakeServer(rootDir, pages) {
     res.writeHead(404).end();
   });
   return new Promise(
-    (resolve8) => server.listen(0, () => {
+    (resolve9) => server.listen(0, () => {
       const addr = server.address();
       const port = typeof addr === "object" && addr ? addr.port : 0;
-      resolve8({ base: `http://localhost:${port}`, close: () => server.close() });
+      resolve9({ base: `http://localhost:${port}`, close: () => server.close() });
     })
   );
 }
@@ -2613,12 +2618,12 @@ async function writeIndexJson(result) {
 }
 
 // src/plugin/deliver.ts
-import { mkdir as mkdir4, mkdtemp, rename as rename4, rm as rm3, stat, writeFile as writeFile6 } from "fs/promises";
+import { mkdir as mkdir5, mkdtemp, rename as rename4, rm as rm3, stat, writeFile as writeFile7 } from "fs/promises";
 import { tmpdir } from "os";
-import { join as join5, relative, resolve as resolve3 } from "path";
+import { join as join6, relative, resolve as resolve4 } from "path";
 import { totalDuration } from "@vosjs/timeline";
-import { existsSync as existsSync5 } from "fs";
-import { readFile as readFile5 } from "fs/promises";
+import { existsSync as existsSync6 } from "fs";
+import { readFile as readFile6 } from "fs/promises";
 import { parseFrontmatter } from "@vosjs/shared/frontmatter";
 import {
   CHANNEL_SPECS_VERIFIED,
@@ -4096,7 +4101,7 @@ function stageSplitCover(input) {
   const column = portrait || square ? 0.84 : 0.36;
   const left = portrait || square ? 0.08 : 0.07;
   const size = portrait ? 60 : square ? 68 : 84;
-  const word = (id, text, preset, family, px, y, color, extra, role) => {
+  const word = (id, text, preset, family, px, y, color, extra, role, x0 = left) => {
     if (!text) return;
     const lines = text.split("\n");
     const longest = Math.max(...lines.map((l) => l.length));
@@ -4117,7 +4122,7 @@ function stageSplitCover(input) {
       align: "left",
       maxWidth: column,
       lineHeight: lh,
-      transform: { x: left + widest / 2, y, scale: 1, rotation: 0 },
+      transform: { x: x0 + widest / 2, y, scale: 1, rotation: 0 },
       // Words on the ground carry no footage shadow: a drop shadow under a
       // headline on a plate is the old-web tell.
       shadow: 0,
@@ -4128,7 +4133,7 @@ function stageSplitCover(input) {
       ...extra
     });
     boxes.push({
-      x: left,
+      x: x0,
       y: y - h / 2,
       w: widest,
       h,
@@ -4137,6 +4142,28 @@ function stageSplitCover(input) {
       label: text.length > 24 ? `${text.slice(0, 24)}\u2026` : text
     });
   };
+  const markKey = str(v.logoKey, "");
+  const markAspect = typeof v.logoAspect === "number" && v.logoAspect > 0 ? v.logoAspect : 1;
+  const wideMark = !!markKey && markAspect > 2.2;
+  const lockup = (px, y) => {
+    if (!markKey) return left;
+    const hPx = wideMark ? px * 1.6 : px * 1.3;
+    const w = Math.min(column, hPx * markAspect / designW);
+    clips.push({
+      id: "stage-mark",
+      kind: "image",
+      key: markKey,
+      width: +w.toFixed(4),
+      radius: 0,
+      shadow: "none",
+      transform: { x: left + w / 2, y, scale: 1, rotation: 0 },
+      start: 0,
+      duration: +input.outputSeconds.toFixed(3),
+      enter: "none",
+      exit: "none"
+    });
+    return left + w + px * 0.5 / designW;
+  };
   const kickerY = portrait ? 0.1 : square ? 0.12 : 0.24;
   const titleY = portrait ? 0.24 : square ? 0.28 : 0.46;
   const brandY = portrait ? 0.94 : square ? 0.94 : 0.86;
@@ -4162,17 +4189,20 @@ function stageSplitCover(input) {
     { weight: 600, letterSpacing: -Math.round(size * 0.02) },
     "headline"
   );
-  word(
-    "stage-brand",
-    brand,
-    "label",
-    body,
-    25,
-    brandY,
-    ink,
-    { weight: 700, letterSpacing: 1 },
-    "body"
-  );
+  const brandX = lockup(25, brandY);
+  if (!wideMark)
+    word(
+      "stage-brand",
+      brand,
+      "label",
+      body,
+      25,
+      brandY,
+      ink,
+      { weight: 700, letterSpacing: 1 },
+      "body",
+      brandX
+    );
   set.push(`overlays=${JSON.stringify(clips)}`);
   return { set, text: boxes, shot };
 }
@@ -4252,7 +4282,32 @@ function stageTile(input) {
     exit: "none"
   };
   if (wordless) {
-    set.push("overlays=[]");
+    const markKey = str(v.logoKey, "");
+    const markAspect = typeof v.logoAspect === "number" && v.logoAspect > 0 ? v.logoAspect : 1;
+    if (markKey) {
+      const hFrac = top * 0.5;
+      const w = Math.min(
+        0.8,
+        hFrac * input.size.h * markAspect / input.size.w
+      );
+      set.push(
+        `overlays=${JSON.stringify([
+          {
+            id: "stage-mark",
+            kind: "image",
+            key: markKey,
+            width: +w.toFixed(4),
+            radius: 0,
+            shadow: "none",
+            transform: { x: left + w / 2, y: top / 2, scale: 1, rotation: 0 },
+            start: 0,
+            duration: +input.outputSeconds.toFixed(3),
+            enter: "none",
+            exit: "none"
+          }
+        ])}`
+      );
+    } else set.push("overlays=[]");
     return { set, text: [], shot };
   }
   set.push(`overlays=${JSON.stringify([clip])}`);
@@ -4270,6 +4325,116 @@ function stageTile(input) {
   return { set, text, shot };
 }
 
+// src/plugin/markAsset.ts
+import { mkdir as mkdir4, readFile as readFile5, writeFile as writeFile6 } from "fs/promises";
+import { existsSync as existsSync5 } from "fs";
+import { isAbsolute, join as join5, resolve as resolve3 } from "path";
+function markExtension(url) {
+  const m = /\.(svg|png|webp|jpe?g)(?:[?#]|$)/i.exec(url);
+  if (!m) return null;
+  const e = m[1].toLowerCase();
+  return e === "jpeg" ? "jpg" : e;
+}
+function imageAspect(bytes, ext) {
+  if (ext === "svg") {
+    const head = new TextDecoder().decode(bytes.subarray(0, 4096));
+    const vb = /viewBox\s*=\s*["']\s*[-\d.]+[\s,]+[-\d.]+[\s,]+([\d.]+)[\s,]+([\d.]+)/i.exec(
+      head
+    );
+    if (vb) return ratio(+vb[1], +vb[2]);
+    const w = /<svg[^>]*\swidth\s*=\s*["']([\d.]+)/i.exec(head);
+    const h = /<svg[^>]*\sheight\s*=\s*["']([\d.]+)/i.exec(head);
+    if (w && h) return ratio(+w[1], +h[1]);
+    return null;
+  }
+  const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  if (ext === "png") {
+    if (bytes.length < 24 || bytes[0] !== 137 || bytes[1] !== 80) return null;
+    return ratio(dv.getUint32(16), dv.getUint32(20));
+  }
+  if (ext === "webp") {
+    if (bytes.length < 30) return null;
+    const tag = String.fromCharCode(...bytes.subarray(12, 16));
+    if (tag === "VP8X")
+      return ratio(
+        1 + (dv.getUint32(24, true) & 16777215),
+        1 + (dv.getUint32(27, true) & 16777215)
+      );
+    if (tag === "VP8L") {
+      const b = dv.getUint32(21, true);
+      return ratio(1 + (b & 16383), 1 + (b >> 14 & 16383));
+    }
+    if (tag === "VP8 ")
+      return ratio(
+        dv.getUint16(26, true) & 16383,
+        dv.getUint16(28, true) & 16383
+      );
+    return null;
+  }
+  if (ext === "jpg") {
+    let i = 2;
+    while (i + 9 < bytes.length) {
+      if (bytes[i] !== 255) return null;
+      const marker = bytes[i + 1];
+      const len = dv.getUint16(i + 2);
+      if (marker >= 192 && marker <= 207 && marker !== 196 && marker !== 200 && marker !== 204) {
+        return ratio(dv.getUint16(i + 7), dv.getUint16(i + 5));
+      }
+      i += 2 + len;
+    }
+    return null;
+  }
+  return null;
+}
+function ratio(w, h) {
+  return w > 0 && h > 0 ? w / h : null;
+}
+async function fetchBrandMarks(takeDir, roles) {
+  const out = { light: null, dark: null, notes: [] };
+  if (!roles) return out;
+  const one = async (role, name) => {
+    const src = (roles[role] ?? "").trim();
+    if (!src) return null;
+    const ext = markExtension(src);
+    if (!ext) {
+      out.notes.push(
+        `${role}: ${src} is not an svg, png, webp or jpg; the wordmark stands in`
+      );
+      return null;
+    }
+    let bytes;
+    try {
+      if (/^https?:/i.test(src)) {
+        const res = await fetch(src);
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        bytes = new Uint8Array(await res.arrayBuffer());
+      } else {
+        const file = isAbsolute(src) ? src : resolve3(takeDir, src);
+        if (!existsSync5(file)) throw new Error("no such file");
+        bytes = new Uint8Array(await readFile5(file));
+      }
+    } catch (e) {
+      out.notes.push(
+        `${role}: ${src} could not be read (${e instanceof Error ? e.message : String(e)}); the wordmark stands in`
+      );
+      return null;
+    }
+    const aspect = imageAspect(bytes, ext);
+    if (!aspect) {
+      out.notes.push(
+        `${role}: ${src} has no readable size; the wordmark stands in`
+      );
+      return null;
+    }
+    await mkdir4(join5(takeDir, "brand"), { recursive: true });
+    await writeFile6(join5(takeDir, "brand", `${name}.${ext}`), bytes);
+    return { key: `/brand/${name}.${ext}`, aspect };
+  };
+  out.light = await one("logoUrl", "mark");
+  out.dark = await one("logoOnDarkUrl", "mark-on-dark");
+  return out;
+}
+
 // src/plugin/motionPlan.ts
 import { ratedSegments as ratedSegments4, spanOutputExtent as spanOutputExtent4 } from "@vosjs/studio-core";
 var SOUND_DESTINATIONS = /* @__PURE__ */ new Set([
@@ -4325,10 +4490,13 @@ function planMotion(input) {
       if (headline) card.headline = headline;
       if (sub && sub !== headline) card.sub = sub;
       if (brand) card.wordmark = brand;
+      if (input.mark) card.mark = input.mark;
       set.push(`endCard=${JSON.stringify(card)}`);
       notes.push("end card");
     } else {
-      skipped.push(`${d.id}: no end card (no headline or wordmark in LAUNCH.md, BRAND.md or the flags)`);
+      skipped.push(
+        `${d.id}: no end card (no headline or wordmark in LAUNCH.md, BRAND.md or the flags)`
+      );
     }
   }
   if (!loop && d.text !== "none" && input.captions.length && !off(launch.captions)) {
@@ -4336,7 +4504,9 @@ function planMotion(input) {
     const steps = doc.source.meta.steps ?? [];
     const clips = [];
     for (const c of input.captions) {
-      const step = steps.find((s) => c.id !== void 0 && s.id === c.id || s.step === c.step);
+      const step = steps.find(
+        (s) => c.id !== void 0 && s.id === c.id || s.step === c.step
+      );
       if (!step || step.skipped) continue;
       const t = stepOutputTime(rated, step, 0.2);
       if (t === null || t < range[0] || t > range[1] - 1) continue;
@@ -4384,7 +4554,9 @@ function planMotion(input) {
       });
       notes.push(`bed ${track.slug}`);
     } else if (launch.music && !off(launch.music)) {
-      skipped.push(`${d.id}: music "${launch.music}" is not a catalog track or mood${catalog ? "" : " (the catalog could not be read)"}`);
+      skipped.push(
+        `${d.id}: music "${launch.music}" is not a catalog track or mood${catalog ? "" : " (the catalog could not be read)"}`
+      );
     }
     const click = catalog?.sfx.find((s) => s.slug === "sfx-click");
     if (click && !doc.source.micKey && !off(launch.clicks)) {
@@ -4444,19 +4616,19 @@ function resolveChannels(raw) {
   return out;
 }
 async function readBrandBesideTake(dir, explicit) {
-  const candidates = explicit ? [explicit] : [join5(dir, "BRAND.md"), join5(dir, "..", "BRAND.md")];
+  const candidates = explicit ? [explicit] : [join6(dir, "BRAND.md"), join6(dir, "..", "BRAND.md")];
   for (const file of candidates) {
-    if (!existsSync5(file)) continue;
-    const roles = parseFrontmatter(await readFile5(file, "utf8"));
+    if (!existsSync6(file)) continue;
+    const roles = parseFrontmatter(await readFile6(file, "utf8"));
     return { file, roles };
   }
   return null;
 }
 async function readLaunchBesideTake(dir, explicit) {
-  const candidates = explicit ? [explicit] : [join5(dir, "LAUNCH.md"), join5(dir, "..", "LAUNCH.md")];
+  const candidates = explicit ? [explicit] : [join6(dir, "LAUNCH.md"), join6(dir, "..", "LAUNCH.md")];
   for (const file of candidates) {
-    if (!existsSync5(file)) continue;
-    return { file, roles: parseFrontmatter(await readFile5(file, "utf8")) };
+    if (!existsSync6(file)) continue;
+    return { file, roles: parseFrontmatter(await readFile6(file, "utf8")) };
   }
   return null;
 }
@@ -4559,7 +4731,7 @@ async function pickStillTimes(browser, dir, doc, duration, opts) {
   const meta = doc.source.meta;
   const vw = meta.captureWidth ?? meta.width;
   const vh = meta.captureHeight ?? meta.height;
-  const probeDir = await mkdtemp(join5(tmpdir(), "vos-moments-"));
+  const probeDir = await mkdtemp(join6(tmpdir(), "vos-moments-"));
   try {
     const probe = await framesTake(browser, dir, {
       times: candidates.map((c) => c.time),
@@ -4573,7 +4745,7 @@ async function pickStillTimes(browser, dir, doc, duration, opts) {
     });
     const byTime = /* @__PURE__ */ new Map();
     for (const frame of probe.frames) {
-      const img = decodePng(new Uint8Array(await readFile5(frame.file)));
+      const img = decodePng(new Uint8Array(await readFile6(frame.file)));
       if (!img) continue;
       const whole = { x: 0, y: 0, w: img.w, h: img.h };
       byTime.set(+frame.time.toFixed(3), {
@@ -4644,10 +4816,16 @@ async function deliverTake(browser, dir, opts) {
   const take = await loadTake(dir);
   if (!take.doc) throw new Error(`${dir} has no doc.json \u2014 run plan first`);
   const doc = take.doc;
+  const marks = await fetchBrandMarks(dir, opts.brandRoles);
+  for (const n of marks.notes) opts.onPhase?.(`note: ${n}`);
+  const darkGround = opts.look?.kind === "dark";
+  const mark = darkGround ? marks.dark : marks.light;
+  if (mark)
+    opts.onPhase?.(`brand mark: ${mark.key} (${mark.aspect.toFixed(2)}:1)`);
   const duration = totalDuration(ratedSegments5(doc));
   const videoSeconds = opts.range ? Math.min(opts.range[1], duration) - Math.min(opts.range[0], duration) : duration;
-  const outDir = resolve3(opts.outDir ?? join5(dir, "kit"));
-  await mkdir4(outDir, { recursive: true });
+  const outDir = resolve4(opts.outDir ?? join6(dir, "kit"));
+  await mkdir5(outDir, { recursive: true });
   const destinations = opts.channels.flatMap((c) => destinationsForChannel(c));
   const assets = [];
   const skipped = [];
@@ -4689,7 +4867,8 @@ async function deliverTake(browser, dir, opts) {
       launch: opts.launchRoles ?? {},
       captions: opts.captions ?? [],
       catalog: opts.catalog ?? null,
-      ink: endCardInk(opts.look, opts.brandRoles)
+      ink: endCardInk(opts.look, opts.brandRoles),
+      mark
     });
     set.push(...plan.set);
     if (plan.notes.length) opts.onPhase?.(`${d.id}: ${plan.notes.join(", ")}`);
@@ -4710,10 +4889,14 @@ async function deliverTake(browser, dir, opts) {
     const meta = doc.source.meta;
     const heroTime = opts.shotTime ?? (stillTimes.length ? stillTimes[0] : duration / 2);
     const fill = posterValues(opts.brandRoles, opts.words ?? {});
+    if (mark) {
+      fill.values.logoKey = mark.key;
+      fill.values.logoAspect = mark.aspect;
+    }
     opts.onPhase?.(
       `poster shot (full bleed at ${heroTime.toFixed(2)}s), baked as an object`
     );
-    const serveDir = await mkdtemp(join5(tmpdir(), "vos-poster-"));
+    const serveDir = await mkdtemp(join6(tmpdir(), "vos-poster-"));
     try {
       const shot = await framesTake(browser, dir, {
         times: [heroTime],
@@ -4735,7 +4918,7 @@ async function deliverTake(browser, dir, opts) {
           ]
         }
       });
-      const raw = decodePng(new Uint8Array(await readFile5(shot.frames[0].file)));
+      const raw = decodePng(new Uint8Array(await readFile6(shot.frames[0].file)));
       if (!raw) throw new Error("the poster shot could not be decoded");
       const PAD = 0.06;
       const baked = bakeShot(raw, {
@@ -4743,7 +4926,7 @@ async function deliverTake(browser, dir, opts) {
         hairline: fill.lightGround ? 0.14 : 0,
         shadow: fill.lightGround ? 0.28 : 0.4
       });
-      await writeFile6(join5(serveDir, "shot.png"), encodePng(baked));
+      await writeFile7(join6(serveDir, "shot.png"), encodePng(baked));
       const shotAspect = raw.w / raw.h;
       for (const { d, plan } of cardPlans) {
         if (plan.stage) {
@@ -4759,7 +4942,7 @@ async function deliverTake(browser, dir, opts) {
           opts.onPhase?.(
             `${d.channel} ${d.asset} (${specWords(d)}) from ${plan.from}`
           );
-          const shotDir = await mkdtemp(join5(tmpdir(), "vos-stage-"));
+          const shotDir = await mkdtemp(join6(tmpdir(), "vos-stage-"));
           try {
             const captured = await framesTake(browser, dir, {
               times: [heroTime],
@@ -4771,7 +4954,7 @@ async function deliverTake(browser, dir, opts) {
                 set: [...staged.set, ...opts.overrides?.set ?? []]
               }
             });
-            const to2 = join5(outDir, `${d.id}.png`);
+            const to2 = join6(outDir, `${d.id}.png`);
             await rename4(captured.frames[0].file, to2);
             const bytes2 = (await stat(to2)).size;
             if (d.maxBytes !== void 0 && bytes2 > d.maxBytes) {
@@ -4843,8 +5026,8 @@ async function deliverTake(browser, dir, opts) {
           [{ name: `${d.id}.png`, width: d.px.w, height: d.px.h }],
           time
         );
-        const from = join5(serveDir, `${d.id}.png`);
-        const to = join5(outDir, `${d.id}.png`);
+        const from = join6(serveDir, `${d.id}.png`);
+        const to = join6(outDir, `${d.id}.png`);
         await rename4(from, to);
         const bytes = (await stat(to)).size;
         if (d.maxBytes !== void 0 && bytes > d.maxBytes) {
@@ -4905,7 +5088,7 @@ async function deliverTake(browser, dir, opts) {
         }
       }
       opts.onPhase?.(`${label} (${specWords(d)})`);
-      const outFile = join5(outDir, `${d.id}.${d.format}`);
+      const outFile = join6(outDir, `${d.id}.${d.format}`);
       const bitrate = d.maxBytes !== void 0 ? Math.min(
         1e7,
         Math.floor(d.maxBytes * 8 / seconds * 0.85)
@@ -4952,7 +5135,7 @@ async function deliverTake(browser, dir, opts) {
     for (let i = 0; i < captured.frames.length; i++) {
       const frame = captured.frames[i];
       const name = captured.frames.length > 1 ? `${d.id}-${i + 1}.png` : `${d.id}.png`;
-      const to = join5(outDir, name);
+      const to = join6(outDir, name);
       await rename4(frame.file, to);
       const bytes = (await stat(to)).size;
       if (d.maxBytes !== void 0 && bytes > d.maxBytes) {
@@ -4990,8 +5173,8 @@ async function deliverTake(browser, dir, opts) {
     skipped,
     assets
   };
-  const kitFile = join5(outDir, "kit.json");
-  await writeFile6(kitFile, JSON.stringify(kit, null, 2));
+  const kitFile = join6(outDir, "kit.json");
+  await writeFile7(kitFile, JSON.stringify(kit, null, 2));
   return { kit, kitFile, outDir };
 }
 
@@ -5008,9 +5191,9 @@ async function fetchMusicCatalog(origin) {
 }
 
 // src/plugin/judge.ts
-import { existsSync as existsSync6 } from "fs";
-import { mkdir as mkdir5, readFile as readFile6, writeFile as writeFile7 } from "fs/promises";
-import { dirname, isAbsolute, join as join6, resolve as resolve4 } from "path";
+import { existsSync as existsSync7 } from "fs";
+import { mkdir as mkdir6, readFile as readFile7, writeFile as writeFile8 } from "fs/promises";
+import { dirname, isAbsolute as isAbsolute2, join as join7, resolve as resolve5 } from "path";
 import { DESTINATIONS as DESTINATIONS2 } from "@vosjs/studio-core";
 var RUBRIC = [
   "A plate, and room on it: the subject sits at 74 to 89% of the width with headroom; nobody bleeds a window on all four sides.",
@@ -5114,26 +5297,26 @@ function composeSheet(left, right, height = 540, gutter = 32) {
   return { w, h, data: out };
 }
 async function judgeKit(kitPath, manifestPath, outDir) {
-  const kit = JSON.parse(await readFile6(kitPath, "utf8"));
-  const manifest = JSON.parse(await readFile6(manifestPath, "utf8"));
-  const manifestDir = dirname(resolve4(manifestPath));
-  const kitDir = dirname(resolve4(kitPath));
-  const out = resolve4(outDir ?? join6(kitDir, "judge"));
-  await mkdir5(out, { recursive: true });
+  const kit = JSON.parse(await readFile7(kitPath, "utf8"));
+  const manifest = JSON.parse(await readFile7(manifestPath, "utf8"));
+  const manifestDir = dirname(resolve5(manifestPath));
+  const kitDir = dirname(resolve5(kitPath));
+  const out = resolve5(outDir ?? join7(kitDir, "judge"));
+  await mkdir6(out, { recursive: true });
   const sheets = [];
   const skipped = [];
   const refCache = /* @__PURE__ */ new Map();
   const loadRef = async (file) => {
     if (refCache.has(file)) return refCache.get(file) ?? null;
-    const p = join6(manifestDir, file);
-    const img = existsSync6(p) ? decodePng(new Uint8Array(await readFile6(p))) : null;
+    const p = join7(manifestDir, file);
+    const img = existsSync7(p) ? decodePng(new Uint8Array(await readFile7(p))) : null;
     refCache.set(file, img);
     return img;
   };
   for (const a of kit.assets) {
     if (!/\.png$/i.test(a.path)) continue;
-    const file = isAbsolute(a.path) && existsSync6(a.path) ? a.path : join6(kitDir, a.path.split("/").pop() ?? a.path);
-    const img = existsSync6(file) ? decodePng(new Uint8Array(await readFile6(file))) : null;
+    const file = isAbsolute2(a.path) && existsSync7(a.path) ? a.path : join7(kitDir, a.path.split("/").pop() ?? a.path);
+    const img = existsSync7(file) ? decodePng(new Uint8Array(await readFile7(file))) : null;
     if (!img) {
       skipped.push(`${a.destination ?? a.path}: unreadable`);
       continue;
@@ -5153,8 +5336,8 @@ async function judgeKit(kitPath, manifestPath, outDir) {
     const id = stem.replace(/[^A-Za-z0-9_-]+/g, "-") || a.destination || "asset";
     const nameA = `${id}--A.png`;
     const nameB = `${id}--B.png`;
-    await writeFile7(join6(out, nameA), encodePng(composeSheet(img, refImg)));
-    await writeFile7(join6(out, nameB), encodePng(composeSheet(refImg, img)));
+    await writeFile8(join7(out, nameA), encodePng(composeSheet(img, refImg)));
+    await writeFile8(join7(out, nameB), encodePng(composeSheet(refImg, img)));
     const rubric = [
       `# ${id} against ${ref.id} (${ref.file})`,
       "",
@@ -5174,12 +5357,12 @@ async function judgeKit(kitPath, manifestPath, outDir) {
       "In judge.json: `win` true when the kit asset is at least as good as the reference on the rules that apply to its genre, false when it is worse, null for a tie; `reasons` names the rules by number.",
       ""
     ].join("\n");
-    await writeFile7(join6(out, `${id}.md`), rubric);
+    await writeFile8(join7(out, `${id}.md`), rubric);
     sheets.push({ asset: id, reference: ref.id, sheetA: nameA, sheetB: nameB, rubric: `${id}.md` });
   }
-  const verdictFile = join6(out, "judge.json");
-  if (!existsSync6(verdictFile)) {
-    await writeFile7(
+  const verdictFile = join7(out, "judge.json");
+  if (!existsSync7(verdictFile)) {
+    await writeFile8(
       verdictFile,
       JSON.stringify(
         {
@@ -5205,7 +5388,7 @@ function winRate(verdicts) {
 // src/plugin/kitPicture.ts
 import { execFile } from "child_process";
 import { promisify } from "util";
-import { readFile as readFile7 } from "fs/promises";
+import { readFile as readFile8 } from "fs/promises";
 var execFileP = promisify(execFile);
 var SUBJECT_BAND = { min: 0.6, max: 0.92 };
 var BLANK_INK = 0.12;
@@ -5481,7 +5664,7 @@ async function pictureChecks(assets) {
   let ffmpeg = null;
   for (const a of assets) {
     if (/\.png$/i.test(a.file)) {
-      const img = decodePng(new Uint8Array(await readFile7(a.file)));
+      const img = decodePng(new Uint8Array(await readFile8(a.file)));
       if (!img) {
         findings.push({
           code: "unreadable",
@@ -5574,9 +5757,9 @@ function formatFinding(f) {
 }
 
 // src/plugin/validateKit.ts
-import { existsSync as existsSync7 } from "fs";
-import { readFile as readFile8, stat as stat2 } from "fs/promises";
-import { dirname as dirname2, isAbsolute as isAbsolute2, join as join7 } from "path";
+import { existsSync as existsSync8 } from "fs";
+import { readFile as readFile9, stat as stat2 } from "fs/promises";
+import { dirname as dirname2, isAbsolute as isAbsolute3, join as join8 } from "path";
 import { DESTINATIONS as DESTINATIONS3 } from "@vosjs/studio-core";
 var PNG_SIG2 = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
 function pngDimensions(bytes) {
@@ -5595,7 +5778,7 @@ async function probeVideo(path) {
   const MB = await import("mediabunny");
   const input = new MB.Input({
     formats: MB.ALL_FORMATS,
-    source: new MB.BufferSource(new Uint8Array(await readFile8(path)))
+    source: new MB.BufferSource(new Uint8Array(await readFile9(path)))
   });
   try {
     const track = await input.getPrimaryVideoTrack();
@@ -5616,7 +5799,7 @@ async function validateKit(kitPath, opts = {}) {
   const measured = [];
   let kit;
   try {
-    kit = JSON.parse(await readFile8(kitPath, "utf8"));
+    kit = JSON.parse(await readFile9(kitPath, "utf8"));
   } catch (e) {
     return {
       valid: false,
@@ -5635,8 +5818,8 @@ async function validateKit(kitPath, opts = {}) {
   }
   const base = dirname2(kitPath);
   const resolvePath = (p) => {
-    if (isAbsolute2(p) && existsSync7(p)) return p;
-    const beside = join7(base, p.split("/").pop() ?? p);
+    if (isAbsolute3(p) && existsSync8(p)) return p;
+    const beside = join8(base, p.split("/").pop() ?? p);
     return beside;
   };
   const perDestination = /* @__PURE__ */ new Map();
@@ -5662,7 +5845,7 @@ async function validateKit(kitPath, opts = {}) {
     let h = null;
     let seconds = null;
     if (/\.(png|jpe?g|webp)$/i.test(file)) {
-      const head = Buffer.from(await readFile8(file));
+      const head = Buffer.from(await readFile9(file));
       const kind = sniffImage(head);
       if (file.toLowerCase().endsWith(".png") && kind !== "png")
         problems.push(
@@ -5773,7 +5956,7 @@ async function validateKit(kitPath, opts = {}) {
 // src/plugin/platform.ts
 import { mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
 import { homedir } from "os";
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 function platformOrigin(flags = {}) {
   const legacyEnv = process.env.VOS_API_BASE?.trim();
   const raw = flags.origin ?? flags.api ?? process.env.VOS_ORIGIN?.trim() ?? legacyEnv ?? "https://vos.so";
@@ -5806,7 +5989,7 @@ function parseVosId(input) {
 function deriveSlug(title) {
   return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 50).replace(/-+$/, "") || "remix";
 }
-var CREDENTIALS_PATH = join8(homedir(), ".config", "vos", "credentials");
+var CREDENTIALS_PATH = join9(homedir(), ".config", "vos", "credentials");
 function resolveCredential(explicit) {
   const flag = explicit?.trim();
   if (flag) return flag;
@@ -5829,7 +6012,7 @@ function requireCredential(explicit) {
   return key;
 }
 function writeCredential(key) {
-  mkdirSync(join8(homedir(), ".config", "vos"), { recursive: true, mode: 448 });
+  mkdirSync(join9(homedir(), ".config", "vos"), { recursive: true, mode: 448 });
   writeFileSync(CREDENTIALS_PATH, `${key.trim()}
 `, { mode: 384 });
   return CREDENTIALS_PATH;
@@ -5873,7 +6056,7 @@ function readJsonFile(file) {
   }
 }
 function readSyncState(dir) {
-  const own = readJsonFile(join8(dir, SYNC_STATE_NAME));
+  const own = readJsonFile(join9(dir, SYNC_STATE_NAME));
   if (own && typeof own.vosId === "string") {
     return {
       vosId: own.vosId,
@@ -5884,7 +6067,7 @@ function readSyncState(dir) {
       ...typeof own.remixOfId === "string" ? { remixOfId: own.remixOfId } : {}
     };
   }
-  const push = readJsonFile(join8(dir, "push.json"));
+  const push = readJsonFile(join9(dir, "push.json"));
   if (push && typeof push.vosId === "string") {
     return {
       vosId: push.vosId,
@@ -5892,7 +6075,7 @@ function readSyncState(dir) {
       ...typeof push.pushedAt === "string" ? { pushedAt: push.pushedAt } : {}
     };
   }
-  const meta = readJsonFile(join8(dir, "meta.json"));
+  const meta = readJsonFile(join9(dir, "meta.json"));
   if (meta && typeof meta.id === "string") {
     return {
       vosId: meta.id,
@@ -5910,7 +6093,7 @@ function writeSyncState(dir, patch) {
     ...patch
   };
   writeFileSync(
-    join8(dir, SYNC_STATE_NAME),
+    join9(dir, SYNC_STATE_NAME),
     `${JSON.stringify(merged, null, 2)}
 `
   );
@@ -5931,7 +6114,7 @@ function formatChanges(changes) {
 
 // src/plugin/recorder.ts
 import { readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 
 // src/plugin/recordingCap.ts
 var HOSTED_RECORDING_CAP_SECONDS = 30 * 60;
@@ -6019,7 +6202,7 @@ async function recordTake(browser, url, actions, paths, log, opts = {}) {
   cdp.on("Page.screencastFrame", (ev) => {
     const tsMs = ev.metadata.timestamp ? ev.metadata.timestamp * 1e3 : Date.now();
     const file = `frame-${String(frameIdx++).padStart(5, "0")}.jpg`;
-    writeFileSync2(join9(paths.framesDir, file), Buffer.from(ev.data, "base64"));
+    writeFileSync2(join10(paths.framesDir, file), Buffer.from(ev.data, "base64"));
     frames.push({ file, tMs: Math.max(0, Math.round(tsMs - t0)) });
     cdp.send("Page.screencastFrameAck", { sessionId: ev.sessionId }).catch(() => {
     });
@@ -6242,7 +6425,7 @@ async function recordTake(browser, url, actions, paths, log, opts = {}) {
   await sleep(200);
   const pageTitle = await page.title().catch(() => "");
   await context.close();
-  const firstFrame = frames[0] ? jpegDims(readFileSync3(join9(paths.framesDir, frames[0].file))) : null;
+  const firstFrame = frames[0] ? jpegDims(readFileSync3(join10(paths.framesDir, frames[0].file))) : null;
   const meta = {
     dpr: 1,
     zoom: 1,
@@ -6350,9 +6533,9 @@ async function encodeRecording(browser, takeDir, onProgress) {
 }
 
 // src/plugin/plan.ts
-import { existsSync as existsSync8 } from "fs";
-import { readFile as readFile9 } from "fs/promises";
-import { join as join10 } from "path";
+import { existsSync as existsSync9 } from "fs";
+import { readFile as readFile10 } from "fs/promises";
+import { join as join11 } from "path";
 import {
   DEFAULT_FRAME_STYLE,
   STYLE_FIELDS,
@@ -6545,10 +6728,10 @@ function retimeCut(prev, newSteps, newDurationMs) {
 // src/plugin/plan.ts
 var overlaps = (a, b) => a.in < b.out && b.in < a.out;
 async function readDigestActivity(dir) {
-  const file = join10(dir, "digest", "digest.json");
-  if (!existsSync8(file)) return null;
+  const file = join11(dir, "digest", "digest.json");
+  if (!existsSync9(file)) return null;
   try {
-    const d = JSON.parse(await readFile9(file, "utf8"));
+    const d = JSON.parse(await readFile10(file, "utf8"));
     return Array.isArray(d.activity) && d.activity.every((v) => typeof v === "number") ? d.activity : null;
   } catch {
     return null;
@@ -6661,16 +6844,16 @@ async function planTake(dir, opts = {}) {
 
 // src/plugin/sync.ts
 import { createHash } from "crypto";
-import { existsSync as existsSync10 } from "fs";
-import { readFile as readFile10 } from "fs/promises";
+import { existsSync as existsSync11 } from "fs";
+import { readFile as readFile11 } from "fs/promises";
 import { createInterface } from "readline/promises";
-import { basename, join as join13 } from "path";
+import { basename, join as join14 } from "path";
 import { lowerToComposition as lowerToComposition3, migrateHostedDoc as migrateHostedDoc2 } from "@vosjs/studio-core";
 
 // src/plugin/media.ts
-import { createWriteStream, existsSync as existsSync9 } from "fs";
-import { writeFile as writeFile8 } from "fs/promises";
-import { join as join11 } from "path";
+import { createWriteStream, existsSync as existsSync10 } from "fs";
+import { writeFile as writeFile9 } from "fs/promises";
+import { join as join12 } from "path";
 import { Readable } from "stream";
 import { pipeline } from "stream/promises";
 var MIC_NAME = "mic.webm";
@@ -6691,8 +6874,8 @@ async function pullMedia(ctx, dir, doc, log) {
     const url = doc.source[key];
     const assetId = assetIdOf(url);
     if (!assetId) continue;
-    const target = join11(dir, file);
-    if (existsSync9(target)) {
+    const target = join12(dir, file);
+    if (existsSync10(target)) {
       result.kept.push(file);
     } else {
       const abs = /^https?:/.test(url) ? url : `${ctx.origin}${url}`;
@@ -6714,17 +6897,17 @@ async function pullMedia(ctx, dir, doc, log) {
     }
     doc.source[key] = file;
   }
-  const metaPath = join11(dir, "meta.json");
-  if (!existsSync9(metaPath)) await writeJson(metaPath, doc.source.meta, true);
-  const cursorPath = join11(dir, "cursor.json");
-  if (!existsSync9(cursorPath)) await writeJson(cursorPath, doc.source.cursor);
-  await writeFile8(join11(dir, "doc.json"), JSON.stringify(doc, null, 2));
+  const metaPath = join12(dir, "meta.json");
+  if (!existsSync10(metaPath)) await writeJson(metaPath, doc.source.meta, true);
+  const cursorPath = join12(dir, "cursor.json");
+  if (!existsSync10(cursorPath)) await writeJson(cursorPath, doc.source.cursor);
+  await writeFile9(join12(dir, "doc.json"), JSON.stringify(doc, null, 2));
   return result;
 }
 
 // src/plugin/folder.ts
-import { mkdir as mkdir6, writeFile as writeFile9 } from "fs/promises";
-import { join as join12 } from "path";
+import { mkdir as mkdir7, writeFile as writeFile10 } from "fs/promises";
+import { join as join13 } from "path";
 import { recipeHints } from "@vosjs/shared/frontmatter";
 import { migrateHostedDoc } from "@vosjs/studio-core";
 var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["json", "help", "media"]);
@@ -6900,25 +7083,25 @@ async function cmdPull(argv) {
     throw new Error(apiError(`pull folder ${folder.slug}`, res));
   const payload = res.body;
   const out = strFlag(flags, "out") ?? folder.slug;
-  await mkdir6(join12(out, "recipes"), { recursive: true });
+  await mkdir7(join13(out, "recipes"), { recursive: true });
   const lines = [];
   const recipes = [];
   for (const rec of payload.recipes) {
-    const path = join12(out, "recipes", safeName(rec.filename));
-    await writeFile9(path, rec.body ?? "");
+    const path = join13(out, "recipes", safeName(rec.filename));
+    await writeFile10(path, rec.body ?? "");
     recipes.push({ path, line: recipeLine(rec.filename, rec.body ?? "") });
   }
   for (const rec of payload.inheritedRecipes) {
     const from = safeName(rec.folderSlug ?? "inherited");
-    await mkdir6(join12(out, "recipes", "_inherited", from), { recursive: true });
-    const path = join12(
+    await mkdir7(join13(out, "recipes", "_inherited", from), { recursive: true });
+    const path = join13(
       out,
       "recipes",
       "_inherited",
       from,
       safeName(rec.filename)
     );
-    await writeFile9(path, rec.body ?? "");
+    await writeFile10(path, rec.body ?? "");
     recipes.push({
       path,
       line: `${recipeLine(rec.filename, rec.body ?? "")}  [inherited from ${rec.folderName ?? from}]`
@@ -6926,15 +7109,15 @@ async function cmdPull(argv) {
   }
   const members = [];
   for (const v of payload.voses) {
-    const dir = join12(out, "members", safeName(v.slug || v.title || v.id));
-    await mkdir6(dir, { recursive: true });
+    const dir = join13(out, "members", safeName(v.slug || v.title || v.id));
+    await mkdir7(dir, { recursive: true });
     const cfg = await apiJson(origin, `/api/vos/${v.id}/config`, { key });
     if (cfg.status !== 200) {
       lines.push(`skipped ${v.title}: ${apiError("fetch config", cfg)}`);
       continue;
     }
-    await writeFile9(
-      join12(dir, "config.json"),
+    await writeFile10(
+      join13(dir, "config.json"),
       JSON.stringify(cfg.body.config, null, 2)
     );
     let take = false;
@@ -6945,8 +7128,8 @@ async function cmdPull(argv) {
         { key }
       );
       if (doc.status === 200) {
-        await writeFile9(
-          join12(dir, "doc.json"),
+        await writeFile10(
+          join13(dir, "doc.json"),
           JSON.stringify(doc.body, null, 2)
         );
         take = true;
@@ -7063,7 +7246,7 @@ async function pushTake(dir, flags, r) {
     throw new Error(`doc.json fails lint:
   ${lint.problems.join("\n  ")}`);
   }
-  if (!existsSync10(take.paths.recording)) {
+  if (!existsSync11(take.paths.recording)) {
     throw new Error("no recording.webm in this take");
   }
   const ctx = apiContext(flags);
@@ -7095,7 +7278,7 @@ async function pushTake(dir, flags, r) {
       throw new Error("push cancelled");
     }
   }
-  const bytes = await readFile10(take.paths.recording);
+  const bytes = await readFile11(take.paths.recording);
   const hash = createHash("sha256").update(bytes).digest("hex");
   r.log(`uploading recording (${Math.round(bytes.length / 1024)} kB)\u2026`);
   const upload = await api(ctx, "/assets/recording", {
@@ -7246,9 +7429,9 @@ async function pullTake(dir, flags, r) {
       };
     }
     let media2;
-    if (flags.media && existsSync10(join13(dir, "doc.json"))) {
+    if (flags.media && existsSync11(join14(dir, "doc.json"))) {
       const local = JSON.parse(
-        await readFile10(join13(dir, "doc.json"), "utf8")
+        await readFile11(join14(dir, "doc.json"), "utf8")
       );
       media2 = await pullMedia(ctx, dir, local, r.log);
     }
@@ -7308,10 +7491,10 @@ async function pullTake(dir, flags, r) {
   }
   const hostedDoc = migrateHostedDoc2(docRes.json);
   const doc = hostedDoc;
-  if (existsSync10(join13(dir, RECORDING_NAME))) {
+  if (existsSync11(join14(dir, RECORDING_NAME))) {
     doc.source.videoKey = RECORDING_NAME;
   }
-  await writeJson(join13(dir, "doc.json"), doc, true);
+  await writeJson(join14(dir, "doc.json"), doc, true);
   const media = flags.media ? await pullMedia(ctx, dir, doc, r.log) : void 0;
   const versions = await api(ctx, `/vos/${vosId}/versions`);
   const headRow = (versions.json.versions ?? []).find((v) => v.id === head);
@@ -7330,10 +7513,10 @@ async function pullTake(dir, flags, r) {
 }
 
 // src/plugin/program.ts
-import { existsSync as existsSync11 } from "fs";
-import { mkdir as mkdir7, readFile as readFile11, writeFile as writeFile10 } from "fs/promises";
+import { existsSync as existsSync12 } from "fs";
+import { mkdir as mkdir8, readFile as readFile12, writeFile as writeFile11 } from "fs/promises";
 import { createInterface as createInterface2 } from "readline/promises";
-import { basename as basename2, dirname as dirname3, join as join14 } from "path";
+import { basename as basename2, dirname as dirname3, join as join15 } from "path";
 import {
   CURRENT_CONFIG_VERSION,
   migrateConfig,
@@ -7503,8 +7686,8 @@ function preflightConfig(parsed) {
 }
 function resolveConfigPath(target) {
   if (target.endsWith(".json")) return target;
-  const inDir = join14(target, "config.json");
-  if (existsSync11(inDir)) return inDir;
+  const inDir = join15(target, "config.json");
+  if (existsSync12(inDir)) return inDir;
   throw new UsageError(
     `${target} has no config.json (and is not a take \u2014 no doc.json)`
   );
@@ -7530,9 +7713,9 @@ async function cmdFetch(argv) {
     throw new Error(apiError(`fetch config for ${vosId}`, cfg));
   const slug = typeof vosMeta.slug === "string" && vosMeta.slug ? vosMeta.slug : vosId;
   const out = strFlag(flags, "out") ?? slug;
-  await mkdir7(out, { recursive: true });
-  await writeFile10(
-    join14(out, "config.json"),
+  await mkdir8(out, { recursive: true });
+  await writeFile11(
+    join15(out, "config.json"),
     JSON.stringify(cfg.body.config, null, 2)
   );
   const title = typeof vosMeta.title === "string" ? vosMeta.title : "";
@@ -7557,12 +7740,12 @@ async function cmdFetch(argv) {
       const hosted = migrateHostedDoc3(doc.body);
       const { config: own } = await writeProgramDoc(out, hosted);
       if (own) {
-        await writeFile10(join14(out, "config.json"), JSON.stringify(own, null, 2));
+        await writeFile11(join15(out, "config.json"), JSON.stringify(own, null, 2));
       }
     } else if (doc.status === 200) {
       take = true;
       const hosted = migrateHostedDoc3(doc.body);
-      await writeFile10(join14(out, "doc.json"), JSON.stringify(hosted, null, 2));
+      await writeFile11(join15(out, "doc.json"), JSON.stringify(hosted, null, 2));
       if (flags.media === true) {
         const media = await pullMedia({ origin, key }, out, hosted, r.log);
         mediaLine = media.downloaded.length ? ` + ${media.downloaded.map((m) => m.file).join(", ")}` : "";
@@ -7674,7 +7857,7 @@ async function cmdPushProgram(argv) {
     api: strFlag(flags, "api")
   });
   const dir = dirname3(source);
-  const parsed = JSON.parse(await readFile11(source, "utf8"));
+  const parsed = JSON.parse(await readFile12(source, "utf8"));
   const pre = preflightConfig(parsed);
   if (!pre.ok || !pre.config) {
     for (const issue of pre.issues) r.log(`error ${issue}`);
@@ -7907,10 +8090,10 @@ async function cmdPullProgram(argv) {
   const cfg = await apiJson(origin, `/api/vos/${vosId}/config`, { key });
   if (cfg.status !== 200)
     throw new Error(apiError(`fetch head config for ${vosId}`, cfg));
-  const configPath = join14(dir, "config.json");
+  const configPath = join15(dir, "config.json");
   let backedUp = false;
-  if (existsSync11(configPath)) {
-    await writeFile10(join14(dir, "config.backup.json"), await readFile11(configPath));
+  if (existsSync12(configPath)) {
+    await writeFile11(join15(dir, "config.backup.json"), await readFile12(configPath));
     backedUp = true;
   }
   let headConfig = cfg.body.config;
@@ -7929,7 +8112,7 @@ async function cmdPullProgram(argv) {
       if (own) headConfig = own;
     }
   }
-  await writeFile10(configPath, JSON.stringify(headConfig, null, 2));
+  await writeFile11(configPath, JSON.stringify(headConfig, null, 2));
   writeSyncState(dir, {
     vosId,
     versionId: typeof head.id === "string" ? head.id : since
@@ -7943,7 +8126,7 @@ async function cmdPullProgram(argv) {
       protected: protectedIds,
       changes,
       out: configPath,
-      backup: backedUp ? join14(dir, "config.backup.json") : null
+      backup: backedUp ? join15(dir, "config.backup.json") : null
     },
     `Pulled ${changes.length} version${changes.length === 1 ? "" : "s"} \u2192 ${configPath}` + (backedUp ? ` (previous copy: config.backup.json)` : "") + `
 Re-apply your edit on the new head, then: vos push ${configPath} --vos ${vosId}`
@@ -8000,9 +8183,9 @@ function isTakeDir(target) {
   return directoryKind(target) === "take";
 }
 async function readProgramDoc(dir, config) {
-  const docPath = join14(dir, "doc.json");
-  if (!existsSync11(docPath)) return null;
-  const parsed = JSON.parse(await readFile11(docPath, "utf8"));
+  const docPath = join15(dir, "doc.json");
+  if (!existsSync12(docPath)) return null;
+  const parsed = JSON.parse(await readFile12(docPath, "utf8"));
   if (typeof parsed !== "object" || parsed === null || "source" in parsed)
     return null;
   const raw = parsed;
@@ -8013,7 +8196,7 @@ async function writeProgramDoc(dir, hosted) {
   const program = hosted.program && typeof hosted.program === "object" ? hosted.program : {};
   const { config, ...rest } = program;
   const onDisk = { ...hosted, program: rest };
-  await writeFile10(join14(dir, "doc.json"), JSON.stringify(onDisk, null, 2));
+  await writeFile11(join15(dir, "doc.json"), JSON.stringify(onDisk, null, 2));
   return {
     config: config && typeof config === "object" ? config : null
   };
@@ -8220,8 +8403,8 @@ async function cmdRecipe(argv) {
 }
 
 // src/plugin/brand.ts
-import { writeFile as writeFile11 } from "fs/promises";
-import { resolve as resolve5 } from "path";
+import { writeFile as writeFile12 } from "fs/promises";
+import { resolve as resolve6 } from "path";
 import { parseFrontmatter as parseFrontmatter2 } from "@vosjs/shared/frontmatter";
 import { lookKindForGround } from "@vosjs/studio-core";
 var HEX_RE = /#(?:[0-9a-f]{6}|[0-9a-f]{3})\b/gi;
@@ -8425,7 +8608,14 @@ function composeBrand(input) {
   const designBody = design?.fonts.slice(1).find((f) => !/\bmono\b/i.test(f));
   const fontBody = designBody ?? firstFamily2(w.body.fontFamily);
   p.fontBody = designBody ? `named in design.md` : `the body's computed face`;
-  const logoUrl = design?.logos.find((u) => /wordmark|logo/i.test(u)) ?? null;
+  const isIcon = (u) => /favicon|apple-touch|icon/i.test(u);
+  const onDark = (u) => /on-dark|white/i.test(u);
+  const logoUrl = design?.logos.find(
+    (u) => /wordmark|logo|mark/i.test(u) && !isIcon(u) && !onDark(u)
+  ) ?? null;
+  const logoOnDarkUrl = design?.logos.find(
+    (u) => /wordmark|logo|mark/i.test(u) && !isIcon(u) && onDark(u)
+  ) ?? null;
   const iconUrl = w.icons.find((u) => /apple-touch/i.test(u)) ?? (w.icons.length ? w.icons[0] : null);
   p.logoUrl = logoUrl ? `linked from design.md` : `none linked; the icon stands in`;
   p.iconUrl = iconUrl ? `the page's icon link` : `no icon link`;
@@ -8444,6 +8634,7 @@ function composeBrand(input) {
     fontDisplay,
     fontBody,
     logoUrl: logoUrl ?? iconUrl,
+    logoOnDarkUrl,
     iconUrl,
     ogImage: w.ogImage,
     wordmark,
@@ -8473,6 +8664,7 @@ function renderBrandMd(c, claim) {
     `fontDisplay: ${q(k.fontDisplay)}`,
     `fontBody: ${q(k.fontBody)}`,
     `logoUrl: ${q(k.logoUrl)}`,
+    `logoOnDarkUrl: ${q(k.logoOnDarkUrl)}`,
     `iconUrl: ${q(k.iconUrl)}`,
     `ogImage: ${q(k.ogImage)}`,
     `wordmark: ${q(k.wordmark)}`,
@@ -8498,7 +8690,7 @@ function renderBrandMd(c, claim) {
     "",
     "## Use",
     "",
-    `The poster family binds these roles: \`bgA/bgB/bgC\` for the ground, \`ink\` for type, \`fontDisplay\` for the headline (if it is not in the hosted catalog, \`vos check\` warns and the nearest hosted serif or sans stands in), \`logoUrl\` for the mark. A take's frame ground is a gradient of \`accent\` toward \`bgC\` unless the brand is paper, in which case \`bgB\` toward \`bgC\`.`
+    `The poster family binds these roles: \`bgA/bgB/bgC\` for the ground, \`ink\` for type, \`fontDisplay\` for the headline (if it is not in the hosted catalog, \`vos check\` warns and the nearest hosted serif or sans stands in), \`logoUrl\` for the mark (placed beside the wordmark on the cards and the end card; \`logoOnDarkUrl\` stands in on a dark ground). A site that publishes only a favicon or an app icon gets the icon here, tile and all: publish a bare mark and name it in design.md. A take's frame ground is a gradient of \`accent\` toward \`bgC\` unless the brand is paper, in which case \`bgB\` toward \`bgC\`.`
   ];
   if (c.avoid.length) {
     lines.push("", "## Avoid (the site says)", "");
@@ -8529,7 +8721,7 @@ async function cmdBrand(argv) {
     throw new UsageError(`not a URL: ${raw}`);
   }
   const r = createReporter(flags.json === true);
-  const out = resolve5(strFlag(flags, "out") ?? "BRAND.md");
+  const out = resolve6(strFlag(flags, "out") ?? "BRAND.md");
   r.log(`reading ${origin}/design.md and /llms.txt\u2026`);
   const [designText, llmsText] = await Promise.all([
     fetchText(`${origin}/design.md`),
@@ -8563,7 +8755,7 @@ async function cmdBrand(argv) {
     composition,
     llms?.claim ?? design?.description ?? null
   );
-  await writeFile11(out, md);
+  await writeFile12(out, md);
   const k = composition.kit;
   r.done(
     {
@@ -8581,8 +8773,8 @@ async function cmdBrand(argv) {
 }
 
 // src/plugin/agentBrowser.ts
-import { writeFile as writeFile12 } from "fs/promises";
-import { resolve as resolve6 } from "path";
+import { writeFile as writeFile13 } from "fs/promises";
+import { resolve as resolve7 } from "path";
 function parseAgentBrowserLog(text) {
   const records = [];
   const problems = [];
@@ -9052,7 +9244,7 @@ async function cmdActions(argv) {
     );
   }
   const r = createReporter(flags.json === true);
-  const out = resolve6(strFlag(flags, "out") ?? "actions.json");
+  const out = resolve7(strFlag(flags, "out") ?? "actions.json");
   const viewportFlag = strFlag(flags, "viewport");
   let viewport;
   if (viewportFlag) {
@@ -9060,8 +9252,8 @@ async function cmdActions(argv) {
     if (!m) throw new UsageError("--viewport expects WxH, e.g. 1280x720");
     viewport = { width: Number(m[1]), height: Number(m[2]) };
   }
-  const { readFile: readFile13 } = await import("fs/promises");
-  const text = await readFile13(resolve6(input), "utf8");
+  const { readFile: readFile14 } = await import("fs/promises");
+  const text = await readFile14(resolve7(input), "utf8");
   const { records, problems } = parseAgentBrowserLog(text);
   for (const p of problems) r.log(`  ${p}`);
   const result = convertAgentBrowser(records, {
@@ -9078,7 +9270,7 @@ async function cmdActions(argv) {
     );
     return EXIT_ERROR;
   }
-  await writeFile12(out, `${JSON.stringify(result.actions, null, 2)}
+  await writeFile13(out, `${JSON.stringify(result.actions, null, 2)}
 `);
   r.done(
     { ok: true, out, url: result.actions.url ?? null, ...summary(result) },
@@ -9349,7 +9541,7 @@ lint-gated, so a bad override fails like a bad doc.json):
                        first ready loop (the house backdrop the studio opens on), or a flat ground offline
 `;
 async function loadActions(file) {
-  const raw = JSON.parse(await readFile12(file, "utf8"));
+  const raw = JSON.parse(await readFile13(file, "utf8"));
   const errors = validateActions(raw);
   if (errors.length)
     throw new UsageError(`invalid actions file:
@@ -9405,16 +9597,16 @@ async function cmdRecord(argv) {
   const url = strFlag(flags, "url") ?? actions.url;
   if (!url)
     throw new UsageError('no URL \u2014 set "url" in the actions file or pass --url');
-  const outDir = resolve7(strFlag(flags, "out") ?? "take");
+  const outDir = resolve8(strFlag(flags, "out") ?? "take");
   const backdrop = await takeBackdrop(flags, r);
   const maxDurationSeconds = await maxDuration(flags, r);
-  if (existsSync12(join15(outDir, "meta.json"))) {
+  if (existsSync13(join16(outDir, "meta.json"))) {
     const { prevDoc, kept } = await prepareReRecord(outDir);
     r.log(
       `note: re-recording ${outDir} \u2014 kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? "; apply the previous cut to the new footage with: vos plan " + outDir + " --reuse" : "")
     );
   }
-  await mkdir8(outDir, { recursive: true });
+  await mkdir9(outDir, { recursive: true });
   const paths = await ensureTakeDir(outDir);
   const browser = await launchBrowser();
   try {
@@ -9455,7 +9647,7 @@ async function cmdRecord(argv) {
       },
       strictFail ? `STRICT: take recorded but incomplete \u2014 ${strictReason(rec)}; fix the flow and re-record.${skippedNote}` : `Take ready: ${outDir}
   ${(rec.meta.durationMs / 1e3).toFixed(1)}s \xB7 ${rec.frames.length} frames \xB7 ${rec.events.length} cursor events \xB7 ${clicks} clicks \xB7 ${plan.doc.zoom.length} zoom spans planned \xB7 ${rec.freezePct}% frozen${rec.freezePct >= 25 ? " \u26A0 keep motion in frame or trim" : ""}${skippedNote}
-  Next: edit ${join15(outDir, "doc.json")} (optional), then: vos render ${outDir}`
+  Next: edit ${join16(outDir, "doc.json")} (optional), then: vos render ${outDir}`
     );
     return strictFail ? EXIT_USAGE : EXIT_OK;
   } finally {
@@ -9479,25 +9671,25 @@ async function cmdCreate2(argv) {
   const url = strFlag(flags, "url") ?? actions.url;
   if (!url)
     throw new UsageError('no URL \u2014 set "url" in the actions file or pass --url');
-  const outDir = resolve7(strFlag(flags, "out") ?? "take");
+  const outDir = resolve8(strFlag(flags, "out") ?? "take");
   const fmtRaw = strFlag(flags, "format") ?? "webm";
   if (fmtRaw !== "webm" && fmtRaw !== "mp4")
     throw new UsageError("--format must be webm or mp4");
   const format = fmtRaw;
-  const out = positionals[0] ?? join15(outDir, `out.${format}`);
+  const out = positionals[0] ?? join16(outDir, `out.${format}`);
   const parallel = numFlag(flags, "parallel", 1);
   if (!Number.isInteger(parallel) || parallel < 1 || parallel > 16) {
     throw new UsageError("--parallel expects an integer between 1 and 16");
   }
   const backdrop = await takeBackdrop(flags, r);
   const maxDurationSeconds = await maxDuration(flags, r);
-  if (existsSync12(join15(outDir, "meta.json"))) {
+  if (existsSync13(join16(outDir, "meta.json"))) {
     const { prevDoc, kept } = await prepareReRecord(outDir);
     r.log(
       `note: re-recording ${outDir} \u2014 kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? "; apply the previous cut to the new footage with: vos plan " + outDir + " --reuse" : "")
     );
   }
-  await mkdir8(outDir, { recursive: true });
+  await mkdir9(outDir, { recursive: true });
   const paths = await ensureTakeDir(outDir);
   const browser = await launchBrowser();
   try {
@@ -9578,24 +9770,24 @@ async function cmdPlan(argv) {
     );
   const r = createReporter(flags.json === true);
   if (flags.fresh === true) {
-    await rm4(join15(dir, "doc.json"), { force: true });
+    await rm4(join16(dir, "doc.json"), { force: true });
     r.log("note: --fresh discarded the existing doc.json");
   }
   let reuse;
   if (flags.reuse === true) {
-    const from = resolve7(strFlag(flags, "from") ?? join15(dir, PREV_DOC_NAME));
-    if (!existsSync12(from)) {
+    const from = resolve8(strFlag(flags, "from") ?? join16(dir, PREV_DOC_NAME));
+    if (!existsSync13(from)) {
       throw new UsageError(
         `--reuse: ${from} does not exist \u2014 a re-record into this take writes doc.prev.json, or pass --from <doc.json>`
       );
     }
     reuse = {
       from,
-      doc: JSON.parse(await readFile12(from, "utf8"))
+      doc: JSON.parse(await readFile13(from, "utf8"))
     };
   }
   const style = await resolveStyleRef(flags);
-  const backdrop = existsSync12(join15(dir, "doc.json")) ? null : await takeBackdrop(flags, r);
+  const backdrop = existsSync13(join16(dir, "doc.json")) ? null : await takeBackdrop(flags, r);
   const s = await planTake(dir, {
     ...style ? { style } : {},
     ...reuse ? { reuse } : {},
@@ -9607,7 +9799,7 @@ async function cmdPlan(argv) {
     ${s.reuse.flagged.join("\n    ")}` : "") : "";
   r.done(
     {
-      take: resolve7(dir),
+      take: resolve8(dir),
       fresh: s.fresh,
       cursorKept: s.cursorKept,
       zoomAuto: s.zoomAuto,
@@ -9617,7 +9809,7 @@ async function cmdPlan(argv) {
       ...s.styleFrom ? { styleFrom: s.styleFrom, styleFields: s.styleFields } : {},
       ...s.reuse ? { reuse: s.reuse } : {}
     },
-    `${s.reuse ? "Reused" : s.fresh ? "Planned" : "Refreshed"} ${join15(dir, "doc.json")}: ${s.zoomAuto} auto + ${s.zoomManual} manual zoom spans${s.cursorKept ? "" : " (cursor track dropped)"}${reuseLines}`
+    `${s.reuse ? "Reused" : s.fresh ? "Planned" : "Refreshed"} ${join16(dir, "doc.json")}: ${s.zoomAuto} auto + ${s.zoomManual} manual zoom spans${s.cursorKept ? "" : " (cursor track dropped)"}${reuseLines}`
   );
   return EXIT_OK;
 }
@@ -9637,7 +9829,7 @@ async function cmdRender(argv) {
   if (fmtRaw !== "webm" && fmtRaw !== "mp4")
     throw new UsageError("--format must be webm or mp4");
   const format = fmtRaw;
-  const out = positionals[1] ?? join15(dir, `out.${format}`);
+  const out = positionals[1] ?? join16(dir, `out.${format}`);
   const parallel = numFlag(flags, "parallel", 1);
   if (!Number.isInteger(parallel) || parallel < 1 || parallel > 16) {
     throw new UsageError("--parallel expects an integer between 1 and 16");
@@ -9822,10 +10014,10 @@ async function cmdDeliver(argv) {
   } else if (posterRef !== void 0 && templateByName(posterRef)) {
     poster = { from: `template ${posterRef}`, config: templateByName(posterRef) };
   } else if (posterRef !== void 0) {
-    if (existsSync12(posterRef)) {
+    if (existsSync13(posterRef)) {
       poster = {
-        from: resolve7(posterRef),
-        config: JSON.parse(await readFile12(posterRef, "utf8"))
+        from: resolve8(posterRef),
+        config: JSON.parse(await readFile13(posterRef, "utf8"))
       };
     } else {
       const origin = platformOrigin({
@@ -9951,14 +10143,14 @@ Store uploads stay manual: hand the human this directory and the manifest.`
 async function resolveStyleRef(flags) {
   const styleRef = strFlag(flags, "style");
   if (!styleRef) return null;
-  const file = existsSync12(styleRef) ? resolve7(
+  const file = existsSync13(styleRef) ? resolve8(
     styleRef,
-    existsSync12(join15(styleRef, "doc.json")) ? "doc.json" : ""
+    existsSync13(join16(styleRef, "doc.json")) ? "doc.json" : ""
   ) : null;
-  if (file && existsSync12(file)) {
+  if (file && existsSync13(file)) {
     return {
       from: file,
-      doc: JSON.parse(await readFile12(file, "utf8"))
+      doc: JSON.parse(await readFile13(file, "utf8"))
     };
   }
   const origin = platformOrigin({
@@ -9995,7 +10187,7 @@ async function cmdDigest(argv) {
   const take = await loadTake(dir);
   if (!take.doc) throw new UsageError(`${dir} has no doc.json \u2014 run plan first`);
   const transcriptPath = strFlag(flags, "transcript");
-  const transcript = transcriptPath ? parseTranscript(JSON.parse(await readFile12(transcriptPath, "utf8"))) : null;
+  const transcript = transcriptPath ? parseTranscript(JSON.parse(await readFile13(transcriptPath, "utf8"))) : null;
   const style = await resolveStyleRef(flags);
   const noFrames = flags["no-frames"] === true;
   let browser = null;
@@ -10026,7 +10218,7 @@ async function cmdDigest(argv) {
         kinds,
         frames: d.images.full,
         crops: d.images.crop,
-        sheet: d.images.sheet ? join15(result.outDir, d.images.sheet) : null,
+        sheet: d.images.sheet ? join16(result.outDir, d.images.sheet) : null,
         scenes: kinds.scene ?? 0,
         sourceDuration: d.take.sourceDuration,
         outputDuration: d.take.outputDuration,
@@ -10050,14 +10242,14 @@ async function cmdOpen(argv) {
   if (!dir) throw new UsageError("vos open <take> [--studio <url>]");
   const r = createReporter(flags.json === true);
   const take = await loadTake(dir);
-  if (!existsSync12(take.paths.recording)) {
+  if (!existsSync13(take.paths.recording)) {
     throw new UsageError(`${dir} has no recording.webm \u2014 re-run record`);
   }
   const studio = (strFlag(flags, "studio") ?? "http://localhost:6060").replace(
     /\/+$/,
     ""
   );
-  const server = await startTakeServer(resolve7(dir), {});
+  const server = await startTakeServer(resolve8(dir), {});
   const url = `${studio}/studio?take=${encodeURIComponent(server.base)}`;
   r.event({ event: "open", server: server.base, url });
   r.log(`take served at ${server.base}`);
@@ -10091,11 +10283,11 @@ async function cmdJudge(argv) {
       "vos judge <kit.json> --against <MANIFEST.json> [--out dir] [--json]\n(the manifest names the reference set: id, file, role, layout, facts, rule per asset)"
     );
   const r = createReporter(flags.json === true);
-  const kitFile = target.endsWith("kit.json") ? target : join15(target, "kit.json");
-  if (!existsSync12(kitFile)) throw new UsageError(`${kitFile}: no kit manifest`);
-  if (!existsSync12(against)) throw new UsageError(`${against}: no reference manifest`);
+  const kitFile = target.endsWith("kit.json") ? target : join16(target, "kit.json");
+  if (!existsSync13(kitFile)) throw new UsageError(`${kitFile}: no kit manifest`);
+  if (!existsSync13(against)) throw new UsageError(`${against}: no reference manifest`);
   const result = await judgeKit(kitFile, against, strFlag(flags, "out"));
-  const verdicts = JSON.parse(await readFile12(result.verdictFile, "utf8")).verdicts;
+  const verdicts = JSON.parse(await readFile13(result.verdictFile, "utf8")).verdicts;
   const rate = winRate(verdicts);
   const lines = result.sheets.map(
     (s) => `${s.asset} vs ${s.reference}: ${s.sheetA}, ${s.sheetB}, ${s.rubric}`
@@ -10115,7 +10307,7 @@ async function cmdValidate(argv) {
   const target = positionals[0];
   if (!target) throw new UsageError("vos validate <actions.json|take>");
   const r = createReporter(flags.json === true);
-  const kitTarget = target.endsWith("kit.json") ? target : existsSync12(join15(target, "kit.json")) && !isTakeDir(target) ? join15(target, "kit.json") : null;
+  const kitTarget = target.endsWith("kit.json") ? target : existsSync13(join16(target, "kit.json")) && !isTakeDir(target) ? join16(target, "kit.json") : null;
   if (kitTarget) {
     const picture = flags.picture === true;
     const verdict = await validateKit(kitTarget, { picture });
@@ -10147,9 +10339,9 @@ async function cmdValidate(argv) {
     r.done({ valid: true, target }, `${target}: valid actions file`);
     return EXIT_OK;
   }
-  if (!isTakeDir(target) && existsSync12(join15(target, "config.json"))) {
+  if (!isTakeDir(target) && existsSync13(join16(target, "config.json"))) {
     const parsed = JSON.parse(
-      await readFile12(join15(target, "config.json"), "utf8")
+      await readFile13(join16(target, "config.json"), "utf8")
     );
     const pre = preflightConfig(parsed);
     const problems2 = pre.ok ? [] : pre.issues.map((i) => `config.json: ${i}`);
@@ -10190,7 +10382,7 @@ async function cmdValidate(argv) {
   const take = await loadTake(target);
   const problems = [];
   const warnings = [];
-  if (!existsSync12(take.paths.recording))
+  if (!existsSync13(take.paths.recording))
     problems.push("missing recording.webm (re-run record)");
   if (!take.doc) problems.push("missing doc.json (run plan)");
   if (take.doc) {
@@ -10235,7 +10427,7 @@ async function cmdPush3(argv) {
   const r = createReporter(flags.json === true);
   const overrides = multi.override;
   const result = await pushTake(
-    resolve7(dir),
+    resolve8(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -10262,7 +10454,7 @@ async function cmdPull2(argv) {
   const dir = positionals[0] ?? ".";
   const r = createReporter(flags.json === true);
   const result = await pullTake(
-    resolve7(dir),
+    resolve8(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -10397,4 +10589,4 @@ export {
   convertAgentBrowser,
   run
 };
-//# sourceMappingURL=chunk-PKHORUJ2.js.map
+//# sourceMappingURL=chunk-Q5NF5EN2.js.map