feat(examples): Tree Lab, Citrus, forest and unified world demos

[charlieforward9]

Add native Tree Lab, Citrus, 10K/20K forest and geographic world examples and website entries. The world demo uses the unified public TreeLayer, flat accessors and explicit budgets.

Pause wind at the rendered clock, preserve offscreen specimen poses and Forest wind phase across hidden tabs without rebuilding wind-off inventories, resume the Tree Lab, Citrus and Forest tours without advancing through pauses or hidden-tab intervals, refresh current sunlight when wind-off specimens re-enter, use one sunlight model for cycling and manual control, retain cycled sunlight across shadow toggles, frame large single-species grids with their computed pullback zoom and keep film startup errors visible after cleanup. World measurements count every completed draw independently of frame intervals and abort on renderer errors. Benchmark errors reject samples; closing cancels idle timers, camera animation callbacks and queued repeated samples. Actual winter ground pixels verify partial wood coverage, and a resumed timeline update verifies that hidden wall time is excluded.

The forest control fixture retains all 20K source rows and highest native geometry with a bounded logical viewport/framebuffer, 128-pixel shadow maps and fewer than 256 wood casters in the grazing close view with shadows enabled only after entering that view, then restores full-inventory framing for all four seasons; production maps retain their 1024-pixel default and full-resolution receiver tests cover shadow pixels; dedicated lab tests assert actual pixels. The all-species ownership fixture retains all sixteen renderers at 160 by 120 pixels; separate species cases retain full-size pixel checks. The wind-clock control fixture uses a bounded real view, stops automatic raster work after the live pose exists and explicitly renders its frozen source before testing engine-time updates. World UI/report fixtures retain real Deck/tiled TreeLayer with empty source pages; separate source and rendering contracts verify streamed data and pixels.

Base: #806. #809 migrates Seasonal Farm and removes the legacy three workspace. #815 remains independent from #814.

Final integration validation: immutable install, lint, package build, strict public/example types, production example bundles and website build pass. All 1,128 Node tests and 22 renderer browser contracts pass. All 28 Tree Lab, Citrus, forest and world application cases pass across the full-suite and focused final-fixture reruns. Renderer tests require software WebGPU and exercise both sorted backends.

Ordinary headless CI explicitly uses software WebGL on GitHub runners. The same provider passed all three forest cases locally; the dedicated required-adapter lane continues to verify WebGPU separately.

Stack graph:

flowchart TD
  M[master] --> A["#807 prepared Composite SplatLayer"]
  A --> B["#814 shared static/RAD scenes"]
  B --> C["#794 native TreeLayer"]
  C --> D["#806 unified inventories"]
  D --> E["#808 tree examples"]
  E --> F["#809 migration / three removal"]
  B --> G["#815 independent Coit"]
  L["luma 9.4-release"] --> H["luma #3398 host/RAD support"]
  H -. compatible release .-> B

Loading

Full stack record.

[github-actions]

Coverage

Stmts: 40.21% ▲+6.76% | Branch: 31.30% ▲+7.10% | Funcs: 33.52% ▲+5.48% | Lines: 39.71% ▲+6.33%

Test Files 136 passed (136)

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[greptile-apps]

Confidence Score: 5/5

[Low risk] Adds example applications and documentation for tree rendering.

The changes since the previous review appear safe to merge.

What we checked:

• Required WebGPU checks stay separate: No. REQUIRE_WEBGPU is checked first. When enabled, Chrome still receives the flags that select the SwiftShader WebGPU adapter.

Summary

Adds Tree Lab, Citrus Lab, forest and synthetic world demos, website entries, comparison recordings and browser checks.

• The change since the previous review explicitly uses SwiftShader for WebGL in GitHub Actions.
• The separate adapter-required WebGPU configuration remains unchanged.
• No new actionable issues were found.

_{Reviews (21) · Last reviewed commit: "test: use explicit software WebGL for he..." · Reviewed by Greptile}

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit aaad10c. Configure here.}