@codexo/exojs-aseprite 0.14.0 → 0.15.1

package/README.md

@@ -0,0 +1,83 @@
+# @codexo/exojs-aseprite
+
+Official ExoJS extension for loading [Aseprite](https://www.aseprite.org) JSON sprite-sheet
+exports into a ready-to-animate sprite, with one animation clip per Aseprite frame tag.
+
+## Installation
+
+```sh
+npm install @codexo/exojs @codexo/exojs-aseprite
+```
+
+`@codexo/exojs` is a peer dependency. This package has no other runtime dependencies.
+
+> Export your sprite sheet from Aseprite as a **JSON + PNG** pair (`File → Export Sprite Sheet`,
+> *Output → JSON Data*). Either array or hash frame mode works; frame tags become animation clips.
+
+## What this package provides
+
+- `AsepriteSheet` — parsed sprite sheet; the result of `loader.load(AsepriteSheet, url)`. Exposes
+  the underlying `spritesheet`, a `clips` map (one `AnimatedSpriteClipDefinition` per frame tag),
+  and `createAnimatedSprite()` for a ready-to-play `AnimatedSprite`
+- `asepriteExtension` — extension descriptor registering the Aseprite asset binding
+- `asepriteBinding` — the underlying `AssetBinding` (advanced/custom wiring)
+- `AsepriteFormatError` — typed error thrown on malformed Aseprite JSON
+- `AsepriteData` and related types (`AsepriteFrameData`, `AsepriteFrameTag`, `AsepriteMeta`,
+  `AsepriteSlice`, …) plus the `isAsepriteArrayData` guard
+
+## Usage
+
+Register the extension, load an Aseprite JSON export, and create an animated sprite. The extension
+fetches the JSON, resolves and loads the packed texture, and builds one clip per frame tag:
+
+```ts
+import { Application } from '@codexo/exojs';
+import { AsepriteSheet, asepriteExtension } from '@codexo/exojs-aseprite';
+
+const app = new Application({ extensions: [asepriteExtension] });
+
+const sheet = await app.loader.load(AsepriteSheet, 'sprites/hero.aseprite.json');
+
+const sprite = sheet.createAnimatedSprite();
+sprite.play('run'); // 'run' is an Aseprite frame-tag name
+app.scene.root.addChild(sprite);
+```
+
+Clip frame rate is derived from each frame's Aseprite `duration` (falling back to 12 fps). Frame
+indices in a tag are resolved against the ordered frame array; out-of-range indices are skipped.
+
+## `/register` convenience entry
+
+Importing `/register` registers `asepriteExtension` in the global `ExtensionRegistry`, so
+subsequently created Applications that use global defaults pick it up automatically:
+
+```ts
+// Side effect: registers asepriteExtension in the global ExtensionRegistry.
+import '@codexo/exojs-aseprite/register';
+
+// All named exports are also re-exported from /register:
+import { AsepriteSheet, asepriteExtension } from '@codexo/exojs-aseprite/register';
+```
+
+This is the only side-effectful entry — importing the package root (`@codexo/exojs-aseprite`) does
+**not** register anything.
+
+## Texture ownership
+
+The packed texture is loaded via the Loader and stays in the Loader cache. `AsepriteSheet.destroy()`
+releases the parsed sprite sheet; the Loader handles texture lifecycle and deduplication.
+
+## Core compatibility
+
+| `@codexo/exojs-aseprite` | `@codexo/exojs` |
+|---|---|
+| 0.14.x | 0.14.x |
+
+## Links
+
+- [API reference](https://exojs.dev/api/exojs-aseprite)
+- [Aseprite](https://www.aseprite.org)
+
+## License
+
+MIT © Codexo

package/dist/esm/AsepriteData.d.ts

@@ -35,6 +35,11 @@ export interface AsepriteFrameTag {
     /** Inclusive start frame index. */
     readonly from: number;
     readonly name: string;
+    /**
+     * Number of times the tag plays before stopping, as a numeric string
+     * (e.g. `"1"`, `"2"`). Absent means the tag loops indefinitely.
+     */
+    readonly repeat?: string;
 }
 /** A single layer entry in the Aseprite JSON metadata. */
 export interface AsepriteLayer {

package/dist/esm/AsepriteData.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsepriteData.js","sources":["../../../src/AsepriteData.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AACA;AAkGA;AACM,SAAU,mBAAmB,CAAC,IAAkB,EAAA;IACpD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;AACnC;;;;"}
+{"version":3,"file":"AsepriteData.js","sources":["../../../src/AsepriteData.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AACA;AAuGA;AACM,SAAU,mBAAmB,CAAC,IAAkB,EAAA;IACpD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;AACnC;;;;"}

package/dist/esm/AsepriteSheet.d.ts

@@ -1,5 +1,5 @@
 import { AnimatedSprite, type AnimatedSpriteClipDefinition, Spritesheet, type Texture } from '@codexo/exojs';
-import { type AsepriteData } from './AsepriteData';
+import { type AsepriteData, type AsepriteSlice } from './AsepriteData';
 /**
  * Parsed representation of an Aseprite JSON sprite sheet export.
  *
@@ -29,12 +29,21 @@ export declare class AsepriteSheet {
      * they are cloned automatically when passed to {@link AnimatedSprite.defineClip}.
      */
     readonly clips: ReadonlyMap<string, AnimatedSpriteClipDefinition>;
+    /**
+     * Named slices from the Aseprite `meta.slices` metadata, keyed by slice
+     * name. Slices describe editor-defined regions — hitboxes, nine-patch
+     * borders, UI anchor points — that aren't part of the frame/animation
+     * data itself. Each {@link AsepriteSlice} carries one {@link AsepriteSliceKey}
+     * per frame at which its bounds change; consumers resolve the applicable
+     * key for a given frame index themselves.
+     */
+    readonly slices: ReadonlyMap<string, AsepriteSlice>;
     /**
      * @internal — use {@link AsepriteSheet.parse} to create instances.
      * The public modifier is required for the Loader's `AssetConstructor` token
      * contract; users should call `parse()` instead of constructing directly.
      */
-    constructor(spritesheet: Spritesheet, clips: ReadonlyMap<string, AnimatedSpriteClipDefinition>);
+    constructor(spritesheet: Spritesheet, clips: ReadonlyMap<string, AnimatedSpriteClipDefinition>, slices: ReadonlyMap<string, AsepriteSlice>);
     /**
      * Parse a raw {@link AsepriteData} document and the already-loaded
      * {@link Texture} into an {@link AsepriteSheet}.
@@ -43,9 +52,24 @@ export declare class AsepriteSheet {
      * `frameTags` are resolved against the ordered frame array; out-of-range
      * indices are silently skipped.
      *
-     * Ping-pong directions (`pingpong`, `pingpong_reverse`) are recorded with
-     * `loop: true` but the reversed segment is not automatically appended —
-     * the clip plays only the declared `from`→`to` range.
+     * A tag's `direction` determines the expanded frame sequence fed into the
+     * clip — `forward` and `reverse` play the `[from, to]` range in order or
+     * in reverse, while `pingpong`/`pingpong_reverse` append a backward pass
+     * (excluding both endpoints) so the bounce plays back correctly on the
+     * engine's forward-only {@link AnimatedSprite} playback. The tag's
+     * `repeat` field maps directly onto {@link AnimatedSpriteClipDefinition.repeat}:
+     * absent means the clip loops indefinitely (`repeat: -1`); a numeric
+     * string (`"1"`, `"2"`, …) means it plays exactly that many full cycles
+     * before stopping.
+     *
+     * Each clip's `frameDurations` carries the real per-frame `duration` from
+     * the export (falling back to the tag's average when a frame's duration is
+     * non-positive), so uneven hold-frames survive into playback instead of
+     * being flattened to a uniform fps. `frameOffsets` carries each frame's
+     * `spriteSourceSize` `{x,y}` — its trimmed content's offset within the
+     * untrimmed canvas — whenever any frame in the tag is trimmed, so frames
+     * trimmed by different amounts stay anchored instead of jittering; it's
+     * omitted entirely for tags with no trimmed frames.
      */
     static parse(data: AsepriteData, texture: Texture): AsepriteSheet;
     /**

package/dist/esm/AsepriteSheet.js

@@ -13,17 +13,63 @@ function normaliseFrames(data) {
     return Object.values(data.frames);
 }
 /**
- * Calculates the average frames-per-second for a subset of frames, based on
- * the per-frame `duration` field (milliseconds per frame) exported by Aseprite.
- * Falls back to `12` fps when all durations are zero or the slice is empty.
+ * Expands a frame tag's inclusive `[from, to]` range into the ordered
+ * sequence of frame indices it actually plays, according to its
+ * {@link AsepriteDirection}. Indices are not bounds-checked against the
+ * frame array here; callers filter out-of-range entries separately.
+ *
+ * - `forward`: `[from, from+1, ..., to]`.
+ * - `reverse`: `[to, to-1, ..., from]`.
+ * - `pingpong`: a forward pass followed by a backward pass that excludes
+ *   both endpoints, e.g. `[0,1,2]` becomes `[0,1,2,1]`.
+ * - `pingpong_reverse`: the mirrored shape, starting from `to`.
+ * - A single-frame tag (`from === to`) always yields just that one frame.
+ */
+function expandFrameIndices(tag) {
+    const { from, to } = tag;
+    if (from === to) {
+        return [from];
+    }
+    const indices = [];
+    switch (tag.direction) {
+        case 'reverse':
+            for (let i = to; i >= from; i--)
+                indices.push(i);
+            break;
+        case 'pingpong':
+            for (let i = from; i <= to; i++)
+                indices.push(i);
+            for (let i = to - 1; i > from; i--)
+                indices.push(i);
+            break;
+        case 'pingpong_reverse':
+            for (let i = to; i >= from; i--)
+                indices.push(i);
+            for (let i = from + 1; i < to; i++)
+                indices.push(i);
+            break;
+        case 'forward':
+        default:
+            for (let i = from; i <= to; i++)
+                indices.push(i);
+            break;
+    }
+    return indices;
+}
+/**
+ * Calculates the average frames-per-second for a sequence of frame indices,
+ * based on the per-frame `duration` field (milliseconds per frame) exported
+ * by Aseprite. Every occurrence of an index counts toward the average — for
+ * ping-pong sequences that means repeated (bounced) frames are weighted twice.
+ * Falls back to `12` fps when all durations are zero or the sequence is empty.
  */
-function avgFps(frames, from, to) {
-    const slice = frames.slice(from, to + 1);
-    if (slice.length === 0) {
+function avgFps(frameArray, indices) {
+    const durations = indices.filter(i => i >= 0 && i < frameArray.length).map(i => frameArray[i].duration);
+    if (durations.length === 0) {
         return 12;
     }
-    const totalMs = slice.reduce((sum, f) => sum + f.duration, 0);
-    const avgMs = totalMs / slice.length;
+    const totalMs = durations.reduce((sum, d) => sum + d, 0);
+    const avgMs = totalMs / durations.length;
     return avgMs > 0 ? 1000 / avgMs : 12;
 }
 /**
@@ -55,14 +101,24 @@ class AsepriteSheet {
      * they are cloned automatically when passed to {@link AnimatedSprite.defineClip}.
      */
     clips;
+    /**
+     * Named slices from the Aseprite `meta.slices` metadata, keyed by slice
+     * name. Slices describe editor-defined regions — hitboxes, nine-patch
+     * borders, UI anchor points — that aren't part of the frame/animation
+     * data itself. Each {@link AsepriteSlice} carries one {@link AsepriteSliceKey}
+     * per frame at which its bounds change; consumers resolve the applicable
+     * key for a given frame index themselves.
+     */
+    slices;
     /**
      * @internal — use {@link AsepriteSheet.parse} to create instances.
      * The public modifier is required for the Loader's `AssetConstructor` token
      * contract; users should call `parse()` instead of constructing directly.
      */
-    constructor(spritesheet, clips) {
+    constructor(spritesheet, clips, slices) {
         this.spritesheet = spritesheet;
         this.clips = clips;
+        this.slices = slices;
     }
     /**
      * Parse a raw {@link AsepriteData} document and the already-loaded
@@ -72,9 +128,24 @@ class AsepriteSheet {
      * `frameTags` are resolved against the ordered frame array; out-of-range
      * indices are silently skipped.
      *
-     * Ping-pong directions (`pingpong`, `pingpong_reverse`) are recorded with
-     * `loop: true` but the reversed segment is not automatically appended —
-     * the clip plays only the declared `from`→`to` range.
+     * A tag's `direction` determines the expanded frame sequence fed into the
+     * clip — `forward` and `reverse` play the `[from, to]` range in order or
+     * in reverse, while `pingpong`/`pingpong_reverse` append a backward pass
+     * (excluding both endpoints) so the bounce plays back correctly on the
+     * engine's forward-only {@link AnimatedSprite} playback. The tag's
+     * `repeat` field maps directly onto {@link AnimatedSpriteClipDefinition.repeat}:
+     * absent means the clip loops indefinitely (`repeat: -1`); a numeric
+     * string (`"1"`, `"2"`, …) means it plays exactly that many full cycles
+     * before stopping.
+     *
+     * Each clip's `frameDurations` carries the real per-frame `duration` from
+     * the export (falling back to the tag's average when a frame's duration is
+     * non-positive), so uneven hold-frames survive into playback instead of
+     * being flattened to a uniform fps. `frameOffsets` carries each frame's
+     * `spriteSourceSize` `{x,y}` — its trimmed content's offset within the
+     * untrimmed canvas — whenever any frame in the tag is trimmed, so frames
+     * trimmed by different amounts stay anchored instead of jittering; it's
+     * omitted entirely for tags with no trimmed frames.
      */
     static parse(data, texture) {
         const frameArray = normaliseFrames(data);
@@ -89,22 +160,53 @@ class AsepriteSheet {
         const clips = new Map();
         const frameTags = data.meta.frameTags ?? [];
         for (const tag of frameTags) {
-            const frames = [];
-            for (let i = tag.from; i <= tag.to; i++) {
-                if (i >= 0 && i < frameArray.length) {
-                    frames.push(spritesheet.getFrame(String(i)));
-                }
-            }
+            // Out-of-range indices are silently skipped; `validIndices` parallels
+            // `frames` exactly, so it's the basis for every other per-frame array
+            // (durations, offsets) built below.
+            const validIndices = expandFrameIndices(tag).filter(i => i >= 0 && i < frameArray.length);
+            const frames = validIndices.map(i => spritesheet.getFrame(String(i)));
             if (frames.length === 0) {
                 continue;
             }
+            // Aseprite's `tag.repeat` (a numeric string, `'1'` through any N) maps
+            // directly onto the engine's `repeat` count. Absent means the tag
+            // loops indefinitely, the engine's `-1` sentinel.
+            const repeat = tag.repeat !== undefined ? Number(tag.repeat) : -1;
+            const fps = avgFps(frameArray, validIndices);
+            // Per-frame hold duration (Aseprite "duration"), so uneven hold-frames
+            // (e.g. a lingering idle frame) survive into playback instead of being
+            // flattened to the tag's average fps. A non-positive duration (same
+            // degenerate case `avgFps` guards against) falls back to the average.
+            const avgDurationFallback = 1000 / fps;
+            const frameDurations = validIndices.map(i => {
+                const duration = frameArray[i].duration;
+                return duration > 0 ? duration : avgDurationFallback;
+            });
+            // Per-frame trim offset (Aseprite "spriteSourceSize"), so frames trimmed
+            // by different amounts stay anchored to the same point in the untrimmed
+            // canvas instead of jittering frame to frame. Omitted entirely when no
+            // frame in the tag is trimmed, to avoid noise on untrimmed sheets.
+            const anyTrimmed = validIndices.some(i => frameArray[i].trimmed);
+            const frameOffsets = anyTrimmed
+                ? validIndices.map(i => {
+                    const { x, y } = frameArray[i].spriteSourceSize;
+                    return { x, y };
+                })
+                : undefined;
             clips.set(tag.name, {
-                fps: avgFps(frameArray, tag.from, tag.to),
+                fps,
                 frames,
-                loop: true,
+                repeat,
+                frameDurations,
+                ...(frameOffsets ? { frameOffsets } : {}),
             });
         }
-        return new AsepriteSheet(spritesheet, clips);
+        // Build the slices map from meta.slices, keyed by slice name.
+        const slices = new Map();
+        for (const slice of data.meta.slices ?? []) {
+            slices.set(slice.name, slice);
+        }
+        return new AsepriteSheet(spritesheet, clips, slices);
     }
     /**
      * Create an {@link AnimatedSprite} with all frame-tag clips pre-defined.

package/dist/esm/AsepriteSheet.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsepriteSheet.js","sources":["../../../src/AsepriteSheet.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"AsepriteSheet.js","sources":["../../../src/AsepriteSheet.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/asepriteBinding.js

@@ -29,7 +29,11 @@ function resolveAsepriteUrl(ref, base) {
         return new URL(ref, base).href;
     }
     const resolved = new URL(ref, syntheticOrigin + base.replace(/^\/+/, ''));
-    return resolved.href.slice(syntheticOrigin.length);
+    const relative = resolved.href.slice(syntheticOrigin.length);
+    // A root-relative base must produce a root-relative result again — dropping
+    // the leading slash would make the browser re-resolve the reference against
+    // the document base URL (e.g. `/site/assets/x.png` → `/site/site/assets/…`).
+    return base.startsWith('/') ? `/${relative}` : relative;
 }
 // ── Validation ───────────────────────────────────────────────────────────────
 /**

package/dist/esm/asepriteBinding.js.map

@@ -1 +1 @@
-{"version":3,"file":"asepriteBinding.js","sources":["../../../src/asepriteBinding.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"asepriteBinding.js","sources":["../../../src/asepriteBinding.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codexo/exojs-aseprite",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "description": "Aseprite sprite sheet asset extension for ExoJS.",
   "repository": {
     "type": "git",
@@ -33,10 +33,10 @@
     "LICENSE"
   ],
   "peerDependencies": {
-    "@codexo/exojs": "0.14.x"
+    "@codexo/exojs": "0.15.x"
   },
   "devDependencies": {
-    "@codexo/exojs": "0.14.0",
+    "@codexo/exojs": "0.15.1",
     "@codexo/exojs-config": "0.0.0"
   },
   "license": "MIT",