@almadar/ui 2.6.0 → 2.8.1

package/dist/lib/index.d.ts

@@ -353,6 +353,14 @@ 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;
@@ -366,6 +374,14 @@ interface OrbitalVerificationAPI {
     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 {
@@ -378,16 +394,31 @@ declare global {
  */
 declare function waitForTransition(event: string, timeoutMs?: number): Promise<TransitionTrace | null>;
 /**
- * Bind the EventBus so automation can send events.
+ * 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;
 
 /**
@@ -424,4 +455,4 @@ declare function getNestedValue(obj: Record<string, unknown> | null | undefined,
  */
 declare function formatNestedFieldLabel(path: string): string;
 
-export { ApiError, type BridgeHealth, type CheckStatus, type DebugEvent, type DebugEventType, type EffectTrace, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, type PersistentEntityInfo, type RuntimeEntity, type TickExecution, type TraitDebugInfo, type TraitGuard, type TraitTransition, type TransitionTrace, type VerificationCheck, type VerificationSnapshot, type VerificationSummary, apiClient, bindEventBus, bindTraitStateGetter, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, clearVerification, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, formatNestedFieldLabel, getAllChecks, getAllTicks, getAllTraits, getBridgeHealth, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getSnapshot, getSummary, getTick, getTrait, getTransitions, getTransitionsForTrait, initDebugShortcut, isDebugEnabled, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, recordGuardEvaluation, recordTransition, registerCheck, registerTick, registerTrait, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, subscribeToVerification, toggleDebug, unregisterTick, unregisterTrait, updateBridgeHealth, updateCheck, updateGuardResult, updateTickExecution, updateTraitState, waitForTransition };
+export { ApiError, type AssetLoadStatus, type BridgeHealth, type CheckStatus, type DebugEvent, type DebugEventType, type EffectTrace, type EntitySnapshot, type EntityState, type EventLogEntry, type GuardContext, type GuardEvaluation, type PersistentEntityInfo, type RuntimeEntity, type TickExecution, type TraitDebugInfo, type TraitGuard, type TraitTransition, type TransitionTrace, type VerificationCheck, type VerificationSnapshot, type VerificationSummary, apiClient, bindCanvasCapture, bindEventBus, bindTraitStateGetter, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, clearVerification, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, formatNestedFieldLabel, getAllChecks, getAllTicks, getAllTraits, getBridgeHealth, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getSnapshot, getSummary, getTick, getTrait, getTransitions, getTransitionsForTrait, initDebugShortcut, isDebugEnabled, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, recordGuardEvaluation, recordTransition, registerCheck, registerTick, registerTrait, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, subscribeToVerification, toggleDebug, unregisterTick, unregisterTrait, updateAssetStatus, updateBridgeHealth, updateCheck, updateGuardResult, updateTickExecution, updateTraitState, waitForTransition };

package/dist/lib/index.js

@@ -1,7 +1,6 @@
 export { DEFAULT_CONFIG, extractOutputsFromTransitions, extractStateMachine, formatGuard, getEffectSummary, parseContentSegments, parseMarkdownWithCodeBlocks, renderStateMachineToDomData, renderStateMachineToSvg } from '../chunk-N6DJVKZ6.js';
 export { ApiError, apiClient } from '../chunk-3HJHHULT.js';
-export { bindEventBus, bindTraitStateGetter, clearVerification, getAllChecks, getBridgeHealth, getSnapshot, getSummary, getTransitions, getTransitionsForTrait, recordTransition, registerCheck, subscribeToVerification, updateBridgeHealth, updateCheck, waitForTransition } from '../chunk-45CTDYBT.js';
-export { cn, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, formatNestedFieldLabel, getNestedValue, isDebugEnabled } from '../chunk-KKCVDUK7.js';
+export { bindCanvasCapture, bindEventBus, bindTraitStateGetter, clearVerification, cn, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, formatNestedFieldLabel, getAllChecks, getBridgeHealth, getNestedValue, getSnapshot, getSummary, getTransitions, getTransitionsForTrait, isDebugEnabled, recordTransition, registerCheck, subscribeToVerification, updateAssetStatus, updateBridgeHealth, updateCheck, waitForTransition } from '../chunk-A5J5CNCU.js';
 import '../chunk-PKBMQBKP.js';
 
 // lib/debugUtils.ts

package/dist/providers/index.js

@@ -1,12 +1,11 @@
-import { SuspenseConfigProvider } from '../chunk-LEWQP2UP.js';
+import { SuspenseConfigProvider } from '../chunk-NES4SBB7.js';
 import { ThemeProvider } from '../chunk-DKQN5FVU.js';
 import { SelectionProvider, EntityDataProvider } from '../chunk-WGJIL4YR.js';
 export { SelectionContext, SelectionProvider, useSelection, useSelectionOptional } from '../chunk-WGJIL4YR.js';
 import { useEventBus, EventBusProvider } from '../chunk-YXZM3WCF.js';
 export { EventBusContext, EventBusProvider } from '../chunk-YXZM3WCF.js';
 import '../chunk-3JGAROCW.js';
-import { recordTransition, registerCheck, bindEventBus, bindTraitStateGetter } from '../chunk-45CTDYBT.js';
-import '../chunk-KKCVDUK7.js';
+import { recordTransition, registerCheck, bindEventBus, bindTraitStateGetter } from '../chunk-A5J5CNCU.js';
 import '../chunk-TSETXL2E.js';
 import { useOfflineExecutor } from '../chunk-K2D5D3WK.js';
 import '../chunk-PKBMQBKP.js';

package/package.json

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

package/dist/chunk-KKCVDUK7.js

@@ -1,104 +0,0 @@
-import { clsx } from 'clsx';
-import { twMerge } from 'tailwind-merge';
-
-// lib/cn.ts
-function cn(...inputs) {
-  return twMerge(clsx(inputs));
-}
-
-// lib/debug.ts
-var DEBUG_ENABLED = typeof window !== "undefined" && (localStorage.getItem("debug") === "true" || process.env.NODE_ENV === "development");
-function isDebugEnabled() {
-  return DEBUG_ENABLED;
-}
-function debug(...args) {
-  if (DEBUG_ENABLED) {
-    console.log("[DEBUG]", ...args);
-  }
-}
-function debugGroup(label) {
-  if (DEBUG_ENABLED) {
-    console.group(`[DEBUG] ${label}`);
-  }
-}
-function debugGroupEnd() {
-  if (DEBUG_ENABLED) {
-    console.groupEnd();
-  }
-}
-function debugWarn(...args) {
-  if (DEBUG_ENABLED) {
-    console.warn("[DEBUG]", ...args);
-  }
-}
-function debugError(...args) {
-  if (DEBUG_ENABLED) {
-    console.error("[DEBUG]", ...args);
-  }
-}
-function debugTable(data) {
-  if (DEBUG_ENABLED) {
-    console.table(data);
-  }
-}
-function debugTime(label) {
-  if (DEBUG_ENABLED) {
-    console.time(`[DEBUG] ${label}`);
-  }
-}
-function debugTimeEnd(label) {
-  if (DEBUG_ENABLED) {
-    console.timeEnd(`[DEBUG] ${label}`);
-  }
-}
-function debugInput(inputType, data) {
-  if (DEBUG_ENABLED) {
-    console.log(`[DEBUG:INPUT] ${inputType}:`, data);
-  }
-}
-function debugCollision(entityA, entityB, details) {
-  if (DEBUG_ENABLED) {
-    console.log(
-      `[DEBUG:COLLISION] ${entityA.type || entityA.id} <-> ${entityB.type || entityB.id}`,
-      details ?? ""
-    );
-  }
-}
-function debugPhysics(entityId, physics) {
-  if (DEBUG_ENABLED) {
-    console.log(`[DEBUG:PHYSICS] ${entityId}:`, physics);
-  }
-}
-function debugGameState(stateName, value) {
-  if (DEBUG_ENABLED) {
-    console.log(`[DEBUG:GAME_STATE] ${stateName}:`, value);
-  }
-}
-
-// lib/getNestedValue.ts
-function getNestedValue(obj, path) {
-  if (obj === null || obj === void 0) {
-    return void 0;
-  }
-  if (!path.includes(".")) {
-    return obj[path];
-  }
-  const parts = path.split(".");
-  let value = obj;
-  for (const part of parts) {
-    if (value === null || value === void 0) {
-      return void 0;
-    }
-    if (typeof value !== "object") {
-      return void 0;
-    }
-    value = value[part];
-  }
-  return value;
-}
-function formatNestedFieldLabel(path) {
-  const lastPart = path.includes(".") ? path.split(".").pop() : path;
-  return lastPart.replace(/([A-Z])/g, " $1").replace(/^./, (str) => str.toUpperCase()).replace(/Id$/, "").trim();
-}
-
-export { cn, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, formatNestedFieldLabel, getNestedValue, isDebugEnabled };