angry-pixel 2.3.1 → 2.3.3

package/lib/index.d.ts

@@ -2442,6 +2442,12 @@ interface AudioPlayerOptions {
     fixedToTimeScale: boolean;
     /** TRUE If the audio source should loop. */
     loop: boolean;
+    /** Time mark (seconds) where looping starts. Only has effect when `loop` is TRUE and `loopEnd` is greater than zero. */
+    loopStart: number;
+    /** Time mark (seconds) where looping ends. When `loop` is TRUE and this is greater than zero, the audio loops between `loopStart` and `loopEnd`. */
+    loopEnd: number;
+    /** Time mark (seconds) where playback starts from when playing from a stopped state. Default is 0. */
+    startAt: number;
     /** The volume of the audio source. */
     volume: number;
 }
@@ -2471,10 +2477,18 @@ declare class AudioPlayer {
     fixedToTimeScale: boolean;
     /** TRUE If the audio source should loop. */
     loop: boolean;
+    /** Time mark (seconds) where looping starts. Only has effect when `loop` is TRUE and `loopEnd` is greater than zero. */
+    loopStart: number;
+    /** Time mark (seconds) where looping ends. When `loop` is TRUE and this is greater than zero, the audio loops between `loopStart` and `loopEnd`. */
+    loopEnd: number;
+    /** Time mark (seconds) where playback starts from when playing from a stopped state. Default is 0. */
+    startAt: number;
     /** READONLY, The current state of the audio source. */
     state: "stopped" | "playing" | "paused";
     /** The volume of the audio source. */
     volume: number;
+    /** READONLY, The current playback time mark of the audio source, expressed in seconds. */
+    get currentTime(): number;
     /** READONLY, TRUE If the audio source is playing. */
     get playing(): boolean;
     /** READONLY, TRUE If the audio source is paused. */
@@ -2491,6 +2505,8 @@ declare class AudioPlayer {
     _startedAt: number;
     /** @internal Offset (seconds) within the buffer at which the next play should resume from (used on pause) */
     _pauseOffset: number;
+    /** @internal Current playback time mark (seconds), updated each frame by the AudioPlayerSystem */
+    _currentTime: number;
     /** @internal */
     _playAfterUserInput: boolean;
     /** @internal */
@@ -3154,6 +3170,13 @@ interface RigidBodyOptions {
      * @public
      */
     acceleration: Vector2;
+    /**
+     * Collision layers for which this body behaves as static. When a Dynamic body whose collider layer
+     * is listed here collides with this body, only the other body is repositioned, as if this one were static.
+     * This body still behaves as its own type (e.g. Dynamic) for every other collision.
+     * @public
+     */
+    staticForLayers: string[];
 }
 /**
  * The RigidBody component enables physics simulation for an entity, allowing it to interact with other physics-enabled objects in the game world.\
@@ -3219,6 +3242,13 @@ declare class RigidBody {
      * @public
      */
     acceleration: Vector2;
+    /**
+     * Collision layers for which this body behaves as static. When a Dynamic body whose collider layer
+     * is listed here collides with this body, only the other body is repositioned, as if this one were static.
+     * This body still behaves as its own type (e.g. Dynamic) for every other collision.
+     * @public
+     */
+    staticForLayers: string[];
     /** @internal */
     static componentName: string;
     constructor(options?: Partial<RigidBodyOptions>);
@@ -3460,6 +3490,7 @@ interface TilemapRenderData extends RenderData {
     tiles: number[];
     tilemap: Tilemap;
     tileset: Tileset$1;
+    tileAnimations?: Map<number, number>;
     smooth?: boolean;
     flipHorizontal?: boolean;
     flipVertical?: boolean;
@@ -4307,6 +4338,7 @@ interface TilemapRendererOptions {
     maskColorMix: number;
     opacity: number;
     smooth: boolean;
+    animations: Map<number, TileAnimation>;
 }
 /**
  * The TilemapRenderer component renders 2D tile-based maps to the screen.\
@@ -4369,14 +4401,62 @@ declare class TilemapRenderer {
     maskColorMix: number;
     /** TRUE for smooth pixels (not recommended for pixel art) */
     smooth: boolean;
+    /** Animated tiles, keyed by the tile id to animate. */
+    animations: Map<number, TileAnimation>;
     /** @internal */
     _processed: boolean;
     /** @internal */
     _renderData: TilemapRenderData[];
+    /** Maps each animated tile id to the tile id currently displayed. @internal */
+    _tileAnimationState: Map<number, number>;
     /** @internal */
     static componentName: string;
     constructor(options?: Partial<TilemapRendererOptions>);
 }
+/**
+ * TileAnimation configuration
+ * @public
+ * @category Components Configuration
+ * @example
+ * ```js
+ * const waterAnimation = new TileAnimation({
+ *   tiles: [5, 6, 7, 8],
+ *   fps: 6
+ * });
+ * ```
+ */
+interface TileAnimationOptions {
+    tiles: number[];
+    fps?: number;
+}
+/**
+ * TileAnimation cycles a tile through a sequence of tile ids from the tileset.\
+ * It is assigned to a {@link TilemapRenderer} keyed by the tile id that should animate.
+ * @public
+ * @category Components Configuration
+ * @example
+ * ```js
+ * const tilemapRenderer = new TilemapRenderer({
+ *   tileset: { image: "tileset.png", width: 10, tileWidth: 32, tileHeight: 32 },
+ *   data: [1, 2, 3, 4],
+ *   width: 2,
+ *   animations: new Map([
+ *     [3, new TileAnimation({ tiles: [3, 4, 5], fps: 6 })]
+ *   ])
+ * });
+ * ```
+ */
+declare class TileAnimation {
+    /** The sequence of tile ids to cycle through. */
+    tiles: number[];
+    /** The animation speed in frames per second. */
+    fps: number;
+    /** The current frame of the animation. */
+    currentFrame: number;
+    /** The current time of the animation. */
+    currentTime: number;
+    constructor(options?: TileAnimationOptions);
+}
 /**
  * The Tileset configuration defines the properties of a tileset used by the TilemapRenderer.\
  * It specifies the source image containing the tiles, the dimensions of the tileset and individual tiles,\
@@ -5115,4 +5195,4 @@ declare const SYMBOLS: {
     TimeManager: symbol;
 };
 
-export { Animation, type AnimationOptions, type AnimationSlice, Animator, type AnimatorOptions, type Archetype, AssetManager, AudioPlayer, type AudioPlayerOptions, type AudioSource, BallCollider, type BallColliderOptions, BoxCollider, type BoxColliderOptions, BroadPhaseMethods, Button, type ButtonOptions, ButtonShape, Camera, type CameraOptions, type Chunk, Circumference, type Collider, type Collision, type CollisionMatrix, CollisionMethods, CollisionRepository, type CollisionResolution, type Component, type ComponentType, DarknessRenderer, type DarknessRendererOptions, type DependencyName, type DependencyType, EdgeCollider, type EdgeColliderOptions, type Entity, EntityManager, Game, type GameConfig, GameSystem, GamepadController, GeometricRenderer, type GeometricRendererOptions, GeometricShape, InputManager, type IntervalOptions, Keyboard, LightRenderer, type LightRendererOptions, MaskRenderer, type MaskRendererOptions, MaskShape, Mouse, type PlaySfxOptions, Polygon, PolygonCollider, type PolygonColliderOptions, type PropertyKey, Rectangle, RigidBody, type RigidBodyOptions, RigidBodyType, SYMBOLS, Scene, SceneManager, type SceneType, type SearchResult, type Shape, type Slice, SpriteRenderer, type SpriteRendererOptions, type System, type SystemGroup, SystemManager, type SystemType, TextAlignment, TextRenderer, type TextRendererOptions, type TiledChunk, type TiledLayer, type TiledObject, type TiledObjectLayer, type TiledProperty, type TiledTilemap, TiledWrapper, type TiledWrapperOptions, TilemapCollider, type TilemapColliderOptions, TilemapOrientation, TilemapRenderer, type TilemapRendererOptions, type Tileset, TimeManager, type TouchInteraction, TouchScreen, Transform, type TransformOptions, Vector2, type VibrationInput, VideoRenderer, type VideoRendererOptions, between, clamp, debugRenderLayer, decorate, defaultRenderLayer, defaultTextureAtlasOptions, degreesToRadians, fixedRound, gameLogicSystem, gamePhysicsSystem, gamePreRenderSystem, inject, injectable, playSfx, radiansToDegrees, randomFloat, randomInt, range, rgbToHex, stopSfx };
+export { Animation, type AnimationOptions, type AnimationSlice, Animator, type AnimatorOptions, type Archetype, AssetManager, AudioPlayer, type AudioPlayerOptions, type AudioSource, BallCollider, type BallColliderOptions, BoxCollider, type BoxColliderOptions, BroadPhaseMethods, Button, type ButtonOptions, ButtonShape, Camera, type CameraOptions, type Chunk, Circumference, type Collider, type Collision, type CollisionMatrix, CollisionMethods, CollisionRepository, type CollisionResolution, type Component, type ComponentType, DarknessRenderer, type DarknessRendererOptions, type DependencyName, type DependencyType, EdgeCollider, type EdgeColliderOptions, type Entity, EntityManager, Game, type GameConfig, GameSystem, GamepadController, GeometricRenderer, type GeometricRendererOptions, GeometricShape, InputManager, type IntervalOptions, Keyboard, LightRenderer, type LightRendererOptions, MaskRenderer, type MaskRendererOptions, MaskShape, Mouse, type PlaySfxOptions, Polygon, PolygonCollider, type PolygonColliderOptions, type PropertyKey, Rectangle, RigidBody, type RigidBodyOptions, RigidBodyType, SYMBOLS, Scene, SceneManager, type SceneType, type SearchResult, type Shape, type Slice, SpriteRenderer, type SpriteRendererOptions, type System, type SystemGroup, SystemManager, type SystemType, TextAlignment, TextRenderer, type TextRendererOptions, TileAnimation, type TileAnimationOptions, type TiledChunk, type TiledLayer, type TiledObject, type TiledObjectLayer, type TiledProperty, type TiledTilemap, TiledWrapper, type TiledWrapperOptions, TilemapCollider, type TilemapColliderOptions, TilemapOrientation, TilemapRenderer, type TilemapRendererOptions, type Tileset, TimeManager, type TouchInteraction, TouchScreen, Transform, type TransformOptions, Vector2, type VibrationInput, VideoRenderer, type VideoRendererOptions, between, clamp, debugRenderLayer, decorate, defaultRenderLayer, defaultTextureAtlasOptions, degreesToRadians, fixedRound, gameLogicSystem, gamePhysicsSystem, gamePreRenderSystem, inject, injectable, playSfx, radiansToDegrees, randomFloat, randomInt, range, rgbToHex, stopSfx };