@almadar/ui 5.74.0 → 5.76.0

package/dist/hooks/index.js

@@ -1,4 +1,4 @@
-import { createContext, useCallback, useState, useEffect, useMemo, useContext, useRef, useSyncExternalStore, useReducer } from 'react';
+import { createContext, useCallback, useState, useEffect, useMemo, useContext, useRef } from 'react';
 import { createLogger } from '@almadar/logger';
 import { EventBusContext, useTraitScope } from '@almadar/ui/providers';
 import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
@@ -158,12 +158,10 @@ function useFileSystem() {
         const flattenTree = (obj, basePath = "") => {
           for (const [key, value] of Object.entries(obj)) {
             const path = basePath ? `${basePath}/${key}` : key;
-            if (value && typeof value === "object" && "file" in value) {
-              const fileObj = value;
-              filesArray.push({ path, content: fileObj.file.contents || "" });
-            } else if (value && typeof value === "object" && "directory" in value) {
-              const dirObj = value;
-              flattenTree(dirObj.directory, path);
+            if (value && "file" in value) {
+              filesArray.push({ path, content: value.file.contents || "" });
+            } else if (value && "directory" in value) {
+              flattenTree(value.directory, path);
             }
           }
         };
@@ -1022,8 +1020,6 @@ var ALL_SLOTS = [
   "toast",
   "hud-top",
   "hud-bottom",
-  "hud-left",
-  "hud-right",
   "floating"
 ];
 var DEFAULT_SLOTS = ALL_SLOTS.reduce(
@@ -1040,10 +1036,6 @@ var DEFAULT_SOURCES = ALL_SLOTS.reduce(
   },
   {}
 );
-var idCounter = 0;
-function generateId() {
-  return `slot-content-${++idCounter}-${Date.now()}`;
-}
 function aggregateSlot(sources) {
   if (!sources) return null;
   const entries = Object.entries(sources);
@@ -1120,8 +1112,8 @@ function useUISlotManager() {
   }, []);
   const render = useCallback(
     (config) => {
-      const id = generateId();
       const sourceKey = config.sourceTrait ?? DEFAULT_SOURCE_KEY;
+      const id = `slot-content-${config.target}-${sourceKey}`;
       const content = {
         id,
         pattern: config.pattern,
@@ -1137,10 +1129,12 @@ function useUISlotManager() {
       };
       if (config.autoDismissMs && config.autoDismissMs > 0) {
         content.autoDismissAt = Date.now() + config.autoDismissMs;
+        const prevTimer = timersRef.current.get(id);
+        if (prevTimer) clearTimeout(prevTimer);
         const timer = setTimeout(() => {
           setSources((prev) => {
             const slotSources = prev[config.target];
-            if (slotSources && slotSources[sourceKey]?.id === id) {
+            if (slotSources && slotSources[sourceKey] === content) {
               content.onDismiss?.();
               const next = { ...slotSources };
               delete next[sourceKey];
@@ -1293,7 +1287,7 @@ function useUISlotManager() {
     });
     traitIndexRef.current.clear();
   }, [notifySubscribers, notifyTraitSubscribers]);
-  const subscribe2 = useCallback((callback) => {
+  const subscribe = useCallback((callback) => {
     subscribersRef.current.add(callback);
     return () => {
       subscribersRef.current.delete(callback);
@@ -1304,7 +1298,7 @@ function useUISlotManager() {
     [slots]
   );
   const getContent = useCallback(
-    (slot) => slots[slot],
+    (slot) => slots[slot] ?? null,
     [slots]
   );
   const getTraitContent = useCallback(
@@ -1332,7 +1326,7 @@ function useUISlotManager() {
   );
   const updateTraitContent = useCallback(
     (traitName, content) => {
-      const id = generateId();
+      const id = `slot-content-trait-${traitName}`;
       const fullContent = { ...content, id, sourceTrait: traitName };
       indexTraitRender(traitName, fullContent);
       notifyTraitSubscribers(traitName, fullContent);
@@ -1347,7 +1341,7 @@ function useUISlotManager() {
     clearBySource,
     clearById,
     clearAll,
-    subscribe: subscribe2,
+    subscribe,
     hasContent,
     getContent,
     getTraitContent,
@@ -1476,117 +1470,6 @@ function parseQueryBinding(binding) {
   };
 }
 
-// stores/entityStore.ts
-var entities = /* @__PURE__ */ new Map();
-var listeners = /* @__PURE__ */ new Set();
-var idCounter2 = 0;
-function subscribe(listener) {
-  listeners.add(listener);
-  return () => listeners.delete(listener);
-}
-function notify() {
-  listeners.forEach((listener) => listener());
-}
-function getEntity(id) {
-  return entities.get(id);
-}
-function getByType(type) {
-  const types = Array.isArray(type) ? type : [type];
-  return [...entities.values()].filter((e) => types.includes(e.type));
-}
-function getAllEntities() {
-  return [...entities.values()];
-}
-function getSingleton(type) {
-  return [...entities.values()].find((e) => e.type === type);
-}
-function spawnEntity(config) {
-  const id = config.id ?? `entity_${++idCounter2}`;
-  const entity = { ...config, id };
-  entities = new Map(entities);
-  entities.set(id, entity);
-  notify();
-  return id;
-}
-function updateEntity(id, updates) {
-  const entity = entities.get(id);
-  if (entity) {
-    entities = new Map(entities);
-    entities.set(id, { ...entity, ...updates });
-    notify();
-  }
-}
-function updateSingleton(type, updates) {
-  const entity = getSingleton(type);
-  if (entity) {
-    updateEntity(entity.id, updates);
-  }
-}
-function removeEntity(id) {
-  if (entities.has(id)) {
-    entities = new Map(entities);
-    entities.delete(id);
-    notify();
-  }
-}
-function clearEntities() {
-  entities = /* @__PURE__ */ new Map();
-  notify();
-}
-function getSnapshot() {
-  return entities;
-}
-
-// hooks/useEntities.ts
-function useEntities() {
-  const entities2 = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
-  return {
-    entities: entities2,
-    getEntity,
-    getByType,
-    getAllEntities,
-    getSingleton,
-    spawnEntity,
-    updateEntity,
-    updateSingleton,
-    removeEntity,
-    clearEntities
-  };
-}
-function useEntity(id) {
-  const entities2 = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
-  return entities2.get(id);
-}
-function useEntitiesByType(type) {
-  const entities2 = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
-  return [...entities2.values()].filter((e) => e.type === type);
-}
-function useSingletonEntity(type) {
-  const entities2 = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
-  return [...entities2.values()].find((e) => e.type === type);
-}
-function usePlayer() {
-  const player = useSingletonEntity("Player");
-  const update = useCallback((updates) => {
-    if (player) updateEntity(player.id, updates);
-  }, [player?.id]);
-  return { player, updatePlayer: update };
-}
-function usePhysics() {
-  const physics = useSingletonEntity("Physics");
-  const update = useCallback((updates) => {
-    if (physics) updateEntity(physics.id, updates);
-  }, [physics?.id]);
-  return { physics, updatePhysics: update };
-}
-function useInput() {
-  const input = useSingletonEntity("Input");
-  const update = useCallback((updates) => {
-    if (input) updateEntity(input.id, updates);
-  }, [input?.id]);
-  return { input, updateInput: update };
-}
-
 // locales/en.json
 var en_default = {
   $meta: {
@@ -2471,49 +2354,6 @@ function usePullToRefresh(onRefresh, options = {}) {
     endRefresh
   };
 }
-function getDistance(touches) {
-  const dx = touches[0].clientX - touches[1].clientX;
-  const dy = touches[0].clientY - touches[1].clientY;
-  return Math.sqrt(dx * dx + dy * dy);
-}
-function usePinchZoom(options = {}) {
-  const { minScale = 0.5, maxScale = 4 } = options;
-  const [scale, setScale] = useState(1);
-  const [isPinching, setIsPinching] = useState(false);
-  const initialDistance = useRef(0);
-  const initialScale = useRef(1);
-  const onTouchStart = useCallback((e) => {
-    if (e.touches.length === 2) {
-      initialDistance.current = getDistance(e.touches);
-      initialScale.current = scale;
-      setIsPinching(true);
-    }
-  }, [scale]);
-  const onTouchMove = useCallback((e) => {
-    if (e.touches.length !== 2 || !isPinching) return;
-    e.preventDefault();
-    const currentDistance = getDistance(e.touches);
-    const ratio = currentDistance / initialDistance.current;
-    const newScale = Math.min(maxScale, Math.max(minScale, initialScale.current * ratio));
-    setScale(newScale);
-  }, [isPinching, minScale, maxScale]);
-  const onTouchEnd = useCallback(() => {
-    setIsPinching(false);
-  }, []);
-  const resetZoom = useCallback(() => {
-    setScale(1);
-  }, []);
-  return {
-    scale,
-    isPinching,
-    gestureProps: {
-      onTouchStart,
-      onTouchMove,
-      onTouchEnd
-    },
-    resetZoom
-  };
-}
 function localPoint(canvas, clientX, clientY) {
   if (!canvas) return { x: clientX, y: clientY };
   const rect = canvas.getBoundingClientRect();
@@ -2757,9 +2597,9 @@ function useRenderInterpolation(options = {}) {
   const prevRef = useRef(null);
   const currRef = useRef(null);
   const rafRef = useRef(null);
-  const onSnapshot = useCallback((entities2) => {
+  const onSnapshot = useCallback((entities) => {
     prevRef.current = currRef.current;
-    currRef.current = { entities: entities2, arrivedAt: performance.now() };
+    currRef.current = { entities, arrivedAt: performance.now() };
   }, []);
   const getInterpolated = useCallback((now) => {
     const out = /* @__PURE__ */ new Map();
@@ -2819,99 +2659,6 @@ function useRenderInterpolation(options = {}) {
   }, []);
   return { onSnapshot, getInterpolated, startLoop };
 }
-var EMPTY_STATE = {
-  activities: [],
-  subagents: [],
-  coordinatorMessages: [],
-  status: "idle"
-};
-function upsertSubagent(subagents, id, patch) {
-  const idx = subagents.findIndex((s) => s.id === id);
-  if (idx === -1) {
-    const next = {
-      id,
-      name: patch.name ?? id,
-      role: patch.role ?? "",
-      status: patch.status ?? "running",
-      task: patch.task ?? "",
-      messages: []
-    };
-    if (patch.orbitalName !== void 0) next.orbitalName = patch.orbitalName;
-    if (patch.parentId !== void 0) next.parentId = patch.parentId;
-    if (patch.durationMs !== void 0) next.durationMs = patch.durationMs;
-    return [...subagents, next];
-  }
-  const merged = { ...subagents[idx] };
-  if (patch.name !== void 0) merged.name = patch.name;
-  if (patch.role !== void 0) merged.role = patch.role;
-  if (patch.orbitalName !== void 0) merged.orbitalName = patch.orbitalName;
-  if (patch.parentId !== void 0) merged.parentId = patch.parentId;
-  if (patch.status !== void 0) merged.status = patch.status;
-  if (patch.task !== void 0) merged.task = patch.task;
-  if (patch.durationMs !== void 0) merged.durationMs = patch.durationMs;
-  const out = subagents.slice();
-  out[idx] = merged;
-  return out;
-}
-function appendSubagentMessage(subagents, id, message) {
-  const idx = subagents.findIndex((s) => s.id === id);
-  if (idx === -1) return subagents;
-  const out = subagents.slice();
-  out[idx] = { ...out[idx], messages: [...out[idx].messages, message] };
-  return out;
-}
-function setCoordinatorMessage(messages, index, message) {
-  if (index < messages.length) {
-    const out = messages.slice();
-    out[index] = message;
-    return out;
-  }
-  return [...messages, message];
-}
-function reduce(state, update) {
-  switch (update.kind) {
-    case "activity":
-      return { ...state, activities: [...state.activities, update.activity] };
-    case "subagent-upsert":
-      return { ...state, subagents: upsertSubagent(state.subagents, update.id, update.subagent) };
-    case "subagent-message":
-      return { ...state, subagents: appendSubagentMessage(state.subagents, update.id, update.message) };
-    case "coordinator-message":
-      return {
-        ...state,
-        coordinatorMessages: setCoordinatorMessage(state.coordinatorMessages, update.index, update.message)
-      };
-    case "status":
-      return { ...state, status: update.status };
-    case "reset":
-      return EMPTY_STATE;
-  }
-}
-function traceReducer(state, action) {
-  if (action.type === "apply") return reduce(state, action.update);
-  return action.updates.reduce(reduce, state);
-}
-function useAgentTrace() {
-  const [state, dispatch] = useReducer(traceReducer, EMPTY_STATE);
-  const apply = useCallback((update) => {
-    dispatch({ type: "apply", update });
-  }, []);
-  const applyAll = useCallback((updates) => {
-    dispatch({ type: "applyAll", updates });
-  }, []);
-  const reset = useCallback(() => {
-    dispatch({ type: "apply", update: { kind: "reset" } });
-  }, []);
-  return {
-    activities: state.activities,
-    subagents: state.subagents,
-    coordinatorMessages: state.coordinatorMessages,
-    status: state.status,
-    apply,
-    applyAll,
-    reset
-  };
-}
 var API_BASE = typeof process !== "undefined" && process.env?.VITE_API_URL ? process.env.VITE_API_URL : "http://localhost:3000";
 function getUserId() {
   return localStorage.getItem("userId") || "anonymous";
@@ -2988,4 +2735,4 @@ function useGitHubBranches(owner, repo, enabled = true) {
   });
 }
 
-export { ALMADAR_DND_MIME, DEFAULT_SLOTS, I18nProvider, clearEntities, createTranslate, getAllEntities, getByType, getEntity, getSingleton, parseQueryBinding, removeEntity, spawnEntity, updateEntity, updateSingleton, useAgentChat, useAgentTrace, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEntities, useEntitiesByType, useEntity as useEntityById, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useInput, useLongPress, useOrbitalHistory, usePhysics, usePinchZoom, usePlayer, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSingletonEntity, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useUISlotManager, useValidation };
+export { ALMADAR_DND_MIME, DEFAULT_SLOTS, I18nProvider, createTranslate, parseQueryBinding, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useUISlotManager, useValidation };

package/dist/hooks/useAgentChat.d.ts

@@ -1,4 +1,5 @@
 import type { DeepAgentInterrupt } from './useDeepAgentGeneration';
+import type { FieldValue, OrbitalSchema } from '@almadar/core';
 export interface ChatMessage {
     id: string;
     role: 'user' | 'assistant' | 'system';
@@ -16,13 +17,13 @@ export type Activity = {
 } | {
     type: 'tool_call';
     tool: string;
-    args: Record<string, unknown>;
+    args: Record<string, FieldValue>;
     timestamp: number;
     isExecuting?: boolean;
 } | {
     type: 'tool_result';
     tool: string;
-    result: unknown;
+    result: FieldValue | null;
     success: boolean;
     timestamp: number;
 } | {
@@ -79,8 +80,8 @@ export interface SchemaDiff {
 export type AgentStatus = 'idle' | 'running' | 'complete' | 'error' | 'interrupted';
 export interface UseAgentChatOptions {
     appId?: string;
-    onComplete?: (schema?: unknown) => void;
-    onSchemaChange?: (diff?: unknown) => void;
+    onComplete?: (schema?: OrbitalSchema) => void;
+    onSchemaChange?: (diff?: OrbitalSchema) => void;
     onError?: (error: Error | string) => void;
 }
 export interface UseAgentChatResult {
@@ -94,9 +95,9 @@ export interface UseAgentChatResult {
     threadId: string | null;
     interrupt: DeepAgentInterrupt | null;
     sendMessage: (content: string) => Promise<void>;
-    startGeneration: (skill: string | string[], prompt: string, options?: Record<string, unknown>) => Promise<void>;
+    startGeneration: (skill: string | string[], prompt: string, options?: Record<string, FieldValue>) => Promise<void>;
     continueConversation: (message: string | string[]) => Promise<void>;
-    resumeWithDecision: (decisions: unknown[]) => Promise<void>;
+    resumeWithDecision: (decisions: FieldValue[]) => Promise<void>;
     cancel: () => void;
     clearMessages: () => void;
     clearHistory: () => void;

package/dist/{renderer → hooks}/useClientEffects.d.ts

@@ -1,4 +1,4 @@
-import type { ClientEffect, ClientEffectExecutorConfig } from './types';
+import type { ClientEffect, ClientEffectExecutorConfig } from '../types/renderer-types';
 /**
  * Options for the useClientEffects hook
  */

package/dist/hooks/useCompile.d.ts

@@ -1,8 +1,4 @@
-export interface SchemaLike {
-    name: string;
-    version?: string;
-    [key: string]: unknown;
-}
+import type { OrbitalSchema } from '@almadar/core';
 export type CompileStage = 'idle' | 'compiling' | 'done' | 'error';
 export interface CompileResult {
     success: boolean;
@@ -17,6 +13,6 @@ export interface UseCompileResult {
     stage: CompileStage;
     lastResult: CompileResult | null;
     error: string | null;
-    compileSchema: (schema: SchemaLike) => Promise<CompileResult | null>;
+    compileSchema: (schema: OrbitalSchema) => Promise<CompileResult | null>;
 }
 export declare function useCompile(): UseCompileResult;

package/dist/hooks/useDeepAgentGeneration.d.ts

@@ -1,9 +1,9 @@
-import type { OrbitalSchema } from '@almadar/core';
+import type { OrbitalSchema, FieldValue } from '@almadar/core';
 export interface DeepAgentActionRequest {
     id: string;
     type: string;
     tool: string;
-    args: Record<string, unknown>;
+    args: Record<string, FieldValue>;
     description?: string;
     allowedDecisions: ('approve' | 'edit' | 'reject')[];
     status: 'pending' | 'approved' | 'rejected' | 'edited';
@@ -38,9 +38,9 @@ export interface UseDeepAgentGenerationResult {
     error: string | null;
     interrupt: DeepAgentInterrupt | null;
     generate: (prompt: string) => Promise<OrbitalSchema | null>;
-    startGeneration: (skill: string, prompt: string, options?: Record<string, unknown>) => Promise<void>;
+    startGeneration: (skill: string, prompt: string, options?: Record<string, FieldValue>) => Promise<void>;
     cancelGeneration: () => void;
     clearRequests: () => void;
-    submitInterruptDecisions: (decisions: unknown[]) => void;
+    submitInterruptDecisions: (decisions: FieldValue[]) => void;
 }
 export declare function useDeepAgentGeneration(): UseDeepAgentGenerationResult;

package/dist/hooks/useEventBus.d.ts

@@ -1,6 +1,8 @@
-import type { BusEvent, BusEventSource, EventListener, Unsubscribe, EventBusContextType } from './event-bus-types';
+import type { BusEvent, BusEventSource, BusEventListener, Unsubscribe, EventBusContextType } from '../types/event-bus-types';
 import type { EventPayload } from '@almadar/core';
-export type { BusEvent, BusEventSource, EventListener, Unsubscribe, EventBusContextType };
+export type { BusEvent, BusEventSource, BusEventListener, Unsubscribe, EventBusContextType };
+/** @deprecated Use BusEventListener from @almadar/core. */
+export type { BusEventListener as EventListener };
 declare global {
     interface Window {
         __kflowEventBus?: EventBusContextType | null;
@@ -73,7 +75,7 @@ export declare function useEventBus(): EventBusContextType;
  * });
  * ```
  */
-export declare function useEventListener(event: string, handler: EventListener): void;
+export declare function useEventListener(event: string, handler: BusEventListener): void;
 /**
  * Alias for useEventListener for backward compatibility
  */

package/dist/hooks/useFileSystem.d.ts

@@ -1,3 +1,12 @@
+interface FileSystemTree {
+    [name: string]: {
+        file: {
+            contents: string;
+        };
+    } | {
+        directory: FileSystemTree;
+    };
+}
 export interface FileNode {
     path: string;
     name: string;
@@ -24,7 +33,7 @@ export interface UseFileSystemResult {
     selectedPath: string | null;
     previewUrl: string | null;
     boot: () => Promise<void>;
-    mountFiles: (files: FileSystemFile[] | Record<string, unknown>) => Promise<void>;
+    mountFiles: (files: FileSystemFile[] | FileSystemTree) => Promise<void>;
     readFile: (path: string) => Promise<string>;
     writeFile: (path: string, content: string) => Promise<void>;
     selectFile: (path: string) => Promise<void>;
@@ -38,3 +47,4 @@ export interface UseFileSystemResult {
     startDevServer: () => Promise<void>;
 }
 export declare function useFileSystem(): UseFileSystemResult;
+export {};

package/dist/hooks/useOrbitalHistory.d.ts

@@ -1,5 +1,5 @@
 import type { OrbitalSchema } from '@almadar/core';
-export interface ChangeSummary {
+export interface HistoryChangeSummary {
     added: number;
     modified: number;
     removed: number;
@@ -11,7 +11,7 @@ export interface HistoryTimelineItem {
     timestamp: number;
     description: string;
     source?: string;
-    summary?: ChangeSummary;
+    summary?: HistoryChangeSummary;
     reason?: string;
 }
 export interface RevertResult {

package/dist/hooks/useQuerySingleton.d.ts

@@ -1,9 +1,10 @@
+import type { FieldValue } from '@almadar/core';
 /**
  * Query state for filters and search
  */
 export interface QueryState {
     search?: string;
-    filters?: Record<string, unknown>;
+    filters?: Record<string, FieldValue>;
     sortField?: string;
     sortDirection?: 'asc' | 'desc';
 }
@@ -12,7 +13,7 @@ export interface QueryState {
  */
 export interface QuerySingletonEntity {
     name: string;
-    fields: Record<string, unknown>;
+    fields: Record<string, FieldValue>;
 }
 /**
  * Query singleton result type
@@ -28,9 +29,9 @@ export interface QuerySingletonState {
     /** Set search term */
     setSearch: (value: string) => void;
     /** Current filters */
-    filters: Record<string, unknown>;
+    filters: Record<string, FieldValue>;
     /** Set a filter value */
-    setFilter: (key: string, value: unknown) => void;
+    setFilter: (key: string, value: FieldValue) => void;
     /** Clear all filters */
     clearFilters: () => void;
     /** Current sort field */

package/dist/{runtime → hooks}/useResolvedSchema.d.ts

@@ -12,7 +12,7 @@
  * @packageDocumentation
  */
 import type { OrbitalSchema } from '@almadar/core';
-import type { ResolvedIR, ResolvedPage, ResolvedTrait, ResolvedEntity, ResolvedTraitBinding } from './types';
+import type { ResolvedIR, ResolvedPage, ResolvedTrait, ResolvedEntity, ResolvedTraitBinding } from '../types/runtime-types';
 export interface ResolvedSchemaResult {
     /** The resolved page (or undefined if not found) */
     page: ResolvedPage | undefined;

package/dist/{runtime → hooks}/useTraitStateMachine.d.ts

@@ -16,10 +16,10 @@
  *
  * @packageDocumentation
  */
-import type { EventPayload } from '@almadar/core';
+import type { EventPayload, ServiceParams } from '@almadar/core';
 import { type TraitState } from '@almadar/runtime';
-import type { ResolvedTraitBinding } from './types';
-import type { useUISlots } from '../context/UISlotContext';
+import type { ResolvedTraitBinding } from '../types/runtime-types';
+import type { useUISlots } from '../providers/UISlotContext';
 export type { TraitState };
 export interface TraitStateMachineResult {
     /** Current state for each trait */
@@ -45,7 +45,7 @@ export interface UseTraitStateMachineOptions {
      */
     onEventProcessed?: (eventKey: string, payload?: EventPayload, dispatchedOrbitals?: Set<string>) => void | Promise<void>;
     /** Router navigate function for navigate effects */
-    navigate?: (path: string, params?: Record<string, unknown>) => void;
+    navigate?: (path: string, params?: Record<string, string>) => void;
     /** Notification function for notify effects */
     notify?: (message: string, type?: 'success' | 'error' | 'warning' | 'info') => void;
     /**
@@ -58,7 +58,7 @@ export interface UseTraitStateMachineOptions {
      */
     persistence?: import('@almadar/runtime').PersistenceAdapter;
     /** Optional consumer `call-service` hook forwarded to the mock server handlers. */
-    callService?: (service: string, action: string, params: unknown) => Promise<unknown>;
+    callService?: (service: string, action: string, params?: ServiceParams) => Promise<EventPayload>;
     /**
      * Trait configs keyed by trait name. Threaded into setTraitConfig so
      * `@config.X` resolves inside guard expressions on the client. Page-level

package/dist/hooks/useUISlots.d.ts

@@ -30,11 +30,8 @@
  * @packageDocumentation
  */
 import type React from 'react';
-import type { EventPayloadValue, RenderItemLambda } from '@almadar/core';
-/**
- * Valid UI slot names
- */
-export type UISlot = 'main' | 'sidebar' | 'modal' | 'drawer' | 'overlay' | 'center' | 'toast' | 'hud-top' | 'hud-bottom' | 'hud-left' | 'hud-right' | 'floating';
+import type { EventPayloadValue, RenderItemLambda, UISlot } from '@almadar/core';
+export type { UISlot };
 /**
  * Animation types for slot transitions
  */
@@ -95,7 +92,7 @@ export interface SlotContent {
     sourceTrait?: string;
     /** Stable node ID from the schema pattern tree (for edit mode overlay targeting) */
     nodeId?: string;
-    /** Slot this content was rendered into (= RenderUIConfig.target) — contextual-edit address. */
+    /** Slot this content was rendered into (= SlotRenderConfig.target) — contextual-edit address. */
     slot?: string;
     /** Transition event key that produced this render (raw, as fired). */
     transitionEvent?: string;
@@ -107,7 +104,7 @@ export interface SlotContent {
 /**
  * Configuration for render_ui effect
  */
-export interface RenderUIConfig {
+export interface SlotRenderConfig {
     /** Target slot */
     target: UISlot;
     /** Pattern/component to render */
@@ -156,9 +153,9 @@ export interface UISlotManager {
      * pattern configs in insertion order. Single consumers can continue
      * to read `slots[slot]` without knowing the slot is multi-source.
      */
-    slots: Record<UISlot, SlotContent | null>;
+    slots: Partial<Record<UISlot, SlotContent | null>>;
     /** Render content to a slot */
-    render: (config: RenderUIConfig) => string;
+    render: (config: SlotRenderConfig) => string;
     /** Clear all source entries from a slot */
     clear: (slot: UISlot) => void;
     /** Clear a single source's contribution from a slot, keeping others */
@@ -206,7 +203,7 @@ export interface UISlotManager {
      */
     updateTraitContent: (traitName: string, content: Omit<SlotContent, 'id' | 'sourceTrait'>) => string;
 }
-declare const DEFAULT_SLOTS: Record<UISlot, SlotContent | null>;
+declare const DEFAULT_SLOTS: Partial<Record<UISlot, SlotContent | null>>;
 /**
  * Create a UI Slot Manager instance.
  *