@almadar/ui 2.10.0 → 2.11.1

package/dist/{chunk-N6DJVKZ6.js → chunk-3E73CE7J.js}

@@ -744,4 +744,263 @@ function parseContentSegments(content) {
   return segments;
 }
 
-export { DEFAULT_CONFIG, extractOutputsFromTransitions, extractStateMachine, formatGuard, getEffectSummary, parseContentSegments, parseMarkdownWithCodeBlocks, renderStateMachineToDomData, renderStateMachineToSvg };
+// lib/traitRegistry.ts
+var traits = /* @__PURE__ */ new Map();
+var listeners = /* @__PURE__ */ new Set();
+function notifyListeners() {
+  listeners.forEach((listener) => listener());
+}
+function registerTrait(info) {
+  traits.set(info.id, info);
+  notifyListeners();
+}
+function updateTraitState(id, newState) {
+  const trait = traits.get(id);
+  if (trait) {
+    trait.currentState = newState;
+    trait.transitionCount++;
+    notifyListeners();
+  }
+}
+function updateGuardResult(traitId, guardName, result) {
+  const trait = traits.get(traitId);
+  if (trait) {
+    const guard = trait.guards.find((g) => g.name === guardName);
+    if (guard) {
+      guard.lastResult = result;
+      notifyListeners();
+    }
+  }
+}
+function unregisterTrait(id) {
+  traits.delete(id);
+  notifyListeners();
+}
+function getAllTraits() {
+  return Array.from(traits.values());
+}
+function getTrait(id) {
+  return traits.get(id);
+}
+function subscribeToTraitChanges(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+function clearTraits() {
+  traits.clear();
+  notifyListeners();
+}
+
+// lib/tickRegistry.ts
+var ticks = /* @__PURE__ */ new Map();
+var listeners2 = /* @__PURE__ */ new Set();
+function notifyListeners2() {
+  listeners2.forEach((listener) => listener());
+}
+function registerTick(tick) {
+  ticks.set(tick.id, tick);
+  notifyListeners2();
+}
+function updateTickExecution(id, timestamp) {
+  const tick = ticks.get(id);
+  if (tick) {
+    tick.lastExecuted = timestamp;
+    tick.nextExecution = timestamp + tick.interval;
+    tick.executionCount++;
+    notifyListeners2();
+  }
+}
+function setTickActive(id, isActive) {
+  const tick = ticks.get(id);
+  if (tick) {
+    tick.isActive = isActive;
+    notifyListeners2();
+  }
+}
+function unregisterTick(id) {
+  ticks.delete(id);
+  notifyListeners2();
+}
+function getAllTicks() {
+  return Array.from(ticks.values());
+}
+function getTick(id) {
+  return ticks.get(id);
+}
+function subscribeToTickChanges(listener) {
+  listeners2.add(listener);
+  return () => listeners2.delete(listener);
+}
+function clearTicks() {
+  ticks.clear();
+  notifyListeners2();
+}
+
+// lib/guardRegistry.ts
+var guardHistory = [];
+var listeners3 = /* @__PURE__ */ new Set();
+var MAX_HISTORY = 100;
+function notifyListeners3() {
+  listeners3.forEach((listener) => listener());
+}
+function recordGuardEvaluation(evaluation) {
+  const entry = {
+    ...evaluation,
+    id: `guard-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,
+    timestamp: Date.now()
+  };
+  guardHistory.unshift(entry);
+  if (guardHistory.length > MAX_HISTORY) {
+    guardHistory.pop();
+  }
+  notifyListeners3();
+}
+function getGuardHistory() {
+  return [...guardHistory];
+}
+function getRecentGuardEvaluations(count) {
+  return guardHistory.slice(0, count);
+}
+function getGuardEvaluationsForTrait(traitName) {
+  return guardHistory.filter((g) => g.traitName === traitName);
+}
+function subscribeToGuardChanges(listener) {
+  listeners3.add(listener);
+  return () => listeners3.delete(listener);
+}
+function clearGuardHistory() {
+  guardHistory.length = 0;
+  notifyListeners3();
+}
+
+// lib/entityDebug.ts
+var entityProvider = null;
+function setEntityProvider(provider) {
+  entityProvider = provider;
+}
+function clearEntityProvider() {
+  entityProvider = null;
+}
+function getEntitySnapshot() {
+  if (!entityProvider) {
+    return null;
+  }
+  const entities = entityProvider();
+  return {
+    entities,
+    timestamp: Date.now(),
+    totalCount: entities.length,
+    singletons: {},
+    runtime: entities.map((e) => ({ id: e.id, type: e.type, data: e.fields })),
+    persistent: {}
+  };
+}
+function getEntityById(id) {
+  if (!entityProvider) {
+    return void 0;
+  }
+  return entityProvider().find((e) => e.id === id);
+}
+function getEntitiesByType(type) {
+  if (!entityProvider) {
+    return [];
+  }
+  return entityProvider().filter((e) => e.type === type);
+}
+
+// lib/debugRegistry.ts
+var events = [];
+var listeners4 = /* @__PURE__ */ new Set();
+var MAX_EVENTS = 500;
+function notifyListeners4() {
+  listeners4.forEach((listener) => listener());
+}
+function logDebugEvent(type, source, message, data) {
+  const event = {
+    id: `event-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,
+    type,
+    source,
+    message,
+    data,
+    timestamp: Date.now()
+  };
+  events.unshift(event);
+  if (events.length > MAX_EVENTS) {
+    events.pop();
+  }
+  notifyListeners4();
+}
+function logStateChange(source, from, to, event) {
+  logDebugEvent("state-change", source, `${from} \u2192 ${to}`, { from, to, event });
+}
+function logEventFired(source, eventName, payload) {
+  logDebugEvent("event-fired", source, eventName, { eventName, payload });
+}
+function logEffectExecuted(source, effectType, details) {
+  logDebugEvent("effect-executed", source, effectType, { effectType, details });
+}
+function logError(source, message, error) {
+  logDebugEvent("error", source, message, { error });
+}
+function logWarning(source, message, data) {
+  logDebugEvent("warning", source, message, data);
+}
+function logInfo(source, message, data) {
+  logDebugEvent("info", source, message, data);
+}
+function getDebugEvents() {
+  return [...events];
+}
+function getRecentEvents(count) {
+  return events.slice(0, count);
+}
+function getEventsByType(type) {
+  return events.filter((e) => e.type === type);
+}
+function getEventsBySource(source) {
+  return events.filter((e) => e.source === source);
+}
+function subscribeToDebugEvents(listener) {
+  listeners4.add(listener);
+  return () => listeners4.delete(listener);
+}
+function clearDebugEvents() {
+  events.length = 0;
+  notifyListeners4();
+}
+
+// lib/debugUtils.ts
+var DEBUG_STORAGE_KEY = "orbital-debug";
+var listeners5 = /* @__PURE__ */ new Set();
+function isDebugEnabled() {
+  if (typeof window === "undefined") return false;
+  return localStorage.getItem(DEBUG_STORAGE_KEY) === "true";
+}
+function setDebugEnabled(enabled) {
+  if (typeof window === "undefined") return;
+  localStorage.setItem(DEBUG_STORAGE_KEY, String(enabled));
+  listeners5.forEach((listener) => listener(enabled));
+}
+function toggleDebug() {
+  const newValue = !isDebugEnabled();
+  setDebugEnabled(newValue);
+  return newValue;
+}
+function onDebugToggle(listener) {
+  listeners5.add(listener);
+  return () => listeners5.delete(listener);
+}
+function initDebugShortcut() {
+  if (typeof window === "undefined") return () => {
+  };
+  const handleKeyDown = (e) => {
+    if (e.ctrlKey && e.shiftKey && e.key === "D") {
+      e.preventDefault();
+      toggleDebug();
+    }
+  };
+  window.addEventListener("keydown", handleKeyDown);
+  return () => window.removeEventListener("keydown", handleKeyDown);
+}
+
+export { DEFAULT_CONFIG, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, extractOutputsFromTransitions, extractStateMachine, formatGuard, getAllTicks, getAllTraits, getDebugEvents, getEffectSummary, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, initDebugShortcut, isDebugEnabled, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, parseContentSegments, parseMarkdownWithCodeBlocks, recordGuardEvaluation, registerTick, registerTrait, renderStateMachineToDomData, renderStateMachineToSvg, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };

package/dist/{chunk-KPOLHTPA.js → chunk-HQZV4PYL.js}

@@ -1,8 +1,8 @@
-import { SuspenseConfigProvider } from './chunk-7M2KEJTF.js';
+import { SuspenseConfigProvider } from './chunk-QAFNBUDT.js';
 import { ThemeProvider } from './chunk-DKQN5FVU.js';
 import { SelectionProvider, EntityDataProvider } from './chunk-WGJIL4YR.js';
 import { useEventBus, EventBusProvider } from './chunk-YXZM3WCF.js';
-import { recordTransition, registerCheck, bindEventBus, bindTraitStateGetter } from './chunk-6D5QMEUS.js';
+import { recordTransition, registerCheck, bindEventBus, bindTraitStateGetter } from './chunk-WCTZ7WZX.js';
 import { useOfflineExecutor } from './chunk-K2D5D3WK.js';
 import { createContext, useState, useCallback, useMemo, useContext, useRef, useEffect } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';

package/dist/{chunk-7M2KEJTF.js → chunk-QAFNBUDT.js}

@@ -1,7 +1,7 @@
 import { useTheme, useUISlots } from './chunk-DKQN5FVU.js';
 import { useTranslate, useInfiniteScroll, useQuerySingleton, useLongPress, useSwipeGesture, useDragReorder, usePullToRefresh } from './chunk-WGJIL4YR.js';
 import { useEventBus } from './chunk-YXZM3WCF.js';
-import { cn, debugGroup, debug, debugGroupEnd, updateAssetStatus, bindCanvasCapture, getNestedValue, isDebugEnabled } from './chunk-6D5QMEUS.js';
+import { cn, debugGroup, debug, debugGroupEnd, updateAssetStatus, bindCanvasCapture, getNestedValue, isDebugEnabled } from './chunk-WCTZ7WZX.js';
 import { isPortalSlot } from './chunk-K2D5D3WK.js';
 import { __publicField } from './chunk-PKBMQBKP.js';
 import * as LucideIcons from 'lucide-react';

package/dist/{chunk-6D5QMEUS.js → chunk-WCTZ7WZX.js}

@@ -229,7 +229,8 @@ function bindEventBus(eventBus) {
   exposeOnWindow();
   if (window.__orbitalVerification) {
     window.__orbitalVerification.sendEvent = (event, payload) => {
-      eventBus.emit(event, payload);
+      const prefixed = event.startsWith("UI:") ? event : `UI:${event}`;
+      eventBus.emit(prefixed, payload);
     };
     const eventLog = [];
     window.__orbitalVerification.eventLog = eventLog;

package/dist/cn-C_ATNPvi.d.ts

@@ -0,0 +1,332 @@
+import { ClassValue } from 'clsx';
+
+/**
+ * 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;
+
+/**
+ * Content Segment Parsing Utilities
+ *
+ * Parses rich content with code blocks and quiz tags into structured
+ * segments for rendering. Detects orbital schemas in JSON code blocks
+ * and marks them for JazariStateMachine rendering.
+ */
+/** Segment types for content rendering */
+type ContentSegment = {
+    type: 'markdown';
+    content: string;
+} | {
+    type: 'code';
+    language: string;
+    content: string;
+} | {
+    type: 'orbital';
+    language: string;
+    content: string;
+    schema: unknown;
+} | {
+    type: 'quiz';
+    question: string;
+    answer: string;
+};
+/**
+ * Parse markdown content to extract code blocks.
+ *
+ * Splits markdown into segments of plain markdown and fenced code blocks.
+ * JSON/orb code blocks containing orbital schemas are tagged as 'orbital'.
+ */
+declare function parseMarkdownWithCodeBlocks(content: string | undefined | null): ContentSegment[];
+/**
+ * Parse content to extract all segments including quiz tags and code blocks.
+ *
+ * Supported tags:
+ * - <question>q</question><answer>a</answer> — Quiz Q&A
+ *
+ * Also handles fenced code blocks (```language...```) with orbital detection.
+ */
+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 };