1681-engine 0.0.0-stage → 0.5.8

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

@@ -0,0 +1,80 @@
+import { Animator, type AnimationClip } from './Animator.js';
+import type { AnimParams, AnimStateMachineOptions } from './animStateTypes.js';
+/**
+ * Chooses which clip an `Animator` plays from named states and the transitions between them, the way an animation
+ * graph in a larger engine does: the game sets parameters (a bool, a number, a one-shot trigger) and the machine
+ * moves between states when a transition's conditions hold, when a clip has played through, or from any state at
+ * all by priority. Frame markers fire events (a footstep on frame 3) for the game to hang sounds and effects on.
+ *
+ * Pure and driven by `update(dt)`, so it runs under node with a fake clock. The definition is compiled into typed
+ * arrays once; an update allocates nothing.
+ *
+ * ```ts
+ * const sm = new AnimStateMachine(sheet.clips, {
+ *   initial: 'idle',
+ *   params: { speed: 0, grounded: true, jump: 'trigger' },
+ *   states: { idle: { clip: 'idle' }, run: { clip: 'run', markers: [{ frame: 2, name: 'step' }] }, jump: { clip: 'jump' } },
+ *   transitions: [
+ *     { from: 'idle', to: 'run', when: { speed: ['>', 0] } },
+ *     { from: 'run', to: 'idle', when: { speed: 0 } },
+ *     { from: '*', to: 'jump', when: { jump: true, grounded: true }, priority: 10 },
+ *   ],
+ * });
+ * sm.onEvent = (name) => name === 'step' && sound.play('step');
+ * sm.set('speed', 3);
+ * sm.update(dt);              // seconds; then show sm.frame
+ * ```
+ */
+export declare class AnimStateMachine<State extends string = string, Clip extends string = string, P extends AnimParams = AnimParams> {
+    /** The animator it drives; read `frame` off it (or off the machine). */
+    readonly animator: Animator<Clip>;
+    /** Fired for every marker playback reaches, the state's first frame's on entering it. */
+    onEvent: ((event: string, state: State, frame: number) => void) | null;
+    /** Fired after each change of state. */
+    onStateChange: ((from: State, to: State) => void) | null;
+    private readonly params;
+    private readonly states;
+    private readonly tr;
+    private readonly keepTriggers;
+    private stateIndex;
+    /** Time played in this state, ms, scaled by speed as the animator scales it. */
+    private time;
+    constructor(clips: Record<Clip, AnimationClip>, options: AnimStateMachineOptions<State, Clip, P>);
+    /** The state playing. */
+    get state(): State;
+    /** The frame to show now (a sheet frame index or name, as the clip lists it). */
+    get frame(): string | number;
+    /** How much of this state's clip has played: 0 at entry, 1 after one pass, 2 after two loops. */
+    get normalizedTime(): number;
+    /** Sets a bool or number parameter. */
+    set(name: keyof P & string, value: boolean | number): this;
+    /** A parameter's value: bools as booleans, triggers as whether they are set. */
+    get(name: keyof P & string): boolean | number;
+    /** Fires a trigger: the next update's transitions see it once. */
+    trigger(name: keyof P & string): this;
+    resetTrigger(name: keyof P & string): this;
+    /** Goes to `state` now, whatever the transitions say (a respawn, a cut scene). */
+    play(state: State): this;
+    /** Back to the initial values of every parameter (triggers cleared). */
+    resetParams(): this;
+    /**
+     * Advances the clip by `dt` seconds, fires the markers it passed, then takes at most one transition (so a chain of
+     * them never runs through several states in one frame). `update(0)` only checks the transitions.
+     */
+    update(dt: number): void;
+    private pick;
+    private holds;
+    private enter;
+    /**
+     * Fires the markers of every frame after `from` up to `to`. The animator skips frames on a long step, so they are
+     * walked rather than only the one landed on; a step long enough to loop the whole clip fires each frame once.
+     */
+    private firePassed;
+    private fire;
+    private applySpeed;
+    private consumeTriggers;
+    private clearTriggers;
+    private paramIndex;
+    private triggerIndex;
+}
+//# sourceMappingURL=AnimStateMachine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnimStateMachine.d.ts","sourceRoot":"","sources":["../../../src/anim/AnimStateMachine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAiB1D,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,gBAAgB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,IAAI,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,UAAU,GAAG,UAAU;IAC1H,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClC,yFAAyF;IACzF,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAC9E,wCAAwC;IACxC,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEhE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,UAAU,CAAS;IAC3B,gFAAgF;IAChF,OAAO,CAAC,IAAI,CAAK;gBAEL,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE,OAAO,EAAE,uBAAuB,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAWhG,yBAAyB;IACzB,IAAI,KAAK,IAAI,KAAK,CAEjB;IAED,iFAAiF;IACjF,IAAI,KAAK,IAAI,MAAM,GAAG,MAAM,CAE3B;IAED,iGAAiG;IACjG,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,uCAAuC;IACvC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAO1D,gFAAgF;IAChF,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM;IAM7C,kEAAkE;IAClE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI;IAKrC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI;IAK1C,kFAAkF;IAClF,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAOxB,wEAAwE;IACxE,WAAW,IAAI,IAAI;IAKnB;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAqBxB,OAAO,CAAC,IAAI;IAcZ,OAAO,CAAC,KAAK;IAqBb,OAAO,CAAC,KAAK;IAWb;;;OAGG;IACH,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,YAAY;CAKrB"}

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

@@ -0,0 +1,50 @@
+/**
+ * Frame animation of one sprite: which clip plays, which frame it is on. Pure state, advanced by time; a system copies
+ * `frame` onto the sprite (`animationSystem`).
+ *
+ * ```ts
+ * const clips = { idle: { frames: [0, 1], fps: 2 }, walk: { frames: [2, 3, 4, 5], fps: 10 }, die: { frames: [6, 7, 8], fps: 8, loop: false } };
+ * const a = new Animator(clips, 'idle');
+ * a.play('walk');          // switching to the clip already playing keeps its place
+ * a.update(dt);            // seconds
+ * sprite.setFrame(a.frame);
+ * ```
+ */
+export interface AnimationClip {
+    /** Frame names or indices of the sprite sheet, in order. */
+    frames: readonly (string | number)[];
+    /** Frames per second (default 10). Pixel art usually wants 8–12. */
+    fps?: number;
+    /** Start over at the end (default true); otherwise hold the last frame and report it finished. */
+    loop?: boolean;
+    /** Per-frame lengths in ms, overriding `fps` (a held key pose, a quick smear). */
+    durations?: readonly number[];
+}
+export type AnimationClips = Record<string, AnimationClip>;
+export declare class Animator<Name extends string = string> {
+    private readonly clips;
+    private clip;
+    private index;
+    private elapsed;
+    private ended;
+    private name;
+    /** Called when a clip that does not loop reaches its last frame. */
+    onComplete: ((clip: Name) => void) | null;
+    /** Playback speed multiplier (1 normal, 0 paused). */
+    speed: number;
+    constructor(clips: Record<Name, AnimationClip>, initial: NoInfer<Name>);
+    /** The clip playing. */
+    get current(): Name;
+    /** The frame to show now. */
+    get frame(): string | number;
+    /** Which frame of the clip (0-based). */
+    get frameIndex(): number;
+    /** A non-looping clip has reached its last frame. */
+    get finished(): boolean;
+    /** Plays `name`. The clip already playing keeps its place unless `restart`. */
+    play(name: Name, restart?: boolean): this;
+    /** Advances by `dt` seconds; returns true when the frame changed. */
+    update(dt: number): boolean;
+    private lengthOf;
+}
+//# sourceMappingURL=Animator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Animator.d.ts","sourceRoot":"","sources":["../../../src/anim/Animator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACrC,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kFAAkF;IAClF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE3D,qBAAa,QAAQ,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;IAY9C,OAAO,CAAC,QAAQ,CAAC,KAAK;IAXxB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,IAAI,CAAO;IACnB,oEAAoE;IACpE,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IACjD,sDAAsD;IACtD,KAAK,SAAK;gBAGS,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,EACnD,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC;IASxB,wBAAwB;IACxB,IAAI,OAAO,IAAI,IAAI,CAElB;IAED,6BAA6B;IAC7B,IAAI,KAAK,IAAI,MAAM,GAAG,MAAM,CAE3B;IAED,yCAAyC;IACzC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,qDAAqD;IACrD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,+EAA+E;IAC/E,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,UAAQ,GAAG,IAAI;IAavC,qEAAqE;IACrE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAqB3B,OAAO,CAAC,QAAQ;CAIjB"}

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

@@ -0,0 +1,52 @@
+import type { AnimationClip } from './Animator.js';
+import type { AnimParams, AnimStateMachineOptions } from './animStateTypes.js';
+export declare const PARAM_BOOL = 0;
+export declare const PARAM_NUMBER = 1;
+export declare const PARAM_TRIGGER = 2;
+export declare const OP_EQ = 0;
+export declare const OP_NE = 1;
+export declare const OP_GT = 2;
+export declare const OP_GE = 3;
+export declare const OP_LT = 4;
+export declare const OP_LE = 5;
+export interface CompiledParams {
+    names: string[];
+    index: Map<string, number>;
+    kinds: Uint8Array;
+    values: Float64Array;
+    initial: Float64Array;
+}
+export interface CompiledStates {
+    names: string[];
+    index: Map<string, number>;
+    clips: string[];
+    speeds: Float64Array;
+    /** Index of the speed parameter, or -1. */
+    speedParams: Int32Array;
+    /** Total length of each state's clip in ms, at speed 1. */
+    lengths: Float64Array;
+    frameCounts: Int32Array;
+    /** Per state, per clip frame: the event names fired there (undefined: none). */
+    markers: (readonly (readonly string[] | undefined)[])[];
+    /** Per state: transition indices to try, best first. */
+    candidates: Int32Array[];
+}
+export interface CompiledTransitions {
+    to: Int32Array;
+    anyState: Uint8Array;
+    self: Uint8Array;
+    onEnd: Uint8Array;
+    /** -1: none. */
+    exitTime: Float64Array;
+    condStart: Int32Array;
+    condEnd: Int32Array;
+    condParam: Int32Array;
+    condOp: Uint8Array;
+    condValue: Float64Array;
+}
+/** The length of a clip in ms, frame by frame exactly as `Animator` times it. */
+export declare function clipLength(clip: AnimationClip): number;
+export declare function compileParams(decl: AnimParams): CompiledParams;
+export declare function compileStates(options: AnimStateMachineOptions<string, string, AnimParams>, clips: Record<string, AnimationClip>, params: CompiledParams): CompiledStates;
+export declare function compileTransitions(options: AnimStateMachineOptions<string, string, AnimParams>, states: CompiledStates, params: CompiledParams): CompiledTransitions;
+//# sourceMappingURL=animStateCompile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animStateCompile.d.ts","sourceRoot":"","sources":["../../../src/anim/animStateCompile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAiB,UAAU,EAAE,uBAAuB,EAAa,MAAM,kBAAkB,CAAC;AAQtG,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,KAAK,IAAI,CAAC;AAIvB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,2CAA2C;IAC3C,WAAW,EAAE,UAAU,CAAC;IACxB,2DAA2D;IAC3D,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,UAAU,CAAC;IACxB,gFAAgF;IAChF,OAAO,EAAE,CAAC,SAAS,CAAC,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;IACxD,wDAAwD;IACxD,UAAU,EAAE,UAAU,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,UAAU,CAAC;IACf,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,gBAAgB;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,UAAU,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,YAAY,CAAC;CACzB;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAItD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAgB9D;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAC5D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACpC,MAAM,EAAE,cAAc,GACrB,cAAc,CAiChB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAC5D,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,GACrB,mBAAmB,CAmDrB"}

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

@@ -0,0 +1,10 @@
+import { type ComponentType, type System } from '../ecs/World.js';
+import type { AnimStateMachine } from './AnimStateMachine.js';
+/** An entity's animation state machine. Give an entity this instead of `AnimationComponent`: the machine owns its animator. */
+export declare const AnimStateComponent: ComponentType<AnimStateMachine>;
+/**
+ * Updates every `AnimStateMachine` each frame and shows its frame on the entity's sprite (only when it changed).
+ * Add it after the systems that set the machines' parameters, so a change shows the same frame.
+ */
+export declare function animStateSystem(name?: string): System;
+//# sourceMappingURL=animStateSystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animStateSystem.d.ts","sourceRoot":"","sources":["../../../src/anim/animStateSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAExF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,+HAA+H;AAC/H,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,gBAAgB,CAAkD,CAAC;AAElH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,SAAe,GAAG,MAAM,CAQ3D"}

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

@@ -0,0 +1,50 @@
+import type { ClipMarker } from './asepriteTypes.js';
+/** A parameter's declaration, by its starting value: a bool, a number, or the word 'trigger' (a one-shot flag). */
+export type AnimParamDecl = boolean | number | 'trigger';
+export type AnimParams = Record<string, AnimParamDecl>;
+export type CompareOp = '==' | '!=' | '>' | '>=' | '<' | '<=';
+/**
+ * What a transition asks of one parameter: a bool or number to equal, `[op, number]` to compare a number, and for a
+ * trigger `true` (it was fired) or `false` (it was not).
+ */
+export type AnimCondition = boolean | number | readonly [CompareOp, number];
+export interface AnimStateDef<Clip extends string> {
+    /** The clip this state plays, entered from its first frame. */
+    clip: Clip;
+    /** Playback speed (default 1). */
+    speed?: number;
+    /** A number parameter the speed is multiplied by (its size: a run cadence that follows the body's speed). */
+    speedParam?: string;
+    /** Events fired as playback reaches frames of the clip (positions in the clip, 0-based). */
+    markers?: readonly ClipMarker[];
+}
+export interface AnimTransition<State extends string, P extends AnimParams> {
+    /** The state it leaves, several, or '*' for any state (an any-state transition). */
+    from: State | '*' | readonly State[];
+    to: State;
+    /** Every condition must hold. Triggers it names are used up when it is taken. */
+    when?: {
+        readonly [K in keyof P]?: AnimCondition;
+    };
+    /** Only once the clip has played through once (a non-looping clip has finished, a looping one has looped). */
+    onEnd?: boolean;
+    /** Only once this share of the clip has played (0.5 is half way; 2 is two loops). */
+    exitTime?: number;
+    /** Checked before lower ones; ties in the order written. Default 0. */
+    priority?: number;
+    /** An any-state transition may re-enter the state it is already in (default false: it would restart every update). */
+    self?: boolean;
+}
+export interface AnimStateMachineOptions<State extends string, Clip extends string, P extends AnimParams> {
+    initial: NoInfer<State>;
+    states: Record<State, AnimStateDef<Clip>>;
+    params?: P;
+    transitions?: readonly AnimTransition<NoInfer<State>, NoInfer<P>>[];
+    /**
+     * Keep a trigger no transition used until one does (default false: cleared at the end of every update). Off by
+     * default because a press that changed nothing now — a jump pressed in mid-air — should not play out later, on
+     * landing.
+     */
+    keepTriggers?: boolean;
+}
+//# sourceMappingURL=animStateTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animStateTypes.d.ts","sourceRoot":"","sources":["../../../src/anim/animStateTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,mHAAmH;AACnH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AACzD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;AAE9D;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAE5E,MAAM,WAAW,YAAY,CAAC,IAAI,SAAS,MAAM;IAC/C,+DAA+D;IAC/D,IAAI,EAAE,IAAI,CAAC;IACX,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6GAA6G;IAC7G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,cAAc,CAAC,KAAK,SAAS,MAAM,EAAE,CAAC,SAAS,UAAU;IACxE,oFAAoF;IACpF,IAAI,EAAE,KAAK,GAAG,GAAG,GAAG,SAAS,KAAK,EAAE,CAAC;IACrC,EAAE,EAAE,KAAK,CAAC;IACV,iFAAiF;IACjF,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa;KAAE,CAAC;IACnD,8GAA8G;IAC9G,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sHAAsH;IACtH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB,CAAC,KAAK,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM,EAAE,CAAC,SAAS,UAAU;IACtG,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,WAAW,CAAC,EAAE,SAAS,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

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

@@ -0,0 +1,13 @@
+import type { Image } from '../core/Image.js';
+import { type ComponentType, type System } from '../ecs/World.js';
+import type { Animator } from './Animator.js';
+/** The engine's sprite component: the `Image` an entity is drawn as. */
+export declare const SpriteComponent: ComponentType<Image>;
+/** The engine's animation component: the `Animator` choosing the sprite's frame. */
+export declare const AnimationComponent: ComponentType<Animator>;
+/**
+ * Advances every `Animator` each frame and shows its frame on the entity's sprite (only when it changed, so an idle
+ * crowd costs no texture swaps).
+ */
+export declare function animationSystem(name?: string): System;
+//# sourceMappingURL=animationSystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animationSystem.d.ts","sourceRoot":"","sources":["../../../src/anim/animationSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAA2B,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wEAAwE;AACxE,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,KAAK,CAAoC,CAAC;AAEtF,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,QAAQ,CAA0C,CAAC;AAElG;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,SAAc,GAAG,MAAM,CAO1D"}

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

@@ -0,0 +1,19 @@
+import type { AsepriteSheet, AsepriteSlice, AsepriteSliceKey } from './asepriteTypes.js';
+/** A slice by name, or undefined. */
+export declare function sliceNamed(sheet: AsepriteSheet, name: string): AsepriteSlice | undefined;
+/**
+ * The key of `slice` in effect on sprite frame `frame`: Aseprite keys a slice on the frame it changes and holds it
+ * until the next key, so the last key at or before the frame. Before the first key the slice is not there (undefined).
+ */
+export declare function sliceAt(slice: AsepriteSlice, frame?: number): AsepriteSliceKey | undefined;
+/**
+ * The 9-slice borders of a key with a centre — how far in from each edge the stretchable middle starts — in the shape
+ * Pixi's `NineSliceSprite` and `Texture.defaultBorders` take. Undefined for a key with no centre.
+ */
+export declare function sliceBorders(key: AsepriteSliceKey): {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+} | undefined;
+//# sourceMappingURL=asepriteSlices.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asepriteSlices.d.ts","sourceRoot":"","sources":["../../../src/anim/asepriteSlices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEtF,qCAAqC;AACrC,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAExF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,SAAI,GAAG,gBAAgB,GAAG,SAAS,CAOrF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAI5H"}

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

@@ -0,0 +1,16 @@
+import type { AsepriteDirection } from './asepriteTypes.js';
+/** Aseprite's direction name, or forward for anything unknown (older files write none). */
+export declare function tagDirection(raw: string | undefined): AsepriteDirection;
+/** Aseprite writes the repeat count as a string; absent, 0 or nonsense is forever. */
+export declare function tagRepeat(raw: string | number | undefined): number;
+/**
+ * The sheet frames a tag plays, in playing order, unrolled so the engine's `Animator` (which only ever plays a list
+ * forward) shows exactly what Aseprite's own player shows.
+ *
+ * - forever (`repeat` 0): forward and reverse are one pass, looped; a ping-pong is one round trip without its two
+ *   ends doubled (a b c d c b, then a again), so a loop never stutters on the turn.
+ * - `repeat` n: n passes, played once. A ping-pong counts each pass in one direction as one, as Aseprite does, and two
+ *   passes share their turning frame (repeat 2 of a b c is a b c b a).
+ */
+export declare function tagFrames(from: number, to: number, direction: AsepriteDirection, repeat: number): number[];
+//# sourceMappingURL=asepriteTags.d.ts.map

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":"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"}

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,85 @@
+import { type TileMap, type Tileset } from '../tilemap/tiled.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;
+}
+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<{
+        ok: boolean;
+        status: number;
+        blob(): Promise<Blob>;
+        json(): Promise<unknown>;
+        text(): Promise<string>;
+    }>;
+    /** Turns image bytes into a canvas; defaults to `createImageBitmap` drawn onto a new canvas. */
+    toCanvas?: (blob: Blob) => Promise<HTMLCanvasElement>;
+}
+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. 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 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;
+    /** 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;
+}
+//# 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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"}