react-form-manage 1.0.6-beta.5 → 1.0.7-beta.1

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.7-beta.1] - 2026-01-22
+
+- Add `FormFieldError` type export for typed error handling
+- Improve `getValueFromEvent` in FormItem for custom event handler support
+- Type `errors` as `FormFieldError[]` for better IDE support
+
+## [1.0.6] - 2026-01-22
+
+- Promote ValidationRule typing + regex pattern support to stable
+- Update README with validation examples (pattern, async validator) and remove template boilerplate
+- Finalize TypeScript migration and docs for npm landing page
+
 ## [1.0.6-beta.5] - 2026-01-22
 
 - Update README with validation rule examples (pattern, async validator)

package/dist/components/Form/FormItem.d.ts

@@ -8,6 +8,6 @@ export interface FormItemProps {
     formItemId?: string;
     rules?: ValidationRule[];
     valuePropName?: string;
-    getValueFromEvent?: (event: any) => any;
+    getValueFromEvent?: (...args: any[]) => any;
 }
 export default function FormItem({ children, name, formName, initialValue, formItemId: externalFormItemId, rules, valuePropName, getValueFromEvent, }: FormItemProps): ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;

package/dist/components/Form/FormItem.js

@@ -19,12 +19,13 @@ export default function FormItem({ children, name, formName, initialValue, formI
     return cloneElement(children, {
         // ref: inputRef,
         [valuePropName]: value,
-        onChange: (e) => {
-            let val = e;
+        onChange: (...args) => {
+            let val = args[0];
             if (getValueFromEvent && typeof getValueFromEvent === "function") {
-                val = getValueFromEvent(e);
+                val = getValueFromEvent(...args);
             }
             else {
+                const e = args[0];
                 if (e && e.target) {
                     val = e.target.value;
                 }

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import Form, { useForm, useWatch, useSubmitDataWatch, useFormStateWatch, type FormProps, type ValidationRule } from "./providers/Form";
+import Form, { useForm, useWatch, useSubmitDataWatch, useFormStateWatch, type FormProps, type ValidationRule, type FormFieldError } from "./providers/Form";
 import FormItem, { type FormItemProps } from "./components/Form/FormItem";
 import FormList, { type FormListProps } from "./components/Form/FormList";
 import Input from "./components/Input";
 import InputWrapper, { type InputWrapperProps } from "./components/Form/InputWrapper";
 import useFormItemControl from "./hooks/useFormItemControl";
 import useFormListControl from "./hooks/useFormListControl";
-export { Form, FormItem, FormList, Input, InputWrapper, useFormItemControl, useFormListControl, useForm, useWatch, useSubmitDataWatch, useFormStateWatch, type FormProps, type FormItemProps, type FormListProps, type InputWrapperProps, type ValidationRule, };
+export { Form, FormItem, FormList, Input, InputWrapper, useFormItemControl, useFormListControl, useForm, useWatch, useSubmitDataWatch, useFormStateWatch, type FormProps, type FormItemProps, type FormListProps, type InputWrapperProps, type ValidationRule, type FormFieldError, };
 export default Form;

package/dist/providers/Form.d.ts

@@ -1,6 +1,6 @@
 import type { ComponentType, FormHTMLAttributes, ReactNode } from "react";
 import type { PublicFormInstance } from "../types/public";
-export type { ValidationRule } from "../types/public";
+export type { ValidationRule, FormFieldError } from "../types/public";
 export declare const FormContext: import("react").Context<any>;
 export interface FormProps<T = any> extends Omit<FormHTMLAttributes<HTMLFormElement>, "onSubmit"> {
     children: ReactNode;

package/dist/types/public.d.ts

@@ -1,4 +1,8 @@
 export type FormValues<T = any> = T;
+export interface FormFieldError {
+    ruleName: string | number;
+    message: string;
+}
 export interface ValidationRule<T = any, TValues = any> {
     name?: string;
     message: string;
@@ -50,7 +54,7 @@ export interface UseFormItemReturn<T = any> {
     value: T | undefined;
     onChange: (value: T, options?: any) => void;
     state: any;
-    errors: any;
+    errors: FormFieldError[];
     onFocus: () => void;
     isDirty?: boolean;
 }

package/package.json

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

package/src/components/Form/FormItem.tsx

@@ -1,8 +1,8 @@
-import { cloneElement, useRef, useState } from "react";
 import type { ReactElement } from "react";
-import type { ValidationRule } from "../../types/public";
+import { cloneElement, useRef, useState } from "react";
 import { v4 } from "uuid";
 import useFormItemControl from "../../hooks/useFormItemControl";
+import type { ValidationRule } from "../../types/public";
 
 export interface FormItemProps {
   children: ReactElement;
@@ -12,7 +12,7 @@ export interface FormItemProps {
   formItemId?: string;
   rules?: ValidationRule[];
   valuePropName?: string;
-  getValueFromEvent?: (event: any) => any;
+  getValueFromEvent?: (...args: any[]) => any;
 }
 
 export default function FormItem({
@@ -46,11 +46,12 @@ export default function FormItem({
   return cloneElement(children, {
     // ref: inputRef,
     [valuePropName]: value,
-    onChange: (e: any) => {
-      let val = e;
+    onChange: (...args: any[]) => {
+      let val = args[0];
       if (getValueFromEvent && typeof getValueFromEvent === "function") {
-        val = getValueFromEvent(e);
+        val = getValueFromEvent(...args);
       } else {
+        const e = args[0];
         if (e && e.target) {
           val = e.target.value;
         }

package/src/index.ts

@@ -5,6 +5,7 @@ import Form, {
   useFormStateWatch,
   type FormProps,
   type ValidationRule,
+  type FormFieldError,
 } from "./providers/Form";
 
 import FormItem, { type FormItemProps } from "./components/Form/FormItem";
@@ -32,6 +33,7 @@ export {
   type FormListProps,
   type InputWrapperProps,
   type ValidationRule,
+  type FormFieldError,
 };
 
 export default Form;

package/src/providers/Form.tsx

@@ -8,7 +8,7 @@ import FormCleanUp from "../components/Form/FormCleanUp";
 import { useFormListeners, useFormStore } from "../stores/formStore";
 import type { PublicFormInstance } from "../types/public";
 import { getAllNoneObjStringPath } from "../utils/obj.util";
-export type { ValidationRule } from "../types/public";
+export type { ValidationRule, FormFieldError } from "../types/public";
 
 export const FormContext = createContext(null);
 

package/src/types/public.ts

@@ -1,5 +1,10 @@
 export type FormValues<T = any> = T;
 
+export interface FormFieldError {
+  ruleName: string | number;
+  message: string;
+}
+
 export interface ValidationRule<T = any, TValues = any> {
   name?: string;
   message: string;
@@ -53,7 +58,7 @@ export interface UseFormItemReturn<T = any> {
   value: T | undefined;
   onChange: (value: T, options?: any) => void;
   state: any;
-  errors: any;
+  errors: FormFieldError[];
   onFocus: () => void;
   isDirty?: boolean;
 }