@dcl/ecs 7.19.1-21526551025.commit-799f37f → 7.19.1-21595262606.commit-a6f1c20

package/dist/components/generated/pb/decentraland/sdk/components/audio_analysis.gen.js

@@ -0,0 +1,161 @@
+/* eslint-disable */
+import _m0 from "protobufjs/minimal";
+const protobufPackageSarasa = "decentraland.sdk.components";
+/**
+ * @public
+ */
+export var PBAudioAnalysisMode;
+(function (PBAudioAnalysisMode) {
+    PBAudioAnalysisMode[PBAudioAnalysisMode["MODE_RAW"] = 0] = "MODE_RAW";
+    PBAudioAnalysisMode[PBAudioAnalysisMode["MODE_LOGARITHMIC"] = 1] = "MODE_LOGARITHMIC";
+})(PBAudioAnalysisMode || (PBAudioAnalysisMode = {}));
+function createBasePBAudioAnalysis() {
+    return {
+        mode: 0,
+        amplitudeGain: undefined,
+        bandsGain: undefined,
+        amplitude: 0,
+        band0: 0,
+        band1: 0,
+        band2: 0,
+        band3: 0,
+        band4: 0,
+        band5: 0,
+        band6: 0,
+        band7: 0,
+    };
+}
+/**
+ * @public
+ */
+export var PBAudioAnalysis;
+(function (PBAudioAnalysis) {
+    function encode(message, writer = _m0.Writer.create()) {
+        if (message.mode !== 0) {
+            writer.uint32(8).int32(message.mode);
+        }
+        if (message.amplitudeGain !== undefined) {
+            writer.uint32(805).float(message.amplitudeGain);
+        }
+        if (message.bandsGain !== undefined) {
+            writer.uint32(813).float(message.bandsGain);
+        }
+        if (message.amplitude !== 0) {
+            writer.uint32(1605).float(message.amplitude);
+        }
+        if (message.band0 !== 0) {
+            writer.uint32(1613).float(message.band0);
+        }
+        if (message.band1 !== 0) {
+            writer.uint32(1621).float(message.band1);
+        }
+        if (message.band2 !== 0) {
+            writer.uint32(1629).float(message.band2);
+        }
+        if (message.band3 !== 0) {
+            writer.uint32(1637).float(message.band3);
+        }
+        if (message.band4 !== 0) {
+            writer.uint32(1645).float(message.band4);
+        }
+        if (message.band5 !== 0) {
+            writer.uint32(1653).float(message.band5);
+        }
+        if (message.band6 !== 0) {
+            writer.uint32(1661).float(message.band6);
+        }
+        if (message.band7 !== 0) {
+            writer.uint32(1669).float(message.band7);
+        }
+        return writer;
+    }
+    PBAudioAnalysis.encode = encode;
+    function decode(input, length) {
+        const reader = input instanceof _m0.Reader ? input : _m0.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBasePBAudioAnalysis();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 8) {
+                        break;
+                    }
+                    message.mode = reader.int32();
+                    continue;
+                case 100:
+                    if (tag !== 805) {
+                        break;
+                    }
+                    message.amplitudeGain = reader.float();
+                    continue;
+                case 101:
+                    if (tag !== 813) {
+                        break;
+                    }
+                    message.bandsGain = reader.float();
+                    continue;
+                case 200:
+                    if (tag !== 1605) {
+                        break;
+                    }
+                    message.amplitude = reader.float();
+                    continue;
+                case 201:
+                    if (tag !== 1613) {
+                        break;
+                    }
+                    message.band0 = reader.float();
+                    continue;
+                case 202:
+                    if (tag !== 1621) {
+                        break;
+                    }
+                    message.band1 = reader.float();
+                    continue;
+                case 203:
+                    if (tag !== 1629) {
+                        break;
+                    }
+                    message.band2 = reader.float();
+                    continue;
+                case 204:
+                    if (tag !== 1637) {
+                        break;
+                    }
+                    message.band3 = reader.float();
+                    continue;
+                case 205:
+                    if (tag !== 1645) {
+                        break;
+                    }
+                    message.band4 = reader.float();
+                    continue;
+                case 206:
+                    if (tag !== 1653) {
+                        break;
+                    }
+                    message.band5 = reader.float();
+                    continue;
+                case 207:
+                    if (tag !== 1661) {
+                        break;
+                    }
+                    message.band6 = reader.float();
+                    continue;
+                case 208:
+                    if (tag !== 1669) {
+                        break;
+                    }
+                    message.band7 = reader.float();
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    }
+    PBAudioAnalysis.decode = decode;
+})(PBAudioAnalysis || (PBAudioAnalysis = {}));

package/dist/components/generated/pb/decentraland/sdk/components/avatar_locomotion_settings.gen.d.ts

@@ -0,0 +1,29 @@
+import _m0 from "protobufjs/minimal";
+/**
+ * The PBAvatarLocomotionSettings component allows scenes to modify locomotion settings defining things such
+ * as the avatar movement speed, jump height etc.
+ */
+/**
+ * @public
+ */
+export interface PBAvatarLocomotionSettings {
+    /** Maximum speed when walking (in meters per second) */
+    walkSpeed?: number | undefined;
+    /** Maximum speed when jogging (in meters per second) */
+    jogSpeed?: number | undefined;
+    /** Maximum speed when running (in meters per second) */
+    runSpeed?: number | undefined;
+    /** Height of a regular jump (in meters) */
+    jumpHeight?: number | undefined;
+    /** Height of a jump while running (in meters) */
+    runJumpHeight?: number | undefined;
+    /** Cooldown time after a hard landing before the avatar can move again (in seconds) */
+    hardLandingCooldown?: number | undefined;
+}
+/**
+ * @public
+ */
+export declare namespace PBAvatarLocomotionSettings {
+    function encode(message: PBAvatarLocomotionSettings, writer?: _m0.Writer): _m0.Writer;
+    function decode(input: _m0.Reader | Uint8Array, length?: number): PBAvatarLocomotionSettings;
+}

package/dist/components/generated/pb/decentraland/sdk/components/avatar_locomotion_settings.gen.js

@@ -0,0 +1,93 @@
+/* eslint-disable */
+import _m0 from "protobufjs/minimal";
+const protobufPackageSarasa = "decentraland.sdk.components";
+function createBasePBAvatarLocomotionSettings() {
+    return {
+        walkSpeed: undefined,
+        jogSpeed: undefined,
+        runSpeed: undefined,
+        jumpHeight: undefined,
+        runJumpHeight: undefined,
+        hardLandingCooldown: undefined,
+    };
+}
+/**
+ * @public
+ */
+export var PBAvatarLocomotionSettings;
+(function (PBAvatarLocomotionSettings) {
+    function encode(message, writer = _m0.Writer.create()) {
+        if (message.walkSpeed !== undefined) {
+            writer.uint32(13).float(message.walkSpeed);
+        }
+        if (message.jogSpeed !== undefined) {
+            writer.uint32(21).float(message.jogSpeed);
+        }
+        if (message.runSpeed !== undefined) {
+            writer.uint32(29).float(message.runSpeed);
+        }
+        if (message.jumpHeight !== undefined) {
+            writer.uint32(37).float(message.jumpHeight);
+        }
+        if (message.runJumpHeight !== undefined) {
+            writer.uint32(45).float(message.runJumpHeight);
+        }
+        if (message.hardLandingCooldown !== undefined) {
+            writer.uint32(53).float(message.hardLandingCooldown);
+        }
+        return writer;
+    }
+    PBAvatarLocomotionSettings.encode = encode;
+    function decode(input, length) {
+        const reader = input instanceof _m0.Reader ? input : _m0.Reader.create(input);
+        let end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBasePBAvatarLocomotionSettings();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 13) {
+                        break;
+                    }
+                    message.walkSpeed = reader.float();
+                    continue;
+                case 2:
+                    if (tag !== 21) {
+                        break;
+                    }
+                    message.jogSpeed = reader.float();
+                    continue;
+                case 3:
+                    if (tag !== 29) {
+                        break;
+                    }
+                    message.runSpeed = reader.float();
+                    continue;
+                case 4:
+                    if (tag !== 37) {
+                        break;
+                    }
+                    message.jumpHeight = reader.float();
+                    continue;
+                case 5:
+                    if (tag !== 45) {
+                        break;
+                    }
+                    message.runJumpHeight = reader.float();
+                    continue;
+                case 6:
+                    if (tag !== 53) {
+                        break;
+                    }
+                    message.hardLandingCooldown = reader.float();
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    }
+    PBAvatarLocomotionSettings.decode = decode;
+})(PBAvatarLocomotionSettings || (PBAvatarLocomotionSettings = {}));

package/dist/components/generated/pb/decentraland/sdk/components/common/input_action.gen.d.ts

@@ -15,7 +15,8 @@ export declare const enum InputAction {
     IA_ACTION_3 = 10,
     IA_ACTION_4 = 11,
     IA_ACTION_5 = 12,
-    IA_ACTION_6 = 13
+    IA_ACTION_6 = 13,
+    IA_MODIFIER = 14
 }
 /** PointerEventType is a kind of interaction that can be detected. */
 /**

package/dist/components/generated/pb/decentraland/sdk/components/common/input_action.gen.js

@@ -19,6 +19,7 @@ export var InputAction;
     InputAction[InputAction["IA_ACTION_4"] = 11] = "IA_ACTION_4";
     InputAction[InputAction["IA_ACTION_5"] = 12] = "IA_ACTION_5";
     InputAction[InputAction["IA_ACTION_6"] = 13] = "IA_ACTION_6";
+    InputAction[InputAction["IA_MODIFIER"] = 14] = "IA_MODIFIER";
 })(InputAction || (InputAction = {}));
 /** PointerEventType is a kind of interaction that can be detected. */
 /**

package/dist/components/generated/pb/decentraland/sdk/components/virtual_camera.gen.d.ts

@@ -6,6 +6,7 @@ import { CameraTransition } from "./common/camera_transition.gen";
  * an 'instant' transition (like using speed/time = 0)
  * * The lookAtEntity defines to which entity the Camera has to look at constantly (independent from
  * the holding entity transform).
+ * * The fov defines the Field of View of the virtual camera
  */
 /**
  * @public
@@ -13,6 +14,8 @@ import { CameraTransition } from "./common/camera_transition.gen";
 export interface PBVirtualCamera {
     defaultTransition?: CameraTransition | undefined;
     lookAtEntity?: number | undefined;
+    /** default: 60 */
+    fov?: number | undefined;
 }
 /**
  * @public

package/dist/components/generated/pb/decentraland/sdk/components/virtual_camera.gen.js

@@ -3,7 +3,7 @@ import _m0 from "protobufjs/minimal";
 import { CameraTransition } from "./common/camera_transition.gen";
 const protobufPackageSarasa = "decentraland.sdk.components";
 function createBasePBVirtualCamera() {
-    return { defaultTransition: undefined, lookAtEntity: undefined };
+    return { defaultTransition: undefined, lookAtEntity: undefined, fov: undefined };
 }
 /**
  * @public
@@ -17,6 +17,9 @@ export var PBVirtualCamera;
         if (message.lookAtEntity !== undefined) {
             writer.uint32(16).uint32(message.lookAtEntity);
         }
+        if (message.fov !== undefined) {
+            writer.uint32(29).float(message.fov);
+        }
         return writer;
     }
     PBVirtualCamera.encode = encode;
@@ -39,6 +42,12 @@ export var PBVirtualCamera;
                     }
                     message.lookAtEntity = reader.uint32();
                     continue;
+                case 3:
+                    if (tag !== 29) {
+                        break;
+                    }
+                    message.fov = reader.float();
+                    continue;
             }
             if ((tag & 7) === 4 || tag === 0) {
                 break;

package/dist/components/index.d.ts

@@ -2,6 +2,8 @@ import { GrowOnlyValueSetComponentDefinition, LastWriteWinElementSetComponentDef
 import { IEngine } from '../engine/types';
 import { AnimatorComponentDefinitionExtended } from './extended/Animator';
 import { AudioSourceComponentDefinitionExtended } from './extended/AudioSource';
+import { AudioAnalysisComponentDefinitionExtended } from './extended/AudioAnalysis';
+import type { AudioAnalysisView } from './extended/AudioAnalysis';
 import { MaterialComponentDefinitionExtended } from './extended/Material';
 import { MeshColliderComponentDefinitionExtended } from './extended/MeshCollider';
 import { MeshRendererComponentDefinitionExtended } from './extended/MeshRenderer';
@@ -25,6 +27,7 @@ export declare const Transform: LwwComponentGetter<TransformComponentExtended>;
 export declare const Material: LwwComponentGetter<MaterialComponentDefinitionExtended>;
 export declare const Animator: LwwComponentGetter<AnimatorComponentDefinitionExtended>;
 export declare const AudioSource: LwwComponentGetter<AudioSourceComponentDefinitionExtended>;
+export declare const AudioAnalysis: LwwComponentGetter<AudioAnalysisComponentDefinitionExtended>;
 export declare const AudioStream: (engine: Pick<IEngine, 'defineComponentFromSchema' | 'defineValueSetComponentFromSchema'>) => AudioStreamComponentDefinitionExtended;
 export declare const MeshRenderer: LwwComponentGetter<MeshRendererComponentDefinitionExtended>;
 export declare const MeshCollider: LwwComponentGetter<MeshColliderComponentDefinitionExtended>;
@@ -51,3 +54,4 @@ export declare const NetworkEntity: (engine: Pick<IEngine, 'defineComponent'>) =
  */
 export declare const NetworkParent: (engine: Pick<IEngine, 'defineComponent'>) => LastWriteWinElementSetComponentDefinition<INetowrkParentType>;
 export { MediaState };
+export type { AudioAnalysisView };

package/dist/components/index.js

@@ -1,5 +1,6 @@
 import { defineAnimatorComponent } from './extended/Animator';
 import { defineAudioSourceComponent } from './extended/AudioSource';
+import { defineAudioAnalysisComponent } from './extended/AudioAnalysis';
 import { defineMaterialComponent } from './extended/Material';
 import { defineMeshColliderComponent } from './extended/MeshCollider';
 import { defineMeshRendererComponent } from './extended/MeshRenderer';
@@ -26,6 +27,8 @@ export const Animator = (engine) => defineAnimatorComponent(engine);
 /* @__PURE__ */
 export const AudioSource = (engine) => defineAudioSourceComponent(engine);
 /* @__PURE__ */
+export const AudioAnalysis = (engine) => defineAudioAnalysisComponent(engine);
+/* @__PURE__ */
 export const AudioStream = (engine) => defineAudioStreamComponent(engine);
 /* @__PURE__ */
 export const MeshRenderer = (engine) => defineMeshRendererComponent(engine);

package/dist/components/types.d.ts

@@ -1,5 +1,6 @@
 export type { AnimatorComponentDefinitionExtended } from './extended/Animator';
 export type { AudioSourceComponentDefinitionExtended } from './extended/AudioSource';
+export type { AudioAnalysisComponentDefinitionExtended, AudioAnalysisView } from './extended/AudioAnalysis';
 export type { AudioStreamComponentDefinitionExtended } from './extended/AudioStream';
 export type { MeshRendererComponentDefinitionExtended } from './extended/MeshRenderer';
 export type { MeshColliderComponentDefinitionExtended } from './extended/MeshCollider';

package/dist/index.d.ts

@@ -7,17 +7,19 @@ export { cyclicParentingChecker } from './systems/cyclicParentingChecker';
 export * from './systems/events';
 export * from './systems/raycast';
 export * from './systems/videoEvents';
+export * from './systems/assetLoad';
 export * from './systems/async-task';
 export * from './systems/tween';
 export * from './systems/triggerArea';
 export * from './engine/entity';
 export * from './components/types';
-import { MaterialComponentDefinitionExtended, MeshColliderComponentDefinitionExtended, MeshRendererComponentDefinitionExtended, TransformComponentExtended, AnimatorComponentDefinitionExtended, AudioSourceComponentDefinitionExtended, AudioStreamComponentDefinitionExtended, ISyncComponents, TweenComponentDefinitionExtended, INetowrkEntity, INetowrkParent, VirtualCameraComponentDefinitionExtended, InputModifierComponentDefinitionExtended, LightSourceComponentDefinitionExtended, TriggerAreaComponentDefinitionExtended } from './components/types';
+import { MaterialComponentDefinitionExtended, MeshColliderComponentDefinitionExtended, MeshRendererComponentDefinitionExtended, TransformComponentExtended, AnimatorComponentDefinitionExtended, AudioSourceComponentDefinitionExtended, AudioAnalysisComponentDefinitionExtended, AudioStreamComponentDefinitionExtended, ISyncComponents, TweenComponentDefinitionExtended, INetowrkEntity, INetowrkParent, VirtualCameraComponentDefinitionExtended, InputModifierComponentDefinitionExtended, LightSourceComponentDefinitionExtended, TriggerAreaComponentDefinitionExtended } from './components/types';
 import { NameComponent } from './components/manual/Name';
 import { TagsComponentDefinitionExtended } from './components/manual/Tags';
 export declare const Transform: TransformComponentExtended;
 export declare const Animator: AnimatorComponentDefinitionExtended;
 export declare const AudioSource: AudioSourceComponentDefinitionExtended;
+export declare const AudioAnalysis: AudioAnalysisComponentDefinitionExtended;
 export declare const AudioStream: AudioStreamComponentDefinitionExtended;
 export declare const Material: MaterialComponentDefinitionExtended;
 export declare const MeshRenderer: MeshRendererComponentDefinitionExtended;

package/dist/index.js

@@ -8,6 +8,7 @@ export { cyclicParentingChecker } from './systems/cyclicParentingChecker';
 export * from './systems/events';
 export * from './systems/raycast';
 export * from './systems/videoEvents';
+export * from './systems/assetLoad';
 export * from './systems/async-task';
 export * from './systems/tween';
 export * from './systems/triggerArea';
@@ -22,6 +23,7 @@ import { engine } from './runtime/initialization';
 export const Transform = /* @__PURE__*/ components.Transform(engine);
 export const Animator = /* @__PURE__*/ components.Animator(engine);
 export const AudioSource = /* @__PURE__*/ components.AudioSource(engine);
+export const AudioAnalysis = /* @__PURE__*/ components.AudioAnalysis(engine);
 export const AudioStream = /* @__PURE__*/ components.AudioStream(engine);
 export const Material = /* @__PURE__*/ components.Material(engine);
 export const MeshRenderer = /* @__PURE__*/ components.MeshRenderer(engine);

package/dist/runtime/initialization/index.d.ts

@@ -8,6 +8,7 @@ import { PointerEventsSystem } from '../../systems/events';
 import { IInputSystem } from './../../engine/input';
 import { RaycastSystem } from '../../systems/raycast';
 import { VideoEventsSystem } from '../../systems/videoEvents';
+import { AssetLoadLoadingStateSystem } from '../../systems/assetLoad';
 import { TweenSystem } from '../../systems/tween';
 import { TriggerAreaEventsSystem } from '../../systems/triggerArea';
 import { createTimers, Timers } from '../helpers/timers';
@@ -52,6 +53,12 @@ export { RaycastSystem };
  */
 export declare const videoEventsSystem: VideoEventsSystem;
 export { VideoEventsSystem };
+/**
+ * @public
+ * Register callback functions to a particular entity on asset pre-load events.
+ */
+export declare const assetLoadLoadingStateSystem: AssetLoadLoadingStateSystem;
+export { AssetLoadLoadingStateSystem };
 /**
  * @public
  * Register callback functions to a particular entity on tween events.

package/dist/runtime/initialization/index.js

@@ -8,6 +8,7 @@ import { createPointerEventsSystem } from '../../systems/events';
 import { createInputSystem } from './../../engine/input';
 import { createRaycastSystem } from '../../systems/raycast';
 import { createVideoEventsSystem } from '../../systems/videoEvents';
+import { createAssetLoadLoadingStateSystem } from '../../systems/assetLoad';
 import { createTweenSystem } from '../../systems/tween';
 import { pointerEventColliderChecker } from '../../systems/pointer-event-collider-checker';
 import { createTriggerAreaEventsSystem } from '../../systems/triggerArea';
@@ -50,6 +51,12 @@ export const raycastSystem = /* @__PURE__ */ createRaycastSystem(engine);
  * Register callback functions to a particular entity on video events.
  */
 export const videoEventsSystem = /* @__PURE__ */ createVideoEventsSystem(engine);
+/**
+ * @public
+ * Register callback functions to a particular entity on asset pre-load events.
+ */
+export const assetLoadLoadingStateSystem = 
+/* @__PURE__ */ createAssetLoadLoadingStateSystem(engine);
 /**
  * @public
  * Register callback functions to a particular entity on tween events.

package/dist/systems/assetLoad.d.ts

@@ -0,0 +1,13 @@
+import { DeepReadonlyObject, Entity } from '../engine';
+import { PBAssetLoadLoadingState } from '../components';
+/**
+ * @public
+ */
+export type AssetLoadLoadingStateSystemCallback = (event: DeepReadonlyObject<PBAssetLoadLoadingState>) => void;
+/**
+ * @public
+ */
+export interface AssetLoadLoadingStateSystem {
+    removeAssetLoadLoadingStateEntity(entity: Entity): void;
+    registerAssetLoadLoadingStateEntity(entity: Entity, callback: AssetLoadLoadingStateSystemCallback): void;
+}

package/dist/systems/assetLoad.js

@@ -0,0 +1,47 @@
+import * as components from '../components';
+import { EntityState } from '../engine/entity';
+/**
+ * @internal
+ */
+export function createAssetLoadLoadingStateSystem(engine) {
+    const assetLoadLoadingStateComponent = components.AssetLoadLoadingState(engine);
+    const entitiesCallbackAssetLoadLoadingStateMap = new Map();
+    function registerAssetLoadLoadingStateEntity(entity, callback) {
+        entitiesCallbackAssetLoadLoadingStateMap.set(entity, { callback: callback, lastLoadingStateLength: 0 });
+    }
+    function removeAssetLoadLoadingStateEntity(entity) {
+        entitiesCallbackAssetLoadLoadingStateMap.delete(entity);
+    }
+    // @internal
+    engine.addSystem(function EventSystem() {
+        const garbageEntries = [];
+        for (const [entity, data] of entitiesCallbackAssetLoadLoadingStateMap) {
+            if (engine.getEntityState(entity) === EntityState.Removed) {
+                garbageEntries.push(entity);
+                continue;
+            }
+            const loadingState = assetLoadLoadingStateComponent.get(entity);
+            if (loadingState.size === 0 || loadingState.size === data.lastLoadingStateLength)
+                continue;
+            // Get last added values (can be multiple per tick, just not for the same asset)
+            const lastValues = Array.from(loadingState.values()).slice(data.lastLoadingStateLength);
+            lastValues.forEach((value) => {
+                data.callback(value);
+            });
+            entitiesCallbackAssetLoadLoadingStateMap.set(entity, {
+                callback: data.callback,
+                lastLoadingStateLength: loadingState.size
+            });
+        }
+        // Clean up garbage entries
+        garbageEntries.forEach((garbageEntity) => entitiesCallbackAssetLoadLoadingStateMap.delete(garbageEntity));
+    });
+    return {
+        removeAssetLoadLoadingStateEntity(entity) {
+            removeAssetLoadLoadingStateEntity(entity);
+        },
+        registerAssetLoadLoadingStateEntity(entity, callback) {
+            registerAssetLoadLoadingStateEntity(entity, callback);
+        }
+    };
+}

package/dist-cjs/components/extended/AudioAnalysis.d.ts

@@ -0,0 +1,55 @@
+import { Entity, IEngine } from '../../engine';
+import { LastWriteWinElementSetComponentDefinition } from '../../engine/component';
+import { PBAudioAnalysis, PBAudioAnalysisMode } from '../generated/pb/decentraland/sdk/components/audio_analysis.gen';
+export interface AudioAnalysisComponentDefinitionExtended extends LastWriteWinElementSetComponentDefinition<PBAudioAnalysis> {
+    /**
+     * Reads the component data of `entity` into the provided `out` view.
+     *
+     * @throws Error if the entity does not have an AudioAnalysis component.
+     * @param entity - The entity whose AudioAnalysis data will be read.
+     * @param out - An existing AudioAnalysisView to populate with the latest values.
+     */
+    readIntoView(entity: Entity, out: AudioAnalysisView): void;
+    /**
+     * Attempts to read the component data of `entity` into the provided `out` view.
+     *
+     * @returns `true` if the component exists and data was written into `out`,
+     *          `false` if the entity does not have an AudioAnalysis component.
+     * @param entity - The entity whose AudioAnalysis data will be read.
+     * @param out - An existing AudioAnalysisView to populate.
+     */
+    tryReadIntoView(entity: Entity, out: AudioAnalysisView): boolean;
+    /**
+     * Creates an AudioAnalysis component for the given `entity`.
+     *
+     * If a component already exists on the entity, this call fails (does not replace).
+     *
+     * @param entity - The entity to attach the component to.
+     * @param mode - Analysis mode. Defaults to `PBAudioAnalysisMode.MODE_LOGARITHMIC`.
+     * @param amplitudeGain - Optional amplitude gain multiplier.
+     * @param bandsGain - Optional gain multiplier applied to all frequency bands.
+     */
+    createAudioAnalysis(entity: Entity, mode?: PBAudioAnalysisMode, // default is PBAudioAnalysisMode.MODE_LOGARITHMIC
+    amplitudeGain?: number, bandsGain?: number): void;
+    /**
+     * Creates the AudioAnalysis component if missing, or replaces the existing one.
+     *
+     * @param entity - The target entity.
+     * @param mode - Analysis mode. Defaults to `PBAudioAnalysisMode.MODE_LOGARITHMIC`.
+     * @param amplitudeGain - Optional amplitude gain multiplier.
+     * @param bandsGain - Optional gain multiplier applied to the frequency bands.
+     */
+    createOrReplaceAudioAnalysis(entity: Entity, mode?: PBAudioAnalysisMode, // default is PBAudioAnalysisMode.MODE_LOGARITHMIC
+    amplitudeGain?: number, bandsGain?: number): void;
+}
+/**
+ * A read-only JavaScript-friendly view of AudioAnalysis ECS data.
+ *
+ * `amplitude` represents the aggregated signal strength.
+ * `bands` represents the processed frequency bands.
+ */
+export type AudioAnalysisView = {
+    amplitude: number;
+    bands: number[];
+};
+export declare function defineAudioAnalysisComponent(engine: Pick<IEngine, 'defineComponentFromSchema'>): AudioAnalysisComponentDefinitionExtended;