@playcanvas/web-components 0.19.0 → 0.21.0

package/dist/custom-elements.json

@@ -6490,9 +6490,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "AnimComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas anim component.",
+              "description": "Gets the underlying PlayCanvas anim component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -6761,9 +6761,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "AudioListenerComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas audio listener component.",
+              "description": "Gets the underlying PlayCanvas audio listener component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -6931,9 +6931,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "ButtonComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas button component.",
+              "description": "Gets the underlying PlayCanvas button component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -7048,7 +7048,7 @@
             {
               "kind": "field",
               "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.",
               "parameters": [
                 {
                   "description": "The image entity reference.",
@@ -7261,7 +7261,7 @@
                 "text": "string"
               },
               "fieldName": "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."
             },
             {
               "name": "inactive-sprite-asset",
@@ -7524,9 +7524,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "CameraComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas camera component.",
+              "description": "Gets the underlying PlayCanvas camera component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -8157,9 +8157,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "CollisionComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas collision component.",
+              "description": "Gets the underlying PlayCanvas collision component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -8629,9 +8629,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "ElementComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas element component.",
+              "description": "Gets the underlying PlayCanvas element component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -9366,9 +9366,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "GSplatComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas gsplat component.",
+              "description": "Gets the underlying PlayCanvas gsplat component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -9594,7 +9594,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The JointComponentElement interface provides properties and methods for manipulating\n[`<pc-joint>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-joint/) elements.\nThe JointComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\nThe entity holding the joint is not itself constrained. Its world transform defines the joint\nframe — the anchor point and axes the constraint operates about — with the local X axis as the\nprimary axis: a hinge rotates about it, a slider translates along it and a ball joint twists\nabout it. The constrained bodies are referenced by `entity-a` and `entity-b`, both of which need\na rigid body component; leaving `entity-b` empty constrains `entity-a` to a fixed point in world\nspace. The underlying engine component is in alpha, so its API may change.\n",
+          "description": "The JointComponentElement interface provides properties and methods for manipulating\n[`<pc-joint>`](https://developer.playcanvas.com/user-manual/web-components/tags/pc-joint/) elements.\nThe JointComponentElement interface also inherits the properties and methods of the\nHTMLElement interface.\n\nThe entity holding the joint is not itself constrained. Its world transform defines the joint\nframe — the anchor point and axes the constraint operates about — with the local X axis as the\nprimary axis: a hinge rotates about it, a slider translates along it and a ball joint twists\nabout it. The constrained bodies are referenced by `entity-a` and `entity-b`, both of which need\na rigid body component; leaving `entity-b` empty constrains `entity-a` to a fixed point in world\nspace. A reference can name any entity-fronting element — `<pc-entity>`, `<pc-model>` or\n`<pc-node>`, so a ragdoll can join a model's own skeleton nodes by name — and a name resolves\nagainst the nearest enclosing entity first, then outward through the entity hierarchy, then the\ndocument, while a `#` selector resolves document-wide. A `<template>` prefab with one\nentity-fronting root can therefore wire its joints by name and stay self-contained when cloned.\nThe underlying engine component is in alpha, so its API may change.\n",
           "name": "JointComponentElement",
           "members": [
             {
@@ -9797,9 +9797,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "JointComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas joint component.",
+              "description": "Gets the underlying PlayCanvas joint component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -9866,7 +9866,7 @@
             {
               "kind": "field",
               "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.",
               "parameters": [
                 {
                   "description": "The first body's entity reference.",
@@ -9882,7 +9882,7 @@
             {
               "kind": "field",
               "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.",
               "parameters": [
                 {
                   "description": "The second body's entity reference.",
@@ -10314,7 +10314,7 @@
                 "text": "string"
               },
               "fieldName": "entityA",
-              "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."
             },
             {
               "name": "entity-b",
@@ -10322,7 +10322,7 @@
                 "text": "string"
               },
               "fieldName": "entityB",
-              "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."
             },
             {
               "name": "limits",
@@ -10546,9 +10546,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "LayoutChildComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas layout child component.",
+              "description": "Gets the underlying PlayCanvas layout child component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -10889,9 +10889,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "LayoutGroupComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas layout group component.",
+              "description": "Gets the underlying PlayCanvas layout group component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -11316,9 +11316,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "LightComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas light component.",
+              "description": "Gets the underlying PlayCanvas light component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -11975,9 +11975,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "ParticleSystemComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas particle system component.",
+              "description": "Gets the underlying PlayCanvas particle system component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -12176,9 +12176,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "RenderComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas render component.",
+              "description": "Gets the underlying PlayCanvas render component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -12427,9 +12427,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "RigidBodyComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas rigidbody component.",
+              "description": "Gets the underlying PlayCanvas rigidbody component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -12683,9 +12683,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "ScreenComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas screen component.",
+              "description": "Gets the underlying PlayCanvas screen component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -12937,9 +12937,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "ScriptComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas script component.",
+              "description": "Gets the underlying PlayCanvas script component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -13048,7 +13048,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The ScriptInstanceElement interface provides properties and methods for manipulating\n`<pc-script-instance>` elements. The ScriptInstanceElement 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-script>` element.\n",
+          "description": "The ScriptInstanceElement interface provides properties and methods for manipulating\n`<pc-script-instance>` elements. The ScriptInstanceElement 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. An `entity:` reference is an entity name — resolved against the nearest\n  enclosing entity first, then outward, then the document — or a document-wide `#` selector\n  (`entity:#id`); a bare value is always a name, never an element id.\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-script>` element.\n",
           "name": "ScriptInstanceElement",
           "members": [
             {
@@ -13150,7 +13150,7 @@
             {
               "kind": "field",
               "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.",
               "parameters": [
                 {
                   "description": "The attributes of the script.",
@@ -13208,7 +13208,7 @@
                 "text": "string"
               },
               "fieldName": "scriptAttributes",
-              "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."
             },
             {
               "name": "enabled",
@@ -13232,7 +13232,7 @@
             "name": "AsyncElement",
             "module": "/src/async-element"
           },
-          "summary": "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",
+          "summary": "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",
           "tagName": "pc-script-instance",
           "customElement": true
         }
@@ -13321,9 +13321,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "ScrollViewComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas scroll view component.",
+              "description": "Gets the underlying PlayCanvas scroll view component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -13338,7 +13338,7 @@
             {
               "kind": "field",
               "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.",
               "parameters": [
                 {
                   "description": "The content entity reference.",
@@ -13406,7 +13406,7 @@
             {
               "kind": "field",
               "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.",
               "parameters": [
                 {
                   "description": "The horizontal scrollbar entity reference.",
@@ -13516,7 +13516,7 @@
             {
               "kind": "field",
               "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.",
               "parameters": [
                 {
                   "description": "The vertical scrollbar entity reference.",
@@ -13548,7 +13548,7 @@
             {
               "kind": "field",
               "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.",
               "parameters": [
                 {
                   "description": "The viewport entity reference.",
@@ -13578,7 +13578,7 @@
                 "text": "string"
               },
               "fieldName": "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."
             },
             {
               "name": "enabled",
@@ -13617,7 +13617,7 @@
                 "text": "string"
               },
               "fieldName": "horizontalScrollbar",
-              "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."
             },
             {
               "name": "horizontal-scrollbar-visibility",
@@ -13670,7 +13670,7 @@
                 "text": "string"
               },
               "fieldName": "verticalScrollbar",
-              "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."
             },
             {
               "name": "vertical-scrollbar-visibility",
@@ -13687,7 +13687,7 @@
                 "text": "string"
               },
               "fieldName": "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."
             }
           ],
           "superclass": {
@@ -13780,9 +13780,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "ScrollbarComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas scrollbar component.",
+              "description": "Gets the underlying PlayCanvas scrollbar component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""
@@ -13817,7 +13817,7 @@
             {
               "kind": "field",
               "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.",
               "parameters": [
                 {
                   "description": "The handle entity reference.",
@@ -13913,7 +13913,7 @@
                 "text": "string"
               },
               "fieldName": "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."
             },
             {
               "name": "handle-size",
@@ -14033,9 +14033,9 @@
               "kind": "field",
               "name": "component",
               "type": {
-                "text": "Component | null"
+                "text": "SoundComponent | null"
               },
-              "description": "Gets the underlying PlayCanvas sound component.",
+              "description": "Gets the underlying PlayCanvas sound component. `null` until the element is\nready — see ComponentElement.component.",
               "return": {
                 "type": {
                   "text": ""

package/dist/entity-reference.d.cts

@@ -0,0 +1,13 @@
+/**
+ * Resolves entity reference strings against the document. A reference beginning with `#` is a
+ * document-wide selector (an element id, or any selector rooted in one); anything else is an
+ * entity name, resolved lexically through the entity hierarchy first and against the document
+ * after — never as a selector or an id.
+ *
+ * Unlike the attribute parsers in `parse.ts`, these helpers touch the DOM, and `findEntityElement`
+ * and `getEntity` return `null` instead of falling back to a default. They also do not warn -
+ * what an unresolved reference means depends on the element holding it - so elements report
+ * through `resolveEntity`, which takes that meaning as parameters, and `pc-script` builds its own
+ * message from the lower-level pieces.
+ */
+export {};

package/dist/entity-reference.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Resolves entity reference strings against the document. A reference beginning with `#` is a
+ * document-wide selector (an element id, or any selector rooted in one); anything else is an
+ * entity name, resolved lexically through the entity hierarchy first and against the document
+ * after — never as a selector or an id.
+ *
+ * Unlike the attribute parsers in `parse.ts`, these helpers touch the DOM, and `findEntityElement`
+ * and `getEntity` return `null` instead of falling back to a default. They also do not warn -
+ * what an unresolved reference means depends on the element holding it - so elements report
+ * through `resolveEntity`, which takes that meaning as parameters, and `pc-script` builds its own
+ * message from the lower-level pieces.
+ */
+export {};

package/dist/material.d.cts

@@ -130,11 +130,12 @@ declare class MaterialElement extends HTMLElement {
     private _useSkybox;
     private _useTonemap;
     /**
-     * Pending `load` handlers, one per texture slot. A slot's handler is torn down when the slot is
-     * reassigned or the element disconnects, so a late-arriving asset can never write a texture the
-     * element no longer wants.
+     * One asset binding per texture slot, created on first use and kept for the element's
+     * lifetime. A slot's binding is superseded when the slot is reassigned and cancelled when the
+     * element disconnects, so a late-arriving asset can never write a texture the element no
+     * longer wants.
      */
-    private _mapHandles;
+    private _mapBindings;
     private _updateScheduled;
     private _glossConflictWarned;
     /**
@@ -163,8 +164,9 @@ declare class MaterialElement extends HTMLElement {
      */
     private _warnGlossConflict;
     /**
-     * Points a texture slot at the resource of a `pc-asset`, waiting for the asset to load when it
-     * has not already. An empty id clears the slot.
+     * Points a texture slot at the resource of a `pc-asset`, waiting for the asset to load when
+     * it has not already. An empty id clears the slot; a slot keeps its current texture while
+     * the new asset loads, and also across a failed load - a later reload can still deliver.
      *
      * @param id - The id of the `pc-asset`, or an empty string to clear the slot.
      * @param slot - The material property to write.

package/dist/material.d.ts

@@ -130,11 +130,12 @@ declare class MaterialElement extends HTMLElement {
     private _useSkybox;
     private _useTonemap;
     /**
-     * Pending `load` handlers, one per texture slot. A slot's handler is torn down when the slot is
-     * reassigned or the element disconnects, so a late-arriving asset can never write a texture the
-     * element no longer wants.
+     * One asset binding per texture slot, created on first use and kept for the element's
+     * lifetime. A slot's binding is superseded when the slot is reassigned and cancelled when the
+     * element disconnects, so a late-arriving asset can never write a texture the element no
+     * longer wants.
      */
-    private _mapHandles;
+    private _mapBindings;
     private _updateScheduled;
     private _glossConflictWarned;
     /**
@@ -163,8 +164,9 @@ declare class MaterialElement extends HTMLElement {
      */
     private _warnGlossConflict;
     /**
-     * Points a texture slot at the resource of a `pc-asset`, waiting for the asset to load when it
-     * has not already. An empty id clears the slot.
+     * Points a texture slot at the resource of a `pc-asset`, waiting for the asset to load when
+     * it has not already. An empty id clears the slot; a slot keeps its current texture while
+     * the new asset loads, and also across a failed load - a later reload can still deliver.
      *
      * @param id - The id of the `pc-asset`, or an empty string to clear the slot.
      * @param slot - The material property to write.

package/dist/model.d.cts

@@ -120,18 +120,18 @@ declare class ModelElement extends EntityOwnerElement {
     private _contentEntity;
     /**
      * Incremented on every new load, on disconnect, and when the host entity dies, 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 can neither instantiate a second
-     * content root nor parent one under a host a newer cycle has already replaced.
+     * by a load when it starts. A load that resumes from an await abandons itself if the value
+     * has moved on, so a superseded load can neither instantiate a second content root nor
+     * parent one under a host a newer cycle has already replaced. The asset subscription itself
+     * is guarded by the binding below.
      */
     private _loadGeneration;
     /**
-     * The pending asset subscriptions of the current load, if it is waiting for its asset. Held
-     * so that whatever supersedes the load can detach the handlers from the asset, rather than
-     * leave them registered until the asset settles (or forever, if it never does).
+     * The subscription to the current container asset while it is loading. Whatever supersedes
+     * the load — a newer load, a disconnect, the host dying — cancels it, so the asset settling
+     * later cannot deliver to a load that no longer owns the element.
      */
-    private _loadHandle;
-    private _errorHandle;
+    private _binding;
     /**
      * The root entity of the instantiated model content, parented beneath the host entity.
      * `null` until the container asset has loaded and been instantiated, after a failed load,
@@ -170,7 +170,6 @@ declare class ModelElement extends EntityOwnerElement {
      * @param entity - The host entity that was destroyed.
      */
     protected _onEntityDestroy(entity: Entity): void;
-    private _detachLoadHandlers;
     /**
      * Resolves readiness and dispatches the `load` event. Called once the instantiated content
      * has been parented beneath the host — the host itself is already in the scene graph by

package/dist/model.d.ts

@@ -120,18 +120,18 @@ declare class ModelElement extends EntityOwnerElement {
     private _contentEntity;
     /**
      * Incremented on every new load, on disconnect, and when the host entity dies, 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 can neither instantiate a second
-     * content root nor parent one under a host a newer cycle has already replaced.
+     * by a load when it starts. A load that resumes from an await abandons itself if the value
+     * has moved on, so a superseded load can neither instantiate a second content root nor
+     * parent one under a host a newer cycle has already replaced. The asset subscription itself
+     * is guarded by the binding below.
      */
     private _loadGeneration;
     /**
-     * The pending asset subscriptions of the current load, if it is waiting for its asset. Held
-     * so that whatever supersedes the load can detach the handlers from the asset, rather than
-     * leave them registered until the asset settles (or forever, if it never does).
+     * The subscription to the current container asset while it is loading. Whatever supersedes
+     * the load — a newer load, a disconnect, the host dying — cancels it, so the asset settling
+     * later cannot deliver to a load that no longer owns the element.
      */
-    private _loadHandle;
-    private _errorHandle;
+    private _binding;
     /**
      * The root entity of the instantiated model content, parented beneath the host entity.
      * `null` until the container asset has loaded and been instantiated, after a failed load,
@@ -170,7 +170,6 @@ declare class ModelElement extends EntityOwnerElement {
      * @param entity - The host entity that was destroyed.
      */
     protected _onEntityDestroy(entity: Entity): void;
-    private _detachLoadHandlers;
     /**
      * Resolves readiness and dispatches the `load` event. Called once the instantiated content
      * has been parented beneath the host — the host itself is already in the scene graph by

package/dist/parse.d.cts

@@ -11,8 +11,5 @@
  *   shared frozen constants (`Vec3.ZERO`, `Color.WHITE`) as defaults.
  * - `parseBool` and `parseTags` take no attribute name, because every value is valid for them and
  *   so they never warn.
- *
- * `getEntity` is the exception: it resolves a reference to a live entity rather than parsing a
- * literal, and returns `null` instead of falling back to a default.
  */
 export {};

package/dist/parse.d.ts

@@ -11,8 +11,5 @@
  *   shared frozen constants (`Vec3.ZERO`, `Color.WHITE`) as defaults.
  * - `parseBool` and `parseTags` take no attribute name, because every value is valid for them and
  *   so they never warn.
- *
- * `getEntity` is the exception: it resolves a reference to a live entity rather than parsing a
- * literal, and returns `null` instead of falling back to a default.
  */
 export {};

package/dist/pointer-controller.d.cts

@@ -0,0 +1 @@
+export {};

package/dist/pointer-controller.d.ts

@@ -0,0 +1 @@
+export {};