@vectoriox/iox-ui 4.42.0 → 4.43.0

package/index.d.ts

@@ -1137,6 +1137,20 @@ declare class IoxFormComponent implements OnChanges, OnInit {
     name: string;
     renderState: FormRenderState | string;
     feedback: FeedbackTiming | string;
+    /**
+     * Move focus to the first field that failed, instead of leaving the visitor to hunt for red
+     * text. On by default — the single most valuable thing a failed submit can do.
+     */
+    focusFirstProblem: boolean;
+    /**
+     * Speak the failure the moment it happens. Without this a screen-reader user only learns a
+     * submit failed if they happen to tab back into the message — the error text is rendered, but
+     * nothing directs them to it.
+     */
+    announceFailure: boolean;
+    /** What the live region is currently saying. Empty between attempts so the same failure
+     *  announces again rather than being swallowed as an unchanged value. */
+    announcement: string;
     /**
      * Emitted ONLY when client-side validation passes, carrying the collected values. The host
      * (builder canvas or engine runtime) owns the transport — posting, retries and the server's
@@ -1176,9 +1190,15 @@ declare class IoxFormComponent implements OnChanges, OnInit {
     private honeypotValue;
     /** Blank the real DOM controls after a success. The runtime state alone would leave them filled. */
     private resetControls;
+    /**
+     * Put the failure into the live region. Cleared first so two identical failures in a row are
+     * two announcements, not one — a live region only speaks on CHANGE, and "same error again"
+     * is exactly when a visitor most needs telling.
+     */
+    private announce;
     private focusFirstInvalid;
     static ɵfac: i0.ɵɵFactoryDeclaration<IoxFormComponent, [null, null, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<IoxFormComponent, "form[iox-form]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; "formId": { "alias": "formId"; "required": false; }; "name": { "alias": "name"; "required": false; }; "renderState": { "alias": "renderState"; "required": false; }; "feedback": { "alias": "feedback"; "required": false; }; }, { "formSubmit": "formSubmit"; "validationFailed": "validationFailed"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IoxFormComponent, "form[iox-form]", never, { "nodeId": { "alias": "nodeId"; "required": false; }; "formId": { "alias": "formId"; "required": false; }; "name": { "alias": "name"; "required": false; }; "renderState": { "alias": "renderState"; "required": false; }; "feedback": { "alias": "feedback"; "required": false; }; "focusFirstProblem": { "alias": "focusFirstProblem"; "required": false; }; "announceFailure": { "alias": "announceFailure"; "required": false; }; }, { "formSubmit": "formSubmit"; "validationFailed": "validationFailed"; }, never, never, false, never>;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-ui",
-  "version": "4.42.0",
+  "version": "4.43.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",