@playcanvas/web-components 0.11.0 → 0.11.1

package/dist/web-types.json

@@ -1,14 +1,14 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@playcanvas/web-components",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description-markup": "markdown",
   "contributions": {
     "html": {
       "elements": [
         {
           "name": "pc-app",
-          "description": "The AppElement interface provides properties and methods for manipulating\n[`<pc-app>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-app/) elements.\nThe AppElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **progress** - Fired while the application preloads its assets. `loaded` and `total` are asset counts, not bytes, and an asset that fails to load still counts as loaded. Fired at least once per boot, and the final event always has `loaded` equal to `total`. Does not bubble.\n- **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n - **elementFromEntity(entity: _Entity_): __** - Returns the `<pc-entity>` element whose backing entity is `entity`, or `null` if the\nentity was not created by an element of this application - for example, a node inside a\nmodel's instantiated hierarchy, or an entity created through the engine API.\n\n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The AppElement interface provides properties and methods for manipulating\n[`<pc-app>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-app/) elements.\nThe AppElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **progress** - Fired while the application preloads its assets. `loaded` and `total` are asset counts, not bytes, and an asset that fails to load still counts as loaded. Fired at least once per boot, and the final event always has `loaded` equal to `total`. Does not bubble.\n- **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **elementFromEntity(entity: _Entity_): __** - Returns the `<pc-entity>` element whose backing entity is `entity`, or `null` if the\nentity was not created by an element of this application - for example, a node inside a\nmodel's instantiated hierarchy, or an entity created through the engine API.\n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -59,21 +59,11 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
-              {
-                "name": "app",
-                "description": "The PlayCanvas application instance. `null` until the element is ready, and again once it\nhas been removed from the document — await whenReady or the element's `ready()`\npromise before accessing it.",
-                "type": "AppBase | null"
-              },
-              {
-                "name": "loadProgress",
-                "description": "The asset preload progress of the application, as a fraction from 0 to 1. It is 0 until\npreloading begins (and again once the element has been removed from the document), and 1\nonce preloading has finished — including when there was nothing to preload. Read this to\ninitialize a loading UI; subsequent updates arrive via the `progress` event.",
-                "type": "number"
-              },
               {
                 "name": "alpha",
                 "description": "Gets whether the frame buffer has an alpha channel."
@@ -82,10 +72,25 @@
                 "name": "antialias",
                 "description": "Gets whether the frame buffer is anti-aliased."
               },
+              {
+                "name": "app",
+                "description": "The PlayCanvas application instance. `null` until the element is ready, and again once it\nhas been removed from the document — await whenReady or the element's `ready()`\npromise before accessing it.",
+                "type": "AppBase | null"
+              },
               {
                 "name": "backend",
                 "description": "Gets the graphics backend."
               },
+              {
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
+              },
+              {
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
+              },
               {
                 "name": "depthBuffer",
                 "description": "Gets whether the frame buffer has a depth buffer."
@@ -94,6 +99,11 @@
                 "name": "loadingBar",
                 "description": "Gets whether the application shows its built-in loading bar while it boots and preloads\nits assets."
               },
+              {
+                "name": "loadProgress",
+                "description": "The asset preload progress of the application, as a fraction from 0 to 1. It is 0 until\npreloading begins (and again once the element has been removed from the document), and 1\nonce preloading has finished — including when there was nothing to preload. Read this to\ninitialize a loading UI; subsequent updates arrive via the `progress` event.",
+                "type": "number"
+              },
               {
                 "name": "maxPixelRatio",
                 "description": "Gets the cap on the pixel ratio the application renders at."
@@ -101,16 +111,6 @@
               {
                 "name": "stencilBuffer",
                 "description": "Gets whether the frame buffer has a stencil buffer."
-              },
-              {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
-              },
-              {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
               }
             ],
             "events": [
@@ -122,14 +122,14 @@
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-asset",
-          "description": "The AssetElement interface provides properties and methods for manipulating\n[`<pc-asset>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-asset/) elements.\nThe AssetElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\nThe element becomes ready once the containing application has started and the asset is in the\nstate declared by the markup: loaded for preloaded assets (even if loading failed — check the\nasset's `resource`), or registered and awaiting a load for `lazy` assets. Elements inserted\nwhile the application is running are created and registered on insertion, and begin loading\nimmediately unless `lazy`. A `pc-asset` must be a direct child of `pc-app` — elements placed\nelsewhere, or with an unsupported asset type, never become ready.\n\nApart from `lazy`, these attributes are read once when the asset is created, so changing them\nlater has no effect.\n\n---\n\n\n### **Events:**\n - **error** - Fired when the asset fails to load, with the engine's error in `message`. Does not bubble. The element still becomes ready — readiness means the load settled, not that it succeeded.\n- **load** - Fired each time the asset finishes loading, including a `lazy` asset loaded later and any subsequent reloads. Does not bubble — listen on this element, or use a capture-phase listener on an ancestor to observe every asset.\n- **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The AssetElement interface provides properties and methods for manipulating\n[`<pc-asset>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-asset/) elements.\nThe AssetElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\nThe element becomes ready once the containing application has started and the asset is in the\nstate declared by the markup: loaded for preloaded assets (even if loading failed — check the\nasset's `resource`), or registered and awaiting a load for `lazy` assets. Elements inserted\nwhile the application is running are created and registered on insertion, and begin loading\nimmediately unless `lazy`. A `pc-asset` must be a direct child of `pc-app` — elements placed\nelsewhere, or with an unsupported asset type, never become ready.\n\nApart from `lazy`, these attributes are read once when the asset is created, so changing them\nlater has no effect.\n\n---\n\n\n### **Events:**\n - **error** - Fired when the asset fails to load, with the engine's error in `message`. Does not bubble. The element still becomes ready — readiness means the load settled, not that it succeeded.\n- **load** - Fired each time the asset finishes loading, including a `lazy` asset loaded later and any subsequent reloads. Does not bubble — listen on this element, or use a capture-phase listener on an ancestor to observe every asset.\n- **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **get(id: _string_): __** - Returns the Asset created by the `<pc-asset>` element with the given `id`, or\n`undefined` if there is no such element or its asset has not been created yet.\n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -192,7 +192,7 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
@@ -202,10 +202,6 @@
                 "description": "The asset that is loaded. Available once the element is ready — await\nwhenReady or the element's `ready()` promise before accessing it.",
                 "type": "Asset | null"
               },
-              {
-                "name": "lazy",
-                "description": "Gets whether the asset should be loaded lazily."
-              },
               {
                 "name": "closestApp",
                 "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
@@ -215,6 +211,10 @@
                 "name": "closestEntity",
                 "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
                 "type": "EntityElement | null"
+              },
+              {
+                "name": "lazy",
+                "description": "Gets whether the asset should be loaded lazily."
               }
             ],
             "events": [
@@ -231,14 +231,14 @@
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-entity",
-          "description": "The EntityElement interface provides properties and methods for manipulating\n[`<pc-entity>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-entity/) elements.\nThe EntityElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\nThe pointer events below are dispatched by the containing `<pc-app>` element when the pointer\nintersects this entity's geometry. They are only generated while the entity has a listener for\nthem, registered either with addEventListener or with the matching inline `onpointer*`\nattribute.\n\n---\n\n\n### **Events:**\n - **pointerdown** - Fired when a pointer button is pressed over the entity.\n- **pointerenter** - Fired when the pointer moves onto the entity.\n- **pointerleave** - Fired when the pointer moves off the entity.\n- **pointermove** - Fired when the pointer moves over the entity.\n- **pointerup** - Fired when a pointer button is released over the entity.\n- **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The EntityElement interface provides properties and methods for manipulating\n[`<pc-entity>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-entity/) elements.\nThe EntityElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\nThe pointer events below are dispatched by the containing `<pc-app>` element when the pointer\nintersects this entity's geometry. They are only generated while the entity has a listener for\nthem, registered either with addEventListener or with the matching inline `onpointer*`\nattribute.\n\n---\n\n\n### **Events:**\n - **pointerdown** - Fired when a pointer button is pressed over the entity.\n- **pointerenter** - Fired when the pointer moves onto the entity.\n- **pointerleave** - Fired when the pointer moves off the entity.\n- **pointermove** - Fired when the pointer moves over the entity.\n- **pointerup** - Fired when a pointer button is released over the entity.\n- **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -326,20 +326,30 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
               {
-                "name": "entity",
-                "description": "The PlayCanvas entity instance. `null` until the element is ready, and again once it has\nbeen removed from the document — await whenReady or the element's `ready()`\npromise before accessing it.",
-                "type": "Entity | null"
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
+              },
+              {
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
               },
               {
                 "name": "enabled",
                 "description": "Gets the enabled state of the entity."
               },
+              {
+                "name": "entity",
+                "description": "The PlayCanvas entity instance. `null` until the element is ready, and again once it has\nbeen removed from the document — await whenReady or the element's `ready()`\npromise before accessing it.",
+                "type": "Entity | null"
+              },
               { "name": "name", "description": "Gets the name of the entity." },
               {
                 "name": "position",
@@ -353,17 +363,7 @@
                 "name": "scale",
                 "description": "Gets the scale of the entity."
               },
-              { "name": "tags", "description": "Gets the tags of the entity." },
-              {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
-              },
-              {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
-              }
+              { "name": "tags", "description": "Gets the tags of the entity." }
             ],
             "events": [
               {
@@ -394,14 +394,14 @@
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-material",
-          "description": "The MaterialElement interface provides properties and methods for manipulating\n[`<pc-material>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-material/) elements.\nThe MaterialElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\nA `pc-material` must be a direct child of `pc-app` — elements placed elsewhere log a warning\nand never create a material. Elements inserted while the application is already running are\ncreated on insertion.\n\nThe element is metal/rough by default: unlike a bare `StandardMaterial` it enables the metalness\nworkflow, which is what the `metalness-*` attributes assume and what glTF means by PBR. It also\ndefaults `metalness` to 0 rather than the engine's 1, because those two defaults have to be\nchosen together - the engine's 1 is unreachable under its own `useMetalness` of false, and with\nthe workflow on it would make every material fully metallic, so `<pc-material diffuse=\"crimson\">`\nwould render as dark tinted reflections of an environment that may not exist rather than as a\ncrimson surface. `metalness=\"1\"` remains one attribute away.\n\nThe `roughness` and `roughness-map` attributes are aliases for `gloss` and `gloss-map` that\nadditionally invert the gloss channel; do not mix the two families on one element.\n\nThe two aliases are documented here rather than on an accessor, because they resolve to the\n`gloss` properties and would otherwise inherit gloss's description - which reads inverted.\n\n---\n\n\n### **Methods:**\n - **setMap(id: _string_, slot: _TextureSlot_)** - Points a texture slot at the resource of a `pc-asset`, waiting for the asset to load when it\nhas not already. An empty id clears the slot.",
+          "description": "The MaterialElement interface provides properties and methods for manipulating\n[`<pc-material>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-material/) elements.\nThe MaterialElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\nA `pc-material` must be a direct child of `pc-app` — elements placed elsewhere log a warning\nand never create a material. Elements inserted while the application is already running are\ncreated on insertion.\n\nThe element is metal/rough by default: unlike a bare `StandardMaterial` it enables the metalness\nworkflow, which is what the `metalness-*` attributes assume and what glTF means by PBR. It also\ndefaults `metalness` to 0 rather than the engine's 1, because those two defaults have to be\nchosen together - the engine's 1 is unreachable under its own `useMetalness` of false, and with\nthe workflow on it would make every material fully metallic, so `<pc-material diffuse=\"crimson\">`\nwould render as dark tinted reflections of an environment that may not exist rather than as a\ncrimson surface. `metalness=\"1\"` remains one attribute away.\n\nThe `roughness` and `roughness-map` attributes are aliases for `gloss` and `gloss-map` that\nadditionally invert the gloss channel; do not mix the two families on one element.\n\nThe two aliases are documented here rather than on an accessor, because they resolve to the\n`gloss` properties and would otherwise inherit gloss's description - which reads inverted.\n\n---\n\n\n### **Methods:**\n - **get(id: _string_): __** - Returns the StandardMaterial created by the `<pc-material>` element with the given\n`id`, or `undefined` if there is no such element or its material has not been created yet.",
           "doc-url": "",
           "attributes": [
             {
@@ -831,7 +831,6 @@
           "events": [],
           "js": {
             "properties": [
-              { "name": "material", "type": "StandardMaterial | null" },
               {
                 "name": "alphaTest",
                 "description": "Gets the alpha test reference value."
@@ -1030,6 +1029,11 @@
                 "name": "heightMapUv",
                 "description": "Gets the UV channel the height map samples."
               },
+              {
+                "name": "material",
+                "description": "The material. `null` until the containing application has created it — an element present\nat startup has its material once the application is ready.",
+                "type": "StandardMaterial | null"
+              },
               {
                 "name": "metalness",
                 "description": "Gets how metallic the surface is."
@@ -1181,7 +1185,7 @@
         },
         {
           "name": "pc-model",
-          "description": "The ModelElement interface provides properties and methods for manipulating\n[`<pc-model>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-model/) elements.\nThe ModelElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The ModelElement interface provides properties and methods for manipulating\n[`<pc-model>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-model/) elements.\nThe ModelElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -1194,7 +1198,7 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
@@ -1213,13 +1217,18 @@
                 "name": "closestEntity",
                 "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
                 "type": "EntityElement | null"
+              },
+              {
+                "name": "entity",
+                "description": "The root entity of the instantiated model. `null` until the container asset has loaded\nand been instantiated, and again once the element has been removed from the document.",
+                "type": "Entity | null"
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
@@ -1255,7 +1264,7 @@
         },
         {
           "name": "pc-scene",
-          "description": "The SceneElement interface provides properties and methods for manipulating\n[`<pc-scene>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-scene/) elements.\nThe SceneElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The SceneElement interface provides properties and methods for manipulating\n[`<pc-scene>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-scene/) elements.\nThe SceneElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -1296,15 +1305,20 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
               {
-                "name": "scene",
-                "description": "The PlayCanvas scene instance. `null` until the element is ready — await\nwhenReady or the element's `ready()` promise before accessing it.",
-                "type": "Scene | null"
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
+              },
+              {
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
               },
               {
                 "name": "fog",
@@ -1318,41 +1332,36 @@
                 "name": "fogDensity",
                 "description": "Gets the fog density of the scene."
               },
-              {
-                "name": "fogStart",
-                "description": "Gets the fog start distance of the scene."
-              },
               {
                 "name": "fogEnd",
                 "description": "Gets the fog end distance of the scene."
               },
               {
-                "name": "gravity",
-                "description": "Gets the gravity of the scene."
+                "name": "fogStart",
+                "description": "Gets the fog start distance of the scene."
               },
               {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
+                "name": "gravity",
+                "description": "Gets the gravity of the scene."
               },
               {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
+                "name": "scene",
+                "description": "The PlayCanvas scene instance. `null` until the element is ready — await\nwhenReady or the element's `ready()` promise before accessing it.",
+                "type": "Scene | null"
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-sky",
-          "description": "The SkyElement interface provides properties and methods for manipulating\n`<pc-sky>` elements. The SkyElement interface also inherits the properties and\nmethods of the HTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The SkyElement interface provides properties and methods for manipulating\n`<pc-sky>` elements. The SkyElement interface also inherits the properties and\nmethods of the HTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -1403,7 +1412,7 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
@@ -1416,6 +1425,16 @@
                 "name": "center",
                 "description": "Gets the center of the skybox."
               },
+              {
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
+              },
+              {
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
+              },
               {
                 "name": "intensity",
                 "description": "Gets the intensity of the skybox."
@@ -1436,30 +1455,20 @@
                 "name": "scale",
                 "description": "Gets the scale of the skybox."
               },
-              { "name": "type", "description": "Gets the type of the skybox." },
-              {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
-              },
-              {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
-              }
+              { "name": "type", "description": "Gets the type of the skybox." }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-button",
-          "description": "The ButtonComponentElement interface provides properties and methods for manipulating\n[`<pc-button>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-button/) elements.\nThe ButtonComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The ButtonComponentElement interface provides properties and methods for manipulating\n[`<pc-button>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-button/) elements.\nThe ButtonComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -1542,48 +1551,42 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
-              {
-                "name": "component",
-                "description": "Gets the underlying PlayCanvas button component.",
-                "type": "Component | null"
-              },
               {
                 "name": "active",
                 "description": "Gets whether the button is active."
               },
               {
-                "name": "image",
-                "description": "Gets the reference to the `<pc-entity>` whose image element is used for visual transitions."
-              },
-              {
-                "name": "hitPadding",
-                "description": "Gets the padding used to expand the button's hit area."
-              },
-              {
-                "name": "transitionMode",
-                "description": "Gets how the button reacts to being hovered/pressed."
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
               },
               {
-                "name": "hoverTint",
-                "description": "Gets the hover tint color."
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
               },
               {
-                "name": "pressedTint",
-                "description": "Gets the pressed tint color."
+                "name": "component",
+                "description": "Gets the underlying PlayCanvas button component.",
+                "type": "Component | null"
               },
               {
-                "name": "inactiveTint",
-                "description": "Gets the inactive tint color."
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
               },
               {
                 "name": "fadeDuration",
                 "description": "Gets the duration over which tint transitions are applied."
               },
+              {
+                "name": "hitPadding",
+                "description": "Gets the padding used to expand the button's hit area."
+              },
               {
                 "name": "hoverSpriteAsset",
                 "description": "Gets the id of the `pc-asset` sprite shown when the button is hovered."
@@ -1593,12 +1596,12 @@
                 "description": "Gets the frame of the hover sprite to show."
               },
               {
-                "name": "pressedSpriteAsset",
-                "description": "Gets the id of the `pc-asset` sprite shown when the button is pressed."
+                "name": "hoverTint",
+                "description": "Gets the hover tint color."
               },
               {
-                "name": "pressedSpriteFrame",
-                "description": "Gets the frame of the pressed sprite to show."
+                "name": "image",
+                "description": "Gets the reference to the `<pc-entity>` whose image element is used for visual transitions."
               },
               {
                 "name": "inactiveSpriteAsset",
@@ -1609,32 +1612,38 @@
                 "description": "Gets the frame of the inactive sprite to show."
               },
               {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
+                "name": "inactiveTint",
+                "description": "Gets the inactive tint color."
               },
               {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
+                "name": "pressedSpriteAsset",
+                "description": "Gets the id of the `pc-asset` sprite shown when the button is pressed."
               },
               {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
+                "name": "pressedSpriteFrame",
+                "description": "Gets the frame of the pressed sprite to show."
+              },
+              {
+                "name": "pressedTint",
+                "description": "Gets the pressed tint color."
+              },
+              {
+                "name": "transitionMode",
+                "description": "Gets how the button reacts to being hovered/pressed."
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-camera",
-          "description": "The CameraComponentElement interface provides properties and methods for manipulating\n[`<pc-camera>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-camera/) elements.\nThe CameraComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n - **startXr(type: _'immersive-ar' | 'immersive-vr'_, space: _'bounded-floor' | 'local' | 'local-floor' | 'unbounded' | 'viewer'_)** - Starts the camera in XR mode.\n- **endXr()** - Ends the camera's XR mode.\n\n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The CameraComponentElement interface provides properties and methods for manipulating\n[`<pc-camera>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-camera/) elements.\nThe CameraComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **endXr()** - Ends the camera's XR mode.\n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.\n- **startXr(type: _'immersive-ar' | 'immersive-vr'_, space: _'bounded-floor' | 'local' | 'local-floor' | 'unbounded' | 'viewer'_)** - Starts the camera in XR mode.",
           "doc-url": "",
           "attributes": [
             {
@@ -1743,17 +1752,11 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
-              { "name": "xrAvailable" },
-              {
-                "name": "component",
-                "description": "Gets the underlying PlayCanvas camera component.",
-                "type": "Component | null"
-              },
               {
                 "name": "clearColor",
                 "description": "Gets the clear color of the camera.",
@@ -1774,11 +1777,30 @@
                 "description": "Gets the clear stencil buffer of the camera.",
                 "type": "boolean"
               },
+              {
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
+              },
+              {
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
+              },
+              {
+                "name": "component",
+                "description": "Gets the underlying PlayCanvas camera component.",
+                "type": "Component | null"
+              },
               {
                 "name": "cullFaces",
                 "description": "Gets the cull faces of the camera.",
                 "type": "boolean"
               },
+              {
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
+              },
               {
                 "name": "farClip",
                 "description": "Gets the far clip distance of the camera.",
@@ -1842,33 +1864,20 @@
                 "description": "Gets the tone mapping of the camera.",
                 "type": "'none' | 'linear' | 'filmic' | 'hejl' | 'aces' | 'aces2' | 'neutral'"
               },
-              {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
-              },
-              {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
-              },
-              {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
-              }
+              { "name": "xrAvailable" }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-collision",
-          "description": "The CollisionComponentElement interface provides properties and methods for manipulating\n[`<pc-collision>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-collision/) elements.\nThe CollisionComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The CollisionComponentElement interface provides properties and methods for manipulating\n[`<pc-collision>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-collision/) elements.\nThe CollisionComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -1913,28 +1922,13 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
-              {
-                "name": "component",
-                "description": "Gets the underlying PlayCanvas collision component.",
-                "type": "Component | null"
-              },
               { "name": "angularOffset" },
               { "name": "axis" },
-              { "name": "convexHull" },
-              { "name": "halfExtents" },
-              { "name": "height" },
-              { "name": "linearOffset" },
-              { "name": "radius" },
-              { "name": "type" },
-              {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
-              },
               {
                 "name": "closestApp",
                 "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
@@ -1944,20 +1938,35 @@
                 "name": "closestEntity",
                 "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
                 "type": "EntityElement | null"
-              }
-            ],
-            "events": [
+              },
               {
-                "name": "ready",
-                "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
-              }
+                "name": "component",
+                "description": "Gets the underlying PlayCanvas collision component.",
+                "type": "Component | null"
+              },
+              { "name": "convexHull" },
+              {
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
+              },
+              { "name": "halfExtents" },
+              { "name": "height" },
+              { "name": "linearOffset" },
+              { "name": "radius" },
+              { "name": "type" }
+            ],
+            "events": [
+              {
+                "name": "ready",
+                "type": "CustomEvent",
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
+              }
             ]
           }
         },
         {
           "name": "pc-element",
-          "description": "The ElementComponentElement interface provides properties and methods for manipulating\n[`<pc-element>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-element/) elements.\nThe ElementComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The ElementComponentElement interface provides properties and methods for manipulating\n[`<pc-element>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-element/) elements.\nThe ElementComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -2103,32 +2112,54 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
-              {
-                "name": "component",
-                "description": "Gets the underlying PlayCanvas element component.",
-                "type": "Component | null"
-              },
               {
                 "name": "anchor",
                 "description": "Gets the anchor of the element component."
               },
               {
-                "name": "autoWidth",
-                "description": "Gets whether the element component should automatically adjust its width."
+                "name": "autoFitHeight",
+                "description": "Gets whether a text element automatically reduces its font size to fit its height."
+              },
+              {
+                "name": "autoFitWidth",
+                "description": "Gets whether a text element automatically reduces its font size to fit its width."
               },
               {
                 "name": "autoHeight",
                 "description": "Gets whether the element component should automatically adjust its height."
               },
+              {
+                "name": "autoWidth",
+                "description": "Gets whether the element component should automatically adjust its width."
+              },
+              {
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
+              },
+              {
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
+              },
               {
                 "name": "color",
                 "description": "Gets the color of the element component."
               },
+              {
+                "name": "component",
+                "description": "Gets the underlying PlayCanvas element component.",
+                "type": "Component | null"
+              },
+              {
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
+              },
               {
                 "name": "enableMarkup",
                 "description": "Gets whether the element component should use markup."
@@ -2157,6 +2188,14 @@
                 "name": "mask",
                 "description": "Gets whether the element component is a mask."
               },
+              {
+                "name": "maxFontSize",
+                "description": "Gets the largest font size a text element may use when auto-fitting."
+              },
+              {
+                "name": "minFontSize",
+                "description": "Gets the smallest font size a text element may use when auto-fitting."
+              },
               {
                 "name": "opacity",
                 "description": "Gets the opacity of the element component."
@@ -2201,50 +2240,20 @@
               {
                 "name": "wrapLines",
                 "description": "Gets whether the element component should wrap lines."
-              },
-              {
-                "name": "autoFitWidth",
-                "description": "Gets whether a text element automatically reduces its font size to fit its width."
-              },
-              {
-                "name": "autoFitHeight",
-                "description": "Gets whether a text element automatically reduces its font size to fit its height."
-              },
-              {
-                "name": "minFontSize",
-                "description": "Gets the smallest font size a text element may use when auto-fitting."
-              },
-              {
-                "name": "maxFontSize",
-                "description": "Gets the largest font size a text element may use when auto-fitting."
-              },
-              {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
-              },
-              {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
-              },
-              {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-gsplat",
-          "description": "The GSplatComponentElement interface provides properties and methods for manipulating\n[`<pc-gsplat>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-gsplat/) elements.\nThe GSplatComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The GSplatComponentElement interface provides properties and methods for manipulating\n[`<pc-gsplat>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-gsplat/) elements.\nThe GSplatComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -2287,16 +2296,11 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
-              {
-                "name": "component",
-                "description": "Gets the underlying PlayCanvas gsplat component.",
-                "type": "Component | null"
-              },
               {
                 "name": "asset",
                 "description": "Gets the id of the `pc-asset` to use for the splat."
@@ -2306,48 +2310,53 @@
                 "description": "Gets whether the splat casts shadows."
               },
               {
-                "name": "lodBaseDistance",
-                "description": "Gets the base distance for the first LOD transition."
-              },
-              {
-                "name": "lodMultiplier",
-                "description": "Gets the multiplier between successive LOD distance thresholds."
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
               },
               {
-                "name": "lodRangeMin",
-                "description": "Gets the minimum allowed LOD index."
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
               },
               {
-                "name": "lodRangeMax",
-                "description": "Gets the maximum allowed LOD index."
+                "name": "component",
+                "description": "Gets the underlying PlayCanvas gsplat component.",
+                "type": "Component | null"
               },
               {
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
               {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
+                "name": "lodBaseDistance",
+                "description": "Gets the base distance for the first LOD transition."
               },
               {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
+                "name": "lodMultiplier",
+                "description": "Gets the multiplier between successive LOD distance thresholds."
+              },
+              {
+                "name": "lodRangeMax",
+                "description": "Gets the maximum allowed LOD index."
+              },
+              {
+                "name": "lodRangeMin",
+                "description": "Gets the minimum allowed LOD index."
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-layoutchild",
-          "description": "The LayoutChildComponentElement interface provides properties and methods for manipulating\n[`<pc-layoutchild>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-layoutchild/) elements.\nThe LayoutChildComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The LayoutChildComponentElement interface provides properties and methods for manipulating\n[`<pc-layoutchild>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-layoutchild/) elements.\nThe LayoutChildComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -2395,71 +2404,71 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
+              {
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
+              },
+              {
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
+              },
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas layout child component.",
                 "type": "Component | null"
               },
               {
-                "name": "minWidth",
-                "description": "Gets the minimum width the element should be laid out with."
-              },
-              {
-                "name": "minHeight",
-                "description": "Gets the minimum height the element should be laid out with."
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
               },
               {
-                "name": "maxWidth",
-                "description": "Gets the maximum width the element should be laid out with."
+                "name": "excludeFromLayout",
+                "description": "Gets whether the element is excluded from the layout."
               },
               {
-                "name": "maxHeight",
-                "description": "Gets the maximum height the element should be laid out with."
+                "name": "fitHeightProportion",
+                "description": "Gets the proportion of the container's spare height this element should take."
               },
               {
                 "name": "fitWidthProportion",
                 "description": "Gets the proportion of the container's spare width this element should take."
               },
               {
-                "name": "fitHeightProportion",
-                "description": "Gets the proportion of the container's spare height this element should take."
-              },
-              {
-                "name": "excludeFromLayout",
-                "description": "Gets whether the element is excluded from the layout."
+                "name": "maxHeight",
+                "description": "Gets the maximum height the element should be laid out with."
               },
               {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
+                "name": "maxWidth",
+                "description": "Gets the maximum width the element should be laid out with."
               },
               {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
+                "name": "minHeight",
+                "description": "Gets the minimum height the element should be laid out with."
               },
               {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
+                "name": "minWidth",
+                "description": "Gets the minimum width the element should be laid out with."
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-layoutgroup",
-          "description": "The LayoutGroupComponentElement interface provides properties and methods for manipulating\n[`<pc-layoutgroup>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-layoutgroup/) elements.\nThe LayoutGroupComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The LayoutGroupComponentElement interface provides properties and methods for manipulating\n[`<pc-layoutgroup>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-layoutgroup/) elements.\nThe LayoutGroupComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -2526,20 +2535,46 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
+              {
+                "name": "alignment",
+                "description": "Gets the alignment of the child elements."
+              },
+              {
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
+              },
+              {
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
+              },
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas layout group component.",
                 "type": "Component | null"
               },
+              {
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
+              },
+              {
+                "name": "heightFitting",
+                "description": "Gets the fitting mode along the vertical axis."
+              },
               {
                 "name": "orientation",
                 "description": "Gets the orientation of the layout group."
               },
+              {
+                "name": "padding",
+                "description": "Gets the padding around the layout group."
+              },
               {
                 "name": "reverseX",
                 "description": "Gets whether the order of children is reversed along the horizontal axis."
@@ -2548,14 +2583,6 @@
                 "name": "reverseY",
                 "description": "Gets whether the order of children is reversed along the vertical axis."
               },
-              {
-                "name": "alignment",
-                "description": "Gets the alignment of the child elements."
-              },
-              {
-                "name": "padding",
-                "description": "Gets the padding around the layout group."
-              },
               {
                 "name": "spacing",
                 "description": "Gets the spacing between child elements."
@@ -2564,41 +2591,23 @@
                 "name": "widthFitting",
                 "description": "Gets the fitting mode along the horizontal axis."
               },
-              {
-                "name": "heightFitting",
-                "description": "Gets the fitting mode along the vertical axis."
-              },
               {
                 "name": "wrap",
                 "description": "Gets whether children wrap onto a new line/column when they overflow the group."
-              },
-              {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
-              },
-              {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
-              },
-              {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-light",
-          "description": "The LightComponentElement interface provides properties and methods for manipulating\n[`<pc-light>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-light/) elements.\nThe LightComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The LightComponentElement interface provides properties and methods for manipulating\n[`<pc-light>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-light/) elements.\nThe LightComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -2712,40 +2721,62 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
-              {
-                "name": "component",
-                "description": "Gets the underlying PlayCanvas light component.",
-                "type": "Component | null"
-              },
               {
                 "name": "castShadows",
                 "description": "Gets the cast shadows flag of the light."
               },
               {
-                "name": "color",
-                "description": "Gets the color of the light."
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
               },
               {
-                "name": "innerConeAngle",
-                "description": "Gets the inner cone angle of the light."
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
               },
               {
-                "name": "intensity",
-                "description": "Gets the intensity of the light."
+                "name": "color",
+                "description": "Gets the color of the light."
               },
               {
-                "name": "normalOffsetBias",
-                "description": "Gets the normal offset bias of the light."
+                "name": "component",
+                "description": "Gets the underlying PlayCanvas light component.",
+                "type": "Component | null"
+              },
+              {
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
+              },
+              {
+                "name": "innerConeAngle",
+                "description": "Gets the inner cone angle of the light."
+              },
+              {
+                "name": "intensity",
+                "description": "Gets the intensity of the light."
+              },
+              {
+                "name": "normalOffsetBias",
+                "description": "Gets the normal offset bias of the light."
               },
               {
                 "name": "outerConeAngle",
                 "description": "Gets the outer cone angle of the light."
               },
+              {
+                "name": "penumbraFalloff",
+                "description": "Gets the penumbra falloff of the light."
+              },
+              {
+                "name": "penumbraSize",
+                "description": "Gets the penumbra size of the light."
+              },
               {
                 "name": "range",
                 "description": "Gets the range of the light."
@@ -2754,6 +2785,10 @@
                 "name": "shadowBias",
                 "description": "Gets the shadow bias of the light."
               },
+              {
+                "name": "shadowBlockerSamples",
+                "description": "Gets the number of shadow blocker samples."
+              },
               {
                 "name": "shadowDistance",
                 "description": "Gets the shadow distance of the light."
@@ -2766,6 +2801,10 @@
                 "name": "shadowResolution",
                 "description": "Gets the shadow resolution of the light."
               },
+              {
+                "name": "shadowSamples",
+                "description": "Gets the number of shadow samples."
+              },
               {
                 "name": "shadowType",
                 "description": "Gets the shadow type of the light."
@@ -2778,50 +2817,20 @@
               {
                 "name": "vsmBlurSize",
                 "description": "Gets the VSM blur size of the light."
-              },
-              {
-                "name": "penumbraSize",
-                "description": "Gets the penumbra size of the light."
-              },
-              {
-                "name": "penumbraFalloff",
-                "description": "Gets the penumbra falloff of the light."
-              },
-              {
-                "name": "shadowSamples",
-                "description": "Gets the number of shadow samples."
-              },
-              {
-                "name": "shadowBlockerSamples",
-                "description": "Gets the number of shadow blocker samples."
-              },
-              {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
-              },
-              {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
-              },
-              {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-listener",
-          "description": "The ListenerComponentElement interface provides properties and methods for manipulating\n[`<pc-listener>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-listener/) elements.\nThe ListenerComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The ListenerComponentElement interface provides properties and methods for manipulating\n[`<pc-listener>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-listener/) elements.\nThe ListenerComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -2834,20 +2843,11 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
-              {
-                "name": "component",
-                "description": "Gets the underlying PlayCanvas audio listener component.",
-                "type": "Component | null"
-              },
-              {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
-              },
               {
                 "name": "closestApp",
                 "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
@@ -2857,20 +2857,29 @@
                 "name": "closestEntity",
                 "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
                 "type": "EntityElement | null"
+              },
+              {
+                "name": "component",
+                "description": "Gets the underlying PlayCanvas audio listener component.",
+                "type": "Component | null"
+              },
+              {
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-particles",
-          "description": "The ParticleSystemComponentElement interface provides properties and methods for manipulating\n[`<pc-particles>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-particles/) elements.\nThe ParticleSystemComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n - **play()** - Starts playing the particle system\n- **pause()** - Pauses the particle system\n- **reset()** - Resets the particle system\n- **stop()** - Stops the particle system\n\n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The ParticleSystemComponentElement interface provides properties and methods for manipulating\n[`<pc-particles>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-particles/) elements.\nThe ParticleSystemComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **pause()** - Pauses the particle system\n- **play()** - Starts playing the particle system\n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.\n- **reset()** - Resets the particle system\n- **stop()** - Stops the particle system",
           "doc-url": "",
           "attributes": [
             {
@@ -2888,25 +2897,16 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
-              {
-                "name": "component",
-                "description": "Gets the underlying PlayCanvas particle system component.",
-                "type": "Component | null"
-              },
               {
                 "name": "asset",
                 "description": "Gets the id of the `pc-asset` to use for the model.",
                 "type": "string"
               },
-              {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
-              },
               {
                 "name": "closestApp",
                 "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
@@ -2916,20 +2916,29 @@
                 "name": "closestEntity",
                 "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
                 "type": "EntityElement | null"
+              },
+              {
+                "name": "component",
+                "description": "Gets the underlying PlayCanvas particle system component.",
+                "type": "Component | null"
+              },
+              {
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-render",
-          "description": "The RenderComponentElement interface provides properties and methods for manipulating\n[`<pc-render>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-render/) elements.\nThe RenderComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\nThis element renders one of the engine's built-in primitives, selected with `type` (defaulting\nto `box`). It does not cover the engine's `asset` render type, since there is no way to supply\na render asset here — use `pc-model` for glTF content instead.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The RenderComponentElement interface provides properties and methods for manipulating\n[`<pc-render>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-render/) elements.\nThe RenderComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\nThis element renders one of the engine's built-in primitives, selected with `type` (defaulting\nto `box`). It does not cover the engine's `asset` render type, since there is no way to supply\na render asset here — use `pc-model` for glTF content instead.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -2965,25 +2974,34 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
+              {
+                "name": "castShadows",
+                "description": "Gets the cast shadows flag of the render component.",
+                "type": "boolean"
+              },
+              {
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
+              },
+              {
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
+              },
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas render component.",
                 "type": "Component | null"
               },
               {
-                "name": "type",
-                "description": "Gets the type of the render component.",
-                "type": "'box' | 'capsule' | 'cone' | 'cylinder' | 'plane' | 'sphere'"
-              },
-              {
-                "name": "castShadows",
-                "description": "Gets the cast shadows flag of the render component.",
-                "type": "boolean"
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
               },
               {
                 "name": "material",
@@ -2995,32 +3013,23 @@
                 "type": "boolean"
               },
               {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
-              },
-              {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
-              },
-              {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
+                "name": "type",
+                "description": "Gets the type of the render component.",
+                "type": "'box' | 'capsule' | 'cone' | 'cylinder' | 'plane' | 'sphere'"
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-rigidbody",
-          "description": "The RigidBodyComponentElement interface provides properties and methods for manipulating\n[`<pc-rigidbody>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-rigidbody/) elements.\nThe RigidBodyComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The RigidBodyComponentElement interface provides properties and methods for manipulating\n[`<pc-rigidbody>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-rigidbody/) elements.\nThe RigidBodyComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -3071,29 +3080,13 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
-              {
-                "name": "component",
-                "description": "Gets the underlying PlayCanvas rigidbody component.",
-                "type": "Component | null"
-              },
               { "name": "angularDamping" },
               { "name": "angularFactor" },
-              { "name": "friction" },
-              { "name": "linearDamping" },
-              { "name": "linearFactor" },
-              { "name": "mass" },
-              { "name": "restitution" },
-              { "name": "rollingFriction" },
-              { "name": "type" },
-              {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
-              },
               {
                 "name": "closestApp",
                 "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
@@ -3103,20 +3096,36 @@
                 "name": "closestEntity",
                 "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
                 "type": "EntityElement | null"
-              }
+              },
+              {
+                "name": "component",
+                "description": "Gets the underlying PlayCanvas rigidbody component.",
+                "type": "Component | null"
+              },
+              {
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
+              },
+              { "name": "friction" },
+              { "name": "linearDamping" },
+              { "name": "linearFactor" },
+              { "name": "mass" },
+              { "name": "restitution" },
+              { "name": "rollingFriction" },
+              { "name": "type" }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-screen",
-          "description": "The ScreenComponentElement interface provides properties and methods for manipulating\n[`<pc-screen>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-screen/) elements.\nThe ScreenComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The ScreenComponentElement interface provides properties and methods for manipulating\n[`<pc-screen>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-screen/) elements.\nThe ScreenComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -3157,16 +3166,30 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
+              {
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
+              },
+              {
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
+              },
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas screen component.",
                 "type": "Component | null"
               },
+              {
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
+              },
               { "name": "priority" },
               { "name": "referenceResolution" },
               { "name": "resolution" },
@@ -3178,34 +3201,20 @@
                 "name": "scaleMode",
                 "description": "Gets how the screen scales its contents."
               },
-              { "name": "screenSpace" },
-              {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
-              },
-              {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
-              },
-              {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
-              }
+              { "name": "screenSpace" }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-scripts",
-          "description": "The ScriptComponentElement interface provides properties and methods for manipulating\n[`<pc-scripts>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-scripts/) elements.\nThe ScriptComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The ScriptComponentElement interface provides properties and methods for manipulating\n[`<pc-scripts>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-scripts/) elements.\nThe ScriptComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -3218,20 +3227,11 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
-              {
-                "name": "component",
-                "description": "Gets the underlying PlayCanvas script component.",
-                "type": "Component | null"
-              },
-              {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
-              },
               {
                 "name": "closestApp",
                 "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
@@ -3241,20 +3241,29 @@
                 "name": "closestEntity",
                 "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
                 "type": "EntityElement | null"
+              },
+              {
+                "name": "component",
+                "description": "Gets the underlying PlayCanvas script component.",
+                "type": "Component | null"
+              },
+              {
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-script",
-          "description": "The ScriptElement interface provides properties and methods for manipulating\n`<pc-script>` elements. The ScriptElement interface also inherits the properties and\nmethods of the AsyncElement interface.\n\nScript attributes can be supplied through two channels:\n\n- **Per-property attributes**: any non-reserved attribute on the element maps to the script\n  attribute of the same name (kebab-case to camelCase, e.g. `focus-point` → `focusPoint`).\n  Values are parsed according to the type of the attribute's current value — initially the\n  script's declared default (numbers, booleans, strings, Vec2/3/4, Color, Quat as Euler\n  angles) — and the `asset:`/`entity:`/`vec2:`/`vec3:`/`vec4:`/`color:` prefixes may be used\n  to be explicit.\n- **The `attributes` JSON attribute**: an object supporting nested structures and attribute\n  names that collide with reserved HTML attribute names (e.g. `title`).\n\nWhen both specify the same attribute, the per-property attribute wins — at creation and\nwhenever either channel changes at runtime. The element's own `name` and `enabled`\nattributes configure the element itself and are not script attributes.\n\nChanging `name` on a live element destroys the old-name script instance and creates the\nnew-name one, re-applying both attribute channels to it.\n\nThe element becomes ready once its script instance has been created by the parent\n`<pc-scripts>` element.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n- **scriptattributeschange** - Fired when the script's attributes change. The `detail` carries the new `attributes` object. Bubbles.\n- **scriptenablechange** - Fired when the script's enabled state changes. The `detail` carries the new `enabled` state. Bubbles.\n- **scriptnamechange** - Fired when the script is renamed on a live element. The `detail` carries `oldName` and `newName`. Bubbles.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The ScriptElement interface provides properties and methods for manipulating\n`<pc-script>` elements. The ScriptElement interface also inherits the properties and\nmethods of the AsyncElement interface.\n\nScript attributes can be supplied through two channels:\n\n- **Per-property attributes**: any non-reserved attribute on the element maps to the script\n  attribute of the same name (kebab-case to camelCase, e.g. `focus-point` → `focusPoint`).\n  Values are parsed according to the type of the attribute's current value — initially the\n  script's declared default (numbers, booleans, strings, Vec2/3/4, Color, Quat as Euler\n  angles) — and the `asset:`/`entity:`/`vec2:`/`vec3:`/`vec4:`/`color:` prefixes may be used\n  to be explicit.\n- **The `attributes` JSON attribute**: an object supporting nested structures and attribute\n  names that collide with reserved HTML attribute names (e.g. `title`).\n\nWhen both specify the same attribute, the per-property attribute wins — at creation and\nwhenever either channel changes at runtime. The element's own `name` and `enabled`\nattributes configure the element itself and are not script attributes.\n\nChanging `name` on a live element destroys the old-name script instance and creates the\nnew-name one, re-applying both attribute channels to it.\n\nThe element becomes ready once its script instance has been created by the parent\n`<pc-scripts>` element.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n- **scriptattributeschange** - Fired when the script's attributes change. The `detail` carries the new `attributes` object. Bubbles.\n- **scriptenablechange** - Fired when the script's enabled state changes. The `detail` carries the new `enabled` state. Bubbles.\n- **scriptnamechange** - Fired when the script is renamed on a live element. The `detail` carries `oldName` and `newName`. Bubbles.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -3277,7 +3286,7 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             },
             {
               "name": "scriptattributeschange",
@@ -3298,9 +3307,14 @@
           "js": {
             "properties": [
               {
-                "name": "scriptAttributes",
-                "description": "Gets the attributes of the script.",
-                "type": "Record<string, any>"
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
+              },
+              {
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
               },
               {
                 "name": "enabled",
@@ -3313,21 +3327,16 @@
                 "type": "Script | null"
               },
               {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
-              },
-              {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
+                "name": "scriptAttributes",
+                "description": "Gets the attributes of the script.",
+                "type": "Record<string, any>"
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               },
               {
                 "name": "scriptattributeschange",
@@ -3349,7 +3358,7 @@
         },
         {
           "name": "pc-scrollbar",
-          "description": "The ScrollbarComponentElement interface provides properties and methods for manipulating\n[`<pc-scrollbar>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-scrollbar/) elements.\nThe ScrollbarComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The ScrollbarComponentElement interface provides properties and methods for manipulating\n[`<pc-scrollbar>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-scrollbar/) elements.\nThe ScrollbarComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -3385,59 +3394,59 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
               {
-                "name": "component",
-                "description": "Gets the underlying PlayCanvas scrollbar component.",
-                "type": "Component | null"
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
               },
               {
-                "name": "orientation",
-                "description": "Gets the orientation of the scrollbar."
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
               },
               {
-                "name": "value",
-                "description": "Gets the current position value of the scrollbar."
+                "name": "component",
+                "description": "Gets the underlying PlayCanvas scrollbar component.",
+                "type": "Component | null"
               },
               {
-                "name": "handleSize",
-                "description": "Gets the size of the handle relative to the size of the track."
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
               },
               {
                 "name": "handle",
                 "description": "Gets the reference to the `<pc-entity>` used as the scrollbar handle."
               },
               {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
+                "name": "handleSize",
+                "description": "Gets the size of the handle relative to the size of the track."
               },
               {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
+                "name": "orientation",
+                "description": "Gets the orientation of the scrollbar."
               },
               {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
+                "name": "value",
+                "description": "Gets the current position value of the scrollbar."
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-scrollview",
-          "description": "The ScrollViewComponentElement interface provides properties and methods for manipulating\n[`<pc-scrollview>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-scrollview/) elements.\nThe ScrollViewComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The ScrollViewComponentElement interface provides properties and methods for manipulating\n[`<pc-scrollview>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-scrollview/) elements.\nThe ScrollViewComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -3524,92 +3533,92 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
               {
-                "name": "component",
-                "description": "Gets the underlying PlayCanvas scroll view component.",
-                "type": "Component | null"
+                "name": "bounceAmount",
+                "description": "Gets the bounce amount."
               },
               {
-                "name": "horizontal",
-                "description": "Gets whether scrolling along the horizontal axis is enabled."
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
               },
               {
-                "name": "vertical",
-                "description": "Gets whether scrolling along the vertical axis is enabled."
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
               },
               {
-                "name": "scrollMode",
-                "description": "Gets how the scroll view behaves when the content is scrolled beyond its bounds."
+                "name": "component",
+                "description": "Gets the underlying PlayCanvas scroll view component.",
+                "type": "Component | null"
               },
               {
-                "name": "bounceAmount",
-                "description": "Gets the bounce amount."
+                "name": "content",
+                "description": "Gets the reference to the `<pc-entity>` used as the content."
+              },
+              {
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
               },
               { "name": "friction", "description": "Gets the friction." },
               {
-                "name": "useMouseWheel",
-                "description": "Gets whether the scroll view responds to mouse wheel events."
+                "name": "horizontal",
+                "description": "Gets whether scrolling along the horizontal axis is enabled."
               },
               {
-                "name": "mouseWheelSensitivity",
-                "description": "Gets the mouse wheel sensitivity."
+                "name": "horizontalScrollbar",
+                "description": "Gets the reference to the `<pc-entity>` containing the horizontal scrollbar."
               },
               {
                 "name": "horizontalScrollbarVisibility",
                 "description": "Gets the visibility of the horizontal scrollbar."
               },
               {
-                "name": "verticalScrollbarVisibility",
-                "description": "Gets the visibility of the vertical scrollbar."
+                "name": "mouseWheelSensitivity",
+                "description": "Gets the mouse wheel sensitivity."
               },
               {
-                "name": "viewport",
-                "description": "Gets the reference to the `<pc-entity>` used as the viewport."
+                "name": "scrollMode",
+                "description": "Gets how the scroll view behaves when the content is scrolled beyond its bounds."
               },
               {
-                "name": "content",
-                "description": "Gets the reference to the `<pc-entity>` used as the content."
+                "name": "useMouseWheel",
+                "description": "Gets whether the scroll view responds to mouse wheel events."
               },
               {
-                "name": "horizontalScrollbar",
-                "description": "Gets the reference to the `<pc-entity>` containing the horizontal scrollbar."
+                "name": "vertical",
+                "description": "Gets whether scrolling along the vertical axis is enabled."
               },
               {
                 "name": "verticalScrollbar",
                 "description": "Gets the reference to the `<pc-entity>` containing the vertical scrollbar."
               },
               {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
-              },
-              {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
+                "name": "verticalScrollbarVisibility",
+                "description": "Gets the visibility of the vertical scrollbar."
               },
               {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
+                "name": "viewport",
+                "description": "Gets the reference to the `<pc-entity>` used as the viewport."
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-sounds",
-          "description": "The SoundComponentElement interface provides properties and methods for manipulating\n[`<pc-sounds>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-sounds/) elements.\nThe SoundComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The SoundComponentElement interface provides properties and methods for manipulating\n[`<pc-sounds>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-sounds/) elements.\nThe SoundComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -3660,11 +3669,21 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
+              {
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
+              },
+              {
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
+              },
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas sound component.",
@@ -3675,6 +3694,10 @@
                 "description": "Gets which algorithm to use to reduce the volume of the sound as it moves away from the listener.",
                 "type": "'exponential' | 'inverse' | 'linear'"
               },
+              {
+                "name": "enabled",
+                "description": "Gets the enabled state of the component."
+              },
               {
                 "name": "maxDistance",
                 "description": "Gets the maximum distance from the listener at which audio falloff stops."
@@ -3698,34 +3721,20 @@
               {
                 "name": "volume",
                 "description": "Gets the volume of the sound."
-              },
-              {
-                "name": "enabled",
-                "description": "Gets the enabled state of the component."
-              },
-              {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
-              },
-              {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }
         },
         {
           "name": "pc-sound",
-          "description": "The SoundSlotElement interface provides properties and methods for manipulating\n`<pc-sound>` elements. The SoundSlotElement interface also inherits the properties and\nmethods of the AsyncElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired once the element is fully initialized. Bubbles and is composed.\n\n### **Methods:**\n \n- **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.",
+          "description": "The SoundSlotElement interface provides properties and methods for manipulating\n`<pc-sound>` elements. The SoundSlotElement interface also inherits the properties and\nmethods of the AsyncElement interface.\n\n---\n\n\n### **Events:**\n - **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.\n\n### **Methods:**\n - **ready(): __** - Returns a promise that resolves with this element when it's ready. This is the low-level\nprimitive underlying whenReady, which is the recommended way to wait for elements.\n\nReadiness tracks the element's current lifecycle: once a ready element is torn down (for\nexample by removing it from the document), this returns a fresh promise that resolves when\nthe element is next ready. A promise obtained earlier stays resolved — call this again\nafter re-inserting an element rather than reusing a promise from before its removal.",
           "doc-url": "",
           "attributes": [
             {
@@ -3778,16 +3787,11 @@
             {
               "name": "ready",
               "type": "CustomEvent",
-              "description": "Fired once the element is fully initialized. Bubbles and is composed."
+              "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
             }
           ],
           "js": {
             "properties": [
-              {
-                "name": "soundSlot",
-                "description": "The sound slot.",
-                "type": "SoundSlot | null"
-              },
               {
                 "name": "asset",
                 "description": "Gets the id of the `pc-asset` to use for the sound slot."
@@ -3796,6 +3800,16 @@
                 "name": "autoPlay",
                 "description": "Gets the auto play flag of the sound slot."
               },
+              {
+                "name": "closestApp",
+                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "AppElement | null"
+              },
+              {
+                "name": "closestEntity",
+                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
+                "type": "EntityElement | null"
+              },
               {
                 "name": "duration",
                 "description": "Gets the duration of the sound slot.",
@@ -3817,6 +3831,11 @@
                 "name": "pitch",
                 "description": "Gets the pitch of the sound slot."
               },
+              {
+                "name": "soundSlot",
+                "description": "The sound slot.",
+                "type": "SoundSlot | null"
+              },
               {
                 "name": "startTime",
                 "description": "Gets the start time of the sound slot."
@@ -3824,23 +3843,13 @@
               {
                 "name": "volume",
                 "description": "Gets the volume of the sound slot."
-              },
-              {
-                "name": "closestApp",
-                "description": "The nearest ancestor `<pc-app>` element, or `null` if this element has no `<pc-app>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "AppElement | null"
-              },
-              {
-                "name": "closestEntity",
-                "description": "The nearest ancestor `<pc-entity>` element, or `null` if this element has no `<pc-entity>`\nancestor. The search starts at the parent, so an element never resolves to itself.",
-                "type": "EntityElement | null"
               }
             ],
             "events": [
               {
                 "name": "ready",
                 "type": "CustomEvent",
-                "description": "Fired once the element is fully initialized. Bubbles and is composed."
+                "description": "Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed."
               }
             ]
           }