@starweb-libs/engine 0.0.1 → 0.0.3

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Starweb Libraries, Mason L'Etoile
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Starweb Libraries, Mason L'Etoile
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,28 +1,28 @@
-# Starweb Engine
-
-A lightweight 2D game engine for the browser, built with TypeScript and the Web Audio / Canvas APIs.
-
-## Tech Stack
-<p align="left">
-  <img height="35" src="https://img.shields.io/badge/TypeScript-%23007ACC?logo=typescript&logoColor=white&style=for-the-badge"/>
-  <img height="35" src="https://img.shields.io/badge/Web%20Audio%20API-black?logo=webaudio&logoColor=white&style=for-the-badge"/>
-  <img height="35" src="https://img.shields.io/badge/Canvas%20API-black?logo=html5&logoColor=white&style=for-the-badge"/>
-</p>
-
-## Modules
-| Module           | Description                                       |
-| ------           | -----------                                       |
-| `canvas`         | Fullscreen canvas setup with resize handling      |
-| `update`         | Fixed or variable timestep game loop              |
-| `assets`         | Image loading and tinting                         |
-| `input/keyboard` | Per-frame keyboard state                          |
-| `input/pointer`  | Per-frame pointer/mouse state with canvas scaling |
-| `validate`       | JSON validation helpers and error collector       |
-
-## Installation
-```bash
-npm install github:starweb-libs/engine
-```
-
-## License
-MIT License - see [LICENSE](./LICENSE) for details.
+# Starweb Engine
+
+A lightweight 2D game engine for the browser, built with TypeScript and the Web Audio / Canvas APIs.
+
+## Tech Stack
+<p align="left">
+  <img height="35" src="https://img.shields.io/badge/TypeScript-%23007ACC?logo=typescript&logoColor=white&style=for-the-badge"/>
+  <img height="35" src="https://img.shields.io/badge/Web%20Audio%20API-black?logo=webaudio&logoColor=white&style=for-the-badge"/>
+  <img height="35" src="https://img.shields.io/badge/Canvas%20API-black?logo=html5&logoColor=white&style=for-the-badge"/>
+</p>
+
+## Modules
+| Module           | Description                                       |
+| ------           | -----------                                       |
+| `canvas`         | Fullscreen canvas setup with resize handling      |
+| `update`         | Fixed or variable timestep game loop              |
+| `assets`         | Image loading and tinting                         |
+| `input/keyboard` | Per-frame keyboard state                          |
+| `input/pointer`  | Per-frame pointer/mouse state with canvas scaling |
+| `validate`       | JSON validation helpers and error collector       |
+
+## Installation
+```bash
+npm install github:starweb-libs/engine
+```
+
+## License
+MIT License - see [LICENSE](./LICENSE) for details.

package/dist/{assets.d.ts → assets.d.mts}

@@ -1,10 +1,11 @@
+//#region src/assets.d.ts
 /** Loads an image from the given Path or URL.
  *
  * @param src - Path or URL of the image to load.
  * @returns A promise that resolves with the loaded {@link HTMLImageElement}.
  * @throws {Error} If the image fails to load.
  */
-export declare function loadImage(src: string): Promise<HTMLImageElement>;
+declare function loadImage(src: string): Promise<HTMLImageElement>;
 /** Returns a new offscreen canvas with the source image tinted by the given colour.
  *  Non-transparent pixels are filled with `color`; transparency is preserved.
  *
@@ -13,5 +14,7 @@ export declare function loadImage(src: string): Promise<HTMLImageElement>;
  * @returns An offscreen {@link HTMLCanvasElement} with the tinted result.
  * @throws {Error} If a 2D context cannot be obtained.
  */
-export declare function tintImage(source: HTMLImageElement, color: string): HTMLCanvasElement;
-//# sourceMappingURL=assets.d.ts.map
+declare function tintImage(source: HTMLImageElement, color: string): HTMLCanvasElement;
+//#endregion
+export { loadImage, tintImage };
+//# sourceMappingURL=assets.d.mts.map

package/dist/assets.mjs

@@ -0,0 +1,39 @@
+//#region src/assets.ts
+/** Loads an image from the given Path or URL.
+*
+* @param src - Path or URL of the image to load.
+* @returns A promise that resolves with the loaded {@link HTMLImageElement}.
+* @throws {Error} If the image fails to load.
+*/
+function loadImage(src) {
+	return new Promise((resolve, reject) => {
+		const img = new Image();
+		img.onload = () => resolve(img);
+		img.onerror = () => reject(/* @__PURE__ */ new Error(`Failed to load image: ${src}`));
+		img.src = src;
+	});
+}
+/** Returns a new offscreen canvas with the source image tinted by the given colour.
+*  Non-transparent pixels are filled with `color`; transparency is preserved.
+*
+* @param source - The source image to tint.
+* @param color - Any valid CSS colour string.
+* @returns An offscreen {@link HTMLCanvasElement} with the tinted result.
+* @throws {Error} If a 2D context cannot be obtained.
+*/
+function tintImage(source, color) {
+	const off = document.createElement("canvas");
+	off.width = source.width;
+	off.height = source.height;
+	const c = off.getContext("2d");
+	if (!c) throw new Error("Failed to get offscreen 2d context");
+	c.drawImage(source, 0, 0);
+	c.globalCompositeOperation = "source-in";
+	c.fillStyle = color;
+	c.fillRect(0, 0, off.width, off.height);
+	return off;
+}
+//#endregion
+export { loadImage, tintImage };
+
+//# sourceMappingURL=assets.mjs.map

package/dist/assets.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.mjs","names":[],"sources":["../src/assets.ts"],"sourcesContent":["/** Loads an image from the given Path or URL.\n *\n * @param src - Path or URL of the image to load.\n * @returns A promise that resolves with the loaded {@link HTMLImageElement}.\n * @throws {Error} If the image fails to load.\n */\nexport function loadImage(src: string): Promise<HTMLImageElement> {\n  return new Promise((resolve, reject) => {\n    const img = new Image();\n    img.onload  = () => resolve(img);\n    img.onerror = () => reject(new Error(`Failed to load image: ${src}`));\n    img.src = src;\n  });\n}\n\n/** Returns a new offscreen canvas with the source image tinted by the given colour.\n *  Non-transparent pixels are filled with `color`; transparency is preserved.\n *\n * @param source - The source image to tint.\n * @param color - Any valid CSS colour string.\n * @returns An offscreen {@link HTMLCanvasElement} with the tinted result.\n * @throws {Error} If a 2D context cannot be obtained.\n */\nexport function tintImage(\n  source: HTMLImageElement,\n  color: string,\n): HTMLCanvasElement {\n  const off = document.createElement(\"canvas\");\n  off.width = source.width;\n  off.height = source.height;\n  const c = off.getContext(\"2d\");\n  if (!c) throw new Error(\"Failed to get offscreen 2d context\");\n\n  c.drawImage(source, 0, 0);\n  c.globalCompositeOperation = \"source-in\";\n  c.fillStyle = color;\n  c.fillRect(0, 0, off.width, off.height);\n\n  return off;\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,UAAU,KAAwC;CAChE,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,MAAM,IAAI,MAAM;EACtB,IAAI,eAAgB,QAAQ,GAAG;EAC/B,IAAI,gBAAgB,uBAAO,IAAI,MAAM,yBAAyB,KAAK,CAAC;EACpE,IAAI,MAAM;CACZ,CAAC;AACH;;;;;;;;;AAUA,SAAgB,UACd,QACA,OACmB;CACnB,MAAM,MAAM,SAAS,cAAc,QAAQ;CAC3C,IAAI,QAAQ,OAAO;CACnB,IAAI,SAAS,OAAO;CACpB,MAAM,IAAI,IAAI,WAAW,IAAI;CAC7B,IAAI,CAAC,GAAG,MAAM,IAAI,MAAM,oCAAoC;CAE5D,EAAE,UAAU,QAAQ,GAAG,CAAC;CACxB,EAAE,2BAA2B;CAC7B,EAAE,YAAY;CACd,EAAE,SAAS,GAAG,GAAG,IAAI,OAAO,IAAI,MAAM;CAEtC,OAAO;AACT"}

package/dist/canvas.d.mts

@@ -0,0 +1,36 @@
+//#region src/canvas.d.ts
+/** Options for configuring the game canvas. */
+interface CanvasOptions {
+  /** Enables or disables `imageSmoothingEnabled` on the canvas context. Default: `true`. */
+  imageSmoothing?: boolean;
+}
+/** The result of {@link createGameCanvas}. */
+interface GameCanvas {
+  /** The underlying canvas element. */
+  canvas: HTMLCanvasElement;
+  /** The 2D rendering context for the canvas. */
+  ctx: CanvasRenderingContext2D;
+  /** Canvas width and height. */
+  size: {
+    readonly width: number;
+    readonly height: number;
+  };
+  /** Removes the canvas from the DOM and cleans up the resize listener. */
+  destroy: () => void;
+}
+/** Creates a full-window canvas and appends it to `document.body`.
+ *
+ * The canvas is automatically resized to fill the window on creation,
+ * and on every subsequent `resize` event.
+ *
+ * @returns The canvas element, its 2D context, and a `destroy` function
+ * to remove the canvas and clean up the resize listener.
+ *
+ * @throws {Error} If a 2D canvas context cannot be obtained.
+ */
+declare function createGameCanvas({
+  imageSmoothing
+}?: CanvasOptions): GameCanvas;
+//#endregion
+export { CanvasOptions, GameCanvas, createGameCanvas };
+//# sourceMappingURL=canvas.d.mts.map

package/dist/canvas.mjs

@@ -0,0 +1,50 @@
+//#region src/canvas.ts
+/** Creates a full-window canvas and appends it to `document.body`.
+*
+* The canvas is automatically resized to fill the window on creation,
+* and on every subsequent `resize` event.
+*
+* @returns The canvas element, its 2D context, and a `destroy` function
+* to remove the canvas and clean up the resize listener.
+*
+* @throws {Error} If a 2D canvas context cannot be obtained.
+*/
+function createGameCanvas({ imageSmoothing = true } = {}) {
+	const canvas = document.createElement("canvas");
+	document.body.appendChild(canvas);
+	const ctx = canvas.getContext("2d");
+	if (!ctx) throw new Error("2D canvas context not found");
+	const size = {
+		width: 0,
+		height: 0
+	};
+	const onResize = () => {
+		const dpr = window.devicePixelRatio ?? 1;
+		size.width = window.innerWidth;
+		size.height = window.innerHeight;
+		canvas.width = size.width * dpr;
+		canvas.height = size.height * dpr;
+		canvas.style.width = `${size.width}px`;
+		canvas.style.height = `${size.height}px`;
+		ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+		ctx.imageSmoothingEnabled = imageSmoothing;
+	};
+	window.addEventListener("resize", onResize);
+	onResize();
+	let destroyed = false;
+	return {
+		canvas,
+		ctx,
+		size,
+		destroy: () => {
+			if (destroyed) return;
+			destroyed = true;
+			window.removeEventListener("resize", onResize);
+			canvas.remove();
+		}
+	};
+}
+//#endregion
+export { createGameCanvas };
+
+//# sourceMappingURL=canvas.mjs.map

package/dist/canvas.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.mjs","names":[],"sources":["../src/canvas.ts"],"sourcesContent":["/** Options for configuring the game canvas. */\nexport interface CanvasOptions {\n  /** Enables or disables `imageSmoothingEnabled` on the canvas context. Default: `true`. */\n  imageSmoothing?: boolean;\n}\n\n/** The result of {@link createGameCanvas}. */\nexport interface GameCanvas {\n  /** The underlying canvas element. */\n  canvas:  HTMLCanvasElement;\n  /** The 2D rendering context for the canvas. */\n  ctx:     CanvasRenderingContext2D;\n  /** Canvas width and height. */\n  size:    { readonly width: number; readonly height: number };\n  /** Removes the canvas from the DOM and cleans up the resize listener. */\n  destroy: () => void;\n}\n\n/** Creates a full-window canvas and appends it to `document.body`.\n *\n * The canvas is automatically resized to fill the window on creation,\n * and on every subsequent `resize` event.\n *\n * @returns The canvas element, its 2D context, and a `destroy` function\n * to remove the canvas and clean up the resize listener.\n *\n * @throws {Error} If a 2D canvas context cannot be obtained.\n */\nexport function createGameCanvas(\n  { imageSmoothing = true }: CanvasOptions = {}\n): GameCanvas {\n  const canvas = document.createElement(\"canvas\");\n  document.body.appendChild(canvas);\n\n  const ctx = canvas.getContext(\"2d\");\n  if (!ctx) throw new Error(\"2D canvas context not found\");\n\n  const size = { width: 0, height: 0 };\n\n  const onResize = () => {\n    const dpr     = window.devicePixelRatio ?? 1;\n    size.width   = window.innerWidth;\n    size.height  = window.innerHeight;\n    canvas.width  = size.width  * dpr;\n    canvas.height = size.height * dpr;\n    canvas.style.width  = `${size.width}px`;\n    canvas.style.height = `${size.height}px`;\n    ctx.setTransform(dpr, 0, 0, dpr, 0, 0);\n    ctx.imageSmoothingEnabled = imageSmoothing;\n  }\n  window.addEventListener(\"resize\", onResize);\n  onResize();\n\n  let destroyed = false;\n  return {\n    canvas,\n    ctx,\n    size,\n    destroy: () => {\n      if (destroyed) return;\n      destroyed = true;\n      window.removeEventListener(\"resize\", onResize);\n      canvas.remove();\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;AA4BA,SAAgB,iBACd,EAAE,iBAAiB,SAAwB,CAAC,GAChC;CACZ,MAAM,SAAS,SAAS,cAAc,QAAQ;CAC9C,SAAS,KAAK,YAAY,MAAM;CAEhC,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KAAK,MAAM,IAAI,MAAM,6BAA6B;CAEvD,MAAM,OAAO;EAAE,OAAO;EAAG,QAAQ;CAAE;CAEnC,MAAM,iBAAiB;EACrB,MAAM,MAAU,OAAO,oBAAoB;EAC3C,KAAK,QAAU,OAAO;EACtB,KAAK,SAAU,OAAO;EACtB,OAAO,QAAS,KAAK,QAAS;EAC9B,OAAO,SAAS,KAAK,SAAS;EAC9B,OAAO,MAAM,QAAS,GAAG,KAAK,MAAM;EACpC,OAAO,MAAM,SAAS,GAAG,KAAK,OAAO;EACrC,IAAI,aAAa,KAAK,GAAG,GAAG,KAAK,GAAG,CAAC;EACrC,IAAI,wBAAwB;CAC9B;CACA,OAAO,iBAAiB,UAAU,QAAQ;CAC1C,SAAS;CAET,IAAI,YAAY;CAChB,OAAO;EACL;EACA;EACA;EACA,eAAe;GACb,IAAI,WAAW;GACf,YAAY;GACZ,OAAO,oBAAoB,UAAU,QAAQ;GAC7C,OAAO,OAAO;EAChB;CACF;AACF"}

package/dist/input/{keyboard.d.ts → keyboard.d.mts}

@@ -1,18 +1,21 @@
+//#region src/input/keyboard.d.ts
 /** Initializes keyboard input listeners.
  * @returns A cleanup function that removes all listeners and clears state.
  * @throws {Error} If already initialized.
  */
-export declare function initKeyboard(): () => void;
+declare function initKeyboard(): () => void;
 /** Returns `true` if the key is currently held down.
  * @param code - A `KeyboardEvent.code` value (e.g. `"KeyA"`, `"Space"`, `"Digit1"`).
  */
-export declare function isDown(code: string): boolean;
+declare function isDown(code: string): boolean;
 /** Returns `true` if the key was pressed this frame.
  * @param code - A `KeyboardEvent.code` value (e.g. `"KeyA"`, `"Space"`).
  */
-export declare function wasPressed(code: string): boolean;
+declare function wasPressed(code: string): boolean;
 /** Advances the per-frame pressed state. Called once per frame by {@link startLoop}. */
-export declare function clearFrameKeyboard(): void;
+declare function clearFrameKeyboard(): void;
 /** Clears the per-frame pressed state immediately. */
-export declare function flushKeyboard(): void;
-//# sourceMappingURL=keyboard.d.ts.map
+declare function flushKeyboard(): void;
+//#endregion
+export { clearFrameKeyboard, flushKeyboard, initKeyboard, isDown, wasPressed };
+//# sourceMappingURL=keyboard.d.mts.map

package/dist/input/keyboard.mjs

@@ -0,0 +1,61 @@
+//#region src/input/keyboard.ts
+let isKeyboardInitialized = false;
+const keys = /* @__PURE__ */ new Set();
+const pressedThisFrame = /* @__PURE__ */ new Set();
+let pressedFrame = [];
+const onKeyDown = (e) => {
+	if (!keys.has(e.code)) pressedThisFrame.add(e.code);
+	keys.add(e.code);
+};
+const onKeyUp = (e) => {
+	keys.delete(e.code);
+};
+const onBlur = () => {
+	keys.clear();
+	pressedThisFrame.clear();
+};
+/** Initializes keyboard input listeners.
+* @returns A cleanup function that removes all listeners and clears state.
+* @throws {Error} If already initialized.
+*/
+function initKeyboard() {
+	if (isKeyboardInitialized) throw new Error("initKeyboard: already initialized, call cleanup first");
+	isKeyboardInitialized = true;
+	window.addEventListener("keydown", onKeyDown);
+	window.addEventListener("keyup", onKeyUp);
+	window.addEventListener("blur", onBlur);
+	return () => {
+		isKeyboardInitialized = false;
+		keys.clear();
+		pressedThisFrame.clear();
+		flushKeyboard();
+		window.removeEventListener("keydown", onKeyDown);
+		window.removeEventListener("keyup", onKeyUp);
+		window.removeEventListener("blur", onBlur);
+	};
+}
+/** Returns `true` if the key is currently held down.
+* @param code - A `KeyboardEvent.code` value (e.g. `"KeyA"`, `"Space"`, `"Digit1"`).
+*/
+function isDown(code) {
+	return keys.has(code);
+}
+/** Returns `true` if the key was pressed this frame.
+* @param code - A `KeyboardEvent.code` value (e.g. `"KeyA"`, `"Space"`).
+*/
+function wasPressed(code) {
+	return pressedFrame.includes(code);
+}
+/** Advances the per-frame pressed state. Called once per frame by {@link startLoop}. */
+function clearFrameKeyboard() {
+	pressedFrame = [...pressedThisFrame];
+	pressedThisFrame.clear();
+}
+/** Clears the per-frame pressed state immediately. */
+function flushKeyboard() {
+	pressedFrame = [];
+}
+//#endregion
+export { clearFrameKeyboard, flushKeyboard, initKeyboard, isDown, wasPressed };
+
+//# sourceMappingURL=keyboard.mjs.map

package/dist/input/keyboard.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.mjs","names":[],"sources":["../../src/input/keyboard.ts"],"sourcesContent":["let isKeyboardInitialized = false;\nconst keys = new Set<string>();\nconst pressedThisFrame = new Set<string>();\nlet pressedFrame: readonly string[] = [];\n\nconst onKeyDown = (e: KeyboardEvent) => {\n  if (!keys.has(e.code)) pressedThisFrame.add(e.code);\n  keys.add(e.code);\n};\nconst onKeyUp = (e: KeyboardEvent) => { keys.delete(e.code); };\nconst onBlur = () => { keys.clear(); pressedThisFrame.clear(); };\n\n/** Initializes keyboard input listeners.\n * @returns A cleanup function that removes all listeners and clears state.\n * @throws {Error} If already initialized.\n */\nexport function initKeyboard(): () => void {\n  if (isKeyboardInitialized) throw new Error(\"initKeyboard: already initialized, call cleanup first\");\n  isKeyboardInitialized = true;\n\n  window.addEventListener(\"keydown\", onKeyDown);\n  window.addEventListener(\"keyup\", onKeyUp);\n  window.addEventListener(\"blur\", onBlur);\n\n  return () => {\n    isKeyboardInitialized = false;\n    keys.clear();\n    pressedThisFrame.clear();\n    flushKeyboard();\n    window.removeEventListener(\"keydown\", onKeyDown);\n    window.removeEventListener(\"keyup\", onKeyUp);\n    window.removeEventListener(\"blur\", onBlur);\n  }\n}\n\n/** Returns `true` if the key is currently held down.\n * @param code - A `KeyboardEvent.code` value (e.g. `\"KeyA\"`, `\"Space\"`, `\"Digit1\"`).\n */\nexport function isDown(code: string): boolean     { return keys.has(code); }\n\n/** Returns `true` if the key was pressed this frame.\n * @param code - A `KeyboardEvent.code` value (e.g. `\"KeyA\"`, `\"Space\"`).\n */\nexport function wasPressed(code: string): boolean { return pressedFrame.includes(code); }\n\n/** Advances the per-frame pressed state. Called once per frame by {@link startLoop}. */\nexport function clearFrameKeyboard(): void {\n  pressedFrame = [...pressedThisFrame];\n  pressedThisFrame.clear();\n}\n\n/** Clears the per-frame pressed state immediately. */\nexport function flushKeyboard(): void { pressedFrame = []; }\n"],"mappings":";AAAA,IAAI,wBAAwB;AAC5B,MAAM,uBAAO,IAAI,IAAY;AAC7B,MAAM,mCAAmB,IAAI,IAAY;AACzC,IAAI,eAAkC,CAAC;AAEvC,MAAM,aAAa,MAAqB;CACtC,IAAI,CAAC,KAAK,IAAI,EAAE,IAAI,GAAG,iBAAiB,IAAI,EAAE,IAAI;CAClD,KAAK,IAAI,EAAE,IAAI;AACjB;AACA,MAAM,WAAW,MAAqB;CAAE,KAAK,OAAO,EAAE,IAAI;AAAG;AAC7D,MAAM,eAAe;CAAE,KAAK,MAAM;CAAG,iBAAiB,MAAM;AAAG;;;;;AAM/D,SAAgB,eAA2B;CACzC,IAAI,uBAAuB,MAAM,IAAI,MAAM,uDAAuD;CAClG,wBAAwB;CAExB,OAAO,iBAAiB,WAAW,SAAS;CAC5C,OAAO,iBAAiB,SAAS,OAAO;CACxC,OAAO,iBAAiB,QAAQ,MAAM;CAEtC,aAAa;EACX,wBAAwB;EACxB,KAAK,MAAM;EACX,iBAAiB,MAAM;EACvB,cAAc;EACd,OAAO,oBAAoB,WAAW,SAAS;EAC/C,OAAO,oBAAoB,SAAS,OAAO;EAC3C,OAAO,oBAAoB,QAAQ,MAAM;CAC3C;AACF;;;;AAKA,SAAgB,OAAO,MAA2B;CAAE,OAAO,KAAK,IAAI,IAAI;AAAG;;;;AAK3E,SAAgB,WAAW,MAAuB;CAAE,OAAO,aAAa,SAAS,IAAI;AAAG;;AAGxF,SAAgB,qBAA2B;CACzC,eAAe,CAAC,GAAG,gBAAgB;CACnC,iBAAiB,MAAM;AACzB;;AAGA,SAAgB,gBAAsB;CAAE,eAAe,CAAC;AAAG"}

package/dist/input/{pointer.d.ts → pointer.d.mts}

@@ -1,27 +1,30 @@
+//#region src/input/pointer.d.ts
 /** Initializes pointer input listeners and binds to the given canvas for coordinate mapping.
  * @param canvas - The canvas element used to transform pointer coordinates.
  * @returns A cleanup function that removes all listeners and clears state.
  * @throws {Error} If already initialized.
  */
-export declare function initPointer(canvas: HTMLCanvasElement): () => void;
+declare function initPointer(canvas: HTMLCanvasElement): () => void;
 /** Returns `true` if the given pointer button is currently held down.
  * @param button - Pointer button index. Default: `0` (primary).
  */
-export declare function isPointerDown(button?: number): boolean;
+declare function isPointerDown(button?: number): boolean;
 /** Returns `true` if the given button was clicked this frame.
  * @param button - Pointer button index. Default: `0` (primary).
  */
-export declare function wasPointerClicked(button?: number): boolean;
+declare function wasPointerClicked(button?: number): boolean;
 /** Returns `true` if the given button was released this frame.
  * @param button - Pointer button index. Default: `0` (primary).
  */
-export declare function wasPointerReleased(button?: number): boolean;
+declare function wasPointerReleased(button?: number): boolean;
 /** Returns the pointer's current X position in canvas pixel coordinates. */
-export declare function pointerX(): number;
+declare function pointerX(): number;
 /** Returns the pointer's current Y position in canvas pixel coordinates. */
-export declare function pointerY(): number;
+declare function pointerY(): number;
 /** Advances the per-frame click and release state. Called once per frame by {@link startLoop}. */
-export declare function clearFramePointer(): void;
+declare function clearFramePointer(): void;
 /** Clears the per-frame click and release state immediately. */
-export declare function flushPointer(): void;
-//# sourceMappingURL=pointer.d.ts.map
+declare function flushPointer(): void;
+//#endregion
+export { clearFramePointer, flushPointer, initPointer, isPointerDown, pointerX, pointerY, wasPointerClicked, wasPointerReleased };
+//# sourceMappingURL=pointer.d.mts.map

package/dist/input/pointer.mjs

@@ -0,0 +1,105 @@
+//#region src/input/pointer.ts
+let isPointerInitialized = false;
+const down = /* @__PURE__ */ new Set();
+const clicked = /* @__PURE__ */ new Set();
+const released = /* @__PURE__ */ new Set();
+let clickedFrame = [];
+let releasedFrame = [];
+let canvasRef = null;
+let posX = 0;
+let posY = 0;
+function clearDown() {
+	down.clear();
+	clicked.clear();
+	released.clear();
+}
+const updatePos = (e) => {
+	if (!canvasRef) return;
+	const rect = canvasRef.getBoundingClientRect();
+	posX = e.clientX - rect.left;
+	posY = e.clientY - rect.top;
+};
+const onDown = (e) => {
+	updatePos(e);
+	if (!down.has(e.button)) clicked.add(e.button);
+	down.add(e.button);
+};
+const onUp = (e) => {
+	updatePos(e);
+	down.delete(e.button);
+	released.add(e.button);
+};
+const onMove = (e) => updatePos(e);
+const onBlur = () => clearDown();
+const onMenu = (e) => {
+	clearDown();
+	e.preventDefault();
+};
+/** Initializes pointer input listeners and binds to the given canvas for coordinate mapping.
+* @param canvas - The canvas element used to transform pointer coordinates.
+* @returns A cleanup function that removes all listeners and clears state.
+* @throws {Error} If already initialized.
+*/
+function initPointer(canvas) {
+	if (isPointerInitialized) throw new Error("initPointer: already initialized, call cleanup first");
+	isPointerInitialized = true;
+	canvasRef = canvas;
+	window.addEventListener("pointerdown", onDown);
+	window.addEventListener("pointerup", onUp);
+	window.addEventListener("pointermove", onMove);
+	window.addEventListener("blur", onBlur);
+	window.addEventListener("contextmenu", onMenu);
+	return () => {
+		isPointerInitialized = false;
+		canvasRef = null;
+		clearDown();
+		flushPointer();
+		window.removeEventListener("pointerdown", onDown);
+		window.removeEventListener("pointerup", onUp);
+		window.removeEventListener("pointermove", onMove);
+		window.removeEventListener("blur", onBlur);
+		window.removeEventListener("contextmenu", onMenu);
+	};
+}
+/** Returns `true` if the given pointer button is currently held down.
+* @param button - Pointer button index. Default: `0` (primary).
+*/
+function isPointerDown(button = 0) {
+	return down.has(button);
+}
+/** Returns `true` if the given button was clicked this frame.
+* @param button - Pointer button index. Default: `0` (primary).
+*/
+function wasPointerClicked(button = 0) {
+	return clickedFrame.includes(button);
+}
+/** Returns `true` if the given button was released this frame.
+* @param button - Pointer button index. Default: `0` (primary).
+*/
+function wasPointerReleased(button = 0) {
+	return releasedFrame.includes(button);
+}
+/** Returns the pointer's current X position in canvas pixel coordinates. */
+function pointerX() {
+	return posX;
+}
+/** Returns the pointer's current Y position in canvas pixel coordinates. */
+function pointerY() {
+	return posY;
+}
+/** Advances the per-frame click and release state. Called once per frame by {@link startLoop}. */
+function clearFramePointer() {
+	clickedFrame = [...clicked];
+	releasedFrame = [...released];
+	clicked.clear();
+	released.clear();
+}
+/** Clears the per-frame click and release state immediately. */
+function flushPointer() {
+	clickedFrame = [];
+	releasedFrame = [];
+}
+//#endregion
+export { clearFramePointer, flushPointer, initPointer, isPointerDown, pointerX, pointerY, wasPointerClicked, wasPointerReleased };
+
+//# sourceMappingURL=pointer.mjs.map

package/dist/input/pointer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.mjs","names":[],"sources":["../../src/input/pointer.ts"],"sourcesContent":["let isPointerInitialized = false;\nconst down     = new Set<number>();\nconst clicked  = new Set<number>();\nconst released = new Set<number>();\nlet clickedFrame:  readonly number[] = [];\nlet releasedFrame: readonly number[] = [];\n\nlet canvasRef: HTMLCanvasElement | null = null;\nlet posX = 0;\nlet posY = 0;\n\nfunction clearDown(): void {\n  down.clear();\n  clicked.clear();\n  released.clear();\n}\n\nconst updatePos = (e: PointerEvent) => {\n  if (!canvasRef) return;\n  const rect = canvasRef.getBoundingClientRect();\n  posX = e.clientX - rect.left;\n  posY = e.clientY - rect.top;\n};\n\nconst onDown = (e: PointerEvent) => {\n  updatePos(e);\n  if (!down.has(e.button)) clicked.add(e.button);\n  down.add(e.button);\n};\nconst onUp = (e: PointerEvent) => {\n  updatePos(e);\n  down.delete(e.button);\n  released.add(e.button);\n};\nconst onMove = (e: PointerEvent) => updatePos(e);\nconst onBlur = () => clearDown();\nconst onMenu = (e: MouseEvent) => {\n  clearDown();\n  e.preventDefault();\n}\n\n/** Initializes pointer input listeners and binds to the given canvas for coordinate mapping.\n * @param canvas - The canvas element used to transform pointer coordinates.\n * @returns A cleanup function that removes all listeners and clears state.\n * @throws {Error} If already initialized.\n */\nexport function initPointer(canvas: HTMLCanvasElement): () => void {\n  if (isPointerInitialized) throw new Error(\"initPointer: already initialized, call cleanup first\");\n  isPointerInitialized = true;\n\n  canvasRef = canvas;\n\n  window.addEventListener(\"pointerdown\", onDown);\n  window.addEventListener(\"pointerup\", onUp);\n  window.addEventListener(\"pointermove\", onMove);\n  window.addEventListener(\"blur\", onBlur);\n  window.addEventListener(\"contextmenu\", onMenu);\n\n  return () => {\n    isPointerInitialized = false;\n    canvasRef = null;\n    clearDown();\n    flushPointer();\n    window.removeEventListener(\"pointerdown\", onDown);\n    window.removeEventListener(\"pointerup\", onUp);\n    window.removeEventListener(\"pointermove\", onMove);\n    window.removeEventListener(\"blur\", onBlur);\n    window.removeEventListener(\"contextmenu\", onMenu);\n  };\n}\n\n/** Returns `true` if the given pointer button is currently held down.\n * @param button - Pointer button index. Default: `0` (primary).\n */\nexport function isPointerDown(button = 0): boolean      { return down.has(button); }\n\n/** Returns `true` if the given button was clicked this frame.\n * @param button - Pointer button index. Default: `0` (primary).\n */\nexport function wasPointerClicked(button = 0): boolean  { return clickedFrame.includes(button); }\n\n/** Returns `true` if the given button was released this frame.\n * @param button - Pointer button index. Default: `0` (primary).\n */\nexport function wasPointerReleased(button = 0): boolean { return releasedFrame.includes(button); }\n\n/** Returns the pointer's current X position in canvas pixel coordinates. */\nexport function pointerX(): number { return posX; }\n\n/** Returns the pointer's current Y position in canvas pixel coordinates. */\nexport function pointerY(): number { return posY; }\n\n/** Advances the per-frame click and release state. Called once per frame by {@link startLoop}. */\nexport function clearFramePointer(): void {\n  clickedFrame  = [...clicked];\n  releasedFrame = [...released];\n  clicked.clear();\n  released.clear();\n}\n\n/** Clears the per-frame click and release state immediately. */\nexport function flushPointer(): void { clickedFrame = []; releasedFrame = []; }\n"],"mappings":";AAAA,IAAI,uBAAuB;AAC3B,MAAM,uBAAW,IAAI,IAAY;AACjC,MAAM,0BAAW,IAAI,IAAY;AACjC,MAAM,2BAAW,IAAI,IAAY;AACjC,IAAI,eAAmC,CAAC;AACxC,IAAI,gBAAmC,CAAC;AAExC,IAAI,YAAsC;AAC1C,IAAI,OAAO;AACX,IAAI,OAAO;AAEX,SAAS,YAAkB;CACzB,KAAK,MAAM;CACX,QAAQ,MAAM;CACd,SAAS,MAAM;AACjB;AAEA,MAAM,aAAa,MAAoB;CACrC,IAAI,CAAC,WAAW;CAChB,MAAM,OAAO,UAAU,sBAAsB;CAC7C,OAAO,EAAE,UAAU,KAAK;CACxB,OAAO,EAAE,UAAU,KAAK;AAC1B;AAEA,MAAM,UAAU,MAAoB;CAClC,UAAU,CAAC;CACX,IAAI,CAAC,KAAK,IAAI,EAAE,MAAM,GAAG,QAAQ,IAAI,EAAE,MAAM;CAC7C,KAAK,IAAI,EAAE,MAAM;AACnB;AACA,MAAM,QAAQ,MAAoB;CAChC,UAAU,CAAC;CACX,KAAK,OAAO,EAAE,MAAM;CACpB,SAAS,IAAI,EAAE,MAAM;AACvB;AACA,MAAM,UAAU,MAAoB,UAAU,CAAC;AAC/C,MAAM,eAAe,UAAU;AAC/B,MAAM,UAAU,MAAkB;CAChC,UAAU;CACV,EAAE,eAAe;AACnB;;;;;;AAOA,SAAgB,YAAY,QAAuC;CACjE,IAAI,sBAAsB,MAAM,IAAI,MAAM,sDAAsD;CAChG,uBAAuB;CAEvB,YAAY;CAEZ,OAAO,iBAAiB,eAAe,MAAM;CAC7C,OAAO,iBAAiB,aAAa,IAAI;CACzC,OAAO,iBAAiB,eAAe,MAAM;CAC7C,OAAO,iBAAiB,QAAQ,MAAM;CACtC,OAAO,iBAAiB,eAAe,MAAM;CAE7C,aAAa;EACX,uBAAuB;EACvB,YAAY;EACZ,UAAU;EACV,aAAa;EACb,OAAO,oBAAoB,eAAe,MAAM;EAChD,OAAO,oBAAoB,aAAa,IAAI;EAC5C,OAAO,oBAAoB,eAAe,MAAM;EAChD,OAAO,oBAAoB,QAAQ,MAAM;EACzC,OAAO,oBAAoB,eAAe,MAAM;CAClD;AACF;;;;AAKA,SAAgB,cAAc,SAAS,GAAiB;CAAE,OAAO,KAAK,IAAI,MAAM;AAAG;;;;AAKnF,SAAgB,kBAAkB,SAAS,GAAa;CAAE,OAAO,aAAa,SAAS,MAAM;AAAG;;;;AAKhG,SAAgB,mBAAmB,SAAS,GAAY;CAAE,OAAO,cAAc,SAAS,MAAM;AAAG;;AAGjG,SAAgB,WAAmB;CAAE,OAAO;AAAM;;AAGlD,SAAgB,WAAmB;CAAE,OAAO;AAAM;;AAGlD,SAAgB,oBAA0B;CACxC,eAAgB,CAAC,GAAG,OAAO;CAC3B,gBAAgB,CAAC,GAAG,QAAQ;CAC5B,QAAQ,MAAM;CACd,SAAS,MAAM;AACjB;;AAGA,SAAgB,eAAqB;CAAE,eAAe,CAAC;CAAG,gBAAgB,CAAC;AAAG"}

package/dist/update.d.mts

@@ -0,0 +1,37 @@
+//#region src/update.d.ts
+/** Options for configuring the game loop. */
+interface LoopOptions {
+  /** Fixed timestep in **ms**, or "variable" for frame-rate dependent updates. */
+  tickRate: number | "variable";
+  /** Maximum elapsed time per frame in **ms**. */
+  maxDelta: number;
+  /** Automatically pause the loop when the page is hidden. */
+  pauseOnHidden: boolean;
+}
+/** Handle returned by {@link startLoop} to control the running game loop. */
+interface LoopHandle {
+  /** Permanently stops the loop and cancels the animation frame. */
+  stop(): void;
+  /** Pauses update and render calls without cancelling the animation frame. */
+  pause(): void;
+  /** Resumes a paused loop. */
+  resume(): void;
+}
+/** Starts a game loop using `requestAnimationFrame`.
+ *
+ * When `tickRate` is a number, uses a fixed timestep accumulator
+ * so `update` is always called with a consistent delta.
+ * When `"variable"`, `update` receives the raw frame delta.
+ *
+ * @param update - Called each tick with the delta time in **ms**.
+ * @param render - Called once per frame after all update ticks.
+ * @param options - Loop configuration. See {@link LoopOptions}.
+ * @returns A {@link LoopHandle} to stop, pause, or resume the loop.
+ *
+ * @throws {RangeError} If `tickRate` is not `"variable"` or a positive finite number.
+ * @throws {RangeError} If `maxDelta` is not a positive finite number.
+ */
+declare function startLoop(update: (/** **Milliseconds** */dt: number) => void, render: () => void, options: LoopOptions): LoopHandle;
+//#endregion
+export { LoopHandle, LoopOptions, startLoop };
+//# sourceMappingURL=update.d.mts.map

package/dist/update.mjs

@@ -0,0 +1,82 @@
+import { clearFrameKeyboard } from "./input/keyboard.mjs";
+import { clearFramePointer } from "./input/pointer.mjs";
+//#region src/update.ts
+/** Starts a game loop using `requestAnimationFrame`.
+*
+* When `tickRate` is a number, uses a fixed timestep accumulator
+* so `update` is always called with a consistent delta.
+* When `"variable"`, `update` receives the raw frame delta.
+*
+* @param update - Called each tick with the delta time in **ms**.
+* @param render - Called once per frame after all update ticks.
+* @param options - Loop configuration. See {@link LoopOptions}.
+* @returns A {@link LoopHandle} to stop, pause, or resume the loop.
+*
+* @throws {RangeError} If `tickRate` is not `"variable"` or a positive finite number.
+* @throws {RangeError} If `maxDelta` is not a positive finite number.
+*/
+function startLoop(update, render, options) {
+	const { tickRate, maxDelta, pauseOnHidden } = options;
+	if (typeof tickRate === "number" && (!Number.isFinite(tickRate) || tickRate <= 0)) throw new RangeError(`startLoop: tickRate must be "variable" or a positive finite number, got ${tickRate}`);
+	if (!Number.isFinite(maxDelta) || maxDelta <= 0) throw new RangeError(`startLoop: maxDelta must be a positive finite number, got ${maxDelta}`);
+	let reqId = null;
+	let accumulator = 0;
+	let lastTime = performance.now();
+	let paused = false;
+	let visibilityCleanup = null;
+	if (pauseOnHidden) {
+		const onVisibility = () => {
+			paused = document.hidden;
+		};
+		document.addEventListener("visibilitychange", onVisibility);
+		visibilityCleanup = () => document.removeEventListener("visibilitychange", onVisibility);
+	}
+	function frame(nowMs) {
+		if (paused) {
+			lastTime = nowMs;
+			reqId = requestAnimationFrame(frame);
+			return;
+		}
+		const elapsed = Math.min(nowMs - lastTime, maxDelta);
+		lastTime = nowMs;
+		if (tickRate === "variable") {
+			clearFrameKeyboard();
+			clearFramePointer();
+			update(elapsed);
+		} else {
+			accumulator += elapsed;
+			let ticked = false;
+			while (accumulator >= tickRate) {
+				if (!ticked) {
+					clearFrameKeyboard();
+					clearFramePointer();
+					ticked = true;
+				}
+				update(tickRate);
+				accumulator -= tickRate;
+			}
+		}
+		render();
+		reqId = requestAnimationFrame(frame);
+	}
+	reqId = requestAnimationFrame(frame);
+	return {
+		stop: () => {
+			if (reqId !== null) {
+				cancelAnimationFrame(reqId);
+				reqId = null;
+			}
+			visibilityCleanup?.();
+		},
+		pause: () => {
+			paused = true;
+		},
+		resume: () => {
+			paused = false;
+		}
+	};
+}
+//#endregion
+export { startLoop };
+
+//# sourceMappingURL=update.mjs.map