@almadar/ui 1.0.30 → 1.0.32

package/dist/lib/index.d.ts

@@ -1,4 +1,4 @@
-export { c as cn } from '../cn-mqkxz8Sd.js';
+export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TransitionDefinition, V as VisualizerConfig, h as cn, i as extractOutputsFromTransitions, j as extractStateMachine, k as formatGuard, l as getEffectSummary, p as parseContentSegments, m as parseMarkdownWithCodeBlocks, r as renderStateMachineToDomData, n as renderStateMachineToSvg } from '../cn-BoBXsxuX.js';
 import 'clsx';
 
 /**
@@ -162,7 +162,7 @@ interface DebugEvent {
     data?: Record<string, unknown>;
     timestamp: number;
 }
-type ChangeListener$3 = () => void;
+type ChangeListener$4 = () => void;
 declare function logDebugEvent(type: DebugEventType, source: string, message: string, data?: Record<string, unknown>): void;
 declare function logStateChange(source: string, from: string, to: string, event?: string): void;
 declare function logEventFired(source: string, eventName: string, payload?: unknown): void;
@@ -174,7 +174,7 @@ declare function getDebugEvents(): DebugEvent[];
 declare function getRecentEvents(count: number): DebugEvent[];
 declare function getEventsByType(type: DebugEventType): DebugEvent[];
 declare function getEventsBySource(source: string): DebugEvent[];
-declare function subscribeToDebugEvents(listener: ChangeListener$3): () => void;
+declare function subscribeToDebugEvents(listener: ChangeListener$4): () => void;
 declare function clearDebugEvents(): void;
 
 /**
@@ -201,12 +201,12 @@ interface GuardEvaluation {
     /** Input values used in guard evaluation */
     inputs: Record<string, unknown>;
 }
-type ChangeListener$2 = () => void;
+type ChangeListener$3 = () => void;
 declare function recordGuardEvaluation(evaluation: Omit<GuardEvaluation, "id" | "timestamp">): void;
 declare function getGuardHistory(): GuardEvaluation[];
 declare function getRecentGuardEvaluations(count: number): GuardEvaluation[];
 declare function getGuardEvaluationsForTrait(traitName: string): GuardEvaluation[];
-declare function subscribeToGuardChanges(listener: ChangeListener$2): () => void;
+declare function subscribeToGuardChanges(listener: ChangeListener$3): () => void;
 declare function clearGuardHistory(): void;
 
 /**
@@ -239,14 +239,14 @@ interface TickExecution {
     /** Whether the guard passed on last evaluation */
     guardPassed?: boolean;
 }
-type ChangeListener$1 = () => void;
+type ChangeListener$2 = () => void;
 declare function registerTick(tick: TickExecution): void;
 declare function updateTickExecution(id: string, timestamp: number): void;
 declare function setTickActive(id: string, isActive: boolean): void;
 declare function unregisterTick(id: string): void;
 declare function getAllTicks(): TickExecution[];
 declare function getTick(id: string): TickExecution | undefined;
-declare function subscribeToTickChanges(listener: ChangeListener$1): () => void;
+declare function subscribeToTickChanges(listener: ChangeListener$2): () => void;
 declare function clearTicks(): void;
 
 /**
@@ -273,16 +273,123 @@ interface TraitDebugInfo {
     guards: TraitGuard[];
     transitionCount: number;
 }
-type ChangeListener = () => void;
+type ChangeListener$1 = () => void;
 declare function registerTrait(info: TraitDebugInfo): void;
 declare function updateTraitState(id: string, newState: string): void;
 declare function updateGuardResult(traitId: string, guardName: string, result: boolean): void;
 declare function unregisterTrait(id: string): void;
 declare function getAllTraits(): TraitDebugInfo[];
 declare function getTrait(id: string): TraitDebugInfo | undefined;
-declare function subscribeToTraitChanges(listener: ChangeListener): () => void;
+declare function subscribeToTraitChanges(listener: ChangeListener$1): () => void;
 declare function clearTraits(): void;
 
+/**
+ * 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;
+/** 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;
+}
+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.
+ * Call this during app initialization.
+ */
+declare function bindEventBus(eventBus: {
+    emit: (type: string, payload?: Record<string, unknown>) => void;
+}): void;
+/**
+ * Bind a trait state getter so automation can query current states.
+ */
+declare function bindTraitStateGetter(getter: (traitName: string) => string | undefined): void;
+declare function clearVerification(): void;
+
 /**
  * Get Nested Value Utility
  *
@@ -317,147 +424,4 @@ declare function getNestedValue(obj: Record<string, unknown> | null | undefined,
  */
 declare function formatNestedFieldLabel(path: string): string;
 
-/**
- * Orbital State Machine Visualizer
- *
- * Renders SVG diagrams from Orbital schemas and Trait definitions.
- * Can be used in documentation, IDE previews, and other tools.
- */
-interface VisualizerConfig {
-    nodeRadius: number;
-    nodeSpacing: number;
-    initialIndicatorOffset: number;
-    arrowSize: number;
-    colors: {
-        background: string;
-        node: string;
-        nodeBorder: string;
-        nodeText: string;
-        initialNode: string;
-        finalNode: string;
-        arrow: string;
-        arrowText: string;
-        effectText: string;
-        guardText: string;
-        initial: string;
-    };
-    fonts: {
-        node: string;
-        event: string;
-        effect: string;
-    };
-}
-interface StateDefinition {
-    name: string;
-    isInitial?: boolean;
-    isFinal?: boolean;
-    description?: string;
-}
-interface TransitionDefinition {
-    from: string;
-    to: string;
-    event: string;
-    guard?: unknown;
-    effects?: unknown[];
-}
-interface StateMachineDefinition {
-    states: StateDefinition[];
-    transitions: TransitionDefinition[];
-}
-interface EntityDefinition {
-    name: string;
-    fields?: (string | {
-        name: string;
-    })[];
-}
-interface RenderOptions {
-    title?: string;
-    entity?: EntityDefinition;
-}
-/** Position data for a state node in DOM layout */
-interface DomStateNode {
-    id: string;
-    name: string;
-    x: number;
-    y: number;
-    radius: number;
-    isInitial: boolean;
-    isFinal: boolean;
-    description?: string;
-}
-/** Position data for a transition arrow */
-interface DomTransitionPath {
-    id: string;
-    from: string;
-    to: string;
-    /** SVG path data for the curved arrow */
-    pathData: string;
-    /** Midpoint for label positioning */
-    labelX: number;
-    labelY: number;
-}
-/** Position data for a transition label with guard/effect details */
-interface DomTransitionLabel {
-    id: string;
-    from: string;
-    to: string;
-    event: string;
-    x: number;
-    y: number;
-    /** Human-readable guard text (e.g., "if amount > 100") */
-    guardText?: string;
-    /** Human-readable effect texts */
-    effectTexts: string[];
-    /** Whether this transition has details to show in tooltip */
-    hasDetails: boolean;
-}
-/** Entity input box data */
-interface DomEntityBox {
-    name: string;
-    fields: string[];
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-/** Output effects box data */
-interface DomOutputsBox {
-    outputs: string[];
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-/** Complete DOM layout data for rendering */
-interface DomLayoutData {
-    width: number;
-    height: number;
-    title?: string;
-    states: DomStateNode[];
-    paths: DomTransitionPath[];
-    labels: DomTransitionLabel[];
-    entity?: DomEntityBox;
-    outputs?: DomOutputsBox;
-    config: VisualizerConfig;
-}
-declare const DEFAULT_CONFIG: VisualizerConfig;
-declare function formatGuard(guard: unknown): string;
-declare function getEffectSummary(effects: unknown[]): string;
-declare function extractOutputsFromTransitions(transitions: TransitionDefinition[]): string[];
-/**
- * Render a state machine to an SVG string.
- * Works in both browser and Node.js environments.
- */
-declare function renderStateMachineToSvg(stateMachine: StateMachineDefinition, options?: RenderOptions, config?: VisualizerConfig): string;
-/**
- * Extract state machine from various data formats (Trait, Orbital, or raw)
- */
-declare function extractStateMachine(data: unknown): StateMachineDefinition | null;
-/**
- * Render a state machine to DOM layout data.
- * This is used by the DOM-based visualizer component for hybrid SVG/DOM rendering.
- * Unlike renderStateMachineToSvg, this returns structured data instead of an SVG string.
- */
-declare function renderStateMachineToDomData(stateMachine: StateMachineDefinition, options?: RenderOptions, config?: VisualizerConfig): DomLayoutData;
-
-export { ApiError, DEFAULT_CONFIG, type DebugEvent, type DebugEventType, type DomEntityBox, type DomLayoutData, type DomOutputsBox, type DomStateNode, type DomTransitionLabel, type DomTransitionPath, type EntityDefinition, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, type PersistentEntityInfo, type RenderOptions, type RuntimeEntity, type StateDefinition, type StateMachineDefinition, type TickExecution, type TraitDebugInfo, type TraitGuard, type TraitTransition, type TransitionDefinition, type VisualizerConfig, apiClient, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, extractOutputsFromTransitions, extractStateMachine, formatGuard, formatNestedFieldLabel, getAllTicks, getAllTraits, getDebugEvents, getEffectSummary, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, initDebugShortcut, isDebugEnabled, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, recordGuardEvaluation, registerTick, registerTrait, renderStateMachineToDomData, renderStateMachineToSvg, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };
+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 };