@playcanvas/web-components 0.11.1 → 0.13.0

package/dist/entity-base.d.cts

@@ -0,0 +1,67 @@
+import type { Entity } from 'playcanvas';
+import type { AppElement } from './app.cjs';
+import { AsyncElement } from './async-element.cjs';
+/**
+ * The attribute names of the inline `onpointer*` event handlers, shared by every element that
+ * fronts an engine entity. Spread into `observedAttributes` by subclasses.
+ * @ignore
+ */
+declare const POINTER_ATTRIBUTES: readonly ["onpointerenter", "onpointerleave", "onpointerdown", "onpointerup", "onpointermove"];
+/**
+ * The base class for elements that front an engine {@link Entity}: `<pc-entity>`, which creates
+ * one, and `<pc-node>`, which binds to one inside a model's instantiated hierarchy. It carries
+ * what both need — the `entity` contract, registration with the owning application (which joins
+ * picked scene nodes back to elements by identity, never by name), and the pointer listener
+ * bookkeeping that lets the application lazily attach its canvas handlers.
+ */
+declare class EntityBaseElement extends AsyncElement {
+    protected _entity: Entity | null;
+    /**
+     * The application element this entity is registered with, cached at registration time so the
+     * entity can be unregistered even once this element has left the DOM.
+     */
+    protected _appElement: AppElement | null;
+    /**
+     * The pointer event listeners for the entity.
+     */
+    private _listeners;
+    /**
+     * The event types for which an inline `onpointer*` attribute is currently present.
+     */
+    private _inlineHandlerTypes;
+    /**
+     * The PlayCanvas entity instance. `null` until the element is ready, and again once the
+     * entity is gone — await {@link whenReady} or the element's `ready()` promise before
+     * accessing it.
+     * @returns The entity instance, or `null`.
+     */
+    get entity(): Entity | null;
+    /**
+     * Registers `entity` as this element's backing entity with the owning application, which
+     * joins engine nodes back to elements by identity (never by name).
+     *
+     * @param entity - The entity to register.
+     */
+    protected _registerEntity(entity: Entity): void;
+    /**
+     * Removes the registration for `entity`.
+     *
+     * @param entity - The entity to unregister.
+     */
+    protected _unregisterEntity(entity: Entity): void;
+    /**
+     * Tracks whether an inline `onpointer*` attribute is present. The browser itself compiles and
+     * runs these attributes — they are standard `GlobalEventHandlers`, so setting one replaces
+     * the previous handler and removing it removes the handler, exactly like `onclick` on any
+     * HTML element. But because they bypass {@link addEventListener}, the connect/disconnect
+     * bookkeeping that lets the application lazily attach its canvas pointer handlers must be
+     * kept in sync here.
+     *
+     * @param name - The attribute name (e.g. 'onpointerdown').
+     * @param value - The attribute value, or `null` when the attribute has been removed.
+     */
+    protected _updateInlineHandler(name: string, value: string | null): void;
+    addEventListener(type: string, listener: EventListener, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListener, options?: boolean | EventListenerOptions): void;
+}
+export { EntityBaseElement, POINTER_ATTRIBUTES };

package/dist/entity-base.d.ts

@@ -0,0 +1,67 @@
+import type { Entity } from 'playcanvas';
+import type { AppElement } from './app.js';
+import { AsyncElement } from './async-element.js';
+/**
+ * The attribute names of the inline `onpointer*` event handlers, shared by every element that
+ * fronts an engine entity. Spread into `observedAttributes` by subclasses.
+ * @ignore
+ */
+declare const POINTER_ATTRIBUTES: readonly ["onpointerenter", "onpointerleave", "onpointerdown", "onpointerup", "onpointermove"];
+/**
+ * The base class for elements that front an engine {@link Entity}: `<pc-entity>`, which creates
+ * one, and `<pc-node>`, which binds to one inside a model's instantiated hierarchy. It carries
+ * what both need — the `entity` contract, registration with the owning application (which joins
+ * picked scene nodes back to elements by identity, never by name), and the pointer listener
+ * bookkeeping that lets the application lazily attach its canvas handlers.
+ */
+declare class EntityBaseElement extends AsyncElement {
+    protected _entity: Entity | null;
+    /**
+     * The application element this entity is registered with, cached at registration time so the
+     * entity can be unregistered even once this element has left the DOM.
+     */
+    protected _appElement: AppElement | null;
+    /**
+     * The pointer event listeners for the entity.
+     */
+    private _listeners;
+    /**
+     * The event types for which an inline `onpointer*` attribute is currently present.
+     */
+    private _inlineHandlerTypes;
+    /**
+     * The PlayCanvas entity instance. `null` until the element is ready, and again once the
+     * entity is gone — await {@link whenReady} or the element's `ready()` promise before
+     * accessing it.
+     * @returns The entity instance, or `null`.
+     */
+    get entity(): Entity | null;
+    /**
+     * Registers `entity` as this element's backing entity with the owning application, which
+     * joins engine nodes back to elements by identity (never by name).
+     *
+     * @param entity - The entity to register.
+     */
+    protected _registerEntity(entity: Entity): void;
+    /**
+     * Removes the registration for `entity`.
+     *
+     * @param entity - The entity to unregister.
+     */
+    protected _unregisterEntity(entity: Entity): void;
+    /**
+     * Tracks whether an inline `onpointer*` attribute is present. The browser itself compiles and
+     * runs these attributes — they are standard `GlobalEventHandlers`, so setting one replaces
+     * the previous handler and removing it removes the handler, exactly like `onclick` on any
+     * HTML element. But because they bypass {@link addEventListener}, the connect/disconnect
+     * bookkeeping that lets the application lazily attach its canvas pointer handlers must be
+     * kept in sync here.
+     *
+     * @param name - The attribute name (e.g. 'onpointerdown').
+     * @param value - The attribute value, or `null` when the attribute has been removed.
+     */
+    protected _updateInlineHandler(name: string, value: string | null): void;
+    addEventListener(type: string, listener: EventListener, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListener, options?: boolean | EventListenerOptions): void;
+}
+export { EntityBaseElement, POINTER_ATTRIBUTES };

package/dist/entity.d.cts

@@ -0,0 +1,131 @@
+import { Vec3 } from 'playcanvas';
+import { EntityBaseElement } from './entity-base.cjs';
+/**
+ * The EntityElement interface provides properties and methods for manipulating
+ * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-entity/ | `<pc-entity>`} elements.
+ * The EntityElement interface also inherits the properties and methods of the
+ * {@link HTMLElement} interface.
+ *
+ * The pointer events below are dispatched by the containing `<pc-app>` element when the pointer
+ * intersects this entity's geometry. They are only generated while the entity has a listener for
+ * them, registered either with {@link addEventListener} or with the matching inline `onpointer*`
+ * attribute.
+ *
+ * @attribute {string} onpointerenter - Script to run when the pointer moves onto the entity.
+ * @attribute {string} onpointerleave - Script to run when the pointer moves off the entity.
+ * @attribute {string} onpointermove - Script to run when the pointer moves over the entity.
+ * @attribute {string} onpointerdown - Script to run when a pointer button is pressed over the
+ * entity.
+ * @attribute {string} onpointerup - Script to run when a pointer button is released over the
+ * entity.
+ * @fires {PointerEvent} pointerenter - Fired when the pointer moves onto the entity.
+ * @fires {PointerEvent} pointerleave - Fired when the pointer moves off the entity.
+ * @fires {PointerEvent} pointermove - Fired when the pointer moves over the entity.
+ * @fires {PointerEvent} pointerdown - Fired when a pointer button is pressed over the entity.
+ * @fires {PointerEvent} pointerup - Fired when a pointer button is released over the entity.
+ */
+declare class EntityElement extends EntityBaseElement {
+    /**
+     * Whether the entity is enabled.
+     */
+    private _enabled;
+    /**
+     * The name of the entity.
+     */
+    private _name;
+    /**
+     * The position of the entity.
+     */
+    private _position;
+    /**
+     * The rotation of the entity.
+     */
+    private _rotation;
+    /**
+     * The scale of the entity.
+     */
+    private _scale;
+    /**
+     * The tags of the entity.
+     */
+    private _tags;
+    /**
+     * Whether the hierarchy has been built for this entity.
+     */
+    private _built;
+    /**
+     * Handles the destruction of the backing entity. Resets the element so a later re-insertion
+     * starts clean: `_built` must be cleared alongside `_entity`, or _buildHierarchy would bail
+     * and a re-created entity would never be parented. Readiness is re-armed for the same
+     * reason — with the entity gone, a resolved ready promise would resume its awaiters against
+     * a null `entity`.
+     *
+     * @param entity - The entity that was destroyed.
+     */
+    private _onEntityDestroy;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Sets the enabled state of the entity.
+     * @param value - Whether the entity is enabled.
+     */
+    set enabled(value: boolean);
+    /**
+     * Gets the enabled state of the entity.
+     * @returns Whether the entity is enabled.
+     */
+    get enabled(): boolean;
+    /**
+     * Sets the name of the entity.
+     * @param value - The name of the entity.
+     */
+    set name(value: string);
+    /**
+     * Gets the name of the entity.
+     * @returns The name of the entity.
+     */
+    get name(): string;
+    /**
+     * Sets the position of the entity.
+     * @param value - The position of the entity.
+     */
+    set position(value: Vec3);
+    /**
+     * Gets the position of the entity.
+     * @returns The position of the entity.
+     */
+    get position(): Vec3;
+    /**
+     * Sets the rotation of the entity.
+     * @param value - The rotation of the entity.
+     */
+    set rotation(value: Vec3);
+    /**
+     * Gets the rotation of the entity.
+     * @returns The rotation of the entity.
+     */
+    get rotation(): Vec3;
+    /**
+     * Sets the scale of the entity.
+     * @param value - The scale of the entity.
+     */
+    set scale(value: Vec3);
+    /**
+     * Gets the scale of the entity.
+     * @returns The scale of the entity.
+     */
+    get scale(): Vec3;
+    /**
+     * Sets the tags of the entity.
+     * @param value - The tags of the entity.
+     */
+    set tags(value: string[]);
+    /**
+     * Gets the tags of the entity.
+     * @returns The tags of the entity.
+     */
+    get tags(): string[];
+    static get observedAttributes(): string[];
+    attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void;
+}
+export { EntityElement };

package/dist/entity.d.ts

@@ -1,5 +1,5 @@
-import { Entity, Vec3 } from 'playcanvas';
-import { AsyncElement } from './async-element';
+import { Vec3 } from 'playcanvas';
+import { EntityBaseElement } from './entity-base.js';
 /**
  * The EntityElement interface provides properties and methods for manipulating
  * {@link https://developer.playcanvas.com/user-manual/web-components/tags/pc-entity/ | `<pc-entity>`} elements.
@@ -24,7 +24,7 @@ import { AsyncElement } from './async-element';
  * @fires {PointerEvent} pointerdown - Fired when a pointer button is pressed over the entity.
  * @fires {PointerEvent} pointerup - Fired when a pointer button is released over the entity.
  */
-declare class EntityElement extends AsyncElement {
+declare class EntityElement extends EntityBaseElement {
     /**
      * Whether the entity is enabled.
      */
@@ -49,31 +49,10 @@ declare class EntityElement extends AsyncElement {
      * The tags of the entity.
      */
     private _tags;
-    /**
-     * The pointer event listeners for the entity.
-     */
-    private _listeners;
-    /**
-     * The event types for which an inline `onpointer*` attribute is currently present.
-     */
-    private _inlineHandlerTypes;
     /**
      * Whether the hierarchy has been built for this entity.
      */
     private _built;
-    private _entity;
-    /**
-     * The application element this entity is registered with, cached at creation time so the
-     * entity can be unregistered even once this element has left the DOM.
-     */
-    private _appElement;
-    /**
-     * The PlayCanvas entity instance. `null` until the element is ready, and again once it has
-     * been removed from the document — await {@link whenReady} or the element's `ready()`
-     * promise before accessing it.
-     * @returns The entity instance, or `null`.
-     */
-    get entity(): Entity | null;
     /**
      * Handles the destruction of the backing entity. Resets the element so a later re-insertion
      * starts clean: `_built` must be cleared alongside `_entity`, or _buildHierarchy would bail
@@ -146,21 +125,7 @@ declare class EntityElement extends AsyncElement {
      * @returns The tags of the entity.
      */
     get tags(): string[];
-    /**
-     * Tracks whether an inline `onpointer*` attribute is present. The browser itself compiles and
-     * runs these attributes — they are standard `GlobalEventHandlers`, so setting one replaces
-     * the previous handler and removing it removes the handler, exactly like `onclick` on any
-     * HTML element. But because they bypass {@link addEventListener}, the connect/disconnect
-     * bookkeeping that lets the application lazily attach its canvas pointer handlers must be
-     * kept in sync here.
-     *
-     * @param name - The attribute name (e.g. 'onpointerdown').
-     * @param value - The attribute value, or `null` when the attribute has been removed.
-     */
-    private _updateInlineHandler;
     static get observedAttributes(): string[];
     attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void;
-    addEventListener(type: string, listener: EventListener, options?: boolean | AddEventListenerOptions): void;
-    removeEventListener(type: string, listener: EventListener, options?: boolean | EventListenerOptions): void;
 }
 export { EntityElement };

package/dist/index.d.cts

@@ -0,0 +1,79 @@
+/**
+ * The Engine Web Components module provides a set of Web Components for the PlayCanvas Engine.
+ * While these components are normally instantiated in a declarative fashion using HTML, this
+ * reference covers the TypeScript/JavaScript API that allows these components to be created
+ * programmatically.
+ *
+ * @module EngineWebComponents
+ */
+import { AsyncElement, whenReady } from './async-element.cjs';
+import { ModuleElement } from './module.cjs';
+import { AppElement } from './app.cjs';
+import { EntityElement } from './entity.cjs';
+import { AssetElement } from './asset.cjs';
+import { ListenerComponentElement } from './components/listener-component.cjs';
+import { ButtonComponentElement } from './components/button-component.cjs';
+import { CameraComponentElement } from './components/camera-component.cjs';
+import { CollisionComponentElement } from './components/collision-component.cjs';
+import { ComponentElement } from './components/component.cjs';
+import { ElementComponentElement } from './components/element-component.cjs';
+import { LayoutChildComponentElement } from './components/layoutchild-component.cjs';
+import { LayoutGroupComponentElement } from './components/layoutgroup-component.cjs';
+import { LightComponentElement } from './components/light-component.cjs';
+import { ParticleSystemComponentElement } from './components/particlesystem-component.cjs';
+import { RenderComponentElement } from './components/render-component.cjs';
+import { RigidBodyComponentElement } from './components/rigidbody-component.cjs';
+import { ScreenComponentElement } from './components/screen-component.cjs';
+import { ScrollbarComponentElement } from './components/scrollbar-component.cjs';
+import { ScrollViewComponentElement } from './components/scrollview-component.cjs';
+import { ScriptComponentElement } from './components/script-component.cjs';
+import { ScriptElement } from './components/script.cjs';
+import { SoundComponentElement } from './components/sound-component.cjs';
+import { SoundSlotElement } from './components/sound-slot.cjs';
+import { GSplatComponentElement } from './components/gsplat-component.cjs';
+import { EntityBaseElement } from './entity-base.cjs';
+import { MaterialElement } from './material.cjs';
+import { ModelElement } from './model.cjs';
+import { NodeElement } from './node.cjs';
+import { SceneElement } from './scene.cjs';
+import { SkyElement } from './sky.cjs';
+import type { ScriptAttributesChangeEvent, ScriptEnableChangeEvent, ScriptNameChangeEvent } from './components/script-component.cjs';
+declare global {
+    interface HTMLElementEventMap {
+        scriptattributeschange: ScriptAttributesChangeEvent;
+        scriptenablechange: ScriptEnableChangeEvent;
+        scriptnamechange: ScriptNameChangeEvent;
+    }
+    interface HTMLElementTagNameMap {
+        'pc-app': AppElement;
+        'pc-asset': AssetElement;
+        'pc-button': ButtonComponentElement;
+        'pc-camera': CameraComponentElement;
+        'pc-collision': CollisionComponentElement;
+        'pc-element': ElementComponentElement;
+        'pc-entity': EntityElement;
+        'pc-gsplat': GSplatComponentElement;
+        'pc-layoutchild': LayoutChildComponentElement;
+        'pc-layoutgroup': LayoutGroupComponentElement;
+        'pc-light': LightComponentElement;
+        'pc-listener': ListenerComponentElement;
+        'pc-material': MaterialElement;
+        'pc-model': ModelElement;
+        'pc-module': ModuleElement;
+        'pc-node': NodeElement;
+        'pc-particles': ParticleSystemComponentElement;
+        'pc-render': RenderComponentElement;
+        'pc-rigidbody': RigidBodyComponentElement;
+        'pc-scene': SceneElement;
+        'pc-screen': ScreenComponentElement;
+        'pc-script': ScriptElement;
+        'pc-scripts': ScriptComponentElement;
+        'pc-scrollbar': ScrollbarComponentElement;
+        'pc-scrollview': ScrollViewComponentElement;
+        'pc-sky': SkyElement;
+        'pc-sound': SoundSlotElement;
+        'pc-sounds': SoundComponentElement;
+    }
+}
+export { AsyncElement, ModuleElement, AppElement, EntityElement, AssetElement, ButtonComponentElement, CameraComponentElement, CollisionComponentElement, ComponentElement, ElementComponentElement, LayoutChildComponentElement, LayoutGroupComponentElement, ParticleSystemComponentElement, LightComponentElement, ListenerComponentElement, RenderComponentElement, RigidBodyComponentElement, ScreenComponentElement, ScrollbarComponentElement, ScrollViewComponentElement, ScriptComponentElement, ScriptElement, SoundComponentElement, SoundSlotElement, GSplatComponentElement, EntityBaseElement, MaterialElement, ModelElement, NodeElement, SceneElement, SkyElement, whenReady };
+export type { AsyncElementTagName } from './async-element.cjs';

package/dist/index.d.ts

@@ -6,36 +6,38 @@
  *
  * @module EngineWebComponents
  */
-import { AsyncElement, whenReady } from './async-element';
-import { ModuleElement } from './module';
-import { AppElement } from './app';
-import { EntityElement } from './entity';
-import { AssetElement } from './asset';
-import { ListenerComponentElement } from './components/listener-component';
-import { ButtonComponentElement } from './components/button-component';
-import { CameraComponentElement } from './components/camera-component';
-import { CollisionComponentElement } from './components/collision-component';
-import { ComponentElement } from './components/component';
-import { ElementComponentElement } from './components/element-component';
-import { LayoutChildComponentElement } from './components/layoutchild-component';
-import { LayoutGroupComponentElement } from './components/layoutgroup-component';
-import { LightComponentElement } from './components/light-component';
-import { ParticleSystemComponentElement } from './components/particlesystem-component';
-import { RenderComponentElement } from './components/render-component';
-import { RigidBodyComponentElement } from './components/rigidbody-component';
-import { ScreenComponentElement } from './components/screen-component';
-import { ScrollbarComponentElement } from './components/scrollbar-component';
-import { ScrollViewComponentElement } from './components/scrollview-component';
-import { ScriptComponentElement } from './components/script-component';
-import { ScriptElement } from './components/script';
-import { SoundComponentElement } from './components/sound-component';
-import { SoundSlotElement } from './components/sound-slot';
-import { GSplatComponentElement } from './components/gsplat-component';
-import { MaterialElement } from './material';
-import { ModelElement } from './model';
-import { SceneElement } from './scene';
-import { SkyElement } from './sky';
-import type { ScriptAttributesChangeEvent, ScriptEnableChangeEvent, ScriptNameChangeEvent } from './components/script-component';
+import { AsyncElement, whenReady } from './async-element.js';
+import { ModuleElement } from './module.js';
+import { AppElement } from './app.js';
+import { EntityElement } from './entity.js';
+import { AssetElement } from './asset.js';
+import { ListenerComponentElement } from './components/listener-component.js';
+import { ButtonComponentElement } from './components/button-component.js';
+import { CameraComponentElement } from './components/camera-component.js';
+import { CollisionComponentElement } from './components/collision-component.js';
+import { ComponentElement } from './components/component.js';
+import { ElementComponentElement } from './components/element-component.js';
+import { LayoutChildComponentElement } from './components/layoutchild-component.js';
+import { LayoutGroupComponentElement } from './components/layoutgroup-component.js';
+import { LightComponentElement } from './components/light-component.js';
+import { ParticleSystemComponentElement } from './components/particlesystem-component.js';
+import { RenderComponentElement } from './components/render-component.js';
+import { RigidBodyComponentElement } from './components/rigidbody-component.js';
+import { ScreenComponentElement } from './components/screen-component.js';
+import { ScrollbarComponentElement } from './components/scrollbar-component.js';
+import { ScrollViewComponentElement } from './components/scrollview-component.js';
+import { ScriptComponentElement } from './components/script-component.js';
+import { ScriptElement } from './components/script.js';
+import { SoundComponentElement } from './components/sound-component.js';
+import { SoundSlotElement } from './components/sound-slot.js';
+import { GSplatComponentElement } from './components/gsplat-component.js';
+import { EntityBaseElement } from './entity-base.js';
+import { MaterialElement } from './material.js';
+import { ModelElement } from './model.js';
+import { NodeElement } from './node.js';
+import { SceneElement } from './scene.js';
+import { SkyElement } from './sky.js';
+import type { ScriptAttributesChangeEvent, ScriptEnableChangeEvent, ScriptNameChangeEvent } from './components/script-component.js';
 declare global {
     interface HTMLElementEventMap {
         scriptattributeschange: ScriptAttributesChangeEvent;
@@ -58,6 +60,7 @@ declare global {
         'pc-material': MaterialElement;
         'pc-model': ModelElement;
         'pc-module': ModuleElement;
+        'pc-node': NodeElement;
         'pc-particles': ParticleSystemComponentElement;
         'pc-render': RenderComponentElement;
         'pc-rigidbody': RigidBodyComponentElement;
@@ -72,5 +75,5 @@ declare global {
         'pc-sounds': SoundComponentElement;
     }
 }
-export { AsyncElement, ModuleElement, AppElement, EntityElement, AssetElement, ButtonComponentElement, CameraComponentElement, CollisionComponentElement, ComponentElement, ElementComponentElement, LayoutChildComponentElement, LayoutGroupComponentElement, ParticleSystemComponentElement, LightComponentElement, ListenerComponentElement, RenderComponentElement, RigidBodyComponentElement, ScreenComponentElement, ScrollbarComponentElement, ScrollViewComponentElement, ScriptComponentElement, ScriptElement, SoundComponentElement, SoundSlotElement, GSplatComponentElement, MaterialElement, ModelElement, SceneElement, SkyElement, whenReady };
-export type { AsyncElementTagName } from './async-element';
+export { AsyncElement, ModuleElement, AppElement, EntityElement, AssetElement, ButtonComponentElement, CameraComponentElement, CollisionComponentElement, ComponentElement, ElementComponentElement, LayoutChildComponentElement, LayoutGroupComponentElement, ParticleSystemComponentElement, LightComponentElement, ListenerComponentElement, RenderComponentElement, RigidBodyComponentElement, ScreenComponentElement, ScrollbarComponentElement, ScrollViewComponentElement, ScriptComponentElement, ScriptElement, SoundComponentElement, SoundSlotElement, GSplatComponentElement, EntityBaseElement, MaterialElement, ModelElement, NodeElement, SceneElement, SkyElement, whenReady };
+export type { AsyncElementTagName } from './async-element.js';

package/dist/loading-bar.d.cts

@@ -0,0 +1,35 @@
+/**
+ * The slim progress bar `<pc-app>` shows while it boots and preloads. An implementation detail of
+ * AppElement rather than a custom element, so its shape can change without a breaking change.
+ *
+ * All styling is inline, so the library injects no stylesheet. The colors and height resolve CSS
+ * custom properties — `--pc-loading-bar-color`, `--pc-loading-bar-background` and
+ * `--pc-loading-bar-height` — so a page can theme the bar from `pc-app` or `:root`.
+ */
+declare class LoadingBar {
+    private _track;
+    private _fill;
+    private _sweep;
+    private _removal;
+    /**
+     * Creates the bar and appends it to `parent`, starting in the indeterminate state.
+     * @param parent - The element to append the bar to.
+     */
+    constructor(parent: HTMLElement);
+    /**
+     * Reflects preload progress, switching the bar from indeterminate to determinate on the first
+     * call.
+     * @param loaded - The number of assets that have finished loading.
+     * @param total - The number of assets being preloaded.
+     */
+    progress(loaded: number, total: number): void;
+    /**
+     * Fills the bar, fades it out and removes it. Idempotent.
+     */
+    complete(): void;
+    /**
+     * Removes the bar immediately, cancelling any pending fade. Idempotent.
+     */
+    destroy(): void;
+}
+export { LoadingBar };