dino-ge 1.0.0

package/dist/Camera.d.ts

@@ -0,0 +1,37 @@
+import Vector2 from './Vector2.js';
+/**
+ * Manages the viewport and transformation of the game world.
+ */
+export default class Camera {
+    /** Current camera position in world space. */
+    position: Vector2;
+    /** Zoom level of the camera. */
+    zoom: number;
+    constructor();
+    /**
+     * Center the camera on a target object.
+     * @param target The object to follow.
+     * @param viewportWidth Width of the viewport.
+     * @param viewportHeight Height of the viewport.
+     */
+    follow(target: {
+        position: Vector2;
+        width: number;
+        height: number;
+    }, viewportWidth: number, viewportHeight: number): void;
+    /**
+     * Returns the current viewport bounds in world space.
+     * @param width Width of the viewport.
+     * @param height Height of the viewport.
+     */
+    getViewportBounds(width: number, height: number): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /**
+     * Reset camera position to origin and zoom to 1.
+     */
+    reset(): void;
+}

package/dist/Camera.js

@@ -0,0 +1,44 @@
+import Vector2 from './Vector2.js';
+/**
+ * Manages the viewport and transformation of the game world.
+ */
+export default class Camera {
+    constructor() {
+        /** Current camera position in world space. */
+        this.position = new Vector2(0, 0);
+        /** Zoom level of the camera. */
+        this.zoom = 1;
+    }
+    /**
+     * Center the camera on a target object.
+     * @param target The object to follow.
+     * @param viewportWidth Width of the viewport.
+     * @param viewportHeight Height of the viewport.
+     */
+    follow(target, viewportWidth, viewportHeight) {
+        this.position.x = (target.position.x + target.width / 2) - (viewportWidth / 2) / this.zoom;
+        this.position.y = (target.position.y + target.height / 2) - (viewportHeight / 2) / this.zoom;
+    }
+    /**
+     * Returns the current viewport bounds in world space.
+     * @param width Width of the viewport.
+     * @param height Height of the viewport.
+     */
+    getViewportBounds(width, height) {
+        return {
+            x: this.position.x,
+            y: this.position.y,
+            width: width / this.zoom,
+            height: height / this.zoom
+        };
+    }
+    /**
+     * Reset camera position to origin and zoom to 1.
+     */
+    reset() {
+        this.position.x = 0;
+        this.position.y = 0;
+        this.zoom = 1;
+    }
+}
+//# sourceMappingURL=Camera.js.map

package/dist/Camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Camera.js","sourceRoot":"","sources":["../src/Camera.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,MAAM;IAMzB;QALA,8CAA8C;QACvC,aAAQ,GAAY,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,gCAAgC;QACzB,SAAI,GAAW,CAAC,CAAC;IAET,CAAC;IAEhB;;;;;OAKG;IACH,MAAM,CAAC,MAA4D,EAAE,aAAqB,EAAE,cAAsB;QAChH,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAC3F,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;IAC/F,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,KAAa,EAAE,MAAc;QAC7C,OAAO;YACL,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClB,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,IAAI;YACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,IAAI;SAC3B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IAChB,CAAC;CACF"}

package/dist/Canvas.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Simple wrapper for creating and managing a full-screen canvas element.
+ */
+export default class Canvas {
+    /** The underlying HTMLCanvasElement. */
+    canvas: HTMLCanvasElement;
+    constructor();
+    /**
+     * Resizes the canvas to match the window dimensions.
+     */
+    resize(): void;
+}

package/dist/Canvas.js

@@ -0,0 +1,21 @@
+/**
+ * Simple wrapper for creating and managing a full-screen canvas element.
+ */
+export default class Canvas {
+    constructor() {
+        this.canvas = document.createElement('canvas');
+        this.canvas.id = 'canvas';
+        this.canvas.width = window.innerWidth;
+        this.canvas.height = window.innerHeight;
+        this.canvas.style.zIndex = '0';
+        this.canvas.style.position = 'fixed';
+    }
+    /**
+     * Resizes the canvas to match the window dimensions.
+     */
+    resize() {
+        this.canvas.width = window.innerWidth;
+        this.canvas.height = window.innerHeight;
+    }
+}
+//# sourceMappingURL=Canvas.js.map

package/dist/Canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Canvas.js","sourceRoot":"","sources":["../src/Canvas.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,MAAM;IAIzB;QACE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;IAC1C,CAAC;CACF"}

package/dist/Circle.d.ts

@@ -0,0 +1,39 @@
+import Vector2 from './Vector2.js';
+import GameObject from './GameObject.js';
+/**
+ * Configuration for creating a Circle object.
+ */
+export interface CircleProps {
+    /** Unique tag for identification. */
+    tag: string;
+    /** Initial position of the circle. */
+    position: Vector2;
+    /** Radius of the circle. */
+    radius: number;
+    /** Fill colour. */
+    colour: string;
+    /** Render order (lower is background). */
+    zIndex: number;
+}
+/**
+ * A basic circle shape that can be drawn to the screen.
+ */
+export default class Circle extends GameObject {
+    private _position;
+    /** Radius of the circle. */
+    radius: number;
+    /** Fill colour. */
+    colour: string;
+    /** Gets or sets the position of the circle. */
+    get position(): Vector2;
+    set position(val: Vector2);
+    /** Width of the circle (radius * 2). */
+    get width(): number;
+    /** Height of the circle (radius * 2). */
+    get height(): number;
+    /** Center point of the circle. */
+    get center(): Vector2;
+    constructor(props: CircleProps);
+    /** Draws the circle onto the provided rendering context. */
+    draw(ctx: CanvasRenderingContext2D): void;
+}

package/dist/Circle.js

@@ -0,0 +1,51 @@
+import Vector2 from './Vector2.js';
+import GameObject from './GameObject.js';
+const defaultProps = {
+    tag: 'circle',
+    colour: 'black',
+    zIndex: 0,
+};
+/**
+ * A basic circle shape that can be drawn to the screen.
+ */
+export default class Circle extends GameObject {
+    /** Gets or sets the position of the circle. */
+    get position() { return this._position; }
+    set position(val) { this._position = val; }
+    /** Width of the circle (radius * 2). */
+    get width() { return this.radius * 2; }
+    /** Height of the circle (radius * 2). */
+    get height() { return this.radius * 2; }
+    /** Center point of the circle. */
+    get center() {
+        return new Vector2(this.position.x + this.radius, this.position.y + this.radius);
+    }
+    constructor(props) {
+        super(props.tag || defaultProps.tag, props.zIndex || defaultProps.zIndex);
+        const defaultedProps = Object.assign(Object.assign({}, defaultProps), props);
+        if (!(defaultedProps.position instanceof Vector2)) {
+            throw new Error('"position" must be a Vector2!');
+        }
+        if (!defaultedProps.radius) {
+            throw new Error('You must provide a radius for Circle');
+        }
+        this.tag = defaultedProps.tag;
+        this._position = defaultedProps.position;
+        this.radius = defaultedProps.radius;
+        this.colour = defaultedProps.colour;
+        this.zIndex = defaultedProps.zIndex;
+        this.registerSelf();
+    }
+    /** Draws the circle onto the provided rendering context. */
+    draw(ctx) {
+        if (!this.visible)
+            return;
+        ctx.beginPath();
+        ctx.fillStyle = this.colour;
+        const center = this.center;
+        ctx.arc(center.x, center.y, this.radius, 0, Math.PI * 2);
+        ctx.fill();
+        ctx.closePath();
+    }
+}
+//# sourceMappingURL=Circle.js.map

package/dist/Circle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Circle.js","sourceRoot":"","sources":["../src/Circle.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AAkBzC,MAAM,YAAY,GAAG;IACnB,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,CAAC;CACV,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,UAAU;IAO5C,+CAA+C;IAC/C,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACzC,IAAI,QAAQ,CAAC,GAAG,IAAI,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC;IAE3C,wCAAwC;IACxC,IAAI,KAAK,KAAK,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACvC,yCAAyC;IACzC,IAAI,MAAM,KAAK,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAExC,kCAAkC;IAClC,IAAI,MAAM;QACR,OAAO,IAAI,OAAO,CAChB,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAC7B,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAC9B,CAAC;IACJ,CAAC;IAED,YAAY,KAAkB;QAC5B,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QAE1E,MAAM,cAAc,mCACf,YAAY,GACZ,KAAK,CACT,CAAC;QAEF,IAAI,CAAC,CAAC,cAAc,CAAC,QAAQ,YAAY,OAAO,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;QAEpC,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED,4DAA4D;IAC5D,IAAI,CAAC,GAA6B;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,GAAG,CAAC,SAAS,EAAE,CAAC;QAChB,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACzD,GAAG,CAAC,IAAI,EAAE,CAAC;QACX,GAAG,CAAC,SAAS,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/Engine.d.ts

@@ -0,0 +1,114 @@
+import GameObject from './GameObject.js';
+import Scene from './Scene.js';
+import Camera from './Camera.js';
+/**
+ * Options for initializing the Engine.
+ */
+export interface EngineOpts {
+    /** Width of the game window (e.g., '800px' or '100%'). */
+    width: string;
+    /** Height of the game window (e.g., '600px' or '100%'). */
+    height: string;
+    /** Title of the game, set in the document head. */
+    title: string;
+    /** Background colour of the canvas. */
+    backgroundColour: string;
+}
+/**
+ * Lifecycle and update callbacks for the engine.
+ */
+export interface EngineCallbacks {
+    /** Called once after the engine is initialized. */
+    onLoad: () => void;
+    /** Called every frame for game logic and rendering. */
+    update: () => void;
+    /** Optional callback for physics or fixed-step logic. */
+    fixedUpdate?: () => void;
+}
+/**
+ * Specialized Set for managing game objects with helper methods.
+ */
+export declare class ObjectSet extends Set<GameObject> {
+    /**
+     * Find all objects with a specific tag.
+     * @param tag The tag to search for.
+     */
+    findAll: (tag: string) => GameObject[];
+}
+/**
+ * The core singleton class that manages the game loop, rendering, and scene state.
+ */
+export default class Engine {
+    #private;
+    /**
+     * Global set of game objects if no scene is active.
+     */
+    static objects: ObjectSet;
+    /**
+     * Whether the game loop is currently paused.
+     */
+    static paused: boolean;
+    /**
+     * Toggle for visual debug mode (hitboxes and stats).
+     */
+    static debug: boolean;
+    /**
+     * The currently selected object in debug mode.
+     */
+    static selectedObject: GameObject | null;
+    /**
+     * The global camera instance.
+     */
+    static camera: Camera;
+    private static _currentScene;
+    /**
+     * Gets the currently active scene.
+     */
+    static get currentScene(): Scene;
+    /**
+     * Sets the active scene, resetting the camera and calling the scene's onLoad.
+     */
+    static set currentScene(scene: Scene);
+    /** Current background colour. */
+    backgroundColour: string;
+    /** Registered engine callbacks. */
+    callbacks: EngineCallbacks;
+    /** Pixel width of the canvas. */
+    width: number;
+    /** Pixel height of the canvas. */
+    height: number;
+    /** Current mouse x position in world space. */
+    get mouseX(): number;
+    /** Current mouse y position in world space. */
+    get mouseY(): number;
+    /** Current frames per second. */
+    fps: number;
+    constructor(callbacks: EngineCallbacks, opts?: Partial<EngineOpts>);
+    /**
+     * Promisified setTimeout.
+     * @param timeoutFn The function to run after the timeout.
+     * @param time The time in milliseconds to wait.
+     */
+    setTimeout(timeoutFn: () => void, time: number): Promise<void>;
+    /**
+     * Run a function repeatedly for a duration and then run a final function.
+     * @param milliseconds Total duration.
+     * @param fn Function to run every second.
+     * @param onEnded Final function to run.
+     */
+    countdown(milliseconds: number, fn: () => void, onEnded: () => void): void;
+    /** Sets the CSS cursor style for the game canvas. */
+    set cursor(value: string);
+    /**
+     * Register a new game object with the active scene or global engine.
+     * @param object The object to register.
+     */
+    static registerObject(object: GameObject): void;
+    /**
+     * Remove a game object from the active scene or global engine.
+     * @param object The object to destroy.
+     */
+    static destroyObject(object: GameObject): void;
+    /** Destroy all objects in the active scene or global engine. */
+    static destroyAll(): void;
+}

package/dist/Engine.js

@@ -0,0 +1,321 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _Engine_instances, _a, _Engine_canvas, _Engine_ctx, _Engine_window, _Engine_title, _Engine_oldTimestamp, _Engine_secondsPassed, _Engine_accumulator, _Engine_fixedDelta, _Engine_onLoad, _Engine_update, _Engine_fixedUpdate, _Engine_setBackground, _Engine_draw, _Engine_drawDebug, _Engine_findAllObjects, _Engine_getSortedArray;
+import Canvas from './Canvas.js';
+import Input from './Input.js';
+import Camera from './Camera.js';
+/**
+ * Specialized Set for managing game objects with helper methods.
+ */
+export class ObjectSet extends Set {
+    constructor() {
+        super(...arguments);
+        /**
+         * Find all objects with a specific tag.
+         * @param tag The tag to search for.
+         */
+        this.findAll = () => [];
+    }
+}
+/**
+ * The core singleton class that manages the game loop, rendering, and scene state.
+ */
+class Engine {
+    /**
+     * Gets the currently active scene.
+     */
+    static get currentScene() {
+        return this._currentScene;
+    }
+    /**
+     * Sets the active scene, resetting the camera and calling the scene's onLoad.
+     */
+    static set currentScene(scene) {
+        this._currentScene = scene;
+        this.camera.reset();
+        scene.onLoad();
+    }
+    /** Current mouse x position in world space. */
+    get mouseX() {
+        return Input.mouseX;
+    }
+    /** Current mouse y position in world space. */
+    get mouseY() {
+        return Input.mouseY;
+    }
+    constructor(callbacks, opts = {}) {
+        _Engine_instances.add(this);
+        _Engine_canvas.set(this, void 0);
+        _Engine_ctx.set(this, void 0);
+        _Engine_window.set(this, void 0);
+        _Engine_title.set(this, void 0);
+        /** Current frames per second. */
+        this.fps = 0;
+        _Engine_oldTimestamp.set(this, 0);
+        _Engine_secondsPassed.set(this, 0);
+        _Engine_accumulator.set(this, 0);
+        _Engine_fixedDelta.set(this, 1 / 60);
+        const defaultedOpts = Object.assign({ width: '100%', height: '100%', title: 'Example', backgroundColour: 'white' }, opts);
+        _a.objects.findAll = __classPrivateFieldGet(this, _Engine_instances, "m", _Engine_findAllObjects).bind(this);
+        __classPrivateFieldSet(this, _Engine_title, document.createElement('title'), "f");
+        __classPrivateFieldGet(this, _Engine_title, "f").innerHTML = defaultedOpts.title;
+        document.getElementsByTagName('head')[0].appendChild(__classPrivateFieldGet(this, _Engine_title, "f"));
+        this.backgroundColour = defaultedOpts.backgroundColour;
+        this.callbacks = {
+            onLoad: () => {
+                callbacks.onLoad();
+                __classPrivateFieldGet(this, _Engine_instances, "m", _Engine_onLoad).call(this);
+            },
+            update: callbacks.update,
+        };
+        __classPrivateFieldSet(this, _Engine_canvas, new Canvas(), "f");
+        __classPrivateFieldSet(this, _Engine_ctx, __classPrivateFieldGet(this, _Engine_canvas, "f").canvas.getContext('2d'), "f");
+        this.width = __classPrivateFieldGet(this, _Engine_canvas, "f").canvas.width;
+        this.height = __classPrivateFieldGet(this, _Engine_canvas, "f").canvas.height;
+        __classPrivateFieldSet(this, _Engine_window, document.createElement('div'), "f");
+        __classPrivateFieldGet(this, _Engine_window, "f").id = 'canvas-container';
+        __classPrivateFieldGet(this, _Engine_window, "f").style.width = defaultedOpts.width;
+        __classPrivateFieldGet(this, _Engine_window, "f").style.height = defaultedOpts.height;
+        Input.init();
+        window.addEventListener('resize', () => {
+            __classPrivateFieldGet(this, _Engine_canvas, "f").resize();
+            this.width = __classPrivateFieldGet(this, _Engine_canvas, "f").canvas.width;
+            this.height = __classPrivateFieldGet(this, _Engine_canvas, "f").canvas.height;
+        });
+        document.getElementsByTagName('body')[0].appendChild(__classPrivateFieldGet(this, _Engine_window, "f"));
+        __classPrivateFieldGet(this, _Engine_window, "f").appendChild(__classPrivateFieldGet(this, _Engine_canvas, "f").canvas);
+        setTimeout(() => this.callbacks.onLoad(), 0);
+    }
+    /**
+     * Promisified setTimeout.
+     * @param timeoutFn The function to run after the timeout.
+     * @param time The time in milliseconds to wait.
+     */
+    setTimeout(timeoutFn, time) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield new Promise((resolve) => {
+                setTimeout(resolve, time);
+            });
+            timeoutFn();
+        });
+    }
+    /**
+     * Run a function repeatedly for a duration and then run a final function.
+     * @param milliseconds Total duration.
+     * @param fn Function to run every second.
+     * @param onEnded Final function to run.
+     */
+    countdown(milliseconds, fn, onEnded) {
+        setTimeout(onEnded, milliseconds);
+        for (let i = 1; i <= milliseconds; i += 1) {
+            if (i % 1000 === 0) {
+                setTimeout(fn, i);
+            }
+        }
+    }
+    /** Sets the CSS cursor style for the game canvas. */
+    set cursor(value) {
+        const canvas = document.getElementById('canvas');
+        if (canvas)
+            canvas.style.cursor = value;
+    }
+    /**
+     * Register a new game object with the active scene or global engine.
+     * @param object The object to register.
+     */
+    static registerObject(object) {
+        if (_a.currentScene) {
+            _a.currentScene.add(object);
+        }
+        else {
+            this.objects.add(object);
+        }
+    }
+    /**
+     * Remove a game object from the active scene or global engine.
+     * @param object The object to destroy.
+     */
+    static destroyObject(object) {
+        if (_a.currentScene) {
+            _a.currentScene.remove(object);
+        }
+        else {
+            this.objects.delete(object);
+        }
+    }
+    /** Destroy all objects in the active scene or global engine. */
+    static destroyAll() {
+        if (_a.currentScene) {
+            _a.currentScene.clear();
+        }
+        else {
+            this.objects.clear();
+        }
+    }
+}
+_a = Engine, _Engine_canvas = new WeakMap(), _Engine_ctx = new WeakMap(), _Engine_window = new WeakMap(), _Engine_title = new WeakMap(), _Engine_oldTimestamp = new WeakMap(), _Engine_secondsPassed = new WeakMap(), _Engine_accumulator = new WeakMap(), _Engine_fixedDelta = new WeakMap(), _Engine_instances = new WeakSet(), _Engine_onLoad = function _Engine_onLoad() {
+    __classPrivateFieldGet(this, _Engine_instances, "m", _Engine_draw).call(this);
+    window.requestAnimationFrame(__classPrivateFieldGet(this, _Engine_instances, "m", _Engine_update).bind(this));
+}, _Engine_update = function _Engine_update(timestamp) {
+    if (!_a.paused) {
+        __classPrivateFieldSet(this, _Engine_secondsPassed, (timestamp - __classPrivateFieldGet(this, _Engine_oldTimestamp, "f")) / 1000, "f");
+        __classPrivateFieldSet(this, _Engine_oldTimestamp, timestamp, "f");
+        this.fps = Math.round(1 / __classPrivateFieldGet(this, _Engine_secondsPassed, "f"));
+        // Fixed update loop
+        __classPrivateFieldSet(this, _Engine_accumulator, __classPrivateFieldGet(this, _Engine_accumulator, "f") + __classPrivateFieldGet(this, _Engine_secondsPassed, "f"), "f");
+        while (__classPrivateFieldGet(this, _Engine_accumulator, "f") >= __classPrivateFieldGet(this, _Engine_fixedDelta, "f")) {
+            __classPrivateFieldGet(this, _Engine_instances, "m", _Engine_fixedUpdate).call(this);
+            __classPrivateFieldSet(this, _Engine_accumulator, __classPrivateFieldGet(this, _Engine_accumulator, "f") - __classPrivateFieldGet(this, _Engine_fixedDelta, "f"), "f");
+        }
+        if (_a.currentScene) {
+            _a.currentScene.update();
+        }
+        this.callbacks.update();
+        __classPrivateFieldGet(this, _Engine_instances, "m", _Engine_draw).call(this);
+    }
+    else {
+        // Still allow drawing in paused mode if debug is on or for initial frame
+        __classPrivateFieldGet(this, _Engine_instances, "m", _Engine_draw).call(this);
+    }
+    window.requestAnimationFrame(__classPrivateFieldGet(this, _Engine_instances, "m", _Engine_update).bind(this));
+}, _Engine_fixedUpdate = function _Engine_fixedUpdate() {
+    const objects = _a.currentScene ? _a.currentScene.objects : _a.objects;
+    objects.forEach((object) => {
+        // Apply acceleration to velocity
+        object.velocity.x += object.acceleration.x * __classPrivateFieldGet(this, _Engine_fixedDelta, "f");
+        object.velocity.y += object.acceleration.y * __classPrivateFieldGet(this, _Engine_fixedDelta, "f");
+        // Apply velocity to position
+        object.position.x += object.velocity.x * __classPrivateFieldGet(this, _Engine_fixedDelta, "f");
+        object.position.y += object.velocity.y * __classPrivateFieldGet(this, _Engine_fixedDelta, "f");
+    });
+    if (this.callbacks.fixedUpdate) {
+        this.callbacks.fixedUpdate();
+    }
+}, _Engine_setBackground = function _Engine_setBackground() {
+    __classPrivateFieldGet(this, _Engine_ctx, "f").fillStyle = this.backgroundColour;
+    __classPrivateFieldGet(this, _Engine_ctx, "f").fillRect(0, 0, __classPrivateFieldGet(this, _Engine_canvas, "f").canvas.width, __classPrivateFieldGet(this, _Engine_canvas, "f").canvas.height);
+}, _Engine_draw = function _Engine_draw() {
+    __classPrivateFieldGet(this, _Engine_instances, "m", _Engine_setBackground).call(this);
+    const objects = _a.currentScene ? _a.currentScene.objects : _a.objects;
+    const bounds = _a.camera.getViewportBounds(this.width, this.height);
+    __classPrivateFieldGet(this, _Engine_ctx, "f").save();
+    // Apply camera transform
+    __classPrivateFieldGet(this, _Engine_ctx, "f").scale(_a.camera.zoom, _a.camera.zoom);
+    __classPrivateFieldGet(this, _Engine_ctx, "f").translate(-_a.camera.position.x, -_a.camera.position.y);
+    __classPrivateFieldGet(_a, _a, "m", _Engine_getSortedArray).call(_a, objects).forEach((object) => {
+        // Frustum Culling
+        if (object.position.x < bounds.x + bounds.width &&
+            object.position.x + object.width > bounds.x &&
+            object.position.y < bounds.y + bounds.height &&
+            object.position.y + object.height > bounds.y) {
+            object.draw(__classPrivateFieldGet(this, _Engine_ctx, "f"));
+        }
+    });
+    if (_a.debug) {
+        __classPrivateFieldGet(this, _Engine_instances, "m", _Engine_drawDebug).call(this, objects);
+    }
+    __classPrivateFieldGet(this, _Engine_ctx, "f").restore();
+}, _Engine_drawDebug = function _Engine_drawDebug(objects) {
+    __classPrivateFieldGet(this, _Engine_ctx, "f").strokeStyle = 'red';
+    __classPrivateFieldGet(this, _Engine_ctx, "f").lineWidth = 1;
+    __classPrivateFieldGet(this, _Engine_ctx, "f").font = '12px monospace';
+    __classPrivateFieldGet(this, _Engine_ctx, "f").fillStyle = 'red';
+    objects.forEach((obj) => {
+        // Draw hitbox
+        __classPrivateFieldGet(this, _Engine_ctx, "f").strokeStyle = obj === _a.selectedObject ? '#00ff00' : 'red';
+        __classPrivateFieldGet(this, _Engine_ctx, "f").lineWidth = obj === _a.selectedObject ? 2 : 1;
+        __classPrivateFieldGet(this, _Engine_ctx, "f").strokeRect(obj.position.x, obj.position.y, obj.width, obj.height);
+        // Draw tag
+        __classPrivateFieldGet(this, _Engine_ctx, "f").fillStyle = __classPrivateFieldGet(this, _Engine_ctx, "f").strokeStyle;
+        __classPrivateFieldGet(this, _Engine_ctx, "f").fillText(obj.tag || 'obj', obj.position.x, obj.position.y - 5);
+    });
+    // Draw Stats Overlay (Top Right)
+    __classPrivateFieldGet(this, _Engine_ctx, "f").save();
+    __classPrivateFieldGet(this, _Engine_ctx, "f").setTransform(1, 0, 0, 1, 0, 0); // Reset transform for UI
+    const overlayWidth = 180;
+    const statsHeight = 80;
+    const padding = 10;
+    const x = __classPrivateFieldGet(this, _Engine_canvas, "f").canvas.width - overlayWidth - padding;
+    let y = padding;
+    // Background for Stats
+    __classPrivateFieldGet(this, _Engine_ctx, "f").fillStyle = 'rgba(0, 0, 0, 0.7)';
+    __classPrivateFieldGet(this, _Engine_ctx, "f").fillRect(x, y, overlayWidth, statsHeight);
+    __classPrivateFieldGet(this, _Engine_ctx, "f").fillStyle = 'white';
+    __classPrivateFieldGet(this, _Engine_ctx, "f").textAlign = 'left';
+    __classPrivateFieldGet(this, _Engine_ctx, "f").textBaseline = 'top';
+    __classPrivateFieldGet(this, _Engine_ctx, "f").fillText(`FPS: ${this.fps}`, x + 10, y + 10);
+    __classPrivateFieldGet(this, _Engine_ctx, "f").fillText(`Objects: ${objects.size}`, x + 10, y + 25);
+    __classPrivateFieldGet(this, _Engine_ctx, "f").fillText(`Mouse X: ${Math.round(this.mouseX)}`, x + 10, y + 45);
+    __classPrivateFieldGet(this, _Engine_ctx, "f").fillText(`Mouse Y: ${Math.round(this.mouseY)}`, x + 10, y + 60);
+    // Inspector Panel (If object selected)
+    if (_a.selectedObject) {
+        y += statsHeight + 10;
+        const obj = _a.selectedObject;
+        const properties = [
+            ['Tag', obj.tag],
+            ['Pos', `${Math.round(obj.position.x)}, ${Math.round(obj.position.y)}`],
+            ['Size', `${Math.round(obj.width)}x${Math.round(obj.height)}`],
+            ['Vel', `${Math.round(obj.velocity.x)}, ${Math.round(obj.velocity.y)}`],
+            ['Acc', `${Math.round(obj.acceleration.x)}, ${Math.round(obj.acceleration.y)}`],
+            ['Z-Index', obj.zIndex]
+        ];
+        const inspectorHeight = 20 + (properties.length * 15);
+        __classPrivateFieldGet(this, _Engine_ctx, "f").fillStyle = 'rgba(0, 0, 0, 0.7)';
+        __classPrivateFieldGet(this, _Engine_ctx, "f").fillRect(x, y, overlayWidth, inspectorHeight);
+        __classPrivateFieldGet(this, _Engine_ctx, "f").strokeStyle = '#00ff00';
+        __classPrivateFieldGet(this, _Engine_ctx, "f").strokeRect(x, y, overlayWidth, inspectorHeight);
+        __classPrivateFieldGet(this, _Engine_ctx, "f").fillStyle = '#00ff00';
+        __classPrivateFieldGet(this, _Engine_ctx, "f").fillText('INSPECTOR', x + 10, y + 5);
+        __classPrivateFieldGet(this, _Engine_ctx, "f").fillStyle = 'white';
+        properties.forEach(([key, val], i) => {
+            __classPrivateFieldGet(this, _Engine_ctx, "f").fillText(`${key}: ${val}`, x + 10, y + 20 + (i * 15));
+        });
+    }
+    __classPrivateFieldGet(this, _Engine_ctx, "f").restore();
+}, _Engine_findAllObjects = function _Engine_findAllObjects(tag = '') {
+    return Array.from(_a.objects).filter((obj) => obj.tag === tag);
+}, _Engine_getSortedArray = function _Engine_getSortedArray(objects = _a.objects) {
+    const arr = Array.from(objects);
+    arr.sort((a, b) => (a.zIndex > b.zIndex ? 1 : -1));
+    return arr;
+};
+/**
+ * Global set of game objects if no scene is active.
+ */
+Engine.objects = new ObjectSet();
+/**
+ * Whether the game loop is currently paused.
+ */
+Engine.paused = false;
+/**
+ * Toggle for visual debug mode (hitboxes and stats).
+ */
+Engine.debug = false;
+/**
+ * The currently selected object in debug mode.
+ */
+Engine.selectedObject = null;
+/**
+ * The global camera instance.
+ */
+Engine.camera = new Camera();
+export default Engine;
+//# sourceMappingURL=Engine.js.map