1681-engine 0.0.0-stage → 0.5.9

package/dist/types/anim/asepriteTags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asepriteTags.d.ts","sourceRoot":"","sources":["../../../src/anim/asepriteTags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIzD,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAEvE;AAED,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAGlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA2B1G"}

package/dist/types/anim/asepriteTypes.d.ts

@@ -0,0 +1,159 @@
+import type { AnimationClip } from './Animator.js';
+export interface AsepriteRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** One frame as Aseprite writes it. */
+export interface AsepriteJsonFrame {
+    /** Only in the "array" layout; the "hash" layout keys the frame by it instead. */
+    filename?: string;
+    frame: AsepriteRect;
+    rotated?: boolean;
+    trimmed?: boolean;
+    spriteSourceSize?: AsepriteRect;
+    sourceSize?: {
+        w: number;
+        h: number;
+    };
+    /** Milliseconds. */
+    duration?: number;
+}
+export interface AsepriteJsonTag {
+    name: string;
+    from: number;
+    to: number;
+    direction?: string;
+    /** A count as a string ("3"); absent means forever. Aseprite 1.3 and later. */
+    repeat?: string | number;
+    color?: string;
+    data?: string;
+}
+export interface AsepriteJsonSliceKey {
+    frame: number;
+    bounds: AsepriteRect;
+    center?: AsepriteRect;
+    pivot?: {
+        x: number;
+        y: number;
+    };
+}
+export interface AsepriteJsonSlice {
+    name: string;
+    color?: string;
+    data?: string;
+    keys: AsepriteJsonSliceKey[];
+}
+export interface AsepriteJsonLayer {
+    name: string;
+    group?: string;
+    opacity?: number;
+    blendMode?: string;
+    color?: string;
+    data?: string;
+    /** Cels carrying user data or a colour, when the export includes them. */
+    cels?: {
+        frame: number;
+        data?: string;
+        color?: string;
+    }[];
+}
+export interface AsepriteJson {
+    frames: AsepriteJsonFrame[] | Record<string, AsepriteJsonFrame>;
+    meta: {
+        app?: string;
+        version?: string;
+        image?: string;
+        format?: string;
+        size?: {
+            w: number;
+            h: number;
+        };
+        scale?: string;
+        frameTags?: AsepriteJsonTag[];
+        layers?: AsepriteJsonLayer[];
+        slices?: AsepriteJsonSlice[];
+    };
+}
+export type AsepriteDirection = 'forward' | 'reverse' | 'pingpong' | 'pingpong_reverse';
+/** A frame of the sheet, by its index (the texture frame's name is that index as a string). */
+export interface AsepriteFrame {
+    index: number;
+    /** Aseprite's file name for the frame ("hero 3.aseprite"); look a frame up by it with `frameNamed`. */
+    name: string;
+    /** Where it lies on the sheet image. */
+    rect: AsepriteRect;
+    /** Milliseconds. */
+    duration: number;
+    /** The untrimmed size of the sprite. */
+    sourceW: number;
+    sourceH: number;
+    /** Where the trimmed rect sits inside the untrimmed sprite (0, 0 when not trimmed). */
+    offsetX: number;
+    offsetY: number;
+    trimmed: boolean;
+}
+export interface AsepriteTag {
+    name: string;
+    from: number;
+    to: number;
+    direction: AsepriteDirection;
+    /** Passes to play; 0 is forever. */
+    repeat: number;
+    color?: string;
+    data?: string;
+}
+export interface AsepriteSliceKey {
+    /** The key holds from this frame until the next key's frame. */
+    frame: number;
+    bounds: AsepriteRect;
+    /** The 9-slice centre, in the slice's own coordinates. */
+    center?: AsepriteRect;
+    pivot?: {
+        x: number;
+        y: number;
+    };
+}
+export interface AsepriteSlice {
+    name: string;
+    color?: string;
+    data?: string;
+    /** Sorted by frame. */
+    keys: AsepriteSliceKey[];
+}
+export interface AsepriteLayer {
+    name: string;
+    group?: string;
+    opacity: number;
+    blendMode: string;
+    color?: string;
+    data?: string;
+}
+/** A cel's user data: what a game marks a frame with (a footstep, a hit) on a layer kept for marks. */
+export interface AsepriteCue {
+    layer: string;
+    frame: number;
+    data: string;
+}
+/** A marker a clip fires when its playback reaches `frame` (the frame's position within the clip). */
+export interface ClipMarker {
+    frame: number;
+    name: string;
+}
+export interface AsepriteSheet {
+    /** The sheet image's file name as written in the JSON (relative to the JSON file). */
+    image: string;
+    width: number;
+    height: number;
+    frames: AsepriteFrame[];
+    tags: AsepriteTag[];
+    /** One clip per tag, by tag name; frames are sheet frame indices, durations from the frames. */
+    clips: Record<string, AnimationClip>;
+    /** Every frame in order, looping: for a sheet with no tags. */
+    all: AnimationClip;
+    slices: AsepriteSlice[];
+    layers: AsepriteLayer[];
+    cues: AsepriteCue[];
+}
+//# sourceMappingURL=asepriteTypes.d.ts.map

package/dist/types/anim/asepriteTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asepriteTypes.d.ts","sourceRoot":"","sources":["../../../src/anim/asepriteTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOhD,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,YAAY,CAAC;IAChC,UAAU,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,oBAAoB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3D;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAChE,IAAI,EAAE;QACJ,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAChC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;QAC9B,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;QAC7B,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;KAC9B,CAAC;CACH;AAID,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAExF,+FAA+F;AAC/F,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,uGAAuG;IACvG,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,EAAE,YAAY,CAAC;IACnB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,iBAAiB,CAAC;IAC7B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,IAAI,EAAE,gBAAgB,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uGAAuG;AACvG,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sGAAsG;AACtG,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,gGAAgG;IAChG,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACrC,+DAA+D;IAC/D,GAAG,EAAE,aAAa,CAAC;IACnB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB"}

package/dist/types/anim/parseAseprite.d.ts

@@ -0,0 +1,21 @@
+import type { AsepriteSheet, ClipMarker } from './asepriteTypes.js';
+/**
+ * Reads Aseprite's exported sprite-sheet JSON — either frame layout, "hash" (frames keyed by file name) or "array" —
+ * into frames, one `Animator` clip per tag, slices, layers and cel cues. Pure: no image is touched, so it runs under
+ * node and in a worker; `addAsepriteTextures` / `loadAseprite` cut the sheet image by the frames it returns.
+ *
+ * ```ts
+ * const sheet = parseAseprite(json);
+ * const anim = new Animator(sheet.clips, 'idle'); // tag names are clip names; frames are sheet frame indices
+ * ```
+ */
+export declare function parseAseprite(json: unknown): AsepriteSheet;
+/** The index of the frame Aseprite named `name`, or -1. */
+export declare function frameNamed(sheet: AsepriteSheet, name: string): number;
+/**
+ * Markers for every clip from the sheet's cel cues: wherever a clip shows a sheet frame whose cel carries user data,
+ * a marker of that data at that position of the clip. A ping-pong shows a frame twice a round trip, so it fires twice,
+ * as a footstep should. `layer` keeps only the cues of one layer (a layer kept for marks, say "events").
+ */
+export declare function clipMarkers(sheet: AsepriteSheet, layer?: string): Record<string, ClipMarker[]>;
+//# sourceMappingURL=parseAseprite.d.ts.map

package/dist/types/anim/parseAseprite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseAseprite.d.ts","sourceRoot":"","sources":["../../../src/anim/parseAseprite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAMV,aAAa,EAGb,UAAU,EACX,MAAM,iBAAiB,CAAC;AAKzB;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CA6D1D;AA0BD,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAiB9F"}

package/dist/types/assets/AssetLoader.d.ts

@@ -0,0 +1,140 @@
+import type { CanvasTexture } from '../core/TextureRegistry.js';
+import { type TileMap, type Tileset } from '../tilemap/tiled.js';
+import { type AtlasFrame } from './textureAtlas.js';
+/** Where loaded images go: the stage's `TextureRegistry` satisfies it. */
+export interface TextureSink {
+    addCanvas(key: string, canvas: HTMLCanvasElement): unknown;
+    addSpriteSheet(key: string, canvas: HTMLCanvasElement, size: {
+        frameWidth: number;
+        frameHeight: number;
+    }): unknown;
+    /** Needed only by `atlas`; the stage's `TextureRegistry` has it. */
+    addAtlas?(key: string, pages: readonly {
+        canvas: HTMLCanvasElement;
+        frames: readonly AtlasFrame[];
+    }[]): CanvasTexture | unknown;
+}
+/** What a fetch must answer with; `arrayBuffer` is optional so older custom transports keep working (blob is used). */
+export interface AssetResponse {
+    ok: boolean;
+    status: number;
+    blob(): Promise<Blob>;
+    json(): Promise<unknown>;
+    text(): Promise<string>;
+    arrayBuffer?(): Promise<ArrayBuffer>;
+}
+/** What an atlas brought besides its textures: its frame names (every page) and animations. */
+export interface AtlasInfo {
+    frames: string[];
+    animations: Record<string, string[]>;
+    pages: number;
+}
+export interface AssetLoaderOptions {
+    /** Prefix for relative URLs (default: none, so relative to the page). */
+    baseUrl?: string;
+    /** Requests running at once (default 6). */
+    concurrency?: number;
+    /** For tests and custom transports: defaults to the global `fetch`. */
+    fetch?: (url: string) => Promise<AssetResponse>;
+    /** Turns image bytes into a canvas; defaults to `createImageBitmap` drawn onto a new canvas. */
+    toCanvas?: (blob: Blob) => Promise<HTMLCanvasElement>;
+    /**
+     * The context `audio` decodes through (default: the engine's sound context, `sound.audioContext`, once a gesture
+     * opened it). Null means "not yet": the bytes are kept and decoded on first `decodeAudio`.
+     */
+    audioContext?: () => BaseAudioContext | null;
+    /** Installs a font's bytes; defaults to a `FontFace` added to `document.fonts`. */
+    addFont?: (family: string, data: ArrayBuffer, descriptors?: FontFaceDescriptors) => Promise<void>;
+}
+export interface TilemapAssetOptions {
+    /** The texture key a tileset's image is loaded under (default: the tileset's name). */
+    textureKey?: (tileset: Tileset) => string;
+}
+export interface LoadProgress {
+    done: number;
+    total: number;
+    /** The asset that just finished. */
+    key: string;
+}
+/** `url` resolved against `base` the way a browser would (a bare file name sits beside its map). */
+export declare function resolveUrl(url: string, base: string): string;
+/**
+ * Loads a scene's assets before it starts: queue them, then `await load()`. Images become textures in the stage's
+ * registry (frames of a sprite sheet named 0, 1, 2…); JSON, text and Tiled maps are kept here by key; atlases register every frame under their key; fonts go to
+ * `document.fonts`; audio is decoded into `AudioBuffer`s (or kept as bytes until a context exists). A failed asset
+ * fails the whole load with its URL in the message.
+ *
+ * ```ts
+ * override async onEnter() {
+ *   const assets = new AssetLoader(this.engine.stage.textures);
+ *   assets.spritesheet('hero', 'art/hero.png', { frameWidth: 20, frameHeight: 24 }).tilemap('level', 'maps/level.tmj');
+ *   await assets.load(({ done, total }) => bar.set(done / total));
+ *   const map = assets.map('level');
+ * }
+ * ```
+ */
+export declare class AssetLoader {
+    private readonly textures;
+    private readonly options;
+    private readonly queue;
+    private readonly data;
+    private readonly maps;
+    private readonly atlases;
+    /** Decoded audio by key; a key with bytes only waits for a context (`decodeAudio`). */
+    private readonly audioBuffers;
+    private readonly audioBytes;
+    private readonly decoding;
+    private readonly fetcher;
+    private readonly toCanvas;
+    private total;
+    private done;
+    constructor(textures: TextureSink, options?: AssetLoaderOptions);
+    image(key: string, url: string): this;
+    /** An image cut into equal frames named 0, 1, 2…, left to right, then row by row. */
+    spritesheet(key: string, url: string, size: {
+        frameWidth: number;
+        frameHeight: number;
+    }): this;
+    json(key: string, url: string): this;
+    text(key: string, url: string): this;
+    /** A Tiled JSON map, then every tileset image it names (resolved beside the map file). */
+    tilemap(key: string, url: string, options?: TilemapAssetOptions): this;
+    /**
+     * A TexturePacker (or Pixi) JSON atlas, hash or array format: its page image, and for a multipack atlas every page
+     * named in `meta.related_multi_packs` (each resolved beside the file naming it). The first page is the texture
+     * `key`, further pages `key~1`, `key~2`…, and every frame of every page is found as `textures.get(key, frameName)`.
+     * Counts as one asset in the progress.
+     */
+    atlas(key: string, url: string): this;
+    /**
+     * A web font (woff2, woff, ttf) under `family`, added to `document.fonts` once loaded so canvas text and the DOM can
+     * use it at once — load fonts before the first `Text` is drawn, or it measures with the fallback.
+     */
+    font(family: string, url: string, descriptors?: FontFaceDescriptors): this;
+    /**
+     * A sound file decoded into an `AudioBuffer` through the engine's audio context (`getAudio`). Before any context
+     * exists (browsers open one only after a gesture) the bytes are kept and decoded by `decodeAudio`, so a loading
+     * screen never has to wait for the player to click.
+     */
+    audio(key: string, url: string): this;
+    /** A loaded sound, decoded; null while it waits for an audio context (`decodeAudio`). */
+    getAudio(key: string): AudioBuffer | null;
+    /** A loaded sound, decoding its kept bytes through `ctx` (default: the loader's context) the first time. */
+    decodeAudio(key: string, ctx?: BaseAudioContext): Promise<AudioBuffer>;
+    /** What a loaded atlas holds: its frame names and animations. */
+    getAtlas(key: string): AtlasInfo;
+    /** Runs everything queued; `onProgress` after each asset. Safe to call again after queueing more. */
+    load(onProgress?: (p: LoadProgress) => void): Promise<void>;
+    /** A loaded JSON value. */
+    getJson<T = unknown>(key: string): T;
+    /** A loaded text file. */
+    getText(key: string): string;
+    /** A loaded Tiled map. */
+    map(key: string): TileMap;
+    private add;
+    private request;
+    private blob;
+    private bytes;
+    private decode;
+}
+//# sourceMappingURL=AssetLoader.d.ts.map

package/dist/types/assets/AssetLoader.d.ts.map

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

package/dist/types/assets/loadAseprite.d.ts

@@ -0,0 +1,27 @@
+import type { AsepriteSheet } from '../anim/asepriteTypes.js';
+import type { CanvasTexture } from '../core/TextureRegistry.js';
+import { type AssetLoaderOptions } from './AssetLoader.js';
+/** Where an Aseprite sheet's texture goes: the stage's `TextureRegistry` satisfies it. */
+export interface AsepriteTextureSink {
+    addCanvas(key: string, canvas: HTMLCanvasElement): CanvasTexture;
+}
+/** Fetch and decode hooks, as `AssetLoader` takes them (tests, custom transports, a base URL). */
+export type AsepriteLoadOptions = Pick<AssetLoaderOptions, 'baseUrl' | 'fetch' | 'toCanvas'>;
+/**
+ * Registers `canvas` (the sheet image) under `key` with one frame per sheet frame, named by its index ("0", "1"…), so
+ * the clips `parseAseprite` returns play on an `Image` of that key as they are. A trimmed frame keeps its untrimmed
+ * size and offset (Pixi's `orig` and `trim`), so a sprite anchored at its feet does not jump as the trim changes.
+ */
+export declare function addAsepriteTextures(textures: AsepriteTextureSink, key: string, canvas: HTMLCanvasElement, sheet: AsepriteSheet): CanvasTexture;
+/**
+ * Loads an Aseprite export — the JSON, then the sheet image it names (resolved beside the JSON) — registers its
+ * frames under `key` and returns the parsed sheet (clips, slices, layers, cues).
+ *
+ * ```ts
+ * const [hero] = await Promise.all([loadAseprite(stage.textures, 'hero', 'art/hero.json'), assets.load()]);
+ * const sprite = stage.add.image(0, 0, 'hero', 0);
+ * const anim = new Animator(hero.clips, 'idle');
+ * ```
+ */
+export declare function loadAseprite(textures: AsepriteTextureSink, key: string, jsonUrl: string, options?: AsepriteLoadOptions): Promise<AsepriteSheet>;
+//# sourceMappingURL=loadAseprite.d.ts.map

package/dist/types/assets/loadAseprite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadAseprite.d.ts","sourceRoot":"","sources":["../../../src/assets/loadAseprite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEpE,0FAA0F;AAC1F,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAAC;CAClE;AAED,kGAAkG;AAClG,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC;AAE7F;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,aAAa,GAAG,aAAa,CAoB9I;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmBzJ"}

package/dist/types/assets/textureAtlas.d.ts

@@ -0,0 +1,35 @@
+import type { PackedFrame } from '../core/TextureRegistry.js';
+/**
+ * Reads TexturePacker's JSON atlases — the "JSON (Hash)" and "JSON (Array)" exports, which Pixi's own `Spritesheet`
+ * also reads — into plain numbers, with no Pixi or DOM, so the parsing is tested under node. A multipack atlas lists
+ * its other pages' JSON files in `meta.related_multi_packs`; the loader follows them and registers every frame of
+ * every page under one key.
+ */
+/** One frame as the registry needs it: where it lies on its page and how it is trimmed or turned. */
+export type AtlasFrame = PackedFrame;
+/** One page of an atlas: its image and its frames. */
+export interface PackedAtlasPage {
+    /** The page image as named in `meta.image`, relative to the JSON file. */
+    image: string;
+    frames: AtlasFrame[];
+    /** Animations by name, each a list of frame names (`animations` in Pixi-flavoured JSON). */
+    animations: Record<string, string[]>;
+    /** Further pages' JSON files (`meta.related_multi_packs`), relative to this one. */
+    related: string[];
+    /** Pixels per unit the page was exported at (`meta.scale`, default 1). */
+    scale: number;
+}
+/** Parses one atlas JSON file; throws naming `where` (its URL) when it is not one. */
+export declare function parseAtlas(json: unknown, where?: string): PackedAtlasPage;
+/**
+ * Every page of a multipack atlas, the first first, each JSON fetched once however the pages name each other
+ * (TexturePacker lists every other page in each page). `load(url)` returns a page's parsed JSON; `resolve` turns a
+ * related name into a URL beside the file naming it.
+ */
+export declare function collectAtlasPages(url: string, load: (url: string) => Promise<PackedAtlasPage>, resolve: (name: string, base: string) => string): Promise<{
+    url: string;
+    page: PackedAtlasPage;
+}[]>;
+/** Frame names that appear on more than one page: the later page's frame wins, which is almost always a mistake. */
+export declare function duplicateFrames(pages: readonly PackedAtlasPage[]): string[];
+//# sourceMappingURL=textureAtlas.d.ts.map

package/dist/types/assets/textureAtlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureAtlas.d.ts","sourceRoot":"","sources":["../../../src/assets/textureAtlas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;GAKG;AAEH,qGAAqG;AACrG,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC;AAErC,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,4FAA4F;IAC5F,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC,oFAAoF;IACpF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;CACf;AAsDD,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,SAAU,GAAG,eAAe,CAqB1E;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,EAC/C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,GAC9C,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,EAAE,CAAC,CAgBnD;AAED,oHAAoH;AACpH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,EAAE,CAK3E"}

package/dist/types/audio/Footsteps.d.ts

@@ -0,0 +1,33 @@
+/** What a surface sounds like underfoot: a step, and a beat of hooves (a mount) if it differs. */
+export interface SurfaceSounds {
+    step: string;
+    hoof?: string;
+}
+export interface FootstepOptions {
+    /** Per surface name (`'grass'`, `'stone'`, `'wood'`…), the sounds a foot makes on it. */
+    sounds: Record<string, SurfaceSounds>;
+    /** The surface of anywhere `surfaceAt` does not name. */
+    fallback: string;
+    /** Weight of a step against other sounds (default 0.5). */
+    gain?: number;
+    /** Beyond this (world px) nobody else's steps are heard (default 200). */
+    range?: number;
+}
+/**
+ * Footsteps by the ground under the feet. The game says what a point is made of (`surfaceAt`: a tile's surface, a
+ * Tiled property, a floor collider), and calls `step` on each beat of a walk or a gait; the sound is the surface's,
+ * through `sound` at the feet, quieter and muffled with distance like every other sound, and dropped first when too
+ * many sounds play at once.
+ */
+export declare class Footsteps {
+    private readonly options;
+    private surfaceAt;
+    constructor(options: FootstepOptions);
+    /** Where the surface of a world point comes from; `undefined` is the fallback surface. */
+    setSurfaceAt(surfaceAt: (x: number, y: number) => string | undefined): void;
+    /** The surface at a world point. */
+    surface(x: number, y: number): string;
+    /** One step (or a beat of hooves when `mounted`) at the feet, world x/y; `local` is the player's own. */
+    step(x: number, y: number, local: boolean, mounted?: boolean): void;
+}
+//# sourceMappingURL=Footsteps.d.ts.map

package/dist/types/audio/Footsteps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Footsteps.d.ts","sourceRoot":"","sources":["../../../src/audio/Footsteps.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IAGR,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,SAAS,CAAiE;gBAErD,OAAO,EAAE,eAAe;IAErD,0FAA0F;IAC1F,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI;IAI3E,oCAAoC;IACpC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrC,yGAAyG;IACzG,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,UAAQ,GAAG,IAAI;CAMlE"}

package/dist/types/audio/MusicPlayer.d.ts

@@ -0,0 +1,65 @@
+import { MusicChannel, type PlayOptions } from './music/MusicChannel.js';
+export type { PlayOptions } from './music/MusicChannel.js';
+/**
+ * How music reaches the speaker: `'element'` on the `<audio>` element's own volume (nothing in between; a file from
+ * another origin plays as it is), `'graph'` through a Web Audio gain (the only way where that volume is read-only),
+ * `'auto'` (default) the graph only where it has to be (iOS).
+ */
+export type MusicRoute = 'auto' | 'element' | 'graph';
+export interface MusicOptions {
+    route?: MusicRoute;
+    /** Stop the music while the page is hidden (an app sent to the background). Default: on touch devices. */
+    pauseInBackground?: boolean;
+}
+/**
+ * Background music in layers: each named channel (`'music'` by default, `'ambience'`, any other) plays one looping
+ * track at a time, crossfaded when it changes, all at `engineSettings.musicVolume`. Tracks stream through `<audio>`
+ * elements (no decoding a whole song into memory).
+ *
+ * Browsers start sound only after a user gesture: a track played before one starts on the first tap or key. On iOS the
+ * graph's context is woken inside that gesture too, and again after the app comes back from the background.
+ *
+ * ```ts
+ * music.play('music/forest.ogg');                                     // the 'music' channel
+ * music.channel('ambience').play('amb/wind.ogg', { volume: 0.5 });     // a second layer under it
+ * music.play('music/boss.ogg', { fadeMs: 600 });                      // crossfades the first only
+ * music.stop(2000);
+ * ```
+ */
+export declare class MusicPlayer {
+    private readonly channels;
+    private route;
+    private graph;
+    private graphLocked;
+    private pauseInBackground;
+    private installed;
+    /** Picks the route and background behaviour; call before the first track for the route to apply to every track. */
+    configure(options: MusicOptions): this;
+    /** The channel named `name`, made on first use. */
+    channel(name?: string): MusicChannel;
+    /** The url the `'music'` channel plays, if any. */
+    get current(): string | null;
+    /** Plays `url` on the `'music'` channel. */
+    play(url: string, options?: PlayOptions): void;
+    /** Fades every channel out. */
+    stop(fadeMs?: number): void;
+    pause(): void;
+    resume(): void;
+    destroy(): void;
+    private voiceFor;
+    private throughGraph;
+    private context;
+    /** Retries every refused start and follows the volume; the graph's context resumes inside the gesture that called it. */
+    private wake;
+    private install;
+}
+/** A fade's value at `now`: linear from `from` to `to` over `ms`. */
+export declare function fadeValue(f: {
+    from: number;
+    to: number;
+    start: number;
+    ms: number;
+}, now: number): number;
+/** The shared music player. */
+export declare const music: MusicPlayer;
+//# sourceMappingURL=MusicPlayer.d.ts.map

package/dist/types/audio/MusicPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MusicPlayer.d.ts","sourceRoot":"","sources":["../../../src/audio/MusicPlayer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGtE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,0GAA0G;IAC1G,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,iBAAiB,CAAwB;IACjD,OAAO,CAAC,SAAS,CAAS;IAE1B,mHAAmH;IACnH,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAMtC,mDAAmD;IACnD,OAAO,CAAC,IAAI,SAAU,GAAG,YAAY;IAUrC,mDAAmD;IACnD,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IAED,4CAA4C;IAC5C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAI9C,+BAA+B;IAC/B,IAAI,CAAC,MAAM,SAAO,GAAG,IAAI;IAIzB,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IAId,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,OAAO;IAQf,yHAAyH;IACzH,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,OAAO;CAahB;AAED,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIzG;AAED,+BAA+B;AAC/B,eAAO,MAAM,KAAK,aAAoB,CAAC"}

package/dist/types/audio/SoundEngine.d.ts

@@ -0,0 +1,47 @@
+export interface SoundOptions {
+    /** Where it happened in the world; absent for what happens to or is done by the local player. */
+    x?: number;
+    y?: number;
+    /** Done by (or to) the local player: full weight. */
+    local?: boolean;
+    /** Extra weight (default 1). */
+    gain?: number;
+    /** How far away it can be heard (px), when nearer than `HEARING`. */
+    range?: number;
+    /** Skipped when the mix is busy (footsteps). */
+    minor?: boolean;
+    /** Cut off after this long (ms), faded over `CUT_FADE_MS`: a cast's sound ends with the cast. */
+    maxMs?: number;
+}
+export declare class SoundEngine {
+    private ctx;
+    private master;
+    private readonly buffers;
+    private readonly samples;
+    private readonly lastAt;
+    private voices;
+    /** Where the local player stands, set by the world scene; null off the world screens. */
+    listener: () => {
+        x: number;
+        y: number;
+    } | null;
+    private onRunning;
+    constructor();
+    /**
+     * The effects' audio context once something opened it (the first gesture does), else null: never created here, so
+     * asking does not open a context the browser would hold suspended. `AssetLoader.audio` decodes through it.
+     */
+    get audioContext(): AudioContext | null;
+    play(name: string | undefined, opts?: SoundOptions): void;
+    private level;
+    private context;
+    /**
+     * Starts decoding every recorded take and renders every recipe not rendered yet, one per task, once the context
+     * first runs — so the first swing of a fight does not pay for its sound in that frame.
+     */
+    private prerender;
+    /** Rendered on first use or by `prerender` (a few ms each), then kept. */
+    private buffer;
+}
+export declare const sound: SoundEngine;
+//# sourceMappingURL=SoundEngine.d.ts.map

package/dist/types/audio/SoundEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoundEngine.d.ts","sourceRoot":"","sources":["../../../src/audio/SoundEngine.ts"],"names":[],"mappings":"AAqCA,MAAM,WAAW,YAAY;IAC3B,iGAAiG;IACjG,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iGAAiG;IACjG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAA6B;IACxC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,MAAM,CAAK;IACnB,yFAAyF;IACzF,QAAQ,EAAE,MAAM;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAc;IAC7D,OAAO,CAAC,SAAS,CAAwC;;IAmCzD;;;OAGG;IACH,IAAI,YAAY,IAAI,YAAY,GAAG,IAAI,CAEtC;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI;IA0D7D,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,OAAO;IA0Bf;;;OAGG;IACH,OAAO,CAAC,SAAS;IAajB,0EAA0E;IAC1E,OAAO,CAAC,MAAM;CAaf;AAED,eAAO,MAAM,KAAK,aAAoB,CAAC"}

package/dist/types/audio/cleanTake.d.ts

@@ -0,0 +1,3 @@
+/** The cleaned mono samples, or null for a take that is silence. */
+export declare function cleanSamples(channels: Float32Array[], sampleRate: number): Float32Array | null;
+//# sourceMappingURL=cleanTake.d.ts.map

package/dist/types/audio/cleanTake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanTake.d.ts","sourceRoot":"","sources":["../../../src/audio/cleanTake.ts"],"names":[],"mappings":"AAoBA,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA6B9F"}

package/dist/types/audio/music/ElementVoice.d.ts

@@ -0,0 +1,14 @@
+import { type MusicVoice } from './musicVoice.js';
+/** A track on the `<audio>` element's own volume, faded frame by frame: nothing between the file and the speaker. */
+export declare class ElementVoice implements MusicVoice {
+    readonly el: HTMLAudioElement;
+    private fading;
+    constructor(el: HTMLAudioElement);
+    level(): number;
+    set(level: number): void;
+    fade(to: number, ms: number, done?: () => void): void;
+    get busy(): boolean;
+    dispose(): void;
+    private stopFade;
+}
+//# sourceMappingURL=ElementVoice.d.ts.map

package/dist/types/audio/music/ElementVoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementVoice.d.ts","sourceRoot":"","sources":["../../../../src/audio/music/ElementVoice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAExD,qHAAqH;AACrH,qBAAa,YAAa,YAAW,UAAU;IAGjC,QAAQ,CAAC,EAAE,EAAE,gBAAgB;IAFzC,OAAO,CAAC,MAAM,CAAuB;gBAEhB,EAAE,EAAE,gBAAgB;IAEzC,KAAK,IAAI,MAAM;IAIf,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKxB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAgBrD,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,QAAQ;CAIjB"}

package/dist/types/audio/music/GraphVoice.d.ts

@@ -0,0 +1,22 @@
+import { type MusicVoice } from './musicVoice.js';
+/**
+ * A track routed `<audio>` → MediaElementSource → gain → speakers, so its volume and crossfades work where the
+ * element's own `volume` is read-only (iOS). The fade is scheduled on the audio clock (a ramp), so it runs even while
+ * the page draws no frames. A cross-origin file without CORS headers plays silent this way: serve music from the
+ * game's own origin, or keep `ElementVoice` where volume works.
+ */
+export declare class GraphVoice implements MusicVoice {
+    readonly el: HTMLAudioElement;
+    private readonly graph;
+    private readonly gain;
+    private readonly source;
+    private timer;
+    constructor(el: HTMLAudioElement, graph: AudioContext);
+    level(): number;
+    set(level: number): void;
+    fade(to: number, ms: number, done?: () => void): void;
+    get busy(): boolean;
+    dispose(): void;
+    private stopFade;
+}
+//# sourceMappingURL=GraphVoice.d.ts.map

package/dist/types/audio/music/GraphVoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphVoice.d.ts","sourceRoot":"","sources":["../../../../src/audio/music/GraphVoice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAExD;;;;;GAKG;AACH,qBAAa,UAAW,YAAW,UAAU;IAMzC,QAAQ,CAAC,EAAE,EAAE,gBAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK;IANxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,KAAK,CAA8C;gBAGhD,EAAE,EAAE,gBAAgB,EACZ,KAAK,EAAE,YAAY;IAQtC,KAAK,IAAI,MAAM;IAIf,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOxB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAarD,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,QAAQ;CAIjB"}