@woosh/meep-engine 3.68.0 → 3.70.0

package/src/shade/renderer/fluid/mac/FLUID_MAC_STEP_STRUCT.d.ts

@@ -18,8 +18,12 @@
  *
  * The step runs from `t₀`, the instant the cascade's velocity was last brought to (its read record),
  * to `t₁` (GPU_FLUID_CASCADES_PROPOSAL_2026_10_16.md §6, §8):
- * - `far_velocity`: `v_far(t₀)`, m/s: what the velocity the step starts from is a deviation from.
- * - `far_velocity_end`: `v_far(t₁)`, m/s.
+ * - `far`: `v_far(t₀)`, what the velocity the step starts from is a deviation from, as the air the
+ *   far field alone moves arrives at each point by `t₁`: its mean and `σ` at `t₀`, its eddies where
+ *   the mean has carried them by `t₁` ({@link FLUID_FAR_FIELD_STRUCT}, over the window's cells, cell
+ *   coordinate 0 at window-local cell 0). The eddies that arrive at a face by `t₁` are where the
+ *   end's offset puts them, so `far` and `far_end` share `origin` and `scale`, and one tap serves both.
+ * - `far_end`: `v_far(t₁)`, over the same lattice.
  * - `keep`: `e^(−(Λ(t₁) − Λ(t₀)))`, the deviation the atmosphere leaves over the step.
  * - `deviation_limit`: m/s, `FLUID_CASCADE_DEVIATION_CELLS·h/dt`, the clamp on `|v − v_far(t₁)|`.
  * - `band`: 1 when the faces of rows 2..5 relax toward the parent, 0 when they do not.

package/src/shade/renderer/fluid/mac/FLUID_MAC_STEP_STRUCT.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FLUID_MAC_STEP_STRUCT.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/fluid/mac/FLUID_MAC_STEP_STRUCT.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,iDAamB;6BA/CU,mCAAmC"}
+{"version":3,"file":"FLUID_MAC_STEP_STRUCT.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/fluid/mac/FLUID_MAC_STEP_STRUCT.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,iDAamB;6BApDU,mCAAmC"}

package/src/shade/renderer/fluid/mac/FLUID_MAC_STEP_STRUCT.js

@@ -1,6 +1,7 @@
 import { GRID_TILE_WINDOW_STRUCT } from "../../shader/chunk/grid/GRID_TILE_WINDOW_STRUCT.js";
-import { f32, u32, vec3f } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { f32, u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
 import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
+import { FLUID_FAR_FIELD_STRUCT } from "../FLUID_FAR_FIELD_STRUCT.js";
 
 /**
  * What the MAC passes of one cascade step read, as the uniform `step`.
@@ -22,8 +23,12 @@ import { WebGPUStruct } from "../../shader/type/WebGPUStruct.js";
  *
  * The step runs from `t₀`, the instant the cascade's velocity was last brought to (its read record),
  * to `t₁` (GPU_FLUID_CASCADES_PROPOSAL_2026_10_16.md §6, §8):
- * - `far_velocity`: `v_far(t₀)`, m/s: what the velocity the step starts from is a deviation from.
- * - `far_velocity_end`: `v_far(t₁)`, m/s.
+ * - `far`: `v_far(t₀)`, what the velocity the step starts from is a deviation from, as the air the
+ *   far field alone moves arrives at each point by `t₁`: its mean and `σ` at `t₀`, its eddies where
+ *   the mean has carried them by `t₁` ({@link FLUID_FAR_FIELD_STRUCT}, over the window's cells, cell
+ *   coordinate 0 at window-local cell 0). The eddies that arrive at a face by `t₁` are where the
+ *   end's offset puts them, so `far` and `far_end` share `origin` and `scale`, and one tap serves both.
+ * - `far_end`: `v_far(t₁)`, over the same lattice.
  * - `keep`: `e^(−(Λ(t₁) − Λ(t₀)))`, the deviation the atmosphere leaves over the step.
  * - `deviation_limit`: m/s, `FLUID_CASCADE_DEVIATION_CELLS·h/dt`, the clamp on `|v − v_far(t₁)|`.
  * - `band`: 1 when the faces of rows 2..5 relax toward the parent, 0 when they do not.
@@ -39,9 +44,9 @@ export const FLUID_MAC_STEP_STRUCT = WebGPUStruct.from({
     faces_u: GRID_TILE_WINDOW_STRUCT,
     faces_v: GRID_TILE_WINDOW_STRUCT,
     faces_w: GRID_TILE_WINDOW_STRUCT,
-    far_velocity: vec3f,
+    far: FLUID_FAR_FIELD_STRUCT,
+    far_end: FLUID_FAR_FIELD_STRUCT,
     dt_over_h: f32,
-    far_velocity_end: vec3f,
     rhs_scale: f32,
     keep: f32,
     deviation_limit: f32,

package/src/shade/renderer/fluid/mac/FluidMacPasses.d.ts

@@ -1,18 +1,3 @@
-/**
- * @typedef {import("../../../device/ShadeGPUCommandContext.js").ShadeGPUCommandContext} ShadeGPUCommandContext
- * @typedef {import("./FluidMacVelocitySet.js").FluidMacVelocitySet} FluidMacVelocitySet
- * @typedef {{u: GPUTextureView, v: GPUTextureView, w: GPUTextureView}} FluidMacVelocityViews a MAC
- *   velocity field's three component views: a {@link FluidMacVelocitySet}'s, or a frame graph's
- *   transient textures'
- * @typedef {{uniform: GPUBuffer, u: GPUTextureView, v: GPUTextureView, w: GPUTextureView, pressure: GPUBuffer}} FluidCascadeParentBindings
- *   what a step reads of its parent beyond its window: `uniform`, the parent as
- *   {@link FLUID_CASCADE_PARENT_STRUCT}; `u`, `v`, `w`, its persistent faces; `pressure`, its pressure.
- *   A far-field parent binds stand-ins it never reads.
- * @typedef {{u: GPUTextureView, v: GPUTextureView, w: GPUTextureView, pressure: GPUBuffer}} FluidCascadeGhostBindings
- *   a step's ghosts (`shader_fluid_cascade_ghosts`): `u`, `v`, `w`, the velocity shells, transient
- *   `r32float` textures of each face lattice grown by `FLUID_CASCADE_GHOST_DEPTH` on every side;
- *   `pressure`, the pressure ghosts over the window grown by one cell.
- */
 /**
  * Records the MAC passes of one cascade's step (GPU_FLUID_CASCADES_PROPOSAL_2026_10_16.md §8): the
  * advection (predict, then correct), the right-hand side of the pressure solve, and the gradient
@@ -61,15 +46,27 @@ export class FluidMacPasses {
      *
      * @param {number} h cell size, m
      * @param {number} dt time step, s
-     * @param {ArrayLike<number>} far_velocity `v_far(t₀)`, m/s: what the velocity the step starts from
-     *   is a deviation from
-     * @param {ArrayLike<number>} far_velocity_end `v_far(t₁)`, m/s
+     * @param {{mean: ArrayLike<number>, sigma: number, origin: ArrayLike<number>, scale: ArrayLike<number>}} far
+     *   `v_far(t₀)` as {@link FLUID_MAC_STEP_STRUCT} `far` holds it, over the window's cells: what the
+     *   velocity the step starts from is a deviation from
+     * @param {{mean: ArrayLike<number>, sigma: number, origin: ArrayLike<number>, scale: ArrayLike<number>}} far_end
+     *   `v_far(t₁)`, likewise
      * @param {number} keep `e^(−(Λ(t₁) − Λ(t₀)))`, in [0, 1]
      * @param {boolean} band whether the faces of rows 2..5 relax toward the parent
      * @param {number} confinement the vorticity confinement's strength ε, per second, ≥ 0: 0 for none,
      *   and then {@link record_curl} is not recorded for the step
      */
-    set_step(h: number, dt: number, far_velocity: ArrayLike<number>, far_velocity_end: ArrayLike<number>, keep: number, band: boolean, confinement: number): void;
+    set_step(h: number, dt: number, far: {
+        mean: ArrayLike<number>;
+        sigma: number;
+        origin: ArrayLike<number>;
+        scale: ArrayLike<number>;
+    }, far_end: {
+        mean: ArrayLike<number>;
+        sigma: number;
+        origin: ArrayLike<number>;
+        scale: ArrayLike<number>;
+    }, keep: number, band: boolean, confinement: number): void;
     /**
      * The step's vorticity confinement, pass 1 (`shader_fluid_mac_curl`): the curl of the persistent
      * velocity and the force it makes in every cell, for the correct pass. Recorded only for a step whose
@@ -146,8 +143,9 @@ export type FluidMacVelocityViews = {
 };
 /**
  * what a step reads of its parent beyond its window: `uniform`, the parent as
- * {@link FLUID_CASCADE_PARENT_STRUCT }; `u`, `v`, `w`, its persistent faces; `pressure`, its pressure.
- * A far-field parent binds stand-ins it never reads.
+ * {@link FLUID_CASCADE_PARENT_STRUCT }; `u`, `v`, `w`, its persistent faces; `pressure`, its pressure;
+ * `turbulence`, the far field's turbulence tile, which the step's far field reads too. A far-field
+ * parent binds stand-ins it never reads.
  */
 export type FluidCascadeParentBindings = {
     uniform: GPUBuffer;
@@ -155,6 +153,7 @@ export type FluidCascadeParentBindings = {
     v: GPUTextureView;
     w: GPUTextureView;
     pressure: GPUBuffer;
+    turbulence: GPUTextureView;
 };
 /**
  * a step's ghosts (`shader_fluid_cascade_ghosts`): `u`, `v`, `w`, the velocity shells, transient

package/src/shade/renderer/fluid/mac/FluidMacPasses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FluidMacPasses.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/fluid/mac/FluidMacPasses.js"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IACI;;;;OAIG;IACH,iCAFW,OAAO,6CAA6C,EAAE,eAAe,QAW/E;IA2ED;;;;;OAKG;IACH,kBAHW,UAAU,MAAM,CAAC,UACjB,UAAU,MAAM,CAAC,QAkC3B;IAED;;;;;;;;;;;;OAYG;IACH,YAVW,MAAM,MACN,MAAM,gBACN,UAAU,MAAM,CAAC,oBAEjB,UAAU,MAAM,CAAC,QACjB,MAAM,QACN,OAAO,eACP,MAAM,QA+BhB;IAaD;;;;;;;;;OASG;IACH,qBALW,sBAAsB,UACtB,qBAAqB,kDAmB/B;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,uBAbW,sBAAsB,UACtB,qBAAqB,WACrB,qBAAqB,OACrB,qBAAqB,wEAOrB,0BAA0B,UAC1B,yBAAyB,QAwCnC;IAED;;;;;;;OAOG;IACH,uBAJW,sBAAsB,UACtB,0BAA0B,UAC1B,yBAAyB,QAgBnC;IAuBD;;;;;;;;;OASG;IACH,2BANW,sBAAsB,YACtB,qBAAqB,6DAmB/B;IAED;;;;;;;;;OASG;IACH,yBAPW,sBAAsB,YACtB,qBAAqB,8CAGrB,qBAAqB,UACrB,yBAAyB,QAmBnC;;CACJ;qCA3ZY,OAAO,2CAA2C,EAAE,sBAAsB;kCAC1E,OAAO,0BAA0B,EAAE,mBAAmB;;;;;;oCACtD;IAAC,CAAC,iBAAiB;IAAC,CAAC,iBAAiB;IAAC,CAAC,iBAAgB;CAAC;;;;;;yCAGzD;IAAC,OAAO,YAAY;IAAC,CAAC,iBAAiB;IAAC,CAAC,iBAAiB;IAAC,CAAC,iBAAiB;IAAC,QAAQ,YAAW;CAAC;;;;;;wCAIlG;IAAC,CAAC,iBAAiB;IAAC,CAAC,iBAAiB;IAAC,CAAC,iBAAiB;IAAC,QAAQ,YAAW;CAAC"}
+{"version":3,"file":"FluidMacPasses.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/fluid/mac/FluidMacPasses.js"],"names":[],"mappings":"AAuDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IACI;;;;OAIG;IACH,iCAFW,OAAO,6CAA6C,EAAE,eAAe,QAW/E;IA2ED;;;;;OAKG;IACH,kBAHW,UAAU,MAAM,CAAC,UACjB,UAAU,MAAM,CAAC,QAkC3B;IAED;;;;;;;;;;;;;;OAcG;IACH,YAZW,MAAM,MACN,MAAM,OACN;QAAC,IAAI,EAAE,UAAU,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,UAAU,MAAM,CAAC,CAAA;KAAC,WAG7F;QAAC,IAAI,EAAE,UAAU,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,UAAU,MAAM,CAAC,CAAA;KAAC,QAE7F,MAAM,QACN,OAAO,eACP,MAAM,QA0BhB;IAaD;;;;;;;;;OASG;IACH,qBALW,sBAAsB,UACtB,qBAAqB,kDAmB/B;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,uBAbW,sBAAsB,UACtB,qBAAqB,WACrB,qBAAqB,OACrB,qBAAqB,wEAOrB,0BAA0B,UAC1B,yBAAyB,QA0CnC;IAED;;;;;;;OAOG;IACH,uBAJW,sBAAsB,UACtB,0BAA0B,UAC1B,yBAAyB,QAkBnC;IAuBD;;;;;;;;;OASG;IACH,2BANW,sBAAsB,YACtB,qBAAqB,6DAmB/B;IAED;;;;;;;;;OASG;IACH,yBAPW,sBAAsB,YACtB,qBAAqB,8CAGrB,qBAAqB,UACrB,yBAAyB,QAmBnC;;CACJ;qCApbY,OAAO,2CAA2C,EAAE,sBAAsB;kCAC1E,OAAO,0BAA0B,EAAE,mBAAmB;;;;;;oCACtD;IAAC,CAAC,iBAAiB;IAAC,CAAC,iBAAiB;IAAC,CAAC,iBAAgB;CAAC;;;;;;;yCAGzD;IAAC,OAAO,YAAY;IAAC,CAAC,iBAAiB;IAAC,CAAC,iBAAiB;IAAC,CAAC,iBAAiB;IAAC,QAAQ,YAAY;IAAC,UAAU,iBAAgB;CAAC;;;;;;wCAK9H;IAAC,CAAC,iBAAiB;IAAC,CAAC,iBAAiB;IAAC,CAAC,iBAAiB;IAAC,QAAQ,YAAW;CAAC"}