@factorialco/f0-react 2.23.0 → 2.25.0

package/dist/ai.d.ts

@@ -2180,7 +2180,9 @@ declare type DetailsItemContent = (ComponentProps<typeof DataList.Item> & {
 }[TagType_2] | {
     type: "avatar-list";
     avatarList: F0AvatarListProps;
-};
+} | (ComponentProps<typeof FileItem> & {
+    type: "file";
+});
 
 /**
  * Remove a property from a union of objects.
@@ -2785,6 +2787,15 @@ declare type F0AvatarIconProps = {
     state?: F0IconProps["state"];
 } & Partial<Pick<BaseAvatarProps, "aria-label" | "aria-labelledby">>;
 
+/**
+ * Optional extras every avatar entry may carry regardless of `type`.
+ * `tooltipDescription` is rendered as the tooltip's secondary line via the
+ * underlying `Tooltip` `description` slot (use it for emails, roles, etc.).
+ */
+declare type F0AvatarListExtras = {
+    tooltipDescription?: string;
+};
+
 declare type F0AvatarListProps = {
     /**
      * The size of the avatars in the list.
@@ -2812,23 +2823,32 @@ declare type F0AvatarListProps = {
      * @default "compact"
      */
     layout?: "fill" | "compact";
+    /**
+     * Controls the scroll behavior of the `+N` overflow popover that lists
+     * collapsed avatars (including their `tooltipDescription` entries).
+     * - `"vertical"` (default): caps the popover height and scrolls vertically.
+     * - `"none"`: lets the popover grow to fit all entries.
+     * @default "vertical"
+     */
+    tooltipScroll?: "vertical" | "none";
 } & F0AvatarListPropsAvatars;
 
 declare type F0AvatarListPropsAvatars = {
     type: "person";
-    avatars: (Omit<PersonAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<PersonAvatarVariant, "type"> & // Allow to have more properties in the avatar variant
+    F0AvatarListExtras & Record<string, unknown>)[];
 } | {
     type: "team";
-    avatars: (Omit<TeamAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<TeamAvatarVariant, "type"> & F0AvatarListExtras & Record<string, unknown>)[];
 } | {
     type: "company";
-    avatars: (Omit<CompanyAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<CompanyAvatarVariant, "type"> & F0AvatarListExtras & Record<string, unknown>)[];
 } | {
     type: "flag";
-    avatars: (Omit<FlagAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<FlagAvatarVariant, "type"> & F0AvatarListExtras & Record<string, unknown>)[];
 } | {
     type: "file";
-    avatars: (Omit<FileAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<FileAvatarVariant, "type"> & F0AvatarListExtras & Record<string, unknown>)[];
 };
 
 declare type F0AvatarPersonProps = {
@@ -3165,6 +3185,13 @@ export declare type FeedbackConfig = {
     }) => void;
 };
 
+declare type FileAction = {
+    icon?: IconType;
+    label: string;
+    onClick: () => void;
+    critical?: boolean;
+};
+
 declare type FileAvatarVariant = Extract<AvatarVariant, {
     type: "file";
 }>;
@@ -3174,6 +3201,27 @@ declare type FileDef = {
     type: string;
 };
 
+declare const FileItem: WithDataTestIdReturnType<ForwardRefExoticComponent<FileItemProps & RefAttributes<HTMLDivElement>>>;
+
+declare interface FileItemProps extends React.HTMLAttributes<HTMLDivElement> {
+    file: File | FileDef;
+    actions?: FileAction[];
+    disabled?: boolean;
+    size?: FileItemSize;
+}
+
+declare type FileItemSize = NonNullable<VariantProps<typeof fileItemVariants>["size"]>;
+
+declare const fileItemVariants: (props?: ({
+    size?: "lg" | "md" | undefined;
+} & ({
+    class?: ClassValue;
+    className?: never;
+} | {
+    class?: never;
+    className?: ClassValue;
+})) | undefined) => string;
+
 declare type FlagAvatarVariant = Extract<AvatarVariant, {
     type: "flag";
 }>;

package/dist/ai.js

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

package/dist/experimental.d.ts

@@ -2645,6 +2645,13 @@ export declare type DataSourceDefinition<R extends RecordType = RecordType, Filt
         item: R;
         pagination?: ChildrenPaginationInfo;
     }) => number | undefined;
+    /**
+     * Item ids that start expanded on first render. Rows matched here have
+     * their children fetched eagerly. Only rows whose `item.id` is in this
+     * list are auto-expanded — nested descendants are not, unless their own id
+     * is also included. Defaults to none.
+     */
+    defaultExpandedIds?: Array<string | number>;
 };
 
 declare type DateCellConfig = {
@@ -3602,7 +3609,9 @@ export declare type DetailsItemContent = (ComponentProps<typeof DataList.Item> &
 }[TagType_2] | {
     type: "avatar-list";
     avatarList: F0AvatarListProps;
-};
+} | (ComponentProps<typeof FileItem> & {
+    type: "file";
+});
 
 /**
  * @experimental This is an experimental component use it at your own risk
@@ -4123,6 +4132,15 @@ declare type F0AvatarIconProps = {
     state?: F0IconProps["state"];
 } & Partial<Pick<BaseAvatarProps, "aria-label" | "aria-labelledby">>;
 
+/**
+ * Optional extras every avatar entry may carry regardless of `type`.
+ * `tooltipDescription` is rendered as the tooltip's secondary line via the
+ * underlying `Tooltip` `description` slot (use it for emails, roles, etc.).
+ */
+declare type F0AvatarListExtras = {
+    tooltipDescription?: string;
+};
+
 declare type F0AvatarListProps = {
     /**
      * The size of the avatars in the list.
@@ -4150,23 +4168,32 @@ declare type F0AvatarListProps = {
      * @default "compact"
      */
     layout?: "fill" | "compact";
+    /**
+     * Controls the scroll behavior of the `+N` overflow popover that lists
+     * collapsed avatars (including their `tooltipDescription` entries).
+     * - `"vertical"` (default): caps the popover height and scrolls vertically.
+     * - `"none"`: lets the popover grow to fit all entries.
+     * @default "vertical"
+     */
+    tooltipScroll?: "vertical" | "none";
 } & F0AvatarListPropsAvatars;
 
 declare type F0AvatarListPropsAvatars = {
     type: "person";
-    avatars: (Omit<PersonAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<PersonAvatarVariant, "type"> & // Allow to have more properties in the avatar variant
+    F0AvatarListExtras & Record<string, unknown>)[];
 } | {
     type: "team";
-    avatars: (Omit<TeamAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<TeamAvatarVariant, "type"> & F0AvatarListExtras & Record<string, unknown>)[];
 } | {
     type: "company";
-    avatars: (Omit<CompanyAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<CompanyAvatarVariant, "type"> & F0AvatarListExtras & Record<string, unknown>)[];
 } | {
     type: "flag";
-    avatars: (Omit<FlagAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<FlagAvatarVariant, "type"> & F0AvatarListExtras & Record<string, unknown>)[];
 } | {
     type: "file";
-    avatars: (Omit<FileAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<FileAvatarVariant, "type"> & F0AvatarListExtras & Record<string, unknown>)[];
 };
 
 export declare const F0AvatarModule: WithDataTestIdReturnType_5<typeof F0AvatarModule_2>;
@@ -5588,6 +5615,7 @@ declare type MetadataItemValue = {
     variant: StatusVariant;
 } | ({
     type: "list";
+    max?: number;
 } & ({
     variant: "person";
     avatars: (PersonAvatarVariant | (PersonAvatarVariant & Record<string, unknown>))[];

package/dist/experimental.js

@@ -1,9 +1,9 @@
-import { g as ua, B as fa, h as ma, i as ha, j as At, k as De, l as ga, m as g, n as X, o as pe, u as se, T as pa, p as ba, q as xa, R as va, r as wa, s as ne, t as ya, v as gt, w as rt, x as Re, A as _e, y as Na, z as Ca, C as W, E as ka, G as Sa, H as ve, J as sn, K as Ia, L as Fa, M, N as on, S as O, O as we, Q as Aa, U as La, V as Ea, W as _a, X as Oa, Y as ke, Z as cn, _ as Da, $ as be, a0 as $e, a1 as Ta, a2 as pt, d as dn, a3 as Ce, a4 as za, a5 as un, a6 as ae, a7 as H, a8 as fn, a9 as Pa, aa as Ba, ab as Ra, ac as mn, ad as $a, ae as hn, af as me, ag as ee, ah as Wa, ai as Ma, aj as ja, ak as Va, al as ge, am as Ge, an as Ga, ao as Ha, ap as Ua, aq as Ka, ar as He, as as gn, at as qa, au as Ya, av as Za, aw as We, ax as Xa, ay as Ja, az as Qa, aA as er, aB as tr, aC as nr, aD as ar, aE as rr, aF as lr, aG as sr, aH as lt, aI as st, aJ as pn, aK as ir, aL as or, aM as cr, aN as dr, aO as Ue, aP as bt, aQ as bn, aR as ur, aS as xn, aT as fr, aU as mr, aV as hr, aW as Ee, aX as gr, aY as Lt, aZ as it, a_ as pr, a$ as br, a as xr, b as vr, b0 as vn, b1 as wr, f as yr, F as Nr, b2 as wn, b3 as Cr, b4 as yn, b5 as kr, b6 as Sr, b7 as Ir, b8 as Fr, b9 as Ar, ba as Lr, bb as Er, bc as _r, bd as Or, be as Nn, bf as ue, bg as Cn, bh as kn, bi as Dr, bj as Tr, bk as zr, bl as Pr, bm as Br, bn as Rr, bo as $r, bp as Et, bq as _t, br as Ot, bs as Wr, bt as Mr, bu as jr, bv as Vr, bw as Sn, bx as Gr, by as Hr } from "./F0CanvasPanel-CSOSmTuX.js";
-import { bK as Tc, bJ as zc, bW as Pc, bG as Bc, bH as Rc, bz as $c, bA as Wc, bX as Mc, bB as jc, bI as Vc, bS as Gc, bT as Hc, bC as Uc, bM as Kc, bL as qc, bD as Yc, bE as Zc, bU as Xc, bY as Jc, bV as Qc, bR as ed, bO as td, bQ as nd, bN as ad, bF as rd, bP as ld } from "./F0CanvasPanel-CSOSmTuX.js";
+import { g as ua, B as fa, h as ma, i as ha, j as At, k as De, l as ga, m as g, n as X, o as pe, u as se, T as pa, p as ba, q as xa, R as va, r as wa, s as ne, t as ya, v as gt, w as rt, x as Re, A as _e, y as Na, z as Ca, C as W, E as ka, G as Sa, H as ve, J as sn, K as Ia, L as Fa, M, N as on, S as O, O as we, Q as Aa, U as La, V as Ea, W as _a, X as Oa, Y as ke, Z as cn, _ as Da, $ as be, a0 as $e, a1 as Ta, a2 as pt, d as dn, a3 as Ce, a4 as za, a5 as un, a6 as ae, a7 as H, a8 as fn, a9 as Pa, aa as Ba, ab as Ra, ac as mn, ad as $a, ae as hn, af as me, ag as ee, ah as Wa, ai as Ma, aj as ja, ak as Va, al as ge, am as Ge, an as Ga, ao as Ha, ap as Ua, aq as Ka, ar as He, as as gn, at as qa, au as Ya, av as Za, aw as We, ax as Xa, ay as Ja, az as Qa, aA as er, aB as tr, aC as nr, aD as ar, aE as rr, aF as lr, aG as sr, aH as lt, aI as st, aJ as pn, aK as ir, aL as or, aM as cr, aN as dr, aO as Ue, aP as bt, aQ as bn, aR as ur, aS as xn, aT as fr, aU as mr, aV as hr, aW as Ee, aX as gr, aY as Lt, aZ as it, a_ as pr, a$ as br, a as xr, b as vr, b0 as vn, b1 as wr, f as yr, F as Nr, b2 as wn, b3 as Cr, b4 as yn, b5 as kr, b6 as Sr, b7 as Ir, b8 as Fr, b9 as Ar, ba as Lr, bb as Er, bc as _r, bd as Or, be as Nn, bf as ue, bg as Cn, bh as kn, bi as Dr, bj as Tr, bk as zr, bl as Pr, bm as Br, bn as Rr, bo as $r, bp as Et, bq as _t, br as Ot, bs as Wr, bt as Mr, bu as jr, bv as Vr, bw as Sn, bx as Gr, by as Hr } from "./F0CanvasPanel-DAJcyyFM.js";
+import { bK as Tc, bJ as zc, bW as Pc, bG as Bc, bH as Rc, bz as $c, bA as Wc, bX as Mc, bB as jc, bI as Vc, bS as Gc, bT as Hc, bC as Uc, bM as Kc, bL as qc, bD as Yc, bE as Zc, bU as Xc, bY as Jc, bV as Qc, bR as ed, bO as td, bQ as nd, bN as ad, bF as rd, bP as ld } from "./F0CanvasPanel-DAJcyyFM.js";
 import { jsx as e, jsxs as o, Fragment as K } from "react/jsx-runtime";
 import ie, { forwardRef as j, useRef as G, useTransition as Ur, useState as _, useLayoutEffect as In, useId as ot, useContext as Ke, createContext as xt, useEffect as $, useCallback as Q, useMemo as q, Fragment as Kr, isValidElement as qr, cloneElement as Fn, Children as An } from "react";
-import { C as Yr, P as Zr, g as Ln, c as Xr, a as En, F as ct, f as Jr, b as Te, M as Qr, d as el, R as Dt, e as _n, u as tl, h as On, i as vt, j as wt, k as yt, l as Dn, m as Nt, n as nl, o as al, S as rl, p as ll, A as sl, B as il, L as ol, q as cl, V as dl, r as ul, s as Tt, t as fl, v as ml, O as hl } from "./useDataCollectionSource-DnYC5D7b.js";
-import { D as id, E as od, y as cd, W as dd, G as ud, N as fd, ad as md, U as hd, z as gd, a0 as pd, aj as bd, a1 as xd, a2 as vd, H as wd, af as yd, ag as Nd, ae as Cd, ah as kd, Y as Sd, a3 as Id, aa as Fd, ac as Ad, I as Ld, K as Ed, Q as _d, _ as Od, ai as Dd, $ as Td, Z as zd, J as Pd, T as Bd, w as Rd, x as $d, a5 as Wd, a6 as Md, ab as jd, X as Vd, a7 as Gd, a8 as Hd, a4 as Ud, a9 as Kd } from "./useDataCollectionSource-DnYC5D7b.js";
+import { C as Yr, P as Zr, g as Ln, c as Xr, a as En, F as ct, f as Jr, b as Te, M as Qr, d as el, R as Dt, e as _n, u as tl, h as On, i as vt, j as wt, k as yt, l as Dn, m as Nt, n as nl, o as al, S as rl, p as ll, A as sl, B as il, L as ol, q as cl, V as dl, r as ul, s as Tt, t as fl, v as ml, O as hl } from "./useDataCollectionSource-CjRrXJC3.js";
+import { D as id, E as od, y as cd, W as dd, G as ud, N as fd, ad as md, U as hd, z as gd, a0 as pd, aj as bd, a1 as xd, a2 as vd, H as wd, af as yd, ag as Nd, ae as Cd, ah as kd, Y as Sd, a3 as Id, aa as Fd, ac as Ad, I as Ld, K as Ed, Q as _d, _ as Od, ai as Dd, $ as Td, Z as zd, J as Pd, T as Bd, w as Rd, x as $d, a5 as Wd, a6 as Md, ab as jd, X as Vd, a7 as Gd, a8 as Hd, a4 as Ud, a9 as Kd } from "./useDataCollectionSource-CjRrXJC3.js";
 const gl = ua("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

@@ -3735,6 +3735,13 @@ export declare type DataSourceDefinition<R extends RecordType = RecordType, Filt
         item: R;
         pagination?: ChildrenPaginationInfo;
     }) => number | undefined;
+    /**
+     * Item ids that start expanded on first render. Rows matched here have
+     * their children fetched eagerly. Only rows whose `item.id` is in this
+     * list are auto-expanded — nested descendants are not, unless their own id
+     * is also included. Defaults to none.
+     */
+    defaultExpandedIds?: Array<string | number>;
 };
 
 /**
@@ -4789,7 +4796,9 @@ declare type DetailsItemContent = (ComponentProps<typeof DataList.Item> & {
 }[TagType] | {
     type: "avatar-list";
     avatarList: F0AvatarListProps;
-};
+} | (ComponentProps<typeof FileItem> & {
+    type: "file";
+});
 
 export declare type DialogPosition = (typeof dialogPositions)[number];
 
@@ -6092,10 +6101,19 @@ export declare type F0AvatarIconProps = {
 } & Partial<Pick<BaseAvatarProps, "aria-label" | "aria-labelledby">>;
 
 export declare const F0AvatarList: WithDataTestIdReturnType_4<    {
-({ avatars, size, type, noTooltip, remainingCount: initialRemainingCount, max, }: F0AvatarListProps_2): JSX_2.Element;
+({ avatars, size, type, noTooltip, remainingCount: initialRemainingCount, max, tooltipScroll, }: F0AvatarListProps_2): JSX_2.Element;
 displayName: string;
 }>;
 
+/**
+ * Optional extras every avatar entry may carry regardless of `type`.
+ * `tooltipDescription` is rendered as the tooltip's secondary line via the
+ * underlying `Tooltip` `description` slot (use it for emails, roles, etc.).
+ */
+declare type F0AvatarListExtras = {
+    tooltipDescription?: string;
+};
+
 export declare type F0AvatarListProps = {
     /**
      * The size of the avatars in the list.
@@ -6123,23 +6141,32 @@ export declare type F0AvatarListProps = {
      * @default "compact"
      */
     layout?: "fill" | "compact";
+    /**
+     * Controls the scroll behavior of the `+N` overflow popover that lists
+     * collapsed avatars (including their `tooltipDescription` entries).
+     * - `"vertical"` (default): caps the popover height and scrolls vertically.
+     * - `"none"`: lets the popover grow to fit all entries.
+     * @default "vertical"
+     */
+    tooltipScroll?: "vertical" | "none";
 } & F0AvatarListPropsAvatars;
 
 declare type F0AvatarListPropsAvatars = {
     type: "person";
-    avatars: (Omit<PersonAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<PersonAvatarVariant, "type"> & // Allow to have more properties in the avatar variant
+    F0AvatarListExtras & Record<string, unknown>)[];
 } | {
     type: "team";
-    avatars: (Omit<TeamAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<TeamAvatarVariant, "type"> & F0AvatarListExtras & Record<string, unknown>)[];
 } | {
     type: "company";
-    avatars: (Omit<CompanyAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<CompanyAvatarVariant, "type"> & F0AvatarListExtras & Record<string, unknown>)[];
 } | {
     type: "flag";
-    avatars: (Omit<FlagAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<FlagAvatarVariant, "type"> & F0AvatarListExtras & Record<string, unknown>)[];
 } | {
     type: "file";
-    avatars: (Omit<FileAvatarVariant, "type"> & Record<string, unknown>)[];
+    avatars: (Omit<FileAvatarVariant, "type"> & F0AvatarListExtras & Record<string, unknown>)[];
 };
 
 export declare const F0AvatarModule: WithDataTestIdReturnType_4<typeof F0AvatarModule_2>;
@@ -9564,28 +9591,35 @@ export declare interface F0TimelineRowMultitaskProps extends F0TimelineRowBasePr
 }
 
 /**
- * Props for a nestedtask timeline row.
- * Renders a task-style header (custom icon, title, description, chevron toggle)
- * with collapsible nested items and optional group-level metadata (assignees, file chips, etc.).
- * Unlike multitask, the header looks like a regular task row with expand/collapse capability.
+ * Shared shape for nestedtask rows. The collapsible behaviour is layered on
+ * top via a discriminated union (`F0TimelineRowNestedtaskProps`) so callers
+ * either provide both `expanded` and `onExpandToggle` (collapsible) or
+ * neither (non-collapsible).
  */
-export declare interface F0TimelineRowNestedtaskProps extends F0TimelineRowBaseProps {
+declare interface F0TimelineRowNestedtaskBaseProps extends F0TimelineRowBaseProps {
     /** The icon representing the task type */
     icon: IconType;
     /** Description text (e.g., "Estimated on 18/07/2025") */
     description?: string;
-    /** Number of nested items (displayed in the progress pill) */
-    taskCount: number;
+    /**
+     * Number of nested items (displayed in the progress pill alongside
+     * `completedCount`). Omit when the row body conveys progress on its own
+     * (e.g. an embedded info card or table) and a pill would be redundant.
+     */
+    taskCount?: number;
     /** Number of completed items (displayed in the progress pill) */
     completedCount?: number;
-    /** Whether the row is expanded (controlled) */
-    expanded: boolean;
-    /** Callback when expand/collapse is toggled */
-    onExpandToggle: () => void;
     /** Metadata items displayed below the header (e.g., assignees, file chips). Always visible regardless of expand/collapse */
     metadata?: (MetadataItem | undefined | boolean)[];
-    /** The nested task items to render when expanded */
-    items: F0TimelineRowTaskProps[];
+    /** The nested task items to render when expanded. Ignored when `content` is provided. */
+    items?: F0TimelineRowTaskProps[];
+    /**
+     * Custom content to render in the expanded body of the row. When provided,
+     * `items` is ignored and this React node is rendered instead. Use this to
+     * embed richer UI (callout cards, tables, custom panels) inside a nested
+     * timeline row.
+     */
+    content?: React.ReactNode;
     /** Primary action button (displayed on the right after a divider) */
     primaryAction?: F0TimelineRowAction;
     /** Secondary action buttons (displayed on the left) */
@@ -9594,6 +9628,38 @@ export declare interface F0TimelineRowNestedtaskProps extends F0TimelineRowBaseP
     otherActions?: F0TimelineRowOtherAction[];
 }
 
+/**
+ * Props for a nestedtask timeline row.
+ * Renders a task-style header (custom icon, title, description, chevron toggle)
+ * with collapsible nested items and optional group-level metadata (assignees, file chips, etc.).
+ * Unlike multitask, the header looks like a regular task row with expand/collapse capability.
+ *
+ * Discriminated by `collapsible`:
+ * - default / `collapsible: true` — both `expanded` and `onExpandToggle` are required.
+ * - `collapsible: false` — the row is always expanded, the header has no toggle affordance,
+ *   and `expanded`/`onExpandToggle` are not accepted.
+ */
+export declare type F0TimelineRowNestedtaskProps = (F0TimelineRowNestedtaskBaseProps & {
+    /**
+     * Whether the header chevron toggles the body.
+     * @default true
+     */
+    collapsible?: true;
+    /** Whether the row is expanded (controlled) */
+    expanded: boolean;
+    /** Callback when expand/collapse is toggled */
+    onExpandToggle: () => void;
+}) | (F0TimelineRowNestedtaskBaseProps & {
+    /**
+     * When false, the row is always expanded and the header has no toggle
+     * affordance — useful when the body controls its own expansion
+     * (e.g. a collapsible callout card).
+     */
+    collapsible: false;
+    expanded?: never;
+    onExpandToggle?: never;
+});
+
 export declare type F0TimelineRowOtherAction = DropdownItem;
 
 export declare type F0TimelineRowProps = F0TimelineRowTaskProps | F0TimelineRowMultitaskProps | F0TimelineRowNestedtaskProps;
@@ -11200,6 +11266,7 @@ declare type MetadataItemValue = {
     variant: StatusVariant;
 } | ({
     type: "list";
+    max?: number;
 } & ({
     variant: "person";
     avatars: (PersonAvatarVariant | (PersonAvatarVariant & Record<string, unknown>))[];