@@ -885,6 +885,12 @@ Sentences come from a transcript: `--transcript <file>`, or
885885` <recording>.transcript.json ` beside the recording. Without one, voice lines
886886carry no words.
887887
888+ A file you know holds one layer is read whole with ` --layer music|sfx|voice ` :
889+ no stems are fetched and nothing leaves the machine, whatever ` --quality ` says.
890+ ` music ` reads the file as the music bed (sections, tempo, levels), ` voice ` reads
891+ words and pauses from it, ` sfx ` finds its effects. The JSON result records the
892+ declared ` layer ` ; without the flag the read is unchanged.
893+
888894Effects and music are read from stems. At ` --quality best ` the
889895recording is separated into vocals, drums, bass, guitar, piano and other by
890896HeyGen's ` /v3/audio/stems ` , with your HeyGen credential (see
@@ -1149,6 +1155,13 @@ installed, `open` exits 1 and prints a download link. With `--json`, the result
11491155names the ` reason ` and the ` downloadUrl ` . The hand-off works on macOS, Windows
11501156and Linux.
11511157
1158+ The app can't edit a project while a preview of it is running, because the
1159+ preview holds the project's edit history. So ` open ` first stops the project's
1160+ ` preview --background ` server and says so. It leaves any other preview running,
1161+ such as one started in a terminal, and prints the ` preview --stop ` command
1162+ instead. With ` --json ` , the ` preview ` field reports ` none ` , ` stopped ` or
1163+ ` left-running ` .
1164+
11521165` catch-up ` is the other half of that hand-off. Run it when the person is back
11531166from the desktop app, before you change anything: it lists what they asked and
11541167what changed in the app since you last looked, and the files changed since
@@ -1196,6 +1209,12 @@ unless you pass `--verbose`, which keeps output clean for agents and CI.
11961209` --lint-verbose ` , which ` render ` , ` preview ` and ` publish ` use for the same wish, works here and on ` check ` too.
11971210` --json ` adds ` errorCount ` , ` warningCount ` , ` infoCount ` , and a ` findings ` array.
11981211
1212+ Only the compositions the project uses are linted: ` index.html ` and every file it mounts through
1213+ ` data-composition-src ` , followed through the files they mount. A file under ` compositions/ ` that
1214+ nothing mounts (an installed block you have not placed yet) is left out, and one line says how
1215+ many were; ` --include-unmounted ` lints them too. ` --json ` lists them in ` unmountedCompositions ` .
1216+ ` check ` lints the same way and takes the same flag.
1217+
11991218The linter catches missing attributes, missing adapter libraries (GSAP, Lottie,
12001219Three.js), and structural problems. [ Troubleshooting] ( /help )
12011220explains each rule.
@@ -1240,6 +1259,7 @@ cover every finding from the full check.
12401259| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
12411260| ` --json ` | One aggregated envelope. Every finding carries a selector, ` data-* ` identity, source file, bbox, and sample time. |
12421261| ` --snapshots ` | Save the five audited frames under ` .hyperframes/artifacts/snapshots/ ` , plus a ` finding-NN-<code>.png ` crop per finding |
1262+ | ` --include-unmounted ` | Also lint ` compositions/ ` files that ` index.html ` never mounts (left out by default, with one line saying how many) |
12431263| ` --samples ` | Midpoint samples across the duration (default 9) |
12441264| ` --at ` | Explicit timestamps in seconds, comma-separated |
12451265| ` --at-transitions ` | Also sample every tween start and end, to catch transient overlaps at transition seams |
@@ -1269,6 +1289,10 @@ and ends a copy that makes no progress for 3 minutes (`HYPERFRAMES_PROXY_STALL_M
12691289For a long project, run ` hyperframes check --prepare-media ` first, then the check itself finds
12701290every copy ready.
12711291
1292+ A Chrome that is not ready 3 minutes after the check begins to start it ends the check with a runtime
1293+ finding that says Chrome did not start and how long each step took. On a first run Chrome may still be
1294+ downloading: run ` hyperframes browser ensure ` once, then run check again.
1295+
12721296` --caption-zone ` and ` --frame-check ` refuse a ranged check when none of their
12731297configured seek samples falls inside ` --range ` ; a requested gate never silently
12741298passes without running.
@@ -1366,6 +1390,10 @@ The check runs alongside the browser pass, up to four files at a time. A clip
13661390longer than 3 s is first sampled at three 1-second spots and decoded in full
13671391only if all three are silent.
13681392
1393+ Overlap is judged on the text a viewer can see: a part of a text block that an
1394+ overflow clip, a ` clip-path ` or a gradient ` mask-image ` (on the text or an ancestor)
1395+ keeps from painting does not count.
1396+
13691397#### Mark intentional layout choices
13701398
13711399When the audit is wrong because the layout is deliberate, say so in the HTML and
0 commit comments