@rb-games/core 0.1.0

package/dist/plugins/Plugin.types.d.ts

@@ -0,0 +1,80 @@
+import type { PixiEngine } from '../engine/PixiEngine';
+/**
+ * Internal symbols for engine-only hook access
+ * These symbols prevent external code from calling lifecycle hooks
+ */
+export declare const ENGINE_HOOKS: {
+    readonly onEngineReady: symbol;
+    readonly onPause: symbol;
+    readonly onResume: symbol;
+    readonly onResize: symbol;
+};
+/**
+ * Plugin lifecycle states
+ */
+export declare enum PluginState {
+    REGISTERED = "registered",
+    INITIALIZING = "initializing",
+    INITIALIZED = "initialized",
+    READY = "ready",
+    ERROR = "error"
+}
+/**
+ * Plugin interface
+ */
+export interface EnginePlugin {
+    /**
+     * Plugin name. Must be unique.
+     */
+    name: string;
+    /**
+     * Plugin priority. Lower values represent higher priority.
+     */
+    priority: number;
+    /**
+     * Current plugin state
+     */
+    state?: PluginState;
+    /**
+     * Plugin dependencies - other plugins that must be ready before this one
+     */
+    dependencies?: string[];
+    /**
+     * Method that will be executed when the plugin is first loaded.
+     * @param engine PixiEngine instance
+     * @returns Promise that resolves when plugin is fully initialized
+     */
+    initialize(engine: PixiEngine): Promise<void> | void;
+    /**
+     * Called after initialization to mark plugin as ready
+     * This is where you can access other plugins safely
+     * @param engine PixiEngine instance
+     * @returns Promise that resolves when plugin is ready
+     */
+    onReady?(engine: PixiEngine): Promise<void> | void;
+    /**
+     * Method that will be executed when the plugin is cleaned up.
+     */
+    cleanup?(): void;
+    /**
+     * Called on every frame update.
+     * @param delta Frame duration (ms)
+     * @returns Boolean value
+     */
+    onUpdate?(delta: number): boolean;
+    /**
+     * Index signature to allow symbol-based properties for internal engine hooks
+     * @internal - These are accessed via ENGINE_HOOKS symbols by PixiEngine only
+     */
+    [key: symbol]: any;
+}
+/**
+ * Common configuration parameters for all plugins
+ */
+export interface PluginConfig {
+    priority?: number;
+    enabled?: boolean;
+    name?: string;
+    dependencies?: string[];
+}
+//# sourceMappingURL=Plugin.types.d.ts.map

package/dist/plugins/Plugin.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.types.d.ts","sourceRoot":"","sources":["../../plugins/Plugin.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX;;GAEG;AACH,oBAAY,WAAW;IACrB,UAAU,eAAe;IACzB,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAErD;;;;;OAKG;IACH,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEnD;;OAEG;IACH,OAAO,CAAC,IAAI,IAAI,CAAC;IAEjB;;;;OAIG;IACH,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAElC;;;OAGG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/dist/plugins/device/DeviceOptimizerPlugin.d.ts

@@ -0,0 +1,187 @@
+import { PixiEngine } from '../../engine/PixiEngine';
+import type { EnginePlugin } from '../Plugin.types';
+import type { DeviceInfo, PerformanceMetrics, OptimizationSettings, DeviceOptimizerConfig } from './DeviceOptimizerPlugin.types';
+/**
+ * Device detection and optimization plugin for PixiJS games.
+ *
+ * DeviceOptimizerPlugin automatically detects device capabilities and generates
+ * optimal performance settings. It analyzes platform, memory, network, battery,
+ * and GPU to calculate a performance tier (low/medium/high) and provides
+ * appropriate optimization settings.
+ *
+ * ## Features
+ *
+ * - **Device Detection**: Platform, browser, OS, screen properties
+ * - **Performance Metrics**: Memory, network, battery, GPU capabilities
+ * - **Automatic Tier Calculation**: Low, medium, or high performance tier
+ * - **Optimization Settings**: Asset resolution, particle limits, memory management
+ * - **ResourcePlugin Integration**: Provides settings for asset loading
+ *
+ * ## Performance Tiers
+ *
+ * - **Low Tier**: Mobile devices, low memory, slow network
+ *   - Asset resolution: 0.25x
+ *   - Max particles: 25
+ *   - Target FPS: 30
+ *   - Aggressive memory cleanup
+ *
+ * - **Medium Tier**: Tablets, mid-range devices
+ *   - Asset resolution: 0.5x
+ *   - Max particles: 100
+ *   - Target FPS: 60
+ *   - Moderate memory management
+ *
+ * - **High Tier**: Desktop, high-end devices
+ *   - Asset resolution: 1.0x - 2.0x
+ *   - Max particles: 500
+ *   - Target FPS: 60
+ *   - Advanced effects enabled
+ *
+ * ## Integration with ResourcePlugin
+ *
+ * DeviceOptimizerPlugin must initialize before ResourcePlugin. ResourcePlugin
+ * reads optimization settings to determine which asset resolutions to load.
+ *
+ * @example
+ * ```typescript
+ * const deviceOptimizer = new DeviceOptimizerPlugin({
+ *   enableAdvancedMetrics: true,
+ *   enableNetworkDetection: true,
+ *   enableBatteryDetection: true,
+ *   debug: true
+ * });
+ *
+ * engine.registerPlugin(deviceOptimizer);
+ * await engine.initialize();
+ *
+ * // Get optimization settings
+ * const settings = deviceOptimizer.getSettings();
+ * console.log('Asset resolution:', settings.assetResolution);
+ * console.log('Performance tier:', deviceOptimizer.getPerformanceTier());
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Force specific tier for testing
+ * const deviceOptimizer = new DeviceOptimizerPlugin({
+ *   forceTier: 'low',
+ *   forceResolution: 0.5
+ * });
+ * ```
+ *
+ * @category Plugins
+ * @public
+ */
+export declare class DeviceOptimizerPlugin implements EnginePlugin {
+    name: string;
+    priority: number;
+    dependencies: string[];
+    private config;
+    private deviceInfo;
+    private metrics;
+    private settings;
+    private performanceTier;
+    private isInitialized;
+    /**
+     * Detect WebP support using PIXI's native method
+     */
+    private detectWebP;
+    private defaultTierSettings;
+    constructor(config?: DeviceOptimizerConfig);
+    initialize(engine: PixiEngine): Promise<void>;
+    onReady(engine: PixiEngine): void;
+    isReady(): boolean;
+    cleanup(): void;
+    /**
+     * Safe device detection
+     */
+    private detectDevice;
+    private detectPlatform;
+    private detectBrowser;
+    private detectOS;
+    private calculateDiagonal;
+    /**
+     * Gather performance metrics safely
+     */
+    private gatherMetrics;
+    private getMemoryInfo;
+    private getNetworkInfo;
+    private getBatteryInfo;
+    private getGPUInfo;
+    private assessGPUTier;
+    /**
+     * Calculate overall performance tier
+     */
+    private calculatePerformanceTier;
+    private generateOptimizationSettings;
+    private applyForceOverrides;
+    private useFallbackSettings;
+    private logDeviceInfo;
+    /**
+     * Gets detected device information.
+     *
+     * @returns Device info or null if not yet initialized
+     */
+    getDeviceInfo(): DeviceInfo | null;
+    /**
+     * Gets gathered performance metrics.
+     *
+     * @returns Performance metrics or null if not yet initialized
+     */
+    getMetrics(): PerformanceMetrics | null;
+    /**
+     * Gets calculated optimization settings.
+     *
+     * These settings are used by ResourcePlugin to determine asset loading strategy.
+     *
+     * @returns Optimization settings or null if not yet initialized
+     */
+    getSettings(): OptimizationSettings | null;
+    /**
+     * Gets the calculated performance tier.
+     *
+     * @returns Performance tier: 'low', 'medium', or 'high'
+     */
+    getPerformanceTier(): 'low' | 'medium' | 'high';
+    /**
+     * Gets the recommended asset resolution multiplier.
+     *
+     * @returns Resolution multiplier (e.g., 0.25, 0.5, 1.0, 2.0)
+     */
+    getAssetResolution(): number;
+    getAssetSuffix(): string;
+    /**
+     * Gets the optimal particle count for the current device.
+     *
+     * @param baseCount Base particle count
+     * @returns Adjusted particle count
+     */
+    getOptimalParticleCount(baseCount: number): number;
+    /**
+     * Checks if advanced particle effects are supported.
+     *
+     * @returns True if advanced effects are supported, false otherwise
+     */
+    supportsAdvancedEffects(): boolean;
+    /**
+     * Gets package loading preferences for ResourcePlugin.
+     *
+     * Returns a map of package names to preference values:
+     * - -1: Disable package
+     * - 0: Normal priority
+     * - 1: Prefer package
+     * - 2: High priority
+     *
+     * @returns Package preferences map
+     */
+    getPackagePreferences(): Record<string, number>;
+    /**
+     * Overrides optimization settings with custom values.
+     *
+     * @param overrides Custom optimization settings
+     */
+    overrideSettings(overrides: Partial<OptimizationSettings>): void;
+    forceTier(tier: 'low' | 'medium' | 'high'): void;
+    [key: symbol]: any;
+}
+//# sourceMappingURL=DeviceOptimizerPlugin.d.ts.map

package/dist/plugins/device/DeviceOptimizerPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceOptimizerPlugin.d.ts","sourceRoot":"","sources":["../../../plugins/device/DeviceOptimizerPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,+BAA+B,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACjD,IAAI,EAAE,MAAM,CAA2B;IACvC,QAAQ,EAAE,MAAM,CAAM;IACtB,YAAY,EAAE,MAAM,EAAE,CAAM;IAEnC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,aAAa,CAAS;IAE9B;;OAEG;YACW,UAAU;IASxB,OAAO,CAAC,mBAAmB,CAA0D;gBAEzE,MAAM,GAAE,qBAA0B;IAuHjC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCnD,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKjC,OAAO,IAAI,OAAO;IAIlB,OAAO,IAAI,IAAI;IAKtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,QAAQ;IA8BhB,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;YACW,aAAa;YAWb,aAAa;YA+Bb,cAAc;YAyCd,cAAc;YAmCd,UAAU;IA0CxB,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoChC,OAAO,CAAC,4BAA4B;IA8FpC,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,mBAAmB;IAgC3B,OAAO,CAAC,aAAa;IAoBrB;;;;OAIG;IACI,aAAa,IAAI,UAAU,GAAG,IAAI;IAIzC;;;;OAIG;IACI,UAAU,IAAI,kBAAkB,GAAG,IAAI;IAI9C;;;;;;OAMG;IACI,WAAW,IAAI,oBAAoB,GAAG,IAAI;IAIjD;;;;OAIG;IACI,kBAAkB,IAAI,KAAK,GAAG,QAAQ,GAAG,MAAM;IAItD;;;;OAIG;IACI,kBAAkB,IAAI,MAAM;IAI5B,cAAc,IAAI,MAAM;IAI/B;;;;;OAKG;IACI,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAMzD;;;;OAIG;IACI,uBAAuB,IAAI,OAAO;IAIzC;;;;;;;;;;OAUG;IACI,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAItD;;;;OAIG;IACI,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAOhE,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI;IAMvD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/plugins/device/DeviceOptimizerPlugin.types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Device information detected from the user's system.
+ *
+ * Contains comprehensive details about the device platform, browser, OS, and screen properties.
+ * Used by DeviceOptimizerPlugin to determine optimal performance settings.
+ *
+ * @public
+ */
+export interface DeviceInfo {
+    /** Device platform type */
+    platform: 'mobile' | 'tablet' | 'desktop';
+    /** Browser information */
+    browser: {
+        /** Browser name */
+        name: 'chrome' | 'firefox' | 'safari' | 'edge' | 'unknown';
+        /** Browser version string */
+        version: string;
+    };
+    /** Operating system information */
+    os: {
+        /** OS name */
+        name: 'ios' | 'android' | 'windows' | 'macos' | 'linux' | 'unknown';
+        /** OS version string */
+        version: string;
+    };
+    /** Screen properties */
+    screen: {
+        /** CSS viewport width in pixels */
+        width: number;
+        /** CSS viewport height in pixels */
+        height: number;
+        /** Device pixel ratio (e.g., 2 for Retina displays) */
+        pixelRatio: number;
+        /** Screen diagonal size in pixels */
+        diagonal: number;
+        /** Current screen orientation */
+        orientation: 'portrait' | 'landscape';
+    };
+}
+/**
+ * Performance metrics gathered from the device.
+ *
+ * Includes memory, network, battery, and GPU information used to calculate
+ * the optimal performance tier and optimization settings.
+ *
+ * @public
+ */
+export interface PerformanceMetrics {
+    memory: {
+        totalMB: number;
+        usedMB: number;
+        tier: 'low' | 'medium' | 'high';
+    };
+    network: {
+        type: 'slow-2g' | '2g' | '3g' | '4g' | 'wifi' | 'unknown';
+        effectiveType: 'slow-2g' | '2g' | '3g' | '4g';
+        downlink: number;
+        rtt: number;
+        isSlow: boolean;
+    };
+    battery: {
+        level: number;
+        charging: boolean;
+        isLow: boolean;
+        savePower: boolean;
+    };
+    gpu: {
+        renderer: string;
+        vendor: string;
+        tier: 'low' | 'medium' | 'high';
+        maxTextureSize: number;
+        supportsWebGL2: boolean;
+    };
+}
+/**
+ * Optimization settings calculated based on device capabilities.
+ *
+ * These settings control asset quality, visual effects, performance targets,
+ * and memory management. Generated automatically by DeviceOptimizerPlugin
+ * based on the detected performance tier.
+ *
+ * @remarks
+ * Used by ResourcePlugin to determine which asset resolutions to load.
+ *
+ * @public
+ */
+export interface OptimizationSettings {
+    assetResolution: number;
+    assetSuffix: string;
+    assetQuality: 'low' | 'medium' | 'high';
+    preloadStrategy: 'minimal' | 'moderate' | 'aggressive';
+    enableWebP: boolean;
+    particleSettings: {
+        maxParticles: number;
+        quality: 'low' | 'medium' | 'high';
+        enableAdvancedEffects: boolean;
+        enableBlur: boolean;
+        enableGlow: boolean;
+    };
+    targetFPS: 30 | 60;
+    enableAntialiasing: boolean;
+    enableMipmaps: boolean;
+    textureMaxSize: number;
+    memoryLimits: {
+        maxAssetMemoryMB: number;
+        maxTextureMemoryMB: number;
+        enableAggressiveCleanup: boolean;
+        gcInterval: number;
+    };
+    packagePreferences: Record<string, number>;
+}
+/**
+ * Configuration options for DeviceOptimizerPlugin.
+ *
+ * Controls which metrics to gather, allows forcing specific settings,
+ * and enables customization of tier-based optimization profiles.
+ *
+ * @public
+ */
+export interface DeviceOptimizerConfig {
+    enableAdvancedMetrics?: boolean;
+    enableNetworkDetection?: boolean;
+    enableBatteryDetection?: boolean;
+    enableGPUDetection?: boolean;
+    forceResolution?: number;
+    forceTier?: 'low' | 'medium' | 'high';
+    forcePlatform?: 'mobile' | 'tablet' | 'desktop';
+    tierSettings?: {
+        low?: Partial<OptimizationSettings>;
+        medium?: Partial<OptimizationSettings>;
+        high?: Partial<OptimizationSettings>;
+    };
+}
+//# sourceMappingURL=DeviceOptimizerPlugin.types.d.ts.map

package/dist/plugins/device/DeviceOptimizerPlugin.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceOptimizerPlugin.types.d.ts","sourceRoot":"","sources":["../../../plugins/device/DeviceOptimizerPlugin.types.ts"],"names":[],"mappings":"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"}

package/dist/plugins/device/index.d.ts

@@ -0,0 +1,3 @@
+export { DeviceOptimizerPlugin } from './DeviceOptimizerPlugin';
+export type { DeviceInfo, PerformanceMetrics, OptimizationSettings, DeviceOptimizerConfig } from './DeviceOptimizerPlugin.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/device/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../plugins/device/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EACR,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACxB,MAAM,+BAA+B,CAAC"}

package/dist/plugins/display/DisplayPlugin.d.ts

@@ -0,0 +1,208 @@
+import { PixiEngine } from '../../engine/PixiEngine';
+import type { DisplayPluginConfig, DisplayEvents, DisplayResizeData } from './DisplayPlugin.types';
+import type { EnginePlugin } from '../Plugin.types';
+import { EventEmitter } from 'pixi.js';
+/**
+ * Display management plugin for PixiJS games.
+ *
+ * DisplayPlugin handles responsive canvas scaling and positioning, maintaining a fixed
+ * design resolution while adapting to different window sizes and aspect ratios.
+ *
+ * ## Features
+ *
+ * - **Fixed Design Resolution**: Work with consistent logical coordinates
+ * - **Responsive Scaling**: Automatically scales to fit any window size
+ * - **Aspect Ratio Preservation**: Maintains design proportions
+ * - **Flexible Alignment**: Position game canvas anywhere in the window
+ * - **Scale Modes**: Contain (letterbox) or cover (fill) options
+ * - **Automatic Resize Handling**: Responds to window size changes
+ *
+ * ## Scaling Behavior
+ *
+ * ### Contain Mode (default)
+ * Fits the entire game within the window, adding letterboxing or pillarboxing if needed.
+ * Ensures all content is visible but may leave empty space.
+ *
+ * ### Cover Mode
+ * Fills the entire window, potentially cropping content at the edges.
+ * No empty space but some content may be off-screen.
+ *
+ * ## Design Resolution
+ *
+ * The plugin uses a fixed design resolution (e.g., 1920x1080) that your game is built for.
+ * All game objects use these logical coordinates. The plugin handles scaling to physical pixels.
+ *
+ * @example
+ * ```typescript
+ * // Standard 1080p design resolution
+ * const displayPlugin = new DisplayPlugin({
+ *   width: 1920,
+ *   height: 1080,
+ *   scaleMode: 'contain',
+ *   alignment: 'center'
+ * });
+ *
+ * engine.registerPlugin(displayPlugin);
+ * await engine.initialize();
+ *
+ * // Your game objects use logical coordinates
+ * sprite.position.set(960, 540);  // Center of 1920x1080
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Mobile-optimized vertical layout
+ * const displayPlugin = new DisplayPlugin({
+ *   width: 720,
+ *   height: 1280,
+ *   scaleMode: 'contain',
+ *   alignment: 'center'
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Cover mode for full-screen games
+ * const displayPlugin = new DisplayPlugin({
+ *   width: 1920,
+ *   height: 1080,
+ *   scaleMode: 'cover',  // Fill entire window
+ *   alignment: 'center'
+ * });
+ * ```
+ *
+ * @category Plugins
+ * @public
+ */
+export declare class DisplayPlugin extends EventEmitter<DisplayEvents> implements EnginePlugin {
+    name: string;
+    priority: number;
+    /**
+     * No dependencies - this is a core display plugin
+     */
+    dependencies: string[];
+    private _designWidth;
+    private _designHeight;
+    private _engine;
+    private config;
+    private isInitialized;
+    private _currentOrientation;
+    private _activeConfig;
+    private _lastResizeData;
+    /**
+     * Creates a new DisplayPlugin instance.
+     *
+     * @param config - Display configuration options
+     *
+     * @example
+     * ```typescript
+     * const displayPlugin = new DisplayPlugin({
+     *   width: 1920,
+     *   height: 1080,
+     *   scaleMode: 'contain',
+     *   alignment: 'center',
+     *   debug: true
+     * });
+     * ```
+     */
+    constructor(config: DisplayPluginConfig);
+    /**
+     * Detects orientation based on width/height ratio.
+     * @param width - Window width
+     * @param height - Window height
+     * @returns 'landscape' if width >= height, 'portrait' otherwise
+     */
+    private detectOrientation;
+    /**
+     * Gets the active configuration based on current orientation.
+     * Falls back to landscape config if portrait is not defined.
+     */
+    private getActiveConfig;
+    /**
+     * Gets the current orientation.
+     */
+    get orientation(): 'landscape' | 'portrait';
+    /**
+     * Initializes the DisplayPlugin.
+     *
+     * Sets up canvas styles and prepares for resize handling.
+     * Called automatically by PixiEngine during plugin initialization.
+     *
+     * @param engine - PixiEngine instance
+     */
+    initialize(engine: PixiEngine): void;
+    /**
+     * Plugin is ready immediately after initialization
+     */
+    onReady(engine: PixiEngine): void;
+    /**
+     * Check if plugin is ready for use
+     */
+    isReady(): boolean;
+    /**
+     * Gets the design width.
+     *
+     * @returns Design width in logical pixels
+     *
+     * @example
+     * ```typescript
+     * const centerX = displayPlugin.width / 2;  // 960 for 1920x1080
+     * ```
+     */
+    get width(): number;
+    /**
+     * Gets the design height.
+     *
+     * @returns Design height in logical pixels
+     *
+     * @example
+     * ```typescript
+     * const centerY = displayPlugin.height / 2;  // 540 for 1920x1080
+     * ```
+     */
+    get height(): number;
+    /**
+     * Gets the last resize data.
+     * Useful for getting current display state without waiting for resize event.
+     *
+     * @returns Last resize data or null if not yet resized
+     */
+    getLastResizeData(): DisplayResizeData | null;
+    /**
+     * Gets the current fullscreen state.
+     *
+     * @returns True if the document is in fullscreen mode
+     */
+    get isFullscreen(): boolean;
+    /**
+     * Toggles fullscreen mode using the Browser Fullscreen API.
+     *
+     * @param state - Optional. If true, enters fullscreen. If false, exits fullscreen.
+     *                If not provided, toggles the current state.
+     * @returns Promise that resolves when the fullscreen state change is complete
+     *
+     * @example
+     * ```typescript
+     * // Toggle fullscreen
+     * await displayPlugin.toggleFullscreen();
+     *
+     * // Enter fullscreen
+     * await displayPlugin.toggleFullscreen(true);
+     *
+     * // Exit fullscreen
+     * await displayPlugin.toggleFullscreen(false);
+     * ```
+     */
+    toggleFullscreen(state?: boolean): Promise<void>;
+    /**
+     * Cleanup the plugin
+     */
+    cleanup(): void;
+    /**
+     * Plugin update process
+     */
+    onUpdate(_deltaTime: number): boolean;
+    [key: symbol]: any;
+}
+export type { DisplayPluginConfig, DisplayEvents, DisplayResizeData } from './DisplayPlugin.types';
+//# sourceMappingURL=DisplayPlugin.d.ts.map

package/dist/plugins/display/DisplayPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayPlugin.d.ts","sourceRoot":"","sources":["../../../plugins/display/DisplayPlugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAqB,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACtH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AACH,qBAAa,aAAc,SAAQ,YAAY,CAAC,aAAa,CAAE,YAAW,YAAY;IAC7E,IAAI,EAAE,MAAM,CAAmB;IAC/B,QAAQ,EAAE,MAAM,CAAO;IAE9B;;OAEG;IACI,YAAY,EAAE,MAAM,EAAE,CAAM;IAEnC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,mBAAmB,CAAyC;IACpE,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,eAAe,CAAkC;IAEzD;;;;;;;;;;;;;;;OAeG;gBACS,MAAM,EAAE,mBAAmB;IAqBvC;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,IAAW,WAAW,IAAI,WAAW,GAAG,UAAU,CAEjD;IAED;;;;;;;OAOG;IACI,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAwB3C;;OAEG;IACI,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIxC;;OAEG;IACI,OAAO,IAAI,OAAO;IA4OzB;;;;;;;;;OASG;IACH,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED;;;;;;;;;OASG;IACH,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED;;;;;OAKG;IACI,iBAAiB;IAIxB;;;;OAIG;IACH,IAAW,YAAY,IAAI,OAAO,CAEjC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACU,gBAAgB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB7D;;OAEG;IACI,OAAO,IAAI,IAAI;IAMtB;;OAEG;IAEI,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAK5C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAGD,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}