@factorialco/f0-react 1.418.1 → 1.419.0

package/dist/ai.d.ts

@@ -1296,6 +1296,7 @@ export declare const defaultTranslations: {
             readonly fileTooLarge: "File exceeds {{maxSize}} MB limit";
             readonly invalidFileType: "File type not accepted. Accepted formats: {{types}}";
         };
+        readonly moreInformation: "More information";
         readonly validation: {
             readonly required: "This field is required";
             readonly invalidType: "Invalid value";

package/dist/experimental.d.ts

@@ -1351,6 +1351,11 @@ export declare interface CardSelectableItem<T extends CardSelectableValue> {
     disabled?: boolean;
     /** Whether this item is required (shows asterisk indicator) */
     required?: boolean;
+    /** Link displayed below the description, typically pointing to external documentation */
+    moreInfoLink?: {
+        href: string;
+        label?: string;
+    };
 }
 
 export declare interface CardSelectableMultipleProps<T extends CardSelectableValue> {
@@ -2859,6 +2864,7 @@ declare const defaultTranslations: {
             readonly fileTooLarge: "File exceeds {{maxSize}} MB limit";
             readonly invalidFileType: "File type not accepted. Accepted formats: {{types}}";
         };
+        readonly moreInformation: "More information";
         readonly validation: {
             readonly required: "This field is required";
             readonly invalidType: "Invalid value";

package/dist/experimental.js

@@ -3,8 +3,8 @@ import { eP as WI, eO as UI, eM as GI, aI as KI, eN as qI, eX as YI, eY as JI, e
 import { jsx as c, jsxs as g, Fragment as ne } from "react/jsx-runtime";
 import * as Sn from "react";
 import z, { PureComponent as Tp, forwardRef as P, useRef as K, useTransition as Dp, useState as L, useLayoutEffect as Ga, useContext as Hs, createContext as Vs, useCallback as X, useMemo as ee, useEffect as W, useId as Ka, useImperativeHandle as qa, memo as Ya, Fragment as Rp, isValidElement as Lp, cloneElement as Ja, Children as Xa } from "react";
-import { f as Yt, ac as Nn, e as nr, ad as Op, L as wi, ae as Mp, A as Pp, i as rr, k as Fp, G as zp, g as Lo, af as $p, j as Oo, n as Bp, ag as Za, ah as Qa, ai as jp, C as Hp, aa as Vp, aj as je, ak as ot, al as Ee, am as Wp, an as gr, ao as Ue, ap as ec, aq as Me, ar as Ws, as as $e, at as Mo, au as Up, av as tc, aw as Ie, ax as Fe, ay as In, az as Rr, aA as nc, aB as Gp, aC as Vt, aD as Kp, aE as qp, aF as Yp, aG as Wn, aH as Un, aI as Us, aJ as Jp, aK as rc, aL as ic, aM as sc, aN as Xp, aO as oc, aP as lc, aQ as ac, aR as cc, aS as dc, aT as uc, a3 as Po, aU as Zp, aV as Fo, aW as Qp, aX as em, aY as tm, w as nm, x as rm, z as im, J as sm, K as om, s as lm, aZ as fc, a_ as am, a$ as cm, b0 as dm, b1 as hc, a7 as Ui, b2 as um, b3 as fm, b4 as hm, b5 as pm, b6 as mm, b7 as gm, b8 as bm, b9 as wm, ba as xm, bb as ym, bc as vm, bd as km, ab as pc, M as Cm, N as Sm, P as Nm, Q as Im, V as Am, O as _m, be as zo, bf as Em, bg as Tm, l as Dm } from "./index-uBFHZ597.js";
-import { a5 as pA, Z as mA, a0 as gA, R as bA, $ as wA, bk as xA, bj as yA, bh as vA, bi as kA, T as CA, a4 as SA, U as NA, _ as IA, W as AA, a8 as _A, a9 as EA } from "./index-uBFHZ597.js";
+import { f as Yt, ac as Nn, e as nr, ad as Op, L as wi, ae as Mp, A as Pp, i as rr, k as Fp, G as zp, g as Lo, af as $p, j as Oo, n as Bp, ag as Za, ah as Qa, ai as jp, C as Hp, aa as Vp, aj as je, ak as ot, al as Ee, am as Wp, an as gr, ao as Ue, ap as ec, aq as Me, ar as Ws, as as $e, at as Mo, au as Up, av as tc, aw as Ie, ax as Fe, ay as In, az as Rr, aA as nc, aB as Gp, aC as Vt, aD as Kp, aE as qp, aF as Yp, aG as Wn, aH as Un, aI as Us, aJ as Jp, aK as rc, aL as ic, aM as sc, aN as Xp, aO as oc, aP as lc, aQ as ac, aR as cc, aS as dc, aT as uc, a3 as Po, aU as Zp, aV as Fo, aW as Qp, aX as em, aY as tm, w as nm, x as rm, z as im, J as sm, K as om, s as lm, aZ as fc, a_ as am, a$ as cm, b0 as dm, b1 as hc, a7 as Ui, b2 as um, b3 as fm, b4 as hm, b5 as pm, b6 as mm, b7 as gm, b8 as bm, b9 as wm, ba as xm, bb as ym, bc as vm, bd as km, ab as pc, M as Cm, N as Sm, P as Nm, Q as Im, V as Am, O as _m, be as zo, bf as Em, bg as Tm, l as Dm } from "./index-ClKgg8Ep.js";
+import { a5 as pA, Z as mA, a0 as gA, R as bA, $ as wA, bk as xA, bj as yA, bh as vA, bi as kA, T as CA, a4 as SA, U as NA, _ as IA, W as AA, a8 as _A, a9 as EA } from "./index-ClKgg8Ep.js";
 import './experimental.css';const Rm = mf("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

@@ -3400,6 +3400,7 @@ export declare const defaultTranslations: {
             readonly fileTooLarge: "File exceeds {{maxSize}} MB limit";
             readonly invalidFileType: "File type not accepted. Accepted formats: {{types}}";
         };
+        readonly moreInformation: "More information";
         readonly validation: {
             readonly required: "This field is required";
             readonly invalidType: "Invalid value";
@@ -4241,10 +4242,6 @@ export declare type F0AvatarTeamProps = {
     badge?: AvatarBadge;
 } & Pick<BaseAvatarProps, "aria-label" | "aria-labelledby">;
 
-/**
- * Base configuration shared across all field types.
- * Position is automatically derived from field declaration order in the schema.
- */
 export declare interface F0BaseConfig {
     /** Label displayed above the field */
     label: string;
@@ -4286,6 +4283,20 @@ export declare interface F0BaseConfig {
      * renderIf: ({ values }) => values.status === 'active'
      */
     renderIf?: F0BaseFieldRenderIfProp;
+    /**
+     * Alert displayed below the field.
+     * Can be static props (always shown) or a callback for conditional display.
+     * @example
+     * // Static alert (always visible)
+     * alert: { title: "Note", description: "This field is important" }
+     *
+     * // Conditional alert based on field value
+     * alert: ({ fieldValue }) =>
+     *   fieldValue === 0
+     *     ? { title: "Heads up", description: "Value is zero", variant: "warning" }
+     *     : null
+     */
+    alert?: F0FieldAlert;
     /**
      * Name identifying a reusable custom field type.
      * When set, the form-level `renderCustomField` callback is invoked to provide
@@ -4327,6 +4338,8 @@ export declare interface F0BaseField {
      * @default false
      */
     resetOnDisable?: boolean;
+    /** Alert displayed below the field (static props or conditional callback) */
+    alert?: F0FieldAlert;
     /**
      * Name identifying a reusable custom field type.
      * Used with the form-level `renderCustomField` callback.
@@ -4549,9 +4562,14 @@ declare function _F0Checkbox({ title, onCheckedChange, id, disabled, indetermina
 
 /**
  * F0 config options specific to checkbox fields
- * (checkbox has no additional options beyond base config)
  */
 export declare interface F0CheckboxConfig {
+    /**
+     * Link displayed below the help text, typically pointing to external documentation.
+     * @example
+     * moreInfoLink: { href: "https://help.example.com/article", label: "Learn more" }
+     */
+    moreInfoLink?: F0MoreInfoLink;
 }
 
 /**
@@ -4559,6 +4577,8 @@ export declare interface F0CheckboxConfig {
  */
 export declare type F0CheckboxField = F0BaseField & {
     type: "checkbox";
+    /** Link displayed below the help text, typically pointing to external documentation */
+    moreInfoLink?: F0MoreInfoLink;
     /** Conditional rendering based on another field's value */
     renderIf?: CheckboxFieldRenderIf;
 };
@@ -5132,6 +5152,34 @@ export declare function F0EventCatcherProvider({ children, onEvent, enabled, cat
  */
 export declare type F0Field = F0TextField | F0NumberField | F0DurationField | F0TextareaField | F0SelectField | F0CheckboxField | F0SwitchField | F0DateField | F0TimeField | F0DateTimeField | F0DateRangeField | F0RichTextField | F0FileField | F0CustomField;
 
+/**
+ * Alert configuration for a field.
+ * Can be static props (always shown) or a callback for conditional display.
+ */
+export declare type F0FieldAlert = F0FieldAlertProps | F0FieldAlertFunction;
+
+/**
+ * Callback that evaluates whether to show an alert below the field.
+ * Receives the field's current value and all form values.
+ * Return alert props to show, or null/undefined to hide.
+ */
+export declare type F0FieldAlertFunction = (context: {
+    fieldValue: unknown;
+    values: Record<string, unknown>;
+}) => F0FieldAlertProps | null | undefined;
+
+/**
+ * Base configuration shared across all field types.
+ * Position is automatically derived from field declaration order in the schema.
+ */
+/**
+ * Alert props returned by the field alert callback.
+ * Derived from F0AlertProps with `variant` defaulting to "info".
+ */
+export declare type F0FieldAlertProps = Omit<F0AlertProps, "variant"> & {
+    variant?: F0AlertProps["variant"];
+};
+
 /**
  * Complete F0 field configuration (union of all possible configs)
  * @typeParam T - The value type for select fields (string or number)
@@ -5834,6 +5882,16 @@ export declare type F0LinkProps = Omit<ActionLinkProps, "variant" | "href"> & {
     href?: string;
 };
 
+/**
+ * Configuration for a "more info" link displayed below the help text.
+ */
+export declare interface F0MoreInfoLink {
+    /** URL the link points to */
+    href: string;
+    /** Link label (defaults to "More information") */
+    label?: string;
+}
+
 /**
  * F0 config options specific to number fields
  *
@@ -6295,6 +6353,12 @@ declare type F0StringTextConfig = F0BaseConfig & F0TextConfig & {
  * (switch has no additional options beyond base config)
  */
 export declare interface F0SwitchConfig {
+    /**
+     * Link displayed below the help text, typically pointing to external documentation.
+     * @example
+     * moreInfoLink: { href: "https://help.example.com/article", label: "Learn more" }
+     */
+    moreInfoLink?: F0MoreInfoLink;
 }
 
 /**
@@ -6302,6 +6366,8 @@ export declare interface F0SwitchConfig {
  */
 export declare type F0SwitchField = F0BaseField & {
     type: "switch";
+    /** Link displayed below the help text, typically pointing to external documentation */
+    moreInfoLink?: F0MoreInfoLink;
     /** Conditional rendering based on another field's value */
     renderIf?: SwitchFieldRenderIf;
 };