spine-html 0.4.0 → 0.5.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAoB,MAAM,cAAc,CAAC;AAC1F,OAAO,EACL,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAoB,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAEL,eAAe,GAEhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAElB,gBAAgB,GAGjB,MAAM,yBAAyB,CAAC"}

package/dist/loadAtlasAssets.d.ts

@@ -0,0 +1,73 @@
+import { TextureAtlas } from '@esotericsoftware/spine-core';
+import { type RegionImage } from './DomTexture.js';
+/**
+ * Optional convenience loader, atlas half: fetch an atlas export, attach the
+ * page images, unpack the regions — once, for however many skeletons share it.
+ *
+ * It is deliberately the *only* thing this module does, and it deliberately
+ * knows nothing about skeleton exports: it must not drag a skeleton reader
+ * (SkeletonJson or SkeletonBinary) into the bundle of a consumer that only
+ * wanted the atlas. Reading a skeleton against these assets is
+ * `loadSkeletonJson` in loadSkeletonAssets.ts or `loadSkeletonBinary` in
+ * binary.ts, both of which sit on this seam.
+ *
+ * Nothing on the renderer's path imports this file, so a bundler drops it when
+ * it is unused.
+ */
+export interface LoadAtlasAssetsOptions {
+    /** URL of the atlas (.atlas) export. */
+    atlasUrl: string;
+    /**
+     * Maps an atlas page name to the URL its image lives at. Defaults to
+     * resolving the page name against the atlas URL's directory, which is what
+     * a Spine editor export next to its atlas needs.
+     */
+    resolvePage?: (pageName: string, atlasUrl: string) => string;
+    /**
+     * crossOrigin attribute for the page images. Needed when the images come
+     * from another origin: the region cut reads them into a canvas, and a
+     * tainted canvas cannot be exported (SecurityError from toBlob).
+     */
+    crossOrigin?: string;
+    /** fetch implementation, for custom headers or a test double. */
+    fetch?: typeof globalThis.fetch;
+}
+export interface AtlasAssets {
+    /** The parsed atlas, page textures attached. */
+    atlas: TextureAtlas;
+    /** Unpacked per-region bitmaps, ready for `new SpineHtmlRenderer(root, …)`. */
+    regionImages: Map<string, RegionImage>;
+    /**
+     * Frees the blob URLs this load created (see revokeRegions). Idempotent.
+     * Call it after the renderers using these images are disposed — a live
+     * <img> would be left pointing at a dead URL.
+     */
+    dispose(): void;
+}
+/** @internal Shared with loadSkeletonAssets.ts; not part of the package API. */
+export declare function fetchText(fetchImpl: typeof globalThis.fetch, url: string): Promise<string>;
+/**
+ * @internal Shared with binary.ts; not part of the package API. Same HTTP
+ * failure message as fetchText, so both skeleton readers reject alike.
+ */
+export declare function fetchBytes(fetchImpl: typeof globalThis.fetch, url: string): Promise<Uint8Array>;
+/**
+ * Loads an atlas and its regions once, to be shared by several skeletons.
+ *
+ * ```ts
+ * const shared = await loadAtlasAssets({ atlasUrl: '/spineboy/spineboy.atlas' });
+ * const [ess, pro] = await Promise.all([
+ *   loadSkeletonJson(shared, '/spineboy/spineboy-ess.json'),
+ *   loadSkeletonJson(shared, '/spineboy/spineboy-pro.json'),
+ * ]);
+ * // …later, after every renderer using them is disposed: shared.dispose();
+ * ```
+ *
+ * The caller owns the result: reading a skeleton against it never disposes it,
+ * and one `regionImages` map is meant to be handed to several renderers.
+ *
+ * Page images load in parallel. If anything fails part-way, no blob URL is
+ * left behind.
+ */
+export declare function loadAtlasAssets(options: LoadAtlasAssetsOptions): Promise<AtlasAssets>;
+//# sourceMappingURL=loadAtlasAssets.d.ts.map

package/dist/loadAtlasAssets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadAtlasAssets.d.ts","sourceRoot":"","sources":["../src/loadAtlasAssets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAc,KAAK,WAAW,EAAgC,MAAM,iBAAiB,CAAC;AAE7F;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7D;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,KAAK,EAAE,YAAY,CAAC;IACpB,+EAA+E;IAC/E,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD,gFAAgF;AAChF,wBAAsB,SAAS,CAAC,SAAS,EAAE,OAAO,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIhG;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,OAAO,UAAU,CAAC,KAAK,EAClC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,CAAC,CAIrB;AAYD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CA2B3F"}

package/dist/loadAtlasAssets.js

@@ -0,0 +1,75 @@
+import { TextureAtlas } from '@esotericsoftware/spine-core';
+import { DomTexture, revokeRegions, unpackRegions } from './DomTexture.js';
+function resolveAgainstAtlas(pageName, atlasUrl) {
+    return new URL(pageName, new URL(atlasUrl, document.baseURI)).href;
+}
+/** @internal Shared with loadSkeletonAssets.ts; not part of the package API. */
+export async function fetchText(fetchImpl, url) {
+    const response = await fetchImpl(url);
+    if (!response.ok)
+        throw new Error(`Failed to fetch ${url}: ${response.status}`);
+    return response.text();
+}
+/**
+ * @internal Shared with binary.ts; not part of the package API. Same HTTP
+ * failure message as fetchText, so both skeleton readers reject alike.
+ */
+export async function fetchBytes(fetchImpl, url) {
+    const response = await fetchImpl(url);
+    if (!response.ok)
+        throw new Error(`Failed to fetch ${url}: ${response.status}`);
+    return new Uint8Array(await response.arrayBuffer());
+}
+function loadImage(url, crossOrigin) {
+    return new Promise((resolve, reject) => {
+        const image = new Image();
+        if (crossOrigin !== undefined)
+            image.crossOrigin = crossOrigin;
+        image.onload = () => resolve(image);
+        image.onerror = () => reject(new Error(`Failed to load atlas page image: ${url}`));
+        image.src = url;
+    });
+}
+/**
+ * Loads an atlas and its regions once, to be shared by several skeletons.
+ *
+ * ```ts
+ * const shared = await loadAtlasAssets({ atlasUrl: '/spineboy/spineboy.atlas' });
+ * const [ess, pro] = await Promise.all([
+ *   loadSkeletonJson(shared, '/spineboy/spineboy-ess.json'),
+ *   loadSkeletonJson(shared, '/spineboy/spineboy-pro.json'),
+ * ]);
+ * // …later, after every renderer using them is disposed: shared.dispose();
+ * ```
+ *
+ * The caller owns the result: reading a skeleton against it never disposes it,
+ * and one `regionImages` map is meant to be handed to several renderers.
+ *
+ * Page images load in parallel. If anything fails part-way, no blob URL is
+ * left behind.
+ */
+export async function loadAtlasAssets(options) {
+    const { atlasUrl, crossOrigin } = options;
+    const fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
+    const resolvePage = options.resolvePage ?? resolveAgainstAtlas;
+    const atlas = new TextureAtlas(await fetchText(fetchImpl, atlasUrl));
+    const pageImages = new Map();
+    await Promise.all(atlas.pages.map(async (page) => {
+        const image = await loadImage(resolvePage(page.name, atlasUrl), crossOrigin);
+        page.setTexture(new DomTexture(image));
+        pageImages.set(page.name, image);
+    }));
+    const regionImages = await unpackRegions(atlas, pageImages);
+    let disposed = false;
+    return {
+        atlas,
+        regionImages,
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            revokeRegions(regionImages);
+        },
+    };
+}
+//# sourceMappingURL=loadAtlasAssets.js.map

package/dist/loadAtlasAssets.js.map

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

package/dist/loadSkeletonAssets.d.ts

@@ -1,5 +1,6 @@
 import { type SkeletonData, TextureAtlas } from '@esotericsoftware/spine-core';
-import { type RegionImage } from './DomTexture';
+import type { RegionImage } from './DomTexture.js';
+import { type LoadAtlasAssetsOptions } from './loadAtlasAssets.js';
 /**
  * Optional convenience loader: fetch a skeleton export and its atlas, attach
  * the page images, unpack the regions.
@@ -8,30 +9,24 @@ import { type RegionImage } from './DomTexture';
  * deliberately the *only* thing this module does — it owns no frame loop, no
  * AnimationState, no layout, and it is not on the renderer's path, so the
  * low-level route (TextureAtlas + DomTexture + unpackRegions by hand) stays
- * the way to do anything this does not cover: sharing one atlas across
- * several skeletons, binary (.skel) exports, images that come from somewhere
- * other than a URL. Nothing else in the package imports this file, so a
- * bundler drops it when it is unused.
+ * the way to do anything this does not cover: images that come from somewhere
+ * other than a URL, an atlas that is not fetched at all. Binary (.skel) exports
+ * are read by `loadSkeletonBinary`, from the separate `spine-html/binary` entry,
+ * on the same seam. Sharing one atlas across several
+ * skeletons has its own seam: `loadAtlasAssets` (loadAtlasAssets.ts) plus one
+ * `loadSkeletonJson` per skeleton, which is what this function is built on.
+ * Nothing else in the package imports this file, so a bundler drops it when it
+ * is unused.
  */
-export interface LoadSkeletonAssetsOptions {
-    /** URL of the atlas (.atlas) export. */
-    atlasUrl: string;
+export interface LoadSkeletonAssetsOptions extends LoadAtlasAssetsOptions {
     /** URL of the skeleton JSON (.json) export. */
     skeletonUrl: string;
-    /**
-     * Maps an atlas page name to the URL its image lives at. Defaults to
-     * resolving the page name against the atlas URL's directory, which is what
-     * a Spine editor export next to its atlas needs.
-     */
-    resolvePage?: (pageName: string, atlasUrl: string) => string;
     /** SkeletonJson.scale — scales the skeleton as it is read. */
     scale?: number;
-    /**
-     * crossOrigin attribute for the page images. Needed when the images come
-     * from another origin: the region cut reads them into a canvas, and a
-     * tainted canvas cannot be exported (SecurityError from toBlob).
-     */
-    crossOrigin?: string;
+}
+export interface LoadSkeletonJsonOptions {
+    /** SkeletonJson.scale — scales the skeleton as it is read. */
+    scale?: number;
     /** fetch implementation, for custom headers or a test double. */
     fetch?: typeof globalThis.fetch;
 }
@@ -49,6 +44,26 @@ export interface SkeletonAssets {
      */
     dispose(): void;
 }
+/**
+ * Reads one skeleton JSON export against already-loaded atlas assets — the
+ * second step of the shared-atlas path.
+ *
+ * ```ts
+ * const shared = await loadAtlasAssets({ atlasUrl: '/spineboy/spineboy.atlas' });
+ * const [ess, pro] = await Promise.all([
+ *   loadSkeletonJson(shared, '/spineboy/spineboy-ess.json'),
+ *   loadSkeletonJson(shared, '/spineboy/spineboy-pro.json'),
+ * ]);
+ * ```
+ *
+ * `assets` needs nothing but a parsed atlas with its page textures attached,
+ * so a caller on the low-level path can pass its own `{ atlas }`. Ownership
+ * stays with the caller: this never disposes `assets`, whether it succeeds or
+ * throws, because the same assets normally back several skeletons.
+ */
+export declare function loadSkeletonJson(assets: {
+    atlas: TextureAtlas;
+}, skeletonUrl: string, options?: LoadSkeletonJsonOptions): Promise<SkeletonData>;
 /**
  * Loads everything the renderer needs from two URLs.
  *
@@ -62,8 +77,12 @@ export interface SkeletonAssets {
  * // …later: renderer.dispose(); assets.dispose();
  * ```
  *
- * Page images load in parallel. If anything fails part-way, no blob URL is
- * left behind.
+ * One atlas, one skeleton. Several skeletons sharing one atlas is the two-step
+ * path instead (`loadAtlasAssets` + `loadSkeletonJson`), which this is built
+ * on — calling this once per skeleton would refetch and re-unpack the atlas.
+ *
+ * Page images load in parallel, and the skeleton export downloads alongside
+ * the atlas half. If anything fails part-way, no blob URL is left behind.
  */
 export declare function loadSkeletonAssets(options: LoadSkeletonAssetsOptions): Promise<SkeletonAssets>;
 //# sourceMappingURL=loadSkeletonAssets.d.ts.map

package/dist/loadSkeletonAssets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadSkeletonAssets.d.ts","sourceRoot":"","sources":["../src/loadSkeletonAssets.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EAEjB,YAAY,EACb,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAc,KAAK,WAAW,EAAgC,MAAM,cAAc,CAAC;AAE1F;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,yBAAyB;IACxC,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7D,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,IAAI,EAAE,YAAY,CAAC;IACnB,+EAA+E;IAC/E,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,gDAAgD;IAChD,KAAK,EAAE,YAAY,CAAC;IACpB;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAsBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,cAAc,CAAC,CA4CzB"}
+{"version":3,"file":"loadSkeletonAssets.d.ts","sourceRoot":"","sources":["../src/loadSkeletonAssets.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EAEjB,YAAY,EACb,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAa,KAAK,sBAAsB,EAAmB,MAAM,sBAAsB,CAAC;AAE/F;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,yBAA0B,SAAQ,sBAAsB;IACvE,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,IAAI,EAAE,YAAY,CAAC;IACnB,+EAA+E;IAC/E,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,gDAAgD;IAChD,KAAK,EAAE,YAAY,CAAC;IACpB;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAQD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,EAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CAIvB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,cAAc,CAAC,CA6BzB"}

package/dist/loadSkeletonAssets.js

@@ -1,23 +1,32 @@
-import { AtlasAttachmentLoader, SkeletonJson, TextureAtlas, } from '@esotericsoftware/spine-core';
-import { DomTexture, revokeRegions, unpackRegions } from './DomTexture';
-function resolveAgainstAtlas(pageName, atlasUrl) {
-    return new URL(pageName, new URL(atlasUrl, document.baseURI)).href;
+import { AtlasAttachmentLoader, SkeletonJson, } from '@esotericsoftware/spine-core';
+import { fetchText, loadAtlasAssets } from './loadAtlasAssets.js';
+function readSkeletonData(atlas, text, scale) {
+    const json = new SkeletonJson(new AtlasAttachmentLoader(atlas));
+    if (scale !== undefined)
+        json.scale = scale;
+    return json.readSkeletonData(text);
 }
-async function fetchText(fetchImpl, url) {
-    const response = await fetchImpl(url);
-    if (!response.ok)
-        throw new Error(`Failed to fetch ${url}: ${response.status}`);
-    return response.text();
-}
-function loadImage(url, crossOrigin) {
-    return new Promise((resolve, reject) => {
-        const image = new Image();
-        if (crossOrigin !== undefined)
-            image.crossOrigin = crossOrigin;
-        image.onload = () => resolve(image);
-        image.onerror = () => reject(new Error(`Failed to load atlas page image: ${url}`));
-        image.src = url;
-    });
+/**
+ * Reads one skeleton JSON export against already-loaded atlas assets — the
+ * second step of the shared-atlas path.
+ *
+ * ```ts
+ * const shared = await loadAtlasAssets({ atlasUrl: '/spineboy/spineboy.atlas' });
+ * const [ess, pro] = await Promise.all([
+ *   loadSkeletonJson(shared, '/spineboy/spineboy-ess.json'),
+ *   loadSkeletonJson(shared, '/spineboy/spineboy-pro.json'),
+ * ]);
+ * ```
+ *
+ * `assets` needs nothing but a parsed atlas with its page textures attached,
+ * so a caller on the low-level path can pass its own `{ atlas }`. Ownership
+ * stays with the caller: this never disposes `assets`, whether it succeeds or
+ * throws, because the same assets normally back several skeletons.
+ */
+export async function loadSkeletonJson(assets, skeletonUrl, options = {}) {
+    const fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
+    const text = await fetchText(fetchImpl, skeletonUrl);
+    return readSkeletonData(assets.atlas, text, options.scale);
 }
 /**
  * Loads everything the renderer needs from two URLs.
@@ -32,48 +41,38 @@ function loadImage(url, crossOrigin) {
  * // …later: renderer.dispose(); assets.dispose();
  * ```
  *
- * Page images load in parallel. If anything fails part-way, no blob URL is
- * left behind.
+ * One atlas, one skeleton. Several skeletons sharing one atlas is the two-step
+ * path instead (`loadAtlasAssets` + `loadSkeletonJson`), which this is built
+ * on — calling this once per skeleton would refetch and re-unpack the atlas.
+ *
+ * Page images load in parallel, and the skeleton export downloads alongside
+ * the atlas half. If anything fails part-way, no blob URL is left behind.
  */
 export async function loadSkeletonAssets(options) {
-    const { atlasUrl, skeletonUrl, crossOrigin, scale } = options;
     const fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
-    const resolvePage = options.resolvePage ?? resolveAgainstAtlas;
-    const [atlasText, skeletonText] = await Promise.all([
-        fetchText(fetchImpl, atlasUrl),
-        fetchText(fetchImpl, skeletonUrl),
-    ]);
-    const atlas = new TextureAtlas(atlasText);
-    const pageImages = new Map();
-    await Promise.all(atlas.pages.map(async (page) => {
-        const image = await loadImage(resolvePage(page.name, atlasUrl), crossOrigin);
-        page.setTexture(new DomTexture(image));
-        pageImages.set(page.name, image);
-    }));
-    const regionImages = await unpackRegions(atlas, pageImages);
+    // Started before the atlas half is awaited, so the two downloads overlap.
+    const skeletonText = fetchText(fetchImpl, options.skeletonUrl);
+    // The atlas half can throw first and leave this rejection unobserved until
+    // the catch below, which is an unhandled rejection in between. A no-op
+    // handler marks it observed; the value/error is still read from the promise.
+    skeletonText.catch(() => { });
+    const assets = await loadAtlasAssets(options);
     let data;
     try {
-        const json = new SkeletonJson(new AtlasAttachmentLoader(atlas));
-        if (scale !== undefined)
-            json.scale = scale;
-        data = json.readSkeletonData(skeletonText);
+        data = readSkeletonData(assets.atlas, await skeletonText, options.scale);
     }
     catch (error) {
-        // Reading the skeleton is the one step after the regions exist, so it is
-        // the one step that could strand them.
-        revokeRegions(regionImages);
+        // The regions exist by now, so the skeleton half is the one step that
+        // could strand them — whether the fetch failed or the read did.
+        assets.dispose();
         throw error;
     }
-    let disposed = false;
     return {
-        atlas,
+        atlas: assets.atlas,
         data,
-        regionImages,
+        regionImages: assets.regionImages,
         dispose() {
-            if (disposed)
-                return;
-            disposed = true;
-            revokeRegions(regionImages);
+            assets.dispose();
         },
     };
 }

package/dist/loadSkeletonAssets.js.map

@@ -1 +1 @@
-{"version":3,"file":"loadSkeletonAssets.js","sourceRoot":"","sources":["../src/loadSkeletonAssets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loadSkeletonAssets.js","sourceRoot":"","sources":["../src/loadSkeletonAssets.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAErB,YAAY,GAEb,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,SAAS,EAA+B,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAiD/F,SAAS,gBAAgB,CAAC,KAAmB,EAAE,IAAY,EAAE,KAAc;IACzE,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,IAAI,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,IAAI,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAC5C,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA+B,EAC/B,WAAmB,EACnB,UAAmC,EAAE;IAErC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACrD,OAAO,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAkC;IAElC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAErE,0EAA0E;IAC1E,MAAM,YAAY,GAAG,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/D,2EAA2E;IAC3E,uEAAuE;IACvE,6EAA6E;IAC7E,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAE7B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,IAAkB,CAAC;IACvB,IAAI,CAAC;QACH,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sEAAsE;QACtE,gEAAgE;QAChE,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI;QACJ,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,OAAO;YACL,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}