@almadar/ui 2.42.0 → 2.43.0

package/dist/hooks/index.cjs

@@ -2460,6 +2460,98 @@ function usePinchZoom(options = {}) {
     resetZoom
   };
 }
+var ALMADAR_DND_MIME = "application/x-almadar-dnd";
+function useDraggable({ payload, disabled = false }) {
+  const [isDragging, setIsDragging] = React2.useState(false);
+  const eventBus = useEventBus();
+  const handleDragStart = React2.useCallback(
+    (e) => {
+      if (disabled) {
+        e.preventDefault();
+        return;
+      }
+      e.dataTransfer.setData(ALMADAR_DND_MIME, JSON.stringify(payload));
+      e.dataTransfer.effectAllowed = "copy";
+      setIsDragging(true);
+      eventBus.emit("UI:DRAG_START", { kind: payload.kind, data: payload.data });
+    },
+    [disabled, payload, eventBus]
+  );
+  const handleDragEnd = React2.useCallback(
+    (e) => {
+      setIsDragging(false);
+      eventBus.emit("UI:DRAG_END", { kind: payload.kind, data: payload.data });
+    },
+    [payload, eventBus]
+  );
+  const dragProps = React2.useMemo(
+    () => ({
+      draggable: !disabled,
+      onDragStart: handleDragStart,
+      onDragEnd: handleDragEnd,
+      "aria-grabbed": isDragging
+    }),
+    [disabled, handleDragStart, handleDragEnd, isDragging]
+  );
+  return { dragProps, isDragging };
+}
+function parsePayload(e) {
+  try {
+    const raw = e.dataTransfer.getData(ALMADAR_DND_MIME);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.kind !== "string" || !parsed.data) return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function hasAlmadarPayload(e) {
+  return e.dataTransfer.types.includes(ALMADAR_DND_MIME);
+}
+function useDropZone({ accepts, onDrop, disabled = false }) {
+  const [isOver, setIsOver] = React2.useState(false);
+  const eventBus = useEventBus();
+  const handleDragOver = React2.useCallback(
+    (e) => {
+      if (disabled) return;
+      if (!hasAlmadarPayload(e)) return;
+      e.preventDefault();
+      e.dataTransfer.dropEffect = "copy";
+      setIsOver(true);
+    },
+    [disabled]
+  );
+  const handleDragLeave = React2.useCallback(
+    (e) => {
+      setIsOver(false);
+    },
+    []
+  );
+  const handleDrop = React2.useCallback(
+    (e) => {
+      e.preventDefault();
+      setIsOver(false);
+      if (disabled) return;
+      const payload = parsePayload(e);
+      if (!payload) return;
+      if (!accepts.includes(payload.kind)) return;
+      const position = { x: e.clientX, y: e.clientY };
+      onDrop(payload, position);
+      eventBus.emit("UI:DROP", { kind: payload.kind, data: payload.data, ...position });
+    },
+    [disabled, accepts, onDrop, eventBus]
+  );
+  const dropProps = React2.useMemo(
+    () => ({
+      onDragOver: handleDragOver,
+      onDragLeave: handleDragLeave,
+      onDrop: handleDrop
+    }),
+    [handleDragOver, handleDragLeave, handleDrop]
+  );
+  return { dropProps, isOver };
+}
 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";
@@ -2536,6 +2628,7 @@ function useGitHubBranches(owner, repo, enabled = true) {
   });
 }
 
+exports.ALMADAR_DND_MIME = ALMADAR_DND_MIME;
 exports.DEFAULT_SLOTS = DEFAULT_SLOTS;
 exports.ENTITY_EVENTS = ENTITY_EVENTS;
 exports.EntityDataProvider = EntityDataProvider;
@@ -2561,6 +2654,8 @@ exports.useDeepAgentGeneration = useDeepAgentGeneration;
 exports.useDeleteEntity = useDeleteEntity;
 exports.useDisconnectGitHub = useDisconnectGitHub;
 exports.useDragReorder = useDragReorder;
+exports.useDraggable = useDraggable;
+exports.useDropZone = useDropZone;
 exports.useEmitEvent = useEmitEvent;
 exports.useEntities = useEntities;
 exports.useEntitiesByType = useEntitiesByType;

package/dist/hooks/index.d.ts

@@ -28,4 +28,6 @@ export { useDragReorder, type DragReorderResult, } from './useDragReorder';
 export { useInfiniteScroll, type InfiniteScrollOptions, type InfiniteScrollResult, } from './useInfiniteScroll';
 export { usePullToRefresh, type PullToRefreshOptions, type PullToRefreshResult, } from './usePullToRefresh';
 export { usePinchZoom, type PinchZoomOptions, type PinchZoomResult, } from './usePinchZoom';
+export { useDraggable, ALMADAR_DND_MIME, type DraggablePayload, type UseDraggableOptions, type UseDraggableResult, } from './useDraggable';
+export { useDropZone, type UseDropZoneOptions, type UseDropZoneResult, } from './useDropZone';
 export { useGitHubStatus, useConnectGitHub, useDisconnectGitHub, useGitHubRepos, useGitHubRepo, useGitHubBranches, type GitHubStatus, type GitHubRepo, } from './useGitHub';

package/dist/hooks/index.js

@@ -2454,6 +2454,98 @@ function usePinchZoom(options = {}) {
     resetZoom
   };
 }
+var ALMADAR_DND_MIME = "application/x-almadar-dnd";
+function useDraggable({ payload, disabled = false }) {
+  const [isDragging, setIsDragging] = useState(false);
+  const eventBus = useEventBus();
+  const handleDragStart = useCallback(
+    (e) => {
+      if (disabled) {
+        e.preventDefault();
+        return;
+      }
+      e.dataTransfer.setData(ALMADAR_DND_MIME, JSON.stringify(payload));
+      e.dataTransfer.effectAllowed = "copy";
+      setIsDragging(true);
+      eventBus.emit("UI:DRAG_START", { kind: payload.kind, data: payload.data });
+    },
+    [disabled, payload, eventBus]
+  );
+  const handleDragEnd = useCallback(
+    (e) => {
+      setIsDragging(false);
+      eventBus.emit("UI:DRAG_END", { kind: payload.kind, data: payload.data });
+    },
+    [payload, eventBus]
+  );
+  const dragProps = useMemo(
+    () => ({
+      draggable: !disabled,
+      onDragStart: handleDragStart,
+      onDragEnd: handleDragEnd,
+      "aria-grabbed": isDragging
+    }),
+    [disabled, handleDragStart, handleDragEnd, isDragging]
+  );
+  return { dragProps, isDragging };
+}
+function parsePayload(e) {
+  try {
+    const raw = e.dataTransfer.getData(ALMADAR_DND_MIME);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.kind !== "string" || !parsed.data) return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function hasAlmadarPayload(e) {
+  return e.dataTransfer.types.includes(ALMADAR_DND_MIME);
+}
+function useDropZone({ accepts, onDrop, disabled = false }) {
+  const [isOver, setIsOver] = useState(false);
+  const eventBus = useEventBus();
+  const handleDragOver = useCallback(
+    (e) => {
+      if (disabled) return;
+      if (!hasAlmadarPayload(e)) return;
+      e.preventDefault();
+      e.dataTransfer.dropEffect = "copy";
+      setIsOver(true);
+    },
+    [disabled]
+  );
+  const handleDragLeave = useCallback(
+    (e) => {
+      setIsOver(false);
+    },
+    []
+  );
+  const handleDrop = useCallback(
+    (e) => {
+      e.preventDefault();
+      setIsOver(false);
+      if (disabled) return;
+      const payload = parsePayload(e);
+      if (!payload) return;
+      if (!accepts.includes(payload.kind)) return;
+      const position = { x: e.clientX, y: e.clientY };
+      onDrop(payload, position);
+      eventBus.emit("UI:DROP", { kind: payload.kind, data: payload.data, ...position });
+    },
+    [disabled, accepts, onDrop, eventBus]
+  );
+  const dropProps = useMemo(
+    () => ({
+      onDragOver: handleDragOver,
+      onDragLeave: handleDragLeave,
+      onDrop: handleDrop
+    }),
+    [handleDragOver, handleDragLeave, handleDrop]
+  );
+  return { dropProps, isOver };
+}
 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";
@@ -2530,4 +2622,4 @@ function useGitHubBranches(owner, repo, enabled = true) {
   });
 }
 
-export { DEFAULT_SLOTS, ENTITY_EVENTS, EntityDataProvider, I18nProvider, 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, useEntity2 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, useUISlotManager, useUpdateEntity, useValidation };
+export { ALMADAR_DND_MIME, DEFAULT_SLOTS, ENTITY_EVENTS, EntityDataProvider, I18nProvider, clearEntities, createTranslate, entityDataKeys, getAllEntities, getByType, getEntity, getSingleton, parseQueryBinding, removeEntity, spawnEntity, updateEntity, updateSingleton, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useCreateEntity, useDeepAgentGeneration, useDeleteEntity, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEntities, useEntitiesByType, useEntity, useEntity2 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, useUISlotManager, useUpdateEntity, useValidation };

package/dist/hooks/useDraggable.d.ts

@@ -0,0 +1,24 @@
+/** Discriminated payload carried by every drag operation. */
+export interface DraggablePayload {
+    kind: 'pattern' | 'behavior' | 'tree-node' | 'event-wire';
+    data: Record<string, unknown>;
+}
+export interface UseDraggableOptions {
+    /** The payload that will be serialised into dataTransfer. */
+    payload: DraggablePayload;
+    /** When true the element cannot be dragged. */
+    disabled?: boolean;
+}
+export interface UseDraggableResult {
+    /** Spread these onto the draggable element. */
+    dragProps: {
+        draggable: boolean;
+        onDragStart: (e: React.DragEvent) => void;
+        onDragEnd: (e: React.DragEvent) => void;
+        'aria-grabbed': boolean;
+    };
+    /** True while the element is being dragged. */
+    isDragging: boolean;
+}
+export declare const ALMADAR_DND_MIME = "application/x-almadar-dnd";
+export declare function useDraggable({ payload, disabled }: UseDraggableOptions): UseDraggableResult;

package/dist/hooks/useDropZone.d.ts

@@ -0,0 +1,23 @@
+import { type DraggablePayload } from './useDraggable';
+export interface UseDropZoneOptions {
+    /** Which payload kinds this zone accepts. */
+    accepts: DraggablePayload['kind'][];
+    /** Called when a valid payload is dropped. */
+    onDrop: (payload: DraggablePayload, position: {
+        x: number;
+        y: number;
+    }) => void;
+    /** When true the zone rejects all drops. */
+    disabled?: boolean;
+}
+export interface UseDropZoneResult {
+    /** Spread these onto the drop-target element. */
+    dropProps: {
+        onDragOver: (e: React.DragEvent) => void;
+        onDragLeave: (e: React.DragEvent) => void;
+        onDrop: (e: React.DragEvent) => void;
+    };
+    /** True while a valid drag payload is hovering over this zone. */
+    isOver: boolean;
+}
+export declare function useDropZone({ accepts, onDrop, disabled }: UseDropZoneOptions): UseDropZoneResult;

package/dist/providers/EntityStoreProvider.d.ts

@@ -1,13 +1,15 @@
 /**
  * EntityStoreProvider
  *
- * Reactive entity store for Orbital applications. Holds per-entity-type snapshots.
- * When `advance()` is called (after a persist/set/swap!/atomic response from the server),
- * all `useEntityRef` subscribers for that entity type re-render with fresh data.
- * `useEntityWatch` callbacks fire for side effects (toasts, cross-orbital emits).
+ * Normalized reactive entity store for Orbital applications.
+ * Stores entities in ID-keyed Maps with ordered ID lists.
+ * Provides operation-specific methods (setAll, upsertOne, addOne,
+ * updateOne, removeOne) and selector hooks (useEntityRef for
+ * collections, useEntityById for single entities).
  *
- * This is the client-side half of the `ref` operator. The server-side half is the
- * initial DB query and auto-fetch-after-mutation in the generated handler / runtime.
+ * Every mutation creates new Map/array objects (immutable values).
+ * Identity (the store key) advances to a new value on each write.
+ * Follows the Clojure epochal time model from Almadar_Orb_IO.md.
  *
  * @packageDocumentation
  */
@@ -16,26 +18,38 @@ type StoreListener = () => void;
 type WatchCallback = (oldData: unknown[], newData: unknown[]) => void;
 export declare function subscribeToStore(listener: StoreListener): () => void;
 /**
- * Subscribe to an entity type's data reactively.
- * Re-renders only when the data for this specific entity type changes.
+ * Subscribe to an entity collection reactively.
+ * Returns the full ordered array. Re-renders when the collection changes.
  *
- * This is the client-side implementation of the `["ref", "EntityType"]` operator.
+ * Client-side implementation of `["ref", "EntityType"]`.
  */
 export declare function useEntityRef(entityType: string): unknown[];
 /**
- * Register a callback that fires when an entity type's data changes.
+ * Subscribe to a single entity by ID reactively.
+ * Returns the entity record or null. Re-renders when the entity changes.
  *
- * This is the client-side implementation of the `["watch", "EntityType", effects]` operator.
- * The callback receives (oldData, newData) and should execute side effects (notify, emit, log).
+ * Client-side implementation of `["fetch", "EntityType", { id: ... }]`.
+ */
+export declare function useEntityById(entityType: string, id: string | undefined): Record<string, unknown> | null;
+/**
+ * Register a callback that fires when an entity collection changes.
+ * Receives (oldData, newData) for side effects (notify, emit, log).
+ *
+ * Client-side implementation of `["watch", "EntityType", effects]`.
  */
 export declare function useEntityWatch(entityType: string, callback: WatchCallback): void;
 export interface EntityStoreContextValue {
-    advance: (entityType: string, data: unknown[]) => void;
+    setAll: (entityType: string, records: unknown[]) => void;
+    upsertOne: (entityType: string, record: Record<string, unknown>) => void;
+    addOne: (entityType: string, record: Record<string, unknown>) => void;
+    updateOne: (entityType: string, id: string, changes: Partial<Record<string, unknown>>) => void;
+    removeOne: (entityType: string, id: string) => void;
     getSnapshot: (entityType: string) => unknown[];
+    getById: (entityType: string, id: string) => Record<string, unknown> | null;
 }
 export declare const EntityStoreContext: React.Context<EntityStoreContextValue>;
 /**
- * Access the entity store's advance function.
+ * Access the entity store operations.
  * Used by useOrbitalBridge and OrbPreview to push server response data into the store.
  */
 export declare function useEntityStore(): EntityStoreContextValue;