lizaui 14.0.5 → 14.0.6

package/dist/table/index.d.ts

@@ -11,7 +11,30 @@ interface TableReorderEvent<TData = unknown> {
   };
   /** The full data array after applying the move; ready to store as the new order. */
   reorderedData: TData[];
+  /** Absolute position (`indexOffset` + page index) of the first moved row before the move. */
+  fromIndex: number;
+  /** Absolute position of the first moved row after the move. */
+  toIndex: number;
+  /** Every row of `data` in its new order with its absolute position, ready to persist. */
+  positions: TableRowPosition<TData>[];
 }
+/** A row and its absolute position (0-based, `indexOffset` included). */
+interface TableRowPosition<TData = unknown> {
+  key: string;
+  item: TData;
+  index: number;
+}
+/** Fired by "Mover a posición…" (`onMoveToPosition`): one row to an absolute position, possibly on another page. */
+interface TableMoveToPositionEvent<TData = unknown> {
+  key: string;
+  item: TData;
+  /** Absolute position (0-based) before the move. */
+  fromIndex: number;
+  /** Absolute position (0-based) requested, clamped to `0 … totalCount - 1`. */
+  toIndex: number;
+}
+/** What `onReorder` / `onMoveToPosition` may return: a promise turns on the optimistic, busy and rollback flow. */
+type TableReorderResult = void | Promise<unknown>;
 export interface TableKeyCurrent {
   id: string;
   name: string;
@@ -74,6 +97,12 @@ interface TableShareProps {
    * `sortDescriptor` is active, since the visual order is then derived.
    */
   isReorderable?: boolean;
+  /**
+   * Disables the handles without removing their column (no layout shift). A string is the reason,
+   * shown on hover and read by screen readers (e.g. "Quita la búsqueda para cambiar el orden").
+   * Use it whenever the visible order is not the real one: a search, a filter, a grouped view.
+   */
+  reorderDisabled?: boolean | string;
   sortDescriptor?: SortDescriptor | null;
   onSortChange?: (column: string) => void;
   columnWidths?: ColumnWidths;
@@ -204,8 +233,25 @@ interface TableBodyProps<TData> {
    * Fired when a row (or the selection it belongs to) is dropped in a new
    * position. Requires `isReorderable` on the table and a `rowKey` that
    * matches each row's `keyCurrent.id`.
+   *
+   * Returning a promise (e.g. the save request) makes the table show the new
+   * order right away, disable the handles until it settles and roll back if
+   * it rejects. The optimistic order lasts until `data` changes.
+   */
+  onReorder?: (event: TableReorderEvent<TData>) => TableReorderResult;
+  /**
+   * Absolute position of the first row of `data` (e.g. `(page - 1) * limit`).
+   * Added to `fromIndex`, `toIndex` and `positions` so they can be saved as is.
+   */
+  indexOffset?: number;
+  /**
+   * Enables "Mover a posición…" on the handles (double click or Shift+Enter):
+   * moves one row to an absolute position, also to another page. Pair it with
+   * `totalCount`. A returned promise disables the handles until it settles.
    */
-  onReorder?: (event: TableReorderEvent<TData>) => void;
+  onMoveToPosition?: (event: TableMoveToPositionEvent<TData>) => TableReorderResult;
+  /** Total rows across all pages; upper bound for "Mover a posición…". Defaults to `indexOffset + data.length`. */
+  totalCount?: number;
 }
 interface TableBodyRowProps {
   className?: string;
@@ -249,4 +295,4 @@ interface TableProps {
   persistKey?: string;
 }
 export declare const useTable: ({ initialDisabledKeys, initialSelectKey, initialValueSearch, initialSortDescriptor, initialColumnWidths, initialHiddenColumns, persistKey }: TableProps) => TableHookProps;
-export type { TableDropPosition, TableReorderEvent };
+export type { TableDropPosition, TableMoveToPositionEvent, TableReorderEvent, TableReorderResult, TableRowPosition };