sliver-engine 0.0.1-alpha-4

package/dist/Game/Saves/index.js

@@ -0,0 +1,213 @@
+const getLocalStorage = () => {
+    if (typeof window === "undefined") {
+        return null;
+    }
+    try {
+        return window.localStorage ?? null;
+    }
+    catch {
+        return null;
+    }
+};
+const encodeUtf8ToBase64 = (value) => {
+    // Prefer Node/Bun (tests, tooling) if available.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const maybeBuffer = globalThis.Buffer;
+    if (maybeBuffer) {
+        return maybeBuffer.from(value, "utf-8").toString("base64");
+    }
+    if (typeof TextEncoder !== "undefined" && typeof btoa !== "undefined") {
+        const bytes = new TextEncoder().encode(value);
+        let binary = "";
+        const chunkSize = 0x8000;
+        for (let i = 0; i < bytes.length; i += chunkSize) {
+            const chunk = bytes.subarray(i, i + chunkSize);
+            binary += String.fromCharCode(...chunk);
+        }
+        return btoa(binary);
+    }
+    if (typeof btoa !== "undefined") {
+        return btoa(unescape(encodeURIComponent(value)));
+    }
+    throw new Error("Base64 encoding is not available in this environment.");
+};
+const decodeBase64ToUtf8 = (base64) => {
+    // Prefer Node/Bun (tests, tooling) if available.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const maybeBuffer = globalThis.Buffer;
+    if (maybeBuffer) {
+        return maybeBuffer.from(base64, "base64").toString("utf-8");
+    }
+    if (typeof atob !== "undefined") {
+        const binary = atob(base64);
+        if (typeof TextDecoder !== "undefined") {
+            const bytes = new Uint8Array(binary.length);
+            for (let i = 0; i < binary.length; i++) {
+                bytes[i] = binary.charCodeAt(i);
+            }
+            return new TextDecoder().decode(bytes);
+        }
+        return decodeURIComponent(escape(binary));
+    }
+    throw new Error("Base64 decoding is not available in this environment.");
+};
+const encodeJsonToBase64 = (data) => {
+    return encodeUtf8ToBase64(JSON.stringify(data));
+};
+const decodeBase64ToJson = (base64) => {
+    return JSON.parse(decodeBase64ToUtf8(base64));
+};
+const generateSaveId = () => {
+    if (typeof crypto !== "undefined" && "randomUUID" in crypto) {
+        return crypto.randomUUID();
+    }
+    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+};
+class GameSaves {
+    namespace;
+    onLoadSaveFileCallback = null;
+    constructor(options) {
+        this.namespace = options?.namespace ?? "sliver-engine";
+    }
+    onLoadSaveFile(callback) {
+        this.onLoadSaveFileCallback = callback;
+        return this;
+    }
+    create(data, options) {
+        const id = options?.id ?? generateSaveId();
+        this.write(id, data, { label: options?.label, createIfMissing: true });
+        return id;
+    }
+    write(id, data, options) {
+        const storage = getLocalStorage();
+        if (!storage) {
+            return;
+        }
+        const now = Date.now();
+        const index = this.readIndex(storage);
+        const existing = index.find((s) => s.id === id);
+        if (!existing && options?.createIfMissing === false) {
+            return;
+        }
+        const createdAt = existing?.createdAt ?? now;
+        const entry = {
+            id,
+            createdAt,
+            updatedAt: now,
+            label: options?.label ?? existing?.label,
+        };
+        const payload = encodeJsonToBase64(data);
+        storage.setItem(this.saveKey(id), payload);
+        const nextIndex = [
+            ...index.filter((s) => s.id !== id),
+            entry,
+        ].sort((a, b) => b.updatedAt - a.updatedAt);
+        this.writeIndex(storage, nextIndex);
+    }
+    read(id) {
+        const storage = getLocalStorage();
+        if (!storage) {
+            return null;
+        }
+        const index = this.readIndex(storage);
+        const entry = index.find((s) => s.id === id);
+        if (!entry) {
+            return null;
+        }
+        const encoded = storage.getItem(this.saveKey(id));
+        if (!encoded) {
+            return null;
+        }
+        try {
+            const data = decodeBase64ToJson(encoded);
+            return { ...entry, data };
+        }
+        catch {
+            return null;
+        }
+    }
+    list() {
+        const storage = getLocalStorage();
+        if (!storage) {
+            return [];
+        }
+        return this.readIndex(storage);
+    }
+    loadAll() {
+        const storage = getLocalStorage();
+        if (!storage) {
+            return [];
+        }
+        const index = this.readIndex(storage);
+        const loaded = [];
+        for (const entry of index) {
+            const encoded = storage.getItem(this.saveKey(entry.id));
+            if (!encoded)
+                continue;
+            try {
+                const data = decodeBase64ToJson(encoded);
+                const save = { ...entry, data };
+                loaded.push(save);
+                this.onLoadSaveFileCallback?.(save);
+            }
+            catch {
+                continue;
+            }
+        }
+        return loaded;
+    }
+    delete(id) {
+        const storage = getLocalStorage();
+        if (!storage) {
+            return;
+        }
+        storage.removeItem(this.saveKey(id));
+        const index = this.readIndex(storage).filter((s) => s.id !== id);
+        this.writeIndex(storage, index);
+    }
+    clear() {
+        const storage = getLocalStorage();
+        if (!storage) {
+            return;
+        }
+        const index = this.readIndex(storage);
+        for (const entry of index) {
+            storage.removeItem(this.saveKey(entry.id));
+        }
+        storage.removeItem(this.indexKey());
+    }
+    indexKey() {
+        return `${this.namespace}:saves:index`;
+    }
+    saveKey(id) {
+        return `${this.namespace}:saves:${id}`;
+    }
+    readIndex(storage) {
+        const raw = storage.getItem(this.indexKey());
+        if (!raw) {
+            return [];
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            if (!Array.isArray(parsed)) {
+                return [];
+            }
+            return parsed
+                .filter((s) => {
+                return (!!s &&
+                    typeof s.id === "string" &&
+                    typeof s.createdAt === "number" &&
+                    typeof s.updatedAt === "number");
+            })
+                .sort((a, b) => b.updatedAt - a.updatedAt);
+        }
+        catch {
+            return [];
+        }
+    }
+    writeIndex(storage, index) {
+        storage.setItem(this.indexKey(), JSON.stringify(index));
+    }
+}
+export { GameSaves };
+//# sourceMappingURL=index.js.map

package/dist/Game/Saves/index.js.map

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

package/dist/Game/index.d.ts

@@ -0,0 +1,45 @@
+import type { CanvasController } from "../CanvasController";
+import type { GameEvent } from "../Events";
+import type { SceneManager } from "../Scenes/SceneManager";
+import { GameContext } from "../Context";
+import { KeyAccumulator } from "../Events";
+import { SoundManager } from "../SoundManager";
+import { GameSaves, type SaveFile } from "./Saves";
+type GameOptions = {
+    canvas: CanvasController;
+    scenes: SceneManager;
+    soundManager: SoundManager;
+    ticksPerSecond?: number;
+    saveNamespace?: string;
+};
+declare class Game {
+    canvas: CanvasController;
+    private scenes;
+    private ticksPerSecond;
+    private lastTickTime;
+    private didSetup;
+    context: GameContext;
+    private keyAccumulator;
+    private eventsDispatcher;
+    saves: GameSaves;
+    constructor({ canvas, scenes, ticksPerSecond, soundManager, saveNamespace, }: GameOptions);
+    setup(): void;
+    onLoadSaveFile(callback: ((save: SaveFile) => void) | null): this;
+    saveGame<T = unknown>(data: T, options?: {
+        label?: string;
+        id?: string;
+    }): string;
+    protected onSetup(): void;
+    start(): void;
+    render(): void;
+    protected onTick(): void;
+    handleEvent(event: GameEvent): void;
+    getContext(): GameContext;
+    getTickRate(): number;
+    getKeyAccumulator(): KeyAccumulator;
+}
+export { Game };
+export type { GameOptions };
+export { GameSaves };
+export type { SaveFile };
+//# sourceMappingURL=index.d.ts.map

package/dist/Game/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Game/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAwB,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnD,KAAK,WAAW,GAAG;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,cAAM,IAAI;IACD,MAAM,EAAE,gBAAgB,CAAC;IAChC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAkB;IAC3B,OAAO,EAAE,WAAW,CAAC;IAC5B,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,gBAAgB,CAAuB;IACxC,KAAK,EAAE,SAAS,CAAC;gBAEZ,EACV,MAAM,EACN,MAAM,EACN,cAAc,EACd,YAAY,EACZ,aAAa,GACd,EAAE,WAAW;IAgBd,KAAK;IAWL,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAKjE,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAOjF,SAAS,CAAC,OAAO,IAAI,IAAI;IAEzB,KAAK;IAyBL,MAAM;IASN,SAAS,CAAC,MAAM,IAAI,IAAI;IAExB,WAAW,CAAC,KAAK,EAAE,SAAS;IAS5B,UAAU,IAAI,WAAW;IAIzB,WAAW,IAAI,MAAM;IAIrB,iBAAiB,IAAI,cAAc;CAGpC;AAED,OAAO,EAAE,IAAI,EAAE,CAAC;AAChB,YAAY,EAAE,WAAW,EAAE,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/Game/index.js

@@ -0,0 +1,101 @@
+import { GameContext } from "../Context";
+import { GameEventsdispatcher, KeyAccumulator } from "../Events";
+import { SoundManager } from "../SoundManager";
+import { GameSaves } from "./Saves";
+class Game {
+    canvas;
+    scenes;
+    ticksPerSecond = 60;
+    lastTickTime = 0;
+    didSetup = false;
+    context;
+    keyAccumulator = new KeyAccumulator();
+    eventsDispatcher;
+    saves;
+    constructor({ canvas, scenes, ticksPerSecond, soundManager, saveNamespace, }) {
+        this.canvas = canvas;
+        this.scenes = scenes;
+        this.ticksPerSecond = ticksPerSecond || this.ticksPerSecond;
+        this.context = new GameContext({
+            game: this,
+            canvas,
+            sceneManager: scenes,
+            keyAccumulator: this.keyAccumulator,
+            soundManager: soundManager,
+        });
+        this.scenes.bindContext(this.context);
+        this.eventsDispatcher = new GameEventsdispatcher(this, this.keyAccumulator);
+        this.saves = new GameSaves({ namespace: saveNamespace });
+    }
+    setup() {
+        if (this.didSetup) {
+            return;
+        }
+        this.didSetup = true;
+        this.saves.loadAll();
+        this.onSetup();
+        console.log("Game setup complete.");
+    }
+    onLoadSaveFile(callback) {
+        this.saves.onLoadSaveFile(callback);
+        return this;
+    }
+    saveGame(data, options) {
+        return this.saves.create(data, options);
+    }
+    // Meant to be overridden by game-specific implementations to inject logic
+    // that should run once during game setup (after save files are loaded).
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    onSetup() { }
+    start() {
+        this.setup();
+        console.log("Game started.");
+        // Tick interval
+        setInterval(() => {
+            const now = performance.now();
+            const tickInterval = 1000 / this.ticksPerSecond;
+            const lastTickTime = this.lastTickTime || 0;
+            if (now - lastTickTime >= tickInterval) {
+                this.onTick();
+                this.scenes.tick();
+                this.lastTickTime = now;
+            }
+        });
+        // Render loop
+        const renderLoop = () => {
+            this.canvas.clearCanvas();
+            this.render();
+            requestAnimationFrame(renderLoop);
+        };
+        requestAnimationFrame(renderLoop);
+    }
+    render() {
+        this.scenes.getActiveScenes().forEach((scene) => {
+            scene.render(this.canvas);
+        });
+    }
+    // Meant to be overridden by game-specific implementations to inject logic
+    // that should run once per tick, before the scenes tick.
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    onTick() { }
+    handleEvent(event) {
+        this.scenes
+            .getActiveScenes()
+            .toReversed()
+            .forEach((scene) => {
+            scene.handleEvent(event);
+        });
+    }
+    getContext() {
+        return this.context;
+    }
+    getTickRate() {
+        return this.ticksPerSecond;
+    }
+    getKeyAccumulator() {
+        return this.keyAccumulator;
+    }
+}
+export { Game };
+export { GameSaves };
+//# sourceMappingURL=index.js.map

package/dist/Game/index.js.map

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

package/dist/GameObject/Decorators/index.d.ts

@@ -0,0 +1,81 @@
+import type { GameObject } from "..";
+import type { Vector } from "../../Lib/Vector";
+type MirroringMode = "horizontal" | "vertical" | "both" | null;
+type AnimationDefinition<TObj extends GameObject> = string[] | ((obj: TObj) => string[]);
+type OptionValue<TObj extends GameObject, TValue> = TValue | ((obj: TObj) => TValue);
+type RenderOptions<TObj extends GameObject> = {
+    when?: OptionValue<TObj, boolean>;
+    scale?: OptionValue<TObj, number>;
+    mirroring?: OptionValue<TObj, MirroringMode>;
+    overridePosition?: OptionValue<TObj, Vector>;
+};
+type TileAnimationOptions<TObj extends GameObject> = RenderOptions<TObj> & {
+    ticksPerFrame: OptionValue<TObj, number>;
+};
+export declare const onColision: <TObj extends GameObject = GameObject>(predicate: (self: TObj, other: GameObject) => boolean, handler: (self: TObj, other: GameObject) => void) => (_target: Object, _propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<(this: TObj, other: GameObject, penetration: Vector) => unknown>) => TypedPropertyDescriptor<(this: TObj, other: GameObject, penetration: Vector) => unknown>;
+/**
+ * Render a sprite definition by name.
+ *
+ * @param spriteDefinitionName - Sprite definition name (or a function returning one).
+ * @param options - Optional render settings.
+ * @param options.when - Render guard; defaults to true.
+ * @param options.scale - Scale multiplier; defaults to 1.
+ * @param options.mirroring - Mirror mode: horizontal, vertical, both, or null.
+ * @param options.overridePosition - Override draw position (defaults to object position).
+ *
+ * @example
+ * @renderSprite("human_down_0", { scale: 2 })
+ * @renderSprite((obj) => obj.spriteName, { mirroring: "horizontal" })
+ */
+export declare const renderSprite: <TObj extends GameObject = GameObject>(spriteDefinitionName: OptionValue<TObj, string>, options?: RenderOptions<TObj>) => (_target: Object, _propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<any>) => TypedPropertyDescriptor<any>;
+/**
+ * Render a single tile from a sprite sheet by index.
+ *
+ * @param spriteSheetName - Sprite sheet name (or a function returning one).
+ * @param index - Frame index (or a function returning one).
+ * @param options - Optional render settings.
+ * @param options.when - Render guard; defaults to true.
+ * @param options.scale - Scale multiplier; defaults to 1.
+ * @param options.mirroring - Mirror mode: horizontal, vertical, both, or null.
+ * @param options.overridePosition - Override draw position (defaults to object position).
+ *
+ * @example
+ * @renderTile("items", 0, { scale: 4 })
+ * @renderTile("hero", (obj) => obj.frame, { when: (obj) => obj.visible })
+ */
+export declare const renderTile: <TObj extends GameObject = GameObject>(spriteSheetName: OptionValue<TObj, string>, index: OptionValue<TObj, number>, options?: RenderOptions<TObj>) => (_target: Object, _propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<any>) => TypedPropertyDescriptor<any>;
+/**
+ * Render a sprite sheet animation by index list.
+ *
+ * @param spriteSheetName - Sprite sheet name (or a function returning one).
+ * @param indexes - Frame index list (or a function returning one).
+ * @param options - Animation + render settings.
+ * @param options.when - Render guard; defaults to true.
+ * @param options.ticksPerFrame - Ticks per frame; required.
+ * @param options.scale - Scale multiplier; defaults to 1.
+ * @param options.mirroring - Mirror mode: horizontal, vertical, both, or null.
+ * @param options.overridePosition - Override draw position (defaults to object position).
+ *
+ * @example
+ * @renderTileAnimation("hero", [0, 1, 2, 3], { ticksPerFrame: 6, scale: 2 })
+ * @renderTileAnimation("hero", (obj) => obj.frames, { ticksPerFrame: 4 })
+ */
+export declare const renderTileAnimation: <TObj extends GameObject = GameObject>(spriteSheetName: OptionValue<TObj, string>, indexes: OptionValue<TObj, number[]>, options: TileAnimationOptions<TObj>) => (_target: Object, _propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<any>) => TypedPropertyDescriptor<any>;
+/**
+ * Render a sprite definition animation by name list.
+ *
+ * @param definitions - Sprite definition names (or a function returning them).
+ * @param options - Animation + render settings.
+ * @param options.when - Render guard; defaults to true.
+ * @param options.ticksPerFrame - Ticks per frame; required.
+ * @param options.scale - Scale multiplier; defaults to 1.
+ * @param options.mirroring - Mirror mode: horizontal, vertical, both, or null.
+ * @param options.overridePosition - Override draw position (defaults to object position).
+ *
+ * @example
+ * @renderSpriteAnimation(["human_down_0", "human_down_1"], { ticksPerFrame: 6 })
+ * @renderSpriteAnimation((obj) => obj.frames, { ticksPerFrame: 4, scale: 2 })
+ */
+export declare const renderSpriteAnimation: <TObj extends GameObject = GameObject>(definitions: AnimationDefinition<TObj>, options: TileAnimationOptions<TObj>) => (_target: Object, _propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<any>) => TypedPropertyDescriptor<any>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/GameObject/Decorators/index.d.ts.map

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

package/dist/GameObject/Decorators/index.js

@@ -0,0 +1,183 @@
+const resolveOption = (value, fallback, obj) => {
+    if (typeof value === "function") {
+        return value(obj);
+    }
+    return value ?? fallback;
+};
+export const onColision = (predicate, handler) => {
+    return function (_target, _propertyKey, descriptor) {
+        const original = descriptor.value;
+        if (!original)
+            return descriptor;
+        descriptor.value = function (other, penetration) {
+            if (predicate(this, other)) {
+                handler(this, other);
+            }
+            return original.call(this, other, penetration);
+        };
+        return descriptor;
+    };
+};
+/**
+ * Render a sprite definition by name.
+ *
+ * @param spriteDefinitionName - Sprite definition name (or a function returning one).
+ * @param options - Optional render settings.
+ * @param options.when - Render guard; defaults to true.
+ * @param options.scale - Scale multiplier; defaults to 1.
+ * @param options.mirroring - Mirror mode: horizontal, vertical, both, or null.
+ * @param options.overridePosition - Override draw position (defaults to object position).
+ *
+ * @example
+ * @renderSprite("human_down_0", { scale: 2 })
+ * @renderSprite((obj) => obj.spriteName, { mirroring: "horizontal" })
+ */
+export const renderSprite = (spriteDefinitionName, options = {}) => {
+    return function (_target, _propertyKey, descriptor) {
+        const original = descriptor.value;
+        if (!original)
+            return descriptor;
+        descriptor.value = function (canvas, scene) {
+            const shouldRender = resolveOption(options.when, true, this);
+            if (!shouldRender) {
+                return original.call(this, canvas, scene);
+            }
+            const spriteLib = canvas.getSpriteLibrary();
+            const context = canvas.getContext();
+            const definitionName = typeof spriteDefinitionName === "function"
+                ? spriteDefinitionName(this)
+                : spriteDefinitionName;
+            const position = resolveOption(options.overridePosition, this.getPosition(), this);
+            const resolvedScale = resolveOption(options.scale, 1, this);
+            const mirroring = resolveOption(options.mirroring, null, this);
+            const mirrorHorizontal = mirroring === "horizontal" || mirroring === "both";
+            const mirrorVertical = mirroring === "vertical" || mirroring === "both";
+            spriteLib.drawSpriteDefinition(context, definitionName, position, resolvedScale, mirrorHorizontal, mirrorVertical);
+            return original.call(this, canvas, scene);
+        };
+        return descriptor;
+    };
+};
+/**
+ * Render a single tile from a sprite sheet by index.
+ *
+ * @param spriteSheetName - Sprite sheet name (or a function returning one).
+ * @param index - Frame index (or a function returning one).
+ * @param options - Optional render settings.
+ * @param options.when - Render guard; defaults to true.
+ * @param options.scale - Scale multiplier; defaults to 1.
+ * @param options.mirroring - Mirror mode: horizontal, vertical, both, or null.
+ * @param options.overridePosition - Override draw position (defaults to object position).
+ *
+ * @example
+ * @renderTile("items", 0, { scale: 4 })
+ * @renderTile("hero", (obj) => obj.frame, { when: (obj) => obj.visible })
+ */
+export const renderTile = (spriteSheetName, index, options = {}) => {
+    return function (_target, _propertyKey, descriptor) {
+        const original = descriptor.value;
+        if (!original)
+            return descriptor;
+        descriptor.value = function (canvas, scene) {
+            const shouldRender = resolveOption(options.when, true, this);
+            if (!shouldRender) {
+                return original.call(this, canvas, scene);
+            }
+            const spriteLib = canvas.getSpriteLibrary();
+            const context = canvas.getContext();
+            const position = resolveOption(options.overridePosition, this.getPosition(), this);
+            const resolvedIndex = resolveOption(index, 0, this);
+            const resolvedScale = resolveOption(options.scale, 1, this);
+            const mirroring = resolveOption(options.mirroring, null, this);
+            spriteLib.drawSpriteFrame(context, resolveOption(spriteSheetName, "", this), resolvedIndex, position, resolvedScale, mirroring === "horizontal" || mirroring === "both", mirroring === "vertical" || mirroring === "both");
+            return original.call(this, canvas, scene);
+        };
+        return descriptor;
+    };
+};
+/**
+ * Render a sprite sheet animation by index list.
+ *
+ * @param spriteSheetName - Sprite sheet name (or a function returning one).
+ * @param indexes - Frame index list (or a function returning one).
+ * @param options - Animation + render settings.
+ * @param options.when - Render guard; defaults to true.
+ * @param options.ticksPerFrame - Ticks per frame; required.
+ * @param options.scale - Scale multiplier; defaults to 1.
+ * @param options.mirroring - Mirror mode: horizontal, vertical, both, or null.
+ * @param options.overridePosition - Override draw position (defaults to object position).
+ *
+ * @example
+ * @renderTileAnimation("hero", [0, 1, 2, 3], { ticksPerFrame: 6, scale: 2 })
+ * @renderTileAnimation("hero", (obj) => obj.frames, { ticksPerFrame: 4 })
+ */
+export const renderTileAnimation = (spriteSheetName, indexes, options) => {
+    return function (_target, _propertyKey, descriptor) {
+        const original = descriptor.value;
+        if (!original)
+            return descriptor;
+        descriptor.value = function (canvas, scene) {
+            const shouldRender = resolveOption(options.when, true, this);
+            if (!shouldRender) {
+                return original.call(this, canvas, scene);
+            }
+            const spriteLib = canvas.getSpriteLibrary();
+            const context = canvas.getContext();
+            const gameContext = this.getContext();
+            const mirroring = resolveOption(options.mirroring, null, this);
+            const ticksPerFrame = resolveOption(options.ticksPerFrame, 1, this);
+            const position = resolveOption(options.overridePosition, this.getPosition(), this);
+            const resolvedScale = resolveOption(options.scale, 1, this);
+            const resolvedIndexes = resolveOption(indexes, [], this);
+            const frameIndex = Math.floor(gameContext.getTickCount() / ticksPerFrame) %
+                resolvedIndexes.length;
+            const spriteIndex = resolvedIndexes[frameIndex];
+            spriteLib.drawSpriteFrame(context, resolveOption(spriteSheetName, "", this), spriteIndex, position, resolvedScale, mirroring === "horizontal" || mirroring === "both", mirroring === "vertical" || mirroring === "both");
+            return original.call(this, canvas, scene);
+        };
+        return descriptor;
+    };
+};
+/**
+ * Render a sprite definition animation by name list.
+ *
+ * @param definitions - Sprite definition names (or a function returning them).
+ * @param options - Animation + render settings.
+ * @param options.when - Render guard; defaults to true.
+ * @param options.ticksPerFrame - Ticks per frame; required.
+ * @param options.scale - Scale multiplier; defaults to 1.
+ * @param options.mirroring - Mirror mode: horizontal, vertical, both, or null.
+ * @param options.overridePosition - Override draw position (defaults to object position).
+ *
+ * @example
+ * @renderSpriteAnimation(["human_down_0", "human_down_1"], { ticksPerFrame: 6 })
+ * @renderSpriteAnimation((obj) => obj.frames, { ticksPerFrame: 4, scale: 2 })
+ */
+export const renderSpriteAnimation = (definitions, options) => {
+    return function (_target, _propertyKey, descriptor) {
+        const original = descriptor.value;
+        if (!original)
+            return descriptor;
+        descriptor.value = function (canvas, scene) {
+            const shouldRender = resolveOption(options.when, true, this);
+            if (!shouldRender) {
+                return original.call(this, canvas, scene);
+            }
+            const spriteLib = canvas.getSpriteLibrary();
+            const context = canvas.getContext();
+            const gameContext = this.getContext();
+            const mirroring = resolveOption(options.mirroring, null, this);
+            const ticksPerFrame = resolveOption(options.ticksPerFrame, 1, this);
+            const position = resolveOption(options.overridePosition, this.getPosition(), this);
+            const resolvedScale = resolveOption(options.scale, 1, this);
+            const resolvedDefinitions = typeof definitions === "function" ? definitions(this) : definitions;
+            const frameIndex = Math.floor(gameContext.getTickCount() / ticksPerFrame) %
+                resolvedDefinitions.length;
+            const definitionName = resolvedDefinitions[frameIndex];
+            spriteLib.drawSpriteDefinition(context, definitionName, position, resolvedScale, mirroring === "horizontal" || mirroring === "both", mirroring === "vertical" || mirroring === "both");
+            return original.call(this, canvas, scene);
+        };
+        return descriptor;
+    };
+};
+//# sourceMappingURL=index.js.map