toaimin-indie-engine 1.0.0

package/dist/scene/Blackboard.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Persistent cross-scene observable data store.
+ * Supports typed gets/sets, atomic increments, boolean toggles, change observers,
+ * and JSON / LocalStorage serialization.
+ */
+export declare class Blackboard {
+    private _data;
+    private _emitter;
+    /**
+     * Set a key-value pair and notify registered listeners.
+     */
+    set<T = any>(key: string, value: T): this;
+    /**
+     * Get a stored value with optional fallback default.
+     */
+    get<T = any>(key: string, defaultValue?: T): T;
+    /**
+     * Check if key exists in the store.
+     */
+    has(key: string): boolean;
+    /**
+     * Remove a key and notify listeners with value undefined.
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all entries.
+     */
+    clear(): void;
+    /**
+     * Atomic numeric increment.
+     * If key does not exist, defaults to 0 and adds delta.
+     * @returns Updated numeric value.
+     */
+    increment(key: string, delta?: number): number;
+    /**
+     * Atomic numeric decrement.
+     * @returns Updated numeric value.
+     */
+    decrement(key: string, delta?: number): number;
+    /**
+     * Atomic boolean toggle.
+     * If key does not exist, treats current as false and sets to true.
+     * @returns Updated boolean value.
+     */
+    toggle(key: string): boolean;
+    /**
+     * Subscribe to value changes for a specific key.
+     * @returns Disposer function that unsubscribes the listener when called.
+     */
+    onChange<T = any>(key: string, callback: (value: T, oldValue: T | undefined) => void): () => void;
+    /**
+     * Subscribe to all value changes across the entire store.
+     * @returns Disposer function that unsubscribes the listener when called.
+     */
+    onAnyChange(callback: (key: string, value: any, oldValue: any) => void): () => void;
+    /**
+     * Export all data as a plain JavaScript record.
+     */
+    toObject(): Record<string, any>;
+    /**
+     * Bulk load key-values from a record.
+     */
+    fromObject(data: Record<string, any>): this;
+    /**
+     * Serialize state to JSON string.
+     */
+    serialize(): string;
+    /**
+     * Deserialize state from JSON string.
+     */
+    deserialize(json: string): this;
+    /**
+     * Save store to browser localStorage.
+     */
+    saveToLocalStorage(storageKey: string): boolean;
+    /**
+     * Load store from browser localStorage.
+     */
+    loadFromLocalStorage(storageKey: string): boolean;
+}
+//# sourceMappingURL=Blackboard.d.ts.map

package/dist/scene/Blackboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Blackboard.d.ts","sourceRoot":"","sources":["../../src/scene/Blackboard.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,QAAQ,CAAwD;IAExE;;OAEG;IACI,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAgBhD;;OAEG;IACI,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC;IAOrD;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAanC;;OAEG;IACI,KAAK,IAAI,IAAI;IAMpB;;;;OAIG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM;IAOxD;;;OAGG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM;IAIxD;;;;OAIG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAOnC;;;OAGG;IACI,QAAQ,CAAC,CAAC,GAAG,GAAG,EACrB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,GACpD,MAAM,IAAI;IAOb;;;OAGG;IACI,WAAW,CAChB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,GACzD,MAAM,IAAI;IAOb;;OAEG;IACI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAQtC;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAQlD;;OAEG;IACI,SAAS,IAAI,MAAM;IAI1B;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAUtC;;OAEG;IACI,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAUtD;;OAEG;IACI,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;CAazD"}

package/dist/scene/Scene.d.ts

@@ -0,0 +1,160 @@
+import type { Camera2D } from '../rendering/Camera2D';
+import type { Blackboard } from './Blackboard';
+import type { SceneManager } from './SceneManager';
+/**
+ * Lifecycle states of a scene.
+ */
+export declare enum SceneState {
+    UNINITIALIZED = "UNINITIALIZED",
+    INACTIVE = "INACTIVE",
+    ENTERING = "ENTERING",
+    ACTIVE = "ACTIVE",
+    PAUSED = "PAUSED",
+    EXITING = "EXITING",
+    DESTROYED = "DESTROYED"
+}
+/**
+ * Public interface contract for all framework scenes.
+ */
+export interface IScene<TGame = any> {
+    /** Unique registered name of the scene */
+    name: string;
+    /** Reference to the game orchestrator / context */
+    game: TGame;
+    /** Reference to the SceneManager managing this scene */
+    sceneManager: SceneManager<TGame>;
+    /** Reference to the shared cross-scene Blackboard */
+    blackboard: Blackboard;
+    /** Current lifecycle state */
+    state: SceneState;
+    /** Whether the scene has completed init() */
+    initialized: boolean;
+    /** Whether the scene is currently the top active scene */
+    active: boolean;
+    /** Whether the scene is currently paused beneath a modal overlay */
+    paused: boolean;
+    /**
+     * If true, underlying scenes on the modal stack will be rendered
+     * beneath this scene (e.g. for pause menus or semi-transparent overlays).
+     * Default: false.
+     */
+    renderUnderlying: boolean;
+    /** Optional active Camera2D reference for scene rendering */
+    camera: Camera2D | null;
+    /**
+     * One-time initialization. Called when scene is added or first loaded.
+     * Use for preloading assets, initializing pools, and configuring entities.
+     */
+    init(game: TGame): void | Promise<void>;
+    /**
+     * Called whenever the scene becomes active on the stack.
+     * @param data Optional payload passed via switchTo() or push().
+     */
+    enter(data?: any): void | Promise<void>;
+    /**
+     * Variable logic update called every frame.
+     * @param dt Scaled delta time in seconds.
+     */
+    update(dt: number): void;
+    /**
+     * Deterministic fixed timestep update called at constant rate (e.g. 60Hz).
+     * @param dt Fixed timestep in seconds.
+     */
+    fixedUpdate?(dt: number): void;
+    /**
+     * Render pass called once per display frame.
+     * @param ctx CanvasRenderingContext2D or framework CanvasContext / Renderer.
+     */
+    render(ctx: CanvasRenderingContext2D | any): void;
+    /**
+     * Called when another scene is pushed on top of this scene in the modal stack.
+     */
+    pause?(): void;
+    /**
+     * Called when a modal scene on top is popped and this scene resumes being active.
+     * @param data Optional result data passed from pop().
+     */
+    resume?(data?: any): void;
+    /**
+     * Called when switching away from this scene or popping it off the stack.
+     */
+    exit(): void | Promise<void>;
+    /**
+     * Final teardown. Releases GPU textures, unbinds global listeners, clears state.
+     */
+    destroy(): void;
+}
+/**
+ * Abstract base class providing default lifecycle implementations,
+ * scene-local key-value state, and convenient engine hooks.
+ */
+export declare abstract class Scene<TGame = any> implements IScene<TGame> {
+    name: string;
+    game: TGame;
+    sceneManager: SceneManager<TGame>;
+    blackboard: Blackboard;
+    state: SceneState;
+    renderUnderlying: boolean;
+    camera: Camera2D | null;
+    protected _localState: Map<string, any>;
+    get initialized(): boolean;
+    get active(): boolean;
+    get paused(): boolean;
+    /**
+     * One-time initialization.
+     */
+    init(game: TGame): void | Promise<void>;
+    /**
+     * Called on entering the scene.
+     */
+    enter(data?: any): void | Promise<void>;
+    /**
+     * Variable frame logic update.
+     */
+    update(dt: number): void;
+    /**
+     * Deterministic fixed timestep physics/simulation update.
+     */
+    fixedUpdate(dt: number): void;
+    /**
+     * Render loop pass.
+     */
+    render(ctx: CanvasRenderingContext2D | any): void;
+    /**
+     * Modal pause hook.
+     */
+    pause(): void;
+    /**
+     * Modal resume hook.
+     */
+    resume(data?: any): void;
+    /**
+     * Exit hook called when leaving the scene.
+     */
+    exit(): void | Promise<void>;
+    /**
+     * Teardown and resource cleanup.
+     */
+    destroy(): void;
+    /**
+     * Set a scene-local state value.
+     */
+    setLocal<T = any>(key: string, value: T): void;
+    /**
+     * Get a scene-local state value with optional fallback default.
+     */
+    getLocal<T = any>(key: string, defaultValue?: T): T;
+    /**
+     * Check if a scene-local state key exists.
+     */
+    hasLocal(key: string): boolean;
+    /**
+     * Remove a scene-local state key.
+     */
+    deleteLocal(key: string): boolean;
+    /**
+     * Clear all scene-local state.
+     */
+    clearLocal(): void;
+}
+//# sourceMappingURL=Scene.d.ts.map

package/dist/scene/Scene.d.ts.map

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

package/dist/scene/SceneManager.d.ts

@@ -0,0 +1,142 @@
+import { EventEmitter } from '../core/EventEmitter';
+import { Blackboard } from './Blackboard';
+import { IScene } from './Scene';
+import { SceneTransition } from './SceneTransition';
+export type SceneConstructor<TGame = any> = new () => IScene<TGame>;
+export type SceneEntry<TGame = any> = IScene<TGame> | SceneConstructor<TGame>;
+/**
+ * Events emitted by SceneManager.
+ */
+export interface SceneManagerEvents {
+    'scene:added': {
+        name: string;
+        scene: IScene;
+    };
+    'scene:removed': {
+        name: string;
+    };
+    'scene:change': {
+        from: string | null;
+        to: string;
+        data?: any;
+    };
+    'scene:pushed': {
+        name: string;
+        depth: number;
+        data?: any;
+    };
+    'scene:popped': {
+        name: string;
+        depth: number;
+        result?: any;
+    };
+    'transition:start': {
+        type: string;
+        from: string | null;
+        to: string;
+        duration: number;
+    };
+    'transition:complete': {
+        type: string;
+        from: string | null;
+        to: string;
+    };
+}
+/**
+ * Production-grade Scene Lifecycle & Modal Stack Manager.
+ */
+export declare class SceneManager<TGame = any> {
+    readonly game: TGame;
+    readonly blackboard: Blackboard;
+    readonly events: EventEmitter<SceneManagerEvents>;
+    private _registry;
+    private _instances;
+    private _stack;
+    private _previousScene;
+    private _activeTransition;
+    private _transitionFromScene;
+    private _transitionToScene;
+    private _pendingSwitchData;
+    constructor(game?: TGame);
+    /**
+     * Register a scene by name. Supports both instantiated instances and class constructors.
+     */
+    add(name: string, scene: SceneEntry<TGame>): this;
+    /**
+     * Check if a scene is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Remove a registered scene. If scene is active or on stack, it is exited and destroyed.
+     */
+    remove(name: string): boolean;
+    /**
+     * Get an instantiated scene by name, instantiating lazily if needed.
+     */
+    get(name: string): IScene<TGame> | undefined;
+    /**
+     * Return a list of all registered scene names.
+     */
+    getSceneNames(): string[];
+    /**
+     * Currently active scene (top of stack).
+     */
+    get currentScene(): IScene<TGame> | null;
+    /**
+     * Scene that was active prior to the latest switch.
+     */
+    get previousScene(): IScene<TGame> | null;
+    /**
+     * Number of scenes currently in the modal stack.
+     */
+    get stackDepth(): number;
+    /**
+     * Read-only view of the current scene stack (bottom to top).
+     */
+    getStack(): readonly IScene<TGame>[];
+    /**
+     * Whether a visual scene transition is actively animating.
+     */
+    get isTransitioning(): boolean;
+    /**
+     * Currently executing scene transition, if any.
+     */
+    get activeTransition(): SceneTransition | null;
+    /**
+     * Switch directly to a scene, clearing the existing modal stack.
+     * Supports smooth visual transitions.
+     */
+    switchTo(name: string, transition?: SceneTransition, data?: any): boolean;
+    /**
+     * Push a modal scene onto the stack (e.g. Pause Menu, Inventory overlay).
+     * Pauses the underlying scene.
+     */
+    push(name: string, transition?: SceneTransition, data?: any): boolean;
+    /**
+     * Pop the top modal scene off the stack and resume the underlying scene.
+     * @param transition Optional transition out.
+     * @param popResult Optional result data passed to underlying scene's resume(data).
+     */
+    pop(transition?: SceneTransition, popResult?: any): IScene<TGame> | null;
+    /**
+     * Execute variable logic update for active scenes.
+     */
+    update(dt: number): void;
+    /**
+     * Execute deterministic fixed timestep update for active scenes.
+     */
+    fixedUpdate(dt: number): void;
+    /**
+     * Render active scenes with modal stack composition and transition blending.
+     */
+    render(ctx: CanvasRenderingContext2D | any): void;
+    /**
+     * Teardown all scenes and reset manager.
+     */
+    destroy(): void;
+    private _bindSceneMetadata;
+    private _ensureSceneInitialized;
+    private _executeDirectSwitch;
+    private _finishTransition;
+}
+//# sourceMappingURL=SceneManager.d.ts.map

package/dist/scene/SceneManager.d.ts.map

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

package/dist/scene/SceneTransition.d.ts

@@ -0,0 +1,118 @@
+import type { IScene } from './Scene';
+/**
+ * Standard easing function signature: maps progress t in [0, 1] to eased value.
+ */
+export type EasingFunction = (t: number) => number;
+/**
+ * Built-in easing functions for smooth scene transitions.
+ */
+export declare const Easing: {
+    readonly linear: (t: number) => number;
+    readonly easeInQuad: (t: number) => number;
+    readonly easeOutQuad: (t: number) => number;
+    readonly easeInOutQuad: (t: number) => number;
+    readonly easeInCubic: (t: number) => number;
+    readonly easeOutCubic: (t: number) => number;
+    readonly easeInOutCubic: (t: number) => number;
+    readonly smoothstep: (t: number) => number;
+};
+/**
+ * Base transition configuration options.
+ */
+export interface TransitionOptions {
+    /** Duration of transition in seconds (default: 0.5s) */
+    duration?: number;
+    /** Easing function to apply to progress (default: Easing.linear) */
+    easing?: EasingFunction;
+}
+/**
+ * Abstract base class for all scene visual transitions.
+ */
+export declare abstract class SceneTransition {
+    duration: number;
+    elapsed: number;
+    progress: number;
+    isComplete: boolean;
+    easing: EasingFunction;
+    /**
+     * If true, transition has a distinct midpoint (e.g. Fade to solid color)
+     * where the actual scene switch takes place.
+     */
+    readonly hasMidpoint: boolean;
+    midpointTriggered: boolean;
+    constructor(options?: TransitionOptions);
+    /**
+     * Reset transition timers and flags before starting.
+     */
+    reset(): void;
+    /**
+     * Initialize transition for a specific scene pairing.
+     */
+    start(_fromScene: IScene | null, _toScene: IScene | null): void;
+    /**
+     * Advance transition time and calculate eased progress.
+     */
+    update(dt: number): void;
+    /**
+     * Render the transitioning visual state.
+     */
+    abstract render(ctx: CanvasRenderingContext2D | any, fromScene: IScene | null, toScene: IScene | null): void;
+    /**
+     * Helper to retrieve canvas logical dimensions.
+     */
+    protected getCanvasDimensions(ctx: any): {
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Options for FadeTransition.
+ */
+export interface FadeTransitionOptions extends TransitionOptions {
+    /** Fade color (default: '#000000' black) */
+    color?: string;
+}
+/**
+ * Two-phase solid color fade transition:
+ * Phase 1 (0 -> 50%): fades fromScene to color.
+ * Midpoint (50%): scenes swap.
+ * Phase 2 (50% -> 100%): fades color to toScene.
+ */
+export declare class FadeTransition extends SceneTransition {
+    readonly hasMidpoint: boolean;
+    readonly color: string;
+    constructor(options?: FadeTransitionOptions);
+    render(ctx: CanvasRenderingContext2D | any, fromScene: IScene | null, toScene: IScene | null): void;
+}
+/**
+ * Slide transition directions and presentation modes.
+ */
+export type SlideDirection = 'left' | 'right' | 'up' | 'down';
+export type SlideMode = 'push' | 'cover' | 'reveal';
+export interface SlideTransitionOptions extends TransitionOptions {
+    direction?: SlideDirection;
+    mode?: SlideMode;
+}
+/**
+ * Slide transition translating scenes across screen boundaries.
+ */
+export declare class SlideTransition extends SceneTransition {
+    readonly direction: SlideDirection;
+    readonly mode: SlideMode;
+    constructor(options?: SlideTransitionOptions);
+    render(ctx: CanvasRenderingContext2D | any, fromScene: IScene | null, toScene: IScene | null): void;
+}
+/**
+ * CrossFade transition blending transparency directly between scenes.
+ */
+export declare class CrossFadeTransition extends SceneTransition {
+    render(ctx: CanvasRenderingContext2D | any, fromScene: IScene | null, toScene: IScene | null): void;
+}
+/**
+ * Instantaneous scene switch with 0s duration.
+ */
+export declare class InstantTransition extends SceneTransition {
+    constructor();
+    render(ctx: CanvasRenderingContext2D | any, _fromScene: IScene | null, toScene: IScene | null): void;
+}
+//# sourceMappingURL=SceneTransition.d.ts.map

package/dist/scene/SceneTransition.d.ts.map

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

package/dist/scene/index.d.ts

@@ -0,0 +1,5 @@
+export * from './Scene';
+export * from './SceneTransition';
+export * from './Blackboard';
+export * from './SceneManager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scene/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/ui/UIAnchor.d.ts

@@ -0,0 +1,31 @@
+import { Vector2 } from '../math/Vector2';
+/**
+ * Standard 9-point normalized anchor presets for responsive canvas UI layout.
+ * Values range from 0.0 to 1.0.
+ */
+export declare const UIAnchor: {
+    readonly TopLeft: Readonly<Vector2>;
+    readonly TopCenter: Readonly<Vector2>;
+    readonly TopRight: Readonly<Vector2>;
+    readonly CenterLeft: Readonly<Vector2>;
+    readonly Center: Readonly<Vector2>;
+    readonly CenterRight: Readonly<Vector2>;
+    readonly BottomLeft: Readonly<Vector2>;
+    readonly BottomCenter: Readonly<Vector2>;
+    readonly BottomRight: Readonly<Vector2>;
+};
+/**
+ * Standard 9-point normalized pivot presets for local element alignment.
+ */
+export declare const UIPivot: {
+    readonly TopLeft: Readonly<Vector2>;
+    readonly TopCenter: Readonly<Vector2>;
+    readonly TopRight: Readonly<Vector2>;
+    readonly CenterLeft: Readonly<Vector2>;
+    readonly Center: Readonly<Vector2>;
+    readonly CenterRight: Readonly<Vector2>;
+    readonly BottomLeft: Readonly<Vector2>;
+    readonly BottomCenter: Readonly<Vector2>;
+    readonly BottomRight: Readonly<Vector2>;
+};
+//# sourceMappingURL=UIAnchor.d.ts.map

package/dist/ui/UIAnchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIAnchor.d.ts","sourceRoot":"","sources":["../../src/ui/UIAnchor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;CAUX,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;CAUV,CAAC"}

package/dist/ui/UIButton.d.ts

@@ -0,0 +1,48 @@
+import { UIElement, UIElementOptions, UIPointerEvent } from './UIElement';
+import { Rect } from '../math/Rect';
+import { Color } from '../math/Color';
+import { UILabel } from './UILabel';
+export declare enum UIButtonState {
+    Normal = "normal",
+    Hover = "hover",
+    Pressed = "pressed",
+    Disabled = "disabled"
+}
+export interface UIButtonStyle {
+    backgroundColor?: string | Color;
+    borderColor?: string | Color;
+    borderWidth?: number;
+    textColor?: string | Color;
+}
+export interface UIButtonOptions extends UIElementOptions {
+    text?: string;
+    fontSize?: number;
+    fontFamily?: string;
+    textColor?: string | Color;
+    borderRadius?: number;
+    stateStyles?: Partial<Record<UIButtonState, UIButtonStyle>>;
+    onHover?: (button: UIButton, isHovered: boolean) => void;
+}
+/**
+ * Production-grade Interactive Button with 4-state visual machine,
+ * hover/pressed feedback, pointer absorption, and optional embedded label.
+ */
+export declare class UIButton extends UIElement {
+    state: UIButtonState;
+    borderRadius: number;
+    label: UILabel | null;
+    stateStyles: Record<UIButtonState, UIButtonStyle>;
+    onHover?: (button: UIButton, isHovered: boolean) => void;
+    private _isHovered;
+    private _isPressed;
+    constructor(options?: UIButtonOptions);
+    set disabled(value: boolean);
+    get disabled(): boolean;
+    handlePointerEnter(event: UIPointerEvent): void;
+    handlePointerLeave(event: UIPointerEvent): void;
+    handlePointerDown(event: UIPointerEvent): void;
+    handlePointerUp(event: UIPointerEvent): void;
+    private _syncLabelColor;
+    protected draw(raw: any, localBounds: Rect): void;
+}
+//# sourceMappingURL=UIButton.d.ts.map

package/dist/ui/UIButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIButton.d.ts","sourceRoot":"","sources":["../../src/ui/UIButton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,oBAAY,aAAa;IACvB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC5B;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,SAAS;IAC9B,KAAK,EAAE,aAAa,CAAwB;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,GAAG,IAAI,CAAQ;IAC7B,WAAW,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IAElD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAEhE,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,UAAU,CAAkB;gBAExB,OAAO,GAAE,eAAoB;IA6DzC,IAAW,QAAQ,CAAC,KAAK,EAAE,OAAO,EAUjC;IAED,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAEM,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAW/C,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAU/C,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAQ9C,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAmBnD,OAAO,CAAC,eAAe;cAQJ,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,GAAG,IAAI;CAkB3D"}