@factorialco/f0-react 2.36.1 → 2.37.0

package/dist/ai.js

@@ -1,6 +1,6 @@
-import { D as e, F as r, a as t, e as o, f as i, c as n, d as F, I as C, P as A, b as l, u as d } from "./F0CanvasPanel-CzqKtOrT.js";
+import { D as e, F as r, a as t, e as o, f as i, c as n, d as F, I as C, P as A, b as l, u as d } from "./F0CanvasPanel-BErabj-B.js";
 import { defaultTranslations as m } from "./i18n-provider-defaults.js";
-import { A as c, C as I, h as P, t as v, v as f, x as p, n as T, j as g, r as y, y as S, q as x, s as H, k as V, e as b, g as k, l as w, F as M, i as O, a as D, p as j, m as q, o as z, b as B, f as E, w as L, c as R, d as G, u as J } from "./useChatHistory-D4MyhT2a.js";
+import { A as c, C as I, h as P, t as v, v as f, x as p, n as T, j as g, r as y, y as S, q as x, s as H, k as V, e as b, g as k, l as w, F as M, i as O, a as D, p as j, m as q, o as z, b as B, f as E, w as L, c as R, d as G, u as J } from "./useChatHistory-DBzFU3JU.js";
 export {
   c as AiChatTranslationsProvider,
   I as ChatSpinner,

package/dist/experimental.d.ts

@@ -2624,6 +2624,20 @@ export declare type DataSourceDefinition<R extends RecordType = RecordType, Filt
     /** Current state of applied sortings */
     currentSortings?: SortingsState<Sortings>;
     /*******************************************************/
+    /***** PAGINATION ***************************************************/
+    /**
+     * Initial page to fetch (1-indexed) for page-based pagination. Applied on the
+     * first load only; the page resets to 1 whenever filters/search/sortings
+     * change (as it always has). Useful for restoring a page from the URL.
+     */
+    currentPage?: number;
+    /**
+     * Called whenever the pagination info changes — e.g. the user navigates to a
+     * different page. Lets a consumer observe the current page (to persist it in
+     * the URL, analytics, etc.) without owning the pagination state.
+     */
+    onPaginationChange?: (paginationInfo: PaginationInfo | null) => void;
+    /*******************************************************/
     /** Data adapter responsible for fetching and managing data */
     dataAdapter: DataAdapter<R, Filters>;
     /** Selectable items value under the checkbox column (undefined if not selectable) */
@@ -6387,6 +6401,13 @@ declare type OneDataCollectionProps<R extends RecordType, Filters extends Filter
          */
         features?: DataCollectionStorageFeaturesDefinition;
     };
+    /**
+     * By default, when an `id` is set, the data collection reads its
+     * filters/search/sortings from the URL query params on mount and reflects any
+     * later changes back into them (see `dataCollectionUrlParams`). Set this to
+     * `true` to opt out of that URL syncing.
+     */
+    disableUrlParams?: boolean;
     /**
      * @deprecated removes the horizontal padding from the data collection
      */

package/dist/experimental.js

@@ -1,9 +1,9 @@
-import { g as da, B as ua, h as fa, i as ma, j as At, k as De, l as ha, m as p, n as X, o as be, u as ie, T as pa, p as ba, q as ga, R as xa, r as va, s as re, t as wa, v as pt, w as rt, x as Re, A as _e, y as ya, z as Na, C as M, E as Ca, G as ka, H as ve, J as sn, K as Sa, L as Ia, M as W, N as on, S as O, O as we, Q as Fa, U as Aa, V as La, W as Ea, X as _a, Y as ke, Z as cn, _ as Oa, $ as ge, a0 as $e, a1 as Da, a2 as bt, d as dn, a3 as Ce, a4 as Ta, a5 as un, a6 as ne, a7 as K, a8 as fn, a9 as mn, aa as za, ab as hn, ac as me, ad as ee, ae as Pa, af as Ba, ag as Ra, ah as $a, ai as pe, aj as Ge, ak as Wa, al as Ma, am as ja, an as Va, ao as He, ap as pn, aq as Ga, ar as Ha, as as Ua, at as We, au as Ka, av as qa, aw as Ya, ax as Za, ay as Xa, az as Ja, aA as Qa, aB as er, aC as tr, aD as nr, aE as lt, aF as it, aG as bn, aH as ar, aI as rr, aJ as lr, aK as ir, aL as Ue, aM as gt, aN as gn, aO as sr, aP as xn, aQ as or, aR as cr, aS as dr, aT as Ee, aU as ur, aV as Te, aW as Lt, aX as st, aY as fr, aZ as mr, a as hr, b as pr, a_ as vn, a$ as br, f as gr, F as xr, b0 as wn, b1 as vr, b2 as yn, b3 as wr, b4 as yr, b5 as Nr, b6 as Cr, b7 as kr, b8 as Sr, b9 as Ir, ba as Fr, bb as Ar, bc as Nn, bd as ue, be as xt, bf as vt, bg as wt, bh as Cn, bi as yt, bj as kn, bk as Sn, bl as Lr, bm as Er, bn as _r, bo as Or, bp as Dr, bq as Tr, br as zr, bs as Pr, bt as Br, bu as Rr, bv as Et, bw as _t, bx as Ot, by as $r, bz as Wr, bA as Mr, bB as jr, bC as In, bD as Vr, bE as Gr } from "./F0CanvasPanel-CzqKtOrT.js";
-import { bQ as Lc, bP as Ec, c0 as _c, bM as Oc, bN as Dc, bF as Tc, bG as zc, bH as Pc, c1 as Bc, bO as Rc, bY as $c, bZ as Wc, bI as Mc, bS as jc, bR as Vc, bJ as Gc, bK as Hc, b_ as Uc, c2 as Kc, b$ as qc, bX as Yc, bU as Zc, bW as Xc, bT as Jc, bL as Qc, bV as ed } from "./F0CanvasPanel-CzqKtOrT.js";
+import { g as da, B as ua, h as fa, i as ma, j as At, k as De, l as ha, m as p, n as X, o as be, u as ie, T as pa, p as ba, q as ga, R as xa, r as va, s as re, t as wa, v as pt, w as rt, x as Re, A as _e, y as ya, z as Na, C as M, E as Ca, G as ka, H as ve, J as sn, K as Sa, L as Ia, M as W, N as on, S as O, O as we, Q as Fa, U as Aa, V as La, W as Ea, X as _a, Y as ke, Z as cn, _ as Oa, $ as ge, a0 as $e, a1 as Da, a2 as bt, d as dn, a3 as Ce, a4 as Ta, a5 as un, a6 as ne, a7 as K, a8 as fn, a9 as mn, aa as za, ab as hn, ac as me, ad as ee, ae as Pa, af as Ba, ag as Ra, ah as $a, ai as pe, aj as Ge, ak as Wa, al as Ma, am as ja, an as Va, ao as He, ap as pn, aq as Ga, ar as Ha, as as Ua, at as We, au as Ka, av as qa, aw as Ya, ax as Za, ay as Xa, az as Ja, aA as Qa, aB as er, aC as tr, aD as nr, aE as lt, aF as it, aG as bn, aH as ar, aI as rr, aJ as lr, aK as ir, aL as Ue, aM as gt, aN as gn, aO as sr, aP as xn, aQ as or, aR as cr, aS as dr, aT as Ee, aU as ur, aV as Te, aW as Lt, aX as st, aY as fr, aZ as mr, a as hr, b as pr, a_ as vn, a$ as br, f as gr, F as xr, b0 as wn, b1 as vr, b2 as yn, b3 as wr, b4 as yr, b5 as Nr, b6 as Cr, b7 as kr, b8 as Sr, b9 as Ir, ba as Fr, bb as Ar, bc as Nn, bd as ue, be as xt, bf as vt, bg as wt, bh as Cn, bi as yt, bj as kn, bk as Sn, bl as Lr, bm as Er, bn as _r, bo as Or, bp as Dr, bq as Tr, br as zr, bs as Pr, bt as Br, bu as Rr, bv as Et, bw as _t, bx as Ot, by as $r, bz as Wr, bA as Mr, bB as jr, bC as In, bD as Vr, bE as Gr } from "./F0CanvasPanel-BErabj-B.js";
+import { bQ as Lc, bP as Ec, c0 as _c, bM as Oc, bN as Dc, bF as Tc, bG as zc, bH as Pc, c1 as Bc, bO as Rc, bY as $c, bZ as Wc, bI as Mc, bS as jc, bR as Vc, bJ as Gc, bK as Hc, b_ as Uc, c2 as Kc, b$ as qc, bX as Yc, bU as Zc, bW as Xc, bT as Jc, bL as Qc, bV as ed } from "./F0CanvasPanel-BErabj-B.js";
 import { jsx as e, jsxs as o, Fragment as U } from "react/jsx-runtime";
 import se, { forwardRef as j, useRef as G, useTransition as Hr, useState as _, useLayoutEffect as Fn, useId as ot, useContext as Ke, createContext as Nt, useEffect as $, useCallback as Q, useMemo as q, Fragment as Ur, isValidElement as Kr, cloneElement as An, Children as Ln } from "react";
-import { C as qr, P as Yr, g as En, c as Zr, a as _n, F as ct, f as Xr, M as Jr, b as Qr, R as Dt, d as On, u as el, e as Dn, S as tl, A as nl, B as al, L as rl, h as ll, V as il, i as sl, j as Tt, k as ol, l as cl, O as dl } from "./useDataCollectionSource-BNAFV8q4.js";
-import { r as nd, s as ad, p as rd, H as ld, t as id, z as sd, a9 as od, G as cd, q as dd, Q as ud, o as fd, Y as md, U as hd, J as pd, af as bd, K as gd, Z as xd, _ as vd, v as wd, ab as yd, ac as Nd, aa as Cd, ad as kd, N as Sd, $ as Id, a6 as Fd, a8 as Ad, w as Ld, y as Ed, D as _d, W as Od, ae as Dd, X as Td, T as zd, x as Pd, E as Bd, m as Rd, n as $d, a1 as Wd, a2 as Md, a7 as jd, I as Vd, a3 as Gd, a4 as Hd, a0 as Ud, a5 as Kd } from "./useDataCollectionSource-BNAFV8q4.js";
+import { C as qr, P as Yr, g as En, c as Zr, a as _n, F as ct, f as Xr, M as Jr, b as Qr, R as Dt, d as On, u as el, e as Dn, S as tl, A as nl, B as al, L as rl, h as ll, V as il, i as sl, j as Tt, k as ol, l as cl, O as dl } from "./useDataCollectionSource-O4gVVcoQ.js";
+import { r as nd, s as ad, p as rd, H as ld, t as id, z as sd, a9 as od, G as cd, q as dd, Q as ud, o as fd, Y as md, U as hd, J as pd, af as bd, K as gd, Z as xd, _ as vd, v as wd, ab as yd, ac as Nd, aa as Cd, ad as kd, N as Sd, $ as Id, a6 as Fd, a8 as Ad, w as Ld, y as Ed, D as _d, W as Od, ae as Dd, X as Td, T as zd, x as Pd, E as Bd, m as Rd, n as $d, a1 as Wd, a2 as Md, a7 as jd, I as Vd, a3 as Gd, a4 as Hd, a0 as Ud, a5 as Kd } from "./useDataCollectionSource-O4gVVcoQ.js";
 const ul = da("Search", [
   ["circle", { cx: "11", cy: "11", r: "8", key: "4ej97u" }],
   ["path", { d: "m21 21-4.3-4.3", key: "1qie3q" }]

package/dist/f0.d.ts

@@ -1634,6 +1634,12 @@ declare const boxVariants: (props?: ({
 /** Supported breakpoints */
 export declare type Breakpoint = "sm" | "md" | "lg" | "xl";
 
+/**
+ * Builds a fresh `URLSearchParams` encoding a data collection `id` and state,
+ * symmetric with {@link parseDataCollectionUrlParams}. Always sets `dc_id`.
+ */
+export declare const buildDataCollectionUrlParams: <CurrentFiltersState extends FiltersState<FiltersDefinition> = FiltersState<FiltersDefinition>>(id: string, state?: DataCollectionUrlState<CurrentFiltersState>) => URLSearchParams;
+
 export declare const buildTranslations: (translations: TranslationsType) => TranslationsType;
 
 /**
@@ -3499,6 +3505,29 @@ export declare type Data<R extends RecordType> = {
     groups: GroupRecord<R>[];
 };
 
+/**
+ * Every data collection URL param shares this prefix, so each filter is its own
+ * readable param — e.g. `?dc_id=people/v1&dc_department=Sales&dc_search=ada`
+ * instead of a single JSON blob.
+ */
+export declare const DATA_COLLECTION_URL_PARAM_PREFIX = "dc_";
+
+/**
+ * The reserved (non-filter) param names. Individual filters are encoded as
+ * `dc_<filterKey>`; these three names are written last (via `set`) so that on
+ * the rare clash where a filter key is exactly `id`, `search` or `sort`, the
+ * reserved param wins.
+ */
+export declare const DATA_COLLECTION_URL_PARAMS: {
+    readonly id: "dc_id";
+    readonly search: "dc_search";
+    readonly sortings: "dc_sort";
+    /** Active visualization type/key, e.g. `table` (omitted for the default one). */
+    readonly visualization: "dc_view";
+    /** Current page (1-indexed; omitted for the first page). */
+    readonly page: "dc_page";
+};
+
 /**
  * Combined type for all possible data adapter configurations
  * @template R - The type of records in the collection
@@ -3632,6 +3661,27 @@ export declare type DataCollectionStorageHandler<CurrentFiltersState extends Fil
     set: (key: string, storage: DataCollectionStorage<CurrentFiltersState>) => Promise<void>;
 };
 
+/** How {@link syncDataCollectionUrlParams} should update the browser history. */
+export declare type DataCollectionUrlHistoryMode = "replace" | "push" | "none";
+
+export declare type DataCollectionUrlParams<CurrentFiltersState extends FiltersState<FiltersDefinition> = FiltersState<FiltersDefinition>> = {
+    id: string;
+    state: DataCollectionUrlState<CurrentFiltersState>;
+};
+
+/** The subset of a data collection's state we read from / write to the URL. */
+export declare type DataCollectionUrlState<CurrentFiltersState extends FiltersState<FiltersDefinition> = FiltersState<FiltersDefinition>> = Pick<DataCollectionStorage<CurrentFiltersState>, "filters" | "search" | "sortings"> & {
+    /**
+     * Active visualization, addressed by its **type/key** (e.g. `"table"`,
+     * `"kanban"`) rather than a positional index — readable and stable across
+     * reordering. Mapping to/from the index is the caller's job (the data
+     * collection knows the visualization list).
+     */
+    visualization?: string;
+    /** Current page (1-indexed). Not part of persisted storage — URL only. */
+    page?: number;
+};
+
 /**
  * Data download canvas content — renders a full data table with download options.
  */
@@ -3776,6 +3826,20 @@ export declare type DataSourceDefinition<R extends RecordType = RecordType, Filt
     /** Current state of applied sortings */
     currentSortings?: SortingsState<Sortings>;
     /*******************************************************/
+    /***** PAGINATION ***************************************************/
+    /**
+     * Initial page to fetch (1-indexed) for page-based pagination. Applied on the
+     * first load only; the page resets to 1 whenever filters/search/sortings
+     * change (as it always has). Useful for restoring a page from the URL.
+     */
+    currentPage?: number;
+    /**
+     * Called whenever the pagination info changes — e.g. the user navigates to a
+     * different page. Lets a consumer observe the current page (to persist it in
+     * the URL, analytics, etc.) without owning the pagination state.
+     */
+    onPaginationChange?: (paginationInfo: PaginationInfo | null) => void;
+    /*******************************************************/
     /** Data adapter responsible for fetching and managing data */
     dataAdapter: DataAdapter<R, Filters>;
     /** Selectable items value under the checkbox column (undefined if not selectable) */
@@ -11411,6 +11475,18 @@ export declare type MaskOptions = {
 
 declare const MAX_EXPANDED_ACTIONS = 2;
 
+/**
+ * Maximum number of values a single filter may contribute to the URL.
+ *
+ * A multi-select (`in`) filter materializes one URL param per selected value,
+ * so "select all" over a large or paginated data source would otherwise dump
+ * hundreds of ids into the query string (bloated, and beyond browser/server URL
+ * length limits). Past this cap the filter is left out of the URL — it is still
+ * applied in-memory and persisted via storage, just not shareable through the
+ * URL. Deliberately conservative; tune if a use case needs more.
+ */
+export declare const MAX_URL_FILTER_VALUES = 25;
+
 export declare type MentionedUser = {
     id: string | number;
     label: string;
@@ -12390,6 +12466,17 @@ export declare type PaginationInfo = Omit<PageBasedPaginatedResponse<unknown>, "
  */
 export declare type PaginationType = "pages" | "infinite-scroll" | "no-pagination";
 
+/**
+ * Parses the data collection identifier and state out of URL query params.
+ *
+ * @param input - A query string, a `URLSearchParams`, or omitted to read from
+ *                `window.location.search`.
+ * @param filtersDefinition - Needed to decode the `dc_<filterKey>` params back
+ *                into correctly-typed filter values. Omit to skip filters.
+ * @returns `{ id, state }`, or `null` when no `dc_id` is present.
+ */
+export declare const parseDataCollectionUrlParams: <CurrentFiltersState extends FiltersState<FiltersDefinition> = FiltersState<FiltersDefinition>>(input?: string | URLSearchParams, filtersDefinition?: FiltersDefinition) => DataCollectionUrlParams<CurrentFiltersState> | null;
+
 declare type PathsToStringProps<T> = T extends string ? [] : {
     [K in Extract<keyof T, string>]: [K, ...PathsToStringProps<T[K]>];
 }[Extract<keyof T, string>];
@@ -13458,6 +13545,14 @@ export declare const selectSizes: readonly ["sm", "md"];
  */
 declare type SelectValueType = string | number;
 
+/**
+ * Writes a data collection's current filters/search/sortings onto an existing
+ * query string, preserving any unrelated params. Every `dc_`-prefixed param is
+ * rebuilt from `state`, so cleared filters drop out and an entirely empty state
+ * leaves the URL free of `dc_` params (rather than a bare `?dc_id=<id>`).
+ */
+export declare const setDataCollectionUrlParams: <CurrentFiltersState extends FiltersState<FiltersDefinition> = FiltersState<FiltersDefinition>>(current: string | URLSearchParams | undefined, id: string, state: DataCollectionUrlState<CurrentFiltersState>) => URLSearchParams;
+
 declare type SetFormCardValueFormatter = <T = unknown>(entry: FormCardValueFormatterEntry<T>) => void;
 
 /**
@@ -13750,6 +13845,18 @@ export declare type SurveySubmitAnswers = Record<string, string | number | boole
  */
 declare type SwitchFieldRenderIf = BooleanRenderIfCondition | CommonRenderIfCondition | F0BaseFieldRenderIfFunction;
 
+/**
+ * Reflects a data collection's current filters/search/sortings into the URL.
+ *
+ * Pairs with {@link parseDataCollectionUrlParams} (which reads the other way).
+ * `OneDataCollection` wires this up by default when an `id` is set.
+ *
+ * @returns The resulting query string (no leading `?`), or `null` under SSR.
+ */
+export declare const syncDataCollectionUrlParams: <CurrentFiltersState extends FiltersState<FiltersDefinition> = FiltersState<FiltersDefinition>>(id: string, state: DataCollectionUrlState<CurrentFiltersState>, options?: {
+    history?: DataCollectionUrlHistoryMode;
+}) => string | null;
+
 declare type TableCollectionProps<R extends RecordType, Filters extends FiltersDefinition, Sortings extends SortingsDefinition, Summaries extends SummariesDefinition, ItemActions extends ItemActionsDefinition<R>, NavigationFilters extends NavigationFiltersDefinition, Grouping extends GroupingDefinition<R>> = CollectionProps<R, Filters, Sortings, Summaries, ItemActions, NavigationFilters, Grouping, TableVisualizationOptions<R, Filters, Sortings, Summaries>>;
 
 declare type TableColumnDefinition<R extends RecordType, Sortings extends SortingsDefinition, Summaries extends SummariesDefinition> = WithOptionalSorting<R, Sortings> & Pick<ComponentProps<typeof TableHead>, "hidden" | "info" | "infoIcon" | "sticky" | "width" | "minWidth"> & {
@@ -15360,6 +15467,15 @@ declare interface WithTooltipDescription {
     description?: string;
 }
 
+/**
+ * Synchronously persists a OneDataCollection's state to localStorage, mirroring
+ * `readDataCollectionStorage`. Uses the same `datacollection-` prefixed key as
+ * `dataCollectionLocalStorageHandler` so the component hydrates from it.
+ *
+ * @param id - The OneDataCollection `id`, WITHOUT the `datacollection-` prefix.
+ */
+export declare const writeDataCollectionStorage: <CurrentFiltersState extends FiltersState<FiltersDefinition> = FiltersState<FiltersDefinition>>(id: string, storage: DataCollectionStorage<CurrentFiltersState>) => void;
+
 /** z-index values */
 export declare type ZIndexToken = "auto" | "0" | "10" | "20" | "30" | "40" | "50";