@woosh/meep-engine 3.53.0 → 3.55.0

package/src/generation/foliage/presets/make_tree_species_preset.js

@@ -1,837 +1,870 @@
-import { AnimationCurve } from "../../../engine/animation/curve/AnimationCurve.js";
-import { CrownEnvelopeType } from "../config/CrownEnvelopeType.js";
-import { FoliageCardType } from "../config/FoliageCardType.js";
-import { PhyllotaxisMode } from "../config/PhyllotaxisMode.js";
-import { TreePreset } from "../config/TreePreset.js";
-import { TreeSpeciesConfig } from "../config/TreeSpeciesConfig.js";
-
-/**
- * Returns a rich, botanically tuned `TreeSpeciesConfig` for one of the 9 built-in
- * `TreePreset` archetypes (`Oak`, `Pine`, `Birch`, `Willow`, `Maple`, `Spruce`, `Palm`, `Shrub`, `Fern`),
- * with optional deep parameter overrides.
- *
- * @param {TreePreset|string} [preset=TreePreset.Oak]
- * @param {Object} [overrides]
- * @returns {TreeSpeciesConfig}
- */
-export function make_tree_species_preset(preset = TreePreset.Oak, overrides = {}) {
-    const config = new TreeSpeciesConfig();
-    const key = typeof preset === "string" ? preset.toLowerCase() : TreePreset.Oak;
-
-    switch (key) {
-        case TreePreset.Pine: {
-            config.name = "pine";
-            config.preset = TreePreset.Pine;
-            config.crown.applyOverrides({
-                envelope_type: CrownEnvelopeType.Conical,
-                height: 10.5,
-                radius: 4.4,
-                base_height: 2.2,
-                prune_ratio: 0.25,
-                space_colonization_weight: 0.08,
-                pipe_model_exponent: 2.4,
-                pipe_model_weight: 0.55,
-                sky_phototropism_mix: 0.35
-            });
-            config.levels = [
-                {
-                    level: 0,
-                    segments: 12,
-                    radial_segments_max: 14,
-                    radial_segments_min: 8,
-                    length: 11.2,
-                    length_variance: 0.05,
-                    radius_ratio: 0.038,
-                    taper: 0.88,
-                    bare_length_ratio: 0.24,
-                    child_count: 26,
-                    phyllotaxis_mode: PhyllotaxisMode.Whorled,
-                    whorl_count: 4,
-                    azimuth_jitter: 0.16,
-                    insertion_angle: 1.34,
-                    insertion_angle_variation: 0.10,
-                    insertion_angle_profile: AnimationCurve.linear(0, 1.05, 1, 0.68),
-                    curvature: 0.16,
-                    curve_back: -0.10,
-                    spiral_twist: 0.22,
-                    gravitropism: -0.06,
-                    phototropism: 0.10,
-                    gnarl_strength: 0.09,
-                    gnarl_frequency: 0.32,
-                    basal_lean: 0.015,
-                    nodal_kink_strength: 0.18,
-                    internode_zigzag: 0.04,
-                    kink_sharpness: 0.48,
-                    bark_displacement: 0.08,
-                    parent_collar_bulge: 0.26,
-                    knot_count: 6,
-                    knot_strength: 0.16,
-                    split_probability: 0.0,
-                    flare_amplitude: 0.28,
-                    flare_height_ratio: 0.15,
-                    flare_lobes: 4,
-                    flare_sharpness: 3.0,
-                    flute_amplitude: 0.015,
-                    flute_frequency: 3,
-                    collar_weld_rings: 0
-                },
-                {
-                    level: 1,
-                    segments: 7,
-                    radial_segments_max: 7,
-                    radial_segments_min: 4,
-                    length: 4.2,
-                    length_variance: 0.12,
-                    length_profile: AnimationCurve.linear(0, 1.0, 1, 0.28),
-                    radius_ratio: 0.035,
-                    taper: 0.85,
-                    bare_length_ratio: 0.12,
-                    child_count: 7,
-                    phyllotaxis_mode: PhyllotaxisMode.AlternateDistichous,
-                    azimuth_jitter: 0.16,
-                    insertion_angle: 0.88,
-                    insertion_angle_variation: 0.12,
-                    curvature: 0.22,
-                    curve_back: -0.16,
-                    gravitropism: 0.22,
-                    phototropism: 0.18,
-                    gnarl_strength: 0.16,
-                    nodal_kink_strength: 0.55,
-                    internode_zigzag: 0.11,
-                    kink_sharpness: 0.55,
-                    tip_upcurl: 0.36,
-                    oval_eccentricity: 0.16,
-                    bark_displacement: 0.06,
-                    knot_count: 2,
-                    knot_strength: 0.12,
-                    collar_weld_rings: 2
-                },
-                {
-                    level: 2,
-                    segments: 5,
-                    radial_segments_max: 5,
-                    radial_segments_min: 3,
-                    length: 1.5,
-                    length_variance: 0.15,
-                    length_profile: AnimationCurve.linear(0, 0.95, 1, 0.45),
-                    radius_ratio: 0.032,
-                    taper: 0.85,
-                    bare_length_ratio: 0.08,
-                    child_count: 0,
-                    insertion_angle: 0.78,
-                    curvature: 0.16,
-                    gravitropism: 0.08,
-                    phototropism: 0.24,
-                    gnarl_strength: 0.14,
-                    internode_zigzag: 0.14,
-                    tip_upcurl: 0.32,
-                    collar_weld_rings: 1
-                }
-            ];
-            config.applyOverrides({ levels: config.levels, replace_levels: true });
-            config.foliage.applyOverrides({
-                enabled: true,
-                card_type: FoliageCardType.TriStarCluster,
-                attach_min_level: 1,
-                cards_per_branch: 8,
-                terminal_rosette_count: 3,
-                bare_ratio: 0.18,
-                phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
-                card_width: 0.82,
-                card_length: 0.88,
-                phototropism: 0.45,
-                gravitropism: 0.12
-            });
-            config.bark_material.applyOverrides({
-                bark_type: "plated",
-                primary_color: [0.39, 0.28, 0.21],
-                secondary_color: [0.14, 0.11, 0.09],
-                inner_bark_color: [0.46, 0.31, 0.21],
-                fissure_frequency: 6,
-                fissure_depth: 0.76,
-                plate_terrace: 0.52,
-                knot_amount: 0.45,
-                roughness: 0.90
-            });
-            config.foliage_material.applyOverrides({
-                primary_color: [0.13, 0.32, 0.14],
-                secondary_color: [0.08, 0.22, 0.09],
-                leaf_shape: "needle",
-                leaflets_per_cluster: 9,
-                roughness: 0.55
-            });
-            break;
-        }
-
-        case TreePreset.Birch: {
-            config.name = "birch";
-            config.preset = TreePreset.Birch;
-            config.crown.applyOverrides({
-                envelope_type: CrownEnvelopeType.Flame,
-                height: 12.5,
-                radius: 3.4,
-                base_height: 2.5,
-                prune_ratio: 0.3,
-                space_colonization_weight: 0.25,
-                pipe_model_exponent: 2.15,
-                pipe_model_weight: 0.6
-            });
-            config.levels = [
-                {
-                    level: 0,
-                    segments: 12,
-                    radial_segments_max: 14,
-                    radial_segments_min: 8,
-                    length: 11.5,
-                    length_variance: 0.08,
-                    radius_ratio: 0.032,
-                    taper: 0.86,
-                    bare_length_ratio: 0.24,
-                    child_count: 12,
-                    phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
-                    insertion_angle: 0.58,
-                    insertion_angle_variation: 0.14,
-                    curvature: 0.32,
-                    curve_back: -0.22,
-                    spiral_twist: 0.28,
-                    gravitropism: -0.06,
-                    phototropism: 0.20,
-                    gnarl_strength: 0.15,
-                    gnarl_frequency: 0.36,
-                    basal_lean: 0.04,
-                    nodal_kink_strength: 0.48,
-                    internode_zigzag: 0.07,
-                    kink_sharpness: 0.62,
-                    bark_displacement: 0.075,
-                    parent_collar_bulge: 0.30,
-                    knot_count: 6,
-                    knot_strength: 0.16,
-                    split_probability: 0.28,
-                    split_count: 2,
-                    split_angle: 0.38,
-                    flare_amplitude: 0.24,
-                    flare_height_ratio: 0.15,
-                    flare_lobes: 4,
-                    flute_amplitude: 0.010,
-                    flute_frequency: 3,
-                    collar_weld_rings: 0
-                },
-                {
-                    level: 1,
-                    segments: 8,
-                    radial_segments_max: 7,
-                    radial_segments_min: 4,
-                    length: 3.6,
-                    length_variance: 0.15,
-                    length_profile: AnimationCurve.linear(0, 0.85, 1, 0.45),
-                    radius_ratio: 0.034,
-                    taper: 0.86,
-                    bare_length_ratio: 0.15,
-                    child_count: 6,
-                    phyllotaxis_mode: PhyllotaxisMode.AlternateDistichous,
-                    insertion_angle: 0.58,
-                    curvature: 0.28,
-                    curve_back: -0.18,
-                    gravitropism: 0.22,
-                    phototropism: 0.24,
-                    gnarl_strength: 0.20,
-                    nodal_kink_strength: 0.72,
-                    internode_zigzag: 0.15,
-                    kink_sharpness: 0.65,
-                    tip_upcurl: 0.20,
-                    oval_eccentricity: 0.15,
-                    bark_displacement: 0.06,
-                    knot_count: 3,
-                    knot_strength: 0.14,
-                    collar_weld_rings: 2
-                },
-                {
-                    level: 2,
-                    segments: 6,
-                    radial_segments_max: 5,
-                    radial_segments_min: 3,
-                    length: 1.7,
-                    length_variance: 0.18,
-                    radius_ratio: 0.028,
-                    taper: 0.9,
-                    bare_length_ratio: 0.1,
-                    child_count: 0,
-                    phyllotaxis_mode: PhyllotaxisMode.AlternateDistichous,
-                    insertion_angle: 0.52,
-                    curvature: 0.32,
-                    gravitropism: 0.42,
-                    phototropism: 0.12,
-                    gnarl_strength: 0.18,
-                    internode_zigzag: 0.18,
-                    kink_sharpness: 0.58,
-                    tip_upcurl: 0.06,
-                    collar_weld_rings: 1
-                }
-            ];
-            config.applyOverrides({ levels: config.levels, replace_levels: true });
-            config.foliage.applyOverrides({
-                enabled: true,
-                card_type: FoliageCardType.FoldedVCard,
-                attach_min_level: 1,
-                cards_per_branch: 8,
-                terminal_rosette_count: 3,
-                card_width: 0.75,
-                card_length: 0.85,
-                fold_angle: 0.24,
-                gravitropism: 0.35,
-                phototropism: 0.55
-            });
-            config.bark_material.applyOverrides({
-                bark_type: "birch",
-                primary_color: [0.85, 0.83, 0.80],
-                secondary_color: [0.17, 0.16, 0.15],
-                inner_bark_color: [0.52, 0.35, 0.23],
-                moss_color: [0.24, 0.30, 0.19],
-                moss_amount: 0.04,
-                fissure_frequency: 4,
-                fissure_depth: 0.62,
-                lenticel_amount: 0.78,
-                peel_amount: 0.35,
-                knot_amount: 0.58,
-                roughness: 0.88
-            });
-            config.foliage_material.applyOverrides({
-                primary_color: [0.32, 0.52, 0.18],
-                secondary_color: [0.22, 0.40, 0.12],
-                leaf_shape: "serrated",
-                leaflets_per_cluster: 5,
-                roughness: 0.52
-            });
-            break;
-        }
-
-        case TreePreset.Willow: {
-            config.name = "willow";
-            config.preset = TreePreset.Willow;
-            config.crown.applyOverrides({
-                envelope_type: CrownEnvelopeType.Weeping,
-                height: 11.0,
-                radius: 5.5,
-                base_height: 1.6,
-                prune_ratio: 0.2,
-                space_colonization_weight: 0.2,
-                pipe_model_exponent: 2.25,
-                pipe_model_weight: 0.65
-            });
-            config.levels = [
-                {
-                    level: 0,
-                    segments: 11,
-                    radial_segments_max: 13,
-                    radial_segments_min: 7,
-                    length: 7.5,
-                    radius_ratio: 0.065,
-                    taper: 0.75,
-                    bare_length_ratio: 0.25,
-                    child_count: 9,
-                    insertion_angle: 0.68,
-                    curvature: 0.32,
-                    curve_back: -0.18,
-                    spiral_twist: 0.38,
-                    gravitropism: -0.05,
-                    phototropism: 0.15,
-                    gnarl_strength: 0.18,
-                    basal_lean: 0.05,
-                    nodal_kink_strength: 0.55,
-                    internode_zigzag: 0.08,
-                    kink_sharpness: 0.65,
-                    bark_displacement: 0.11,
-                    parent_collar_bulge: 0.35,
-                    knot_count: 6,
-                    knot_strength: 0.20,
-                    split_probability: 0.35,
-                    split_count: 2,
-                    split_angle: 0.52,
-                    flare_amplitude: 0.38,
-                    flare_lobes: 5,
-                    flute_amplitude: 0.055,
-                    flute_frequency: 5,
-                    collar_weld_rings: 0
-                },
-                {
-                    level: 1,
-                    segments: 8,
-                    radial_segments_max: 8,
-                    radial_segments_min: 4,
-                    length: 4.8,
-                    radius_ratio: 0.042,
-                    taper: 0.84,
-                    bare_length_ratio: 0.15,
-                    child_count: 9,
-                    insertion_angle: 0.65,
-                    curvature: 0.38,
-                    curve_back: -0.15,
-                    gravitropism: 0.32,
-                    phototropism: 0.22,
-                    gnarl_strength: 0.22,
-                    nodal_kink_strength: 0.72,
-                    internode_zigzag: 0.14,
-                    kink_sharpness: 0.60,
-                    tip_upcurl: 0.10,
-                    oval_eccentricity: 0.18,
-                    bark_displacement: 0.08,
-                    knot_count: 3,
-                    knot_strength: 0.15,
-                    collar_weld_rings: 2
-                },
-                {
-                    level: 2,
-                    segments: 8,
-                    radial_segments_max: 4,
-                    radial_segments_min: 3,
-                    length: 3.4,
-                    radius_ratio: 0.02,
-                    taper: 0.92,
-                    bare_length_ratio: 0.08,
-                    child_count: 0,
-                    insertion_angle: 0.55,
-                    curvature: 0.45,
-                    gravitropism: 0.88,
-                    phototropism: 0.04,
-                    gnarl_strength: 0.12,
-                    internode_zigzag: 0.09,
-                    kink_sharpness: 0.25,
-                    tip_upcurl: 0.0,
-                    collar_weld_rings: 1
-                }
-            ];
-            config.applyOverrides({ levels: config.levels, replace_levels: true });
-            config.foliage.applyOverrides({
-                enabled: true,
-                card_type: FoliageCardType.RibbedFrond,
-                attach_min_level: 2,
-                cards_per_branch: 9,
-                terminal_rosette_count: 2,
-                card_width: 0.55,
-                card_length: 1.35,
-                arch_height: 0.12,
-                camber_droop: 0.28,
-                frond_segments: 5,
-                gravitropism: 0.72,
-                phototropism: 0.25
-            });
-            config.bark_material.applyOverrides({
-                bark_type: "fissured",
-                primary_color: [0.35, 0.32, 0.27],
-                secondary_color: [0.15, 0.13, 0.11],
-                inner_bark_color: [0.39, 0.32, 0.25],
-                fissure_frequency: 8,
-                fissure_depth: 0.76,
-                roughness: 0.91
-            });
-            config.foliage_material.applyOverrides({
-                primary_color: [0.34, 0.50, 0.20],
-                secondary_color: [0.24, 0.38, 0.14],
-                leaf_shape: "frond",
-                leaflets_per_cluster: 9
-            });
-            break;
-        }
-
-        case TreePreset.Maple: {
-            config.name = "maple";
-            config.preset = TreePreset.Maple;
-            config.crown.applyOverrides({
-                envelope_type: CrownEnvelopeType.Spherical,
-                height: 11.5,
-                radius: 4.8,
-                base_height: 2.2,
-                prune_ratio: 0.35,
-                space_colonization_weight: 0.3,
-                pipe_model_exponent: 2.25,
-                pipe_model_weight: 0.65
-            });
-            config.levels[0].applyOverrides({
-                phyllotaxis_mode: PhyllotaxisMode.OppositeDecussate,
-                child_count: 10,
-                flare_amplitude: 0.3,
-                flare_lobes: 5
-            });
-            config.levels[1].applyOverrides({
-                phyllotaxis_mode: PhyllotaxisMode.OppositeDecussate,
-                child_count: 8,
-                insertion_angle: 0.68
-            });
-            config.levels[2].applyOverrides({
-                phyllotaxis_mode: PhyllotaxisMode.OppositeDecussate
-            });
-            config.foliage.applyOverrides({
-                enabled: true,
-                card_type: FoliageCardType.OctagonalCutoutHull,
-                attach_min_level: 1,
-                cards_per_branch: 8,
-                terminal_rosette_count: 3,
-                phyllotaxis_mode: PhyllotaxisMode.OppositeDecussate,
-                card_width: 0.9,
-                card_length: 0.95,
-                fold_angle: 0.25
-            });
-            config.bark_material.applyOverrides({
-                bark_type: "fissured",
-                primary_color: [0.36, 0.34, 0.31],
-                secondary_color: [0.16, 0.15, 0.14],
-                inner_bark_color: [0.38, 0.32, 0.27],
-                fissure_frequency: 7,
-                fissure_depth: 0.66,
-                roughness: 0.90
-            });
-            config.foliage_material.applyOverrides({
-                primary_color: [0.24, 0.45, 0.15],
-                secondary_color: [0.42, 0.28, 0.12],
-                autumn_tint: 0.22,
-                leaf_shape: "palmate",
-                leaflets_per_cluster: 5
-            });
-            break;
-        }
-
-        case TreePreset.Spruce: {
-            config.name = "spruce";
-            config.preset = TreePreset.Spruce;
-            config.crown.applyOverrides({
-                envelope_type: CrownEnvelopeType.Conical,
-                height: 11.5,
-                radius: 3.8,
-                base_height: 1.4,
-                prune_ratio: 0.3,
-                space_colonization_weight: 0.08,
-                pipe_model_exponent: 2.45,
-                pipe_model_weight: 0.55,
-                sky_phototropism_mix: 0.3
-            });
-            config.levels = [
-                {
-                    level: 0,
-                    segments: 10,
-                    radial_segments_max: 10,
-                    radial_segments_min: 4,
-                    length: 11.8,
-                    radius_ratio: 0.036,
-                    taper: 0.92,
-                    bare_length_ratio: 0.12,
-                    child_count: 35,
-                    phyllotaxis_mode: PhyllotaxisMode.Whorled,
-                    whorl_count: 5,
-                    insertion_angle: 1.38,
-                    insertion_angle_profile: AnimationCurve.linear(0, 1.05, 1, 0.72),
-                    curvature: 0.02,
-                    gravitropism: -0.08,
-                    phototropism: 0.06,
-                    gnarl_strength: 0.02,
-                    flare_amplitude: 0.2,
-                    flare_lobes: 4,
-                    collar_weld_rings: 0
-                },
-                {
-                    level: 1,
-                    segments: 5,
-                    radial_segments_max: 6,
-                    radial_segments_min: 3,
-                    length: 3.8,
-                    length_profile: AnimationCurve.linear(0, 1.0, 1, 0.22),
-                    radius_ratio: 0.032,
-                    taper: 0.86,
-                    bare_length_ratio: 0.1,
-                    child_count: 6,
-                    phyllotaxis_mode: PhyllotaxisMode.AlternateDistichous,
-                    insertion_angle: 0.9,
-                    curvature: 0.22,
-                    curve_back: -0.10,
-                    gravitropism: 0.16,
-                    phototropism: 0.12,
-                    collar_weld_rings: 2
-                },
-                {
-                    level: 2,
-                    segments: 3,
-                    radial_segments_max: 4,
-                    radial_segments_min: 3,
-                    length: 1.1,
-                    radius_ratio: 0.03,
-                    taper: 0.85,
-                    bare_length_ratio: 0.08,
-                    child_count: 0,
-                    insertion_angle: 0.8,
-                    curvature: 0.15,
-                    gravitropism: 0.18,
-                    phototropism: 0.2,
-                    collar_weld_rings: 1
-                }
-            ];
-            config.applyOverrides({ levels: config.levels, replace_levels: true });
-            config.foliage.applyOverrides({
-                enabled: true,
-                card_type: FoliageCardType.CrossCard,
-                attach_min_level: 1,
-                cards_per_branch: 7,
-                terminal_rosette_count: 2,
-                card_width: 0.68,
-                card_length: 0.75
-            });
-            config.bark_material.applyOverrides({
-                bark_type: "plated",
-                primary_color: [0.36, 0.29, 0.24],
-                secondary_color: [0.15, 0.12, 0.10],
-                inner_bark_color: [0.42, 0.30, 0.22],
-                fissure_frequency: 8,
-                fissure_depth: 0.72,
-                roughness: 0.91
-            });
-            config.foliage_material.applyOverrides({
-                primary_color: [0.11, 0.27, 0.15],
-                secondary_color: [0.07, 0.18, 0.10],
-                leaf_shape: "needle",
-                leaflets_per_cluster: 9
-            });
-            break;
-        }
-
-        case TreePreset.Palm: {
-            config.name = "palm";
-            config.preset = TreePreset.Palm;
-            config.crown.applyOverrides({
-                envelope_type: CrownEnvelopeType.Hemispherical,
-                height: 11.0,
-                radius: 4.2,
-                base_height: 7.5,
-                prune_ratio: 0.1,
-                space_colonization_weight: 0.0,
-                pipe_model_weight: 0.15
-            });
-            config.levels = [
-                {
-                    level: 0,
-                    segments: 10,
-                    radial_segments_max: 10,
-                    radial_segments_min: 7,
-                    length: 9.5,
-                    radius_ratio: 0.038,
-                    taper: 0.35,
-                    bare_length_ratio: 0.92,
-                    child_count: 12,
-                    phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
-                    insertion_angle: 0.95,
-                    insertion_angle_variation: 0.25,
-                    curvature: 0.28,
-                    curve_back: -0.12,
-                    gravitropism: -0.08,
-                    phototropism: 0.22,
-                    gnarl_strength: 0.04,
-                    flare_amplitude: 0.25,
-                    flare_height_ratio: 0.12,
-                    flare_lobes: 6,
-                    collar_weld_rings: 0
-                },
-                {
-                    level: 1,
-                    segments: 5,
-                    radial_segments_max: 5,
-                    radial_segments_min: 3,
-                    length: 2.8,
-                    radius_ratio: 0.025,
-                    taper: 0.9,
-                    bare_length_ratio: 0.05,
-                    child_count: 0,
-                    insertion_angle: 0.85,
-                    curvature: 0.55,
-                    gravitropism: 0.48,
-                    phototropism: 0.15,
-                    collar_weld_rings: 1
-                }
-            ];
-            config.applyOverrides({ levels: config.levels, replace_levels: true });
-            config.foliage.applyOverrides({
-                enabled: true,
-                card_type: FoliageCardType.RibbedFrond,
-                attach_min_level: 1,
-                cards_per_branch: 4,
-                terminal_rosette_count: 3,
-                bare_ratio: 0.05,
-                card_width: 0.95,
-                card_length: 1.85,
-                fold_angle: 0.32,
-                arch_height: 0.22,
-                camber_droop: 0.32,
-                frond_segments: 6,
-                gravitropism: 0.45,
-                phototropism: 0.4
-            });
-            config.bark_material.applyOverrides({
-                bark_type: "ringed",
-                primary_color: [0.54, 0.46, 0.36],
-                secondary_color: [0.26, 0.21, 0.15],
-                fissure_frequency: 5,
-                fissure_depth: 0.62,
-                lenticel_amount: 0.45
-            });
-            config.foliage_material.applyOverrides({
-                primary_color: [0.22, 0.46, 0.14],
-                secondary_color: [0.15, 0.34, 0.09],
-                leaf_shape: "frond",
-                leaflets_per_cluster: 11
-            });
-            break;
-        }
-
-        case TreePreset.Shrub: {
-            config.name = "shrub";
-            config.preset = TreePreset.Shrub;
-            config.crown.applyOverrides({
-                envelope_type: CrownEnvelopeType.Hemispherical,
-                height: 2.8,
-                radius: 2.2,
-                base_height: 0.15,
-                prune_ratio: 0.25,
-                space_colonization_weight: 0.3,
-                pipe_model_exponent: 2.1,
-                pipe_model_weight: 0.55
-            });
-            config.levels = [
-                {
-                    level: 0,
-                    segments: 5,
-                    radial_segments_max: 7,
-                    radial_segments_min: 4,
-                    length: 1.8,
-                    radius_ratio: 0.055,
-                    taper: 0.8,
-                    bare_length_ratio: 0.08,
-                    child_count: 8,
-                    phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
-                    insertion_angle: 0.82,
-                    curvature: 0.25,
-                    gravitropism: -0.05,
-                    phototropism: 0.28,
-                    gnarl_strength: 0.12,
-                    split_probability: 0.45,
-                    split_count: 3,
-                    split_angle: 0.52,
-                    collar_weld_rings: 0
-                },
-                {
-                    level: 1,
-                    segments: 4,
-                    radial_segments_max: 5,
-                    radial_segments_min: 3,
-                    length: 1.2,
-                    radius_ratio: 0.04,
-                    taper: 0.85,
-                    bare_length_ratio: 0.1,
-                    child_count: 0,
-                    insertion_angle: 0.72,
-                    curvature: 0.2,
-                    gravitropism: 0.06,
-                    phototropism: 0.35,
-                    collar_weld_rings: 1
-                }
-            ];
-            config.applyOverrides({ levels: config.levels, replace_levels: true });
-            config.foliage.applyOverrides({
-                enabled: true,
-                card_type: FoliageCardType.FoldedVCard,
-                attach_min_level: 1,
-                cards_per_branch: 9,
-                terminal_rosette_count: 4,
-                card_width: 0.55,
-                card_length: 0.62,
-                phototropism: 0.7
-            });
-            config.foliage_material.applyOverrides({
-                primary_color: [0.22, 0.44, 0.16],
-                secondary_color: [0.14, 0.30, 0.10],
-                leaf_shape: "ovate",
-                leaflets_per_cluster: 7
-            });
-            break;
-        }
-
-        case TreePreset.Fern: {
-            config.name = "fern";
-            config.preset = TreePreset.Fern;
-            config.crown.applyOverrides({
-                envelope_type: CrownEnvelopeType.InverseConical,
-                height: 1.6,
-                radius: 1.5,
-                base_height: 0.05,
-                prune_ratio: 0.05,
-                space_colonization_weight: 0.0,
-                pipe_model_weight: 0.2
-            });
-            config.levels = [
-                {
-                    level: 0,
-                    segments: 3,
-                    radial_segments_max: 6,
-                    radial_segments_min: 4,
-                    length: 0.35,
-                    radius_ratio: 0.18,
-                    taper: 0.6,
-                    bare_length_ratio: 0.1,
-                    child_count: 9,
-                    phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
-                    insertion_angle: 0.95,
-                    curvature: 0.1,
-                    collar_weld_rings: 0
-                },
-                {
-                    level: 1,
-                    segments: 5,
-                    radial_segments_max: 4,
-                    radial_segments_min: 3,
-                    length: 1.15,
-                    radius_ratio: 0.025,
-                    taper: 0.92,
-                    bare_length_ratio: 0.05,
-                    child_count: 0,
-                    insertion_angle: 0.85,
-                    curvature: 0.48,
-                    gravitropism: 0.38,
-                    phototropism: 0.2,
-                    collar_weld_rings: 1
-                }
-            ];
-            config.applyOverrides({ levels: config.levels, replace_levels: true });
-            config.foliage.applyOverrides({
-                enabled: true,
-                card_type: FoliageCardType.RibbedFrond,
-                attach_min_level: 1,
-                cards_per_branch: 3,
-                terminal_rosette_count: 2,
-                bare_ratio: 0.05,
-                card_width: 0.48,
-                card_length: 0.95,
-                fold_angle: 0.28,
-                arch_height: 0.16,
-                camber_droop: 0.24,
-                frond_segments: 6,
-                gravitropism: 0.35,
-                phototropism: 0.55
-            });
-            config.foliage_material.applyOverrides({
-                primary_color: [0.24, 0.50, 0.16],
-                secondary_color: [0.16, 0.36, 0.10],
-                leaf_shape: "frond",
-                leaflets_per_cluster: 11
-            });
-            break;
-        }
-
-        case TreePreset.Oak:
-        default: {
-            config.name = "oak";
-            config.preset = TreePreset.Oak;
-            break;
-        }
-    }
-
-    if (overrides !== undefined && overrides !== null) {
-        config.applyOverrides(overrides);
-    }
-
-    return config;
-}
+import { AnimationCurve } from "../../../engine/animation/curve/AnimationCurve.js";
+import { CrownEnvelopeType } from "../config/CrownEnvelopeType.js";
+import { FoliageBarkType } from "../config/FoliageBarkType.js";
+import { FoliageCardType } from "../config/FoliageCardType.js";
+import { PhyllotaxisMode } from "../config/PhyllotaxisMode.js";
+import { TreePreset } from "../config/TreePreset.js";
+import { TreeSpeciesConfig } from "../config/TreeSpeciesConfig.js";
+
+/**
+ * Returns a rich, botanically tuned `TreeSpeciesConfig` for one of the 9 built-in
+ * `TreePreset` archetypes (`Oak`, `Pine`, `Birch`, `Willow`, `Maple`, `Spruce`, `Palm`, `Shrub`, `Fern`),
+ * with optional deep parameter overrides.
+ *
+ * @param {TreePreset|string} [preset=TreePreset.Oak]
+ * @param {Object} [overrides]
+ * @returns {TreeSpeciesConfig}
+ */
+export function make_tree_species_preset(preset = TreePreset.Oak, overrides = {}) {
+	const config = new TreeSpeciesConfig();
+	const key = typeof preset === "string" ? preset.toLowerCase() : TreePreset.Oak;
+
+	switch (key) {
+		case TreePreset.Pine: {
+			config.name = "pine";
+			config.preset = TreePreset.Pine;
+			config.crown.applyOverrides({
+				envelope_type: CrownEnvelopeType.Conical,
+				height: 8.6,
+				radius: 4.2,
+				base_height: 2.2,
+				prune_ratio: 0.25,
+				space_colonization_weight: 0.08,
+				pipe_model_exponent: 2.4,
+				pipe_model_weight: 0.55,
+				sky_phototropism_mix: 0.35
+			});
+			config.levels = [
+				{
+					level: 0,
+					segments: 12,
+					radial_segments_max: 14,
+					radial_segments_min: 8,
+					length: 11.2,
+					length_variance: 0.05,
+					radius_ratio: 0.038,
+					taper: 0.88,
+					bare_length_ratio: 0.24,
+					child_count: 32,
+					phyllotaxis_mode: PhyllotaxisMode.Whorled,
+					whorl_count: 4,
+					azimuth_jitter: 0.16,
+					insertion_angle: 1.34,
+					insertion_angle_variation: 0.08,
+					insertion_angle_profile: AnimationCurve.linear(0, 1.05, 1, 0.52),
+					curvature: 0.16,
+					curve_back: -0.10,
+					spiral_twist: 0.22,
+					gravitropism: -0.06,
+					phototropism: 0.10,
+					gnarl_strength: 0.09,
+					gnarl_frequency: 0.32,
+					basal_lean: 0.015,
+					nodal_kink_strength: 0.18,
+					internode_zigzag: 0.04,
+					kink_sharpness: 0.48,
+					bark_displacement: 0.08,
+					parent_collar_bulge: 0.26,
+					knot_count: 6,
+					knot_strength: 0.16,
+					split_probability: 0.0,
+					flare_amplitude: 0.28,
+					flare_height_ratio: 0.15,
+					flare_lobes: 4,
+					flare_sharpness: 3.0,
+					flute_amplitude: 0.015,
+					flute_frequency: 3,
+					collar_weld_rings: 0
+				},
+				{
+					level: 1,
+					segments: 7,
+					radial_segments_max: 7,
+					radial_segments_min: 4,
+					length: 3.8,
+					length_variance: 0.10,
+					length_profile: AnimationCurve.linear(0, 1.0, 1, 0.72),
+					radius_ratio: 0.035,
+					taper: 0.85,
+					bare_length_ratio: 0.12,
+					child_count: 7,
+					phyllotaxis_mode: PhyllotaxisMode.AlternateDistichous,
+					azimuth_jitter: 0.14,
+					insertion_angle: 0.88,
+					insertion_angle_variation: 0.10,
+					curvature: 0.16,
+					curve_back: -0.12,
+					gravitropism: 0.22,
+					phototropism: 0.16,
+					gnarl_strength: 0.12,
+					nodal_kink_strength: 0.42,
+					internode_zigzag: 0.09,
+					kink_sharpness: 0.55,
+					tip_upcurl: 0.34,
+					oval_eccentricity: 0.16,
+					bark_displacement: 0.06,
+					knot_count: 2,
+					knot_strength: 0.12,
+					collar_weld_rings: 2
+				},
+				{
+					level: 2,
+					segments: 5,
+					radial_segments_max: 5,
+					radial_segments_min: 3,
+					length: 1.4,
+					length_variance: 0.14,
+					length_profile: AnimationCurve.linear(0, 0.95, 1, 0.48),
+					radius_ratio: 0.032,
+					taper: 0.85,
+					bare_length_ratio: 0.08,
+					child_count: 0,
+					insertion_angle: 0.78,
+					curvature: 0.14,
+					gravitropism: 0.08,
+					phototropism: 0.24,
+					gnarl_strength: 0.12,
+					internode_zigzag: 0.12,
+					tip_upcurl: 0.32,
+					collar_weld_rings: 1
+				}
+			];
+			config.applyOverrides({ levels: config.levels, replace_levels: true });
+			config.foliage.applyOverrides({
+				enabled: true,
+				card_type: FoliageCardType.TriStarCluster,
+				attach_min_level: 1,
+				cards_per_branch: 8,
+				terminal_rosette_count: 3,
+				bare_ratio: 0.18,
+				phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
+				card_width: 0.82,
+				card_length: 0.88,
+				phototropism: 0.45,
+				gravitropism: 0.12
+			});
+			config.bark_material.applyOverrides({
+				bark_type: FoliageBarkType.Plated,
+				primary_color: [0.39, 0.28, 0.21],
+				secondary_color: [0.14, 0.11, 0.09],
+				inner_bark_color: [0.46, 0.31, 0.21],
+				fissure_frequency: 6,
+				fissure_depth: 0.76,
+				plate_terrace: 0.52,
+				knot_amount: 0.45,
+				roughness: 0.90
+			});
+			config.foliage_material.applyOverrides({
+				primary_color: [0.13, 0.32, 0.14],
+				secondary_color: [0.08, 0.22, 0.09],
+				leaf_shape: "needle",
+				leaflets_per_cluster: 9,
+				roughness: 0.55,
+				juvenile_color_shift: 0.46,
+				juvenile_anthocyanin: 0.0,
+				carotenoid_density: 0.35,
+				anthocyanin_potential: 0.0,
+				tannin_oxidation: 0.30
+			});
+			break;
+		}
+
+		case TreePreset.Birch: {
+			config.name = "birch";
+			config.preset = TreePreset.Birch;
+			config.crown.applyOverrides({
+				envelope_type: CrownEnvelopeType.Flame,
+				height: 12.5,
+				radius: 3.4,
+				base_height: 2.5,
+				prune_ratio: 0.3,
+				space_colonization_weight: 0.25,
+				pipe_model_exponent: 2.15,
+				pipe_model_weight: 0.6
+			});
+			config.levels = [
+				{
+					level: 0,
+					segments: 12,
+					radial_segments_max: 14,
+					radial_segments_min: 8,
+					length: 11.5,
+					length_variance: 0.08,
+					radius_ratio: 0.032,
+					taper: 0.86,
+					bare_length_ratio: 0.24,
+					child_count: 12,
+					phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
+					insertion_angle: 0.58,
+					insertion_angle_variation: 0.14,
+					curvature: 0.32,
+					curve_back: -0.22,
+					spiral_twist: 0.28,
+					gravitropism: -0.06,
+					phototropism: 0.20,
+					gnarl_strength: 0.15,
+					gnarl_frequency: 0.36,
+					basal_lean: 0.04,
+					nodal_kink_strength: 0.48,
+					internode_zigzag: 0.07,
+					kink_sharpness: 0.62,
+					bark_displacement: 0.075,
+					parent_collar_bulge: 0.30,
+					knot_count: 6,
+					knot_strength: 0.16,
+					split_probability: 0.28,
+					split_count: 2,
+					split_angle: 0.38,
+					flare_amplitude: 0.24,
+					flare_height_ratio: 0.15,
+					flare_lobes: 4,
+					flute_amplitude: 0.010,
+					flute_frequency: 3,
+					collar_weld_rings: 0
+				},
+				{
+					level: 1,
+					segments: 8,
+					radial_segments_max: 7,
+					radial_segments_min: 4,
+					length: 3.6,
+					length_variance: 0.15,
+					length_profile: AnimationCurve.linear(0, 0.85, 1, 0.45),
+					radius_ratio: 0.034,
+					taper: 0.86,
+					bare_length_ratio: 0.15,
+					child_count: 6,
+					phyllotaxis_mode: PhyllotaxisMode.AlternateDistichous,
+					insertion_angle: 0.58,
+					curvature: 0.28,
+					curve_back: -0.18,
+					gravitropism: 0.22,
+					phototropism: 0.24,
+					gnarl_strength: 0.20,
+					nodal_kink_strength: 0.72,
+					internode_zigzag: 0.15,
+					kink_sharpness: 0.65,
+					tip_upcurl: 0.20,
+					oval_eccentricity: 0.15,
+					bark_displacement: 0.06,
+					knot_count: 3,
+					knot_strength: 0.14,
+					collar_weld_rings: 2
+				},
+				{
+					level: 2,
+					segments: 6,
+					radial_segments_max: 5,
+					radial_segments_min: 3,
+					length: 1.7,
+					length_variance: 0.18,
+					radius_ratio: 0.028,
+					taper: 0.9,
+					bare_length_ratio: 0.1,
+					child_count: 0,
+					phyllotaxis_mode: PhyllotaxisMode.AlternateDistichous,
+					insertion_angle: 0.52,
+					curvature: 0.32,
+					gravitropism: 0.42,
+					phototropism: 0.12,
+					gnarl_strength: 0.18,
+					internode_zigzag: 0.18,
+					kink_sharpness: 0.58,
+					tip_upcurl: 0.06,
+					collar_weld_rings: 1
+				}
+			];
+			config.applyOverrides({ levels: config.levels, replace_levels: true });
+			config.foliage.applyOverrides({
+				enabled: true,
+				card_type: FoliageCardType.FoldedVCard,
+				attach_min_level: 1,
+				cards_per_branch: 8,
+				terminal_rosette_count: 3,
+				card_width: 0.75,
+				card_length: 0.85,
+				fold_angle: 0.24,
+				gravitropism: 0.35,
+				phototropism: 0.55
+			});
+			config.bark_material.applyOverrides({
+				bark_type: FoliageBarkType.Birch,
+				primary_color: [0.85, 0.83, 0.80],
+				secondary_color: [0.17, 0.16, 0.15],
+				inner_bark_color: [0.52, 0.35, 0.23],
+				moss_color: [0.24, 0.30, 0.19],
+				moss_amount: 0.04,
+				fissure_frequency: 4,
+				fissure_depth: 0.62,
+				lenticel_amount: 0.78,
+				peel_amount: 0.35,
+				knot_amount: 0.58,
+				roughness: 0.88
+			});
+			config.foliage_material.applyOverrides({
+				primary_color: [0.32, 0.52, 0.18],
+				secondary_color: [0.22, 0.40, 0.12],
+				leaf_shape: "serrated",
+				leaflets_per_cluster: 5,
+				roughness: 0.52,
+				juvenile_color_shift: 0.42,
+				juvenile_anthocyanin: 0.0,
+				carotenoid_density: 0.94,
+				anthocyanin_potential: 0.06,
+				tannin_oxidation: 0.16
+			});
+			break;
+		}
+
+		case TreePreset.Willow: {
+			config.name = "willow";
+			config.preset = TreePreset.Willow;
+			config.crown.applyOverrides({
+				envelope_type: CrownEnvelopeType.Weeping,
+				height: 11.0,
+				radius: 5.5,
+				base_height: 1.6,
+				prune_ratio: 0.2,
+				space_colonization_weight: 0.2,
+				pipe_model_exponent: 2.25,
+				pipe_model_weight: 0.65
+			});
+			config.levels = [
+				{
+					level: 0,
+					segments: 11,
+					radial_segments_max: 13,
+					radial_segments_min: 7,
+					length: 7.5,
+					radius_ratio: 0.065,
+					taper: 0.75,
+					bare_length_ratio: 0.25,
+					child_count: 9,
+					insertion_angle: 0.68,
+					curvature: 0.32,
+					curve_back: -0.18,
+					spiral_twist: 0.38,
+					gravitropism: -0.05,
+					phototropism: 0.15,
+					gnarl_strength: 0.18,
+					basal_lean: 0.05,
+					nodal_kink_strength: 0.55,
+					internode_zigzag: 0.08,
+					kink_sharpness: 0.65,
+					bark_displacement: 0.11,
+					parent_collar_bulge: 0.35,
+					knot_count: 6,
+					knot_strength: 0.20,
+					split_probability: 0.35,
+					split_count: 2,
+					split_angle: 0.52,
+					flare_amplitude: 0.38,
+					flare_lobes: 5,
+					flute_amplitude: 0.055,
+					flute_frequency: 5,
+					collar_weld_rings: 0
+				},
+				{
+					level: 1,
+					segments: 8,
+					radial_segments_max: 8,
+					radial_segments_min: 4,
+					length: 4.8,
+					radius_ratio: 0.042,
+					taper: 0.84,
+					bare_length_ratio: 0.15,
+					child_count: 9,
+					insertion_angle: 0.65,
+					curvature: 0.38,
+					curve_back: -0.15,
+					gravitropism: 0.32,
+					phototropism: 0.22,
+					gnarl_strength: 0.22,
+					nodal_kink_strength: 0.72,
+					internode_zigzag: 0.14,
+					kink_sharpness: 0.60,
+					tip_upcurl: 0.10,
+					oval_eccentricity: 0.18,
+					bark_displacement: 0.08,
+					knot_count: 3,
+					knot_strength: 0.15,
+					collar_weld_rings: 2
+				},
+				{
+					level: 2,
+					segments: 8,
+					radial_segments_max: 4,
+					radial_segments_min: 3,
+					length: 3.4,
+					radius_ratio: 0.02,
+					taper: 0.92,
+					bare_length_ratio: 0.08,
+					child_count: 0,
+					insertion_angle: 0.55,
+					curvature: 0.45,
+					gravitropism: 0.88,
+					phototropism: 0.04,
+					gnarl_strength: 0.12,
+					internode_zigzag: 0.09,
+					kink_sharpness: 0.25,
+					tip_upcurl: 0.0,
+					collar_weld_rings: 1
+				}
+			];
+			config.applyOverrides({ levels: config.levels, replace_levels: true });
+			config.foliage.applyOverrides({
+				enabled: true,
+				card_type: FoliageCardType.RibbedFrond,
+				attach_min_level: 2,
+				cards_per_branch: 9,
+				terminal_rosette_count: 2,
+				card_width: 0.55,
+				card_length: 1.35,
+				arch_height: 0.12,
+				camber_droop: 0.28,
+				frond_segments: 5,
+				gravitropism: 0.72,
+				phototropism: 0.25
+			});
+			config.bark_material.applyOverrides({
+				bark_type: FoliageBarkType.Fissured,
+				primary_color: [0.35, 0.32, 0.27],
+				secondary_color: [0.15, 0.13, 0.11],
+				inner_bark_color: [0.39, 0.32, 0.25],
+				fissure_frequency: 8,
+				fissure_depth: 0.76,
+				roughness: 0.91
+			});
+			config.foliage_material.applyOverrides({
+				primary_color: [0.34, 0.50, 0.20],
+				secondary_color: [0.24, 0.38, 0.14],
+				leaf_shape: "frond",
+				leaflets_per_cluster: 9,
+				juvenile_color_shift: 0.44,
+				juvenile_anthocyanin: 0.0,
+				carotenoid_density: 0.84,
+				anthocyanin_potential: 0.04,
+				tannin_oxidation: 0.22
+			});
+			break;
+		}
+
+		case TreePreset.Maple: {
+			config.name = "maple";
+			config.preset = TreePreset.Maple;
+			config.crown.applyOverrides({
+				envelope_type: CrownEnvelopeType.Spherical,
+				height: 11.5,
+				radius: 4.8,
+				base_height: 2.2,
+				prune_ratio: 0.35,
+				space_colonization_weight: 0.3,
+				pipe_model_exponent: 2.25,
+				pipe_model_weight: 0.65
+			});
+			config.levels[0].applyOverrides({
+				phyllotaxis_mode: PhyllotaxisMode.OppositeDecussate,
+				child_count: 10,
+				flare_amplitude: 0.3,
+				flare_lobes: 5
+			});
+			config.levels[1].applyOverrides({
+				phyllotaxis_mode: PhyllotaxisMode.OppositeDecussate,
+				child_count: 8,
+				insertion_angle: 0.68
+			});
+			config.levels[2].applyOverrides({
+				phyllotaxis_mode: PhyllotaxisMode.OppositeDecussate
+			});
+			config.foliage.applyOverrides({
+				enabled: true,
+				card_type: FoliageCardType.OctagonalCutoutHull,
+				attach_min_level: 1,
+				cards_per_branch: 8,
+				terminal_rosette_count: 3,
+				phyllotaxis_mode: PhyllotaxisMode.OppositeDecussate,
+				card_width: 0.9,
+				card_length: 0.95,
+				fold_angle: 0.25
+			});
+			config.bark_material.applyOverrides({
+				bark_type: FoliageBarkType.Fissured,
+				primary_color: [0.36, 0.34, 0.31],
+				secondary_color: [0.16, 0.15, 0.14],
+				inner_bark_color: [0.38, 0.32, 0.27],
+				fissure_frequency: 7,
+				fissure_depth: 0.66,
+				roughness: 0.90
+			});
+			config.foliage_material.applyOverrides({
+				primary_color: [0.24, 0.45, 0.15],
+				secondary_color: [0.42, 0.28, 0.12],
+				autumn_tint: 0.22,
+				leaf_shape: "palmate",
+				leaflets_per_cluster: 5,
+				juvenile_color_shift: 0.40,
+				juvenile_anthocyanin: 0.18,
+				carotenoid_density: 0.88,
+				anthocyanin_potential: 0.90,
+				tannin_oxidation: 0.18
+			});
+			break;
+		}
+
+		case TreePreset.Spruce: {
+			config.name = "spruce";
+			config.preset = TreePreset.Spruce;
+			config.crown.applyOverrides({
+				envelope_type: CrownEnvelopeType.Conical,
+				height: 9.5,
+				radius: 3.6,
+				base_height: 1.4,
+				prune_ratio: 0.3,
+				space_colonization_weight: 0.08,
+				pipe_model_exponent: 2.45,
+				pipe_model_weight: 0.55,
+				sky_phototropism_mix: 0.3
+			});
+			config.levels = [
+				{
+					level: 0,
+					segments: 10,
+					radial_segments_max: 10,
+					radial_segments_min: 4,
+					length: 11.8,
+					radius_ratio: 0.036,
+					taper: 0.92,
+					bare_length_ratio: 0.12,
+					child_count: 35,
+					phyllotaxis_mode: PhyllotaxisMode.Whorled,
+					whorl_count: 5,
+					insertion_angle: 1.38,
+					insertion_angle_profile: AnimationCurve.linear(0, 1.05, 1, 0.56),
+					curvature: 0.02,
+					gravitropism: -0.08,
+					phototropism: 0.06,
+					gnarl_strength: 0.02,
+					flare_amplitude: 0.2,
+					flare_lobes: 4,
+					collar_weld_rings: 0
+				},
+				{
+					level: 1,
+					segments: 5,
+					radial_segments_max: 6,
+					radial_segments_min: 3,
+					length: 3.6,
+					length_profile: AnimationCurve.linear(0, 1.0, 1, 0.68),
+					radius_ratio: 0.032,
+					taper: 0.86,
+					bare_length_ratio: 0.1,
+					child_count: 6,
+					phyllotaxis_mode: PhyllotaxisMode.AlternateDistichous,
+					insertion_angle: 0.9,
+					curvature: 0.18,
+					curve_back: -0.10,
+					gravitropism: 0.16,
+					phototropism: 0.12,
+					collar_weld_rings: 2
+				},
+				{
+					level: 2,
+					segments: 3,
+					radial_segments_max: 4,
+					radial_segments_min: 3,
+					length: 1.1,
+					radius_ratio: 0.03,
+					taper: 0.85,
+					bare_length_ratio: 0.08,
+					child_count: 0,
+					insertion_angle: 0.8,
+					curvature: 0.15,
+					gravitropism: 0.18,
+					phototropism: 0.2,
+					collar_weld_rings: 1
+				}
+			];
+			config.applyOverrides({ levels: config.levels, replace_levels: true });
+			config.foliage.applyOverrides({
+				enabled: true,
+				card_type: FoliageCardType.CrossCard,
+				attach_min_level: 1,
+				cards_per_branch: 7,
+				terminal_rosette_count: 2,
+				card_width: 0.68,
+				card_length: 0.75
+			});
+			config.bark_material.applyOverrides({
+				bark_type: FoliageBarkType.Plated,
+				primary_color: [0.36, 0.29, 0.24],
+				secondary_color: [0.15, 0.12, 0.10],
+				inner_bark_color: [0.42, 0.30, 0.22],
+				fissure_frequency: 8,
+				fissure_depth: 0.72,
+				roughness: 0.91
+			});
+			config.foliage_material.applyOverrides({
+				primary_color: [0.11, 0.27, 0.15],
+				secondary_color: [0.07, 0.18, 0.10],
+				leaf_shape: "needle",
+				leaflets_per_cluster: 9,
+				juvenile_color_shift: 0.46,
+				juvenile_anthocyanin: 0.0,
+				carotenoid_density: 0.35,
+				anthocyanin_potential: 0.0,
+				tannin_oxidation: 0.30
+			});
+			break;
+		}
+
+		case TreePreset.Palm: {
+			config.name = "palm";
+			config.preset = TreePreset.Palm;
+			config.crown.applyOverrides({
+				envelope_type: CrownEnvelopeType.Hemispherical,
+				height: 11.0,
+				radius: 4.2,
+				base_height: 7.5,
+				prune_ratio: 0.1,
+				space_colonization_weight: 0.0,
+				pipe_model_weight: 0.15
+			});
+			config.levels = [
+				{
+					level: 0,
+					segments: 10,
+					radial_segments_max: 10,
+					radial_segments_min: 7,
+					length: 9.5,
+					radius_ratio: 0.038,
+					taper: 0.35,
+					bare_length_ratio: 0.92,
+					child_count: 12,
+					phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
+					insertion_angle: 0.95,
+					insertion_angle_variation: 0.25,
+					curvature: 0.28,
+					curve_back: -0.12,
+					gravitropism: -0.08,
+					phototropism: 0.22,
+					gnarl_strength: 0.04,
+					flare_amplitude: 0.25,
+					flare_height_ratio: 0.12,
+					flare_lobes: 6,
+					collar_weld_rings: 0
+				},
+				{
+					level: 1,
+					segments: 5,
+					radial_segments_max: 5,
+					radial_segments_min: 3,
+					length: 2.8,
+					radius_ratio: 0.025,
+					taper: 0.9,
+					bare_length_ratio: 0.05,
+					child_count: 0,
+					insertion_angle: 0.85,
+					curvature: 0.55,
+					gravitropism: 0.48,
+					phototropism: 0.15,
+					collar_weld_rings: 1
+				}
+			];
+			config.applyOverrides({ levels: config.levels, replace_levels: true });
+			config.foliage.applyOverrides({
+				enabled: true,
+				card_type: FoliageCardType.RibbedFrond,
+				attach_min_level: 1,
+				cards_per_branch: 4,
+				terminal_rosette_count: 3,
+				bare_ratio: 0.05,
+				card_width: 0.95,
+				card_length: 1.85,
+				fold_angle: 0.32,
+				arch_height: 0.22,
+				camber_droop: 0.32,
+				frond_segments: 6,
+				gravitropism: 0.45,
+				phototropism: 0.4
+			});
+			config.bark_material.applyOverrides({
+				bark_type: FoliageBarkType.Ringed,
+				primary_color: [0.54, 0.46, 0.36],
+				secondary_color: [0.26, 0.21, 0.15],
+				fissure_frequency: 5,
+				fissure_depth: 0.62,
+				lenticel_amount: 0.45
+			});
+			config.foliage_material.applyOverrides({
+				primary_color: [0.22, 0.46, 0.14],
+				secondary_color: [0.15, 0.34, 0.09],
+				leaf_shape: "frond",
+				leaflets_per_cluster: 11
+			});
+			break;
+		}
+
+		case TreePreset.Shrub: {
+			config.name = "shrub";
+			config.preset = TreePreset.Shrub;
+			config.crown.applyOverrides({
+				envelope_type: CrownEnvelopeType.Hemispherical,
+				height: 2.8,
+				radius: 2.2,
+				base_height: 0.15,
+				prune_ratio: 0.25,
+				space_colonization_weight: 0.3,
+				pipe_model_exponent: 2.1,
+				pipe_model_weight: 0.55
+			});
+			config.levels = [
+				{
+					level: 0,
+					segments: 5,
+					radial_segments_max: 7,
+					radial_segments_min: 4,
+					length: 1.8,
+					radius_ratio: 0.055,
+					taper: 0.8,
+					bare_length_ratio: 0.08,
+					child_count: 8,
+					phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
+					insertion_angle: 0.82,
+					curvature: 0.25,
+					gravitropism: -0.05,
+					phototropism: 0.28,
+					gnarl_strength: 0.12,
+					split_probability: 0.45,
+					split_count: 3,
+					split_angle: 0.52,
+					collar_weld_rings: 0
+				},
+				{
+					level: 1,
+					segments: 4,
+					radial_segments_max: 5,
+					radial_segments_min: 3,
+					length: 1.2,
+					radius_ratio: 0.04,
+					taper: 0.85,
+					bare_length_ratio: 0.1,
+					child_count: 0,
+					insertion_angle: 0.72,
+					curvature: 0.2,
+					gravitropism: 0.06,
+					phototropism: 0.35,
+					collar_weld_rings: 1
+				}
+			];
+			config.applyOverrides({ levels: config.levels, replace_levels: true });
+			config.foliage.applyOverrides({
+				enabled: true,
+				card_type: FoliageCardType.FoldedVCard,
+				attach_min_level: 1,
+				cards_per_branch: 9,
+				terminal_rosette_count: 4,
+				card_width: 0.55,
+				card_length: 0.62,
+				phototropism: 0.7
+			});
+			config.foliage_material.applyOverrides({
+				primary_color: [0.22, 0.44, 0.16],
+				secondary_color: [0.14, 0.30, 0.10],
+				leaf_shape: "ovate",
+				leaflets_per_cluster: 7
+			});
+			break;
+		}
+
+		case TreePreset.Fern: {
+			config.name = "fern";
+			config.preset = TreePreset.Fern;
+			config.crown.applyOverrides({
+				envelope_type: CrownEnvelopeType.InverseConical,
+				height: 1.6,
+				radius: 1.5,
+				base_height: 0.05,
+				prune_ratio: 0.05,
+				space_colonization_weight: 0.0,
+				pipe_model_weight: 0.2
+			});
+			config.levels = [
+				{
+					level: 0,
+					segments: 3,
+					radial_segments_max: 6,
+					radial_segments_min: 4,
+					length: 0.35,
+					radius_ratio: 0.18,
+					taper: 0.6,
+					bare_length_ratio: 0.1,
+					child_count: 9,
+					phyllotaxis_mode: PhyllotaxisMode.SpiralGolden,
+					insertion_angle: 0.95,
+					curvature: 0.1,
+					collar_weld_rings: 0
+				},
+				{
+					level: 1,
+					segments: 5,
+					radial_segments_max: 4,
+					radial_segments_min: 3,
+					length: 1.15,
+					radius_ratio: 0.025,
+					taper: 0.92,
+					bare_length_ratio: 0.05,
+					child_count: 0,
+					insertion_angle: 0.85,
+					curvature: 0.48,
+					gravitropism: 0.38,
+					phototropism: 0.2,
+					collar_weld_rings: 1
+				}
+			];
+			config.applyOverrides({ levels: config.levels, replace_levels: true });
+			config.foliage.applyOverrides({
+				enabled: true,
+				card_type: FoliageCardType.RibbedFrond,
+				attach_min_level: 1,
+				cards_per_branch: 3,
+				terminal_rosette_count: 2,
+				bare_ratio: 0.05,
+				card_width: 0.48,
+				card_length: 0.95,
+				fold_angle: 0.28,
+				arch_height: 0.16,
+				camber_droop: 0.24,
+				frond_segments: 6,
+				gravitropism: 0.35,
+				phototropism: 0.55
+			});
+			config.foliage_material.applyOverrides({
+				primary_color: [0.24, 0.50, 0.16],
+				secondary_color: [0.16, 0.36, 0.10],
+				leaf_shape: "frond",
+				leaflets_per_cluster: 11
+			});
+			break;
+		}
+
+		case TreePreset.Oak:
+		default: {
+			config.name = "oak";
+			config.preset = TreePreset.Oak;
+			config.foliage_material.applyOverrides({
+				juvenile_color_shift: 0.38,
+				juvenile_anthocyanin: 0.14,
+				carotenoid_density: 0.72,
+				anthocyanin_potential: 0.52,
+				tannin_oxidation: 0.68
+			});
+			break;
+		}
+	}
+
+	if (overrides !== undefined && overrides !== null) {
+		config.applyOverrides(overrides);
+	}
+
+	return config;
+}