@douyinfe/semi-foundation 2.97.0 → 2.98.0

package/slider/rtl.scss

@@ -0,0 +1,62 @@
+$module: #{$prefix}-slider;
+
+// RTL support (horizontal)
+// Slider uses `left` positioning in LTR. In RTL we switch to `right` positioning
+// in the component logic, so centering transforms must be mirrored.
+.#{$prefix}-rtl,
+.#{$prefix}-portal-rtl {
+    .#{$module} {
+        direction: rtl;
+
+        &-handle {
+            transform: $transform_scale-slider_handle translateX(50%) translateY($spacing-slider_handle-translateY);
+        }
+
+        &-mark {
+            transform: translate(50%, 0);
+        }
+
+        &-mark-reverse {
+            transform: translate(50%, 0) rotate(-180deg);
+        }
+
+        // Boundary text should match RTL direction: min on the right, max on the left
+
+        &-boundary-min {
+            left: auto;
+            right: $spacing-slider_boundary_min-left;
+        }
+
+        &-boundary-max {
+            right: auto;
+            left: $spacing-slider_boundary_max-right;
+        }
+    }
+}
+
+// Backward/explicit support: the component may add `semi-slider-rtl` on wrapper.
+// Keep these rules so RTL transforms still apply even without `.semi-rtl` container.
+
+.#{$module}-rtl {
+    .#{$module}-handle {
+        transform: $transform_scale-slider_handle translateX(50%) translateY($spacing-slider_handle-translateY);
+    }
+
+    .#{$module}-mark {
+        transform: translate(50%, 0);
+    }
+
+    .#{$module}-mark-reverse {
+        transform: translate(50%, 0) rotate(-180deg);
+    }
+
+    .#{$module}-boundary-min {
+        left: auto;
+        right: $spacing-slider_boundary_min-left;
+    }
+
+    .#{$module}-boundary-max {
+        right: auto;
+        left: $spacing-slider_boundary_max-right;
+    }
+}

package/slider/slider.scss

@@ -252,3 +252,5 @@ $module: #{$prefix}-slider;
 .#{$module}-reverse {
     transform: rotate(180deg);
 }
+
+@import "./rtl.scss";

package/table/foundation.ts

@@ -21,6 +21,13 @@ import BaseFoundation, { DefaultAdapter } from '../base/foundation';
 import { strings, numbers } from './constants';
 import { mergeQueries, flattenColumns, filterColumns } from './utils';
 import { pullAll, withOrderSort } from '../utils/array';
+import {
+    convertDataToEntities,
+    calcCheckedKeys,
+    calcCheckedKeysForChecked,
+    calcCheckedKeysForUnchecked,
+    findDescendantKeys,
+} from '../tree/treeUtil';
 
 export interface BaseColumnProps<RecordType> {
     align?: BaseAlign;
@@ -78,8 +85,11 @@ export interface TableAdapter<RecordType> extends DefaultAdapter {
     setFlattenData: (flattenData: RecordType[]) => void;
     setAllRowKeys: (allRowKeys: BaseRowKeyType[]) => void;
     setHoveredRowKey: (hoveredRowKey: BaseRowKeyType) => void;
+    setHoveredRowKeys: (hoveredRowKeys: BaseRowKeyType[]) => void;
     setCachedFilteredSortedDataSource: (filteredSortedDataSource: RecordType[]) => void;
     setCachedFilteredSortedRowKeys: (filteredSortedRowKeys: BaseRowKeyType[]) => void;
+    setHalfCheckedRowKeys: (halfCheckedRowKeys: BaseRowKeyType[]) => void;
+    setKeyEntities: (keyEntities: BaseEntitys) => void;
     getCurrentPage: () => number;
     getCurrentPageSize: () => number;
     getCachedFilteredSortedDataSource: () => RecordType[];
@@ -88,6 +98,9 @@ export interface TableAdapter<RecordType> extends DefaultAdapter {
     setAllDisabledRowKeys: (allDisabledRowKeys: BaseRowKeyType[]) => void;
     getAllDisabledRowKeys: () => BaseRowKeyType[];
     getAllDisabledRowKeysSet: () => Set<BaseRowKeyType>;
+    getHalfCheckedRowKeys: () => BaseRowKeyType[];
+    getHalfCheckedRowKeysSet: () => Set<BaseRowKeyType>;
+    getKeyEntities: () => BaseEntitys;
     notifyFilterDropdownVisibleChange: (visible: boolean, dataIndex: string) => void;
     notifyChange: (changeInfo: { pagination: BasePagination; filters: BaseChangeInfoFilter<RecordType>[]; sorter: BaseChangeInfoSorter<RecordType>; extra: OnChangeExtra }) => void;
     notifyExpand: (expanded?: boolean, record?: BaseIncludeGroupRecord<RecordType>, mouseEvent?: any) => void;
@@ -107,7 +120,8 @@ export interface TableAdapter<RecordType> extends DefaultAdapter {
     getHandleColumns: () => (queries: BaseColumnProps<RecordType>[], cachedColumns: BaseColumnProps<RecordType>[]) => BaseColumnProps<RecordType>[];
     getMergePagination: () => (pagination: BasePagination) => BasePagination;
     setBodyHasScrollbar: (bodyHasScrollBar: boolean) => void;
-    getTableLayout: () => 'fixed' | 'auto'
+    getTableLayout: () => 'fixed' | 'auto';
+    getCheckRelation: () => CheckRelation
 }
 
 class TableFoundation<RecordType> extends BaseFoundation<TableAdapter<RecordType>> {
@@ -756,30 +770,118 @@ class TableFoundation<RecordType> extends BaseFoundation<TableAdapter<RecordType
         return !(Array.isArray(dataSource) && dataSource.length > 0);
     }
 
+    /**
+     * Build tree data entities for checkRelation
+     * @param dataSource 
+     * @returns keyEntities map
+     */
+    buildKeyEntities(dataSource?: RecordType[]): BaseEntitys {
+        dataSource = dataSource == null ? this._getDataSource() : dataSource;
+        const childrenRecordName = this.getProp('childrenRecordName');
+        const rowKey = this.getProp('rowKey');
+        
+        // Convert table data to tree data format
+        const convertToTreeData = (data: RecordType[]): any[] => {
+            return data.map(record => {
+                const key = typeof rowKey === 'function' ? rowKey(record) : get(record, rowKey);
+                const children = get(record, childrenRecordName);
+                const node: any = { key, ...record };
+                if (Array.isArray(children) && children.length) {
+                    node.children = convertToTreeData(children);
+                }
+                return node;
+            });
+        };
+
+        const treeData = convertToTreeData(dataSource);
+        const { keyEntities } = convertDataToEntities(treeData, { key: 'key', children: 'children' });
+        return keyEntities;
+    }
+
+    /**
+     * Calculate checked keys when checkRelation is 'related'
+     * @param realKey 
+     * @param selected 
+     * @param checkedKeys 
+     * @param halfCheckedKeys 
+     */
+    calcCheckedKeysForSelect(realKey: BaseRowKeyType, selected: boolean, checkedKeys: Set<string>, halfCheckedKeys: Set<string>) {
+        const keyEntities = this._adapter.getKeyEntities();
+        const keyStr = String(realKey);
+        
+        // If keyEntities doesn't contain this key, handle it as a simple add/remove
+        if (!keyEntities || !keyEntities[keyStr]) {
+            if (selected) {
+                checkedKeys.add(keyStr);
+            } else {
+                checkedKeys.delete(keyStr);
+            }
+            return { checkedKeys, halfCheckedKeys };
+        }
+        
+        if (selected) {
+            return calcCheckedKeysForChecked(keyStr, keyEntities, checkedKeys, halfCheckedKeys);
+        } else {
+            return calcCheckedKeysForUnchecked(keyStr, keyEntities, checkedKeys, halfCheckedKeys);
+        }
+    }
+
     handleSelectRow(realKey: BaseRowKeyType, selected: boolean, e: any) {
         this.stopPropagation(e);
         if (typeof selected === 'boolean' && realKey != null) {
+            const checkRelation = this._adapter.getCheckRelation();
             const selectedRowKeys = this._getSelectedRowKeys();
+            const halfCheckedRowKeys = [...(this._adapter.getHalfCheckedRowKeys() || [])];
             let foundIdx = -1;
             const selectedRow = this.getSelectedRows(null, [realKey])[0];
             let selectedRows: BaseIncludeGroupRecord<RecordType>[];
 
-            if ((foundIdx = selectedRowKeys.indexOf(realKey)) > -1 && selected === false) {
-                selectedRowKeys.splice(foundIdx, 1);
-                selectedRows = this.getSelectedRows(null, selectedRowKeys);
+            if (checkRelation === 'related') {
+                // When checkRelation is 'related', use tree selection logic
+                const keyEntities = this._adapter.getKeyEntities();
+                // Convert keys to strings for tree utility functions
+                const checkedKeysSet = new Set(selectedRowKeys.map(key => String(key)));
+                const halfCheckedKeysSet = new Set(halfCheckedRowKeys.map(key => String(key)));
+                
+                const { checkedKeys, halfCheckedKeys } = this.calcCheckedKeysForSelect(
+                    String(realKey), 
+                    selected, 
+                    checkedKeysSet, 
+                    halfCheckedKeysSet
+                );
+                
+                const newSelectedRowKeys = [...checkedKeys];
+                const newHalfCheckedRowKeys = [...halfCheckedKeys];
+                selectedRows = this.getSelectedRows(null, newSelectedRowKeys);
+                
+                // Always update halfCheckedRowKeys state for checkRelation='related' mode
+                // This is needed for rendering the half-checked state in the UI
+                this._adapter.setHalfCheckedRowKeys(newHalfCheckedRowKeys);
+                
                 if (!this._selectionIsControlled()) {
-                    this._adapter.setSelectedRowKeys(selectedRowKeys);
+                    this._adapter.setSelectedRowKeys(newSelectedRowKeys);
                 }
                 this._adapter.notifySelect(selectedRow, selected, selectedRows, e);
-                this._adapter.notifySelectionChange(selectedRowKeys, selectedRows);
-            } else if (selectedRowKeys.indexOf(realKey) === -1 && selected === true) {
-                selectedRowKeys.push(realKey);
-                selectedRows = this.getSelectedRows(null, selectedRowKeys);
-                if (!this._selectionIsControlled()) {
-                    this._adapter.setSelectedRowKeys(selectedRowKeys);
+                this._adapter.notifySelectionChange(newSelectedRowKeys, selectedRows);
+            } else {
+                // Original logic for unRelated mode
+                if ((foundIdx = selectedRowKeys.indexOf(realKey)) > -1 && selected === false) {
+                    selectedRowKeys.splice(foundIdx, 1);
+                    selectedRows = this.getSelectedRows(null, selectedRowKeys);
+                    if (!this._selectionIsControlled()) {
+                        this._adapter.setSelectedRowKeys(selectedRowKeys);
+                    }
+                    this._adapter.notifySelect(selectedRow, selected, selectedRows, e);
+                    this._adapter.notifySelectionChange(selectedRowKeys, selectedRows);
+                } else if (selectedRowKeys.indexOf(realKey) === -1 && selected === true) {
+                    selectedRowKeys.push(realKey);
+                    selectedRows = this.getSelectedRows(null, selectedRowKeys);
+                    if (!this._selectionIsControlled()) {
+                        this._adapter.setSelectedRowKeys(selectedRowKeys);
+                    }
+                    this._adapter.notifySelect(selectedRow, selected, selectedRows, e);
+                    this._adapter.notifySelectionChange(selectedRowKeys, selectedRows);
                 }
-                this._adapter.notifySelect(selectedRow, selected, selectedRows, e);
-                this._adapter.notifySelectionChange(selectedRowKeys, selectedRows);
             }
         }
     }
@@ -792,6 +894,7 @@ class TableFoundation<RecordType> extends BaseFoundation<TableAdapter<RecordType
     handleSelectAllRow(selected: boolean, e: any) {
         this.stopPropagation(e);
         if (typeof selected === 'boolean') {
+            const checkRelation = this._adapter.getCheckRelation();
             const curSelectedRowKeys = this._getSelectedRowKeys();
             let selectedRowKeys = [...curSelectedRowKeys];
             const selectedRowKeysSet = this._getSelectedRowKeysSet();
@@ -800,28 +903,78 @@ class TableFoundation<RecordType> extends BaseFoundation<TableAdapter<RecordType
             const disabledRowKeysSet = this._adapter.getAllDisabledRowKeysSet();
             let changedRowKeys;
 
-            // Select all, if not disabled && not in selectedRowKeys
-            if (selected) {
-                for (const key of allRowKeys) {
-                    if (!disabledRowKeysSet.has(key) && !selectedRowKeysSet.has(key)) {
-                        selectedRowKeys.push(key);
+            if (checkRelation === 'related') {
+                // When checkRelation is 'related', use tree selection logic
+                const keyEntities = this._adapter.getKeyEntities();
+                const halfCheckedRowKeys = [...(this._adapter.getHalfCheckedRowKeys() || [])];
+                // Convert keys to strings for tree utility functions
+                let checkedKeysSet = new Set(selectedRowKeys.map(key => String(key)));
+                let halfCheckedKeysSet = new Set(halfCheckedRowKeys.map(key => String(key)));
+                
+                if (selected) {
+                    // Select all: add all non-disabled keys
+                    const keysToAdd = allRowKeys.filter(key => !disabledRowKeysSet.has(key));
+                    for (const key of keysToAdd) {
+                        const keyStr = String(key);
+                        if (!checkedKeysSet.has(keyStr) && keyEntities && keyEntities[keyStr]) {
+                            const result = calcCheckedKeysForChecked(keyStr, keyEntities, checkedKeysSet, halfCheckedKeysSet);
+                            checkedKeysSet = result.checkedKeys;
+                            halfCheckedKeysSet = result.halfCheckedKeys;
+                        }
                     }
+                    changedRowKeys = keysToAdd;
+                } else {
+                    // Deselect all: remove all keys
+                    const keysToRemove = [...checkedKeysSet];
+                    for (const key of keysToRemove) {
+                        if (keyEntities && keyEntities[key]) {
+                            const result = calcCheckedKeysForUnchecked(key, keyEntities, checkedKeysSet, halfCheckedKeysSet);
+                            checkedKeysSet = result.checkedKeys;
+                            halfCheckedKeysSet = result.halfCheckedKeys;
+                        }
+                    }
+                    changedRowKeys = [...curSelectedRowKeys];
                 }
-                allRowKeys = pullAll(allRowKeys, [...disabledRowKeys, ...curSelectedRowKeys]);
-                changedRowKeys = [...allRowKeys];
+                
+                selectedRowKeys = [...checkedKeysSet];
+                const newHalfCheckedRowKeys = [...halfCheckedKeysSet];
+                const changedRows = this.getSelectedRows(null, changedRowKeys || []);
+                const selectedRows = this.getSelectedRows(null, selectedRowKeys || []);
+
+                // Always update halfCheckedRowKeys state for checkRelation='related' mode
+                // This is needed for rendering the half-checked state in the UI
+                this._adapter.setHalfCheckedRowKeys(newHalfCheckedRowKeys);
+                
+                if (!this._selectionIsControlled()) {
+                    this._adapter.setSelectedRowKeys(selectedRowKeys);
+                }
+                this._adapter.notifySelectAll(selected, selectedRows, changedRows, e);
+                this._adapter.notifySelectionChange(selectedRowKeys, selectedRows);
             } else {
-                selectedRowKeys = pullAll(selectedRowKeys, allRowKeys);
-                changedRowKeys = [...curSelectedRowKeys];
-            }
+                // Original logic for unRelated mode
+                // Select all, if not disabled && not in selectedRowKeys
+                if (selected) {
+                    for (const key of allRowKeys) {
+                        if (!disabledRowKeysSet.has(key) && !selectedRowKeysSet.has(key)) {
+                            selectedRowKeys.push(key);
+                        }
+                    }
+                    allRowKeys = pullAll(allRowKeys, [...disabledRowKeys, ...curSelectedRowKeys]);
+                    changedRowKeys = [...allRowKeys];
+                } else {
+                    selectedRowKeys = pullAll(selectedRowKeys, allRowKeys);
+                    changedRowKeys = [...curSelectedRowKeys];
+                }
 
-            const changedRows = this.getSelectedRows(null, changedRowKeys || []);
-            const selectedRows = this.getSelectedRows(null, selectedRowKeys || []);
+                const changedRows = this.getSelectedRows(null, changedRowKeys || []);
+                const selectedRows = this.getSelectedRows(null, selectedRowKeys || []);
 
-            if (!this._selectionIsControlled()) {
-                this._adapter.setSelectedRowKeys(selectedRowKeys);
+                if (!this._selectionIsControlled()) {
+                    this._adapter.setSelectedRowKeys(selectedRowKeys);
+                }
+                this._adapter.notifySelectAll(selected, selectedRows, changedRows, e);
+                this._adapter.notifySelectionChange(selectedRowKeys, selectedRows);
             }
-            this._adapter.notifySelectAll(selected, selectedRows, changedRows, e);
-            this._adapter.notifySelectionChange(selectedRowKeys, selectedRows);
         }
     }
 
@@ -1283,4 +1436,19 @@ export type BaseIncludeGroupRecord<RecordType> = RecordType | { groupKey: string
 
 export type BaseEllipsis = boolean | { showTitle: boolean };
 
+export type CheckRelation = 'related' | 'unRelated';
+
+export interface BaseEntity {
+    key?: string | number;
+    level?: number;
+    children?: BaseEntity[];
+    parent?: BaseEntity | null;
+    data?: Record<string, any>;
+    [key: string]: any
+}
+
+export interface BaseEntitys {
+    [key: string]: BaseEntity
+}
+
 export default TableFoundation;

package/table/table.scss

@@ -259,6 +259,23 @@ $module: #{$prefix}-table;
             display: table-row;
             background-color: $color-table_body-bg-default;
 
+            // Programmatic hover state (e.g. rowSpanHover feature)
+            // Keep visual effect consistent with native :hover
+            &.#{$module}-row-hovered {
+                & > .#{$module}-row-cell {
+                    background-image: linear-gradient(0deg, $color-table_body-bg-hover, $color-table_body-bg-hover);
+                    background-color: $color-table_cell-bg-hover;
+
+                    &.#{$module}-cell-fixed {
+                        &-left,
+                        &-right {
+                            background-image: linear-gradient(0deg, $color-table_body-bg-hover, $color-table_body-bg-hover);
+                            background-color: $color-table_body-bg-default;
+                        }
+                    }
+                }
+            }
+
             &:hover {
                 & > .#{$module}-row-cell {
                     // $color-table_body-bg-hover has transparency，will reveal the background color $color-table_body-bg-default\

package/tooltip/foundation.ts

@@ -210,7 +210,7 @@ export default class Tooltip<P = Record<string, any>, S = Record<string, any>> e
         switch (types) {
             case 'focus':
                 triggerEventSet[eventNames.focus] = () => {
-                    this.delayShow();
+                    this.getProp('condition') !== false && this.delayShow();
                 };
                 triggerEventSet[eventNames.blur] = () => {
                     this.delayHide();
@@ -220,7 +220,7 @@ export default class Tooltip<P = Record<string, any>, S = Record<string, any>> e
             case 'click':
                 triggerEventSet[eventNames.click] = () => {
                     // this.delayShow();
-                    this.show();
+                    this.getProp('condition') !== false && this.show();
                 };
                 portalEventSet = {};
                 // Click outside needs special treatment, can not be directly tied to the trigger Element, need to be bound to the document
@@ -229,7 +229,7 @@ export default class Tooltip<P = Record<string, any>, S = Record<string, any>> e
                 triggerEventSet[eventNames.mouseEnter] = () => {
                     // console.log(e);
                     this.setCache('isClickToHide', false);
-                    this.delayShow();
+                    this.getProp('condition') !== false && this.delayShow();
                     // this.show('trigger');
                 };
                 triggerEventSet[eventNames.mouseLeave] = () => {
@@ -240,7 +240,7 @@ export default class Tooltip<P = Record<string, any>, S = Record<string, any>> e
                 // bind focus to hover trigger for a11y
                 triggerEventSet[eventNames.focus] = () => {
                     const { disableFocusListener } = this.getProps();
-                    !disableFocusListener && this.delayShow();
+                    this.getProp('condition') !== false && !disableFocusListener && this.delayShow();
                 };
                 triggerEventSet[eventNames.blur] = () => {
                     const { disableFocusListener } = this.getProps();
@@ -259,7 +259,7 @@ export default class Tooltip<P = Record<string, any>, S = Record<string, any>> e
                             return;
                         }
 
-                        this.delayShow();
+                        this.getProp('condition') !== false && this.delayShow();
                     };
                 }
                 break;
@@ -269,6 +269,9 @@ export default class Tooltip<P = Record<string, any>, S = Record<string, any>> e
                 break;
             case 'contextMenu':
                 triggerEventSet[eventNames.contextMenu] = (e) => {
+                    if (this.getProp('condition') === false) {
+                        return;
+                    }
                     e.preventDefault();
                     this.show();
                 };

package/transfer/constants.ts

@@ -10,6 +10,8 @@ const strings = {
     TYPE_TREE_TO_LIST: 'treeList',
 };
 
-const numbers = {};
+const numbers = {
+    DEFAULT_PAGE_SIZE: 10,
+};
 
 export { cssClasses, strings, numbers };

package/transfer/foundation.ts

@@ -40,7 +40,9 @@ export interface TransferAdapter<P = Record<string, any>, S = Record<string, any
     notifyDeselect: (items: BasicDataItem) => void;
     updateInput: (input: string) => void;
     updateSearchResult: (searchResult: Set<number | string>) => void;
-    searchTree: (keyword: string) => void
+    searchTree: (keyword: string) => void;
+    updateCurrentPage: (currentPage: number) => void;
+    notifyPageChange: (currentPage: number) => void;
 }
 
 export default class TransferFoundation<P = Record<string, any>, S = Record<string, any>> extends BaseFoundation<TransferAdapter<P, S>> {
@@ -253,4 +255,9 @@ export default class TransferFoundation<P = Record<string, any>, S = Record<stri
         this._notifyChange(newSelectedItems);
     }
 
+    handlePageChange(currentPage: number) {
+        this._adapter.updateCurrentPage(currentPage);
+        this._adapter.notifyPageChange(currentPage);
+    }
+
 }

package/transfer/transfer.scss

@@ -118,6 +118,16 @@ $module: #{$prefix}-transfer;
             flex-grow: 1;
         }
 
+        &-pagination {
+            padding-top: $spacing-base-tight;
+            padding-bottom: $spacing-base-tight;
+            padding-left: $spacing-base-tight;
+            padding-right: $spacing-base-tight;
+            flex-shrink: 0;
+            display: flex;
+            justify-content: center;
+        }
+
         &-empty {
             height: $height-transfer_left_empty;
         }

package/tree/foundation.ts

@@ -3,7 +3,7 @@
  * https://github.com/react-component/tree
  */
 
-import { isUndefined, difference, pick, get } from 'lodash';
+import { isUndefined, difference, pick, get, throttle } from 'lodash';
 import BaseFoundation, { DefaultAdapter } from '../base/foundation';
 import {
     flattenTreeData,
@@ -322,11 +322,35 @@ export interface TreeAdapter extends DefaultAdapter<BasicTreeProps, BasicTreeInn
 
 export default class TreeFoundation extends BaseFoundation<TreeAdapter, BasicTreeProps, BasicTreeInnerData> {
     delayedDragEnterLogic: any;
+    throttledDragOverUpdate: ReturnType<typeof throttle>;
 
     constructor(adapter: TreeAdapter) {
         super({
             ...adapter,
         });
+        // Throttle drag over state updates to improve performance during fast dragging
+        // 16ms ≈ 60fps, ensuring smooth updates without excessive re-renders
+        this.throttledDragOverUpdate = throttle((dropPosition: number) => {
+            this._adapter.updateState({
+                dropPosition,
+            });
+        }, 16);
+    }
+
+    destroy() {
+        super.destroy();
+        // Cancel any pending throttled updates
+        if (this.throttledDragOverUpdate) {
+            this.throttledDragOverUpdate.cancel();
+        }
+
+        // Clear pending delayed drag enter timers to avoid updates after unmount
+        if (this.delayedDragEnterLogic) {
+            Object.keys(this.delayedDragEnterLogic).forEach(key => {
+                clearTimeout(this.delayedDragEnterLogic[key]);
+            });
+            this.delayedDragEnterLogic = null;
+        }
     }
 
     _isMultiple() {
@@ -863,21 +887,22 @@ export default class TreeFoundation extends BaseFoundation<TreeAdapter, BasicTre
             return;
         }
 
-        // Update the drag position
+        // Update the drag position with throttle to improve performance
         if (dragNode && eventKey === dragOverNodeKey) {
             const newPos = calcDropRelativePosition(e, treeNode);
             if (dropPosition === newPos) {
                 return;
             }
-            this._adapter.updateState({
-                dropPosition: newPos,
-            });
+            // Use throttled update to reduce re-renders during fast dragging
+            this.throttledDragOverUpdate(newPos);
         }
 
         this.triggerDragEvent('onDragOver', e, treeNode);
     }
 
     handleNodeDragLeave(e: any, treeNode: BasicTreeNodeData) {
+        // Cancel pending throttled updates when leaving a node
+        this.throttledDragOverUpdate.cancel();
         this._adapter.updateState({
             dragOverNodeKey: '',
         });
@@ -885,12 +910,16 @@ export default class TreeFoundation extends BaseFoundation<TreeAdapter, BasicTre
     }
 
     handleNodeDragEnd(e: any, treeNode: BasicTreeNodeData) {
+        // Flush any pending throttled updates before clearing drag state
+        this.throttledDragOverUpdate.flush();
         this.clearDragState();
         this.triggerDragEvent('onDragEnd', e, treeNode);
         this._adapter.setDragNode(null);
     }
 
     handleNodeDrop(e: any, treeNode: BasicTreeNodeData, dragNode: any) {
+        // Flush any pending throttled updates to ensure accurate drop position
+        this.throttledDragOverUpdate.flush();
         const { dropPosition, dragNodesKeys } = this.getStates();
         const { eventKey, pos } = treeNode;
         this.clearDragState();

package/treeSelect/foundation.ts

@@ -119,6 +119,7 @@ export interface BasicTreeSelectProps extends Pick<BasicTreeProps,
     outerTopSlot?: any;
     placeholder?: string;
     prefix?: any;
+    remote?: boolean;
     searchAutoFocus?: boolean;
     searchPlaceholder?: string;
     showSearchClear?: boolean;
@@ -626,7 +627,15 @@ export default class TreeSelectFoundation<P = Record<string, any>, S = Record<st
         // Input is used as controlled component
         this._adapter.updateInputValue(sugInput);
         const { flattenNodes, expandedKeys, selectedKeys, keyEntities, treeData } = this.getStates();
-        const { showFilteredOnly, filterTreeNode, treeNodeFilterProp, keyMaps } = this.getProps();
+        const { showFilteredOnly, filterTreeNode, treeNodeFilterProp, keyMaps, remote } = this.getProps();
+
+        // When remote is true, skip local filtering, only update inputValue and trigger onSearch callback
+        if (remote) {
+            this._adapter.notifySearch(sugInput, [], []);
+            this._adapter.rePositionDropdown();
+            return;
+        }
+
         const realFilterProp = treeNodeFilterProp !== 'label' ? treeNodeFilterProp : get(keyMaps, 'label', 'label');
         const newExpandedKeys: Set<string> = new Set(expandedKeys);
         let filteredNodes: BasicTreeNodeData[] = [];