@famgia/omnify-react 0.0.1 → 0.0.3

package/dist/hooks/index.cjs

@@ -20,6 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/hooks/index.ts
 var hooks_exports = {};
 __export(hooks_exports, {
+  getFirstValidationError: () => getFirstValidationError,
+  getFormErrors: () => getFormErrors,
+  getValidationMessage: () => getValidationMessage,
   useFormMutation: () => useFormMutation
 });
 module.exports = __toCommonJS(hooks_exports);
@@ -31,20 +34,31 @@ function getFormErrors(error) {
   const data = error?.response?.data;
   const errors = data?.errors;
   if (!errors || typeof errors !== "object") return [];
-  return Object.entries(errors).map(([name, messages]) => ({
-    name,
+  return Object.entries(errors).map(([fieldName, messages]) => ({
+    // Convert "user.name" or "items.0.name" to array path for Ant Design
+    name: fieldName.includes(".") ? fieldName.split(".").map((part) => /^\d+$/.test(part) ? parseInt(part, 10) : part) : fieldName,
     errors: Array.isArray(messages) ? messages : [String(messages)]
   }));
 }
 function getValidationMessage(error) {
-  const data = error?.response?.data;
-  return data?.message || null;
+  const axiosError = error;
+  if (axiosError?.response?.status !== 422) return null;
+  return axiosError?.response?.data?.message ?? null;
+}
+function getFirstValidationError(error) {
+  const errors = error?.response?.data?.errors;
+  if (!errors || typeof errors !== "object") return null;
+  const firstField = Object.keys(errors)[0];
+  return firstField ? errors[firstField][0] : null;
 }
 function useFormMutation({
   form,
   mutationFn,
   invalidateKeys = [],
   successMessage,
+  redirectTo,
+  router,
+  translateFn,
   onSuccess,
   onError
 }) {
@@ -57,7 +71,11 @@ function useFormMutation({
         queryClient.invalidateQueries({ queryKey: [...key] });
       });
       if (successMessage) {
-        message.success(successMessage);
+        const msg = translateFn ? translateFn(successMessage) : successMessage;
+        message.success(msg);
+      }
+      if (redirectTo && router) {
+        router.push(redirectTo);
       }
       onSuccess?.(data);
     },
@@ -76,6 +94,9 @@ function useFormMutation({
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  getFirstValidationError,
+  getFormErrors,
+  getValidationMessage,
   useFormMutation
 });
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/index.ts","../../src/hooks/use-form-mutation.ts"],"sourcesContent":["/**\n * @famgia/omnify-react/hooks\n *\n * React hooks for form handling and data mutations\n */\n\nexport { useFormMutation, type UseFormMutationOptions } from './use-form-mutation';\n","/**\n * useFormMutation - Form mutation with auto Laravel error handling\n *\n * @example\n * ```typescript\n * import { useFormMutation } from '@famgia/omnify-react/hooks';\n *\n * const mutation = useFormMutation({\n *   form,\n *   mutationFn: (data) => axios.post('/api/customers', data),\n *   invalidateKeys: [['customers']],\n *   successMessage: '保存しました',\n * });\n *\n * <Form form={form} onFinish={mutation.mutate}>\n *   ...\n *   <Button loading={mutation.isPending}>保存</Button>\n * </Form>\n * ```\n */\n\nimport { useMutation, useQueryClient } from '@tanstack/react-query';\nimport { App } from 'antd';\nimport type { FormInstance } from 'antd';\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport interface UseFormMutationOptions<TData, TResult> {\n  /** Ant Design form instance */\n  form: FormInstance;\n  /** API call function */\n  mutationFn: (data: TData) => Promise<TResult>;\n  /** Query keys to invalidate on success */\n  invalidateKeys?: readonly (readonly unknown[])[];\n  /** Success message to show */\n  successMessage?: string;\n  /** Callback on success */\n  onSuccess?: (data: TResult) => void;\n  /** Callback on error */\n  onError?: (error: unknown) => void;\n}\n\n// =============================================================================\n// Laravel Error Helpers\n// =============================================================================\n\n/**\n * Parse Laravel validation errors to Ant Design form format\n */\nfunction getFormErrors(error: unknown): { name: string; errors: string[] }[] {\n  const data = (error as any)?.response?.data;\n  const errors = data?.errors;\n\n  if (!errors || typeof errors !== 'object') return [];\n\n  return Object.entries(errors).map(([name, messages]) => ({\n    name,\n    errors: Array.isArray(messages) ? messages : [String(messages)],\n  }));\n}\n\n/**\n * Get general validation message from Laravel response\n */\nfunction getValidationMessage(error: unknown): string | null {\n  const data = (error as any)?.response?.data;\n  return data?.message || null;\n}\n\n// =============================================================================\n// Hook\n// =============================================================================\n\nexport function useFormMutation<TData, TResult = unknown>({\n  form,\n  mutationFn,\n  invalidateKeys = [],\n  successMessage,\n  onSuccess,\n  onError,\n}: UseFormMutationOptions<TData, TResult>) {\n  const queryClient = useQueryClient();\n  const { message } = App.useApp();\n\n  return useMutation({\n    mutationFn,\n    onSuccess: (data) => {\n      // Invalidate queries\n      invalidateKeys.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: [...key] });\n      });\n\n      // Show success message\n      if (successMessage) {\n        message.success(successMessage);\n      }\n\n      // Custom callback\n      onSuccess?.(data);\n    },\n    onError: (error) => {\n      // Set form field errors from Laravel validation\n      const formErrors = getFormErrors(error);\n      if (formErrors.length > 0) {\n        form.setFields(formErrors);\n      }\n\n      // Show general error message\n      const validationMessage = getValidationMessage(error);\n      if (validationMessage) {\n        message.error(validationMessage);\n      }\n\n      // Custom callback\n      onError?.(error);\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACqBA,yBAA4C;AAC5C,kBAAoB;AA6BpB,SAAS,cAAc,OAAsD;AAC3E,QAAM,OAAQ,OAAe,UAAU;AACvC,QAAM,SAAS,MAAM;AAErB,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO,CAAC;AAEnD,SAAO,OAAO,QAAQ,MAAM,EAAE,IAAI,CAAC,CAAC,MAAM,QAAQ,OAAO;AAAA,IACvD;AAAA,IACA,QAAQ,MAAM,QAAQ,QAAQ,IAAI,WAAW,CAAC,OAAO,QAAQ,CAAC;AAAA,EAChE,EAAE;AACJ;AAKA,SAAS,qBAAqB,OAA+B;AAC3D,QAAM,OAAQ,OAAe,UAAU;AACvC,SAAO,MAAM,WAAW;AAC1B;AAMO,SAAS,gBAA0C;AAAA,EACxD;AAAA,EACA;AAAA,EACA,iBAAiB,CAAC;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AACF,GAA2C;AACzC,QAAM,kBAAc,mCAAe;AACnC,QAAM,EAAE,QAAQ,IAAI,gBAAI,OAAO;AAE/B,aAAO,gCAAY;AAAA,IACjB;AAAA,IACA,WAAW,CAAC,SAAS;AAEnB,qBAAe,QAAQ,CAAC,QAAQ;AAC9B,oBAAY,kBAAkB,EAAE,UAAU,CAAC,GAAG,GAAG,EAAE,CAAC;AAAA,MACtD,CAAC;AAGD,UAAI,gBAAgB;AAClB,gBAAQ,QAAQ,cAAc;AAAA,MAChC;AAGA,kBAAY,IAAI;AAAA,IAClB;AAAA,IACA,SAAS,CAAC,UAAU;AAElB,YAAM,aAAa,cAAc,KAAK;AACtC,UAAI,WAAW,SAAS,GAAG;AACzB,aAAK,UAAU,UAAU;AAAA,MAC3B;AAGA,YAAM,oBAAoB,qBAAqB,KAAK;AACpD,UAAI,mBAAmB;AACrB,gBAAQ,MAAM,iBAAiB;AAAA,MACjC;AAGA,gBAAU,KAAK;AAAA,IACjB;AAAA,EACF,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../../src/hooks/index.ts","../../src/hooks/use-form-mutation.ts"],"sourcesContent":["/**\n * @famgia/omnify-react/hooks\n *\n * React hooks for form handling and data mutations\n */\n\nexport {\n  useFormMutation,\n  type UseFormMutationOptions,\n  type FormMutationRouter,\n  type TranslateFn,\n  type FormFieldError,\n  // Helper functions (also exported for direct use)\n  getFormErrors,\n  getValidationMessage,\n  getFirstValidationError,\n} from './use-form-mutation';\n","/**\n * useFormMutation - Form mutation with auto Laravel error handling\n *\n * Features:\n * - Auto parse Laravel validation errors to Ant Design form format\n * - Support nested field paths (e.g., \"items.0.name\" → [\"items\", 0, \"name\"])\n * - Auto invalidate queries on success\n * - Optional redirect after success\n * - Optional i18n translation for messages\n *\n * @example\n * ```typescript\n * import { useFormMutation } from '@famgia/omnify-react';\n * import { useRouter } from 'next/navigation';\n * import { useTranslations } from 'next-intl';\n *\n * function MyForm() {\n *   const [form] = Form.useForm();\n *   const router = useRouter();\n *   const t = useTranslations();\n *\n *   const mutation = useFormMutation({\n *     form,\n *     mutationFn: (data) => api.post('/api/customers', data),\n *     invalidateKeys: [['customers']],\n *     successMessage: 'messages.saved',\n *     redirectTo: '/customers',\n *     router,           // Optional: for redirect\n *     translateFn: t,   // Optional: for i18n\n *   });\n *\n *   return (\n *     <Form form={form} onFinish={mutation.mutate}>\n *       ...\n *       <Button loading={mutation.isPending}>保存</Button>\n *     </Form>\n *   );\n * }\n * ```\n */\n\nimport { useMutation, useQueryClient } from '@tanstack/react-query';\nimport { App } from 'antd';\nimport type { FormInstance } from 'antd';\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/** Router interface - compatible with Next.js useRouter */\nexport interface FormMutationRouter {\n  push: (path: string) => void;\n}\n\n/** Translation function - compatible with next-intl useTranslations */\nexport type TranslateFn = (key: string) => string;\n\nexport interface UseFormMutationOptions<TData, TResult> {\n  /** Ant Design form instance */\n  form: FormInstance;\n  /** API call function */\n  mutationFn: (data: TData) => Promise<TResult>;\n  /** Query keys to invalidate on success */\n  invalidateKeys?: readonly (readonly unknown[])[];\n  /** Success message to show (will be translated if translateFn provided) */\n  successMessage?: string;\n  /** Redirect path after success (requires router) */\n  redirectTo?: string;\n  /** Router instance for redirect (e.g., useRouter from next/navigation) */\n  router?: FormMutationRouter;\n  /** Translation function for messages (e.g., useTranslations from next-intl) */\n  translateFn?: TranslateFn;\n  /** Callback on success */\n  onSuccess?: (data: TResult) => void;\n  /** Callback on error */\n  onError?: (error: unknown) => void;\n}\n\n// =============================================================================\n// Laravel Error Helpers (exported for reuse)\n// =============================================================================\n\n/** Form field error for Ant Design */\nexport interface FormFieldError {\n  name: string | (string | number)[];\n  errors: string[];\n}\n\n/**\n * Parse Laravel validation errors to Ant Design form format\n *\n * Supports:\n * - Simple fields: \"email\" → name: \"email\"\n * - Dot notation: \"user.name\" → name: [\"user\", \"name\"]\n * - Array notation: \"items.0.name\" → name: [\"items\", 0, \"name\"]\n *\n * @example\n * form.setFields(getFormErrors(error))\n */\nexport function getFormErrors(error: unknown): FormFieldError[] {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const data = (error as any)?.response?.data;\n  const errors = data?.errors;\n\n  if (!errors || typeof errors !== 'object') return [];\n\n  return Object.entries(errors).map(([fieldName, messages]) => ({\n    // Convert \"user.name\" or \"items.0.name\" to array path for Ant Design\n    name: fieldName.includes('.')\n      ? fieldName.split('.').map((part) => (/^\\d+$/.test(part) ? parseInt(part, 10) : part))\n      : fieldName,\n    errors: Array.isArray(messages) ? (messages as string[]) : [String(messages)],\n  }));\n}\n\n/**\n * Get general validation message from Laravel 422 response\n * @example \"The name_lastname field is required. (and 3 more errors)\"\n */\nexport function getValidationMessage(error: unknown): string | null {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const axiosError = error as any;\n\n  // Only for 422 validation errors\n  if (axiosError?.response?.status !== 422) return null;\n\n  return axiosError?.response?.data?.message ?? null;\n}\n\n/**\n * Get first error message from validation errors\n * Useful when field names don't match form fields\n */\nexport function getFirstValidationError(error: unknown): string | null {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const errors = (error as any)?.response?.data?.errors;\n\n  if (!errors || typeof errors !== 'object') return null;\n\n  const firstField = Object.keys(errors)[0];\n  return firstField ? errors[firstField][0] : null;\n}\n\n// =============================================================================\n// Hook\n// =============================================================================\n\nexport function useFormMutation<TData, TResult = unknown>({\n  form,\n  mutationFn,\n  invalidateKeys = [],\n  successMessage,\n  redirectTo,\n  router,\n  translateFn,\n  onSuccess,\n  onError,\n}: UseFormMutationOptions<TData, TResult>) {\n  const queryClient = useQueryClient();\n  const { message } = App.useApp();\n\n  return useMutation({\n    mutationFn,\n    onSuccess: (data) => {\n      // Invalidate queries\n      invalidateKeys.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: [...key] });\n      });\n\n      // Show success message (translate if translateFn provided)\n      if (successMessage) {\n        const msg = translateFn ? translateFn(successMessage) : successMessage;\n        message.success(msg);\n      }\n\n      // Redirect if router and redirectTo provided\n      if (redirectTo && router) {\n        router.push(redirectTo);\n      }\n\n      // Custom callback\n      onSuccess?.(data);\n    },\n    onError: (error) => {\n      // Set form field errors from Laravel validation\n      const formErrors = getFormErrors(error);\n      if (formErrors.length > 0) {\n        form.setFields(formErrors);\n      }\n\n      // Show general validation message (from Laravel)\n      const validationMessage = getValidationMessage(error);\n      if (validationMessage) {\n        message.error(validationMessage);\n      }\n\n      // Custom callback\n      onError?.(error);\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACyCA,yBAA4C;AAC5C,kBAAoB;AAyDb,SAAS,cAAc,OAAkC;AAE9D,QAAM,OAAQ,OAAe,UAAU;AACvC,QAAM,SAAS,MAAM;AAErB,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO,CAAC;AAEnD,SAAO,OAAO,QAAQ,MAAM,EAAE,IAAI,CAAC,CAAC,WAAW,QAAQ,OAAO;AAAA;AAAA,IAE5D,MAAM,UAAU,SAAS,GAAG,IACxB,UAAU,MAAM,GAAG,EAAE,IAAI,CAAC,SAAU,QAAQ,KAAK,IAAI,IAAI,SAAS,MAAM,EAAE,IAAI,IAAK,IACnF;AAAA,IACJ,QAAQ,MAAM,QAAQ,QAAQ,IAAK,WAAwB,CAAC,OAAO,QAAQ,CAAC;AAAA,EAC9E,EAAE;AACJ;AAMO,SAAS,qBAAqB,OAA+B;AAElE,QAAM,aAAa;AAGnB,MAAI,YAAY,UAAU,WAAW,IAAK,QAAO;AAEjD,SAAO,YAAY,UAAU,MAAM,WAAW;AAChD;AAMO,SAAS,wBAAwB,OAA+B;AAErE,QAAM,SAAU,OAAe,UAAU,MAAM;AAE/C,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAElD,QAAM,aAAa,OAAO,KAAK,MAAM,EAAE,CAAC;AACxC,SAAO,aAAa,OAAO,UAAU,EAAE,CAAC,IAAI;AAC9C;AAMO,SAAS,gBAA0C;AAAA,EACxD;AAAA,EACA;AAAA,EACA,iBAAiB,CAAC;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA2C;AACzC,QAAM,kBAAc,mCAAe;AACnC,QAAM,EAAE,QAAQ,IAAI,gBAAI,OAAO;AAE/B,aAAO,gCAAY;AAAA,IACjB;AAAA,IACA,WAAW,CAAC,SAAS;AAEnB,qBAAe,QAAQ,CAAC,QAAQ;AAC9B,oBAAY,kBAAkB,EAAE,UAAU,CAAC,GAAG,GAAG,EAAE,CAAC;AAAA,MACtD,CAAC;AAGD,UAAI,gBAAgB;AAClB,cAAM,MAAM,cAAc,YAAY,cAAc,IAAI;AACxD,gBAAQ,QAAQ,GAAG;AAAA,MACrB;AAGA,UAAI,cAAc,QAAQ;AACxB,eAAO,KAAK,UAAU;AAAA,MACxB;AAGA,kBAAY,IAAI;AAAA,IAClB;AAAA,IACA,SAAS,CAAC,UAAU;AAElB,YAAM,aAAa,cAAc,KAAK;AACtC,UAAI,WAAW,SAAS,GAAG;AACzB,aAAK,UAAU,UAAU;AAAA,MAC3B;AAGA,YAAM,oBAAoB,qBAAqB,KAAK;AACpD,UAAI,mBAAmB;AACrB,gBAAQ,MAAM,iBAAiB;AAAA,MACjC;AAGA,gBAAU,KAAK;AAAA,IACjB;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/hooks/index.d.cts

@@ -1,6 +1,12 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { FormInstance } from 'antd';
 
+/** Router interface - compatible with Next.js useRouter */
+interface FormMutationRouter {
+    push: (path: string) => void;
+}
+/** Translation function - compatible with next-intl useTranslations */
+type TranslateFn = (key: string) => string;
 interface UseFormMutationOptions<TData, TResult> {
     /** Ant Design form instance */
     form: FormInstance;
@@ -8,13 +14,46 @@ interface UseFormMutationOptions<TData, TResult> {
     mutationFn: (data: TData) => Promise<TResult>;
     /** Query keys to invalidate on success */
     invalidateKeys?: readonly (readonly unknown[])[];
-    /** Success message to show */
+    /** Success message to show (will be translated if translateFn provided) */
     successMessage?: string;
+    /** Redirect path after success (requires router) */
+    redirectTo?: string;
+    /** Router instance for redirect (e.g., useRouter from next/navigation) */
+    router?: FormMutationRouter;
+    /** Translation function for messages (e.g., useTranslations from next-intl) */
+    translateFn?: TranslateFn;
     /** Callback on success */
     onSuccess?: (data: TResult) => void;
     /** Callback on error */
     onError?: (error: unknown) => void;
 }
-declare function useFormMutation<TData, TResult = unknown>({ form, mutationFn, invalidateKeys, successMessage, onSuccess, onError, }: UseFormMutationOptions<TData, TResult>): _tanstack_react_query.UseMutationResult<TResult, Error, TData, unknown>;
+/** Form field error for Ant Design */
+interface FormFieldError {
+    name: string | (string | number)[];
+    errors: string[];
+}
+/**
+ * Parse Laravel validation errors to Ant Design form format
+ *
+ * Supports:
+ * - Simple fields: "email" → name: "email"
+ * - Dot notation: "user.name" → name: ["user", "name"]
+ * - Array notation: "items.0.name" → name: ["items", 0, "name"]
+ *
+ * @example
+ * form.setFields(getFormErrors(error))
+ */
+declare function getFormErrors(error: unknown): FormFieldError[];
+/**
+ * Get general validation message from Laravel 422 response
+ * @example "The name_lastname field is required. (and 3 more errors)"
+ */
+declare function getValidationMessage(error: unknown): string | null;
+/**
+ * Get first error message from validation errors
+ * Useful when field names don't match form fields
+ */
+declare function getFirstValidationError(error: unknown): string | null;
+declare function useFormMutation<TData, TResult = unknown>({ form, mutationFn, invalidateKeys, successMessage, redirectTo, router, translateFn, onSuccess, onError, }: UseFormMutationOptions<TData, TResult>): _tanstack_react_query.UseMutationResult<TResult, Error, TData, unknown>;
 
-export { type UseFormMutationOptions, useFormMutation };
+export { type FormFieldError, type FormMutationRouter, type TranslateFn, type UseFormMutationOptions, getFirstValidationError, getFormErrors, getValidationMessage, useFormMutation };

package/dist/hooks/index.d.ts

@@ -1,6 +1,12 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { FormInstance } from 'antd';
 
+/** Router interface - compatible with Next.js useRouter */
+interface FormMutationRouter {
+    push: (path: string) => void;
+}
+/** Translation function - compatible with next-intl useTranslations */
+type TranslateFn = (key: string) => string;
 interface UseFormMutationOptions<TData, TResult> {
     /** Ant Design form instance */
     form: FormInstance;
@@ -8,13 +14,46 @@ interface UseFormMutationOptions<TData, TResult> {
     mutationFn: (data: TData) => Promise<TResult>;
     /** Query keys to invalidate on success */
     invalidateKeys?: readonly (readonly unknown[])[];
-    /** Success message to show */
+    /** Success message to show (will be translated if translateFn provided) */
     successMessage?: string;
+    /** Redirect path after success (requires router) */
+    redirectTo?: string;
+    /** Router instance for redirect (e.g., useRouter from next/navigation) */
+    router?: FormMutationRouter;
+    /** Translation function for messages (e.g., useTranslations from next-intl) */
+    translateFn?: TranslateFn;
     /** Callback on success */
     onSuccess?: (data: TResult) => void;
     /** Callback on error */
     onError?: (error: unknown) => void;
 }
-declare function useFormMutation<TData, TResult = unknown>({ form, mutationFn, invalidateKeys, successMessage, onSuccess, onError, }: UseFormMutationOptions<TData, TResult>): _tanstack_react_query.UseMutationResult<TResult, Error, TData, unknown>;
+/** Form field error for Ant Design */
+interface FormFieldError {
+    name: string | (string | number)[];
+    errors: string[];
+}
+/**
+ * Parse Laravel validation errors to Ant Design form format
+ *
+ * Supports:
+ * - Simple fields: "email" → name: "email"
+ * - Dot notation: "user.name" → name: ["user", "name"]
+ * - Array notation: "items.0.name" → name: ["items", 0, "name"]
+ *
+ * @example
+ * form.setFields(getFormErrors(error))
+ */
+declare function getFormErrors(error: unknown): FormFieldError[];
+/**
+ * Get general validation message from Laravel 422 response
+ * @example "The name_lastname field is required. (and 3 more errors)"
+ */
+declare function getValidationMessage(error: unknown): string | null;
+/**
+ * Get first error message from validation errors
+ * Useful when field names don't match form fields
+ */
+declare function getFirstValidationError(error: unknown): string | null;
+declare function useFormMutation<TData, TResult = unknown>({ form, mutationFn, invalidateKeys, successMessage, redirectTo, router, translateFn, onSuccess, onError, }: UseFormMutationOptions<TData, TResult>): _tanstack_react_query.UseMutationResult<TResult, Error, TData, unknown>;
 
-export { type UseFormMutationOptions, useFormMutation };
+export { type FormFieldError, type FormMutationRouter, type TranslateFn, type UseFormMutationOptions, getFirstValidationError, getFormErrors, getValidationMessage, useFormMutation };

package/dist/hooks/index.js

@@ -5,20 +5,31 @@ function getFormErrors(error) {
   const data = error?.response?.data;
   const errors = data?.errors;
   if (!errors || typeof errors !== "object") return [];
-  return Object.entries(errors).map(([name, messages]) => ({
-    name,
+  return Object.entries(errors).map(([fieldName, messages]) => ({
+    // Convert "user.name" or "items.0.name" to array path for Ant Design
+    name: fieldName.includes(".") ? fieldName.split(".").map((part) => /^\d+$/.test(part) ? parseInt(part, 10) : part) : fieldName,
     errors: Array.isArray(messages) ? messages : [String(messages)]
   }));
 }
 function getValidationMessage(error) {
-  const data = error?.response?.data;
-  return data?.message || null;
+  const axiosError = error;
+  if (axiosError?.response?.status !== 422) return null;
+  return axiosError?.response?.data?.message ?? null;
+}
+function getFirstValidationError(error) {
+  const errors = error?.response?.data?.errors;
+  if (!errors || typeof errors !== "object") return null;
+  const firstField = Object.keys(errors)[0];
+  return firstField ? errors[firstField][0] : null;
 }
 function useFormMutation({
   form,
   mutationFn,
   invalidateKeys = [],
   successMessage,
+  redirectTo,
+  router,
+  translateFn,
   onSuccess,
   onError
 }) {
@@ -31,7 +42,11 @@ function useFormMutation({
         queryClient.invalidateQueries({ queryKey: [...key] });
       });
       if (successMessage) {
-        message.success(successMessage);
+        const msg = translateFn ? translateFn(successMessage) : successMessage;
+        message.success(msg);
+      }
+      if (redirectTo && router) {
+        router.push(redirectTo);
       }
       onSuccess?.(data);
     },
@@ -49,6 +64,9 @@ function useFormMutation({
   });
 }
 export {
+  getFirstValidationError,
+  getFormErrors,
+  getValidationMessage,
   useFormMutation
 };
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/use-form-mutation.ts"],"sourcesContent":["/**\n * useFormMutation - Form mutation with auto Laravel error handling\n *\n * @example\n * ```typescript\n * import { useFormMutation } from '@famgia/omnify-react/hooks';\n *\n * const mutation = useFormMutation({\n *   form,\n *   mutationFn: (data) => axios.post('/api/customers', data),\n *   invalidateKeys: [['customers']],\n *   successMessage: '保存しました',\n * });\n *\n * <Form form={form} onFinish={mutation.mutate}>\n *   ...\n *   <Button loading={mutation.isPending}>保存</Button>\n * </Form>\n * ```\n */\n\nimport { useMutation, useQueryClient } from '@tanstack/react-query';\nimport { App } from 'antd';\nimport type { FormInstance } from 'antd';\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport interface UseFormMutationOptions<TData, TResult> {\n  /** Ant Design form instance */\n  form: FormInstance;\n  /** API call function */\n  mutationFn: (data: TData) => Promise<TResult>;\n  /** Query keys to invalidate on success */\n  invalidateKeys?: readonly (readonly unknown[])[];\n  /** Success message to show */\n  successMessage?: string;\n  /** Callback on success */\n  onSuccess?: (data: TResult) => void;\n  /** Callback on error */\n  onError?: (error: unknown) => void;\n}\n\n// =============================================================================\n// Laravel Error Helpers\n// =============================================================================\n\n/**\n * Parse Laravel validation errors to Ant Design form format\n */\nfunction getFormErrors(error: unknown): { name: string; errors: string[] }[] {\n  const data = (error as any)?.response?.data;\n  const errors = data?.errors;\n\n  if (!errors || typeof errors !== 'object') return [];\n\n  return Object.entries(errors).map(([name, messages]) => ({\n    name,\n    errors: Array.isArray(messages) ? messages : [String(messages)],\n  }));\n}\n\n/**\n * Get general validation message from Laravel response\n */\nfunction getValidationMessage(error: unknown): string | null {\n  const data = (error as any)?.response?.data;\n  return data?.message || null;\n}\n\n// =============================================================================\n// Hook\n// =============================================================================\n\nexport function useFormMutation<TData, TResult = unknown>({\n  form,\n  mutationFn,\n  invalidateKeys = [],\n  successMessage,\n  onSuccess,\n  onError,\n}: UseFormMutationOptions<TData, TResult>) {\n  const queryClient = useQueryClient();\n  const { message } = App.useApp();\n\n  return useMutation({\n    mutationFn,\n    onSuccess: (data) => {\n      // Invalidate queries\n      invalidateKeys.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: [...key] });\n      });\n\n      // Show success message\n      if (successMessage) {\n        message.success(successMessage);\n      }\n\n      // Custom callback\n      onSuccess?.(data);\n    },\n    onError: (error) => {\n      // Set form field errors from Laravel validation\n      const formErrors = getFormErrors(error);\n      if (formErrors.length > 0) {\n        form.setFields(formErrors);\n      }\n\n      // Show general error message\n      const validationMessage = getValidationMessage(error);\n      if (validationMessage) {\n        message.error(validationMessage);\n      }\n\n      // Custom callback\n      onError?.(error);\n    },\n  });\n}\n"],"mappings":";AAqBA,SAAS,aAAa,sBAAsB;AAC5C,SAAS,WAAW;AA6BpB,SAAS,cAAc,OAAsD;AAC3E,QAAM,OAAQ,OAAe,UAAU;AACvC,QAAM,SAAS,MAAM;AAErB,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO,CAAC;AAEnD,SAAO,OAAO,QAAQ,MAAM,EAAE,IAAI,CAAC,CAAC,MAAM,QAAQ,OAAO;AAAA,IACvD;AAAA,IACA,QAAQ,MAAM,QAAQ,QAAQ,IAAI,WAAW,CAAC,OAAO,QAAQ,CAAC;AAAA,EAChE,EAAE;AACJ;AAKA,SAAS,qBAAqB,OAA+B;AAC3D,QAAM,OAAQ,OAAe,UAAU;AACvC,SAAO,MAAM,WAAW;AAC1B;AAMO,SAAS,gBAA0C;AAAA,EACxD;AAAA,EACA;AAAA,EACA,iBAAiB,CAAC;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AACF,GAA2C;AACzC,QAAM,cAAc,eAAe;AACnC,QAAM,EAAE,QAAQ,IAAI,IAAI,OAAO;AAE/B,SAAO,YAAY;AAAA,IACjB;AAAA,IACA,WAAW,CAAC,SAAS;AAEnB,qBAAe,QAAQ,CAAC,QAAQ;AAC9B,oBAAY,kBAAkB,EAAE,UAAU,CAAC,GAAG,GAAG,EAAE,CAAC;AAAA,MACtD,CAAC;AAGD,UAAI,gBAAgB;AAClB,gBAAQ,QAAQ,cAAc;AAAA,MAChC;AAGA,kBAAY,IAAI;AAAA,IAClB;AAAA,IACA,SAAS,CAAC,UAAU;AAElB,YAAM,aAAa,cAAc,KAAK;AACtC,UAAI,WAAW,SAAS,GAAG;AACzB,aAAK,UAAU,UAAU;AAAA,MAC3B;AAGA,YAAM,oBAAoB,qBAAqB,KAAK;AACpD,UAAI,mBAAmB;AACrB,gBAAQ,MAAM,iBAAiB;AAAA,MACjC;AAGA,gBAAU,KAAK;AAAA,IACjB;AAAA,EACF,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../../src/hooks/use-form-mutation.ts"],"sourcesContent":["/**\n * useFormMutation - Form mutation with auto Laravel error handling\n *\n * Features:\n * - Auto parse Laravel validation errors to Ant Design form format\n * - Support nested field paths (e.g., \"items.0.name\" → [\"items\", 0, \"name\"])\n * - Auto invalidate queries on success\n * - Optional redirect after success\n * - Optional i18n translation for messages\n *\n * @example\n * ```typescript\n * import { useFormMutation } from '@famgia/omnify-react';\n * import { useRouter } from 'next/navigation';\n * import { useTranslations } from 'next-intl';\n *\n * function MyForm() {\n *   const [form] = Form.useForm();\n *   const router = useRouter();\n *   const t = useTranslations();\n *\n *   const mutation = useFormMutation({\n *     form,\n *     mutationFn: (data) => api.post('/api/customers', data),\n *     invalidateKeys: [['customers']],\n *     successMessage: 'messages.saved',\n *     redirectTo: '/customers',\n *     router,           // Optional: for redirect\n *     translateFn: t,   // Optional: for i18n\n *   });\n *\n *   return (\n *     <Form form={form} onFinish={mutation.mutate}>\n *       ...\n *       <Button loading={mutation.isPending}>保存</Button>\n *     </Form>\n *   );\n * }\n * ```\n */\n\nimport { useMutation, useQueryClient } from '@tanstack/react-query';\nimport { App } from 'antd';\nimport type { FormInstance } from 'antd';\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/** Router interface - compatible with Next.js useRouter */\nexport interface FormMutationRouter {\n  push: (path: string) => void;\n}\n\n/** Translation function - compatible with next-intl useTranslations */\nexport type TranslateFn = (key: string) => string;\n\nexport interface UseFormMutationOptions<TData, TResult> {\n  /** Ant Design form instance */\n  form: FormInstance;\n  /** API call function */\n  mutationFn: (data: TData) => Promise<TResult>;\n  /** Query keys to invalidate on success */\n  invalidateKeys?: readonly (readonly unknown[])[];\n  /** Success message to show (will be translated if translateFn provided) */\n  successMessage?: string;\n  /** Redirect path after success (requires router) */\n  redirectTo?: string;\n  /** Router instance for redirect (e.g., useRouter from next/navigation) */\n  router?: FormMutationRouter;\n  /** Translation function for messages (e.g., useTranslations from next-intl) */\n  translateFn?: TranslateFn;\n  /** Callback on success */\n  onSuccess?: (data: TResult) => void;\n  /** Callback on error */\n  onError?: (error: unknown) => void;\n}\n\n// =============================================================================\n// Laravel Error Helpers (exported for reuse)\n// =============================================================================\n\n/** Form field error for Ant Design */\nexport interface FormFieldError {\n  name: string | (string | number)[];\n  errors: string[];\n}\n\n/**\n * Parse Laravel validation errors to Ant Design form format\n *\n * Supports:\n * - Simple fields: \"email\" → name: \"email\"\n * - Dot notation: \"user.name\" → name: [\"user\", \"name\"]\n * - Array notation: \"items.0.name\" → name: [\"items\", 0, \"name\"]\n *\n * @example\n * form.setFields(getFormErrors(error))\n */\nexport function getFormErrors(error: unknown): FormFieldError[] {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const data = (error as any)?.response?.data;\n  const errors = data?.errors;\n\n  if (!errors || typeof errors !== 'object') return [];\n\n  return Object.entries(errors).map(([fieldName, messages]) => ({\n    // Convert \"user.name\" or \"items.0.name\" to array path for Ant Design\n    name: fieldName.includes('.')\n      ? fieldName.split('.').map((part) => (/^\\d+$/.test(part) ? parseInt(part, 10) : part))\n      : fieldName,\n    errors: Array.isArray(messages) ? (messages as string[]) : [String(messages)],\n  }));\n}\n\n/**\n * Get general validation message from Laravel 422 response\n * @example \"The name_lastname field is required. (and 3 more errors)\"\n */\nexport function getValidationMessage(error: unknown): string | null {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const axiosError = error as any;\n\n  // Only for 422 validation errors\n  if (axiosError?.response?.status !== 422) return null;\n\n  return axiosError?.response?.data?.message ?? null;\n}\n\n/**\n * Get first error message from validation errors\n * Useful when field names don't match form fields\n */\nexport function getFirstValidationError(error: unknown): string | null {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const errors = (error as any)?.response?.data?.errors;\n\n  if (!errors || typeof errors !== 'object') return null;\n\n  const firstField = Object.keys(errors)[0];\n  return firstField ? errors[firstField][0] : null;\n}\n\n// =============================================================================\n// Hook\n// =============================================================================\n\nexport function useFormMutation<TData, TResult = unknown>({\n  form,\n  mutationFn,\n  invalidateKeys = [],\n  successMessage,\n  redirectTo,\n  router,\n  translateFn,\n  onSuccess,\n  onError,\n}: UseFormMutationOptions<TData, TResult>) {\n  const queryClient = useQueryClient();\n  const { message } = App.useApp();\n\n  return useMutation({\n    mutationFn,\n    onSuccess: (data) => {\n      // Invalidate queries\n      invalidateKeys.forEach((key) => {\n        queryClient.invalidateQueries({ queryKey: [...key] });\n      });\n\n      // Show success message (translate if translateFn provided)\n      if (successMessage) {\n        const msg = translateFn ? translateFn(successMessage) : successMessage;\n        message.success(msg);\n      }\n\n      // Redirect if router and redirectTo provided\n      if (redirectTo && router) {\n        router.push(redirectTo);\n      }\n\n      // Custom callback\n      onSuccess?.(data);\n    },\n    onError: (error) => {\n      // Set form field errors from Laravel validation\n      const formErrors = getFormErrors(error);\n      if (formErrors.length > 0) {\n        form.setFields(formErrors);\n      }\n\n      // Show general validation message (from Laravel)\n      const validationMessage = getValidationMessage(error);\n      if (validationMessage) {\n        message.error(validationMessage);\n      }\n\n      // Custom callback\n      onError?.(error);\n    },\n  });\n}\n"],"mappings":";AAyCA,SAAS,aAAa,sBAAsB;AAC5C,SAAS,WAAW;AAyDb,SAAS,cAAc,OAAkC;AAE9D,QAAM,OAAQ,OAAe,UAAU;AACvC,QAAM,SAAS,MAAM;AAErB,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO,CAAC;AAEnD,SAAO,OAAO,QAAQ,MAAM,EAAE,IAAI,CAAC,CAAC,WAAW,QAAQ,OAAO;AAAA;AAAA,IAE5D,MAAM,UAAU,SAAS,GAAG,IACxB,UAAU,MAAM,GAAG,EAAE,IAAI,CAAC,SAAU,QAAQ,KAAK,IAAI,IAAI,SAAS,MAAM,EAAE,IAAI,IAAK,IACnF;AAAA,IACJ,QAAQ,MAAM,QAAQ,QAAQ,IAAK,WAAwB,CAAC,OAAO,QAAQ,CAAC;AAAA,EAC9E,EAAE;AACJ;AAMO,SAAS,qBAAqB,OAA+B;AAElE,QAAM,aAAa;AAGnB,MAAI,YAAY,UAAU,WAAW,IAAK,QAAO;AAEjD,SAAO,YAAY,UAAU,MAAM,WAAW;AAChD;AAMO,SAAS,wBAAwB,OAA+B;AAErE,QAAM,SAAU,OAAe,UAAU,MAAM;AAE/C,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAElD,QAAM,aAAa,OAAO,KAAK,MAAM,EAAE,CAAC;AACxC,SAAO,aAAa,OAAO,UAAU,EAAE,CAAC,IAAI;AAC9C;AAMO,SAAS,gBAA0C;AAAA,EACxD;AAAA,EACA;AAAA,EACA,iBAAiB,CAAC;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA2C;AACzC,QAAM,cAAc,eAAe;AACnC,QAAM,EAAE,QAAQ,IAAI,IAAI,OAAO;AAE/B,SAAO,YAAY;AAAA,IACjB;AAAA,IACA,WAAW,CAAC,SAAS;AAEnB,qBAAe,QAAQ,CAAC,QAAQ;AAC9B,oBAAY,kBAAkB,EAAE,UAAU,CAAC,GAAG,GAAG,EAAE,CAAC;AAAA,MACtD,CAAC;AAGD,UAAI,gBAAgB;AAClB,cAAM,MAAM,cAAc,YAAY,cAAc,IAAI;AACxD,gBAAQ,QAAQ,GAAG;AAAA,MACrB;AAGA,UAAI,cAAc,QAAQ;AACxB,eAAO,KAAK,UAAU;AAAA,MACxB;AAGA,kBAAY,IAAI;AAAA,IAClB;AAAA,IACA,SAAS,CAAC,UAAU;AAElB,YAAM,aAAa,cAAc,KAAK;AACtC,UAAI,WAAW,SAAS,GAAG;AACzB,aAAK,UAAU,UAAU;AAAA,MAC3B;AAGA,YAAM,oBAAoB,qBAAqB,KAAK;AACpD,UAAI,mBAAmB;AACrB,gBAAQ,MAAM,iBAAiB;AAAA,MACjC;AAGA,gBAAU,KAAK;AAAA,IACjB;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/index.cjs

@@ -32,10 +32,14 @@ __export(src_exports, {
   KATAKANA_HALF_WIDTH: () => KATAKANA_HALF_WIDTH,
   KATAKANA_PATTERN: () => KATAKANA_PATTERN,
   KATAKANA_WITH_NUMBERS: () => KATAKANA_WITH_NUMBERS,
+  OmnifyForm: () => OmnifyForm,
   addZodMessages: () => addZodMessages,
   createKanaRegex: () => createKanaRegex,
+  getFirstValidationError: () => getFirstValidationError,
+  getFormErrors: () => getFormErrors,
   getKanaErrorMessage: () => getKanaErrorMessage,
   getKanaPattern: () => getKanaPattern,
+  getValidationMessage: () => getValidationMessage,
   getZodFallbackLocale: () => getZodFallbackLocale,
   getZodLocale: () => getZodLocale,
   getZodMessage: () => getZodMessage,
@@ -747,20 +751,31 @@ function getFormErrors(error) {
   const data = error?.response?.data;
   const errors = data?.errors;
   if (!errors || typeof errors !== "object") return [];
-  return Object.entries(errors).map(([name, messages]) => ({
-    name,
+  return Object.entries(errors).map(([fieldName, messages]) => ({
+    // Convert "user.name" or "items.0.name" to array path for Ant Design
+    name: fieldName.includes(".") ? fieldName.split(".").map((part) => /^\d+$/.test(part) ? parseInt(part, 10) : part) : fieldName,
     errors: Array.isArray(messages) ? messages : [String(messages)]
   }));
 }
 function getValidationMessage(error) {
-  const data = error?.response?.data;
-  return data?.message || null;
+  const axiosError = error;
+  if (axiosError?.response?.status !== 422) return null;
+  return axiosError?.response?.data?.message ?? null;
+}
+function getFirstValidationError(error) {
+  const errors = error?.response?.data?.errors;
+  if (!errors || typeof errors !== "object") return null;
+  const firstField = Object.keys(errors)[0];
+  return firstField ? errors[firstField][0] : null;
 }
 function useFormMutation({
   form,
   mutationFn,
   invalidateKeys = [],
   successMessage,
+  redirectTo,
+  router,
+  translateFn,
   onSuccess,
   onError
 }) {
@@ -773,7 +788,11 @@ function useFormMutation({
         queryClient.invalidateQueries({ queryKey: [...key] });
       });
       if (successMessage) {
-        message2.success(successMessage);
+        const msg = translateFn ? translateFn(successMessage) : successMessage;
+        message2.success(msg);
+      }
+      if (redirectTo && router) {
+        router.push(redirectTo);
       }
       onSuccess?.(data);
     },
@@ -967,6 +986,13 @@ var kanaRules = {
     any: KANA_ANY_PATTERN
   }
 };
+
+// src/index.ts
+var OmnifyForm = {
+  JapaneseName: JapaneseNameField,
+  JapaneseAddress: JapaneseAddressField,
+  JapaneseBank: JapaneseBankField
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   HIRAGANA,
@@ -981,10 +1007,14 @@ var kanaRules = {
   KATAKANA_HALF_WIDTH,
   KATAKANA_PATTERN,
   KATAKANA_WITH_NUMBERS,
+  OmnifyForm,
   addZodMessages,
   createKanaRegex,
+  getFirstValidationError,
+  getFormErrors,
   getKanaErrorMessage,
   getKanaPattern,
+  getValidationMessage,
   getZodFallbackLocale,
   getZodLocale,
   getZodMessage,