@3driseai/3drise-viewer 0.1.42 → 0.1.43

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

@@ -0,0 +1,225 @@
+// Emitted from Claude outputs/vegetation-lab/flowers.mjs by gen_family.mjs — edit the lab module and re-emit.
+// Flowers — vegetation object (lab module). Shared core: ./common.mjs (blades + petal cards).
+// Construction: a bed or meadow of one species: each flower is a stalk (bent blade), a head of petal
+// cards in the species' arrangement (flat ray florets, a cup, a spike, a crinkled bowl), a centre disc
+// and a few leaves on the stalk. `bloom` folds every petal from a closed bud to open (each flower at
+// its own moment, so a bed opens over a while), stalks lean and nod in the shared wind field, petals
+// flutter and glow against the sun. Species: daisy, tulip, poppy, sunflower, cosmos, lavender spike.
+import * as THREE from 'three';
+import { mulberry32, setColor, createCommonUniforms, applyCommonConfig, updateCommon, QUALITY_V, LEAF_TYPES, bladeGeometry, setBlade, bladeMaterial, clumpedPositions, leafGeometry, setLeaf, unitBounds, leafMaterial, plantMesh, } from '../vegetationCore.js';
+// petals: count, size (unit, at a 4 m bed), tilt (0 flat .. 1 cup), petal leaf type; centre size; stalk height; colours
+// petals: count, size (unit, at a 4 m bed), tilt (0 flat .. 1 cup; negative recurves), cupNormal; rows of petals
+// (rowShrink per row, inner rows more upright); centre size; stalk height; colours; spike (bells along the top);
+// faceDown (hanging bells); sphere (a globe of florets); petalType (SDF) and leafType
+export const SPECIES = {
+    daisy: { petals: 21, size: 0.013, tilt: 0.12, cupNormal: 0.25, centre: 0.0075, stalk: 0.75, stalkW: 0.003, leaves: 3, leafSize: 0.018, flower: '#fbf8ee', centreC: '#f0c030', per: 0.6 },
+    tulip: { petals: 6, size: 0.03, tilt: 0.85, cupNormal: 1.0, centre: 0.0, stalk: 0.85, stalkW: 0.008, leaves: 2, leafSize: 0.06, flower: '#e2362e', centreC: '#2a2a1a', per: 1, leafType: 'lanceolate' },
+    poppy: { petals: 5, size: 0.028, tilt: 0.35, cupNormal: 0.5, centre: 0.008, stalk: 0.8, stalkW: 0.004, leaves: 3, leafSize: 0.03, flower: '#d8261e', centreC: '#1e1a1e', per: 1 },
+    sunflower: { petals: 21, size: 0.026, tilt: 0.05, cupNormal: 0.15, centre: 0.028, stalk: 1, stalkW: 0.012, leaves: 4, leafSize: 0.055, flower: '#f3c12a', centreC: '#4a2a12', per: 0.14, lean: 0.3 },
+    cosmos: { petals: 8, size: 0.022, tilt: 0.15, cupNormal: 0.25, centre: 0.009, stalk: 0.9, stalkW: 0.003, leaves: 3, leafSize: 0.025, flower: '#ee9ac6', centreC: '#f2c230', per: 1 },
+    lavender: { petals: 24, size: 0.007, tilt: 0.6, cupNormal: 0.3, centre: 0.0, stalk: 0.9, stalkW: 0.003, leaves: 2, leafSize: 0.02, flower: '#8d73cf', centreC: '#8d73cf', per: 1.6, spike: 0.22, leafType: 'lanceolate' },
+    rose: { petals: 8, size: 0.022, tilt: 0.55, cupNormal: 0.9, rows: 4, rowShrink: 0.18, rowTilt: 0.12, centre: 0.0, stalk: 0.8, stalkW: 0.006, leaves: 4, leafSize: 0.03, flower: '#d8203a', centreC: '#5a1020', per: 0.7, petalType: 'round' },
+    peony: { petals: 10, size: 0.026, tilt: 0.4, cupNormal: 0.8, rows: 5, rowShrink: 0.15, rowTilt: 0.12, centre: 0.0, stalk: 0.7, stalkW: 0.007, leaves: 4, leafSize: 0.04, flower: '#f2a8c0', centreC: '#f0d060', per: 0.5, petalType: 'round' },
+    lily: { petals: 6, size: 0.038, tilt: 0.3, cupNormal: -0.5, centre: 0.006, stalk: 0.95, stalkW: 0.007, leaves: 5, leafSize: 0.04, flower: '#f7b24a', centreC: '#6a3a10', per: 0.4, petalType: 'lanceolate', leafType: 'lanceolate', lean: 0.25 },
+    iris: { petals: 3, size: 0.03, tilt: 0.75, cupNormal: 1.0, rows: 2, rowShrink: 0.0, rowTilt: -1.3, centre: 0.0, stalk: 0.95, stalkW: 0.006, leaves: 3, leafSize: 0.08, flower: '#5a4ab8', centreC: '#f0d040', per: 0.5, leafType: 'blade' },
+    dandelion: { petals: 26, size: 0.011, tilt: 0.08, cupNormal: 0.2, rows: 2, rowShrink: 0.3, rowTilt: 0.25, centre: 0.005, stalk: 0.4, stalkW: 0.004, leaves: 5, leafSize: 0.035, flower: '#f5c518', centreC: '#e0a010', per: 0.8, petalType: 'lanceolate', leafType: 'lobed' },
+    dandelionPuff: { petals: 70, size: 0.012, sphere: 0.012, centre: 0.004, stalk: 0.55, stalkW: 0.004, leaves: 5, leafSize: 0.035, flower: '#f4f2ea', centreC: '#c8c0a0', per: 0.6, petalType: 'blade', leafType: 'lobed' },
+    allium: { petals: 110, size: 0.008, sphere: 0.03, centre: 0.0, stalk: 1, stalkW: 0.006, leaves: 2, leafSize: 0.06, flower: '#9a5ac8', centreC: '#9a5ac8', per: 0.3, leafType: 'blade' },
+    clover: { petals: 36, size: 0.006, sphere: 0.008, centre: 0.0, stalk: 0.3, stalkW: 0.002, leaves: 3, leafSize: 0.02, flower: '#e8a0c0', centreC: '#e8a0c0', per: 1.5, leafType: 'round' },
+    bluebell: { petals: 6, size: 0.009, tilt: 0.85, cupNormal: 0.9, centre: 0.0, stalk: 0.6, stalkW: 0.003, leaves: 3, leafSize: 0.04, flower: '#5a6ad8', centreC: '#5a6ad8', per: 1.2, spike: 0.2, spikeN: 7, faceDown: 1, leafType: 'blade' },
+    foxglove: { petals: 5, size: 0.014, tilt: 0.9, cupNormal: 0.95, centre: 0.0, stalk: 1, stalkW: 0.006, leaves: 4, leafSize: 0.05, flower: '#c868b0', centreC: '#c868b0', per: 0.35, spike: 0.42, spikeN: 16, faceDown: 0.6 },
+    lupine: { petals: 6, size: 0.008, tilt: 0.7, cupNormal: 0.6, centre: 0.0, stalk: 1, stalkW: 0.005, leaves: 4, leafSize: 0.04, flower: '#6a4ac8', centreC: '#6a4ac8', per: 0.5, spike: 0.4, spikeN: 22, leafType: 'frond' },
+    marigold: { petals: 14, size: 0.014, tilt: 0.3, cupNormal: 0.6, rows: 3, rowShrink: 0.2, rowTilt: 0.15, centre: 0.004, stalk: 0.5, stalkW: 0.004, leaves: 4, leafSize: 0.025, flower: '#f2901e', centreC: '#c86a10', per: 1, petalType: 'round', leafType: 'frond' },
+    chrysanthemum: { petals: 20, size: 0.016, tilt: 0.25, cupNormal: 0.5, rows: 4, rowShrink: 0.16, rowTilt: 0.15, centre: 0.0, stalk: 0.7, stalkW: 0.005, leaves: 4, leafSize: 0.03, flower: '#f0d040', centreC: '#f0d040', per: 0.6, petalType: 'lanceolate', leafType: 'lobed' },
+    carnation: { petals: 12, size: 0.016, tilt: 0.5, cupNormal: 0.7, rows: 3, rowShrink: 0.15, rowTilt: 0.15, centre: 0.0, stalk: 0.8, stalkW: 0.004, leaves: 3, leafSize: 0.03, flower: '#f06a90', centreC: '#f06a90', per: 0.7, petalType: 'round', leafType: 'lanceolate' },
+    gerbera: { petals: 26, size: 0.018, tilt: 0.08, cupNormal: 0.2, rows: 2, rowShrink: 0.25, rowTilt: 0.2, centre: 0.012, stalk: 0.7, stalkW: 0.005, leaves: 3, leafSize: 0.04, flower: '#f25a3a', centreC: '#3a2a1a', per: 0.5, petalType: 'lanceolate', leafType: 'lobed' },
+    anemone: { petals: 7, size: 0.022, tilt: 0.2, cupNormal: 0.4, centre: 0.009, stalk: 0.6, stalkW: 0.003, leaves: 3, leafSize: 0.03, flower: '#e8406a', centreC: '#101018', per: 0.8, petalType: 'round', leafType: 'lobed' },
+    buttercup: { petals: 5, size: 0.011, tilt: 0.3, cupNormal: 0.6, centre: 0.004, stalk: 0.5, stalkW: 0.002, leaves: 3, leafSize: 0.022, flower: '#f8d020', centreC: '#e0b010', per: 1.3, petalType: 'round', leafType: 'lobed' },
+    pansy: { petals: 5, size: 0.02, tilt: 0.1, cupNormal: 0.3, centre: 0.005, stalk: 0.3, stalkW: 0.003, leaves: 3, leafSize: 0.025, flower: '#6a3ab8', centreC: '#f0d040', per: 1, petalType: 'round', leafType: 'round' },
+    crocus: { petals: 6, size: 0.022, tilt: 0.8, cupNormal: 0.9, centre: 0.0, stalk: 0.25, stalkW: 0.004, leaves: 4, leafSize: 0.05, flower: '#8a5ad0', centreC: '#f0a020', per: 1.2, leafType: 'blade' },
+    hibiscus: { petals: 5, size: 0.036, tilt: 0.2, cupNormal: 0.5, centre: 0.01, stalk: 0.7, stalkW: 0.006, leaves: 4, leafSize: 0.05, flower: '#e8203a', centreC: '#f0d040', per: 0.4, petalType: 'round' },
+    lotus: { petals: 12, size: 0.045, tilt: 0.45, cupNormal: 0.8, rows: 3, rowShrink: 0.2, rowTilt: 0.15, centre: 0.015, stalk: 0.45, stalkW: 0.008, leaves: 3, leafSize: 0.14, flower: '#f6b0c8', centreC: '#f0d060', per: 0.12, leafType: 'round' },
+    zinnia: { petals: 12, size: 0.016, tilt: 0.15, cupNormal: 0.3, rows: 3, rowShrink: 0.2, rowTilt: 0.12, centre: 0.008, stalk: 0.6, stalkW: 0.004, leaves: 3, leafSize: 0.03, flower: '#e03a8a', centreC: '#f0c030', per: 0.8, petalType: 'round' },
+    aster: { petals: 22, size: 0.012, tilt: 0.1, cupNormal: 0.2, rows: 2, rowShrink: 0.2, rowTilt: 0.15, centre: 0.007, stalk: 0.7, stalkW: 0.003, leaves: 4, leafSize: 0.025, flower: '#9a7ad8', centreC: '#f0c030', per: 0.9, petalType: 'lanceolate', leafType: 'lanceolate' },
+    cornflower: { petals: 10, size: 0.013, tilt: 0.25, cupNormal: 0.5, rows: 2, rowShrink: 0.3, rowTilt: 0.3, centre: 0.005, stalk: 0.75, stalkW: 0.003, leaves: 3, leafSize: 0.025, flower: '#3a5ad8', centreC: '#2a2a6a', per: 1, petalType: 'petal', leafType: 'lanceolate' },
+    snapdragon: { petals: 4, size: 0.011, tilt: 0.7, cupNormal: 0.8, centre: 0.0, stalk: 0.8, stalkW: 0.004, leaves: 4, leafSize: 0.03, flower: '#f0a0c0', centreC: '#f0a0c0', per: 0.6, spike: 0.3, spikeN: 12, faceDown: 0.2, leafType: 'lanceolate' },
+    orchid: { petals: 5, size: 0.022, tilt: 0.2, cupNormal: 0.4, centre: 0.007, stalk: 0.75, stalkW: 0.004, leaves: 2, leafSize: 0.06, flower: '#f2c0e0', centreC: '#a0207a', per: 0.4, spike: 0.3, spikeN: 5, faceDown: 0.25, petalType: 'round', leafType: 'blade' },
+};
+const FLOWER_BASE = 420;
+export function createUniforms() { return Object.assign(createCommonUniforms(), { uLeafType: { value: LEAF_TYPES.indexOf('broadleaf') } }); }
+export function applyConfig(u, c, mats) {
+    applyCommonConfig(u, Object.assign({}, c, { leafType: undefined }));
+    if (!mats)
+        return;
+    if (c.species !== undefined)
+        c = Object.assign({}, c, speciesColors(c));
+    if (c.flowerColor !== undefined)
+        setColor(mats.petalU.uColor, c.flowerColor);
+    if (c.centerColor !== undefined)
+        setColor(mats.centreU.uColor, c.centerColor);
+    if (c.color !== undefined && mats.underU) {
+        setColor(mats.underU.uColor, c.color);
+    }
+    if (c.shadeColor !== undefined && mats.underU)
+        setColor(mats.underU.uShadeColor, c.shadeColor);
+    if (c.bloom !== undefined)
+        mats.bloom.value = c.bloom;
+    if (c.headSize !== undefined) {
+        mats.petalU.uLeafSize.value = c.headSize;
+        mats.centreU.uLeafSize.value = c.headSize;
+    }
+    if (c.stemHeight !== undefined || c.growth !== undefined) {
+        if (c.stemHeight !== undefined)
+            mats.state.stem = c.stemHeight;
+        if (c.growth !== undefined)
+            mats.state.growth = c.growth;
+        mats.stalkU.uGrowth.value = mats.state.stem * mats.state.growth;
+    }
+}
+/** A colour the user has not customised (it is some species' default) follows the current species. */
+export function speciesColors(c) {
+    const sp = SPECIES[c.species] || SPECIES.daisy;
+    const defaults = Object.values(SPECIES);
+    const isDefault = (v, key) => !v || defaults.some((s) => s[key].toLowerCase() === String(v).toLowerCase());
+    return { flowerColor: isDefault(c.flowerColor, 'flower') ? sp.flower : c.flowerColor, centerColor: isDefault(c.centerColor, 'centreC') ? sp.centreC : c.centerColor };
+}
+export function build(u, c) {
+    const q = QUALITY_V[c.quality] || 1;
+    const sp = SPECIES[c.species] || SPECIES.daisy;
+    c = Object.assign({}, c, speciesColors(c));
+    const rnd = mulberry32((c.seed ?? 21) * 2654435761 + 41);
+    const n = Math.round(FLOWER_BASE * (c.density ?? 1) * q * sp.per);
+    const pts = clumpedPositions(n, rnd, c.clumping ?? 0.4, 0.02);
+    const stalkU = Object.assign({}, u, { uGrowth: { value: (c.stemHeight ?? 1) * (c.growth ?? 1) }, uLeafSize: { value: 1 } });
+    const petalU = Object.assign({}, u, { uLeafType: { value: LEAF_TYPES.indexOf(sp.petalType || 'petal') }, uColor: { value: new THREE.Color(c.flowerColor || sp.flower) }, uShadeColor: { value: new THREE.Color(sp.flower).multiplyScalar(0.55) }, uGrowth: stalkU.uGrowth, uFoliage: { value: 1 }, uSeason: { value: 0 }, uLeafSize: { value: c.headSize ?? 1 } });
+    const centreU = Object.assign({}, petalU, { uLeafType: { value: LEAF_TYPES.indexOf('round') }, uColor: { value: new THREE.Color(c.centerColor || sp.centreC) }, uShadeColor: { value: new THREE.Color(sp.centreC).multiplyScalar(0.6) }, uLeafSize: petalU.uLeafSize });
+    const leafU = Object.assign({}, u, { uLeafType: { value: LEAF_TYPES.indexOf(sp.leafType || 'broadleaf') }, uGrowth: stalkU.uGrowth });
+    const spikeN = sp.spike ? sp.petals : 0;
+    const stalks = bladeGeometry(n);
+    const petalCap = sp.sphere ? sp.petals : (sp.rows || 1) * Math.min(sp.petals, sp.spike ? 8 : 999) * (sp.spike ? (sp.spikeN || sp.petals) : 1);
+    const petalGeo = leafGeometry(n * petalCap), centreGeo = leafGeometry(Math.max(1, sp.centre > 0 ? n : 1)), leafGeo = leafGeometry(n * sp.leaves);
+    const along = new THREE.Vector3(), nrm = new THREE.Vector3(), up = new THREE.Vector3(0, 1, 0), pos = new THREE.Vector3(), root = new THREE.Vector3();
+    let pi = 0, ci = 0, li = 0;
+    for (let i = 0; i < n; i++) {
+        const p = pts[i];
+        const h = sp.stalk * (0.8 + 0.4 * rnd());
+        const yaw = rnd() * Math.PI * 2, lean = (sp.lean || 0.12) * rnd(), phase = rnd(), moment = rnd();
+        setBlade(stalks, i, p, h, sp.stalkW, yaw, rnd(), lean, phase, 0, 0);
+        // the head sits where the bent stalk ends (its curve: fwd * lean * H)
+        const fwd = new THREE.Vector3(-Math.sin(yaw), 0, Math.cos(yaw));
+        pos.set(p.x, h * 0.985, p.z).addScaledVector(fwd, lean * h);
+        root.set(p.x, 0, p.z);
+        // the head faces up and a little along the lean; sunflowers face the sun side
+        const face = new THREE.Vector3(fwd.x * (0.3 + lean * 2), 1, fwd.z * (0.3 + lean * 2)).normalize();
+        const perp = new THREE.Vector3().crossVectors(face, Math.abs(face.y) < 0.9 ? up : new THREE.Vector3(1, 0, 0)).normalize();
+        const rows = sp.rows || 1, perRow = sp.petals;
+        if (sp.sphere) {
+            // a globe of florets (dandelion clock, allium, clover): petals on a Fibonacci sphere around the head
+            const n = sp.petals, R = sp.sphere;
+            for (let k = 0; k < n; k++) {
+                const yy = 1 - 2 * (k + 0.5) / n, rr = Math.sqrt(1 - yy * yy), ang = k * 2.39996;
+                const dir = new THREE.Vector3(Math.cos(ang) * rr, yy, Math.sin(ang) * rr);
+                const at = pos.clone().addScaledVector(dir, R * 0.35);
+                nrm.crossVectors(dir, perp).normalize();
+                setLeaf(petalGeo, pi, at, dir, nrm, sp.size * (0.85 + 0.3 * rnd()), rnd(), h, 1, phase, 0.4, 0, 0);
+                petalGeo.attributes.aInfoA.setW(pi, moment);
+                petalGeo.attributes.aRoot.setXYZ(pi, root.x, root.y, root.z);
+                pi++;
+            }
+        }
+        else {
+            const spikeN = sp.spike ? (sp.spikeN || sp.petals) : 1;
+            const heads = sp.spike ? spikeN : 1;
+            for (let hh = 0; hh < heads; hh++) {
+                // a spike: small heads along the top of the stalk, facing out (and down for bells)
+                let hFace = face.clone(), at = pos.clone();
+                if (sp.spike) {
+                    const a0 = hh * 2.4 + rnd() * 0.5, ty = hh / heads;
+                    at = pos.clone().addScaledVector(face, -sp.spike * ty);
+                    hFace = new THREE.Vector3(Math.cos(a0), 0.4 - (sp.faceDown || 0) * 1.3, Math.sin(a0)).normalize();
+                    at.addScaledVector(hFace, 0.004);
+                }
+                else if (sp.faceDown)
+                    hFace = new THREE.Vector3(hFace.x, -hFace.y * sp.faceDown, hFace.z).normalize();
+                const hPerp = new THREE.Vector3().crossVectors(hFace, Math.abs(hFace.y) < 0.9 ? up : new THREE.Vector3(1, 0, 0)).normalize();
+                const petN = sp.spike ? Math.min(perRow, 8) : perRow;
+                for (let r = 0; r < rows; r++) {
+                    const scale = 1 - r * (sp.rowShrink || 0), tilt = Math.min(0.98, sp.tilt + r * (sp.rowTilt || 0)), cupN = sp.cupNormal + r * (sp.rowTilt || 0) * 0.5;
+                    const rAt = at.clone().addScaledVector(hFace, r * 0.004);
+                    for (let k = 0; k < petN; k++) {
+                        const a = (k + 0.5 * (r % 2)) / petN * Math.PI * 2 + rnd() * 0.15;
+                        along.copy(hPerp).applyAxisAngle(hFace, a).multiplyScalar(1 - Math.abs(tilt)).addScaledVector(hFace, tilt).normalize();
+                        nrm.copy(hFace).multiplyScalar(1 - Math.abs(cupN)).addScaledVector(hPerp.clone().applyAxisAngle(hFace, a), -cupN).normalize();
+                        if (pi >= petalGeo.instanceCount)
+                            break;
+                        setLeaf(petalGeo, pi, rAt, along, nrm, sp.size * scale * (0.85 + 0.3 * rnd()), rnd(), h, 1, phase, 0.4, 0, 0);
+                        petalGeo.attributes.aInfoA.setW(pi, moment);
+                        petalGeo.attributes.aRoot.setXYZ(pi, root.x, root.y, root.z);
+                        pi++;
+                    }
+                }
+            }
+        }
+        if (sp.centre > 0) {
+            setLeaf(centreGeo, ci, pos.clone().addScaledVector(face, 0.002), perp, face, sp.centre, rnd(), h, 1, phase, 0.4, 0, 0);
+            centreGeo.attributes.aRoot.setXYZ(ci, root.x, root.y, root.z);
+            ci++;
+        }
+        for (let k = 0; k < sp.leaves; k++) {
+            const t = 0.15 + 0.5 * rnd(), a = rnd() * Math.PI * 2;
+            const lp = new THREE.Vector3(p.x, h * t, p.z).addScaledVector(fwd, lean * h * t * t);
+            along.set(Math.cos(a), 0.5 + 0.5 * rnd(), Math.sin(a)).normalize();
+            nrm.set(Math.cos(a), 1.2, Math.sin(a)).normalize();
+            setLeaf(leafGeo, li, lp, along, nrm, sp.leafSize * (0.8 + 0.4 * rnd()), rnd(), h * t, 0.8, phase, 0.5, 0, 0);
+            leafGeo.attributes.aRoot.setXYZ(li, root.x, root.y, root.z);
+            li++;
+        }
+    }
+    petalGeo.instanceCount = pi;
+    centreGeo.instanceCount = Math.max(ci, 0);
+    leafGeo.instanceCount = li;
+    for (const g of [stalks, petalGeo, centreGeo, leafGeo]) {
+        for (const k of ['aPos', 'aInfoA', 'aInfoB', 'aQuat', 'aRoot'])
+            if (g.attributes[k])
+                g.attributes[k].needsUpdate = true;
+        unitBounds(g);
+    }
+    // undergrowth: a sward of short blades the flowers stand in
+    const nU = Math.round(9000 * (c.undergrowth ?? 0.6) * q);
+    const under = bladeGeometry(Math.max(1, nU));
+    const upts = clumpedPositions(Math.max(1, nU), rnd, 0.3, 0.01);
+    for (let i = 0; i < nU; i++)
+        setBlade(under, i, upts[i], (0.18 + 0.2 * rnd()) * sp.stalk, 0.008 * (0.8 + 0.5 * rnd()), rnd() * Math.PI * 2, rnd(), 0.5 + 0.6 * rnd(), rnd(), 0, 0);
+    under.instanceCount = nU;
+    for (const k of ['aPos', 'aInfoA', 'aInfoB'])
+        under.attributes[k].needsUpdate = true;
+    unitBounds(under);
+    const underU = Object.assign({}, u, { uGrowth: stalkU.uGrowth, uColor: { value: new THREE.Color(c.color || '#5e9a3c').multiplyScalar(1.05) }, uShadeColor: { value: new THREE.Color(c.shadeColor || '#244a1c') } });
+    const underPair = bladeMaterial(underU, { translucency: 0.5 });
+    const stalkPair = bladeMaterial(stalkU, { translucency: 0.4, taper: 0.3 });
+    const petalPair = leafMaterial(petalU, { translucency: 0.75, veins: 0.0, roughness: 0.9, bloom: true, curl: 0.5, underside: 0.08 });
+    petalPair.material.envMapIntensity = 0.2;
+    const centrePair = leafMaterial(centreU, { translucency: 0.1, veins: 0, roughness: 0.95, underside: 0 });
+    const leafPair = leafMaterial(leafU, { translucency: 0.5, veins: 0.4 });
+    const object = new THREE.Group();
+    object.name = 'flowers';
+    object.add(plantMesh(under, underPair, 'undergrowth'), plantMesh(stalks, stalkPair, 'stalks'), plantMesh(leafGeo, leafPair, 'leaves'), plantMesh(petalGeo, petalPair, 'petals'));
+    if (sp.centre > 0)
+        object.add(plantMesh(centreGeo, centrePair, 'centres'));
+    const mats = { petalU, centreU, stalkU, underU, bloom: petalPair.material.userData.uniforms.uBloom, state: { stem: c.stemHeight ?? 1, growth: c.growth ?? 1 } };
+    applyConfig(u, c, mats);
+    return {
+        object,
+        materials: [underPair.material, stalkPair.material, petalPair.material, centrePair.material, leafPair.material],
+        apply: function (cfg) { applyConfig(u, cfg, mats); },
+        update: function (dt, camera, sunWorld) { updateCommon(u, object, camera, dt, sunWorld); },
+        stats: { flowers: n, petals: pi },
+        dispose: function () { for (const g of [under, stalks, petalGeo, centreGeo, leafGeo])
+            g.dispose(); for (const p of [underPair, stalkPair, petalPair, centrePair, leafPair]) {
+            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', 'clumping', 'density', 'quality', 'seed', 'undergrowth'];

package/dist/components/vegetation/core/forest.d.ts

@@ -0,0 +1,138 @@
+import * as THREE from 'three';
+export declare const MIXES: {
+    temperate: {
+        trees: (string | number)[][];
+        under: string[];
+    };
+    conifer: {
+        trees: (string | number)[][];
+        under: string[];
+    };
+    birch: {
+        trees: (string | number)[][];
+        under: string[];
+    };
+    autumn: {
+        trees: (string | number)[][];
+        under: string[];
+    };
+    mediterranean: {
+        trees: (string | number)[][];
+        under: string[];
+    };
+    tropical: {
+        trees: (string | number)[][];
+        under: string[];
+    };
+    savanna: {
+        trees: (string | number)[][];
+        under: string[];
+    };
+    blossom: {
+        trees: (string | number)[][];
+        under: string[];
+    };
+    winter: {
+        trees: (string | number)[][];
+        under: string[];
+    };
+};
+export declare function createUniforms(): {
+    uTime: {
+        value: number;
+    };
+    uWindPhase: {
+        value: number;
+    };
+    uWindDir: {
+        value: THREE.Vector2;
+    };
+    uWindStrength: {
+        value: number;
+    };
+    uTurb: {
+        value: number;
+    };
+    uSpeed: {
+        value: number;
+    };
+    uSway: {
+        value: number;
+    };
+    uFlutter: {
+        value: number;
+    };
+    uScale: {
+        value: THREE.Vector3;
+    };
+    uMean: {
+        value: number;
+    };
+    uOpacity: {
+        value: number;
+    };
+    uColor: {
+        value: THREE.Color;
+    };
+    uShadeColor: {
+        value: THREE.Color;
+    };
+    uSeason: {
+        value: number;
+    };
+    uFoliage: {
+        value: number;
+    };
+    uLeafType: {
+        value: number;
+    };
+    uLeafSize: {
+        value: number;
+    };
+    uGrowth: {
+        value: number;
+    };
+    uSunDirView: {
+        value: THREE.Vector3;
+    };
+    uViewPos: {
+        value: THREE.Vector3;
+    };
+    uLodK: {
+        value: number;
+    };
+    uLodOrtho: {
+        value: number;
+    };
+    uLodBias: {
+        value: number;
+    };
+    uImpReady: {
+        value: number;
+    };
+    uBake: {
+        value: number;
+    };
+    uBakeView: {
+        value: THREE.Matrix3;
+    };
+    uBakeDepth: {
+        value: THREE.Vector2;
+    };
+};
+export declare function applyConfig(u: any, c: any, plants: any): void;
+export declare function build(u: any, c: any): {
+    object: THREE.Group<THREE.Object3DEventMap>;
+    materials: any[];
+    apply: (cfg: any) => void;
+    update: (dt: any, camera: any, sunWorld: any, renderer: any) => void;
+    stats: {
+        trees: number;
+        undergrowth: number;
+        species: number;
+    };
+    dispose: () => void;
+};
+/** Knobs whose change rebuilds the plant (dispose + build); every other knob is a live push through apply. */
+export declare const STRUCTURAL: string[];
+//# sourceMappingURL=forest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forest.d.ts","sourceRoot":"","sources":["../../../../src/components/vegetation/core/forest.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUjB,CAAC;AAUF,wBAAgB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAqC;AAqBnE,wBAAgB,WAAW,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA,EAAE,MAAM,KAAA,QAIvC;AAUD,wBAAgB,KAAK,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA;;;;;;;;;;;EA8KzB;AAED,8GAA8G;AAC9G,eAAO,MAAM,UAAU,UAAyF,CAAC"}