x-sccba 0.1.1 → 0.2.3

package/dist/vue3/index146.mjs

@@ -0,0 +1,107 @@
+import dayjs from "./index231.mjs";
+import advancedFormat from "./index232.mjs";
+import weekOfYear from "./index233.mjs";
+import { isVue2 } from "vue-demi";
+import { warnOnce } from "./index147.mjs";
+const __isDev = globalThis.process?.env?.NODE_ENV !== "production";
+let __dayjsReady = false;
+function ensureDayjsPlugins() {
+  if (__dayjsReady) return;
+  dayjs.extend(weekOfYear);
+  dayjs.extend(advancedFormat);
+  __dayjsReady = true;
+}
+let __dayjsAvailable = null;
+function isDayjsAvailable() {
+  if (__dayjsAvailable !== null) return __dayjsAvailable;
+  try {
+    __dayjsAvailable = typeof dayjs === "function" && typeof dayjs.extend === "function";
+  } catch {
+    __dayjsAvailable = false;
+  }
+  return __dayjsAvailable;
+}
+function toDayjsFormat(fmt) {
+  if (!isVue2) return fmt;
+  return fmt.replace(/yyyy/g, "YYYY").replace(/\bdd\b/g, "DD").replace(/(?<![A-Za-z])d(?![A-Za-z])/g, "D");
+}
+const DATE_TYPE_DEFAULTS = {
+  date: "YYYY-MM-DD",
+  dates: "YYYY-MM-DD",
+  datetime: "YYYY-MM-DD HH:mm:ss",
+  week: "YYYY 第 ww 周",
+  month: "YYYY-MM",
+  months: "YYYY-MM",
+  year: "YYYY",
+  years: "YYYY",
+  daterange: "YYYY-MM-DD",
+  monthrange: "YYYY-MM",
+  datetimerange: "YYYY-MM-DD HH:mm:ss"
+};
+function formatPrimitive(value) {
+  return value == null ? "" : String(value);
+}
+function formatNumber(value, precision) {
+  if (value == null || value === "") return "";
+  if (precision != null) {
+    const num = Number(value);
+    return Number.isNaN(num) ? String(value) : num.toFixed(precision);
+  }
+  return String(value);
+}
+function formatDateValue(value, type, attrs, sep = " ~ ") {
+  if (value == null || value === "") return "";
+  ensureDayjsPlugins();
+  const valueFormat = attrs?.["value-format"];
+  const defaultFormat = DATE_TYPE_DEFAULTS[type] || DATE_TYPE_DEFAULTS.date;
+  const formatter = (v) => {
+    if (typeof v === "string") return v;
+    if (v instanceof Date) {
+      if (!isDayjsAvailable()) {
+        if (__isDev) {
+          warnOnce(
+            "textMode:dayjs-missing",
+            "[XUI] textMode 日期格式化需要 dayjs，但 dayjs 未安装。请执行 `pnpm add dayjs` 安装。"
+          );
+        }
+        return v.toLocaleDateString();
+      }
+      const fmt = valueFormat ? toDayjsFormat(valueFormat) : defaultFormat;
+      return dayjs(v).format(fmt);
+    }
+    return String(v ?? "");
+  };
+  if (Array.isArray(value) && value.length === 2 && type.includes("range")) {
+    const [start, end] = value;
+    if (start == null && end == null) return "";
+    return `${formatter(start)}${sep}${formatter(end)}`;
+  }
+  if (Array.isArray(value)) {
+    return value.map(formatter).filter(Boolean).join(", ");
+  }
+  return formatter(value);
+}
+function formatRange(value, formatter, sep = " ~ ") {
+  if (!Array.isArray(value) || value.length !== 2) return formatter(value);
+  const [start, end] = value;
+  if (start == null && end == null) return "";
+  return `${formatter(start)}${sep}${formatter(end)}`;
+}
+function formatGroupOptions(values, options, valueKey = "value", labelKey = "label", sep = ", ") {
+  if (!Array.isArray(values) || values.length === 0) return "";
+  if (!Array.isArray(options) || options.length === 0) return "";
+  const map = new Map(options.map((o) => [o[valueKey], o[labelKey]]));
+  return values.map((v) => {
+    const label = map.get(v);
+    return label != null ? String(label) : String(v ?? "");
+  }).join(sep);
+}
+export {
+  DATE_TYPE_DEFAULTS,
+  formatDateValue,
+  formatGroupOptions,
+  formatNumber,
+  formatPrimitive,
+  formatRange
+};
+//# sourceMappingURL=index146.mjs.map

package/dist/vue3/index146.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index146.mjs","sources":["../../src/utils/textMode.ts"],"sourcesContent":["import dayjs from 'dayjs';\nimport advancedFormat from 'dayjs/plugin/advancedFormat';\nimport weekOfYear from 'dayjs/plugin/weekOfYear';\nimport { isVue2 } from 'vue-demi';\n\nimport { warnOnce } from './warnOnce';\n\nconst __isDev = (globalThis as any).process?.env?.NODE_ENV !== 'production';\n\n// ===== dayjs 插件 lazy ensure =====\n// 不在模块顶层调用 dayjs.extend()——package.json sideEffects 仅含 *.css/*.scss/*.vue，\n// .ts 文件被 tree-shaking 视为无副作用，顶层 extend 调用可能被消除。\n// 改为首次使用时按需注册，保证运行时一定生效。\nlet __dayjsReady = false;\nfunction ensureDayjsPlugins(): void {\n  if (__dayjsReady) return;\n  dayjs.extend(weekOfYear);\n  dayjs.extend(advancedFormat); // ww（带前导零周数）token 由 advancedFormat 提供\n  __dayjsReady = true;\n}\n\n// dayjs 可用性检测（optional peerDependency 场景下 dayjs 可能未安装）\nlet __dayjsAvailable: boolean | null = null;\nfunction isDayjsAvailable(): boolean {\n  if (__dayjsAvailable !== null) return __dayjsAvailable;\n  try {\n    __dayjsAvailable =\n      typeof dayjs === 'function' && typeof dayjs.extend === 'function';\n  } catch {\n    __dayjsAvailable = false;\n  }\n  return __dayjsAvailable;\n}\n\n/**\n * 将 Vue2 element-ui 的 value-format token 转换为 dayjs token。\n *\n * 支持的 token 子集（element-ui 与 dayjs 一致的部分）：\n *   yyyy → YYYY，dd → DD（孤立小写 d → D）；其余 token 已与 dayjs 同名。\n *\n * 不支持的 token（element-ui 与 dayjs 语义不同，调用方需在文档中提示用户改用标准 token）：\n *   d / dd —— element-ui 中为日期数字，dayjs 中为星期（需用 D/DD）\n *   A / a —— element-ui 中为 AM/PM，dayjs 需 advancedFormat 插件且行为略有差异\n */\nfunction toDayjsFormat(fmt: string): string {\n  if (!isVue2) return fmt;\n  return fmt\n    .replace(/yyyy/g, 'YYYY')\n    .replace(/\\bdd\\b/g, 'DD')\n    .replace(/(?<![A-Za-z])d(?![A-Za-z])/g, 'D');\n}\n\n/**\n * 日期 type → dayjs 默认 format token 映射表。\n * 与 XDatePicker 内部 typeAttrsMap 的 'value-format' 值保持一致（单一数据源）。\n *\n * ⚠️ Vue2 端 element-ui 不支持 'dates' / 'months' / 'years'（element-plus 特有 type）。\n */\nexport const DATE_TYPE_DEFAULTS: Record<string, string> = {\n  date: 'YYYY-MM-DD',\n  dates: 'YYYY-MM-DD',\n  datetime: 'YYYY-MM-DD HH:mm:ss',\n  week: 'YYYY 第 ww 周',\n  month: 'YYYY-MM',\n  months: 'YYYY-MM',\n  year: 'YYYY',\n  years: 'YYYY',\n  daterange: 'YYYY-MM-DD',\n  monthrange: 'YYYY-MM',\n  datetimerange: 'YYYY-MM-DD HH:mm:ss'\n};\n\n/** 基础值格式化：直接 String() 兜底。 */\nexport function formatPrimitive(value: any): string {\n  return value == null ? '' : String(value);\n}\n\n/** 数字格式化（支持 precision 小数位数）。 */\nexport function formatNumber(value: any, precision?: number): string {\n  if (value == null || value === '') return '';\n  if (precision != null) {\n    const num = Number(value);\n    return Number.isNaN(num) ? String(value) : num.toFixed(precision);\n  }\n  return String(value);\n}\n\n/**\n * 日期类格式化（支持单值 / 范围 / 多选）。\n *\n * 格式化优先级：\n *  1. 字符串直显（value-format 生效时，DatePicker 已将值格式化为字符串）\n *  2. Date 对象 + 用户传的 value-format → dayjs 格式化\n *  3. Date 对象 + 无 value-format → 按 type 从 DATE_TYPE_DEFAULTS 取默认 token\n */\nexport function formatDateValue(\n  value: any,\n  type: string,\n  attrs?: Record<string, any>,\n  sep = ' ~ '\n): string {\n  if (value == null || value === '') return '';\n\n  ensureDayjsPlugins();\n\n  const valueFormat = attrs?.['value-format'];\n  const defaultFormat = DATE_TYPE_DEFAULTS[type] || DATE_TYPE_DEFAULTS.date;\n\n  const formatter = (v: any): string => {\n    if (typeof v === 'string') return v;\n    if (v instanceof Date) {\n      if (!isDayjsAvailable()) {\n        if (__isDev) {\n          warnOnce(\n            'textMode:dayjs-missing',\n            '[XUI] textMode 日期格式化需要 dayjs，但 dayjs 未安装。请执行 `pnpm add dayjs` 安装。'\n          );\n        }\n        return v.toLocaleDateString();\n      }\n      const fmt = valueFormat ? toDayjsFormat(valueFormat) : defaultFormat;\n      return dayjs(v).format(fmt);\n    }\n    return String(v ?? '');\n  };\n\n  // 范围类 [start, end]\n  if (Array.isArray(value) && value.length === 2 && type.includes('range')) {\n    const [start, end] = value;\n    if (start == null && end == null) return '';\n    return `${formatter(start)}${sep}${formatter(end)}`;\n  }\n\n  // 多选（dates）\n  if (Array.isArray(value)) {\n    return value.map(formatter).filter(Boolean).join(', ');\n  }\n\n  return formatter(value);\n}\n\n/** 通用范围格式化（time range / 自定义 formatter）。 */\nexport function formatRange(\n  value: any,\n  formatter: (v: any) => string,\n  sep = ' ~ '\n): string {\n  if (!Array.isArray(value) || value.length !== 2) return formatter(value);\n  const [start, end] = value;\n  if (start == null && end == null) return '';\n  return `${formatter(start)}${sep}${formatter(end)}`;\n}\n\n/**\n * Group 选项映射：value 数组 → label 拼接。\n *\n * 默认 valueKey='value' / labelKey='label' 适用于 XCheckboxGroup/XRadioGroup 裸用场景\n * （与 element-plus option 数据结构一致）。\n * XForm 配置驱动场景下，XForm 会先把 arrKey/arrLabel 映射为 { value, label }，\n * 因此 formatGroupOptions 内部始终用 'value'/'label' 匹配即可。\n */\nexport function formatGroupOptions(\n  values: any[],\n  options: Array<Record<string, any>>,\n  valueKey = 'value',\n  labelKey = 'label',\n  sep = ', '\n): string {\n  if (!Array.isArray(values) || values.length === 0) return '';\n  if (!Array.isArray(options) || options.length === 0) return '';\n\n  const map = new Map(options.map(o => [o[valueKey], o[labelKey]]));\n  return values\n    .map(v => {\n      const label = map.get(v);\n      return label != null ? String(label) : String(v ?? '');\n    })\n    .join(sep);\n}\n"],"names":[],"mappings":"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"}

package/dist/vue3/index147.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=new Set,o="production"!==globalThis.process?.env?.NODE_ENV;exports.warnOnce=function(t,n){o&&(e.has(t)||e.add(t))};
+//# sourceMappingURL=index147.cjs.map

package/dist/vue3/index147.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index147.cjs","sources":["../../src/utils/warnOnce.ts"],"sourcesContent":["/**\n * dev-only 一次性 warn 去重。\n *\n * - 同一 key 仅在首次调用时 console.warn，后续静默；\n * - 生产环境（NODE_ENV === 'production'）整体短路，不占用内存；\n * - 全局共享 Set（跨组件 key 空间统一）；为避免冲突，调用方 key 必须自带组件前缀。\n */\nconst __warned = new Set<string>();\nconst __isDev = (globalThis as any).process?.env?.NODE_ENV !== 'production';\n\nexport function warnOnce(key: string, msg: string): void {\n  if (!__isDev) return;\n  if (__warned.has(key)) return;\n  __warned.add(key);\n\n  console.warn(msg);\n}\n\n/**\n * 仅供测试隔离使用（Vitest beforeEach 调用）。\n * 命名沿用社区惯例（*ForTest 后缀），运行时仍然安全：生产环境短路不做任何事。\n */\nexport function clearWarningsForTest(): void {\n  if (__isDev) __warned.clear();\n}\n"],"names":["__warned","Set","__isDev","globalThis","process","env","NODE_ENV","key","msg","has","add"],"mappings":"gFAOA,MAAMA,MAAeC,IACfC,EAAyD,eAA9CC,WAAmBC,SAASC,KAAKC,0BAE3C,SAAkBC,EAAaC,GAC/BN,IACDF,EAASS,IAAIF,IACjBP,EAASU,IAAIH,GAGf"}

package/dist/vue3/index147.mjs

@@ -0,0 +1,12 @@
+const __warned = /* @__PURE__ */ new Set();
+const __isDev = globalThis.process?.env?.NODE_ENV !== "production";
+function warnOnce(key, msg) {
+  if (!__isDev) return;
+  if (__warned.has(key)) return;
+  __warned.add(key);
+  console.warn(msg);
+}
+export {
+  warnOnce
+};
+//# sourceMappingURL=index147.mjs.map

package/dist/vue3/index147.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index147.mjs","sources":["../../src/utils/warnOnce.ts"],"sourcesContent":["/**\n * dev-only 一次性 warn 去重。\n *\n * - 同一 key 仅在首次调用时 console.warn，后续静默；\n * - 生产环境（NODE_ENV === 'production'）整体短路，不占用内存；\n * - 全局共享 Set（跨组件 key 空间统一）；为避免冲突，调用方 key 必须自带组件前缀。\n */\nconst __warned = new Set<string>();\nconst __isDev = (globalThis as any).process?.env?.NODE_ENV !== 'production';\n\nexport function warnOnce(key: string, msg: string): void {\n  if (!__isDev) return;\n  if (__warned.has(key)) return;\n  __warned.add(key);\n\n  console.warn(msg);\n}\n\n/**\n * 仅供测试隔离使用（Vitest beforeEach 调用）。\n * 命名沿用社区惯例（*ForTest 后缀），运行时仍然安全：生产环境短路不做任何事。\n */\nexport function clearWarningsForTest(): void {\n  if (__isDev) __warned.clear();\n}\n"],"names":[],"mappings":"AAOA,MAAM,+BAAe,IAAA;AACrB,MAAM,UAAW,WAAmB,SAAS,KAAK,aAAa;AAExD,SAAS,SAAS,KAAa,KAAmB;AACvD,MAAI,CAAC,QAAS;AACd,MAAI,SAAS,IAAI,GAAG,EAAG;AACvB,WAAS,IAAI,GAAG;AAEhB,UAAQ,KAAK,GAAG;AAClB;"}

package/dist/vue3/index148.cjs

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index148.cjs.map

package/dist/vue3/index148.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index148.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/vue3/index148.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=index148.mjs.map

package/dist/vue3/index148.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index148.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/vue3/index149.cjs

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index149.cjs.map

package/dist/vue3/index149.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index149.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/vue3/index149.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=index149.mjs.map

package/dist/vue3/index149.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index149.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/vue3/index15.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./components/XButton/style.css');const e=require("vue-demi"),t=require("./index129.cjs"),i=require("./index131.cjs"),n=require("./index2.cjs");;/* empty css           */const o=require("./index119.cjs"),r=require("./index126.cjs"),a=require("./index121.cjs"),u=require("./index128.cjs"),s={time:{type:Number,default:void 0},tip:{type:String,default:void 0},placement:{type:String,default:void 0},tipProps:{type:Object,default:void 0},isDebounce:{type:Boolean,default:void 0},disabledTip:{type:String,default:void 0},asyncClick:{type:Function,default:void 0},autoLoading:{type:Boolean,default:!0},loading:{type:Boolean,default:void 0},confirm:{type:String,default:void 0}},l=["click","error","cancel"],c=["time","tip","placement","tipProps","isDebounce","disabledTip","asyncClick","autoLoading","confirm"],d=e.defineComponent({name:"XButton",inheritAttrs:!1,props:s,emits:[...l],setup(s,{attrs:l,emit:d}){const p=n.getUIComponent("Button"),f=n.getUIComponent("Tooltip"),m=a.useForwardProps(s),v=u.useOmitForwardProps(m,c),y=e.computed(()=>{const e=l.disabled;return null!=e&&!1!==e}),g=e.computed(()=>y.value?s.disabledTip??s.tip??"":s.tip??""),{loading:b,run:x}=o.useAsyncAction(e=>s.asyncClick?.(e),{autoLoading:s.autoLoading,onError:e=>d("error",e)}),C=e.computed(()=>m.value.loading??b.value),j=r.useMessageBox(),h=e.ref(!1),k=e.ref(0),q=async e=>{if(!(e=>{if(!(m.value.isDebounce??1))return!1;const t=s.time??1e3;return e-k.value<=t||(k.value=e,!1)})(Date.now())&&!h.value&&!b.value){if(s.confirm){h.value=!0;try{await j.confirm(s.confirm,"提示",{type:"warning"})}catch{return void d("cancel")}finally{h.value=!1}}if(s.asyncClick){const t=globalThis.process?.env?.NODE_ENV;"production"!==t&&l.onClick;try{await x(e)}catch{}return}d("click",e)}};return()=>{const n=i.useCompatSlots(e.getCurrentInstance()),o=i.useCompatListeners(e.getCurrentInstance()),r={...v.value,loading:C.value,...l,...o,class:["x-button",l.class].filter(Boolean),onClick:q},a={};Object.keys(n).forEach(e=>{a[e]=t=>i.renderSlot(n,e,t)});const u=t.h(p,r,a),c=g.value?t.h("span",{class:"x-button__tip-shim",style:"display:inline-block"},[u]):u;if(g.value){const i={content:g.value,placement:s.placement??"top",...s.tipProps??{}};return e.isVue3?t.h(f,i,{default:()=>c}):t.h(f,i,[c])}return c}}});exports.buttonEmits=l,exports.buttonProps=s,exports.default=d;
+//# sourceMappingURL=index15.cjs.map

package/dist/vue3/index15.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index15.cjs","sources":["../../src/components/XButton/index.tsx"],"sourcesContent":["/**\r\n * XButton —— X_UI 组件二次封装的典型样板\r\n *\r\n * 本文件可作为理解项目封装模式的入口示例，核心模式有三：\r\n *   1. 兼容层：vue-demi + compat/{h,slots,listeners} 同时适配 Vue2 / Vue3；\r\n *   2. 适配器：通过 ui-provider 运行时获取底层 UI 组件，支持 element-ui / element-plus；\r\n *   3. 属性隔离：inheritAttrs:false + useForwardProps + useOmitForwardProps，\r\n *      把「封装层自有 prop」与「需透传给底层组件的 prop / attrs / listeners」精确分离。\r\n *\r\n * 附带业务能力：点击防抖、可选 Tooltip 包裹（与封装模式关系不大，不作展开）。\r\n */\r\nimport { defineComponent, ref, computed, getCurrentInstance, isVue3, type PropType } from 'vue-demi'\r\nimport { h } from '../../compat/h'\r\nimport { useCompatSlots, useCompatListeners, renderSlot } from '../../compat/slots'\r\nimport { useForwardProps, useOmitForwardProps, useMessageBox, useAsyncAction } from '../../hooks'\r\nimport { getUIComponent } from '../../adapters/ui-provider'\r\nimport './style.scss'\r\n\r\n/**\r\n * 封装层自有 props\r\n *\r\n * 这些字段仅服务于 XButton 自身的业务（tooltip / 防抖 / 禁用态提示 / 异步 loading / 二次确认），\r\n * 大多数不会被转发到底层 el-button；特例是 `loading`（见下方注释，双重身份）。\r\n * 统一将 default 写为 undefined，是为了保留「用户是否显式传入」的状态信号，\r\n * 让消费侧用 `?? 默认值` 做兜底（对 Boolean 的 isDebounce 尤其必要，否则 Vue 会隐式补 false）。\r\n */\r\nexport const buttonProps = {\r\n  // —— 原有（保留） ——\r\n  time: { type: Number, default: undefined },\r\n  tip: { type: String, default: undefined },\r\n  placement: { type: String, default: undefined },\r\n  tipProps: { type: Object as PropType<Record<string, any>>, default: undefined },\r\n  isDebounce: { type: Boolean, default: undefined },\r\n\r\n  // —— 特性 2：禁用态提示 ——\r\n  disabledTip: { type: String, default: undefined },\r\n\r\n  // —— 特性 4：异步按钮自动 loading ——\r\n  asyncClick: {\r\n    type: Function as PropType<(e: MouseEvent) => unknown | Promise<unknown>>,\r\n    default: undefined\r\n  },\r\n  autoLoading: { type: Boolean, default: true },\r\n  /**\r\n   * P0-1：显式声明 loading 为自有 prop（default:undefined 保留“未传入”信号）。\r\n   * 关键：loading 不加入 SELF_PROP_KEYS，仍需透传给底层 el-button；\r\n   * 目的：让 useForwardProps 的末步过滤 `refProps.value[curr] !== undefined` 能读到它，\r\n   *      从而在 setup 中 finalLoading = forwarded.value.loading ?? autoLoadingRef.value 生效。\r\n   */\r\n  loading: { type: Boolean, default: undefined },\r\n\r\n  // —— 特性 6：二次确认 ——\r\n  confirm: { type: String, default: undefined }\r\n} as const\r\nexport const buttonEmits = ['click', 'error', 'cancel'] as const\r\n\r\n// 封装层专用 prop 的 key 清单：useOmitForwardProps 会据此从转发集合中剔除，\r\n// 保证底层 el-button 只收到它自己认识的属性。\r\n// 注意：loading 故意不在此列表——既要 XButton 内部读取、又要透传底层。\r\nconst SELF_PROP_KEYS = [\r\n  'time', 'tip', 'placement', 'tipProps', 'isDebounce',\r\n  'disabledTip',\r\n  'asyncClick', 'autoLoading',\r\n  'confirm'\r\n] as const\r\n\r\n// defineComponent：vue-demi 暴露的统一组件定义入口（Vue2 下走 @vue/composition-api，Vue3 下走原生），\r\n// 作用一是为 setup / props / emits 等选项提供完整 TS 类型推导，二是抹平双端的组件注册写法差异。\r\nexport default defineComponent({\r\n  name: 'XButton',\r\n  // 关闭自动继承，由组件内部显式合并 attrs，避免原生属性/监听器被重复挂到根元素。\r\n  inheritAttrs: false,\r\n  // 封装层需要处理的 prop 和 事件\r\n  props: buttonProps,\r\n  emits: [...buttonEmits],\r\n\r\n  // setup：组合式 API 的组件入口，本组件所有逻辑（属性隔离、防抖、渲染）都收敛在这里。\r\n  //   props —— 经过 props 选项校验/默认值处理后的响应式只读对象（即 buttonProps 中声明的字段）；\r\n  //   attrs —— 未在 props 中声明的「透传属性 + 原生监听器」，因 inheritAttrs:false 关闭了自动继承，\r\n  //            需要在渲染时由我们自行合并到底层 el-button 上；\r\n  //   emit  —— 触发 emits 中声明事件的函数，这里仅用于向外抛出 'click'。\r\n  // 返回值是一个渲染函数（见下方 return () => h(...)），等价于 Vue3 的 setup 渲染函数写法。\r\n  setup(props, { attrs, emit }) {\r\n    // 通过适配器拿到底层组件，运行时对应 element-ui 或 element-plus\r\n    const ElButton = getUIComponent('Button')\r\n    const ElTooltip = getUIComponent('Tooltip')\r\n\r\n    // 属性隔离两步走：\r\n    //   forwarded    —— 用户显式传入的全部 prop\r\n    //   elForwarded  —— forwarded 再剔除 SELF_PROP_KEYS，即真正应转发给底层 el-button 的 prop\r\n    const forwarded = useForwardProps(props)\r\n    const elForwarded = useOmitForwardProps(forwarded, SELF_PROP_KEYS)\r\n\r\n    // ========== 特性 2：禁用态提示 ==========\r\n    // 注意：`disabled` 未在 buttonProps 中声明，是通过 inheritAttrs:false + attrs 透传给 el-button 的；\r\n    // 故从 attrs 读取（useForwardProps 仅返回已声明 prop，forwarded 上无 disabled）。\r\n    // 语义对齐 HTML：undefined / null / false 视为未禁用，其余（包括空串 / true）视为禁用。\r\n    const isDisabled = computed(() => {\r\n      const v = (attrs as any).disabled\r\n      return v !== undefined && v !== null && v !== false\r\n    })\r\n    const activeTip = computed(() =>\r\n      isDisabled.value\r\n        ? (props.disabledTip ?? props.tip ?? '')\r\n        : (props.tip ?? '')\r\n    )\r\n\r\n    // ========== 特性 4：异步按钮自动 loading ==========\r\n    // 把 asyncClick 包进 useAsyncAction；hook 内部承担并发自锁\r\n    const { loading: autoLoadingRef, run: runAsync } = useAsyncAction(\r\n      (e: MouseEvent) => props.asyncClick?.(e),\r\n      {\r\n        autoLoading: props.autoLoading,\r\n        onError: (err) => emit('error', err)\r\n      }\r\n    )\r\n    // 最终 loading：父级显式传入优先，否则取 hook 的自动 loading\r\n    const finalLoading = computed(\r\n      () => forwarded.value.loading ?? autoLoadingRef.value\r\n    )\r\n\r\n    // ========== 特性 6：二次确认 ==========\r\n    const messageBox = useMessageBox()\r\n    const confirmingRef = ref(false)\r\n\r\n    // ========== 防抖（沿用原能力） ==========\r\n    const record = ref(0)\r\n    const isDebounceBlocked = (now: number) => {\r\n      // isDebounce 默认 true；false 时完全跳过\r\n      if (!(forwarded.value.isDebounce ?? true)) return false\r\n      const gap = props.time ?? 1000\r\n      if (now - record.value <= gap) return true\r\n      record.value = now\r\n      return false\r\n    }\r\n\r\n    // ========== handleClick 主链路（顺序敏感，见方案 §5） ==========\r\n    const handleClick = async (e: MouseEvent) => {\r\n      // [1] 防抖\r\n      if (isDebounceBlocked(Date.now())) return\r\n      // [2] confirm 期并发拦截\r\n      if (confirmingRef.value) return\r\n      // [3] asyncClick 期并发兜底（hook 内部亦有自锁，此处外层快速返回）\r\n      if (autoLoadingRef.value) return\r\n\r\n      // [4] 二次确认\r\n      if (props.confirm) {\r\n        confirmingRef.value = true\r\n        try {\r\n          // 注意：useMessageBox().confirm 签名为 (message, title?, options?)\r\n          await messageBox.confirm(props.confirm, '提示', { type: 'warning' })\r\n        } catch {\r\n          emit('cancel')\r\n          return\r\n        } finally {\r\n          confirmingRef.value = false\r\n        }\r\n      }\r\n\r\n      // [5] 异步业务：走 asyncClick，不再 emit('click') 避免双触发\r\n      if (props.asyncClick) {\r\n        // @click 与 :async-click 混用时 dev 告警\r\n        // 注意：项目 tsconfig.app.json 未含 @types/node，不能直写 process.env.NODE_ENV；\r\n        //      Vite (見 vite.config.umd.ts) 已在 define 阶段将 process.env.NODE_ENV 替换为字面量，\r\n        //      用 (globalThis as any).process 既能通过 TS 检查，又能命中构建时替换。\r\n        const __NODE_ENV__ = (globalThis as any).process?.env?.NODE_ENV\r\n        if (__NODE_ENV__ !== 'production' && (attrs as any).onClick) {\r\n          // eslint-disable-next-line no-console\r\n          console.warn(\r\n            '[XButton] `@click` 与 `:async-click` 同时存在，已以 `async-click` 为准。' +\r\n            '请移除 @click 以消除此警告。'\r\n          )\r\n        }\r\n        try { await runAsync(e) } catch { /* 已通过 onError → emit('error') 暴露 */ }\r\n        return\r\n      }\r\n\r\n      // [6] 同步业务\r\n      emit('click', e)\r\n    }\r\n\r\n    return () => {\r\n      // compat 层抹平 Vue2 / Vue3 差异：\r\n      //   slots         —— 统一 $slots / $scopedSlots 与 Vue3 slots\r\n      //   listenerProps —— 把 Vue2 的 $listeners 归一成 Vue3 风格的 onXxx 形态\r\n      const slots = useCompatSlots(getCurrentInstance())\r\n      const listenerProps = useCompatListeners(getCurrentInstance())\r\n\r\n      // 合并顺序：已剔除自有 prop 的转发集合 → 注入 finalLoading（覆盖可能透传的 loading）\r\n      //           → 原生 attrs（因 inheritAttrs:false 需手动合并）\r\n      //           → 兼容层监听器 → 本组件追加的 class / onClick。\r\n      const compProps = {\r\n        ...elForwarded.value,\r\n        loading: finalLoading.value,\r\n        ...attrs,\r\n        ...listenerProps,\r\n        class: ['x-button', (attrs as any).class].filter(Boolean),\r\n        onClick: handleClick\r\n      }\r\n\r\n      // 把父级插槽统一包成 Vue3 函数型 slot，renderSlot 内部兼容 Vue2 作用域插槽调用\r\n      const slotNodes: Record<string, any> = {}\r\n      Object.keys(slots).forEach(name => {\r\n        slotNodes[name] = (scope: any) => renderSlot(slots, name, scope)\r\n      })\r\n\r\n      const button = h(ElButton, compProps, slotNodes)\r\n\r\n      // 特性 2：只要存在 tooltip 文案就始终外包 span。\r\n      //   1) disabled 态下 HTML 规范不派发 mouse 事件，必须借 span 承接；\r\n      //   2) Vue2 下 element-ui 的 el-tooltip 在 mounted 阶段把 mouseenter/mouseleave\r\n      //      绑定到 referenceElm（第一个子 VNode 对应的 DOM）。若触发器随 disabled\r\n      //      切换在 <span> 与 <button> 之间变化，Vue 会替换 DOM 而 el-tooltip 不会\r\n      //      重新订阅事件，导致切到非禁用态后 tooltip 失效。始终用 span 作为稳定触发器，\r\n      //      可彻底规避该响应式缺陷；Vue3/element-plus 侧无副作用。\r\n      const trigger = activeTip.value\r\n        ? h('span', { class: 'x-button__tip-shim', style: 'display:inline-block' }, [button])\r\n        : button\r\n\r\n      // 业务能力：有 tip 文案时外层包一层 Tooltip\r\n      //\r\n      // 【Vue2 下必须使用数组 children，而不是 { default: () => trigger }】\r\n      //\r\n      // 背景：element-ui v2 的 el-tooltip 在 render 函数内部通过 getFirstElement()\r\n      //   读取 `this.$slots.default`，取其中第一个带 `tag` 的 VNode 作为触发元素\r\n      //   （trigger）。它并不会走 `_t(\"default\")` / `$scopedSlots.default()` 访问层。\r\n      //\r\n      // 问题：若写成 `{ default: () => trigger }`，Vue2 兼容层 `compat/h.ts` 会把\r\n      //   default 函数挂到 `data.scopedSlots.default`（懒传），而 `$slots.default`\r\n      //   的回填源是 **当前 XButton wrapper 自身的 $slots.default**（即父级模板塞进来\r\n      //   的文本节点，如 \"上方提示\"）。这些文本 VNode 不带 tag，getFirstElement()\r\n      //   返回 null，整颗 tooltip 渲染为空 —— 表现为页面上按钮完全不显示。\r\n      //\r\n      // 方案：直接以数组 children 形式把已构造好的 `trigger` VNode 传给 el-tooltip。\r\n      //   `compat/h.ts` 对 Array.isArray(children) 的分支会直接透传给 Vue2\r\n      //   createElement，由 Vue2 将其填充到子组件的 $slots.default。这样\r\n      //   getFirstElement() 能正确取到 trigger 作 trigger，tooltip 正常挂载。\r\n      //   Vue3 分支下数组 children 也被直接识别为默认插槽内容，语义一致。\r\n      //\r\n      // 注意：该写法仅适用于\"纯 default 插槽 + 非作用域 + 单个/多个静态 VNode\" 的\r\n      //   wrap 场景。若下游组件还需要具名插槽（如 el-tooltip 的 `content` 插槽）或\r\n      //   作用域插槽，则必须回到 `{ default, xxx, ... }` 对象形式。本组件仅用到\r\n      //   el-tooltip 的 default 通道（`content` 已通过 props 传递），故适用。\r\n      if (activeTip.value) {\r\n        const tooltipProps = {\r\n          content: activeTip.value,\r\n          placement: props.placement ?? 'top',\r\n          ...(props.tipProps ?? {})\r\n        }\r\n        // 【Vue2 / Vue3 的 default slot 形式必须分发】\r\n        // Vue2 侧保持数组 children：这是 element-ui v2 的 el-tooltip 通过\r\n        //   `$slots.default[0]` 读取触发元素的刚需（上方大段历史注释已详述）。\r\n        // Vue3 侧若继续用数组 children，Vue 3.5+ 会抛出性能告警：\r\n        //   \"Non-function value encountered for default slot. Prefer function slots for better performance.\"\r\n        //   （见 runtime-core 对 RawSlots 的规范化：值型 slot 会被包成函数并静态标记，\r\n        //    消耗额外的开销，官方推荐直接传函数型 slot。）\r\n        // 因此 Vue3 改走 { default: () => trigger } 的函数插槽，Vue2 保持数组兼容写法。\r\n        return isVue3\r\n          ? h(ElTooltip, tooltipProps, { default: () => trigger })\r\n          : h(ElTooltip, tooltipProps, [trigger] as any)\r\n      }\r\n\r\n      return trigger\r\n    }\r\n  }\r\n})\r\n"],"names":["buttonProps","time","type","Number","default","undefined","tip","String","placement","tipProps","Object","isDebounce","Boolean","disabledTip","asyncClick","Function","autoLoading","loading","confirm","buttonEmits","SELF_PROP_KEYS","XButton","name","inheritAttrs","props","emits","setup","attrs","emit","ElButton","getUIComponent","ElTooltip","forwarded","useForwardProps","elForwarded","useOmitForwardProps","isDisabled","computed","v","disabled","activeTip","value","autoLoadingRef","run","runAsync","useAsyncAction","e","onError","err","finalLoading","messageBox","useMessageBox","confirmingRef","ref","record","handleClick","async","now","gap","isDebounceBlocked","Date","__NODE_ENV__","globalThis","process","env","NODE_ENV","onClick","slots","useCompatSlots","getCurrentInstance","listenerProps","useCompatListeners","compProps","class","filter","slotNodes","keys","forEach","scope","renderSlot","button","h","trigger","style","tooltipProps","content","isVue3"],"mappings":"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"}

package/dist/vue3/index15.mjs

@@ -0,0 +1,177 @@
+import { defineComponent, computed, ref, getCurrentInstance, isVue3 } from "vue-demi";
+import { h } from "./index129.mjs";
+import { useCompatSlots, useCompatListeners, renderSlot } from "./index131.mjs";
+import { getUIComponent } from "./index2.mjs";
+import './components/XButton/style.css';/* empty css          */
+import { useAsyncAction } from "./index119.mjs";
+import { useMessageBox } from "./index126.mjs";
+import { useForwardProps } from "./index121.mjs";
+import { useOmitForwardProps } from "./index128.mjs";
+const buttonProps = {
+  // —— 原有（保留） ——
+  time: {
+    type: Number,
+    default: void 0
+  },
+  tip: {
+    type: String,
+    default: void 0
+  },
+  placement: {
+    type: String,
+    default: void 0
+  },
+  tipProps: {
+    type: Object,
+    default: void 0
+  },
+  isDebounce: {
+    type: Boolean,
+    default: void 0
+  },
+  // —— 特性 2：禁用态提示 ——
+  disabledTip: {
+    type: String,
+    default: void 0
+  },
+  // —— 特性 4：异步按钮自动 loading ——
+  asyncClick: {
+    type: Function,
+    default: void 0
+  },
+  autoLoading: {
+    type: Boolean,
+    default: true
+  },
+  /**
+   * P0-1：显式声明 loading 为自有 prop（default:undefined 保留“未传入”信号）。
+   * 关键：loading 不加入 SELF_PROP_KEYS，仍需透传给底层 el-button；
+   * 目的：让 useForwardProps 的末步过滤 `refProps.value[curr] !== undefined` 能读到它，
+   *      从而在 setup 中 finalLoading = forwarded.value.loading ?? autoLoadingRef.value 生效。
+   */
+  loading: {
+    type: Boolean,
+    default: void 0
+  },
+  // —— 特性 6：二次确认 ——
+  confirm: {
+    type: String,
+    default: void 0
+  }
+};
+const buttonEmits = ["click", "error", "cancel"];
+const SELF_PROP_KEYS = ["time", "tip", "placement", "tipProps", "isDebounce", "disabledTip", "asyncClick", "autoLoading", "confirm"];
+const XButton = /* @__PURE__ */ defineComponent({
+  name: "XButton",
+  // 关闭自动继承，由组件内部显式合并 attrs，避免原生属性/监听器被重复挂到根元素。
+  inheritAttrs: false,
+  // 封装层需要处理的 prop 和 事件
+  props: buttonProps,
+  emits: [...buttonEmits],
+  // setup：组合式 API 的组件入口，本组件所有逻辑（属性隔离、防抖、渲染）都收敛在这里。
+  //   props —— 经过 props 选项校验/默认值处理后的响应式只读对象（即 buttonProps 中声明的字段）；
+  //   attrs —— 未在 props 中声明的「透传属性 + 原生监听器」，因 inheritAttrs:false 关闭了自动继承，
+  //            需要在渲染时由我们自行合并到底层 el-button 上；
+  //   emit  —— 触发 emits 中声明事件的函数，这里仅用于向外抛出 'click'。
+  // 返回值是一个渲染函数（见下方 return () => h(...)），等价于 Vue3 的 setup 渲染函数写法。
+  setup(props, {
+    attrs,
+    emit
+  }) {
+    const ElButton = getUIComponent("Button");
+    const ElTooltip = getUIComponent("Tooltip");
+    const forwarded = useForwardProps(props);
+    const elForwarded = useOmitForwardProps(forwarded, SELF_PROP_KEYS);
+    const isDisabled = computed(() => {
+      const v = attrs.disabled;
+      return v !== void 0 && v !== null && v !== false;
+    });
+    const activeTip = computed(() => isDisabled.value ? props.disabledTip ?? props.tip ?? "" : props.tip ?? "");
+    const {
+      loading: autoLoadingRef,
+      run: runAsync
+    } = useAsyncAction((e) => props.asyncClick?.(e), {
+      autoLoading: props.autoLoading,
+      onError: (err) => emit("error", err)
+    });
+    const finalLoading = computed(() => forwarded.value.loading ?? autoLoadingRef.value);
+    const messageBox = useMessageBox();
+    const confirmingRef = ref(false);
+    const record = ref(0);
+    const isDebounceBlocked = (now) => {
+      if (!(forwarded.value.isDebounce ?? true)) return false;
+      const gap = props.time ?? 1e3;
+      if (now - record.value <= gap) return true;
+      record.value = now;
+      return false;
+    };
+    const handleClick = async (e) => {
+      if (isDebounceBlocked(Date.now())) return;
+      if (confirmingRef.value) return;
+      if (autoLoadingRef.value) return;
+      if (props.confirm) {
+        confirmingRef.value = true;
+        try {
+          await messageBox.confirm(props.confirm, "提示", {
+            type: "warning"
+          });
+        } catch {
+          emit("cancel");
+          return;
+        } finally {
+          confirmingRef.value = false;
+        }
+      }
+      if (props.asyncClick) {
+        const __NODE_ENV__ = globalThis.process?.env?.NODE_ENV;
+        if (__NODE_ENV__ !== "production" && attrs.onClick) {
+          console.warn("[XButton] `@click` 与 `:async-click` 同时存在，已以 `async-click` 为准。请移除 @click 以消除此警告。");
+        }
+        try {
+          await runAsync(e);
+        } catch {
+        }
+        return;
+      }
+      emit("click", e);
+    };
+    return () => {
+      const slots = useCompatSlots(getCurrentInstance());
+      const listenerProps = useCompatListeners(getCurrentInstance());
+      const compProps = {
+        ...elForwarded.value,
+        loading: finalLoading.value,
+        ...attrs,
+        ...listenerProps,
+        class: ["x-button", attrs.class].filter(Boolean),
+        onClick: handleClick
+      };
+      const slotNodes = {};
+      Object.keys(slots).forEach((name) => {
+        slotNodes[name] = (scope) => renderSlot(slots, name, scope);
+      });
+      const button = h(ElButton, compProps, slotNodes);
+      const trigger = activeTip.value ? h("span", {
+        class: "x-button__tip-shim",
+        style: "display:inline-block"
+      }, [button]) : button;
+      if (activeTip.value) {
+        const tooltipProps = {
+          content: activeTip.value,
+          placement: props.placement ?? "top",
+          ...props.tipProps ?? {}
+        };
+        return isVue3 ? h(ElTooltip, tooltipProps, {
+          default: () => trigger
+        }) : h(ElTooltip, tooltipProps, [trigger]);
+      }
+      return trigger;
+    };
+  }
+});
+export {
+  buttonEmits,
+  buttonProps,
+  XButton as default
+};
+//# sourceMappingURL=index15.mjs.map

package/dist/vue3/index15.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index15.mjs","sources":["../../src/components/XButton/index.tsx"],"sourcesContent":["/**\r\n * XButton —— X_UI 组件二次封装的典型样板\r\n *\r\n * 本文件可作为理解项目封装模式的入口示例，核心模式有三：\r\n *   1. 兼容层：vue-demi + compat/{h,slots,listeners} 同时适配 Vue2 / Vue3；\r\n *   2. 适配器：通过 ui-provider 运行时获取底层 UI 组件，支持 element-ui / element-plus；\r\n *   3. 属性隔离：inheritAttrs:false + useForwardProps + useOmitForwardProps，\r\n *      把「封装层自有 prop」与「需透传给底层组件的 prop / attrs / listeners」精确分离。\r\n *\r\n * 附带业务能力：点击防抖、可选 Tooltip 包裹（与封装模式关系不大，不作展开）。\r\n */\r\nimport { defineComponent, ref, computed, getCurrentInstance, isVue3, type PropType } from 'vue-demi'\r\nimport { h } from '../../compat/h'\r\nimport { useCompatSlots, useCompatListeners, renderSlot } from '../../compat/slots'\r\nimport { useForwardProps, useOmitForwardProps, useMessageBox, useAsyncAction } from '../../hooks'\r\nimport { getUIComponent } from '../../adapters/ui-provider'\r\nimport './style.scss'\r\n\r\n/**\r\n * 封装层自有 props\r\n *\r\n * 这些字段仅服务于 XButton 自身的业务（tooltip / 防抖 / 禁用态提示 / 异步 loading / 二次确认），\r\n * 大多数不会被转发到底层 el-button；特例是 `loading`（见下方注释，双重身份）。\r\n * 统一将 default 写为 undefined，是为了保留「用户是否显式传入」的状态信号，\r\n * 让消费侧用 `?? 默认值` 做兜底（对 Boolean 的 isDebounce 尤其必要，否则 Vue 会隐式补 false）。\r\n */\r\nexport const buttonProps = {\r\n  // —— 原有（保留） ——\r\n  time: { type: Number, default: undefined },\r\n  tip: { type: String, default: undefined },\r\n  placement: { type: String, default: undefined },\r\n  tipProps: { type: Object as PropType<Record<string, any>>, default: undefined },\r\n  isDebounce: { type: Boolean, default: undefined },\r\n\r\n  // —— 特性 2：禁用态提示 ——\r\n  disabledTip: { type: String, default: undefined },\r\n\r\n  // —— 特性 4：异步按钮自动 loading ——\r\n  asyncClick: {\r\n    type: Function as PropType<(e: MouseEvent) => unknown | Promise<unknown>>,\r\n    default: undefined\r\n  },\r\n  autoLoading: { type: Boolean, default: true },\r\n  /**\r\n   * P0-1：显式声明 loading 为自有 prop（default:undefined 保留“未传入”信号）。\r\n   * 关键：loading 不加入 SELF_PROP_KEYS，仍需透传给底层 el-button；\r\n   * 目的：让 useForwardProps 的末步过滤 `refProps.value[curr] !== undefined` 能读到它，\r\n   *      从而在 setup 中 finalLoading = forwarded.value.loading ?? autoLoadingRef.value 生效。\r\n   */\r\n  loading: { type: Boolean, default: undefined },\r\n\r\n  // —— 特性 6：二次确认 ——\r\n  confirm: { type: String, default: undefined }\r\n} as const\r\nexport const buttonEmits = ['click', 'error', 'cancel'] as const\r\n\r\n// 封装层专用 prop 的 key 清单：useOmitForwardProps 会据此从转发集合中剔除，\r\n// 保证底层 el-button 只收到它自己认识的属性。\r\n// 注意：loading 故意不在此列表——既要 XButton 内部读取、又要透传底层。\r\nconst SELF_PROP_KEYS = [\r\n  'time', 'tip', 'placement', 'tipProps', 'isDebounce',\r\n  'disabledTip',\r\n  'asyncClick', 'autoLoading',\r\n  'confirm'\r\n] as const\r\n\r\n// defineComponent：vue-demi 暴露的统一组件定义入口（Vue2 下走 @vue/composition-api，Vue3 下走原生），\r\n// 作用一是为 setup / props / emits 等选项提供完整 TS 类型推导，二是抹平双端的组件注册写法差异。\r\nexport default defineComponent({\r\n  name: 'XButton',\r\n  // 关闭自动继承，由组件内部显式合并 attrs，避免原生属性/监听器被重复挂到根元素。\r\n  inheritAttrs: false,\r\n  // 封装层需要处理的 prop 和 事件\r\n  props: buttonProps,\r\n  emits: [...buttonEmits],\r\n\r\n  // setup：组合式 API 的组件入口，本组件所有逻辑（属性隔离、防抖、渲染）都收敛在这里。\r\n  //   props —— 经过 props 选项校验/默认值处理后的响应式只读对象（即 buttonProps 中声明的字段）；\r\n  //   attrs —— 未在 props 中声明的「透传属性 + 原生监听器」，因 inheritAttrs:false 关闭了自动继承，\r\n  //            需要在渲染时由我们自行合并到底层 el-button 上；\r\n  //   emit  —— 触发 emits 中声明事件的函数，这里仅用于向外抛出 'click'。\r\n  // 返回值是一个渲染函数（见下方 return () => h(...)），等价于 Vue3 的 setup 渲染函数写法。\r\n  setup(props, { attrs, emit }) {\r\n    // 通过适配器拿到底层组件，运行时对应 element-ui 或 element-plus\r\n    const ElButton = getUIComponent('Button')\r\n    const ElTooltip = getUIComponent('Tooltip')\r\n\r\n    // 属性隔离两步走：\r\n    //   forwarded    —— 用户显式传入的全部 prop\r\n    //   elForwarded  —— forwarded 再剔除 SELF_PROP_KEYS，即真正应转发给底层 el-button 的 prop\r\n    const forwarded = useForwardProps(props)\r\n    const elForwarded = useOmitForwardProps(forwarded, SELF_PROP_KEYS)\r\n\r\n    // ========== 特性 2：禁用态提示 ==========\r\n    // 注意：`disabled` 未在 buttonProps 中声明，是通过 inheritAttrs:false + attrs 透传给 el-button 的；\r\n    // 故从 attrs 读取（useForwardProps 仅返回已声明 prop，forwarded 上无 disabled）。\r\n    // 语义对齐 HTML：undefined / null / false 视为未禁用，其余（包括空串 / true）视为禁用。\r\n    const isDisabled = computed(() => {\r\n      const v = (attrs as any).disabled\r\n      return v !== undefined && v !== null && v !== false\r\n    })\r\n    const activeTip = computed(() =>\r\n      isDisabled.value\r\n        ? (props.disabledTip ?? props.tip ?? '')\r\n        : (props.tip ?? '')\r\n    )\r\n\r\n    // ========== 特性 4：异步按钮自动 loading ==========\r\n    // 把 asyncClick 包进 useAsyncAction；hook 内部承担并发自锁\r\n    const { loading: autoLoadingRef, run: runAsync } = useAsyncAction(\r\n      (e: MouseEvent) => props.asyncClick?.(e),\r\n      {\r\n        autoLoading: props.autoLoading,\r\n        onError: (err) => emit('error', err)\r\n      }\r\n    )\r\n    // 最终 loading：父级显式传入优先，否则取 hook 的自动 loading\r\n    const finalLoading = computed(\r\n      () => forwarded.value.loading ?? autoLoadingRef.value\r\n    )\r\n\r\n    // ========== 特性 6：二次确认 ==========\r\n    const messageBox = useMessageBox()\r\n    const confirmingRef = ref(false)\r\n\r\n    // ========== 防抖（沿用原能力） ==========\r\n    const record = ref(0)\r\n    const isDebounceBlocked = (now: number) => {\r\n      // isDebounce 默认 true；false 时完全跳过\r\n      if (!(forwarded.value.isDebounce ?? true)) return false\r\n      const gap = props.time ?? 1000\r\n      if (now - record.value <= gap) return true\r\n      record.value = now\r\n      return false\r\n    }\r\n\r\n    // ========== handleClick 主链路（顺序敏感，见方案 §5） ==========\r\n    const handleClick = async (e: MouseEvent) => {\r\n      // [1] 防抖\r\n      if (isDebounceBlocked(Date.now())) return\r\n      // [2] confirm 期并发拦截\r\n      if (confirmingRef.value) return\r\n      // [3] asyncClick 期并发兜底（hook 内部亦有自锁，此处外层快速返回）\r\n      if (autoLoadingRef.value) return\r\n\r\n      // [4] 二次确认\r\n      if (props.confirm) {\r\n        confirmingRef.value = true\r\n        try {\r\n          // 注意：useMessageBox().confirm 签名为 (message, title?, options?)\r\n          await messageBox.confirm(props.confirm, '提示', { type: 'warning' })\r\n        } catch {\r\n          emit('cancel')\r\n          return\r\n        } finally {\r\n          confirmingRef.value = false\r\n        }\r\n      }\r\n\r\n      // [5] 异步业务：走 asyncClick，不再 emit('click') 避免双触发\r\n      if (props.asyncClick) {\r\n        // @click 与 :async-click 混用时 dev 告警\r\n        // 注意：项目 tsconfig.app.json 未含 @types/node，不能直写 process.env.NODE_ENV；\r\n        //      Vite (見 vite.config.umd.ts) 已在 define 阶段将 process.env.NODE_ENV 替换为字面量，\r\n        //      用 (globalThis as any).process 既能通过 TS 检查，又能命中构建时替换。\r\n        const __NODE_ENV__ = (globalThis as any).process?.env?.NODE_ENV\r\n        if (__NODE_ENV__ !== 'production' && (attrs as any).onClick) {\r\n          // eslint-disable-next-line no-console\r\n          console.warn(\r\n            '[XButton] `@click` 与 `:async-click` 同时存在，已以 `async-click` 为准。' +\r\n            '请移除 @click 以消除此警告。'\r\n          )\r\n        }\r\n        try { await runAsync(e) } catch { /* 已通过 onError → emit('error') 暴露 */ }\r\n        return\r\n      }\r\n\r\n      // [6] 同步业务\r\n      emit('click', e)\r\n    }\r\n\r\n    return () => {\r\n      // compat 层抹平 Vue2 / Vue3 差异：\r\n      //   slots         —— 统一 $slots / $scopedSlots 与 Vue3 slots\r\n      //   listenerProps —— 把 Vue2 的 $listeners 归一成 Vue3 风格的 onXxx 形态\r\n      const slots = useCompatSlots(getCurrentInstance())\r\n      const listenerProps = useCompatListeners(getCurrentInstance())\r\n\r\n      // 合并顺序：已剔除自有 prop 的转发集合 → 注入 finalLoading（覆盖可能透传的 loading）\r\n      //           → 原生 attrs（因 inheritAttrs:false 需手动合并）\r\n      //           → 兼容层监听器 → 本组件追加的 class / onClick。\r\n      const compProps = {\r\n        ...elForwarded.value,\r\n        loading: finalLoading.value,\r\n        ...attrs,\r\n        ...listenerProps,\r\n        class: ['x-button', (attrs as any).class].filter(Boolean),\r\n        onClick: handleClick\r\n      }\r\n\r\n      // 把父级插槽统一包成 Vue3 函数型 slot，renderSlot 内部兼容 Vue2 作用域插槽调用\r\n      const slotNodes: Record<string, any> = {}\r\n      Object.keys(slots).forEach(name => {\r\n        slotNodes[name] = (scope: any) => renderSlot(slots, name, scope)\r\n      })\r\n\r\n      const button = h(ElButton, compProps, slotNodes)\r\n\r\n      // 特性 2：只要存在 tooltip 文案就始终外包 span。\r\n      //   1) disabled 态下 HTML 规范不派发 mouse 事件，必须借 span 承接；\r\n      //   2) Vue2 下 element-ui 的 el-tooltip 在 mounted 阶段把 mouseenter/mouseleave\r\n      //      绑定到 referenceElm（第一个子 VNode 对应的 DOM）。若触发器随 disabled\r\n      //      切换在 <span> 与 <button> 之间变化，Vue 会替换 DOM 而 el-tooltip 不会\r\n      //      重新订阅事件，导致切到非禁用态后 tooltip 失效。始终用 span 作为稳定触发器，\r\n      //      可彻底规避该响应式缺陷；Vue3/element-plus 侧无副作用。\r\n      const trigger = activeTip.value\r\n        ? h('span', { class: 'x-button__tip-shim', style: 'display:inline-block' }, [button])\r\n        : button\r\n\r\n      // 业务能力：有 tip 文案时外层包一层 Tooltip\r\n      //\r\n      // 【Vue2 下必须使用数组 children，而不是 { default: () => trigger }】\r\n      //\r\n      // 背景：element-ui v2 的 el-tooltip 在 render 函数内部通过 getFirstElement()\r\n      //   读取 `this.$slots.default`，取其中第一个带 `tag` 的 VNode 作为触发元素\r\n      //   （trigger）。它并不会走 `_t(\"default\")` / `$scopedSlots.default()` 访问层。\r\n      //\r\n      // 问题：若写成 `{ default: () => trigger }`，Vue2 兼容层 `compat/h.ts` 会把\r\n      //   default 函数挂到 `data.scopedSlots.default`（懒传），而 `$slots.default`\r\n      //   的回填源是 **当前 XButton wrapper 自身的 $slots.default**（即父级模板塞进来\r\n      //   的文本节点，如 \"上方提示\"）。这些文本 VNode 不带 tag，getFirstElement()\r\n      //   返回 null，整颗 tooltip 渲染为空 —— 表现为页面上按钮完全不显示。\r\n      //\r\n      // 方案：直接以数组 children 形式把已构造好的 `trigger` VNode 传给 el-tooltip。\r\n      //   `compat/h.ts` 对 Array.isArray(children) 的分支会直接透传给 Vue2\r\n      //   createElement，由 Vue2 将其填充到子组件的 $slots.default。这样\r\n      //   getFirstElement() 能正确取到 trigger 作 trigger，tooltip 正常挂载。\r\n      //   Vue3 分支下数组 children 也被直接识别为默认插槽内容，语义一致。\r\n      //\r\n      // 注意：该写法仅适用于\"纯 default 插槽 + 非作用域 + 单个/多个静态 VNode\" 的\r\n      //   wrap 场景。若下游组件还需要具名插槽（如 el-tooltip 的 `content` 插槽）或\r\n      //   作用域插槽，则必须回到 `{ default, xxx, ... }` 对象形式。本组件仅用到\r\n      //   el-tooltip 的 default 通道（`content` 已通过 props 传递），故适用。\r\n      if (activeTip.value) {\r\n        const tooltipProps = {\r\n          content: activeTip.value,\r\n          placement: props.placement ?? 'top',\r\n          ...(props.tipProps ?? {})\r\n        }\r\n        // 【Vue2 / Vue3 的 default slot 形式必须分发】\r\n        // Vue2 侧保持数组 children：这是 element-ui v2 的 el-tooltip 通过\r\n        //   `$slots.default[0]` 读取触发元素的刚需（上方大段历史注释已详述）。\r\n        // Vue3 侧若继续用数组 children，Vue 3.5+ 会抛出性能告警：\r\n        //   \"Non-function value encountered for default slot. Prefer function slots for better performance.\"\r\n        //   （见 runtime-core 对 RawSlots 的规范化：值型 slot 会被包成函数并静态标记，\r\n        //    消耗额外的开销，官方推荐直接传函数型 slot。）\r\n        // 因此 Vue3 改走 { default: () => trigger } 的函数插槽，Vue2 保持数组兼容写法。\r\n        return isVue3\r\n          ? h(ElTooltip, tooltipProps, { default: () => trigger })\r\n          : h(ElTooltip, tooltipProps, [trigger] as any)\r\n      }\r\n\r\n      return trigger\r\n    }\r\n  }\r\n})\r\n"],"names":["buttonProps","time","type","Number","default","undefined","tip","String","placement","tipProps","Object","isDebounce","Boolean","disabledTip","asyncClick","Function","autoLoading","loading","confirm","buttonEmits","SELF_PROP_KEYS","name","inheritAttrs","props","emits","setup","attrs","emit","ElButton","getUIComponent","ElTooltip","forwarded","useForwardProps","elForwarded","useOmitForwardProps","isDisabled","computed","v","disabled","activeTip","value","autoLoadingRef","run","runAsync","useAsyncAction","e","onError","err","finalLoading","messageBox","useMessageBox","confirmingRef","ref","record","isDebounceBlocked","now","gap","handleClick","Date","__NODE_ENV__","globalThis","process","env","NODE_ENV","onClick","console","warn","slots","useCompatSlots","getCurrentInstance","listenerProps","useCompatListeners","compProps","class","filter","slotNodes","keys","forEach","scope","renderSlot","button","h","trigger","style","tooltipProps","content","isVue3"],"mappings":"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"}

package/dist/vue3/index150.cjs

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index150.cjs.map

package/dist/vue3/index150.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index150.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/vue3/index150.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=index150.mjs.map

package/dist/vue3/index150.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index150.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/vue3/index151.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("vue-demi"),t=new WeakMap;let n=0;function o(e){if(e&&"object"==typeof e)return t.get(e)}exports.createComponentRef=function(){const o=e.ref(null);return e.isVue2&&t.set(o,(n+=1,`__x_inner_ref_${n}__`)),o},exports.getV2StringRefKey=o,exports.useForwardRef=function(t){const n=e.getCurrentInstance();if(e.isVue2)e.onMounted(()=>{if(!n)return;const e=t(),r=o(e),s=n.proxy;let u=null;r&&s&&s.$refs&&(u=s.$refs[r]),!u&&e.value&&(u=e.value),u&&(e.value=u,Object.keys(u).forEach(e=>{"function"==typeof u[e]&&(s[e]=u[e].bind(u))}))});else if(n){n.exposed||(n.exposed={});const o=n.exposed;e.onMounted(()=>{const e=t();if(e.value){const t=e.value;Object.keys(t).forEach(e=>{"function"==typeof t[e]&&(o[e]=t[e].bind(t))})}})}};
+//# sourceMappingURL=index151.cjs.map

package/dist/vue3/index151.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index151.cjs","sources":["../../src/compat/ref.ts"],"sourcesContent":["// packages/core/src/compat/ref.ts\r\n\r\n/**\r\n * 组件 ref 转发兼容层\r\n *\r\n * 问题背景：\r\n *   X 系列组件（如 XInput）通常是对 el-input 等底层组件的包装器（wrapper）。\r\n *   使用者通过 `ref` 获取 XInput 实例后，期望能像直接使用 el-input 一样\r\n *   调用 focus()、blur()、clear() 等方法。然而：\r\n *   - Vue 3：包装组件需要通过 `defineExpose` 显式暴露方法，否则外部 ref 无法访问。\r\n *   - Vue 2：没有 `expose` 机制，所有组件实例属性都默认可访问，\r\n *     但包装组件本身并未定义这些方法，需手动将内层组件的方法挂载到外层实例上。\r\n *\r\n * 【Vue 2 对象 ref 不可用的关键事实】\r\n *   Vue 2 原生 createElement 的 `data.ref` 只接受字符串（以及少见的函数 ref），\r\n *   并不识别一个 `ref()` 返回的 Ref 对象。`@vue/composition-api` 也未对\r\n *   `h(Comp, { ref: refObj })` 做自动注入 —— 它只在组件 setup() 返回的 bindings\r\n *   中按 key 同步 `vm.$refs[key]` → `bindings[key].value`。\r\n *   因此在 Vue 2 下，若直接把 Ref 对象传给 `h` 的 ref 字段，`refObj.value` 始终\r\n *   为 null，以此驱动的 forward 逻辑永远不会执行。\r\n *\r\n *   本模块的兼容策略：`createComponentRef` 在 Vue 2 下给返回的 Ref 关联一个唯一\r\n *   字符串 key（通过 WeakMap 旁路保存，而非挂在 Ref 对象上——\r\n *   `@vue/composition-api` 会对 `ref()` 返回值执行 `Object.seal`，直接挂属性会触发\r\n *   `TypeError: Cannot add property ..., object is not extensible`）；\r\n *   `compat/h.ts` 在 Vue 2 分支通过该映射将对象 ref 替换为对应字符串 ref；\r\n *   组件挂载后 `useForwardRef` 通过 `instance.proxy.$refs[key]` 取出真实 vm，\r\n *   一方面把 vm 回填到 Ref 对象（保持 `ref.value` 语义一致），\r\n *   一方面将 vm 上的方法转发到 wrapper 实例。\r\n *\r\n * 解决方案：\r\n *   `useForwardRef` 在组件挂载后，将内层组件 ref 上的所有函数方法转发到外层：\r\n *   - Vue2：将方法直接挂载到 instance.proxy（即组件的 `this`）上\r\n *   - Vue3：将方法写入 instance.exposed（等价于 defineExpose 的效果），\r\n *     同时同步到 instance.exposeProxy 以保证响应性代理的可访问性\r\n */\r\n\r\nimport { ref, getCurrentInstance, onMounted, type Ref } from 'vue-demi'\r\nimport { isVue2 } from 'vue-demi'\r\n\r\n/**\r\n * Vue2 Ref → 字符串 ref key 的旁路映射。\r\n *\r\n * 为什么必须用 WeakMap 而不是直接在 Ref 对象上加属性：\r\n *   `@vue/composition-api` 的 `createRef` 在返回前调用 `Object.seal(r)`\r\n *   （见其源码 `createRef`），对 seal 后的对象新增属性会在严格模式下抛\r\n *   `TypeError: Cannot add property __v2StringRef, object is not extensible`，\r\n *   非严格模式下则静默失败。使用 WeakMap 以 Ref 对象为键旁路保存元数据，\r\n *   既不触碰对象本身，也能在组件卸载、Ref 被 GC 时自动释放条目。\r\n */\r\nconst v2RefKeyMap = new WeakMap<object, string>()\r\n\r\nlet v2RefUid = 0\r\nfunction genV2StringRef(): string {\r\n  v2RefUid += 1\r\n  return `__x_inner_ref_${v2RefUid}__`\r\n}\r\n\r\n/**\r\n * 读取 Ref 对象关联的 Vue2 字符串 ref key（若无则返回 undefined）。\r\n * 供 `compat/h.ts` 在 Vue2 分支识别需要替换为字符串 ref 的对象 ref。\r\n */\r\nexport function getV2StringRefKey(refObj: unknown): string | undefined {\r\n  if (!refObj || typeof refObj !== 'object') return undefined\r\n  return v2RefKeyMap.get(refObj as object)\r\n}\r\n\r\n/**\r\n * 将内层组件（如 el-input）的方法转发到当前包装组件的 ref 上。\r\n *\r\n * - Vue2：挂载后通过 `instance.proxy.$refs[stringKey]` 获取真实 vm，\r\n *   将其函数方法绑定并挂载到 `instance.proxy`，同时把 vm 写回外部传入的\r\n *   Ref 对象（便于组件内部沿用 `ref.value.focus()` 统一 API）。\r\n * - Vue3：在 setup 阶段占位 `instance.exposed = {}`，onMounted 再写入方法。\r\n *\r\n * @param getTargetRef - 返回内层组件 ref 的工厂函数（延迟求值，避免挂载前访问）\r\n *\r\n * 示例：\r\n *   const elInputRef = createComponentRef<ElInputInstance>()\r\n *   useForwardRef(() => elInputRef)\r\n *   // 渲染：h(ElInput, { ref: elInputRef })\r\n */\r\nexport function useForwardRef<T = any>(\r\n  getTargetRef: () => Ref<T | null>\r\n) {\r\n  const instance = getCurrentInstance()\r\n\r\n  if (isVue2) {\r\n    onMounted(() => {\r\n      if (!instance) return\r\n      const targetRefObj = getTargetRef()\r\n      const stringKey = getV2StringRefKey(targetRefObj)\r\n      const vm: any = (instance as any).proxy\r\n      // 优先：通过字符串 ref key 从 $refs 取真实内层 vm；\r\n      // 回退：若外部已直接写入 ref.value（少见），继续使用。\r\n      let target: any = null\r\n      if (stringKey && vm && vm.$refs) {\r\n        target = vm.$refs[stringKey]\r\n      }\r\n      if (!target && targetRefObj.value) {\r\n        target = targetRefObj.value\r\n      }\r\n      if (!target) return\r\n      // 回填到外部 ref 对象，保持 `ref.value` 与 Vue3 行为一致\r\n      targetRefObj.value = target\r\n      Object.keys(target).forEach(key => {\r\n        if (typeof target[key] === 'function') {\r\n          vm[key] = target[key].bind(target)\r\n        }\r\n      })\r\n    })\r\n  } else {\r\n    // 【关键】Vue3 下必须在 setup 阶段就把 instance.exposed 置为一个对象。\r\n    // 原因：父组件的 templateRef 在 patch 阶段 mountComponent 返回后立即通过\r\n    // setRef 解析 —— 此时如果 instance.exposed 为 null，setRef 会回落到\r\n    // instance.proxy（不含 el-input 的 focus/blur/…）。而 onMounted 钩子\r\n    // 位于 post flush 队列，晚于 setRef，届时再写 instance.exposed 已经\r\n    // 无法影响父 ref.value。\r\n    //\r\n    // 这里的做法：setup 阶段先放入一个占位对象，使 setRef 能解析出\r\n    // exposeProxy；onMounted 再把 el-input 上的方法 in-place 写入同一个对象，\r\n    // exposeProxy 的 Proxy 会实时读到新增属性（target[key]），外部\r\n    // ref.value.focus() 从而可用。\r\n    if (instance) {\r\n      if (!instance.exposed) {\r\n        instance.exposed = {}\r\n      }\r\n      const exposed = instance.exposed as Record<string, any>\r\n      onMounted(() => {\r\n        const targetRef = getTargetRef()\r\n        if (targetRef.value) {\r\n          const target = targetRef.value as any\r\n          Object.keys(target).forEach(key => {\r\n            if (typeof target[key] === 'function') {\r\n              exposed[key] = target[key].bind(target)\r\n            }\r\n          })\r\n        }\r\n      })\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * 创建带类型的组件 ref，初始值为 null。\r\n *\r\n * 在 Vue 2 下，额外给返回的 Ref 对象挂上唯一字符串 key（`__v2StringRef`），\r\n * 用于在 `compat/h.ts` 中把对象 ref 替换为字符串 ref（绕过\r\n * `@vue/composition-api` 不支持 `h(..., { ref: refObj })` 的限制）。\r\n *\r\n * 示例：\r\n *   const elInputRef = createComponentRef<ElInput>()\r\n *   // 渲染：h(ElInput, { ref: elInputRef })  // Vue2 下内部转为字符串 ref\r\n */\r\nexport function createComponentRef<T = any>(): Ref<T | null> {\r\n  const r = ref(null) as Ref<T | null>\r\n  if (isVue2) {\r\n    // 通过 WeakMap 旁路保存字符串 key，避免直接在 Object.seal 过的 Ref 上挂属性\r\n    v2RefKeyMap.set(r as unknown as object, genV2StringRef())\r\n  }\r\n  return r\r\n}\r\n"],"names":["v2RefKeyMap","WeakMap","v2RefUid","getV2StringRefKey","refObj","get","r","ref","isVue2","set","getTargetRef","instance","getCurrentInstance","onMounted","targetRefObj","stringKey","vm","proxy","target","$refs","value","Object","keys","forEach","key","bind","exposed","targetRef"],"mappings":"4GAkDMA,MAAkBC,QAExB,IAAIC,EAAW,EAUR,SAASC,EAAkBC,GAChC,GAAKA,GAA4B,iBAAXA,EACtB,OAAOJ,EAAYK,IAAID,EACzB,4BAyFO,WACL,MAAME,EAAIC,EAAAA,IAAI,MAKd,OAJIC,UAEFR,EAAYS,IAAIH,GAxGlBJ,GAAY,EACL,iBAAiBA,QAyGjBI,CACT,oDA/EO,SACLI,GAEA,MAAMC,EAAWC,EAAAA,qBAEjB,GAAIJ,SACFK,EAAAA,UAAU,KACR,IAAKF,EAAU,OACf,MAAMG,EAAeJ,IACfK,EAAYZ,EAAkBW,GAC9BE,EAAWL,EAAiBM,MAGlC,IAAIC,EAAc,KACdH,GAAaC,GAAMA,EAAGG,QACxBD,EAASF,EAAGG,MAAMJ,KAEfG,GAAUJ,EAAaM,QAC1BF,EAASJ,EAAaM,OAEnBF,IAELJ,EAAaM,MAAQF,EACrBG,OAAOC,KAAKJ,GAAQK,QAAQC,IACC,mBAAhBN,EAAOM,KAChBR,EAAGQ,GAAON,EAAOM,GAAKC,KAAKP,cAgBjC,GAAIP,EAAU,CACPA,EAASe,UACZf,EAASe,QAAU,CAAA,GAErB,MAAMA,EAAUf,EAASe,QACzBb,EAAAA,UAAU,KACR,MAAMc,EAAYjB,IAClB,GAAIiB,EAAUP,MAAO,CACnB,MAAMF,EAASS,EAAUP,MACzBC,OAAOC,KAAKJ,GAAQK,QAAQC,IACC,mBAAhBN,EAAOM,KAChBE,EAAQF,GAAON,EAAOM,GAAKC,KAAKP,KAGtC,GAEJ,CAEJ"}

package/dist/vue3/index151.mjs

@@ -0,0 +1,67 @@
+import { ref, isVue2, getCurrentInstance, onMounted } from "vue-demi";
+const v2RefKeyMap = /* @__PURE__ */ new WeakMap();
+let v2RefUid = 0;
+function genV2StringRef() {
+  v2RefUid += 1;
+  return `__x_inner_ref_${v2RefUid}__`;
+}
+function getV2StringRefKey(refObj) {
+  if (!refObj || typeof refObj !== "object") return void 0;
+  return v2RefKeyMap.get(refObj);
+}
+function useForwardRef(getTargetRef) {
+  const instance = getCurrentInstance();
+  if (isVue2) {
+    onMounted(() => {
+      if (!instance) return;
+      const targetRefObj = getTargetRef();
+      const stringKey = getV2StringRefKey(targetRefObj);
+      const vm = instance.proxy;
+      let target = null;
+      if (stringKey && vm && vm.$refs) {
+        target = vm.$refs[stringKey];
+      }
+      if (!target && targetRefObj.value) {
+        target = targetRefObj.value;
+      }
+      if (!target) return;
+      targetRefObj.value = target;
+      Object.keys(target).forEach((key) => {
+        if (typeof target[key] === "function") {
+          vm[key] = target[key].bind(target);
+        }
+      });
+    });
+  } else {
+    if (instance) {
+      if (!instance.exposed) {
+        instance.exposed = {};
+      }
+      const exposed = instance.exposed;
+      onMounted(() => {
+        const targetRef = getTargetRef();
+        if (targetRef.value) {
+          const target = targetRef.value;
+          Object.keys(target).forEach((key) => {
+            if (typeof target[key] === "function") {
+              exposed[key] = target[key].bind(target);
+            }
+          });
+        }
+      });
+    }
+  }
+}
+function createComponentRef() {
+  const r = ref(null);
+  if (isVue2) {
+    v2RefKeyMap.set(r, genV2StringRef());
+  }
+  return r;
+}
+export {
+  createComponentRef,
+  getV2StringRefKey,
+  useForwardRef
+};
+//# sourceMappingURL=index151.mjs.map

package/dist/vue3/index151.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index151.mjs","sources":["../../src/compat/ref.ts"],"sourcesContent":["// packages/core/src/compat/ref.ts\r\n\r\n/**\r\n * 组件 ref 转发兼容层\r\n *\r\n * 问题背景：\r\n *   X 系列组件（如 XInput）通常是对 el-input 等底层组件的包装器（wrapper）。\r\n *   使用者通过 `ref` 获取 XInput 实例后，期望能像直接使用 el-input 一样\r\n *   调用 focus()、blur()、clear() 等方法。然而：\r\n *   - Vue 3：包装组件需要通过 `defineExpose` 显式暴露方法，否则外部 ref 无法访问。\r\n *   - Vue 2：没有 `expose` 机制，所有组件实例属性都默认可访问，\r\n *     但包装组件本身并未定义这些方法，需手动将内层组件的方法挂载到外层实例上。\r\n *\r\n * 【Vue 2 对象 ref 不可用的关键事实】\r\n *   Vue 2 原生 createElement 的 `data.ref` 只接受字符串（以及少见的函数 ref），\r\n *   并不识别一个 `ref()` 返回的 Ref 对象。`@vue/composition-api` 也未对\r\n *   `h(Comp, { ref: refObj })` 做自动注入 —— 它只在组件 setup() 返回的 bindings\r\n *   中按 key 同步 `vm.$refs[key]` → `bindings[key].value`。\r\n *   因此在 Vue 2 下，若直接把 Ref 对象传给 `h` 的 ref 字段，`refObj.value` 始终\r\n *   为 null，以此驱动的 forward 逻辑永远不会执行。\r\n *\r\n *   本模块的兼容策略：`createComponentRef` 在 Vue 2 下给返回的 Ref 关联一个唯一\r\n *   字符串 key（通过 WeakMap 旁路保存，而非挂在 Ref 对象上——\r\n *   `@vue/composition-api` 会对 `ref()` 返回值执行 `Object.seal`，直接挂属性会触发\r\n *   `TypeError: Cannot add property ..., object is not extensible`）；\r\n *   `compat/h.ts` 在 Vue 2 分支通过该映射将对象 ref 替换为对应字符串 ref；\r\n *   组件挂载后 `useForwardRef` 通过 `instance.proxy.$refs[key]` 取出真实 vm，\r\n *   一方面把 vm 回填到 Ref 对象（保持 `ref.value` 语义一致），\r\n *   一方面将 vm 上的方法转发到 wrapper 实例。\r\n *\r\n * 解决方案：\r\n *   `useForwardRef` 在组件挂载后，将内层组件 ref 上的所有函数方法转发到外层：\r\n *   - Vue2：将方法直接挂载到 instance.proxy（即组件的 `this`）上\r\n *   - Vue3：将方法写入 instance.exposed（等价于 defineExpose 的效果），\r\n *     同时同步到 instance.exposeProxy 以保证响应性代理的可访问性\r\n */\r\n\r\nimport { ref, getCurrentInstance, onMounted, type Ref } from 'vue-demi'\r\nimport { isVue2 } from 'vue-demi'\r\n\r\n/**\r\n * Vue2 Ref → 字符串 ref key 的旁路映射。\r\n *\r\n * 为什么必须用 WeakMap 而不是直接在 Ref 对象上加属性：\r\n *   `@vue/composition-api` 的 `createRef` 在返回前调用 `Object.seal(r)`\r\n *   （见其源码 `createRef`），对 seal 后的对象新增属性会在严格模式下抛\r\n *   `TypeError: Cannot add property __v2StringRef, object is not extensible`，\r\n *   非严格模式下则静默失败。使用 WeakMap 以 Ref 对象为键旁路保存元数据，\r\n *   既不触碰对象本身，也能在组件卸载、Ref 被 GC 时自动释放条目。\r\n */\r\nconst v2RefKeyMap = new WeakMap<object, string>()\r\n\r\nlet v2RefUid = 0\r\nfunction genV2StringRef(): string {\r\n  v2RefUid += 1\r\n  return `__x_inner_ref_${v2RefUid}__`\r\n}\r\n\r\n/**\r\n * 读取 Ref 对象关联的 Vue2 字符串 ref key（若无则返回 undefined）。\r\n * 供 `compat/h.ts` 在 Vue2 分支识别需要替换为字符串 ref 的对象 ref。\r\n */\r\nexport function getV2StringRefKey(refObj: unknown): string | undefined {\r\n  if (!refObj || typeof refObj !== 'object') return undefined\r\n  return v2RefKeyMap.get(refObj as object)\r\n}\r\n\r\n/**\r\n * 将内层组件（如 el-input）的方法转发到当前包装组件的 ref 上。\r\n *\r\n * - Vue2：挂载后通过 `instance.proxy.$refs[stringKey]` 获取真实 vm，\r\n *   将其函数方法绑定并挂载到 `instance.proxy`，同时把 vm 写回外部传入的\r\n *   Ref 对象（便于组件内部沿用 `ref.value.focus()` 统一 API）。\r\n * - Vue3：在 setup 阶段占位 `instance.exposed = {}`，onMounted 再写入方法。\r\n *\r\n * @param getTargetRef - 返回内层组件 ref 的工厂函数（延迟求值，避免挂载前访问）\r\n *\r\n * 示例：\r\n *   const elInputRef = createComponentRef<ElInputInstance>()\r\n *   useForwardRef(() => elInputRef)\r\n *   // 渲染：h(ElInput, { ref: elInputRef })\r\n */\r\nexport function useForwardRef<T = any>(\r\n  getTargetRef: () => Ref<T | null>\r\n) {\r\n  const instance = getCurrentInstance()\r\n\r\n  if (isVue2) {\r\n    onMounted(() => {\r\n      if (!instance) return\r\n      const targetRefObj = getTargetRef()\r\n      const stringKey = getV2StringRefKey(targetRefObj)\r\n      const vm: any = (instance as any).proxy\r\n      // 优先：通过字符串 ref key 从 $refs 取真实内层 vm；\r\n      // 回退：若外部已直接写入 ref.value（少见），继续使用。\r\n      let target: any = null\r\n      if (stringKey && vm && vm.$refs) {\r\n        target = vm.$refs[stringKey]\r\n      }\r\n      if (!target && targetRefObj.value) {\r\n        target = targetRefObj.value\r\n      }\r\n      if (!target) return\r\n      // 回填到外部 ref 对象，保持 `ref.value` 与 Vue3 行为一致\r\n      targetRefObj.value = target\r\n      Object.keys(target).forEach(key => {\r\n        if (typeof target[key] === 'function') {\r\n          vm[key] = target[key].bind(target)\r\n        }\r\n      })\r\n    })\r\n  } else {\r\n    // 【关键】Vue3 下必须在 setup 阶段就把 instance.exposed 置为一个对象。\r\n    // 原因：父组件的 templateRef 在 patch 阶段 mountComponent 返回后立即通过\r\n    // setRef 解析 —— 此时如果 instance.exposed 为 null，setRef 会回落到\r\n    // instance.proxy（不含 el-input 的 focus/blur/…）。而 onMounted 钩子\r\n    // 位于 post flush 队列，晚于 setRef，届时再写 instance.exposed 已经\r\n    // 无法影响父 ref.value。\r\n    //\r\n    // 这里的做法：setup 阶段先放入一个占位对象，使 setRef 能解析出\r\n    // exposeProxy；onMounted 再把 el-input 上的方法 in-place 写入同一个对象，\r\n    // exposeProxy 的 Proxy 会实时读到新增属性（target[key]），外部\r\n    // ref.value.focus() 从而可用。\r\n    if (instance) {\r\n      if (!instance.exposed) {\r\n        instance.exposed = {}\r\n      }\r\n      const exposed = instance.exposed as Record<string, any>\r\n      onMounted(() => {\r\n        const targetRef = getTargetRef()\r\n        if (targetRef.value) {\r\n          const target = targetRef.value as any\r\n          Object.keys(target).forEach(key => {\r\n            if (typeof target[key] === 'function') {\r\n              exposed[key] = target[key].bind(target)\r\n            }\r\n          })\r\n        }\r\n      })\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * 创建带类型的组件 ref，初始值为 null。\r\n *\r\n * 在 Vue 2 下，额外给返回的 Ref 对象挂上唯一字符串 key（`__v2StringRef`），\r\n * 用于在 `compat/h.ts` 中把对象 ref 替换为字符串 ref（绕过\r\n * `@vue/composition-api` 不支持 `h(..., { ref: refObj })` 的限制）。\r\n *\r\n * 示例：\r\n *   const elInputRef = createComponentRef<ElInput>()\r\n *   // 渲染：h(ElInput, { ref: elInputRef })  // Vue2 下内部转为字符串 ref\r\n */\r\nexport function createComponentRef<T = any>(): Ref<T | null> {\r\n  const r = ref(null) as Ref<T | null>\r\n  if (isVue2) {\r\n    // 通过 WeakMap 旁路保存字符串 key，避免直接在 Object.seal 过的 Ref 上挂属性\r\n    v2RefKeyMap.set(r as unknown as object, genV2StringRef())\r\n  }\r\n  return r\r\n}\r\n"],"names":[],"mappings":";AAkDA,MAAM,kCAAkB,QAAA;AAExB,IAAI,WAAW;AACf,SAAS,iBAAyB;AAChC,cAAY;AACZ,SAAO,iBAAiB,QAAQ;AAClC;AAMO,SAAS,kBAAkB,QAAqC;AACrE,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,SAAO,YAAY,IAAI,MAAgB;AACzC;AAiBO,SAAS,cACd,cACA;AACA,QAAM,WAAW,mBAAA;AAEjB,MAAI,QAAQ;AACV,cAAU,MAAM;AACd,UAAI,CAAC,SAAU;AACf,YAAM,eAAe,aAAA;AACrB,YAAM,YAAY,kBAAkB,YAAY;AAChD,YAAM,KAAW,SAAiB;AAGlC,UAAI,SAAc;AAClB,UAAI,aAAa,MAAM,GAAG,OAAO;AAC/B,iBAAS,GAAG,MAAM,SAAS;AAAA,MAC7B;AACA,UAAI,CAAC,UAAU,aAAa,OAAO;AACjC,iBAAS,aAAa;AAAA,MACxB;AACA,UAAI,CAAC,OAAQ;AAEb,mBAAa,QAAQ;AACrB,aAAO,KAAK,MAAM,EAAE,QAAQ,CAAA,QAAO;AACjC,YAAI,OAAO,OAAO,GAAG,MAAM,YAAY;AACrC,aAAG,GAAG,IAAI,OAAO,GAAG,EAAE,KAAK,MAAM;AAAA,QACnC;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAAA,EACH,OAAO;AAYL,QAAI,UAAU;AACZ,UAAI,CAAC,SAAS,SAAS;AACrB,iBAAS,UAAU,CAAA;AAAA,MACrB;AACA,YAAM,UAAU,SAAS;AACzB,gBAAU,MAAM;AACd,cAAM,YAAY,aAAA;AAClB,YAAI,UAAU,OAAO;AACnB,gBAAM,SAAS,UAAU;AACzB,iBAAO,KAAK,MAAM,EAAE,QAAQ,CAAA,QAAO;AACjC,gBAAI,OAAO,OAAO,GAAG,MAAM,YAAY;AACrC,sBAAQ,GAAG,IAAI,OAAO,GAAG,EAAE,KAAK,MAAM;AAAA,YACxC;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAaO,SAAS,qBAA6C;AAC3D,QAAM,IAAI,IAAI,IAAI;AAClB,MAAI,QAAQ;AAEV,gBAAY,IAAI,GAAwB,gBAAgB;AAAA,EAC1D;AACA,SAAO;AACT;"}

package/dist/vue3/index152.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("vue-demi");exports.buildVModelBind=function(u,l){return e.isVue2?{value:u,onInput:l}:{modelValue:u,"onUpdate:modelValue":l}},exports.useVModel=function(u,l){const o=e.computed({get:()=>e.isVue2?u.value:u.modelValue,set(u){e.isVue2?l("input",u):l("update:modelValue",u)}}),t=e.computed(()=>e.isVue2?{value:o.value,onInput:e=>{o.value=e}}:{modelValue:o.value,"onUpdate:modelValue":e=>{o.value=e}});return{modelValue:o,modelProps:t}};
+//# sourceMappingURL=index152.cjs.map

package/dist/vue3/index152.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index152.cjs","sources":["../../src/compat/v-model.ts"],"sourcesContent":["// packages/core/src/compat/v-model.ts\r\n\r\n/**\r\n * v-model 双向绑定兼容层\r\n *\r\n * Vue 2：v-model 绑定 value prop + input 事件\r\n * Vue 3：v-model 绑定 modelValue prop + update:modelValue 事件\r\n *\r\n * 使用方式：\r\n *   const { modelValue, modelProps } = useVModel(props, emit)\r\n *   // modelProps 自动返回正确版本的 prop/event 组合\r\n */\r\n\r\nimport { computed } from 'vue-demi'\r\nimport { isVue2 } from 'vue-demi'\r\n\r\nexport interface VModelProps {\r\n  modelValue?: any\r\n  value?: any\r\n  'onUpdate:modelValue'?: (value: any) => void\r\n  onInput?: (value: any) => void\r\n}\r\n\r\nexport function useVModel<T = any>(\r\n  props: VModelProps,\r\n  emit: (event: string, ...args: any[]) => void\r\n) {\r\n  const modelValue = computed<T>({\r\n    get() {\r\n      return (isVue2 ? props.value : props.modelValue) as T\r\n    },\r\n    set(val: T) {\r\n      if (isVue2) {\r\n        emit('input', val)\r\n      } else {\r\n        emit('update:modelValue', val)\r\n      }\r\n    }\r\n  })\r\n\r\n  const modelProps = computed(() => {\r\n    if (isVue2) {\r\n      return {\r\n        value: modelValue.value,\r\n        onInput: (val: T) => {\r\n          modelValue.value = val\r\n        }\r\n      }\r\n    } else {\r\n      return {\r\n        modelValue: modelValue.value,\r\n        'onUpdate:modelValue': (val: T) => {\r\n          modelValue.value = val\r\n        }\r\n      }\r\n    }\r\n  })\r\n\r\n  return {\r\n    modelValue,\r\n    modelProps\r\n  }\r\n}\r\n\r\nexport function getModelPropName(): string {\r\n  return isVue2 ? 'value' : 'modelValue'\r\n}\r\n\r\nexport function getModelEventName(): string {\r\n  return isVue2 ? 'input' : 'update:modelValue'\r\n}\r\n\r\n/**\r\n * 命令式 v-model 绑定生成器（与 useVModel hook 互补）\r\n *\r\n * 用于配置驱动场景：renderField 中针对每个动态字段生成 v-model props，\r\n * 此时无法使用 hook 写法。返回值直接展开到 h() 的 props 中。\r\n *\r\n * Vue2：{ value, onInput }\r\n * Vue3：{ modelValue, 'onUpdate:modelValue' }\r\n */\r\nexport function buildVModelBind(val: any, setter: (v: any) => void): Record<string, any> {\r\n  return isVue2\r\n    ? { value: val, onInput: setter }\r\n    : { modelValue: val, 'onUpdate:modelValue': setter }\r\n}\r\n"],"names":["val","setter","isVue2","value","onInput","modelValue","props","emit","computed","get","set","modelProps"],"mappings":"oIAiFO,SAAyBA,EAAUC,GACxC,OAAOC,SACH,CAAEC,MAAOH,EAAKI,QAASH,GACvB,CAAEI,WAAYL,EAAK,sBAAuBC,EAChD,oBA9DO,SACLK,EACAC,GAEA,MAAMF,EAAaG,EAAAA,SAAY,CAC7BC,IAAA,IACUP,SAASI,EAAMH,MAAQG,EAAMD,WAEvC,GAAAK,CAAIV,GACEE,SACFK,EAAK,QAASP,GAEdO,EAAK,oBAAqBP,EAE9B,IAGIW,EAAaH,EAAAA,SAAS,IACtBN,SACK,CACLC,MAAOE,EAAWF,MAClBC,QAAUJ,IACRK,EAAWF,MAAQH,IAIhB,CACLK,WAAYA,EAAWF,MACvB,sBAAwBH,IACtBK,EAAWF,MAAQH,KAM3B,MAAO,CACLK,aACAM,aAEJ"}