@almadar/ui 2.13.3 → 2.15.0

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";