@factorialco/f0-react 1.401.0 → 1.402.3

package/dist/f0.d.ts

@@ -48,6 +48,7 @@ import { F0AvatarListProps as F0AvatarListProps_2 } from './types';
 import { F0AvatarPersonProps as F0AvatarPersonProps_2 } from './types';
 import { F0AvatarTeamProps as F0AvatarTeamProps_2 } from './F0AvatarTeam';
 import { F0DialogInternalProps } from './internal-types';
+import { F0DurationInputProps as F0DurationInputProps_2 } from './types';
 import { F0FormDefinitionPerSection as F0FormDefinitionPerSection_2 } from './f0';
 import { F0FormDefinitionSingleSchema as F0FormDefinitionSingleSchema_2 } from './f0';
 import { F0GridStackProps as F0GridStackProps_2 } from './F0GridStack';
@@ -858,6 +859,33 @@ declare type BaseFilterDefinition<T extends FilterTypeKey> = {
     hideSelector?: boolean;
 };
 
+declare function BaseHeader({ title, avatar, deactivated, description, primaryAction, secondaryActions, otherActions, status, metadata, }: BaseHeaderProps_2): JSX_2.Element;
+
+declare type BaseHeaderProps = ComponentProps<typeof BaseHeader>;
+
+declare interface BaseHeaderProps_2 {
+    title: string;
+    deactivated?: boolean;
+    avatar?: {
+        type: "generic";
+        name: string;
+        src?: string;
+    } | AvatarVariant;
+    description?: string;
+    primaryAction?: PrimaryActionButton | PrimaryDropdownAction<string>;
+    secondaryActions?: HeaderSecondaryAction[];
+    otherActions?: (DropdownItem & {
+        isVisible?: boolean;
+    })[];
+    status?: {
+        label: string;
+        text: string;
+        variant: StatusVariant;
+        actions?: MetadataAction[];
+    };
+    metadata?: MetadataProps["items"];
+}
+
 /**
  * Represents a base structure for paginated API responses, providing
  * details about the records on the current page and pagination metadata.
@@ -2827,6 +2855,13 @@ export declare const defaultTranslations: {
             readonly expand: "Expand";
             readonly collapse: "Collapse";
         };
+        readonly labels: {
+            readonly empty: {
+                readonly title: "No questions to answer";
+                readonly description: "This survey has no questions yet.";
+                readonly emoji: "📝";
+            };
+        };
     };
     readonly richTextEditor: {
         readonly bold: "Bold";
@@ -3038,6 +3073,31 @@ export declare type DropIntent = {
     type: "cancel";
 };
 
+export declare interface DurationFieldConfig {
+    suffix?: string;
+    max?: number;
+    /**
+     * Maximum number of visible digits for this segment input.
+     * Defaults to 2 when omitted.
+     */
+    maxVisibleDigits?: number;
+    ariaLabel?: string;
+}
+
+declare type DurationFieldRenderIf = DurationRenderIfCondition | CommonRenderIfCondition | F0BaseFieldRenderIfFunction;
+
+export declare type DurationFields = Record<DurationUnit, number>;
+
+export declare type DurationInputSize = (typeof durationInputSizes)[number];
+
+export declare const durationInputSizes: readonly ["sm", "md"];
+
+declare type DurationRenderIfCondition = NumberRenderIfCondition;
+
+export declare type DurationUnit = (typeof durationUnits)[number];
+
+export declare const durationUnits: readonly ["days", "hours", "minutes", "seconds"];
+
 /** The edit mode for a column cell in the editable table. */
 declare type EditableTableCellEditType = "text" | "date" | "select" | "multiselect" | "display-only" | "disabled";
 
@@ -3608,6 +3668,8 @@ export declare interface F0BaseConfig {
     placeholder?: string;
     /** Helper text displayed below the field */
     helpText?: string;
+    /** Optional non-validation field status (warning/info/error/default) */
+    status?: InputFieldStatus;
     /**
      * Whether the field is disabled.
      * Can be a boolean or a function that receives form values.
@@ -3652,6 +3714,8 @@ export declare interface F0BaseField {
     validation?: ZodTypeAny;
     /** Helper text displayed below the field */
     helpText?: string;
+    /** Optional non-validation field status (warning/info/error/default) */
+    status?: InputFieldStatus;
     /** Placeholder text for the input */
     placeholder?: string;
     /**
@@ -4467,12 +4531,57 @@ export declare type F0DropdownButtonProps<T = string> = {
     onClick: (value: T, item: ButtonDropdownItem<T>) => void;
 };
 
+declare interface F0DurationConfig {
+    units?: DurationUnit[];
+    fields?: Partial<Record<DurationUnit, DurationFieldConfig>>;
+    readonly?: boolean;
+    size?: DurationInputSize;
+}
+
+declare type F0DurationField = F0BaseField & F0DurationConfig & {
+    type: "duration";
+    /** Conditional rendering based on another field's value */
+    renderIf?: DurationFieldRenderIf;
+};
+
+/**
+ * Config for duration fields (stores total seconds as number)
+ */
+declare type F0DurationFieldConfig = F0BaseConfig & {
+    fieldType: "duration";
+    units?: DurationUnit[];
+    fields?: Partial<Record<DurationUnit, DurationFieldConfig>>;
+    readonly?: boolean;
+    size?: DurationInputSize;
+};
+
+export declare const F0DurationInput: WithDataTestIdReturnType_3<ForwardRefExoticComponent<Omit<F0DurationInputProps_2 & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
+
+export declare interface F0DurationInputProps {
+    id?: string;
+    "aria-describedby"?: string;
+    "aria-invalid"?: AriaAttributes["aria-invalid"];
+    label: string;
+    ariaLabel?: string;
+    hideLabel?: boolean;
+    value: number;
+    onChange: (seconds: number) => void;
+    onBlur?: () => void;
+    units?: DurationUnit[];
+    fields?: Partial<Record<DurationUnit, DurationFieldConfig>>;
+    status?: InputFieldStatus;
+    disabled?: boolean;
+    required?: boolean;
+    readonly?: boolean;
+    size?: DurationInputSize;
+}
+
 export declare function F0EventCatcherProvider({ children, onEvent, enabled, catchEvents, }: EventCatcherProviderProps): JSX.Element;
 
 /**
  * Union of all F0 field types used for rendering
  */
-export declare type F0Field = F0TextField | F0NumberField | F0TextareaField | F0SelectField | F0CheckboxField | F0SwitchField | F0DateField | F0TimeField | F0DateTimeField | F0DateRangeField | F0RichTextField | F0FileField | F0CustomField;
+export declare type F0Field = F0TextField | F0NumberField | F0DurationField | F0TextareaField | F0SelectField | F0CheckboxField | F0SwitchField | F0DateField | F0TimeField | F0DateTimeField | F0DateRangeField | F0RichTextField | F0FileField | F0CustomField;
 
 /**
  * Complete F0 field configuration (union of all possible configs)
@@ -4484,7 +4593,7 @@ export declare type F0FieldConfig<T extends string | number = string | number, R
 /**
  * Field types for rendering
  */
-export declare type F0FieldType = "text" | "number" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "file" | "custom";
+export declare type F0FieldType = "text" | "number" | "duration" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "file" | "custom";
 
 /**
  * F0 config options specific to file fields
@@ -4673,10 +4782,10 @@ export declare type F0FormErrorTriggerMode = "on-blur" | "on-change" | "on-submi
  * without requiring a react-hook-form context.
  *
  * Supports all field types that F0Form supports: text, number, textarea,
- * select, checkbox, switch, date, time, datetime, daterange, richtext, custom,
+ * duration, select, checkbox, switch, date, time, datetime, daterange, richtext, custom,
  * and file.
  */
-export declare function F0FormField({ field, value, onChange, onBlur, error, errorMessage, loading, required, disabled, hideLabel: hideLabelProp, initialFiles, }: F0FormFieldProps): JSX_2.Element;
+export declare function F0FormField({ field, value, onChange, onBlur, error, errorMessage, status, loading, required, disabled, hideLabel: hideLabelProp, initialFiles, }: F0FormFieldProps): JSX_2.Element;
 
 export declare namespace F0FormField {
     var displayName: string;
@@ -4689,7 +4798,7 @@ export declare namespace F0FormField {
 export declare function f0FormField<T extends z.ZodString, TConfig = undefined, R extends Record<string, unknown> = Record<string, unknown>>(schema: T, config: F0StringConfig<z.infer<T>, TConfig, R>): T & F0ZodType<T>;
 
 /**
- * Number field - number input or select
+ * Number field - number input, duration, or select
  * @typeParam R - Record type for data source (when using source instead of options)
  */
 export declare function f0FormField<T extends z.ZodNumber, R extends Record<string, unknown> = Record<string, unknown>>(schema: T, config: F0NumberFieldConfig<R>): T & F0ZodType<T>;
@@ -4769,6 +4878,8 @@ declare interface F0FormFieldCommonProps {
     error?: boolean;
     /** Error message to display */
     errorMessage?: string;
+    /** Field status for warning/info/error/default messages */
+    status?: InputFieldStatus;
     /** Whether the field is in a loading/validating state */
     loading?: boolean;
     /** Whether the field is required */
@@ -5131,7 +5242,7 @@ export declare type F0NumberField = F0BaseField & F0NumberConfig & {
  * Config for number fields
  * @typeParam R - Record type for data source (when using source instead of options)
  */
-export declare type F0NumberFieldConfig<R extends Record<string, unknown> = Record<string, unknown>> = F0NumberInputConfig | F0NumberSelectConfig<R>;
+export declare type F0NumberFieldConfig<R extends Record<string, unknown> = Record<string, unknown>> = F0NumberInputConfig | F0NumberSelectConfig<R> | F0DurationFieldConfig;
 
 /**
  * Config for number fields - number input
@@ -5311,6 +5422,8 @@ export declare interface F0SectionConfig {
     title: string;
     /** Section description */
     description?: string;
+    /** Applies default horizontal inset to the section header (title/subtitle/action row) */
+    withInset?: boolean;
     /** Conditional rendering for the entire section */
     renderIf?: SectionRenderIf;
     /** Optional action button for the section */
@@ -5861,10 +5974,12 @@ export declare interface F0ZodType<T extends ZodTypeAny = ZodTypeAny> {
 
 /* Excluded from this release type: FieldItem */
 
+export declare function fieldsToSeconds(fields: DurationFields): number;
+
 /**
  * Field types for rendering
  */
-export declare type FieldType = "text" | "number" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "file" | "custom";
+export declare type FieldType = "text" | "number" | "duration" | "textarea" | "select" | "checkbox" | "switch" | "date" | "time" | "datetime" | "daterange" | "richtext" | "file" | "custom";
 
 export declare type FileAvatarVariant = Extract<AvatarVariant, {
     type: "file";
@@ -6391,6 +6506,10 @@ export declare function H3({ children, ...props }: React.HTMLAttributes<HTMLHead
  */
 export declare function hasF0Config(schema: ZodTypeAny): boolean;
 
+declare type HeaderSecondaryAction = SecondaryAction & {
+    hideLabel?: boolean;
+};
+
 declare type HeadingTags = (typeof headingTags)[number];
 
 declare const headingTags: readonly ["h1", "h2", "h3", "h4", "h5", "h6"];
@@ -6675,7 +6794,7 @@ declare type InputFieldSize = (typeof INPUTFIELD_SIZES)[number];
 
 declare type InputFieldStatus = {
     type: Exclude<InputFieldStatusType, "error">;
-    message: string;
+    message?: string;
 } | {
     type: "error";
     message?: string;
@@ -6928,6 +7047,90 @@ declare type MentionsConfig = {
     users: MentionedUser[];
 };
 
+declare type MetadataAction = {
+    icon: IconType;
+    label: string;
+    onClick: () => void;
+    type?: never;
+};
+
+declare type MetadataCopyAction = {
+    icon?: never;
+    label?: never;
+    onClick?: never;
+    copyValue?: string;
+    type: "copy";
+};
+
+declare function MetadataItem({ item }: {
+    item: MetadataItem;
+}): JSX_2.Element;
+
+declare interface MetadataItem {
+    label: string;
+    value: MetadataItemValue;
+    actions?: (MetadataAction | MetadataCopyAction)[];
+    hideLabel?: boolean;
+    /**
+     * Optional info text. When provided, displays an info icon next to the label
+     * that shows this text in a tooltip when hovered.
+     */
+    info?: {
+        title: string;
+        description?: string;
+    };
+}
+
+declare type MetadataItemValue = {
+    type: "text";
+    content: string;
+} | {
+    type: "avatar";
+    variant: AvatarVariant;
+    text: string;
+} | {
+    type: "status";
+    label: string;
+    variant: StatusVariant;
+} | ({
+    type: "list";
+} & ({
+    variant: "person";
+    avatars: (PersonAvatarVariant | (PersonAvatarVariant & Record<string, unknown>))[];
+} | {
+    variant: "team";
+    avatars: (TeamAvatarVariant | (TeamAvatarVariant & Record<string, unknown>))[];
+} | {
+    variant: "company";
+    avatars: (CompanyAvatarVariant | (CompanyAvatarVariant & Record<string, unknown>))[];
+})) | {
+    type: "data-list";
+    data: string[];
+} | {
+    type: "tag-list";
+    tags: string[];
+} | {
+    type: "dot-tag";
+    label: string;
+    color: NewColor;
+} | {
+    type: "date";
+    formattedDate: string;
+    icon?: "warning" | "critical";
+};
+
+declare interface MetadataProps {
+    /**
+     * Everything is not a MetadataItem is ignored.
+     * Undefined and boolean enable conditional items
+     **/
+    items: (MetadataItem | undefined | boolean)[];
+    /**
+     * If true and the metadata type is a list, it will be collapsed to the first item
+     */
+    collapse?: boolean;
+}
+
 /** How to format the metric value */
 export declare type MetricFormat = {
     type: "number";
@@ -7576,6 +7779,18 @@ declare type PrevNextDateNavigation = {
     next: DateRange | false;
 };
 
+declare interface PrimaryAction {
+    disabled?: boolean;
+    tooltip?: string;
+    isVisible?: boolean;
+}
+
+declare interface PrimaryActionButton extends PrimaryAction {
+    label: string;
+    icon?: IconType;
+    onClick: () => void;
+}
+
 declare type PrimaryActionItemDefinition = Pick<DropdownItemObject, "label" | "icon" | "description"> & {
     loading?: boolean;
     onClick?: () => void | Promise<void>;
@@ -7588,6 +7803,12 @@ declare type PrimaryActionItemDefinition = Pick<DropdownItemObject, "label" | "i
  */
 declare type PrimaryActionsDefinitionFn = () => PrimaryActionItemDefinition | PrimaryActionItemDefinition[] | undefined;
 
+declare interface PrimaryDropdownAction<T> extends PrimaryAction {
+    items: ButtonDropdownItem<T>[];
+    value?: T;
+    onClick: (value: T, item: ButtonDropdownItem<T>) => void;
+}
+
 export declare const PrivacyModeProvider: React_2.FC<{
     initiallyEnabled?: boolean;
     children: ReactNode;
@@ -7795,6 +8016,8 @@ declare type Props_3 = {
     list?: TagCounterItem[];
 };
 
+declare type Props_4 = {} & Pick<BaseHeaderProps, "avatar" | "title" | "description" | "primaryAction" | "secondaryActions" | "otherActions" | "metadata" | "status" | "deactivated">;
+
 export declare type QuestionActionParams = {
     questionId: string;
     type: ActionType;
@@ -7895,6 +8118,8 @@ export declare type RenderIfCondition = CommonRenderIfCondition | TextRenderIfCo
 
 export declare type ResolvedRecordType<R> = R extends RecordType ? R : RecordType;
 
+declare type ResourceHeaderProps = Props_4;
+
 /** All styling props that can be overridden per breakpoint */
 export declare interface ResponsiveStyleProps {
     display?: DisplayToken;
@@ -7985,6 +8210,10 @@ declare type SearchOptions = {
     debounceTime?: number;
 };
 
+declare interface SecondaryAction extends PrimaryActionButton {
+    variant?: "outline" | "critical" | "outlinePromote" | "promote";
+}
+
 declare type SecondaryActionGroup = {
     label?: string;
     items: SecondaryActionItem[];
@@ -8009,6 +8238,10 @@ declare type SecondaryActionsDefinition = {
 
 declare type SecondaryActionsItems = SecondaryActionItem[] | SecondaryActionItem[][] | SecondaryActionGroup[];
 
+export declare function secondsToFields(totalSeconds: number): DurationFields;
+
+export declare function secondsToVisibleFields(totalSeconds: number, visibleUnits: DurationUnit[]): DurationFields;
+
 export declare type SectionActionParams = {
     sectionId: string;
     type: ActionType;
@@ -8243,23 +8476,51 @@ declare type SummaryKey<Definition extends SummariesDefinition> = Definition ext
 
 declare type SummaryType = "sum";
 
-export declare function SurveyAnsweringForm({ elements, onSubmit, mode, title, isOpen, onClose, fullscreen: fullscreenProp, allowToChangeFullscreen, defaultValues, errorTriggerMode, }: SurveyAnsweringFormProps): JSX_2.Element;
-
-export declare type SurveyAnsweringFormMode = "stepped" | "all-questions";
+export declare function SurveyAnsweringForm({ elements, onSubmit: onSubmitProp, mode, title, description, resourceHeader, isOpen, onClose, position: positionProp, module, allowToChangeFullscreen, defaultValues, errorTriggerMode, loading, labels, preview, }: SurveyAnsweringFormProps): JSX_2.Element;
 
-export declare interface SurveyAnsweringFormProps {
+declare interface SurveyAnsweringFormBaseProps {
     elements: SurveyFormBuilderElement[];
-    onSubmit: (answers: SurveySubmitAnswers) => Promise<SurveyFormSubmitResult> | SurveyFormSubmitResult;
     mode: SurveyAnsweringFormMode;
     title: string;
+    description?: string;
+    resourceHeader?: Omit<ResourceHeaderProps, "title" | "description">;
+    module: SurveyAnsweringFormModule;
+    position?: DialogPosition;
     isOpen: boolean;
     onClose: () => void;
-    fullscreen?: boolean;
     allowToChangeFullscreen?: boolean;
     defaultValues?: Partial<SurveyAnswers>;
     errorTriggerMode?: F0FormErrorTriggerMode;
+    loading?: boolean;
+    labels?: {
+        empty?: {
+            title?: string;
+            description?: string;
+            emoji?: string;
+        };
+    };
 }
 
+declare type SurveyAnsweringFormDefaultProps = SurveyAnsweringFormBaseProps & {
+    preview?: false;
+    onSubmit: (answers: SurveySubmitAnswers) => Promise<SurveyFormSubmitResult> | SurveyFormSubmitResult;
+};
+
+export declare type SurveyAnsweringFormMode = "stepped" | "all-questions";
+
+declare type SurveyAnsweringFormModule = {
+    id: ModuleId;
+    label: string;
+    href: string;
+};
+
+declare type SurveyAnsweringFormPreviewProps = SurveyAnsweringFormBaseProps & {
+    preview: true;
+    onSubmit?: never;
+};
+
+export declare type SurveyAnsweringFormProps = SurveyAnsweringFormDefaultProps | SurveyAnsweringFormPreviewProps;
+
 export declare type SurveyAnswers = Record<string, SurveyAnswerValue>;
 
 export declare type SurveyAnswerValue = {