@weitutech/by-components 1.2.0 → 1.2.2

package/lib/by-components.common.js

@@ -96015,8 +96015,8 @@ var ByCascaderPanel_component = normalizeComponent(
 )
 
 /* harmony default export */ var ByCascaderPanel = (ByCascaderPanel_component.exports);
-;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"8cd600e8-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.use[1]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/loaders/templateLoader.js??ruleSet[1].rules[3]!./node_modules/cache-loader/dist/cjs.js??ruleSet[0].use[0]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/index.js??vue-loader-options!./src/components/cascader-panel-pro/ByCascaderPanelPro.vue?vue&type=template&id=4bdb9820
-var ByCascaderPanelProvue_type_template_id_4bdb9820_render = function render() {
+;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"8cd600e8-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.use[1]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/loaders/templateLoader.js??ruleSet[1].rules[3]!./node_modules/cache-loader/dist/cjs.js??ruleSet[0].use[0]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/index.js??vue-loader-options!./src/components/cascader-panel-pro/ByCascaderPanelPro.vue?vue&type=template&id=37aef47d
+var ByCascaderPanelProvue_type_template_id_37aef47d_render = function render() {
   var _vm = this,
     _c = _vm._self._c;
   return _c('div', {
@@ -96154,7 +96154,8 @@ var ByCascaderPanelProvue_type_template_id_4bdb9820_render = function render() {
     },
     on: {
       "input": _vm.onMainPanelInput,
-      "change": _vm.handleValueChange
+      "change": _vm.handleValueChange,
+      "store-ready": _vm.schedulePanelSyncFromExternalValue
     }
   }) : _vm._e(), _vm.searchOptions.length > 0 ? _c('VirtualCascaderPanel', {
     directives: [{
@@ -96257,8 +96258,215 @@ var ByCascaderPanelProvue_type_template_id_4bdb9820_render = function render() {
     staticClass: "empty-state"
   }, [_vm._v("暂无选中项")])], 1)])])])]);
 };
-var ByCascaderPanelProvue_type_template_id_4bdb9820_staticRenderFns = [];
+var ByCascaderPanelProvue_type_template_id_37aef47d_staticRenderFns = [];
+
+;// ./src/components/cascader-panel-pro/cascaderStorePro.js
+
+
+
+
+
+
+/**
+ * 级联树扁平化存储，初始化时预计算子树叶子元数据，供 O(1) 级勾选/聚合
+ */
+
+let nodeIdSeed = 0;
+function nextId() {
+  nodeIdSeed += 1;
+  return nodeIdSeed;
+}
+function resetCascaderStoreIdSeed() {
+  nodeIdSeed = 0;
+}
+
+/**
+ * @param {Array} options
+ * @param {Object} config - disabledField/disabledValue/disabledCheck
+ * @param {Object} cascaderProps
+ * @param {Object} utils - CascaderUtilsPro
+ */
+function buildCascaderStore(options, config, cascaderProps, utils) {
+  resetCascaderStoreIdSeed();
+  const valueKey = cascaderProps.value || 'value';
+  const labelKey = cascaderProps.label || 'label';
+  const childrenKey = cascaderProps.children || 'children';
+  const disabledKey = cascaderProps.disabled || 'disabled';
+  const nodes = [];
+  const nodeById = new Map();
+  const nodeByValue = new Map();
+  const childrenByParentId = new Map();
+  const rootIds = [];
+  const pathByLeafValue = new Map();
+  const allLeafValues = [];
+  const allLeafPaths = [];
+  const createNode = (raw, parentPath, level, parentId) => {
+    const value = raw[valueKey];
+    const children = raw[childrenKey];
+    const hasChildren = Array.isArray(children) && children.length > 0;
+    const id = nextId();
+    const nodePath = parentId == null ? [value] : parentPath.concat(value);
+    const node = {
+      id,
+      value,
+      label: raw[labelKey],
+      path: nodePath,
+      level,
+      parentId,
+      childIds: [],
+      isLeaf: !hasChildren,
+      disabled: !!raw[disabledKey],
+      raw,
+      descendantLeafValues: [],
+      descendantLeafCount: 0,
+      descendantPaths: []
+    };
+    nodes.push(node);
+    nodeById.set(id, node);
+    if (!nodeByValue.has(value)) {
+      nodeByValue.set(value, node);
+    }
+    if (parentId == null) {
+      rootIds.push(id);
+    } else {
+      const siblings = childrenByParentId.get(parentId) || [];
+      siblings.push(id);
+      childrenByParentId.set(parentId, siblings);
+      const parent = nodeById.get(parentId);
+      if (parent) {
+        parent.childIds.push(id);
+      }
+    }
+    if (hasChildren) {
+      children.forEach(child => {
+        createNode(child, nodePath, level + 1, id);
+      });
+    } else {
+      pathByLeafValue.set(value, nodePath);
+      if (!node.disabled) {
+        allLeafValues.push(value);
+        allLeafPaths.push(nodePath);
+      }
+    }
+    return node;
+  };
+  const walkRoots = (items, ancestorDisabled = false) => {
+    items.forEach(item => {
+      const isDisabled = ancestorDisabled || utils.isItemDisabled(item, config);
+      const cloned = {
+        ...item
+      };
+      if (isDisabled) {
+        cloned[disabledKey] = true;
+      }
+      createNode(cloned, [], 0, null);
+    });
+  };
+  walkRoots(options || []);
 
+  // 自底向上汇总子树叶子
+  const sorted = nodes.slice().sort((a, b) => b.level - a.level);
+  sorted.forEach(node => {
+    if (node.isLeaf) {
+      node.descendantLeafValues = [node.value];
+      node.descendantLeafCount = 1;
+      node.descendantPaths = [node.path];
+      return;
+    }
+    const leafValues = [];
+    const leafPaths = [];
+    node.childIds.forEach(childId => {
+      const child = nodeById.get(childId);
+      if (!child || child.descendantLeafCount === 0) {
+        return;
+      }
+      leafValues.push(...child.descendantLeafValues);
+      leafPaths.push(...child.descendantPaths);
+    });
+    node.descendantLeafValues = leafValues;
+    node.descendantLeafCount = leafValues.length;
+    node.descendantPaths = leafPaths;
+  });
+  return {
+    nodes,
+    nodeById,
+    nodeByValue,
+    childrenByParentId,
+    rootIds,
+    pathByLeafValue,
+    allLeafValues,
+    allLeafPaths,
+    totalLeafCount: allLeafPaths.length
+  };
+}
+function getStoreChildren(store, parentId) {
+  if (parentId == null) {
+    return store.rootIds.map(id => store.nodeById.get(id)).filter(Boolean);
+  }
+  const childIds = store.childrenByParentId.get(parentId) || [];
+  return childIds.map(id => store.nodeById.get(id)).filter(Boolean);
+}
+function resolveStoreNodeByValue(store, value) {
+  if (!store || value == null || value === '') {
+    return null;
+  }
+  if (store.nodeByValue.has(value)) {
+    return store.nodeByValue.get(value);
+  }
+  const num = Number(value);
+  if (!Number.isNaN(num) && store.nodeByValue.has(num)) {
+    return store.nodeByValue.get(num);
+  }
+  const str = String(value);
+  if (str !== value && store.nodeByValue.has(str)) {
+    return store.nodeByValue.get(str);
+  }
+  for (const [key, node] of store.nodeByValue) {
+    if (key == value) {
+      return node;
+    }
+  }
+  return null;
+}
+function getStoreLeafPath(store, leafValue) {
+  if (!store || leafValue == null || leafValue === '') {
+    return null;
+  }
+  if (store.pathByLeafValue.has(leafValue)) {
+    return store.pathByLeafValue.get(leafValue);
+  }
+  const node = resolveStoreNodeByValue(store, leafValue);
+  if (node && node.isLeaf) {
+    return node.path;
+  }
+  for (const [key, path] of store.pathByLeafValue) {
+    if (key == leafValue) {
+      return path;
+    }
+  }
+  return null;
+}
+function storeHasLeafValue(store, leafValue) {
+  return getStoreLeafPath(store, leafValue) != null;
+}
+function findStoreNodeByPath(store, pathValues) {
+  if (!pathValues || pathValues.length === 0) {
+    return null;
+  }
+  let node = resolveStoreNodeByValue(store, pathValues[0]);
+  if (!node || pathValues.length === 1) {
+    return node;
+  }
+  for (let i = 1; i < pathValues.length; i++) {
+    const target = pathValues[i];
+    const children = getStoreChildren(store, node.id);
+    node = children.find(child => child.value == target) || null;
+    if (!node) {
+      return null;
+    }
+  }
+  return node;
+}
 ;// ./src/components/cascader-panel-pro/cascaderUtilsPro.js
 
 
@@ -96278,6 +96486,7 @@ var ByCascaderPanelProvue_type_template_id_4bdb9820_staticRenderFns = [];
 /**
  * 级联选择器工具类（Pro 版，独立于 CascaderUtils）
  */
+
 class CascaderUtilsPro {
   /**
    * 估算级联节点标签文本宽度（px）
@@ -96620,14 +96829,14 @@ class CascaderUtilsPro {
     }
     const items = [];
     selection.selectedLeafSet.forEach(leafValue => {
-      const path = store.pathByLeafValue.get(leafValue);
-      const node = store.nodeByValue.get(leafValue);
+      const path = getStoreLeafPath(store, leafValue);
+      const node = resolveStoreNodeByValue(store, leafValue);
       if (!path || !node) {
         return;
       }
       items.push({
         ...node.raw,
-        value: leafValue,
+        value: node.value,
         label: node.label,
         path
       });
@@ -96751,7 +96960,7 @@ class CascaderUtilsPro {
     const items = [];
     const walk = nodeId => {
       const node = store.nodeById.get(nodeId);
-      if (!node || node.disabled) {
+      if (!node) {
         return;
       }
       const state = selection.getCheckState(nodeId);
@@ -96999,7 +97208,7 @@ class CascaderUtilsPro {
     const findPath = (nodes, targetValues, currentPath = []) => {
       for (const option of nodes) {
         const newPath = [...currentPath, option[cascaderProps.value]];
-        if (targetValues.includes(option[cascaderProps.value])) {
+        if (targetValues.some(target => target == option[cascaderProps.value])) {
           // 如果是叶子节点（没有children属性），添加到路径中
           if (!option[cascaderProps.children]) {
             paths.push(newPath);
@@ -97016,8 +97225,8 @@ class CascaderUtilsPro {
     return paths;
   }
 }
-;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"8cd600e8-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.use[1]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/loaders/templateLoader.js??ruleSet[1].rules[3]!./node_modules/cache-loader/dist/cjs.js??ruleSet[0].use[0]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/index.js??vue-loader-options!./src/components/cascader-panel-pro/VirtualCascaderPanel.vue?vue&type=template&id=23086f90
-var VirtualCascaderPanelvue_type_template_id_23086f90_render = function render() {
+;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"8cd600e8-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.use[1]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/loaders/templateLoader.js??ruleSet[1].rules[3]!./node_modules/cache-loader/dist/cjs.js??ruleSet[0].use[0]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/index.js??vue-loader-options!./src/components/cascader-panel-pro/VirtualCascaderPanel.vue?vue&type=template&id=05f77638
+var VirtualCascaderPanelvue_type_template_id_05f77638_render = function render() {
   var _vm = this,
     _c = _vm._self._c;
   return _c('div', {
@@ -97108,7 +97317,7 @@ var VirtualCascaderPanelvue_type_template_id_23086f90_render = function render()
     })], 1);
   }), 0);
 };
-var VirtualCascaderPanelvue_type_template_id_23086f90_staticRenderFns = [];
+var VirtualCascaderPanelvue_type_template_id_05f77638_staticRenderFns = [];
 
 ;// ./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"node_modules/.cache/vue-loader","cacheIdentifier":"8cd600e8-vue-loader-template"}!./node_modules/babel-loader/lib/index.js??clonedRuleSet-40.use[1]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/loaders/templateLoader.js??ruleSet[1].rules[3]!./node_modules/cache-loader/dist/cjs.js??ruleSet[0].use[0]!./node_modules/@vue/cli-service/node_modules/@vue/vue-loader-v15/lib/index.js??vue-loader-options!./src/components/cascader-panel-pro/VirtualList.vue?vue&type=template&id=43cb1148
 var VirtualListvue_type_template_id_43cb1148_render = function render() {
@@ -97264,170 +97473,6 @@ var VirtualList_component = normalizeComponent(
 )
 
 /* harmony default export */ var VirtualList = (VirtualList_component.exports);
-;// ./src/components/cascader-panel-pro/cascaderStorePro.js
-
-
-
-
-
-
-/**
- * 级联树扁平化存储，初始化时预计算子树叶子元数据，供 O(1) 级勾选/聚合
- */
-
-let nodeIdSeed = 0;
-function nextId() {
-  nodeIdSeed += 1;
-  return nodeIdSeed;
-}
-function resetCascaderStoreIdSeed() {
-  nodeIdSeed = 0;
-}
-
-/**
- * @param {Array} options
- * @param {Object} config - disabledField/disabledValue/disabledCheck
- * @param {Object} cascaderProps
- * @param {Object} utils - CascaderUtilsPro
- */
-function buildCascaderStore(options, config, cascaderProps, utils) {
-  resetCascaderStoreIdSeed();
-  const valueKey = cascaderProps.value || 'value';
-  const labelKey = cascaderProps.label || 'label';
-  const childrenKey = cascaderProps.children || 'children';
-  const disabledKey = cascaderProps.disabled || 'disabled';
-  const nodes = [];
-  const nodeById = new Map();
-  const nodeByValue = new Map();
-  const childrenByParentId = new Map();
-  const rootIds = [];
-  const pathByLeafValue = new Map();
-  const allLeafValues = [];
-  const allLeafPaths = [];
-  const createNode = (raw, parentPath, level, parentId) => {
-    const value = raw[valueKey];
-    const children = raw[childrenKey];
-    const hasChildren = Array.isArray(children) && children.length > 0;
-    const id = nextId();
-    const nodePath = parentId == null ? [value] : parentPath.concat(value);
-    const node = {
-      id,
-      value,
-      label: raw[labelKey],
-      path: nodePath,
-      level,
-      parentId,
-      childIds: [],
-      isLeaf: !hasChildren,
-      disabled: !!raw[disabledKey],
-      raw,
-      descendantLeafValues: [],
-      descendantLeafCount: 0,
-      descendantPaths: []
-    };
-    nodes.push(node);
-    nodeById.set(id, node);
-    if (!nodeByValue.has(value)) {
-      nodeByValue.set(value, node);
-    }
-    if (parentId == null) {
-      rootIds.push(id);
-    } else {
-      const siblings = childrenByParentId.get(parentId) || [];
-      siblings.push(id);
-      childrenByParentId.set(parentId, siblings);
-      const parent = nodeById.get(parentId);
-      if (parent) {
-        parent.childIds.push(id);
-      }
-    }
-    if (hasChildren) {
-      children.forEach(child => {
-        createNode(child, nodePath, level + 1, id);
-      });
-    } else if (!node.disabled) {
-      pathByLeafValue.set(value, nodePath);
-      allLeafValues.push(value);
-      allLeafPaths.push(nodePath);
-    }
-    return node;
-  };
-  const walkRoots = (items, ancestorDisabled = false) => {
-    items.forEach(item => {
-      const isDisabled = ancestorDisabled || utils.isItemDisabled(item, config);
-      const cloned = {
-        ...item
-      };
-      if (isDisabled) {
-        cloned[disabledKey] = true;
-      }
-      createNode(cloned, [], 0, null);
-    });
-  };
-  walkRoots(options || []);
-
-  // 自底向上汇总子树叶子
-  const sorted = nodes.slice().sort((a, b) => b.level - a.level);
-  sorted.forEach(node => {
-    if (node.isLeaf) {
-      if (!node.disabled) {
-        node.descendantLeafValues = [node.value];
-        node.descendantLeafCount = 1;
-        node.descendantPaths = [node.path];
-      }
-      return;
-    }
-    const leafValues = [];
-    const leafPaths = [];
-    node.childIds.forEach(childId => {
-      const child = nodeById.get(childId);
-      if (!child || child.descendantLeafCount === 0) {
-        return;
-      }
-      leafValues.push(...child.descendantLeafValues);
-      leafPaths.push(...child.descendantPaths);
-    });
-    node.descendantLeafValues = leafValues;
-    node.descendantLeafCount = leafValues.length;
-    node.descendantPaths = leafPaths;
-  });
-  return {
-    nodes,
-    nodeById,
-    nodeByValue,
-    childrenByParentId,
-    rootIds,
-    pathByLeafValue,
-    allLeafValues,
-    allLeafPaths,
-    totalLeafCount: allLeafPaths.length
-  };
-}
-function getStoreChildren(store, parentId) {
-  if (parentId == null) {
-    return store.rootIds.map(id => store.nodeById.get(id)).filter(Boolean);
-  }
-  const childIds = store.childrenByParentId.get(parentId) || [];
-  return childIds.map(id => store.nodeById.get(id)).filter(Boolean);
-}
-function findStoreNodeByPath(store, pathValues) {
-  if (!pathValues || pathValues.length === 0) {
-    return null;
-  }
-  let node = store.nodeByValue.get(pathValues[0]);
-  if (!node || pathValues.length === 1) {
-    return node;
-  }
-  for (let i = 1; i < pathValues.length; i++) {
-    const target = pathValues[i];
-    const children = getStoreChildren(store, node.id);
-    node = children.find(child => child.value == target) || null;
-    if (!node) {
-      return null;
-    }
-  }
-  return node;
-}
 ;// ./src/components/cascader-panel-pro/selectionStatePro.js
 
 
@@ -97439,6 +97484,7 @@ function findStoreNodeByPath(store, pathValues) {
 
 
 
+
 const COMPACT_EMIT_THRESHOLD = 300;
 
 class SelectionStatePro {
@@ -97603,32 +97649,40 @@ class SelectionStatePro {
         return;
       }
       const leafValue = path[path.length - 1];
-      if (this.store.pathByLeafValue.has(leafValue)) {
-        this.selectedLeafSet.add(leafValue);
+      const leafPath = getStoreLeafPath(this.store, leafValue);
+      if (leafPath) {
+        this.selectedLeafSet.add(leafPath[leafPath.length - 1]);
       }
     });
     this._reconcileAllRoots();
   }
   getCheckState(nodeId) {
     const node = this.store.nodeById.get(nodeId);
-    if (!node || node.disabled) {
+    if (!node) {
       return 'disabled';
     }
+    let selectionState;
     if (node.isLeaf) {
-      return this.selectedLeafSet.has(node.value) ? 'checked' : 'unchecked';
-    }
-    const total = node.descendantLeafCount;
-    if (total === 0) {
-      return 'unchecked';
-    }
-    const selected = this.subtreeSelectedCount.get(node.id) || 0;
-    if (selected === 0) {
-      return 'unchecked';
+      selectionState = this.selectedLeafSet.has(node.value) ? 'checked' : 'unchecked';
+    } else {
+      const total = node.descendantLeafCount;
+      if (total === 0) {
+        selectionState = 'unchecked';
+      } else {
+        const selected = this.subtreeSelectedCount.get(node.id) || 0;
+        if (selected === 0) {
+          selectionState = 'unchecked';
+        } else if (selected >= total) {
+          selectionState = 'checked';
+        } else {
+          selectionState = 'indeterminate';
+        }
+      }
     }
-    if (selected >= total) {
-      return 'checked';
+    if (node.disabled && selectionState === 'unchecked') {
+      return 'disabled';
     }
-    return 'indeterminate';
+    return selectionState;
   }
   isChecked(nodeId) {
     return this.getCheckState(nodeId) === 'checked';
@@ -97674,8 +97728,8 @@ class SelectionStatePro {
       if (typeof val === 'string' && val.startsWith(prefix)) {
         rootValue = val.substring(prefix.length);
       }
-      const node = this.store.nodeByValue.get(rootValue);
-      if (node && !node.isLeaf && !node.disabled) {
+      const node = resolveStoreNodeByValue(this.store, rootValue);
+      if (node && !node.isLeaf) {
         node.descendantLeafValues.forEach(v => this.selectedLeafSet.add(v));
       }
     });
@@ -97876,6 +97930,9 @@ class SelectionStatePro {
       }
       this.$nextTick(() => {
         this.syncHorizontalOverflow();
+        if (!this.syncValueFromParent) {
+          this.$emit('store-ready');
+        }
       });
     },
     syncFromValue() {
@@ -98173,8 +98230,8 @@ class SelectionStatePro {
 ;
 var VirtualCascaderPanel_component = normalizeComponent(
   cascader_panel_pro_VirtualCascaderPanelvue_type_script_lang_js,
-  VirtualCascaderPanelvue_type_template_id_23086f90_render,
-  VirtualCascaderPanelvue_type_template_id_23086f90_staticRenderFns,
+  VirtualCascaderPanelvue_type_template_id_05f77638_render,
+  VirtualCascaderPanelvue_type_template_id_05f77638_staticRenderFns,
   false,
   null,
   null,
@@ -98201,6 +98258,7 @@ var VirtualCascaderPanel_component = normalizeComponent(
 
 
 
+
 /* harmony default export */ var ByCascaderPanelProvue_type_script_lang_js = ({
   name: 'ByCascaderPanelPro',
   components: {
@@ -98335,7 +98393,8 @@ var VirtualCascaderPanel_component = normalizeComponent(
       compactPanelValue: [],
       // 紧凑模式下稳定的空 value 引用，避免 watch 误触发清空
       searchDebounceTimer: null,
-      searchLeafSetCache: null
+      searchLeafSetCache: null,
+      panelSyncTimer: null
     };
   },
   computed: {
@@ -98495,6 +98554,7 @@ var VirtualCascaderPanel_component = normalizeComponent(
       clearTimeout(this.searchDebounceTimer);
       this.searchDebounceTimer = null;
     }
+    this.clearPanelSyncTimer();
   },
   methods: {
     onMainPanelInput(value) {
@@ -98507,7 +98567,7 @@ var VirtualCascaderPanel_component = normalizeComponent(
         this.selectedValues = value && value.length ? [value] : [];
       }
     },
-    applyPanelSelectionChange() {
+    refreshSelectionDisplayFromPanel() {
       const panel = this.$refs.cascaderPanel;
       if (!panel || !panel.store || !panel.selection) {
         return;
@@ -98524,29 +98584,46 @@ var VirtualCascaderPanel_component = normalizeComponent(
         if (!selection.isCompactSelection()) {
           this.selectedValues = selection.getCheckedPaths();
         }
+        panel.bumpSelectionView();
+        return;
+      }
+      if (selection.isCompactSelection()) {
+        this.selectedItems = this.buildSelectedItemsFromValuesLazy(panel);
+        this.selectedCount = selection.size();
+        this.isAllSelected = selection.size() === store.totalLeafCount;
+        panel.bumpSelectionView();
+        return;
+      }
+      this.selectedValues = selection.getCheckedPaths();
+      this.updateSelectedItems();
+      panel.bumpSelectionView();
+    },
+    applyPanelSelectionChange() {
+      const panel = this.$refs.cascaderPanel;
+      if (!panel || !panel.store || !panel.selection) {
+        return;
+      }
+      const {
+        store,
+        selection
+      } = panel;
+      this.refreshSelectionDisplayFromPanel();
+      if (this.aggregationMode) {
         this.isInternalUpdate = true;
-        let emitValue = CascaderUtilsPro.getAggregatedEmitValues(items, this.parentNodePrefix);
+        let emitValue = CascaderUtilsPro.getAggregatedEmitValues(this.selectedItems, this.parentNodePrefix);
         if (!this.isMultiple && emitValue.length > 0) {
           emitValue = emitValue[0];
         }
         this.$emit('input', emitValue);
         this.$emit('change', this.getSelectedData());
-        panel.bumpSelectionView();
         return;
       }
       if (selection.isCompactSelection()) {
-        this.selectedItems = this.buildSelectedItemsFromValuesLazy(panel);
-        this.selectedCount = this.aggregationMode ? this.selectedItems.length : selection.size();
-        this.isAllSelected = selection.size() === store.totalLeafCount;
         this.isInternalUpdate = true;
         this.$emit('input', this.currentValue);
         this.$emit('change', this.getSelectedData());
-        panel.bumpSelectionView();
         return;
       }
-      this.selectedValues = selection.getCheckedPaths();
-      this.updateSelectedItems();
-      panel.bumpSelectionView();
       this.$nextTick(() => {
         this.isInternalUpdate = true;
         let emitValue = this.currentValue;
@@ -98572,56 +98649,151 @@ var VirtualCascaderPanel_component = normalizeComponent(
     syncPanelFromExternalValue() {
       const panel = this.$refs.cascaderPanel;
       if (!panel || !panel.selection || !panel.store) {
-        return;
+        return false;
       }
-      if (!Array.isArray(this.value) || this.value.length === 0) {
+      if (!this.hasExternalValue()) {
         panel.clearCheckedNodes();
         this.selectedItems = [];
         this.selectedValues = [];
-        return;
+        return true;
       }
-      const paths = this.resolveExternalValueToPaths();
       panel.selection.clear();
+      this.applyExternalValueToPanelSelection(panel);
+      panel.selection._reconcileAllRoots();
+      panel.bumpSelectionView();
+      this.refreshSelectionDisplayFromPanel();
+      this.expandPanelToExternalValue(panel);
+      return true;
+    },
+    hasExternalValue() {
+      const val = this.value;
+      if (val == null || val === '') {
+        return false;
+      }
+      if (Array.isArray(val)) {
+        return val.length > 0;
+      }
+      return true;
+    },
+    applyExternalValueToPanelSelection(panel) {
+      const {
+        store,
+        selection
+      } = panel;
+      const paths = this.resolveExternalValueToPaths();
       paths.forEach(path => {
+        if (!Array.isArray(path) || path.length === 0) {
+          return;
+        }
         const leafValue = path[path.length - 1];
-        if (panel.store.pathByLeafValue.has(leafValue)) {
-          panel.selection.selectedLeafSet.add(leafValue);
+        const leafPath = getStoreLeafPath(store, leafValue);
+        if (leafPath) {
+          selection.selectedLeafSet.add(leafPath[leafPath.length - 1]);
+        }
+      });
+
+      // 直接按外部 value 再补一遍，避免 paths 解析遗漏（聚合父节点、异步 options 等）
+      this.getExternalValueList().forEach(val => {
+        if (this.aggregationMode && CascaderUtilsPro.isParentNodeValue(val, this.parentNodePrefix)) {
+          const actualValue = CascaderUtilsPro.extractParentNodeValue(val, this.parentNodePrefix);
+          const node = resolveStoreNodeByValue(store, actualValue);
+          if (node && !node.isLeaf) {
+            node.descendantLeafValues.forEach(leaf => selection.selectedLeafSet.add(leaf));
+          }
+          return;
+        }
+        const leafPath = getStoreLeafPath(store, val);
+        if (leafPath) {
+          selection.selectedLeafSet.add(leafPath[leafPath.length - 1]);
+          return;
+        }
+        const node = resolveStoreNodeByValue(store, val);
+        if (node && node.isLeaf) {
+          selection.selectedLeafSet.add(node.value);
+        } else if (node && !node.isLeaf) {
+          node.descendantLeafValues.forEach(leaf => selection.selectedLeafSet.add(leaf));
+        }
+      });
+    },
+    getExternalValueList() {
+      const val = this.value;
+      if (val == null || val === '') {
+        return [];
+      }
+      if (Array.isArray(val)) {
+        if (val.length === 0) {
+          return [];
+        }
+        if (Array.isArray(val[0])) {
+          return val.map(path => path[path.length - 1]);
+        }
+        return val;
+      }
+      return [val];
+    },
+    clearPanelSyncTimer() {
+      if (this.panelSyncTimer) {
+        clearTimeout(this.panelSyncTimer);
+        this.panelSyncTimer = null;
+      }
+    },
+    schedulePanelSyncFromExternalValue(retry = 0) {
+      this.clearPanelSyncTimer();
+      this.$nextTick(() => {
+        if (!this.hasExternalValue()) {
+          const panel = this.$refs.cascaderPanel;
+          if (panel && panel.selection) {
+            panel.clearCheckedNodes();
+          }
+          this.selectedItems = [];
+          this.selectedValues = [];
+          return;
+        }
+        const synced = this.syncPanelFromExternalValue();
+        if (!synced && retry < 20) {
+          this.panelSyncTimer = setTimeout(() => {
+            this.schedulePanelSyncFromExternalValue(retry + 1);
+          }, 50);
         }
       });
-      panel.selection._reconcileAllRoots();
-      panel.bumpSelectionView();
-      this.applyPanelSelectionChange();
-      this.expandPanelToExternalValue(panel);
     },
     resolveExternalValueToPaths() {
-      if (!Array.isArray(this.value) || this.value.length === 0) {
+      const val = this.value;
+      if (val == null || val === '') {
         return [];
       }
-      if (typeof this.value[0] === 'string' || typeof this.value[0] === 'number') {
+      if (Array.isArray(val) && val.length > 0 && Array.isArray(val[0])) {
+        return [...val];
+      }
+      const values = Array.isArray(val) ? val : [val];
+      if (typeof values[0] === 'string' || typeof values[0] === 'number') {
         if (this.aggregationMode) {
-          return CascaderUtilsPro.processValuesWithParentNodes(this.value, this.filteredOptions, this.cascaderProps, this.parentNodePrefix);
+          return CascaderUtilsPro.processValuesWithParentNodes(values, this.filteredOptions, this.cascaderProps, this.parentNodePrefix);
         }
-        return this.findPathsByValues(this.value);
+        return this.findPathsByValues(values);
       }
-      return [...this.value];
+      return Array.isArray(val) ? [...val] : [];
     },
     expandPanelToExternalValue(panel) {
-      if (!panel || !panel.store || !Array.isArray(this.value) || this.value.length === 0) {
+      if (!panel || !panel.store || !this.hasExternalValue()) {
         return;
       }
-      const firstValue = this.value[0];
+      const values = this.getExternalValueList();
+      const firstValue = values[0];
       let pathValues = [];
       if (this.aggregationMode && CascaderUtilsPro.isParentNodeValue(firstValue, this.parentNodePrefix)) {
         const actualValue = CascaderUtilsPro.extractParentNodeValue(firstValue, this.parentNodePrefix);
-        const node = panel.store.nodeByValue.get(actualValue);
+        const node = resolveStoreNodeByValue(panel.store, actualValue);
         pathValues = node ? [...node.path] : [];
-      } else if (panel.store.pathByLeafValue.has(firstValue)) {
-        const path = panel.store.pathByLeafValue.get(firstValue);
-        pathValues = path ? path.slice(0, -1) : [];
       } else {
-        const node = panel.store.nodeByValue.get(firstValue);
-        if (node) {
-          pathValues = node.isLeaf ? node.path.slice(0, -1) : [...node.path];
+        const leafPath = getStoreLeafPath(panel.store, firstValue);
+        if (leafPath) {
+          pathValues = leafPath.slice(0, -1);
+        } else {
+          const node = resolveStoreNodeByValue(panel.store, firstValue);
+          if (node) {
+            pathValues = node.isLeaf ? node.path.slice(0, -1) : [...node.path];
+          }
         }
       }
       if (pathValues.length > 0) {
@@ -98642,11 +98814,15 @@ var VirtualCascaderPanel_component = normalizeComponent(
     },
     // 处理 value 值
     processValue() {
+      if (!this.hasExternalValue()) {
+        this.selectedValues = [];
+        this.selectedItems = [];
+        this.schedulePanelSyncFromExternalValue();
+        return;
+      }
       if (this.useCompactSelection && this.isMultiple) {
         this.selectedValues = [];
-        this.$nextTick(() => {
-          this.syncPanelFromExternalValue();
-        });
+        this.schedulePanelSyncFromExternalValue();
         return;
       }
       if (this.isMultiple) {
@@ -98688,27 +98864,14 @@ var VirtualCascaderPanel_component = normalizeComponent(
           this.selectedValues = [];
         }
       }
-      this.updateSelectedItems();
-
-      // 单选模式下，确保级联面板正确显示选中状态
-      if (!this.isMultiple && this.selectedValues.length > 0) {
-        this.$nextTick(() => {
-          const panel = this.$refs.cascaderPanel;
-          if (panel) {
-            panel.syncCheckedValue();
-            this.updateSelectedItems();
-          }
-        });
-      }
+      this.schedulePanelSyncFromExternalValue();
     },
     // 初始化选项数据
     initOptions() {
       this.filteredOptions = this.processOptions(this.options);
       this.countTotalItems();
-      if (this.isMultiple && Array.isArray(this.value) && this.value.length > 0 && (this.useCompactSelection || this.$refs.cascaderPanel)) {
-        this.$nextTick(() => {
-          this.syncPanelFromExternalValue();
-        });
+      if (this.hasExternalValue()) {
+        this.schedulePanelSyncFromExternalValue();
       } else {
         this.updateSelectedItems();
       }
@@ -98891,23 +99054,23 @@ var VirtualCascaderPanel_component = normalizeComponent(
       const panel = this.$refs.cascaderPanel;
       if (panel && panel.selection) {
         if (item.isAggregated) {
-          const node = panel.store.nodeByValue.get(item.value);
+          const node = resolveStoreNodeByValue(panel.store, item.value);
           if (node) {
             panel.selection.toggleNode(node.id, false);
           }
         } else if (item.path && item.path.length > 0) {
           const leafValue = item.path[item.path.length - 1];
-          const leafNode = panel.store.nodeByValue.get(leafValue);
+          const leafNode = resolveStoreNodeByValue(panel.store, leafValue);
           if (leafNode) {
             panel.selection.toggleNode(leafNode.id, false);
           } else {
-            const node = panel.store.nodeByValue.get(item.value);
+            const node = resolveStoreNodeByValue(panel.store, item.value);
             if (node) {
               panel.selection.toggleNode(node.id, false);
             }
           }
         } else {
-          const node = panel.store.nodeByValue.get(item.value);
+          const node = resolveStoreNodeByValue(panel.store, item.value);
           if (node) {
             panel.selection.toggleNode(node.id, false);
           }
@@ -99039,7 +99202,7 @@ var VirtualCascaderPanel_component = normalizeComponent(
           this.selectedValues = [];
         }
       }
-      this.updateSelectedItems();
+      this.schedulePanelSyncFromExternalValue();
     },
     // 根据values找到对应的路径
     findPathsByValues(values) {
@@ -99047,7 +99210,7 @@ var VirtualCascaderPanel_component = normalizeComponent(
       const findPath = (options, targetValues, currentPath = []) => {
         for (const option of options) {
           const newPath = [...currentPath, option[this.cascaderProps.value]];
-          if (targetValues.includes(option[this.cascaderProps.value])) {
+          if (targetValues.some(target => target == option[this.cascaderProps.value])) {
             // 如果是叶子节点（没有children属性），添加到路径中
             if (!option[this.cascaderProps.children]) {
               paths.push(newPath);
@@ -99093,8 +99256,9 @@ var VirtualCascaderPanel_component = normalizeComponent(
         if (panel && panel.selection && panel.store) {
           matchedPaths.forEach(path => {
             const leafValue = path[path.length - 1];
-            if (panel.store.pathByLeafValue.has(leafValue)) {
-              panel.selection.selectedLeafSet.add(leafValue);
+            const leafPath = getStoreLeafPath(panel.store, leafValue);
+            if (leafPath) {
+              panel.selection.selectedLeafSet.add(leafPath[leafPath.length - 1]);
             }
           });
           panel.selection._reconcileAllRoots();
@@ -99197,8 +99361,8 @@ var VirtualCascaderPanel_component = normalizeComponent(
 ;
 var ByCascaderPanelPro_component = normalizeComponent(
   cascader_panel_pro_ByCascaderPanelProvue_type_script_lang_js,
-  ByCascaderPanelProvue_type_template_id_4bdb9820_render,
-  ByCascaderPanelProvue_type_template_id_4bdb9820_staticRenderFns,
+  ByCascaderPanelProvue_type_template_id_37aef47d_render,
+  ByCascaderPanelProvue_type_template_id_37aef47d_staticRenderFns,
   false,
   null,
   null,