angry-pixel 2.0.17 → 2.0.19

package/lib/index.d.ts

@@ -55,7 +55,7 @@ declare function injectable(name: DependencyName): (target: DependencyType) => v
  * }
  * ```
  */
-declare function inject(name: DependencyName): (target: any, propertyKey: PropertyKey, parameterIndex?: number) => void;
+declare function inject(name: DependencyName): (target: any, propertyKey?: PropertyKey, parameterIndex?: number) => void;
 
 /**
  * Represents a 2D vector and provides static methods for vector calculations.
@@ -245,8 +245,57 @@ declare class Vector2 {
      * v2.x // 4
      * v2.y // 2
      * ```
+     * @example
+     * ```js
+     * const v1 = new Vector2(3.9, 2.2);
+     * Vector2.round(v1, v1);
+     * v1.x // 4
+     * v1.y // 2
+     * ```
      */
     static round(out: Vector2, a: Vector2): Vector2;
+    /**
+     * Floors a vector
+     *
+     * @param a The vector to floor
+     * @returns The output vector
+     * @example
+     * ```js
+     * const v1 = new Vector2(3.9, 2.2);
+     * const v2 = Vector2.floor(new Vector2(), v1);
+     * v2.x // 3
+     * v2.y // 2
+     * ```
+     * @example
+     * ```js
+     * const v1 = new Vector2(3.9, 2.2);
+     * Vector2.floor(v1, v1);
+     * v1.x // 3
+     * v1.y // 2
+     * ```
+     */
+    static floor(out: Vector2, a: Vector2): Vector2;
+    /**
+     * Ceils a vector
+     *
+     * @param a The vector to ceil
+     * @returns The output vector
+     * @example
+     * ```js
+     * const v1 = new Vector2(3.9, 2.2);
+     * const v2 = Vector2.ceil(new Vector2(), v1);
+     * v2.x // 4
+     * v2.y // 3
+     * ```
+     * @example
+     * ```js
+     * const v1 = new Vector2(3.9, 2.2);
+     * Vector2.ceil(v1, v1);
+     * v1.x // 4
+     * v1.y // 3
+     * ```
+     */
+    static ceil(out: Vector2, a: Vector2): Vector2;
     toString(): string;
 }
 
@@ -372,6 +421,20 @@ declare const range: (start: number, end: number, steps?: number) => number[];
  * @returns true if the number is between the min and the max, false instead
  */
 declare const between: (value: number, min: number, max: number) => boolean;
+/**
+ * Converts the given radians to degrees.
+ * @param radians
+ * @returns degrees
+ */
+declare const radiansToDegrees: (radians: number) => number;
+/**
+ * Converts the given degrees to radians.
+ * @param degrees
+ * @returns radians
+ * @category Math
+ * @public
+ */
+declare const degreesToRadians: (degrees: number) => number;
 
 /** @internal */
 interface Shape {
@@ -1117,7 +1180,11 @@ interface GameConfig {
     height: number;
     /** Enables the debug mode */
     debugEnabled?: boolean;
-    /** Background color of canvas */
+    /** Color of debug elements, default "#00FF00" (green) */
+    debugColor?: string;
+    /** Position of debug text, default "bottom-left" */
+    debugTextPosition?: "top-left" | "top-right" | "bottom-left" | "bottom-right";
+    /** Background color of canvas, default "#000000" (black) */
     canvasColor?: string;
     /** Framerate for physics execution. The allowed values are 60, 120, 180, 240.
      * The higher the framerate, the more accurate the physics will be, but it will consume more processor resources.
@@ -1178,15 +1245,17 @@ declare class AssetManager {
     /**
      * Loads an image asset
      * @param url The asset URL
+     * @param name The asset name [optional]
      * @returns The HTML Image element created
      */
-    loadImage(url: string): HTMLImageElement;
+    loadImage(url: string, name?: string): HTMLImageElement;
     /**
      * Loads an audio asset
      * @param url The asset URL
+     * @param name The asset name [optional]
      * @returns The HTML Audio element created
      */
-    loadAudio(url: string): HTMLAudioElement;
+    loadAudio(url: string, name?: string): HTMLAudioElement;
     /**
      * Loads a font asset
      * @param family The font family name
@@ -1197,21 +1266,34 @@ declare class AssetManager {
     /**
      * Loads an video asset
      * @param url The asset URL
+     * @param name The asset name [optional]
      * @returns The HTML Video element created
      */
-    loadVideo(url: string): HTMLVideoElement;
+    loadVideo(url: string, name?: string): HTMLVideoElement;
     /**
      * Retrieves an image asset
      * @param url The asset URL
      * @returns The HTML Image element
      */
     getImage(url: string): HTMLImageElement;
+    /**
+     * Retrieves an image asset
+     * @param name The asset name
+     * @returns The HTML Image element
+     */
+    getImage(name: string): HTMLImageElement;
     /**
      * Retrieves an audio asset
      * @param url The asset URL
      * @returns The HTML Audio element
      */
     getAudio(url: string): HTMLAudioElement;
+    /**
+     * Retrieves an audio asset
+     * @param name The asset name
+     * @returns The HTML Audio element
+     */
+    getAudio(name: string): HTMLAudioElement;
     /**
      * Retrieves a font asset
      * @param family The font family name
@@ -1224,6 +1306,12 @@ declare class AssetManager {
      * @returns The HTML Video element
      */
     getVideo(url: string): HTMLVideoElement;
+    /**
+     * Retrieves a video asset
+     * @param name The asset name
+     * @returns The HTML Video element
+     */
+    getVideo(name: string): HTMLVideoElement;
     private createAsset;
 }
 
@@ -2485,6 +2573,11 @@ interface VideoRenderData extends RenderData {
  * @category Components
  */
 declare const defaultRenderLayer = "Default";
+/**
+ * Debug render layer
+ * @internal
+ */
+declare const debugRenderLayer = "Debug";
 /**
  * @public
  * @category Components
@@ -2493,6 +2586,7 @@ interface CameraOptions {
     layers: string[];
     zoom: number;
     depth: number;
+    debug: boolean;
 }
 /**
  * @public
@@ -2505,6 +2599,8 @@ declare class Camera {
     zoom: number;
     /** In case you have more than one camera, the depth value determines which camera is rendered first. The lesser value, the first to render */
     depth: number;
+    /** Set to TRUE to allow this camera to render debug data (default FALSE) */
+    debug: boolean;
     /** @internal */
     _renderData: CameraData;
     constructor(options?: Partial<CameraOptions>);
@@ -2730,6 +2826,14 @@ declare class SpriteRenderer {
     constructor(options?: Partial<SpriteRendererOptions>);
 }
 
+/**
+ * @internal
+ */
+declare const defaultTextureAtlasOptions: {
+    charRanges: number[];
+    fontSize: number;
+    spacing: number;
+};
 /**
  * @public
  * @category Components
@@ -3481,6 +3585,36 @@ declare function gamePhysicsSystem(): (target: SystemType) => void;
  */
 declare function gamePreRenderSystem(): (target: SystemType) => void;
 
+/**
+ * Applies a decorator manually.
+ * @param decorator The decorator function to be applied.
+ * @param target The target to which the decorator is applied (class, prototype, or constructor argument).
+ * @param propertyKey The property name or constructor argument index (optional).
+ * @public
+ * @category Decorators
+ * @example
+ * ```javascript
+ * decorate(injectable("SomeDependency"), SomeDependency);
+ * ```
+ * @example
+ * ```javascript
+ * decorate(inject("AnotherDependency"), SomeClass, "anotherDependency");
+ * ```
+ * @example
+ * ```javascript
+ *  decorate(inject("AnotherDependency"), SomeClass, 0);
+ * ```
+ * @example
+ * ```javascript
+ * decorate(gamePhysicsSystem(), SomeSystem);
+ * ```
+ * @example
+ * ```javascript
+ * decorate(gamePreRenderSystem(), SomeSystem);
+ * ```
+ */
+declare function decorate(decorator: (...args: any[]) => any, target: any, propertyKey?: string | symbol | number): void;
+
 /**
  * Symbols to be used as dependency identifiers
  * @public
@@ -3498,4 +3632,4 @@ declare const Symbols: {
     TimeManager: symbol;
 };
 
-export { Animation, type AnimationSlice, Animator, type AnimatorOptions, AssetManager, AudioPlayer, type AudioPlayerAction, type AudioPlayerOptions, BallCollider, type BallColliderOptions, BoxCollider, type BoxColliderOptions, BroadPhaseMethods, Button, type ButtonOptions, ButtonShape, Camera, type CameraOptions, Children, type Chunk, Circumference, type Collider, type Collision, type CollisionMatrix, CollisionMethods, CollisionRepository, type CollisionResolution, type Component, type ComponentType, type DependencyName, type DependencyType, EdgeCollider, type EdgeColliderOptions, type Entity, EntityManager, Game, type GameConfig, GameSystem, GamepadController, InputManager, type IntervalOptions, Keyboard, LightRenderer, type LightRendererOptions, MaskRenderer, type MaskRendererOptions, MaskShape, Mouse, Parent, Polygon, PolygonCollider, type PolygonColliderOptions, Rectangle, RigidBody, type RigidBodyOptions, RigidBodyType, Scene, SceneManager, type SceneType, type SearchCriteria, type SearchResult, ShadowRenderer, type ShadowRendererOptions, type Shape, type Slice, SpriteRenderer, type SpriteRendererOptions, Symbols, type System, type SystemGroup, SystemManager, type SystemType, TextOrientation, 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, defaultRenderLayer, fixedRound, gameLogicSystem, gamePhysicsSystem, gamePreRenderSystem, inject, injectable, randomFloat, randomInt, range };
+export { Animation, type AnimationSlice, Animator, type AnimatorOptions, AssetManager, AudioPlayer, type AudioPlayerAction, type AudioPlayerOptions, BallCollider, type BallColliderOptions, BoxCollider, type BoxColliderOptions, BroadPhaseMethods, Button, type ButtonOptions, ButtonShape, Camera, type CameraOptions, Children, type Chunk, Circumference, type Collider, type Collision, type CollisionMatrix, CollisionMethods, CollisionRepository, type CollisionResolution, type Component, type ComponentType, type DependencyName, type DependencyType, EdgeCollider, type EdgeColliderOptions, type Entity, EntityManager, Game, type GameConfig, GameSystem, GamepadController, InputManager, type IntervalOptions, Keyboard, LightRenderer, type LightRendererOptions, MaskRenderer, type MaskRendererOptions, MaskShape, Mouse, Parent, Polygon, PolygonCollider, type PolygonColliderOptions, Rectangle, RigidBody, type RigidBodyOptions, RigidBodyType, Scene, SceneManager, type SceneType, type SearchCriteria, type SearchResult, ShadowRenderer, type ShadowRendererOptions, type Shape, type Slice, SpriteRenderer, type SpriteRendererOptions, Symbols, type System, type SystemGroup, SystemManager, type SystemType, TextOrientation, 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, radiansToDegrees, randomFloat, randomInt, range };