@mohasinac/react 1.0.0 → 1.1.0

package/dist/index.d.cts

@@ -1,4 +1,5 @@
-import { RefObject } from 'react';
+import { RefObject, Dispatch, SetStateAction } from 'react';
+import * as next_navigation from 'next/navigation';
 
 /**
  * useMediaQuery Hook
@@ -363,4 +364,271 @@ interface UseCameraReturn {
  */
 declare function useCamera(): UseCameraReturn;
 
-export { type CountdownRemaining, type GestureType, type KeyModifiers, type SwipeDirection, type UseCameraOptions, type UseCameraReturn, type UseClickOutsideOptions, type UseGestureOptions, type UseKeyPressOptions, type UsePullToRefreshOptions, type UsePullToRefreshReturn, type UseSwipeOptions, useBreakpoint, useCamera, useClickOutside, useCountdown, useGesture, useKeyPress, useLongPress, useMediaQuery, usePullToRefresh, useSwipe };
+interface UseBulkSelectionOptions<T> {
+    /** The current page / list of items being displayed. */
+    items: T[];
+    /** Extract a stable unique key from each item (e.g. `item => item.id`). */
+    keyExtractor: (item: T) => string;
+    /**
+     * Maximum number of IDs that can be selected at once.
+     * @default 100
+     */
+    maxSelection?: number;
+}
+interface UseBulkSelectionReturn {
+    selectedIds: string[];
+    selectedCount: number;
+    /** Returns `true` if the given ID is currently selected. */
+    isSelected: (id: string) => boolean;
+    /** `true` when every item on the current page is selected. */
+    isAllSelected: boolean;
+    /**
+     * `true` when some — but not all — items are selected.
+     * Use to set the indeterminate state on the header checkbox.
+     */
+    isIndeterminate: boolean;
+    /** Toggle one item in or out of the selection. Respects `maxSelection`. */
+    toggle: (id: string) => void;
+    /**
+     * Select all items on the current page (up to `maxSelection`),
+     * or deselect all if every item is already selected.
+     */
+    toggleAll: () => void;
+    /** Deselect everything. Call this after a bulk action completes. */
+    clearSelection: () => void;
+    /**
+     * Direct state setter — pass straight to a table's `onSelectionChange`
+     * or use when you need to replace the entire selection programmatically.
+     */
+    setSelectedIds: Dispatch<SetStateAction<string[]>>;
+}
+declare function useBulkSelection<T>({ items, keyExtractor, maxSelection, }: UseBulkSelectionOptions<T>): UseBulkSelectionReturn;
+
+interface UseUrlTableOptions {
+    /** Default param values used when a param is absent from the URL */
+    defaults?: Record<string, string>;
+}
+declare function useUrlTable(options?: UseUrlTableOptions): {
+    params: next_navigation.ReadonlyURLSearchParams;
+    get: (key: string) => string;
+    getNumber: (key: string, fallback?: number) => number;
+    set: (key: string, value: string) => void;
+    setMany: (updates: Record<string, string>) => void;
+    clear: (keys?: string[]) => void;
+    setPage: (page: number) => void;
+    setPageSize: (size: number) => void;
+    setSort: (sort: string) => void;
+    buildSieveParams: (sieveFilters: string) => string;
+    buildSearchParams: () => string;
+};
+
+type UrlTable$1 = ReturnType<typeof useUrlTable>;
+interface UsePendingFiltersOptions {
+    /** The page's useUrlTable instance */
+    table: UrlTable$1;
+    /** URL param keys to manage (e.g. ['status', 'category', 'role']) */
+    keys: string[];
+}
+interface UsePendingFiltersReturn {
+    /** Current uncommitted selections per key (string[] per key) */
+    pending: Record<string, string[]>;
+    /** Values currently in the URL (committed) per key */
+    applied: Record<string, string[]>;
+    /** true when pending differs from applied */
+    isDirty: boolean;
+    /** Total number of selected values across all pending keys */
+    pendingCount: number;
+    /** Total number of selected values in the URL (for badge display) */
+    appliedCount: number;
+    /** Update one key in pending state (does NOT write to URL) */
+    set: (key: string, values: string[]) => void;
+    /** Write all pending keys to the URL (resets page to 1) */
+    apply: () => void;
+    /** Discard pending, revert to applied (URL) state */
+    reset: () => void;
+    /** Clear all keys in both pending state and the URL */
+    clear: () => void;
+}
+/**
+ * usePendingFilters
+ *
+ * Manages local (uncommitted) filter state for a FilterDrawer or any deferred
+ * filter panel. Values are only written to the URL when `apply()` is called.
+ *
+ * Initialised from the current URL params on mount, so opening a drawer
+ * pre-fills any already-applied filters.
+ *
+ * @example
+ * ```ts
+ * const table   = useUrlTable({ defaults: { pageSize: '25' } });
+ * const filters = usePendingFilters({ table, keys: ['status', 'category'] });
+ *
+ * <FilterDrawer
+ *   onApply={() => { filters.apply(); setDrawerOpen(false); }}
+ *   onReset={() => filters.clear()}
+ *   activeCount={filters.appliedCount}
+ * >
+ *   <FilterFacetSection
+ *     title="Status"
+ *     options={STATUS_OPTIONS}
+ *     selected={filters.pending['status'] ?? []}
+ *     onChange={(v) => filters.set('status', v)}
+ *   />
+ * </FilterDrawer>
+ * ```
+ */
+declare function usePendingFilters({ table, keys, }: UsePendingFiltersOptions): UsePendingFiltersReturn;
+
+type UrlTable = ReturnType<typeof useUrlTable>;
+/**
+ * Minimal UrlTable-compatible interface consumed by *Filters components.
+ */
+interface PendingTable {
+    get: (key: string) => string;
+    set: (key: string, value: string) => void;
+    setMany: (updates: Record<string, string>) => void;
+}
+interface UsePendingTableReturn {
+    /** Drop-in UrlTable replacement that reads/writes to pending state */
+    pendingTable: PendingTable;
+    /** Count of applied (URL) filter values — use for the filter badge */
+    filterActiveCount: number;
+    /** Commit all pending changes to the URL (resets page to 1) */
+    onFilterApply: () => void;
+    /** Clear all filter keys from pending state and URL */
+    onFilterClear: () => void;
+}
+/**
+ * usePendingTable
+ *
+ * A thin wrapper around `usePendingFilters` that exposes a `pendingTable`
+ * object matching the `UrlTable` interface (`get`, `set`, `setMany`).
+ *
+ * Drop this into any listing view to replace the per-filter `useState` +
+ * `handleFilterApply` + `handleFilterClear` boilerplate.
+ *
+ * @example
+ * ```tsx
+ * const { pendingTable, filterActiveCount, onFilterApply, onFilterClear } =
+ *   usePendingTable(table, ['status', 'category', 'minPrice', 'maxPrice']);
+ *
+ * // Pass pendingTable directly to any *Filters component:
+ * filterContent={<ProductFilters table={pendingTable} showStatus />}
+ * filterActiveCount={filterActiveCount}
+ * onFilterApply={onFilterApply}
+ * onFilterClear={onFilterClear}
+ * ```
+ */
+declare function usePendingTable(table: UrlTable, keys: string[]): UsePendingTableReturn;
+
+declare const UNSAVED_CHANGES_EVENT = "unsaved-changes:confirm";
+interface UseUnsavedChangesOptions {
+    /** Current form values to compare against initial */
+    formValues: Record<string, string>;
+    /** Initial form values snapshot (taken when data loads) */
+    initialValues: Record<string, string> | null;
+    /** Additional dirty flag from outside the form (e.g. pending avatar upload) */
+    extraDirty?: boolean;
+    /**
+     * Called when the user attempts to navigate away with unsaved changes.
+     * Must return a Promise that resolves to `true` (continue) or `false` (stay).
+     * Defaults to `window.confirm` with a generic message.
+     */
+    confirmFn?: () => Promise<boolean>;
+    /**
+     * Message shown in the browser-native `beforeunload` dialog.
+     * Most modern browsers ignore custom messages and show their own text.
+     */
+    beforeUnloadWarning?: string;
+}
+interface UseUnsavedChangesReturn {
+    /** Whether there are any unsaved changes (form or extra) */
+    isDirty: boolean;
+    /** Whether the form fields specifically have changed */
+    isFormDirty: boolean;
+    /** Call after a successful save to reset initial values to current */
+    markClean: () => void;
+    /** Prompt the user and return true if they confirmed leaving, false otherwise */
+    confirmLeave: () => Promise<boolean>;
+}
+/**
+ * useUnsavedChanges
+ *
+ * Tracks unsaved form changes and warns users before navigating away.
+ *
+ * - Compares `formValues` to `initialValues` to detect form dirtiness
+ * - Accepts an optional `extraDirty` flag (e.g. pending file upload)
+ * - Registers a `beforeunload` handler while dirty
+ * - Exposes `confirmLeave()` which calls the provided `confirmFn` (or falls back
+ *   to `window.confirm`) to handle navigation guards
+ * - `markClean()` resets the snapshot after a successful save
+ */
+declare function useUnsavedChanges({ formValues, initialValues, extraDirty, confirmFn, beforeUnloadWarning, }: UseUnsavedChangesOptions): UseUnsavedChangesReturn;
+
+interface BulkActionItemFailure {
+    id: string;
+    reason: string;
+}
+interface BulkActionSummary {
+    total: number;
+    succeeded: number;
+    skipped: number;
+    failed: number;
+}
+interface BulkActionResult<TData = Record<string, unknown>> {
+    action: string;
+    summary: BulkActionSummary;
+    succeeded: string[];
+    skipped: string[];
+    failed: BulkActionItemFailure[];
+    data?: TData;
+}
+interface BulkActionPayload {
+    action: string;
+    ids: string[];
+}
+interface UseBulkActionOptions<TPayload extends BulkActionPayload, TData = Record<string, unknown>> {
+    /**
+     * Async function that POSTs to the bulk endpoint.
+     * Must return `Promise<BulkActionResult<TData>>`.
+     */
+    mutationFn: (payload: TPayload) => Promise<BulkActionResult<TData>>;
+    /**
+     * Called when `mutationFn` resolves (even for partial failures).
+     * Inspect `result.summary` to build feedback.
+     */
+    onSuccess?: (result: BulkActionResult<TData>, payload: TPayload) => void | Promise<void>;
+    /**
+     * Called when `mutationFn` rejects.
+     */
+    onError?: (error: Error, payload: TPayload) => void;
+    /**
+     * When `true`, `execute()` parks the payload in `pendingPayload` instead of
+     * running immediately. The caller renders a confirm modal wired to
+     * `confirmAndExecute` / `cancelConfirm`.
+     */
+    requiresConfirm?: boolean;
+}
+interface UseBulkActionReturn<TPayload extends BulkActionPayload, TData = Record<string, unknown>> {
+    execute: (payload: TPayload) => Promise<void>;
+    isLoading: boolean;
+    result: BulkActionResult<TData> | null;
+    error: Error | null;
+    reset: () => void;
+    pendingPayload: TPayload | null;
+    confirmAndExecute: () => Promise<void>;
+    cancelConfirm: () => void;
+}
+/**
+ * useBulkAction
+ *
+ * Generic mutation hook for any `/bulk` endpoint.
+ * Handles loading state, partial-success result tracking, and an optional
+ * confirmation flow for destructive operations.
+ *
+ * Pair with `useBulkSelection` and a `BulkActionBar` component for the
+ * full admin list pattern.
+ */
+declare function useBulkAction<TPayload extends BulkActionPayload = BulkActionPayload, TData = Record<string, unknown>>(options: UseBulkActionOptions<TPayload, TData>): UseBulkActionReturn<TPayload, TData>;
+
+export { type BulkActionItemFailure, type BulkActionPayload, type BulkActionResult, type BulkActionSummary, type CountdownRemaining, type GestureType, type KeyModifiers, type PendingTable, type SwipeDirection, UNSAVED_CHANGES_EVENT, type UseBulkActionOptions, type UseBulkActionReturn, type UseBulkSelectionOptions, type UseBulkSelectionReturn, type UseCameraOptions, type UseCameraReturn, type UseClickOutsideOptions, type UseGestureOptions, type UseKeyPressOptions, type UsePendingFiltersOptions, type UsePendingFiltersReturn, type UsePendingTableReturn, type UsePullToRefreshOptions, type UsePullToRefreshReturn, type UseSwipeOptions, type UseUnsavedChangesOptions, type UseUnsavedChangesReturn, type UseUrlTableOptions, useBreakpoint, useBulkAction, useBulkSelection, useCamera, useClickOutside, useCountdown, useGesture, useKeyPress, useLongPress, useMediaQuery, usePendingFilters, usePendingTable, usePullToRefresh, useSwipe, useUnsavedChanges, useUrlTable };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { RefObject } from 'react';
+import { RefObject, Dispatch, SetStateAction } from 'react';
+import * as next_navigation from 'next/navigation';
 
 /**
  * useMediaQuery Hook
@@ -363,4 +364,271 @@ interface UseCameraReturn {
  */
 declare function useCamera(): UseCameraReturn;
 
-export { type CountdownRemaining, type GestureType, type KeyModifiers, type SwipeDirection, type UseCameraOptions, type UseCameraReturn, type UseClickOutsideOptions, type UseGestureOptions, type UseKeyPressOptions, type UsePullToRefreshOptions, type UsePullToRefreshReturn, type UseSwipeOptions, useBreakpoint, useCamera, useClickOutside, useCountdown, useGesture, useKeyPress, useLongPress, useMediaQuery, usePullToRefresh, useSwipe };
+interface UseBulkSelectionOptions<T> {
+    /** The current page / list of items being displayed. */
+    items: T[];
+    /** Extract a stable unique key from each item (e.g. `item => item.id`). */
+    keyExtractor: (item: T) => string;
+    /**
+     * Maximum number of IDs that can be selected at once.
+     * @default 100
+     */
+    maxSelection?: number;
+}
+interface UseBulkSelectionReturn {
+    selectedIds: string[];
+    selectedCount: number;
+    /** Returns `true` if the given ID is currently selected. */
+    isSelected: (id: string) => boolean;
+    /** `true` when every item on the current page is selected. */
+    isAllSelected: boolean;
+    /**
+     * `true` when some — but not all — items are selected.
+     * Use to set the indeterminate state on the header checkbox.
+     */
+    isIndeterminate: boolean;
+    /** Toggle one item in or out of the selection. Respects `maxSelection`. */
+    toggle: (id: string) => void;
+    /**
+     * Select all items on the current page (up to `maxSelection`),
+     * or deselect all if every item is already selected.
+     */
+    toggleAll: () => void;
+    /** Deselect everything. Call this after a bulk action completes. */
+    clearSelection: () => void;
+    /**
+     * Direct state setter — pass straight to a table's `onSelectionChange`
+     * or use when you need to replace the entire selection programmatically.
+     */
+    setSelectedIds: Dispatch<SetStateAction<string[]>>;
+}
+declare function useBulkSelection<T>({ items, keyExtractor, maxSelection, }: UseBulkSelectionOptions<T>): UseBulkSelectionReturn;
+
+interface UseUrlTableOptions {
+    /** Default param values used when a param is absent from the URL */
+    defaults?: Record<string, string>;
+}
+declare function useUrlTable(options?: UseUrlTableOptions): {
+    params: next_navigation.ReadonlyURLSearchParams;
+    get: (key: string) => string;
+    getNumber: (key: string, fallback?: number) => number;
+    set: (key: string, value: string) => void;
+    setMany: (updates: Record<string, string>) => void;
+    clear: (keys?: string[]) => void;
+    setPage: (page: number) => void;
+    setPageSize: (size: number) => void;
+    setSort: (sort: string) => void;
+    buildSieveParams: (sieveFilters: string) => string;
+    buildSearchParams: () => string;
+};
+
+type UrlTable$1 = ReturnType<typeof useUrlTable>;
+interface UsePendingFiltersOptions {
+    /** The page's useUrlTable instance */
+    table: UrlTable$1;
+    /** URL param keys to manage (e.g. ['status', 'category', 'role']) */
+    keys: string[];
+}
+interface UsePendingFiltersReturn {
+    /** Current uncommitted selections per key (string[] per key) */
+    pending: Record<string, string[]>;
+    /** Values currently in the URL (committed) per key */
+    applied: Record<string, string[]>;
+    /** true when pending differs from applied */
+    isDirty: boolean;
+    /** Total number of selected values across all pending keys */
+    pendingCount: number;
+    /** Total number of selected values in the URL (for badge display) */
+    appliedCount: number;
+    /** Update one key in pending state (does NOT write to URL) */
+    set: (key: string, values: string[]) => void;
+    /** Write all pending keys to the URL (resets page to 1) */
+    apply: () => void;
+    /** Discard pending, revert to applied (URL) state */
+    reset: () => void;
+    /** Clear all keys in both pending state and the URL */
+    clear: () => void;
+}
+/**
+ * usePendingFilters
+ *
+ * Manages local (uncommitted) filter state for a FilterDrawer or any deferred
+ * filter panel. Values are only written to the URL when `apply()` is called.
+ *
+ * Initialised from the current URL params on mount, so opening a drawer
+ * pre-fills any already-applied filters.
+ *
+ * @example
+ * ```ts
+ * const table   = useUrlTable({ defaults: { pageSize: '25' } });
+ * const filters = usePendingFilters({ table, keys: ['status', 'category'] });
+ *
+ * <FilterDrawer
+ *   onApply={() => { filters.apply(); setDrawerOpen(false); }}
+ *   onReset={() => filters.clear()}
+ *   activeCount={filters.appliedCount}
+ * >
+ *   <FilterFacetSection
+ *     title="Status"
+ *     options={STATUS_OPTIONS}
+ *     selected={filters.pending['status'] ?? []}
+ *     onChange={(v) => filters.set('status', v)}
+ *   />
+ * </FilterDrawer>
+ * ```
+ */
+declare function usePendingFilters({ table, keys, }: UsePendingFiltersOptions): UsePendingFiltersReturn;
+
+type UrlTable = ReturnType<typeof useUrlTable>;
+/**
+ * Minimal UrlTable-compatible interface consumed by *Filters components.
+ */
+interface PendingTable {
+    get: (key: string) => string;
+    set: (key: string, value: string) => void;
+    setMany: (updates: Record<string, string>) => void;
+}
+interface UsePendingTableReturn {
+    /** Drop-in UrlTable replacement that reads/writes to pending state */
+    pendingTable: PendingTable;
+    /** Count of applied (URL) filter values — use for the filter badge */
+    filterActiveCount: number;
+    /** Commit all pending changes to the URL (resets page to 1) */
+    onFilterApply: () => void;
+    /** Clear all filter keys from pending state and URL */
+    onFilterClear: () => void;
+}
+/**
+ * usePendingTable
+ *
+ * A thin wrapper around `usePendingFilters` that exposes a `pendingTable`
+ * object matching the `UrlTable` interface (`get`, `set`, `setMany`).
+ *
+ * Drop this into any listing view to replace the per-filter `useState` +
+ * `handleFilterApply` + `handleFilterClear` boilerplate.
+ *
+ * @example
+ * ```tsx
+ * const { pendingTable, filterActiveCount, onFilterApply, onFilterClear } =
+ *   usePendingTable(table, ['status', 'category', 'minPrice', 'maxPrice']);
+ *
+ * // Pass pendingTable directly to any *Filters component:
+ * filterContent={<ProductFilters table={pendingTable} showStatus />}
+ * filterActiveCount={filterActiveCount}
+ * onFilterApply={onFilterApply}
+ * onFilterClear={onFilterClear}
+ * ```
+ */
+declare function usePendingTable(table: UrlTable, keys: string[]): UsePendingTableReturn;
+
+declare const UNSAVED_CHANGES_EVENT = "unsaved-changes:confirm";
+interface UseUnsavedChangesOptions {
+    /** Current form values to compare against initial */
+    formValues: Record<string, string>;
+    /** Initial form values snapshot (taken when data loads) */
+    initialValues: Record<string, string> | null;
+    /** Additional dirty flag from outside the form (e.g. pending avatar upload) */
+    extraDirty?: boolean;
+    /**
+     * Called when the user attempts to navigate away with unsaved changes.
+     * Must return a Promise that resolves to `true` (continue) or `false` (stay).
+     * Defaults to `window.confirm` with a generic message.
+     */
+    confirmFn?: () => Promise<boolean>;
+    /**
+     * Message shown in the browser-native `beforeunload` dialog.
+     * Most modern browsers ignore custom messages and show their own text.
+     */
+    beforeUnloadWarning?: string;
+}
+interface UseUnsavedChangesReturn {
+    /** Whether there are any unsaved changes (form or extra) */
+    isDirty: boolean;
+    /** Whether the form fields specifically have changed */
+    isFormDirty: boolean;
+    /** Call after a successful save to reset initial values to current */
+    markClean: () => void;
+    /** Prompt the user and return true if they confirmed leaving, false otherwise */
+    confirmLeave: () => Promise<boolean>;
+}
+/**
+ * useUnsavedChanges
+ *
+ * Tracks unsaved form changes and warns users before navigating away.
+ *
+ * - Compares `formValues` to `initialValues` to detect form dirtiness
+ * - Accepts an optional `extraDirty` flag (e.g. pending file upload)
+ * - Registers a `beforeunload` handler while dirty
+ * - Exposes `confirmLeave()` which calls the provided `confirmFn` (or falls back
+ *   to `window.confirm`) to handle navigation guards
+ * - `markClean()` resets the snapshot after a successful save
+ */
+declare function useUnsavedChanges({ formValues, initialValues, extraDirty, confirmFn, beforeUnloadWarning, }: UseUnsavedChangesOptions): UseUnsavedChangesReturn;
+
+interface BulkActionItemFailure {
+    id: string;
+    reason: string;
+}
+interface BulkActionSummary {
+    total: number;
+    succeeded: number;
+    skipped: number;
+    failed: number;
+}
+interface BulkActionResult<TData = Record<string, unknown>> {
+    action: string;
+    summary: BulkActionSummary;
+    succeeded: string[];
+    skipped: string[];
+    failed: BulkActionItemFailure[];
+    data?: TData;
+}
+interface BulkActionPayload {
+    action: string;
+    ids: string[];
+}
+interface UseBulkActionOptions<TPayload extends BulkActionPayload, TData = Record<string, unknown>> {
+    /**
+     * Async function that POSTs to the bulk endpoint.
+     * Must return `Promise<BulkActionResult<TData>>`.
+     */
+    mutationFn: (payload: TPayload) => Promise<BulkActionResult<TData>>;
+    /**
+     * Called when `mutationFn` resolves (even for partial failures).
+     * Inspect `result.summary` to build feedback.
+     */
+    onSuccess?: (result: BulkActionResult<TData>, payload: TPayload) => void | Promise<void>;
+    /**
+     * Called when `mutationFn` rejects.
+     */
+    onError?: (error: Error, payload: TPayload) => void;
+    /**
+     * When `true`, `execute()` parks the payload in `pendingPayload` instead of
+     * running immediately. The caller renders a confirm modal wired to
+     * `confirmAndExecute` / `cancelConfirm`.
+     */
+    requiresConfirm?: boolean;
+}
+interface UseBulkActionReturn<TPayload extends BulkActionPayload, TData = Record<string, unknown>> {
+    execute: (payload: TPayload) => Promise<void>;
+    isLoading: boolean;
+    result: BulkActionResult<TData> | null;
+    error: Error | null;
+    reset: () => void;
+    pendingPayload: TPayload | null;
+    confirmAndExecute: () => Promise<void>;
+    cancelConfirm: () => void;
+}
+/**
+ * useBulkAction
+ *
+ * Generic mutation hook for any `/bulk` endpoint.
+ * Handles loading state, partial-success result tracking, and an optional
+ * confirmation flow for destructive operations.
+ *
+ * Pair with `useBulkSelection` and a `BulkActionBar` component for the
+ * full admin list pattern.
+ */
+declare function useBulkAction<TPayload extends BulkActionPayload = BulkActionPayload, TData = Record<string, unknown>>(options: UseBulkActionOptions<TPayload, TData>): UseBulkActionReturn<TPayload, TData>;
+
+export { type BulkActionItemFailure, type BulkActionPayload, type BulkActionResult, type BulkActionSummary, type CountdownRemaining, type GestureType, type KeyModifiers, type PendingTable, type SwipeDirection, UNSAVED_CHANGES_EVENT, type UseBulkActionOptions, type UseBulkActionReturn, type UseBulkSelectionOptions, type UseBulkSelectionReturn, type UseCameraOptions, type UseCameraReturn, type UseClickOutsideOptions, type UseGestureOptions, type UseKeyPressOptions, type UsePendingFiltersOptions, type UsePendingFiltersReturn, type UsePendingTableReturn, type UsePullToRefreshOptions, type UsePullToRefreshReturn, type UseSwipeOptions, type UseUnsavedChangesOptions, type UseUnsavedChangesReturn, type UseUrlTableOptions, useBreakpoint, useBulkAction, useBulkSelection, useCamera, useClickOutside, useCountdown, useGesture, useKeyPress, useLongPress, useMediaQuery, usePendingFilters, usePendingTable, usePullToRefresh, useSwipe, useUnsavedChanges, useUrlTable };