custom-pixi-particles 4.40.1 → 4.41.0

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

@@ -1,47 +1,54 @@
 import Behaviour from './Behaviour';
 import Particle from '../Particle';
 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.
+ *
+ * Gradual color mode is designed to run after ColorBehaviour (lower priority):
+ * ColorBehaviour sets the natural particle color first, then this behaviour
+ * blends zone tint on top and eases back to the live natural color on exit.
  */
 export default class TemperatureBehaviour extends Behaviour {
     enabled: boolean;
     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;
     init(particle: Particle): void;
-    /**
-     * 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.
-     */
+    apply(particle: Particle, deltaTime?: number): void;
+    private applyGradualOutsideColor;
+    private clearGradualColorState;
+    private findActiveZone;
+    private zoneColor;
+    private copyColor;
+    private writeColor;
+    private mixColors;
+    private stepBlendToward;
+    private getBlendT;
+    private lerp;
+    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,211 @@ import behaviourNames from './BehaviourNames';
 /**
  * TemperatureBehaviour adjusts particle velocity and color
  * based on whether they are in a hot or cold zone.
+ *
+ * Gradual color mode is designed to run after ColorBehaviour (lower priority):
+ * ColorBehaviour sets the natural particle color first, then this behaviour
+ * blends zone tint on top and eases back to the live natural color on exit.
  */
 export default class TemperatureBehaviour extends Behaviour {
     constructor() {
         super(...arguments);
         this.enabled = true;
-        this.priority = 150;
+        this.priority = 50;
         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;
     }
-    /**
-     * 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;
     }
-    /**
-     * Applies temperature-based adjustments to the particle's velocity and color.
-     */
-    apply(particle) {
+    apply(particle, deltaTime = 1 / 60) {
+        var _a, _b, _c;
         if (!this.enabled || !this.zones || !this.zones.length)
             return;
-        // Check if the particle is in any hot zone
+        const p = particle;
+        const activeZone = this.findActiveZone(particle);
+        const naturalColor = this.copyColor(particle);
+        const wasInZone = p._temperatureInZone === true;
+        if (!activeZone) {
+            if (this.gradualColorTransition) {
+                if (wasInZone) {
+                    p._temperatureTransitioningOut = true;
+                }
+                this.applyGradualOutsideColor(particle, p, naturalColor, deltaTime);
+            }
+            else if (wasInZone && p._temperatureOutsideColor && this.matchesAnyZoneColor(particle)) {
+                this.writeColor(particle, p._temperatureOutsideColor);
+            }
+            else if (!wasInZone) {
+                p._temperatureOutsideColor = naturalColor;
+            }
+            p._temperatureInZone = false;
+            if (!this.gradualColorTransition) {
+                this.clearGradualColorState(particle, p);
+            }
+            return;
+        }
+        if (this.gradualColorTransition) {
+            p._temperatureTransitioningOut = false;
+            if (!wasInZone || !p._temperatureOutsideColor) {
+                p._temperatureOutsideColor = naturalColor;
+            }
+            if (!wasInZone && ((_a = p._temperatureBlend) !== null && _a !== void 0 ? _a : 0) <= 0) {
+                p._temperatureBlend = 0;
+            }
+        }
+        else if (!wasInZone) {
+            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((_b = p._temperatureBlend) !== null && _b !== void 0 ? _b : 0, 1, deltaTime);
+            p._temperatureBlend = blend;
+            const outside = (_c = p._temperatureOutsideColor) !== null && _c !== void 0 ? _c : naturalColor;
+            this.writeColor(particle, this.mixColors(outside, zoneColor, blend));
+        }
+        else {
+            this.writeColor(particle, zoneColor);
+            p._temperatureBlend = 1;
+        }
+        p._temperatureInZone = true;
+    }
+    applyGradualOutsideColor(particle, p, naturalColor, deltaTime) {
+        var _a, _b, _c, _d;
+        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)) {
+            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;
+            return;
+        }
+        const outside = transitioningOut
+            ? naturalColor
+            : ((_c = p._temperatureOutsideColor) !== null && _c !== void 0 ? _c : naturalColor);
+        const zone = (_d = p._temperatureLastZoneColor) !== null && _d !== void 0 ? _d : outside;
+        this.writeColor(particle, this.mixColors(outside, zone, blend));
+        if (blend <= 0.001) {
+            p._temperatureBlend = 0;
+            p._temperatureTransitioningOut = false;
+            p._temperatureLastZoneColor = null;
+        }
+    }
+    clearGradualColorState(particle, p) {
+        p._temperatureBlend = 0;
+        p._temperatureLastZoneColor = null;
+    }
+    findActiveZone(particle) {
         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;
+            if (this.isInZone(particle, zone)) {
+                return zone;
             }
         }
+        return null;
     }
-    /**
-     * Checks if a particle is within a specified zone.
-     */
-    isInZone(particle, center, radius) {
-        const dx = particle.movement.x - center.x;
-        const dy = particle.movement.y - center.y;
+    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;
+    }
+    matchesAnyZoneColor(particle) {
+        return this.matchesAnyZoneColorValue(this.copyColor(particle));
+    }
+    matchesAnyZoneColorValue(color) {
+        for (const zone of this.zones) {
+            const zoneColor = this.zoneColor(zone);
+            if (color.r === zoneColor.r && color.g === zoneColor.g && color.b === zoneColor.b) {
+                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

@@ -3,10 +3,12 @@ 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).
+ * Uses sprite bounds when available; falls back to particle size. 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.
  */
 export default class ToroidalWrapBehaviour extends Behaviour {
     enabled: boolean;

package/dist/lib/behaviour/ToroidalWrapBehaviour.js

@@ -1,10 +1,13 @@
 import Behaviour from './Behaviour';
 import BehaviourNames from './BehaviourNames';
+import { getToroidalEdgeExtents, wrapToroidalAxis } from '../util/toroidalWrapExtents';
 /**
- * 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).
+ * Uses sprite bounds when available; falls back to particle size. 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.
  */
 export default class ToroidalWrapBehaviour extends Behaviour {
     constructor() {
@@ -36,35 +39,20 @@ export default class ToroidalWrapBehaviour extends Behaviour {
             const maxX = base.maxX - this.inset;
             const minY = base.minY + this.inset;
             const maxY = base.maxY - this.inset;
+            const extents = getToroidalEdgeExtents(particle);
             let x = particle.x;
             let y = particle.y;
             let mx = particle.movement.x;
             let my = particle.movement.y;
-            if (this.wrapX) {
-                const w = maxX - minX;
-                if (w > 0) {
-                    while (x < minX) {
-                        x += w;
-                        mx += w;
-                    }
-                    while (x > maxX) {
-                        x -= w;
-                        mx -= w;
-                    }
-                }
+            if (this.wrapX && maxX > minX) {
+                const wrapped = wrapToroidalAxis(x, mx, minX, maxX, extents.left, extents.right, particle.velocity.x);
+                x = wrapped.position;
+                mx = wrapped.movement;
             }
-            if (this.wrapY) {
-                const h = maxY - minY;
-                if (h > 0) {
-                    while (y < minY) {
-                        y += h;
-                        my += h;
-                    }
-                    while (y > maxY) {
-                        y -= h;
-                        my -= h;
-                    }
-                }
+            if (this.wrapY && maxY > minY) {
+                const wrapped = wrapToroidalAxis(y, my, minY, maxY, extents.top, extents.bottom, particle.velocity.y);
+                y = wrapped.position;
+                my = wrapped.movement;
             }
             particle.x = x;
             particle.y = y;

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

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

package/dist/lib/util/toroidalWrapExtents.d.ts

@@ -0,0 +1,22 @@
+import type Particle from '../Particle';
+export type ToroidalEdgeExtents = {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+};
+/**
+ * Axis-aligned edge offsets from particle center to sprite bounds.
+ * Falls back to scaled size when no sprite/texture is available yet.
+ */
+export declare function getToroidalEdgeExtents(particle: Particle): ToroidalEdgeExtents;
+export type ToroidalAxisWrapResult = {
+    position: number;
+    movement: number;
+};
+/**
+ * Wraps one axis only after the particle is fully outside the bounds,
+ * placing it fully outside on the opposite side to avoid visible jumps.
+ * Velocity sign prevents re-wrapping when the particle is entering from off-screen.
+ */
+export declare function wrapToroidalAxis(position: number, movement: number, min: number, max: number, leadingExtent: number, trailingExtent: number, axisVelocity: number): ToroidalAxisWrapResult;

package/dist/lib/util/toroidalWrapExtents.js

@@ -0,0 +1,55 @@
+/**
+ * Axis-aligned edge offsets from particle center to sprite bounds.
+ * Falls back to scaled size when no sprite/texture is available yet.
+ */
+export function getToroidalEdgeExtents(particle) {
+    var _a, _b, _c, _d, _e, _f;
+    const sprite = particle.sprite;
+    const texture = sprite === null || sprite === void 0 ? void 0 : sprite.texture;
+    if (sprite && texture) {
+        const scaleX = Math.abs(sprite.scale.x);
+        const scaleY = Math.abs(sprite.scale.y);
+        const width = texture.width * scaleX;
+        const height = texture.height * scaleY;
+        const anchorX = (_b = (_a = sprite.anchor) === null || _a === void 0 ? void 0 : _a.x) !== null && _b !== void 0 ? _b : 0.5;
+        const anchorY = (_d = (_c = sprite.anchor) === null || _c === void 0 ? void 0 : _c.y) !== null && _d !== void 0 ? _d : 0.5;
+        const rotation = (_f = (_e = sprite.rotation) !== null && _e !== void 0 ? _e : particle.rotation) !== null && _f !== void 0 ? _f : 0;
+        const cos = Math.abs(Math.cos(rotation));
+        const sin = Math.abs(Math.sin(rotation));
+        const halfW = (width * cos + height * sin) / 2;
+        const halfH = (width * sin + height * cos) / 2;
+        const centerOffsetX = width * (0.5 - anchorX) * cos - height * (0.5 - anchorY) * sin;
+        const centerOffsetY = width * (0.5 - anchorX) * sin + height * (0.5 - anchorY) * cos;
+        return {
+            left: halfW - centerOffsetX,
+            right: halfW + centerOffsetX,
+            top: halfH - centerOffsetY,
+            bottom: halfH + centerOffsetY,
+        };
+    }
+    const fallback = Math.max(Math.abs(particle.size.x), Math.abs(particle.size.y)) * 0.5;
+    return { left: fallback, right: fallback, top: fallback, bottom: fallback };
+}
+/**
+ * Wraps one axis only after the particle is fully outside the bounds,
+ * placing it fully outside on the opposite side to avoid visible jumps.
+ * Velocity sign prevents re-wrapping when the particle is entering from off-screen.
+ */
+export function wrapToroidalAxis(position, movement, min, max, leadingExtent, trailingExtent, axisVelocity) {
+    let pos = position;
+    let mov = movement;
+    while (pos + trailingExtent < min && axisVelocity < 0) {
+        const overflow = min - pos - trailingExtent;
+        const next = max + leadingExtent + overflow;
+        mov += next - pos;
+        pos = next;
+    }
+    while (pos - leadingExtent > max && axisVelocity > 0) {
+        const overflow = pos - leadingExtent - max;
+        const next = min - trailingExtent - overflow;
+        mov += next - pos;
+        pos = next;
+    }
+    return { position: pos, movement: mov };
+}
+//# sourceMappingURL=toroidalWrapExtents.js.map

package/dist/lib/util/toroidalWrapExtents.js.map

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

package/package.json

@@ -51,5 +51,5 @@
     "lint:fix": "tslint --fix 'src/**/*.ts'",
     "test": "vitest run"
   },
-  "version": "4.40.1"
+  "version": "4.41.0"
 }