@playcanvas/web-components 0.19.0 → 0.21.0

package/dist/components/component.d.cts

@@ -5,7 +5,7 @@ import { AsyncElement } from '../async-element.cjs';
  *
  * @category Components
  */
-declare class ComponentElement extends AsyncElement {
+declare class ComponentElement<T extends Component = Component> extends AsyncElement {
     private _componentName;
     private _enabled;
     private _component;
@@ -66,7 +66,7 @@ declare class ComponentElement extends AsyncElement {
      * before accessing it.
      * @returns The component instance, or `null`.
      */
-    get component(): Component | null;
+    get component(): T | null;
     /**
      * Sets the enabled state of the component.
      * @param value - The enabled state of the component.

package/dist/components/component.d.ts

@@ -5,7 +5,7 @@ import { AsyncElement } from '../async-element.js';
  *
  * @category Components
  */
-declare class ComponentElement extends AsyncElement {
+declare class ComponentElement<T extends Component = Component> extends AsyncElement {
     private _componentName;
     private _enabled;
     private _component;
@@ -66,7 +66,7 @@ declare class ComponentElement extends AsyncElement {
      * before accessing it.
      * @returns The component instance, or `null`.
      */
-    get component(): Component | null;
+    get component(): T | null;
     /**
      * Sets the enabled state of the component.
      * @param value - The enabled state of the component.

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

@@ -20,7 +20,7 @@ import { ComponentElement } from './component.cjs';
  *
  * @category Components
  */
-declare class ElementComponentElement extends ComponentElement {
+declare class ElementComponentElement extends ComponentElement<ElementComponent> {
     private _anchor;
     private _autoWidth;
     private _autoHeight;
@@ -52,10 +52,11 @@ declare class ElementComponentElement extends ComponentElement {
     protected initComponent(): void;
     protected getInitialComponentData(): Record<string, any>;
     /**
-     * Gets the underlying PlayCanvas element component.
-     * @returns The element component.
+     * Gets the underlying PlayCanvas element component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The element component, or `null`.
      */
-    get component(): ElementComponent;
+    get component(): ElementComponent | null;
     /**
      * Sets the anchor of the element component.
      * @param value - The anchor.

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

@@ -20,7 +20,7 @@ import { ComponentElement } from './component.js';
  *
  * @category Components
  */
-declare class ElementComponentElement extends ComponentElement {
+declare class ElementComponentElement extends ComponentElement<ElementComponent> {
     private _anchor;
     private _autoWidth;
     private _autoHeight;
@@ -52,10 +52,11 @@ declare class ElementComponentElement extends ComponentElement {
     protected initComponent(): void;
     protected getInitialComponentData(): Record<string, any>;
     /**
-     * Gets the underlying PlayCanvas element component.
-     * @returns The element component.
+     * Gets the underlying PlayCanvas element component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The element component, or `null`.
      */
-    get component(): ElementComponent;
+    get component(): ElementComponent | null;
     /**
      * Sets the anchor of the element component.
      * @param value - The anchor.

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

@@ -14,7 +14,7 @@ import { ComponentElement } from './component.cjs';
  *
  * @category Components
  */
-declare class GSplatComponentElement extends ComponentElement {
+declare class GSplatComponentElement extends ComponentElement<GSplatComponent> {
     private _asset;
     private _castShadows;
     private _lodBaseDistance;
@@ -32,10 +32,11 @@ declare class GSplatComponentElement extends ComponentElement {
         lodRangeMax: number;
     };
     /**
-     * Gets the underlying PlayCanvas gsplat component.
-     * @returns The gsplat component.
+     * Gets the underlying PlayCanvas gsplat component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The gsplat component, or `null`.
      */
-    get component(): GSplatComponent;
+    get component(): GSplatComponent | null;
     /**
      * Sets id of the `pc-asset` to use for the splat.
      * @param value - The asset ID.

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

@@ -14,7 +14,7 @@ import { ComponentElement } from './component.js';
  *
  * @category Components
  */
-declare class GSplatComponentElement extends ComponentElement {
+declare class GSplatComponentElement extends ComponentElement<GSplatComponent> {
     private _asset;
     private _castShadows;
     private _lodBaseDistance;
@@ -32,10 +32,11 @@ declare class GSplatComponentElement extends ComponentElement {
         lodRangeMax: number;
     };
     /**
-     * Gets the underlying PlayCanvas gsplat component.
-     * @returns The gsplat component.
+     * Gets the underlying PlayCanvas gsplat component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The gsplat component, or `null`.
      */
-    get component(): GSplatComponent;
+    get component(): GSplatComponent | null;
     /**
      * Sets id of the `pc-asset` to use for the splat.
      * @param value - The asset ID.

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

@@ -19,7 +19,12 @@ export type MotionMode = 'locked' | 'limited' | 'free';
  * primary axis: a hinge rotates about it, a slider translates along it and a ball joint twists
  * about it. The constrained bodies are referenced by `entity-a` and `entity-b`, both of which need
  * 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.
+ * space. A reference can name any entity-fronting element — `<pc-entity>`, `<pc-model>` or
+ * `<pc-node>`, so a ragdoll can join a model's own skeleton nodes by name — and a name resolves
+ * against the nearest enclosing entity first, then outward through the entity hierarchy, then the
+ * document, while a `#` selector resolves document-wide. A `<template>` prefab with one
+ * entity-fronting root can therefore wire its joints by name and stay self-contained when cloned.
+ * 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
@@ -34,7 +39,7 @@ export type MotionMode = 'locked' | 'limited' | 'free';
  *
  * @category Components
  */
-declare class JointComponentElement extends ComponentElement {
+declare class JointComponentElement extends ComponentElement<JointComponent> {
     /**
      * The spring damping of the joint per angular axis.
      */
@@ -192,10 +197,11 @@ declare class JointComponentElement extends ComponentElement {
     private _onBreak;
     protected initComponent(): void;
     /**
-     * Gets the underlying PlayCanvas joint component.
-     * @returns The joint component.
+     * Gets the underlying PlayCanvas joint component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The joint component, or `null`.
      */
-    get component(): JointComponent;
+    get component(): JointComponent | null;
     /**
      * Sets the spring damping of a 6dof joint per angular axis, used on axes with a non-zero
      * angular-stiffness.
@@ -327,27 +333,36 @@ declare class JointComponentElement extends ComponentElement {
      */
     get enableLimits(): boolean;
     /**
-     * Sets the reference (CSS selector, element id or entity name) to the `<pc-entity>` providing
-     * the first constrained body. The reference resolves when it is set, so an entity created
-     * later is picked up by setting the attribute again.
+     * Sets the reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#`
+     * selector) to the element providing the first constrained body. An exact name resolves
+     * against the nearest enclosing entity first, then outward, then the document. The reference
+     * resolves when it is set, so an entity created later is picked up by setting the attribute
+     * again. A non-empty reference that does not resolve warns, naming which of the two causes it
+     * hit.
      * @param value - The first body's entity reference.
      */
     set entityA(value: string);
     /**
-     * Gets the reference to the `<pc-entity>` providing the first constrained body.
+     * Gets the reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#`
+     * selector) to the element providing the first constrained body.
      * @returns The first body's entity reference.
      */
     get entityA(): string;
     /**
-     * Sets the reference (CSS selector, element id or entity name) to the `<pc-entity>` providing
-     * the second constrained body, or empty to constrain the first body to a fixed point in world
-     * space. The reference resolves when it is set, so an entity created later is picked up by
-     * setting the attribute again.
+     * Sets 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 to constrain the
+     * first body to a fixed point in world space. An exact name resolves against the nearest
+     * enclosing entity first, then outward, then the document. The reference resolves when it is
+     * set, so an entity created later is picked up by setting the attribute again. A non-empty
+     * reference that does not resolve warns; an empty one is the documented world-space case and
+     * stays silent.
      * @param value - The second body's entity reference.
      */
     set entityB(value: string);
     /**
-     * Gets the reference to the `<pc-entity>` providing the second constrained body.
+     * Gets 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.
      * @returns The second body's entity reference.
      */
     get entityB(): string;

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

@@ -19,7 +19,12 @@ export type MotionMode = 'locked' | 'limited' | 'free';
  * primary axis: a hinge rotates about it, a slider translates along it and a ball joint twists
  * about it. The constrained bodies are referenced by `entity-a` and `entity-b`, both of which need
  * 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.
+ * space. A reference can name any entity-fronting element — `<pc-entity>`, `<pc-model>` or
+ * `<pc-node>`, so a ragdoll can join a model's own skeleton nodes by name — and a name resolves
+ * against the nearest enclosing entity first, then outward through the entity hierarchy, then the
+ * document, while a `#` selector resolves document-wide. A `<template>` prefab with one
+ * entity-fronting root can therefore wire its joints by name and stay self-contained when cloned.
+ * 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
@@ -34,7 +39,7 @@ export type MotionMode = 'locked' | 'limited' | 'free';
  *
  * @category Components
  */
-declare class JointComponentElement extends ComponentElement {
+declare class JointComponentElement extends ComponentElement<JointComponent> {
     /**
      * The spring damping of the joint per angular axis.
      */
@@ -192,10 +197,11 @@ declare class JointComponentElement extends ComponentElement {
     private _onBreak;
     protected initComponent(): void;
     /**
-     * Gets the underlying PlayCanvas joint component.
-     * @returns The joint component.
+     * Gets the underlying PlayCanvas joint component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The joint component, or `null`.
      */
-    get component(): JointComponent;
+    get component(): JointComponent | null;
     /**
      * Sets the spring damping of a 6dof joint per angular axis, used on axes with a non-zero
      * angular-stiffness.
@@ -327,27 +333,36 @@ declare class JointComponentElement extends ComponentElement {
      */
     get enableLimits(): boolean;
     /**
-     * Sets the reference (CSS selector, element id or entity name) to the `<pc-entity>` providing
-     * the first constrained body. The reference resolves when it is set, so an entity created
-     * later is picked up by setting the attribute again.
+     * Sets the reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#`
+     * selector) to the element providing the first constrained body. An exact name resolves
+     * against the nearest enclosing entity first, then outward, then the document. The reference
+     * resolves when it is set, so an entity created later is picked up by setting the attribute
+     * again. A non-empty reference that does not resolve warns, naming which of the two causes it
+     * hit.
      * @param value - The first body's entity reference.
      */
     set entityA(value: string);
     /**
-     * Gets the reference to the `<pc-entity>` providing the first constrained body.
+     * Gets the reference (a `pc-entity`, `pc-model` or `pc-node` name, or a document-wide `#`
+     * selector) to the element providing the first constrained body.
      * @returns The first body's entity reference.
      */
     get entityA(): string;
     /**
-     * Sets the reference (CSS selector, element id or entity name) to the `<pc-entity>` providing
-     * the second constrained body, or empty to constrain the first body to a fixed point in world
-     * space. The reference resolves when it is set, so an entity created later is picked up by
-     * setting the attribute again.
+     * Sets 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 to constrain the
+     * first body to a fixed point in world space. An exact name resolves against the nearest
+     * enclosing entity first, then outward, then the document. The reference resolves when it is
+     * set, so an entity created later is picked up by setting the attribute again. A non-empty
+     * reference that does not resolve warns; an empty one is the documented world-space case and
+     * stays silent.
      * @param value - The second body's entity reference.
      */
     set entityB(value: string);
     /**
-     * Gets the reference to the `<pc-entity>` providing the second constrained body.
+     * Gets 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.
      * @returns The second body's entity reference.
      */
     get entityB(): string;

package/dist/components/layout-child-component.d.cts

@@ -14,7 +14,7 @@ import { ComponentElement } from './component.cjs';
  *
  * @category Components
  */
-declare class LayoutChildComponentElement extends ComponentElement {
+declare class LayoutChildComponentElement extends ComponentElement<LayoutChildComponent> {
     private _minWidth;
     private _minHeight;
     private _maxWidth;
@@ -34,10 +34,11 @@ declare class LayoutChildComponentElement extends ComponentElement {
         excludeFromLayout: boolean;
     };
     /**
-     * Gets the underlying PlayCanvas layout child component.
-     * @returns The layout child component.
+     * Gets the underlying PlayCanvas layout child component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The layout child component, or `null`.
      */
-    get component(): LayoutChildComponent;
+    get component(): LayoutChildComponent | null;
     /**
      * Sets the minimum width the element should be laid out with.
      * @param value - The minimum width.

package/dist/components/layout-child-component.d.ts

@@ -14,7 +14,7 @@ import { ComponentElement } from './component.js';
  *
  * @category Components
  */
-declare class LayoutChildComponentElement extends ComponentElement {
+declare class LayoutChildComponentElement extends ComponentElement<LayoutChildComponent> {
     private _minWidth;
     private _minHeight;
     private _maxWidth;
@@ -34,10 +34,11 @@ declare class LayoutChildComponentElement extends ComponentElement {
         excludeFromLayout: boolean;
     };
     /**
-     * Gets the underlying PlayCanvas layout child component.
-     * @returns The layout child component.
+     * Gets the underlying PlayCanvas layout child component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The layout child component, or `null`.
      */
-    get component(): LayoutChildComponent;
+    get component(): LayoutChildComponent | null;
     /**
      * Sets the minimum width the element should be laid out with.
      * @param value - The minimum width.

package/dist/components/layout-group-component.d.cts

@@ -15,7 +15,7 @@ import { ComponentElement } from './component.cjs';
  *
  * @category Components
  */
-declare class LayoutGroupComponentElement extends ComponentElement {
+declare class LayoutGroupComponentElement extends ComponentElement<LayoutGroupComponent> {
     private _orientation;
     private _reverseX;
     private _reverseY;
@@ -39,10 +39,11 @@ declare class LayoutGroupComponentElement extends ComponentElement {
         wrap: boolean;
     };
     /**
-     * Gets the underlying PlayCanvas layout group component.
-     * @returns The layout group component.
+     * Gets the underlying PlayCanvas layout group component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The layout group component, or `null`.
      */
-    get component(): LayoutGroupComponent;
+    get component(): LayoutGroupComponent | null;
     /**
      * Sets the orientation of the layout group. Can be `horizontal` or `vertical`. Defaults to
      * `horizontal`.

package/dist/components/layout-group-component.d.ts

@@ -15,7 +15,7 @@ import { ComponentElement } from './component.js';
  *
  * @category Components
  */
-declare class LayoutGroupComponentElement extends ComponentElement {
+declare class LayoutGroupComponentElement extends ComponentElement<LayoutGroupComponent> {
     private _orientation;
     private _reverseX;
     private _reverseY;
@@ -39,10 +39,11 @@ declare class LayoutGroupComponentElement extends ComponentElement {
         wrap: boolean;
     };
     /**
-     * Gets the underlying PlayCanvas layout group component.
-     * @returns The layout group component.
+     * Gets the underlying PlayCanvas layout group component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The layout group component, or `null`.
      */
-    get component(): LayoutGroupComponent;
+    get component(): LayoutGroupComponent | null;
     /**
      * Sets the orientation of the layout group. Can be `horizontal` or `vertical`. Defaults to
      * `horizontal`.

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

@@ -15,7 +15,7 @@ import { ComponentElement } from './component.cjs';
  *
  * @category Components
  */
-declare class LightComponentElement extends ComponentElement {
+declare class LightComponentElement extends ComponentElement<LightComponent> {
     private _cascadeBlend;
     private _cascadeDistribution;
     private _castShadows;
@@ -65,10 +65,11 @@ declare class LightComponentElement extends ComponentElement {
         vsmBlurSize: number;
     };
     /**
-     * Gets the underlying PlayCanvas light component.
-     * @returns The light component.
+     * Gets the underlying PlayCanvas light component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The light component, or `null`.
      */
-    get component(): LightComponent;
+    get component(): LightComponent | null;
     /**
      * 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

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

@@ -15,7 +15,7 @@ import { ComponentElement } from './component.js';
  *
  * @category Components
  */
-declare class LightComponentElement extends ComponentElement {
+declare class LightComponentElement extends ComponentElement<LightComponent> {
     private _cascadeBlend;
     private _cascadeDistribution;
     private _castShadows;
@@ -65,10 +65,11 @@ declare class LightComponentElement extends ComponentElement {
         vsmBlurSize: number;
     };
     /**
-     * Gets the underlying PlayCanvas light component.
-     * @returns The light component.
+     * Gets the underlying PlayCanvas light component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The light component, or `null`.
      */
-    get component(): LightComponent;
+    get component(): LightComponent | null;
     /**
      * 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

package/dist/components/particle-system-component.d.cts

@@ -14,18 +14,35 @@ import { ComponentElement } from './component.cjs';
  *
  * @category Components
  */
-declare class ParticleSystemComponentElement extends ComponentElement {
+declare class ParticleSystemComponentElement extends ComponentElement<ParticleSystemComponent> {
     private _asset;
+    /**
+     * The subscription to the current config asset while its load is in flight. Rebinding
+     * supersedes it and disconnect cancels it, so a superseded config — an earlier asset that
+     * finishes loading after its replacement, or a callback left behind by a previous
+     * connection — can never configure the component.
+     */
+    private _binding;
     /** @ignore */
     constructor();
     protected getInitialComponentData(): object;
+    protected initComponent(): void;
+    disconnectedCallback(): void;
+    /**
+     * Gets the underlying PlayCanvas particle system component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The particle system component, or `null`.
+     */
+    get component(): ParticleSystemComponent | null;
     /**
-     * Gets the underlying PlayCanvas particle system component.
-     * @returns The particle system component.
+     * Rewrites the config's `colorMapAsset` from the `pc-asset` id it is authored with to the
+     * engine asset id the component resolves, starting the texture's load if it is lazy. The
+     * rewrite is in place, so a config applied again — a host cycle, a reconnection — is already
+     * resolved and passes through unchanged.
      */
-    get component(): ParticleSystemComponent;
+    private _resolveColorMap;
     private applyConfig;
-    private _loadAsset;
+    private _bindConfig;
     /**
      * Sets the id of the `pc-asset` to use for the model.
      * @param value - The asset ID.

package/dist/components/particle-system-component.d.ts

@@ -14,18 +14,35 @@ import { ComponentElement } from './component.js';
  *
  * @category Components
  */
-declare class ParticleSystemComponentElement extends ComponentElement {
+declare class ParticleSystemComponentElement extends ComponentElement<ParticleSystemComponent> {
     private _asset;
+    /**
+     * The subscription to the current config asset while its load is in flight. Rebinding
+     * supersedes it and disconnect cancels it, so a superseded config — an earlier asset that
+     * finishes loading after its replacement, or a callback left behind by a previous
+     * connection — can never configure the component.
+     */
+    private _binding;
     /** @ignore */
     constructor();
     protected getInitialComponentData(): object;
+    protected initComponent(): void;
+    disconnectedCallback(): void;
+    /**
+     * Gets the underlying PlayCanvas particle system component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The particle system component, or `null`.
+     */
+    get component(): ParticleSystemComponent | null;
     /**
-     * Gets the underlying PlayCanvas particle system component.
-     * @returns The particle system component.
+     * Rewrites the config's `colorMapAsset` from the `pc-asset` id it is authored with to the
+     * engine asset id the component resolves, starting the texture's load if it is lazy. The
+     * rewrite is in place, so a config applied again — a host cycle, a reconnection — is already
+     * resolved and passes through unchanged.
      */
-    get component(): ParticleSystemComponent;
+    private _resolveColorMap;
     private applyConfig;
-    private _loadAsset;
+    private _bindConfig;
     /**
      * Sets the id of the `pc-asset` to use for the model.
      * @param value - The asset ID.

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

@@ -19,7 +19,7 @@ import { ComponentElement } from './component.cjs';
  *
  * @category Components
  */
-declare class RenderComponentElement extends ComponentElement {
+declare class RenderComponentElement extends ComponentElement<RenderComponent> {
     private _castShadows;
     private _material;
     private _receiveShadows;
@@ -33,10 +33,11 @@ declare class RenderComponentElement extends ComponentElement {
         receiveShadows: boolean;
     };
     /**
-     * Gets the underlying PlayCanvas render component.
-     * @returns The render component.
+     * Gets the underlying PlayCanvas render component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The render component, or `null`.
      */
-    get component(): RenderComponent;
+    get component(): RenderComponent | null;
     /**
      * Sets the type of the render component.
      * @param value - The type.

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

@@ -19,7 +19,7 @@ import { ComponentElement } from './component.js';
  *
  * @category Components
  */
-declare class RenderComponentElement extends ComponentElement {
+declare class RenderComponentElement extends ComponentElement<RenderComponent> {
     private _castShadows;
     private _material;
     private _receiveShadows;
@@ -33,10 +33,11 @@ declare class RenderComponentElement extends ComponentElement {
         receiveShadows: boolean;
     };
     /**
-     * Gets the underlying PlayCanvas render component.
-     * @returns The render component.
+     * Gets the underlying PlayCanvas render component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The render component, or `null`.
      */
-    get component(): RenderComponent;
+    get component(): RenderComponent | null;
     /**
      * Sets the type of the render component.
      * @param value - The type.

package/dist/components/rigid-body-component.d.cts

@@ -16,7 +16,7 @@ import { ComponentElement } from './component.cjs';
  *
  * @category Components
  */
-declare class RigidBodyComponentElement extends ComponentElement {
+declare class RigidBodyComponentElement extends ComponentElement<RigidBodyComponent> {
     /**
      * The angular damping of the rigidbody.
      */
@@ -67,10 +67,11 @@ declare class RigidBodyComponentElement extends ComponentElement {
         type: "static" | "dynamic" | "kinematic";
     };
     /**
-     * Gets the underlying PlayCanvas rigidbody component.
-     * @returns The rigidbody component.
+     * Gets the underlying PlayCanvas rigidbody component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The rigidbody component, or `null`.
      */
-    get component(): RigidBodyComponent;
+    get component(): RigidBodyComponent | null;
     set angularDamping(value: number);
     get angularDamping(): number;
     set angularFactor(value: Vec3);

package/dist/components/rigid-body-component.d.ts

@@ -16,7 +16,7 @@ import { ComponentElement } from './component.js';
  *
  * @category Components
  */
-declare class RigidBodyComponentElement extends ComponentElement {
+declare class RigidBodyComponentElement extends ComponentElement<RigidBodyComponent> {
     /**
      * The angular damping of the rigidbody.
      */
@@ -67,10 +67,11 @@ declare class RigidBodyComponentElement extends ComponentElement {
         type: "static" | "dynamic" | "kinematic";
     };
     /**
-     * Gets the underlying PlayCanvas rigidbody component.
-     * @returns The rigidbody component.
+     * Gets the underlying PlayCanvas rigidbody component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The rigidbody component, or `null`.
      */
-    get component(): RigidBodyComponent;
+    get component(): RigidBodyComponent | null;
     set angularDamping(value: number);
     get angularDamping(): number;
     set angularFactor(value: Vec3);