@factorialco/f0-react 1.254.0 → 1.255.0

package/dist/f0.d.ts

@@ -1115,6 +1115,7 @@ declare type DataCollectionSourceDefinition<R extends RecordType = RecordType, F
      */
     /** Navigation filters */
     navigationFilters?: NavigationFilters;
+    currentNavigationFilters?: NavigationFiltersState<NavigationFilters>;
     /** URL for a single item in the collection */
     itemUrl?: (item: R) => string | undefined;
     /** Click handler for a single item in the collection */
@@ -1186,19 +1187,27 @@ export declare type DataSource<R extends RecordType, Filters extends FiltersDefi
     setCurrentFilters: React.Dispatch<React.SetStateAction<FiltersState<Filters>>>;
     /** Whether presets are currently loading */
     presetsLoading?: boolean;
+    /***** SORTINGS ***************************************************/
     /** Current state of applied sortings */
     currentSortings: SortingsState<Sortings>;
     /** Function to update the current sortings state */
     setCurrentSortings: React.Dispatch<React.SetStateAction<SortingsState<Sortings>>>;
+    /*******************************************************/
+    /***** SEARCH ***************************************************/
     currentSearch: undefined | string;
     debouncedCurrentSearch: undefined | string;
     setCurrentSearch: (search: string | undefined) => void;
+    /*******************************************************/
+    /***** LOADING ***************************************************/
     isLoading: boolean;
     setIsLoading: (loading: boolean) => void;
+    /*******************************************************/
+    /***** GROUPING ***************************************************/
     /** Current state of applied grouping */
     currentGrouping?: Grouping["mandatory"] extends true ? Exclude<GroupingState<R, Grouping>, undefined> : GroupingState<R, Grouping>;
     /** Function to update the current grouping state */
     setCurrentGrouping: React.Dispatch<React.SetStateAction<GroupingState<R, Grouping>>>;
+    /*******************************************************/
     /** Function to provide an id for a record, necessary for append mode */
     idProvider?: <Item extends R>(item: Item, index?: number) => string | number | symbol;
     /** Item filter that can be used to filter the items before they are displayed */
@@ -1219,27 +1228,42 @@ export declare type DataSource<R extends RecordType, Filters extends FiltersDefi
  * @template Summaries - The available summaries for the collection
  */
 export declare type DataSourceDefinition<R extends RecordType = RecordType, Filters extends FiltersDefinition = FiltersDefinition, Sortings extends SortingsDefinition = SortingsDefinition, Grouping extends GroupingDefinition<R> = GroupingDefinition<R>> = {
+    /***** FILTERS ***************************************************/
     /** Available filter configurations */
     filters?: Filters;
+    /** Default filters state (this is the state that the source will back on reset)*/
+    defaultFilters?: FiltersState<Filters>;
     /** Current state of applied filters */
     currentFilters?: FiltersState<Filters>;
     /** Predefined filter configurations that can be applied */
     presets?: PresetsDefinition<Filters>;
     /** Whether presets are currently loading */
     presetsLoading?: boolean;
+    /*******************************************************/
+    /***** SEARCH ***************************************************/
     /** Search configuration */
     search?: SearchOptions;
+    /*******************************************************/
+    /***** SORTINGS ***************************************************/
     /** Available sorting fields. If not provided, sorting is not allowed. */
     sortings?: Sortings;
-    defaultSorting?: SortingsState<Sortings>;
+    /** Default sorting state (this is the state that the source will back on reset)*/
+    defaultSortings?: SortingsState<Sortings>;
+    /** Current state of applied sortings */
+    currentSortings?: SortingsState<Sortings>;
+    /*******************************************************/
     /** Data adapter responsible for fetching and managing data */
     dataAdapter: DataAdapter<R, Filters>;
     /** Selectable items value under the checkbox column (undefined if not selectable) */
     selectable?: (item: R) => string | number | undefined;
     /** Default selected items */
     defaultSelectedItems?: SelectedItemsState;
+    /***** GROUPING ***************************************************/
     /** Grouping configuration */
     grouping?: Grouping;
+    /** Default grouping state (this is the state that the source will back on reset)*/
+    defaultGrouping?: GroupingState<R, Grouping>;
+    /** Current state of applied grouping */
     currentGrouping?: GroupingState<R, Grouping>;
 };
 
@@ -3735,7 +3759,7 @@ export declare interface UseDataReturn<R extends RecordType> {
  * - actions: Available actions for the collection
  * - presets: Available filter presets
  */
-export declare function useDataSource<R extends RecordType = RecordType, FiltersSchema extends FiltersDefinition = FiltersDefinition, Sortings extends SortingsDefinition = SortingsDefinition, Grouping extends GroupingDefinition<R> = GroupingDefinition<R>>({ currentFilters: initialCurrentFilters, currentGrouping: initialCurrentGrouping, filters, search, defaultSorting, dataAdapter, grouping, ...rest }: DataSourceDefinition<R, FiltersSchema, Sortings, Grouping>, deps?: ReadonlyArray<unknown>): DataSource<R, FiltersSchema, Sortings, Grouping>;
+export declare function useDataSource<R extends RecordType = RecordType, FiltersSchema extends FiltersDefinition = FiltersDefinition, Sortings extends SortingsDefinition = SortingsDefinition, Grouping extends GroupingDefinition<R> = GroupingDefinition<R>>({ defaultFilters, currentFilters: externalCurrentFilters, defaultGrouping: externalDefaultGrouping, currentGrouping: externalCurrentGrouping, filters, search, defaultSortings, currentSortings: externalCurrentSortings, dataAdapter, grouping, ...rest }: DataSourceDefinition<R, FiltersSchema, Sortings, Grouping>, deps?: ReadonlyArray<unknown>): DataSource<R, FiltersSchema, Sortings, Grouping>;
 
 export declare function useDndEvents(handler: (e: {
     phase: "start" | "over" | "drop" | "cancel";

package/dist/f0.js

@@ -1,5 +1,5 @@
-import { S as xe, a as mt, f as ne, L as K, b as ht, A as vt, i as J, c as yt, d as Te, E as bt, g as X, e as gt, h as xt, C as wt, j as Pt, k as $, l as Fe, u as St, G as Ct, m as Nt, n as we, o as At, p as Ie, q as Ot, B as _e, X as Ee, Y as le, r as kt, s as je, t as Lt, v as Dt, w as Tt, x as Ft, y as It, z as _t, D as Et, F as jt, H as Pe, I as $t, J as W, K as oe, M as Bt, N as Mt, O as Rt, P as $e, Q as E, R as I, T as zt, U as Kt, V as Wt, W as qt, Z as Gt, _ as Vt, $ as Yt, a0 as Be, a1 as Ut, a2 as Z, a3 as Me, a4 as Re, a5 as Ht, a6 as ze, a7 as Ke, a8 as We, a9 as qe, aa as Jt, ab as Ge, ac as Xt, ad as Zt, ae as Qt, af as Se, ag as ie, ah as ea, ai as ta, aj as Ve, ak as aa, al as ra, am as Ye, an as na, ao as oa, ap as ia, aq as sa, ar as la, as as ca, at as ua, au as da, av as Ue, aw as M, ax as He, ay as fa, az as pa, aA as Ce, aB as ma, aC as Je, aD as ha, aE as va, aF as ya, aG as ba, aH as ga, aI as xa, aJ as wa, aK as Pa, aL as Sa, aM as Ca, aN as Na, aO as Aa } from "./hooks-CCnHcgjZ.js";
-import { bp as tn, br as an, bA as rn, aP as nn, aQ as on, aR as sn, aS as ln, aT as cn, aU as un, aV as dn, aW as fn, aY as pn, aZ as mn, a_ as hn, a$ as vn, b0 as yn, b1 as bn, bw as gn, b3 as xn, b5 as wn, b6 as Pn, b7 as Sn, b8 as Cn, bb as Nn, bc as An, bd as On, bf as kn, b4 as Ln, be as Dn, ba as Tn, bx as Fn, bq as In, bk as _n, bn as En, bj as jn, bB as $n, bi as Bn, bh as Mn, aX as Rn, b2 as zn, b9 as Kn, bg as Wn, bl as qn, bs as Gn, bt as Vn, bu as Yn, bC as Un, bm as Hn, bv as Jn, bz as Xn, bo as Zn, by as Qn } from "./hooks-CCnHcgjZ.js";
+import { S as xe, a as mt, f as ne, L as K, b as ht, A as vt, i as J, c as yt, d as Te, E as bt, g as X, e as gt, h as xt, C as wt, j as Pt, k as $, l as Fe, u as St, G as Ct, m as Nt, n as we, o as At, p as Ie, q as Ot, B as _e, X as Ee, Y as le, r as kt, s as je, t as Lt, v as Dt, w as Tt, x as Ft, y as It, z as _t, D as Et, F as jt, H as Pe, I as $t, J as W, K as oe, M as Bt, N as Mt, O as Rt, P as $e, Q as E, R as I, T as zt, U as Kt, V as Wt, W as qt, Z as Gt, _ as Vt, $ as Yt, a0 as Be, a1 as Ut, a2 as Z, a3 as Me, a4 as Re, a5 as Ht, a6 as ze, a7 as Ke, a8 as We, a9 as qe, aa as Jt, ab as Ge, ac as Xt, ad as Zt, ae as Qt, af as Se, ag as ie, ah as ea, ai as ta, aj as Ve, ak as aa, al as ra, am as Ye, an as na, ao as oa, ap as ia, aq as sa, ar as la, as as ca, at as ua, au as da, av as Ue, aw as M, ax as He, ay as fa, az as pa, aA as Ce, aB as ma, aC as Je, aD as ha, aE as va, aF as ya, aG as ba, aH as ga, aI as xa, aJ as wa, aK as Pa, aL as Sa, aM as Ca, aN as Na, aO as Aa } from "./hooks-BdJAFEQs.js";
+import { bp as tn, br as an, bA as rn, aP as nn, aQ as on, aR as sn, aS as ln, aT as cn, aU as un, aV as dn, aW as fn, aY as pn, aZ as mn, a_ as hn, a$ as vn, b0 as yn, b1 as bn, bw as gn, b3 as xn, b5 as wn, b6 as Pn, b7 as Sn, b8 as Cn, bb as Nn, bc as An, bd as On, bf as kn, b4 as Ln, be as Dn, ba as Tn, bx as Fn, bq as In, bk as _n, bn as En, bj as jn, bB as $n, bi as Bn, bh as Mn, aX as Rn, b2 as zn, b9 as Kn, bg as Wn, bl as qn, bs as Gn, bt as Vn, bu as Yn, bC as Un, bm as Hn, bv as Jn, bz as Xn, bo as Zn, by as Qn } from "./hooks-BdJAFEQs.js";
 import { jsx as n, jsxs as C, Fragment as ae } from "react/jsx-runtime";
 import * as fe from "react";
 import k, { PureComponent as Oa, useState as D, forwardRef as V, useEffect as B, useMemo as se, useCallback as Ne, useRef as pe, useImperativeHandle as ka, Children as La, createContext as Da } from "react";