@almadar/ui 2.11.7 → 2.12.0

package/dist/components/index.js

@@ -1,20 +1,20 @@
 import { DEFAULT_CONFIG, renderStateMachineToDomData, parseContentSegments, isDebugEnabled, onDebugToggle, subscribeToTickChanges, subscribeToGuardChanges, subscribeToDebugEvents, getEntitySnapshot, getDebugEvents, getGuardHistory, getAllTicks } from '../chunk-4ZBSL37D.js';
-import { useAuthContext } from '../chunk-3FENGM4Y.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-3FENGM4Y.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 { subscribeToTraitChanges, getAllTraits } from '../chunk-42YQ6JVR.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, Accordion, ButtonGroup, Container } from '../chunk-4NAQLJ2M.js';
-export { ALL_PRESETS, Accordion, ActionButton, ActionButtons, Card2 as ActionCard, Alert, AnimatedCounter, Avatar, Badge, Box, Breadcrumb, Button, ButtonGroup, CalendarGrid, CanvasEffect, Card, CardBody, CardContent, CardFooter, CardGrid, CardHeader, CardTitle, Carousel, Center, Chart, 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, SimulationCanvas, SimulationControls, SimulationGraph, 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, pendulum, projectileMotion, screenToIso, springOscillator, useCamera, useImageCache } from '../chunk-4NAQLJ2M.js';
-import '../chunk-YLKXEXBP.js';
-import { useTranslate } from '../chunk-RUL35VPK.js';
-export { EntityDataProvider, I18nProvider, createTranslate, entityDataKeys, parseQueryBinding, useDragReorder, useEntity, useEntityDataAdapter, useEntityDetail, useEntityList, useEntityListSuspense, useEntitySuspense, useInfiniteScroll, useLongPress, usePullToRefresh, useQuerySingleton, useSwipeGesture, useTranslate } from '../chunk-RUL35VPK.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, Accordion, ButtonGroup, Container } from '../chunk-JDISOWHE.js';
+export { ALL_PRESETS, Accordion, ActionButton, ActionButtons, Card2 as ActionCard, Alert, AnimatedCounter, Avatar, Badge, Box, Breadcrumb, Button, ButtonGroup, CalendarGrid, CanvasEffect, Card, CardBody, CardContent, CardFooter, CardGrid, CardHeader, CardTitle, Carousel, Center, Chart, 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, SimulationCanvas, SimulationControls, SimulationGraph, 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, pendulum, projectileMotion, screenToIso, springOscillator, useCamera, useImageCache } from '../chunk-JDISOWHE.js';
+import '../chunk-DKQN5FVU.js';
+import { useTranslate } from '../chunk-WGJIL4YR.js';
+export { EntityDataProvider, I18nProvider, createTranslate, entityDataKeys, parseQueryBinding, useDragReorder, useEntity, useEntityDataAdapter, useEntityDetail, useEntityList, useEntityListSuspense, useEntitySuspense, useInfiniteScroll, useLongPress, usePullToRefresh, useQuerySingleton, useSwipeGesture, useTranslate } from '../chunk-WGJIL4YR.js';
 import { useEventBus, useEventListener } from '../chunk-YXZM3WCF.js';
 export { useEmitEvent, useEventBus, useEventListener } from '../chunk-YXZM3WCF.js';
 export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-3JGAROCW.js';
-import '../chunk-TSETXL2E.js';
 import { cn, getNestedValue, subscribeToVerification, getSummary, getBridgeHealth, getTransitions, getAllChecks } from '../chunk-WCTZ7WZX.js';
 export { cn } from '../chunk-WCTZ7WZX.js';
+import '../chunk-TSETXL2E.js';
 import '../chunk-K2D5D3WK.js';
 import { __publicField } from '../chunk-PKBMQBKP.js';
 import * as React44 from 'react';

package/dist/context/index.js

@@ -1,5 +1,5 @@
-import { ThemeProvider, useTheme } from '../chunk-YLKXEXBP.js';
-export { BUILT_IN_THEMES, ThemeContext_default as ThemeContext, ThemeProvider, UISlotContext, UISlotProvider, useSlotContent, useSlotHasContent, useTheme, useUISlots } from '../chunk-YLKXEXBP.js';
+import { ThemeProvider, useTheme } from '../chunk-DKQN5FVU.js';
+export { BUILT_IN_THEMES, ThemeContext_default as ThemeContext, ThemeProvider, UISlotContext, UISlotProvider, useSlotContent, useSlotHasContent, useTheme, useUISlots } from '../chunk-DKQN5FVU.js';
 import '../chunk-3JGAROCW.js';
 import '../chunk-PKBMQBKP.js';
 import { createContext, useCallback, useMemo, useContext } from 'react';

package/dist/hooks/index.d.ts

@@ -7,6 +7,67 @@ 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';
 
+declare global {
+    interface Window {
+        __kflowEventBus?: EventBusContextType | null;
+    }
+}
+/**
+ * Hook for accessing the event bus.
+ *
+ * Uses EventBusProvider context if available, otherwise falls back to
+ * a simple in-memory event bus (for design system / Storybook).
+ *
+ * @returns Event bus instance with emit, on, once, and hasListeners methods
+ *
+ * @example
+ * ```tsx
+ * const eventBus = useEventBus();
+ *
+ * // Emit an event
+ * eventBus.emit('UI:CLICK', { id: '123' });
+ *
+ * // Subscribe to an event
+ * useEffect(() => {
+ *   return eventBus.on('UI:CLICK', (event) => {
+ *     console.log('Clicked:', event.payload);
+ *   });
+ * }, []);
+ * ```
+ */
+declare function useEventBus(): EventBusContextType;
+/**
+ * Hook for subscribing to a specific event.
+ * Automatically cleans up subscription on unmount.
+ *
+ * @param event - Event name to subscribe to
+ * @param handler - Event handler function
+ *
+ * @example
+ * ```tsx
+ * useEventListener('UI:CLICK', (event) => {
+ *   console.log('Clicked:', event.payload);
+ * });
+ * ```
+ */
+declare function useEventListener(event: string, handler: EventListener): void;
+/**
+ * Hook for emitting events.
+ * Returns a memoized emit function.
+ *
+ * @returns Function to emit events
+ *
+ * @example
+ * ```tsx
+ * const emit = useEmitEvent();
+ *
+ * const handleClick = () => {
+ *   emit('UI:CLICK', { id: '123' });
+ * };
+ * ```
+ */
+declare function useEmitEvent(): (type: string, payload?: Record<string, unknown>) => void;
+
 interface ChangeSummary {
     added: number;
     modified: number;
@@ -427,67 +488,6 @@ interface UseValidationResult {
 }
 declare function useValidation(): UseValidationResult;
 
-declare global {
-    interface Window {
-        __kflowEventBus?: EventBusContextType | null;
-    }
-}
-/**
- * Hook for accessing the event bus.
- *
- * Uses EventBusProvider context if available, otherwise falls back to
- * a simple in-memory event bus (for design system / Storybook).
- *
- * @returns Event bus instance with emit, on, once, and hasListeners methods
- *
- * @example
- * ```tsx
- * const eventBus = useEventBus();
- *
- * // Emit an event
- * eventBus.emit('UI:CLICK', { id: '123' });
- *
- * // Subscribe to an event
- * useEffect(() => {
- *   return eventBus.on('UI:CLICK', (event) => {
- *     console.log('Clicked:', event.payload);
- *   });
- * }, []);
- * ```
- */
-declare function useEventBus(): EventBusContextType;
-/**
- * Hook for subscribing to a specific event.
- * Automatically cleans up subscription on unmount.
- *
- * @param event - Event name to subscribe to
- * @param handler - Event handler function
- *
- * @example
- * ```tsx
- * useEventListener('UI:CLICK', (event) => {
- *   console.log('Clicked:', event.payload);
- * });
- * ```
- */
-declare function useEventListener(event: string, handler: EventListener): void;
-/**
- * Hook for emitting events.
- * Returns a memoized emit function.
- *
- * @returns Function to emit events
- *
- * @example
- * ```tsx
- * const emit = useEmitEvent();
- *
- * const handleClick = () => {
- *   emit('UI:CLICK', { id: '123' });
- * };
- * ```
- */
-declare function useEmitEvent(): (type: string, payload?: Record<string, unknown>) => void;
-
 /**
  * Hook to bridge UI events to state machine dispatch
  *

package/dist/hooks/index.js

@@ -1,7 +1,7 @@
-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-3FENGM4Y.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-RUL35VPK.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';

package/dist/providers/index.js

@@ -1,10 +1,10 @@
-export { FetchedDataContext, FetchedDataProvider, OfflineModeProvider, OrbitalProvider, VerificationProvider, useFetchedData, useFetchedDataContext, useFetchedEntity, useOfflineMode, useOptionalOfflineMode } from '../chunk-5K3GTPBX.js';
-import '../chunk-4NAQLJ2M.js';
-import '../chunk-YLKXEXBP.js';
-export { SelectionContext, SelectionProvider, useSelection, useSelectionOptional } from '../chunk-RUL35VPK.js';
+export { FetchedDataContext, FetchedDataProvider, OfflineModeProvider, OrbitalProvider, VerificationProvider, useFetchedData, useFetchedDataContext, useFetchedEntity, useOfflineMode, useOptionalOfflineMode } from '../chunk-TVP75XPM.js';
+import '../chunk-JDISOWHE.js';
+import '../chunk-DKQN5FVU.js';
+export { SelectionContext, SelectionProvider, useSelection, useSelectionOptional } from '../chunk-WGJIL4YR.js';
 export { EventBusContext, EventBusProvider } from '../chunk-YXZM3WCF.js';
 import '../chunk-3JGAROCW.js';
-import '../chunk-TSETXL2E.js';
 import '../chunk-WCTZ7WZX.js';
+import '../chunk-TSETXL2E.js';
 import '../chunk-K2D5D3WK.js';
 import '../chunk-PKBMQBKP.js';

package/dist/runtime/index.js

@@ -1,20 +1,20 @@
-import '../chunk-3FENGM4Y.js';
+import '../chunk-GTIAVPI5.js';
 import '../chunk-N7MVUW4R.js';
 import { registerTrait, unregisterTrait, updateTraitState } from '../chunk-42YQ6JVR.js';
 import '../chunk-3HJHHULT.js';
-import { useFetchedDataContext } from '../chunk-5K3GTPBX.js';
-import '../chunk-4NAQLJ2M.js';
-import '../chunk-YLKXEXBP.js';
-import '../chunk-RUL35VPK.js';
+import { useFetchedDataContext } from '../chunk-TVP75XPM.js';
+import '../chunk-JDISOWHE.js';
+import '../chunk-DKQN5FVU.js';
+import '../chunk-WGJIL4YR.js';
 import { useEventBus } from '../chunk-YXZM3WCF.js';
 import '../chunk-3JGAROCW.js';
-import '../chunk-TSETXL2E.js';
 import { recordTransition } from '../chunk-WCTZ7WZX.js';
+import '../chunk-TSETXL2E.js';
 import '../chunk-K2D5D3WK.js';
 import '../chunk-PKBMQBKP.js';
 import { createContext, useMemo, useContext, useState, useRef, useEffect, useCallback } from 'react';
 import { isCircuitEvent, schemaToIR, getPage, clearSchemaCache as clearSchemaCache$1 } from '@almadar/core';
-import { StateMachineManager, EffectExecutor } from '@almadar/runtime';
+import { StateMachineManager, createContextFromBindings, interpolateValue, EffectExecutor } from '@almadar/runtime';
 import { isEntityAwarePattern } from '@almadar/patterns';
 import { jsx } from 'react/jsx-runtime';
 
@@ -124,6 +124,14 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
   useEffect(() => {
     optionsRef.current = options;
   }, [options]);
+  const traitStatesRef = useRef(traitStates);
+  const fetchedDataContextRef = useRef(fetchedDataContext);
+  useEffect(() => {
+    traitStatesRef.current = traitStates;
+  }, [traitStates]);
+  useEffect(() => {
+    fetchedDataContextRef.current = fetchedDataContext;
+  }, [fetchedDataContext]);
   useEffect(() => {
     const mgr = managerRef.current;
     const bindings = traitBindingsRef.current;
@@ -166,6 +174,143 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
       Array.from(newManager.getAllStates().keys()).join(", ")
     );
   }, [traitBindings]);
+  const runTickEffects = useCallback((tick, binding) => {
+    const fdc = fetchedDataContextRef.current;
+    const actions = slotsActionsRef.current;
+    const linkedEntity = binding.linkedEntity ?? "";
+    const currentState = traitStatesRef.current.get(binding.trait.name)?.currentState ?? "";
+    if (tick.appliesTo.length > 0 && !tick.appliesTo.includes(currentState)) return;
+    const records = linkedEntity && fdc ? fdc.getData(linkedEntity) : [];
+    const entityData = records.length > 0 ? Object.assign([...records], records[0]) : {};
+    const bindingCtx = { entity: entityData, payload: {}, state: currentState };
+    const evalCtx = createContextFromBindings(bindingCtx);
+    if (tick.guard !== void 0) {
+      const passed = interpolateValue(tick.guard, evalCtx);
+      if (!passed) return;
+    }
+    const entityMutations = /* @__PURE__ */ new Map();
+    const pendingSlots = /* @__PURE__ */ new Map();
+    const slotSource = {
+      trait: binding.trait.name,
+      state: currentState,
+      transition: `${currentState}->tick:${tick.name}`,
+      effects: tick.effects,
+      traitDefinition: binding.trait
+    };
+    const enrichTickNode = (node) => {
+      if (!node || typeof node !== "object") return node;
+      const rec = node;
+      const nodeType = rec.type;
+      let enriched = rec;
+      if (Array.isArray(rec.children)) {
+        enriched = { ...rec, children: rec.children.map(enrichTickNode) };
+      }
+      if (nodeType && isEntityAwarePattern(nodeType) && fdc) {
+        let injected = false;
+        if (typeof enriched.entity === "string") {
+          const entityRecords = fdc.getData(enriched.entity);
+          if (entityRecords.length > 0) {
+            enriched = { ...enriched, entity: entityRecords };
+            injected = true;
+          }
+        } else if (!enriched.entity && linkedEntity) {
+          const entityRecords = fdc.getData(linkedEntity);
+          if (entityRecords.length > 0) {
+            enriched = { ...enriched, entity: entityRecords };
+            injected = true;
+          }
+        }
+        if (injected && !enriched.fields && !enriched.columns) {
+          const sample = enriched.entity[0];
+          if (sample && typeof sample === "object") {
+            const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
+            enriched = { ...enriched, fields: keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" })), children: void 0 };
+          }
+        }
+      }
+      return enriched;
+    };
+    for (const effect of tick.effects) {
+      if (!Array.isArray(effect)) continue;
+      const op = effect[0];
+      if (op === "set") {
+        const path = effect[1];
+        if (typeof path !== "string" || !path.startsWith("@entity.")) continue;
+        const field = path.slice("@entity.".length);
+        const updatedCtx = createContextFromBindings(bindingCtx);
+        const value = interpolateValue(effect[2], updatedCtx);
+        bindingCtx.entity[field] = value;
+        entityMutations.set(field, value);
+      } else if (op === "render-ui" || op === "render") {
+        const slot = effect[1];
+        const rawPattern = effect[2];
+        if (rawPattern === null || rawPattern === void 0) {
+          pendingSlots.set(slot, []);
+          continue;
+        }
+        const updatedCtx = createContextFromBindings(bindingCtx);
+        const resolved = interpolateValue(rawPattern, updatedCtx);
+        const enriched = enrichTickNode(resolved);
+        const existing = pendingSlots.get(slot) ?? [];
+        existing.push({ pattern: enriched, props: {} });
+        pendingSlots.set(slot, existing);
+      }
+    }
+    for (const [slot, patterns] of pendingSlots) {
+      if (patterns.length === 0) {
+        actions.clearSlot(slot);
+      } else {
+        actions.setSlotPatterns(slot, patterns, slotSource);
+      }
+    }
+    if (linkedEntity && entityMutations.size > 0 && fdc) {
+      const latestRecords = fdc.getData(linkedEntity);
+      if (latestRecords.length > 0) {
+        const updated = latestRecords.map(
+          (r, i) => i === 0 ? { ...r, ...Object.fromEntries(entityMutations) } : r
+        );
+        fdc.setData({ [linkedEntity]: updated });
+      }
+    }
+  }, []);
+  useEffect(() => {
+    const hasFrameTicks = traitBindingsRef.current.some(
+      (b) => b.trait.ticks?.some((t) => t.interval === "frame")
+    );
+    if (!hasFrameTicks) return;
+    let running = true;
+    let rafId = 0;
+    const frame = () => {
+      if (!running) return;
+      for (const binding of traitBindingsRef.current) {
+        for (const tick of binding.trait.ticks ?? []) {
+          if (tick.interval !== "frame") continue;
+          runTickEffects(tick, binding);
+        }
+      }
+      rafId = requestAnimationFrame(frame);
+    };
+    rafId = requestAnimationFrame(frame);
+    return () => {
+      running = false;
+      cancelAnimationFrame(rafId);
+    };
+  }, [traitBindings, runTickEffects]);
+  useEffect(() => {
+    const intervals = [];
+    for (const binding of traitBindings) {
+      for (const tick of binding.trait.ticks ?? []) {
+        if (tick.interval === "frame") continue;
+        const ms = tick.interval;
+        intervals.push(setInterval(() => {
+          runTickEffects(tick, binding);
+        }, ms));
+      }
+    }
+    return () => {
+      for (const id of intervals) clearInterval(id);
+    };
+  }, [traitBindings, runTickEffects]);
   const processEvent = useCallback((eventKey, payload) => {
     const normalizedEvent = normalizeEventKey(eventKey);
     const bindings = traitBindingsRef.current;
@@ -277,6 +422,19 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
           payload: payload || {},
           state: result.previousState
         };
+        const entityMutations = /* @__PURE__ */ new Map();
+        for (const effect of result.effects) {
+          if (!Array.isArray(effect) || effect[0] !== "set") continue;
+          const path = effect[1];
+          if (typeof path !== "string" || !path.startsWith("@entity.")) continue;
+          const field = path.slice("@entity.".length);
+          const evalCtx = createContextFromBindings(bindingCtx);
+          const value = interpolateValue(effect[2], evalCtx);
+          if (bindingCtx.entity !== null && typeof bindingCtx.entity === "object") {
+            bindingCtx.entity[field] = value;
+          }
+          entityMutations.set(field, value);
+        }
         const effectContext = {
           traitName: binding.trait.name,
           state: result.previousState,
@@ -297,6 +455,15 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
               actions.setSlotPatterns(slot, patterns, slotSource);
             }
           }
+          if (linkedEntity && entityMutations.size > 0 && fetchedDataContext) {
+            const records = fetchedDataContext.getData(linkedEntity);
+            if (records.length > 0) {
+              const updated = records.map(
+                (r, i) => i === 0 ? { ...r, ...Object.fromEntries(entityMutations) } : r
+              );
+              fetchedDataContext.setData({ [linkedEntity]: updated });
+            }
+          }
         }).catch((error) => {
           console.error(
             "[TraitStateMachine] Effect execution error:",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "2.11.7",
+  "version": "2.12.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",
@@ -93,6 +93,7 @@
     "@react-three/drei": "^9.92.0 || ^10.0.0",
     "@react-three/fiber": "^8.15.0",
     "@tanstack/react-query": "^5.0.0",
+    "@docusaurus/theme-common": "*",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
     "react-router-dom": "^7.0.0",

package/themes/almadar.css

@@ -99,9 +99,6 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #14b8a6;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }
 
 /* ==========================================================================
@@ -198,7 +195,4 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #14b8a6;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }

package/themes/arctic.css

@@ -100,9 +100,6 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #0284c7;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }
 
 /* ==========================================================================
@@ -197,7 +194,4 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #67e8f9;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }

package/themes/copper.css

@@ -100,9 +100,6 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #b45309;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }
 
 /* ==========================================================================
@@ -197,7 +194,4 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #d97706;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }

package/themes/ember.css

@@ -101,9 +101,6 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #dc2626;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }
 
 /* ==========================================================================
@@ -200,7 +197,4 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #f87171;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }

package/themes/forest.css

@@ -101,9 +101,6 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #2d6a4f;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }
 
 /* ==========================================================================
@@ -200,7 +197,4 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #52b788;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }

package/themes/lavender.css

@@ -98,9 +98,6 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #7c3aed;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }
 
 /* ==========================================================================
@@ -195,7 +192,4 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #a78bfa;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }

package/themes/midnight.css

@@ -99,9 +99,6 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #6366f1;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }
 
 /* ==========================================================================
@@ -196,7 +193,4 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #818cf8;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }

package/themes/minimalist.css

@@ -98,9 +98,6 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #18181b;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }
 
 /* ==========================================================================
@@ -195,7 +192,4 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #fafafa;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }

package/themes/neon.css

@@ -101,9 +101,6 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #22d3ee;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }
 
 /* ==========================================================================
@@ -202,7 +199,4 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #22d3ee;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }

package/themes/ocean.css

@@ -101,9 +101,6 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #0077b6;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }
 
 /* ==========================================================================
@@ -200,7 +197,4 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #48cae4;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }

package/themes/rose.css

@@ -98,9 +98,6 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #e11d48;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }
 
 /* ==========================================================================
@@ -195,7 +192,4 @@
     --focus-ring-offset: 2px;
     --focus-ring-color: #fb7185;
 
-    /* Apply background and foreground colors */
-    background-color: var(--color-background);
-    color: var(--color-foreground);
 }