@woosh/meep-engine 3.56.0 → 3.57.0

package/src/generation/foliage/config/FoliageMaterialConfig.js

@@ -1,279 +1,261 @@
-import { assert } from "../../../core/assert.js";
-import { Color } from "../../../core/color/Color.js";
-import { hash_mix2 } from "../../../core/math/hash/hash_mix2.js";
-import { computeHashFloat } from "../../../core/primitives/numbers/computeHashFloat.js";
-import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
-
-/**
- * Procedural foliage cluster PBR material, ontogenetic variant atlas, & biochemical senescence configuration.
- */
-export class FoliageMaterialConfig {
-	/**
-	 * Procedural per-variant tile resolution (pixels, power of two).
-	 * @type {number}
-	 */
-	resolution = 128;
-
-	/**
-	 * Mature sun-facing leaf lamina color (sRGB).
-	 * @type {Color}
-	 */
-	primary_color = new Color(0.26, 0.48, 0.16, 1.0);
-
-	/**
-	 * Vein / secondary leaf color (sRGB).
-	 * @type {Color}
-	 */
-	secondary_color = new Color(0.38, 0.58, 0.22, 1.0);
-
-	/**
-	 * Legacy / convenience autumn shift factor [0, 1].
-	 * Acts as a lower bound on `senescence` when non-zero for backwards compatibility.
-	 * @type {number}
-	 */
-	autumn_tint = 0.0;
-
-	/**
-	 * Leaf cluster silhouette style: `"ovate" | "lobed" | "serrated" | "palmate" | "needle" | "frond"`.
-	 * @type {string}
-	 */
-	leaf_shape = "lobed";
-
-	/**
-	 * Number of leaflets arranged on the twig cluster card.
-	 * @type {number}
-	 */
-	leaflets_per_cluster = 5;
-
-	/**
-	 * Base PBR roughness [0, 1].
-	 * @type {number}
-	 */
-	roughness = 0.56;
-
-	/**
-	 * Venation normal-map relief strength [0, 1].
-	 * @type {number}
-	 */
-	vein_strength = 0.5;
-
-	/**
-	 * Horizontal UV coordinate [0, 1] on the foliage card where the drawn woody stem/petiole attaches to the branch.
-	 * @type {number}
-	 */
-	stem_anchor_u = 0.5;
-
-	/**
-	 * Vertical UV coordinate [0, 1] on the foliage card where the drawn woody stem/petiole attaches to the branch.
-	 * @type {number}
-	 */
-	stem_anchor_v = 0.0;
-
-	/**
-	 * Number of ontogenetic foliage card variants packed into the material atlas [1, 16].
-	 * Variant 0 represents newly flushed juvenile apical leaves; Variant `variant_count - 1`
-	 * represents fully mature (or most senescent) basal/interior leaves.
-	 * @type {number}
-	 */
-	variant_count = 4;
-
-	/**
-	 * Juvenile-to-mature chlorophyll-lag lightening & yellow-green/chartreuse shift [0, 1].
-	 * @type {number}
-	 */
-	juvenile_color_shift = 0.38;
-
-	/**
-	 * Transient epidermal anthocyanin bronze/reddish margin flush on newly emerging juvenile leaves [0, 1].
-	 * @type {number}
-	 */
-	juvenile_anthocyanin = 0.08;
-
-	/**
-	 * Juvenile-to-mature leaflet aspect ratio, lobe/tooth incision depth, and lateral spread progression [0, 1].
-	 * @type {number}
-	 */
-	ontogeny_shape_variation = 0.35;
-
-	/**
-	 * Juvenile-to-mature vascular venation relief, interveinal bullation, stem lignification, and cuticle roughness progression [0, 1].
-	 * @type {number}
-	 */
-	ontogeny_vein_contrast = 0.55;
-
-	/**
-	 * Seasonal chlorophyll catabolism (autumn senescence) stage [0, 1].
-	 * Governed by photoperiod/temperature breakdown of chlorophyll a/b, which unmasks plastid carotenoids,
-	 * triggers photoprotective vacuolar anthocyanin synthesis in sunlit leaves, and oxidizes foliar tannins.
-	 * @type {number}
-	 */
-	senescence = 0.0;
-
-	/**
-	 * Foliar xanthophyll & beta-carotene concentration [0, 1] unmasked as chlorophyll degrades
-	 * (drives vivid golden-yellow autumn coloration in Birch, Willow, Aspen, Ginkgo, Maple).
-	 * @type {number}
-	 */
-	carotenoid_density = 0.75;
-
-	/**
-	 * Species genetic potential [0, 1] for de novo vacuolar anthocyanin synthesis under high solar
-	 * irradiance and carbohydrate accumulation during senescence (drives scarlet/crimson in Maple & Oak).
-	 * @type {number}
-	 */
-	anthocyanin_potential = 0.35;
-
-	/**
-	 * Foliar condensed tannin / polyphenol oxidation rate [0, 1] into russet/copper-brown during late senescence
-	 * (high in Oak, low in Birch/Maple).
-	 * @type {number}
-	 */
-	tannin_oxidation = 0.25;
-
-	/**
-	 * @param {Partial<FoliageMaterialConfig>} [options]
-	 * @returns {FoliageMaterialConfig}
-	 */
-	static from(options = {}) {
-		const r = new FoliageMaterialConfig();
-		r.applyOverrides(options);
-		return r;
-	}
-
-	/**
-	 * @param {Partial<FoliageMaterialConfig>} [overrides]
-	 * @returns {this}
-	 */
-	applyOverrides(overrides = {}) {
-		if (overrides === null || overrides === undefined) {
-			return this;
-		}
-		if (overrides.resolution !== undefined) this.resolution = Math.max(16, overrides.resolution | 0);
-		if (overrides.primary_color !== undefined) {
-			if (Array.isArray(overrides.primary_color)) {
-				this.primary_color.setRGB(overrides.primary_color[0], overrides.primary_color[1], overrides.primary_color[2]);
-			} else {
-				this.primary_color.copy(overrides.primary_color);
-			}
-		}
-		if (overrides.secondary_color !== undefined) {
-			if (Array.isArray(overrides.secondary_color)) {
-				this.secondary_color.setRGB(overrides.secondary_color[0], overrides.secondary_color[1], overrides.secondary_color[2]);
-			} else {
-				this.secondary_color.copy(overrides.secondary_color);
-			}
-		}
-		if (overrides.autumn_tint !== undefined) this.autumn_tint = overrides.autumn_tint;
-		if (overrides.leaf_shape !== undefined) this.leaf_shape = overrides.leaf_shape;
-		if (overrides.leaflets_per_cluster !== undefined) this.leaflets_per_cluster = Math.max(1, overrides.leaflets_per_cluster | 0);
-		if (overrides.roughness !== undefined) this.roughness = overrides.roughness;
-		if (overrides.vein_strength !== undefined) this.vein_strength = overrides.vein_strength;
-		if (overrides.stem_anchor_u !== undefined) this.stem_anchor_u = overrides.stem_anchor_u;
-		if (overrides.stem_anchor_v !== undefined) this.stem_anchor_v = overrides.stem_anchor_v;
-		if (overrides.variant_count !== undefined) this.variant_count = Math.max(1, Math.min(16, overrides.variant_count | 0));
-		if (overrides.juvenile_color_shift !== undefined) this.juvenile_color_shift = overrides.juvenile_color_shift;
-		if (overrides.juvenile_anthocyanin !== undefined) this.juvenile_anthocyanin = overrides.juvenile_anthocyanin;
-		if (overrides.ontogeny_shape_variation !== undefined) this.ontogeny_shape_variation = overrides.ontogeny_shape_variation;
-		if (overrides.ontogeny_vein_contrast !== undefined) this.ontogeny_vein_contrast = overrides.ontogeny_vein_contrast;
-		if (overrides.senescence !== undefined) this.senescence = overrides.senescence;
-		if (overrides.carotenoid_density !== undefined) this.carotenoid_density = overrides.carotenoid_density;
-		if (overrides.anthocyanin_potential !== undefined) this.anthocyanin_potential = overrides.anthocyanin_potential;
-		if (overrides.tannin_oxidation !== undefined) this.tannin_oxidation = overrides.tannin_oxidation;
-		return this;
-	}
-
-	/**
-	 * @param {FoliageMaterialConfig} other
-	 * @returns {this}
-	 */
-	copy(other) {
-		assert.defined(other, 'other');
-		this.resolution = other.resolution;
-		this.primary_color.copy(other.primary_color);
-		this.secondary_color.copy(other.secondary_color);
-		this.autumn_tint = other.autumn_tint;
-		this.leaf_shape = other.leaf_shape;
-		this.leaflets_per_cluster = other.leaflets_per_cluster;
-		this.roughness = other.roughness;
-		this.vein_strength = other.vein_strength;
-		this.stem_anchor_u = other.stem_anchor_u;
-		this.stem_anchor_v = other.stem_anchor_v;
-		this.variant_count = other.variant_count;
-		this.juvenile_color_shift = other.juvenile_color_shift;
-		this.juvenile_anthocyanin = other.juvenile_anthocyanin;
-		this.ontogeny_shape_variation = other.ontogeny_shape_variation;
-		this.ontogeny_vein_contrast = other.ontogeny_vein_contrast;
-		this.senescence = other.senescence;
-		this.carotenoid_density = other.carotenoid_density;
-		this.anthocyanin_potential = other.anthocyanin_potential;
-		this.tannin_oxidation = other.tannin_oxidation;
-		return this;
-	}
-
-	/**
-	 * @returns {FoliageMaterialConfig}
-	 */
-	clone() {
-		const r = new FoliageMaterialConfig();
-		r.copy(this);
-		return r;
-	}
-
-	/**
-	 * @param {FoliageMaterialConfig} other
-	 * @returns {boolean}
-	 */
-	equals(other) {
-		if (this === other) return true;
-		if (!other || !other.isFoliageMaterialConfig) return false;
-		return this.resolution === other.resolution
-			&& this.primary_color.equals(other.primary_color)
-			&& this.secondary_color.equals(other.secondary_color)
-			&& this.autumn_tint === other.autumn_tint
-			&& this.leaf_shape === other.leaf_shape
-			&& this.leaflets_per_cluster === other.leaflets_per_cluster
-			&& this.roughness === other.roughness
-			&& this.vein_strength === other.vein_strength
-			&& this.stem_anchor_u === other.stem_anchor_u
-			&& this.stem_anchor_v === other.stem_anchor_v
-			&& this.variant_count === other.variant_count
-			&& this.juvenile_color_shift === other.juvenile_color_shift
-			&& this.juvenile_anthocyanin === other.juvenile_anthocyanin
-			&& this.ontogeny_shape_variation === other.ontogeny_shape_variation
-			&& this.ontogeny_vein_contrast === other.ontogeny_vein_contrast
-			&& this.senescence === other.senescence
-			&& this.carotenoid_density === other.carotenoid_density
-			&& this.anthocyanin_potential === other.anthocyanin_potential
-			&& this.tannin_oxidation === other.tannin_oxidation;
-	}
-
-	/**
-	 * @returns {number}
-	 */
-	hash() {
-		let h = hash_mix2(this.resolution, this.primary_color.hash());
-		h = hash_mix2(h, this.secondary_color.hash());
-		h = hash_mix2(h, computeHashFloat(this.autumn_tint));
-		h = hash_mix2(h, computeStringHash(this.leaf_shape));
-		h = hash_mix2(h, this.leaflets_per_cluster);
-		h = hash_mix2(h, computeHashFloat(this.roughness));
-		h = hash_mix2(h, computeHashFloat(this.stem_anchor_u));
-		h = hash_mix2(h, computeHashFloat(this.stem_anchor_v));
-		h = hash_mix2(h, this.variant_count);
-		h = hash_mix2(h, computeHashFloat(this.juvenile_color_shift));
-		h = hash_mix2(h, computeHashFloat(this.juvenile_anthocyanin));
-		h = hash_mix2(h, computeHashFloat(this.ontogeny_shape_variation));
-		h = hash_mix2(h, computeHashFloat(this.ontogeny_vein_contrast));
-		h = hash_mix2(h, computeHashFloat(this.senescence));
-		h = hash_mix2(h, computeHashFloat(this.carotenoid_density));
-		h = hash_mix2(h, computeHashFloat(this.anthocyanin_potential));
-		h = hash_mix2(h, computeHashFloat(this.tannin_oxidation));
-		return h;
-	}
-}
-
-/**
- * @readonly
- * @type {boolean}
- */
-FoliageMaterialConfig.prototype.isFoliageMaterialConfig = true;
+import { assert } from "../../../core/assert.js";
+import { Color } from "../../../core/color/Color.js";
+import { hash_mix2 } from "../../../core/math/hash/hash_mix2.js";
+import { computeHashFloat } from "../../../core/primitives/numbers/computeHashFloat.js";
+import { FoliageTileContent } from "./FoliageTileContent.js";
+import { LeafArchitecture } from "./LeafArchitecture.js";
+
+/**
+ * Procedural foliage cluster PBR material, ontogenetic variant atlas, & biochemical senescence configuration.
+ */
+export class FoliageMaterialConfig {
+	/**
+	 * Mature sun-facing leaf lamina color (sRGB).
+	 * @type {Color}
+	 */
+	primary_color = new Color(0.26, 0.48, 0.16, 1.0);
+
+	/**
+	 * Vein / secondary leaf color (sRGB).
+	 * @type {Color}
+	 */
+	secondary_color = new Color(0.38, 0.58, 0.22, 1.0);
+
+	/**
+	 * Legacy / convenience autumn shift factor [0, 1].
+	 * Acts as a lower bound on `senescence` when non-zero for backwards compatibility.
+	 * @type {number}
+	 */
+	autumn_tint = 0.0;
+
+	/**
+	 * The species' leaf, or its needle: what every tile draws, at its true size (`foliage_tile_layout`).
+	 * @type {LeafArchitecture}
+	 */
+	leaf = new LeafArchitecture();
+
+	/**
+	 * What a tile, and so a card, draws: one leaf, or a stretch of needle shoot.
+	 * @type {FoliageTileContent|number}
+	 */
+	tile_content = FoliageTileContent.Leaf;
+
+	/**
+	 * Angle (radians) at which a needle shoot's needles leave it, for `FoliageTileContent.NeedleShoot`.
+	 * @type {number}
+	 */
+	needle_angle = 0.6;
+
+	/**
+	 * Base PBR roughness [0, 1].
+	 * @type {number}
+	 */
+	roughness = 0.56;
+
+	/**
+	 * Venation normal-map relief strength [0, 1].
+	 * @type {number}
+	 */
+	vein_strength = 0.5;
+
+	/**
+	 * Number of ontogenetic foliage card variants packed into the material atlas [1, 16].
+	 * Variant 0 represents newly flushed juvenile apical leaves; Variant `variant_count - 1`
+	 * represents fully mature (or most senescent) basal/interior leaves.
+	 * @type {number}
+	 */
+	variant_count = 4;
+
+	/**
+	 * Juvenile-to-mature chlorophyll-lag lightening & yellow-green/chartreuse shift [0, 1].
+	 * @type {number}
+	 */
+	juvenile_color_shift = 0.38;
+
+	/**
+	 * Transient epidermal anthocyanin bronze/reddish margin flush on newly emerging juvenile leaves [0, 1].
+	 * @type {number}
+	 */
+	juvenile_anthocyanin = 0.08;
+
+	/**
+	 * Juvenile-to-mature leaflet aspect ratio, lobe/tooth incision depth, and lateral spread progression [0, 1].
+	 * @type {number}
+	 */
+	ontogeny_shape_variation = 0.35;
+
+	/**
+	 * Juvenile-to-mature vascular venation relief, interveinal bullation, stem lignification, and cuticle roughness progression [0, 1].
+	 * @type {number}
+	 */
+	ontogeny_vein_contrast = 0.55;
+
+	/**
+	 * Seasonal chlorophyll catabolism (autumn senescence) stage [0, 1].
+	 * Governed by photoperiod/temperature breakdown of chlorophyll a/b, which unmasks plastid carotenoids,
+	 * triggers photoprotective vacuolar anthocyanin synthesis in sunlit leaves, and oxidizes foliar tannins.
+	 * @type {number}
+	 */
+	senescence = 0.0;
+
+	/**
+	 * Foliar xanthophyll & beta-carotene concentration [0, 1] unmasked as chlorophyll degrades
+	 * (drives vivid golden-yellow autumn coloration in Birch, Willow, Aspen, Ginkgo, Maple).
+	 * @type {number}
+	 */
+	carotenoid_density = 0.75;
+
+	/**
+	 * Species genetic potential [0, 1] for de novo vacuolar anthocyanin synthesis under high solar
+	 * irradiance and carbohydrate accumulation during senescence (drives scarlet/crimson in Maple & Oak).
+	 * @type {number}
+	 */
+	anthocyanin_potential = 0.35;
+
+	/**
+	 * Foliar condensed tannin / polyphenol oxidation rate [0, 1] into russet/copper-brown during late senescence
+	 * (high in Oak, low in Birch/Maple).
+	 * @type {number}
+	 */
+	tannin_oxidation = 0.25;
+
+	/**
+	 * @param {Partial<FoliageMaterialConfig>} [options]
+	 * @returns {FoliageMaterialConfig}
+	 */
+	static from(options = {}) {
+		const r = new FoliageMaterialConfig();
+		r.applyOverrides(options);
+		return r;
+	}
+
+	/**
+	 * @param {Partial<FoliageMaterialConfig>} [overrides]
+	 * @returns {this}
+	 */
+	applyOverrides(overrides = {}) {
+		if (overrides === null || overrides === undefined) {
+			return this;
+		}
+		if (overrides.primary_color !== undefined) {
+			if (Array.isArray(overrides.primary_color)) {
+				this.primary_color.setRGB(overrides.primary_color[0], overrides.primary_color[1], overrides.primary_color[2]);
+			} else {
+				this.primary_color.copy(overrides.primary_color);
+			}
+		}
+		if (overrides.secondary_color !== undefined) {
+			if (Array.isArray(overrides.secondary_color)) {
+				this.secondary_color.setRGB(overrides.secondary_color[0], overrides.secondary_color[1], overrides.secondary_color[2]);
+			} else {
+				this.secondary_color.copy(overrides.secondary_color);
+			}
+		}
+		if (overrides.autumn_tint !== undefined) this.autumn_tint = overrides.autumn_tint;
+		if (overrides.leaf !== undefined) this.leaf.applyOverrides(overrides.leaf);
+		if (overrides.tile_content !== undefined) this.tile_content = overrides.tile_content;
+		if (overrides.needle_angle !== undefined) this.needle_angle = overrides.needle_angle;
+		if (overrides.roughness !== undefined) this.roughness = overrides.roughness;
+		if (overrides.vein_strength !== undefined) this.vein_strength = overrides.vein_strength;
+		if (overrides.variant_count !== undefined) this.variant_count = Math.max(1, Math.min(16, overrides.variant_count | 0));
+		if (overrides.juvenile_color_shift !== undefined) this.juvenile_color_shift = overrides.juvenile_color_shift;
+		if (overrides.juvenile_anthocyanin !== undefined) this.juvenile_anthocyanin = overrides.juvenile_anthocyanin;
+		if (overrides.ontogeny_shape_variation !== undefined) this.ontogeny_shape_variation = overrides.ontogeny_shape_variation;
+		if (overrides.ontogeny_vein_contrast !== undefined) this.ontogeny_vein_contrast = overrides.ontogeny_vein_contrast;
+		if (overrides.senescence !== undefined) this.senescence = overrides.senescence;
+		if (overrides.carotenoid_density !== undefined) this.carotenoid_density = overrides.carotenoid_density;
+		if (overrides.anthocyanin_potential !== undefined) this.anthocyanin_potential = overrides.anthocyanin_potential;
+		if (overrides.tannin_oxidation !== undefined) this.tannin_oxidation = overrides.tannin_oxidation;
+		return this;
+	}
+
+	/**
+	 * @param {FoliageMaterialConfig} other
+	 * @returns {this}
+	 */
+	copy(other) {
+		assert.defined(other, 'other');
+		this.primary_color.copy(other.primary_color);
+		this.secondary_color.copy(other.secondary_color);
+		this.autumn_tint = other.autumn_tint;
+		this.leaf.copy(other.leaf);
+		this.tile_content = other.tile_content;
+		this.needle_angle = other.needle_angle;
+		this.roughness = other.roughness;
+		this.vein_strength = other.vein_strength;
+		this.variant_count = other.variant_count;
+		this.juvenile_color_shift = other.juvenile_color_shift;
+		this.juvenile_anthocyanin = other.juvenile_anthocyanin;
+		this.ontogeny_shape_variation = other.ontogeny_shape_variation;
+		this.ontogeny_vein_contrast = other.ontogeny_vein_contrast;
+		this.senescence = other.senescence;
+		this.carotenoid_density = other.carotenoid_density;
+		this.anthocyanin_potential = other.anthocyanin_potential;
+		this.tannin_oxidation = other.tannin_oxidation;
+		return this;
+	}
+
+	/**
+	 * @returns {FoliageMaterialConfig}
+	 */
+	clone() {
+		const r = new FoliageMaterialConfig();
+		r.copy(this);
+		return r;
+	}
+
+	/**
+	 * @param {FoliageMaterialConfig} other
+	 * @returns {boolean}
+	 */
+	equals(other) {
+		if (this === other) return true;
+		if (!other || !other.isFoliageMaterialConfig) return false;
+		return this.primary_color.equals(other.primary_color)
+			&& this.secondary_color.equals(other.secondary_color)
+			&& this.autumn_tint === other.autumn_tint
+			&& this.leaf.equals(other.leaf)
+			&& this.tile_content === other.tile_content
+			&& this.needle_angle === other.needle_angle
+			&& this.roughness === other.roughness
+			&& this.vein_strength === other.vein_strength
+			&& this.variant_count === other.variant_count
+			&& this.juvenile_color_shift === other.juvenile_color_shift
+			&& this.juvenile_anthocyanin === other.juvenile_anthocyanin
+			&& this.ontogeny_shape_variation === other.ontogeny_shape_variation
+			&& this.ontogeny_vein_contrast === other.ontogeny_vein_contrast
+			&& this.senescence === other.senescence
+			&& this.carotenoid_density === other.carotenoid_density
+			&& this.anthocyanin_potential === other.anthocyanin_potential
+			&& this.tannin_oxidation === other.tannin_oxidation;
+	}
+
+	/**
+	 * @returns {number}
+	 */
+	hash() {
+		let h = this.primary_color.hash();
+		h = hash_mix2(h, this.secondary_color.hash());
+		h = hash_mix2(h, computeHashFloat(this.autumn_tint));
+		h = hash_mix2(h, this.leaf.hash());
+		h = hash_mix2(h, this.tile_content);
+		h = hash_mix2(h, computeHashFloat(this.needle_angle));
+		h = hash_mix2(h, computeHashFloat(this.roughness));
+		h = hash_mix2(h, this.variant_count);
+		h = hash_mix2(h, computeHashFloat(this.juvenile_color_shift));
+		h = hash_mix2(h, computeHashFloat(this.juvenile_anthocyanin));
+		h = hash_mix2(h, computeHashFloat(this.ontogeny_shape_variation));
+		h = hash_mix2(h, computeHashFloat(this.ontogeny_vein_contrast));
+		h = hash_mix2(h, computeHashFloat(this.senescence));
+		h = hash_mix2(h, computeHashFloat(this.carotenoid_density));
+		h = hash_mix2(h, computeHashFloat(this.anthocyanin_potential));
+		h = hash_mix2(h, computeHashFloat(this.tannin_oxidation));
+		return h;
+	}
+}
+
+/**
+ * @readonly
+ * @type {boolean}
+ */
+FoliageMaterialConfig.prototype.isFoliageMaterialConfig = true;

package/src/generation/foliage/config/FoliageSpawnRule.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Foliage edge of the generator graph: every branch grown by generator `source` carries leaf cards
+ * shaped by `TreeSpeciesConfig.foliage`. Several rules may name different sources, so foliage can sit on
+ * twigs, boughs and epicormic sprouts alike.
+ *
+ * How many cards a carrier gets is not authored: it follows from the carrier's leafy length, the card size and the
+ * atlas's leaf coverage (see `foliage_cards_per_metre`).
+ */
+export class FoliageSpawnRule {
+    /**
+     * @param {Partial<FoliageSpawnRule>} [options]
+     * @returns {FoliageSpawnRule}
+     */
+    static from(options?: Partial<FoliageSpawnRule>): FoliageSpawnRule;
+    /**
+     * Carrier branch generator index into `TreeSpeciesConfig.branches`.
+     * @type {number}
+     */
+    source: number;
+    /**
+     * Bare fraction [0, 0.9] at the base of a carrier branch without leaves.
+     * @type {number}
+     */
+    attach_min: number;
+    /**
+     * Phyllotactic arrangement of the lateral cards.
+     * @type {PhyllotaxisMode|number}
+     */
+    phyllotaxis_mode: PhyllotaxisMode | number;
+    /**
+     * Cards per node when `phyllotaxis_mode === PhyllotaxisMode.Whorled`.
+     * @type {number}
+     */
+    whorl_count: number;
+    /**
+     * Whether the carriers are short shoots: each year's unit bears `FoliageConfig.leaves_per_short_shoot` leaves
+     * crowded at its tip.
+     * @type {boolean}
+     */
+    short_shoot: boolean;
+    /**
+     * Petiole insertion angle (radians) relative to the carrier branch tangent. Sets how far the cards reach out from
+     * the shoot, and with it how much leaf the shoot wears.
+     * @type {number}
+     */
+    insertion_angle: number;
+    /**
+     * @param {Partial<FoliageSpawnRule>} [overrides]
+     * @returns {this}
+     */
+    applyOverrides(overrides?: Partial<FoliageSpawnRule>): this;
+    /**
+     * @param {FoliageSpawnRule} other
+     * @returns {this}
+     */
+    copy(other: FoliageSpawnRule): this;
+    /**
+     * @returns {FoliageSpawnRule}
+     */
+    clone(): FoliageSpawnRule;
+    /**
+     * @param {FoliageSpawnRule} other
+     * @returns {boolean}
+     */
+    equals(other: FoliageSpawnRule): boolean;
+    /**
+     * @returns {number}
+     */
+    hash(): number;
+    /**
+     * @readonly
+     * @type {boolean}
+     */
+    readonly isFoliageSpawnRule: boolean;
+}
+import { PhyllotaxisMode } from "./PhyllotaxisMode.js";
+//# sourceMappingURL=FoliageSpawnRule.d.ts.map

package/src/generation/foliage/config/FoliageSpawnRule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FoliageSpawnRule.d.ts","sourceRoot":"","sources":["../../../../../src/generation/foliage/config/FoliageSpawnRule.js"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH;IAuCI;;;OAGG;IACH,sBAHW,QAAQ,gBAAgB,CAAC,GACvB,gBAAgB,CAM5B;IA9CD;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,YAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,kBAFU,eAAe,GAAC,MAAM,CAEgB;IAEhD;;;OAGG;IACH,aAFU,MAAM,CAEA;IAEhB;;;;OAIG;IACH,aAFU,OAAO,CAEG;IAEpB;;;;OAIG;IACH,iBAFU,MAAM,CAEO;IAYvB;;;OAGG;IACH,2BAHW,QAAQ,gBAAgB,CAAC,GACvB,IAAI,CAahB;IAED;;;OAGG;IACH,YAHW,gBAAgB,GACd,IAAI,CAWhB;IAED;;OAEG;IACH,SAFa,gBAAgB,CAM5B;IAED;;;OAGG;IACH,cAHW,gBAAgB,GACd,OAAO,CAWnB;IAED;;OAEG;IACH,QAFa,MAAM,CAQlB;IAGL;;;OAGG;IACH,6BAFU,OAAO,CAE4B;CAN5C;gCA7H+B,sBAAsB"}