@almadar/ui 5.103.0 → 5.105.0

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

@@ -111,7 +111,7 @@ export interface DataGridProps extends DataDndProps {
      */
     look?: "dense" | "spacious" | "striped" | "borderless" | "card-rows";
 }
-export declare function DataGrid({ entity, fields, columns, itemActions, maxInlineActions, scrollX, cols, gap, minCardWidth, className, isLoading, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataGridProps): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
+export declare function DataGrid({ entity, fields, columns, itemActions, maxInlineActions, scrollX, cols, gap, minCardWidth, className, isLoading, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataGridProps): string | number | bigint | boolean | React.JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
 export declare namespace DataGrid {
     var displayName: string;
 }

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

@@ -123,7 +123,7 @@ export interface DataListProps extends DataDndProps {
      */
     look?: "dense" | "spacious" | "striped" | "borderless" | "card-rows";
 }
-export declare function DataList({ entity, fields, columns, itemActions, maxInlineActions, itemClickEvent, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataListProps): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
+export declare function DataList({ entity, fields, columns, itemActions, maxInlineActions, itemClickEvent, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataListProps): string | number | bigint | boolean | React.JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
 export declare namespace DataList {
     var displayName: string;
 }

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

@@ -1,3 +1,10 @@
+/**
+ * DocPagination Molecule
+ *
+ * Previous/Next navigation links for documentation pages.
+ * Composed from HStack, Box, VStack, Icon, and Typography atoms.
+ */
+import React from 'react';
 export interface DocPaginationLink {
     label: string;
     href: string;
@@ -11,4 +18,4 @@ export interface DocPaginationProps {
     /** Additional class names */
     className?: string;
 }
-export declare function DocPagination({ prev, next, className }: DocPaginationProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function DocPagination({ prev, next, className }: DocPaginationProps): React.JSX.Element | null;

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

@@ -1,3 +1,10 @@
+/**
+ * DocSearch — documentation search input with inline results dropdown (distinct from SearchInput).
+ * SearchInput emits bus events for entity-list filtering with debounce.
+ * DocSearch drives a callback-based result list with keyboard navigation and
+ * popover dropdown; designed for docs site navigation, not data-list filtering.
+ */
+import React from 'react';
 export interface DocSearchResult {
     title: string;
     href: string;
@@ -12,4 +19,4 @@ export interface DocSearchProps {
     /** Additional class names */
     className?: string;
 }
-export declare function DocSearch({ placeholder, onSearch, className, }: DocSearchProps): import("react/jsx-runtime").JSX.Element;
+export declare function DocSearch({ placeholder, onSearch, className, }: DocSearchProps): React.JSX.Element;

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

@@ -19,6 +19,6 @@ export interface FlipCardProps {
     height?: string;
 }
 export declare const FlipCard: {
-    ({ front, back, flipped, onFlip, className, height, }: FlipCardProps): import("react/jsx-runtime").JSX.Element;
+    ({ front, back, flipped, onFlip, className, height, }: FlipCardProps): React.JSX.Element;
     displayName: string;
 };

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

@@ -6,7 +6,9 @@
  */
 import React from 'react';
 export interface ChartDataPoint {
-    date: string | Date;
+    /** Optional: chronological x-axis. Absent for a categorical line chart
+     * (label-as-x), which plots points in author order. */
+    date?: string | Date;
     value: number;
     label?: string;
 }

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

@@ -1,3 +1,20 @@
+/**
+ * MapView Molecule Component
+ *
+ * Interactive map using react-leaflet with OpenStreetMap tiles.
+ * Supports both programmatic callbacks (onMapClick) and schema-driven
+ * event dispatch (mapClickEvent) via the event bus.
+ *
+ * Why this file looks weird: Leaflet's core/Util.js evaluates
+ * `window.requestAnimationFrame` at module load time, which crashes any
+ * SSR/SSG environment (Docusaurus, Next.js RSC, etc.) the moment a
+ * consumer statically imports something that transitively reaches MapView.
+ * To stay SSR-safe, the actual leaflet bindings are loaded lazily inside
+ * a `React.lazy(async () => …)` callback so the leaflet module is only
+ * evaluated when the component is rendered for the first time, which
+ * never happens on the server because Suspense shows the fallback there.
+ */
+import React from 'react';
 import type { EventEmit } from '@almadar/core';
 export type MapMarkerData = {
     /** Unique marker identifier */
@@ -67,4 +84,4 @@ export interface MapViewProps {
  * lazy implementation finishes loading on the client) so SSR never reaches
  * the leaflet code.
  */
-export declare function MapView(props: MapViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function MapView(props: MapViewProps): React.JSX.Element;

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

@@ -14,6 +14,6 @@ export interface SortableListProps {
     dragHandlePosition?: 'left' | 'right';
     className?: string;
 }
-declare function SortableListInner({ items: initialItemsProp, renderItem, reorderEvent, reorderPayload, dragHandlePosition, className, }: SortableListProps): import("react/jsx-runtime").JSX.Element;
+declare function SortableListInner({ items: initialItemsProp, renderItem, reorderEvent, reorderPayload, dragHandlePosition, className, }: SortableListProps): React.JSX.Element;
 export declare const SortableList: typeof SortableListInner;
 export {};

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

@@ -105,7 +105,7 @@ export interface TableViewProps extends DataDndProps {
      */
     look?: 'dense' | 'spacious' | 'striped' | 'borderless' | 'bordered';
 }
-export declare function TableView({ entity, columns, fields, itemActions, maxInlineActions, selectable, selectEvent, selectedIds, sortEvent, sortColumn, sortDirection, className, emptyMessage, isLoading, error, groupBy, pageSize, children, renderItem: _schemaRenderItem, look, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, }: TableViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function TableView({ entity, columns, fields, itemActions, maxInlineActions, selectable, selectEvent, selectedIds, sortEvent, sortColumn, sortDirection, className, emptyMessage, isLoading, error, groupBy, pageSize, children, renderItem: _schemaRenderItem, look, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, }: TableViewProps): React.JSX.Element;
 export declare namespace TableView {
     var displayName: string;
 }

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

@@ -5,8 +5,12 @@ import { DisplayStateProps } from "./types";
 import type { EntityRow, FieldValue } from "@almadar/core";
 export type EntityTableLook = "dense" | "spacious" | "striped" | "borderless" | "card-rows";
 export interface Column<T> {
-    key: keyof T | string;
-    header: string;
+    /** Column identity. Optional because `name` is an accepted alias; the
+     * compiler emits `{ name, label }` columns and `normalizeColumns` fills
+     * `key`/`header` from the aliases, so a column needs (`key` OR `name`) and
+     * (`header` OR `label`), not literally `key`+`header`. */
+    key?: keyof T | string;
+    header?: string;
     /** Alias for key (used by compiler-generated fields) */
     name?: string;
     /** Alias for header (used by compiler-generated fields) */
@@ -69,7 +73,7 @@ export interface DataTableProps<T extends EntityRow & {
 }
 export declare function DataTable<T extends EntityRow & {
     id: string | number;
-}>({ fields, columns, entity, itemActions, isLoading, error, emptyIcon, emptyTitle, emptyDescription, emptyAction, selectable, selectedIds, sortBy, sortDirection, searchable, searchValue, searchPlaceholder, page, pageSize, totalCount, rowActions: externalRowActions, bulkActions, headerActions, showTotal, className, look, }: DataTableProps<T>): import("react/jsx-runtime").JSX.Element;
+}>({ fields, columns, entity, itemActions, isLoading, error, emptyIcon, emptyTitle, emptyDescription, emptyAction, selectable, selectedIds, sortBy, sortDirection, searchable, searchValue, searchPlaceholder, page, pageSize, totalCount, rowActions: externalRowActions, bulkActions, headerActions, showTotal, className, look, }: DataTableProps<T>): React.JSX.Element;
 export declare namespace DataTable {
     var displayName: string;
 }

package/dist/components/core/organisms/debug/RuntimeDebugger.d.ts

@@ -1,3 +1,12 @@
+/**
+ * RuntimeDebugger - Main debug panel for KFlow applications
+ *
+ * Press backtick (`) to toggle. Displays traits, ticks, entities, events,
+ * guards, verification checks, transition timeline, and server bridge health.
+ *
+ * @packageDocumentation
+ */
+import * as React from 'react';
 import type { OrbitalSchema } from '@almadar/core';
 import './RuntimeDebugger.css';
 export interface RuntimeDebuggerProps {
@@ -14,7 +23,7 @@ export interface RuntimeDebuggerProps {
     /** Raw schema for EventDispatcherTab payload extraction */
     schema?: OrbitalSchema;
 }
-export declare function RuntimeDebugger({ position, defaultCollapsed, className, mode, defaultTab, schema, }: RuntimeDebuggerProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function RuntimeDebugger({ position, defaultCollapsed, className, mode, defaultTab, schema, }: RuntimeDebuggerProps): React.JSX.Element | null;
 export declare namespace RuntimeDebugger {
     var displayName: string;
 }

package/dist/components/core/organisms/debug/tabs/EntitiesTab.d.ts

@@ -2,11 +2,12 @@
  * EntitiesTab - Displays entity snapshots
  * Uses existing component library atoms/molecules.
  */
+import * as React from 'react';
 import type { EntitySnapshot } from '../../../../../lib/entityDebug';
 interface EntitiesTabProps {
     snapshot: EntitySnapshot | null;
 }
-export declare function EntitiesTab({ snapshot }: EntitiesTabProps): import("react/jsx-runtime").JSX.Element;
+export declare function EntitiesTab({ snapshot }: EntitiesTabProps): React.JSX.Element;
 export declare namespace EntitiesTab {
     var displayName: string;
 }

package/dist/components/core/organisms/debug/tabs/EventDispatcherTab.d.ts

@@ -4,13 +4,14 @@
  * Shows available transitions per trait based on current state,
  * lets users click to fire events, and displays a compact transition log.
  */
+import * as React from 'react';
 import type { OrbitalSchema } from '@almadar/core';
 import type { TraitDebugInfo } from '../../../../../lib/traitRegistry';
 interface EventDispatcherTabProps {
     traits: TraitDebugInfo[];
     schema?: OrbitalSchema;
 }
-export declare function EventDispatcherTab({ traits, schema }: EventDispatcherTabProps): import("react/jsx-runtime").JSX.Element;
+export declare function EventDispatcherTab({ traits, schema }: EventDispatcherTabProps): React.JSX.Element;
 export declare namespace EventDispatcherTab {
     var displayName: string;
 }

package/dist/components/core/organisms/debug/tabs/EventFlowTab.d.ts

@@ -1,8 +1,13 @@
+/**
+ * EventFlowTab - Displays event flow and debug messages
+ * Uses existing component library atoms/molecules.
+ */
+import * as React from 'react';
 import type { DebugEvent } from '../../../../../lib/debugRegistry';
 interface EventFlowTabProps {
     events: DebugEvent[];
 }
-export declare function EventFlowTab({ events }: EventFlowTabProps): import("react/jsx-runtime").JSX.Element;
+export declare function EventFlowTab({ events }: EventFlowTabProps): React.JSX.Element;
 export declare namespace EventFlowTab {
     var displayName: string;
 }

package/dist/components/core/organisms/debug/tabs/GuardsPanel.d.ts

@@ -1,8 +1,13 @@
+/**
+ * GuardsPanel - Displays guard evaluation history
+ * Uses existing component library atoms/molecules.
+ */
+import * as React from 'react';
 import type { GuardEvaluation } from '../../../../../lib/guardRegistry';
 interface GuardsPanelProps {
     guards: GuardEvaluation[];
 }
-export declare function GuardsPanel({ guards }: GuardsPanelProps): import("react/jsx-runtime").JSX.Element;
+export declare function GuardsPanel({ guards }: GuardsPanelProps): React.JSX.Element;
 export declare namespace GuardsPanel {
     var displayName: string;
 }

package/dist/components/core/organisms/debug/tabs/ServerBridgeTab.d.ts

@@ -1,8 +1,19 @@
+/**
+ * ServerBridgeTab - Displays ServerBridge health and connectivity status
+ *
+ * Shows:
+ * - Connection status (connected/disconnected)
+ * - Events forwarded (client → server) count
+ * - Events received (server → client) count
+ * - Last error if any
+ * - Last heartbeat timestamp
+ */
+import * as React from 'react';
 import type { BridgeHealth } from '../../../../../lib/verificationRegistry';
 interface ServerBridgeTabProps {
     bridge: BridgeHealth | null;
 }
-export declare function ServerBridgeTab({ bridge }: ServerBridgeTabProps): import("react/jsx-runtime").JSX.Element;
+export declare function ServerBridgeTab({ bridge }: ServerBridgeTabProps): React.JSX.Element;
 export declare namespace ServerBridgeTab {
     var displayName: string;
 }

package/dist/components/core/organisms/debug/tabs/TicksTab.d.ts

@@ -2,11 +2,12 @@
  * TicksTab - Displays tick execution timing and status
  * Uses existing component library atoms/molecules.
  */
+import * as React from 'react';
 import type { TickExecution } from '../../../../../lib/tickRegistry';
 interface TicksTabProps {
     ticks: TickExecution[];
 }
-export declare function TicksTab({ ticks }: TicksTabProps): import("react/jsx-runtime").JSX.Element;
+export declare function TicksTab({ ticks }: TicksTabProps): React.JSX.Element;
 export declare namespace TicksTab {
     var displayName: string;
 }

package/dist/components/core/organisms/debug/tabs/TraitsTab.d.ts

@@ -2,11 +2,12 @@
  * TraitsTab - Displays active traits and their state machines
  * Uses existing component library atoms/molecules.
  */
+import * as React from 'react';
 import type { TraitDebugInfo } from '../../../../../lib/traitRegistry';
 interface TraitsTabProps {
     traits: TraitDebugInfo[];
 }
-export declare function TraitsTab({ traits }: TraitsTabProps): import("react/jsx-runtime").JSX.Element;
+export declare function TraitsTab({ traits }: TraitsTabProps): React.JSX.Element;
 export declare namespace TraitsTab {
     var displayName: string;
 }

package/dist/components/core/organisms/debug/tabs/TransitionTimeline.d.ts

@@ -1,8 +1,18 @@
+/**
+ * TransitionTimeline - Visual timeline of state machine transitions
+ *
+ * Shows each transition with:
+ * - Trait name, from → to state, triggering event
+ * - Guard result (if any)
+ * - Effect execution results (green = executed, red = failed)
+ * - Timestamp
+ */
+import * as React from 'react';
 import type { TransitionTrace } from '../../../../../lib/verificationRegistry';
 interface TransitionTimelineProps {
     transitions: TransitionTrace[];
 }
-export declare function TransitionTimeline({ transitions }: TransitionTimelineProps): import("react/jsx-runtime").JSX.Element;
+export declare function TransitionTimeline({ transitions }: TransitionTimelineProps): React.JSX.Element;
 export declare namespace TransitionTimeline {
     var displayName: string;
 }

package/dist/components/core/organisms/debug/tabs/VerificationTab.d.ts

@@ -1,9 +1,16 @@
+/**
+ * VerificationTab - Displays pass/fail verification checklist
+ *
+ * Shows all registered checks with their status, grouped by category.
+ * Green = pass, Red = fail, Yellow = warn, Gray = pending.
+ */
+import * as React from 'react';
 import type { VerificationCheck, VerificationSummary } from '../../../../../lib/verificationRegistry';
 interface VerificationTabProps {
     checks: VerificationCheck[];
     summary: VerificationSummary;
 }
-export declare function VerificationTab({ checks, summary }: VerificationTabProps): import("react/jsx-runtime").JSX.Element;
+export declare function VerificationTab({ checks, summary }: VerificationTabProps): React.JSX.Element;
 export declare namespace VerificationTab {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset, EventKey } from '@almadar/core';
 export interface ActionButtonProps {
@@ -24,7 +25,7 @@ export interface ActionButtonProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function ActionButton({ assetUrl, label, icon, cooldown, disabled, hotkey, size, variant, onClick, action, className, }: ActionButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function ActionButton({ assetUrl, label, icon, cooldown, disabled, hotkey, size, variant, onClick, action, className, }: ActionButtonProps): React.JSX.Element;
 export declare namespace ActionButton {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset, EventKey } from '@almadar/core';
 export interface ChoiceButtonProps {
@@ -22,7 +23,7 @@ export interface ChoiceButtonProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function ChoiceButton({ text, index, assetUrl, icon, disabled, selected, onClick, action, payload, className, }: ChoiceButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChoiceButton({ text, index, assetUrl, icon, disabled, selected, onClick, action, payload, className, }: ChoiceButtonProps): React.JSX.Element;
 export declare namespace ChoiceButton {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { Asset } from '@almadar/core';
 export interface ComboCounterProps {
     /** Sprite asset displayed alongside the combo number */
@@ -13,7 +14,7 @@ export interface ComboCounterProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function ComboCounter({ assetUrl, combo, multiplier, streak, size, className, }: ComboCounterProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ComboCounter({ assetUrl, combo, multiplier, streak, size, className, }: ComboCounterProps): React.JSX.Element | null;
 export declare namespace ComboCounter {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { EventKey, Asset } from "@almadar/core";
 import { type IconInput } from '../../../core/atoms/Icon';
 export interface ControlButtonProps {
@@ -28,7 +29,7 @@ export interface ControlButtonProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function ControlButton({ assetUrl, label, icon, size, shape, variant, onPress, onRelease, pressEvent, releaseEvent, pressed, disabled, className, }: ControlButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function ControlButton({ assetUrl, label, icon, size, shape, variant, onPress, onRelease, pressEvent, releaseEvent, pressed, disabled, className, }: ControlButtonProps): React.JSX.Element;
 export declare namespace ControlButton {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { Asset } from '@almadar/core';
 export interface DamageNumberProps {
     /** Sprite asset — displayed as a hit-effect icon alongside the number */
@@ -11,7 +12,7 @@ export interface DamageNumberProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function DamageNumber({ assetUrl, value, type, size, className, }: DamageNumberProps): import("react/jsx-runtime").JSX.Element;
+export declare function DamageNumber({ assetUrl, value, type, size, className, }: DamageNumberProps): React.JSX.Element;
 export declare namespace DamageNumber {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { Asset } from '@almadar/core';
 export interface DialogueBubbleProps {
     /** Speaker name displayed at the top */
@@ -19,7 +20,7 @@ export interface DialogueBubbleProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function DialogueBubble({ speaker, text, portrait, position, mood, revealedChars, className, }: DialogueBubbleProps): import("react/jsx-runtime").JSX.Element;
+export declare function DialogueBubble({ speaker, text, portrait, position, mood, revealedChars, className, }: DialogueBubbleProps): React.JSX.Element;
 export declare namespace DialogueBubble {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { Asset } from '@almadar/core';
 import { type IconInput } from '../../../core/atoms/Icon';
 export interface GameIconProps {
@@ -12,7 +13,7 @@ export interface GameIconProps {
     /** Additional CSS classes. */
     className?: string;
 }
-export declare function GameIcon({ assetUrl, icon, size, alt, className }: GameIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function GameIcon({ assetUrl, icon, size, alt, className }: GameIconProps): React.JSX.Element;
 export declare namespace GameIcon {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { Asset } from '@almadar/core';
 export interface HealthBarProps {
     /** Current value */
@@ -25,7 +26,7 @@ export interface HealthBarProps {
     /** Sprite image tiled across the filled portion of bar/progress formats. Falls back to CSS color gradient. */
     fillAsset?: Asset;
 }
-export declare function HealthBar({ current, max, format, level, showLabel, labelSuffix, size, className, animated, frameAsset, fillAsset, }: HealthBarProps): import("react/jsx-runtime").JSX.Element;
+export declare function HealthBar({ current, max, format, level, showLabel, labelSuffix, size, className, animated, frameAsset, fillAsset, }: HealthBarProps): React.JSX.Element;
 export declare namespace HealthBar {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset, EventKey } from '@almadar/core';
 export interface ItemSlotProps {
@@ -24,7 +25,7 @@ export interface ItemSlotProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function ItemSlot({ assetUrl, icon, label, quantity, rarity, empty, size, selected, onClick, action, className, }: ItemSlotProps): import("react/jsx-runtime").JSX.Element;
+export declare function ItemSlot({ assetUrl, icon, label, quantity, rarity, empty, size, selected, onClick, action, className, }: ItemSlotProps): React.JSX.Element;
 export declare namespace ItemSlot {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { Asset } from '@almadar/core';
 import type { Rect } from '../../../core/atoms/types';
 export interface MiniMapTile {
@@ -33,7 +34,7 @@ export interface MiniMapProps {
     /** Map of unit id or unit type → Asset; when present, draws sprites instead of flat dots for units. */
     unitAssets?: Record<string, Asset>;
 }
-export declare function MiniMap({ tiles, units, width, height, mapWidth, mapHeight, viewportRect, className, tileAssets, unitAssets, }: MiniMapProps): import("react/jsx-runtime").JSX.Element;
+export declare function MiniMap({ tiles, units, width, height, mapWidth, mapHeight, viewportRect, className, tileAssets, unitAssets, }: MiniMapProps): React.JSX.Element;
 export declare namespace MiniMap {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { ColorToken } from '../../../core/atoms/types';
 import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
@@ -19,7 +20,7 @@ export interface ResourceCounterProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function ResourceCounter({ assetUrl, icon, label, value, max, color, size, className, }: ResourceCounterProps): import("react/jsx-runtime").JSX.Element;
+export declare function ResourceCounter({ assetUrl, icon, label, value, max, color, size, className, }: ResourceCounterProps): React.JSX.Element;
 export declare namespace ResourceCounter {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
 export interface ScoreDisplayProps {
@@ -18,7 +19,7 @@ export interface ScoreDisplayProps {
     /** Number formatting locale */
     locale?: string;
 }
-export declare function ScoreDisplay({ assetUrl, value, score, label, icon, size, className, locale, }: ScoreDisplayProps): import("react/jsx-runtime").JSX.Element;
+export declare function ScoreDisplay({ assetUrl, value, score, label, icon, size, className, locale, }: ScoreDisplayProps): React.JSX.Element;
 export declare namespace ScoreDisplay {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
 export interface StatusEffectProps {
@@ -18,7 +19,7 @@ export interface StatusEffectProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function StatusEffect({ assetUrl, icon, label, duration, stacks, variant, size, className, }: StatusEffectProps): import("react/jsx-runtime").JSX.Element;
+export declare function StatusEffect({ assetUrl, icon, label, duration, stacks, variant, size, className, }: StatusEffectProps): React.JSX.Element;
 export declare namespace StatusEffect {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { Asset } from '@almadar/core';
 export interface TimerDisplayProps {
     /** Time in seconds */
@@ -15,7 +16,7 @@ export interface TimerDisplayProps {
     /** Icon asset rendered to the left of the time value. Falls back to no icon. */
     iconAsset?: Asset;
 }
-export declare function TimerDisplay({ seconds, running, format, size, className, lowThreshold, iconAsset, }: TimerDisplayProps): import("react/jsx-runtime").JSX.Element;
+export declare function TimerDisplay({ seconds, running, format, size, className, lowThreshold, iconAsset, }: TimerDisplayProps): React.JSX.Element;
 export declare namespace TimerDisplay {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { Asset } from '@almadar/core';
 export interface TurnIndicatorProps {
     /** Sprite asset — takes precedence over the dot indicator when provided */
@@ -15,7 +16,7 @@ export interface TurnIndicatorProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function TurnIndicator({ assetUrl, currentTurn, maxTurns, activeTeam, phase, size, className, }: TurnIndicatorProps): import("react/jsx-runtime").JSX.Element;
+export declare function TurnIndicator({ assetUrl, currentTurn, maxTurns, activeTeam, phase, size, className, }: TurnIndicatorProps): React.JSX.Element;
 export declare namespace TurnIndicator {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
 export interface WaypointMarkerProps {
@@ -16,7 +17,7 @@ export interface WaypointMarkerProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function WaypointMarker({ assetUrl, label, icon, active, completed, size, className, }: WaypointMarkerProps): import("react/jsx-runtime").JSX.Element;
+export declare function WaypointMarker({ assetUrl, label, icon, active, completed, size, className, }: WaypointMarkerProps): React.JSX.Element;
 export declare namespace WaypointMarker {
     var displayName: string;
 }

package/dist/components/game/2d/molecules/Canvas2D.d.ts

@@ -21,7 +21,7 @@
  * @packageDocumentation
  */
 import * as React from 'react';
-import type { Asset, EventEmit } from '@almadar/core';
+import type { Asset, AssetUrl, EventEmit } from '@almadar/core';
 import type { IsometricTile, IsometricUnit, IsometricFeature, ActiveEffect } from '../../shared/isometricTypes';
 import type { ResolvedFrame } from '../../shared/spriteAnimationTypes';
 import type { UiError } from '../../../core/atoms/types';
@@ -79,8 +79,9 @@ export interface Canvas2DProps {
     platforms?: Platform[];
     /** Side-view player. `projection:'side'` only. */
     player?: SidePlayer;
-    /** Background image (tiled behind iso/hex/flat/free; stretched in side). */
-    backgroundImage?: Asset;
+    /** Background image (tiled behind iso/hex/flat/free; stretched in side).
+     * A bare URL string is accepted as shorthand for a standalone backdrop. */
+    backgroundImage?: AssetUrl | Asset;
     /** Currently selected unit ID */
     selectedUnitId?: string | null;
     /** Valid move positions (pulsing green highlights) */
@@ -125,7 +126,7 @@ export interface Canvas2DProps {
     /**
      * Opt-in: smooth-interpolate unit positions between LOLO tick snapshots
      * via a `requestAnimationFrame` loop (same fixed-timestep technique
-     * `SideView` already uses for the player), instead of the default
+     * `SideCanvas2D` already uses for the player), instead of the default
      * tick-rate-cadence redraw. DEFAULT OFF — for continuous-movement boards
      * only; tile-snapped boards see no behavior change.
      */
@@ -167,7 +168,7 @@ export interface Canvas2DProps {
         effects?: Record<string, Asset>;
     };
 }
-export declare function Canvas2D({ className, isLoading, error, projection, tiles: _tilesPropRaw, units: _unitsPropRaw, features: _featuresPropRaw, effects: _effectsPropRaw, platforms, player, backgroundImage, selectedUnitId, validMoves, attackTargets, hoveredTile, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, keyMap, keyUpMap, camera, scale, unitScale, showMinimap, animate, interpolateUnits, debug, spriteHeightRatio, spriteMaxWidthRatio, diamondTopY: diamondTopYProp, getTerrainSprite, getFeatureSprite, getUnitSprite, resolveUnitFrame, effectSpriteUrls, onDrawEffects, playerSprite, tileSprites, bgColor, worldWidth, worldHeight, assetManifest, }: Canvas2DProps): React.JSX.Element;
+export declare function Canvas2D({ className, isLoading, error, projection, tiles: _tilesPropRaw, units: _unitsPropRaw, features: _featuresPropRaw, effects: _effectsPropRaw, platforms, player, backgroundImage: backgroundImageRaw, selectedUnitId, validMoves, attackTargets, hoveredTile, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, keyMap, keyUpMap, camera, scale, unitScale, showMinimap, animate, interpolateUnits, debug, spriteHeightRatio, spriteMaxWidthRatio, diamondTopY: diamondTopYProp, getTerrainSprite, getFeatureSprite, getUnitSprite, resolveUnitFrame, effectSpriteUrls, onDrawEffects, playerSprite, tileSprites, bgColor, worldWidth, worldHeight, assetManifest, }: Canvas2DProps): React.JSX.Element;
 export declare namespace Canvas2D {
     var displayName: string;
 }

package/dist/components/game/2d/molecules/GameHud.d.ts

@@ -1,3 +1,4 @@
+import * as React from "react";
 import { type StatBadgeProps } from "./StatBadge";
 import type { Asset } from "@almadar/core";
 import type { IconInput } from "../../../core/atoms/index";
@@ -45,7 +46,7 @@ export interface GameHudProps {
     /** Whether to use a semi-transparent background */
     transparent?: boolean;
 }
-export declare function GameHud({ position: propPosition, stats: propStats, items, elements, size, className, transparent, }: GameHudProps): import("react/jsx-runtime").JSX.Element;
+export declare function GameHud({ position: propPosition, stats: propStats, items, elements, size, className, transparent, }: GameHudProps): React.JSX.Element;
 export declare namespace GameHud {
     var displayName: string;
 }