@almadar/ui 5.89.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}/ObjectRulePanel.d.ts

@@ -8,19 +8,24 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EntityRow } from '@almadar/core';
+import type { EntityRow, EventEmit } from '@almadar/core';
 import { type RuleDefinition } from './RuleEditor';
 export interface ObjectRulePanelProps {
     /** The selected puzzle-object row (`EntityRow` carrying the editable object data) */
     object: EntityRow;
-    /** Called when rules change */
-    onRulesChange: (objectId: string, rules: RuleDefinition[]) => void;
+    /** Called when rules change (callback path) */
+    onRulesChange?: (objectId: string, rules: RuleDefinition[]) => void;
+    /** Emits UI:{rulesChangeEvent} with { objectId, rules } when rules change (declarative path) */
+    rulesChangeEvent?: EventEmit<{
+        objectId: string;
+        rules: RuleDefinition[];
+    }>;
     /** Whether editing is disabled */
     disabled?: boolean;
     /** Additional CSS classes */
     className?: string;
 }
-export declare function ObjectRulePanel({ object, onRulesChange, disabled, className, }: ObjectRulePanelProps): React.JSX.Element;
+export declare function ObjectRulePanel({ object, onRulesChange, rulesChangeEvent, disabled, className, }: ObjectRulePanelProps): React.JSX.Element;
 export declare namespace ObjectRulePanel {
     var displayName: string;
 }

package/dist/components/game/2d/{organisms → molecules}/SequenceBar.d.ts

@@ -8,16 +8,26 @@
  * @packageDocumentation
  */
 import React from 'react';
+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/StateJsonView.d.ts

@@ -0,0 +1,37 @@
+/**
+ * StateJsonView Component
+ *
+ * Shows a state machine's definition as an expandable code block, so the learner
+ * sees the declarative schema behind the visual graph. Dumb molecule: takes the
+ * machine as plain typed fields (name/states/initialState/transitions) — the
+ * .lolo organism owns the entity and the molecule renders + stringifies it.
+ *
+ * @packageDocumentation
+ */
+import React from 'react';
+export interface StateJsonTransition {
+    from: string;
+    to: string;
+    event: string;
+}
+export interface StateJsonViewProps {
+    /** Machine name */
+    name: string;
+    /** Initial state */
+    initialState: string;
+    /** All state names */
+    states: string[];
+    /** The player's wired transitions */
+    transitions: StateJsonTransition[];
+    /** Header label */
+    label?: string;
+    /** Whether the code block is expanded by default */
+    defaultExpanded?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function StateJsonView({ name, initialState, states, transitions, label, defaultExpanded, className, }: StateJsonViewProps): React.JSX.Element;
+export declare namespace StateJsonView {
+    var displayName: string;
+}
+export default StateJsonView;

package/dist/components/game/2d/{organisms → molecules}/TraitSlot.d.ts

@@ -66,8 +66,6 @@ export interface TraitSlotProps {
     isLoading?: boolean;
     /** Error state */
     error?: UiError | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
     /** Called when an item is dropped on this slot */
     onItemDrop?: (item: SlotItemData) => void;
     /** Whether this slot's equipped item is draggable */
@@ -88,8 +86,13 @@ export interface TraitSlotProps {
     removeEvent?: EventEmit<{
         slotNumber: number;
     }>;
+    /** Emits UI:{dropEvent} with { slotNumber, itemId } when an item is dropped into this slot */
+    dropEvent?: EventEmit<{
+        slotNumber: number;
+        itemId: string;
+    }>;
 }
-export declare function TraitSlot({ slotNumber, equippedItem, locked, lockLabel, selected, size, showTooltip, categoryColors, tooltipFrameUrl, className, feedback, onItemDrop, draggable, onDragStart, onClick, onRemove, clickEvent, removeEvent, }: TraitSlotProps): React.JSX.Element;
+export declare function TraitSlot({ slotNumber, equippedItem, locked, lockLabel, selected, size, showTooltip, categoryColors, tooltipFrameUrl, className, feedback, onItemDrop, draggable, onDragStart, onClick, onRemove, clickEvent, removeEvent, dropEvent, }: TraitSlotProps): React.JSX.Element;
 export declare namespace TraitSlot {
     var displayName: string;
 }

package/dist/components/game/2d/{organisms → molecules}/TraitStateViewer.d.ts

@@ -44,8 +44,6 @@ export interface TraitStateViewerProps {
     isLoading?: boolean;
     /** Error state */
     error?: UiError | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
 }
 export declare function TraitStateViewer({ trait, variant, size, showTransitions, onStateClick, stateStyles, className, }: TraitStateViewerProps): React.JSX.Element;
 export declare namespace TraitStateViewer {

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

@@ -0,0 +1,28 @@
+/**
+ * VariablePanel Component
+ *
+ * Shows a machine's variables and their current values during State Architect
+ * playback. Dumb molecule: takes a plain typed list of { name, value } — the
+ * .lolo organism owns the entity data and passes it already flattened.
+ *
+ * @packageDocumentation
+ */
+import React from 'react';
+/** A single variable row (already flattened by the .lolo — plain strings). */
+export interface VariablePanelVariable {
+    name: string;
+    value: string;
+}
+export interface VariablePanelProps {
+    /** Entity name shown in the header */
+    entityName: string;
+    /** Variable rows to display */
+    variables: VariablePanelVariable[];
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function VariablePanel({ entityName, variables, className, }: VariablePanelProps): React.JSX.Element;
+export declare namespace VariablePanel {
+    var displayName: string;
+}
+export default VariablePanel;

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

@@ -39,32 +39,28 @@ export { GameAudioProvider, GameAudioContext, useGameAudioContext, type GameAudi
 export { GameAudioToggle, type GameAudioToggleProps, } from '../atoms/GameAudioToggle';
 export { useGameAudio, type AudioManifest, type SoundEntry, type GameAudioControls, type UseGameAudioOptions, } from '../../shared/hooks/useGameAudio';
 export { useCamera } from '../../shared/hooks/useCamera';
-export { TraitStateViewer, type TraitStateViewerProps, type TraitStateMachineDefinition, type TraitTransition, } from '../organisms/TraitStateViewer';
-export { TraitSlot, type TraitSlotProps, type SlotItemData, } from '../organisms/TraitSlot';
+export { TraitStateViewer, type TraitStateViewerProps, type TraitStateMachineDefinition, type TraitTransition, } from './TraitStateViewer';
+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 '../organisms/ActionTile';
-export { ActionPalette, type ActionPaletteProps } from '../organisms/ActionPalette';
-export { SequenceBar, type SequenceBarProps } from '../organisms/SequenceBar';
+export { ActionTile, type ActionTileProps } from './ActionTile';
+export { ActionPalette, type ActionPaletteProps } from './ActionPalette';
+export { SequenceBar, type SequenceBarProps } from './SequenceBar';
 export { SequencerBoard, type SequencerBoardProps } from '../organisms/SequencerBoard';
-export { RuleEditor, type RuleEditorProps, type RuleDefinition } from '../organisms/RuleEditor';
-export { EventLog, type EventLogProps, type EventLogEntry } from '../organisms/EventLog';
-export { ObjectRulePanel, type ObjectRulePanelProps } from '../organisms/ObjectRulePanel';
+export { RuleEditor, type RuleEditorProps, type RuleDefinition } from './RuleEditor';
+export { EventLog, type EventLogProps, type EventLogEntry } from './EventLog';
+export { ObjectRulePanel, type ObjectRulePanelProps } from './ObjectRulePanel';
 export { EventHandlerBoard, type EventHandlerBoardProps } from '../organisms/EventHandlerBoard';
 export * from '../../shared/lib/puzzleObject';
-export { StateNode, type StateNodeProps } from '../organisms/StateNode';
-export { TransitionArrow, type TransitionArrowProps } from '../organisms/TransitionArrow';
-export { VariablePanel, type VariablePanelProps } from '../organisms/VariablePanel';
-export { StateJsonView, type StateJsonViewProps } from '../organisms/StateJsonView';
+export { StateNode, type StateNodeProps } from './StateNode';
+export { TransitionArrow, type TransitionArrowProps } from './TransitionArrow';
+export { VariablePanel, type VariablePanelProps } from './VariablePanel';
+export { StateJsonView, type StateJsonViewProps } from './StateJsonView';
 export { StateArchitectBoard, type StateArchitectBoardProps, type StateArchitectTransition, type TestCase, } from '../organisms/StateArchitectBoard';
 export { SimulatorBoard, type SimulatorBoardProps, type SimulatorParameter } from '../organisms/SimulatorBoard';
 export { ClassifierBoard, type ClassifierBoardProps, type ClassifierItem, type ClassifierCategory } from '../organisms/ClassifierBoard';
 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/2d/organisms/EventHandlerBoard.d.ts

@@ -13,7 +13,7 @@
 import React from 'react';
 import type { EventEmit, EntityRow } from '@almadar/core';
 import type { DisplayStateProps } from '../../../core/organisms/types';
-import type { RuleDefinition } from './RuleEditor';
+import type { RuleDefinition } from '../molecules/RuleEditor';
 export interface EventHandlerBoardProps extends DisplayStateProps {
     /** Puzzle board-state entity (single row or array). The board reads
      *  `objects` / `triggerEvents` / `goalEvent` etc. off the row; the editable

package/dist/components/game/shared/lib/puzzleObject.d.ts

@@ -9,7 +9,7 @@
  * @packageDocumentation
  */
 import type { EntityWith } from '@almadar/core';
-import type { RuleDefinition, RuleOption } from '../../2d/organisms/RuleEditor';
+import type { RuleDefinition, RuleOption } from '../../2d/molecules/RuleEditor';
 type PuzzleObjectRow = EntityWith<{
     name?: string;
     icon?: string;

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