@almadar/ui 5.21.12 → 5.22.2

package/dist/components/core/organisms/Timeline.d.ts

@@ -12,7 +12,7 @@
  */
 import React from "react";
 import type { EventKey } from "@almadar/core";
-import type { EntityCollection, EntityRow } from "@almadar/core";
+import type { EntityRow } from "@almadar/core";
 import type { LucideIcon } from "lucide-react";
 import type { UiError } from '../atoms/types';
 export type TimelineItemStatus = "complete" | "active" | "pending" | "error";
@@ -56,7 +56,7 @@ export interface TimelineProps {
      * TimelineItem fields (`icon`, callbacks) cannot round-trip through the
      * event bus, so decorative stories that need them pass `items` directly.
      */
-    entity?: EntityCollection<EntityRow>;
+    entity?: readonly EntityRow[];
     /** Timeline title */
     title?: string;
     /** Timeline items */

package/dist/components/core/organisms/book/index.d.ts

@@ -3,5 +3,5 @@ export { BookChapterView, type BookChapterViewProps } from '../../../marketing/o
 export { BookCoverPage, type BookCoverPageProps } from '../../../marketing/organisms/book/BookCoverPage';
 export { BookTableOfContents, type BookTableOfContentsProps } from '../../../marketing/organisms/book/BookTableOfContents';
 export { BookNavBar, type BookNavBarProps } from '../../../marketing/organisms/book/BookNavBar';
-export type { BookData, BookPart, BookChapter, BookFieldMap } from './types';
+export type { BookFieldMap } from './types';
 export { mapBookData, resolveFieldMap, IDENTITY_BOOK_FIELDS, AR_BOOK_FIELDS } from './types';

package/dist/components/core/organisms/book/types.d.ts

@@ -1,55 +1,34 @@
 /**
- * BookViewer shared types
+ * BookViewer shared types + field-map normalisation.
  *
- * `BookData` / `BookPart` / `BookChapter` are rendering-layer content-model
- * types: they carry a typed `OrbitalSchema` (via `@almadar/core`) for the
- * embedded orbital-diagram feature, which is richer than `FieldValue` and
- * therefore cannot satisfy `EntityRow`'s primitive-field constraint. The
- * BookViewer organism's prop surface IS `EntityRow` — raw schema data bound
- * from `@payload.data`; `mapBookData()` normalises those records (English or
- * localised) into the typed `BookData` representation at render time.
+ * The BookViewer's entity boundary is `EntityRow` (raw schema data bound from
+ * `@payload.data`). Books may use non-English field names (e.g. Arabic `.orb`
+ * schemas), so `mapBookData()` normalises a raw record into canonical English
+ * field names while keeping every value as `EntityRow` — no private entity
+ * content-model types.
+ *
+ * The embedded orbital-diagram (`OrbitalSchema`) is richer than `FieldValue`
+ * and therefore CANNOT live on an `EntityRow`. It is lifted OFF the entity
+ * boundary into a separate `schemaByChapterId` lookup; consumers fetch a
+ * chapter's schema by id and pass it as its own non-entity prop.
  */
-import type { OrbitalSchema } from '@almadar/core';
-export interface BookData {
-    title: string;
-    subtitle?: string;
-    author?: string;
-    coverImageUrl?: string;
-    direction?: 'rtl' | 'ltr';
-    parts: BookPart[];
-}
-export interface BookPart {
-    title: string;
-    chapters: BookChapter[];
+import type { EntityRow, OrbitalSchema } from '@almadar/core';
+/** A normalised book: cover fields + part rows + a chapter→schema side-table. */
+export interface NormalizedBook {
+    /** Cover-level fields (title/subtitle/author/coverImageUrl/direction). */
+    cover: EntityRow;
+    /** Reading direction resolved from the cover record. */
+    direction: 'rtl' | 'ltr';
+    /** Parts, each an `EntityRow` carrying `title` + a `chapters: EntityRow[]`. */
+    parts: readonly EntityRow[];
+    /** Flattened chapter rows in reading order (each carries id/title/content). */
+    chapters: readonly EntityRow[];
+    /** Orbital diagram schemas keyed by chapter id — kept OFF the entity rows. */
+    schemaByChapterId: Record<string, OrbitalSchema>;
 }
-export type BookChapter = {
-    id: string;
-    title: string;
-    content: string;
-    orbitalSchema?: OrbitalSchema;
-};
 /**
  * Maps raw entity field names to canonical BookData field names.
  * Each key is a canonical field, each value is the entity field name.
- *
- * @example
- * ```ts
- * // Arabic schema
- * const AR_BOOK_FIELDS: BookFieldMap = {
- *   title: 'العنوان',
- *   subtitle: 'العنوان_الفرعي',
- *   author: 'المؤلف',
- *   coverImageUrl: 'صورة_الغلاف',
- *   direction: 'الاتجاه',
- *   parts: 'الأجزاء',
- *   partTitle: 'العنوان',
- *   chapters: 'الفصول',
- *   chapterId: 'المعرف',
- *   chapterTitle: 'العنوان',
- *   chapterContent: 'المحتوى',
- *   chapterOrbitalSchema: 'المخطط_المداري',
- * };
- * ```
  */
 export interface BookFieldMap {
     title: string;
@@ -76,7 +55,8 @@ export declare const AR_BOOK_FIELDS: BookFieldMap;
  */
 export declare function resolveFieldMap(fieldMap: BookFieldMap | string | undefined): BookFieldMap;
 /**
- * Maps a raw entity record to a typed BookData using a field map.
- * Pass `IDENTITY_BOOK_FIELDS` for English schemas, `AR_BOOK_FIELDS` for Arabic, etc.
+ * Maps a raw entity record to a `NormalizedBook` using a field map. Cover and
+ * chapter data come back as `EntityRow`s; the per-chapter `OrbitalSchema` is
+ * lifted off into `schemaByChapterId`.
  */
-export declare function mapBookData(raw: Record<string, unknown>, fields?: BookFieldMap): BookData;
+export declare function mapBookData(raw: Record<string, unknown>, fields?: BookFieldMap): NormalizedBook;

package/dist/components/core/organisms/index.d.ts

@@ -1,4 +1,4 @@
-export { type EntityDisplayProps, type UiError, EntityDisplayEvents, type SortPayload, type PaginatePayload, type SearchPayload, type FilterPayload, type SelectPayload, } from "./types";
+export { type DisplayStateProps, type UiError, EntityDisplayEvents, type SortPayload, type PaginatePayload, type SearchPayload, type FilterPayload, type SelectPayload, } from "./types";
 export { DataTable, type DataTableProps, type Column, type RowAction, } from "./DataTable";
 export { StatCard, type StatCardProps } from "./StatCard";
 export { DetailPanel, type DetailPanelProps, type DetailField, type DetailSection, } from "./DetailPanel";
@@ -18,7 +18,6 @@ export { NotifyListener } from "./NotifyListener";
 export { Timeline, type TimelineProps, type TimelineItem, type TimelineItemStatus, } from "./Timeline";
 export { MediaGallery, type MediaGalleryProps, type MediaItem, } from "./MediaGallery";
 export { RuntimeDebugger, type RuntimeDebuggerProps, } from "./debug";
-export type { MarketingAction, MarketingImage, HeroEntity, FeatureEntity, PricingPlanEntity, StatEntity, StepEntity, ShowcaseEntity, TeamMemberEntity, CaseStudyEntity, } from "./marketing-types";
 export { HeroOrganism, type HeroOrganismProps, } from "./HeroOrganism";
 export { FeatureGridOrganism, type FeatureGridOrganismProps, } from "./FeatureGridOrganism";
 export { PricingOrganism, type PricingOrganismProps, } from "../../marketing/organisms/PricingOrganism";

package/dist/components/core/organisms/layout/DashboardGrid.d.ts

@@ -7,7 +7,7 @@
  * Uses wireframe theme styling (high contrast, sharp edges).
  */
 import React from "react";
-import type { EntityDisplayProps } from "../types";
+import type { DisplayStateProps } from "../types";
 export interface DashboardGridCell {
     /** Optional unique cell ID */
     id?: string;
@@ -20,7 +20,7 @@ export interface DashboardGridCell {
     /** Allow additional schema-driven properties */
     [key: string]: unknown;
 }
-export interface DashboardGridProps extends EntityDisplayProps {
+export interface DashboardGridProps extends DisplayStateProps {
     /** Number of columns */
     columns?: 2 | 3 | 4;
     /** Gap between cells */

package/dist/components/core/organisms/marketing-types.d.ts

@@ -1,97 +1,8 @@
 /**
- * Marketing Entity Types
+ * (stub) Marketing entity types removed in the entity-row clean slate.
  *
- * Shared entity interfaces for marketing/landing-page organisms (HeroOrganism,
- * FeatureGridOrganism, PricingOrganism, StatsOrganism, StepFlowOrganism,
- * ShowcaseOrganism, TeamOrganism, CaseStudyOrganism).
- *
- * Every marketing entity extends `@almadar/core`'s `EntityRow` so the
- * canonical runtime entity shape lives in core. Marketing data is pure
- * JSON-serialisable content (strings, numbers, nested records) with no
- * React nodes or callbacks, so the `EntityRow` index signature is satisfied
- * structurally. Nested `MarketingAction` / `MarketingImage` carry explicit
- * `[key: string]: FieldValue | undefined` signatures so they fit the
- * `{ [key: string]: FieldValue }` branch of `FieldValue`.
+ * Marketing organisms now consume `@almadar/core`'s `EntityRow` directly and
+ * coerce concrete fields at the read site; templates declare their nested
+ * content shapes inline. No bespoke per-organism entity interfaces live here.
  */
-import type { EntityRow, FieldValue } from '@almadar/core';
-export interface MarketingAction {
-    [key: string]: FieldValue | undefined;
-    label: string;
-    href: string;
-    variant?: 'primary' | 'secondary' | 'ghost';
-}
-export interface MarketingImage {
-    [key: string]: FieldValue | undefined;
-    src: string;
-    alt: string;
-}
-export interface HeroEntity extends EntityRow {
-    id: string;
-    tag?: string;
-    title: string;
-    titleAccent?: string;
-    subtitle: string;
-    primaryAction?: MarketingAction;
-    secondaryAction?: MarketingAction;
-    installCommand?: string;
-    image?: MarketingImage;
-    imagePosition?: 'below' | 'right' | 'background';
-    background?: 'dark' | 'gradient' | 'subtle';
-}
-export interface FeatureEntity extends EntityRow {
-    id: string;
-    icon?: string;
-    title: string;
-    description: string;
-    href?: string;
-    linkLabel?: string;
-}
-export interface PricingPlanEntity extends EntityRow {
-    id: string;
-    name: string;
-    price: string;
-    description?: string;
-    features: string[];
-    actionLabel: string;
-    actionHref: string;
-    highlighted?: boolean;
-    badge?: string;
-}
-export interface StatEntity extends EntityRow {
-    id: string;
-    value: string;
-    label: string;
-}
-export interface StepEntity extends EntityRow {
-    id: string;
-    number?: number;
-    title: string;
-    description: string;
-    icon?: string;
-}
-export interface ShowcaseEntity extends EntityRow {
-    id: string;
-    title: string;
-    description?: string;
-    image: MarketingImage;
-    href?: string;
-    badge?: string;
-    accentColor?: string;
-}
-export interface TeamMemberEntity extends EntityRow {
-    id: string;
-    name: string;
-    nameAr?: string;
-    role: string;
-    bio: string;
-    avatar?: string;
-}
-export interface CaseStudyEntity extends EntityRow {
-    id: string;
-    title: string;
-    description: string;
-    category: string;
-    categoryColor?: string;
-    href: string;
-    linkLabel?: string;
-}
+export {};

package/dist/components/core/organisms/types.d.ts

@@ -7,7 +7,6 @@
  * Exception: Form manages local `formData` state for field input tracking.
  * This is the ONE allowed exception — documented here.
  */
-import type { EntityRow, EntityInlet } from '@almadar/core';
 import type { UiError } from '../atoms/types';
 export type { UiError };
 export declare const EntityDisplayEvents: {
@@ -38,32 +37,15 @@ export interface FilterPayload {
 export interface SelectPayload {
     ids: (string | number)[];
 }
-export interface EntityDisplayProps<T extends EntityRow = EntityRow> {
-    /**
-     * Pre-resolved entity data, typed against `@almadar/core`'s `EntityRow`
-     * (`{ id?: string } & Record<string, FieldValue>`) so the single source of
-     * truth for runtime entity shape lives in core. Consumers narrow via the
-     * generic parameter; the constraint guarantees every organism receives
-     * something with an optional `id` and a Record of `FieldValue` fields.
-     *
-     * Two shapes accepted:
-     * - `readonly T[]`: array for list patterns (authoring: `entity: @payload.data`
-     *   on the calling trait after a `fetch … { emit: { success } }` listener).
-     * - `T`: single record for detail patterns.
-     *
-     * The legacy `string` (entity-name) branch was removed in V2 Phase 6. The
-     * EntityStore resolver is gone; components now receive pre-resolved data via
-     * the event bus.
-     *
-     * NOTE: Several legacy organisms (HeroOrganism, TeamOrganism, CaseStudyOrganism,
-     * MediaGallery, PricingOrganism, ShowcaseOrganism, StatsOrganism, Sidebar,
-     * Timeline, StepFlowOrganism, FeatureGridOrganism, book/*, WorldMapBoard,
-     * StateMachineView, JazariStateMachine, MasterDetail, DataTable, Table) define
-     * local entity types (HeroEntity, TeamMemberEntity, …) that don't formally
-     * extend `EntityRow`. They surface `EntityDisplayProps<T>` constraint errors.
-     * Tracked as a Phase 7 follow-up in `docs/Almadar_Entity_V2_Plan.md` §10.
-     */
-    entity?: EntityInlet<T>;
+/**
+ * Common non-entity display state shared by every display organism — loading,
+ * error, and the render-ui display hints (sort/search/pagination/selection).
+ * Carries NO entity data and NO generic. Components that show entity data add
+ * their own `entity?: EntityRow | readonly EntityRow[]` field directly (the one
+ * unified entity type from `@almadar/core`); components that only need the
+ * loading/hint surface just extend this.
+ */
+export interface DisplayStateProps {
     /** Additional CSS classes */
     className?: string;
     /** Loading state indicator */

package/dist/components/core/templates/index.d.ts

@@ -5,10 +5,10 @@ export { CounterTemplate, type CounterTemplateProps, type CounterSize, type Coun
 export { GameTemplate, type GameTemplateProps } from '../../game/templates/GameTemplate';
 export { GenericAppTemplate, type GenericAppTemplateProps } from './GenericAppTemplate';
 export { GameShell, type GameShellProps } from '../../game/templates/GameShell';
-export { BattleTemplate, type BattleTemplateProps, type BattleEntity, type BattlePhase, type BattleUnit, type BattleTile, type BattleSlotContext, } from '../../game/templates/BattleTemplate';
-export { CastleTemplate, type CastleTemplateProps, type CastleEntity, type CastleSlotContext, } from '../../game/templates/CastleTemplate';
-export { WorldMapTemplate, type WorldMapTemplateProps, type WorldMapEntity, type MapHero, type MapHex, type WorldMapSlotContext, } from '../../game/templates/WorldMapTemplate';
-export { LandingPageTemplate, type LandingPageTemplateProps, type LandingPageEntity, type HeroEntity, type FeatureEntity, type StatEntity, type StepEntity, type ShowcaseEntity, } from '../../marketing/templates/LandingPageTemplate';
-export { PricingPageTemplate, type PricingPageTemplateProps, type PricingPageEntity, type PricingPlanEntity, } from '../../marketing/templates/PricingPageTemplate';
+export { BattleTemplate, type BattleTemplateProps, type BattlePhase, type BattleSlotContext, } from '../../game/templates/BattleTemplate';
+export { CastleTemplate, type CastleTemplateProps, type CastleSlotContext, } from '../../game/templates/CastleTemplate';
+export { WorldMapTemplate, type WorldMapTemplateProps, type WorldMapSlotContext, } from '../../game/templates/WorldMapTemplate';
+export { LandingPageTemplate, type LandingPageTemplateProps, type LandingPageEntity, } from '../../marketing/templates/LandingPageTemplate';
+export { PricingPageTemplate, type PricingPageTemplateProps, type PricingPageEntity, } from '../../marketing/templates/PricingPageTemplate';
 export { FeatureDetailPageTemplate, type FeatureDetailPageTemplateProps, type FeatureDetailPageEntity, type FeatureDetailSection, } from '../../marketing/templates/FeatureDetailPageTemplate';
-export { AboutPageTemplate, type AboutPageTemplateProps, type AboutPageEntity, type TeamMemberEntity, type CaseStudyEntity, } from '../../marketing/templates/AboutPageTemplate';
+export { AboutPageTemplate, type AboutPageTemplateProps, type AboutPageEntity, } from '../../marketing/templates/AboutPageTemplate';

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

@@ -18,95 +18,19 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
-import type { EntityDisplayProps } from '../../core/organisms/types';
-import type { IsometricTile, IsometricFeature } from './types/isometric';
+import type { EventEmit, EntityRow } from '@almadar/core';
+import type { DisplayStateProps } from '../../core/organisms/types';
 import type { ResolvedFrame } from './types/spriteAnimation';
-/** Battle phases an encounter walks through */
+/** Battle phases an encounter walks through (UI value enum — not entity data). */
 export type BattlePhase = 'observation' | 'selection' | 'movement' | 'action' | 'enemy_turn' | 'game_over';
-/** A unit participating in battle */
-export type BattleUnit = {
-    id: string;
-    name: string;
-    unitType?: string;
-    heroId?: string;
-    sprite?: string;
-    /** Optional sprite sheet for animation (null = use static sprite) */
-    spriteSheet?: {
-        se: string;
-        sw: string;
-        frameWidth: number;
-        frameHeight: number;
-    } | null;
-    team: 'player' | 'enemy';
-    position: {
-        x: number;
-        y: number;
-    };
-    health: number;
-    maxHealth: number;
-    movement: number;
-    attack: number;
-    defense: number;
-    traits?: {
-        name: string;
-        currentState: string;
-        states: string[];
-        cooldown?: number;
-    }[];
-};
-/** Minimal tile for map generation */
-export interface BattleTile {
-    x: number;
-    y: number;
-    terrain: string;
-    terrainSprite?: string;
-}
-/** Entity prop containing all board data.
- *
- * BattleBoard is **controlled-only**: all game-state fields (`units`, `phase`,
- * `turn`, `gameResult`, `selectedUnitId`) must be provided.  Mutations are
- * communicated via event bus emissions — the component never calls `setState`
- * for game-logic values.
- *
- * For a self-managing variant, use `UncontrolledBattleBoard`.
- *
- * Animation-only state (`movingPositions`, `isShaking`, `hoveredTile`) is
- * always managed locally.
- */
-export interface BattleEntity {
-    id: string;
-    tiles: IsometricTile[];
-    features?: IsometricFeature[];
-    boardWidth?: number;
-    boardHeight?: number;
-    assetManifest?: {
-        baseUrl: string;
-        terrains?: Record<string, string>;
-        units?: Record<string, string>;
-        features?: Record<string, string>;
-        effects?: Record<string, string>;
-    };
-    backgroundImage?: string;
-    /** Current unit state. */
-    units: BattleUnit[];
-    /** Current battle phase. */
-    phase: BattlePhase;
-    /** Current turn number. */
-    turn: number;
-    /** Game result. `null` = still in progress. */
-    gameResult: 'victory' | 'defeat' | null;
-    /** Currently selected unit ID. */
-    selectedUnitId: string | null;
-}
-/** Context exposed to render-prop slots */
+/** Context exposed to render-prop slots. Carries coerced entity rows + UI helpers. */
 export type BattleSlotContext = {
     phase: BattlePhase;
     turn: number;
-    selectedUnit: BattleUnit | null;
-    hoveredUnit: BattleUnit | null;
-    playerUnits: BattleUnit[];
-    enemyUnits: BattleUnit[];
+    selectedUnit: EntityRow | null;
+    hoveredUnit: EntityRow | null;
+    playerUnits: readonly EntityRow[];
+    enemyUnits: readonly EntityRow[];
     gameResult: 'victory' | 'defeat' | null;
     onEndTurn: () => void;
     onCancel: () => void;
@@ -121,9 +45,9 @@ export type BattleSlotContext = {
         y: number;
     };
 };
-export interface BattleBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    /** Entity containing all board data */
-    entity: BattleEntity;
+export interface BattleBoardProps extends DisplayStateProps {
+    /** Entity (single board state) containing all board data */
+    entity?: EntityRow | readonly EntityRow[];
     /** Canvas render scale */
     scale?: number;
     /** Unit draw-size multiplier */
@@ -139,16 +63,16 @@ export interface BattleBoardProps extends Omit<EntityDisplayProps, 'entity'> {
     /** Game-over screen overlay */
     gameOverOverlay?: (ctx: BattleSlotContext) => React.ReactNode;
     /** Called when a unit attacks another */
-    onAttack?: (attacker: BattleUnit, target: BattleUnit, damage: number) => void;
+    onAttack?: (attacker: EntityRow, target: EntityRow, damage: number) => void;
     /** Called when battle ends */
     onGameEnd?: (result: 'victory' | 'defeat') => void;
     /** Called after a unit moves */
-    onUnitMove?: (unit: BattleUnit, to: {
+    onUnitMove?: (unit: EntityRow, to: {
         x: number;
         y: number;
     }) => void;
     /** Custom combat damage calculator */
-    calculateDamage?: (attacker: BattleUnit, target: BattleUnit) => number;
+    calculateDamage?: (attacker: EntityRow, target: EntityRow) => number;
     onDrawEffects?: (ctx: CanvasRenderingContext2D, timestamp: number) => void;
     hasActiveEffects?: boolean;
     effectSpriteUrls?: string[];

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

@@ -6,29 +6,15 @@
  * Designed to be consumed by CastleTemplate (thin wrapper) or embedded directly
  * in any page that needs an isometric castle view.
  *
- * Accepts an `entity` prop conforming to `CastleEntity` and optional declarative
- * event props (`featureClickEvent`, `unitClickEvent`, `tileClickEvent`) that
- * emit through the Orbital event bus.
+ * Accepts an `entity` prop (`EntityRow`) and optional declarative event props
+ * (`featureClickEvent`, `unitClickEvent`, `tileClickEvent`) that emit through
+ * the Orbital event bus.
  *
  * @packageDocumentation
  */
 import React from 'react';
 import type { EventEmit, EntityRow } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
-/** Entity shape consumed by CastleBoard */
-export interface CastleEntity {
-    id: string;
-    tiles: IsometricTile[];
-    features?: IsometricFeature[];
-    units?: IsometricUnit[];
-    assetManifest?: {
-        baseUrl: string;
-        terrains?: Record<string, string>;
-        units?: Record<string, string>;
-        features?: Record<string, string>;
-    };
-    backgroundImage?: string;
-}
+import type { IsometricUnit, IsometricFeature } from './types/isometric';
 /** Context exposed to render-prop slots */
 export type CastleSlotContext = {
     /** Currently hovered tile coordinates (null when not hovering) */
@@ -53,9 +39,9 @@ export type CastleSlotContext = {
     scale: number;
 };
 export interface CastleBoardProps {
-    /** Castle entity data. Also accepts the canonical `EntityRow` the compiler
-     *  binds (and arrays); narrowed to `CastleEntity` internally. */
-    entity?: CastleEntity | EntityRow | readonly (CastleEntity | EntityRow)[];
+    /** Castle board-state entity (single row or array). The board reads
+     *  `tiles` / `features` / `units` arrays plus an `assetManifest` off it. */
+    entity?: EntityRow | readonly EntityRow[];
     /** Canvas render scale */
     scale?: number;
     /** Top bar / header */

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

@@ -15,14 +15,9 @@
  */
 import * as React from 'react';
 import type { EntityRow } from '@almadar/core';
-import { type BattleBoardProps, type BattleUnit } from './BattleBoard';
-/** Uncontrolled entity read-shape: controlled game-state fields are dropped in
- *  favor of `initialUnits`, which the internal `useBattleState` hook manages. */
-export type UncontrolledBattleEntity = Omit<BattleBoardProps['entity'], 'units' | 'phase' | 'turn' | 'gameResult' | 'selectedUnitId'> & {
-    initialUnits: BattleUnit[];
-};
+import { type BattleBoardProps } from './BattleBoard';
 export interface UncontrolledBattleBoardProps extends Omit<BattleBoardProps, 'entity'> {
-    entity?: UncontrolledBattleEntity | EntityRow | readonly (UncontrolledBattleEntity | EntityRow)[];
+    entity?: EntityRow | readonly EntityRow[];
 }
 export declare function UncontrolledBattleBoard({ entity, ...rest }: UncontrolledBattleBoardProps): React.JSX.Element | null;
 export declare namespace UncontrolledBattleBoard {

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

@@ -19,53 +19,22 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit, EntityRow, FieldValue } from '@almadar/core';
-import type { IsometricFeature } from './types/isometric';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { ResolvedFrame } from './types/spriteAnimation';
 import type { UiError } from '../../core/atoms/types';
-/** A hero on the world map */
-export interface MapHero {
-    id: string;
-    name: string;
-    owner: 'player' | 'enemy' | string;
-    position: {
-        x: number;
-        y: number;
-    };
-    movement: number;
-    sprite?: string;
-    /** Optional sprite sheet for animation (null = use static sprite) */
-    spriteSheet?: {
-        se: string;
-        sw: string;
-        frameWidth: number;
-        frameHeight: number;
-    } | null;
-    level?: number;
-}
-/** A hex on the map */
-export type MapHex = {
-    x: number;
-    y: number;
-    terrain: string;
-    terrainSprite?: string;
-    feature?: string;
-    featureData?: Record<string, FieldValue | undefined>;
-    passable?: boolean;
-};
-/** Context exposed to render-prop slots */
+/** Context exposed to render-prop slots. Hex / hero rows are `EntityRow`. */
 export type WorldMapSlotContext = {
     /** Currently hovered tile */
     hoveredTile: {
         x: number;
         y: number;
     } | null;
-    /** Hex at the hovered tile */
-    hoveredHex: MapHex | null;
-    /** Hero at the hovered tile */
-    hoveredHero: MapHero | null;
-    /** Currently selected hero */
-    selectedHero: MapHero | null;
+    /** Hex row at the hovered tile */
+    hoveredHex: EntityRow | null;
+    /** Hero row at the hovered tile */
+    hoveredHero: EntityRow | null;
+    /** Currently selected hero row */
+    selectedHero: EntityRow | null;
     /** Valid move tiles for selected hero */
     validMoves: Array<{
         x: number;
@@ -81,21 +50,6 @@ export type WorldMapSlotContext = {
     /** Canvas scale */
     scale: number;
 };
-/** Entity shape for the WorldMapBoard */
-export interface WorldMapEntity {
-    id: string;
-    hexes: MapHex[];
-    heroes: MapHero[];
-    features?: IsometricFeature[];
-    selectedHeroId?: string | null;
-    assetManifest?: {
-        baseUrl: string;
-        terrains?: Record<string, string>;
-        units?: Record<string, string>;
-        features?: Record<string, string>;
-    };
-    backgroundImage?: string;
-}
 /** Event Contract:
  *  Emits: UI:HERO_SELECT
  *  Emits: UI:HERO_MOVE
@@ -110,9 +64,9 @@ export interface WorldMapBoardProps {
     isLoading?: boolean;
     /** Error state */
     error?: UiError | null;
-    /** World map entity data. Also accepts the canonical `EntityRow` the
-     *  compiler binds; the component narrows to `WorldMapEntity` below. */
-    entity?: WorldMapEntity | EntityRow | readonly (WorldMapEntity | EntityRow)[];
+    /** World-map board-state entity (single row or array). The board reads
+     *  `hexes` / `heroes` / `features` arrays + `selectedHeroId` off it. */
+    entity?: EntityRow | readonly EntityRow[];
     /** Canvas render scale */
     scale?: number;
     /** Unit draw-size multiplier */
@@ -146,7 +100,7 @@ export interface WorldMapBoardProps {
     featureEnterEvent?: EventEmit<{
         heroId: string;
         feature: string;
-        hex: MapHex;
+        hex: EntityRow;
     }>;
     /** Emits UI:{tileClickEvent} with { x, y } */
     tileClickEvent?: EventEmit<{
@@ -166,7 +120,7 @@ export interface WorldMapBoardProps {
     /** Called when hero clicks an enemy hero tile */
     onBattleEncounter?: (attackerId: string, defenderId: string) => void;
     /** Called when hero enters a feature hex (castle, resource, etc.) */
-    onFeatureEnter?: (heroId: string, hex: MapHex) => void;
+    onFeatureEnter?: (heroId: string, hex: EntityRow) => void;
     /** Override for the diamond-top Y offset within tile sprites (default: 374). */
     diamondTopY?: number;
     /** Disable pan/zoom camera (default: true). Set false for fixed maps where overlay labels need stable positions. */