@page-speed/forms 0.4.4 → 0.4.6

package/dist/{types-BBif0kuP.d.cts → types-4ppM117e.d.cts}

@@ -275,6 +275,34 @@ interface UseFieldReturn<T = any> {
         setError: (error: string | undefined) => void;
     };
 }
+type FormSubmissionBehavior = "showConfirmation" | "redirect" | "renderCustomComponent";
+interface NewFormSubmissionActionConfig {
+    /**
+     * Whether to render the "new submission" action.
+     * If omitted, defaults to true when `label` is provided.
+     */
+    enable?: boolean;
+    /**
+     * Optional custom button label.
+     */
+    label?: string;
+}
+interface FormSubmissionConfig {
+    /**
+     * Post-submit UI behavior.
+     * @default "showConfirmation"
+     */
+    behavior?: FormSubmissionBehavior;
+    /**
+     * Optional custom component rendered after successful submission when
+     * behavior is "renderCustomComponent".
+     */
+    customComponent?: ReactNode;
+    /**
+     * Optional configuration for allowing a fresh submission in the same session.
+     */
+    newFormSubmissionAction?: NewFormSubmissionActionConfig;
+}
 /**
  * Form component props
  */
@@ -304,6 +332,30 @@ interface FormProps<T extends FormValues = FormValues> {
      * @default true
      */
     noValidate?: boolean;
+    /**
+     * Optional submission behavior configuration.
+     */
+    submissionConfig?: FormSubmissionConfig;
+    /**
+     * Optional success message shown after successful submission.
+     */
+    successMessage?: ReactNode;
+    /**
+     * Optional submission error shown below the form actions.
+     */
+    submissionError?: ReactNode;
+    /**
+     * Additional className for success feedback.
+     */
+    successMessageClassName?: string;
+    /**
+     * Additional className for error feedback.
+     */
+    errorMessageClassName?: string;
+    /**
+     * Optional callback invoked when the user starts a new submission.
+     */
+    onNewSubmission?: () => void;
 }
 /**
  * Field component props
@@ -400,4 +452,4 @@ interface InputProps<T = string> {
     "aria-required"?: boolean;
 }
 
-export type { ErrorHandler as E, FieldValidator as F, InputProps as I, SubmissionStatus as S, TouchedFields as T, UseFormOptions as U, ValidationSchema as V, ValidationMode as a, FormValues as b, UseFormReturn as c, UseFieldOptions as d, UseFieldReturn as e, FormProps as f, FieldProps as g, FormErrors as h, FormHelpers as i, SubmitHandler as j, FormState as k, FormActions as l, FieldInputProps as m, FieldMeta as n };
+export type { ErrorHandler as E, FieldValidator as F, InputProps as I, NewFormSubmissionActionConfig as N, SubmissionStatus as S, TouchedFields as T, UseFormOptions as U, ValidationSchema as V, ValidationMode as a, FormValues as b, UseFormReturn as c, UseFieldOptions as d, UseFieldReturn as e, FormProps as f, FieldProps as g, FormErrors as h, FormSubmissionBehavior as i, FormSubmissionConfig as j, FormHelpers as k, SubmitHandler as l, FormState as m, FormActions as n, FieldInputProps as o, FieldMeta as p };

package/dist/{types-BBif0kuP.d.ts → types-4ppM117e.d.ts}

@@ -275,6 +275,34 @@ interface UseFieldReturn<T = any> {
         setError: (error: string | undefined) => void;
     };
 }
+type FormSubmissionBehavior = "showConfirmation" | "redirect" | "renderCustomComponent";
+interface NewFormSubmissionActionConfig {
+    /**
+     * Whether to render the "new submission" action.
+     * If omitted, defaults to true when `label` is provided.
+     */
+    enable?: boolean;
+    /**
+     * Optional custom button label.
+     */
+    label?: string;
+}
+interface FormSubmissionConfig {
+    /**
+     * Post-submit UI behavior.
+     * @default "showConfirmation"
+     */
+    behavior?: FormSubmissionBehavior;
+    /**
+     * Optional custom component rendered after successful submission when
+     * behavior is "renderCustomComponent".
+     */
+    customComponent?: ReactNode;
+    /**
+     * Optional configuration for allowing a fresh submission in the same session.
+     */
+    newFormSubmissionAction?: NewFormSubmissionActionConfig;
+}
 /**
  * Form component props
  */
@@ -304,6 +332,30 @@ interface FormProps<T extends FormValues = FormValues> {
      * @default true
      */
     noValidate?: boolean;
+    /**
+     * Optional submission behavior configuration.
+     */
+    submissionConfig?: FormSubmissionConfig;
+    /**
+     * Optional success message shown after successful submission.
+     */
+    successMessage?: ReactNode;
+    /**
+     * Optional submission error shown below the form actions.
+     */
+    submissionError?: ReactNode;
+    /**
+     * Additional className for success feedback.
+     */
+    successMessageClassName?: string;
+    /**
+     * Additional className for error feedback.
+     */
+    errorMessageClassName?: string;
+    /**
+     * Optional callback invoked when the user starts a new submission.
+     */
+    onNewSubmission?: () => void;
 }
 /**
  * Field component props
@@ -400,4 +452,4 @@ interface InputProps<T = string> {
     "aria-required"?: boolean;
 }
 
-export type { ErrorHandler as E, FieldValidator as F, InputProps as I, SubmissionStatus as S, TouchedFields as T, UseFormOptions as U, ValidationSchema as V, ValidationMode as a, FormValues as b, UseFormReturn as c, UseFieldOptions as d, UseFieldReturn as e, FormProps as f, FieldProps as g, FormErrors as h, FormHelpers as i, SubmitHandler as j, FormState as k, FormActions as l, FieldInputProps as m, FieldMeta as n };
+export type { ErrorHandler as E, FieldValidator as F, InputProps as I, NewFormSubmissionActionConfig as N, SubmissionStatus as S, TouchedFields as T, UseFormOptions as U, ValidationSchema as V, ValidationMode as a, FormValues as b, UseFormReturn as c, UseFieldOptions as d, UseFieldReturn as e, FormProps as f, FieldProps as g, FormErrors as h, FormSubmissionBehavior as i, FormSubmissionConfig as j, FormHelpers as k, SubmitHandler as l, FormState as m, FormActions as n, FieldInputProps as o, FieldMeta as p };

package/dist/validation-rules.d.cts

@@ -1,4 +1,4 @@
-import { F as FieldValidator } from './types-BBif0kuP.cjs';
+import { F as FieldValidator } from './types-4ppM117e.cjs';
 import 'react';
 
 /**

package/dist/validation-rules.d.ts

@@ -1,4 +1,4 @@
-import { F as FieldValidator } from './types-BBif0kuP.js';
+import { F as FieldValidator } from './types-4ppM117e.js';
 import 'react';
 
 /**

package/dist/validation-utils.d.cts

@@ -1,4 +1,4 @@
-import { F as FieldValidator, b as FormValues } from './types-BBif0kuP.cjs';
+import { F as FieldValidator, b as FormValues } from './types-4ppM117e.cjs';
 import 'react';
 
 /**

package/dist/validation-utils.d.ts

@@ -1,4 +1,4 @@
-import { F as FieldValidator, b as FormValues } from './types-BBif0kuP.js';
+import { F as FieldValidator, b as FormValues } from './types-4ppM117e.js';
 import 'react';
 
 /**

package/dist/validation-valibot.d.cts

@@ -1,4 +1,4 @@
-import { b as FormValues, V as ValidationSchema, F as FieldValidator } from './types-BBif0kuP.cjs';
+import { b as FormValues, V as ValidationSchema, F as FieldValidator } from './types-4ppM117e.cjs';
 import 'react';
 
 /**

package/dist/validation-valibot.d.ts

@@ -1,4 +1,4 @@
-import { b as FormValues, V as ValidationSchema, F as FieldValidator } from './types-BBif0kuP.js';
+import { b as FormValues, V as ValidationSchema, F as FieldValidator } from './types-4ppM117e.js';
 import 'react';
 
 /**

package/dist/validation.d.cts

@@ -1,4 +1,4 @@
-export { F as FieldValidator, a as ValidationMode, V as ValidationSchema } from './types-BBif0kuP.cjs';
+export { F as FieldValidator, a as ValidationMode, V as ValidationSchema } from './types-4ppM117e.cjs';
 export { ErrorMessageFn, ValidationRuleOptions, alpha, alphanumeric, compose, creditCard, email, integer, matches, max, maxLength, min, minLength, numeric, oneOf, pattern, phone, postalCode, required, url } from './validation-rules.cjs';
 export { DebounceOptions, ErrorMessages, MessageTemplate, asyncValidator, crossFieldValidator, debounce, defaultMessages, getErrorMessage, messageRegistry, resetErrorMessages, setErrorMessages, when, withRaceConditionPrevention } from './validation-utils.cjs';
 import 'react';

package/dist/validation.d.ts

@@ -1,4 +1,4 @@
-export { F as FieldValidator, a as ValidationMode, V as ValidationSchema } from './types-BBif0kuP.js';
+export { F as FieldValidator, a as ValidationMode, V as ValidationSchema } from './types-4ppM117e.js';
 export { ErrorMessageFn, ValidationRuleOptions, alpha, alphanumeric, compose, creditCard, email, integer, matches, max, maxLength, min, minLength, numeric, oneOf, pattern, phone, postalCode, required, url } from './validation-rules.js';
 export { DebounceOptions, ErrorMessages, MessageTemplate, asyncValidator, crossFieldValidator, debounce, defaultMessages, getErrorMessage, messageRegistry, resetErrorMessages, setErrorMessages, when, withRaceConditionPrevention } from './validation-utils.js';
 import 'react';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@page-speed/forms",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "Ultra-high-performance React form library with field-level reactivity and tree-shakable architecture",
   "keywords": [
     "react",
@@ -117,7 +117,7 @@
     "vitest": "^4.0.10"
   },
   "dependencies": {
-    "@opensite/hooks": "2.0.6",
+    "@opensite/hooks": "2.0.7",
     "clsx": "^2.1.1",
     "tailwind-merge": "^3.4.0"
   },