@robot-admin/naive-ui-components 0.24.1 → 0.24.3

package/dist/verification.d.ts

@@ -77,16 +77,16 @@ declare const __VLS_export: vue.DefineComponent<CaptchaProps, {
   show: () => void;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
   change: (valid: boolean) => any;
-  success: (data: CaptchaSuccessPayload) => any;
   reset: () => any;
+  success: (data: CaptchaSuccessPayload) => any;
   fail: (error: string) => any;
   "verify-error": (error: unknown) => any;
   "load-error": (error: unknown) => any;
   "visible-change": (visible: boolean) => any;
 }, string, vue.PublicProps, Readonly<CaptchaProps> & Readonly<{
   onChange?: ((valid: boolean) => any) | undefined;
-  onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
   onReset?: (() => any) | undefined;
+  onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
   onFail?: ((error: string) => any) | undefined;
   "onVerify-error"?: ((error: unknown) => any) | undefined;
   "onLoad-error"?: ((error: unknown) => any) | undefined;

package/docs/engineering.en.md

@@ -43,7 +43,7 @@ dist/
 
 ## Development
 
-The environment baseline is Node.js 20.19.0+ and Bun 1.3.14. `.node-version`, `packageManager`, `engines`, and the frozen lockfile keep local and CI installs aligned.
+The maintenance environment uses Node.js 20.19.0+ and pinned Bun 1.4.2. `.node-version`, `packageManager` and the frozen lockfile align local and CI installs. The minimum Bun version for consumers remains 1.3.14; maintenance checks verify that conditional overrides affect actual resolutions.
 
 ```bash
 bun install --frozen-lockfile # Install exactly from the lockfile

package/docs/engineering.md

@@ -44,7 +44,7 @@ dist/
 
 ## 开发
 
-环境基线为 Node.js 20.19.0+ 与 Bun 1.3.14；仓库通过 `.node-version`、`packageManager`、`engines` 和冻结锁文件保持本地/CI 一致。
+维护环境为 Node.js 20.19.0+ 与固定的 Bun 1.4.2；仓库通过 `.node-version`、`packageManager` 和冻结锁文件保持本地/CI 一致。消费者 Bun 最低版本仍为 1.3.14；维护环境使用能真实应用条件 overrides 的版本，并校验实际解析结果。
 
 ```bash
 bun install --frozen-lockfile # 严格按锁文件安装依赖

package/docs/guides/form-density.md

@@ -15,11 +15,11 @@ import type { ComponentDensity } from '@robot-admin/naive-ui-components/C_Form'
 const density = ref<ComponentDensity>('compact')
 ```
 
-| 密度          | 字段与操作按钮 | 布局间距 | 卡片留白 | 表单反馈预留高度 |
-| ------------- | -------------- | -------- | -------- | ---------------- |
-| `default`     | `medium`       | 16px     | 24px     | 24px             |
-| `compact`     | `small`        | 8px      | 12px     | 4px              |
-| `comfortable` | `large`        | 20px     | 28px     | 28px             |
+| 密度          | 字段与操作按钮 | 布局间距        | 卡片留白 | 表单反馈预留高度 |
+| ------------- | -------------- | --------------- | -------- | ---------------- |
+| `default`     | `medium`       | 16px            | 24px     | 24px             |
+| `compact`     | `small`        | 横 8px / 纵 4px | 12px     | 2px              |
+| `comfortable` | `large`        | 20px            | 28px     | 28px             |
 
 反馈预留高度是最小值，校验错误可自然撑开。密度支持响应式切换，切换不会清空表单值、搜索草稿、折叠条件或分组展开状态；不同实例可以使用不同密度。
 
@@ -110,3 +110,9 @@ const fields = [
 ```
 
 `focusTarget` 上下文还提供 `field`、字段表单项的 `element`（可能为空）和当前 `model`。即使异步适配器忽略取消，库也会拒绝旧元素；没有可聚焦目标时诚实返回 `false`，由使用侧保留错误摘要或提示导航限制。
+
+## 密集录入与性能
+
+紧凑表单与搜索默认纵向行距 4px，空反馈预留 2px；校验文案使用自然高度，多行错误不裁切、不盖住下一行。C_FormModal 的紧凑壳同步收紧，内容过高时在弹窗内部滚动，页脚保留可操作空间。显式的 grid.yGap / gutter 仍优先。
+
+Grid 和 Dynamic 字段不再执行逐字段入场或布局尺寸动画，Inline 不再对尺寸设置 transition: all。保留控件自身的焦点、悬停及校验反馈。配置与字段定义稳定时，表单控件按自身响应式依赖更新；400 字段回归检查单字段输入不会重绘其余 399 个控件。v-model 仍按既有契约输出独立的完整模型快照，成本随模型大小增长；大量字段建议按业务使用现有 Tabs/Steps 分区，明细数据继续交给虚拟表格。

package/docs/stability-review-20261031.md

@@ -0,0 +1,46 @@
+# 0.24.3 稳定性复核
+
+日期：2026-10-31。基线：0.24.2。本轮保留现有组件、主题、精简配置和公开接口，通过复现处理真实边界问题，不建立新的状态框架、全局缓存或通用虚拟化层。
+
+## 范围与发现
+
+公共值工具、字典与工作流入口，以及表单、搜索、表格、图、地图、上传、媒体等高风险组件是本轮重点。其他资源组件结合源码检查和现有生命周期回归复核；这不等同于所有第三方引擎和业务环境都完成压力测试。
+
+| 范围           | 已复现问题                                                                            | 修复边界与回归                                                                                                      |
+| -------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| 数据路径与快照 | 继承分支被修改；回退克隆压缩稀疏索引、把原型键当 setter；数组比较不对称               | 仅沿自有分支访问，保留 Vue HAS/GET 依赖和 literal dotted key；稀疏快照、循环对象及修改检测回归                      |
+| 字典           | 初次同步销毁遗漏清理，批量重载继续分发，abort/响应式通知重入后控制器失去归属          | 提前注册销毁、沿用视图和控制器身份；初读、订阅、请求、状态通知和销毁共 7 项边界回归                                 |
+| Tabs / Steps   | 旧校验写到替换后的区域或覆盖新结果                                                    | 稳定 key、既有状态与请求代次共同确认归属；删除从未读取的 Tabs 状态 Map                                              |
+| 搜索历史       | 小数数量触发数组长度异常，旧记录含 null 时抛错                                        | 有限正整数边界；存储按未知输入处理，仅恢复限定数量的有效文本                                                        |
+| 表格展示       | 编辑模式绕过状态/字典展示                                                             | 复用只读展示路径，删除重复 formatter 分支和两处 any                                                                 |
+| 列拖拽         | 辅助列使 DOM 下标错位，外部更新与 Sortable 同时改 DOM                                 | 最终列身份映射，辅助列不移动，先还原 DOM 再提交；统一单一初始化 watch，普通内容/测宽更新保留实例                    |
+| 编辑会话       | 公开 hook 的旧校验污染新草稿，scope 结束后继续保存                                    | 沿用 revision 失效化，hook 自身拥有清理责任                                                                         |
+| 视频小窗       | 配置不能动态启停、重复观察与迟到回调；观察 fixed 元素可能回跳，固定高度被宽度适配覆盖 | 唯一 observer、当前身份判断、文档流锚点及原位高度；固定与流式尺寸分离，小窗约束媒体容器，无轮询、额外 RO 或全局监听 |
+| X6 图实例      | 等待 DOM 时无法取消初始化，并发创建多余实例                                           | 初始化代次取消；删除被正值尺寸兜底遮蔽、不可达的重试分支                                                            |
+| 高德加载器     | 失败或超时后遗留本加载器写入的宿主安全配置                                            | 仅在仍持有同一对象时归还旧配置，保留宿主后续接管                                                                    |
+| 高亮与上传     | 诊断异常改变任务结果；删除 UID 在私有 Map 驻留                                        | 复用观察通知隔离；删除已移除 UID，既有取消和迟到上传契约继续验证                                                    |
+
+上述主要问题均先在原实现复现，再验证修复。源码检查另外覆盖地图实例/标记、富文本与 Markdown、代码加载、分片上传和对象 URL、甘特、瀑布流、工作流、签名和图片资源等已有保护；没有证据需要扩大重构的路径保持原架构。
+
+## 性能与复杂度
+
+- 字典仅在选项快照更新时创建索引，表格单元格按索引解析；不添加共享网络缓存，身份与租户隔离仍由应用 Provider 持有。
+- 列拖拽只有开启时追踪列结构，使用组件内惰性列 Map；不按数据行扫描，不因内容测宽变化重建实例。
+- 数据比较保留短路、循环处理和 O(N) 稠密数组遍历，不创建额外数组键列表。既有大表单比较缓存和集合线性查询回归继续通过。
+- 400 字段普通表单与弹窗仍验证仅被编辑控件更新。完整模型快照仍有与模型大小相关的成本；大量重复明细使用虚拟表格，异构大表单使用已有 Tabs/Steps 分区。
+- 单个小窗锚点只在进入小窗时记录一次原高度，没有持续测量任务；第三方实例继续使用浅引用，未增加运行时依赖。
+- 显式 any 从 108 降至 106，并把总预算从 117 收紧到 106；没有把第三方边界强行改为错误类型，也没有用忽略注释隐藏类型错误。
+
+对外的 deprecated 类型或兼容入口仍有公开消费契约，不把“已标记废弃”当成“无人使用”。补丁仅删除已确认的死状态、重复渲染逻辑和不可达分支，避免破坏已有使用侧。
+
+本轮新增路径没有新增 lint 警告。当前仍有 18 条既有提示，主要是公式/Cron 解析器分支、表格渲染分派和旧参数数量；没有为降低统计数字而拆散解析状态机或改变公开参数。本次不是“零技术债”的声明，后续按可验证收益渐进收敛。
+
+## 依赖与实际验证
+
+维护者工具及全部 CI 已固定到能真实应用条件依赖覆盖的 Bun 1.4.2，冻结安装及实际解析结果通过验证；消费者最低版本不变。现代工具链的 glob/minimatch 已按新公告修复；legacy glob 7 与 minimatch 3 保持成套接口。维护者公告与聚合数据库的范围差异、实际不可达代码路径、源码指纹和行为证据见 [SECURITY](../SECURITY.md)。原始审计命中保留并单独分类，不宣称零告警。
+
+- `bun run verify`：485 项逻辑测试、495 项组件测试，TypeScript/Vue/消费者类型、lint、旧 API 扫描、导出、vendor、构建、ESM/CJS、Node16/NodeNext 和可选 peer 契约全部通过。
+- 原有发布体积和消费者 gzip 预算全部通过，没有放宽限额；完整可用包约 5.13 MiB（含单列预算的 SheetJS）。
+- 发布候选包在 Chromium、Firefox、WebKit 共 9 项专项回归通过：400 字段表单 3 项，fixed/fluid 视频小窗 6 项；真实媒体保持固定高度及 320×180 小窗，持续观察不回跳，动态开关、卸载和页面错误检查通过。Robot_Admin 正式依赖的最终结果见应用提交与交付记录。
+
+真人读屏、多业务 UAT 与真实后端仍按已有交付约定留待人工环境验收，不计入自动测试通过项。

package/package.json

@@ -3,9 +3,9 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.24.1",
+  "version": "0.24.3",
   "description": "基于 Naive UI 的 Vue 3 组件库",
-  "packageManager": "bun@1.3.14",
+  "packageManager": "bun@1.4.2",
   "engines": {
     "node": ">=20.19.0",
     "bun": ">=1.3.14"
@@ -252,6 +252,8 @@
     "xlsx": "file:vendor/xlsx-0.20.3.tgz"
   },
   "overrides": {
+    "glob@13.0.6": "14.0.2",
+    "minimatch@10.2.6": "11.0.1",
     "@xmldom/xmldom": "0.8.15",
     "defu": "6.1.7",
     "fast-uri": "3.1.9",