Dimensions

1// dimensions.mjs — canvas size + caption-band geometry for the video
2// pipeline. Single source of truth = the STORYBOARD frontmatter `format` global
3// ("1920x1080" / "1080x1920" / "1080x1080", or a named orientation). Every
4// script and the index assembler reads the size from here; none hardcodes it.
5
6// Named orientation presets. Square/portrait are 1080-based so they share the
7// long-edge pixel budget with landscape (same render-cost ballpark).
8export const ORIENTATION_PRESETS = {
9  landscape: { width: 1920, height: 1080 }, // 16:9 — default
10  portrait: { width: 1080, height: 1920 }, // 9:16 — reels / shorts / TikTok
11  square: { width: 1080, height: 1080 }, // 1:1 — feed
12};
13
14export const DEFAULT_DIMENSIONS = ORIENTATION_PRESETS.landscape;
15
16function sane(w, h) {
17  return Number.isFinite(w) && Number.isFinite(h) && w >= 240 && h >= 240 && w <= 8192 && h <= 8192;
18}
19
20// Parse a STORYBOARD `format` global into { width, height, source }. Accepts
21// "WxH" (e.g. "1920x1080"; `x` or `×`, any inner spacing) or a named orientation;
22// falls back to landscape so a storyboard with a missing/garbled format still
23// renders (no behavior change vs the old landscape lock).
24export function parseFormat(format) {
25  const s = typeof format === "string" ? format.trim().toLowerCase() : "";
26  if (ORIENTATION_PRESETS[s]) return { ...ORIENTATION_PRESETS[s], source: `orientation=${s}` };
27  const m = s.match(/^(\d+)\s*[x×]\s*(\d+)$/);
28  if (m) {
29    const w = parseInt(m[1] ?? "", 10);
30    const h = parseInt(m[2] ?? "", 10);
31    if (sane(w, h)) return { width: w, height: h, source: "format" };
32  }
33  return { ...DEFAULT_DIMENSIONS, source: "default(landscape)" };
34}
35
36// Caption band geometry, derived from canvas height: the bottom ~16.67% (180px
37// at h=1080). Frame content must end `safetyPx` above the band top. Holds even
38// when captions are disabled (bottom-edge consistency).
39export const CAPTION_BAND_FRACTION = 0.1667;
40export function captionBand(height, safetyPx = 20) {
41  const h = Number.isFinite(height) ? height : DEFAULT_DIMENSIONS.height;
42  const bandHeight = Math.round(h * CAPTION_BAND_FRACTION);
43  const bandTopY = h - bandHeight; // foreground must end at/above this y
44  return { bandHeight, bandTopY, foregroundMaxY: bandTopY - safetyPx };
45}