@playcanvas/web-components 0.10.0 → 0.11.0

package/dist/web-types.json

@@ -1,24 +1,24 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@playcanvas/web-components",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "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 - **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 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.",
           "doc-url": "",
           "attributes": [
             {
               "name": "alpha",
-              "description": "The alpha flag.",
+              "description": "Whether the frame buffer has an alpha channel.",
               "value": { "type": "boolean", "default": "true" }
             },
             {
               "name": "antialias",
-              "description": "The antialias flag.",
+              "description": "Whether the frame buffer is anti-aliased.",
               "value": { "type": "boolean", "default": "true" }
             },
             {
@@ -30,22 +30,32 @@
               }
             },
             {
-              "name": "depth",
-              "description": "The depth flag.",
+              "name": "depth-buffer",
+              "description": "Whether the frame buffer has a depth buffer.",
               "value": { "type": "boolean", "default": "true" }
             },
             {
-              "name": "high-resolution",
-              "description": "The high resolution flag.",
+              "name": "loading-bar",
+              "description": "Whether the application shows its built-in loading bar while it boots and preloads its assets.",
               "value": { "type": "boolean", "default": "true" }
             },
             {
-              "name": "stencil",
-              "description": "The stencil flag.",
+              "name": "max-pixel-ratio",
+              "description": "The cap on the pixel ratio the application renders at.",
+              "value": { "type": "number", "default": "Infinity" }
+            },
+            {
+              "name": "stencil-buffer",
+              "description": "Whether the frame buffer has a stencil buffer.",
               "value": { "type": "boolean", "default": "true" }
             }
           ],
           "events": [
+            {
+              "name": "progress",
+              "type": "ProgressEvent",
+              "description": "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."
+            },
             {
               "name": "ready",
               "type": "CustomEvent",
@@ -56,28 +66,59 @@
             "properties": [
               {
                 "name": "app",
-                "description": "The PlayCanvas application instance. Available once the element is ready — await\nwhenReady or the element's `ready()` promise before accessing it.",
-                "type": "AppBase"
+                "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."
               },
-              { "name": "alpha", "description": "Gets the alpha flag." },
               {
                 "name": "antialias",
-                "description": "Gets the antialias flag."
+                "description": "Gets whether the frame buffer is anti-aliased."
               },
               {
                 "name": "backend",
                 "description": "Gets the graphics backend."
               },
-              { "name": "depth", "description": "Gets the depth flag." },
               {
-                "name": "highResolution",
-                "description": "Gets the high resolution flag."
+                "name": "depthBuffer",
+                "description": "Gets whether the frame buffer has a depth buffer."
+              },
+              {
+                "name": "loadingBar",
+                "description": "Gets whether the application shows its built-in loading bar while it boots and preloads\nits assets."
               },
-              { "name": "stencil", "description": "Gets the stencil flag." },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "name": "maxPixelRatio",
+                "description": "Gets the cap on the pixel ratio the application renders at."
+              },
+              {
+                "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": [
+              {
+                "name": "progress",
+                "type": "ProgressEvent",
+                "description": "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."
+              },
               {
                 "name": "ready",
                 "type": "CustomEvent",
@@ -88,7 +129,7 @@
         },
         {
           "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 - **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 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.",
           "doc-url": "",
           "attributes": [
             {
@@ -138,6 +179,16 @@
             }
           ],
           "events": [
+            {
+              "name": "error",
+              "type": "ErrorEvent",
+              "description": "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."
+            },
+            {
+              "name": "load",
+              "type": "Event",
+              "description": "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."
+            },
             {
               "name": "ready",
               "type": "CustomEvent",
@@ -155,10 +206,28 @@
                 "name": "lazy",
                 "description": "Gets whether the asset should be loaded lazily."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": "error",
+                "type": "ErrorEvent",
+                "description": "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."
+              },
+              {
+                "name": "load",
+                "type": "Event",
+                "description": "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."
+              },
               {
                 "name": "ready",
                 "type": "CustomEvent",
@@ -264,8 +333,8 @@
             "properties": [
               {
                 "name": "entity",
-                "description": "The PlayCanvas entity instance. Available once the element is ready — await\nwhenReady or the element's `ready()` promise before accessing it.",
-                "type": "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": "enabled",
@@ -285,8 +354,16 @@
                 "description": "Gets the scale of the entity."
               },
               { "name": "tags", "description": "Gets the tags of the entity." },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -324,7 +401,7 @@
         },
         {
           "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. The\n`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 - **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.",
           "doc-url": "",
           "attributes": [
             {
@@ -577,7 +654,7 @@
             {
               "name": "metalness",
               "description": "How metallic the surface is.",
-              "value": { "type": "number", "default": "1" }
+              "value": { "type": "number", "default": "0" }
             },
             {
               "name": "metalness-map",
@@ -1127,8 +1204,16 @@
                 "description": "Gets the id of the `pc-asset` to use for the model.",
                 "type": "string"
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -1218,8 +1303,8 @@
             "properties": [
               {
                 "name": "scene",
-                "description": "The PlayCanvas scene instance. Available once the element is ready — await\nwhenReady or the element's `ready()` promise before accessing it.",
-                "type": "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": "fog",
@@ -1245,8 +1330,16 @@
                 "name": "gravity",
                 "description": "Gets the gravity of the scene."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -1277,16 +1370,16 @@
               "description": "The intensity of the skybox.",
               "value": { "type": "number", "default": "1" }
             },
-            {
-              "name": "level",
-              "description": "The mip level of the skybox.",
-              "value": { "type": "number", "default": "0" }
-            },
             {
               "name": "lighting",
               "description": "Whether the skybox is used as a light source.",
               "value": { "type": "boolean", "default": "false" }
             },
+            {
+              "name": "mip-level",
+              "description": "The mip level of the skybox.",
+              "value": { "type": "number", "default": "0" }
+            },
             {
               "name": "rotation",
               "description": "The Euler rotation of the skybox. Accepts 3 space-separated numbers.",
@@ -1327,14 +1420,14 @@
                 "name": "intensity",
                 "description": "Gets the intensity of the skybox."
               },
-              {
-                "name": "level",
-                "description": "Gets the mip level of the skybox."
-              },
               {
                 "name": "lighting",
                 "description": "Gets whether the skybox is used as a light source."
               },
+              {
+                "name": "mipLevel",
+                "description": "Gets the mip level of the skybox."
+              },
               {
                 "name": "rotation",
                 "description": "Gets the Euler rotation of the skybox."
@@ -1344,8 +1437,16 @@
                 "description": "Gets the scale of the skybox."
               },
               { "name": "type", "description": "Gets the type of the skybox." },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -1449,7 +1550,7 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas button component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "active",
@@ -1511,8 +1612,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -1598,16 +1707,19 @@
               "description": "The orthographic height of the camera.",
               "value": { "type": "number", "default": "10" }
             },
-            {
-              "name": "orthographic",
-              "description": "The orthographic projection of the camera.",
-              "value": { "type": "boolean", "default": "false" }
-            },
             {
               "name": "priority",
               "description": "The priority of the camera.",
               "value": { "type": "number", "default": "0" }
             },
+            {
+              "name": "projection",
+              "description": "The projection of the camera.",
+              "value": {
+                "type": "'perspective' | 'orthographic'",
+                "default": "perspective"
+              }
+            },
             {
               "name": "rect",
               "description": "The rect of the camera. Accepts 4 space-separated numbers.",
@@ -1640,7 +1752,7 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas camera component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "clearColor",
@@ -1702,11 +1814,6 @@
                 "description": "Gets the near clip distance of the camera.",
                 "type": "number"
               },
-              {
-                "name": "orthographic",
-                "description": "Gets the orthographic projection of the camera.",
-                "type": "boolean"
-              },
               {
                 "name": "orthoHeight",
                 "description": "Gets the orthographic height of the camera."
@@ -1716,6 +1823,10 @@
                 "description": "Gets the priority of the camera.",
                 "type": "number"
               },
+              {
+                "name": "projection",
+                "description": "Gets the projection of the camera."
+              },
               {
                 "name": "rect",
                 "description": "Gets the rect of the camera.",
@@ -1735,8 +1846,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -1802,7 +1921,7 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas collision component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               { "name": "angularOffset" },
               { "name": "axis" },
@@ -1816,8 +1935,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -1984,7 +2111,7 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas element component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "anchor",
@@ -2095,8 +2222,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -2160,7 +2295,7 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas gsplat component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "asset",
@@ -2190,8 +2325,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -2260,7 +2403,7 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas layout child component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "minWidth",
@@ -2294,8 +2437,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -2383,7 +2534,7 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas layout group component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "orientation",
@@ -2425,8 +2576,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -2561,7 +2720,7 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas light component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "castShadows",
@@ -2640,8 +2799,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -2675,14 +2842,22 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas audio listener component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -2721,7 +2896,7 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas particle system component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "asset",
@@ -2732,8 +2907,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -2790,7 +2973,7 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas render component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "type",
@@ -2815,8 +2998,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -2888,7 +3079,7 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas rigidbody component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               { "name": "angularDamping" },
               { "name": "angularFactor" },
@@ -2903,8 +3094,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -2920,10 +3119,6 @@
           "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.",
           "doc-url": "",
           "attributes": [
-            {
-              "name": "blend",
-              "value": { "type": "boolean", "default": "false" }
-            },
             {
               "name": "enabled",
               "description": "The enabled state of the component.",
@@ -2945,8 +3140,14 @@
             },
             {
               "name": "scale-blend",
+              "description": "How the screen's resolutions are weighted against each other.",
               "value": { "type": "number", "default": "0.5" }
             },
+            {
+              "name": "scale-mode",
+              "description": "How the screen scales its contents.",
+              "value": { "type": "'none' | 'blend'", "default": "none" }
+            },
             {
               "name": "screen-space",
               "value": { "type": "boolean", "default": "false" }
@@ -2964,20 +3165,34 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas screen component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               { "name": "priority" },
               { "name": "referenceResolution" },
               { "name": "resolution" },
-              { "name": "scaleBlend" },
-              { "name": "blend" },
+              {
+                "name": "scaleBlend",
+                "description": "Gets how the screen's resolutions are weighted against each other."
+              },
+              {
+                "name": "scaleMode",
+                "description": "Gets how the screen scales its contents."
+              },
               { "name": "screenSpace" },
               {
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -3011,14 +3226,22 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas script component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -3089,8 +3312,16 @@
                 "description": "Gets the Script instance created for this element. Returns `null` until the\ninstance exists — await whenReady or the element's `ready()` promise before\naccessing it.",
                 "type": "Script | null"
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -3162,7 +3393,7 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas scrollbar component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "orientation",
@@ -3184,8 +3415,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -3223,7 +3462,7 @@
             },
             {
               "name": "horizontal",
-              "description": "Whether horizontal scrolling is enabled.",
+              "description": "Whether scrolling along the horizontal axis is enabled.",
               "value": { "type": "boolean", "default": "true" }
             },
             {
@@ -3259,7 +3498,7 @@
             },
             {
               "name": "vertical",
-              "description": "Whether vertical scrolling is enabled.",
+              "description": "Whether scrolling along the vertical axis is enabled.",
               "value": { "type": "boolean", "default": "true" }
             },
             {
@@ -3293,15 +3532,15 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas scroll view component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "horizontal",
-                "description": "Gets whether horizontal scrolling is enabled."
+                "description": "Gets whether scrolling along the horizontal axis is enabled."
               },
               {
                 "name": "vertical",
-                "description": "Gets whether vertical scrolling is enabled."
+                "description": "Gets whether scrolling along the vertical axis is enabled."
               },
               {
                 "name": "scrollMode",
@@ -3348,8 +3587,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -3421,7 +3668,7 @@
               {
                 "name": "component",
                 "description": "Gets the underlying PlayCanvas sound component.",
-                "type": "Component"
+                "type": "Component | null"
               },
               {
                 "name": "distanceModel",
@@ -3456,8 +3703,16 @@
                 "name": "enabled",
                 "description": "Gets the enabled state of the component."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {
@@ -3570,8 +3825,16 @@
                 "name": "volume",
                 "description": "Gets the volume of the sound slot."
               },
-              { "name": "closestApp", "type": "AppElement" },
-              { "name": "closestEntity", "type": "EntityElement" }
+              {
+                "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": [
               {