@factorialco/f0-react 2.8.2 → 2.14.1

package/dist/f0.d.ts

@@ -1531,6 +1531,7 @@ declare type BaseQuestionProps = {
     children: React.ReactNode;
     required?: boolean;
     locked?: boolean;
+    hiddenActions?: HiddenActions;
 };
 
 declare type BaseQuestionPropsForOtherQuestionComponents = Omit<BaseQuestionProps, "children" | "onChange">;
@@ -2001,6 +2002,48 @@ export declare type CanvasEntityDefinition<T extends CanvasContentBase = CanvasC
     overflowHidden?: boolean;
 };
 
+declare interface CardAlertBase {
+    /**
+     * The visual variant of the alert, which determines the color scheme and default icon.
+     */
+    variant: CardAlertVariant;
+    /**
+     * The title text displayed in the alert banner.
+     */
+    title: string;
+    /**
+     * Optional custom icon. When omitted, defaults to the icon that best represents the variant.
+     */
+    icon?: IconType;
+    /**
+     * Controls whether the alert is visible. Defaults to true.
+     * Use this together with onDismiss for controlled dismiss behaviour:
+     *   alert={{ ..., visible, dismissible: true, onDismiss: () => setVisible(false) }}
+     */
+    visible?: boolean;
+}
+
+declare type CardAlertDismissible = CardAlertBase & {
+    /** Renders a dismiss (×) button. Requires onDismiss. */
+    dismissible: true;
+    /**
+     * Called when the dismiss (×) button is clicked.
+     * The consumer is responsible for hiding the alert (e.g. by setting visible: false).
+     */
+    onDismiss: () => void;
+};
+
+declare type CardAlertNonDismissible = CardAlertBase & {
+    dismissible?: false;
+    onDismiss?: never;
+};
+
+export declare type CardAlertProps = CardAlertDismissible | CardAlertNonDismissible;
+
+export declare type CardAlertVariant = (typeof cardAlertVariants)[number];
+
+export declare const cardAlertVariants: readonly ["info", "warning", "critical", "positive"];
+
 declare type CardAvatarVariant = AvatarVariant | {
     type: "emoji";
     emoji: string;
@@ -2125,6 +2168,12 @@ declare interface CardInternalProps {
      * can manage drag-and-drop while still allowing click navigation via onClick
      */
     disableOverlayLink?: boolean;
+    /**
+     * Alert banner displayed above the card with a coloured header strip and matching border.
+     * Supports info, warning, critical, and positive variants with a default icon per variant.
+     * Use `visible` + `onDismiss` for controlled dismiss behaviour.
+     */
+    alert?: CardAlertProps;
 }
 
 declare type CardInternalProps_2 = F0AiInsightCardProps & {
@@ -2445,6 +2494,12 @@ declare interface ChatDashboardColumn {
     label: string;
     /** Optional fixed width in pixels */
     width?: number;
+    /**
+     * Optional header tooltip explaining what the column represents — formula
+     * or aggregation if derived, source if direct. Forwarded to the underlying
+     * table column's `info` prop. Omit when the label is self-explanatory.
+     */
+    info?: string;
 }
 
 /**
@@ -4582,6 +4637,9 @@ export declare const defaultTranslations: {
         readonly noResults: "No results found";
         readonly loadingMore: "Loading...";
         readonly applySelection: "Apply selection";
+        readonly create: "Create";
+        readonly createWithValue: "Create \"{{value}}\"";
+        readonly createEmptyMessage: "Try another search or create a new item";
     };
     readonly numberInput: {
         readonly between: "It should be between {{min}} and {{max}}";
@@ -4657,6 +4715,7 @@ export declare const defaultTranslations: {
             readonly sectionDescriptionPlaceholder: "Describe the section in a few words";
             readonly required: "Required";
             readonly allowMultiSelection: "Allow multi-selection";
+            readonly allowCreate: "Allow creation";
             readonly singleSelection: "Single selection";
             readonly multiSelection: "Multi selection";
             readonly questionType: "Question type";
@@ -4962,6 +5021,7 @@ declare type DropdownSingleQuestionProps = BaseQuestionPropsForOtherQuestionComp
     value?: string | null;
     showSearchBox?: boolean;
     searchBoxPlaceholder?: string;
+    allowCreate?: boolean;
 };
 
 export declare type DropIntent = {
@@ -7488,9 +7548,9 @@ export declare interface F0FormDiscardConfig {
 
 /**
  * When to trigger and display validation errors (does not apply with autosubmit)
- * - "on-blur": Errors appear when the user leaves a field (default)
+ * - "on-blur": Errors appear when the user leaves a field
  * - "on-change": Errors appear as the user types (real-time validation)
- * - "on-submit": Errors only appear after attempting to submit the form
+ * - "on-submit": Errors only appear after attempting to submit the form (default)
  */
 export declare type F0FormErrorTriggerMode = "on-blur" | "on-change" | "on-submit";
 
@@ -8138,12 +8198,10 @@ declare interface F0FormSubmitConfigBase {
     /** Custom label for the submit button */
     label?: string;
     /**
-     * Custom icon for the submit button
-     * - undefined: uses default Save icon
-     * - null: no icon shown
-     * - IconType: custom icon
+     * Custom icon for the submit button.
+     * No icon is shown by default.
      */
-    icon?: IconType | null;
+    icon?: IconType;
     /** Label shown in the action bar while submitting (defaults to i18n "forms.actionBar.saving") */
     savingMessage?: string;
     /**
@@ -8510,12 +8568,10 @@ export declare interface F0PerSectionSubmitConfig {
     /** Custom label for the submit button (per section) */
     label?: string;
     /**
-     * Custom icon for the submit button
-     * - undefined: uses default Save icon
-     * - null: no icon shown
-     * - IconType: custom icon
+     * Custom icon for the submit button.
+     * No icon is shown by default.
      */
-    icon?: IconType | null;
+    icon?: IconType;
     /**
      * When true, the submit button is only visible once the section has unsaved changes.
      * @default false
@@ -8731,6 +8787,7 @@ export declare const F0Select: <T extends string = string, R = unknown>(props: F
  * Base props shared across all F0Select variants
  */
 declare type F0SelectBaseProps<T extends string, R = unknown> = {
+    onApply?: () => void;
     onChangeSelectedOption?: (option: F0SelectItemObject<T, ResolvedRecordType<R>> | undefined, checked: boolean) => void;
     children?: React.ReactNode;
     open?: boolean;
@@ -8742,6 +8799,8 @@ declare type F0SelectBaseProps<T extends string, R = unknown> = {
     searchEmptyMessage?: string;
     className?: string;
     actions?: Action_2[];
+    /** Callback to create a new item from the current search text. When provided, a "+ Create" button is shown in the empty state of the dropdown. */
+    onCreate?: (value: string) => Promise<void> | void;
     /** Container element to render the portal content into */
     portalContainer?: HTMLElement | null;
     /**
@@ -8793,6 +8852,8 @@ declare interface F0SelectConfigBase {
     searchBoxPlaceholder?: string;
     /** Icon displayed on the left side of the select input */
     icon?: IconType;
+    /** Callback to create a new item from the search text. Shows a "+ Create" button in the empty state of the dropdown. */
+    onCreate?: (value: string) => Promise<void> | void;
 }
 
 /**
@@ -8923,6 +8984,10 @@ export declare type F0SelectTagProp = string | {
     type: "person";
     name: string;
     src?: string;
+} | {
+    type: "icon";
+    text: string;
+    icon: IconType;
 };
 
 /**
@@ -10157,6 +10222,19 @@ declare interface HeatmapComputation {
 
 export declare type heightType = "xxs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "full" | "auto";
 
+/**
+ * Per-question control to hide individual entries from the question
+ * actions menu (the "⋯" dropdown). Useful when a consumer wants to
+ * lock down a subset of question editing without disabling the whole
+ * question.
+ *
+ * When every available action is hidden, the actions menu trigger is
+ * not rendered at all.
+ */
+export declare type HiddenAction = "required" | "multiSelect" | "allowCreate" | "questionType" | "duplicate" | "delete";
+
+export declare type HiddenActions = ReadonlyArray<HiddenAction>;
+
 export declare const HomeLayout: WithDataTestIdReturnType_2<ForwardRefExoticComponent<Omit<{
 widgets?: ReactNode[];
 children?: ReactNode;
@@ -11371,6 +11449,7 @@ declare type OnChangeQuestionParams = BaseQuestionOnChangeParams & ({
     datasetKey?: string;
     showSearchBox?: boolean;
     searchBoxPlaceholder?: string;
+    allowCreate?: boolean;
 } | {
     type: "dropdown-multi";
     value?: string[] | null;
@@ -12898,7 +12977,8 @@ export declare type SurveyDataset = {
     icon?: IconType;
     placeholder?: string;
     dataSource: DataSourceDefinition;
-    mapOptions: (item: RecordType) => F0SelectItemProps<string, RecordType>;
+    mapOptions: (item: RecordType) => F0SelectItemObject<string, RecordType>;
+    onCreate?: (value: string) => Promise<RecordType>;
 };
 
 export declare type SurveyDatasets = Record<string, SurveyDataset>;