dino-ge 1.10.3 → 1.10.7

package/README.md

@@ -28,14 +28,18 @@ class MyGame {
   constructor() {
     new Engine({
       onLoad: () => this.onLoad(),
-      update: (dt) => this.onUpdate(dt)
+      update: () => this.onUpdate()
+    }, {
+      title: 'My Game',
+      width: '100%',
+      height: '100%'
     });
   }
 
   onLoad() {
     const player = new Sprite({
       tag: 'player',
-      img: 'player',
+      img: 'player', // Asset tag from ResourceLoader
       rows: 1,
       cols: 4,
       position: new Vector2(400, 300),
@@ -45,7 +49,7 @@ class MyGame {
     player.play();
   }
 
-  onUpdate(dt: number) {
+  onUpdate() {
     // Game logic here
   }
 }

package/dist/Camera.d.ts

@@ -8,9 +8,12 @@ export default class Camera {
     position: Vector2;
     /** Zoom level of the camera. */
     zoom: number;
+    /**
+     * Initializes a new instance of Camera.
+     */
     constructor();
     /**
-     * Center the camera on a target object.
+     * Centers the camera on a target object.
      * @param target The object to follow.
      * @param viewportWidth Width of the viewport.
      * @param viewportHeight Height of the viewport.
@@ -18,8 +21,9 @@ export default class Camera {
     follow(target: GameObject, 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.
+     * @param width Width of the viewport in pixels.
+     * @param height Height of the viewport in pixels.
+     * @returns An object representing the x, y, width, and height of the visible area.
      */
     getViewportBounds(width: number, height: number): {
         x: number;
@@ -28,7 +32,7 @@ export default class Camera {
         height: number;
     };
     /**
-     * Reset camera position to origin and zoom to 1.
+     * Resets the camera position to the origin (0, 0) and zoom to 1.
      */
     reset(): void;
 }

package/dist/Camera.js

@@ -3,6 +3,9 @@ import Vector2 from './Vector2.js';
  * Manages the viewport and transformation of the game world.
  */
 export default class Camera {
+    /**
+     * Initializes a new instance of Camera.
+     */
     constructor() {
         /** Current camera position in world space. */
         this.position = new Vector2(0, 0);
@@ -10,7 +13,7 @@ export default class Camera {
         this.zoom = 1;
     }
     /**
-     * Center the camera on a target object.
+     * Centers the camera on a target object.
      * @param target The object to follow.
      * @param viewportWidth Width of the viewport.
      * @param viewportHeight Height of the viewport.
@@ -24,8 +27,9 @@ export default class Camera {
     }
     /**
      * Returns the current viewport bounds in world space.
-     * @param width Width of the viewport.
-     * @param height Height of the viewport.
+     * @param width Width of the viewport in pixels.
+     * @param height Height of the viewport in pixels.
+     * @returns An object representing the x, y, width, and height of the visible area.
      */
     getViewportBounds(width, height) {
         return {
@@ -36,7 +40,7 @@ export default class Camera {
         };
     }
     /**
-     * Reset camera position to origin and zoom to 1.
+     * Resets the camera position to the origin (0, 0) and zoom to 1.
      */
     reset() {
         this.position.x = 0;

package/dist/Camera.js.map

@@ -1 +1 @@
-{"version":3,"file":"Camera.js","sourceRoot":"","sources":["../src/Camera.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AAGnC;;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,MAAkB,EAAE,aAAqB,EAAE,cAAsB;;QACtE,MAAM,KAAK,GAAG,MAAA,MAAA,MAAM,CAAC,MAAM,0CAAE,KAAK,mCAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAA,MAAA,MAAM,CAAC,MAAM,0CAAE,MAAM,mCAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAC9F,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;IAClG,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"}
+{"version":3,"file":"Camera.js","sourceRoot":"","sources":["../src/Camera.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AAGnC;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,MAAM;IAMzB;;OAEG;IACH;QARA,8CAA8C;QACvC,aAAQ,GAAY,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,gCAAgC;QACzB,SAAI,GAAW,CAAC,CAAC;IAKT,CAAC;IAEhB;;;;;OAKG;IACI,MAAM,CAAC,MAAkB,EAAE,aAAqB,EAAE,cAAsB;;QAC7E,MAAM,KAAK,GAAG,MAAA,MAAA,MAAM,CAAC,MAAM,0CAAE,KAAK,mCAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAA,MAAA,MAAM,CAAC,MAAM,0CAAE,MAAM,mCAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAC9F,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;IAClG,CAAC;IAED;;;;;OAKG;IACI,iBAAiB,CAAC,KAAa,EAAE,MAAc;QACpD,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;IACI,KAAK;QACV,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

@@ -8,14 +8,19 @@ export default class Canvas {
     /** Optional callback fired when the canvas resizes. */
     onResize?: () => void;
     private _resizeObserver?;
+    /**
+     * Initializes a new instance of Canvas.
+     * @param parentElement Optional HTML element to inject the canvas into.
+     */
     constructor(parentElement?: HTMLElement);
     /**
      * Resizes the canvas to match its container or window dimensions.
      * @param parent Optional parent element to match size with.
      */
     resize(parent?: HTMLElement): void;
+    private _onResizeObserved;
     /**
-     * Cleans up resources.
+     * Completely removes the canvas element and cleans up its observers.
      */
     destroy(): void;
 }

package/dist/Canvas.js

@@ -3,6 +3,10 @@
  * Supports full-screen or container-relative sizing.
  */
 export default class Canvas {
+    /**
+     * Initializes a new instance of Canvas.
+     * @param parentElement Optional HTML element to inject the canvas into.
+     */
     constructor(parentElement) {
         this.canvas = document.createElement('canvas');
         this.canvas.id = 'canvas';
@@ -11,7 +15,7 @@ export default class Canvas {
             this.canvas.style.width = '100%';
             this.canvas.style.height = '100%';
             // Use ResizeObserver to handle panel resizing in playground
-            this._resizeObserver = new ResizeObserver(() => this.resize(parentElement));
+            this._resizeObserver = new ResizeObserver(this._onResizeObserved.bind(this, parentElement));
             this._resizeObserver.observe(parentElement);
             this.resize(parentElement);
         }
@@ -29,9 +33,10 @@ export default class Canvas {
      * @param parent Optional parent element to match size with.
      */
     resize(parent) {
-        if (parent) {
-            this.canvas.width = parent.clientWidth;
-            this.canvas.height = parent.clientHeight;
+        const target = parent || this.canvas.parentElement;
+        if (target && target.clientWidth > 0) {
+            this.canvas.width = target.clientWidth;
+            this.canvas.height = target.clientHeight;
         }
         else {
             this.canvas.width = window.innerWidth;
@@ -41,8 +46,11 @@ export default class Canvas {
             this.onResize();
         }
     }
+    _onResizeObserved(parentElement) {
+        this.resize(this.canvas.parentElement || parentElement);
+    }
     /**
-     * Cleans up resources.
+     * Completely removes the canvas element and cleans up its observers.
      */
     destroy() {
         if (this._resizeObserver) {

package/dist/Canvas.js.map

@@ -1 +1 @@
-{"version":3,"file":"Canvas.js","sourceRoot":"","sources":["../src/Canvas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,MAAM;IAQzB,YAAY,aAA2B;QACrC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,CAAC;QAE1B,IAAI,aAAa,EAAE,CAAC;YAClB,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;YAElC,4DAA4D;YAC5D,IAAI,CAAC,eAAe,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;YAC5E,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAoB;QACzB,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;QAC1C,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;CACF"}
+{"version":3,"file":"Canvas.js","sourceRoot":"","sources":["../src/Canvas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,MAAM;IAQzB;;;OAGG;IACH,YAAY,aAA2B;QACrC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,CAAC;QAE1B,IAAI,aAAa,EAAE,CAAC;YAClB,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;YAElC,4DAA4D;YAC5D,IAAI,CAAC,eAAe,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;YAC5F,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,MAAoB;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;QACnD,IAAI,MAAM,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;QAC1C,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAEO,iBAAiB,CAAC,aAA0B;QAClD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,aAAa,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/Circle.d.ts

@@ -19,13 +19,21 @@ export interface CircleProps {
  * A basic circle shape that can be drawn to the screen.
  */
 export default class Circle extends GameObject {
-    /** Radius of the circle. */
+    /** Radius of the circle in local space. */
     radius: number;
-    /** Fill colour. */
+    /** Fill colour (CSS colour string). */
     colour: string;
-    /** Center point of the circle in world space. */
+    /**
+     * The center point of the circle in world space.
+     */
     get center(): Vector2;
-    /** Radius of the circle in world space. */
+    /**
+     * The radius of the circle in world space (accounting for scale).
+     */
     get worldRadius(): number;
+    /**
+     * Initializes a new instance of a Circle.
+     * @param props Configuration properties for the circle.
+     */
     constructor(props: CircleProps);
 }

package/dist/Circle.js

@@ -10,15 +10,23 @@ const defaultProps = {
  * A basic circle shape that can be drawn to the screen.
  */
 export default class Circle extends GameObject {
-    /** Center point of the circle in world space. */
+    /**
+     * The center point of the circle in world space.
+     */
     get center() {
         const r = this.radius * this.transform.worldScale.x;
         return this.transform.worldPosition.add(new Vector2(r, r));
     }
-    /** Radius of the circle in world space. */
+    /**
+     * The radius of the circle in world space (accounting for scale).
+     */
     get worldRadius() {
         return this.radius * this.transform.worldScale.x;
     }
+    /**
+     * Initializes a new instance of a Circle.
+     * @param props Configuration properties for the circle.
+     */
     constructor(props) {
         super(props.tag || defaultProps.tag, props.zIndex || defaultProps.zIndex);
         const defaultedProps = Object.assign(Object.assign({}, defaultProps), props);

package/dist/Circle.js.map

@@ -1 +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;AACzC,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAkBjD,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;IAM5C,iDAAiD;IACjD,IAAI,MAAM;QACR,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,2CAA2C;IAC3C,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IACnD,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,QAAQ,CAAC,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC;QACvC,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;QAE7C,yFAAyF;QACzF,IAAI,CAAC,YAAY,CAAC,IAAI,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAEvF,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;CACF"}
+{"version":3,"file":"Circle.js","sourceRoot":"","sources":["../src/Circle.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAkBjD,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;IAM5C;;OAEG;IACH,IAAW,MAAM;QACf,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,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,QAAQ,CAAC,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC;QACvC,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;QAE7C,yFAAyF;QACzF,IAAI,CAAC,YAAY,CAAC,IAAI,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAEvF,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/Engine.d.ts

@@ -1,9 +1,9 @@
 import GameObject from './GameObject.js';
 import Scene from './Scene.js';
 import Camera from './Camera.js';
-import System from './System.js';
 import RenderingSystem from './RenderingSystem.js';
 import type { CollisionManifold } from './Physics.js';
+import { ObjectSet } from './ObjectSet.js';
 /**
  * Options for initializing the Engine.
  */
@@ -30,39 +30,6 @@ export interface EngineCallbacks {
     /** 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[];
-    constructor();
-}
-/**
- * Interface for the shared global state of the Engine.
- */
-export interface EngineState {
-    objects: ObjectSet;
-    paused: boolean;
-    debug: boolean;
-    selectedObject: GameObject | null;
-    camera: Camera;
-    systems: System[];
-    renderingSystem?: RenderingSystem;
-    events: EventTarget;
-    currentScene: Scene | null;
-    debugCollisions: {
-        manifold: CollisionManifold;
-        timestamp: number;
-    }[];
-    showPhysicsVectors: boolean;
-    showCollisionLines: boolean;
-    zOrderDirty: boolean;
-    sortedObjects: GameObject[];
-}
 /**
  * The core singleton class that manages the game loop, rendering, and scene state.
  */
@@ -171,6 +138,9 @@ export default class Engine {
     private _ctx;
     private _window;
     private _title;
+    private _isWindowInternal;
+    private _destroyed;
+    private _resizeHandler;
     /** Current background colour. */
     backgroundColour: string;
     /** Registered engine callbacks. */
@@ -179,9 +149,13 @@ export default class Engine {
     width: number;
     /** Pixel height of the canvas. */
     height: number;
-    /** Current mouse x position in world space. */
+    /**
+     * Current mouse x position in world space.
+     */
     get mouseX(): number;
-    /** Current mouse y position in world space. */
+    /**
+     * Current mouse y position in world space.
+     */
     get mouseY(): number;
     /** Current frames per second (rolling average). */
     fps: number;
@@ -192,39 +166,58 @@ export default class Engine {
     private _accumulator;
     private _fixedDelta;
     private _fpsValues;
+    /**
+     * Initializes a new instance of the Engine.
+     * @param callbacks Lifecycle and update callbacks.
+     * @param opts Configuration options for the engine.
+     */
     constructor(callbacks: EngineCallbacks, opts?: Partial<EngineOpts>);
+    /**
+     * Completely stops the engine and cleans up all resources.
+     */
+    terminate(): void;
     private _onLoad;
     private _update;
     private _fixedUpdate;
     private _setBackground;
     private _draw;
+    /**
+     * Cleans up expired debug collisions.
+     * @param now Current timestamp.
+     */
+    static cleanDebugCollisions(now?: number): void;
     private _drawDebug;
-    private _findAllObjects;
     /**
-     * Promisified setTimeout.
-     * @param timeoutFn The function to run after the timeout.
-     * @param time The time in milliseconds to wait.
+     * Schedules a function to run after a delay.
+     * @param callback The function to run.
+     * @param delay The delay in milliseconds.
+     * @returns A timer ID.
      */
-    setTimeout(timeoutFn: () => void, time: number): Promise<void>;
+    setTimeout(callback: () => void, delay: number): number;
     /**
-     * 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.
+     * Starts a countdown timer that runs a function every second and an ending function.
+     * @param milliseconds The total duration of the countdown.
+     * @param fn The function to run every second.
+     * @param onEnded The function to run when the countdown is finished.
      */
     countdown(milliseconds: number, fn: () => void, onEnded: () => void): void;
-    /** Sets the CSS cursor style for the game canvas. */
+    /**
+     * Sets the CSS cursor style for the game canvas.
+     * @param value The CSS cursor value (e.g., 'pointer', 'crosshair').
+     */
     set cursor(value: string);
     /**
-     * Register a new game object with the active scene or global engine.
+     * Registers a game object with the active scene or global engine loop.
      * @param object The object to register.
      */
     static registerObject(object: GameObject): void;
     /**
-     * Remove a game object from the active scene or global engine.
+     * Removes a game object from the active scene or global engine loop.
      * @param object The object to destroy.
      */
     static destroyObject(object: GameObject): void;
-    /** Destroy all objects in the active scene or global engine. */
+    /**
+     * Destroy all objects in the active scene or global engine.
+     */
     static destroyAll(): void;
 }

package/dist/Engine.js

@@ -1,27 +1,11 @@
-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());
-    });
-};
 import Canvas from './Canvas.js';
 import Input from './Input.js';
 import Camera from './Camera.js';
 import PhysicsSystem from './PhysicsSystem.js';
 import RenderingSystem from './RenderingSystem.js';
+import Registry from './Registry.js';
 import PhysicsComponent from './PhysicsComponent.js';
-/**
- * Specialized Set for managing game objects with helper methods.
- */
-export class ObjectSet extends Set {
-    constructor() {
-        super();
-        this.findAll = () => [];
-    }
-}
+import { ObjectSet } from './ObjectSet.js';
 /**
  * Shared state for the engine to ensure singletons work across different module loads.
  */
@@ -143,7 +127,12 @@ export default class Engine {
      * The currently selected object in debug mode.
      */
     static get selectedObject() { return this._state.selectedObject; }
-    static set selectedObject(val) { this._state.selectedObject = val; }
+    static set selectedObject(val) {
+        if (this._state.selectedObject !== val) {
+            this._state.selectedObject = val;
+            this.emit('selectedObjectChanged', val);
+        }
+    }
     /**
      * Whether the global object list needs to be re-sorted by z-index.
      */
@@ -175,15 +164,26 @@ export default class Engine {
             scene.onLoad();
         }
     }
-    /** Current mouse x position in world space. */
+    /**
+     * Current mouse x position in world space.
+     */
     get mouseX() {
         return Input.mouseX;
     }
-    /** Current mouse y position in world space. */
+    /**
+     * Current mouse y position in world space.
+     */
     get mouseY() {
         return Input.mouseY;
     }
+    /**
+     * Initializes a new instance of the Engine.
+     * @param callbacks Lifecycle and update callbacks.
+     * @param opts Configuration options for the engine.
+     */
     constructor(callbacks, opts = {}) {
+        this._isWindowInternal = false;
+        this._destroyed = false;
         /** Current frames per second (rolling average). */
         this.fps = 0;
         /** Current frame time in milliseconds. */
@@ -193,8 +193,13 @@ export default class Engine {
         this._accumulator = 0;
         this._fixedDelta = 1 / 60;
         this._fpsValues = [];
+        // Terminate existing engine if any
+        const global = globalThis;
+        if (global.__DINO_ENGINE_INSTANCE__) {
+            global.__DINO_ENGINE_INSTANCE__.terminate();
+        }
+        global.__DINO_ENGINE_INSTANCE__ = this;
         const defaultedOpts = Object.assign({ width: '100%', height: '100%', title: 'Example', backgroundColour: 'white' }, opts);
-        Engine.objects.findAll = this._findAllObjects.bind(this);
         this._title = document.createElement('title');
         this._title.innerHTML = defaultedOpts.title;
         const heads = document.getElementsByTagName('head');
@@ -226,6 +231,7 @@ export default class Engine {
             Engine.renderingSystem = new RenderingSystem(this._ctx);
         }
         if (!container) {
+            this._isWindowInternal = true;
             this._window = document.createElement('div');
             this._window.id = 'canvas-container';
             this._window.style.width = defaultedOpts.width;
@@ -240,18 +246,45 @@ export default class Engine {
             this._window = container;
         }
         Input.init();
-        window.addEventListener('resize', () => {
-            this._canvas.resize(container || undefined);
+        this._canvas.onResize = () => {
+            var _a;
             this.width = this._canvas.canvas.width;
             this.height = this._canvas.canvas.height;
-        });
+            if ((_a = Engine.currentScene) === null || _a === void 0 ? void 0 : _a.onResize) {
+                Engine.currentScene.onResize(this.width, this.height);
+            }
+        };
+        this._resizeHandler = () => {
+            this._canvas.resize(container || undefined);
+        };
+        window.addEventListener('resize', this._resizeHandler);
         setTimeout(() => { var _a, _b; return (_b = (_a = this.callbacks).onLoad) === null || _b === void 0 ? void 0 : _b.call(_a); }, 0);
     }
+    /**
+     * Completely stops the engine and cleans up all resources.
+     */
+    terminate() {
+        this._destroyed = true;
+        window.removeEventListener('resize', this._resizeHandler);
+        this._canvas.destroy();
+        if (this._isWindowInternal && this._window) {
+            this._window.remove();
+        }
+        if (this._title) {
+            this._title.remove();
+        }
+        const global = globalThis;
+        if (global.__DINO_ENGINE_INSTANCE__ === this) {
+            global.__DINO_ENGINE_INSTANCE__ = null;
+        }
+    }
     _onLoad() {
         this._draw();
         window.requestAnimationFrame(this._update.bind(this));
     }
     _update(timestamp) {
+        if (this._destroyed)
+            return;
         if (this._oldTimestamp === 0)
             this._oldTimestamp = timestamp;
         if (!Engine.paused) {
@@ -312,6 +345,16 @@ export default class Engine {
             this._drawDebug(objects);
         }
     }
+    /**
+     * Cleans up expired debug collisions.
+     * @param now Current timestamp.
+     */
+    static cleanDebugCollisions(now = Date.now()) {
+        const TTL = 500; // 500ms
+        while (this.debugCollisions.length > 0 && now - this.debugCollisions[0].timestamp > TTL) {
+            this.debugCollisions.shift();
+        }
+    }
     _drawDebug(objects) {
         var _a, _b, _c, _d;
         // Draw Stats Overlay (Top Right)
@@ -365,75 +408,55 @@ export default class Engine {
         }
         this._ctx.restore();
     }
-    _findAllObjects(tag = '') {
-        if (!tag) {
-            return Array.from(Engine.objects);
-        }
-        return Array.from(Engine.objects).filter((obj) => obj.metadata.tag === tag);
-    }
     /**
-     * Promisified setTimeout.
-     * @param timeoutFn The function to run after the timeout.
-     * @param time The time in milliseconds to wait.
+     * Schedules a function to run after a delay.
+     * @param callback The function to run.
+     * @param delay The delay in milliseconds.
+     * @returns A timer ID.
      */
-    setTimeout(timeoutFn, time) {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield new Promise((resolve) => {
-                setTimeout(resolve, time);
-            });
-            timeoutFn();
-        });
+    setTimeout(callback, delay) {
+        return window.setTimeout(callback, delay);
     }
     /**
-     * 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.
+     * Starts a countdown timer that runs a function every second and an ending function.
+     * @param milliseconds The total duration of the countdown.
+     * @param fn The function to run every second.
+     * @param onEnded The function to run when the countdown is finished.
      */
     countdown(milliseconds, fn, onEnded) {
-        setTimeout(onEnded, milliseconds);
+        this.setTimeout(onEnded, milliseconds);
         for (let i = 1; i <= milliseconds; i += 1) {
             if (i % 1000 === 0) {
-                setTimeout(fn, i);
+                this.setTimeout(fn, i);
             }
         }
     }
-    /** Sets the CSS cursor style for the game canvas. */
+    /**
+     * Sets the CSS cursor style for the game canvas.
+     * @param value The CSS cursor value (e.g., 'pointer', 'crosshair').
+     */
     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.
+     * Registers a game object with the active scene or global engine loop.
      * @param object The object to register.
      */
     static registerObject(object) {
-        this.zOrderDirty = true;
-        if (Engine.currentScene) {
-            Engine.currentScene.add(object);
-        }
-        else {
-            this.objects.add(object);
-        }
+        Registry.registerObject(object);
     }
     /**
-     * Remove a game object from the active scene or global engine.
+     * Removes a game object from the active scene or global engine loop.
      * @param object The object to destroy.
      */
     static destroyObject(object) {
-        this.zOrderDirty = true;
-        if (this.selectedObject === object) {
-            this.selectedObject = null;
-        }
-        if (Engine.currentScene) {
-            Engine.currentScene.remove(object);
-        }
-        else {
-            this.objects.delete(object);
-        }
+        Registry.destroyObject(object);
     }
-    /** Destroy all objects in the active scene or global engine. */
+    /**
+     * Destroy all objects in the active scene or global engine.
+     */
     static destroyAll() {
         this.zOrderDirty = true;
         if (Engine.currentScene) {