@agile-team/wl-skills-ui 1.9.8 → 1.9.10

package/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to **@agile-team/wl-skills-ui** will be documented in this f
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [1.9.10] - 2026-08-01
+
+### Added
+
+- 新增 `@agile-team/wl-skills-ui/runtime/auto` 包级保护入口；Skin 项目一次引入即可获得主题锁和普通表格真实溢出 Tooltip 兜底，Native 项目的 `installCommonPreset()` 自动安装相同保护。
+- 新增长文本 DOM 回归测试，覆盖真实溢出、未溢出、动态/虚拟行、Element 原生 Tooltip 优先以及操作列、Tag、定制区域等排除边界。
+
+### Fixed
+
+- 修复平台将 `.ag-cell` 与 `.ag-cell-value` 复用为 flex 节点时 `text-overflow: ellipsis` 只裁切、不绘制省略号的问题。
+- 普通 Element Table、BaseTable 与 AG Grid 不再依赖页面是否调用 `defineColumns()` 才能获得长文本兜底；运行时仅在真实溢出时创建统一提示，不接管已有 Tooltip 或语义组件。
+
+### Changed
+
+- SCSS 发布门禁由引用路径检查升级为 full/skin 入口真实编译，避免合法性问题进入 npm 包。
+
+## [1.9.9] - 2026-07-29
+
+### Fixed
+
+- 将 Element Table 与 AG Grid 的行 hover/selected 底色统一为品牌色 4%/7% 浅层，并保证 AG Grid 选中态优先于 hover，缓解可编辑控件下方色带过重且不覆盖校验态或业务语义单元格。
+
 ## [1.9.8] - 2026-07-29
 
 ### Fixed

package/README.md

@@ -103,18 +103,23 @@ wl-skills-ui/
 │   │   ├── registry.ts           # createPreset / installPreset
 │   │   ├── common.ts             # 通用业务预设（enable/audit/verify + 起步包）
 │   │   └── index.ts
+│   ├── auto.ts                   # Skin/老项目包级保护自动入口
+│   ├── guards.ts                 # 主题锁 + 长文本溢出保护聚合
+│   ├── overflow-tooltip.ts       # 普通表格真实溢出 Tooltip 兜底
 │   └── index.ts                  # 公共 API 入口
 │
 ├── scanner/                      # 自动化扫描 / 修复
 │   ├── index.mjs                 # CLI（含 --layer/--vendor/--mode 过滤）
 │   ├── rules/                    # 规则集
 │   │   ├── _shared.mjs           # 公共工具 + inferMeta(layer/vendor)
-│   │   ├── table.mjs             # R001 R002 R003 R014
+│   │   ├── table.mjs             # R001 R002 R003 R014 R039
 │   │   ├── form.mjs              # R006 R007 R008
-│   │   ├── button.mjs            # R004 R005 R015
+│   │   ├── button.mjs            # R004 R005 R015 R038
 │   │   ├── tag.mjs               # R009 R010 R012
 │   │   ├── dialog.mjs            # R011
 │   │   ├── color.mjs             # R016 R017 R018
+│   │   ├── semantic.mjs          # R025 R026 R027
+│   │   ├── componentFamily.mjs   # R031 R032 R033 R034 R035 R036 R037
 │   │   └── index.mjs             # 聚合 + addRules() 插件机制
 │   ├── fix.mjs                   # 自动修复引擎
 │   ├── integration.mjs           # 接入完整性检查
@@ -134,7 +139,8 @@ wl-skills-ui/
 │   │   ├── el-table/SKILL.md
 │   │   ├── el-form/SKILL.md
 │   │   ├── el-dialog/SKILL.md
-│   │   └── el-tag/SKILL.md
+│   │   ├── el-tag/SKILL.md
+│   │   └── component-family/      # 扩展组件族（card/tabs/descriptions/drawer/upload/steps/feedback）
 │   ├── vendors/                  # ⭐ L2 封装识别 SKILL
 │   │   ├── base-table/SKILL.md       # 优先级 #1
 │   │   ├── jh-components/SKILL.md    # 优先级 #2
@@ -149,7 +155,9 @@ wl-skills-ui/
 │   │   └── migration/SKILL.md
 │   └── ops/                      # 操作类 SKILL
 │       ├── scan/SKILL.md
-│       └── fix/SKILL.md
+│       ├── audit/SKILL.md
+│       ├── fix/SKILL.md
+│       └── migrate/SKILL.md
 │
 ├── templates/                    # 代码生成模板
 │   ├── list-page/TPL-LIST.md
@@ -200,7 +208,7 @@ yarn add @agile-team/wl-skills-ui
 |---|---|---|
 | `element-plus` | **`2.2.6-prod.3`** | 集团 jh- 定制版；EP 2.3.0 起引入 `.el-input__wrapper`，与 jh-ui 3.x 不兼容 |
 | `@jhlc/jh-ui` | **`3.1.0`** | SCSS 皮肤包，`.com-text` label 包裹 + `.has-colon` 冒号注入（wl-skills-ui 已统一屏蔽表单冒号） |
-| `@agile-team/wl-skills-ui` | `^1.9.8` | 已对齐上述组合的 DOM 假设、客户主题锁、圆角契约与定制页样式边界 |
+| `@agile-team/wl-skills-ui` | `^1.9.10` | 已对齐上述组合的 DOM 假设、客户主题锁、圆角契约、表格长文本兜底与定制页样式边界 |
 
 三种识别方式，任选其一：
 
@@ -214,10 +222,17 @@ yarn add @agile-team/wl-skills-ui
 
 ## 版本亮点
 
-当前 v1.9.8：
+当前 v1.9.10：
+
+- **长文本真正包级闭环**：普通 Element Table、BaseTable 与 AG Grid 即使没有经过 `defineColumns()`，真实超宽时也会稳定显示省略号，并由 `runtime/auto` 在悬停或键盘聚焦时兜底完整文本提示；动态行和虚拟滚动无需额外处理。
+- **严格防污染边界**：已有组件 Tooltip 优先，编辑列、操作列、Tag、复选框、自定义 renderer、主动换行列、登录页及显式皮肤豁免区域均不接管；没有溢出时不创建 Tooltip。
+- **发布验证补强**：新增真实 DOM 行为测试，并将 SCSS 门禁从路径存在检查升级为完整入口编译，防止 flex 省略冲突或无效选择器再次漏发。
+
+上一版 v1.9.9：
 
 - **主操作按钮不再漏色**：新增/新建/添加/创建类按钮强制使用客户主题 `primary` 填充样式，扫描器可识别并自动修复漏写 `type` 或误带 `plain` 的存量代码。
 - **长文本交互统一**：普通数据列在空间不足时单行省略，悬停显示完整内容；Tag、操作列、自定义渲染和主动换行列不被机械覆盖。
+- **表格行状态降噪**：Element Table 与 AG Grid 的 hover/selected 统一为品牌色 4%/7% 浅层，选中态优先于悬停，同时保留编辑控件、校验态、Tag 和业务语义单元格底色。
 - **紧凑表单字号闭环**：业务表单 label、输入值、选择值、placeholder、textarea 与数字输入统一为 12px；登录页和显式定制区域继续保持项目自身设计。
 - **输入边框状态闭环**：textarea 聚焦始终显示品牌色边框；数字输入兼容 Element Plus 新旧及混合 wrapper DOM，默认、hover、focus、错误、禁用态均只保留一层正确边框。
 - **分裂操作保持一体**：BaseToolbar 的主动作与下拉箭头共用外轮廓和状态色，下拉菜单中的业务按钮扁平化为菜单项；规则精准限定在平台工具栏结构，不污染普通按钮组和普通下拉菜单。
@@ -277,7 +292,7 @@ yarn add @agile-team/wl-skills-ui
 - **R025** 语义合规：`options:[]` 退化检测 → 升级 `renderTagSlot` / `renderDictClassifyTag`
 - **R026** 原生 HTML 拦截：`<table>/<input>/<select>/<button>/<textarea>` → 替换 el-* 组件
 - `scan --only/--skip` 规则过滤 + `exempt init` 智能豁免脚手架
-- `scan --baseline` 漂移对比 + SCSS 链路检查 + R-rule 单一事实源（32 条）
+- `scan --baseline` 漂移对比 + SCSS 链路检查 + R-rule 单一事实源（35 条）
 
 历史亮点（v1.7.1）：
 
@@ -372,6 +387,7 @@ npx wl-ui init --mode native
 // 4. src/main.ts
 import { installCommonPreset } from "@agile-team/wl-skills-ui/runtime/common-preset";
 installCommonPreset();
+// installCommonPreset 已包含主题锁和普通表格长文本包级保护，无需重复引入 runtime/auto。
 ```
 
 ```vue
@@ -411,8 +427,13 @@ npx wl-ui init --mode skin
 @use "@agile-team/wl-skills-ui/styles/presets/skin" as *;
 ```
 
+```ts
+// 3. src/main.ts：只安装包级保护，不接管页面布局或业务列定义
+import "@agile-team/wl-skills-ui/runtime/auto";
+```
+
 ```bash
-# 3. AI 编辑器中触发：
+# 4. AI 编辑器中触发：
 #    "用 wl-ui 的 legacy-skin-align 流程跑一下当前项目"
 # → AI 按 _flows/legacy-skin-align.md 顺序执行 6 个 phase
 
@@ -624,15 +645,19 @@ export const myRules = [
 
 ---
 
-## AI/MCP 智能引导
+## AI/MCP 智能引导（10 个工具）
 
 | MCP Tool                | 作用                                                       |
 | ----------------------- | ---------------------------------------------------------- |
 | `wl_ui_check`          | 检查 tokens/styles/runtime 接入完整性                      |
 | `wl_ui_scan`           | 扫描 UI 风格偏差，输出 Markdown 或 JSON                    |
 | `wl_ui_fix_dry_run`    | 预览自动修复，不实际写入                                   |
+| `wl_ui_detect_skin`    | 检测项目 vendor 版本配对                                   |
 | `wl_ui_skill_prompt`   | 输出 AI 触发提示                                           |
 | `wl_ui_route_intent`   | 根据自然语言识别 UI 治理意图并推荐 flow/tool/skill         |
+| `wl_ui_list_rules`     | 列出全部扫描规则及说明                                     |
+| `wl_ui_describe_rule`  | 查询单条规则详情                                           |
+| `wl_ui_drift`          | 对比基线漂移                                               |
 | `wl_ui_recommend_flow` | 根据扫描 JSON 推荐 nextActions 和 `wl-skills-kit` 桥接动作 |
 
 推荐智能体流程：
@@ -660,9 +685,14 @@ export const myRules = [
 | `renderRatingLevel(v)`                           | 评级颜色                                           |
 | `registerColumnAutoMap(field, config)`           | 注册新字段自动渲染                                 |
 | `installCommonPreset()`                          | 安装通用业务预设                                   |
+| `installUiRuntimeGuards()`                       | 安装主题锁与普通表格长文本包级保护                 |
+| `installOverflowTooltipGuard()`                  | 单独安装真实溢出 Tooltip 兜底                      |
 | `setDictResolver(fn)`                            | 解耦动态字典查询                                   |
 | `createPreset(config)` / `installPreset(config)` | 自定义 preset 工厂                                 |
 
+长文本兜底的接入方式、排除边界和验收方法见
+[表格长文本包级兜底机制](docs/table-overflow-tooltip.md)。
+
 ---
 
 ## 设计令牌

package/bin/wl-ui.js

@@ -573,7 +573,8 @@ ${
      installCommonPreset();
 `
     : `
-  ℹ️  skin 模式不需要引入 runtime，页面布局 / 业务代码均保持现状。
+  ⚠️  请手动在 src/main.ts 添加包级保护（不接管页面布局 / 业务列定义）：
+     import '@agile-team/wl-skills-ui/runtime/auto';
 `
 }`);
 }

package/docs/compat-matrix.md

@@ -11,7 +11,7 @@
 | `element-plus` | **`2.2.6-prod.3`** | 集团 jh- 定制版，搭配 `@jhlc/jh-ui` 使用，DOM 仍为 `.el-input > .el-input__inner` 直挂结构（**EP 2.3.0 起才引入 `.el-input__wrapper`**） |
 | `@jhlc/jh-ui` | **`3.1.0`** | SCSS 皮肤包，`.com-text` label 包裹、`.has-colon ::after` 冒号注入、`.el-form-item--default { margin-bottom: 24px }` 等强约束 |
 | `@jhlc/common-core` | `3.1.0` 或 `3.1.0-prod.x` | 基础 util/types，`@jhlc/jh-ui` 间接依赖 |
-| `@agile-team/wl-skills-ui` | `^1.9.8` | 已对齐 jh-ui 3.1.0 + EP 2.2.6-prod.3 的 DOM 假设、客户主题锁、6px 基础圆角、紧凑表单、分裂按钮、长文本提示、定制页样式边界与 Vite 4 开发转换 |
+| `@agile-team/wl-skills-ui` | `^1.9.10` | 已对齐 jh-ui 3.1.0 + EP 2.2.6-prod.3 的 DOM 假设、客户主题锁、6px 基础圆角、紧凑表单、表格行状态、分裂按钮、包级长文本提示、定制页样式边界与 Vite 4 开发转换 |
 
 ## 项目集群当前实测
 
@@ -35,7 +35,8 @@
 
 ## 适配建议
 
-- 集团内项目：**统一锚定 `element-plus@2.2.6-prod.3` + `@jhlc/jh-ui@3.1.0`**，与 wl-skills-ui v1.9.8 三方对齐。
+- 集团内项目：**统一锚定 `element-plus@2.2.6-prod.3` + `@jhlc/jh-ui@3.1.0`**，与 wl-skills-ui v1.9.10 三方对齐。
+- Skin 项目除全局样式外，在 `main.ts` 引入一次 `@agile-team/wl-skills-ui/runtime/auto`；Native 项目的 `installCommonPreset()` 已包含相同包级保护，不要重复安装。
 - 升级 `element-plus` 到 2.3+ 前，必须同步升级 `@jhlc/jh-ui` 到对应支持版本，否则 `.com-text` / `.el-input__inner` DOM 与 EP `__wrapper` 体系不兼容。
 - 新项目接入：见 README 「快速接入」章节，默认会按本表声明 peerDependency 范围。
 

package/docs/table-overflow-tooltip.md

@@ -0,0 +1,66 @@
+# 表格长文本包级兜底机制
+
+## 目标
+
+凡完整接入 `@agile-team/wl-skills-ui` 的普通 Element Table、BaseTable 与 AG Grid，普通文本单元格在空间不足时统一单行省略；鼠标悬停或键盘聚焦后显示完整文本。业务页面不需要逐列补丁，也不依赖列定义是否经过 `defineColumns()`。
+
+该能力只治理普通文本。Tag、操作按钮、编辑控件、复选框、自定义 renderer 和主动换行内容保留业务组件自身行为。
+
+## 接入
+
+Native 项目调用 `installCommonPreset()` 时会自动安装包级保护：
+
+```ts
+import { installCommonPreset } from "@agile-team/wl-skills-ui/runtime/common-preset";
+
+installCommonPreset();
+```
+
+Skin/老项目在保留 `skin` 样式入口的同时，在启动文件引入一次自动入口：
+
+```ts
+import "@agile-team/wl-skills-ui/runtime/auto";
+```
+
+不要同时重复调用 `installCommonPreset()` 和引入 `runtime/auto`。内部安装函数具备幂等保护，但项目应保留单一、清晰的启动入口。
+
+## 工作机制
+
+1. 样式层只对没有子元素的普通纯文本单元格修正单行省略，解决 AG Grid 同一节点同时为 flex 容器时省略号不绘制的问题。
+2. Runtime 在 `document` 上使用事件委托，不扫描整页，也不使用 `MutationObserver` 监听表格结构。
+3. 用户悬停或键盘聚焦后才计算 `scrollWidth > clientWidth`；没有真实溢出时不创建 Tooltip。
+4. Element/AG Grid 已有 Tooltip、`title` 或 `aria-describedby` 时由原组件优先处理，兜底不会重复弹出。
+5. 动态行、Picker 与虚拟滚动复用相同事件入口，新插入的单元格不需要重新注册。
+
+## 防污染边界
+
+以下内容默认排除：
+
+- `.editable-cell`、`.always-editable-cell`、`.ag-cell-inline-editing` 等编辑单元格；
+- `.operations-cell`、`.default-slot-cell`、`.ag-cell-wrap-text`；
+- input、textarea、select、button、Tag、Link、Checkbox、Radio、Switch、日期和数字输入；
+- Element Table 已带 `.el-tooltip` 的原生溢出提示列；
+- `.lp-root`、`.session-login`、`.wl-ui-skin-exempt`、`data-wl-ui-skin="off"` 定制区域。
+
+局部显式退出：
+
+```html
+<div data-wl-ui-overflow="off">保持业务自身长文本行为</div>
+```
+
+自定义纯文本 renderer 确认需要包级提示时，可在实际文本单元格上标记：
+
+```html
+<div data-wl-ui-overflow="on">自定义但仍按普通文本处理</div>
+```
+
+## 验收
+
+- 短文本：无省略号、无兜底 Tooltip。
+- 长文本：单行省略，悬停或键盘聚焦显示完整内容。
+- 选中行/hover 行：省略和 Tooltip 不受行状态底色影响。
+- 动态/虚拟行：滚动复用 DOM 后仍然有效。
+- 操作列、Tag、编辑态、自定义 renderer：布局与交互保持原样。
+- 登录页和显式豁免区域：不增加任何长文本接管行为。
+
+自动回归测试位于 `scanner/__tests__/overflow-tooltip.test.mjs`；发布前 `npm run verify` 会同时执行 DOM 行为、SCSS 实际编译、构建与包导出检查。

package/es/auto.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/es/auto.js

@@ -0,0 +1,5 @@
+import { installUiRuntimeGuards } from './chunk-Z2OTWMW6.js';
+import './chunk-Q3N5QNRZ.js';
+
+// runtime/auto.ts
+installUiRuntimeGuards();

package/es/{chunk-XDGTJ7LE.js → chunk-4IOYRBW4.js}

@@ -328,132 +328,4 @@ registerColumnAutoMaps({
   }
 });
 
-// runtime/theme-lock.ts
-var BRAND_THEME_TOKENS = Object.freeze({
-  "--el-color-primary": "#002a8f",
-  "--el-color-primary-rgb": "0, 42, 143",
-  "--el-color-primary-light-1": "#1a3f9a",
-  "--el-color-primary-light-2": "#3355a5",
-  "--el-color-primary-light-3": "#4d6ab1",
-  "--el-color-primary-light-4": "#667fbc",
-  "--el-color-primary-light-5": "#8094c7",
-  "--el-color-primary-light-6": "#99aad2",
-  "--el-color-primary-light-7": "#b2bfdd",
-  "--el-color-primary-light-8": "#ccd4e9",
-  "--el-color-primary-light-9": "#e5eaf4",
-  "--el-color-primary-dark-1": "#002681",
-  "--el-color-primary-dark-2": "#002272",
-  "--el-color-primary-dark-3": "#001d64",
-  "--el-color-primary-dark-4": "#001956",
-  "--el-color-success": "#2bb268",
-  "--el-color-success-light-1": "#40ba77",
-  "--el-color-success-light-2": "#55c286",
-  "--el-color-success-light-3": "#6bcb95",
-  "--el-color-success-light-4": "#80d3a4",
-  "--el-color-success-light-5": "#95dbb4",
-  "--el-color-success-light-6": "#aae3c3",
-  "--el-color-success-light-7": "#bfebd2",
-  "--el-color-success-light-8": "#d5f4e1",
-  "--el-color-success-light-9": "#eaf9f0",
-  "--el-color-success-dark-1": "#229051",
-  "--el-color-success-dark-2": "#1b733f",
-  "--el-color-success-dark-3": "#14562f",
-  "--el-color-success-dark-4": "#0d3a20",
-  "--el-color-warning": "#ea9a13",
-  "--el-color-warning-light-1": "#eca42b",
-  "--el-color-warning-light-2": "#efae42",
-  "--el-color-warning-light-3": "#f1b85a",
-  "--el-color-warning-light-4": "#f3c171",
-  "--el-color-warning-light-5": "#f5cb89",
-  "--el-color-warning-light-6": "#f7d5a1",
-  "--el-color-warning-light-7": "#f9dfb8",
-  "--el-color-warning-light-8": "#fce8d0",
-  "--el-color-warning-light-9": "#fef2e7",
-  "--el-color-warning-dark-1": "#c47f0e",
-  "--el-color-warning-dark-2": "#9d650a",
-  "--el-color-warning-dark-3": "#754a07",
-  "--el-color-warning-dark-4": "#4e3004",
-  "--el-color-danger": "#bb2d3f",
-  "--el-color-danger-light-1": "#c34253",
-  "--el-color-danger-light-2": "#ca5766",
-  "--el-color-danger-light-3": "#d16b78",
-  "--el-color-danger-light-4": "#d8808b",
-  "--el-color-danger-light-5": "#dd969f",
-  "--el-color-danger-light-6": "#e4abb2",
-  "--el-color-danger-light-7": "#e8c0c5",
-  "--el-color-danger-light-8": "#f0d5d9",
-  "--el-color-danger-light-9": "#f7eaec",
-  "--el-color-danger-dark-1": "#962433",
-  "--el-color-danger-dark-2": "#711b26",
-  "--el-color-danger-dark-3": "#4b1219",
-  "--el-color-danger-dark-4": "#26090d",
-  "--el-color-error": "#bb2d3f",
-  "--el-color-error-light-1": "#c34253",
-  "--el-color-error-light-2": "#ca5766",
-  "--el-color-error-light-3": "#d16b78",
-  "--el-color-error-light-4": "#d8808b",
-  "--el-color-error-light-5": "#dd969f",
-  "--el-color-error-light-6": "#e4abb2",
-  "--el-color-error-light-7": "#e8c0c5",
-  "--el-color-error-light-8": "#f0d5d9",
-  "--el-color-error-light-9": "#f7eaec",
-  "--el-color-error-dark-1": "#962433",
-  "--el-color-error-dark-2": "#711b26",
-  "--el-color-error-dark-3": "#4b1219",
-  "--el-color-error-dark-4": "#26090d",
-  "--el-border-radius-base": "6px",
-  "--el-border-radius-small": "2px",
-  "--el-border-radius-round": "20px",
-  "--el-border-radius-circle": "100%"
-});
-var observer;
-var waitingForBody = false;
-function enforceOn(target) {
-  if (!target) return;
-  for (const [name, value] of Object.entries(BRAND_THEME_TOKENS)) {
-    if (target.style.getPropertyValue(name).trim().toLowerCase() !== value || target.style.getPropertyPriority(name) !== "important") {
-      target.style.setProperty(name, value, "important");
-    }
-  }
-}
-function bindObserver() {
-  if (typeof document === "undefined") return;
-  enforceOn(document.documentElement);
-  enforceOn(document.body);
-  if (typeof MutationObserver === "undefined") return;
-  observer ?? (observer = new MutationObserver((mutations) => {
-    const bodyChanged = mutations.some((mutation) => mutation.type === "childList");
-    enforceOn(document.documentElement);
-    enforceOn(document.body);
-    if (bodyChanged) bindObserver();
-  }));
-  observer.disconnect();
-  observer.observe(document.documentElement, {
-    attributes: true,
-    attributeFilter: ["style"],
-    childList: true
-  });
-  if (document.body) {
-    observer.observe(document.body, {
-      attributes: true,
-      attributeFilter: ["style"]
-    });
-  }
-}
-function installBrandThemeLock() {
-  if (typeof document === "undefined") return;
-  bindObserver();
-  if (!document.body && !waitingForBody) {
-    waitingForBody = true;
-    document.addEventListener(
-      "DOMContentLoaded",
-      () => {
-        waitingForBody = false;
-        bindObserver();
-      },
-      { once: true }
-    );
-  }
-}
-
-export { AUDIT_STATUS_MAP, BRAND_THEME_TOKENS, ENABLE_STATUS_MAP, RATING_LEVEL_COLORS, VERIFY_STATUS_MAP, clearColumnAutoMap, defineColumns, getColumnAutoMap, installBrandThemeLock, registerColumnAutoMap, registerColumnAutoMaps, registerDictColorMap, registerDictColorMaps, renderAuditStatus, renderBadge, renderClassifyTag, renderCountBadge, renderDangerText, renderDictClassifyTag, renderEnableStatus, renderOps, renderRatingLevel, renderTagNode, renderTagSlot, renderVerifyStatus, setDictResolver };
+export { AUDIT_STATUS_MAP, ENABLE_STATUS_MAP, RATING_LEVEL_COLORS, VERIFY_STATUS_MAP, clearColumnAutoMap, defineColumns, getColumnAutoMap, registerColumnAutoMap, registerColumnAutoMaps, registerDictColorMap, registerDictColorMaps, renderAuditStatus, renderBadge, renderClassifyTag, renderCountBadge, renderDangerText, renderDictClassifyTag, renderEnableStatus, renderOps, renderRatingLevel, renderTagNode, renderTagSlot, renderVerifyStatus, setDictResolver };

package/es/chunk-Q3N5QNRZ.js

@@ -0,0 +1,129 @@
+// runtime/theme-lock.ts
+var BRAND_THEME_TOKENS = Object.freeze({
+  "--el-color-primary": "#002a8f",
+  "--el-color-primary-rgb": "0, 42, 143",
+  "--el-color-primary-light-1": "#1a3f9a",
+  "--el-color-primary-light-2": "#3355a5",
+  "--el-color-primary-light-3": "#4d6ab1",
+  "--el-color-primary-light-4": "#667fbc",
+  "--el-color-primary-light-5": "#8094c7",
+  "--el-color-primary-light-6": "#99aad2",
+  "--el-color-primary-light-7": "#b2bfdd",
+  "--el-color-primary-light-8": "#ccd4e9",
+  "--el-color-primary-light-9": "#e5eaf4",
+  "--el-color-primary-dark-1": "#002681",
+  "--el-color-primary-dark-2": "#002272",
+  "--el-color-primary-dark-3": "#001d64",
+  "--el-color-primary-dark-4": "#001956",
+  "--el-color-success": "#2bb268",
+  "--el-color-success-light-1": "#40ba77",
+  "--el-color-success-light-2": "#55c286",
+  "--el-color-success-light-3": "#6bcb95",
+  "--el-color-success-light-4": "#80d3a4",
+  "--el-color-success-light-5": "#95dbb4",
+  "--el-color-success-light-6": "#aae3c3",
+  "--el-color-success-light-7": "#bfebd2",
+  "--el-color-success-light-8": "#d5f4e1",
+  "--el-color-success-light-9": "#eaf9f0",
+  "--el-color-success-dark-1": "#229051",
+  "--el-color-success-dark-2": "#1b733f",
+  "--el-color-success-dark-3": "#14562f",
+  "--el-color-success-dark-4": "#0d3a20",
+  "--el-color-warning": "#ea9a13",
+  "--el-color-warning-light-1": "#eca42b",
+  "--el-color-warning-light-2": "#efae42",
+  "--el-color-warning-light-3": "#f1b85a",
+  "--el-color-warning-light-4": "#f3c171",
+  "--el-color-warning-light-5": "#f5cb89",
+  "--el-color-warning-light-6": "#f7d5a1",
+  "--el-color-warning-light-7": "#f9dfb8",
+  "--el-color-warning-light-8": "#fce8d0",
+  "--el-color-warning-light-9": "#fef2e7",
+  "--el-color-warning-dark-1": "#c47f0e",
+  "--el-color-warning-dark-2": "#9d650a",
+  "--el-color-warning-dark-3": "#754a07",
+  "--el-color-warning-dark-4": "#4e3004",
+  "--el-color-danger": "#bb2d3f",
+  "--el-color-danger-light-1": "#c34253",
+  "--el-color-danger-light-2": "#ca5766",
+  "--el-color-danger-light-3": "#d16b78",
+  "--el-color-danger-light-4": "#d8808b",
+  "--el-color-danger-light-5": "#dd969f",
+  "--el-color-danger-light-6": "#e4abb2",
+  "--el-color-danger-light-7": "#e8c0c5",
+  "--el-color-danger-light-8": "#f0d5d9",
+  "--el-color-danger-light-9": "#f7eaec",
+  "--el-color-danger-dark-1": "#962433",
+  "--el-color-danger-dark-2": "#711b26",
+  "--el-color-danger-dark-3": "#4b1219",
+  "--el-color-danger-dark-4": "#26090d",
+  "--el-color-error": "#bb2d3f",
+  "--el-color-error-light-1": "#c34253",
+  "--el-color-error-light-2": "#ca5766",
+  "--el-color-error-light-3": "#d16b78",
+  "--el-color-error-light-4": "#d8808b",
+  "--el-color-error-light-5": "#dd969f",
+  "--el-color-error-light-6": "#e4abb2",
+  "--el-color-error-light-7": "#e8c0c5",
+  "--el-color-error-light-8": "#f0d5d9",
+  "--el-color-error-light-9": "#f7eaec",
+  "--el-color-error-dark-1": "#962433",
+  "--el-color-error-dark-2": "#711b26",
+  "--el-color-error-dark-3": "#4b1219",
+  "--el-color-error-dark-4": "#26090d",
+  "--el-border-radius-base": "6px",
+  "--el-border-radius-small": "2px",
+  "--el-border-radius-round": "20px",
+  "--el-border-radius-circle": "100%"
+});
+var observer;
+var waitingForBody = false;
+function enforceOn(target) {
+  if (!target) return;
+  for (const [name, value] of Object.entries(BRAND_THEME_TOKENS)) {
+    if (target.style.getPropertyValue(name).trim().toLowerCase() !== value || target.style.getPropertyPriority(name) !== "important") {
+      target.style.setProperty(name, value, "important");
+    }
+  }
+}
+function bindObserver() {
+  if (typeof document === "undefined") return;
+  enforceOn(document.documentElement);
+  enforceOn(document.body);
+  if (typeof MutationObserver === "undefined") return;
+  observer ?? (observer = new MutationObserver((mutations) => {
+    const bodyChanged = mutations.some((mutation) => mutation.type === "childList");
+    enforceOn(document.documentElement);
+    enforceOn(document.body);
+    if (bodyChanged) bindObserver();
+  }));
+  observer.disconnect();
+  observer.observe(document.documentElement, {
+    attributes: true,
+    attributeFilter: ["style"],
+    childList: true
+  });
+  if (document.body) {
+    observer.observe(document.body, {
+      attributes: true,
+      attributeFilter: ["style"]
+    });
+  }
+}
+function installBrandThemeLock() {
+  if (typeof document === "undefined") return;
+  bindObserver();
+  if (!document.body && !waitingForBody) {
+    waitingForBody = true;
+    document.addEventListener(
+      "DOMContentLoaded",
+      () => {
+        waitingForBody = false;
+        bindObserver();
+      },
+      { once: true }
+    );
+  }
+}
+
+export { BRAND_THEME_TOKENS, installBrandThemeLock };

package/es/chunk-Z2OTWMW6.js

@@ -0,0 +1,241 @@
+import { installBrandThemeLock } from './chunk-Q3N5QNRZ.js';
+
+// runtime/overflow-tooltip.ts
+var MANAGED_CELL_SELECTOR = ".ag-root-wrapper .ag-cell-value, .el-table__body .cell";
+var EXEMPT_ROOT_SELECTOR = ".lp-root, .session-login, .wl-ui-skin-exempt, [data-wl-ui-skin='off']";
+var OVERFLOW_OFF_SELECTOR = ".wl-ui-overflow-ignore, [data-wl-ui-overflow='off']";
+var INTERACTIVE_CONTENT_SELECTOR = [
+  "input",
+  "textarea",
+  "select",
+  "button",
+  "[contenteditable='true']",
+  ".el-input",
+  ".el-textarea",
+  ".el-select",
+  ".el-input-number",
+  ".el-date-editor",
+  ".el-button",
+  ".el-link",
+  ".el-tag",
+  ".el-checkbox",
+  ".el-radio",
+  ".el-switch",
+  ".ag-checkbox",
+  ".ag-cell-editor"
+].join(", ");
+var EXCLUDED_AG_CELL_SELECTOR = [
+  ".editable-cell",
+  ".always-editable-cell",
+  ".default-slot-cell",
+  ".operations-cell",
+  ".ag-cell-inline-editing",
+  ".ag-cell-wrap-text",
+  ".ag-checkbox-cell"
+].join(", ");
+var COMPONENT_TOOLTIP_SELECTOR = ".ag-tooltip, .el-popper[role='tooltip'], .el-tooltip__popper";
+var TOOLTIP_ID = "wl-ui-overflow-tooltip";
+var DEFAULT_OPTIONS = {
+  showDelay: 220,
+  agGridShowDelay: 900
+};
+var installedDocument;
+var installedOptions = DEFAULT_OPTIONS;
+var pendingCell;
+var visibleCell;
+var showTimer;
+var tooltipElement;
+var previousDescribedBy = null;
+function asElement(target) {
+  if (!target || typeof target.closest !== "function") return null;
+  return target;
+}
+function isPlainTextCell(cell) {
+  if (cell.dataset.wlUiOverflow === "on") return true;
+  return cell.childElementCount === 0;
+}
+function resolveManagedCell(target) {
+  const element = asElement(target);
+  const cell = element?.closest(MANAGED_CELL_SELECTOR);
+  if (!cell || !cell.isConnected) return null;
+  if (cell.closest(EXEMPT_ROOT_SELECTOR)) return null;
+  if (cell.closest(OVERFLOW_OFF_SELECTOR)) return null;
+  if (cell.matches(EXCLUDED_AG_CELL_SELECTOR)) return null;
+  if (cell.matches(".el-tooltip") || cell.querySelector(INTERACTIVE_CONTENT_SELECTOR)) {
+    return null;
+  }
+  return isPlainTextCell(cell) ? cell : null;
+}
+function hasHorizontalOverflow(cell) {
+  return cell.scrollWidth - cell.clientWidth > 1;
+}
+function getCellText(cell) {
+  return (cell.textContent ?? "").replace(/\s+/g, " ").trim();
+}
+function hasDeclaredTooltip(cell) {
+  return Boolean(
+    cell.getAttribute("title")?.trim() || cell.getAttribute("aria-describedby")?.trim() || cell.dataset.tooltip?.trim()
+  );
+}
+function hasVisibleComponentTooltip(doc) {
+  const view = doc.defaultView;
+  const componentTooltips = Array.from(
+    doc.querySelectorAll(COMPONENT_TOOLTIP_SELECTOR)
+  );
+  for (const element of componentTooltips) {
+    if (element.id === TOOLTIP_ID || element.hidden) continue;
+    if (element.getAttribute("aria-hidden") === "true") continue;
+    if (!view) return true;
+    const style = view.getComputedStyle(element);
+    if (style.display !== "none" && style.visibility !== "hidden" && style.opacity !== "0") {
+      return true;
+    }
+  }
+  return false;
+}
+function ensureTooltip(doc) {
+  if (tooltipElement?.isConnected) return tooltipElement;
+  if (!doc.body) return null;
+  const tooltip = doc.createElement("div");
+  tooltip.id = TOOLTIP_ID;
+  tooltip.className = "wl-ui-overflow-tooltip";
+  tooltip.setAttribute("role", "tooltip");
+  tooltip.hidden = true;
+  doc.body.append(tooltip);
+  tooltipElement = tooltip;
+  return tooltip;
+}
+function positionTooltip(cell, tooltip) {
+  const doc = cell.ownerDocument;
+  const view = doc.defaultView;
+  const viewportWidth = view?.innerWidth ?? doc.documentElement.clientWidth;
+  const viewportHeight = view?.innerHeight ?? doc.documentElement.clientHeight;
+  const cellRect = cell.getBoundingClientRect();
+  const tooltipRect = tooltip.getBoundingClientRect();
+  const gap = 8;
+  const edge = 12;
+  const maxLeft = Math.max(edge, viewportWidth - tooltipRect.width - edge);
+  const centeredLeft = cellRect.left + cellRect.width / 2 - tooltipRect.width / 2;
+  const left = Math.min(Math.max(edge, centeredLeft), maxLeft);
+  const above = cellRect.top - tooltipRect.height - gap;
+  const below = Math.min(
+    viewportHeight - tooltipRect.height - edge,
+    cellRect.bottom + gap
+  );
+  tooltip.style.left = `${Math.round(left)}px`;
+  tooltip.style.top = `${Math.round(above >= edge ? above : below)}px`;
+}
+function restoreDescribedBy() {
+  if (!visibleCell) return;
+  if (previousDescribedBy === null) visibleCell.removeAttribute("aria-describedby");
+  else visibleCell.setAttribute("aria-describedby", previousDescribedBy);
+  visibleCell.removeAttribute("data-wl-ui-overflow-active");
+  previousDescribedBy = null;
+}
+function hideTooltip() {
+  if (showTimer) clearTimeout(showTimer);
+  showTimer = void 0;
+  pendingCell = void 0;
+  restoreDescribedBy();
+  visibleCell = void 0;
+  if (!tooltipElement) return;
+  tooltipElement.classList.remove("is-visible");
+  tooltipElement.hidden = true;
+  tooltipElement.textContent = "";
+}
+function revealTooltip(cell) {
+  const doc = cell.ownerDocument;
+  pendingCell = void 0;
+  showTimer = void 0;
+  if (!cell.isConnected || !hasHorizontalOverflow(cell)) return;
+  if (hasDeclaredTooltip(cell) || hasVisibleComponentTooltip(doc)) return;
+  const text = getCellText(cell);
+  if (!text) return;
+  const tooltip = ensureTooltip(doc);
+  if (!tooltip) return;
+  tooltip.textContent = text;
+  tooltip.hidden = false;
+  previousDescribedBy = cell.getAttribute("aria-describedby");
+  cell.setAttribute("aria-describedby", TOOLTIP_ID);
+  cell.setAttribute("data-wl-ui-overflow-active", "true");
+  visibleCell = cell;
+  positionTooltip(cell, tooltip);
+  tooltip.classList.add("is-visible");
+}
+function scheduleTooltip(cell, keyboard = false) {
+  hideTooltip();
+  if (!hasHorizontalOverflow(cell) || hasDeclaredTooltip(cell)) return;
+  pendingCell = cell;
+  const delay = keyboard ? 0 : cell.matches(".ag-cell-value") ? installedOptions.agGridShowDelay : installedOptions.showDelay;
+  showTimer = setTimeout(() => {
+    if (pendingCell === cell) revealTooltip(cell);
+  }, delay);
+}
+function onPointerOver(event) {
+  const cell = resolveManagedCell(event.target);
+  if (!cell || cell === pendingCell || cell === visibleCell) return;
+  scheduleTooltip(cell);
+}
+function onPointerOut(event) {
+  const pointerEvent = event;
+  const fromCell = resolveManagedCell(event.target);
+  if (!fromCell) return;
+  const toCell = resolveManagedCell(pointerEvent.relatedTarget);
+  if (toCell === fromCell) return;
+  if (fromCell === pendingCell || fromCell === visibleCell) hideTooltip();
+}
+function onFocusIn(event) {
+  const cell = resolveManagedCell(event.target);
+  if (cell) scheduleTooltip(cell, true);
+}
+function onFocusOut(event) {
+  const fromCell = resolveManagedCell(event.target);
+  if (fromCell === pendingCell || fromCell === visibleCell) hideTooltip();
+}
+function onKeyDown(event) {
+  if (event.key === "Escape") hideTooltip();
+}
+function bindDocument(doc) {
+  doc.addEventListener("pointerover", onPointerOver);
+  doc.addEventListener("pointerout", onPointerOut);
+  doc.addEventListener("focusin", onFocusIn);
+  doc.addEventListener("focusout", onFocusOut);
+  doc.addEventListener("keydown", onKeyDown);
+  doc.addEventListener("pointerdown", hideTooltip);
+  doc.addEventListener("scroll", hideTooltip, true);
+  doc.defaultView?.addEventListener("resize", hideTooltip);
+}
+function unbindDocument(doc) {
+  doc.removeEventListener("pointerover", onPointerOver);
+  doc.removeEventListener("pointerout", onPointerOut);
+  doc.removeEventListener("focusin", onFocusIn);
+  doc.removeEventListener("focusout", onFocusOut);
+  doc.removeEventListener("keydown", onKeyDown);
+  doc.removeEventListener("pointerdown", hideTooltip);
+  doc.removeEventListener("scroll", hideTooltip, true);
+  doc.defaultView?.removeEventListener("resize", hideTooltip);
+}
+function installOverflowTooltipGuard(options = {}) {
+  if (typeof document === "undefined") return;
+  if (installedDocument === document) return;
+  if (installedDocument) unbindDocument(installedDocument);
+  installedOptions = { ...DEFAULT_OPTIONS, ...options };
+  installedDocument = document;
+  bindDocument(document);
+}
+function uninstallOverflowTooltipGuard() {
+  if (installedDocument) unbindDocument(installedDocument);
+  hideTooltip();
+  tooltipElement?.remove();
+  tooltipElement = void 0;
+  installedDocument = void 0;
+  installedOptions = DEFAULT_OPTIONS;
+}
+
+// runtime/guards.ts
+function installUiRuntimeGuards() {
+  installBrandThemeLock();
+  installOverflowTooltipGuard();
+}
+
+export { installOverflowTooltipGuard, installUiRuntimeGuards, uninstallOverflowTooltipGuard };

package/es/common-preset.d.ts

@@ -1,7 +1,7 @@
 import * as vue from 'vue';
 import { VNode } from 'vue';
-import { T as TagMapItem, J as JhTagNode } from './types-QZ1gy9KX.js';
-export { r as registerDictColorMap, a as registerDictColorMaps, g as renderDictClassifyTag, s as setDictResolver } from './renderers-BFRSp2BH.js';
+import { T as TagMapItem, J as JhTagNode } from './types-Dnh4U0hw.js';
+export { r as registerDictColorMap, a as registerDictColorMaps, b as renderDictClassifyTag, s as setDictResolver } from './renderers-B3uUAze8.js';
 
 declare const RISK_LEVEL_MAP: Record<string | number, TagMapItem>;
 declare const renderRiskLevel: (v: string | number | null | undefined) => JhTagNode | null;

package/es/common-preset.js

@@ -1,5 +1,7 @@
-import { renderTagNode, renderClassifyTag, installBrandThemeLock, registerColumnAutoMaps, renderRatingLevel, renderBadge } from './chunk-XDGTJ7LE.js';
-export { registerDictColorMap, registerDictColorMaps, renderDictClassifyTag, setDictResolver } from './chunk-XDGTJ7LE.js';
+import { installUiRuntimeGuards } from './chunk-Z2OTWMW6.js';
+import { renderTagNode, renderClassifyTag, registerColumnAutoMaps, renderRatingLevel, renderBadge } from './chunk-4IOYRBW4.js';
+export { registerDictColorMap, registerDictColorMaps, renderDictClassifyTag, setDictResolver } from './chunk-4IOYRBW4.js';
+import './chunk-Q3N5QNRZ.js';
 
 // runtime/presets/common.ts
 var RISK_LEVEL_MAP = {
@@ -94,7 +96,7 @@ var DRILL_TYPE_COLOR_MAP = {
   "2": "warning"
 };
 function installCommonPreset() {
-  installBrandThemeLock();
+  installUiRuntimeGuards();
   registerColumnAutoMaps({
     riskLevel: {
       width: 90,

package/es/index.d.ts

@@ -1,6 +1,6 @@
-import { C as ColumnLike } from './types-QZ1gy9KX.js';
-export { E as ElTagType, J as JhTagNode, O as OpChip, a as OpItem, b as OpLink, c as OpPreset, T as TagMapItem } from './types-QZ1gy9KX.js';
-export { A as AUDIT_STATUS_MAP, E as ENABLE_STATUS_MAP, R as RATING_LEVEL_COLORS, V as VERIFY_STATUS_MAP, r as registerDictColorMap, a as registerDictColorMaps, b as renderAuditStatus, c as renderBadge, d as renderClassifyTag, e as renderCountBadge, f as renderDangerText, g as renderDictClassifyTag, h as renderEnableStatus, i as renderOps, j as renderRatingLevel, k as renderTagNode, l as renderTagSlot, m as renderVerifyStatus, s as setDictResolver } from './renderers-BFRSp2BH.js';
+import { C as ColumnLike } from './types-Dnh4U0hw.js';
+export { E as ElTagType, J as JhTagNode, a as OpChip, O as OpItem, b as OpLink, c as OpPreset, T as TagMapItem } from './types-Dnh4U0hw.js';
+export { A as AUDIT_STATUS_MAP, E as ENABLE_STATUS_MAP, R as RATING_LEVEL_COLORS, V as VERIFY_STATUS_MAP, r as registerDictColorMap, a as registerDictColorMaps, c as renderAuditStatus, d as renderBadge, e as renderClassifyTag, f as renderCountBadge, g as renderDangerText, b as renderDictClassifyTag, h as renderEnableStatus, i as renderOps, j as renderRatingLevel, k as renderTagNode, l as renderTagSlot, m as renderVerifyStatus, s as setDictResolver } from './renderers-B3uUAze8.js';
 import 'vue';
 
 /**
@@ -160,4 +160,30 @@ declare const BRAND_THEME_TOKENS: Readonly<{
  */
 declare function installBrandThemeLock(): void;
 
-export { BRAND_THEME_TOKENS, ColumnLike, type PresetConfig, clearColumnAutoMap, createPreset, defineColumns, getColumnAutoMap, getInstalledPresets, installBrandThemeLock, installPreset, registerColumnAutoMap, registerColumnAutoMaps };
+/**
+ * 普通表格长文本兜底。
+ *
+ * CSS 负责绘制省略号；本模块只在用户悬停或键盘聚焦时按需判断真实溢出，
+ * 并为未启用组件原生 tooltip 的普通文本单元格提供完整内容提示。
+ * 动态行和虚拟滚动通过事件委托自然覆盖，不需要 MutationObserver。
+ */
+interface OverflowTooltipGuardOptions {
+    /** 普通 Element Table 单元格的悬停延迟。 */
+    showDelay?: number;
+    /**
+     * AG Grid 兜底延迟。默认略晚于平台的 800ms 原生 tooltip，避免重复提示。
+     */
+    agGridShowDelay?: number;
+}
+/** 安装普通表格长文本兜底。重复调用安全，SSR 环境自动跳过。 */
+declare function installOverflowTooltipGuard(options?: OverflowTooltipGuardOptions): void;
+/** 卸载兜底监听，主要供微前端销毁和回归测试使用。 */
+declare function uninstallOverflowTooltipGuard(): void;
+
+/**
+ * 安装不依赖业务页面写法的包级运行时保护。
+ * 包含客户主题锁与普通表格长文本溢出提示兜底；重复调用安全。
+ */
+declare function installUiRuntimeGuards(): void;
+
+export { BRAND_THEME_TOKENS, ColumnLike, type OverflowTooltipGuardOptions, type PresetConfig, clearColumnAutoMap, createPreset, defineColumns, getColumnAutoMap, getInstalledPresets, installBrandThemeLock, installOverflowTooltipGuard, installPreset, installUiRuntimeGuards, registerColumnAutoMap, registerColumnAutoMaps, uninstallOverflowTooltipGuard };

package/es/index.js

@@ -1,5 +1,7 @@
-import { registerColumnAutoMaps } from './chunk-XDGTJ7LE.js';
-export { AUDIT_STATUS_MAP, BRAND_THEME_TOKENS, ENABLE_STATUS_MAP, RATING_LEVEL_COLORS, VERIFY_STATUS_MAP, clearColumnAutoMap, defineColumns, getColumnAutoMap, installBrandThemeLock, registerColumnAutoMap, registerColumnAutoMaps, registerDictColorMap, registerDictColorMaps, renderAuditStatus, renderBadge, renderClassifyTag, renderCountBadge, renderDangerText, renderDictClassifyTag, renderEnableStatus, renderOps, renderRatingLevel, renderTagNode, renderTagSlot, renderVerifyStatus, setDictResolver } from './chunk-XDGTJ7LE.js';
+export { installOverflowTooltipGuard, installUiRuntimeGuards, uninstallOverflowTooltipGuard } from './chunk-Z2OTWMW6.js';
+import { registerColumnAutoMaps } from './chunk-4IOYRBW4.js';
+export { AUDIT_STATUS_MAP, ENABLE_STATUS_MAP, RATING_LEVEL_COLORS, VERIFY_STATUS_MAP, clearColumnAutoMap, defineColumns, getColumnAutoMap, registerColumnAutoMap, registerColumnAutoMaps, registerDictColorMap, registerDictColorMaps, renderAuditStatus, renderBadge, renderClassifyTag, renderCountBadge, renderDangerText, renderDictClassifyTag, renderEnableStatus, renderOps, renderRatingLevel, renderTagNode, renderTagSlot, renderVerifyStatus, setDictResolver } from './chunk-4IOYRBW4.js';
+export { BRAND_THEME_TOKENS, installBrandThemeLock } from './chunk-Q3N5QNRZ.js';
 
 // runtime/presets/registry.ts
 var _installedPresets = /* @__PURE__ */ new Set();

package/es/presets/security.d.ts

@@ -1,4 +1,4 @@
-import { T as TagMapItem, J as JhTagNode } from '../types-QZ1gy9KX.js';
+import { T as TagMapItem, J as JhTagNode } from '../types-Dnh4U0hw.js';
 import 'vue';
 
 declare const VIOLATION_STATUS_MAP: Record<string | number, TagMapItem>;

package/es/presets/security.js

@@ -1,4 +1,5 @@
-import { renderTagNode, installBrandThemeLock, registerDictColorMaps, registerColumnAutoMaps } from '../chunk-XDGTJ7LE.js';
+import { renderTagNode, registerDictColorMaps, registerColumnAutoMaps } from '../chunk-4IOYRBW4.js';
+import { installBrandThemeLock } from '../chunk-Q3N5QNRZ.js';
 
 // runtime/presets/security.ts
 var VIOLATION_STATUS_MAP = {

package/es/{renderers-BFRSp2BH.d.ts → renderers-B3uUAze8.d.ts}

@@ -1,5 +1,5 @@
 import { VNode } from 'vue';
-import { T as TagMapItem, J as JhTagNode, a as OpItem } from './types-QZ1gy9KX.js';
+import { T as TagMapItem, J as JhTagNode, O as OpItem } from './types-Dnh4U0hw.js';
 
 /**
  * runtime/core/renderers.ts — 通用渲染器 + 通用状态映射
@@ -48,4 +48,4 @@ declare const renderVerifyStatus: (v: string | number | null | undefined) => JhT
 /** 渲染操作列按钮组（图标 + 胶囊 + 文字链接，自动 stopPropagation） */
 declare function renderOps(items: OpItem[]): VNode;
 
-export { AUDIT_STATUS_MAP as A, ENABLE_STATUS_MAP as E, RATING_LEVEL_COLORS as R, VERIFY_STATUS_MAP as V, registerDictColorMaps as a, renderAuditStatus as b, renderBadge as c, renderClassifyTag as d, renderCountBadge as e, renderDangerText as f, renderDictClassifyTag as g, renderEnableStatus as h, renderOps as i, renderRatingLevel as j, renderTagNode as k, renderTagSlot as l, renderVerifyStatus as m, registerDictColorMap as r, setDictResolver as s };
+export { AUDIT_STATUS_MAP as A, ENABLE_STATUS_MAP as E, RATING_LEVEL_COLORS as R, VERIFY_STATUS_MAP as V, registerDictColorMaps as a, renderDictClassifyTag as b, renderAuditStatus as c, renderBadge as d, renderClassifyTag as e, renderCountBadge as f, renderDangerText as g, renderEnableStatus as h, renderOps as i, renderRatingLevel as j, renderTagNode as k, renderTagSlot as l, renderVerifyStatus as m, registerDictColorMap as r, setDictResolver as s };

package/es/{types-QZ1gy9KX.d.ts → types-Dnh4U0hw.d.ts}

@@ -60,4 +60,4 @@ interface OpLink {
 }
 type OpItem = OpPreset | OpChip | OpLink;
 
-export type { ColumnLike as C, ElTagType as E, JhTagNode as J, OpChip as O, TagMapItem as T, OpItem as a, OpLink as b, OpPreset as c };
+export type { ColumnLike as C, ElTagType as E, JhTagNode as J, OpItem as O, TagMapItem as T, OpChip as a, OpLink as b, OpPreset as c };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/wl-skills-ui",
-  "version": "1.9.8",
+  "version": "1.9.10",
   "description": "企业级 UI 风格对齐框架 — Vue + Element Plus 项目通用化妆/原生双模式（tokens / element / vendors / layouts / runtime / scanner / fixer / skills）",
   "type": "module",
   "main": "./es/index.js",
@@ -14,6 +14,9 @@
       "import": "./es/index.js",
       "types": "./es/index.d.ts"
     },
+    "./runtime/auto": {
+      "import": "./es/auto.js"
+    },
     "./runtime/common-preset": {
       "import": "./es/common-preset.js",
       "types": "./es/common-preset.d.ts"
@@ -82,7 +85,8 @@
   ],
   "sideEffects": [
     "*.css",
-    "*.scss"
+    "*.scss",
+    "./es/auto.js"
   ],
   "devDependencies": {
     "@commitlint/cli": "^20.5.3",
@@ -96,8 +100,10 @@
     "element-plus": "^2.7.0",
     "eslint": "^10.3.0",
     "eslint-plugin-vue": "^10.9.0",
+    "happy-dom": "20.11.1",
     "husky": "^9.1.7",
     "lint-staged": "^16.4.0",
+    "sass": "1.77.8",
     "tsup": "^8.3.0",
     "typescript": "^5.4.0",
     "vue": "^3.4.0"

package/scanner/index.mjs

@@ -276,9 +276,10 @@ if (subcommand === "init") {
    @use '@agile-team/wl-skills-ui/styles' as *;
    // 化妆模式：@use '@agile-team/wl-skills-ui/styles/presets/skin' as *;
 
-4. 在 src/main.ts 中注册 runtime（可选，仅当业务侧用到 defineColumns）：
-   import { installCommonPreset } from '@agile-team/wl-skills-ui/runtime/common-preset';
-   installCommonPreset();
+4. 在 src/main.ts 中安装包级保护：
+   // Skin / 老项目：
+   import '@agile-team/wl-skills-ui/runtime/auto';
+   // Native 项目改为调用 installCommonPreset()，其已包含相同保护。
 
 5. 业务列定义改用 defineColumns：
    import { defineColumns, renderOps } from '@agile-team/wl-skills-ui/runtime';

package/scanner/integration.mjs

@@ -128,7 +128,7 @@ export function checkIntegration(projectRoot) {
       : "未发现 runtime 引入（无 src/util/ag-cell-renders.ts，main.ts 也未 import runtime）",
     suggestion: runtimeOk
       ? ""
-      : '推荐：在 main.ts 中 import { installCommonPreset } from "@agile-team/wl-skills-ui/runtime/common-preset"; installCommonPreset();',
+      : 'Skin 项目在 main.ts 中 import "@agile-team/wl-skills-ui/runtime/auto"；Native 项目调用 installCommonPreset()（已包含包级保护）。',
   });
 
   // ── I004: element-plus 已安装 ────────────────────────────────────────

package/scanner/rules/table.mjs

@@ -62,7 +62,7 @@ export const tableRules = [
             "table",
             "warning",
             "普通数据列缺少超长省略与悬停完整内容提示",
-            "添加 show-overflow-tooltip；BaseTable/AG Grid 列统一使用 defineColumns() 自动补齐",
+            "添加 show-overflow-tooltip；BaseTable/AG Grid 优先使用 defineColumns()，并在项目启动入口安装 runtime/auto 包级兜底",
           ),
         );
       }

package/skills/element/el-table/SKILL.md

@@ -66,6 +66,16 @@ BaseTable / AG Grid 使用 `defineColumns()` 后由 runtime 自动为普通文
 `showOverflowTooltip: true`。自定义渲染、结构列、换行列不强制；需要主动关闭时
 显式声明 `showOverflowTooltip: false`。
 
+Skin/历史项目还必须在启动入口引入一次
+`@agile-team/wl-skills-ui/runtime/auto`。它为未经过 `defineColumns()` 的动态
+Picker/BaseTable/AG Grid 普通文本提供真实溢出兜底；未溢出、已有 Tooltip、Tag、
+操作列、编辑列、自定义 renderer 与皮肤豁免区域均不接管。局部可使用
+`data-wl-ui-overflow="off"` 退出。
+
+行 hover/selected 色由包内表格 token 统一管理，业务页面不要重写
+`hover-row`、`current-row` 或直接覆盖 `td.el-table__cell` 背景，以免编辑控件、
+校验态和语义单元格底色发生冲突。
+
 ---
 
 ## 完整标准写法示例

package/skills/vendors/ag-grid/SKILL.md

@@ -13,8 +13,17 @@ applyTo: "**/*.{ts,vue}"
 2. 操作列统一用 `renderOps([...])` — 图标按钮系统，自动分隔线 + stopPropagation
 3. 状态字段用 `renderTagNode()` / `renderClassifyTag()` — 彩色 Tag，见 tag-status/SKILL.md
 
+Skin/历史项目必须在 `main.ts` 引入一次
+`@agile-team/wl-skills-ui/runtime/auto`。它修复普通纯文本 flex 单元格的省略号，
+并在未配置平台原生 Tooltip 且真实溢出时兜底完整内容。编辑列、操作列、Tag、
+复选框、自定义 renderer、主动换行列和皮肤豁免区域不会被接管。
+
 > 与 `wl-skills-kit` 协同说明：本 Skill 负责 AG Grid/列渲染/操作列 runtime 能力，也要服务非 kit 项目的通用 AG Grid 场景。若扫描发现项目希望升级为团队最佳实践，再提示使用 `wl-skills-kit` 进行页面结构和工作流规范化；在此之前，`wl-skills-ui` 仍应保证样式和渲染能力可独立生效。
 
+> 行状态由包统一管控：hover 为品牌色 4% 浅底，selected 为 7% 浅底且优先于
+> hover。业务代码不要重写 `.ag-row-hover`、`.ag-row-selected` 或对应 AG
+> Grid 主题变量，也不要为了行状态修改编辑控件、校验态和语义单元格背景。
+
 ---
 
 ## 标准列定义写法

package/skills/vendors/base-table/SKILL.md

@@ -28,7 +28,7 @@ applyTo: "**/*.vue"
 - ❌ 用 `<el-button type="primary">` 当操作按钮（应用 `is-text` 文字按钮，沿用 R004）
 - ❌ 列头未居中（同 R001）
 - ❌ 缺 `empty-text="暂无数据"`（同 R003）
-- ❌ 普通文本列未通过 `defineColumns()` 获得超长省略与悬停完整提示（同 R039）
+- ❌ 项目未安装 `runtime/auto` 包级保护，导致动态 Picker/历史列绕过 `defineColumns()` 后没有超长省略与完整提示（同 R039）
 - ❌ 在 `<BaseTable>` 外层包裹自定义 padding 容器，破坏整体节奏
 
 ## Repair（修复）
@@ -36,6 +36,7 @@ applyTo: "**/*.vue"
 ### A 类（自动修）
 - 缺失 `empty-text` → 补 `empty-text="暂无数据"`
 - 普通文本列统一经 `defineColumns()` 自动补 `showOverflowTooltip: true`
+- Skin/历史项目启动入口统一引入 `@agile-team/wl-skills-ui/runtime/auto`，为未经过 `defineColumns()` 的普通文本列提供真实溢出兜底
 - 操作列按钮 `type="primary"` → 改为 `link` + `is-text`
 - 内联 hex → CSS 变量
 
@@ -54,8 +55,10 @@ applyTo: "**/*.vue"
 ## 全局样式来源
 
 `styles/vendors/_base-table.scss` — 已注入容器圆角、表头颜色、操作按钮间距；
-`runtime.defineColumns()` 统一控制普通文本列的 overflow tooltip。
-项目侧无需重复写样式，遵循 DOM 约定即可。
+`runtime.defineColumns()` 优先接入平台原生 overflow tooltip；`runtime/auto` 为动态
+Picker 和历史普通文本列提供包级兜底。运行时只在 `scrollWidth > clientWidth` 时工作，
+并排除 Tag、操作列、编辑器、自定义 renderer、主动换行列和皮肤豁免区域。项目侧
+不要重复写样式或再注册第二套全局 Tooltip。
 
 ## 未来源码迁移
 

package/standards/ui/01-table.md

@@ -46,10 +46,21 @@
 />
 ```
 
-BaseTable / AG Grid 列必须通过 `defineColumns()` 声明。普通文本列会自动补
-`showOverflowTooltip: true`；自定义渲染列、selection/index/expand、`wrapText`
-或 `autoHeight` 列不会被强制。业务可显式设置 `showOverflowTooltip: false`
-退出。
+BaseTable / AG Grid 仍推荐通过 `defineColumns()` 声明，普通文本列会自动补
+`showOverflowTooltip: true` 并优先使用平台原生 Tooltip。对于动态 Picker 或未经过
+`defineColumns()` 的历史列，项目启动入口必须安装 `runtime/auto` 包级保护；其仅在
+真实溢出时提供兜底。自定义渲染列、selection/index/expand、`wrapText`、`autoHeight`、
+Tag、编辑列和操作列不会被强制。局部可用 `data-wl-ui-overflow="off"` 显式退出。
+
+---
+
+## 行悬停与选中状态
+
+- hover 使用客户品牌色 4% 透明度，只提示当前位置，不形成整条亮蓝色块。
+- selected 使用客户品牌色 7% 透明度，并始终优先于 hover。
+- 状态色只作用于数据行背景，不覆盖编辑输入框、校验态、Tag 和业务语义单元格底色。
+- 不在业务页面重写 `.ag-row-hover`、`.ag-row-selected`、`hover-row` 或
+  `current-row`；Element Table 与 AG Grid 均由化妆包统一管控。
 
 ---
 

package/styles/element/_table.scss

@@ -1,7 +1,16 @@
 // styles/element/_table.scss — el-table 表头颜色覆盖
 // jh-ui table.scss 表头颜色为硬编码，此处用 CSS 变量覆盖
 
+@use "../scope" as skin;
+
 html body .el-table {
+  // 与 AG Grid 共用克制的行状态层级；只改表格状态 token，
+  // 不强刷 input / 校验 / 业务语义单元格背景。
+  --wk-table-row-hover-bg: rgba(var(--el-color-primary-rgb), 0.04);
+  --wk-table-row-selected-bg: rgba(var(--el-color-primary-rgb), 0.07);
+  --el-table-row-hover-bg-color: var(--wk-table-row-hover-bg) !important;
+  --el-table-current-row-bg-color: var(--wk-table-row-selected-bg) !important;
+
   .el-table__header-wrapper th,
   .el-table__fixed-header-wrapper th {
     color: var(--el-text-color-primary, #303133);
@@ -38,3 +47,25 @@ html body .el-table {
     margin: 0 auto;
   }
 }
+
+// 未显式配置 show-overflow-tooltip 的普通纯文本列也获得视觉省略。
+// :not(:has(> *)) 将 Tag、按钮、复选框、自定义 renderer 和编辑控件排除在外；
+// Tooltip 由 runtime/auto 在真实溢出时按需兜底。
+#{skin.$managed-scope-selector} {
+  &.el-table__body
+    .cell:not(.el-tooltip):not(
+      :where(
+        .wl-ui-overflow-ignore,
+        .wl-ui-overflow-ignore *,
+        [data-wl-ui-overflow="off"],
+        [data-wl-ui-overflow="off"] *
+      )
+    ):not(:has(> *)) {
+    display: block !important;
+    min-width: 0 !important;
+    max-width: 100% !important;
+    overflow: hidden !important;
+    text-overflow: ellipsis !important;
+    white-space: nowrap !important;
+  }
+}

package/styles/vendors/_ag-grid.scss

@@ -1,3 +1,5 @@
+@use "../scope" as skin;
+
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 // AG Grid 全局样式 — wl-ui-safe 统一设计规范
 // 适用：所有使用 BaseTable renderType="agGrid" 的页面
@@ -6,14 +8,18 @@
 
 // ── CSS 变量注入（AG Grid 28+ 支持）──────────────────────────────────────────
 .ag-root-wrapper {
+  // 深品牌蓝在大面积行底色中只保留轻提示：hover 4%，selected 7%。
+  // 同时回写 AG Grid 变量，避免平台主题继续使用默认亮蓝。
+  --wk-grid-row-hover-bg: rgba(var(--el-color-primary-rgb), 0.04);
+  --wk-grid-row-selected-bg: rgba(var(--el-color-primary-rgb), 0.07);
   --ag-background-color: #ffffff;
   --ag-odd-row-background-color: #ffffff;
   --ag-header-background-color: #fafafa;
   --ag-header-foreground-color: #374151;
   --ag-border-color: rgba(0, 0, 0, 0.06);
   --ag-row-border-color: rgba(0, 0, 0, 0.06);
-  --ag-row-hover-color: rgba(var(--el-color-primary-rgb), 0.06);
-  --ag-selected-row-background-color: rgba(var(--el-color-primary-rgb), 0.1);
+  --ag-row-hover-color: var(--wk-grid-row-hover-bg) !important;
+  --ag-selected-row-background-color: var(--wk-grid-row-selected-bg) !important;
   --ag-range-selection-border-color: rgba(var(--el-color-primary-rgb), 0.4);
   --ag-font-size: 13px;
   --ag-font-family: inherit;
@@ -88,7 +94,7 @@
   font-size: 13px !important;
   color: var(--el-text-color-primary) !important;
   border-bottom-color: var(--el-border-color-lighter) !important;
-  transition: background-color 0.15s ease;
+  transition: background-color 0.12s ease;
 }
 
 .ag-row-even {
@@ -98,13 +104,21 @@
   background-color: #ffffff;
 }
 
-.ag-row:hover,
-.ag-row.ag-row-hover {
-  background-color: rgba(var(--el-color-primary-rgb), 0.06) !important;
+.ag-row:not(.ag-row-selected):hover,
+.ag-row.ag-row-hover:not(.ag-row-selected) {
+  background-color: var(
+    --wk-grid-row-hover-bg,
+    rgba(var(--el-color-primary-rgb), 0.04)
+  ) !important;
 }
 
-.ag-row.ag-row-selected {
-  background-color: rgba(var(--el-color-primary-rgb), 0.1) !important;
+.ag-row.ag-row-selected,
+.ag-row.ag-row-selected:hover,
+.ag-row.ag-row-selected.ag-row-hover {
+  background-color: var(
+    --wk-grid-row-selected-bg,
+    rgba(var(--el-color-primary-rgb), 0.07)
+  ) !important;
 }
 
 // ── 单元格 ────────────────────────────────────────────────────────────────────
@@ -126,6 +140,33 @@
   max-width: 100%;
 }
 
+// 平台把 .ag-cell 与 .ag-cell-value 复用在同一个 flex 节点上；flex 容器的
+// 直接文本不会稳定绘制 text-overflow。仅对没有子元素的普通文本单元格切回
+// block，编辑器、操作列、自定义 renderer、复选框与主动换行列保持原结构。
+#{skin.$managed-scope-selector} {
+  &.ag-root-wrapper
+    .ag-cell-value:not(.editable-cell):not(.always-editable-cell):not(
+      .default-slot-cell
+    ):not(.operations-cell):not(.ag-cell-inline-editing):not(
+      .ag-cell-wrap-text
+    ):not(.ag-checkbox-cell):not(
+      :where(
+        .wl-ui-overflow-ignore,
+        .wl-ui-overflow-ignore *,
+        [data-wl-ui-overflow="off"],
+        [data-wl-ui-overflow="off"] *
+      )
+    ):not(:has(> *)) {
+    display: block !important;
+    min-width: 0 !important;
+    max-width: 100% !important;
+    overflow: hidden !important;
+    line-height: var(--ag-row-height, 26px);
+    text-overflow: ellipsis !important;
+    white-space: nowrap !important;
+  }
+}
+
 // 复选框单元格（header 与 body 使用相同规则，确保视觉对齐）
 .ag-cell.ag-checkbox-cell {
   padding: 0 !important;

package/styles/vendors/_overflow-tooltip.scss

@@ -0,0 +1,35 @@
+// 普通表格长文本兜底 Tooltip。
+// 仅由 runtime/auto 在真实溢出且组件没有原生 Tooltip 时创建。
+
+.wl-ui-overflow-tooltip {
+  position: fixed;
+  z-index: 2147483000;
+  box-sizing: border-box;
+  max-width: min(520px, calc(100vw - 24px));
+  padding: 7px 10px;
+  color: #fff;
+  font-size: 12px;
+  font-weight: 400;
+  line-height: 1.5;
+  overflow-wrap: anywhere;
+  white-space: normal;
+  background: rgba(17, 24, 39, 0.94);
+  border: 1px solid rgba(255, 255, 255, 0.12);
+  border-radius: 6px;
+  box-shadow: 0 8px 24px rgba(15, 23, 42, 0.18);
+  opacity: 0;
+  visibility: hidden;
+  pointer-events: none;
+  transform: translateY(2px);
+  transition:
+    opacity 0.12s ease,
+    transform 0.12s ease,
+    visibility 0.12s ease;
+
+  &.is-visible {
+    opacity: 1;
+    visibility: visible;
+    transform: translateY(0);
+  }
+}
+

package/styles/vendors/index.scss

@@ -6,6 +6,7 @@
 // → 但 SCSS 加载顺序里我们反过来：兜底先加载，让高优先级覆盖
 
 @forward './_portal';            // 弹层/popper 通用（基础设施层）
+@forward './_overflow-tooltip';  // 普通长文本真实溢出 Tooltip 兜底
 @forward './_ag-grid';           // AG Grid 完整主题
 @forward './_custom-wrappers';   // 兜底：野路子自封装
 @forward './_c-components';      // C_/c_ 前缀