@energy8platform/game-engine 0.21.0 → 0.22.0

package/dist/react.d.ts

@@ -1,1467 +0,0 @@
-import { Texture, Container, TextStyle, ColorSource, ApplicationOptions, Application } from 'pixi.js';
-import * as react from 'react';
-import { ReactElement } from 'react';
-import * as _energy8platform_platform_core_shell from '@energy8platform/platform-core/shell';
-import { LoadingScreenConfig, AssetManifest, PlatformSession } from '@energy8platform/platform-core';
-import { CasinoGameSDK, InitData, GameConfigData, SessionData } from '@energy8platform/game-sdk';
-
-/**
- * Universal view input type for UI component visual slots.
- *
- * - `string` — texture name, resolved via `Sprite.from()`
- * - `Texture` — wrapped in a `Sprite`
- * - `Container` — used as-is (Sprite, Graphics, NineSliceSprite, AnimatedSprite, custom...)
- */
-type ViewInput = string | Texture | Container;
-
-type ButtonState = 'default' | 'hover' | 'pressed' | 'disabled';
-interface ButtonConfig {
-    /** Custom view for default state (string texture name, Texture, or Container) */
-    defaultView?: ViewInput;
-    /** Custom view for hover state */
-    hoverView?: ViewInput;
-    /** Custom view for pressed state */
-    pressedView?: ViewInput;
-    /** Custom view for disabled state */
-    disabledView?: ViewInput;
-    /** Width (for Graphics-based button, ignored when custom views provided) */
-    width?: number;
-    /** Height (for Graphics-based button) */
-    height?: number;
-    /** Corner radius (for Graphics-based button) */
-    borderRadius?: number;
-    /** Colors for each state (for Graphics-based button) */
-    colors?: Partial<Record<ButtonState, number>>;
-    /** Scale on press */
-    pressScale?: number;
-    /** Scale animation duration (ms) */
-    animationDuration?: number;
-    /** Start disabled */
-    disabled?: boolean;
-    /** Button text (rendered on top of the view) */
-    text?: string;
-    /** Button text style */
-    textStyle?: Record<string, unknown>;
-    /** Press callback */
-    onPress?: () => void;
-}
-
-interface LabelConfig {
-    text?: string;
-    style?: Partial<TextStyle>;
-    /** Maximum width — text will be scaled down to fit */
-    maxWidth?: number;
-    /** Auto-fit: scale text to fit maxWidth */
-    autoFit?: boolean;
-}
-
-type FlexDirection = 'row' | 'column';
-type JustifyContent = 'start' | 'center' | 'end' | 'space-between' | 'space-around';
-type AlignItems = 'start' | 'center' | 'end' | 'stretch';
-type AlignContent = 'start' | 'center' | 'end' | 'space-between' | 'stretch';
-type AlignSelf = 'auto' | 'start' | 'center' | 'end' | 'stretch';
-interface FlexContainerConfig {
-    /** Layout direction (default: 'row') */
-    direction?: FlexDirection;
-    /** Main-axis distribution (default: 'start') */
-    justifyContent?: JustifyContent;
-    /** Cross-axis alignment (default: 'start') */
-    alignItems?: AlignItems;
-    /** Gap between children in pixels (default: 0) */
-    gap?: number;
-    /** Padding [top, right, bottom, left] or single number (default: 0) */
-    padding?: number | [number, number, number, number];
-    /** Individual padding overrides (take priority over `padding`) */
-    paddingTop?: number;
-    paddingRight?: number;
-    paddingBottom?: number;
-    paddingLeft?: number;
-    /** Enable wrapping to next line (default: false) */
-    flexWrap?: boolean;
-    /** Distribution of lines along the cross axis when wrapping (default: 'start') */
-    alignContent?: AlignContent;
-    /** Maximum width before wrapping (only with flexWrap) */
-    maxWidth?: number;
-    /** Maximum height before wrapping (only with flexWrap + column) */
-    maxHeight?: number;
-    /** Explicit container width — number in pixels, or string percentage (e.g. "50%") resolved against parent */
-    width?: number | string;
-    /** Explicit container height — number in pixels, or string percentage (e.g. "50%") resolved against parent */
-    height?: number | string;
-}
-
-type LabelValueAlign = 'start' | 'center' | 'end';
-interface LabelValueConfig {
-    /** Caption text (top row, typically smaller/muted) */
-    label?: string;
-    /** Value text (bottom row, typically larger/prominent) */
-    value?: string;
-    /** Style for the caption Label */
-    labelStyle?: Partial<TextStyle>;
-    /** Style for the value Label */
-    valueStyle?: Partial<TextStyle>;
-    /** Gap in pixels between caption and value (default: 4) */
-    gap?: number;
-    /** Horizontal alignment of both rows (default: 'center') */
-    align?: LabelValueAlign;
-    /** Maximum width — value will be auto-scaled to fit when exceeded */
-    maxWidth?: number;
-    /** Optional padding (forwarded to the underlying FlexContainer) */
-    padding?: FlexContainerConfig['padding'];
-}
-
-interface PanelConfig {
-    /** Width */
-    width?: number;
-    /** Height */
-    height?: number;
-    /** Background color (for Graphics-based panel) */
-    backgroundColor?: number;
-    /** Background alpha */
-    backgroundAlpha?: number;
-    /** Corner radius */
-    borderRadius?: number;
-    /** Border color */
-    borderColor?: number;
-    /** Border width */
-    borderWidth?: number;
-    /** 9-slice texture (if provided, uses NineSliceSprite instead of Graphics) */
-    nineSliceTexture?: string | Texture;
-    /** 9-slice borders [left, top, right, bottom] */
-    nineSliceBorders?: [number, number, number, number];
-    /** Padding inside the panel */
-    padding?: number;
-    /** Flex layout config for content */
-    layout?: Partial<FlexContainerConfig>;
-}
-
-interface ProgressBarConfig {
-    /** Width of the bar */
-    width?: number;
-    /** Height of the bar */
-    height?: number;
-    /** Corner radius (for Graphics-based bar) */
-    borderRadius?: number;
-    /** Fill color (for Graphics-based bar, ignored when fillView provided) */
-    fillColor?: number;
-    /** Track background color (for Graphics-based bar, ignored when trackView provided) */
-    trackColor?: number;
-    /** Border color */
-    borderColor?: number;
-    /** Border width */
-    borderWidth?: number;
-    /** Animated fill (smoothly interpolate) */
-    animated?: boolean;
-    /** Animation speed (0..1 per frame, default: 0.1) */
-    animationSpeed?: number;
-    /** Custom track background (string texture name, Texture, or Container) */
-    trackView?: ViewInput;
-    /** Custom fill bar (string texture name, Texture, or Container) */
-    fillView?: ViewInput;
-}
-
-type ScrollDirection = 'vertical' | 'horizontal' | 'both';
-interface ScrollContainerConfig {
-    /** Visible viewport width */
-    width: number;
-    /** Visible viewport height */
-    height: number;
-    /** Scroll direction (default: 'vertical') */
-    direction?: ScrollDirection;
-    /** Background color (undefined = transparent) */
-    backgroundColor?: ColorSource;
-    /** Border radius for the mask (default: 0) */
-    borderRadius?: number;
-    /** Gap between items (default: 0) */
-    elementsMargin?: number;
-    /** Padding */
-    padding?: number;
-    /** Disable easing/inertia */
-    disableEasing?: boolean;
-    /** Show scrollbar indicator (default: false) */
-    scrollbar?: boolean;
-    /** Custom scrollbar thumb view (string texture name, Texture, or Container) */
-    thumbView?: ViewInput;
-    /** Scrollbar width in px (default: 6) */
-    scrollbarWidth?: number;
-    /** Scrollbar padding from edge (default: 4) */
-    scrollbarPadding?: number;
-    /** Scrollbar color (when no thumbView, default: 0xaaaaaa) */
-    scrollbarColor?: number;
-    /** Scrollbar alpha (default: 0.5) */
-    scrollbarAlpha?: number;
-}
-
-interface ModalConfig {
-    /** Overlay color */
-    overlayColor?: number;
-    /** Overlay alpha */
-    overlayAlpha?: number;
-    /** Close on overlay tap */
-    closeOnOverlay?: boolean;
-    /** Animation duration */
-    animationDuration?: number;
-}
-
-interface ToastConfig {
-    /** Auto-dismiss after this many ms (0 = manual dismiss only) */
-    duration?: number;
-    /** Toast position from bottom */
-    bottomOffset?: number;
-    /** Custom background view (string texture name, Texture, or Container). Sized to fit text. */
-    backgroundView?: ViewInput;
-}
-
-interface BalanceDisplayConfig {
-    /** Label prefix (e.g., "BALANCE") */
-    prefix?: string;
-    /** Text style overrides */
-    style?: Record<string, unknown>;
-    /** Currency code */
-    currency?: string;
-    /** Locale for number formatting */
-    locale?: string;
-    /** Max width */
-    maxWidth?: number;
-    /** Animate value changes */
-    animated?: boolean;
-    /** Animation duration in ms */
-    animationDuration?: number;
-}
-
-interface WinDisplayConfig {
-    /** Text style overrides */
-    style?: Record<string, unknown>;
-    /** Currency code */
-    currency?: string;
-    /** Locale for number formatting */
-    locale?: string;
-    /** Countup duration in ms */
-    countupDuration?: number;
-    /** Scale pop animation on win */
-    popScale?: number;
-}
-
-type LayoutDirection = 'horizontal' | 'vertical' | 'grid' | 'wrap';
-type LayoutAlignment = 'start' | 'center' | 'end' | 'stretch';
-type LayoutAnchor = 'top-left' | 'top-center' | 'top-right' | 'center-left' | 'center' | 'center-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
-interface LayoutConfig {
-    /** Layout direction (default: 'vertical') */
-    direction?: LayoutDirection;
-    /** Gap between children in pixels (default: 0) */
-    gap?: number;
-    /** Padding inside the layout container [top, right, bottom, left] or a single number */
-    padding?: number | [number, number, number, number];
-    /** Alignment of children on the cross axis (default: 'start') */
-    alignment?: LayoutAlignment;
-    /** Anchor point determining where the layout is positioned relative to its coordinates */
-    anchor?: LayoutAnchor;
-    /** Number of columns (only for 'grid' direction) */
-    columns?: number;
-    /** Maximum width for 'wrap' direction before wrapping to next line */
-    maxWidth?: number;
-    /** Whether to auto-layout when children change (default: true) */
-    autoLayout?: boolean;
-    /** Breakpoints: map of max viewport widths to override configs */
-    breakpoints?: Record<number, Partial<LayoutConfig>>;
-}
-
-interface SliderConfig {
-    /** Minimum value (default: 0) */
-    min?: number;
-    /** Maximum value (default: 1) */
-    max?: number;
-    /** Step increment (0 = continuous, default: 0) */
-    step?: number;
-    /** Initial value (default: min) */
-    value?: number;
-    /** Track width in pixels (default: 200) */
-    width?: number;
-    /** Track height in pixels (default: 8) */
-    height?: number;
-    /** Corner radius for Graphics-based track/fill (default: 4) */
-    borderRadius?: number;
-    /** Track background color (ignored when trackView provided) */
-    trackColor?: number;
-    /** Fill bar color (ignored when fillView provided) */
-    fillColor?: number;
-    /** Handle radius (for Graphics-based handle, default: 12) */
-    handleRadius?: number;
-    /** Handle color (for Graphics-based handle, ignored when handleView provided) */
-    handleColor?: number;
-    /** Custom track background view */
-    trackView?: ViewInput;
-    /** Custom fill bar view */
-    fillView?: ViewInput;
-    /** Custom handle view */
-    handleView?: ViewInput;
-    /** Called when value changes during drag */
-    onUpdate?: (value: number) => void;
-    /** Called when drag ends */
-    onChange?: (value: number) => void;
-}
-
-interface ToggleConfig {
-    /** Initial state (default: false) */
-    value?: boolean;
-    /** Custom view for the ON state */
-    onView?: ViewInput;
-    /** Custom view for the OFF state */
-    offView?: ViewInput;
-    /** Width (for Graphics-based toggle, default: 52) */
-    width?: number;
-    /** Height (for Graphics-based toggle, default: 28) */
-    height?: number;
-    /** Track color when ON (ignored when custom views provided) */
-    onColor?: number;
-    /** Track color when OFF (ignored when custom views provided) */
-    offColor?: number;
-    /** Handle color (for Graphics-based toggle) */
-    handleColor?: number;
-    /** Handle radius (for Graphics-based toggle, default: auto) */
-    handleRadius?: number;
-    /** Animation duration in ms (default: 200) */
-    animationDuration?: number;
-    /** Called when value changes */
-    onChange?: (value: boolean) => void;
-}
-
-/**
- * JSX prop types for the PixiJS React reconciler.
- *
- * The engine auto-augments `react`'s module-scoped `JSX.IntrinsicElements`
- * with every registered element (`<flexContainer>`, `<button>`, `<label>`,
- * `<labelValue>`, etc). Because the augmentation is scoped to the `react`
- * module (not the legacy global `JSX` namespace), it reliably wins over
- * `@types/react`'s HTML defaults for colliding names like `<button>` / `<label>`.
- *
- * **Consumers don't need any shim.** Any import from `@energy8platform/game-engine/react`
- * (e.g. `createPixiRoot`, `extendUIElements`, `ReactScene` — you're already
- * importing these to boot the reconciler) pulls this module in and the JSX
- * types activate automatically.
- *
- * If a project imports only from `/ui` or `/core` and never touches `/react`,
- * add a one-line side-effect import to trigger the augmentation:
- *
- * ```ts
- * // app/src/pixi-jsx.d.ts
- * import '@energy8platform/game-engine/react-jsx';
- * ```
- *
- * Dash-notation for nested config objects is supported:
- *   <button colors-default={0xff0000} colors-hover={0x00ff00} />
- */
-
-interface PixiEventProps {
-    onClick?: (e: any) => void;
-    onPointerDown?: (e: any) => void;
-    onPointerUp?: (e: any) => void;
-    onPointerMove?: (e: any) => void;
-    onPointerOver?: (e: any) => void;
-    onPointerOut?: (e: any) => void;
-    onPointerEnter?: (e: any) => void;
-    onPointerLeave?: (e: any) => void;
-    onPointerCancel?: (e: any) => void;
-    onPointerTap?: (e: any) => void;
-    onPointerUpOutside?: (e: any) => void;
-    onMouseDown?: (e: any) => void;
-    onMouseUp?: (e: any) => void;
-    onMouseMove?: (e: any) => void;
-    onMouseOver?: (e: any) => void;
-    onMouseOut?: (e: any) => void;
-    onWheel?: (e: any) => void;
-    onTap?: (e: any) => void;
-    onRightClick?: (e: any) => void;
-}
-interface BaseProps extends PixiEventProps {
-    key?: React.Key;
-    ref?: React.Ref<any>;
-    children?: React.ReactNode;
-    x?: number;
-    y?: number;
-    width?: number;
-    height?: number;
-    alpha?: number;
-    visible?: boolean;
-    rotation?: number;
-    angle?: number;
-    zIndex?: number;
-    label?: string;
-    cursor?: string;
-    eventMode?: 'auto' | 'none' | 'passive' | 'static' | 'dynamic';
-    'scale-x'?: number;
-    'scale-y'?: number;
-    'pivot-x'?: number;
-    'pivot-y'?: number;
-    'position-x'?: number;
-    'position-y'?: number;
-    'anchor-x'?: number;
-    'anchor-y'?: number;
-    scale?: number | {
-        x: number;
-        y: number;
-    };
-    flexGrow?: number;
-    flexShrink?: number;
-    layoutWidth?: number | string;
-    layoutHeight?: number | string;
-    alignSelf?: AlignSelf;
-    flexExclude?: boolean;
-    top?: number;
-    right?: number;
-    bottom?: number;
-    left?: number;
-    /** X coordinate of the visual center within parent (px or `'50%'`). Overrides left/right. */
-    centerX?: number | string;
-    /** Y coordinate of the visual center within parent (px or `'50%'`). Overrides top/bottom. */
-    centerY?: number | string;
-}
-interface SpriteProps extends BaseProps {
-    texture?: string | Texture;
-    anchor?: number | {
-        x: number;
-        y: number;
-    };
-    tint?: number;
-}
-interface TextProps extends BaseProps {
-    text?: string;
-    style?: Partial<TextStyle>;
-    anchor?: number | {
-        x: number;
-        y: number;
-    };
-    'style-fontSize'?: number;
-    'style-fill'?: number | string;
-    'style-fontFamily'?: string;
-    'style-fontWeight'?: string;
-    'style-letterSpacing'?: number;
-}
-interface GraphicsProps extends BaseProps {
-    /** Draw function: receives the Graphics instance, called on mount and updates */
-    draw?: (g: any) => void;
-    /**
-     * Layout size hint (pixels). For Graphics, `width`/`height` do NOT apply a scale
-     * transform (unlike Container.width). They're forwarded to the parent
-     * FlexContainer as `layoutWidth`/`layoutHeight` so layout measures the element
-     * at the requested size while the actual geometry stays in the `draw` callback.
-     */
-    width?: number;
-    height?: number;
-}
-interface AnimatedSpriteProps extends BaseProps {
-    textures?: Texture[];
-    animationSpeed?: number;
-    loop?: boolean;
-    playing?: boolean;
-}
-interface NineSliceSpriteProps extends BaseProps {
-    texture?: string | Texture;
-    leftWidth?: number;
-    topHeight?: number;
-    rightWidth?: number;
-    bottomHeight?: number;
-}
-interface TilingSpriteProps extends BaseProps {
-    texture?: string | Texture;
-    tilePosition?: {
-        x: number;
-        y: number;
-    };
-}
-interface ButtonComponentProps extends BaseProps, Omit<ButtonConfig, 'colors' | 'textStyle'> {
-    colors?: Partial<Record<ButtonState, number>>;
-    textStyle?: Record<string, unknown>;
-    defaultView?: ViewInput;
-    hoverView?: ViewInput;
-    pressedView?: ViewInput;
-    disabledView?: ViewInput;
-    'colors-default'?: number;
-    'colors-hover'?: number;
-    'colors-pressed'?: number;
-    'colors-disabled'?: number;
-    'textStyle-fontSize'?: number;
-    'textStyle-fill'?: number | string;
-    'textStyle-fontFamily'?: string;
-    'textStyle-fontWeight'?: string;
-    'textStyle-fontStyle'?: string;
-    'textStyle-letterSpacing'?: number;
-    onPress?: () => void;
-}
-interface LabelComponentProps extends BaseProps, Omit<LabelConfig, 'style'> {
-    style?: Partial<TextStyle>;
-    'style-fontSize'?: number;
-    'style-fill'?: number | string;
-    'style-fontFamily'?: string;
-    'style-fontWeight'?: string;
-    'style-letterSpacing'?: number;
-}
-interface LabelValueComponentProps extends Omit<BaseProps, 'width' | 'height' | 'label'>, Omit<LabelValueConfig, 'labelStyle' | 'valueStyle'> {
-    labelStyle?: Partial<TextStyle>;
-    valueStyle?: Partial<TextStyle>;
-    width?: number | string;
-    height?: number | string;
-    'labelStyle-fontSize'?: number;
-    'labelStyle-fill'?: number | string;
-    'labelStyle-fontFamily'?: string;
-    'labelStyle-fontWeight'?: string;
-    'valueStyle-fontSize'?: number;
-    'valueStyle-fill'?: number | string;
-    'valueStyle-fontFamily'?: string;
-    'valueStyle-fontWeight'?: string;
-}
-interface PanelComponentProps extends BaseProps, Omit<PanelConfig, 'layout'> {
-    layout?: Partial<FlexContainerConfig>;
-}
-interface FlexContainerComponentProps extends Omit<BaseProps, 'width' | 'height'>, FlexContainerConfig {
-    padding?: number | [number, number, number, number];
-    paddingTop?: number;
-    paddingRight?: number;
-    paddingBottom?: number;
-    paddingLeft?: number;
-    alignContent?: AlignContent;
-    width?: number | string;
-    height?: number | string;
-}
-interface ProgressBarComponentProps extends BaseProps, ProgressBarConfig {
-    progress?: number;
-    /** Custom track background (string texture name, Texture, or Container) */
-    trackView?: ViewInput;
-    /** Custom fill bar */
-    fillView?: ViewInput;
-}
-interface ScrollContainerComponentProps extends BaseProps, Omit<ScrollContainerConfig, 'width' | 'height'> {
-    width: number;
-    height: number;
-    /** Show scrollbar indicator */
-    scrollbar?: boolean;
-    /** Custom scrollbar thumb view */
-    thumbView?: ViewInput;
-    scrollbarWidth?: number;
-    scrollbarPadding?: number;
-    scrollbarColor?: number;
-    scrollbarAlpha?: number;
-}
-interface ModalComponentProps extends BaseProps, ModalConfig {
-    onClose?: () => void;
-}
-interface ToastComponentProps extends BaseProps, ToastConfig {
-    /** Custom background view */
-    backgroundView?: ViewInput;
-}
-interface BalanceDisplayComponentProps extends BaseProps, BalanceDisplayConfig {
-    /** Current balance value */
-    value?: number;
-}
-interface WinDisplayComponentProps extends BaseProps, WinDisplayConfig {
-}
-interface LayoutComponentProps extends BaseProps, LayoutConfig {
-}
-interface SliderComponentProps extends BaseProps, Omit<SliderConfig, 'width' | 'height'> {
-    width?: number;
-    height?: number;
-    onUpdate?: (value: number) => void;
-    onChange?: (value: number) => void;
-}
-interface ToggleComponentProps extends BaseProps, Omit<ToggleConfig, 'width' | 'height'> {
-    width?: number;
-    height?: number;
-    onView?: ViewInput;
-    offView?: ViewInput;
-    onChange?: (value: boolean) => void;
-}
-/**
- * Complete element → prop-type map for all engine-registered JSX elements.
- * Also consumable directly for typing custom wrappers around engine elements.
- */
-interface EngineIntrinsicElements {
-    container: BaseProps;
-    sprite: SpriteProps;
-    text: TextProps;
-    graphics: GraphicsProps;
-    animatedSprite: AnimatedSpriteProps;
-    nineSliceSprite: NineSliceSpriteProps;
-    tilingSprite: TilingSpriteProps;
-    button: ButtonComponentProps;
-    label: LabelComponentProps;
-    labelValue: LabelValueComponentProps;
-    panel: PanelComponentProps;
-    flexContainer: FlexContainerComponentProps;
-    progressBar: ProgressBarComponentProps;
-    scrollContainer: ScrollContainerComponentProps;
-    modal: ModalComponentProps;
-    toast: ToastComponentProps;
-    balanceDisplay: BalanceDisplayComponentProps;
-    winDisplay: WinDisplayComponentProps;
-    layout: LayoutComponentProps;
-    slider: SliderComponentProps;
-    toggle: ToggleComponentProps;
-}
-declare module 'react' {
-    namespace JSX {
-        interface IntrinsicElements extends EngineIntrinsicElements {
-        }
-    }
-}
-
-interface PixiRoot {
-    render(element: ReactElement): void;
-    unmount(): void;
-}
-declare function createPixiRoot(container: Container): PixiRoot;
-
-/**
- * Register PixiJS classes for use as JSX elements.
- * Keys must be PascalCase; JSX uses the camelCase equivalent.
- *
- * @example
- * ```ts
- * import { Container, Sprite, Text } from 'pixi.js';
- * extend({ Container, Sprite, Text });
- * // Now <container>, <sprite>, <text> work in JSX
- * ```
- */
-declare function extend(components: Record<string, any>): void;
-
-/**
- * Register all standard PixiJS display objects for JSX use.
- * Call once at app startup before rendering any React scenes.
- */
-declare function extendPixiElements(): void;
-/**
- * Register all engine UI components for JSX use.
- * Call once at app startup before rendering React scenes that use UI components.
- *
- * @example
- * ```ts
- * extendPixiElements();
- * extendUIElements();
- *
- * // Now you can use:
- * // <button text="SPIN" onPress={handler} />
- * // <flexContainer direction="row" gap={16}>...</flexContainer>
- * // <label text="Hello" style-fontSize={24} />
- * ```
- */
-declare function extendUIElements(): void;
-/**
- * Register additional custom components for JSX use.
- * Pass an object mapping component names to their constructors.
- */
-declare function extendCustomElements(components: Record<string, any>): void;
-
-declare enum ScaleMode {
-    /** Fit inside container, maintain aspect ratio (letterbox/pillarbox) */
-    FIT = "FIT",
-    /** Fill container, maintain aspect ratio (crop edges) */
-    FILL = "FILL",
-    /** Stretch to fill (distorts) */
-    STRETCH = "STRETCH"
-}
-declare enum Orientation {
-    LANDSCAPE = "landscape",
-    PORTRAIT = "portrait",
-    ANY = "any"
-}
-
-interface AudioConfig {
-    /** Default volumes per category (0..1) */
-    music?: number;
-    sfx?: number;
-    ui?: number;
-    ambient?: number;
-    /** Persist mute state in localStorage */
-    persist?: boolean;
-    /** LocalStorage key prefix */
-    storageKey?: string;
-}
-interface GameApplicationConfig {
-    /** Container element or CSS selector to mount canvas into */
-    container?: HTMLElement | string;
-    /** Reference design width (fallback: GameConfigData.viewport.width or 1920) */
-    designWidth?: number;
-    /** Reference design height (fallback: GameConfigData.viewport.height or 1080) */
-    designHeight?: number;
-    /** How to scale the game to fit the container */
-    scaleMode?: ScaleMode;
-    /** Preferred orientation */
-    orientation?: Orientation;
-    /** Loading screen configuration */
-    loading?: LoadingScreenConfig;
-    /** Asset manifest — what to load */
-    manifest?: AssetManifest;
-    /** Audio configuration */
-    audio?: AudioConfig;
-    /** SDK options. Set to false to disable SDK (offline/development mode) */
-    sdk?: {
-        parentOrigin?: string;
-        timeout?: number;
-        debug?: boolean;
-        /** Use in-memory channel instead of postMessage (no iframe required) */
-        devMode?: boolean;
-    } | false;
-    /** PixiJS Application options (pass-through) */
-    pixi?: Partial<ApplicationOptions>;
-    /** Enable debug overlay (FPS, draw calls) */
-    debug?: boolean;
-    /** When set, GameApplication mounts the branded game shell after the SDK handshake. */
-    shell?: _energy8platform_platform_core_shell.ShellConfig | false;
-}
-interface SceneConstructor {
-    new (): IScene;
-    [key: string]: any;
-}
-interface IScene {
-    /** Root display container for this scene */
-    readonly container: Container;
-    /** @internal GameApplication reference — set by SceneManager */
-    __engineApp?: any;
-    /** Called when the scene is entered */
-    onEnter?(data?: unknown): Promise<void> | void;
-    /** Called when the scene is exited */
-    onExit?(): Promise<void> | void;
-    /** Called every frame */
-    onUpdate?(dt: number): void;
-    /** Called when viewport resizes */
-    onResize?(width: number, height: number): void;
-    /** Called when the scene is destroyed */
-    onDestroy?(): void;
-}
-declare enum TransitionType {
-    NONE = "none",
-    FADE = "fade",
-    SLIDE_LEFT = "slide-left",
-    SLIDE_RIGHT = "slide-right"
-}
-interface TransitionConfig {
-    type: TransitionType;
-    duration?: number;
-    easing?: (t: number) => number;
-}
-interface GameEngineEvents {
-    /** Fired when engine initialization is complete */
-    initialized: void;
-    /** Fired when all assets are loaded */
-    loaded: void;
-    /** Fired when the engine starts running */
-    started: void;
-    /** Fired on viewport resize */
-    resize: {
-        width: number;
-        height: number;
-    };
-    /** Fired on orientation change */
-    orientationChange: Orientation;
-    /** Fired on scene change */
-    sceneChange: {
-        from: string | null;
-        to: string;
-    };
-    /** Fired when player balance changes (forwarded from SDK) */
-    balanceUpdate: {
-        balance: number;
-    };
-    /** Fired on error */
-    error: Error;
-    /** Fired when engine is destroyed */
-    destroyed: void;
-}
-
-/**
- * Base class for all scenes.
- * Provides a root PixiJS Container and lifecycle hooks.
- *
- * @example
- * ```ts
- * class MenuScene extends Scene {
- *   async onEnter() {
- *     const bg = Sprite.from('menu-bg');
- *     this.container.addChild(bg);
- *   }
- *
- *   onUpdate(dt: number) {
- *     // per-frame logic
- *   }
- *
- *   onResize(width: number, height: number) {
- *     // reposition UI
- *   }
- * }
- * ```
- */
-declare abstract class Scene implements IScene {
-    readonly container: Container;
-    constructor();
-    /** Called when this scene becomes active. Override in subclass. */
-    onEnter?(data?: unknown): Promise<void> | void;
-    /** Called when this scene is deactivated. Override in subclass. */
-    onExit?(): Promise<void> | void;
-    /** Called every frame with delta time (in seconds). Override in subclass. */
-    onUpdate?(dt: number): void;
-    /** Called when the viewport resizes. Override in subclass. */
-    onResize?(width: number, height: number): void;
-    /** Cleanup — called when the scene is permanently removed. */
-    onDestroy?(): void;
-}
-
-/**
- * Minimal typed event emitter.
- * Used internally by GameApplication, SceneManager, AudioManager, etc.
- *
- * Supports `void` event types — events that carry no data can be emitted
- * without arguments: `emitter.emit('eventName')`.
- */
-declare class EventEmitter<TEvents extends {}> {
-    private listeners;
-    on<K extends keyof TEvents>(event: K, handler: (data: TEvents[K]) => void): this;
-    once<K extends keyof TEvents>(event: K, handler: (data: TEvents[K]) => void): this;
-    off<K extends keyof TEvents>(event: K, handler: (data: TEvents[K]) => void): this;
-    emit<K extends keyof TEvents>(...args: TEvents[K] extends void ? [event: K] : [event: K, data: TEvents[K]]): void;
-    removeAllListeners(event?: keyof TEvents): this;
-}
-
-interface SceneEntry {
-    scene: IScene;
-    key: string;
-}
-interface SceneManagerEvents {
-    change: {
-        from: string | null;
-        to: string;
-    };
-}
-/**
- * Manages the scene stack and transitions between scenes.
- *
- * @example
- * ```ts
- * const scenes = new SceneManager(app.stage);
- * scenes.register('loading', LoadingScene);
- * scenes.register('game', GameScene);
- * await scenes.goto('loading');
- * ```
- */
-declare class SceneManager extends EventEmitter<SceneManagerEvents> {
-    private static MAX_TRANSITION_DEPTH;
-    /** Root container that scenes are added to */
-    root: Container;
-    private registry;
-    private stack;
-    private _transitionDepth;
-    /** Current viewport dimensions — set by ViewportManager */
-    private _width;
-    private _height;
-    /** @internal GameApplication reference — passed to scenes */
-    private _app;
-    constructor(root?: Container);
-    /** @internal Set the root container (called by GameApplication after PixiJS init) */
-    setRoot(root: Container): void;
-    /** @internal Set the app reference (called by GameApplication) */
-    setApp(app: any): void;
-    /** Register a scene class by key */
-    register(key: string, ctor: SceneConstructor): this;
-    /** Get the current (topmost) scene entry */
-    get current(): SceneEntry | null;
-    /** Get the current scene key */
-    get currentKey(): string | null;
-    /** Whether a scene transition is in progress */
-    get isTransitioning(): boolean;
-    /**
-     * Navigate to a scene, replacing the entire stack.
-     */
-    goto(key: string, data?: unknown, transition?: TransitionConfig): Promise<void>;
-    /**
-     * Push a scene onto the stack (the previous scene stays underneath).
-     * Useful for overlays, modals, pause screens.
-     */
-    push(key: string, data?: unknown, transition?: TransitionConfig): Promise<void>;
-    /**
-     * Pop the top scene from the stack.
-     */
-    pop(transition?: TransitionConfig): Promise<void>;
-    /**
-     * Replace the top scene with a new one.
-     */
-    replace(key: string, data?: unknown, transition?: TransitionConfig): Promise<void>;
-    /**
-     * Called every frame by GameApplication.
-     */
-    update(dt: number): void;
-    /**
-     * Called on viewport resize.
-     */
-    resize(width: number, height: number): void;
-    /**
-     * Destroy all scenes and clear the manager.
-     */
-    destroy(): void;
-    private createScene;
-    private pushInternal;
-    private popInternal;
-    private transitionIn;
-    private transitionOut;
-}
-
-/**
- * Manages game asset loading with progress tracking, bundle support, and
- * automatic base path resolution from SDK's assetsUrl.
- *
- * Wraps PixiJS Assets API with a typed, game-oriented interface.
- *
- * @example
- * ```ts
- * const assets = new AssetManager('https://cdn.example.com/game/', manifest);
- * await assets.init();
- * await assets.loadBundle('preload', (p) => console.log(p));
- * const texture = assets.get<Texture>('hero');
- * ```
- */
-declare class AssetManager {
-    private _initialized;
-    private _basePath;
-    private _manifest;
-    private _loadedBundles;
-    constructor(basePath?: string, manifest?: AssetManifest);
-    /** Whether the asset system has been initialized */
-    get initialized(): boolean;
-    /** Base path for all assets (usually from SDK's assetsUrl) */
-    get basePath(): string;
-    /** Set of loaded bundle names */
-    get loadedBundles(): ReadonlySet<string>;
-    /**
-     * Initialize the asset system.
-     * Must be called before loading any assets.
-     */
-    init(): Promise<void>;
-    /**
-     * Load a single bundle by name.
-     *
-     * @param name - Bundle name (must exist in the manifest)
-     * @param onProgress - Progress callback (0..1)
-     * @returns Loaded assets map
-     */
-    loadBundle(name: string, onProgress?: (progress: number) => void): Promise<Record<string, unknown>>;
-    /**
-     * Load multiple bundles simultaneously.
-     * Progress is aggregated across all bundles.
-     *
-     * @param names - Bundle names
-     * @param onProgress - Progress callback (0..1)
-     */
-    loadBundles(names: string[], onProgress?: (progress: number) => void): Promise<Record<string, unknown>>;
-    /**
-     * Load individual assets by URL or alias.
-     *
-     * @param urls - Asset URLs or aliases
-     * @param onProgress - Progress callback (0..1)
-     */
-    load<T = unknown>(urls: string | string[], onProgress?: (progress: number) => void): Promise<T>;
-    /**
-     * Get a loaded asset synchronously from cache.
-     *
-     * @param alias - Asset alias
-     * @throws if not loaded
-     */
-    get<T = unknown>(alias: string): T;
-    /**
-     * Unload a bundle to free memory.
-     */
-    unloadBundle(name: string): Promise<void>;
-    /**
-     * Start background loading a bundle (low-priority preload).
-     * Useful for loading bonus round assets while player is in base game.
-     */
-    backgroundLoad(name: string): Promise<void>;
-    /**
-     * Get all bundle names from the manifest.
-     */
-    getBundleNames(): string[];
-    /**
-     * Check if a bundle is loaded.
-     */
-    isBundleLoaded(name: string): boolean;
-    private ensureInitialized;
-}
-
-type AudioCategoryName = 'music' | 'sfx' | 'ui' | 'ambient';
-/**
- * Manages all game audio: music, SFX, UI sounds, ambient.
- *
- * Optional dependency on @pixi/sound — if not installed, AudioManager
- * operates as a silent no-op (graceful degradation).
- *
- * Features:
- * - Per-category volume control (music, sfx, ui, ambient)
- * - Music crossfade and looping
- * - Mobile audio unlock on first interaction
- * - Mute state persistence in localStorage
- * - Global mute/unmute
- *
- * @example
- * ```ts
- * const audio = new AudioManager({ music: 0.5, sfx: 0.8 });
- * await audio.init();
- * audio.playMusic('bg-music');
- * audio.play('spin-click', 'sfx');
- * ```
- */
-declare class AudioManager {
-    private _soundModule;
-    private _initialized;
-    private _globalMuted;
-    private _persist;
-    private _storageKey;
-    private _categories;
-    private _masterGain;
-    private _currentMusic;
-    private _unlocked;
-    private _unlockHandler;
-    constructor(config?: AudioConfig);
-    /** Whether the audio system is initialized */
-    get initialized(): boolean;
-    /** Whether audio is globally muted */
-    get muted(): boolean;
-    /**
-     * Initialize the audio system.
-     * Dynamically imports @pixi/sound to keep it optional.
-     */
-    init(): Promise<void>;
-    /**
-     * Play a sound effect.
-     *
-     * @param alias - Sound alias (must be loaded via AssetManager)
-     * @param category - Audio category (default: 'sfx')
-     * @param options - Additional play options
-     */
-    play(alias: string, category?: AudioCategoryName, options?: {
-        volume?: number;
-        loop?: boolean;
-        speed?: number;
-    }): void;
-    /**
-     * Play background music with optional crossfade.
-     *
-     * @param alias - Music alias
-     * @param fadeDuration - Crossfade duration in ms (default: 500)
-     */
-    playMusic(alias: string, fadeDuration?: number): void;
-    /**
-     * Stop current music.
-     */
-    stopMusic(): void;
-    /**
-     * Stop all sounds.
-     */
-    stopAll(): void;
-    /** Global gain (0..1) folded into every category's effective volume. Driven by the shell's
-     *  'master' settingChange. Does not affect the persisted per-category volumes. */
-    setMasterVolume(volume: number): void;
-    getMasterVolume(): number;
-    /**
-     * Set volume for a category.
-     */
-    setVolume(category: AudioCategoryName, volume: number): void;
-    /**
-     * Get volume for a category.
-     */
-    getVolume(category: AudioCategoryName): number;
-    /**
-     * Mute a specific category.
-     */
-    muteCategory(category: AudioCategoryName): void;
-    /**
-     * Unmute a specific category.
-     */
-    unmuteCategory(category: AudioCategoryName): void;
-    /**
-     * Toggle mute for a category.
-     */
-    toggleCategory(category: AudioCategoryName): boolean;
-    /**
-     * Mute all audio globally.
-     */
-    muteAll(): void;
-    /**
-     * Unmute all audio globally.
-     */
-    unmuteAll(): void;
-    /**
-     * Toggle global mute.
-     */
-    toggleMute(): boolean;
-    /**
-     * Duck music volume (e.g., during big win presentation).
-     *
-     * @param factor - Volume multiplier (0..1), e.g. 0.3 = 30% of normal
-     */
-    duckMusic(factor: number): void;
-    /**
-     * Restore music to normal volume after ducking.
-     */
-    unduckMusic(): void;
-    /**
-     * Destroy the audio manager and free resources.
-     */
-    destroy(): void;
-    /**
-     * Smoothly fade a sound's volume from `fromVol` to `toVol` over `durationMs`.
-     */
-    private fadeVolume;
-    private applyVolumes;
-    private setupMobileUnlock;
-    private removeMobileUnlock;
-    private saveState;
-    private restoreState;
-}
-
-interface InputEvents {
-    tap: {
-        x: number;
-        y: number;
-    };
-    press: {
-        x: number;
-        y: number;
-    };
-    release: {
-        x: number;
-        y: number;
-    };
-    move: {
-        x: number;
-        y: number;
-    };
-    swipe: {
-        direction: 'up' | 'down' | 'left' | 'right';
-        velocity: number;
-    };
-    keydown: {
-        key: string;
-        code: string;
-    };
-    keyup: {
-        key: string;
-        code: string;
-    };
-}
-/**
- * Unified input manager for touch, mouse, and keyboard.
- *
- * Features:
- * - Unified pointer events (works with touch + mouse)
- * - Swipe gesture detection
- * - Keyboard input with isKeyDown state
- * - Input locking (block input during animations)
- *
- * @example
- * ```ts
- * const input = new InputManager(app.canvas);
- *
- * input.on('tap', ({ x, y }) => console.log('Tapped at', x, y));
- * input.on('swipe', ({ direction }) => console.log('Swiped', direction));
- * input.on('keydown', ({ key }) => {
- *   if (key === ' ') spin();
- * });
- *
- * // Block input during animations
- * input.lock();
- * await playAnimation();
- * input.unlock();
- * ```
- */
-declare class InputManager extends EventEmitter<InputEvents> {
-    private _canvas;
-    private _locked;
-    private _keysDown;
-    private _destroyed;
-    private _viewportScale;
-    private _viewportOffsetX;
-    private _viewportOffsetY;
-    private _pointerStart;
-    private _swipeThreshold;
-    private _swipeMaxTime;
-    constructor(canvas: HTMLCanvasElement);
-    /** Whether input is currently locked */
-    get locked(): boolean;
-    /** Lock all input (e.g., during animations) */
-    lock(): void;
-    /** Unlock input */
-    unlock(): void;
-    /** Check if a key is currently pressed */
-    isKeyDown(key: string): boolean;
-    /**
-     * Update the viewport transform used for DOM→world coordinate mapping.
-     * Called automatically by GameApplication when ViewportManager emits resize.
-     */
-    setViewportTransform(scale: number, offsetX: number, offsetY: number): void;
-    /**
-     * Convert a DOM canvas position to game-world coordinates,
-     * accounting for viewport scaling and offset.
-     */
-    getWorldPosition(canvasX: number, canvasY: number): {
-        x: number;
-        y: number;
-    };
-    /** Destroy the input manager */
-    destroy(): void;
-    private setupPointerEvents;
-    private onPointerDown;
-    private onPointerUp;
-    private onPointerMove;
-    private getCanvasPosition;
-    private setupKeyboardEvents;
-    private onKeyDown;
-    private onKeyUp;
-}
-
-interface ViewportConfig {
-    designWidth: number;
-    designHeight: number;
-    scaleMode: ScaleMode;
-    orientation: Orientation;
-}
-interface ViewportEvents {
-    resize: {
-        width: number;
-        height: number;
-        scale: number;
-    };
-    orientationChange: Orientation;
-}
-/**
- * Manages responsive scaling of the game canvas to fit its container.
- *
- * Supports three scale modes:
- * - **FIT** — letterbox/pillarbox to maintain aspect ratio (industry standard)
- * - **FILL** — fill container, crop edges
- * - **STRETCH** — stretch to fill (distorts)
- *
- * Also handles:
- * - Orientation detection (landscape/portrait)
- * - Safe areas (mobile notch)
- * - ResizeObserver for smooth container resizing
- *
- * @example
- * ```ts
- * const viewport = new ViewportManager(app, container, {
- *   designWidth: 1920,
- *   designHeight: 1080,
- *   scaleMode: ScaleMode.FIT,
- *   orientation: Orientation.LANDSCAPE,
- * });
- *
- * viewport.on('resize', ({ width, height, scale }) => {
- *   console.log(`New size: ${width}x${height} @ ${scale}x`);
- * });
- * ```
- */
-declare class ViewportManager extends EventEmitter<ViewportEvents> {
-    private _app;
-    private _container;
-    private _config;
-    private _target;
-    private _resizeObserver;
-    private _currentOrientation;
-    private _currentWidth;
-    private _currentHeight;
-    private _currentScale;
-    private _destroyed;
-    private _resizeTimeout;
-    constructor(app: Application, container: HTMLElement, config: ViewportConfig, target?: Container);
-    /** Current canvas width in game units */
-    get width(): number;
-    /** Current canvas height in game units */
-    get height(): number;
-    /** Current scale factor */
-    get scale(): number;
-    /** Current orientation */
-    get orientation(): Orientation;
-    /** Design reference width */
-    get designWidth(): number;
-    /** Design reference height */
-    get designHeight(): number;
-    /**
-     * Force a resize calculation. Called automatically on container size change.
-     */
-    refresh(): void;
-    /**
-     * Destroy the viewport manager.
-     */
-    destroy(): void;
-    private setupObserver;
-    private onWindowResize;
-    private debouncedRefresh;
-}
-
-/**
- * FPS overlay for debugging performance.
- *
- * Shows FPS, frame time, and draw call count in the corner of the screen.
- *
- * @example
- * ```ts
- * const fps = new FPSOverlay(app);
- * fps.show();
- * ```
- */
-declare class FPSOverlay {
-    private _app;
-    private _container;
-    private _fpsText;
-    private _visible;
-    private _samples;
-    private _maxSamples;
-    private _lastUpdate;
-    private _tickFn;
-    constructor(app: Application);
-    /** Show the FPS overlay */
-    show(): void;
-    /** Hide the FPS overlay */
-    hide(): void;
-    /** Toggle visibility */
-    toggle(): void;
-    /** Destroy the overlay */
-    destroy(): void;
-}
-
-/**
- * The main entry point for a game built on @energy8platform/game-engine.
- *
- * Orchestrates the full lifecycle:
- * 1. Create PixiJS Application
- * 2. Initialize SDK (or run offline)
- * 3. Show CSS preloader → Canvas loading screen with progress bar
- * 4. Load asset manifest
- * 5. Transition to the first game scene
- *
- * @example
- * ```ts
- * import { GameApplication, ScaleMode } from '@energy8platform/game-engine';
- * import { GameScene } from './scenes/GameScene';
- *
- * const game = new GameApplication({
- *   container: '#game',
- *   designWidth: 1920,
- *   designHeight: 1080,
- *   scaleMode: ScaleMode.FIT,
- *   manifest: { bundles: [
- *     { name: 'preload', assets: [{ alias: 'logo', src: 'logo.png' }] },
- *     { name: 'game', assets: [{ alias: 'bg', src: 'background.png' }] },
- *   ]},
- *   loading: { tapToStart: true },
- * });
- *
- * game.scenes.register('game', GameScene);
- * await game.start('game');
- * ```
- */
-declare class GameApplication extends EventEmitter<GameEngineEvents> {
-    /** PixiJS Application instance */
-    app: Application;
-    /** Scene manager */
-    scenes: SceneManager;
-    /** Asset manager */
-    assets: AssetManager;
-    /** Audio manager */
-    audio: AudioManager;
-    /** Input manager */
-    input: InputManager;
-    /** Viewport manager */
-    viewport: ViewportManager;
-    /** Scaled world root (holds scenes). Transformed by the ViewportManager to fit the design
-     *  resolution; lives below the UI layer on app.stage. */
-    worldRoot: Container;
-    /** Unscaled, screen-space UI layer. Sits above {@link worldRoot} and is NOT touched by the
-     *  viewport transform — children fill the real screen (e.g. the host's shell + overlay). */
-    uiLayer: Container;
-    /** SDK instance (null in offline mode) */
-    sdk: CasinoGameSDK | null;
-    /** FPS overlay instance (only when debug: true) */
-    fpsOverlay: FPSOverlay | null;
-    /** Data received from SDK initialization */
-    initData: InitData | null;
-    /** Platform session (SDK + optional DevBridge). null until start() runs. */
-    platformSession: PlatformSession | null;
-    /** Branded game shell (only when config.shell is set). */
-    shell?: _energy8platform_platform_core_shell.GameShell;
-    /** Configuration */
-    readonly config: GameApplicationConfig;
-    private _running;
-    private _destroyed;
-    private _container;
-    constructor(config?: GameApplicationConfig);
-    /** Current game config from SDK (or null in offline mode) */
-    get gameConfig(): GameConfigData | null;
-    /** Current session data */
-    get session(): SessionData | null;
-    /** Current balance */
-    get balance(): number;
-    /** Current currency */
-    get currency(): string;
-    /** Whether the engine is running */
-    get isRunning(): boolean;
-    /**
-     * Start the game engine. This is the main entry point.
-     *
-     * @param firstScene - Key of the first scene to show after loading (must be registered)
-     * @param sceneData - Optional data to pass to the first scene's onEnter
-     */
-    start(firstScene: string, sceneData?: unknown): Promise<void>;
-    /**
-     * Destroy the engine and free all resources.
-     */
-    destroy(): Promise<void>;
-    private resolveContainer;
-    private initPixi;
-    private initSDK;
-    private applySDKConfig;
-    private initSubSystems;
-    private loadAssets;
-}
-
-declare abstract class ReactScene extends Scene {
-    private _pixiRoot;
-    private _contextValue;
-    /** Subclasses implement this to return their React element tree. */
-    abstract render(): ReactElement;
-    /** Access the GameApplication instance. */
-    protected getApp(): GameApplication;
-    onEnter(data?: unknown): Promise<void>;
-    onExit(): Promise<void>;
-    onResize(width: number, height: number): void;
-    onDestroy(): void;
-    private _mountReactTree;
-}
-
-interface EngineContextValue {
-    app: GameApplication;
-    sdk: CasinoGameSDK | null;
-    audio: AudioManager;
-    input: InputManager;
-    viewport: ViewportManager;
-    gameConfig: GameConfigData | null;
-    screen: {
-        width: number;
-        height: number;
-        scale: number;
-    };
-    isPortrait: boolean;
-}
-declare const EngineContext: react.Context<EngineContextValue | null>;
-declare function useEngine(): EngineContextValue;
-
-declare function useSDK(): CasinoGameSDK | null;
-declare function useAudio(): AudioManager;
-declare function useInput(): InputManager;
-declare function useViewport(): {
-    width: number;
-    height: number;
-    scale: number;
-    isPortrait: boolean;
-};
-declare function useBalance(): number;
-declare function useSession(): SessionData | null;
-declare function useGameConfig<T = GameConfigData>(): T | null;
-
-export { EngineContext, ReactScene, createPixiRoot, extend, extendCustomElements, extendPixiElements, extendUIElements, useAudio, useBalance, useEngine, useGameConfig, useInput, useSDK, useSession, useViewport };
-export type { EngineContextValue, PixiRoot };