@robot-admin/naive-ui-components 0.10.3 → 0.11.1

package/CHANGELOG.md

@@ -1,100 +1,117 @@
-# @robot-admin/naive-ui-components
-
-## 0.10.3
-
-### Patch Changes
-
-- 修复内部共享入口与根声明文件重名导致的类型导出丢失，并增加构建后公共 JS/DTS 入口校验。
-
-## 0.10.2
-
-### Patch Changes
-
-- 从 `C_Menu` 子路径导出菜单适配工具与公共类型，避免消费者为 `createMenuOptions` 引入组件库根入口及无关重依赖。
-
-## 0.10.1
-
-### Patch Changes
-
-- 将表单验证库改为 peer dependency，避免消费端安装重复版本导致规则类型冲突；通知中心 Popover 直接桥接 Naive UI 主题变量，修复 Teleport 场景下文本颜色无法随明暗主题切换的问题。
-
-## 0.10.0
-
-### Minor Changes
-
-- 默认从组件子路径按需解析组件，避免总入口将编辑器、Office、图表等重依赖带入应用首屏；同时为动态表单状态补充稳定的公共返回类型，修复消费项目生成声明时的内部类型泄漏。
-
-## 0.8.1
-
-### Minor Changes
-
-- C_Form 新增8项能力：
-  - 🧹 脏检查系统（isDirty / getChangedFields / isFieldDirty / markAsClean），独立 useFormDirty Composable
-  - ✏️ 编辑模式（mode: "edit" + initialValues 自动回填 + 脏状态重置）
-  - 🔒 字段级 disabled / readonly（支持 boolean | (model) => boolean 动态判断）
-  - 🔄 联动赋值引擎（valueWhen 根据其他字段自动计算回填）
-  - 🌐 异步选项加载（asyncOptions 远程数据源 + asyncLoadingMap loading 状态）
-  - 📐 动态校验规则（rulesWhen 根据表单状态动态切换验证规则）
-  - 🔗 跨字段校验（crossFieldValidator 声明式跨字段验证）
-  - 💡 Help Tooltip（help 字段标签旁 ℹ️ 图标 + NTooltip 帮助文本）
-  - useFormRenderer 重构为 Options 对象参数模式
-  - 新增导出：FormMode 类型、useFormDirty、UseFormRendererOptions
-
-## 0.7.2
-
-### Patch Changes
-
-- C_Table 类型系统清理：移除 6 个废弃类型（TestRecord、SelectedChildGroup、DemoConfig、DataMapping、CommonMappings），集中定义 ColumnWithKey 消除跨文件重复，修复所有 TypeScript 类型错误
-
-## 0.7.0
-
-### Minor Changes
-
-- C_Table 新增10项能力：全局配置 provide/inject、列级 formatter 格式化引擎、树形表格、行拖拽排序、跨页多选、CSV/XLSX 导出、列配置持久化、编辑校验、错误状态、批量操作栏
-
-## 0.6.2
-
-### Patch Changes
-
-- 修复菜单图标在生产环境下错位问题
-  - menuAdapter 的 defaultRenderIcon 中 `inline-flex items-center` 原子类改为内联 style
-  - 组件库不应依赖宿主项目的 UnoCSS/Tailwind 原子类，否则生产构建时可能丢失样式
-
-## 0.6.1
-
-### Patch Changes
-
-- 修复 C_Table loading 状态在 crud 模式下失效的问题
-  - `loading` prop 默认值从 `false` 改为 `undefined`，使 `??` 运算符能正确回退到 `crud.loading.value`
-  - 之前 `false ?? crud.loading.value` 始终返回 `false`（`??` 不回退 falsy 值，只回退 null/undefined）
-
-## 0.6.0
-
-### Minor Changes
-
-- 依赖架构优化 + CSS 按需导入 + Changesets 集成
-  - 将 optionalDependencies 迁移至 dependencies，消费端自动传递安装
-  - 新增按组件 CSS 导出 (`C_*/style.css`)，支持样式按需导入
-  - 修复 merge-css.js 中 esm/cjs CSS 重复合并问题
-  - Resolver 新增 `importStyle` 选项，自动注入组件样式
-  - 集成 @changesets/cli 自动化版本管理
-
-- 提取 C_Menu / C_Breadcrumb / C_TagsView 布局组件 + 适配器架构
-  - 新增 `_shared` 模块：统一类型定义（RouteItem, TagItem, BreadcrumbItem）+ menuAdapter 适配器
-  - `createMenuOptions(routes, config)` 工厂函数：将 RouteItem[] 转换为 NMenu MenuOption[]
-  - `flattenRoutes()` 辅助：扁平化嵌套路由用于标签页匹配
-  - C_Menu：支持双输入（options / routes），内置 labelFormatter 回调解耦 i18n
-  - C_Breadcrumb：auto（route.matched）+ manual（items）双模式
-  - C_TagsView：useTagsView composable + localStorage 持久化 + 右键菜单
-  - vue-router ^4.0.0 新增为 peerDependency
-
-## 0.5.0
-
-### Minor Changes
-
-- 依赖架构优化 + CSS 按需导入 + Changesets 集成
-  - 将 optionalDependencies 迁移至 dependencies，消费端自动传递安装
-  - 新增按组件 CSS 导出 (`C_*/style.css`)，支持样式按需导入
-  - 修复 merge-css.js 中 esm/cjs CSS 重复合并问题
-  - Resolver 新增 `importStyle` 选项，自动注入组件样式
-  - 集成 @changesets/cli 自动化版本管理
+# @robot-admin/naive-ui-components
+
+## 0.11.1
+
+### Patch Changes
+
+- 1b09ddd: Preserve the row model generic across `C_Table` Vue props so typed `CrudBinding<T>` values can be passed directly without consumer-side casts.
+
+## 0.11.0
+
+### Minor Changes
+
+- f0a9254: 增强组件库公共契约与使用体验：C_Form 新增业务模型泛型、嵌套字段路径和 `useCForm`；C_Table 新增类型助手、远程查询控制器、行键诊断及可靠的异步展开；C_Date、C_Time、C_Menu、C_FormSearch 统一支持标准 `v-model`。同时引入可选的全局反馈、语言和组件默认配置，修复跨实例、异步竞态、重复副作用、受控状态同步及发布产物问题，并补齐契约与回归测试。
+- 48dc8fe: Add lightweight/full C_Form and C_Table style entries, deduplicate the full stylesheet and reject leaked Vue deep selectors, harden C_Captcha with cancellable server verification, stabilize Naive UI public type imports, remove unused/runtime validation dependencies, improve async error and keyboard behavior, and enforce dependency, SSR, declaration, and package-size release contracts.
+
+### Patch Changes
+
+- 0c5ecf2: 深度治理 C_Form、C_Table 及其他组件的状态同步、异步竞态、资源清理、输入输出安全与依赖漏洞，并补齐回归测试和推荐用法文档。
+
+## 0.10.3
+
+### Patch Changes
+
+- 修复内部共享入口与根声明文件重名导致的类型导出丢失，并增加构建后公共 JS/DTS 入口校验。
+
+## 0.10.2
+
+### Patch Changes
+
+- 从 `C_Menu` 子路径导出菜单适配工具与公共类型，避免消费者为 `createMenuOptions` 引入组件库根入口及无关重依赖。
+
+## 0.10.1
+
+### Patch Changes
+
+- 将表单验证库改为 peer dependency，避免消费端安装重复版本导致规则类型冲突；通知中心 Popover 直接桥接 Naive UI 主题变量，修复 Teleport 场景下文本颜色无法随明暗主题切换的问题。
+
+## 0.10.0
+
+### Minor Changes
+
+- 默认从组件子路径按需解析组件，避免总入口将编辑器、Office、图表等重依赖带入应用首屏；同时为动态表单状态补充稳定的公共返回类型，修复消费项目生成声明时的内部类型泄漏。
+
+## 0.8.1
+
+### Minor Changes
+
+- C_Form 新增8项能力：
+  - 🧹 脏检查系统（isDirty / getChangedFields / isFieldDirty / markAsClean），独立 useFormDirty Composable
+  - ✏️ 编辑模式（mode: "edit" + initialValues 自动回填 + 脏状态重置）
+  - 🔒 字段级 disabled / readonly（支持 boolean | (model) => boolean 动态判断）
+  - 🔄 联动赋值引擎（valueWhen 根据其他字段自动计算回填）
+  - 🌐 异步选项加载（asyncOptions 远程数据源 + asyncLoadingMap loading 状态）
+  - 📐 动态校验规则（rulesWhen 根据表单状态动态切换验证规则）
+  - 🔗 跨字段校验（crossFieldValidator 声明式跨字段验证）
+  - 💡 Help Tooltip（help 字段标签旁 ℹ️ 图标 + NTooltip 帮助文本）
+  - useFormRenderer 重构为 Options 对象参数模式
+  - 新增导出：FormMode 类型、useFormDirty、UseFormRendererOptions
+
+## 0.7.2
+
+### Patch Changes
+
+- C_Table 类型系统清理：移除 6 个废弃类型（TestRecord、SelectedChildGroup、DemoConfig、DataMapping、CommonMappings），集中定义 ColumnWithKey 消除跨文件重复，修复所有 TypeScript 类型错误
+
+## 0.7.0
+
+### Minor Changes
+
+- C_Table 新增10项能力：全局配置 provide/inject、列级 formatter 格式化引擎、树形表格、行拖拽排序、跨页多选、CSV/XLSX 导出、列配置持久化、编辑校验、错误状态、批量操作栏
+
+## 0.6.2
+
+### Patch Changes
+
+- 修复菜单图标在生产环境下错位问题
+  - menuAdapter 的 defaultRenderIcon 中 `inline-flex items-center` 原子类改为内联 style
+  - 组件库不应依赖宿主项目的 UnoCSS/Tailwind 原子类，否则生产构建时可能丢失样式
+
+## 0.6.1
+
+### Patch Changes
+
+- 修复 C_Table loading 状态在 crud 模式下失效的问题
+  - `loading` prop 默认值从 `false` 改为 `undefined`，使 `??` 运算符能正确回退到 `crud.loading.value`
+  - 之前 `false ?? crud.loading.value` 始终返回 `false`（`??` 不回退 falsy 值，只回退 null/undefined）
+
+## 0.6.0
+
+### Minor Changes
+
+- 依赖架构优化 + CSS 按需导入 + Changesets 集成
+  - 将 optionalDependencies 迁移至 dependencies，消费端自动传递安装
+  - 新增按组件 CSS 导出 (`C_*/style.css`)，支持样式按需导入
+  - 修复 merge-css.js 中 esm/cjs CSS 重复合并问题
+  - Resolver 新增 `importStyle` 选项，自动注入组件样式
+  - 集成 @changesets/cli 自动化版本管理
+
+- 提取 C_Menu / C_Breadcrumb / C_TagsView 布局组件 + 适配器架构
+  - 新增 `_shared` 模块：统一类型定义（RouteItem, TagItem, BreadcrumbItem）+ menuAdapter 适配器
+  - `createMenuOptions(routes, config)` 工厂函数：将 RouteItem[] 转换为 NMenu MenuOption[]
+  - `flattenRoutes()` 辅助：扁平化嵌套路由用于标签页匹配
+  - C_Menu：支持双输入（options / routes），内置 labelFormatter 回调解耦 i18n
+  - C_Breadcrumb：auto（route.matched）+ manual（items）双模式
+  - C_TagsView：useTagsView composable + localStorage 持久化 + 右键菜单
+  - vue-router ^4.0.0 新增为 peerDependency
+
+## 0.5.0
+
+### Minor Changes
+
+- 依赖架构优化 + CSS 按需导入 + Changesets 集成
+  - 将 optionalDependencies 迁移至 dependencies，消费端自动传递安装
+  - 新增按组件 CSS 导出 (`C_*/style.css`)，支持样式按需导入
+  - 修复 merge-css.js 中 esm/cjs CSS 重复合并问题
+  - Resolver 新增 `importStyle` 选项，自动注入组件样式
+  - 集成 @changesets/cli 自动化版本管理

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 CHENY
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 CHENY
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.