@cloud-ru/ds-list 2.2.10-preview-5c9b8135.0 → 2.3.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 2.3.0 (2026-10-05)
+
+### Features
+
+- **FF-9204:** add disableSpanWrapper prop ([2f4bc67](https://github.com/cloud-ru-tech/snack-v2/commit/2f4bc675bb984f18c788913dd8f5136cd4be3ed9))
+
 ## 2.2.9 (2026-10-02)
 
 **Note:** Version bump only for package @ds/list

package/README.md

@@ -953,6 +953,7 @@ export function DroplistWithHeader() {
 | `data-test-id` | `string` | — |  |
 | `dataError` | `boolean` | — | Загрузка данных завершилась ошибкой: показывается `errorDataState` |
 | `dataFiltered` | `boolean` | — | Текущий пустой список — результат поиска/фильтра: показывается `noResultsState` вместо `noDataState` |
+| `disableSpanWrapper` | `boolean` | — | Отключает для `isValidElement` внешнюю обертку триггера <br/> Пригодится для элементов с `position: absolute` <br/> Работает для триггеров, которые умеют отдать свою DOM-ноду: нативные элементы, `forwardRef`-компоненты <br/> и компоненты, помеченные `withInnerRefSupport` из `@cloud-ru/ds-utils`. Остальные всё равно получают `<span>` — <br/> без ноды поповеру не от чего считать позицию; в dev-режиме об этом печатается предупреждение. |
 | `errorDataState` | `EmptyStateProps` | — | Экран при ошибке запроса |
 | `footer` | `ReactNode ;` | — | Кастомизируемый элемент в конце списка |
 | `footerActiveElementsRefs` | `RefObject<HTMLElement>[]` | — | Список ссылок на кастомные элементы, помещенные в специальную секцию внизу списка |
@@ -969,7 +970,7 @@ export function DroplistWithHeader() {
 | `noResultsState` | `EmptyStateProps` | — | Экран при отсутствии результатов поиска или фильтров |
 | `onBackButtonClick` | `(() => void)` | — | Только mobile (`BottomSheet`): callback back-кнопки. |
 | `onOpenChange` | `((isOpen: boolean) => void)` | — | Колбек отображения компонента. Срабатывает при изменении состояния open. |
-| `onScroll` | `((event?: Event) => void)` | — | Колбек на скролл прокручиваемого списка |
+| `onScroll` | `OriginalScrollProps` | — | Колбек на скролл прокручиваемого списка |
 | `open` | `boolean` | — | Управляет состоянием показан/не показан. |
 | `pinBottom` | `BaseItemWithoutNonGroup` \| `CommonGroupItem` \| `Item` \| `ScrollProps` | — | Элементы списка, закрепленные снизу |
 | `pinTop` | `BaseItemWithoutNonGroup` \| `CommonGroupItem` \| `Item` \| `ScrollProps` | — | Элементы списка, закрепленные сверху |
@@ -1025,8 +1026,6 @@ export function DroplistWithHeader() {
 | `toggleOn` | `"expandIcon"` \| `"item"` | — | Что переключает раскрытие вложенного списка: <br/> <br> - `item` — клик по всей строке (по умолчанию), <br/> <br> - `expandIcon` — только клик по шеврону; клик по строке остаётся потребителю <br/> (например, когда `itemWrapRender` оборачивает строку в ссылку). <br/> Клавиатура (`Enter` / `Space` / `ArrowRight` на строке) раскрывает группу в обоих режимах. |
 | `value` | `ItemId` | — |  |
 
-- `CollapseToggleOn` = `"expandIcon"` \| `"item"`
-
 **CommonGroupItem**
 
 | Prop | Type | Default | Description |
@@ -1036,7 +1035,7 @@ export function DroplistWithHeader() {
 | `groupVariant` | `"subtitle"` \| `"subtitleTertiary"` | — | Визуальный стиль заголовка группы |
 | `hidden` | `boolean \| undefined` | — | Скрыть группу из списка |
 | `label` | `string \| undefined` | — | Заголовок группы |
-| `truncate` | `{ variant?: TruncateStringProps["variant"]; } \| undefined` | — | Настройки усечения длинного заголовка группы |
+| `truncate` | `TruncateStringProps` | — | Настройки усечения длинного заголовка группы |
 
 **EmptyStateProps**
 
@@ -1050,28 +1049,12 @@ export function DroplistWithHeader() {
 
 - `Item` = `BaseItem | GroupItem | GroupSelectItem | NextListItem | AccordionItem`
 
-**ItemContent**
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `caption` | `string \| undefined` | — |  |
-| `className` | `string \| undefined` | — |  |
-| `data-test-id` | `string \| undefined` | — |  |
-| `description` | `string \| undefined` | — |  |
-| `disabled` | `boolean \| undefined` | — |  |
-| `label` | `string \| number` | — |  |
-| `truncate` | `TruncateProps` | — |  |
-
-- `ItemId` = `string | number`
-
-- `OnChangeHandler` = `(value: T) => void`
-
 **ScrollProps**
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `barHideStrategy` | `"leave"` \| `"move"` \| `"never"` \| `"scroll"` | — | Управление скрытием скролл баров: <br/> <br> - `Never` - показывать всегда <br/> <br> - `Leave` - скрывать когда курсор покидает компонент <br/> <br> - `Scroll` - показывать только когда происходит скроллинг <br/> <br> - `Move` - показывать при движении курсора над компонентом |
-| `onScroll` | `((event?: Event) => void) \| undefined` | — | Колбек на скролл прокручиваемого списка |
+| `onScroll` | `OriginalScrollProps` | — | Колбек на скролл прокручиваемого списка |
 | `scroll` | `boolean \| undefined` | — | Включить ли скролл для основной части списка |
 | `scrollContainerRef` | `Ref<HTMLElement> \| undefined` | — | Ссылка на контейнер, который скроллится |
 | `scrollRef` | `Ref<HTMLElement> \| undefined` | — | Ссылка на элемент, обозначающий самый конец прокручиваемого списка |

package/dist/cjs/components/Lists/types.d.ts

@@ -133,7 +133,7 @@ type DroplistOwnProps = {
     children: ReactNode | ((params: {
         onKeyDown?: (e: KeyboardEvent<HTMLElement>) => void;
     }) => ReactNode);
-} & Pick<DropdownProps, 'trigger' | 'placement' | 'widthStrategy' | 'open' | 'onOpenChange' | 'triggerClassName' | 'closeOnPopstate'>;
+} & Pick<DropdownProps, 'trigger' | 'placement' | 'widthStrategy' | 'open' | 'onOpenChange' | 'triggerClassName' | 'disableSpanWrapper' | 'closeOnPopstate'>;
 /** Props списка, которые дроплист пробрасывает в `List` (навигацией управляет он сам). */
 type DroplistListProps<T> = Omit<T, 'tabIndex' | 'onKeyDown' | 'hasListInFocusChain' | 'keyboardNavigationRef'>;
 /** Базовые props дроплиста: собственные + props обычного `List`. */
@@ -174,7 +174,7 @@ export type DroplistImplProps = DesktopDroplistProps & DroplistMobileSlots;
  * @internal Props mobile-реализации (`BottomSheet`): реализация дроплиста без popover-пропов
  * + mobile-слоты.
  */
-export type MobileDroplistProps = Omit<DesktopDroplistProps, 'trigger' | 'placement' | 'widthStrategy' | 'triggerElemRef' | 'listRef' | 'triggerClassName'> & Pick<BottomSheetProps, 'snapPoints' | 'withDividers'> & DroplistMobileSlots;
+export type MobileDroplistProps = Omit<DesktopDroplistProps, 'trigger' | 'placement' | 'widthStrategy' | 'triggerElemRef' | 'listRef' | 'triggerClassName' | 'disableSpanWrapper'> & Pick<BottomSheetProps, 'snapPoints' | 'withDividers'> & DroplistMobileSlots;
 export type ListPrivateProps = Omit<ListImplProps, 'pinTop' | 'pinBottom' | 'items' | 'hasListInFocusChain' | 'onItemsReorder' | 'virtualized'> & {
     nested?: boolean;
     active?: boolean;

package/dist/cjs/helperComponents/DesktopDroplist/DesktopDroplist.d.ts

@@ -4,4 +4,4 @@ import { DesktopDroplistProps } from '../../components/Lists/types';
  * не реэкспортится; рендерится адаптивным `Droplist` на не-mobile раскладке. Так как вызывается
  * только на desktop-раскладке, внутренний адаптивный `Dropdown` всегда рендерит popover.
  */
-export declare function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp, pinTop: pinTopProp, footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, open: openProp, onOpenChange, collapse, triggerClassName, selection, contentRender, size, marker, closeDroplistOnItemClick, className, listRef: listRefProp, untouchableScrollbars, virtualized, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }: DesktopDroplistProps): import("react/jsx-runtime").JSX.Element;
+export declare function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp, pinTop: pinTopProp, footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, open: openProp, onOpenChange, collapse, triggerClassName, disableSpanWrapper, selection, contentRender, size, marker, closeDroplistOnItemClick, className, listRef: listRefProp, untouchableScrollbars, virtualized, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }: DesktopDroplistProps): import("react/jsx-runtime").JSX.Element;

package/dist/cjs/helperComponents/DesktopDroplist/DesktopDroplist.js

@@ -21,7 +21,7 @@ const styles_module_scss_1 = __importDefault(require('../../components/Lists/sty
  * не реэкспортится; рендерится адаптивным `Droplist` на не-mobile раскладке. Так как вызывается
  * только на desktop-раскладке, внутренний адаптивный `Dropdown` всегда рендерит popover.
  */
-function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp = [], pinTop: pinTopProp = [], footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, open: openProp, onOpenChange, collapse = {}, triggerClassName, selection, contentRender, size = constants_1.DEFAULT_SIZE, marker = true, closeDroplistOnItemClick = false, className, listRef: listRefProp, untouchableScrollbars = false, virtualized = false, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }) {
+function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp = [], pinTop: pinTopProp = [], footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, open: openProp, onOpenChange, collapse = {}, triggerClassName, disableSpanWrapper, selection, contentRender, size = constants_1.DEFAULT_SIZE, marker = true, closeDroplistOnItemClick = false, className, listRef: listRefProp, untouchableScrollbars = false, virtualized = false, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }) {
     const { hasSearch, openCollapseItems, toggleOpenCollapseItem, searchItem, flattenItems, focusFlattenItems, memorizedItems, ids, expandedIds, firstItemId, onDragEnd, sortableIds, } = (0, hooks_1.useListItemsModel)({
         items: itemsProp,
         pinTop: pinTopProp,
@@ -135,7 +135,7 @@ function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp =
                             // Divider под topBar рисуется, если явно запрошен header'ом либо когда в topBar
                             // есть поиск: строка поиска визуально отделяется от тела списка (как в PinTopGroupItem
                             // у inline-List). @cloud-ru/ds-dropdown рисует один divider на весь topBar (headline + search).
-                            headerDivider: headerDivider || hasSearch, search: searchNode, footer: footerNode, footerDivider: footerDivider, container: container, outsideClick: true, triggerClassName: triggerClassName, fallbackPlacements: constants_1.DEFAULT_FALLBACK_PLACEMENTS, trigger: trigger, placement: placement, widthStrategy: effectiveWidthStrategy, triggerRef: !triggerElemRefProp ? triggerElemRef : (isValid && triggerElemRefProp) || undefined, open: open, onOpenChange: handleOpenChange, closeOnPopstate: closeOnPopstate, 
+                            headerDivider: headerDivider || hasSearch, search: searchNode, footer: footerNode, footerDivider: footerDivider, container: container, outsideClick: true, triggerClassName: triggerClassName, disableSpanWrapper: disableSpanWrapper, fallbackPlacements: constants_1.DEFAULT_FALLBACK_PLACEMENTS, trigger: trigger, placement: placement, widthStrategy: effectiveWidthStrategy, triggerRef: !triggerElemRefProp ? triggerElemRef : (isValid && triggerElemRefProp) || undefined, open: open, onOpenChange: handleOpenChange, closeOnPopstate: closeOnPopstate, 
                             // dnd-kit (`MouseSensor`/`TouchSensor`) слушает `mouseup`/`touchend` на document
                             // в bubble-фазе — гашение этих хендлеров на floating ломает завершение drag.
                             stopPropagation: onItemsReorder ? { onMouseUp: false, onTouchEnd: false } : undefined, children: triggerElem }) }) }) }) }) }));

package/dist/esm/components/Lists/types.d.ts

@@ -133,7 +133,7 @@ type DroplistOwnProps = {
     children: ReactNode | ((params: {
         onKeyDown?: (e: KeyboardEvent<HTMLElement>) => void;
     }) => ReactNode);
-} & Pick<DropdownProps, 'trigger' | 'placement' | 'widthStrategy' | 'open' | 'onOpenChange' | 'triggerClassName' | 'closeOnPopstate'>;
+} & Pick<DropdownProps, 'trigger' | 'placement' | 'widthStrategy' | 'open' | 'onOpenChange' | 'triggerClassName' | 'disableSpanWrapper' | 'closeOnPopstate'>;
 /** Props списка, которые дроплист пробрасывает в `List` (навигацией управляет он сам). */
 type DroplistListProps<T> = Omit<T, 'tabIndex' | 'onKeyDown' | 'hasListInFocusChain' | 'keyboardNavigationRef'>;
 /** Базовые props дроплиста: собственные + props обычного `List`. */
@@ -174,7 +174,7 @@ export type DroplistImplProps = DesktopDroplistProps & DroplistMobileSlots;
  * @internal Props mobile-реализации (`BottomSheet`): реализация дроплиста без popover-пропов
  * + mobile-слоты.
  */
-export type MobileDroplistProps = Omit<DesktopDroplistProps, 'trigger' | 'placement' | 'widthStrategy' | 'triggerElemRef' | 'listRef' | 'triggerClassName'> & Pick<BottomSheetProps, 'snapPoints' | 'withDividers'> & DroplistMobileSlots;
+export type MobileDroplistProps = Omit<DesktopDroplistProps, 'trigger' | 'placement' | 'widthStrategy' | 'triggerElemRef' | 'listRef' | 'triggerClassName' | 'disableSpanWrapper'> & Pick<BottomSheetProps, 'snapPoints' | 'withDividers'> & DroplistMobileSlots;
 export type ListPrivateProps = Omit<ListImplProps, 'pinTop' | 'pinBottom' | 'items' | 'hasListInFocusChain' | 'onItemsReorder' | 'virtualized'> & {
     nested?: boolean;
     active?: boolean;

package/dist/esm/helperComponents/DesktopDroplist/DesktopDroplist.d.ts

@@ -4,4 +4,4 @@ import { DesktopDroplistProps } from '../../components/Lists/types.js';
  * не реэкспортится; рендерится адаптивным `Droplist` на не-mobile раскладке. Так как вызывается
  * только на desktop-раскладке, внутренний адаптивный `Dropdown` всегда рендерит popover.
  */
-export declare function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp, pinTop: pinTopProp, footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, open: openProp, onOpenChange, collapse, triggerClassName, selection, contentRender, size, marker, closeDroplistOnItemClick, className, listRef: listRefProp, untouchableScrollbars, virtualized, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }: DesktopDroplistProps): import("react/jsx-runtime").JSX.Element;
+export declare function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp, pinTop: pinTopProp, footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, open: openProp, onOpenChange, collapse, triggerClassName, disableSpanWrapper, selection, contentRender, size, marker, closeDroplistOnItemClick, className, listRef: listRefProp, untouchableScrollbars, virtualized, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }: DesktopDroplistProps): import("react/jsx-runtime").JSX.Element;

package/dist/esm/helperComponents/DesktopDroplist/DesktopDroplist.js

@@ -15,7 +15,7 @@ import styles from '../../components/Lists/styles.module.css';
  * не реэкспортится; рендерится адаптивным `Droplist` на не-mobile раскладке. Так как вызывается
  * только на desktop-раскладке, внутренний адаптивный `Dropdown` всегда рендерит popover.
  */
-export function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp = [], pinTop: pinTopProp = [], footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, open: openProp, onOpenChange, collapse = {}, triggerClassName, selection, contentRender, size = DEFAULT_SIZE, marker = true, closeDroplistOnItemClick = false, className, listRef: listRefProp, untouchableScrollbars = false, virtualized = false, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }) {
+export function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottomProp = [], pinTop: pinTopProp = [], footerActiveElementsRefs, children, trigger, placement, widthStrategy, triggerElemRef: triggerElemRefProp, container, open: openProp, onOpenChange, collapse = {}, triggerClassName, disableSpanWrapper, selection, contentRender, size = DEFAULT_SIZE, marker = true, closeDroplistOnItemClick = false, className, listRef: listRefProp, untouchableScrollbars = false, virtualized = false, closeOnPopstate, header, headerDivider, footer, footerDivider, onItemsReorder, ...props }) {
     const { hasSearch, openCollapseItems, toggleOpenCollapseItem, searchItem, flattenItems, focusFlattenItems, memorizedItems, ids, expandedIds, firstItemId, onDragEnd, sortableIds, } = useListItemsModel({
         items: itemsProp,
         pinTop: pinTopProp,
@@ -129,7 +129,7 @@ export function DesktopDroplist({ items: itemsProp, search, pinBottom: pinBottom
                             // Divider под topBar рисуется, если явно запрошен header'ом либо когда в topBar
                             // есть поиск: строка поиска визуально отделяется от тела списка (как в PinTopGroupItem
                             // у inline-List). @cloud-ru/ds-dropdown рисует один divider на весь topBar (headline + search).
-                            headerDivider: headerDivider || hasSearch, search: searchNode, footer: footerNode, footerDivider: footerDivider, container: container, outsideClick: true, triggerClassName: triggerClassName, fallbackPlacements: DEFAULT_FALLBACK_PLACEMENTS, trigger: trigger, placement: placement, widthStrategy: effectiveWidthStrategy, triggerRef: !triggerElemRefProp ? triggerElemRef : (isValid && triggerElemRefProp) || undefined, open: open, onOpenChange: handleOpenChange, closeOnPopstate: closeOnPopstate, 
+                            headerDivider: headerDivider || hasSearch, search: searchNode, footer: footerNode, footerDivider: footerDivider, container: container, outsideClick: true, triggerClassName: triggerClassName, disableSpanWrapper: disableSpanWrapper, fallbackPlacements: DEFAULT_FALLBACK_PLACEMENTS, trigger: trigger, placement: placement, widthStrategy: effectiveWidthStrategy, triggerRef: !triggerElemRefProp ? triggerElemRef : (isValid && triggerElemRefProp) || undefined, open: open, onOpenChange: handleOpenChange, closeOnPopstate: closeOnPopstate, 
                             // dnd-kit (`MouseSensor`/`TouchSensor`) слушает `mouseup`/`touchend` на document
                             // в bubble-фазе — гашение этих хендлеров на floating ломает завершение drag.
                             stopPropagation: onItemsReorder ? { onMouseUp: false, onTouchEnd: false } : undefined, children: triggerElem }) }) }) }) }) }));