@woosh/meep-engine 3.60.6 → 3.60.8

package/src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP.d.ts

@@ -211,16 +211,24 @@ export const PROBE_DEPTH_LIMIT: number;
  */
 export const PROBE_BACK_FACE_DEPTH: number;
 /**
- * The most a radiance texel counts of the updates that reached it: its blend's floor is 1/(this + 1),
- * below the time term's at any frame rate a probe is updated at.
+ * The short mean's blend a sample, the multi-scale mean estimator's own (Barré-Brisebois et al. 2019), and the
+ * depth's: a texel's samples, however far apart in time they come. A change in the light is the estimator's to
+ * find, not the time since the last sample's to assume (§8.8).
  * @type {number}
  */
-export const PROBE_RADIANCE_SAMPLES_LIMIT: number;
+export const PROBE_SHORT_BLEND: number;
 /**
- * The share of an update's resolved rays on back faces past which the probe is dead (§8.4).
+ * The variance's blend a sample, half the short mean's, so that its window outlasts the short mean's; and the
+ * blend of a probe's change statistics, which follow the estimator's variance (§8.8).
  * @type {number}
  */
-export const PROBE_DEAD_BACK_FACE_SHARE: number;
+export const PROBE_VARIANCE_BLEND: number;
+/**
+ * The most a radiance texel counts of the updates that reached it: its long mean is its running mean until
+ * then, its blend's floor 1/(this + 1), far below `PROBE_SHORT_BLEND`.
+ * @type {number}
+ */
+export const PROBE_RADIANCE_SAMPLES_LIMIT: number;
 /**
  * Rays a depth texel gathers at most, which bounds the settings: R ≤ this · n_d².
  * @type {number}
@@ -236,12 +244,19 @@ export const PROBE_DEPTH_TEXEL_RAYS: number;
  */
 export const PROBE_UNIFORM_PERIOD: number;
 /**
- * The fewest rays an update casts, of the radiance texels: a quarter. The settings hold R to
- * `[n_r²/4, 4·n_r²]`, which the uniform map and the gathers are built for; a DEAD probe's updates cast
- * the fewest, and a guided update of a probe that sees no change asks for no more (§8.6).
+ * The fewest rays a guided update casts, of the radiance texels: a quarter, or R where R is fewer, so
+ * that no update casts more than the budget counts a probe for. A guided update of a probe that sees no
+ * change asks for no more (§8.6).
  * @type {number}
  */
 export const PROBE_RAYS_PER_TEXEL_MIN: number;
+/**
+ * Rays a DEAD probe's update casts, or R where R is fewer, uniform over the sphere (§8.4, §8.6). A DEAD
+ * probe is one whose every resolved ray hit a back face; the update asks only whether one ray now gets
+ * out.
+ * @type {number}
+ */
+export const PROBE_DEAD_RAYS: number;
 /**
  * The most rays an update casts, of the radiance texels: four. A guided update of a probe whose light
  * moved asks for them, and a new probe's first guided ones (§8.6). The guide holds any one texel under
@@ -266,6 +281,12 @@ export const PROBE_CHANGE_SIGNIFICANCE: number;
  * @type {number}
  */
 export const PROBE_TEXEL_RAYS: number;
+/**
+ * The share of the frame's ray budget the frustum's probes trace; the world cache's is the rest
+ * (WORLD_PROBE_CACHE_SCOPE_2026_11_01.md). Alex's, 2026-11-01.
+ * @type {number}
+ */
+export const FRUSTUM_RAY_BUDGET_FRACTION: number;
 /**
  * The guide's fixed point. A texel's weight is its share of the probe's luminance in units of 1/this,
  * so the walk's sums are exact and every pass that reads them agrees on each texel's rays. A share
@@ -300,25 +321,20 @@ export const PROBE_RAY_BACK_FACE: number;
  * @type {number}
  */
 export const PROBE_RAY_CASCADE_SHIFT: number;
-/**
- * The hit's cascade's bits once shifted down: the brick clipmap has at most
- * `PROBE_CLIPMAP_CASCADE_COUNT_MAX` (8) cascades.
- * @type {number}
- */
-export const PROBE_RAY_CASCADE_MASK: number;
 /**
  * The shift of the ray's probe, its place in the trace list: 24 bits, past any trace list.
  * @type {number}
  */
 export const PROBE_RAY_PROBE_SHIFT: number;
 /**
- * Set when a pixel wanted the probe in the last frame anything did, clear when only hits did (§8.3):
- * whether its hits want in turn.
+ * The hit's cascade's bits once shifted down: every bit between the cascade's shift and the probe's,
+ * so the brick clipmap's cascades fit in it up to 32.
  * @type {number}
  */
-export const PROBE_RECORD_SCREEN: number;
+export const PROBE_RAY_CASCADE_MASK: number;
 /**
- * The shift of the probe's cascade, the flags' top bits: six, past `PROBE_CLIPMAP_CASCADE_COUNT_MAX`.
+ * The shift of the probe's cascade, the flags' top bits: six, so the probe clipmap's cascades fit in it up
+ * to 64.
  * @type {number}
  */
 export const PROBE_RECORD_CASCADE_SHIFT: number;
@@ -332,13 +348,6 @@ export const PROBE_WANT_TILE: number;
  * @type {number}
  */
 export const PROBE_WANT_WORKGROUP_TILES: number;
-/**
- * A wanted list entry's top bit: a pixel wanted the point, not only hits (§8.3). Admit marks the point's
- * probe as the screen's on it, and only the screen's probes' hits want in turn. The key is the other
- * bits.
- * @type {number}
- */
-export const PROBE_WANTED_SCREEN: number;
 /**
  * Lanes of the fill, a texel of the indirection each.
  * @type {number}

package/src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PROBE_CLIPMAP.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"PROBE_CLIPMAP.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP.js"],"names":[],"mappings":"AAoRA;;;;;;;;;;GAUG;AACH,8DAJW,MAAM,oBACN,MAAM,GACJ,MAAM,CAIlB;AAsED;;;;;;;;;;;GAWG;AACH,+DAHW,MAAM,GACJ,MAAM,CAIlB;AA1WD;;;GAGG;AACH,iCAFU,MAAM,CAE6B;AAS7C;;;GAGG;AACH,+BAFU,MAAM,CAEkB;AAElC;;;GAGG;AACH,8BAFU,MAAM,CAEiB;AAEjC;;;GAGG;AACH,gCAFU,MAAM,CAEmB;AAEnC;;;;GAIG;AACH,+BAFU,MAAM,CAEkB;AAElC;;;GAGG;AACH,oCAFU,MAAM,CAEuB;AAEvC;;;GAGG;AACH,wCAFU,MAAM,CAE2B;AAM3C;;;GAGG;AACH,iCAFU,MAAM,CAEoB;AAEpC;;;;GAIG;AACH,oCAFU,MAAM,CAEuB;AAEvC;;;GAGG;AACH,mCAFU,MAAM,CAEsB;AAEtC;;;;GAIG;AACH,oCAFU,MAAM,CAEuB;AAEvC;;;;;GAKG;AACH,oCAFU,MAAM,CAEuB;AAEvC;;;;GAIG;AACH,gCAFU,MAAM,CAEoB;AAEpC;;;;GAIG;AACH,iCAFU,MAAM,CAEoB;AAEpC;;;GAGG;AACH,kCAFU,MAAM,CAE0D;AAE1E;;;;GAIG;AACH,+BAFU,MAAM,CAEqB;AAQrC;;;;GAIG;AACH,oCAFU,MAAM,CAEuB;AAEvC;;;GAGG;AACH,mCAFU,MAAM,CAEsB;AAEtC;;;GAGG;AACH,oCAFU,MAAM,CAEuB;AAEvC;;;GAGG;AACH,kCAFU,MAAM,CAEqB;AAErC;;;GAGG;AACH,oCAFU,MAAM,CAEwB;AAExC;;;GAGG;AACH,kCAFU,MAAM,CAEsB;AAEtC;;;GAGG;AACH,qCAFU,MAAM,CAEyB;AAEzC;;;;GAIG;AACH,8BAFU,MAAM,CAEoB;AAEpC;;;GAGG;AACH,mCAFU,MAAM,CAEuB;AAEvC;;;GAGG;AACH,mCAFU,MAAM,CAEuB;AAEvC;;;GAGG;AACH,0CAFU,MAAM,CAE8B;AAE9C;;;;GAIG;AACH,yCAFU,MAAM,CAE+B;AAE/C;;;;GAIG;AACH,qCAFU,MAAM,CAE2B;AAE3C;;;GAGG;AACH,qCAFU,MAAM,CAEwB;AAExC;;;;;;;;GAQG;AACH,sCAFU,MAAM,CAE8B;AAE9C;;;;;;;GAOG;AACH,gCAFU,MAAM,CAE6D;AAE7E;;;;GAIG;AACH,oCAFU,MAAM,CAEyB;AAEzC;;;;;GAKG;AACH,gCAFU,MAAM,CAEsB;AAEtC;;;;GAIG;AACH,mCAFU,MAAM,CAE0C;AAE1D;;;;GAIG;AACH,2CAFU,MAAM,CAEgC;AAEhD;;;GAGG;AACH,qCAFU,MAAM,CAEyB;AAiBzC;;;;;;;GAOG;AACH,mCAFU,MAAM,CAEsB;AAEtC;;;;;GAKG;AACH,uCAFU,MAAM,CAE8B;AAE9C;;;;;GAKG;AACH,8BAFU,MAAM,CAEkB;AAElC;;;;;GAKG;AACH,uCAFU,MAAM,CAE0B;AAE1C;;;;;;;;GAQG;AACH,wCAFU,MAAM,CAE2B;AAE3C;;;;;GAKG;AACH,+BAFU,MAAM,CAEuC;AAEvD;;;;GAIG;AACH,0CAFU,MAAM,CAEgC;AAEhD;;;;;GAKG;AACH,gCAFU,MAAM,CAEuB;AAkBvC;;;;GAIG;AACH,kCAFU,MAAM,CAEqB;AAQrC;;;GAGG;AACH,kCAFU,MAAM,CAEqB;AAErC;;;;GAIG;AACH,6BAFU,MAAM,CAEgB;AAEhC;;;GAGG;AACH,kCAFU,MAAM,CAEqB;AAErC;;;GAGG;AACH,sCAFU,MAAM,CAEyB;AAEzC;;;GAGG;AACH,oCAFU,MAAM,CAEuB;AAEvC;;;;GAIG;AACH,qCAFU,MAAM,CAEmF;AAOnG;;;;GAIG;AACH,yCAFU,MAAM,CAE6B;AAE7C;;;GAGG;AACH,8BAFU,MAAM,CAEiB;AAEjC;;;GAGG;AACH,yCAFU,MAAM,CAE4B;AAE5C;;;GAGG;AACH,wCAFU,MAAM,CAE4B;AAE5C;;;;GAIG;AACH,gCAFU,MAAM,CAEmB;AAEnC;;;GAGG;AACH,kCAFU,MAAM,CAEuB;AAEvC;;;;GAIG;AACH,uCAFU,MAAM,CAE4B;AAE5C;;;;GAIG;AACH,wCAFU,MAAM,CAE2B"}

package/src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP.js

@@ -247,17 +247,26 @@ export const PROBE_DEPTH_LIMIT = (1 + PROBE_RELOCATION_LIMIT) * Math.sqrt(3);
 export const PROBE_BACK_FACE_DEPTH = 0.2;
 
 /**
- * The most a radiance texel counts of the updates that reached it: its blend's floor is 1/(this + 1),
- * below the time term's at any frame rate a probe is updated at.
+ * The short mean's blend a sample, the multi-scale mean estimator's own (Barré-Brisebois et al. 2019), and the
+ * depth's: a texel's samples, however far apart in time they come. A change in the light is the estimator's to
+ * find, not the time since the last sample's to assume (§8.8).
  * @type {number}
  */
-export const PROBE_RADIANCE_SAMPLES_LIMIT = 255;
+export const PROBE_SHORT_BLEND = 0.08;
 
 /**
- * The share of an update's resolved rays on back faces past which the probe is dead (§8.4).
+ * The variance's blend a sample, half the short mean's, so that its window outlasts the short mean's; and the
+ * blend of a probe's change statistics, which follow the estimator's variance (§8.8).
  * @type {number}
  */
-export const PROBE_DEAD_BACK_FACE_SHARE = 0.25;
+export const PROBE_VARIANCE_BLEND = PROBE_SHORT_BLEND / 2;
+
+/**
+ * The most a radiance texel counts of the updates that reached it: its long mean is its running mean until
+ * then, its blend's floor 1/(this + 1), far below `PROBE_SHORT_BLEND`.
+ * @type {number}
+ */
+export const PROBE_RADIANCE_SAMPLES_LIMIT = 255;
 
 /**
  * Rays a depth texel gathers at most, which bounds the settings: R ≤ this · n_d².
@@ -291,13 +300,21 @@ export function probe_clipmap_maps_words(radiance_resolution, depth_resolution)
 export const PROBE_UNIFORM_PERIOD = 5;
 
 /**
- * The fewest rays an update casts, of the radiance texels: a quarter. The settings hold R to
- * `[n_r²/4, 4·n_r²]`, which the uniform map and the gathers are built for; a DEAD probe's updates cast
- * the fewest, and a guided update of a probe that sees no change asks for no more (§8.6).
+ * The fewest rays a guided update casts, of the radiance texels: a quarter, or R where R is fewer, so
+ * that no update casts more than the budget counts a probe for. A guided update of a probe that sees no
+ * change asks for no more (§8.6).
  * @type {number}
  */
 export const PROBE_RAYS_PER_TEXEL_MIN = 1 / 4;
 
+/**
+ * Rays a DEAD probe's update casts, or R where R is fewer, uniform over the sphere (§8.4, §8.6). A DEAD
+ * probe is one whose every resolved ray hit a back face; the update asks only whether one ray now gets
+ * out.
+ * @type {number}
+ */
+export const PROBE_DEAD_RAYS = 16;
+
 /**
  * The most rays an update casts, of the radiance texels: four. A guided update of a probe whose light
  * moved asks for them, and a new probe's first guided ones (§8.6). The guide holds any one texel under
@@ -325,6 +342,13 @@ export const PROBE_CHANGE_SIGNIFICANCE = 3;
  */
 export const PROBE_TEXEL_RAYS = PROBE_DEPTH_TEXEL_RAYS;
 
+/**
+ * The share of the frame's ray budget the frustum's probes trace; the world cache's is the rest
+ * (WORLD_PROBE_CACHE_SCOPE_2026_11_01.md). Alex's, 2026-11-01.
+ * @type {number}
+ */
+export const FRUSTUM_RAY_BUDGET_FRACTION = 0.75;
+
 /**
  * The guide's fixed point. A texel's weight is its share of the probe's luminance in units of 1/this,
  * so the walk's sums are exact and every pass that reads them agrees on each texel's rays. A share
@@ -359,7 +383,7 @@ export const PROBE_SHADOWED_SUNS = 2;
 /*
  A ray's flags, `PROBE_RAY_STRUCT.flags`: its kind in the low two bits, as the brick clipmap's tracer
  names it (miss 0, hit 1, unresolved 2) or none (3), whether the hit is a back face, the hit's cascade
- in three bits above, and the probe it belongs to, its place in the trace list, from bit 8.
+ in the five bits above, and the probe it belongs to, its place in the trace list, from bit 8.
 */
 
 /**
@@ -388,32 +412,26 @@ export const PROBE_RAY_BACK_FACE = 4;
 export const PROBE_RAY_CASCADE_SHIFT = 3;
 
 /**
- * The hit's cascade's bits once shifted down: the brick clipmap has at most
- * `PROBE_CLIPMAP_CASCADE_COUNT_MAX` (8) cascades.
+ * The shift of the ray's probe, its place in the trace list: 24 bits, past any trace list.
  * @type {number}
  */
-export const PROBE_RAY_CASCADE_MASK = 7;
+export const PROBE_RAY_PROBE_SHIFT = 8;
 
 /**
- * The shift of the ray's probe, its place in the trace list: 24 bits, past any trace list.
+ * The hit's cascade's bits once shifted down: every bit between the cascade's shift and the probe's,
+ * so the brick clipmap's cascades fit in it up to 32.
  * @type {number}
  */
-export const PROBE_RAY_PROBE_SHIFT = 8;
+export const PROBE_RAY_CASCADE_MASK = (1 << (PROBE_RAY_PROBE_SHIFT - PROBE_RAY_CASCADE_SHIFT)) - 1;
 
 /*
  A probe record's flags, `PROBE_RECORD_STRUCT.flags`: the share of its last update's resolved rays that
- hit back faces, unorm16, in the low half; ten bits of flags above it; its cascade in the top six bits.
+ hit back faces, unorm16, in the low half; ten bits clear above it; its cascade in the top six bits.
 */
 
 /**
- * Set when a pixel wanted the probe in the last frame anything did, clear when only hits did (§8.3):
- * whether its hits want in turn.
- * @type {number}
- */
-export const PROBE_RECORD_SCREEN = 0x10000;
-
-/**
- * The shift of the probe's cascade, the flags' top bits: six, past `PROBE_CLIPMAP_CASCADE_COUNT_MAX`.
+ * The shift of the probe's cascade, the flags' top bits: six, so the probe clipmap's cascades fit in it up
+ * to 64.
  * @type {number}
  */
 export const PROBE_RECORD_CASCADE_SHIFT = 26;
@@ -430,14 +448,6 @@ export const PROBE_WANT_TILE = 8;
  */
 export const PROBE_WANT_WORKGROUP_TILES = 8;
 
-/**
- * A wanted list entry's top bit: a pixel wanted the point, not only hits (§8.3). Admit marks the point's
- * probe as the screen's on it, and only the screen's probes' hits want in turn. The key is the other
- * bits.
- * @type {number}
- */
-export const PROBE_WANTED_SCREEN = 0x80000000;
-
 /**
  * Lanes of the fill, a texel of the indirection each.
  * @type {number}

package/src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP_RESAMPLING.d.ts

@@ -1,10 +1,12 @@
 /**
- * Whether the frame's updates re-sample their neighbours (`shader_probe_clipmap_resample`): accumulate
- * then adds each radiance texel's re-samples to its rays (`chunk_probe_clipmap_resampled`). Decided by
- * `chunk_probe_clipmap_resampled`, whose `false` alternative, the default, is the texel's own rays alone
- * and binds nothing more, so a pass that never sets it accumulates exactly as it always did.
+ * Whether the frame's updates re-sample their neighbours, their histories (`shader_probe_clipmap_resample`) or
+ * their rays (`shader_probe_clipmap_resample_rays`): accumulate then adds each radiance texel's re-samples to its
+ * rays (`chunk_probe_clipmap_resampled`). Decided by `chunk_probe_clipmap_resampled`, whose `false` alternative, the
+ * default, is the texel's own rays alone and binds nothing more, so a pass that never sets it accumulates exactly as
+ * it always did.
  *
- * `GPUProbeClipmap` sets it from `ProbeClipmapSettings.resampling` the frame it records the update.
+ * `GPUProbeClipmap` sets it from `ProbeClipmapSettings.history_resampling` or `ray_resampling` the frame it records
+ * the update.
  *
  * @type {ShaderSwitch}
  */

package/src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP_RESAMPLING.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PROBE_CLIPMAP_RESAMPLING.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP_RESAMPLING.js"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,uCAFU,YAAY,CAEgE;6BAZzD,0CAA0C"}
+{"version":3,"file":"PROBE_CLIPMAP_RESAMPLING.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP_RESAMPLING.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,uCAFU,YAAY,CAEgE;6BAdzD,0CAA0C"}

package/src/shade/renderer/global_illumination/probe_clipmap/probe/PROBE_CLIPMAP_RESAMPLING.js

@@ -1,12 +1,14 @@
 import { ShaderSwitch } from "../../../shader/compiler/ShaderSwitch.js";
 
 /**
- * Whether the frame's updates re-sample their neighbours (`shader_probe_clipmap_resample`): accumulate
- * then adds each radiance texel's re-samples to its rays (`chunk_probe_clipmap_resampled`). Decided by
- * `chunk_probe_clipmap_resampled`, whose `false` alternative, the default, is the texel's own rays alone
- * and binds nothing more, so a pass that never sets it accumulates exactly as it always did.
+ * Whether the frame's updates re-sample their neighbours, their histories (`shader_probe_clipmap_resample`) or
+ * their rays (`shader_probe_clipmap_resample_rays`): accumulate then adds each radiance texel's re-samples to its
+ * rays (`chunk_probe_clipmap_resampled`). Decided by `chunk_probe_clipmap_resampled`, whose `false` alternative, the
+ * default, is the texel's own rays alone and binds nothing more, so a pass that never sets it accumulates exactly as
+ * it always did.
  *
- * `GPUProbeClipmap` sets it from `ProbeClipmapSettings.resampling` the frame it records the update.
+ * `GPUProbeClipmap` sets it from `ProbeClipmapSettings.history_resampling` or `ray_resampling` the frame it records
+ * the update.
  *
  * @type {ShaderSwitch}
  */

package/src/shade/renderer/global_illumination/probe_clipmap/probe/ProbeClipmapHitWants.d.ts

@@ -0,0 +1,47 @@
+/**
+ * A clipmap's probes wanted by another clipmap's hits (WORLD_PROBE_CACHE_SCOPE_2026_11_01.md §1.3): each
+ * front-face hit of that clipmap's last frame that its own probes did not serve wants the cages its pick reads
+ * here (`shader_probe_clipmap_want_hits`). The world cache's wants, from the frustum's rays; a
+ * {@link GPUProbeClipmap} records them in its lifetime, between retire and admit.
+ *
+ * It reads the rays as their clipmap left them, so the wanting clipmap's lifetime is recorded before theirs,
+ * which writes them over. Give it that clipmap's ray budget with {@link set} before the wanting clipmap's
+ * `graph_update`.
+ */
+export class ProbeClipmapHitWants {
+    /**
+     * @param {import("./GPUProbeClipmap.js").GPUProbeClipmap} rays_of the clipmap whose last frame's hits want
+     */
+    constructor(rays_of: import("./GPUProbeClipmap.js").GPUProbeClipmap);
+    /**
+     * The other clipmap's frame.
+     *
+     * @param {Object} options
+     * @param {number} options.ray_budget the rays it casts a frame at most
+     */
+    set({ ray_budget }: {
+        ray_budget: number;
+    }): void;
+    /**
+     * @returns {number} the most points a frame's wants list: each of the other clipmap's rays, the eight points of
+     *   a cage in each of two cascades
+     */
+    wanted_bound(): number;
+    /**
+     * Nothing of the frame graph's: the rays are the other clipmap's own buffers, read before its lifetime.
+     *
+     * @param {*} pass
+     * @param {Object} data
+     */
+    graph_declare(pass: any, data: any): void;
+    /**
+     * @param {GPUCommandEncoder} encoder
+     * @param {Object} data the lifetime pass's data
+     * @param {*} resources the frame graph's resources
+     * @param {Object} clipmap what the wanting clipmap binds: `probe_levels`, `probe_wanted`,
+     *   `probe_wanted_bits` and its want settings as `settings`
+     */
+    encode(encoder: GPUCommandEncoder, data: any, resources: any, clipmap: any): void;
+    #private;
+}
+//# sourceMappingURL=ProbeClipmapHitWants.d.ts.map

package/src/shade/renderer/global_illumination/probe_clipmap/probe/ProbeClipmapHitWants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProbeClipmapHitWants.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/probe/ProbeClipmapHitWants.js"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH;IAQI;;OAEG;IACH,qBAFW,OAAO,sBAAsB,EAAE,eAAe,EAMxD;IAED;;;;;OAKG;IACH;QAF2B,UAAU,EAA1B,MAAM;aAMhB;IAED;;;OAGG;IACH,gBAHa,MAAM,CAKlB;IAED;;;;;OAKG;IACH,0CACC;IAED;;;;;;OAMG;IACH,kFAeC;;CACJ"}

package/src/shade/renderer/global_illumination/probe_clipmap/probe/ProbeClipmapHitWants.js

@@ -0,0 +1,84 @@
+import { assert } from "../../../../../core/assert.js";
+import { PROBE_DISPATCH_RAYS } from "./PROBE_CLIPMAP.js";
+import { shader_probe_clipmap_want_hits } from "./shader_probe_clipmap_want_hits.js";
+
+/**
+ * A clipmap's probes wanted by another clipmap's hits (WORLD_PROBE_CACHE_SCOPE_2026_11_01.md §1.3): each
+ * front-face hit of that clipmap's last frame that its own probes did not serve wants the cages its pick reads
+ * here (`shader_probe_clipmap_want_hits`). The world cache's wants, from the frustum's rays; a
+ * {@link GPUProbeClipmap} records them in its lifetime, between retire and admit.
+ *
+ * It reads the rays as their clipmap left them, so the wanting clipmap's lifetime is recorded before theirs,
+ * which writes them over. Give it that clipmap's ray budget with {@link set} before the wanting clipmap's
+ * `graph_update`.
+ */
+export class ProbeClipmapHitWants {
+    /** @type {import("./GPUProbeClipmap.js").GPUProbeClipmap} */
+    #rays_of;
+
+    #bindings = {};
+
+    #ray_budget = 0;
+
+    /**
+     * @param {import("./GPUProbeClipmap.js").GPUProbeClipmap} rays_of the clipmap whose last frame's hits want
+     */
+    constructor(rays_of) {
+        assert.defined(rays_of, 'rays_of');
+
+        this.#rays_of = rays_of;
+    }
+
+    /**
+     * The other clipmap's frame.
+     *
+     * @param {Object} options
+     * @param {number} options.ray_budget the rays it casts a frame at most
+     */
+    set({ ray_budget }) {
+        assert.isPositiveInteger(ray_budget, 'ray_budget');
+
+        this.#ray_budget = ray_budget;
+    }
+
+    /**
+     * @returns {number} the most points a frame's wants list: each of the other clipmap's rays, the eight points of
+     *   a cage in each of two cascades
+     */
+    wanted_bound() {
+        return 16 * this.#ray_budget;
+    }
+
+    /**
+     * Nothing of the frame graph's: the rays are the other clipmap's own buffers, read before its lifetime.
+     *
+     * @param {*} pass
+     * @param {Object} data
+     */
+    graph_declare(pass, data) {
+    }
+
+    /**
+     * @param {GPUCommandEncoder} encoder
+     * @param {Object} data the lifetime pass's data
+     * @param {*} resources the frame graph's resources
+     * @param {Object} clipmap what the wanting clipmap binds: `probe_levels`, `probe_wanted`,
+     *   `probe_wanted_bits` and its want settings as `settings`
+     */
+    encode(encoder, data, resources, clipmap) {
+        const rays_of = this.#rays_of;
+        const b = Object.assign(this.#bindings, clipmap);
+
+        // as the other clipmap holds them now, which a growth may have replaced since the frame was recorded
+        b.probe_trace = rays_of.trace;
+        b.probe_origins = rays_of.origins;
+        b.probe_rays = rays_of.rays;
+
+        shader_probe_clipmap_want_hits.dispatchIndirect({
+            encoder,
+            bindings: b,
+            command: rays_of.dispatch,
+            command_offset: 4 * PROBE_DISPATCH_RAYS,
+        });
+    }
+}

package/src/shade/renderer/global_illumination/probe_clipmap/probe/ProbeClipmapScreenWants.d.ts

@@ -0,0 +1,48 @@
+/**
+ * A clipmap's probes wanted by the frame's pixels (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §8.3): one pixel of
+ * each screen tile wants the cages its pick reads (`shader_probe_clipmap_want`). The wants of the frustum's
+ * probes; a {@link GPUProbeClipmap} records them in its lifetime, between retire and admit.
+ *
+ * Give it the frame's G-buffer with {@link set} before the clipmap's `graph_update`.
+ */
+export class ProbeClipmapScreenWants {
+    /**
+     * The frame's G-buffer and view.
+     *
+     * @param {Object} options
+     * @param {number} options.depth graph handle of the frame's depth
+     * @param {number} options.normal graph handle of the G-buffer's normals
+     * @param {GPUBuffer} options.camera the view's camera uniform
+     * @param {*} options.stbn the 2-channel spatio-temporal blue noise, `STATIC_GRAPHICS_ENGINE_ASSETS.stbn_vec2`
+     * @param {ArrayLike<number>} options.resolution the frame's pixels, x and y
+     */
+    set({ depth, normal, camera, stbn, resolution }: {
+        depth: number;
+        normal: number;
+        camera: GPUBuffer;
+        stbn: any;
+        resolution: ArrayLike<number>;
+    }): void;
+    /**
+     * @returns {number} the most points a frame's wants list: a pixel of each tile, the eight points of a cage in
+     *   each of two cascades
+     */
+    wanted_bound(): number;
+    /**
+     * Declare what the wants read on the lifetime's pass.
+     *
+     * @param {import("../../../../../engine/graphics/render/frame_graph/FramePassBuilder.js").FramePassBuilder} pass
+     * @param {Object} data the pass's data, which {@link encode} is given back
+     */
+    graph_declare(pass: import("../../../../../engine/graphics/render/frame_graph/FramePassBuilder.js").FramePassBuilder, data: any): void;
+    /**
+     * @param {GPUCommandEncoder} encoder
+     * @param {Object} data the lifetime pass's data
+     * @param {*} resources the frame graph's resources
+     * @param {Object} clipmap what the wanting clipmap binds: `probe_levels`, `probe_wanted`,
+     *   `probe_wanted_bits` and its want settings as `settings`
+     */
+    encode(encoder: GPUCommandEncoder, data: any, resources: any, clipmap: any): void;
+    #private;
+}
+//# sourceMappingURL=ProbeClipmapScreenWants.d.ts.map

package/src/shade/renderer/global_illumination/probe_clipmap/probe/ProbeClipmapScreenWants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProbeClipmapScreenWants.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/global_illumination/probe_clipmap/probe/ProbeClipmapScreenWants.js"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH;IAeI;;;;;;;;;OASG;IACH;QAN2B,KAAK,EAArB,MAAM;QACU,MAAM,EAAtB,MAAM;QACa,MAAM;QACd,IAAI;QACY,UAAU,EAArC,UAAU,MAAM,CAAC;aAqB3B;IAED;;;OAGG;IACH,gBAHa,MAAM,CAKlB;IAED;;;;;OAKG;IACH,oBAHW,OAAO,uEAAuE,EAAE,gBAAgB,mBAQ1G;IAED;;;;;;OAMG;IACH,kFAcC;;CACJ"}

package/src/shade/renderer/global_illumination/probe_clipmap/probe/ProbeClipmapScreenWants.js

@@ -0,0 +1,101 @@
+import { assert } from "../../../../../core/assert.js";
+import { PROBE_WANT_TILE, PROBE_WANT_WORKGROUP_TILES } from "./PROBE_CLIPMAP.js";
+import { shader_probe_clipmap_want } from "./shader_probe_clipmap_want.js";
+
+/**
+ * A clipmap's probes wanted by the frame's pixels (PROBE_CLIPMAP_PROPOSAL_2026_10_27.md §8.3): one pixel of
+ * each screen tile wants the cages its pick reads (`shader_probe_clipmap_want`). The wants of the frustum's
+ * probes; a {@link GPUProbeClipmap} records them in its lifetime, between retire and admit.
+ *
+ * Give it the frame's G-buffer with {@link set} before the clipmap's `graph_update`.
+ */
+export class ProbeClipmapScreenWants {
+    #depth = -1;
+    #normal = -1;
+
+    /** @type {GPUBuffer|null} */
+    #camera = null;
+
+    #stbn = null;
+
+    #groups = [0, 0];
+
+    #tiles = 0;
+
+    #bindings = {};
+
+    /**
+     * The frame's G-buffer and view.
+     *
+     * @param {Object} options
+     * @param {number} options.depth graph handle of the frame's depth
+     * @param {number} options.normal graph handle of the G-buffer's normals
+     * @param {GPUBuffer} options.camera the view's camera uniform
+     * @param {*} options.stbn the 2-channel spatio-temporal blue noise, `STATIC_GRAPHICS_ENGINE_ASSETS.stbn_vec2`
+     * @param {ArrayLike<number>} options.resolution the frame's pixels, x and y
+     */
+    set({ depth, normal, camera, stbn, resolution }) {
+        assert.isNonNegativeInteger(depth, 'depth');
+        assert.isNonNegativeInteger(normal, 'normal');
+        assert.defined(camera, 'camera');
+        assert.defined(stbn, 'stbn');
+        assert.isPositiveInteger(resolution[0], 'resolution[0]');
+        assert.isPositiveInteger(resolution[1], 'resolution[1]');
+
+        this.#depth = depth;
+        this.#normal = normal;
+        this.#camera = camera;
+        this.#stbn = stbn;
+
+        const tiles_x = Math.ceil(resolution[0] / PROBE_WANT_TILE);
+        const tiles_y = Math.ceil(resolution[1] / PROBE_WANT_TILE);
+
+        this.#groups[0] = Math.ceil(tiles_x / PROBE_WANT_WORKGROUP_TILES);
+        this.#groups[1] = Math.ceil(tiles_y / PROBE_WANT_WORKGROUP_TILES);
+        this.#tiles = tiles_x * tiles_y;
+    }
+
+    /**
+     * @returns {number} the most points a frame's wants list: a pixel of each tile, the eight points of a cage in
+     *   each of two cascades
+     */
+    wanted_bound() {
+        return 16 * this.#tiles;
+    }
+
+    /**
+     * Declare what the wants read on the lifetime's pass.
+     *
+     * @param {import("../../../../../engine/graphics/render/frame_graph/FramePassBuilder.js").FramePassBuilder} pass
+     * @param {Object} data the pass's data, which {@link encode} is given back
+     */
+    graph_declare(pass, data) {
+        assert.isNonNegativeInteger(this.#depth, 'depth: set() first');
+
+        data.want_depth = pass.read(this.#depth);
+        data.want_normal = pass.read(this.#normal);
+    }
+
+    /**
+     * @param {GPUCommandEncoder} encoder
+     * @param {Object} data the lifetime pass's data
+     * @param {*} resources the frame graph's resources
+     * @param {Object} clipmap what the wanting clipmap binds: `probe_levels`, `probe_wanted`,
+     *   `probe_wanted_bits` and its want settings as `settings`
+     */
+    encode(encoder, data, resources, clipmap) {
+        const b = Object.assign(this.#bindings, clipmap);
+
+        b.gBufferDepth = resources.get(data.want_depth);
+        b.gBufferNormals = resources.get(data.want_normal);
+        b.camera = this.#camera;
+        b.tSTBN_vec2 = this.#stbn;
+
+        shader_probe_clipmap_want.dispatch({
+            encoder,
+            group_count_x: this.#groups[0],
+            group_count_y: this.#groups[1],
+            bindings: b,
+        });
+    }
+}