@factorialco/f0-react 2.60.0 → 2.61.1

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;
 }
 
@@ -16359,6 +16387,11 @@ declare module "gridstack" {
 }
 
 
+declare namespace Calendar {
+    var displayName: string;
+}
+
+
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         aiBlock: {
@@ -16408,11 +16441,6 @@ declare module "@tiptap/core" {
 }
 
 
-declare namespace Calendar {
-    var displayName: string;
-}
-
-
 declare namespace F0GraphNodeWrapperInner {
     var displayName: string;
 }