@almadar/ui 5.70.0 → 5.72.0

package/dist/components/game/organisms/boardEntity.d.ts

@@ -10,7 +10,7 @@
  *
  * @packageDocumentation
  */
-import type { EntityRow } from '@almadar/core';
+import type { EntityRow, FieldValue } from '@almadar/core';
 /** A 2D grid position read off an entity row. */
 export interface Vec2 {
     x: number;
@@ -27,15 +27,15 @@ export interface TeamUnitTraits {
  *  an array of rows, or undefined. Boards operate on one board state. */
 export declare function boardEntity(entity: EntityRow | readonly EntityRow[] | undefined): EntityRow | undefined;
 /** Coerce a field value to a string (empty string when absent). */
-export declare function str(v: unknown): string;
+export declare function str(v: FieldValue | undefined): string;
 /** Coerce a field value to a number (0 when absent / non-numeric). */
-export declare function num(v: unknown, fallback?: number): number;
+export declare function num(v: FieldValue | undefined, fallback?: number): number;
 /** Coerce a field value to a boolean. */
-export declare function bool(v: unknown): boolean;
+export declare function bool(v: FieldValue | undefined): boolean;
 /** Coerce a nested array field to a readonly array of entity rows. */
-export declare function rows(v: unknown): readonly EntityRow[];
+export declare function rows(v: FieldValue | undefined): readonly EntityRow[];
 /** Read an `{ x, y }` position off an entity row's named field. */
-export declare function vec2(v: unknown): Vec2;
+export declare function vec2(v: FieldValue | undefined): Vec2;
 /** Read a unit row's `position` as a `Vec2`. */
 export declare function unitPosition(u: EntityRow): Vec2;
 /** Read a unit row's `team` ('player' | 'enemy' | string). */

package/dist/components/game/organisms/puzzles/debugger/DebuggerBoard.d.ts

@@ -9,7 +9,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit, EntityRow } from '@almadar/core';
+import type { EventEmit, EntityRow, EntityWith } from '@almadar/core';
 import type { DisplayStateProps } from '../../../../core/organisms/types';
 /** A reviewable code line (UI value DTO read off the entity). */
 export interface DebuggerLine {
@@ -23,7 +23,21 @@ export interface DebuggerBoardProps extends DisplayStateProps {
     /** Puzzle board-state entity (single row or array). The board reads
      *  `lines` array (each with `isFlagged`), `result`, `attempts`, plus
      *  title/description/bugCount/hint off the row. */
-    entity?: EntityRow | readonly EntityRow[];
+    entity?: EntityWith<{
+        lines?: DebuggerLine[];
+        result?: string;
+        attempts?: number;
+        title?: string;
+        description?: string;
+        bugCount?: number;
+        hint?: string;
+        headerImage?: string;
+        theme?: {
+            background?: string;
+            accentColor?: string;
+        };
+        successMessage?: string;
+    }> | readonly EntityRow[];
     completeEvent?: EventEmit<{
         success: boolean;
         attempts: number;

package/dist/components/game/organisms/puzzles/event-handler/puzzleObject.d.ts

@@ -8,14 +8,25 @@
  *
  * @packageDocumentation
  */
-import type { EntityRow } from '@almadar/core';
+import type { EntityWith } from '@almadar/core';
 import type { RuleDefinition, RuleOption } from './RuleEditor';
-export declare function objId(o: EntityRow): string;
-export declare function objName(o: EntityRow): string;
-export declare function objIcon(o: EntityRow): string;
-export declare function objStates(o: EntityRow): string[];
-export declare function objCurrentState(o: EntityRow): string;
-export declare function objAvailableEvents(o: EntityRow): RuleOption[];
-export declare function objAvailableActions(o: EntityRow): RuleOption[];
-export declare function objRules(o: EntityRow): RuleDefinition[];
-export declare function objMaxRules(o: EntityRow): number;
+type PuzzleObjectRow = EntityWith<{
+    name?: string;
+    icon?: string;
+    states?: string[];
+    currentState?: string;
+    availableEvents?: RuleOption[];
+    availableActions?: RuleOption[];
+    rules?: RuleDefinition[];
+    maxRules?: number;
+}>;
+export declare function objId(o: PuzzleObjectRow): string;
+export declare function objName(o: PuzzleObjectRow): string;
+export declare function objIcon(o: PuzzleObjectRow): string;
+export declare function objStates(o: PuzzleObjectRow): string[];
+export declare function objCurrentState(o: PuzzleObjectRow): string;
+export declare function objAvailableEvents(o: PuzzleObjectRow): RuleOption[];
+export declare function objAvailableActions(o: PuzzleObjectRow): RuleOption[];
+export declare function objRules(o: PuzzleObjectRow): RuleDefinition[];
+export declare function objMaxRules(o: PuzzleObjectRow): number;
+export {};

package/dist/components/game/organisms/puzzles/state-architect/StateJsonView.d.ts

@@ -1,7 +1,8 @@
 import React from 'react';
+import { JsonObject } from '@almadar/core';
 export interface StateJsonViewProps {
     /** JSON data to display */
-    data: Record<string, unknown>;
+    data: JsonObject;
     /** Label */
     label?: string;
     /** Whether the code is expanded by default */

package/dist/components/game/organisms/types/isometric.d.ts

@@ -1,4 +1,5 @@
 import type { AssetUrl } from '@almadar/core';
+import type { AnimationName } from './spriteAnimation';
 /**
  * Isometric Game Types
  *
@@ -7,6 +8,17 @@ import type { AssetUrl } from '@almadar/core';
  *
  * @packageDocumentation
  */
+/** An active visual effect on the board. x,y are grid tile coords; ttl = remaining ticks. */
+export interface ActiveEffect {
+    /** Unique key — matched against assetManifest.effects for sprite lookup */
+    key: string;
+    /** Grid x coordinate */
+    x: number;
+    /** Grid y coordinate */
+    y: number;
+    /** Remaining ticks — used as a fade/scale hint (alpha = min(1, ttl/4)) */
+    ttl: number;
+}
 /** A single isometric tile on the grid */
 export interface IsometricTile {
     /** Optional unique identifier (required for 3D rendering) */
@@ -85,6 +97,10 @@ export type IsometricUnit = {
     };
     /** Elevation offset for 3D rendering */
     elevation?: number;
+    /** Animation name — driven by the LOLO state machine; renderer defaults to 'idle' */
+    animation?: AnimationName;
+    /** Frame index within the animation — driven by the LOLO state machine; renderer defaults to 0 */
+    frame?: number;
 };
 /** A map feature (resource, building, portal, etc.) */
 export type IsometricFeature = {