@factorialco/f0-react 8.24.0 → 8.28.0

package/dist/experimental.d.ts

@@ -1430,7 +1430,7 @@ declare interface BaseChipProps extends VariantProps<typeof chipVariants> {
 
 declare type BaseColor = keyof typeof baseColors;
 
-export declare const BaseCommunityPost: ({ id, author, group, createdAt, title, description, onClick, mediaUrl, event, counters, reactions, inLabel, comment, actions, dropdownItems, noReactionsButton, descriptionExpandable, noDescriptionClamp, hideTitle, hideGroup, pinned, pinnedLabel, relativeDate, }: CommunityPostProps) => JSX_2.Element;
+export declare const BaseCommunityPost: ({ id, author, group, createdAt, title, description, onClick, mediaUrl, event, counters, reactions, inLabel, comment, actions, dropdownItems, noReactionsButton, descriptionExpandable, noDescriptionClamp, hideTitle, hideGroup, pinned, pinnedLabel, relativeDate, noVideoPreload, reserveCountersLine, }: CommunityPostProps) => JSX_2.Element;
 
 /**
  * Base data adapter configuration for non-paginated collections
@@ -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";
@@ -4159,7 +4166,7 @@ export declare type CommandRunContext = {
     setQuery: (query: string) => void;
 };
 
-export declare const CommunityPost: (({ id, author, group, createdAt, title, description, onClick, mediaUrl, event, counters, reactions, inLabel, comment, actions, dropdownItems, noReactionsButton, descriptionExpandable, noDescriptionClamp, hideTitle, hideGroup, pinned, pinnedLabel, relativeDate, }: CommunityPostProps) => JSX_2.Element) & {
+export declare const CommunityPost: (({ id, author, group, createdAt, title, description, onClick, mediaUrl, event, counters, reactions, inLabel, comment, actions, dropdownItems, noReactionsButton, descriptionExpandable, noDescriptionClamp, hideTitle, hideGroup, pinned, pinnedLabel, relativeDate, noVideoPreload, reserveCountersLine, }: CommunityPostProps) => JSX_2.Element) & {
     Skeleton: ({ withEvent, withImage, }: CommunityPostSkeletonProps) => JSX_2.Element;
 };
 
@@ -4197,7 +4204,13 @@ export declare type CommunityPostProps = {
         onClick: () => void;
     };
     actions?: CommunityPostAction[];
+    /** Sets `preload="none"` on a video: for lists that mount posts ahead of
+     * the reader (a virtualized feed), where preloading would fetch unseen media. */
     noVideoPreload?: boolean;
+    /** Keeps the counters line one line tall even while empty, so the first view
+     * or comment doesn't grow a post already on screen (a virtualized feed
+     * anchors on row heights). */
+    reserveCountersLine?: boolean;
     /**
      * WHAT CLICKING THE POST DOES — and whether it does anything.
      *
@@ -5466,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";
@@ -6075,6 +6091,7 @@ declare const defaultTranslations: {
         readonly documentPreview: "Document preview";
         readonly videoPlayerLabel: "Video player: {{name}}";
         readonly loadingVideo: "Loading video: {{name}}";
+        readonly previewUnavailable: "Can't preview this file";
         readonly photo: "Photo";
         readonly photoCount: {
             readonly one: "{{count}} photo";
@@ -6188,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";
@@ -12443,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
  */
@@ -18785,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
  */
@@ -20051,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.
  *
@@ -21018,16 +21107,6 @@ declare module "@tiptap/core" {
 }
 
 
-declare module "@tiptap/core" {
-    interface Commands<ReturnType> {
-        fontSize: {
-            setFontSize: (fontSize: string) => ReturnType;
-            unsetFontSize: () => ReturnType;
-        };
-    }
-}
-
-
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         enhanceHighlight: {
@@ -21051,6 +21130,16 @@ declare module "@tiptap/core" {
 }
 
 
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        fontSize: {
+            setFontSize: (fontSize: string) => ReturnType;
+            unsetFontSize: () => ReturnType;
+        };
+    }
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         moodTracker: {
@@ -21098,3 +21187,26 @@ declare namespace F0GraphCollapserWrapperInner {
 declare namespace F0GraphStackGroupWrapperInner {
     var displayName: string;
 }
+
+
+declare global {
+    interface Window {
+        __f0Jank?: JankProbe;
+    }
+}
+
+
+declare global {
+    interface Window {
+        __f0ChatHarness?: JankHarnessApi;
+        __f0JankInput?: JankRealInput;
+        __f0JankLast?: JankReport;
+        __f0JankState?: JankRunState;
+        /** Set by the runner when recording video: draw the anchor lines. */
+        __f0JankOverlay?: boolean;
+        /** Set by the runner: serve images through a slow route. */
+        __f0JankSlowImages?: boolean;
+        /** Force hard assertions on the gates (also `?jankStrict` in the URL). */
+        __f0JankStrict?: boolean;
+    }
+}