@factorialco/f0-react 1.435.0 → 1.436.1

package/dist/{F0HILActionConfirmation-zvTnEJgf.js → F0HILActionConfirmation-CMnMjtvP.js}

@@ -1,7 +1,7 @@
 import { defaultTranslations as ke } from "./i18n-provider-defaults.js";
 import { jsx as q, jsxs as le } from "react/jsx-runtime";
 import { useInsertionEffect as Xe, createContext as Ye, useContext as $e, useRef as B, useEffect as ie, useState as Ue, useCallback as qe, useMemo as He } from "react";
-import { r as Ke, l as je, m as Qe, n as Je, o as Me, p as Ze, q as et, s as tt, t as rt, v as nt, w as Ne, x as ot, V as it, y as st, z as at, A as ct, S as ut, H as lt, B as se, D as ft, E as dt, G as ht, J as mt, K as pt, L as vt, M as fe, N as gt } from "./F0AiChat-BsYN-CYp.js";
+import { r as Ke, l as je, m as Qe, n as Je, o as Me, p as Ze, q as et, s as tt, t as rt, v as nt, w as Ne, x as ot, V as it, y as st, z as at, A as ct, S as ut, H as lt, B as se, D as ft, E as dt, G as ht, J as mt, K as pt, L as vt, M as fe, N as gt } from "./F0AiChat-Cg05PVK9.js";
 import { useTrackVolume as wt } from "@livekit/components-react";
 function Tt(t, e, r) {
   Xe(() => t.on(e, r), [t, e, r]);

package/dist/ai.d.ts

@@ -237,6 +237,10 @@ declare type AiChatProviderReturnValue = {
     inProgress: boolean;
     /** Set the in-progress state (synced from CopilotKit's isLoading) */
     setInProgress: (value: boolean) => void;
+    /** The current clarifying question shown in the textarea, or null if none */
+    clarifyingQuestion: ClarifyingQuestionState | null;
+    /** Set the current clarifying question (or null to dismiss) */
+    setClarifyingQuestion: React.Dispatch<React.SetStateAction<ClarifyingQuestionState | null>>;
 } & Pick<AiChatState, "greeting" | "agent" | "disclaimer" | "resizable" | "entityRefs" | "toolHints" | "credits" | "fileAttachments"> & {
     /** The current canvas content, or null when canvas is closed */
     canvasContent: CanvasContent | null;
@@ -422,6 +426,15 @@ export declare const aiTranslations: {
         };
         readonly attachFile: "Attach file";
         readonly removeFile: "Remove";
+        readonly clarifyingQuestion: {
+            readonly submit: "Submit";
+            readonly next: "Next";
+            readonly back: "Back";
+            readonly typeYourAnswer: "Type your answer…";
+            readonly stepOf: "{{current}} of {{total}}";
+            readonly custom: "own answer";
+            readonly skipped: "skipped";
+        };
         readonly growth: {
             readonly demoCard: {
                 readonly title: "See {{moduleName}} in action";
@@ -672,6 +685,81 @@ declare type ChatTextareaProps = InputProps & {
     onGetCredits?: () => void;
 };
 
+/**
+ * A single selectable option within a clarifying question step.
+ */
+declare interface ClarifyingOption {
+    /** Unique identifier for this option */
+    id: string;
+    /** Display label shown to the user */
+    label: string;
+}
+
+/**
+ * The active clarifying question state pushed into the AiChat context.
+ * When no clarifying question is active the context value is `null`.
+ *
+ * Navigation metadata (currentStepIndex, totalSteps) and callbacks live
+ * here so the panel component stays a pure view of this state.
+ */
+declare interface ClarifyingQuestionState {
+    /** The current step's data + interaction state */
+    currentStep: ClarifyingStepState;
+    /** Zero-based index of the current step */
+    currentStepIndex: number;
+    /** Total number of steps (1 for single-step questions) */
+    totalSteps: number;
+    /** Toggle selection of an option by its ID */
+    toggleOption: (optionId: string) => void;
+    /** Confirm the current step's selection and advance (or submit on final step) */
+    confirm: () => void;
+    /** Go back to the previous step */
+    back: () => void;
+    /** Set the custom answer text */
+    setCustomAnswerText: (text: string) => void;
+    /** Toggle whether the custom answer is included in the submission */
+    setCustomAnswerActive: (active: boolean) => void;
+    /** Activate the custom answer input (in single mode, clears predefined selections) */
+    activateCustomAnswer: () => void;
+}
+
+/**
+ * Selection mode for a clarifying question step.
+ * - "single": only one option can be selected (rendered as radio buttons)
+ * - "multiple": multiple options can be selected (rendered as checkboxes)
+ */
+declare type ClarifyingSelectionMode = "single" | "multiple";
+
+/**
+ * Pure data describing a single clarifying question step.
+ * This is what the AI backend sends — no UI state or callbacks.
+ */
+declare interface ClarifyingStepData {
+    /** The question text displayed to the user */
+    question: string;
+    /** Available options the user can select from */
+    options: ClarifyingOption[];
+    /** Selection mode. Defaults to "single" when omitted */
+    selectionMode?: ClarifyingSelectionMode;
+    /** Whether the user can skip this step without selecting any option */
+    optional?: boolean;
+    /** Whether the user can type a free-text custom answer */
+    allowCustomAnswer?: boolean;
+}
+
+/**
+ * A step enriched with the user's current interaction state.
+ * Used internally by the controller to track selections per step.
+ */
+declare interface ClarifyingStepState extends ClarifyingStepData {
+    /** IDs of currently selected options */
+    selectedOptionIds: string[];
+    /** Current custom answer text (preserved even when deactivated) */
+    customAnswerText?: string;
+    /** Whether the custom answer is currently included in the submission */
+    isCustomAnswerActive: boolean;
+}
+
 declare interface CollectionComputation {
     datasetId: string;
     sortBy?: string;
@@ -1163,6 +1251,15 @@ export declare const defaultTranslations: {
         };
         readonly attachFile: "Attach file";
         readonly removeFile: "Remove";
+        readonly clarifyingQuestion: {
+            readonly submit: "Submit";
+            readonly next: "Next";
+            readonly back: "Back";
+            readonly typeYourAnswer: "Type your answer…";
+            readonly stepOf: "{{current}} of {{total}}";
+            readonly custom: "own answer";
+            readonly skipped: "skipped";
+        };
         readonly growth: {
             readonly demoCard: {
                 readonly title: "See {{moduleName}} in action";
@@ -1872,6 +1969,11 @@ declare module "gridstack" {
 }
 
 
+declare namespace Calendar {
+    var displayName: string;
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -1919,8 +2021,3 @@ declare module "@tiptap/core" {
         };
     }
 }
-
-
-declare namespace Calendar {
-    var displayName: string;
-}

package/dist/ai.js

@@ -1,6 +1,6 @@
-import { i as t, h as i, F as e, a as n, C as o, b as r, j as A, k as c, I as u, g as F, c as h, d as C, u as l, f as I, e as f } from "./F0AiChat-BsYN-CYp.js";
+import { i as t, h as i, F as e, a as n, C as o, b as r, j as A, k as c, I as u, g as F, c as h, d as C, u as l, f as I, e as f } from "./F0AiChat-Cg05PVK9.js";
 import { defaultTranslations as d } from "./i18n-provider-defaults.js";
-import { A as p, F as S, c as g, d as v, b as x, a as k, o as O, u as P } from "./F0HILActionConfirmation-zvTnEJgf.js";
+import { A as p, F as S, c as g, d as v, b as x, a as k, o as O, u as P } from "./F0HILActionConfirmation-CMnMjtvP.js";
 export {
   p as AiChatTranslationsProvider,
   t as ChatSpinner,

package/dist/experimental.d.ts

@@ -2849,6 +2849,15 @@ declare const defaultTranslations: {
         };
         readonly attachFile: "Attach file";
         readonly removeFile: "Remove";
+        readonly clarifyingQuestion: {
+            readonly submit: "Submit";
+            readonly next: "Next";
+            readonly back: "Back";
+            readonly typeYourAnswer: "Type your answer…";
+            readonly stepOf: "{{current}} of {{total}}";
+            readonly custom: "own answer";
+            readonly skipped: "skipped";
+        };
         readonly growth: {
             readonly demoCard: {
                 readonly title: "See {{moduleName}} in action";
@@ -7506,6 +7515,11 @@ declare module "gridstack" {
 }
 
 
+declare namespace Calendar {
+    var displayName: string;
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -7553,8 +7567,3 @@ declare module "@tiptap/core" {
         };
     }
 }
-
-
-declare namespace Calendar {
-    var displayName: string;
-}

package/dist/experimental.js

@@ -1,10 +1,10 @@
-import { cN as Uu, cO as Gu, cP as Ku, a1 as qu, cQ as uo, cR as Un, cS as Yu, cT as ms, cU as _i, cV as br, K as k, R as X, L as rt, u as me, cW as Ju, cX as Xu, cY as Zu, cZ as Qu, c_ as ef, af as Le, c$ as tf, a0 as Pt, d0 as nf, b3 as rf, _ as H, b9 as sf, ba as of, U as $t, d1 as Yl, bi as lf, bc as af, M as $, d2 as gs, Z as T, d3 as it, d4 as cf, d5 as df, bd as uf, au as ff, bf as hf, aC as Bt, d6 as Jl, d7 as pf, d8 as At, aV as xn, av as bs, aw as on, k as Xl, a4 as pt, d9 as Zl, da as mf, db as fo, dc as Qt, dd as ws, de as Mn, df as wr, dg as gf, dh as Ql, di as bf, dj as xs, dk as yn, dl as Re, dm as wf, dn as xf, dp as yt, dq as oi, dr as yf, ds as bn, dt as Ut, du as vf, P as ge, dv as kf, dw as Cf, dx as Sf, dy as Nf, dz as If, W as Ye, Y as de, dA as ys, aR as On, cK as $r, dB as ea, dC as vs, dD as Af, dE as _f, dF as Tf, dG as Ef, dH as Df, dI as Rf, dJ as Lf, dK as Mf, dL as Of, b6 as Ff, dM as zf, b4 as Pf, dN as $f, dO as Bf, dP as Hf, dQ as jf, dR as Vf, dS as Wf, dT as Uf, dU as Gf, b_ as nt, dV as ta, dW as Kf, a3 as V, N as na, dX as ra, dY as qf, aZ as ks, an as Yf, dZ as Jf, d_ as Xf, ah as ln, d$ as Zf, e0 as Qf, e1 as eh, e2 as th, aM as Br, e3 as ia, e4 as sa, ca as oa, e5 as nh, aF as xr, e6 as rh, e7 as ih, e8 as sh, e9 as oh, ea as lh, ad as ah, ae as ch, ag as dh, eb as la, ec as uh, ed as fh, as as yr, ee as Kt, ef as hh, eg as aa, eh as Cs, ei as ph, ej as mh, ek as ca, el as Ti, bX as Ei, em as da, en as gh, eo as bh, cJ as Hr, bz as ua, cM as wh, cL as xh, ep as yh, bA as en, eq as vh, aJ as Gn, er as ho, es as Di, et as kh, bn as Ch, eu as Sh, bV as fa, b$ as Nh, cl as ha, cj as Ss, a9 as Ih, cm as Ah, bY as Ns, aq as pa, a as _h, c as Th, bR as Eh, ev as ma, ew as Dh, ex as Rh, F as Lh, ey as ga, ez as ba, eA as Mh, bs as po, eB as Oh, eC as Fh, bT as zh, bq as wa, bt as Ph, eD as $h, eE as Bh, eF as Hh, eG as jh, bU as xa, $ as Vh, Q as st, bF as Is, eH as As, eI as _s, eJ as ya, bG as Ts, eK as va, eL as Wh, eM as Uh, eN as Gh, eO as Kh, eP as qh, bH as Yh, eQ as Jh, bW as Xh, eR as Zh, eS as mo, eT as go, eU as bo, aX as Qh, eV as ep, eW as tp, b8 as np, eX as ka, by as rp, eY as ip, eZ as sp } from "./F0AiChat-BsYN-CYp.js";
-import { f1 as jN, f0 as VN, ai as WN, e_ as UN, fl as GN, az as KN, e$ as qN, aE as YN, f9 as JN, fa as XN, fc as ZN, fj as QN, fk as eI, aG as tI, f3 as nI, f2 as rI, fb as iI, c9 as sI, fe as oI, ff as lI, f8 as aI, f5 as cI, f7 as dI, f4 as uI, bZ as fI, f6 as hI, fg as pI, fh as mI, fd as gI, fi as bI } from "./F0AiChat-BsYN-CYp.js";
+import { cN as Uu, cO as Gu, cP as Ku, a1 as qu, cQ as uo, cR as Un, cS as Yu, cT as ms, cU as _i, cV as br, K as k, R as X, L as rt, u as me, cW as Ju, cX as Xu, cY as Zu, cZ as Qu, c_ as ef, af as Le, c$ as tf, a0 as Pt, d0 as nf, b3 as rf, _ as H, b9 as sf, ba as of, U as $t, d1 as Yl, bi as lf, bc as af, M as $, d2 as gs, Z as T, d3 as it, d4 as cf, d5 as df, bd as uf, au as ff, bf as hf, aC as Bt, d6 as Jl, d7 as pf, d8 as At, aV as xn, av as bs, aw as on, k as Xl, a4 as pt, d9 as Zl, da as mf, db as fo, dc as Qt, dd as ws, de as Mn, df as wr, dg as gf, dh as Ql, di as bf, dj as xs, dk as yn, dl as Re, dm as wf, dn as xf, dp as yt, dq as oi, dr as yf, ds as bn, dt as Ut, du as vf, P as ge, dv as kf, dw as Cf, dx as Sf, dy as Nf, dz as If, W as Ye, Y as de, dA as ys, aR as On, cK as $r, dB as ea, dC as vs, dD as Af, dE as _f, dF as Tf, dG as Ef, dH as Df, dI as Rf, dJ as Lf, dK as Mf, dL as Of, b6 as Ff, dM as zf, b4 as Pf, dN as $f, dO as Bf, dP as Hf, dQ as jf, dR as Vf, dS as Wf, dT as Uf, dU as Gf, b_ as nt, dV as ta, dW as Kf, a3 as V, N as na, dX as ra, dY as qf, aZ as ks, an as Yf, dZ as Jf, d_ as Xf, ah as ln, d$ as Zf, e0 as Qf, e1 as eh, e2 as th, aM as Br, e3 as ia, e4 as sa, ca as oa, e5 as nh, aF as xr, e6 as rh, e7 as ih, e8 as sh, e9 as oh, ea as lh, ad as ah, ae as ch, ag as dh, eb as la, ec as uh, ed as fh, as as yr, ee as Kt, ef as hh, eg as aa, eh as Cs, ei as ph, ej as mh, ek as ca, el as Ti, bX as Ei, em as da, en as gh, eo as bh, cJ as Hr, bz as ua, cM as wh, cL as xh, ep as yh, bA as en, eq as vh, aJ as Gn, er as ho, es as Di, et as kh, bn as Ch, eu as Sh, bV as fa, b$ as Nh, cl as ha, cj as Ss, a9 as Ih, cm as Ah, bY as Ns, aq as pa, a as _h, c as Th, bR as Eh, ev as ma, ew as Dh, ex as Rh, F as Lh, ey as ga, ez as ba, eA as Mh, bs as po, eB as Oh, eC as Fh, bT as zh, bq as wa, bt as Ph, eD as $h, eE as Bh, eF as Hh, eG as jh, bU as xa, $ as Vh, Q as st, bF as Is, eH as As, eI as _s, eJ as ya, bG as Ts, eK as va, eL as Wh, eM as Uh, eN as Gh, eO as Kh, eP as qh, bH as Yh, eQ as Jh, bW as Xh, eR as Zh, eS as mo, eT as go, eU as bo, aX as Qh, eV as ep, eW as tp, b8 as np, eX as ka, by as rp, eY as ip, eZ as sp } from "./F0AiChat-Cg05PVK9.js";
+import { f1 as jN, f0 as VN, ai as WN, e_ as UN, fl as GN, az as KN, e$ as qN, aE as YN, f9 as JN, fa as XN, fc as ZN, fj as QN, fk as eI, aG as tI, f3 as nI, f2 as rI, fb as iI, c9 as sI, fe as oI, ff as lI, f8 as aI, f5 as cI, f7 as dI, f4 as uI, bZ as fI, f6 as hI, fg as pI, fh as mI, fd as gI, fi as bI } from "./F0AiChat-Cg05PVK9.js";
 import { jsx as c, jsxs as g, Fragment as re } from "react/jsx-runtime";
 import * as he from "react";
 import ne, { forwardRef as F, useRef as K, useTransition as op, useState as L, useLayoutEffect as Ca, useContext as Es, createContext as Ds, useCallback as J, useMemo as ee, useEffect as W, useId as Sa, useImperativeHandle as Na, memo as Ia, Fragment as lp, isValidElement as ap, cloneElement as Aa, Children as _a } from "react";
-import { C as cp, m as dp, N as He, o as ot, q as Te, t as up, v as sr, w as Ue, x as Ta, y as Oe, z as Rs, E as $e, G as wo, H as fp, I as Ea, J as Ie, K as ze, O as vn, Q as vr, U as Da, W as hp, X as Ht, Y as pp, Z as mp, a0 as gp, a1 as Fn, a2 as zn, a3 as Ls, a4 as bp, a5 as Ra, a6 as La, a7 as Ma, a8 as wp, a9 as Oa, aa as Fa, ab as za, ac as Pa, ad as $a, ae as Ba, n as xo, af as xp, ag as yo, ah as yp, ai as vp, aj as kp, ak as Ha, al as Cp, am as Sp, an as Np, ao as ja, e as Ri, ap as Ip, aq as Ap, ar as _p, as as Tp, at as Ep, au as Dp, av as Rp, M as Lp, aw as Mp, ax as Op, ay as Fp, az as zp, u as Va, aA as Pp, aB as $p, aC as Bp, aD as Hp, aE as jp, aF as Vp, aG as vo, aH as Wp, aI as Up, aJ as Gp } from "./index-CHmxufWS.js";
-import { A as xI, f as yI, B as vI, a as kI, g as CI, j as SI, D as NI, F as II, b as AI, aM as _I, aK as TI, aL as EI, L as DI, h as RI, i as LI, k as MI, c as OI, R as FI, S as zI, T as PI, V as $I, _ as BI, l as HI, p as jI, s as VI } from "./index-CHmxufWS.js";
+import { C as cp, m as dp, N as He, o as ot, q as Te, t as up, v as sr, w as Ue, x as Ta, y as Oe, z as Rs, E as $e, G as wo, H as fp, I as Ea, J as Ie, K as ze, O as vn, Q as vr, U as Da, W as hp, X as Ht, Y as pp, Z as mp, a0 as gp, a1 as Fn, a2 as zn, a3 as Ls, a4 as bp, a5 as Ra, a6 as La, a7 as Ma, a8 as wp, a9 as Oa, aa as Fa, ab as za, ac as Pa, ad as $a, ae as Ba, n as xo, af as xp, ag as yo, ah as yp, ai as vp, aj as kp, ak as Ha, al as Cp, am as Sp, an as Np, ao as ja, e as Ri, ap as Ip, aq as Ap, ar as _p, as as Tp, at as Ep, au as Dp, av as Rp, M as Lp, aw as Mp, ax as Op, ay as Fp, az as zp, u as Va, aA as Pp, aB as $p, aC as Bp, aD as Hp, aE as jp, aF as Vp, aG as vo, aH as Wp, aI as Up, aJ as Gp } from "./index-B0hDgrco.js";
+import { A as xI, f as yI, B as vI, a as kI, g as CI, j as SI, D as NI, F as II, b as AI, aM as _I, aK as TI, aL as EI, L as DI, h as RI, i as LI, k as MI, c as OI, R as FI, S as zI, T as PI, V as $I, _ as BI, l as HI, p as jI, s as VI } from "./index-B0hDgrco.js";
 import './experimental.css';const Kp = Uu("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

@@ -540,6 +540,10 @@ declare type AiChatProviderReturnValue = {
     inProgress: boolean;
     /** Set the in-progress state (synced from CopilotKit's isLoading) */
     setInProgress: (value: boolean) => void;
+    /** The current clarifying question shown in the textarea, or null if none */
+    clarifyingQuestion: ClarifyingQuestionState | null;
+    /** Set the current clarifying question (or null to dismiss) */
+    setClarifyingQuestion: React.Dispatch<React.SetStateAction<ClarifyingQuestionState | null>>;
 } & Pick<AiChatState, "greeting" | "agent" | "disclaimer" | "resizable" | "entityRefs" | "toolHints" | "credits" | "fileAttachments"> & {
     /** The current canvas content, or null when canvas is closed */
     canvasContent: CanvasContent | null;
@@ -725,6 +729,15 @@ export declare const aiTranslations: {
         };
         readonly attachFile: "Attach file";
         readonly removeFile: "Remove";
+        readonly clarifyingQuestion: {
+            readonly submit: "Submit";
+            readonly next: "Next";
+            readonly back: "Back";
+            readonly typeYourAnswer: "Type your answer…";
+            readonly stepOf: "{{current}} of {{total}}";
+            readonly custom: "own answer";
+            readonly skipped: "skipped";
+        };
         readonly growth: {
             readonly demoCard: {
                 readonly title: "See {{moduleName}} in action";
@@ -2228,6 +2241,81 @@ export declare const chipVariants: (props?: ({
     className?: ClassValue;
 })) | undefined) => string;
 
+/**
+ * A single selectable option within a clarifying question step.
+ */
+declare interface ClarifyingOption {
+    /** Unique identifier for this option */
+    id: string;
+    /** Display label shown to the user */
+    label: string;
+}
+
+/**
+ * The active clarifying question state pushed into the AiChat context.
+ * When no clarifying question is active the context value is `null`.
+ *
+ * Navigation metadata (currentStepIndex, totalSteps) and callbacks live
+ * here so the panel component stays a pure view of this state.
+ */
+declare interface ClarifyingQuestionState {
+    /** The current step's data + interaction state */
+    currentStep: ClarifyingStepState;
+    /** Zero-based index of the current step */
+    currentStepIndex: number;
+    /** Total number of steps (1 for single-step questions) */
+    totalSteps: number;
+    /** Toggle selection of an option by its ID */
+    toggleOption: (optionId: string) => void;
+    /** Confirm the current step's selection and advance (or submit on final step) */
+    confirm: () => void;
+    /** Go back to the previous step */
+    back: () => void;
+    /** Set the custom answer text */
+    setCustomAnswerText: (text: string) => void;
+    /** Toggle whether the custom answer is included in the submission */
+    setCustomAnswerActive: (active: boolean) => void;
+    /** Activate the custom answer input (in single mode, clears predefined selections) */
+    activateCustomAnswer: () => void;
+}
+
+/**
+ * Selection mode for a clarifying question step.
+ * - "single": only one option can be selected (rendered as radio buttons)
+ * - "multiple": multiple options can be selected (rendered as checkboxes)
+ */
+declare type ClarifyingSelectionMode = "single" | "multiple";
+
+/**
+ * Pure data describing a single clarifying question step.
+ * This is what the AI backend sends — no UI state or callbacks.
+ */
+declare interface ClarifyingStepData {
+    /** The question text displayed to the user */
+    question: string;
+    /** Available options the user can select from */
+    options: ClarifyingOption[];
+    /** Selection mode. Defaults to "single" when omitted */
+    selectionMode?: ClarifyingSelectionMode;
+    /** Whether the user can skip this step without selecting any option */
+    optional?: boolean;
+    /** Whether the user can type a free-text custom answer */
+    allowCustomAnswer?: boolean;
+}
+
+/**
+ * A step enriched with the user's current interaction state.
+ * Used internally by the controller to track selections per step.
+ */
+declare interface ClarifyingStepState extends ClarifyingStepData {
+    /** IDs of currently selected options */
+    selectedOptionIds: string[];
+    /** Current custom answer text (preserved even when deactivated) */
+    customAnswerText?: string;
+    /** Whether the custom answer is currently included in the submission */
+    isCustomAnswerActive: boolean;
+}
+
 declare type ColId = string;
 
 declare interface CollectionComputation {
@@ -3502,6 +3590,15 @@ export declare const defaultTranslations: {
         };
         readonly attachFile: "Attach file";
         readonly removeFile: "Remove";
+        readonly clarifyingQuestion: {
+            readonly submit: "Submit";
+            readonly next: "Next";
+            readonly back: "Back";
+            readonly typeYourAnswer: "Type your answer…";
+            readonly stepOf: "{{current}} of {{total}}";
+            readonly custom: "own answer";
+            readonly skipped: "skipped";
+        };
         readonly growth: {
             readonly demoCard: {
                 readonly title: "See {{moduleName}} in action";
@@ -5802,8 +5899,15 @@ export declare interface F0FileConfig {
     multiple?: boolean;
     /** Helper text shown in the dropzone area */
     description?: string;
-    /** Consumer-provided hook that returns upload capabilities */
-    useUpload: UseFileUpload;
+    /**
+     * Consumer-provided upload hook.
+     *
+     * When used inside `<F0Form>`, the form-level `useUpload` is preferred.
+     * This prop is primarily for standalone file fields rendered outside of
+     * `<F0Form>` / `F0FormContext.Provider`, where the upload hook cannot be
+     * supplied via context.
+     */
+    useUpload?: UseFileUpload;
 }
 
 /**
@@ -5819,8 +5923,11 @@ export declare type F0FileField = F0BaseField & {
     multiple?: boolean;
     /** Dropzone description text */
     description?: string;
-    /** Consumer-provided upload hook */
-    useUpload: UseFileUpload;
+    /**
+     * Consumer-provided upload hook for standalone usage.
+     * When inside `<F0Form>`, the form-level `useUpload` takes precedence.
+     */
+    useUpload?: UseFileUpload;
     /** Conditional rendering */
     renderIf?: FileFieldRenderIf;
 };
@@ -6120,6 +6227,8 @@ export declare interface F0FormPropsWithPerSectionDefinition<T extends F0PerSect
     styling?: F0FormStylingConfig;
     formRef?: React.MutableRefObject<F0FormRef | null>;
     initialFiles?: InitialFile[];
+    /** Upload hook shared by all file fields in the form. */
+    useUpload?: UseFileUpload;
     /**
      * Callback that renders custom fields identified by `customFieldName`.
      * When a field has `customFieldName`, this function is called instead of the inline `render`.
@@ -6174,6 +6283,10 @@ export declare interface F0FormPropsWithPerSectionSchema<T extends F0PerSectionS
      * `defaultValues` against `InitialFile.value`.
      */
     initialFiles?: InitialFile[];
+    /**
+     * Upload hook shared by all file fields in the form.
+     */
+    useUpload?: UseFileUpload;
     /**
      * Callback that renders custom fields identified by `customFieldName`.
      * When a field has `customFieldName`, this function is called instead of the inline `render`.
@@ -6229,6 +6342,11 @@ export declare interface F0FormPropsWithSingleSchema<TSchema extends F0FormSchem
      * `defaultValues` against `InitialFile.value`.
      */
     initialFiles?: InitialFile[];
+    /**
+     * Upload hook shared by all file fields in the form.
+     * Called once per file to obtain an independent upload instance.
+     */
+    useUpload?: UseFileUpload;
     /**
      * Callback that renders custom fields identified by `customFieldName`.
      * When a field has `customFieldName`, this function is called instead of the inline `render`.
@@ -6263,6 +6381,8 @@ export declare interface F0FormPropsWithSingleSchemaDefinition<TSchema extends F
     styling?: F0FormStylingConfig;
     formRef?: React.MutableRefObject<F0FormRef | null>;
     initialFiles?: InitialFile[];
+    /** Upload hook shared by all file fields in the form. */
+    useUpload?: UseFileUpload;
     /**
      * Callback that renders custom fields identified by `customFieldName`.
      * When a field has `customFieldName`, this function is called instead of the inline `render`.
@@ -11561,6 +11681,11 @@ declare module "gridstack" {
 }
 
 
+declare namespace Calendar {
+    var displayName: string;
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -11608,8 +11733,3 @@ declare module "@tiptap/core" {
         };
     }
 }
-
-
-declare namespace Calendar {
-    var displayName: string;
-}