@almadar/ui 5.49.1 → 5.51.0

package/dist/components/game/organisms/utils/spriteAnimation.d.ts

@@ -7,7 +7,7 @@
  *
  * @packageDocumentation
  */
-import type { AnimationName, FacingDirection, SpriteDirection, ResolvedFrame, UnitAnimationState, SpriteFrameDims, SpriteSheetUrls } from '../types/spriteAnimation';
+import type { AnimationDef, AnimationName, FacingDirection, SpriteDirection, ResolvedFrame, UnitAnimationState, SpriteFrameDims, SpriteSheetUrls } from '../types/spriteAnimation';
 /**
  * Infer facing direction from a movement delta on the isometric grid.
  * dx/dy are tile coordinate deltas (not screen pixels).
@@ -29,6 +29,34 @@ export declare function resolveSheetDirection(facing: FacingDirection): {
     sheetDir: SpriteDirection;
     flipX: boolean;
 };
+/** A source rectangle into a sprite sheet for a single frame. */
+export interface FrameRect {
+    /** Source X in the sheet (pixel offset). */
+    sx: number;
+    /** Source Y in the sheet (pixel offset). */
+    sy: number;
+    /** Source width (frame width). */
+    sw: number;
+    /** Source height (frame height). */
+    sh: number;
+}
+/**
+ * Compute the source rect for a single frame within a grid sprite sheet.
+ * Single home for the `sx = (frame % columns) * frameWidth`, `sy = row * frameHeight`
+ * math shared by `Sprite.tsx`, `useUnitSpriteAtlas.ts`, and `resolveFrame`.
+ *
+ * Pass `row` explicitly for atlas-driven layouts (each animation occupies a row);
+ * pass `row = Math.floor(frame / columns)` for flat frame-index sheets.
+ */
+export declare function frameRect(frame: number, row: number, columns: number, frameWidth: number, frameHeight: number): FrameRect;
+/**
+ * Compute the current frame index from an animation definition.
+ * Atlas-driven and constant-driven callers share this one timing core.
+ */
+export declare function getCurrentFrameFromDef(def: AnimationDef, elapsed: number): {
+    frame: number;
+    finished: boolean;
+};
 /**
  * Compute the current frame index and whether the animation has finished.
  */