charlieforward9 · Oct 5, 2026 · Oct 5, 2026 · Oct 5, 2026 · Oct 5, 2026 · Oct 5, 2026
diff --git a/README.md b/README.md
@@ -16,10 +16,9 @@ An awesome list of community-driven modules, integrations, and tools built with
 | **[arrow-layers](./modules/arrow-layers)**       | [![npm](https://img.shields.io/npm/v/@deck.gl-community/arrow-layers.svg)](https://www.npmjs.com/package/@deck.gl-community/arrow-layers)       | Apache Arrow visualization layers — render large columnar datasets directly on the GPU.        |
 | **[editable-layers](./modules/editable-layers)** | [![npm](https://img.shields.io/npm/v/@deck.gl-community/editable-layers.svg)](https://www.npmjs.com/package/@deck.gl-community/editable-layers) | Interactive drawing and editing layers for geospatial features.                                |
 | **[geo-layers](./modules/geo-layers)**           | [![npm](https://img.shields.io/npm/v/@deck.gl-community/geo-layers.svg)](https://www.npmjs.com/package/@deck.gl-community/geo-layers)           | Suite of geospatial layers covering tile formats, terrain, and more.                           |
-| **[layers](./modules/layers)**                   | [![npm](https://img.shields.io/npm/v/@deck.gl-community/layers.svg)](https://www.npmjs.com/package/@deck.gl-community/layers)                   | Additional community-contributed layers not yet in the official deck.gl release.               |
+| **[layers](./modules/layers)**                   | [![npm](https://img.shields.io/npm/v/@deck.gl-community/layers.svg)](https://www.npmjs.com/package/@deck.gl-community/layers)                   | Additional community-contributed layers, including the native procedural `TreeLayer`.               |
 | **[infovis-layers](./modules/infovis-layers)**   | [![npm](https://img.shields.io/npm/v/@deck.gl-community/infovis-layers.svg)](https://www.npmjs.com/package/@deck.gl-community/infovis-layers)   | Information visualization layers for non-geospatial, chart-style rendering.                    |
 | **[graph-layers](./modules/graph-layers)**       | [![npm](https://img.shields.io/npm/v/@deck.gl-community/graph-layers.svg)](https://www.npmjs.com/package/@deck.gl-community/graph-layers)       | Graph and network visualization layers for deck.gl.                                            |
-| **[three](./modules/three)**                     | [![npm](https://img.shields.io/npm/v/@deck.gl-community/three.svg)](https://www.npmjs.com/package/@deck.gl-community/three)                     | Three.js-backed layers for deck.gl, including a fully parametric 3D `TreeLayer`.               |
 | **[widgets](./modules/widgets)**                 | [![npm](https://img.shields.io/npm/v/@deck.gl-community/widgets.svg)](https://www.npmjs.com/package/@deck.gl-community/widgets)                 | UI widgets (pan, zoom range, etc.) that integrate with deck.gl view state management.          |
 | **[react](./modules/react)**                     | [![npm](https://img.shields.io/npm/v/@deck.gl-community/react.svg)](https://www.npmjs.com/package/@deck.gl-community/react)                     | React components and hooks for building deck.gl applications.                                  |
 | **[react-fiber](./modules/react-fiber)**         | [![npm](https://img.shields.io/npm/v/@deck.gl-community/react-fiber.svg)](https://www.npmjs.com/package/@deck.gl-community/react-fiber) | React Fiber renderer for composing deck.gl layers and views as React elements.                 |

diff --git a/docs/modules/layers/README.md b/docs/modules/layers/README.md
@@ -32,6 +32,8 @@ Release date: 2023
 
 ## Exports
 
+- [`TreeLayer`](./api-reference/tree-layer.md) (WebGL2 and WebGPU)
+
 - [`FlameTrailLayer`](./api-reference/flame-trail-layer.md) (WebGL2 and WebGPU)
 - `DependencyArrowLayer`
 - `PathMarkerLayer`
@@ -45,6 +47,8 @@ Release date: 2023
 
 ## Examples
 
+- [Tree Lab](/examples/layers/tree-lab)
+
 - [FlameTrailLayer](/examples/layers/flame-trail)
 - [Path outline, marker, and dependency arrow](/examples/layers/path-outline-and-markers)
 - [SkyboxLayer MapView](/examples/layers/skybox-map-view)

diff --git a/docs/modules/layers/api-reference/tree-layer.md b/docs/modules/layers/api-reference/tree-layer.md
@@ -0,0 +1,62 @@
+# TreeLayer
+
+An instanced, procedural tree layer built entirely with deck.gl, luma.gl and math.gl. Five species share cached CPU meshes; winter deciduous trees expose branching crowns. Trunks and crowns always use the highest-quality geometry. No Three.js runtime dependency is required.
+
+```ts
+import {TreeLayer} from '@deck.gl-community/layers';
+
+new TreeLayer({
+  data: trees,
+  getPosition: tree => tree.position,
+  getTreeType: tree => tree.species,
+  getHeight: tree => tree.height,
+  getSeason: () => 'summer',
+  windStrength: 0.025,
+  pickable: true
+});
+```
+
+Try [Tree Lab](/examples/layers/tree-lab) for synchronized original/native specimens of every species, seasonal controls, supplied crop points, shadows and wind.
+
+## Properties
+
+Inherits the deck.gl `CompositeLayer` properties. Accessors are functions of the source data object.
+
+| Property | Default | Meaning |
+| --- | --- | --- |
+| `getPosition` | `d => d.position` | Longitude/latitude position of the tree base; the host coordinate system also supports local coordinates. |
+| `getElevation` | `() => 0` | Base elevation in metres. |
+| `getTreeType` | `() => 'pine'` | `pine`, `oak`, `palm`, `birch` or `cherry`. |
+| `getHeight` | `() => 10` | Total nominal height in metres. |
+| `getTrunkHeightFraction` | `() => 0.35` | Trunk fraction, clamped to 0–1. Palm shafts extend into the crown. |
+| `getTrunkRadius` | `() => 0.5` | Trunk base radius in metres. |
+| `getCanopyRadius` | `() => 3` | Horizontal canopy scale, retaining the legacy approximate half-scale broadleaf radius. Palms and pines have their own silhouette envelopes. |
+| `getTrunkColor` | `() => null` | Explicit bark color or the species default. |
+| `getCanopyColor` | `() => null` | Explicit foliage color or the species/season default. Winter branches use bark color. Vertex tones multiply this color. |
+| `getSeason` | `() => 'summer'` | `spring`, `summer`, `autumn` or `winter`. Winter removes deciduous foliage; pine and palm remain evergreen. |
+| `getBranchLevels` | `() => 3` | Pine tier count, rounded and clamped to 1–5. |
+| `getCrop` | `() => null` | Explicit crop configuration; the layer never invents seasonal yield. |
+| `sizeScale` | `1` | Multiplier for tree and crop dimensions. |
+| `windStrength` | `0` | Bend amplitude as a fraction of tree height. Zero stops continuous redraw; a value around `0.025` is a gentle breeze. |
+| `windTime` | `null` | Wind time in seconds. `null` uses deck.gl's timeline; a number freezes the pose for controlled comparisons. |
+| `shadowEnabled` | `true` | Cast shadows when enabled by the host `LightingEffect`. |
+
+## Crops
+
+`CropConfig` has `color`, `count`, `radius` and optional `droppedCount`. Radius is the actual sphere radius in metres. Counts are explicitly supplied, rounded down and clamped at zero. Broadleaf crops follow the shared outer crown envelope; palm crops cluster beneath the crown. Dropped spheres rest on the ground. Positions are deterministic, remain stable when counts grow, and picking returns the owning source tree. Attached crops share the tree's GPU bend; dropped crops remain still.
+
+## Animation and shadows
+
+Wind is implemented in GLSL and WGSL. Trunks, crowns, attached crops, picking and WebGL shadow passes use the same deformation. Time changes do not rebuild geometry, regroup data or regenerate instance attributes.
+
+For WebGL shadows, supply a deck.gl `LightingEffect` with a `DirectionalLight` whose `_shadow` option is enabled, and a receiving ground surface. Shadows are an extra rendering pass. WebGPU shadow effects are not supported by deck.gl; Tree Lab disables that control on WebGPU.
+
+## Migration
+
+Remove `detail` from TreeLayer props and `TreeDetail` from type imports. Trunks and crowns now always use the former high-detail meshes. Legacy demo `detail` query parameters are ignored.
+
+The legacy `@deck.gl-community/three` package has been removed from this repository. Replace its imports with `@deck.gl-community/layers`, including `TreeLayerProps`, `TreeType`, `Season` and `CropConfig`. Previously published package versions are unchanged. Three.js is used only by Tree Lab's frozen development fixture.
+
+Native crowns and winter silhouettes deliberately differ from the original geometry. `CropConfig.radius` now matches its documented radius: older geometry rendered half that radius. Halve an existing crop radius to retain its old apparent size. Inspect your explicit seasonal foliage overrides, canopy sublayer overrides and custom winter branches when migrating; the native crown sublayer IDs include foliage/winter and tier information. Legacy species overrides such as `canopy-cherry` remain supported and apply after native defaults. Exact grouped sublayer IDs take precedence over species aliases. Override accessors receive the source tree and its original accessor context; parameters and update triggers merge by key.
+
+[Source](https://github.com/visgl/deck.gl-community/tree/master/modules/layers/src/tree-layer)
diff --git a/docs/modules/layers/sidebar.json b/docs/modules/layers/sidebar.json
@@ -7,6 +7,7 @@
     "modules/layers/api-reference/skybox-layer",
     "modules/layers/api-reference/dependency-arrow-layer",
     "modules/layers/api-reference/path-marker-layer",
-    "modules/layers/api-reference/path-outline-layer"
+    "modules/layers/api-reference/path-outline-layer",
+    "modules/layers/api-reference/tree-layer"
   ]
 }
diff --git a/docs/modules/three/README.md b/docs/modules/three/README.md
diff --git a/docs/modules/three/api-reference/tree-layer.md b/docs/modules/three/api-reference/tree-layer.md
diff --git a/docs/modules/three/sidebar.json b/docs/modules/three/sidebar.json
diff --git a/docs/upgrade-guide.md b/docs/upgrade-guide.md
@@ -6,6 +6,17 @@ Please refer the documentation of each module for detailed upgrade guides.
 
 ## Unreleased
 
+- Remove `detail` from `TreeLayer` props and `TreeDetail` from type imports. Trunks and crowns
+  always use the former high-detail meshes; legacy demo `detail` query parameters are ignored.
+
+- The `@deck.gl-community/three` compatibility package has been removed from the repository.
+  Replace its imports with `@deck.gl-community/layers`, including `TreeLayer`, `TreeLayerProps`,
+  `TreeType`, `Season` and `CropConfig`. Previously published versions are unchanged.
+  Existing TreeLayer documentation and Seasonal Farm URLs redirect to their new locations.
+  `CropConfig.radius` now renders the actual radius in metres; halve an existing radius to keep
+  its old apparent size. Review changed crowns, winter branches and canopy sublayer overrides
+  against the [TreeLayer migration notes](./modules/layers/api-reference/tree-layer.md#migration).
+
 ### `@deck.gl-community/editable-layers`
 
 Edit modes now consistently accept `SimpleFeatureCollection`, which supports Point,

diff --git a/docs/webgpu.md b/docs/webgpu.md
@@ -42,7 +42,7 @@ deck.gl-community is adding WebGPU support incrementally while continuing to sup
 | `@deck.gl-community/editable-layers` | GeoJSON paths, polygons, and edit handles | ✅ | ✅ | Browser-verified `EditableGeoJsonLayer` rendering in `ModifyMode`, including the WebGPU picking-width shader path. |
 | `@deck.gl-community/editable-layers` | Editing and selection interactions | ✅ | 🚧 | Pointer, drag, snapping, and selection behavior still require browser interaction coverage on WebGPU. |
 | `@deck.gl-community/basemap-layers` | `BasemapLayer` | ✅ | 🚧 | Support depends on the selected style's polygon, path, and label sublayers. |
-| `@deck.gl-community/three` | `TreeLayer` | ✅ | ✅ | Browser-verified procedural Three.js geometry rendered through upstream `SimpleMeshLayer`. |
+| `@deck.gl-community/layers` | `TreeLayer` | ✅ | ✅ | Native vis.gl meshes and GLSL/WGSL wind through `SimpleMeshLayer`. deck.gl shadow effects remain WebGL2-only. |
 | `@deck.gl-community/leaflet` | Leaflet map overlay | ✅ | ❌ | A host-owned WebGL context cannot be switched to WebGPU. |
 | `@deck.gl-community/bing-maps` | Bing Maps overlay | ✅ | ❌ | A host-owned WebGL context cannot be switched to WebGPU. |
 | `@deck.gl-community/widgets` | `DeviceManagerController` and `DeviceTabsWidget` | ✅ | ✅ | Selects and attaches an independently managed real rendering device. |