rig-play 0.8.0 → 1.0.0

package/dist/loadSkeletonAssets.d.ts

@@ -1,88 +0,0 @@
-import { type SkeletonData, TextureAtlas } from '@esotericsoftware/spine-core';
-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.
- *
- * It exists because every consumer was copying the same twenty lines. It is
- * 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: 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 extends LoadAtlasAssetsOptions {
-    /** URL of the skeleton JSON (.json) export. */
-    skeletonUrl: string;
-    /** SkeletonJson.scale — scales the skeleton as it is read. */
-    scale?: number;
-}
-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;
-}
-export interface SkeletonAssets {
-    /** Parsed skeleton data — construct one `new Skeleton(data)` per instance. */
-    data: SkeletonData;
-    /** Unpacked per-region bitmaps, ready for `new SpineHtmlRenderer(root, …)`. */
-    regionImages: Map<string, RegionImage>;
-    /** The parsed atlas, page textures attached. */
-    atlas: TextureAtlas;
-    /**
-     * 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;
-}
-/**
- * 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.
- *
- * ```ts
- * const assets = await loadSkeletonAssets({
- *   atlasUrl: '/spineboy/spineboy.atlas',
- *   skeletonUrl: '/spineboy/spineboy-pro.json',
- * });
- * const skeleton = new Skeleton(assets.data);
- * const renderer = new SpineHtmlRenderer(root, assets.regionImages);
- * // …later: renderer.dispose(); assets.dispose();
- * ```
- *
- * 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 +0,0 @@
-{"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,79 +0,0 @@
-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);
-}
-/**
- * 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.
- *
- * ```ts
- * const assets = await loadSkeletonAssets({
- *   atlasUrl: '/spineboy/spineboy.atlas',
- *   skeletonUrl: '/spineboy/spineboy-pro.json',
- * });
- * const skeleton = new Skeleton(assets.data);
- * const renderer = new SpineHtmlRenderer(root, assets.regionImages);
- * // …later: renderer.dispose(); assets.dispose();
- * ```
- *
- * 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 fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
-    // 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 {
-        data = readSkeletonData(assets.atlas, await skeletonText, options.scale);
-    }
-    catch (error) {
-        // 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;
-    }
-    return {
-        atlas: assets.atlas,
-        data,
-        regionImages: assets.regionImages,
-        dispose() {
-            assets.dispose();
-        },
-    };
-}
-//# sourceMappingURL=loadSkeletonAssets.js.map

package/dist/loadSkeletonAssets.js.map

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