@factorialco/f0-react 2.59.0 → 2.61.0

package/dist/f0.d.ts

@@ -409,6 +409,21 @@ declare type ActionVariant = (typeof actionVariants)[number];
 
 declare const actionVariants: readonly ["default", "outline", "critical", "neutral", "ghost", "promote", "outlinePromote", "ai", "link", "unstyled", "mention"];
 
+/**
+ * Wraps a `pages`-paginated data adapter so it presents itself as
+ * `infinite-scroll`, letting page-based sources (the typical list adapter) be
+ * consumed by components that only support cursor pagination — e.g.
+ * `F0Select` and the breadcrumb jump-to select.
+ *
+ * The cursor is the stringified next page: `cursor: null` fetches page 1,
+ * `cursor: "3"` fetches page 3, and `hasMore` is derived from
+ * `currentPage < pagesCount`. All three `fetchData` return channels (sync,
+ * Promise, Observable of PromiseState) are mapped; loading/error emissions
+ * pass through untouched. Adapters that already are `infinite-scroll` /
+ * `no-pagination` are returned as-is (same reference).
+ */
+export declare const adaptDataAdapterToInfiniteScroll: <R extends RecordType, Filters extends FiltersDefinition>(dataAdapter: DataAdapter<R, Filters>) => DataAdapter<R, Filters>;
+
 declare type AddRowActionsResult = PrimaryActionItemDefinition | PrimaryActionItemDefinition[] | undefined;
 
 /* Excluded from this release type: AgentState */
@@ -9816,6 +9831,12 @@ declare type F0SelectBaseProps<T extends string, R = unknown> = {
     onSearchChange?: (value: string) => void;
     searchValue?: string;
     onOpenChange?: (open: boolean) => void;
+    /**
+     * Called when the user changes the in-dropdown filters (requires a `source`
+     * with filter definitions). Lets consumers keep an external context — e.g.
+     * detail-page navigation — in sync with what the dropdown is showing.
+     */
+    onFiltersChange?: (filters: FiltersState<FiltersDefinition>) => void;
     searchEmptyMessage?: string;
     className?: string;
     actions?: Action_2[];
@@ -15877,7 +15898,7 @@ export declare const useGroups: <R extends RecordType>(groups: GroupRecord<R>[],
  *   id is null, nothing is fetched and `neighbors` stays null — consumers
  *   keep their fallback behaviour.
  */
-export declare function useItemNeighbors<R extends RecordType, Filters extends FiltersDefinition>({ dataAdapter, id, filters, sortings, search, enabled, onError, }: UseItemNeighborsOptions<R, Filters>): UseItemNeighborsReturn<R>;
+export declare function useItemNeighbors<R extends RecordType, Filters extends FiltersDefinition>({ dataAdapter, id, filters, sortings, search, enabled, fetchParamsProvider, onError, }: UseItemNeighborsOptions<R, Filters>): UseItemNeighborsReturn<R>;
 
 export declare interface UseItemNeighborsOptions<R extends RecordType, Filters extends FiltersDefinition> {
     /** The adapter that may implement the `fetchItemNeighbors` capability */
@@ -15896,6 +15917,13 @@ export declare interface UseItemNeighborsOptions<R extends RecordType, Filters e
      * @default true
      */
     enabled?: boolean;
+    /**
+     * Extends/transforms the options passed to `fetchItemNeighbors`, mirroring
+     * `useData`'s option of the same name — e.g. OneDataCollection adds
+     * `navigationFilters`. The extended options also key the response cache,
+     * so extra context invalidates it correctly.
+     */
+    fetchParamsProvider?: <O extends BaseFetchOptions<Filters>>(options: O) => O;
     onError?: (error: DataError) => void;
 }
 
@@ -16376,9 +16404,8 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        enhanceHighlight: {
-            setEnhanceHighlight: (from: number, to: number) => ReturnType;
-            clearEnhanceHighlight: () => ReturnType;
+        moodTracker: {
+            insertMoodTracker: (data: MoodTrackerData) => ReturnType;
         };
     }
 }
@@ -16386,8 +16413,9 @@ declare module "@tiptap/core" {
 
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
-        moodTracker: {
-            insertMoodTracker: (data: MoodTrackerData) => ReturnType;
+        enhanceHighlight: {
+            setEnhanceHighlight: (from: number, to: number) => ReturnType;
+            clearEnhanceHighlight: () => ReturnType;
         };
     }
 }