dsh-hyperframes 0.2.0 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.en.md +52 -6
- package/README.md +51 -7
- package/lib/index.d.ts +8 -41
- package/lib/index.js +38 -99
- package/lib/skill-bundle.d.ts +56 -0
- package/lib/skill-bundle.js +218 -0
- package/package.json +1 -1
- package/skills/embedded-captions/CATALOG.md +91 -0
- package/skills/embedded-captions/SKILL.md +258 -0
- package/skills/embedded-captions/assets/fonts/char-widths.json +2211 -0
- package/skills/embedded-captions/assets/strokefonts/HersheyScript1.svg +242 -0
- package/skills/embedded-captions/assets/strokefonts/HersheyScriptMed.svg +242 -0
- package/skills/embedded-captions/dna/README.md +148 -0
- package/skills/embedded-captions/dna/chrome.json +68 -0
- package/skills/embedded-captions/dna/cream.json +69 -0
- package/skills/embedded-captions/dna/documentary.json +62 -0
- package/skills/embedded-captions/dna/editorial.json +70 -0
- package/skills/embedded-captions/dna/glitch.json +82 -0
- package/skills/embedded-captions/dna/ink.json +65 -0
- package/skills/embedded-captions/dna/keynote.json +62 -0
- package/skills/embedded-captions/dna/loud.json +75 -0
- package/skills/embedded-captions/dna/neon.json +58 -0
- package/skills/embedded-captions/dna/velocity.json +89 -0
- package/skills/embedded-captions/modes/cinematic/README.md +48 -0
- package/skills/embedded-captions/modes/cinematic/_archive/champion/spec.md +98 -0
- package/skills/embedded-captions/modes/cinematic/_archive/champion/template.html +188 -0
- package/skills/embedded-captions/modes/cinematic/_archive/memory-wall/spec.md +134 -0
- package/skills/embedded-captions/modes/cinematic/_archive/memory-wall/template.html +179 -0
- package/skills/embedded-captions/modes/cinematic/_archive/portrait-header/spec.md +81 -0
- package/skills/embedded-captions/modes/cinematic/_archive/portrait-header/template.html +170 -0
- package/skills/embedded-captions/modes/cinematic/cinematic-cream/spec.md +16 -0
- package/skills/embedded-captions/modes/cinematic/cinematic-cream/template.html +226 -0
- package/skills/embedded-captions/modes/cinematic/engine.html +355 -0
- package/skills/embedded-captions/modes/standard/_anatomy.md +233 -0
- package/skills/embedded-captions/modes/standard/_motion.md +192 -0
- package/skills/embedded-captions/modes/standard/fonts/build-fonts-css.cjs +97 -0
- package/skills/embedded-captions/modes/standard/fonts/files/anton-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/audiowide-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/baloo-2-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/baloo-2-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/bangers-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/bodoni-moda-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/bodoni-moda-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/caveat-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/caveat-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/chakra-petch-latin-500-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/chakra-petch-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/cinzel-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/cinzel-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/cormorant-garamond-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/cormorant-garamond-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/creepster-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/fredoka-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/fredoka-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/inter-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/inter-latin-500-italic.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/inter-latin-500-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/inter-latin-600-italic.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/inter-latin-600-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/inter-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/inter-latin-800-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/inter-latin-900-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/monoton-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/orbitron-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/orbitron-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/permanent-marker-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/press-start-2p-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/rajdhani-latin-500-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/rajdhani-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/saira-stencil-one-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/shippori-mincho-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/shippori-mincho-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/sora-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/sora-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/space-grotesk-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/space-grotesk-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/special-elite-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/teko-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/teko-latin-700-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/files/vt323-latin-400-normal.woff2 +0 -0
- package/skills/embedded-captions/modes/standard/fonts/fonts.css +401 -0
- package/skills/embedded-captions/references/aesthetic-principles.md +168 -0
- package/skills/embedded-captions/references/anti-patterns.md +188 -0
- package/skills/embedded-captions/references/bespoke-vs-presets.md +178 -0
- package/skills/embedded-captions/references/caption-grouping.md +130 -0
- package/skills/embedded-captions/references/composition-craft.md +522 -0
- package/skills/embedded-captions/references/direction-catalog.md +138 -0
- package/skills/embedded-captions/references/example-renders/champion.html +371 -0
- package/skills/embedded-captions/references/example-renders/memory-wall.html +334 -0
- package/skills/embedded-captions/references/failure-modes.md +145 -0
- package/skills/embedded-captions/references/layout-heuristics.md +238 -0
- package/skills/embedded-captions/references/motion-vocabulary.md +148 -0
- package/skills/embedded-captions/references/rail.md +68 -0
- package/skills/embedded-captions/references/reference-bar.md +47 -0
- package/skills/embedded-captions/references/scene-types.md +94 -0
- package/skills/embedded-captions/references/typographic-moves.md +266 -0
- package/skills/embedded-captions/references/typography-presets.md +63 -0
- package/skills/embedded-captions/scripts/audio-envelope.cjs +95 -0
- package/skills/embedded-captions/scripts/check-occlusion.cjs +250 -0
- package/skills/embedded-captions/scripts/check-overflow.cjs +194 -0
- package/skills/embedded-captions/scripts/check-rail-climax.cjs +233 -0
- package/skills/embedded-captions/scripts/check-timing.cjs +173 -0
- package/skills/embedded-captions/scripts/fill-timings.cjs +124 -0
- package/skills/embedded-captions/scripts/fit-fonts.cjs +158 -0
- package/skills/embedded-captions/scripts/gen-stroke-path.py +57 -0
- package/skills/embedded-captions/scripts/inject-fonts.cjs +169 -0
- package/skills/embedded-captions/scripts/lib-dna.cjs +201 -0
- package/skills/embedded-captions/scripts/make-cinematic.cjs +1206 -0
- package/skills/embedded-captions/scripts/make-composition.cjs +405 -0
- package/skills/embedded-captions/scripts/make-theme.cjs +8585 -0
- package/skills/embedded-captions/scripts/matte.cjs +280 -0
- package/skills/embedded-captions/scripts/measure-layout.cjs +293 -0
- package/skills/embedded-captions/scripts/prepare.sh +39 -0
- package/skills/embedded-captions/scripts/preview-frames.cjs +268 -0
- package/skills/embedded-captions/scripts/render-and-composite.sh +469 -0
- package/skills/embedded-captions/scripts/render-theme.sh +34 -0
- package/skills/embedded-captions/scripts/safe-zones.cjs +813 -0
- package/skills/embedded-captions/scripts/transcribe.cjs +332 -0
- package/skills/embedded-captions/themes/README.md +243 -0
- package/skills/embedded-captions/themes/anchor.json +27 -0
- package/skills/embedded-captions/themes/arcade.json +51 -0
- package/skills/embedded-captions/themes/aurora.json +41 -0
- package/skills/embedded-captions/themes/biolume.json +35 -0
- package/skills/embedded-captions/themes/brush.json +74 -0
- package/skills/embedded-captions/themes/chalkboard.json +52 -0
- package/skills/embedded-captions/themes/dossier.json +56 -0
- package/skills/embedded-captions/themes/graffiti.json +62 -0
- package/skills/embedded-captions/themes/hologram.json +41 -0
- package/skills/embedded-captions/themes/inkwater.json +43 -0
- package/skills/embedded-captions/themes/laser.json +46 -0
- package/skills/embedded-captions/themes/lastpage.json +33 -0
- package/skills/embedded-captions/themes/neonsign.json +53 -0
- package/skills/embedded-captions/themes/ordnance.json +54 -0
- package/skills/embedded-captions/themes/papercut.json +37 -0
- package/skills/embedded-captions/themes/popup.json +46 -0
- package/skills/embedded-captions/themes/ransom.json +62 -0
- package/skills/embedded-captions/themes/scoreboard.json +54 -0
- package/skills/embedded-captions/themes/spectrum.json +46 -0
- package/skills/embedded-captions/themes/stardust.json +29 -0
- package/skills/embedded-captions/themes/stomp.json +43 -0
- package/skills/embedded-captions/themes/terminal.json +49 -0
- package/skills/embedded-captions/themes/thunder.json +44 -0
- package/skills/embedded-captions/themes/transit.json +44 -0
- package/skills/embedded-captions/themes/vhs.json +47 -0
- package/skills/faceless-explainer/SKILL.md +233 -0
- package/skills/faceless-explainer/references/cut-catalog.md +215 -0
- package/skills/faceless-explainer/references/motion-language.md +156 -0
- package/skills/faceless-explainer/references/story-design.md +255 -0
- package/skills/faceless-explainer/references/visual-design.md +146 -0
- package/skills/faceless-explainer/scripts/assemble-index.mjs +623 -0
- package/skills/faceless-explainer/scripts/assemble-index.test.mjs +72 -0
- package/skills/faceless-explainer/scripts/audio.mjs +291 -0
- package/skills/faceless-explainer/scripts/audio.test.mjs +176 -0
- package/skills/faceless-explainer/scripts/build-frame.mjs +551 -0
- package/skills/faceless-explainer/scripts/captions.mjs +521 -0
- package/skills/faceless-explainer/scripts/captions.test.mjs +219 -0
- package/skills/faceless-explainer/scripts/frame-packets.mjs +27 -0
- package/skills/faceless-explainer/scripts/frame-packets.test.mjs +66 -0
- package/skills/faceless-explainer/scripts/lib/assets.mjs +56 -0
- package/skills/faceless-explainer/scripts/lib/dimensions.mjs +45 -0
- package/skills/faceless-explainer/scripts/lib/pad-frame-duration.mjs +36 -0
- package/skills/faceless-explainer/scripts/lib/storyboard.mjs +249 -0
- package/skills/faceless-explainer/scripts/lib/tokens.mjs +211 -0
- package/skills/faceless-explainer/scripts/lib/transition-registry.mjs +38 -0
- package/skills/faceless-explainer/scripts/lib/transitions.json +71 -0
- package/skills/faceless-explainer/scripts/transitions.mjs +383 -0
- package/skills/faceless-explainer/scripts/transitions.test.mjs +68 -0
- package/skills/faceless-explainer/sub-agents/frame-worker.md +12 -0
- package/skills/figma/SKILL.md +132 -0
- package/skills/figma/scripts/verify-motion.mjs +153 -0
- package/skills/general-video/SKILL.md +165 -0
- package/skills/general-video/scripts/frame-packets.mjs +38 -0
- package/skills/general-video/scripts/frame-packets.test.mjs +80 -0
- package/skills/general-video/sub-agents/frame-worker.md +34 -0
- package/skills/hyperframes/SKILL.md +98 -337
- package/skills/hyperframes/references/capability-menu.md +47 -0
- package/skills/hyperframes/references/intent-interview.md +71 -0
- package/skills/hyperframes/references/pitch-round.md +40 -0
- package/skills/hyperframes/references/route-briefs.md +11 -0
- package/skills/hyperframes/references/routes/embedded-captions.md +11 -0
- package/skills/hyperframes/references/routes/faceless-explainer.md +12 -0
- package/skills/hyperframes/references/routes/general-video.md +12 -0
- package/skills/hyperframes/references/routes/motion-graphics.md +11 -0
- package/skills/hyperframes/references/routes/music-to-video.md +12 -0
- package/skills/hyperframes/references/routes/pr-to-video.md +28 -0
- package/skills/hyperframes/references/routes/product-launch-video.md +13 -0
- package/skills/hyperframes/references/routes/remotion-to-hyperframes.md +9 -0
- package/skills/hyperframes/references/routes/slideshow.md +11 -0
- package/skills/hyperframes/references/routes/talking-head-recut.md +11 -0
- package/skills/hyperframes/references/skill-lifecycle.md +33 -0
- package/skills/hyperframes/references/workflow-catalog.md +10 -0
- package/skills/hyperframes-animation/SKILL.md +84 -0
- package/skills/hyperframes-animation/adapters/animate-text.md +64 -0
- package/skills/hyperframes-animation/adapters/animejs.md +130 -0
- package/skills/hyperframes-animation/adapters/css-animations.md +143 -0
- package/skills/hyperframes-animation/adapters/gsap-easing-and-stagger.md +199 -0
- package/skills/hyperframes-animation/adapters/gsap-timeline-and-labels.md +96 -0
- package/skills/hyperframes-animation/adapters/gsap-transforms-and-perf.md +129 -0
- package/skills/hyperframes-animation/adapters/gsap.md +105 -0
- package/skills/hyperframes-animation/adapters/html-in-canvas-patterns.md +507 -0
- package/skills/hyperframes-animation/adapters/lottie.md +117 -0
- package/skills/hyperframes-animation/adapters/three.md +131 -0
- package/skills/hyperframes-animation/adapters/typegpu.md +182 -0
- package/skills/hyperframes-animation/adapters/waapi.md +101 -0
- package/skills/hyperframes-animation/blueprints/agent-progress-theater.md +76 -0
- package/skills/hyperframes-animation/blueprints/camera-journey.md +61 -0
- package/skills/hyperframes-animation/blueprints/comparison-split.md +27 -0
- package/skills/hyperframes-animation/blueprints/constellation-hub.md +63 -0
- package/skills/hyperframes-animation/blueprints/cta-morph-press.md +63 -0
- package/skills/hyperframes-animation/blueprints/cursor-ui-demo.md +89 -0
- package/skills/hyperframes-animation/blueprints/dataviz-countup.md +59 -0
- package/skills/hyperframes-animation/blueprints/device-surface-showcase.md +68 -0
- package/skills/hyperframes-animation/blueprints/fixed-anchor-cycle.md +46 -0
- package/skills/hyperframes-animation/blueprints/grid-card-assemble.md +81 -0
- package/skills/hyperframes-animation/blueprints/kinetic-type-beats.md +133 -0
- package/skills/hyperframes-animation/blueprints/logo-assemble-lockup.md +121 -0
- package/skills/hyperframes-animation/blueprints/overwhelm-surround.md +58 -0
- package/skills/hyperframes-animation/blueprints/panel-edit-live-sync.md +73 -0
- package/skills/hyperframes-animation/blueprints/prompt-type-submit-generate.md +85 -0
- package/skills/hyperframes-animation/blueprints/spatial-pan-stations.md +37 -0
- package/skills/hyperframes-animation/blueprints/ticker-takeover.md +29 -0
- package/skills/hyperframes-animation/blueprints/titlecard-reveal.md +80 -0
- package/skills/hyperframes-animation/blueprints/transcript-scroll-artifact-reveal.md +45 -0
- package/skills/hyperframes-animation/blueprints/typewriter-reveal.md +51 -0
- package/skills/hyperframes-animation/blueprints/video-text-pivot.md +30 -0
- package/skills/hyperframes-animation/blueprints/zoom-out-workspace-reveal.md +68 -0
- package/skills/hyperframes-animation/blueprints-index.md +202 -0
- package/skills/hyperframes-animation/examples/brand-reveal-assemble-zoom.html +382 -0
- package/skills/hyperframes-animation/examples/comparison-split-cards.html +649 -0
- package/skills/hyperframes-animation/examples/concept-demo-decode-pan.html +520 -0
- package/skills/hyperframes-animation/examples/cta-morph-press.html +468 -0
- package/skills/hyperframes-animation/examples/cta-orbit-collapse.html +1298 -0
- package/skills/hyperframes-animation/examples/demo-page-scroll-spotlight.html +759 -0
- package/skills/hyperframes-animation/examples/hook-counter-burst.html +729 -0
- package/skills/hyperframes-animation/examples/messaging-multi-phrase.html +352 -0
- package/skills/hyperframes-animation/examples/metric-video-text-pivot.html +779 -0
- package/skills/hyperframes-animation/examples/problem-mockup-overwhelm.html +1374 -0
- package/skills/hyperframes-animation/examples/proof-logo-chain.html +861 -0
- package/skills/hyperframes-animation/examples/takeover-ticker-displace.html +347 -0
- package/skills/hyperframes-animation/examples/workflow-approve-press.html +606 -0
- package/skills/hyperframes-animation/rules/3d-camera-flight.md +180 -0
- package/skills/hyperframes-animation/rules/3d-page-scroll.md +135 -0
- package/skills/hyperframes-animation/rules/3d-text-depth-layers.md +128 -0
- package/skills/hyperframes-animation/rules/ai-tracking-box.md +139 -0
- package/skills/hyperframes-animation/rules/ambient-glow-bloom.md +133 -0
- package/skills/hyperframes-animation/rules/anchored-layout-expand.md +148 -0
- package/skills/hyperframes-animation/rules/asr-keyword-glow.md +128 -0
- package/skills/hyperframes-animation/rules/avatar-cloud-network.md +145 -0
- package/skills/hyperframes-animation/rules/camera-cursor-tracking.md +133 -0
- package/skills/hyperframes-animation/rules/card-morph-anchor.md +134 -0
- package/skills/hyperframes-animation/rules/center-outward-expansion.md +88 -0
- package/skills/hyperframes-animation/rules/chart-scrub-readout.md +151 -0
- package/skills/hyperframes-animation/rules/chromatic-glitch.md +150 -0
- package/skills/hyperframes-animation/rules/context-sensitive-cursor.md +140 -0
- package/skills/hyperframes-animation/rules/control-target-sync.md +131 -0
- package/skills/hyperframes-animation/rules/coordinate-target-zoom.md +138 -0
- package/skills/hyperframes-animation/rules/counting-dynamic-scale.md +115 -0
- package/skills/hyperframes-animation/rules/css-marker-patterns.md +208 -0
- package/skills/hyperframes-animation/rules/cursor-click-ripple.md +104 -0
- package/skills/hyperframes-animation/rules/cursor-drag.md +141 -0
- package/skills/hyperframes-animation/rules/depth-of-field-blur.md +112 -0
- package/skills/hyperframes-animation/rules/depth-scatter-assemble.md +139 -0
- package/skills/hyperframes-animation/rules/discrete-text-sequence.md +146 -0
- package/skills/hyperframes-animation/rules/dynamic-content-sequencing.md +149 -0
- package/skills/hyperframes-animation/rules/gradient-text-sweep.md +136 -0
- package/skills/hyperframes-animation/rules/gsap-effects.md +196 -0
- package/skills/hyperframes-animation/rules/hacker-flip-3d.md +123 -0
- package/skills/hyperframes-animation/rules/kinetic-beat-slam.md +137 -0
- package/skills/hyperframes-animation/rules/motion-blur-streak.md +130 -0
- package/skills/hyperframes-animation/rules/multi-cursor-choreography.md +133 -0
- package/skills/hyperframes-animation/rules/multi-phase-camera.md +129 -0
- package/skills/hyperframes-animation/rules/nudge-curve.md +47 -0
- package/skills/hyperframes-animation/rules/orbit-3d-entry.md +148 -0
- package/skills/hyperframes-animation/rules/particle-burst.md +149 -0
- package/skills/hyperframes-animation/rules/physics-press-reaction.md +101 -0
- package/skills/hyperframes-animation/rules/press-release-spring.md +108 -0
- package/skills/hyperframes-animation/rules/reactive-displacement.md +92 -0
- package/skills/hyperframes-animation/rules/scale-swap-transition.md +88 -0
- package/skills/hyperframes-animation/rules/sine-wave-loop.md +85 -0
- package/skills/hyperframes-animation/rules/split-tilt-cards.md +123 -0
- package/skills/hyperframes-animation/rules/spring-pop-entrance.md +107 -0
- package/skills/hyperframes-animation/rules/stat-bars-and-fills.md +145 -0
- package/skills/hyperframes-animation/rules/svg-icon-enrichment.md +141 -0
- package/skills/hyperframes-animation/rules/svg-path-draw.md +122 -0
- package/skills/hyperframes-animation/rules/theme-crossfade-morph.md +126 -0
- package/skills/hyperframes-animation/rules/vertical-spring-ticker.md +104 -0
- package/skills/hyperframes-animation/rules/viewport-change.md +148 -0
- package/skills/hyperframes-animation/rules/waterfall-entry.md +81 -0
- package/skills/hyperframes-animation/rules-index.md +113 -0
- package/skills/hyperframes-animation/scripts/animation-map-sampling.mjs +40 -0
- package/skills/hyperframes-animation/scripts/animation-map-sampling.test.mjs +48 -0
- package/skills/{hyperframes → hyperframes-animation}/scripts/animation-map.mjs +116 -53
- package/skills/hyperframes-animation/scripts/animation-map.test.mjs +444 -0
- package/skills/hyperframes-animation/scripts/package-loader.mjs +384 -0
- package/skills/hyperframes-animation/scripts/package-loader.test.mjs +62 -0
- package/skills/{website-to-hyperframes/references → hyperframes-animation}/techniques.md +146 -26
- package/skills/hyperframes-animation/transitions/TRANSITION-REGISTRY.md +168 -0
- package/skills/{hyperframes/references → hyperframes-animation}/transitions/catalog.md +26 -16
- package/skills/{hyperframes/references → hyperframes-animation}/transitions/css-destruction.md +1 -1
- package/skills/{hyperframes/references/transitions.md → hyperframes-animation/transitions/overview.md} +44 -3
- package/skills/hyperframes-audio/SKILL.md +470 -0
- package/skills/hyperframes-audio/references/attributes.md +138 -0
- package/skills/hyperframes-audio/references/diagnosis.md +276 -0
- package/skills/hyperframes-audio/references/fx-registry.md +84 -0
- package/skills/hyperframes-audio/references/presets.md +216 -0
- package/skills/hyperframes-audio/scripts/carve.mjs +569 -0
- package/skills/hyperframes-audio/scripts/carve.test.mjs +239 -0
- package/skills/hyperframes-cli/SKILL.md +121 -103
- package/skills/hyperframes-cli/references/beats.md +19 -0
- package/skills/hyperframes-cli/references/cloud.md +163 -0
- package/skills/hyperframes-cli/references/cloudrun.md +62 -0
- package/skills/hyperframes-cli/references/compare-and-batch.md +105 -0
- package/skills/hyperframes-cli/references/doctor-browser.md +57 -0
- package/skills/hyperframes-cli/references/init-and-scaffold.md +72 -0
- package/skills/hyperframes-cli/references/lambda.md +185 -0
- package/skills/hyperframes-cli/references/lint-validate-inspect.md +132 -0
- package/skills/hyperframes-cli/references/preview-render.md +190 -0
- package/skills/hyperframes-cli/references/upgrade-info-misc.md +77 -0
- package/skills/hyperframes-core/SKILL.md +94 -0
- package/skills/hyperframes-core/references/brief-contract.md +108 -0
- package/skills/hyperframes-core/references/brief-format.md +72 -0
- package/skills/hyperframes-core/references/composition-patterns.md +263 -0
- package/skills/hyperframes-core/references/creator-editing-recipes.md +367 -0
- package/skills/hyperframes-core/references/data-attributes.md +78 -0
- package/skills/hyperframes-core/references/determinism-rules.md +70 -0
- package/skills/hyperframes-core/references/frame-worker-core.md +80 -0
- package/skills/hyperframes-core/references/full-screen-motion.md +76 -0
- package/skills/hyperframes-core/references/minimal-composition.md +69 -0
- package/skills/hyperframes-core/references/production-loop.md +26 -0
- package/skills/hyperframes-core/references/review-loop.md +41 -0
- package/skills/hyperframes-core/references/script-format.md +52 -0
- package/skills/hyperframes-core/references/storyboard-format.md +130 -0
- package/skills/hyperframes-core/references/sub-compositions.md +239 -0
- package/skills/hyperframes-core/references/subagent-dispatch.md +35 -0
- package/skills/hyperframes-core/references/tailwind.md +123 -0
- package/skills/hyperframes-core/references/tracks-and-clips.md +91 -0
- package/skills/hyperframes-core/references/variables-and-media.md +107 -0
- package/skills/hyperframes-core/scripts/lib/frame-packets-core.mjs +212 -0
- package/skills/hyperframes-creative/SKILL.md +71 -0
- package/skills/hyperframes-creative/frame-presets/biennale-yellow/FRAME.md +289 -0
- package/skills/hyperframes-creative/frame-presets/biennale-yellow/caption-skin.html +221 -0
- package/skills/hyperframes-creative/frame-presets/biennale-yellow/frame-showcase.html +1214 -0
- package/skills/hyperframes-creative/frame-presets/blockframe/FRAME.md +275 -0
- package/skills/hyperframes-creative/frame-presets/blockframe/caption-skin.html +224 -0
- package/skills/hyperframes-creative/frame-presets/blockframe/frame-showcase.html +1347 -0
- package/skills/hyperframes-creative/frame-presets/blue-professional/FRAME.md +307 -0
- package/skills/hyperframes-creative/frame-presets/blue-professional/caption-skin.html +223 -0
- package/skills/hyperframes-creative/frame-presets/blue-professional/frame-showcase.html +1372 -0
- package/skills/hyperframes-creative/frame-presets/bold-poster/FRAME.md +275 -0
- package/skills/hyperframes-creative/frame-presets/bold-poster/caption-skin.html +230 -0
- package/skills/hyperframes-creative/frame-presets/bold-poster/frame-showcase.html +1140 -0
- package/skills/hyperframes-creative/frame-presets/broadside/FRAME.md +284 -0
- package/skills/hyperframes-creative/frame-presets/broadside/caption-skin.html +225 -0
- package/skills/hyperframes-creative/frame-presets/broadside/frame-showcase.html +1166 -0
- package/skills/hyperframes-creative/frame-presets/capsule/FRAME.md +284 -0
- package/skills/hyperframes-creative/frame-presets/capsule/caption-skin.html +224 -0
- package/skills/hyperframes-creative/frame-presets/capsule/frame-showcase.html +1465 -0
- package/skills/hyperframes-creative/frame-presets/cartesian/FRAME.md +278 -0
- package/skills/hyperframes-creative/frame-presets/cartesian/caption-skin.html +222 -0
- package/skills/hyperframes-creative/frame-presets/cartesian/frame-showcase.html +1263 -0
- package/skills/hyperframes-creative/frame-presets/cobalt-grid/FRAME.md +265 -0
- package/skills/hyperframes-creative/frame-presets/cobalt-grid/caption-skin.html +238 -0
- package/skills/hyperframes-creative/frame-presets/cobalt-grid/frame-showcase.html +1468 -0
- package/skills/hyperframes-creative/frame-presets/code-editorial/FRAME.md +277 -0
- package/skills/hyperframes-creative/frame-presets/code-editorial/caption-skin.html +224 -0
- package/skills/hyperframes-creative/frame-presets/code-editorial/fonts/EBGaramond-400.woff2 +0 -0
- package/skills/hyperframes-creative/frame-presets/code-editorial/fonts/EBGaramond-700.woff2 +0 -0
- package/skills/hyperframes-creative/frame-presets/code-editorial/fonts/Inter-400.woff2 +0 -0
- package/skills/hyperframes-creative/frame-presets/code-editorial/fonts/Inter-700.woff2 +0 -0
- package/skills/hyperframes-creative/frame-presets/code-editorial/fonts/JetBrainsMono-400.woff2 +0 -0
- package/skills/hyperframes-creative/frame-presets/code-editorial/fonts/JetBrainsMono-700.woff2 +0 -0
- package/skills/hyperframes-creative/frame-presets/code-editorial/fonts/OFL-eb-garamond.txt +93 -0
- package/skills/hyperframes-creative/frame-presets/code-editorial/fonts/OFL-inter.txt +93 -0
- package/skills/hyperframes-creative/frame-presets/code-editorial/fonts/OFL-jetbrains-mono.txt +93 -0
- package/skills/hyperframes-creative/frame-presets/code-editorial/frame-showcase.html +1438 -0
- package/skills/hyperframes-creative/frame-presets/coral/FRAME.md +314 -0
- package/skills/hyperframes-creative/frame-presets/coral/caption-skin.html +226 -0
- package/skills/hyperframes-creative/frame-presets/coral/frame-showcase.html +1268 -0
- package/skills/hyperframes-creative/frame-presets/creative-mode/FRAME.md +333 -0
- package/skills/hyperframes-creative/frame-presets/creative-mode/caption-skin.html +227 -0
- package/skills/hyperframes-creative/frame-presets/creative-mode/frame-showcase.html +1330 -0
- package/skills/hyperframes-creative/frame-presets/daisy-days/FRAME.md +274 -0
- package/skills/hyperframes-creative/frame-presets/daisy-days/caption-skin.html +230 -0
- package/skills/hyperframes-creative/frame-presets/daisy-days/frame-showcase.html +1444 -0
- package/skills/hyperframes-creative/frame-presets/editorial-forest/FRAME.md +265 -0
- package/skills/hyperframes-creative/frame-presets/editorial-forest/caption-skin.html +223 -0
- package/skills/hyperframes-creative/frame-presets/editorial-forest/frame-showcase.html +1273 -0
- package/skills/{hyperframes → hyperframes-creative}/references/audio-reactive.md +1 -1
- package/skills/hyperframes-creative/references/beat-direction.md +164 -0
- package/skills/hyperframes-creative/references/composition-patterns.md +199 -0
- package/skills/{hyperframes → hyperframes-creative/references}/data-in-motion.md +1 -1
- package/skills/hyperframes-creative/references/design-adherence.md +19 -0
- package/skills/hyperframes-creative/references/design-picker.md +123 -0
- package/skills/hyperframes-creative/references/design-spec.md +55 -0
- package/skills/{hyperframes → hyperframes-creative/references}/house-style.md +4 -2
- package/skills/hyperframes-creative/references/motion-principles.md +151 -0
- package/skills/{website-to-hyperframes/references/step-3-script.md → hyperframes-creative/references/narration.md} +5 -9
- package/skills/hyperframes-creative/references/prompt-expansion.md +68 -0
- package/skills/hyperframes-creative/references/story-spine.md +43 -0
- package/skills/{hyperframes → hyperframes-creative}/references/typography.md +45 -2
- package/skills/hyperframes-creative/references/video-composition.md +63 -0
- package/skills/hyperframes-creative/references/visual-styles.md +457 -0
- package/skills/hyperframes-creative/scripts/contrast-report.mjs +538 -0
- package/skills/{gsap → hyperframes-creative}/scripts/extract-audio-data.py +13 -2
- package/skills/hyperframes-creative/scripts/package-loader.mjs +384 -0
- package/skills/hyperframes-creative/scripts/package-loader.test.mjs +62 -0
- package/skills/hyperframes-creative/templates/design-picker.html +1432 -0
- package/skills/hyperframes-keyframes/SKILL.md +262 -0
- package/skills/hyperframes-keyframes/agents/openai.yaml +4 -0
- package/skills/hyperframes-keyframes/references/keyframe-patterns.md +108 -0
- package/skills/hyperframes-registry/SKILL.md +55 -16
- package/skills/hyperframes-registry/references/component-quality-bar.md +250 -0
- package/skills/hyperframes-registry/references/contributing.md +174 -0
- package/skills/hyperframes-registry/references/discovery.md +191 -13
- package/skills/hyperframes-registry/references/placeholder-material.md +149 -0
- package/skills/hyperframes-registry/references/templates.md +417 -0
- package/skills/hyperframes-registry/references/wiring-blocks.md +1 -31
- package/skills/hyperframes-registry/references/wiring-components.md +1 -39
- package/skills/media-use/SKILL.md +96 -0
- package/skills/media-use/audio/assets/sfx/CREDITS.md +35 -0
- package/skills/media-use/audio/assets/sfx/chime.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/click-soft.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/click.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/error.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/glitch-1.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/glitch-2.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/glitch-3.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/impact-bass-1.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/impact-bass-2.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/key-press.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/manifest.json +97 -0
- package/skills/media-use/audio/assets/sfx/notification.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/ping.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/pop.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/riser.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/sparkle.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/typing.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/whoosh-cinematic.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/whoosh-short.mp3 +0 -0
- package/skills/media-use/audio/assets/sfx/whoosh.mp3 +0 -0
- package/skills/media-use/audio/references/bgm.md +74 -0
- package/skills/media-use/audio/references/captions/authoring.md +159 -0
- package/skills/{hyperframes/references/dynamic-techniques.md → media-use/audio/references/captions/motion.md} +8 -11
- package/skills/{hyperframes/references/transcript-guide.md → media-use/audio/references/captions/transcript-handling.md} +5 -59
- package/skills/media-use/audio/references/remove-background.md +143 -0
- package/skills/media-use/audio/references/requirements.md +29 -0
- package/skills/media-use/audio/references/sfx.md +42 -0
- package/skills/media-use/audio/references/transcribe.md +52 -0
- package/skills/media-use/audio/references/tts-to-captions.md +26 -0
- package/skills/media-use/audio/references/tts.md +165 -0
- package/skills/media-use/audio/scripts/audio.mjs +293 -0
- package/skills/media-use/audio/scripts/audio.test.mjs +49 -0
- package/skills/media-use/audio/scripts/heygen-tts.mjs +121 -0
- package/skills/media-use/audio/scripts/lib/bgm.mjs +257 -0
- package/skills/media-use/audio/scripts/lib/bgm.test.mjs +30 -0
- package/skills/media-use/audio/scripts/lib/concurrency.mjs +14 -0
- package/skills/media-use/audio/scripts/lib/concurrency.test.mjs +41 -0
- package/skills/media-use/audio/scripts/lib/heygen.mjs +155 -0
- package/skills/media-use/audio/scripts/lib/heygen.test.mjs +103 -0
- package/skills/media-use/audio/scripts/lib/python.mjs +63 -0
- package/skills/media-use/audio/scripts/lib/python.test.mjs +68 -0
- package/skills/media-use/audio/scripts/lib/sfx.mjs +143 -0
- package/skills/media-use/audio/scripts/lib/sfx.test.mjs +69 -0
- package/skills/media-use/audio/scripts/lib/tts.mjs +378 -0
- package/skills/media-use/audio/scripts/lib/tts.spawn.test.mjs +158 -0
- package/skills/media-use/audio/scripts/lib/tts.test.mjs +157 -0
- package/skills/media-use/audio/scripts/lyria-recipe.py +136 -0
- package/skills/media-use/audio/scripts/wait-bgm.mjs +167 -0
- package/skills/media-use/luts/README.md +28 -0
- package/skills/media-use/luts/index.json +57 -0
- package/skills/media-use/references/audio.md +19 -0
- package/skills/media-use/references/grading.md +160 -0
- package/skills/media-use/references/media-treatment-recipes.md +929 -0
- package/skills/media-use/references/media-treatments.md +202 -0
- package/skills/media-use/references/memory.md +36 -0
- package/skills/media-use/references/meta.md +61 -0
- package/skills/media-use/references/operations.md +325 -0
- package/skills/media-use/references/resolve.md +139 -0
- package/skills/media-use/references/setup-providers.md +80 -0
- package/skills/media-use/references/telemetry-dashboard.md +49 -0
- package/skills/media-use/scripts/audio-duck.mjs +121 -0
- package/skills/media-use/scripts/dither.mjs +328 -0
- package/skills/media-use/scripts/dither.test.mjs +176 -0
- package/skills/media-use/scripts/eval.mjs +369 -0
- package/skills/media-use/scripts/lib/adopt.mjs +128 -0
- package/skills/media-use/scripts/lib/adopt.test.mjs +95 -0
- package/skills/media-use/scripts/lib/bgm-provider.mjs +20 -0
- package/skills/media-use/scripts/lib/brand-provider.mjs +59 -0
- package/skills/media-use/scripts/lib/bundled-sfx-provider.mjs +108 -0
- package/skills/media-use/scripts/lib/bundled-sfx-provider.test.mjs +85 -0
- package/skills/media-use/scripts/lib/cache.mjs +150 -0
- package/skills/media-use/scripts/lib/candidates.mjs +91 -0
- package/skills/media-use/scripts/lib/candidates.test.mjs +155 -0
- package/skills/media-use/scripts/lib/codex-provider.mjs +161 -0
- package/skills/media-use/scripts/lib/codex-provider.test.mjs +34 -0
- package/skills/media-use/scripts/lib/coverage.test.mjs +117 -0
- package/skills/media-use/scripts/lib/cube-build.mjs +181 -0
- package/skills/media-use/scripts/lib/cube-build.test.mjs +80 -0
- package/skills/media-use/scripts/lib/cube-validate.mjs +198 -0
- package/skills/media-use/scripts/lib/cube-validate.test.mjs +125 -0
- package/skills/media-use/scripts/lib/cutlist.mjs +184 -0
- package/skills/media-use/scripts/lib/cutlist.test.mjs +148 -0
- package/skills/media-use/scripts/lib/duck.mjs +89 -0
- package/skills/media-use/scripts/lib/duck.test.mjs +118 -0
- package/skills/media-use/scripts/lib/error-diffusion.mjs +230 -0
- package/skills/media-use/scripts/lib/error-diffusion.test.mjs +102 -0
- package/skills/media-use/scripts/lib/freeze.mjs +70 -0
- package/skills/media-use/scripts/lib/freeze.test.mjs +46 -0
- package/skills/media-use/scripts/lib/grade-analyzer.mjs +264 -0
- package/skills/media-use/scripts/lib/grade-analyzer.test.mjs +285 -0
- package/skills/media-use/scripts/lib/heygen-cli.mjs +191 -0
- package/skills/media-use/scripts/lib/heygen-cli.test.mjs +301 -0
- package/skills/media-use/scripts/lib/heygen-search.mjs +45 -0
- package/skills/media-use/scripts/lib/heygen-search.test.mjs +49 -0
- package/skills/media-use/scripts/lib/heygen-video-provider.mjs +127 -0
- package/skills/media-use/scripts/lib/heygen-video-provider.test.mjs +344 -0
- package/skills/media-use/scripts/lib/image-provider.mjs +44 -0
- package/skills/media-use/scripts/lib/index-gen.mjs +63 -0
- package/skills/media-use/scripts/lib/local-models.mjs +318 -0
- package/skills/media-use/scripts/lib/local-models.test.mjs +220 -0
- package/skills/media-use/scripts/lib/local-run.mjs +78 -0
- package/skills/media-use/scripts/lib/local-run.test.mjs +121 -0
- package/skills/media-use/scripts/lib/logo-provider.mjs +222 -0
- package/skills/media-use/scripts/lib/logo-provider.test.mjs +137 -0
- package/skills/media-use/scripts/lib/ltx-video-provider.mjs +94 -0
- package/skills/media-use/scripts/lib/ltx-video-provider.test.mjs +316 -0
- package/skills/media-use/scripts/lib/lut-preset-provider.mjs +266 -0
- package/skills/media-use/scripts/lib/lut-preset-provider.test.mjs +176 -0
- package/skills/media-use/scripts/lib/manifest.mjs +229 -0
- package/skills/media-use/scripts/lib/manifest.test.mjs +388 -0
- package/skills/media-use/scripts/lib/match.mjs +47 -0
- package/skills/media-use/scripts/lib/mflux-provider.mjs +128 -0
- package/skills/media-use/scripts/lib/mflux-provider.test.mjs +174 -0
- package/skills/media-use/scripts/lib/misses.mjs +49 -0
- package/skills/media-use/scripts/lib/misses.test.mjs +78 -0
- package/skills/media-use/scripts/lib/npx-sync.mjs +31 -0
- package/skills/media-use/scripts/lib/npx-sync.test.mjs +50 -0
- package/skills/media-use/scripts/lib/parakeet-words.mjs +27 -0
- package/skills/media-use/scripts/lib/parakeet-words.test.mjs +44 -0
- package/skills/media-use/scripts/lib/prefs-store.mjs +180 -0
- package/skills/media-use/scripts/lib/prefs-store.test.mjs +189 -0
- package/skills/media-use/scripts/lib/probe.mjs +39 -0
- package/skills/media-use/scripts/lib/probe.test.mjs +31 -0
- package/skills/media-use/scripts/lib/providers.mjs +5 -0
- package/skills/media-use/scripts/lib/recipe-store.mjs +367 -0
- package/skills/media-use/scripts/lib/recipe-store.test.mjs +367 -0
- package/skills/media-use/scripts/lib/registry.mjs +218 -0
- package/skills/media-use/scripts/lib/registry.test.mjs +261 -0
- package/skills/media-use/scripts/lib/search.mjs +24 -0
- package/skills/media-use/scripts/lib/search.test.mjs +32 -0
- package/skills/media-use/scripts/lib/sfx-provider.mjs +23 -0
- package/skills/media-use/scripts/lib/specs.mjs +132 -0
- package/skills/media-use/scripts/lib/specs.test.mjs +157 -0
- package/skills/media-use/scripts/lib/stats.mjs +117 -0
- package/skills/media-use/scripts/lib/stats.test.mjs +165 -0
- package/skills/media-use/scripts/lib/telemetry.mjs +222 -0
- package/skills/media-use/scripts/lib/telemetry.test.mjs +373 -0
- package/skills/media-use/scripts/lib/tts-local-provider.mjs +92 -0
- package/skills/media-use/scripts/lib/tts-local-provider.test.mjs +72 -0
- package/skills/media-use/scripts/lib/usage.mjs +57 -0
- package/skills/media-use/scripts/lib/usage.test.mjs +54 -0
- package/skills/media-use/scripts/lib/voice-provider.mjs +57 -0
- package/skills/media-use/scripts/lib/voice-provider.test.mjs +46 -0
- package/skills/media-use/scripts/lib/words.mjs +18 -0
- package/skills/media-use/scripts/prefs.mjs +70 -0
- package/skills/media-use/scripts/recipe.mjs +103 -0
- package/skills/media-use/scripts/resolve.mjs +1271 -0
- package/skills/media-use/scripts/resolve.test.mjs +1120 -0
- package/skills/media-use/scripts/transcribe.mjs +180 -0
- package/skills/media-use/scripts/transcript-cut.mjs +239 -0
- package/skills/motion-graphics/SKILL.md +176 -0
- package/skills/motion-graphics/agents/builder.md +40 -0
- package/skills/motion-graphics/agents/director.md +53 -0
- package/skills/motion-graphics/agents/finalize.md +17 -0
- package/skills/motion-graphics/catalog-map.md +40 -0
- package/skills/motion-graphics/categories/asset-fusion/module.md +37 -0
- package/skills/motion-graphics/categories/charts/module.md +21 -0
- package/skills/motion-graphics/categories/kinetic-type/module.md +19 -0
- package/skills/motion-graphics/categories/logo-reveal/module.md +17 -0
- package/skills/motion-graphics/categories/lower-thirds/module.md +16 -0
- package/skills/motion-graphics/categories/maps/bake-basemap.mjs +273 -0
- package/skills/motion-graphics/categories/maps/module.md +61 -0
- package/skills/motion-graphics/categories/news/module.md +56 -0
- package/skills/motion-graphics/categories/stat/module.md +21 -0
- package/skills/motion-graphics/categories/tweet/module.md +16 -0
- package/skills/motion-graphics/categories/webpage/module.md +30 -0
- package/skills/motion-graphics/grounding/PROTOCOL.md +64 -0
- package/skills/motion-graphics/grounding/locate.mjs +228 -0
- package/skills/motion-graphics/phases/source/guide.md +21 -0
- package/skills/motion-graphics/references/builder-contract.md +38 -0
- package/skills/motion-graphics/references/motion-vocabulary.md +43 -0
- package/skills/motion-graphics/references/shot-plan-ir.md +54 -0
- package/skills/motion-graphics/samples/asset-fusion/_ref-circle-highlight.html +306 -0
- package/skills/music-to-video/SKILL.md +208 -0
- package/skills/music-to-video/references/frame-skeleton.md +100 -0
- package/skills/music-to-video/references/montage.md +58 -0
- package/skills/music-to-video/references/motion-primitive-catalog.md +75 -0
- package/skills/music-to-video/references/motion-primitives/3d-card-flip/index.html +154 -0
- package/skills/music-to-video/references/motion-primitives/assets/gsap.min.js +11 -0
- package/skills/music-to-video/references/motion-primitives/bg-flow-field/index.html +326 -0
- package/skills/music-to-video/references/motion-primitives/binary-decrypt/index.html +120 -0
- package/skills/music-to-video/references/motion-primitives/blur-resolve/index.html +95 -0
- package/skills/music-to-video/references/motion-primitives/braam-punch/index.html +135 -0
- package/skills/music-to-video/references/motion-primitives/chromatic-split/index.html +146 -0
- package/skills/music-to-video/references/motion-primitives/chrome-sweep/index.html +103 -0
- package/skills/music-to-video/references/motion-primitives/counting-punch/index.html +154 -0
- package/skills/music-to-video/references/motion-primitives/crash-zoom-in/index.html +155 -0
- package/skills/music-to-video/references/motion-primitives/datamosh-smear/index.html +166 -0
- package/skills/music-to-video/references/motion-primitives/directional-fill/index.html +133 -0
- package/skills/music-to-video/references/motion-primitives/dolly-zoom/index.html +137 -0
- package/skills/music-to-video/references/motion-primitives/electric-arc/index.html +144 -0
- package/skills/music-to-video/references/motion-primitives/flash-cut/index.html +132 -0
- package/skills/music-to-video/references/motion-primitives/gooey-metaball/index.html +241 -0
- package/skills/music-to-video/references/motion-primitives/hard-cut/index.html +117 -0
- package/skills/music-to-video/references/motion-primitives/hypercut-whip/index.html +79 -0
- package/skills/music-to-video/references/motion-primitives/iris-open/index.html +104 -0
- package/skills/music-to-video/references/motion-primitives/kinetic-letter-in/index.html +98 -0
- package/skills/music-to-video/references/motion-primitives/liquid-morph/index.html +131 -0
- package/skills/music-to-video/references/motion-primitives/mask-reveal/index.html +109 -0
- package/skills/music-to-video/references/motion-primitives/mosaic-pack/index.html +124 -0
- package/skills/music-to-video/references/motion-primitives/neon-flicker/index.html +108 -0
- package/skills/music-to-video/references/motion-primitives/outline-to-fill/index.html +117 -0
- package/skills/music-to-video/references/motion-primitives/palette-flip/index.html +132 -0
- package/skills/music-to-video/references/motion-primitives/particle-burst/index.html +141 -0
- package/skills/music-to-video/references/motion-primitives/pixel-dissolve/index.html +121 -0
- package/skills/music-to-video/references/motion-primitives/radial-burst-lines/index.html +160 -0
- package/skills/music-to-video/references/motion-primitives/screen-shake/index.html +113 -0
- package/skills/music-to-video/references/motion-primitives/slot-machine-reveal/index.html +130 -0
- package/skills/music-to-video/references/motion-primitives/spotlight-sweep/index.html +137 -0
- package/skills/music-to-video/references/motion-primitives/staggered-exit/index.html +117 -0
- package/skills/music-to-video/references/motion-primitives/text-spectral-rays/USAGE.md +42 -0
- package/skills/music-to-video/references/motion-primitives/text-spectral-rays/index.html +313 -0
- package/skills/music-to-video/references/motion-primitives/text-wave-distort/index.html +136 -0
- package/skills/music-to-video/references/motion-primitives/tile-mosaic/index.html +144 -0
- package/skills/music-to-video/references/motion-primitives/typewriter-reveal/index.html +122 -0
- package/skills/music-to-video/references/motion-primitives/word-grid-burst/index.html +126 -0
- package/skills/music-to-video/references/planning.md +104 -0
- package/skills/music-to-video/references/storyboard-format.md +94 -0
- package/skills/music-to-video/references/template-catalog.md +106 -0
- package/skills/music-to-video/references/templates/card-flyby/index.html +527 -0
- package/skills/music-to-video/references/templates/card-flyby/program.json +13 -0
- package/skills/music-to-video/references/templates/held-message-living-field/index.html +485 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/asphalt-031.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/bark-014.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/brick.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/bricks-075-a.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/bricks-101.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/bricks-102.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/bricks-104.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/carpet.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/concrete-034.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/concrete-042-a.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/concrete-046.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/concrete-047-a.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/concrete.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/diamond-plate-009.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/fabric-080.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/fabric-083.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/grass-001.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/grass-004.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/grass-005.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/ground-037.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/ground-054.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/ground-068.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/ground-080.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/ground-103.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/ground-104.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/lava.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/leather-037.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/marble-012.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/marble-016.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/metal-032.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/metal-038.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/metal-041-a.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/metal-046-b.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/metal-048-a.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/metal-049-a.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/metal-055-a.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/metal-061-b.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/metal.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/onyx.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/painted-plaster-017.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/paving-stones-138.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/paving-stones-150.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/plaster-001.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/road-007.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/road-008-a.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/road-009-c.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/road-012-a.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/road-012-b.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/road-013-a.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/rock-058.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/rock-063.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/rock.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/snow-015.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/snow.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/tiles-138.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/travertine-009.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/wood-049.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/wood-051.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/wood-058.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/wood-066.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/wood-092.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/wood-094.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/wood-floor-051.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/wood-floor-064.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/wood-floor-070.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/assets/texture-mask-text/masks/wood.png +0 -0
- package/skills/music-to-video/references/templates/held-text-strobe-burst/index.html +302 -0
- package/skills/music-to-video/references/templates/intro-kinetic-cascade/index.html +610 -0
- package/skills/music-to-video/references/templates/intro-kinetic-cascade/program.json +41 -0
- package/skills/music-to-video/references/templates/logo-split-lockup-pulse/assets/fredoka-700.woff2 +0 -0
- package/skills/music-to-video/references/templates/logo-split-lockup-pulse/index.html +596 -0
- package/skills/music-to-video/references/templates/poster-tile-mosaic/index.html +589 -0
- package/skills/music-to-video/references/templates/poster-tile-mosaic/program.json +25 -0
- package/skills/music-to-video/references/templates/roll-flipbook-word-cycle/index.html +267 -0
- package/skills/music-to-video/references/templates/split-anchor-word-slot/index.html +594 -0
- package/skills/music-to-video/references/templates/split-anchor-word-slot/program.json +39 -0
- package/skills/music-to-video/references/templates/typewriter-phrase-keyword-shuffle/index.html +238 -0
- package/skills/music-to-video/scripts/analyze-beatgrid.py +542 -0
- package/skills/music-to-video/scripts/assemble-index.mjs +220 -0
- package/skills/music-to-video/scripts/lib/storyboard.mjs +249 -0
- package/skills/music-to-video/scripts/stage-assets.mjs +58 -0
- package/skills/music-to-video/scripts/validate-plan.mjs +161 -0
- package/skills/music-to-video/sub-agents/frame-worker.md +49 -0
- package/skills/pr-to-video/SKILL.md +269 -0
- package/skills/pr-to-video/references/code-vocabulary.md +111 -0
- package/skills/pr-to-video/references/cut-catalog.md +215 -0
- package/skills/pr-to-video/references/motion-language.md +156 -0
- package/skills/pr-to-video/references/story-design.md +230 -0
- package/skills/pr-to-video/references/visual-design.md +164 -0
- package/skills/pr-to-video/scripts/assemble-index.mjs +629 -0
- package/skills/pr-to-video/scripts/assemble-index.test.mjs +75 -0
- package/skills/pr-to-video/scripts/audio.mjs +291 -0
- package/skills/pr-to-video/scripts/build-frame.mjs +586 -0
- package/skills/pr-to-video/scripts/captions.mjs +521 -0
- package/skills/pr-to-video/scripts/captions.test.mjs +219 -0
- package/skills/pr-to-video/scripts/fetch-people-avatars.mjs +157 -0
- package/skills/pr-to-video/scripts/fetch-pr.mjs +234 -0
- package/skills/pr-to-video/scripts/frame-contract.test.mjs +209 -0
- package/skills/pr-to-video/scripts/frame-packets.mjs +62 -0
- package/skills/pr-to-video/scripts/ingest.mjs +561 -0
- package/skills/pr-to-video/scripts/lib/assets.mjs +56 -0
- package/skills/pr-to-video/scripts/lib/dimensions.mjs +45 -0
- package/skills/pr-to-video/scripts/lib/frame-contract.mjs +54 -0
- package/skills/pr-to-video/scripts/lib/pad-frame-duration.mjs +36 -0
- package/skills/pr-to-video/scripts/lib/storyboard.mjs +249 -0
- package/skills/pr-to-video/scripts/lib/tokens.mjs +211 -0
- package/skills/pr-to-video/scripts/lib/transition-registry.mjs +38 -0
- package/skills/pr-to-video/scripts/lib/transitions.json +71 -0
- package/skills/pr-to-video/scripts/preflight.mjs +51 -0
- package/skills/pr-to-video/scripts/project-dir.mjs +92 -0
- package/skills/pr-to-video/scripts/transitions.mjs +381 -0
- package/skills/pr-to-video/scripts/workflow-guardrails.test.mjs +198 -0
- package/skills/pr-to-video/sub-agents/frame-worker.md +38 -0
- package/skills/product-launch-video/SKILL.md +260 -0
- package/skills/product-launch-video/references/cut-catalog.md +220 -0
- package/skills/product-launch-video/references/motion-language.md +156 -0
- package/skills/product-launch-video/references/story-design.md +508 -0
- package/skills/product-launch-video/references/visual-design.md +126 -0
- package/skills/product-launch-video/scripts/assemble-index.mjs +771 -0
- package/skills/product-launch-video/scripts/assemble-index.test.mjs +72 -0
- package/skills/product-launch-video/scripts/audio.mjs +291 -0
- package/skills/product-launch-video/scripts/audio.test.mjs +218 -0
- package/skills/product-launch-video/scripts/build-frame.mjs +549 -0
- package/skills/product-launch-video/scripts/captions.mjs +521 -0
- package/skills/product-launch-video/scripts/captions.test.mjs +219 -0
- package/skills/product-launch-video/scripts/capture-skill-guardrails.test.mjs +39 -0
- package/skills/product-launch-video/scripts/frame-packets.mjs +27 -0
- package/skills/product-launch-video/scripts/frame-packets.test.mjs +144 -0
- package/skills/product-launch-video/scripts/lib/assets.mjs +56 -0
- package/skills/product-launch-video/scripts/lib/dimensions.mjs +45 -0
- package/skills/product-launch-video/scripts/lib/pad-frame-duration.mjs +36 -0
- package/skills/product-launch-video/scripts/lib/pad-frame-duration.test.mjs +76 -0
- package/skills/product-launch-video/scripts/lib/storyboard.mjs +249 -0
- package/skills/product-launch-video/scripts/lib/tokens.mjs +218 -0
- package/skills/product-launch-video/scripts/lib/tokens.test.mjs +57 -0
- package/skills/product-launch-video/scripts/lib/transition-registry.mjs +38 -0
- package/skills/product-launch-video/scripts/lib/transitions.json +71 -0
- package/skills/product-launch-video/scripts/media-contract.test.mjs +200 -0
- package/skills/product-launch-video/scripts/stage-assets.mjs +39 -0
- package/skills/product-launch-video/scripts/stage-assets.test.mjs +52 -0
- package/skills/product-launch-video/scripts/transitions.mjs +381 -0
- package/skills/product-launch-video/sub-agents/frame-worker.md +21 -0
- package/skills/remotion-to-hyperframes/SKILL.md +129 -0
- package/skills/remotion-to-hyperframes/assets/.gitkeep +0 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/run.sh +249 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/README.md +41 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/expected.json +26 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/hf-src/index.html +61 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/package.json +14 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/remotion.config.ts +13 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/src/Root.tsx +13 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/src/TitleCard.tsx +34 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/src/index.ts +4 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-1-title-card/remotion-src/tsconfig.json +15 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/README.md +54 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/expected.json +29 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/hf-src/index.html +118 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/package.json +14 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/remotion.config.ts +13 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/src/MultiScene.tsx +105 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/src/Root.tsx +13 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/src/index.ts +4 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/remotion-src/tsconfig.json +15 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-2-multi-scene/setup.sh +34 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/README.md +85 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/expected.json +41 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/hf-src/index.html +269 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/package.json +15 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/remotion.config.ts +13 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/Root.tsx +27 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/Stargazed.tsx +37 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/components/AnimatedNumber.tsx +23 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/components/StatCard.tsx +59 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/components/UnderlinedText.tsx +47 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/index.ts +4 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/OutroScene.tsx +18 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/StatsScene.tsx +34 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/src/scenes/TitleScene.tsx +55 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-3-data-driven/remotion-src/tsconfig.json +15 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/README.md +51 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/01-use-state.tsx +29 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/02-use-effect-deps.tsx +29 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/03-async-metadata.tsx +39 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/04-third-party-react.tsx +30 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/05-lambda-config.tsx +38 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/06-warnings-only.tsx +36 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/07-custom-hook.tsx +28 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/cases/08-mixed.tsx +41 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/expected.json +85 -0
- package/skills/remotion-to-hyperframes/assets/test-corpus/tier-4-escape-hatch/validate.sh +110 -0
- package/skills/remotion-to-hyperframes/references/api-map.md +142 -0
- package/skills/remotion-to-hyperframes/references/escape-hatch.md +115 -0
- package/skills/remotion-to-hyperframes/references/eval.md +140 -0
- package/skills/remotion-to-hyperframes/references/fonts.md +112 -0
- package/skills/remotion-to-hyperframes/references/limitations.md +136 -0
- package/skills/remotion-to-hyperframes/references/lottie.md +121 -0
- package/skills/remotion-to-hyperframes/references/media.md +149 -0
- package/skills/remotion-to-hyperframes/references/parameters.md +167 -0
- package/skills/remotion-to-hyperframes/references/sequencing.md +198 -0
- package/skills/remotion-to-hyperframes/references/timing.md +165 -0
- package/skills/remotion-to-hyperframes/references/transitions.md +114 -0
- package/skills/remotion-to-hyperframes/scripts/.gitkeep +0 -0
- package/skills/remotion-to-hyperframes/scripts/frame_strip.sh +107 -0
- package/skills/remotion-to-hyperframes/scripts/lint_source.py +370 -0
- package/skills/remotion-to-hyperframes/scripts/render_diff.sh +103 -0
- package/skills/remotion-to-hyperframes/scripts/tests/fixtures/blocker.tsx +50 -0
- package/skills/remotion-to-hyperframes/scripts/tests/fixtures/clean.tsx +46 -0
- package/skills/remotion-to-hyperframes/scripts/tests/smoke.sh +90 -0
- package/skills/slideshow/SKILL.md +529 -0
- package/skills/slideshow/references/standalone-harness.md +1020 -0
- package/skills/talking-head-recut/NOTICE.md +39 -0
- package/skills/talking-head-recut/SKILL.md +1211 -0
- package/skills/talking-head-recut/assets/fonts/Caveat-400-latin.woff2 +0 -0
- package/skills/talking-head-recut/assets/fonts/Caveat-700-latin.woff2 +0 -0
- package/skills/talking-head-recut/assets/fonts/Inter-400-latin.woff2 +0 -0
- package/skills/talking-head-recut/assets/fonts/Inter-700-latin.woff2 +0 -0
- package/skills/talking-head-recut/assets/fonts/LXGWWenKaiTC-400-latin.woff2 +0 -0
- package/skills/talking-head-recut/assets/fonts/Virgil.woff2 +0 -0
- package/skills/talking-head-recut/assets/vendor/gsap.min.js +10 -0
- package/skills/talking-head-recut/media-contract.test.mjs +35 -0
- package/skills/talking-head-recut/references/DESIGN_INDEX.md +145 -0
- package/skills/talking-head-recut/references/frames/clean.html +92 -0
- package/skills/talking-head-recut/references/frames/hairline.html +171 -0
- package/skills/talking-head-recut/references/frames/polaroid.html +131 -0
- package/skills/talking-head-recut/references/layouts/overlay.html +164 -0
- package/skills/talking-head-recut/references/layouts/pip.html +143 -0
- package/skills/talking-head-recut/references/layouts/split.html +121 -0
- package/skills/talking-head-recut/references/layouts/stack.html +109 -0
- package/skills/talking-head-recut/references/styles/academic.html +172 -0
- package/skills/talking-head-recut/references/styles/audit.html +170 -0
- package/skills/talking-head-recut/references/styles/editorial.html +189 -0
- package/skills/talking-head-recut/references/styles/geom.html +181 -0
- package/skills/talking-head-recut/references/styles/minimal.html +130 -0
- package/skills/talking-head-recut/references/styles/spotlight.html +142 -0
- package/skills/talking-head-recut/references/styles/swiss.html +188 -0
- package/skills/talking-head-recut/references/styles/terminal.html +196 -0
- package/skills/talking-head-recut/references/styles/whiteboard.html +170 -0
- package/skills/talking-head-recut/references/styles/xhs.html +206 -0
- package/skills/gsap/SKILL.md +0 -213
- package/skills/gsap/references/effects.md +0 -297
- package/skills/hyperframes/patterns.md +0 -118
- package/skills/hyperframes/references/captions.md +0 -132
- package/skills/hyperframes/references/css-patterns.md +0 -373
- package/skills/hyperframes/references/motion-principles.md +0 -69
- package/skills/hyperframes/references/tts.md +0 -75
- package/skills/hyperframes/scripts/contrast-report.mjs +0 -335
- package/skills/hyperframes/visual-styles.md +0 -211
- package/skills/website-to-hyperframes/SKILL.md +0 -125
- package/skills/website-to-hyperframes/references/step-1-capture.md +0 -74
- package/skills/website-to-hyperframes/references/step-2-design.md +0 -178
- package/skills/website-to-hyperframes/references/step-4-storyboard.md +0 -246
- package/skills/website-to-hyperframes/references/step-5-vo.md +0 -42
- package/skills/website-to-hyperframes/references/step-6-build.md +0 -229
- package/skills/website-to-hyperframes/references/step-7-validate.md +0 -114
- /package/skills/{hyperframes/references → hyperframes-animation}/transitions/css-3d.md +0 -0
- /package/skills/{hyperframes/references → hyperframes-animation}/transitions/css-blur.md +0 -0
- /package/skills/{hyperframes/references → hyperframes-animation}/transitions/css-cover.md +0 -0
- /package/skills/{hyperframes/references → hyperframes-animation}/transitions/css-dissolve.md +0 -0
- /package/skills/{hyperframes/references → hyperframes-animation}/transitions/css-distortion.md +0 -0
- /package/skills/{hyperframes/references → hyperframes-animation}/transitions/css-grid.md +0 -0
- /package/skills/{hyperframes/references → hyperframes-animation}/transitions/css-light.md +0 -0
- /package/skills/{hyperframes/references → hyperframes-animation}/transitions/css-mechanical.md +0 -0
- /package/skills/{hyperframes/references → hyperframes-animation}/transitions/css-other.md +0 -0
- /package/skills/{hyperframes/references → hyperframes-animation}/transitions/css-push.md +0 -0
- /package/skills/{hyperframes/references → hyperframes-animation}/transitions/css-radial.md +0 -0
- /package/skills/{hyperframes/references → hyperframes-animation}/transitions/css-scale.md +0 -0
- /package/skills/{hyperframes → hyperframes-creative}/palettes/bold-energetic.md +0 -0
- /package/skills/{hyperframes → hyperframes-creative}/palettes/clean-corporate.md +0 -0
- /package/skills/{hyperframes → hyperframes-creative}/palettes/dark-premium.md +0 -0
- /package/skills/{hyperframes → hyperframes-creative}/palettes/jewel-rich.md +0 -0
- /package/skills/{hyperframes → hyperframes-creative}/palettes/monochrome.md +0 -0
- /package/skills/{hyperframes → hyperframes-creative}/palettes/nature-earth.md +0 -0
- /package/skills/{hyperframes → hyperframes-creative}/palettes/neon-electric.md +0 -0
- /package/skills/{hyperframes → hyperframes-creative}/palettes/pastel-soft.md +0 -0
- /package/skills/{hyperframes → hyperframes-creative}/palettes/warm-editorial.md +0 -0
|
@@ -0,0 +1,629 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// assemble-index.mjs — deterministic top-level index.html assembly for a
|
|
3
|
+
// HyperFrames project. No subagent, no judgment: turns STORYBOARD.md + the
|
|
4
|
+
// built frame files (+ optional audio_meta.json) into the standalone index.html
|
|
5
|
+
// the renderer consumes, and stages the frame-named capture assets into assets/.
|
|
6
|
+
//
|
|
7
|
+
// index.html is a *standalone* composition (root <div id="root"> directly in
|
|
8
|
+
// <body>, no <template> wrapper — template is for sub-comps). Structure is
|
|
9
|
+
// modeled on the canonical fixture packages/studio/fixtures/storyboard-sample/
|
|
10
|
+
// index.html and the authoritative head/audio template in
|
|
11
|
+
// packages/core/docs/quickstart-template.html. Frame mount order = STORYBOARD
|
|
12
|
+
// document order. Transitions are NOT written here — the transitions injector
|
|
13
|
+
// mutates this file afterward (data-start/duration/track-index + GSAP).
|
|
14
|
+
//
|
|
15
|
+
// Track lanes. Same-track time-overlap is this workflow's own assembly convention,
|
|
16
|
+
// not a framework rule: the render never reads data-track-index, and no lint rule
|
|
17
|
+
// checks overlap (timeline_track_too_dense counts elements per lane for readability).
|
|
18
|
+
// The convention exists because the frame injector below ping-pongs 0/1 for overlaps:
|
|
19
|
+
// 1 frame sub-comp clips (sequential; the injector 0/1-ping-pongs for overlaps)
|
|
20
|
+
// 2 captions sub-comp clip (full-duration overlay, on top of frames)
|
|
21
|
+
// 10 per-frame voice <audio>
|
|
22
|
+
// 11 BGM <audio>
|
|
23
|
+
// 20+i SFX <audio> (one lane each)
|
|
24
|
+
//
|
|
25
|
+
// audio_meta.json contract (produced by audio.mjs; OPTIONAL — absent ⇒ silent
|
|
26
|
+
// video, frames only). Durations come from STORYBOARD (audio sync-durations
|
|
27
|
+
// writes them), NOT from here; this file carries only media PATHS, keyed by
|
|
28
|
+
// frame number:
|
|
29
|
+
// { "bgm": { "path": "assets/bgm/x.mp3", "volume": 0.12 } | null,
|
|
30
|
+
// "voices":[ { "frame": 3, "path": "assets/voice/03.wav" } ],
|
|
31
|
+
// "sfx": [ { "frame": 3, "file": "assets/sfx/x.mp3", "offset_s": 0,
|
|
32
|
+
// "duration_s": 1.0, "volume": 0.35 } ] }
|
|
33
|
+
//
|
|
34
|
+
// Reads: --storyboard STORYBOARD.md, --hyperframes <project root>,
|
|
35
|
+
// [--audio-meta audio_meta.json]. On disk: each built frame's src html,
|
|
36
|
+
// capture/{assets,assets/videos,screenshots}/<basename> for staging, compositions/captions.html.
|
|
37
|
+
// Writes: <project>/index.html + stages assets/<basename> + (guard ① below)
|
|
38
|
+
// repairs a frame file in place when its root is missing data-width/height.
|
|
39
|
+
//
|
|
40
|
+
// Pre-assembly frame guards (run in the same pass that reads each frame, so common
|
|
41
|
+
// `lint` failures surface HERE instead of after assembly + a wasted render):
|
|
42
|
+
// ① AUTO-REPAIR — a sub-comp root missing data-width/data-height: inject the canvas
|
|
43
|
+
// dims (the renderer needs them on the cloned root; else lint root_missing_dimensions).
|
|
44
|
+
// ② HARD FAIL — a timed element (data-start+duration+track-index) that is not the root
|
|
45
|
+
// and lacks class="clip" (shows the whole frame), or two same-track clips that overlap.
|
|
46
|
+
// (Media inside a sub-comp is NOT a violation: the runtime seeks + decodes nested
|
|
47
|
+
// <video>/<audio> at any depth — see packages/core/src/runtime/{media,startResolver}.ts.)
|
|
48
|
+
//
|
|
49
|
+
// Exit 0 = index.html written + summary. Exit 1 = fatal contract break (no
|
|
50
|
+
// frames, a built/animated frame missing its src/file, a frame with no
|
|
51
|
+
// duration, an inner data-composition-id mismatch, or a guard ② violation).
|
|
52
|
+
// No backstop: fix upstream.
|
|
53
|
+
|
|
54
|
+
import { existsSync, readFileSync, writeFileSync } from "node:fs";
|
|
55
|
+
import { spawnSync } from "node:child_process";
|
|
56
|
+
import { basename, join, resolve } from "node:path";
|
|
57
|
+
import { parseStoryboard } from "./lib/storyboard.mjs";
|
|
58
|
+
import { parseFormat } from "./lib/dimensions.mjs";
|
|
59
|
+
import { stageAssets } from "./lib/assets.mjs";
|
|
60
|
+
import { parseColors, semanticColors } from "./lib/tokens.mjs";
|
|
61
|
+
import { validateFrameHtml } from "./lib/frame-contract.mjs";
|
|
62
|
+
import { bgmDefaultVolume } from "../../media-use/audio/scripts/lib/bgm.mjs";
|
|
63
|
+
|
|
64
|
+
// ---------- argv ----------
|
|
65
|
+
const argv = process.argv.slice(2);
|
|
66
|
+
const flag = (name, def) => {
|
|
67
|
+
const i = argv.indexOf(`--${name}`);
|
|
68
|
+
return i >= 0 && i + 1 < argv.length ? argv[i + 1] : def;
|
|
69
|
+
};
|
|
70
|
+
// Deliberate escape from the bgm_pending refusal below — for previewing while a detached
|
|
71
|
+
// generate is still running. Off by default so a silent film can't ship by accident.
|
|
72
|
+
const allowPendingBgm = argv.includes("--allow-pending-bgm");
|
|
73
|
+
function die(msg) {
|
|
74
|
+
console.error(`✗ assemble-index.mjs: ${msg}`);
|
|
75
|
+
process.exit(1);
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
// Ensure the BGM track is at least `total` seconds long. HeyGen (and most music
|
|
79
|
+
// libraries) return a short loopable clip (~15–30s); mounting it at data-duration=total
|
|
80
|
+
// would leave the video's TAIL SILENT. If the file is short, loop-extend it to `total`
|
|
81
|
+
// (with a 0.4s fade-in + 1.5s fade-out) into a sibling *.loop.mp3 and return that path.
|
|
82
|
+
// Needs ffprobe+ffmpeg (present in the render env); degrades to the original + a warning
|
|
83
|
+
// when they're absent, so assembly never hard-fails on audio tooling.
|
|
84
|
+
function ensureBgmCovers(relPath, hyperframesDir, total) {
|
|
85
|
+
const abs = join(hyperframesDir, relPath);
|
|
86
|
+
const probe = spawnSync(
|
|
87
|
+
"ffprobe",
|
|
88
|
+
["-v", "error", "-show_entries", "format=duration", "-of", "csv=p=0", "--", abs],
|
|
89
|
+
{ encoding: "utf8" },
|
|
90
|
+
);
|
|
91
|
+
if (probe.status !== 0) return { looped: false, short: false, reason: "ffprobe unavailable" };
|
|
92
|
+
const dur = parseFloat(String(probe.stdout || "").trim());
|
|
93
|
+
if (!Number.isFinite(dur) || dur <= 0)
|
|
94
|
+
return { looped: false, short: false, reason: "unreadable duration" };
|
|
95
|
+
if (dur >= total - 0.1) return { looped: false, short: false, dur }; // already covers
|
|
96
|
+
const relOut = relPath.replace(/\.([^./]+)$/, ".loop.$1");
|
|
97
|
+
const absOut = join(hyperframesDir, relOut);
|
|
98
|
+
const fadeOut = Math.max(0, total - 1.5);
|
|
99
|
+
const ff = spawnSync(
|
|
100
|
+
"ffmpeg",
|
|
101
|
+
[
|
|
102
|
+
"-y",
|
|
103
|
+
"-stream_loop",
|
|
104
|
+
"-1",
|
|
105
|
+
"-i",
|
|
106
|
+
abs,
|
|
107
|
+
"-t",
|
|
108
|
+
String(total),
|
|
109
|
+
"-af",
|
|
110
|
+
`afade=t=in:st=0:d=0.4,afade=t=out:st=${fadeOut}:d=1.5`,
|
|
111
|
+
"-c:a",
|
|
112
|
+
"libmp3lame",
|
|
113
|
+
"-q:a",
|
|
114
|
+
"2",
|
|
115
|
+
absOut,
|
|
116
|
+
],
|
|
117
|
+
{ encoding: "utf8" },
|
|
118
|
+
);
|
|
119
|
+
if (ff.status !== 0 || !existsSync(absOut))
|
|
120
|
+
return { looped: false, short: true, dur, reason: "ffmpeg unavailable" };
|
|
121
|
+
return { looped: true, rel: relOut, from: dur };
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
const hyperframesDir = resolve(flag("hyperframes", "."));
|
|
125
|
+
const storyboardPath = resolve(flag("storyboard", join(hyperframesDir, "STORYBOARD.md")));
|
|
126
|
+
const audioMetaPath = resolve(flag("audio-meta", join(hyperframesDir, "audio_meta.json")));
|
|
127
|
+
const outPath = resolve(flag("out", join(hyperframesDir, "index.html")));
|
|
128
|
+
|
|
129
|
+
const r3 = (x) => Math.round(x * 1000) / 1000;
|
|
130
|
+
const anomalies = [];
|
|
131
|
+
const frameErrors = []; // fatal per-frame composition violations (guard ②) — reported together
|
|
132
|
+
const repairs = []; // auto-repairs applied to frame files in place (guard ①)
|
|
133
|
+
|
|
134
|
+
// ---------- parse storyboard ----------
|
|
135
|
+
if (!existsSync(storyboardPath)) die(`STORYBOARD.md not found at ${storyboardPath}`);
|
|
136
|
+
const manifest = parseStoryboard(readFileSync(storyboardPath, "utf8"));
|
|
137
|
+
const { width: WIDTH, height: HEIGHT } = parseFormat(manifest.globals.format);
|
|
138
|
+
|
|
139
|
+
// ---------- per-frame composition guards (see header ①②) ----------
|
|
140
|
+
// String-level checks on each frame's HTML — no DOM parse, deterministic, run in
|
|
141
|
+
// the same pass that already reads the file. OPEN_TAG matches one opening tag while
|
|
142
|
+
// tolerating quoted attribute values that contain ">" (e.g. inline styles).
|
|
143
|
+
const OPEN_TAG = "<([a-zA-Z][a-zA-Z0-9-]*)((?:[^>\"']|\"[^\"]*\"|'[^']*')*)>";
|
|
144
|
+
const attrPresent = (attrs, name) => new RegExp(`(?:^|\\s)${name}(?:[\\s=]|$)`).test(attrs);
|
|
145
|
+
const attrValue = (attrs, name) => {
|
|
146
|
+
const m = attrs.match(new RegExp(`(?:^|\\s)${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)')`));
|
|
147
|
+
return m ? (m[1] ?? m[2]) : null;
|
|
148
|
+
};
|
|
149
|
+
// The root (or a nested-comp mount) legitimately carries timing without class="clip".
|
|
150
|
+
const isRootish = (attrs) =>
|
|
151
|
+
/(?:^|\s)id\s*=\s*["']root["']/.test(attrs) ||
|
|
152
|
+
attrPresent(attrs, "data-composition-id") ||
|
|
153
|
+
attrPresent(attrs, "data-composition-src");
|
|
154
|
+
|
|
155
|
+
// Locate the composition root opening tag: prefer id="root", else the first element
|
|
156
|
+
// carrying data-composition-id. Returns { start, end, full, attrs } or null.
|
|
157
|
+
function findRootTag(html) {
|
|
158
|
+
const re = new RegExp(OPEN_TAG, "g");
|
|
159
|
+
let m;
|
|
160
|
+
let firstCompId = null;
|
|
161
|
+
while ((m = re.exec(html))) {
|
|
162
|
+
const attrs = m[2];
|
|
163
|
+
if (/(?:^|\s)id\s*=\s*["']root["']/.test(attrs))
|
|
164
|
+
return { start: m.index, end: m.index + m[0].length, full: m[0], attrs };
|
|
165
|
+
if (attrPresent(attrs, "data-composition-id") && !firstCompId)
|
|
166
|
+
firstCompId = { start: m.index, end: m.index + m[0].length, full: m[0], attrs };
|
|
167
|
+
}
|
|
168
|
+
return firstCompId;
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
// Returns { errors: string[], repairedHtml: string|null, repairNote: string|null }.
|
|
172
|
+
function guardFrame(html, label) {
|
|
173
|
+
const errors = [];
|
|
174
|
+
// Scan a copy with comments + <script>/<style> bodies blanked, so a tag-like string
|
|
175
|
+
// in a comment (e.g. "<!-- match the host <video> coords -->") or in GSAP code can't
|
|
176
|
+
// trip ②. ① still splices into the ORIGINAL html, so its offsets stay correct.
|
|
177
|
+
const scan = html
|
|
178
|
+
.replace(/<!--[\s\S]*?-->/g, " ")
|
|
179
|
+
.replace(/<script\b[\s\S]*?<\/script[^>]*>/gi, " ")
|
|
180
|
+
.replace(/<style\b[\s\S]*?<\/style[^>]*>/gi, " ");
|
|
181
|
+
|
|
182
|
+
// ② timed-element checks: missing class="clip", and same-track window overlap.
|
|
183
|
+
// (Media inside a sub-comp is fine: the runtime's global media sweep seeks + decodes
|
|
184
|
+
// <video>/<audio> at any nesting depth, re-basing each clip's local data-start by its
|
|
185
|
+
// host composition's absolute start — no root-child requirement. See
|
|
186
|
+
// packages/core/src/runtime/{media,startResolver}.ts.)
|
|
187
|
+
const re = new RegExp(OPEN_TAG, "g");
|
|
188
|
+
const clips = [];
|
|
189
|
+
let m;
|
|
190
|
+
while ((m = re.exec(scan))) {
|
|
191
|
+
const attrs = m[2];
|
|
192
|
+
if (
|
|
193
|
+
!attrPresent(attrs, "data-start") ||
|
|
194
|
+
!attrPresent(attrs, "data-duration") ||
|
|
195
|
+
!attrPresent(attrs, "data-track-index")
|
|
196
|
+
)
|
|
197
|
+
continue;
|
|
198
|
+
if (isRootish(attrs)) continue;
|
|
199
|
+
if (!/(?:^|\s)class\s*=\s*["'][^"']*\bclip\b[^"']*["']/.test(attrs)) {
|
|
200
|
+
errors.push(
|
|
201
|
+
`${label}: a timed <${m[1]}> (data-start/duration/track-index) has no class="clip" — it renders for the whole frame instead of only its window. Add class="clip", or remove the timing attrs if it is a GSAP-animated element meant to be present throughout.`,
|
|
202
|
+
);
|
|
203
|
+
}
|
|
204
|
+
const track = attrValue(attrs, "data-track-index");
|
|
205
|
+
const start = parseFloat(attrValue(attrs, "data-start"));
|
|
206
|
+
const dur = parseFloat(attrValue(attrs, "data-duration"));
|
|
207
|
+
if (track != null && Number.isFinite(start) && Number.isFinite(dur))
|
|
208
|
+
clips.push({ track, start, end: start + dur });
|
|
209
|
+
}
|
|
210
|
+
const EPS = 1e-3; // adjacent clips that merely touch are legal
|
|
211
|
+
const byTrack = new Map();
|
|
212
|
+
for (const c of clips) {
|
|
213
|
+
const arr = byTrack.get(c.track);
|
|
214
|
+
if (arr) arr.push(c);
|
|
215
|
+
else byTrack.set(c.track, [c]);
|
|
216
|
+
}
|
|
217
|
+
for (const [track, list] of byTrack) {
|
|
218
|
+
list.sort((a, b) => a.start - b.start);
|
|
219
|
+
for (let i = 1; i < list.length; i++) {
|
|
220
|
+
if (list[i].start < list[i - 1].end - EPS) {
|
|
221
|
+
errors.push(
|
|
222
|
+
`${label}: clips on track ${track} overlap (one ends at ${r3(list[i - 1].end)}s, the next starts at ${r3(list[i].start)}s). This workflow's injector assumes one clip per lane at a time. The render itself tolerates the overlap; put them on distinct data-track-index lanes or fix their windows.`,
|
|
223
|
+
);
|
|
224
|
+
break; // one report per track is enough
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
// ① auto-repair: ensure the root carries data-width / data-height.
|
|
230
|
+
let repairedHtml = null;
|
|
231
|
+
let repairNote = null;
|
|
232
|
+
const root = findRootTag(html);
|
|
233
|
+
if (root) {
|
|
234
|
+
const needW = !attrPresent(root.attrs, "data-width");
|
|
235
|
+
const needH = !attrPresent(root.attrs, "data-height");
|
|
236
|
+
if (needW || needH) {
|
|
237
|
+
const inject =
|
|
238
|
+
(needW ? ` data-width="${WIDTH}"` : "") + (needH ? ` data-height="${HEIGHT}"` : "");
|
|
239
|
+
const newTag = root.full.replace(/(\/?>)$/, `${inject}$1`);
|
|
240
|
+
repairedHtml = html.slice(0, root.start) + newTag + html.slice(root.end);
|
|
241
|
+
repairNote = `${label}: injected${needW ? " data-width" : ""}${needH ? " data-height" : ""} (${WIDTH}×${HEIGHT}) on the root — was missing (would lint root_missing_dimensions)`;
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
return { errors, repairedHtml, repairNote };
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
// ---------- resolve mountable frames in document order ----------
|
|
249
|
+
// A frame mounts when its src html exists on disk. A built/animated frame
|
|
250
|
+
// missing its src/file is a contract break (die). An outline frame with no
|
|
251
|
+
// file is skipped (still a placeholder) with an anomaly note.
|
|
252
|
+
const mounted = [];
|
|
253
|
+
for (const f of manifest.frames) {
|
|
254
|
+
const label = `frame ${f.number ?? f.index}${f.title ? ` (${f.title})` : ""}`;
|
|
255
|
+
const built = f.status === "built" || f.status === "animated";
|
|
256
|
+
if (!f.src) {
|
|
257
|
+
if (built) die(`${label} is ${f.status} but has no \`src\` — the orchestrator must write it`);
|
|
258
|
+
anomalies.push(`${label}: status ${f.status}, no src — skipped`);
|
|
259
|
+
continue;
|
|
260
|
+
}
|
|
261
|
+
const compAbs = join(hyperframesDir, f.src);
|
|
262
|
+
// Read directly and handle ENOENT here rather than an existsSync precheck — the
|
|
263
|
+
// check→read/write pair is a TOCTOU race CodeQL flags (js/file-system-race).
|
|
264
|
+
let html;
|
|
265
|
+
try {
|
|
266
|
+
html = readFileSync(compAbs, "utf8");
|
|
267
|
+
} catch {
|
|
268
|
+
if (built)
|
|
269
|
+
die(`${label} is ${f.status} but its src ${f.src} is not on disk — re-dispatch the worker`);
|
|
270
|
+
anomalies.push(`${label}: src ${f.src} not on disk (status ${f.status}) — skipped`);
|
|
271
|
+
continue;
|
|
272
|
+
}
|
|
273
|
+
if (!Number.isFinite(f.durationSeconds) || f.durationSeconds <= 0) {
|
|
274
|
+
die(
|
|
275
|
+
`${label}: no positive duration (got ${JSON.stringify(f.duration)}) — run audio sync-durations`,
|
|
276
|
+
);
|
|
277
|
+
}
|
|
278
|
+
// Host data-composition-id MUST equal the inner file's, or the runtime never
|
|
279
|
+
// finds the timeline. frame_id = src basename (frame-worker contract); verify
|
|
280
|
+
// the inner html actually declares it.
|
|
281
|
+
const compId = basename(f.src).replace(/\.html?$/i, "");
|
|
282
|
+
// Guard against blank/partial scene files: a worker that errors or is
|
|
283
|
+
// interrupted mid-write leaves an empty (or markup-less) file that exists but
|
|
284
|
+
// fails at render with "Composition HTML is empty or could not be parsed".
|
|
285
|
+
// Catch it here — before emitting data-composition-src — and re-dispatch.
|
|
286
|
+
if (!html.trim() || !/<\w/.test(html)) {
|
|
287
|
+
die(
|
|
288
|
+
`${label}: ${f.src} is empty or has no HTML — the worker wrote a blank/partial file. Re-dispatch that worker before assembling.`,
|
|
289
|
+
);
|
|
290
|
+
}
|
|
291
|
+
try {
|
|
292
|
+
validateFrameHtml(html, { expectedId: compId, expectedDuration: f.durationSeconds });
|
|
293
|
+
} catch (error) {
|
|
294
|
+
die(`${label}: ${error.message}`);
|
|
295
|
+
}
|
|
296
|
+
// pre-assembly guards: ① repair missing root dims in place, ② collects fatal violations.
|
|
297
|
+
const guard = guardFrame(html, label);
|
|
298
|
+
if (guard.repairedHtml) {
|
|
299
|
+
writeFileSync(compAbs, guard.repairedHtml);
|
|
300
|
+
html = guard.repairedHtml;
|
|
301
|
+
repairs.push(guard.repairNote);
|
|
302
|
+
}
|
|
303
|
+
for (const e of guard.errors) frameErrors.push(e);
|
|
304
|
+
if (
|
|
305
|
+
!html.includes(`data-composition-id="${compId}"`) &&
|
|
306
|
+
!html.includes(`data-composition-id='${compId}'`)
|
|
307
|
+
) {
|
|
308
|
+
die(`${label}: ${f.src} has no data-composition-id="${compId}" (host/inner id must match)`);
|
|
309
|
+
}
|
|
310
|
+
mounted.push({ frame: f, compId, durationSeconds: r3(f.durationSeconds) });
|
|
311
|
+
}
|
|
312
|
+
if (frameErrors.length) {
|
|
313
|
+
die(
|
|
314
|
+
`${frameErrors.length} frame composition violation(s) — fix the worker output and re-assemble:\n` +
|
|
315
|
+
frameErrors.map((e) => ` • ${e}`).join("\n"),
|
|
316
|
+
);
|
|
317
|
+
}
|
|
318
|
+
if (mounted.length === 0) die("no mountable frames (none built with an on-disk src)");
|
|
319
|
+
|
|
320
|
+
// cumulative starts — emitted data-start[i] + data-duration[i] == start[i+1] by
|
|
321
|
+
// construction (renderer computes end the same way), so adjacent clips touch
|
|
322
|
+
// exactly with no float-overlap.
|
|
323
|
+
let acc = 0;
|
|
324
|
+
for (const m of mounted) {
|
|
325
|
+
m.start = acc;
|
|
326
|
+
acc += m.durationSeconds;
|
|
327
|
+
}
|
|
328
|
+
const TOTAL = r3(acc);
|
|
329
|
+
|
|
330
|
+
// ---------- duration expectation (advisory) ----------
|
|
331
|
+
// Frontmatter `duration:` carries the brief's rough length expectation
|
|
332
|
+
// (storyboard-format.md § Frontmatter). Never blocks the build: report where
|
|
333
|
+
// the cut lands, and flag a large gap so the agent judges whether the drift
|
|
334
|
+
// serves the piece.
|
|
335
|
+
let durationNote = "";
|
|
336
|
+
const rawTarget = manifest.globals.extra?.duration;
|
|
337
|
+
if (rawTarget != null && String(rawTarget).trim() !== "") {
|
|
338
|
+
const targetMatch = String(rawTarget).match(/(\d+(?:\.\d+)?)/);
|
|
339
|
+
const target = targetMatch ? parseFloat(targetMatch[1]) : NaN;
|
|
340
|
+
if (!Number.isFinite(target) || target <= 0) {
|
|
341
|
+
anomalies.push(
|
|
342
|
+
`frontmatter duration "${rawTarget}" is not parseable (e.g. "22s") — skipped the expectation check`,
|
|
343
|
+
);
|
|
344
|
+
} else {
|
|
345
|
+
const diff = r3(TOTAL - target);
|
|
346
|
+
durationNote = ` (expected ~${target}s, ${diff >= 0 ? "+" : ""}${diff}s)`;
|
|
347
|
+
const pct = Math.abs((diff / target) * 100);
|
|
348
|
+
if (pct > 10) {
|
|
349
|
+
anomalies.push(
|
|
350
|
+
`total ${TOTAL}s lands ${Math.round(pct)}% ${diff > 0 ? "over" : "under"} the brief's ~${target}s expectation — ` +
|
|
351
|
+
`judge whether the drift serves the piece (pacing, narration fit); re-pace, or update \`duration:\` if the new length is intended`,
|
|
352
|
+
);
|
|
353
|
+
}
|
|
354
|
+
}
|
|
355
|
+
}
|
|
356
|
+
const startOfFrameNumber = new Map();
|
|
357
|
+
for (const m of mounted) if (m.frame.number != null) startOfFrameNumber.set(m.frame.number, m);
|
|
358
|
+
|
|
359
|
+
// ---------- audio_meta (optional) ----------
|
|
360
|
+
let audio = { bgm: null, voices: [], sfx: [] };
|
|
361
|
+
if (existsSync(audioMetaPath)) {
|
|
362
|
+
try {
|
|
363
|
+
const parsed = JSON.parse(readFileSync(audioMetaPath, "utf8"));
|
|
364
|
+
// bgm_pending rides along: without it this step cannot tell a detached generate that has
|
|
365
|
+
// not landed yet from a film that is silent by design, and it would build the silent one.
|
|
366
|
+
audio = {
|
|
367
|
+
bgm: parsed.bgm ?? null,
|
|
368
|
+
bgm_pending: !!parsed.bgm_pending,
|
|
369
|
+
voices: parsed.voices ?? [],
|
|
370
|
+
sfx: parsed.sfx ?? [],
|
|
371
|
+
};
|
|
372
|
+
} catch (e) {
|
|
373
|
+
die(`audio_meta.json parse: ${e.message}`);
|
|
374
|
+
}
|
|
375
|
+
}
|
|
376
|
+
const voiceByFrame = new Map();
|
|
377
|
+
for (const v of audio.voices) if (v.frame != null) voiceByFrame.set(v.frame, v);
|
|
378
|
+
|
|
379
|
+
// ---------- build <body> in track order ----------
|
|
380
|
+
const body = [];
|
|
381
|
+
let voiceCount = 0;
|
|
382
|
+
|
|
383
|
+
for (const m of mounted) {
|
|
384
|
+
// (track 1) frame sub-comp clip — no class="clip" semantics needed; .scene CSS sizes it.
|
|
385
|
+
body.push(
|
|
386
|
+
` <div`,
|
|
387
|
+
` id="el-${m.compId}"`,
|
|
388
|
+
` class="scene"`,
|
|
389
|
+
` data-composition-id="${m.compId}"`,
|
|
390
|
+
` data-composition-src="${m.frame.src}"`,
|
|
391
|
+
` data-start="${m.start}"`,
|
|
392
|
+
` data-duration="${m.durationSeconds}"`,
|
|
393
|
+
` data-track-index="1"`,
|
|
394
|
+
` ></div>`,
|
|
395
|
+
);
|
|
396
|
+
// (track 10) voice — only when the file is actually on disk.
|
|
397
|
+
const v = m.frame.number != null ? voiceByFrame.get(m.frame.number) : undefined;
|
|
398
|
+
if (v?.path) {
|
|
399
|
+
if (existsSync(join(hyperframesDir, v.path))) {
|
|
400
|
+
body.push(
|
|
401
|
+
` <audio`,
|
|
402
|
+
` id="el-${m.compId}-voice"`,
|
|
403
|
+
` src="${v.path}"`,
|
|
404
|
+
` data-start="${m.start}"`,
|
|
405
|
+
` data-duration="${m.durationSeconds}"`,
|
|
406
|
+
` data-track-index="10"`,
|
|
407
|
+
` data-volume="1"`,
|
|
408
|
+
` ></audio>`,
|
|
409
|
+
);
|
|
410
|
+
voiceCount++;
|
|
411
|
+
} else {
|
|
412
|
+
anomalies.push(`${m.compId}: voice ${v.path} not on disk — skipped`);
|
|
413
|
+
}
|
|
414
|
+
}
|
|
415
|
+
body.push("");
|
|
416
|
+
}
|
|
417
|
+
|
|
418
|
+
// (track 11) BGM — duck under narration when any voice is present. Loop-extend a short
|
|
419
|
+
// track to the full video length so the tail isn't silent (libraries return ~15–30s clips).
|
|
420
|
+
let bgmEmitted = false;
|
|
421
|
+
let bgmNote = "";
|
|
422
|
+
if (audio.bgm?.path) {
|
|
423
|
+
if (existsSync(join(hyperframesDir, audio.bgm.path))) {
|
|
424
|
+
let bgmSrc = audio.bgm.path;
|
|
425
|
+
const cov = ensureBgmCovers(audio.bgm.path, hyperframesDir, TOTAL);
|
|
426
|
+
if (cov.looped) {
|
|
427
|
+
bgmSrc = cov.rel;
|
|
428
|
+
bgmNote = ` (looped ${cov.from.toFixed(1)}s→${TOTAL}s)`;
|
|
429
|
+
} else if (cov.short) {
|
|
430
|
+
anomalies.push(
|
|
431
|
+
`bgm is ${cov.dur?.toFixed?.(1) ?? "?"}s (< ${TOTAL}s) and could not be extended (${cov.reason}) — the tail will be silent; install ffmpeg`,
|
|
432
|
+
);
|
|
433
|
+
}
|
|
434
|
+
// An explicit volume from audio_meta always wins; otherwise the shared
|
|
435
|
+
// media-use default (bed ~ -18 dB under narration, forward for a silent film).
|
|
436
|
+
const vol = audio.bgm.volume != null ? audio.bgm.volume : bgmDefaultVolume(voiceCount > 0);
|
|
437
|
+
body.push(
|
|
438
|
+
` <!-- BGM -->`,
|
|
439
|
+
` <audio`,
|
|
440
|
+
` id="el-bgm"`,
|
|
441
|
+
` src="${bgmSrc}"`,
|
|
442
|
+
` data-start="0"`,
|
|
443
|
+
` data-duration="${TOTAL}"`,
|
|
444
|
+
` data-track-index="11"`,
|
|
445
|
+
` data-volume="${vol}"`,
|
|
446
|
+
` ></audio>`,
|
|
447
|
+
"",
|
|
448
|
+
);
|
|
449
|
+
bgmEmitted = true;
|
|
450
|
+
} else {
|
|
451
|
+
anomalies.push(`bgm ${audio.bgm.path} not on disk — skipped`);
|
|
452
|
+
}
|
|
453
|
+
} else if (audio.bgm_pending) {
|
|
454
|
+
// The distinction the flag exists to make. A warning is not enough: assemble is re-run on
|
|
455
|
+
// rework long after the audio step's own warning scrolled past, and it would happily build a
|
|
456
|
+
// silent film from a snapshot whose JSON says the bed is still generating.
|
|
457
|
+
if (!allowPendingBgm) {
|
|
458
|
+
die(
|
|
459
|
+
"audio_meta.json says bgm_pending — the music bed is still generating and is NOT in this " +
|
|
460
|
+
"assembly. Wait for the track, re-run the audio step, then assemble again. To assemble a " +
|
|
461
|
+
"deliberately silent preview anyway, pass --allow-pending-bgm.",
|
|
462
|
+
);
|
|
463
|
+
}
|
|
464
|
+
anomalies.push(
|
|
465
|
+
"bgm still generating (bgm_pending) — assembled without a bed per --allow-pending-bgm",
|
|
466
|
+
);
|
|
467
|
+
}
|
|
468
|
+
|
|
469
|
+
// (track 2) captions — captions.mjs writes this or legally skips; key off existence.
|
|
470
|
+
let captionsEmitted = false;
|
|
471
|
+
if (existsSync(join(hyperframesDir, "compositions/captions.html"))) {
|
|
472
|
+
body.push(
|
|
473
|
+
` <!-- captions -->`,
|
|
474
|
+
` <div`,
|
|
475
|
+
` id="el-captions"`,
|
|
476
|
+
` class="scene"`,
|
|
477
|
+
` data-composition-id="captions"`,
|
|
478
|
+
` data-composition-src="compositions/captions.html"`,
|
|
479
|
+
` data-start="0"`,
|
|
480
|
+
` data-duration="${TOTAL}"`,
|
|
481
|
+
` data-track-index="2"`,
|
|
482
|
+
` ></div>`,
|
|
483
|
+
"",
|
|
484
|
+
);
|
|
485
|
+
captionsEmitted = true;
|
|
486
|
+
}
|
|
487
|
+
|
|
488
|
+
// (track 20+i) SFX — placed at its frame's start + offset.
|
|
489
|
+
let sfxEmitted = 0;
|
|
490
|
+
audio.sfx.forEach((cue, i) => {
|
|
491
|
+
const host = cue.frame != null ? startOfFrameNumber.get(cue.frame) : undefined;
|
|
492
|
+
if (!host) {
|
|
493
|
+
anomalies.push(`sfx ${cue.file}: frame ${cue.frame} not mounted — skipped`);
|
|
494
|
+
return;
|
|
495
|
+
}
|
|
496
|
+
const rel = cue.file;
|
|
497
|
+
if (!existsSync(join(hyperframesDir, rel))) {
|
|
498
|
+
anomalies.push(`sfx ${rel} not on disk — skipped`);
|
|
499
|
+
return;
|
|
500
|
+
}
|
|
501
|
+
const t = r3(host.start + (cue.offset_s ?? 0));
|
|
502
|
+
const dur = r3(cue.duration_s ?? 1);
|
|
503
|
+
const vol = cue.volume != null ? cue.volume : 0.35;
|
|
504
|
+
if (sfxEmitted === 0) body.push(` <!-- SFX -->`);
|
|
505
|
+
body.push(
|
|
506
|
+
` <audio`,
|
|
507
|
+
` id="el-sfx-${i}"`,
|
|
508
|
+
` src="${rel}"`,
|
|
509
|
+
` data-start="${t}"`,
|
|
510
|
+
` data-duration="${dur}"`,
|
|
511
|
+
` data-track-index="${20 + i}"`,
|
|
512
|
+
` data-volume="${vol}"`,
|
|
513
|
+
` ></audio>`,
|
|
514
|
+
);
|
|
515
|
+
sfxEmitted++;
|
|
516
|
+
});
|
|
517
|
+
|
|
518
|
+
// ---------- stage frame-named assets: capture/ → assets/ (idempotent backstop) ----------
|
|
519
|
+
// Frame workers + the live preview reference assets/<basename>; stage-assets.mjs
|
|
520
|
+
// already ran this at Step 4 close. Re-run as a backstop so a late-named asset
|
|
521
|
+
// still lands. Shared logic: lib/assets.mjs (first-wins, safe to call twice).
|
|
522
|
+
const {
|
|
523
|
+
staged,
|
|
524
|
+
wanted,
|
|
525
|
+
anomalies: assetAnomalies,
|
|
526
|
+
} = stageAssets({
|
|
527
|
+
hyperframesDir,
|
|
528
|
+
frames: manifest.frames,
|
|
529
|
+
});
|
|
530
|
+
for (const a of assetAnomalies) anomalies.push(a);
|
|
531
|
+
|
|
532
|
+
// ---------- <head> ----------
|
|
533
|
+
// ---------- ground color ----------
|
|
534
|
+
// Per-frame roots carry data-start/data-duration and get clip-gated against the
|
|
535
|
+
// global timeline in render (only the first frame's [0,dur] window overlaps global
|
|
536
|
+
// 0), so a frame's own full-bleed background can't be relied on as the video ground —
|
|
537
|
+
// every frame after the first would render on the bare body color (black). Paint the
|
|
538
|
+
// ground on the always-present root composition instead, using the project's frame.md
|
|
539
|
+
// canvas color (the same ground role the caption skin maps to --cap-canvas). Falls
|
|
540
|
+
// back to the body letterbox color when frame.md is absent or has no resolvable ground.
|
|
541
|
+
const framePath = join(hyperframesDir, "frame.md");
|
|
542
|
+
let groundColor = null;
|
|
543
|
+
if (existsSync(framePath)) {
|
|
544
|
+
try {
|
|
545
|
+
const roles = semanticColors(parseColors(readFileSync(framePath, "utf8")));
|
|
546
|
+
if (roles && roles.canvas) groundColor = roles.canvas;
|
|
547
|
+
} catch {
|
|
548
|
+
/* leave groundColor null — #root stays transparent over the body letterbox */
|
|
549
|
+
}
|
|
550
|
+
}
|
|
551
|
+
|
|
552
|
+
const headStyle = [
|
|
553
|
+
" * {",
|
|
554
|
+
" margin: 0;",
|
|
555
|
+
" padding: 0;",
|
|
556
|
+
" box-sizing: border-box;",
|
|
557
|
+
" }",
|
|
558
|
+
" html,",
|
|
559
|
+
" body {",
|
|
560
|
+
` width: ${WIDTH}px;`,
|
|
561
|
+
` height: ${HEIGHT}px;`,
|
|
562
|
+
" overflow: hidden;",
|
|
563
|
+
" background: #000;",
|
|
564
|
+
" }",
|
|
565
|
+
" #root {",
|
|
566
|
+
" position: relative;",
|
|
567
|
+
` width: ${WIDTH}px;`,
|
|
568
|
+
` height: ${HEIGHT}px;`,
|
|
569
|
+
" overflow: hidden;",
|
|
570
|
+
...(groundColor ? [` background: ${groundColor};`] : []),
|
|
571
|
+
" }",
|
|
572
|
+
" .scene {",
|
|
573
|
+
" position: absolute;",
|
|
574
|
+
" inset: 0;",
|
|
575
|
+
" width: 100%;",
|
|
576
|
+
" height: 100%;",
|
|
577
|
+
" }",
|
|
578
|
+
].join("\n");
|
|
579
|
+
|
|
580
|
+
const html = `<!doctype html>
|
|
581
|
+
<html lang="en">
|
|
582
|
+
<head>
|
|
583
|
+
<meta charset="UTF-8" />
|
|
584
|
+
<meta name="viewport" content="width=${WIDTH}, height=${HEIGHT}" />
|
|
585
|
+
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js" integrity="sha384-sG0Hv1tP1lZCk9KQmrIbY/XNwi+OY84GQqhMscbnsoBFqAz8KNCil1kvfL3Hbbk2" crossorigin="anonymous"></script>
|
|
586
|
+
<style>
|
|
587
|
+
${headStyle}
|
|
588
|
+
</style>
|
|
589
|
+
</head>
|
|
590
|
+
<body>
|
|
591
|
+
<div
|
|
592
|
+
id="root"
|
|
593
|
+
data-composition-id="main"
|
|
594
|
+
data-start="0"
|
|
595
|
+
data-duration="${TOTAL}"
|
|
596
|
+
data-width="${WIDTH}"
|
|
597
|
+
data-height="${HEIGHT}"
|
|
598
|
+
>
|
|
599
|
+
${body.join("\n")}
|
|
600
|
+
</div>
|
|
601
|
+
|
|
602
|
+
<script>
|
|
603
|
+
window.__timelines = window.__timelines || {};
|
|
604
|
+
window.__timelines["main"] = gsap.timeline({ paused: true });
|
|
605
|
+
</script>
|
|
606
|
+
</body>
|
|
607
|
+
</html>
|
|
608
|
+
`;
|
|
609
|
+
|
|
610
|
+
writeFileSync(outPath, html);
|
|
611
|
+
|
|
612
|
+
// ---------- summary ----------
|
|
613
|
+
console.log(`✓ wrote ${outPath}`);
|
|
614
|
+
console.log(` canvas: ${WIDTH}×${HEIGHT}`);
|
|
615
|
+
console.log(` frames (track 1): ${mounted.length}`);
|
|
616
|
+
console.log(` voice (track 10): ${voiceCount}`);
|
|
617
|
+
console.log(` bgm (track 11): ${bgmEmitted ? "yes" + bgmNote : "no"}`);
|
|
618
|
+
console.log(` captions (track 2): ${captionsEmitted ? "yes" : "no"}`);
|
|
619
|
+
console.log(` sfx (track 20+): ${sfxEmitted}`);
|
|
620
|
+
console.log(` assets staged: ${staged}/${wanted.size}`);
|
|
621
|
+
console.log(` total duration: ${TOTAL}s${durationNote}`);
|
|
622
|
+
if (repairs.length) {
|
|
623
|
+
console.log(`\nrepaired (frame files updated in place):`);
|
|
624
|
+
for (const rp of repairs) console.log(` - ${rp}`);
|
|
625
|
+
}
|
|
626
|
+
if (anomalies.length) {
|
|
627
|
+
console.log(`\nanomalies (non-fatal):`);
|
|
628
|
+
for (const a of anomalies) console.log(` - ${a}`);
|
|
629
|
+
}
|