@factorialco/f0-react 8.25.0 → 8.28.0

package/dist/experimental.d.ts

@@ -2019,6 +2019,13 @@ export declare interface CalendarEventProps {
     fromDate?: Date;
     toDate?: Date;
     noBackground?: boolean;
+    /**
+     * Makes the whole event a real link, routed through the app's `LinkProvider`.
+     * Only an href to another host opens a new tab.
+     */
+    href?: string;
+    /** Called when a linked event is activated, alongside its navigation. */
+    onClick?: () => void;
 }
 
 export declare type CalendarMode = "single" | "range";
@@ -5472,6 +5479,9 @@ declare const defaultTranslations: {
         readonly language: "Language";
         readonly audio: "Audio";
     };
+    readonly swipeDeck: {
+        readonly label: "Swipe deck";
+    };
     readonly meetingCard: {
         readonly today: "Today";
         readonly yesterday: "Yesterday";
@@ -6195,6 +6205,7 @@ declare const defaultTranslations: {
             readonly description: "Try a different date or fewer filters";
         };
         readonly windowedCategories: "Showing {{count}} of {{total}} categories";
+        readonly noData: "No data";
         readonly tooltip: {
             readonly ofTotal: "of total";
             readonly total: "total";
@@ -12450,6 +12461,22 @@ export declare type F0SelectTagProp = string | {
 
 export declare type F0SelectVariant = (typeof selectVariants)[number];
 
+/**
+ * @experimental This is an experimental component, use it at your own risk.
+ */
+export declare const F0SwipeDeck: <T>({ deck, renderCard, label, empty, dataTestId, offsetThreshold, velocityThreshold, }: F0SwipeDeckProps<T>) => JSX_2.Element;
+
+export declare type F0SwipeDeckProps<T> = WithDataTestIdProps & {
+    deck: UseSwipeDeckResult<T>;
+    renderCard: (item: T) => ReactNode;
+    label?: string;
+    empty?: ReactNode;
+    /** Drag distance in pixels that commits a decision. */
+    offsetThreshold?: number;
+    /** Drag speed in pixels per second that commits a decision regardless of distance. */
+    velocityThreshold?: number;
+};
+
 /**
  * @experimental This is an experimental component use it at your own risk
  */
@@ -18792,6 +18819,24 @@ export declare type SummaryKey<Definition extends SummariesDefinition> = Definit
 
 export declare type SummaryType = "sum";
 
+export declare type SwipeDecision<T> = {
+    item: T;
+    direction: SwipeDirection;
+};
+
+export declare type SwipeDeckAction = {
+    type: "decide";
+    direction: SwipeDirection;
+} | {
+    type: "undo";
+} | {
+    type: "rollback";
+};
+
+export declare type SwipeDirection = (typeof swipeDirections)[number];
+
+export declare const swipeDirections: readonly ["left", "right"];
+
 /**
  * @experimental This is an experimental component use it at your own risk
  */
@@ -20058,6 +20103,43 @@ export declare const useSidebarChats: () => SidebarChatStore;
  */
 export declare function useSidePanel(): SidePanelContextValue;
 
+export declare const useSwipeDeck: <T>({ items, getItemId, onDecide, onUndo, onNeedMore, undoDepth, needMoreThreshold, }: UseSwipeDeckOptions<T>) => UseSwipeDeckResult<T>;
+
+export declare type UseSwipeDeckOptions<T> = {
+    /**
+     * Append-only: the deck reads it by position, so a page of new items must be
+     * added to the end. Replacing the array with a differently ordered or
+     * filtered one makes the deck skip items.
+     */
+    items: T[];
+    getItemId: (item: T) => string;
+    /**
+     * `rollback` returns the item to the deck, for a consumer whose mutation
+     * failed: as the current card when it was the most recent decision, after
+     * the items loaded so far otherwise.
+     */
+    onDecide?: (decision: SwipeDecision<T>, rollback: () => void) => void;
+    onUndo?: (item: T) => void;
+    /** Fires once each time the remaining items drop to `needMoreThreshold`. */
+    onNeedMore?: () => void;
+    undoDepth?: number;
+    needMoreThreshold?: number;
+};
+
+export declare type UseSwipeDeckResult<T> = {
+    current: T | undefined;
+    currentId: string | undefined;
+    index: number;
+    total: number;
+    remaining: number;
+    canUndo: boolean;
+    lastAction: SwipeDeckAction | undefined;
+    decide: (direction: SwipeDirection) => void;
+    swipeLeft: () => void;
+    swipeRight: () => void;
+    undo: () => void;
+};
+
 /**
  * Attaches a track to a media element F0 owns.
  *
@@ -21039,9 +21121,10 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        fontSize: {
-            setFontSize: (fontSize: string) => ReturnType;
-            unsetFontSize: () => ReturnType;
+        indent: {
+            setIndent: (level: number) => ReturnType;
+            unsetIndent: () => ReturnType;
+            outdent: () => ReturnType;
         };
     }
 }
@@ -21049,10 +21132,9 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        indent: {
-            setIndent: (level: number) => ReturnType;
-            unsetIndent: () => ReturnType;
-            outdent: () => ReturnType;
+        fontSize: {
+            setFontSize: (fontSize: string) => ReturnType;
+            unsetFontSize: () => ReturnType;
         };
     }
 }