@yoka-ui/ui 1.0.10-test

package/dist/es/components/TextWithToolTip/index.js

@@ -0,0 +1,118 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+
+// src/components/TextWithToolTip/index.tsx
+import { Tooltip } from "antd";
+import React, { useRef, useState } from "react";
+var TextWithTooltip = ({
+  text,
+  placement = "top",
+  zIndex,
+  width,
+  maxWidth,
+  className,
+  style = {},
+  color,
+  styles,
+  highlight = "",
+  arrow = false
+}) => {
+  const [showTooltip, setShowTooltip] = useState(false);
+  const textRef = useRef(null);
+  const handleMouseEnter = () => {
+    if (textRef.current) {
+      const range = document.createRange();
+      range.selectNodeContents(textRef.current);
+      const rangeWidth = range.getBoundingClientRect().width;
+      const actualWidth = textRef.current.getBoundingClientRect().width;
+      setShowTooltip(rangeWidth > actualWidth);
+    }
+  };
+  function splitString(str, delimiter) {
+    const result = [];
+    let match;
+    const escapedDelimiter = delimiter.replace(/[-/\\^$*+?.()|[\]{}]/g, "\\$&");
+    const regex = new RegExp(`(${escapedDelimiter})`, "gi");
+    let remaining = str;
+    while ((match = regex.exec(remaining)) !== null) {
+      const index = match.index;
+      if (index !== 0) {
+        result.push(remaining.slice(0, index));
+      }
+      result.push(match[1]);
+      remaining = remaining.slice(index + match[1].length);
+      regex.lastIndex = 0;
+    }
+    if (remaining.length > 0) {
+      result.push(remaining);
+    }
+    return result;
+  }
+  const highlightedText = (text2) => {
+    if (highlight && (typeof text2 === "string" || typeof text2 === "number")) {
+      return splitString(text2.toString(), highlight).map((part, index) => {
+        if (part.toUpperCase() === highlight.toUpperCase()) {
+          return /* @__PURE__ */ React.createElement("span", { key: index, style: { color: "#ffb401" } }, part);
+        } else {
+          return /* @__PURE__ */ React.createElement("span", { key: index }, part);
+        }
+      });
+    } else {
+      return text2;
+    }
+  };
+  const formatWidth = (value) => {
+    if (typeof value === "string" && /^\d+$/.test(value)) {
+      return `${value}px`;
+    }
+    return value;
+  };
+  return /* @__PURE__ */ React.createElement(
+    Tooltip,
+    __spreadValues({
+      open: showTooltip,
+      title: text,
+      placement,
+      arrow,
+      destroyOnHidden: true,
+      color: color ? color : "#fff",
+      styles: styles ? styles : { body: { color: "#333", fontSize: 12 } }
+    }, zIndex ? { zIndex } : {}),
+    /* @__PURE__ */ React.createElement(
+      "span",
+      {
+        ref: textRef,
+        onMouseEnter: handleMouseEnter,
+        onMouseLeave: () => setShowTooltip(false),
+        className,
+        style: __spreadValues(__spreadValues({
+          display: "inline-block",
+          overflow: "hidden",
+          textOverflow: "ellipsis",
+          whiteSpace: "nowrap",
+          verticalAlign: "bottom"
+        }, style), maxWidth ? { maxWidth: formatWidth(maxWidth) } : { width: formatWidth(width) })
+      },
+      highlightedText(text)
+    )
+  );
+};
+var TextWithToolTip_default = TextWithTooltip;
+export {
+  TextWithToolTip_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/es/components/TextWithToolTip/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/components/TextWithToolTip/index.tsx"],
+  "sourcesContent": ["import { Tooltip, TooltipProps } from 'antd';\nimport React, { useRef, useState } from 'react';\n\ntype PropsType = {\n  text: number | string | React.ReactNode;\n  placement?: 'top' | 'left' | 'right' | 'bottom';\n  zIndex?: number;\n  color?: string;\n  styles?: TooltipProps['styles'];\n  width: number | string;\n  maxWidth?: number | string;\n  className?: string;\n  style?: React.CSSProperties;\n  highlight?: string; // 高亮的关键字\n  arrow?: boolean;\n};\n\nconst TextWithTooltip: React.FC<PropsType> = ({\n  text,\n  placement = 'top',\n  zIndex,\n  width,\n  maxWidth,\n  className,\n  style = {},\n  color,\n  styles,\n  highlight = '',\n  arrow = false,\n}) => {\n  const [showTooltip, setShowTooltip] = useState(false);\n  const textRef = useRef(null);\n\n  const handleMouseEnter = () => {\n    if (textRef.current) {\n      const range = document.createRange();\n      range.selectNodeContents(textRef.current);\n      const rangeWidth = range.getBoundingClientRect().width;\n      const actualWidth = (textRef.current as HTMLElement).getBoundingClientRect().width;\n      setShowTooltip(rangeWidth > actualWidth);\n    }\n  };\n\n  // 将text按照高亮关键字拆分成数组\n  function splitString(str: string, delimiter: string) {\n    const result = [];\n    let match;\n    const escapedDelimiter = delimiter.replace(/[-/\\\\^$*+?.()|[\\]{}]/g, '\\\\$&');\n    const regex = new RegExp(`(${escapedDelimiter})`, 'gi');\n    let remaining = str; // 新建变量存储剩余字符串\n\n    while ((match = regex.exec(remaining)) !== null) {\n      const index = match.index;\n      if (index !== 0) {\n        result.push(remaining.slice(0, index));\n      }\n      result.push(match[1]);\n      remaining = remaining.slice(index + match[1].length);\n      regex.lastIndex = 0;\n    }\n    if (remaining.length > 0) {\n      result.push(remaining);\n    }\n    return result;\n  }\n\n  // text是ReactNode时，不处理高亮\n  const highlightedText = (text: number | string | React.ReactNode): React.ReactNode => {\n    if (highlight && (typeof text === 'string' || typeof text === 'number')) {\n      return splitString(text.toString(), highlight).map((part, index) => {\n        if (part.toUpperCase() === highlight.toUpperCase()) {\n          return (\n            <span key={index} style={{ color: '#ffb401' }}>\n              {part}\n            </span>\n          );\n        } else {\n          return <span key={index}>{part}</span>;\n        }\n      });\n    } else {\n      return text;\n    }\n  };\n\n  // 处理宽度值，确保字符串数字能正确转换为带单位的 CSS 值\n  const formatWidth = (value: number | string): number | string => {\n    if (typeof value === 'string' && /^\\d+$/.test(value)) {\n      // 如果是纯数字字符串，添加 px 单位\n      return `${value}px`;\n    }\n    return value;\n  };\n\n  return (\n    <Tooltip\n      open={showTooltip}\n      title={text}\n      placement={placement}\n      arrow={arrow}\n      destroyOnHidden={true}\n      color={color ? color : '#fff'}\n      styles={styles ? styles : { body: { color: '#333', fontSize: 12 } }}\n      {...(zIndex ? { zIndex } : {})}\n    >\n      <span\n        ref={textRef}\n        onMouseEnter={handleMouseEnter}\n        onMouseLeave={() => setShowTooltip(false)}\n        className={className}\n        style={{\n          display: 'inline-block',\n          overflow: 'hidden',\n          textOverflow: 'ellipsis',\n          whiteSpace: 'nowrap',\n          verticalAlign: 'bottom',\n          ...style,\n          ...(maxWidth ? { maxWidth: formatWidth(maxWidth) } : { width: formatWidth(width) }),\n        }}\n      >\n        {highlightedText(text)}\n      </span>\n    </Tooltip>\n  );\n};\n\nexport default TextWithTooltip;\n"],
+  "mappings": "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",
+  "names": ["text"]
+}

package/dist/es/components/TreeTransfer/components/TreeTransferPanel/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * TreeTransferPanel
+ *
+ * 树形穿梭框单侧面板：搜索框 + 树形表格 + 分页器。
+ *
+ * @example
+ * ```tsx
+ * <TreeTransferPanel
+ *   dataSource={data}
+ *   selectedRowKeys={selectedKeys}
+ *   onRowSelect={handleRowSelect}
+ *   searchValue={searchValue}
+ *   setSearchValue={setSearchValue}
+ *   totalCount={totalCount}
+ *   title="待分配项"
+ *   showPagination={true}
+ *   currentPage={currentPage}
+ *   pageSize={20}
+ *   onPageChange={handlePageChange}
+ *   columns={customColumns}
+ * />
+ * ```
+ */
+import React from 'react';
+import { TreeTransferPanelProps } from '../../types';
+import './index.less';
+declare const TreeTransferPanel: <T>({ dataSource, selectedRowKeys, onRowSelect, searchValue, setSearchValue, totalCount, title, showPagination, currentPage, pageSize, onPageChange, columns: customColumns, customRender, searchPlaceholder, }: TreeTransferPanelProps<T>) => React.JSX.Element;
+export default TreeTransferPanel;

package/dist/es/components/TreeTransfer/components/TreeTransferPanel/index.js

@@ -0,0 +1,161 @@
+// src/components/TreeTransfer/components/TreeTransferPanel/index.tsx
+import React, { useMemo, useRef, useState, useEffect, useCallback } from "react";
+import { Table, Input, Empty, Pagination, Typography, Tooltip } from "antd";
+import { SearchOutlined } from "@ant-design/icons";
+import { DEFAULT_PAGE_SIZE } from "../../types";
+import "./index.less";
+var { Text } = Typography;
+var HEADER_HEIGHT = 34;
+var SEARCH_HEIGHT = 44;
+var PAGINATION_HEIGHT = 36;
+var MARGIN = 8;
+var EXTRA_PADDING = 60;
+var MIN_SCROLL_Y = 100;
+var TreeTransferPanel = ({
+  dataSource,
+  selectedRowKeys,
+  onRowSelect,
+  searchValue,
+  setSearchValue,
+  totalCount,
+  title,
+  showPagination = false,
+  currentPage = 1,
+  pageSize = DEFAULT_PAGE_SIZE,
+  onPageChange,
+  columns: customColumns,
+  customRender,
+  searchPlaceholder
+}) => {
+  const panelRef = useRef(null);
+  const [tableScrollY, setTableScrollY] = useState(void 0);
+  useEffect(() => {
+    if (!panelRef.current)
+      return void 0;
+    let rafId;
+    const calculateScrollHeight = () => {
+      var _a, _b;
+      const panelHeight = (_b = (_a = panelRef.current) == null ? void 0 : _a.clientHeight) != null ? _b : 0;
+      const paginationOffset = showPagination ? PAGINATION_HEIGHT : 0;
+      const available = panelHeight - HEADER_HEIGHT - SEARCH_HEIGHT - paginationOffset - MARGIN - EXTRA_PADDING;
+      setTableScrollY(Math.max(available, MIN_SCROLL_Y));
+    };
+    const scheduleCalc = () => {
+      cancelAnimationFrame(rafId);
+      rafId = requestAnimationFrame(calculateScrollHeight);
+    };
+    scheduleCalc();
+    const resizeObserver = new ResizeObserver(scheduleCalc);
+    resizeObserver.observe(panelRef.current);
+    const mutationObserver = new MutationObserver(scheduleCalc);
+    const tableBody = panelRef.current.querySelector(".ant-table-tbody");
+    if (tableBody) {
+      mutationObserver.observe(tableBody, {
+        childList: true,
+        subtree: true,
+        attributes: true,
+        attributeFilter: ["class"]
+      });
+    }
+    return () => {
+      cancelAnimationFrame(rafId);
+      resizeObserver.disconnect();
+      mutationObserver.disconnect();
+    };
+  }, [showPagination]);
+  const defaultColumns = useMemo(
+    () => [
+      {
+        title: "ID",
+        dataIndex: "key",
+        key: "id",
+        width: "35%",
+        onCell: (record) => record.isParent ? {} : { colSpan: 0 },
+        render: (_, record) => record.isParent ? String(record.key) : ""
+      },
+      {
+        title: "名称",
+        dataIndex: "data",
+        key: "name",
+        width: "65%",
+        ellipsis: { showTitle: false },
+        onCell: (record) => {
+          if (!record.isParent)
+            return { colSpan: 2 };
+          return (customRender == null ? void 0 : customRender.onCell) ? customRender.onCell(record) : {};
+        },
+        render: (_, record, index) => {
+          if (customRender == null ? void 0 : customRender.cellRender)
+            return customRender.cellRender(_, record, index);
+          const content = JSON.stringify(record.data);
+          if (content.length > 20) {
+            return /* @__PURE__ */ React.createElement(Tooltip, { placement: "topLeft", title: content }, content);
+          }
+          return content;
+        }
+      }
+    ],
+    [customRender]
+  );
+  const columns = customColumns != null ? customColumns : defaultColumns;
+  const rowSelection = useMemo(
+    () => ({
+      selectedRowKeys,
+      onChange: (selectedKeys, selectedRows) => {
+        onRowSelect(selectedRows, selectedKeys);
+      },
+      checkStrictly: false,
+      columnWidth: 50
+    }),
+    [selectedRowKeys, onRowSelect]
+  );
+  const handleSearchChange = useCallback(
+    (e) => setSearchValue(e.target.value),
+    [setSearchValue]
+  );
+  return /* @__PURE__ */ React.createElement("div", { ref: panelRef, className: "tree-transfer-panel" }, /* @__PURE__ */ React.createElement("div", { className: "tree-transfer-panel-header" }, /* @__PURE__ */ React.createElement(Text, null, title), /* @__PURE__ */ React.createElement(Text, { type: "secondary" }, "(", totalCount, ")")), /* @__PURE__ */ React.createElement("div", { className: "tree-transfer-panel-search" }, /* @__PURE__ */ React.createElement(
+    Input,
+    {
+      placeholder: searchPlaceholder != null ? searchPlaceholder : "搜索",
+      prefix: /* @__PURE__ */ React.createElement(SearchOutlined, null),
+      value: searchValue,
+      onChange: handleSearchChange,
+      allowClear: true
+    }
+  )), /* @__PURE__ */ React.createElement("div", { className: "tree-transfer-panel-content" }, dataSource.length > 0 ? /* @__PURE__ */ React.createElement(
+    Table,
+    {
+      rowKey: "key",
+      columns,
+      dataSource,
+      rowSelection,
+      expandable: {
+        childrenColumnName: "children",
+        defaultExpandAllRows: true,
+        indentSize: 30
+      },
+      pagination: false,
+      size: "small",
+      className: "tree-transfer-table",
+      scroll: tableScrollY !== void 0 ? { y: tableScrollY } : void 0
+    }
+  ) : /* @__PURE__ */ React.createElement(Empty, { description: "暂无数据", image: Empty.PRESENTED_IMAGE_SIMPLE })), showPagination && onPageChange && totalCount > pageSize && /* @__PURE__ */ React.createElement("div", { className: "tree-transfer-panel-pagination" }, /* @__PURE__ */ React.createElement(
+    Pagination,
+    {
+      current: currentPage,
+      pageSize,
+      total: totalCount,
+      showSizeChanger: false,
+      showQuickJumper: false,
+      showTitle: false,
+      onChange: onPageChange,
+      size: "small",
+      simple: true
+    }
+  )));
+};
+var TreeTransferPanel_default = TreeTransferPanel;
+export {
+  TreeTransferPanel_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/es/components/TreeTransfer/components/TreeTransferPanel/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/components/TreeTransfer/components/TreeTransferPanel/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 * TreeTransferPanel\n *\n * 树形穿梭框单侧面板：搜索框 + 树形表格 + 分页器。\n *\n * @example\n * ```tsx\n * <TreeTransferPanel\n *   dataSource={data}\n *   selectedRowKeys={selectedKeys}\n *   onRowSelect={handleRowSelect}\n *   searchValue={searchValue}\n *   setSearchValue={setSearchValue}\n *   totalCount={totalCount}\n *   title=\"待分配项\"\n *   showPagination={true}\n *   currentPage={currentPage}\n *   pageSize={20}\n *   onPageChange={handlePageChange}\n *   columns={customColumns}\n * />\n * ```\n */\n\nimport React, { useMemo, useRef, useState, useEffect, useCallback } from 'react';\nimport { Table, Input, Empty, Pagination, Typography, Tooltip } from 'antd';\nimport type { ColumnsType } from 'antd/es/table';\nimport { SearchOutlined } from '@ant-design/icons';\nimport { TreeTransferPanelProps, TreeTransferRow, DEFAULT_PAGE_SIZE } from '../../types';\nimport './index.less';\n\nconst { Text } = Typography;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// 固定元素高度常量（与 CSS 保持一致）\n// ─────────────────────────────────────────────────────────────────────────────\nconst HEADER_HEIGHT = 34; // .tree-transfer-panel-header padding + border\nconst SEARCH_HEIGHT = 44; // .tree-transfer-panel-search padding + input\nconst PAGINATION_HEIGHT = 36; // .tree-transfer-panel-pagination\nconst MARGIN = 8; // 底部预留间距\nconst EXTRA_PADDING = 60; // 最后一行防遮挡预留空间\nconst MIN_SCROLL_Y = 100; // 表格最小可见高度（px）\n\n// ─────────────────────────────────────────────────────────────────────────────\n// TreeTransferPanel\n// ─────────────────────────────────────────────────────────────────────────────\n\nconst TreeTransferPanel = <T,>({\n  dataSource,\n  selectedRowKeys,\n  onRowSelect,\n  searchValue,\n  setSearchValue,\n  totalCount,\n  title,\n  showPagination = false,\n  currentPage = 1,\n  pageSize = DEFAULT_PAGE_SIZE,\n  onPageChange,\n  columns: customColumns,\n  customRender,\n  searchPlaceholder,\n}: TreeTransferPanelProps<T>) => {\n  const panelRef = useRef<HTMLDivElement>(null);\n\n  // 表格滚动高度（undefined 表示尚未计算完成，Table 自适应）\n  const [tableScrollY, setTableScrollY] = useState<number | undefined>(undefined);\n\n  // ── 动态计算表格可滚动高度 ─────────────────────────────────────────────────\n  //\n  // 计算逻辑：面板总高 - 固定头部/搜索/分页区域高度 = 表格可用高度。\n  //\n  // 修复说明：\n  // 1. 初始值改为 undefined，避免 Table 短暂以 scroll.y=0 渲染导致高度坍塌。\n  // 2. MutationObserver 回调中原使用 setTimeout(fn, 150)，每次 DOM 变化都会\n  //    入队新定时器；树形展开时大量 mutation 会堆积数十个 timer。\n  //    修复：改用 requestAnimationFrame，每次只在下一帧执行一次计算。\n  // 3. 移除 `dataSource` 出 deps：dataSource 每次 render 都是新数组引用，\n  //    导致 observer 被频繁拆卸/重建。表格内容的 DOM 变化已由 MutationObserver 捕获，\n  //    无需在数据变化时重建整个 effect。\n  //\n  useEffect(() => {\n    if (!panelRef.current) return undefined;\n\n    let rafId: number;\n\n    const calculateScrollHeight = () => {\n      const panelHeight = panelRef.current?.clientHeight ?? 0;\n      const paginationOffset = showPagination ? PAGINATION_HEIGHT : 0;\n      const available = panelHeight - HEADER_HEIGHT - SEARCH_HEIGHT - paginationOffset - MARGIN - EXTRA_PADDING;\n      setTableScrollY(Math.max(available, MIN_SCROLL_Y));\n    };\n\n    const scheduleCalc = () => {\n      cancelAnimationFrame(rafId);\n      rafId = requestAnimationFrame(calculateScrollHeight);\n    };\n\n    // 初次计算\n    scheduleCalc();\n\n    // 监听面板容器尺寸（窗口 resize、flex 布局变化等）\n    const resizeObserver = new ResizeObserver(scheduleCalc);\n    resizeObserver.observe(panelRef.current);\n\n    // 监听表格 DOM 变化（树形行展开 / 收起会增删行节点）\n    const mutationObserver = new MutationObserver(scheduleCalc);\n    const tableBody = panelRef.current.querySelector('.ant-table-tbody');\n    if (tableBody) {\n      mutationObserver.observe(tableBody, {\n        childList: true,\n        subtree: true,\n        attributes: true,\n        attributeFilter: ['class'],\n      });\n    }\n\n    return () => {\n      cancelAnimationFrame(rafId);\n      resizeObserver.disconnect();\n      mutationObserver.disconnect();\n    };\n  }, [showPagination]); // 只在 showPagination 变化时重建（影响固定高度计算）\n\n  // ── 默认列配置 ─────────────────────────────────────────────────────────────\n  // 第一列：父节点显示 ID，子节点合并到名称列（colSpan:0）\n  // 第二列：名称列，子节点 colSpan:2 占满整行\n  const defaultColumns: ColumnsType<TreeTransferRow<T>> = useMemo(\n    () => [\n      {\n        title: 'ID',\n        dataIndex: 'key',\n        key: 'id',\n        width: '35%',\n        onCell: (record: TreeTransferRow<T>) => (record.isParent ? {} : { colSpan: 0 }),\n        render: (_: unknown, record: TreeTransferRow<T>) => (record.isParent ? String(record.key) : ''),\n      },\n      {\n        title: '名称',\n        dataIndex: 'data',\n        key: 'name',\n        width: '65%',\n        ellipsis: { showTitle: false },\n        onCell: (record: TreeTransferRow<T>) => {\n          if (!record.isParent) return { colSpan: 2 };\n          return customRender?.onCell ? customRender.onCell(record) : {};\n        },\n        render: (_: unknown, record: TreeTransferRow<T>, index: number) => {\n          if (customRender?.cellRender) return customRender.cellRender(_, record, index);\n          const content = JSON.stringify(record.data);\n          if (content.length > 20) {\n            return (\n              <Tooltip placement='topLeft' title={content}>\n                {content}\n              </Tooltip>\n            );\n          }\n          return content;\n        },\n      },\n    ],\n    [customRender],\n  );\n\n  // 优先使用调用方传入的列配置\n  const columns = customColumns ?? defaultColumns;\n\n  // ── 行选择配置 ─────────────────────────────────────────────────────────────\n  // checkStrictly:false — 选中父节点时自动全选子节点\n  const rowSelection = useMemo(\n    () => ({\n      selectedRowKeys,\n      onChange: (selectedKeys: React.Key[], selectedRows: TreeTransferRow<T>[]) => {\n        onRowSelect(selectedRows, selectedKeys);\n      },\n      checkStrictly: false,\n      columnWidth: 50,\n    }),\n    [selectedRowKeys, onRowSelect],\n  );\n\n  // ── 搜索框 onChange ────────────────────────────────────────────────────────\n  const handleSearchChange = useCallback(\n    (e: React.ChangeEvent<HTMLInputElement>) => setSearchValue(e.target.value),\n    [setSearchValue],\n  );\n\n  // ── 渲染 ──────────────────────────────────────────────────────────────────\n\n  return (\n    <div ref={panelRef} className='tree-transfer-panel'>\n      {/* 头部：标题和数量 */}\n      <div className='tree-transfer-panel-header'>\n        <Text>{title}</Text>\n        <Text type='secondary'>({totalCount})</Text>\n      </div>\n\n      {/* 搜索框 */}\n      <div className='tree-transfer-panel-search'>\n        <Input\n          placeholder={searchPlaceholder ?? '搜索'}\n          prefix={<SearchOutlined />}\n          value={searchValue}\n          onChange={handleSearchChange}\n          allowClear\n        />\n      </div>\n\n      {/* 表格内容区域 */}\n      <div className='tree-transfer-panel-content'>\n        {dataSource.length > 0 ? (\n          <Table\n            rowKey='key'\n            columns={columns}\n            dataSource={dataSource}\n            rowSelection={rowSelection}\n            expandable={{\n              childrenColumnName: 'children',\n              defaultExpandAllRows: true,\n              indentSize: 30,\n            }}\n            pagination={false}\n            size='small'\n            className='tree-transfer-table'\n            // tableScrollY 未计算完成时不传 y，Table 自适应高度，避免初始高度坍塌\n            scroll={tableScrollY !== undefined ? { y: tableScrollY } : undefined}\n          />\n        ) : (\n          <Empty description='暂无数据' image={Empty.PRESENTED_IMAGE_SIMPLE} />\n        )}\n      </div>\n\n      {/* 分页器：数据超过 1 页才显示 */}\n      {showPagination && onPageChange && totalCount > pageSize && (\n        <div className='tree-transfer-panel-pagination'>\n          <Pagination\n            current={currentPage}\n            pageSize={pageSize}\n            total={totalCount}\n            showSizeChanger={false}\n            showQuickJumper={false}\n            showTitle={false}\n            onChange={onPageChange}\n            size='small'\n            simple\n          />\n        </div>\n      )}\n    </div>\n  );\n};\n\nexport default TreeTransferPanel;\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/es/components/TreeTransfer/components/TreeTransferPanel/index.less

@@ -0,0 +1,151 @@
+/*
+ *  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-panel {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  min-width: 350px;
+  max-width: 500px;
+  background: #fff;
+  border-radius: 4px;
+  overflow: hidden;
+
+  // 头部区域
+  .tree-transfer-panel-header {
+    display: flex;
+    justify-content: flex-start;
+    align-items: center;
+    padding-top: 12px;
+    padding-bottom: 12px;
+    padding-left: 17px;
+    background: #fafafa;
+    border-bottom: 1px solid #f0f0f0;
+    flex-shrink: 0;
+    gap: 8px;
+
+    .ant-typography {
+      margin-bottom: 0;
+      font-size: 14px;
+      font-weight: normal;
+    }
+  }
+
+  // 搜索区域
+  .tree-transfer-panel-search {
+    padding: 12px 16px;
+    flex-shrink: 0;
+  }
+
+  // 表格内容区域
+  .tree-transfer-panel-content {
+    flex: 1;
+    overflow: hidden;
+
+    .tree-transfer-table {
+      .ant-table {
+        font-size: 13px;
+        border: 1px solid #f0f0f0;
+
+        // 去掉列边线，保留行边线
+        .ant-table-tbody > tr > td {
+          border-left: none;
+          border-right: none;
+        }
+
+        // 表头样式
+        .ant-table-thead > tr > th {
+          padding: 8px 12px;
+          background: #fafafa;
+          font-weight: 500;
+          font-size: 13px;
+          border-left: none;
+          border-right: none;
+          border-bottom: 1px solid #f0f0f0;
+        }
+
+        // 单元格样式
+        .ant-table-tbody > tr > td {
+          padding: 8px 12px;
+        }
+
+        // 树形展开图标样式
+        .ant-table-row-expand-icon {
+          width: 16px;
+          height: 16px;
+          line-height: 14px;
+          font-size: 10px;
+        }
+
+        // 展开行背景色
+        .ant-table-expanded-row {
+          background: #fafafa;
+        }
+
+        // 强制子项缩进30px
+        .ant-table-tbody > tr.ant-table-row-level-1 > td {
+          padding-left: 32px !important;
+        }
+
+        // 第一层不缩进
+        .ant-table-tbody > tr.ant-table-row-level-0 > td {
+          padding-left: 12px;
+        }
+
+        // 复选框样式
+        .ant-checkbox-wrapper {
+          .ant-checkbox {
+            .ant-checkbox-inner {
+              width: 14px;
+              height: 14px;
+            }
+          }
+        }
+
+        // 空状态样式
+        .ant-empty {
+          padding: 40px 0;
+        }
+      }
+    }
+
+    // 空状态容器
+    .ant-empty {
+      height: 100%;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+    }
+  }
+
+  // 分页器区域
+  .tree-transfer-panel-pagination {
+    padding: 12px 16px;
+    border-top: 1px solid #f0f0f0;
+    flex-shrink: 0;
+    display: flex;
+    justify-content: center;
+
+    .ant-space-compact {
+      .ant-btn {
+        min-width: 70px;
+        font-size: 12px;
+      }
+    }
+  }
+}

package/dist/es/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;