@factorialco/f0-react 2.36.1 → 2.37.1

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

@@ -37,7 +37,6 @@ import { DotTagCellValue as DotTagCellValue_2 } from './experimental';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
 import { Editor } from '@tiptap/react';
 import { EmployeeItemProps } from './types';
-import { F0NumberInputProps as F0NumberInputProps_2 } from './F0NumberInput';
 import { F0SegmentedControlProps as F0SegmentedControlProps_2 } from './types';
 import { F0SelectProps as F0SelectProps_2 } from './types';
 import { F0TagBalanceProps as F0TagBalanceProps_2 } from './types';
@@ -45,8 +44,6 @@ import { F0TagCompanyProps } from './types';
 import { F0TagPersonProps } from './types';
 import { F0TagRawProps as F0TagRawProps_2 } from './types';
 import { F0TagTeamProps } from './types';
-import { F0TextAreaInputProps as F0TextAreaInputProps_2 } from './F0TextAreaInput';
-import { F0TextInputProps as F0TextInputProps_2 } from './F0TextInput';
 import { f1Colors } from '@factorialco/f0-core';
 import { FC } from 'react';
 import { FileCellValue } from './types/file';
@@ -2624,6 +2621,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) */
@@ -5383,7 +5394,7 @@ export declare type InfiniteScrollPaginatedResponse<TRecord> = BasePaginatedResp
  *
  * @removeIn 2.0.0
  */
-export declare const Input: <T extends string>(props: F0TextInputProps_2<T>) => JSX_2.Element;
+export declare const Input: <T extends string>(props: F0TextInputProps<T>) => JSX_2.Element;
 
 declare const Input_2: React_2.ForwardRefExoticComponent<Omit<React_2.InputHTMLAttributes<HTMLInputElement>, "onChange" | "size"> & Pick<InputFieldProps<string>, "label" | "onChange" | "size" | "icon" | "role" | "onFocus" | "onBlur" | "transparent" | "status" | "loading" | "disabled" | "maxLength" | "required" | "error" | "append" | "hideLabel" | "hint" | "labelIcon" | "onClickContent" | "readonly" | "clearable" | "autocomplete" | "onClear" | "isEmpty" | "emptyValue" | "hideMaxLength" | "appendTag" | "lengthProvider" | "buttonToggle"> & React_2.RefAttributes<HTMLInputElement>>;
 
@@ -5485,7 +5496,7 @@ declare type InputInternalProps<T extends string> = Pick<ComponentProps<typeof I
  * @deprecated Renamed to `F0TextInputProps`. See the `Input` deprecation note.
  * @removeIn 2.0.0
  */
-export declare type InputProps<T extends string> = F0TextInputProps_2<T>;
+export declare type InputProps<T extends string> = F0TextInputProps<T>;
 
 declare interface InsertAfterNotesTextEditorPageDocumentPatch {
     type: "insert_after";
@@ -6082,7 +6093,7 @@ declare type NumberFilterValue = {
  *
  * @removeIn 2.0.0
  */
-export declare const NumberInput: (props: F0NumberInputProps_2) => JSX_2.Element;
+export declare const NumberInput: (props: F0NumberInputProps) => JSX_2.Element;
 
 declare type NumberInputInternalProps = Omit<InputInternalProps<string>, "value" | "type" | "onChange"> & {
     locale: string;
@@ -6118,7 +6129,7 @@ export declare interface NumberInputPopoverConfig {
  * deprecation note.
  * @removeIn 2.0.0
  */
-export declare type NumberInputProps = F0NumberInputProps_2;
+export declare type NumberInputProps = F0NumberInputProps;
 
 declare type Numeric = NumericValue | number | undefined | null;
 
@@ -6387,6 +6398,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
      */
@@ -7915,7 +7933,7 @@ declare type TeamTagProps = ComponentProps<typeof F0TagTeam>;
  *
  * @removeIn 2.0.0
  */
-export declare const Textarea: FC<F0TextAreaInputProps_2>;
+export declare const Textarea: FC<F0TextAreaInputProps>;
 
 declare const Textarea_2: ForwardRefExoticComponent<Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "value" | "onChange" | "onFocus" | "onBlur"> & {
 value?: string;
@@ -7928,7 +7946,7 @@ maxHeight?: number;
  * deprecation note.
  * @removeIn 2.0.0
  */
-export declare type TextareaProps = F0TextAreaInputProps_2;
+export declare type TextareaProps = F0TextAreaInputProps;
 
 export declare type TOCItem<Depth extends 1 | 2 | 3 | 4 = 1> = BaseTOCItem & {
     children?: NextDepth<Depth> extends never ? never : TOCItem<NextDepth<Depth>>[];

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

@@ -59,7 +59,6 @@ import { F0FormDefinition as F0FormDefinition_2 } from './f0';
 import { F0FormDefinitionPerSection as F0FormDefinitionPerSection_2 } from './f0';
 import { F0FormDefinitionSingleSchema as F0FormDefinitionSingleSchema_2 } from './f0';
 import { F0GridStackProps as F0GridStackProps_2 } from './F0GridStack';
-import { F0NumberInputProps as F0NumberInputProps_2 } from './F0NumberInput';
 import { F0SelectProps as F0SelectProps_2 } from './types';
 import { F0TagBalanceProps } from './types';
 import { F0TagCompanyProps } from './types';
@@ -68,8 +67,6 @@ import { F0TagPersonProps as F0TagPersonProps_2 } from './types';
 import { F0TagRawProps } from './types';
 import { F0TagStatusProps } from './types';
 import { F0TagTeamProps } from './types';
-import { F0TextAreaInputProps as F0TextAreaInputProps_2 } from './F0TextAreaInput';
-import { F0TextInputProps as F0TextInputProps_2 } from './F0TextInput';
 import { F0TimelineRowProps as F0TimelineRowProps_2 } from './types';
 import { f1Colors } from '@factorialco/f0-core';
 import { FC } from 'react';
@@ -1634,6 +1631,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 +3502,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 +3658,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 +3823,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) */
@@ -11012,7 +11073,7 @@ export declare function injectSectionEnds(items: FlatFormItem[], inSectionQuesti
  *
  * @removeIn 2.0.0
  */
-export declare const Input: <T extends string>(props: F0TextInputProps_2<T>) => JSX_2.Element;
+export declare const Input: <T extends string>(props: F0TextInputProps<T>) => JSX_2.Element;
 
 declare const Input_2: React_2.ForwardRefExoticComponent<Omit<React_2.InputHTMLAttributes<HTMLInputElement>, "onChange" | "size"> & Pick<InputFieldProps<string>, "label" | "onChange" | "size" | "icon" | "role" | "onFocus" | "onBlur" | "transparent" | "status" | "loading" | "disabled" | "maxLength" | "required" | "error" | "append" | "hideLabel" | "hint" | "labelIcon" | "onClickContent" | "readonly" | "clearable" | "autocomplete" | "onClear" | "isEmpty" | "emptyValue" | "hideMaxLength" | "appendTag" | "lengthProvider" | "buttonToggle"> & React_2.RefAttributes<HTMLInputElement>>;
 
@@ -11118,7 +11179,7 @@ declare type InputInternalProps<T extends string> = Pick<ComponentProps<typeof I
  * @deprecated Renamed to `F0TextInputProps`. See the `Input` deprecation note.
  * @removeIn 2.0.0
  */
-export declare type InputProps<T extends string> = F0TextInputProps_2<T>;
+export declare type InputProps<T extends string> = F0TextInputProps<T>;
 
 declare interface InsertAfterNotesTextEditorPageDocumentPatch {
     type: "insert_after";
@@ -11411,6 +11472,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;
@@ -11881,7 +11954,7 @@ declare type NumberFilterValue = {
  *
  * @removeIn 2.0.0
  */
-export declare const NumberInput: (props: F0NumberInputProps_2) => JSX_2.Element;
+export declare const NumberInput: (props: F0NumberInputProps) => JSX_2.Element;
 
 declare type NumberInputInternalProps = Omit<InputInternalProps<string>, "value" | "type" | "onChange"> & {
     locale: string;
@@ -11917,7 +11990,7 @@ export declare interface NumberInputPopoverConfig {
  * deprecation note.
  * @removeIn 2.0.0
  */
-export declare type NumberInputProps = F0NumberInputProps_2;
+export declare type NumberInputProps = F0NumberInputProps;
 
 /**
  * Base for number-specific conditions
@@ -12390,6 +12463,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 +13542,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 +13842,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"> & {
@@ -14089,7 +14193,7 @@ declare type TeamTagProps = ComponentProps<typeof F0TagTeam>;
  *
  * @removeIn 2.0.0
  */
-export declare const Textarea: FC<F0TextAreaInputProps_2>;
+export declare const Textarea: FC<F0TextAreaInputProps>;
 
 declare const Textarea_2: ForwardRefExoticComponent<Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "value" | "onChange" | "onFocus" | "onBlur"> & {
 value?: string;
@@ -14107,7 +14211,7 @@ declare type TextareaFieldRenderIf = TextRenderIfCondition | CommonRenderIfCondi
  * deprecation note.
  * @removeIn 2.0.0
  */
-export declare type TextareaProps = F0TextAreaInputProps_2;
+export declare type TextareaProps = F0TextAreaInputProps;
 
 /**
  * All valid renderIf conditions for text fields
@@ -15360,6 +15464,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";