@energy8platform/game-engine 0.15.1 → 0.16.0

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 import { Container, ApplicationOptions, Application, Texture, AnimatedSprite, Spritesheet, TextStyle, ColorSource } from 'pixi.js';
-import { CasinoGameSDK, InitData, GameConfigData, SessionData, PlayParams, PlayResultData } from '@energy8platform/game-sdk';
+import { CasinoGameSDK, InitData, GameConfigData, SessionData } from '@energy8platform/game-sdk';
 export { AnywhereWinData, BalanceData, BridgeDestroyedError, BridgeNotReadyError, GameConfigData, InitData, PaylineData, PlayParams, PlayResultData, SDKError, SessionData, SymbolData, TimeoutError, WinLineData } from '@energy8platform/game-sdk';
+import { LoadingScreenConfig, AssetManifest, PlatformSession } from '@energy8platform/platform-core';
+export { AssetBundle, AssetEntry, AssetManifest, LoadingScreenConfig } from '@energy8platform/platform-core';
+export { DevBridge, DevBridgeConfig } from '@energy8platform/platform-core/dev-bridge';
+export { ActionDefinition, GameDefinition, LuaEngineConfig, LuaPlayResult, TransitionRule } from '@energy8platform/platform-core/lua';
 
 declare enum ScaleMode {
     /** Fit inside container, maintain aspect ratio (letterbox/pillarbox) */
@@ -15,41 +19,7 @@ declare enum Orientation {
     PORTRAIT = "portrait",
     ANY = "any"
 }
-interface LoadingScreenConfig {
-    /** Background color (hex number or CSS string) */
-    backgroundColor?: number | string;
-    /** Background gradient (CSS string applied to the CSS preloader) */
-    backgroundGradient?: string;
-    /** Logo texture alias (must be in 'preload' bundle) */
-    logoAsset?: string;
-    /** Logo scale (default: 1) */
-    logoScale?: number;
-    /** Show percentage text below the loader bar */
-    showPercentage?: boolean;
-    /** Custom progress text formatter */
-    progressTextFormatter?: (progress: number) => string;
-    /** Show "Tap to start" after loading (needed for mobile audio unlock) */
-    tapToStart?: boolean;
-    /** "Tap to start" label text */
-    tapToStartText?: string;
-    /** Minimum display time in ms (so the user sees the brand, even if loading is fast) */
-    minDisplayTime?: number;
-    /** CSS preloader custom HTML (shown before PixiJS is ready) */
-    cssPreloaderHTML?: string;
-}
-interface AssetEntry {
-    alias: string;
-    src: string | string[];
-    /** Optional data to pass to the loader */
-    data?: Record<string, unknown>;
-}
-interface AssetBundle {
-    name: string;
-    assets: AssetEntry[];
-}
-interface AssetManifest {
-    bundles: AssetBundle[];
-}
+
 interface AudioConfig {
     /** Default volumes per category (0..1) */
     music?: number;
@@ -725,6 +695,8 @@ declare class GameApplication extends EventEmitter<GameEngineEvents> {
     fpsOverlay: FPSOverlay | null;
     /** Data received from SDK initialization */
     initData: InitData | null;
+    /** Platform session (SDK + optional DevBridge). null until start() runs. */
+    platformSession: PlatformSession | null;
     /** Configuration */
     readonly config: GameApplicationConfig;
     private _running;
@@ -2194,162 +2166,5 @@ declare class LoadingScene extends Scene {
     private transitionToGame;
 }
 
-interface GameDefinition {
-    id: string;
-    type: 'SLOT' | 'TABLE';
-    actions: Record<string, ActionDefinition>;
-    bet_levels?: number[] | BetLevelsConfig;
-    max_win?: MaxWinConfig;
-    buy_bonus?: BuyBonusConfig;
-    ante_bet?: AnteBetConfig;
-    persistent_state?: PersistentStateConfig;
-}
-interface BetLevelsConfig {
-    levels?: number[];
-    min?: number;
-    max?: number;
-}
-interface MaxWinConfig {
-    multiplier?: number;
-    fixed?: number;
-}
-interface BuyBonusConfig {
-    modes: Record<string, BuyBonusMode>;
-}
-interface BuyBonusMode {
-    cost_multiplier: number;
-    /** Distribution of forced scatter counts. Optional — if omitted, Lua script handles bonus setup itself. */
-    scatter_distribution?: Record<string, number>;
-    /** Optional description */
-    description?: string;
-}
-interface AnteBetConfig {
-    cost_multiplier: number;
-}
-interface PersistentStateConfig {
-    vars: string[];
-    exposed_vars: string[];
-}
-interface ActionDefinition {
-    stage: string;
-    debit: 'bet' | 'buy_bonus_cost' | 'ante_bet_cost' | 'none';
-    credit?: 'win' | 'none' | 'defer';
-    requires_session?: boolean;
-    buy_bonus_mode?: string;
-    transitions: TransitionRule[];
-    input_schema?: Record<string, unknown>;
-}
-interface TransitionRule {
-    condition: string;
-    creates_session?: boolean;
-    complete_session?: boolean;
-    credit_override?: 'defer';
-    next_actions: string[];
-    session_config?: SessionConfig;
-    add_spins_var?: string;
-}
-interface SessionConfig {
-    total_spins_var: string;
-    persistent_vars?: string[];
-}
-interface LuaEngineConfig {
-    /** Lua script source code */
-    script: string;
-    /** Platform game definition (actions, transitions, bet levels, etc.) */
-    gameDefinition: GameDefinition;
-    /** Seed for deterministic RNG (for simulation/replay) */
-    seed?: number;
-    /** Custom logger function */
-    logger?: (level: string, msg: string) => void;
-    /** Skip marshalling data fields (matrix, wins, etc.) for faster simulation */
-    simulationMode?: boolean;
-}
-interface LuaPlayResult {
-    totalWin: number;
-    data: Record<string, unknown>;
-    nextActions: string[];
-    session: SessionData | null;
-    variables: Record<string, number>;
-    creditDeferred: boolean;
-}
-
-interface DevBridgeConfig {
-    /** Mock initial balance */
-    balance?: number;
-    /** Mock currency */
-    currency?: string;
-    /** Game config */
-    gameConfig?: Partial<GameConfigData>;
-    /** Base URL for assets (default: '/assets/') */
-    assetsUrl?: string;
-    /** Active session to resume (null = no active session) */
-    session?: SessionData | null;
-    /** Custom play result handler — return mock result data */
-    onPlay?: (params: PlayParams) => Partial<PlayResultData>;
-    /** Simulated network delay in ms */
-    networkDelay?: number;
-    /** Enable debug logging */
-    debug?: boolean;
-    /** Lua script source code. When set, play requests are routed to the Vite dev server's LuaEngine. */
-    luaScript?: string;
-    /** Game definition for Lua engine (actions, transitions, etc.) */
-    gameDefinition?: GameDefinition;
-    /** RNG seed for deterministic Lua execution */
-    luaSeed?: number;
-}
-/**
- * Mock host bridge for local development.
- *
- * Uses the SDK's `Bridge` class in `devMode` to communicate with
- * `CasinoGameSDK` via a shared in-memory `MemoryChannel`, removing
- * the need for postMessage and iframes.
- *
- * When `luaScript` is set, play requests are sent to the Vite dev server
- * which runs LuaEngine in Node.js — no fengari in the browser.
- *
- * @example
- * ```ts
- * import { DevBridge } from '@energy8platform/game-engine/debug';
- *
- * const devBridge = new DevBridge({
- *   balance: 5000,
- *   currency: 'EUR',
- *   gameConfig: { id: 'my-slot', type: 'slot', betLevels: [0.2, 0.5, 1, 2] },
- *   onPlay: ({ action, bet }) => ({
- *     totalWin: Math.random() > 0.5 ? bet * (Math.random() * 20) : 0,
- *     data: { matrix: [[1,2,3],[4,5,6],[7,8,9]] },
- *   }),
- * });
- * devBridge.start();
- * ```
- */
-declare class DevBridge {
-    private _config;
-    private _balance;
-    private _roundCounter;
-    private _bridge;
-    private _useLuaServer;
-    constructor(config?: DevBridgeConfig);
-    /** Current mock balance */
-    get balance(): number;
-    /** Start listening for SDK messages */
-    start(): void;
-    /** Stop listening */
-    stop(): void;
-    /** Set mock balance */
-    setBalance(balance: number): void;
-    /** Destroy the dev bridge */
-    destroy(): void;
-    private handleGameReady;
-    private handlePlayRequest;
-    private executeLuaOnServer;
-    private buildFallbackResult;
-    private handlePlayAck;
-    private handleGetBalance;
-    private handleGetState;
-    private handleOpenDeposit;
-    private delayedSend;
-}
-
-export { AssetManager, AudioManager, BalanceDisplay, Button, DevBridge, Easing, EventEmitter, FPSOverlay, FlexContainer, GameApplication, InputManager, Label, Layout, LoadingScene, Modal, Orientation, Panel, ProgressBar, ScaleMode, Scene, SceneManager, ScrollContainer, SpineHelper, SpriteAnimation, StateMachine, Timeline, Toast, TransitionType, Tween, ViewportManager, WinDisplay };
-export type { ActionDefinition, AlignItems, AssetBundle, AssetEntry, AssetManifest, AudioConfig, BalanceDisplayConfig, ButtonConfig, ButtonState, DevBridgeConfig, EasingFunction, FlexContainerConfig, FlexDirection, FlexItemConfig, GameApplicationConfig, GameDefinition, GameEngineEvents, IScene, JustifyContent, LabelConfig, LayoutAlignment, LayoutAnchor, LayoutConfig, LayoutDirection, LoadingScreenConfig, LuaEngineConfig, LuaPlayResult, ModalConfig, PanelConfig, ProgressBarConfig, SceneConstructor, ScrollContainerConfig, ScrollDirection, SpriteAnimationConfig, ToastConfig, ToastType, TransitionConfig, TransitionRule, TweenOptions, WinDisplayConfig };
+export { AssetManager, AudioManager, BalanceDisplay, Button, Easing, EventEmitter, FPSOverlay, FlexContainer, GameApplication, InputManager, Label, Layout, LoadingScene, Modal, Orientation, Panel, ProgressBar, ScaleMode, Scene, SceneManager, ScrollContainer, SpineHelper, SpriteAnimation, StateMachine, Timeline, Toast, TransitionType, Tween, ViewportManager, WinDisplay };
+export type { AlignItems, AudioConfig, BalanceDisplayConfig, ButtonConfig, ButtonState, EasingFunction, FlexContainerConfig, FlexDirection, FlexItemConfig, GameApplicationConfig, GameEngineEvents, IScene, JustifyContent, LabelConfig, LayoutAlignment, LayoutAnchor, LayoutConfig, LayoutDirection, ModalConfig, PanelConfig, ProgressBarConfig, SceneConstructor, ScrollContainerConfig, ScrollDirection, SpriteAnimationConfig, ToastConfig, ToastType, TransitionConfig, TweenOptions, WinDisplayConfig };