@almadar/ui 2.14.0 → 2.15.0

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

@@ -0,0 +1,61 @@
+/**
+ * Isometric Coordinate Utilities
+ *
+ * Pure functions for 2:1 diamond isometric coordinate conversion.
+ * No React dependencies — usable in any context.
+ *
+ * @packageDocumentation
+ */
+/** Base tile width in pixels (before scale) */
+export declare const TILE_WIDTH = 256;
+/** Base tile height in pixels (before scale) — full sprite image height (Kenney 256×512) */
+export declare const TILE_HEIGHT = 512;
+/** Floor diamond height — the "walkable surface" portion of the tile (TILE_WIDTH / 2 for 2:1 ratio) */
+export declare const FLOOR_HEIGHT = 128;
+/**
+ * Measured Y offset from sprite top to the diamond top vertex within a Kenney
+ * 256×512 tile sprite.  The code previously assumed `TILE_HEIGHT - FLOOR_HEIGHT = 384`,
+ * but the actual diamond (dirt_E.png) begins at y = 374 because the 3D side walls
+ * occupy 10 extra pixels above the pure 128 px diamond.
+ *
+ * Use `DIAMOND_TOP_Y * scale` for highlight positioning, unit groundY, feature
+ * placement, and hit-testing — NOT `(TILE_HEIGHT - FLOOR_HEIGHT) * scale`.
+ * `FLOOR_HEIGHT` remains 128 for the isoToScreen spacing formula (2:1 ratio).
+ */
+export declare const DIAMOND_TOP_Y = 374;
+/**
+ * Feature type → fallback color mapping (when sprites not loaded).
+ */
+export declare const FEATURE_COLORS: Record<string, string>;
+/**
+ * Convert tile grid coordinates to screen pixel coordinates.
+ *
+ * Uses 2:1 diamond isometric projection:
+ * - X increases to the lower-right
+ * - Y increases to the lower-left
+ *
+ * @param tileX - Grid X coordinate
+ * @param tileY - Grid Y coordinate
+ * @param scale - Render scale factor
+ * @param baseOffsetX - Horizontal offset to center the grid
+ * @returns Screen position { x, y } of the tile's top-left corner
+ */
+export declare function isoToScreen(tileX: number, tileY: number, scale: number, baseOffsetX: number): {
+    x: number;
+    y: number;
+};
+/**
+ * Convert screen pixel coordinates back to tile grid coordinates.
+ *
+ * Inverse of isoToScreen. Snaps to nearest integer tile position.
+ *
+ * @param screenX - Screen X in pixels
+ * @param screenY - Screen Y in pixels
+ * @param scale - Render scale factor
+ * @param baseOffsetX - Horizontal offset used in isoToScreen
+ * @returns Snapped grid position { x, y }
+ */
+export declare function screenToIso(screenX: number, screenY: number, scale: number, baseOffsetX: number): {
+    x: number;
+    y: number;
+};

package/dist/components/organisms/game/utils/spriteAnimation.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Sprite Animation Engine
+ *
+ * Pure functions for sprite sheet animation: direction inference,
+ * frame computation, sheet resolution, and animation state management.
+ * No React dependencies — usable in any context.
+ *
+ * @packageDocumentation
+ */
+import type { AnimationName, FacingDirection, SpriteDirection, ResolvedFrame, UnitAnimationState, SpriteFrameDims, SpriteSheetUrls } from '../types/spriteAnimation';
+/**
+ * Infer facing direction from a movement delta on the isometric grid.
+ * dx/dy are tile coordinate deltas (not screen pixels).
+ *
+ * Isometric grid:
+ *   NW ← (-x)    NE ← (-y)
+ *   SW ← (+y)    SE ← (+x)
+ */
+export declare function inferDirection(dx: number, dy: number): FacingDirection;
+/**
+ * Map a 4-direction facing to the actual sheet file direction + flipX flag.
+ * We only have SE and SW sheet images. NE/NW are rendered by flipping:
+ *   SE → SE sheet, no flip
+ *   SW → SW sheet, no flip
+ *   NE → SW sheet, flipX (mirror of SW gives NE)
+ *   NW → SE sheet, flipX (mirror of SE gives NW)
+ */
+export declare function resolveSheetDirection(facing: FacingDirection): {
+    sheetDir: SpriteDirection;
+    flipX: boolean;
+};
+/**
+ * Compute the current frame index and whether the animation has finished.
+ */
+export declare function getCurrentFrame(animName: AnimationName, elapsed: number): {
+    frame: number;
+    finished: boolean;
+};
+/**
+ * Resolve a complete frame descriptor for canvas drawing.
+ * Returns null if no sprite sheet URLs are available for this unit.
+ */
+export declare function resolveFrame(sheetUrls: SpriteSheetUrls | null, frameDims: SpriteFrameDims, animState: UnitAnimationState): ResolvedFrame | null;
+/**
+ * Create initial animation state for a unit (idle, facing SE).
+ */
+export declare function createUnitAnimationState(unitId: string): UnitAnimationState;
+/**
+ * Transition to a new animation. Resets elapsed time.
+ * Optionally updates direction. Death cannot be overridden.
+ */
+export declare function transitionAnimation(state: UnitAnimationState, newAnim: AnimationName, direction?: FacingDirection): UnitAnimationState;
+/**
+ * Advance animation state by deltaMs.
+ * Handles one-shot → queued/idle transitions automatically.
+ */
+export declare function tickAnimationState(state: UnitAnimationState, deltaMs: number): UnitAnimationState;

package/dist/components/organisms/game/utils/spriteSheetConstants.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Sprite Sheet Constants
+ *
+ * Standard layout for 8-column × 5-row character sprite sheets.
+ * All characters share identical sheet geometry.
+ *
+ * @packageDocumentation
+ */
+import type { AnimationDef, AnimationName } from '../types/spriteAnimation';
+/** Number of columns in a sprite sheet (frames per row) */
+export declare const SHEET_COLUMNS = 8;
+/**
+ * Standard sprite sheet row layout.
+ * Row 0 = idle, Row 1 = walk, Row 2 = attack, Row 3 = hit, Row 4 = death.
+ */
+export declare const SPRITE_SHEET_LAYOUT: Record<AnimationName, AnimationDef>;

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

@@ -0,0 +1,38 @@
+export { type EntityDisplayProps, 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";
+export { DetailPanel, type DetailPanelProps, type DetailField, type DetailSection, } from "./DetailPanel";
+export { FormSection, FormLayout, FormActions, type FormSectionProps, type FormLayoutProps, type FormActionsProps, } from "./FormSection";
+export { Form, type FormProps } from "./Form";
+export { Header, type HeaderProps } from "./Header";
+export { Navigation, type NavigationProps, type NavigationItem, } from "./Navigation";
+export { Section, type SectionProps } from "./Section";
+export { Sidebar, type SidebarProps, type SidebarItem } from "./Sidebar";
+export { Split, type SplitProps } from "./Split";
+export { Table, type TableProps, type TableColumn, type SortDirection, } from "./Table";
+export { List, type ListProps, type ListItem } from "./List";
+export { CardGrid, type CardGridProps, type CardGridGap } from "./CardGrid";
+export { MasterDetail, type MasterDetailProps } from "./MasterDetail";
+export { ConfirmDialog, type ConfirmDialogProps, type ConfirmDialogVariant, } from "./ConfirmDialog";
+export { WizardContainer, type WizardContainerProps, type WizardStep, } from "./WizardContainer";
+export { OrbitalVisualization, type OrbitalVisualizationProps, } from "./OrbitalVisualization";
+export { StateMachineView, DomStateMachineVisualizer, OrbitalStateMachineView, type StateMachineViewProps, type TransitionBundle, } from "./StateMachineView";
+export { JazariStateMachine, type JazariStateMachineProps, } from "./JazariStateMachine";
+export { ContentRenderer, type ContentRendererProps, } from "./ContentRenderer";
+export * from "./book";
+export * from "./layout";
+export * from "./game";
+export { UISlotRenderer, UISlotComponent, SlotContentRenderer, type UISlotRendererProps, } from "./UISlotRenderer";
+export { ModalSlot, type ModalSlotProps } from "./ModalSlot";
+export { DrawerSlot, type DrawerSlotProps } from "./DrawerSlot";
+export { ToastSlot, type ToastSlotProps } from "./ToastSlot";
+export { NotifyListener } from "./NotifyListener";
+export { Chart, type ChartProps, type ChartType, type ChartSeries, } from "./Chart";
+export { Timeline, type TimelineProps, type TimelineItem, type TimelineItemStatus, } from "./Timeline";
+export { MediaGallery, type MediaGalleryProps, type MediaItem, } from "./MediaGallery";
+export { SignaturePad, type SignaturePadProps, } from "./SignaturePad";
+export { DocumentViewer, type DocumentViewerProps, type DocumentType, } from "./DocumentViewer";
+export { GraphCanvas, type GraphCanvasProps, type GraphNode, type GraphEdge, } from "./GraphCanvas";
+export { CodeViewer, type CodeViewerProps, type CodeViewerMode, type DiffLine, } from "./CodeViewer";
+export { RuntimeDebugger, type RuntimeDebuggerProps, } from "./debug";

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

@@ -0,0 +1,35 @@
+/**
+ * DashboardGrid Component
+ *
+ * Multi-column grid for widgets and stats cards.
+ * Supports cell spanning for flexible dashboard layouts.
+ *
+ * Uses wireframe theme styling (high contrast, sharp edges).
+ */
+import React from "react";
+import type { EntityDisplayProps } from "../types";
+export interface DashboardGridCell {
+    /** Optional unique cell ID */
+    id?: string;
+    /** Content to render in the cell */
+    content?: React.ReactNode;
+    /** Number of columns this cell spans (1-4) */
+    colSpan?: 1 | 2 | 3 | 4;
+    /** Number of rows this cell spans (1-2) */
+    rowSpan?: 1 | 2;
+    /** Allow additional schema-driven properties */
+    [key: string]: unknown;
+}
+export interface DashboardGridProps extends EntityDisplayProps {
+    /** Number of columns */
+    columns?: 2 | 3 | 4;
+    /** Gap between cells */
+    gap?: "sm" | "md" | "lg";
+    /** Cell definitions */
+    cells: DashboardGridCell[];
+}
+/**
+ * DashboardGrid - Multi-column widget grid
+ */
+export declare const DashboardGrid: React.FC<DashboardGridProps>;
+export default DashboardGrid;

package/dist/components/organisms/layout/MasterDetail.d.ts

@@ -0,0 +1,32 @@
+/**
+ * MasterDetail Component
+ *
+ * Classic master-detail pattern with a list on the left
+ * and selected item detail on the right.
+ *
+ * Uses wireframe theme styling (high contrast, sharp edges).
+ */
+import React from "react";
+export interface MasterDetailProps {
+    /** Master panel content (usually a list) */
+    master: React.ReactNode;
+    /** Detail panel content */
+    detail: React.ReactNode;
+    /** Content shown when nothing is selected */
+    emptyDetail?: React.ReactNode;
+    /** Whether an item is currently selected */
+    hasSelection?: boolean;
+    /** Width of master panel (e.g., '350px', '30%') */
+    masterWidth?: string;
+    /** Additional CSS classes */
+    className?: string;
+    /** Class for master pane */
+    masterClassName?: string;
+    /** Class for detail pane */
+    detailClassName?: string;
+}
+/**
+ * MasterDetail - List + detail split layout
+ */
+export declare const MasterDetail: React.FC<MasterDetailProps>;
+export default MasterDetail;

package/dist/components/organisms/layout/SplitPane.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SplitPane Component
+ *
+ * Two-pane resizable split layout for master-detail views,
+ * dual-pane editors, and code + preview layouts.
+ *
+ * Uses wireframe theme styling (high contrast, sharp edges).
+ */
+import React from "react";
+export interface SplitPaneProps {
+    /** Direction of the split */
+    direction?: "horizontal" | "vertical";
+    /** Initial ratio (0-100, percentage of first pane) */
+    ratio?: number;
+    /** Minimum size of either pane in pixels */
+    minSize?: number;
+    /** Allow user resizing */
+    resizable?: boolean;
+    /** Content for the left/top pane */
+    left: React.ReactNode;
+    /** Content for the right/bottom pane */
+    right: React.ReactNode;
+    /** Additional CSS classes */
+    className?: string;
+    /** Class for left/top pane */
+    leftClassName?: string;
+    /** Class for right/bottom pane */
+    rightClassName?: string;
+}
+/**
+ * SplitPane - Two-pane resizable layout
+ */
+export declare const SplitPane: React.FC<SplitPaneProps>;
+export default SplitPane;

package/dist/components/organisms/layout/TabbedContainer.d.ts

@@ -0,0 +1,42 @@
+/**
+ * TabbedContainer Component
+ *
+ * Tabbed content areas with shared header/context.
+ * Wraps the Tabs molecule with layout-specific styling.
+ *
+ * Uses wireframe theme styling (high contrast, sharp edges).
+ */
+import React from "react";
+export interface TabDefinition {
+    /** Tab identifier */
+    id: string;
+    /** Tab label */
+    label: string;
+    /** Tab content (optional if using sectionId) */
+    content?: React.ReactNode;
+    /** Section ID to render (alternative to content) */
+    sectionId?: string;
+    /** Optional badge/count */
+    badge?: string | number;
+    /** Disable this tab */
+    disabled?: boolean;
+}
+export interface TabbedContainerProps {
+    /** Tab definitions */
+    tabs: TabDefinition[];
+    /** Default active tab ID */
+    defaultTab?: string;
+    /** Controlled active tab */
+    activeTab?: string;
+    /** Callback when tab changes */
+    onTabChange?: (tabId: string) => void;
+    /** Tab position */
+    position?: "top" | "left";
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * TabbedContainer - Tabbed content areas
+ */
+export declare const TabbedContainer: React.FC<TabbedContainerProps>;
+export default TabbedContainer;

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

@@ -0,0 +1,9 @@
+/**
+ * Layout organisms index
+ *
+ * Export layout pattern components for adaptive UI.
+ */
+export { SplitPane, type SplitPaneProps } from './SplitPane';
+export { MasterDetail, type MasterDetailProps } from './MasterDetail';
+export { DashboardGrid, type DashboardGridProps, type DashboardGridCell } from './DashboardGrid';
+export { TabbedContainer, type TabbedContainerProps, type TabDefinition } from './TabbedContainer';

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

@@ -0,0 +1,63 @@
+/**
+ * Shared types for entity-display organisms.
+ *
+ * All entity-display organisms (DataTable, List, Table, CardGrid, DetailPanel)
+ * extend EntityDisplayProps to guarantee a uniform prop contract.
+ *
+ * Exception: Form manages local `formData` state for field input tracking.
+ * This is the ONE allowed exception — documented here.
+ */
+export declare const EntityDisplayEvents: {
+    readonly SORT: "SORT";
+    readonly PAGINATE: "PAGINATE";
+    readonly SEARCH: "SEARCH";
+    readonly FILTER: "FILTER";
+    readonly CLEAR_FILTERS: "CLEAR_FILTERS";
+    readonly SELECT: "SELECT";
+    readonly DESELECT: "DESELECT";
+};
+export interface SortPayload {
+    field: string;
+    direction: 'asc' | 'desc';
+}
+export interface PaginatePayload {
+    page: number;
+    pageSize?: number;
+}
+export interface SearchPayload {
+    query: string;
+}
+export interface FilterPayload {
+    field: string;
+    operator: string;
+    value: unknown;
+}
+export interface SelectPayload {
+    ids: (string | number)[];
+}
+export interface EntityDisplayProps<T = unknown> {
+    /** Entity name (string) or data injected by the runtime (array for lists, single object for detail) */
+    entity?: string | T | readonly T[];
+    /** Additional CSS classes */
+    className?: string;
+    /** Loading state indicator */
+    isLoading?: boolean;
+    /** Error state */
+    error?: Error | null;
+    /** Current sort field */
+    sortBy?: string;
+    /** Current sort direction */
+    sortDirection?: 'asc' | 'desc';
+    /** Current search query value */
+    searchValue?: string;
+    /** Current page number (1-indexed) */
+    page?: number;
+    /** Number of items per page */
+    pageSize?: number;
+    /** Total number of items (for pagination display) */
+    totalCount?: number;
+    /** Active filters */
+    activeFilters?: Record<string, unknown>;
+    /** Currently selected item IDs */
+    selectedIds?: readonly (string | number)[];
+}

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

@@ -0,0 +1,14 @@
+import React from "react";
+export interface AuthLayoutProps {
+    /** App name */
+    appName?: string;
+    /** Logo component or URL */
+    logo?: React.ReactNode;
+    /** Background image URL */
+    backgroundImage?: string;
+    /** Show branding panel on the side */
+    showBranding?: boolean;
+    /** Branding panel content */
+    brandingContent?: React.ReactNode;
+}
+export declare const AuthLayout: React.FC<AuthLayoutProps>;

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

@@ -0,0 +1,25 @@
+/**
+ * BattleTemplate
+ *
+ * Thin declarative wrapper around BattleBoard organism.
+ * All game logic (turn phases, movement animation, combat, etc.) lives in BattleBoard.
+ *
+ * Compliant with Almadar_Templates.md: no hooks, no callbacks, entity-only data flow.
+ *
+ * @packageDocumentation
+ */
+import React from 'react';
+import type { TemplateProps } from './types';
+import type { BattleEntity } from '../organisms/game/BattleBoard';
+export type { BattleEntity, BattlePhase, BattleUnit, BattleTile, BattleSlotContext, } from '../organisms/game/BattleBoard';
+export interface BattleTemplateProps extends TemplateProps<BattleEntity> {
+    /** Canvas render scale */
+    scale?: number;
+    /** Unit draw-size multiplier */
+    unitScale?: number;
+}
+export declare function BattleTemplate({ entity, scale, unitScale, className, }: BattleTemplateProps): React.JSX.Element | null;
+export declare namespace BattleTemplate {
+    var displayName: string;
+}
+export default BattleTemplate;

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

@@ -0,0 +1,23 @@
+/**
+ * CastleTemplate
+ *
+ * Thin declarative wrapper around CastleBoard organism.
+ * All game logic (hover state, feature selection, etc.) lives in CastleBoard.
+ *
+ * Compliant with Almadar_Templates.md: no hooks, no callbacks, entity-only data flow.
+ *
+ * @packageDocumentation
+ */
+import React from 'react';
+import type { TemplateProps } from './types';
+import type { CastleEntity } from '../organisms/game/CastleBoard';
+export type { CastleEntity, CastleSlotContext, } from '../organisms/game/CastleBoard';
+export interface CastleTemplateProps extends TemplateProps<CastleEntity> {
+    /** Canvas render scale */
+    scale?: number;
+}
+export declare function CastleTemplate({ entity, scale, className, }: CastleTemplateProps): React.JSX.Element | null;
+export declare namespace CastleTemplate {
+    var displayName: string;
+}
+export default CastleTemplate;

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

@@ -0,0 +1,44 @@
+/**
+ * CounterTemplate
+ *
+ * A presentational template for counter/incrementer features.
+ * Supports increment, decrement, and reset operations.
+ */
+import React from "react";
+import type { TemplateProps } from "./types";
+export type CounterSize = "sm" | "md" | "lg";
+export type CounterVariant = "minimal" | "standard" | "full";
+export interface CounterEntity {
+    /** Entity ID */
+    id: string;
+    /** Current count value */
+    count: number;
+    /** Whether decrement button is disabled */
+    decrementDisabled?: boolean;
+    /** Whether increment button is disabled */
+    incrementDisabled?: boolean;
+    /** Step label for decrement button (e.g. "-5") */
+    decrementLabel?: string;
+    /** Step label for increment button (e.g. "+5") */
+    incrementLabel?: string;
+    /** Formatted range text (e.g. "Range: 0 to 100") */
+    rangeText?: string;
+}
+export interface CounterTemplateProps extends TemplateProps<CounterEntity> {
+    /** Called when increment is clicked */
+    onIncrement?: () => void;
+    /** Called when decrement is clicked */
+    onDecrement?: () => void;
+    /** Called when reset is clicked */
+    onReset?: () => void;
+    /** Title displayed above the counter */
+    title?: string;
+    /** Show reset button */
+    showReset?: boolean;
+    /** Counter display size */
+    size?: CounterSize;
+    /** Template variant */
+    variant?: CounterVariant;
+}
+export declare const CounterTemplate: React.FC<CounterTemplateProps>;
+export default CounterTemplate;

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

@@ -0,0 +1,34 @@
+import React from "react";
+import { LucideIcon } from "lucide-react";
+export interface NavItem {
+    label: string;
+    href: string;
+    icon?: LucideIcon;
+    badge?: string | number;
+    children?: NavItem[];
+}
+export interface DashboardLayoutProps {
+    /** App name shown in sidebar */
+    appName?: string;
+    /** Logo component or URL */
+    logo?: React.ReactNode;
+    /** Navigation items */
+    navItems?: NavItem[];
+    /** Current user info (optional - auto-populated from auth context if not provided) */
+    user?: {
+        name: string;
+        email: string;
+        avatar?: string;
+    };
+    /** Header actions (notifications, etc.) */
+    headerActions?: React.ReactNode;
+    /** Show search in header */
+    showSearch?: boolean;
+    /** Custom sidebar footer */
+    sidebarFooter?: React.ReactNode;
+    /** Callback when user clicks sign out (optional - uses auth context signOut if not provided) */
+    onSignOut?: () => void;
+    /** Page content rendered inside the main area */
+    children?: React.ReactNode;
+}
+export declare const DashboardLayout: React.FC<DashboardLayoutProps>;

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

@@ -0,0 +1,96 @@
+/**
+ * GameCanvas3DBattleTemplate
+ *
+ * Pure declarative template wrapper for 3D battle scenes.
+ * Optimized for tactical combat view with turn indicators.
+ *
+ * Page: Battle3DPage
+ * Entity: Battle3D
+ * ViewType: detail
+ *
+ * Events Emitted:
+ * - TILE_SELECTED - When a tile is clicked
+ * - UNIT_SELECTED - When a unit is clicked
+ * - UNIT_ATTACK - When attacking a unit
+ * - UNIT_MOVE - When moving a unit
+ * - END_TURN - When ending turn
+ * - EXIT_BATTLE - When exiting battle
+ *
+ * @packageDocumentation
+ */
+import React from 'react';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/game/types/isometric';
+import type { TemplateProps } from './types';
+export interface Battle3DEntity {
+    /** Battlefield tiles */
+    tiles: IsometricTile[];
+    /** Combatants */
+    units: IsometricUnit[];
+    /** Battlefield features (cover, obstacles) */
+    features: IsometricFeature[];
+    /** Current turn (player/enemy) */
+    currentTurn?: 'player' | 'enemy';
+    /** Round number */
+    round?: number;
+    /** Entity ID */
+    id: string;
+}
+export interface GameCanvas3DBattleTemplateProps extends TemplateProps<Battle3DEntity> {
+    /** 3D camera mode - defaults to perspective for dramatic effect */
+    cameraMode?: 'isometric' | 'perspective' | 'top-down';
+    /** Show grid helper */
+    showGrid?: boolean;
+    /** Enable shadows */
+    shadows?: boolean;
+    /** Background color - darker for battle atmosphere */
+    backgroundColor?: string;
+    /** Event name for tile clicks */
+    tileClickEvent?: string;
+    /** Event name for unit clicks */
+    unitClickEvent?: string;
+    /** Event name for unit attack */
+    unitAttackEvent?: string;
+    /** Event name for unit move */
+    unitMoveEvent?: string;
+    /** Event name for ending turn */
+    endTurnEvent?: string;
+    /** Event name for exiting battle */
+    exitEvent?: string;
+    /** Currently selected unit ID */
+    selectedUnitId?: string | null;
+    /** Valid move positions */
+    validMoves?: Array<{
+        x: number;
+        z: number;
+    }>;
+    /** Valid attack targets */
+    attackTargets?: Array<{
+        x: number;
+        z: number;
+    }>;
+    /** Show turn indicator overlay */
+    showTurnIndicator?: boolean;
+}
+/**
+ * GameCanvas3DBattleTemplate Component
+ *
+ * Template for 3D battle/tactical combat view.
+ *
+ * @example
+ * ```tsx
+ * <GameCanvas3DBattleTemplate
+ *     entity={battleEntity}
+ *     cameraMode="perspective"
+ *     selectedUnitId="unit-1"
+ *     validMoves={[{ x: 2, z: 3 }]}
+ *     attackTargets={[{ x: 5, z: 5 }]}
+ *     tileClickEvent="SELECT_TILE"
+ *     unitClickEvent="SELECT_UNIT"
+ * />
+ * ```
+ */
+export declare function GameCanvas3DBattleTemplate({ entity, cameraMode, showGrid, shadows, backgroundColor, tileClickEvent, unitClickEvent, unitAttackEvent, unitMoveEvent, endTurnEvent, exitEvent, selectedUnitId, validMoves, attackTargets, className, }: GameCanvas3DBattleTemplateProps): React.JSX.Element | null;
+export declare namespace GameCanvas3DBattleTemplate {
+    var displayName: string;
+}
+export default GameCanvas3DBattleTemplate;