@robot-admin/naive-ui-components 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -1,60 +1,76 @@
-# @robot-admin/naive-ui-components
-
-## 0.7.1
-
-### 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.8.0
+
+### 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/dist/C_Form.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./C_Icon.js`),require(`./C_Editor.js`);const e=require(`./C_Form.js`);exports.C_Form=e.t,exports.DYNAMIC_FORM_STATE_KEY=e.n,exports.FIELD_TYPE_OPTIONS=e.r,exports.FORM_DEFAULTS=e.c,exports.LAYOUTS_WITH_OWN_CONTROLS=e.l,exports.registerRenderer=e.a,exports.resolveFormConfig=e.u,exports.shouldShowActions=e.d,exports.useDynamicFormState=e.i,exports.useFormRenderer=e.o,exports.useFormState=e.s;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./C_Icon.js`),require(`./C_Editor.js`);const e=require(`./C_Form.js`);exports.C_Form=e.t,exports.DYNAMIC_FORM_STATE_KEY=e.n,exports.FIELD_TYPE_OPTIONS=e.r,exports.FORM_DEFAULTS=e.l,exports.LAYOUTS_WITH_OWN_CONTROLS=e.u,exports.registerRenderer=e.a,exports.resolveFormConfig=e.d,exports.shouldShowActions=e.f,exports.useDynamicFormState=e.i,exports.useFormDirty=e.c,exports.useFormRenderer=e.o,exports.useFormState=e.s;

package/dist/C_Form.d.cts

@@ -1,2 +1,2 @@
-import { A as LayoutConfig, C as DynamicFormState, D as GridLayoutConfig, E as FormOption, M as StepsLayoutConfig, N as SubmitEventPayload, O as InlineLayoutConfig, P as TabsLayoutConfig, S as DynamicFormConfig, T as FormModel, _ as shouldShowActions, a as ComponentMap, b as CustomLayoutConfig, c as useFormRenderer, d as FORM_DEFAULTS, f as FormConfig, g as resolveFormConfig, h as ResolvedFormConfig, i as useDynamicFormState, j as LayoutType, k as LabelPlacement, l as useFormState, m as LayoutCallbacks, n as DynamicFormStateType, o as FormRenderer, p as LAYOUTS_WITH_OWN_CONTROLS, r as FIELD_TYPE_OPTIONS, s as registerRenderer, t as DYNAMIC_FORM_STATE_KEY, u as _default, v as CardLayoutConfig, w as FormInstance, x as DynamicFieldConfig, y as ComponentType } from "./useDynamicFormState.js";
-export { _default as C_Form, type CardLayoutConfig, type ComponentMap, type ComponentType, type CustomLayoutConfig, DYNAMIC_FORM_STATE_KEY, type DynamicFieldConfig, type DynamicFormConfig, type DynamicFormState, type DynamicFormStateType, FIELD_TYPE_OPTIONS, FORM_DEFAULTS, type FormConfig, type FormInstance, type FormModel, type FormOption, type FormRenderer, type GridLayoutConfig, type InlineLayoutConfig, LAYOUTS_WITH_OWN_CONTROLS, type LabelPlacement, type LayoutCallbacks, type LayoutConfig, type LayoutType, type ResolvedFormConfig, type StepsLayoutConfig, type SubmitEventPayload, type TabsLayoutConfig, registerRenderer, resolveFormConfig, shouldShowActions, useDynamicFormState, useFormRenderer, useFormState };
+import { A as FormOption, C as CustomLayoutConfig, D as FormInstance, E as DynamicFormState, F as LayoutType, I as StepsLayoutConfig, L as SubmitEventPayload, M as InlineLayoutConfig, N as LabelPlacement, O as FormMode, P as LayoutConfig, R as TabsLayoutConfig, S as ComponentType, T as DynamicFormConfig, _ as LayoutCallbacks, a as UseFormDirtyReturn, b as shouldShowActions, c as FormRenderer, d as useFormRenderer, f as useFormState, g as LAYOUTS_WITH_OWN_CONTROLS, h as FormConfig, i as useDynamicFormState, j as GridLayoutConfig, k as FormModel, l as UseFormRendererOptions, m as FORM_DEFAULTS, n as DynamicFormStateType, o as useFormDirty, p as _default, r as FIELD_TYPE_OPTIONS, s as ComponentMap, t as DYNAMIC_FORM_STATE_KEY, u as registerRenderer, v as ResolvedFormConfig, w as DynamicFieldConfig, x as CardLayoutConfig, y as resolveFormConfig } from "./useDynamicFormState.js";
+export { _default as C_Form, type CardLayoutConfig, type ComponentMap, type ComponentType, type CustomLayoutConfig, DYNAMIC_FORM_STATE_KEY, type DynamicFieldConfig, type DynamicFormConfig, type DynamicFormState, type DynamicFormStateType, FIELD_TYPE_OPTIONS, FORM_DEFAULTS, type FormConfig, type FormInstance, type FormMode, type FormModel, type FormOption, type FormRenderer, type GridLayoutConfig, type InlineLayoutConfig, LAYOUTS_WITH_OWN_CONTROLS, type LabelPlacement, type LayoutCallbacks, type LayoutConfig, type LayoutType, type ResolvedFormConfig, type StepsLayoutConfig, type SubmitEventPayload, type TabsLayoutConfig, type UseFormDirtyReturn, type UseFormRendererOptions, registerRenderer, resolveFormConfig, shouldShowActions, useDynamicFormState, useFormDirty, useFormRenderer, useFormState };

package/dist/C_Form.d.ts

@@ -1,2 +1,2 @@
-import { A as LayoutConfig, C as DynamicFormState, D as GridLayoutConfig, E as FormOption, M as StepsLayoutConfig, N as SubmitEventPayload, O as InlineLayoutConfig, P as TabsLayoutConfig, S as DynamicFormConfig, T as FormModel, _ as shouldShowActions, a as ComponentMap, b as CustomLayoutConfig, c as useFormRenderer, d as FORM_DEFAULTS, f as FormConfig, g as resolveFormConfig, h as ResolvedFormConfig, i as useDynamicFormState, j as LayoutType, k as LabelPlacement, l as useFormState, m as LayoutCallbacks, n as DynamicFormStateType, o as FormRenderer, p as LAYOUTS_WITH_OWN_CONTROLS, r as FIELD_TYPE_OPTIONS, s as registerRenderer, t as DYNAMIC_FORM_STATE_KEY, u as _default, v as CardLayoutConfig, w as FormInstance, x as DynamicFieldConfig, y as ComponentType } from "./useDynamicFormState.js";
-export { _default as C_Form, type CardLayoutConfig, type ComponentMap, type ComponentType, type CustomLayoutConfig, DYNAMIC_FORM_STATE_KEY, type DynamicFieldConfig, type DynamicFormConfig, type DynamicFormState, type DynamicFormStateType, FIELD_TYPE_OPTIONS, FORM_DEFAULTS, type FormConfig, type FormInstance, type FormModel, type FormOption, type FormRenderer, type GridLayoutConfig, type InlineLayoutConfig, LAYOUTS_WITH_OWN_CONTROLS, type LabelPlacement, type LayoutCallbacks, type LayoutConfig, type LayoutType, type ResolvedFormConfig, type StepsLayoutConfig, type SubmitEventPayload, type TabsLayoutConfig, registerRenderer, resolveFormConfig, shouldShowActions, useDynamicFormState, useFormRenderer, useFormState };
+import { A as FormOption, C as CustomLayoutConfig, D as FormInstance, E as DynamicFormState, F as LayoutType, I as StepsLayoutConfig, L as SubmitEventPayload, M as InlineLayoutConfig, N as LabelPlacement, O as FormMode, P as LayoutConfig, R as TabsLayoutConfig, S as ComponentType, T as DynamicFormConfig, _ as LayoutCallbacks, a as UseFormDirtyReturn, b as shouldShowActions, c as FormRenderer, d as useFormRenderer, f as useFormState, g as LAYOUTS_WITH_OWN_CONTROLS, h as FormConfig, i as useDynamicFormState, j as GridLayoutConfig, k as FormModel, l as UseFormRendererOptions, m as FORM_DEFAULTS, n as DynamicFormStateType, o as useFormDirty, p as _default, r as FIELD_TYPE_OPTIONS, s as ComponentMap, t as DYNAMIC_FORM_STATE_KEY, u as registerRenderer, v as ResolvedFormConfig, w as DynamicFieldConfig, x as CardLayoutConfig, y as resolveFormConfig } from "./useDynamicFormState.js";
+export { _default as C_Form, type CardLayoutConfig, type ComponentMap, type ComponentType, type CustomLayoutConfig, DYNAMIC_FORM_STATE_KEY, type DynamicFieldConfig, type DynamicFormConfig, type DynamicFormState, type DynamicFormStateType, FIELD_TYPE_OPTIONS, FORM_DEFAULTS, type FormConfig, type FormInstance, type FormMode, type FormModel, type FormOption, type FormRenderer, type GridLayoutConfig, type InlineLayoutConfig, LAYOUTS_WITH_OWN_CONTROLS, type LabelPlacement, type LayoutCallbacks, type LayoutConfig, type LayoutType, type ResolvedFormConfig, type StepsLayoutConfig, type SubmitEventPayload, type TabsLayoutConfig, type UseFormDirtyReturn, type UseFormRendererOptions, registerRenderer, resolveFormConfig, shouldShowActions, useDynamicFormState, useFormDirty, useFormRenderer, useFormState };

package/dist/C_Form.js

@@ -1 +1 @@
-import"./C_Icon2.js";import"./C_Editor2.js";import{a as e,c as t,d as n,i as r,l as i,n as a,o,r as s,s as c,t as l,u}from"./C_Form2.js";export{l as C_Form,a as DYNAMIC_FORM_STATE_KEY,s as FIELD_TYPE_OPTIONS,t as FORM_DEFAULTS,i as LAYOUTS_WITH_OWN_CONTROLS,e as registerRenderer,u as resolveFormConfig,n as shouldShowActions,r as useDynamicFormState,o as useFormRenderer,c as useFormState};
+import"./C_Icon2.js";import"./C_Editor2.js";import{a as e,c as t,d as n,f as r,i,l as a,n as o,o as s,r as c,s as l,t as u,u as d}from"./C_Form2.js";export{u as C_Form,o as DYNAMIC_FORM_STATE_KEY,c as FIELD_TYPE_OPTIONS,a as FORM_DEFAULTS,d as LAYOUTS_WITH_OWN_CONTROLS,e as registerRenderer,n as resolveFormConfig,r as shouldShowActions,i as useDynamicFormState,t as useFormDirty,s as useFormRenderer,l as useFormState};