babylonjs-toolkit 9.12.101 → 9.12.1101

package/lib/index.d.ts

@@ -7,7 +7,7 @@ declare namespace TOOLKIT {
     * @class SceneManager - All rights reserved (c) 2024 Mackey Kinard
     */
     class SceneManager {
-        /** Gets the toolkit framework version string (9.12.101 - R1) */
+        /** Gets the toolkit framework version string (9.12.1101 - R1) */
         static get Version(): string;
         /** Gets the toolkit framework copyright notice */
         static get Copyright(): string;
@@ -1983,6 +1983,29 @@ declare namespace TOOLKIT {
          * (suppressed diffuse), preserving the previous Unity behavior.
          */
         static ApplyGlobalReflectionProbeDiffuse(texture: BABYLON.BaseTexture, scene: BABYLON.Scene, createPolynomialsFromFaces?: boolean): void;
+        /** Tracks whether the global box-projection reflection shader fix has been installed (install-once). */
+        private static _boxProjectionShaderPatched;
+        /**
+         * Installs a Unity-faithful per-pixel containment test into Babylon's shared `parallaxCorrectNormal`
+         * box-projection helper (patches both the GLSL and WGSL copies of the `helperFunctions` shader include).
+         *
+         * Babylon applies box (local cubemap) projection to EVERY pixel of a material that has a reflection
+         * bounding box, with no skybox fallback. Surfaces that sit OUTSIDE the probe box - e.g. a tall building
+         * reflecting a ground-level racetrack probe - therefore hit the slab-intersection math in its invalid
+         * regime (exit distance <= 0) and sample the dark box floor, turning glossy/metallic surfaces black.
+         *
+         * Unity instead evaluates probe contribution per-pixel: "When a pixel of an object is outside of any
+         * reflection probe volume, Unity uses the skybox reflection." This injects exactly that rule - if the
+         * shaded world position is outside the probe box on any axis, return the un-projected (infinite)
+         * reflection vector so the pixel reflects the environment (the probe's sky hemisphere) instead of the
+         * dark face. Pixels INSIDE the box are byte-for-byte unchanged, so ground reflections keep their
+         * parallax correction.
+         *
+         * The patch is install-once, idempotent (sentinel guarded) and FAIL-SAFE: if a future Babylon release
+         * renames or reformats the helper so the anchor is not found, it logs a warning and leaves the stock
+         * shader untouched (reverting to Babylon's default behavior) rather than emitting a broken shader.
+         * See README.md ("Box-Projected Reflection Shader Patch") for the full rationale.
+         */
         /** Defines whether this extension is enabled. */
         enabled: boolean;
         private _webgpu;
@@ -8564,6 +8587,7 @@ declare namespace TOOLKIT {
     class NavigationAgent extends TOOLKIT.ScriptComponent {
         static TARGET_ANGLE_FACTOR: number;
         static ANGULAR_SPEED_RATIO: number;
+        static BRAKING_CUSHION_FACTOR: number;
         static GLOBAL_CROWD_INSTANCE: boolean;
         private crowd;
         private type;
@@ -8592,6 +8616,7 @@ declare namespace TOOLKIT {
         private m_reachObserver;
         private m_navMeshDestroyObserver;
         speed: number;
+        reachRadius: number;
         heightOffset: number;
         angularSpeed: number;
         updatePosition: boolean;
@@ -8600,8 +8625,10 @@ declare namespace TOOLKIT {
         velocityEpsilon: number;
         offMeshVelocity: number;
         stoppingDistance: number;
-        reachRadius: number;
+        minLookAtDistance: number;
+        enableLookAtDistance: boolean;
         stuckFrameThreshold: number;
+        updateFlags: number;
         isReady(): boolean;
         isNavigating(): boolean;
         isTeleporting(): boolean;
@@ -8646,7 +8673,9 @@ declare namespace TOOLKIT {
         protected destroy(): void;
         private awakeNavigationAgent;
         private updateNavigationAgent;
+        private getLookAtStopDistance;
         private updateAgentParameters;
+        private applyAgentUpdateFlags;
         private destroyNavigationAgent;
         /** Move agent relative to current position. */
         move(offset: BABYLON.Vector3, closetPoint?: boolean): void;
@@ -8664,6 +8693,9 @@ declare namespace TOOLKIT {
         setOptimizationRange(range: number): void;
         /** Sets agent current collision query range (Defines how close a collision element must be before it is considered for steering behaviors). */
         setCollisionQueryRange(range: number): void;
+        /** Sets the Detour crowd update flags bitmask (ANTICIPATE_TURNS=1, OBSTACLE_AVOIDANCE=2,
+         *  SEPARATION=4, OPTIMIZE_VIS=8, OPTIMIZE_TOPO=16). Use 0 for a single agent to avoid doorway crawl/stall. */
+        setUpdateFlags(flags: number): void;
         /** Sets agent current radius. */
         setAgentRadius(radius: number): void;
         /** Sets agent current height. */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "babylonjs-toolkit",
-    "version": "9.12.101",
+    "version": "9.12.1101",
     "description": "Babylon Toolkit Runtime Library (UMD)",
     "author": "MackeyK24 <mackeyk24@gmail.com>",
     "main": "lib/babylon.toolkit.js",