@factorialco/f0-react 1.356.1 → 1.357.0

package/dist/f0.d.ts

@@ -1547,6 +1547,8 @@ export declare interface CustomFieldRenderProps<TValue = unknown, TConfig = unde
     isValidating: boolean;
     /** Whether the field is disabled */
     disabled?: boolean;
+    /** Whether the field is required (derived from Zod schema) */
+    required?: boolean;
     /** Custom configuration passed via fieldConfig */
     config: TConfig;
 }
@@ -1573,6 +1575,8 @@ declare interface CustomFieldRenderPropsBase {
     isValidating: boolean;
     /** Whether the field is disabled */
     disabled?: boolean;
+    /** Whether the field is required (derived from Zod schema) */
+    required?: boolean;
 }
 
 export declare const Dashboard: ComponentType<DashboardProps_2> & PageLayoutGroupComponent_2;
@@ -1799,6 +1803,16 @@ export declare type DataSourceDefinition<R extends RecordType = RecordType, Filt
     selectable?: (item: R) => string | number | undefined;
     /** Default selected items */
     defaultSelectedItems?: SelectedItemsState<R>;
+    /**
+     * When true, selection spans across all pages (cross-page selection).
+     * - Selection state persists when navigating between pages
+     * - itemStatus includes items from all pages
+     *
+     * When false (default), selection is scoped to the current page only:
+     * - Selection state resets when navigating between pages
+     * - itemStatus only includes items from the current page
+     */
+    allPagesSelection?: boolean;
     /***** GROUPING ***************************************************/
     /** Grouping configuration */
     grouping?: Grouping;
@@ -2144,6 +2158,9 @@ export declare const defaultTranslations: {
             readonly singular: "Selected";
             readonly plural: "Selected";
             readonly all: "All selected";
+            readonly allOnPage: "All items on this page are selected";
+            readonly selectAllItems: "Select all {{total}} items";
+            readonly allItemsSelected: "All {{total}} items selected";
         };
     };
     readonly syncStatus: {
@@ -5620,7 +5637,7 @@ declare type OnLoadErrorCallback = (error: DataError) => void;
 
 export declare type OnSelectItemsCallback<R extends RecordType, Filters extends FiltersDefinition> = (selectedItems: SelectedItemsDetailedStatus<R, Filters> & {
     byLane?: Record<string, SelectedItemsDetailedStatus<R, Filters>>;
-}, clearSelectedItems: () => void) => void;
+}, clearSelectedItems: () => void, handleSelectAll?: (checked: boolean) => void) => void;
 
 declare type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
 
@@ -7125,7 +7142,7 @@ export declare function useSchemaDefinition(schema: z.ZodObject<ZodRawShape>, se
  * Custom hook to manage selection state for items and groups in a data table
  * Supports single/multi selection, grouped data, pagination, and filtering
  */
-export declare function useSelectable<R extends RecordType, Filters extends FiltersDefinition, Sortings extends SortingsDefinition, Grouping extends GroupingDefinition<R>>({ data, paginationInfo, source, selectionMode, selectedState, onSelectItems, disableSelectAll, isSearchActive, }: UseSelectableProps<R, Filters, Sortings, Grouping>): UseSelectableReturn<R, Filters>;
+export declare function useSelectable<R extends RecordType, Filters extends FiltersDefinition, Sortings extends SortingsDefinition, Grouping extends GroupingDefinition<R>>({ data, paginationInfo, source, selectionMode, selectedState, onSelectItems, disableSelectAll, isSearchActive, allPagesSelection, }: UseSelectableProps<R, Filters, Sortings, Grouping>): UseSelectableReturn<R, Filters>;
 
 export declare type UseSelectableProps<R extends RecordType, Filters extends FiltersDefinition, Sortings extends SortingsDefinition, Grouping extends GroupingDefinition<R>> = {
     data: Data<R>;
@@ -7145,6 +7162,16 @@ export declare type UseSelectableProps<R extends RecordType, Filters extends Fil
      * because the visible items are a filtered subset.
      */
     isSearchActive?: boolean;
+    /**
+     * When true, selection spans across all pages (cross-page selection).
+     * - Selection state persists when navigating between pages
+     * - itemStatus includes items from all pages
+     *
+     * When false (default), selection is scoped to the current page only:
+     * - Selection state resets when navigating between pages
+     * - itemStatus only includes items from the current page
+     */
+    allPagesSelection?: boolean;
 };
 
 export declare type UseSelectableReturn<R extends RecordType, Filters extends FiltersDefinition> = {
@@ -7351,6 +7378,11 @@ declare module "gridstack" {
 }
 
 
+declare namespace Calendar {
+    var displayName: string;
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -7387,8 +7419,3 @@ declare module "@tiptap/core" {
         };
     }
 }
-
-
-declare namespace Calendar {
-    var displayName: string;
-}