@wix/patterns 1.483.0 → 1.485.0

package/src/components/SlidingModal/SlidingModal.st.css.ts

@@ -5,7 +5,7 @@ import { classesRuntime, statesRuntime } from "../../stylable-esm-runtime.js";
 
 
 
-var _namespace_ = "SlidingModal2408213466";
+var _namespace_ = "SlidingModal374946894";
 var _style_ = classesRuntime.bind(null, _namespace_);
 
 export var cssStates = statesRuntime.bind(null, _namespace_);
@@ -13,7 +13,7 @@ export var style = _style_;
 export var st: import("@stylable/runtime").STFunction = _style_;
 
 export var namespace = _namespace_;
-export var classes = {"root":"SlidingModal2408213466__root"};
+export var classes = {"root":"SlidingModal374946894__root"};
 export var keyframes = {}; 
 export var layers = {};
 export var containers = {};

package/src/components/Table/AddFieldColumnHeader.st.css.ts

@@ -5,7 +5,7 @@ import { classesRuntime, statesRuntime } from "../../stylable-esm-runtime.js";
 
 
 
-var _namespace_ = "AddFieldColumnHeader4142431444";
+var _namespace_ = "AddFieldColumnHeader995037369";
 var _style_ = classesRuntime.bind(null, _namespace_);
 
 export var cssStates = statesRuntime.bind(null, _namespace_);
@@ -13,7 +13,7 @@ export var style = _style_;
 export var st: import("@stylable/runtime").STFunction = _style_;
 
 export var namespace = _namespace_;
-export var classes = {"root":"AddFieldColumnHeader4142431444__root","anchorLayer":"AddFieldColumnHeader4142431444__anchorLayer","popover":"AddFieldColumnHeader4142431444__popover","title":"AddFieldColumnHeader4142431444__title","hoverBridge":"AddFieldColumnHeader4142431444__hoverBridge"};
+export var classes = {"root":"AddFieldColumnHeader995037369__root","anchorLayer":"AddFieldColumnHeader995037369__anchorLayer","popover":"AddFieldColumnHeader995037369__popover","title":"AddFieldColumnHeader995037369__title","hoverBridge":"AddFieldColumnHeader995037369__hoverBridge"};
 export var keyframes = {}; 
 export var layers = {};
 export var containers = {};

package/src/components/Table/PrimaryFieldHeaderFlag.tsx

@@ -0,0 +1,20 @@
+import React from 'react';
+import { Box, Tooltip } from '@wix/design-system';
+import { FlagFilledSmall } from '@wix/wix-ui-icons-common/lazy';
+import { useWixPatternsContainer } from '@wix/bex-core/react';
+
+export function PrimaryFieldHeaderFlag() {
+  const { translate: t } = useWixPatternsContainer();
+
+  return (
+    <Tooltip
+      dataHook="primary-field-header-flag"
+      content={t('cairo.table.custom-columns.indication.primary.tooltip')}
+      appendTo="window"
+    >
+      <Box flexShrink={0} verticalAlign="middle">
+        <FlagFilledSmall />
+      </Box>
+    </Tooltip>
+  );
+}

package/src/components/TableFolders/TableFoldersContent.tsx

@@ -258,7 +258,6 @@ function _TableFoldersContent<
   return (
     <Table
       {...rest}
-      showHeaderWhenEmpty
       state={state}
       sticky
       search={search}

package/src/components/TabsFilter/TabsFilter.st.css.ts

@@ -5,7 +5,7 @@ import { classesRuntime, statesRuntime } from "../../stylable-esm-runtime.js";
 
 
 
-var _namespace_ = "TabsFilter740598598";
+var _namespace_ = "TabsFilter2111467738";
 var _style_ = classesRuntime.bind(null, _namespace_);
 
 export var cssStates = statesRuntime.bind(null, _namespace_);
@@ -13,7 +13,7 @@ export var style = _style_;
 export var st: import("@stylable/runtime").STFunction = _style_;
 
 export var namespace = _namespace_;
-export var classes = {"root":"TabsFilter740598598__root","titleBox":"TabsFilter740598598__titleBox"};
+export var classes = {"root":"TabsFilter2111467738__root","titleBox":"TabsFilter2111467738__titleBox"};
 export var keyframes = {}; 
 export var layers = {};
 export var containers = {};

package/src/components/Tags/ManageTags/ManageTagsModal/ManageTagsModal.st.css.ts

@@ -5,7 +5,7 @@ import { classesRuntime, statesRuntime } from "../../../../stylable-esm-runtime.
 
 
 
-var _namespace_ = "ManageTagsModal869508022";
+var _namespace_ = "ManageTagsModal3997751947";
 var _style_ = classesRuntime.bind(null, _namespace_);
 
 export var cssStates = statesRuntime.bind(null, _namespace_);
@@ -13,7 +13,7 @@ export var style = _style_;
 export var st: import("@stylable/runtime").STFunction = _style_;
 
 export var namespace = _namespace_;
-export var classes = {"root":"ManageTagsModal869508022__root"};
+export var classes = {"root":"ManageTagsModal3997751947__root"};
 export var keyframes = {}; 
 export var layers = {};
 export var containers = {};

package/src/components/ToolbarItem/ToolbarItem.st.css.ts

@@ -5,7 +5,7 @@ import { classesRuntime, statesRuntime } from "../../stylable-esm-runtime.js";
 
 
 
-var _namespace_ = "ToolbarItem1893581691";
+var _namespace_ = "ToolbarItem2641872092";
 var _style_ = classesRuntime.bind(null, _namespace_);
 
 export var cssStates = statesRuntime.bind(null, _namespace_);
@@ -13,7 +13,7 @@ export var style = _style_;
 export var st: import("@stylable/runtime").STFunction = _style_;
 
 export var namespace = _namespace_;
-export var classes = {"root":"ToolbarItem1893581691__root"};
+export var classes = {"root":"ToolbarItem2641872092__root"};
 export var keyframes = {}; 
 export var layers = {};
 export var containers = {};

package/src/components/ToolbarItemBox/ToolbarItemBox.st.css.ts

@@ -5,7 +5,7 @@ import { classesRuntime, statesRuntime } from "../../stylable-esm-runtime.js";
 
 
 
-var _namespace_ = "ToolbarItemBox1194538631";
+var _namespace_ = "ToolbarItemBox3288774067";
 var _style_ = classesRuntime.bind(null, _namespace_);
 
 export var cssStates = statesRuntime.bind(null, _namespace_);
@@ -13,7 +13,7 @@ export var style = _style_;
 export var st: import("@stylable/runtime").STFunction = _style_;
 
 export var namespace = _namespace_;
-export var classes = {"root":"ToolbarItemBox1194538631__root"};
+export var classes = {"root":"ToolbarItemBox3288774067__root"};
 export var keyframes = {}; 
 export var layers = {};
 export var containers = {};

package/src/components/common.st.css.ts

@@ -5,7 +5,7 @@ import { classesRuntime, statesRuntime } from "../stylable-esm-runtime.js";
 
 
 
-var _namespace_ = "common1857037593";
+var _namespace_ = "common1560238800";
 var _style_ = classesRuntime.bind(null, _namespace_);
 
 export var cssStates = statesRuntime.bind(null, _namespace_);
@@ -13,7 +13,7 @@ export var style = _style_;
 export var st: import("@stylable/runtime").STFunction = _style_;
 
 export var namespace = _namespace_;
-export var classes = {"root":"common1857037593__root","column":"common1857037593__column","fullHeight":"common1857037593__fullHeight"};
+export var classes = {"root":"common1560238800__root","column":"common1560238800__column","fullHeight":"common1560238800__fullHeight"};
 export var keyframes = {}; 
 export var layers = {};
 export var containers = {};

package/src/essentials/usePickerModal.ts

@@ -10,7 +10,11 @@ import {
   FiltersMap,
   OptionalFiltersMap,
 } from '@wix/bex-core';
-import { PaginationModeConfig } from '@wix/bex-core/react';
+import {
+  CursorPaginationModeConfig,
+  OffsetPaginationModeConfig,
+  PaginationModeConfig,
+} from '@wix/bex-core/react';
 import { useEssentials } from '@wix/fe-essentials/react';
 import { useCallback, useState } from 'react';
 
@@ -34,9 +38,23 @@ export type UsePickerModalParams<
   UsePickerModalParamsOverrides<T, F> &
   PaginationModeConfig<T, F>;
 
-export type PikerModalFactory = <T, F extends FiltersMap = OptionalFiltersMap>(
-  config: UsePickerModalParams<T, F>,
-) => PickerModalState<T, F>;
+type ParamsWithoutPagination<
+  T,
+  F extends FiltersMap,
+> = UsePickerModalParamsEssentials<T, F> & UsePickerModalParamsOverrides<T, F>;
+
+// One overload per pagination branch: see `PaginationModeConfig` in bex-core.
+export type PikerModalFactory = {
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: ParamsWithoutPagination<T, F> & CursorPaginationModeConfig<T, F>,
+  ): PickerModalState<T, F>;
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: ParamsWithoutPagination<T, F> & OffsetPaginationModeConfig<T, F>,
+  ): PickerModalState<T, F>;
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: UsePickerModalParams<T, F>,
+  ): PickerModalState<T, F>;
+};
 
 export function useCreatePickerModal(): PikerModalFactory {
   const { errorMonitor, environment, biLoggerFactory } = useEssentials();
@@ -57,9 +75,18 @@ export function useCreatePickerModal(): PikerModalFactory {
   );
 }
 
+export function usePickerModal<T, F extends FiltersMap = OptionalFiltersMap>(
+  params: ParamsWithoutPagination<T, F> & CursorPaginationModeConfig<T, F>,
+): PickerModalState<T, F>;
+export function usePickerModal<T, F extends FiltersMap = OptionalFiltersMap>(
+  params: ParamsWithoutPagination<T, F> & OffsetPaginationModeConfig<T, F>,
+): PickerModalState<T, F>;
+export function usePickerModal<T, F extends FiltersMap = OptionalFiltersMap>(
+  params: UsePickerModalParams<T, F>,
+): PickerModalState<T, F>;
 export function usePickerModal<T, F extends FiltersMap = OptionalFiltersMap>(
   params: UsePickerModalParams<T, F>,
-) {
+): PickerModalState<T, F> {
   const createPickerModal = useCreatePickerModal();
   const [state] = useState(() => createPickerModal<T, F>(params));
   useSyncPickerModalProps(state, params);

package/src/giza/usePickerModal.ts

@@ -10,7 +10,11 @@ import {
   FiltersMap,
   OptionalFiltersMap,
 } from '@wix/bex-core';
-import { PaginationModeConfig } from '@wix/bex-core/react';
+import {
+  CursorPaginationModeConfig,
+  OffsetPaginationModeConfig,
+  PaginationModeConfig,
+} from '@wix/bex-core/react';
 import { useEssentials } from '@wix/yoshi-flow-bm/fe-essentials-giza';
 import { useCallback, useState } from 'react';
 
@@ -34,9 +38,23 @@ export type UsePickerModalParams<
   UsePickerModalParamsOverrides<T, F> &
   PaginationModeConfig<T, F>;
 
-export type PikerModalFactory = <T, F extends FiltersMap = OptionalFiltersMap>(
-  config: UsePickerModalParams<T, F>,
-) => PickerModalState<T, F>;
+type ParamsWithoutPagination<
+  T,
+  F extends FiltersMap,
+> = UsePickerModalParamsEssentials<T, F> & UsePickerModalParamsOverrides<T, F>;
+
+// One overload per pagination branch: see `PaginationModeConfig` in bex-core.
+export type PikerModalFactory = {
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: ParamsWithoutPagination<T, F> & CursorPaginationModeConfig<T, F>,
+  ): PickerModalState<T, F>;
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: ParamsWithoutPagination<T, F> & OffsetPaginationModeConfig<T, F>,
+  ): PickerModalState<T, F>;
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: UsePickerModalParams<T, F>,
+  ): PickerModalState<T, F>;
+};
 
 export function useCreatePickerModal(): PikerModalFactory {
   const { errorMonitor, environment, createChildEssentials } = useEssentials();
@@ -60,9 +78,18 @@ export function useCreatePickerModal(): PikerModalFactory {
   );
 }
 
+export function usePickerModal<T, F extends FiltersMap = OptionalFiltersMap>(
+  params: ParamsWithoutPagination<T, F> & CursorPaginationModeConfig<T, F>,
+): PickerModalState<T, F>;
+export function usePickerModal<T, F extends FiltersMap = OptionalFiltersMap>(
+  params: ParamsWithoutPagination<T, F> & OffsetPaginationModeConfig<T, F>,
+): PickerModalState<T, F>;
+export function usePickerModal<T, F extends FiltersMap = OptionalFiltersMap>(
+  params: UsePickerModalParams<T, F>,
+): PickerModalState<T, F>;
 export function usePickerModal<T, F extends FiltersMap = OptionalFiltersMap>(
   params: UsePickerModalParams<T, F>,
-) {
+): PickerModalState<T, F> {
   const createPickerModal = useCreatePickerModal();
   const [state] = useState(() => createPickerModal<T, F>(params));
   useSyncPickerModalProps(state, params);

package/src/hooks/useCreateWSRColumnBase.tsx

@@ -3,6 +3,7 @@ import React, { useCallback, type ReactNode } from 'react';
 import { Box, Text } from '@wix/design-system';
 import { getFieldTypeIcon } from '../utils/fieldTypePrefixIcons';
 import { AddFieldColumnHeader } from '../components/Table/AddFieldColumnHeader';
+import { PrimaryFieldHeaderFlag } from '../components/Table/PrimaryFieldHeaderFlag';
 
 export interface UseCreateWSRColumnBaseParams {
   horizontalScroll?: boolean;
@@ -31,6 +32,7 @@ export function useCreateWSRColumnBase({
         infoTooltipProps,
         fieldType,
         fieldTypeIcons,
+        isPrimary,
       } = column;
       const lastColumn = index === length - 1;
 
@@ -58,6 +60,7 @@ export function useCreateWSRColumnBase({
       const renderedTitle: ReactNode =
         title && showFieldTypeIcons ? (
           <Box gap="SP1" verticalAlign="middle" minWidth={0}>
+            {isPrimary && <PrimaryFieldHeaderFlag />}
             <Box flexShrink={0}>
               {getFieldTypeIcon({ fieldType, icons: fieldTypeIcons })}
             </Box>

package/src/hooks/useEditableTableCollection.ts

@@ -6,6 +6,9 @@ import {
 import {
   useWixPatternsContainer,
   CollectionConfigWithConditionals,
+  CollectionConfigWithoutPagination,
+  CursorPaginationModeConfig,
+  OffsetPaginationModeConfig,
   useCreateCollection,
   useCreateOptimisticActions,
 } from '@wix/bex-core/react';
@@ -20,7 +23,9 @@ import { useOptionalCachedState } from './useOptionalCachedState';
 export type EditableTableCollectionConfig<
   T,
   F extends FiltersMap,
-> = CollectionConfigWithConditionals<T, F> & {
+> = CollectionConfigWithConditionals<T, F> & EditableTableOptions<T, F>;
+
+type EditableTableOptions<T, F extends FiltersMap> = {
   permissions?: EditableTablePermissions<T>;
   mutations: EditableTableMutationHandlers<T>;
   optimisticActionParams?: Partial<CollectionOptimisticActionsBaseParams<T, F>>;
@@ -31,9 +36,22 @@ export type EditableTableCollectionConfig<
   extraCellTypes?: CellType[];
 };
 
-type EditableTableCollection = <T, F extends FiltersMap = OptionalFiltersMap>(
-  config: EditableTableCollectionConfig<T, F>,
-) => EditableTableState<T, F>;
+// One overload per pagination branch: see `PaginationModeConfig`.
+type EditableTableCollection = {
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: CollectionConfigWithoutPagination<T, F> &
+      EditableTableOptions<T, F> &
+      CursorPaginationModeConfig<T, F>,
+  ): EditableTableState<T, F>;
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: CollectionConfigWithoutPagination<T, F> &
+      EditableTableOptions<T, F> &
+      OffsetPaginationModeConfig<T, F>,
+  ): EditableTableState<T, F>;
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: EditableTableCollectionConfig<T, F>,
+  ): EditableTableState<T, F>;
+};
 
 export const useEditableTableCollection: EditableTableCollection = <
   T,

package/src/hooks/useFilterCollection/useFilterCollection.ts

@@ -8,8 +8,8 @@ import {
 import {
   CollectionConfig,
   CollectionConfigWithConditionals,
-  CursorFetchDataFn,
-  OffsetFetchDataFn,
+  CursorPaginationModeConfig,
+  OffsetPaginationModeConfig,
   useCreateCollection,
 } from '@wix/bex-core/react';
 
@@ -17,17 +17,7 @@ type FiltersConfig<F extends FiltersMap> = F extends OptionalFiltersMap
   ? { filters?: {} }
   : { filters: F };
 
-type PaginationModeConfig<T, F extends FiltersMap> =
-  | {
-      paginationMode?: 'offset';
-      fetchData: OffsetFetchDataFn<T, F>;
-    }
-  | {
-      paginationMode: 'cursor';
-      fetchData: CursorFetchDataFn<T, F>;
-    };
-
-export type FilterCollectionConfig<T, F extends FiltersMap> = Omit<
+type ConfigWithoutPagination<T, F extends FiltersMap> = Omit<
   CollectionConfig<T, F>,
   | 'itemKey'
   | 'itemName'
@@ -36,18 +26,38 @@ export type FilterCollectionConfig<T, F extends FiltersMap> = Omit<
   | 'fetchData'
   | 'fetchErrorMessage'
 > &
-  FiltersConfig<F> &
-  PaginationModeConfig<T, F>;
+  FiltersConfig<F>;
 
-export type FilterCollectionFactory = <T, F extends FiltersMap = FiltersMap>(
-  filter: Filter<T[]>,
-  config: FilterCollectionConfig<T, F>,
-) => CollectionState<T, F>;
+type CursorConfig<T, F extends FiltersMap> = ConfigWithoutPagination<T, F> &
+  Omit<CursorPaginationModeConfig<T, F>, 'fetchTotal'>;
+
+type OffsetConfig<T, F extends FiltersMap> = ConfigWithoutPagination<T, F> &
+  OffsetPaginationModeConfig<T, F>;
+
+export type FilterCollectionConfig<T, F extends FiltersMap> =
+  | OffsetConfig<T, F>
+  | CursorConfig<T, F>;
+
+// One overload per pagination branch: see `PaginationModeConfig` in bex-core.
+export type FilterCollectionFactory = {
+  <T, F extends FiltersMap = FiltersMap>(
+    filter: Filter<T[]>,
+    config: CursorConfig<T, F>,
+  ): CollectionState<T, F>;
+  <T, F extends FiltersMap = FiltersMap>(
+    filter: Filter<T[]>,
+    config: OffsetConfig<T, F>,
+  ): CollectionState<T, F>;
+  <T, F extends FiltersMap = FiltersMap>(
+    filter: Filter<T[]>,
+    config: FilterCollectionConfig<T, F>,
+  ): CollectionState<T, F>;
+};
 
 export function useCreateFilterCollection(): FilterCollectionFactory {
   const createCollection = useCreateCollection();
 
-  return useCallback(
+  return useCallback<FilterCollectionFactory>(
     <T, F extends FiltersMap = FiltersMap>(
       filter: Filter<T[]>,
       config: FilterCollectionConfig<T, F>,
@@ -67,6 +77,21 @@ export function useCreateFilterCollection(): FilterCollectionFactory {
   );
 }
 
+export function useFilterCollection<
+  T,
+  F extends FiltersMap = OptionalFiltersMap,
+>(filter: Filter<T[]>, config: CursorConfig<T, F>): CollectionState<T, F>;
+export function useFilterCollection<
+  T,
+  F extends FiltersMap = OptionalFiltersMap,
+>(filter: Filter<T[]>, config: OffsetConfig<T, F>): CollectionState<T, F>;
+export function useFilterCollection<
+  T,
+  F extends FiltersMap = OptionalFiltersMap,
+>(
+  filter: Filter<T[]>,
+  config: FilterCollectionConfig<T, F>,
+): CollectionState<T, F>;
 export function useFilterCollection<
   T,
   F extends FiltersMap = OptionalFiltersMap,

package/src/hooks/useGridCollection.ts

@@ -2,14 +2,28 @@ import { FiltersMap, OptionalFiltersMap } from '@wix/bex-core';
 import {
   useWixPatternsContainer,
   CollectionConfigWithConditionals,
+  CollectionConfigWithoutPagination,
+  CursorPaginationModeConfig,
+  OffsetPaginationModeConfig,
   useCreateCollection,
 } from '@wix/bex-core/react';
 import { GridState } from '../state';
 import { useOptionalCachedState } from './useOptionalCachedState';
 
-export type GridCollection = <T, F extends FiltersMap = OptionalFiltersMap>(
-  config: CollectionConfigWithConditionals<T, F>,
-) => GridState<T, F>;
+// One overload per pagination branch: see `PaginationModeConfig`.
+export type GridCollection = {
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: CollectionConfigWithoutPagination<T, F> &
+      CursorPaginationModeConfig<T, F>,
+  ): GridState<T, F>;
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: CollectionConfigWithoutPagination<T, F> &
+      OffsetPaginationModeConfig<T, F>,
+  ): GridState<T, F>;
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: CollectionConfigWithConditionals<T, F>,
+  ): GridState<T, F>;
+};
 
 export const useGridCollection: GridCollection = <
   T,

package/src/hooks/useLayoutSwitchCollection.ts

@@ -3,6 +3,9 @@ import {
   useWixPatternsContainer,
   useWixPatternsContainerOverrides,
   CollectionConfigWithConditionals,
+  CollectionConfigWithoutPagination,
+  CursorPaginationModeConfig,
+  OffsetPaginationModeConfig,
   useCreateCollection,
   useCreateOptimisticActions,
 } from '@wix/bex-core/react';
@@ -19,7 +22,9 @@ import { useOptionalCachedState } from './useOptionalCachedState';
 export type LayoutSwitchCollectionConfig<
   T,
   F extends FiltersMap,
-> = CollectionConfigWithConditionals<T, F> & {
+> = CollectionConfigWithConditionals<T, F> & LayoutSwitchOptions<T, F>;
+
+type LayoutSwitchOptions<T, F extends FiltersMap> = {
   table?: TableLayoutConfig;
   grid?: GridLayoutConfig;
   spreadsheet?: Omit<SpreadsheetLayoutConfig<T, F>, 'createOptimisticActions'>;
@@ -30,7 +35,24 @@ export type LayoutSwitchCollectionConfig<
   defaultViewType?: ViewType;
 };
 
-export const useLayoutSwitchCollection = <
+// One overload per pagination branch: see `PaginationModeConfig`.
+type LayoutSwitchCollection = {
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: CollectionConfigWithoutPagination<T, F> &
+      LayoutSwitchOptions<T, F> &
+      CursorPaginationModeConfig<T, F>,
+  ): LayoutSwitchState<T, F>;
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: CollectionConfigWithoutPagination<T, F> &
+      LayoutSwitchOptions<T, F> &
+      OffsetPaginationModeConfig<T, F>,
+  ): LayoutSwitchState<T, F>;
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: LayoutSwitchCollectionConfig<T, F>,
+  ): LayoutSwitchState<T, F>;
+};
+
+export const useLayoutSwitchCollection: LayoutSwitchCollection = <
   T,
   F extends FiltersMap = OptionalFiltersMap,
 >(

package/src/hooks/usePickerModal/usePickerModalState.ts

@@ -1,6 +1,9 @@
 import { useCallback, useEffect, useState } from 'react';
 import type { FiltersMap, OptionalFiltersMap } from '@wix/bex-core';
-import { CursorFetchDataFn, OffsetFetchDataFn } from '@wix/bex-core/react';
+import {
+  CursorPaginationModeConfig,
+  OffsetPaginationModeConfig,
+} from '@wix/bex-core/react';
 import { UsePickerModalParamsBase } from './UsePickerModalParamsBase';
 import { PickerModalState } from './PickerModalState';
 import { configure } from '@wix/bex-utils/react-dom';
@@ -8,25 +11,33 @@ import { version as cairoVersion } from '../../version';
 
 configure();
 
-type PaginationModeConfig<T, F extends FiltersMap> =
-  | {
-      paginationMode?: 'offset';
-      fetchData: OffsetFetchDataFn<T, F>;
-    }
-  | {
-      paginationMode: 'cursor';
-      fetchData: CursorFetchDataFn<T, F>;
-    };
-
-export type UsePickerModalParams<T, F extends FiltersMap> = Omit<
+type ParamsWithoutPagination<T, F extends FiltersMap> = Omit<
   UsePickerModalParamsBase<T, F>,
   'paginationMode' | 'fetchData'
-> &
-  PaginationModeConfig<T, F>;
+>;
+
+type CursorParams<T, F extends FiltersMap> = ParamsWithoutPagination<T, F> &
+  Omit<CursorPaginationModeConfig<T, F>, 'fetchTotal'>;
+
+type OffsetParams<T, F extends FiltersMap> = ParamsWithoutPagination<T, F> &
+  OffsetPaginationModeConfig<T, F>;
 
-export type PikerModalFactory = <T, F extends FiltersMap = OptionalFiltersMap>(
-  config: UsePickerModalParams<T, F>,
-) => PickerModalState<T, F>;
+export type UsePickerModalParams<T, F extends FiltersMap> =
+  | OffsetParams<T, F>
+  | CursorParams<T, F>;
+
+// One overload per pagination branch: see `PaginationModeConfig` in bex-core.
+export type PikerModalFactory = {
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: CursorParams<T, F>,
+  ): PickerModalState<T, F>;
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: OffsetParams<T, F>,
+  ): PickerModalState<T, F>;
+  <T, F extends FiltersMap = OptionalFiltersMap>(
+    config: UsePickerModalParams<T, F>,
+  ): PickerModalState<T, F>;
+};
 
 export function useCreatePickerModalState(): PikerModalFactory {
   return useCallback<PikerModalFactory>(
@@ -82,6 +93,18 @@ export function useSyncPickerModalProps<
   }, [disableAutoSelectOnSingleItem]);
 }
 
+export function usePickerModalState<
+  T,
+  F extends FiltersMap = OptionalFiltersMap,
+>(params: CursorParams<T, F>): PickerModalState<T, F>;
+export function usePickerModalState<
+  T,
+  F extends FiltersMap = OptionalFiltersMap,
+>(params: OffsetParams<T, F>): PickerModalState<T, F>;
+export function usePickerModalState<
+  T,
+  F extends FiltersMap = OptionalFiltersMap,
+>(params: UsePickerModalParams<T, F>): PickerModalState<T, F>;
 export function usePickerModalState<
   T,
   F extends FiltersMap = OptionalFiltersMap,

package/src/hooks/usePickerStandalone/usePickerStandalone.spec.tsx

@@ -84,7 +84,8 @@ describe('usePickerStandalone', () => {
         fetchData: async () => ({
           items: [] as { id2: string; name2: string }[],
         }),
-        itemName: (item) => item.name2,
+        // Annotated: a call that matches no overload leaves `item` as `unknown`.
+        itemName: (item: { id2: string; name2: string }) => item.name2,
         fetchErrorMessage: () => null,
         defaultDestinationUrl: `https://manage.wix.com`,
       });
@@ -114,7 +115,8 @@ describe('usePickerStandalone', () => {
         fetchData: async () => ({
           items: [] as { id2: string; name2: string }[],
         }),
-        itemKey: (item) => item.id2,
+        // Annotated: a call that matches no overload leaves `item` as `unknown`.
+        itemKey: (item: { id2: string; name2: string }) => item.id2,
         fetchErrorMessage: () => null,
         defaultDestinationUrl: `https://manage.wix.com`,
         noItemsAvailableDestinationUrl: 'https://wix.com',