@ahrowe/ui 0.1.4 → 0.1.5

package/dist/types/package/services/formValidation/FormValidatorGroupWithForm.d.ts

@@ -6,6 +6,9 @@ import { default as React } from 'react';
  *
  * This is the class you should use everywhere — it is a drop-in replacement
  * for FormValidatorGroup with one extra property: `this.Form`.
+ *
+ * Also injects the default toast-based onSubmitError so both hook and class-component
+ * consumers surface errors out of the box; pass options.onSubmitError to override.
  */
 export default class FormValidatorGroupWithForm<TGroup extends FormGroup = FormGroup, TInitial = InferGroupValues<TGroup>> extends FormValidatorGroup<TGroup, TInitial> {
     Form: React.FC<React.FormHTMLAttributes<HTMLFormElement>>;

package/dist/types/package/services/formValidation/formValidatorGroup.d.ts

@@ -16,6 +16,7 @@ export interface FormValidatorGroupOptions<TGroup extends FormGroup = FormGroup,
     onSubmit?: (values: MergedValues<TInitial, TGroup>, group: FormValidatorGroup<TGroup, TInitial>) => Promise<void> | void;
     onValidate?: (group: FormValidatorGroup<TGroup, TInitial>) => ValidationError | null | void;
     errorParser?: ErrorParser;
+    onSubmitError?: (errors: ValidationError[]) => void;
 }
 interface ComponentLike {
     forceUpdate: () => void;
@@ -27,6 +28,7 @@ export default class FormValidatorGroup<TGroup extends FormGroup = FormGroup, TI
     onSubmitCallback: (values: MergedValues<TInitial, TGroup>, group: FormValidatorGroup<TGroup, TInitial>) => Promise<void> | void;
     onValidateCallback: (group: FormValidatorGroup<TGroup, TInitial>) => ValidationError | null | void;
     errorParser: ErrorParser;
+    onSubmitError: (errors: ValidationError[]) => void;
     submitCount: number;
     onDebounce: (values: MergedValues<TInitial, TGroup>) => void;
     onReset: (group: FormValidatorGroup<TGroup, TInitial>, valuesAfterCreation: FormValues, initialValues: TInitial) => void;
@@ -35,7 +37,7 @@ export default class FormValidatorGroup<TGroup extends FormGroup = FormGroup, TI
      * @param component          - Class component instance for forceUpdate (pass null when using hooks)
      * @param options            - initialValues, onSubmit, onValidate, errorParser
      */
-    constructor(formValidatorGroup: TGroup, component?: ComponentLike | null, { initialValues, onSubmit, onValidate, errorParser, }?: FormValidatorGroupOptions<TGroup, TInitial>);
+    constructor(formValidatorGroup: TGroup, component?: ComponentLike | null, { initialValues, onSubmit, onValidate, errorParser, onSubmitError, }?: FormValidatorGroupOptions<TGroup, TInitial>);
     get isSubmitting(): boolean;
     get wasTouched(): boolean;
     get isDirty(): boolean;
@@ -45,7 +47,11 @@ export default class FormValidatorGroup<TGroup extends FormGroup = FormGroup, TI
     set: (validatorName: keyof TGroup & string, value: unknown) => this;
     reset: (toOverride?: FormValues) => void;
     resetDirtyAndTouched: () => void;
-    /** Parses an API error and pushes field-level errors into the matching validators. */
+    /**
+     * Parses an API error and pushes field-level errors into the matching validators.
+     * When field errors are found and isInternal is set, surfaces the first field message.
+     * When the error shape isn't recognised (no field errors), always surfaces a generic message.
+     */
     parseError: (err: unknown, isInternal?: boolean) => void;
     registerOnUpdateListener: (callback: UpdateListener) => void;
     removeOnUpdateListener: (callback: UpdateListener) => void;

package/dist/types/package/services/formValidation/useFormValidatorGroup.d.ts

@@ -8,8 +8,11 @@ import { FormGroup, FormValidatorGroupOptions, InferGroupValues } from './formVa
  * onSubmit / onValidate are kept fresh via refs — they always reflect the latest
  * closure without needing to be listed in effect dependencies.
  *
+ * onSubmitError defaults to showing the message as an error toast (provided by FormValidatorGroupWithForm);
+ * pass options.onSubmitError to override.
+ *
  * @param groupDef - Map of field name → FormValidator instance
- * @param options  - initialValues, onSubmit, onValidate, errorParser
+ * @param options  - initialValues, onSubmit, onValidate, errorParser, onSubmitError
  *
  * @example
  * const form = useFormValidatorGroup(
@@ -20,4 +23,4 @@ import { FormGroup, FormValidatorGroupOptions, InferGroupValues } from './formVa
  *   },
  * );
  */
-export declare function useFormValidatorGroup<TGroup extends FormGroup = FormGroup, TInitial = InferGroupValues<TGroup>>(groupDef: TGroup, { initialValues, onSubmit, onValidate, errorParser }?: FormValidatorGroupOptions<TGroup, TInitial>): FormValidatorGroup<TGroup, TInitial>;
+export declare function useFormValidatorGroup<TGroup extends FormGroup = FormGroup, TInitial = InferGroupValues<TGroup>>(groupDef: TGroup, { initialValues, onSubmit, onValidate, errorParser, onSubmitError }?: FormValidatorGroupOptions<TGroup, TInitial>): FormValidatorGroup<TGroup, TInitial>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahrowe/ui",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "publishConfig": {
     "access": "public"
   },
@@ -37,7 +37,7 @@
   },
   "style": "./dist/style.css",
   "bin": {
-    "ahrowe-ui-mcp": "./dist/mcp"
+    "ahrowe-ui-mcp": "./dist/mcp.js"
   },
   "files": [
     "dist",