dsh-hyperframes 0.1.1 → 0.3.0

package/skills/embedded-captions/dna/cream.json

@@ -0,0 +1,69 @@
+{
+  "name": "cream",
+  "title": "Warm cream — the poetic default",
+  "register": "premium-warm",
+  "when": "dark / mid-tone warm scenes (band luma < 150): studios, evening interiors, moody interviews. Introspective, narrative, emotional content. The successor of cinematic-cream.",
+  "font": {
+    "family": "Inter",
+    "weights": [500, 600, 700, 900]
+  },
+  "palette": {
+    "scheme": "light-on-dark",
+    "cap_color": "#fff5df",
+    "blend": "screen",
+    "accent": "scene",
+    "accent_fallback": "#e3c06a"
+  },
+  "optics": {
+    "depthMatch": true,
+    "contactShadow": true,
+    "warmBloom": true
+  },
+  "filter": "contrast(1.08)",
+  "motion": {
+    "soft": {
+      "y": 8,
+      "blur": 2.5,
+      "dur": 0.5,
+      "ease": "power2.out"
+    },
+    "present": {
+      "y": 6,
+      "blur": 1.5,
+      "scale": 1.03,
+      "dur": 0.3,
+      "ease": "power3.out"
+    },
+    "impact": {
+      "y": 12,
+      "blur": 1.5,
+      "scale": 1.08,
+      "dur": 0.24,
+      "ease": "power4.out"
+    },
+    "exit": {
+      "dur": 0.45,
+      "y": -8,
+      "ease": "sine.in",
+      "stagger": 0
+    }
+  },
+  "hero": {
+    "entrance": "emergence",
+    "perLetter": true,
+    "letterStagger": 0.016,
+    "glow": 0.3,
+    "dimOthers": 0.45,
+    "breathe": 0.012,
+    "case": "uppercase",
+    "tracking": "-0.03em",
+    "sizeRange": [0.2, 0.34],
+    "letterBlur": 2.5
+  },
+  "css": "",
+  "deliveries": {
+    "home": "column",
+    "rail": "validated",
+    "note": "standard-mode lineage IS cinematic-cream; validated std renders (jimeng)"
+  }
+}

package/skills/embedded-captions/dna/documentary.json

@@ -0,0 +1,62 @@
+{
+  "name": "documentary",
+  "title": "Documentary — Errol Morris dignity",
+  "register": "formal",
+  "when": "interviews, serious subject matter, journalism, testimonial. Burn-in reveals (no animation), bone on charcoal, a deliberately modest hero. Gravitas IS the style — stillness, no accent color, no glow.",
+  "font": {
+    "family": "Inter",
+    "weights": [500, 700]
+  },
+  "palette": {
+    "scheme": "light-on-dark",
+    "cap_color": "#F5EFE6",
+    "blend": "normal",
+    "accent": "#F5EFE6",
+    "accent_fallback": "#F5EFE6"
+  },
+  "optics": {
+    "depthMatch": true,
+    "contactShadow": true,
+    "warmBloom": false
+  },
+  "filter": "none",
+  "motion": {
+    "soft": {
+      "reveal": "burn"
+    },
+    "present": {
+      "y": 0,
+      "dur": 0.18,
+      "ease": "power1.out"
+    },
+    "impact": {
+      "y": 6,
+      "scale": 1.03,
+      "dur": 0.2,
+      "ease": "power2.out"
+    },
+    "exit": {
+      "dur": 0.15,
+      "ease": "power1.in",
+      "stagger": 0
+    }
+  },
+  "hero": {
+    "entrance": "rise",
+    "perLetter": false,
+    "letterStagger": 0,
+    "glow": 0,
+    "dimOthers": 0.3,
+    "breathe": 0,
+    "case": "none",
+    "tracking": "-0.015em",
+    "sizeRange": [0.09, 0.15],
+    "css": "font-weight: 700;"
+  },
+  "css": "",
+  "deliveries": {
+    "home": "column",
+    "rail": "unvalidated",
+    "note": "the lower-third IS documentary's home register (Errol Morris); column stays deliberately modest"
+  }
+}

package/skills/embedded-captions/dna/editorial.json

@@ -0,0 +1,70 @@
+{
+  "name": "editorial",
+  "title": "Editorial — serif voice, magazine cadence",
+  "register": "editorial-luxe",
+  "when": "introspective monologue, fashion / beauty, poetic or lyrical content, premium brand films on mid/dark scenes. The serif italic carries intimacy that a grotesque can't. The hero stays lowercase italic — elegance over shout.",
+  "font": {
+    "family": "Bodoni Moda",
+    "weights": [400, 700]
+  },
+  "palette": {
+    "scheme": "light-on-dark",
+    "cap_color": "#f2ead8",
+    "blend": "screen",
+    "accent": "scene",
+    "accent_fallback": "#c9a36a"
+  },
+  "optics": {
+    "depthMatch": true,
+    "contactShadow": true,
+    "warmBloom": true
+  },
+  "filter": "contrast(1.06)",
+  "motion": {
+    "soft": {
+      "x": -10,
+      "y": 0,
+      "dur": 0.55,
+      "ease": "power2.out"
+    },
+    "present": {
+      "x": -8,
+      "y": 0,
+      "scale": 1.02,
+      "dur": 0.34,
+      "ease": "power2.out"
+    },
+    "impact": {
+      "x": -10,
+      "y": 0,
+      "scale": 1.06,
+      "dur": 0.28,
+      "ease": "power3.out"
+    },
+    "exit": {
+      "dur": 0.4,
+      "x": 8,
+      "ease": "sine.in",
+      "stagger": 0.07
+    }
+  },
+  "hero": {
+    "entrance": "emergence",
+    "perLetter": true,
+    "letterStagger": 0.022,
+    "glow": 0.18,
+    "dimOthers": 0.5,
+    "breathe": 0.01,
+    "case": "none",
+    "tracking": "-0.01em",
+    "sizeRange": [0.18, 0.3],
+    "css": "font-style: italic; font-weight: 700;",
+    "letterBlur": 1.5
+  },
+  "css": "",
+  "deliveries": {
+    "home": "column",
+    "rail": "unvalidated",
+    "note": "italic serif rail reads fine; the signature x-glide + line cascade-out exits don't exist in the std enum"
+  }
+}

package/skills/embedded-captions/dna/glitch.json

@@ -0,0 +1,82 @@
+{
+  "name": "glitch",
+  "title": "Glitch — signal corruption",
+  "register": "loud-cyber",
+  "when": "digital / hacker / AI / dystopia content; anything that wants the captions to feel like a corrupted feed. RGB-split echoes snap together as each beat lands; timing is machine-percussive; nothing eases politely.",
+  "font": {
+    "family": "Space Grotesk",
+    "weights": [400, 700]
+  },
+  "palette": {
+    "scheme": "light-on-dark",
+    "cap_color": "#eaffff",
+    "blend": "screen",
+    "accent": "#ff3df0",
+    "accent_fallback": "#ff3df0"
+  },
+  "optics": {
+    "depthMatch": false,
+    "contactShadow": false,
+    "warmBloom": false
+  },
+  "filter": "none",
+  "motion": {
+    "soft": {
+      "x": -6,
+      "stretchX": 1.12,
+      "dur": 0.12,
+      "ease": "power4.out"
+    },
+    "present": {
+      "x": -8,
+      "stretchX": 1.18,
+      "dur": 0.11,
+      "ease": "power4.out"
+    },
+    "impact": {
+      "x": -10,
+      "stretchX": 1.25,
+      "dur": 0.1,
+      "ease": "power4.out"
+    },
+    "exit": {
+      "dur": 0.1,
+      "scale": 1.02,
+      "ease": "power4.in",
+      "stagger": 0
+    }
+  },
+  "hero": {
+    "entrance": "settle",
+    "perLetter": false,
+    "letterStagger": 0,
+    "glow": 0.18,
+    "dimOthers": 0.45,
+    "breathe": 0,
+    "ripple": 2,
+    "case": "uppercase",
+    "tracking": "0.01em",
+    "sizeRange": [0.2, 0.32],
+    "css": "font-weight: 700;",
+    "echoes": [
+      {
+        "dx": -5,
+        "dy": 0,
+        "color": "#22e6ff",
+        "opacity": 0.75
+      },
+      {
+        "dx": 5,
+        "dy": 1,
+        "color": "#ff3df0",
+        "opacity": 0.75
+      }
+    ]
+  },
+  "css": "",
+  "deliveries": {
+    "home": "column",
+    "rail": "unvalidated",
+    "note": "signature = RGB-split echoes converge (engine fx) — rail keeps only a tinted skin"
+  }
+}

package/skills/embedded-captions/dna/ink.json

@@ -0,0 +1,65 @@
+{
+  "name": "ink",
+  "title": "Ink — printed on the scene",
+  "register": "premium",
+  "when": "BRIGHT scenes (band luma > 150): white offices, daylight, pale walls — the scenes where cream/screen washes out. Multiply blend makes the type read as printed ON the wall, picking up its texture. Confident, editorial-tech tone.",
+  "font": {
+    "family": "Inter",
+    "weights": [500, 700, 900]
+  },
+  "palette": {
+    "scheme": "dark-on-light",
+    "cap_color": "#1b1714",
+    "blend": "multiply",
+    "accent": "scene",
+    "accent_fallback": "#9a3b2e"
+  },
+  "optics": {
+    "depthMatch": true,
+    "contactShadow": true,
+    "warmBloom": false
+  },
+  "filter": "contrast(1.05)",
+  "motion": {
+    "soft": {
+      "y": 0,
+      "scale": 1.06,
+      "dur": 0.22,
+      "ease": "power3.out"
+    },
+    "present": {
+      "y": 0,
+      "scale": 1.08,
+      "dur": 0.2,
+      "ease": "power3.out"
+    },
+    "impact": {
+      "y": 0,
+      "scale": 1.12,
+      "dur": 0.18,
+      "ease": "power4.out"
+    },
+    "exit": {
+      "dur": 0.22,
+      "ease": "power2.in",
+      "stagger": 0
+    }
+  },
+  "hero": {
+    "entrance": "settle",
+    "perLetter": false,
+    "letterStagger": 0.014,
+    "glow": 0,
+    "dimOthers": 0.4,
+    "breathe": 0,
+    "case": "uppercase",
+    "tracking": "-0.035em",
+    "sizeRange": [0.2, 0.34]
+  },
+  "css": "",
+  "deliveries": {
+    "home": "column",
+    "rail": "unvalidated",
+    "note": "rail works (scale-press→settle) but the letterpress identity wants a scene surface to press INTO"
+  }
+}

package/skills/embedded-captions/dna/keynote.json

@@ -0,0 +1,62 @@
+{
+  "name": "keynote",
+  "title": "Keynote — Apple-grade confidence",
+  "register": "tech-premium",
+  "when": "product walkthroughs, launches, founder updates, tech explainers. Opaque white type, dead-center planes, few words held long. Confidence comes from mass and stillness, not motion.",
+  "font": {
+    "family": "Inter",
+    "weights": [400, 600, 800]
+  },
+  "palette": {
+    "scheme": "light-on-dark",
+    "cap_color": "#ffffff",
+    "blend": "normal",
+    "accent": "scene",
+    "accent_fallback": "#8ab4ff"
+  },
+  "optics": {
+    "depthMatch": true,
+    "contactShadow": true,
+    "warmBloom": false
+  },
+  "filter": "none",
+  "motion": {
+    "soft": {
+      "reveal": "burn"
+    },
+    "present": {
+      "reveal": "burn"
+    },
+    "impact": {
+      "reveal": "burn"
+    },
+    "lineReveal": {
+      "type": "wipe-x",
+      "dur": 0.4,
+      "ease": "expo.out"
+    },
+    "exit": {
+      "dur": 0.3,
+      "ease": "power2.in",
+      "stagger": 0
+    }
+  },
+  "hero": {
+    "entrance": "wipe-up",
+    "perLetter": false,
+    "letterStagger": 0,
+    "glow": 0,
+    "dimOthers": 0.35,
+    "breathe": 0,
+    "case": "uppercase",
+    "tracking": "-0.045em",
+    "sizeRange": [0.16, 0.3],
+    "css": "font-weight: 800;"
+  },
+  "css": "",
+  "deliveries": {
+    "home": "column",
+    "rail": "validated",
+    "note": "wipe-up maps to the std entrance enum; keynote_std validated (Shine)"
+  }
+}

package/skills/embedded-captions/dna/loud.json

@@ -0,0 +1,75 @@
+{
+  "name": "loud",
+  "title": "Loud — the sanctioned blast",
+  "register": "loud",
+  "when": "hype, social reels, sport, music, motivational shorts — content that WANTS the type to compete with the face (k-pop-lyric lineage; deliberately breaks 'subject wins' at the hero). Machine-gun letter staggers, slam entrances, scene-sampled saturated accent on the hero. Body lines ANNOUNCE in front of the subject (bodyLayer:fg — k-pop lyric depth); only the hero embeds behind.",
+  "font": {
+    "family": "Anton",
+    "weights": [400]
+  },
+  "palette": {
+    "scheme": "light-on-dark",
+    "cap_color": "#ffffff",
+    "blend": "normal",
+    "accent": "scene",
+    "accent_fallback": "#ffd600",
+    "heroColor": "accent",
+    "accentMode": "counter"
+  },
+  "optics": {
+    "depthMatch": false,
+    "contactShadow": true,
+    "warmBloom": false
+  },
+  "filter": "none",
+  "motion": {
+    "soft": {
+      "y": 0,
+      "scale": 1.3,
+      "rot": 1.2,
+      "dur": 0.18,
+      "ease": "back.out(1.7)"
+    },
+    "present": {
+      "y": 0,
+      "scale": 1.35,
+      "rot": 1.2,
+      "dur": 0.18,
+      "ease": "back.out(1.7)"
+    },
+    "impact": {
+      "y": 0,
+      "scale": 1.45,
+      "rot": 1.5,
+      "dur": 0.16,
+      "ease": "back.out(1.9)"
+    },
+    "exit": {
+      "dur": 0.14,
+      "scale": 0.96,
+      "ease": "power3.in",
+      "stagger": 0
+    }
+  },
+  "hero": {
+    "entrance": "slam",
+    "perLetter": false,
+    "letterStagger": 0.01,
+    "glow": 0.25,
+    "dimOthers": 0.55,
+    "breathe": 0.016,
+    "case": "uppercase",
+    "tracking": "-0.005em",
+    "sizeRange": [0.26, 0.4],
+    "css": "-webkit-text-stroke: 2px rgba(0,0,0,0.35); paint-order: stroke fill;",
+    "ripple": 3,
+    "loom": 0.03
+  },
+  "css": "",
+  "bodyLayer": "fg",
+  "deliveries": {
+    "home": "column",
+    "rail": "unvalidated",
+    "note": "slam maps; bodyLayer:fg already a std-shaped hybrid; validated both"
+  }
+}

package/skills/embedded-captions/dna/neon.json

@@ -0,0 +1,58 @@
+{
+  "name": "neon",
+  "title": "Neon — the sign in the scene",
+  "register": "loud-neon",
+  "when": "neon-noir / nightlife / tech-noir / music content on dark scenes. The captions ARE neon signage hanging in the room: electric cyan tubes, ignition flicker, a hum of glow. The hero powers ON like a sign being lit.",
+  "font": {
+    "family": "Orbitron",
+    "weights": [400, 700]
+  },
+  "palette": {
+    "scheme": "light-on-dark",
+    "cap_color": "#d9f7ff",
+    "blend": "screen",
+    "accent": "#22e6ff",
+    "accent_fallback": "#22e6ff",
+    "heroColor": "accent"
+  },
+  "optics": {
+    "depthMatch": false,
+    "contactShadow": false,
+    "warmBloom": false
+  },
+  "filter": "none",
+  "motion": {
+    "soft": {
+      "reveal": "flicker"
+    },
+    "present": {
+      "reveal": "flicker"
+    },
+    "impact": {
+      "reveal": "flicker"
+    },
+    "exit": {
+      "dur": 0.18,
+      "ease": "power2.in",
+      "stagger": 0
+    }
+  },
+  "hero": {
+    "entrance": "flicker-on",
+    "perLetter": false,
+    "letterStagger": 0,
+    "glow": 0.5,
+    "dimOthers": 0.4,
+    "breathe": 0.01,
+    "case": "uppercase",
+    "tracking": "0.04em",
+    "sizeRange": [0.18, 0.3],
+    "css": "text-shadow: 0 0 14px rgba(34,230,255,0.65), 0 0 40px rgba(34,230,255,0.35), 0 0 80px rgba(34,230,255,0.18);"
+  },
+  "css": ".cap { text-shadow: 0 0 10px rgba(34,230,255,0.4), 0 0 26px rgba(34,230,255,0.2); }",
+  "deliveries": {
+    "home": "column",
+    "rail": "unvalidated",
+    "note": "signature = flicker-on + glow layer (engine hero fx) — rail keeps only the cyan skin"
+  }
+}

package/skills/embedded-captions/dna/velocity.json

@@ -0,0 +1,89 @@
+{
+  "name": "velocity",
+  "title": "Velocity — speed lines",
+  "register": "loud-sport",
+  "when": "sport, automotive, fitness, anything kinetic. Every word arrives ALONG its own motion vector (streak + skew settles upright); the hero passes through with speed trails behind it. Condensed italic forward lean.",
+  "font": {
+    "family": "Teko",
+    "weights": [400, 700]
+  },
+  "palette": {
+    "scheme": "light-on-dark",
+    "cap_color": "#ffffff",
+    "blend": "normal",
+    "accent": "scene",
+    "accent_fallback": "#ffd600",
+    "heroColor": "accent",
+    "accentMode": "counter"
+  },
+  "optics": {
+    "depthMatch": false,
+    "contactShadow": true,
+    "warmBloom": false
+  },
+  "filter": "none",
+  "motion": {
+    "soft": {
+      "x": -22,
+      "skewX": -8,
+      "stretchX": 1.3,
+      "dur": 0.22,
+      "ease": "expo.out"
+    },
+    "present": {
+      "x": -26,
+      "skewX": -10,
+      "stretchX": 1.35,
+      "dur": 0.2,
+      "ease": "expo.out"
+    },
+    "impact": {
+      "x": -32,
+      "skewX": -12,
+      "stretchX": 1.45,
+      "dur": 0.18,
+      "ease": "expo.out"
+    },
+    "exit": {
+      "dur": 0.16,
+      "x": 14,
+      "ease": "power3.in",
+      "stagger": 0.04
+    }
+  },
+  "hero": {
+    "entrance": "streak",
+    "perLetter": false,
+    "letterStagger": 0,
+    "glow": 0,
+    "dimOthers": 0.5,
+    "breathe": 0,
+    "loom": 0.025,
+    "case": "uppercase",
+    "tracking": "0.015em",
+    "sizeRange": [0.24, 0.38],
+    "css": "font-weight: 700; font-style: italic;",
+    "echoes": [
+      {
+        "dx": -10,
+        "dy": 0,
+        "color": "#ffffff",
+        "opacity": 0.22,
+        "blur": 1
+      },
+      {
+        "dx": -20,
+        "dy": 0,
+        "color": "#ffffff",
+        "opacity": 0.1,
+        "blur": 2
+      }
+    ]
+  },
+  "css": "",
+  "deliveries": {
+    "home": "column",
+    "rail": "unvalidated",
+    "note": "signature = streak + trail echoes along the speed vector (engine fx) — rail loses all of it"
+  }
+}

package/skills/embedded-captions/modes/cinematic/README.md

@@ -0,0 +1,48 @@
+# Cinematic mode (pure embed) — one engine, six DNAs
+
+> Cinematic mode compiles **[../../dna/](../../dna/README.md)** through
+> **[engine.html](engine.html)** (`make-composition.cjs`). The old per-template HTML
+> shells are retired — `cinematic-cream` maps to `dna: "cream"` automatically; the other
+> archived templates (memory-wall / champion / portrait-header, in [\_archive/](_archive/))
+> remain as design references only.
+
+Use this mode for pure-embed asks (no rail): brand film, hype, social reel, showcase.
+The **DNA** locks the visual language (type, palette scheme, blend, motion grammar, hero
+three-act); **safe-zones v2** parameterizes it to the scene (sampled accent, light-
+direction contact shadow, depth-match blur); **the agent decides layout only** (planes,
+blocks, per-line typography within the DNA).
+
+## Workflow
+
+1. `bash scripts/prepare.sh <project>` → matte ∥ transcript ∥ envelope → safe-zones v2
+2. Pick a DNA ([../../dna/README.md](../../dna/README.md)): bright hero band → `ink`,
+   else by register (cream / editorial / keynote / documentary / loud). Recommend, let
+   the user pick.
+3. Author `<project>/cinematic.json` — `"dna": "<name>"` + thought-blocks (schema:
+   `scripts/make-cinematic.cjs` header)
+4. `node scripts/make-cinematic.cjs <project>` → plan.json → engine-compiled index.html
+5. `node scripts/preview-frames.cjs <project>` → § Visual QA (failure checks + the 5
+   positive checks in [../../references/reference-bar.md](../../references/reference-bar.md))
+6. `bash scripts/render-and-composite.sh <project>` → gates → final.mp4
+
+## What the engine generates (never author these)
+
+- word timings from the transcript; accumulate-within-block / page-flip-between-blocks
+- the hero hand-off + **three-act orchestration** (dim → RMS-coupled per-letter entrance
+  → breathe + glow), per the DNA's `hero` block
+- scene tokens: `--accent` (sampled), contact shadow, depth blur
+- reading order, re-slot from measured heights, hero size/collision post-pass
+
+## What you DON'T do
+
+- Override `.cap` color / blend / shadow / filter / motion curves — that's the DNA.
+  Scene fights the look → pick a different DNA (bright → `ink`), never recolor.
+- Hand-position the hero into a clean margin (it belongs ON the subject, ~30–55%
+  occluded — safe-zones `heroBands.best`).
+- Add full-frame grades/textures over the footage (hard rule: the video ships untouched).
+
+## Adding a DNA
+
+`dna/<name>.json` — copy one, change the voice (see [../../dna/README.md](../../dna/README.md)
+§ Adding). The engine consumes it with no code change. A DNA must be a distinct voice
+with a reason to exist, not a recolor.