@3driseai/3drise-viewer 0.1.41 → 0.1.43

package/dist/components/vegetation/core/bush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bush.d.ts","sourceRoot":"","sources":["../../../../src/components/vegetation/core/bush.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkLnB,CAAC;AAIF,wBAAgB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAqC;AAEnE,wBAAgB,WAAW,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA,EAAE,IAAI,KAAA,QAcrC;AAaD,+GAA+G;AAC/G,wBAAgB,aAAa,CAAC,CAAC,KAAA,OAU9B;AAED,wBAAgB,KAAK,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwFzB;AAED,8GAA8G;AAC9G,eAAO,MAAM,UAAU,UAAwE,CAAC"}

package/dist/components/vegetation/core/bush.js

@@ -0,0 +1,376 @@
+// Emitted from Claude outputs/vegetation-lab/bush.mjs by gen_family.mjs — edit the lab module and re-emit.
+// vegetation/core/bush — Bush (type 'vegetation', config.type 'bush'). Shared core: ../vegetationCore.
+// Construction: the tree's branching model without a trunk — a crown of basal stems rising from one
+// point at the ground, arching under gravity and phototropism, one or two levels of twigs, a dense
+// low canopy of shaped leaves; flower heads (fans of petal cards at the stem tips) and berries at the
+// outer leaves. Species: boxwood, wild shrub, lavender, hydrangea, fern, juniper. Same wind,
+// season and fall as the tree. Size: the unit box = the transform scale.
+import * as THREE from 'three';
+import { mulberry32, setColor, createCommonUniforms, applyCommonConfig, updateCommon, LEAF_TYPES, QUALITY_V, generatePlant, branchGeometry, leafGeometry, fillLeaves, setLeaf, unitBounds, barkMaterial, leafMaterial, fruitMaterial, applyFruitConfig, fruitGeometry, fillFruit, fallingMaterial, plantMesh, plantLod, lodOrder, } from '../vegetationCore.js';
+export const SPECIES = {
+    wildShrub: {
+        leaf: 'broadleaf', bark: '#6b5a42', autumn: ['#d9a21e', '#a8401c'], flower: '#f2f0ff', petals: 5, flowerSize: 0.05,
+        levels: 3, droop: 0.25, twist: 0.5, photo: 0.6,
+        trunk: { length: 0.02, radius: 0.03, taper: 0, segments: 2, flex: 0.1 },
+        level: [
+            { count: 12, length: 30, radius: 0.5, downAngle: 55, downVar: 40, curve: -25, curveVar: 0.8, segments: 6, start: 0 },
+            { count: 5, length: 0.5, radius: 0.55, downAngle: 45, downVar: 40, curve: 15, segments: 4, start: 0.25 },
+            { count: 4, length: 0.5, radius: 0.5, downAngle: 45, downVar: 50, curve: 15, segments: 3, start: 0.15 },
+        ],
+        leaves: { perLength: 70, size: 0.045, sizeVar: 0.4, spread: 0.8, lift: 0.3, fromLevel: 1, tuft: 2, start: 0.1 },
+    },
+    boxwood: {
+        leaf: 'round', bark: '#7a6a50', autumn: ['#9a9a2a', '#7a6a1a'], flower: '#f0e8c0', petals: 4, flowerSize: 0.02,
+        levels: 3, droop: -0.1, twist: 0.6, photo: 0.8,
+        trunk: { length: 0.02, radius: 0.025, taper: 0, segments: 2, flex: 0.05 },
+        level: [
+            { count: 24, length: 22, radius: 0.5, downAngle: 60, downVar: 40, curve: -35, curveVar: 0.6, segments: 5, start: 0 },
+            { count: 6, length: 0.4, radius: 0.55, downAngle: 50, downVar: 40, curve: -10, segments: 3, start: 0.2 },
+            { count: 5, length: 0.45, radius: 0.5, downAngle: 50, downVar: 50, curve: 0, segments: 3, start: 0.1 },
+        ],
+        leaves: { perLength: 110, size: 0.03, sizeVar: 0.3, spread: 0.9, lift: 0.3, fromLevel: 1, tuft: 2, start: 0.1 },
+    },
+    lavender: {
+        leaf: 'lanceolate', bark: '#8a8a70', autumn: ['#9a9a5a', '#7a7a4a'], flower: '#9a7fd6', petals: 7, flowerSize: 0.045,
+        levels: 2, droop: -0.05, twist: 0.3, photo: 1.0,
+        trunk: { length: 0.02, radius: 0.02, taper: 0, segments: 2, flex: 0.1 },
+        level: [
+            { count: 40, length: 30, radius: 0.35, downAngle: 40, downVar: 50, curve: -20, curveVar: 0.8, segments: 6, start: 0 },
+            { count: 3, length: 0.35, radius: 0.5, downAngle: 30, downVar: 30, curve: 0, segments: 3, start: 0.3 },
+        ],
+        leaves: { perLength: 60, size: 0.035, sizeVar: 0.3, spread: 0.6, lift: 0.5, fromLevel: 0, tuft: 2, start: 0.1, faceUp: 0.5 },
+        flowersAlways: 0.9,
+    },
+    hydrangea: {
+        leaf: 'broadleaf', bark: '#7a6a50', autumn: ['#c89a3a', '#9a5a2a'], flower: '#8fb2e6', petals: 4, flowerSize: 0.035, head: 12,
+        levels: 2, droop: 0.2, twist: 0.3, photo: 0.6,
+        trunk: { length: 0.02, radius: 0.03, taper: 0, segments: 2, flex: 0.1 },
+        level: [
+            { count: 16, length: 28, radius: 0.5, downAngle: 45, downVar: 35, curve: -20, curveVar: 0.6, segments: 5, start: 0 },
+            { count: 4, length: 0.4, radius: 0.55, downAngle: 50, downVar: 40, curve: 0, segments: 3, start: 0.3 },
+        ],
+        leaves: { perLength: 40, size: 0.075, sizeVar: 0.3, spread: 0.8, lift: 0.2, fromLevel: 0, tuft: 2, start: 0.15 },
+        flowersAlways: 0.7,
+    },
+    fern: {
+        leaf: 'lanceolate', bark: '#5a6a3a', autumn: ['#a08a3a', '#7a5a2a'], flower: '#ffffff', petals: 0, flowerSize: 0,
+        levels: 1, droop: 1.2, twist: 0.1, photo: 0.4,
+        trunk: { length: 0.02, radius: 0.015, taper: 0, segments: 2, flex: 0.1 },
+        level: [
+            // fronds: arching stipes with pinnae in two ranks
+            { count: 22, length: 32, radius: 0.35, downAngle: 50, downVar: 40, curve: 50, curveVar: 0.5, segments: 8, start: 0 },
+        ],
+        leaves: { perLength: 160, size: 0.06, sizeVar: 0.2, spread: 1.6, lift: -0.1, fromLevel: 0, tuft: 2, start: 0.1, faceUp: 0.6 },
+    },
+    juniper: {
+        leaf: 'needles', bark: '#5a4a3a', autumn: ['#7a7a3a', '#5a5a2a'], flower: '#ffffff', petals: 0, flowerSize: 0,
+        levels: 3, droop: 0.5, twist: 0.5, photo: 0.3,
+        trunk: { length: 0.02, radius: 0.03, taper: 0, segments: 2, flex: 0.05 },
+        level: [
+            { count: 10, length: 36, radius: 0.5, downAngle: 75, downVar: 30, curve: -10, curveVar: 0.8, segments: 6, start: 0 },
+            { count: 6, length: 0.45, radius: 0.55, downAngle: 40, downVar: 40, curve: 0, segments: 4, start: 0.2 },
+            { count: 5, length: 0.45, radius: 0.5, downAngle: 40, downVar: 50, curve: 0, segments: 3, start: 0.1 },
+        ],
+        leaves: { perLength: 110, size: 0.035, sizeVar: 0.3, spread: 1, lift: 0.3, fromLevel: 1, tuft: 2, start: 0.1, faceUp: 0.5 },
+    },
+    rose: {
+        leaf: 'broadleaf', bark: '#5a4a3a', autumn: ['#c89a3a', '#8a5a2a'], flower: '#d8203a', petals: 8, flowerSize: 0.04, head: 1, color: '#3f7a2e', shade: '#1a3a1a',
+        levels: 2, droop: 0.15, twist: 0.5, photo: 0.7,
+        trunk: { length: 0.02, radius: 0.02, taper: 0, segments: 2, flex: 0.1 },
+        level: [{ count: 10, length: 36, radius: 0.5, downAngle: 40, downVar: 40, curve: -15, curveVar: 0.8, segments: 6, start: 0 }, { count: 5, length: 0.4, radius: 0.5, downAngle: 50, downVar: 40, curve: 10, segments: 3, start: 0.25 }],
+        leaves: { perLength: 60, size: 0.045, sizeVar: 0.3, spread: 0.8, lift: 0.2, fromLevel: 0, tuft: 2, start: 0.1 }, flowersAlways: 0.7,
+    },
+    azalea: {
+        leaf: 'lanceolate', bark: '#6a5a4a', autumn: ['#c88a3a', '#8a4a2a'], flower: '#f0407a', petals: 5, flowerSize: 0.04, head: 3, color: '#4f8a3a', shade: '#1e3a1a',
+        levels: 3, droop: 0.1, twist: 0.5, photo: 0.6,
+        trunk: { length: 0.02, radius: 0.025, taper: 0, segments: 2, flex: 0.1 },
+        level: [{ count: 14, length: 26, radius: 0.5, downAngle: 55, downVar: 40, curve: -25, curveVar: 0.7, segments: 5, start: 0 }, { count: 5, length: 0.45, radius: 0.55, downAngle: 50, downVar: 40, curve: 0, segments: 3, start: 0.2 }, { count: 4, length: 0.4, radius: 0.5, downAngle: 50, downVar: 50, curve: 0, segments: 3, start: 0.1 }],
+        leaves: { perLength: 90, size: 0.035, sizeVar: 0.3, spread: 0.9, lift: 0.3, fromLevel: 1, tuft: 2, start: 0.1 }, flowersAlways: 0.9,
+    },
+    holly: {
+        leaf: 'lobed', bark: '#5a5a4a', autumn: ['#3a5a2a', '#2a4a1a'], flower: '#ffffff', petals: 0, flowerSize: 0, color: '#2a5a2a', shade: '#0f2414',
+        levels: 3, droop: 0.0, twist: 0.5, photo: 0.6,
+        trunk: { length: 0.05, radius: 0.03, taper: 0, segments: 2, flex: 0.05 },
+        level: [{ count: 10, length: 16, radius: 0.5, downAngle: 45, downVar: 40, curve: -20, curveVar: 0.7, segments: 5, start: 0 }, { count: 6, length: 0.45, radius: 0.55, downAngle: 50, downVar: 40, curve: 0, segments: 3, start: 0.2 }, { count: 5, length: 0.45, radius: 0.5, downAngle: 50, downVar: 50, curve: 0, segments: 3, start: 0.1 }],
+        leaves: { perLength: 100, size: 0.03, sizeVar: 0.3, spread: 0.9, lift: 0.3, fromLevel: 1, tuft: 2, start: 0.1 }, fruitAlways: 'rosehip',
+    },
+    hibiscus: {
+        leaf: 'broadleaf', bark: '#6a5a4a', autumn: ['#c89a3a', '#8a5a2a'], flower: '#e8203a', petals: 5, flowerSize: 0.07, head: 1, color: '#3f8a2e', shade: '#1a3a1a',
+        levels: 2, droop: 0.1, twist: 0.4, photo: 0.6,
+        trunk: { length: 0.02, radius: 0.025, taper: 0, segments: 2, flex: 0.1 },
+        level: [{ count: 9, length: 36, radius: 0.5, downAngle: 40, downVar: 40, curve: -20, curveVar: 0.8, segments: 6, start: 0 }, { count: 5, length: 0.45, radius: 0.5, downAngle: 50, downVar: 40, curve: 5, segments: 3, start: 0.25 }],
+        leaves: { perLength: 50, size: 0.06, sizeVar: 0.3, spread: 0.8, lift: 0.2, fromLevel: 0, tuft: 2, start: 0.1 }, flowersAlways: 0.5,
+    },
+    bougainvillea: {
+        leaf: 'broadleaf', bark: '#6a5a4a', autumn: ['#c89a3a', '#8a5a2a'], flower: '#e0207a', petals: 3, flowerSize: 0.035, head: 6, color: '#4f8a3a', shade: '#1e3a1a',
+        levels: 3, droop: 0.4, twist: 0.6, photo: 0.4,
+        trunk: { length: 0.02, radius: 0.025, taper: 0, segments: 2, flex: 0.15 },
+        level: [{ count: 10, length: 40, radius: 0.5, downAngle: 45, downVar: 45, curve: -15, curveVar: 1, segments: 7, start: 0 }, { count: 6, length: 0.5, radius: 0.5, downAngle: 50, downVar: 40, curve: 10, segments: 4, start: 0.2 }, { count: 4, length: 0.4, radius: 0.5, downAngle: 45, downVar: 50, curve: 10, segments: 3, start: 0.1 }],
+        leaves: { perLength: 60, size: 0.04, sizeVar: 0.3, spread: 0.8, lift: 0.1, fromLevel: 1, tuft: 2, start: 0.1 }, flowersAlways: 1,
+    },
+    rosemary: {
+        leaf: 'needles', bark: '#7a7a6a', autumn: ['#7a8a5a', '#5a6a4a'], flower: '#9ab0e8', petals: 4, flowerSize: 0.012, head: 1, color: '#5a7a5a', shade: '#2a3a2a',
+        levels: 2, droop: 0.0, twist: 0.3, photo: 0.9,
+        trunk: { length: 0.02, radius: 0.02, taper: 0, segments: 2, flex: 0.1 },
+        level: [{ count: 30, length: 30, radius: 0.4, downAngle: 35, downVar: 50, curve: -15, curveVar: 0.8, segments: 6, start: 0 }, { count: 4, length: 0.4, radius: 0.5, downAngle: 30, downVar: 30, curve: 0, segments: 3, start: 0.3 }],
+        leaves: { perLength: 120, size: 0.025, sizeVar: 0.3, spread: 1, lift: 0.4, fromLevel: 0, tuft: 2, start: 0.1, faceUp: 0.5 }, flowersAlways: 0.4,
+    },
+    sage: {
+        leaf: 'broadleaf', bark: '#8a8a7a', autumn: ['#9a9a6a', '#7a7a5a'], flower: '#7a5ad8', petals: 4, flowerSize: 0.014, head: 4, color: '#8a9a7a', shade: '#3f4f3a',
+        levels: 2, droop: 0.1, twist: 0.3, photo: 0.9,
+        trunk: { length: 0.02, radius: 0.02, taper: 0, segments: 2, flex: 0.1 },
+        level: [{ count: 26, length: 28, radius: 0.4, downAngle: 40, downVar: 50, curve: -15, curveVar: 0.8, segments: 5, start: 0 }, { count: 3, length: 0.4, radius: 0.5, downAngle: 40, downVar: 30, curve: 0, segments: 3, start: 0.3 }],
+        leaves: { perLength: 70, size: 0.04, sizeVar: 0.3, spread: 0.7, lift: 0.4, fromLevel: 0, tuft: 2, start: 0.1 }, flowersAlways: 0.6,
+    },
+    heather: {
+        leaf: 'needles', bark: '#6a5a4a', autumn: ['#8a6a4a', '#6a4a3a'], flower: '#d070b0', petals: 4, flowerSize: 0.008, head: 10, color: '#5a7a4a', shade: '#2a3a2a',
+        levels: 2, droop: 0.0, twist: 0.4, photo: 0.9,
+        trunk: { length: 0.02, radius: 0.015, taper: 0, segments: 2, flex: 0.1 },
+        level: [{ count: 40, length: 28, radius: 0.4, downAngle: 45, downVar: 50, curve: -20, curveVar: 0.8, segments: 5, start: 0 }, { count: 3, length: 0.4, radius: 0.5, downAngle: 30, downVar: 30, curve: 0, segments: 3, start: 0.3 }],
+        leaves: { perLength: 120, size: 0.02, sizeVar: 0.3, spread: 1, lift: 0.4, fromLevel: 0, tuft: 2, start: 0.1, faceUp: 0.5 }, flowersAlways: 0.9,
+    },
+    yucca: {
+        leaf: 'blade', bark: '#7a6a5a', autumn: ['#9a9a6a', '#7a7a5a'], flower: '#f4f0e0', petals: 6, flowerSize: 0.02, head: 12, color: '#4f7a5a', shade: '#1f3a2a',
+        levels: 1, droop: -0.2, twist: 0.05, photo: 1.2,
+        trunk: { length: 0.05, radius: 0.03, taper: 0, segments: 2, flex: 0.02 },
+        level: [{ count: 50, length: 18, radius: 0.3, downAngle: 50, downVar: 40, curve: -20, curveVar: 0.3, segments: 3, start: 0 }],
+        leaves: { perBranch: 1, size: 0.5, sizeVar: 0.2, spread: 0, lift: 0, fromLevel: 0, tuft: 1, start: 0.9, faceUp: 1 }, flowersAlways: 0,
+    },
+    hosta: {
+        leaf: 'broadleaf', bark: '#7a8a5a', autumn: ['#c8b84a', '#8a7a3a'], flower: '#b8a0e0', petals: 6, flowerSize: 0.015, head: 8, color: '#5f9a4a', shade: '#2a4a1f',
+        levels: 1, droop: 0.5, twist: 0.1, photo: 0.6,
+        trunk: { length: 0.02, radius: 0.015, taper: 0, segments: 2, flex: 0.05 },
+        level: [{ count: 28, length: 24, radius: 0.3, downAngle: 55, downVar: 40, curve: 30, curveVar: 0.4, segments: 4, start: 0 }],
+        leaves: { perBranch: 1, size: 0.5, sizeVar: 0.2, spread: 0, lift: 0, fromLevel: 0, tuft: 1, start: 0.95, faceUp: 1 }, flowersAlways: 0,
+    },
+    bamboo: {
+        leaf: 'lanceolate', bark: '#8aa858', autumn: ['#c8b84a', '#9a8a3a'], flower: '#ffffff', petals: 0, flowerSize: 0, color: '#5f9a3a', shade: '#2a4a1f',
+        levels: 2, droop: 0.15, twist: 0.05, photo: 0.3,
+        trunk: { length: 0.02, radius: 0.02, taper: 0, segments: 2, flex: 0.1 },
+        level: [{ count: 14, length: 60, radius: 0.55, downAngle: 8, downVar: 10, curve: 4, curveVar: 0.5, segments: 9, start: 0 }, { count: 12, length: 0.22, radius: 0.3, downAngle: 55, downVar: 30, curve: 10, segments: 3, start: 0.35 }],
+        leaves: { perLength: 90, size: 0.05, sizeVar: 0.3, spread: 0.9, lift: -0.2, fromLevel: 1, tuft: 2, start: 0.2 }, flowersAlways: 0,
+    },
+    camellia: {
+        leaf: 'broadleaf', bark: '#6a5a4a', autumn: ['#8a7a3a', '#6a5a2a'], flower: '#e03a5a', petals: 9, flowerSize: 0.045, head: 1, color: '#2f6a2a', shade: '#102414',
+        levels: 3, droop: 0.0, twist: 0.4, photo: 0.6,
+        trunk: { length: 0.05, radius: 0.03, taper: 0, segments: 2, flex: 0.05 },
+        level: [{ count: 10, length: 18, radius: 0.5, downAngle: 45, downVar: 40, curve: -15, curveVar: 0.7, segments: 5, start: 0 }, { count: 6, length: 0.45, radius: 0.55, downAngle: 50, downVar: 40, curve: 0, segments: 3, start: 0.2 }, { count: 5, length: 0.45, radius: 0.5, downAngle: 50, downVar: 50, curve: 0, segments: 3, start: 0.1 }],
+        leaves: { perLength: 80, size: 0.04, sizeVar: 0.3, spread: 0.9, lift: 0.3, fromLevel: 1, tuft: 2, start: 0.1 }, flowersAlways: 0.5,
+    },
+    forsythia: {
+        leaf: 'lanceolate', bark: '#8a7a5a', autumn: ['#c8a84a', '#8a6a3a'], flower: '#f8d020', petals: 4, flowerSize: 0.018, head: 8, color: '#5f9a3a', shade: '#2a4a1f',
+        levels: 2, droop: 0.5, twist: 0.3, photo: 0.4,
+        trunk: { length: 0.02, radius: 0.02, taper: 0, segments: 2, flex: 0.15 },
+        level: [{ count: 16, length: 40, radius: 0.5, downAngle: 30, downVar: 40, curve: 20, curveVar: 0.8, segments: 7, start: 0 }, { count: 4, length: 0.35, radius: 0.5, downAngle: 45, downVar: 40, curve: 5, segments: 3, start: 0.3 }],
+        leaves: { perLength: 40, size: 0.035, sizeVar: 0.3, spread: 0.8, lift: 0.2, fromLevel: 0, tuft: 2, start: 0.1 }, flowersAlways: 1,
+    },
+    lilac: {
+        leaf: 'heart', bark: '#6a5a4a', autumn: ['#c8a84a', '#8a6a3a'], flower: '#b48ae0', petals: 4, flowerSize: 0.009, head: 24, color: '#4f8a3a', shade: '#1e3a1a',
+        levels: 3, droop: 0.05, twist: 0.4, photo: 0.7,
+        trunk: { length: 0.05, radius: 0.03, taper: 0, segments: 2, flex: 0.08 },
+        level: [{ count: 8, length: 20, radius: 0.5, downAngle: 35, downVar: 35, curve: -10, curveVar: 0.7, segments: 5, start: 0 }, { count: 5, length: 0.5, radius: 0.55, downAngle: 45, downVar: 40, curve: 0, segments: 3, start: 0.2 }, { count: 4, length: 0.45, radius: 0.5, downAngle: 45, downVar: 50, curve: 0, segments: 3, start: 0.1 }],
+        leaves: { perLength: 60, size: 0.05, sizeVar: 0.3, spread: 0.9, lift: 0.2, fromLevel: 1, tuft: 2, start: 0.1 }, flowersAlways: 0.8,
+    },
+    oleander: {
+        leaf: 'lanceolate', bark: '#7a7a6a', autumn: ['#9a9a6a', '#7a7a5a'], flower: '#f080a8', petals: 5, flowerSize: 0.028, head: 5, color: '#3f7a3a', shade: '#1a3a1f',
+        levels: 2, droop: 0.05, twist: 0.3, photo: 0.8,
+        trunk: { length: 0.02, radius: 0.025, taper: 0, segments: 2, flex: 0.1 },
+        level: [{ count: 18, length: 40, radius: 0.5, downAngle: 30, downVar: 40, curve: -10, curveVar: 0.6, segments: 6, start: 0 }, { count: 4, length: 0.4, radius: 0.5, downAngle: 40, downVar: 40, curve: 0, segments: 3, start: 0.3 }],
+        leaves: { perLength: 70, size: 0.06, sizeVar: 0.3, spread: 0.9, lift: 0.1, fromLevel: 0, tuft: 2, start: 0.15 }, flowersAlways: 0.7,
+    },
+    agave: {
+        leaf: 'blade', bark: '#7a6a5a', autumn: ['#9a9a6a', '#7a7a5a'], flower: '#ffffff', petals: 0, flowerSize: 0, color: '#6a8a7a', shade: '#2a4a3a',
+        levels: 1, droop: -0.3, twist: 0.0, photo: 0.8,
+        trunk: { length: 0.03, radius: 0.04, taper: 0, segments: 2, flex: 0.01 },
+        level: [{ count: 34, length: 20, radius: 0.5, downAngle: 60, downVar: 35, curve: -30, curveVar: 0.2, segments: 3, start: 0 }],
+        leaves: { perBranch: 1, size: 0.7, sizeVar: 0.15, spread: 0, lift: 0, fromLevel: 0, tuft: 1, start: 0.85, faceUp: 1 }, flowersAlways: 0,
+    },
+};
+const LEAF_BASE = 7000, FALL_BASE = 150, FRUIT_BASE = 260, FLOWER_BASE = 900;
+export function createUniforms() { return createCommonUniforms(); }
+export function applyConfig(u, c, mats) {
+    if (c.species !== undefined)
+        c = Object.assign({}, c, speciesColors(c));
+    applyCommonConfig(u, c);
+    if (c.leafType !== undefined || c.species !== undefined) {
+        const sp = SPECIES[c.species] || SPECIES.wildShrub;
+        const lt = !c.leafType || c.leafType === 'auto' ? sp.leaf : c.leafType;
+        u.uLeafType.value = Math.max(0, LEAF_TYPES.indexOf(lt));
+    }
+    if (!mats)
+        return;
+    if (c.barkColor !== undefined)
+        setColor(mats.bark.userData.uniforms.uBarkColor, c.barkColor);
+    if (c.leafFall !== undefined)
+        mats.fall.userData.uniforms.uLeafFall.value = c.leafFall;
+    if (c.flowers !== undefined)
+        mats.flowerU.uFoliage.value = c.flowers;
+    if (c.flowerColor !== undefined)
+        setColor(mats.flowerU.uColor, c.flowerColor);
+    applyFruitConfig(mats.fruit, c);
+}
+function fitUnit(plant) {
+    let maxY = 1e-6, maxR = 1e-6;
+    for (const b of plant.branches)
+        for (const p of b.pts) {
+            if (p.y > maxY)
+                maxY = p.y;
+            const r = Math.hypot(p.x, p.z);
+            if (r > maxR)
+                maxR = r;
+        }
+    for (const l of plant.leaves) {
+        if (l.pos.y + l.size * 0.5 > maxY)
+            maxY = l.pos.y + l.size * 0.5;
+        const r = Math.hypot(l.pos.x, l.pos.z) + l.size * 0.5;
+        if (r > maxR)
+            maxR = r;
+    }
+    const sy = 1 / maxY, sxz = 0.5 / maxR, sr = Math.sqrt(sy * sxz);
+    const S = new THREE.Vector3(sxz, sy, sxz);
+    for (const b of plant.branches) {
+        for (const p of b.pts) {
+            p.multiply(S);
+            if (p.y < 0.005)
+                p.y = 0.005;
+        }
+        for (let i = 0; i < b.radii.length; i++)
+            b.radii[i] *= sr;
+        b.hf0 = Math.min(1, Math.max(0, b.pts[0].y));
+    }
+    for (const l of plant.leaves) {
+        l.pos.multiply(S);
+        l.along.multiply(S).normalize();
+        l.normal.multiply(S).normalize();
+        l.size *= sr;
+        l.hf = Math.min(1, Math.max(0, l.pos.y));
+    }
+    return plant;
+}
+/** Leaf / bark / flower colours the user has not customised (a species default) follow the current species. */
+export function speciesColors(c) {
+    const sp = SPECIES[c.species] || SPECIES.wildShrub;
+    const all = Object.values(SPECIES);
+    const isDef = (v, pick, extra) => !v || all.some((s) => (pick(s) || '').toLowerCase() === String(v).toLowerCase()) || (extra && extra.includes(String(v).toLowerCase()));
+    const out = Object.create(null); // only the keys set below override the config
+    if (isDef(c.color, (s) => s.color, ['#5a9440']))
+        out.color = sp.color || '#5a9440';
+    if (isDef(c.shadeColor, (s) => s.shade, ['#1e3a1a']))
+        out.shadeColor = sp.shade || '#1e3a1a';
+    if (isDef(c.barkColor, (s) => s.bark, ['#6b5a42']))
+        out.barkColor = sp.bark;
+    if (isDef(c.flowerColor, (s) => s.flower, ['#f2f0ff']))
+        out.flowerColor = sp.flower;
+    return out;
+}
+export function build(u, c) {
+    const q = QUALITY_V[c.quality] || 1;
+    const sp = SPECIES[c.species] || SPECIES.wildShrub;
+    c = Object.assign({}, c, speciesColors(c));
+    const rnd = mulberry32((c.seed ?? 3) * 2654435761 + 91);
+    const lv = sp.level.map((l) => Object.assign({}, l));
+    lv[0].count = Math.max(1, Math.round(c.stems ?? lv[0].count));
+    lv[0].downAngle = lv[0].downAngle * (c.spread ?? 1);
+    const P = Object.assign({}, sp, { level: lv, twist: (sp.twist || 0) + (c.twist ?? 0.5) - 0.5, leaves: Object.assign({}, sp.leaves) });
+    const plant = fitUnit(generatePlant(P, rnd));
+    let leaves = plant.leaves;
+    const target = Math.round(LEAF_BASE * (c.density ?? 1) * q);
+    if (leaves.length > target) {
+        const grow = Math.min(1.8, Math.sqrt(leaves.length / Math.max(target, 1)));
+        const picked = [];
+        for (let i = 0; i < target; i++)
+            picked.push(leaves[Math.floor(rnd() * leaves.length)]);
+        picked.forEach((l) => { l.size *= grow; });
+        leaves = picked;
+    }
+    leaves = lodOrder(leaves, c.seed ?? 3); // drawing the first K at distance is an even thinning
+    // flower heads at the tips of the outermost stems: a fan of petals around the tip
+    const tips = plant.branches.filter((b) => b.level === P.levels - 1 || (P.levels === 1 && b.level === 0));
+    const flowerU = Object.assign({}, u, { uLeafType: { value: LEAF_TYPES.indexOf('petal') }, uColor: { value: new THREE.Color(c.flowerColor || sp.flower) }, uShadeColor: { value: new THREE.Color(sp.flower).multiplyScalar(0.6) }, uFoliage: { value: c.flowers ?? 0 }, uSeason: { value: 0 } });
+    const nHeads = Math.min(tips.length, Math.round(FLOWER_BASE / Math.max(sp.petals * (sp.head || 1), 1)));
+    const flowerGeo = leafGeometry(Math.max(1, nHeads * sp.petals * (sp.head || 1)));
+    let fi = 0;
+    const up = new THREE.Vector3(0, 1, 0), along = new THREE.Vector3(), nrm = new THREE.Vector3(), perp = new THREE.Vector3(), pos = new THREE.Vector3();
+    if (sp.petals > 0)
+        for (let h = 0; h < nHeads; h++) {
+            const b = tips[Math.floor(rnd() * tips.length)];
+            const tipP = b.pts[b.pts.length - 1], t = b.tip;
+            const order = h / nHeads;
+            for (let k = 0; k < (sp.head || 1); k++) {
+                // a head: florets scattered in a small dome over the tip
+                perp.crossVectors(t, Math.abs(t.y) < 0.9 ? up : new THREE.Vector3(1, 0, 0)).normalize().applyAxisAngle(t, rnd() * Math.PI * 2);
+                pos.copy(tipP).addScaledVector(perp, (sp.head ? rnd() * 0.06 : 0)).addScaledVector(t, sp.head ? rnd() * 0.04 : 0.01);
+                for (let p = 0; p < sp.petals; p++) {
+                    const a = (p + rnd() * 0.3) / sp.petals * Math.PI * 2;
+                    along.copy(perp).applyAxisAngle(t, a).multiplyScalar(0.85).addScaledVector(t, 0.5).normalize();
+                    nrm.copy(t).addScaledVector(along, -0.3).normalize();
+                    setLeaf(flowerGeo, fi++, pos, along, nrm, sp.flowerSize * (0.8 + 0.4 * rnd()), rnd(), Math.min(1, pos.y), 0.9, b.phase, b.flex, order, 0);
+                }
+            }
+        }
+    flowerGeo.instanceCount = fi;
+    for (const k of ['aPos', 'aQuat', 'aInfoA', 'aInfoB'])
+        flowerGeo.attributes[k].needsUpdate = true;
+    unitBounds(flowerGeo);
+    const mats = { bark: null, leaf: null, fruit: null, fall: null, flowerU: null };
+    const barkPair = barkMaterial(u, { barkColor: c.barkColor || sp.bark, ridges: 0.6, lod: true });
+    const leafPair = leafMaterial(u, { autumnA: sp.autumn[0], autumnB: sp.autumn[1], translucency: sp.leaf === 'needles' ? 0.25 : 0.55, lod: true });
+    const flowerPair = leafMaterial(flowerU, { translucency: 0.7, veins: 0.0, roughness: 0.9, underside: 0.08, lod: true });
+    const fruitPair = fruitMaterial(u);
+    const fallPair = fallingMaterial(u);
+    fallPair.material.userData.uniforms.uAutumnA.value.set(sp.autumn[0]);
+    fallPair.material.userData.uniforms.uAutumnB.value.set(sp.autumn[1]);
+    mats.bark = barkPair.material;
+    mats.leaf = leafPair.material;
+    mats.fruit = fruitPair.material;
+    mats.fall = fallPair.material;
+    mats.flowerU = flowerU;
+    const barkGeo = branchGeometry(plant.branches, { sides: [6, 6, 5, 4] });
+    const leafGeo = leafGeometry(Math.max(1, leaves.length));
+    fillLeaves(leafGeo, leaves);
+    unitBounds(leafGeo);
+    const fallGeo = leafGeometry(Math.round(FALL_BASE * q));
+    fillLeaves(fallGeo, leaves.length ? Array.from({ length: fallGeo.instanceCount }, () => leaves[Math.floor(rnd() * leaves.length)]).map((l, i) => Object.assign({}, l, { order: (i + 0.5) / fallGeo.instanceCount })) : []);
+    unitBounds(fallGeo);
+    const fruitGeo = fruitGeometry(Math.round(FRUIT_BASE * q), 10);
+    if (leaves.length)
+        fillFruit(fruitGeo, leaves, rnd, 0.05);
+    unitBounds(fruitGeo);
+    const object = new THREE.Group();
+    object.name = 'bush';
+    const stems = plantMesh(barkGeo, barkPair, 'stems'), foliage = plantMesh(leafGeo, leafPair, 'leaves'), flowersM = plantMesh(flowerGeo, flowerPair, 'flowers');
+    const berries = plantMesh(fruitGeo, fruitPair, 'berries'), falling = plantMesh(fallGeo, fallPair, 'falling');
+    object.add(stems, foliage, flowersM, berries, falling);
+    const lod = plantLod(u, object, {
+        leaves: [foliage, flowersM], bark: [stems], other: [berries, falling], bake: [stems, foliage, flowersM, berries],
+        visible: [[flowersM, () => fi > 0 && flowerU.uFoliage.value > 0.001], [falling, () => mats.fall.userData.uniforms.uLeafFall.value + 0.6 * Math.max(0, Math.min(1, (u.uSeason.value - 0.5) * 2)) > 0.001]],
+    });
+    const cfg = Object.assign({}, c);
+    if (sp.flowersAlways && (c.flowers ?? 0) === 0)
+        cfg.flowers = sp.flowersAlways;
+    if (sp.fruitAlways && (!c.fruit || c.fruit === 'none')) {
+        cfg.fruit = sp.fruitAlways;
+        cfg.fruitAmount = 0.6;
+    }
+    applyConfig(u, cfg, mats);
+    lod.applied(cfg);
+    return {
+        object,
+        materials: [barkPair.material, leafPair.material, flowerPair.material, fruitPair.material, fallPair.material, lod.impostor.material],
+        apply: function (cfg2) { applyConfig(u, cfg2, mats); lod.applied(cfg2); },
+        update: function (dt, camera, sunWorld, renderer) { updateCommon(u, object, camera, dt, sunWorld); lod.update(dt, renderer); },
+        lod,
+        stats: { branches: plant.branches.length, leaves: leaves.length, petals: fi },
+        dispose: function () {
+            for (const g of [barkGeo, leafGeo, flowerGeo, fallGeo, fruitGeo])
+                g.dispose();
+            lod.dispose();
+            for (const p of [barkPair, leafPair, flowerPair, fruitPair, fallPair]) {
+                p.material.dispose();
+                p.depth.dispose();
+            }
+        },
+    };
+}
+/** Knobs whose change rebuilds the plant (dispose + build); every other knob is a live push through apply. */
+export const STRUCTURAL = ['species', 'stems', 'spread', 'twist', 'density', 'quality', 'seed'];