@playcanvas/web-components 0.16.0 → 0.18.0

package/dist/components/camera-component.d.cts

@@ -7,11 +7,18 @@ import { ComponentElement } from './component.cjs';
  * The CameraComponentElement interface also inherits the properties and methods of the
  * {@link HTMLElement} interface.
  *
+ * Engine component: {@link CameraComponent} (`camera`).
+ *
+ * @elementSummary The `<pc-camera>` element renders the scene from its entity's transform, with
+ * attributes for the projection, field of view, clip planes, clear color and tonemapping. Must be a
+ * child of a `<pc-entity>`, `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class CameraComponentElement extends ComponentElement {
     private _clearColor;
     private _clearColorBuffer;
+    private _clearDepth;
     private _clearDepthBuffer;
     private _clearStencilBuffer;
     private _cullFaces;
@@ -33,6 +40,7 @@ declare class CameraComponentElement extends ComponentElement {
     protected getInitialComponentData(): {
         clearColor: Color;
         clearColorBuffer: boolean;
+        clearDepth: number;
         clearDepthBuffer: boolean;
         clearStencilBuffer: boolean;
         cullFaces: boolean;
@@ -50,7 +58,25 @@ declare class CameraComponentElement extends ComponentElement {
         scissorRect: Vec4;
         toneMapping: number;
     };
-    get xrAvailable(): boolean | null;
+    /**
+     * Whether immersive AR is available. Independent of {@link vrAvailable}: a device can offer
+     * either mode without the other.
+     * @returns Whether immersive AR is available.
+     */
+    get arAvailable(): boolean;
+    /**
+     * Whether immersive VR is available. Independent of {@link arAvailable}: a device can offer
+     * either mode without the other.
+     * @returns Whether immersive VR is available.
+     */
+    get vrAvailable(): boolean;
+    /**
+     * Whether one XR session type is available on this device.
+     *
+     * @param type - The XR session type to test.
+     * @returns Whether that type is available.
+     */
+    private _available;
     /**
      * Starts the camera in XR mode.
      * @param type - The type of XR mode to start.
@@ -86,6 +112,16 @@ declare class CameraComponentElement extends ComponentElement {
      * @returns The clear color buffer.
      */
     get clearColorBuffer(): boolean;
+    /**
+     * Sets the depth value the depth buffer is cleared to. Defaults to 1.
+     * @param value - The clear depth value.
+     */
+    set clearDepth(value: number);
+    /**
+     * Gets the depth value the depth buffer is cleared to.
+     * @returns The clear depth value.
+     */
+    get clearDepth(): number;
     /**
      * Sets the clear depth buffer of the camera.
      * @param value - The clear depth buffer.

package/dist/components/camera-component.d.ts

@@ -7,11 +7,18 @@ import { ComponentElement } from './component.js';
  * The CameraComponentElement interface also inherits the properties and methods of the
  * {@link HTMLElement} interface.
  *
+ * Engine component: {@link CameraComponent} (`camera`).
+ *
+ * @elementSummary The `<pc-camera>` element renders the scene from its entity's transform, with
+ * attributes for the projection, field of view, clip planes, clear color and tonemapping. Must be a
+ * child of a `<pc-entity>`, `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class CameraComponentElement extends ComponentElement {
     private _clearColor;
     private _clearColorBuffer;
+    private _clearDepth;
     private _clearDepthBuffer;
     private _clearStencilBuffer;
     private _cullFaces;
@@ -33,6 +40,7 @@ declare class CameraComponentElement extends ComponentElement {
     protected getInitialComponentData(): {
         clearColor: Color;
         clearColorBuffer: boolean;
+        clearDepth: number;
         clearDepthBuffer: boolean;
         clearStencilBuffer: boolean;
         cullFaces: boolean;
@@ -50,7 +58,25 @@ declare class CameraComponentElement extends ComponentElement {
         scissorRect: Vec4;
         toneMapping: number;
     };
-    get xrAvailable(): boolean | null;
+    /**
+     * Whether immersive AR is available. Independent of {@link vrAvailable}: a device can offer
+     * either mode without the other.
+     * @returns Whether immersive AR is available.
+     */
+    get arAvailable(): boolean;
+    /**
+     * Whether immersive VR is available. Independent of {@link arAvailable}: a device can offer
+     * either mode without the other.
+     * @returns Whether immersive VR is available.
+     */
+    get vrAvailable(): boolean;
+    /**
+     * Whether one XR session type is available on this device.
+     *
+     * @param type - The XR session type to test.
+     * @returns Whether that type is available.
+     */
+    private _available;
     /**
      * Starts the camera in XR mode.
      * @param type - The type of XR mode to start.
@@ -86,6 +112,16 @@ declare class CameraComponentElement extends ComponentElement {
      * @returns The clear color buffer.
      */
     get clearColorBuffer(): boolean;
+    /**
+     * Sets the depth value the depth buffer is cleared to. Defaults to 1.
+     * @param value - The clear depth value.
+     */
+    set clearDepth(value: number);
+    /**
+     * Gets the depth value the depth buffer is cleared to.
+     * @returns The clear depth value.
+     */
+    get clearDepth(): number;
     /**
      * Sets the clear depth buffer of the camera.
      * @param value - The clear depth buffer.

package/dist/components/collision-component.d.cts

@@ -13,6 +13,12 @@ import { ComponentElement } from './component.cjs';
  * retargets or rebinds picks up the new node's geometry. An entity with no asset-backed render
  * component warns, and the collider has no shape.
  *
+ * Engine component: {@link CollisionComponent} (`collision`).
+ *
+ * @elementSummary The `<pc-collision>` element gives its entity a collision shape — a box, sphere,
+ * capsule, cone, cylinder or mesh — for the physics simulation to collide against. Pair it with a
+ * `<pc-rigid-body>`. Must be a child of a `<pc-entity>`, `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class CollisionComponentElement extends ComponentElement {
@@ -43,7 +49,9 @@ declare class CollisionComponentElement extends ComponentElement {
      * no attribute to supply it - so the host's visible geometry, the meaning a mesh collider
      * on a glTF node carries, fills the gap. Runs on every application (so a rebound `pc-node`
      * recomputes it) and on a runtime switch to `type="mesh"`; an explicitly assigned
-     * `renderAsset` is never overwritten.
+     * `renderAsset` is never overwritten. A `pc-model` host entity never carries a render
+     * component (the instantiated content beneath it does), so a mesh collider that should take
+     * an asset's geometry belongs on a bound `pc-node`.
      */
     private _applyMeshGeometryDefault;
     /**

package/dist/components/collision-component.d.ts

@@ -13,6 +13,12 @@ import { ComponentElement } from './component.js';
  * retargets or rebinds picks up the new node's geometry. An entity with no asset-backed render
  * component warns, and the collider has no shape.
  *
+ * Engine component: {@link CollisionComponent} (`collision`).
+ *
+ * @elementSummary The `<pc-collision>` element gives its entity a collision shape — a box, sphere,
+ * capsule, cone, cylinder or mesh — for the physics simulation to collide against. Pair it with a
+ * `<pc-rigid-body>`. Must be a child of a `<pc-entity>`, `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class CollisionComponentElement extends ComponentElement {
@@ -43,7 +49,9 @@ declare class CollisionComponentElement extends ComponentElement {
      * no attribute to supply it - so the host's visible geometry, the meaning a mesh collider
      * on a glTF node carries, fills the gap. Runs on every application (so a rebound `pc-node`
      * recomputes it) and on a runtime switch to `type="mesh"`; an explicitly assigned
-     * `renderAsset` is never overwritten.
+     * `renderAsset` is never overwritten. A `pc-model` host entity never carries a render
+     * component (the instantiated content beneath it does), so a mesh collider that should take
+     * an asset's geometry belongs on a bound `pc-node`.
      */
     private _applyMeshGeometryDefault;
     /**

package/dist/components/component.d.cts

@@ -61,8 +61,9 @@ declare class ComponentElement extends AsyncElement {
     disconnectedCallback(): void;
     /**
      * The PlayCanvas component instance. `null` until the element is ready, and also for an
-     * element that is not a descendant of a `<pc-entity>` — await {@link whenReady} or the
-     * element's `ready()` promise before accessing it.
+     * element that is not a descendant of an entity-fronting element (`<pc-entity>`,
+     * `<pc-model>` or `<pc-node>`) — await {@link whenReady} or the element's `ready()` promise
+     * before accessing it.
      * @returns The component instance, or `null`.
      */
     get component(): Component | null;

package/dist/components/component.d.ts

@@ -61,8 +61,9 @@ declare class ComponentElement extends AsyncElement {
     disconnectedCallback(): void;
     /**
      * The PlayCanvas component instance. `null` until the element is ready, and also for an
-     * element that is not a descendant of a `<pc-entity>` — await {@link whenReady} or the
-     * element's `ready()` promise before accessing it.
+     * element that is not a descendant of an entity-fronting element (`<pc-entity>`,
+     * `<pc-model>` or `<pc-node>`) — await {@link whenReady} or the element's `ready()` promise
+     * before accessing it.
      * @returns The component instance, or `null`.
      */
     get component(): Component | null;

package/dist/components/element-component.d.cts

@@ -7,6 +7,17 @@ import { ComponentElement } from './component.cjs';
  * The ElementComponentElement interface also inherits the properties and methods of the
  * {@link HTMLElement} interface.
  *
+ * Despite the name, this is not a base class or a generic wrapper: it is the engine's 2D UI
+ * component, which gives its host entity a rectangle in a `<pc-screen>` hierarchy that draws
+ * either an image, a line of text or nothing (`type="image"`, `"text"` or `"group"`). The tag
+ * spells the engine component it adds, as every component element does.
+ *
+ * Engine component: {@link ElementComponent} (`element`).
+ *
+ * @elementSummary The `<pc-element>` element gives its entity a 2D UI rectangle inside a
+ * `<pc-screen>` hierarchy, drawing an image, a line of text or nothing (`type="image"`, `"text"` or
+ * `"group"`). Must be a child of a `<pc-entity>`, `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class ElementComponentElement extends ComponentElement {

package/dist/components/element-component.d.ts

@@ -7,6 +7,17 @@ import { ComponentElement } from './component.js';
  * The ElementComponentElement interface also inherits the properties and methods of the
  * {@link HTMLElement} interface.
  *
+ * Despite the name, this is not a base class or a generic wrapper: it is the engine's 2D UI
+ * component, which gives its host entity a rectangle in a `<pc-screen>` hierarchy that draws
+ * either an image, a line of text or nothing (`type="image"`, `"text"` or `"group"`). The tag
+ * spells the engine component it adds, as every component element does.
+ *
+ * Engine component: {@link ElementComponent} (`element`).
+ *
+ * @elementSummary The `<pc-element>` element gives its entity a 2D UI rectangle inside a
+ * `<pc-screen>` hierarchy, drawing an image, a line of text or nothing (`type="image"`, `"text"` or
+ * `"group"`). Must be a child of a `<pc-entity>`, `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class ElementComponentElement extends ComponentElement {

package/dist/components/gsplat-component.d.cts

@@ -6,6 +6,12 @@ import { ComponentElement } from './component.cjs';
  * The GSplatComponentElement interface also inherits the properties and methods of the
  * {@link HTMLElement} interface.
  *
+ * Engine component: {@link GSplatComponent} (`gsplat`).
+ *
+ * @elementSummary The `<pc-gsplat>` element renders the 3D Gaussian splats of a `gsplat` asset at
+ * its entity, with attributes for shadow casting and level of detail. Must be a child of a
+ * `<pc-entity>`, `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class GSplatComponentElement extends ComponentElement {

package/dist/components/gsplat-component.d.ts

@@ -6,6 +6,12 @@ import { ComponentElement } from './component.js';
  * The GSplatComponentElement interface also inherits the properties and methods of the
  * {@link HTMLElement} interface.
  *
+ * Engine component: {@link GSplatComponent} (`gsplat`).
+ *
+ * @elementSummary The `<pc-gsplat>` element renders the 3D Gaussian splats of a `gsplat` asset at
+ * its entity, with attributes for shadow casting and level of detail. Must be a child of a
+ * `<pc-entity>`, `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class GSplatComponentElement extends ComponentElement {

package/dist/components/joint-component.d.cts

@@ -1,8 +1,13 @@
 import type { JointComponent } from 'playcanvas';
 import { Vec2, Vec3 } from 'playcanvas';
 import { ComponentElement } from './component.cjs';
-type JointType = 'fixed' | 'ball' | 'hinge' | 'slider' | '6dof';
-type MotionMode = 'locked' | 'limited' | 'free';
+/** The constraint types supported by the `<pc-joint>` element. */
+export type JointType = 'fixed' | 'ball' | 'hinge' | 'slider' | '6dof';
+/**
+ * The motion modes for a single joint axis: fully constrained (`locked`), constrained within
+ * limits (`limited`) or unconstrained (`free`).
+ */
+export type MotionMode = 'locked' | 'limited' | 'free';
 /**
  * The JointComponentElement interface provides properties and methods for manipulating
  * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-joint/ | `<pc-joint>`} elements.
@@ -16,10 +21,17 @@ type MotionMode = 'locked' | 'limited' | 'free';
  * a rigid body component; leaving `entity-b` empty constrains `entity-a` to a fixed point in world
  * space. The underlying engine component is in alpha, so its API may change.
  *
+ * @elementSummary The `<pc-joint>` element constrains two rigid bodies to each other — a hinged
+ * door, a swinging chain, a sliding drawer. Its entity's transform is the joint frame, and
+ * `entity-a` and `entity-b` name the bodies. Must be a child of a `<pc-entity>`, `<pc-model>` or
+ * `<pc-node>`.
+ *
  * @fires {CustomEvent} break - Fired when the impulse on the joint exceeds `break-impulse` and the
  * constraint breaks. A broken joint no longer constrains its bodies; calling `refreshFrames()` on
  * the underlying component re-attaches it. Bubbles and is composed.
  *
+ * Engine component: {@link JointComponent} (`joint`).
+ *
  * @category Components
  */
 declare class JointComponentElement extends ComponentElement {

package/dist/components/joint-component.d.ts

@@ -1,8 +1,13 @@
 import type { JointComponent } from 'playcanvas';
 import { Vec2, Vec3 } from 'playcanvas';
 import { ComponentElement } from './component.js';
-type JointType = 'fixed' | 'ball' | 'hinge' | 'slider' | '6dof';
-type MotionMode = 'locked' | 'limited' | 'free';
+/** The constraint types supported by the `<pc-joint>` element. */
+export type JointType = 'fixed' | 'ball' | 'hinge' | 'slider' | '6dof';
+/**
+ * The motion modes for a single joint axis: fully constrained (`locked`), constrained within
+ * limits (`limited`) or unconstrained (`free`).
+ */
+export type MotionMode = 'locked' | 'limited' | 'free';
 /**
  * The JointComponentElement interface provides properties and methods for manipulating
  * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-joint/ | `<pc-joint>`} elements.
@@ -16,10 +21,17 @@ type MotionMode = 'locked' | 'limited' | 'free';
  * a rigid body component; leaving `entity-b` empty constrains `entity-a` to a fixed point in world
  * space. The underlying engine component is in alpha, so its API may change.
  *
+ * @elementSummary The `<pc-joint>` element constrains two rigid bodies to each other — a hinged
+ * door, a swinging chain, a sliding drawer. Its entity's transform is the joint frame, and
+ * `entity-a` and `entity-b` name the bodies. Must be a child of a `<pc-entity>`, `<pc-model>` or
+ * `<pc-node>`.
+ *
  * @fires {CustomEvent} break - Fired when the impulse on the joint exceeds `break-impulse` and the
  * constraint breaks. A broken joint no longer constrains its bodies; calling `refreshFrames()` on
  * the underlying component re-attaches it. Bubbles and is composed.
  *
+ * Engine component: {@link JointComponent} (`joint`).
+ *
  * @category Components
  */
 declare class JointComponentElement extends ComponentElement {

package/dist/components/{layoutchild-component.d.cts → layout-child-component.d.cts}

@@ -2,10 +2,16 @@ import type { LayoutChildComponent } from 'playcanvas';
 import { ComponentElement } from './component.cjs';
 /**
  * The LayoutChildComponentElement interface provides properties and methods for manipulating
- * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-layoutchild/ | `<pc-layoutchild>`} elements.
+ * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-layout-child/ | `<pc-layout-child>`} elements.
  * The LayoutChildComponentElement interface also inherits the properties and methods of the
  * {@link HTMLElement} interface.
  *
+ * Engine component: {@link LayoutChildComponent} (`layoutchild`).
+ *
+ * @elementSummary The `<pc-layout-child>` element controls how its entity is sized by the
+ * `<pc-layout-group>` above it, through minimum and maximum sizes and fit proportions. Must be a
+ * child of a `<pc-entity>`, `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class LayoutChildComponentElement extends ComponentElement {

package/dist/components/{layoutchild-component.d.ts → layout-child-component.d.ts}

@@ -2,10 +2,16 @@ import type { LayoutChildComponent } from 'playcanvas';
 import { ComponentElement } from './component.js';
 /**
  * The LayoutChildComponentElement interface provides properties and methods for manipulating
- * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-layoutchild/ | `<pc-layoutchild>`} elements.
+ * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-layout-child/ | `<pc-layout-child>`} elements.
  * The LayoutChildComponentElement interface also inherits the properties and methods of the
  * {@link HTMLElement} interface.
  *
+ * Engine component: {@link LayoutChildComponent} (`layoutchild`).
+ *
+ * @elementSummary The `<pc-layout-child>` element controls how its entity is sized by the
+ * `<pc-layout-group>` above it, through minimum and maximum sizes and fit proportions. Must be a
+ * child of a `<pc-entity>`, `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class LayoutChildComponentElement extends ComponentElement {

package/dist/components/{layoutgroup-component.d.cts → layout-group-component.d.cts}

@@ -3,10 +3,16 @@ import { Vec2, Vec4 } from 'playcanvas';
 import { ComponentElement } from './component.cjs';
 /**
  * The LayoutGroupComponentElement interface provides properties and methods for manipulating
- * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-layoutgroup/ | `<pc-layoutgroup>`} elements.
+ * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-layout-group/ | `<pc-layout-group>`} elements.
  * The LayoutGroupComponentElement interface also inherits the properties and methods of the
  * {@link HTMLElement} interface.
  *
+ * Engine component: {@link LayoutGroupComponent} (`layoutgroup`).
+ *
+ * @elementSummary The `<pc-layout-group>` element arranges its entity's children in a row or
+ * column, with spacing, padding, alignment and fitting. Must be a child of a `<pc-entity>`,
+ * `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class LayoutGroupComponentElement extends ComponentElement {

package/dist/components/{layoutgroup-component.d.ts → layout-group-component.d.ts}

@@ -3,10 +3,16 @@ import { Vec2, Vec4 } from 'playcanvas';
 import { ComponentElement } from './component.js';
 /**
  * The LayoutGroupComponentElement interface provides properties and methods for manipulating
- * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-layoutgroup/ | `<pc-layoutgroup>`} elements.
+ * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-layout-group/ | `<pc-layout-group>`} elements.
  * The LayoutGroupComponentElement interface also inherits the properties and methods of the
  * {@link HTMLElement} interface.
  *
+ * Engine component: {@link LayoutGroupComponent} (`layoutgroup`).
+ *
+ * @elementSummary The `<pc-layout-group>` element arranges its entity's children in a row or
+ * column, with spacing, padding, alignment and fitting. Must be a child of a `<pc-entity>`,
+ * `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class LayoutGroupComponentElement extends ComponentElement {

package/dist/components/light-component.d.cts

@@ -7,14 +7,23 @@ import { ComponentElement } from './component.cjs';
  * The LightComponentElement interface also inherits the properties and methods of the
  * {@link HTMLElement} interface.
  *
+ * Engine component: {@link LightComponent} (`light`).
+ *
+ * @elementSummary The `<pc-light>` element lights the scene from its entity — as a directional,
+ * omni or spot light — with attributes for color, intensity, range and shadows. Must be a child of
+ * a `<pc-entity>`, `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class LightComponentElement extends ComponentElement {
+    private _cascadeBlend;
+    private _cascadeDistribution;
     private _castShadows;
     private _color;
     private _innerConeAngle;
     private _intensity;
     private _normalOffsetBias;
+    private _numCascades;
     private _outerConeAngle;
     private _range;
     private _shadowBias;
@@ -32,11 +41,14 @@ declare class LightComponentElement extends ComponentElement {
     /** @ignore */
     constructor();
     protected getInitialComponentData(): {
+        cascadeBlend: number;
+        cascadeDistribution: number;
         castShadows: boolean;
         color: Color;
         innerConeAngle: number;
         intensity: number;
         normalOffsetBias: number;
+        numCascades: number;
         outerConeAngle: number;
         penumbraFalloff: number;
         penumbraSize: number;
@@ -47,7 +59,7 @@ declare class LightComponentElement extends ComponentElement {
         shadowIntensity: number;
         shadowResolution: number;
         shadowSamples: number;
-        shadowType: number | undefined;
+        shadowType: number;
         type: "directional" | "omni" | "spot";
         vsmBias: number;
         vsmBlurSize: number;
@@ -57,6 +69,33 @@ declare class LightComponentElement extends ComponentElement {
      * @returns The light component.
      */
     get component(): LightComponent;
+    /**
+     * Sets the fraction of each shadow cascade that is blended into the next one, from 0 (no
+     * blending) to 1, which applies only to `directional` lights with `num-cascades` greater than
+     * 1. Defaults to 0.
+     * @param value - The cascade blend factor.
+     */
+    set cascadeBlend(value: number);
+    /**
+     * Gets the cascade blend factor of the light, from 0 (no blending) to 1, which applies only to
+     * `directional` lights with `num-cascades` greater than 1.
+     * @returns The cascade blend factor.
+     */
+    get cascadeBlend(): number;
+    /**
+     * Sets the distribution of the camera frustum split between shadow cascades, from 0 (linear
+     * split) to 1 (logarithmic split, concentrating shadow resolution near the camera), which
+     * applies only to `directional` lights with `num-cascades` greater than 1. Defaults to 0.5.
+     * @param value - The cascade distribution.
+     */
+    set cascadeDistribution(value: number);
+    /**
+     * Gets the cascade distribution of the light, from 0 (linear split) to 1 (logarithmic split,
+     * concentrating shadow resolution near the camera), which applies only to `directional` lights
+     * with `num-cascades` greater than 1.
+     * @returns The cascade distribution.
+     */
+    get cascadeDistribution(): number;
     /**
      * Sets the cast shadows flag of the light.
      * @param value - The cast shadows flag.
@@ -107,6 +146,18 @@ declare class LightComponentElement extends ComponentElement {
      * @returns The normal offset bias.
      */
     get normalOffsetBias(): number;
+    /**
+     * Sets the number of shadow cascades of the light, an integer from 1 (no cascades) to 4, which
+     * applies only to `directional` lights. Defaults to 1.
+     * @param value - The number of shadow cascades.
+     */
+    set numCascades(value: number);
+    /**
+     * Gets the number of shadow cascades of the light, an integer from 1 (no cascades) to 4, which
+     * applies only to `directional` lights.
+     * @returns The number of shadow cascades.
+     */
+    get numCascades(): number;
     /**
      * Sets the outer cone angle of the light.
      * @param value - The outer cone angle.

package/dist/components/light-component.d.ts

@@ -7,14 +7,23 @@ import { ComponentElement } from './component.js';
  * The LightComponentElement interface also inherits the properties and methods of the
  * {@link HTMLElement} interface.
  *
+ * Engine component: {@link LightComponent} (`light`).
+ *
+ * @elementSummary The `<pc-light>` element lights the scene from its entity — as a directional,
+ * omni or spot light — with attributes for color, intensity, range and shadows. Must be a child of
+ * a `<pc-entity>`, `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class LightComponentElement extends ComponentElement {
+    private _cascadeBlend;
+    private _cascadeDistribution;
     private _castShadows;
     private _color;
     private _innerConeAngle;
     private _intensity;
     private _normalOffsetBias;
+    private _numCascades;
     private _outerConeAngle;
     private _range;
     private _shadowBias;
@@ -32,11 +41,14 @@ declare class LightComponentElement extends ComponentElement {
     /** @ignore */
     constructor();
     protected getInitialComponentData(): {
+        cascadeBlend: number;
+        cascadeDistribution: number;
         castShadows: boolean;
         color: Color;
         innerConeAngle: number;
         intensity: number;
         normalOffsetBias: number;
+        numCascades: number;
         outerConeAngle: number;
         penumbraFalloff: number;
         penumbraSize: number;
@@ -47,7 +59,7 @@ declare class LightComponentElement extends ComponentElement {
         shadowIntensity: number;
         shadowResolution: number;
         shadowSamples: number;
-        shadowType: number | undefined;
+        shadowType: number;
         type: "directional" | "omni" | "spot";
         vsmBias: number;
         vsmBlurSize: number;
@@ -57,6 +69,33 @@ declare class LightComponentElement extends ComponentElement {
      * @returns The light component.
      */
     get component(): LightComponent;
+    /**
+     * Sets the fraction of each shadow cascade that is blended into the next one, from 0 (no
+     * blending) to 1, which applies only to `directional` lights with `num-cascades` greater than
+     * 1. Defaults to 0.
+     * @param value - The cascade blend factor.
+     */
+    set cascadeBlend(value: number);
+    /**
+     * Gets the cascade blend factor of the light, from 0 (no blending) to 1, which applies only to
+     * `directional` lights with `num-cascades` greater than 1.
+     * @returns The cascade blend factor.
+     */
+    get cascadeBlend(): number;
+    /**
+     * Sets the distribution of the camera frustum split between shadow cascades, from 0 (linear
+     * split) to 1 (logarithmic split, concentrating shadow resolution near the camera), which
+     * applies only to `directional` lights with `num-cascades` greater than 1. Defaults to 0.5.
+     * @param value - The cascade distribution.
+     */
+    set cascadeDistribution(value: number);
+    /**
+     * Gets the cascade distribution of the light, from 0 (linear split) to 1 (logarithmic split,
+     * concentrating shadow resolution near the camera), which applies only to `directional` lights
+     * with `num-cascades` greater than 1.
+     * @returns The cascade distribution.
+     */
+    get cascadeDistribution(): number;
     /**
      * Sets the cast shadows flag of the light.
      * @param value - The cast shadows flag.
@@ -107,6 +146,18 @@ declare class LightComponentElement extends ComponentElement {
      * @returns The normal offset bias.
      */
     get normalOffsetBias(): number;
+    /**
+     * Sets the number of shadow cascades of the light, an integer from 1 (no cascades) to 4, which
+     * applies only to `directional` lights. Defaults to 1.
+     * @param value - The number of shadow cascades.
+     */
+    set numCascades(value: number);
+    /**
+     * Gets the number of shadow cascades of the light, an integer from 1 (no cascades) to 4, which
+     * applies only to `directional` lights.
+     * @returns The number of shadow cascades.
+     */
+    get numCascades(): number;
     /**
      * Sets the outer cone angle of the light.
      * @param value - The outer cone angle.

package/dist/components/{particlesystem-component.d.cts → particle-system-component.d.cts}

@@ -2,10 +2,16 @@ import type { ParticleSystemComponent } from 'playcanvas';
 import { ComponentElement } from './component.cjs';
 /**
  * The ParticleSystemComponentElement interface provides properties and methods for manipulating
- * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-particles/ | `<pc-particles>`} elements.
+ * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-particle-system/ | `<pc-particle-system>`} elements.
  * The ParticleSystemComponentElement interface also inherits the properties and methods of the
  * {@link HTMLElement} interface.
  *
+ * Engine component: {@link ParticleSystemComponent} (`particlesystem`).
+ *
+ * @elementSummary The `<pc-particle-system>` element emits particles from its entity, with
+ * attributes for the emitter's shape, rate, lifetime, textures and blending. Must be a child of a
+ * `<pc-entity>`, `<pc-model>` or `<pc-node>`.
+ *
  * @category Components
  */
 declare class ParticleSystemComponentElement extends ComponentElement {