@factorialco/f0-react 1.372.0 → 1.373.0

package/dist/f0.d.ts

@@ -2195,6 +2195,7 @@ export declare const defaultTranslations: {
             readonly selectAllItems: "Select all {{total}} items";
             readonly allItemsSelected: "All {{total}} items selected";
         };
+        readonly noItemsSelected: "No items selected";
     };
     readonly filters: {
         readonly searchPlaceholder: "Search filters...";
@@ -2542,6 +2543,8 @@ export declare const defaultTranslations: {
     readonly forms: {
         readonly actionBar: {
             readonly unsavedChanges: "You have changes pending to be saved";
+            readonly saving: "Saving...";
+            readonly saved: "Your changes have been saved";
             readonly discard: "Discard";
             readonly issues: {
                 readonly one: "{{count}} issue";
@@ -4071,6 +4074,8 @@ declare interface F0FormSubmitConfigBase {
      * - IconType: custom icon
      */
     icon?: IconType | null;
+    /** Label shown in the action bar while submitting (defaults to i18n "forms.actionBar.saving") */
+    savingMessage?: string;
 }
 
 /**
@@ -4078,6 +4083,8 @@ declare interface F0FormSubmitConfigBase {
  */
 export declare type F0FormSubmitResult = {
     success: true;
+    /** Optional message shown in the action bar after successful submission */
+    message?: string;
 } | {
     success: false;
     /** Root error message displayed at the top of the form */
@@ -4361,6 +4368,12 @@ declare type F0SelectBaseProps<T extends string, R = unknown> = {
      * Only displays the dropdown content with max height, border and scroll.
      */
     asList?: boolean;
+    /**
+     * When true, shows a selection preview panel on the right side of the dropdown
+     * for multi-select mode. When false and filters are present, filters use compact mode.
+     * @default false
+     */
+    showPreview?: boolean;
 };
 
 /**
@@ -4822,7 +4835,7 @@ declare interface FilterPickerBaseProps<Filters extends FiltersDefinition> {
  */
 export declare type FiltersDefinition<Keys extends string = string> = Record<Keys, FilterDefinition>;
 
-export declare type FiltersMode = "default" | "compact" | "simple";
+export declare type FiltersMode = "default" | "compact" | "simple" | "inline";
 
 /**
  * Current state of all filters in a collection.
@@ -4837,6 +4850,8 @@ export declare type FiltersState<Definition extends Record<string, FilterDefinit
 declare type FilterTypeContext<Options extends object = never> = {
     schema: FilterTypeSchema<Options>;
     i18n: I18nContextType;
+    /** The key of this filter in the FiltersDefinition (passed to chipLabel for nested label lookups) */
+    filterKey?: string;
 };
 
 declare type FilterTypeDefinition<Value = unknown, Options extends object = never, EmptyValue = Value, OptionalOptions extends boolean = false> = {
@@ -4849,6 +4864,8 @@ declare type FilterTypeDefinition<Value = unknown, Options extends object = neve
         value: Value;
         onChange: (value: Value) => void;
         isCompactMode?: boolean;
+        onFilterChange?: (key: string, value: unknown) => void;
+        allFiltersValue?: Record<string, unknown>;
     }) => React.ReactNode;
     /**
      * The value label to display in the filter chips
@@ -5257,6 +5274,16 @@ declare type InFilterOptionItem<T = unknown> = {
     value: T;
     /** Human-readable label for the option */
     label: string;
+    /**
+     * Nested children that belong to a different filter key.
+     * Enables hierarchical filtering (e.g., office -> space -> desk).
+     */
+    children?: {
+        /** The filter key where child selections are stored in FiltersState */
+        filterKey: string;
+        /** Child options, which can themselves have children for infinite nesting */
+        options: Array<InFilterOptionItem<T>>;
+    };
 };
 
 /**
@@ -7537,7 +7564,7 @@ export declare function useSchemaDefinition(schema: F0FormSchema, sections?: Rec
  * 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, allPagesSelection, }: 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, resetOnPageChange, }: 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>;
@@ -7567,6 +7594,12 @@ export declare type UseSelectableProps<R extends RecordType, Filters extends Fil
      * - itemStatus only includes items from the current page
      */
     allPagesSelection?: boolean;
+    /**
+     * When true (default), clears selection when the page changes
+     * (unless all items are selected). Set to false to persist
+     * selections across page changes unconditionally.
+     */
+    resetOnPageChange?: boolean;
 };
 
 export declare type UseSelectableReturn<R extends RecordType, Filters extends FiltersDefinition> = {
@@ -7596,9 +7629,14 @@ export declare type UseSelectableReturn<R extends RecordType, Filters extends Fi
      */
     handleSelectItemChange: (itemOrId: R | SelectionId | readonly SelectionId[], checked: boolean) => void;
     /**
-     * Handles the change of the selected all items
+     * Handles "select all" for the current page only
      */
     handleSelectAll: (checked: boolean) => void;
+    /**
+     * Handles "select all items" across all pages (full dataset).
+     * Only meaningful when allPagesSelection is enabled.
+     */
+    handleSelectAllItems: (checked: boolean) => void;
     /**
      * Handles the change of the selected group.
      * Accepts either SelectionId(s) or a GroupRecord.
@@ -7777,6 +7815,11 @@ declare module "gridstack" {
 }
 
 
+declare namespace Calendar {
+    var displayName: string;
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -7824,8 +7867,3 @@ declare module "@tiptap/core" {
         };
     }
 }
-
-
-declare namespace Calendar {
-    var displayName: string;
-}