@almadar/ui 5.87.0 → 5.91.0

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/molecules/StateGraph.d.ts

@@ -0,0 +1,38 @@
+/**
+ * StateGraph (molecule)
+ *
+ * Dumb visual renderer for a state-machine graph: lays states out on a circle,
+ * draws the player's transitions as SVG arrows, and emits a node-click event.
+ * All state (which transitions exist, the pending "from" selection, test results)
+ * lives in the .lolo FSM — this molecule only renders and reports clicks.
+ */
+import * as React from 'react';
+import type { EventKey } from '@almadar/core';
+export interface StateGraphTransition {
+    from: string;
+    to: string;
+    event: string;
+    guardHint?: string;
+}
+export interface StateGraphProps {
+    /** All states in the machine (node labels). */
+    states: string[];
+    /** Player-built transitions rendered as arrows. */
+    transitions?: StateGraphTransition[];
+    /** State highlighted as current (test playback / initial). */
+    currentState?: string;
+    /** State the player has selected (first click). */
+    selectedState?: string;
+    /** When set, the graph is in "pick a target" mode from this state. */
+    addingFrom?: string;
+    /** The machine's initial state (ring-marked). */
+    initialState?: string;
+    /** Graph canvas width. */
+    width?: number;
+    /** Graph canvas height. */
+    height?: number;
+    /** Emits UI:{nodeClickEvent} with { stateId } when a node is clicked. */
+    nodeClickEvent?: EventKey;
+    className?: string;
+}
+export declare function StateGraph({ states, transitions, currentState, selectedState, addingFrom, initialState, width, height, nodeClickEvent, className, }: StateGraphProps): React.JSX.Element;

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

@@ -32,28 +32,29 @@ export { InventoryGrid, type InventoryGridProps, type InventoryGridItem } from '
 export { ResourceBar, type ResourceBarProps, type ResourceBarResource } from './ResourceBar';
 export { GameHud, type GameHudProps, type GameHudStat, type GameHudElement } from './GameHud';
 export { GameMenu, type GameMenuProps, type MenuOption } from './GameMenu';
+export { StateGraph, type StateGraphProps, type StateGraphTransition } from './StateGraph';
 export { Canvas2D, type Canvas2DProps, type Projection, type CameraMode, type Platform, type SidePlayer, type TileCoord, } from './Canvas2D';
 export { useUnitSpriteAtlas } from '../../shared/hooks/useUnitSpriteAtlas';
 export { GameAudioProvider, GameAudioContext, useGameAudioContext, type GameAudioProviderProps, type GameAudioContextValue, } from '../../shared/providers/GameAudioProvider';
 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 { ActionTile, type ActionTileProps } from './ActionTile';
+export { ActionPalette, type ActionPaletteProps } from './ActionPalette';
 export { SequenceBar, type SequenceBarProps } from '../organisms/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';

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/2d/organisms/SequenceBar.d.ts

@@ -8,7 +8,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { SlotItemData } from './TraitSlot';
+import type { SlotItemData } from '../molecules/TraitSlot';
 export interface SequenceBarProps {
     /** The current sequence (sparse — undefined means empty slot) */
     slots: Array<SlotItemData | undefined>;

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;