@cloud-ru/ds-list 2.3.3 → 2.3.4

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.4 (2026-10-09)
+
+### Bug Fixes
+
+- **FF-9216:** value selection ([818fa8c](https://github.com/cloud-ru-tech/snack-v2/commit/818fa8ca8730ba81e31cd7f0ca2c7493652592e1))
+
 ## 2.3.3 (2026-10-09)
 
 **Note:** Version bump only for package @ds/list

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

@@ -1,17 +1,18 @@
 import { KeyboardEvent } from 'react';
+import { Item } from '../../Items';
 /** Список айтемов: base / collapse / group / next-list, с опциональной виртуализацией. */
 export declare const List: import("react").ForwardRefExoticComponent<{
     'data-test-id'?: string;
 } & import("react").AriaAttributes & {
-    pinTop?: import("../..").Item[];
-    pinBottom?: import("../..").Item[];
+    pinTop?: Item[];
+    pinBottom?: Item[];
     footer?: import("react").ReactNode;
     header?: import("react").ReactNode;
     headerDivider?: boolean;
     footerDivider?: boolean;
     footerActiveElementsRefs?: import("react").RefObject<HTMLElement>[];
     keyboardNavigationRef?: import("react").RefObject<{
-        focusItem(id: import("../..").ItemId): void;
+        focusItem(id: import("../../Items").ItemId): void;
     }>;
     search?: import("../../..").SearchState;
     tabIndex?: number;
@@ -24,7 +25,7 @@ export declare const List: import("react").ForwardRefExoticComponent<{
     scrollContainerClassName?: string;
     limitedScrollHeight?: boolean;
 } & import("../contexts").SelectionState & Omit<import("../contexts").PublicListContextType, "virtualized"> & import("../../..").ScrollProps & import("../types").EmptyState & {
-    items: import("../..").Item[];
+    items: Item[];
     virtualized?: boolean;
 } & import("react").RefAttributes<HTMLElement>>;
 /**
@@ -35,15 +36,15 @@ export declare const List: import("react").ForwardRefExoticComponent<{
 export declare const ReorderableList: import("react").ForwardRefExoticComponent<{
     'data-test-id'?: string;
 } & import("react").AriaAttributes & {
-    pinTop?: import("../..").Item[];
-    pinBottom?: import("../..").Item[];
+    pinTop?: Item[];
+    pinBottom?: Item[];
     footer?: import("react").ReactNode;
     header?: import("react").ReactNode;
     headerDivider?: boolean;
     footerDivider?: boolean;
     footerActiveElementsRefs?: import("react").RefObject<HTMLElement>[];
     keyboardNavigationRef?: import("react").RefObject<{
-        focusItem(id: import("../..").ItemId): void;
+        focusItem(id: import("../../Items").ItemId): void;
     }>;
     search?: import("../../..").SearchState;
     tabIndex?: number;
@@ -56,6 +57,6 @@ export declare const ReorderableList: import("react").ForwardRefExoticComponent<
     scrollContainerClassName?: string;
     limitedScrollHeight?: boolean;
 } & import("../contexts").SelectionState & Omit<import("../contexts").PublicListContextType, "virtualized"> & import("../../..").ScrollProps & import("../types").EmptyState & {
-    items: import("../..").ReorderItem[];
-    onItemsReorder(items: import("../..").ReorderItem[]): void;
+    items: import("../../Items").ReorderItem[];
+    onItemsReorder(items: import("../../Items").ReorderItem[]): void;
 } & import("react").RefAttributes<HTMLElement>>;

package/dist/cjs/components/Lists/List/List.js

@@ -15,7 +15,8 @@ const contexts_1 = require("../contexts");
 const hooks_1 = require("../hooks");
 const ListPrivate_1 = require("../ListPrivate");
 const styles_module_scss_1 = __importDefault(require('../styles.module.css'));
-const ListImpl = (0, react_1.forwardRef)(({ items: itemsProp = [], search, pinBottom: pinBottomProp = [], pinTop: pinTopProp = [], footerActiveElementsRefs, onKeyDown, tabIndex = 0, className, collapse = {}, selection, contentRender, size = constants_1.DEFAULT_SIZE, marker = true, keyboardNavigationRef, hasListInFocusChain = true, onItemsReorder, ...props }, ref) => {
+const EMPTY_ITEMS = [];
+const ListImpl = (0, react_1.forwardRef)(({ items: itemsProp = EMPTY_ITEMS, search, pinBottom: pinBottomProp = EMPTY_ITEMS, pinTop: pinTopProp = EMPTY_ITEMS, footerActiveElementsRefs, onKeyDown, tabIndex = 0, className, collapse = {}, selection, contentRender, size = constants_1.DEFAULT_SIZE, marker = true, keyboardNavigationRef, hasListInFocusChain = true, onItemsReorder, ...props }, ref) => {
     const { openCollapseItems, toggleOpenCollapseItem, searchItem, flattenItems, focusFlattenItems, memorizedItems, ids, expandedIds, firstItemId, onDragEnd, sortableIds, } = (0, hooks_1.useListItemsModel)({
         items: itemsProp,
         pinTop: pinTopProp,

package/dist/cjs/components/Lists/ListPrivate/ListPrivate.js

@@ -92,6 +92,7 @@ exports.ListPrivate = (0, react_1.forwardRef)(({ items, pinTop, pinBottom, onKey
     // fixed` у `DragOverlay` остаётся относительно вьюпорта (в т.ч. внутри popover-Droplist).
     const portalRoot = (0, portal_context_1.usePortalContext)();
     const innerScrollRef = (0, react_1.useRef)(null);
+    const lastCenteredItemRef = (0, react_1.useRef)(null);
     // `@cloud-ru/ds-scroll` (OverlayScrollbars) разрешает свой ref в viewport-элемент только после
     // инициализации инстанса. До этого `innerScrollRef.current` === null, и виртуализатор
     // не получает scroll-элемент → рендерит пустой контейнер. Флаг поднимается из
@@ -110,11 +111,11 @@ exports.ListPrivate = (0, react_1.forwardRef)(({ items, pinTop, pinBottom, onKey
             selectedItemIndex: -1,
             selectedItem: undefined,
         };
-        if (!scrollToSelectedItem || !value) {
+        if (!scrollToSelectedItem || (0, utils_1.isNil)(value)) {
             return result;
         }
         const selectedItem = isSelectionSingle ? flattenItems[value] : flattenItems[value[0]];
-        if (!selectedItem?.id) {
+        if (!selectedItem || (0, utils_1.isNil)(selectedItem.id)) {
             return result;
         }
         const allFocusFlattenItems = Object.values(focusFlattenItems);
@@ -223,7 +224,8 @@ exports.ListPrivate = (0, react_1.forwardRef)(({ items, pinTop, pinBottom, onKey
     // ведут эффекты выше через виртуализатор, поэтому здесь только `!virtualized`. Хелпер тот
     // же `centerItemInScrollContainer` — обычному листу отдельный виртуализатор не нужен.
     (0, react_1.useEffect)(() => {
-        if (virtualized || !scroll || !scrollToSelectedItem || !scrollElementReady) {
+        if (virtualized || !scroll || !scrollToSelectedItem || !scrollElementReady || !selectedItem) {
+            lastCenteredItemRef.current = null;
             return;
         }
         const container = innerScrollRef.current;
@@ -231,7 +233,12 @@ exports.ListPrivate = (0, react_1.forwardRef)(({ items, pinTop, pinBottom, onKey
         if (!container || !item) {
             return;
         }
+        if (lastCenteredItemRef.current?.id === selectedItem.originalId &&
+            lastCenteredItemRef.current.container === container) {
+            return;
+        }
         centerItemInScrollContainer(container, item);
+        lastCenteredItemRef.current = { id: selectedItem.originalId, container };
     }, [virtualized, scroll, scrollToSelectedItem, scrollElementReady, selectedItem]);
     const loadingJSX = (0, react_1.useMemo)(() => loading && ((0, jsx_runtime_1.jsx)("div", { role: 'status', tabIndex: -1, className: styles_module_scss_2.default.loader, "data-size": size, "data-no-items": hasNoItems || undefined, "data-test-id": constants_1.TEST_IDS.loader, children: (0, jsx_runtime_1.jsx)(loader_1.Spinner, { size: constants_2.SPINNER_SIZE_MAP[size] }) })), [hasNoItems, loading, size]);
     const content = (0, react_1.useMemo)(() => {

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

@@ -1,10 +1,11 @@
 import { KeyboardEvent } from 'react';
+import { Item } from '../../Items/index.js';
 /** Список айтемов: base / collapse / group / next-list, с опциональной виртуализацией. */
 export declare const List: import("react").ForwardRefExoticComponent<{
     'data-test-id'?: string;
 } & import("react").AriaAttributes & {
-    pinTop?: import("../..").Item[];
-    pinBottom?: import("../..").Item[];
+    pinTop?: Item[];
+    pinBottom?: Item[];
     footer?: import("react").ReactNode;
     header?: import("react").ReactNode;
     headerDivider?: boolean;
@@ -24,7 +25,7 @@ export declare const List: import("react").ForwardRefExoticComponent<{
     scrollContainerClassName?: string;
     limitedScrollHeight?: boolean;
 } & import("..").SelectionState & Omit<import("..").PublicListContextType, "virtualized"> & import("../../..").ScrollProps & import("..").EmptyState & {
-    items: import("../..").Item[];
+    items: Item[];
     virtualized?: boolean;
 } & import("react").RefAttributes<HTMLElement>>;
 /**
@@ -35,8 +36,8 @@ export declare const List: import("react").ForwardRefExoticComponent<{
 export declare const ReorderableList: import("react").ForwardRefExoticComponent<{
     'data-test-id'?: string;
 } & import("react").AriaAttributes & {
-    pinTop?: import("../..").Item[];
-    pinBottom?: import("../..").Item[];
+    pinTop?: Item[];
+    pinBottom?: Item[];
     footer?: import("react").ReactNode;
     header?: import("react").ReactNode;
     headerDivider?: boolean;

package/dist/esm/components/Lists/List/List.js

@@ -9,7 +9,8 @@ import { CollapseContext, FocusListContext, NewListContextProvider, SelectionPro
 import { useListItemsModel, useNewKeyboardNavigation } from '../hooks.js';
 import { ListPrivate } from '../ListPrivate/index.js';
 import styles from '../styles.module.css';
-const ListImpl = forwardRef(({ items: itemsProp = [], search, pinBottom: pinBottomProp = [], pinTop: pinTopProp = [], footerActiveElementsRefs, onKeyDown, tabIndex = 0, className, collapse = {}, selection, contentRender, size = DEFAULT_SIZE, marker = true, keyboardNavigationRef, hasListInFocusChain = true, onItemsReorder, ...props }, ref) => {
+const EMPTY_ITEMS = [];
+const ListImpl = forwardRef(({ items: itemsProp = EMPTY_ITEMS, search, pinBottom: pinBottomProp = EMPTY_ITEMS, pinTop: pinTopProp = EMPTY_ITEMS, footerActiveElementsRefs, onKeyDown, tabIndex = 0, className, collapse = {}, selection, contentRender, size = DEFAULT_SIZE, marker = true, keyboardNavigationRef, hasListInFocusChain = true, onItemsReorder, ...props }, ref) => {
     const { openCollapseItems, toggleOpenCollapseItem, searchItem, flattenItems, focusFlattenItems, memorizedItems, ids, expandedIds, firstItemId, onDragEnd, sortableIds, } = useListItemsModel({
         items: itemsProp,
         pinTop: pinTopProp,

package/dist/esm/components/Lists/ListPrivate/ListPrivate.js

@@ -4,7 +4,7 @@ import { SortableContext, sortableKeyboardCoordinates, verticalListSortingStrate
 import { Spinner } from '@cloud-ru/ds-loader';
 import { usePortalContext } from '@cloud-ru/ds-portal-context';
 import { Scroll } from '@cloud-ru/ds-scroll';
-import { extractSupportProps, isBrowser, useLayoutEffect } from '@cloud-ru/ds-utils';
+import { extractSupportProps, isBrowser, isNil, useLayoutEffect } from '@cloud-ru/ds-utils';
 import { useVirtualizer } from '@tanstack/react-virtual';
 import cn from 'classnames';
 import mergeRefs from 'merge-refs';
@@ -86,6 +86,7 @@ export const ListPrivate = forwardRef(({ items, pinTop, pinBottom, onKeyDown, on
     // fixed` у `DragOverlay` остаётся относительно вьюпорта (в т.ч. внутри popover-Droplist).
     const portalRoot = usePortalContext();
     const innerScrollRef = useRef(null);
+    const lastCenteredItemRef = useRef(null);
     // `@cloud-ru/ds-scroll` (OverlayScrollbars) разрешает свой ref в viewport-элемент только после
     // инициализации инстанса. До этого `innerScrollRef.current` === null, и виртуализатор
     // не получает scroll-элемент → рендерит пустой контейнер. Флаг поднимается из
@@ -104,11 +105,11 @@ export const ListPrivate = forwardRef(({ items, pinTop, pinBottom, onKeyDown, on
             selectedItemIndex: -1,
             selectedItem: undefined,
         };
-        if (!scrollToSelectedItem || !value) {
+        if (!scrollToSelectedItem || isNil(value)) {
             return result;
         }
         const selectedItem = isSelectionSingle ? flattenItems[value] : flattenItems[value[0]];
-        if (!selectedItem?.id) {
+        if (!selectedItem || isNil(selectedItem.id)) {
             return result;
         }
         const allFocusFlattenItems = Object.values(focusFlattenItems);
@@ -217,7 +218,8 @@ export const ListPrivate = forwardRef(({ items, pinTop, pinBottom, onKeyDown, on
     // ведут эффекты выше через виртуализатор, поэтому здесь только `!virtualized`. Хелпер тот
     // же `centerItemInScrollContainer` — обычному листу отдельный виртуализатор не нужен.
     useEffect(() => {
-        if (virtualized || !scroll || !scrollToSelectedItem || !scrollElementReady) {
+        if (virtualized || !scroll || !scrollToSelectedItem || !scrollElementReady || !selectedItem) {
+            lastCenteredItemRef.current = null;
             return;
         }
         const container = innerScrollRef.current;
@@ -225,7 +227,12 @@ export const ListPrivate = forwardRef(({ items, pinTop, pinBottom, onKeyDown, on
         if (!container || !item) {
             return;
         }
+        if (lastCenteredItemRef.current?.id === selectedItem.originalId &&
+            lastCenteredItemRef.current.container === container) {
+            return;
+        }
         centerItemInScrollContainer(container, item);
+        lastCenteredItemRef.current = { id: selectedItem.originalId, container };
     }, [virtualized, scroll, scrollToSelectedItem, scrollElementReady, selectedItem]);
     const loadingJSX = useMemo(() => loading && (_jsx("div", { role: 'status', tabIndex: -1, className: styles.loader, "data-size": size, "data-no-items": hasNoItems || undefined, "data-test-id": TEST_IDS.loader, children: _jsx(Spinner, { size: SPINNER_SIZE_MAP[size] }) })), [hasNoItems, loading, size]);
     const content = useMemo(() => {