@dcl/playground-assets 7.18.2-21453292414.commit-1da934f → 7.18.2-21458377493.commit-ea4f3b6

package/dist/index.bundled.d.ts

@@ -90,6 +90,61 @@ export declare namespace AppendValueOperation {
  */
 export declare function areConnected(parcels: Coords[]): boolean;
 
+export declare const AudioAnalysis: AudioAnalysisComponentDefinitionExtended;
+
+export declare 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 declare type AudioAnalysisView = {
+    amplitude: number;
+    bands: number[];
+};
+
 /** @public */
 export declare const AudioEvent: GrowOnlyValueSetComponentDefinition<PBAudioEvent>;
 
@@ -184,6 +239,9 @@ export declare const AvatarEmoteCommand: GrowOnlyValueSetComponentDefinition<PBA
 /** @public */
 export declare const AvatarEquippedData: LastWriteWinElementSetComponentDefinition<PBAvatarEquippedData>;
 
+/** @public */
+export declare const AvatarLocomotionSettings: LastWriteWinElementSetComponentDefinition<PBAvatarLocomotionSettings>;
+
 /** @public */
 export declare const AvatarModifierArea: LastWriteWinElementSetComponentDefinition<PBAvatarModifierArea>;
 
@@ -1294,6 +1352,7 @@ export declare type ComponentDefinition<T> = LastWriteWinElementSetComponentDefi
 /** public */
 export declare const componentDefinitionByName: {
     "core::Animator": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAnimator>>;
+    "core::AudioAnalysis": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAudioAnalysis>>;
     "core::AudioEvent": GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBAudioEvent>>;
     "core::AudioSource": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAudioSource>>;
     "core::AudioStream": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAudioStream>>;
@@ -1301,6 +1360,7 @@ export declare const componentDefinitionByName: {
     "core::AvatarBase": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarBase>>;
     "core::AvatarEmoteCommand": GSetComponentGetter<GrowOnlyValueSetComponentDefinition<PBAvatarEmoteCommand>>;
     "core::AvatarEquippedData": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarEquippedData>>;
+    "core::AvatarLocomotionSettings": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarLocomotionSettings>>;
     "core::AvatarModifierArea": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarModifierArea>>;
     "core::AvatarShape": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBAvatarShape>>;
     "core::Billboard": LwwComponentGetter<LastWriteWinElementSetComponentDefinition<PBBillboard>>;
@@ -2004,6 +2064,7 @@ export declare type EventSystemOptions = {
     maxDistance?: number;
     showFeedback?: boolean;
     showHighlight?: boolean;
+    maxPlayerDistance?: number;
 };
 
 /**
@@ -2648,7 +2709,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
 }
 
 export declare const InputModifier: InputModifierComponentDefinitionExtended;
@@ -4292,6 +4354,45 @@ export declare namespace PBAnimator {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBAnimator;
 }
 
+/**
+ * @public
+ */
+export declare interface PBAudioAnalysis {
+    /** Parameters section */
+    mode: PBAudioAnalysisMode;
+    /** Used only when mode == MODE_LOGARITHMIC */
+    amplitudeGain?: number | undefined;
+    /** End when mode == MODE_LOGARITHMIC */
+    bandsGain?: number | undefined;
+    /** Result section */
+    amplitude: number;
+    /** Protobuf doesn't support fixed arrays -> 8 band fields */
+    band0: number;
+    band1: number;
+    band2: number;
+    band3: number;
+    band4: number;
+    band5: number;
+    band6: number;
+    band7: number;
+}
+
+/**
+ * @public
+ */
+export declare namespace PBAudioAnalysis {
+    export function encode(message: PBAudioAnalysis, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBAudioAnalysis;
+}
+
+/**
+ * @public
+ */
+export declare const enum PBAudioAnalysisMode {
+    MODE_RAW = 0,
+    MODE_LOGARITHMIC = 1
+}
+
 /**
  * @public
  */
@@ -4481,6 +4582,36 @@ export declare namespace PBAvatarEquippedData {
     export function decode(input: _m0.Reader | Uint8Array, length?: number): PBAvatarEquippedData;
 }
 
+/**
+ * The PBAvatarLocomotionSettings component allows scenes to modify locomotion settings defining things such
+ * as the avatar movement speed, jump height etc.
+ */
+/**
+ * @public
+ */
+export declare 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 {
+    export function encode(message: PBAvatarLocomotionSettings, writer?: _m0.Writer): _m0.Writer;
+    export function decode(input: _m0.Reader | Uint8Array, length?: number): PBAvatarLocomotionSettings;
+}
+
 /**
  * The AvatarModifierArea component can be attached to an Entity to define a region of space where
  * avatar behavior changes.
@@ -5285,6 +5416,29 @@ export declare namespace PBPlayerIdentityData {
  *
  * It also supports simple visual feedback when interactions occur, by showing floating text.
  * More sophisticated feedback requires the use of other components.
+ *
+ * Distance rules
+ * --------------
+ * PointerEvents can enforce interaction range using two independent distance checks:
+ *
+ * - Camera distance (`max_distance`): distance from the active camera to the target entity.
+ * - Player distance (`max_player_distance`): distance from the avatar/player position to the target entity.
+ *
+ * How the interaction checks are combined:
+ *
+ * 1) Only `max_distance` is present
+ *    - The interaction is allowed only if the camera distance is <= `max_distance`.
+ *
+ * 2) Only `max_player_distance` is present
+ *    - The interaction is allowed only if the player distance is <= `max_player_distance`.
+ *
+ * 3) Both `max_distance` and `max_player_distance` are present
+ *    - The interaction is allowed if ANY of the checks passes (OR logic):
+ *      (camera distance <= `max_distance`) OR (player distance <= `max_player_distance`).
+ *
+ * 4) Neither `max_distance` nor `max_player_distance` is present
+ *    - The system behaves as if `max_distance` were set to its default value (10),
+ *      i.e., it uses the camera distance check with a threshold of 10.
  */
 /**
  * @public
@@ -5334,6 +5488,8 @@ export declare interface PBPointerEvents_Info {
     showFeedback?: boolean | undefined;
     /** enable or disable hover highlight (default true) */
     showHighlight?: boolean | undefined;
+    /** range of interaction from the avatar's position (default 0) */
+    maxPlayerDistance?: number | undefined;
 }
 
 /**
@@ -6207,6 +6363,7 @@ export declare namespace PBVideoPlayer {
  * 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
@@ -6214,6 +6371,8 @@ export declare namespace PBVideoPlayer {
 export declare interface PBVirtualCamera {
     defaultTransition?: CameraTransition | undefined;
     lookAtEntity?: number | undefined;
+    /** default: 60 */
+    fov?: number | undefined;
 }
 
 /**