@factorialco/f0-react 1.288.0 → 1.290.0

package/dist/experimental.d.ts

@@ -55,7 +55,6 @@ import { LongTextCellValue } from './types/longText';
 import { NumberCellValue } from './types/number';
 import { NumberCellValue as NumberCellValue_2 } from '../../value-display/types/number';
 import { NumberFilterOptions } from './NumberFilter/NumberFilter';
-import { NumberFilterValue } from './NumberFilter/NumberFilter';
 import { Observable } from 'zen-observable-ts';
 import { Path } from 'react-hook-form';
 import { PercentageCellValue } from './types/percentage';
@@ -71,6 +70,7 @@ import * as RechartsPrimitive from 'recharts';
 import { RefAttributes } from 'react';
 import { RefObject } from 'react';
 import { ScrollAreaProps } from '@radix-ui/react-scroll-area';
+import { SearchFilterOptions } from './SearchFilter/SearchFilter';
 import { StatusCellValue } from './types/status';
 import { StatusCellValue as StatusCellValue_2 } from '../../value-display/types/status';
 import { SVGProps } from 'react';
@@ -650,6 +650,22 @@ declare type AvatarVariant = DistributiveOmit<({
     type: "icon";
 } & F0AvatarIconProps), "size">;
 
+declare type AvatarVariant_2 = ({
+    type: "person";
+} & Omit<F0AvatarPersonProps, "size">) | ({
+    type: "team";
+} & Omit<F0AvatarTeamProps, "size">) | ({
+    type: "company";
+} & Omit<F0AvatarCompanyProps, "size">) | ({
+    type: "file";
+} & Omit<F0AvatarFileProps, "size">) | ({
+    type: "flag";
+} & Omit<F0AvatarFlagProps, "size">) | ({
+    type: "emoji";
+} & Omit<F0AvatarEmojiProps, "size">) | ({
+    type: "icon";
+} & Omit<F0AvatarIconProps, "size">);
+
 export declare const Badge: ({ type, size, icon }: BadgeProps) => JSX_2.Element;
 
 export declare interface BadgeProps extends VariantProps<typeof badgeVariants> {
@@ -1337,7 +1353,22 @@ export declare const ChartWidgetEmptyState: ForwardRefExoticComponent<Props_5 &
 
 export declare type ChatWidgetEmptyStateProps = Props_5;
 
-declare type ChildrenResponse<R extends RecordType> = BaseResponse<R> | R[] | NestedResponseWithType<R>;
+declare type ChildrenPaginationInfo<R extends RecordType> = Omit<InfiniteScrollPaginatedResponse<R>, "type" | "records">;
+
+declare type ChildrenResponse<R extends RecordType> = NestedResponseWithType<R>;
+
+declare type ChipLabel = {
+    label: string;
+} & ({
+    icon: IconType;
+    avatar?: never;
+} | {
+    icon?: never;
+    avatar: AvatarVariant_2;
+} | {
+    icon?: never;
+    avatar?: never;
+});
 
 export declare function ClockInControls({ trackedMinutes, remainingMinutes, data, labels, locationId, locations, canShowLocation, locationSelectorDisabled, onClockIn, onClockOut, onBreak, breakTypes, onChangeBreakTypeId, canShowBreakButton, canSeeGraph, canSeeRemainingTime, onChangeLocationId, canShowProject, projectSelectorElement, breakTypeName, }: ClockInControlsProps): JSX_2.Element;
 
@@ -1876,11 +1907,11 @@ export declare type DataSourceDefinition<R extends RecordType = RecordType, Filt
     currentGrouping?: GroupingState<R, Grouping>;
     /*******************************************************/
     /***** NESTED RECORDS ***************************************************/
-    fetchChildren?: (item: R, filters?: FiltersState<FiltersDefinition>) => Promise<ChildrenResponse<R>>;
+    fetchChildren?: (item: R, filters?: FiltersState<FiltersDefinition>, pagination?: ChildrenPaginationInfo<R>) => Promise<ChildrenResponse<R>>;
     /** Function to determine if an item has children */
     itemsWithChildren?: (item: R) => boolean;
     /** Function to get the number of children for an item */
-    childrenCount?: (item: R) => number | undefined;
+    childrenCount?: (item: R, pagination?: ChildrenPaginationInfo<R>) => number | undefined;
 };
 
 export declare type DateFilterDefinition = BaseFilterDefinition<"date"> & {
@@ -2181,12 +2212,20 @@ declare const defaultTranslations: {
             readonly equal: "Equal to";
             readonly equalTo: "Equal to {{value}}";
             readonly lessOrEqual: "Less or equal to";
+            readonly lessThan: "Less than";
             readonly greaterOrEqual: "Greater or equal to";
+            readonly greaterThan: "Greater than";
             readonly equalShort: "= {{value}}";
             readonly greaterThanOrEqualShort: ">= {{value}}";
+            readonly greaterThanShort: "> {{value}}";
             readonly lessThanOrEqualShort: "<= {{value}}";
+            readonly lessThanShort: "< {{value}}";
             readonly rangeTitle: "Use range";
-            readonly range: "Between {{min}} and {{max}}";
+            readonly range: "{{minStrict}} {{min}} and {{maxStrict}} {{max}}";
+        };
+        readonly search: {
+            readonly relaxed: "Relaxed";
+            readonly strict: "Strict";
         };
         readonly selectAll: "Select all";
         readonly clear: "Clear";
@@ -2509,7 +2548,7 @@ declare const DropdownMenuItem: React_2.ForwardRefExoticComponent<Omit<DropdownM
     inset?: boolean;
 } & React_2.RefAttributes<HTMLDivElement>>;
 
-declare type DropdownProps = Omit<DropdownInternalProps, (typeof privateProps_2)[number]> & {
+declare type DropdownProps = Omit<DropdownInternalProps, (typeof privateProps_4)[number]> & {
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
 };
@@ -2945,12 +2984,12 @@ declare type FilterTypeContext<Options extends object = never> = {
     i18n: I18nContextType;
 };
 
-declare type FilterTypeDefinition<Value = unknown, Options extends object = never, EmptyValue = Value> = {
-    /** Check if the value is empty */
+declare type FilterTypeDefinition<Value = unknown, Options extends object = never, EmptyValue = Value, OptionalOptions extends boolean = false> = {
     emptyValue: EmptyValue;
+    /** Check if the value is empty */
     isEmpty: (value: Value | undefined, context: FilterTypeContext<Options>) => boolean;
     /** Render the filter form */
-    render: <Schema extends FilterTypeSchema<Options>>(props: {
+    render: <Schema extends FilterTypeSchema<Options, OptionalOptions>>(props: {
         schema: Schema;
         value: Value;
         onChange: (value: Value) => void;
@@ -2959,7 +2998,7 @@ declare type FilterTypeDefinition<Value = unknown, Options extends object = neve
     /**
      * The value label to display in the filter chips
      */
-    chipLabel: (value: Value, context: FilterTypeContext<Options>) => string | Promise<string>;
+    chipLabel: (value: Value, context: FilterTypeContext<Options>) => string | ChipLabel | Promise<string | ChipLabel>;
     /**
      * The default options to render a filter of this type, for example max and min date for a date filter, the list of options for an in filter, etc
      */
@@ -2974,14 +3013,27 @@ declare type FilterTypeKey = keyof typeof filterTypes;
 
 declare const filterTypes: {
     readonly in: FilterTypeDefinition<string[], InFilterOptions<string>>;
-    readonly search: FilterTypeDefinition<string>;
+    readonly search: FilterTypeDefinition<string | {
+        value: string;
+        strict: boolean;
+    }, SearchFilterOptions, string | {
+        value: string;
+        strict: boolean;
+    }, true>;
     readonly date: FilterTypeDefinition<Date | DateRange | undefined, DateFilterOptions>;
     readonly number: FilterTypeDefinition<NumberFilterValue, NumberFilterOptions>;
 };
 
-declare type FilterTypeSchema<Options extends object = never> = {
-    options: Options extends never ? never : Options;
+declare type FilterTypeSchema<Options extends object = never, OptionalOptions extends boolean = false> = OptionalOptions extends true ? FilterTypeSchemaOptionalOptions<Options> : FilterTypeSchemaRequiredOptions<Options>;
+
+declare type FilterTypeSchemaOptionalOptions<Options extends object = never> = {
+    label: string;
+    options?: Options extends never ? never : Options;
+};
+
+declare type FilterTypeSchemaRequiredOptions<Options extends object = never> = {
     label: string;
+    options: Options extends never ? never : Options;
 };
 
 /**
@@ -2992,7 +3044,7 @@ declare type FilterTypeSchema<Options extends object = never> = {
  * This type is used to ensure type safety when working with filter values.
  * @template T - The filter definition type
  */
-export declare type FilterValue<T extends FilterDefinition> = T extends InFilterDefinition<infer U> ? U[] : T extends SearchFilterDefinition ? string : T extends DateFilterDefinition ? DateRange | Date | undefined : T extends NumberFilterDefinition ? [number | undefined, number | undefined] | undefined : never;
+export declare type FilterValue<T extends FilterDefinition> = T extends InFilterDefinition<infer U> ? U[] : T extends SearchFilterDefinition ? string : T extends DateFilterDefinition ? DateRange | Date | undefined : T extends NumberFilterDefinition ? NumberFilterValue | undefined : never;
 
 /**
  * Extracts the value type for a specific filter key from a FiltersDefinition.
@@ -3339,9 +3391,9 @@ export declare type InfiniteScrollPaginatedResponse<TRecord> = BasePaginatedResp
     hasMore: boolean;
 };
 
-export declare const Input: <T extends string = string>({ type, ...props }: InputProps<T>) => JSX_2.Element;
+export declare const Input: <T extends string>(props: InputProps<T>) => JSX_2.Element;
 
-declare const Input_2: React_2.ForwardRefExoticComponent<Omit<React_2.InputHTMLAttributes<HTMLInputElement>, "onChange" | "size"> & Pick<InputFieldProps<string>, "label" | "onChange" | "role" | "onFocus" | "onBlur" | "disabled" | "maxLength" | "required" | "size" | "loading" | "status" | "error" | "icon" | "hideLabel" | "append" | "labelIcon" | "onClickContent" | "hint" | "readonly" | "clearable" | "autocomplete" | "onClear" | "isEmpty" | "emptyValue" | "hideMaxLength" | "appendTag" | "lengthProvider"> & React_2.RefAttributes<HTMLInputElement>>;
+declare const Input_2: React_2.ForwardRefExoticComponent<Omit<React_2.InputHTMLAttributes<HTMLInputElement>, "onChange" | "size"> & Pick<InputFieldProps<string>, "label" | "onChange" | "role" | "onFocus" | "onBlur" | "disabled" | "maxLength" | "required" | "size" | "loading" | "status" | "error" | "icon" | "hideLabel" | "append" | "labelIcon" | "onClickContent" | "hint" | "readonly" | "clearable" | "autocomplete" | "onClear" | "isEmpty" | "emptyValue" | "hideMaxLength" | "appendTag" | "lengthProvider" | "buttonToggle"> & React_2.RefAttributes<HTMLInputElement>>;
 
 declare const INPUTFIELD_SIZES: readonly ["sm", "md"];
 
@@ -3404,6 +3456,16 @@ declare type InputFieldProps<T> = {
          */
         offset?: number;
     };
+    /**
+     * Renders a button toggle inside the input field
+     */
+    buttonToggle?: {
+        label: string | [string, string];
+        icon: IconType | [IconType, IconType];
+        selected: boolean;
+        disabled?: boolean;
+        onChange: (selected: boolean) => void;
+    };
 };
 
 declare type InputFieldSize = (typeof INPUTFIELD_SIZES)[number];
@@ -3420,11 +3482,13 @@ declare const inputFieldStatus: readonly ["default", "warning", "info", "error"]
 
 declare type InputFieldStatusType = (typeof inputFieldStatus)[number];
 
-export declare type InputProps<T extends string> = Pick<ComponentProps<typeof Input_2>, "ref"> & Pick<InputFieldProps<T>, "autoFocus" | "required" | "disabled" | "size" | "onChange" | "value" | "placeholder" | "clearable" | "maxLength" | "hideMaxLength" | "label" | "labelIcon" | "icon" | "hideLabel" | "name" | "error" | "status" | "hint" | "autocomplete"> & {
+declare type InputInternalProps<T extends string> = Pick<ComponentProps<typeof Input_2>, "ref"> & Pick<InputFieldProps<T>, "autoFocus" | "required" | "disabled" | "size" | "onChange" | "value" | "placeholder" | "clearable" | "maxLength" | "label" | "labelIcon" | "icon" | "hideLabel" | "name" | "error" | "status" | "hint" | "autocomplete" | "buttonToggle" | "hideMaxLength"> & {
     type?: Exclude<HTMLInputTypeAttribute, "number">;
     onPressEnter?: () => void;
 };
 
+export declare type InputProps<T extends string> = Omit<InputInternalProps<T>, (typeof privateProps_2)[number]>;
+
 declare const internalAvatarColors: readonly ["viridian", "malibu", "yellow", "purple", "lilac", "barbie", "smoke", "army", "flubber", "indigo", "camel"];
 
 declare type InternalAvatarProps = React_2.ComponentPropsWithoutRef<typeof AvatarPrimitive.Root> & {
@@ -3900,6 +3964,7 @@ declare type NestedKeyOf<T> = {
 declare type NestedResponseWithType<R extends RecordType> = {
     records: R[];
     type?: NestedVariant;
+    paginationInfo?: ChildrenPaginationInfo<R>;
 };
 
 declare type NestedVariant = "basic" | "detailed";
@@ -3968,12 +4033,28 @@ export declare type NumberFilterDefinition = BaseFilterDefinition<"number"> & {
 declare type NumberFilterOptions_2 = {
     min?: number;
     max?: number;
-    modes?: ("range" | "single")[];
+    modes?: readonly ("range" | "single")[];
+    openCloseToggle?: boolean;
 };
 
-export declare const NumberInput: ForwardRefExoticComponent<Omit<NumberInputProps, "ref"> & RefAttributes<HTMLInputElement>>;
+declare type NumberFilterValue = {
+    mode: "single";
+    value: number | undefined;
+} | {
+    mode: "range";
+    from: {
+        value: number | undefined;
+        closed: boolean;
+    };
+    to: {
+        value: number | undefined;
+        closed: boolean;
+    };
+} | undefined;
+
+export declare const NumberInput: (props: NumberInputProps) => JSX_2.Element;
 
-export declare type NumberInputProps = Omit<InputProps<string>, "value" | "type" | "onChange"> & {
+declare type NumberInputInternalProps = Omit<InputInternalProps<string>, "value" | "type" | "onChange"> & {
     locale: string;
     value?: number | null;
     step?: number;
@@ -3984,6 +4065,8 @@ export declare type NumberInputProps = Omit<InputProps<string>, "value" | "type"
     units?: string;
 };
 
+export declare type NumberInputProps = Omit<NumberInputInternalProps, (typeof privateProps_3)[number]>;
+
 declare type NumericQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
     value?: number | null;
 };
@@ -4071,7 +4154,7 @@ export declare interface OneCalendarInternalProps {
     compact?: boolean;
 }
 
-export declare type OneCalendarProps = Omit<OneCalendarInternalProps, (typeof privateProps_3)[number]>;
+export declare type OneCalendarProps = Omit<OneCalendarInternalProps, (typeof privateProps_5)[number]>;
 
 /**
  * @experimental This is an experimental component use it at your own risk
@@ -4581,11 +4664,15 @@ export declare const PrivateBox: FC<PropsWithChildren>;
 
 declare const privateProps: readonly ["append", "className", "pressed", "compact", "noTitle", "noAutoTooltip", "style"];
 
-declare const privateProps_2: readonly [];
+declare const privateProps_2: readonly ["buttonToggle"];
 
-declare const privateProps_3: readonly ["compact"];
+declare const privateProps_3: readonly ["buttonToggle"];
 
-declare const privateProps_4: readonly ["delay"];
+declare const privateProps_4: readonly [];
+
+declare const privateProps_5: readonly ["compact"];
+
+declare const privateProps_6: readonly ["delay"];
 
 declare type ProductUpdate = {
     title: string;
@@ -5726,7 +5813,7 @@ declare type TooltipInternalProps = {
     description: string;
 });
 
-export declare type TooltipProps = Omit<TooltipInternalProps, (typeof privateProps_4)[number]>;
+export declare type TooltipProps = Omit<TooltipInternalProps, (typeof privateProps_6)[number]>;
 
 declare interface TranscriptLabels {
     deleteBlock: string;
@@ -6145,31 +6232,6 @@ declare global {
 }
 
 
-declare module "gridstack" {
-    interface GridStackWidget {
-        id?: string;
-        allowedSizes?: Array<{
-            w: number;
-            h: number;
-        }>;
-        renderFn?: () => React.ReactElement | null;
-        meta?: Record<string, unknown>;
-    }
-    interface GridStackNode {
-        id?: string;
-        w?: number;
-        h?: number;
-        x?: number;
-        y?: number;
-        allowedSizes?: Array<{
-            w: number;
-            h: number;
-        }>;
-        renderFn?: () => React.ReactElement | null;
-    }
-}
-
-
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -6197,8 +6259,28 @@ declare module "@tiptap/core" {
 }
 
 
-declare namespace Calendar {
-    var displayName: string;
+declare module "gridstack" {
+    interface GridStackWidget {
+        id?: string;
+        allowedSizes?: Array<{
+            w: number;
+            h: number;
+        }>;
+        renderFn?: () => React.ReactElement | null;
+        meta?: Record<string, unknown>;
+    }
+    interface GridStackNode {
+        id?: string;
+        w?: number;
+        h?: number;
+        x?: number;
+        y?: number;
+        allowedSizes?: Array<{
+            w: number;
+            h: number;
+        }>;
+        renderFn?: () => React.ReactElement | null;
+    }
 }
 
 
@@ -6209,3 +6291,8 @@ declare module "@tiptap/core" {
         };
     }
 }
+
+
+declare namespace Calendar {
+    var displayName: string;
+}