@playcanvas/web-components 0.1.10 → 0.1.12

package/dist/pwc.mjs

@@ -13,11 +13,11 @@ class AsyncElement extends HTMLElement {
     }
     get closestApp() {
         var _a;
-        return (_a = this.parentElement) === null || _a === void 0 ? void 0 : _a.closest('pc-app');
+        return (_a = this.parentElement) === null || _a === undefined ? undefined : _a.closest('pc-app');
     }
     get closestEntity() {
         var _a;
-        return (_a = this.parentElement) === null || _a === void 0 ? void 0 : _a.closest('pc-entity');
+        return (_a = this.parentElement) === null || _a === undefined ? undefined : _a.closest('pc-entity');
     }
     /**
      * Called when the element is fully initialized and ready.
@@ -38,8 +38,9 @@ class AsyncElement extends HTMLElement {
 
 /**
  * The ModuleElement interface provides properties and methods for manipulating
- * `<pc-module>` elements. The ModuleElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-module/ | `<pc-module>`} elements.
+ * The ModuleElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  */
 class ModuleElement extends HTMLElement {
     /** @ignore */
@@ -77,7 +78,10 @@ class ModuleElement extends HTMLElement {
 customElements.define('pc-module', ModuleElement);
 
 /**
- * The main application element.
+ * The AppElement interface provides properties and methods for manipulating
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-app/ | `<pc-app>`} elements.
+ * The AppElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  */
 class AppElement extends AsyncElement {
     /**
@@ -236,13 +240,14 @@ class AppElement extends AsyncElement {
         // Get the currently hovered entity by walking up the hierarchy
         let newHoverEntity = null;
         if (selection.length > 0) {
-            let node = selection[0].node;
-            while (node && !newHoverEntity) {
-                const entityElement = this.querySelector(`pc-entity[name="${node.name}"]`);
+            let currentNode = selection[0].node;
+            while (currentNode !== null) {
+                const entityElement = this.querySelector(`pc-entity[name="${currentNode.name}"]`);
                 if (entityElement) {
                     newHoverEntity = entityElement;
+                    break;
                 }
-                node = node.parent;
+                currentNode = currentNode.parent;
             }
         }
         // Handle enter/leave events
@@ -273,14 +278,14 @@ class AppElement extends AsyncElement {
         this._picker.prepare(camera, this.app.scene);
         const selection = this._picker.getSelection(x, y);
         if (selection.length > 0) {
-            let node = selection[0].node;
-            while (node) {
-                const entityElement = this.querySelector(`pc-entity[name="${node.name}"]`);
+            let currentNode = selection[0].node;
+            while (currentNode !== null) {
+                const entityElement = this.querySelector(`pc-entity[name="${currentNode.name}"]`);
                 if (entityElement && entityElement.hasListeners('pointerdown')) {
                     entityElement.dispatchEvent(new PointerEvent('pointerdown', event));
                     break;
                 }
-                node = node.parent;
+                currentNode = currentNode.parent;
             }
         }
     }
@@ -649,8 +654,9 @@ const parseVec4 = (value) => {
 
 /**
  * The EntityElement interface provides properties and methods for manipulating
- * `<pc-entity>` elements. The EntityElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-entity/ | `<pc-entity>`} elements.
+ * The EntityElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  */
 class EntityElement extends AsyncElement {
     constructor() {
@@ -740,7 +746,7 @@ class EntityElement extends AsyncElement {
         if (!this.entity)
             return;
         const closestEntity = this.closestEntity;
-        if (closestEntity === null || closestEntity === void 0 ? void 0 : closestEntity.entity) {
+        if (closestEntity === null || closestEntity === undefined ? undefined : closestEntity.entity) {
             closestEntity.entity.addChild(this.entity);
         }
         else {
@@ -962,7 +968,7 @@ class EntityElement extends AsyncElement {
     }
     hasListeners(type) {
         var _a;
-        return Boolean((_a = this._listeners[type]) === null || _a === void 0 ? void 0 : _a.length);
+        return Boolean((_a = this._listeners[type]) === null || _a === undefined ? undefined : _a.length);
     }
 }
 customElements.define('pc-entity', EntityElement);
@@ -988,8 +994,9 @@ const extToType = new Map([
 ]);
 /**
  * The AssetElement interface provides properties and methods for manipulating
- * `<pc-asset>` elements. The AssetElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-asset/ | `<pc-asset>`} elements.
+ * The AssetElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  */
 class AssetElement extends HTMLElement {
     constructor() {
@@ -1011,7 +1018,7 @@ class AssetElement extends HTMLElement {
         // If no type is specified, try to infer it from the file extension.
         if (!type) {
             const ext = src.split('.').pop();
-            type = (_a = extToType.get(ext || '')) !== null && _a !== void 0 ? _a : null;
+            type = (_a = extToType.get(ext || '')) !== null && _a !== undefined ? _a : null;
         }
         if (!type) {
             console.warn(`Unsupported asset type: ${src}`);
@@ -1045,7 +1052,7 @@ class AssetElement extends HTMLElement {
     }
     static get(id) {
         const assetElement = document.querySelector(`pc-asset[id="${id}"]`);
-        return assetElement === null || assetElement === void 0 ? void 0 : assetElement.asset;
+        return assetElement === null || assetElement === undefined ? undefined : assetElement.asset;
     }
     static get observedAttributes() {
         return ['preload'];
@@ -1092,7 +1099,7 @@ class ComponentElement extends AsyncElement {
     initComponent() { }
     async connectedCallback() {
         var _a;
-        await ((_a = this.closestApp) === null || _a === void 0 ? void 0 : _a.ready());
+        await ((_a = this.closestApp) === null || _a === undefined ? undefined : _a.ready());
         await this.addComponent();
         this.initComponent();
         this._onReady();
@@ -1138,8 +1145,9 @@ class ComponentElement extends AsyncElement {
 
 /**
  * The ListenerComponentElement interface provides properties and methods for manipulating
- * `<pc-listener>` elements. The ListenerComponentElement interface also inherits the properties
- * and methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-listener/ | `<pc-listener>`} elements.
+ * The ListenerComponentElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  *
  * @category Components
  */
@@ -1149,7 +1157,7 @@ class ListenerComponentElement extends ComponentElement {
         super('audiolistener');
     }
     /**
-     * Gets the audio listener component.
+     * Gets the underlying PlayCanvas audio listener component.
      * @returns The audio listener component.
      */
     get component() {
@@ -1169,8 +1177,9 @@ const tonemaps = new Map([
 ]);
 /**
  * The CameraComponentElement interface provides properties and methods for manipulating
- * `<pc-camera>` elements. The CameraComponentElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-camera/ | `<pc-camera>`} elements.
+ * The CameraComponentElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  *
  * @category Components
  */
@@ -1188,6 +1197,7 @@ class CameraComponentElement extends ComponentElement {
         this._fov = 45;
         this._frustumCulling = true;
         this._gamma = 'srgb';
+        this._horizontalFov = false;
         this._nearClip = 0.1;
         this._orthographic = false;
         this._orthoHeight = 10;
@@ -1208,6 +1218,7 @@ class CameraComponentElement extends ComponentElement {
             fov: this._fov,
             frustumCulling: this._frustumCulling,
             gammaCorrection: this._gamma === 'srgb' ? GAMMA_SRGB : GAMMA_NONE,
+            horizontalFov: this._horizontalFov,
             nearClip: this._nearClip,
             orthographic: this._orthographic,
             orthoHeight: this._orthoHeight,
@@ -1219,7 +1230,7 @@ class CameraComponentElement extends ComponentElement {
     }
     get xrAvailable() {
         var _a;
-        const xrManager = (_a = this.component) === null || _a === void 0 ? void 0 : _a.system.app.xr;
+        const xrManager = (_a = this.component) === null || _a === undefined ? undefined : _a.system.app.xr;
         return xrManager && xrManager.supported && xrManager.isAvailable(XRTYPE_VR);
     }
     startXr(type, space) {
@@ -1238,7 +1249,7 @@ class CameraComponentElement extends ComponentElement {
         }
     }
     /**
-     * Gets the camera component.
+     * Gets the underlying PlayCanvas camera component.
      * @returns The camera component.
      */
     get component() {
@@ -1414,6 +1425,24 @@ class CameraComponentElement extends ComponentElement {
     get gamma() {
         return this._gamma;
     }
+    /**
+     * Sets whether the camera's field of view (fov) is horizontal or vertical. Defaults to false
+     * (meaning it is vertical be default).
+     * @param value - Whether the camera's field of view is horizontal.
+     */
+    set horizontalFov(value) {
+        this._horizontalFov = value;
+        if (this.component) {
+            this.component.horizontalFov = value;
+        }
+    }
+    /**
+     * Gets whether the camera's field of view (fov) is horizontal or vertical.
+     * @returns Whether the camera's field of view is horizontal.
+     */
+    get horizontalFov() {
+        return this._horizontalFov;
+    }
     /**
      * Sets the near clip distance of the camera.
      * @param value - The near clip distance.
@@ -1524,7 +1553,7 @@ class CameraComponentElement extends ComponentElement {
         var _a;
         this._tonemap = value;
         if (this.component) {
-            this.component.toneMapping = (_a = tonemaps.get(value)) !== null && _a !== void 0 ? _a : TONEMAP_NONE;
+            this.component.toneMapping = (_a = tonemaps.get(value)) !== null && _a !== undefined ? _a : TONEMAP_NONE;
         }
     }
     /**
@@ -1547,6 +1576,7 @@ class CameraComponentElement extends ComponentElement {
             'fov',
             'frustum-culling',
             'gamma',
+            'horizontal-fov',
             'near-clip',
             'orthographic',
             'ortho-height',
@@ -1589,6 +1619,9 @@ class CameraComponentElement extends ComponentElement {
             case 'gamma':
                 this.gamma = newValue;
                 break;
+            case 'horizontal-fov':
+                this.horizontalFov = this.hasAttribute('horizontal-fov');
+                break;
             case 'near-clip':
                 this.nearClip = parseFloat(newValue);
                 break;
@@ -1617,8 +1650,9 @@ customElements.define('pc-camera', CameraComponentElement);
 
 /**
  * The CollisionComponentElement interface provides properties and methods for manipulating
- * `<pc-collision>` elements. The CollisionComponentElement interface also inherits the properties
- * and methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-collision/ | `<pc-collision>`} elements.
+ * The CollisionComponentElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  *
  * @category Components
  */
@@ -1648,7 +1682,7 @@ class CollisionComponentElement extends ComponentElement {
         };
     }
     /**
-     * Gets the collision component.
+     * Gets the underlying PlayCanvas collision component.
      * @returns The collision component.
      */
     get component() {
@@ -1763,8 +1797,9 @@ customElements.define('pc-collision', CollisionComponentElement);
 
 /**
  * The ElementComponentElement interface provides properties and methods for manipulating
- * `<pc-element>` elements. The ElementComponentElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-element/ | `<pc-element>`} elements.
+ * The ElementComponentElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  *
  * @category Components
  */
@@ -1803,21 +1838,33 @@ class ElementComponentElement extends ComponentElement {
         };
     }
     /**
-     * Gets the element component.
+     * Gets the underlying PlayCanvas element component.
      * @returns The element component.
      */
     get component() {
         return super.component;
     }
+    /**
+     * Sets the anchor of the element component.
+     * @param value - The anchor.
+     */
     set anchor(value) {
         this._anchor = value;
         if (this.component) {
             this.component.anchor = value;
         }
     }
+    /**
+     * Gets the anchor of the element component.
+     * @returns The anchor.
+     */
     get anchor() {
         return this._anchor;
     }
+    /**
+     * Sets the id of the `pc-asset` to use for the font.
+     * @param value - The asset ID.
+     */
     set asset(value) {
         this._asset = value;
         const asset = AssetElement.get(value);
@@ -1825,60 +1872,112 @@ class ElementComponentElement extends ComponentElement {
             this.component.fontAsset = asset.id;
         }
     }
+    /**
+     * Gets the id of the `pc-asset` to use for the font.
+     * @returns The asset ID.
+     */
     get asset() {
         return this._asset;
     }
+    /**
+     * Sets whether the element component should automatically adjust its width.
+     * @param value - Whether to automatically adjust the width.
+     */
     set autoWidth(value) {
         this._autoWidth = value;
         if (this.component) {
             this.component.autoWidth = value;
         }
     }
+    /**
+     * Gets whether the element component should automatically adjust its width.
+     * @returns Whether to automatically adjust the width.
+     */
     get autoWidth() {
         return this._autoWidth;
     }
+    /**
+     * Sets the color of the element component.
+     * @param value - The color.
+     */
     set color(value) {
         this._color = value;
         if (this.component) {
             this.component.color = value;
         }
     }
+    /**
+     * Gets the color of the element component.
+     * @returns The color.
+     */
     get color() {
         return this._color;
     }
+    /**
+     * Sets the font size of the element component.
+     * @param value - The font size.
+     */
     set fontSize(value) {
         this._fontSize = value;
         if (this.component) {
             this.component.fontSize = value;
         }
     }
+    /**
+     * Gets the font size of the element component.
+     * @returns The font size.
+     */
     get fontSize() {
         return this._fontSize;
     }
+    /**
+     * Sets the line height of the element component.
+     * @param value - The line height.
+     */
     set lineHeight(value) {
         this._lineHeight = value;
         if (this.component) {
             this.component.lineHeight = value;
         }
     }
+    /**
+     * Gets the line height of the element component.
+     * @returns The line height.
+     */
     get lineHeight() {
         return this._lineHeight;
     }
+    /**
+     * Sets the pivot of the element component.
+     * @param value - The pivot.
+     */
     set pivot(value) {
         this._pivot = value;
         if (this.component) {
             this.component.pivot = value;
         }
     }
+    /**
+     * Gets the pivot of the element component.
+     * @returns The pivot.
+     */
     get pivot() {
         return this._pivot;
     }
+    /**
+     * Sets the text of the element component.
+     * @param value - The text.
+     */
     set text(value) {
         this._text = value;
         if (this.component) {
             this.component.text = value;
         }
     }
+    /**
+     * Gets the text of the element component.
+     * @returns The text.
+     */
     get text() {
         return this._text;
     }
@@ -1899,21 +1998,37 @@ class ElementComponentElement extends ComponentElement {
     get type() {
         return this._type;
     }
+    /**
+     * Sets the width of the element component.
+     * @param value - The width.
+     */
     set width(value) {
         this._width = value;
         if (this.component) {
             this.component.width = value;
         }
     }
+    /**
+     * Gets the width of the element component.
+     * @returns The width.
+     */
     get width() {
         return this._width;
     }
+    /**
+     * Sets whether the element component should wrap lines.
+     * @param value - Whether to wrap lines.
+     */
     set wrapLines(value) {
         this._wrapLines = value;
         if (this.component) {
             this.component.wrapLines = value;
         }
     }
+    /**
+     * Gets whether the element component should wrap lines.
+     * @returns Whether to wrap lines.
+     */
     get wrapLines() {
         return this._wrapLines;
     }
@@ -1975,13 +2090,14 @@ class ElementComponentElement extends ComponentElement {
 customElements.define('pc-element', ElementComponentElement);
 
 /**
- * The GSplatComponentElement interface provides properties and methods for manipulating
- * `<pc-splat>` elements. The GSplatComponentElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * The SplatComponentElement interface provides properties and methods for manipulating
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-splat/ | `<pc-splat>`} elements.
+ * The SplatComponentElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  *
  * @category Components
  */
-class GSplatComponentElement extends ComponentElement {
+class SplatComponentElement extends ComponentElement {
     /** @ignore */
     constructor() {
         super('gsplat');
@@ -1993,12 +2109,16 @@ class GSplatComponentElement extends ComponentElement {
         };
     }
     /**
-     * Gets the gsplat component.
-     * @returns The gsplat component.
+     * Gets the underlying PlayCanvas splat component.
+     * @returns The splat component.
      */
     get component() {
         return super.component;
     }
+    /**
+     * Sets id of the `pc-asset` to use for the splat.
+     * @param value - The asset ID.
+     */
     set asset(value) {
         this._asset = value;
         const asset = AssetElement.get(value);
@@ -2006,6 +2126,10 @@ class GSplatComponentElement extends ComponentElement {
             this.component.asset = asset;
         }
     }
+    /**
+     * Gets the id of the `pc-asset` to use for the splat.
+     * @returns The asset ID.
+     */
     get asset() {
         return this._asset;
     }
@@ -2021,7 +2145,7 @@ class GSplatComponentElement extends ComponentElement {
         }
     }
 }
-customElements.define('pc-splat', GSplatComponentElement);
+customElements.define('pc-splat', SplatComponentElement);
 
 const shadowTypes = new Map([
     ['pcf1-16f', SHADOW_PCF1_16F],
@@ -2036,8 +2160,9 @@ const shadowTypes = new Map([
 ]);
 /**
  * The LightComponentElement interface provides properties and methods for manipulating
- * `<pc-light>` elements. The LightComponentElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-light/ | `<pc-light>`} elements.
+ * The LightComponentElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  *
  * @category Components
  */
@@ -2079,7 +2204,7 @@ class LightComponentElement extends ComponentElement {
         };
     }
     /**
-     * Gets the light component.
+     * Gets the underlying PlayCanvas light component.
      * @returns The light component.
      */
     get component() {
@@ -2290,7 +2415,7 @@ class LightComponentElement extends ComponentElement {
         var _a;
         this._shadowType = value;
         if (this.component) {
-            this.component.shadowType = (_a = shadowTypes.get(value)) !== null && _a !== void 0 ? _a : SHADOW_PCF3_32F;
+            this.component.shadowType = (_a = shadowTypes.get(value)) !== null && _a !== undefined ? _a : SHADOW_PCF3_32F;
         }
     }
     /**
@@ -2409,8 +2534,9 @@ customElements.define('pc-light', LightComponentElement);
 
 /**
  * The MaterialElement interface provides properties and methods for manipulating
- * `<pc-material>` elements. The MaterialElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-material/ | `<pc-material>`} elements.
+ * The MaterialElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  */
 class MaterialElement extends HTMLElement {
     constructor() {
@@ -2496,7 +2622,7 @@ class MaterialElement extends HTMLElement {
     }
     static get(id) {
         const materialElement = document.querySelector(`pc-material[id="${id}"]`);
-        return materialElement === null || materialElement === void 0 ? void 0 : materialElement.material;
+        return materialElement === null || materialElement === undefined ? undefined : materialElement.material;
     }
     static get observedAttributes() {
         return ['diffuse', 'diffuse-map', 'metalness-map', 'normal-map', 'roughness-map'];
@@ -2525,8 +2651,9 @@ customElements.define('pc-material', MaterialElement);
 
 /**
  * The RenderComponentElement interface provides properties and methods for manipulating
- * `<pc-render>` elements. The RenderComponentElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-render/ | `<pc-render>`} elements.
+ * The RenderComponentElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  *
  * @category Components
  */
@@ -2548,7 +2675,7 @@ class RenderComponentElement extends ComponentElement {
         };
     }
     /**
-     * Gets the render component.
+     * Gets the underlying PlayCanvas render component.
      * @returns The render component.
      */
     get component() {
@@ -2647,8 +2774,9 @@ customElements.define('pc-render', RenderComponentElement);
 
 /**
  * The RigidBodyComponentElement interface provides properties and methods for manipulating
- * `<pc-rigidbody>` elements. The RigidBodyComponentElement interface also inherits the properties
- * and methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-rigidbody/ | `<pc-rigidbody>`} elements.
+ * The RigidBodyComponentElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  *
  * @category Components
  */
@@ -2707,8 +2835,8 @@ class RigidBodyComponentElement extends ComponentElement {
         };
     }
     /**
-     * Gets the collision component.
-     * @returns The collision component.
+     * Gets the underlying PlayCanvas rigidbody component.
+     * @returns The rigidbody component.
      */
     get component() {
         return super.component;
@@ -2834,8 +2962,9 @@ customElements.define('pc-rigidbody', RigidBodyComponentElement);
 
 /**
  * The ScreenComponentElement interface provides properties and methods for manipulating
- * `<pc-screen>` elements. The ScreenComponentElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-screen/ | `<pc-screen>`} elements.
+ * The ScreenComponentElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  *
  * @category Components
  */
@@ -2861,7 +2990,7 @@ class ScreenComponentElement extends ComponentElement {
         };
     }
     /**
-     * Gets the screen component.
+     * Gets the underlying PlayCanvas screen component.
      * @returns The screen component.
      */
     get component() {
@@ -2960,8 +3089,9 @@ customElements.define('pc-screen', ScreenComponentElement);
 
 /**
  * The ScriptComponentElement interface provides properties and methods for manipulating
- * `<pc-scripts>` elements. The ScriptComponentElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-scripts/ | `<pc-scripts>`} elements.
+ * The ScriptComponentElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  *
  * @category Components
  */
@@ -3108,10 +3238,10 @@ class ScriptComponentElement extends ComponentElement {
     disconnectedCallback() {
         var _a;
         this.observer.disconnect();
-        (_a = super.disconnectedCallback) === null || _a === void 0 ? void 0 : _a.call(this);
+        (_a = super.disconnectedCallback) === null || _a === undefined ? undefined : _a.call(this);
     }
     /**
-     * Gets the script component.
+     * Gets the underlying PlayCanvas script component.
      * @returns The script component.
      */
     get component() {
@@ -3203,8 +3333,9 @@ customElements.define('pc-script', ScriptElement);
 
 /**
  * The SoundComponentElement interface provides properties and methods for manipulating
- * `<pc-sounds>` elements. The SoundComponentElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-sounds/ | `<pc-sounds>`} elements.
+ * The SoundComponentElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  *
  * @category Components
  */
@@ -3232,7 +3363,7 @@ class SoundComponentElement extends ComponentElement {
         };
     }
     /**
-     * Gets the sound component.
+     * Gets the underlying PlayCanvas sound component.
      * @returns The sound component.
      */
     get component() {
@@ -3422,7 +3553,7 @@ class SoundSlotElement extends AsyncElement {
     }
     async connectedCallback() {
         var _a;
-        await ((_a = this.soundElement) === null || _a === void 0 ? void 0 : _a.ready());
+        await ((_a = this.soundElement) === null || _a === undefined ? undefined : _a.ready());
         const options = {
             autoPlay: this._autoPlay,
             loop: this._loop,
@@ -3451,21 +3582,21 @@ class SoundSlotElement extends AsyncElement {
         return soundElement;
     }
     /**
-     * Sets the asset of the sound slot.
+     * Sets the id of the `pc-asset` to use for the sound slot.
      * @param value - The asset.
      */
     set asset(value) {
         var _a;
         this._asset = value;
         if (this.soundSlot) {
-            const id = (_a = AssetElement.get(value)) === null || _a === void 0 ? void 0 : _a.id;
+            const id = (_a = AssetElement.get(value)) === null || _a === undefined ? undefined : _a.id;
             if (id) {
                 this.soundSlot.asset = id;
             }
         }
     }
     /**
-     * Gets the asset of the sound slot.
+     * Gets the id of the `pc-asset` to use for the sound slot.
      * @returns The asset.
      */
     get asset() {
@@ -3643,8 +3774,9 @@ customElements.define('pc-sound', SoundSlotElement);
 
 /**
  * The ModelElement interface provides properties and methods for manipulating
- * `<pc-model>` elements. The ModelElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-model/ | `<pc-model>`} elements.
+ * The ModelElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  */
 class ModelElement extends AsyncElement {
     constructor() {
@@ -3685,8 +3817,8 @@ class ModelElement extends AsyncElement {
     async _loadModel() {
         var _a;
         this._unloadModel();
-        const appElement = await ((_a = this.closestApp) === null || _a === void 0 ? void 0 : _a.ready());
-        const app = appElement === null || appElement === void 0 ? void 0 : appElement.app;
+        const appElement = await ((_a = this.closestApp) === null || _a === undefined ? undefined : _a.ready());
+        const app = appElement === null || appElement === undefined ? undefined : appElement.app;
         const asset = AssetElement.get(this._asset);
         if (!asset) {
             return;
@@ -3703,11 +3835,11 @@ class ModelElement extends AsyncElement {
     }
     _unloadModel() {
         var _a;
-        (_a = this._entity) === null || _a === void 0 ? void 0 : _a.destroy();
+        (_a = this._entity) === null || _a === undefined ? undefined : _a.destroy();
         this._entity = null;
     }
     /**
-     * Sets the asset ID of the model.
+     * Sets the id of the `pc-asset` to use for the model.
      * @param value - The asset ID.
      */
     set asset(value) {
@@ -3717,8 +3849,8 @@ class ModelElement extends AsyncElement {
         }
     }
     /**
-     * Gets the source URL of the model.
-     * @returns The source URL of the model.
+     * Gets the id of the `pc-asset` to use for the model.
+     * @returns The asset ID.
      */
     get asset() {
         return this._asset;
@@ -3738,8 +3870,9 @@ customElements.define('pc-model', ModelElement);
 
 /**
  * The SceneElement interface provides properties and methods for manipulating
- * `<pc-scene>` elements. The SceneElement interface also inherits the properties and
- * methods of the {@link HTMLElement} interface.
+ * {@link https://developer.playcanvas.com/user-manual/engine/web-components/tags/pc-scene/ | `<pc-scene>`} elements.
+ * The SceneElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
  */
 class SceneElement extends AsyncElement {
     constructor() {
@@ -3771,7 +3904,7 @@ class SceneElement extends AsyncElement {
     }
     async connectedCallback() {
         var _a;
-        await ((_a = this.closestApp) === null || _a === void 0 ? void 0 : _a.ready());
+        await ((_a = this.closestApp) === null || _a === undefined ? undefined : _a.ready());
         this.scene = this.closestApp.app.scene;
         this.updateSceneSettings();
         this._onReady();
@@ -3945,8 +4078,8 @@ class SkyElement extends AsyncElement {
     }
     async _loadSkybox() {
         var _a;
-        const appElement = await ((_a = this.closestApp) === null || _a === void 0 ? void 0 : _a.ready());
-        const app = appElement === null || appElement === void 0 ? void 0 : appElement.app;
+        const appElement = await ((_a = this.closestApp) === null || _a === undefined ? undefined : _a.ready());
+        const app = appElement === null || appElement === undefined ? undefined : appElement.app;
         if (!app) {
             return;
         }
@@ -3969,74 +4102,134 @@ class SkyElement extends AsyncElement {
         var _a, _b;
         if (!this._scene)
             return;
-        (_a = this._scene.skybox) === null || _a === void 0 ? void 0 : _a.destroy();
+        (_a = this._scene.skybox) === null || _a === undefined ? undefined : _a.destroy();
         // @ts-ignore
         this._scene.skybox = null;
-        (_b = this._scene.envAtlas) === null || _b === void 0 ? void 0 : _b.destroy();
+        (_b = this._scene.envAtlas) === null || _b === undefined ? undefined : _b.destroy();
         // @ts-ignore
         this._scene.envAtlas = null;
         this._scene = null;
     }
+    /**
+     * Sets the id of the `pc-asset` to use for the skybox.
+     * @param value - The asset ID.
+     */
     set asset(value) {
         this._asset = value;
         if (this.isConnected) {
             this._loadSkybox();
         }
     }
+    /**
+     * Gets the id of the `pc-asset` to use for the skybox.
+     * @returns The asset ID.
+     */
     get asset() {
         return this._asset;
     }
+    /**
+     * Sets the center of the skybox.
+     * @param value - The center.
+     */
     set center(value) {
         this._center = value;
         if (this._scene) {
             this._scene.sky.center = this._center;
         }
     }
+    /**
+     * Gets the center of the skybox.
+     * @returns The center.
+     */
     get center() {
         return this._center;
     }
+    /**
+     * Sets the intensity of the skybox.
+     * @param value - The intensity.
+     */
     set intensity(value) {
         this._intensity = value;
         if (this._scene) {
             this._scene.skyboxIntensity = this._intensity;
         }
     }
+    /**
+     * Gets the intensity of the skybox.
+     * @returns The intensity.
+     */
     get intensity() {
         return this._intensity;
     }
+    /**
+     * Sets the mip level of the skybox.
+     * @param value - The mip level.
+     */
     set level(value) {
         this._level = value;
         if (this._scene) {
             this._scene.skyboxMip = this._level;
         }
     }
+    /**
+     * Gets the mip level of the skybox.
+     * @returns The mip level.
+     */
     get level() {
         return this._level;
     }
+    /**
+     * Sets whether the skybox is used as a light source.
+     * @param value - Whether to use lighting.
+     */
     set lighting(value) {
         this._lighting = value;
     }
+    /**
+     * Gets whether the skybox is used as a light source.
+     * @returns Whether to use lighting.
+     */
     get lighting() {
         return this._lighting;
     }
+    /**
+     * Sets the Euler rotation of the skybox.
+     * @param value - The rotation.
+     */
     set rotation(value) {
         this._rotation = value;
         if (this._scene) {
             this._scene.skyboxRotation = new Quat().setFromEulerAngles(value);
         }
     }
+    /**
+     * Gets the Euler rotation of the skybox.
+     * @returns The rotation.
+     */
     get rotation() {
         return this._rotation;
     }
+    /**
+     * Sets the scale of the skybox.
+     * @param value - The scale.
+     */
     set scale(value) {
         this._scale = value;
         if (this._scene) {
             this._scene.sky.node.setLocalScale(this._scale);
         }
     }
+    /**
+     * Gets the scale of the skybox.
+     * @returns The scale.
+     */
     get scale() {
         return this._scale;
     }
+    /**
+     * Sets the type of the skybox.
+     * @param value - The type.
+     */
     set type(value) {
         this._type = value;
         if (this._scene) {
@@ -4047,6 +4240,10 @@ class SkyElement extends AsyncElement {
             }
         }
     }
+    /**
+     * Gets the type of the skybox.
+     * @returns The type.
+     */
     get type() {
         return this._type;
     }
@@ -4084,5 +4281,5 @@ class SkyElement extends AsyncElement {
 }
 customElements.define('pc-sky', SkyElement);
 
-export { AppElement, AssetElement, AsyncElement, CameraComponentElement, CollisionComponentElement, ComponentElement, ElementComponentElement, EntityElement, GSplatComponentElement, LightComponentElement, ListenerComponentElement, MaterialElement, ModelElement, ModuleElement, RenderComponentElement, RigidBodyComponentElement, SceneElement, ScreenComponentElement, ScriptComponentElement, ScriptElement, SkyElement, SoundComponentElement, SoundSlotElement };
+export { AppElement, AssetElement, AsyncElement, CameraComponentElement, CollisionComponentElement, ComponentElement, ElementComponentElement, EntityElement, LightComponentElement, ListenerComponentElement, MaterialElement, ModelElement, ModuleElement, RenderComponentElement, RigidBodyComponentElement, SceneElement, ScreenComponentElement, ScriptComponentElement, ScriptElement, SkyElement, SoundComponentElement, SoundSlotElement, SplatComponentElement };
 //# sourceMappingURL=pwc.mjs.map