@oidoid/void 0.1.0-8 → 0.1.0

package/dist/src/utils/fetch-util.d.ts

@@ -1,3 +1,4 @@
 export declare function fetchAudio(url: string): Promise<ArrayBuffer>;
-export declare function fetchImage(url: string): Promise<HTMLImageElement>;
+export declare function fetchImage(uri: string): Promise<HTMLImageElement>;
 export declare function loadImage(img: HTMLImageElement): Promise<HTMLImageElement>;
+//# sourceMappingURL=fetch-util.d.ts.map

package/dist/src/utils/fetch-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-util.d.ts","sourceRoot":"","sources":["../../../src/utils/fetch-util.ts"],"names":[],"mappings":"AAAA,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CASlE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAKjE;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAM3B"}

package/dist/src/utils/fetch-util.js

@@ -8,10 +8,10 @@ export async function fetchAudio(url) {
         throw Error(`bad fetch response type ${type} for ${url}`);
     return await rsp.arrayBuffer();
 }
-export function fetchImage(url) {
+export function fetchImage(uri) {
     const img = new Image();
     const promise = loadImage(img);
-    img.src = url;
+    img.src = uri;
     return promise;
 }
 export async function loadImage(img) {

package/dist/src/utils/math.d.ts

@@ -4,3 +4,4 @@ export declare function closeTo(lhs: number, rhs: number, tolerance: number): bo
 export declare function lerp(start: number, end: number, ratio: number): number;
 /** returns positive modulo. */
 export declare function mod(dividend: number, divisor: number): number;
+//# sourceMappingURL=math.d.ts.map

package/dist/src/utils/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../src/utils/math.ts"],"names":[],"mappings":"AACA,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE5E;AAGD,8CAA8C;AAC9C,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtE;AAGD,+BAA+B;AAC/B,wBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/src/utils/math.js

@@ -10,7 +10,7 @@ export function closeTo(lhs, rhs, tolerance) {
 export function lerp(start, end, ratio) {
     return start + (end - start) * ratio;
 }
-// to-do: test.
+// to-do: test. mod(-1.3, 1) -> 0.7
 /** returns positive modulo. */
 export function mod(dividend, divisor) {
     return ((dividend % divisor) + divisor) % divisor;

package/dist/src/utils/math.js.map

@@ -1 +1 @@
-{"version":3,"file":"math.js","sourceRoot":"","sources":["../../../src/utils/math.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,MAAM,UAAU,KAAK,CAAC,GAAW,EAAE,GAAW,EAAE,GAAW;IACzD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,GAAW,EAAE,SAAiB;IACjE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,SAAS,CAAA;AACzC,CAAC;AAED,qBAAqB;AACrB,8CAA8C;AAC9C,MAAM,UAAU,IAAI,CAAC,KAAa,EAAE,GAAW,EAAE,KAAa;IAC5D,OAAO,KAAK,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,KAAK,CAAA;AACtC,CAAC;AAED,eAAe;AACf,+BAA+B;AAC/B,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,OAAe;IACnD,OAAO,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,OAAO,CAAA;AACnD,CAAC"}
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../../src/utils/math.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,MAAM,UAAU,KAAK,CAAC,GAAW,EAAE,GAAW,EAAE,GAAW;IACzD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,GAAW,EAAE,SAAiB;IACjE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,SAAS,CAAA;AACzC,CAAC;AAED,qBAAqB;AACrB,8CAA8C;AAC9C,MAAM,UAAU,IAAI,CAAC,KAAa,EAAE,GAAW,EAAE,KAAa;IAC5D,OAAO,KAAK,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,KAAK,CAAA;AACtC,CAAC;AAED,mCAAmC;AACnC,+BAA+B;AAC/B,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,OAAe;IACnD,OAAO,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,OAAO,CAAA;AACnD,CAAC"}

package/dist/src/utils/obj-util.d.ts

@@ -0,0 +1,7 @@
+export declare function assertRecord<T extends {
+    [k: PropertyKey]: unknown;
+}>(v: unknown): asserts v is T;
+export declare function isRecord<T extends {
+    [k: PropertyKey]: unknown;
+}>(v: unknown): v is T;
+//# sourceMappingURL=obj-util.d.ts.map

package/dist/src/utils/obj-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obj-util.d.ts","sourceRoot":"","sources":["../../../src/utils/obj-util.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAC,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAA;CAAC,EAChE,CAAC,EAAE,OAAO,GACT,OAAO,CAAC,CAAC,IAAI,CAAC,CAEhB;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS;IAAC,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAA;CAAC,EAC5D,CAAC,EAAE,OAAO,GACT,CAAC,IAAI,CAAC,CAER"}

package/dist/src/utils/obj-util.js

@@ -0,0 +1,8 @@
+export function assertRecord(v) {
+    if (!isRecord(v))
+        throw new Error('not a record');
+}
+export function isRecord(v) {
+    return v != null && !Array.isArray(v) && typeof v === 'object';
+}
+//# sourceMappingURL=obj-util.js.map

package/dist/src/utils/obj-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obj-util.js","sourceRoot":"","sources":["../../../src/utils/obj-util.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAC1B,CAAU;IAEV,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,CAAU;IAEV,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAA;AAChE,CAAC"}

package/dist/src/utils/str-util.d.ts

@@ -0,0 +1,2 @@
+export declare function uncapitalize<Str extends string>(str: Str): Uncapitalize<Str>;
+//# sourceMappingURL=str-util.d.ts.map

package/dist/src/utils/str-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"str-util.d.ts","sourceRoot":"","sources":["../../../src/utils/str-util.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAG5E"}

package/dist/src/utils/str-util.js

@@ -0,0 +1,6 @@
+export function uncapitalize(str) {
+    if (!str[0])
+        return str;
+    return `${str[0].toLocaleLowerCase()}${str.slice(1)}`;
+}
+//# sourceMappingURL=str-util.js.map

package/dist/src/utils/str-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"str-util.js","sourceRoot":"","sources":["../../../src/utils/str-util.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAqB,GAAQ;IACvD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAAE,OAAO,GAAwB,CAAA;IAC5C,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAuB,CAAA;AAC5E,CAAC"}

package/dist/src/utils/vibrate.d.ts

@@ -1 +1,2 @@
 export declare function vibrate(...pattern: number[]): void;
+//# sourceMappingURL=vibrate.d.ts.map

package/dist/src/utils/vibrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibrate.d.ts","sourceRoot":"","sources":["../../../src/utils/vibrate.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAElD"}

package/dist/src/void.d.ts

@@ -1,48 +1,60 @@
+import type { LoaderEnt } from './ents/loader.ts';
+import type { Sys } from './ents/sys.ts';
 import { Zoo } from './ents/zoo.ts';
-import type { Atlas, AtlasJSON, TagFormat } from './graphics/atlas.ts';
+import type { Atlas } from './graphics/atlas.ts';
 import { Cam } from './graphics/cam.ts';
 import { Renderer } from './graphics/renderer.ts';
-import { Sprite } from './graphics/sprite.ts';
-import { type DefaultButton, Input } from './input/input.ts';
+import type { Sprite } from './graphics/sprite.ts';
+import { Input } from './input/input.ts';
 import { Looper } from './looper.ts';
-import { Pool, type PoolOpts } from './mem/pool.ts';
-import type { WH } from './types/geo.ts';
-import type { Millis } from './types/time.ts';
-export type VoidOpts<out Tag extends TagFormat> = {
-    preloadAtlas?: {
-        image: HTMLImageElement;
-        json: AtlasJSON;
-    } | undefined;
-    backgroundRGBA?: number;
-    canvas?: HTMLCanvasElement | undefined;
-    minWH?: WH | undefined;
-    input?: 'Custom' | 'Default' | undefined;
-    mode?: 'Int' | 'Fraction' | undefined;
-    poll?: {
-        delay?: (() => Millis) | undefined;
-        period: Millis;
-    } | undefined;
-    sprites?: Partial<Omit<PoolOpts<Sprite<Tag>>, 'alloc' | 'allocBytes'>> | undefined;
+import type { PoolOpts } from './mem/pool.ts';
+import type { PoolMap } from './mem/pool-map.ts';
+import { Random } from './random/random.ts';
+import type { GameConfig } from './types/game-config.ts';
+import type { Millis, Secs } from './types/time.ts';
+export type VoidOpts = {
+    canvas?: HTMLCanvasElement | null;
+    config: GameConfig;
+    description?: string;
+    loader: LoaderEnt;
+    loaderSys: Sys;
+    preloadAtlas?: HTMLImageElement | null;
+    random?: Random;
+    sprites?: Partial<Omit<PoolOpts<Sprite>, 'alloc' | 'allocBytes'>>;
 };
-export declare class Void<out Tag extends TagFormat, Button extends string = DefaultButton> {
+export declare class Void {
     #private;
     readonly cam: Cam;
     readonly canvas: HTMLCanvasElement;
-    readonly input: Input<Button>;
+    readonly input: Input;
+    readonly looper: Looper;
+    readonly pool: PoolMap;
     readonly preload: Atlas;
+    readonly random: Random;
     readonly renderer: Renderer;
-    readonly sprites: Pool<Sprite<Tag>>;
-    readonly zoo: Zoo<Tag>;
-    readonly looper: Looper;
-    constructor(opts: Readonly<VoidOpts<Tag>>);
-    onAllocSprite(pool: Pool<Sprite<Tag>>): Sprite<Tag>;
+    /** delta since frame request. */
+    readonly tick: {
+        ms: Millis;
+        s: Secs;
+    };
+    readonly zoo: Zoo;
+    constructor(opts: Readonly<VoidOpts>);
+    alloc(k?: keyof PoolMap): Sprite;
+    get backgroundRGBA(): number;
+    /**
+     * invalid state only impacts drawing in the current frame not requesting a
+     * new frame.
+     */
+    get invalid(): boolean;
+    set invalid(invalid: true);
     onEvent(): void;
     /** update input, update canvas, update cam, update world, then render. */
     onFrame(millis: Millis): void;
-    onLoop(millis: Millis): void;
     onPoll(): void;
     onResize(): void;
+    setPoller(period: Millis, delay?: () => Millis): void;
     register(op: 'add' | 'remove'): Promise<void>;
-    requestFrame(force?: 'Force' | undefined): void;
+    requestFrame(force?: 'Force'): void;
     [Symbol.asyncDispose](): Promise<void>;
 }
+//# sourceMappingURL=void.d.ts.map

package/dist/src/void.d.ts.map

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

package/dist/src/void.js

@@ -1,12 +1,14 @@
 import { Zoo } from "./ents/zoo.js";
 import { parseAtlas } from "./graphics/atlas-parser.js";
 import { Cam } from "./graphics/cam.js";
+import { PixelRatioObserver } from "./graphics/pixel-ratio-observer.js";
 import { Renderer } from "./graphics/renderer.js";
-import { drawableBytes, Sprite } from "./graphics/sprite.js";
 import { Input } from "./input/input.js";
 import { Looper } from "./looper.js";
-import { Pool } from "./mem/pool.js";
+import { SpritePool } from "./mem/sprite-pool.js";
+import { Random } from "./random/random.js";
 import { initCanvas } from "./utils/canvas-util.js";
+import { parseComputedColor } from "./utils/color-util.js";
 import { DelayInterval } from "./utils/delay-interval.js";
 import { initBody, initMetaViewport } from "./utils/dom-util.js";
 import { loadImage } from "./utils/fetch-util.js";
@@ -14,82 +16,124 @@ export class Void {
     cam = new Cam();
     canvas;
     input;
+    looper = new Looper();
+    pool;
     preload;
+    random;
     renderer;
-    sprites;
+    /** delta since frame request. */
+    tick = { ms: 0, s: 0 };
     zoo = new Zoo();
-    looper = new Looper();
-    #poll;
+    #backgroundRGBA;
+    #invalid = false;
+    #pixelRatioObserver = new PixelRatioObserver();
+    #poller;
     #preloadAtlasImage;
-    // may trigger an initial force update.
+    #registered = false;
+    /** may trigger an initial force update. */
     #resizeObserver = new ResizeObserver(() => this.onResize());
     constructor(opts) {
-        if (opts.poll != null)
-            this.#poll = new DelayInterval(opts.poll.delay ?? (() => 0), opts.poll.period, () => this.onPoll());
-        initMetaViewport();
-        this.canvas = initCanvas(opts.canvas, opts.mode ?? 'Int');
-        initBody(this.canvas, opts.backgroundRGBA ?? 0x000000ff);
-        if (opts.minWH)
-            this.cam.minWH = opts.minWH;
-        this.cam.mode = opts.mode ?? 'Int';
+        initMetaViewport(opts.description);
+        this.canvas = initCanvas(opts.canvas, opts.config.init.mode);
+        if (!this.canvas.parentElement)
+            throw Error('no canvas parent');
+        this.#backgroundRGBA =
+            opts.config.init.background ??
+                parseComputedColor(getComputedStyle(this.canvas.parentElement).backgroundColor);
+        if (!opts.canvas)
+            initBody(this.#backgroundRGBA);
+        this.cam.minWH = opts.config.init.minWH;
+        this.cam.mode = opts.config.init.mode;
         this.cam.update(this.canvas);
+        this.random = opts.random ?? new Random(Date.now());
         this.input = new Input(this.cam, this.canvas);
-        if (opts.input !== 'Custom')
+        if (opts.config.init.input !== 'Custom')
             this.input.mapDefault();
         this.input.onEvent = () => this.onEvent();
-        if (opts.preloadAtlas)
-            this.#preloadAtlasImage = opts.preloadAtlas.image;
-        this.preload = opts.preloadAtlas
-            ? parseAtlas(opts.preloadAtlas.json)
+        this.#pixelRatioObserver.onChange = () => this.onResize();
+        this.#preloadAtlasImage = opts.preloadAtlas ?? undefined;
+        if (!!this.#preloadAtlasImage !== !!opts.config.atlas)
+            throw Error('atlas misconfigured');
+        this.preload = opts.config.atlas
+            ? parseAtlas(opts.config.atlas)
             : { anim: {}, celXYWH: [], tags: [] };
         this.renderer = new Renderer(this.preload ?? {}, this.canvas, this.looper);
-        this.sprites = new Pool({
-            alloc: pool => this.onAllocSprite(pool),
-            allocBytes: drawableBytes,
-            minPages: opts.sprites?.minPages ?? 3,
-            pageBlocks: opts.sprites?.pageBlocks ?? 1000
-        });
+        this.pool = {
+            default: SpritePool({
+                atlas: this.preload,
+                looper: this.looper,
+                minPages: opts.sprites?.minPages ?? 3,
+                pageBlocks: opts.sprites?.pageBlocks ?? 1000
+            })
+        };
         this.looper.onFrame = millis => this.onFrame(millis);
+        this.zoo.addSystem({ loader: opts.loaderSys });
+        this.zoo.add(opts.loader);
+    }
+    alloc(k = 'default') {
+        return this.pool[k].alloc();
     }
-    onAllocSprite(pool) {
-        return new Sprite(pool, 0, this.preload, this.looper);
+    get backgroundRGBA() {
+        return this.#backgroundRGBA;
+    }
+    /**
+     * invalid state only impacts drawing in the current frame not requesting a
+     * new frame.
+     */
+    get invalid() {
+        return (this.zoo.invalid ||
+            this.cam.invalid ||
+            this.renderer.invalid ||
+            this.#invalid);
+    }
+    set invalid(invalid) {
+        this.#invalid = invalid;
     }
     onEvent() {
         this.requestFrame('Force');
     }
     /** update input, update canvas, update cam, update world, then render. */
     onFrame(millis) {
+        this.tick.ms = millis;
+        this.tick.s = (millis / 1000);
         if (document.hidden)
             return;
         this.input.update(millis);
-        this.requestFrame(); // request frame before in case loop cancels.
-        this.onLoop(millis);
+        this.requestFrame(); // request frame before in case update cancels.
+        this.#invalid = false;
+        this.zoo.update(this);
         this.cam.postupdate();
     }
-    // biome-ignore lint/correctness/noUnusedFunctionParameters:;
-    onLoop(millis) { }
     onPoll() {
         this.requestFrame('Force');
     }
     onResize() {
         this.requestFrame('Force'); // force cam reeval.
     }
+    // to-do: clear.
+    setPoller(period, delay) {
+        if (this.#poller)
+            this.#poller.register('remove');
+        this.#poller = new DelayInterval(delay ?? (() => 0), period, () => this.onPoll());
+        if (this.#registered)
+            this.#poller.register('add');
+    }
     async register(op) {
         this.input.register(op);
         this.renderer.register(op);
         this.looper.register(op);
-        if (!this.canvas.parentElement)
-            throw Error('no canvas parent');
         if (op === 'add')
             this.#resizeObserver.observe(this.canvas.parentElement);
         else
             this.#resizeObserver.unobserve(this.canvas.parentElement);
+        this.#pixelRatioObserver.register(op);
         if (op === 'add')
             this.looper.requestFrame();
-        this.#poll?.register(op);
+        this.#poller?.register(op);
         if (this.#preloadAtlasImage)
             await loadImage(this.#preloadAtlasImage);
         this.renderer.load(this.#preloadAtlasImage);
+        this.#registered = op === 'add';
     }
     requestFrame(force) {
         if (force || this.renderer.always || this.input.anyOn || this.input.gamepad)

package/dist/src/void.js.map

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

package/dist/tools/atlas-pack/aseprite-json.d.ts

@@ -0,0 +1,5 @@
+declare module '*.aseprite.json' {
+    const json: import('./aseprite.ts').Aseprite;
+    export default json;
+}
+//# sourceMappingURL=aseprite-json.d.ts.map

package/dist/tools/atlas-pack/aseprite-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aseprite-json.d.ts","sourceRoot":"","sources":["../../../tools/atlas-pack/aseprite-json.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,iBAAiB,CAAC;IAC/B,MAAM,IAAI,EAAE,OAAO,eAAe,EAAE,QAAQ,CAAA;IAC5C,eAAe,IAAI,CAAA;CACpB"}

package/dist/tools/atlas-pack/aseprite-json.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=aseprite-json.js.map

package/dist/tools/atlas-pack/aseprite-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aseprite-json.js","sourceRoot":"","sources":["../../../tools/atlas-pack/aseprite-json.ts"],"names":[],"mappings":""}

package/dist/tools/atlas-pack/aseprite.d.ts

@@ -1,47 +1,73 @@
-import type { TagFormat } from '../../src/graphics/atlas.ts';
-import type { Box, WH } from '../../src/types/geo.ts';
+import type * as V from '../../src/index.ts';
 /** https://github.com/aseprite/aseprite/blob/master/docs/ase-file-specs.md */
 export type Aseprite = {
-    meta: AsepriteMeta;
-    frames: AsepriteFrameMap;
+    meta: Meta;
+    frames: FrameMap;
 };
-export type AsepriteFrameMap = {
-    [tag: AsepriteFrameTag]: AsepriteFrame;
+/** eg, `#000000ff`. */
+export type Color = `#${string}`;
+export type FrameMap = {
+    [tag: FrameTag]: Frame;
 };
-export type AsepriteMeta = {
-    /** `--list-tags`. */
-    frameTags: AsepriteTagSpan[];
-    size: WH;
-    /** `--list-slices`. */
-    slices: AsepriteSlice[];
+export type Key = {
+    /** slice dimensions. */
+    bounds: V.Box;
+    /** inclusive `Frame` start offset. */
+    frame: number;
+};
+export type Meta = {
+    /** e.g., `http://www.aseprite.org/`. */
+    app: string;
+    /** e.g., `1.3.15.4-x64`. */
+    version: string;
+    /** output basename. e.g., `atlas.png`. */
+    image: string;
+    /** e.g., `RGBA8888` or `I8`. */
+    format: string;
+    /** output dimensions (`--sheet-pack`). */
+    size: V.WH;
+    /** e.g., `1`. */
+    scale: string;
+    /** all `TagSpan`s for all files packed (`--list-tags`). */
+    frameTags: TagSpan[];
+    /** all slices for all files packed (`--list-slices`). */
+    slices: Slice[];
 };
 /** `--filename-format='{title}--{tag}--{frame}'`. */
-export type AsepriteFrameTag = `${TagFormat}--${bigint}`;
-export type AsepriteFrame = {
-    /** positive animation length in milliseconds. */
+export type FrameTag = `${V.Tag}--${bigint}`;
+/** a cel. */
+export type Frame = {
+    /** animation length in milliseconds. */
     duration: number;
-    /** bounds including padding. */
-    frame: Box;
+    /** bounds including padding (`--inner-padding=n`). */
+    frame: V.Box;
+    rotated: boolean;
+    trimmed: boolean;
+    /** bounds not including padding. x and y are always zero. */
+    spriteSourceSize: V.Box;
     /** WH without padding. */
-    sourceSize: WH;
+    sourceSize: V.WH;
+};
+export type Slice = {
+    /** `#ff0000ff` is hitbox, `#00ff00ff` is hurtbox, `#0000ffff` is both. */
+    color: Color;
+    name: V.Tag;
+    keys: Key[];
 };
-export type AsepriteTagSpan = {
-    direction: AsepriteDirection | string;
-    name: TagFormat | string;
+/** a label and animation behavior. references `Frame`s to form an animation. */
+export type TagSpan = {
+    color: Color;
+    name: V.Tag;
+    /** inclusive starting Frame index. */
     from: number;
     /** inclusive ending index, possibly equal to from. */
     to: number;
+    direction: Direction;
+    /** number of times to replay the animation. undefined is infinite. */
+    repeat?: `${bigint}`;
 };
-export type AsepriteSlice = {
-    /** '#ff0000ff' is hitbox, '#00ff00ff' is hurtbox, '#0000ffff is both. */
-    color: string;
-    name: TagFormat | string;
-    keys: {
-        bounds: Box;
-    }[];
-};
-export type AsepriteDirection = (typeof AsepriteDirection)[keyof typeof AsepriteDirection];
-export declare const AsepriteDirection: {
+export type Direction = (typeof Direction)[keyof typeof Direction];
+export declare const Direction: {
     /** animate from start to end; when looping, return to start. */
     readonly Forward: "forward";
     /** animate from end to start; when looping, return to end. */
@@ -56,3 +82,4 @@ export declare const AsepriteDirection: {
     /** like pingpong but start from end - 1 or start, whichever is greater. */
     readonly PingPongReverse: "pingpong_reverse";
 };
+//# sourceMappingURL=aseprite.d.ts.map

package/dist/tools/atlas-pack/aseprite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aseprite.d.ts","sourceRoot":"","sources":["../../../tools/atlas-pack/aseprite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,CAAC,MAAM,oBAAoB,CAAA;AAE5C,8EAA8E;AAC9E,MAAM,MAAM,QAAQ,GAAG;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAC,CAAA;AAErD,uBAAuB;AACvB,MAAM,MAAM,KAAK,GAAG,IAAI,MAAM,EAAE,CAAA;AAEhC,MAAM,MAAM,QAAQ,GAAG;IAAC,CAAC,GAAG,EAAE,QAAQ,GAAG,KAAK,CAAA;CAAC,CAAA;AAE/C,MAAM,MAAM,GAAG,GAAG;IAChB,wBAAwB;IACxB,MAAM,EAAE,CAAC,CAAC,GAAG,CAAA;IACb,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,IAAI,GAAG;IACjB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAA;IACX,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,IAAI,EAAE,CAAC,CAAC,EAAE,CAAA;IACV,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,2DAA2D;IAC3D,SAAS,EAAE,OAAO,EAAE,CAAA;IACpB,yDAAyD;IACzD,MAAM,EAAE,KAAK,EAAE,CAAA;CAChB,CAAA;AAED,qDAAqD;AACrD,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,MAAM,EAAE,CAAA;AAE5C,aAAa;AACb,MAAM,MAAM,KAAK,GAAG;IAClB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAA;IAChB,sDAAsD;IACtD,KAAK,EAAE,CAAC,CAAC,GAAG,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,6DAA6D;IAC7D,gBAAgB,EAAE,CAAC,CAAC,GAAG,CAAA;IACvB,0BAA0B;IAC1B,UAAU,EAAE,CAAC,CAAC,EAAE,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,KAAK,GAAG;IAClB,0EAA0E;IAC1E,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAA;IACX,IAAI,EAAE,GAAG,EAAE,CAAA;CACZ,CAAA;AAED,gFAAgF;AAChF,MAAM,MAAM,OAAO,GAAG;IACpB,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAA;IACX,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,SAAS,CAAA;IACpB,sEAAsE;IACtE,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA;AAClE,eAAO,MAAM,SAAS;IACpB,gEAAgE;;IAEhE,8DAA8D;;IAE9D;;;;;OAKG;;IAEH,2EAA2E;;CAEnE,CAAA"}

package/dist/tools/atlas-pack/aseprite.js

@@ -1,4 +1,4 @@
-export const AsepriteDirection = {
+export const Direction = {
     /** animate from start to end; when looping, return to start. */
     Forward: 'forward',
     /** animate from end to start; when looping, return to end. */

package/dist/tools/atlas-pack/aseprite.js.map

@@ -1 +1 @@
-{"version":3,"file":"aseprite.js","sourceRoot":"","sources":["../../../tools/atlas-pack/aseprite.ts"],"names":[],"mappings":"AA6CA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,gEAAgE;IAChE,OAAO,EAAE,SAAS;IAClB,8DAA8D;IAC9D,OAAO,EAAE,SAAS;IAClB;;;;;OAKG;IACH,QAAQ,EAAE,UAAU;IACpB,2EAA2E;IAC3E,eAAe,EAAE,kBAAkB;CAC3B,CAAA"}
+{"version":3,"file":"aseprite.js","sourceRoot":"","sources":["../../../tools/atlas-pack/aseprite.ts"],"names":[],"mappings":"AA0EA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,gEAAgE;IAChE,OAAO,EAAE,SAAS;IAClB,8DAA8D;IAC9D,OAAO,EAAE,SAAS;IAClB;;;;;OAKG;IACH,QAAQ,EAAE,UAAU;IACpB,2EAA2E;IAC3E,eAAe,EAAE,kBAAkB;CAC3B,CAAA"}

package/dist/tools/atlas-pack/atlas-json-parser.d.ts

@@ -1,9 +1,9 @@
-import { type Anim, type AtlasJSON } from '../../src/graphics/atlas.ts';
-import { type Box, type XY } from '../../src/types/geo.ts';
-import { type Aseprite, type AsepriteFrame, type AsepriteFrameMap, type AsepriteSlice, type AsepriteTagSpan } from './aseprite.ts';
-export declare function parseAtlasJSON(ase: Readonly<Aseprite>): AtlasJSON;
+import * as V from '../../src/index.ts';
+import * as ase from './aseprite.ts';
+import './aseprite-json.ts';
+export declare function parseAtlasJSON(json: Readonly<ase.Aseprite>): V.AtlasJSON;
 /** @internal */
-export declare function parseAnim(id: number, span: Readonly<AsepriteTagSpan>, map: Readonly<AsepriteFrameMap>, slices: readonly Readonly<AsepriteSlice>[]): Anim;
+export declare function parseAnim(id: number, span: Readonly<ase.TagSpan>, map: Readonly<ase.FrameMap>, slices: readonly Readonly<ase.Slice>[]): V.Anim;
 /**
  * every frame is guaranteed to be present for at least `celMillis`. cels are
  * duplicated until cel duration is at least met. cels are unpacked until a full
@@ -11,11 +11,12 @@ export declare function parseAnim(id: number, span: Readonly<AsepriteTagSpan>, m
  * or uneven periods.
  * @internal
  */
-export declare function parseAnimFrames(span: AsepriteTagSpan, map: AsepriteFrameMap): AsepriteFrame[];
+export declare function parseAnimFrames(span: ase.TagSpan, map: ase.FrameMap): ase.Frame[];
 /** @internal */
-export declare function parseCel(frame: Readonly<AsepriteFrame>): XY;
+export declare function parseCel(frame: Readonly<ase.Frame>): V.XY;
 /** @internal */
-export declare function parseHitboxes(span: Readonly<AsepriteTagSpan>, slices: readonly Readonly<AsepriteSlice>[]): {
-    hitbox: Box | undefined;
-    hurtbox: Box | undefined;
+export declare function parseHitboxes(span: Readonly<ase.TagSpan>, slices: readonly Readonly<ase.Slice>[]): {
+    hitbox: V.Box | undefined;
+    hurtbox: V.Box | undefined;
 };
+//# sourceMappingURL=atlas-json-parser.d.ts.map

package/dist/tools/atlas-pack/atlas-json-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas-json-parser.d.ts","sourceRoot":"","sources":["../../../tools/atlas-pack/atlas-json-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,oBAAoB,CAAA;AACvC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAA;AAEpC,OAAO,oBAAoB,CAAA;AAE3B,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,CAexE;AAED,gBAAgB;AAChB,wBAAgB,SAAS,CACvB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAC3B,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAC3B,MAAM,EAAE,SAAS,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GACrC,CAAC,CAAC,IAAI,CAYR;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,GAAG,CAAC,OAAO,EACjB,GAAG,EAAE,GAAG,CAAC,QAAQ,GAChB,GAAG,CAAC,KAAK,EAAE,CAuCb;AAED,gBAAgB;AAChB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAKzD;AAED,gBAAgB;AAChB,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAC3B,MAAM,EAAE,SAAS,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GACrC;IAAC,MAAM,EAAE,CAAC,CAAC,GAAG,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC,GAAG,GAAG,SAAS,CAAA;CAAC,CAiCzD"}