@yoka-ui/ui 1.0.10-test → 1.1.0

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

@@ -1,7 +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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",
+  "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 { LeftOutlined, RightOutlined } from '@ant-design/icons';\nimport { Button, Space, Spin } from 'antd';\nimport React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport TreeTransferPanel from './components/TreeTransferPanel';\nimport { DEFAULT_PAGE_SIZE, type TreeTransferProps } from './types';\nimport {\n  addNodesToTree,\n  countParentNodes,\n  extractTopLevelSelectedNodes,\n  filterData,\n  getAllDescendantKeys,\n  removeNodesFromTree,\n  sliceDataByPage,\n} from './utils';\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/utils/index.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="react" />
-import { TreeTransferRow } from '../types';
+import { type TreeTransferRow } from '../types';
 /**
  * 从平铺的数据构建树形结构
  *

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/components/TreeTransfer/utils/index.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 { TreeTransferRow, DEFAULT_PAGE_SIZE } from '../types';\n\n/**\n * 从平铺的数据构建树形结构\n *\n * @param data - 平铺的数据数组\n * @param options - 配置选项\n * @returns 树形结构数据\n *\n * @example\n * ```tsx\n * const flatData = [\n *   { id: '1', parentId: null, name: '应用1' },\n *   { id: '1-1', parentId: '1', name: '权限1' },\n * ];\n *\n * const treeData = buildTreeData(flatData, {\n *   keyField: 'id',\n *   parentField: 'parentId',\n * });\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function buildTreeData<T extends Record<string, any>>(\n  data: T[],\n  options: {\n    /** 唯一键字段名，默认 'id' */\n    keyField?: string;\n    /** 父键字段名，默认 'parentId' */\n    parentField?: string;\n    /** 判断是否为父节点的函数，默认：无父键则为父节点 */\n    isParent?: (item: T) => boolean;\n  } = {},\n): TreeTransferRow<T>[] {\n  const { keyField = 'id', parentField = 'parentId', isParent = (item) => !item[parentField] } = options;\n\n  const map = new Map<string | number, TreeTransferRow<T>>();\n  const roots: TreeTransferRow<T>[] = [];\n\n  // 第一次遍历：建立 key → node 映射\n  data.forEach((item) => {\n    const key = item[keyField];\n    map.set(key, { key, data: item, isParent: isParent(item), children: [] });\n  });\n\n  // 第二次遍历：挂载父子关系\n  data.forEach((item) => {\n    const key = item[keyField];\n    const parentId = item[parentField];\n    const node = map.get(key)!;\n\n    if (parentId && map.has(parentId)) {\n      map.get(parentId)!.children!.push(node);\n    } else {\n      roots.push(node);\n    }\n  });\n\n  return roots;\n}\n\n/**\n * 将树形结构平铺为一维数组（深度优先）\n *\n * @example\n * ```tsx\n * const flat = flattenTreeData([{ key: '1', children: [{ key: '1-1' }] }]);\n * // → [{ key: '1' }, { key: '1-1' }]\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function flattenTreeData<T = any>(treeData: TreeTransferRow<T>[]): TreeTransferRow<T>[] {\n  const result: TreeTransferRow<T>[] = [];\n\n  function traverse(nodes: TreeTransferRow<T>[]) {\n    nodes.forEach((node) => {\n      result.push(node);\n      if (node.children?.length) traverse(node.children);\n    });\n  }\n\n  traverse(treeData);\n  return result;\n}\n\n/**\n * 根据页码切片数据（前端分页）\n *\n * @param data - 数据数组\n * @param page - 页码（从 1 开始）\n * @param pageSize - 每页条数\n * @returns 当前页数据\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function sliceDataByPage<T = any>(\n  data: TreeTransferRow<T>[],\n  page: number,\n  pageSize: number = DEFAULT_PAGE_SIZE,\n): TreeTransferRow<T>[] {\n  const start = (page - 1) * pageSize;\n  return data.slice(start, start + pageSize);\n}\n\n/**\n * 过滤数据（支持模糊搜索，递归保留有匹配子节点的父节点）\n *\n * @param data - 数据数组\n * @param searchValue - 搜索关键词（空字符串返回全量数据）\n * @param fields - 搜索字段列表，支持字段名或自定义取值函数，默认 ['id', 'name']\n * @returns 过滤后的数据\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function filterData<T = any>(\n  data: TreeTransferRow<T>[],\n  searchValue: string,\n  fields: (string | ((item: T) => string))[] = ['id', 'name'],\n): TreeTransferRow<T>[] {\n  if (!searchValue.trim()) return data;\n\n  const lowerSearch = searchValue.toLowerCase();\n\n  return data.filter((item) => {\n    // 当前节点任意字段匹配即保留\n    const selfMatch = fields.some((field) => {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const value = typeof field === 'function' ? field(item.data) : (item.data as any)[field];\n      return String(value ?? '')\n        .toLowerCase()\n        .includes(lowerSearch);\n    });\n\n    if (selfMatch) return true;\n\n    // 子节点有匹配项则保留父节点（子节点也递归过滤）\n    if (item.children?.length) {\n      return filterData(item.children, searchValue, fields).length > 0;\n    }\n\n    return false;\n  });\n}\n\n/**\n * 获取选中节点及其所有后代节点的 key 集合（用于批量移除）\n *\n * 修复说明：原实现对 3+ 层树只展开 2 层。现改为对每个选中节点\n * 递归收集完整后代链，支持任意深度的树结构。\n *\n * @param selectedKeys - 选中的 keys\n * @param dataSource - 完整数据源\n * @returns 所有相关 key（字符串形式，含选中节点本身）\n *\n * @example\n * ```tsx\n * // 选中 'app1'（含 2 级子节点）\n * getAllDescendantKeys(['app1'], dataSource);\n * // → ['app1', 'app1-perm1', 'app1-perm1-sub1', 'app1-perm2', ...]\n * ```\n */\nexport function getAllDescendantKeys(selectedKeys: React.Key[], dataSource: TreeTransferRow[]): string[] {\n  const keySet = new Set(selectedKeys.map(String));\n  const allKeys: string[] = [];\n\n  /** 递归收集节点本身及所有后代的 key */\n  function collectWithDescendants(node: TreeTransferRow): void {\n    allKeys.push(String(node.key));\n    node.children?.forEach(collectWithDescendants);\n  }\n\n  function traverse(nodes: TreeTransferRow[]): void {\n    nodes.forEach((node) => {\n      if (keySet.has(String(node.key))) {\n        // 选中节点：收集自身及全部后代\n        collectWithDescendants(node);\n      } else {\n        // 未选中：继续向下搜索\n        if (node.children?.length) traverse(node.children);\n      }\n    });\n  }\n\n  traverse(dataSource);\n  return allKeys;\n}\n\n/**\n * 计算数据总节点数（包含所有后代）\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function countTotalNodes<T = any>(data: TreeTransferRow<T>[]): number {\n  let count = 0;\n  function traverse(nodes: TreeTransferRow<T>[]) {\n    nodes.forEach((node) => {\n      count += 1;\n      if (node.children?.length) traverse(node.children);\n    });\n  }\n  traverse(data);\n  return count;\n}\n\n/**\n * 计算顶层节点数（用于分页总数，不含嵌套子节点）\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function countParentNodes<T = any>(data: TreeTransferRow<T>[]): number {\n  return data.length;\n}\n\n/**\n * 查找节点及其所有后代节点（按 key 定位）\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function findNodeWithDescendants<T = any>(\n  key: string | number,\n  dataSource: TreeTransferRow<T>[],\n): TreeTransferRow<T>[] {\n  const result: TreeTransferRow<T>[] = [];\n\n  function traverse(nodes: TreeTransferRow<T>[]): boolean {\n    for (const node of nodes) {\n      if (node.key === key) {\n        result.push(node);\n        node.children?.forEach((child) => {\n          result.push(child);\n          if (child.children) traverse(child.children);\n        });\n        return true;\n      }\n      if (node.children && traverse(node.children)) return true;\n    }\n    return false;\n  }\n\n  traverse(dataSource);\n  return result;\n}\n\n/**\n * 从树形数据中移除指定 key 的节点（不可变，返回新数组）\n *\n * @param dataSource - 数据源\n * @param keysToRemove - 要移除的节点 key 集合\n * @returns 过滤后的新数据源\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function removeNodesFromTree<T = any>(\n  dataSource: TreeTransferRow<T>[],\n  keysToRemove: Set<string | number>,\n): TreeTransferRow<T>[] {\n  const result: TreeTransferRow<T>[] = [];\n\n  for (const node of dataSource) {\n    if (keysToRemove.has(node.key)) continue;\n\n    if (node.children?.length) {\n      result.push({ ...node, children: removeNodesFromTree(node.children, keysToRemove) });\n    } else {\n      result.push(node);\n    }\n  }\n\n  return result;\n}\n\n/**\n * 向树形数据添加节点\n *\n * @param dataSource - 数据源\n * @param parentKey - 父节点 key；传 null 表示添加到根\n * @param nodes - 要添加的节点列表\n * @returns 新的数据源\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function addNodesToTree<T = any>(\n  dataSource: TreeTransferRow<T>[],\n  parentKey: string | number | null,\n  nodes: TreeTransferRow<T>[],\n): TreeTransferRow<T>[] {\n  if (parentKey === null) {\n    return [...dataSource, ...nodes];\n  }\n\n  return dataSource.map((node) => {\n    if (node.key === parentKey) {\n      return { ...node, children: [...(node.children ?? []), ...nodes] };\n    }\n    if (node.children) {\n      return { ...node, children: addNodesToTree(node.children, parentKey, nodes) };\n    }\n    return node;\n  });\n}\n\n/**\n * 从树形数据中提取\"顶层选中节点\"（用于穿梭框移动操作）\n *\n * 行为：遍历树，遇到选中节点时直接收集（含其 children），不再向下递归。\n * 这样可以避免父节点和其已选中的子节点被分别添加两次。\n *\n * 适用场景：AntD Table 的 checkStrictly:false 级联选择中，\n * 选中父节点会自动勾选子节点。move 时只需携带父节点（含 children）。\n * 若仅选了某个子节点，则该子节点会被作为顶层节点添加到目标列表。\n *\n * @param selectedKeys - 选中的 key 集合（字符串）\n * @param dataSource - 数据源（支持嵌套树）\n * @returns 最小集合的顶层选中节点列表\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function extractTopLevelSelectedNodes<T = any>(\n  selectedKeys: Set<string>,\n  dataSource: TreeTransferRow<T>[],\n): TreeTransferRow<T>[] {\n  const result: TreeTransferRow<T>[] = [];\n\n  function traverse(nodes: TreeTransferRow<T>[]): void {\n    nodes.forEach((node) => {\n      if (selectedKeys.has(String(node.key))) {\n        // 选中节点：整体移动（children 随之迁移）\n        result.push(node);\n      } else if (node.children?.length) {\n        // 父节点未选中：继续向下搜寻子节点选中项\n        traverse(node.children);\n      }\n    });\n  }\n\n  traverse(dataSource);\n  return result;\n}\n"],
-  "mappings": "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",
+  "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 { DEFAULT_PAGE_SIZE, type TreeTransferRow } from '../types';\n\n/**\n * 从平铺的数据构建树形结构\n *\n * @param data - 平铺的数据数组\n * @param options - 配置选项\n * @returns 树形结构数据\n *\n * @example\n * ```tsx\n * const flatData = [\n *   { id: '1', parentId: null, name: '应用1' },\n *   { id: '1-1', parentId: '1', name: '权限1' },\n * ];\n *\n * const treeData = buildTreeData(flatData, {\n *   keyField: 'id',\n *   parentField: 'parentId',\n * });\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function buildTreeData<T extends Record<string, any>>(\n  data: T[],\n  options: {\n    /** 唯一键字段名，默认 'id' */\n    keyField?: string;\n    /** 父键字段名，默认 'parentId' */\n    parentField?: string;\n    /** 判断是否为父节点的函数，默认：无父键则为父节点 */\n    isParent?: (item: T) => boolean;\n  } = {},\n): TreeTransferRow<T>[] {\n  const { keyField = 'id', parentField = 'parentId', isParent = (item) => !item[parentField] } = options;\n\n  const map = new Map<string | number, TreeTransferRow<T>>();\n  const roots: TreeTransferRow<T>[] = [];\n\n  // 第一次遍历：建立 key → node 映射\n  data.forEach((item) => {\n    const key = item[keyField];\n    map.set(key, { key, data: item, isParent: isParent(item), children: [] });\n  });\n\n  // 第二次遍历：挂载父子关系\n  data.forEach((item) => {\n    const key = item[keyField];\n    const parentId = item[parentField];\n    const node = map.get(key)!;\n\n    if (parentId && map.has(parentId)) {\n      map.get(parentId)!.children!.push(node);\n    } else {\n      roots.push(node);\n    }\n  });\n\n  return roots;\n}\n\n/**\n * 将树形结构平铺为一维数组（深度优先）\n *\n * @example\n * ```tsx\n * const flat = flattenTreeData([{ key: '1', children: [{ key: '1-1' }] }]);\n * // → [{ key: '1' }, { key: '1-1' }]\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function flattenTreeData<T = any>(treeData: TreeTransferRow<T>[]): TreeTransferRow<T>[] {\n  const result: TreeTransferRow<T>[] = [];\n\n  function traverse(nodes: TreeTransferRow<T>[]) {\n    nodes.forEach((node) => {\n      result.push(node);\n      if (node.children?.length) traverse(node.children);\n    });\n  }\n\n  traverse(treeData);\n  return result;\n}\n\n/**\n * 根据页码切片数据（前端分页）\n *\n * @param data - 数据数组\n * @param page - 页码（从 1 开始）\n * @param pageSize - 每页条数\n * @returns 当前页数据\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function sliceDataByPage<T = any>(\n  data: TreeTransferRow<T>[],\n  page: number,\n  pageSize: number = DEFAULT_PAGE_SIZE,\n): TreeTransferRow<T>[] {\n  const start = (page - 1) * pageSize;\n  return data.slice(start, start + pageSize);\n}\n\n/**\n * 过滤数据（支持模糊搜索，递归保留有匹配子节点的父节点）\n *\n * @param data - 数据数组\n * @param searchValue - 搜索关键词（空字符串返回全量数据）\n * @param fields - 搜索字段列表，支持字段名或自定义取值函数，默认 ['id', 'name']\n * @returns 过滤后的数据\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function filterData<T = any>(\n  data: TreeTransferRow<T>[],\n  searchValue: string,\n  fields: (string | ((item: T) => string))[] = ['id', 'name'],\n): TreeTransferRow<T>[] {\n  if (!searchValue.trim()) return data;\n\n  const lowerSearch = searchValue.toLowerCase();\n\n  return data.filter((item) => {\n    // 当前节点任意字段匹配即保留\n    const selfMatch = fields.some((field) => {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const value = typeof field === 'function' ? field(item.data) : (item.data as any)[field];\n      return String(value ?? '')\n        .toLowerCase()\n        .includes(lowerSearch);\n    });\n\n    if (selfMatch) return true;\n\n    // 子节点有匹配项则保留父节点（子节点也递归过滤）\n    if (item.children?.length) {\n      return filterData(item.children, searchValue, fields).length > 0;\n    }\n\n    return false;\n  });\n}\n\n/**\n * 获取选中节点及其所有后代节点的 key 集合（用于批量移除）\n *\n * 修复说明：原实现对 3+ 层树只展开 2 层。现改为对每个选中节点\n * 递归收集完整后代链，支持任意深度的树结构。\n *\n * @param selectedKeys - 选中的 keys\n * @param dataSource - 完整数据源\n * @returns 所有相关 key（字符串形式，含选中节点本身）\n *\n * @example\n * ```tsx\n * // 选中 'app1'（含 2 级子节点）\n * getAllDescendantKeys(['app1'], dataSource);\n * // → ['app1', 'app1-perm1', 'app1-perm1-sub1', 'app1-perm2', ...]\n * ```\n */\nexport function getAllDescendantKeys(selectedKeys: React.Key[], dataSource: TreeTransferRow[]): string[] {\n  const keySet = new Set(selectedKeys.map(String));\n  const allKeys: string[] = [];\n\n  /** 递归收集节点本身及所有后代的 key */\n  function collectWithDescendants(node: TreeTransferRow): void {\n    allKeys.push(String(node.key));\n    node.children?.forEach(collectWithDescendants);\n  }\n\n  function traverse(nodes: TreeTransferRow[]): void {\n    nodes.forEach((node) => {\n      if (keySet.has(String(node.key))) {\n        // 选中节点：收集自身及全部后代\n        collectWithDescendants(node);\n      } else {\n        // 未选中：继续向下搜索\n        if (node.children?.length) traverse(node.children);\n      }\n    });\n  }\n\n  traverse(dataSource);\n  return allKeys;\n}\n\n/**\n * 计算数据总节点数（包含所有后代）\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function countTotalNodes<T = any>(data: TreeTransferRow<T>[]): number {\n  let count = 0;\n  function traverse(nodes: TreeTransferRow<T>[]) {\n    nodes.forEach((node) => {\n      count += 1;\n      if (node.children?.length) traverse(node.children);\n    });\n  }\n  traverse(data);\n  return count;\n}\n\n/**\n * 计算顶层节点数（用于分页总数，不含嵌套子节点）\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function countParentNodes<T = any>(data: TreeTransferRow<T>[]): number {\n  return data.length;\n}\n\n/**\n * 查找节点及其所有后代节点（按 key 定位）\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function findNodeWithDescendants<T = any>(\n  key: string | number,\n  dataSource: TreeTransferRow<T>[],\n): TreeTransferRow<T>[] {\n  const result: TreeTransferRow<T>[] = [];\n\n  function traverse(nodes: TreeTransferRow<T>[]): boolean {\n    for (const node of nodes) {\n      if (node.key === key) {\n        result.push(node);\n        node.children?.forEach((child) => {\n          result.push(child);\n          if (child.children) traverse(child.children);\n        });\n        return true;\n      }\n      if (node.children && traverse(node.children)) return true;\n    }\n    return false;\n  }\n\n  traverse(dataSource);\n  return result;\n}\n\n/**\n * 从树形数据中移除指定 key 的节点（不可变，返回新数组）\n *\n * @param dataSource - 数据源\n * @param keysToRemove - 要移除的节点 key 集合\n * @returns 过滤后的新数据源\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function removeNodesFromTree<T = any>(\n  dataSource: TreeTransferRow<T>[],\n  keysToRemove: Set<string | number>,\n): TreeTransferRow<T>[] {\n  const result: TreeTransferRow<T>[] = [];\n\n  for (const node of dataSource) {\n    if (keysToRemove.has(node.key)) continue;\n\n    if (node.children?.length) {\n      result.push({ ...node, children: removeNodesFromTree(node.children, keysToRemove) });\n    } else {\n      result.push(node);\n    }\n  }\n\n  return result;\n}\n\n/**\n * 向树形数据添加节点\n *\n * @param dataSource - 数据源\n * @param parentKey - 父节点 key；传 null 表示添加到根\n * @param nodes - 要添加的节点列表\n * @returns 新的数据源\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function addNodesToTree<T = any>(\n  dataSource: TreeTransferRow<T>[],\n  parentKey: string | number | null,\n  nodes: TreeTransferRow<T>[],\n): TreeTransferRow<T>[] {\n  if (parentKey === null) {\n    return [...dataSource, ...nodes];\n  }\n\n  return dataSource.map((node) => {\n    if (node.key === parentKey) {\n      return { ...node, children: [...(node.children ?? []), ...nodes] };\n    }\n    if (node.children) {\n      return { ...node, children: addNodesToTree(node.children, parentKey, nodes) };\n    }\n    return node;\n  });\n}\n\n/**\n * 从树形数据中提取\"顶层选中节点\"（用于穿梭框移动操作）\n *\n * 行为：遍历树，遇到选中节点时直接收集（含其 children），不再向下递归。\n * 这样可以避免父节点和其已选中的子节点被分别添加两次。\n *\n * 适用场景：AntD Table 的 checkStrictly:false 级联选择中，\n * 选中父节点会自动勾选子节点。move 时只需携带父节点（含 children）。\n * 若仅选了某个子节点，则该子节点会被作为顶层节点添加到目标列表。\n *\n * @param selectedKeys - 选中的 key 集合（字符串）\n * @param dataSource - 数据源（支持嵌套树）\n * @returns 最小集合的顶层选中节点列表\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function extractTopLevelSelectedNodes<T = any>(\n  selectedKeys: Set<string>,\n  dataSource: TreeTransferRow<T>[],\n): TreeTransferRow<T>[] {\n  const result: TreeTransferRow<T>[] = [];\n\n  function traverse(nodes: TreeTransferRow<T>[]): void {\n    nodes.forEach((node) => {\n      if (selectedKeys.has(String(node.key))) {\n        // 选中节点：整体移动（children 随之迁移）\n        result.push(node);\n      } else if (node.children?.length) {\n        // 父节点未选中：继续向下搜寻子节点选中项\n        traverse(node.children);\n      }\n    });\n  }\n\n  traverse(dataSource);\n  return result;\n}\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -0,0 +1,11 @@
+/**
+ * Markdown 渲染器组件
+ */
+import React from 'react';
+export interface YKMarkdownProps {
+    markdown: string;
+    showToc?: boolean;
+    language?: string;
+}
+declare const YKMarkdown: React.FC<YKMarkdownProps>;
+export default YKMarkdown;

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

@@ -0,0 +1,188 @@
+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/YKMarkdown/index.tsx
+var YKMarkdown_exports = {};
+__export(YKMarkdown_exports, {
+  default: () => YKMarkdown_default
+});
+module.exports = __toCommonJS(YKMarkdown_exports);
+var import_react_markdown_preview = __toESM(require("@uiw/react-markdown-preview"));
+var import_react = __toESM(require("react"));
+var import_index_module = __toESM(require("./index.module.less"));
+var YKMarkdown = ({ markdown, showToc = false }) => {
+  const contentRef = (0, import_react.useRef)(null);
+  const [headings, setHeadings] = (0, import_react.useState)([]);
+  (0, import_react.useEffect)(() => {
+    if (!showToc) {
+      setHeadings([]);
+      return;
+    }
+    if (!contentRef.current)
+      return;
+    const headingElements = contentRef.current.querySelectorAll("h1, h2, h3, h4, h5, h6");
+    const headingList = Array.from(headingElements).map((el) => ({
+      id: el.id,
+      text: el.textContent || "",
+      level: parseInt(el.tagName.charAt(1), 10)
+    }));
+    setHeadings(headingList);
+  }, [markdown, showToc]);
+  const handleScrollTo = (0, import_react.useCallback)((id) => {
+    const element = document.getElementById(id);
+    if (element) {
+      element.scrollIntoView({ behavior: "smooth", block: "start" });
+    }
+  }, []);
+  return /* @__PURE__ */ import_react.default.createElement("div", { className: import_index_module.default.container }, showToc && headings.length > 0 && /* @__PURE__ */ import_react.default.createElement("div", { className: import_index_module.default.toc }, /* @__PURE__ */ import_react.default.createElement("h3", null, "目录"), /* @__PURE__ */ import_react.default.createElement("ul", { style: { paddingLeft: "16px", fontSize: "12px", color: "#666" } }, headings.map((heading) => /* @__PURE__ */ import_react.default.createElement(
+    "li",
+    {
+      key: heading.id,
+      style: {
+        marginLeft: `${(heading.level - 1) * 12}px`,
+        listStyle: "none",
+        marginBottom: "8px"
+      }
+    },
+    /* @__PURE__ */ import_react.default.createElement(
+      "a",
+      {
+        href: `#${heading.id}`,
+        onClick: (e) => {
+          e.preventDefault();
+          handleScrollTo(heading.id);
+        },
+        style: { color: "#000", textDecoration: "none" }
+      },
+      heading.text
+    )
+  )))), /* @__PURE__ */ import_react.default.createElement("div", { ref: contentRef, className: import_index_module.default.content }, /* @__PURE__ */ import_react.default.createElement(
+    import_react_markdown_preview.default,
+    {
+      source: markdown,
+      components: { code: Code, pre: Pre },
+      style: { padding: 16 }
+    }
+  )), showToc && headings.length > 0 && /* @__PURE__ */ import_react.default.createElement("div", { className: import_index_module.default.spacer }));
+};
+var MermaidCode = ({ code, className }) => {
+  const demoid = (0, import_react.useMemo)(() => `dome${parseInt(String(Math.random() * 1e15), 10).toString(36)}`, []);
+  const [container, setContainer] = (0, import_react.useState)(null);
+  const [mermaidInstance, setMermaidInstance] = (0, import_react.useState)(null);
+  const isMermaid = className && /^language-mermaid/.test(className.toLocaleLowerCase());
+  (0, import_react.useEffect)(() => {
+    if (isMermaid && !mermaidInstance) {
+      import("mermaid").then((mod) => {
+        setMermaidInstance(mod.default || mod);
+      });
+    }
+  }, [isMermaid, mermaidInstance]);
+  const reRender = (0, import_react.useCallback)(async () => {
+    if (container && isMermaid && mermaidInstance) {
+      try {
+        const str = await mermaidInstance.render(demoid, code);
+        container.innerHTML = str.svg;
+      } catch (error) {
+        container.innerHTML = String(error);
+      }
+    }
+  }, [container, isMermaid, code, demoid, mermaidInstance]);
+  (0, import_react.useEffect)(() => {
+    reRender();
+  }, [reRender]);
+  const refElement = (0, import_react.useCallback)((node) => {
+    if (node !== null) {
+      setContainer(node);
+    }
+  }, []);
+  if (isMermaid) {
+    return /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, /* @__PURE__ */ import_react.default.createElement("code", { id: demoid, style: { display: "none" } }), /* @__PURE__ */ import_react.default.createElement("code", { ref: refElement, "data-name": "mermaid" }));
+  }
+  return /* @__PURE__ */ import_react.default.createElement("code", null, code);
+};
+var getCodeString = (children) => {
+  let result = "";
+  const traverse = (nodes) => {
+    for (const node of nodes) {
+      if (typeof node === "object" && node !== null && "type" in node) {
+        const n = node;
+        if (n.type === "text" && n.value) {
+          result += n.value;
+        } else if (n.children) {
+          traverse(n.children);
+        }
+      }
+    }
+  };
+  traverse(children);
+  return result;
+};
+var Code = ({ inline, children, className, node, ...props }) => {
+  if (inline) {
+    return /* @__PURE__ */ import_react.default.createElement("code", { ...props }, children);
+  }
+  const code = (node == null ? void 0 : node.children) ? getCodeString(node.children) : Array.isArray(children) ? String(children[0] || "") : String(children || "");
+  return /* @__PURE__ */ import_react.default.createElement(MermaidCode, { code, className });
+};
+var Pre = ({ children, node, ...props }) => {
+  let codeStr = "";
+  let mermaidCode = "";
+  let mermaidClassName = "";
+  import_react.default.Children.forEach(children, (child) => {
+    var _a, _b;
+    if (import_react.default.isValidElement(child)) {
+      const childProps = child.props;
+      if (childProps == null ? void 0 : childProps.node) {
+        codeStr = getCodeString(childProps.node.children);
+      }
+      if ((_b = (_a = childProps == null ? void 0 : childProps.className) == null ? void 0 : _a.includes) == null ? void 0 : _b.call(_a, "language-mermaid")) {
+        mermaidCode = codeStr;
+        mermaidClassName = childProps.className || "";
+      }
+    }
+  });
+  if (!codeStr && (node == null ? void 0 : node.children)) {
+    codeStr = getCodeString(node.children);
+  }
+  const renderContent = (child) => {
+    var _a, _b, _c, _d;
+    if (import_react.default.isValidElement(child)) {
+      const childElement = child;
+      if ((_c = (_b = (_a = childElement.props) == null ? void 0 : _a.className) == null ? void 0 : _b.includes) == null ? void 0 : _c.call(_b, "language-mermaid")) {
+        return /* @__PURE__ */ import_react.default.createElement(MermaidCode, { code: mermaidCode, className: mermaidClassName });
+      }
+      return import_react.default.cloneElement(childElement, {
+        children: import_react.default.Children.map((_d = childElement.props) == null ? void 0 : _d.children, renderContent)
+      });
+    }
+    return child;
+  };
+  return /* @__PURE__ */ import_react.default.createElement("div", { className: import_index_module.default.codeBlock }, /* @__PURE__ */ import_react.default.createElement("pre", { ...props }, import_react.default.Children.map(children, renderContent)));
+};
+var YKMarkdown_default = YKMarkdown;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/components/YKMarkdown/index.tsx"],
+  "sourcesContent": ["/**\n * Markdown 渲染器组件\n */\n\nimport MarkdownPreview from '@uiw/react-markdown-preview';\nimport React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport styles from './index.module.less';\n\ninterface HeadingItem {\n  id: string;\n  text: string;\n  level: number;\n}\n\nexport interface YKMarkdownProps {\n  markdown: string;\n  showToc?: boolean;\n  language?: string;\n}\n\nconst YKMarkdown: React.FC<YKMarkdownProps> = ({ markdown, showToc = false }) => {\n  const contentRef = useRef<HTMLDivElement>(null);\n  const [headings, setHeadings] = useState<HeadingItem[]>([]);\n\n  useEffect(() => {\n    if (!showToc) {\n      setHeadings([]);\n      return;\n    }\n    if (!contentRef.current) return;\n\n    const headingElements = contentRef.current.querySelectorAll('h1, h2, h3, h4, h5, h6');\n    const headingList: HeadingItem[] = Array.from(headingElements).map((el: HTMLElement) => ({\n      id: el.id,\n      text: el.textContent || '',\n      level: parseInt(el.tagName.charAt(1), 10),\n    }));\n\n    setHeadings(headingList);\n  }, [markdown, showToc]);\n\n  const handleScrollTo = useCallback((id: string) => {\n    const element = document.getElementById(id);\n    if (element) {\n      element.scrollIntoView({ behavior: 'smooth', block: 'start' });\n    }\n  }, []);\n\n  return (\n    <div className={styles.container}>\n      {showToc && headings.length > 0 && (\n        <div className={styles.toc}>\n          <h3>目录</h3>\n          <ul style={{ paddingLeft: '16px', fontSize: '12px', color: '#666' }}>\n            {headings.map((heading) => (\n              <li\n                key={heading.id}\n                style={{\n                  marginLeft: `${(heading.level - 1) * 12}px`,\n                  listStyle: 'none',\n                  marginBottom: '8px',\n                }}\n              >\n                <a\n                  href={`#${heading.id}`}\n                  onClick={(e) => {\n                    e.preventDefault();\n                    handleScrollTo(heading.id);\n                  }}\n                  style={{ color: '#000', textDecoration: 'none' }}\n                >\n                  {heading.text}\n                </a>\n              </li>\n            ))}\n          </ul>\n        </div>\n      )}\n\n      <div ref={contentRef} className={styles.content}>\n        <MarkdownPreview\n          source={markdown}\n          components={{ code: Code as React.ComponentType, pre: Pre as React.ComponentType }}\n          style={{ padding: 16 }}\n        />\n      </div>\n\n      {showToc && headings.length > 0 && <div className={styles.spacer} />}\n    </div>\n  );\n};\n\ninterface MermaidInstance {\n  render: (id: string, code: string) => Promise<{ svg: string }>;\n}\n\nconst MermaidCode: React.FC<{ code: string; className?: string }> = ({ code, className }) => {\n  const demoid = useMemo(() => `dome${parseInt(String(Math.random() * 1e15), 10).toString(36)}`, []);\n  const [container, setContainer] = useState<HTMLElement | null>(null);\n  const [mermaidInstance, setMermaidInstance] = useState<MermaidInstance | null>(null);\n  const isMermaid = className && /^language-mermaid/.test(className.toLocaleLowerCase());\n\n  useEffect(() => {\n    if (isMermaid && !mermaidInstance) {\n      import('mermaid').then((mod) => {\n        // @ts-expect-error mermaid module type\n        setMermaidInstance(mod.default || mod);\n      });\n    }\n  }, [isMermaid, mermaidInstance]);\n\n  const reRender = useCallback(async () => {\n    if (container && isMermaid && mermaidInstance) {\n      try {\n        const str = await mermaidInstance.render(demoid, code);\n        container.innerHTML = str.svg;\n      } catch (error) {\n        container.innerHTML = String(error);\n      }\n    }\n  }, [container, isMermaid, code, demoid, mermaidInstance]);\n\n  useEffect(() => {\n    reRender();\n  }, [reRender]);\n\n  const refElement = useCallback((node: HTMLElement | null) => {\n    if (node !== null) {\n      setContainer(node);\n    }\n  }, []);\n\n  if (isMermaid) {\n    return (\n      <>\n        <code id={demoid} style={{ display: 'none' }} />\n        <code ref={refElement} data-name='mermaid' />\n      </>\n    );\n  }\n  return <code>{code}</code>;\n};\n\ninterface CodeProps {\n  inline?: boolean;\n  children?: React.ReactNode;\n  className?: string;\n  node?: { children?: unknown[] };\n  [key: string]: unknown;\n}\n\nconst getCodeString = (children: unknown[]): string => {\n  let result = '';\n  const traverse = (nodes: unknown[]) => {\n    for (const node of nodes) {\n      if (typeof node === 'object' && node !== null && 'type' in node) {\n        const n = node as { type: string; children?: unknown[]; value?: string };\n        if (n.type === 'text' && n.value) {\n          result += n.value;\n        } else if (n.children) {\n          traverse(n.children);\n        }\n      }\n    }\n  };\n  traverse(children);\n  return result;\n};\n\nconst Code: React.FC<CodeProps> = ({ inline, children, className, node, ...props }) => {\n  if (inline) {\n    return <code {...props}>{children}</code>;\n  }\n  const code = node?.children\n    ? getCodeString(node.children as unknown[])\n    : Array.isArray(children)\n      ? String(children[0] || '')\n      : String(children || '');\n  return <MermaidCode code={code} className={className} />;\n};\n\ninterface PreProps {\n  children?: React.ReactNode;\n  node?: { children?: unknown[] };\n  [key: string]: unknown;\n}\n\nconst Pre: React.FC<PreProps> = ({ children, node, ...props }) => {\n  let codeStr = '';\n  let mermaidCode = '';\n  let mermaidClassName = '';\n  React.Children.forEach(children, (child) => {\n    if (React.isValidElement(child)) {\n      const childProps = child.props as CodeProps;\n      if (childProps?.node) {\n        codeStr = getCodeString(childProps.node.children as unknown[]);\n      }\n      if (childProps?.className?.includes?.('language-mermaid')) {\n        mermaidCode = codeStr;\n        mermaidClassName = childProps.className || '';\n      }\n    }\n  });\n  if (!codeStr && node?.children) {\n    codeStr = getCodeString(node.children as unknown[]);\n  }\n\n  const renderContent = (child: React.ReactNode): React.ReactNode => {\n    if (React.isValidElement(child)) {\n      const childElement = child as React.ReactElement<{ children?: React.ReactNode; className?: string }>;\n      if (childElement.props?.className?.includes?.('language-mermaid')) {\n        return <MermaidCode code={mermaidCode} className={mermaidClassName} />;\n      }\n      return React.cloneElement(childElement, {\n        children: React.Children.map(childElement.props?.children, renderContent),\n      });\n    }\n    return child;\n  };\n\n  return (\n    <div className={styles.codeBlock}>\n      <pre {...props}>{React.Children.map(children, renderContent)}</pre>\n    </div>\n  );\n};\n\nexport default YKMarkdown;\n"],
+  "mappings": "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",
+  "names": ["React", "styles", "MarkdownPreview"]
+}

package/dist/lib/components/YKMarkdown/index.module.less

@@ -0,0 +1,83 @@
+.container {
+  display: flex;
+  gap: 24px;
+  position: relative;
+}
+
+.toc {
+  width: 220px;
+  flex-shrink: 0;
+  position: sticky;
+  top: 80px;
+  max-height: calc(100vh - 96px);
+  overflow-y: auto;
+  z-index: 10;
+  background-color: #fff;
+}
+
+.content {
+  flex: 1;
+  min-width: 0;
+}
+
+.codeBlock {
+  position: relative;
+
+  .copyBtn {
+    position: absolute;
+    top: 8px;
+    right: 8px;
+    padding: 4px 8px;
+    background: rgba(255, 255, 255, 0.1);
+    border: 1px solid rgba(255, 255, 255, 0.2);
+    border-radius: 4px;
+    cursor: pointer;
+    color: #999;
+    font-size: 12px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: all 0.2s;
+    z-index: 10;
+    opacity: 0;
+
+    &:hover {
+      background: rgba(255, 255, 255, 0.2);
+      color: #fff;
+    }
+
+    &.success {
+      color: #52c41a;
+      border-color: #52c41a;
+      opacity: 1;
+    }
+  }
+}
+
+.codeBlock:hover .copyBtn {
+  opacity: 1;
+}
+
+.spacer {
+  width: 220px;
+  flex-shrink: 0;
+}
+
+@media (max-width: 1024px) {
+  .container {
+    flex-direction: column;
+    gap: 16px;
+  }
+
+  .toc {
+    width: 100%;
+    position: static;
+    max-height: none;
+    border-bottom: 1px solid #eee;
+    padding-bottom: 16px;
+  }
+
+  .spacer {
+    display: none;
+  }
+}