@robot-admin/form-validate

项目定位

Robot Form Validate 以框架无关的 RuleSpec 为规则源，通过适配器输出 Naive UI 与 Element Plus 规则，也支持对纯数据执行校验。包名为 @robot-admin/form-validate，无需安装 Vue 或 UI 框架即可使用规则核心。

当前仓库版本 3.4.2。适用于表单实时反馈、导入数据检查、表格多行提交，以及 SQL 数值契约等场景。

能力地图

flowchart LR
  Spec["RuleSpec · 规则源"] --> Naive["Naive UI 规则"]
  Spec --> Element["Element Plus 规则"]
  Spec --> Data["纯数据 / 记录 / 多行校验"]

快速开始

bun add @robot-admin/form-validate

先校验一条数据

import { SPEC_RULES, validateRecord } from "@robot-admin/form-validate";

const rules = {
  name: [SPEC_RULES.required("姓名")],
  email: [SPEC_RULES.email("邮箱")],
};

const error = await validateRecord(
  { name: "Robot", email: "robot@example.com" },
  rules,
);
// 全部通过为 null；失败时返回 { field, message }

在表单中使用

import {
  NAIVE_COMBOS,
  PRESET_RULES,
  ELEMENT_COMBOS,
  ELEMENT_RULES,
} from "@robot-admin/form-validate";

const naiveRules = {
  name: NAIVE_COMBOS.username("用户名"),
  email: [PRESET_RULES.email("邮箱")],
};

const elementRules = {
  name: ELEMENT_COMBOS.username("用户名"),
  email: [ELEMENT_RULES.email("邮箱")],
};

naiveRules 传给 Naive UI 的表单规则，elementRules 传给 Element Plus。业务规则只需维护一次；需要跨界面与批量提交复用时，直接维护 RuleSpec 并调用 toNaiveRules / toElementRules。

入口选择与规则语义

所有公开 API 都从包根入口导入：

纯数据校验顺序执行，遇到首条失败即返回。可选字段使用相应命名空间的 optional 或核心 optional() 包装；跨字段规则通过 getter 读取最新模型。UI 触发与展示仍由使用侧表单控制，服务端也应执行业务校验。

文档与维护

在本包目录运行 bun run verify，覆盖类型、测试与构建；工作区完整门禁使用根目录的 bun run verify。

许可证

MIT License · Robot Packages