melonjs 18.2.2 → 19.0.0

package/build/system/legacy_pool.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Set a callback to be invoked whenever pool.register() is called.
+ * @param {Function} callback - function(className, classObj, poolInstance) called on each registration
+ * @ignore
+ */
+export function setPoolRegisterCallback(callback: Function): void;
 export default pool;
 /**
  * a default global ObjectPool instance
@@ -32,9 +38,29 @@ declare class ObjectPool {
     objectClass: {};
     instance_counter: number;
     /**
-     * register an object to the pool. <br>
+     * When enabled, classes registered via {@link pool.register} are also
+     * automatically registered as Tiled object factories, so that objects
+     * placed in a Tiled map with a matching class or name will be
+     * instantiated using the registered constructor.
+     * Set to `false` to disable this behavior (e.g. for classes that should
+     * only be used programmatically and not from Tiled maps).
+     * @type {boolean}
+     * @default true
+     * @example
+     * // disable auto-registration for a specific class
+     * pool.autoRegisterTiled = false;
+     * pool.register("InternalHelper", HelperClass);
+     * pool.autoRegisterTiled = true; // re-enable for subsequent registrations
+     */
+    autoRegisterTiled: boolean;
+    /**
+     * Register an object to the pool. <br>
      * Pooling must be set to true if more than one such objects will be created. <br>
-     * (Note: for an object to be poolable, it must implements a `onResetEvent` method)
+     * (Note: for an object to be poolable, it must implement an `onResetEvent` method) <br><br>
+     * Registered classes are also automatically available as Tiled object factories,
+     * meaning objects placed in a Tiled map with a matching class or name will be
+     * instantiated using the registered constructor. For more control, use
+     * {@link registerTiledObjectClass} or {@link registerTiledObjectFactory} instead.
      * @param {string} className - as defined in the Name field of the Object Properties (in Tiled)
      * @param {object} classObj - corresponding Class to be instantiated
      * @param {boolean} [recycling=false] - enables object recycling for the specified class
@@ -47,6 +73,8 @@ declare class ObjectPool {
      *    }
      * };
      * // add our users defined entities in the object pool and enable object recycling
+     * // this also registers "cherrysprite" as a Tiled object factory, so any object
+     * // with class or name "cherrysprite" in a Tiled map will create a Cherry instance
      * me.pool.register("cherrysprite", Cherry, true);
      */
     register(className: string, classObj: object, recycling?: boolean): void;
@@ -68,8 +96,8 @@ declare class ObjectPool {
      * // ...
      * // when we want to destroy existing object, the remove
      * // function will ensure the object can then be reallocated later
-     * me.game.world.removeChild(enemy);
-     * me.game.world.removeChild(bullet);
+     * app.world.removeChild(enemy);
+     * app.world.removeChild(bullet);
      */
     pull(name: string, ...args?: any[]): object;
     /**

package/build/system/legacy_pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legacy_pool.d.ts","sourceRoot":"","sources":["../../src/system/legacy_pool.js"],"names":[],"mappings":";AAoLA;;;;;;;;;;;;;;GAcG;AACH,+BAA8B;AAjM9B;;;;;;;;;;;;GAYG;AACH;IAEE,gBAAqB;IACrB,yBAAyB;IAG1B;;;;;;;;;;;;;;;;;OAiBG;IACH,oBAdW,MAAM,YACN,MAAM,cACN,OAAO,QA4BjB;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAnBW,MAAM,YACH,GAAC,EAAA,GACF,MAAM,CAsClB;IAED;;;;OAIG;IACH,cAOC;IAED;;;;;;;;;OASG;IACH,UAJW,MAAM,iBACN,OAAO,GACL,OAAO,CAgBnB;IAED;;;;OAIG;IACH,aAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;;;;;;;OAUG;IACH,cAPW,MAAM,GACJ,OAAO,CAcnB;IAED;;;OAGG;IACH,oBAFa,MAAM,CAIlB;CACD"}
+{"version":3,"file":"legacy_pool.d.ts","sourceRoot":"","sources":["../../src/system/legacy_pool.js"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,kEAEC;;AAmND;;;;;;;;;;;;;;GAcG;AACH,+BAA8B;AAhO9B;;;;;;;;;;;;GAYG;AACH;IAEE,gBAAqB;IACrB,yBAAyB;IAEzB;;;;;;;;;;;;;;OAcG;IACH,mBARU,OAAO,CAQY;IAG9B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,oBAhBW,MAAM,YACN,MAAM,cACN,OAAO,QAsCjB;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAnBW,MAAM,YACH,GAAC,EAAA,GACF,MAAM,CAsClB;IAED;;;;OAIG;IACH,cAOC;IAED;;;;;;;;;OASG;IACH,UAJW,MAAM,iBACN,OAAO,GACL,OAAO,CAgBnB;IAED;;;;OAIG;IACH,aAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;;;;;;;OAUG;IACH,cAPW,MAAM,GACJ,OAAO,CAcnB;IAED;;;OAGG;IACH,oBAFa,MAAM,CAIlB;CACD"}

package/build/system/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/system/platform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,EAAE,QAGT,CAAC;AACP,eAAO,MAAM,GAAG,SAA+B,CAAC;AAChD,eAAO,MAAM,OAAO,SAAsB,CAAC;AAC3C,eAAO,MAAM,QAAQ,SAAwB,CAAC;AAC9C,eAAO,MAAM,KAAK,SAAoB,CAAC;AACvC,eAAO,MAAM,QAAQ,SAAkB,CAAC;AACxC,eAAO,MAAM,EAAE,SAA4B,CAAC;AAC5C,eAAO,MAAM,UAAU,SAAyB,CAAC;AACjD,eAAO,MAAM,MAAM,SAAyC,CAAC;AAC7D,eAAO,MAAM,MAAM,SAAyB,CAAC;AAC7C,eAAO,MAAM,QAAQ,SAA6B,CAAC;AACnD,eAAO,MAAM,MAAM,SAGwB,CAAC;AAC5C,eAAO,MAAM,QAAQ,SACqD,CAAC;AAC3E,eAAO,MAAM,MAAM,SAK2C,CAAC"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/system/platform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,EAAE,QAGT,CAAC;AACP,eAAO,MAAM,GAAG,SAA+B,CAAC;AAChD,eAAO,MAAM,OAAO,SAAsB,CAAC;AAC3C,eAAO,MAAM,QAAQ,SAAwB,CAAC;AAC9C,eAAO,MAAM,KAAK,SAAoB,CAAC;AACvC,eAAO,MAAM,QAAQ,SAAkB,CAAC;AACxC,eAAO,MAAM,EAAE,SAA4B,CAAC;AAC5C,eAAO,MAAM,UAAU,SAAyB,CAAC;AACjD,eAAO,MAAM,MAAM,SAAyC,CAAC;AAC7D,eAAO,MAAM,MAAM,SAAyB,CAAC;AAC7C,eAAO,MAAM,QAAQ,SAA6B,CAAC;AACnD,eAAO,MAAM,MAAM,SAMiB,CAAC;AACrC,eAAO,MAAM,QAAQ,SACqD,CAAC;AAC3E,eAAO,MAAM,MAAM,SAK2C,CAAC"}

package/build/system/timer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../src/system/timer.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,cAAM,KAAK;IACV,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACP,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;QAC5B,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,IAAI,EAAE,GAAG,EAAE,CAAC;KACZ,EAAE,CAAC;IACJ,OAAO,EAAE,MAAM,CAAC;;IAsEhB;;;OAGG;IACH,KAAK;IAYL;;;;;;;;;;;;OAYG;IACH,UAAU,CACT,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC3B,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,OAAO,EACnB,GAAG,IAAI,EAAE,GAAG,EAAE;IAcf;;;;;;;;;;;;OAYG;IACH,WAAW,CACV,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC3B,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,OAAO,EACnB,GAAG,IAAI,EAAE,GAAG,EAAE;IAcf;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM;IAQ9B;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM;IAQhC;;;;OAIG;IACH,OAAO;IAIP;;;OAGG;IACH,QAAQ;IAIR;;;OAGG;IACH,QAAQ;IAcR;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM;IAmBnB;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM;IAS1B;;;OAGG;IACH,YAAY;CAgBZ;AAED,QAAA,MAAM,KAAK,OAAc,CAAC;AAE1B;;;;;;;;;;;;GAYG;AACH,eAAe,KAAK,CAAC"}
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../src/system/timer.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,cAAM,KAAK;IACV,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACP,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;QAC5B,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,IAAI,EAAE,GAAG,EAAE,CAAC;KACZ,EAAE,CAAC;IACJ,OAAO,EAAE,MAAM,CAAC;;IAsEhB;;;OAGG;IACH,KAAK;IAYL;;;;;;;;;;;;OAYG;IACH,UAAU,CACT,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC3B,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,OAAO,EACnB,GAAG,IAAI,EAAE,GAAG,EAAE;IAcf;;;;;;;;;;;;OAYG;IACH,WAAW,CACV,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC3B,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,OAAO,EACnB,GAAG,IAAI,EAAE,GAAG,EAAE;IAcf;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM;IAQ9B;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM;IAQhC;;;;OAIG;IACH,OAAO;IAIP;;;OAGG;IACH,QAAQ;IAIR;;;OAGG;IACH,QAAQ;IAcR;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM;IAmBnB;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM;IAS1B;;;OAGG;IACH,YAAY;CAgBZ;AAED,QAAA,MAAM,KAAK,OAAc,CAAC;AAE1B;;;;;;;;;;;;GAYG;AACH,eAAe,KAAK,CAAC"}

package/build/tweens/easing.d.ts

@@ -1,38 +1,27 @@
 /**
- * Easing Function :<br>
- * <p>
- * Easing.Linear.None<br>
- * Easing.Quadratic.In<br>
- * Easing.Quadratic.Out<br>
- * Easing.Quadratic.InOut<br>
- * Easing.Cubic.In<br>
- * Easing.Cubic.Out<br>
- * Easing.Cubic.InOut<br>
- * Easing.Quartic.In<br>
- * Easing.Quartic.Out<br>
- * Easing.Quartic.InOut<br>
- * Easing.Quintic.In<br>
- * Easing.Quintic.Out<br>
- * Easing.Quintic.InOut<br>
- * Easing.Sinusoidal.In<br>
- * Easing.Sinusoidal.Out<br>
- * Easing.Sinusoidal.InOut<br>
- * Easing.Exponential.In<br>
- * Easing.Exponential.Out<br>
- * Easing.Exponential.InOut<br>
- * Easing.Circular.In<br>
- * Easing.Circular.Out<br>
- * Easing.Circular.InOut<br>
- * Easing.Elastic.In<br>
- * Easing.Elastic.Out<br>
- * Easing.Elastic.InOut<br>
- * Easing.Back.In<br>
- * Easing.Back.Out<br>
- * Easing.Back.InOut<br>
- * Easing.Bounce.In<br>
- * Easing.Bounce.Out<br>
- * Easing.Bounce.InOut
- * </p>
+ * Easing functions for use with {@link Tween}.
+ * Each family provides `In` (accelerate), `Out` (decelerate), and `InOut` (both) variants.
+ *
+ * Available families:
+ * - `Linear.None` — constant speed
+ * - `Quadratic` — power of 2
+ * - `Cubic` — power of 3
+ * - `Quartic` — power of 4
+ * - `Quintic` — power of 5
+ * - `Sinusoidal` — sine wave
+ * - `Exponential` — base-2 exponential
+ * - `Circular` — circular arc
+ * - `Elastic` — spring overshoot
+ * - `Back` — slight overshoot before settling
+ * - `Bounce` — bouncing ball effect
+ * @example
+ * // use with Tween
+ * new me.Tween(obj).to({ x: 100 }, {
+ *     duration: 1000,
+ *     easing: me.Tween.Easing.Bounce.Out,
+ * }).start();
+ * @see https://easings.net/ for visual reference
+ * @category Tweens
  */
 export type EasingFunction = (t: number) => number;
 export declare const Easing: {

package/build/tweens/easing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"easing.d.ts","sourceRoot":"","sources":["../../src/tweens/easing.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAEnD,eAAO,MAAM,MAAM;;kBAEP,MAAM;;;gBAMR,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAST,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAST,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAST,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAST,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAMT,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAeT,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAST,MAAM;iBASL,MAAM;mBASJ,MAAM;;;gBAoBT,MAAM;iBAIL,MAAM;mBAIJ,MAAM;;;gBAUT,MAAM;iBAGL,MAAM;mBAWJ,MAAM;;CAOlB,CAAC"}
+{"version":3,"file":"easing.d.ts","sourceRoot":"","sources":["../../src/tweens/easing.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAEnD,eAAO,MAAM,MAAM;;kBAEP,MAAM;;;gBAMR,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAST,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAST,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAST,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAST,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAMT,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAeT,MAAM;iBAGL,MAAM;mBAGJ,MAAM;;;gBAST,MAAM;iBASL,MAAM;mBASJ,MAAM;;;gBAoBT,MAAM;iBAIL,MAAM;mBAIJ,MAAM;;;gBAUT,MAAM;iBAGL,MAAM;mBAWJ,MAAM;;CAOlB,CAAC"}

package/build/tweens/interpolation.d.ts

@@ -1,7 +1,39 @@
 export type InterpolationFunction = (v: number[], k: number) => number;
+/**
+ * Interpolation functions for tweening through arrays of values.
+ * Used when a tween target property is an array (e.g. a path of waypoints).
+ *
+ * Available functions:
+ * - `Linear` — straight-line interpolation between consecutive values
+ * - `Bezier` — smooth Bezier curve through all values
+ * - `CatmullRom` — smooth Catmull-Rom spline through all values (best for paths)
+ * @example
+ * // tween through waypoints using CatmullRom spline
+ * new me.Tween(obj).to({ x: [100, 200, 300, 400] }, {
+ *     duration: 2000,
+ *     interpolation: me.Tween.Interpolation.CatmullRom,
+ * }).start();
+ * @see {@link Tween}
+ * @category Tweens
+ */
 export declare const Interpolation: {
+    /**
+     * Piecewise linear interpolation between consecutive array values.
+     * @param v - array of values
+     * @param k - interpolation factor (0 to 1)
+     */
     Linear: (v: number[], k: number) => number;
+    /**
+     * Smooth Bezier curve interpolation through all array values.
+     * @param v - array of values
+     * @param k - interpolation factor (0 to 1)
+     */
     Bezier: (v: number[], k: number) => number;
+    /**
+     * Smooth Catmull-Rom spline interpolation — best for path-following tweens.
+     * @param v - array of values
+     * @param k - interpolation factor (0 to 1)
+     */
     CatmullRom: (v: number[], k: number) => number;
 };
 //# sourceMappingURL=interpolation.d.ts.map

package/build/tweens/interpolation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interpolation.d.ts","sourceRoot":"","sources":["../../src/tweens/interpolation.ts"],"names":[],"mappings":"AA8CA,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAEvE,eAAO,MAAM,aAAa;gBACb,MAAM,EAAE,KAAK,MAAM;gBAcnB,MAAM,EAAE,KAAK,MAAM;oBAUf,MAAM,EAAE,KAAK,MAAM;CAoCnC,CAAC"}
+{"version":3,"file":"interpolation.d.ts","sourceRoot":"","sources":["../../src/tweens/interpolation.ts"],"names":[],"mappings":"AA8CA,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAEvE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa;IACzB;;;;OAIG;gBACS,MAAM,EAAE,KAAK,MAAM;IAc/B;;;;OAIG;gBACS,MAAM,EAAE,KAAK,MAAM;IAU/B;;;;OAIG;oBACa,MAAM,EAAE,KAAK,MAAM;CAoCnC,CAAC"}

package/build/tweens/tween.d.ts

@@ -7,21 +7,33 @@ type OnUpdateCallback<T> = (this: T, value: number) => void;
 /** @ignore */
 type OnCompleteCallback<T> = (this: T) => void;
 /**
- * Javascript Tweening Engine<p>
- * Super simple, fast and easy to use tweening engine which incorporates optimised Robert Penner's equation<p>
- * <a href="https://github.com/sole/Tween.js">https://github.com/sole/Tween.js</a><p>
- * author sole / http://soledadpenades.com<br>
- * author mr.doob / http://mrdoob.com<br>
- * author Robert Eisele / http://www.xarg.org<br>
- * author Philippe / http://philippe.elsass.me<br>
- * author Robert Penner / http://www.robertpenner.com/easing_terms_of_use.html<br>
- * author Paul Lewis / http://www.aerotwist.com/<br>
- * author lechecacharro<br>
- * author Josh Faul / http://jocafa.com/
+ * A tweening engine for smoothly interpolating object properties over time.
+ * Based on <a href="https://github.com/sole/Tween.js">tween.js</a> with
+ * optimised Robert Penner's equations.
+ *
+ * Tweens use an event-based lifecycle — on `start()` the tween subscribes to
+ * the game loop events (`TICK`, `GAME_AFTER_UPDATE`, `STATE_PAUSE`,
+ * `STATE_RESUME`, `GAME_RESET`)
+ * and automatically unsubscribes on completion or `stop()`.
+ * They do not need to be added to a container.
+ * @example
+ * // basic usage
+ * new me.Tween(myObject.pos)
+ *     .to({ x: 200, y: 200 }, { duration: 3000, easing: me.Tween.Easing.Bounce.Out })
+ *     .onComplete(() => console.log("done!"))
+ *     .start();
+ * @example
+ * // auto-start with options
+ * new me.Tween(myObject.pos).to({ x: 200 }, {
+ *     duration: 1000,
+ *     easing: me.Tween.Easing.Quadratic.InOut,
+ *     yoyo: true,
+ *     repeat: Infinity,
+ *     autoStart: true,
+ * });
  * @category Tweens
  */
 export default class Tween {
-    #private;
     _object: object;
     _valuesStart: Record<string, unknown>;
     _valuesEnd: Record<string, unknown>;
@@ -40,21 +52,22 @@ export default class Tween {
     _onUpdateCallback: OnUpdateCallback<object> | null;
     _onCompleteCallback: OnCompleteCallback<object> | null;
     _tweenTimeTracker: number;
+    _lastUpdate: number;
+    _isRunning: boolean;
+    _isPaused: boolean;
+    _lastTick: number;
+    /**
+     * whether the tween should persist across state changes (not auto-stopped on game reset)
+     * @default false
+     */
     isPersistent: boolean;
+    /**
+     * whether the tween should keep running when the game is paused
+     * @default false
+     */
     updateWhenPaused: boolean;
-    isRenderable: boolean;
     /**
-     * @param object - object on which to apply the tween
-     * @example
-     * // add a tween to change the object pos.x and pos.y variable to 200 in 3 seconds
-     * tween = new me.Tween(myObject.pos).to({
-     *       x: 200,
-     *       y: 200,
-     *    }, {
-     *       duration: 3000,
-     *       easing: me.Tween.Easing.Bounce.Out,
-     *       autoStart : true
-     * }).onComplete(myFunc);
+     * @param object - the object whose properties will be tweened
      */
     constructor(object: object);
     /**
@@ -69,27 +82,35 @@ export default class Tween {
      * @ignore
      */
     _resumeCallback(elapsed: number): void;
+    /** @ignore */
+    _onAfterUpdate(lastUpdate: number): void;
+    /** @ignore */
+    _onTick(timestamp: number): void;
+    /** @ignore */
+    _onPause(): void;
+    /** @ignore */
+    _onReset(): void;
     /**
-     * subscribe to the resume event when added
+     * Subscribe to the game loop events
      * @ignore
      */
-    onActivateEvent(): void;
+    _subscribe(): void;
     /**
-     * Unsubscribe when tween is removed
+     * Unsubscribe from the game loop events
      * @ignore
      */
-    onDeactivateEvent(): void;
-    /**
-     * object properties to be updated and duration
-     * @param properties - hash of properties
-     * @param [options] - object of tween properties, or a duration if a numeric value is passed
-     * @param [options.duration] - tween duration
-     * @param [options.easing] - easing function
-     * @param [options.delay] - delay amount expressed in milliseconds
-     * @param [options.yoyo] - allows the tween to bounce back to their original value when finished. To be used together with repeat to create endless loops.
-     * @param [options.repeat] - amount of times the tween should be repeated
-     * @param [options.interpolation] - interpolation function
-     * @param [options.autoStart] - allow this tween to start automatically. Otherwise call me.Tween.start().
+    _unsubscribe(): void;
+    /**
+     * Define the target property values and tween options.
+     * @param properties - target property values to tween to (e.g. `{ x: 200, y: 100 }`)
+     * @param [options] - tween configuration
+     * @param [options.duration] - tween duration in milliseconds
+     * @param [options.easing] - easing function (e.g. `Tween.Easing.Quadratic.InOut`)
+     * @param [options.delay] - delay before starting, in milliseconds
+     * @param [options.yoyo] - bounce back to original values when finished (use with `repeat`)
+     * @param [options.repeat] - number of times to repeat (use `Infinity` for endless loops)
+     * @param [options.interpolation] - interpolation function for array values
+     * @param [options.autoStart] - start the tween immediately without calling `start()`
      * @returns this instance for object chaining
      */
     to(properties: Record<string, unknown>, options?: {
@@ -102,13 +123,13 @@ export default class Tween {
         autoStart?: boolean | undefined;
     }): this;
     /**
-     * start the tween
-     * @param [time] - the current time when the tween was started
+     * Start the tween. Subscribes to game loop events and begins interpolation.
+     * @param [time] - the start time (defaults to current game time)
      * @returns this instance for object chaining
      */
     start(time?: number): this;
     /**
-     * stop the tween
+     * Stop the tween. Unsubscribes from all game loop events.
      * @returns this instance for object chaining
      */
     stop(): this;
@@ -169,6 +190,15 @@ export default class Tween {
     onComplete(onCompleteCallback: OnCompleteCallback<object>): this;
     /** @ignore */
     update(dt: number): boolean;
+    /**
+     * Available easing functions, accessed via `Tween.Easing`.
+     * Each family provides `In`, `Out`, and `InOut` variants.
+     * @see {@link Easing} for the full list
+     * @example
+     * me.Tween.Easing.Quadratic.InOut
+     * me.Tween.Easing.Bounce.Out
+     * me.Tween.Easing.Elastic.In
+     */
     static get Easing(): {
         Linear: {
             None: (k: number) => number;
@@ -224,6 +254,14 @@ export default class Tween {
             InOut: (k: number) => number;
         };
     };
+    /**
+     * Available interpolation functions for tweening array values.
+     * @see {@link Interpolation}
+     * @example
+     * me.Tween.Interpolation.Linear
+     * me.Tween.Interpolation.Bezier
+     * me.Tween.Interpolation.CatmullRom
+     */
     static get Interpolation(): {
         Linear: (v: number[], k: number) => number;
         Bezier: (v: number[], k: number) => number;

package/build/tweens/tween.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tween.d.ts","sourceRoot":"","sources":["../../src/tweens/tween.ts"],"names":[],"mappings":"AAIA,OAAO,EAAU,cAAc,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAiB,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAO1E,cAAc;AACd,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAC5C,cAAc;AACd,KAAK,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAC5D,cAAc;AACd,KAAK,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,OAAO,OAAO,KAAK;;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,cAAc,CAAC;IAChC,sBAAsB,EAAE,qBAAqB,CAAC;IAC9C,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,gBAAgB,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACjD,qBAAqB,EAAE,OAAO,CAAC;IAC/B,iBAAiB,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACnD,mBAAmB,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACvD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IAItB;;;;;;;;;;;;OAYG;gBACS,MAAM,EAAE,MAAM;IAM1B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM;IAI3B;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM;IAoC5B;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM;IAM/B;;;OAGG;IACH,eAAe;IAIf;;;OAGG;IACH,iBAAiB;IAIjB;;;;;;;;;;;;OAYG;IACH,EAAE,CACD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;QACpC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,aAAa,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;QAClD,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KAChC;IA+BF;;;;OAIG;IACH,KAAK,CAAC,IAAI,SAAkB;IAmC5B;;;OAGG;IACH,IAAI;IAMJ;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM;IAKpB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM;IAKpB;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,OAAO;IAKlB;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,cAAc;IAK7B;;;;OAIG;IACH,aAAa,CAAC,aAAa,EAAE,qBAAqB;IAKlD;;;;OAIG;IACH,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE;IAKxB;;;;OAIG;IACH,OAAO,CAAC,eAAe,EAAE,eAAe,CAAC,MAAM,CAAC;IAKhD;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,MAAM,CAAC;IAKnD;;;;OAIG;IACH,UAAU,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,MAAM,CAAC;IAKzD,cAAc;IACd,MAAM,CAAC,EAAE,EAAE,MAAM;IA6GjB,MAAM,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAEhB;IACD,MAAM,KAAK,aAAa;;;;MAEvB;CACD;AAED,eAAO,MAAM,SAAS,wDASpB,CAAC"}
+{"version":3,"file":"tween.d.ts","sourceRoot":"","sources":["../../src/tweens/tween.ts"],"names":[],"mappings":"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"}

package/build/utils/function.d.ts

@@ -13,7 +13,7 @@
  * // with the current context and [1, 2, 3] as parameter
  * me.utils.function.defer(myFunc, this, 1, 2, 3);
  */
-export declare function defer(func: (...args: unknown[]) => unknown, thisArg: unknown, ...args: unknown[]): NodeJS.Timeout;
+export declare function defer(func: (...args: unknown[]) => unknown, thisArg: unknown, ...args: unknown[]): number;
 /**
  * returns a function that, when invoked will only be triggered at most once during a given window of time
  * @param fn - the function to be throttled.

package/build/utils/function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../src/utils/function.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CACpB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACrC,OAAO,EAAE,OAAO,EAChB,GAAG,IAAI,EAAE,OAAO,EAAE,kBAGlB;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,IAAI,MAAM,IAAI,EAAE,OAAM,MAAY,MAIlD,GAAG,MAAM,EAAE,SAkBnB,CAAC"}
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../src/utils/function.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CACpB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACrC,OAAO,EAAE,OAAO,EAChB,GAAG,IAAI,EAAE,OAAO,EAAE,UAGlB;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,IAAI,MAAM,IAAI,EAAE,OAAM,MAAY,MAIlD,GAAG,MAAM,EAAE,SAkBnB,CAAC"}

package/build/video/canvas/canvas_renderer.d.ts

@@ -117,6 +117,9 @@ export default class CanvasRenderer extends Renderer {
      * @see CanvasRenderer#createPattern
      */
     drawPattern(pattern: CanvasPattern, x: number, y: number, width: number, height: number): void;
+    _meshSortBuf: Float64Array<ArrayBuffer> | undefined;
+    _meshColorCanvas: HTMLCanvasElement | undefined;
+    _meshColorCtx: CanvasRenderingContext2D | null | undefined;
     /**
      * starts a new path by emptying the list of sub-paths. Call this method when you want to create a new path
      * @example
@@ -144,6 +147,33 @@ export default class CanvasRenderer extends Renderer {
      * adds a straight line to the current sub-path by connecting the sub-path's last point to the specified (x, y) coordinates.
      */
     lineTo(x: any, y: any): void;
+    /**
+     * Adds a quadratic Bezier curve to the current sub-path.
+     * @param {number} cpx - The x-axis coordinate of the control point.
+     * @param {number} cpy - The y-axis coordinate of the control point.
+     * @param {number} x - The x-axis coordinate of the end point.
+     * @param {number} y - The y-axis coordinate of the end point.
+     */
+    quadraticCurveTo(cpx: number, cpy: number, x: number, y: number): void;
+    /**
+     * Adds a cubic Bezier curve to the current sub-path.
+     * @param {number} cp1x - The x-axis coordinate of the first control point.
+     * @param {number} cp1y - The y-axis coordinate of the first control point.
+     * @param {number} cp2x - The x-axis coordinate of the second control point.
+     * @param {number} cp2y - The y-axis coordinate of the second control point.
+     * @param {number} x - The x-axis coordinate of the end point.
+     * @param {number} y - The y-axis coordinate of the end point.
+     */
+    bezierCurveTo(cp1x: number, cp1y: number, cp2x: number, cp2y: number, x: number, y: number): void;
+    /**
+     * Adds a circular arc to the current sub-path, using the given control points and radius.
+     * @param {number} x1 - The x-axis coordinate of the first control point.
+     * @param {number} y1 - The y-axis coordinate of the first control point.
+     * @param {number} x2 - The x-axis coordinate of the second control point.
+     * @param {number} y2 - The y-axis coordinate of the second control point.
+     * @param {number} radius - The arc's radius. Must be non-negative.
+     */
+    arcTo(x1: number, y1: number, x2: number, y2: number, radius: number): void;
     /**
      * creates a rectangular path whose starting point is at (x, y) and whose size is specified by width and height.
      * @param {number} x - The x axis of the coordinate for the rectangle starting point.
@@ -338,12 +368,6 @@ export default class CanvasRenderer extends Renderer {
      * @param {number} y - Scaling factor in the vertical direction. A negative value flips pixels across the horizontal axis. A value of 1 results in no vertical scaling
      */
     scale(x: number, y: number): void;
-    /**
-     * Set the current fill & stroke style color.
-     * By default, or upon reset, the value is set to #000000.
-     * @param {Color|string} color - css color value
-     */
-    setColor(color: Color | string): void;
     /**
      * Set the global alpha
      * @param {number} alpha - 0.0 to 1.0 values accepted.
@@ -378,25 +402,25 @@ export default class CanvasRenderer extends Renderer {
     /**
      * Reset (overrides) the renderer transformation matrix to the
      * identity one, and then apply the given transformation matrix.
-     * @param {Matrix2d|number} a - a matrix2d to transform by, or a the a component to multiply the current matrix by
+     * @param {Matrix2d|Matrix3d|number} a - a matrix to transform by, or the a component to multiply the current matrix by
      * @param {number} b - the b component to multiply the current matrix by
      * @param {number} c - the c component to multiply the current matrix by
      * @param {number} d - the d component to multiply the current matrix by
      * @param {number} e - the e component to multiply the current matrix by
      * @param {number} f - the f component to multiply the current matrix by
      */
-    setTransform(a: Matrix2d | number, b: number, c: number, d: number, e: number, f: number): void;
+    setTransform(a: Matrix2d | Matrix3d | number, b: number, c: number, d: number, e: number, f: number): void;
     /**
      * Multiply given matrix into the renderer tranformation matrix
      * @see {@link CanvasRenderer.setTransform} which will reset the current transform matrix prior to performing the new transformation
-     * @param {Matrix2d|number} a - a matrix2d to transform by, or a the a component to multiply the current matrix by
+     * @param {Matrix2d|Matrix3d|number} a - a matrix to transform by, or the a component to multiply the current matrix by
      * @param {number} b - the b component to multiply the current matrix by
      * @param {number} c - the c component to multiply the current matrix by
      * @param {number} d - the d component to multiply the current matrix by
      * @param {number} e - the e component to multiply the current matrix by
      * @param {number} f - the f component to multiply the current matrix by
      */
-    transform(a: Matrix2d | number, b: number, c: number, d: number, e: number, f: number): void;
+    transform(a: Matrix2d | Matrix3d | number, b: number, c: number, d: number, e: number, f: number): void;
     /**
      * adds a translation transformation to the current matrix.
      * @param {number} x - Distance to move in the horizontal direction. Positive values are to the right, and negative to the left.

package/build/video/canvas/canvas_renderer.d.ts.map

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

package/build/video/gradient.d.ts

@@ -0,0 +1,116 @@
+/**
+ * A Gradient object representing a linear or radial gradient fill.
+ * Created via {@link Renderer#createLinearGradient} or {@link Renderer#createRadialGradient}.
+ * Can be passed to {@link Renderer#setColor} as a fill style.
+ */
+export class Gradient {
+    /**
+     * @param {"linear"|"radial"} type - the gradient type
+     * @param {number[]} coords - gradient coordinates [x0, y0, x1, y1] for linear, [x0, y0, r0, x1, y1, r1] for radial
+     */
+    constructor(type: "linear" | "radial", coords: number[]);
+    /**
+     * gradient type
+     * @type {"linear"|"radial"}
+     */
+    /** @ignore */
+    _id: number;
+    type: "linear" | "radial";
+    /**
+     * gradient coordinates
+     * @type {number[]}
+     * @ignore
+     */
+    coords: number[];
+    /**
+     * color stops
+     * @type {Array<{offset: number, color: string}>}
+     * @ignore
+     */
+    colorStops: Array<{
+        offset: number;
+        color: string;
+    }>;
+    /**
+     * cached canvas gradient (for Canvas renderer)
+     * @type {CanvasGradient|undefined}
+     * @ignore
+     */
+    _canvasGradient: CanvasGradient | undefined;
+    /**
+     * cached gradient render target (for WebGL renderer)
+     * @type {CanvasRenderTarget|undefined}
+     * @ignore
+     */
+    _renderTarget: CanvasRenderTarget | undefined;
+    /**
+     * whether the gradient needs to be regenerated
+     * @type {boolean}
+     * @ignore
+     */
+    _dirty: boolean;
+    /**
+     * cached parsed Color objects for sampling (lazily built)
+     * @type {{offset: number, color: Color}[]|null}
+     * @ignore
+     */
+    _parsedStops: {
+        offset: number;
+        color: Color;
+    }[] | null;
+    /**
+     * Add a color stop to the gradient.
+     * @param {number} offset - value between 0.0 and 1.0
+     * @param {Color|string} color - a CSS color string or Color object
+     * @returns {Gradient} this gradient for chaining
+     * @example
+     * gradient.addColorStop(0, "#FF0000");
+     * gradient.addColorStop(0.5, "green");
+     * gradient.addColorStop(1, "blue");
+     */
+    addColorStop(offset: number, color: Color | string): Gradient;
+    /**
+     * Get or create a native CanvasGradient for use with a 2D context.
+     * @param {CanvasRenderingContext2D} context - the 2D context to create the gradient on
+     * @returns {CanvasGradient}
+     * @ignore
+     */
+    toCanvasGradient(context: CanvasRenderingContext2D): CanvasGradient;
+    /**
+     * Render the gradient onto a canvas matching the given draw rect.
+     * Uses the original gradient coordinates so the result matches Canvas 2D behavior.
+     * @param {CanvasRenderer|WebGLRenderer} renderer - the active renderer (used to invalidate GPU texture)
+     * @param {number} x - draw rect x
+     * @param {number} y - draw rect y
+     * @param {number} width - draw rect width
+     * @param {number} height - draw rect height
+     * @returns {HTMLCanvasElement|OffscreenCanvas} the rendered gradient canvas
+     * @ignore
+     */
+    toCanvas(renderer: CanvasRenderer | WebGLRenderer, x: number, y: number, width: number, height: number): HTMLCanvasElement | OffscreenCanvas;
+    /**
+     * Get the interpolated color at a given position along the gradient.
+     * Useful for procedural effects like trails that need per-segment colors.
+     * @param {number} position - position along the gradient (0.0–1.0)
+     * @param {Color} out - output Color object to write into
+     * @returns {Color} the output Color object
+     * @example
+     * const gradient = new Gradient("linear", [0, 0, 1, 0]);
+     * gradient.addColorStop(0, "#ff0000");
+     * gradient.addColorStop(1, "#0000ff");
+     * gradient.getColorAt(0.5, myColor); // myColor is now purple
+     */
+    getColorAt(position: number, out: Color): Color;
+    /**
+     * Build the parsed Color cache from colorStops strings.
+     * @ignore
+     */
+    _buildParsedStops(): void;
+    /**
+     * Release pooled resources held by this gradient.
+     */
+    destroy(): void;
+}
+import CanvasRenderTarget from "./rendertarget/canvasrendertarget.js";
+import type { Color } from "../math/color.ts";
+//# sourceMappingURL=gradient.d.ts.map

package/build/video/gradient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradient.d.ts","sourceRoot":"","sources":["../../src/video/gradient.js"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH;IACC;;;OAGG;IACH,kBAHW,QAAQ,GAAC,QAAQ,UACjB,MAAM,EAAE,EAqDlB;IAlDA;;;OAGG;IACH,cAAc;IACd,YAA2B;IAE3B,0BAAgB;IAEhB;;;;OAIG;IACH,QAHU,MAAM,EAAE,CAGE;IAEpB;;;;OAIG;IACH,YAHU,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC,CAG5B;IAEpB;;;;OAIG;IACH,iBAHU,cAAc,GAAC,SAAS,CAGF;IAEhC;;;;OAIG;IACH,eAHU,kBAAkB,GAAC,SAAS,CAGR;IAE9B;;;;OAIG;IACH,QAHU,OAAO,CAGC;IAElB;;;;OAIG;IACH,cAHU;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAC,EAAE,GAAC,IAAI,CAGvB;IAGzB;;;;;;;;;OASG;IACH,qBARW,MAAM,SACN,KAAK,GAAC,MAAM,GACV,QAAQ,CA0BpB;IAED;;;;;OAKG;IACH,0BAJW,wBAAwB,GACtB,cAAc,CAiC1B;IAED;;;;;;;;;;OAUG;IACH,mBARW,cAAc,GAAC,aAAa,KAC5B,MAAM,KACN,MAAM,SACN,MAAM,UACN,MAAM,GACJ,iBAAiB,GAAC,eAAe,CAwE7C;IAED;;;;;;;;;;;OAWG;IACH,qBATW,MAAM,OACN,KAAK,GACH,KAAK,CA+CjB;IAED;;;OAGG;IACH,0BAWC;IAED;;OAEG;IACH,gBAOC;CACD;+BAtT8B,sCAAsC;2BAH7C,kBAAkB"}