hyperframes 0.8.189 → 0.8.191

package/dist/{sites-5PWHAMEG.js → sites-Q2S3DZY4.js}

@@ -28,7 +28,8 @@ async function runSitesCreate(args) {
     projectDir,
     bucketName: stack.bucketName,
     region: stack.region,
-    siteId: args.siteId
+    siteId: args.siteId,
+    onNotice: (message) => console.error(c.dim(message))
   });
   if (args.json) {
     console.log(JSON.stringify(handle, null, 2));

package/dist/skills/hyperframes/references/captions.md

@@ -3,7 +3,7 @@
 ## Words and timings
 
 - `npx hyperframes transcribe <file> --json` and a HeyGen voiceover (`/media-use`) give every word's start and end. Work from those as `[{ "id": "w0", "text": "Hello", "start": 0.0, "end": 0.5 }, …]`.
-- Local transcription defaults to `small.en`, which **translates** non-English speech into English. Pass the model: `npx hyperframes transcribe <file> --model small.en` for English, `--model small --language <code>` otherwise, `--model medium.en` for speech over music. It writes `assets/transcript.json` (its JSON names the path) and overwrites it on the next run; `--to srt` or `--to vtt` writes a sidecar.
+- `npx hyperframes transcribe` defaults to the `small.en` whisper model, which **translates** non-English speech into English. Pass the model: `npx hyperframes transcribe <file> --model small.en` for English, `--model small --language <code>` otherwise, `--model medium.en` for speech over music. It writes `assets/transcript.json` (its JSON names the path) and overwrites it on the next run; `--to srt` or `--to vtt` writes a sidecar.
 - For Chinese, Japanese and other unspaced scripts, local transcription returns a whole sentence as one "word", sometimes in the other script (Traditional for Simplified speech). Split each segment's text into short phrases and spread its time across them by character count; check the characters against what is said.
 - Whisper invents "Thank you." over silence and repeats lines over a silent tail: drop words that start inside a final silence (`silencedetect=noise=-35dB:d=0.6`; real speech sits around −16 to −26 dB).
 - Never put two words in one timed entry, and match transcript words to caption words by position, not text, or a repeated word takes the wrong time.

package/dist/skills/hyperframes/references/motion.md

@@ -5,7 +5,7 @@
 Measured frame by frame from the official HyperFrames launch films. These are defaults: a reference the person gave, or a Moment that does otherwise on purpose, wins for its own beat.
 
 - **Moves**: a fast move takes 0.3–0.6 s and carries motion blur on its own ease, peaking at its fastest frame: 6–12 px on text-sized elements, 15–20 px full-frame, horizontal-only on a horizontal move. One move is one tween.
-- **Render-time blur**: for fast 2D movers, `data-motion-blur="on"` on the composition root smears them along their real path in preview and render (opt-in; also `data-motion-blur-shutter`, `-samples`, `-events="on"` for callback-driven motion). Suggest it when the person asks for blur or a filmic look and the piece moves fast; skip it when the composition has a WebGL canvas, a 3D flip with `backface-visibility`, a root transform or opacity, or an HDR render, because blur turns itself off there. After adding it run `hyperframes check`: `motion_blur_off` names the cause. About 1.7x render time. Guide: /guides/motion-blur.
+- **Render-time blur**: for fast 2D movers, `data-motion-blur="on"` on the composition root smears them along their real path in preview and render (opt-in; also `data-motion-blur-shutter` for a longer smear, 360 is strong; `-events="on"` when the motion is set from a timeline callback such as a `render(t)` function). Suggest it when the person asks for blur or a filmic look and the piece moves fast. It picks how to draw on its own: a cheap per-element filter for translation, the truer capture for spins and zooms; it works over WebGL and in any Chrome, and is off only for HDR and distributed renders. Opt a subtree out with `data-motion-blur="off"`, e.g. a seam that already carries its own blur. After adding it run `hyperframes check`. Guide: /guides/motion-blur.
 - **Arrive slow, leave clean**: long-tailed ease-outs on arrivals; landing takes longer than leaving. An exit is one smooth motion, never slide, stop, then leave. Entrances that are too snappy read as glitches; slowing the whole video by about a second often fixes it.
 - **Ease by role**: an arrival lands on a long tail (`expo.out`, `power4.out`), a camera move or a colour flood eases both ways (`power2.inOut`), a zoom through or an exit accelerates (`power3.in`). The same `power2.out` at 0.5 s on everything is the flat default that makes a film feel generated. Linear only for rotation, progress and constant speed that is the point.
 - **Springs** are named by damping ratio: 1.0 never bounces, 0.7-0.85 reads premium, 0.4-0.6 playful, under 0.3 a cartoon. Position and size may bounce; opacity and colour never do. GSAP's `elastic.out(1, 0.5)` and `back.out(1.4)` are the nearest built-ins; a closed-form spring of `t` keeps any frame renderable on its own.

package/dist/skills/hyperframes-cli/references/cloudrun.md

@@ -22,7 +22,7 @@ npx hyperframes cloudrun destroy --project <gcp-project>
 
 `sites create` uploads a content-addressed project archive for reuse by `render-batch`; pass its `--site-id` to that command to skip the batch upload. Single `cloudrun render` currently resolves the project from its directory and does not consume `--site-id`. Both render commands require `--width` and `--height`; supported output formats are `mp4`, `mov`, `png-sequence`, and `webm`. Use `--output-resolution 4k` to supersample an authored composition without changing its layout dimensions.
 
-Common render flags are `--fps 24|30|60`, `--quality draft|standard|high`, `--codec h264|h265` for MP4, `--chunk-size`, `--max-parallel-chunks`, `--target-chunk-frames`, `--render-id`, `--output-key`, `--wait`, and `--wait-interval-ms`. Use `--json` for machine-readable output.
+Common render flags are `--fps 24|25|30|60`, `--quality draft|standard|high`, `--codec h264|h265` for MP4, `--chunk-size`, `--max-parallel-chunks`, `--target-chunk-frames`, `--render-id`, `--output-key`, `--wait`, and `--wait-interval-ms`. Use `--json` for machine-readable output.
 
 For a variable-driven single render:
 

package/dist/skills/hyperframes-cli/references/lambda.md

@@ -84,7 +84,7 @@ Starts a Step Functions execution. Returns immediately with a `renderId` unless
 | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `--width` / `--height`  | Output dimensions in pixels                                                                                                                                                                                                                                                                                                                                   |
 | `--output-resolution`   | Supersampling preset (engages Chrome `deviceScaleFactor`) — `landscape` / `landscape-4k` / `portrait` / `portrait-4k` / `square` / `square-4k`, plus aliases (`1080p`, `4k`, `uhd`, `hd`, `1080p-portrait`, `4k-portrait`, `1080p-square`, `4k-square`). Use this to render an authored-at-1080p composition at 4K without re-laying-out — see footgun below. |
-| `--fps`                 | `24` / `30` / `60`                                                                                                                                                                                                                                                                                                                                            |
+| `--fps`                 | `24` / `25` / `30` / `60`                                                                                                                                                                                                                                                                                                                                     |
 | `--format`              | `mp4` / `mov` / `png-sequence` / `webm` (default `mp4`)                                                                                                                                                                                                                                                                                                       |
 | `--codec`               | `h264` / `h265` (mp4 only)                                                                                                                                                                                                                                                                                                                                    |
 | `--quality`             | `draft` / `standard` / `high`                                                                                                                                                                                                                                                                                                                                 |

package/dist/skills/hyperframes-cli/references/lint-validate-inspect.md

@@ -111,7 +111,7 @@ Drop a `*.motion.json` sidecar next to the composition (matching the html basena
 npx hyperframes snapshot                       # 5 key frames as PNG
 npx hyperframes snapshot ./my-project          # specific project
 npx hyperframes snapshot --frames 10           # evenly-spaced N frames
-npx hyperframes snapshot --range 3:5 --frames 8 # 8 frames within root-timeline seconds 3–5
+npx hyperframes snapshot --range 3,5 --frames 8 # 8 frames within root-timeline seconds 3–5
 npx hyperframes snapshot --composition intro --frames 8 # 8 frames within this data-composition-id
 npx hyperframes snapshot --review              # beat sheet, seam strips, phone sheet
 npx hyperframes snapshot --review --json       # same, with paths and times as JSON
@@ -119,7 +119,7 @@ npx hyperframes snapshot --review --json       # same, with paths and times as J
 
 Still PNGs. Each run writes `.hyperframes/artifacts/snapshots/<id>/` unless `--output` is set. `snapshot` is the standalone capture; `check --snapshots` is the gate.
 
-One of `--at`, `--range START:END` (seconds), or `--composition <data-composition-id>` (not a CSS selector). `--frames` defaults to 5. Range and composition sample just before the end and add no extra end frame; `--at` adds one unless `--no-end`.
+One of `--at`, `--range START,END` (seconds), or `--composition <data-composition-id>` (not a CSS selector). `--frames` defaults to 5. Range and composition sample just before the end and add no extra end frame; `--at` adds one unless `--no-end`.
 
 `--review` picks the frames that show a film over time. Scenes are the composition's top-level timed clips and sub-composition hosts, as `timeline` lists them (captions and audio excluded); `--composition` scopes to one. It writes `review-beats.jpg` (each scene at its start + 0.3 s and at its middle, and each timed `data-beat="name"` element at its start + 0.3 s, labelled with time and id), `review-seam-NN.jpg` (frames at −0.2, −0.1, 0, +0.1, +0.2 s around every cut) and `review-phone.jpg` (the beat frames 360 px wide, to judge legibility at phone size), beside the `beat-*.png` and `seam-*.png` stills. With fewer than two scenes the beats spread evenly. `--json` prints `{ok, outputDir, frames[{path,time,role,label}], contactSheets, review{window, scenes, beats, seams[{time,from,to,times,paths,sheet}], sheets, notes}}`.
 

package/dist/skills/hyperframes-cli/references/preview-render.md

@@ -120,7 +120,7 @@ npx hyperframes render --docker                       # byte-identical
 | `dir` (positional)                   | path                                                                                               | cwd                            | Project directory. Omit to use current working directory.                                                                                                                                                                                                                                                                                                                                                                                     |
 | `--composition`, `-c`                | path to composition file                                                                           | `index.html`                   | Render a specific composition file (e.g. `compositions/intro.html`) instead of the project's `index.html`.                                                                                                                                                                                                                                                                                                                                    |
 | `--output`, `-o`                     | path                                                                                               | `renders/<project>_<ts>.<ext>` | Output path. Default is timestamped (`<project-name>_YYYY-MM-DD_HH-MM-SS.<ext>`).                                                                                                                                                                                                                                                                                                                                                             |
-| `--fps`                              | 24, 30, 60                                                                                         | 30                             | 60fps doubles render time                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `--fps`                              | 1–240, or a rational such as `30000/1001`                                                          | root `data-fps`, else 30       | 60fps doubles render time. `lambda` and `cloudrun` accept only 24, 25, 30, 60                                                                                                                                                                                                                                                                                                                                                                 |
 | `--quality`                          | draft, looks, delivery, standard, high                                                             | looks                          | `looks` is CRF 16 on the standard preset. `delivery` is `high`. draft for iterating                                                                                                                                                                                                                                                                                                                                                           |
 | `--format`                           | mp4, webm, mov, gif, png-sequence, hls                                                             | mp4                            | WebM/MOV render with transparency; gif for inline autoplay in GitHub PRs/READMEs/docs (two-pass palette encode, fps capped at 30 — prefer `--fps 15` — no audio, 1-bit transparency only, HDR falls back to SDR); png-sequence writes RGBA frames to a directory (AE/Nuke/Fusion ingest); hls writes an HLS VOD directory (master.m3u8 + video/audio playlists + MPEG-TS segments), SDR only, rejects `--gpu`, unavailable on lambda/cloudrun |
 | `--gif-loop`                         | 0-65535                                                                                            | 0                              | GIF loop count; `0` loops forever. Only with `--format gif`.                                                                                                                                                                                                                                                                                                                                                                                  |

package/dist/skills/hyperframes-cli/references/upgrade-info-misc.md

@@ -132,11 +132,3 @@ Run `npx hyperframes usage --json` at the start of a video workflow and again at
 Known results contain `status: "known"`, `harness`, `planTier`, `session`, `weekly`, and `spend`. Each available window contains `usedPercent`, `remainingPercent`, and `resetsAt`; an unavailable window is `null`. `planTier` is the readable subscription tier when available, otherwise `null`. Claude Code reports its shared five-hour and weekly windows; a spend-metered plan (such as Enterprise) has neither and reports `spend`, the share of its billing-period spend limit already used, with `resetsAt: null`. Codex reports its shared session and weekly windows when available. Grok reports its included weekly allowance with `session: null`. Only Claude Code reports `spend`; it is `null` elsewhere. When no window is available the result is `status: "unknown"` with `reason: "no_usage_windows"`.
 
 Unknown results contain `status: "unknown"` and a token-free `reason`. Missing, expired, unsupported, ambiguous, or unreadable logins and unavailable provider responses return unknown. Report the unknown state without guessing allowance. The command reads existing credentials without refreshing or rewriting them and emits no tokens or telemetry. Usage is a snapshot; it does not reserve allowance or estimate the next video's cost. Keep scope and workflow choices with the user.
-
-## Remaining harness usage
-
-Run `npx hyperframes usage --json` at the start of a video workflow and again at milestones such as after drafting and before rendering. A fresh read at handoff can serve as the start read. Use `--harness claude-code`, `--harness codex`, or `--harness grok` to select explicitly.
-
-Known results contain `status: "known"`, `harness`, `planTier`, `session`, `weekly`, and `spend`. Each available window contains `usedPercent`, `remainingPercent`, and `resetsAt`; an unavailable window is `null`. `planTier` is the readable subscription tier when available, otherwise `null`. Claude Code reports its shared five-hour and weekly windows; a spend-metered plan (such as Enterprise) has neither and reports `spend`, the share of its billing-period spend limit already used, with `resetsAt: null`. Codex reports its shared session and weekly windows when available. Grok reports its included weekly allowance with `session: null`. Only Claude Code reports `spend`; it is `null` elsewhere. When no window is available the result is `status: "unknown"` with `reason: "no_usage_windows"`.
-
-Unknown results contain `status: "unknown"` and a token-free `reason`. Missing, expired, unsupported, ambiguous, or unreadable logins and unavailable provider responses return unknown. Report the unknown state without guessing allowance. The command reads existing credentials without refreshing or rewriting them and emits no tokens or telemetry. Usage is a snapshot; it does not reserve allowance or estimate the next video's cost. Keep scope and workflow choices with the user.

package/dist/skills/media-use/audio/references/transcribe.md

@@ -1,6 +1,6 @@
 # Transcription
 
-Create normalized word-level timestamps. **Always specify `--model` explicitly** — the CLI default is `small.en`, which silently translates non-English audio into English.
+Create normalized word-level timestamps. **Always specify `--model` explicitly** — `npx hyperframes transcribe` uses `small.en` as its default whisper model, which silently translates non-English audio into English.
 
 ```bash
 npx hyperframes transcribe audio.mp3  --model small.en             # known English
@@ -19,7 +19,7 @@ npx hyperframes transcribe openai-response.json
 2. **Known non-English** → `--model small --language <iso-code>` (no `.en` suffix)
 3. **Unknown language** → `--model small` (whisper auto-detects)
 
-**CLI default is `small.en`** — do not rely on it; always pass `--model` to make the choice explicit. `--language` also filters out non-target-language segments from mixed-language audio.
+**The CLI's default whisper model is `small.en`** — do not rely on it; always pass `--model` to make the choice explicit. `--language` also filters out non-target-language segments from mixed-language audio.
 
 ## Model Sizes
 

package/dist/skills/media-use/references/audio.md

@@ -17,4 +17,4 @@ node <SKILL_DIR>/audio/scripts/audio.mjs --request ./audio_request.json --out ./
 
 Single-shot helpers: `audio/scripts/heygen-tts.mjs` (one voice file). Transcription / background removal / captions use the `hyperframes` CLI (`transcribe`, `remove-background`), see the per-topic guides in `audio/references/` (`tts.md`, `bgm.md`, `sfx.md`, `transcribe.md`, `remove-background.md`, `captions/`).
 
-Transcription defaults to Parakeet (better than whisper.cpp: 6.05% vs 7.44% WER, 5-10x faster) via `scripts/transcribe.mjs`, with whisper.cpp auto-fallback (see `references/operations.md`).
+Transcription through `scripts/transcribe.mjs` defaults to Parakeet (better than whisper.cpp: 6.05% vs 7.44% WER, 5-10x faster), with whisper.cpp auto-fallback (see `references/operations.md`). `npx hyperframes transcribe` picks its own engine: Parakeet when installed, otherwise whisper with the `small.en` model by default.

package/dist/{skills-EVIDL7PV.js → skills-EYLB2V6F.js}

@@ -15,8 +15,8 @@ import {
 } from "./chunk-WMQNIQDJ.js";
 import {
   trackSkillsInstallSkipped
-} from "./chunk-IPEP346Y.js";
-import "./chunk-T37XXYRK.js";
+} from "./chunk-TFGO5YMI.js";
+import "./chunk-W3CS2KFV.js";
 import {
   diag
 } from "./chunk-VWG7OQKU.js";
@@ -47,15 +47,15 @@ import {
   presentSkills,
   pruneOrphanedLockEntries,
   retiredSkillNotice
-} from "./chunk-R5FS7GFU.js";
+} from "./chunk-FBDOHH3Q.js";
 import {
   withMeta
-} from "./chunk-OHXHBMF4.js";
+} from "./chunk-KAC2WR7P.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-ASZ4IQB4.js";
+import "./chunk-MSM6VRQ4.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-M2WBOQ2Q.js";
 

package/dist/{skillsUpdateCheck-YCNJYDJO.js → skillsUpdateCheck-TE6K5ROM.js}

@@ -9,13 +9,13 @@ import {
   printSkillsUpdateNotice,
   refreshSkillsCache,
   skillsCheckDue
-} from "./chunk-R5FS7GFU.js";
-import "./chunk-OHXHBMF4.js";
+} from "./chunk-FBDOHH3Q.js";
+import "./chunk-KAC2WR7P.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-ASZ4IQB4.js";
+import "./chunk-MSM6VRQ4.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-M2WBOQ2Q.js";
 export {

package/dist/{snapshot-WSYZKR3C.js → snapshot-FE4T3SCN.js}

@@ -25,7 +25,7 @@ import {
   findFFmpeg,
   findFFprobe,
   getFFmpegInstallHint
-} from "./chunk-3OLOVRWS.js";
+} from "./chunk-GLG5JWLI.js";
 import {
   pngDimensions,
   reportArtifacts,
@@ -33,20 +33,20 @@ import {
 } from "./chunk-57GN6KWT.js";
 import {
   captureArtifactRevision
-} from "./chunk-AYBKDHYD.js";
-import "./chunk-4DZ3HBKF.js";
+} from "./chunk-7A65UCMI.js";
+import "./chunk-JOLZ3BSL.js";
 import "./chunk-X7MTZ4T2.js";
 import {
   resolveProject
-} from "./chunk-37EPEFXM.js";
+} from "./chunk-7ZJEQY7Q.js";
 import {
   serveStaticProjectHtml
-} from "./chunk-CSYSEPWL.js";
-import "./chunk-AQ3L7DVB.js";
+} from "./chunk-T5YF32WV.js";
+import "./chunk-ALEF2F5N.js";
 import "./chunk-X7MTZ4T2.js";
 import "./chunk-XUHOIDKG.js";
-import "./chunk-ZPMF6GAQ.js";
-import "./chunk-2CYM34M7.js";
+import "./chunk-2WNVHZHA.js";
+import "./chunk-KHCTBZGJ.js";
 import "./chunk-6JR2XUEE.js";
 import "./chunk-EI7FP7F3.js";
 import {
@@ -56,10 +56,11 @@ import {
   recordArtifacts,
   retainSnapshotOutput
 } from "./chunk-TMBUBLZB.js";
-import "./chunk-BZQLTNMB.js";
+import "./chunk-COETAXRN.js";
 import "./chunk-ALVXFXUG.js";
 import {
   DEFAULT_ZOOM_SCALE,
+  SCREENSHOT_IMAGE_WAIT_MS,
   captureRegionCrop,
   openSettledCompositionPage,
   parseZoomTarget,
@@ -67,37 +68,37 @@ import {
   runFfmpegOnce,
   seekCompositionTimelineOnly,
   settleCompositionSeek
-} from "./chunk-TREMHDWT.js";
-import "./chunk-HNMDLKA4.js";
+} from "./chunk-JYSSPQDT.js";
+import "./chunk-WY3TQ2PT.js";
 import "./chunk-MOEGCMKI.js";
-import "./chunk-565X6Q4X.js";
+import "./chunk-TJKE4EYX.js";
 import "./chunk-DKPNNYBZ.js";
-import "./chunk-HUG47UEE.js";
+import "./chunk-7FF36MAD.js";
 import "./chunk-K2FLNJVB.js";
 import "./chunk-EHSBBBR2.js";
-import "./chunk-SGFMCNLY.js";
+import "./chunk-COWQITWP.js";
 import "./chunk-442JNXRM.js";
 import "./chunk-DQBY7FRR.js";
 import {
   resolveLocalBrowserGpuMode
-} from "./chunk-B52BJM5K.js";
-import "./chunk-Z2BW2WJS.js";
+} from "./chunk-XMSQRDAK.js";
+import "./chunk-JJJCFKMF.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import "./chunk-HVW7ABXD.js";
-import "./chunk-VRQU564T.js";
+import "./chunk-3XI7MIZB.js";
 import {
   runWithConcurrencyLimit
 } from "./chunk-JHOCK3DG.js";
-import "./chunk-WMJJCHVQ.js";
-import "./chunk-5HJJEHGE.js";
+import "./chunk-TRZVS6TL.js";
+import "./chunk-LBNEH6IQ.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
 import "./chunk-7L37AB57.js";
 import "./chunk-EOVYQ3IG.js";
-import "./chunk-IPEP346Y.js";
-import "./chunk-T37XXYRK.js";
+import "./chunk-TFGO5YMI.js";
+import "./chunk-W3CS2KFV.js";
 import "./chunk-VWG7OQKU.js";
 import {
   defineCommand
@@ -113,20 +114,20 @@ import {
 import "./chunk-KLIKCX6Q.js";
 import "./chunk-EVMY7IPL.js";
 import "./chunk-7FMUTGOH.js";
-import "./chunk-HXM2ISEK.js";
+import "./chunk-NMDUSCCE.js";
 import "./chunk-IZCW2NKT.js";
 import {
   createRuntimeStartTimeResolver,
   isClipVisibleAt,
   isInClipWindow
-} from "./chunk-WYCFMNU3.js";
+} from "./chunk-GM3WIOO6.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-SMF6YAUL.js";
+import "./chunk-VYQYVYQ5.js";
 import {
   readElementRateSpec,
   sourceTimeAt,
   timeAtSourceTime
-} from "./chunk-BPX7LZG6.js";
+} from "./chunk-LM265QNK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-X7HBSTCZ.js";
 import {
@@ -150,7 +151,7 @@ import "./chunk-XT6MXC7A.js";
 import "./chunk-4UMPIPCQ.js";
 import {
   lintProject
-} from "./chunk-TSFA2Y5C.js";
+} from "./chunk-3NRB7YXW.js";
 import "./chunk-VAS6HQX3.js";
 import "./chunk-6BNTGNGD.js";
 import "./chunk-RUOG4VB7.js";
@@ -164,12 +165,12 @@ import "./chunk-I5JRXMCV.js";
 import "./chunk-W2LGJSEN.js";
 import {
   withMeta
-} from "./chunk-OHXHBMF4.js";
+} from "./chunk-KAC2WR7P.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-ASZ4IQB4.js";
+import "./chunk-MSM6VRQ4.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";
@@ -695,7 +696,7 @@ function serveCapturePage(projectDir, html, proxy) {
 }
 async function captureSnapshots(projectDir, opts) {
   const log = opts.log ?? ((message) => console.log(message));
-  const { bundleWithLocalizedFonts } = await import("./bundleWithLocalizedFonts-EDD2XDS2.js");
+  const { bundleWithLocalizedFonts } = await import("./bundleWithLocalizedFonts-23QDKFSN.js");
   const capture = await captureArtifactRevision(projectDir).catch(warnSnapshotsNotRecorded);
   const invocation = randomUUID();
   const artifacts = [];
@@ -756,7 +757,7 @@ async function captureSnapshots(projectDir, opts) {
         return 0;
       });
       if (duration <= 0 && !opts.at?.length) {
-        return { paths: [] };
+        return { paths: [], warnings };
       }
       const readTiming = () => page.evaluate(() => ({
         html: document.documentElement.outerHTML,
@@ -827,7 +828,7 @@ async function captureSnapshots(projectDir, opts) {
       let syncVideoFrameVisibility = null;
       let extractMediaMetadata = null;
       try {
-        const engine = await import("./src-YNXBU4ZQ.js");
+        const engine = await import("./src-ZOXSEJCD.js");
         injectVideoFramesBatch = engine.injectVideoFramesBatch;
         syncVideoFrameVisibility = engine.syncVideoFrameVisibility;
         extractMediaMetadata = engine.extractMediaMetadata;
@@ -852,7 +853,7 @@ async function captureSnapshots(projectDir, opts) {
       }
       for (let i = 0; i < positions.length; i++) {
         const time = positions[i];
-        const seekOptions = { exactTime: true };
+        const seekOptions = { exactTime: true, waitForImagesMs: SCREENSHOT_IMAGE_WAIT_MS };
         await seekCompositionTimelineOnly(page, time, seekOptions);
         if (cameraExpr) await page.evaluate(cameraExpr);
         if (injectVideoFramesBatch && syncVideoFrameVisibility) {
@@ -963,7 +964,7 @@ async function captureSnapshots(projectDir, opts) {
             );
           }
         }
-        await settleCompositionSeek(page, seekOptions);
+        warnUnsettledImages(await settleCompositionSeek(page, seekOptions), time, warnings);
         await recaptureSnapshotComposite(page);
         const timeLabel = formatSnapshotTimestamp(time);
         const slot = opts.keep ? `at-${timeLabel}` : `${String(i).padStart(2, "0")}-at-${timeLabel}`;
@@ -1057,6 +1058,7 @@ async function captureSnapshots(projectDir, opts) {
   }
   return {
     paths: savedPaths,
+    warnings,
     ...review && reviewList ? {
       review: {
         plan: review,
@@ -1068,6 +1070,18 @@ async function captureSnapshots(projectDir, opts) {
     } : {}
   };
 }
+function warnUnsettledImages(images, time, warnings) {
+  const groups = [
+    [images.pending, `did not finish loading within ${SCREENSHOT_IMAGE_WAIT_MS} ms`],
+    [images.failed, "failed to load"]
+  ];
+  for (const [sources, what] of groups) {
+    if (sources.length === 0) continue;
+    const message = `${sources.length} image(s) ${what} at ${time}s, so the frame may be missing them: ${sources.join(", ")}`;
+    warnings.push(message);
+    console.warn(`   ${c.warn("\u26A0")} ${message}`);
+  }
+}
 function warnSnapshotsNotRecorded(error) {
   console.warn(`   ${c.warn("\u26A0")} Snapshots were not recorded: ${normalizeErrorMessage(error)}`);
   return void 0;
@@ -1102,6 +1116,7 @@ function snapshotEnvelope(projectDir, outputDir, captured, extra) {
     outputDir,
     frames,
     contactSheets: extra.contactSheets.map((sheet) => resolve(sheet)),
+    ...captured.warnings.length > 0 ? { warnings: captured.warnings } : {},
     ...extra.describedPath ? { descriptions: extra.describedPath } : {},
     ...review ? {
       review: {

package/dist/{src-KTD6WTEV.js → src-SEJ7LNNB.js}

@@ -69,10 +69,10 @@ import {
   serializeRenderRequest,
   startServer,
   validatePlanV2MaterializedTarget
-} from "./chunk-HQIFMCQN.js";
+} from "./chunk-TFMZ4RKM.js";
 import {
   prepareAnimatedGifInputs
-} from "./chunk-XJVXROOL.js";
+} from "./chunk-RQBB7PYT.js";
 import "./chunk-BZ56MTDX.js";
 import {
   FONT_FETCH_FAILED,
@@ -98,14 +98,14 @@ import {
   isTransientBrowserError,
   prepareCaptureSessionForReuse,
   resolveConfig
-} from "./chunk-HXM2ISEK.js";
+} from "./chunk-NMDUSCCE.js";
 import "./chunk-IZCW2NKT.js";
 import {
   quantizeTimeToFrame
-} from "./chunk-WYCFMNU3.js";
+} from "./chunk-GM3WIOO6.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-SMF6YAUL.js";
-import "./chunk-BPX7LZG6.js";
+import "./chunk-VYQYVYQ5.js";
+import "./chunk-LM265QNK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-X7HBSTCZ.js";
 import "./chunk-B2A56S5C.js";
@@ -115,7 +115,7 @@ import "./chunk-3GXQPCJC.js";
 import "./chunk-634HSJ3J.js";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-4UMPIPCQ.js";
-import "./chunk-TSFA2Y5C.js";
+import "./chunk-3NRB7YXW.js";
 import "./chunk-VAS6HQX3.js";
 import "./chunk-6BNTGNGD.js";
 import "./chunk-RUOG4VB7.js";

package/dist/{src-YNXBU4ZQ.js → src-ZOXSEJCD.js}

@@ -223,15 +223,15 @@ import {
   waitForImagesReady,
   writeCapturedFrame,
   writeUrlDownloadTelemetry
-} from "./chunk-HXM2ISEK.js";
+} from "./chunk-NMDUSCCE.js";
 import "./chunk-IZCW2NKT.js";
 import {
   MEDIA_VISUAL_STYLE_PROPERTIES,
   quantizeTimeToFrame
-} from "./chunk-WYCFMNU3.js";
+} from "./chunk-GM3WIOO6.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-SMF6YAUL.js";
-import "./chunk-BPX7LZG6.js";
+import "./chunk-VYQYVYQ5.js";
+import "./chunk-LM265QNK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-X7HBSTCZ.js";
 import "./chunk-B2A56S5C.js";
@@ -253,7 +253,7 @@ import {
 import {
   resolveReferencedDuration,
   resolveReferencedStart
-} from "./chunk-TSFA2Y5C.js";
+} from "./chunk-3NRB7YXW.js";
 import {
   FFMPEG_PATH_ENV,
   FFPROBE_PATH_ENV

package/dist/{staticProjectServer-D2D3BKBP.js → staticProjectServer-LSVIRDRO.js}

@@ -7,27 +7,27 @@ var __dirname = __hf_dirname(__filename);
 import {
   inProcessAnswer,
   serveStaticProjectHtml
-} from "./chunk-CSYSEPWL.js";
-import "./chunk-AQ3L7DVB.js";
+} from "./chunk-T5YF32WV.js";
+import "./chunk-ALEF2F5N.js";
 import "./chunk-X7MTZ4T2.js";
 import "./chunk-XUHOIDKG.js";
-import "./chunk-ZPMF6GAQ.js";
-import "./chunk-2CYM34M7.js";
+import "./chunk-2WNVHZHA.js";
+import "./chunk-KHCTBZGJ.js";
 import "./chunk-6JR2XUEE.js";
 import "./chunk-EI7FP7F3.js";
 import "./chunk-TMBUBLZB.js";
-import "./chunk-BZQLTNMB.js";
+import "./chunk-COETAXRN.js";
 import "./chunk-ALVXFXUG.js";
-import "./chunk-SGFMCNLY.js";
+import "./chunk-COWQITWP.js";
 import "./chunk-442JNXRM.js";
-import "./chunk-Z2BW2WJS.js";
+import "./chunk-JJJCFKMF.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import "./chunk-HVW7ABXD.js";
-import "./chunk-VRQU564T.js";
+import "./chunk-3XI7MIZB.js";
 import "./chunk-JHOCK3DG.js";
-import "./chunk-WMJJCHVQ.js";
-import "./chunk-5HJJEHGE.js";
+import "./chunk-TRZVS6TL.js";
+import "./chunk-LBNEH6IQ.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
@@ -37,10 +37,10 @@ import "./chunk-KLIKCX6Q.js";
 import "./chunk-EVMY7IPL.js";
 import "./chunk-7FMUTGOH.js";
 import "./chunk-IZCW2NKT.js";
-import "./chunk-WYCFMNU3.js";
+import "./chunk-GM3WIOO6.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-SMF6YAUL.js";
-import "./chunk-BPX7LZG6.js";
+import "./chunk-VYQYVYQ5.js";
+import "./chunk-LM265QNK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-X7HBSTCZ.js";
 import "./chunk-B2A56S5C.js";
@@ -48,7 +48,7 @@ import "./chunk-OFQWTKPW.js";
 import "./chunk-DPVXBVLL.js";
 import "./chunk-634HSJ3J.js";
 import "./chunk-FXMKHHPO.js";
-import "./chunk-TSFA2Y5C.js";
+import "./chunk-3NRB7YXW.js";
 import "./chunk-VAS6HQX3.js";
 import "./chunk-6BNTGNGD.js";
 import "./chunk-RUOG4VB7.js";

package/dist/studio/assets/{hyperframes-player-CkK8Zijf.js → hyperframes-player-Bv9hQ3v7.js}

@@ -1,4 +1,4 @@
-var xe=Object.defineProperty;var Ie=(r,i,e)=>i in r?xe(r,i,{enumerable:!0,configurable:!0,writable:!0,value:e}):r[i]=e;var l=(r,i,e)=>Ie(r,typeof i!="symbol"?i+"":i,e);import{S as Oe,r as Ne,a as fe,i as Fe,b as w,c as _e,p as Ve,d as Ue,e as He,f as ze,s as We,g as ge,F as ye}from"./index-B2JcCaRF.js";function $e(r){return r.hasRuntime||r.runtimeInjected?!1:!!(r.hasNestedCompositions||r.hasTimelines&&r.attempts>=5)}function x(r){return typeof r=="object"&&r!==null}function je(r){return x(r)&&typeof r.getDuration=="function"}function Be(r){return x(r)&&typeof r.duration=="function"&&typeof r.time=="function"&&typeof r.seek=="function"&&typeof r.play=="function"&&typeof r.pause=="function"}function qe(r){if(!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(r))throw new Error(`Invalid HyperFrames runtime version: ${r}`);return`https://cdn.jsdelivr.net/npm/@hyperframes/core@${r}/dist/hyperframe.runtime.iife.js`}const z=typeof __HYPERFRAMES_RUNTIME_CDN_URL__=="string"?__HYPERFRAMES_RUNTIME_CDN_URL__:qe("0.0.0-dev");function $(r){if(r===null)return null;const i=Number.parseInt(r,10);return Number.isFinite(i)&&i>0?i:null}function Ge(r){const i=(r==null?void 0:r.querySelector("[data-composition-id][data-width][data-height]"))??(r==null?void 0:r.querySelector("[data-width][data-height]"));if(!i)return null;const e=$(i.getAttribute("data-width")),t=$(i.getAttribute("data-height"));return e!==null&&t!==null?{width:e,height:t}:null}function Ye(r){return Array.isArray(r)?r.find(i=>typeof i=="string"&&i.trim()!==""&&i!=="[object Event]")??null:null}class Xe{constructor(i,e){l(this,"_interval",null);l(this,"_runtimeInjected",!1);l(this,"_runtimeScript",null);l(this,"_failure",null);this._iframe=i,this._callbacks=e}get failed(){return this._failure!==null&&this._failure.document===this._iframe.contentDocument}get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._failure=null,this._runtimeInjected=!1;let i=0;this._interval=setInterval(()=>{i++;let e=null;try{e=this._poll(i)}catch(t){t instanceof DOMException&&t.name==="SecurityError"||(e={kind:"error",message:t instanceof Error?t.message:String(t)})}e??(e=this._deadlineOutcome(i)),e&&(this.stop(),e.kind==="error"?(this._failure={document:this._iframe.contentDocument},this._callbacks.onError(e.message)):this._callbacks.onReady(e.result))},200)}_deadlineOutcome(i){var e,t;return i<40||(t=(e=this._callbacks).hostOwnsDeadline)!=null&&t.call(e)?null:{kind:"error",message:"Composition timeline not found after 8s"}}_poll(i){const e=this._iframe.contentWindow;if(!e)return null;const t=Ye(Reflect.get(e,Oe));if(t!==null)return{kind:"error",message:t};const s=this._iframe.contentDocument,n=Reflect.get(e,"__timelines"),o=this.hasRuntimeBridge(e);if($e({hasRuntime:o,hasTimelines:x(n)&&Object.keys(n).length>0,hasNestedCompositions:!!(s!=null&&s.querySelector("[data-composition-src]")),runtimeInjected:this._runtimeInjected,attempts:i}))return this._injectRuntime(),null;if(this._runtimeInjected&&!o)return null;const a=this._resolveReadyResult(e,s);return a?{kind:"ready",result:a}:null}_resolveReadyResult(i,e){var n;const t=this._resolvePlaybackDurationAdapter(i)??{kind:"document",getDuration:()=>0};let s=t.getDuration();if(!Number.isFinite(s)||s<=0){if(t.kind==="direct-timeline")return null;s=e?((n=Ne(e))==null?void 0:n.durationSeconds)??0:0}return s<=0?null:{duration:s,adapter:{...t,getDuration:()=>s},compositionSize:Ge(e)}}stop(){this._runtimeScript&&(this._runtimeScript.onerror=null,this._runtimeScript=null),this.failed||(this._failure=null),this._interval!==null&&(clearInterval(this._interval),this._interval=null)}resolveDirectTimelineAdapter(){try{const i=this._iframe.contentWindow;return i?this._resolveDirectTimelineAdapterFromWindow(i):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(i){return this._resolveDirectTimelineAdapterFromWindow(i)}hasRuntimeBridge(i){return x(Reflect.get(i,"__player"))}_injectRuntime(){var i,e,t,s;this._runtimeInjected=!0;try{const n=this._iframe.contentDocument;if(!n)return;const o=n.createElement("script");o.src=((e=(i=this._callbacks).resolveRuntimeUrl)==null?void 0:e.call(i))??z,this._runtimeScript=o,o.onerror=()=>{this._runtimeScript!==o||this._iframe.contentDocument!==n||(this.stop(),this._failure={document:n},this._callbacks.onError("HyperFrames runtime failed to load from "+o.src))},(n.head||n.documentElement).appendChild(o),(s=(t=this._callbacks).onRuntimeInjected)==null||s.call(t)}catch{}}_resolveDirectTimelineAdapterFromWindow(i){var a,c;if(this.hasRuntimeBridge(i))return null;const e=Reflect.get(i,"__timelines");if(!x(e))return null;const t=Object.keys(e);if(t.length===0)return null;const s=(c=(a=this._iframe.contentDocument)==null?void 0:a.querySelector("[data-composition-id]"))==null?void 0:c.getAttribute("data-composition-id"),n=s&&s in e?s:t[t.length-1],o=e[n];return Be(o)?o:null}_resolvePlaybackDurationAdapter(i){const e=Reflect.get(i,"__player");if(je(e))return{kind:"runtime",getDuration:()=>e.getDuration()};const t=this._resolveDirectTimelineAdapterFromWindow(i);return t?{kind:"direct-timeline",timeline:t,getDuration:()=>t.duration()}:null}}const Ze=`
+var xe=Object.defineProperty;var Ie=(r,i,e)=>i in r?xe(r,i,{enumerable:!0,configurable:!0,writable:!0,value:e}):r[i]=e;var l=(r,i,e)=>Ie(r,typeof i!="symbol"?i+"":i,e);import{S as Oe,r as Ne,a as fe,i as Fe,b as w,c as _e,p as Ve,d as Ue,e as He,f as ze,s as We,g as ge,F as ye}from"./index-D_QqfWhx.js";function $e(r){return r.hasRuntime||r.runtimeInjected?!1:!!(r.hasNestedCompositions||r.hasTimelines&&r.attempts>=5)}function x(r){return typeof r=="object"&&r!==null}function je(r){return x(r)&&typeof r.getDuration=="function"}function Be(r){return x(r)&&typeof r.duration=="function"&&typeof r.time=="function"&&typeof r.seek=="function"&&typeof r.play=="function"&&typeof r.pause=="function"}function qe(r){if(!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(r))throw new Error(`Invalid HyperFrames runtime version: ${r}`);return`https://cdn.jsdelivr.net/npm/@hyperframes/core@${r}/dist/hyperframe.runtime.iife.js`}const z=typeof __HYPERFRAMES_RUNTIME_CDN_URL__=="string"?__HYPERFRAMES_RUNTIME_CDN_URL__:qe("0.0.0-dev");function $(r){if(r===null)return null;const i=Number.parseInt(r,10);return Number.isFinite(i)&&i>0?i:null}function Ge(r){const i=(r==null?void 0:r.querySelector("[data-composition-id][data-width][data-height]"))??(r==null?void 0:r.querySelector("[data-width][data-height]"));if(!i)return null;const e=$(i.getAttribute("data-width")),t=$(i.getAttribute("data-height"));return e!==null&&t!==null?{width:e,height:t}:null}function Ye(r){return Array.isArray(r)?r.find(i=>typeof i=="string"&&i.trim()!==""&&i!=="[object Event]")??null:null}class Xe{constructor(i,e){l(this,"_interval",null);l(this,"_runtimeInjected",!1);l(this,"_runtimeScript",null);l(this,"_failure",null);this._iframe=i,this._callbacks=e}get failed(){return this._failure!==null&&this._failure.document===this._iframe.contentDocument}get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._failure=null,this._runtimeInjected=!1;let i=0;this._interval=setInterval(()=>{i++;let e=null;try{e=this._poll(i)}catch(t){t instanceof DOMException&&t.name==="SecurityError"||(e={kind:"error",message:t instanceof Error?t.message:String(t)})}e??(e=this._deadlineOutcome(i)),e&&(this.stop(),e.kind==="error"?(this._failure={document:this._iframe.contentDocument},this._callbacks.onError(e.message)):this._callbacks.onReady(e.result))},200)}_deadlineOutcome(i){var e,t;return i<40||(t=(e=this._callbacks).hostOwnsDeadline)!=null&&t.call(e)?null:{kind:"error",message:"Composition timeline not found after 8s"}}_poll(i){const e=this._iframe.contentWindow;if(!e)return null;const t=Ye(Reflect.get(e,Oe));if(t!==null)return{kind:"error",message:t};const s=this._iframe.contentDocument,n=Reflect.get(e,"__timelines"),o=this.hasRuntimeBridge(e);if($e({hasRuntime:o,hasTimelines:x(n)&&Object.keys(n).length>0,hasNestedCompositions:!!(s!=null&&s.querySelector("[data-composition-src]")),runtimeInjected:this._runtimeInjected,attempts:i}))return this._injectRuntime(),null;if(this._runtimeInjected&&!o)return null;const a=this._resolveReadyResult(e,s);return a?{kind:"ready",result:a}:null}_resolveReadyResult(i,e){var n;const t=this._resolvePlaybackDurationAdapter(i)??{kind:"document",getDuration:()=>0};let s=t.getDuration();if(!Number.isFinite(s)||s<=0){if(t.kind==="direct-timeline")return null;s=e?((n=Ne(e))==null?void 0:n.durationSeconds)??0:0}return s<=0?null:{duration:s,adapter:{...t,getDuration:()=>s},compositionSize:Ge(e)}}stop(){this._runtimeScript&&(this._runtimeScript.onerror=null,this._runtimeScript=null),this.failed||(this._failure=null),this._interval!==null&&(clearInterval(this._interval),this._interval=null)}resolveDirectTimelineAdapter(){try{const i=this._iframe.contentWindow;return i?this._resolveDirectTimelineAdapterFromWindow(i):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(i){return this._resolveDirectTimelineAdapterFromWindow(i)}hasRuntimeBridge(i){return x(Reflect.get(i,"__player"))}_injectRuntime(){var i,e,t,s;this._runtimeInjected=!0;try{const n=this._iframe.contentDocument;if(!n)return;const o=n.createElement("script");o.src=((e=(i=this._callbacks).resolveRuntimeUrl)==null?void 0:e.call(i))??z,this._runtimeScript=o,o.onerror=()=>{this._runtimeScript!==o||this._iframe.contentDocument!==n||(this.stop(),this._failure={document:n},this._callbacks.onError("HyperFrames runtime failed to load from "+o.src))},(n.head||n.documentElement).appendChild(o),(s=(t=this._callbacks).onRuntimeInjected)==null||s.call(t)}catch{}}_resolveDirectTimelineAdapterFromWindow(i){var a,c;if(this.hasRuntimeBridge(i))return null;const e=Reflect.get(i,"__timelines");if(!x(e))return null;const t=Object.keys(e);if(t.length===0)return null;const s=(c=(a=this._iframe.contentDocument)==null?void 0:a.querySelector("[data-composition-id]"))==null?void 0:c.getAttribute("data-composition-id"),n=s&&s in e?s:t[t.length-1],o=e[n];return Be(o)?o:null}_resolvePlaybackDurationAdapter(i){const e=Reflect.get(i,"__player");if(je(e))return{kind:"runtime",getDuration:()=>e.getDuration()};const t=this._resolveDirectTimelineAdapterFromWindow(i);return t?{kind:"direct-timeline",timeline:t,getDuration:()=>t.duration()}:null}}const Ze=`
   :host {
     display: block;
     position: relative;