melonjs 19.1.0 → 19.2.0

package/build/level/tiled/TMXObjectFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TMXObjectFactory.d.ts","sourceRoot":"","sources":["../../../src/level/tiled/TMXObjectFactory.js"],"names":[],"mappings":"AA4BA;;;;;;GAMG;AACH,0CAJW,MAAM,GACJ,OAAO,GAAC,MAAM,EAAE,CAY5B;AAED;;;;;;;;;;;;GAYG;AACH,2CAJW,MAAM,GACJ,MAAM,CAsBlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,iDApBW,MAAM,2BA8BhB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,+CAZW,MAAM,+BA6BhB;AAQD;;;;;;;GAOG;AACH,gDAJW,MAAM,+BAWhB;AAoCD;;;;;;;GAOG;AACH,0CALW,MAAM,OACN,UAAU,GACR,UAAU,CAqBtB"}
+{"version":3,"file":"TMXObjectFactory.d.ts","sourceRoot":"","sources":["../../../src/level/tiled/TMXObjectFactory.js"],"names":[],"mappings":"AA2BA;;;;;;GAMG;AACH,0CAJW,MAAM,GACJ,OAAO,GAAC,MAAM,EAAE,CAY5B;AAED;;;;;;;;;;;;GAYG;AACH,2CAJW,MAAM,GACJ,MAAM,CAsBlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,iDApBW,MAAM,2BAgChB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,+CAZW,MAAM,+BA6BhB;AAQD;;;;;;;GAOG;AACH,gDAJW,MAAM,+BAWhB;AAoCD;;;;;;;GAOG;AACH,0CALW,MAAM,OACN,UAAU,GACR,UAAU,CAqBtB"}

package/build/math/color_matrix.d.ts

@@ -0,0 +1,51 @@
+import { Matrix3d } from "./matrix3d.ts";
+/**
+ * A 4x4 color transformation matrix extending {@link Matrix3d}.
+ * Provides chainable methods for common color adjustments.
+ * @category Math
+ * @example
+ * // grayscale
+ * const cm = new ColorMatrix().saturate(0.0);
+ * @example
+ * // combine brightness + contrast
+ * const cm = new ColorMatrix().brightness(1.3).contrast(1.5);
+ */
+export declare class ColorMatrix extends Matrix3d {
+    /**
+     * Apply a brightness adjustment.
+     * @param amount - brightness multiplier (1.0 = normal, >1 brighter, <1 darker)
+     * @returns this instance for chaining
+     */
+    brightness(amount: number): this;
+    /**
+     * Apply a contrast adjustment.
+     * @param amount - contrast multiplier (1.0 = normal, >1 more contrast, <1 less)
+     * @returns this instance for chaining
+     */
+    contrast(amount: number): this;
+    /**
+     * Apply a saturation adjustment.
+     * @param amount - saturation level (0.0 = grayscale, 1.0 = normal, >1 over-saturated)
+     * @returns this instance for chaining
+     */
+    saturate(amount: number): this;
+    /**
+     * Apply a hue rotation.
+     * @param angle - rotation angle in radians
+     * @returns this instance for chaining
+     */
+    hueRotate(angle: number): this;
+    /**
+     * Apply a sepia tone.
+     * @param amount - sepia intensity (0.0 = original, 1.0 = full sepia)
+     * @returns this instance for chaining
+     */
+    sepia(amount?: number): this;
+    /**
+     * Apply a color inversion.
+     * @param amount - inversion amount (0.0 = original, 1.0 = fully inverted)
+     * @returns this instance for chaining
+     */
+    invertColors(amount?: number): this;
+}
+//# sourceMappingURL=color_matrix.d.ts.map

package/build/math/color_matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color_matrix.d.ts","sourceRoot":"","sources":["../../src/math/color_matrix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;;GAUG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACxC;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAqBhC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAsB9B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAwB9B;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IA0B9B;;;;OAIG;IACH,KAAK,CAAC,MAAM,GAAE,MAAY,GAAG,IAAI;IA2CjC;;;;OAIG;IACH,YAAY,CAAC,MAAM,GAAE,MAAY,GAAG,IAAI;CAqBxC"}

package/build/math/matrix2d.d.ts

@@ -44,12 +44,12 @@ export declare class Matrix2d {
     setTransform(...values: [number, number, number, number, number, number] | [number, number, number, number, number, number, number, number, number]): this;
     /**
      * Multiplies the current transformation with the matrix described by the arguments of this method.
-     * @param a a component
-     * @param b b component
-     * @param c c component
-     * @param d d component
-     * @param e e component
-     * @param f f component
+     * @param a - a component (scale x / cos)
+     * @param b - b component (skew y / sin)
+     * @param c - c component (skew x / -sin)
+     * @param d - d component (scale y / cos)
+     * @param e - e component (translate x)
+     * @param f - f component (translate y)
      * @returns Reference to this object for method chaining
      */
     transform(a: number, b: number, c: number, d: number, e: number, f: number): this;

package/build/math/matrix3d.d.ts

@@ -81,6 +81,23 @@ export declare class Matrix3d {
      * @returns Reference to this object for method chaining
      */
     multiply(m: Matrix3d | Matrix2d): this;
+    /**
+     * Multiplies the current transformation with a 2D affine matrix (a, b, c, d, e, f).
+     * The 2D matrix is promoted to 4x4 internally.
+     * @param a - a component (scale x / cos)
+     * @param b - b component (skew y / sin)
+     * @param c - c component (skew x / -sin)
+     * @param d - d component (scale y / cos)
+     * @param e - e component (translate x)
+     * @param f - f component (translate y)
+     * @returns Reference to this object for method chaining
+     */
+    transform(a: number, b: number, c: number, d: number, e: number, f: number): this;
+    /**
+     * Multiplies the current transformation with a full 4x4 matrix specified as 16 individual values (column-major).
+     * @returns Reference to this object for method chaining
+     */
+    transform(b00: number, b01: number, b02: number, b03: number, b10: number, b11: number, b12: number, b13: number, b20: number, b21: number, b22: number, b23: number, b30: number, b31: number, b32: number, b33: number): this;
     /**
      * Transpose the value of this matrix.
      * @returns Reference to this object for method chaining

package/build/math/matrix3d.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"matrix3d.d.ts","sourceRoot":"","sources":["../../src/math/matrix3d.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAG/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,KAAK,cAAc,GAAG;IACrB,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACN,CAAC;AAEF,KAAK,cAAc,GAAG,CAAC,QAAQ,CAAC,GAAG,cAAc,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;AAYrE;;;GAGG;AACH,qBAAa,QAAQ;IACpB;;OAEG;IACH,GAAG,EAAE,YAAY,CAAC;IAElB;;;OAGG;gBACS,GAAG,KAAK,EAAE,cAAc;IAKpC;;;OAGG;IACH,IAAI,EAAE,WAEL;IAED;;;OAGG;IACH,IAAI,EAAE,WAEL;IAED;;;OAGG;IACH,IAAI,EAAE,WAEL;IAED;;;;;OAKG;IACH,QAAQ;IAIR;;;;OAIG;IACH,YAAY,CAAC,GAAG,MAAM,EAAE,cAAc;IAuBtC;;;;OAIG;IACH,IAAI,CAAC,CAAC,EAAE,QAAQ;IAKhB;;;;OAIG;IACH,SAAS,CAAC,CAAC,EAAE,QAAQ;IAsBrB;;;;OAIG;IACH,QAAQ,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ;IA4F/B;;;OAGG;IACH,SAAS;IAyBT;;;OAGG;IACH,MAAM;IAiEN;;;;OAIG;IACH,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK;IAkBpC;;;;OAIG;IACH,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ;IAWnC;;;;;;;;;;OAUG;IACH,KAAK,CACJ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM;IA2BZ;;;;;;;OAOG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAyBlE;;;;;;OAMG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,SAAI,EAAE,CAAC,SAAI;IAqB7B;;;;OAIG;IACH,MAAM,CAAC,CAAC,EAAE,QAAQ;IAIlB;;;;OAIG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM;IAIhB;;;;OAIG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM;IAIhB;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,QAAQ;IA+DlC;;;;;;OAMG;IACH,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ;IACrD,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ;IA6BhD;;;OAGG;IACH,UAAU;IAwBV;;;;OAIG;IACH,MAAM,CAAC,CAAC,EAAE,QAAQ;IAwBlB;;;;OAIG;IACH,UAAU,CAAC,GAAG,CAAC,EAAE,QAAQ;IAOzB;;;OAGG;IACH,KAAK;IAIL;;;OAGG;IACH,OAAO;IAIP;;;OAGG;IACH,QAAQ;CASR;AAED,eAAO,MAAM,YAAY,4DAWxB,CAAC"}
+{"version":3,"file":"matrix3d.d.ts","sourceRoot":"","sources":["../../src/math/matrix3d.ts"],"names":[],"mappings":"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"}

package/build/particles/emitter.d.ts

@@ -1,14 +1,15 @@
 import Container from "./../renderable/container.js";
 import CanvasRenderTarget from "../video/rendertarget/canvasrendertarget.js";
+import { type ParticleEmitterSettings } from "./settings.ts";
 /**
  * Particle Emitter Object.
  * @category Particles
  */
 export default class ParticleEmitter extends Container {
     /**
-     * the current (active) emitter settings
+     * the current (active) emitter settings (with defaults merged in)
      */
-    settings: Record<string, any>;
+    settings: ParticleEmitterSettings;
     /** @ignore */
     _stream: boolean;
     /** @ignore */
@@ -23,6 +24,19 @@ export default class ParticleEmitter extends Container {
     _dt: number;
     /** @ignore */
     _defaultParticle: CanvasRenderTarget | undefined;
+    /**
+     * whether at least one particle has been spawned by this emitter — used as
+     * the precondition for completion detection (a brand-new emitter with zero
+     * children must not count as "complete")
+     * @ignore
+     */
+    _hasSpawned: boolean;
+    /**
+     * cached `timer.maxfps / 1000` — particles read this directly instead of
+     * recomputing it on every spawn.
+     * @ignore
+     */
+    _deltaInv: number;
     /**
      * @param x - x position of the particle emitter
      * @param y - y position of the particle emitter
@@ -53,12 +67,12 @@ export default class ParticleEmitter extends Container {
      * // call this in onDestroyEvent function
      * app.world.removeChild(emitter);
      */
-    constructor(x: number, y: number, settings?: Record<string, any>);
+    constructor(x: number, y: number, settings?: Partial<ParticleEmitterSettings>);
     /**
      * Reset the emitter with particle emitter settings.
-     * @param settings - [optional] object with emitter settings. See {@link ParticleEmitterSettings}
+     * @param settings - object with emitter settings. See {@link ParticleEmitterSettings}
      */
-    reset(settings?: Record<string, any>): void;
+    reset(settings?: Partial<ParticleEmitterSettings>): void;
     /**
      * returns a random point on the x axis within the bounds of this emitter
      * @returns a random x position within the emitter bounds

package/build/particles/emitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/particles/emitter.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,8BAA8B,CAAC;AACrD,OAAO,kBAAkB,MAAM,6CAA6C,CAAC;AAqB7E;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,SAAS;IACrD;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IAEjB,cAAc;IACd,eAAe,EAAE,MAAM,CAAC;IAExB,cAAc;IACd,cAAc,EAAE,MAAM,CAAC;IAEvB,cAAc;IACd,QAAQ,EAAE,OAAO,CAAC;IAElB,cAAc;IACd,YAAY,EAAE,MAAM,CAAC;IAErB,cAAc;IACd,GAAG,EAAE,MAAM,CAAC;IAEZ,cAAc;IACd,gBAAgB,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;gBACS,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IA6CpE;;;OAGG;IACM,KAAK,CAAC,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,IAAI;IAgBxD;;;OAGG;IACH,eAAe,IAAI,MAAM;IAIzB;;;OAGG;IACH,eAAe,IAAI,MAAM;IAKzB,cAAc;IACd,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQjC;;;OAGG;IACH,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACH,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;OAGG;IACH,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IASpC;;OAEG;IACM,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAqDpC;;;OAGG;IACM,OAAO,IAAI,IAAI;CAWxB"}
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/particles/emitter.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,8BAA8B,CAAC;AAErD,OAAO,kBAAkB,MAAM,6CAA6C,CAAC;AAE7E,OAA+B,EAC9B,KAAK,uBAAuB,EAC5B,MAAM,eAAe,CAAC;AAmCvB;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,SAAS;IACrD;;OAEG;IACH,QAAQ,EAAE,uBAAuB,CAAC;IAElC,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;IAEjB,cAAc;IACd,eAAe,EAAE,MAAM,CAAC;IAExB,cAAc;IACd,cAAc,EAAE,MAAM,CAAC;IAEvB,cAAc;IACd,QAAQ,EAAE,OAAO,CAAC;IAElB,cAAc;IACd,YAAY,EAAE,MAAM,CAAC;IAErB,cAAc;IACd,GAAG,EAAE,MAAM,CAAC;IAEZ,cAAc;IACd,gBAAgB,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAEjD;;;;;OAKG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;gBAEF,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,GAAE,OAAO,CAAC,uBAAuB,CAAM;IAoChD;;;OAGG;IACM,KAAK,CAAC,QAAQ,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAAG,IAAI;IAqCrE;;;OAGG;IACH,eAAe,IAAI,MAAM;IAIzB;;;OAGG;IACH,eAAe,IAAI,MAAM;IAKzB,cAAc;IACd,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAcjC;;;OAGG;IACH,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACH,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;OAGG;IACH,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IASpC;;OAEG;IACM,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAoEpC;;;OAGG;IACM,OAAO,IAAI,IAAI;CASxB"}

package/build/particles/particle.d.ts

@@ -9,7 +9,7 @@ import ParticleEmitter from "./emitter.ts";
  */
 export default class Particle extends Renderable {
     vel: Vector2d;
-    image: any;
+    image: HTMLCanvasElement | HTMLImageElement;
     life: number;
     startLife: number;
     startScale: number;
@@ -18,7 +18,10 @@ export default class Particle extends Renderable {
     wind: number;
     followTrajectory: boolean;
     onlyInViewport: boolean;
+    accurateBounds: boolean;
     _deltaInv: number;
+    _halfW: number;
+    _halfH: number;
     _angle: number;
     alive: boolean;
     /**

package/build/particles/particle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"particle.d.ts","sourceRoot":"","sources":["../../src/particles/particle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAgB,MAAM,qBAAqB,CAAC;AAG7D,OAAO,UAAU,MAAM,6BAA6B,CAAC;AAGrD,OAAO,cAAc,MAAM,oCAAoC,CAAC;AAChE,OAAO,aAAa,MAAM,kCAAkC,CAAC;AAC7D,OAAO,eAAe,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,UAAU;IAC/C,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,GAAG,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;gBACS,OAAO,EAAE,eAAe;IAapC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,WAAW,GAAE,OAAe;IAkFnE;;;;;OAKG;IACM,MAAM,CAAC,EAAE,EAAE,MAAM;IAwE1B;;OAEG;IACM,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa;CAKtD;AAED,eAAO,MAAM,YAAY,wEAWxB,CAAC"}
+{"version":3,"file":"particle.d.ts","sourceRoot":"","sources":["../../src/particles/particle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAgB,MAAM,qBAAqB,CAAC;AAG7D,OAAO,UAAU,MAAM,6BAA6B,CAAC;AAErD,OAAO,cAAc,MAAM,oCAAoC,CAAC;AAChE,OAAO,aAAa,MAAM,kCAAkC,CAAC;AAC7D,OAAO,eAAe,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,UAAU;IAC/C,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;gBACS,OAAO,EAAE,eAAe;IAiBpC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,WAAW,GAAE,OAAe;IAwFnE;;;;;OAKG;IACM,MAAM,CAAC,EAAE,EAAE,MAAM;IAuF1B;;OAEG;IACM,IAAI,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa;CAMtD;AAED,eAAO,MAAM,YAAY,wEAWxB,CAAC"}

package/build/particles/settings.d.ts

@@ -1,33 +1,202 @@
-export default ParticleEmitterSettings;
-declare namespace ParticleEmitterSettings {
-    let width: number;
-    let height: number;
-    let image: HTMLCanvasElement;
-    let textureSize: number;
-    let tint: string;
-    let totalParticles: number;
-    let angle: number;
-    let angleVariation: number;
-    let minLife: number;
-    let maxLife: number;
-    let speed: number;
-    let speedVariation: number;
-    let minRotation: number;
-    let maxRotation: number;
-    let minStartScale: number;
-    let maxStartScale: number;
-    let minEndScale: number;
-    let maxEndScale: number;
-    let gravity: number;
-    let wind: number;
-    let followTrajectory: boolean;
-    let textureAdditive: boolean;
-    let blendMode: string;
-    let onlyInViewport: boolean;
-    let floating: boolean;
-    let maxParticles: number;
-    let frequency: number;
-    let duration: number;
-    let framesToSkip: number;
+import type ParticleEmitter from "./emitter.ts";
+/**
+ * Configuration shape for {@link ParticleEmitter}.
+ * Every field has a sensible default; users typically pass a `Partial<ParticleEmitterSettings>`
+ * to the constructor or {@link ParticleEmitter#reset}.
+ * @category Particles
+ * @see {@link ParticleEmitter}
+ */
+export interface ParticleEmitterSettings {
+    /**
+     * Width of the particle spawn area.
+     * @default 1
+     */
+    width: number;
+    /**
+     * Height of the particle spawn area.
+     * @default 1
+     */
+    height: number;
+    /**
+     * Image used for particles texture (by default melonJS will create a white
+     * 8x8 texture image).
+     * @default undefined
+     * @see {@link textureSize}
+     */
+    image: HTMLCanvasElement | HTMLImageElement | undefined;
+    /**
+     * Default texture size used for particles if no image is specified
+     * (by default melonJS will create a white 8x8 texture image).
+     * @default 8
+     * @see {@link image}
+     */
+    textureSize: number;
+    /**
+     * Tint to be applied to particles.
+     * @default "#fff"
+     */
+    tint: string;
+    /**
+     * Total number of particles in the emitter.
+     * @default 50
+     */
+    totalParticles: number;
+    /**
+     * Start angle for particle launch in Radians.
+     * @default Math.PI / 2
+     */
+    angle: number;
+    /**
+     * Variation in the start angle for particle launch in Radians.
+     * @default 0
+     */
+    angleVariation: number;
+    /**
+     * Minimum time each particle lives once it is emitted in ms.
+     * If greater than `maxLife`, it is clamped to `maxLife` at reset.
+     * @default 1000
+     */
+    minLife: number;
+    /**
+     * Maximum time each particle lives once it is emitted in ms.
+     * @default 3000
+     */
+    maxLife: number;
+    /**
+     * Start speed of particles.
+     * @default 2
+     */
+    speed: number;
+    /**
+     * Variation in the start speed of particles.
+     * @default 1
+     */
+    speedVariation: number;
+    /**
+     * Minimum start rotation for particle sprites in Radians.
+     * @default 0
+     */
+    minRotation: number;
+    /**
+     * Maximum start rotation for particle sprites in Radians.
+     * @default 0
+     */
+    maxRotation: number;
+    /**
+     * Minimum start scale ratio for particles (1 = no scaling).
+     * @default 1
+     */
+    minStartScale: number;
+    /**
+     * Maximum start scale ratio for particles (1 = no scaling).
+     * @default 1
+     */
+    maxStartScale: number;
+    /**
+     * Minimum end scale ratio for particles.
+     * @default 0
+     */
+    minEndScale: number;
+    /**
+     * Maximum end scale ratio for particles.
+     * @default 0
+     */
+    maxEndScale: number;
+    /**
+     * Vertical force (Gravity) for each particle.
+     * @default 0
+     * @see {@link World.gravity}
+     */
+    gravity: number;
+    /**
+     * Horizontal force (like a Wind) for each particle.
+     * @default 0
+     */
+    wind: number;
+    /**
+     * Update the rotation of particle in accordance with the particle trajectory.
+     * The particle sprite should aim at zero angle (draw from left to right).
+     * Overrides the particle `minRotation` and `maxRotation`.
+     * @default false
+     */
+    followTrajectory: boolean;
+    /**
+     * Enable the Texture Additive by composite operation ("additive" blendMode).
+     * @default false
+     * @see {@link blendMode}
+     */
+    textureAdditive: boolean;
+    /**
+     * Blend mode applied when rendering particles. If different than "normal",
+     * supersedes the `textureAdditive` setting.
+     * @default "normal"
+     * @see {@link CanvasRenderer#setBlendMode}
+     * @see {@link WebGLRenderer#setBlendMode}
+     */
+    blendMode: string;
+    /**
+     * Update particles only in the viewport; remove when out of viewport.
+     * @default true
+     */
+    onlyInViewport: boolean;
+    /**
+     * Render particles in screen space.
+     * @default false
+     */
+    floating: boolean;
+    /**
+     * Maximum number of particles launched each tick (stream mode only).
+     * @default 10
+     */
+    maxParticles: number;
+    /**
+     * How often a particle is emitted in ms (stream mode only).
+     * @default 100
+     */
+    frequency: number;
+    /**
+     * Duration that the emitter releases particles in ms (stream mode only).
+     * After this period, the emitter stops launching particles.
+     * @default Infinity
+     */
+    duration: number;
+    /**
+     * Skip n frames after updating the particle system once.
+     * Reduces the performance impact of emitters with many particles.
+     * @default 0
+     */
+    framesToSkip: number;
+    /**
+     * When `true`, each particle refreshes its bounding box every frame so the
+     * hitbox tracks the visual exactly (useful for debug visualization or
+     * collision queries). When `false` (default), bounds reflect the previous
+     * frame's transform — sufficient for viewport culling and significantly
+     * cheaper at high particle counts.
+     * @default false
+     */
+    accurateBounds: boolean;
+    /**
+     * When `true`, the emitter automatically removes itself from its parent
+     * container once all particles have died. Useful for fire-and-forget
+     * `burstParticles()` use cases (explosions, pickups, impact effects) where
+     * there is no natural cleanup hook.
+     * @default false
+     */
+    autoDestroyOnComplete: boolean;
+    /**
+     * Optional callback fired when the emitter completes (all particles dead
+     * after at least one particle has been spawned, and — for stream mode —
+     * the duration has elapsed). Fires regardless of `autoDestroyOnComplete`,
+     * and runs *before* the emitter is removed from its parent. The callback
+     * is invoked with the emitter as its `this` context.
+     * @default undefined
+     */
+    onComplete: ((this: ParticleEmitter) => void) | undefined;
 }
+/**
+ * Default values for every {@link ParticleEmitterSettings} field.
+ * @category Particles
+ */
+declare const defaultParticleEmitterSettings: ParticleEmitterSettings;
+export default defaultParticleEmitterSettings;
 //# sourceMappingURL=settings.d.ts.map

package/build/particles/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/particles/settings.js"],"names":[],"mappings":";;eAQW,MAAM;gBAON,MAAM;eAQN,iBAAiB;qBASjB,MAAM;cAQN,MAAM;wBAON,MAAM;eAON,MAAM;wBAON,MAAM;iBAON,MAAM;iBAON,MAAM;eAON,MAAM;wBAON,MAAM;qBAON,MAAM;qBAON,MAAM;uBAON,MAAM;uBAON,MAAM;qBAON,MAAM;qBAON,MAAM;iBAON,MAAM;cAQN,MAAM;0BASN,OAAO;yBAOP,OAAO;mBASP,MAAM;wBASN,OAAO;kBAOP,OAAO;sBAOP,MAAM;mBAON,MAAM;kBAQN,MAAM;sBAQN,MAAM"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/particles/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,eAAe,MAAM,cAAc,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACvC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAExD;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B;;;;OAIG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;;;;OAOG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;;;;;OAMG;IACH,qBAAqB,EAAE,OAAO,CAAC;IAE/B;;;;;;;OAOG;IACH,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC1D;AAED;;;GAGG;AACH,QAAA,MAAM,8BAA8B,EAAE,uBAiCrC,CAAC;AAEF,eAAe,8BAA8B,CAAC"}

package/build/physics/quadtree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quadtree.d.ts","sourceRoot":"","sources":["../../src/physics/quadtree.js"],"names":[],"mappings":"AA2DA;;;;GAIG;AACH;IACC;;;;;;OAMG;IACH,mBANW,KAAK,UACL,MAAM,gBACN,MAAM,eACN,MAAM,UACN,MAAM,EAahB;IAVA,aAAkB;IAClB,eAAoB;IAEpB,oBAA8B;IAC9B,mBAA4B;IAE5B,cAAkB;IAElB,eAAiB;IACjB,aAAe;IAMhB,cA8DC;IAOD,4BA+CC;IAED;;;OAGG;IACH,2BAFW,SAAS,QAsBnB;IAED;;;;;OAKG;IACH,aAFW,MAAM,QAoChB;IAED;;;;;OAKG;IACH,eAJW,MAAM,OACN,MAAM,gBACJ,MAAM,EAAE,CAmCpB;IAED;;;;;OAKG;IACH,aAHW,MAAM,GACJ,OAAO,CAkCnB;IAED;;;OAGG;IACH,cAFa,OAAO,CAInB;IAED;;;OAGG;IACH,eAFa,OAAO,CAUnB;IAED;;;OAGG;IACH,eAFW,MAAM,QAsBhB;CACD;uBA/YqB,YAAY;4BAET,aAAa;2BADZ,8BAA8B"}
+{"version":3,"file":"quadtree.d.ts","sourceRoot":"","sources":["../../src/physics/quadtree.js"],"names":[],"mappings":"AA2DA;;;;GAIG;AACH;IACC;;;;;;OAMG;IACH,mBANW,KAAK,UACL,MAAM,gBACN,MAAM,eACN,MAAM,UACN,MAAM,EAahB;IAVA,aAAkB;IAClB,eAAoB;IAEpB,oBAA8B;IAC9B,mBAA4B;IAE5B,cAAkB;IAElB,eAAiB;IACjB,aAAe;IAMhB,cA8DC;IAOD,4BA+CC;IAED;;;OAGG;IACH,2BAFW,SAAS,QAyBnB;IAED;;;;;OAKG;IACH,aAFW,MAAM,QAoChB;IAED;;;;;OAKG;IACH,eAJW,MAAM,OACN,MAAM,gBACJ,MAAM,EAAE,CAmCpB;IAED;;;;;OAKG;IACH,aAHW,MAAM,GACJ,OAAO,CAkCnB;IAED;;;OAGG;IACH,cAFa,OAAO,CAInB;IAED;;;OAGG;IACH,eAFa,OAAO,CAUnB;IAED;;;OAGG;IACH,eAFW,MAAM,QAsBhB;CACD;uBAlZqB,YAAY;4BAET,aAAa;2BADZ,8BAA8B"}

package/build/renderable/imagelayer.d.ts

@@ -78,8 +78,19 @@ export default class ImageLayer extends Sprite {
      */
     updateLayer(): void;
     /**
-     * override the default predraw function
-     * as repeat and anchor are managed directly in the draw method
+     * Override the default preDraw to skip the base class's anchor offset
+     * translation and `autoTransform` application — `ImageLayer.draw()`
+     * computes its own world-space position from the viewport, the parallax
+     * `ratio`, anchor, and zoom, so applying anchor/transform here would
+     * double-translate the layer.
+     *
+     * Coordinate-sensitive setup (flip, stencil mask) is intentionally
+     * deferred to `draw()` where it runs *after* the per-camera zoom
+     * translate/scale — that way it stays correctly aligned at any
+     * `viewport.zoom` and across multiple cameras. Coordinate-independent
+     * setup (alpha, post-effects, tint, blend) stays here. The inherited
+     * `Renderable.postDraw` cleans up symmetrically (`clearTint` /
+     * `clearMask` / `endPostEffect` / `restore`).
      * @ignore
      */
     preDraw(renderer: any): void;

package/build/renderable/imagelayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imagelayer.d.ts","sourceRoot":"","sources":["../../src/renderable/imagelayer.js"],"names":[],"mappings":"AAYA;;;GAGG;AAEH;;;GAGG;AACH;IACC;;;;;;;;;;;;;;;;OAgBG;IACH,eAhBW,MAAM,KACN,MAAM,YAEd;QAA4E,KAAK,EAAzE,gBAAgB,GAAC,iBAAiB,GAAC,eAAe,GAAC,MAAM;QACvC,IAAI;QACJ,CAAC;QACQ,KAAK;QACsB,MAAM;QACjC,WAAW;KAC9C,EAoDF;IAhCA;;;;;;;;;OASG;IACH,OAHU,QAAQ,CAGqB;IAuCxC,kBAPU,MAAM,EA2Bf;IAnCD;;;;;;;;;;OAUG;IACH,cAHU,MAAM,CAKf;IAGA,4BAAoB;IAGlB,6BAAoB;IACpB,6BAAoB;IAkBvB,wBAsBC;IAED;;;;OAIG;IACH,UAHW,MAAM,KACN,MAAM,QAOhB;IAED;;;OAGG;IACH,sBAKC;IAJA,cAGC;IAGF;;;OAGG;IACH,oBA+CC;IAED;;;;OAIG;IACH,6BAcC;IAED;;;;;OAKG;IACH,yBAHW,cAAc,GAAC,aAAa,aAC5B,QAAQ,QAiDlB;IAGD,0BAMC;CAWD;mBApTkB,aAAa;8BAIL,qBAAqB"}
+{"version":3,"file":"imagelayer.d.ts","sourceRoot":"","sources":["../../src/renderable/imagelayer.js"],"names":[],"mappings":"AAYA;;;GAGG;AAEH;;;GAGG;AACH;IACC;;;;;;;;;;;;;;;;OAgBG;IACH,eAhBW,MAAM,KACN,MAAM,YAEd;QAA4E,KAAK,EAAzE,gBAAgB,GAAC,iBAAiB,GAAC,eAAe,GAAC,MAAM;QACvC,IAAI;QACJ,CAAC;QACQ,KAAK;QACsB,MAAM;QACjC,WAAW;KAC9C,EAoDF;IAhCA;;;;;;;;;OASG;IACH,OAHU,QAAQ,CAGqB;IAuCxC,kBAPU,MAAM,EA2Bf;IAnCD;;;;;;;;;;OAUG;IACH,cAHU,MAAM,CAKf;IAGA,4BAAoB;IAGlB,6BAAoB;IACpB,6BAAoB;IAkBvB,wBAsBC;IAED;;;;OAIG;IACH,UAHW,MAAM,KACN,MAAM,QAOhB;IAED;;;OAGG;IACH,sBAKC;IAJA,cAGC;IAGF;;;OAGG;IACH,oBA+CC;IAED;;;;;;;;;;;;;;;OAeG;IACH,6BAmBC;IAED;;;;;OAKG;IACH,yBAHW,cAAc,GAAC,aAAa,aAC5B,QAAQ,QAoElB;IAGD,0BAMC;CAWD;mBAvVkB,aAAa;8BAIL,qBAAqB"}

package/build/renderable/renderable.d.ts

@@ -185,45 +185,26 @@ export default class Renderable extends Rect {
      */
     mask: Rect | RoundRect | Polygon | Line | Ellipse;
     /**
-     * an optional shader, to be used instead of the default built-in one, when drawing this renderable (WebGL only).
-     * Use {@link ShaderEffect} for a custom fragment `apply()` function,
-     * or one of the built-in effect presets:
-     * - {@link FlashEffect} — flash the sprite with a solid color (hit feedback)
-     * - {@link OutlineEffect} — colored outline around the sprite (selection, hover)
-     * - {@link GlowEffect} — soft colored glow around the sprite (power-ups, magic)
-     * - {@link DesaturateEffect} — partial or full grayscale (disabled, death)
-     * - {@link PixelateEffect} — progressive pixelation (teleport, retro)
-     * - {@link BlurEffect} — box blur (defocus, backdrop)
-     * - {@link ChromaticAberrationEffect} — RGB channel offset (impact, glitch)
-     * - {@link DissolveEffect} — noise-based dissolve (death, spawn)
-     * - {@link DropShadowEffect} — offset shadow beneath the sprite
-     * - {@link ScanlineEffect} — horizontal scanlines with optional CRT curvature and vignette
-     * - {@link TintPulseEffect} — pulsing color overlay (poison, freeze, fire)
-     * - {@link WaveEffect} — sine wave distortion (underwater, heat haze)
-     * - {@link InvertEffect} — color inversion (negative image, X-ray)
-     * - {@link SepiaEffect} — warm vintage photo tone
-     * - {@link HologramEffect} — flickering holographic projection (sci-fi)
-     *
-     * Use {@link GLShader} for full control over vertex and fragment shaders.
+     * the list of post-processing shader effects applied to this renderable (WebGL only).
+     * Effects are applied in order. Use {@link addPostEffect}, {@link getPostEffect},
+     * and {@link removePostEffect} to manage effects, or assign directly.
      * In Canvas mode, this property is ignored.
-     * @type {GLShader|ShaderEffect}
-     * @default undefined
-     * @example
-     * // apply a built-in effect
-     * mySprite.shader = new FlashEffect(renderer, { intensity: 1.0 });
+     * @type {Array<GLShader|ShaderEffect>}
+     * @default []
      * @example
-     * // custom shader effect
-     * mySprite.shader = new ShaderEffect(renderer, `
-     *     vec4 apply(vec4 color, vec2 uv) {
-     *         float gray = dot(color.rgb, vec3(0.299, 0.587, 0.114));
-     *         return vec4(vec3(gray), color.a);
-     *     }
-     * `);
+     * // add effects via helper methods
+     * mySprite.addPostEffect(new DesaturateEffect(renderer));
+     * mySprite.addPostEffect(new VignetteEffect(renderer));
      * @example
-     * // to remove a custom shader
-     * mySprite.shader = undefined;
+     * // assign directly
+     * mySprite.postEffects = [new SepiaEffect(renderer), new VignetteEffect(renderer)];
      */
-    shader: GLShader | ShaderEffect;
+    postEffects: Array<GLShader | ShaderEffect>;
+    /**
+     * whether this renderable manages its own FBO lifecycle (e.g. Camera2d)
+     * @ignore
+     */
+    _postEffectManaged: boolean;
     /**
      * the blend mode to be applied to this renderable (see renderer setBlendMode for available blend mode)
      * @type {string}
@@ -313,6 +294,44 @@ export default class Renderable extends Rect {
      * @default false
      */
     get inViewport(): boolean;
+    set shader(value: GLShader | ShaderEffect | undefined);
+    /**
+     * @deprecated since 19.2.0 — use {@link addPostEffect} / {@link getPostEffect} / {@link removePostEffect} instead
+     * @type {GLShader|ShaderEffect|undefined}
+     */
+    get shader(): GLShader | ShaderEffect | undefined;
+    /**
+     * Add a post-processing shader effect to this renderable.
+     * @param {GLShader|ShaderEffect} effect - the effect to add
+     * @returns {GLShader|ShaderEffect} the added effect
+     * @example
+     * mySprite.addPostEffect(new DesaturateEffect(renderer));
+     */
+    addPostEffect(effect: GLShader | ShaderEffect): GLShader | ShaderEffect;
+    /**
+     * Get post-processing shader effects.
+     * When called with a class, returns the first effect matching the given class.
+     * When called without arguments, returns the full effects array.
+     * @param {Function} [effectClass] - the effect class to search for
+     * @returns {GLShader|ShaderEffect|Array|undefined} the matching effect, the effects array, or undefined
+     * @example
+     * const desat = sprite.getPostEffect(DesaturateEffect);
+     * const allEffects = sprite.getPostEffect();
+     */
+    getPostEffect(effectClass?: Function): GLShader | ShaderEffect | any[] | undefined;
+    /**
+     * Remove all post-processing shader effects.
+     * @example
+     * sprite.clearPostEffects();
+     */
+    clearPostEffects(): void;
+    /**
+     * Remove a specific post-processing shader effect.
+     * @param {GLShader|ShaderEffect} effect - the effect to remove
+     * @example
+     * sprite.removePostEffect(effect);
+     */
+    removePostEffect(effect: GLShader | ShaderEffect): void;
     /**
      * returns true if this renderable is flipped on the horizontal axis
      * @public

package/build/renderable/renderable.d.ts.map

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