feat(layers): native procedural TreeLayer

[charlieforward9]

Render native procedural tree wood and prepared splat crowns through deck.gl layers. Species geometry, canopy materials, wind, seasons and optical/shadow selection preserve owner picking and sparse-root coverage without a separate Three renderer.

Batch wood/canopy submissions and share canopy grants across species. Explicit type accessors retain species dimensions, null hierarchy overrides preserve fallback behavior, and banyan aerial roots remain on valid branch sockets. Keep full geometry checks under coverage; shadow pixel contracts isolate shadow behavior from unrelated refinement cost.

Visible wood receives shadows; separate light-space refinement children own shadow casting in ordinary LightingEffect. Wood coverage runs before host depth-only shortcuts, and constant coverage changes invalidate derived attributes, preserving fractional wood shadows without manual triggers.

Base: #814. #806 adds unified supplied-row and inventory-streaming input.

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.

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: 39.99% ▲+6.54% | Branch: 31.18% ▲+6.98% | Funcs: 33.53% ▲+5.49% | Lines: 39.49% ▲+6.11%

Test Files 135 passed (135)

[greptile-apps]

Confidence Score: 5/5

[Medium risk] Adds a new procedural tree rendering layer to the layers module.

The PR appears safe to merge based on this review; no new actionable issue or outstanding previous finding remains.

Summary

The PR replaces the Three.js-backed TreeLayer with a native deck.gl renderer and keeps a compatibility import in @deck.gl-community/three.

• Adds procedural wood, Gaussian foliage, species traits, crops, wind, picking, refinement, and shadow composition.
• Adds public types, documentation, playground schemas, and renderer tests.
• The latest changes move WebGL wood coverage into an early shader hook and invalidate derived coverage attributes when constant props change.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  A[Tree data and accessors] --> B[TreeLayer]
  B --> C[Prepared species and owner groups]
  C --> D[TreeWoodLayer]
  C --> E[SplatLayer foliage]
  C --> F[TreeMeshLayer crops]
  D --> G[Camera and light-space wood children]
  E --> H[Shared canopy and shadow budgets]

Loading

_{Reviews (29) · Last reviewed commit: "Invalidate derived wood attributes when ..." · Reviewed by Greptile}

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[greptile-apps]

Comments Outside Diff

These findings could not be posted inline.

•  Shadow image has wrong format website/static/videos/tree-lab-shadows.png:1 ▶

  The new shadow comparison is JPEG data saved as tree-lab-shadows.png, and the review document links to it as a PNG. Browsers may display it, but tools that rely on the extension or require a PNG signature cannot process it as a PNG. Save it as PNG, or rename it as a JPEG and update the link.

[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 1 potential issue.

^{❌ 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 d3ba115. Configure here.}