@factorialco/f0-react 4.0.4 → 4.2.0

package/dist/ai.js

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

package/dist/experimental.d.ts

@@ -2975,6 +2975,8 @@ declare interface DatePickerPopupProps {
     asChild?: boolean;
     onCompareToChange?: (compareTo: DateRangeComplete | DateRangeComplete[] | undefined) => void;
     weekStartsOn?: WeekStartsOn;
+    /** When true, switching granularity only changes the view; selection and close happen only on a cell click. Default false. */
+    selectOnCellOnly?: boolean;
 }
 
 export declare type DatePickerValue = {
@@ -6916,7 +6918,7 @@ export declare const OneCalendar: WithDataTestIdReturnType_2<    {
 displayName: string;
 }>;
 
-export declare const OneCalendarInternal: ({ mode, view, onSelect, defaultMonth, defaultSelected, showNavigation, showInput, minDate, maxDate, compact, weekStartsOn, }: OneCalendarInternalProps) => JSX_2.Element;
+export declare const OneCalendarInternal: ({ mode, view, onSelect, defaultMonth, defaultSelected, showNavigation, showInput, minDate, maxDate, compact, weekStartsOn, selectOnCellOnly, }: OneCalendarInternalProps) => JSX_2.Element;
 
 export declare interface OneCalendarInternalProps {
     mode: CalendarMode;
@@ -6930,6 +6932,8 @@ export declare interface OneCalendarInternalProps {
     maxDate?: Date;
     compact?: boolean;
     weekStartsOn?: WeekStartsOn;
+    /** When true, a granularity change updates the view without emitting `onSelect`. Default false. */
+    selectOnCellOnly?: boolean;
 }
 
 export declare type OneCalendarProps = Omit<OneCalendarInternalProps, (typeof privateProps_6)[number]>;

package/dist/experimental.js

@@ -1,9 +1,9 @@
-import { h as ga, B as pa, i as ba, j as xa, k as Dt, l as Be, m as Te, n as va, o as b, p as J, q as ye, u as oe, T as ya, r as wa, s as Na, R as Ca, t as Ia, v as ce, w as ka, x as Nt, y as ut, z as Ve, A as Le, E as Sa, G as Fa, H as U, J as Aa, K as La, L as xe, M as mn, N as Oa, O as Pa, Q as H, S as hn, U as z, V as ke, W as Ea, X as _a, Y as Da, Z as Ta, _ as za, $ as Oe, a0 as gn, a1 as Ra, a2 as we, a3 as Ue, a4 as Ba, e as pn, a5 as Ae, a6 as $a, a7 as bn, a8 as ie, a9 as X, aa as xn, ab as vn, ac as Ma, ad as yn, ae as pe, af as ae, ag as Wa, ah as ja, ai as Va, aj as Ua, ak as ve, al as Ye, am as Ha, an as Ga, ao as Ka, ap as qa, aq as Je, ar as wn, as as Ya, at as Ja, au as Za, av as He, aw as Xa, ax as Nn, ay as Qa, az as er, aA as tr, aB as nr, aC as ar, aD as rr, aE as ir, aF as lr, aG as ft, aH as Cn, aI as mt, aJ as In, aK as sr, aL as or, aM as cr, aN as dr, aO as ur, aP as Ze, aQ as Xe, aR as ht, aS as kn, aT as fr, aU as Ct, aV as mr, aW as hr, aX as gr, aY as Re, aZ as pr, a_ as br, a$ as $e, b0 as Tt, b1 as gt, b2 as xr, b3 as vr, a as yr, b as wr, b4 as Sn, b5 as Nr, g as Cr, F as Ir, b6 as kr, b7 as Fn, b8 as Sr, b9 as An, ba as Ln, bb as Fr, bc as Ar, bd as Lr, be as Or, bf as Pr, bg as Er, bh as _r, bi as Dr, bj as Tr, bk as On, bl as zr, bm as Rr, bn as Br, bo as $r, bp as ge, bq as It, br as kt, bs as St, bt as Pn, bu as Ft, bv as En, bw as _n, bx as Mr, by as Wr, bz as jr, bA as Vr, bB as Ur, bC as Hr, bD as Gr, bE as Kr, bF as zt, bG as qr, bH as Yr, bI as Rt, bJ as Bt, bK as $t, bL as Jr, bM as Zr, bN as Xr, bO as Qr, bP as Dn, bQ as ei, bR as ti } from "./F0CanvasPanel-BEfffklz.js";
-import { c2 as Kc, c1 as qc, ce as Yc, b_ as Jc, b$ as Zc, bS as Xc, bT as Qc, ch as ed, bU as td, bV as nd, ci as ad, c0 as rd, ca as id, cb as ld, cf as sd, bW as od, c4 as cd, c3 as dd, bX as ud, bY as fd, cc as md, cj as hd, cd as gd, cg as pd, c9 as bd, c6 as xd, c8 as vd, c5 as yd, bZ as wd, c7 as Nd } from "./F0CanvasPanel-BEfffklz.js";
+import { h as ga, B as pa, i as ba, j as xa, k as Dt, l as Be, m as Te, n as va, o as b, p as J, q as ye, u as oe, T as ya, r as wa, s as Na, R as Ca, t as Ia, v as ce, w as ka, x as Nt, y as ut, z as Ve, A as Le, E as Sa, G as Fa, H as U, J as Aa, K as La, L as xe, M as mn, N as Oa, O as Pa, Q as H, S as hn, U as z, V as ke, W as Ea, X as _a, Y as Da, Z as Ta, _ as za, $ as Oe, a0 as gn, a1 as Ra, a2 as we, a3 as Ue, a4 as Ba, e as pn, a5 as Ae, a6 as $a, a7 as bn, a8 as ie, a9 as X, aa as xn, ab as vn, ac as Ma, ad as yn, ae as pe, af as ae, ag as Wa, ah as ja, ai as Va, aj as Ua, ak as ve, al as Ye, am as Ha, an as Ga, ao as Ka, ap as qa, aq as Je, ar as wn, as as Ya, at as Ja, au as Za, av as He, aw as Xa, ax as Nn, ay as Qa, az as er, aA as tr, aB as nr, aC as ar, aD as rr, aE as ir, aF as lr, aG as ft, aH as Cn, aI as mt, aJ as In, aK as sr, aL as or, aM as cr, aN as dr, aO as ur, aP as Ze, aQ as Xe, aR as ht, aS as kn, aT as fr, aU as Ct, aV as mr, aW as hr, aX as gr, aY as Re, aZ as pr, a_ as br, a$ as $e, b0 as Tt, b1 as gt, b2 as xr, b3 as vr, a as yr, b as wr, b4 as Sn, b5 as Nr, g as Cr, F as Ir, b6 as kr, b7 as Fn, b8 as Sr, b9 as An, ba as Ln, bb as Fr, bc as Ar, bd as Lr, be as Or, bf as Pr, bg as Er, bh as _r, bi as Dr, bj as Tr, bk as On, bl as zr, bm as Rr, bn as Br, bo as $r, bp as ge, bq as It, br as kt, bs as St, bt as Pn, bu as Ft, bv as En, bw as _n, bx as Mr, by as Wr, bz as jr, bA as Vr, bB as Ur, bC as Hr, bD as Gr, bE as Kr, bF as zt, bG as qr, bH as Yr, bI as Rt, bJ as Bt, bK as $t, bL as Jr, bM as Zr, bN as Xr, bO as Qr, bP as Dn, bQ as ei, bR as ti } from "./F0CanvasPanel-BIGiuzKy.js";
+import { c2 as Kc, c1 as qc, ce as Yc, b_ as Jc, b$ as Zc, bS as Xc, bT as Qc, ch as ed, bU as td, bV as nd, ci as ad, c0 as rd, ca as id, cb as ld, cf as sd, bW as od, c4 as cd, c3 as dd, bX as ud, bY as fd, cc as md, cj as hd, cd as gd, cg as pd, c9 as bd, c6 as xd, c8 as vd, c5 as yd, bZ as wd, c7 as Nd } from "./F0CanvasPanel-BIGiuzKy.js";
 import { jsx as e, jsxs as o, Fragment as Z } from "react/jsx-runtime";
 import ue, { forwardRef as G, useRef as j, useTransition as ni, useState as D, useLayoutEffect as Tn, useId as pt, useContext as Pe, createContext as Qe, useEffect as W, useCallback as ne, useMemo as q, Fragment as ai, isValidElement as ri, cloneElement as zn, Children as Rn } from "react";
-import { C as ii, P as li, a as Bn, M as si, p as oi, b as ci, R as Mt, c as $n, u as di, d as ui, e as fi, f as mi, g as hi, h as Mn, S as gi, A as pi, B as bi, L as xi, i as vi, V as yi, j as wi, k as Ni, l as Ci, O as Ii } from "./useDataCollectionSource-BIPtqfqk.js";
-import { r as Id, s as kd, o as Sd, H as Fd, t as Ad, z as Ld, a8 as Od, G as Pd, q as Ed, aa as _d, a9 as Dd, Q as Td, ad as zd, F as Rd, Y as Bd, U as $d, J as Md, af as Wd, K as jd, Z as Vd, _ as Ud, v as Hd, ab as Gd, ac as Kd, N as qd, $ as Yd, a5 as Jd, a7 as Zd, w as Xd, y as Qd, D as eu, W as tu, ae as nu, X as au, T as ru, ag as iu, x as lu, E as su, m as ou, n as cu, a1 as du, a2 as uu, a6 as fu, I as mu, a3 as hu, a0 as gu, a4 as pu } from "./useDataCollectionSource-BIPtqfqk.js";
+import { C as ii, P as li, a as Bn, M as si, p as oi, b as ci, R as Mt, c as $n, u as di, d as ui, e as fi, f as mi, g as hi, h as Mn, S as gi, A as pi, B as bi, L as xi, i as vi, V as yi, j as wi, k as Ni, l as Ci, O as Ii } from "./useDataCollectionSource-DD8fxq_z.js";
+import { r as Id, s as kd, o as Sd, H as Fd, t as Ad, z as Ld, a8 as Od, G as Pd, q as Ed, aa as _d, a9 as Dd, Q as Td, ad as zd, F as Rd, Y as Bd, U as $d, J as Md, af as Wd, K as jd, Z as Vd, _ as Ud, v as Hd, ab as Gd, ac as Kd, N as qd, $ as Yd, a5 as Jd, a7 as Zd, w as Xd, y as Qd, D as eu, W as tu, ae as nu, X as au, T as ru, ag as iu, x as lu, E as su, m as ou, n as cu, a1 as du, a2 as uu, a6 as fu, I as mu, a3 as hu, a0 as gu, a4 as pu } from "./useDataCollectionSource-DD8fxq_z.js";
 const ki = ga("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

@@ -4115,6 +4115,8 @@ declare interface DatePickerPopupProps {
     asChild?: boolean;
     onCompareToChange?: (compareTo: DateRangeComplete | DateRangeComplete[] | undefined) => void;
     weekStartsOn?: WeekStartsOn;
+    /** When true, switching granularity only changes the view; selection and close happen only on a cell click. Default false. */
+    selectOnCellOnly?: boolean;
 }
 
 export declare const datepickerSizes: readonly ["sm", "md"];
@@ -8045,9 +8047,9 @@ declare type F0DateOrDateTimeFieldConfig = F0DateFieldConfig | F0TimeFieldConfig
 
 export declare const F0DatePicker: WithDataTestIdReturnType_3<typeof F0DatePicker_2>;
 
-declare function F0DatePicker_2({ onChange, value, presets, granularities, minDate, maxDate, open, showIcon, displayFormat, ...inputProps }: F0DatePickerProps): JSX_2.Element;
+declare function F0DatePicker_2({ onChange, value, presets, granularities, minDate, maxDate, open, showIcon, displayFormat, selectOnCellOnly, ...inputProps }: F0DatePickerProps): JSX_2.Element;
 
-export declare type F0DatePickerProps = Pick<DatePickerPopupProps, "granularities" | "minDate" | "maxDate" | "presets" | "open" | "onOpenChange"> & {
+export declare type F0DatePickerProps = Pick<DatePickerPopupProps, "granularities" | "minDate" | "maxDate" | "presets" | "open" | "onOpenChange" | "selectOnCellOnly"> & {
     showIcon?: boolean;
     /** Controls how the selected date is displayed in the input. Defaults to "long" (e.g. "01 Aug 2025"). Use "default" for dd/MM/yyyy. */
     displayFormat?: DateStringFormat;
@@ -8359,7 +8361,7 @@ export declare interface F0FAQItem {
 /**
  * Union of all F0 field types used for rendering
  */
-export declare type F0Field = F0TextField | F0NumberField | F0DurationField | F0TextareaField | F0SelectField | F0CheckboxField | F0SwitchField | F0DateField | F0TimeField | F0DateTimeField | F0DateRangeField | F0RichTextField | F0FileField | F0CardSelectField | F0CustomField;
+export declare type F0Field = F0TextField | F0NumberField | F0DurationField | F0TextareaField | F0SelectField | F0CheckboxField | F0SwitchField | F0DateField | F0TimeField | F0DateTimeField | F0DateRangeField | F0PeriodField | F0RichTextField | F0FileField | F0CardSelectField | F0CustomField;
 
 /**
  * Alert configuration for a field.
@@ -8394,12 +8396,12 @@ export declare type F0FieldAlertProps = Omit<F0AlertProps, "variant"> & {
  * @typeParam T - The value type for select fields (string or number)
  * @typeParam R - Record type for data source (when using source instead of options)
  */
-export declare type F0FieldConfig<T extends string | number = string | number, R extends Record<string, unknown> = Record<string, unknown>> = F0StringConfig<string, undefined, R> | F0NumberFieldConfig<R> | F0BooleanConfig | F0DateFieldConfig | F0TimeFieldConfig | F0DateTimeFieldConfig | F0ArrayConfig<T, R> | F0FileFieldConfig | F0ObjectConfig | F0StringCardSelectConfig;
+export declare type F0FieldConfig<T extends string | number = string | number, R extends Record<string, unknown> = Record<string, unknown>> = F0StringConfig<string, undefined, R> | F0NumberFieldConfig<R> | F0BooleanConfig | F0DateFieldConfig | F0TimeFieldConfig | F0DateTimeFieldConfig | F0ArrayConfig<T, R> | F0FileFieldConfig | F0ObjectConfig | F0PeriodFieldConfig | F0StringCardSelectConfig;
 
 /**
  * Field types for rendering
  */
-export declare type F0FieldType = "text" | "number" | "percentage" | "money" | "duration" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "file" | "cardSelect" | "custom";
+export declare type F0FieldType = "text" | "number" | "percentage" | "money" | "duration" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "period" | "richtext" | "file" | "cardSelect" | "custom";
 
 export declare type F0FileAction = {
     icon?: IconType;
@@ -8746,6 +8748,12 @@ export declare function f0FormField<T extends z.ZodArray<ZodTypeAny>, V extends
  */
 export declare function f0FormField<T extends z.ZodObject<z.ZodRawShape>, TConfig = undefined>(schema: T, config: F0ObjectConfig<z.infer<T>, TConfig>): T & F0ZodType<T>;
 
+/**
+ * Period field - date navigator that preserves the full DatePickerValue.
+ * Use with `z.custom<DatePickerValue>()` (or its optional/nullable wrappers).
+ */
+export declare function f0FormField<T extends ZodTypeAny>(schema: T, config: F0PeriodFieldConfig): T & F0ZodType<T>;
+
 /**
  * Optional wrapper - inherits inner type's config
  * @typeParam V - The value type for select fields (string or number)
@@ -8916,6 +8924,14 @@ export declare namespace f0FormField {
     export function dateRange(config: DateRangeConfig & {
         optional?: false | undefined;
     }): DateRangeObjectSchema & F0ZodType<DateRangeObjectSchema>;
+    /* Excluded from this release type: PeriodValueSchema */
+    /* Excluded from this release type: DatePeriodConfig */
+    export function datePeriod(config: DatePeriodConfig & {
+        optional: true;
+    }): z.ZodOptional<z.ZodNullable<PeriodValueSchema>> & F0ZodType<z.ZodOptional<z.ZodNullable<PeriodValueSchema>>>;
+    export function datePeriod(config: DatePeriodConfig & {
+        optional?: false | undefined;
+    }): PeriodValueSchema & F0ZodType<PeriodValueSchema>;
     /* Excluded from this release type: RichTextObjectSchema */
     /* Excluded from this release type: RichTextConfig */
     export function richText(config: RichTextConfig & {
@@ -9763,6 +9779,70 @@ export declare type F0OneSwitchProps = React.ComponentPropsWithoutRef<typeof Swi
     autoOpen?: boolean;
 };
 
+/**
+ * F0 config options specific to period fields.
+ *
+ * A period field reuses `F0DatePicker` exactly like the `date` field, but keeps
+ * the full `DatePickerValue` (`{ value: { from, to }, granularity }`) as the
+ * form value instead of collapsing it to a single `Date`. This lets a form
+ * declare a real "period" selector (Year / Half year / Quarter / Month / Range).
+ *
+ * Note: `clearable` is derived from the Zod schema (optional/nullable).
+ */
+export declare interface F0PeriodConfig {
+    /** Available granularities for the period picker */
+    granularities?: DateGranularity[];
+    /** Preset period options to display */
+    presets?: DatePreset[];
+    /**
+     * Controls how the selected period is displayed in the input.
+     * Defaults to "long" (e.g. "01 Aug 2025"). Use "default" for dd/MM/yyyy.
+     */
+    displayFormat?: DateStringFormat;
+    /**
+     * Minimum selectable date.
+     * Can be a static Date or a function that receives form values for dynamic constraints.
+     * @example
+     * // Static constraint
+     * minDate: new Date("2024-01-01")
+     *
+     * // Dynamic constraint based on another field
+     * minDate: ({ values }) => values.startDate
+     */
+    minDate?: F0DateConstraintProp;
+    /**
+     * Maximum selectable date.
+     * Can be a static Date or a function that receives form values for dynamic constraints.
+     * @example
+     * // Static constraint
+     * maxDate: new Date("2025-12-31")
+     *
+     * // Dynamic constraint based on another field
+     * maxDate: ({ values }) => values.endDate
+     */
+    maxDate?: F0DateConstraintProp;
+}
+
+/**
+ * Period field with all properties for rendering.
+ * Includes properties derived from the Zod schema.
+ */
+export declare type F0PeriodField = F0BaseField & F0PeriodConfig & {
+    type: "period";
+    /** Whether the period can be cleared (derived from optional/nullable) */
+    clearable?: boolean;
+    /** Conditional rendering based on another field's value */
+    renderIf?: PeriodFieldRenderIf;
+};
+
+/**
+ * Config for period fields (date navigator that preserves the full
+ * DatePickerValue: `{ value: { from, to }, granularity }`).
+ */
+export declare type F0PeriodFieldConfig = F0BaseConfig & F0PeriodConfig & {
+    fieldType: "period";
+};
+
 /**
  * A record mapping section IDs to their individual schemas.
  * When used, each section gets independent validation and its own submit button.
@@ -10740,6 +10820,39 @@ export declare interface F0TimelineRowTaskProps extends F0TimelineRowBaseProps {
     otherActions?: F0TimelineRowOtherAction[];
 }
 
+declare type F0ToastProps = {
+    /**
+     * The title of the toast
+     */
+    title?: string;
+    /**
+     * The description of the toast
+     */
+    description?: string;
+    /**
+     * The variant of the toast
+     */
+    variant?: F0ToastVariant;
+    /**
+     * The duration of the toast in milliseconds (if not provided, the toast will stay open until the user closes it)
+     */
+    duration?: number;
+    /**
+     * Whether the toast is paused. If true, the duraction timer will not tick in anycase
+     */
+    forcePauseTimer?: boolean;
+    /**
+     * The callback to be called when the toast is closed
+     */
+    onClose?: () => void;
+    /**
+     * The actions to display in the toast ()
+     */
+    actions?: ToastActionButton | [ToastActionButton] | ToastActionLink | [ToastActionLink] | [ToastActionButton, ToastActionLink];
+};
+
+declare type F0ToastVariant = (typeof toastVariants)[number];
+
 /**
  * Loose message shape used inside f0. Mirrors the CopilotKit `Message`
  * shape so adapters (factorial, mock runtime) can map back and forth
@@ -10901,7 +11014,7 @@ export declare function fieldsToSeconds(fields: DurationFields): number;
 /**
  * Field types for rendering
  */
-export declare type FieldType = "text" | "number" | "duration" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "file" | "cardSelect" | "custom";
+export declare type FieldType = "text" | "number" | "duration" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "period" | "richtext" | "file" | "cardSelect" | "custom";
 
 export declare const FILE_TYPES: {
     readonly PDF: "pdf";
@@ -13195,7 +13308,7 @@ export declare const OneCalendar: WithDataTestIdReturnType_3<    {
 displayName: string;
 }>;
 
-export declare const OneCalendarInternal: ({ mode, view, onSelect, defaultMonth, defaultSelected, showNavigation, showInput, minDate, maxDate, compact, weekStartsOn, }: OneCalendarInternalProps) => JSX_2.Element;
+export declare const OneCalendarInternal: ({ mode, view, onSelect, defaultMonth, defaultSelected, showNavigation, showInput, minDate, maxDate, compact, weekStartsOn, selectOnCellOnly, }: OneCalendarInternalProps) => JSX_2.Element;
 
 export declare interface OneCalendarInternalProps {
     mode: CalendarMode;
@@ -13209,6 +13322,8 @@ export declare interface OneCalendarInternalProps {
     maxDate?: Date;
     compact?: boolean;
     weekStartsOn?: WeekStartsOn;
+    /** When true, a granularity change updates the view without emitting `onSelect`. Default false. */
+    selectOnCellOnly?: boolean;
 }
 
 export declare type OneCalendarProps = Omit<OneCalendarInternalProps, (typeof privateProps_6)[number]>;
@@ -13496,6 +13611,21 @@ declare type PendingQuote = {
     text: string;
 };
 
+declare type PeriodFieldRenderIf = PeriodRenderIfCondition | CommonRenderIfCondition | F0BaseFieldRenderIfFunction;
+
+declare interface PeriodRenderIfBase {
+    fieldId: string;
+}
+
+/**
+ * RenderIf conditions specific to period fields.
+ * The value is a `DatePickerValue` object, so only `isEmpty` is meaningful
+ * (same approach as date range fields).
+ */
+export declare type PeriodRenderIfCondition = PeriodRenderIfBase & {
+    isEmpty: boolean;
+};
+
 /**
  * Creates a union of `[sectionId, data]` pairs for each key in T.
  * Used to build a callback where TypeScript narrows `data` based on `sectionId`.
@@ -14159,7 +14289,7 @@ declare interface RenderIfBase {
 /**
  * Union of all possible RenderIf conditions (used internally for evaluation)
  */
-export declare type RenderIfCondition = CommonRenderIfCondition | TextRenderIfCondition | NumberRenderIfCondition | BooleanRenderIfCondition | SelectRenderIfCondition | DateRenderIfCondition | DateRangeRenderIfCondition;
+export declare type RenderIfCondition = CommonRenderIfCondition | TextRenderIfCondition | NumberRenderIfCondition | BooleanRenderIfCondition | SelectRenderIfCondition | DateRenderIfCondition | DateRangeRenderIfCondition | PeriodRenderIfCondition;
 
 export declare interface ReplaceBlockNotesTextEditorPageDocumentPatch {
     type: "replace_block";
@@ -15432,6 +15562,111 @@ export declare type TimelineRowStatus = (typeof timelineRowStatuses)[number];
 
 export declare const timelineRowStatuses: readonly ["completed", "in-progress", "not-started"];
 
+declare type ToastActionButton = {
+    type: "button";
+    label: string;
+    onClick: () => void;
+    icon?: IconType;
+    /**
+     * If true, the toast will not be closed automatically when the action is clicked.
+     */
+    keepOpen?: boolean;
+};
+
+declare type ToastActionLink = {
+    type: "link";
+    label: string;
+    href: string;
+    /**
+     * If true, the toast will not be closed automatically when the action is clicked.
+     */
+    keepOpen?: boolean;
+};
+
+export declare type ToastId = string;
+
+export declare type ToastOptions = {
+    /**
+     * The title of the toast
+     */
+    title?: string;
+    /**
+     * The description of the toast
+     */
+    description?: string;
+    /**
+     * The variant of the toast
+     */
+    variant?: F0ToastVariant;
+    /**
+     * The actions to display in the toast
+     */
+    actions?: F0ToastProps["actions"];
+    /**
+     * Optional id for the toast. If not provided, a random id will be generated.
+     */
+    id?: ToastId;
+} & ({
+    /**
+     * The duration of the toast in milliseconds (if not provided, the toast will stay open until the user closes it)
+     * @default 5000
+     */
+    duration?: number;
+    /**
+     * Whether the toast should persist until the user closes it
+     */
+    persistent?: undefined;
+} | {
+    duration?: undefined;
+    persistent: true;
+});
+
+export declare const ToastProvider: ({ children, portalTargets, }: ToastProviderProps) => JSX_2.Element;
+
+/**
+ * A toast as held by the store: the public options resolved into the props the
+ * `F0Toast` component renders, plus a stable `id` and an `onClose` callback.
+ */
+export declare type ToastProviderItem = F0ToastProps & {
+    id: ToastId;
+    onClose: () => void;
+};
+
+declare type ToastProviderProps = {
+    children: React.ReactNode;
+    portalTargets?: Record<"mobile" | "desktop", string>;
+};
+
+/**
+ * Imperative API for toast notifications. Can be called from anywhere — no hook
+ * required — as long as `<F0Provider>` (which mounts `ToastProvider`) is in the
+ * tree.
+ *
+ * @example
+ * import { toasts } from "@factorialco/f0-react"
+ *
+ * const id = toasts.open({ title: "Saved", variant: "success" })
+ * toasts.close(id)
+ * toasts.closeAll()
+ */
+export declare const toasts: {
+    /**
+     * Show a toast.
+     * @param options The options for the toast
+     * @returns The id of the created toast (pass it to `toasts.close` to dismiss it)
+     */
+    open: (options: ToastOptions) => ToastId;
+    /**
+     * Dismiss a toast by id.
+     * @param id The id returned by `toasts.open`
+     */
+    close: (id: ToastId) => void;
+    /** Dismiss every open toast. */
+    closeAll: () => void;
+};
+
+declare const toastVariants: readonly ["error", "warning", "success", "default"];
+
 /** A button rendered in the footer at the bottom of the table of contents */
 declare type TOCAction = {
     label: string;
@@ -16241,6 +16476,16 @@ export declare const useGroups: <R extends RecordType>(groups: GroupRecord<R>[],
     setGroupOpen: (key: string, open: boolean) => void;
 };
 
+/**
+ * Returns true when the viewport width is >= 640px (Tailwind's `sm` breakpoint).
+ */
+export declare const useIsDesktop: () => boolean;
+
+/**
+ * Returns true when the viewport width is < 640px (below Tailwind's `sm` breakpoint).
+ */
+export declare const useIsMobile: () => boolean;
+
 /**
  * Resolves the previous/next neighbours of an item through the adapter's
  * optional id-relative `fetchItemNeighbors` capability.