@almadar/ui 2.13.3 → 2.15.0

package/dist/lib/api-client.d.ts

@@ -0,0 +1,42 @@
+/**
+ * API Client - HTTP client for backend API calls
+ *
+ * Provides typed methods for making API requests.
+ * All requests go through the backend server, NOT directly to Firestore.
+ *
+ * @packageDocumentation
+ */
+/**
+ * API Error class for handling HTTP errors
+ */
+export declare class ApiError extends Error {
+    status: number;
+    statusText: string;
+    constructor(status: number, statusText: string, message?: string);
+}
+/**
+ * API client with typed methods
+ */
+export declare const apiClient: {
+    /**
+     * GET request
+     */
+    get<T>(endpoint: string): Promise<T>;
+    /**
+     * POST request
+     */
+    post<T>(endpoint: string, data?: unknown): Promise<T>;
+    /**
+     * PUT request
+     */
+    put<T>(endpoint: string, data?: unknown): Promise<T>;
+    /**
+     * PATCH request
+     */
+    patch<T>(endpoint: string, data?: unknown): Promise<T>;
+    /**
+     * DELETE request
+     */
+    delete<T = void>(endpoint: string): Promise<T>;
+};
+export default apiClient;

package/dist/lib/cn.d.ts

@@ -0,0 +1,6 @@
+import { type ClassValue } from 'clsx';
+/**
+ * Utility function to merge Tailwind CSS classes
+ * Combines clsx for conditional classes with tailwind-merge to handle conflicts
+ */
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/lib/debug.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Debug utilities for development
+ */
+export declare function isDebugEnabled(): boolean;
+export declare function debug(...args: unknown[]): void;
+export declare function debugGroup(label: string): void;
+export declare function debugGroupEnd(): void;
+export declare function debugWarn(...args: unknown[]): void;
+export declare function debugError(...args: unknown[]): void;
+export declare function debugTable(data: unknown): void;
+export declare function debugTime(label: string): void;
+export declare function debugTimeEnd(label: string): void;
+/**
+ * Debug input events (keyboard, mouse, touch)
+ * @param inputType - Type of input (e.g., 'keydown', 'keyup', 'mouse')
+ * @param data - Input data to log
+ */
+export declare function debugInput(inputType: string, data: unknown): void;
+/**
+ * Debug collision events between entities
+ * @param entityA - First entity in collision
+ * @param entityB - Second entity in collision
+ * @param details - Additional collision details
+ */
+export declare function debugCollision(entityA: {
+    id?: string;
+    type?: string;
+}, entityB: {
+    id?: string;
+    type?: string;
+}, details?: unknown): void;
+/**
+ * Debug physics updates (position, velocity)
+ * @param entityId - Entity identifier
+ * @param physics - Physics data to log
+ */
+export declare function debugPhysics(entityId: string, physics: unknown): void;
+/**
+ * Debug game state changes
+ * @param stateName - Name of the state that changed
+ * @param value - New state value
+ */
+export declare function debugGameState(stateName: string, value: unknown): void;

package/dist/lib/debugRegistry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Debug Registry - Central event log for debugging
+ *
+ * @packageDocumentation
+ */
+export type DebugEventType = 'state-change' | 'event-fired' | 'effect-executed' | 'guard-evaluated' | 'error' | 'warning' | 'info';
+export interface DebugEvent {
+    id: string;
+    type: DebugEventType;
+    source: string;
+    message: string;
+    data?: Record<string, unknown>;
+    timestamp: number;
+}
+type ChangeListener = () => void;
+export declare function logDebugEvent(type: DebugEventType, source: string, message: string, data?: Record<string, unknown>): void;
+export declare function logStateChange(source: string, from: string, to: string, event?: string): void;
+export declare function logEventFired(source: string, eventName: string, payload?: unknown): void;
+export declare function logEffectExecuted(source: string, effectType: string, details?: unknown): void;
+export declare function logError(source: string, message: string, error?: unknown): void;
+export declare function logWarning(source: string, message: string, data?: Record<string, unknown>): void;
+export declare function logInfo(source: string, message: string, data?: Record<string, unknown>): void;
+export declare function getDebugEvents(): DebugEvent[];
+export declare function getRecentEvents(count: number): DebugEvent[];
+export declare function getEventsByType(type: DebugEventType): DebugEvent[];
+export declare function getEventsBySource(source: string): DebugEvent[];
+export declare function subscribeToDebugEvents(listener: ChangeListener): () => void;
+export declare function clearDebugEvents(): void;
+export {};

package/dist/lib/debugUtils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Debug Utilities - Functions for toggling and checking debug mode
+ *
+ * @packageDocumentation
+ */
+type DebugToggleListener = (enabled: boolean) => void;
+/**
+ * Check if debug mode is enabled
+ */
+export declare function isDebugEnabled(): boolean;
+/**
+ * Enable or disable debug mode
+ */
+export declare function setDebugEnabled(enabled: boolean): void;
+/**
+ * Toggle debug mode
+ */
+export declare function toggleDebug(): boolean;
+/**
+ * Subscribe to debug mode changes
+ */
+export declare function onDebugToggle(listener: DebugToggleListener): () => void;
+/**
+ * Initialize debug mode from keyboard shortcut (Ctrl+Shift+D)
+ */
+export declare function initDebugShortcut(): () => void;
+export {};

package/dist/lib/entityDebug.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Entity Debug - Provides entity state snapshots for debugging
+ *
+ * @packageDocumentation
+ */
+export interface EntityState {
+    id: string;
+    type: string;
+    fields: Record<string, unknown>;
+    lastUpdated: number;
+}
+export interface RuntimeEntity {
+    id: string;
+    type: string;
+    data: Record<string, unknown>;
+}
+export interface PersistentEntityInfo {
+    loaded: boolean;
+    count: number;
+}
+export interface EntitySnapshot {
+    entities: EntityState[];
+    timestamp: number;
+    totalCount: number;
+    /** Singleton entities by name */
+    singletons: Record<string, unknown>;
+    /** Runtime entities (in-memory) */
+    runtime: RuntimeEntity[];
+    /** Persistent entities info by type */
+    persistent: Record<string, PersistentEntityInfo>;
+}
+type EntityProvider = () => EntityState[];
+export declare function setEntityProvider(provider: EntityProvider): void;
+export declare function clearEntityProvider(): void;
+export declare function getEntitySnapshot(): EntitySnapshot | null;
+export declare function getEntityById(id: string): EntityState | undefined;
+export declare function getEntitiesByType(type: string): EntityState[];
+export {};

package/dist/lib/getNestedValue.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Get Nested Value Utility
+ *
+ * Safely retrieves nested values from objects using dot-notation paths.
+ * Used by display components to support relation field access like "company.name".
+ *
+ * @packageDocumentation
+ */
+/**
+ * Get a nested value from an object using dot-notation path.
+ *
+ * @param obj - The object to traverse
+ * @param path - Dot-notation path (e.g., "company.name", "address.city")
+ * @returns The value at the path, or undefined if not found
+ *
+ * @example
+ * const data = { company: { name: "Acme Corp", address: { city: "NYC" } } };
+ * getNestedValue(data, "company.name");         // => "Acme Corp"
+ * getNestedValue(data, "company.address.city"); // => "NYC"
+ * getNestedValue(data, "company.missing");      // => undefined
+ */
+export declare function getNestedValue(obj: Record<string, unknown> | null | undefined, path: string): unknown;
+/**
+ * Format a nested field path as a human-readable label.
+ *
+ * @param path - Dot-notation path (e.g., "company.name")
+ * @returns Formatted label (e.g., "Company Name")
+ *
+ * @example
+ * formatFieldLabel("company.name");    // => "Company Name"
+ * formatFieldLabel("address.zipCode"); // => "Address Zip Code"
+ */
+export declare function formatNestedFieldLabel(path: string): string;

package/dist/lib/guardRegistry.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Guard Registry - Tracks guard evaluations for debugging
+ *
+ * @packageDocumentation
+ */
+export interface GuardContext {
+    traitName?: string;
+    type?: "transition" | "tick";
+    transitionFrom?: string;
+    transitionTo?: string;
+    tickName?: string;
+    [key: string]: unknown;
+}
+export interface GuardEvaluation {
+    id: string;
+    traitName: string;
+    guardName: string;
+    expression: string;
+    result: boolean;
+    context: GuardContext;
+    timestamp: number;
+    /** Input values used in guard evaluation */
+    inputs: Record<string, unknown>;
+}
+type ChangeListener = () => void;
+export declare function recordGuardEvaluation(evaluation: Omit<GuardEvaluation, "id" | "timestamp">): void;
+export declare function getGuardHistory(): GuardEvaluation[];
+export declare function getRecentGuardEvaluations(count: number): GuardEvaluation[];
+export declare function getGuardEvaluationsForTrait(traitName: string): GuardEvaluation[];
+export declare function subscribeToGuardChanges(listener: ChangeListener): () => void;
+export declare function clearGuardHistory(): void;
+export {};

package/dist/lib/index.d.ts

@@ -1,320 +1,18 @@
-export { A as AssetLoadStatus, B as BridgeHealth, C as CheckStatus, a as ContentSegment, D as DEFAULT_CONFIG, b as DomEntityBox, c as DomLayoutData, d as DomOutputsBox, e as DomStateNode, f as DomTransitionLabel, g as DomTransitionPath, E as EffectTrace, h as EntityDefinition, i as EventLogEntry, R as RenderOptions, S as StateDefinition, j as StateMachineDefinition, T as TransitionDefinition, k as TransitionTrace, V as VerificationCheck, l as VerificationSnapshot, m as VerificationSummary, n as VisualizerConfig, o as bindCanvasCapture, p as bindEventBus, q as bindTraitStateGetter, r as clearVerification, s as cn, t as extractOutputsFromTransitions, u as extractStateMachine, v as formatGuard, w as getAllChecks, x as getBridgeHealth, y as getEffectSummary, z as getSnapshot, F as getSummary, G as getTransitions, H as getTransitionsForTrait, I as parseContentSegments, J as parseMarkdownWithCodeBlocks, K as recordTransition, L as registerCheck, M as renderStateMachineToDomData, N as renderStateMachineToSvg, O as subscribeToVerification, P as updateAssetStatus, Q as updateBridgeHealth, U as updateCheck, W as waitForTransition } from '../cn-C_ATNPvi.js';
-import 'clsx';
-
 /**
- * Trait Registry - Tracks active traits and their state machines for debugging
- *
- * @packageDocumentation
- */
-interface TraitTransition {
-    from: string;
-    to: string;
-    event: string;
-    guard?: string;
-}
-interface TraitGuard {
-    name: string;
-    lastResult?: boolean;
-}
-interface TraitDebugInfo {
-    id: string;
-    name: string;
-    currentState: string;
-    states: string[];
-    transitions: TraitTransition[];
-    guards: TraitGuard[];
-    transitionCount: number;
-}
-type ChangeListener$3 = () => 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$3): () => void;
-declare function clearTraits(): void;
-
-/**
- * Tick Registry - Tracks scheduled tick executions for debugging
- *
- * @packageDocumentation
- */
-interface TickExecution {
-    id: string;
-    traitName: string;
-    /** Tick name (display name) */
-    name: string;
-    /** Tick identifier */
-    tickName: string;
-    interval: number;
-    /** Last execution timestamp */
-    lastRun: number;
-    lastExecuted: number | null;
-    nextExecution: number | null;
-    /** Number of times this tick has run */
-    runCount: number;
-    executionCount: number;
-    /** Average execution time in ms */
-    executionTime: number;
-    /** Whether the tick is currently active */
-    active: boolean;
-    isActive: boolean;
-    /** Guard name if this tick has a guard */
-    guardName?: string;
-    /** Whether the guard passed on last evaluation */
-    guardPassed?: boolean;
-}
-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$2): () => void;
-declare function clearTicks(): void;
-
-/**
- * Guard Registry - Tracks guard evaluations for debugging
- *
- * @packageDocumentation
- */
-interface GuardContext {
-    traitName?: string;
-    type?: "transition" | "tick";
-    transitionFrom?: string;
-    transitionTo?: string;
-    tickName?: string;
-    [key: string]: unknown;
-}
-interface GuardEvaluation {
-    id: string;
-    traitName: string;
-    guardName: string;
-    expression: string;
-    result: boolean;
-    context: GuardContext;
-    timestamp: number;
-    /** Input values used in guard evaluation */
-    inputs: Record<string, unknown>;
-}
-type ChangeListener$1 = () => 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$1): () => void;
-declare function clearGuardHistory(): void;
-
-/**
- * Entity Debug - Provides entity state snapshots for debugging
- *
- * @packageDocumentation
- */
-interface EntityState {
-    id: string;
-    type: string;
-    fields: Record<string, unknown>;
-    lastUpdated: number;
-}
-interface RuntimeEntity {
-    id: string;
-    type: string;
-    data: Record<string, unknown>;
-}
-interface PersistentEntityInfo {
-    loaded: boolean;
-    count: number;
-}
-interface EntitySnapshot {
-    entities: EntityState[];
-    timestamp: number;
-    totalCount: number;
-    /** Singleton entities by name */
-    singletons: Record<string, unknown>;
-    /** Runtime entities (in-memory) */
-    runtime: RuntimeEntity[];
-    /** Persistent entities info by type */
-    persistent: Record<string, PersistentEntityInfo>;
-}
-type EntityProvider = () => EntityState[];
-declare function setEntityProvider(provider: EntityProvider): void;
-declare function clearEntityProvider(): void;
-declare function getEntitySnapshot(): EntitySnapshot | null;
-declare function getEntityById(id: string): EntityState | undefined;
-declare function getEntitiesByType(type: string): EntityState[];
-
-/**
- * Debug Registry - Central event log for debugging
- *
- * @packageDocumentation
- */
-type DebugEventType = 'state-change' | 'event-fired' | 'effect-executed' | 'guard-evaluated' | 'error' | 'warning' | 'info';
-interface DebugEvent {
-    id: string;
-    type: DebugEventType;
-    source: string;
-    message: string;
-    data?: Record<string, unknown>;
-    timestamp: number;
-}
-type ChangeListener = () => 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;
-declare function logEffectExecuted(source: string, effectType: string, details?: unknown): void;
-declare function logError(source: string, message: string, error?: unknown): void;
-declare function logWarning(source: string, message: string, data?: Record<string, unknown>): void;
-declare function logInfo(source: string, message: string, data?: Record<string, unknown>): void;
-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): () => void;
-declare function clearDebugEvents(): void;
-
-/**
- * API Client - HTTP client for backend API calls
- *
- * Provides typed methods for making API requests.
- * All requests go through the backend server, NOT directly to Firestore.
- *
- * @packageDocumentation
- */
-/**
- * API Error class for handling HTTP errors
- */
-declare class ApiError extends Error {
-    status: number;
-    statusText: string;
-    constructor(status: number, statusText: string, message?: string);
-}
-/**
- * API client with typed methods
- */
-declare const apiClient: {
-    /**
-     * GET request
-     */
-    get<T>(endpoint: string): Promise<T>;
-    /**
-     * POST request
-     */
-    post<T>(endpoint: string, data?: unknown): Promise<T>;
-    /**
-     * PUT request
-     */
-    put<T>(endpoint: string, data?: unknown): Promise<T>;
-    /**
-     * PATCH request
-     */
-    patch<T>(endpoint: string, data?: unknown): Promise<T>;
-    /**
-     * DELETE request
-     */
-    delete<T = void>(endpoint: string): Promise<T>;
-};
-
-/**
- * Debug utilities for development
- */
-declare function isDebugEnabled(): boolean;
-declare function debug(...args: unknown[]): void;
-declare function debugGroup(label: string): void;
-declare function debugGroupEnd(): void;
-declare function debugWarn(...args: unknown[]): void;
-declare function debugError(...args: unknown[]): void;
-declare function debugTable(data: unknown): void;
-declare function debugTime(label: string): void;
-declare function debugTimeEnd(label: string): void;
-/**
- * Debug input events (keyboard, mouse, touch)
- * @param inputType - Type of input (e.g., 'keydown', 'keyup', 'mouse')
- * @param data - Input data to log
- */
-declare function debugInput(inputType: string, data: unknown): void;
-/**
- * Debug collision events between entities
- * @param entityA - First entity in collision
- * @param entityB - Second entity in collision
- * @param details - Additional collision details
- */
-declare function debugCollision(entityA: {
-    id?: string;
-    type?: string;
-}, entityB: {
-    id?: string;
-    type?: string;
-}, details?: unknown): void;
-/**
- * Debug physics updates (position, velocity)
- * @param entityId - Entity identifier
- * @param physics - Physics data to log
- */
-declare function debugPhysics(entityId: string, physics: unknown): void;
-/**
- * Debug game state changes
- * @param stateName - Name of the state that changed
- * @param value - New state value
- */
-declare function debugGameState(stateName: string, value: unknown): void;
-
-/**
- * Debug Utilities - Functions for toggling and checking debug mode
- *
- * @packageDocumentation
- */
-type DebugToggleListener = (enabled: boolean) => void;
-/**
- * Enable or disable debug mode
- */
-declare function setDebugEnabled(enabled: boolean): void;
-/**
- * Toggle debug mode
- */
-declare function toggleDebug(): boolean;
-/**
- * Subscribe to debug mode changes
- */
-declare function onDebugToggle(listener: DebugToggleListener): () => void;
-/**
- * Initialize debug mode from keyboard shortcut (Ctrl+Shift+D)
- */
-declare function initDebugShortcut(): () => void;
-
-/**
- * Get Nested Value Utility
- *
- * Safely retrieves nested values from objects using dot-notation paths.
- * Used by display components to support relation field access like "company.name".
- *
- * @packageDocumentation
- */
-/**
- * Get a nested value from an object using dot-notation path.
- *
- * @param obj - The object to traverse
- * @param path - Dot-notation path (e.g., "company.name", "address.city")
- * @returns The value at the path, or undefined if not found
- *
- * @example
- * const data = { company: { name: "Acme Corp", address: { city: "NYC" } } };
- * getNestedValue(data, "company.name");         // => "Acme Corp"
- * getNestedValue(data, "company.address.city"); // => "NYC"
- * getNestedValue(data, "company.missing");      // => undefined
- */
-declare function getNestedValue(obj: Record<string, unknown> | null | undefined, path: string): unknown;
-/**
- * Format a nested field path as a human-readable label.
- *
- * @param path - Dot-notation path (e.g., "company.name")
- * @returns Formatted label (e.g., "Company Name")
- *
- * @example
- * formatFieldLabel("company.name");    // => "Company Name"
- * formatFieldLabel("address.zipCode"); // => "Address Zip Code"
- */
-declare function formatNestedFieldLabel(path: string): string;
-
-export { ApiError, type DebugEvent, type DebugEventType, type EntitySnapshot, type EntityState, type GuardContext, type GuardEvaluation, type PersistentEntityInfo, type RuntimeEntity, type TickExecution, type TraitDebugInfo, type TraitGuard, type TraitTransition, apiClient, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, formatNestedFieldLabel, getAllTicks, getAllTraits, getDebugEvents, 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, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState };
+ * Lib - Utility functions and registries
+ *
+ * Core utilities for the Almadar UI library.
+ */
+export { cn } from './cn';
+export * from './api-client';
+export * from './debug';
+export { setDebugEnabled, toggleDebug, onDebugToggle, initDebugShortcut, } from './debugUtils';
+export * from './entityDebug';
+export * from './debugRegistry';
+export * from './guardRegistry';
+export * from './tickRegistry';
+export * from './traitRegistry';
+export * from './verificationRegistry';
+export * from './getNestedValue';
+export * from './visualizer';
+export * from './parseContentSegments';

package/dist/lib/index.js

@@ -1,5 +1,3 @@
-export { DEFAULT_CONFIG, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, extractOutputsFromTransitions, extractStateMachine, formatGuard, getAllTicks, getDebugEvents, getEffectSummary, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getRecentEvents, getRecentGuardEvaluations, getTick, initDebugShortcut, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, onDebugToggle, parseContentSegments, parseMarkdownWithCodeBlocks, recordGuardEvaluation, registerTick, renderStateMachineToDomData, renderStateMachineToSvg, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, toggleDebug, unregisterTick, updateTickExecution } from '../chunk-4ZBSL37D.js';
-export { clearTraits, getAllTraits, getTrait, registerTrait, subscribeToTraitChanges, unregisterTrait, updateGuardResult, updateTraitState } from '../chunk-42YQ6JVR.js';
 export { ApiError, apiClient } from '../chunk-3HJHHULT.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-WCTZ7WZX.js';
+export { DEFAULT_CONFIG, bindCanvasCapture, bindEventBus, bindTraitStateGetter, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, clearVerification, cn, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, extractOutputsFromTransitions, extractStateMachine, formatGuard, formatNestedFieldLabel, getAllChecks, getAllTicks, getAllTraits, getBridgeHealth, getDebugEvents, getEffectSummary, 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, parseContentSegments, parseMarkdownWithCodeBlocks, recordGuardEvaluation, recordTransition, registerCheck, registerTick, registerTrait, renderStateMachineToDomData, renderStateMachineToSvg, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, subscribeToVerification, toggleDebug, unregisterTick, unregisterTrait, updateAssetStatus, updateBridgeHealth, updateCheck, updateGuardResult, updateTickExecution, updateTraitState, waitForTransition } from '../chunk-XL7WB2O5.js';
 import '../chunk-PKBMQBKP.js';

package/dist/lib/jazari/index.d.ts

@@ -0,0 +1,5 @@
+export { computeJazariLayout } from './layout.js';
+export type { LayoutState, LayoutTransition, LayoutInput } from './layout.js';
+export { gearTeethPath, lockIconPath, brainIconPath, pipeIconPath, eightPointedStarPath, arrowheadPath, } from './svg-paths.js';
+export type { JazariLayout, JazariGearLayout, JazariArmLayout, JazariGuardInfo, JazariEffectInfo, } from './types.js';
+export { JAZARI_COLORS } from './types.js';

package/dist/lib/jazari/layout.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Layout algorithm for the Al-Jazari state machine visualization.
+ * Pure TypeScript — zero React/DOM dependencies.
+ *
+ * 1. BFS from initial state to order states by graph distance.
+ * 2. Horizontal distribution of gears along the golden axis.
+ * 3. Transition arm routing: forward arcs above, backward arcs below, self-loops above.
+ * 4. Guard icons at 30% along arm, effect icons at 70%.
+ */
+import type { JazariLayout } from './types.js';
+export interface LayoutState {
+    name: string;
+    isInitial?: boolean;
+    isTerminal?: boolean;
+    isFinal?: boolean;
+}
+export interface LayoutTransition {
+    from: string;
+    to: string;
+    event: string;
+    guard?: unknown;
+    effects?: unknown[];
+}
+export interface LayoutInput {
+    states: LayoutState[];
+    transitions: LayoutTransition[];
+    entityFields?: string[];
+    direction?: 'ltr' | 'rtl';
+}
+export declare function computeJazariLayout(input: LayoutInput): JazariLayout;