@factorialco/f0-react 1.381.0 → 1.382.0

package/dist/ai.d.ts

@@ -756,6 +756,18 @@ export declare const defaultTranslations: {
                 readonly other: "{{count}} issues";
             };
         };
+        readonly file: {
+            readonly dropzone: "Drag and drop a file, or click to select";
+            readonly dropzoneActive: "Drop the file here";
+            readonly dropzoneMultiple: "Drag and drop files, or click to select";
+            readonly acceptedTypes: "Accepted formats: {{types}}";
+            readonly remove: "Remove";
+            readonly uploading: "Uploading…";
+            readonly processing: "Processing…";
+            readonly uploadFailed: "Upload failed";
+            readonly fileTooLarge: "File exceeds {{maxSize}} MB limit";
+            readonly invalidFileType: "File type not accepted. Accepted formats: {{types}}";
+        };
         readonly validation: {
             readonly required: "This field is required";
             readonly invalidType: "Invalid value";
@@ -1205,6 +1217,11 @@ declare module "gridstack" {
 }
 
 
+declare namespace Calendar {
+    var displayName: string;
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -1252,8 +1269,3 @@ declare module "@tiptap/core" {
         };
     }
 }
-
-
-declare namespace Calendar {
-    var displayName: string;
-}

package/dist/ai.js

@@ -1,6 +1,6 @@
-import { A as e, B as o, C as t, E as n, h as i, F as r, a as l, x as c, i as A, b as u, s as F, t as h, v as C, w as T, c as d, n as m, o as I, p as f, H as g, I as S, k as p, L as x, O as H, q as P, P as b, S as k, T as O, l as v, m as w, U as M, r as E, j as L, d as q, e as B, u as U, g as j, f as z } from "./F0AiChat-DvWln9wK.js";
+import { A as e, B as o, C as t, E as n, h as i, F as r, a as l, x as c, i as A, b as u, s as F, t as h, v as C, w as T, c as d, n as m, o as I, p as f, H as g, I as S, k as p, L as x, O as H, q as P, P as b, S as k, T as O, l as v, m as w, U as M, r as E, j as L, d as q, e as B, u as U, g as j, f as z } from "./F0AiChat-oTIR5NbZ.js";
 import { defaultTranslations as R } from "./i18n-provider-defaults.js";
-import { A as y, F as G, c as J, b as K, a as N, o as Q, u as W } from "./F0HILActionConfirmation-DRfQGPsn.js";
+import { A as y, F as G, c as J, b as K, a as N, o as Q, u as W } from "./F0HILActionConfirmation-C9Kwjohi.js";
 export {
   e as A,
   y as AiChatTranslationsProvider,

package/dist/experimental.d.ts

@@ -2685,6 +2685,18 @@ declare const defaultTranslations: {
                 readonly other: "{{count}} issues";
             };
         };
+        readonly file: {
+            readonly dropzone: "Drag and drop a file, or click to select";
+            readonly dropzoneActive: "Drop the file here";
+            readonly dropzoneMultiple: "Drag and drop files, or click to select";
+            readonly acceptedTypes: "Accepted formats: {{types}}";
+            readonly remove: "Remove";
+            readonly uploading: "Uploading…";
+            readonly processing: "Processing…";
+            readonly uploadFailed: "Upload failed";
+            readonly fileTooLarge: "File exceeds {{maxSize}} MB limit";
+            readonly invalidFileType: "File type not accepted. Accepted formats: {{types}}";
+        };
         readonly validation: {
             readonly required: "This field is required";
             readonly invalidType: "Invalid value";
@@ -6734,6 +6746,11 @@ declare module "gridstack" {
 }
 
 
+declare namespace Calendar {
+    var displayName: string;
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -6781,8 +6798,3 @@ declare module "@tiptap/core" {
         };
     }
 }
-
-
-declare namespace Calendar {
-    var displayName: string;
-}

package/dist/experimental.js

@@ -1,10 +1,10 @@
-import { a5 as Kd, bH as Xp, bI as Zp, bJ as eg, bK as Ho, bL as tg, bM as eo, D as ng, bN as rg, ad as G, V as Jd, J as ig, bO as og, ap as Ei, bP as Yd, bQ as sg, bR as lg, am as ag, bS as Ea, bT as Qr, bU as cg, bV as gl, bW as Qd, bX as ys, a6 as k, a7 as At, u as Y, bY as dg, bZ as ug, b_ as fg, b$ as hg, c0 as mg, av as Se, c1 as pg, al as Te, c2 as gg, c3 as Xd, aj as q, c4 as Zd, c5 as eu, ae as at, c6 as tu, c7 as xs, c8 as nu, a8 as $, c9 as _r, ai as P, ca as vt, cb as bg, cc as vg, cd as dr, aJ as ru, ce as iu, a$ as rn, cf as ou, cg as bl, ch as pt, aK as vl, aL as Jn, v as su, ci as lu, cj as yg, ck as Ta, cl as zn, cm as yl, cn as Lr, co as Ti, cp as xg, cq as au, cr as wg, cs as xl, ct as ur, cu as et, cv as Cg, cw as kg, cx as qt, cy as Vo, cz as Ng, cA as lr, cB as En, cC as Sg, aa as ve, cD as Ig, cE as Ag, cF as Eg, cG as Tg, cH as Dg, af as He, ah as Ee, cI as un, aU as on, bE as Or, cJ as cu, cK as wl, cL as _g, cM as Lg, cN as Og, cO as Rg, cP as Fg, cQ as Mg, cR as Pg, cS as zg, cT as $g, cU as Cl, cV as jg, cW as du, cX as Bg, cY as Hg, cZ as Vg, c_ as Wg, c$ as Ug, d0 as Gg, d1 as qg, d2 as Kg, bf as St, d3 as uu, d4 as Jg, ao as se, a9 as fr, d5 as fu, d6 as hu, aX as kl, t as Yg, d7 as Qg, d8 as Xg, an as hr, d9 as Zg, da as Wo, db as eb, dc as Nl, dd as Kt, aQ as mu, de as Da, df as _a, dg as tb, dh as La, di as pu, dj as Sl, aP as $n, aN as gu, at as Il, au as Al, aw as El, aM as mr, ak as Rr, dk as nb, dl as rb, dm as bu, dn as ib, ax as It, dp as ob, dq as vu, dr as yu, ds as sb, dt as Fr, du as Tl, dv as to, bh as fn, dw as ws, dx as lb, dy as ab, dz as cb, dA as db, dB as ub, dC as fb, dD as xu, dE as hb, dF as wu, dG as mb, dH as pb, dI as gb, aH as Oa, dJ as Cu, dK as Cs, aC as ks, dL as ku, dM as Ns, bo as Dl, aW as hn, ba as no, dN as ro, dO as bb, dP as vb, dQ as yb, bD as io, aV as Nu, bG as xb, bF as wb, dR as Su, dS as Cb, aE as _n, dT as Ra, dU as Di, dV as kb, dW as Nb, bg as Sb, bb as Iu, a as Ib, d as Ab, dX as _l, dY as Eb, F as Tb, dZ as Au, d_ as Eu, d$ as Db, e0 as _b, e1 as Lb, e2 as Ob, e3 as Rb, e4 as Tu, e5 as Fb, bc as Du, e6 as _u, e7 as Mb, e8 as Pb, e9 as zb, ea as $b, eb as jb, ec as Bb, ed as Hb, ee as Vb, br as Wb, bs as Ub, bz as oo, bx as Ll, b0 as so, ef as lo, eg as ao, b1 as co, eh as Ol, by as Lu, aD as Gb, bt as _i, ei as Ou, ej as qb, ek as Ss, el as Kb, em as Fa, en as Jb, eo as Yb, ep as Qb, eq as Xb, er as Zb, es as ev, et as tv, ac as Ru, bn as nv, bw as rv, ab as yt, aY as iv, aZ as ov, a_ as sv, eu as Fu, ev as lv, ew as av, ex as cv, ey as dv, b2 as uv, ez as fv, eA as Ma, eB as Pa, eC as za, eD as hv, eE as mv, eF as pv, eG as gv, eH as Mu, eI as bv } from "./F0AiChat-DvWln9wK.js";
-import { eL as QL, eK as XL, eJ as ZL, eQ as eO, eR as tO, eN as nO, eM as rO, eP as iO, be as oO, eO as sO } from "./F0AiChat-DvWln9wK.js";
+import { a5 as Kd, bI as Xp, bJ as Zp, bK as eg, bL as Ho, bM as tg, bN as eo, D as ng, bO as rg, ad as G, V as Jd, J as ig, bP as og, ap as Ei, bQ as Yd, bR as sg, bS as lg, am as ag, bT as Ea, bU as Qr, bV as cg, bW as gl, bX as Qd, bY as ys, a6 as k, a7 as At, u as Y, bZ as dg, b_ as ug, b$ as fg, c0 as hg, c1 as mg, av as Se, c2 as pg, al as Te, c3 as gg, c4 as Xd, aj as q, c5 as Zd, c6 as eu, ae as at, c7 as tu, c8 as xs, c9 as nu, a8 as $, ca as _r, ai as P, cb as vt, cc as bg, cd as vg, ce as dr, aJ as ru, cf as iu, aU as rn, cg as ou, ch as bl, ci as pt, aK as vl, aL as Jn, v as su, cj as lu, ck as yg, cl as Ta, cm as zn, cn as yl, co as Lr, cp as Ti, cq as xg, cr as au, cs as wg, ct as xl, cu as ur, cv as et, cw as Cg, cx as kg, cy as qt, cz as Vo, cA as Ng, cB as lr, cC as En, cD as Sg, aa as ve, cE as Ig, cF as Ag, cG as Eg, cH as Tg, cI as Dg, af as He, ah as Ee, cJ as un, aX as on, bF as Or, cK as cu, cL as wl, cM as _g, cN as Lg, cO as Og, cP as Rg, cQ as Fg, cR as Mg, cS as Pg, cT as zg, cU as $g, cV as Cl, cW as jg, cX as du, cY as Bg, cZ as Hg, c_ as Vg, c$ as Wg, d0 as Ug, d1 as Gg, d2 as qg, d3 as Kg, bg as St, d4 as uu, d5 as Jg, ao as se, a9 as fr, d6 as fu, d7 as hu, a_ as kl, t as Yg, d8 as Qg, d9 as Xg, an as hr, da as Zg, db as Wo, dc as eb, dd as Nl, de as Kt, aQ as mu, df as Da, dg as _a, dh as tb, di as La, dj as pu, dk as Sl, aP as $n, aN as gu, at as Il, au as Al, aw as El, aM as mr, ak as Rr, dl as nb, dm as rb, dn as bu, dp as ib, ax as It, dq as ob, dr as vu, ds as yu, dt as sb, du as Fr, dv as Tl, dw as to, bi as fn, dx as ws, dy as lb, dz as ab, dA as cb, dB as db, dC as ub, dD as fb, dE as xu, dF as hb, dG as wu, dH as mb, dI as pb, dJ as gb, aH as Oa, dK as Cu, dL as Cs, aC as ks, dM as ku, dN as Ns, bp as Dl, aZ as hn, bc as no, dO as ro, dP as bb, dQ as vb, dR as yb, bE as io, aY as Nu, bH as xb, bG as wb, dS as Su, dT as Cb, aE as _n, dU as Ra, dV as Di, dW as kb, dX as Nb, bh as Sb, bd as Iu, a as Ib, d as Ab, dY as _l, dZ as Eb, F as Tb, d_ as Au, d$ as Eu, e0 as Db, e1 as _b, e2 as Lb, e3 as Ob, e4 as Rb, e5 as Tu, e6 as Fb, be as Du, e7 as _u, e8 as Mb, e9 as Pb, ea as zb, eb as $b, ec as jb, ed as Bb, ee as Hb, ef as Vb, bs as Wb, bt as Ub, bA as oo, by as Ll, b2 as so, eg as lo, eh as ao, b3 as co, ei as Ol, bz as Lu, aD as Gb, bu as _i, ej as Ou, ek as qb, el as Ss, em as Kb, en as Fa, eo as Jb, ep as Yb, eq as Qb, er as Xb, es as Zb, et as ev, eu as tv, ac as Ru, bo as nv, bx as rv, ab as yt, a$ as iv, b0 as ov, b1 as sv, ev as Fu, ew as lv, ex as av, ey as cv, ez as dv, b4 as uv, eA as fv, eB as Ma, eC as Pa, eD as za, eE as hv, eF as mv, eG as pv, eH as gv, eI as Mu, eJ as bv } from "./F0AiChat-oTIR5NbZ.js";
+import { eM as QL, eL as XL, eK as ZL, eR as eO, eS as tO, eO as nO, eN as rO, eQ as iO, bf as oO, eP as sO } from "./F0AiChat-oTIR5NbZ.js";
 import { jsx as l, jsxs as g, Fragment as Z } from "react/jsx-runtime";
 import * as Pe from "react";
 import X, { createContext as Ht, forwardRef as J, useRef as j, useEffect as H, useContext as Vt, PureComponent as vv, useTransition as yv, useState as R, useLayoutEffect as Xt, useCallback as ee, useMemo as M, useId as Rl, useImperativeHandle as Pu, memo as uo, Fragment as jn, isValidElement as zu, cloneElement as Fl, createElement as $a, Children as $u } from "react";
-import { f as Ln, aG as pr, j as Xr, aH as xv, b as Uo, aI as wv, A as Cv, d as Zr, i as kv, m as Nv, G as Sv, g as ja, aJ as Iv, l as Ba, aK as Av, p as Ev, aL as ju, aM as Bu, aN as Tv, C as Dv, az as _v, af as Bn, D as ze, aO as ct, aP as Et, aQ as Je, aR as Lv, aS as mi, aT as ut, aU as Hu, aV as nt, aW as Ml, aX as st, aY as Ha, aZ as Ov, a_ as Vu, a$ as Ge, b0 as it, b1 as gr, b2 as Li, b3 as Wu, b4 as Rv, b5 as yn, b6 as Fv, b7 as Mv, b8 as Pv, b9 as Mr, ba as Pr, bb as Pl, bc as zv, bd as Uu, be as Gu, bf as qu, bg as $v, bh as Ku, bi as Ju, bj as Yu, bk as Qu, bl as Xu, bm as Zu, bn as Is, bo as jv, bp as Va, bq as Bv, br as Hv, bs as Vv, x as Wv, y as Uv, F as Gv, M as Wa, N as Ua, O as qv, P as Kv, t as Jv, a4 as Yv, a5 as Qv, bt as Xv, bu as Zv, a7 as e0, bv as ef, bw as t0, bx as n0, by as r0, an as fo, bz as zl, bA as tf, am as As, bB as i0, al as nf, a2 as zr, ah as o0, bC as s0, bD as l0, bE as a0, aq as $l, bF as c0, aD as d0, bG as Es, bH as u0, bI as Oi, bJ as f0, aE as h0, bK as m0, aC as rf, aB as p0, aA as g0, bL as b0, bM as v0, bN as y0, bO as x0, bP as w0, bQ as C0, bR as k0, bS as N0, bT as S0, bU as I0, bV as A0, bW as E0, bX as T0, bY as D0, bZ as _0, aF as of, at as sf, b_ as L0, R as O0, T as R0, V as F0, W as M0, Z as P0, U as z0, b$ as Ga, c0 as $0, c1 as j0, n as B0 } from "./DataCollectionStorageProvider-DBnav5cC.js";
-import { ai as aO, a8 as cO, a3 as dO, aa as uO, c5 as fO, c4 as hO, c2 as mO, c3 as pO, a6 as gO, a9 as bO, ar as vO, as as yO } from "./DataCollectionStorageProvider-DBnav5cC.js";
+import { f as Ln, aG as pr, j as Xr, aH as xv, b as Uo, aI as wv, A as Cv, d as Zr, i as kv, m as Nv, G as Sv, g as ja, aJ as Iv, l as Ba, aK as Av, p as Ev, aL as ju, aM as Bu, aN as Tv, C as Dv, az as _v, af as Bn, D as ze, aO as ct, aP as Et, aQ as Je, aR as Lv, aS as mi, aT as ut, aU as Hu, aV as nt, aW as Ml, aX as st, aY as Ha, aZ as Ov, a_ as Vu, a$ as Ge, b0 as it, b1 as gr, b2 as Li, b3 as Wu, b4 as Rv, b5 as yn, b6 as Fv, b7 as Mv, b8 as Pv, b9 as Mr, ba as Pr, bb as Pl, bc as zv, bd as Uu, be as Gu, bf as qu, bg as $v, bh as Ku, bi as Ju, bj as Yu, bk as Qu, bl as Xu, bm as Zu, bn as Is, bo as jv, bp as Va, bq as Bv, br as Hv, bs as Vv, x as Wv, y as Uv, F as Gv, M as Wa, N as Ua, O as qv, P as Kv, t as Jv, a4 as Yv, a5 as Qv, bt as Xv, bu as Zv, a7 as e0, bv as ef, bw as t0, bx as n0, by as r0, an as fo, bz as zl, bA as tf, am as As, bB as i0, al as nf, a2 as zr, ah as o0, bC as s0, bD as l0, bE as a0, aq as $l, bF as c0, aD as d0, bG as Es, bH as u0, bI as Oi, bJ as f0, aE as h0, bK as m0, aC as rf, aB as p0, aA as g0, bL as b0, bM as v0, bN as y0, bO as x0, bP as w0, bQ as C0, bR as k0, bS as N0, bT as S0, bU as I0, bV as A0, bW as E0, bX as T0, bY as D0, bZ as _0, aF as of, at as sf, b_ as L0, R as O0, T as R0, V as F0, W as M0, Z as P0, U as z0, b$ as Ga, c0 as $0, c1 as j0, n as B0 } from "./DataCollectionStorageProvider-B8_-moME.js";
+import { ai as aO, a8 as cO, a3 as dO, aa as uO, c5 as fO, c4 as hO, c2 as mO, c3 as pO, a6 as gO, a9 as bO, ar as vO, as as yO } from "./DataCollectionStorageProvider-B8_-moME.js";
 import './experimental.css';function lf(t, e) {
   const n = Kd(e()), r = () => n.set(e());
   return r(), Xp(() => {

package/dist/f0.d.ts

@@ -2584,6 +2584,18 @@ export declare const defaultTranslations: {
                 readonly other: "{{count}} issues";
             };
         };
+        readonly file: {
+            readonly dropzone: "Drag and drop a file, or click to select";
+            readonly dropzoneActive: "Drop the file here";
+            readonly dropzoneMultiple: "Drag and drop files, or click to select";
+            readonly acceptedTypes: "Accepted formats: {{types}}";
+            readonly remove: "Remove";
+            readonly uploading: "Uploading…";
+            readonly processing: "Processing…";
+            readonly uploadFailed: "Upload failed";
+            readonly fileTooLarge: "File exceeds {{maxSize}} MB limit";
+            readonly invalidFileType: "File type not accepted. Accepted formats: {{types}}";
+        };
         readonly validation: {
             readonly required: "This field is required";
             readonly invalidType: "Invalid value";
@@ -2881,11 +2893,26 @@ export declare interface F0AlertProps {
 }
 
 /**
- * Config for array fields (multi-select)
+ * Config for array fields (multi-select or multi-file)
+ * @typeParam T - The value type (string or number)
+ * @typeParam R - Record type for data source (when using source instead of options)
+ */
+export declare type F0ArrayConfig<T extends string | number = string, R extends Record<string, unknown> = Record<string, unknown>> = F0ArraySelectConfig<T, R> | F0ArrayFileConfig;
+
+/**
+ * Config for file fields (multiple file upload, form value is string[])
+ */
+declare type F0ArrayFileConfig = F0BaseConfig & F0FileConfig & {
+    fieldType: "file";
+    multiple: true;
+};
+
+/**
+ * Config for array fields with select (multi-select)
  * @typeParam T - The value type (string or number)
  * @typeParam R - Record type for data source (when using source instead of options)
  */
-export declare type F0ArrayConfig<T extends string | number = string, R extends Record<string, unknown> = Record<string, unknown>> = F0BaseConfig & F0SelectConfig<T, R> & {
+declare type F0ArraySelectConfig<T extends string | number = string, R extends Record<string, unknown> = Record<string, unknown>> = F0BaseConfig & F0SelectConfig<T, R> & {
     fieldType?: "select";
 };
 
@@ -3741,19 +3768,66 @@ export declare function F0EventCatcherProvider({ children, onEvent, enabled, cat
 /**
  * Union of all F0 field types used for rendering
  */
-export declare type F0Field = F0TextField | F0NumberField | F0TextareaField | F0SelectField | F0CheckboxField | F0SwitchField | F0DateField | F0TimeField | F0DateTimeField | F0DateRangeField | F0RichTextField | F0CustomField;
+export declare type F0Field = F0TextField | F0NumberField | F0TextareaField | F0SelectField | F0CheckboxField | F0SwitchField | F0DateField | F0TimeField | F0DateTimeField | F0DateRangeField | F0RichTextField | F0FileField | F0CustomField;
 
 /**
  * Complete F0 field configuration (union of all possible configs)
  * @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> | F0ObjectConfig;
+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;
 
 /**
  * Field types for rendering
  */
-export declare type F0FieldType = "text" | "number" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "custom";
+export declare type F0FieldType = "text" | "number" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "file" | "custom";
+
+/**
+ * F0 config options specific to file fields
+ */
+export declare interface F0FileConfig {
+    /**
+     * Accepted MIME types.
+     *
+     * @example
+     * accept: ["image"]                       // all image types
+     * accept: ["image/png", "image/jpeg"]     // specific types
+     * accept: ["image", "application/pdf"]    // mix of category and specific
+     */
+    accept?: MimeType_2[];
+    /** Maximum file size in megabytes (per file) */
+    maxSizeMB?: number;
+    /** Allow multiple file uploads (form value becomes `string[]`) */
+    multiple?: boolean;
+    /** Helper text shown in the dropzone area */
+    description?: string;
+    /** Consumer-provided hook that returns upload capabilities */
+    useUpload: UseFileUpload;
+}
+
+/**
+ * File field with all properties for rendering (runtime type)
+ */
+export declare type F0FileField = F0BaseField & {
+    type: "file";
+    /** Accepted MIME types */
+    accept?: MimeType_2[];
+    /** Maximum file size in megabytes */
+    maxSizeMB?: number;
+    /** Allow multiple files */
+    multiple?: boolean;
+    /** Dropzone description text */
+    description?: string;
+    /** Consumer-provided upload hook */
+    useUpload: UseFileUpload;
+    /** Conditional rendering */
+    renderIf?: FileFieldRenderIf;
+};
+
+/**
+ * Union of all file field configs
+ */
+export declare type F0FileFieldConfig = F0StringFileConfig | F0ArrayFileConfig;
 
 export declare const F0FilterPickerContent: F0FilterPickerContentGeneric;
 
@@ -3971,6 +4045,12 @@ export declare interface F0FormPropsWithPerSectionSchema<T extends F0PerSectionS
      * Ref to control the form programmatically from outside.
      */
     formRef?: React.MutableRefObject<F0FormRef | null>;
+    /**
+     * Pre-existing file metadata shared across all file fields.
+     * Each file field automatically resolves its entries by matching
+     * `defaultValues` against `InitialFile.value`.
+     */
+    initialFiles?: InitialFile[];
 }
 
 /**
@@ -4009,6 +4089,12 @@ export declare interface F0FormPropsWithSingleSchema<TSchema extends F0FormSchem
      * Use with the `useF0Form` hook to get a ref and submit/reset functions.
      */
     formRef?: React.MutableRefObject<F0FormRef | null>;
+    /**
+     * Pre-existing file metadata shared across all file fields.
+     * Each file field automatically resolves its entries by matching
+     * `defaultValues` against `InitialFile.value`.
+     */
+    initialFiles?: InitialFile[];
 }
 
 /**
@@ -4595,7 +4681,15 @@ export declare type F0Source = {
  * @typeParam TConfig - Type of the fieldConfig object (for custom fields)
  * @typeParam R - Record type for data source (when using source instead of options)
  */
-export declare type F0StringConfig<TValue = string, TConfig = undefined, R extends Record<string, unknown> = Record<string, unknown>> = F0StringTextConfig | F0StringTextareaConfig | F0StringSelectConfig<R> | F0CustomFieldConfig<TValue, TConfig>;
+export declare type F0StringConfig<TValue = string, TConfig = undefined, R extends Record<string, unknown> = Record<string, unknown>> = F0StringTextConfig | F0StringTextareaConfig | F0StringSelectConfig<R> | F0StringFileConfig | F0CustomFieldConfig<TValue, TConfig>;
+
+/**
+ * Config for file fields (single file upload, form value is a string identifier)
+ */
+declare type F0StringFileConfig = F0BaseConfig & F0FileConfig & {
+    fieldType: "file";
+    multiple?: false;
+};
 
 /**
  * Config for string fields with select options
@@ -4823,7 +4917,7 @@ export declare interface F0ZodType<T extends ZodTypeAny = ZodTypeAny> {
 /**
  * Field types for rendering
  */
-export declare type FieldType = "text" | "number" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "custom";
+export declare type FieldType = "text" | "number" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "file" | "custom";
 
 export declare type FileAvatarVariant = Extract<AvatarVariant, {
     type: "file";
@@ -4834,6 +4928,41 @@ declare type FileDef = {
     type: string;
 };
 
+/**
+ * All valid renderIf conditions for file fields
+ */
+declare type FileFieldRenderIf = CommonRenderIfCondition | F0BaseFieldRenderIfFunction;
+
+/**
+ * Return type of the consumer-provided upload hook
+ */
+export declare interface FileUploadHookReturn {
+    /** Uploads a file and returns the result */
+    upload: (file: File) => Promise<FileUploadResult>;
+    /** Cancels the in-flight upload */
+    cancelUpload?: () => void;
+    /** Upload progress from 0 to 1 */
+    progress: number;
+    /** Current upload status */
+    status: FileUploadStatus;
+}
+
+/**
+ * Result of a file upload operation.
+ * `value` is the identifier stored as the form value (e.g. a signedId, URL, or any string).
+ */
+export declare type FileUploadResult = {
+    type: "success";
+    value: string;
+} | {
+    type: "aborted";
+};
+
+/**
+ * Upload status states
+ */
+export declare type FileUploadStatus = "idle" | "processing" | "uploading" | "success";
+
 /**
  * Union of all available filter types.
  * Used to define possible filter configurations in a collection.
@@ -5392,6 +5521,21 @@ export declare type InfiniteScrollPaginatedResponse<TRecord> = BasePaginatedResp
     hasMore: boolean;
 };
 
+/**
+ * Metadata for a file that already exists (e.g. from a previous upload).
+ * Passed via `initialFiles` so the field can display it without re-uploading.
+ */
+export declare interface InitialFile {
+    /** The identifier that matches the form's default value (signedId, URL, etc.) */
+    value: string;
+    /** Display name (e.g. "report.pdf") */
+    name: string;
+    /** MIME type for icon display (e.g. "application/pdf") */
+    type?: string;
+    /** File size in bytes */
+    size?: number;
+}
+
 declare const INPUTFIELD_SIZES: readonly ["sm", "md"];
 
 declare type InputFieldInheritedProps = (typeof inputFieldInheritedProps)[number];
@@ -5656,6 +5800,20 @@ declare type MentionsConfig = {
     users: MentionedUser[];
 };
 
+/**
+ * Known MIME types for the file field `accept` prop.
+ *
+ * Supports three formats:
+ * - Specific types: `"image/png"`, `"application/pdf"`
+ * - Wildcard categories: `"image/*"`, `"video/*"`
+ * - Bare categories (shorthand for wildcard): `"image"`, `"video"`
+ *
+ * The `string & {}` escape hatch allows unlisted MIME types while
+ * still providing autocomplete for known ones.
+ */
+declare type MimeType_2 = "image" | "video" | "audio" | "text" | "application" | "image/*" | "video/*" | "audio/*" | "text/*" | "application/*" | "image/jpeg" | "image/png" | "image/gif" | "image/webp" | "image/svg+xml" | "image/heic" | "image/bmp" | "image/tiff" | "image/avif" | "video/mp4" | "video/webm" | "video/quicktime" | "audio/mpeg" | "audio/ogg" | "audio/wav" | "application/pdf" | "application/msword" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.ms-excel" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.ms-powerpoint" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/zip" | "application/json" | "text/plain" | "text/csv" | "text/html" | "text/markdown";
+export { MimeType_2 as MimeType }
+
 declare const moduleAvatarVariants: (props?: ({
     size?: "lg" | "md" | "sm" | "xs" | "xxs" | undefined;
 } & ({
@@ -7598,6 +7756,22 @@ export declare interface UseF0FormReturn {
     hasErrors: boolean;
 }
 
+/**
+ * A hook that returns upload capabilities for a single file.
+ * Each call creates an independent upload instance with its own state.
+ *
+ * @example
+ * ```tsx
+ * const useMyUpload: UseFileUpload = () => {
+ *   const { upload, progress, status, cancelUpload } = useDirectUpload({
+ *     resourceType: "MyModule::Document",
+ *   })
+ *   return { upload, progress, status, cancelUpload }
+ * }
+ * ```
+ */
+export declare type UseFileUpload = () => FileUploadHookReturn;
+
 export declare const useGroups: <R extends RecordType>(groups: GroupRecord<R>[], defaultOpenGroups?: boolean | GroupRecord<R>["key"][]) => {
     openGroups: Record<string, boolean>;
     setGroupOpen: (key: string, open: boolean) => void;
@@ -7933,6 +8107,11 @@ declare module "gridstack" {
 }
 
 
+declare namespace Calendar {
+    var displayName: string;
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -7980,8 +8159,3 @@ declare module "@tiptap/core" {
         };
     }
 }
-
-
-declare namespace Calendar {
-    var displayName: string;
-}