react-form-manage 1.0.6-beta.3 → 1.0.6-beta.5

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.6-beta.5] - 2026-01-22
+
+- Update README with validation rule examples (pattern, async validator)
+- Remove Vite template boilerplate from docs
+- Republish docs to npm
+
 ## [1.0.6-beta.3] - 2026-01-22
 
 - Add `ValidationRule` typing and export

package/README.md

@@ -72,6 +72,8 @@ export default Example;
 
 `Form` sẽ đăng ký form instance trong store nội bộ và inject `value` / `onChange` vào các children của `FormItem`.
 
+`ValidationRule` là type public được export để bạn mô tả rules rõ ràng trong TypeScript.
+
 ---
 
 ## Form API / Programmatic usage
@@ -108,6 +110,48 @@ Methods available on the form instance (populated by `Form` provider):
 
 ---
 
+## Validation rules
+
+Hỗ trợ các rule phổ biến: `required`, `min`, `max`, `len`, `pattern`, `enum`, `whitespace`, `type` và custom `validator`. `pattern` nhận `RegExp`; `validator` nhận hàm sync/async `(value, ctx) => void | Promise<void>`.
+
+Ví dụ pattern + required:
+
+```tsx
+<Form formName="codeForm" initialValues={{ numericCode: "" }}>
+  <FormItem
+    name="numericCode"
+    rules={[
+      { required: true, message: "Code is required" },
+      { pattern: /^\d+$/, message: "Only digits are allowed" },
+    ]}
+  >
+    <Input placeholder="Enter digits only" />
+  </FormItem>
+  <button type="submit">Submit</button>
+</Form>
+```
+
+Custom validator (async):
+
+```tsx
+<FormItem
+  name="username"
+  rules={[
+    {
+      validator: async (value) => {
+        if (!value) throw new Error("Username required");
+        const exists = await api.checkUser(value);
+        if (exists) throw new Error("Username already taken");
+      },
+    },
+  ]}
+>
+  <Input placeholder="Username" />
+</FormItem>
+```
+
+---
+
 ## FormList (Array field)
 
 `FormList` là render-prop component cung cấp `listFields` và các action `add`, `remove`, `move`.
@@ -186,20 +230,3 @@ Nếu bạn muốn tự sinh `.d.ts` từ JS, có thể thêm `tsconfig.types.js
 ## License
 
 Mặc định chưa thêm license — nếu muốn public, hãy thêm `LICENSE` (ví dụ MIT).
-
-# React + Vite
-
-This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
-
-Currently, two official plugins are available:
-
-- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
-- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
-
-## React Compiler
-
-The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
-
-## Expanding the ESLint configuration
-
-If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the [TS template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) for information on how to integrate TypeScript and [`typescript-eslint`](https://typescript-eslint.io) in your project.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-form-manage",
-  "version": "1.0.6-beta.3",
+  "version": "1.0.6-beta.5",
   "description": "Lightweight React form management with list and listener support.",
   "license": "MIT",
   "type": "module",