@duyquangnvx/pixi-game-engine 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -285,7 +285,7 @@ interface ModalButtonConfig {
 /**
  * Base modal class providing backdrop, close button, animations, and dragging.
  * Extend this class and build your content in onShow or constructor.
- * Uses Game.instance singleton for screen dimensions - no need to pass them.
+ * Uses Engine static class for screen dimensions - no need to pass them.
  */
 declare class BaseModal<TData = void> extends PIXI.Container {
     protected backdrop: PIXI.Graphics;
@@ -303,9 +303,9 @@ declare class BaseModal<TData = void> extends PIXI.Container {
     readonly didHide: Signal<void>;
     /** Signal emitted when modal is shown (with data) */
     readonly didShow: Signal<TData>;
-    /** Get screen width from Game singleton */
+    /** Get screen width from Engine */
     protected get screenWidth(): number;
-    /** Get screen height from Game singleton */
+    /** Get screen height from Engine */
     protected get screenHeight(): number;
     constructor(config?: BaseModalConfig);
     private setup;
@@ -379,8 +379,8 @@ declare class ParticleManager {
 }
 
 declare abstract class Scene extends PIXI.Container {
-    /** Get game instance */
-    protected get game(): Game;
+    /** Get engine class for static access */
+    protected get engine(): typeof Engine;
     /** Called when scene becomes active */
     abstract onEnter(): void | Promise<void>;
     /** Called every frame while scene is active */
@@ -549,9 +549,9 @@ declare class ToastManager {
     private currentColors;
     private currentThemeName;
     private resizeBinding;
-    /** Get screen width from Game singleton */
+    /** Get screen width from Engine */
     private get screenWidth();
-    /** Get screen height from Game singleton */
+    /** Get screen height from Engine */
     private get screenHeight();
     constructor(stage: PIXI.Container, config?: ToastManagerConfig);
     /**
@@ -657,7 +657,7 @@ declare class UIManager {
 }
 
 type ScaleMode = 'none' | 'letterbox' | 'fill';
-interface GameConfig {
+interface EngineConfig {
     width: number;
     height: number;
     backgroundColor?: number;
@@ -669,66 +669,94 @@ interface GameConfig {
     /** Auto-resize on window resize. Default: true */
     autoResize?: boolean;
 }
-declare class Game {
-    private static _instance;
-    /** Get the singleton Game instance. Throws if not initialized. */
-    static get instance(): Game;
-    /** Initialize the Game singleton. Throws if already initialized. */
-    static init(config: GameConfig): Game;
-    readonly app: PIXI.Application;
-    readonly scenes: SceneManager;
-    readonly input: InputManager;
-    readonly assets: AssetManager;
-    readonly sound: SoundManager;
-    readonly particles: ParticleManager;
-    readonly tween: TweenManager;
-    readonly ui: UIManager;
-    readonly spine: SpineManager;
-    readonly toast: ToastManager;
-    readonly alert: AlertManager;
-    readonly modal: ModalManager;
-    /** Logger instance for consistent logging across the game */
-    readonly logger: LoggerClass;
-    /** Signal emitted when game is paused */
-    readonly onPause: Signal<void>;
-    /** Signal emitted when game is resumed */
-    readonly onResume: Signal<void>;
-    /** Signal emitted when game is resized */
-    readonly onResize: Signal<{
+declare class Engine {
+    private constructor();
+    private static _app;
+    private static _scenes;
+    private static _input;
+    private static _assets;
+    private static _sound;
+    private static _particles;
+    private static _tween;
+    private static _ui;
+    private static _spine;
+    private static _toast;
+    private static _alert;
+    private static _modal;
+    /** Signal emitted when engine is paused */
+    static readonly onPause: Signal<void>;
+    /** Signal emitted when engine is resumed */
+    static readonly onResume: Signal<void>;
+    /** Signal emitted when engine is resized */
+    static readonly onResize: Signal<{
         width: number;
         height: number;
         scale: number;
     }>;
-    /** Signal emitted when game is updated */
-    readonly onUpdate: Signal<number>;
+    /** Signal emitted when engine is updated */
+    static readonly onUpdate: Signal<number>;
+    /** Signal emitted at the end of init() after all managers are constructed */
+    static readonly onReady: Signal<void>;
+    /** Signal emitted at the start of destroy() before any teardown */
+    static readonly onDestroy: Signal<void>;
+    /** Signal emitted when browser tab visibility changes (true = visible, false = hidden) */
+    static readonly onVisibilityChange: Signal<boolean>;
+    /** Signal emitted when browser window gains/loses focus (true = focused, false = blurred) */
+    static readonly onFocusChange: Signal<boolean>;
     /** Design resolution width (original config width) */
-    readonly designWidth: number;
+    private static _designWidth;
     /** Design resolution height (original config height) */
-    readonly designHeight: number;
+    private static _designHeight;
     /** Current scale mode */
-    scaleMode: ScaleMode;
+    private static _scaleMode;
     /** Current scale factor */
-    private _scale;
-    private _isRunning;
-    private readonly _resizeHandler;
-    private constructor();
-    private update;
-    get view(): PIXI.ICanvas;
-    get stage(): PIXI.Container;
+    private static _scale;
+    private static _isRunning;
+    private static _resizeHandler;
+    private static _visibilityHandler;
+    private static _focusHandler;
+    private static _blurHandler;
+    private static _initialized;
+    /** Logger instance for consistent logging across the engine */
+    static readonly logger: LoggerClass;
+    static get scenes(): SceneManager;
+    static get input(): InputManager;
+    static get assets(): AssetManager;
+    static get sound(): SoundManager;
+    static get particles(): ParticleManager;
+    static get tween(): TweenManager;
+    static get ui(): UIManager;
+    static get spine(): SpineManager;
+    static get toast(): ToastManager;
+    static get alert(): AlertManager;
+    static get modal(): ModalManager;
+    static get app(): PIXI.Application;
+    static get view(): PIXI.ICanvas;
+    static get stage(): PIXI.Container;
     /** Returns design resolution dimensions (use for positioning game elements) */
-    get screen(): PIXI.Rectangle;
+    static get screen(): PIXI.Rectangle;
     /** Returns actual renderer/viewport dimensions */
-    get viewport(): PIXI.Rectangle;
-    get isRunning(): boolean;
-    pause(): void;
-    resume(): void;
+    static get viewport(): PIXI.Rectangle;
+    static get isRunning(): boolean;
+    /** Design resolution width (original config width) */
+    static get designWidth(): number;
+    /** Design resolution height (original config height) */
+    static get designHeight(): number;
+    /** Current scale mode */
+    static get scaleMode(): ScaleMode;
+    static set scaleMode(value: ScaleMode);
     /** Get current scale factor */
-    get scale(): number;
+    static get scale(): number;
+    /** Initialize the Engine. Throws if already initialized. */
+    static init(config: EngineConfig): void;
+    private static update;
+    static pause(): void;
+    static resume(): void;
     /**
      * Get bounds in stage coordinates that cover the full viewport (including letterbox areas).
      * Use this for fullscreen overlays, backdrops, modals that need to cover the entire screen.
      */
-    getFullscreenBounds(): {
+    static getFullscreenBounds(): {
         x: number;
         y: number;
         width: number;
@@ -737,17 +765,12 @@ declare class Game {
     /**
      * Resize to fit window while maintaining aspect ratio based on scaleMode
      */
-    resizeToWindow(): void;
-    /**
-     * Resize game to fit target dimensions while maintaining aspect ratio
-     */
-    resize(targetWidth: number, targetHeight: number): void;
+    static resizeToWindow(): void;
     /**
-     * Propagate resize to all managers that need viewport dimensions
-     * Note: Toast/BaseModal auto-resize via Game.instance.onResize signal
+     * Resize engine to fit target dimensions while maintaining aspect ratio
      */
-    private propagateResize;
-    destroy(): void;
+    static resize(targetWidth: number, targetHeight: number): void;
+    static destroy(): void;
 }
 
 /**
@@ -977,4 +1000,4 @@ declare class LoggerClass {
 /** Global logger instance */
 declare const Logger: LoggerClass;
 
-export { type AlertButton, type AlertConfig, AlertManager, type AlertType, type AssetBundle, type AssetEntry, AssetManager, type AssetManifest, BaseModal, type BaseModalConfig, COUNT_PRESETS, type CloseButtonPosition, CountAnimator, type CountAnimatorConfig, type CountPreset, Game, type GameConfig, GamepadManager, type ICountRenderer, InputManager, KeyboardManager, type LogLevel, Logger, LoggerClass, type ModalAnimation, type ModalButtonConfig, ModalManager, ParticleManager, PointerManager, type ScaleMode, Scene, SceneManager, Signal, type SignalBinding, SoundManager, SpineManager, TOAST_PRESETS, TextCountRenderer, type ToastColorSet, type ToastConfig, ToastManager, type ToastManagerConfig, type ToastTheme, type ToastThemePreset, type ToastType, TweenManager, UIManager, createTheme, getCountPreset, getDefaultColors, getPreset };
+export { type AlertButton, type AlertConfig, AlertManager, type AlertType, type AssetBundle, type AssetEntry, AssetManager, type AssetManifest, BaseModal, type BaseModalConfig, COUNT_PRESETS, type CloseButtonPosition, CountAnimator, type CountAnimatorConfig, type CountPreset, Engine, type EngineConfig, GamepadManager, type ICountRenderer, InputManager, KeyboardManager, type LogLevel, Logger, LoggerClass, type ModalAnimation, type ModalButtonConfig, ModalManager, ParticleManager, PointerManager, type ScaleMode, Scene, SceneManager, Signal, type SignalBinding, SoundManager, SpineManager, TOAST_PRESETS, TextCountRenderer, type ToastColorSet, type ToastConfig, ToastManager, type ToastManagerConfig, type ToastTheme, type ToastThemePreset, type ToastType, TweenManager, UIManager, createTheme, getCountPreset, getDefaultColors, getPreset };

package/dist/index.d.ts

@@ -285,7 +285,7 @@ interface ModalButtonConfig {
 /**
  * Base modal class providing backdrop, close button, animations, and dragging.
  * Extend this class and build your content in onShow or constructor.
- * Uses Game.instance singleton for screen dimensions - no need to pass them.
+ * Uses Engine static class for screen dimensions - no need to pass them.
  */
 declare class BaseModal<TData = void> extends PIXI.Container {
     protected backdrop: PIXI.Graphics;
@@ -303,9 +303,9 @@ declare class BaseModal<TData = void> extends PIXI.Container {
     readonly didHide: Signal<void>;
     /** Signal emitted when modal is shown (with data) */
     readonly didShow: Signal<TData>;
-    /** Get screen width from Game singleton */
+    /** Get screen width from Engine */
     protected get screenWidth(): number;
-    /** Get screen height from Game singleton */
+    /** Get screen height from Engine */
     protected get screenHeight(): number;
     constructor(config?: BaseModalConfig);
     private setup;
@@ -379,8 +379,8 @@ declare class ParticleManager {
 }
 
 declare abstract class Scene extends PIXI.Container {
-    /** Get game instance */
-    protected get game(): Game;
+    /** Get engine class for static access */
+    protected get engine(): typeof Engine;
     /** Called when scene becomes active */
     abstract onEnter(): void | Promise<void>;
     /** Called every frame while scene is active */
@@ -549,9 +549,9 @@ declare class ToastManager {
     private currentColors;
     private currentThemeName;
     private resizeBinding;
-    /** Get screen width from Game singleton */
+    /** Get screen width from Engine */
     private get screenWidth();
-    /** Get screen height from Game singleton */
+    /** Get screen height from Engine */
     private get screenHeight();
     constructor(stage: PIXI.Container, config?: ToastManagerConfig);
     /**
@@ -657,7 +657,7 @@ declare class UIManager {
 }
 
 type ScaleMode = 'none' | 'letterbox' | 'fill';
-interface GameConfig {
+interface EngineConfig {
     width: number;
     height: number;
     backgroundColor?: number;
@@ -669,66 +669,94 @@ interface GameConfig {
     /** Auto-resize on window resize. Default: true */
     autoResize?: boolean;
 }
-declare class Game {
-    private static _instance;
-    /** Get the singleton Game instance. Throws if not initialized. */
-    static get instance(): Game;
-    /** Initialize the Game singleton. Throws if already initialized. */
-    static init(config: GameConfig): Game;
-    readonly app: PIXI.Application;
-    readonly scenes: SceneManager;
-    readonly input: InputManager;
-    readonly assets: AssetManager;
-    readonly sound: SoundManager;
-    readonly particles: ParticleManager;
-    readonly tween: TweenManager;
-    readonly ui: UIManager;
-    readonly spine: SpineManager;
-    readonly toast: ToastManager;
-    readonly alert: AlertManager;
-    readonly modal: ModalManager;
-    /** Logger instance for consistent logging across the game */
-    readonly logger: LoggerClass;
-    /** Signal emitted when game is paused */
-    readonly onPause: Signal<void>;
-    /** Signal emitted when game is resumed */
-    readonly onResume: Signal<void>;
-    /** Signal emitted when game is resized */
-    readonly onResize: Signal<{
+declare class Engine {
+    private constructor();
+    private static _app;
+    private static _scenes;
+    private static _input;
+    private static _assets;
+    private static _sound;
+    private static _particles;
+    private static _tween;
+    private static _ui;
+    private static _spine;
+    private static _toast;
+    private static _alert;
+    private static _modal;
+    /** Signal emitted when engine is paused */
+    static readonly onPause: Signal<void>;
+    /** Signal emitted when engine is resumed */
+    static readonly onResume: Signal<void>;
+    /** Signal emitted when engine is resized */
+    static readonly onResize: Signal<{
         width: number;
         height: number;
         scale: number;
     }>;
-    /** Signal emitted when game is updated */
-    readonly onUpdate: Signal<number>;
+    /** Signal emitted when engine is updated */
+    static readonly onUpdate: Signal<number>;
+    /** Signal emitted at the end of init() after all managers are constructed */
+    static readonly onReady: Signal<void>;
+    /** Signal emitted at the start of destroy() before any teardown */
+    static readonly onDestroy: Signal<void>;
+    /** Signal emitted when browser tab visibility changes (true = visible, false = hidden) */
+    static readonly onVisibilityChange: Signal<boolean>;
+    /** Signal emitted when browser window gains/loses focus (true = focused, false = blurred) */
+    static readonly onFocusChange: Signal<boolean>;
     /** Design resolution width (original config width) */
-    readonly designWidth: number;
+    private static _designWidth;
     /** Design resolution height (original config height) */
-    readonly designHeight: number;
+    private static _designHeight;
     /** Current scale mode */
-    scaleMode: ScaleMode;
+    private static _scaleMode;
     /** Current scale factor */
-    private _scale;
-    private _isRunning;
-    private readonly _resizeHandler;
-    private constructor();
-    private update;
-    get view(): PIXI.ICanvas;
-    get stage(): PIXI.Container;
+    private static _scale;
+    private static _isRunning;
+    private static _resizeHandler;
+    private static _visibilityHandler;
+    private static _focusHandler;
+    private static _blurHandler;
+    private static _initialized;
+    /** Logger instance for consistent logging across the engine */
+    static readonly logger: LoggerClass;
+    static get scenes(): SceneManager;
+    static get input(): InputManager;
+    static get assets(): AssetManager;
+    static get sound(): SoundManager;
+    static get particles(): ParticleManager;
+    static get tween(): TweenManager;
+    static get ui(): UIManager;
+    static get spine(): SpineManager;
+    static get toast(): ToastManager;
+    static get alert(): AlertManager;
+    static get modal(): ModalManager;
+    static get app(): PIXI.Application;
+    static get view(): PIXI.ICanvas;
+    static get stage(): PIXI.Container;
     /** Returns design resolution dimensions (use for positioning game elements) */
-    get screen(): PIXI.Rectangle;
+    static get screen(): PIXI.Rectangle;
     /** Returns actual renderer/viewport dimensions */
-    get viewport(): PIXI.Rectangle;
-    get isRunning(): boolean;
-    pause(): void;
-    resume(): void;
+    static get viewport(): PIXI.Rectangle;
+    static get isRunning(): boolean;
+    /** Design resolution width (original config width) */
+    static get designWidth(): number;
+    /** Design resolution height (original config height) */
+    static get designHeight(): number;
+    /** Current scale mode */
+    static get scaleMode(): ScaleMode;
+    static set scaleMode(value: ScaleMode);
     /** Get current scale factor */
-    get scale(): number;
+    static get scale(): number;
+    /** Initialize the Engine. Throws if already initialized. */
+    static init(config: EngineConfig): void;
+    private static update;
+    static pause(): void;
+    static resume(): void;
     /**
      * Get bounds in stage coordinates that cover the full viewport (including letterbox areas).
      * Use this for fullscreen overlays, backdrops, modals that need to cover the entire screen.
      */
-    getFullscreenBounds(): {
+    static getFullscreenBounds(): {
         x: number;
         y: number;
         width: number;
@@ -737,17 +765,12 @@ declare class Game {
     /**
      * Resize to fit window while maintaining aspect ratio based on scaleMode
      */
-    resizeToWindow(): void;
-    /**
-     * Resize game to fit target dimensions while maintaining aspect ratio
-     */
-    resize(targetWidth: number, targetHeight: number): void;
+    static resizeToWindow(): void;
     /**
-     * Propagate resize to all managers that need viewport dimensions
-     * Note: Toast/BaseModal auto-resize via Game.instance.onResize signal
+     * Resize engine to fit target dimensions while maintaining aspect ratio
      */
-    private propagateResize;
-    destroy(): void;
+    static resize(targetWidth: number, targetHeight: number): void;
+    static destroy(): void;
 }
 
 /**
@@ -977,4 +1000,4 @@ declare class LoggerClass {
 /** Global logger instance */
 declare const Logger: LoggerClass;
 
-export { type AlertButton, type AlertConfig, AlertManager, type AlertType, type AssetBundle, type AssetEntry, AssetManager, type AssetManifest, BaseModal, type BaseModalConfig, COUNT_PRESETS, type CloseButtonPosition, CountAnimator, type CountAnimatorConfig, type CountPreset, Game, type GameConfig, GamepadManager, type ICountRenderer, InputManager, KeyboardManager, type LogLevel, Logger, LoggerClass, type ModalAnimation, type ModalButtonConfig, ModalManager, ParticleManager, PointerManager, type ScaleMode, Scene, SceneManager, Signal, type SignalBinding, SoundManager, SpineManager, TOAST_PRESETS, TextCountRenderer, type ToastColorSet, type ToastConfig, ToastManager, type ToastManagerConfig, type ToastTheme, type ToastThemePreset, type ToastType, TweenManager, UIManager, createTheme, getCountPreset, getDefaultColors, getPreset };
+export { type AlertButton, type AlertConfig, AlertManager, type AlertType, type AssetBundle, type AssetEntry, AssetManager, type AssetManifest, BaseModal, type BaseModalConfig, COUNT_PRESETS, type CloseButtonPosition, CountAnimator, type CountAnimatorConfig, type CountPreset, Engine, type EngineConfig, GamepadManager, type ICountRenderer, InputManager, KeyboardManager, type LogLevel, Logger, LoggerClass, type ModalAnimation, type ModalButtonConfig, ModalManager, ParticleManager, PointerManager, type ScaleMode, Scene, SceneManager, Signal, type SignalBinding, SoundManager, SpineManager, TOAST_PRESETS, TextCountRenderer, type ToastColorSet, type ToastConfig, ToastManager, type ToastManagerConfig, type ToastTheme, type ToastThemePreset, type ToastType, TweenManager, UIManager, createTheme, getCountPreset, getDefaultColors, getPreset };