@playcanvas/web-components 0.20.0 → 0.21.0

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

@@ -39,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.
      */
@@ -197,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.

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

@@ -39,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.
      */
@@ -197,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.

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);

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

@@ -15,7 +15,7 @@ import { ComponentElement } from './component.cjs';
  *
  * @category Components
  */
-declare class ScreenComponentElement extends ComponentElement {
+declare class ScreenComponentElement extends ComponentElement<ScreenComponent> {
     private _screenSpace;
     private _resolution;
     private _referenceResolution;
@@ -33,10 +33,11 @@ declare class ScreenComponentElement extends ComponentElement {
         screenSpace: boolean;
     };
     /**
-     * Gets the underlying PlayCanvas screen component.
-     * @returns The screen component.
+     * Gets the underlying PlayCanvas screen component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The screen component, or `null`.
      */
-    get component(): ScreenComponent;
+    get component(): ScreenComponent | null;
     set priority(value: number);
     get priority(): number;
     set referenceResolution(value: Vec2);

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

@@ -15,7 +15,7 @@ import { ComponentElement } from './component.js';
  *
  * @category Components
  */
-declare class ScreenComponentElement extends ComponentElement {
+declare class ScreenComponentElement extends ComponentElement<ScreenComponent> {
     private _screenSpace;
     private _resolution;
     private _referenceResolution;
@@ -33,10 +33,11 @@ declare class ScreenComponentElement extends ComponentElement {
         screenSpace: boolean;
     };
     /**
-     * Gets the underlying PlayCanvas screen component.
-     * @returns The screen component.
+     * Gets the underlying PlayCanvas screen component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The screen component, or `null`.
      */
-    get component(): ScreenComponent;
+    get component(): ScreenComponent | null;
     set priority(value: number);
     get priority(): number;
     set referenceResolution(value: Vec2);

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

@@ -29,7 +29,7 @@ export type ScriptNameChangeEvent = {
  *
  * @category Components
  */
-declare class ScriptComponentElement extends ComponentElement {
+declare class ScriptComponentElement extends ComponentElement<ScriptComponent> {
     private observer;
     /** @ignore */
     constructor();
@@ -171,9 +171,10 @@ declare class ScriptComponentElement extends ComponentElement {
     private handleMutations;
     disconnectedCallback(): void;
     /**
-     * Gets the underlying PlayCanvas script component.
-     * @returns The script component.
+     * Gets the underlying PlayCanvas script component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The script component, or `null`.
      */
-    get component(): ScriptComponent;
+    get component(): ScriptComponent | null;
 }
 export { ScriptComponentElement };

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

@@ -29,7 +29,7 @@ export type ScriptNameChangeEvent = {
  *
  * @category Components
  */
-declare class ScriptComponentElement extends ComponentElement {
+declare class ScriptComponentElement extends ComponentElement<ScriptComponent> {
     private observer;
     /** @ignore */
     constructor();
@@ -171,9 +171,10 @@ declare class ScriptComponentElement extends ComponentElement {
     private handleMutations;
     disconnectedCallback(): void;
     /**
-     * Gets the underlying PlayCanvas script component.
-     * @returns The script component.
+     * Gets the underlying PlayCanvas script component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The script component, or `null`.
      */
-    get component(): ScriptComponent;
+    get component(): ScriptComponent | null;
 }
 export { ScriptComponentElement };

package/dist/components/scroll-view-component.d.cts

@@ -15,7 +15,7 @@ import { ComponentElement } from './component.cjs';
  *
  * @category Components
  */
-declare class ScrollViewComponentElement extends ComponentElement {
+declare class ScrollViewComponentElement extends ComponentElement<ScrollViewComponent> {
     private _horizontal;
     private _vertical;
     private _scrollMode;
@@ -33,10 +33,11 @@ declare class ScrollViewComponentElement extends ComponentElement {
     constructor();
     protected getInitialComponentData(): Record<string, any>;
     /**
-     * Gets the underlying PlayCanvas scroll view component.
-     * @returns The scroll view component.
+     * Gets the underlying PlayCanvas scroll view component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The scroll view component, or `null`.
      */
-    get component(): ScrollViewComponent;
+    get component(): ScrollViewComponent | null;
     /**
      * Sets whether scrolling along the horizontal axis is enabled. This is a toggle, unlike the
      * `orientation` of a `<pc-scrollbar>`, for which `horizontal` is one of the accepted values.

package/dist/components/scroll-view-component.d.ts

@@ -15,7 +15,7 @@ import { ComponentElement } from './component.js';
  *
  * @category Components
  */
-declare class ScrollViewComponentElement extends ComponentElement {
+declare class ScrollViewComponentElement extends ComponentElement<ScrollViewComponent> {
     private _horizontal;
     private _vertical;
     private _scrollMode;
@@ -33,10 +33,11 @@ declare class ScrollViewComponentElement extends ComponentElement {
     constructor();
     protected getInitialComponentData(): Record<string, any>;
     /**
-     * Gets the underlying PlayCanvas scroll view component.
-     * @returns The scroll view component.
+     * Gets the underlying PlayCanvas scroll view component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The scroll view component, or `null`.
      */
-    get component(): ScrollViewComponent;
+    get component(): ScrollViewComponent | null;
     /**
      * Sets whether scrolling along the horizontal axis is enabled. This is a toggle, unlike the
      * `orientation` of a `<pc-scrollbar>`, for which `horizontal` is one of the accepted values.

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

@@ -14,7 +14,7 @@ import { ComponentElement } from './component.cjs';
  *
  * @category Components
  */
-declare class ScrollbarComponentElement extends ComponentElement {
+declare class ScrollbarComponentElement extends ComponentElement<ScrollbarComponent> {
     private _orientation;
     private _value;
     private _handleSize;
@@ -23,10 +23,11 @@ declare class ScrollbarComponentElement extends ComponentElement {
     constructor();
     protected getInitialComponentData(): Record<string, any>;
     /**
-     * Gets the underlying PlayCanvas scrollbar component.
-     * @returns The scrollbar component.
+     * Gets the underlying PlayCanvas scrollbar component. `null` until the element is
+     * ready — see {@link ComponentElement.component}.
+     * @returns The scrollbar component, or `null`.
      */
-    get component(): ScrollbarComponent;
+    get component(): ScrollbarComponent | null;
     /**
      * Sets the orientation of the scrollbar. Can be `horizontal` or `vertical`. Defaults to
      * `horizontal`.