@almadar/ui 2.5.2 → 2.7.0

package/dist/hooks/index.d.ts

@@ -2,7 +2,7 @@ import { OrbitalSchema } from '@almadar/core';
 import { E as EventBusContextType, a as EventListener } from '../event-bus-types-CjJduURa.js';
 export { K as KFlowEvent, U as Unsubscribe } from '../event-bus-types-CjJduURa.js';
 export { D as DEFAULT_SLOTS, R as RenderUIConfig, b as SlotAnimation, c as SlotChangeCallback, S as SlotContent, a as UISlot, U as UISlotManager, u as useUISlotManager } from '../useUISlots-BBjNvQtb.js';
-import * as React from 'react';
+import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { Entity, getEntity, getByType, getAllEntities, getSingleton, spawnEntity, updateEntity, updateSingleton, removeEntity, clearEntities } from '../stores/index.js';
@@ -953,7 +953,7 @@ interface I18nContextValue {
  * </I18nProvider>
  * ```
  */
-declare const I18nProvider: React.Provider<I18nContextValue>;
+declare const I18nProvider: React$1.Provider<I18nContextValue>;
 /**
  * Hook to access the current locale and translate function.
  * Safe to call without a provider — returns passthrough t().
@@ -1029,6 +1029,136 @@ interface AuthContextValue {
  */
 declare function useAuthContext(): AuthContextValue;
 
+interface SwipeGestureOptions {
+    /** Minimum distance in px to trigger a swipe (default: 50) */
+    threshold?: number;
+    /** Minimum velocity in px/ms to qualify (default: 0.3) */
+    velocityThreshold?: number;
+    /** Prevent default touch behavior during swipe (default: false) */
+    preventDefault?: boolean;
+}
+interface SwipeGestureResult {
+    onSwipeLeft?: () => void;
+    onSwipeRight?: () => void;
+    onSwipeUp?: () => void;
+    onSwipeDown?: () => void;
+}
+interface SwipeHandlers {
+    onPointerDown: (e: React__default.PointerEvent) => void;
+    onPointerMove: (e: React__default.PointerEvent) => void;
+    onPointerUp: (e: React__default.PointerEvent) => void;
+    onPointerCancel: (e: React__default.PointerEvent) => void;
+    /** Current horizontal offset during swipe (for animation) */
+    offsetX: number;
+    /** Whether a swipe gesture is in progress */
+    isSwiping: boolean;
+}
+
+declare function useSwipeGesture(callbacks: SwipeGestureResult, options?: SwipeGestureOptions): SwipeHandlers;
+
+interface LongPressOptions {
+    /** Hold duration in ms before triggering (default: 500) */
+    duration?: number;
+    /** Movement tolerance in px before canceling (default: 10) */
+    moveThreshold?: number;
+}
+interface LongPressHandlers {
+    onPointerDown: (e: React__default.PointerEvent) => void;
+    onPointerMove: (e: React__default.PointerEvent) => void;
+    onPointerUp: () => void;
+    onPointerCancel: () => void;
+    /** Whether the long press is currently active (held down, timer running) */
+    isPressed: boolean;
+}
+declare function useLongPress(onLongPress: () => void, options?: LongPressOptions): LongPressHandlers;
+
+interface DragReorderResult<T> {
+    /** The reordered items array */
+    items: T[];
+    /** Index of the item currently being dragged (-1 if not dragging) */
+    dragIndex: number;
+    /** Index of the drop target (-1 if not over any target) */
+    dragOverIndex: number;
+    /** Whether a drag is in progress */
+    isDragging: boolean;
+    /** Props to spread on the drag handle element for a given index */
+    getDragHandleProps: (index: number) => {
+        onPointerDown: (e: React__default.PointerEvent) => void;
+        style: React__default.CSSProperties;
+        'aria-grabbed': boolean;
+        role: string;
+    };
+    /** Props to spread on each list item for a given index */
+    getItemProps: (index: number) => {
+        onPointerMove: (e: React__default.PointerEvent) => void;
+        onPointerUp: () => void;
+        'aria-dropeffect': string;
+        style: React__default.CSSProperties;
+    };
+}
+declare function useDragReorder<T>(initialItems: T[], onReorder: (fromIndex: number, toIndex: number, item: T) => void): DragReorderResult<T>;
+
+interface InfiniteScrollOptions {
+    /** Root margin for IntersectionObserver (default: "200px") */
+    rootMargin?: string;
+    /** Whether more items are available to load */
+    hasMore?: boolean;
+    /** Whether a load is currently in progress */
+    isLoading?: boolean;
+}
+interface InfiniteScrollResult {
+    /** Ref to attach to the sentinel element */
+    sentinelRef: React.RefCallback<HTMLElement>;
+}
+declare function useInfiniteScroll(onLoadMore: () => void, options?: InfiniteScrollOptions): InfiniteScrollResult;
+
+interface PullToRefreshOptions {
+    /** Distance in px to pull before triggering refresh (default: 60) */
+    threshold?: number;
+    /** Maximum pull distance in px (default: 120) */
+    maxPull?: number;
+}
+interface PullToRefreshResult {
+    /** Current pull distance in px */
+    pullDistance: number;
+    /** Whether the user is actively pulling */
+    isPulling: boolean;
+    /** Whether a refresh was triggered and is in progress */
+    isRefreshing: boolean;
+    /** Props to spread on the scrollable container */
+    containerProps: {
+        onTouchStart: (e: React__default.TouchEvent) => void;
+        onTouchMove: (e: React__default.TouchEvent) => void;
+        onTouchEnd: () => void;
+        style: React__default.CSSProperties;
+    };
+    /** Call this when the refresh operation completes */
+    endRefresh: () => void;
+}
+declare function usePullToRefresh(onRefresh: () => void, options?: PullToRefreshOptions): PullToRefreshResult;
+
+interface PinchZoomResult {
+    /** Current zoom scale (1 = no zoom) */
+    scale: number;
+    /** Whether a pinch gesture is active */
+    isPinching: boolean;
+    /** Props to spread on the zoomable container */
+    gestureProps: {
+        onTouchStart: (e: React__default.TouchEvent) => void;
+        onTouchMove: (e: React__default.TouchEvent) => void;
+        onTouchEnd: () => void;
+    };
+    /** Reset zoom to 1 */
+    resetZoom: () => void;
+}
+interface PinchZoomOptions {
+    /** Minimum zoom scale (default: 0.5) */
+    minScale?: number;
+    /** Maximum zoom scale (default: 4) */
+    maxScale?: number;
+}
+declare function usePinchZoom(options?: PinchZoomOptions): PinchZoomResult;
+
 /**
  * GitHub connection status
  */
@@ -1088,4 +1218,4 @@ declare function useGitHubBranches(owner: string, repo: string, enabled?: boolea
     branches: string[];
 }, Error>;
 
-export { type AuthContextValue, type AuthUser, type ChangeSummary, type CompileResult, type CompileStage, ENTITY_EVENTS, Entity, type EntityDataAdapter, EntityDataProvider, type EntityDataRecord, type EntityMutationResult, EventBusContextType, EventListener, type Extension, type ExtensionManifest, type FileSystemFile, type FileSystemStatus, type GitHubRepo, type GitHubStatus, type HistoryTimelineItem, type I18nContextValue, I18nProvider, type OpenFile, type OrbitalEventPayload, type OrbitalEventResponse, type QuerySingletonEntity, type QuerySingletonResult, type QuerySingletonState, type QueryState, type ResolvedEntity, type RevertResult, type SelectedFile, type TranslateFunction, type UseCompileResult, type UseEntityDetailResult, type UseEntityListOptions, type UseEntityListResult, type UseEntityMutationsOptions, type UseExtensionsOptions, type UseExtensionsResult, type UseFileEditorOptions, type UseFileEditorResult, type UseFileSystemResult, type UseOrbitalHistoryOptions, type UseOrbitalHistoryResult, clearEntities, createTranslate, entityDataKeys, getAllEntities, getByType, getEntity, getSingleton, parseQueryBinding, removeEntity, spawnEntity, updateEntity, updateSingleton, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useCreateEntity, useDeepAgentGeneration, useDeleteEntity, useDisconnectGitHub, useEmitEvent, useEntities, useEntitiesByType, useEntity$1 as useEntity, useEntity as useEntityById, useEntityDataAdapter, useEntityDetail, useEntityList, useEntityListSuspense, useEntityMutations, useEntitySuspense, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInput, useOrbitalHistory, useOrbitalMutations, usePhysics, usePlayer, usePreview, useQuerySingleton, useResolvedEntity, useSelectedEntity, useSendOrbitalEvent, useSingletonEntity, useTranslate, useUIEvents, useUpdateEntity, useValidation };
+export { type AuthContextValue, type AuthUser, type ChangeSummary, type CompileResult, type CompileStage, type DragReorderResult, ENTITY_EVENTS, Entity, type EntityDataAdapter, EntityDataProvider, type EntityDataRecord, type EntityMutationResult, EventBusContextType, EventListener, type Extension, type ExtensionManifest, type FileSystemFile, type FileSystemStatus, type GitHubRepo, type GitHubStatus, type HistoryTimelineItem, type I18nContextValue, I18nProvider, type InfiniteScrollOptions, type InfiniteScrollResult, type LongPressHandlers, type LongPressOptions, type OpenFile, type OrbitalEventPayload, type OrbitalEventResponse, type PinchZoomOptions, type PinchZoomResult, type PullToRefreshOptions, type PullToRefreshResult, type QuerySingletonEntity, type QuerySingletonResult, type QuerySingletonState, type QueryState, type ResolvedEntity, type RevertResult, type SelectedFile, type SwipeGestureOptions, type SwipeGestureResult, type SwipeHandlers, type TranslateFunction, type UseCompileResult, type UseEntityDetailResult, type UseEntityListOptions, type UseEntityListResult, type UseEntityMutationsOptions, type UseExtensionsOptions, type UseExtensionsResult, type UseFileEditorOptions, type UseFileEditorResult, type UseFileSystemResult, type UseOrbitalHistoryOptions, type UseOrbitalHistoryResult, clearEntities, createTranslate, entityDataKeys, getAllEntities, getByType, getEntity, getSingleton, parseQueryBinding, removeEntity, spawnEntity, updateEntity, updateSingleton, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useCreateEntity, useDeepAgentGeneration, useDeleteEntity, useDisconnectGitHub, useDragReorder, useEmitEvent, useEntities, useEntitiesByType, useEntity$1 as useEntity, useEntity as useEntityById, useEntityDataAdapter, useEntityDetail, useEntityList, useEntityListSuspense, useEntityMutations, useEntitySuspense, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useInput, useLongPress, useOrbitalHistory, useOrbitalMutations, usePhysics, usePinchZoom, usePlayer, usePreview, usePullToRefresh, useQuerySingleton, useResolvedEntity, useSelectedEntity, useSendOrbitalEvent, useSingletonEntity, useSwipeGesture, useTranslate, useUIEvents, useUpdateEntity, useValidation };

package/dist/hooks/index.js

@@ -1,8 +1,8 @@
-export { ENTITY_EVENTS, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useCreateEntity, useDeepAgentGeneration, useDeleteEntity, useDisconnectGitHub, useEntities, useEntitiesByType, useEntity as useEntityById, useEntityMutations, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInput, useOrbitalHistory, useOrbitalMutations, usePhysics, usePlayer, usePreview, useResolvedEntity, useSelectedEntity, useSendOrbitalEvent, useSingletonEntity, useUIEvents, useUpdateEntity, useValidation } from '../chunk-2UMN2BLO.js';
+export { ENTITY_EVENTS, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useCreateEntity, useDeepAgentGeneration, useDeleteEntity, useDisconnectGitHub, useEntities, useEntitiesByType, useEntity as useEntityById, useEntityMutations, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInput, useOrbitalHistory, useOrbitalMutations, usePhysics, usePinchZoom, usePlayer, usePreview, useResolvedEntity, useSelectedEntity, useSendOrbitalEvent, useSingletonEntity, useUIEvents, useUpdateEntity, useValidation } from '../chunk-2QM732NQ.js';
 import '../chunk-3HJHHULT.js';
-export { clearEntities, getAllEntities, getByType, getEntity, getSingleton, removeEntity, spawnEntity, updateEntity, updateSingleton } from '../chunk-N7MVUW4R.js';
-export { EntityDataProvider, I18nProvider, createTranslate, entityDataKeys, parseQueryBinding, useEntity, useEntityDataAdapter, useEntityDetail, useEntityList, useEntityListSuspense, useEntitySuspense, useQuerySingleton, useTranslate } from '../chunk-GOZKH7QW.js';
+export { EntityDataProvider, I18nProvider, createTranslate, entityDataKeys, parseQueryBinding, useDragReorder, useEntity, useEntityDataAdapter, useEntityDetail, useEntityList, useEntityListSuspense, useEntitySuspense, useInfiniteScroll, useLongPress, usePullToRefresh, useQuerySingleton, useSwipeGesture, useTranslate } from '../chunk-WGJIL4YR.js';
 export { useEmitEvent, useEventBus, useEventListener } from '../chunk-YXZM3WCF.js';
 export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-3JGAROCW.js';
 import '../chunk-TSETXL2E.js';
+export { clearEntities, getAllEntities, getByType, getEntity, getSingleton, removeEntity, spawnEntity, updateEntity, updateSingleton } from '../chunk-N7MVUW4R.js';
 import '../chunk-PKBMQBKP.js';

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-RPYMP7ZC.js';
 import '../chunk-PKBMQBKP.js';
 
 // lib/debugUtils.ts

package/dist/providers/index.js

@@ -1,13 +1,12 @@
-import { SuspenseConfigProvider } from '../chunk-AL6BLHMG.js';
+import { SuspenseConfigProvider } from '../chunk-VJP2HCLY.js';
 import { ThemeProvider } from '../chunk-DKQN5FVU.js';
-import { SelectionProvider, EntityDataProvider } from '../chunk-GOZKH7QW.js';
-export { SelectionContext, SelectionProvider, useSelection, useSelectionOptional } from '../chunk-GOZKH7QW.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-RPYMP7ZC.js';
 import '../chunk-TSETXL2E.js';
-import { recordTransition, registerCheck, bindEventBus, bindTraitStateGetter } from '../chunk-45CTDYBT.js';
-import '../chunk-KKCVDUK7.js';
 import { useOfflineExecutor } from '../chunk-K2D5D3WK.js';
 import '../chunk-PKBMQBKP.js';
 import { createContext, useState, useCallback, useMemo, useContext, useRef, useEffect } from 'react';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "2.5.2",
+  "version": "2.7.0",
   "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 };