@almadar/ui 5.16.4 → 5.17.1

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

@@ -26,6 +26,7 @@
 import * as React from 'react';
 import type { EventEmit } from '@almadar/core';
 import type { CombatActionType, EffectAssetManifest } from './types/effects';
+import type { UiError } from '../../atoms/types';
 export type { CombatActionType } from './types/effects';
 export type { EffectAssetManifest } from './types/effects';
 export interface CanvasEffectProps {
@@ -48,7 +49,7 @@ export interface CanvasEffectProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Sprite URL for the effect (emoji fallback mode).
      *  When set without assetManifest, renders this image instead of emoji. */
     effectSpriteUrl?: string;

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

@@ -13,7 +13,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
 /** Entity shape consumed by CastleBoard */
 export interface CastleEntity {
@@ -30,7 +30,7 @@ export interface CastleEntity {
     backgroundImage?: string;
 }
 /** Context exposed to render-prop slots */
-export interface CastleSlotContext {
+export type CastleSlotContext = {
     /** Currently hovered tile coordinates (null when not hovering) */
     hoveredTile: {
         x: number;
@@ -51,10 +51,11 @@ export interface CastleSlotContext {
     };
     /** Canvas scale */
     scale: number;
-}
+};
 export interface CastleBoardProps {
-    /** Castle entity data */
-    entity: CastleEntity;
+    /** Castle entity data. Also accepts the canonical `EntityRow` the compiler
+     *  binds (and arrays); narrowed to `CastleEntity` internally. */
+    entity?: CastleEntity | EntityRow | readonly (CastleEntity | EntityRow)[];
     /** Canvas render scale */
     scale?: number;
     /** Top bar / header */

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

@@ -18,6 +18,7 @@
  */
 import React from 'react';
 import { type AudioManifest, type GameAudioControls } from './hooks/useGameAudio';
+import type { UiError } from '../../atoms/types';
 export type GameAudioContextValue = Pick<GameAudioControls, 'muted' | 'setMuted' | 'masterVolume' | 'setMasterVolume' | 'play' | 'playMusic' | 'stopMusic'>;
 export declare const GameAudioContext: React.Context<GameAudioContextValue | null>;
 /**
@@ -37,7 +38,7 @@ export interface GameAudioProviderProps {
     /** Closed-circuit props (unused, accepted for runtime compatibility) */
     className?: string;
     isLoading?: boolean;
-    error?: Error | null;
+    error?: UiError | null;
     entity?: string;
 }
 export declare function GameAudioProvider({ manifest, baseUrl, children, initialMuted, }: GameAudioProviderProps): React.JSX.Element;

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

@@ -9,6 +9,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { UiError } from '../../atoms/types';
 export interface GameAudioToggleProps {
     /** Button size */
     size?: 'sm' | 'md' | 'lg';
@@ -17,7 +18,7 @@ export interface GameAudioToggleProps {
     /** Loading state (passed through) */
     isLoading?: boolean;
     /** Error state (passed through) */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
 }

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

@@ -20,8 +20,9 @@
 import React from 'react';
 import type { EventEmit } from '@almadar/core';
 import { type TraitStateMachineDefinition } from './TraitStateViewer';
+import type { UiError } from '../../atoms/types';
 /** Data shape for a slot's equipped item */
-export interface SlotItemData {
+export type SlotItemData = {
     id: string;
     name: string;
     category: string;
@@ -32,7 +33,7 @@ export interface SlotItemData {
     iconUrl?: string;
     /** Optional state machine for tooltip display */
     stateMachine?: TraitStateMachineDefinition;
-}
+};
 /** Event Contract:
  *  Emits: UI:CLICK
  *  Emits: UI:REMOVE
@@ -64,7 +65,7 @@ export interface TraitSlotProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
     /** Called when an item is dropped on this slot */

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

@@ -11,19 +11,20 @@
  */
 import React from 'react';
 import { type StateStyle } from '../../atoms/game/StateIndicator';
-export interface TraitTransition {
+import type { UiError } from '../../atoms/types';
+export type TraitTransition = {
     from: string;
     to: string;
     event: string;
     guardHint?: string;
-}
-export interface TraitStateMachineDefinition {
+};
+export type TraitStateMachineDefinition = {
     name: string;
     states: string[];
     currentState: string;
     transitions: TraitTransition[];
     description?: string;
-}
+};
 export interface TraitStateViewerProps {
     /** The trait / state machine to visualize */
     trait: TraitStateMachineDefinition;
@@ -42,7 +43,7 @@ export interface TraitStateViewerProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
 }

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

@@ -13,13 +13,18 @@
  *
  * @packageDocumentation
  */
+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[];
+};
 export interface UncontrolledBattleBoardProps extends Omit<BattleBoardProps, 'entity'> {
-    entity: Omit<BattleBoardProps['entity'], 'units' | 'phase' | 'turn' | 'gameResult' | 'selectedUnitId'> & {
-        initialUnits: BattleUnit[];
-    };
+    entity?: UncontrolledBattleEntity | EntityRow | readonly (UncontrolledBattleEntity | EntityRow)[];
 }
-export declare function UncontrolledBattleBoard({ entity, ...rest }: UncontrolledBattleBoardProps): import("react/jsx-runtime").JSX.Element;
+export declare function UncontrolledBattleBoard({ entity, ...rest }: UncontrolledBattleBoardProps): React.JSX.Element | null;
 export declare namespace UncontrolledBattleBoard {
     var displayName: string;
 }

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

@@ -19,9 +19,10 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow, FieldValue } from '@almadar/core';
 import type { IsometricFeature } from './types/isometric';
 import type { ResolvedFrame } from './types/spriteAnimation';
+import type { UiError } from '../../atoms/types';
 /** A hero on the world map */
 export interface MapHero {
     id: string;
@@ -43,17 +44,17 @@ export interface MapHero {
     level?: number;
 }
 /** A hex on the map */
-export interface MapHex {
+export type MapHex = {
     x: number;
     y: number;
     terrain: string;
     terrainSprite?: string;
     feature?: string;
-    featureData?: Record<string, unknown>;
+    featureData?: Record<string, FieldValue | undefined>;
     passable?: boolean;
-}
+};
 /** Context exposed to render-prop slots */
-export interface WorldMapSlotContext {
+export type WorldMapSlotContext = {
     /** Currently hovered tile */
     hoveredTile: {
         x: number;
@@ -79,7 +80,7 @@ export interface WorldMapSlotContext {
     };
     /** Canvas scale */
     scale: number;
-}
+};
 /** Entity shape for the WorldMapBoard */
 export interface WorldMapEntity {
     id: string;
@@ -108,9 +109,10 @@ export interface WorldMapBoardProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
-    /** World map entity data */
-    entity?: WorldMapEntity | readonly WorldMapEntity[];
+    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)[];
     /** Canvas render scale */
     scale?: number;
     /** Unit draw-size multiplier */

package/dist/components/organisms/game/physics-sim/SimulationControls.d.ts

@@ -4,16 +4,17 @@
  * Play/pause/step/reset controls with speed and parameter sliders.
  */
 import React from 'react';
+export interface SimulationParameter {
+    value: number;
+    min: number;
+    max: number;
+    step: number;
+    label: string;
+}
 export interface SimulationControlsProps {
     running: boolean;
     speed: number;
-    parameters: Record<string, {
-        value: number;
-        min: number;
-        max: number;
-        step: number;
-        label: string;
-    }>;
+    parameters: Record<string, SimulationParameter>;
     onPlay: () => void;
     onPause: () => void;
     onStep: () => void;

package/dist/components/organisms/game/puzzles/builder/BuilderBoard.d.ts

@@ -9,7 +9,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface BuilderComponent {
     id: string;
@@ -44,13 +44,13 @@ export interface BuilderPuzzleEntity {
     };
 }
 export interface BuilderBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    entity: BuilderPuzzleEntity;
+    entity?: BuilderPuzzleEntity | EntityRow | readonly (BuilderPuzzleEntity | EntityRow)[];
     completeEvent?: EventEmit<{
         success: boolean;
         attempts: number;
     }>;
 }
-export declare function BuilderBoard({ entity, completeEvent, className, }: BuilderBoardProps): React.JSX.Element;
+export declare function BuilderBoard({ entity, completeEvent, className, }: BuilderBoardProps): React.JSX.Element | null;
 export declare namespace BuilderBoard {
     var displayName: string;
 }

package/dist/components/organisms/game/puzzles/classifier/ClassifierBoard.d.ts

@@ -10,7 +10,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface ClassifierItem {
     id: string;
@@ -45,13 +45,13 @@ export interface ClassifierPuzzleEntity {
     };
 }
 export interface ClassifierBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    entity: ClassifierPuzzleEntity;
+    entity?: ClassifierPuzzleEntity | EntityRow | readonly (ClassifierPuzzleEntity | EntityRow)[];
     completeEvent?: EventEmit<{
         success: boolean;
         attempts: number;
     }>;
 }
-export declare function ClassifierBoard({ entity, completeEvent, className, }: ClassifierBoardProps): React.JSX.Element;
+export declare function ClassifierBoard({ entity, completeEvent, className, }: ClassifierBoardProps): React.JSX.Element | null;
 export declare namespace ClassifierBoard {
     var displayName: string;
 }

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

@@ -9,7 +9,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface DebuggerLine {
     id: string;
@@ -37,13 +37,13 @@ export interface DebuggerPuzzleEntity {
     };
 }
 export interface DebuggerBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    entity: DebuggerPuzzleEntity;
+    entity?: DebuggerPuzzleEntity | EntityRow | readonly (DebuggerPuzzleEntity | EntityRow)[];
     completeEvent?: EventEmit<{
         success: boolean;
         attempts: number;
     }>;
 }
-export declare function DebuggerBoard({ entity, completeEvent, className, }: DebuggerBoardProps): React.JSX.Element;
+export declare function DebuggerBoard({ entity, completeEvent, className, }: DebuggerBoardProps): React.JSX.Element | null;
 export declare namespace DebuggerBoard {
     var displayName: string;
 }

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

@@ -11,7 +11,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 import { type PuzzleObjectDef } from './ObjectRulePanel';
 export interface EventHandlerPuzzleEntity {
@@ -40,8 +40,11 @@ export interface EventHandlerPuzzleEntity {
     };
 }
 export interface EventHandlerBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    /** Puzzle data */
-    entity: EventHandlerPuzzleEntity;
+    /** Puzzle data. The compiler binds the generic `EntityRow`, so the inlet
+     *  accepts it (and arrays) as union members; the component narrows to its
+     *  curated `EventHandlerPuzzleEntity` read-shape below (a valid
+     *  union-narrow) and renders nothing until a puzzle entity is present. */
+    entity?: EventHandlerPuzzleEntity | EntityRow | readonly (EventHandlerPuzzleEntity | EntityRow)[];
     /** Playback speed in ms per event */
     stepDurationMs?: number;
     /** Emits UI:{playEvent} */
@@ -51,7 +54,7 @@ export interface EventHandlerBoardProps extends Omit<EntityDisplayProps, 'entity
         success: boolean;
     }>;
 }
-export declare function EventHandlerBoard({ entity, stepDurationMs, playEvent, completeEvent, className, }: EventHandlerBoardProps): React.JSX.Element;
+export declare function EventHandlerBoard({ entity, stepDurationMs, playEvent, completeEvent, className, }: EventHandlerBoardProps): React.JSX.Element | null;
 export declare namespace EventHandlerBoard {
     var displayName: string;
 }

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

@@ -9,7 +9,7 @@
  */
 import React from 'react';
 import { type RuleDefinition } from './RuleEditor';
-export interface PuzzleObjectDef {
+export type PuzzleObjectDef = {
     id: string;
     name: string;
     icon: string;
@@ -27,7 +27,7 @@ export interface PuzzleObjectDef {
     rules: RuleDefinition[];
     /** Max rules allowed on this object */
     maxRules?: number;
-}
+};
 export interface ObjectRulePanelProps {
     /** The selected object */
     object: PuzzleObjectDef;

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

@@ -7,24 +7,22 @@
  * @packageDocumentation
  */
 import React from 'react';
-export interface RuleDefinition {
+export type RuleDefinition = {
     id: string;
     whenEvent: string;
     thenAction: string;
+};
+export interface RuleOption {
+    value: string;
+    label: string;
 }
 export interface RuleEditorProps {
     /** The current rule */
     rule: RuleDefinition;
     /** Available event triggers to listen for */
-    availableEvents: Array<{
-        value: string;
-        label: string;
-    }>;
+    availableEvents: RuleOption[];
     /** Available actions to perform */
-    availableActions: Array<{
-        value: string;
-        label: string;
-    }>;
+    availableActions: RuleOption[];
     /** Called when rule changes */
     onChange: (rule: RuleDefinition) => void;
     /** Called when rule is removed */

package/dist/components/organisms/game/puzzles/negotiator/NegotiatorBoard.d.ts

@@ -11,7 +11,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface NegotiatorAction {
     id: string;
@@ -46,13 +46,13 @@ export interface NegotiatorPuzzleEntity {
     };
 }
 export interface NegotiatorBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    entity: NegotiatorPuzzleEntity;
+    entity?: NegotiatorPuzzleEntity | EntityRow | readonly (NegotiatorPuzzleEntity | EntityRow)[];
     completeEvent?: EventEmit<{
         success: boolean;
         score: number;
     }>;
 }
-export declare function NegotiatorBoard({ entity, completeEvent, className, }: NegotiatorBoardProps): React.JSX.Element;
+export declare function NegotiatorBoard({ entity, completeEvent, className, }: NegotiatorBoardProps): React.JSX.Element | null;
 export declare namespace NegotiatorBoard {
     var displayName: string;
 }

package/dist/components/organisms/game/puzzles/sequencer/SequencerBoard.d.ts

@@ -18,7 +18,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { SlotItemData } from '../../TraitSlot';
 import type { EntityDisplayProps } from '../../../types';
 export interface SequencerPuzzleEntity {
@@ -52,8 +52,9 @@ export interface SequencerPuzzleEntity {
     };
 }
 export interface SequencerBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    /** Puzzle data */
-    entity: SequencerPuzzleEntity;
+    /** Puzzle data. Also accepts the canonical `EntityRow` the compiler binds
+     *  (and arrays); narrowed to `SequencerPuzzleEntity` internally. */
+    entity?: SequencerPuzzleEntity | EntityRow | readonly (SequencerPuzzleEntity | EntityRow)[];
     /** Category → color mapping */
     categoryColors?: Record<string, {
         bg: string;
@@ -71,7 +72,7 @@ export interface SequencerBoardProps extends Omit<EntityDisplayProps, 'entity'>
         sequence: string[];
     }>;
 }
-export declare function SequencerBoard({ entity, categoryColors, stepDurationMs, playEvent, completeEvent, className, }: SequencerBoardProps): React.JSX.Element;
+export declare function SequencerBoard({ entity, categoryColors, stepDurationMs, playEvent, completeEvent, className, }: SequencerBoardProps): React.JSX.Element | null;
 export declare namespace SequencerBoard {
     var displayName: string;
 }

package/dist/components/organisms/game/puzzles/simulator/SimulatorBoard.d.ts

@@ -10,7 +10,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface SimulatorParameter {
     id: string;
@@ -46,13 +46,13 @@ export interface SimulatorPuzzleEntity {
     };
 }
 export interface SimulatorBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    entity: SimulatorPuzzleEntity;
+    entity?: SimulatorPuzzleEntity | EntityRow | readonly (SimulatorPuzzleEntity | EntityRow)[];
     completeEvent?: EventEmit<{
         success: boolean;
         attempts: number;
     }>;
 }
-export declare function SimulatorBoard({ entity, completeEvent, className, }: SimulatorBoardProps): React.JSX.Element;
+export declare function SimulatorBoard({ entity, completeEvent, className, }: SimulatorBoardProps): React.JSX.Element | null;
 export declare namespace SimulatorBoard {
     var displayName: string;
 }

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

@@ -8,7 +8,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 import { type VariableDef } from './VariablePanel';
 export interface StateArchitectTransition {
@@ -61,8 +61,9 @@ export interface StateArchitectPuzzleEntity {
     };
 }
 export interface StateArchitectBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    /** Puzzle data */
-    entity: StateArchitectPuzzleEntity;
+    /** Puzzle data. Also accepts the canonical `EntityRow` the compiler binds
+     *  (and arrays); narrowed to `StateArchitectPuzzleEntity` internally. */
+    entity?: StateArchitectPuzzleEntity | EntityRow | readonly (StateArchitectPuzzleEntity | EntityRow)[];
     /** Playback speed */
     stepDurationMs?: number;
     /** Emits UI:{testEvent} */
@@ -73,7 +74,7 @@ export interface StateArchitectBoardProps extends Omit<EntityDisplayProps, 'enti
         passedTests: number;
     }>;
 }
-export declare function StateArchitectBoard({ entity, stepDurationMs, testEvent, completeEvent, className, }: StateArchitectBoardProps): React.JSX.Element;
+export declare function StateArchitectBoard({ entity, stepDurationMs, testEvent, completeEvent, className, }: StateArchitectBoardProps): React.JSX.Element | null;
 export declare namespace StateArchitectBoard {
     var displayName: string;
 }

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

@@ -7,6 +7,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import { type Point } from '../../../../atoms';
 export interface StateNodeProps {
     /** State name */
     name: string;
@@ -17,10 +18,7 @@ export interface StateNodeProps {
     /** Whether this is the initial state */
     isInitial?: boolean;
     /** Position on the graph canvas */
-    position: {
-        x: number;
-        y: number;
-    };
+    position: Point;
     /** Click handler */
     onClick?: () => void;
     /** Additional CSS classes */

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

@@ -7,17 +7,12 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { Point } from '../../../../atoms/types';
 export interface TransitionArrowProps {
     /** Start position (center of from-node) */
-    from: {
-        x: number;
-        y: number;
-    };
+    from: Point;
     /** End position (center of to-node) */
-    to: {
-        x: number;
-        y: number;
-    };
+    to: Point;
     /** Event label shown on the arrow */
     eventLabel: string;
     /** Guard hint shown below event */

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

@@ -32,7 +32,7 @@ export interface IsometricTile {
     elevation?: number;
 }
 /** A unit positioned on the isometric grid */
-export interface IsometricUnit {
+export type IsometricUnit = {
     /** Unique unit identifier */
     id: string;
     /** Current grid position (2D format) */
@@ -76,9 +76,9 @@ export interface IsometricUnit {
     };
     /** Elevation offset for 3D rendering */
     elevation?: number;
-}
+};
 /** A map feature (resource, building, portal, etc.) */
-export interface IsometricFeature {
+export type IsometricFeature = {
     /** Optional unique identifier (required for 3D rendering) */
     id?: string;
     /** Grid x coordinate */
@@ -97,7 +97,7 @@ export interface IsometricFeature {
     color?: string;
     /** Elevation offset for 3D rendering */
     elevation?: number;
-}
+};
 /** Camera state for pan/zoom */
 export interface CameraState {
     /** Camera X offset in pixels */

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

@@ -1,4 +1,4 @@
-export { type EntityDisplayProps, EntityDisplayEvents, type SortPayload, type PaginatePayload, type SearchPayload, type FilterPayload, type SelectPayload, } from "./types";
+export { type EntityDisplayProps, 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 { PageHeader, type PageHeaderProps, type PageBreadcrumb, } from "./PageHeader";

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

@@ -8,6 +8,8 @@
  * 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: {
     readonly SORT: "SORT";
     readonly PAGINATE: "PAGINATE";
@@ -67,7 +69,7 @@ export interface EntityDisplayProps<T extends EntityRow = EntityRow> {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Current sort field */
     sortBy?: string;
     /** Current sort direction */

package/dist/components/templates/DashboardLayout.d.ts

@@ -39,6 +39,11 @@ export interface TopBarAction {
     /** Visual variant. Default `"default"`. */
     variant?: "default" | "primary" | "danger";
 }
+export interface DashboardUser {
+    name: string;
+    email: string;
+    avatar?: string;
+}
 export interface DashboardLayoutProps {
     /** App name shown in sidebar */
     appName?: string;
@@ -48,11 +53,7 @@ export interface DashboardLayoutProps {
      *  as a navItems entry, not depend on baked-in chrome. */
     navItems?: NavItem[];
     /** Current user info (optional - auto-populated from auth context if not provided) */
-    user?: {
-        name: string;
-        email: string;
-        avatar?: string;
-    };
+    user?: DashboardUser;
     /** Header actions (extra slots beyond bell/search/theme). */
     headerActions?: React.ReactNode;
     /** Show the top-bar search box. Default `false` — opt in by setting