@factorialco/f0-react 1.288.0 → 1.290.0

package/dist/f0.d.ts

@@ -52,7 +52,6 @@ import { LongTextCellValue } from './types/longText';
 import { NumberCellValue } from '../../value-display/types/number';
 import { NumberCellValue as NumberCellValue_2 } from './types/number';
 import { NumberFilterOptions } from './NumberFilter/NumberFilter';
-import { NumberFilterValue } from './NumberFilter/NumberFilter';
 import { Observable } from 'zen-observable-ts';
 import { PercentageCellValue } from './types/percentage';
 import { PersonCellValue } from '../../value-display/types/person';
@@ -64,6 +63,7 @@ import { ReactElement } from 'react';
 import { ReactNode } from 'react';
 import { RefAttributes } from 'react';
 import { RefObject } from 'react';
+import { SearchFilterOptions } from './SearchFilter/SearchFilter';
 import { StatusCellValue } from '../../value-display/types/status';
 import { StatusCellValue as StatusCellValue_2 } from './types/status';
 import { SVGProps } from 'react';
@@ -920,7 +920,22 @@ declare interface CheckboxProps extends DataAttributes_2 {
     name?: string;
 }
 
-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;
+});
 
 declare type ChipProps = BaseChipProps & ChipVariants & {
     variant?: "default" | "selected";
@@ -1295,11 +1310,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"> & {
@@ -1567,12 +1582,20 @@ export 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";
@@ -2411,12 +2434,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;
@@ -2425,7 +2448,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
      */
@@ -2440,14 +2463,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;
 };
 
 /**
@@ -2458,7 +2494,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.
@@ -2799,6 +2835,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];
@@ -3070,6 +3116,7 @@ declare type NestedKeyOf<T> = {
 declare type NestedResponseWithType<R extends RecordType> = {
     records: R[];
     type?: NestedVariant;
+    paginationInfo?: ChildrenPaginationInfo<R>;
 };
 
 declare type NestedVariant = "basic" | "detailed";
@@ -3088,9 +3135,25 @@ export declare type NumberFilterDefinition = BaseFilterDefinition<"number"> & {
 declare type NumberFilterOptions_2 = {
     min?: number;
     max?: number;
-    modes?: ("range" | "single")[];
+    modes?: readonly ("range" | "single")[];
+    openCloseToggle?: boolean;
 };
 
+declare type NumberFilterValue = {
+    mode: "single";
+    value: number | undefined;
+} | {
+    mode: "range";
+    from: {
+        value: number | undefined;
+        closed: boolean;
+    };
+    to: {
+        value: number | undefined;
+        closed: boolean;
+    };
+} | undefined;
+
 declare type OnBulkActionCallback<Record extends RecordType, Filters extends FiltersDefinition> = (...args: [
 action: BulkAction,
 ...Parameters<OnSelectItemsCallback<Record, Filters>>
@@ -4347,31 +4410,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: {
@@ -4399,8 +4437,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;
+    }
 }
 
 
@@ -4411,3 +4469,8 @@ declare module "@tiptap/core" {
         };
     }
 }
+
+
+declare namespace Calendar {
+    var displayName: string;
+}