@factorialco/f0-react 1.278.0 → 1.279.2

package/dist/experimental.d.ts

@@ -1316,6 +1316,14 @@ export declare const ChartWidgetEmptyState: ForwardRefExoticComponent<Props_5 &
 
 export declare type ChatWidgetEmptyStateProps = Props_5;
 
+declare type ChildrenResponse<R extends RecordType> = BaseResponse<R> | R[] | {
+    records: R[] & {
+        type?: ChildrenResponseType;
+    };
+};
+
+declare type ChildrenResponseType = "basic" | "detailed";
+
 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;
 
 export declare interface ClockInControlsProps {
@@ -1828,6 +1836,13 @@ export declare type DataSourceDefinition<R extends RecordType = RecordType, Filt
     defaultGrouping?: GroupingState<R, Grouping>;
     /** Current state of applied grouping */
     currentGrouping?: GroupingState<R, Grouping>;
+    /*******************************************************/
+    /***** NESTED RECORDS ***************************************************/
+    fetchChildren?: (item: R, filters?: FiltersState<FiltersDefinition>) => 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;
 };
 
 export declare type DateFilterDefinition = BaseFilterDefinition<"date"> & {
@@ -2583,7 +2598,7 @@ declare type F0AvatarFileProps = Omit<React.ComponentPropsWithoutRef<typeof Avat
 } & Pick<BaseAvatarProps, "aria-label" | "aria-labelledby">;
 
 declare type F0AvatarFlagProps = {
-    flag: CountryCode;
+    flag: CountryCode | (string & {});
     size?: BaseAvatarProps["size"];
     badge?: AvatarBadge;
 } & Pick<BaseAvatarProps, "aria-label" | "aria-labelledby">;
@@ -3186,6 +3201,15 @@ declare type InFilterOptionItem<T = unknown> = {
  */
 declare type InFilterOptions_2<T, _R extends RecordType = RecordType> = {
     cache?: boolean;
+    /**
+     * Optional function to resolve labels for specific values without fetching all options.
+     * This is useful when you have a dynamic source and want to avoid fetching all options
+     * just to display labels for selected values.
+     * @param value - The value to get the label for
+     * @returns The label for the value, or a promise that resolves to the label
+     * @note The parameter type is `unknown` to allow compatibility when T is different types
+     */
+    getLabel?: (value: unknown) => string | Promise<string>;
 } & ({
     options: Array<InFilterOptionItem<T>> | (() => Array<InFilterOptionItem<T>> | Promise<Array<InFilterOptionItem<T>>>);
 } | {
@@ -5887,33 +5911,6 @@ declare global {
 }
 
 
-declare module "@tiptap/core" {
-    interface Commands<ReturnType> {
-        aiBlock: {
-            insertAIBlock: (data: AIBlockData, config: AIBlockConfigWithLabels) => ReturnType;
-        };
-    }
-}
-
-
-declare module "@tiptap/core" {
-    interface Commands<ReturnType> {
-        liveCompanion: {
-            insertLiveCompanion: (data: LiveCompanionData, config?: LiveCompanionConfig) => ReturnType;
-        };
-    }
-}
-
-
-declare module "@tiptap/core" {
-    interface Commands<ReturnType> {
-        transcript: {
-            insertTranscript: (data: TranscriptData, config?: TranscriptConfig) => ReturnType;
-        };
-    }
-}
-
-
 declare module "gridstack" {
     interface GridStackWidget {
         id?: string;
@@ -5939,8 +5936,30 @@ declare module "gridstack" {
 }
 
 
-declare namespace Calendar {
-    var displayName: string;
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        aiBlock: {
+            insertAIBlock: (data: AIBlockData, config: AIBlockConfigWithLabels) => ReturnType;
+        };
+    }
+}
+
+
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        liveCompanion: {
+            insertLiveCompanion: (data: LiveCompanionData, config?: LiveCompanionConfig) => ReturnType;
+        };
+    }
+}
+
+
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        transcript: {
+            insertTranscript: (data: TranscriptData, config?: TranscriptConfig) => ReturnType;
+        };
+    }
 }
 
 
@@ -5951,3 +5970,8 @@ declare module "@tiptap/core" {
         };
     }
 }
+
+
+declare namespace Calendar {
+    var displayName: string;
+}