@almadar/ui 5.91.0 → 5.93.0

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

@@ -8,10 +8,18 @@ export interface DialogueBubbleProps {
     portrait?: Asset;
     /** Position of the bubble on screen */
     position?: 'top' | 'bottom';
+    /** Speaker mood — drives a portrait-ring accent; LOLO sets this per dialogue node/transition. */
+    mood?: 'neutral' | 'happy' | 'concerned' | 'angry';
+    /**
+     * Number of `text` characters to reveal (typewriter effect). Omit to show
+     * the full string — LOLO drives this from `@entity.revealedChars` via a
+     * tick, incrementing it until it reaches `text.length`.
+     */
+    revealedChars?: number;
     /** Additional CSS classes */
     className?: string;
 }
-export declare function DialogueBubble({ speaker, text, portrait, position, className, }: DialogueBubbleProps): import("react/jsx-runtime").JSX.Element;
+export declare function DialogueBubble({ speaker, text, portrait, position, mood, revealedChars, className, }: DialogueBubbleProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace DialogueBubble {
     var displayName: string;
 }

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

@@ -14,6 +14,12 @@ export interface GameCardProps {
     disabled?: boolean;
     /** Size variant — controls card dimensions and art pixel size */
     size?: 'sm' | 'md' | 'lg';
+    /**
+     * One-shot pose LOLO drives on a transition (`DRAW`/`PLAY`), auto-reverted
+     * to `'idle'` by a short tick — same idiom as `HealthBar.animated`, plain
+     * CSS transform driven off a prop, no internal timer here.
+     */
+    animState?: 'idle' | 'drawn' | 'played' | 'flipped';
     /** Direct click callback */
     onClick?: (id: string) => void;
     /** Event-bus event emitted with `{ cardId }` on click */
@@ -22,7 +28,7 @@ export interface GameCardProps {
     }>;
     className?: string;
 }
-export declare function GameCard({ id, cost, art, frameAsset, attack, defense, name, selected, disabled, size, onClick, clickEvent, className, }: GameCardProps): React.JSX.Element;
+export declare function GameCard({ id, cost, art, frameAsset, attack, defense, name, selected, disabled, size, animState, onClick, clickEvent, className, }: GameCardProps): React.JSX.Element;
 export declare namespace GameCard {
     var displayName: string;
 }

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

@@ -118,6 +118,14 @@ export interface Canvas2DProps {
     animate?: {
         fps: number;
     };
+    /**
+     * 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
+     * tick-rate-cadence redraw. DEFAULT OFF — for continuous-movement boards
+     * only; tile-snapped boards see no behavior change.
+     */
+    interpolateUnits?: boolean;
     /** Show debug grid lines and coordinates. */
     debug?: boolean;
     /** Ratio of unit draw height to scaledFloorHeight. Default 1.5. */
@@ -155,7 +163,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, 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, 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/{organisms → molecules}/SequenceBar.d.ts

@@ -8,16 +8,26 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { SlotItemData } from '../molecules/TraitSlot';
+import type { EventEmit } from '@almadar/core';
+import type { SlotItemData } from './TraitSlot';
 export interface SequenceBarProps {
     /** The current sequence (sparse — undefined means empty slot) */
     slots: Array<SlotItemData | undefined>;
     /** Max number of slots */
     maxSlots: number;
-    /** Called when an item is dropped into slot at index */
-    onSlotDrop: (index: number, item: SlotItemData) => void;
-    /** Called when a slot is cleared */
-    onSlotRemove: (index: number) => void;
+    /** Called when an item is dropped into slot at index (callback path) */
+    onSlotDrop?: (index: number, item: SlotItemData) => void;
+    /** Called when a slot is cleared (callback path) */
+    onSlotRemove?: (index: number) => void;
+    /** Emits UI:{slotDropEvent} with { slotNumber, itemId } when an item is dropped (declarative path) */
+    slotDropEvent?: EventEmit<{
+        slotNumber: number;
+        itemId: string;
+    }>;
+    /** Emits UI:{slotRemoveEvent} with { slotNumber } when a slot is cleared (declarative path) */
+    slotRemoveEvent?: EventEmit<{
+        slotNumber: number;
+    }>;
     /** Whether the sequence is currently playing (disable interaction) */
     playing?: boolean;
     /** Current step index during playback (-1 = not playing) */
@@ -34,7 +44,7 @@ export interface SequenceBarProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function SequenceBar({ slots, maxSlots, onSlotDrop, onSlotRemove, playing, currentStep, categoryColors, slotFeedback, size, className, }: SequenceBarProps): React.JSX.Element;
+export declare function SequenceBar({ slots, maxSlots, onSlotDrop, onSlotRemove, slotDropEvent, slotRemoveEvent, playing, currentStep, categoryColors, slotFeedback, size, className, }: SequenceBarProps): React.JSX.Element;
 export declare namespace SequenceBar {
     var displayName: string;
 }

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

@@ -44,7 +44,7 @@ export { TraitSlot, type TraitSlotProps, type SlotItemData, } from './TraitSlot'
 export { CollapsibleSection, EditorSlider, EditorSelect, EditorCheckbox, EditorTextInput, StatusBar, TerrainPalette, EditorToolbar, TERRAIN_COLORS, FEATURE_TYPES, type EditorMode, type CollapsibleSectionProps, type EditorSliderProps, type EditorSelectProps, type EditorCheckboxProps, type EditorTextInputProps, type StatusBarProps, type TerrainPaletteProps, type EditorToolbarProps, } from '../../shared/lib/editorUtils';
 export { ActionTile, type ActionTileProps } from './ActionTile';
 export { ActionPalette, type ActionPaletteProps } from './ActionPalette';
-export { SequenceBar, type SequenceBarProps } from '../organisms/SequenceBar';
+export { SequenceBar, type SequenceBarProps } from './SequenceBar';
 export { SequencerBoard, type SequencerBoardProps } from '../organisms/SequencerBoard';
 export { RuleEditor, type RuleEditorProps, type RuleDefinition } from './RuleEditor';
 export { EventLog, type EventLogProps, type EventLogEntry } from './EventLog';
@@ -61,10 +61,6 @@ export { ClassifierBoard, type ClassifierBoardProps, type ClassifierItem, type C
 export { BuilderBoard, type BuilderBoardProps, type BuilderComponent, type BuilderSlot } from '../organisms/BuilderBoard';
 export { DebuggerBoard, type DebuggerBoardProps, type DebuggerLine } from '../organisms/DebuggerBoard';
 export { NegotiatorBoard, type NegotiatorBoardProps, type NegotiatorAction, type PayoffEntry } from '../organisms/NegotiatorBoard';
-export { SimulationCanvas, type SimulationCanvasProps } from '../organisms/SimulationCanvas';
-export { SimulationControls, type SimulationControlsProps } from '../organisms/SimulationControls';
-export { SimulationGraph, type SimulationGraphProps, type MeasurementPoint } from '../organisms/SimulationGraph';
-export type { PhysicsPreset, PhysicsBody, PhysicsConstraint } from '../../shared/lib/physicsTypes';
 export { projectileMotion, pendulum, springOscillator, ALL_PRESETS } from '../../shared/lib/physicsPresets';
 export { GameTemplate, type GameTemplateProps } from '../templates/GameTemplate';
 export { GameShell, type GameShellProps } from '../templates/GameShell';

package/dist/components/game/shared/spriteAnimationTypes.d.ts

@@ -4,25 +4,17 @@
  * Type definitions for frame-based sprite sheet animation system.
  * Supports standard 8-column × 5-row character sheets.
  *
+ * `AnimationName`, `AnimationDef`, and `SpriteDirection` are canonically owned
+ * by `@almadar/core` (they travel with a `spriteSheet`-role `Asset.url`'s
+ * resolved atlas contract) — re-exported here so existing call sites in this
+ * package don't need to change their import path.
+ *
  * @packageDocumentation
  */
-/** Animation names matching sprite sheet row layout */
-export type AnimationName = 'idle' | 'walk' | 'attack' | 'hit' | 'death';
-/** Sheet file directions (physical PNG files) */
-export type SpriteDirection = 'se' | 'sw';
+import type { AnimationName } from '@almadar/core';
+export type { AnimationName, AnimationDef, SpriteDirection } from '@almadar/core';
 /** Unit facing direction on screen (4 isometric directions) */
 export type FacingDirection = 'se' | 'sw' | 'ne' | 'nw';
-/** Definition for a single animation row in the sprite sheet */
-export interface AnimationDef {
-    /** Row index in the sprite sheet (0-4) */
-    row: number;
-    /** Number of frames in this animation */
-    frames: number;
-    /** Frames per second */
-    frameRate: number;
-    /** Whether the animation loops */
-    loop: boolean;
-}
 /** A resolved frame ready to draw on canvas */
 export interface ResolvedFrame {
     /** URL of the sprite sheet image */
@@ -74,24 +66,7 @@ export interface SpriteSheetUrls {
 /**
  * Parsed sprite-sheet atlas JSON (e.g. `guardian-sprite-sheet.json`).
  * Sits next to the `.png` sheets and drives the frame rect deterministically.
+ * Canonically `@almadar/core`'s `SpriteSheetAtlas` — re-exported under this
+ * package's existing name so call sites don't need to change.
  */
-export interface SpriteAtlas {
-    /** Unit archetype key */
-    unit?: string;
-    /** Visual type key */
-    type?: string;
-    /** Width of a single frame in pixels */
-    frameWidth: number;
-    /** Height of a single frame in pixels */
-    frameHeight: number;
-    /** Number of columns (frames per row) */
-    columns: number;
-    /** Number of rows (animations) */
-    rows: number;
-    /** Directions present as physical PNG files */
-    directions: SpriteDirection[];
-    /** Relative PNG sheet paths per direction */
-    sheets: Partial<Record<SpriteDirection, string>>;
-    /** Animation row layout keyed by animation name */
-    animations: Partial<Record<AnimationName, AnimationDef>>;
-}
+export type { SpriteSheetAtlas as SpriteAtlas } from '@almadar/core';