Assets

1// assets.mjs — stage frame-named capture assets into assets/.
2// Shared by stage-assets.mjs (Step 4 close, BEFORE the frame workers run) and
3// assemble-index.mjs (Step 5, idempotent backstop). Only assets a frame names
4// in `asset_candidates` are staged; unnamed assets never reach the project.
5// asset_candidates value form: "assets/<basename> — desc; assets/… — …".
6
7import { copyFileSync, existsSync, mkdirSync } from "node:fs";
8import { basename, join } from "node:path";
9
10export function basenamesFromCandidates(value) {
11  if (typeof value !== "string") return [];
12  return value
13    .split(";")
14    .map((seg) => seg.split(/\s+[—–-]\s+/)[0].trim()) // strip the " — description"
15    .filter(Boolean)
16    .map((p) => basename(p.replace(/^assets\//, "")));
17}
18
19// Copy each frame's asset_candidates from capture/{assets,assets/videos,
20// assets/svgs, screenshots} into assets/. Already-staged files are left as is
21// (first-wins), so calling this twice is safe. Returns { staged, wanted, anomalies }.
22export function stageAssets({ hyperframesDir, frames }) {
23  const wanted = new Set();
24  for (const f of frames) {
25    for (const b of basenamesFromCandidates(f.extra?.asset_candidates)) wanted.add(b);
26  }
27  const captureDirs = [
28    join(hyperframesDir, "capture/assets"),
29    join(hyperframesDir, "capture/assets/videos"), // videos download into a subdir
30    join(hyperframesDir, "capture/assets/svgs"), // inline SVGs extract into a subdir
31    join(hyperframesDir, "capture/screenshots"),
32  ];
33  const assetsDir = join(hyperframesDir, "assets");
34  const anomalies = [];
35  let staged = 0;
36  if (wanted.size > 0) {
37    mkdirSync(assetsDir, { recursive: true });
38    for (const b of wanted) {
39      const dest = join(assetsDir, b);
40      if (existsSync(dest)) {
41        staged++;
42        continue;
43      } // first-wins / already staged
44      const src = captureDirs.map((d) => join(d, b)).find((p) => existsSync(p));
45      if (src) {
46        copyFileSync(src, dest);
47        staged++;
48      } else {
49        anomalies.push(
50          `asset "${b}" named by a frame but not found under capture/ — frame will 404 it`,
51        );
52      }
53    }
54  }
55  return { staged, wanted, anomalies };
56}