hyperframes 0.8.190 → 0.8.191

package/dist/{render-4E7QDVOI.js → render-SJ4HFPFU.js}

@@ -46,7 +46,7 @@ import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-WBUO6WH6.js";
+} from "./chunk-WQ3X5OH4.js";
 import {
   downloadToFile
 } from "./chunk-CZUAX3BV.js";
@@ -54,10 +54,10 @@ import {
   findFFmpeg,
   findFFprobe,
   getFFmpegInstallHint
-} from "./chunk-IARWN467.js";
+} from "./chunk-GLG5JWLI.js";
 import {
   resolveProject
-} from "./chunk-OTQXYTQZ.js";
+} from "./chunk-7ZJEQY7Q.js";
 import {
   errorBox,
   formatBytes,
@@ -65,8 +65,8 @@ import {
 } from "./chunk-K2FLNJVB.js";
 import "./chunk-442JNXRM.js";
 import "./chunk-EOVYQ3IG.js";
-import "./chunk-OOAVKK2W.js";
-import "./chunk-TTZTGXKG.js";
+import "./chunk-TFGO5YMI.js";
+import "./chunk-W3CS2KFV.js";
 import "./chunk-VWG7OQKU.js";
 import {
   defineCommand
@@ -78,14 +78,14 @@ import {
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
-import "./chunk-OAPYPSEB.js";
+import "./chunk-NMDUSCCE.js";
 import "./chunk-IZCW2NKT.js";
 import {
   parseAnimatedGifMetadata
-} from "./chunk-56IOFIYB.js";
+} from "./chunk-GM3WIOO6.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-TSQAPPRS.js";
-import "./chunk-DIV37NUE.js";
+import "./chunk-VYQYVYQ5.js";
+import "./chunk-LM265QNK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-X7HBSTCZ.js";
 import "./chunk-B2A56S5C.js";
@@ -98,7 +98,7 @@ import "./chunk-DYAPHNV6.js";
 import "./chunk-T6AGUTZJ.js";
 import "./chunk-XT6MXC7A.js";
 import "./chunk-4UMPIPCQ.js";
-import "./chunk-TSFA2Y5C.js";
+import "./chunk-3NRB7YXW.js";
 import "./chunk-VAS6HQX3.js";
 import {
   cleanAssetUrl,
@@ -121,12 +121,12 @@ import "./chunk-I5JRXMCV.js";
 import "./chunk-W2LGJSEN.js";
 import {
   withMeta
-} from "./chunk-STJ2ANMF.js";
+} from "./chunk-KAC2WR7P.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-F6DNM676.js";
+import "./chunk-MSM6VRQ4.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";
@@ -682,7 +682,7 @@ async function prepareEntryGifs(ctx, fileMap) {
   if (!html || !/\.gif\b/i.test(html)) return;
   const sourceAssets = entryGifSources(ctx, entryPath, html);
   if (!sourceAssets) return;
-  const prep = ctx.opts.gifPrep ?? (await import("./src-W6Y5ZYRQ.js")).prepareAnimatedGifInputs;
+  const prep = ctx.opts.gifPrep ?? (await import("./src-SEJ7LNNB.js")).prepareAnimatedGifInputs;
   const outputDir = mkdtempSync(join(tmpdir(), "hf-offload-gif-"));
   ctx.tempFiles.push(outputDir);
   const result = await prep(html, {

package/dist/{render-batch-7ULP5RIJ.js → render-batch-GKX54O6N.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   warnOnDimensionMismatch
-} from "./chunk-BWPY64WA.js";
+} from "./chunk-CXMXJEVY.js";
 import {
   requireStack
 } from "./chunk-RIJHDTM5.js";
@@ -14,11 +14,11 @@ import {
   loadProjectVariableSchema,
   reportVariableIssues,
   validateVariablesAgainstSchema
-} from "./chunk-WBUO6WH6.js";
+} from "./chunk-WQ3X5OH4.js";
 import {
   errorBox
 } from "./chunk-K2FLNJVB.js";
-import "./chunk-ZFFKWHXN.js";
+import "./chunk-COWQITWP.js";
 import "./chunk-442JNXRM.js";
 import {
   runWithConcurrencyLimit
@@ -30,9 +30,9 @@ import {
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
-import "./chunk-56IOFIYB.js";
+import "./chunk-GM3WIOO6.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-DIV37NUE.js";
+import "./chunk-LM265QNK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-X7HBSTCZ.js";
 import "./chunk-B2A56S5C.js";
@@ -115,7 +115,8 @@ async function runRenderBatch(args) {
     siteHandle = await deploySite({
       projectDir,
       bucketName: stack.bucketName,
-      region: stack.region
+      region: stack.region,
+      onNotice: (message) => console.error(c.dim(message))
     });
     if (!args.json) {
       console.log(

package/dist/renderSetupWorker.js

@@ -22,7 +22,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";

package/dist/{resolver-D3XERO6U.js → resolver-RQJ7CNXD.js}

@@ -11,15 +11,15 @@ import {
   resolveItemWithDependencies,
   resolveItemsByTag,
   unreachableRegistryMessage
-} from "./chunk-SUSSMCWL.js";
+} from "./chunk-3XI7MIZB.js";
 import "./chunk-JHOCK3DG.js";
-import "./chunk-AYFF3GX6.js";
+import "./chunk-LBNEH6IQ.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
-import "./chunk-56IOFIYB.js";
+import "./chunk-GM3WIOO6.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-DIV37NUE.js";
+import "./chunk-LM265QNK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-X7HBSTCZ.js";
 import "./chunk-B2A56S5C.js";

package/dist/{sherpa-5B5G426W.js → sherpa-XZPG7QFF.js}

@@ -17,22 +17,22 @@ import {
   sherpaRuntimeLoadError,
   sherpaUnsupportedReason,
   transcribeWithSherpa
-} from "./chunk-FUHI34T4.js";
+} from "./chunk-BFFLKQVB.js";
 import "./chunk-CZUAX3BV.js";
 import "./chunk-QH3T4WI2.js";
 import "./chunk-6BEFEWFB.js";
-import "./chunk-2FFOLLU2.js";
-import "./chunk-RBGNU7VD.js";
-import "./chunk-S7C6EM7N.js";
+import "./chunk-AQB5M53R.js";
+import "./chunk-RWYUK7LM.js";
+import "./chunk-7LUJE3II.js";
 import "./chunk-WQ6ZXHFQ.js";
-import "./chunk-IARWN467.js";
+import "./chunk-GLG5JWLI.js";
 import "./chunk-EOVYQ3IG.js";
-import "./chunk-OAPYPSEB.js";
+import "./chunk-NMDUSCCE.js";
 import "./chunk-IZCW2NKT.js";
-import "./chunk-56IOFIYB.js";
+import "./chunk-GM3WIOO6.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-TSQAPPRS.js";
-import "./chunk-DIV37NUE.js";
+import "./chunk-VYQYVYQ5.js";
+import "./chunk-LM265QNK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-X7HBSTCZ.js";
 import "./chunk-B2A56S5C.js";
@@ -45,7 +45,7 @@ import "./chunk-W64L7IFS.js";
 import "./chunk-DYAPHNV6.js";
 import "./chunk-XT6MXC7A.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/{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-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-RXHRF7O7.js → skills-EYLB2V6F.js}

@@ -15,8 +15,8 @@ import {
 } from "./chunk-WMQNIQDJ.js";
 import {
   trackSkillsInstallSkipped
-} from "./chunk-OOAVKK2W.js";
-import "./chunk-TTZTGXKG.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-EUUHVDMN.js";
+} from "./chunk-FBDOHH3Q.js";
 import {
   withMeta
-} from "./chunk-STJ2ANMF.js";
+} from "./chunk-KAC2WR7P.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-F6DNM676.js";
+import "./chunk-MSM6VRQ4.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-M2WBOQ2Q.js";
 

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

@@ -9,13 +9,13 @@ import {
   printSkillsUpdateNotice,
   refreshSkillsCache,
   skillsCheckDue
-} from "./chunk-EUUHVDMN.js";
-import "./chunk-STJ2ANMF.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-F6DNM676.js";
+import "./chunk-MSM6VRQ4.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-M2WBOQ2Q.js";
 export {

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

@@ -25,7 +25,7 @@ import {
   findFFmpeg,
   findFFprobe,
   getFFmpegInstallHint
-} from "./chunk-IARWN467.js";
+} from "./chunk-GLG5JWLI.js";
 import {
   pngDimensions,
   reportArtifacts,
@@ -33,20 +33,20 @@ import {
 } from "./chunk-57GN6KWT.js";
 import {
   captureArtifactRevision
-} from "./chunk-56IDMP37.js";
-import "./chunk-7JHTNUF2.js";
+} from "./chunk-7A65UCMI.js";
+import "./chunk-JOLZ3BSL.js";
 import "./chunk-X7MTZ4T2.js";
 import {
   resolveProject
-} from "./chunk-OTQXYTQZ.js";
+} from "./chunk-7ZJEQY7Q.js";
 import {
   serveStaticProjectHtml
-} from "./chunk-HJZ5CPZA.js";
-import "./chunk-EPOYPP36.js";
+} from "./chunk-T5YF32WV.js";
+import "./chunk-ALEF2F5N.js";
 import "./chunk-X7MTZ4T2.js";
 import "./chunk-XUHOIDKG.js";
-import "./chunk-L34DPWY4.js";
-import "./chunk-RDHEG7RX.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-BT64TTSE.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-EU5HTY3E.js";
-import "./chunk-GGVGOY6M.js";
+} from "./chunk-JYSSPQDT.js";
+import "./chunk-WY3TQ2PT.js";
 import "./chunk-MOEGCMKI.js";
-import "./chunk-CWVSJA52.js";
+import "./chunk-TJKE4EYX.js";
 import "./chunk-DKPNNYBZ.js";
-import "./chunk-XNLYMHX2.js";
+import "./chunk-7FF36MAD.js";
 import "./chunk-K2FLNJVB.js";
 import "./chunk-EHSBBBR2.js";
-import "./chunk-ZFFKWHXN.js";
+import "./chunk-COWQITWP.js";
 import "./chunk-442JNXRM.js";
 import "./chunk-DQBY7FRR.js";
 import {
   resolveLocalBrowserGpuMode
-} from "./chunk-KNQQZRB2.js";
-import "./chunk-UZ7RJDEC.js";
+} from "./chunk-XMSQRDAK.js";
+import "./chunk-JJJCFKMF.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import "./chunk-HVW7ABXD.js";
-import "./chunk-SUSSMCWL.js";
+import "./chunk-3XI7MIZB.js";
 import {
   runWithConcurrencyLimit
 } from "./chunk-JHOCK3DG.js";
-import "./chunk-6HYHHMX3.js";
-import "./chunk-AYFF3GX6.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-OOAVKK2W.js";
-import "./chunk-TTZTGXKG.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-OAPYPSEB.js";
+import "./chunk-NMDUSCCE.js";
 import "./chunk-IZCW2NKT.js";
 import {
   createRuntimeStartTimeResolver,
   isClipVisibleAt,
   isInClipWindow
-} from "./chunk-56IOFIYB.js";
+} from "./chunk-GM3WIOO6.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-TSQAPPRS.js";
+import "./chunk-VYQYVYQ5.js";
 import {
   readElementRateSpec,
   sourceTimeAt,
   timeAtSourceTime
-} from "./chunk-DIV37NUE.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-STJ2ANMF.js";
+} from "./chunk-KAC2WR7P.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-F6DNM676.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-RWHFMSFL.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-XSDYRKLG.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-W6Y5ZYRQ.js → src-SEJ7LNNB.js}

@@ -69,10 +69,10 @@ import {
   serializeRenderRequest,
   startServer,
   validatePlanV2MaterializedTarget
-} from "./chunk-FVD44EQX.js";
+} from "./chunk-TFMZ4RKM.js";
 import {
   prepareAnimatedGifInputs
-} from "./chunk-A5YHWTSP.js";
+} from "./chunk-RQBB7PYT.js";
 import "./chunk-BZ56MTDX.js";
 import {
   FONT_FETCH_FAILED,
@@ -98,14 +98,14 @@ import {
   isTransientBrowserError,
   prepareCaptureSessionForReuse,
   resolveConfig
-} from "./chunk-OAPYPSEB.js";
+} from "./chunk-NMDUSCCE.js";
 import "./chunk-IZCW2NKT.js";
 import {
   quantizeTimeToFrame
-} from "./chunk-56IOFIYB.js";
+} from "./chunk-GM3WIOO6.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-TSQAPPRS.js";
-import "./chunk-DIV37NUE.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";