@almadar/ui 2.14.0 → 2.15.0

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

@@ -0,0 +1,25 @@
+import * as React from 'react';
+export interface ItemSlotProps {
+    /** Icon component or emoji */
+    icon?: React.ReactNode;
+    /** Item label */
+    label?: string;
+    /** Stack quantity */
+    quantity?: number;
+    /** Rarity tier affecting border color */
+    rarity?: 'common' | 'uncommon' | 'rare' | 'epic' | 'legendary';
+    /** Whether the slot is empty */
+    empty?: boolean;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Whether the slot is selected */
+    selected?: boolean;
+    /** Click handler */
+    onClick?: () => void;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function ItemSlot({ icon, label, quantity, rarity, empty, size, selected, onClick, className, }: ItemSlotProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace ItemSlot {
+    var displayName: string;
+}

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

@@ -0,0 +1,36 @@
+export interface MiniMapProps {
+    /** Tile data: each tile renders as a 1px dot at (x,y) with the given color */
+    tiles?: {
+        x: number;
+        y: number;
+        color: string;
+    }[];
+    /** Unit positions: each unit renders as a 2px dot */
+    units?: {
+        x: number;
+        y: number;
+        color: string;
+        isPlayer?: boolean;
+    }[];
+    /** Canvas display width in pixels */
+    width?: number;
+    /** Canvas display height in pixels */
+    height?: number;
+    /** Logical map width (for coordinate scaling) */
+    mapWidth?: number;
+    /** Logical map height (for coordinate scaling) */
+    mapHeight?: number;
+    /** Viewport rectangle outline */
+    viewportRect?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function MiniMap({ tiles, units, width, height, mapWidth, mapHeight, viewportRect, className, }: MiniMapProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace MiniMap {
+    var displayName: string;
+}

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

@@ -0,0 +1,21 @@
+import * as React from 'react';
+export interface ResourceCounterProps {
+    /** Icon component or emoji */
+    icon?: React.ReactNode;
+    /** Resource label */
+    label: string;
+    /** Current value */
+    value: number;
+    /** Maximum value */
+    max?: number;
+    /** Accent color class (e.g. 'text-yellow-400') */
+    color?: string;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function ResourceCounter({ icon, label, value, max, color, size, className, }: ResourceCounterProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace ResourceCounter {
+    var displayName: string;
+}

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

@@ -0,0 +1,21 @@
+import * as React from 'react';
+export interface ScoreDisplayProps {
+    /** Current score value */
+    value: number;
+    /** Label to display before score */
+    label?: string;
+    /** Icon component or emoji */
+    icon?: React.ReactNode;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    /** Additional CSS classes */
+    className?: string;
+    /** Animation on value change */
+    animated?: boolean;
+    /** Number formatting locale */
+    locale?: string;
+}
+export declare function ScoreDisplay({ value, label, icon, size, className, animated, locale, ...rest }: ScoreDisplayProps & Record<string, unknown>): import("react/jsx-runtime").JSX.Element;
+export declare namespace ScoreDisplay {
+    var displayName: string;
+}

package/dist/components/atoms/game/Sprite.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Sprite Component
+ *
+ * Renders a single frame from a spritesheet with transform support.
+ */
+import React from 'react';
+export interface SpriteProps {
+    /** Spritesheet image URL */
+    spritesheet: string;
+    /** Width of each frame in pixels */
+    frameWidth: number;
+    /** Height of each frame in pixels */
+    frameHeight: number;
+    /** Frame index to display (0-based, left-to-right, top-to-bottom) */
+    frame: number;
+    /** X position in pixels */
+    x: number;
+    /** Y position in pixels */
+    y: number;
+    /** Scale factor (default: 1) */
+    scale?: number;
+    /** Flip horizontally */
+    flipX?: boolean;
+    /** Flip vertically */
+    flipY?: boolean;
+    /** Rotation in degrees */
+    rotation?: number;
+    /** Opacity (0-1) */
+    opacity?: number;
+    /** Z-index for layering */
+    zIndex?: number;
+    /** Number of columns in spritesheet (for frame calculation) */
+    columns?: number;
+    /** Optional className */
+    className?: string;
+    /** Optional onClick handler */
+    onClick?: () => void;
+    /** Declarative event name emitted on click via useEventBus */
+    action?: string;
+}
+/**
+ * Sprite component for rendering spritesheet frames
+ *
+ * @example
+ * ```tsx
+ * <Sprite
+ *   spritesheet="/sprites/player.png"
+ *   frameWidth={32}
+ *   frameHeight={32}
+ *   frame={currentFrame}
+ *   x={player.x}
+ *   y={player.y}
+ *   flipX={player.facingLeft}
+ *   scale={2}
+ * />
+ * ```
+ */
+export declare function Sprite({ spritesheet, frameWidth, frameHeight, frame, x, y, scale, flipX, flipY, rotation, opacity, zIndex, columns, className, onClick, action, }: SpriteProps): React.JSX.Element;
+/**
+ * Canvas-based sprite renderer for better performance in game loops
+ */
+export declare function drawSprite(ctx: CanvasRenderingContext2D, image: HTMLImageElement, props: Omit<SpriteProps, 'spritesheet' | 'className' | 'onClick'>): void;
+export default Sprite;

package/dist/components/atoms/game/StateIndicator.d.ts

@@ -0,0 +1,31 @@
+/**
+ * StateIndicator Component
+ *
+ * Displays a visual indicator for a game entity's current state.
+ * Generic — not tied to any specific game. Projects can extend
+ * the state styles via the `stateStyles` prop.
+ */
+import React from 'react';
+export interface StateStyle {
+    icon: string;
+    bgClass: string;
+}
+export interface StateIndicatorProps {
+    /** The current state name */
+    state: string;
+    /** Optional label override (defaults to capitalized state name) */
+    label?: string;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Whether to show pulse animation on non-idle states */
+    animated?: boolean;
+    /** Custom state styles to extend/override defaults */
+    stateStyles?: Record<string, StateStyle>;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function StateIndicator({ state, label, size, animated, stateStyles, className, }: StateIndicatorProps): React.JSX.Element;
+export declare namespace StateIndicator {
+    var displayName: string;
+}
+export default StateIndicator;

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

@@ -0,0 +1,21 @@
+import * as React from 'react';
+export interface StatusEffectProps {
+    /** Icon to display for the effect */
+    icon: React.ReactNode;
+    /** Label describing the effect */
+    label?: string;
+    /** Remaining duration in seconds */
+    duration?: number;
+    /** Number of stacks */
+    stacks?: number;
+    /** Effect type */
+    variant?: 'buff' | 'debuff' | 'neutral';
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function StatusEffect({ icon, label, duration, stacks, variant, size, className, }: StatusEffectProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace StatusEffect {
+    var displayName: string;
+}

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

@@ -0,0 +1,18 @@
+export interface TimerDisplayProps {
+    /** Time in seconds */
+    seconds: number;
+    /** Whether the timer is running */
+    running?: boolean;
+    /** Display format */
+    format?: 'mm:ss' | 'ss' | 'countdown';
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS classes */
+    className?: string;
+    /** Seconds below which to pulse red */
+    lowThreshold?: number;
+}
+export declare function TimerDisplay({ seconds, running, format, size, className, lowThreshold, }: TimerDisplayProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace TimerDisplay {
+    var displayName: string;
+}

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

@@ -0,0 +1,18 @@
+export interface TurnIndicatorProps {
+    /** Current turn number */
+    currentTurn: number;
+    /** Maximum number of turns */
+    maxTurns?: number;
+    /** Name of the active team */
+    activeTeam?: string;
+    /** Current phase label */
+    phase?: string;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function TurnIndicator({ currentTurn, maxTurns, activeTeam, phase, size, className, }: TurnIndicatorProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace TurnIndicator {
+    var displayName: string;
+}

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

@@ -0,0 +1,19 @@
+import * as React from 'react';
+export interface WaypointMarkerProps {
+    /** Label text below the marker */
+    label?: string;
+    /** Custom icon to render inside the marker */
+    icon?: React.ReactNode;
+    /** Whether this waypoint is currently active */
+    active?: boolean;
+    /** Whether this waypoint has been completed */
+    completed?: boolean;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function WaypointMarker({ label, icon, active, completed, size, className, }: WaypointMarkerProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace WaypointMarker {
+    var displayName: string;
+}

package/dist/components/atoms/game/XPBar.d.ts

@@ -0,0 +1,20 @@
+export interface XPBarProps {
+    /** Current XP value */
+    current: number;
+    /** XP needed for next level */
+    max: number;
+    /** Current level */
+    level?: number;
+    /** Whether to show the XP label */
+    showLabel?: boolean;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Animate the fill bar */
+    animated?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function XPBar({ current, max, level, showLabel, size, animated, className, }: XPBarProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace XPBar {
+    var displayName: string;
+}

package/dist/components/atoms/game/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Game Atom Components
+ *
+ * Basic building blocks for game UI.
+ *
+ * @packageDocumentation
+ */
+export { HealthBar, type HealthBarProps } from './HealthBar';
+export { ScoreDisplay, type ScoreDisplayProps } from './ScoreDisplay';
+export { ControlButton, type ControlButtonProps } from './ControlButton';
+export { Sprite, drawSprite, type SpriteProps } from './Sprite';
+export { StateIndicator, type StateIndicatorProps, type StateStyle } from './StateIndicator';
+export { TimerDisplay, type TimerDisplayProps } from './TimerDisplay';
+export { ResourceCounter, type ResourceCounterProps } from './ResourceCounter';
+export { ItemSlot, type ItemSlotProps } from './ItemSlot';
+export { TurnIndicator, type TurnIndicatorProps } from './TurnIndicator';
+export { ComboCounter, type ComboCounterProps } from './ComboCounter';
+export { XPBar, type XPBarProps } from './XPBar';
+export { WaypointMarker, type WaypointMarkerProps } from './WaypointMarker';
+export { StatusEffect, type StatusEffectProps } from './StatusEffect';
+export { DamageNumber, type DamageNumberProps } from './DamageNumber';
+export { DialogueBubble, type DialogueBubbleProps } from './DialogueBubble';
+export { ChoiceButton, type ChoiceButtonProps } from './ChoiceButton';
+export { ActionButton, type ActionButtonProps } from './ActionButton';
+export { MiniMap, type MiniMapProps } from './MiniMap';

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

@@ -0,0 +1,37 @@
+export { Button, type ButtonProps } from "./Button";
+export { Input, type InputProps } from "./Input";
+export { Label, type LabelProps } from "./Label";
+export { Textarea, type TextareaProps } from "./Textarea";
+export { Select, type SelectProps, type SelectOption } from "./Select";
+export { Checkbox, type CheckboxProps } from "./Checkbox";
+export { Card, CardHeader, CardTitle, CardContent, CardBody, CardFooter, type CardProps, } from "./Card";
+export { Badge, type BadgeProps, type BadgeVariant } from "./Badge";
+export { Spinner, type SpinnerProps } from "./Spinner";
+export { Avatar, type AvatarProps, type AvatarSize, type AvatarStatus, } from "./Avatar";
+export { Box, type BoxProps, type BoxPadding, type BoxMargin, type BoxBg, type BoxRounded, type BoxShadow, } from "./Box";
+export { Center, type CenterProps } from "./Center";
+export { Divider, type DividerProps, type DividerOrientation } from "./Divider";
+export { Icon, type IconProps, type IconSize, type IconAnimation, } from "./Icon";
+export { ProgressBar, type ProgressBarProps, type ProgressBarVariant, type ProgressBarColor, } from "./ProgressBar";
+export { Radio, type RadioProps } from "./Radio";
+export { Switch, type SwitchProps } from "./Switch";
+export { Spacer, type SpacerProps, type SpacerSize } from "./Spacer";
+export { Stack, VStack, HStack, type StackProps, type VStackProps, type HStackProps, type StackDirection, type StackGap, type StackAlign, type StackJustify, } from "./Stack";
+export { TextHighlight, type TextHighlightProps, type HighlightType, } from "./TextHighlight";
+export { Typography, Heading, Text, type TypographyProps, type TypographyVariant, type HeadingProps, type TextProps, } from "./Typography";
+export { ThemeToggle, type ThemeToggleProps } from "./ThemeToggle";
+export { ThemeSelector } from "./ThemeSelector";
+export { Overlay, type OverlayProps } from "./Overlay";
+export { FlipContainer, type FlipContainerProps } from "./FlipContainer";
+export { ConditionalWrapper, type ConditionalWrapperProps, type ConditionalContext, } from "./ConditionalWrapper";
+export { LawReferenceTooltip, type LawReferenceTooltipProps, type LawReference, } from "./LawReferenceTooltip";
+export { DayCell, type DayCellProps } from "./DayCell";
+export { TimeSlotCell, type TimeSlotCellProps } from "./TimeSlotCell";
+export { StatusDot, type StatusDotProps, type StatusDotStatus, type StatusDotSize } from "./StatusDot";
+export { TrendIndicator, type TrendIndicatorProps, type TrendDirection, type TrendIndicatorSize } from "./TrendIndicator";
+export { RangeSlider, type RangeSliderProps, type RangeSliderSize } from "./RangeSlider";
+export { AnimatedCounter, type AnimatedCounterProps } from "./AnimatedCounter";
+export { InfiniteScrollSentinel, type InfiniteScrollSentinelProps } from "./InfiniteScrollSentinel";
+export { ConfettiEffect, type ConfettiEffectProps } from "./ConfettiEffect";
+export { TypewriterText, type TypewriterTextProps } from "./TypewriterText";
+export * from "./game";

package/dist/components/index.d.ts

@@ -0,0 +1,6 @@
+export * from './atoms';
+export * from './molecules';
+export * from './organisms';
+export * from './templates';
+export { cn } from '../lib/cn';
+export * from '../hooks';

package/dist/components/index.js

@@ -1,8 +1,8 @@
 export { ENTITY_EVENTS, useAgentChat, useCompile, useConnectGitHub, useCreateEntity, useDeepAgentGeneration, useDeleteEntity, useDisconnectGitHub, useEntities, useEntitiesByType, useEntity as useEntityById, useEntityMutations, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInput, useOrbitalHistory, useOrbitalMutations, usePhysics, usePinchZoom, usePlayer, usePreview, useResolvedEntity, useSelectedEntity, useSendOrbitalEvent, useSingletonEntity, useUIEvents, useUpdateEntity, useValidation } from '../chunk-IRIGCHP4.js';
 export { clearEntities, getAllEntities, getByType, getEntity, getSingleton, removeEntity, spawnEntity, updateEntity, updateSingleton } from '../chunk-N7MVUW4R.js';
 import '../chunk-3HJHHULT.js';
-import { VStack, HStack, Typography, Button, Icon, Box, Card, DataTable, Badge, Toast } from '../chunk-SKWPSQHQ.js';
-export { ALL_PRESETS, AR_BOOK_FIELDS, Accordion, ActionButton, ActionButtons, Card2 as ActionCard, ActionPalette, ActionTile, Alert, AnimatedCounter, AuthLayout, Avatar, Badge, BattleBoard, BattleTemplate, BookChapterView, BookCoverPage, BookNavBar, BookTableOfContents, BookViewer, Box, Breadcrumb, BuilderBoard, Button, ButtonGroup, CalendarGrid, CanvasEffect, Card, CardBody, CardContent, CardFooter, CardGrid, CardHeader, CardTitle, Carousel, CastleBoard, CastleTemplate, Center, Chart, ChartLegend, Checkbox, ChoiceButton, ClassifierBoard, CodeBlock, CodeView, CodeViewer, CombatLog, ComboCounter, ConditionalWrapper, ConfettiEffect, ConfirmDialog, Container, ContentRenderer, ControlButton, CounterTemplate, CraftingRecipe, DIAMOND_TOP_Y, DPad, DamageNumber, DashboardGrid, DashboardLayout, DataGrid, DataList, DataTable, DateRangeSelector, DayCell, DebuggerBoard, DetailPanel, DialogueBox, DialogueBubble, Divider, DocumentViewer, StateMachineView as DomStateMachineVisualizer, Drawer, DrawerSlot, EmptyState, EnemyPlate, EntityDisplayEvents, ErrorBoundary, ErrorState, EventHandlerBoard, EventLog, FEATURE_COLORS, FLOOR_HEIGHT, FilterGroup, Flex, FlipCard, FlipContainer, FloatingActionButton, Form, FormField, FormSectionHeader, GameAudioContext, GameAudioProvider, GameAudioToggle, GameCanvas2D, GameHud, GameMenu, GameOverScreen, GameShell, GameTemplate, GenericAppTemplate, GraphCanvas, GraphView, Grid, HStack, Header, Heading, HealthBar, HealthPanel, IDENTITY_BOOK_FIELDS, Icon, InfiniteScrollSentinel, Input, InputGroup, InventoryGrid, InventoryPanel, IsometricCanvas, ItemSlot, JazariStateMachine, Label, LawReferenceTooltip, Lightbox, LineChart, List, LoadingState, MapView, MarkdownContent, MediaGallery, Menu, Meter, MiniMap, Modal, ModalSlot, Navigation, NegotiatorBoard, NumberStepper, ObjectRulePanel, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, Overlay, PageHeader, Pagination, PlatformerCanvas, Popover, PowerupSlots, ProgressBar, ProgressDots, PullToRefresh, QuestTracker, QuizBlock, Radio, RangeSlider, RelationSelect, RepeatableFormSection, ResourceBar, ResourceCounter, RuleEditor, RuntimeDebugger, ScaledDiagram, ScoreBoard, ScoreDisplay, SearchInput, Section, Select, SequenceBar, SequencerBoard, SidePanel, Sidebar, SignaturePad, SimpleGrid, SimulationCanvas, SimulationControls, SimulationGraph, SimulatorBoard, Skeleton, SlotContentRenderer, SortableList, Spacer, Spinner, Split, SplitPane, Sprite, Stack, StarRating, StatBadge, StatCard, StatDisplay, StateArchitectBoard, StateIndicator, StateMachineView, StateNode, StatusDot, StatusEffect, SwipeableRow, Switch, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, Table, Tabs, Text, TextHighlight, Textarea, ThemeSelector, ThemeToggle, TimeSlotCell, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TraitSlot, TraitStateViewer, TransitionArrow, TrendIndicator, TurnIndicator, TurnPanel, TypewriterText, Typography, UISlotComponent, UISlotRenderer, UncontrolledBattleBoard, UnitCommandBar, UploadDropZone, VStack, VariablePanel, ViolationAlert, WaypointMarker, WizardContainer, WizardNavigation, WizardProgress, WorldMapBoard, WorldMapTemplate, XPBar, drawSprite, isoToScreen, mapBookData, pendulum, projectileMotion, resolveFieldMap, screenToIso, springOscillator, useBattleState, useCamera, useGameAudio, useGameAudioContext, useImageCache } from '../chunk-SKWPSQHQ.js';
+import { VStack, HStack, Typography, Button, Icon, Box, Card, DataTable, Badge, Toast } from '../chunk-YPY74G7F.js';
+export { ALL_PRESETS, AR_BOOK_FIELDS, Accordion, ActionButton, ActionButtons, Card2 as ActionCard, ActionPalette, ActionTile, Alert, AnimatedCounter, AuthLayout, Avatar, Badge, BattleBoard, BattleTemplate, BookChapterView, BookCoverPage, BookNavBar, BookTableOfContents, BookViewer, Box, Breadcrumb, BuilderBoard, Button, ButtonGroup, CalendarGrid, CanvasEffect, Card, CardBody, CardContent, CardFooter, CardGrid, CardHeader, CardTitle, Carousel, CastleBoard, CastleTemplate, Center, Chart, ChartLegend, Checkbox, ChoiceButton, ClassifierBoard, CodeBlock, CodeView, CodeViewer, CombatLog, ComboCounter, ConditionalWrapper, ConfettiEffect, ConfirmDialog, Container, ContentRenderer, ControlButton, CounterTemplate, CraftingRecipe, DIAMOND_TOP_Y, DPad, DamageNumber, DashboardGrid, DashboardLayout, DataGrid, DataList, DataTable, DateRangeSelector, DayCell, DebuggerBoard, DetailPanel, DialogueBox, DialogueBubble, Divider, DocumentViewer, StateMachineView as DomStateMachineVisualizer, Drawer, DrawerSlot, EmptyState, EnemyPlate, EntityDisplayEvents, ErrorBoundary, ErrorState, EventHandlerBoard, EventLog, FEATURE_COLORS, FLOOR_HEIGHT, FilterGroup, Flex, FlipCard, FlipContainer, FloatingActionButton, Form, FormField, FormSectionHeader, GameAudioContext, GameAudioProvider, GameAudioToggle, GameCanvas2D, GameHud, GameMenu, GameOverScreen, GameShell, GameTemplate, GenericAppTemplate, GraphCanvas, GraphView, Grid, HStack, Header, Heading, HealthBar, HealthPanel, IDENTITY_BOOK_FIELDS, Icon, InfiniteScrollSentinel, Input, InputGroup, InventoryGrid, InventoryPanel, IsometricCanvas, ItemSlot, JazariStateMachine, Label, LawReferenceTooltip, Lightbox, LineChart, List, LoadingState, MapView, MarkdownContent, MediaGallery, Menu, Meter, MiniMap, Modal, ModalSlot, Navigation, NegotiatorBoard, NumberStepper, ObjectRulePanel, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, Overlay, PageHeader, Pagination, PlatformerCanvas, Popover, PowerupSlots, ProgressBar, ProgressDots, PullToRefresh, QuestTracker, QuizBlock, Radio, RangeSlider, RelationSelect, RepeatableFormSection, ResourceBar, ResourceCounter, RuleEditor, RuntimeDebugger, ScaledDiagram, ScoreBoard, ScoreDisplay, SearchInput, Section, Select, SequenceBar, SequencerBoard, SidePanel, Sidebar, SignaturePad, SimpleGrid, SimulationCanvas, SimulationControls, SimulationGraph, SimulatorBoard, Skeleton, SlotContentRenderer, SortableList, Spacer, Spinner, Split, SplitPane, Sprite, Stack, StarRating, StatBadge, StatCard, StatDisplay, StateArchitectBoard, StateIndicator, StateMachineView, StateNode, StatusDot, StatusEffect, SwipeableRow, Switch, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, Table, Tabs, Text, TextHighlight, Textarea, ThemeSelector, ThemeToggle, TimeSlotCell, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TraitSlot, TraitStateViewer, TransitionArrow, TrendIndicator, TurnIndicator, TurnPanel, TypewriterText, Typography, UISlotComponent, UISlotRenderer, UncontrolledBattleBoard, UnitCommandBar, UploadDropZone, VStack, VariablePanel, ViolationAlert, WaypointMarker, WizardContainer, WizardNavigation, WizardProgress, WorldMapBoard, WorldMapTemplate, XPBar, drawSprite, isoToScreen, mapBookData, pendulum, projectileMotion, resolveFieldMap, screenToIso, springOscillator, useBattleState, useCamera, useGameAudio, useGameAudioContext, useImageCache } from '../chunk-YPY74G7F.js';
 import '../chunk-4N3BAPDB.js';
 import '../chunk-DKQN5FVU.js';
 import { useTranslate } from '../chunk-QU2X55WH.js';

package/dist/components/molecules/Accordion.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Accordion Molecule Component
+ *
+ * A collapsible content component with single or multiple open items.
+ * Uses Button, Icon, Typography, and Divider atoms.
+ */
+import React from "react";
+export interface AccordionItem {
+    /**
+     * Item ID (auto-generated from header/title if not provided)
+     */
+    id?: string;
+    /**
+     * Item header/title
+     */
+    header?: React.ReactNode;
+    /**
+     * Alias for header (pattern compatibility)
+     */
+    title?: React.ReactNode;
+    /**
+     * Item content
+     */
+    content: React.ReactNode;
+    /**
+     * Disable item
+     */
+    disabled?: boolean;
+    /**
+     * Default open state
+     */
+    defaultOpen?: boolean;
+}
+export interface AccordionProps {
+    /**
+     * Accordion items
+     */
+    items: AccordionItem[];
+    /**
+     * Allow multiple items open at once
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * Default open items (IDs)
+     */
+    defaultOpenItems?: string[];
+    /**
+     * Default open items by index (pattern compatibility)
+     */
+    defaultOpen?: number[];
+    /**
+     * Controlled open items (IDs)
+     */
+    openItems?: string[];
+    /**
+     * Callback when item opens/closes
+     */
+    onItemToggle?: (itemId: string, isOpen: boolean) => void;
+    /**
+     * Additional CSS classes
+     */
+    className?: string;
+    /** Declarative toggle event — emits UI:{toggleEvent} with { itemId, isOpen } */
+    toggleEvent?: string;
+}
+export declare const Accordion: React.FC<AccordionProps>;

package/dist/components/molecules/Alert.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Alert Molecule Component
+ *
+ * A component for displaying alert messages with different variants and actions.
+ * Uses theme-aware CSS variables for styling.
+ */
+import React from "react";
+export type AlertVariant = "info" | "success" | "warning" | "error";
+export interface AlertProps {
+    /** Alert content (children or message) */
+    children?: React.ReactNode;
+    /** Alert message (alias for children) */
+    message?: string;
+    variant?: AlertVariant;
+    title?: string;
+    dismissible?: boolean;
+    onDismiss?: () => void;
+    onClose?: () => void;
+    actions?: React.ReactNode;
+    className?: string;
+    /** Declarative dismiss event — emits UI:{dismissEvent} via eventBus when alert is dismissed */
+    dismissEvent?: string;
+}
+export declare const Alert: React.FC<AlertProps>;

package/dist/components/molecules/Breadcrumb.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Breadcrumb Molecule Component
+ *
+ * A breadcrumb navigation component with separators and icons.
+ * Uses Button, Icon, and Typography atoms.
+ */
+import React from "react";
+import type { LucideIcon } from "lucide-react";
+export interface BreadcrumbItem {
+    /**
+     * Item label
+     */
+    label: string;
+    /**
+     * Item href (if provided, renders as link)
+     */
+    href?: string;
+    /**
+     * Item path (alias for href, for schema compatibility)
+     */
+    path?: string;
+    /**
+     * Item icon
+     */
+    icon?: LucideIcon;
+    /**
+     * Click handler (if href not provided)
+     */
+    onClick?: () => void;
+    /**
+     * Is current page
+     */
+    isCurrent?: boolean;
+    /** Event name to emit when clicked (for trait state machine integration) */
+    event?: string;
+}
+export interface BreadcrumbProps {
+    /**
+     * Breadcrumb items
+     */
+    items: BreadcrumbItem[];
+    /**
+     * Separator icon
+     */
+    separator?: LucideIcon;
+    /**
+     * Maximum items to show (truncates with ellipsis)
+     */
+    maxItems?: number;
+    /**
+     * Additional CSS classes
+     */
+    className?: string;
+}
+export declare const Breadcrumb: React.FC<BreadcrumbProps>;

package/dist/components/molecules/ButtonGroup.d.ts

@@ -0,0 +1,67 @@
+/**
+ * ButtonGroup Molecule Component
+ *
+ * A component for grouping buttons together with connected styling.
+ * Supports both children-based and form-actions pattern (primary/secondary) usage.
+ * Uses Button atoms.
+ */
+import React from 'react';
+export type ButtonGroupVariant = 'default' | 'segmented' | 'toggle';
+/** Action button config for form-actions pattern */
+export interface ActionButton {
+    label: string;
+    /** Action type - 'submit' renders as submit button, others render as button */
+    actionType?: string;
+    event?: string;
+    navigatesTo?: string;
+    /** Button variant - matches Button component variants. Accepts string for schema compatibility. */
+    variant?: string;
+}
+/** Filter definition for filter-group pattern */
+export interface FilterDefinition {
+    field: string;
+    label: string;
+    /** Filter type (checkbox, select, etc.) */
+    type?: 'checkbox' | 'select' | 'toggle';
+    /** Options for select filters */
+    options?: readonly string[];
+}
+export interface ButtonGroupProps {
+    /**
+     * Button group content (Button components) - use this OR primary/secondary
+     */
+    children?: React.ReactNode;
+    /**
+     * Primary action button config (for form-actions pattern)
+     * Accepts Readonly for compatibility with generated const objects
+     */
+    primary?: Readonly<ActionButton>;
+    /**
+     * Secondary action buttons config (for form-actions pattern)
+     * Accepts readonly array for compatibility with generated const arrays
+     */
+    secondary?: readonly Readonly<ActionButton>[];
+    /**
+     * Visual variant
+     * @default 'default'
+     */
+    variant?: ButtonGroupVariant;
+    /**
+     * Orientation
+     * @default 'horizontal'
+     */
+    orientation?: 'horizontal' | 'vertical';
+    /**
+     * Additional CSS classes
+     */
+    className?: string;
+    /**
+     * Entity type for filter-group pattern (schema metadata)
+     */
+    entity?: string;
+    /**
+     * Filter definitions for filter-group pattern
+     */
+    filters?: readonly FilterDefinition[];
+}
+export declare const ButtonGroup: React.FC<ButtonGroupProps>;

package/dist/components/molecules/CalendarGrid.d.ts

@@ -0,0 +1,43 @@
+/**
+ * CalendarGrid
+ *
+ * Pure presentational weekly calendar grid molecule.
+ * No entity binding, no event bus, no translations.
+ * Composes DayCell and TimeSlotCell atoms into a 7-day grid.
+ */
+import React from "react";
+export interface CalendarEvent {
+    id: string;
+    title: string;
+    startTime: string | Date;
+    endTime?: string | Date;
+    color?: string;
+}
+export interface CalendarGridProps {
+    /** Start of the week (defaults to current week's Monday) */
+    weekStart?: Date;
+    /** Time slot labels (defaults to 09:00-17:00) */
+    timeSlots?: string[];
+    /** Events to display on the grid */
+    events?: CalendarEvent[];
+    /** Called when a time slot is clicked */
+    onSlotClick?: (day: Date, time: string) => void;
+    /** Called when a day header is clicked */
+    onDayClick?: (day: Date) => void;
+    /** Called when an event is clicked */
+    onEventClick?: (event: CalendarEvent) => void;
+    /** Additional CSS classes */
+    className?: string;
+    /** Event emitted on long-press of a time slot: UI:{longPressEvent} with { date, time } */
+    longPressEvent?: string;
+    /** Additional payload for long-press events */
+    longPressPayload?: Record<string, unknown>;
+    /** Event emitted on swipe left (next week): UI:{swipeLeftEvent} */
+    swipeLeftEvent?: string;
+    /** Event emitted on swipe right (prev week): UI:{swipeRightEvent} */
+    swipeRightEvent?: string;
+}
+export declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, }: CalendarGridProps): React.JSX.Element;
+export declare namespace CalendarGrid {
+    var displayName: string;
+}