@factorialco/f0-react 1.294.0 → 1.296.0

package/dist/experimental.d.ts

@@ -110,6 +110,13 @@ declare type Action_2 = {
     variant?: "default" | "outline" | "promote";
 };
 
+export declare type ActionBarGroup = {
+    label?: string;
+    items: ActionBarItem[];
+};
+
+export declare type ActionBarItem = ActionType_2;
+
 declare type ActionBaseProps = ActionCommonProps & DataAttributes;
 
 declare type ActionButtonProps = ActionBaseProps & {
@@ -298,7 +305,14 @@ export declare type actionType = {
     icon?: IconType;
 };
 
-declare type ActionType_2 = CopyActionType | NavigateActionType | OpenLinkActionType;
+declare type ActionType_2 = {
+    label: string;
+    icon?: IconType;
+    onClick?: () => void;
+    disabled?: boolean;
+    critical?: boolean;
+    description?: string;
+};
 
 declare type actionType_2 = {
     label: string;
@@ -309,6 +323,8 @@ declare type actionType_2 = {
     variant?: "default" | "outline" | "neutral";
 };
 
+declare type ActionType_3 = CopyActionType | NavigateActionType | OpenLinkActionType;
+
 declare type ActionVariant = (typeof actionVariants)[number];
 
 declare const actionVariants: readonly ["default", "outline", "critical", "neutral", "ghost", "promote", "outlinePromote", "ai", "link", "unstyled", "mention"];
@@ -1567,7 +1583,7 @@ declare const CompanyItem: ForwardRefExoticComponent<CompanyItemProps & RefAttri
 declare type CompanyItemProps = {
     name: string;
     avatarUrl?: URL_2;
-    action?: ActionType_2;
+    action?: ActionType_3;
 };
 
 export declare function CompanySelector({ companies, selected, onChange, isLoading, withNotification, additionalOptions, }: CompanySelectorProps): JSX_2.Element;
@@ -1908,7 +1924,7 @@ export declare type DataSourceDefinition<R extends RecordType = RecordType, Filt
     /** Selectable items value under the checkbox column (undefined if not selectable) */
     selectable?: (item: R) => string | number | undefined;
     /** Default selected items */
-    defaultSelectedItems?: SelectedItemsState;
+    defaultSelectedItems?: SelectedItemsState<R>;
     /***** GROUPING ***************************************************/
     /** Grouping configuration */
     grouping?: Grouping;
@@ -2217,6 +2233,7 @@ declare const defaultTranslations: {
         readonly selected: {
             readonly singular: "Selected";
             readonly plural: "Selected";
+            readonly all: "All selected";
         };
     };
     readonly filters: {
@@ -2592,7 +2609,7 @@ declare type EmployeeItemProps = {
     firstName: string;
     lastName: string;
     avatarUrl?: URL_2;
-    action?: ActionType_2;
+    action?: ActionType_3;
 };
 
 declare type EmptyState = {
@@ -2733,6 +2750,27 @@ declare type ExtractVisualizationSettings<T> = T extends {
     };
 } ? S : never;
 
+export declare const F0ActionBar: ({ isOpen, secondaryActions, label, ...props }: F0ActionBarProps) => JSX_2.Element;
+
+declare interface F0ActionBarProps {
+    /**
+     * Whether the action bar is open
+     */
+    isOpen: boolean;
+    /**
+     * The primary action
+     */
+    primaryActions?: ActionBarItem[] | ActionBarGroup[] | ActionBarGroup;
+    /**
+     * The secondary actions
+     */
+    secondaryActions?: ActionBarItem[];
+    /**
+     * The label of the action bar
+     */
+    label?: string;
+}
+
 export declare const F0AiBanner: ForwardRefExoticComponent<AiBannerInternalProps & RefAttributes<HTMLDivElement>> & {
     Skeleton: ({ compact }: AiBannerSkeletonProps) => JSX_2.Element;
 };
@@ -2874,6 +2912,26 @@ declare interface F0IconProps extends SVGProps<SVGSVGElement>, VariantProps<type
     color?: "default" | "currentColor" | `#${string}` | Lowercase<NestedKeyOf<typeof f1Colors.icon>>;
 }
 
+/**
+ * Base props shared across all F0Select variants
+ */
+declare type F0SelectBaseProps<T extends string, R = unknown> = {
+    onChangeSelectedOption?: (option: F0SelectItemObject<T, ResolvedRecordType<R>> | undefined, checked: boolean) => void;
+    children?: React.ReactNode;
+    open?: boolean;
+    showSearchBox?: boolean;
+    searchBoxPlaceholder?: string;
+    onSearchChange?: (value: string) => void;
+    searchValue?: string;
+    onOpenChange?: (open: boolean) => void;
+    searchEmptyMessage?: string;
+    className?: string;
+    selectContentClassName?: string;
+    actions?: Action[];
+    /** Container element to render the portal content into */
+    portalContainer?: HTMLElement | null;
+};
+
 declare type F0SelectItemObject<T, R = unknown> = {
     type?: "item";
     value: T;
@@ -2897,42 +2955,43 @@ export { F0SelectItemProps as SelectItemProps }
 /**
  * Select component for choosing from a list of options.
  *
- * @template T - The type of the emitted  value
+ * @template T - The type of the emitted value
  * @template R - The type of the record/item data (used with data source)
- *
  */
-declare type F0SelectProps<T extends string, R = unknown> = {
-    onChangeSelectedOption?: (option: F0SelectItemObject<T, ResolvedRecordType<R>> | undefined, checked: boolean) => void;
-    children?: React.ReactNode;
-    open?: boolean;
-    showSearchBox?: boolean;
-    searchBoxPlaceholder?: string;
-    onSearchChange?: (value: string) => void;
-    searchValue?: string;
-    onOpenChange?: (open: boolean) => void;
-    searchEmptyMessage?: string;
-    className?: string;
-    selectContentClassName?: string;
-    actions?: Action[];
-    portalContainer?: HTMLElement | null;
-} & ({
+declare type F0SelectProps<T extends string, R = unknown> = F0SelectBaseProps<T, R> & // Single select not clearable
+({
     clearable?: false;
     multiple?: false;
     value?: T;
     defaultItem?: F0SelectItemObject<T, ResolvedRecordType<R>>;
     onChange?: (value: T, originalItem?: ResolvedRecordType<R> | undefined, option?: F0SelectItemObject<T, ResolvedRecordType<R>>) => void;
+    /** Callback for selection changes - provides full selection state for advanced use cases (e.g., "Select All" with exclusions) */
+    onSelectItems?: never;
 } | {
     clearable: true;
     multiple?: false;
     value?: T;
     defaultItem?: F0SelectItemObject<T, ResolvedRecordType<R>>;
     onChange?: (value: T, originalItem?: ResolvedRecordType<R> | undefined, option?: F0SelectItemObject<T, ResolvedRecordType<R>>) => void;
+    onSelectItems?: never;
 } | {
     multiple: true;
     clearable?: boolean;
     value?: T[];
     defaultItem?: F0SelectItemObject<T, ResolvedRecordType<R>>[];
     onChange?: (value: T[], originalItems: ResolvedRecordType<R>[], options: F0SelectItemObject<T, ResolvedRecordType<R>>[]) => void;
+    /**
+     * Callback for selection changes - provides full selection state including:
+     * - `status.allSelected`: true if "Select All" was used, "indeterminate" if some items deselected after Select All
+     * - `status.items`: Map of all items with their checked state
+     * - `filters`: Current applied filters
+     * - `selectedCount`: Total number of selected items
+     *
+     * Use this for "chunked" selection mode where you need to track:
+     * - When allSelected is true/indeterminate: excluded items are those with checked=false
+     * - When allSelected is false: included items are those with checked=true
+     */
+    onSelectItems?: OnSelectItemsCallback<ResolvedRecordType<R>, FiltersDefinition>;
 }) & ({
     source: DataSourceDefinition<ResolvedRecordType<R>, FiltersDefinition, SortingsDefinition, GroupingDefinition<ResolvedRecordType<R>>>;
     mapOptions: (item: ResolvedRecordType<R>) => F0SelectItemProps<T, ResolvedRecordType<R>>;
@@ -3618,7 +3677,7 @@ declare type ItemDefinition = {
 declare type ItemProps = {
     text: string;
     icon?: IconType;
-    action?: ActionType_2;
+    action?: ActionType_3;
 };
 
 declare type Items = typeof Item_2 | typeof PersonItem | typeof CompanyItem | typeof TeamItem;
@@ -5210,10 +5269,13 @@ export declare type SelectedItems<T> = ReadonlyArray<T>;
 
 export declare type SelectedItemsDetailedStatus<R extends RecordType, Filters extends FiltersDefinition> = {
     allSelected: boolean | "indeterminate";
+    /** Status of items that have been loaded. Items not yet loaded won't appear here. */
     itemsStatus: ReadonlyArray<{
         item: R;
         checked: boolean;
     }>;
+    /** All selected item IDs, including those not yet loaded */
+    selectedIds: ReadonlyArray<SelectionId>;
     groupsStatus: Record<string, boolean>;
     filters: FiltersState<Filters>;
     selectedCount: number;
@@ -5222,18 +5284,23 @@ export declare type SelectedItemsDetailedStatus<R extends RecordType, Filters ex
 /**
  * Represents the selected items by id
  */
-export declare type SelectedItemsState = {
-    allSelected?: boolean | "indeterminate";
-    items?: ReadonlyArray<{
-        id: string;
-        checked: boolean;
-    }>;
-    groups?: ReadonlyArray<{
-        groupId: string;
-        checked: boolean;
-    }>;
+export declare type SelectedItemsState<R extends RecordType> = {
+    allSelected: boolean | "indeterminate";
+    items: Map<SelectedItemState<R>["id"], SelectedItemState<R>>;
+    groups: Map<SelectedState["id"], SelectedState>;
+};
+
+export declare type SelectedItemState<R extends RecordType> = SelectedState & {
+    item?: WithGroupId<R>;
 };
 
+export declare type SelectedState = {
+    id: SelectionId;
+    checked: boolean;
+};
+
+export declare type SelectionId = number | string;
+
 export declare type SelectQuestionOption = {
     id?: string;
     value: string;
@@ -5689,7 +5756,7 @@ declare const TeamItem: ForwardRefExoticComponent<TeamItemProps & RefAttributes<
 
 declare type TeamItemProps = {
     name: string;
-    action?: ActionType_2;
+    action?: ActionType_3;
 };
 
 export declare const Textarea: React.FC<TextareaProps>;
@@ -6338,11 +6405,6 @@ declare module "@tiptap/core" {
 }
 
 
-declare namespace Calendar {
-    var displayName: string;
-}
-
-
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         moodTracker: {
@@ -6350,3 +6412,8 @@ declare module "@tiptap/core" {
         };
     }
 }
+
+
+declare namespace Calendar {
+    var displayName: string;
+}