@funpixel/tools 0.0.0-stage → 0.1.1

package/dist/compose/starters.js

@@ -0,0 +1,247 @@
+import { SAFE } from "../trailer/placement.js";
+import { COMPOSE_ASPECTS } from "./contract.js";
+export const STARTERS = ['trailer', 'post', 'endcard'];
+export const STARTER_DEFAULTS = {
+    trailer: { aspect: '16:9', seconds: 15 },
+    post: { aspect: '9:16', seconds: 10 },
+    endcard: { aspect: '9:16', seconds: 6 },
+};
+export const GSAP_URL = 'https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js';
+const esc = (s) => s.replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
+const r2 = (n) => Math.round(n * 100) / 100;
+const FORMAT = { '16:9': '16x9', '9:16': '9x16', '1:1': '1x1' };
+function gameBox(aspect, orientation) {
+    const [w, h] = COMPOSE_ASPECTS[aspect];
+    const frameWide = w > h, square = w === h;
+    if (!square && frameWide === (orientation === 'landscape'))
+        return { css: 'left:0;top:0;width:100vw;height:100vh', wide: orientation === 'landscape' };
+    if (orientation === 'landscape') {
+        const bandH = (100 * (w * 9 / 16)) / h;
+        return { css: `left:0;top:${r2((100 - bandH) / 2)}vh;width:100vw;height:${r2(bandH)}vh`, wide: true };
+    }
+    const colW = (100 * (h * 0.92 * 9 / 16)) / w;
+    return { css: `left:${r2((100 - colW) / 2)}vw;top:4vh;width:${r2(colW)}vw;height:92vh`, wide: false };
+}
+function head(o) {
+    const [w, h] = COMPOSE_ASPECTS[o.aspect];
+    const s = SAFE[FORMAT[o.aspect]];
+    const vars = Object.entries(o.vars).map(([id, def]) => ({ id, type: 'string', label: id, default: def }));
+    return `<!doctype html>
+<html lang="en" data-composition-variables='${JSON.stringify(vars).replace(/'/g, '&#39;')}'>
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=${w}, height=${h}">
+<title>${esc(o.title)}</title>
+<script src="${GSAP_URL}"></script>
+<style>
+  :root { --bg: ${o.palette.bg}; --primary: ${o.palette.primary}; --accent: ${o.palette.accent}; --ink: #fffaf0;
+          --safe-top: ${r2(s.top * 100)}vh; --safe-right: ${r2(s.right * 100)}vw; --safe-bottom: ${r2(s.bottom * 100)}vh; --safe-left: ${r2(s.left * 100)}vw; }
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  html, body { width: 100vw; height: 100vh; overflow: hidden; background: #0d0f12; }
+  #root { position: relative; width: 100vw; height: 100vh; overflow: hidden; font-family: Nunito, Poppins, "Segoe UI", sans-serif; color: var(--ink); }
+  .clip { position: absolute; }
+  .full { left: 0; top: 0; width: 100vw; height: 100vh; }
+  .cover { object-fit: cover; }
+  .game { border: 0; background: #000; }
+  .blur { filter: blur(3vmin) brightness(0.55) saturate(1.2); transform: scale(1.15); }
+  .safe { left: var(--safe-left); right: var(--safe-right); top: var(--safe-top); bottom: var(--safe-bottom); display: flex; flex-direction: column; align-items: center; text-align: center; }
+  .title { font-weight: 900; font-size: 9vmin; line-height: 1; letter-spacing: -0.02em; color: var(--primary); text-shadow: 0 0.7vmin 0 var(--accent), 0 1.4vmin 3vmin rgba(0,0,0,0.45); }
+  .tagline { margin-top: 2.2vmin; font-weight: 700; font-size: 3.6vmin; text-shadow: 0 0.4vmin 1.6vmin rgba(0,0,0,0.6); }
+  .caption { font-weight: 800; font-size: 4.6vmin; padding: 1.4vmin 3vmin; border-radius: 2vmin; background: rgba(13,15,18,0.72); box-shadow: 0 0.6vmin 0 var(--accent); }
+  .scrim { background: linear-gradient(to top, rgba(8,9,12,0.82), rgba(8,9,12,0.35) 45%, transparent 70%); }
+  .big { font-size: 13vmin; }
+  .cta { font-weight: 900; font-size: 4.4vmin; padding: 2vmin 6vmin; border-radius: 99vmin; color: #14110a; background: var(--primary); box-shadow: 0 0.9vmin 0 var(--accent), 0 2vmin 4vmin rgba(0,0,0,0.4); }
+${o.css}
+</style>
+</head>
+<body>
+`;
+}
+function tail(id, timeline) {
+    return `<script>
+  // The words are composition variables: --variables '{"title":"…"}' (or Robin) changes them, the layout stays.
+  (function () {
+    var hf = window.__hyperframes, v = (hf && hf.getVariables && hf.getVariables()) || {};
+    Object.keys(v).forEach(function (k) { document.querySelectorAll('[data-var="' + k + '"]').forEach(function (el) { el.textContent = v[k]; }); });
+  })();
+  var tl = gsap.timeline({ paused: true });
+${timeline}
+  window.__timelines = window.__timelines || {};
+  window.__timelines["${id}"] = tl;
+</script>
+</body>
+</html>
+`;
+}
+export const pickCaptures = (f, wide, n) => {
+    const want = wide ? 'desktop' : 'phone';
+    const boring = /^(title|menu|intro|splash|start|settings|paused?|howto|help|loading|lost|lose|over|gameover|bite|hurt)$/i;
+    const shaped = f.captures.some((c) => c.viewport === want) ? f.captures.filter((c) => c.viewport === want) : f.captures;
+    const good = shaped.filter((c) => !boring.test(c.view));
+    return (good.length ? good : shaped).slice(0, n);
+};
+const audio = (id, src, at, dur, track, more = '', len) => `  <audio id="${id}" data-start="${r2(at)}" data-duration="${r2(len ? Math.min(dur, len) : dur)}" data-track-index="${track}" src="${esc(src)}"${more}></audio>\n`;
+const game = (id, o) => `  <iframe id="${id}" class="clip game${o.cls ? ' ' + o.cls : ''}" style="${o.css}" data-start="${r2(o.at)}" data-duration="${r2(o.dur)}" data-track-index="${o.track}" data-no-timeline
+          data-fpx-game="game/index.html"${o.view ? ` data-fpx-view="${esc(o.view)}"` : ''} data-fpx-inputs='${o.inputs}'></iframe>\n`;
+function opening(open, o) {
+    if (open.kind === 'view') {
+        return { body: game('opener', { at: 0, dur: o.dur, track: 1, view: open.view, inputs: open.moment ? '[]' : 'auto', css: o.box.css }), tl: '' };
+    }
+    let body = '';
+    if (!o.full)
+        body += `  <img id="open-behind" class="clip full cover blur" src="${esc(open.file)}" alt="" data-start="0" data-duration="${r2(o.dur)}" data-track-index="0">\n`;
+    body += `  <img id="open-shot" class="clip" style="${o.box.css};object-fit:cover" src="${esc(open.file)}" alt="" data-start="0" data-duration="${r2(o.dur)}" data-track-index="1">\n`;
+    return { body, tl: `  tl.fromTo("#open-shot", { scale: 1.25 }, { scale: 1, duration: ${r2(o.dur)}, ease: "power3.out" }, 0);\n` };
+}
+export function starter(kind, f, o = {}) {
+    const aspect = o.aspect ?? STARTER_DEFAULTS[kind].aspect;
+    const S = o.seconds ?? STARTER_DEFAULTS[kind].seconds;
+    const k = S / STARTER_DEFAULTS[kind].seconds;
+    const t = (x) => r2(x * k);
+    const box = gameBox(aspect, f.orientation);
+    const vars = { title: f.title, tagline: f.tagline, caption1: 'Make your move', caption2: 'Then watch it go off', cta: kind === 'endcard' ? 'Play now' : 'Play free', ...o.vars };
+    const ad = kind === 'endcard' ? undefined : o.ad;
+    const full = box.css.startsWith('left:0;top:0;width:100vw;height:100vh');
+    let css0 = '';
+    const endTagline = ad ? `\n    <div class="tagline" data-var="tagline">${esc(vars.tagline)}</div>` : '';
+    const open = ad ? ad.open ?? { kind: 'view', view: f.playView ?? '', moment: false } : null;
+    const playOpens = open?.kind === 'view' && !open.moment && open.view === (f.playView ?? '');
+    if (open)
+        css0 += '  .hook { font-size: 7.4vmin; line-height: 1.1; padding: 2vmin 3.8vmin; max-width: 100%; }\n';
+    const id = 'main';
+    const root = `<div id="root" data-composition-id="${id}" data-start="0" data-duration="${r2(S)}" data-width="${COMPOSE_ASPECTS[aspect][0]}" data-height="${COMPOSE_ASPECTS[aspect][1]}">\n`;
+    const bg = f.keyArt ? (at, dur, track, idName, cls = 'cover') => `  <img id="${idName}" class="clip full ${cls}" src="${esc(f.keyArt)}" alt="" data-start="${r2(at)}" data-duration="${r2(dur)}" data-track-index="${track}">\n` : () => '';
+    const momentSfx = f.moment ? f.sfx[f.moment] : undefined;
+    const endSfx = f.sfx.win ?? f.sfx.finale ?? f.sfx.bloom;
+    let body = '', css = css0, tlines = '';
+    if (kind === 'trailer') {
+        const caps = pickCaptures(f, box.wide, 3);
+        body += `  <!-- Track 0: pictures behind everything. Track 1: the game, live. Track 2: words. Tracks 4+: sound. -->\n`;
+        if (open) {
+            if (open.kind === 'view' && !full && !playOpens)
+                body += bg(0, t(2), 0, 'open-keyart', 'cover blur');
+            if (!playOpens) {
+                const op = opening(open, { dur: open.kind === 'view' ? t(2) : t(2.6), box, full });
+                body += op.body;
+                tlines += op.tl;
+            }
+        }
+        else {
+            body += bg(0, t(2.6), 0, 'keyart');
+            body += `  <div id="scrim" class="clip full scrim" data-start="0" data-duration="${t(2.6)}" data-track-index="1"></div>\n`;
+            body += `  <div id="open" class="clip safe" style="justify-content:flex-end" data-start="0" data-duration="${t(2.6)}" data-track-index="2">
+    <div class="title big" data-var="title">${esc(vars.title)}</div>
+    <div class="tagline" data-var="tagline">${esc(vars.tagline)}</div>
+  </div>\n`;
+        }
+        if (!full)
+            body += playOpens ? bg(0, t(11.2), 0, 'keyart-behind', 'cover blur') : bg(t(2), t(9.2), 0, 'keyart-behind', 'cover blur');
+        body += game('game', { at: playOpens ? 0 : t(2), dur: playOpens ? t(9.2) : t(7.2), track: 1, view: f.playView, inputs: 'auto', css: box.css });
+        if (open) {
+            body += `  <div id="scrim" class="clip full scrim" data-start="0" data-duration="${t(2.6)}" data-track-index="3"></div>\n`;
+            body += `  <div id="open" class="clip safe" style="justify-content:flex-end" data-start="0" data-duration="${t(2.6)}" data-track-index="2"><div class="caption hook" data-var="caption1">${esc(vars.caption1)}</div></div>\n`;
+        }
+        if (!open)
+            body += `  <div id="cap1" class="clip safe" style="justify-content:flex-end" data-start="${t(3)}" data-duration="${t(2.6)}" data-track-index="2"><div class="caption" data-var="caption1">${esc(vars.caption1)}</div></div>\n`;
+        body += `  <div id="cap2" class="clip safe" style="justify-content:flex-end" data-start="${t(6.1)}" data-duration="${t(2.6)}" data-track-index="2"><div class="caption" data-var="caption2">${esc(vars.caption2)}</div></div>\n`;
+        if (f.moment)
+            body += game('moment', { at: t(9.2), dur: t(2), track: 1, view: f.moment, inputs: '[]', css: box.css });
+        const stripAt = f.moment ? t(11.2) : t(9.2), stripDur = t(12.6) - stripAt;
+        if (caps.length) {
+            body += bg(stripAt, r2(t(12.6) - stripAt), 0, 'keyart-strip', 'cover blur');
+            body += `  <div id="strip" class="clip full" style="display:flex;align-items:center;justify-content:center" data-start="${stripAt}" data-duration="${r2(stripDur)}" data-track-index="1">\n`;
+            const turn = caps.length === 1 ? [0] : caps.length === 2 ? [-4, 4] : [-6, 0, 6];
+            caps.forEach((c, i) => { body += `    <img id="shot${i + 1}" class="shot" style="transform:rotate(${turn[i]}deg);z-index:${i === 1 ? 2 : 1}" src="${esc(c.file)}" alt="">\n`; });
+            body += `  </div>\n`;
+            const w = box.wide ? (caps.length === 3 ? 40 : 46) : (caps.length === 3 ? 30 : 34);
+            css += `  .shot { width: ${w}vw; margin: 0 -${box.wide ? 3 : 2}vw; border-radius: 1.6vmin; border: 0.8vmin solid #fffaf0; box-shadow: 0 1.6vmin 4vmin rgba(0,0,0,0.5); }\n`;
+            tlines += `  tl.from(".shot", { y: "14vh", opacity: 0, scale: 0.85, duration: ${t(0.45)}, stagger: ${t(0.16)}, ease: "back.out(1.6)" }, ${stripAt});\n`;
+        }
+        body += bg(t(12.6), r2(S - t(12.6)), 0, 'keyart-end', 'cover blur');
+        body += `  <div id="end" class="clip safe" style="justify-content:center;gap:4vmin" data-start="${t(12.6)}" data-duration="${r2(S - t(12.6))}" data-track-index="2">
+    <div class="title big" data-var="title">${esc(vars.title)}</div>${endTagline}
+    <div class="cta" data-var="cta">${esc(vars.cta)}</div>
+  </div>\n`;
+        if (f.music)
+            body += audio('bed', f.music, 0, S, 4, ' data-volume="0.8" data-fade-in="0.4" data-fade-out="1.6"', f.lengths?.[f.music]);
+        if (momentSfx && f.moment)
+            body += audio('moment-sfx', momentSfx, t(9.4), 1.5, 5, '', f.lengths?.[momentSfx]);
+        if (endSfx)
+            body += audio('end-sfx', endSfx, t(12.6), 2, 5, ' data-volume="0.7"', f.lengths?.[endSfx]);
+        tlines += open
+            ? `  tl.from("#open .caption", { scale: 0.7, opacity: 0, duration: ${t(0.35)}, ease: "back.out(2.4)" }, ${t(0.1)});
+  tl.to("#open", { opacity: 0, duration: ${t(0.4)} }, ${t(2.2)});
+${open.kind === 'image' ? `  tl.fromTo("#game", { opacity: 0 }, { opacity: 1, duration: ${t(0.5)} }, ${t(2)});\n` : ''}`
+            : `  tl.fromTo("#keyart", { scale: 1.12 }, { scale: 1, duration: ${t(2.6)}, ease: "power2.out" }, 0);
+  tl.from("#open .title", { y: "6vh", opacity: 0, scale: 0.85, duration: ${t(0.7)}, ease: "back.out(2)" }, ${t(0.25)});
+  tl.from("#open .tagline", { y: "3vh", opacity: 0, duration: ${t(0.5)} }, ${t(0.8)});
+  tl.to("#open", { opacity: 0, duration: ${t(0.4)} }, ${t(2.2)});
+  tl.fromTo("#game", { opacity: 0 }, { opacity: 1, duration: ${t(0.5)} }, ${t(2)});
+  tl.from("#cap1 .caption", { y: "4vh", opacity: 0, duration: ${t(0.35)}, ease: "back.out(2)" }, ${t(3)});
+`;
+        tlines += `  tl.from("#cap2 .caption", { y: "4vh", opacity: 0, duration: ${t(0.35)}, ease: "back.out(2)" }, ${t(6.1)});
+  tl.from("#end .title", { scale: 0.6, opacity: 0, duration: ${t(0.6)}, ease: "back.out(2.2)" }, ${t(12.7)});
+${open ? `  tl.from("#end .tagline", { opacity: 0, duration: ${t(0.4)} }, ${t(13)});\n` : ''}  tl.from("#end .cta", { y: "5vh", opacity: 0, duration: ${t(0.45)}, ease: "back.out(2)" }, ${t(13.2)});
+`;
+    }
+    else if (kind === 'post') {
+        const hook = open ? null : pickCaptures(f, box.wide, 1)[0];
+        if (!full)
+            body += bg(0, S, 0, 'keyart-behind', 'cover blur');
+        if (open && !playOpens) {
+            const op = opening(open, { dur: open.kind === 'view' ? t(1.2) : t(1.4), box, full });
+            body += op.body;
+            tlines += op.tl;
+        }
+        if (hook)
+            body += `  <img id="hook-shot" class="clip" style="${box.css};object-fit:cover" src="${esc(hook.file)}" alt="" data-start="0" data-duration="${t(1.4)}" data-track-index="1">\n`;
+        body += game('game', { at: playOpens ? 0 : t(1.2), dur: playOpens ? t(8.2) : t(7), track: 1, view: f.playView, inputs: 'auto', css: box.css });
+        body += open
+            ? `  <div id="hook" class="clip safe" style="justify-content:flex-start" data-start="0" data-duration="${t(3.4)}" data-track-index="2"><div class="caption hook" data-var="caption1">${esc(vars.caption1)}</div></div>\n`
+                + `  <div id="cap1" class="clip safe" style="justify-content:flex-start" data-start="${t(3.4)}" data-duration="${t(4.8)}" data-track-index="2"><div class="caption" data-var="caption2">${esc(vars.caption2)}</div></div>\n`
+            : `  <div id="hook" class="clip safe" style="justify-content:flex-start" data-start="0" data-duration="${t(3.4)}" data-track-index="2"><div class="caption" data-var="tagline">${esc(vars.tagline)}</div></div>\n`
+                + `  <div id="cap1" class="clip safe" style="justify-content:flex-start" data-start="${t(3.4)}" data-duration="${t(4.8)}" data-track-index="2"><div class="caption" data-var="caption1">${esc(vars.caption1)}</div></div>\n`;
+        body += bg(t(8.2), r2(S - t(8.2)), 0, 'keyart-end', 'cover blur');
+        body += `  <div id="end" class="clip safe" style="justify-content:center;gap:4vmin" data-start="${t(8.2)}" data-duration="${r2(S - t(8.2))}" data-track-index="2">
+    <div class="title" data-var="title">${esc(vars.title)}</div>${endTagline}
+    <div class="cta" data-var="cta">${esc(vars.cta)}</div>
+  </div>\n`;
+        const hookSfx = (open && f.sfx[open.view]) || momentSfx;
+        if (f.music)
+            body += audio('bed', f.music, 0, S, 4, ' data-volume="0.8" data-fade-in="0.2" data-fade-out="1.2"', f.lengths?.[f.music]);
+        if (hookSfx)
+            body += audio('hook-sfx', hookSfx, 0.05, 1.5, 5, '', f.lengths?.[hookSfx]);
+        if (endSfx)
+            body += audio('end-sfx', endSfx, t(8.2), 1.8, 5, ' data-volume="0.7"', f.lengths?.[endSfx]);
+        tlines += `${hook ? `  tl.fromTo("#hook-shot", { scale: 1.25 }, { scale: 1, duration: ${t(1.4)}, ease: "power3.out" }, 0);\n` : ''}  tl.from("#hook .caption", { scale: 0.7, opacity: 0, duration: ${t(0.4)}, ease: "back.out(2.4)" }, ${t(0.1)});
+  tl.from("#cap1 .caption", { y: "-3vh", opacity: 0, duration: ${t(0.35)}, ease: "back.out(2)" }, ${t(3.4)});
+  tl.from("#end .title", { scale: 0.6, opacity: 0, duration: ${t(0.5)}, ease: "back.out(2.2)" }, ${t(8.3)});
+${open ? `  tl.from("#end .tagline", { opacity: 0, duration: ${t(0.35)} }, ${t(8.5)});\n` : ''}  tl.from("#end .cta", { y: "4vh", opacity: 0, duration: ${t(0.4)}, ease: "back.out(2)" }, ${t(8.7)});
+`;
+    }
+    else {
+        if (!full)
+            body += bg(0, S, 0, 'keyart-behind', 'cover blur');
+        const cssBox = full ? box.css : box.css.replace(/top:[\d.]+vh/, 'top:calc(var(--safe-top) + 1vh)');
+        body += game('game', { at: 0, dur: S, track: 1, view: f.playView, inputs: 'auto', css: cssBox, cls: full ? 'dim' : 'soft' });
+        css += `  .dim { filter: blur(0.6vmin) brightness(0.6) saturate(1.1); transform: scale(1.04); }\n  .soft { border-radius: 2vmin; box-shadow: 0 1.6vmin 4vmin rgba(0,0,0,0.5); }\n  .art { width: 40vmin; height: 40vmin; object-fit: cover; border-radius: 6vmin; box-shadow: 0 1.6vmin 0 var(--accent), 0 3vmin 6vmin rgba(0,0,0,0.5); }\n`;
+        body += `  <div id="card" class="clip safe" style="justify-content:${full ? 'center' : 'flex-end'};gap:3.6vmin" data-start="${t(0.3)}" data-duration="${r2(S - t(0.3))}" data-track-index="2">
+${f.keyArt && full ? `    <img class="art" src="${esc(f.keyArt)}" alt="">\n` : ''}    <div class="title" data-var="title">${esc(vars.title)}</div>
+    <div class="tagline" data-var="tagline">${esc(vars.tagline)}</div>
+    <div class="cta" id="install" data-var="cta">${esc(vars.cta)}</div>
+  </div>\n`;
+        if (f.music)
+            body += audio('bed', f.music, 0, S, 4, ' data-volume="0.7" data-fade-in="0.3" data-fade-out="0.8"', f.lengths?.[f.music]);
+        if (endSfx)
+            body += audio('end-sfx', endSfx, t(0.3), 1.8, 5, ' data-volume="0.7"', f.lengths?.[endSfx]);
+        const pulses = Math.max(1, Math.floor((S - t(1.6)) / 0.9));
+        tlines += `${f.keyArt && full ? `  tl.from("#card .art", { scale: 0.4, opacity: 0, duration: ${t(0.5)}, ease: "back.out(2)" }, ${t(0.3)});\n` : ''}  tl.from("#card .title", { y: "4vh", opacity: 0, duration: ${t(0.4)} }, ${t(0.6)});
+  tl.from("#card .tagline", { opacity: 0, duration: ${t(0.4)} }, ${t(0.9)});
+  tl.from("#install", { scale: 0, duration: ${t(0.45)}, ease: "back.out(2.6)" }, ${t(1.2)});
+  // A finite pulse (never repeat: -1): every frame of the render is a seek, and the timeline has an end.
+  tl.to("#install", { scale: 1.08, duration: 0.45, yoyo: true, repeat: ${pulses * 2 - 1}, ease: "sine.inOut" }, ${t(1.7)});
+`;
+    }
+    return head({ title: f.title, aspect, vars, palette: f.palette, css })
+        + root + body + '</div>\n' + tail(id, tlines);
+}

package/dist/compose/variations.js

@@ -0,0 +1,203 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { COMPOSE_ASPECT_NAMES, COMPOSE_LIMITS, tagsOf } from "./contract.js";
+import { pickCaptures, starter } from "./starters.js";
+export const ADS_BRIEF = 'design/compose/ads.json';
+export const ADS_COMPOSITIONS = 'design/compose/ads';
+export const ADS_OUT = '.funtools/compose/ads';
+export const ADS_MAX = { default: 12, limit: 60 };
+export const POST_UP_TO_S = 12;
+export const SELECTION_RULE = 'each next cut is the one that shows the most hooks, calls to action, lengths and aspects not yet shown; '
+    + 'then the most pairs not yet shown (hook × cta, hook × length, hook × aspect, cta × length, cta × aspect, length × aspect); '
+    + 'then the values used least so far; then the brief\'s own order';
+const text = (v) => (typeof v === 'string' && v.trim() ? v.trim() : null);
+export function readBrief(raw, max) {
+    const errors = [], warnings = [];
+    const b = (raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : {});
+    const list = (k) => (Array.isArray(b[k]) ? b[k] : (errors.push(`"${k}" is a list`), []));
+    const hooks = [];
+    for (const [i, h] of list('hooks').entries()) {
+        const line = text(typeof h === 'string' ? h : h?.line);
+        if (!line) {
+            errors.push(`hooks[${i}] has no "line": {"line": "Bugs don't pop. They sneeze.", "moment": "chain"}`);
+            continue;
+        }
+        hooks.push({ line, moment: typeof h === 'object' && h ? text(h.moment) : null });
+    }
+    const ctas = list('ctas').map((c, i) => text(c) ?? (errors.push(`ctas[${i}] is not words: "Play now"`), '')).filter(Boolean);
+    const lengths = list('lengths').map(Number).filter((n, i) => {
+        const ok = Number.isFinite(n) && n >= COMPOSE_LIMITS.seconds[0] && n <= COMPOSE_LIMITS.seconds[1];
+        if (!ok)
+            errors.push(`lengths[${i}] is seconds from ${COMPOSE_LIMITS.seconds.join(' to ')}`);
+        return ok;
+    });
+    const aspects = list('aspects').map((a, i) => {
+        const v = String(a).replace('x', ':');
+        if (!COMPOSE_ASPECT_NAMES.includes(v))
+            errors.push(`aspects[${i}] "${a}" is one of ${COMPOSE_ASPECT_NAMES.join(', ')}`);
+        return v;
+    }).filter((v) => COMPOSE_ASPECT_NAMES.includes(v));
+    for (const [k, v] of [['hooks', hooks.map((h) => `${h.line}|${h.moment}`)], ['ctas', ctas], ['lengths', lengths.map(String)], ['aspects', aspects]]) {
+        if (!v.length && Array.isArray(b[k]))
+            errors.push(`"${k}" is empty: one at least`);
+        if (new Set(v).size < v.length)
+            warnings.push(`"${k}" names one value twice: it is made once`);
+    }
+    const ec = (b.end_card && typeof b.end_card === 'object' ? b.end_card : {});
+    const m = max ?? (b.max === undefined ? ADS_MAX.default : Number(b.max));
+    if (!(Number.isInteger(m) && m >= 1 && m <= ADS_MAX.limit))
+        errors.push(`max is a whole number from 1 to ${ADS_MAX.limit} (default ${ADS_MAX.default})`);
+    if (errors.length)
+        return { errors };
+    const uniq = (xs, key = String) => xs.filter((x, i) => xs.findIndex((y) => key(y) === key(x)) === i);
+    return {
+        brief: {
+            hooks: uniq(hooks, (h) => `${h.line}|${h.moment}`), ctas: uniq(ctas), lengths: uniq(lengths), aspects: uniq(aspects),
+            end_card: { ...(text(ec.title) ? { title: text(ec.title) } : {}), ...(text(ec.tagline) ? { tagline: text(ec.tagline) } : {}) }, max: m,
+        },
+        warnings,
+    };
+}
+export function selectCuts(sizes, max) {
+    const all = [];
+    for (let h = 0; h < sizes[0]; h++)
+        for (let c = 0; c < sizes[1]; c++)
+            for (let l = 0; l < sizes[2]; l++)
+                for (let a = 0; a < sizes[3]; a++)
+                    all.push([h, c, l, a]);
+    const used = sizes.map((n) => new Array(n).fill(0));
+    const pairs = new Set();
+    const pairKeys = (p) => {
+        const out = [];
+        for (let i = 0; i < 4; i++)
+            for (let j = i + 1; j < 4; j++)
+                out.push(`${i}:${p[i]}|${j}:${p[j]}`);
+        return out;
+    };
+    const taken = new Set();
+    const out = [];
+    while (out.length < Math.min(max, all.length)) {
+        let best = -1, bestScore = [-1, -1, Infinity];
+        for (let k = 0; k < all.length; k++) {
+            if (taken.has(k))
+                continue;
+            const p = all[k];
+            const fresh = p.filter((v, d) => used[d][v] === 0).length;
+            const newPairs = pairKeys(p).filter((x) => !pairs.has(x)).length;
+            const load = p.reduce((s, v, d) => s + used[d][v], 0);
+            const better = fresh > bestScore[0] || (fresh === bestScore[0] && (newPairs > bestScore[1] || (newPairs === bestScore[1] && load < bestScore[2])));
+            if (better) {
+                best = k;
+                bestScore = [fresh, newPairs, load];
+            }
+        }
+        taken.add(best);
+        const p = all[best];
+        p.forEach((v, d) => { used[d][v]++; });
+        for (const x of pairKeys(p))
+            pairs.add(x);
+        out.push(p);
+    }
+    return out;
+}
+export function coverage(picks, sizes) {
+    const counts = sizes.map((n) => new Array(n).fill(0));
+    const seen = new Map();
+    for (const p of picks) {
+        p.forEach((v, d) => { counts[d][v]++; });
+        for (let i = 0; i < 4; i++)
+            for (let j = i + 1; j < 4; j++) {
+                const k = `${i}:${p[i]}|${j}:${p[j]}`;
+                seen.set(k, (seen.get(k) ?? 0) + 1);
+            }
+    }
+    let of = 0;
+    for (let i = 0; i < 4; i++)
+        for (let j = i + 1; j < 4; j++)
+            of += sizes[i] * sizes[j];
+    return { counts, pairs: { shown: seen.size, of }, repeats: [...seen.values()].reduce((s, n) => s + n - 1, 0) };
+}
+export function resolveOpening(moment, f) {
+    const wide = f.orientation === 'landscape';
+    const moments = f.moments ?? (f.moment ? [f.moment] : []);
+    const views = f.views ?? [];
+    if (!moment) {
+        if (f.moment)
+            return { open: { kind: 'view', view: f.moment, moment: true }, says: `the "${f.moment}" moment, live` };
+        const c = pickCaptures(f, wide, 1)[0];
+        if (c)
+            return { open: { kind: 'image', file: c.file, view: c.view }, says: `the capture ${basename(c.file)}` };
+        return { open: null, says: 'play, live from its first frame' };
+    }
+    const shot = f.captures.find((c) => c.file === moment || basename(c.file).replace(/\.png$/i, '') === moment);
+    if (shot)
+        return { open: { kind: 'image', file: shot.file, view: shot.view }, says: `the capture ${basename(shot.file)}` };
+    if (moments.includes(moment))
+        return { open: { kind: 'view', view: moment, moment: true }, says: `the "${moment}" moment, live` };
+    if (views.includes(moment) || moment === f.playView)
+        return { open: { kind: 'view', view: moment, moment: false }, says: `the "${moment}" view, live` };
+    return {
+        open: { kind: 'view', view: moment, moment: false }, says: `the "${moment}" view, live`,
+        warn: `"${moment}" is no capture and no view in .funtools/capture/index.json: it opens as the view "${moment}", and the probe says whether the game has it (funtools capture --all lists them)`,
+    };
+}
+export const starterFor = (seconds) => (seconds <= POST_UP_TO_S ? 'post' : 'trailer');
+const secs = (n) => `${Math.round(n * 100) / 100}s`;
+export function planVariations(b, f) {
+    const sizes = [b.hooks.length, b.ctas.length, b.lengths.length, b.aspects.length];
+    const picks = selectCuts(sizes, b.max);
+    const openings = b.hooks.map((h) => resolveOpening(h.moment, f));
+    const warnings = openings.flatMap((o, i) => (o.warn ? [`hook ${i + 1}: ${o.warn}`] : []));
+    const variations = picks.map(([h, c, l, a], i) => {
+        const seconds = b.lengths[l], aspect = b.aspects[a];
+        const id = `${String(i + 1).padStart(2, '0')}-h${h + 1}-c${c + 1}-${aspect.replace(':', 'x')}-${secs(seconds)}`;
+        return {
+            id, hook: { ...b.hooks[h], index: h }, cta: b.ctas[c], ctaIndex: c, seconds, aspect, starter: starterFor(seconds),
+            open: openings[h].open, opens: openings[h].says, composition: `${ADS_COMPOSITIONS}/${id}.html`,
+            vars: { title: b.end_card.title ?? f.title, tagline: b.end_card.tagline ?? f.tagline, caption1: b.hooks[h].line, cta: b.ctas[c] },
+        };
+    });
+    return { variations, possible: sizes.reduce((x, y) => x * y, 1), warnings, picks };
+}
+export const variationHtml = (v, f) => starter(v.starter, f, { aspect: v.aspect, seconds: v.seconds, vars: v.vars, ad: { open: v.open } });
+export const hookAt = (v) => Math.round((v.starter === 'post' ? 0.09 : 0.08) * v.seconds * 1000) / 1000;
+const ENT = { amp: '&', lt: '<', gt: '>', quot: '"', apos: "'", nbsp: ' ', '#39': "'" };
+const plain = (s) => s.replace(/<[^>]*>/g, ' ').replace(/&(#?\w+);/g, (m, e) => ENT[e] ?? (e.startsWith('#') ? String.fromCodePoint(Number(e.slice(1).replace(/^x/i, '0x'))) : m)).replace(/\s+/g, ' ').trim();
+export function ctaOfPlayable(html) {
+    for (const t of tagsOf(html)) {
+        const href = t.attrs.href ?? '';
+        const marked = [t.attrs.id, t.attrs.class, t.attrs['data-cta'] !== undefined ? 'cta' : undefined]
+            .filter((x) => !!x).some((x) => /cta|install|download/i.test(x));
+        const store = /apps\.apple\.com|play\.google\.com|itunes\.apple\.com/.test(href);
+        if (!((t.name === 'a' && store) || marked || /mraid\.open/.test(t.attrs.onclick ?? '')))
+            continue;
+        const rest = html.slice(t.index + t.raw.length);
+        const close = new RegExp(`</${t.name}\\s*>`, 'i').exec(rest);
+        const words = plain(close ? rest.slice(0, close.index) : '');
+        if (words && words.length <= 40)
+            return words;
+    }
+    return null;
+}
+export function playableWords(dir) {
+    for (const source of ['dist-playable/index.html', 'playable.html']) {
+        const file = join(dir, source);
+        if (!existsSync(file))
+            continue;
+        return { source, words: ctaOfPlayable(readFileSync(file, 'utf8')) };
+    }
+    return null;
+}
+export const sameWords = (a, b) => {
+    const n = (s) => s.toLowerCase().normalize('NFKD').replace(/[^\p{L}\p{N}]+/gu, ' ').trim();
+    return n(a) === n(b);
+};
+export function ctaCheck(cta, p) {
+    if (!p)
+        return { id: 'cta', state: 'not_observed', says: 'no playable to match (funtools playable builds dist-playable/)' };
+    if (p.words === null)
+        return { id: 'cta', state: 'not_observed', says: `${p.source} shows no call to action in its markup (drawn in code?): match it by hand` };
+    return sameWords(cta, p.words)
+        ? { id: 'cta', state: 'pass', says: `"${cta}" is the playable's own words` }
+        : { id: 'cta', state: 'warn', says: `"${cta}" is not the playable's "${p.words}" (${p.source}): the ad and the playable it opens say different things` };
+}

package/dist/criteria.js

@@ -0,0 +1,35 @@
+export const CRITERIA_KINDS = ['mechanic', 'progression', 'feedback', 'presentation', 'onboarding'];
+export const CRITERIA_RANGE = [7, 10];
+const SOURCE_WORDS = /\b(src\/|function|variable|the code|in code|constant|class|module|__FPX_\w+|\.ts\b|\.js\b)/i;
+export function criteriaOf(manifest) {
+    const raw = manifest?.criteria;
+    if (raw === undefined)
+        return { criteria: [], problems: [] };
+    if (!Array.isArray(raw))
+        return { criteria: [], problems: ['"criteria" is not a list'] };
+    const criteria = [];
+    const problems = [];
+    const ids = new Set();
+    raw.forEach((c, i) => {
+        const text = (typeof c === 'string' ? c : typeof c?.text === 'string' ? c.text : '').trim();
+        if (!text) {
+            problems.push(`criterion ${i + 1} has no text`);
+            return;
+        }
+        const id = typeof c?.id === 'string' && c.id.trim() ? c.id.trim() : `C${i + 1}`;
+        if (ids.has(id))
+            problems.push(`criterion id ${id} is used twice`);
+        ids.add(id);
+        const kind = typeof c?.kind === 'string' && CRITERIA_KINDS.includes(c.kind) ? c.kind : '';
+        if (typeof c?.kind === 'string' && !kind)
+            problems.push(`criterion ${id}: kind "${c.kind}" is not one of ${CRITERIA_KINDS.join(', ')}`);
+        if (SOURCE_WORDS.test(text))
+            problems.push(`criterion ${id} points into the code ("${text.slice(0, 50)}"): say what a player sees`);
+        criteria.push({ id, text, kind });
+    });
+    const [lo, hi] = CRITERIA_RANGE;
+    if (criteria.length && (criteria.length < lo || criteria.length > hi))
+        problems.push(`${criteria.length} criteria; write ${lo} to ${hi}`);
+    return { criteria, problems };
+}
+export const criteriaText = (criteria) => criteria.map((c) => `- ${c.id}${c.kind ? ` (${c.kind})` : ''}: ${c.text}`).join('\n');

package/dist/depth/experience.js

@@ -0,0 +1,61 @@
+import { DIMENSIONS, EXPERIENCE_LABEL as DIMENSION_NAME } from "../gdd/rubric.js";
+import { pacingLine } from "./pacing.js";
+export { DIMENSIONS, DIMENSION_NAME };
+export const SLICE_CEILING = {
+    depth: null, content: 4, replay: 6, story: null, world: 6, arc: 6, originality: null,
+};
+const mmss = (s) => `${Math.floor(s / 60)}:${String(Math.round(s % 60)).padStart(2, '0')}`;
+export function experienceFacts(x) {
+    const out = [];
+    const cohorts = x.sim?.cohorts ?? [];
+    if (cohorts.length) {
+        const by = (r) => cohorts.find((c) => c.role === r);
+        const row = (r) => { const c = by(r); return c ? `${r} progress ${c.progress.mean}, won ${c.won}/${c.seeds}, run ${mmss(c.meanSeconds)}` : null; };
+        out.push({ instrument: 'sim (bots on the rules over seeds: skill spread and run length)', text: ['skilled', 'naive', 'novice', 'idle'].map(row).filter(Boolean).join('; ') });
+        const ceiling = x.sim?.findings?.find((f) => f.id === 'skill-ceiling');
+        if (ceiling)
+            out.push({ instrument: `sim (skill ceiling, ${ceiling.state})`, text: ceiling.says });
+    }
+    else
+        out.push({ instrument: 'sim', text: 'not measured (no test/probes.ts): the spread between a skilled, a naive and a novice player is unknown' });
+    const feel = (x.feel?.findings ?? []).filter((f) => f.state !== 'not measured');
+    if (feel.length)
+        out.push({ instrument: 'feel (the verb traced through the real controls)', text: `${feel.filter((f) => f.state === 'ok').length} ok, ${feel.filter((f) => f.state === 'note').length} gap(s): ${feel.slice(0, 4).map((f) => f.says).join('; ').slice(0, 360)}` });
+    else
+        out.push({ instrument: 'feel', text: 'not measured (no test/feel.json): the verb\'s numbers and forgiveness windows are unknown' });
+    const d = x.design;
+    if (d.file) {
+        const tables = d.tables.filter((t) => t.kind !== 'other').map((t) => `${t.heading} ${t.rows}`).join(', ');
+        out.push({ instrument: `the design document's content tables (${d.file}; claims, not evidence)`, text: `${d.places} place or stage row(s), ${d.kinds} kind row(s)${tables ? ` (${tables})` : ''}; ${d.debutColumn ? 'a debut column says when each arrives' : 'no debut column'}` });
+    }
+    else
+        out.push({ instrument: 'design document', text: 'none (design/GDD.md or design/README.md): nothing is declared' });
+    const s = x.shipped;
+    if (x.story)
+        out.push({ instrument: 'story beats (the design\'s ## Story table against __FPX_STATE__.beat in real play)', text: x.story });
+    out.push({ instrument: 'shipped files (counted, not judged)', text: `${s.images} picture(s), ${s.sounds} sound(s), ${s.music} music track(s), ${s.models} model(s); ${s.text.length} line(s) and ${s.words} words a player can read` });
+    const played = byEvidence(x.pacing);
+    if (played.length) {
+        const total = played.reduce((n, p) => n + (p.playSeconds ?? p.seconds), 0);
+        const places = new Set(played.flatMap((p) => p.places.map((v) => `${p.placeField}:${v}`)));
+        const claimed = d.file && d.places && places.size ? `; the design declares ${d.places} place or stage row(s) and play reached ${places.size}${places.size < d.places ? ': the rest is claimed, not yet shown' : ''}` : '';
+        out.push({ instrument: 'pacing (real play: blind rounds and journeys, on game time)', text: `${played.length} session(s), ${mmss(total)} of play in all; ${places.size ? `${places.size} distinct place value(s) reached` : 'no place field read'}${claimed}` });
+        out.push({ instrument: 'pacing (the beat strip of the latest filed blind round, else the longest run: screens, places, firsts, payoffs, endings, tension)', text: pacingLine(played[0]) });
+    }
+    else
+        out.push({ instrument: 'pacing', text: 'not measured: no play round or journey run with the game\'s state was found (funtools play, funtools journey)' });
+    if (x.comeBack.length) {
+        for (const c of x.comeBack.slice(-2))
+            out.push({ instrument: `blind player, round ${c.round}${c.played_minutes !== null ? ` (${c.played_minutes} min of play)` : ''}: "would you come back tomorrow, and why?"`, text: `${c.answer}: ${c.why}${c.first ? `; first thing: ${c.first}` : ''}`.slice(0, 400) });
+    }
+    else
+        out.push({ instrument: 'blind player', text: 'the come-back question was not asked (funtools play --long N asks it at the end of a long session)' });
+    if (x.gdd) {
+        const said = (n) => DIMENSIONS.filter((k) => (x.gdd[k] ?? 0) === n).map((k) => DIMENSION_NAME[k]);
+        out.push({ instrument: 'funtools gdd (which experience dimensions the design document addresses)', text: `answered: ${said(2).join(', ') || 'none'}; named only: ${said(1).join(', ') || 'none'}; not addressed: ${said(0).join(', ') || 'none'}` });
+    }
+    return out.map((f, i) => ({ id: `X${i + 1}`, ...f }));
+}
+const roundOf = (p) => (/no report/.test(p.source) || (p.playSeconds ?? p.seconds) < 30 ? -1 : Number(/^blind round (\d+)/.exec(p.source)?.[1] ?? -1));
+export const byEvidence = (ps) => [...ps].sort((a, b) => roundOf(b) - roundOf(a) || b.seconds - a.seconds);
+export const experienceText = (facts) => facts.map((f) => `- ${f.id} · ${f.instrument}: ${f.text}`).join('\n');