Stage Assets

1#!/usr/bin/env node
2// stage-assets.mjs — copy user-supplied media into the project's assets/ so scene
3// files (and lint/validate/render) can reference them locally. Only needed when
4// the user provides images/videos for asset treatments (montage.md). First-wins,
5// idempotent, safe to run twice. Never fetches remote URLs.
6//
7// Usage: node stage-assets.mjs --from <srcDir> --hyperframes <projectRoot>
8//        [--into public]   (subdir under assets/; default copies flat into assets/)
9//
10// Copies common media extensions only; reports what landed.
11
12import { existsSync, mkdirSync, readdirSync, copyFileSync, statSync } from "node:fs";
13import { extname, join, resolve, basename } from "node:path";
14
15const argv = process.argv.slice(2);
16const flag = (n, d) => {
17  const i = argv.indexOf(`--${n}`);
18  return i >= 0 && i + 1 < argv.length ? argv[i + 1] : d;
19};
20function die(m) {
21  console.error(`✗ stage-assets.mjs: ${m}`);
22  process.exit(1);
23}
24
25const fromDir = flag("from", null);
26if (!fromDir) die("missing --from <srcDir>");
27const fromAbs = resolve(fromDir);
28if (!existsSync(fromAbs) || !statSync(fromAbs).isDirectory())
29  die(`--from is not a directory: ${fromAbs}`);
30const hyperframesDir = resolve(flag("hyperframes", "."));
31const into = flag("into", "");
32const destDir = join(hyperframesDir, "assets", into);
33
34const MEDIA = new Set([".jpg", ".jpeg", ".png", ".webp", ".gif", ".mp4", ".mov", ".webm", ".m4v"]);
35
36mkdirSync(destDir, { recursive: true });
37let staged = 0,
38  skipped = 0;
39const landed = [];
40for (const name of readdirSync(fromAbs)) {
41  const src = join(fromAbs, name);
42  if (!statSync(src).isFile()) continue;
43  if (!MEDIA.has(extname(name).toLowerCase())) continue;
44  const dest = join(destDir, basename(name));
45  if (existsSync(dest)) {
46    skipped++;
47    continue;
48  } // first-wins
49  copyFileSync(src, dest);
50  staged++;
51  landed.push(join("assets", into, basename(name)));
52}
53
54console.log(
55  `✓ stage-assets: ${staged} copied, ${skipped} already present → ${join("assets", into)}/`,
56);
57for (const l of landed) console.log(`  ${l}`);
58if (staged === 0 && skipped === 0) console.log(`  (no media files found in ${fromAbs})`);