vite

Author: Nightre

dist/assets.d.ts

@@ -1,7 +1,7 @@
-import { AudioPlayer } from "./audio";
-import { Game } from "./game";
-import { IAsset as IAsset, IAssets } from "./interface";
-import EventEmitter from "eventemitter3";
+import { AudioPlayer } from './audio';
+import { Game } from './game';
+import { IAsset as IAsset, IAssets } from './interface';
+import { default as EventEmitter } from 'eventemitter3';
 /**
  * Events emitted by AssetsLoader.
  */

dist/audio.d.ts

@@ -1,4 +1,4 @@
-import EventEmitter from "eventemitter3";
+import { default as EventEmitter } from 'eventemitter3';
 /**
  * Events emitted by AudioPlayer.
  */

dist/depth.d.ts

@@ -1,12 +1,11 @@
-import AssetsLoader from "./assets";
-import AudioManager from "./audio";
-import { InputManager } from "./input";
-import { IEntityTilemapLayerOptions, IEntityTransformOptions, IGameOptions, IMathObject, ISpriteRenderOptions, TilemapShape, YSortCallback } from "./interface";
-import { MatrixStack, Vec2 } from "./math";
-import Rapid from "./render";
-import { TextureCache } from "./texture";
-import { TileSet } from "./tilemap";
-import { EasingFunction, Timer, Tween } from "./utils";
+import { default as AssetsLoader } from './assets';
+import { default as AudioManager } from './audio';
+import { InputManager } from './input';
+import { ICameraOptions, IEntityTransformOptions, IGameOptions, IMathObject } from './interface';
+import { MatrixStack, Vec2 } from './math';
+import { default as Rapid } from './render';
+import { TextureCache } from './texture';
+import { EasingFunction, Timer, Tween } from './utils';
 /**
  * Base class for game entities with transform and rendering capabilities.
  */
@@ -32,6 +31,7 @@ export declare class Entity {
      * @param options - Configuration options for position, scale, rotation, and tags.
      */
     constructor(game: Game, options?: IEntityTransformOptions);
+    getRoot(): Scene | null;
     /**
      * Gets the parent transform or the renderer's matrix stack if no parent exists.
      * @returns The transform matrix stack.
@@ -57,7 +57,7 @@ export declare class Entity {
      * Prepares the entity's transform before rendering.
      * @ignore
      */
-    beforOnRender(): void;
+    beforeOnRender(): void;
     /**
      * Hook for custom rendering logic.
      * @param render - The rendering engine instance.
@@ -102,88 +102,42 @@ export declare class Entity {
     protected postDispose(): void;
 }
 /**
- * Camera entity for managing the view transform in the game.
+ * A layer that renders its children directly to the screen, ignoring any camera transforms.
+ * Ideal for UI elements like HUDs, menus, and scores.
+ *
+ * CanvasLayer 是一个特殊的层，它会直接将其子节点渲染到屏幕上，忽略任何摄像机的变换。
+ * 非常适合用于UI元素，如HUD（状态栏）、菜单和分数显示。
  */
-export declare class Camera extends Entity {
-    /**
-     * Updates the camera's transform to center the view and apply transformations.
-     */
+export declare class CanvasLayer extends Entity {
+    constructor(game: Game);
     updateTransform(): void;
 }
 /**
- * Tilemap entity for rendering tiled maps.
+ * Camera entity for managing the view transform in the game.
  */
-export declare class Tilemap extends Entity {
-    static readonly DEFAULT_ERROR = 0;
-    static readonly EMPTY_TILE = -1;
-    error: Vec2;
-    shape: TilemapShape;
-    tileSet: TileSet;
-    data: (number | string)[][];
-    eachTile?: (tileId: string | number, mapX: number, mapY: number) => ISpriteRenderOptions | undefined | void;
-    ySortCallback: YSortCallback[];
-    /**
-     * Creates a tilemap entity.
-     * @param game - The game instance this tilemap belongs to.
-     * @param options - Configuration options for the tilemap.
-     */
-    constructor(game: Game, options: IEntityTilemapLayerOptions);
-    /**
-     * Collects renderable entities, excluding children unless they override onRender.
-     * @param queue - The array to collect renderable entities.
-     */
-    collectRenderables(queue: Entity[]): void;
-    /**
-     * Sets a tile at the specified map coordinates.
-     * @param x - The X coordinate (column) on the map.
-     * @param y - The Y coordinate (row) on the map.
-     * @param tileId - The tile ID to set (number or string).
-     * @returns True if the tile was set successfully, false if coordinates are out of bounds.
-     */
-    setTile(x: number, y: number, tileId: number | string): boolean;
-    /**
-     * Gets the tile ID at the specified map coordinates.
-     * @param x - The X coordinate (column) on the map.
-     * @param y - The Y coordinate (row) on the map.
-     * @returns The tile ID (number or string) or undefined if coordinates are out of bounds.
-     */
-    getTile(x: number, y: number): number | string | undefined;
-    /**
-     * Removes a tile at the specified map coordinates (sets it to EMPTY_TILE).
-     * @param x - The X coordinate (column) on the map.
-     * @param y - The Y coordinate (row) on the map.
-     * @returns True if the tile was removed successfully, false if coordinates are out of bounds.
-     */
-    removeTile(x: number, y: number): boolean;
-    /**
-     * Fills a rectangular area with a specified tile ID.
-     * @param tileId - The tile ID to use for filling.
-     * @param startX - The starting X coordinate.
-     * @param startY - The starting Y coordinate.
-     * @param width - The width of the fill area.
-     * @param height - The height of the fill area.
-     */
-    fill(tileId: number | string, startX: number, startY: number, width: number, height: number): void;
-    /**
-     * Replaces the entire tilemap data and updates dimensions.
-     * @param newData - The new 2D array of tile data.
-     */
-    setData(newData: (number | string)[][]): void;
+export declare class Camera extends Entity {
+    enable: boolean;
+    center: boolean;
+    positionSmoothingSpeed: number;
+    rotationSmoothingSpeed: number;
+    private _currentRenderPosition;
+    private _currentRenderRotation;
     /**
-     * Converts local coordinates to map coordinates.
-     * @param local - The local coordinates to convert.
+     * 设置此摄像机是否为当前场景的主摄像机。
+     * @param isEnable
      */
-    localToMap(local: Vec2): void;
+    setEnable(isEnable: boolean): void;
+    constructor(game: Game, options?: ICameraOptions);
     /**
-     * Converts map coordinates to local coordinates.
-     * @param local - The map coordinates to convert.
+     * 每帧更新，用于平滑摄像机的【局部】变换属性。
+     * @param deltaTime
      */
-    mapToLocal(local: Vec2): void;
+    onUpdate(deltaTime: number): void;
     /**
-     * Renders the tilemap layer.
-     * @param render - The rendering engine instance.
+     * 根据摄像机的【全局】变换计算最终的视图矩阵。
+     * 这个方法现在正确地处理了父子关系。
      */
-    onRender(render: Rapid): void;
+    updateTransform(): void;
 }
 /**
  * Scene class representing a game scene with entities.
@@ -208,12 +162,15 @@ export declare class Game {
     private lastTime;
     private tweens;
     private timers;
+    mainCamera: Camera | null;
     renderQueue: Entity[];
     /**
      * Creates a new game instance.
      * @param options - Configuration options for the game.
      */
     constructor(options: IGameOptions);
+    getMainScene(): Scene | null;
+    setMainCamera(camera: Camera | null): void;
     /**
      * Switches to a new scene, disposing of the current one.
      * @param newScene - The new scene to switch to.

dist/game.d.ts

@@ -1,16 +1,16 @@
-import Rapid from "./render";
-import GLShader from "./webgl/glshader";
-import { Text } from "./texture";
-import { TileMapRender, TileSet } from "./tilemap";
-import { Uniform } from "./webgl/uniform";
-import { spriteAttributes, graphicAttributes } from "./regions/attributes";
-import { ParticleEmitter } from "./particle";
+import { default as Rapid } from './render';
+import { default as GLShader } from './webgl/glshader';
+import { Text } from './texture';
+import { TileMapRender, TileSet } from './tilemap';
+import { Uniform } from './webgl/uniform';
+import { spriteAttributes, graphicAttributes } from './regions/attributes';
+import { ParticleEmitter } from './particle';
 export { Text, Rapid, GLShader, TileMapRender, TileSet, Uniform, ParticleEmitter, graphicAttributes, spriteAttributes, };
-export * from "./math";
-export * from "./interface";
-export * from "./texture";
-export * from "./render";
-export * from "./particle";
-export * from "./game";
-export * from "./input";
-export * from "./assets";
+export * from './math';
+export * from './interface';
+export * from './texture';
+export * from './render';
+export * from './particle';
+export * from './game';
+export * from './input';
+export * from './assets';

dist/index.d.ts

@@ -1,6 +1,6 @@
-import { Vec2 } from "./math";
-import Rapid from "./render";
-import { Entity } from "./game";
+import { Vec2 } from './math';
+import { default as Rapid } from './render';
+import { Entity } from './game';
 /**
  * Manages user input for keyboard and mouse events.
  * Tracks key and button states, including pressed/released states for the current and previous frames.

dist/input.d.ts

@@ -1,10 +1,10 @@
-import { AudioPlayer } from "./audio";
-import { Entity } from "./game";
-import { Color, Vec2 } from "./math";
-import { Texture } from "./texture";
-import { TileSet } from "./tilemap";
-import GLShader from "./webgl/glshader";
-import { Uniform } from "./webgl/uniform";
+import { AudioPlayer } from './audio';
+import { Entity } from './game';
+import { Color, Vec2 } from './math';
+import { Texture } from './texture';
+import { TileSet } from './tilemap';
+import { default as GLShader } from './webgl/glshader';
+import { Uniform } from './webgl/uniform';
 /**
  * @ignore
  */
@@ -182,6 +182,7 @@ export interface YSortCallback {
     renderSprite?: ISpriteRenderOptions;
 }
 export interface IEntityTilemapLayerOptions extends ITilemapLayerOptions, IEntityTransformOptions {
+    enableYsort: boolean;
 }
 export interface ITilemapLayerOptions {
     error?: number | Vec2;
@@ -226,6 +227,9 @@ export interface ILightRenderOptions {
 }
 export interface ICameraOptions extends ITransformOptions {
     center?: boolean;
+    enable?: boolean;
+    positionSmoothingSpeed?: number;
+    rotationSmoothingSpeed?: number;
 }
 /**
  * Defines particle emitter shape types
@@ -362,6 +366,8 @@ export type ParticleAttributeData<T extends ParticleAttributeTypes> = {
      */
     damping?: number;
 };
+export interface IParticleEmitterOptions extends IParticleOptions, IEntityTransformOptions {
+}
 export interface IGameOptions extends IRapidOptions {
 }
 export interface ISound {

dist/interface.d.ts

@@ -1,5 +1,5 @@
-import { Vec2 } from "./math";
-import Rapid from "./render";
+import { Vec2 } from './math';
+import { default as Rapid } from './render';
 export declare class LightManager {
     render: Rapid;
     constructor(render: Rapid);

dist/light.d.ts

@@ -1,5 +1,5 @@
-import { ILineStyleOptions } from "./interface";
-import { Vec2 } from "./math";
+import { ILineStyleOptions } from './interface';
+import { Vec2 } from './math';
 /**
  * @ignore
  */

dist/line.d.ts

@@ -1,4 +1,4 @@
-import { IMathObject, ITransformOptions, WebGLContext } from "./interface";
+import { IMathObject, ITransformOptions, WebGLContext } from './interface';
 /**
  * @ignore
  */
@@ -455,6 +455,7 @@ export declare class Vec2 implements IMathObject<Vec2> {
      * @returns The angle between the two vectors in radians.
      */
     angleBetween(v: Vec2): number;
+    lerp(target: Vec2, factor: number): Vec2;
 }
 /**
  * Provides utility methods for mathematical conversions.