custom-pixi-particles 8.18.1 → 8.19.1

package/dist/lib/Model.d.ts

@@ -56,6 +56,12 @@ export default class Model {
         x: number;
         y: number;
     } | null;
+    /**
+     * Incremented when the host tab becomes visible again after being hidden.
+     * Behaviours use this to resync state after a pause (avoids delta spikes / stale wrap tracking).
+     */
+    visibilityResumeGeneration: number;
+    signalVisibilityResume(): void;
     /** Sets {@link toroidalCanvasBounds} from render buffer size (centered rect). */
     setToroidalCanvasBoundsFromSize(width: number, height: number): void;
     clearToroidalCanvasBounds(): void;

package/dist/lib/Model.js

@@ -35,6 +35,14 @@ export default class Model {
          * Updated by Renderer.updatePosition when the host passes cursor/follow-mouse updates.
          */
         this.pointerWorld = null;
+        /**
+         * Incremented when the host tab becomes visible again after being hidden.
+         * Behaviours use this to resync state after a pause (avoids delta spikes / stale wrap tracking).
+         */
+        this.visibilityResumeGeneration = 0;
+    }
+    signalVisibilityResume() {
+        this.visibilityResumeGeneration += 1;
     }
     /** Sets {@link toroidalCanvasBounds} from render buffer size (centered rect). */
     setToroidalCanvasBoundsFromSize(width, height) {

package/dist/lib/Model.js.map

@@ -1 +1 @@
-{"version":3,"file":"Model.js","sourceRoot":"","sources":["../../src/lib/Model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Model.js","sourceRoot":"","sources":["../../src/lib/Model.ts"],"names":[],"mappings":"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"}

package/dist/lib/behaviour/TemperatureBehaviour.d.ts

@@ -1,47 +1,68 @@
 import Behaviour from './Behaviour';
 import Particle from '../Particle';
+import type Model from '../Model';
 import { Color, Point } from '../util';
+export type TemperatureZoneShapeType = 'circle' | 'square' | 'rectangle';
+export type TemperatureZone = {
+    center: Point;
+    velocity: Point;
+    color: Color;
+    shapeType?: TemperatureZoneShapeType;
+    radius?: number;
+    halfSize?: number;
+    halfWidth?: number;
+    halfHeight?: number;
+};
 /**
  * TemperatureBehaviour adjusts particle velocity and color
  * based on whether they are in a hot or cold zone.
+ *
+ * Runs after ColorBehaviour and ToroidalWrapBehaviour (lower priority):
+ * base color and final position are known before zone tinting is applied.
  */
 export default class TemperatureBehaviour extends Behaviour {
     enabled: boolean;
+    /** Below ToroidalWrapBehaviour (45) so zone checks use post-wrap positions. */
     priority: number;
-    zones: {
-        center: Point;
-        radius: number;
-        velocity: Point;
-        color: Color;
-    }[];
-    /**
-     * Initializes the particle. This behavior does not require
-     * per-particle initialization, but it's included for extensibility.
-     */
+    zones: TemperatureZone[];
+    /** When true, particle color eases toward zone / outside colors instead of snapping. */
+    gradualColorTransition: boolean;
+    /** Blend speed toward the target color (higher = faster). */
+    colorTransitionSpeed: number;
+    private _reconciledVisibilityResumeGeneration;
     init(particle: Particle): void;
+    apply(particle: Particle, deltaTime?: number, model?: Model): void;
+    onParticlesUpdated(model?: Model): void;
+    private applyGradualOutsideColor;
+    private getOutsideTarget;
+    private getRestoreOutsideColor;
     /**
-     * Applies temperature-based adjustments to the particle's velocity and color.
-     */
-    apply(particle: Particle): void;
-    /**
-     * Checks if a particle is within a specified zone.
-     */
-    isInZone(particle: Particle, center: Point, radius: number): boolean;
-    /**
-     * Returns the name of the behavior.
+     * True when the particle is outside all zones but still carries zone tint
+     * (state desync, toroidal wrap, or mid-blend).
      */
+    private shouldInstantRestore;
+    private hasResidualZoneTint;
+    private syncColorSkip;
+    private clearGradualColorState;
+    private findActiveZone;
+    private zoneColor;
+    private copyColor;
+    private writeColor;
+    private mixColors;
+    private stepBlendToward;
+    private getBlendT;
+    private lerp;
+    private colorsNear;
+    private colorDistSq;
+    private matchesAnyZoneColor;
+    private matchesAnyZoneColorValue;
+    isInZone(particle: Particle, zone: TemperatureZone): boolean;
     getName(): string;
-    /**
-     * Returns properties for serialization or debugging.
-     */
     getProps(): {
         enabled: boolean;
         priority: number;
-        zones: {
-            center: Point;
-            radius: number;
-            velocity: Point;
-            color: Color;
-        }[];
+        zones: TemperatureZone[];
+        gradualColorTransition: boolean;
+        colorTransitionSpeed: number;
     };
 }

package/dist/lib/behaviour/TemperatureBehaviour.js

@@ -3,61 +3,335 @@ import behaviourNames from './BehaviourNames';
 /**
  * TemperatureBehaviour adjusts particle velocity and color
  * based on whether they are in a hot or cold zone.
+ *
+ * Runs after ColorBehaviour and ToroidalWrapBehaviour (lower priority):
+ * base color and final position are known before zone tinting is applied.
  */
 export default class TemperatureBehaviour extends Behaviour {
     constructor() {
         super(...arguments);
         this.enabled = true;
-        this.priority = 150;
+        /** Below ToroidalWrapBehaviour (45) so zone checks use post-wrap positions. */
+        this.priority = 40;
         this.zones = [];
+        /** When true, particle color eases toward zone / outside colors instead of snapping. */
+        this.gradualColorTransition = false;
+        /** Blend speed toward the target color (higher = faster). */
+        this.colorTransitionSpeed = 6;
+        this._reconciledVisibilityResumeGeneration = -1;
     }
-    /**
-     * Initializes the particle. This behavior does not require
-     * per-particle initialization, but it's included for extensibility.
-     */
     init(particle) {
-        // Optionally, initialize particle-specific data here
+        const p = particle;
+        p._temperatureInZone = false;
+        p._temperatureTransitioningOut = false;
+        p._temperatureBlend = 0;
+        p._temperatureOutsideColor = null;
+        p._temperatureLastZoneColor = null;
+        p._toroidalJustWrapped = false;
+        particle.skipColorBehaviour = false;
     }
-    /**
-     * Applies temperature-based adjustments to the particle's velocity and color.
-     */
-    apply(particle) {
+    apply(particle, deltaTime = 1 / 60, model) {
+        var _a, _b, _c, _d;
         if (!this.enabled || !this.zones || !this.zones.length)
             return;
-        // Check if the particle is in any hot zone
-        for (const zone of this.zones) {
-            if (this.isInZone(particle, zone.center, zone.radius)) {
-                particle.velocity.x *= zone.velocity.x;
-                particle.velocity.y *= zone.velocity.y;
-                particle.color.r = zone.color.r;
-                particle.color.g = zone.color.g;
-                particle.color.b = zone.color.b;
-                break;
+        const p = particle;
+        const justWrapped = p._toroidalJustWrapped === true;
+        if (justWrapped) {
+            p._toroidalJustWrapped = false;
+        }
+        const activeZone = this.findActiveZone(particle);
+        const naturalColor = this.copyColor(particle);
+        const wasInZone = p._temperatureInZone === true;
+        const visibilityResume = ((_a = model === null || model === void 0 ? void 0 : model.visibilityResumeGeneration) !== null && _a !== void 0 ? _a : 0) > this._reconciledVisibilityResumeGeneration;
+        let residualTint = !activeZone && this.hasResidualZoneTint(particle, p, wasInZone, justWrapped);
+        if (!activeZone &&
+            visibilityResume &&
+            (wasInZone || this.matchesAnyZoneColorValue(naturalColor, 12))) {
+            residualTint = true;
+        }
+        if (!activeZone) {
+            if (this.gradualColorTransition) {
+                if (residualTint) {
+                    p._temperatureTransitioningOut = true;
+                }
+                this.applyGradualOutsideColor(particle, p, naturalColor, deltaTime);
+            }
+            else if (residualTint) {
+                const restoreColor = this.getRestoreOutsideColor(p, naturalColor);
+                if (restoreColor &&
+                    (justWrapped && wasInZone || this.shouldInstantRestore(particle, naturalColor))) {
+                    this.writeColor(particle, restoreColor);
+                }
+            }
+            else if (!wasInZone && !residualTint && !this.matchesAnyZoneColorValue(naturalColor)) {
+                p._temperatureOutsideColor = naturalColor;
             }
+            p._temperatureInZone = false;
+            this.syncColorSkip(particle, p, false);
+            if (!this.gradualColorTransition) {
+                this.clearGradualColorState(particle, p);
+            }
+            return;
+        }
+        if (this.gradualColorTransition) {
+            p._temperatureTransitioningOut = false;
+            if (!wasInZone) {
+                p._temperatureOutsideColor = naturalColor;
+                if (((_b = p._temperatureBlend) !== null && _b !== void 0 ? _b : 0) <= 0) {
+                    p._temperatureBlend = 0;
+                }
+            }
+            else if (!p._temperatureOutsideColor) {
+                p._temperatureOutsideColor = naturalColor;
+            }
+        }
+        else if (!wasInZone) {
+            p._temperatureOutsideColor = naturalColor;
+        }
+        else if (justWrapped && !this.matchesAnyZoneColorValue(naturalColor, 12)) {
+            // Wrapped into a zone from a non-tinted color — refresh outside reference.
+            p._temperatureOutsideColor = naturalColor;
+        }
+        particle.velocity.x *= activeZone.velocity.x;
+        particle.velocity.y *= activeZone.velocity.y;
+        const zoneColor = this.zoneColor(activeZone);
+        p._temperatureLastZoneColor = zoneColor;
+        if (this.gradualColorTransition) {
+            const blend = this.stepBlendToward((_c = p._temperatureBlend) !== null && _c !== void 0 ? _c : 0, 1, deltaTime);
+            p._temperatureBlend = blend;
+            const outside = (_d = p._temperatureOutsideColor) !== null && _d !== void 0 ? _d : naturalColor;
+            this.writeColor(particle, this.mixColors(outside, zoneColor, blend));
         }
+        else {
+            this.writeColor(particle, zoneColor);
+        }
+        p._temperatureInZone = true;
+        this.syncColorSkip(particle, p, true);
+    }
+    onParticlesUpdated(model) {
+        var _a;
+        const resumeGeneration = (_a = model === null || model === void 0 ? void 0 : model.visibilityResumeGeneration) !== null && _a !== void 0 ? _a : 0;
+        if (resumeGeneration > this._reconciledVisibilityResumeGeneration) {
+            this._reconciledVisibilityResumeGeneration = resumeGeneration;
+        }
+    }
+    applyGradualOutsideColor(particle, p, naturalColor, deltaTime) {
+        var _a, _b, _c;
+        const transitioningOut = p._temperatureTransitioningOut === true;
+        const startBlend = transitioningOut ? ((_a = p._temperatureBlend) !== null && _a !== void 0 ? _a : 1) : ((_b = p._temperatureBlend) !== null && _b !== void 0 ? _b : 0);
+        if (!transitioningOut &&
+            !this.matchesAnyZoneColorValue(naturalColor) &&
+            !this.hasResidualZoneTint(particle, p, false, false)) {
+            p._temperatureOutsideColor = naturalColor;
+        }
+        const blend = this.stepBlendToward(startBlend, 0, deltaTime);
+        p._temperatureBlend = blend;
+        if (!transitioningOut && blend <= 0.001) {
+            p._temperatureBlend = 0;
+            p._temperatureTransitioningOut = false;
+            p._temperatureLastZoneColor = null;
+            this.syncColorSkip(particle, p, false);
+            return;
+        }
+        const outside = this.getOutsideTarget(p, naturalColor);
+        const zone = (_c = p._temperatureLastZoneColor) !== null && _c !== void 0 ? _c : outside;
+        this.writeColor(particle, this.mixColors(outside, zone, blend));
+        if (blend <= 0.001) {
+            p._temperatureBlend = 0;
+            p._temperatureTransitioningOut = false;
+            p._temperatureLastZoneColor = null;
+            this.syncColorSkip(particle, p, false);
+            return;
+        }
+        this.syncColorSkip(particle, p, false);
+    }
+    getOutsideTarget(p, naturalColor) {
+        var _a, _b;
+        if (p._temperatureTransitioningOut === true) {
+            return (_a = this.getRestoreOutsideColor(p, naturalColor)) !== null && _a !== void 0 ? _a : naturalColor;
+        }
+        return (_b = p._temperatureOutsideColor) !== null && _b !== void 0 ? _b : naturalColor;
+    }
+    getRestoreOutsideColor(p, naturalColor) {
+        const outside = p._temperatureOutsideColor;
+        if (!outside)
+            return null;
+        if (!this.matchesAnyZoneColorValue(outside, 12))
+            return outside;
+        // Outside reference was corrupted (e.g. saved while zone-tinted after a wrap).
+        if (!this.matchesAnyZoneColorValue(naturalColor, 12))
+            return naturalColor;
+        return null;
     }
     /**
-     * Checks if a particle is within a specified zone.
+     * True when the particle is outside all zones but still carries zone tint
+     * (state desync, toroidal wrap, or mid-blend).
      */
-    isInZone(particle, center, radius) {
-        const dx = particle.movement.x - center.x;
-        const dy = particle.movement.y - center.y;
+    shouldInstantRestore(particle, naturalColor) {
+        if (this.matchesAnyZoneColorValue(naturalColor, 12))
+            return true;
+        const p = particle;
+        const outside = p._temperatureOutsideColor;
+        const zone = p._temperatureLastZoneColor;
+        if (!outside || !zone)
+            return false;
+        if (this.colorsNear(naturalColor, outside))
+            return false;
+        if (this.colorsNear(naturalColor, zone, 12))
+            return true;
+        const distToZone = this.colorDistSq(naturalColor, zone);
+        const distToOutside = this.colorDistSq(naturalColor, outside);
+        return distToZone < distToOutside * 0.35 && distToZone <= 3600;
+    }
+    hasResidualZoneTint(particle, p, wasInZone, justWrapped) {
+        var _a;
+        if (justWrapped)
+            return true;
+        if (p._temperatureTransitioningOut === true)
+            return true;
+        if (this.gradualColorTransition && ((_a = p._temperatureBlend) !== null && _a !== void 0 ? _a : 0) > 0.001)
+            return true;
+        if (this.matchesAnyZoneColorValue(this.copyColor(particle), 12))
+            return true;
+        const outside = p._temperatureOutsideColor;
+        const zone = p._temperatureLastZoneColor;
+        if (!outside || !zone) {
+            return wasInZone && this.matchesAnyZoneColorValue(this.copyColor(particle), 12);
+        }
+        const current = this.copyColor(particle);
+        if (this.colorsNear(current, outside))
+            return false;
+        if (this.colorsNear(current, zone, 12))
+            return true;
+        const distToZone = this.colorDistSq(current, zone);
+        const distToOutside = this.colorDistSq(current, outside);
+        return distToZone < distToOutside * 0.35 && distToZone <= 3600;
+    }
+    syncColorSkip(particle, p, inZone) {
+        var _a;
+        if (!this.gradualColorTransition) {
+            particle.skipColorBehaviour = inZone;
+            return;
+        }
+        const blend = (_a = p._temperatureBlend) !== null && _a !== void 0 ? _a : 0;
+        particle.skipColorBehaviour =
+            inZone || p._temperatureTransitioningOut === true || blend > 0.001;
+    }
+    clearGradualColorState(particle, p) {
+        p._temperatureBlend = 0;
+        if (!this.hasResidualZoneTint(particle, p, false, false)) {
+            p._temperatureLastZoneColor = null;
+        }
+    }
+    findActiveZone(particle) {
+        for (const zone of this.zones) {
+            if (this.isInZone(particle, zone)) {
+                return zone;
+            }
+        }
+        return null;
+    }
+    zoneColor(zone) {
+        var _a;
+        return {
+            r: zone.color.r,
+            g: zone.color.g,
+            b: zone.color.b,
+            alpha: (_a = zone.color.alpha) !== null && _a !== void 0 ? _a : 1,
+        };
+    }
+    copyColor(particle) {
+        return {
+            r: particle.color.r,
+            g: particle.color.g,
+            b: particle.color.b,
+            alpha: particle.color.alpha,
+        };
+    }
+    writeColor(particle, color) {
+        particle.color.r = color.r;
+        particle.color.g = color.g;
+        particle.color.b = color.b;
+        particle.color.alpha = color.alpha;
+    }
+    mixColors(from, to, blend) {
+        const t = Math.max(0, Math.min(1, blend));
+        return {
+            r: this.lerp(from.r, to.r, t),
+            g: this.lerp(from.g, to.g, t),
+            b: this.lerp(from.b, to.b, t),
+            alpha: this.lerp(from.alpha, to.alpha, t),
+        };
+    }
+    stepBlendToward(current, target, deltaTime) {
+        const t = this.getBlendT(deltaTime);
+        const next = current + (target - current) * t;
+        if (target > current)
+            return Math.min(target, next);
+        return Math.max(target, next);
+    }
+    getBlendT(deltaTime) {
+        const speed = Math.max(0, this.colorTransitionSpeed);
+        if (speed <= 0)
+            return 0;
+        const dtSeconds = deltaTime >= 1 ? deltaTime / 60 : deltaTime;
+        return 1 - Math.exp(-speed * dtSeconds);
+    }
+    lerp(start, end, t) {
+        return start + (end - start) * t;
+    }
+    colorsNear(a, b, tolerance = 2) {
+        return (Math.abs(a.r - b.r) <= tolerance &&
+            Math.abs(a.g - b.g) <= tolerance &&
+            Math.abs(a.b - b.b) <= tolerance &&
+            Math.abs(a.alpha - b.alpha) <= 0.02);
+    }
+    colorDistSq(a, b) {
+        const dr = a.r - b.r;
+        const dg = a.g - b.g;
+        const db = a.b - b.b;
+        const da = (a.alpha - b.alpha) * 255;
+        return dr * dr + dg * dg + db * db + da * da;
+    }
+    matchesAnyZoneColor(particle, tolerance = 2) {
+        return this.matchesAnyZoneColorValue(this.copyColor(particle), tolerance);
+    }
+    matchesAnyZoneColorValue(color, tolerance = 2) {
+        for (const zone of this.zones) {
+            const zoneColor = this.zoneColor(zone);
+            if (this.colorsNear(color, zoneColor, tolerance)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    isInZone(particle, zone) {
+        var _a, _b, _c, _d, _e;
+        const dx = particle.movement.x - zone.center.x;
+        const dy = particle.movement.y - zone.center.y;
+        const shapeType = (_a = zone.shapeType) !== null && _a !== void 0 ? _a : 'circle';
+        if (shapeType === 'square') {
+            const halfSize = (_b = zone.halfSize) !== null && _b !== void 0 ? _b : 0;
+            return Math.abs(dx) < halfSize && Math.abs(dy) < halfSize;
+        }
+        if (shapeType === 'rectangle') {
+            const halfWidth = (_c = zone.halfWidth) !== null && _c !== void 0 ? _c : 0;
+            const halfHeight = (_d = zone.halfHeight) !== null && _d !== void 0 ? _d : 0;
+            return Math.abs(dx) < halfWidth && Math.abs(dy) < halfHeight;
+        }
+        const radius = (_e = zone.radius) !== null && _e !== void 0 ? _e : 0;
         return Math.sqrt(dx * dx + dy * dy) < radius;
     }
-    /**
-     * Returns the name of the behavior.
-     */
     getName() {
         return behaviourNames.TEMPERATURE_BEHAVIOUR;
     }
-    /**
-     * Returns properties for serialization or debugging.
-     */
     getProps() {
         return {
             enabled: this.enabled,
             priority: this.priority,
             zones: this.zones,
+            gradualColorTransition: this.gradualColorTransition,
+            colorTransitionSpeed: this.colorTransitionSpeed,
         };
     }
 }

package/dist/lib/behaviour/TemperatureBehaviour.js.map

@@ -1 +1 @@
-{"version":3,"file":"TemperatureBehaviour.js","sourceRoot":"","sources":["../../../src/lib/behaviour/TemperatureBehaviour.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,aAAa,CAAA;AAGnC,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAE7C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,SAAS;IAA3D;;QACE,YAAO,GAAG,IAAI,CAAA;QACd,aAAQ,GAAG,GAAG,CAAA;QAEd,UAAK,GAAuE,EAAE,CAAA;IAuDhF,CAAC;IArDC;;;OAGG;IACH,IAAI,CAAC,QAAkB;QACrB,qDAAqD;IACvD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAkB;QACtB,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAM;QAE9D,2CAA2C;QAC3C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtD,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;gBACtC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;gBACtC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;gBAC/B,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;gBAC/B,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;gBAC/B,MAAK;YACP,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,QAAkB,EAAE,MAAa,EAAE,MAAc;QACxD,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAA;QACzC,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAA;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAA;IAC9C,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,cAAc,CAAC,qBAAqB,CAAA;IAC7C,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"TemperatureBehaviour.js","sourceRoot":"","sources":["../../../src/lib/behaviour/TemperatureBehaviour.ts"],"names":[],"mappings":"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"}

package/dist/lib/behaviour/ToroidalWrapBehaviour.d.ts

@@ -1,30 +1,27 @@
 import Behaviour from './Behaviour';
 import Particle from '../Particle';
 import type Model from '../Model';
-import type TurbulencePool from '../util/turbulencePool';
 /**
- * Toroidal screen/world wrap: particles that leave an axis-aligned rectangle
- * re-enter on the opposite side. Runs after {@link PositionBehaviour} (lower priority).
- * Syncs {@link Particle.movement} with wrapped {@link Particle.x}/{@link Particle.y}
- * (same pattern as {@link BounceBehaviour}). Do not combine with bounce on the same axis.
+ * Toroidal screen/world wrap: particles that fully leave an axis-aligned rectangle
+ * re-enter on the opposite side while still fully outside the view (no visible jump).
+ * Renderers hide sprites that do not overlap the viewport so teleports are never seen.
  */
 export default class ToroidalWrapBehaviour extends Behaviour {
     enabled: boolean;
     priority: number;
     wrapX: boolean;
     wrapY: boolean;
-    /**
-     * When true, bounds come from {@link Model.toroidalCanvasBounds} (set each frame from
-     * `canvasSizeProvider` / renderer size). Manual min/max are ignored until turned off.
-     */
     useCanvasBounds: boolean;
     minX: number;
     maxX: number;
     minY: number;
     maxY: number;
-    /** Shrinks the effective wrap rect inward (helps large sprites). */
     inset: number;
-    init: (_particle: Particle, _model: Model, _turbulencePool: TurbulencePool) => void;
+    private _insideX;
+    private _insideY;
+    private _handledVisibilityResumeGeneration;
+    init: (particle: Particle, _model: Model, _turbulencePool: unknown) => void;
+    onParticleRemoved: (particle: Particle) => void;
     apply: (particle: Particle, _deltaTime: number, model: Model) => void;
     getName(): string;
     getProps(): {