@al8b/sprites 0.1.0

package/README.md

@@ -0,0 +1,23 @@
+# @al8b/sprites
+
+Sprite asset helpers for L8B. This package wraps image frames into runtime-friendly sprite objects and includes convenience loaders for updating sprite data from asset payloads.
+
+## Public API
+
+- `Sprite`
+- `LoadSprite`
+- `UpdateSprite`
+- Type: `SpriteProperties`
+
+## Notes
+
+- Built on top of `@al8b/image`.
+- Used by runtime asset loading and by packages that render sprite-backed content.
+
+## Scripts
+
+```bash
+bun run build
+bun run test
+bun run clean
+```

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+export { LoadSprite, Sprite, SpriteProperties, UpdateSprite } from './sprite.mjs';
+import '@al8b/image';

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { LoadSprite, Sprite, SpriteProperties, UpdateSprite } from './sprite.js';
+import '@al8b/image';

package/dist/index.js

@@ -0,0 +1,172 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  LoadSprite: () => LoadSprite,
+  Sprite: () => Sprite,
+  UpdateSprite: () => UpdateSprite
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/sprite.ts
+var import_image = require("@al8b/image");
+var Sprite = class {
+  static {
+    __name(this, "Sprite");
+  }
+  name = "";
+  frames = [];
+  animation_start = 0;
+  fps = 5;
+  ready = 0;
+  width;
+  height;
+  constructor(width, height) {
+    this.width = width;
+    this.height = height;
+    this.frames = [];
+    this.animation_start = 0;
+    this.fps = 5;
+    if (this.width > 0 && this.height > 0) {
+      this.frames.push(new import_image.Image(this.width, this.height));
+      this.ready = 1;
+    }
+  }
+  /**
+  * Set animation frames per second
+  * Preserves current animation position when changing FPS
+  */
+  setFPS(fps) {
+    const dt = 1e3 / this.fps;
+    const frame = (Date.now() - this.animation_start) / dt % this.frames.length;
+    this.fps = fps;
+    const newDt = 1e3 / fps;
+    this.animation_start = Date.now() - frame * newDt;
+    return fps;
+  }
+  /**
+  * Set the current animation frame
+  */
+  setFrame(frame) {
+    this.animation_start = Date.now() - 1e3 / this.fps * frame;
+  }
+  /**
+  * Get the current animation frame index
+  */
+  getFrame() {
+    const dt = 1e3 / this.fps;
+    return Math.floor((Date.now() - this.animation_start) / dt) % this.frames.length;
+  }
+  /**
+  * Get the canvas of the current frame
+  */
+  getCurrentFrameCanvas() {
+    if (!this.ready || this.frames.length === 0) {
+      return null;
+    }
+    if (this.frames.length > 1) {
+      if (this.animation_start === 0) {
+        this.animation_start = Date.now();
+      }
+      const frame = this.getFrame();
+      if (frame >= 0 && frame < this.frames.length) {
+        return this.frames[frame].canvas;
+      }
+      return this.frames[0].canvas;
+    }
+    return this.frames[0].canvas;
+  }
+};
+function resolveFrameCount(imgWidth, imgHeight, requested) {
+  if (imgWidth > 0 && imgHeight % imgWidth === 0) {
+    const available = imgHeight / imgWidth;
+    return Math.min(requested, available);
+  }
+  return requested;
+}
+__name(resolveFrameCount, "resolveFrameCount");
+function LoadSprite(url, properties, loaded) {
+  const sprite = new Sprite(0, 0);
+  sprite.ready = 0;
+  const img = new window.Image();
+  if (location.protocol !== "file:") {
+    img.crossOrigin = "Anonymous";
+  }
+  img.src = url;
+  img.onload = () => {
+    sprite.ready = 1;
+    if (img.width > 0 && img.height > 0) {
+      if (properties?.fps) {
+        sprite.fps = properties.fps;
+      }
+      sprite.width = img.width;
+      const numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);
+      sprite.height = Math.round(img.height / numframes);
+      sprite.frames = [];
+      for (let i = 0; i < numframes; i++) {
+        const frame = new import_image.Image(sprite.width, sprite.height);
+        frame.initContext();
+        const ctx = frame.context;
+        ctx.setTransform(1, 0, 0, 1, 0, 0);
+        ctx.drawImage(img, 0, -i * sprite.height);
+        sprite.frames.push(frame);
+      }
+      sprite.ready = 1;
+    }
+    if (loaded) {
+      loaded();
+    }
+  };
+  img.onerror = () => {
+    sprite.ready = 1;
+  };
+  return sprite;
+}
+__name(LoadSprite, "LoadSprite");
+function UpdateSprite(sprite, img, properties) {
+  if (img.width > 0 && img.height > 0) {
+    if (properties?.fps) {
+      sprite.fps = properties.fps;
+    }
+    sprite.width = img.width;
+    const numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);
+    sprite.height = Math.round(img.height / numframes);
+    sprite.frames = [];
+    for (let i = 0; i < numframes; i++) {
+      const frame = new import_image.Image(sprite.width, sprite.height);
+      frame.initContext();
+      const ctx = frame.context;
+      ctx.setTransform(1, 0, 0, 1, 0, 0);
+      ctx.drawImage(img, 0, -i * sprite.height);
+      sprite.frames.push(frame);
+    }
+    sprite.ready = 1;
+  }
+}
+__name(UpdateSprite, "UpdateSprite");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LoadSprite,
+  Sprite,
+  UpdateSprite
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/sprite.ts"],"sourcesContent":["/**\n * @al8b/sprites - Sprite class for animated graphics\n *\n * Provides utilities for creating and manipulating sprites:\n * - Sprite class for animated sprite support\n * - Multi-frame animation support\n */\n\nexport { Sprite, LoadSprite, UpdateSprite } from \"./sprite\";\nexport type { SpriteProperties } from \"./sprite\";\n","/**\n * Sprite - Animated sprite class for game graphics\n *\n * Provides sprite animation support with multiple frames.\n */\n\nimport { Image } from \"@al8b/image\";\n\nexport interface SpriteProperties {\n\tframes?: number;\n\tfps?: number;\n}\n\nexport class Sprite {\n\tpublic name: string = \"\";\n\tpublic frames: Image[] = [];\n\tpublic animation_start: number = 0;\n\tpublic fps: number = 5;\n\tpublic ready: number = 0;\n\tpublic width: number;\n\tpublic height: number;\n\n\tconstructor(width: number, height: number) {\n\t\tthis.width = width;\n\t\tthis.height = height;\n\t\tthis.frames = [];\n\t\tthis.animation_start = 0;\n\t\tthis.fps = 5;\n\n\t\tif (this.width > 0 && this.height > 0) {\n\t\t\tthis.frames.push(new Image(this.width, this.height));\n\t\t\tthis.ready = 1;\n\t\t}\n\t}\n\n\t/**\n\t * Set animation frames per second\n\t * Preserves current animation position when changing FPS\n\t */\n\tsetFPS(fps: number): number {\n\t\tconst dt = 1000 / this.fps;\n\t\tconst frame = ((Date.now() - this.animation_start) / dt) % this.frames.length;\n\t\tthis.fps = fps;\n\t\tconst newDt = 1000 / fps;\n\t\tthis.animation_start = Date.now() - frame * newDt;\n\t\treturn fps;\n\t}\n\n\t/**\n\t * Set the current animation frame\n\t */\n\tsetFrame(frame: number): void {\n\t\tthis.animation_start = Date.now() - (1000 / this.fps) * frame;\n\t}\n\n\t/**\n\t * Get the current animation frame index\n\t */\n\tgetFrame(): number {\n\t\tconst dt = 1000 / this.fps;\n\t\treturn Math.floor((Date.now() - this.animation_start) / dt) % this.frames.length;\n\t}\n\n\t/**\n\t * Get the canvas of the current frame\n\t */\n\tgetCurrentFrameCanvas(): HTMLCanvasElement | null {\n\t\tif (!this.ready || this.frames.length === 0) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (this.frames.length > 1) {\n\t\t\tif (this.animation_start === 0) {\n\t\t\t\tthis.animation_start = Date.now();\n\t\t\t}\n\t\t\tconst frame = this.getFrame();\n\t\t\tif (frame >= 0 && frame < this.frames.length) {\n\t\t\t\treturn this.frames[frame].canvas;\n\t\t\t}\n\t\t\treturn this.frames[0].canvas;\n\t\t}\n\n\t\treturn this.frames[0].canvas;\n\t}\n}\n\n/**\n * Resolve the actual number of animation frames for a spritesheet image.\n *\n * Strategy: if the image height is an exact multiple of its width (square frames),\n * cap the requested frame count to the available rows. Otherwise trust the caller.\n *\n * @param imgWidth  - Natural width of the loaded image\n * @param imgHeight - Natural height of the loaded image\n * @param requested - Frame count requested via SpriteProperties (defaults to 1)\n */\nfunction resolveFrameCount(imgWidth: number, imgHeight: number, requested: number): number {\n\tif (imgWidth > 0 && imgHeight % imgWidth === 0) {\n\t\tconst available = imgHeight / imgWidth;\n\t\treturn Math.min(requested, available);\n\t}\n\treturn requested;\n}\n\n/**\n * Load a sprite from a URL\n * Supports multi-frame spritesheets (vertical stacking)\n */\nexport function LoadSprite(url: string, properties?: SpriteProperties, loaded?: () => void): Sprite {\n\tconst sprite = new Sprite(0, 0);\n\tsprite.ready = 0;\n\n\tconst img = new window.Image();\n\tif (location.protocol !== \"file:\") {\n\t\timg.crossOrigin = \"Anonymous\";\n\t}\n\timg.src = url;\n\n\timg.onload = () => {\n\t\tsprite.ready = 1;\n\n\t\tif (img.width > 0 && img.height > 0) {\n\t\t\tif (properties?.fps) {\n\t\t\t\tsprite.fps = properties.fps;\n\t\t\t}\n\n\t\t\tsprite.width = img.width;\n\t\t\tconst numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);\n\t\t\tsprite.height = Math.round(img.height / numframes);\n\t\t\tsprite.frames = [];\n\n\t\t\tfor (let i = 0; i < numframes; i++) {\n\t\t\t\tconst frame = new Image(sprite.width, sprite.height);\n\t\t\t\tframe.initContext();\n\t\t\t\tconst ctx = frame.context!;\n\t\t\t\tctx.setTransform(1, 0, 0, 1, 0, 0);\n\t\t\t\tctx.drawImage(img, 0, -i * sprite.height);\n\t\t\t\tsprite.frames.push(frame);\n\t\t\t}\n\t\t\tsprite.ready = 1;\n\t\t}\n\n\t\tif (loaded) {\n\t\t\tloaded();\n\t\t}\n\t};\n\n\timg.onerror = () => {\n\t\tsprite.ready = 1;\n\t};\n\n\treturn sprite;\n}\n\n/**\n * Update a sprite from an image element\n * Supports multi-frame spritesheets (vertical stacking)\n */\nexport function UpdateSprite(sprite: Sprite, img: HTMLImageElement, properties?: SpriteProperties): void {\n\tif (img.width > 0 && img.height > 0) {\n\t\tif (properties?.fps) {\n\t\t\tsprite.fps = properties.fps;\n\t\t}\n\t\tsprite.width = img.width;\n\t\tconst numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);\n\t\tsprite.height = Math.round(img.height / numframes);\n\t\tsprite.frames = [];\n\n\t\tfor (let i = 0; i < numframes; i++) {\n\t\t\tconst frame = new Image(sprite.width, sprite.height);\n\t\t\tframe.initContext();\n\t\t\tconst ctx = frame.context!;\n\t\t\tctx.setTransform(1, 0, 0, 1, 0, 0);\n\t\t\tctx.drawImage(img, 0, -i * sprite.height);\n\t\t\tsprite.frames.push(frame);\n\t\t}\n\t\tsprite.ready = 1;\n\t}\n}\n"],"mappings":"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","names":["Sprite","name","frames","animation_start","fps","ready","width","height","push","Image","setFPS","dt","frame","Date","now","length","newDt","setFrame","getFrame","Math","floor","getCurrentFrameCanvas","canvas","resolveFrameCount","imgWidth","imgHeight","requested","available","min","LoadSprite","url","properties","loaded","sprite","img","window","location","protocol","crossOrigin","src","onload","numframes","round","i","initContext","ctx","context","setTransform","drawImage","onerror","UpdateSprite"]}

package/dist/index.mjs

@@ -0,0 +1,145 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/sprite.ts
+import { Image } from "@al8b/image";
+var Sprite = class {
+  static {
+    __name(this, "Sprite");
+  }
+  name = "";
+  frames = [];
+  animation_start = 0;
+  fps = 5;
+  ready = 0;
+  width;
+  height;
+  constructor(width, height) {
+    this.width = width;
+    this.height = height;
+    this.frames = [];
+    this.animation_start = 0;
+    this.fps = 5;
+    if (this.width > 0 && this.height > 0) {
+      this.frames.push(new Image(this.width, this.height));
+      this.ready = 1;
+    }
+  }
+  /**
+  * Set animation frames per second
+  * Preserves current animation position when changing FPS
+  */
+  setFPS(fps) {
+    const dt = 1e3 / this.fps;
+    const frame = (Date.now() - this.animation_start) / dt % this.frames.length;
+    this.fps = fps;
+    const newDt = 1e3 / fps;
+    this.animation_start = Date.now() - frame * newDt;
+    return fps;
+  }
+  /**
+  * Set the current animation frame
+  */
+  setFrame(frame) {
+    this.animation_start = Date.now() - 1e3 / this.fps * frame;
+  }
+  /**
+  * Get the current animation frame index
+  */
+  getFrame() {
+    const dt = 1e3 / this.fps;
+    return Math.floor((Date.now() - this.animation_start) / dt) % this.frames.length;
+  }
+  /**
+  * Get the canvas of the current frame
+  */
+  getCurrentFrameCanvas() {
+    if (!this.ready || this.frames.length === 0) {
+      return null;
+    }
+    if (this.frames.length > 1) {
+      if (this.animation_start === 0) {
+        this.animation_start = Date.now();
+      }
+      const frame = this.getFrame();
+      if (frame >= 0 && frame < this.frames.length) {
+        return this.frames[frame].canvas;
+      }
+      return this.frames[0].canvas;
+    }
+    return this.frames[0].canvas;
+  }
+};
+function resolveFrameCount(imgWidth, imgHeight, requested) {
+  if (imgWidth > 0 && imgHeight % imgWidth === 0) {
+    const available = imgHeight / imgWidth;
+    return Math.min(requested, available);
+  }
+  return requested;
+}
+__name(resolveFrameCount, "resolveFrameCount");
+function LoadSprite(url, properties, loaded) {
+  const sprite = new Sprite(0, 0);
+  sprite.ready = 0;
+  const img = new window.Image();
+  if (location.protocol !== "file:") {
+    img.crossOrigin = "Anonymous";
+  }
+  img.src = url;
+  img.onload = () => {
+    sprite.ready = 1;
+    if (img.width > 0 && img.height > 0) {
+      if (properties?.fps) {
+        sprite.fps = properties.fps;
+      }
+      sprite.width = img.width;
+      const numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);
+      sprite.height = Math.round(img.height / numframes);
+      sprite.frames = [];
+      for (let i = 0; i < numframes; i++) {
+        const frame = new Image(sprite.width, sprite.height);
+        frame.initContext();
+        const ctx = frame.context;
+        ctx.setTransform(1, 0, 0, 1, 0, 0);
+        ctx.drawImage(img, 0, -i * sprite.height);
+        sprite.frames.push(frame);
+      }
+      sprite.ready = 1;
+    }
+    if (loaded) {
+      loaded();
+    }
+  };
+  img.onerror = () => {
+    sprite.ready = 1;
+  };
+  return sprite;
+}
+__name(LoadSprite, "LoadSprite");
+function UpdateSprite(sprite, img, properties) {
+  if (img.width > 0 && img.height > 0) {
+    if (properties?.fps) {
+      sprite.fps = properties.fps;
+    }
+    sprite.width = img.width;
+    const numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);
+    sprite.height = Math.round(img.height / numframes);
+    sprite.frames = [];
+    for (let i = 0; i < numframes; i++) {
+      const frame = new Image(sprite.width, sprite.height);
+      frame.initContext();
+      const ctx = frame.context;
+      ctx.setTransform(1, 0, 0, 1, 0, 0);
+      ctx.drawImage(img, 0, -i * sprite.height);
+      sprite.frames.push(frame);
+    }
+    sprite.ready = 1;
+  }
+}
+__name(UpdateSprite, "UpdateSprite");
+export {
+  LoadSprite,
+  Sprite,
+  UpdateSprite
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sprite.ts"],"sourcesContent":["/**\n * Sprite - Animated sprite class for game graphics\n *\n * Provides sprite animation support with multiple frames.\n */\n\nimport { Image } from \"@al8b/image\";\n\nexport interface SpriteProperties {\n\tframes?: number;\n\tfps?: number;\n}\n\nexport class Sprite {\n\tpublic name: string = \"\";\n\tpublic frames: Image[] = [];\n\tpublic animation_start: number = 0;\n\tpublic fps: number = 5;\n\tpublic ready: number = 0;\n\tpublic width: number;\n\tpublic height: number;\n\n\tconstructor(width: number, height: number) {\n\t\tthis.width = width;\n\t\tthis.height = height;\n\t\tthis.frames = [];\n\t\tthis.animation_start = 0;\n\t\tthis.fps = 5;\n\n\t\tif (this.width > 0 && this.height > 0) {\n\t\t\tthis.frames.push(new Image(this.width, this.height));\n\t\t\tthis.ready = 1;\n\t\t}\n\t}\n\n\t/**\n\t * Set animation frames per second\n\t * Preserves current animation position when changing FPS\n\t */\n\tsetFPS(fps: number): number {\n\t\tconst dt = 1000 / this.fps;\n\t\tconst frame = ((Date.now() - this.animation_start) / dt) % this.frames.length;\n\t\tthis.fps = fps;\n\t\tconst newDt = 1000 / fps;\n\t\tthis.animation_start = Date.now() - frame * newDt;\n\t\treturn fps;\n\t}\n\n\t/**\n\t * Set the current animation frame\n\t */\n\tsetFrame(frame: number): void {\n\t\tthis.animation_start = Date.now() - (1000 / this.fps) * frame;\n\t}\n\n\t/**\n\t * Get the current animation frame index\n\t */\n\tgetFrame(): number {\n\t\tconst dt = 1000 / this.fps;\n\t\treturn Math.floor((Date.now() - this.animation_start) / dt) % this.frames.length;\n\t}\n\n\t/**\n\t * Get the canvas of the current frame\n\t */\n\tgetCurrentFrameCanvas(): HTMLCanvasElement | null {\n\t\tif (!this.ready || this.frames.length === 0) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (this.frames.length > 1) {\n\t\t\tif (this.animation_start === 0) {\n\t\t\t\tthis.animation_start = Date.now();\n\t\t\t}\n\t\t\tconst frame = this.getFrame();\n\t\t\tif (frame >= 0 && frame < this.frames.length) {\n\t\t\t\treturn this.frames[frame].canvas;\n\t\t\t}\n\t\t\treturn this.frames[0].canvas;\n\t\t}\n\n\t\treturn this.frames[0].canvas;\n\t}\n}\n\n/**\n * Resolve the actual number of animation frames for a spritesheet image.\n *\n * Strategy: if the image height is an exact multiple of its width (square frames),\n * cap the requested frame count to the available rows. Otherwise trust the caller.\n *\n * @param imgWidth  - Natural width of the loaded image\n * @param imgHeight - Natural height of the loaded image\n * @param requested - Frame count requested via SpriteProperties (defaults to 1)\n */\nfunction resolveFrameCount(imgWidth: number, imgHeight: number, requested: number): number {\n\tif (imgWidth > 0 && imgHeight % imgWidth === 0) {\n\t\tconst available = imgHeight / imgWidth;\n\t\treturn Math.min(requested, available);\n\t}\n\treturn requested;\n}\n\n/**\n * Load a sprite from a URL\n * Supports multi-frame spritesheets (vertical stacking)\n */\nexport function LoadSprite(url: string, properties?: SpriteProperties, loaded?: () => void): Sprite {\n\tconst sprite = new Sprite(0, 0);\n\tsprite.ready = 0;\n\n\tconst img = new window.Image();\n\tif (location.protocol !== \"file:\") {\n\t\timg.crossOrigin = \"Anonymous\";\n\t}\n\timg.src = url;\n\n\timg.onload = () => {\n\t\tsprite.ready = 1;\n\n\t\tif (img.width > 0 && img.height > 0) {\n\t\t\tif (properties?.fps) {\n\t\t\t\tsprite.fps = properties.fps;\n\t\t\t}\n\n\t\t\tsprite.width = img.width;\n\t\t\tconst numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);\n\t\t\tsprite.height = Math.round(img.height / numframes);\n\t\t\tsprite.frames = [];\n\n\t\t\tfor (let i = 0; i < numframes; i++) {\n\t\t\t\tconst frame = new Image(sprite.width, sprite.height);\n\t\t\t\tframe.initContext();\n\t\t\t\tconst ctx = frame.context!;\n\t\t\t\tctx.setTransform(1, 0, 0, 1, 0, 0);\n\t\t\t\tctx.drawImage(img, 0, -i * sprite.height);\n\t\t\t\tsprite.frames.push(frame);\n\t\t\t}\n\t\t\tsprite.ready = 1;\n\t\t}\n\n\t\tif (loaded) {\n\t\t\tloaded();\n\t\t}\n\t};\n\n\timg.onerror = () => {\n\t\tsprite.ready = 1;\n\t};\n\n\treturn sprite;\n}\n\n/**\n * Update a sprite from an image element\n * Supports multi-frame spritesheets (vertical stacking)\n */\nexport function UpdateSprite(sprite: Sprite, img: HTMLImageElement, properties?: SpriteProperties): void {\n\tif (img.width > 0 && img.height > 0) {\n\t\tif (properties?.fps) {\n\t\t\tsprite.fps = properties.fps;\n\t\t}\n\t\tsprite.width = img.width;\n\t\tconst numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);\n\t\tsprite.height = Math.round(img.height / numframes);\n\t\tsprite.frames = [];\n\n\t\tfor (let i = 0; i < numframes; i++) {\n\t\t\tconst frame = new Image(sprite.width, sprite.height);\n\t\t\tframe.initContext();\n\t\t\tconst ctx = frame.context!;\n\t\t\tctx.setTransform(1, 0, 0, 1, 0, 0);\n\t\t\tctx.drawImage(img, 0, -i * sprite.height);\n\t\t\tsprite.frames.push(frame);\n\t\t}\n\t\tsprite.ready = 1;\n\t}\n}\n"],"mappings":"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","names":["Image","Sprite","name","frames","animation_start","fps","ready","width","height","push","Image","setFPS","dt","frame","Date","now","length","newDt","setFrame","getFrame","Math","floor","getCurrentFrameCanvas","canvas","resolveFrameCount","imgWidth","imgHeight","requested","available","min","LoadSprite","url","properties","loaded","sprite","img","window","location","protocol","crossOrigin","src","onload","numframes","round","i","initContext","ctx","context","setTransform","drawImage","onerror","UpdateSprite"]}

package/dist/sprite.d.mts

@@ -0,0 +1,51 @@
+import { Image } from '@al8b/image';
+
+/**
+ * Sprite - Animated sprite class for game graphics
+ *
+ * Provides sprite animation support with multiple frames.
+ */
+
+interface SpriteProperties {
+    frames?: number;
+    fps?: number;
+}
+declare class Sprite {
+    name: string;
+    frames: Image[];
+    animation_start: number;
+    fps: number;
+    ready: number;
+    width: number;
+    height: number;
+    constructor(width: number, height: number);
+    /**
+     * Set animation frames per second
+     * Preserves current animation position when changing FPS
+     */
+    setFPS(fps: number): number;
+    /**
+     * Set the current animation frame
+     */
+    setFrame(frame: number): void;
+    /**
+     * Get the current animation frame index
+     */
+    getFrame(): number;
+    /**
+     * Get the canvas of the current frame
+     */
+    getCurrentFrameCanvas(): HTMLCanvasElement | null;
+}
+/**
+ * Load a sprite from a URL
+ * Supports multi-frame spritesheets (vertical stacking)
+ */
+declare function LoadSprite(url: string, properties?: SpriteProperties, loaded?: () => void): Sprite;
+/**
+ * Update a sprite from an image element
+ * Supports multi-frame spritesheets (vertical stacking)
+ */
+declare function UpdateSprite(sprite: Sprite, img: HTMLImageElement, properties?: SpriteProperties): void;
+
+export { LoadSprite, Sprite, type SpriteProperties, UpdateSprite };

package/dist/sprite.d.ts

@@ -0,0 +1,51 @@
+import { Image } from '@al8b/image';
+
+/**
+ * Sprite - Animated sprite class for game graphics
+ *
+ * Provides sprite animation support with multiple frames.
+ */
+
+interface SpriteProperties {
+    frames?: number;
+    fps?: number;
+}
+declare class Sprite {
+    name: string;
+    frames: Image[];
+    animation_start: number;
+    fps: number;
+    ready: number;
+    width: number;
+    height: number;
+    constructor(width: number, height: number);
+    /**
+     * Set animation frames per second
+     * Preserves current animation position when changing FPS
+     */
+    setFPS(fps: number): number;
+    /**
+     * Set the current animation frame
+     */
+    setFrame(frame: number): void;
+    /**
+     * Get the current animation frame index
+     */
+    getFrame(): number;
+    /**
+     * Get the canvas of the current frame
+     */
+    getCurrentFrameCanvas(): HTMLCanvasElement | null;
+}
+/**
+ * Load a sprite from a URL
+ * Supports multi-frame spritesheets (vertical stacking)
+ */
+declare function LoadSprite(url: string, properties?: SpriteProperties, loaded?: () => void): Sprite;
+/**
+ * Update a sprite from an image element
+ * Supports multi-frame spritesheets (vertical stacking)
+ */
+declare function UpdateSprite(sprite: Sprite, img: HTMLImageElement, properties?: SpriteProperties): void;
+
+export { LoadSprite, Sprite, type SpriteProperties, UpdateSprite };

package/dist/sprite.js

@@ -0,0 +1,170 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/sprite.ts
+var sprite_exports = {};
+__export(sprite_exports, {
+  LoadSprite: () => LoadSprite,
+  Sprite: () => Sprite,
+  UpdateSprite: () => UpdateSprite
+});
+module.exports = __toCommonJS(sprite_exports);
+var import_image = require("@al8b/image");
+var Sprite = class {
+  static {
+    __name(this, "Sprite");
+  }
+  name = "";
+  frames = [];
+  animation_start = 0;
+  fps = 5;
+  ready = 0;
+  width;
+  height;
+  constructor(width, height) {
+    this.width = width;
+    this.height = height;
+    this.frames = [];
+    this.animation_start = 0;
+    this.fps = 5;
+    if (this.width > 0 && this.height > 0) {
+      this.frames.push(new import_image.Image(this.width, this.height));
+      this.ready = 1;
+    }
+  }
+  /**
+  * Set animation frames per second
+  * Preserves current animation position when changing FPS
+  */
+  setFPS(fps) {
+    const dt = 1e3 / this.fps;
+    const frame = (Date.now() - this.animation_start) / dt % this.frames.length;
+    this.fps = fps;
+    const newDt = 1e3 / fps;
+    this.animation_start = Date.now() - frame * newDt;
+    return fps;
+  }
+  /**
+  * Set the current animation frame
+  */
+  setFrame(frame) {
+    this.animation_start = Date.now() - 1e3 / this.fps * frame;
+  }
+  /**
+  * Get the current animation frame index
+  */
+  getFrame() {
+    const dt = 1e3 / this.fps;
+    return Math.floor((Date.now() - this.animation_start) / dt) % this.frames.length;
+  }
+  /**
+  * Get the canvas of the current frame
+  */
+  getCurrentFrameCanvas() {
+    if (!this.ready || this.frames.length === 0) {
+      return null;
+    }
+    if (this.frames.length > 1) {
+      if (this.animation_start === 0) {
+        this.animation_start = Date.now();
+      }
+      const frame = this.getFrame();
+      if (frame >= 0 && frame < this.frames.length) {
+        return this.frames[frame].canvas;
+      }
+      return this.frames[0].canvas;
+    }
+    return this.frames[0].canvas;
+  }
+};
+function resolveFrameCount(imgWidth, imgHeight, requested) {
+  if (imgWidth > 0 && imgHeight % imgWidth === 0) {
+    const available = imgHeight / imgWidth;
+    return Math.min(requested, available);
+  }
+  return requested;
+}
+__name(resolveFrameCount, "resolveFrameCount");
+function LoadSprite(url, properties, loaded) {
+  const sprite = new Sprite(0, 0);
+  sprite.ready = 0;
+  const img = new window.Image();
+  if (location.protocol !== "file:") {
+    img.crossOrigin = "Anonymous";
+  }
+  img.src = url;
+  img.onload = () => {
+    sprite.ready = 1;
+    if (img.width > 0 && img.height > 0) {
+      if (properties?.fps) {
+        sprite.fps = properties.fps;
+      }
+      sprite.width = img.width;
+      const numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);
+      sprite.height = Math.round(img.height / numframes);
+      sprite.frames = [];
+      for (let i = 0; i < numframes; i++) {
+        const frame = new import_image.Image(sprite.width, sprite.height);
+        frame.initContext();
+        const ctx = frame.context;
+        ctx.setTransform(1, 0, 0, 1, 0, 0);
+        ctx.drawImage(img, 0, -i * sprite.height);
+        sprite.frames.push(frame);
+      }
+      sprite.ready = 1;
+    }
+    if (loaded) {
+      loaded();
+    }
+  };
+  img.onerror = () => {
+    sprite.ready = 1;
+  };
+  return sprite;
+}
+__name(LoadSprite, "LoadSprite");
+function UpdateSprite(sprite, img, properties) {
+  if (img.width > 0 && img.height > 0) {
+    if (properties?.fps) {
+      sprite.fps = properties.fps;
+    }
+    sprite.width = img.width;
+    const numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);
+    sprite.height = Math.round(img.height / numframes);
+    sprite.frames = [];
+    for (let i = 0; i < numframes; i++) {
+      const frame = new import_image.Image(sprite.width, sprite.height);
+      frame.initContext();
+      const ctx = frame.context;
+      ctx.setTransform(1, 0, 0, 1, 0, 0);
+      ctx.drawImage(img, 0, -i * sprite.height);
+      sprite.frames.push(frame);
+    }
+    sprite.ready = 1;
+  }
+}
+__name(UpdateSprite, "UpdateSprite");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LoadSprite,
+  Sprite,
+  UpdateSprite
+});
+//# sourceMappingURL=sprite.js.map

package/dist/sprite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sprite.ts"],"sourcesContent":["/**\n * Sprite - Animated sprite class for game graphics\n *\n * Provides sprite animation support with multiple frames.\n */\n\nimport { Image } from \"@al8b/image\";\n\nexport interface SpriteProperties {\n\tframes?: number;\n\tfps?: number;\n}\n\nexport class Sprite {\n\tpublic name: string = \"\";\n\tpublic frames: Image[] = [];\n\tpublic animation_start: number = 0;\n\tpublic fps: number = 5;\n\tpublic ready: number = 0;\n\tpublic width: number;\n\tpublic height: number;\n\n\tconstructor(width: number, height: number) {\n\t\tthis.width = width;\n\t\tthis.height = height;\n\t\tthis.frames = [];\n\t\tthis.animation_start = 0;\n\t\tthis.fps = 5;\n\n\t\tif (this.width > 0 && this.height > 0) {\n\t\t\tthis.frames.push(new Image(this.width, this.height));\n\t\t\tthis.ready = 1;\n\t\t}\n\t}\n\n\t/**\n\t * Set animation frames per second\n\t * Preserves current animation position when changing FPS\n\t */\n\tsetFPS(fps: number): number {\n\t\tconst dt = 1000 / this.fps;\n\t\tconst frame = ((Date.now() - this.animation_start) / dt) % this.frames.length;\n\t\tthis.fps = fps;\n\t\tconst newDt = 1000 / fps;\n\t\tthis.animation_start = Date.now() - frame * newDt;\n\t\treturn fps;\n\t}\n\n\t/**\n\t * Set the current animation frame\n\t */\n\tsetFrame(frame: number): void {\n\t\tthis.animation_start = Date.now() - (1000 / this.fps) * frame;\n\t}\n\n\t/**\n\t * Get the current animation frame index\n\t */\n\tgetFrame(): number {\n\t\tconst dt = 1000 / this.fps;\n\t\treturn Math.floor((Date.now() - this.animation_start) / dt) % this.frames.length;\n\t}\n\n\t/**\n\t * Get the canvas of the current frame\n\t */\n\tgetCurrentFrameCanvas(): HTMLCanvasElement | null {\n\t\tif (!this.ready || this.frames.length === 0) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (this.frames.length > 1) {\n\t\t\tif (this.animation_start === 0) {\n\t\t\t\tthis.animation_start = Date.now();\n\t\t\t}\n\t\t\tconst frame = this.getFrame();\n\t\t\tif (frame >= 0 && frame < this.frames.length) {\n\t\t\t\treturn this.frames[frame].canvas;\n\t\t\t}\n\t\t\treturn this.frames[0].canvas;\n\t\t}\n\n\t\treturn this.frames[0].canvas;\n\t}\n}\n\n/**\n * Resolve the actual number of animation frames for a spritesheet image.\n *\n * Strategy: if the image height is an exact multiple of its width (square frames),\n * cap the requested frame count to the available rows. Otherwise trust the caller.\n *\n * @param imgWidth  - Natural width of the loaded image\n * @param imgHeight - Natural height of the loaded image\n * @param requested - Frame count requested via SpriteProperties (defaults to 1)\n */\nfunction resolveFrameCount(imgWidth: number, imgHeight: number, requested: number): number {\n\tif (imgWidth > 0 && imgHeight % imgWidth === 0) {\n\t\tconst available = imgHeight / imgWidth;\n\t\treturn Math.min(requested, available);\n\t}\n\treturn requested;\n}\n\n/**\n * Load a sprite from a URL\n * Supports multi-frame spritesheets (vertical stacking)\n */\nexport function LoadSprite(url: string, properties?: SpriteProperties, loaded?: () => void): Sprite {\n\tconst sprite = new Sprite(0, 0);\n\tsprite.ready = 0;\n\n\tconst img = new window.Image();\n\tif (location.protocol !== \"file:\") {\n\t\timg.crossOrigin = \"Anonymous\";\n\t}\n\timg.src = url;\n\n\timg.onload = () => {\n\t\tsprite.ready = 1;\n\n\t\tif (img.width > 0 && img.height > 0) {\n\t\t\tif (properties?.fps) {\n\t\t\t\tsprite.fps = properties.fps;\n\t\t\t}\n\n\t\t\tsprite.width = img.width;\n\t\t\tconst numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);\n\t\t\tsprite.height = Math.round(img.height / numframes);\n\t\t\tsprite.frames = [];\n\n\t\t\tfor (let i = 0; i < numframes; i++) {\n\t\t\t\tconst frame = new Image(sprite.width, sprite.height);\n\t\t\t\tframe.initContext();\n\t\t\t\tconst ctx = frame.context!;\n\t\t\t\tctx.setTransform(1, 0, 0, 1, 0, 0);\n\t\t\t\tctx.drawImage(img, 0, -i * sprite.height);\n\t\t\t\tsprite.frames.push(frame);\n\t\t\t}\n\t\t\tsprite.ready = 1;\n\t\t}\n\n\t\tif (loaded) {\n\t\t\tloaded();\n\t\t}\n\t};\n\n\timg.onerror = () => {\n\t\tsprite.ready = 1;\n\t};\n\n\treturn sprite;\n}\n\n/**\n * Update a sprite from an image element\n * Supports multi-frame spritesheets (vertical stacking)\n */\nexport function UpdateSprite(sprite: Sprite, img: HTMLImageElement, properties?: SpriteProperties): void {\n\tif (img.width > 0 && img.height > 0) {\n\t\tif (properties?.fps) {\n\t\t\tsprite.fps = properties.fps;\n\t\t}\n\t\tsprite.width = img.width;\n\t\tconst numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);\n\t\tsprite.height = Math.round(img.height / numframes);\n\t\tsprite.frames = [];\n\n\t\tfor (let i = 0; i < numframes; i++) {\n\t\t\tconst frame = new Image(sprite.width, sprite.height);\n\t\t\tframe.initContext();\n\t\t\tconst ctx = frame.context!;\n\t\t\tctx.setTransform(1, 0, 0, 1, 0, 0);\n\t\t\tctx.drawImage(img, 0, -i * sprite.height);\n\t\t\tsprite.frames.push(frame);\n\t\t}\n\t\tsprite.ready = 1;\n\t}\n}\n"],"mappings":"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","names":["Sprite","name","frames","animation_start","fps","ready","width","height","push","Image","setFPS","dt","frame","Date","now","length","newDt","setFrame","getFrame","Math","floor","getCurrentFrameCanvas","canvas","resolveFrameCount","imgWidth","imgHeight","requested","available","min","LoadSprite","url","properties","loaded","sprite","img","window","location","protocol","crossOrigin","src","onload","numframes","round","i","initContext","ctx","context","setTransform","drawImage","onerror","UpdateSprite"]}

package/dist/sprite.mjs

@@ -0,0 +1,145 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/sprite.ts
+import { Image } from "@al8b/image";
+var Sprite = class {
+  static {
+    __name(this, "Sprite");
+  }
+  name = "";
+  frames = [];
+  animation_start = 0;
+  fps = 5;
+  ready = 0;
+  width;
+  height;
+  constructor(width, height) {
+    this.width = width;
+    this.height = height;
+    this.frames = [];
+    this.animation_start = 0;
+    this.fps = 5;
+    if (this.width > 0 && this.height > 0) {
+      this.frames.push(new Image(this.width, this.height));
+      this.ready = 1;
+    }
+  }
+  /**
+  * Set animation frames per second
+  * Preserves current animation position when changing FPS
+  */
+  setFPS(fps) {
+    const dt = 1e3 / this.fps;
+    const frame = (Date.now() - this.animation_start) / dt % this.frames.length;
+    this.fps = fps;
+    const newDt = 1e3 / fps;
+    this.animation_start = Date.now() - frame * newDt;
+    return fps;
+  }
+  /**
+  * Set the current animation frame
+  */
+  setFrame(frame) {
+    this.animation_start = Date.now() - 1e3 / this.fps * frame;
+  }
+  /**
+  * Get the current animation frame index
+  */
+  getFrame() {
+    const dt = 1e3 / this.fps;
+    return Math.floor((Date.now() - this.animation_start) / dt) % this.frames.length;
+  }
+  /**
+  * Get the canvas of the current frame
+  */
+  getCurrentFrameCanvas() {
+    if (!this.ready || this.frames.length === 0) {
+      return null;
+    }
+    if (this.frames.length > 1) {
+      if (this.animation_start === 0) {
+        this.animation_start = Date.now();
+      }
+      const frame = this.getFrame();
+      if (frame >= 0 && frame < this.frames.length) {
+        return this.frames[frame].canvas;
+      }
+      return this.frames[0].canvas;
+    }
+    return this.frames[0].canvas;
+  }
+};
+function resolveFrameCount(imgWidth, imgHeight, requested) {
+  if (imgWidth > 0 && imgHeight % imgWidth === 0) {
+    const available = imgHeight / imgWidth;
+    return Math.min(requested, available);
+  }
+  return requested;
+}
+__name(resolveFrameCount, "resolveFrameCount");
+function LoadSprite(url, properties, loaded) {
+  const sprite = new Sprite(0, 0);
+  sprite.ready = 0;
+  const img = new window.Image();
+  if (location.protocol !== "file:") {
+    img.crossOrigin = "Anonymous";
+  }
+  img.src = url;
+  img.onload = () => {
+    sprite.ready = 1;
+    if (img.width > 0 && img.height > 0) {
+      if (properties?.fps) {
+        sprite.fps = properties.fps;
+      }
+      sprite.width = img.width;
+      const numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);
+      sprite.height = Math.round(img.height / numframes);
+      sprite.frames = [];
+      for (let i = 0; i < numframes; i++) {
+        const frame = new Image(sprite.width, sprite.height);
+        frame.initContext();
+        const ctx = frame.context;
+        ctx.setTransform(1, 0, 0, 1, 0, 0);
+        ctx.drawImage(img, 0, -i * sprite.height);
+        sprite.frames.push(frame);
+      }
+      sprite.ready = 1;
+    }
+    if (loaded) {
+      loaded();
+    }
+  };
+  img.onerror = () => {
+    sprite.ready = 1;
+  };
+  return sprite;
+}
+__name(LoadSprite, "LoadSprite");
+function UpdateSprite(sprite, img, properties) {
+  if (img.width > 0 && img.height > 0) {
+    if (properties?.fps) {
+      sprite.fps = properties.fps;
+    }
+    sprite.width = img.width;
+    const numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);
+    sprite.height = Math.round(img.height / numframes);
+    sprite.frames = [];
+    for (let i = 0; i < numframes; i++) {
+      const frame = new Image(sprite.width, sprite.height);
+      frame.initContext();
+      const ctx = frame.context;
+      ctx.setTransform(1, 0, 0, 1, 0, 0);
+      ctx.drawImage(img, 0, -i * sprite.height);
+      sprite.frames.push(frame);
+    }
+    sprite.ready = 1;
+  }
+}
+__name(UpdateSprite, "UpdateSprite");
+export {
+  LoadSprite,
+  Sprite,
+  UpdateSprite
+};
+//# sourceMappingURL=sprite.mjs.map

package/dist/sprite.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sprite.ts"],"sourcesContent":["/**\n * Sprite - Animated sprite class for game graphics\n *\n * Provides sprite animation support with multiple frames.\n */\n\nimport { Image } from \"@al8b/image\";\n\nexport interface SpriteProperties {\n\tframes?: number;\n\tfps?: number;\n}\n\nexport class Sprite {\n\tpublic name: string = \"\";\n\tpublic frames: Image[] = [];\n\tpublic animation_start: number = 0;\n\tpublic fps: number = 5;\n\tpublic ready: number = 0;\n\tpublic width: number;\n\tpublic height: number;\n\n\tconstructor(width: number, height: number) {\n\t\tthis.width = width;\n\t\tthis.height = height;\n\t\tthis.frames = [];\n\t\tthis.animation_start = 0;\n\t\tthis.fps = 5;\n\n\t\tif (this.width > 0 && this.height > 0) {\n\t\t\tthis.frames.push(new Image(this.width, this.height));\n\t\t\tthis.ready = 1;\n\t\t}\n\t}\n\n\t/**\n\t * Set animation frames per second\n\t * Preserves current animation position when changing FPS\n\t */\n\tsetFPS(fps: number): number {\n\t\tconst dt = 1000 / this.fps;\n\t\tconst frame = ((Date.now() - this.animation_start) / dt) % this.frames.length;\n\t\tthis.fps = fps;\n\t\tconst newDt = 1000 / fps;\n\t\tthis.animation_start = Date.now() - frame * newDt;\n\t\treturn fps;\n\t}\n\n\t/**\n\t * Set the current animation frame\n\t */\n\tsetFrame(frame: number): void {\n\t\tthis.animation_start = Date.now() - (1000 / this.fps) * frame;\n\t}\n\n\t/**\n\t * Get the current animation frame index\n\t */\n\tgetFrame(): number {\n\t\tconst dt = 1000 / this.fps;\n\t\treturn Math.floor((Date.now() - this.animation_start) / dt) % this.frames.length;\n\t}\n\n\t/**\n\t * Get the canvas of the current frame\n\t */\n\tgetCurrentFrameCanvas(): HTMLCanvasElement | null {\n\t\tif (!this.ready || this.frames.length === 0) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (this.frames.length > 1) {\n\t\t\tif (this.animation_start === 0) {\n\t\t\t\tthis.animation_start = Date.now();\n\t\t\t}\n\t\t\tconst frame = this.getFrame();\n\t\t\tif (frame >= 0 && frame < this.frames.length) {\n\t\t\t\treturn this.frames[frame].canvas;\n\t\t\t}\n\t\t\treturn this.frames[0].canvas;\n\t\t}\n\n\t\treturn this.frames[0].canvas;\n\t}\n}\n\n/**\n * Resolve the actual number of animation frames for a spritesheet image.\n *\n * Strategy: if the image height is an exact multiple of its width (square frames),\n * cap the requested frame count to the available rows. Otherwise trust the caller.\n *\n * @param imgWidth  - Natural width of the loaded image\n * @param imgHeight - Natural height of the loaded image\n * @param requested - Frame count requested via SpriteProperties (defaults to 1)\n */\nfunction resolveFrameCount(imgWidth: number, imgHeight: number, requested: number): number {\n\tif (imgWidth > 0 && imgHeight % imgWidth === 0) {\n\t\tconst available = imgHeight / imgWidth;\n\t\treturn Math.min(requested, available);\n\t}\n\treturn requested;\n}\n\n/**\n * Load a sprite from a URL\n * Supports multi-frame spritesheets (vertical stacking)\n */\nexport function LoadSprite(url: string, properties?: SpriteProperties, loaded?: () => void): Sprite {\n\tconst sprite = new Sprite(0, 0);\n\tsprite.ready = 0;\n\n\tconst img = new window.Image();\n\tif (location.protocol !== \"file:\") {\n\t\timg.crossOrigin = \"Anonymous\";\n\t}\n\timg.src = url;\n\n\timg.onload = () => {\n\t\tsprite.ready = 1;\n\n\t\tif (img.width > 0 && img.height > 0) {\n\t\t\tif (properties?.fps) {\n\t\t\t\tsprite.fps = properties.fps;\n\t\t\t}\n\n\t\t\tsprite.width = img.width;\n\t\t\tconst numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);\n\t\t\tsprite.height = Math.round(img.height / numframes);\n\t\t\tsprite.frames = [];\n\n\t\t\tfor (let i = 0; i < numframes; i++) {\n\t\t\t\tconst frame = new Image(sprite.width, sprite.height);\n\t\t\t\tframe.initContext();\n\t\t\t\tconst ctx = frame.context!;\n\t\t\t\tctx.setTransform(1, 0, 0, 1, 0, 0);\n\t\t\t\tctx.drawImage(img, 0, -i * sprite.height);\n\t\t\t\tsprite.frames.push(frame);\n\t\t\t}\n\t\t\tsprite.ready = 1;\n\t\t}\n\n\t\tif (loaded) {\n\t\t\tloaded();\n\t\t}\n\t};\n\n\timg.onerror = () => {\n\t\tsprite.ready = 1;\n\t};\n\n\treturn sprite;\n}\n\n/**\n * Update a sprite from an image element\n * Supports multi-frame spritesheets (vertical stacking)\n */\nexport function UpdateSprite(sprite: Sprite, img: HTMLImageElement, properties?: SpriteProperties): void {\n\tif (img.width > 0 && img.height > 0) {\n\t\tif (properties?.fps) {\n\t\t\tsprite.fps = properties.fps;\n\t\t}\n\t\tsprite.width = img.width;\n\t\tconst numframes = resolveFrameCount(img.width, img.height, properties?.frames ?? 1);\n\t\tsprite.height = Math.round(img.height / numframes);\n\t\tsprite.frames = [];\n\n\t\tfor (let i = 0; i < numframes; i++) {\n\t\t\tconst frame = new Image(sprite.width, sprite.height);\n\t\t\tframe.initContext();\n\t\t\tconst ctx = frame.context!;\n\t\t\tctx.setTransform(1, 0, 0, 1, 0, 0);\n\t\t\tctx.drawImage(img, 0, -i * sprite.height);\n\t\t\tsprite.frames.push(frame);\n\t\t}\n\t\tsprite.ready = 1;\n\t}\n}\n"],"mappings":"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","names":["Image","Sprite","name","frames","animation_start","fps","ready","width","height","push","Image","setFPS","dt","frame","Date","now","length","newDt","setFrame","getFrame","Math","floor","getCurrentFrameCanvas","canvas","resolveFrameCount","imgWidth","imgHeight","requested","available","min","LoadSprite","url","properties","loaded","sprite","img","window","location","protocol","crossOrigin","src","onload","numframes","round","i","initContext","ctx","context","setTransform","drawImage","onerror","UpdateSprite"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+	"name": "@al8b/sprites",
+	"version": "0.1.0",
+	"sideEffects": false,
+	"files": [
+		"dist/**/*",
+		"README.md",
+		"package.json"
+	],
+	"scripts": {
+		"build": "tsup",
+		"clean": "bun --bun ../../../scripts/clean-package.mjs dist",
+		"test": "vitest run --passWithNoTests"
+	},
+	"main": "./dist/index.js",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.mjs",
+			"require": "./dist/index.js"
+		}
+	},
+	"dependencies": {
+		"@al8b/diagnostics": "workspace:*",
+		"@al8b/image": "workspace:*"
+	},
+	"keywords": [
+		"sprites"
+	],
+	"devDependencies": {
+		"@types/jsdom": "^27.0.0",
+		"@vitest/ui": "^4.0.9",
+		"happy-dom": "^20.0.10",
+		"jsdom": "^24.1.3",
+		"vitest": "^4.0.9"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}