@playcanvas/web-components 0.19.0 → 0.21.0

package/dist/sky.d.cts

@@ -22,19 +22,18 @@ declare class SkyElement extends AsyncElement {
     private _appElement;
     /**
      * Incremented on every new load and on disconnect, and captured by a load when it starts. A
-     * load that resumes from an await or a load callback abandons itself if the value has moved
-     * on, so a superseded load cannot generate a skybox for a scene it no longer configures.
+     * load that resumes from an await abandons itself if the value has moved on, so a superseded
+     * load cannot generate a skybox for a scene it no longer configures. The asset subscription
+     * itself is guarded by the binding below.
      */
     private _loadGeneration;
     /**
-     * The pending asset-load subscription of the current load, if it is waiting for its asset.
-     * Held so that whatever supersedes the load can detach the handler from the asset, rather
-     * than leave it registered until the asset loads (or forever, if it never does).
+     * Watches the current texture asset while it loads. Starting a new load or disconnecting
+     * cancels it, so a superseded texture can never generate the skybox.
      */
-    private _loadHandle;
+    private _binding;
     connectedCallback(): void;
     disconnectedCallback(): void;
-    private _detachLoadHandler;
     private _generateSkybox;
     private _loadSkybox;
     private _unloadSkybox;

package/dist/sky.d.ts

@@ -22,19 +22,18 @@ declare class SkyElement extends AsyncElement {
     private _appElement;
     /**
      * Incremented on every new load and on disconnect, and captured by a load when it starts. A
-     * load that resumes from an await or a load callback abandons itself if the value has moved
-     * on, so a superseded load cannot generate a skybox for a scene it no longer configures.
+     * load that resumes from an await abandons itself if the value has moved on, so a superseded
+     * load cannot generate a skybox for a scene it no longer configures. The asset subscription
+     * itself is guarded by the binding below.
      */
     private _loadGeneration;
     /**
-     * The pending asset-load subscription of the current load, if it is waiting for its asset.
-     * Held so that whatever supersedes the load can detach the handler from the asset, rather
-     * than leave it registered until the asset loads (or forever, if it never does).
+     * Watches the current texture asset while it loads. Starting a new load or disconnecting
+     * cancels it, so a superseded texture can never generate the skybox.
      */
-    private _loadHandle;
+    private _binding;
     connectedCallback(): void;
     disconnectedCallback(): void;
-    private _detachLoadHandler;
     private _generateSkybox;
     private _loadSkybox;
     private _unloadSkybox;

package/dist/vscode.html-custom-data.json

@@ -1153,7 +1153,7 @@
         },
         {
           "name": "image",
-          "description": "The reference to the `<pc-entity>` whose image element is used for visual transitions.",
+          "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the entity whose image element is used for visual transitions, or empty for the button's own entity.",
           "values": []
         },
         {
@@ -1648,12 +1648,12 @@
         },
         {
           "name": "entity-a",
-          "description": "The reference to the `<pc-entity>` providing the first constrained body.",
+          "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the element providing the first constrained body.",
           "values": []
         },
         {
           "name": "entity-b",
-          "description": "The reference to the `<pc-entity>` providing the second constrained body.",
+          "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the element providing the second constrained body, or empty for the world-space case.",
           "values": []
         },
         {
@@ -2192,11 +2192,11 @@
     },
     {
       "name": "pc-script-instance",
-      "description": "The `<pc-script-instance>` element attaches one script class, named by `name`, to\nthe entity of its parent `<pc-script>`. Its other attributes set script attributes of the same\nname, and `attributes` takes a JSON object instead. Must be a direct child of `<pc-script>`.\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.",
+      "description": "The `<pc-script-instance>` element attaches one script class, named by `name`, to\nthe entity of its parent `<pc-script>`. Its other attributes set script attributes of the same\nname, and `attributes` takes a JSON object instead. An `entity:` value is an entity name —\nwrite `entity:#id` for an element id. Must be a direct child of `<pc-script>`.\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.",
       "attributes": [
         {
           "name": "attributes",
-          "description": "The attributes of the script.",
+          "description": "The attributes of the script as an object whose `asset:`, `entity:`, `vec2:`, `vec3:`, `vec4:` and `color:` prefixed values are resolved when applied — an `entity:` value being an entity name (nearest enclosing entity first, then outward, then the document) or a document-wide `#` selector (`entity:#id`), never a bare element id.",
           "values": []
         },
         {
@@ -2228,7 +2228,7 @@
         },
         {
           "name": "content",
-          "description": "The reference to the `<pc-entity>` used as the content.",
+          "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the entity used as the content.",
           "values": []
         },
         {
@@ -2244,7 +2244,7 @@
         },
         {
           "name": "horizontal-scrollbar",
-          "description": "The reference to the `<pc-entity>` containing the horizontal scrollbar.",
+          "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the entity containing the horizontal scrollbar.",
           "values": []
         },
         {
@@ -2278,7 +2278,7 @@
         },
         {
           "name": "vertical-scrollbar",
-          "description": "The reference to the `<pc-entity>` containing the vertical scrollbar.",
+          "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the entity containing the vertical scrollbar.",
           "values": []
         },
         {
@@ -2288,7 +2288,7 @@
         },
         {
           "name": "viewport",
-          "description": "The reference to the `<pc-entity>` used as the viewport.",
+          "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the entity used as the viewport.",
           "values": []
         }
       ],
@@ -2310,7 +2310,7 @@
         },
         {
           "name": "handle",
-          "description": "The reference to the `<pc-entity>` used as the scrollbar handle.",
+          "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the entity used as the scrollbar handle.",
           "values": []
         },
         {

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@playcanvas/web-components",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -2137,8 +2137,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas anim component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas anim component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "AnimComponent | null"
               },
               {
                 "name": "enabled",
@@ -2194,8 +2194,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas audio listener component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas audio listener component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "AudioListenerComponent | null"
               },
               {
                 "name": "enabled",
@@ -2253,7 +2253,7 @@
             },
             {
               "name": "image",
-              "description": "The reference to the `<pc-entity>` whose image element is used for visual transitions.",
+              "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the entity whose image element is used for visual transitions, or empty for the button's own entity.",
               "value": { "type": "string" }
             },
             {
@@ -2317,8 +2317,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas button component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas button component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "ButtonComponent | null"
               },
               {
                 "name": "enabled",
@@ -2346,7 +2346,7 @@
               },
               {
                 "name": "image",
-                "description": "Gets the reference to the `<pc-entity>` whose image element is used for visual transitions."
+                "description": "Gets the reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#`\nselector) to the entity whose image element is used for visual transitions, or empty for\nthe button's own entity."
               },
               {
                 "name": "inactiveSpriteAsset",
@@ -2549,8 +2549,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas camera component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas camera component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "CameraComponent | null"
               },
               {
                 "name": "cullFaces",
@@ -2705,8 +2705,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas collision component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas collision component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "CollisionComponent | null"
               },
               { "name": "convexHull" },
               {
@@ -2917,8 +2917,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas element component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas element component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "ElementComponent | null"
               },
               {
                 "name": "enabled",
@@ -3085,8 +3085,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas gsplat component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas gsplat component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "GSplatComponent | null"
               },
               {
                 "name": "enabled",
@@ -3199,12 +3199,12 @@
             },
             {
               "name": "entity-a",
-              "description": "The reference to the `<pc-entity>` providing the first constrained body.",
+              "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the element providing the first constrained body.",
               "value": { "type": "string" }
             },
             {
               "name": "entity-b",
-              "description": "The reference to the `<pc-entity>` providing the second constrained body.",
+              "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the element providing the second constrained body, or empty for the world-space case.",
               "value": { "type": "string" }
             },
             {
@@ -3366,8 +3366,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas joint component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas joint component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "JointComponent | null"
               },
               {
                 "name": "enableCollision",
@@ -3383,11 +3383,11 @@
               },
               {
                 "name": "entityA",
-                "description": "Gets the reference to the `<pc-entity>` providing the first constrained body."
+                "description": "Gets the reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#`\nselector) to the element providing the first constrained body."
               },
               {
                 "name": "entityB",
-                "description": "Gets the reference to the `<pc-entity>` providing the second constrained body."
+                "description": "Gets the reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#`\nselector) to the element providing the second constrained body, or empty for the\nworld-space case."
               },
               {
                 "name": "limits",
@@ -3532,8 +3532,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas layout child component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas layout child component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "LayoutChildComponent | null"
               },
               {
                 "name": "enabled",
@@ -3667,8 +3667,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas layout group component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas layout group component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "LayoutGroupComponent | null"
               },
               {
                 "name": "enabled",
@@ -3880,8 +3880,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas light component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas light component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "LightComponent | null"
               },
               {
                 "name": "enabled",
@@ -4008,8 +4008,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas particle system component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas particle system component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "ParticleSystemComponent | null"
               },
               {
                 "name": "enabled",
@@ -4085,8 +4085,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas render component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas render component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "RenderComponent | null"
               },
               {
                 "name": "enabled",
@@ -4188,8 +4188,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas rigidbody component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas rigidbody component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "RigidBodyComponent | null"
               },
               {
                 "name": "enabled",
@@ -4272,8 +4272,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas screen component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas screen component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "ScreenComponent | null"
               },
               {
                 "name": "enabled",
@@ -4333,8 +4333,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas script component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas script component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "ScriptComponent | null"
               },
               {
                 "name": "enabled",
@@ -4352,12 +4352,12 @@
         },
         {
           "name": "pc-script-instance",
-          "description": "The `<pc-script-instance>` element attaches one script class, named by `name`, to\nthe entity of its parent `<pc-script>`. Its other attributes set script attributes of the same\nname, and `attributes` takes a JSON object instead. Must be a direct child of `<pc-script>`.\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.",
+          "description": "The `<pc-script-instance>` element attaches one script class, named by `name`, to\nthe entity of its parent `<pc-script>`. Its other attributes set script attributes of the same\nname, and `attributes` takes a JSON object instead. An `entity:` value is an entity name —\nwrite `entity:#id` for an element id. Must be a direct child of `<pc-script>`.\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.",
           "doc-url": "https://developer.playcanvas.com/user-manual/web-components/tags/pc-script-instance/",
           "attributes": [
             {
               "name": "attributes",
-              "description": "The attributes of the script.",
+              "description": "The attributes of the script as an object whose `asset:`, `entity:`, `vec2:`, `vec3:`, `vec4:` and `color:` prefixed values are resolved when applied — an `entity:` value being an entity name (nearest enclosing entity first, then outward, then the document) or a document-wide `#` selector (`entity:#id`), never a bare element id.",
               "value": { "type": "string" }
             },
             {
@@ -4417,7 +4417,7 @@
               },
               {
                 "name": "scriptAttributes",
-                "description": "Gets the attributes of the script.",
+                "description": "Gets the attributes of the script as an object whose `asset:`, `entity:`, `vec2:`, `vec3:`,\n`vec4:` and `color:` prefixed values are resolved when applied — an `entity:` value being\nan entity name (nearest enclosing entity first, then outward, then the document) or a\ndocument-wide `#` selector (`entity:#id`), never a bare element id.",
                 "type": "Record<string, any>"
               }
             ],
@@ -4457,7 +4457,7 @@
             },
             {
               "name": "content",
-              "description": "The reference to the `<pc-entity>` used as the content.",
+              "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the entity used as the content.",
               "value": { "type": "string" }
             },
             {
@@ -4477,7 +4477,7 @@
             },
             {
               "name": "horizontal-scrollbar",
-              "description": "The reference to the `<pc-entity>` containing the horizontal scrollbar.",
+              "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the entity containing the horizontal scrollbar.",
               "value": { "type": "string" }
             },
             {
@@ -4513,7 +4513,7 @@
             },
             {
               "name": "vertical-scrollbar",
-              "description": "The reference to the `<pc-entity>` containing the vertical scrollbar.",
+              "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the entity containing the vertical scrollbar.",
               "value": { "type": "string" }
             },
             {
@@ -4526,7 +4526,7 @@
             },
             {
               "name": "viewport",
-              "description": "The reference to the `<pc-entity>` used as the viewport.",
+              "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the entity used as the viewport.",
               "value": { "type": "string" }
             }
           ],
@@ -4555,12 +4555,12 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas scroll view component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas scroll view component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "ScrollViewComponent | null"
               },
               {
                 "name": "content",
-                "description": "Gets the reference to the `<pc-entity>` used as the content."
+                "description": "Gets the reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#`\nselector) to the entity used as the content."
               },
               {
                 "name": "enabled",
@@ -4573,7 +4573,7 @@
               },
               {
                 "name": "horizontalScrollbar",
-                "description": "Gets the reference to the `<pc-entity>` containing the horizontal scrollbar."
+                "description": "Gets the reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#`\nselector) to the entity containing the horizontal scrollbar."
               },
               {
                 "name": "horizontalScrollbarVisibility",
@@ -4597,7 +4597,7 @@
               },
               {
                 "name": "verticalScrollbar",
-                "description": "Gets the reference to the `<pc-entity>` containing the vertical scrollbar."
+                "description": "Gets the reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#`\nselector) to the entity containing the vertical scrollbar."
               },
               {
                 "name": "verticalScrollbarVisibility",
@@ -4605,7 +4605,7 @@
               },
               {
                 "name": "viewport",
-                "description": "Gets the reference to the `<pc-entity>` used as the viewport."
+                "description": "Gets the reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#`\nselector) to the entity used as the viewport."
               }
             ],
             "events": [
@@ -4629,7 +4629,7 @@
             },
             {
               "name": "handle",
-              "description": "The reference to the `<pc-entity>` used as the scrollbar handle.",
+              "description": "The reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#` selector) to the entity used as the scrollbar handle.",
               "value": { "type": "string" }
             },
             {
@@ -4672,8 +4672,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas scrollbar component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas scrollbar component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "ScrollbarComponent | null"
               },
               {
                 "name": "enabled",
@@ -4681,7 +4681,7 @@
               },
               {
                 "name": "handle",
-                "description": "Gets the reference to the `<pc-entity>` used as the scrollbar handle."
+                "description": "Gets the reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#`\nselector) to the entity used as the scrollbar handle."
               },
               {
                 "name": "handleSize",
@@ -4775,8 +4775,8 @@
               },
               {
                 "name": "component",
-                "description": "Gets the underlying PlayCanvas sound component.",
-                "type": "Component | null"
+                "description": "Gets the underlying PlayCanvas sound component. `null` until the element is\nready — see ComponentElement.component.",
+                "type": "SoundComponent | null"
               },
               {
                 "name": "distanceModel",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcanvas/web-components",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "author": "PlayCanvas <support@playcanvas.com>",
   "homepage": "https://playcanvas.com",
   "description": "Web Components for the PlayCanvas Engine",
@@ -99,12 +99,12 @@
     "eslint": "9.39.5",
     "globals": "17.11.0",
     "jsdom": "30.0.1",
-    "mediabunny": "1.55.3",
+    "mediabunny": "1.55.5",
     "opentype.js": "2.0.0",
     "playcanvas": "2.21.4",
     "prettier": "3.9.6",
     "publint": "0.3.24",
-    "rollup": "4.63.0",
+    "rollup": "4.63.1",
     "serve": "14.2.6",
     "tslib": "2.8.1",
     "typedoc": "0.28.20",