@rb-games/core 0.1.0

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

@@ -0,0 +1,174 @@
+import { PluginConfig } from '../Plugin.types';
+/**
+ * Alignment options for canvas positioning.
+ */
+export type DisplayAlignment = 'center' | 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+/**
+ * Scale mode options.
+ *
+ * - `contain`: Fit entire game within window (letterboxing/pillarboxing may occur)
+ * - `cover`: Fill entire window (some content may be cropped)
+ * - `safe`: Cover mode with safe area constraints
+ */
+export type DisplayScaleMode = 'contain' | 'cover' | 'safe';
+/**
+ * Safe area margins in pixels.
+ *
+ * Defines the safe area that should never be cropped when using safe mode.
+ * The scale will be calculated to ensure the safe area always fits within the viewport.
+ */
+export interface SafeAreaConfig {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+/**
+ * Configuration for a specific orientation (landscape or portrait).
+ *
+ * @example
+ * ```typescript
+ * const landscapeConfig: OrientationConfig = {
+ *   width: 1920,
+ *   height: 1080,
+ *   scaleMode: 'safe',
+ *   safeArea: { left: 100, right: 100 },
+ *   alignment: 'center'
+ * };
+ * ```
+ */
+export interface OrientationConfig {
+    /**
+     * Design width in pixels for this orientation.
+     */
+    width: number;
+    /**
+     * Design height in pixels for this orientation.
+     */
+    height: number;
+    /**
+     * Scaling mode (default: 'contain').
+     */
+    scaleMode?: DisplayScaleMode;
+    /**
+     * Safe area margins in pixels (only applies to 'safe' mode).
+     */
+    safeArea?: SafeAreaConfig;
+    /**
+     * Alignment of the game canvas within the window (default: 'center').
+     */
+    alignment?: DisplayAlignment;
+    /**
+     * Supported aspect ratio range for this orientation.
+     * When window aspect ratio is outside this range, it will be clamped
+     * to the nearest supported ratio. The clamped area is always centered
+     * on screen, and the stage is positioned within it according to alignment.
+     *
+     * @example
+     * ```typescript
+     * // Portrait: support 9:16 to 9:21 (0.428 to 0.5625)
+     * aspectRatioRange: {
+     *   min: 9 / 21,   // 0.428 - narrowest supported
+     *   max: 9 / 16    // 0.5625 - widest supported
+     * }
+     *
+     * // Landscape: support 16:9 to 21:9 (1.78 to 2.33)
+     * aspectRatioRange: {
+     *   min: 16 / 9,   // 1.78 - tallest supported
+     *   max: 21 / 9    // 2.33 - widest supported
+     * }
+     * ```
+     */
+    aspectRatioRange?: {
+        min: number;
+        max: number;
+    };
+}
+/**
+ * Configuration for DisplayPlugin.
+ *
+ * Controls the game's design resolution, scaling behavior, and alignment within the browser window.
+ * DisplayPlugin maintains a fixed design resolution and scales the game to fit the window while
+ * preserving aspect ratio. Supports separate configurations for landscape and portrait orientations.
+ *
+ * @example
+ * ```typescript
+ * const config: DisplayPluginConfig = {
+ *   landscape: {
+ *     width: 1920,
+ *     height: 1080,
+ *     scaleMode: 'safe',
+ *     safeArea: { left: 100, right: 100 },
+ *     alignment: 'center'
+ *   },
+ *   portrait: {
+ *     width: 1080,
+ *     height: 1920,
+ *     scaleMode: 'contain',
+ *     alignment: 'center'
+ *   }
+ * };
+ * ```
+ *
+ * @public
+ */
+export interface DisplayPluginConfig extends PluginConfig {
+    /**
+     * Configuration for landscape orientation (required).
+     */
+    landscape: OrientationConfig;
+    /**
+     * Configuration for portrait orientation (optional).
+     * If not provided, landscape config will be used with a warning.
+     */
+    portrait?: OrientationConfig;
+}
+/**
+ * Payload emitted on `display:resize`.
+ */
+export interface DisplayResizeData {
+    designWidth: number;
+    designHeight: number;
+    windowWidth: number;
+    windowHeight: number;
+    width: number;
+    height: number;
+    scale: number;
+    left: number;
+    top: number;
+    offsetX: number;
+    offsetY: number;
+    resolution: number;
+    orientation: 'landscape' | 'portrait';
+    /** Clamped viewport left edge in design coordinates: `-left / scale`. */
+    uiViewportLeftX: number;
+    /** Clamped viewport top edge in design coordinates: `-top / scale`. */
+    uiViewportTopY: number;
+    /** Clamped viewport right edge in design coordinates: `(width - left) / scale`. */
+    uiViewportRightX: number;
+    /** Clamped viewport bottom edge in design coordinates: `(height - top) / scale`. */
+    uiViewportBottomY: number;
+}
+/**
+ * Display events emitted by DisplayPlugin.
+ */
+export interface DisplayEvents {
+    /**
+     * Emitted when the display is resized.
+     */
+    'display:resize': (data: DisplayResizeData) => void;
+    /**
+     * Emitted when the orientation changes.
+     */
+    'display:orientationChange': (data: {
+        oldOrientation: 'landscape' | 'portrait';
+        newOrientation: 'landscape' | 'portrait';
+    }) => void;
+    /**
+     * Emitted when fullscreen state changes.
+     */
+    'display:fullscreenChange': (data: {
+        isFullscreen: boolean;
+    }) => void;
+}
+//# sourceMappingURL=DisplayPlugin.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DisplayPlugin.types.d.ts","sourceRoot":"","sources":["../../../plugins/display/DisplayPlugin.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,MAAM,GACN,OAAO,GACP,UAAU,GACV,WAAW,GACX,aAAa,GACb,cAAc,CAAC;AAEnB;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,gBAAgB,CAAC,EAAE;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD;;OAEG;IACH,SAAS,EAAE,iBAAiB,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,WAAW,GAAG,UAAU,CAAC;IACtC,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,gBAAgB,EAAE,MAAM,CAAC;IACzB,oFAAoF;IACpF,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,gBAAgB,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAEpD;;OAEG;IACH,2BAA2B,EAAE,CAAC,IAAI,EAAE;QAClC,cAAc,EAAE,WAAW,GAAG,UAAU,CAAC;QACzC,cAAc,EAAE,WAAW,GAAG,UAAU,CAAC;KAC1C,KAAK,IAAI,CAAC;IAEX;;OAEG;IACH,0BAA0B,EAAE,CAAC,IAAI,EAAE;QACjC,YAAY,EAAE,OAAO,CAAC;KACvB,KAAK,IAAI,CAAC;CACZ"}

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

@@ -0,0 +1,10 @@
+import type { DisplayResizeData } from './DisplayPlugin.types';
+export interface DesignViewportRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Maps DisplayPlugin clamp geometry to a rectangle in design coordinates. */
+export declare function computeDesignViewportRect(data: DisplayResizeData): DesignViewportRect;
+//# sourceMappingURL=displayViewport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"displayViewport.d.ts","sourceRoot":"","sources":["../../../plugins/display/displayViewport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,iBAAiB,GAAG,kBAAkB,CAUrF"}

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

@@ -0,0 +1,4 @@
+export * from './DisplayPlugin';
+export * from './displayViewport';
+export type { DisplayPluginConfig, DisplayResizeData } from './DisplayPlugin.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../plugins/display/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/plugins/eventbus/EventBusPlugin.d.ts

@@ -0,0 +1,21 @@
+import { EventEmitter } from 'pixi.js';
+import type { EnginePlugin } from '../Plugin.types';
+import { ENGINE_HOOKS } from '../Plugin.types';
+import type { PixiEngine } from '../../engine/PixiEngine';
+import type { EventResult, EngineEvents } from './EventBusPlugin.types';
+export declare class EventBusPlugin<TEvents extends EngineEvents = EngineEvents> extends EventEmitter<TEvents> implements EnginePlugin {
+    [ENGINE_HOOKS.onEngineReady]: (_engine: PixiEngine) => void;
+    [ENGINE_HOOKS.onPause]: (_engine: PixiEngine) => void;
+    [ENGINE_HOOKS.onResume]: (_engine: PixiEngine) => void;
+    [ENGINE_HOOKS.onResize]: (width: number, height: number) => boolean;
+    readonly name = "eventBusPlugin";
+    readonly priority = 5;
+    constructor();
+    initialize(_engine: PixiEngine): Promise<void>;
+    cleanup(): void;
+    emit<T extends EventEmitter.EventNames<TEvents>>(event: T, ...args: Parameters<EventEmitter.EventListener<TEvents, T>>): boolean;
+    emitAsync<T extends EventEmitter.EventNames<TEvents>>(event: T, ...args: Parameters<EventEmitter.EventListener<TEvents, T>>): Promise<any>;
+    emitCancellable<T extends keyof TEvents>(event: T, ...args: any[]): EventResult;
+    emitCancellableAsync<T extends keyof TEvents>(event: T, ...args: any[]): Promise<EventResult>;
+}
+//# sourceMappingURL=EventBusPlugin.d.ts.map

package/dist/plugins/eventbus/EventBusPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBusPlugin.d.ts","sourceRoot":"","sources":["../../../plugins/eventbus/EventBusPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGxE,qBAAa,cAAc,CAAC,OAAO,SAAS,YAAY,GAAG,YAAY,CACrE,SAAQ,YAAY,CAAC,OAAO,CAC5B,YAAW,YAAY;IAavB,CAAC,YAAY,CAAC,aAAa,CAAC,YAAU,UAAU,KAAG,IAAI;IAKvD,CAAC,YAAY,CAAC,OAAO,CAAC,YAAU,UAAU,KAAG,IAAI;IAKjD,CAAC,YAAY,CAAC,QAAQ,CAAC,YAAU,UAAU,KAAG,IAAI;IAKlD,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAQ,MAAM,UAAU,MAAM,KAAG,OAAO;IA3B/D,SAAgB,IAAI,oBAAoB;IACxC,SAAgB,QAAQ,KAAK;;IAOvB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBpD,OAAO,IAAI,IAAI;IAcf,IAAI,CAAC,CAAC,SAAS,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO;IAU1H,SAAS,CAAC,CAAC,SAAS,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAOhJ,eAAe,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,WAAW;IA4BzE,oBAAoB,CAAC,CAAC,SAAS,MAAM,OAAO,EAChD,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,GAAG,EAAE,GACb,OAAO,CAAC,WAAW,CAAC;CA+BxB"}

package/dist/plugins/eventbus/EventBusPlugin.types.d.ts

@@ -0,0 +1,24 @@
+export interface EventResult {
+    cancelled: boolean;
+    data?: any;
+    priority: number;
+    cancel(priority?: number): void;
+    setData(data: any): void;
+}
+/**
+ * Base game events interface
+ * This is intentionally minimal - specific game types (slot, plinko, etc.) should extend this
+ *
+ * Engine lifecycle events are automatically emitted by EventBusPlugin via PixiEngine hooks:
+ * - 'engine:ready' - Emitted in onEngineReady() hook when entire engine is initialized
+ * - 'engine:resize' - Emitted in onResize() hook when window is resized
+ * - 'engine:pause' - Emitted in onPause() hook when engine.pause() is called
+ * - 'engine:resume' - Emitted in onResume() hook when engine.resume() is called
+ */
+export interface EngineEvents {
+    'engine:ready': () => void;
+    'engine:resize': (width: number, height: number) => void;
+    'engine:pause': () => void;
+    'engine:resume': () => void;
+}
+//# sourceMappingURL=EventBusPlugin.types.d.ts.map

package/dist/plugins/eventbus/EventBusPlugin.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBusPlugin.types.d.ts","sourceRoot":"","sources":["../../../plugins/eventbus/EventBusPlugin.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAE3B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B"}

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

@@ -0,0 +1,3 @@
+export { EventBusPlugin } from './EventBusPlugin';
+export type { EventResult, EngineEvents } from './EventBusPlugin.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../plugins/eventbus/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/plugins/gsap/GsapPlugin.d.ts

@@ -0,0 +1,307 @@
+import { PixiEngine } from '../../engine/PixiEngine';
+import { Container } from 'pixi.js';
+import type { EnginePlugin } from '../Plugin.types';
+/**
+ * GSAP animation integration plugin for PixiJS games.
+ *
+ * GsapPlugin integrates the powerful GSAP (GreenSock Animation Platform) library
+ * with PixiJS, providing a unified animation loop and convenient animation helpers.
+ *
+ * ## Features
+ *
+ * - **Unified Ticker**: Single animation loop driven by GSAP
+ * - **Animation Helpers**: Pre-built fade, scale, move animations
+ * - **Timeline Support**: Create complex animation sequences
+ * - **PixiJS Integration**: Direct access to stage management
+ * - **Type-Safe**: Full TypeScript support
+ *
+ * ## How It Works
+ *
+ * GsapPlugin replaces PixiJS's default ticker with GSAP's ticker, ensuring all
+ * animations (both GSAP and PixiJS) run on the same timeline. This prevents
+ * timing conflicts and improves performance.
+ *
+ * ### Ticker Integration
+ *
+ * 1. GSAP ticker runs at 60 FPS (or requestAnimationFrame)
+ * 2. On each tick, GSAP updates all its tweens
+ * 3. Plugin forwards tick to PixiJS ticker
+ * 4. Engine's onUpdate is called for game logic
+ *
+ * ## Animation Helpers
+ *
+ * The plugin provides convenient methods for common animations:
+ * - `fadeIn()` / `fadeOut()` - Opacity animations
+ * - `scaleIn()` / `scaleOut()` - Scale animations with easing
+ * - `moveTo()` - Position animations
+ * - `animate()` - Generic property animations
+ * - `sequence()` - Staggered animation sequences
+ * - `createTimeline()` - Complex animation timelines
+ *
+ * @example
+ * ```typescript
+ * const gsapPlugin = new GsapPlugin();
+ * engine.registerPlugin(gsapPlugin);
+ * await engine.initialize();
+ *
+ * // Fade in a sprite
+ * const sprite = new Sprite(texture);
+ * gsapPlugin.addToStage(sprite);
+ * gsapPlugin.fadeIn(sprite, 1.0);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Create a complex animation sequence
+ * const timeline = gsapPlugin.createTimeline();
+ *
+ * timeline
+ *   .add(gsapPlugin.fadeIn(logo, 0.5))
+ *   .add(gsapPlugin.scaleIn(button, 0.3), '-=0.2')
+ *   .add(gsapPlugin.moveTo(panel, 100, 200, 0.5));
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Staggered animations
+ * const buttons = [button1, button2, button3];
+ *
+ * gsapPlugin.sequence(
+ *   buttons.map(btn => () => gsapPlugin.fadeIn(btn, 0.3)),
+ *   0.1  // 0.1s delay between each
+ * );
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Custom animation with callbacks
+ * gsapPlugin.animate(sprite, { rotation: Math.PI * 2 }, 2.0, {
+ *   ease: 'elastic.out',
+ *   onComplete: () => console.log('Rotation complete!')
+ * });
+ * ```
+ *
+ * @category Plugins
+ * @public
+ */
+export declare class GsapPlugin implements EnginePlugin {
+    /**
+     * Plugin name
+     */
+    name: string;
+    /**
+     * High priority to ensure it runs before other plugins
+     */
+    priority: number;
+    /**
+     * No dependencies - this is a core plugin
+     */
+    dependencies: string[];
+    private engine;
+    private gsapTickerCallback;
+    private isInitialized;
+    /**
+     * Initializes the GSAP plugin.
+     *
+     * Sets up the unified ticker system by connecting GSAP's ticker to PixiJS.
+     * 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;
+    [key: symbol]: any;
+    /**
+     * Clean up when plugin is removed
+     */
+    cleanup(): void;
+    /**
+     * Plugin hook that runs every tick
+     * @param deltaTime The time elapsed since the last update
+     * @returns Returns false because GsapPlugin allows other plugins to continue updating.
+     * GSAP ticker and plugin onUpdate loops are different mechanisms.
+     */
+    onUpdate(_deltaTime: number): boolean;
+    /**
+     * Creates a GSAP timeline for complex animation sequences.
+     *
+     * Timelines allow you to choreograph multiple animations with precise timing control.
+     *
+     * @param vars - Timeline configuration options
+     * @returns GSAP Timeline instance
+     *
+     * @example
+     * ```typescript
+     * const timeline = gsapPlugin.createTimeline({ repeat: -1, yoyo: true });
+     * timeline
+     *   .to(sprite, { x: 100, duration: 1 })
+     *   .to(sprite, { y: 100, duration: 1 })
+     *   .to(sprite, { rotation: Math.PI, duration: 1 });
+     * ```
+     */
+    createTimeline(vars?: gsap.TimelineVars): gsap.core.Timeline;
+    /**
+     * Fades in a container from transparent to opaque.
+     *
+     * Sets alpha to 0 and animates to 1.
+     *
+     * @param target - Container to animate
+     * @param duration - Animation duration in seconds (default: 0.5)
+     * @param vars - Additional GSAP tween options
+     * @returns Promise that resolves to GSAP Tween instance
+     *
+     * @example
+     * ```typescript
+     * gsapPlugin.fadeIn(sprite, 1.0, {
+     *   ease: 'power2.out',
+     *   onComplete: () => console.log('Fade complete!')
+     * });
+     * ```
+     */
+    fadeIn(target: Container, duration?: number, vars?: gsap.TweenVars): Promise<gsap.core.Tween>;
+    /**
+     * Fade out a Container
+     * @param target Container to animate
+     * @param duration Animation duration in seconds
+     * @param vars Additional animation variables
+     * @returns Promise that resolves to GSAP Tween instance
+     */
+    fadeOut(target: Container, duration?: number, vars?: gsap.TweenVars): Promise<gsap.core.Tween>;
+    /**
+     * Scales in a container with a bounce effect.
+     *
+     * Starts from 0.5 scale and animates to original scale with back.out easing.
+     *
+     * @param target - Container to animate
+     * @param duration - Animation duration in seconds (default: 0.5)
+     * @param vars - Additional GSAP tween options
+     * @returns Promise that resolves to GSAP Tween instance
+     *
+     * @example
+     * ```typescript
+     * gsapPlugin.scaleIn(button, 0.3, {
+     *   delay: 0.5,
+     *   onComplete: () => button.interactive = true
+     * });
+     * ```
+     */
+    scaleIn(target: Container, duration?: number, vars?: gsap.TweenVars): Promise<gsap.core.Tween>;
+    /**
+     * Scale out a Container
+     * @param target Container to animate
+     * @param duration Animation duration in seconds
+     * @param vars Additional animation variables
+     * @returns Promise that resolves to GSAP Tween instance
+     */
+    scaleOut(target: Container, duration?: number, vars?: gsap.TweenVars): Promise<gsap.core.Tween>;
+    /**
+     * Moves a container to a new position.
+     *
+     * Animates x and y properties with power2.out easing.
+     *
+     * @param target - Container to animate
+     * @param x - Target x position
+     * @param y - Target y position
+     * @param duration - Animation duration in seconds (default: 0.5)
+     * @param vars - Additional GSAP tween options
+     * @returns Promise that resolves to GSAP Tween instance
+     *
+     * @example
+     * ```typescript
+     * gsapPlugin.moveTo(sprite, 400, 300, 1.0, {
+     *   ease: 'elastic.out',
+     *   onUpdate: () => console.log('Moving...')
+     * });
+     * ```
+     */
+    moveTo(target: Container, x: number, y: number, duration?: number, vars?: gsap.TweenVars): Promise<gsap.core.Tween>;
+    /**
+     * Animates any properties of an object.
+     *
+     * Generic animation method for custom property animations.
+     *
+     * @param target - Object to animate (Container, Sprite, or any object)
+     * @param props - Properties to animate with target values
+     * @param duration - Animation duration in seconds (default: 0.5)
+     * @param vars - Additional GSAP tween options
+     * @returns Promise that resolves to GSAP Tween instance
+     *
+     * @example
+     * ```typescript
+     * gsapPlugin.animate(sprite, {
+     *   rotation: Math.PI * 2,
+     *   alpha: 0.5,
+     *   scale: { x: 2, y: 2 }
+     * }, 2.0, {
+     *   ease: 'bounce.out'
+     * });
+     * ```
+     */
+    animate(target: gsap.TweenTarget, props: object, vars?: gsap.TweenVars): Promise<gsap.core.Tween>;
+    /**
+     * Creates a staggered sequence of animations.
+     *
+     * Executes multiple animations with a time delay between each.
+     *
+     * @param animations - Array of functions that return GSAP Tweens
+     * @param stagger - Time delay between each animation in seconds (default: 0.1)
+     * @returns Promise that resolves to GSAP Timeline instance
+     *
+     * @example
+     * ```typescript
+     * const items = [item1, item2, item3, item4];
+     *
+     * gsapPlugin.timeline(
+     *   items.map(item => () => gsapPlugin.fadeIn(item, 0.3)),
+     *   0.15  // 0.15s delay between each
+     * );
+     * ```
+     */
+    timeline(animations: Array<() => gsap.core.Tween>, stagger?: number): Promise<gsap.core.Timeline>;
+    /**
+     * Creates a delayed function call.
+     *
+     * Executes a callback after a specified delay.
+     *
+     * @param delay - Delay in seconds before executing the callback
+     * @param callback - Function to execute after the delay
+     * @param params - Optional parameters to pass to the callback
+     * @returns GSAP Tween instance (can be used to kill the delayed call)
+     *
+     * @example
+     * ```typescript
+     * // Simple delayed call
+     * gsapPlugin.delayedCall(2, () => console.log('2 seconds passed'));
+     *
+     * // With parameters
+     * gsapPlugin.delayedCall(1.5, (msg) => console.log(msg), ['Hello!']);
+     *
+     * // Store reference to cancel later
+     * const call = gsapPlugin.delayedCall(5, doSomething);
+     * call.kill(); // Cancel the delayed call
+     * ```
+     */
+    delayedCall(delay: number, callback: gsap.Callback, params?: any[]): gsap.core.Tween;
+    /**
+     * Waits for a duration using GSAP delayedCall.
+     * Respects engine pause/resume via GSAP ticker sleep/wake.
+     *
+     * @param duration - Delay in seconds
+     * @returns Promise that resolves after the delay
+     *
+     * @example
+     * ```typescript
+     * await gsapPlugin.delay(0.5);
+     * showPopup();
+     * ```
+     */
+    delay(duration: number): Promise<void>;
+}
+//# sourceMappingURL=GsapPlugin.d.ts.map

package/dist/plugins/gsap/GsapPlugin.d.ts.map

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

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

@@ -0,0 +1,2 @@
+export * from './GsapPlugin';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../plugins/gsap/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,13 @@
+export * from './device';
+export * from './resource';
+export * from './display';
+export * from './eventbus';
+export * from './gsap';
+export * from './input';
+export * from './language';
+export * from './scene';
+export * from './sentry';
+export * from './service';
+export * from './skin';
+export * from './sound';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../plugins/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}