@playcanvas/web-components 0.18.0 → 0.20.0

package/dist/scene.d.cts

@@ -8,9 +8,14 @@ import { AsyncElement } from './async-element.cjs';
  * {@link HTMLElement} interface.
  *
  * @elementSummary The `<pc-scene>` element holds the entity hierarchy the application renders,
- * along with the scene-wide fog and gravity settings. Must be a direct child of `<pc-app>`.
+ * along with the scene-wide fog, exposure and gravity settings. Must be a direct child of
+ * `<pc-app>`.
  */
 declare class SceneElement extends AsyncElement {
+    /**
+     * The exposure of the scene.
+     */
+    private _exposure;
     /**
      * The fog type of the scene.
      */
@@ -53,6 +58,17 @@ declare class SceneElement extends AsyncElement {
      * @param value - The gravity to apply.
      */
     private _applyGravity;
+    /**
+     * Sets the exposure of the scene, which tweaks the overall brightness of the rendered image.
+     * Ignored if the scene is using physical units. Defaults to 1.
+     * @param value - The exposure.
+     */
+    set exposure(value: number);
+    /**
+     * Gets the exposure of the scene.
+     * @returns The exposure.
+     */
+    get exposure(): number;
     /**
      * Sets the fog type of the scene. Can be `none`, `linear`, `exp` or `exp2`. Defaults to
      * `none`.

package/dist/scene.d.ts

@@ -8,9 +8,14 @@ import { AsyncElement } from './async-element.js';
  * {@link HTMLElement} interface.
  *
  * @elementSummary The `<pc-scene>` element holds the entity hierarchy the application renders,
- * along with the scene-wide fog and gravity settings. Must be a direct child of `<pc-app>`.
+ * along with the scene-wide fog, exposure and gravity settings. Must be a direct child of
+ * `<pc-app>`.
  */
 declare class SceneElement extends AsyncElement {
+    /**
+     * The exposure of the scene.
+     */
+    private _exposure;
     /**
      * The fog type of the scene.
      */
@@ -53,6 +58,17 @@ declare class SceneElement extends AsyncElement {
      * @param value - The gravity to apply.
      */
     private _applyGravity;
+    /**
+     * Sets the exposure of the scene, which tweaks the overall brightness of the rendered image.
+     * Ignored if the scene is using physical units. Defaults to 1.
+     * @param value - The exposure.
+     */
+    set exposure(value: number);
+    /**
+     * Gets the exposure of the scene.
+     * @returns The exposure.
+     */
+    get exposure(): number;
     /**
      * Sets the fog type of the scene. Can be `none`, `linear`, `exp` or `exp2`. Defaults to
      * `none`.

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

@@ -171,7 +171,7 @@
     },
     {
       "name": "pc-entity",
-      "description": "The `<pc-entity>` element creates an entity: a named, transformable node of the\nscene hierarchy, and the host for component elements such as `<pc-camera>`, `<pc-light>` and\n`<pc-render>`. Place it in the `<pc-scene>`, or nest it under another `<pc-entity>`, a\n`<pc-model>` or a `<pc-node>` to parent it there.\n\n---\n\n\n### **Events:**\n - **pointerdown** - Fired when a pointer button is pressed over the entity.\n- **pointerenter** - Fired when the pointer moves onto the entity.\n- **pointerleave** - Fired when the pointer moves off the entity.\n- **pointermove** - Fired when the pointer moves over the entity.\n- **pointerup** - Fired when a pointer button is released over the entity.\n- **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.",
+      "description": "The `<pc-entity>` element creates an entity: a named, transformable node of the\nscene hierarchy, and the host for component elements such as `<pc-camera>`, `<pc-light>` and\n`<pc-render>`. Place it in the `<pc-scene>`, or nest it under another `<pc-entity>`, a\n`<pc-model>` or a `<pc-node>` to parent it there.\n\n---\n\n\n### **Events:**\n - **click** - Fired when a primary pointer button is pressed and then released over the entity. A press and release that picked different entities fires on their nearest common ancestor instead, as in the DOM. `detail` carries the click count, so a double click arrives as a click whose `detail` is 2.\n- **pointerdown** - Fired when a pointer button is pressed over the entity.\n- **pointerenter** - Fired when the pointer moves onto the entity.\n- **pointerleave** - Fired when the pointer moves off the entity.\n- **pointermove** - Fired when the pointer moves over the entity.\n- **pointerup** - Fired when a pointer button is released over the entity.\n- **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.",
       "attributes": [
         {
           "name": "enabled",
@@ -183,6 +183,11 @@
           "description": "The name of the entity.",
           "values": []
         },
+        {
+          "name": "onclick",
+          "description": "Script to run when the entity is clicked: a primary pointer button pressed and then released over it.",
+          "values": []
+        },
         {
           "name": "onpointerdown",
           "description": "Script to run when a pointer button is pressed over the entity.",
@@ -723,7 +728,7 @@
     },
     {
       "name": "pc-model",
-      "description": "The `<pc-model>` element instantiates a 3D model from a container asset\n(typically a GLB) beneath an entity of its own, so the element's transform and tags place the\ninstance in the scene. Its `<pc-node>` children override what the asset authored. Place it in the\n`<pc-scene>`, or nest it under a `<pc-entity>`, another `<pc-model>` or a `<pc-node>`.\n\n---\n\n\n### **Events:**\n - **error** - Fired when the container 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 a container asset finishes instantiating, including re-instantiation after `asset` changes. Does not bubble — listen on this element, or use a capture-phase listener on an ancestor.\n- **pointerdown** - Fired when a pointer button is pressed over the model.\n- **pointerenter** - Fired when the pointer moves onto the model.\n- **pointerleave** - Fired when the pointer moves off the model.\n- **pointermove** - Fired when the pointer moves over the model.\n- **pointerup** - Fired when a pointer button is released over the model.\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.",
+      "description": "The `<pc-model>` element instantiates a 3D model from a container asset\n(typically a GLB) beneath an entity of its own, so the element's transform and tags place the\ninstance in the scene. Its `<pc-node>` children override what the asset authored. Place it in the\n`<pc-scene>`, or nest it under a `<pc-entity>`, another `<pc-model>` or a `<pc-node>`.\n\n---\n\n\n### **Events:**\n - **click** - Fired when a primary pointer button is pressed and then released over the model. A press and release that picked different entities fires on their nearest common ancestor instead, as in the DOM. `detail` carries the click count, so a double click arrives as a click whose `detail` is 2.\n- **error** - Fired when the container 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 a container asset finishes instantiating, including re-instantiation after `asset` changes. Does not bubble — listen on this element, or use a capture-phase listener on an ancestor.\n- **pointerdown** - Fired when a pointer button is pressed over the model.\n- **pointerenter** - Fired when the pointer moves onto the model.\n- **pointerleave** - Fired when the pointer moves off the model.\n- **pointermove** - Fired when the pointer moves over the model.\n- **pointerup** - Fired when a pointer button is released over the model.\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.",
       "attributes": [
         {
           "name": "asset",
@@ -740,6 +745,11 @@
           "description": "The name of the model.",
           "values": []
         },
+        {
+          "name": "onclick",
+          "description": "Script to run when the model is clicked: a primary pointer button pressed and then released over it.",
+          "values": []
+        },
         {
           "name": "onpointerdown",
           "description": "Script to run when a pointer button is pressed over the model.",
@@ -795,7 +805,7 @@
     },
     {
       "name": "pc-node",
-      "description": "The `<pc-node>` element binds to a node inside the hierarchy a `<pc-model>`\ninstantiated and declares overrides against it: a transform, an enabled state, tags, components\nto add, or content to attach. Its `name` is a lookup, never a rename. Must be a descendant of\n`<pc-model>`.\n\n---\n\n\n### **Events:**\n - **pointerdown** - Fired when a pointer button is pressed over the node.\n- **pointerenter** - Fired when the pointer moves onto the node.\n- **pointerleave** - Fired when the pointer moves off the node.\n- **pointermove** - Fired when the pointer moves over the node.\n- **pointerup** - Fired when a pointer button is released over the node.\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.",
+      "description": "The `<pc-node>` element binds to a node inside the hierarchy a `<pc-model>`\ninstantiated and declares overrides against it: a transform, an enabled state, tags, components\nto add, or content to attach. Its `name` is a lookup, never a rename. Must be a descendant of\n`<pc-model>`.\n\n---\n\n\n### **Events:**\n - **click** - Fired when a primary pointer button is pressed and then released over the node. A press and release that picked different entities fires on their nearest common ancestor instead, as in the DOM. `detail` carries the click count, so a double click arrives as a click whose `detail` is 2.\n- **pointerdown** - Fired when a pointer button is pressed over the node.\n- **pointerenter** - Fired when the pointer moves onto the node.\n- **pointerleave** - Fired when the pointer moves off the node.\n- **pointermove** - Fired when the pointer moves over the node.\n- **pointerup** - Fired when a pointer button is released over the node.\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.",
       "attributes": [
         {
           "name": "enabled",
@@ -817,6 +827,11 @@
           "description": "The name of the node to bind, resolved within the nearest ancestor `pc-model` (or `pc-node`) once it has instantiated.",
           "values": []
         },
+        {
+          "name": "onclick",
+          "description": "Script to run when the node is clicked: a primary pointer button pressed and then released over it.",
+          "values": []
+        },
         {
           "name": "onpointerdown",
           "description": "Script to run when a pointer button is pressed over the node.",
@@ -872,8 +887,13 @@
     },
     {
       "name": "pc-scene",
-      "description": "The `<pc-scene>` element holds the entity hierarchy the application renders,\nalong with the scene-wide fog and gravity settings. Must be a direct child of `<pc-app>`.\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.",
+      "description": "The `<pc-scene>` element holds the entity hierarchy the application renders,\nalong with the scene-wide fog, exposure and gravity settings. Must be a direct child of\n`<pc-app>`.\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.",
       "attributes": [
+        {
+          "name": "exposure",
+          "description": "The exposure of the scene.",
+          "values": []
+        },
         {
           "name": "fog",
           "description": "The fog type of the scene.",
@@ -1133,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": []
         },
         {
@@ -1628,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": []
         },
         {
@@ -2172,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": []
         },
         {
@@ -2208,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": []
         },
         {
@@ -2224,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": []
         },
         {
@@ -2258,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": []
         },
         {
@@ -2268,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": []
         }
       ],
@@ -2290,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.18.0",
+  "version": "0.20.0",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -337,7 +337,7 @@
         },
         {
           "name": "pc-entity",
-          "description": "The `<pc-entity>` element creates an entity: a named, transformable node of the\nscene hierarchy, and the host for component elements such as `<pc-camera>`, `<pc-light>` and\n`<pc-render>`. Place it in the `<pc-scene>`, or nest it under another `<pc-entity>`, a\n`<pc-model>` or a `<pc-node>` to parent it there.\n\n---\n\n\n### **Events:**\n - **pointerdown** - Fired when a pointer button is pressed over the entity.\n- **pointerenter** - Fired when the pointer moves onto the entity.\n- **pointerleave** - Fired when the pointer moves off the entity.\n- **pointermove** - Fired when the pointer moves over the entity.\n- **pointerup** - Fired when a pointer button is released over the entity.\n- **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.",
+          "description": "The `<pc-entity>` element creates an entity: a named, transformable node of the\nscene hierarchy, and the host for component elements such as `<pc-camera>`, `<pc-light>` and\n`<pc-render>`. Place it in the `<pc-scene>`, or nest it under another `<pc-entity>`, a\n`<pc-model>` or a `<pc-node>` to parent it there.\n\n---\n\n\n### **Events:**\n - **click** - Fired when a primary pointer button is pressed and then released over the entity. A press and release that picked different entities fires on their nearest common ancestor instead, as in the DOM. `detail` carries the click count, so a double click arrives as a click whose `detail` is 2.\n- **pointerdown** - Fired when a pointer button is pressed over the entity.\n- **pointerenter** - Fired when the pointer moves onto the entity.\n- **pointerleave** - Fired when the pointer moves off the entity.\n- **pointermove** - Fired when the pointer moves over the entity.\n- **pointerup** - Fired when a pointer button is released over the entity.\n- **ready** - Fired when the element is fully initialized — once per readiness cycle, so an element that is torn down and re-initialized (for example by removing and re-inserting it) fires it again. Bubbles and is composed.",
           "doc-url": "https://developer.playcanvas.com/user-manual/web-components/tags/pc-entity/",
           "attributes": [
             {
@@ -350,6 +350,11 @@
               "description": "The name of the entity.",
               "value": { "type": "string" }
             },
+            {
+              "name": "onclick",
+              "description": "Script to run when the entity is clicked: a primary pointer button pressed and then released over it.",
+              "value": { "type": "string" }
+            },
             {
               "name": "onpointerdown",
               "description": "Script to run when a pointer button is pressed over the entity.",
@@ -397,6 +402,11 @@
             }
           ],
           "events": [
+            {
+              "name": "click",
+              "type": "PointerEvent",
+              "description": "Fired when a primary pointer button is pressed and then released over the entity. A press and release that picked different entities fires on their nearest common ancestor instead, as in the DOM. `detail` carries the click count, so a double click arrives as a click whose `detail` is 2."
+            },
             {
               "name": "pointerdown",
               "type": "PointerEvent",
@@ -465,6 +475,11 @@
               { "name": "tags", "description": "Gets the tags of the entity." }
             ],
             "events": [
+              {
+                "name": "click",
+                "type": "PointerEvent",
+                "description": "Fired when a primary pointer button is pressed and then released over the entity. A press and release that picked different entities fires on their nearest common ancestor instead, as in the DOM. `detail` carries the click count, so a double click arrives as a click whose `detail` is 2."
+              },
               {
                 "name": "pointerdown",
                 "type": "PointerEvent",
@@ -1293,7 +1308,7 @@
         },
         {
           "name": "pc-model",
-          "description": "The `<pc-model>` element instantiates a 3D model from a container asset\n(typically a GLB) beneath an entity of its own, so the element's transform and tags place the\ninstance in the scene. Its `<pc-node>` children override what the asset authored. Place it in the\n`<pc-scene>`, or nest it under a `<pc-entity>`, another `<pc-model>` or a `<pc-node>`.\n\n---\n\n\n### **Events:**\n - **error** - Fired when the container 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 a container asset finishes instantiating, including re-instantiation after `asset` changes. Does not bubble — listen on this element, or use a capture-phase listener on an ancestor.\n- **pointerdown** - Fired when a pointer button is pressed over the model.\n- **pointerenter** - Fired when the pointer moves onto the model.\n- **pointerleave** - Fired when the pointer moves off the model.\n- **pointermove** - Fired when the pointer moves over the model.\n- **pointerup** - Fired when a pointer button is released over the model.\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.",
+          "description": "The `<pc-model>` element instantiates a 3D model from a container asset\n(typically a GLB) beneath an entity of its own, so the element's transform and tags place the\ninstance in the scene. Its `<pc-node>` children override what the asset authored. Place it in the\n`<pc-scene>`, or nest it under a `<pc-entity>`, another `<pc-model>` or a `<pc-node>`.\n\n---\n\n\n### **Events:**\n - **click** - Fired when a primary pointer button is pressed and then released over the model. A press and release that picked different entities fires on their nearest common ancestor instead, as in the DOM. `detail` carries the click count, so a double click arrives as a click whose `detail` is 2.\n- **error** - Fired when the container 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 a container asset finishes instantiating, including re-instantiation after `asset` changes. Does not bubble — listen on this element, or use a capture-phase listener on an ancestor.\n- **pointerdown** - Fired when a pointer button is pressed over the model.\n- **pointerenter** - Fired when the pointer moves onto the model.\n- **pointerleave** - Fired when the pointer moves off the model.\n- **pointermove** - Fired when the pointer moves over the model.\n- **pointerup** - Fired when a pointer button is released over the model.\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.",
           "doc-url": "https://developer.playcanvas.com/user-manual/web-components/tags/pc-model/",
           "attributes": [
             {
@@ -1311,6 +1326,11 @@
               "description": "The name of the model.",
               "value": { "type": "string" }
             },
+            {
+              "name": "onclick",
+              "description": "Script to run when the model is clicked: a primary pointer button pressed and then released over it.",
+              "value": { "type": "string" }
+            },
             {
               "name": "onpointerdown",
               "description": "Script to run when a pointer button is pressed over the model.",
@@ -1358,6 +1378,11 @@
             }
           ],
           "events": [
+            {
+              "name": "click",
+              "type": "PointerEvent",
+              "description": "Fired when a primary pointer button is pressed and then released over the model. A press and release that picked different entities fires on their nearest common ancestor instead, as in the DOM. `detail` carries the click count, so a double click arrives as a click whose `detail` is 2."
+            },
             {
               "name": "error",
               "type": "ErrorEvent",
@@ -1446,6 +1471,11 @@
               { "name": "tags", "description": "Gets the tags of the entity." }
             ],
             "events": [
+              {
+                "name": "click",
+                "type": "PointerEvent",
+                "description": "Fired when a primary pointer button is pressed and then released over the model. A press and release that picked different entities fires on their nearest common ancestor instead, as in the DOM. `detail` carries the click count, so a double click arrives as a click whose `detail` is 2."
+              },
               {
                 "name": "error",
                 "type": "ErrorEvent",
@@ -1491,7 +1521,7 @@
         },
         {
           "name": "pc-node",
-          "description": "The `<pc-node>` element binds to a node inside the hierarchy a `<pc-model>`\ninstantiated and declares overrides against it: a transform, an enabled state, tags, components\nto add, or content to attach. Its `name` is a lookup, never a rename. Must be a descendant of\n`<pc-model>`.\n\n---\n\n\n### **Events:**\n - **pointerdown** - Fired when a pointer button is pressed over the node.\n- **pointerenter** - Fired when the pointer moves onto the node.\n- **pointerleave** - Fired when the pointer moves off the node.\n- **pointermove** - Fired when the pointer moves over the node.\n- **pointerup** - Fired when a pointer button is released over the node.\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.",
+          "description": "The `<pc-node>` element binds to a node inside the hierarchy a `<pc-model>`\ninstantiated and declares overrides against it: a transform, an enabled state, tags, components\nto add, or content to attach. Its `name` is a lookup, never a rename. Must be a descendant of\n`<pc-model>`.\n\n---\n\n\n### **Events:**\n - **click** - Fired when a primary pointer button is pressed and then released over the node. A press and release that picked different entities fires on their nearest common ancestor instead, as in the DOM. `detail` carries the click count, so a double click arrives as a click whose `detail` is 2.\n- **pointerdown** - Fired when a pointer button is pressed over the node.\n- **pointerenter** - Fired when the pointer moves onto the node.\n- **pointerleave** - Fired when the pointer moves off the node.\n- **pointermove** - Fired when the pointer moves over the node.\n- **pointerup** - Fired when a pointer button is released over the node.\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.",
           "doc-url": "https://developer.playcanvas.com/user-manual/web-components/tags/pc-node/",
           "attributes": [
             {
@@ -1514,6 +1544,11 @@
               "description": "The name of the node to bind, resolved within the nearest ancestor `pc-model` (or `pc-node`) once it has instantiated.",
               "value": { "type": "string" }
             },
+            {
+              "name": "onclick",
+              "description": "Script to run when the node is clicked: a primary pointer button pressed and then released over it.",
+              "value": { "type": "string" }
+            },
             {
               "name": "onpointerdown",
               "description": "Script to run when a pointer button is pressed over the node.",
@@ -1561,6 +1596,11 @@
             }
           ],
           "events": [
+            {
+              "name": "click",
+              "type": "PointerEvent",
+              "description": "Fired when a primary pointer button is pressed and then released over the node. A press and release that picked different entities fires on their nearest common ancestor instead, as in the DOM. `detail` carries the click count, so a double click arrives as a click whose `detail` is 2."
+            },
             {
               "name": "pointerdown",
               "type": "PointerEvent",
@@ -1661,6 +1701,11 @@
               }
             ],
             "events": [
+              {
+                "name": "click",
+                "type": "PointerEvent",
+                "description": "Fired when a primary pointer button is pressed and then released over the node. A press and release that picked different entities fires on their nearest common ancestor instead, as in the DOM. `detail` carries the click count, so a double click arrives as a click whose `detail` is 2."
+              },
               {
                 "name": "pointerdown",
                 "type": "PointerEvent",
@@ -1696,9 +1741,14 @@
         },
         {
           "name": "pc-scene",
-          "description": "The `<pc-scene>` element holds the entity hierarchy the application renders,\nalong with the scene-wide fog and gravity settings. Must be a direct child of `<pc-app>`.\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.",
+          "description": "The `<pc-scene>` element holds the entity hierarchy the application renders,\nalong with the scene-wide fog, exposure and gravity settings. Must be a direct child of\n`<pc-app>`.\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.",
           "doc-url": "https://developer.playcanvas.com/user-manual/web-components/tags/pc-scene/",
           "attributes": [
+            {
+              "name": "exposure",
+              "description": "The exposure of the scene.",
+              "value": { "type": "number", "default": "1" }
+            },
             {
               "name": "fog",
               "description": "The fog type of the scene.",
@@ -1752,6 +1802,10 @@
                 "description": "The nearest ancestor element that fronts an entity — `<pc-entity>`, `<pc-model>` or\n`<pc-node>` — or `null` if this element has no such ancestor. The search starts at the\nparent, so an element never resolves to itself.",
                 "type": "EntityBaseElement | null"
               },
+              {
+                "name": "exposure",
+                "description": "Gets the exposure of the scene."
+              },
               {
                 "name": "fog",
                 "description": "Gets the fog type of the scene."
@@ -2199,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" }
             },
             {
@@ -2292,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",
@@ -3145,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" }
             },
             {
@@ -3329,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",
@@ -4298,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" }
             },
             {
@@ -4363,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>"
               }
             ],
@@ -4403,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" }
             },
             {
@@ -4423,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" }
             },
             {
@@ -4459,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" }
             },
             {
@@ -4472,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" }
             }
           ],
@@ -4506,7 +4560,7 @@
               },
               {
                 "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",
@@ -4519,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",
@@ -4543,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",
@@ -4551,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": [
@@ -4575,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" }
             },
             {
@@ -4627,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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcanvas/web-components",
-  "version": "0.18.0",
+  "version": "0.20.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.2",
+    "mediabunny": "1.55.4",
     "opentype.js": "2.0.0",
     "playcanvas": "2.21.4",
     "prettier": "3.9.6",
     "publint": "0.3.24",
-    "rollup": "4.62.5",
+    "rollup": "4.63.1",
     "serve": "14.2.6",
     "tslib": "2.8.1",
     "typedoc": "0.28.20",