Commit Graph
6847 Commits
Author SHA1 Message Date
Vance IngallsandClaude Sonnet 5.5 2066a2ff54 fix(core): the filter tier's svg no longer changes which child is last in the root (#7293)
Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-06 04:33:20 +00:00
Vance IngallsandClaude Sonnet 5.5 cd7e93baa0 fix(core): blur quiets discrete callbacks instead of undoing what they wrote (#7271)
* fix(core): blur quiets discrete callbacks instead of undoing what they wrote

#7191 undid the DOM a callback wrote during the blur scan with a mutation journal. That
regressed once-guarded and memoized timeline callbacks: the callback ran, its guard flipped,
and the journal put the DOM back, so the real seek never wrote it again.

Mute GSAP's onStart, onComplete, onReverseComplete and onRepeat for the scan and for eventful
pose reads, then restore them. onUpdate keeps firing, so movers driven from it are still found.
muteDiscreteCallbacks replaces a callback with a no-op rather than clearing it
(hasZeroDurationCallbackTween reads typeof vars.onComplete), walks tween.timeline for staggers
and keyframes, and skips an animation already muted because scene timelines nest in the root.
The journal (journalDom, landThenUndoDom, putBack) is deleted. The loud rewind through 0 stays.

Measured in the spike (mute-spike-report.md, "Probe matrix and fresh worker"): every GSAP
pattern matches blur off in label and fire count; 8 of 300 comparisons differ, all the non-GSAP
row, against 248 of 300 on main. This supersedes the limit #7191 accepted. Mute and restore over
2002 animations is 0.2 ms.

Limits:
- A mover that exists only because a muted callback set it up is found only if that callback
  fired before the scan. A worker starting before the call leaves that mover sharp while a later
  worker blurs it; positions stay right.
- tl.call(() => gsap.to(...)) movers are never found and stay sharp.
- A non-GSAP adapter that ignores suppressEvents (adapters/animejs.ts) and writes DOM on a
  once-only completion shows it early. Pinned by a KNOWN LIMIT test.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(producer): drop the once-guard-label block-start guard that pins a block that cannot fail

The guard required a block start in [1, 15], the worker at frame 9, and the comment said it
paints on both sides of the call at 16. Its frames after the call (16, 17) sit inside the
trail mask at the label, so that block cannot show the bug. The outside-the-trail case on the
7-worker partition is what catches the mutant; the fixture stays in FIXTURE_NAMES.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(engine): split the callbacks matrix in three and share one blur-off run per row

The matrix file took 247 s on an idle Mac and timed out at the flake gate's 120 s in all 10 reruns.
Each row now compares the arms against one blur-off page painted in order and one fresh page, not
a new blur-off page per arm and sequence; the in-order sequence is the first paints of the page that
goes back to the first time; rows run their pages together; the paint skips the full-frame PNG that
only the pixel tests read. Only the two arms with an onUpdate mover stay (both tiers): they run the
scan's mute and the per-frame mute, which the arms without a mover do not.

The rows and harness move to __fixtures__/motionBlur/callbackRows.ts and the matrix is split over
three files so each run fits the gate. Rows a to y, the three sequences, both tiers, row y and the
KNOWN LIMIT test are all kept; no assertion changed.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-06 04:15:22 +00:00
Miguel Ángel a81b344108 feat(cli): a line_unread finding carries the frames it measured around where the line was first read (#7294)
* feat(cli): a line_unread finding carries the frames it measured around where the line was first read

* style(cli): shorten the measured field's comment

* feat(cli): measured frames at both ends of the line, with fewer comment lines
2026-11-06 04:09:52 +00:00
Miguel Ángel b4cc674f7f chore: release v0.9.19 (#7290) v0.9.19 2026-11-06 03:19:54 +00:00
Miguel Ángel b56e2c0366 fix(cli): a font missing from this computer no longer stops a cloud render, and is named (#7287)
* fix(cli): a font missing from this computer no longer stops a cloud render, and is named

* style(cli): format the font preflight files and trim two new comments

* style(cli): the embedSystemFonts doc fits in two lines
2026-11-06 02:10:06 +00:00
Miguel Ángel 6abc62a179 fix(core): a render lands where preview does when a set interrupts a tween (#7283)
* fix(core): a render lands where preview does when a set interrupts a tween

* fix(core): the settling helper carries no comment, its name says it
2026-11-06 01:40:40 +00:00
Miguel Ángel cbe5dcb2d2 chore: release v0.9.18 (#7270) v0.9.18 2026-11-06 01:14:12 +00:00
James RussoandClaude Opus 5.5 5259fd1120 chore(ci): close PRs and needs-info issues after three weeks without activity (#7280)
Mark stale at 14 days, close 7 days later. Drafts, keep-open, and Renovate
PRs (now labeled dependencies) are exempt, since closing a Renovate PR makes
it skip that update.

Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-11-06 00:42:34 +00:00
Miguel Ángel 72326a3ac7 fix(cli): a render's lint runs at normal priority, so a busy Windows PC no longer stalls it (#7268) 2026-11-05 23:09:58 +00:00
Miguel Ángel 4935d6736b fix(cli): normalize-audio says where the target stays when a limit holds its gain (#7267)
* fix(cli): normalize-audio says where the target stays when a limit holds its gain

* fix(cli): normalize-audio held line counts the clip's data-volume in both modes

* style(cli): format the normalize-audio held-line change
2026-11-05 21:07:47 +00:00
Miguel Ángel 256b84a41b fix(core): check's no-draw seeks no longer upload graded images to the GPU (#7264) 2026-11-05 20:44:35 +00:00
Vance IngallsandClaude Opus 5.5 32eb4c3582 chore: release v0.9.17 (#7260)
* chore: release v0.9.17

* chore(producer): raise the unpacked size budget for windowed video frames

The new modules and this version bump put the unpacked package 49 bytes
past the 1% tolerance. No tests or source maps are in the tarball.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
v0.9.17
2026-11-05 12:00:52 -08:00
Vance IngallsandClaude Sonnet 5.5 968f97fe95 feat(producer): render long videos with windowed source frames behind a flag (#7242)
* feat(producer): render long videos with windowed source frames, behind HF_VIDEO_FRAME_WINDOW

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(producer): windowed calibration sees real frames, and the late full extraction reports itself

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(producer): windowed frames match a full extraction, frame for frame

Renders ten compositions twice on the segmented route, with and without
HF_VIDEO_FRAME_WINDOW, and compares FFmpeg framemd5 of the two outputs: a
mid-clip start, NTSC 24000/1001, a loop crossing a slice edge, a playback-rate
ramp, a held tail, two clips of one file, a VFR source beside a CFR one, two
workers, auto workers (capture calibration runs), and motion blur, which
declines the window. Each pair must also report the same capture mode.

A separate test samples segment-frames during a four-segment, two-worker
render and holds its peak under workers x segment frames x the largest frame
file x 1.2, and checks the folder is empty once the render closes.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* test(producer): windowed frames test finds its own work dir and asserts what it claims

Find the render's work dir with resolveRenderWorkDirPrefix and the owner record's pid, so
the peak test works on Linux and never samples or deletes a concurrent render's dir.
Assert the measured worker count, calibration, and the exact up-front frame count of the
VFR video. Retry a dead Chrome only with HF_TEST_RETRY_BROWSER_STALL=1, and fail a case
whose windowed render alone needed it.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* fix(producer): windowed segments honour keep-segments and cleanup never fails a render

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* refactor(producer): trim the comments the windowed frames route added

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(producer): the VFR-beside-CFR extraction test moves to the integration lane

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(producer): raise the package size budget for windowed video frames

The new segment frame modules add about 9 KB to the packed producer package.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(producer): windowed frames header says what the real runs measured

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 11:27:10 -08:00
Miguel Ángel 478ef2f26e fix(cli): check judges SVG gradient text by its gradient stops, not as black (#7258) 2026-11-05 19:03:31 +00:00
Miguel Ángel 7290ee68c3 fix(engine): name a failed script's origin and error before the free text of its warning (#7256) 2026-11-05 18:51:19 +00:00
Miguel Ángel 2f2195515b fix(cli): normalize-audio --reference stops short of the peak ceiling instead of refusing (#7254)
* fix(cli): normalize-audio --reference stops short of the peak ceiling instead of refusing

* docs(cli): the README says normalize-audio stops short of the ceilings instead of refusing
2026-11-05 18:47:49 +00:00
Miguel Ángel 8df4f21c20 fix(producer): segmented and sequential capture check drawElement samples (#7255)
* fix(producer): segmented capture checks drawElement frames against their screenshots

* fix(producer): streaming sequential loop checks drawElement samples too
2026-11-05 18:43:59 +00:00
Vance IngallsandClaude Opus 5.5 599eaad2ba feat(producer): a capture segment extracts the frames it shows and deletes them (#7241)
* feat(producer): a capture segment extracts the frames it shows and deletes them when it closes

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(producer): the windowed video hook reads its own frames outside a prepared window

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* refactor(producer): trim the comments the segment video frames hook added

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 10:53:17 -08:00
Vance IngallsandClaude Opus 5.5 35cbca9927 refactor(producer): deferred frame extraction moves out of the distributed code (#7240)
* refactor(producer): deferred frame extraction moves out of the distributed code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(producer): the real-ffmpeg deferred extraction test moves to the integration lane

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 09:45:12 -08:00
Miguel Ángel b108f85120 fix(core): two scenes drawing SVGs with the same ids each show their own (#7251)
* fix(core): two scenes drawing SVGs with the same ids each show their own

* fix(core): the runtime's scene scopes typecheck as mounted scopes
2026-11-05 17:20:51 +00:00
Miguel Ángel f98218a224 fix(cli): end a stalled cloud upload and send it again (#7237)
* fix(cli): end a stalled cloud upload after 60 s and send it again up to three times

* fix(cli): bound the in-memory project zip upload by progress like a file, watch the socket

* refactor(cli): split the upload retry and stall watch into small functions
2026-11-05 17:07:59 +00:00
Miguel Ángel 600bfa451b fix(core): decode WebKit sources by memory budget, not by length (#7232) 2026-11-05 16:53:59 +00:00
Miguel Ángel 5377b756b5 fix(core): snapshot and preview show a clip on the frame render shows it (#7238)
* fix(core): snapshot and preview show a clip on the frame render shows it

* fix(cli): snapshot pulls a video's frame on the same on-screen rule

* refactor(cli): drop two doc lines the names already carry
2026-11-05 16:21:24 +00:00
Miguel Ángel d40d0b251f fix(producer): an export over the peak ceiling loses only what it must (#7246)
* fix(producer): an export over the peak ceiling loses only what it must

The delivery limiter cut every peak over -1 dBTP down to -3, a fixed 2 dB margin for its detector. It now limits at -1, measures the encode, and lowers the ceiling only by what that encode measured over.

* fix(producer): the delivery limit test runs in CI and one pass is its own step

* test(producer): build the loudness reference from the 16-bit track the mixer reads
2026-11-05 16:20:28 +00:00
Miguel Ángel a664f99ec8 fix(lint): every selector in a comma list counts as hidden by authored CSS (#7252)
* fix(lint): every selector in a comma list counts as hidden by authored CSS

* fix(lint): keep gsap.ts's comment share where it was

* fix(lint): the transform conflict check reads every selector of a comma list too
2026-11-05 16:16:23 +00:00
Miguel Ángel 0b35598246 fix(core): the bundle's contract check reads a timeline registered in a local script (#7248)
* fix(core): the bundle's contract check reads a timeline registered in a local script

* fix(lint): collectExternalStyles is internal now that linkedSources is the export
2026-11-05 15:48:10 +00:00
Miguel Ángel 644b166e78 fix(cli): check sees an SVG stroke drawing on, so it no longer calls it a dead stretch (#7250) 2026-11-05 15:46:41 +00:00
Miguel Ángel 0a6746e1d6 fix(cli): an unknown command answers in a few lines and says what to run instead (#7247)
* fix(cli): an unknown command answers in a few lines and says what to run instead

* fix(cli): shorten the captions pointer and drop the redirect doc comments

* fix(cli): point the captions hint at the hyperframes skill's guide, and test the path exists

* chore(cli): regenerate the skills manifest for the hyperframes-cli skill edit
2026-11-05 15:35:10 +00:00
Miguel Ángel b7d72c9478 feat(cli): check --budget stops the whole check in time and reports what it found (#7245)
* feat(cli): check --budget stops the whole check in time and reports what it found

* fix(cli): keep check's comment share where it was

* fix(cli): a --budget that runs out before any check step is waiting is not an unhandled rejection
2026-11-05 14:45:30 +00:00
Miguel Ángel c1977fab3e fix(cli): lint says nothing when the OS refuses to lower its priority (#7244) 2026-11-05 14:11:18 +00:00
Miguel Ángel df54f380cb feat(cli): info --media lists every clip the render hears, on the film's clock (#7235)
* feat(cli): info --media lists every clip the render hears, on the film's clock

* fix(cli): info --media leaves out a clip that starts past its media's end

* fix(cli): keep the heard-clips doc line within 120 characters
2026-11-05 14:09:22 +00:00
Miguel Ángel 80e02e74a0 fix(lint): compositions in .hyperframesignore no longer count as the project's (#7239)
* fix(lint): compositions in .hyperframesignore no longer count as the project's

* fix(lint): keep the ignore helper under the package's comment share
2026-11-05 13:18:42 +00:00
Miguel Ángel f55990ebca fix(cli): name the network cause of a failed fetch in the error box (#7236) 2026-11-05 13:08:09 +00:00
Miguel Ángel 5ee9e928d5 fix(core): hlg footage tone-maps to sdr at the bt.2408 reference white (#7234)
* fix(core): hlg footage tone-maps to sdr at the bt.2408 reference white

* fix(core): an HLG clip whose stream leaves its transfer unset keeps HLG's white

An SPS with an unspecified transfer takes the stream's tag, as its frames do; a failed keyframe read is not cached; the grey test needs ffmpeg 8.
2026-11-05 13:04:56 +00:00
Miguel Ángel 45705fa25c chore: release v0.9.16 (#7230)
* chore: release v0.9.16

* chore: format v0.9.16 release notes

* chore: add #7228 and #7231 to v0.9.16 notes

* chore: add #7217 #7224 #7225 #7226 #7229 #7233 to v0.9.16 notes
v0.9.16
2026-11-05 13:03:33 +00:00
WaterrrForeverandClaude Opus 5.5 5f7b85c5d7 fix(cli): billing re-reads the account on Enter and sells nothing it can't price (#7226)
Two holes in `billing subscribe` / `billing add-credits`:

- After paying on the pricing page, "Press Enter to pay" was still waiting. Pressing it before the
  next 2-second poll opened a second Stripe checkout. Enter now reads the plan again: nothing opens
  when the page has already covered it, and a partial top-up on the page is priced from the new
  balance.
- One failed first plan read made the account look like Free with 0 credits: it offered Pro to a
  Pro account and priced add-on credits for the whole run, not the shortfall. The first read is
  retried; if the plan still can't be read, no terminal checkout opens and the page finishes it.


Claude-Session: https://claude.ai/code/session_01HebQXN7wsMK6GqT3MNtqXw

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 12:05:26 +00:00
Miguel Ángel 2af37ac0c3 fix(engine): read a video's length from its packets when headers state none (#7233)
* fix(engine): read a video's length from its packets when its headers state none

* fix(engine): ignore the cut first line of a long packet scan and count N/A as a frame

* chore(engine): trim the packet scan comments and put its doc back on the function

* style(engine): format the packet duration test
2026-11-05 11:53:45 +00:00
Miguel Ángel 216395e98e fix(cli): every settings file follows HYPERFRAMES_CONFIG_DIR (#7229)
* fix(cli): every settings file follows HYPERFRAMES_CONFIG_DIR

* fix(cli): the media-use skill copy reads its config from HYPERFRAMES_CONFIG_DIR too

* test(cli): expect the config folder as a normalized path on every platform

* chore(skills): refresh the media-use manifest hash

* fix(cli): a moved settings folder starts from ~/.hyperframes, keeping an opt-out

* fix(cli): drop the updater's unused path import

* style(cli): keep the settings-seed comment under 120 characters
2026-11-05 11:34:36 +00:00
Miguel Ángel b7a8cfa73c fix(core): keep long WebKit sources and unloaded clips on the audio clock (#7225)
* fix(core): keep long WebKit sources and unloaded clips on the audio clock

* fix(core): drop the comments the ratchet counts

* fix(core): shorten the decode helper comment
2026-11-05 11:05:51 +00:00
Miguel Ángel ecf0e14387 fix(cli): previews and every per-user cache follow HYPERFRAMES_CACHE_DIR (#7224)
* fix(cli): a preview's session follows HYPERFRAMES_CACHE_DIR when it is set

* docs(cli): background previews follow HYPERFRAMES_CACHE_DIR

* test(cli): unstub the preview test's env in a block body

* test(cli): clear HYPERFRAMES_CACHE_DIR in the CLI's test home

* fix(cli): registry cache, search model, catalog and catch-up follow HYPERFRAMES_CACHE_DIR

* style(cli): format the media search cache test

* test(cli): compare the model path against an absolute cache folder on Windows too

* fix(cli): both catalog readers treat an empty HYPERFRAMES_CATALOG_ARTIFACT_DIR as unset
2026-11-05 10:56:35 +00:00
Jerrai 0180c603d1 fix(producer): resolve template sub-composition entries in the shared compile stage (#7217)
The distributed planner compiled the raw entry file, so a <template>-wrapped
sub-composition rendered alone had no live root, timeline or duration and failed
with "Composition has zero duration". Entry resolution now lives in
runCompileStage, which both the in-process renderer and plan() call.

— Jerrai
2026-11-05 09:45:19 +00:00
Miguel Ángel b96d3c8bd6 fix(core): a multi-worker render replays overlapping tweens behind the timeline stand-in (#7231)
* fix(core): a multi-worker render replays overlapping tweens behind the timeline stand-in

The overlap and landing-mark walks compared tween parents with the stand-in the producer's GSAP stub hands out, never met it, and lost the overlaps and step times. Both now compare with the real timeline behind the stand-in.

* fix(core): drop the moved helper's comment so the file's comment share holds
2026-11-05 09:39:37 +00:00
Miguel Ángel 659ef568d7 fix(producer): export sizes an unsized phone video as it plays, not as stored (#7228)
* fix(producer): export sizes an unsized phone video as it plays, not as stored

* fix(engine): keep the stored-size check on the video layer path
2026-11-05 09:35:36 +00:00
Miguel Ángel ada71da92d fix(cli): capture takes a refused screenshot once more before naming it (#7222)
* fix(cli): capture takes a refused screenshot once more before naming it

* fix(cli): keep the screenshot retry's doc to one line

* test(cli): refuse the same capture shot twice now that one refusal is retried
2026-11-05 08:19:17 +00:00
WaterrrForeverandClaude Opus 5.5 7bebcb9fcb fix(skills): reword the billing lines the Snyk audit reads as hiding cost (#7218)
Behaviour is unchanged: on Free the plans page opens straight away, a
mid-run shortfall goes to add-on credits for the run's total, and cost is
never brought up unprompted. Lines like "without asking or naming a price"
and "never tell the person prices" read as hiding cost, so the skills now
say the page shows the price and payment happens only there, by the
person, and that cost is not volunteered.


Claude-Session: https://claude.ai/code/session_01HebQXQjEiSeVmhvTbJvSAw

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 08:11:50 +00:00
Miguel Ángel 18513d46d2 fix(studio-server): the cancel route replies once the adapter's stop has settled (#7221)
* fix(studio-server): the cancel route replies once the adapter's stop has settled

* fix(studio-server): shorten the cancel route comments

* fix(studio-server): drop the added cancel comments so the comment share stays down

* fix(studio-server): the cancel route clears its timer when the stop throws
2026-11-05 08:00:38 +00:00
James RussoandClaude Opus 5.5 b98718fe93 fix(engine): report a pending setup as a setup timeout, not zero duration (#7211)
* fix(engine): headline a pending setup as a setup timeout, not zero duration

When the runtime never reaches render-ready, __hf.duration reads 0 because
the bridge masks it, so pollHfReady's timeout reported "Composition has zero
duration" even for compositions with a declared data-duration whose
window.__hf.buildReady promise was still pending. Headline that case as
"Composition setup did not finish within <timeout>ms", skip the duration
inference hint that cannot apply yet, and note that the render clock stays
at 0 until the first frame. Keep its transient retry classification and give
it its own CLI diagnostic code.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* fix(engine): name animation frames in the setup-timeout hint

Setup that awaits requestAnimationFrame hits the same render-clock rule as
setup that waits on Date or performance.now: frames only fire on a seek, and
the first seek waits for setup. Say so, and point at the waits that work.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* fix(engine): stop suggesting scheduler.yield() for setup waits

Chrome runs scheduler.yield() continuations ahead of ordinary tasks, so a
setup loop that polls with it starves the setTimeout-driven work it waits on
(Three's compileAsync polls with setTimeout(10)) and never finishes. Plain
headless Chrome 152 hangs on a ten-line page that does exactly that. Point
authors at setTimeout and say why yield-polling does not work.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* fix(engine): point setup waits at the library's readiness promise

HyperFrames guidance is no system timers, so the hint should not tell authors
to wait with setTimeout. Point them at the library's own readiness promise
(Three.js renderer.compileAsync) and keep the warning about scheduler.yield()
polling loops.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* fix(engine): keep the setup-timeout hint to what it can diagnose

A scheduler.yield() polling loop starves the page, so the readiness poll never
returns and the render reports a capture stall instead of this message. Drop
that sentence; the hint covers animation-frame and clock waits only.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-11-05 07:41:04 +00:00
Miguel Ángel 7050b9b5bb fix(studio-server): a refused cut says which way it was refused (#7212) 2026-11-05 07:05:25 +00:00
Miguel Ángel d810bdbb27 fix(cli): init no longer crashes copying into a folder at a Windows drive root (#7220)
* fix(cli): init no longer crashes copying into a folder at a Windows drive root

* fix(cli): keep copyDirSync's comment to one line
2026-11-05 07:00:55 +00:00
James RussoandClaude Opus 5.5 d452a6fad4 feat(registry): add path-traced-3d example with raster preview and path-traced export (#7219)
* feat(registry): add path-traced-3d example with raster preview and path-traced export

An opt-in Three.js starter: previews with raster rendering and exports with
three-gpu-pathtracer, from one scene file. three 0.180.0, three-gpu-pathtracer
0.0.24 and three-mesh-bvh 0.9.5 ship as one local, pinned ES module with their
licences and a rebuild recipe, so renders make no network requests and 2D
projects never load the tracer.

Setup is one buildReady promise that awaits library readiness promises only
and ends with a throwaway frame and a one-pixel readback. Frames are drawn in
the hf-seek listener through waitUntil, each time from zero with a fixed
sample count. Math.random is seeded while the scene and tracer are built,
because object ids order light sampling and the tracer's noise textures come
from it.

Adds a skill reference and a docs guide for the setup and seek contract, the
frozen clock, why scheduler.yield() waits hang, and sample/bounce cost.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* fix(registry): list path-traced-3d in CLI docs and tighten its notes

Add the example's section to the CLI examples doc, which docs.test.ts
requires for every registry example. Throw if the tracer reports compiling
but exposes no compile promise, instead of spinning renderSample(). Say that
three's object uuids set the tracer's sort order, that later-created objects
need the seed too, and that Date and performance.now read the current seek
time during a render rather than staying at 0.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-11-05 06:40:37 +00:00