bonkjs 0.2.0

package/dist/runtime/Game.d.ts

@@ -0,0 +1,59 @@
+import { Renderer, RendererConfig } from '../render/Renderer';
+import { PhysicsWorld } from '../physics/PhysicsWorld';
+import { RigidBody, RigidBodyConfig as RBConfig } from '../physics/RigidBody';
+import { Transform } from './Transform';
+import { Vector2 } from '../types';
+/** Game configuration */
+export interface GameConfig {
+    physics?: {
+        gravity?: Vector2;
+        enabled?: boolean;
+    };
+}
+type UpdateCallback = () => void;
+export declare class Game {
+    readonly renderer: Renderer;
+    readonly physics: PhysicsWorld | null;
+    private fixedUpdateCallbacks;
+    private updateCallbacks;
+    private lateUpdateCallbacks;
+    private running;
+    private paused;
+    private animFrameId;
+    private lastTime;
+    private fixedAccumulator;
+    private readonly maxDeltaTime;
+    /** Body ID → RigidBody for collision routing */
+    private registeredBodies;
+    private physicsCleanup;
+    constructor(config?: GameConfig);
+    /** Initialize the renderer and input system. Returns the canvas. */
+    init(config?: Partial<RendererConfig>): Promise<HTMLCanvasElement>;
+    /** Register a callback for fixed-timestep updates (physics). */
+    onFixedUpdate(cb: UpdateCallback): () => void;
+    /** Register a callback for per-frame updates. */
+    onUpdate(cb: UpdateCallback): () => void;
+    /** Register a callback for late updates (after main update). */
+    onLateUpdate(cb: UpdateCallback): () => void;
+    /** Register a RigidBody for collision routing. */
+    registerBody(rb: RigidBody): void;
+    /** Unregister a RigidBody from collision routing. */
+    unregisterBody(rb: RigidBody): void;
+    /** Convenience: create a RigidBody and auto-register it. */
+    createBody(transform: Transform, config: RBConfig): RigidBody;
+    /** Start the game loop. */
+    start(): void;
+    /** Stop the game loop. */
+    stop(): void;
+    /** Pause the game (loop continues but updates are skipped). */
+    pause(): void;
+    /** Resume a paused game. */
+    resume(): void;
+    /** Clean up all resources. */
+    destroy(): void;
+    private loop;
+    private setupCollisionRouting;
+    private routeCollision;
+}
+export {};
+//# sourceMappingURL=Game.d.ts.map

package/dist/runtime/Game.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Game.d.ts","sourceRoot":"","sources":["../../src/runtime/Game.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,yBAAyB,CAAC;AACjC,OAAO,+BAA+B,CAAC;AAKvC,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,IAAI,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,yBAAyB;AACzB,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,KAAK,cAAc,GAAG,MAAM,IAAI,CAAC;AAEjC,qBAAa,IAAI;IACf,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAEtC,OAAO,CAAC,oBAAoB,CAAwB;IACpD,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,mBAAmB,CAAwB;IAEnD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IAErC,gDAAgD;IAChD,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,cAAc,CAAsB;gBAEhC,MAAM,CAAC,EAAE,UAAU;IAc/B,oEAAoE;IAC9D,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAaxE,gEAAgE;IAChE,aAAa,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,IAAI;IAQ7C,iDAAiD;IACjD,QAAQ,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,IAAI;IAQxC,gEAAgE;IAChE,YAAY,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,IAAI;IAQ5C,kDAAkD;IAClD,YAAY,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAMjC,qDAAqD;IACrD,cAAc,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAMnC,4DAA4D;IAC5D,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS;IAS7D,2BAA2B;IAC3B,KAAK,IAAI,IAAI;IASb,0BAA0B;IAC1B,IAAI,IAAI,IAAI;IAQZ,+DAA+D;IAC/D,KAAK,IAAI,IAAI;IAOb,4BAA4B;IAC5B,MAAM,IAAI,IAAI;IAQd,8BAA8B;IAC9B,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,IAAI,CA0CV;IAEF,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,cAAc;CA6BvB"}

package/dist/runtime/Scheduler.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Coroutine scheduler for game logic.
+ * Provides generator-based async operations that integrate with the game loop.
+ */
+/** Coroutine handle for controlling execution */
+export interface CoroutineHandle {
+    id: number;
+    cancel: () => void;
+    readonly isRunning: boolean;
+}
+/** Yield instruction types */
+export type YieldInstruction = {
+    type: 'frames';
+    count: number;
+} | {
+    type: 'seconds';
+    duration: number;
+} | {
+    type: 'until';
+    predicate: () => boolean;
+} | {
+    type: 'coroutine';
+    generator: Generator<YieldInstruction, void, void>;
+};
+/** Wait for a number of frames */
+export declare function waitFrames(count: number): YieldInstruction;
+/** Wait for a duration in seconds (respects Time.timeScale) */
+export declare function wait(seconds: number): YieldInstruction;
+/** Wait until a condition is true */
+export declare function waitUntil(predicate: () => boolean): YieldInstruction;
+/** Wait for another coroutine to complete */
+export declare function waitForCoroutine(generator: Generator<YieldInstruction, void, void>): YieldInstruction;
+export declare class Scheduler {
+    private coroutines;
+    /** Start a new coroutine */
+    start(generator: Generator<YieldInstruction, void, void>): CoroutineHandle;
+    /** Cancel a running coroutine */
+    cancel(id: number): void;
+    /** Cancel all coroutines */
+    cancelAll(): void;
+    /** Update all coroutines (called each frame) */
+    update(): void;
+    /** Advance a coroutine to its next yield point */
+    private advanceCoroutine;
+    /** Get number of running coroutines */
+    get count(): number;
+}
+/** Global scheduler instance */
+export declare const GlobalScheduler: Scheduler;
+//# sourceMappingURL=Scheduler.d.ts.map

package/dist/runtime/Scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scheduler.d.ts","sourceRoot":"","sources":["../../src/runtime/Scheduler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,8BAA8B;AAC9B,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,OAAO,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;CAAE,CAAC;AAE9E,kCAAkC;AAClC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAE1D;AAED,+DAA+D;AAC/D,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAEtD;AAED,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,OAAO,GAAG,gBAAgB,CAEpE;AAED,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,GACjD,gBAAgB,CAElB;AAcD,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAA0B;IAE5C,4BAA4B;IAC5B,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,eAAe;IAwB1E,iCAAiC;IACjC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOxB,4BAA4B;IAC5B,SAAS,IAAI,IAAI;IAOjB,gDAAgD;IAChD,MAAM,IAAI,IAAI;IAsCd,kDAAkD;IAClD,OAAO,CAAC,gBAAgB;IAgDxB,uCAAuC;IACvC,IAAI,KAAK,IAAI,MAAM,CAElB;CACF;AAED,gCAAgC;AAChC,eAAO,MAAM,eAAe,WAAkB,CAAC"}

package/dist/runtime/Time.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Time management for the game loop.
+ * Provides delta time, elapsed time, and time scaling.
+ */
+export declare class Time {
+    /** Time since last frame in seconds */
+    static deltaTime: number;
+    /** Unscaled time since last frame */
+    static unscaledDeltaTime: number;
+    /** Total elapsed time since game start */
+    static time: number;
+    /** Unscaled total elapsed time */
+    static unscaledTime: number;
+    /** Fixed timestep for physics (1/60 second) */
+    static readonly fixedDeltaTime: number;
+    /** Time scale for slow-mo or pause effects */
+    static timeScale: number;
+    /** Frame count since game start */
+    static frameCount: number;
+    /** Current frames per second */
+    static fps: number;
+    private static fpsAccumulator;
+    private static fpsFrameCount;
+    private static lastFpsUpdate;
+    /** Update time values (called by WorldManager) */
+    static update(dt: number): void;
+    /** Reset all time values */
+    static reset(): void;
+}
+//# sourceMappingURL=Time.d.ts.map

package/dist/runtime/Time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Time.d.ts","sourceRoot":"","sources":["../../src/runtime/Time.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,IAAI;IACf,uCAAuC;IACvC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAK;IAE7B,qCAAqC;IACrC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAK;IAErC,0CAA0C;IAC1C,MAAM,CAAC,IAAI,EAAE,MAAM,CAAK;IAExB,kCAAkC;IAClC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAK;IAEhC,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAU;IAEhD,8CAA8C;IAC9C,MAAM,CAAC,SAAS,EAAE,MAAM,CAAK;IAE7B,mCAAmC;IACnC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAK;IAE9B,gCAAgC;IAChC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAM;IAExB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAa;IAC1C,OAAO,CAAC,MAAM,CAAC,aAAa,CAAa;IACzC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAa;IAEzC,kDAAkD;IAClD,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAiB/B,4BAA4B;IAC5B,MAAM,CAAC,KAAK,IAAI,IAAI;CAWrB"}

package/dist/runtime/Transform.d.ts

@@ -0,0 +1,47 @@
+import { Vector2, TransformJson } from '../types';
+export declare class Transform {
+    /** Position in world space */
+    position: Vector2;
+    /** Rotation in degrees */
+    rotation: number;
+    /** Scale factor */
+    scale: Vector2;
+    /** Z-index for render ordering (higher = on top) */
+    zIndex: number;
+    /** Parent transform for hierarchical positioning */
+    parent: Transform | null;
+    /** Child transforms */
+    private children;
+    constructor(data?: Partial<TransformJson>);
+    /** Get world position (accounting for parent transforms) */
+    get worldPosition(): Vector2;
+    /** Set world position */
+    set worldPosition(value: Vector2);
+    /** Get world rotation */
+    get worldRotation(): number;
+    /** Set world rotation */
+    set worldRotation(value: number);
+    /** Get world scale */
+    get worldScale(): Vector2;
+    /** Add a child transform */
+    addChild(child: Transform): void;
+    /** Remove a child transform */
+    removeChild(child: Transform): void;
+    /** Get all children */
+    getChildren(): readonly Transform[];
+    /** Get forward direction vector */
+    get forward(): Vector2;
+    /** Get right direction vector */
+    get right(): Vector2;
+    /** Translate by offset */
+    translate(x: number, y: number): void;
+    /** Rotate by degrees */
+    rotate(degrees: number): void;
+    /** Look at a target position */
+    lookAt(target: Vector2): void;
+    /** Convert to JSON */
+    toJSON(): TransformJson;
+    /** Create from JSON */
+    static fromJSON(json: TransformJson): Transform;
+}
+//# sourceMappingURL=Transform.d.ts.map

package/dist/runtime/Transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transform.d.ts","sourceRoot":"","sources":["../../src/runtime/Transform.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEvD,qBAAa,SAAS;IACpB,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAElB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IAEjB,mBAAmB;IACnB,KAAK,EAAE,OAAO,CAAC;IAEf,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IAEf,oDAAoD;IACpD,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAEhC,uBAAuB;IACvB,OAAO,CAAC,QAAQ,CAAmB;gBAEvB,IAAI,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAOzC,4DAA4D;IAC5D,IAAI,aAAa,IAAI,OAAO,CAiB3B;IAED,yBAAyB;IACzB,IAAI,aAAa,CAAC,KAAK,EAAE,OAAO,EAoB/B;IAED,yBAAyB;IACzB,IAAI,aAAa,IAAI,MAAM,CAG1B;IAED,yBAAyB;IACzB,IAAI,aAAa,CAAC,KAAK,EAAE,MAAM,EAM9B;IAED,sBAAsB;IACtB,IAAI,UAAU,IAAI,OAAO,CAIxB;IAED,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAQhC,+BAA+B;IAC/B,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAQnC,uBAAuB;IACvB,WAAW,IAAI,SAAS,SAAS,EAAE;IAInC,mCAAmC;IACnC,IAAI,OAAO,IAAI,OAAO,CAGrB;IAED,iCAAiC;IACjC,IAAI,KAAK,IAAI,OAAO,CAGnB;IAED,0BAA0B;IAC1B,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAKrC,wBAAwB;IACxB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B,gCAAgC;IAChC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAM7B,sBAAsB;IACtB,MAAM,IAAI,aAAa;IASvB,uBAAuB;IACvB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS;CAGhD"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,6 @@
+export { Game, type GameConfig } from './Game';
+export { Time } from './Time';
+export { Scheduler, GlobalScheduler, waitFrames, wait, waitUntil, waitForCoroutine, type CoroutineHandle, type YieldInstruction, } from './Scheduler';
+export { EventEmitter, GlobalEvents, EngineEvents, type EventCallback, } from './EventSystem';
+export { Transform } from './Transform';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EACL,SAAS,EACT,eAAe,EACf,UAAU,EACV,IAAI,EACJ,SAAS,EACT,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Shared type definitions for Bonk Engine.
+ */
+/** 2D vector as tuple [x, y] */
+export type Vector2 = [number, number];
+/** 2D vector with optional z for layering */
+export type Vector3 = [number, number, number];
+/** RGBA color as tuple [r, g, b, a] with values 0-1 */
+export type Color = [number, number, number, number];
+/** Hex color string */
+export type HexColor = string;
+/** Color can be specified as hex or RGBA tuple */
+export type ColorValue = string | Color;
+/** Configuration for an axis (e.g., horizontal, vertical) */
+export interface AxisConfig {
+    /** Keys that contribute -1 to this axis */
+    negative: string[];
+    /** Keys that contribute +1 to this axis */
+    positive: string[];
+    /** Smoothing factor (0 = instant, higher = smoother). Default: 10 */
+    smoothing?: number;
+}
+/** Configuration for a button (e.g., jump, fire) */
+export interface ButtonConfig {
+    /** Keys that trigger this button. Use "Mouse0", "Mouse1", "Mouse2" for mouse buttons */
+    keys: string[];
+}
+/** Full input configuration */
+export interface InputConfig {
+    axes: Record<string, AxisConfig>;
+    buttons: Record<string, ButtonConfig>;
+}
+/** Transform data for positioning */
+export interface TransformJson {
+    position: Vector2;
+    rotation: number;
+    scale: Vector2;
+    zIndex?: number;
+}
+/** Physics body types */
+export type BodyType = 'dynamic' | 'static' | 'kinematic';
+/** Collider shapes */
+export type ColliderShape = {
+    type: 'box';
+    width: number;
+    height: number;
+} | {
+    type: 'circle';
+    radius: number;
+} | {
+    type: 'polygon';
+    vertices: Vector2[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,gCAAgC;AAChC,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvC,6CAA6C;AAC7C,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE/C,uDAAuD;AACvD,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAErD,uBAAuB;AACvB,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAIxC,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,wFAAwF;IACxF,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC;AAID,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,yBAAyB;AACzB,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE1D,sBAAsB;AACtB,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC"}

package/dist/ui/UIElement.d.ts

@@ -0,0 +1,211 @@
+import { Container } from 'pixi.js';
+import { Vector2 } from '../types';
+import { UIAnchor, UIElementConfig } from './types';
+/**
+ * Abstract base class for all UI elements.
+ *
+ * Subclasses must:
+ * 1. Call super() with config
+ * 2. Create their PixiJS displayObject in constructor
+ * 3. Override measureContent() to return intrinsic size
+ * 4. Optionally override update() for per-frame logic
+ */
+export declare abstract class UIElement {
+    /** Unique identifier for this element */
+    readonly id: string;
+    /** Human-readable name for debugging */
+    name: string;
+    /**
+     * Anchor point determines where the element attaches to its parent/screen.
+     *
+     * The anchor affects both:
+     * 1. Which point on the parent/screen we measure from
+     * 2. Which point on this element is placed at that location
+     *
+     * Example: anchor='bottom-right' means:
+     * - Reference the parent's bottom-right corner
+     * - Place this element's bottom-right corner there
+     * - Offset moves the element up and left (into the parent)
+     */
+    anchor: UIAnchor;
+    /**
+     * Pixel offset from the anchor point.
+     * Positive values move right/down from the anchor.
+     */
+    offset: Vector2;
+    /**
+     * Requested size in pixels [width, height].
+     * 0 = auto-size to content (uses measureContent())
+     */
+    size: Vector2;
+    /**
+     * Computed position after layout pass (screen coordinates).
+     * Set by parent or UIManager during layout().
+     */
+    protected computedPosition: Vector2;
+    /**
+     * Computed size after layout pass.
+     * Either explicit size or measureContent() result.
+     */
+    protected computedSize: Vector2;
+    /** Whether this element is visible */
+    visible: boolean;
+    /** Opacity (0-1) */
+    alpha: number;
+    /** Render order within parent (higher = on top) */
+    zIndex: number;
+    /** Parent element (null for root elements) */
+    parent: UIElement | null;
+    /** Child elements */
+    protected children: UIElement[];
+    /**
+     * The PixiJS container for this element.
+     * Subclasses add their visual content (Graphics, Text, Sprite) to this.
+     */
+    protected displayObject: Container;
+    /**
+     * Whether layout needs to be recalculated.
+     * Set to true when properties change that affect layout.
+     */
+    protected layoutDirty: boolean;
+    constructor(config?: UIElementConfig);
+    /**
+     * Called when the element is first added to the UI hierarchy.
+     * Override to perform one-time initialization.
+     */
+    awake(): void;
+    /**
+     * Called every frame.
+     * Override for per-frame logic (animations, state updates).
+     */
+    update(): void;
+    /**
+     * Called when the element is removed from the UI hierarchy.
+     * Override to clean up resources.
+     */
+    onDestroy(): void;
+    /**
+     * Add a child element.
+     */
+    addChild(child: UIElement): void;
+    /**
+     * Remove a child element.
+     */
+    removeChild(child: UIElement): void;
+    /**
+     * Remove all children.
+     */
+    removeAllChildren(): void;
+    /**
+     * Get all children.
+     */
+    getChildren(): readonly UIElement[];
+    /**
+     * Get the PixiJS display object.
+     * Used by UIManager to add to render tree.
+     */
+    getDisplayObject(): Container;
+    /**
+     * Mark this element and its ancestors as needing layout recalculation.
+     */
+    markLayoutDirty(): void;
+    /**
+     * Measure the intrinsic content size.
+     * Override in subclasses to return the natural size of the content.
+     *
+     * Examples:
+     * - UIText: Returns the text bounds
+     * - UIImage: Returns the image dimensions
+     * - UIPanel: Returns size needed to contain children + padding
+     *
+     * @returns [width, height] in pixels
+     */
+    protected measureContent(): Vector2;
+    /**
+     * Compute layout for this element and its children.
+     * Called by UIManager each frame on root elements.
+     *
+     * @param viewport - The available space (screen or parent bounds)
+     */
+    layout(viewport: {
+        width: number;
+        height: number;
+    }): void;
+    /**
+     * Layout child elements.
+     * Override in VBox/HBox to implement custom layout logic.
+     */
+    protected layoutChildren(viewport: {
+        width: number;
+        height: number;
+    }): void;
+    /**
+     * Compute position based on anchor point and offset.
+     *
+     * The anchor system works like this:
+     * ┌─────────────────────────────────────────┐
+     * │ (0,0)           (w/2,0)           (w,0) │
+     * │ top-left      top-center      top-right │
+     * │                                         │
+     * │ (0,h/2)       (w/2,h/2)       (w,h/2)   │
+     * │ center-left    center    center-right   │
+     * │                                         │
+     * │ (0,h)         (w/2,h)         (w,h)     │
+     * │ bottom-left bottom-center bottom-right  │
+     * └─────────────────────────────────────────┘
+     */
+    protected computeAnchoredPosition(viewport: {
+        width: number;
+        height: number;
+    }): Vector2;
+    /**
+     * Get the world/screen position of this element.
+     *
+     * For nested elements, computedPosition is in LOCAL coordinates (relative to parent).
+     * This method walks up the parent chain to compute the absolute screen position.
+     *
+     * Example:
+     * - Panel at screen position (600, 400)
+     *   - Button at local position (10, 10)
+     *   - Button's world position = (610, 410)
+     */
+    getWorldPosition(): Vector2;
+    /**
+     * Check if a screen point is inside this element's bounds.
+     * Uses world position for accurate hit testing of nested elements.
+     */
+    containsPoint(point: Vector2): boolean;
+    /**
+     * Find the topmost element at a screen point.
+     * Searches children first (in reverse z-order) then self.
+     */
+    hitTest(point: Vector2): UIElement | null;
+    /** Get computed position after layout */
+    getComputedPosition(): Vector2;
+    /**
+     * Offset the computed position after layout.
+     * Used by layout containers (UIPanel) to adjust child positions for padding.
+     * This keeps computedPosition in sync with displayObject.position.
+     */
+    offsetComputedPosition(dx: number, dy: number): void;
+    /**
+     * Set the computed position directly.
+     * Used by layout containers (UIVBox, UIHBox) that completely override child positioning.
+     * Also updates the displayObject position.
+     */
+    setComputedPosition(x: number, y: number): void;
+    /** Get computed size after layout */
+    getComputedSize(): Vector2;
+    /** Get computed bounds as {x, y, width, height} */
+    getComputedBounds(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /**
+     * Destroy this element and all children.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=UIElement.d.ts.map

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

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

package/dist/ui/UIManager.d.ts

@@ -0,0 +1,102 @@
+import { Renderer } from '../render/Renderer';
+import { UIPointerEvent } from './types';
+import { UIElement } from './UIElement';
+/**
+ * Interface for elements that can receive pointer events.
+ * Implemented by UIButton and other interactive elements.
+ */
+export interface UIInteractive {
+    /** Called when pointer enters element bounds */
+    onPointerEnter?(event: UIPointerEvent): void;
+    /** Called when pointer exits element bounds */
+    onPointerExit?(event: UIPointerEvent): void;
+    /** Called when pointer button is pressed on element */
+    onPointerDown?(event: UIPointerEvent): void;
+    /** Called when pointer button is released on element */
+    onPointerUp?(event: UIPointerEvent): void;
+}
+export declare class UIManager {
+    /** Root UI elements (not parented to other UI elements) */
+    private roots;
+    /** Reference to the renderer for viewport size */
+    private renderer;
+    /** Currently hovered element */
+    private hoveredElement;
+    /** Currently pressed element (mouse button held) */
+    private pressedElement;
+    /** Whether the UI system is active */
+    private active;
+    constructor(renderer: Renderer);
+    /**
+     * Add a root UI element.
+     * Root elements are positioned relative to the screen.
+     */
+    addRoot(element: UIElement): void;
+    /**
+     * Remove a root UI element.
+     */
+    removeRoot(element: UIElement): void;
+    /**
+     * Get all root elements.
+     */
+    getRoots(): readonly UIElement[];
+    /**
+     * Process input events for the UI.
+     * Call this BEFORE game input processing.
+     *
+     * @returns true if UI consumed the input (game should ignore it)
+     */
+    processInput(): boolean;
+    /**
+     * Hit test all root elements.
+     * Returns the topmost element at the given point.
+     */
+    private hitTestAll;
+    /**
+     * Create a pointer event object.
+     */
+    private createPointerEvent;
+    /**
+     * Update all UI elements.
+     * Call once per frame.
+     */
+    update(): void;
+    /**
+     * Recursively update an element and its children.
+     */
+    private updateElement;
+    /**
+     * Run layout pass on all root elements.
+     * Call once per frame after update.
+     */
+    layout(): void;
+    /**
+     * Enable or disable the UI system.
+     */
+    setActive(active: boolean): void;
+    /**
+     * Check if the UI system is active.
+     */
+    isActive(): boolean;
+    /**
+     * Destroy the UI manager and all root elements.
+     */
+    destroy(): void;
+    /**
+     * Find a UI element by ID.
+     */
+    findById(id: string): UIElement | null;
+    /**
+     * Recursively search for an element by ID.
+     */
+    private findByIdInTree;
+    /**
+     * Find a UI element by name.
+     */
+    findByName(name: string): UIElement | null;
+    /**
+     * Recursively search for an element by name.
+     */
+    private findByNameInTree;
+}
+//# sourceMappingURL=UIManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UIManager.d.ts","sourceRoot":"","sources":["../../src/ui/UIManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,cAAc,CAAC,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7C,+CAA+C;IAC/C,aAAa,CAAC,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5C,uDAAuD;IACvD,aAAa,CAAC,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5C,wDAAwD;IACxD,WAAW,CAAC,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;CAC3C;AAcD,qBAAa,SAAS;IACpB,2DAA2D;IAC3D,OAAO,CAAC,KAAK,CAAmB;IAEhC,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAW;IAE3B,gCAAgC;IAChC,OAAO,CAAC,cAAc,CAA0B;IAEhD,oDAAoD;IACpD,OAAO,CAAC,cAAc,CAA0B;IAEhD,sCAAsC;IACtC,OAAO,CAAC,MAAM,CAAiB;gBAEnB,QAAQ,EAAE,QAAQ;IAM9B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI;IAejC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI;IAapC;;OAEG;IACH,QAAQ,IAAI,SAAS,SAAS,EAAE;IAMhC;;;;;OAKG;IACH,YAAY,IAAI,OAAO;IAsDvB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;;OAGG;IACH,MAAM,IAAI,IAAI;IAQd;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;OAGG;IACH,MAAM,IAAI,IAAI;IAYd;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIhC;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,OAAO,IAAI,IAAI;IAYf;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAQtC;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAQ1C;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAQzB"}

package/dist/ui/index.d.ts

@@ -0,0 +1,11 @@
+export * from './types';
+export { UIElement } from './UIElement';
+export { UIManager } from './UIManager';
+export type { UIInteractive } from './UIManager';
+export { UIText } from './primitives/UIText';
+export { UIImage } from './primitives/UIImage';
+export { UIPanel } from './primitives/UIPanel';
+export { UIButton } from './primitives/UIButton';
+export { UIVBox } from './layout/UIVBox';
+export { UIHBox } from './layout/UIHBox';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/ui/layout/UIHBox.d.ts

@@ -0,0 +1,42 @@
+import { UIElement } from '../UIElement';
+import { Vector2 } from '../../types';
+import { UIPadding, UILayoutAlign, UILayoutContainerConfig } from '../types';
+export declare class UIHBox extends UIElement {
+    /** Space between children in pixels */
+    private _gap;
+    /** Inner padding [top, right, bottom, left] */
+    private _padding;
+    /** Cross-axis (vertical) alignment of children */
+    private _align;
+    constructor(config?: UILayoutContainerConfig);
+    /** Get gap between children */
+    get gap(): number;
+    /** Set gap between children */
+    set gap(value: number);
+    /** Get padding */
+    get padding(): UIPadding;
+    /** Set padding [top, right, bottom, left] */
+    set padding(value: UIPadding);
+    /** Get alignment */
+    get align(): UILayoutAlign;
+    /** Set alignment */
+    set align(value: UILayoutAlign);
+    /**
+     * Measure content size (sum of child widths + gaps + padding).
+     *
+     * ┌───────────────────────────────────────────────────────────┐
+     * │ pl │ Child1 │ gap │ Child2 │ gap │ Child3 │ pr           │
+     * └───────────────────────────────────────────────────────────┘
+     *        └─────────────────────────────────────┘
+     *                    content area
+     */
+    protected measureContent(): Vector2;
+    /**
+     * Layout children horizontally with gaps.
+     */
+    protected layoutChildren(viewport: {
+        width: number;
+        height: number;
+    }): void;
+}
+//# sourceMappingURL=UIHBox.d.ts.map