@factorialco/f0-react 1.458.0 → 1.458.2

package/dist/ai.d.ts

@@ -3211,9 +3211,9 @@ declare module "gridstack" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        aiBlock: {
-            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
-            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
+        enhanceHighlight: {
+            setEnhanceHighlight: (from: number, to: number) => ReturnType;
+            clearEnhanceHighlight: () => ReturnType;
         };
     }
 }
@@ -3221,9 +3221,9 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        enhanceHighlight: {
-            setEnhanceHighlight: (from: number, to: number) => ReturnType;
-            clearEnhanceHighlight: () => ReturnType;
+        aiBlock: {
+            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
+            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
         };
     }
 }

package/dist/ai.js

@@ -1,6 +1,6 @@
-import { l as t, k as e, F as r, a as o, C as i, b as n, m as F, n as u, d as A, I as c, g as C, c as m, h, e as l, u as d, j as I, i as f, f as T } from "./F0AiChat-D8Nbyn2N.js";
+import { l as t, k as e, F as r, a as o, C as i, b as n, m as F, n as u, d as A, I as c, g as C, c as m, h, e as l, u as d, j as I, i as f, f as T } from "./F0AiChat-DCBZKVBj.js";
 import { defaultTranslations as S } from "./i18n-provider-defaults.js";
-import { A as v, e as x, F as P, c as V, d as k, b as O, a as b, f as y, o as M, u as j } from "./types-CfpjN4dh.js";
+import { A as v, e as x, F as P, c as V, d as k, b as O, a as b, f as y, o as M, u as j } from "./types-BSfiLtJG.js";
 export {
   v as AiChatTranslationsProvider,
   t as ChatSpinner,

package/dist/experimental.d.ts

@@ -8017,9 +8017,9 @@ declare module "gridstack" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        aiBlock: {
-            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
-            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
+        enhanceHighlight: {
+            setEnhanceHighlight: (from: number, to: number) => ReturnType;
+            clearEnhanceHighlight: () => ReturnType;
         };
     }
 }
@@ -8027,9 +8027,9 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        enhanceHighlight: {
-            setEnhanceHighlight: (from: number, to: number) => ReturnType;
-            clearEnhanceHighlight: () => ReturnType;
+        aiBlock: {
+            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
+            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
         };
     }
 }

package/dist/experimental.js

@@ -1,9 +1,9 @@
-import { a9 as oa, aa as ca, ab as da, ac as ua, ad as Ft, ae as Te, af as fa, ag as ht, ah as rt, ai as Be, O as b, W as Z, P as be, u as se, aj as ma, ak as ha, al as pa, am as ba, an as ga, a5 as oe, ao as xa, U as Ee, ap as va, aq as wa, ar as $, as as ya, at as Na, M as _e, au as ln, av as Ca, aw as ka, Q as B, ax as sn, a8 as E, ay as ge, az as Sa, aA as Ia, aB as Fa, aC as Aa, aD as La, aE as Ce, aF as on, aG as Ea, aH as xe, aI as $e, aJ as _a, aK as pt, n as cn, aL as Ne, aM as Oa, aN as dn, a6 as ne, aO as H, R as un, aP as fn, aQ as Ta, aR as mn, aS as me, a7 as ee, aT as Da, aU as za, aV as Pa, aW as Ra, X as pe, aX as Ge, aY as Ba, aZ as $a, a_ as Wa, a$ as Ma, b0 as He, b1 as hn, b2 as ja, b3 as Va, b4 as Ga, b5 as We, b6 as Ha, b7 as Ua, b8 as Ka, b9 as qa, ba as Ya, bb as Za, bc as Xa, bd as Ja, be as Qa, bf as er, bg as lt, bh as it, bi as pn, bj as tr, bk as nr, bl as bn, bm as ar, bn as rr, T as Ue, bo as bt, bp as gn, bq as lr, br as xn, bs as ir, bt as sr, bu as or, bv as Le, bw as cr, bx as De, by as At, bz as st, bA as dr, bB as ur, a as fr, c as mr, bC as hr, bD as vn, bE as pr, bF as br, F as gr, bG as wn, _ as xr, bH as yn, bI as vr, bJ as Lt, bK as wr, bL as yr, bM as Nr, bN as Cr, bO as Nn, bP as kr, bQ as Sr, bR as Ir, bS as Fr, bT as Ar, Y as Cn, bU as ue, bV as kn, bW as gt, bX as xt, bY as vt, bZ as Sn, b_ as wt, b$ as In, $ as Fn, c0 as Lr, c1 as Er, c2 as _r, c3 as Or, c4 as Tr, c5 as Dr, c6 as zr, c7 as Pr, c8 as Rr, c9 as Br, ca as $r, cb as Et, cc as _t, cd as Ot, ce as Wr, cf as Mr, cg as jr, ch as Vr, ci as An, cj as Gr, ck as Hr, cl as Ur } from "./F0AiChat-D8Nbyn2N.js";
-import { cF as Ac, cE as Lc, co as Ec, cR as _c, cy as Oc, cz as Tc, cn as Dc, cB as zc, cp as Pc, d1 as Rc, c$ as Bc, cq as $c, cC as Wc, cD as Mc, cA as jc, cr as Vc, cN as Gc, cO as Hc, cS as Uc, cZ as Kc, c_ as qc, d0 as Yc, cx as Zc, cs as Xc, cH as Jc, cG as Qc, ct as ed, cu as td, cv as nd, cP as ad, d2 as rd, cm as ld, cQ as id, cU as sd, cV as od, cM as cd, cJ as dd, cL as ud, cI as fd, cw as md, cK as hd, cW as pd, cX as bd, cT as gd, cY as xd } from "./F0AiChat-D8Nbyn2N.js";
+import { a9 as oa, aa as ca, ab as da, ac as ua, ad as Ft, ae as Te, af as fa, ag as ht, ah as rt, ai as Be, O as b, W as Z, P as be, u as se, aj as ma, ak as ha, al as pa, am as ba, an as ga, a5 as oe, ao as xa, U as Ee, ap as va, aq as wa, ar as $, as as ya, at as Na, M as _e, au as ln, av as Ca, aw as ka, Q as B, ax as sn, a8 as E, ay as ge, az as Sa, aA as Ia, aB as Fa, aC as Aa, aD as La, aE as Ce, aF as on, aG as Ea, aH as xe, aI as $e, aJ as _a, aK as pt, n as cn, aL as Ne, aM as Oa, aN as dn, a6 as ne, aO as H, R as un, aP as fn, aQ as Ta, aR as mn, aS as me, a7 as ee, aT as Da, aU as za, aV as Pa, aW as Ra, X as pe, aX as Ge, aY as Ba, aZ as $a, a_ as Wa, a$ as Ma, b0 as He, b1 as hn, b2 as ja, b3 as Va, b4 as Ga, b5 as We, b6 as Ha, b7 as Ua, b8 as Ka, b9 as qa, ba as Ya, bb as Za, bc as Xa, bd as Ja, be as Qa, bf as er, bg as lt, bh as it, bi as pn, bj as tr, bk as nr, bl as bn, bm as ar, bn as rr, T as Ue, bo as bt, bp as gn, bq as lr, br as xn, bs as ir, bt as sr, bu as or, bv as Le, bw as cr, bx as De, by as At, bz as st, bA as dr, bB as ur, a as fr, c as mr, bC as hr, bD as vn, bE as pr, bF as br, F as gr, bG as wn, _ as xr, bH as yn, bI as vr, bJ as Lt, bK as wr, bL as yr, bM as Nr, bN as Cr, bO as Nn, bP as kr, bQ as Sr, bR as Ir, bS as Fr, bT as Ar, Y as Cn, bU as ue, bV as kn, bW as gt, bX as xt, bY as vt, bZ as Sn, b_ as wt, b$ as In, $ as Fn, c0 as Lr, c1 as Er, c2 as _r, c3 as Or, c4 as Tr, c5 as Dr, c6 as zr, c7 as Pr, c8 as Rr, c9 as Br, ca as $r, cb as Et, cc as _t, cd as Ot, ce as Wr, cf as Mr, cg as jr, ch as Vr, ci as An, cj as Gr, ck as Hr, cl as Ur } from "./F0AiChat-DCBZKVBj.js";
+import { cF as Ac, cE as Lc, co as Ec, cR as _c, cy as Oc, cz as Tc, cn as Dc, cB as zc, cp as Pc, d1 as Rc, c$ as Bc, cq as $c, cC as Wc, cD as Mc, cA as jc, cr as Vc, cN as Gc, cO as Hc, cS as Uc, cZ as Kc, c_ as qc, d0 as Yc, cx as Zc, cs as Xc, cH as Jc, cG as Qc, ct as ed, cu as td, cv as nd, cP as ad, d2 as rd, cm as ld, cQ as id, cU as sd, cV as od, cM as cd, cJ as dd, cL as ud, cI as fd, cw as md, cK as hd, cW as pd, cX as bd, cT as gd, cY as xd } from "./F0AiChat-DCBZKVBj.js";
 import { jsx as e, jsxs as o, Fragment as U } from "react/jsx-runtime";
 import re, { forwardRef as j, useRef as V, useTransition as Kr, useState as _, useLayoutEffect as Ln, useContext as Ke, createContext as yt, useCallback as Q, useMemo as K, useEffect as W, useId as qr, Fragment as Yr, isValidElement as Zr, cloneElement as En, Children as _n } from "react";
-import { C as Xr, P as Jr, g as On, c as Qr, F as ot, f as el, a as tl, A as nl, B as al, L as rl, b as ll, V as il, d as sl, e as Tt, h as ol, i as cl } from "./index-Dc8ulwvV.js";
-import { l as wd, m as yd, j as Nd, n as Cd, s as kd, D as Sd, k as Id, o as Fd, w as Ad, x as Ld, N as Ed, y as _d, p as Od, r as Td, R as Dd, u as zd, q as Pd, _ as Rd, v as Bd, t as $d } from "./index-Dc8ulwvV.js";
+import { C as Xr, P as Jr, g as On, c as Qr, F as ot, f as el, a as tl, A as nl, B as al, L as rl, b as ll, V as il, d as sl, e as Tt, h as ol, i as cl } from "./index-DM6oo-6E.js";
+import { l as wd, m as yd, j as Nd, n as Cd, s as kd, D as Sd, k as Id, o as Fd, w as Ad, x as Ld, N as Ed, y as _d, p as Od, r as Td, R as Dd, u as zd, q as Pd, _ as Rd, v as Bd, t as $d } from "./index-DM6oo-6E.js";
 const dl = oa("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

@@ -161,6 +161,7 @@ import { WithDataTestIdReturnType as WithDataTestIdReturnType_7 } from './f0';
 import { WithDataTestIdReturnType as WithDataTestIdReturnType_8 } from './f0';
 import { z } from 'zod';
 import { ZodEffects } from 'zod';
+import { ZodErrorMap } from 'zod';
 import { ZodRawShape } from 'zod';
 import { ZodType } from 'zod';
 import { ZodTypeAny } from 'zod';
@@ -2825,6 +2826,98 @@ export declare function createAtlaskitDriver(instanceId: symbol): DndDriver;
  */
 export declare const createDataSourceDefinition: <R extends RecordType = RecordType, FiltersSchema extends FiltersDefinition = FiltersDefinition, Sortings extends SortingsDefinition = SortingsDefinition, Grouping extends GroupingDefinition<R> = GroupingDefinition<R>>(definition: DataSourceDefinition<R, FiltersSchema, Sortings, Grouping>) => DataSourceDefinition<R, FiltersSchema, Sortings, Grouping>;
 
+/**
+ * Creates a headless form tester from a form definition object returned by
+ * `useF0FormDefinition`. Extracts the `schema` and `defaultValues` from the
+ * definition and delegates to `createF0FormTester`.
+ *
+ * This is the recommended way to unit-test the validation logic of a form
+ * definition hook without mounting any React components.
+ *
+ * @example
+ * ```ts
+ * // useEmployeeForm.ts
+ * export function useEmployeeForm(employee: Employee) {
+ *   return useF0FormDefinition({
+ *     name: "employee-form",
+ *     schema: employeeSchema,
+ *     defaultValues: { name: employee.name, email: employee.email },
+ *     onSubmit: async ({ data }) => updateEmployee(data),
+ *   })
+ * }
+ *
+ * // useEmployeeForm.test.ts
+ * it("requires name and email", async () => {
+ *   const { result } = zeroRenderHook(() =>
+ *     useEmployeeForm({ name: "", email: "" })
+ *   )
+ *   const tester = createF0FormDefinitionTester(result.current)
+ *
+ *   const { errors } = await tester.validate()
+ *   expect(errors).toHaveProperty("name")
+ *   expect(errors).toHaveProperty("email")
+ * })
+ *
+ * it("is valid when required fields are filled", async () => {
+ *   const { result } = zeroRenderHook(() =>
+ *     useEmployeeForm({ name: "", email: "" })
+ *   )
+ *   const tester = createF0FormDefinitionTester(result.current)
+ *
+ *   const { valid } = await tester.validate({ name: "Alice", email: "alice@example.com" })
+ *   expect(valid).toBe(true)
+ * })
+ * ```
+ *
+ * @remarks
+ * This utility only supports **single-schema** form definitions
+ * (`F0FormDefinitionSingleSchema`). If your form uses per-section definitions
+ * (the array variant returned by {@link useF0FormDefinition}), you must create
+ * a {@link createF0FormTester} for each section's schema directly.
+ */
+export declare function createF0FormDefinitionTester<TSchema extends F0FormSchema>(definition: F0FormDefinitionSingleSchema<TSchema>, options?: Pick<CreateF0FormTesterOptions<TSchema>, "errorMap">): F0FormTester<TSchema>;
+
+/**
+ * Create a headless form tester that validates a schema using the same
+ * conditional resolver logic that real F0Form uses internally.
+ *
+ * No React, no DOM, no providers required.
+ *
+ * @example
+ * ```ts
+ * const schema = z.object({
+ *   name: f0FormField(z.string().min(1), { label: "Name" }),
+ *   email: f0FormField(z.string().email(), { label: "Email" }),
+ * })
+ *
+ * const tester = createF0FormTester({ schema })
+ *
+ * const { errors } = await tester.validate()
+ * expect(errors).toHaveProperty("name")
+ * expect(errors).toHaveProperty("email")
+ *
+ * const { valid } = await tester.validate({ name: "Alice", email: "alice@example.com" })
+ * expect(valid).toBe(true)
+ * ```
+ */
+export declare function createF0FormTester<TSchema extends F0FormSchema>(options: CreateF0FormTesterOptions<TSchema>): F0FormTester<TSchema>;
+
+export declare interface CreateF0FormTesterOptions<TSchema extends F0FormSchema> {
+    schema: TSchema;
+    defaultValues?: Partial<z.infer<TSchema>>;
+    /**
+     * Optional submit handler. When provided, `tester.submit(values)` will run
+     * schema validation first and then call this handler if validation passes.
+     * Mirrors the signature used inside F0Form — the tester supplies `data`.
+     */
+    onSubmit?: (data: z.infer<TSchema>) => Promise<F0FormSubmitResult> | F0FormSubmitResult;
+    /**
+     * Optional Zod errorMap. Defaults to Zod's built-in English messages.
+     * Pass a custom errorMap to get localised messages in assertions.
+     */
+    errorMap?: ZodErrorMap;
+}
+
 export declare const createPageLayoutBlock: <Props = unknown>(displayName: string, Component: React.ComponentType<Props>) => React.ComponentType<Props> & PageLayoutBlockComponent;
 
 export declare const createPageLayoutBlockGroup: <Props = unknown>(displayName: string, Component: React.ComponentType<Props>) => React.ComponentType<Props> & PageLayoutGroupComponent;
@@ -7239,6 +7332,77 @@ export declare type F0FormSubmitResult = {
     errors?: Record<string, string>;
 };
 
+export declare interface F0FormTester<TSchema extends F0FormSchema> {
+    /**
+     * Run validation against the schema.
+     *
+     * Provided `values` are merged on top of the tester's `defaultValues` so
+     * you can test incremental fills:
+     *
+     * ```ts
+     * const { errors } = await tester.validate()                        // all required errors
+     * const { errors } = await tester.validate({ name: "Alice" })       // remaining errors
+     * const { valid }  = await tester.validate({ name: "Alice", email: "a@b.com" }) // valid
+     * ```
+     *
+     * Fields with `renderIf` conditions that evaluate to `false` for the given
+     * values are skipped — matching real F0Form behaviour.
+     */
+    validate(values?: Record<string, unknown>): Promise<F0FormValidationResult>;
+    /**
+     * Validate a single field in isolation.
+     * Returns `{ valid, errors }` where `errors` contains at most one entry.
+     */
+    validateField(fieldName: string, values?: Record<string, unknown>): Promise<F0FormValidationResult>;
+    /**
+     * Return field descriptions for all fields in the schema.
+     * Delegates to `describeFormSchema()` — useful for asserting field metadata.
+     */
+    describeFields(): FormFieldDescription[];
+    /**
+     * Return the default values this tester was created with, if any.
+     */
+    getDefaultValues(): Partial<z.infer<TSchema>> | undefined;
+    /**
+     * Return the names of fields that are currently visible (renderIf === true)
+     * for the given values, merged with the tester's defaultValues.
+     */
+    getVisibleFields(values?: Record<string, unknown>): string[];
+    /**
+     * Run schema validation and, if it passes, call the `onSubmit` handler
+     * provided in the options. Useful for testing server-side errors that an
+     * `onSubmit` returns (e.g. duplicate email, insufficient permissions).
+     *
+     * If schema validation fails the handler is never called and the result
+     * is `{ success: false, errors: <validation errors> }`.
+     *
+     * Requires `onSubmit` to be set in `createF0FormTesterOptions`.
+     *
+     * @example
+     * ```ts
+     * const tester = createF0FormDefinitionTester(result.current)
+     *
+     * const result = await tester.submit({ name: "Alice", email: "taken@example.com" })
+     * expect(result.success).toBe(false)
+     * expect((result as { errors: Record<string,string> }).errors.email)
+     *   .toBe("Email already registered")
+     * ```
+     */
+    submit(values?: Record<string, unknown>): Promise<F0FormSubmitResult>;
+}
+
+export declare interface F0FormValidationResult {
+    /** Whether all visible fields pass validation */
+    valid: boolean;
+    /** Flat map of field name → error message for every failing field */
+    errors: Record<string, string>;
+    /**
+     * Root-level Zod error message (if any). Corresponds to issues with
+     * `path.length === 0` — e.g. from `.refine()` calls at the object level.
+     */
+    rootError?: string;
+}
+
 export declare const F0GridStack: WithDataTestIdReturnType_7<    {
 ({ options, widgets, onChange, className, static: isStatic, forcePositionSync, }: F0GridStackProps_2): JSX_2.Element;
 displayName: string;
@@ -13098,9 +13262,9 @@ declare module "gridstack" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        aiBlock: {
-            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
-            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
+        enhanceHighlight: {
+            setEnhanceHighlight: (from: number, to: number) => ReturnType;
+            clearEnhanceHighlight: () => ReturnType;
         };
     }
 }
@@ -13108,9 +13272,9 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        enhanceHighlight: {
-            setEnhanceHighlight: (from: number, to: number) => ReturnType;
-            clearEnhanceHighlight: () => ReturnType;
+        aiBlock: {
+            insertAIBlock: (data: AIBlockData, config: AIBlockConfig) => ReturnType;
+            executeAIAction: (actionType: string, config: AIBlockConfig) => ReturnType;
         };
     }
 }