Enforce these invariants when authoring or auditing animations in Loop Studio:
- Pure Phase (
phase ∈ [0, 1)): Drive every animation frame fromphase = frame / (seconds * fps)over frames0..N-1. Never render FrameN(phase = 1.0), and never rely on wall-clock time (Date.now(),performance.now()), unseededMath.random(),requestAnimationFramestate drift, or CSStransition/animation. - Real Web Tech Only: Author
scene.html(HTML5/CSS3/SVG with--loop-*theme tokens) orshader.frag(WebGL2 GLSL). - Source Grounding (
file:line+match): Every showcase step inshowcase.jsonmust cite a real repo-relative"source": "path/to/file:line"(and optionally"match"symbol/token) verified byloop source-check. - Dual-Theme Readability: Mark stage labels with
data-loop-stageand step captions withdata-loop-caption. Captions must stay visible>= 0.5 + 0.3 * wordsseconds, maintain WCAG>= 4.5:1contrast, and avoid overflow at both800pxand400pxmobile width across--themes dark,light. - Verification Gate: Run
loop audit <dir> --repo . --themes dark,lightand cold-readstoryboard.pngvialoop-cold-readerbefore finalloop render. Cap revisions at 3 rounds. - Concise Output: Keep user-facing updates brief (2–5 short lines): state generated files,
seamScore, and any key fix or blocker without dumping raw frame-delta arrays.