@woosh/meep-engine 3.53.0 → 3.54.0

package/src/engine/physics/fluid/ecs/FluidObstacleSystem.d.ts

@@ -66,11 +66,11 @@ export class FluidObstacleSystem extends System<any> {
     /**
      * @param {FluidComponent} fluid
      */
-    static "__#464@#refresh_masks"(fluid: FluidComponent): void;
+    static "__#467@#refresh_masks"(fluid: FluidComponent): void;
     /**
      * @param {FluidComponent} fluid
      */
-    static "__#464@#clear_field"(fluid: FluidComponent): void;
+    static "__#467@#clear_field"(fluid: FluidComponent): void;
     /**
      * Mark every cell of `fluid` whose centre lies within `inflation` of the
      * posed shape as solid. Iteration is clipped to the shape's world AABB
@@ -82,7 +82,7 @@ export class FluidObstacleSystem extends System<any> {
      * @param {number} inflation       world-units SDF threshold
      * @param {Float64Array} point     length-3 scratch
      */
-    static "__#464@#voxelize"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array): void;
+    static "__#467@#voxelize"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array): void;
     /**
      * Write the obstacle's translation velocity onto every face of every cell
      * it voxelized — the moving-wall boundary condition. Runs AFTER the mask
@@ -102,7 +102,7 @@ export class FluidObstacleSystem extends System<any> {
      * @param {number} wvy
      * @param {number} wvz
      */
-    static "__#464@#stamp_wall_velocity"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array, wvx: number, wvy: number, wvz: number): void;
+    static "__#467@#stamp_wall_velocity"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array, wvx: number, wvy: number, wvz: number): void;
     constructor();
     dependencies: (typeof FluidObstacle)[];
     components_used: (ResourceAccessSpecification<typeof Transform64> | ResourceAccessSpecification<typeof FluidObstacle> | ResourceAccessSpecification<typeof Collider> | ResourceAccessSpecification<typeof RigidBody> | ResourceAccessSpecification<typeof FluidComponent>)[];

package/src/generation/foliage/FOLIAGE_DESIGN.md

@@ -239,7 +239,8 @@ src/generation/foliage/
   config/
     CrownEnvelopeType.js
     PhyllotaxisMode.js
-    FoliageCardType.js
+    FoliageCardType.js
+    FoliageBarkType.js
     TreePreset.js
     BranchLevelConfig.js
     CrownConfig.js

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

@@ -13,10 +13,10 @@ export class BarkMaterialConfig {
      */
     resolution: number;
     /**
-     * Botanical bark pattern archetype (`"fissured"` | `"birch"` | `"plated"` | `"ringed"`).
-     * @type {string}
+     * Botanical bark pattern archetype.
+     * @type {FoliageBarkType|number}
      */
-    bark_type: string;
+    bark_type: FoliageBarkType | number;
     /**
      * Outer bark ridge / periderm color (sRGB).
      * @type {Color}
@@ -116,5 +116,6 @@ export class BarkMaterialConfig {
      */
     readonly isBarkMaterialConfig: boolean;
 }
+import { FoliageBarkType } from "./FoliageBarkType.js";
 import { Color } from "../../../core/color/Color.js";
 //# sourceMappingURL=BarkMaterialConfig.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"BarkMaterialConfig.d.ts","sourceRoot":"","sources":["../../../../../src/generation/foliage/config/BarkMaterialConfig.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IAiGI;;;OAGG;IACH,sBAHW,QAAQ,kBAAkB,CAAC,GACzB,kBAAkB,CAM9B;IAxGD;;;OAGG;IACH,YAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,WAFU,MAAM,CAEO;IAEvB;;;OAGG;IACH,eAFU,KAAK,CAEkC;IAEjD;;;OAGG;IACH,iBAFU,KAAK,CAEoC;IAEnD;;;OAGG;IACH,kBAFU,KAAK,CAEqC;IAEpD;;;OAGG;IACH,YAFU,KAAK,CAE+B;IAE9C;;;OAGG;IACH,aAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,mBAFU,MAAM,CAEM;IAEtB;;;OAGG;IACH,eAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,iBAFU,MAAM,CAEM;IAEtB;;;OAGG;IACH,aAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,eAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,aAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,WAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,eAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,UAFU,MAAM,CAEA;IAYhB;;;OAGG;IACH,2BAHW,QAAQ,kBAAkB,CAAC,GACzB,IAAI,CA+ChB;IAED;;;OAGG;IACH,YAHW,kBAAkB,GAChB,IAAI,CAqBhB;IAED;;OAEG;IACH,SAFa,kBAAkB,CAM9B;IAED;;;OAGG;IACH,cAHW,kBAAkB,GAChB,OAAO,CAqBnB;IAED;;OAEG;IACH,QAFa,MAAM,CAelB;IAGL;;;OAGG;IACH,+BAFU,OAAO,CAEgC;CANhD;sBAlPqB,8BAA8B"}
+{"version":3,"file":"BarkMaterialConfig.d.ts","sourceRoot":"","sources":["../../../../../src/generation/foliage/config/BarkMaterialConfig.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IAiGI;;;OAGG;IACH,sBAHW,QAAQ,kBAAkB,CAAC,GACzB,kBAAkB,CAM9B;IAxGD;;;OAGG;IACH,YAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,WAFU,eAAe,GAAC,MAAM,CAEK;IAErC;;;OAGG;IACH,eAFU,KAAK,CAEkC;IAEjD;;;OAGG;IACH,iBAFU,KAAK,CAEoC;IAEnD;;;OAGG;IACH,kBAFU,KAAK,CAEqC;IAEpD;;;OAGG;IACH,YAFU,KAAK,CAE+B;IAE9C;;;OAGG;IACH,aAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,mBAFU,MAAM,CAEM;IAEtB;;;OAGG;IACH,eAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,iBAFU,MAAM,CAEM;IAEtB;;;OAGG;IACH,aAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,eAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,aAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,WAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,eAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,UAFU,MAAM,CAEA;IAYhB;;;OAGG;IACH,2BAHW,QAAQ,kBAAkB,CAAC,GACzB,IAAI,CA+ChB;IAED;;;OAGG;IACH,YAHW,kBAAkB,GAChB,IAAI,CAqBhB;IAED;;OAEG;IACH,SAFa,kBAAkB,CAM9B;IAED;;;OAGG;IACH,cAHW,kBAAkB,GAChB,OAAO,CAqBnB;IAED;;OAEG;IACH,QAFa,MAAM,CAelB;IAGL;;;OAGG;IACH,+BAFU,OAAO,CAEgC;CANhD;gCA/O+B,sBAAsB;sBAHhC,8BAA8B"}

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

@@ -2,7 +2,7 @@ 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";
+import { FoliageBarkType } from "./FoliageBarkType.js";
 
 /**
  * Procedural bark PBR material & UV tiling configuration.
@@ -15,10 +15,10 @@ export class BarkMaterialConfig {
     resolution = 256;
 
     /**
-     * Botanical bark pattern archetype (`"fissured"` | `"birch"` | `"plated"` | `"ringed"`).
-     * @type {string}
+     * Botanical bark pattern archetype.
+     * @type {FoliageBarkType|number}
      */
-    bark_type = "fissured";
+    bark_type = FoliageBarkType.Fissured;
 
     /**
      * Outer bark ridge / periderm color (sRGB).
@@ -123,7 +123,7 @@ export class BarkMaterialConfig {
             return this;
         }
         if (overrides.resolution !== undefined) this.resolution = Math.max(16, overrides.resolution | 0);
-        if (overrides.bark_type !== undefined) this.bark_type = String(overrides.bark_type);
+        if (overrides.bark_type !== undefined) this.bark_type = overrides.bark_type;
         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]);
@@ -228,7 +228,7 @@ export class BarkMaterialConfig {
      * @returns {number}
      */
     hash() {
-        let h = hash_mix2(this.resolution, computeStringHash(this.bark_type));
+        let h = hash_mix2(this.resolution, this.bark_type);
         h = hash_mix2(h, this.primary_color.hash());
         h = hash_mix2(h, this.secondary_color.hash());
         h = hash_mix2(h, this.inner_bark_color.hash());

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

@@ -0,0 +1,11 @@
+/**
+ * Botanical bark surface pattern archetypes for procedural bark synthesis and relief.
+ */
+export type FoliageBarkType = number;
+export namespace FoliageBarkType {
+    let Fissured: number;
+    let Birch: number;
+    let Plated: number;
+    let Ringed: number;
+}
+//# sourceMappingURL=FoliageBarkType.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FoliageBarkType.d.ts","sourceRoot":"","sources":["../../../../../src/generation/foliage/config/FoliageBarkType.js"],"names":[],"mappings":";;;8BAIU,MAAM"}

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

@@ -0,0 +1,16 @@
+/**
+ * Botanical bark surface pattern archetypes for procedural bark synthesis and relief.
+ *
+ * @readonly
+ * @enum {number}
+ */
+export const FoliageBarkType = {
+    /** Braided vertical ridges and cellular fissures (oak, willow, maple default) */
+    Fissured: 0,
+    /** Chalk-white periderm with horizontal lenticel dashes, peeling strips, and basal rupture skirt (birch) */
+    Birch: 1,
+    /** Ragged exfoliating stepped conifer scale plates (pine, spruce) */
+    Plated: 2,
+    /** Horizontal leaf-scar rings and fibrous trunk weave (palm, shrub, fern) */
+    Ringed: 3,
+};

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

@@ -1,5 +1,5 @@
 /**
- * Procedural foliage cluster PBR material & silhouette synthesis configuration.
+ * Procedural foliage cluster PBR material, ontogenetic variant atlas, & biochemical senescence configuration.
  */
 export class FoliageMaterialConfig {
     /**
@@ -8,22 +8,23 @@ export class FoliageMaterialConfig {
      */
     static from(options?: Partial<FoliageMaterialConfig>): FoliageMaterialConfig;
     /**
-     * Procedural texture resolution (pixels, power of two).
+     * Procedural per-variant tile resolution (pixels, power of two).
      * @type {number}
      */
     resolution: number;
     /**
-     * Sun-facing leaf lamina color (sRGB).
+     * Mature sun-facing leaf lamina color (sRGB).
      * @type {Color}
      */
     primary_color: Color;
     /**
-     * Vein / young tip / secondary leaf color (sRGB).
+     * Vein / secondary leaf color (sRGB).
      * @type {Color}
      */
     secondary_color: Color;
     /**
-     * Autumn / golden-red shift factor [0, 1].
+     * Legacy / convenience autumn shift factor [0, 1].
+     * Acts as a lower bound on `senescence` when non-zero for backwards compatibility.
      * @type {number}
      */
     autumn_tint: number;
@@ -57,6 +58,58 @@ export class FoliageMaterialConfig {
      * @type {number}
      */
     stem_anchor_v: number;
+    /**
+     * 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: number;
+    /**
+     * Juvenile-to-mature chlorophyll-lag lightening & yellow-green/chartreuse shift [0, 1].
+     * @type {number}
+     */
+    juvenile_color_shift: number;
+    /**
+     * Transient epidermal anthocyanin bronze/reddish margin flush on newly emerging juvenile leaves [0, 1].
+     * @type {number}
+     */
+    juvenile_anthocyanin: number;
+    /**
+     * Juvenile-to-mature leaflet aspect ratio, lobe/tooth incision depth, and lateral spread progression [0, 1].
+     * @type {number}
+     */
+    ontogeny_shape_variation: number;
+    /**
+     * Juvenile-to-mature vascular venation relief, interveinal bullation, stem lignification, and cuticle roughness progression [0, 1].
+     * @type {number}
+     */
+    ontogeny_vein_contrast: number;
+    /**
+     * 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: number;
+    /**
+     * 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: number;
+    /**
+     * 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: number;
+    /**
+     * 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: number;
     /**
      * @param {Partial<FoliageMaterialConfig>} [overrides]
      * @returns {this}

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

@@ -1 +1 @@
-{"version":3,"file":"FoliageMaterialConfig.d.ts","sourceRoot":"","sources":["../../../../../src/generation/foliage/config/FoliageMaterialConfig.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IA6DI;;;OAGG;IACH,sBAHW,QAAQ,qBAAqB,CAAC,GAC5B,qBAAqB,CAMjC;IApED;;;OAGG;IACH,YAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,eAFU,KAAK,CAEkC;IAEjD;;;OAGG;IACH,iBAFU,KAAK,CAEoC;IAEnD;;;OAGG;IACH,aAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,YAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,sBAFU,MAAM,CAES;IAEzB;;;OAGG;IACH,WAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,eAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,eAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,eAFU,MAAM,CAEI;IAYpB;;;OAGG;IACH,2BAHW,QAAQ,qBAAqB,CAAC,GAC5B,IAAI,CA6BhB;IAED;;;OAGG;IACH,YAHW,qBAAqB,GACnB,IAAI,CAehB;IAED;;OAEG;IACH,SAFa,qBAAqB,CAMjC;IAED;;;OAGG;IACH,cAHW,qBAAqB,GACnB,OAAO,CAenB;IAED;;OAEG;IACH,QAFa,MAAM,CAYlB;IAGL;;;OAGG;IACH,kCAFU,OAAO,CAEsC;CANtD;sBA7KqB,8BAA8B"}
+{"version":3,"file":"FoliageMaterialConfig.d.ts","sourceRoot":"","sources":["../../../../../src/generation/foliage/config/FoliageMaterialConfig.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IA2HC;;;OAGG;IACH,sBAHW,QAAQ,qBAAqB,CAAC,GAC5B,qBAAqB,CAMjC;IAlID;;;OAGG;IACH,YAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,eAFU,KAAK,CAEkC;IAEjD;;;OAGG;IACH,iBAFU,KAAK,CAEoC;IAEnD;;;;OAIG;IACH,aAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,YAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,sBAFU,MAAM,CAES;IAEzB;;;OAGG;IACH,WAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,eAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,eAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,eAFU,MAAM,CAEI;IAEpB;;;;;OAKG;IACH,eAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,sBAFU,MAAM,CAEY;IAE5B;;;OAGG;IACH,sBAFU,MAAM,CAEY;IAE5B;;;OAGG;IACH,0BAFU,MAAM,CAEgB;IAEhC;;;OAGG;IACH,wBAFU,MAAM,CAEc;IAE9B;;;;;OAKG;IACH,YAFU,MAAM,CAEC;IAEjB;;;;OAIG;IACH,oBAFU,MAAM,CAEU;IAE1B;;;;OAIG;IACH,uBAFU,MAAM,CAEa;IAE7B;;;;OAIG;IACH,kBAFU,MAAM,CAEQ;IAYxB;;;OAGG;IACH,2BAHW,QAAQ,qBAAqB,CAAC,GAC5B,IAAI,CAsChB;IAED;;;OAGG;IACH,YAHW,qBAAqB,GACnB,IAAI,CAwBhB;IAED;;OAEG;IACH,SAFa,qBAAqB,CAMjC;IAED;;;OAGG;IACH,cAHW,qBAAqB,GACnB,OAAO,CAwBnB;IAED;;OAEG;IACH,QAFa,MAAM,CAqBlB;IAGF;;;OAGG;IACH,kCAFU,OAAO,CAEsC;CANtD;sBA/QqB,8BAA8B"}