@testid/antd-testid-runtime 1.0.17 → 1.0.18

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import { App } from 'vue';
+
 /**
  * UI 库适配器接口 — adapters/types.ts
  *
@@ -486,4 +488,30 @@ declare class TestIdChecker {
     private static reportGroupDuplicates;
 }
 
-export { type ParsedBaseKey, type PopupType, TestIdChecker, type TestIdMarkConfig, TestIdObserver, type UiAdapter, antdAdapter, buildAnchorTestId, buildPopupTestId, defaultConfig, elementAdapter, getAnchorCounterMap, getConfig, getNextAnchorLocalIndex, getNextPopupId, getPopupCounterSnapshot, initConfig, mergeConfig, parseBaseKey, resetAllAnchorCounters, resetAllPopupCounters, resetPopupCounter };
+/**
+ * Vue 3 插件桥接 — testIdVuePlugin.ts
+ *
+ * 铁三角第二层：绕过 UI 库组件 inheritAttrs: false 的限制。
+ *
+ * 问题背景:
+ *   编译期在 <a-menu-item data-test-base-key="..."> 上注入属性，
+ *   但 Ant Design Vue 等 UI 库组件通常设置 inheritAttrs: false，
+ *   导致非 prop 属性不会自动传递到渲染后的 DOM 元素上。
+ *
+ * 解决方案:
+ *   通过 app.mixin({ mounted() }) 全局混入，在每个组件挂载后，
+ *   从 Vue 内部的 $attrs 中读取插件关注的属性并手动写入 $el。
+ *
+ *   对于 inheritAttrs: true (默认) 的组件，Vue 已自动应用属性到 $el，
+ *   hasAttribute 检查会跳过避免重复写入。
+ *
+ * 使用方式:
+ *   import { TestIdVuePlugin } from '@testid/antd-testid-runtime';
+ *   app.use(TestIdVuePlugin);  // 必须在 app.mount() 之前调用
+ */
+
+declare const TestIdVuePlugin: {
+    install(app: App): void;
+};
+
+export { type ParsedBaseKey, type PopupType, TestIdChecker, type TestIdMarkConfig, TestIdObserver, TestIdVuePlugin, type UiAdapter, antdAdapter, buildAnchorTestId, buildPopupTestId, defaultConfig, elementAdapter, getAnchorCounterMap, getConfig, getNextAnchorLocalIndex, getNextPopupId, getPopupCounterSnapshot, initConfig, mergeConfig, parseBaseKey, resetAllAnchorCounters, resetAllPopupCounters, resetPopupCounter };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { App } from 'vue';
+
 /**
  * UI 库适配器接口 — adapters/types.ts
  *
@@ -486,4 +488,30 @@ declare class TestIdChecker {
     private static reportGroupDuplicates;
 }
 
-export { type ParsedBaseKey, type PopupType, TestIdChecker, type TestIdMarkConfig, TestIdObserver, type UiAdapter, antdAdapter, buildAnchorTestId, buildPopupTestId, defaultConfig, elementAdapter, getAnchorCounterMap, getConfig, getNextAnchorLocalIndex, getNextPopupId, getPopupCounterSnapshot, initConfig, mergeConfig, parseBaseKey, resetAllAnchorCounters, resetAllPopupCounters, resetPopupCounter };
+/**
+ * Vue 3 插件桥接 — testIdVuePlugin.ts
+ *
+ * 铁三角第二层：绕过 UI 库组件 inheritAttrs: false 的限制。
+ *
+ * 问题背景:
+ *   编译期在 <a-menu-item data-test-base-key="..."> 上注入属性，
+ *   但 Ant Design Vue 等 UI 库组件通常设置 inheritAttrs: false，
+ *   导致非 prop 属性不会自动传递到渲染后的 DOM 元素上。
+ *
+ * 解决方案:
+ *   通过 app.mixin({ mounted() }) 全局混入，在每个组件挂载后，
+ *   从 Vue 内部的 $attrs 中读取插件关注的属性并手动写入 $el。
+ *
+ *   对于 inheritAttrs: true (默认) 的组件，Vue 已自动应用属性到 $el，
+ *   hasAttribute 检查会跳过避免重复写入。
+ *
+ * 使用方式:
+ *   import { TestIdVuePlugin } from '@testid/antd-testid-runtime';
+ *   app.use(TestIdVuePlugin);  // 必须在 app.mount() 之前调用
+ */
+
+declare const TestIdVuePlugin: {
+    install(app: App): void;
+};
+
+export { type ParsedBaseKey, type PopupType, TestIdChecker, type TestIdMarkConfig, TestIdObserver, TestIdVuePlugin, type UiAdapter, antdAdapter, buildAnchorTestId, buildPopupTestId, defaultConfig, elementAdapter, getAnchorCounterMap, getConfig, getNextAnchorLocalIndex, getNextPopupId, getPopupCounterSnapshot, initConfig, mergeConfig, parseBaseKey, resetAllAnchorCounters, resetAllPopupCounters, resetPopupCounter };

package/dist/index.js

@@ -39,6 +39,7 @@ var index_exports = {};
 __export(index_exports, {
   TestIdChecker: () => TestIdChecker,
   TestIdObserver: () => TestIdObserver,
+  TestIdVuePlugin: () => TestIdVuePlugin,
   antdAdapter: () => antdAdapter,
   buildAnchorTestId: () => buildAnchorTestId,
   buildPopupTestId: () => buildPopupTestId,
@@ -882,10 +883,32 @@ var TestIdChecker = class {
     console.groupEnd();
   }
 };
+
+// src/utils/testIdVuePlugin.ts
+var WATCHED_ATTRS = ["data-testid", "data-test-base-key"];
+var TestIdVuePlugin = {
+  install(app) {
+    app.mixin({
+      mounted() {
+        const el = this.$el;
+        if (!el) return;
+        const attrs = this.$attrs || {};
+        if (!attrs || typeof attrs !== "object") return;
+        for (const attr of WATCHED_ATTRS) {
+          const value = attrs[attr];
+          if (value != null && !el.hasAttribute(attr)) {
+            el.setAttribute(attr, String(value));
+          }
+        }
+      }
+    });
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   TestIdChecker,
   TestIdObserver,
+  TestIdVuePlugin,
   antdAdapter,
   buildAnchorTestId,
   buildPopupTestId,

package/dist/index.mjs

@@ -842,9 +842,31 @@ var TestIdChecker = class {
     console.groupEnd();
   }
 };
+
+// src/utils/testIdVuePlugin.ts
+var WATCHED_ATTRS = ["data-testid", "data-test-base-key"];
+var TestIdVuePlugin = {
+  install(app) {
+    app.mixin({
+      mounted() {
+        const el = this.$el;
+        if (!el) return;
+        const attrs = this.$attrs || {};
+        if (!attrs || typeof attrs !== "object") return;
+        for (const attr of WATCHED_ATTRS) {
+          const value = attrs[attr];
+          if (value != null && !el.hasAttribute(attr)) {
+            el.setAttribute(attr, String(value));
+          }
+        }
+      }
+    });
+  }
+};
 export {
   TestIdChecker,
   TestIdObserver,
+  TestIdVuePlugin,
   antdAdapter,
   buildAnchorTestId,
   buildPopupTestId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testid/antd-testid-runtime",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "description": "运行时兜底打标模块 — MutationObserver + 锚点计数器 + 浮层计数器 + ID 重复检测",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -25,8 +25,12 @@
     "dev": "tsup src/index.ts --dts --format esm,cjs --watch --target es2015"
   },
   "dependencies": {},
+  "peerDependencies": {
+    "vue": "^3.0.0"
+  },
   "devDependencies": {
     "tsup": "^8.0.0",
-    "typescript": "^5.3.0"
+    "typescript": "^5.3.0",
+    "vue": "^3.4.0"
   }
 }