@factorialco/f0-react 1.388.4 → 1.390.0

package/dist/f0.d.ts

@@ -1051,6 +1051,10 @@ export declare type ButtonDropdownItem<T = string> = {
     description?: string;
 };
 
+export declare type ButtonDropdownMode = (typeof buttonDropdownModes)[number];
+
+export declare const buttonDropdownModes: readonly ["split", "dropdown"];
+
 export declare type ButtonDropdownSize = (typeof buttonDropdownSizes)[number];
 
 export declare const buttonDropdownSizes: readonly ["sm", "md", "lg"];
@@ -1785,6 +1789,8 @@ declare type DataCollectionSourceDefinition<R extends RecordType = RecordType, F
     itemActions?: ItemActions;
     /** Available primary actions that can be performed on the collection */
     primaryActions?: PrimaryActionsDefinitionFn;
+    /** Label for the primary actions dropdown trigger button */
+    primaryActionsLabel?: string;
     /** Available secondary actions that can be performed on the collection */
     secondaryActions?: SecondaryActionsDefinition;
     /** Available summaries fields. If not provided, summaries is not allowed. */
@@ -2573,6 +2579,8 @@ export declare const defaultTranslations: {
             readonly deleteQuestion: "Delete question";
             readonly duplicateSection: "Duplicate section";
             readonly deleteSection: "Delete section";
+            readonly confirmMoveLastQuestion: "Move question";
+            readonly cancelMoveLastQuestion: "Cancel";
         };
         readonly questionTypes: {
             readonly section: "Section";
@@ -2584,6 +2592,7 @@ export declare const defaultTranslations: {
             readonly numeric: "Numeric";
             readonly link: "Link";
             readonly date: "Date";
+            readonly dropdownSingle: "Dropdown";
         };
         readonly selectQuestion: {
             readonly addOption: "Add option";
@@ -2610,6 +2619,8 @@ export declare const defaultTranslations: {
             readonly questionOptions: "Question options";
             readonly actions: "Actions";
             readonly sectionTitlePlaceholder: "Section title";
+            readonly lastQuestionDialogTitle: "Remove last question from section";
+            readonly lastQuestionDialogDescription: "Moving this question will leave the section empty and it will be removed. Do you want to continue?";
         };
     };
     readonly richTextEditor: {
@@ -3449,9 +3460,9 @@ export declare const F0Button: WithDataTestIdReturnType_3<ForwardRefExoticCompon
 variant?: Exclude<ButtonInternalProps["variant"], "ai">;
 } & RefAttributes<HTMLAnchorElement | HTMLButtonElement>>>;
 
-export declare const F0ButtonDropdown: WithDataTestIdReturnType_6<({ onClick, value, ...props }: F0ButtonDropdownProps) => JSX_2.Element | undefined>;
+export declare const F0ButtonDropdown: WithDataTestIdReturnType_6<(props: F0ButtonDropdownProps) => JSX_2.Element>;
 
-export declare type F0ButtonDropdownProps<T = string> = {
+declare type F0ButtonDropdownBaseProps<T = string> = {
     /**
      * The size of the button.
      * @default "md"
@@ -3466,10 +3477,6 @@ export declare type F0ButtonDropdownProps<T = string> = {
      * @default "default"
      */
     variant?: ButtonDropdownVariant;
-    /**
-     * The value of the button.
-     */
-    value?: T;
     /**
      * The disabled state of the button.
      * @default false
@@ -3485,8 +3492,51 @@ export declare type F0ButtonDropdownProps<T = string> = {
      * @default undefined
      */
     tooltip?: string;
+};
+
+/**
+ * Props for dropdown mode: a unified button with chevron that opens a dropdown
+ * showing all items (with optional descriptions and icons).
+ */
+declare type F0ButtonDropdownDropdownProps<T = string> = F0ButtonDropdownBaseProps<T> & {
+    /**
+     * The rendering mode.
+     * - "dropdown": Single button with chevron — clicking anywhere opens the dropdown with all items.
+     */
+    mode: "dropdown";
+    /**
+     * Optional trigger button label. Customize the label shown on the
+     * trigger button independently from the dropdown items.
+     * Falls back to the first item's label if not provided.
+     */
+    trigger?: string;
+    /**
+     * Called when a dropdown item is clicked.
+     * @param value The value of the item that was clicked.
+     * @param item The item that was clicked.
+     */
+    onClick: (value: T, item: ButtonDropdownItem<T>) => void;
+};
+
+export declare type F0ButtonDropdownProps<T = string> = F0ButtonDropdownSplitProps<T> | F0ButtonDropdownDropdownProps<T>;
+
+/**
+ * Props for split mode (default): a split button where the main button triggers the selected item,
+ * and a chevron reveals the remaining items.
+ */
+declare type F0ButtonDropdownSplitProps<T = string> = F0ButtonDropdownBaseProps<T> & {
+    /**
+     * The rendering mode.
+     * - "split": (default) Split button — main button triggers the selected item, chevron reveals others.
+     * @default "split"
+     */
+    mode?: "split";
     /**
-     * The callback function to be called when the button is clicked.
+     * The currently selected value. Defaults to the first item.
+     */
+    value?: T;
+    /**
+     * Called when the main button or a dropdown item is clicked.
      * @param value The value of the item that was clicked.
      * @param item The item that was clicked.
      */
@@ -5070,9 +5120,9 @@ export declare const F0TableOfContentPopover: WithDataTestIdReturnType_3<typeof
  * Internal implementation of the TableOfContentPopover component.
  * This component includes all props including private ones.
  */
-declare function F0TableOfContentPopover_2({ title, items, className, activeItem, collapsible, showChildrenCounter, barsAlign, size, variant, }: F0TableOfContentPopoverProps): JSX_2.Element;
+declare function F0TableOfContentPopover_2({ title, items, className, activeItem, collapsible, sortable, onReorder, showChildrenCounter, barsAlign, size, variant, }: F0TableOfContentPopoverProps): JSX_2.Element;
 
-declare interface F0TableOfContentPopoverProps extends Omit<TOCProps, "sortable" | "onReorder" | "showSearchBox" | "title" | "hideChildrenCounter"> {
+declare interface F0TableOfContentPopoverProps extends Omit<TOCProps, "showSearchBox" | "title" | "hideChildrenCounter"> {
     /** Optional title displayed at the top of the menu popup */
     title?: string;
     /** Alignment of the collapsed bars (left or right) */
@@ -6800,7 +6850,7 @@ declare type PrevNextDateNavigation = {
     next: DateRange | false;
 };
 
-declare type PrimaryActionItemDefinition = Pick<DropdownItemObject, "label" | "icon"> & {
+declare type PrimaryActionItemDefinition = Pick<DropdownItemObject, "label" | "icon" | "description"> & {
     loading?: boolean;
     onClick?: () => void | Promise<void>;
     disabled?: boolean;
@@ -7787,8 +7837,27 @@ declare type TOCItemAction = {
     label: string;
     onClick: () => void;
     icon?: IconType;
+    critical?: boolean;
+    /** Show a check icon to indicate this item is selected */
+    selected?: boolean;
 } | {
     type: "separator";
+} | {
+    type: "label";
+    text: string;
+} | {
+    type: "toggle";
+    label: string;
+    icon?: IconType;
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+} | {
+    type: "submenu";
+    label: string;
+    icon?: IconType;
+    /** Currently selected option label shown inline */
+    selectedLabel?: string;
+    children: TOCItemAction[];
 };
 
 declare interface TOCProps {