Revert "Fix bug in all JS files."

This reverts commit 0ffec094a1.

dist/phaser-arcade-physics.js

@@ -42253,7 +42253,7 @@ var FX = new Class({
                     pipeline = pipeline.pop();
                 }
 
-                if (pipeline) pipeline.controller = fx;
+                pipeline.controller = fx;
 
                 return fx;
             }

dist/phaser-ie9.js

@@ -42253,7 +42253,7 @@ var FX = new Class({
                     pipeline = pipeline.pop();
                 }
 
-                if (pipeline) pipeline.controller = fx;
+                pipeline.controller = fx;
 
                 return fx;
             }

dist/phaser.esm.js

@@ -42241,7 +42241,7 @@ var FX = new Class({
                     pipeline = pipeline.pop();
                 }
 
-                if (pipeline) pipeline.controller = fx;
+                pipeline.controller = fx;
 
                 return fx;
             }

dist/phaser.js

@@ -42253,7 +42253,7 @@ var FX = new Class({
                     pipeline = pipeline.pop();
                 }
 
-                if (pipeline) pipeline.controller = fx;
+                pipeline.controller = fx;
 
                 return fx;
             }

plugins/spine/dist/SpineCanvasPlugin.js

@@ -21167,7 +21167,7 @@ var FX = new Class({
                     pipeline = pipeline.pop();
                 }
 
-                if (pipeline) pipeline.controller = fx;
+                pipeline.controller = fx;
 
                 return fx;
             }

plugins/spine/dist/SpineCanvasPluginDebug.js

@@ -20856,7 +20856,7 @@ var FX = new Class({
                     pipeline = pipeline.pop();
                 }
 
-                if (pipeline) pipeline.controller = fx;
+                pipeline.controller = fx;
 
                 return fx;
             }

plugins/spine/dist/SpinePlugin.js

@@ -24000,7 +24000,7 @@ var FX = new Class({
                     pipeline = pipeline.pop();
                 }
 
-                if (pipeline) pipeline.controller = fx;
+                pipeline.controller = fx;
 
                 return fx;
             }

plugins/spine/dist/SpinePluginDebug.js

@@ -24202,7 +24202,7 @@ var FX = new Class({
                     pipeline = pipeline.pop();
                 }
 
-                if (pipeline) pipeline.controller = fx;
+                pipeline.controller = fx;
 
                 return fx;
             }

plugins/spine/dist/SpineWebGLPlugin.js

@@ -23501,7 +23501,7 @@ var FX = new Class({
                     pipeline = pipeline.pop();
                 }
 
-                if (pipeline) pipeline.controller = fx;
+                pipeline.controller = fx;
 
                 return fx;
             }

plugins/spine/dist/SpineWebGLPluginDebug.js

@@ -23196,7 +23196,7 @@ var FX = new Class({
                     pipeline = pipeline.pop();
                 }
 
-                if (pipeline) pipeline.controller = fx;
+                pipeline.controller = fx;
 
                 return fx;
             }

plugins/spine4.1/dist/SpineCanvasPlugin.js

@@ -22218,7 +22218,7 @@ var FX = new Class({
                     pipeline = pipeline.pop();
                 }
 
-                if (pipeline) pipeline.controller = fx;
+                pipeline.controller = fx;
 
                 return fx;
             }

plugins/spine4.1/dist/SpinePluginDebug.js

@@ -34952,7 +34952,7 @@ var FX = new Class({
                     pipeline = pipeline.pop();
                 }
 
-                if (pipeline) pipeline.controller = fx;
+                pipeline.controller = fx;
 
                 return fx;
             }

plugins/spine4.1/dist/SpineWebGLPlugin.js

@@ -24960,7 +24960,7 @@ var FX = new Class({
                     pipeline = pipeline.pop();
                 }
 
-                if (pipeline) pipeline.controller = fx;
+                pipeline.controller = fx;
 
                 return fx;
             }

src/gameobjects/components/FX.js

@@ -10,8 +10,7 @@ var SpliceOne = require('../../utils/array/SpliceOne');
 
 /**
  * @classdesc
- * The FX Component features a set of methods used for applying a range of
+ * The FX Component features a set of methods used for applying a range of special built-in effects to a Game Object.
- * special built-in effects to a Game Object.
  *
  * The effects include the following:
  *
@@ -30,8 +29,7 @@ var SpliceOne = require('../../utils/array/SpliceOne');
  * * Vignette
  * * Wipe / Reveal
  *
- * All Game Objects support Post FX. These are effects applied after the Game
+ * All Game Objects support Post FX. These are effects applied after the Game Object has been rendered.
- * Object has been rendered.
  *
  * Texture-based Game Objects also support Pre FX, including:
  *
@@ -44,31 +42,25 @@ var SpliceOne = require('../../utils/array/SpliceOne');
  *
  * And any Game Object that extends the above.
  *
- * The difference between Pre FX and Post FX are that all Post FX take place in
+ * The difference between Pre FX and Post FX are that all Post FX take place in a canvas (renderer) sized frame buffer,
- * a canvas (renderer) sized frame buffer, after the Game Object has been
+ * after the Game Object has been rendered. Pre FX, however, take place in a texture sized frame buffer, which is sized
- * rendered. Pre FX, however, take place in a texture sized frame buffer, which
+ * based on the Game Object itself. The end result is then composited back to the main game canvas. For intensive effects,
- * is sized based on the Game Object itself. The end result is then composited
+ * such as blur, bloom or glow, which can require many iterations, this is a much more efficient way to apply the effect,
- * back to the main game canvas. For intensive effects, such as blur, bloom or
+ * as only it only has to work on a Game Object sized texture and not all pixels in the canvas.
- * glow, which can require many iterations, this is a much more efficient way to
- * apply the effect, as only it only has to work on a Game Object sized texture
- * and not all pixels in the canvas.
  *
  * In short, you should always try and use a Pre FX if you can.
  *
- * Due to the way that FX work they can be stacked-up. For example, you can
+ * Due to the way that FX work they can be stacked-up. For example, you can apply a blur to a Game Object, then apply
- * apply a blur to a Game Object, then apply a bloom effect to the same Game
+ * a bloom effect to the same Game Object. The bloom effect will be applied to the blurred texture, not the original.
- * Object. The bloom effect will be applied to the blurred texture, not the
+ * Keep the order in mind when stacking effects.
- * original. Keep the order in mind when stacking effects.
  *
  * All effects are WebGL only and do not have canvas counterparts.
  *
- * As you can appreciate, some effects are more expensive than others. For
+ * As you can appreciate, some effects are more expensive than others. For example, a bloom effect is going to be more
- * example, a bloom effect is going to be more expensive than a simple color
+ * expensive than a simple color matrix effect, so please consider using them wisely and performance test your target
- * matrix effect, so please consider using them wisely and performance test your
+ * platforms early on in production.
- * target platforms early on in production.
  *
- * This component is created automatically by the `PostPipeline` class and does
+ * This component is created automatically by the `PostPipeline` class and does not need to be instantiated directly.
- * not need to be instantiated directly.
  *
  * @class FX
  * @memberof Phaser.GameObjects.Components
@@ -76,15 +68,15 @@ var SpliceOne = require('../../utils/array/SpliceOne');
  * @since 3.60.0
  * @webglOnly
  *
- * @param {Phaser.GameObjects.GameObject} gameObject - A reference to the Game
+ * @param {Phaser.GameObjects.GameObject} gameObject - A reference to the Game Object that owns this FX Component.
- *     Object that owns this FX Component.
  * @param {boolean} isPost - Is this a Pre or Post FX Component?
  */
 var FX = new Class({
 
     initialize:
 
-      function FX(gameObject, isPost) {
+    function FX (gameObject, isPost)
+    {
         /**
          * A reference to the Game Object that owns this FX Component.
          *
@@ -164,15 +156,13 @@ var FX = new Class({
      * @webglOnly
      * @since 3.60.0
      *
-   * @param {number} [padding=0] - The amount of padding to add to this Game
+     * @param {number} [padding=0] - The amount of padding to add to this Game Object.
-   *     Object.
      *
      * @return {this} This Game Object instance.
      */
-  setPadding: function(padding) {
+    setPadding: function (padding)
-    if (padding === undefined) {
+    {
-      padding = 0;
+        if (padding === undefined) { padding = 0; }
-    }
 
         this.padding = padding;
 
@@ -180,73 +170,73 @@ var FX = new Class({
     },
 
     /**
-   * This callback is invoked when this Game Object is copied by a PreFX
+     * This callback is invoked when this Game Object is copied by a PreFX Pipeline.
-   * Pipeline.
      *
      * This happens when the pipeline uses its `copySprite` method.
      *
-   * It's invoked prior to the copy, allowing you to set shader uniforms, etc on
+     * It's invoked prior to the copy, allowing you to set shader uniforms, etc on the pipeline.
-   * the pipeline.
      *
      * @method Phaser.GameObjects.Components.FX#onFXCopy
      * @since 3.60.0
      *
-   * @param {Phaser.Renderer.WebGL.Pipelines.PreFXPipeline} pipeline - The PreFX
+     * @param {Phaser.Renderer.WebGL.Pipelines.PreFXPipeline} pipeline - The PreFX Pipeline that invoked this callback.
-   *     Pipeline that invoked this callback.
      */
-  onFXCopy: function() {},
+    onFXCopy: function ()
+    {
+    },
 
     /**
-   * This callback is invoked when this Game Object is rendered by a PreFX
+     * This callback is invoked when this Game Object is rendered by a PreFX Pipeline.
-   * Pipeline.
      *
      * This happens when the pipeline uses its `drawSprite` method.
      *
-   * It's invoked prior to the draw, allowing you to set shader uniforms, etc on
+     * It's invoked prior to the draw, allowing you to set shader uniforms, etc on the pipeline.
-   * the pipeline.
      *
      * @method Phaser.GameObjects.Components.FX#onFX
      * @since 3.60.0
      *
-   * @param {Phaser.Renderer.WebGL.Pipelines.PreFXPipeline} pipeline - The PreFX
+     * @param {Phaser.Renderer.WebGL.Pipelines.PreFXPipeline} pipeline - The PreFX Pipeline that invoked this callback.
-   *     Pipeline that invoked this callback.
      */
-  onFX: function() {},
+    onFX: function ()
+    {
+    },
 
     /**
-   * Enables this FX Component and applies the FXPipeline to the parent Game
+     * Enables this FX Component and applies the FXPipeline to the parent Game Object.
-   * Object.
      *
-   * This is called automatically whenever you call a method such as `addBloom`,
+     * This is called automatically whenever you call a method such as `addBloom`, etc.
-   * etc.
      *
-   * You can check the `enabled` property to see if the Game Object is already
+     * You can check the `enabled` property to see if the Game Object is already enabled, or not.
-   * enabled, or not.
      *
      * This only applies to Pre FX. Post FX are always enabled.
      *
      * @method Phaser.GameObjects.Components.FX#enable
      * @since 3.60.0
      *
-   * @param {number} [padding=0] - The amount of padding to add to this Game
+     * @param {number} [padding=0] - The amount of padding to add to this Game Object.
-   *     Object.
      */
-  enable: function(padding) {
+    enable: function (padding)
-    if (this.isPost) {
+    {
+        if (this.isPost)
+        {
             return;
         }
 
         var renderer = this.gameObject.scene.sys.renderer;
 
-    if (renderer && renderer.pipelines) {
+        if (renderer && renderer.pipelines)
+        {
             this.gameObject.pipeline = renderer.pipelines.FX_PIPELINE;
 
-      if (padding !== undefined) {
+            if (padding !== undefined)
+            {
                 this.padding = padding;
             }
 
             this.enabled = true;
-    } else {
+        }
+        else
+        {
             this.enabled = false;
         }
     },
@@ -265,13 +255,18 @@ var FX = new Class({
      *
      * @return {this} This Game Object instance.
      */
-  clear: function() {
+    clear: function ()
-    if (this.isPost) {
+    {
+        if (this.isPost)
+        {
             this.gameObject.resetPostPipeline(true);
-    } else {
+        }
+        else
+        {
             var list = this.list;
 
-      for (var i = 0; i < list.length; i++) {
+            for (var i = 0; i < list.length; i++)
+            {
                 list[i].destroy();
             }
 
@@ -294,25 +289,29 @@ var FX = new Class({
      * @generic {Phaser.FX.Controller} T
      * @genericUse {T} - [fx]
      *
-   * @param {Phaser.FX.Controller} fx - The FX Controller to remove from this FX
+     * @param {Phaser.FX.Controller} fx - The FX Controller to remove from this FX Component.
-   *     Component.
      *
      * @return {this} This Game Object instance.
      */
-  remove: function(fx) {
+    remove: function (fx)
+    {
         var i;
 
-    if (this.isPost) {
+        if (this.isPost)
+        {
             var pipelines = this.gameObject.getPostPipeline(String(fx.type));
 
-      if (!Array.isArray(pipelines)) {
+            if (!Array.isArray(pipelines))
+            {
                 pipelines = [ pipelines ];
             }
 
-      for (i = 0; i < pipelines.length; i++) {
+            for (i = 0; i < pipelines.length; i++)
+            {
                 var pipeline = pipelines[i];
 
-        if (pipeline.controller === fx) {
+                if (pipeline.controller === fx)
+                {
                     this.gameObject.removePostPipeline(pipeline);
 
                     fx.destroy();
@@ -320,11 +319,15 @@ var FX = new Class({
                     break;
                 }
             }
-    } else {
+        }
+        else
+        {
             var list = this.list;
 
-      for (i = 0; i < list.length; i++) {
+            for (i = 0; i < list.length; i++)
-        if (list[i] === fx) {
+            {
+                if (list[i] === fx)
+                {
                     SpliceOne(list, i);
 
                     fx.destroy();
@@ -338,34 +341,33 @@ var FX = new Class({
     /**
      * Disables this FX Component.
      *
-   * This will reset the pipeline on the Game Object that owns this component
+     * This will reset the pipeline on the Game Object that owns this component back to its
-   * back to its default and flag this component as disabled.
+     * default and flag this component as disabled.
      *
-   * You can re-enable it again by calling `enable` for Pre FX or by adding an
+     * You can re-enable it again by calling `enable` for Pre FX or by adding an FX for Post FX.
-   * FX for Post FX.
      *
      * Optionally, set `clear` to destroy all current FX Controllers.
      *
      * @method Phaser.GameObjects.Components.FX#disable
      * @since 3.60.0
      *
-   * @param {boolean} [clear=false] - Destroy and remove all FX Controllers that
+     * @param {boolean} [clear=false] - Destroy and remove all FX Controllers that are part of this component.
-   *     are part of this component.
      *
      * @return {this} This Game Object instance.
      */
-  disable: function(clear) {
+    disable: function (clear)
-    if (clear === undefined) {
+    {
-      clear = false;
+        if (clear === undefined) { clear = false; }
-    }
 
-    if (!this.isPost) {
+        if (!this.isPost)
+        {
             this.gameObject.resetPipeline();
         }
 
         this.enabled = false;
 
-    if (clear) {
+        if (clear)
+        {
             this.clear();
         }
 
@@ -375,9 +377,9 @@ var FX = new Class({
     /**
      * Adds the given FX Controler to this FX Component.
      *
-   * Note that adding an FX Controller does not remove any existing FX. They all
+     * Note that adding an FX Controller does not remove any existing FX. They all stack-up
-   * stack-up on-top of each other. If you don't want this, make sure to call
+     * on-top of each other. If you don't want this, make sure to call either `remove` or
-   * either `remove` or `clear` first.
+     * `clear` first.
      *
      * @method Phaser.GameObjects.Components.FX#add
      * @since 3.60.0
@@ -385,32 +387,39 @@ var FX = new Class({
      * @generic {Phaser.FX.Controller} T
      * @genericUse {T} - [fx]
      *
-   * @param {Phaser.FX.Controller} fx - The FX Controller to add to this FX
+     * @param {Phaser.FX.Controller} fx - The FX Controller to add to this FX Component.
-   *     Component.
+     * @param {object} [config] - Optional configuration object that is passed to the pipeline during instantiation.
-   * @param {object} [config] - Optional configuration object that is passed to
-   *     the pipeline during instantiation.
      *
      * @return {Phaser.FX.Controller} The FX Controller.
      */
-  add: function(fx, config) {
+    add: function (fx, config)
-    if (this.isPost) {
+    {
+        if (this.isPost)
+        {
             var type = String(fx.type);
 
             this.gameObject.setPostPipeline(type, config);
 
             var pipeline = this.gameObject.getPostPipeline(type);
 
-      if (pipeline) {
+            if (pipeline)
-        if (Array.isArray(pipeline)) {
+            {
+                if (Array.isArray(pipeline))
+                {
                     pipeline = pipeline.pop();
                 }
 
-        if (pipeline) pipeline.controller = fx;
+                if (pipeline) {
+                    pipeline.controller = fx;
+                }
 
                 return fx;
             }
-    } else {
+        }
-      if (!this.enabled) {
+        else
+        {
+            if (!this.enabled)
+            {
                 this.enable();
             }
 
@@ -423,47 +432,34 @@ var FX = new Class({
     /**
      * Adds a Glow effect.
      *
-   * The glow effect is a visual technique that creates a soft, luminous halo
+     * The glow effect is a visual technique that creates a soft, luminous halo around game objects,
-   * around game objects, characters, or UI elements. This effect is used to
+     * characters, or UI elements. This effect is used to emphasize importance, enhance visual appeal,
-   * emphasize importance, enhance visual appeal, or convey a sense of energy,
+     * or convey a sense of energy, magic, or otherworldly presence. The effect can also be set on
-   * magic, or otherworldly presence. The effect can also be set on the inside
+     * the inside of the Game Object. The color and strength of the glow can be modified.
-   * of the Game Object. The color and strength of the glow can be modified.
      *
      * @method Phaser.GameObjects.Components.FX#addGlow
      * @since 3.60.0
      *
-   * @param {number} [color=0xffffff] - The color of the glow effect as a number
+     * @param {number} [color=0xffffff] - The color of the glow effect as a number value.
-   *     value.
+     * @param {number} [outerStrength=4] - The strength of the glow outward from the edge of the Sprite.
-   * @param {number} [outerStrength=4] - The strength of the glow outward from
+     * @param {number} [innerStrength=0] - The strength of the glow inward from the edge of the Sprite.
-   *     the edge of the Sprite.
+     * @param {boolean} [knockout=false] - If `true` only the glow is drawn, not the texture itself.
-   * @param {number} [innerStrength=0] - The strength of the glow inward from
+     * @param {number} [quality=0.1] - Only available for PostFX. Sets the quality of this Glow effect. Default is 0.1. Cannot be changed post-creation.
-   *     the edge of the Sprite.
+     * @param {number} [distance=10] - Only available for PostFX. Sets the distance of this Glow effect. Default is 10. Cannot be changed post-creation.
-   * @param {boolean} [knockout=false] - If `true` only the glow is drawn, not
-   *     the texture itself.
-   * @param {number} [quality=0.1] - Only available for PostFX. Sets the quality
-   *     of this Glow effect. Default is 0.1. Cannot be changed post-creation.
-   * @param {number} [distance=10] - Only available for PostFX. Sets the
-   *     distance of this Glow effect. Default is 10. Cannot be changed
-   *     post-creation.
      *
      * @return {Phaser.FX.Glow} The Glow FX Controller.
      */
-  addGlow: function(
+    addGlow: function (color, outerStrength, innerStrength, knockout, quality, distance)
-      color, outerStrength, innerStrength, knockout, quality, distance) {
+    {
-    return this.add(
+        return this.add(new Effects.Glow(this.gameObject, color, outerStrength, innerStrength, knockout), { quality: quality, distance: distance });
-        new Effects.Glow(
-            this.gameObject, color, outerStrength, innerStrength, knockout),
-        {quality: quality, distance: distance});
     },
 
     /**
      * Adds a Shadow effect.
      *
-   * The shadow effect is a visual technique used to create the illusion of
+     * The shadow effect is a visual technique used to create the illusion of depth and realism by adding darker,
-   * depth and realism by adding darker, offset silhouettes or shapes beneath
+     * offset silhouettes or shapes beneath game objects, characters, or environments. These simulated shadows
-   * game objects, characters, or environments. These simulated shadows help to
+     * help to enhance the visual appeal and immersion, making the 2D game world appear more dynamic and three-dimensional.
-   * enhance the visual appeal and immersion, making the 2D game world appear
-   * more dynamic and three-dimensional.
      *
      * @method Phaser.GameObjects.Components.FX#addShadow
      * @since 3.60.0
@@ -473,26 +469,23 @@ var FX = new Class({
      * @param {number} [decay=0.1] - The amount of decay for shadow effect.
      * @param {number} [power=1] - The power of the shadow effect.
      * @param {number} [color=0x000000] - The color of the shadow.
-   * @param {number} [samples=6] - The number of samples that the shadow effect
+     * @param {number} [samples=6] - The number of samples that the shadow effect will run for. An integer between 1 and 12.
-   *     will run for. An integer between 1 and 12.
      * @param {number} [intensity=1] - The intensity of the shadow effect.
      *
      * @return {Phaser.FX.Shadow} The Shadow FX Controller.
      */
-  addShadow: function(x, y, decay, power, color, samples, intensity) {
+    addShadow: function (x, y, decay, power, color, samples, intensity)
-    return this.add(new Effects.Shadow(
+    {
-        this.gameObject, x, y, decay, power, color, samples, intensity));
+        return this.add(new Effects.Shadow(this.gameObject, x, y, decay, power, color, samples, intensity));
     },
 
     /**
      * Adds a Pixelate effect.
      *
-   * The pixelate effect is a visual technique that deliberately reduces the
+     * The pixelate effect is a visual technique that deliberately reduces the resolution or detail of an image,
-   * resolution or detail of an image, creating a blocky or mosaic appearance
+     * creating a blocky or mosaic appearance composed of large, visible pixels. This effect can be used for stylistic
-   * composed of large, visible pixels. This effect can be used for stylistic
+     * purposes, as a homage to retro gaming, or as a means to obscure certain elements within the game, such as
-   * purposes, as a homage to retro gaming, or as a means to obscure certain
+     * during a transition or to censor specific content.
-   * elements within the game, such as during a transition or to censor specific
-   * content.
      *
      * @method Phaser.GameObjects.Components.FX#addPixelate
      * @since 3.60.0
@@ -501,44 +494,40 @@ var FX = new Class({
      *
      * @return {Phaser.FX.Pixelate} The Pixelate FX Controller.
      */
-  addPixelate: function(amount) {
+    addPixelate: function (amount)
+    {
         return this.add(new Effects.Pixelate(this.gameObject, amount));
     },
 
     /**
      * Adds a Vignette effect.
      *
-   * The vignette effect is a visual technique where the edges of the screen, or
+     * The vignette effect is a visual technique where the edges of the screen, or a Game Object, gradually darken or blur,
-   * a Game Object, gradually darken or blur, creating a frame-like appearance.
+     * creating a frame-like appearance. This effect is used to draw the player's focus towards the central action or subject,
-   * This effect is used to draw the player's focus towards the central action
+     * enhance immersion, and provide a cinematic or artistic quality to the game's visuals.
-   * or subject, enhance immersion, and provide a cinematic or artistic quality
-   * to the game's visuals.
      *
      * @method Phaser.GameObjects.Components.FX#addVignette
      * @since 3.60.0
      *
-   * @param {number} [x=0.5] - The horizontal offset of the vignette effect.
+     * @param {number} [x=0.5] - The horizontal offset of the vignette effect. This value is normalized to the range 0 to 1.
-   *     This value is normalized to the range 0 to 1.
+     * @param {number} [y=0.5] - The vertical offset of the vignette effect. This value is normalized to the range 0 to 1.
-   * @param {number} [y=0.5] - The vertical offset of the vignette effect. This
+     * @param {number} [radius=0.5] - The radius of the vignette effect. This value is normalized to the range 0 to 1.
-   *     value is normalized to the range 0 to 1.
-   * @param {number} [radius=0.5] - The radius of the vignette effect. This
-   *     value is normalized to the range 0 to 1.
      * @param {number} [strength=0.5] - The strength of the vignette effect.
      *
      * @return {Phaser.FX.Vignette} The Vignette FX Controller.
      */
-  addVignette: function(x, y, radius, strength) {
+    addVignette: function (x, y, radius, strength)
-    return this.add(
+    {
-        new Effects.Vignette(this.gameObject, x, y, radius, strength));
+        return this.add(new Effects.Vignette(this.gameObject, x, y, radius, strength));
     },
 
     /**
      * Adds a Shine effect.
      *
-   * The shine effect is a visual technique that simulates the appearance of
+     * The shine effect is a visual technique that simulates the appearance of reflective
-   * reflective or glossy surfaces by passing a light beam across a Game Object.
+     * or glossy surfaces by passing a light beam across a Game Object. This effect is used to
-   * This effect is used to enhance visual appeal, emphasize certain features,
+     * enhance visual appeal, emphasize certain features, and create a sense of depth or
-   * and create a sense of depth or material properties.
+     * material properties.
      *
      * @method Phaser.GameObjects.Components.FX#addShine
      * @since 3.60.0
@@ -546,89 +535,74 @@ var FX = new Class({
      * @param {number} [speed=0.5] - The speed of the Shine effect.
      * @param {number} [lineWidth=0.5] - The line width of the Shine effect.
      * @param {number} [gradient=3] - The gradient of the Shine effect.
-   * @param {boolean} [reveal=false] - Does this Shine effect reveal or get
+     * @param {boolean} [reveal=false] - Does this Shine effect reveal or get added to its target?
-   *     added to its target?
      *
      * @return {Phaser.FX.Shine} The Shine FX Controller.
      */
-  addShine: function(speed, lineWidth, gradient, reveal) {
+    addShine: function (speed, lineWidth, gradient, reveal)
-    return this.add(
+    {
-        new Effects.Shine(this.gameObject, speed, lineWidth, gradient, reveal));
+        return this.add(new Effects.Shine(this.gameObject, speed, lineWidth, gradient, reveal));
     },
 
     /**
      * Adds a Blur effect.
      *
-   * A Gaussian blur is the result of blurring an image by a Gaussian function.
+     * A Gaussian blur is the result of blurring an image by a Gaussian function. It is a widely used effect,
-   * It is a widely used effect, typically to reduce image noise and reduce
+     * typically to reduce image noise and reduce detail. The visual effect of this blurring technique is a
-   * detail. The visual effect of this blurring technique is a smooth blur
+     * smooth blur resembling that of viewing the image through a translucent screen, distinctly different
-   * resembling that of viewing the image through a translucent screen,
+     * from the bokeh effect produced by an out-of-focus lens or the shadow of an object under usual illumination.
-   * distinctly different from the bokeh effect produced by an out-of-focus lens
-   * or the shadow of an object under usual illumination.
      *
      * @method Phaser.GameObjects.Components.FX#addBlur
      * @since 3.60.0
      *
-   * @param {number} [quality=0] - The quality of the blur effect. Can be either
+     * @param {number} [quality=0] - The quality of the blur effect. Can be either 0 for Low Quality, 1 for Medium Quality or 2 for High Quality.
-   *     0 for Low Quality, 1 for Medium Quality or 2 for High Quality.
      * @param {number} [x=2] - The horizontal offset of the blur effect.
      * @param {number} [y=2] - The vertical offset of the blur effect.
      * @param {number} [strength=1] - The strength of the blur effect.
      * @param {number} [color=0xffffff] - The color of the blur, as a hex value.
-   * @param {number} [steps=4] - The number of steps to run the blur effect for.
+     * @param {number} [steps=4] - The number of steps to run the blur effect for. This value should always be an integer.
-   *     This value should always be an integer.
      *
      * @return {Phaser.FX.Blur} The Blur FX Controller.
      */
-  addBlur: function(quality, x, y, strength, color, steps) {
+    addBlur: function (quality, x, y, strength, color, steps)
-    return this.add(new Effects.Blur(
+    {
-        this.gameObject, quality, x, y, strength, color, steps));
+        return this.add(new Effects.Blur(this.gameObject, quality, x, y, strength, color, steps));
     },
 
     /**
      * Adds a Gradient effect.
      *
-   * The gradient overlay effect is a visual technique where a smooth color
+     * The gradient overlay effect is a visual technique where a smooth color transition is applied over Game Objects,
-   * transition is applied over Game Objects, such as sprites or UI components.
+     * such as sprites or UI components. This effect is used to enhance visual appeal, emphasize depth, or create
-   * This effect is used to enhance visual appeal, emphasize depth, or create
+     * stylistic and atmospheric variations. It can also be utilized to convey information, such as representing
-   * stylistic and atmospheric variations. It can also be utilized to convey
+     * progress or health status through color changes.
-   * information, such as representing progress or health status through color
-   * changes.
      *
      * @method Phaser.GameObjects.Components.FX#addGradient
      * @since 3.60.0
      *
-   * @param {number} [color1=0xff0000] - The first gradient color, given as a
+     * @param {number} [color1=0xff0000] - The first gradient color, given as a number value.
-   *     number value.
+     * @param {number} [color2=0x00ff00] - The second gradient color, given as a number value.
-   * @param {number} [color2=0x00ff00] - The second gradient color, given as a
-   *     number value.
      * @param {number} [alpha=0.2] - The alpha value of the gradient effect.
-   * @param {number} [fromX=0] - The horizontal position the gradient will start
+     * @param {number} [fromX=0] - The horizontal position the gradient will start from. This value is normalized, between 0 and 1, and is not in pixels.
-   *     from. This value is normalized, between 0 and 1, and is not in pixels.
+     * @param {number} [fromY=0] - The vertical position the gradient will start from. This value is normalized, between 0 and 1, and is not in pixels.
-   * @param {number} [fromY=0] - The vertical position the gradient will start
+     * @param {number} [toX=0] - The horizontal position the gradient will end at. This value is normalized, between 0 and 1, and is not in pixels.
-   *     from. This value is normalized, between 0 and 1, and is not in pixels.
+     * @param {number} [toY=1] - The vertical position the gradient will end at. This value is normalized, between 0 and 1, and is not in pixels.
-   * @param {number} [toX=0] - The horizontal position the gradient will end at.
+     * @param {number} [size=0] - How many 'chunks' the gradient is divided in to, as spread over the entire height of the texture. Leave this at zero for a smooth gradient, or set higher for a more retro chunky effect.
-   *     This value is normalized, between 0 and 1, and is not in pixels.
-   * @param {number} [toY=1] - The vertical position the gradient will end at.
-   *     This value is normalized, between 0 and 1, and is not in pixels.
-   * @param {number} [size=0] - How many 'chunks' the gradient is divided in to,
-   *     as spread over the entire height of the texture. Leave this at zero for
-   *     a smooth gradient, or set higher for a more retro chunky effect.
      *
      * @return {Phaser.FX.Gradient} The Gradient FX Controller.
      */
-  addGradient: function(color1, color2, alpha, fromX, fromY, toX, toY, size) {
+    addGradient: function (color1, color2, alpha, fromX, fromY, toX, toY, size)
-    return this.add(new Effects.Gradient(
+    {
-        this.gameObject, color1, color2, alpha, fromX, fromY, toX, toY, size));
+        return this.add(new Effects.Gradient(this.gameObject, color1, color2, alpha, fromX, fromY, toX, toY, size));
     },
 
     /**
      * Adds a Bloom effect.
      *
-   * Bloom is an effect used to reproduce an imaging artifact of real-world
+     * Bloom is an effect used to reproduce an imaging artifact of real-world cameras.
-   * cameras. The effect produces fringes of light extending from the borders of
+     * The effect produces fringes of light extending from the borders of bright areas in an image,
-   * bright areas in an image, contributing to the illusion of an extremely
+     * contributing to the illusion of an extremely bright light overwhelming the
-   * bright light overwhelming the camera or eye capturing the scene.
+     * camera or eye capturing the scene.
      *
      * @method Phaser.GameObjects.Components.FX#addBloom
      * @since 3.60.0
@@ -636,202 +610,173 @@ var FX = new Class({
      * @param {number} [color] - The color of the Bloom, as a hex value.
      * @param {number} [offsetX=1] - The horizontal offset of the bloom effect.
      * @param {number} [offsetY=1] - The vertical offset of the bloom effect.
-   * @param {number} [blurStrength=1] - The strength of the blur process of the
+     * @param {number} [blurStrength=1] - The strength of the blur process of the bloom effect.
-   *     bloom effect.
+     * @param {number} [strength=1] - The strength of the blend process of the bloom effect.
-   * @param {number} [strength=1] - The strength of the blend process of the
+     * @param {number} [steps=4] - The number of steps to run the Bloom effect for. This value should always be an integer.
-   *     bloom effect.
-   * @param {number} [steps=4] - The number of steps to run the Bloom effect
-   *     for. This value should always be an integer.
      *
      * @return {Phaser.FX.Bloom} The Bloom FX Controller.
      */
-  addBloom: function(color, offsetX, offsetY, blurStrength, strength, steps) {
+    addBloom: function (color, offsetX, offsetY, blurStrength, strength, steps)
-    return this.add(new Effects.Bloom(
+    {
-        this.gameObject, color, offsetX, offsetY, blurStrength, strength,
+        return this.add(new Effects.Bloom(this.gameObject, color, offsetX, offsetY, blurStrength, strength, steps));
-        steps));
     },
 
     /**
      * Adds a ColorMatrix effect.
      *
-   * The color matrix effect is a visual technique that involves manipulating
+     * The color matrix effect is a visual technique that involves manipulating the colors of an image
-   * the colors of an image or scene using a mathematical matrix. This process
+     * or scene using a mathematical matrix. This process can adjust hue, saturation, brightness, and contrast,
-   * can adjust hue, saturation, brightness, and contrast, allowing developers
+     * allowing developers to create various stylistic appearances or mood settings within the game.
-   * to create various stylistic appearances or mood settings within the game.
+     * Common applications include simulating different lighting conditions, applying color filters,
-   * Common applications include simulating different lighting conditions,
+     * or achieving a specific visual style.
-   * applying color filters, or achieving a specific visual style.
      *
      * @method Phaser.GameObjects.Components.FX#addColorMatrix
      * @since 3.60.0
      *
      * @return {Phaser.FX.ColorMatrix} The ColorMatrix FX Controller.
      */
-  addColorMatrix: function() {
+    addColorMatrix: function ()
+    {
         return this.add(new Effects.ColorMatrix(this.gameObject));
     },
 
     /**
      * Adds a Circle effect.
      *
-   * This effect will draw a circle around the texture of the Game Object,
+     * This effect will draw a circle around the texture of the Game Object, effectively masking off
-   * effectively masking off any area outside of the circle without the need for
+     * any area outside of the circle without the need for an actual mask. You can control the thickness
-   * an actual mask. You can control the thickness of the circle, the color of
+     * of the circle, the color of the circle and the color of the background, should the texture be
-   * the circle and the color of the background, should the texture be
+     * transparent. You can also control the feathering applied to the circle, allowing for a harsh or soft edge.
-   * transparent. You can also control the feathering applied to the circle,
-   * allowing for a harsh or soft edge.
      *
-   * Please note that adding this effect to a Game Object will not change the
+     * Please note that adding this effect to a Game Object will not change the input area or physics body of
-   * input area or physics body of the Game Object, should it have one.
+     * the Game Object, should it have one.
      *
      * @method Phaser.GameObjects.Components.FX#addCircle
      * @since 3.60.0
      *
-   * @param {number} [thickness=8] - The width of the circle around the texture,
+     * @param {number} [thickness=8] - The width of the circle around the texture, in pixels.
-   *     in pixels.
+     * @param {number} [color=0xfeedb6] - The color of the circular ring, given as a number value.
-   * @param {number} [color=0xfeedb6] - The color of the circular ring, given as
+     * @param {number} [backgroundColor=0xff0000] - The color of the background, behind the texture, given as a number value.
-   *     a number value.
+     * @param {number} [scale=1] - The scale of the circle. The default scale is 1, which is a circle the full size of the underlying texture.
-   * @param {number} [backgroundColor=0xff0000] - The color of the background,
+     * @param {number} [feather=0.005] - The amount of feathering to apply to the circle from the ring.
-   *     behind the texture, given as a number value.
-   * @param {number} [scale=1] - The scale of the circle. The default scale is
-   *     1, which is a circle the full size of the underlying texture.
-   * @param {number} [feather=0.005] - The amount of feathering to apply to the
-   *     circle from the ring.
      *
      * @return {Phaser.FX.Circle} The Circle FX Controller.
      */
-  addCircle: function(thickness, color, backgroundColor, scale, feather) {
+    addCircle: function (thickness, color, backgroundColor, scale, feather)
-    return this.add(new Effects.Circle(
+    {
-        this.gameObject, thickness, color, backgroundColor, scale, feather));
+        return this.add(new Effects.Circle(this.gameObject, thickness, color, backgroundColor, scale, feather));
     },
 
     /**
      * Adds a Barrel effect.
      *
-   * A barrel effect allows you to apply either a 'pinch' or 'expand' distortion
+     * A barrel effect allows you to apply either a 'pinch' or 'expand' distortion to
-   * to a Game Object. The amount of the effect can be modified in real-time.
+     * a Game Object. The amount of the effect can be modified in real-time.
      *
      * @method Phaser.GameObjects.Components.FX#addBarrel
      * @since 3.60.0
      *
-   * @param {number} [amount=1] - The amount of distortion applied to the barrel
+     * @param {number} [amount=1] - The amount of distortion applied to the barrel effect. A value of 1 is no distortion. Typically keep this within +- 1.
-   *     effect. A value of 1 is no distortion. Typically keep this within +- 1.
      *
      * @return {Phaser.FX.Barrel} The Barrel FX Controller.
      */
-  addBarrel: function(amount) {
+    addBarrel: function (amount)
+    {
         return this.add(new Effects.Barrel(this.gameObject, amount));
     },
 
     /**
      * Adds a Displacement effect.
      *
-   * The displacement effect is a visual technique that alters the position of
+     * The displacement effect is a visual technique that alters the position of pixels in an image
-   * pixels in an image or texture based on the values of a displacement map.
+     * or texture based on the values of a displacement map. This effect is used to create the illusion
-   * This effect is used to create the illusion of depth, surface
+     * of depth, surface irregularities, or distortion in otherwise flat elements. It can be applied to
-   * irregularities, or distortion in otherwise flat elements. It can be applied
+     * characters, objects, or backgrounds to enhance realism, convey movement, or achieve various
-   * to characters, objects, or backgrounds to enhance realism, convey movement,
+     * stylistic appearances.
-   * or achieve various stylistic appearances.
      *
      * @method Phaser.GameObjects.Components.FX#addDisplacement
      * @since 3.60.0
      *
-   * @param {string} [texture='__WHITE'] - The unique string-based key of the
+     * @param {string} [texture='__WHITE'] - The unique string-based key of the texture to use for displacement, which must exist in the Texture Manager.
-   *     texture to use for displacement, which must exist in the Texture
+     * @param {number} [x=0.005] - The amount of horizontal displacement to apply. A very small float number, such as 0.005.
-   *     Manager.
+     * @param {number} [y=0.005] - The amount of vertical displacement to apply. A very small float number, such as 0.005.
-   * @param {number} [x=0.005] - The amount of horizontal displacement to apply.
-   *     A very small float number, such as 0.005.
-   * @param {number} [y=0.005] - The amount of vertical displacement to apply. A
-   *     very small float number, such as 0.005.
      *
      * @return {Phaser.FX.Displacement} The Displacement FX Controller.
      */
-  addDisplacement: function(texture, x, y) {
+    addDisplacement: function (texture, x, y)
+    {
         return this.add(new Effects.Displacement(this.gameObject, texture, x, y));
     },
 
     /**
      * Adds a Wipe effect.
      *
-   * The wipe or reveal effect is a visual technique that gradually uncovers or
+     * The wipe or reveal effect is a visual technique that gradually uncovers or conceals elements
-   * conceals elements in the game, such as images, text, or scene transitions.
+     * in the game, such as images, text, or scene transitions. This effect is often used to create
-   * This effect is often used to create a sense of progression, reveal hidden
+     * a sense of progression, reveal hidden content, or provide a smooth and visually appealing transition
-   * content, or provide a smooth and visually appealing transition between game
+     * between game states.
-   * states.
      *
-   * You can set both the direction and the axis of the wipe effect. The
+     * You can set both the direction and the axis of the wipe effect. The following combinations are possible:
-   * following combinations are possible:
      *
      * * left to right: direction 0, axis 0
      * * right to left: direction 1, axis 0
      * * top to bottom: direction 1, axis 1
      * * bottom to top: direction 1, axis 0
      *
-   * It is up to you to set the `progress` value yourself, i.e. via a Tween, in
+     * It is up to you to set the `progress` value yourself, i.e. via a Tween, in order to transition the effect.
-   * order to transition the effect.
      *
      * @method Phaser.GameObjects.Components.FX#addWipe
      * @since 3.60.0
      *
-   * @param {number} [wipeWidth=0.1] - The width of the wipe effect. This value
+     * @param {number} [wipeWidth=0.1] - The width of the wipe effect. This value is normalized in the range 0 to 1.
-   *     is normalized in the range 0 to 1.
+     * @param {number} [direction=0] - The direction of the wipe effect. Either 0 or 1. Set in conjunction with the axis property.
-   * @param {number} [direction=0] - The direction of the wipe effect. Either 0
+     * @param {number} [axis=0] - The axis of the wipe effect. Either 0 or 1. Set in conjunction with the direction property.
-   *     or 1. Set in conjunction with the axis property.
-   * @param {number} [axis=0] - The axis of the wipe effect. Either 0 or 1. Set
-   *     in conjunction with the direction property.
      *
      * @return {Phaser.FX.Wipe} The Wipe FX Controller.
      */
-  addWipe: function(wipeWidth, direction, axis) {
+    addWipe: function (wipeWidth, direction, axis)
-    return this.add(
+    {
-        new Effects.Wipe(this.gameObject, wipeWidth, direction, axis));
+        return this.add(new Effects.Wipe(this.gameObject, wipeWidth, direction, axis));
     },
 
     /**
      * Adds a Reveal Wipe effect.
      *
-   * The wipe or reveal effect is a visual technique that gradually uncovers or
+     * The wipe or reveal effect is a visual technique that gradually uncovers or conceals elements
-   * conceals elements in the game, such as images, text, or scene transitions.
+     * in the game, such as images, text, or scene transitions. This effect is often used to create
-   * This effect is often used to create a sense of progression, reveal hidden
+     * a sense of progression, reveal hidden content, or provide a smooth and visually appealing transition
-   * content, or provide a smooth and visually appealing transition between game
+     * between game states.
-   * states.
      *
-   * You can set both the direction and the axis of the wipe effect. The
+     * You can set both the direction and the axis of the wipe effect. The following combinations are possible:
-   * following combinations are possible:
      *
      * * left to right: direction 0, axis 0
      * * right to left: direction 1, axis 0
      * * top to bottom: direction 1, axis 1
      * * bottom to top: direction 1, axis 0
      *
-   * It is up to you to set the `progress` value yourself, i.e. via a Tween, in
+     * It is up to you to set the `progress` value yourself, i.e. via a Tween, in order to transition the effect.
-   * order to transition the effect.
      *
      * @method Phaser.GameObjects.Components.FX#addReveal
      * @since 3.60.0
      *
-   * @param {number} [wipeWidth=0.1] - The width of the wipe effect. This value
+     * @param {number} [wipeWidth=0.1] - The width of the wipe effect. This value is normalized in the range 0 to 1.
-   *     is normalized in the range 0 to 1.
+     * @param {number} [direction=0] - The direction of the wipe effect. Either 0 or 1. Set in conjunction with the axis property.
-   * @param {number} [direction=0] - The direction of the wipe effect. Either 0
+     * @param {number} [axis=0] - The axis of the wipe effect. Either 0 or 1. Set in conjunction with the direction property.
-   *     or 1. Set in conjunction with the axis property.
-   * @param {number} [axis=0] - The axis of the wipe effect. Either 0 or 1. Set
-   *     in conjunction with the direction property.
      *
      * @return {Phaser.FX.Wipe} The Wipe FX Controller.
      */
-  addReveal: function(wipeWidth, direction, axis) {
+    addReveal: function (wipeWidth, direction, axis)
-    return this.add(
+    {
-        new Effects.Wipe(this.gameObject, wipeWidth, direction, axis, true));
+        return this.add(new Effects.Wipe(this.gameObject, wipeWidth, direction, axis, true));
     },
 
     /**
      * Adds a Bokeh effect.
      *
-   * Bokeh refers to a visual effect that mimics the photographic technique of
+     * Bokeh refers to a visual effect that mimics the photographic technique of creating a shallow depth of field.
-   * creating a shallow depth of field. This effect is used to emphasize the
+     * This effect is used to emphasize the game's main subject or action, by blurring the background or foreground
-   * game's main subject or action, by blurring the background or foreground
+     * elements, resulting in a more immersive and visually appealing experience. It is achieved through rendering
-   * elements, resulting in a more immersive and visually appealing experience.
+     * techniques that simulate the out-of-focus areas, giving a sense of depth and realism to the game's graphics.
-   * It is achieved through rendering techniques that simulate the out-of-focus
-   * areas, giving a sense of depth and realism to the game's graphics.
      *
      * See also Tilt Shift.
      *
@@ -844,17 +789,16 @@ var FX = new Class({
      *
      * @return {Phaser.FX.Bokeh} The Bokeh FX Controller.
      */
-  addBokeh: function(radius, amount, contrast) {
+    addBokeh: function (radius, amount, contrast)
-    return this.add(
+    {
-        new Effects.Bokeh(this.gameObject, radius, amount, contrast));
+        return this.add(new Effects.Bokeh(this.gameObject, radius, amount, contrast));
     },
 
     /**
      * Adds a Tilt Shift effect.
      *
-   * This Bokeh effect can also be used to generate a Tilt Shift effect, which
+     * This Bokeh effect can also be used to generate a Tilt Shift effect, which is a technique used to create a miniature
-   * is a technique used to create a miniature effect by blurring everything
+     * effect by blurring everything except a small area of the image. This effect is achieved by blurring the
-   * except a small area of the image. This effect is achieved by blurring the
      * top and bottom elements, while keeping the center area in focus.
      *
      * See also Bokeh.
@@ -871,10 +815,9 @@ var FX = new Class({
      *
      * @return {Phaser.FX.Bokeh} The Bokeh TiltShift FX Controller.
      */
-  addTiltShift: function(radius, amount, contrast, blurX, blurY, strength) {
+    addTiltShift: function (radius, amount, contrast, blurX, blurY, strength)
-    return this.add(new Effects.Bokeh(
+    {
-        this.gameObject, radius, amount, contrast, true, blurX, blurY,
+        return this.add(new Effects.Bokeh(this.gameObject, radius, amount, contrast, true, blurX, blurY, strength));
-        strength));
     },
 
     /**
@@ -885,7 +828,8 @@ var FX = new Class({
      * @method Phaser.GameObjects.Components.FX#destroy
      * @since 3.60.0
      */
-  destroy: function() {
+    destroy: function ()
+    {
         this.clear();
 
         this.gameObject = null;