@almadar/ui 5.69.0 → 5.71.0

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

@@ -1,34 +1,36 @@
 import React from 'react';
 import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
 import type { DisplayStateProps } from '../../core/organisms/types';
+import type { IsometricCanvasProps } from '../molecules/IsometricCanvas';
 export interface HolidayRunnerBoardProps extends DisplayStateProps {
-    /** Background image URL for the runner level */
-    backgroundImage?: AssetUrl;
-    /** Base URL prefix for asset URLs */
+    /** Ground/sky terrain tiles for the side-scroll strip */
+    tiles?: IsometricTile[];
+    /** Runner and obstacle units on the board */
+    units?: IsometricUnit[];
+    /** Features (gifts, obstacles, etc.) on the board */
+    features?: IsometricFeature[];
+    /** Asset sprite manifest (same shape as IsometricCanvas.assetManifest) */
+    assetManifest?: IsometricCanvasProps['assetManifest'];
+    /** Base URL prepended to manifest sprite paths */
     assetBaseUrl?: AssetUrl;
-    /** Canvas width in pixels */
-    width?: number;
-    /** Canvas height in pixels */
-    height?: number;
-    /** Target frames per second */
-    fps?: number;
     /** Render scale */
     scale?: number;
     /** Show minimap overlay */
     showMinimap?: boolean;
     /** Enable camera pan/zoom controls */
     enableCamera?: boolean;
-    /** Declarative event: emits UI:{tickEvent} with { dt, frame } each tick */
-    tickEvent?: EventEmit<{
-        dt: number;
-        frame: number;
+    /** Declarative event: emits UI:{tileClickEvent} with { x, y } on tile click */
+    tileClickEvent?: EventEmit<{
+        x: number;
+        y: number;
     }>;
-    /** Declarative event: emits UI:{drawEvent} with { frame } each draw frame */
-    drawEvent?: EventEmit<{
-        frame: number;
+    /** Declarative event: emits UI:{unitClickEvent} with { unitId } on unit click */
+    unitClickEvent?: EventEmit<{
+        unitId: string;
     }>;
 }
-export declare function HolidayRunnerBoard({ backgroundImage, assetBaseUrl, width, height, fps, isLoading, error, className, }: HolidayRunnerBoardProps): React.ReactElement;
+export declare function HolidayRunnerBoard({ tiles, units, features, assetManifest, assetBaseUrl, scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: HolidayRunnerBoardProps): React.ReactElement;
 export declare namespace HolidayRunnerBoard {
     var displayName: string;
 }

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

@@ -1,13 +1,13 @@
 import React from 'react';
-import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
 import type { DisplayStateProps } from '../../core/organisms/types';
 export interface PinballBoardProps extends DisplayStateProps {
     /** Playfield tiles */
-    tiles?: unknown[];
+    tiles?: readonly EntityRow[];
     /** Ball units on the board */
-    units?: unknown[];
+    units?: readonly EntityRow[];
     /** Features (bumpers, paddles, etc.) on the board */
-    features?: unknown[];
+    features?: readonly EntityRow[];
     /** Asset sprite manifest */
     assetManifest?: string;
     /** Base URL prepended to manifest sprite paths */

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

@@ -1,28 +1,36 @@
 import React from 'react';
 import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
 import type { DisplayStateProps } from '../../core/organisms/types';
+import type { IsometricCanvasProps } from '../molecules/IsometricCanvas';
 export interface RacingBoardProps extends DisplayStateProps {
-    /** Race track background image URL */
-    backgroundImage?: AssetUrl;
-    /** Base URL prepended to asset paths */
+    /** Road + grass terrain tiles forming the race circuit */
+    tiles?: IsometricTile[];
+    /** Car units on the track */
+    units?: IsometricUnit[];
+    /** Track features (pit lane markers, start/finish line, etc.) */
+    features?: IsometricFeature[];
+    /** Asset sprite manifest (same shape as IsometricCanvas.assetManifest) */
+    assetManifest?: IsometricCanvasProps['assetManifest'];
+    /** Base URL prepended to manifest sprite paths */
     assetBaseUrl?: AssetUrl;
-    /** Canvas width in pixels */
-    width?: number;
-    /** Canvas height in pixels */
-    height?: number;
-    /** Target frames per second */
-    fps?: number;
-    /** Declarative event: emits UI:{tickEvent} with { dt, frame } each tick */
-    tickEvent?: EventEmit<{
-        dt: number;
-        frame: number;
+    /** Render scale */
+    scale?: number;
+    /** Show minimap overlay */
+    showMinimap?: boolean;
+    /** Enable camera pan/zoom controls */
+    enableCamera?: boolean;
+    /** Declarative event: emits UI:{tileClickEvent} with { x, y } on tile click */
+    tileClickEvent?: EventEmit<{
+        x: number;
+        y: number;
     }>;
-    /** Declarative event: emits UI:{drawEvent} with { frame } each draw frame */
-    drawEvent?: EventEmit<{
-        frame: number;
+    /** Declarative event: emits UI:{unitClickEvent} with { unitId } on unit click */
+    unitClickEvent?: EventEmit<{
+        unitId: string;
     }>;
 }
-export declare function RacingBoard({ backgroundImage, assetBaseUrl, width, height, fps, tickEvent, drawEvent, className, }: RacingBoardProps): React.ReactElement;
+export declare function RacingBoard({ tiles, units, features, assetManifest, assetBaseUrl, scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: RacingBoardProps): React.ReactElement;
 export declare namespace RacingBoard {
     var displayName: string;
 }

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

@@ -1,19 +1,36 @@
 import React from 'react';
-import type { AssetUrl } from '@almadar/core';
+import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
 import type { DisplayStateProps } from '../../core/organisms/types';
+import type { IsometricCanvasProps } from '../molecules/IsometricCanvas';
 export interface SpaceShmupBoardProps extends DisplayStateProps {
-    /** Background image URL (starfield / space scene) */
-    backgroundImage?: AssetUrl;
-    /** Base URL prefix for asset URLs */
+    /** Space terrain tiles filling the grid */
+    tiles?: IsometricTile[];
+    /** Player ship and enemy ships on the board */
+    units?: IsometricUnit[];
+    /** Features (asteroids, power-ups, etc.) on the board */
+    features?: IsometricFeature[];
+    /** Asset sprite manifest (same shape as IsometricCanvas.assetManifest) */
+    assetManifest?: IsometricCanvasProps['assetManifest'];
+    /** Base URL prepended to manifest sprite paths */
     assetBaseUrl?: AssetUrl;
-    /** Canvas width in pixels */
-    width?: number;
-    /** Canvas height in pixels */
-    height?: number;
-    /** Target frames per second */
-    fps?: number;
+    /** Render scale */
+    scale?: number;
+    /** Show minimap overlay */
+    showMinimap?: boolean;
+    /** Enable camera pan/zoom controls */
+    enableCamera?: boolean;
+    /** Declarative event: emits UI:{tileClickEvent} with { x, y } on tile click */
+    tileClickEvent?: EventEmit<{
+        x: number;
+        y: number;
+    }>;
+    /** Declarative event: emits UI:{unitClickEvent} with { unitId } on unit click */
+    unitClickEvent?: EventEmit<{
+        unitId: string;
+    }>;
 }
-export declare function SpaceShmupBoard({ backgroundImage, assetBaseUrl, width, height, fps, isLoading, error, className, }: SpaceShmupBoardProps): React.ReactElement;
+export declare function SpaceShmupBoard({ tiles, units, features, assetManifest, assetBaseUrl, scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: SpaceShmupBoardProps): React.ReactElement;
 export declare namespace SpaceShmupBoard {
     var displayName: string;
 }

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 */