@almadar/ui 5.41.0 → 5.42.0

package/dist/avl/index.cjs

@@ -46871,6 +46871,10 @@ function SequencerBoard({
   stepDurationMs = 1e3,
   playEvent,
   completeEvent,
+  placeEvent,
+  removeEvent,
+  checkEvent,
+  playAgainEvent,
   className
 }) {
   const { emit } = useEventBus();
@@ -46906,7 +46910,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "drop_slot" });
-  }, [emit]);
+    if (placeEvent) emit(`UI:${placeEvent}`, { slotIndex: index, actionId: item.id });
+  }, [emit, placeEvent]);
   const handleSlotRemove = React91.useCallback((index) => {
     setSlots((prev) => {
       const next = [...prev];
@@ -46919,7 +46924,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "back" });
-  }, [emit]);
+    if (removeEvent) emit(`UI:${removeEvent}`, { slotIndex: index });
+  }, [emit, removeEvent]);
   const handleReset = React91.useCallback(() => {
     if (timerRef.current) clearTimeout(timerRef.current);
     setSlots(Array.from({ length: maxSlots }, () => void 0));
@@ -46927,7 +46933,8 @@ function SequencerBoard({
     setCurrentStep(-1);
     setAttempts(0);
     setSlotFeedback(Array.from({ length: maxSlots }, () => null));
-  }, [maxSlots]);
+    if (playAgainEvent) emit(`UI:${playAgainEvent}`, {});
+  }, [maxSlots, playAgainEvent, emit]);
   const filledSlots = slots.filter((s) => !!s);
   const canPlay = filledSlots.length > 0 && playState === "idle";
   const handlePlay = React91.useCallback(() => {
@@ -46949,6 +46956,7 @@ function SequencerBoard({
         const success = solutions.some(
           (sol) => sol.length === playerIds.length && sol.every((id, i) => id === playerIds[i])
         );
+        if (checkEvent) emit(`UI:${checkEvent}`, { sequence: playerIds });
         if (success) {
           setPlayState("success");
           setCurrentStep(-1);
@@ -46976,7 +46984,7 @@ function SequencerBoard({
       }
     };
     timerRef.current = setTimeout(advance, stepDurationMs);
-  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, emit]);
+  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, checkEvent, emit]);
   const machine = {
     name: str(resolved?.title),
     description: str(resolved?.description),

package/dist/avl/index.js

@@ -46825,6 +46825,10 @@ function SequencerBoard({
   stepDurationMs = 1e3,
   playEvent,
   completeEvent,
+  placeEvent,
+  removeEvent,
+  checkEvent,
+  playAgainEvent,
   className
 }) {
   const { emit } = useEventBus();
@@ -46860,7 +46864,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "drop_slot" });
-  }, [emit]);
+    if (placeEvent) emit(`UI:${placeEvent}`, { slotIndex: index, actionId: item.id });
+  }, [emit, placeEvent]);
   const handleSlotRemove = useCallback((index) => {
     setSlots((prev) => {
       const next = [...prev];
@@ -46873,7 +46878,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "back" });
-  }, [emit]);
+    if (removeEvent) emit(`UI:${removeEvent}`, { slotIndex: index });
+  }, [emit, removeEvent]);
   const handleReset = useCallback(() => {
     if (timerRef.current) clearTimeout(timerRef.current);
     setSlots(Array.from({ length: maxSlots }, () => void 0));
@@ -46881,7 +46887,8 @@ function SequencerBoard({
     setCurrentStep(-1);
     setAttempts(0);
     setSlotFeedback(Array.from({ length: maxSlots }, () => null));
-  }, [maxSlots]);
+    if (playAgainEvent) emit(`UI:${playAgainEvent}`, {});
+  }, [maxSlots, playAgainEvent, emit]);
   const filledSlots = slots.filter((s) => !!s);
   const canPlay = filledSlots.length > 0 && playState === "idle";
   const handlePlay = useCallback(() => {
@@ -46903,6 +46910,7 @@ function SequencerBoard({
         const success = solutions.some(
           (sol) => sol.length === playerIds.length && sol.every((id, i) => id === playerIds[i])
         );
+        if (checkEvent) emit(`UI:${checkEvent}`, { sequence: playerIds });
         if (success) {
           setPlayState("success");
           setCurrentStep(-1);
@@ -46930,7 +46938,7 @@ function SequencerBoard({
       }
     };
     timerRef.current = setTimeout(advance, stepDurationMs);
-  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, emit]);
+  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, checkEvent, emit]);
   const machine = {
     name: str(resolved?.title),
     description: str(resolved?.description),

package/dist/components/game/organisms/UncontrolledBattleBoard.d.ts

@@ -14,7 +14,7 @@
  * @packageDocumentation
  */
 import * as React from 'react';
-import type { EntityRow } from '@almadar/core';
+import type { EntityRow, EventEmit } from '@almadar/core';
 import { type BattleBoardProps } from './BattleBoard';
 import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
 export interface UncontrolledBattleBoardProps extends Omit<BattleBoardProps, 'entity'> {
@@ -27,6 +27,14 @@ export interface UncontrolledBattleBoardProps extends Omit<BattleBoardProps, 'en
     features?: IsometricFeature[];
     /** Direct asset manifest — takes priority over entity-derived manifest. */
     assetManifest?: BattleBoardProps['assetManifest'];
+    /** Emits UI:{stepEvent} with { attackerId, targetId, damage } each battle round */
+    stepEvent?: EventEmit<{
+        attackerId: string;
+        targetId: string;
+        damage: number;
+    }>;
+    /** Emits UI:{playAgainEvent} with {} on restart */
+    playAgainEvent?: EventEmit<Record<string, never>>;
 }
 export declare function UncontrolledBattleBoard({ entity, tiles, units, features, assetManifest, ...rest }: UncontrolledBattleBoardProps): React.JSX.Element | null;
 export declare namespace UncontrolledBattleBoard {

package/dist/components/game/organisms/puzzles/sequencer/SequencerBoard.d.ts

@@ -42,8 +42,23 @@ export interface SequencerBoardProps extends DisplayStateProps {
         success: boolean;
         sequence: string[];
     }>;
+    /** Emits UI:{placeEvent} with { slotIndex, actionId } when an action is dropped into a slot */
+    placeEvent?: EventEmit<{
+        slotIndex: number;
+        actionId: string;
+    }>;
+    /** Emits UI:{removeEvent} with { slotIndex } when an action is removed from a slot */
+    removeEvent?: EventEmit<{
+        slotIndex: number;
+    }>;
+    /** Emits UI:{checkEvent} with { sequence } when the player submits the sequence */
+    checkEvent?: EventEmit<{
+        sequence: string[];
+    }>;
+    /** Emits UI:{playAgainEvent} with {} on reset */
+    playAgainEvent?: EventEmit<Record<string, never>>;
 }
-export declare function SequencerBoard({ entity, categoryColors, stepDurationMs, playEvent, completeEvent, className, }: SequencerBoardProps): React.JSX.Element | null;
+export declare function SequencerBoard({ entity, categoryColors, stepDurationMs, playEvent, completeEvent, placeEvent, removeEvent, checkEvent, playAgainEvent, className, }: SequencerBoardProps): React.JSX.Element | null;
 export declare namespace SequencerBoard {
     var displayName: string;
 }

package/dist/components/index.cjs

@@ -45508,6 +45508,10 @@ function SequencerBoard({
   stepDurationMs = 1e3,
   playEvent,
   completeEvent,
+  placeEvent,
+  removeEvent,
+  checkEvent,
+  playAgainEvent,
   className
 }) {
   const { emit } = useEventBus();
@@ -45543,7 +45547,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "drop_slot" });
-  }, [emit]);
+    if (placeEvent) emit(`UI:${placeEvent}`, { slotIndex: index, actionId: item.id });
+  }, [emit, placeEvent]);
   const handleSlotRemove = React77.useCallback((index) => {
     setSlots((prev) => {
       const next = [...prev];
@@ -45556,7 +45561,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "back" });
-  }, [emit]);
+    if (removeEvent) emit(`UI:${removeEvent}`, { slotIndex: index });
+  }, [emit, removeEvent]);
   const handleReset = React77.useCallback(() => {
     if (timerRef.current) clearTimeout(timerRef.current);
     setSlots(Array.from({ length: maxSlots }, () => void 0));
@@ -45564,7 +45570,8 @@ function SequencerBoard({
     setCurrentStep(-1);
     setAttempts(0);
     setSlotFeedback(Array.from({ length: maxSlots }, () => null));
-  }, [maxSlots]);
+    if (playAgainEvent) emit(`UI:${playAgainEvent}`, {});
+  }, [maxSlots, playAgainEvent, emit]);
   const filledSlots = slots.filter((s) => !!s);
   const canPlay = filledSlots.length > 0 && playState === "idle";
   const handlePlay = React77.useCallback(() => {
@@ -45586,6 +45593,7 @@ function SequencerBoard({
         const success = solutions.some(
           (sol) => sol.length === playerIds.length && sol.every((id, i) => id === playerIds[i])
         );
+        if (checkEvent) emit(`UI:${checkEvent}`, { sequence: playerIds });
         if (success) {
           setPlayState("success");
           setCurrentStep(-1);
@@ -45613,7 +45621,7 @@ function SequencerBoard({
       }
     };
     timerRef.current = setTimeout(advance, stepDurationMs);
-  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, emit]);
+  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, checkEvent, emit]);
   const machine = {
     name: str(resolved?.title),
     description: str(resolved?.description),

package/dist/components/index.js

@@ -45463,6 +45463,10 @@ function SequencerBoard({
   stepDurationMs = 1e3,
   playEvent,
   completeEvent,
+  placeEvent,
+  removeEvent,
+  checkEvent,
+  playAgainEvent,
   className
 }) {
   const { emit } = useEventBus();
@@ -45498,7 +45502,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "drop_slot" });
-  }, [emit]);
+    if (placeEvent) emit(`UI:${placeEvent}`, { slotIndex: index, actionId: item.id });
+  }, [emit, placeEvent]);
   const handleSlotRemove = useCallback((index) => {
     setSlots((prev) => {
       const next = [...prev];
@@ -45511,7 +45516,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "back" });
-  }, [emit]);
+    if (removeEvent) emit(`UI:${removeEvent}`, { slotIndex: index });
+  }, [emit, removeEvent]);
   const handleReset = useCallback(() => {
     if (timerRef.current) clearTimeout(timerRef.current);
     setSlots(Array.from({ length: maxSlots }, () => void 0));
@@ -45519,7 +45525,8 @@ function SequencerBoard({
     setCurrentStep(-1);
     setAttempts(0);
     setSlotFeedback(Array.from({ length: maxSlots }, () => null));
-  }, [maxSlots]);
+    if (playAgainEvent) emit(`UI:${playAgainEvent}`, {});
+  }, [maxSlots, playAgainEvent, emit]);
   const filledSlots = slots.filter((s) => !!s);
   const canPlay = filledSlots.length > 0 && playState === "idle";
   const handlePlay = useCallback(() => {
@@ -45541,6 +45548,7 @@ function SequencerBoard({
         const success = solutions.some(
           (sol) => sol.length === playerIds.length && sol.every((id, i) => id === playerIds[i])
         );
+        if (checkEvent) emit(`UI:${checkEvent}`, { sequence: playerIds });
         if (success) {
           setPlayState("success");
           setCurrentStep(-1);
@@ -45568,7 +45576,7 @@ function SequencerBoard({
       }
     };
     timerRef.current = setTimeout(advance, stepDurationMs);
-  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, emit]);
+  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, checkEvent, emit]);
   const machine = {
     name: str(resolved?.title),
     description: str(resolved?.description),

package/dist/providers/index.cjs

@@ -44784,6 +44784,10 @@ function SequencerBoard({
   stepDurationMs = 1e3,
   playEvent,
   completeEvent,
+  placeEvent,
+  removeEvent,
+  checkEvent,
+  playAgainEvent,
   className
 }) {
   const { emit } = useEventBus();
@@ -44819,7 +44823,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "drop_slot" });
-  }, [emit]);
+    if (placeEvent) emit(`UI:${placeEvent}`, { slotIndex: index, actionId: item.id });
+  }, [emit, placeEvent]);
   const handleSlotRemove = React83.useCallback((index) => {
     setSlots((prev) => {
       const next = [...prev];
@@ -44832,7 +44837,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "back" });
-  }, [emit]);
+    if (removeEvent) emit(`UI:${removeEvent}`, { slotIndex: index });
+  }, [emit, removeEvent]);
   const handleReset = React83.useCallback(() => {
     if (timerRef.current) clearTimeout(timerRef.current);
     setSlots(Array.from({ length: maxSlots }, () => void 0));
@@ -44840,7 +44846,8 @@ function SequencerBoard({
     setCurrentStep(-1);
     setAttempts(0);
     setSlotFeedback(Array.from({ length: maxSlots }, () => null));
-  }, [maxSlots]);
+    if (playAgainEvent) emit(`UI:${playAgainEvent}`, {});
+  }, [maxSlots, playAgainEvent, emit]);
   const filledSlots = slots.filter((s) => !!s);
   const canPlay = filledSlots.length > 0 && playState === "idle";
   const handlePlay = React83.useCallback(() => {
@@ -44862,6 +44869,7 @@ function SequencerBoard({
         const success = solutions.some(
           (sol) => sol.length === playerIds.length && sol.every((id, i) => id === playerIds[i])
         );
+        if (checkEvent) emit(`UI:${checkEvent}`, { sequence: playerIds });
         if (success) {
           setPlayState("success");
           setCurrentStep(-1);
@@ -44889,7 +44897,7 @@ function SequencerBoard({
       }
     };
     timerRef.current = setTimeout(advance, stepDurationMs);
-  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, emit]);
+  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, checkEvent, emit]);
   const machine = {
     name: str(resolved?.title),
     description: str(resolved?.description),

package/dist/providers/index.js

@@ -44738,6 +44738,10 @@ function SequencerBoard({
   stepDurationMs = 1e3,
   playEvent,
   completeEvent,
+  placeEvent,
+  removeEvent,
+  checkEvent,
+  playAgainEvent,
   className
 }) {
   const { emit } = useEventBus();
@@ -44773,7 +44777,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "drop_slot" });
-  }, [emit]);
+    if (placeEvent) emit(`UI:${placeEvent}`, { slotIndex: index, actionId: item.id });
+  }, [emit, placeEvent]);
   const handleSlotRemove = useCallback((index) => {
     setSlots((prev) => {
       const next = [...prev];
@@ -44786,7 +44791,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "back" });
-  }, [emit]);
+    if (removeEvent) emit(`UI:${removeEvent}`, { slotIndex: index });
+  }, [emit, removeEvent]);
   const handleReset = useCallback(() => {
     if (timerRef.current) clearTimeout(timerRef.current);
     setSlots(Array.from({ length: maxSlots }, () => void 0));
@@ -44794,7 +44800,8 @@ function SequencerBoard({
     setCurrentStep(-1);
     setAttempts(0);
     setSlotFeedback(Array.from({ length: maxSlots }, () => null));
-  }, [maxSlots]);
+    if (playAgainEvent) emit(`UI:${playAgainEvent}`, {});
+  }, [maxSlots, playAgainEvent, emit]);
   const filledSlots = slots.filter((s) => !!s);
   const canPlay = filledSlots.length > 0 && playState === "idle";
   const handlePlay = useCallback(() => {
@@ -44816,6 +44823,7 @@ function SequencerBoard({
         const success = solutions.some(
           (sol) => sol.length === playerIds.length && sol.every((id, i) => id === playerIds[i])
         );
+        if (checkEvent) emit(`UI:${checkEvent}`, { sequence: playerIds });
         if (success) {
           setPlayState("success");
           setCurrentStep(-1);
@@ -44843,7 +44851,7 @@ function SequencerBoard({
       }
     };
     timerRef.current = setTimeout(advance, stepDurationMs);
-  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, emit]);
+  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, checkEvent, emit]);
   const machine = {
     name: str(resolved?.title),
     description: str(resolved?.description),

package/dist/runtime/index.cjs

@@ -44370,6 +44370,10 @@ function SequencerBoard({
   stepDurationMs = 1e3,
   playEvent,
   completeEvent,
+  placeEvent,
+  removeEvent,
+  checkEvent,
+  playAgainEvent,
   className
 }) {
   const { emit } = useEventBus();
@@ -44405,7 +44409,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "drop_slot" });
-  }, [emit]);
+    if (placeEvent) emit(`UI:${placeEvent}`, { slotIndex: index, actionId: item.id });
+  }, [emit, placeEvent]);
   const handleSlotRemove = React82.useCallback((index) => {
     setSlots((prev) => {
       const next = [...prev];
@@ -44418,7 +44423,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "back" });
-  }, [emit]);
+    if (removeEvent) emit(`UI:${removeEvent}`, { slotIndex: index });
+  }, [emit, removeEvent]);
   const handleReset = React82.useCallback(() => {
     if (timerRef.current) clearTimeout(timerRef.current);
     setSlots(Array.from({ length: maxSlots }, () => void 0));
@@ -44426,7 +44432,8 @@ function SequencerBoard({
     setCurrentStep(-1);
     setAttempts(0);
     setSlotFeedback(Array.from({ length: maxSlots }, () => null));
-  }, [maxSlots]);
+    if (playAgainEvent) emit(`UI:${playAgainEvent}`, {});
+  }, [maxSlots, playAgainEvent, emit]);
   const filledSlots = slots.filter((s) => !!s);
   const canPlay = filledSlots.length > 0 && playState === "idle";
   const handlePlay = React82.useCallback(() => {
@@ -44448,6 +44455,7 @@ function SequencerBoard({
         const success = solutions.some(
           (sol) => sol.length === playerIds.length && sol.every((id, i) => id === playerIds[i])
         );
+        if (checkEvent) emit(`UI:${checkEvent}`, { sequence: playerIds });
         if (success) {
           setPlayState("success");
           setCurrentStep(-1);
@@ -44475,7 +44483,7 @@ function SequencerBoard({
       }
     };
     timerRef.current = setTimeout(advance, stepDurationMs);
-  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, emit]);
+  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, checkEvent, emit]);
   const machine = {
     name: str(resolved?.title),
     description: str(resolved?.description),

package/dist/runtime/index.js

@@ -44324,6 +44324,10 @@ function SequencerBoard({
   stepDurationMs = 1e3,
   playEvent,
   completeEvent,
+  placeEvent,
+  removeEvent,
+  checkEvent,
+  playAgainEvent,
   className
 }) {
   const { emit } = useEventBus();
@@ -44359,7 +44363,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "drop_slot" });
-  }, [emit]);
+    if (placeEvent) emit(`UI:${placeEvent}`, { slotIndex: index, actionId: item.id });
+  }, [emit, placeEvent]);
   const handleSlotRemove = useCallback((index) => {
     setSlots((prev) => {
       const next = [...prev];
@@ -44372,7 +44377,8 @@ function SequencerBoard({
       return next;
     });
     emit("UI:PLAY_SOUND", { key: "back" });
-  }, [emit]);
+    if (removeEvent) emit(`UI:${removeEvent}`, { slotIndex: index });
+  }, [emit, removeEvent]);
   const handleReset = useCallback(() => {
     if (timerRef.current) clearTimeout(timerRef.current);
     setSlots(Array.from({ length: maxSlots }, () => void 0));
@@ -44380,7 +44386,8 @@ function SequencerBoard({
     setCurrentStep(-1);
     setAttempts(0);
     setSlotFeedback(Array.from({ length: maxSlots }, () => null));
-  }, [maxSlots]);
+    if (playAgainEvent) emit(`UI:${playAgainEvent}`, {});
+  }, [maxSlots, playAgainEvent, emit]);
   const filledSlots = slots.filter((s) => !!s);
   const canPlay = filledSlots.length > 0 && playState === "idle";
   const handlePlay = useCallback(() => {
@@ -44402,6 +44409,7 @@ function SequencerBoard({
         const success = solutions.some(
           (sol) => sol.length === playerIds.length && sol.every((id, i) => id === playerIds[i])
         );
+        if (checkEvent) emit(`UI:${checkEvent}`, { sequence: playerIds });
         if (success) {
           setPlayState("success");
           setCurrentStep(-1);
@@ -44429,7 +44437,7 @@ function SequencerBoard({
       }
     };
     timerRef.current = setTimeout(advance, stepDurationMs);
-  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, emit]);
+  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, checkEvent, emit]);
   const machine = {
     name: str(resolved?.title),
     description: str(resolved?.description),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "5.41.0",
+  "version": "5.42.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [