@almadar/ui 4.49.0 → 4.50.0

package/dist/components/molecules/DataGrid.d.ts

@@ -12,6 +12,7 @@
  */
 import React from 'react';
 import type { EntityRow, EventKey } from '@almadar/core';
+import { type DataDndProps } from './useDataDnd';
 export interface DataGridField {
     /** Entity field name (dot-notation supported) */
     name: string;
@@ -45,7 +46,7 @@ export interface DataGridItemAction {
     /** Button variant */
     variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
 }
-export interface DataGridProps<T extends EntityRow = EntityRow> {
+export interface DataGridProps<T extends EntityRow = EntityRow> extends DataDndProps {
     /**
      * Schema entity data — single record or collection, typed against
      * `@almadar/core`'s `EntityRow` so the narrow type declared on the
@@ -102,7 +103,7 @@ export interface DataGridProps<T extends EntityRow = EntityRow> {
     /** Max items to show before "Show More" button. Defaults to 0 (disabled). */
     pageSize?: number;
 }
-export declare function DataGrid<T extends EntityRow = EntityRow>({ entity, fields, columns, itemActions, cols, gap, minCardWidth, className, isLoading, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, }: DataGridProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function DataGrid<T extends EntityRow = EntityRow>({ entity, fields, columns, itemActions, cols, gap, minCardWidth, className, isLoading, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable, dropEvent, reorderEvent, dndItemIdField, }: DataGridProps<T>): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
 export declare namespace DataGrid {
     var displayName: string;
 }

package/dist/components/molecules/DataList.d.ts

@@ -12,6 +12,7 @@
  */
 import React from 'react';
 import type { EntityRow, EventKey } from "@almadar/core";
+import { type DataDndProps } from './useDataDnd';
 export interface DataListField {
     /** Entity field name (dot-notation supported) */
     name: string;
@@ -35,7 +36,7 @@ export interface DataListItemAction {
     /** Button variant */
     variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
 }
-export interface DataListProps<T extends EntityRow = EntityRow> {
+export interface DataListProps<T extends EntityRow = EntityRow> extends DataDndProps {
     /**
      * Schema entity data — single record or collection, typed against
      * `@almadar/core`'s `EntityRow` so the narrow type declared on the
@@ -116,7 +117,7 @@ export interface DataListProps<T extends EntityRow = EntityRow> {
     /** Max items to show before "Show More" button. Defaults to 5. Set to 0 to disable. */
     pageSize?: number;
 }
-export declare function DataList<T extends EntityRow = EntityRow>({ entity, fields, columns, itemActions, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, }: DataListProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function DataList<T extends EntityRow = EntityRow>({ entity, fields, columns, itemActions, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, dndItemIdField, }: DataListProps<T>): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
 export declare namespace DataList {
     var displayName: string;
 }

package/dist/components/molecules/useDataDnd.d.ts

@@ -0,0 +1,44 @@
+/**
+ * useDataDnd — shared drag-drop machinery for DataList + DataGrid.
+ *
+ * Both primitives expose six identical drag-drop props:
+ *   - dragGroup?:      string   items in this container announce this group when picked up
+ *   - accepts?:        string   this container accepts drops whose dragGroup matches (or "*" for any)
+ *   - sortable?:       boolean  enable in-container reorder
+ *   - dropEvent?:      EventKey bus event on cross-container drop: { id, sourceGroup, targetGroup, newIndex }
+ *   - reorderEvent?:   EventKey bus event on in-container reorder: { id, oldIndex, newIndex }
+ *   - dndItemIdField?: string   row field used as the @dnd-kit draggable id (default "id")
+ *
+ * Architecture
+ *   - A container that opts in via any dnd prop becomes a "zone".
+ *   - The first ancestor zone in the tree creates the DndContext (the "root").
+ *   - Inner zones detect the root via React context and skip creating their own.
+ *   - The root's onDragEnd reads source + target zone metadata off the dragged
+ *     item and the drop target, dispatches to the bus accordingly.
+ */
+import React from 'react';
+import { type UniqueIdentifier } from '@dnd-kit/core';
+import type { EntityRow, EventKey } from '@almadar/core';
+export interface DataDndProps {
+    dragGroup?: string;
+    accepts?: string;
+    sortable?: boolean;
+    dropEvent?: EventKey;
+    reorderEvent?: EventKey;
+    dndItemIdField?: string;
+}
+interface UseDataDndArgs<T extends EntityRow> extends DataDndProps {
+    items: readonly T[];
+    layout: 'list' | 'grid';
+}
+interface UseDataDndResult<T extends EntityRow> {
+    enabled: boolean;
+    wrapContainer: (children: React.ReactNode) => React.ReactNode;
+    SortableItem: React.FC<{
+        id: UniqueIdentifier;
+        children: React.ReactNode;
+    }>;
+    orderedItems: readonly T[];
+}
+export declare function useDataDnd<T extends EntityRow>(args: UseDataDndArgs<T>): UseDataDndResult<T>;
+export {};