@tailor-platform/app-shell 1.0.0 → 1.0.1

package/dist/app-shell.d.ts

@@ -831,19 +831,36 @@ export declare interface CollectionControl<TFieldName extends string = string, T
     clearSort: () => void;
     pageSize: number;
     setPageSize: (size: number) => void;
-    cursor: string | null;
-    paginationDirection: "forward" | "backward";
-    nextPage: (cursor: string) => void;
-    prevPage: (cursor: string) => void;
+    /** Navigate to the next page. Mode-aware: pushes cursor in forward, pops stack in backward. */
+    goToNextPage: (pageInfo: Pick<PageInfo, "endCursor">) => void;
+    /** Navigate to the previous page. Mode-aware: pops stack in forward, pushes cursor in backward. */
+    goToPrevPage: (pageInfo: Pick<PageInfo, "startCursor">) => void;
     resetPage: () => void;
     goToFirstPage: () => void;
     /**
      * Navigate to the last page.
      *
-     * Requests the last `pageSize` items by setting `paginationDirection` to
-     * `"backward"` with no cursor.
+     * When `total` is provided, the hook computes `total % pageSize` so the last
+     * page aligns with forward-pagination boundaries. Without `total`, it falls
+     * back to a full `pageSize` fetch.
      */
-    goToLastPage: () => void;
+    goToLastPage: (total?: number | null) => void;
+    /**
+     * Determine whether a previous page exists, given the server's `pageInfo`.
+     * Accounts for the current pagination direction and cursor stack.
+     */
+    getHasPrevPage: (pageInfo: Pick<PageInfo, "hasPreviousPage">) => boolean;
+    /**
+     * Determine whether a next page exists, given the server's `pageInfo`.
+     * Accounts for the current pagination direction and cursor stack.
+     */
+    getHasNextPage: (pageInfo: Pick<PageInfo, "hasNextPage">) => boolean;
+    /**
+     * Monotonically increasing counter that bumps on every pagination reset.
+     * Used internally by `usePageCounter` to detect external resets (e.g.
+     * filter/sort changes) and sync `currentPage`.
+     */
+    resetCount: number;
 }
 
 /**
@@ -1690,8 +1707,14 @@ export declare interface DataTableContextValue<TRow extends Record<string, unkno
     pageInfo: PageInfo;
     total: number | null;
     totalPages: number | null;
-    nextPage: (cursor: string) => void;
-    prevPage: (cursor: string) => void;
+    /** 1-based page counter, automatically kept in sync by navigation actions. */
+    currentPage: number;
+    goToNextPage: (pageInfo: Pick<PageInfo, "endCursor">) => void;
+    goToPrevPage: (pageInfo: Pick<PageInfo, "startCursor">) => void;
+    /** Jump to the first page. */
+    goToFirstPage: () => void;
+    /** Jump to the last page. Only functional when `totalPages` is known. */
+    goToLastPage: () => void;
     hasPrevPage: boolean;
     hasNextPage: boolean;
     /**
@@ -1699,6 +1722,8 @@ export declare interface DataTableContextValue<TRow extends Record<string, unkno
      * configured. Used to render the correct number of skeleton / ghost rows.
      */
     pageSize: number;
+    /** Change the page size and reset to the first page. */
+    setPageSize: (size: number) => void;
     columns: Column<TRow>[];
     visibleColumns: Column<TRow>[];
     toggleColumn: (fieldOrId: string) => void;
@@ -4945,8 +4970,18 @@ export declare interface UseDataTableReturn<TRow extends Record<string, unknown>
     pageInfo: PageInfo;
     total: number | null;
     totalPages: number | null;
-    nextPage: (cursor: string) => void;
-    prevPage: (cursor: string) => void;
+    /** 1-based page counter, automatically kept in sync by navigation actions. */
+    currentPage: number;
+    /** Navigate to the next page. Mode-aware: pushes cursor in forward, pops stack in backward. */
+    goToNextPage: (pageInfo: Pick<PageInfo, "endCursor">) => void;
+    /** Navigate to the previous page. Mode-aware: pops stack in forward, pushes cursor in backward. */
+    goToPrevPage: (pageInfo: Pick<PageInfo, "startCursor">) => void;
+    /** Jump to the first page. */
+    goToFirstPage: () => void;
+    /** Jump to the last page. Only functional when `totalPages` is known. */
+    goToLastPage: () => void;
+    /** Change the page size and reset to the first page. */
+    setPageSize: (size: number) => void;
     hasPrevPage: boolean;
     hasNextPage: boolean;
     columns: Column<TRow>[];