@almadar/ui 2.8.1 → 2.9.0

package/dist/chunk-UVMBFEMO.js

@@ -0,0 +1,375 @@
+import { SuspenseConfigProvider } from './chunk-NES4SBB7.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-A5J5CNCU.js';
+import { useOfflineExecutor } from './chunk-K2D5D3WK.js';
+import { createContext, useState, useCallback, useMemo, useContext, useRef, useEffect } from 'react';
+import { jsx, Fragment } from 'react/jsx-runtime';
+
+var FetchedDataContext = createContext(null);
+function FetchedDataProvider({
+  initialData,
+  children
+}) {
+  const [state, setState] = useState(() => ({
+    data: initialData || {},
+    fetchedAt: {},
+    loading: false,
+    error: null
+  }));
+  const getData = useCallback(
+    (entityName) => {
+      return state.data[entityName] || [];
+    },
+    [state.data]
+  );
+  const getById = useCallback(
+    (entityName, id) => {
+      const records = state.data[entityName];
+      return records?.find((r) => r.id === id);
+    },
+    [state.data]
+  );
+  const hasData = useCallback(
+    (entityName) => {
+      return entityName in state.data && state.data[entityName].length > 0;
+    },
+    [state.data]
+  );
+  const getFetchedAt = useCallback(
+    (entityName) => {
+      return state.fetchedAt[entityName];
+    },
+    [state.fetchedAt]
+  );
+  const setData = useCallback((data) => {
+    const now = Date.now();
+    setState((prev) => ({
+      ...prev,
+      data: {
+        ...prev.data,
+        ...data
+      },
+      fetchedAt: {
+        ...prev.fetchedAt,
+        ...Object.keys(data).reduce(
+          (acc, key) => ({ ...acc, [key]: now }),
+          {}
+        )
+      },
+      loading: false,
+      error: null
+    }));
+  }, []);
+  const clearData = useCallback(() => {
+    setState((prev) => ({
+      ...prev,
+      data: {},
+      fetchedAt: {}
+    }));
+  }, []);
+  const clearEntity = useCallback((entityName) => {
+    setState((prev) => {
+      const newData = { ...prev.data };
+      const newFetchedAt = { ...prev.fetchedAt };
+      delete newData[entityName];
+      delete newFetchedAt[entityName];
+      return {
+        ...prev,
+        data: newData,
+        fetchedAt: newFetchedAt
+      };
+    });
+  }, []);
+  const setLoading = useCallback((loading) => {
+    setState((prev) => ({ ...prev, loading }));
+  }, []);
+  const setError = useCallback((error) => {
+    setState((prev) => ({ ...prev, error, loading: false }));
+  }, []);
+  const contextValue = useMemo(
+    () => ({
+      getData,
+      getById,
+      hasData,
+      getFetchedAt,
+      setData,
+      clearData,
+      clearEntity,
+      loading: state.loading,
+      setLoading,
+      error: state.error,
+      setError
+    }),
+    [
+      getData,
+      getById,
+      hasData,
+      getFetchedAt,
+      setData,
+      clearData,
+      clearEntity,
+      state.loading,
+      setLoading,
+      state.error,
+      setError
+    ]
+  );
+  return /* @__PURE__ */ jsx(FetchedDataContext.Provider, { value: contextValue, children });
+}
+function useFetchedDataContext() {
+  return useContext(FetchedDataContext);
+}
+function useFetchedData() {
+  const context = useContext(FetchedDataContext);
+  if (!context) {
+    return {
+      getData: () => [],
+      getById: () => void 0,
+      hasData: () => false,
+      getFetchedAt: () => void 0,
+      setData: () => {
+      },
+      clearData: () => {
+      },
+      clearEntity: () => {
+      },
+      loading: false,
+      setLoading: () => {
+      },
+      error: null,
+      setError: () => {
+      }
+    };
+  }
+  return context;
+}
+function useFetchedEntity(entityName) {
+  const context = useFetchedData();
+  return {
+    /** All fetched records for this entity */
+    records: context.getData(entityName),
+    /** Get a record by ID */
+    getById: (id) => context.getById(entityName, id),
+    /** Whether data has been fetched for this entity */
+    hasData: context.hasData(entityName),
+    /** When data was last fetched */
+    fetchedAt: context.getFetchedAt(entityName),
+    /** Whether data is loading */
+    loading: context.loading,
+    /** Current error */
+    error: context.error
+  };
+}
+var DISPATCH_SUFFIX = ":DISPATCH";
+var SUCCESS_SUFFIX = ":SUCCESS";
+var ERROR_SUFFIX = ":ERROR";
+function parseLifecycleEvent(type) {
+  if (type.endsWith(DISPATCH_SUFFIX)) {
+    const traitName = type.slice(0, -DISPATCH_SUFFIX.length);
+    if (traitName) return { kind: "dispatch", traitName };
+  } else if (type.endsWith(SUCCESS_SUFFIX)) {
+    const rest = type.slice(0, -SUCCESS_SUFFIX.length);
+    const colonIdx = rest.indexOf(":");
+    if (colonIdx > 0) {
+      return {
+        kind: "success",
+        traitName: rest.slice(0, colonIdx),
+        event: rest.slice(colonIdx + 1)
+      };
+    }
+  } else if (type.endsWith(ERROR_SUFFIX)) {
+    const rest = type.slice(0, -ERROR_SUFFIX.length);
+    const colonIdx = rest.indexOf(":");
+    if (colonIdx > 0) {
+      return {
+        kind: "error",
+        traitName: rest.slice(0, colonIdx),
+        event: rest.slice(colonIdx + 1)
+      };
+    }
+  }
+  return null;
+}
+function VerificationProvider({
+  children,
+  enabled,
+  runtimeManager,
+  traitStateGetter
+}) {
+  const isEnabled = enabled ?? (typeof process !== "undefined" && process.env?.NODE_ENV !== "production");
+  const eventBus = useEventBus();
+  const pendingRef = useRef(/* @__PURE__ */ new Map());
+  useEffect(() => {
+    if (!isEnabled) return;
+    if (!eventBus.onAny) return;
+    const unsub = eventBus.onAny((evt) => {
+      const parsed = parseLifecycleEvent(evt.type);
+      if (!parsed) return;
+      const payload = evt.payload ?? {};
+      if (parsed.kind === "dispatch") {
+        const key = `${parsed.traitName}:${String(payload["event"] ?? "")}`;
+        pendingRef.current.set(key, {
+          traitName: parsed.traitName,
+          event: String(payload["event"] ?? ""),
+          from: payload["currentState"],
+          timestamp: evt.timestamp
+        });
+      } else if (parsed.kind === "success" && parsed.event) {
+        const key = `${parsed.traitName}:${parsed.event}`;
+        const pending = pendingRef.current.get(key);
+        pendingRef.current.delete(key);
+        const newState = payload["newState"] ?? payload["state"] ?? "unknown";
+        const effects = Array.isArray(payload["clientEffects"]) ? payload["clientEffects"].map((e) => ({
+          type: String(e["type"] ?? "unknown"),
+          args: Array.isArray(e["args"]) ? e["args"] : [],
+          status: "executed"
+        })) : [];
+        recordTransition({
+          traitName: parsed.traitName,
+          from: pending?.from ?? "unknown",
+          to: newState,
+          event: parsed.event,
+          effects,
+          timestamp: Date.now()
+        });
+      } else if (parsed.kind === "error" && parsed.event) {
+        const key = `${parsed.traitName}:${parsed.event}`;
+        const pending = pendingRef.current.get(key);
+        pendingRef.current.delete(key);
+        const errorMsg = payload["error"] ?? "Unknown error";
+        recordTransition({
+          traitName: parsed.traitName,
+          from: pending?.from ?? "unknown",
+          to: pending?.from ?? "unknown",
+          // state didn't change on error
+          event: parsed.event,
+          effects: [{
+            type: "server-call",
+            args: [],
+            status: "failed",
+            error: errorMsg
+          }],
+          timestamp: Date.now()
+        });
+      }
+    });
+    registerCheck(
+      "verification-provider",
+      "VerificationProvider active (compiled path)",
+      "pass"
+    );
+    return unsub;
+  }, [isEnabled, eventBus]);
+  useEffect(() => {
+    if (!isEnabled) return;
+    if (!runtimeManager) return;
+    runtimeManager.setObserver({
+      onTransition(trace) {
+        recordTransition({
+          traitName: trace.traitName,
+          from: trace.from,
+          to: trace.to,
+          event: trace.event,
+          guardResult: trace.guardResult,
+          effects: trace.effects,
+          timestamp: Date.now()
+        });
+      }
+    });
+    registerCheck(
+      "verification-provider",
+      "VerificationProvider active (runtime path)",
+      "pass"
+    );
+  }, [isEnabled, runtimeManager]);
+  useEffect(() => {
+    if (!isEnabled) return;
+    bindEventBus(eventBus);
+  }, [isEnabled, eventBus]);
+  useEffect(() => {
+    if (!isEnabled) return;
+    if (traitStateGetter) {
+      bindTraitStateGetter(traitStateGetter);
+    } else if (runtimeManager?.getState) {
+      const mgr = runtimeManager;
+      bindTraitStateGetter((traitName) => mgr.getState(traitName));
+    }
+  }, [isEnabled, traitStateGetter, runtimeManager]);
+  return /* @__PURE__ */ jsx(Fragment, { children });
+}
+VerificationProvider.displayName = "VerificationProvider";
+function FetchedDataBridge({ children }) {
+  const fetchedData = useFetchedData();
+  const adapter = useMemo(() => ({
+    getData: (entity) => fetchedData.getData(entity),
+    getById: (entity, id) => fetchedData.getById(entity, id),
+    isLoading: fetchedData.loading,
+    error: fetchedData.error
+  }), [fetchedData.getData, fetchedData.getById, fetchedData.loading, fetchedData.error]);
+  return /* @__PURE__ */ jsx(EntityDataProvider, { adapter, children });
+}
+function OrbitalProvider({
+  children,
+  themes,
+  defaultTheme = "wireframe",
+  defaultMode = "system",
+  targetRef,
+  skipTheme = false,
+  debug = false,
+  initialData,
+  suspense = false,
+  verification
+}) {
+  const suspenseConfig = useMemo(
+    () => ({ enabled: suspense }),
+    [suspense]
+  );
+  const inner = /* @__PURE__ */ jsx(FetchedDataProvider, { initialData, children: /* @__PURE__ */ jsx(FetchedDataBridge, { children: /* @__PURE__ */ jsx(EventBusProvider, { debug, children: /* @__PURE__ */ jsx(VerificationProvider, { enabled: verification, children: /* @__PURE__ */ jsx(SelectionProvider, { debug, children: /* @__PURE__ */ jsx(SuspenseConfigProvider, { config: suspenseConfig, children }) }) }) }) }) });
+  if (skipTheme) {
+    return inner;
+  }
+  return /* @__PURE__ */ jsx(
+    ThemeProvider,
+    {
+      themes,
+      defaultTheme,
+      defaultMode,
+      targetRef,
+      children: inner
+    }
+  );
+}
+OrbitalProvider.displayName = "OrbitalProvider";
+var OfflineModeContext = createContext(null);
+function OfflineModeProvider({
+  children,
+  ...executorOptions
+}) {
+  const [forceOffline, setForceOffline] = useState(false);
+  const executor = useOfflineExecutor(executorOptions);
+  const effectivelyOffline = executor.isOffline || forceOffline;
+  const contextValue = useMemo(
+    () => ({
+      ...executor,
+      forceOffline,
+      setForceOffline,
+      effectivelyOffline
+    }),
+    [executor, forceOffline, effectivelyOffline]
+  );
+  return /* @__PURE__ */ jsx(OfflineModeContext.Provider, { value: contextValue, children });
+}
+function useOfflineMode() {
+  const context = useContext(OfflineModeContext);
+  if (!context) {
+    throw new Error("useOfflineMode must be used within OfflineModeProvider");
+  }
+  return context;
+}
+function useOptionalOfflineMode() {
+  return useContext(OfflineModeContext);
+}
+
+export { FetchedDataContext, FetchedDataProvider, OfflineModeProvider, OrbitalProvider, VerificationProvider, useFetchedData, useFetchedDataContext, useFetchedEntity, useOfflineMode, useOptionalOfflineMode };

package/dist/components/index.d.ts

@@ -4339,9 +4339,9 @@ interface DataGridItemAction {
 }
 interface DataGridProps {
     /** Entity data array */
-    entity?: unknown | readonly unknown[];
+    entity: unknown | readonly unknown[];
     /** Field definitions for rendering each card */
-    fields?: readonly DataGridField[];
+    fields: readonly DataGridField[];
     /** Alias for fields (compiler generates `columns` for field definitions) */
     columns?: readonly DataGridField[];
     /** Per-item action buttons */
@@ -4415,9 +4415,9 @@ interface DataListItemAction {
 }
 interface DataListProps {
     /** Entity data array */
-    entity?: unknown | readonly unknown[];
+    entity: unknown | readonly unknown[];
     /** Field definitions for rendering each row */
-    fields?: readonly DataListField[];
+    fields: readonly DataListField[];
     /** Alias for fields (compiler may generate `columns` for field definitions) */
     columns?: readonly DataListField[];
     /** Per-item action buttons */
@@ -4485,7 +4485,7 @@ interface StatDisplayProps {
     /** Display label (e.g., "Total", "Remaining") */
     label: string;
     /** Primary value (number or formatted string) */
-    value?: number | string;
+    value: number | string;
     /** Maximum value (renders as "value / max") */
     max?: number;
     /** Lucide icon name or React node */

package/dist/components/index.js

@@ -1,6 +1,7 @@
-import { useAuthContext } from '../chunk-2QM732NQ.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 { DEFAULT_CONFIG, renderStateMachineToDomData, parseContentSegments } from '../chunk-N6DJVKZ6.js';
+import { useAuthContext } from '../chunk-GTIAVPI5.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-GTIAVPI5.js';
+export { clearEntities, getAllEntities, getByType, getEntity, getSingleton, removeEntity, spawnEntity, updateEntity, updateSingleton } from '../chunk-N7MVUW4R.js';
 import '../chunk-3HJHHULT.js';
 import { VStack, HStack, Typography, Button, Icon, Box, Card, Avatar, Badge, SearchInput, Checkbox, Menu as Menu$1, Pagination, LoadingState, EmptyState, Modal, ErrorState, QuizBlock, CodeBlock, ScaledDiagram, MarkdownContent, Divider, ProgressBar, isoToScreen, IsometricCanvas_default, Stack, Select, Drawer, Toast, Tabs, Input, ThemeToggle, TILE_WIDTH, EntityDisplayEvents, StateIndicator, Container } from '../chunk-NES4SBB7.js';
 export { Accordion, ActionButton, ActionButtons, Card2 as ActionCard, Alert, AnimatedCounter, Avatar, Badge, Box, Breadcrumb, Button, ButtonGroup, CalendarGrid, Card, CardBody, CardContent, CardFooter, CardGrid, CardHeader, CardTitle, Carousel, Center, ChartLegend, Checkbox, ChoiceButton, CodeBlock, CombatLog, ComboCounter, ConditionalWrapper, ConfettiEffect, Container, ControlButton, CraftingRecipe, DIAMOND_TOP_Y, DPad, DamageNumber, DataGrid, DataList, DataTable, DateRangeSelector, DayCell, DetailPanel, DialogueBox, DialogueBubble, Divider, Drawer, EmptyState, EnemyPlate, EntityDisplayEvents, ErrorBoundary, ErrorState, FEATURE_COLORS, FLOOR_HEIGHT, FilterGroup, Flex, FlipCard, FlipContainer, FloatingActionButton, Form, FormField, FormSectionHeader, GameCanvas2D, GameHud, GameMenu, GameOverScreen, GraphView, Grid, HStack, Heading, HealthBar, HealthPanel, Icon, InfiniteScrollSentinel, Input, InputGroup, InventoryGrid, InventoryPanel, IsometricCanvas, ItemSlot, Label, LawReferenceTooltip, Lightbox, LineChart, LoadingState, MapView, MarkdownContent, MasterDetail, Menu, Meter, MiniMap, Modal, NumberStepper, Overlay, PageHeader, Pagination, PlatformerCanvas, Popover, PowerupSlots, ProgressBar, ProgressDots, PullToRefresh, QuestTracker, QuizBlock, Radio, RangeSlider, RelationSelect, RepeatableFormSection, ResourceBar, ResourceCounter, ScaledDiagram, ScoreBoard, ScoreDisplay, SearchInput, Select, SidePanel, SimpleGrid, Skeleton, SlotContentRenderer, SortableList, Spacer, Spinner, Sprite, Stack, StarRating, StatBadge, StatCard, StatDisplay, StateIndicator, StatusDot, StatusEffect, SwipeableRow, Switch, TILE_HEIGHT, TILE_WIDTH, Tabs, Text, TextHighlight, Textarea, ThemeSelector, ThemeToggle, TimeSlotCell, TimerDisplay, Toast, Tooltip, TrendIndicator, TurnIndicator, TurnPanel, TypewriterText, Typography, UISlotComponent, UISlotRenderer, UnitCommandBar, UploadDropZone, VStack, ViolationAlert, WaypointMarker, WizardNavigation, WizardProgress, XPBar, drawSprite, isoToScreen, screenToIso, useCamera, useImageCache } from '../chunk-NES4SBB7.js';
@@ -14,7 +15,6 @@ import { cn, getNestedValue, bindCanvasCapture } from '../chunk-A5J5CNCU.js';
 export { cn } from '../chunk-A5J5CNCU.js';
 import '../chunk-TSETXL2E.js';
 import '../chunk-K2D5D3WK.js';
-export { clearEntities, getAllEntities, getByType, getEntity, getSingleton, removeEntity, spawnEntity, updateEntity, updateSingleton } from '../chunk-N7MVUW4R.js';
 import { __publicField } from '../chunk-PKBMQBKP.js';
 import React, { createContext, useState, useCallback, useMemo, useEffect, useRef, useContext } from 'react';
 import { ChevronDown, X, Menu, ChevronRight, ChevronLeft, ArrowUp, ArrowDown, MoreVertical, Package, Check, AlertTriangle, Trash2, List as List$1, Printer, CheckCircle, XCircle, Play, RotateCcw, Send, Wrench, Bug, ArrowRight, Pause, SkipForward, AlertCircle, Circle, Clock, CheckCircle2, Image as Image$1, Upload, ZoomIn, Eraser, FileText, ZoomOut, Download, Code, WrapText, Copy, Settings, Search, Bell, LogOut, Calendar, Pencil, Eye, MoreHorizontal, Minus, Plus } from 'lucide-react';

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, usePinchZoom, usePlayer, usePreview, useResolvedEntity, useSelectedEntity, useSendOrbitalEvent, useSingletonEntity, useUIEvents, useUpdateEntity, useValidation } from '../chunk-2QM732NQ.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-GTIAVPI5.js';
+export { clearEntities, getAllEntities, getByType, getEntity, getSingleton, removeEntity, spawnEntity, updateEntity, updateSingleton } from '../chunk-N7MVUW4R.js';
 import '../chunk-3HJHHULT.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';