x-sccba 0.2.4 → 0.2.5

package/dist/vue2/index211.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.create,Object.defineProperty,Object.getOwnPropertyDescriptor,Object.getOwnPropertyNames,Object.getPrototypeOf,Object.prototype.hasOwnProperty;var e=(e,r,l)=>new Promise((t,o)=>{var u=e=>{try{a(l.next(e))}catch(r){o(r)}},c=e=>{try{a(l.throw(e))}catch(r){o(r)}},a=e=>e.done?t(e.value):Promise.resolve(e.value).then(u,c);a((l=l.apply(e,r)).next())});Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("@vue/composition-api"),l=require("./index145.cjs"),t=require("./index234.cjs");let o=null,u=!1,c=!1;function a(){return e(this,null,function*(){var e;if(u)return o;if(c)return null;try{const r=yield import("vue-virtual-scroller"),t=r.RecycleScroller||(null==(e=r.default)?void 0:e.RecycleScroller);return t?(o={RecycleScroller:t},u=!0,o):(c=!0,l.warnOnce("XTable:virtualScroll:noExport","[XTable] vue-virtual-scroller 已加载但未导出 RecycleScroller，虚拟滚动已禁用"),null)}catch(r){return c=!0,l.warnOnce("XTable:virtualScroll:notInstalled","[XTable] useVirtual=true 需要安装 vue-virtual-scroller，请运行: pnpm add vue-virtual-scroller"),null}})}exports.loadVirtualScroller=a,exports.useVirtualScroll=function(o,u,c,n){const i=r.shallowRef(null),s=r.ref(!1),p=r.computed(()=>o.value&&!!i.value),v=r.computed(()=>c.value||t.DEFAULT_VIRTUAL_ITEM_HEIGHT),d=r.computed(()=>u.value||t.DEFAULT_VIRTUAL_SHOW_SIZE);return{shouldVirtualize:p,RecycleScroller:i,loadFailed:s,itemSize:v,bufferSize:d,ensureLoaded:()=>e(null,null,function*(){if(!o.value)return;if(i.value||s.value)return;const e=yield a();e?i.value=e.RecycleScroller:s.value=!0}),checkCompat:()=>{if(!o.value)return;const e=n()||{};(e["span-method"]||e.spanMethod)&&l.warnOnce("XTable:virtualScroll:spanMethod","[XTable] 虚拟滚动模式下 span-method 不可用，合并行/列将被忽略"),(e["tree-props"]||e.treeProps)&&l.warnOnce("XTable:virtualScroll:treeProps","[XTable] 虚拟滚动模式下 tree-props 不可用，请使用平铺数据")}}};
+"use strict";var e=(e,l,r)=>new Promise((t,u)=>{var a=e=>{try{n(r.next(e))}catch(l){u(l)}},o=e=>{try{n(r.throw(e))}catch(l){u(l)}},n=e=>e.done?t(e.value):Promise.resolve(e.value).then(a,o);n((r=r.apply(e,l)).next())});Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("@vue/composition-api"),r=require("./index145.cjs"),t=require("./index234.cjs");function u(){return e(this,null,function*(){return r.warnOnce("XTable:virtualScroll:disabled","[XTable] 虚拟滚动能力暂未开放，useVirtual 将被忽略"),null})}exports.loadVirtualScroller=u,exports.useVirtualScroll=function(a,o,n,c){const i=l.shallowRef(null),s=l.ref(!1),p=l.computed(()=>a.value&&!!i.value),d=l.computed(()=>n.value||t.DEFAULT_VIRTUAL_ITEM_HEIGHT),v=l.computed(()=>o.value||t.DEFAULT_VIRTUAL_SHOW_SIZE);return{shouldVirtualize:p,RecycleScroller:i,loadFailed:s,itemSize:d,bufferSize:v,ensureLoaded:()=>e(null,null,function*(){if(!a.value)return;if(i.value||s.value)return;const e=yield u();e?i.value=e.RecycleScroller:s.value=!0}),checkCompat:()=>{if(!a.value)return;const e=c()||{};(e["span-method"]||e.spanMethod)&&r.warnOnce("XTable:virtualScroll:spanMethod","[XTable] 虚拟滚动模式下 span-method 不可用，合并行/列将被忽略"),(e["tree-props"]||e.treeProps)&&r.warnOnce("XTable:virtualScroll:treeProps","[XTable] 虚拟滚动模式下 tree-props 不可用，请使用平铺数据")}}};
 //# sourceMappingURL=index211.cjs.map

package/dist/vue2/index211.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index211.cjs","sources":["../../src/components/XTable/useVirtualScroll.ts"],"sourcesContent":["// packages/core/src/components/XTable/useVirtualScroll.ts\n//\n// useVirtualScroll —— 虚拟滚动接入 vue-virtual-scroller（optional peer）\n//\n// 设计目标：\n//  - 用户安装 vue-virtual-scroller 时，useVirtual=true 启用大数据量虚拟滚动\n//  - 用户未安装时，给出友好 warn 并回退到普通 ElTable 渲染（不崩溃）\n//  - 检测到不兼容场景（fixed columns / span-method / tree-props）时 dev warn\n//\n// 与 ElTable 的协作：\n//  - ElTable 自身不暴露虚拟滚动 API（TableV2 是独立组件，且 Vue2 端不可用）\n//  - 本 hook 在 useVirtual=true 时旁路 ElTable，改用 RecycleScroller 渲染行\n//  - 表头仍由 ElTable 渲染（仅渲染表头部分，不渲染 tbody），保持样式一致\n//\n// 性能要点：\n//  - vue-virtual-scroller 的 RecycleScroller 自带 itemSize + buffer 优化\n//  - 避免在循环内创建闭包（render 函数引用稳定）\n\nimport type { Component, ComputedRef, Ref } from 'vue-demi';\nimport { computed, ref, shallowRef } from 'vue-demi';\nimport { warnOnce } from '../../utils/warnOnce';\nimport {\n  DEFAULT_VIRTUAL_ITEM_HEIGHT,\n  DEFAULT_VIRTUAL_SHOW_SIZE\n} from './src/constants';\n// vue-virtual-scroller 类型桩在 ./vue-virtual-scroller.types.d.ts 中声明（optional peer）\n\n// 模块级缓存：避免每次启用虚拟滚动都触发 import()\nlet _scrollerCache: { RecycleScroller: Component } | null = null;\nlet _scrollerLoaded = false;\nlet _scrollerFailed = false;\n\n/**\n * 运行时动态加载 vue-virtual-scroller。\n * 失败一次后不再重试，避免反复触发网络请求或抛错。\n *\n * 返回值：\n *  - 成功：{ RecycleScroller }（vue-virtual-scroller v1.x/v2.x 都导出此命名）\n *  - 失败：null（用户未安装该 peer）\n */\nexport async function loadVirtualScroller(): Promise<{\n  RecycleScroller: Component;\n} | null> {\n  if (_scrollerLoaded) {\n    return _scrollerCache;\n  }\n  if (_scrollerFailed) {\n    return null;\n  }\n  try {\n    // @vite-ignore 注释避免 Vite 静态分析时抛 unresolved 错误（peerDep 未必装）\n    const mod: any = await import(/* @vite-ignore */ 'vue-virtual-scroller');\n    const RecycleScroller = mod.RecycleScroller || mod.default?.RecycleScroller;\n    if (!RecycleScroller) {\n      _scrollerFailed = true;\n      warnOnce(\n        'XTable:virtualScroll:noExport',\n        '[XTable] vue-virtual-scroller 已加载但未导出 RecycleScroller，虚拟滚动已禁用'\n      );\n      return null;\n    }\n    _scrollerCache = { RecycleScroller };\n    _scrollerLoaded = true;\n    return _scrollerCache;\n  } catch {\n    _scrollerFailed = true;\n    warnOnce(\n      'XTable:virtualScroll:notInstalled',\n      '[XTable] useVirtual=true 需要安装 vue-virtual-scroller，请运行: pnpm add vue-virtual-scroller'\n    );\n    return null;\n  }\n}\n\n/**\n * useVirtualScroll —— 虚拟滚动状态与异步加载控制。\n *\n * @param useVirtual - 是否启用虚拟滚动（响应式）\n * @param virtualShowSize - 可视区域渲染行数（响应式，默认 30）\n * @param virtualItemHeight - 预估行高 px（响应式，默认 50）\n * @param attrsRef - 用户透传给 ElTable 的 attrs（用于检测不兼容场景）\n *\n * 返回：\n *  - shouldVirtualize：最终是否启用虚拟模式（useVirtual + 加载成功）\n *  - RecycleScroller：vue-virtual-scroller 组件（响应式，加载完成后填充）\n *  - itemSize：合并后的行高\n *  - bufferSize：合并后的可视区行数\n */\nexport interface UseVirtualScrollReturn {\n  shouldVirtualize: ComputedRef<boolean>;\n  RecycleScroller: Ref<Component | null>;\n  loadFailed: Ref<boolean>;\n  itemSize: ComputedRef<number>;\n  bufferSize: ComputedRef<number>;\n  ensureLoaded: () => Promise<void>;\n  checkCompat: () => void;\n}\n\nexport function useVirtualScroll(\n  useVirtual: Ref<boolean>,\n  virtualShowSize: Ref<number>,\n  virtualItemHeight: Ref<number>,\n  attrsRef: () => Record<string, any>\n): UseVirtualScrollReturn {\n  // 使用 shallowRef 存储组件定义，避免 Vue3 将组件对象深度 reactive 化\n  // 导致 \"Component that was made a reactive object\" 警告\n  const RecycleScroller = shallowRef(null) as Ref<Component | null>;\n  const loadFailed = ref(false);\n\n  const shouldVirtualize = computed(\n    () => useVirtual.value && !!RecycleScroller.value\n  );\n\n  // 不兼容场景检测（dev only）—— 仅在 useVirtual=true 时触发\n  const checkCompat = () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    const a = attrsRef() || {};\n    if (a['span-method'] || a.spanMethod) {\n      warnOnce(\n        'XTable:virtualScroll:spanMethod',\n        '[XTable] 虚拟滚动模式下 span-method 不可用，合并行/列将被忽略'\n      );\n    }\n    if (a['tree-props'] || a.treeProps) {\n      warnOnce(\n        'XTable:virtualScroll:treeProps',\n        '[XTable] 虚拟滚动模式下 tree-props 不可用，请使用平铺数据'\n      );\n    }\n    // 检测固定列：通过判断列配置中是否含 fixed（由主组件在调用时传入）\n    // 此处仅检测 attrs 上的 default-sort 等无关属性即可，固定列在 columns 渲染处再 warn\n  };\n\n  // 启动加载（异步，不阻塞渲染）\n  const ensureLoaded = async () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    if (RecycleScroller.value || loadFailed.value) {\n      return;\n    }\n    const mod = await loadVirtualScroller();\n    if (mod) {\n      RecycleScroller.value = mod.RecycleScroller as Component;\n    } else {\n      loadFailed.value = true;\n    }\n  };\n\n  const itemSize = computed(\n    () => virtualItemHeight.value || DEFAULT_VIRTUAL_ITEM_HEIGHT\n  );\n  const bufferSize = computed(\n    () => virtualShowSize.value || DEFAULT_VIRTUAL_SHOW_SIZE\n  );\n\n  return {\n    shouldVirtualize,\n    RecycleScroller,\n    loadFailed,\n    itemSize,\n    bufferSize,\n    ensureLoaded,\n    checkCompat\n  };\n}\n\n// @internal 测试用：重置模块级缓存\nexport function _resetVirtualScrollerCache(): void {\n  _scrollerCache = null;\n  _scrollerLoaded = false;\n  _scrollerFailed = false;\n}\n"],"names":["_scrollerCache","_scrollerLoaded","_scrollerFailed","loadVirtualScroller","__async","this","mod","import","RecycleScroller","_a","default","warnOnce","e","useVirtual","virtualShowSize","virtualItemHeight","attrsRef","shallowRef","loadFailed","ref","shouldVirtualize","computed","value","itemSize","DEFAULT_VIRTUAL_ITEM_HEIGHT","bufferSize","DEFAULT_VIRTUAL_SHOW_SIZE","ensureLoaded","checkCompat","a","spanMethod","treeProps"],"mappings":"khBA4BA,IAAIA,EAAwD,KACxDC,GAAkB,EAClBC,GAAkB,EAUtB,SAAsBC,IAEZ,OAAAC,EAAAC,KAAA,KAAA,kBACR,GAAIJ,EACF,OAAOD,EAET,GAAIE,EACF,OAAO,KAET,IAEE,MAAMI,QAAiBC,OAA0B,wBAC3CC,EAAkBF,EAAIE,kBAAmB,OAAAC,EAAAH,EAAII,cAAJ,EAAAD,EAAaD,iBAC5D,OAAKA,GAQLR,EAAiB,CAAEQ,mBACnBP,GAAkB,EACXD,IATLE,GAAkB,EAClBS,EAAAA,SACE,gCACA,iEAEK,KAKX,CAAA,MAAQC,GAMN,OALAV,GAAkB,EAClBS,EAAAA,SACE,oCACA,yFAEK,IACT,CACF,EAAA,wDA0BO,SACLE,EACAC,EACAC,EACAC,GAIA,MAAMR,EAAkBS,EAAAA,WAAW,MAC7BC,EAAaC,EAAAA,KAAI,GAEjBC,EAAmBC,EAAAA,SACvB,IAAMR,EAAWS,SAAWd,EAAgBc,OAyCxCC,EAAWF,EAAAA,SACf,IAAMN,EAAkBO,OAASE,EAAAA,6BAE7BC,EAAaJ,EAAAA,SACjB,IAAMP,EAAgBQ,OAASI,EAAAA,2BAGjC,MAAO,CACLN,mBACAZ,kBACAU,aACAK,WACAE,aACAE,aA5BmB,IAAYvB,EAAA,KAAA,KAAA,YAC/B,IAAKS,EAAWS,MACd,OAEF,GAAId,EAAgBc,OAASJ,EAAWI,MACtC,OAEF,MAAMhB,QAAYH,IACdG,EACFE,EAAgBc,MAAQhB,EAAIE,gBAE5BU,EAAWI,OAAQ,CAEvB,GAgBEM,YAnDkB,KAClB,IAAKf,EAAWS,MACd,OAEF,MAAMO,EAAIb,KAAc,CAAA,GACpBa,EAAE,gBAAkBA,EAAEC,aACxBnB,EAAAA,SACE,kCACA,+CAGAkB,EAAE,eAAiBA,EAAEE,YACvBpB,EAAAA,SACE,iCACA,4CAuCR"}
+{"version":3,"file":"index211.cjs","sources":["../../src/components/XTable/useVirtualScroll.ts"],"sourcesContent":["// packages/core/src/components/XTable/useVirtualScroll.ts\n//\n// useVirtualScroll —— 虚拟滚动接入 vue-virtual-scroller（当前已禁用）\n//\n// 当前状态：虚拟滚动能力暂未开放，loadVirtualScroller() 直接返回 null。\n// 原因：CJS 构建产物中 import('vue-virtual-scroller') 会被 Rollup 转为 require()，\n// 导致宿主项目在未安装该包时编译失败。待能力正式开放时恢复动态加载逻辑。\n//\n// 设计目标（恢复后）：\n//  - 用户安装 vue-virtual-scroller 时，useVirtual=true 启用大数据量虚拟滚动\n//  - 用户未安装时，给出友好 warn 并回退到普通 ElTable 渲染（不崩溃）\n//  - 检测到不兼容场景（fixed columns / span-method / tree-props）时 dev warn\n//\n// 与 ElTable 的协作：\n//  - ElTable 自身不暴露虚拟滚动 API（TableV2 是独立组件，且 Vue2 端不可用）\n//  - 本 hook 在 useVirtual=true 时旁路 ElTable，改用 RecycleScroller 渲染行\n//  - 表头仍由 ElTable 渲染（仅渲染表头部分，不渲染 tbody），保持样式一致\n//\n// 性能要点：\n//  - vue-virtual-scroller 的 RecycleScroller 自带 itemSize + buffer 优化\n//  - 避免在循环内创建闭包（render 函数引用稳定）\n\nimport type { Component, ComputedRef, Ref } from 'vue-demi';\nimport { computed, ref, shallowRef } from 'vue-demi';\nimport { warnOnce } from '../../utils/warnOnce';\nimport {\n  DEFAULT_VIRTUAL_ITEM_HEIGHT,\n  DEFAULT_VIRTUAL_SHOW_SIZE\n} from './src/constants';\n// vue-virtual-scroller 类型桩在 ./vue-virtual-scroller.types.d.ts 中声明（optional peer）\n\n// 虚拟滚动能力暂未开放：loadVirtualScroller 直接返回 null，不执行任何动态 import。\n// 原因：CJS 构建产物中 import() 会被 Rollup 转为 require()，导致宿主项目\n// 在未安装 vue-virtual-scroller 时编译失败。待虚拟滚动能力正式开放时恢复。\n\n/**\n * 运行时动态加载 vue-virtual-scroller（当前已禁用，直接返回 null）。\n *\n * 返回值：\n *  - 成功：{ RecycleScroller }（当前始终为 null）\n *  - 失败：null（虚拟滚动能力暂未开放）\n */\nexport async function loadVirtualScroller(): Promise<{\n  RecycleScroller: Component;\n} | null> {\n  warnOnce(\n    'XTable:virtualScroll:disabled',\n    '[XTable] 虚拟滚动能力暂未开放，useVirtual 将被忽略'\n  );\n  return null;\n}\n\n/**\n * useVirtualScroll —— 虚拟滚动状态与异步加载控制。\n *\n * @param useVirtual - 是否启用虚拟滚动（响应式）\n * @param virtualShowSize - 可视区域渲染行数（响应式，默认 30）\n * @param virtualItemHeight - 预估行高 px（响应式，默认 50）\n * @param attrsRef - 用户透传给 ElTable 的 attrs（用于检测不兼容场景）\n *\n * 返回：\n *  - shouldVirtualize：最终是否启用虚拟模式（useVirtual + 加载成功）\n *  - RecycleScroller：vue-virtual-scroller 组件（响应式，加载完成后填充）\n *  - itemSize：合并后的行高\n *  - bufferSize：合并后的可视区行数\n */\nexport interface UseVirtualScrollReturn {\n  shouldVirtualize: ComputedRef<boolean>;\n  RecycleScroller: Ref<Component | null>;\n  loadFailed: Ref<boolean>;\n  itemSize: ComputedRef<number>;\n  bufferSize: ComputedRef<number>;\n  ensureLoaded: () => Promise<void>;\n  checkCompat: () => void;\n}\n\nexport function useVirtualScroll(\n  useVirtual: Ref<boolean>,\n  virtualShowSize: Ref<number>,\n  virtualItemHeight: Ref<number>,\n  attrsRef: () => Record<string, any>\n): UseVirtualScrollReturn {\n  // 使用 shallowRef 存储组件定义，避免 Vue3 将组件对象深度 reactive 化\n  // 导致 \"Component that was made a reactive object\" 警告\n  const RecycleScroller = shallowRef(null) as Ref<Component | null>;\n  const loadFailed = ref(false);\n\n  const shouldVirtualize = computed(\n    () => useVirtual.value && !!RecycleScroller.value\n  );\n\n  // 不兼容场景检测（dev only）—— 仅在 useVirtual=true 时触发\n  const checkCompat = () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    const a = attrsRef() || {};\n    if (a['span-method'] || a.spanMethod) {\n      warnOnce(\n        'XTable:virtualScroll:spanMethod',\n        '[XTable] 虚拟滚动模式下 span-method 不可用，合并行/列将被忽略'\n      );\n    }\n    if (a['tree-props'] || a.treeProps) {\n      warnOnce(\n        'XTable:virtualScroll:treeProps',\n        '[XTable] 虚拟滚动模式下 tree-props 不可用，请使用平铺数据'\n      );\n    }\n    // 检测固定列：通过判断列配置中是否含 fixed（由主组件在调用时传入）\n    // 此处仅检测 attrs 上的 default-sort 等无关属性即可，固定列在 columns 渲染处再 warn\n  };\n\n  // 启动加载（异步，不阻塞渲染）\n  const ensureLoaded = async () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    if (RecycleScroller.value || loadFailed.value) {\n      return;\n    }\n    const mod = await loadVirtualScroller();\n    if (mod) {\n      RecycleScroller.value = mod.RecycleScroller as Component;\n    } else {\n      loadFailed.value = true;\n    }\n  };\n\n  const itemSize = computed(\n    () => virtualItemHeight.value || DEFAULT_VIRTUAL_ITEM_HEIGHT\n  );\n  const bufferSize = computed(\n    () => virtualShowSize.value || DEFAULT_VIRTUAL_SHOW_SIZE\n  );\n\n  return {\n    shouldVirtualize,\n    RecycleScroller,\n    loadFailed,\n    itemSize,\n    bufferSize,\n    ensureLoaded,\n    checkCompat\n  };\n}\n\n// @internal 测试用：重置模块级缓存（虚拟滚动已禁用，此函数当前为空操作）\nexport function _resetVirtualScrollerCache(): void {\n  // no-op: 虚拟滚动禁用期间无需重置任何缓存\n}\n"],"names":["loadVirtualScroller","__async","this","warnOnce","useVirtual","virtualShowSize","virtualItemHeight","attrsRef","RecycleScroller","shallowRef","loadFailed","ref","shouldVirtualize","computed","value","itemSize","DEFAULT_VIRTUAL_ITEM_HEIGHT","bufferSize","DEFAULT_VIRTUAL_SHOW_SIZE","ensureLoaded","mod","checkCompat","a","spanMethod","treeProps"],"mappings":"6XA0CA,SAAsBA,IAEZ,OAAAC,EAAAC,KAAA,KAAA,YAKR,OAJAC,EAAAA,SACE,gCACA,uCAEK,IACT,EAAA,wDA0BO,SACLC,EACAC,EACAC,EACAC,GAIA,MAAMC,EAAkBC,EAAAA,WAAW,MAC7BC,EAAaC,EAAAA,KAAI,GAEjBC,EAAmBC,EAAAA,SACvB,IAAMT,EAAWU,SAAWN,EAAgBM,OAyCxCC,EAAWF,EAAAA,SACf,IAAMP,EAAkBQ,OAASE,EAAAA,6BAE7BC,EAAaJ,EAAAA,SACjB,IAAMR,EAAgBS,OAASI,EAAAA,2BAGjC,MAAO,CACLN,mBACAJ,kBACAE,aACAK,WACAE,aACAE,aA5BmB,IAAYlB,EAAA,KAAA,KAAA,YAC/B,IAAKG,EAAWU,MACd,OAEF,GAAIN,EAAgBM,OAASJ,EAAWI,MACtC,OAEF,MAAMM,QAAYpB,IACdoB,EACFZ,EAAgBM,MAAQM,EAAIZ,gBAE5BE,EAAWI,OAAQ,CAEvB,GAgBEO,YAnDkB,KAClB,IAAKjB,EAAWU,MACd,OAEF,MAAMQ,EAAIf,KAAc,CAAA,GACpBe,EAAE,gBAAkBA,EAAEC,aACxBpB,EAAAA,SACE,kCACA,+CAGAmB,EAAE,eAAiBA,EAAEE,YACvBrB,EAAAA,SACE,iCACA,4CAuCR"}

package/dist/vue2/index211.mjs

@@ -21,43 +21,13 @@ var __async = (__this, __arguments, generator) => {
 import { shallowRef, ref, computed } from "@vue/composition-api";
 import { warnOnce } from "./index145.mjs";
 import { DEFAULT_VIRTUAL_ITEM_HEIGHT, DEFAULT_VIRTUAL_SHOW_SIZE } from "./index234.mjs";
-let _scrollerCache = null;
-let _scrollerLoaded = false;
-let _scrollerFailed = false;
 function loadVirtualScroller() {
   return __async(this, null, function* () {
-    var _a;
-    if (_scrollerLoaded) {
-      return _scrollerCache;
-    }
-    if (_scrollerFailed) {
-      return null;
-    }
-    try {
-      const mod = yield import(
-        /* @vite-ignore */
-        "vue-virtual-scroller"
-      );
-      const RecycleScroller = mod.RecycleScroller || ((_a = mod.default) == null ? void 0 : _a.RecycleScroller);
-      if (!RecycleScroller) {
-        _scrollerFailed = true;
-        warnOnce(
-          "XTable:virtualScroll:noExport",
-          "[XTable] vue-virtual-scroller 已加载但未导出 RecycleScroller，虚拟滚动已禁用"
-        );
-        return null;
-      }
-      _scrollerCache = { RecycleScroller };
-      _scrollerLoaded = true;
-      return _scrollerCache;
-    } catch (e) {
-      _scrollerFailed = true;
-      warnOnce(
-        "XTable:virtualScroll:notInstalled",
-        "[XTable] useVirtual=true 需要安装 vue-virtual-scroller，请运行: pnpm add vue-virtual-scroller"
-      );
-      return null;
-    }
+    warnOnce(
+      "XTable:virtualScroll:disabled",
+      "[XTable] 虚拟滚动能力暂未开放，useVirtual 将被忽略"
+    );
+    return null;
   });
 }
 function useVirtualScroll(useVirtual, virtualShowSize, virtualItemHeight, attrsRef) {

package/dist/vue2/index211.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index211.mjs","sources":["../../src/components/XTable/useVirtualScroll.ts"],"sourcesContent":["// packages/core/src/components/XTable/useVirtualScroll.ts\n//\n// useVirtualScroll —— 虚拟滚动接入 vue-virtual-scroller（optional peer）\n//\n// 设计目标：\n//  - 用户安装 vue-virtual-scroller 时，useVirtual=true 启用大数据量虚拟滚动\n//  - 用户未安装时，给出友好 warn 并回退到普通 ElTable 渲染（不崩溃）\n//  - 检测到不兼容场景（fixed columns / span-method / tree-props）时 dev warn\n//\n// 与 ElTable 的协作：\n//  - ElTable 自身不暴露虚拟滚动 API（TableV2 是独立组件，且 Vue2 端不可用）\n//  - 本 hook 在 useVirtual=true 时旁路 ElTable，改用 RecycleScroller 渲染行\n//  - 表头仍由 ElTable 渲染（仅渲染表头部分，不渲染 tbody），保持样式一致\n//\n// 性能要点：\n//  - vue-virtual-scroller 的 RecycleScroller 自带 itemSize + buffer 优化\n//  - 避免在循环内创建闭包（render 函数引用稳定）\n\nimport type { Component, ComputedRef, Ref } from 'vue-demi';\nimport { computed, ref, shallowRef } from 'vue-demi';\nimport { warnOnce } from '../../utils/warnOnce';\nimport {\n  DEFAULT_VIRTUAL_ITEM_HEIGHT,\n  DEFAULT_VIRTUAL_SHOW_SIZE\n} from './src/constants';\n// vue-virtual-scroller 类型桩在 ./vue-virtual-scroller.types.d.ts 中声明（optional peer）\n\n// 模块级缓存：避免每次启用虚拟滚动都触发 import()\nlet _scrollerCache: { RecycleScroller: Component } | null = null;\nlet _scrollerLoaded = false;\nlet _scrollerFailed = false;\n\n/**\n * 运行时动态加载 vue-virtual-scroller。\n * 失败一次后不再重试，避免反复触发网络请求或抛错。\n *\n * 返回值：\n *  - 成功：{ RecycleScroller }（vue-virtual-scroller v1.x/v2.x 都导出此命名）\n *  - 失败：null（用户未安装该 peer）\n */\nexport async function loadVirtualScroller(): Promise<{\n  RecycleScroller: Component;\n} | null> {\n  if (_scrollerLoaded) {\n    return _scrollerCache;\n  }\n  if (_scrollerFailed) {\n    return null;\n  }\n  try {\n    // @vite-ignore 注释避免 Vite 静态分析时抛 unresolved 错误（peerDep 未必装）\n    const mod: any = await import(/* @vite-ignore */ 'vue-virtual-scroller');\n    const RecycleScroller = mod.RecycleScroller || mod.default?.RecycleScroller;\n    if (!RecycleScroller) {\n      _scrollerFailed = true;\n      warnOnce(\n        'XTable:virtualScroll:noExport',\n        '[XTable] vue-virtual-scroller 已加载但未导出 RecycleScroller，虚拟滚动已禁用'\n      );\n      return null;\n    }\n    _scrollerCache = { RecycleScroller };\n    _scrollerLoaded = true;\n    return _scrollerCache;\n  } catch {\n    _scrollerFailed = true;\n    warnOnce(\n      'XTable:virtualScroll:notInstalled',\n      '[XTable] useVirtual=true 需要安装 vue-virtual-scroller，请运行: pnpm add vue-virtual-scroller'\n    );\n    return null;\n  }\n}\n\n/**\n * useVirtualScroll —— 虚拟滚动状态与异步加载控制。\n *\n * @param useVirtual - 是否启用虚拟滚动（响应式）\n * @param virtualShowSize - 可视区域渲染行数（响应式，默认 30）\n * @param virtualItemHeight - 预估行高 px（响应式，默认 50）\n * @param attrsRef - 用户透传给 ElTable 的 attrs（用于检测不兼容场景）\n *\n * 返回：\n *  - shouldVirtualize：最终是否启用虚拟模式（useVirtual + 加载成功）\n *  - RecycleScroller：vue-virtual-scroller 组件（响应式，加载完成后填充）\n *  - itemSize：合并后的行高\n *  - bufferSize：合并后的可视区行数\n */\nexport interface UseVirtualScrollReturn {\n  shouldVirtualize: ComputedRef<boolean>;\n  RecycleScroller: Ref<Component | null>;\n  loadFailed: Ref<boolean>;\n  itemSize: ComputedRef<number>;\n  bufferSize: ComputedRef<number>;\n  ensureLoaded: () => Promise<void>;\n  checkCompat: () => void;\n}\n\nexport function useVirtualScroll(\n  useVirtual: Ref<boolean>,\n  virtualShowSize: Ref<number>,\n  virtualItemHeight: Ref<number>,\n  attrsRef: () => Record<string, any>\n): UseVirtualScrollReturn {\n  // 使用 shallowRef 存储组件定义，避免 Vue3 将组件对象深度 reactive 化\n  // 导致 \"Component that was made a reactive object\" 警告\n  const RecycleScroller = shallowRef(null) as Ref<Component | null>;\n  const loadFailed = ref(false);\n\n  const shouldVirtualize = computed(\n    () => useVirtual.value && !!RecycleScroller.value\n  );\n\n  // 不兼容场景检测（dev only）—— 仅在 useVirtual=true 时触发\n  const checkCompat = () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    const a = attrsRef() || {};\n    if (a['span-method'] || a.spanMethod) {\n      warnOnce(\n        'XTable:virtualScroll:spanMethod',\n        '[XTable] 虚拟滚动模式下 span-method 不可用，合并行/列将被忽略'\n      );\n    }\n    if (a['tree-props'] || a.treeProps) {\n      warnOnce(\n        'XTable:virtualScroll:treeProps',\n        '[XTable] 虚拟滚动模式下 tree-props 不可用，请使用平铺数据'\n      );\n    }\n    // 检测固定列：通过判断列配置中是否含 fixed（由主组件在调用时传入）\n    // 此处仅检测 attrs 上的 default-sort 等无关属性即可，固定列在 columns 渲染处再 warn\n  };\n\n  // 启动加载（异步，不阻塞渲染）\n  const ensureLoaded = async () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    if (RecycleScroller.value || loadFailed.value) {\n      return;\n    }\n    const mod = await loadVirtualScroller();\n    if (mod) {\n      RecycleScroller.value = mod.RecycleScroller as Component;\n    } else {\n      loadFailed.value = true;\n    }\n  };\n\n  const itemSize = computed(\n    () => virtualItemHeight.value || DEFAULT_VIRTUAL_ITEM_HEIGHT\n  );\n  const bufferSize = computed(\n    () => virtualShowSize.value || DEFAULT_VIRTUAL_SHOW_SIZE\n  );\n\n  return {\n    shouldVirtualize,\n    RecycleScroller,\n    loadFailed,\n    itemSize,\n    bufferSize,\n    ensureLoaded,\n    checkCompat\n  };\n}\n\n// @internal 测试用：重置模块级缓存\nexport function _resetVirtualScrollerCache(): void {\n  _scrollerCache = null;\n  _scrollerLoaded = false;\n  _scrollerFailed = false;\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA4BA,IAAI,iBAAwD;AAC5D,IAAI,kBAAkB;AACtB,IAAI,kBAAkB;AAUtB,SAAsB,sBAEZ;AAAA;;AACR,QAAI,iBAAiB;AACnB,aAAO;AAAA,IACT;AACA,QAAI,iBAAiB;AACnB,aAAO;AAAA,IACT;AACA,QAAI;AAEF,YAAM,MAAW,MAAM;AAAA;AAAA,QAA0B;AAAA,MAAA;AACjD,YAAM,kBAAkB,IAAI,qBAAmB,SAAI,YAAJ,mBAAa;AAC5D,UAAI,CAAC,iBAAiB;AACpB,0BAAkB;AAClB;AAAA,UACE;AAAA,UACA;AAAA,QAAA;AAEF,eAAO;AAAA,MACT;AACA,uBAAiB,EAAE,gBAAA;AACnB,wBAAkB;AAClB,aAAO;AAAA,IACT,SAAQ;AACN,wBAAkB;AAClB;AAAA,QACE;AAAA,QACA;AAAA,MAAA;AAEF,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AA0BO,SAAS,iBACd,YACA,iBACA,mBACA,UACwB;AAGxB,QAAM,kBAAkB,WAAW,IAAI;AACvC,QAAM,aAAa,IAAI,KAAK;AAE5B,QAAM,mBAAmB;AAAA,IACvB,MAAM,WAAW,SAAS,CAAC,CAAC,gBAAgB;AAAA,EAAA;AAI9C,QAAM,cAAc,MAAM;AACxB,QAAI,CAAC,WAAW,OAAO;AACrB;AAAA,IACF;AACA,UAAM,IAAI,SAAA,KAAc,CAAA;AACxB,QAAI,EAAE,aAAa,KAAK,EAAE,YAAY;AACpC;AAAA,QACE;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AACA,QAAI,EAAE,YAAY,KAAK,EAAE,WAAW;AAClC;AAAA,QACE;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AAAA,EAGF;AAGA,QAAM,eAAe,MAAY;AAC/B,QAAI,CAAC,WAAW,OAAO;AACrB;AAAA,IACF;AACA,QAAI,gBAAgB,SAAS,WAAW,OAAO;AAC7C;AAAA,IACF;AACA,UAAM,MAAM,MAAM,oBAAA;AAClB,QAAI,KAAK;AACP,sBAAgB,QAAQ,IAAI;AAAA,IAC9B,OAAO;AACL,iBAAW,QAAQ;AAAA,IACrB;AAAA,EACF;AAEA,QAAM,WAAW;AAAA,IACf,MAAM,kBAAkB,SAAS;AAAA,EAAA;AAEnC,QAAM,aAAa;AAAA,IACjB,MAAM,gBAAgB,SAAS;AAAA,EAAA;AAGjC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"index211.mjs","sources":["../../src/components/XTable/useVirtualScroll.ts"],"sourcesContent":["// packages/core/src/components/XTable/useVirtualScroll.ts\n//\n// useVirtualScroll —— 虚拟滚动接入 vue-virtual-scroller（当前已禁用）\n//\n// 当前状态：虚拟滚动能力暂未开放，loadVirtualScroller() 直接返回 null。\n// 原因：CJS 构建产物中 import('vue-virtual-scroller') 会被 Rollup 转为 require()，\n// 导致宿主项目在未安装该包时编译失败。待能力正式开放时恢复动态加载逻辑。\n//\n// 设计目标（恢复后）：\n//  - 用户安装 vue-virtual-scroller 时，useVirtual=true 启用大数据量虚拟滚动\n//  - 用户未安装时，给出友好 warn 并回退到普通 ElTable 渲染（不崩溃）\n//  - 检测到不兼容场景（fixed columns / span-method / tree-props）时 dev warn\n//\n// 与 ElTable 的协作：\n//  - ElTable 自身不暴露虚拟滚动 API（TableV2 是独立组件，且 Vue2 端不可用）\n//  - 本 hook 在 useVirtual=true 时旁路 ElTable，改用 RecycleScroller 渲染行\n//  - 表头仍由 ElTable 渲染（仅渲染表头部分，不渲染 tbody），保持样式一致\n//\n// 性能要点：\n//  - vue-virtual-scroller 的 RecycleScroller 自带 itemSize + buffer 优化\n//  - 避免在循环内创建闭包（render 函数引用稳定）\n\nimport type { Component, ComputedRef, Ref } from 'vue-demi';\nimport { computed, ref, shallowRef } from 'vue-demi';\nimport { warnOnce } from '../../utils/warnOnce';\nimport {\n  DEFAULT_VIRTUAL_ITEM_HEIGHT,\n  DEFAULT_VIRTUAL_SHOW_SIZE\n} from './src/constants';\n// vue-virtual-scroller 类型桩在 ./vue-virtual-scroller.types.d.ts 中声明（optional peer）\n\n// 虚拟滚动能力暂未开放：loadVirtualScroller 直接返回 null，不执行任何动态 import。\n// 原因：CJS 构建产物中 import() 会被 Rollup 转为 require()，导致宿主项目\n// 在未安装 vue-virtual-scroller 时编译失败。待虚拟滚动能力正式开放时恢复。\n\n/**\n * 运行时动态加载 vue-virtual-scroller（当前已禁用，直接返回 null）。\n *\n * 返回值：\n *  - 成功：{ RecycleScroller }（当前始终为 null）\n *  - 失败：null（虚拟滚动能力暂未开放）\n */\nexport async function loadVirtualScroller(): Promise<{\n  RecycleScroller: Component;\n} | null> {\n  warnOnce(\n    'XTable:virtualScroll:disabled',\n    '[XTable] 虚拟滚动能力暂未开放，useVirtual 将被忽略'\n  );\n  return null;\n}\n\n/**\n * useVirtualScroll —— 虚拟滚动状态与异步加载控制。\n *\n * @param useVirtual - 是否启用虚拟滚动（响应式）\n * @param virtualShowSize - 可视区域渲染行数（响应式，默认 30）\n * @param virtualItemHeight - 预估行高 px（响应式，默认 50）\n * @param attrsRef - 用户透传给 ElTable 的 attrs（用于检测不兼容场景）\n *\n * 返回：\n *  - shouldVirtualize：最终是否启用虚拟模式（useVirtual + 加载成功）\n *  - RecycleScroller：vue-virtual-scroller 组件（响应式，加载完成后填充）\n *  - itemSize：合并后的行高\n *  - bufferSize：合并后的可视区行数\n */\nexport interface UseVirtualScrollReturn {\n  shouldVirtualize: ComputedRef<boolean>;\n  RecycleScroller: Ref<Component | null>;\n  loadFailed: Ref<boolean>;\n  itemSize: ComputedRef<number>;\n  bufferSize: ComputedRef<number>;\n  ensureLoaded: () => Promise<void>;\n  checkCompat: () => void;\n}\n\nexport function useVirtualScroll(\n  useVirtual: Ref<boolean>,\n  virtualShowSize: Ref<number>,\n  virtualItemHeight: Ref<number>,\n  attrsRef: () => Record<string, any>\n): UseVirtualScrollReturn {\n  // 使用 shallowRef 存储组件定义，避免 Vue3 将组件对象深度 reactive 化\n  // 导致 \"Component that was made a reactive object\" 警告\n  const RecycleScroller = shallowRef(null) as Ref<Component | null>;\n  const loadFailed = ref(false);\n\n  const shouldVirtualize = computed(\n    () => useVirtual.value && !!RecycleScroller.value\n  );\n\n  // 不兼容场景检测（dev only）—— 仅在 useVirtual=true 时触发\n  const checkCompat = () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    const a = attrsRef() || {};\n    if (a['span-method'] || a.spanMethod) {\n      warnOnce(\n        'XTable:virtualScroll:spanMethod',\n        '[XTable] 虚拟滚动模式下 span-method 不可用，合并行/列将被忽略'\n      );\n    }\n    if (a['tree-props'] || a.treeProps) {\n      warnOnce(\n        'XTable:virtualScroll:treeProps',\n        '[XTable] 虚拟滚动模式下 tree-props 不可用，请使用平铺数据'\n      );\n    }\n    // 检测固定列：通过判断列配置中是否含 fixed（由主组件在调用时传入）\n    // 此处仅检测 attrs 上的 default-sort 等无关属性即可，固定列在 columns 渲染处再 warn\n  };\n\n  // 启动加载（异步，不阻塞渲染）\n  const ensureLoaded = async () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    if (RecycleScroller.value || loadFailed.value) {\n      return;\n    }\n    const mod = await loadVirtualScroller();\n    if (mod) {\n      RecycleScroller.value = mod.RecycleScroller as Component;\n    } else {\n      loadFailed.value = true;\n    }\n  };\n\n  const itemSize = computed(\n    () => virtualItemHeight.value || DEFAULT_VIRTUAL_ITEM_HEIGHT\n  );\n  const bufferSize = computed(\n    () => virtualShowSize.value || DEFAULT_VIRTUAL_SHOW_SIZE\n  );\n\n  return {\n    shouldVirtualize,\n    RecycleScroller,\n    loadFailed,\n    itemSize,\n    bufferSize,\n    ensureLoaded,\n    checkCompat\n  };\n}\n\n// @internal 测试用：重置模块级缓存（虚拟滚动已禁用，此函数当前为空操作）\nexport function _resetVirtualScrollerCache(): void {\n  // no-op: 虚拟滚动禁用期间无需重置任何缓存\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAsB,sBAEZ;AAAA;AACR;AAAA,MACE;AAAA,MACA;AAAA,IAAA;AAEF,WAAO;AAAA,EACT;AAAA;AA0BO,SAAS,iBACd,YACA,iBACA,mBACA,UACwB;AAGxB,QAAM,kBAAkB,WAAW,IAAI;AACvC,QAAM,aAAa,IAAI,KAAK;AAE5B,QAAM,mBAAmB;AAAA,IACvB,MAAM,WAAW,SAAS,CAAC,CAAC,gBAAgB;AAAA,EAAA;AAI9C,QAAM,cAAc,MAAM;AACxB,QAAI,CAAC,WAAW,OAAO;AACrB;AAAA,IACF;AACA,UAAM,IAAI,SAAA,KAAc,CAAA;AACxB,QAAI,EAAE,aAAa,KAAK,EAAE,YAAY;AACpC;AAAA,QACE;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AACA,QAAI,EAAE,YAAY,KAAK,EAAE,WAAW;AAClC;AAAA,QACE;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AAAA,EAGF;AAGA,QAAM,eAAe,MAAY;AAC/B,QAAI,CAAC,WAAW,OAAO;AACrB;AAAA,IACF;AACA,QAAI,gBAAgB,SAAS,WAAW,OAAO;AAC7C;AAAA,IACF;AACA,UAAM,MAAM,MAAM,oBAAA;AAClB,QAAI,KAAK;AACP,sBAAgB,QAAQ,IAAI;AAAA,IAC9B,OAAO;AACL,iBAAW,QAAQ;AAAA,IACrB;AAAA,EACF;AAEA,QAAM,WAAW;AAAA,IACf,MAAM,kBAAkB,SAAS;AAAA,EAAA;AAEnC,QAAM,aAAa;AAAA,IACjB,MAAM,gBAAgB,SAAS;AAAA,EAAA;AAGjC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;"}

package/dist/vue3/index212.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.create,Object.defineProperty,Object.getOwnPropertyDescriptor,Object.getOwnPropertyNames,Object.getPrototypeOf,Object.prototype.hasOwnProperty;Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("vue-demi"),r=require("./index147.cjs"),l=require("./index234.cjs");let t=null,c=!1,o=!1;async function a(){if(c)return t;if(o)return null;try{const e=await import("vue-virtual-scroller"),l=e.RecycleScroller||e.default?.RecycleScroller;return l?(t={RecycleScroller:l},c=!0,t):(o=!0,r.warnOnce("XTable:virtualScroll:noExport","[XTable] vue-virtual-scroller 已加载但未导出 RecycleScroller，虚拟滚动已禁用"),null)}catch{return o=!0,r.warnOnce("XTable:virtualScroll:notInstalled","[XTable] useVirtual=true 需要安装 vue-virtual-scroller，请运行: pnpm add vue-virtual-scroller"),null}}exports.loadVirtualScroller=a,exports.useVirtualScroll=function(t,c,o,u){const n=e.shallowRef(null),i=e.ref(!1),s=e.computed(()=>t.value&&!!n.value),p=e.computed(()=>o.value||l.DEFAULT_VIRTUAL_ITEM_HEIGHT),v=e.computed(()=>c.value||l.DEFAULT_VIRTUAL_SHOW_SIZE);return{shouldVirtualize:s,RecycleScroller:n,loadFailed:i,itemSize:p,bufferSize:v,ensureLoaded:async()=>{if(!t.value)return;if(n.value||i.value)return;const e=await a();e?n.value=e.RecycleScroller:i.value=!0},checkCompat:()=>{if(!t.value)return;const e=u()||{};(e["span-method"]||e.spanMethod)&&r.warnOnce("XTable:virtualScroll:spanMethod","[XTable] 虚拟滚动模式下 span-method 不可用，合并行/列将被忽略"),(e["tree-props"]||e.treeProps)&&r.warnOnce("XTable:virtualScroll:treeProps","[XTable] 虚拟滚动模式下 tree-props 不可用，请使用平铺数据")}}};
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("vue-demi"),r=require("./index147.cjs"),l=require("./index234.cjs");async function a(){return r.warnOnce("XTable:virtualScroll:disabled","[XTable] 虚拟滚动能力暂未开放，useVirtual 将被忽略"),null}exports.loadVirtualScroller=a,exports.useVirtualScroll=function(t,u,o,n){const c=e.shallowRef(null),i=e.ref(!1),s=e.computed(()=>t.value&&!!c.value),d=e.computed(()=>o.value||l.DEFAULT_VIRTUAL_ITEM_HEIGHT),p=e.computed(()=>u.value||l.DEFAULT_VIRTUAL_SHOW_SIZE);return{shouldVirtualize:s,RecycleScroller:c,loadFailed:i,itemSize:d,bufferSize:p,ensureLoaded:async()=>{if(!t.value)return;if(c.value||i.value)return;const e=await a();e?c.value=e.RecycleScroller:i.value=!0},checkCompat:()=>{if(!t.value)return;const e=n()||{};(e["span-method"]||e.spanMethod)&&r.warnOnce("XTable:virtualScroll:spanMethod","[XTable] 虚拟滚动模式下 span-method 不可用，合并行/列将被忽略"),(e["tree-props"]||e.treeProps)&&r.warnOnce("XTable:virtualScroll:treeProps","[XTable] 虚拟滚动模式下 tree-props 不可用，请使用平铺数据")}}};
 //# sourceMappingURL=index212.cjs.map

package/dist/vue3/index212.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index212.cjs","sources":["../../src/components/XTable/useVirtualScroll.ts"],"sourcesContent":["// packages/core/src/components/XTable/useVirtualScroll.ts\n//\n// useVirtualScroll —— 虚拟滚动接入 vue-virtual-scroller（optional peer）\n//\n// 设计目标：\n//  - 用户安装 vue-virtual-scroller 时，useVirtual=true 启用大数据量虚拟滚动\n//  - 用户未安装时，给出友好 warn 并回退到普通 ElTable 渲染（不崩溃）\n//  - 检测到不兼容场景（fixed columns / span-method / tree-props）时 dev warn\n//\n// 与 ElTable 的协作：\n//  - ElTable 自身不暴露虚拟滚动 API（TableV2 是独立组件，且 Vue2 端不可用）\n//  - 本 hook 在 useVirtual=true 时旁路 ElTable，改用 RecycleScroller 渲染行\n//  - 表头仍由 ElTable 渲染（仅渲染表头部分，不渲染 tbody），保持样式一致\n//\n// 性能要点：\n//  - vue-virtual-scroller 的 RecycleScroller 自带 itemSize + buffer 优化\n//  - 避免在循环内创建闭包（render 函数引用稳定）\n\nimport type { Component, ComputedRef, Ref } from 'vue-demi';\nimport { computed, ref, shallowRef } from 'vue-demi';\nimport { warnOnce } from '../../utils/warnOnce';\nimport {\n  DEFAULT_VIRTUAL_ITEM_HEIGHT,\n  DEFAULT_VIRTUAL_SHOW_SIZE\n} from './src/constants';\n// vue-virtual-scroller 类型桩在 ./vue-virtual-scroller.types.d.ts 中声明（optional peer）\n\n// 模块级缓存：避免每次启用虚拟滚动都触发 import()\nlet _scrollerCache: { RecycleScroller: Component } | null = null;\nlet _scrollerLoaded = false;\nlet _scrollerFailed = false;\n\n/**\n * 运行时动态加载 vue-virtual-scroller。\n * 失败一次后不再重试，避免反复触发网络请求或抛错。\n *\n * 返回值：\n *  - 成功：{ RecycleScroller }（vue-virtual-scroller v1.x/v2.x 都导出此命名）\n *  - 失败：null（用户未安装该 peer）\n */\nexport async function loadVirtualScroller(): Promise<{\n  RecycleScroller: Component;\n} | null> {\n  if (_scrollerLoaded) {\n    return _scrollerCache;\n  }\n  if (_scrollerFailed) {\n    return null;\n  }\n  try {\n    // @vite-ignore 注释避免 Vite 静态分析时抛 unresolved 错误（peerDep 未必装）\n    const mod: any = await import(/* @vite-ignore */ 'vue-virtual-scroller');\n    const RecycleScroller = mod.RecycleScroller || mod.default?.RecycleScroller;\n    if (!RecycleScroller) {\n      _scrollerFailed = true;\n      warnOnce(\n        'XTable:virtualScroll:noExport',\n        '[XTable] vue-virtual-scroller 已加载但未导出 RecycleScroller，虚拟滚动已禁用'\n      );\n      return null;\n    }\n    _scrollerCache = { RecycleScroller };\n    _scrollerLoaded = true;\n    return _scrollerCache;\n  } catch {\n    _scrollerFailed = true;\n    warnOnce(\n      'XTable:virtualScroll:notInstalled',\n      '[XTable] useVirtual=true 需要安装 vue-virtual-scroller，请运行: pnpm add vue-virtual-scroller'\n    );\n    return null;\n  }\n}\n\n/**\n * useVirtualScroll —— 虚拟滚动状态与异步加载控制。\n *\n * @param useVirtual - 是否启用虚拟滚动（响应式）\n * @param virtualShowSize - 可视区域渲染行数（响应式，默认 30）\n * @param virtualItemHeight - 预估行高 px（响应式，默认 50）\n * @param attrsRef - 用户透传给 ElTable 的 attrs（用于检测不兼容场景）\n *\n * 返回：\n *  - shouldVirtualize：最终是否启用虚拟模式（useVirtual + 加载成功）\n *  - RecycleScroller：vue-virtual-scroller 组件（响应式，加载完成后填充）\n *  - itemSize：合并后的行高\n *  - bufferSize：合并后的可视区行数\n */\nexport interface UseVirtualScrollReturn {\n  shouldVirtualize: ComputedRef<boolean>;\n  RecycleScroller: Ref<Component | null>;\n  loadFailed: Ref<boolean>;\n  itemSize: ComputedRef<number>;\n  bufferSize: ComputedRef<number>;\n  ensureLoaded: () => Promise<void>;\n  checkCompat: () => void;\n}\n\nexport function useVirtualScroll(\n  useVirtual: Ref<boolean>,\n  virtualShowSize: Ref<number>,\n  virtualItemHeight: Ref<number>,\n  attrsRef: () => Record<string, any>\n): UseVirtualScrollReturn {\n  // 使用 shallowRef 存储组件定义，避免 Vue3 将组件对象深度 reactive 化\n  // 导致 \"Component that was made a reactive object\" 警告\n  const RecycleScroller = shallowRef(null) as Ref<Component | null>;\n  const loadFailed = ref(false);\n\n  const shouldVirtualize = computed(\n    () => useVirtual.value && !!RecycleScroller.value\n  );\n\n  // 不兼容场景检测（dev only）—— 仅在 useVirtual=true 时触发\n  const checkCompat = () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    const a = attrsRef() || {};\n    if (a['span-method'] || a.spanMethod) {\n      warnOnce(\n        'XTable:virtualScroll:spanMethod',\n        '[XTable] 虚拟滚动模式下 span-method 不可用，合并行/列将被忽略'\n      );\n    }\n    if (a['tree-props'] || a.treeProps) {\n      warnOnce(\n        'XTable:virtualScroll:treeProps',\n        '[XTable] 虚拟滚动模式下 tree-props 不可用，请使用平铺数据'\n      );\n    }\n    // 检测固定列：通过判断列配置中是否含 fixed（由主组件在调用时传入）\n    // 此处仅检测 attrs 上的 default-sort 等无关属性即可，固定列在 columns 渲染处再 warn\n  };\n\n  // 启动加载（异步，不阻塞渲染）\n  const ensureLoaded = async () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    if (RecycleScroller.value || loadFailed.value) {\n      return;\n    }\n    const mod = await loadVirtualScroller();\n    if (mod) {\n      RecycleScroller.value = mod.RecycleScroller as Component;\n    } else {\n      loadFailed.value = true;\n    }\n  };\n\n  const itemSize = computed(\n    () => virtualItemHeight.value || DEFAULT_VIRTUAL_ITEM_HEIGHT\n  );\n  const bufferSize = computed(\n    () => virtualShowSize.value || DEFAULT_VIRTUAL_SHOW_SIZE\n  );\n\n  return {\n    shouldVirtualize,\n    RecycleScroller,\n    loadFailed,\n    itemSize,\n    bufferSize,\n    ensureLoaded,\n    checkCompat\n  };\n}\n\n// @internal 测试用：重置模块级缓存\nexport function _resetVirtualScrollerCache(): void {\n  _scrollerCache = null;\n  _scrollerLoaded = false;\n  _scrollerFailed = false;\n}\n"],"names":["_scrollerCache","_scrollerLoaded","_scrollerFailed","async","loadVirtualScroller","mod","import","RecycleScroller","default","warnOnce","useVirtual","virtualShowSize","virtualItemHeight","attrsRef","shallowRef","loadFailed","ref","shouldVirtualize","computed","value","itemSize","DEFAULT_VIRTUAL_ITEM_HEIGHT","bufferSize","DEFAULT_VIRTUAL_SHOW_SIZE","ensureLoaded","checkCompat","a","spanMethod","treeProps"],"mappings":"yTA4BA,IAAIA,EAAwD,KACxDC,GAAkB,EAClBC,GAAkB,EAUtBC,eAAsBC,IAGpB,GAAIH,EACF,OAAOD,EAET,GAAIE,EACF,OAAO,KAET,IAEE,MAAMG,QAAiBC,OAA0B,wBAC3CC,EAAkBF,EAAIE,iBAAmBF,EAAIG,SAASD,gBAC5D,OAAKA,GAQLP,EAAiB,CAAEO,mBACnBN,GAAkB,EACXD,IATLE,GAAkB,EAClBO,EAAAA,SACE,gCACA,iEAEK,KAKX,CAAA,MAME,OALAP,GAAkB,EAClBO,EAAAA,SACE,oCACA,yFAEK,IACT,CACF,wDA0BO,SACLC,EACAC,EACAC,EACAC,GAIA,MAAMN,EAAkBO,EAAAA,WAAW,MAC7BC,EAAaC,EAAAA,KAAI,GAEjBC,EAAmBC,EAAAA,SACvB,IAAMR,EAAWS,SAAWZ,EAAgBY,OAyCxCC,EAAWF,EAAAA,SACf,IAAMN,EAAkBO,OAASE,EAAAA,6BAE7BC,EAAaJ,EAAAA,SACjB,IAAMP,EAAgBQ,OAASI,EAAAA,2BAGjC,MAAO,CACLN,mBACAV,kBACAQ,aACAK,WACAE,aACAE,aA5BmBrB,UACnB,IAAKO,EAAWS,MACd,OAEF,GAAIZ,EAAgBY,OAASJ,EAAWI,MACtC,OAEF,MAAMd,QAAYD,IACdC,EACFE,EAAgBY,MAAQd,EAAIE,gBAE5BQ,EAAWI,OAAQ,GAkBrBM,YAnDkB,KAClB,IAAKf,EAAWS,MACd,OAEF,MAAMO,EAAIb,KAAc,CAAA,GACpBa,EAAE,gBAAkBA,EAAEC,aACxBlB,EAAAA,SACE,kCACA,+CAGAiB,EAAE,eAAiBA,EAAEE,YACvBnB,EAAAA,SACE,iCACA,4CAuCR"}
+{"version":3,"file":"index212.cjs","sources":["../../src/components/XTable/useVirtualScroll.ts"],"sourcesContent":["// packages/core/src/components/XTable/useVirtualScroll.ts\n//\n// useVirtualScroll —— 虚拟滚动接入 vue-virtual-scroller（当前已禁用）\n//\n// 当前状态：虚拟滚动能力暂未开放，loadVirtualScroller() 直接返回 null。\n// 原因：CJS 构建产物中 import('vue-virtual-scroller') 会被 Rollup 转为 require()，\n// 导致宿主项目在未安装该包时编译失败。待能力正式开放时恢复动态加载逻辑。\n//\n// 设计目标（恢复后）：\n//  - 用户安装 vue-virtual-scroller 时，useVirtual=true 启用大数据量虚拟滚动\n//  - 用户未安装时，给出友好 warn 并回退到普通 ElTable 渲染（不崩溃）\n//  - 检测到不兼容场景（fixed columns / span-method / tree-props）时 dev warn\n//\n// 与 ElTable 的协作：\n//  - ElTable 自身不暴露虚拟滚动 API（TableV2 是独立组件，且 Vue2 端不可用）\n//  - 本 hook 在 useVirtual=true 时旁路 ElTable，改用 RecycleScroller 渲染行\n//  - 表头仍由 ElTable 渲染（仅渲染表头部分，不渲染 tbody），保持样式一致\n//\n// 性能要点：\n//  - vue-virtual-scroller 的 RecycleScroller 自带 itemSize + buffer 优化\n//  - 避免在循环内创建闭包（render 函数引用稳定）\n\nimport type { Component, ComputedRef, Ref } from 'vue-demi';\nimport { computed, ref, shallowRef } from 'vue-demi';\nimport { warnOnce } from '../../utils/warnOnce';\nimport {\n  DEFAULT_VIRTUAL_ITEM_HEIGHT,\n  DEFAULT_VIRTUAL_SHOW_SIZE\n} from './src/constants';\n// vue-virtual-scroller 类型桩在 ./vue-virtual-scroller.types.d.ts 中声明（optional peer）\n\n// 虚拟滚动能力暂未开放：loadVirtualScroller 直接返回 null，不执行任何动态 import。\n// 原因：CJS 构建产物中 import() 会被 Rollup 转为 require()，导致宿主项目\n// 在未安装 vue-virtual-scroller 时编译失败。待虚拟滚动能力正式开放时恢复。\n\n/**\n * 运行时动态加载 vue-virtual-scroller（当前已禁用，直接返回 null）。\n *\n * 返回值：\n *  - 成功：{ RecycleScroller }（当前始终为 null）\n *  - 失败：null（虚拟滚动能力暂未开放）\n */\nexport async function loadVirtualScroller(): Promise<{\n  RecycleScroller: Component;\n} | null> {\n  warnOnce(\n    'XTable:virtualScroll:disabled',\n    '[XTable] 虚拟滚动能力暂未开放，useVirtual 将被忽略'\n  );\n  return null;\n}\n\n/**\n * useVirtualScroll —— 虚拟滚动状态与异步加载控制。\n *\n * @param useVirtual - 是否启用虚拟滚动（响应式）\n * @param virtualShowSize - 可视区域渲染行数（响应式，默认 30）\n * @param virtualItemHeight - 预估行高 px（响应式，默认 50）\n * @param attrsRef - 用户透传给 ElTable 的 attrs（用于检测不兼容场景）\n *\n * 返回：\n *  - shouldVirtualize：最终是否启用虚拟模式（useVirtual + 加载成功）\n *  - RecycleScroller：vue-virtual-scroller 组件（响应式，加载完成后填充）\n *  - itemSize：合并后的行高\n *  - bufferSize：合并后的可视区行数\n */\nexport interface UseVirtualScrollReturn {\n  shouldVirtualize: ComputedRef<boolean>;\n  RecycleScroller: Ref<Component | null>;\n  loadFailed: Ref<boolean>;\n  itemSize: ComputedRef<number>;\n  bufferSize: ComputedRef<number>;\n  ensureLoaded: () => Promise<void>;\n  checkCompat: () => void;\n}\n\nexport function useVirtualScroll(\n  useVirtual: Ref<boolean>,\n  virtualShowSize: Ref<number>,\n  virtualItemHeight: Ref<number>,\n  attrsRef: () => Record<string, any>\n): UseVirtualScrollReturn {\n  // 使用 shallowRef 存储组件定义，避免 Vue3 将组件对象深度 reactive 化\n  // 导致 \"Component that was made a reactive object\" 警告\n  const RecycleScroller = shallowRef(null) as Ref<Component | null>;\n  const loadFailed = ref(false);\n\n  const shouldVirtualize = computed(\n    () => useVirtual.value && !!RecycleScroller.value\n  );\n\n  // 不兼容场景检测（dev only）—— 仅在 useVirtual=true 时触发\n  const checkCompat = () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    const a = attrsRef() || {};\n    if (a['span-method'] || a.spanMethod) {\n      warnOnce(\n        'XTable:virtualScroll:spanMethod',\n        '[XTable] 虚拟滚动模式下 span-method 不可用，合并行/列将被忽略'\n      );\n    }\n    if (a['tree-props'] || a.treeProps) {\n      warnOnce(\n        'XTable:virtualScroll:treeProps',\n        '[XTable] 虚拟滚动模式下 tree-props 不可用，请使用平铺数据'\n      );\n    }\n    // 检测固定列：通过判断列配置中是否含 fixed（由主组件在调用时传入）\n    // 此处仅检测 attrs 上的 default-sort 等无关属性即可，固定列在 columns 渲染处再 warn\n  };\n\n  // 启动加载（异步，不阻塞渲染）\n  const ensureLoaded = async () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    if (RecycleScroller.value || loadFailed.value) {\n      return;\n    }\n    const mod = await loadVirtualScroller();\n    if (mod) {\n      RecycleScroller.value = mod.RecycleScroller as Component;\n    } else {\n      loadFailed.value = true;\n    }\n  };\n\n  const itemSize = computed(\n    () => virtualItemHeight.value || DEFAULT_VIRTUAL_ITEM_HEIGHT\n  );\n  const bufferSize = computed(\n    () => virtualShowSize.value || DEFAULT_VIRTUAL_SHOW_SIZE\n  );\n\n  return {\n    shouldVirtualize,\n    RecycleScroller,\n    loadFailed,\n    itemSize,\n    bufferSize,\n    ensureLoaded,\n    checkCompat\n  };\n}\n\n// @internal 测试用：重置模块级缓存（虚拟滚动已禁用，此函数当前为空操作）\nexport function _resetVirtualScrollerCache(): void {\n  // no-op: 虚拟滚动禁用期间无需重置任何缓存\n}\n"],"names":["async","loadVirtualScroller","warnOnce","useVirtual","virtualShowSize","virtualItemHeight","attrsRef","RecycleScroller","shallowRef","loadFailed","ref","shouldVirtualize","computed","value","itemSize","DEFAULT_VIRTUAL_ITEM_HEIGHT","bufferSize","DEFAULT_VIRTUAL_SHOW_SIZE","ensureLoaded","mod","checkCompat","a","spanMethod","treeProps"],"mappings":"oKA0CAA,eAAsBC,IAOpB,OAJAC,EAAAA,SACE,gCACA,uCAEK,IACT,wDA0BO,SACLC,EACAC,EACAC,EACAC,GAIA,MAAMC,EAAkBC,EAAAA,WAAW,MAC7BC,EAAaC,EAAAA,KAAI,GAEjBC,EAAmBC,EAAAA,SACvB,IAAMT,EAAWU,SAAWN,EAAgBM,OAyCxCC,EAAWF,EAAAA,SACf,IAAMP,EAAkBQ,OAASE,EAAAA,6BAE7BC,EAAaJ,EAAAA,SACjB,IAAMR,EAAgBS,OAASI,EAAAA,2BAGjC,MAAO,CACLN,mBACAJ,kBACAE,aACAK,WACAE,aACAE,aA5BmBlB,UACnB,IAAKG,EAAWU,MACd,OAEF,GAAIN,EAAgBM,OAASJ,EAAWI,MACtC,OAEF,MAAMM,QAAYlB,IACdkB,EACFZ,EAAgBM,MAAQM,EAAIZ,gBAE5BE,EAAWI,OAAQ,GAkBrBO,YAnDkB,KAClB,IAAKjB,EAAWU,MACd,OAEF,MAAMQ,EAAIf,KAAc,CAAA,GACpBe,EAAE,gBAAkBA,EAAEC,aACxBpB,EAAAA,SACE,kCACA,+CAGAmB,EAAE,eAAiBA,EAAEE,YACvBrB,EAAAA,SACE,iCACA,4CAuCR"}

package/dist/vue3/index212.mjs

@@ -1,41 +1,12 @@
 import { shallowRef, ref, computed } from "vue-demi";
 import { warnOnce } from "./index147.mjs";
 import { DEFAULT_VIRTUAL_ITEM_HEIGHT, DEFAULT_VIRTUAL_SHOW_SIZE } from "./index234.mjs";
-let _scrollerCache = null;
-let _scrollerLoaded = false;
-let _scrollerFailed = false;
 async function loadVirtualScroller() {
-  if (_scrollerLoaded) {
-    return _scrollerCache;
-  }
-  if (_scrollerFailed) {
-    return null;
-  }
-  try {
-    const mod = await import(
-      /* @vite-ignore */
-      "vue-virtual-scroller"
-    );
-    const RecycleScroller = mod.RecycleScroller || mod.default?.RecycleScroller;
-    if (!RecycleScroller) {
-      _scrollerFailed = true;
-      warnOnce(
-        "XTable:virtualScroll:noExport",
-        "[XTable] vue-virtual-scroller 已加载但未导出 RecycleScroller，虚拟滚动已禁用"
-      );
-      return null;
-    }
-    _scrollerCache = { RecycleScroller };
-    _scrollerLoaded = true;
-    return _scrollerCache;
-  } catch {
-    _scrollerFailed = true;
-    warnOnce(
-      "XTable:virtualScroll:notInstalled",
-      "[XTable] useVirtual=true 需要安装 vue-virtual-scroller，请运行: pnpm add vue-virtual-scroller"
-    );
-    return null;
-  }
+  warnOnce(
+    "XTable:virtualScroll:disabled",
+    "[XTable] 虚拟滚动能力暂未开放，useVirtual 将被忽略"
+  );
+  return null;
 }
 function useVirtualScroll(useVirtual, virtualShowSize, virtualItemHeight, attrsRef) {
   const RecycleScroller = shallowRef(null);

package/dist/vue3/index212.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index212.mjs","sources":["../../src/components/XTable/useVirtualScroll.ts"],"sourcesContent":["// packages/core/src/components/XTable/useVirtualScroll.ts\n//\n// useVirtualScroll —— 虚拟滚动接入 vue-virtual-scroller（optional peer）\n//\n// 设计目标：\n//  - 用户安装 vue-virtual-scroller 时，useVirtual=true 启用大数据量虚拟滚动\n//  - 用户未安装时，给出友好 warn 并回退到普通 ElTable 渲染（不崩溃）\n//  - 检测到不兼容场景（fixed columns / span-method / tree-props）时 dev warn\n//\n// 与 ElTable 的协作：\n//  - ElTable 自身不暴露虚拟滚动 API（TableV2 是独立组件，且 Vue2 端不可用）\n//  - 本 hook 在 useVirtual=true 时旁路 ElTable，改用 RecycleScroller 渲染行\n//  - 表头仍由 ElTable 渲染（仅渲染表头部分，不渲染 tbody），保持样式一致\n//\n// 性能要点：\n//  - vue-virtual-scroller 的 RecycleScroller 自带 itemSize + buffer 优化\n//  - 避免在循环内创建闭包（render 函数引用稳定）\n\nimport type { Component, ComputedRef, Ref } from 'vue-demi';\nimport { computed, ref, shallowRef } from 'vue-demi';\nimport { warnOnce } from '../../utils/warnOnce';\nimport {\n  DEFAULT_VIRTUAL_ITEM_HEIGHT,\n  DEFAULT_VIRTUAL_SHOW_SIZE\n} from './src/constants';\n// vue-virtual-scroller 类型桩在 ./vue-virtual-scroller.types.d.ts 中声明（optional peer）\n\n// 模块级缓存：避免每次启用虚拟滚动都触发 import()\nlet _scrollerCache: { RecycleScroller: Component } | null = null;\nlet _scrollerLoaded = false;\nlet _scrollerFailed = false;\n\n/**\n * 运行时动态加载 vue-virtual-scroller。\n * 失败一次后不再重试，避免反复触发网络请求或抛错。\n *\n * 返回值：\n *  - 成功：{ RecycleScroller }（vue-virtual-scroller v1.x/v2.x 都导出此命名）\n *  - 失败：null（用户未安装该 peer）\n */\nexport async function loadVirtualScroller(): Promise<{\n  RecycleScroller: Component;\n} | null> {\n  if (_scrollerLoaded) {\n    return _scrollerCache;\n  }\n  if (_scrollerFailed) {\n    return null;\n  }\n  try {\n    // @vite-ignore 注释避免 Vite 静态分析时抛 unresolved 错误（peerDep 未必装）\n    const mod: any = await import(/* @vite-ignore */ 'vue-virtual-scroller');\n    const RecycleScroller = mod.RecycleScroller || mod.default?.RecycleScroller;\n    if (!RecycleScroller) {\n      _scrollerFailed = true;\n      warnOnce(\n        'XTable:virtualScroll:noExport',\n        '[XTable] vue-virtual-scroller 已加载但未导出 RecycleScroller，虚拟滚动已禁用'\n      );\n      return null;\n    }\n    _scrollerCache = { RecycleScroller };\n    _scrollerLoaded = true;\n    return _scrollerCache;\n  } catch {\n    _scrollerFailed = true;\n    warnOnce(\n      'XTable:virtualScroll:notInstalled',\n      '[XTable] useVirtual=true 需要安装 vue-virtual-scroller，请运行: pnpm add vue-virtual-scroller'\n    );\n    return null;\n  }\n}\n\n/**\n * useVirtualScroll —— 虚拟滚动状态与异步加载控制。\n *\n * @param useVirtual - 是否启用虚拟滚动（响应式）\n * @param virtualShowSize - 可视区域渲染行数（响应式，默认 30）\n * @param virtualItemHeight - 预估行高 px（响应式，默认 50）\n * @param attrsRef - 用户透传给 ElTable 的 attrs（用于检测不兼容场景）\n *\n * 返回：\n *  - shouldVirtualize：最终是否启用虚拟模式（useVirtual + 加载成功）\n *  - RecycleScroller：vue-virtual-scroller 组件（响应式，加载完成后填充）\n *  - itemSize：合并后的行高\n *  - bufferSize：合并后的可视区行数\n */\nexport interface UseVirtualScrollReturn {\n  shouldVirtualize: ComputedRef<boolean>;\n  RecycleScroller: Ref<Component | null>;\n  loadFailed: Ref<boolean>;\n  itemSize: ComputedRef<number>;\n  bufferSize: ComputedRef<number>;\n  ensureLoaded: () => Promise<void>;\n  checkCompat: () => void;\n}\n\nexport function useVirtualScroll(\n  useVirtual: Ref<boolean>,\n  virtualShowSize: Ref<number>,\n  virtualItemHeight: Ref<number>,\n  attrsRef: () => Record<string, any>\n): UseVirtualScrollReturn {\n  // 使用 shallowRef 存储组件定义，避免 Vue3 将组件对象深度 reactive 化\n  // 导致 \"Component that was made a reactive object\" 警告\n  const RecycleScroller = shallowRef(null) as Ref<Component | null>;\n  const loadFailed = ref(false);\n\n  const shouldVirtualize = computed(\n    () => useVirtual.value && !!RecycleScroller.value\n  );\n\n  // 不兼容场景检测（dev only）—— 仅在 useVirtual=true 时触发\n  const checkCompat = () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    const a = attrsRef() || {};\n    if (a['span-method'] || a.spanMethod) {\n      warnOnce(\n        'XTable:virtualScroll:spanMethod',\n        '[XTable] 虚拟滚动模式下 span-method 不可用，合并行/列将被忽略'\n      );\n    }\n    if (a['tree-props'] || a.treeProps) {\n      warnOnce(\n        'XTable:virtualScroll:treeProps',\n        '[XTable] 虚拟滚动模式下 tree-props 不可用，请使用平铺数据'\n      );\n    }\n    // 检测固定列：通过判断列配置中是否含 fixed（由主组件在调用时传入）\n    // 此处仅检测 attrs 上的 default-sort 等无关属性即可，固定列在 columns 渲染处再 warn\n  };\n\n  // 启动加载（异步，不阻塞渲染）\n  const ensureLoaded = async () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    if (RecycleScroller.value || loadFailed.value) {\n      return;\n    }\n    const mod = await loadVirtualScroller();\n    if (mod) {\n      RecycleScroller.value = mod.RecycleScroller as Component;\n    } else {\n      loadFailed.value = true;\n    }\n  };\n\n  const itemSize = computed(\n    () => virtualItemHeight.value || DEFAULT_VIRTUAL_ITEM_HEIGHT\n  );\n  const bufferSize = computed(\n    () => virtualShowSize.value || DEFAULT_VIRTUAL_SHOW_SIZE\n  );\n\n  return {\n    shouldVirtualize,\n    RecycleScroller,\n    loadFailed,\n    itemSize,\n    bufferSize,\n    ensureLoaded,\n    checkCompat\n  };\n}\n\n// @internal 测试用：重置模块级缓存\nexport function _resetVirtualScrollerCache(): void {\n  _scrollerCache = null;\n  _scrollerLoaded = false;\n  _scrollerFailed = false;\n}\n"],"names":[],"mappings":";;;AA4BA,IAAI,iBAAwD;AAC5D,IAAI,kBAAkB;AACtB,IAAI,kBAAkB;AAUtB,eAAsB,sBAEZ;AACR,MAAI,iBAAiB;AACnB,WAAO;AAAA,EACT;AACA,MAAI,iBAAiB;AACnB,WAAO;AAAA,EACT;AACA,MAAI;AAEF,UAAM,MAAW,MAAM;AAAA;AAAA,MAA0B;AAAA,IAAA;AACjD,UAAM,kBAAkB,IAAI,mBAAmB,IAAI,SAAS;AAC5D,QAAI,CAAC,iBAAiB;AACpB,wBAAkB;AAClB;AAAA,QACE;AAAA,QACA;AAAA,MAAA;AAEF,aAAO;AAAA,IACT;AACA,qBAAiB,EAAE,gBAAA;AACnB,sBAAkB;AAClB,WAAO;AAAA,EACT,QAAQ;AACN,sBAAkB;AAClB;AAAA,MACE;AAAA,MACA;AAAA,IAAA;AAEF,WAAO;AAAA,EACT;AACF;AA0BO,SAAS,iBACd,YACA,iBACA,mBACA,UACwB;AAGxB,QAAM,kBAAkB,WAAW,IAAI;AACvC,QAAM,aAAa,IAAI,KAAK;AAE5B,QAAM,mBAAmB;AAAA,IACvB,MAAM,WAAW,SAAS,CAAC,CAAC,gBAAgB;AAAA,EAAA;AAI9C,QAAM,cAAc,MAAM;AACxB,QAAI,CAAC,WAAW,OAAO;AACrB;AAAA,IACF;AACA,UAAM,IAAI,SAAA,KAAc,CAAA;AACxB,QAAI,EAAE,aAAa,KAAK,EAAE,YAAY;AACpC;AAAA,QACE;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AACA,QAAI,EAAE,YAAY,KAAK,EAAE,WAAW;AAClC;AAAA,QACE;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AAAA,EAGF;AAGA,QAAM,eAAe,YAAY;AAC/B,QAAI,CAAC,WAAW,OAAO;AACrB;AAAA,IACF;AACA,QAAI,gBAAgB,SAAS,WAAW,OAAO;AAC7C;AAAA,IACF;AACA,UAAM,MAAM,MAAM,oBAAA;AAClB,QAAI,KAAK;AACP,sBAAgB,QAAQ,IAAI;AAAA,IAC9B,OAAO;AACL,iBAAW,QAAQ;AAAA,IACrB;AAAA,EACF;AAEA,QAAM,WAAW;AAAA,IACf,MAAM,kBAAkB,SAAS;AAAA,EAAA;AAEnC,QAAM,aAAa;AAAA,IACjB,MAAM,gBAAgB,SAAS;AAAA,EAAA;AAGjC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"index212.mjs","sources":["../../src/components/XTable/useVirtualScroll.ts"],"sourcesContent":["// packages/core/src/components/XTable/useVirtualScroll.ts\n//\n// useVirtualScroll —— 虚拟滚动接入 vue-virtual-scroller（当前已禁用）\n//\n// 当前状态：虚拟滚动能力暂未开放，loadVirtualScroller() 直接返回 null。\n// 原因：CJS 构建产物中 import('vue-virtual-scroller') 会被 Rollup 转为 require()，\n// 导致宿主项目在未安装该包时编译失败。待能力正式开放时恢复动态加载逻辑。\n//\n// 设计目标（恢复后）：\n//  - 用户安装 vue-virtual-scroller 时，useVirtual=true 启用大数据量虚拟滚动\n//  - 用户未安装时，给出友好 warn 并回退到普通 ElTable 渲染（不崩溃）\n//  - 检测到不兼容场景（fixed columns / span-method / tree-props）时 dev warn\n//\n// 与 ElTable 的协作：\n//  - ElTable 自身不暴露虚拟滚动 API（TableV2 是独立组件，且 Vue2 端不可用）\n//  - 本 hook 在 useVirtual=true 时旁路 ElTable，改用 RecycleScroller 渲染行\n//  - 表头仍由 ElTable 渲染（仅渲染表头部分，不渲染 tbody），保持样式一致\n//\n// 性能要点：\n//  - vue-virtual-scroller 的 RecycleScroller 自带 itemSize + buffer 优化\n//  - 避免在循环内创建闭包（render 函数引用稳定）\n\nimport type { Component, ComputedRef, Ref } from 'vue-demi';\nimport { computed, ref, shallowRef } from 'vue-demi';\nimport { warnOnce } from '../../utils/warnOnce';\nimport {\n  DEFAULT_VIRTUAL_ITEM_HEIGHT,\n  DEFAULT_VIRTUAL_SHOW_SIZE\n} from './src/constants';\n// vue-virtual-scroller 类型桩在 ./vue-virtual-scroller.types.d.ts 中声明（optional peer）\n\n// 虚拟滚动能力暂未开放：loadVirtualScroller 直接返回 null，不执行任何动态 import。\n// 原因：CJS 构建产物中 import() 会被 Rollup 转为 require()，导致宿主项目\n// 在未安装 vue-virtual-scroller 时编译失败。待虚拟滚动能力正式开放时恢复。\n\n/**\n * 运行时动态加载 vue-virtual-scroller（当前已禁用，直接返回 null）。\n *\n * 返回值：\n *  - 成功：{ RecycleScroller }（当前始终为 null）\n *  - 失败：null（虚拟滚动能力暂未开放）\n */\nexport async function loadVirtualScroller(): Promise<{\n  RecycleScroller: Component;\n} | null> {\n  warnOnce(\n    'XTable:virtualScroll:disabled',\n    '[XTable] 虚拟滚动能力暂未开放，useVirtual 将被忽略'\n  );\n  return null;\n}\n\n/**\n * useVirtualScroll —— 虚拟滚动状态与异步加载控制。\n *\n * @param useVirtual - 是否启用虚拟滚动（响应式）\n * @param virtualShowSize - 可视区域渲染行数（响应式，默认 30）\n * @param virtualItemHeight - 预估行高 px（响应式，默认 50）\n * @param attrsRef - 用户透传给 ElTable 的 attrs（用于检测不兼容场景）\n *\n * 返回：\n *  - shouldVirtualize：最终是否启用虚拟模式（useVirtual + 加载成功）\n *  - RecycleScroller：vue-virtual-scroller 组件（响应式，加载完成后填充）\n *  - itemSize：合并后的行高\n *  - bufferSize：合并后的可视区行数\n */\nexport interface UseVirtualScrollReturn {\n  shouldVirtualize: ComputedRef<boolean>;\n  RecycleScroller: Ref<Component | null>;\n  loadFailed: Ref<boolean>;\n  itemSize: ComputedRef<number>;\n  bufferSize: ComputedRef<number>;\n  ensureLoaded: () => Promise<void>;\n  checkCompat: () => void;\n}\n\nexport function useVirtualScroll(\n  useVirtual: Ref<boolean>,\n  virtualShowSize: Ref<number>,\n  virtualItemHeight: Ref<number>,\n  attrsRef: () => Record<string, any>\n): UseVirtualScrollReturn {\n  // 使用 shallowRef 存储组件定义，避免 Vue3 将组件对象深度 reactive 化\n  // 导致 \"Component that was made a reactive object\" 警告\n  const RecycleScroller = shallowRef(null) as Ref<Component | null>;\n  const loadFailed = ref(false);\n\n  const shouldVirtualize = computed(\n    () => useVirtual.value && !!RecycleScroller.value\n  );\n\n  // 不兼容场景检测（dev only）—— 仅在 useVirtual=true 时触发\n  const checkCompat = () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    const a = attrsRef() || {};\n    if (a['span-method'] || a.spanMethod) {\n      warnOnce(\n        'XTable:virtualScroll:spanMethod',\n        '[XTable] 虚拟滚动模式下 span-method 不可用，合并行/列将被忽略'\n      );\n    }\n    if (a['tree-props'] || a.treeProps) {\n      warnOnce(\n        'XTable:virtualScroll:treeProps',\n        '[XTable] 虚拟滚动模式下 tree-props 不可用，请使用平铺数据'\n      );\n    }\n    // 检测固定列：通过判断列配置中是否含 fixed（由主组件在调用时传入）\n    // 此处仅检测 attrs 上的 default-sort 等无关属性即可，固定列在 columns 渲染处再 warn\n  };\n\n  // 启动加载（异步，不阻塞渲染）\n  const ensureLoaded = async () => {\n    if (!useVirtual.value) {\n      return;\n    }\n    if (RecycleScroller.value || loadFailed.value) {\n      return;\n    }\n    const mod = await loadVirtualScroller();\n    if (mod) {\n      RecycleScroller.value = mod.RecycleScroller as Component;\n    } else {\n      loadFailed.value = true;\n    }\n  };\n\n  const itemSize = computed(\n    () => virtualItemHeight.value || DEFAULT_VIRTUAL_ITEM_HEIGHT\n  );\n  const bufferSize = computed(\n    () => virtualShowSize.value || DEFAULT_VIRTUAL_SHOW_SIZE\n  );\n\n  return {\n    shouldVirtualize,\n    RecycleScroller,\n    loadFailed,\n    itemSize,\n    bufferSize,\n    ensureLoaded,\n    checkCompat\n  };\n}\n\n// @internal 测试用：重置模块级缓存（虚拟滚动已禁用，此函数当前为空操作）\nexport function _resetVirtualScrollerCache(): void {\n  // no-op: 虚拟滚动禁用期间无需重置任何缓存\n}\n"],"names":[],"mappings":";;;AA0CA,eAAsB,sBAEZ;AACR;AAAA,IACE;AAAA,IACA;AAAA,EAAA;AAEF,SAAO;AACT;AA0BO,SAAS,iBACd,YACA,iBACA,mBACA,UACwB;AAGxB,QAAM,kBAAkB,WAAW,IAAI;AACvC,QAAM,aAAa,IAAI,KAAK;AAE5B,QAAM,mBAAmB;AAAA,IACvB,MAAM,WAAW,SAAS,CAAC,CAAC,gBAAgB;AAAA,EAAA;AAI9C,QAAM,cAAc,MAAM;AACxB,QAAI,CAAC,WAAW,OAAO;AACrB;AAAA,IACF;AACA,UAAM,IAAI,SAAA,KAAc,CAAA;AACxB,QAAI,EAAE,aAAa,KAAK,EAAE,YAAY;AACpC;AAAA,QACE;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AACA,QAAI,EAAE,YAAY,KAAK,EAAE,WAAW;AAClC;AAAA,QACE;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AAAA,EAGF;AAGA,QAAM,eAAe,YAAY;AAC/B,QAAI,CAAC,WAAW,OAAO;AACrB;AAAA,IACF;AACA,QAAI,gBAAgB,SAAS,WAAW,OAAO;AAC7C;AAAA,IACF;AACA,UAAM,MAAM,MAAM,oBAAA;AAClB,QAAI,KAAK;AACP,sBAAgB,QAAQ,IAAI;AAAA,IAC9B,OAAO;AACL,iBAAW,QAAQ;AAAA,IACrB;AAAA,EACF;AAEA,QAAM,WAAW;AAAA,IACf,MAAM,kBAAkB,SAAS;AAAA,EAAA;AAEnC,QAAM,aAAa;AAAA,IACjB,MAAM,gBAAgB,SAAS;AAAA,EAAA;AAGjC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "x-sccba",
   "type": "module",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "license": "MIT",
   "homepage": "https://x-sccba.com",
   "repository": {
@@ -55,6 +55,7 @@
   "main": "dist/vue3/index.cjs",
   "module": "dist/vue3/index.mjs",
   "browser": "dist/vue3/index.mjs",
+  "style": "dist/vue3/style.css",
   "unpkg": "dist/umd/index.js",
   "jsdelivr": "dist/umd/index.js",
   "types": "dist/vue3/index.d.ts",
@@ -74,7 +75,9 @@
     "types/dom-speech-recognition-env.d.ts",
     "types/index.d.ts",
     "vue2.js",
-    "vue3.js"
+    "vue3.js",
+    "style.css",
+    "vue2/style.css"
   ],
   "scripts": {
     "build:es": "set NODE_OPTIONS=\"--max-old-space-size=4096\" && pnpm run generate-types && vue-tsc -b --noEmit && vite build",

package/style.css

@@ -0,0 +1,4 @@
+/* x-sccba Vue3 全量样式代理文件 */
+/* 兼容不支持 package.json exports 字段的打包工具（如 Webpack 4 / VuePress 1.x） */
+/* 现代工具（Webpack 5+ / Vite / Rollup）会优先走 exports 映射，不会进入此文件 */
+@import './dist/vue3/style.css';

package/types/components/XTable/useVirtualScroll.d.ts

@@ -1,11 +1,10 @@
 import { Component, ComputedRef, Ref } from 'vue-demi';
 /**
- * 运行时动态加载 vue-virtual-scroller。
- * 失败一次后不再重试，避免反复触发网络请求或抛错。
+ * 运行时动态加载 vue-virtual-scroller（当前已禁用，直接返回 null）。
  *
  * 返回值：
- *  - 成功：{ RecycleScroller }（vue-virtual-scroller v1.x/v2.x 都导出此命名）
- *  - 失败：null（用户未安装该 peer）
+ *  - 成功：{ RecycleScroller }（当前始终为 null）
+ *  - 失败：null（虚拟滚动能力暂未开放）
  */
 export declare function loadVirtualScroller(): Promise<{
     RecycleScroller: Component;

package/vue2/style.css

@@ -0,0 +1,4 @@
+/* x-sccba Vue2 全量样式代理文件 */
+/* 兼容不支持 package.json exports 字段的打包工具（如 Webpack 4 / VuePress 1.x） */
+/* 现代工具（Webpack 5+ / Vite / Rollup）会优先走 exports 映射，不会进入此文件 */
+@import '../dist/vue2/style.css';