@almadar/core 10.12.0 → 10.14.0

package/dist/{trait-DecHZfpm.d.ts → trait-Ctj2l6ma.d.ts}

@@ -1001,29 +1001,387 @@ declare const GAME_TYPES: readonly ["platformer", "roguelike", "top-down", "puzz
 type GameType = (typeof GAME_TYPES)[number];
 declare const GameTypeSchema: z.ZodEnum<["platformer", "roguelike", "top-down", "puzzle", "racing", "card", "board", "shooter", "rpg"]>;
 /**
- * Animation definition for sprites
+ * Animation names matching a sprite sheet's row layout. Canonical home for
+ * this vocabulary — `@almadar/ui`'s `spriteAnimationTypes.ts` re-exports it
+ * rather than redeclaring, so board `.lolo` config and the render library
+ * agree on one enum.
+ */
+declare const ANIMATION_NAMES: readonly ["idle", "walk", "attack", "hit", "death"];
+type AnimationName = (typeof ANIMATION_NAMES)[number];
+declare const AnimationNameSchema: z.ZodEnum<["idle", "walk", "attack", "hit", "death"]>;
+/** Sheet file directions (physical PNG files a sprite sheet ships as). */
+declare const SPRITE_DIRECTIONS: readonly ["se", "sw"];
+type SpriteDirection = (typeof SPRITE_DIRECTIONS)[number];
+declare const SpriteDirectionSchema: z.ZodEnum<["se", "sw"]>;
+/**
+ * Definition for a single named animation within a sprite sheet: which row
+ * it occupies, how many frames it has, and its playback rate. This is the
+ * shape actually consumed by `@almadar/ui`'s sprite-sheet renderer
+ * (`spriteAnimation.ts`'s `frameRect`/`getCurrentFrameFromDef`) — moved here
+ * verbatim rather than reconciled with a differently-shaped guess, since
+ * `@almadar/ui`'s version is the one with real production consumers.
  */
 interface AnimationDef {
-    /** Frame indices or file names */
-    frames: number[] | string[];
-    /** Frames per second */
-    fps: number;
-    /** Whether animation loops */
+    /** Row index in the sprite sheet (0-based; each animation occupies one row). */
+    row: number;
+    /** Number of frames in this animation. */
+    frames: number;
+    /** Frames per second. */
+    frameRate: number;
+    /** Whether the animation loops. */
     loop: boolean;
 }
 declare const AnimationDefSchema: z.ZodObject<{
-    frames: z.ZodUnion<[z.ZodArray<z.ZodNumber, "many">, z.ZodArray<z.ZodString, "many">]>;
-    fps: z.ZodNumber;
+    row: z.ZodNumber;
+    frames: z.ZodNumber;
+    frameRate: z.ZodNumber;
     loop: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
-    frames: string[] | number[];
-    fps: number;
+    row: number;
+    frames: number;
+    frameRate: number;
     loop: boolean;
 }, {
-    frames: string[] | number[];
-    fps: number;
+    row: number;
+    frames: number;
+    frameRate: number;
     loop: boolean;
 }>;
+/**
+ * Parsed sprite-sheet atlas JSON — the contract a `spriteSheet`-role `Asset.url`
+ * resolves to when fetched (see `Asset.url` usage in `@almadar/ui`'s
+ * `useUnitSpriteAtlas`). A unit's `sprite?: Asset` stays the static single-pose
+ * image; `spriteSheet?: Asset` is a SEPARATE reference whose URL points at a
+ * `SpriteSheetAtlas`-shaped JSON manifest (e.g. `.../guardian-sprite-sheet.json`),
+ * not a PNG. Frame-cutting geometry lives here, not inlined onto `Asset` — an
+ * `Asset` traveling through `render-ui` every tick stays small.
+ */
+interface SpriteSheetAtlas {
+    /** Unit archetype key. */
+    unit?: string;
+    /** Visual type key. */
+    type?: string;
+    /** Width of a single frame in pixels. */
+    frameWidth: number;
+    /** Height of a single frame in pixels. */
+    frameHeight: number;
+    /** Number of columns (frames per row). */
+    columns: number;
+    /** Number of rows (animations). */
+    rows: number;
+    /** Directions present as physical PNG files. */
+    directions: SpriteDirection[];
+    /** Relative PNG sheet paths per direction. */
+    sheets: Partial<Record<SpriteDirection, string>>;
+    /** Animation row layout keyed by animation name. */
+    animations: Partial<Record<AnimationName, AnimationDef>>;
+}
+declare const SpriteSheetAtlasSchema: z.ZodObject<{
+    unit: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    frameWidth: z.ZodNumber;
+    frameHeight: z.ZodNumber;
+    columns: z.ZodNumber;
+    rows: z.ZodNumber;
+    directions: z.ZodArray<z.ZodEnum<["se", "sw"]>, "many">;
+    sheets: z.ZodRecord<z.ZodEnum<["se", "sw"]>, z.ZodString>;
+    animations: z.ZodRecord<z.ZodEnum<["idle", "walk", "attack", "hit", "death"]>, z.ZodObject<{
+        row: z.ZodNumber;
+        frames: z.ZodNumber;
+        frameRate: z.ZodNumber;
+        loop: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        row: number;
+        frames: number;
+        frameRate: number;
+        loop: boolean;
+    }, {
+        row: number;
+        frames: number;
+        frameRate: number;
+        loop: boolean;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    frameWidth: number;
+    frameHeight: number;
+    columns: number;
+    rows: number;
+    directions: ("se" | "sw")[];
+    sheets: Partial<Record<"se" | "sw", string>>;
+    animations: Partial<Record<"idle" | "walk" | "attack" | "hit" | "death", {
+        row: number;
+        frames: number;
+        frameRate: number;
+        loop: boolean;
+    }>>;
+    type?: string | undefined;
+    unit?: string | undefined;
+}, {
+    frameWidth: number;
+    frameHeight: number;
+    columns: number;
+    rows: number;
+    directions: ("se" | "sw")[];
+    sheets: Partial<Record<"se" | "sw", string>>;
+    animations: Partial<Record<"idle" | "walk" | "attack" | "hit" | "death", {
+        row: number;
+        frames: number;
+        frameRate: number;
+        loop: boolean;
+    }>>;
+    type?: string | undefined;
+    unit?: string | undefined;
+}>;
+/**
+ * One named sub-rectangle inside a packed sheet. Mirrors the ShoeBox /
+ * TexturePacker `<SubTexture>` element every Kenney `Spritesheet/*.xml` ships
+ * (`x`/`y`/`width`/`height` = the rect in the sheet PNG; `frameX`/`frameY`/
+ * `frameWidth`/`frameHeight` = the trim/pad offsets for sprites packed with
+ * transparent edges removed — optional, present only on trimmed atlases).
+ */
+interface SubTexture {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    frameX?: number;
+    frameY?: number;
+    frameWidth?: number;
+    frameHeight?: number;
+}
+declare const SubTextureSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    frameX: z.ZodOptional<z.ZodNumber>;
+    frameY: z.ZodOptional<z.ZodNumber>;
+    frameWidth: z.ZodOptional<z.ZodNumber>;
+    frameHeight: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    frameWidth?: number | undefined;
+    frameHeight?: number | undefined;
+    frameX?: number | undefined;
+    frameY?: number | undefined;
+}, {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    frameWidth?: number | undefined;
+    frameHeight?: number | undefined;
+    frameX?: number | undefined;
+    frameY?: number | undefined;
+}>;
+/**
+ * A packed sheet + its named sub-rectangles — the canonical parse target for a
+ * Kenney `Spritesheet/*.xml` atlas. A STATIC tile/prop/UI Asset references one
+ * of these: `{ url: <sheet.png>, atlas: <this.json>, sprite: "grass.png" }` →
+ * the renderer fetches the sheet + atlas ONCE and blits the named sub-rect,
+ * instead of loading N individual PNGs. (Animated actors use `SpriteSheetAtlas`
+ * instead; a uniform-grid tile page uses `Tilesheet`.)
+ */
+interface TextureAtlas {
+    /** Relative path to the sheet PNG the sub-rects index into (the atlas's own `imagePath`). */
+    imagePath: string;
+    /** Sub-rectangles keyed by their atlas name (e.g. `"grass.png"`). */
+    subTextures: Record<string, SubTexture>;
+}
+declare const TextureAtlasSchema: z.ZodObject<{
+    imagePath: z.ZodString;
+    subTextures: z.ZodRecord<z.ZodString, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        frameX: z.ZodOptional<z.ZodNumber>;
+        frameY: z.ZodOptional<z.ZodNumber>;
+        frameWidth: z.ZodOptional<z.ZodNumber>;
+        frameHeight: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        frameWidth?: number | undefined;
+        frameHeight?: number | undefined;
+        frameX?: number | undefined;
+        frameY?: number | undefined;
+    }, {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        frameWidth?: number | undefined;
+        frameHeight?: number | undefined;
+        frameX?: number | undefined;
+        frameY?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    imagePath: string;
+    subTextures: Record<string, {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        frameWidth?: number | undefined;
+        frameHeight?: number | undefined;
+        frameX?: number | undefined;
+        frameY?: number | undefined;
+    }>;
+}, {
+    imagePath: string;
+    subTextures: Record<string, {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        frameWidth?: number | undefined;
+        frameHeight?: number | undefined;
+        frameX?: number | undefined;
+        frameY?: number | undefined;
+    }>;
+}>;
+/**
+ * A uniform-grid tile page — the shape a Kenney `Tilesheet/` sheet takes (e.g.
+ * Pirate Pack: "each tile is 64×64, no margin"). Tiles are cut by `(col,row)`
+ * index rather than by named rect. `names` is present only when a sibling
+ * `.xml`/`.txt` supplies an index→name list; otherwise a tile is addressed by
+ * its `"col,row"` (or flat index) via `Asset.sprite`.
+ */
+interface Tilesheet {
+    /** Relative path to the tile sheet PNG. */
+    imagePath: string;
+    /** Width of one tile cell in pixels. */
+    tileWidth: number;
+    /** Height of one tile cell in pixels. */
+    tileHeight: number;
+    /** Number of columns in the grid. */
+    columns: number;
+    /** Number of rows in the grid. */
+    rows: number;
+    /** Outer margin before the first tile, in pixels (default 0). */
+    margin?: number;
+    /** Gap between adjacent tiles, in pixels (default 0). */
+    spacing?: number;
+    /** Optional index→name labels when a descriptor supplies them. */
+    names?: string[];
+}
+declare const TilesheetSchema: z.ZodObject<{
+    imagePath: z.ZodString;
+    tileWidth: z.ZodNumber;
+    tileHeight: z.ZodNumber;
+    columns: z.ZodNumber;
+    rows: z.ZodNumber;
+    margin: z.ZodOptional<z.ZodNumber>;
+    spacing: z.ZodOptional<z.ZodNumber>;
+    names: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    columns: number;
+    rows: number;
+    imagePath: string;
+    tileWidth: number;
+    tileHeight: number;
+    margin?: number | undefined;
+    spacing?: number | undefined;
+    names?: string[] | undefined;
+}, {
+    columns: number;
+    rows: number;
+    imagePath: string;
+    tileWidth: number;
+    tileHeight: number;
+    margin?: number | undefined;
+    spacing?: number | undefined;
+    names?: string[] | undefined;
+}>;
+/**
+ * The three roles a source pack plays, decided by the systematic per-folder
+ * scan (see `docs/Almadar_Std_Assets.md`):
+ *   - `board-tileset`     — a genre/canvas-matched terrain/level set, often ~1:1 with a board.
+ *   - `character-kit`     — modular layered character parts assembled into one figure.
+ *   - `shared-primitive`  — backgrounds / effects / UI / particles fanned out to many boards.
+ */
+declare const PACK_CLASSES: readonly ["board-tileset", "character-kit", "shared-primitive"];
+type PackClass = (typeof PACK_CLASSES)[number];
+declare const PackClassSchema: z.ZodEnum<["board-tileset", "character-kit", "shared-primitive"]>;
+/**
+ * A modular character-kit layer: one selectable part (`head`/`hair`/`shirt`/…)
+ * resolved to a sub-texture ref. Recorded now so the analysis can RECOGNIZE
+ * modular packs; the layered compositor that stacks these is a later follow-up.
+ */
+interface CharacterKitLayer {
+    /** Which body slot this layer fills. */
+    slot: 'body' | 'head' | 'face' | 'hair' | 'facialHair' | 'shirt' | 'pants' | 'shoes' | 'accessory';
+    /** Sheet PNG the part lives on. */
+    url: AssetUrl;
+    /** Atlas JSON next to the sheet. */
+    atlas?: AssetUrl;
+    /** Sub-texture name within the atlas. */
+    sprite?: string;
+}
+declare const CharacterKitLayerSchema: z.ZodObject<{
+    slot: z.ZodEnum<["body", "head", "face", "hair", "facialHair", "shirt", "pants", "shoes", "accessory"]>;
+    url: z.ZodString;
+    atlas: z.ZodOptional<z.ZodString>;
+    sprite: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    slot: "body" | "head" | "face" | "hair" | "facialHair" | "shirt" | "pants" | "shoes" | "accessory";
+    url: string;
+    atlas?: string | undefined;
+    sprite?: string | undefined;
+}, {
+    slot: "body" | "head" | "face" | "hair" | "facialHair" | "shirt" | "pants" | "shoes" | "accessory";
+    url: string;
+    atlas?: string | undefined;
+    sprite?: string | undefined;
+}>;
+/** A recognized modular-character pack: an ordered, back-to-front layer stack. */
+interface CharacterKit {
+    /** Source pack slug the kit came from. */
+    pack: string;
+    /** Layers in back-to-front draw order. */
+    layers: CharacterKitLayer[];
+}
+declare const CharacterKitSchema: z.ZodObject<{
+    pack: z.ZodString;
+    layers: z.ZodArray<z.ZodObject<{
+        slot: z.ZodEnum<["body", "head", "face", "hair", "facialHair", "shirt", "pants", "shoes", "accessory"]>;
+        url: z.ZodString;
+        atlas: z.ZodOptional<z.ZodString>;
+        sprite: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        slot: "body" | "head" | "face" | "hair" | "facialHair" | "shirt" | "pants" | "shoes" | "accessory";
+        url: string;
+        atlas?: string | undefined;
+        sprite?: string | undefined;
+    }, {
+        slot: "body" | "head" | "face" | "hair" | "facialHair" | "shirt" | "pants" | "shoes" | "accessory";
+        url: string;
+        atlas?: string | undefined;
+        sprite?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    pack: string;
+    layers: {
+        slot: "body" | "head" | "face" | "hair" | "facialHair" | "shirt" | "pants" | "shoes" | "accessory";
+        url: string;
+        atlas?: string | undefined;
+        sprite?: string | undefined;
+    }[];
+}, {
+    pack: string;
+    layers: {
+        slot: "body" | "head" | "face" | "hair" | "facialHair" | "shirt" | "pants" | "shoes" | "accessory";
+        url: string;
+        atlas?: string | undefined;
+        sprite?: string | undefined;
+    }[];
+}>;
 /**
  * Semantic reference to an asset (not a hardcoded path).
  * Resolved to actual paths at compile time via asset maps.
@@ -1078,8 +1436,21 @@ declare const SemanticAssetRefSchema: z.ZodObject<{
  * pixel-dimension or filename heuristics needed to know sheet-vs-frame / 2d-vs-3d).
  */
 interface Asset extends SemanticAssetRef {
-    /** The resolved asset URL. */
+    /** The resolved asset URL. When `atlas`/`sprite` are set this is the SHEET png; otherwise a standalone image. */
     url: AssetUrl;
+    /**
+     * Optional atlas JSON (a `TextureAtlas` or `Tilesheet`) that slices `url`.
+     * When present with `sprite`, the renderer fetches sheet + atlas once and
+     * blits one sub-rect instead of loading a standalone PNG. Absent → `url` is
+     * a plain whole-image asset (the existing, non-atlas path).
+     */
+    atlas?: AssetUrl;
+    /**
+     * The sub-texture selector within `atlas`: a `SubTexture` name for a
+     * `TextureAtlas` (e.g. `"grass.png"`), or a `"col,row"`/flat index for a
+     * `Tilesheet`. Only meaningful alongside `atlas`.
+     */
+    sprite?: string;
     /** Optional display name (inspector picker). */
     name?: string;
     /** Optional thumbnail URL (inspector picker grid). */
@@ -1095,6 +1466,8 @@ declare const AssetSchema: z.ZodObject<{
     aspect: z.ZodOptional<z.ZodEnum<["1:1", "16:9", "5:7", "8:1"]>>;
 } & {
     url: z.ZodString;
+    atlas: z.ZodOptional<z.ZodString>;
+    sprite: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
     thumbnailUrl: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -1103,6 +1476,8 @@ declare const AssetSchema: z.ZodObject<{
     category: string;
     name?: string | undefined;
     animations?: string[] | undefined;
+    atlas?: string | undefined;
+    sprite?: string | undefined;
     style?: "pixel" | "vector" | "hd" | "1-bit" | "isometric" | undefined;
     variant?: string | undefined;
     dimension?: "2d" | "3d" | undefined;
@@ -1114,6 +1489,8 @@ declare const AssetSchema: z.ZodObject<{
     category: string;
     name?: string | undefined;
     animations?: string[] | undefined;
+    atlas?: string | undefined;
+    sprite?: string | undefined;
     style?: "pixel" | "vector" | "hd" | "1-bit" | "isometric" | undefined;
     variant?: string | undefined;
     dimension?: "2d" | "3d" | undefined;
@@ -1144,24 +1521,28 @@ declare const ResolvedAssetSchema: z.ZodObject<{
     tileSize: z.ZodOptional<z.ZodNumber>;
     files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     animations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        frames: z.ZodUnion<[z.ZodArray<z.ZodNumber, "many">, z.ZodArray<z.ZodString, "many">]>;
-        fps: z.ZodNumber;
+        row: z.ZodNumber;
+        frames: z.ZodNumber;
+        frameRate: z.ZodNumber;
         loop: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        frames: string[] | number[];
-        fps: number;
+        row: number;
+        frames: number;
+        frameRate: number;
         loop: boolean;
     }, {
-        frames: string[] | number[];
-        fps: number;
+        row: number;
+        frames: number;
+        frameRate: number;
         loop: boolean;
     }>>>;
 }, "strip", z.ZodTypeAny, {
     path: string;
     basePath: string;
     animations?: Record<string, {
-        frames: string[] | number[];
-        fps: number;
+        row: number;
+        frames: number;
+        frameRate: number;
         loop: boolean;
     }> | undefined;
     tiles?: number[] | undefined;
@@ -1171,8 +1552,9 @@ declare const ResolvedAssetSchema: z.ZodObject<{
     path: string;
     basePath: string;
     animations?: Record<string, {
-        frames: string[] | number[];
-        fps: number;
+        row: number;
+        frames: number;
+        frameRate: number;
         loop: boolean;
     }> | undefined;
     tiles?: number[] | undefined;
@@ -1200,23 +1582,27 @@ declare const AssetMappingSchema: z.ZodObject<{
     tileSize: z.ZodOptional<z.ZodNumber>;
     files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     animations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        frames: z.ZodUnion<[z.ZodArray<z.ZodNumber, "many">, z.ZodArray<z.ZodString, "many">]>;
-        fps: z.ZodNumber;
+        row: z.ZodNumber;
+        frames: z.ZodNumber;
+        frameRate: z.ZodNumber;
         loop: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        frames: string[] | number[];
-        fps: number;
+        row: number;
+        frames: number;
+        frameRate: number;
         loop: boolean;
     }, {
-        frames: string[] | number[];
-        fps: number;
+        row: number;
+        frames: number;
+        frameRate: number;
         loop: boolean;
     }>>>;
 }, "strip", z.ZodTypeAny, {
     path: string;
     animations?: Record<string, {
-        frames: string[] | number[];
-        fps: number;
+        row: number;
+        frames: number;
+        frameRate: number;
         loop: boolean;
     }> | undefined;
     tiles?: number[] | undefined;
@@ -1225,8 +1611,9 @@ declare const AssetMappingSchema: z.ZodObject<{
 }, {
     path: string;
     animations?: Record<string, {
-        frames: string[] | number[];
-        fps: number;
+        row: number;
+        frames: number;
+        frameRate: number;
         loop: boolean;
     }> | undefined;
     tiles?: number[] | undefined;
@@ -1257,23 +1644,27 @@ declare const AssetMapSchema: z.ZodObject<{
         tileSize: z.ZodOptional<z.ZodNumber>;
         files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         animations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-            frames: z.ZodUnion<[z.ZodArray<z.ZodNumber, "many">, z.ZodArray<z.ZodString, "many">]>;
-            fps: z.ZodNumber;
+            row: z.ZodNumber;
+            frames: z.ZodNumber;
+            frameRate: z.ZodNumber;
             loop: z.ZodBoolean;
         }, "strip", z.ZodTypeAny, {
-            frames: string[] | number[];
-            fps: number;
+            row: number;
+            frames: number;
+            frameRate: number;
             loop: boolean;
         }, {
-            frames: string[] | number[];
-            fps: number;
+            row: number;
+            frames: number;
+            frameRate: number;
             loop: boolean;
         }>>>;
     }, "strip", z.ZodTypeAny, {
         path: string;
         animations?: Record<string, {
-            frames: string[] | number[];
-            fps: number;
+            row: number;
+            frames: number;
+            frameRate: number;
             loop: boolean;
         }> | undefined;
         tiles?: number[] | undefined;
@@ -1282,8 +1673,9 @@ declare const AssetMapSchema: z.ZodObject<{
     }, {
         path: string;
         animations?: Record<string, {
-            frames: string[] | number[];
-            fps: number;
+            row: number;
+            frames: number;
+            frameRate: number;
             loop: boolean;
         }> | undefined;
         tiles?: number[] | undefined;
@@ -1297,8 +1689,9 @@ declare const AssetMapSchema: z.ZodObject<{
     mappings: Record<string, {
         path: string;
         animations?: Record<string, {
-            frames: string[] | number[];
-            fps: number;
+            row: number;
+            frames: number;
+            frameRate: number;
             loop: boolean;
         }> | undefined;
         tiles?: number[] | undefined;
@@ -1312,8 +1705,9 @@ declare const AssetMapSchema: z.ZodObject<{
     mappings: Record<string, {
         path: string;
         animations?: Record<string, {
-            frames: string[] | number[];
-            fps: number;
+            row: number;
+            frames: number;
+            frameRate: number;
             loop: boolean;
         }> | undefined;
         tiles?: number[] | undefined;
@@ -1414,6 +1808,7 @@ type AssetMappingInput = z.input<typeof AssetMappingSchema>;
 type AssetMapInput = z.input<typeof AssetMapSchema>;
 type AnimationDefInput = z.input<typeof AnimationDefSchema>;
 type AssetCatalogEntryInput = z.input<typeof AssetCatalogEntrySchema>;
+type SpriteSheetAtlasInput = z.input<typeof SpriteSheetAtlasSchema>;
 /**
  * Creates a semantic asset key from role and category.
  *
@@ -6435,4 +6830,4 @@ declare const OrbitalTraitRefSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
     } | undefined;
 }>]>;
 
-export { ConfigFieldDeclarationSchema as $, ASSET_ASPECTS as A, type AssetCatalogEntry as B, type CallSiteConfig as C, type AssetCatalogEntryInput as D, type Effect as E, AssetCatalogEntrySchema as F, AssetCatalogSchema as G, type AssetDimension as H, AssetDimensionSchema as I, type AssetMap as J, type AssetMapInput as K, AssetMapSchema as L, type AssetMapping as M, type AssetMappingInput as N, AssetMappingSchema as O, AssetSchema as P, type AssetUrl as Q, type RenderBinding as R, type ServiceRef as S, type TraitConfig as T, type UISlot as U, type AtomicEffect as V, type CallServiceConfig as W, type CallServiceEffect as X, type CallSiteConfigEntry as Y, type CheckpointLoadEffect as Z, type CheckpointSaveEffect as _, type Trait as a, PayloadFieldSchema as a$, type DeclaredTraitConfig as a0, DeclaredTraitConfigSchema as a1, type DerefEffect as a2, type DespawnEffect as a3, type DoEffect as a4, ENTITY_ROLES as a5, type EffectInput as a6, EffectSchema as a7, type EmitConfig as a8, type EmitEffect as a9, type FieldType as aA, FieldTypeSchema as aB, type FieldValue as aC, type ForwardConfig as aD, type ForwardEffect as aE, GAME_TYPES as aF, type GameType as aG, GameTypeSchema as aH, type Guard as aI, type GuardInput as aJ, GuardSchema as aK, type ListenSource as aL, ListenSourceSchema as aM, type LogEffect as aN, type McpServiceDef as aO, McpServiceDefSchema as aP, type NavigateEffect as aQ, type NnConfig as aR, type NnLayer as aS, type NotifyEffect as aT, type OrbitalEntity as aU, type OrbitalEntityInput as aV, OrbitalEntitySchema as aW, type OrbitalTraitRef as aX, OrbitalTraitRefSchema as aY, type OsEffect as aZ, type PayloadField as a_, type EntityData as aa, type EntityFieldContract as ab, EntityFieldContractSchema as ac, type EntityFieldInput as ad, EntityFieldSchema as ae, EntityPersistenceSchema as af, type EntityRole as ag, EntityRoleSchema as ah, EntitySchema as ai, type EntityWith as aj, type EnumEntityField as ak, type EvaluateConfig as al, type EvaluateEffect as am, type Event as an, type EventInput as ao, EventPayloadFieldSchema as ap, EventSchema as aq, type EventScope as ar, EventScopeSchema as as, type FetchEffect as at, type FetchOptions as au, type FetchResult as av, type Field as aw, type FieldFormat as ax, FieldFormatSchema as ay, FieldSchema as az, type RenderUIEffect as b, TraitSchema as b$, type PersistData as b0, type PersistEffect as b1, type PersistEmitConfig as b2, type PresentationType as b3, type RefEffect as b4, RelationConfigSchema as b5, type RelationEntityField as b6, type RenderItemLambda as b7, type RenderUIConfig as b8, type RenderUINode as b9, SocketEventsSchema as bA, type SocketServiceDef as bB, SocketServiceDefSchema as bC, type SpawnEffect as bD, type StateInput as bE, type StateMachine as bF, type StateMachineInput as bG, StateMachineSchema as bH, StateSchema as bI, type SwapEffect as bJ, type TrainConfig as bK, type TrainEffect as bL, type TraitCategory as bM, TraitCategorySchema as bN, TraitConfigSchema as bO, type TraitConfigValue as bP, TraitConfigValueSchema as bQ, type TraitDataEntity as bR, TraitDataEntitySchema as bS, type TraitEntityField as bT, TraitEntityFieldSchema as bU, TraitEventContractSchema as bV, TraitEventListenerSchema as bW, type TraitInput as bX, TraitRefSchema as bY, type TraitReferenceInput as bZ, TraitReferenceSchema as b_, type RequiredField as ba, RequiredFieldSchema as bb, type ResolvedAsset as bc, type ResolvedAssetInput as bd, ResolvedAssetSchema as be, type ResolvedPatternProps as bf, type RestAuthConfig as bg, RestAuthConfigSchema as bh, type RestServiceDef as bi, RestServiceDefSchema as bj, SERVICE_TYPES as bk, type ScalarEntityField as bl, type SemanticAssetRef as bm, type SemanticAssetRefInput as bn, SemanticAssetRefSchema as bo, ServiceDefinitionSchema as bp, type ServiceParams as bq, type ServiceParamsValue as br, type ServiceRefObject as bs, ServiceRefObjectSchema as bt, ServiceRefSchema as bu, ServiceRefStringSchema as bv, type ServiceType as bw, ServiceTypeSchema as bx, type SetEffect as by, type SocketEvents as bz, type TraitEventContract as c, type TraitTick as c0, TraitTickSchema as c1, type TraitUIBinding as c2, type Transition as c3, type TransitionInput as c4, TransitionSchema as c5, type TypedEffect as c6, UISlotSchema as c7, UI_SLOTS as c8, VISUAL_STYLES as c9, isServiceReference as cA, isServiceReferenceObject as cB, isSingletonEntity as cC, isSocketService as cD, navigate as cE, normalizeTraitRef as cF, notify as cG, parseAssetKey as cH, parseServiceRef as cI, persist as cJ, persistenceModeAllowsOverrides as cK, ref as cL, renderUI as cM, set as cN, spawn as cO, swap as cP, validateAssetAnimations as cQ, watch as cR, type TraitScope as cS, type VisualStyle as ca, VisualStyleSchema as cb, type WatchEffect as cc, type WatchOptions as cd, atomic as ce, callService as cf, createAssetKey as cg, deref as ch, deriveCollection as ci, despawn as cj, doEffects as ck, emit as cl, findService as cm, getDefaultAnimationsForRole as cn, getServiceNames as co, getTraitConfig as cp, getTraitName as cq, hasService as cr, isCallSiteConfigDeclaration as cs, isCircuitEvent as ct, isEffect as cu, isInlineTrait as cv, isMcpService as cw, isRestService as cx, isRuntimeEntity as cy, isSExprEffect as cz, type Entity as d, type TraitEventListener as e, type EntityField as f, type EntityPersistence as g, type EntityRow as h, type TraitRef as i, type TraitReference as j, type RelationConfig as k, type TraitConfigObject as l, type EventPayloadField as m, type ConfigFieldDeclaration as n, type ServiceDefinition as o, type State as p, ASSET_DIMENSIONS as q, type AgentEffect as r, type AnimationDef as s, type AnimationDefInput as t, AnimationDefSchema as u, type ArrayEntityField as v, type Asset as w, type AssetAspect as x, AssetAspectSchema as y, type AssetCatalog as z };
+export { type CallSiteConfigEntry as $, ANIMATION_NAMES as A, type AssetAspect as B, type CallSiteConfig as C, AssetAspectSchema as D, type Effect as E, type AssetCatalog as F, type AssetCatalogEntry as G, type AssetCatalogEntryInput as H, AssetCatalogEntrySchema as I, AssetCatalogSchema as J, type AssetDimension as K, AssetDimensionSchema as L, type AssetMap as M, type AssetMapInput as N, AssetMapSchema as O, type AssetMapping as P, type AssetMappingInput as Q, type RenderBinding as R, type ServiceRef as S, type TraitConfig as T, type UISlot as U, AssetMappingSchema as V, AssetSchema as W, type AssetUrl as X, type AtomicEffect as Y, type CallServiceConfig as Z, type CallServiceEffect as _, type Trait as a, type OrbitalEntity as a$, type CharacterKit as a0, type CharacterKitLayer as a1, CharacterKitLayerSchema as a2, CharacterKitSchema as a3, type CheckpointLoadEffect as a4, type CheckpointSaveEffect as a5, ConfigFieldDeclarationSchema as a6, type DeclaredTraitConfig as a7, DeclaredTraitConfigSchema as a8, type DerefEffect as a9, type FetchEffect as aA, type FetchOptions as aB, type FetchResult as aC, type Field as aD, type FieldFormat as aE, FieldFormatSchema as aF, FieldSchema as aG, type FieldType as aH, FieldTypeSchema as aI, type FieldValue as aJ, type ForwardConfig as aK, type ForwardEffect as aL, GAME_TYPES as aM, type GameType as aN, GameTypeSchema as aO, type Guard as aP, type GuardInput as aQ, GuardSchema as aR, type ListenSource as aS, ListenSourceSchema as aT, type LogEffect as aU, type McpServiceDef as aV, McpServiceDefSchema as aW, type NavigateEffect as aX, type NnConfig as aY, type NnLayer as aZ, type NotifyEffect as a_, type DespawnEffect as aa, type DoEffect as ab, ENTITY_ROLES as ac, type EffectInput as ad, EffectSchema as ae, type EmitConfig as af, type EmitEffect as ag, type EntityData as ah, type EntityFieldContract as ai, EntityFieldContractSchema as aj, type EntityFieldInput as ak, EntityFieldSchema as al, EntityPersistenceSchema as am, type EntityRole as an, EntityRoleSchema as ao, EntitySchema as ap, type EntityWith as aq, type EnumEntityField as ar, type EvaluateConfig as as, type EvaluateEffect as at, type Event as au, type EventInput as av, EventPayloadFieldSchema as aw, EventSchema as ax, type EventScope as ay, EventScopeSchema as az, type RenderUIEffect as b, type SwapEffect as b$, type OrbitalEntityInput as b0, OrbitalEntitySchema as b1, type OrbitalTraitRef as b2, OrbitalTraitRefSchema as b3, type OsEffect as b4, PACK_CLASSES as b5, type PackClass as b6, PackClassSchema as b7, type PayloadField as b8, PayloadFieldSchema as b9, ServiceDefinitionSchema as bA, type ServiceParams as bB, type ServiceParamsValue as bC, type ServiceRefObject as bD, ServiceRefObjectSchema as bE, ServiceRefSchema as bF, ServiceRefStringSchema as bG, type ServiceType as bH, ServiceTypeSchema as bI, type SetEffect as bJ, type SocketEvents as bK, SocketEventsSchema as bL, type SocketServiceDef as bM, SocketServiceDefSchema as bN, type SpawnEffect as bO, type SpriteDirection as bP, SpriteDirectionSchema as bQ, type SpriteSheetAtlas as bR, type SpriteSheetAtlasInput as bS, SpriteSheetAtlasSchema as bT, type StateInput as bU, type StateMachine as bV, type StateMachineInput as bW, StateMachineSchema as bX, StateSchema as bY, type SubTexture as bZ, SubTextureSchema as b_, type PersistData as ba, type PersistEffect as bb, type PersistEmitConfig as bc, type PresentationType as bd, type RefEffect as be, RelationConfigSchema as bf, type RelationEntityField as bg, type RenderItemLambda as bh, type RenderUIConfig as bi, type RenderUINode as bj, type RequiredField as bk, RequiredFieldSchema as bl, type ResolvedAsset as bm, type ResolvedAssetInput as bn, ResolvedAssetSchema as bo, type ResolvedPatternProps as bp, type RestAuthConfig as bq, RestAuthConfigSchema as br, type RestServiceDef as bs, RestServiceDefSchema as bt, SERVICE_TYPES as bu, SPRITE_DIRECTIONS as bv, type ScalarEntityField as bw, type SemanticAssetRef as bx, type SemanticAssetRefInput as by, SemanticAssetRefSchema as bz, type TraitEventContract as c, normalizeTraitRef as c$, type TextureAtlas as c0, TextureAtlasSchema as c1, type Tilesheet as c2, TilesheetSchema as c3, type TrainConfig as c4, type TrainEffect as c5, type TraitCategory as c6, TraitCategorySchema as c7, TraitConfigSchema as c8, type TraitConfigValue as c9, atomic as cA, callService as cB, createAssetKey as cC, deref as cD, deriveCollection as cE, despawn as cF, doEffects as cG, emit as cH, findService as cI, getDefaultAnimationsForRole as cJ, getServiceNames as cK, getTraitConfig as cL, getTraitName as cM, hasService as cN, isCallSiteConfigDeclaration as cO, isCircuitEvent as cP, isEffect as cQ, isInlineTrait as cR, isMcpService as cS, isRestService as cT, isRuntimeEntity as cU, isSExprEffect as cV, isServiceReference as cW, isServiceReferenceObject as cX, isSingletonEntity as cY, isSocketService as cZ, navigate as c_, TraitConfigValueSchema as ca, type TraitDataEntity as cb, TraitDataEntitySchema as cc, type TraitEntityField as cd, TraitEntityFieldSchema as ce, TraitEventContractSchema as cf, TraitEventListenerSchema as cg, type TraitInput as ch, TraitRefSchema as ci, type TraitReferenceInput as cj, TraitReferenceSchema as ck, TraitSchema as cl, type TraitTick as cm, TraitTickSchema as cn, type TraitUIBinding as co, type Transition as cp, type TransitionInput as cq, TransitionSchema as cr, type TypedEffect as cs, UISlotSchema as ct, UI_SLOTS as cu, VISUAL_STYLES as cv, type VisualStyle as cw, VisualStyleSchema as cx, type WatchEffect as cy, type WatchOptions as cz, type Entity as d, notify as d0, parseAssetKey as d1, parseServiceRef as d2, persist as d3, persistenceModeAllowsOverrides as d4, ref as d5, renderUI as d6, set as d7, spawn as d8, swap as d9, validateAssetAnimations as da, watch as db, type TraitScope as dc, type TraitEventListener as e, type EntityField as f, type EntityPersistence as g, type EntityRow as h, type TraitRef as i, type TraitReference as j, type RelationConfig as k, type TraitConfigObject as l, type EventPayloadField as m, type ConfigFieldDeclaration as n, type ServiceDefinition as o, type State as p, ASSET_ASPECTS as q, ASSET_DIMENSIONS as r, type AgentEffect as s, type AnimationDef as t, type AnimationDefInput as u, AnimationDefSchema as v, type AnimationName as w, AnimationNameSchema as x, type ArrayEntityField as y, type Asset as z };