@breadstone/mosaik-elements-angular 0.0.151 → 0.0.152

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## 0.0.152 (2025-10-15)
+
+### 🚀 Features
+
+- Refactor validation reporting in FormValidator2 to use IValidateHooks interface ([3f2cc3e038](https://github.com/RueDeRennes/mosaik/commit/3f2cc3e038))
+- Update AutoCompleteBox component to include new input properties and methods ([70b4f5462e](https://github.com/RueDeRennes/mosaik/commit/70b4f5462e))
+
 ## 0.0.151 (2025-09-29)
 
 ### 🚀 Features

package/fesm2022/mosaik-elements-angular.mjs

@@ -1656,6 +1656,166 @@ let AutoCompleteBoxComponent = class AutoCompleteBoxComponent {
             this._element.text = value;
         });
     }
+    get inputId() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.inputId;
+    }
+    set inputId(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.inputId = value;
+        });
+    }
+    get listboxId() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.listboxId;
+    }
+    set listboxId(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.listboxId = value;
+        });
+    }
+    get highlightedIndex() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.highlightedIndex;
+    }
+    set highlightedIndex(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.highlightedIndex = value;
+        });
+    }
+    get shouldRenderSuggestions() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.shouldRenderSuggestions;
+    }
+    set shouldRenderSuggestions(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.shouldRenderSuggestions = value;
+        });
+    }
+    get hasSuggestions() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.hasSuggestions;
+    }
+    set hasSuggestions(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.hasSuggestions = value;
+        });
+    }
+    get activeDescendantId() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.activeDescendantId;
+    }
+    set activeDescendantId(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.activeDescendantId = value;
+        });
+    }
+    get shouldShowNoResultsMessage() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.shouldShowNoResultsMessage;
+    }
+    set shouldShowNoResultsMessage(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.shouldShowNoResultsMessage = value;
+        });
+    }
+    get shouldShowLoadingState() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.shouldShowLoadingState;
+    }
+    set shouldShowLoadingState(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.shouldShowLoadingState = value;
+        });
+    }
+    get intl() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.intl;
+    }
+    set intl(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.intl = value;
+        });
+    }
+    get suggestionPlacement() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.suggestionPlacement;
+    }
+    set suggestionPlacement(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.suggestionPlacement = value;
+        });
+    }
+    get suggestionStrategy() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.suggestionStrategy;
+    }
+    set suggestionStrategy(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.suggestionStrategy = value;
+        });
+    }
+    get suggestionDistance() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.suggestionDistance;
+    }
+    set suggestionDistance(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.suggestionDistance = value;
+        });
+    }
+    get suggestionSkidding() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.suggestionSkidding;
+    }
+    set suggestionSkidding(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.suggestionSkidding = value;
+        });
+    }
+    get suggestionSync() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.suggestionSync;
+    }
+    set suggestionSync(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.suggestionSync = value;
+        });
+    }
+    get maxSuggestionHeight() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.maxSuggestionHeight;
+    }
+    set maxSuggestionHeight(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.maxSuggestionHeight = value;
+        });
+    }
+    get suggestionFlipFallbackPlacements() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.suggestionFlipFallbackPlacements;
+    }
+    set suggestionFlipFallbackPlacements(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.suggestionFlipFallbackPlacements = value;
+        });
+    }
     get themeName() {
         // @ts-ignore - temporary fix for the type error
         return this._element.themeName;
@@ -1666,6 +1826,96 @@ let AutoCompleteBoxComponent = class AutoCompleteBoxComponent {
             this._element.themeName = value;
         });
     }
+    get dropDownPlacement() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.dropDownPlacement;
+    }
+    set dropDownPlacement(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.dropDownPlacement = value;
+        });
+    }
+    get dropDownStrategy() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.dropDownStrategy;
+    }
+    set dropDownStrategy(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.dropDownStrategy = value;
+        });
+    }
+    get dropDownDistance() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.dropDownDistance;
+    }
+    set dropDownDistance(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.dropDownDistance = value;
+        });
+    }
+    get dropDownSkidding() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.dropDownSkidding;
+    }
+    set dropDownSkidding(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.dropDownSkidding = value;
+        });
+    }
+    get dropDownStaysOpen() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.dropDownStaysOpen;
+    }
+    set dropDownStaysOpen(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.dropDownStaysOpen = value;
+        });
+    }
+    get maxDropDownHeight() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.maxDropDownHeight;
+    }
+    set maxDropDownHeight(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.maxDropDownHeight = value;
+        });
+    }
+    get isDropDownOpen() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.isDropDownOpen;
+    }
+    set isDropDownOpen(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.isDropDownOpen = value;
+        });
+    }
+    get isFocused() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.isFocused;
+    }
+    set isFocused(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.isFocused = value;
+        });
+    }
+    get disabled() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.disabled;
+    }
+    set disabled(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.disabled = value;
+        });
+    }
     get minimumPrefixLength() {
         // @ts-ignore - temporary fix for the type error
         return this._element.minimumPrefixLength;
@@ -1726,6 +1976,16 @@ let AutoCompleteBoxComponent = class AutoCompleteBoxComponent {
             this._element.items = value;
         });
     }
+    get itemsProvider() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.itemsProvider;
+    }
+    set itemsProvider(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.itemsProvider = value;
+        });
+    }
     get populating() {
         // @ts-ignore - temporary fix for the type error
         return this._element.populating;
@@ -1756,6 +2016,16 @@ let AutoCompleteBoxComponent = class AutoCompleteBoxComponent {
             this._element.filteredItems = value;
         });
     }
+    get isPopulating() {
+        // @ts-ignore - temporary fix for the type error
+        return this._element.isPopulating;
+    }
+    set isPopulating(value) {
+        this._zone.runOutsideAngular(() => {
+            // @ts-ignore - temporary fix for the type error
+            this._element.isPopulating = value;
+        });
+    }
     get dir() {
         // @ts-ignore - temporary fix for the type error
         return this._element.dir;
@@ -1797,13 +2067,13 @@ let AutoCompleteBoxComponent = class AutoCompleteBoxComponent {
         }
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.0", ngImport: i0, type: AutoCompleteBoxComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.0", type: AutoCompleteBoxComponent, isStandalone: true, selector: "mosaik-autocompletebox", inputs: { text: "text", themeName: "themeName", minimumPrefixLength: "minimumPrefixLength", minimumPopulateDelay: "minimumPopulateDelay", isTextCompletionEnabled: "isTextCompletionEnabled", searchMode: "searchMode", displayMemberPath: "displayMemberPath", items: "items", populating: "populating", populated: "populated", filteredItems: "filteredItems", dir: "dir", lang: "lang" }, outputs: { connected: "connected", disconnected: "disconnected", changed: "changed" }, ngImport: i0, template: '<ng-content></ng-content>', isInline: true, changeDetection: i0.ChangeDetectionStrategy.OnPush });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.0", type: AutoCompleteBoxComponent, isStandalone: true, selector: "mosaik-autocompletebox", inputs: { text: "text", inputId: "inputId", listboxId: "listboxId", highlightedIndex: "highlightedIndex", shouldRenderSuggestions: "shouldRenderSuggestions", hasSuggestions: "hasSuggestions", activeDescendantId: "activeDescendantId", shouldShowNoResultsMessage: "shouldShowNoResultsMessage", shouldShowLoadingState: "shouldShowLoadingState", intl: "intl", suggestionPlacement: "suggestionPlacement", suggestionStrategy: "suggestionStrategy", suggestionDistance: "suggestionDistance", suggestionSkidding: "suggestionSkidding", suggestionSync: "suggestionSync", maxSuggestionHeight: "maxSuggestionHeight", suggestionFlipFallbackPlacements: "suggestionFlipFallbackPlacements", themeName: "themeName", dropDownPlacement: "dropDownPlacement", dropDownStrategy: "dropDownStrategy", dropDownDistance: "dropDownDistance", dropDownSkidding: "dropDownSkidding", dropDownStaysOpen: "dropDownStaysOpen", maxDropDownHeight: "maxDropDownHeight", isDropDownOpen: "isDropDownOpen", isFocused: "isFocused", disabled: "disabled", minimumPrefixLength: "minimumPrefixLength", minimumPopulateDelay: "minimumPopulateDelay", isTextCompletionEnabled: "isTextCompletionEnabled", searchMode: "searchMode", displayMemberPath: "displayMemberPath", items: "items", itemsProvider: "itemsProvider", populating: "populating", populated: "populated", filteredItems: "filteredItems", isPopulating: "isPopulating", dir: "dir", lang: "lang" }, outputs: { connected: "connected", disconnected: "disconnected", changed: "changed" }, ngImport: i0, template: '<ng-content></ng-content>', isInline: true, changeDetection: i0.ChangeDetectionStrategy.OnPush });
 };
 AutoCompleteBoxComponent = __decorate$3y([
     ProxyCmp({
         defineCustomElementFn: () => customElements.define('mosaik-autocompletebox', AutoCompleteBoxElement),
-        inputs: ['text', 'themeName', 'minimumPrefixLength', 'minimumPopulateDelay', 'isTextCompletionEnabled', 'searchMode', 'displayMemberPath', 'items', 'populating', 'populated', 'filteredItems', 'dir', 'lang'],
-        methods: ['onInput', 'onSelectCallback', 'onFilterCallback', 'updateSearchText', 'updateSelectedItem', 'getDisplayValue', 'adoptStyle', 'on', 'off', 'emit', 'requestUpdate']
+        inputs: ['text', 'inputId', 'listboxId', 'highlightedIndex', 'shouldRenderSuggestions', 'hasSuggestions', 'activeDescendantId', 'shouldShowNoResultsMessage', 'shouldShowLoadingState', 'intl', 'suggestionPlacement', 'suggestionStrategy', 'suggestionDistance', 'suggestionSkidding', 'suggestionSync', 'maxSuggestionHeight', 'suggestionFlipFallbackPlacements', 'themeName', 'dropDownPlacement', 'dropDownStrategy', 'dropDownDistance', 'dropDownSkidding', 'dropDownStaysOpen', 'maxDropDownHeight', 'isDropDownOpen', 'isFocused', 'disabled', 'minimumPrefixLength', 'minimumPopulateDelay', 'isTextCompletionEnabled', 'searchMode', 'displayMemberPath', 'items', 'itemsProvider', 'populating', 'populated', 'filteredItems', 'isPopulating', 'dir', 'lang'],
+        methods: ['onFilterCallback', 'onFloatingActiveChanged', 'onSelectCallback', 'onInput', 'onFocus', 'onBlur', 'onKeyDown', 'onSuggestionMouseDown', 'onSuggestionClick', 'renderHighlightedItem', 'getOptionId', 'open', 'close', 'toggle', 'hasVisibleFocusInTree', 'updateSearchText', 'updateSelectedItem', 'getDisplayValue', 'adoptStyle', 'on', 'off', 'emit', 'requestUpdate']
     }),
     __metadata$3y("design:paramtypes", [])
 ], AutoCompleteBoxComponent);
@@ -1814,13 +2084,63 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.0", ngImpor
                     standalone: true,
                     changeDetection: ChangeDetectionStrategy.OnPush,
                     template: '<ng-content></ng-content>',
-                    inputs: ['text', 'themeName', 'minimumPrefixLength', 'minimumPopulateDelay', 'isTextCompletionEnabled', 'searchMode', 'displayMemberPath', 'items', 'populating', 'populated', 'filteredItems', 'dir', 'lang'],
+                    inputs: ['text', 'inputId', 'listboxId', 'highlightedIndex', 'shouldRenderSuggestions', 'hasSuggestions', 'activeDescendantId', 'shouldShowNoResultsMessage', 'shouldShowLoadingState', 'intl', 'suggestionPlacement', 'suggestionStrategy', 'suggestionDistance', 'suggestionSkidding', 'suggestionSync', 'maxSuggestionHeight', 'suggestionFlipFallbackPlacements', 'themeName', 'dropDownPlacement', 'dropDownStrategy', 'dropDownDistance', 'dropDownSkidding', 'dropDownStaysOpen', 'maxDropDownHeight', 'isDropDownOpen', 'isFocused', 'disabled', 'minimumPrefixLength', 'minimumPopulateDelay', 'isTextCompletionEnabled', 'searchMode', 'displayMemberPath', 'items', 'itemsProvider', 'populating', 'populated', 'filteredItems', 'isPopulating', 'dir', 'lang'],
                     outputs: ['connected', 'disconnected', 'changed']
                 }]
         }], ctorParameters: () => [], propDecorators: { text: [{
                 type: Input
+            }], inputId: [{
+                type: Input
+            }], listboxId: [{
+                type: Input
+            }], highlightedIndex: [{
+                type: Input
+            }], shouldRenderSuggestions: [{
+                type: Input
+            }], hasSuggestions: [{
+                type: Input
+            }], activeDescendantId: [{
+                type: Input
+            }], shouldShowNoResultsMessage: [{
+                type: Input
+            }], shouldShowLoadingState: [{
+                type: Input
+            }], intl: [{
+                type: Input
+            }], suggestionPlacement: [{
+                type: Input
+            }], suggestionStrategy: [{
+                type: Input
+            }], suggestionDistance: [{
+                type: Input
+            }], suggestionSkidding: [{
+                type: Input
+            }], suggestionSync: [{
+                type: Input
+            }], maxSuggestionHeight: [{
+                type: Input
+            }], suggestionFlipFallbackPlacements: [{
+                type: Input
             }], themeName: [{
                 type: Input
+            }], dropDownPlacement: [{
+                type: Input
+            }], dropDownStrategy: [{
+                type: Input
+            }], dropDownDistance: [{
+                type: Input
+            }], dropDownSkidding: [{
+                type: Input
+            }], dropDownStaysOpen: [{
+                type: Input
+            }], maxDropDownHeight: [{
+                type: Input
+            }], isDropDownOpen: [{
+                type: Input
+            }], isFocused: [{
+                type: Input
+            }], disabled: [{
+                type: Input
             }], minimumPrefixLength: [{
                 type: Input
             }], minimumPopulateDelay: [{
@@ -1833,12 +2153,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.0", ngImpor
                 type: Input
             }], items: [{
                 type: Input
+            }], itemsProvider: [{
+                type: Input
             }], populating: [{
                 type: Input
             }], populated: [{
                 type: Input
             }], filteredItems: [{
                 type: Input
+            }], isPopulating: [{
+                type: Input
             }], dir: [{
                 type: Input
             }], lang: [{
@@ -60013,18 +60337,20 @@ class FormValidator2 {
      * @public
      */
     constructor() {
-        //
+        // noop
     }
     // #endregion
-    // #region Public API (marking + optional reporting)
+    // #region Methods
     /**
      * Marks each control as touched and optionally reports validation issues.
      *
      * @public
-     * @param formGroup - The form group to validate.
-     * @param options - Optional reporting callbacks.
+     * @template TGroup The specific type of the form group (for typed raw value).
+     * @param formGroup The form group to validate.
+     * @param hooks Optional validation reporting callbacks.
+     * @returns The raw form value (as returned by `formGroup.getRawValue()`).
      */
-    validate(formGroup, options) {
+    validate(formGroup, hooks) {
         const issues = [];
         this.traverse(formGroup, '', {
             onControl: (ctrl) => {
@@ -60037,25 +60363,27 @@ class FormValidator2 {
                 } // FormGroup: no-op here
             },
             onErrors: (issue) => {
-                options?.onEachError?.(issue);
+                hooks?.onEachError?.(issue);
                 issues.push(issue);
             }
         });
         if (issues.length === 0) {
-            options?.onSuccess?.();
+            hooks?.onSuccess?.(formGroup.getRawValue());
         }
         else {
-            options?.onErrors?.(issues);
+            hooks?.onErrors?.(issues);
         }
     }
     /**
      * Marks each control as pristine and optionally reports validation issues.
      *
      * @public
-     * @param formGroup - The form group to mark as pristine.
-     * @param options - Optional reporting callbacks.
+     * @template TGroup The specific type of the form group (for typed raw value).
+     * @param formGroup The form group to mark as pristine.
+     * @param hooks Optional validation reporting callbacks.
+     * @returns The raw form value (as returned by `formGroup.getRawValue()`).
      */
-    pristine(formGroup, options) {
+    pristine(formGroup, hooks) {
         const issues = [];
         this.traverse(formGroup, '', {
             onControl: (ctrl) => {
@@ -60067,24 +60395,22 @@ class FormValidator2 {
                 } // FormGroup: no-op here
             },
             onErrors: (issue) => {
-                options?.onEachError?.(issue);
+                hooks?.onEachError?.(issue);
                 issues.push(issue);
             }
         });
         if (issues.length === 0) {
-            options?.onSuccess?.();
+            hooks?.onSuccess?.(formGroup.getRawValue());
         }
         else {
-            options?.onErrors?.(issues);
+            hooks?.onErrors?.(issues);
         }
     }
-    // #endregion
-    // #region Public API (pure helpers)
     /**
      * Collects all validation issues without mutating any control state.
      *
      * @public
-     * @param formGroup - The form group to inspect.
+     * @param formGroup The form group to inspect.
      * @returns An array of validation issues.
      */
     collectErrors(formGroup) {
@@ -60099,6 +60425,8 @@ class FormValidator2 {
      * Indicates whether the form is currently valid (pure check).
      *
      * @public
+     * @param formGroup The form group to inspect.
+     * @returns `true` if no validation issues were found; `false` otherwise.
      */
     isValid(formGroup) {
         return this.collectErrors(formGroup).length === 0;
@@ -60107,6 +60435,8 @@ class FormValidator2 {
      * Builds a map from control path to its errors for quick lookup.
      *
      * @public
+     * @param issues The array of validation issues to convert.
+     * @returns A map from control path to its validation errors.
      */
     toPathMap(issues) {
         const map = Object.create(null);
@@ -60119,12 +60449,12 @@ class FormValidator2 {
      * Starts a fluent validation session.
      *
      * @public
+     * @param formGroup The form group to validate.
+     * @returns A new `ValidationSession` instance.
      */
     session(formGroup) {
         return new ValidationSession(this, formGroup);
     }
-    // #endregion
-    // #region Core traversal
     /**
      * Internal traversal utility: can mutate state (via `onControl`) and
      * collect/report issues (via `onErrors`) in a single pass.
@@ -60191,11 +60521,12 @@ class ValidationSession {
         this._pristine = false;
     }
     // #endregion
-    // #region Fluent steps
+    // #region Methods
     /**
      * Mark all controls as touched.
      *
      * @public
+     * @returns This validation session (for chaining).
      */
     touch() {
         this._touch = true;
@@ -60205,6 +60536,7 @@ class ValidationSession {
      * Mark all controls as pristine.
      *
      * @public
+     * @returns This validation session (for chaining).
      */
     pristine() {
         this._pristine = true;
@@ -60214,6 +60546,8 @@ class ValidationSession {
      * Provide a per-issue callback invoked during traversal.
      *
      * @public
+     * @param cb The callback to invoke for each issue found.
+     * @returns This validation session (for chaining).
      */
     onEachError(cb) {
         this._onEachError = cb;
@@ -60223,6 +60557,8 @@ class ValidationSession {
      * Provide a single callback to receive all issues after traversal.
      *
      * @public
+     * @param cb The callback to invoke with all issues found.
+     * @returns This validation session (for chaining).
      */
     onErrors(cb) {
         this._onErrors = cb;
@@ -60232,6 +60568,8 @@ class ValidationSession {
      * Provide a callback that fires when no issues are found.
      *
      * @public
+     * @param cb The callback to invoke on success.
+     * @returns This validation session (for chaining).
      */
     onSuccess(cb) {
         this._onSuccess = cb;