@almadar/ui 5.74.0 → 5.76.0

package/dist/components/core/molecules/DataGrid.d.ts

@@ -12,7 +12,7 @@
  */
 import React from 'react';
 import type { EntityRow, EventKey } from '@almadar/core';
-import type { IconInput } from '../atoms';
+import type { IconInput } from '../atoms/index';
 import { type DataDndProps } from './useDataDnd';
 import type { UiError } from '../atoms/types';
 export interface DataGridField {

package/dist/components/core/molecules/DataList.d.ts

@@ -12,7 +12,7 @@
  */
 import React from 'react';
 import type { EntityRow, EventKey } from "@almadar/core";
-import type { IconInput } from '../atoms';
+import type { IconInput } from '../atoms/index';
 import { type DataDndProps } from './useDataDnd';
 import type { UiError } from '../atoms/types';
 export interface DataListField {

package/dist/components/core/molecules/EmptyState.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 import type { EventEmit } from "@almadar/core";
-import type { IconInput } from "../atoms";
+import type { IconInput } from "../atoms/index";
 export type EmptyStateLook = "illustrated" | "icon-only" | "text-only" | "mascot";
 export interface EmptyStateProps {
     /**

package/dist/components/core/molecules/FloatingActionButton.d.ts

@@ -11,7 +11,7 @@
  */
 import React from "react";
 import type { EventKey, EventPayload } from "@almadar/core";
-import type { IconInput } from "../atoms";
+import type { IconInput } from "../atoms/index";
 export interface FloatingAction {
     /**
      * Action ID

package/dist/components/core/molecules/FormSectionHeader.d.ts

@@ -5,7 +5,7 @@
  * Provides consistent styling and interaction for section headers.
  */
 import React from "react";
-import type { IconInput } from "../atoms";
+import type { IconInput } from "../atoms/index";
 export interface FormSectionHeaderProps {
     /** Section title */
     title: string;

package/dist/components/core/molecules/GraphCanvas.d.ts

@@ -73,8 +73,6 @@ export interface GraphCanvasProps {
     linkOpacity?: number;
     /** Layout algorithm */
     layout?: "force" | "circular" | "grid";
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
     /** Loading state */
     isLoading?: boolean;
     /** Error state */

package/dist/components/core/molecules/Header.d.ts

@@ -6,7 +6,7 @@
  */
 import React from "react";
 import type { AssetUrl } from "@almadar/core";
-import type { IconInput } from "../atoms";
+import type { IconInput } from "../atoms/index";
 import type { UiError } from '../atoms/types';
 export type HeaderLook = "hero" | "compact-bar" | "breadcrumb" | "contextual" | "editorial-banner";
 export interface HeaderNavigationItem {

package/dist/components/core/molecules/Menu.d.ts

@@ -5,7 +5,7 @@
  * Uses theme-aware CSS variables for styling.
  */
 import React from "react";
-import type { IconInput } from "../atoms";
+import type { IconInput } from "../atoms/index";
 export interface MenuItem {
     /** Item ID (auto-generated from label if not provided) */
     id?: string;

package/dist/components/core/molecules/Navigation.d.ts

@@ -5,7 +5,7 @@
  * Uses Menu, ButtonGroup molecules and Button, Icon, Badge, Typography, Divider atoms.
  */
 import React from 'react';
-import type { IconInput } from '../atoms';
+import type { IconInput } from '../atoms/index';
 import type { UiError } from '../atoms/types';
 export interface NavigationItem {
     /**

package/dist/components/core/molecules/OrbitalVisualization.d.ts

@@ -43,8 +43,6 @@ export interface OrbitalVisualizationProps {
     isLoading?: boolean;
     /** Error state */
     error?: UiError | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
 }
 export declare const OrbitalVisualization: React.FC<OrbitalVisualizationProps>;
 export default OrbitalVisualization;

package/dist/components/core/molecules/PageHeader.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 import type { EventEmit } from "@almadar/core";
-import type { IconInput } from "../atoms";
+import type { IconInput } from "../atoms/index";
 import type { UiError } from '../atoms/types';
 export interface PageBreadcrumb {
     label: string;

package/dist/components/core/molecules/RepeatableFormSection.d.ts

@@ -14,11 +14,12 @@ import React from "react";
 import type { JsonValue } from "@almadar/core";
 export type RepeatableItem = {
     id: string;
-    /** State in which this item was added (for audit trails) */
-    addedInState: string | null;
-    /** Timestamp when item was added */
-    addedAt: string | null;
-    [key: string]: JsonValue;
+    /** State in which this item was added (for audit trails). Optional — only
+     *  consumers using `trackAddedInState`/`showAuditInfo` populate it. */
+    addedInState?: string | null;
+    /** Timestamp when item was added. Optional — see `addedInState`. */
+    addedAt?: string | null;
+    [key: string]: JsonValue | undefined;
 };
 export interface RepeatableFormSectionProps {
     /** Section type identifier */

package/dist/components/core/molecules/Section.d.ts

@@ -35,8 +35,6 @@ export interface SectionProps {
     isLoading?: boolean;
     /** Error state */
     error?: UiError | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
 }
 /**
  * Section - Semantic content grouping with header

package/dist/components/core/molecules/Sidebar.d.ts

@@ -11,7 +11,7 @@
  */
 import React from 'react';
 import type { AssetUrl, EventEmit } from '@almadar/core';
-import type { IconInput } from '../atoms';
+import type { IconInput } from '../atoms/index';
 import type { UiError } from '../atoms/types';
 export interface SidebarItem {
     /** Item ID */

package/dist/components/core/molecules/SignaturePad.d.ts

@@ -36,8 +36,6 @@ export interface SignaturePadProps {
     }>;
     /** Event to emit on clear */
     clearEvent?: EventEmit<Record<string, never>>;
-    /** Entity name for schema-driven context */
-    entity?: string;
     /** Loading state */
     isLoading?: boolean;
     /** Error state */

package/dist/components/core/molecules/Split.d.ts

@@ -33,8 +33,6 @@ export interface SplitProps {
     isLoading?: boolean;
     /** Error state */
     error?: UiError | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
 }
 /**
  * Split - Two-column layout with flexible ratios

package/dist/components/core/molecules/StatDisplay.d.ts

@@ -6,7 +6,7 @@
  * No entity prop, no data fetching, no hooks beyond icon resolution.
  */
 import React from 'react';
-import type { IconInput } from '../atoms';
+import type { IconInput } from '../atoms/index';
 import type { UiError } from '../atoms/types';
 export type StatDisplayLook = 'elevated' | 'flat' | 'progress-backed' | 'gauge' | 'sparkline';
 export interface StatDisplayProps {

package/dist/components/core/molecules/SwipeableRow.d.ts

@@ -7,7 +7,7 @@
  */
 import React from 'react';
 import type { EventKey, EventPayload } from "@almadar/core";
-import type { IconInput } from '../atoms';
+import type { IconInput } from '../atoms/index';
 export interface SwipeAction {
     label: string;
     icon?: IconInput;

package/dist/components/core/molecules/TableView.d.ts

@@ -13,7 +13,7 @@
  */
 import React from 'react';
 import type { EntityRow, EventKey } from '@almadar/core';
-import type { IconInput } from '../atoms';
+import type { IconInput } from '../atoms/index';
 import { type DataDndProps } from './useDataDnd';
 import type { UiError } from '../atoms/types';
 export interface TableViewColumn {

package/dist/components/core/molecules/Tabs.d.ts

@@ -6,7 +6,7 @@
  */
 import React from 'react';
 import type { EventEmit } from '@almadar/core';
-import type { IconInput } from '../atoms';
+import type { IconInput } from '../atoms/index';
 export interface TabItem {
     /**
      * Tab ID. Optional — schema-driven callers may pass `value` instead;

package/dist/components/core/molecules/UploadDropZone.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 import type { EventKey, EventPayload } from "@almadar/core";
-import type { IconInput } from "../atoms";
+import type { IconInput } from "../atoms/index";
 export interface UploadDropZoneProps {
     /** Accepted MIME types (e.g., "image/*", "application/pdf") */
     accept?: string;

package/dist/components/core/molecules/WizardContainer.d.ts

@@ -152,8 +152,6 @@ export interface WizardContainerProps {
     isLoading?: boolean;
     /** Error state */
     error?: UiError | null;
-    /** Entity type name (schema-driven) */
-    entity?: string;
 }
 /**
  * WizardContainer - Multi-step wizard

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

@@ -51,7 +51,7 @@ export { DateRangeSelector, type DateRangeSelectorProps, type DateRangeSelectorO
 export { ChartLegend, type ChartLegendProps, type ChartLegendItem } from './ChartLegend';
 export { LineChart, type LineChartProps, type ChartDataPoint } from './LineChart';
 export { ProgressDots, type ProgressDotsProps, type DotState, type DotSize } from './ProgressDots';
-export * from '../../game/molecules';
+export * from '../../game/2d/molecules/index';
 export { GraphView, type GraphViewProps, type GraphViewNode, type GraphViewEdge } from './GraphView';
 export { MapView, type MapViewProps, type MapMarkerData, type MapRouteData, type MapRouteWaypoint } from './MapView';
 export { NumberStepper, type NumberStepperProps, type NumberStepperSize } from './NumberStepper';

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

@@ -12,7 +12,7 @@
  * @packageDocumentation
  */
 import React from "react";
-import { type UISlot, type SlotContent } from "../../../context/UISlotContext";
+import { type UISlot, type SlotContent } from "../../../providers/UISlotContext";
 export interface SuspenseConfig {
     /** Enable Suspense boundaries around slot content */
     enabled: boolean;

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

@@ -7,9 +7,9 @@ export { List, type ListProps, type ListItem } from "./List";
 export { CardGrid, type CardGridProps, type CardGridGap } from "./CardGrid";
 export { MasterDetail, type MasterDetailProps } from "./MasterDetail";
 export { StateMachineView, DomStateMachineVisualizer, OrbitalStateMachineView, type StateMachineViewProps, type TransitionBundle, } from "./StateMachineView";
-export * from "./book";
-export * from "./layout";
-export * from "../../game/organisms";
+export * from "./book/index";
+export * from "./layout/index";
+export * from "../../game/2d/molecules/index";
 export { UISlotRenderer, UISlotComponent, SlotContentRenderer, type UISlotRendererProps, } from "./UISlotRenderer";
 export { ModalSlot, type ModalSlotProps } from "./ModalSlot";
 export { DrawerSlot, type DrawerSlotProps } from "./DrawerSlot";
@@ -17,7 +17,7 @@ export { ToastSlot, type ToastSlotProps } from "./ToastSlot";
 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 { RuntimeDebugger, type RuntimeDebuggerProps, } from "./debug/index";
 export { HeroOrganism, type HeroOrganismProps, } from "../../marketing/organisms/HeroOrganism";
 export { FeatureGridOrganism, type FeatureGridOrganismProps, } from "../../marketing/organisms/FeatureGridOrganism";
 export { PricingOrganism, type PricingOrganismProps, } from "../../marketing/organisms/PricingOrganism";

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

@@ -2,19 +2,19 @@ export type { TemplateProps } from './types';
 export { DashboardLayout, type DashboardLayoutProps, type NavItem } from './DashboardLayout';
 export { AuthLayout, type AuthLayoutProps } from '../../marketing/templates/AuthLayout';
 export { CounterTemplate, type CounterTemplateProps, type CounterSize, type CounterVariant } from './CounterTemplate';
-export { GameTemplate, type GameTemplateProps } from '../../game/templates/GameTemplate';
+export { GameTemplate, type GameTemplateProps } from '../../game/2d/templates/GameTemplate';
 export { GenericAppTemplate, type GenericAppTemplateProps } from './GenericAppTemplate';
-export { GameShell, type GameShellProps } from '../../game/templates/GameShell';
-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 { PlatformerTemplate, type PlatformerTemplateProps, } from '../../game/templates/PlatformerTemplate';
-export { TowerDefenseTemplate, type TowerDefenseTemplateProps, } from '../../game/templates/TowerDefenseTemplate';
-export { RoguelikeTemplate, type RoguelikeTemplateProps, } from '../../game/templates/RoguelikeTemplate';
-export { TopDownShooterTemplate, type TopDownShooterTemplateProps, } from '../../game/templates/TopDownShooterTemplate';
-export { CityBuilderTemplate, type CityBuilderTemplateProps, } from '../../game/templates/CityBuilderTemplate';
-export { VisualNovelTemplate, type VisualNovelTemplateProps, } from '../../game/templates/VisualNovelTemplate';
-export { CardBattlerTemplate, type CardBattlerTemplateProps, } from '../../game/templates/CardBattlerTemplate';
+export { GameShell, type GameShellProps } from '../../game/2d/templates/GameShell';
+export { BattleTemplate, type BattleTemplateProps, type BattlePhase, type BattleSlotContext, } from '../../game/2d/templates/BattleTemplate';
+export { CastleTemplate, type CastleTemplateProps, type CastleSlotContext, } from '../../game/2d/templates/CastleTemplate';
+export { WorldMapTemplate, type WorldMapTemplateProps, type WorldMapSlotContext, } from '../../game/2d/templates/WorldMapTemplate';
+export { PlatformerTemplate, type PlatformerTemplateProps, } from '../../game/2d/templates/PlatformerTemplate';
+export { TowerDefenseTemplate, type TowerDefenseTemplateProps, } from '../../game/2d/templates/TowerDefenseTemplate';
+export { RoguelikeTemplate, type RoguelikeTemplateProps, } from '../../game/2d/templates/RoguelikeTemplate';
+export { TopDownShooterTemplate, type TopDownShooterTemplateProps, } from '../../game/2d/templates/TopDownShooterTemplate';
+export { CityBuilderTemplate, type CityBuilderTemplateProps, } from '../../game/2d/templates/CityBuilderTemplate';
+export { VisualNovelTemplate, type VisualNovelTemplateProps, } from '../../game/2d/templates/VisualNovelTemplate';
+export { CardBattlerTemplate, type CardBattlerTemplateProps, } from '../../game/2d/templates/CardBattlerTemplate';
 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';

package/dist/components/game/{atoms → 2d/atoms}/ActionButton.d.ts

@@ -1,4 +1,4 @@
-import { type IconInput } from '../../core/atoms/Icon';
+import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
 export interface ActionButtonProps {
     /** Sprite asset — takes precedence over icon when provided */

package/dist/components/game/{atoms → 2d/atoms}/ChoiceButton.d.ts

@@ -1,4 +1,4 @@
-import { type IconInput } from '../../core/atoms/Icon';
+import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
 export interface ChoiceButtonProps {
     /** Choice text content */

package/dist/components/game/{atoms → 2d/atoms}/ControlButton.d.ts

@@ -1,5 +1,5 @@
 import type { EventKey, Asset } from "@almadar/core";
-import { type IconInput } from '../../core/atoms/Icon';
+import { type IconInput } from '../../../core/atoms/Icon';
 export interface ControlButtonProps {
     /** Sprite asset — takes precedence over icon when provided */
     assetUrl?: Asset;

package/dist/components/game/{organisms → 2d/atoms}/GameAudioToggle.d.ts

@@ -11,7 +11,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { UiError } from '../../core/atoms/types';
+import type { UiError } from '../../../core/atoms/types';
 export interface GameAudioToggleProps {
     /** Button size */
     size?: 'sm' | 'md' | 'lg';
@@ -21,8 +21,6 @@ export interface GameAudioToggleProps {
     isLoading?: boolean;
     /** Error state (passed through) */
     error?: UiError | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
 }
 export declare function GameAudioToggle({ size, className, }: GameAudioToggleProps): React.JSX.Element;
 export declare namespace GameAudioToggle {

package/dist/components/game/2d/atoms/GameCard.d.ts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+import type { Asset, EventEmit } from '@almadar/core';
+export interface GameCardProps {
+    id: string;
+    cost?: number;
+    /** Card art asset */
+    art?: Asset;
+    attack?: number;
+    defense?: number;
+    name?: string;
+    selected?: boolean;
+    disabled?: boolean;
+    /** Size variant — controls card dimensions and art pixel size */
+    size?: 'sm' | 'md' | 'lg';
+    /** Direct click callback */
+    onClick?: (id: string) => void;
+    /** Event-bus event emitted with `{ cardId }` on click */
+    clickEvent?: EventEmit<{
+        cardId: string;
+    }>;
+    className?: string;
+}
+export declare function GameCard({ id, cost, art, attack, defense, name, selected, disabled, size, onClick, clickEvent, className, }: GameCardProps): React.JSX.Element;
+export declare namespace GameCard {
+    var displayName: string;
+}

package/dist/components/game/2d/atoms/GameIcon.d.ts

@@ -0,0 +1,18 @@
+import type { Asset } from '@almadar/core';
+import { type IconInput } from '../../../core/atoms/Icon';
+export interface GameIconProps {
+    /** Asset — when url is present, renders an img (Asset-primary). */
+    assetUrl?: Asset;
+    /** Lucide component or kebab-case icon name (fallback when no assetUrl). */
+    icon: IconInput;
+    /** Pixel size or named variant. */
+    size?: number | 'sm' | 'md' | 'lg';
+    /** Alt text for the img (defaults to assetUrl.category). */
+    alt?: string;
+    /** Additional CSS classes. */
+    className?: string;
+}
+export declare function GameIcon({ assetUrl, icon, size, alt, className }: GameIconProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace GameIcon {
+    var displayName: string;
+}

package/dist/components/game/2d/atoms/HealthBar.d.ts

@@ -0,0 +1,26 @@
+export interface HealthBarProps {
+    /** Current value */
+    current: number;
+    /** Maximum value */
+    max: number;
+    /** Display format.
+     * - `hearts` / `bar` / `numeric` — health display
+     * - `progress` — XP / generic progress bar with optional level badge and value label */
+    format?: 'hearts' | 'bar' | 'numeric' | 'progress';
+    /** Current level — shown as "Lv.N" badge when format="progress" */
+    level?: number;
+    /** Show value label below bar when format="progress" */
+    showLabel?: boolean;
+    /** Label suffix shown next to the value (e.g. "XP") when showLabel=true */
+    labelSuffix?: string;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS classes */
+    className?: string;
+    /** Animation on change */
+    animated?: boolean;
+}
+export declare function HealthBar({ current, max, format, level, showLabel, labelSuffix, size, className, animated, }: HealthBarProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace HealthBar {
+    var displayName: string;
+}

package/dist/components/game/{atoms → 2d/atoms}/ItemSlot.d.ts

@@ -1,4 +1,4 @@
-import { type IconInput } from '../../core/atoms/Icon';
+import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
 export interface ItemSlotProps {
     /** Sprite asset — takes precedence over icon when provided */

package/dist/components/game/{atoms → 2d/atoms}/MiniMap.d.ts

@@ -1,4 +1,4 @@
-import type { Rect } from '../../core/atoms/types';
+import type { Rect } from '../../../core/atoms/types';
 export interface MiniMapTile {
     x: number;
     y: number;

package/dist/components/game/{atoms → 2d/atoms}/ResourceCounter.d.ts

@@ -1,5 +1,5 @@
-import type { ColorToken } from '../../core/atoms/types';
-import { type IconInput } from '../../core/atoms/Icon';
+import type { ColorToken } from '../../../core/atoms/types';
+import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
 export interface ResourceCounterProps {
     /** Sprite asset — takes precedence over icon when provided */

package/dist/components/game/{atoms → 2d/atoms}/ScoreDisplay.d.ts

@@ -1,4 +1,4 @@
-import { type IconInput } from '../../core/atoms/Icon';
+import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
 export interface ScoreDisplayProps {
     /** Sprite asset — takes precedence over icon when provided */

package/dist/components/game/{atoms → 2d/atoms}/Sprite.d.ts

@@ -5,7 +5,7 @@
  */
 import React from 'react';
 import type { EventKey, Asset } from "@almadar/core";
-import type { AnimationName } from '../organisms/types/spriteAnimation';
+import type { AnimationName } from '../../shared/spriteAnimationTypes';
 export interface SpriteProps {
     /** Spritesheet asset */
     spritesheet: Asset;

package/dist/components/game/{atoms → 2d/atoms}/StateIndicator.d.ts

@@ -1,16 +1,17 @@
 import React from 'react';
-import { type IconInput } from '../../core/atoms/Icon';
+import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
 export interface StateStyle {
     icon: IconInput;
     bgClass: string;
 }
+export type StateIndicatorState = 'idle' | 'active' | 'sleeping' | 'moving' | 'eating' | 'waiting' | 'happy' | 'scared' | 'done' | 'error' | 'ready' | 'cooldown';
 export interface StateIndicatorProps {
     /** Sprite image URL — takes precedence over the state icon when provided */
     assetUrl?: Asset;
-    /** The current state name */
-    state: string;
-    /** Optional label override (defaults to capitalized state name) */
+    /** The current state — known values get a styled indicator, unknown values fall back to default */
+    state: StateIndicatorState | string;
+    /** Optional label override */
     label?: string;
     /** Size variant */
     size?: 'sm' | 'md' | 'lg';

package/dist/components/game/{atoms → 2d/atoms}/StatusEffect.d.ts

@@ -1,10 +1,10 @@
-import { type IconInput } from '../../core/atoms/Icon';
+import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
 export interface StatusEffectProps {
     /** Sprite asset — takes precedence over icon when provided */
     assetUrl?: Asset;
     /** Lucide icon name or component */
-    icon: IconInput;
+    icon?: IconInput;
     /** Label describing the effect */
     label?: string;
     /** Remaining duration in seconds */

package/dist/components/game/{atoms → 2d/atoms}/WaypointMarker.d.ts

@@ -1,4 +1,4 @@
-import { type IconInput } from '../../core/atoms/Icon';
+import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
 export interface WaypointMarkerProps {
     /** Sprite asset — takes precedence over icon when provided */