@codexo/exojs-aseprite 0.14.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Codexo
+
+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/dist/esm/AsepriteData.d.ts

@@ -0,0 +1,86 @@
+/** Playback direction of an Aseprite frame tag animation. */
+export type AsepriteDirection = 'forward' | 'pingpong' | 'pingpong_reverse' | 'reverse';
+/** Pixel region rectangle used throughout the Aseprite JSON format. */
+export interface AsepriteRect {
+    readonly h: number;
+    readonly w: number;
+    readonly x: number;
+    readonly y: number;
+}
+/** Width/height size descriptor used in Aseprite metadata. */
+export interface AsepriteSize {
+    readonly h: number;
+    readonly w: number;
+}
+/** A single animation frame in the Aseprite JSON export. */
+export interface AsepriteFrameData {
+    /** Display duration of this frame in milliseconds. */
+    readonly duration: number;
+    /** Pixel region of this frame within the packed sprite sheet texture. */
+    readonly frame: AsepriteRect;
+    readonly rotated: boolean;
+    readonly sourceSize: AsepriteSize;
+    readonly spriteSourceSize: AsepriteRect;
+    readonly trimmed: boolean;
+}
+/**
+ * A named animation range defined via Aseprite frame tags.
+ * `from` and `to` are inclusive zero-based frame indices.
+ */
+export interface AsepriteFrameTag {
+    readonly color?: string;
+    readonly direction: AsepriteDirection;
+    /** Inclusive end frame index. */
+    readonly to: number;
+    /** Inclusive start frame index. */
+    readonly from: number;
+    readonly name: string;
+}
+/** A single layer entry in the Aseprite JSON metadata. */
+export interface AsepriteLayer {
+    readonly blendMode: string;
+    readonly name: string;
+    readonly opacity: number;
+}
+/** Bounds of a named slice at a specific frame. */
+export interface AsepriteSliceKey {
+    readonly bounds: AsepriteRect;
+    readonly frame: number;
+}
+/** A named slice defined in the Aseprite editor. */
+export interface AsepriteSlice {
+    readonly color?: string;
+    readonly keys: readonly AsepriteSliceKey[];
+    readonly name: string;
+}
+/** Metadata block of an Aseprite JSON export. */
+export interface AsepriteMeta {
+    readonly app: string;
+    readonly format: string;
+    readonly frameTags?: readonly AsepriteFrameTag[];
+    /** Relative path to the exported sprite sheet image. */
+    readonly image: string;
+    readonly layers?: readonly AsepriteLayer[];
+    readonly scale: string;
+    readonly size: AsepriteSize;
+    readonly slices?: readonly AsepriteSlice[];
+    readonly version: string;
+}
+/** Aseprite JSON export in array mode — frames is an ordered array. */
+export interface AsepriteArrayData {
+    readonly frames: readonly AsepriteFrameData[];
+    readonly meta: AsepriteMeta;
+}
+/** Aseprite JSON export in hash mode — frames is an object keyed by frame name. */
+export interface AsepriteHashData {
+    readonly frames: Readonly<Record<string, AsepriteFrameData>>;
+    readonly meta: AsepriteMeta;
+}
+/**
+ * Union of both Aseprite JSON export formats.
+ *
+ * Use {@link isAsepriteArrayData} to discriminate between array and hash mode.
+ */
+export type AsepriteData = AsepriteArrayData | AsepriteHashData;
+/** Returns `true` when `data` is in array mode (frames is an array). */
+export declare function isAsepriteArrayData(data: AsepriteData): data is AsepriteArrayData;

package/dist/esm/AsepriteData.js

@@ -0,0 +1,10 @@
+// TypeScript types for the Aseprite JSON sprite sheet export format.
+// Supports both array mode (frames is an ordered array) and hash mode
+// (frames is an object keyed by frame name / filename).
+/** Returns `true` when `data` is in array mode (frames is an array). */
+function isAsepriteArrayData(data) {
+    return Array.isArray(data.frames);
+}
+
+export { isAsepriteArrayData };
+//# sourceMappingURL=AsepriteData.js.map

package/dist/esm/AsepriteData.js.map

@@ -0,0 +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;;;;"}

package/dist/esm/AsepriteSheet.d.ts

@@ -0,0 +1,61 @@
+import { AnimatedSprite, type AnimatedSpriteClipDefinition, Spritesheet, type Texture } from '@codexo/exojs';
+import { type AsepriteData } from './AsepriteData';
+/**
+ * Parsed representation of an Aseprite JSON sprite sheet export.
+ *
+ * `AsepriteSheet.parse(data, texture)` converts the raw JSON document into:
+ * - A {@link Spritesheet} whose frames correspond to the Aseprite frame array
+ *   (keyed by zero-based index string: `"0"`, `"1"`, …).
+ * - A `clips` map of {@link AnimatedSpriteClipDefinition} entries built from
+ *   `meta.frameTags`, one per named tag.
+ *
+ * Call {@link createAnimatedSprite} to obtain a ready-to-use
+ * {@link AnimatedSprite} with all clips pre-registered.
+ *
+ * @example
+ * ```ts
+ * const sheet = await loader.load(AsepriteSheet, 'hero.aseprite.json');
+ * const sprite = sheet.createAnimatedSprite();
+ * sprite.play('run');
+ * scene.addChild(sprite);
+ * ```
+ */
+export declare class AsepriteSheet {
+    /** The underlying {@link Spritesheet} whose frames are keyed by index string. */
+    readonly spritesheet: Spritesheet;
+    /**
+     * Animation clips derived from the Aseprite `frameTags` metadata.
+     * Each clip's frames are live references into {@link spritesheet.frames};
+     * they are cloned automatically when passed to {@link AnimatedSprite.defineClip}.
+     */
+    readonly clips: ReadonlyMap<string, AnimatedSpriteClipDefinition>;
+    /**
+     * @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>);
+    /**
+     * Parse a raw {@link AsepriteData} document and the already-loaded
+     * {@link Texture} into an {@link AsepriteSheet}.
+     *
+     * Supports both Aseprite array mode and hash mode. Frame indices from
+     * `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.
+     */
+    static parse(data: AsepriteData, texture: Texture): AsepriteSheet;
+    /**
+     * Create an {@link AnimatedSprite} with all frame-tag clips pre-defined.
+     *
+     * Each clip is registered via {@link AnimatedSprite.defineClip}, which
+     * clones the frame {@link Rectangle}s so the sprite owns its own copies.
+     * Call {@link AnimatedSprite.play} with a tag name to start playback.
+     */
+    createAnimatedSprite(): AnimatedSprite;
+    /** Destroy the underlying {@link Spritesheet} and release its frame resources. */
+    destroy(): void;
+}

package/dist/esm/AsepriteSheet.js

@@ -0,0 +1,130 @@
+import { Spritesheet, AnimatedSprite } from '@codexo/exojs';
+import { isAsepriteArrayData } from './AsepriteData.js';
+
+/**
+ * Normalises an {@link AsepriteData} document into an ordered array of
+ * {@link AsepriteFrameData} entries regardless of whether the JSON was
+ * produced in array or hash mode.
+ */
+function normaliseFrames(data) {
+    if (isAsepriteArrayData(data)) {
+        return [...data.frames];
+    }
+    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.
+ */
+function avgFps(frames, from, to) {
+    const slice = frames.slice(from, to + 1);
+    if (slice.length === 0) {
+        return 12;
+    }
+    const totalMs = slice.reduce((sum, f) => sum + f.duration, 0);
+    const avgMs = totalMs / slice.length;
+    return avgMs > 0 ? 1000 / avgMs : 12;
+}
+/**
+ * Parsed representation of an Aseprite JSON sprite sheet export.
+ *
+ * `AsepriteSheet.parse(data, texture)` converts the raw JSON document into:
+ * - A {@link Spritesheet} whose frames correspond to the Aseprite frame array
+ *   (keyed by zero-based index string: `"0"`, `"1"`, …).
+ * - A `clips` map of {@link AnimatedSpriteClipDefinition} entries built from
+ *   `meta.frameTags`, one per named tag.
+ *
+ * Call {@link createAnimatedSprite} to obtain a ready-to-use
+ * {@link AnimatedSprite} with all clips pre-registered.
+ *
+ * @example
+ * ```ts
+ * const sheet = await loader.load(AsepriteSheet, 'hero.aseprite.json');
+ * const sprite = sheet.createAnimatedSprite();
+ * sprite.play('run');
+ * scene.addChild(sprite);
+ * ```
+ */
+class AsepriteSheet {
+    /** The underlying {@link Spritesheet} whose frames are keyed by index string. */
+    spritesheet;
+    /**
+     * Animation clips derived from the Aseprite `frameTags` metadata.
+     * Each clip's frames are live references into {@link spritesheet.frames};
+     * they are cloned automatically when passed to {@link AnimatedSprite.defineClip}.
+     */
+    clips;
+    /**
+     * @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) {
+        this.spritesheet = spritesheet;
+        this.clips = clips;
+    }
+    /**
+     * Parse a raw {@link AsepriteData} document and the already-loaded
+     * {@link Texture} into an {@link AsepriteSheet}.
+     *
+     * Supports both Aseprite array mode and hash mode. Frame indices from
+     * `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.
+     */
+    static parse(data, texture) {
+        const frameArray = normaliseFrames(data);
+        // Build SpritesheetData: frame names are zero-based index strings.
+        const spritesheetFrames = {};
+        for (let i = 0; i < frameArray.length; i++) {
+            const frameData = frameArray[i];
+            spritesheetFrames[String(i)] = { frame: frameData.frame };
+        }
+        const spritesheet = new Spritesheet(texture, { frames: spritesheetFrames });
+        // Build clips from frameTags, resolving frame indices into Rectangles.
+        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)));
+                }
+            }
+            if (frames.length === 0) {
+                continue;
+            }
+            clips.set(tag.name, {
+                fps: avgFps(frameArray, tag.from, tag.to),
+                frames,
+                loop: true,
+            });
+        }
+        return new AsepriteSheet(spritesheet, clips);
+    }
+    /**
+     * Create an {@link AnimatedSprite} with all frame-tag clips pre-defined.
+     *
+     * Each clip is registered via {@link AnimatedSprite.defineClip}, which
+     * clones the frame {@link Rectangle}s so the sprite owns its own copies.
+     * Call {@link AnimatedSprite.play} with a tag name to start playback.
+     */
+    createAnimatedSprite() {
+        const sprite = new AnimatedSprite(this.spritesheet.texture);
+        for (const [name, clip] of this.clips) {
+            sprite.defineClip(name, clip);
+        }
+        return sprite;
+    }
+    /** Destroy the underlying {@link Spritesheet} and release its frame resources. */
+    destroy() {
+        this.spritesheet.destroy();
+    }
+}
+
+export { AsepriteSheet };
+//# sourceMappingURL=AsepriteSheet.js.map

package/dist/esm/AsepriteSheet.js.map

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

package/dist/esm/asepriteBinding.d.ts

@@ -0,0 +1,27 @@
+import { AsepriteSheet } from './AsepriteSheet';
+/**
+ * Thrown when an Aseprite JSON document does not match the expected shape.
+ * `source` is the URL of the file being parsed.
+ */
+export declare class AsepriteFormatError extends Error {
+    readonly source: string;
+    constructor(source: string, message: string);
+}
+/**
+ * Declarative asset binding for {@link AsepriteSheet}.
+ *
+ * `loader.load(AsepriteSheet, 'hero.aseprite.json')` fetches and validates the
+ * Aseprite JSON export, resolves the packed image URL from `meta.image`
+ * (relative to the JSON source), loads the {@link Texture} via the Loader's
+ * sub-load deduplication, and constructs a fully-parsed {@link AsepriteSheet}.
+ *
+ * The `aseprite` type name enables the asset-config shorthand:
+ * `{ type: 'aseprite', source: 'hero.aseprite.json' }`.
+ */
+export declare const asepriteBinding: {
+    type: typeof AsepriteSheet;
+    typeNames: string[];
+    create(): {
+        load(req: import("@codexo/exojs").AssetLoadRequest<undefined>, ctx: import("@codexo/exojs").AssetLoaderContext): Promise<AsepriteSheet>;
+    };
+};

package/dist/esm/asepriteBinding.js

@@ -0,0 +1,102 @@
+import { Texture } from '@codexo/exojs';
+import { AsepriteSheet } from './AsepriteSheet.js';
+
+// Relative-path resolution for Aseprite image references (JSON → PNG).
+// Mirrors the approach used in @codexo/exojs-tiled: Aseprite stores the image
+// path relative to the JSON file; asset sources are often themselves relative,
+// so plain `new URL(ref, base)` cannot be used when `base` has no scheme.
+// ── URL resolution ───────────────────────────────────────────────────────────
+/** Matches references that are already absolute: scheme, `//`, `/`, data/blob. */
+const absoluteRefPattern = /^(?:[a-z][a-z\d+.-]*:|\/\/|\/)/i;
+/** Matches a base that has an explicit scheme (absolute URL). */
+const absoluteBasePattern = /^[a-z][a-z\d+.-]*:/i;
+/** Synthetic origin used to borrow `URL`'s `../`/`./` collapsing. */
+const syntheticOrigin = 'https://exojs.invalid/';
+/**
+ * Resolves `ref` (the image path read from an Aseprite JSON file) relative to
+ * `base` (the resolved location of the JSON file itself).
+ *
+ * - Absolute refs (scheme, `//`, `/`, `data:`, `blob:`) are returned as-is.
+ * - Absolute bases delegate to `new URL(ref, base).href`.
+ * - Relative bases use a synthetic origin to collapse `./` and `../` segments,
+ *   then strips the origin from the result.
+ */
+function resolveAsepriteUrl(ref, base) {
+    if (absoluteRefPattern.test(ref)) {
+        return ref;
+    }
+    if (absoluteBasePattern.test(base)) {
+        return new URL(ref, base).href;
+    }
+    const resolved = new URL(ref, syntheticOrigin + base.replace(/^\/+/, ''));
+    return resolved.href.slice(syntheticOrigin.length);
+}
+// ── Validation ───────────────────────────────────────────────────────────────
+/**
+ * Thrown when an Aseprite JSON document does not match the expected shape.
+ * `source` is the URL of the file being parsed.
+ */
+class AsepriteFormatError extends Error {
+    source;
+    constructor(source, message) {
+        super(`[AsepriteFormatError] ${source}: ${message}`);
+        this.name = 'AsepriteFormatError';
+        this.source = source;
+    }
+}
+/**
+ * Validates an `unknown` value against the minimum required Aseprite JSON
+ * shape and narrows it to {@link AsepriteData}. Throws {@link AsepriteFormatError}
+ * on any mismatch.
+ */
+function validateAsepriteData(raw, source) {
+    if (typeof raw !== 'object' || raw === null) {
+        throw new AsepriteFormatError(source, 'root must be an object');
+    }
+    const doc = raw;
+    if (!('frames' in doc)) {
+        throw new AsepriteFormatError(source, 'missing required field "frames"');
+    }
+    if (!('meta' in doc) || typeof doc.meta !== 'object' || doc.meta === null) {
+        throw new AsepriteFormatError(source, 'missing required field "meta"');
+    }
+    const meta = doc.meta;
+    if (typeof meta.image !== 'string' || meta.image.length === 0) {
+        throw new AsepriteFormatError(source, '"meta.image" must be a non-empty string');
+    }
+    const frames = doc.frames;
+    if (!Array.isArray(frames) && (typeof frames !== 'object' || frames === null)) {
+        throw new AsepriteFormatError(source, '"frames" must be an array or an object');
+    }
+    return doc;
+}
+// ── Asset binding ─────────────────────────────────────────────────────────────
+/**
+ * Declarative asset binding for {@link AsepriteSheet}.
+ *
+ * `loader.load(AsepriteSheet, 'hero.aseprite.json')` fetches and validates the
+ * Aseprite JSON export, resolves the packed image URL from `meta.image`
+ * (relative to the JSON source), loads the {@link Texture} via the Loader's
+ * sub-load deduplication, and constructs a fully-parsed {@link AsepriteSheet}.
+ *
+ * The `aseprite` type name enables the asset-config shorthand:
+ * `{ type: 'aseprite', source: 'hero.aseprite.json' }`.
+ */
+const asepriteBinding = {
+    type: AsepriteSheet,
+    typeNames: ['asepriteSheet'],
+    create() {
+        return {
+            async load(req, ctx) {
+                const raw = await ctx.fetchJson(req.source);
+                const data = validateAsepriteData(raw, req.source);
+                const imageUrl = resolveAsepriteUrl(data.meta.image, req.source);
+                const texture = (await ctx.loader.load(Texture, imageUrl));
+                return AsepriteSheet.parse(data, texture);
+            },
+        };
+    },
+};
+
+export { AsepriteFormatError, asepriteBinding };
+//# sourceMappingURL=asepriteBinding.js.map

package/dist/esm/asepriteBinding.js.map

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

package/dist/esm/asepriteExtension.d.ts

@@ -0,0 +1,13 @@
+import type { Extension } from '@codexo/exojs/extensions';
+/**
+ * Default immutable Aseprite extension descriptor.
+ *
+ * Registers one asset binding:
+ * - {@link asepriteBinding} — `loader.load(AsepriteSheet, 'hero.aseprite.json')` →
+ *   fetches the Aseprite JSON, resolves and loads the packed texture, and
+ *   returns a fully-parsed {@link AsepriteSheet} with all frame-tag clips.
+ *
+ * Use with `ApplicationOptions.extensions` or call
+ * `import '@codexo/exojs-aseprite/register'` for global auto-registration.
+ */
+export declare const asepriteExtension: Extension;

package/dist/esm/asepriteExtension.js

@@ -0,0 +1,22 @@
+import { asepriteBinding } from './asepriteBinding.js';
+
+/**
+ * Default immutable Aseprite extension descriptor.
+ *
+ * Registers one asset binding:
+ * - {@link asepriteBinding} — `loader.load(AsepriteSheet, 'hero.aseprite.json')` →
+ *   fetches the Aseprite JSON, resolves and loads the packed texture, and
+ *   returns a fully-parsed {@link AsepriteSheet} with all frame-tag clips.
+ *
+ * Use with `ApplicationOptions.extensions` or call
+ * `import '@codexo/exojs-aseprite/register'` for global auto-registration.
+ */
+const asepriteExtension = Object.freeze({
+    id: '@codexo/exojs-aseprite',
+    // Localized erasure cast: typed binding (Options=undefined) meets the
+    // untyped Extension.assets contract here. Runtime behavior is unaffected.
+    assets: [asepriteBinding],
+});
+
+export { asepriteExtension };
+//# sourceMappingURL=asepriteExtension.js.map

package/dist/esm/asepriteExtension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asepriteExtension.js","sources":["../../../src/asepriteExtension.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;;;;;;;;AAUG;AACI,MAAM,iBAAiB,GAAc,MAAM,CAAC,MAAM,CAAC;AACxD,IAAA,EAAE,EAAE,wBAAwB;;;IAG5B,MAAM,EAAE,CAAC,eAAe,CAA8B;AACvD,CAAA;;;;"}

package/dist/esm/index.d.ts

@@ -0,0 +1 @@
+export * from './public';

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+export { AsepriteFormatError, asepriteBinding } from './asepriteBinding.js';
+export { isAsepriteArrayData } from './AsepriteData.js';
+export { asepriteExtension } from './asepriteExtension.js';
+export { AsepriteSheet } from './AsepriteSheet.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/esm/public.d.ts

@@ -0,0 +1,16 @@
+export { asepriteBinding, AsepriteFormatError } from './asepriteBinding';
+export type { AsepriteArrayData, AsepriteData, AsepriteDirection, AsepriteFrameData, AsepriteFrameTag, AsepriteHashData, AsepriteLayer, AsepriteMeta, AsepriteRect, AsepriteSize, AsepriteSlice, AsepriteSliceKey, } from './AsepriteData';
+export { isAsepriteArrayData } from './AsepriteData';
+export { asepriteExtension } from './asepriteExtension';
+export { AsepriteSheet } from './AsepriteSheet';
+import type { AsepriteSheet } from './AsepriteSheet';
+declare module '@codexo/exojs' {
+    interface AssetDefinitions {
+        asepriteSheet: {
+            resource: AsepriteSheet;
+            config: {
+                source: string;
+            };
+        };
+    }
+}

package/dist/esm/register.d.ts

@@ -0,0 +1 @@
+export * from './public';

package/dist/esm/register.js

@@ -0,0 +1,15 @@
+import { ExtensionRegistry } from '@codexo/exojs/extensions';
+import { asepriteExtension } from './asepriteExtension.js';
+export { AsepriteFormatError, asepriteBinding } from './asepriteBinding.js';
+export { isAsepriteArrayData } from './AsepriteData.js';
+export { AsepriteSheet } from './AsepriteSheet.js';
+
+// @codexo/exojs-aseprite/register — explicit registration entry.
+// Importing this entry registers the default asepriteExtension descriptor
+// in the global ExtensionRegistry. Subsequently constructed Applications
+// that use global defaults will receive the Aseprite extension.
+// This is the only side-effectful entry in this package.
+ExtensionRegistry.register(asepriteExtension);
+
+export { asepriteExtension };
+//# sourceMappingURL=register.js.map

package/dist/esm/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sources":["../../../src/register.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AAMA,iBAAiB,CAAC,QAAQ,CAAC,iBAAiB,CAAC;;;;"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@codexo/exojs-aseprite",
+  "version": "0.14.0",
+  "description": "Aseprite sprite sheet asset extension for ExoJS.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Exoridus/ExoJS.git",
+    "directory": "packages/exojs-aseprite"
+  },
+  "type": "module",
+  "sideEffects": [
+    "./dist/esm/register.js"
+  ],
+  "main": "./dist/esm/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "default": "./dist/esm/index.js"
+    },
+    "./register": {
+      "types": "./dist/esm/register.d.ts",
+      "import": "./dist/esm/register.js",
+      "default": "./dist/esm/register.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/esm/",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@codexo/exojs": "0.14.x"
+  },
+  "devDependencies": {
+    "@codexo/exojs": "0.14.0",
+    "@codexo/exojs-config": "0.0.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsx ../../node_modules/rollup/dist/bin/rollup -c --environment EXOJS_ENV:production",
+    "build:dev": "tsx ../../node_modules/rollup/dist/bin/rollup -c --environment EXOJS_ENV:development",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"src/**/*.ts\"",
+    "test": "vitest run --root ../.. --project=exojs-aseprite"
+  }
+}