bkui-vue 2.1.0-dev-beta.8 → 2.1.0-dev-beta.9

package/lib/tree/index.js

@@ -17461,7 +17461,7 @@ function toPropertyKey(t) {
 
 ;// CONCATENATED MODULE: ../../node_modules/@babel/runtime/helpers/esm/defineProperty.js
 
-function _defineProperty(e, r, t) {
+function defineProperty_defineProperty(e, r, t) {
   return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
     value: t,
     enumerable: !0,
@@ -17500,6 +17500,8 @@ var _TreeEmitEventsType;
  */
 var EVENTS;
 (function (EVENTS) {
+  EVENTS["NODE_ASYNC_LOAD"] = "nodeAsyncLoad";
+  EVENTS["NODE_ASYNC_LOAD_ERROR"] = "nodeAsyncLoadError";
   EVENTS["NODE_CHECKED"] = "nodeChecked";
   EVENTS["NODE_CLICK"] = "nodeClick";
   EVENTS["NODE_COLLAPSE"] = "nodeCollapse";
@@ -17515,7 +17517,7 @@ var EVENTS;
 var EMPTY = function EMPTY() {
   return true;
 };
-var TreeEmitEventsType = (_TreeEmitEventsType = {}, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_TreeEmitEventsType, EVENTS.NODE_CLICK, EMPTY), EVENTS.NODE_COLLAPSE, EMPTY), EVENTS.NODE_EXPAND, EMPTY), EVENTS.NODE_CHECKED, EMPTY), EVENTS.NODE_DRAG_START, EMPTY), EVENTS.NODE_DRAG_OVER, EMPTY), EVENTS.NODE_DRAG_LEAVE, EMPTY), EVENTS.NODE_DRAG_SORT, EMPTY), EVENTS.NODE_DROP, EMPTY), EVENTS.NODE_ENTER_VIEW, EMPTY), _defineProperty(_TreeEmitEventsType, EVENTS.NODE_SELECTED, EMPTY));
+var TreeEmitEventsType = (_TreeEmitEventsType = {}, defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(_TreeEmitEventsType, EVENTS.NODE_ASYNC_LOAD, EMPTY), EVENTS.NODE_ASYNC_LOAD_ERROR, EMPTY), EVENTS.NODE_CLICK, EMPTY), EVENTS.NODE_COLLAPSE, EMPTY), EVENTS.NODE_EXPAND, EMPTY), EVENTS.NODE_CHECKED, EMPTY), EVENTS.NODE_DRAG_START, EMPTY), EVENTS.NODE_DRAG_OVER, EMPTY), EVENTS.NODE_DRAG_LEAVE, EMPTY), EVENTS.NODE_DRAG_SORT, EMPTY), defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(_TreeEmitEventsType, EVENTS.NODE_DROP, EMPTY), EVENTS.NODE_ENTER_VIEW, EMPTY), EVENTS.NODE_SELECTED, EMPTY));
 /**
  * 节点扩展属性
  */
@@ -17542,7 +17544,7 @@ var NODE_ATTRIBUTES;
   NODE_ATTRIBUTES["TREE_NODE_ATTR"] = "__attr__";
   NODE_ATTRIBUTES["UUID"] = "__uuid";
 })(NODE_ATTRIBUTES || (NODE_ATTRIBUTES = {}));
-var NODE_SOURCE_ATTRS = _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, NODE_ATTRIBUTES.IS_OPEN, 'isOpen'), NODE_ATTRIBUTES.IS_SELECTED, 'selected'), NODE_ATTRIBUTES.IS_MATCH, 'isMatch'), NODE_ATTRIBUTES.HAS_CHILD, 'hasChild'), NODE_ATTRIBUTES.IS_CHECKED, 'checked'), NODE_ATTRIBUTES.IS_ASYNC, 'async'), NODE_ATTRIBUTES.IS_LOADING, 'loading'), NODE_ATTRIBUTES.IS_ROOT, 'isRoot');
+var NODE_SOURCE_ATTRS = defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty({}, NODE_ATTRIBUTES.IS_OPEN, 'isOpen'), NODE_ATTRIBUTES.IS_SELECTED, 'selected'), NODE_ATTRIBUTES.IS_MATCH, 'isMatch'), NODE_ATTRIBUTES.HAS_CHILD, 'hasChild'), NODE_ATTRIBUTES.IS_CHECKED, 'checked'), NODE_ATTRIBUTES.IS_ASYNC, 'async'), NODE_ATTRIBUTES.IS_LOADING, 'loading'), NODE_ATTRIBUTES.IS_ROOT, 'isRoot');
 /**
  * 节点点击可执行行为配置
  */
@@ -17588,7 +17590,7 @@ var treeProps = {
   label: shared_namespaceObject.PropTypes.oneOfType([shared_namespaceObject.PropTypes.func.def(undefined), shared_namespaceObject.PropTypes.string.def('label')]),
   /**
    * 每个树节点用来作为唯一标识的属性，此标识应该是唯一的
-   * 如果设置系统会默认自动生成唯一id
+   * 启用拖拽、异步、受控选中/勾选等复杂能力时强烈建议显式设置
    */
   nodeKey: shared_namespaceObject.PropTypes.string.def(undefined),
   /**
@@ -17623,6 +17625,10 @@ var treeProps = {
    * 默认 true
    */
   prefixIcon: shared_namespaceObject.PropTypes.oneOfType([shared_namespaceObject.PropTypes.func.def(function () {}), shared_namespaceObject.PropTypes.bool.def(false)]).def(true),
+  /**
+   * 当树数据需要由外部接管更新时的统一回调
+   */
+  onDataChange: Function,
   /**
    * 异步加载节点数据配置
    * @param callback 请求数据回调函数，函数返回 Promise
@@ -17774,9 +17780,18 @@ var treeProps = {
    */
   keepSlotData: shared_namespaceObject.PropTypes.bool.def(false),
   /**
-   * 在显示复选框的情况下，是否严格的遵循父子互相关联的做法
+   * 是否启用父子节点勾选联动
+   * true: 父子联动
+   * false: 父子不联动（语义与行业常见 checkStrictly 相反，为兼容历史行为暂保留）
    */
   checkStrictly: shared_namespaceObject.PropTypes.bool.def(true),
+  /**
+   * 是否深度监听 props.data 变化
+   * - false (默认): 仅监听 props.data 引用变化，性能更优
+   * - true: 深度监听 props.data 内部节点变化（已废弃，将在下个主版本移除）
+   * @deprecated 请使用 onDataChange 回调更新数据，避免直接修改 props.data 内部节点
+   */
+  deepWatch: shared_namespaceObject.PropTypes.bool.def(false),
   /**
    * 是否开启监听Tree节点进入Tree容器可视区域
    */
@@ -18048,7 +18063,7 @@ const icon_namespaceObject = icon_x({ ["DownShape"]: () => __WEBPACK_EXTERNAL_MO
       console.warn('node is not in schema, please check', id, node);
       return;
     }
-    flatData.schema.set(node, Object.assign({}, getSchemaVal(node), _defineProperty({}, attr, val)));
+    flatData.schema.set(node, Object.assign({}, getSchemaVal(node), defineProperty_defineProperty({}, attr, val)));
   };
   var getNodeById = function getNodeById(id) {
     return flatData.data.find(function (item) {
@@ -18179,14 +18194,18 @@ const icon_namespaceObject = icon_x({ ["DownShape"]: () => __WEBPACK_EXTERNAL_MO
       return Array.isArray(pre) ? pre[index] : pre[props.children][index];
     }, props.data);
     if (uid) {
-      Object.assign(target, _defineProperty({}, NODE_ATTRIBUTES.UUID, uid));
+      Object.assign(target, defineProperty_defineProperty({}, NODE_ATTRIBUTES.UUID, uid));
     }
     return target;
   };
   var getChildNodes = function getChildNodes(node) {
-    return flatData.data.filter(function (item) {
-      return getParentNode(item) === node;
+    var children = [];
+    flatData.data.forEach(function (item) {
+      if (getParentNode(item) === node) {
+        children.push(item);
+      }
     });
+    return children;
   };
   var getSourceNodeByUID = function getSourceNodeByUID(uid) {
     return flatData.data.find(function (item) {
@@ -18199,7 +18218,7 @@ const icon_namespaceObject = icon_x({ ["DownShape"]: () => __WEBPACK_EXTERNAL_MO
       target = getSourceNodeByUID(target);
     }
     if (isRootNode(target)) {
-      return _defineProperty({}, props.children, props.data);
+      return defineProperty_defineProperty({}, props.children, props.data);
     }
     return getParentNode(target);
   };
@@ -18209,10 +18228,10 @@ const icon_namespaceObject = icon_x({ ["DownShape"]: () => __WEBPACK_EXTERNAL_MO
    * @returns
    */
   var resolveScopedSlotParam = function resolveScopedSlotParam(item) {
-    return _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, NODE_SOURCE_ATTRS[NODE_ATTRIBUTES.IS_LOADING], getNodeAttr(item, NODE_ATTRIBUTES.IS_LOADING)), NODE_SOURCE_ATTRS[NODE_ATTRIBUTES.HAS_CHILD], hasChildNode(item)), NODE_SOURCE_ATTRS[NODE_ATTRIBUTES.IS_MATCH], isNodeMatched(item)), NODE_SOURCE_ATTRS[NODE_ATTRIBUTES.IS_CHECKED], isNodeChecked(item)), NODE_SOURCE_ATTRS[NODE_ATTRIBUTES.IS_OPEN], isNodeOpened(item)), NODE_SOURCE_ATTRS[NODE_ATTRIBUTES.IS_ROOT], isRootNode(item)), "fullPath", getNodeAttr(item, NODE_ATTRIBUTES.PATH)), "uuid", getNodeId(item)), "parent", getNodeAttr(item, NODE_ATTRIBUTES.PARENT)), "parentId", getNodeId(getNodeAttr(item, NODE_ATTRIBUTES.PARENT)));
+    return defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty({}, NODE_SOURCE_ATTRS[NODE_ATTRIBUTES.IS_LOADING], getNodeAttr(item, NODE_ATTRIBUTES.IS_LOADING)), NODE_SOURCE_ATTRS[NODE_ATTRIBUTES.HAS_CHILD], hasChildNode(item)), NODE_SOURCE_ATTRS[NODE_ATTRIBUTES.IS_MATCH], isNodeMatched(item)), NODE_SOURCE_ATTRS[NODE_ATTRIBUTES.IS_CHECKED], isNodeChecked(item)), NODE_SOURCE_ATTRS[NODE_ATTRIBUTES.IS_OPEN], isNodeOpened(item)), NODE_SOURCE_ATTRS[NODE_ATTRIBUTES.IS_ROOT], isRootNode(item)), "fullPath", getNodeAttr(item, NODE_ATTRIBUTES.PATH)), "uuid", getNodeId(item)), "parent", getNodeAttr(item, NODE_ATTRIBUTES.PARENT)), "parentId", getNodeId(getNodeAttr(item, NODE_ATTRIBUTES.PARENT)));
   };
   var extendNodeAttr = function extendNodeAttr(item) {
-    return Object.assign({}, item, _defineProperty({}, NODE_ATTRIBUTES.TREE_NODE_ATTR, resolveScopedSlotParam(item)));
+    return Object.assign({}, item, defineProperty_defineProperty({}, NODE_ATTRIBUTES.TREE_NODE_ATTR, resolveScopedSlotParam(item)));
   };
   var extendNodeScopedData = function extendNodeScopedData(item) {
     return {
@@ -18320,9 +18339,13 @@ function _toConsumableArray(r) {
 
 
 
+
 var _this = undefined;
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = util_unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function util_unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return util_arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? util_arrayLikeToArray(r, a) : void 0; } }
+function util_arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 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; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { defineProperty_defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 /*
  * Tencent is pleased to support the open source community by making
  * 蓝鲸智云PaaS平台社区版 (BlueKing PaaS Community Edition) available.
@@ -18351,6 +18374,23 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 
 
 var DEFAULT_LEVLE_LINE = '1px dashed #c3cdd7';
+var _cloneTreeNode = function cloneTreeNode(node) {
+  if (Array.isArray(node)) {
+    return node.map(function (item) {
+      return _cloneTreeNode(item);
+    });
+  }
+  if (node && _typeof(node) === 'object') {
+    return Object.keys(node).reduce(function (acc, key) {
+      var value = node[key];
+      acc[key] = Array.isArray(value) ? value.map(function (item) {
+        return _cloneTreeNode(item);
+      }) : value;
+      return acc;
+    }, {});
+  }
+  return node;
+};
 /**
  * 获取配置项可为Bool|String|Function类型，如果为Bool则配置默认值
  * @param props
@@ -18462,7 +18502,7 @@ var getNodeItemClass = function getNodeItemClass(item, schema, props) {
     __is_open = _ref.__is_open;
   var _usePrefix = (0,config_provider_namespaceObject.usePrefix)(),
     resolveClassName = _usePrefix.resolveClassName;
-  return _defineProperty(_defineProperty(_defineProperty(_defineProperty({
+  return defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty({
     'is-root': __is_root
   }, "".concat(resolveClassName('tree-node')), true), 'is-open', __is_open), 'is-virtual-render', props.virtualRender), 'level-line', props.levelLine && showTree);
 };
@@ -18478,7 +18518,7 @@ var getNodeRowClass = function getNodeRowClass(item, schema) {
     __is_selected = _ref3.__is_selected;
   var _usePrefix2 = (0,config_provider_namespaceObject.usePrefix)(),
     resolveClassName = _usePrefix2.resolveClassName;
-  return _defineProperty({
+  return defineProperty_defineProperty({
     'is-checked': __is_checked,
     'is-selected': __is_selected,
     'node-folder': item.is_folder,
@@ -18496,6 +18536,187 @@ var getNodeRowClass = function getNodeRowClass(item, schema) {
 var updateTreeNode = function updateTreeNode(path, treeData, childKey, nodekey, nodeValue) {
   assignTreeNode(path, treeData, childKey, _defineProperty({}, nodekey, nodeValue));
 };
+var _cloneTreeData = function cloneTreeData() {
+  var treeData = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var childKey = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'children';
+  return (treeData || []).map(function (node) {
+    var clonedNode = _cloneTreeNode(node);
+    if (Array.isArray(node === null || node === void 0 ? void 0 : node[childKey])) {
+      clonedNode[childKey] = _cloneTreeData(node[childKey], childKey);
+    }
+    return clonedNode;
+  });
+};
+
+var _findNodeById = function findNodeById() {
+  var treeData = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var nodeId = arguments.length > 1 ? arguments[1] : undefined;
+  var nodeKey = arguments.length > 2 ? arguments[2] : undefined;
+  var childKey = arguments.length > 3 ? arguments[3] : undefined;
+  var _iterator = _createForOfIteratorHelper(treeData),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var node = _step.value;
+      if ((node === null || node === void 0 ? void 0 : node[nodeKey]) === nodeId) {
+        return node;
+      }
+      var children = node === null || node === void 0 ? void 0 : node[childKey];
+      if (Array.isArray(children) && children.length) {
+        var target = _findNodeById(children, nodeId, nodeKey, childKey);
+        if (target) {
+          return target;
+        }
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return null;
+};
+
+var mutateTreeById = function mutateTreeById() {
+  var treeData = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var nodeId = arguments.length > 1 ? arguments[1] : undefined;
+  var nodeKey = arguments.length > 2 ? arguments[2] : undefined;
+  var childKey = arguments.length > 3 ? arguments[3] : undefined;
+  var updater = arguments.length > 4 ? arguments[4] : undefined;
+  var target = _findNodeById(treeData, nodeId, nodeKey, childKey);
+  if (target) {
+    updater(target);
+  }
+  return treeData;
+};
+var removeTreeNodeById = function removeTreeNodeById() {
+  var treeData = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var nodeId = arguments.length > 1 ? arguments[1] : undefined;
+  var nodeKey = arguments.length > 2 ? arguments[2] : undefined;
+  var childKey = arguments.length > 3 ? arguments[3] : undefined;
+  var _loop = function loop(list, parentNode) {
+    for (var index = 0; index < list.length; index++) {
+      var current = list[index];
+      if ((current === null || current === void 0 ? void 0 : current[nodeKey]) === nodeId) {
+        var _list$splice = list.splice(index, 1),
+          _list$splice2 = _slicedToArray(_list$splice, 1),
+          node = _list$splice2[0];
+        return {
+          node: node,
+          parentNode: parentNode,
+          index: index
+        };
+      }
+      var children = current === null || current === void 0 ? void 0 : current[childKey];
+      if (Array.isArray(children) && children.length) {
+        var _result = _loop(children, current);
+        if (_result.node) {
+          return _result;
+        }
+      }
+    }
+    return {
+      node: null,
+      parentNode: null,
+      index: -1
+    };
+  };
+  var result = _loop(treeData, null);
+  return _objectSpread(_objectSpread({}, result), {}, {
+    data: treeData
+  });
+};
+var insertTreeNodeById = function insertTreeNodeById() {
+  var treeData = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var node = arguments.length > 1 ? arguments[1] : undefined;
+  var targetNodeId = arguments.length > 2 ? arguments[2] : undefined;
+  var nodeKey = arguments.length > 3 ? arguments[3] : undefined;
+  var childKey = arguments.length > 4 ? arguments[4] : undefined;
+  var options = arguments.length > 5 ? arguments[5] : undefined;
+  var dropType = options.dropType,
+    _options$willInsertAf = options.willInsertAfter,
+    willInsertAfter = _options$willInsertAf === void 0 ? true : _options$willInsertAf;
+  if (dropType === 'child') {
+    var targetNode = _findNodeById(treeData, targetNodeId, nodeKey, childKey);
+    if (!targetNode) {
+      return {
+        data: treeData,
+        parentNode: null,
+        targetNode: null,
+        index: -1
+      };
+    }
+    if (!Array.isArray(targetNode[childKey])) {
+      targetNode[childKey] = [];
+    }
+    var targetChildren = targetNode[childKey];
+    targetChildren.push(node);
+    return {
+      data: treeData,
+      parentNode: targetNode,
+      targetNode: targetNode,
+      index: targetChildren.length - 1
+    };
+  }
+  var _loop2 = function loop(list, parentNode) {
+    for (var index = 0; index < list.length; index++) {
+      var current = list[index];
+      if ((current === null || current === void 0 ? void 0 : current[nodeKey]) === targetNodeId) {
+        var insertIndex = willInsertAfter ? index + 1 : index;
+        list.splice(insertIndex, 0, node);
+        return {
+          parentNode: parentNode,
+          targetNode: current,
+          index: insertIndex
+        };
+      }
+      var children = current === null || current === void 0 ? void 0 : current[childKey];
+      if (Array.isArray(children) && children.length) {
+        var _result2 = _loop2(children, current);
+        if (_result2.targetNode) {
+          return _result2;
+        }
+      }
+    }
+    return {
+      parentNode: null,
+      targetNode: null,
+      index: -1
+    };
+  };
+  var result = _loop2(treeData, null);
+  return _objectSpread({
+    data: treeData
+  }, result);
+};
+var moveTreeNodeById = function moveTreeNodeById() {
+  var treeData = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var nodeId = arguments.length > 1 ? arguments[1] : undefined;
+  var targetNodeId = arguments.length > 2 ? arguments[2] : undefined;
+  var nodeKey = arguments.length > 3 ? arguments[3] : undefined;
+  var childKey = arguments.length > 4 ? arguments[4] : undefined;
+  var options = arguments.length > 5 ? arguments[5] : undefined;
+  var nextTreeData = _cloneTreeData(treeData, childKey);
+  var removeResult = removeTreeNodeById(nextTreeData, nodeId, nodeKey, childKey);
+  if (!removeResult.node) {
+    return null;
+  }
+  var insertResult = insertTreeNodeById(nextTreeData, removeResult.node, targetNodeId, nodeKey, childKey, options);
+  if (!insertResult.targetNode && options.dropType !== 'child') {
+    return null;
+  }
+  return {
+    trigger: 'drag',
+    data: nextTreeData,
+    node: removeResult.node,
+    targetNode: insertResult.targetNode,
+    parentNode: insertResult.parentNode,
+    oldParentNode: removeResult.parentNode,
+    dropType: options.dropType,
+    sourceIndex: removeResult.index,
+    targetIndex: insertResult.index
+  };
+};
 /**
  * 根据路径更新指定节点Child-Data
  * @param path 节点路径
@@ -18514,9 +18735,7 @@ var assignTreeNode = function assignTreeNode(path, treeData, childKey, assignVal
 var resolveNodeItem = function resolveNodeItem(node) {
   if (node === undefined || node === null) {
     // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-    return {
-      __IS_NULL: true
-    };
+    return defineProperty_defineProperty({}, NODE_ATTRIBUTES.IS_NULL, true);
   }
   return node;
 };
@@ -18568,23 +18787,42 @@ var showCheckbox = function showCheckbox(props, node) {
 
 
 
-/* harmony default export */ const use_node_async = (function (props, flatData) {
+/* harmony default export */ const use_node_async = (function (props, flatData, ctx) {
   var _useNodeAttribute = use_node_attribute(flatData, props),
     setNodeAttr = _useNodeAttribute.setNodeAttr,
-    getNodePath = _useNodeAttribute.getNodePath,
+    getNodeId = _useNodeAttribute.getNodeId,
     getNodeAttr = _useNodeAttribute.getNodeAttr,
     resolveScopedSlotParam = _useNodeAttribute.resolveScopedSlotParam,
     setTreeNodeLoading = _useNodeAttribute.setTreeNodeLoading;
+  var requestVersionMap = new Map();
+  var emitTreeDataChange = function emitTreeDataChange(payload) {
+    var _props$onDataChange;
+    (_props$onDataChange = props.onDataChange) === null || _props$onDataChange === void 0 || _props$onDataChange.call(props, payload);
+    ctx === null || ctx === void 0 || ctx.emit(EVENTS.NODE_ASYNC_LOAD, payload);
+  };
   /**
    * 处理异步加载节点数据返回结果
    * @param resp 异步请求返回结果
    * @param item 当前节点
    */
-  var setNodeRemoteLoad = function setNodeRemoteLoad(resp, item) {
+  var setNodeRemoteLoad = function setNodeRemoteLoad(resp, item, requestVersion) {
     if (_typeof(resp) === 'object' && resp !== null) {
+      var nodeId = getNodeId(item);
+      if (requestVersion !== undefined && requestVersionMap.get(nodeId) !== requestVersion) {
+        return Promise.resolve(resp);
+      }
       setNodeAttr(item, NODE_ATTRIBUTES.IS_OPEN, true);
       var nodeValue = Array.isArray(resp) ? resp : [resp];
-      updateTreeNode(getNodePath(item), props.data, props.children, props.children, nodeValue);
+      var nextTreeData = _cloneTreeData(props.data, props.children);
+      mutateTreeById(nextTreeData, nodeId, props.nodeKey || NODE_ATTRIBUTES.UUID, props.children, function (targetNode) {
+        targetNode[props.children] = nodeValue;
+      });
+      emitTreeDataChange({
+        trigger: 'async',
+        data: nextTreeData,
+        node: item,
+        parentNode: item
+      });
       return Promise.resolve(resp);
     }
     return Promise.resolve(resp);
@@ -18595,29 +18833,39 @@ var showCheckbox = function showCheckbox(props, node) {
       callback = _ref$callback === void 0 ? null : _ref$callback,
       _ref$cache = _ref.cache,
       cache = _ref$cache === void 0 ? true : _ref$cache;
-    /** 如果是异步请求加载 */
     if (typeof callback === 'function' && getNodeAttr(item, NODE_ATTRIBUTES.IS_ASYNC)) {
-      /** 用于注释当前节点是否已经初始化过 */
+      var nodeId = getNodeId(item);
+      var requestVersion = (requestVersionMap.get(nodeId) || 0) + 1;
+      requestVersionMap.set(nodeId, requestVersion);
       setNodeAttr(item, NODE_ATTRIBUTES.IS_ASYNC_INIT, true);
       if (!getNodeAttr(item, NODE_ATTRIBUTES.IS_CACHED)) {
         setNodeAttr(item, NODE_ATTRIBUTES.IS_CACHED, cache);
         var dataAttr = resolveScopedSlotParam(item);
         var callbackResult = callback(item, function (resp) {
-          return setNodeRemoteLoad(resp, item);
+          return setNodeRemoteLoad(resp, item, requestVersion);
         }, dataAttr);
         if (_typeof(callbackResult) === 'object' && callbackResult !== null) {
           setTreeNodeLoading(item, true);
           if (callbackResult instanceof Promise) {
             return Promise.resolve(callbackResult.then(function (resp) {
-              return setNodeRemoteLoad(resp, item);
+              return setNodeRemoteLoad(resp, item, requestVersion);
             })["catch"](function (err) {
-              return console.error('load remote data error:', err);
+              if (requestVersionMap.get(nodeId) === requestVersion) {
+                ctx === null || ctx === void 0 || ctx.emit(EVENTS.NODE_ASYNC_LOAD_ERROR, {
+                  node: item,
+                  error: err,
+                  requestVersion: requestVersion
+                });
+              }
+              return false;
             })["finally"](function () {
-              setTreeNodeLoading(item, false);
-              setNodeAttr(item, NODE_ATTRIBUTES.IS_CACHED, true);
+              if (requestVersionMap.get(nodeId) === requestVersion) {
+                setTreeNodeLoading(item, false);
+                setNodeAttr(item, NODE_ATTRIBUTES.IS_CACHED, true);
+              }
             }));
           }
-          setNodeRemoteLoad(callbackResult, item);
+          setNodeRemoteLoad(callbackResult, item, requestVersion);
           setTreeNodeLoading(item, false);
           return Promise.resolve(true);
         }
@@ -18686,6 +18934,10 @@ var use_node_action_this = undefined;
 
 /* harmony default export */ const use_node_action = (function (props, ctx, flatData, _renderData, initOption) {
   // const checkedNodes = [];
+  var getSelectedNodeId = function getSelectedNodeId() {
+    var _props$selected;
+    return (_props$selected = props.selected) !== null && _props$selected !== void 0 ? _props$selected : selectedNodeId;
+  };
   var selectedNodeId = props.selected;
   var _useNodeAttribute = use_node_attribute(flatData, props),
     setNodeAttr = _useNodeAttribute.setNodeAttr,
@@ -18708,7 +18960,7 @@ var use_node_action_this = undefined;
   var _usePrefix = (0,config_provider_namespaceObject.usePrefix)(),
     resolveClassName = _usePrefix.resolveClassName;
   var registerNextLoop = initOption.registerNextLoop;
-  var _useNodeAsync = use_node_async(props, flatData),
+  var _useNodeAsync = use_node_async(props, flatData, ctx),
     asyncNodeClick = _useNodeAsync.asyncNodeClick,
     deepAutoOpen = _useNodeAsync.deepAutoOpen;
   /**
@@ -18851,6 +19103,7 @@ var use_node_action_this = undefined;
     if (value) {
       setNodeAttr(item, NODE_ATTRIBUTES.IS_INDETERMINATE, false);
     }
+    // 历史语义：checkStrictly=true 表示启用父子联动
     if (props.checkStrictly) {
       _deepUpdateChildNode(item, [NODE_ATTRIBUTES.IS_CHECKED, NODE_ATTRIBUTES.IS_INDETERMINATE], [!!value, false]);
       _updateParentChecked(item, value);
@@ -19031,7 +19284,7 @@ var use_node_action_this = undefined;
       var _flatData$data$find;
       resolvedItem = (_flatData$data$find = flatData.data.find(function (item) {
         return getNodeId(item) === resolvedItem;
-      })) !== null && _flatData$data$find !== void 0 ? _flatData$data$find : _defineProperty({}, NODE_ATTRIBUTES.IS_NULL, true);
+      })) !== null && _flatData$data$find !== void 0 ? _flatData$data$find : defineProperty_defineProperty({}, NODE_ATTRIBUTES.IS_NULL, true);
     }
     if (resolvedItem[NODE_ATTRIBUTES.IS_NULL]) {
       return;
@@ -19040,19 +19293,23 @@ var use_node_action_this = undefined;
       console.warn('props.selectable is false or undefined, please set selectable with true');
       return;
     }
-    if (selectedNodeId !== null && selectedNodeId !== undefined) {
-      setNodeAttrById(selectedNodeId, NODE_ATTRIBUTES.IS_SELECTED, !selected);
+    var currentSelectedNodeId = getSelectedNodeId();
+    if (currentSelectedNodeId !== null && currentSelectedNodeId !== undefined) {
+      setNodeAttrById(currentSelectedNodeId, NODE_ATTRIBUTES.IS_SELECTED, !selected);
     }
-    if (props.selected && props.selected !== selectedNodeId) {
+    if (props.selected && props.selected !== currentSelectedNodeId) {
       setNodeAttrById(props.selected, NODE_ATTRIBUTES.IS_SELECTED, !selected);
     }
     setNodeAttr(resolvedItem, NODE_ATTRIBUTES.IS_SELECTED, selected);
-    selectedNodeId = getNodeId(resolvedItem);
+    if (props.selected === undefined) {
+      selectedNodeId = getNodeId(resolvedItem);
+    }
     if (triggerEvent) {
-      ctx.emit(EVENTS.NODE_SELECTED, {
+      var payload = {
         selected: selected,
         node: resolvedItem
-      });
+      };
+      ctx.emit(EVENTS.NODE_SELECTED, payload);
     }
     /**
      * 如果设置了自动展开
@@ -22647,14 +22904,17 @@ Sortable.mount(Remove, Revert);
 
 
 
-/* harmony default export */ const use_node_drag = (function (props, ctx, root, flatData) {
+/* harmony default export */ const use_node_drag = (function (props, ctx, root, flatData, options) {
   var _useNodeAttribute = use_node_attribute(flatData, props),
     getSourceNodeByUID = _useNodeAttribute.getSourceNodeByUID,
     getParentNode = _useNodeAttribute.getParentNode,
     extendNodeAttr = _useNodeAttribute.extendNodeAttr,
-    setNodeAttr = _useNodeAttribute.setNodeAttr,
     getNodeAttr = _useNodeAttribute.getNodeAttr,
-    getRootNodeList = _useNodeAttribute.getRootNodeList;
+    getNodeId = _useNodeAttribute.getNodeId,
+    setNodeAttr = _useNodeAttribute.setNodeAttr;
+  var _ref = options || {},
+    moveTreeNodeById = _ref.moveTreeNodeById,
+    onTreeDataChange = _ref.onTreeDataChange;
   var _usePrefix = (0,config_provider_namespaceObject.usePrefix)(),
     resolveClassName = _usePrefix.resolveClassName;
   var isNeedCheckDraggable = (0,external_vue_namespaceObject.computed)(function () {
@@ -22762,24 +23022,12 @@ Sortable.mount(Remove, Revert);
       }
     });
   };
-  /**
-   * 从父节点的 children 数组中移除指定节点
-   */
-  var removeFromParentChildren = function removeFromParentChildren(node, parent) {
-    if (!parent) {
-      var index = props.data.indexOf(node);
-      if (index > -1) {
-        props.data.splice(index, 1);
-      }
-    } else {
-      var children = parent[props.children];
-      if (children) {
-        var _index = children.indexOf(node);
-        if (_index > -1) {
-          children.splice(_index, 1);
-        }
-      }
+  var emitTreeDataChange = function emitTreeDataChange(payload) {
+    if (!payload) {
+      return null;
     }
+    onTreeDataChange === null || onTreeDataChange === void 0 || onTreeDataChange(payload);
+    return payload;
   };
   /**
    * 更新节点的 HAS_CHILD 属性
@@ -22819,52 +23067,36 @@ Sortable.mount(Remove, Revert);
     return 'child';
   };
   /**
-   * 将源数据树结构重新展开为 flatData（BFS 顺序）
-   * 这是唯一需要的 flatData 更新方式：修改 children 后重新展平
+   * 将源数据树结构重新展开为 flatData（DFS 顺序）
+   * 同时重新计算所有节点属性（深度、路径、索引等）
+   * 与 v1 版本保持一致：从 props.data 出发进行遍历，不依赖旧 schema 状态
    */
-  var rebuildFlatData = function rebuildFlatData() {
+  var rebuildFlatDataWithAttributes = function rebuildFlatDataWithAttributes() {
     var newFlatData = [];
-    var _traverse = function traverse(nodes) {
-      nodes.forEach(function (node) {
-        newFlatData.push(node);
-        var children = node[props.children];
-        if (children && children.length > 0) {
-          _traverse(children);
-        }
-      });
-    };
-    _traverse(props.data);
-    flatData.data = newFlatData;
-  };
-  /**
-   * 重新计算所有节点属性（深度、路径、索引等）
-   */
-  var recalculateNodeAttributes = function recalculateNodeAttributes() {
     var orderIndex = 0;
-    var _setNodeAttribute = function setNodeAttribute(nodeList, level, parentPath, parent) {
-      for (var i = 0; i < nodeList.length; i++) {
-        var node = nodeList[i];
+    var _traverse = function traverse(nodes, level, parentPath, parent) {
+      for (var i = 0; i < nodes.length; i++) {
+        var node = nodes[i];
         var path = parentPath !== '' ? "".concat(parentPath, "-").concat(i) : "".concat(i);
+        // 重新构建 flatData
+        newFlatData.push(node);
+        // 重新计算所有节点属性
         setNodeAttr(node, NODE_ATTRIBUTES.INDEX, orderIndex);
         setNodeAttr(node, NODE_ATTRIBUTES.ORDER, orderIndex);
         setNodeAttr(node, NODE_ATTRIBUTES.DEPTH, level);
         setNodeAttr(node, NODE_ATTRIBUTES.PATH, path);
         setNodeAttr(node, NODE_ATTRIBUTES.IS_ROOT, level === 0);
         setNodeAttr(node, NODE_ATTRIBUTES.PARENT, parent);
-        if (!parent) {
-          // 根节点：检查是否有子节点
-          var _children = node[props.children];
-          setNodeAttr(node, NODE_ATTRIBUTES.HAS_CHILD, !!(_children && _children.length > 0));
-        }
+        setNodeAttr(node, NODE_ATTRIBUTES.HAS_CHILD, !!(node[props.children] || []).length);
         orderIndex += 1;
-        var children = node[props.children];
-        if (children && children.length > 0) {
-          _setNodeAttribute(children, level + 1, path, node);
+        var children = node[props.children] || [];
+        if (children.length > 0) {
+          _traverse(children, level + 1, path, node);
         }
       }
     };
-    var rootNodeList = getRootNodeList();
-    _setNodeAttribute(rootNodeList, 0, '', null);
+    _traverse(props.data, 0, '', null);
+    flatData.data = newFlatData;
   };
   /**
    * 拖拽排序：同级节点间排序（dragSort 模式）
@@ -22873,36 +23105,29 @@ Sortable.mount(Remove, Revert);
   var dragSortData = function dragSortData(sourceNodeData, targetNodeData, willInsertAfter, savedOpenStates) {
     var sourceParent = getParentNode(sourceNodeData);
     var targetParent = getParentNode(targetNodeData);
-    // 只允许同父节点下排序
-    if (props.dragSortMode === 'next' && sourceParent !== targetParent) return;
-    // 1. 从原位置移除
-    removeFromParentChildren(sourceNodeData, sourceParent);
-    // 2. 获取目标所在的 children 数组
-    var targetChildren;
-    if (!targetParent) {
-      targetChildren = props.data;
-    } else {
-      targetChildren = targetParent[props.children];
-      if (!targetChildren) {
-        targetParent[props.children] = [];
-        targetChildren = targetParent[props.children];
-      }
-    }
-    // 3. 在目标节点前/后插入源节点
-    var targetIndexInParent = targetChildren.indexOf(targetNodeData);
-    var insertIndex = willInsertAfter ? targetIndexInParent + 1 : targetIndexInParent;
-    targetChildren.splice(insertIndex, 0, sourceNodeData);
-    // 4. 重新构建 flatData 并计算属性
-    rebuildFlatData();
-    recalculateNodeAttributes();
-    // 5. 更新源父节点的 HAS_CHILD
+    if (props.dragSortMode === 'next' && sourceParent !== targetParent) return null;
+    var payload = emitTreeDataChange(moveTreeNodeById === null || moveTreeNodeById === void 0 ? void 0 : moveTreeNodeById(props.data, getNodeId(sourceNodeData), getNodeId(targetNodeData), props.nodeKey || NODE_ATTRIBUTES.UUID, props.children, {
+      dropType: 'sort',
+      willInsertAfter: willInsertAfter
+    }));
+    if (!payload) {
+      return null;
+    }
+    rebuildFlatDataWithAttributes();
     updateHasChildAttr(sourceParent);
-    // 6. 恢复展开状态
     restoreAllOpenStates(savedOpenStates);
-    ctx.emit(EVENTS.NODE_DRAG_SORT, {
+    var dragSortPayload = {
       sourceNode: sourceNodeData,
-      targetNode: targetNodeData
-    });
+      targetNode: targetNodeData,
+      sourceIndex: payload.sourceIndex,
+      targetIndex: payload.targetIndex,
+      data: payload.data,
+      parentNode: payload.parentNode,
+      oldParentNode: payload.oldParentNode,
+      dropType: payload.dropType
+    };
+    ctx.emit(EVENTS.NODE_DRAG_SORT, dragSortPayload);
+    return payload;
   };
   /**
    * 将源节点作为目标节点的子节点
@@ -22910,22 +23135,17 @@ Sortable.mount(Remove, Revert);
    */
   var dragAsChildNode = function dragAsChildNode(sourceNodeData, targetNodeData, savedOpenStates) {
     var sourceParent = getParentNode(sourceNodeData);
-    // 1. 从原位置移除
-    removeFromParentChildren(sourceNodeData, sourceParent);
-    // 2. 初始化目标节点的 children 并 push
-    if (!targetNodeData[props.children]) {
-      targetNodeData[props.children] = [];
-    }
-    targetNodeData[props.children].push(sourceNodeData);
-    // 3. 重新构建 flatData 并计算属性
-    rebuildFlatData();
-    recalculateNodeAttributes();
-    // 4. 更新属性
+    var payload = emitTreeDataChange(moveTreeNodeById === null || moveTreeNodeById === void 0 ? void 0 : moveTreeNodeById(props.data, getNodeId(sourceNodeData), getNodeId(targetNodeData), props.nodeKey || NODE_ATTRIBUTES.UUID, props.children, {
+      dropType: 'child'
+    }));
+    if (!payload) {
+      return null;
+    }
+    rebuildFlatDataWithAttributes();
     updateHasChildAttr(sourceParent);
     setNodeAttr(targetNodeData, NODE_ATTRIBUTES.HAS_CHILD, true);
-    // 5. 恢复展开状态
     restoreAllOpenStates(savedOpenStates);
-    ctx.emit(EVENTS.NODE_DROP, sourceNodeData, targetNodeData, 'child');
+    return payload;
   };
   /**
    * 将源节点作为目标节点的同级节点插入（可跨级）
@@ -22934,32 +23154,18 @@ Sortable.mount(Remove, Revert);
   var dragAsSiblingNode = function dragAsSiblingNode(sourceNodeData, targetNodeData, willInsertAfter, savedOpenStates) {
     var sourceParent = getParentNode(sourceNodeData);
     var targetParent = getParentNode(targetNodeData);
-    // 1. 从原位置移除
-    removeFromParentChildren(sourceNodeData, sourceParent);
-    // 2. 获取目标所在的 children 数组
-    var targetChildren;
-    if (!targetParent) {
-      targetChildren = props.data;
-    } else {
-      targetChildren = targetParent[props.children];
-      if (!targetChildren) {
-        targetParent[props.children] = [];
-        targetChildren = targetParent[props.children];
-      }
-    }
-    // 3. 在目标节点前/后插入源节点
-    var targetIndexInParent = targetChildren.indexOf(targetNodeData);
-    var insertIndex = willInsertAfter ? targetIndexInParent + 1 : targetIndexInParent;
-    targetChildren.splice(insertIndex, 0, sourceNodeData);
-    // 4. 重新构建 flatData 并计算属性
-    rebuildFlatData();
-    recalculateNodeAttributes();
-    // 5. 更新属性
+    var payload = emitTreeDataChange(moveTreeNodeById === null || moveTreeNodeById === void 0 ? void 0 : moveTreeNodeById(props.data, getNodeId(sourceNodeData), getNodeId(targetNodeData), props.nodeKey || NODE_ATTRIBUTES.UUID, props.children, {
+      dropType: 'move',
+      willInsertAfter: willInsertAfter
+    }));
+    if (!payload) {
+      return null;
+    }
+    rebuildFlatDataWithAttributes();
     updateHasChildAttr(sourceParent);
     updateHasChildAttr(targetParent);
-    // 6. 恢复展开状态
     restoreAllOpenStates(savedOpenStates);
-    ctx.emit(EVENTS.NODE_DROP, sourceNodeData, targetNodeData, 'move');
+    return payload;
   };
   /**
    * 检查是否禁止拖拽
@@ -23036,7 +23242,8 @@ Sortable.mount(Remove, Revert);
         }
         var sourceNodeData = getSourceNodeByUID(dragNodeId);
         var targetNodeData = getSourceNodeByUID(targetNodeId);
-        if (!sourceNodeData || !targetNodeData) {
+        var targetEl = evt.related;
+        if (!sourceNodeData || !targetNodeData || !targetEl) {
           cleanup();
           return;
         }
@@ -23046,17 +23253,32 @@ Sortable.mount(Remove, Revert);
         }
         // 保存展开状态
         var savedOpenStates = saveAllOpenStates();
-        // 根据放置类型执行对应操作
+        var payload = null;
         if (currentDropType === 'child') {
-          dragAsChildNode(sourceNodeData, targetNodeData, savedOpenStates);
+          payload = dragAsChildNode(sourceNodeData, targetNodeData, savedOpenStates);
         } else if (currentDropType === 'sort') {
-          dragSortData(sourceNodeData, targetNodeData, currentWillInsertAfter, savedOpenStates);
+          payload = dragSortData(sourceNodeData, targetNodeData, currentWillInsertAfter, savedOpenStates);
         } else {
-          // move: 跨级移动为同级节点
-          dragAsSiblingNode(sourceNodeData, targetNodeData, currentWillInsertAfter, savedOpenStates);
+          payload = dragAsSiblingNode(sourceNodeData, targetNodeData, currentWillInsertAfter, savedOpenStates);
+        }
+        if (!payload) {
+          cleanup();
+          return;
         }
         var targetData = extendNodeAttr(targetNodeData);
-        ctx.emit(EVENTS.NODE_DROP, evt, evt.item, targetData);
+        var dropPayload = {
+          event: evt,
+          element: targetEl,
+          targetNode: targetData,
+          sourceNode: sourceNodeData,
+          data: payload.data,
+          parentNode: payload.parentNode,
+          oldParentNode: payload.oldParentNode,
+          dropType: payload.dropType,
+          sourceIndex: payload.sourceIndex,
+          targetIndex: payload.targetIndex
+        };
+        ctx.emit(EVENTS.NODE_DROP, dropPayload);
         cleanup();
       },
       onMove: function onMove(evt, originalEvent) {
@@ -23114,12 +23336,6 @@ Sortable.mount(Remove, Revert);
    * 拖拽结束后移除节点的选中状态，避免拖拽完毕节点保持选中
    */
   var cleanup = function cleanup() {
-    if (dragNodeId) {
-      var dragNode = getSourceNodeByUID(dragNodeId);
-      if (dragNode) {
-        setNodeAttr(dragNode, NODE_ATTRIBUTES.IS_SELECTED, false);
-      }
-    }
     dragNodeId = '';
     currentDropType = 'move';
     currentRelatedId = '';
@@ -23363,8 +23579,16 @@ var use_tree_init_this = undefined;
 
 
 
+var warnRequiredNodeKey = function warnRequiredNodeKey(props) {
+  var _props$async, _props$checked;
+  var needsStableNodeKey = !!props.draggable || !!props.dragSort || !!((_props$async = props.async) !== null && _props$async !== void 0 && _props$async.callback) || props.selected !== undefined || !!((_props$checked = props.checked) !== null && _props$checked !== void 0 && _props$checked.length);
+  if (needsStableNodeKey && !props.nodeKey) {
+    console.warn('[Tree] `nodeKey` is recommended when using drag, async, selected, or checked state.');
+  }
+};
 /* harmony default export */ const use_tree_init = (function (props) {
-  var _props$async3;
+  var _props$async4;
+  warnRequiredNodeKey(props);
   /**
    * 扁平化当前数据
    * @param treeData 树形结构数据
@@ -23379,6 +23603,10 @@ var use_tree_init_this = undefined;
     var checkedList = [];
     var outputData = [];
     var order = 0;
+    // TODO P2: 考虑将 WeakMap<TreeNode, meta> 切换为 Map<nodeKey, meta>
+    // 优势：序列化友好、跨实例共享、避免对象引用泄漏
+    // 劣势：需要手动管理内存、依赖 nodeKey 唯一性
+    // 当前保留 WeakMap 以保证兼容性和自动 GC
     var treeSchema = new WeakMap();
     /**
      * 递归更新节点属性
@@ -23399,7 +23627,7 @@ var use_tree_init_this = undefined;
             if (target[attrName] === attrValue) {
               return;
             }
-            Object.assign(target, _defineProperty({}, attrName, attrValue));
+            Object.assign(target, defineProperty_defineProperty({}, attrName, attrValue));
             loopUpdateNodeAttr(target[NODE_ATTRIBUTES.PARENT], attrName, attrValue, callFn);
           }
         }
@@ -23417,7 +23645,7 @@ var use_tree_init_this = undefined;
      * 如果传入数据没有设置相关属性值
      * 这里会自动生成
      */
-    var cachedDefaultVal = _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, NODE_ATTRIBUTES.IS_OPEN, function () {
+    var cachedDefaultVal = defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty({}, NODE_ATTRIBUTES.IS_OPEN, function () {
       return !!props.expandAll;
     }), NODE_ATTRIBUTES.IS_CHECKED, function () {
       return false;
@@ -23540,7 +23768,7 @@ var use_tree_init_this = undefined;
                */
               isOpened = isNodeOpend(uuid, item, parent);
             }
-            var attributes = (_attributes = {}, _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_attributes, NODE_ATTRIBUTES.DEPTH, depth), NODE_ATTRIBUTES.INDEX, order), NODE_ATTRIBUTES.UUID, uuid), NODE_ATTRIBUTES.PARENT, parent), NODE_ATTRIBUTES.HAS_CHILD, hasChildren), NODE_ATTRIBUTES.PATH, currentPath), NODE_ATTRIBUTES.IS_ROOT, parent === null), NODE_ATTRIBUTES.ORDER, order), NODE_ATTRIBUTES.IS_SELECTED, isCachedTreeNodeSelected(uuid, item)), NODE_ATTRIBUTES.IS_MATCH, getCachedTreeNodeAttr(uuid, item, NODE_ATTRIBUTES.IS_MATCH)), _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_attributes, NODE_ATTRIBUTES.IS_OPEN, isOpened), NODE_ATTRIBUTES.IS_CHECKED, undefined), NODE_ATTRIBUTES.IS_CACHED, getCachedTreeNodeAttr(uuid, item, NODE_ATTRIBUTES.IS_CACHED)), NODE_ATTRIBUTES.IS_ASYNC, getCachedTreeNodeAttr(uuid, item, NODE_ATTRIBUTES.IS_ASYNC)), NODE_ATTRIBUTES.IS_LOADING, getCachedTreeNodeAttr(uuid, item, NODE_ATTRIBUTES.IS_LOADING)), NODE_ATTRIBUTES.IS_INDETERMINATE, false));
+            var attributes = (_attributes = {}, defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(_attributes, NODE_ATTRIBUTES.DEPTH, depth), NODE_ATTRIBUTES.INDEX, order), NODE_ATTRIBUTES.UUID, uuid), NODE_ATTRIBUTES.PARENT, parent), NODE_ATTRIBUTES.HAS_CHILD, hasChildren), NODE_ATTRIBUTES.PATH, currentPath), NODE_ATTRIBUTES.IS_ROOT, parent === null), NODE_ATTRIBUTES.ORDER, order), NODE_ATTRIBUTES.IS_SELECTED, isCachedTreeNodeSelected(uuid, item)), NODE_ATTRIBUTES.IS_MATCH, getCachedTreeNodeAttr(uuid, item, NODE_ATTRIBUTES.IS_MATCH)), defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(defineProperty_defineProperty(_attributes, NODE_ATTRIBUTES.IS_OPEN, isOpened), NODE_ATTRIBUTES.IS_CHECKED, undefined), NODE_ATTRIBUTES.IS_CACHED, getCachedTreeNodeAttr(uuid, item, NODE_ATTRIBUTES.IS_CACHED)), NODE_ATTRIBUTES.IS_ASYNC, getCachedTreeNodeAttr(uuid, item, NODE_ATTRIBUTES.IS_ASYNC)), NODE_ATTRIBUTES.IS_LOADING, getCachedTreeNodeAttr(uuid, item, NODE_ATTRIBUTES.IS_LOADING)), NODE_ATTRIBUTES.IS_INDETERMINATE, false));
             attributes[NODE_ATTRIBUTES.IS_CHECKED] = isCheckedNode(item, uuid, attributes);
             if (attributes[NODE_ATTRIBUTES.IS_CHECKED]) {
               checkedList.push(item);
@@ -23556,6 +23784,7 @@ var use_tree_init_this = undefined;
       }
     }
     flatten(treeData !== null && treeData !== void 0 ? treeData : data);
+    // 历史语义：checkStrictly=true 表示启用父子联动
     if (props.showCheckbox !== false && props.checkStrictly) {
       checkedList === null || checkedList === void 0 || checkedList.forEach(function (value) {
         loopUpdateNodeAttr(value, NODE_ATTRIBUTES.IS_CHECKED, true, loopUpdateCheckedEvent);
@@ -23643,15 +23872,17 @@ var use_tree_init_this = undefined;
   };
   /**
    * 监听组件配置Data改变
+   * 注意：外部应通过 onDataChange 回调更新数据，而非直接修改 props.data 内部节点
+   * 默认不使用 deep: true 以避免不必要的深度遍历开销
    */
   (0,external_vue_namespaceObject.watch)(function () {
-    return [props.data];
+    return props.data;
   }, function (newData) {
-    var _props$async, _props$async2;
-    var formatData = getFlatdata(newData[0], flatData.schema);
+    var _props$async2, _props$async3;
+    var formatData = getFlatdata(newData, flatData.schema);
     flatData.data = formatData[0];
     flatData.schema = formatData[1];
-    if ((_props$async = props.async) !== null && _props$async !== void 0 && _props$async.callback && ((_props$async2 = props.async) === null || _props$async2 === void 0 ? void 0 : _props$async2.deepAutoOpen) === 'every') {
+    if ((_props$async2 = props.async) !== null && _props$async2 !== void 0 && _props$async2.callback && ((_props$async3 = props.async) === null || _props$async3 === void 0 ? void 0 : _props$async3.deepAutoOpen) === 'every') {
       deepAutoOpen();
     }
     /**
@@ -23660,8 +23891,12 @@ var use_tree_init_this = undefined;
      */
     executeNextEvent();
   }, {
-    deep: true
+    deep: props.deepWatch
   });
+  // deepWatch 已废弃警告
+  if (props.deepWatch) {
+    console.warn('[BkTree] deepWatch is deprecated and will be removed in the next major version. ' + 'Please use onDataChange callback to update data instead of directly modifying props.data internal nodes.');
+  }
   if (props.selectable) {
     (0,external_vue_namespaceObject.onMounted)(function () {
       (0,external_vue_namespaceObject.watch)(function () {
@@ -23689,7 +23924,7 @@ var use_tree_init_this = undefined;
     registerNextLoop('afterDataUpdate', callFn);
   };
   /** 如果设置了异步请求 */
-  if ((_props$async3 = props.async) !== null && _props$async3 !== void 0 && _props$async3.callback) {
+  if ((_props$async4 = props.async) !== null && _props$async4 !== void 0 && _props$async4.callback) {
     deepAutoOpen();
   }
   return {
@@ -23755,6 +23990,10 @@ var use_tree_init_this = undefined;
       flatData = _useTreeInit.flatData,
       onSelected = _useTreeInit.onSelected,
       registerNextLoop = _useTreeInit.registerNextLoop;
+    var handleTreeDataChange = function handleTreeDataChange(payload) {
+      var _props$onDataChange;
+      (_props$onDataChange = props.onDataChange) === null || _props$onDataChange === void 0 || _props$onDataChange.call(props, payload);
+    };
     var _useNodeAttribute = use_node_attribute(flatData, props),
       checkNodeIsOpen = _useNodeAttribute.checkNodeIsOpen,
       isRootNode = _useNodeAttribute.isRootNode,
@@ -23879,7 +24118,7 @@ var use_tree_init_this = undefined;
         if (checked) {
           setNodeAction(resolvedNode, NODE_ATTRIBUTES.IS_INDETERMINATE, false);
         }
-        // 如果设置了 checkStrictly，需要同步更新子节点和父节点的状态
+        // 历史语义：checkStrictly=true 表示启用父子联动
         if (props.checkStrictly) {
           deepUpdateChildNode(resolvedNode, [NODE_ATTRIBUTES.IS_CHECKED, NODE_ATTRIBUTES.IS_INDETERMINATE], [checked, false]);
           updateParentChecked(resolvedNode, checked);
@@ -23896,32 +24135,46 @@ var use_tree_init_this = undefined;
     onSelected(function (newData) {
       setSelect(newData, true, props.autoOpenParentNode, true);
     });
+    var buildChildrenIndex = function buildChildrenIndex() {
+      var childrenMap = new Map();
+      flatData.data.forEach(function (node) {
+        var _getParentNode;
+        var parentNode = (_getParentNode = getParentNode(node)) !== null && _getParentNode !== void 0 ? _getParentNode : null;
+        if (!childrenMap.has(parentNode)) {
+          childrenMap.set(parentNode, []);
+        }
+        childrenMap.get(parentNode).push(node);
+      });
+      return childrenMap;
+    };
     /**
      * 根据最新的schema生成最新的Tree结构数据
      * @returns
      */
     var getLastTreeDataBySchema = function getLastTreeDataBySchema() {
+      var _childrenMap$get2;
+      var childrenMap = buildChildrenIndex();
       var _loopData = function loopData(rootNodeList) {
         return (rootNodeList !== null && rootNodeList !== void 0 ? rootNodeList : []).map(function (node) {
+          var _childrenMap$get;
           var copyData = (0,lodash.cloneDeep)(node);
           if (!copyData) {
             return copyData;
           }
-          var children = flatData.data.filter(function (item) {
-            return getParentNode(item) === node;
-          });
+          var children = (_childrenMap$get = childrenMap.get(node)) !== null && _childrenMap$get !== void 0 ? _childrenMap$get : [];
           copyData[props.children] = _loopData(children);
           return copyData;
         });
       };
-      return _loopData(getRootNodeList());
+      return _loopData((_childrenMap$get2 = childrenMap.get(null)) !== null && _childrenMap$get2 !== void 0 ? _childrenMap$get2 : getRootNodeList());
     };
     /**
      * 获取当前树形结构相关数据
      * @param newTree 如果启用了排序，拖拽功能，这里数据结构会改变，需要设置为true，获取最新的数据
      * @returns
      */
-    var getData = function getData(newTree) {
+    var getData = function getData() {
+      var newTree = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
       if (!newTree) {
         return flatData;
       }
@@ -24020,7 +24273,10 @@ var use_tree_init_this = undefined;
     });
     var _useEmpty = use_empty(props),
       renderEmpty = _useEmpty.renderEmpty;
-    use_node_drag(props, ctx, root, flatData);
+    use_node_drag(props, ctx, root, flatData, {
+      moveTreeNodeById: moveTreeNodeById,
+      onTreeDataChange: handleTreeDataChange
+    });
     var renderTreeContent = function renderTreeContent(scopedData) {
       var _ctx$slots$empty, _ctx$slots$empty2, _ctx$slots;
       if (scopedData.length) {