@yoka-ui/ui 1.0.10-test

package/dist/lib/components/TreeTransfer/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * TreeTransfer
+ *
+ * 树形表格穿梭框组件。支持：
+ * - 树形结构展示，父子联动选择（checkStrictly: false）
+ * - 前端分页 + 防抖搜索
+ * - 左右穿梭操作（含多级树正确迁移）
+ * - 自定义列配置和渲染
+ * - 完整的 TypeScript 泛型支持
+ *
+ * @template T - 行数据的自定义业务类型
+ *
+ * @example
+ * ```tsx
+ * <TreeTransfer
+ *   leftDataSource={leftData}
+ *   rightDataSource={rightData}
+ *   leftTitle="待分配"
+ *   rightTitle="已分配"
+ *   onChange={({ leftData, rightData }) => { ... }}
+ * />
+ * ```
+ */
+import React from 'react';
+import { TreeTransferProps } from './types';
+import './index.less';
+declare function TreeTransfer<T>({ leftDataSource, rightDataSource, loading, leftTitle, rightTitle, pageSize, columns, customRender, searchFields, searchPlaceholder, onChange, }: TreeTransferProps<T>): React.JSX.Element;
+export default TreeTransfer;

package/dist/lib/components/TreeTransfer/index.js

@@ -0,0 +1,214 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/TreeTransfer/index.tsx
+var TreeTransfer_exports = {};
+__export(TreeTransfer_exports, {
+  default: () => TreeTransfer_default
+});
+module.exports = __toCommonJS(TreeTransfer_exports);
+var import_react = __toESM(require("react"));
+var import_antd = require("antd");
+var import_icons = require("@ant-design/icons");
+var import_types = require("./types");
+var import_utils = require("./utils");
+var import_TreeTransferPanel = __toESM(require("./components/TreeTransferPanel"));
+var import_index = require("./index.less");
+function useDebounce(callback, delay) {
+  const callbackRef = (0, import_react.useRef)(callback);
+  callbackRef.current = callback;
+  const timeoutRef = (0, import_react.useRef)();
+  return (0, import_react.useCallback)(
+    (...args) => {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = setTimeout(() => callbackRef.current(...args), delay);
+    },
+    [delay]
+    // callback 通过 ref 读取，不需要放入 deps
+  );
+}
+function TreeTransfer({
+  leftDataSource,
+  rightDataSource,
+  loading = false,
+  leftTitle = "待分配项",
+  rightTitle = "已分配项",
+  pageSize = import_types.DEFAULT_PAGE_SIZE,
+  columns,
+  customRender,
+  searchFields,
+  searchPlaceholder,
+  onChange
+}) {
+  const [leftPanel, setLeftPanel] = (0, import_react.useState)({
+    selectedRowKeys: [],
+    searchValue: "",
+    currentPage: 1,
+    totalCount: 0
+  });
+  const [rightPanel, setRightPanel] = (0, import_react.useState)({
+    selectedRowKeys: [],
+    searchValue: "",
+    currentPage: 1,
+    totalCount: 0
+  });
+  const filteredLeft = (0, import_react.useMemo)(
+    () => (0, import_utils.filterData)(leftDataSource, leftPanel.searchValue, searchFields),
+    [leftDataSource, leftPanel.searchValue, searchFields]
+  );
+  const filteredRight = (0, import_react.useMemo)(
+    () => (0, import_utils.filterData)(rightDataSource, rightPanel.searchValue, searchFields),
+    [rightDataSource, rightPanel.searchValue, searchFields]
+  );
+  const filteredLeftData = (0, import_react.useMemo)(
+    () => (0, import_utils.sliceDataByPage)(filteredLeft, leftPanel.currentPage, pageSize),
+    [filteredLeft, leftPanel.currentPage, pageSize]
+  );
+  const filteredRightData = (0, import_react.useMemo)(
+    () => (0, import_utils.sliceDataByPage)(filteredRight, rightPanel.currentPage, pageSize),
+    [filteredRight, rightPanel.currentPage, pageSize]
+  );
+  const filteredLeftTotalCount = (0, import_react.useMemo)(() => (0, import_utils.countParentNodes)(filteredLeft), [filteredLeft]);
+  const filteredRightTotalCount = (0, import_react.useMemo)(() => (0, import_utils.countParentNodes)(filteredRight), [filteredRight]);
+  (0, import_react.useEffect)(() => {
+    setLeftPanel((prev) => ({
+      ...prev,
+      currentPage: 1,
+      totalCount: (0, import_utils.countParentNodes)(leftDataSource)
+    }));
+  }, [leftDataSource]);
+  (0, import_react.useEffect)(() => {
+    setRightPanel((prev) => ({
+      ...prev,
+      currentPage: 1,
+      totalCount: (0, import_utils.countParentNodes)(rightDataSource)
+    }));
+  }, [rightDataSource]);
+  const handleLeftSearchChange = useDebounce((value) => {
+    setLeftPanel((prev) => ({ ...prev, searchValue: value, currentPage: 1 }));
+  }, 300);
+  const handleRightSearchChange = useDebounce((value) => {
+    setRightPanel((prev) => ({ ...prev, searchValue: value, currentPage: 1 }));
+  }, 300);
+  const handleLeftPageChange = (0, import_react.useCallback)((page) => {
+    setLeftPanel((prev) => ({ ...prev, currentPage: page }));
+  }, []);
+  const handleRightPageChange = (0, import_react.useCallback)((page) => {
+    setRightPanel((prev) => ({ ...prev, currentPage: page }));
+  }, []);
+  const handleMoveRight = (0, import_react.useCallback)(() => {
+    if (leftPanel.selectedRowKeys.length === 0)
+      return;
+    const selectedSet = new Set(leftPanel.selectedRowKeys.map(String));
+    const nodesToAdd = (0, import_utils.extractTopLevelSelectedNodes)(selectedSet, leftDataSource);
+    const keysToRemove = new Set((0, import_utils.getAllDescendantKeys)(leftPanel.selectedRowKeys, leftDataSource));
+    const newLeftData = (0, import_utils.removeNodesFromTree)(leftDataSource, keysToRemove);
+    const newRightData = (0, import_utils.addNodesToTree)(rightDataSource, null, nodesToAdd);
+    setLeftPanel((prev) => ({ ...prev, currentPage: 1, selectedRowKeys: [] }));
+    setRightPanel((prev) => ({ ...prev, currentPage: 1, selectedRowKeys: [] }));
+    onChange == null ? void 0 : onChange({
+      leftSelected: [],
+      rightSelected: [],
+      leftData: newLeftData,
+      rightData: newRightData
+    });
+  }, [leftPanel.selectedRowKeys, leftDataSource, rightDataSource, onChange]);
+  const handleMoveLeft = (0, import_react.useCallback)(() => {
+    if (rightPanel.selectedRowKeys.length === 0)
+      return;
+    const selectedSet = new Set(rightPanel.selectedRowKeys.map(String));
+    const nodesToAdd = (0, import_utils.extractTopLevelSelectedNodes)(selectedSet, rightDataSource);
+    const keysToRemove = new Set((0, import_utils.getAllDescendantKeys)(rightPanel.selectedRowKeys, rightDataSource));
+    const newRightData = (0, import_utils.removeNodesFromTree)(rightDataSource, keysToRemove);
+    const newLeftData = (0, import_utils.addNodesToTree)(leftDataSource, null, nodesToAdd);
+    setLeftPanel((prev) => ({ ...prev, currentPage: 1, selectedRowKeys: [] }));
+    setRightPanel((prev) => ({ ...prev, currentPage: 1, selectedRowKeys: [] }));
+    onChange == null ? void 0 : onChange({
+      leftSelected: [],
+      rightSelected: [],
+      leftData: newLeftData,
+      rightData: newRightData
+    });
+  }, [rightPanel.selectedRowKeys, rightDataSource, leftDataSource, onChange]);
+  return /* @__PURE__ */ import_react.default.createElement("div", { className: "tree-transfer-wrapper" }, /* @__PURE__ */ import_react.default.createElement(import_antd.Spin, { spinning: loading }, /* @__PURE__ */ import_react.default.createElement("div", { className: "tree-transfer-content" }, /* @__PURE__ */ import_react.default.createElement(
+    import_TreeTransferPanel.default,
+    {
+      dataSource: filteredLeftData,
+      selectedRowKeys: leftPanel.selectedRowKeys,
+      onRowSelect: (_, keys) => setLeftPanel((prev) => ({ ...prev, selectedRowKeys: keys })),
+      searchValue: leftPanel.searchValue,
+      setSearchValue: handleLeftSearchChange,
+      totalCount: leftPanel.searchValue ? filteredLeftTotalCount : leftPanel.totalCount,
+      title: leftTitle,
+      showPagination: true,
+      currentPage: leftPanel.currentPage,
+      pageSize,
+      onPageChange: handleLeftPageChange,
+      columns,
+      customRender,
+      searchPlaceholder
+    }
+  ), /* @__PURE__ */ import_react.default.createElement("div", { className: "tree-transfer-operations" }, /* @__PURE__ */ import_react.default.createElement(import_antd.Space, { direction: "vertical", size: 8 }, /* @__PURE__ */ import_react.default.createElement(
+    import_antd.Button,
+    {
+      className: "tree-transfer-operation-btn",
+      type: leftPanel.selectedRowKeys.length > 0 ? "primary" : "default",
+      icon: /* @__PURE__ */ import_react.default.createElement(import_icons.RightOutlined, null),
+      onClick: handleMoveRight,
+      disabled: leftPanel.selectedRowKeys.length === 0
+    }
+  ), /* @__PURE__ */ import_react.default.createElement(
+    import_antd.Button,
+    {
+      className: "tree-transfer-operation-btn",
+      type: rightPanel.selectedRowKeys.length > 0 ? "primary" : "default",
+      icon: /* @__PURE__ */ import_react.default.createElement(import_icons.LeftOutlined, null),
+      onClick: handleMoveLeft,
+      disabled: rightPanel.selectedRowKeys.length === 0
+    }
+  ))), /* @__PURE__ */ import_react.default.createElement(
+    import_TreeTransferPanel.default,
+    {
+      dataSource: filteredRightData,
+      selectedRowKeys: rightPanel.selectedRowKeys,
+      onRowSelect: (_, keys) => setRightPanel((prev) => ({ ...prev, selectedRowKeys: keys })),
+      searchValue: rightPanel.searchValue,
+      setSearchValue: handleRightSearchChange,
+      totalCount: rightPanel.searchValue ? filteredRightTotalCount : rightPanel.totalCount,
+      title: rightTitle,
+      showPagination: true,
+      currentPage: rightPanel.currentPage,
+      pageSize,
+      onPageChange: handleRightPageChange,
+      columns,
+      customRender
+    }
+  ))));
+}
+var TreeTransfer_default = TreeTransfer;
+//# sourceMappingURL=index.js.map

package/dist/lib/components/TreeTransfer/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/components/TreeTransfer/index.tsx"],
+  "sourcesContent": ["/*\n *  Licensed to the Apache Software Foundation (ASF) under one or more\n *  contributor license agreements.  See the NOTICE file distributed with\n *  this work for additional information regarding copyright ownership.\n *  The ASF licenses this file to You under the Apache License, Version 2.0\n *  (the \"License\"); you may not use this file except in compliance with\n *  the License.  You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n *  Unless required by applicable law or agreed to in writing, software\n *  distributed under the License is distributed on an \"AS IS\" BASIS,\n *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n *  See the License for the specific language governing permissions and\n *  limitations under the License.\n *\n */\n\n/**\n * TreeTransfer\n *\n * 树形表格穿梭框组件。支持：\n * - 树形结构展示，父子联动选择（checkStrictly: false）\n * - 前端分页 + 防抖搜索\n * - 左右穿梭操作（含多级树正确迁移）\n * - 自定义列配置和渲染\n * - 完整的 TypeScript 泛型支持\n *\n * @template T - 行数据的自定义业务类型\n *\n * @example\n * ```tsx\n * <TreeTransfer\n *   leftDataSource={leftData}\n *   rightDataSource={rightData}\n *   leftTitle=\"待分配\"\n *   rightTitle=\"已分配\"\n *   onChange={({ leftData, rightData }) => { ... }}\n * />\n * ```\n */\n\nimport React, { useState, useMemo, useCallback, useEffect, useRef } from 'react';\nimport { Spin, Button, Space } from 'antd';\nimport { RightOutlined, LeftOutlined } from '@ant-design/icons';\nimport { TreeTransferProps, DEFAULT_PAGE_SIZE } from './types';\nimport {\n  sliceDataByPage,\n  filterData,\n  getAllDescendantKeys,\n  removeNodesFromTree,\n  addNodesToTree,\n  countParentNodes,\n  extractTopLevelSelectedNodes,\n} from './utils';\nimport TreeTransferPanel from './components/TreeTransferPanel';\nimport './index.less';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// useDebounce\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * 防抖 Hook\n *\n * 修复说明：\n * 原实现将 `callback` 放入 `useCallback` 的 deps，导致每次渲染（callback 为\n * 新引用）都重新创建防抖函数，使 timeout 重置，防抖完全失效。\n * 修复方案：将最新 callback 存入 ref，useCallback 仅依赖 delay，保证\n * 防抖函数引用稳定，timeout 不被意外清除。\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction useDebounce<T extends (...args: any[]) => any>(callback: T, delay: number): T {\n  // 存储最新 callback，避免 stale closure\n  const callbackRef = useRef(callback);\n  callbackRef.current = callback;\n\n  const timeoutRef = useRef<NodeJS.Timeout>();\n\n  return useCallback(\n    (...args: Parameters<T>) => {\n      clearTimeout(timeoutRef.current);\n      timeoutRef.current = setTimeout(() => callbackRef.current(...args), delay);\n    },\n    [delay], // callback 通过 ref 读取，不需要放入 deps\n  ) as T;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// TreeTransfer\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * 面板选择/分页状态（不含 dataSource，数据源来自 props + memo 计算）\n */\ninterface PanelState {\n  selectedRowKeys: React.Key[];\n  searchValue: string;\n  currentPage: number;\n  totalCount: number;\n}\n\nfunction TreeTransfer<T>({\n  leftDataSource,\n  rightDataSource,\n  loading = false,\n  leftTitle = '待分配项',\n  rightTitle = '已分配项',\n  pageSize = DEFAULT_PAGE_SIZE,\n  columns,\n  customRender,\n  searchFields,\n  searchPlaceholder,\n  onChange,\n}: TreeTransferProps<T>) {\n  // ── 面板状态（选择、搜索、分页） ─────────────────────────────────────────────\n  // 注意：dataSource 不存储在 state 中；显示数据通过 memo 从 props 实时计算，\n  // 避免 state 与 props 不同步的问题。\n  const [leftPanel, setLeftPanel] = useState<PanelState>({\n    selectedRowKeys: [],\n    searchValue: '',\n    currentPage: 1,\n    totalCount: 0,\n  });\n\n  const [rightPanel, setRightPanel] = useState<PanelState>({\n    selectedRowKeys: [],\n    searchValue: '',\n    currentPage: 1,\n    totalCount: 0,\n  });\n\n  // ── 过滤后的完整数据（先 filter，再由 slice 分页） ──────────────────────────\n  // 合并 filter + count，避免对同一搜索词调用两次 filterData（原来的问题）。\n\n  const filteredLeft = useMemo(\n    () => filterData<T>(leftDataSource, leftPanel.searchValue, searchFields),\n    [leftDataSource, leftPanel.searchValue, searchFields],\n  );\n\n  const filteredRight = useMemo(\n    () => filterData<T>(rightDataSource, rightPanel.searchValue, searchFields),\n    [rightDataSource, rightPanel.searchValue, searchFields],\n  );\n\n  /** 当前页展示数据（供左侧面板渲染） */\n  const filteredLeftData = useMemo(\n    () => sliceDataByPage<T>(filteredLeft, leftPanel.currentPage, pageSize),\n    [filteredLeft, leftPanel.currentPage, pageSize],\n  );\n\n  /** 当前页展示数据（供右侧面板渲染） */\n  const filteredRightData = useMemo(\n    () => sliceDataByPage<T>(filteredRight, rightPanel.currentPage, pageSize),\n    [filteredRight, rightPanel.currentPage, pageSize],\n  );\n\n  /** 搜索后的顶层节点数（用于分页器 total） */\n  const filteredLeftTotalCount = useMemo(() => countParentNodes(filteredLeft), [filteredLeft]);\n  const filteredRightTotalCount = useMemo(() => countParentNodes(filteredRight), [filteredRight]);\n\n  // ── 数据源变化时更新 totalCount，同时重置到第 1 页 ──────────────────────────\n  useEffect(() => {\n    setLeftPanel((prev) => ({\n      ...prev,\n      currentPage: 1,\n      totalCount: countParentNodes(leftDataSource),\n    }));\n  }, [leftDataSource]);\n\n  useEffect(() => {\n    setRightPanel((prev) => ({\n      ...prev,\n      currentPage: 1,\n      totalCount: countParentNodes(rightDataSource),\n    }));\n  }, [rightDataSource]);\n\n  // ── 防抖搜索 ─────────────────────────────────────────────────────────────────\n\n  const handleLeftSearchChange = useDebounce((value: string) => {\n    setLeftPanel((prev) => ({ ...prev, searchValue: value, currentPage: 1 }));\n  }, 300);\n\n  const handleRightSearchChange = useDebounce((value: string) => {\n    setRightPanel((prev) => ({ ...prev, searchValue: value, currentPage: 1 }));\n  }, 300);\n\n  // ── 分页 ─────────────────────────────────────────────────────────────────────\n\n  const handleLeftPageChange = useCallback((page: number) => {\n    setLeftPanel((prev) => ({ ...prev, currentPage: page }));\n  }, []);\n\n  const handleRightPageChange = useCallback((page: number) => {\n    setRightPanel((prev) => ({ ...prev, currentPage: page }));\n  }, []);\n\n  // ── 穿梭操作 ─────────────────────────────────────────────────────────────────\n\n  /**\n   * 右移：将左侧选中项移到右侧\n   *\n   * 修复说明：\n   * 原实现通过 `dataSource.filter(item => item.key === key)` 只查根节点，\n   * 导致仅选中子节点时 nodesToAdd 为空，数据静默丢失。\n   * 修复：使用 `extractTopLevelSelectedNodes` 递归提取选中的顶层节点（含 children）。\n   */\n  const handleMoveRight = useCallback(() => {\n    if (leftPanel.selectedRowKeys.length === 0) return;\n\n    const selectedSet = new Set(leftPanel.selectedRowKeys.map(String));\n    // 提取选中的顶层节点（子节点随父一起携带）\n    const nodesToAdd = extractTopLevelSelectedNodes<T>(selectedSet, leftDataSource);\n    // 删除所有相关 key（含后代）\n    const keysToRemove = new Set(getAllDescendantKeys(leftPanel.selectedRowKeys, leftDataSource));\n    const newLeftData = removeNodesFromTree(leftDataSource, keysToRemove);\n    const newRightData = addNodesToTree(rightDataSource, null, nodesToAdd);\n\n    setLeftPanel((prev) => ({ ...prev, currentPage: 1, selectedRowKeys: [] }));\n    setRightPanel((prev) => ({ ...prev, currentPage: 1, selectedRowKeys: [] }));\n\n    onChange?.({\n      leftSelected: [],\n      rightSelected: [],\n      leftData: newLeftData,\n      rightData: newRightData,\n    });\n  }, [leftPanel.selectedRowKeys, leftDataSource, rightDataSource, onChange]);\n\n  /**\n   * 左移：将右侧选中项移到左侧\n   */\n  const handleMoveLeft = useCallback(() => {\n    if (rightPanel.selectedRowKeys.length === 0) return;\n\n    const selectedSet = new Set(rightPanel.selectedRowKeys.map(String));\n    const nodesToAdd = extractTopLevelSelectedNodes<T>(selectedSet, rightDataSource);\n    const keysToRemove = new Set(getAllDescendantKeys(rightPanel.selectedRowKeys, rightDataSource));\n    const newRightData = removeNodesFromTree(rightDataSource, keysToRemove);\n    const newLeftData = addNodesToTree(leftDataSource, null, nodesToAdd);\n\n    setLeftPanel((prev) => ({ ...prev, currentPage: 1, selectedRowKeys: [] }));\n    setRightPanel((prev) => ({ ...prev, currentPage: 1, selectedRowKeys: [] }));\n\n    onChange?.({\n      leftSelected: [],\n      rightSelected: [],\n      leftData: newLeftData,\n      rightData: newRightData,\n    });\n  }, [rightPanel.selectedRowKeys, rightDataSource, leftDataSource, onChange]);\n\n  // ── 渲染 ─────────────────────────────────────────────────────────────────────\n\n  return (\n    <div className='tree-transfer-wrapper'>\n      <Spin spinning={loading}>\n        <div className='tree-transfer-content'>\n          {/* 左侧面板 */}\n          <TreeTransferPanel<T>\n            dataSource={filteredLeftData}\n            selectedRowKeys={leftPanel.selectedRowKeys}\n            onRowSelect={(_, keys) => setLeftPanel((prev) => ({ ...prev, selectedRowKeys: keys }))}\n            searchValue={leftPanel.searchValue}\n            setSearchValue={handleLeftSearchChange}\n            totalCount={leftPanel.searchValue ? filteredLeftTotalCount : leftPanel.totalCount}\n            title={leftTitle}\n            showPagination={true}\n            currentPage={leftPanel.currentPage}\n            pageSize={pageSize}\n            onPageChange={handleLeftPageChange}\n            columns={columns}\n            customRender={customRender}\n            searchPlaceholder={searchPlaceholder}\n          />\n\n          {/* 中间操作按钮 */}\n          <div className='tree-transfer-operations'>\n            <Space direction='vertical' size={8}>\n              <Button\n                className='tree-transfer-operation-btn'\n                type={leftPanel.selectedRowKeys.length > 0 ? 'primary' : 'default'}\n                icon={<RightOutlined />}\n                onClick={handleMoveRight}\n                disabled={leftPanel.selectedRowKeys.length === 0}\n              />\n              <Button\n                className='tree-transfer-operation-btn'\n                type={rightPanel.selectedRowKeys.length > 0 ? 'primary' : 'default'}\n                icon={<LeftOutlined />}\n                onClick={handleMoveLeft}\n                disabled={rightPanel.selectedRowKeys.length === 0}\n              />\n            </Space>\n          </div>\n\n          {/* 右侧面板 */}\n          <TreeTransferPanel<T>\n            dataSource={filteredRightData}\n            selectedRowKeys={rightPanel.selectedRowKeys}\n            onRowSelect={(_, keys) => setRightPanel((prev) => ({ ...prev, selectedRowKeys: keys }))}\n            searchValue={rightPanel.searchValue}\n            setSearchValue={handleRightSearchChange}\n            totalCount={rightPanel.searchValue ? filteredRightTotalCount : rightPanel.totalCount}\n            title={rightTitle}\n            showPagination={true}\n            currentPage={rightPanel.currentPage}\n            pageSize={pageSize}\n            onPageChange={handleRightPageChange}\n            columns={columns}\n            customRender={customRender}\n          />\n        </div>\n      </Spin>\n    </div>\n  );\n}\n\nexport default TreeTransfer;\n"],
+  "mappings": "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",
+  "names": ["React", "TreeTransferPanel"]
+}

package/dist/lib/components/TreeTransfer/index.less

@@ -0,0 +1,69 @@
+/*
+ *  Licensed to the Apache Software Foundation (ASF) under one or more
+ *  contributor license agreements.  See the NOTICE file distributed with
+ *  this work for additional information regarding copyright ownership.
+ *  The ASF licenses this file to You under the Apache License, Version 2.0
+ *  (the "License"); you may not use this file except in compliance with
+ *  the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ *
+ */
+
+.tree-transfer-wrapper {
+  width: 100%;
+  height: 100%;
+  display: flex;
+  flex-direction: column;
+
+  .ant-spin-nested-loading {
+    width: 100%;
+    height: 100%;
+
+    .ant-spin-container {
+      width: 100%;
+      height: 100%;
+    }
+  }
+
+  // 主内容区域
+  .tree-transfer-content {
+    display: flex;
+    align-items: stretch;
+    height: 100%;
+  }
+
+  // 中间操作按钮区域
+  .tree-transfer-operations {
+    display: flex;
+    flex-direction: column;
+    justify-content: center;
+    gap: 8px;
+    padding-left: 7px;
+    width: 40px;
+    flex-shrink: 0;
+
+    .ant-space {
+      .tree-transfer-operation-btn {
+        width: 25px;
+        height: 25px;
+        min-width: 25px;
+        padding: 0;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+
+        .anticon {
+          font-size: 12px;
+          margin: 0;
+        }
+      }
+    }
+  }
+}

package/dist/lib/components/TreeTransfer/types.d.ts

@@ -0,0 +1,122 @@
+/// <reference types="react" />
+import type { ColumnsType } from 'antd/es/table';
+/**
+ * 默认每页显示条数
+ */
+export declare const DEFAULT_PAGE_SIZE = 20;
+/**
+ * 树形表格行数据基类
+ * @template T - 自定义数据类型
+ */
+export interface TreeTransferRow<T = any> {
+    /** 唯一标识 */
+    key: string | number;
+    /** 父节点唯一标识 */
+    parentKey?: string | number;
+    /** 子节点列表 */
+    children?: TreeTransferRow<T>[];
+    /** 是否为父节点 */
+    isParent?: boolean;
+    /** 自定义数据 */
+    data: T;
+}
+/**
+ * 穿梭框面板Props
+ */
+export interface TreeTransferPanelProps<T = any> {
+    /** 数据源 */
+    dataSource: TreeTransferRow<T>[];
+    /** 已选中的行keys */
+    selectedRowKeys: React.Key[];
+    /** 行选择回调 */
+    onRowSelect: (selectedRows: TreeTransferRow<T>[], selectedRowKeys: React.Key[]) => void;
+    /** 搜索关键词 */
+    searchValue: string;
+    /** 设置搜索关键词 */
+    setSearchValue: (value: string) => void;
+    searchPlaceholder?: string;
+    /** 总数 */
+    totalCount: number;
+    /** 面板标题 */
+    title: string;
+    /** 是否显示分页 */
+    showPagination?: boolean;
+    /** 当前页码 */
+    currentPage?: number;
+    /** 每页条数（与父组件 pageSize 保持一致，用于分页器） */
+    pageSize?: number;
+    /** 分页变化回调 */
+    onPageChange?: (page: number) => void;
+    /** 自定义列配置，如果不传则使用默认配置 */
+    columns?: ColumnsType<TreeTransferRow<T>>;
+    /** 自定义渲染函数 */
+    customRender?: {
+        /** 自定义行单元格渲染 */
+        onCell?: (record: TreeTransferRow<T>) => any;
+        /** 自定义单元格内容渲染 */
+        cellRender?: (text: any, record: TreeTransferRow<T>, index: number) => React.ReactNode;
+    };
+}
+/**
+ * 穿梭框面板状态
+ */
+export interface TreeTransferPanelState {
+    /** 当前页数据 */
+    dataSource: TreeTransferRow[];
+    /** 选中的keys */
+    selectedRowKeys: React.Key[];
+    /** 搜索关键词 */
+    searchValue: string;
+    /** 当前页码 */
+    currentPage: number;
+    /** 总条数 */
+    totalCount: number;
+}
+/**
+ * 穿梭框主组件Props
+ * @template T - 数据类型
+ */
+export interface TreeTransferProps<T = any> {
+    /** 左侧数据源（完整数据） */
+    leftDataSource: TreeTransferRow<T>[];
+    /** 右侧数据源（完整数据） */
+    rightDataSource: TreeTransferRow<T>[];
+    /** 数据加载状态 */
+    loading?: boolean;
+    /** 左侧面板标题 */
+    leftTitle?: string;
+    /** 右侧面板标题 */
+    rightTitle?: string;
+    /** 左侧总数文本（如需自定义） */
+    leftCountText?: string;
+    /** 右侧总数文本（如需自定义） */
+    rightCountText?: string;
+    /** 搜索框占位符 */
+    searchPlaceholder?: string;
+    /** 是否允许跨页选择 */
+    crossPageSelection?: boolean;
+    /** 每页显示条数 */
+    pageSize?: number;
+    /** 自定义列配置 */
+    columns?: ColumnsType<TreeTransferRow<T>>;
+    /** 自定义渲染 */
+    customRender?: TreeTransferPanelProps['customRender'];
+    /** 搜索字段，支持字段名或自定义函数 */
+    searchFields?: (string | ((item: T) => string))[];
+    /** 选中项变化回调 */
+    onChange?: (params: {
+        leftSelected: TreeTransferRow<T>[];
+        rightSelected: TreeTransferRow<T>[];
+        leftData: TreeTransferRow<T>[];
+        rightData: TreeTransferRow<T>[];
+    }) => void;
+}
+/**
+ * 权限移动数据（用于穿梭操作）
+ */
+export interface TransferItem<T = any> {
+    /** 所属父节点key */
+    parentKey: string | number;
+    /** 移动的数据 */
+    data: T;
+}

package/dist/lib/components/TreeTransfer/types.js

@@ -0,0 +1,30 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/TreeTransfer/types.ts
+var types_exports = {};
+__export(types_exports, {
+  DEFAULT_PAGE_SIZE: () => DEFAULT_PAGE_SIZE
+});
+module.exports = __toCommonJS(types_exports);
+var DEFAULT_PAGE_SIZE = 20;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_PAGE_SIZE
+});
+//# sourceMappingURL=types.js.map

package/dist/lib/components/TreeTransfer/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/components/TreeTransfer/types.ts"],
+  "sourcesContent": ["/*\n *  Licensed to the Apache Software Foundation (ASF) under one or more\n *  contributor license agreements.  See the NOTICE file distributed with\n *  this work for additional information regarding copyright ownership.\n *  The ASF licenses this file to You under the Apache License, Version 2.0\n *  (the \"License\"); you may not use this file except in compliance with\n *  the License.  You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n *  Unless required by applicable law or agreed to in writing, software\n *  distributed under the License is distributed on an \"AS IS\" BASIS,\n *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n *  See the License for the specific language governing permissions and\n *  limitations under the License.\n *\n */\n\nimport type { ColumnsType } from 'antd/es/table';\n\n/**\n * 默认每页显示条数\n */\nexport const DEFAULT_PAGE_SIZE = 20;\n\n/**\n * 树形表格行数据基类\n * @template T - 自定义数据类型\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface TreeTransferRow<T = any> {\n  /** 唯一标识 */\n  key: string | number;\n  /** 父节点唯一标识 */\n  parentKey?: string | number;\n  /** 子节点列表 */\n  children?: TreeTransferRow<T>[];\n  /** 是否为父节点 */\n  isParent?: boolean;\n  /** 自定义数据 */\n  data: T;\n}\n\n/**\n * 穿梭框面板Props\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface TreeTransferPanelProps<T = any> {\n  /** 数据源 */\n  dataSource: TreeTransferRow<T>[];\n  /** 已选中的行keys */\n  selectedRowKeys: React.Key[];\n  /** 行选择回调 */\n  onRowSelect: (selectedRows: TreeTransferRow<T>[], selectedRowKeys: React.Key[]) => void;\n  /** 搜索关键词 */\n  searchValue: string;\n  /** 设置搜索关键词 */\n  setSearchValue: (value: string) => void;\n  searchPlaceholder?: string;\n  /** 总数 */\n  totalCount: number;\n  /** 面板标题 */\n  title: string;\n  /** 是否显示分页 */\n  showPagination?: boolean;\n  /** 当前页码 */\n  currentPage?: number;\n  /** 每页条数（与父组件 pageSize 保持一致，用于分页器） */\n  pageSize?: number;\n  /** 分页变化回调 */\n  onPageChange?: (page: number) => void;\n  /** 自定义列配置，如果不传则使用默认配置 */\n  columns?: ColumnsType<TreeTransferRow<T>>;\n  /** 自定义渲染函数 */\n  customRender?: {\n    /** 自定义行单元格渲染 */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    onCell?: (record: TreeTransferRow<T>) => any;\n    /** 自定义单元格内容渲染 */\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    cellRender?: (text: any, record: TreeTransferRow<T>, index: number) => React.ReactNode;\n  };\n}\n\n/**\n * 穿梭框面板状态\n */\nexport interface TreeTransferPanelState {\n  /** 当前页数据 */\n  dataSource: TreeTransferRow[];\n  /** 选中的keys */\n  selectedRowKeys: React.Key[];\n  /** 搜索关键词 */\n  searchValue: string;\n  /** 当前页码 */\n  currentPage: number;\n  /** 总条数 */\n  totalCount: number;\n}\n\n/**\n * 穿梭框主组件Props\n * @template T - 数据类型\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface TreeTransferProps<T = any> {\n  /** 左侧数据源（完整数据） */\n  leftDataSource: TreeTransferRow<T>[];\n  /** 右侧数据源（完整数据） */\n  rightDataSource: TreeTransferRow<T>[];\n  /** 数据加载状态 */\n  loading?: boolean;\n  /** 左侧面板标题 */\n  leftTitle?: string;\n  /** 右侧面板标题 */\n  rightTitle?: string;\n  /** 左侧总数文本（如需自定义） */\n  leftCountText?: string;\n  /** 右侧总数文本（如需自定义） */\n  rightCountText?: string;\n  /** 搜索框占位符 */\n  searchPlaceholder?: string;\n  /** 是否允许跨页选择 */\n  crossPageSelection?: boolean;\n  /** 每页显示条数 */\n  pageSize?: number;\n  /** 自定义列配置 */\n  columns?: ColumnsType<TreeTransferRow<T>>;\n  /** 自定义渲染 */\n  customRender?: TreeTransferPanelProps['customRender'];\n  /** 搜索字段，支持字段名或自定义函数 */\n  searchFields?: (string | ((item: T) => string))[];\n  /** 选中项变化回调 */\n  onChange?: (params: {\n    leftSelected: TreeTransferRow<T>[];\n    rightSelected: TreeTransferRow<T>[];\n    leftData: TreeTransferRow<T>[];\n    rightData: TreeTransferRow<T>[];\n  }) => void;\n}\n\n/**\n * 权限移动数据（用于穿梭操作）\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface TransferItem<T = any> {\n  /** 所属父节点key */\n  parentKey: string | number;\n  /** 移动的数据 */\n  data: T;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAuBO,IAAM,oBAAoB;",
+  "names": []
+}

package/dist/lib/components/TreeTransfer/utils/index.d.ts

@@ -0,0 +1,120 @@
+/// <reference types="react" />
+import { TreeTransferRow } from '../types';
+/**
+ * 从平铺的数据构建树形结构
+ *
+ * @param data - 平铺的数据数组
+ * @param options - 配置选项
+ * @returns 树形结构数据
+ *
+ * @example
+ * ```tsx
+ * const flatData = [
+ *   { id: '1', parentId: null, name: '应用1' },
+ *   { id: '1-1', parentId: '1', name: '权限1' },
+ * ];
+ *
+ * const treeData = buildTreeData(flatData, {
+ *   keyField: 'id',
+ *   parentField: 'parentId',
+ * });
+ * ```
+ */
+export declare function buildTreeData<T extends Record<string, any>>(data: T[], options?: {
+    /** 唯一键字段名，默认 'id' */
+    keyField?: string;
+    /** 父键字段名，默认 'parentId' */
+    parentField?: string;
+    /** 判断是否为父节点的函数，默认：无父键则为父节点 */
+    isParent?: (item: T) => boolean;
+}): TreeTransferRow<T>[];
+/**
+ * 将树形结构平铺为一维数组（深度优先）
+ *
+ * @example
+ * ```tsx
+ * const flat = flattenTreeData([{ key: '1', children: [{ key: '1-1' }] }]);
+ * // → [{ key: '1' }, { key: '1-1' }]
+ * ```
+ */
+export declare function flattenTreeData<T = any>(treeData: TreeTransferRow<T>[]): TreeTransferRow<T>[];
+/**
+ * 根据页码切片数据（前端分页）
+ *
+ * @param data - 数据数组
+ * @param page - 页码（从 1 开始）
+ * @param pageSize - 每页条数
+ * @returns 当前页数据
+ */
+export declare function sliceDataByPage<T = any>(data: TreeTransferRow<T>[], page: number, pageSize?: number): TreeTransferRow<T>[];
+/**
+ * 过滤数据（支持模糊搜索，递归保留有匹配子节点的父节点）
+ *
+ * @param data - 数据数组
+ * @param searchValue - 搜索关键词（空字符串返回全量数据）
+ * @param fields - 搜索字段列表，支持字段名或自定义取值函数，默认 ['id', 'name']
+ * @returns 过滤后的数据
+ */
+export declare function filterData<T = any>(data: TreeTransferRow<T>[], searchValue: string, fields?: (string | ((item: T) => string))[]): TreeTransferRow<T>[];
+/**
+ * 获取选中节点及其所有后代节点的 key 集合（用于批量移除）
+ *
+ * 修复说明：原实现对 3+ 层树只展开 2 层。现改为对每个选中节点
+ * 递归收集完整后代链，支持任意深度的树结构。
+ *
+ * @param selectedKeys - 选中的 keys
+ * @param dataSource - 完整数据源
+ * @returns 所有相关 key（字符串形式，含选中节点本身）
+ *
+ * @example
+ * ```tsx
+ * // 选中 'app1'（含 2 级子节点）
+ * getAllDescendantKeys(['app1'], dataSource);
+ * // → ['app1', 'app1-perm1', 'app1-perm1-sub1', 'app1-perm2', ...]
+ * ```
+ */
+export declare function getAllDescendantKeys(selectedKeys: React.Key[], dataSource: TreeTransferRow[]): string[];
+/**
+ * 计算数据总节点数（包含所有后代）
+ */
+export declare function countTotalNodes<T = any>(data: TreeTransferRow<T>[]): number;
+/**
+ * 计算顶层节点数（用于分页总数，不含嵌套子节点）
+ */
+export declare function countParentNodes<T = any>(data: TreeTransferRow<T>[]): number;
+/**
+ * 查找节点及其所有后代节点（按 key 定位）
+ */
+export declare function findNodeWithDescendants<T = any>(key: string | number, dataSource: TreeTransferRow<T>[]): TreeTransferRow<T>[];
+/**
+ * 从树形数据中移除指定 key 的节点（不可变，返回新数组）
+ *
+ * @param dataSource - 数据源
+ * @param keysToRemove - 要移除的节点 key 集合
+ * @returns 过滤后的新数据源
+ */
+export declare function removeNodesFromTree<T = any>(dataSource: TreeTransferRow<T>[], keysToRemove: Set<string | number>): TreeTransferRow<T>[];
+/**
+ * 向树形数据添加节点
+ *
+ * @param dataSource - 数据源
+ * @param parentKey - 父节点 key；传 null 表示添加到根
+ * @param nodes - 要添加的节点列表
+ * @returns 新的数据源
+ */
+export declare function addNodesToTree<T = any>(dataSource: TreeTransferRow<T>[], parentKey: string | number | null, nodes: TreeTransferRow<T>[]): TreeTransferRow<T>[];
+/**
+ * 从树形数据中提取"顶层选中节点"（用于穿梭框移动操作）
+ *
+ * 行为：遍历树，遇到选中节点时直接收集（含其 children），不再向下递归。
+ * 这样可以避免父节点和其已选中的子节点被分别添加两次。
+ *
+ * 适用场景：AntD Table 的 checkStrictly:false 级联选择中，
+ * 选中父节点会自动勾选子节点。move 时只需携带父节点（含 children）。
+ * 若仅选了某个子节点，则该子节点会被作为顶层节点添加到目标列表。
+ *
+ * @param selectedKeys - 选中的 key 集合（字符串）
+ * @param dataSource - 数据源（支持嵌套树）
+ * @returns 最小集合的顶层选中节点列表
+ */
+export declare function extractTopLevelSelectedNodes<T = any>(selectedKeys: Set<string>, dataSource: TreeTransferRow<T>[]): TreeTransferRow<T>[];