@rainbow-oh/yee-c 0.6.4 → 0.8.0

package/dist/esm/Select/select.js

@@ -1,4 +1,4 @@
-var _excluded = ["prefixCls", "options", "placement", "mode", "value", "defaultValue", "optionFilterProp", "disabled", "onChange", "onFilter", "virtual", "itemHeight", "listHeight", "orphanClassName", "orphanStyle"];
+var _excluded = ["prefixCls", "options", "placement", "mode", "value", "defaultValue", "optionFilterProp", "disabled", "onChange", "onFilter", "virtual", "itemHeight", "listHeight", "columns", "popupWidth", "looseMatch", "orphanClassName", "orphanStyle"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
@@ -22,6 +22,24 @@ import mergeContextToProps from "../utils/mergeContextToProps";
 import useSelectKeyboard from "./hooks/useSelectKeyboard";
 import Options from "./options";
 import "./style/index.less";
+
+// ---------------------------------------------------------------------------
+// Value comparison utilities (module-level for stable references)
+// ---------------------------------------------------------------------------
+
+/** Compare two values: loose mode uses String() conversion, strict uses ===. */
+function matchValue(a, b, loose) {
+  if (loose) return String(a) === String(b);
+  return a === b;
+}
+
+/** Check if a value exists in a keys array with optional loose matching. */
+function keysIncludes(keys, val, loose) {
+  if (loose) return keys.some(function (k) {
+    return String(k) === String(val);
+  });
+  return keys.includes(val);
+}
 var Select = function Select(baseprops) {
   var _useContext = useContext(GlobalContext),
     select = _useContext.select;
@@ -43,6 +61,11 @@ var Select = function Select(baseprops) {
     virtual = props.virtual,
     itemHeight = props.itemHeight,
     listHeight = props.listHeight,
+    _props$columns = props.columns,
+    columns = _props$columns === void 0 ? 1 : _props$columns,
+    popupWidth = props.popupWidth,
+    _props$looseMatch = props.looseMatch,
+    looseMatch = _props$looseMatch === void 0 ? false : _props$looseMatch,
     orphanClassName = props.orphanClassName,
     orphanStyle = props.orphanStyle,
     rest = _objectWithoutProperties(props, _excluded);
@@ -89,11 +112,9 @@ var Select = function Select(baseprops) {
       if (keys.length === 0) {
         return [];
       }
-      // 按 keys 顺序回填，找不到的 key 构造 label=value 的兜底项（孤儿值），
-      // 与 Selector 的显示保持一致，避免 onChange 第二参数丢值。
       return keys.map(function (key) {
         var opt = options.find(function (o) {
-          return o.value === key;
+          return matchValue(o.value, key, looseMatch);
         });
         return opt !== null && opt !== void 0 ? opt : {
           value: key,
@@ -102,7 +123,7 @@ var Select = function Select(baseprops) {
       });
     }
     return (_options$find = options.find(function (opt) {
-      return opt.value === keys;
+      return matchValue(opt.value, keys, looseMatch);
     })) !== null && _options$find !== void 0 ? _options$find : {
       value: keys,
       label: String(keys)
@@ -116,9 +137,9 @@ var Select = function Select(baseprops) {
       setSearchValue('');
       setOpen(false);
     } else {
-      if (mergedValue.includes(key)) {
+      if (keysIncludes(mergedValue, key, looseMatch)) {
         keys = mergedValue.filter(function (k) {
-          return k !== key;
+          return !matchValue(k, key, looseMatch);
         });
       } else {
         keys = [].concat(_toConsumableArray(mergedValue), [key]);
@@ -137,7 +158,7 @@ var Select = function Select(baseprops) {
   };
   var handleRemove = function handleRemove(option) {
     var keys = mergedValue.filter(function (k) {
-      return k !== option.value;
+      return !matchValue(k, option.value, looseMatch);
     });
     var filteredOpts = getOptions(keys);
     setMergedValue(keys);
@@ -169,6 +190,8 @@ var Select = function Select(baseprops) {
       options: filteredOpts,
       open: open,
       selectedKeys: mergedValue,
+      columns: columns,
+      looseMatch: looseMatch,
       onSelect: handleSelect,
       onClose: function onClose() {
         return setOpen(false);
@@ -191,12 +214,17 @@ var Select = function Select(baseprops) {
     virtual: virtual,
     itemHeight: itemHeight,
     listHeight: listHeight,
-    virtualApiRef: virtualApiRef
+    virtualApiRef: virtualApiRef,
+    columns: columns,
+    looseMatch: looseMatch
   });
   return /*#__PURE__*/React.createElement(Trigger, _extends({}, rest, {
     placement: placement,
     popup: popup,
-    stretch: "width",
+    stretch: popupWidth ? undefined : 'width',
+    popupStyle: popupWidth ? {
+      width: popupWidth
+    } : undefined,
     open: disabled ? false : open,
     onOpenChange: handleOpenChange
   }), /*#__PURE__*/React.createElement(Selector, _extends({}, rest, {
@@ -211,7 +239,8 @@ var Select = function Select(baseprops) {
     onSearch: handleSearch,
     onKeyDown: onKeyDown,
     orphanClassName: orphanClassName,
-    orphanStyle: orphanStyle
+    orphanStyle: orphanStyle,
+    looseMatch: looseMatch
   })));
 };
 export default Select;

package/dist/esm/Select/style/index.less

@@ -54,6 +54,20 @@
     align-items: center;
   }
 
+  // Multi-column grid layout (non-virtual mode).
+  // The column count is driven by the CSS custom property --yee-select-columns
+  // set inline by the Options component.
+  &-popup-grid {
+    display: grid;
+    grid-template-columns: repeat(var(--yee-select-columns, 1), 1fr);
+  }
+
+  // Virtual multi-column: each row container is already a grid via inline style;
+  // options inside it should fill cells evenly and center vertically.
+  &-popup-grid-row {
+    align-items: center;
+  }
+
   &-empty {
     padding: var(--yee-select-option-padding);
   }

package/dist/esm/Selector/interface.d.ts

@@ -62,6 +62,10 @@ export interface PureSelectorProps {
      * Selected keys
      */
     selectedKeys: Array<string | number>;
+    /**
+     * Enable loose value matching (String comparison instead of strict equality)
+     */
+    looseMatch?: boolean;
     /**
      * Custom suffix
      */

package/dist/esm/Selector/selector.js

@@ -1,5 +1,5 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-var _excluded = ["prefixCls", "mode", "className", "style", "optionLabelProp", "searchable", "disabled", "options", "selectedKeys", "orphanClassName", "orphanStyle", "allowClear", "placeholder", "closable", "suffix", "value", "open", "loading", "size", "onSearch", "onRemove", "onClear", "onOpenChange", "onKeyDown"],
+var _excluded = ["prefixCls", "mode", "className", "style", "optionLabelProp", "searchable", "disabled", "options", "selectedKeys", "looseMatch", "orphanClassName", "orphanStyle", "allowClear", "placeholder", "closable", "suffix", "value", "open", "loading", "size", "onSearch", "onRemove", "onClear", "onOpenChange", "onKeyDown"],
   _excluded2 = ["_orphan"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
@@ -38,6 +38,8 @@ var Selector = /*#__PURE__*/React.forwardRef(function (props, ref) {
     _props$options = props.options,
     options = _props$options === void 0 ? [] : _props$options,
     selectedKeys = props.selectedKeys,
+    _props$looseMatch = props.looseMatch,
+    looseMatch = _props$looseMatch === void 0 ? false : _props$looseMatch,
     orphanClassName = props.orphanClassName,
     orphanStyle = props.orphanStyle,
     _props$allowClear = props.allowClear,
@@ -71,7 +73,9 @@ var Selector = /*#__PURE__*/React.forwardRef(function (props, ref) {
     }
     // 按 selectedKeys 顺序渲染；找不到的 key 作为孤儿值回退显示 value 本身
     return selectedKeys.map(function (key) {
-      var opt = options.find(function (o) {
+      var opt = looseMatch ? options.find(function (o) {
+        return String(o.value) === String(key);
+      }) : options.find(function (o) {
         return o.value === key;
       });
       if (opt) {
@@ -87,7 +91,7 @@ var Selector = /*#__PURE__*/React.forwardRef(function (props, ref) {
         _orphan: true
       };
     });
-  }, [options, selectedKeys, optionLabelProp]);
+  }, [options, selectedKeys, optionLabelProp, looseMatch]);
   var handleClick = function handleClick() {
     if (inputRef.current && !disabled) {
       inputRef.current.focus();
@@ -156,7 +160,9 @@ var Selector = /*#__PURE__*/React.forwardRef(function (props, ref) {
       });
     }
     var key = selectedKeys.length ? selectedKeys[0] : '';
-    var opt = Array.isArray(options) ? options.find(function (opt) {
+    var opt = Array.isArray(options) ? looseMatch ? options.find(function (opt) {
+      return String(opt.value) === String(key);
+    }) : options.find(function (opt) {
       return opt.value === key;
     }) : null;
     // 孤儿值：key 非空但在 options 中找不到时，回退显示 value 本身

package/dist/esm/Table/hooks/useColumns.js

@@ -37,7 +37,7 @@ export default function useColumns(_ref) {
       var tree = injectSelectionExpand(base, rowSelection, expandable);
       var leaves = flattenLeafColumns(tree);
       var wraped = handleColumns(leaves);
-      var rows = parseHeaderRows(tree);
+      var rows = parseHeaderRows(tree, wraped);
       return {
         wrapedColumns: wraped,
         headerRows: rows

package/dist/esm/Table/interface.d.ts

@@ -498,7 +498,7 @@ export interface TableProps extends FooterProps, Omit<HeaderProps, 'pageData'>,
     /**
      * Row class name, unlike classNames, this prop can be set dynamically via a function
      */
-    rowClassName?: (record: object) => string | undefined;
+    rowClassName?: (record: Record<string, any>) => string | undefined;
     /**
      * Row style, unlike styles, this prop can be set dynamically via a function
      */

package/dist/esm/Table/style/index.less

@@ -49,6 +49,12 @@
           background-color: var(--yee-table-head-cell-split-line-color, #eee);
         }
       }
+
+      &-fixed-left,
+      &-fixed-right {
+        position: sticky;
+        z-index: 1;
+      }
     }
 
     &-cell {
@@ -84,6 +90,16 @@
     &-wrapper {
       overflow: auto;
       width: 100%;
+
+      &-scroll-left @{pls}-cell-fixed-left-last {
+        box-shadow: 6px 0 6px -4px
+          var(--yee-table-fixed-left-after-bs-color);
+      }
+
+      &-scroll-right @{pls}-cell-fixed-right-first {
+        box-shadow: -6px 0 6px -4px
+          var(--yee-table-fixed-right-after-bs-color);
+      }
     }
 
     > table {
@@ -101,10 +117,18 @@
     }
   }
 
+  &-row {
+    background-color: var(--yee-table-row-bg-color);
+  }
+
   &-even-row {
     background-color: var(--yee-table-even-row-bg-color);
   }
 
+  &-odd-row {
+    background-color: var(--yee-table-odd-row-bg-color);
+  }
+
   &-column-sorters {
     display: inline-flex;
     align-items: center;
@@ -137,7 +161,7 @@
     &-fixed-left,
     &-fixed-right {
       position: sticky;
-      background-color: inherit;
+      background-color: var(--yee-table-fixed-column-bg-color);
     }
   }
 
@@ -163,17 +187,17 @@
     }
   }
 
-  &-odd-row {
-    > @{pls}-cell {
-      background-color: var(--yee-table-odd-row-bg-color);
-    }
-  }
+  // &-odd-row {
+  //   > @{pls}-cell {
+  //     background-color: var(--yee-table-odd-row-bg-color);
+  //   }
+  // }
 
-  &-even-row {
-    > @{pls}-cell {
-      background-color: var(--yee-table-even-row-bg-color);
-    }
-  }
+  // &-even-row {
+  //   > @{pls}-cell {
+  //     background-color: var(--yee-table-even-row-bg-color);
+  //   }
+  // }
 
   &-footer {
     display: flex;

package/dist/esm/Table/table.js

@@ -6,6 +6,12 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 import clsx from 'clsx';
@@ -138,6 +144,30 @@ var Table = /*#__PURE__*/React.forwardRef(function (baseprops, ref) {
 
   // Track previous values to determine what action triggered onChange
   var prevSortersRef = useRef({});
+  var contentWrapperRef = useRef(null);
+  var contentRef = useRef(null);
+  var _React$useState = React.useState({
+      left: false,
+      right: false
+    }),
+    _React$useState2 = _slicedToArray(_React$useState, 2),
+    horizontalScroll = _React$useState2[0],
+    setHorizontalScroll = _React$useState2[1];
+  var updateHorizontalScroll = React.useCallback(function () {
+    var wrapper = contentWrapperRef.current;
+    var content = contentRef.current;
+    if (!wrapper || !content) return;
+    var scrollContainer = content.scrollWidth - content.clientWidth > 1 ? content : wrapper;
+    var maxScrollLeft = scrollContainer.scrollWidth - scrollContainer.clientWidth;
+    var hasHorizontalScroll = maxScrollLeft > 1;
+    var next = {
+      left: hasHorizontalScroll && scrollContainer.scrollLeft > 1,
+      right: hasHorizontalScroll && scrollContainer.scrollLeft < maxScrollLeft - 1
+    };
+    setHorizontalScroll(function (current) {
+      return current.left === next.left && current.right === next.right ? current : next;
+    });
+  }, []);
 
   // Wrap onFilter to trigger onChange
   var onFilter = React.useCallback(function () {
@@ -179,6 +209,24 @@ var Table = /*#__PURE__*/React.forwardRef(function (baseprops, ref) {
       return;
     }
   }, [sorters, current, pageSize, pageData, sortedData, onChange]);
+  useEffect(function () {
+    updateHorizontalScroll();
+    var wrapper = contentWrapperRef.current;
+    var content = contentRef.current;
+    if (!wrapper || !content) return undefined;
+    if (typeof ResizeObserver === 'undefined') {
+      window.addEventListener('resize', updateHorizontalScroll);
+      return function () {
+        return window.removeEventListener('resize', updateHorizontalScroll);
+      };
+    }
+    var resizeObserver = new ResizeObserver(updateHorizontalScroll);
+    resizeObserver.observe(wrapper);
+    resizeObserver.observe(content);
+    return function () {
+      return resizeObserver.disconnect();
+    };
+  }, [updateHorizontalScroll, wrapedColumns, pageData, scroll === null || scroll === void 0 ? void 0 : scroll.x]);
   var renderHeader = function renderHeader() {
     return /*#__PURE__*/React.createElement(Header, {
       prefixCls: prefixCls,
@@ -244,13 +292,17 @@ var Table = /*#__PURE__*/React.forwardRef(function (baseprops, ref) {
       columns: wrapedColumns
     }), renderTHeader(), renderTBody(), renderTFooter()));
     return /*#__PURE__*/React.createElement("div", {
-      className: "".concat(prefixCls, "-content-wrapper")
+      ref: contentWrapperRef,
+      className: clsx("".concat(prefixCls, "-content-wrapper"), _defineProperty(_defineProperty({}, "".concat(prefixCls, "-content-wrapper-scroll-left"), horizontalScroll.left), "".concat(prefixCls, "-content-wrapper-scroll-right"), horizontalScroll.right)),
+      onScroll: updateHorizontalScroll
     }, /*#__PURE__*/React.createElement("div", {
+      ref: contentRef,
       className: clsx("".concat(prefixCls, "-content"), _defineProperty(_defineProperty({}, "".concat(prefixCls, "-").concat(size, "-size"), size), "".concat(prefixCls, "-fixed-header"), scroll === null || scroll === void 0 ? void 0 : scroll.y)),
       style: {
         height: scroll === null || scroll === void 0 ? void 0 : scroll.y,
         width: scroll === null || scroll === void 0 ? void 0 : scroll.x
-      }
+      },
+      onScroll: updateHorizontalScroll
     }, table));
   };
   var renderFooter = function renderFooter() {

package/dist/esm/Table/tbody/cell.js

@@ -42,7 +42,7 @@ var TableCell = function TableCell(props) {
   var _children = renderChildren();
   var getTdProps = function getTdProps() {
     var title = render ? undefined : record[dataIndex || ''];
-    var cls = clsx("".concat(prefixCls, "-cell"), _defineProperty(_defineProperty(_defineProperty({}, "".concat(prefixCls, "-cell-fixed-").concat(fixed), fixed), "".concat(prefixCls, "-cell-fixed-").concat(fixed, "-first"), isFixedRightFirst), "".concat(prefixCls, "-fixed-").concat(fixed, "-last"), isFixedLeftLast), className);
+    var cls = clsx("".concat(prefixCls, "-cell"), _defineProperty(_defineProperty(_defineProperty({}, "".concat(prefixCls, "-cell-fixed-").concat(fixed), fixed), "".concat(prefixCls, "-cell-fixed-").concat(fixed, "-first"), isFixedRightFirst), "".concat(prefixCls, "-cell-fixed-").concat(fixed, "-last"), isFixedLeftLast), className);
     var styles = _objectSpread(_objectSpread({}, style), {}, {
       width: width,
       maxWidth: width,

package/dist/esm/Table/util/header.d.ts

@@ -11,10 +11,12 @@ export declare function flattenLeafColumns(columns: WrapedColumnProps[], parentF
  *
  * - Pass 1 (DFS): place each column into the row matching its depth; a group's
  *   colSpan equals the sum of its children's colSpans.
+ * - Fixed metadata from the resolved leaf columns is reused by leaf cells and
+ *   aggregated for group cells whose descendants share the same fixed side.
  * - Pass 2: leaf cells (no sub-columns) get rowSpan = rowCount - rowIndex so
  *   they stretch down to the last header row; group cells keep rowSpan = 1.
  */
-export declare function parseHeaderRows(rootColumns: WrapedColumnProps[]): HeaderCell[][];
+export declare function parseHeaderRows(rootColumns: WrapedColumnProps[], resolvedLeafColumns?: WrapedColumnProps[]): HeaderCell[][];
 /**
  * Inject selection / expand columns into the top level of the column tree.
  * `index` is a 1-based position among the top-level columns.

package/dist/esm/Table/util/header.js

@@ -34,24 +34,52 @@ export function flattenLeafColumns(columns, parentFixed) {
  *
  * - Pass 1 (DFS): place each column into the row matching its depth; a group's
  *   colSpan equals the sum of its children's colSpans.
+ * - Fixed metadata from the resolved leaf columns is reused by leaf cells and
+ *   aggregated for group cells whose descendants share the same fixed side.
  * - Pass 2: leaf cells (no sub-columns) get rowSpan = rowCount - rowIndex so
  *   they stretch down to the last header row; group cells keep rowSpan = 1.
  */
 export function parseHeaderRows(rootColumns) {
+  var resolvedLeafColumns = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : flattenLeafColumns(rootColumns);
   var rows = [];
+  var leafIndex = 0;
   var fillRowCells = function fillRowCells(columns, rowIndex) {
     rows[rowIndex] = rows[rowIndex] || [];
     var colSpanTotal = 0;
-    columns.filter(Boolean).forEach(function (column) {
+    columns.filter(Boolean).forEach(function (sourceColumn) {
+      var column = sourceColumn;
+      var subColumns = sourceColumn.children;
+      var leafStartIndex = leafIndex;
       var cell = {
         column: column,
         colSpan: 1,
         rowSpan: 1
       };
-      var subColumns = column.children;
       if (subColumns && subColumns.length > 0) {
+        var _groupLeaves$;
         cell.colSpan = fillRowCells(subColumns, rowIndex + 1);
         cell.hasSubColumns = true;
+        var groupLeaves = resolvedLeafColumns.slice(leafStartIndex, leafIndex);
+        var fixed = (_groupLeaves$ = groupLeaves[0]) === null || _groupLeaves$ === void 0 ? void 0 : _groupLeaves$.fixed;
+        var isFixedGroup = (fixed === 'left' || fixed === 'right') && groupLeaves.every(function (leaf) {
+          return leaf.fixed === fixed;
+        });
+        if (isFixedGroup) {
+          var _offsetLeaf$style;
+          var offsetLeaf = fixed === 'left' ? groupLeaves[0] : groupLeaves[groupLeaves.length - 1];
+          var boundaryLeaf = fixed === 'left' ? groupLeaves[groupLeaves.length - 1] : groupLeaves[0];
+          column = _objectSpread(_objectSpread({}, sourceColumn), {}, {
+            fixed: fixed,
+            style: _objectSpread(_objectSpread({}, sourceColumn.style), {}, _defineProperty({}, fixed, (_offsetLeaf$style = offsetLeaf.style) === null || _offsetLeaf$style === void 0 ? void 0 : _offsetLeaf$style[fixed])),
+            isFixedLeftLast: fixed === 'left' && boundaryLeaf.isFixedLeftLast,
+            isFixedRightFirst: fixed === 'right' && boundaryLeaf.isFixedRightFirst
+          });
+          cell.column = column;
+        }
+      } else {
+        column = resolvedLeafColumns[leafIndex] || sourceColumn;
+        cell.column = column;
+        leafIndex += 1;
       }
       rows[rowIndex].push(cell);
       colSpanTotal += cell.colSpan;

package/dist/esm/Tree/demo/draggable.js

@@ -53,6 +53,8 @@ export default (function () {
         return moveTreeNode(prev, {
           dragKey: info.dragKey,
           dropKey: info.dropKey,
+          dragPath: info.dragPath,
+          dropPath: info.dropPath,
           position: info.position
         }, FIELD_NAMES);
       });

package/dist/esm/Tree/interface.d.ts

@@ -4,13 +4,14 @@ export type DragPosition = 'before' | 'after' | 'inside';
 export type { MoveInfo } from './utils/tree-tools';
 export type TreeNode<T> = {
     /**
-     * uid
+     * Unique internal identifier built from key path joined by '\x00'.
+     * Guaranteed unique even when user-provided `key` values repeat across branches.
      */
     uid: string;
     /**
-     * Unique key
-     * */
-    key: string;
+     * User-provided key (may not be globally unique)
+     */
+    key: string | number;
     /**
      * Display node text
      */
@@ -20,7 +21,7 @@ export type TreeNode<T> = {
      */
     title?: string;
     /**
-     * Child nodes
+     * Child nodes (only present in raw tree; not used in flat list)
      */
     children?: Array<TreeNode<T>>;
     /**
@@ -28,16 +29,16 @@ export type TreeNode<T> = {
      */
     depth: number;
     /**
-     * Parent node key
-     * */
-    pKey: string | null;
+     * Parent node uid (null for root nodes)
+     */
+    pUid: string | null;
     /**
      * Whether this is a leaf node
-     * */
+     */
     isLeaf: boolean;
     /**
      * Whether this is the last node at its level
-     * */
+     */
     isLast: boolean;
     /**
      * Whether disabled
@@ -48,17 +49,17 @@ export type TreeNode<T> = {
      */
     icon?: React.ReactNode | (() => React.ReactNode);
     /**
-     * Ancestor keys
+     * Ancestor keys (user-provided keys, for building uid path)
      */
-    path: string[];
+    path: Array<string | number>;
     /**
-     * Whether to show connecting lines
+     * Whether to show connecting lines at given depth levels
      */
     lines: number[];
     /**
-     * List of child node keys
+     * All descendant uids (collected bottom-up). Used for check/uncheck propagation.
      */
-    childKeys?: Array<string | number>;
+    childUids?: Array<string>;
     /**
      * Original data
      */
@@ -66,6 +67,7 @@ export type TreeNode<T> = {
 };
 export interface TreeNodeProps<T> {
     node: TreeNode<T>;
+    style?: React.CSSProperties;
 }
 export interface TreeProps<T> {
     /**
@@ -89,11 +91,11 @@ export interface TreeProps<T> {
      */
     defaultExpandAll?: boolean;
     /**
-     * Specify which tree nodes to expand by default
+     * Specify which tree nodes to expand by default (user keys)
      */
     defaultExpandedKeys?: string[];
     /**
-     * Controlled expanded tree nodes
+     * Controlled expanded tree nodes (user keys)
      */
     expandedKeys?: string[];
     /**
@@ -124,6 +126,10 @@ export interface TreeProps<T> {
         dropNode: T;
         dragKey: string | number;
         dropKey: string | number;
+        /** Full key path from root to the dragged node (for non-unique key support) */
+        dragPath: Array<string | number>;
+        /** Full key path from root to the drop target (for non-unique key support) */
+        dropPath: Array<string | number>;
         position: DragPosition;
         /** Convenience flag: true when position is 'before' or 'after' */
         dropToGap: boolean;
@@ -164,22 +170,39 @@ export interface TreeProps<T> {
     loadData?: () => void;
     /**
      * Data source
-     * */
+     */
     dataSource?: Array<T> | T;
     /**
-     * Checked tree nodes (controlled)
+     * Enable virtual scrolling for large datasets.
+     * Requires `height` to be set.
+     * @default false
+     */
+    virtual?: boolean;
+    /**
+     * Height of the scrollable container in pixels.
+     * Required when `virtual` is true.
+     */
+    height?: number;
+    /**
+     * Fixed height of each tree node row in pixels.
+     * Used for virtual scroll calculation.
+     * @default 28
+     */
+    itemHeight?: number;
+    /**
+     * Checked tree nodes (controlled, user keys)
      */
     checkedKeys?: Array<string | number>;
     /**
-     * Checked tree nodes (uncontrolled)
+     * Checked tree nodes (uncontrolled, user keys)
      */
     defaultCheckedKeys?: Array<string | number>;
     /**
-     * Set selected tree nodes, set multiple to true for multi-select
+     * Set selected tree nodes, set multiple to true for multi-select (user keys)
      */
     selectedKeys?: Array<string | number>;
     /**
-     * Set default selected tree nodes, set multiple to true for multi-select
+     * Set default selected tree nodes (user keys)
      */
     defaultSelectedKeys?: Array<string | number>;
     /**
@@ -204,6 +227,6 @@ export interface TreeProps<T> {
     onExpand?: (expandedKeys: Array<string | number>, params: {
         expanded: boolean;
         expandedNodes: T[];
-        node: T[];
+        node: T;
     }) => void;
 }

package/dist/esm/Tree/tree-node.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
 import type { TreeNodeProps } from './interface';
 import './style/index.less';
-declare const Node: <T extends Record<string, unknown> = any>(props: TreeNodeProps<T>) => React.JSX.Element | null;
+declare const Node: <T extends Record<string, unknown> = any>(props: TreeNodeProps<T>) => React.JSX.Element;
 export default Node;