@almadar/ui 2.13.1 → 2.13.3

package/dist/runtime/index.js

@@ -1,15 +1,15 @@
-import '../chunk-X2ZDE63F.js';
+import '../chunk-PERGHHON.js';
 import '../chunk-N7MVUW4R.js';
 import { registerTrait, unregisterTrait, updateTraitState } from '../chunk-42YQ6JVR.js';
 import '../chunk-3HJHHULT.js';
-import { useFetchedDataContext } from '../chunk-XF7GGUTH.js';
-import '../chunk-YYCP5CD7.js';
-import '../chunk-YLKXEXBP.js';
-import '../chunk-3CP74CBL.js';
+import { useFetchedDataContext } from '../chunk-UNDQO6DL.js';
+import '../chunk-MSLMORZK.js';
+import '../chunk-DKQN5FVU.js';
+import '../chunk-Y7IHEYYE.js';
 import { useEventBus } from '../chunk-YXZM3WCF.js';
 import '../chunk-3JGAROCW.js';
-import '../chunk-2XXSUIOK.js';
 import { recordTransition } from '../chunk-WCTZ7WZX.js';
+import '../chunk-2XXSUIOK.js';
 import '../chunk-K2D5D3WK.js';
 import '../chunk-PKBMQBKP.js';
 import { createContext, useMemo, useContext, useState, useRef, useEffect, useCallback } from 'react';
@@ -107,6 +107,8 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
   const [traitStates, setTraitStates] = useState(() => {
     return manager.getAllStates();
   });
+  const eventQueueRef = useRef([]);
+  const processingRef = useRef(false);
   const traitBindingsRef = useRef(traitBindings);
   const managerRef = useRef(manager);
   const slotsActionsRef = useRef(slotsActions);
@@ -311,7 +313,7 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
       for (const id of intervals) clearInterval(id);
     };
   }, [traitBindings, runTickEffects]);
-  const processEvent = useCallback((eventKey, payload) => {
+  const processEventQueued = useCallback(async (eventKey, payload) => {
     const normalizedEvent = normalizeEventKey(eventKey);
     const bindings = traitBindingsRef.current;
     const currentManager = managerRef.current;
@@ -443,7 +445,8 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
           entityId
         };
         const executor = new EffectExecutor({ handlers, bindings: bindingCtx, context: effectContext });
-        executor.executeAll(result.effects).then(() => {
+        try {
+          await executor.executeAll(result.effects);
           console.log(
             "[TraitStateMachine] After executeAll, pendingSlots:",
             Object.fromEntries(pendingSlots.entries())
@@ -464,14 +467,14 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
               fetchedDataContext.setData({ [linkedEntity]: updated });
             }
           }
-        }).catch((error) => {
+        } catch (error) {
           console.error(
             "[TraitStateMachine] Effect execution error:",
             error,
             "| effects:",
             JSON.stringify(result.effects)
           );
-        });
+        }
       } else if (!result.executed) {
         if (result.guardResult === false) {
           console.log(
@@ -533,9 +536,28 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
       onEventProcessed(normalizedEvent, payload);
     }
   }, [entities, fetchedDataContext, eventBus]);
+  const drainEventQueue = useCallback(async () => {
+    if (processingRef.current) return;
+    processingRef.current = true;
+    try {
+      while (eventQueueRef.current.length > 0) {
+        const entry = eventQueueRef.current.shift();
+        await processEventQueued(entry.eventKey, entry.payload);
+      }
+    } finally {
+      processingRef.current = false;
+    }
+  }, [processEventQueued]);
+  const enqueueAndDrain = useCallback((eventKey, payload) => {
+    eventQueueRef.current.push({ eventKey, payload });
+    void drainEventQueue();
+  }, [drainEventQueue]);
+  useCallback((eventKey, payload) => {
+    enqueueAndDrain(eventKey, payload);
+  }, [enqueueAndDrain]);
   const sendEvent = useCallback((eventKey, payload) => {
-    processEvent(eventKey, payload);
-  }, [processEvent]);
+    enqueueAndDrain(eventKey, payload);
+  }, [enqueueAndDrain]);
   const getTraitState = useCallback((traitName) => {
     return managerRef.current.getState(traitName);
   }, []);
@@ -561,7 +583,7 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
       }
       const unsub = eventBus.on(`UI:${eventKey}`, (event) => {
         console.log("[TraitStateMachine] Received event:", `UI:${eventKey}`, event);
-        processEvent(eventKey, event.payload);
+        enqueueAndDrain(eventKey, event.payload);
       });
       unsubscribes.push(unsub);
     }
@@ -570,7 +592,7 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
         unsub();
       }
     };
-  }, [traitBindings, eventBus, processEvent]);
+  }, [traitBindings, eventBus, enqueueAndDrain]);
   return {
     traitStates,
     sendEvent,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "2.13.1",
+  "version": "2.13.3",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",

package/dist/{parseContentSegments-BZrQRvgK.d.ts → cn-C_ATNPvi.d.ts}

@@ -1,149 +1,5 @@
 import { ClassValue } from 'clsx';
 
-/**
- * Utility function to merge Tailwind CSS classes
- * Combines clsx for conditional classes with tailwind-merge to handle conflicts
- */
-declare function cn(...inputs: ClassValue[]): string;
-
-/**
- * Verification Registry - Tracks runtime verification checks and transition traces
- *
- * Provides:
- * 1. A checklist of pass/fail checks (INIT has fetch, bridge connected, etc.)
- * 2. A full transition timeline with effect execution results
- * 3. ServerBridge health snapshot
- * 4. window.__orbitalVerification for Playwright/automation
- *
- * @packageDocumentation
- */
-type CheckStatus = "pass" | "fail" | "pending" | "warn";
-interface VerificationCheck {
-    id: string;
-    label: string;
-    status: CheckStatus;
-    details?: string;
-    /** Timestamp when status last changed */
-    updatedAt: number;
-}
-interface EffectTrace {
-    type: string;
-    args: unknown[];
-    status: "executed" | "failed" | "skipped";
-    error?: string;
-    durationMs?: number;
-}
-interface TransitionTrace {
-    id: string;
-    traitName: string;
-    from: string;
-    to: string;
-    event: string;
-    guardExpression?: string;
-    guardResult?: boolean;
-    effects: EffectTrace[];
-    timestamp: number;
-}
-interface BridgeHealth {
-    connected: boolean;
-    eventsForwarded: number;
-    eventsReceived: number;
-    lastError?: string;
-    lastHeartbeat: number;
-}
-interface VerificationSummary {
-    totalChecks: number;
-    passed: number;
-    failed: number;
-    warnings: number;
-    pending: number;
-}
-interface VerificationSnapshot {
-    checks: VerificationCheck[];
-    transitions: TransitionTrace[];
-    bridge: BridgeHealth | null;
-    summary: VerificationSummary;
-}
-type ChangeListener = () => void;
-declare function registerCheck(id: string, label: string, status?: CheckStatus, details?: string): void;
-declare function updateCheck(id: string, status: CheckStatus, details?: string): void;
-declare function getAllChecks(): VerificationCheck[];
-declare function recordTransition(trace: Omit<TransitionTrace, "id">): void;
-declare function getTransitions(): TransitionTrace[];
-declare function getTransitionsForTrait(traitName: string): TransitionTrace[];
-declare function updateBridgeHealth(health: BridgeHealth): void;
-declare function getBridgeHealth(): BridgeHealth | null;
-declare function getSummary(): VerificationSummary;
-declare function getSnapshot(): VerificationSnapshot;
-declare function subscribeToVerification(listener: ChangeListener): () => void;
-/** Asset load status for canvas verification */
-type AssetLoadStatus = "loaded" | "failed" | "pending";
-/** Event bus log entry for verification */
-interface EventLogEntry {
-    type: string;
-    payload?: Record<string, unknown>;
-    timestamp: number;
-}
-/** Exposed on window for Playwright to query */
-interface OrbitalVerificationAPI {
-    getSnapshot: () => VerificationSnapshot;
-    getChecks: () => VerificationCheck[];
-    getTransitions: () => TransitionTrace[];
-    getBridge: () => BridgeHealth | null;
-    getSummary: () => VerificationSummary;
-    /** Wait for a specific event to be processed */
-    waitForTransition: (event: string, timeoutMs?: number) => Promise<TransitionTrace | null>;
-    /** Send an event into the runtime (requires eventBus binding) */
-    sendEvent?: (event: string, payload?: Record<string, unknown>) => void;
-    /** Get current trait state */
-    getTraitState?: (traitName: string) => string | undefined;
-    /** Capture a canvas frame as PNG data URL. Registered by game organisms. */
-    captureFrame?: () => string | null;
-    /** Asset load status map. Registered by game organisms. */
-    assetStatus?: Record<string, AssetLoadStatus>;
-    /** Event bus log. Records all emit() calls for verification. */
-    eventLog?: EventLogEntry[];
-    /** Clear the event log. */
-    clearEventLog?: () => void;
-}
-declare global {
-    interface Window {
-        __orbitalVerification?: OrbitalVerificationAPI;
-    }
-}
-/**
- * Wait for a transition matching the given event to appear.
- * Returns the trace or null on timeout.
- */
-declare function waitForTransition(event: string, timeoutMs?: number): Promise<TransitionTrace | null>;
-/**
- * Bind the EventBus so automation can send events and log emissions.
- * Call this during app initialization.
- */
-declare function bindEventBus(eventBus: {
-    emit: (type: string, payload?: Record<string, unknown>) => void;
-    onAny?: (listener: (event: {
-        type: string;
-        payload?: Record<string, unknown>;
-    }) => void) => () => void;
-}): void;
-/**
- * Bind a trait state getter so automation can query current states.
- */
-declare function bindTraitStateGetter(getter: (traitName: string) => string | undefined): void;
-/**
- * Register a canvas frame capture function.
- * Called by game organisms (IsometricCanvas, PlatformerCanvas, SimulationCanvas)
- * so the verifier can snapshot canvas content at checkpoints.
- */
-declare function bindCanvasCapture(captureFn: () => string | null): void;
-/**
- * Update asset load status for canvas verification.
- * Game organisms call this when images load or fail.
- */
-declare function updateAssetStatus(url: string, status: AssetLoadStatus): void;
-declare function clearVerification(): void;
-
 /**
  * Orbital State Machine Visualizer
  *
@@ -329,4 +185,148 @@ declare function parseMarkdownWithCodeBlocks(content: string | undefined | null)
  */
 declare function parseContentSegments(content: string | undefined | null): ContentSegment[];
 
+/**
+ * Verification Registry - Tracks runtime verification checks and transition traces
+ *
+ * Provides:
+ * 1. A checklist of pass/fail checks (INIT has fetch, bridge connected, etc.)
+ * 2. A full transition timeline with effect execution results
+ * 3. ServerBridge health snapshot
+ * 4. window.__orbitalVerification for Playwright/automation
+ *
+ * @packageDocumentation
+ */
+type CheckStatus = "pass" | "fail" | "pending" | "warn";
+interface VerificationCheck {
+    id: string;
+    label: string;
+    status: CheckStatus;
+    details?: string;
+    /** Timestamp when status last changed */
+    updatedAt: number;
+}
+interface EffectTrace {
+    type: string;
+    args: unknown[];
+    status: "executed" | "failed" | "skipped";
+    error?: string;
+    durationMs?: number;
+}
+interface TransitionTrace {
+    id: string;
+    traitName: string;
+    from: string;
+    to: string;
+    event: string;
+    guardExpression?: string;
+    guardResult?: boolean;
+    effects: EffectTrace[];
+    timestamp: number;
+}
+interface BridgeHealth {
+    connected: boolean;
+    eventsForwarded: number;
+    eventsReceived: number;
+    lastError?: string;
+    lastHeartbeat: number;
+}
+interface VerificationSummary {
+    totalChecks: number;
+    passed: number;
+    failed: number;
+    warnings: number;
+    pending: number;
+}
+interface VerificationSnapshot {
+    checks: VerificationCheck[];
+    transitions: TransitionTrace[];
+    bridge: BridgeHealth | null;
+    summary: VerificationSummary;
+}
+type ChangeListener = () => void;
+declare function registerCheck(id: string, label: string, status?: CheckStatus, details?: string): void;
+declare function updateCheck(id: string, status: CheckStatus, details?: string): void;
+declare function getAllChecks(): VerificationCheck[];
+declare function recordTransition(trace: Omit<TransitionTrace, "id">): void;
+declare function getTransitions(): TransitionTrace[];
+declare function getTransitionsForTrait(traitName: string): TransitionTrace[];
+declare function updateBridgeHealth(health: BridgeHealth): void;
+declare function getBridgeHealth(): BridgeHealth | null;
+declare function getSummary(): VerificationSummary;
+declare function getSnapshot(): VerificationSnapshot;
+declare function subscribeToVerification(listener: ChangeListener): () => void;
+/** Asset load status for canvas verification */
+type AssetLoadStatus = "loaded" | "failed" | "pending";
+/** Event bus log entry for verification */
+interface EventLogEntry {
+    type: string;
+    payload?: Record<string, unknown>;
+    timestamp: number;
+}
+/** Exposed on window for Playwright to query */
+interface OrbitalVerificationAPI {
+    getSnapshot: () => VerificationSnapshot;
+    getChecks: () => VerificationCheck[];
+    getTransitions: () => TransitionTrace[];
+    getBridge: () => BridgeHealth | null;
+    getSummary: () => VerificationSummary;
+    /** Wait for a specific event to be processed */
+    waitForTransition: (event: string, timeoutMs?: number) => Promise<TransitionTrace | null>;
+    /** Send an event into the runtime (requires eventBus binding) */
+    sendEvent?: (event: string, payload?: Record<string, unknown>) => void;
+    /** Get current trait state */
+    getTraitState?: (traitName: string) => string | undefined;
+    /** Capture a canvas frame as PNG data URL. Registered by game organisms. */
+    captureFrame?: () => string | null;
+    /** Asset load status map. Registered by game organisms. */
+    assetStatus?: Record<string, AssetLoadStatus>;
+    /** Event bus log. Records all emit() calls for verification. */
+    eventLog?: EventLogEntry[];
+    /** Clear the event log. */
+    clearEventLog?: () => void;
+}
+declare global {
+    interface Window {
+        __orbitalVerification?: OrbitalVerificationAPI;
+    }
+}
+/**
+ * Wait for a transition matching the given event to appear.
+ * Returns the trace or null on timeout.
+ */
+declare function waitForTransition(event: string, timeoutMs?: number): Promise<TransitionTrace | null>;
+/**
+ * Bind the EventBus so automation can send events and log emissions.
+ * Call this during app initialization.
+ */
+declare function bindEventBus(eventBus: {
+    emit: (type: string, payload?: Record<string, unknown>) => void;
+    onAny?: (listener: (event: {
+        type: string;
+        payload?: Record<string, unknown>;
+    }) => void) => () => void;
+}): void;
+/**
+ * Bind a trait state getter so automation can query current states.
+ */
+declare function bindTraitStateGetter(getter: (traitName: string) => string | undefined): void;
+/**
+ * Register a canvas frame capture function.
+ * Called by game organisms (IsometricCanvas, PlatformerCanvas, SimulationCanvas)
+ * so the verifier can snapshot canvas content at checkpoints.
+ */
+declare function bindCanvasCapture(captureFn: () => string | null): void;
+/**
+ * Update asset load status for canvas verification.
+ * Game organisms call this when images load or fail.
+ */
+declare function updateAssetStatus(url: string, status: AssetLoadStatus): void;
+declare function clearVerification(): void;
+
+/**
+ * Utility function to merge Tailwind CSS classes
+ * Combines clsx for conditional classes with tailwind-merge to handle conflicts
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
 export { type AssetLoadStatus as A, type BridgeHealth as B, type CheckStatus as C, DEFAULT_CONFIG as D, type EffectTrace as E, getSummary as F, getTransitions as G, getTransitionsForTrait as H, parseContentSegments as I, parseMarkdownWithCodeBlocks as J, recordTransition as K, registerCheck as L, renderStateMachineToDomData as M, renderStateMachineToSvg as N, subscribeToVerification as O, updateAssetStatus as P, updateBridgeHealth as Q, type RenderOptions as R, type StateDefinition as S, type TransitionDefinition as T, updateCheck as U, type VerificationCheck as V, waitForTransition as W, type ContentSegment as a, type DomEntityBox as b, type DomLayoutData as c, type DomOutputsBox as d, type DomStateNode as e, type DomTransitionLabel as f, type DomTransitionPath as g, type EntityDefinition as h, type EventLogEntry as i, type StateMachineDefinition as j, type TransitionTrace as k, type VerificationSnapshot as l, type VerificationSummary as m, type VisualizerConfig as n, bindCanvasCapture as o, bindEventBus as p, bindTraitStateGetter as q, clearVerification as r, cn as s, extractOutputsFromTransitions as t, extractStateMachine as u, formatGuard as v, getAllChecks as w, getBridgeHealth as x, getEffectSummary as y, getSnapshot as z };