@xh/hoist 80.0.0-SNAPSHOT.1768323341476 → 80.0.0-SNAPSHOT.1768360784265

package/CHANGELOG.md

@@ -4,7 +4,12 @@
 
 ### 💥 Breaking Changes
 
-* Completed the refactoring away from `loadModel` to `loadObserver` started in v79:
+* Modified several CSS classes related to `FormField` to better follow BEM conventions.
+    * ⚠️The commonly targeted `xh-form-field-label` class is now `xh-form-field__label`, although
+      please review new CSS vars (below) and consider using those instead of class-based selectors.
+    * Modifier classes now follow BEM conventions (e.g. `xh-form-field-invalid` is now
+      `xh-form-field--invalid`).
+* Completed the refactoring from `loadModel` to `loadObserver` started in v79:
     * Renamed `XH.appLoadModel` to `XH.appLoadObserver`. The prior getter remains as an alias but is
       deprecated and scheduled for removal in v82.
     * Renamed `AppContainerModel.loadModel` to `loadObserver`. This is primarily an internal model,
@@ -17,6 +22,8 @@
 
 ### 🎁 New Features
 
+* Enhanced `Field.rules` to support `warning` and `info` severity. Useful for non-blocking
+  validation scenarios, such as providing guidance to users without preventing form submission.
 * Added new `AppMenuButton.renderWithUserProfile` prop as a built-in alternative to the default
   hamburger menu. Set to `true` to render the current user's initials instead or provide a function
   to render a custom element for the user.
@@ -27,8 +34,25 @@
 * Introduced new `FilterBindTarget` and `FilterValueSource` interfaces to generalize the data
   sources that could be used with `FilterChooserModel` and `GridFilterModel`. Both `Store` and
   `View` implement these interfaces, meaning no changes are required for apps, but it is now
-  possible to use these models with other, alternate implementations if needed.
-* Added new static typeguard methods on `Store`, `View`, and `Filter` + subclasses.
+  possible to use these models with alternate implementations.
+* Added new static typeguard methods on `Store`, `View`, and `Filter` + its subclasses.
+* Removed `RecordErrorMap` + reorganized validation types (not expected to impact most apps).
+
+### ✨ Styles
+
+* Applied the app-wide `--xh-font-family` to `input` elements. Previously these had continued to
+  take a default font defined by the browser stylesheet.
+    * Customize for inputs if needed via `--xh-input-font-family`.
+    * Note that the switch to Hoist's default Inter font w/tabular numbers might require some
+      inputs w/tight sizing to be made wider to avoid clipping (e.g. `DateInputs` sized to fit).
+* Updated + added validation-related `FormField` CSS classes and variables to account for new `info`
+  and `warning` validation levels. Additionally validation messages and the `info` text element no
+  longer clip at a single line - they will wrap as needed.
+* Added new CSS variables for `FormField` to allow easier customization of commonly adjusted styles,
+  with a focus on labels. See `vars.scss` for the full list. Consider replacing existing class-based
+  CSS overrides with overrides to variables where possible.
+* Added new CSS variables `--xh-intent-danger-text-color` (and others). Consider using these when
+  styling text with Hoist intent colors to enhance legibility in dark mode.
 
 ## 79.0.0 - 2026-01-05
 

package/admin/tabs/activity/tracking/ActivityTracking.scss

@@ -9,7 +9,7 @@
   .xh-toolbar .xh-form-field {
     margin: 0 0 0 var(--xh-tbar-item-pad-px);
 
-    .xh-form-field-label {
+    .xh-form-field__label {
       min-width: 0 !important;
       margin-right: 6px;
     }
@@ -60,7 +60,12 @@
       margin: 0;
       padding: 2px var(--xh-pad-px);
 
-      &.xh-form-field-readonly .xh-form-field-readonly-display {
+      &__label {
+        font-size: var(--xh-font-size-small-px);
+        padding: 0;
+      }
+
+      &__readonly-display {
         padding: var(--xh-pad-half-px);
       }
 
@@ -68,11 +73,6 @@
         background-color: var(--xh-grid-bg-odd);
       }
     }
-
-    .xh-form-field-label {
-      font-size: var(--xh-font-size-small-px);
-      padding: 0;
-    }
   }
 
   h3 {

package/admin/tabs/userData/roles/details/RoleDetails.scss

@@ -6,7 +6,12 @@
       margin: 0;
       padding: 2px var(--xh-pad-px);
 
-      &.xh-form-field-readonly .xh-form-field-readonly-display {
+      &__label {
+        font-size: var(--xh-font-size-small-px);
+        padding: 0;
+      }
+
+      &__readonly-display {
         padding: var(--xh-pad-half-px);
       }
 
@@ -14,10 +19,5 @@
         background-color: var(--xh-grid-bg-odd);
       }
     }
-
-    .xh-form-field-label {
-      font-size: var(--xh-font-size-small-px);
-      padding: 0;
-    }
   }
 }

package/build/types/cmp/form/FormModel.d.ts

@@ -119,7 +119,7 @@ export declare class FormModel extends HoistModel {
     get isValid(): boolean;
     /** List of all validation errors for this form. */
     get allErrors(): string[];
-    /** Recompute all validations and return true if the form is valid. */
+    /** Recompute all ValidationResults and return true if the form is valid. */
     validateAsync(opts?: FormValidateOptions): Promise<boolean>;
     /** Trigger the display of validation errors (if any) by bound `FormField`s. */
     displayValidation(): void;

package/build/types/cmp/form/field/BaseFieldModel.d.ts

@@ -1,5 +1,5 @@
 import { HoistModel } from '@xh/hoist/core';
-import { Rule, RuleLike, ValidationState } from '@xh/hoist/data';
+import { Rule, RuleLike, ValidationResult, ValidationState } from '@xh/hoist/data';
 import { FormModel } from '../FormModel';
 export interface BaseFieldConfig {
     /** Unique name for this field within its parent FormModel. */
@@ -58,7 +58,7 @@ export declare abstract class BaseFieldModel extends HoistModel {
     private _formModel;
     private origInitialValue;
     boundInputRef: import("react").RefObject<unknown> & import("react").RefCallback<unknown>;
-    private _errors;
+    private validationResultsInternal;
     private validationTask;
     private validationRunId;
     constructor({ name, displayName, initialValue, disabled, readonly, rules }: BaseFieldConfig);
@@ -79,8 +79,12 @@ export declare abstract class BaseFieldModel extends HoistModel {
     setValue(v: any): void;
     /** All validation errors for this field. */
     get errors(): string[];
+    /** All ValidationResults for this field. */
+    get validationResults(): ValidationResult[];
     /** All validation errors for this field and its sub-forms. */
     get allErrors(): string[];
+    /** All ValidationResults for this field and its sub-forms. */
+    get allValidationResults(): ValidationResult[];
     /**
      * Set the initial value of the field, reset to that value, and reset validation state.
      *
@@ -137,7 +141,7 @@ export declare abstract class BaseFieldModel extends HoistModel {
      */
     get isRequired(): boolean;
     /**
-     * Recompute all validations and return true if the field is valid.
+     * Recompute all ValidationResults and return true if the field is valid.
      *
      * @param display - true to trigger the display of validation errors (if any)
      *      by the bound FormField component after validation is complete.

package/build/types/cmp/form/field/SubformsFieldModel.d.ts

@@ -1,5 +1,5 @@
 import { PlainObject } from '@xh/hoist/core';
-import { ValidationState } from '@xh/hoist/data';
+import { ValidationResult, ValidationState } from '@xh/hoist/data';
 import { FormModel } from '../FormModel';
 import { BaseFieldModel, BaseFieldConfig } from './BaseFieldModel';
 import { FormConfig } from '../FormModel';
@@ -33,7 +33,7 @@ export interface SubformAddOptions {
  * all existing form contents to new values. Call {@link add} or {@link remove} on one of these
  * fields to adjust the contents of its collection while preserving existing state.
  *
- * Validation rules for the entire collection may be specified as for any field, but validations on
+ * Validation rules for the entire collection may be specified as for any field, but ValidationResults on
  * the subforms will also bubble up to this field, affecting its overall validation state.
  */
 export declare class SubformsFieldModel extends BaseFieldModel {
@@ -51,7 +51,7 @@ export declare class SubformsFieldModel extends BaseFieldModel {
     setValue(v: any): void;
     get formModel(): FormModel;
     set formModel(formModel: FormModel);
-    get allErrors(): string[];
+    get allValidationResults(): ValidationResult[];
     reset(): void;
     displayValidation(includeSubforms?: boolean): void;
     get isValidationPending(): boolean;

package/build/types/cmp/grid/Grid.d.ts

@@ -55,7 +55,7 @@ export declare class GridLocalModel extends HoistModel {
     getColumnDefs(): Array<ColDef | ColGroupDef>;
     getContextMenuItems: (params: GetContextMenuItemsParams) => (string | import("ag-grid-community").MenuItemDef<any, any>)[];
     dataReaction(): {
-        track: () => (boolean | RecordSet | import("../../data").StoreRecord[] | import("@xh/hoist/core").VSide)[];
+        track: () => (boolean | import("../../data").StoreRecord[] | RecordSet | import("@xh/hoist/core").VSide)[];
         run: () => void;
     };
     selectionReaction(): {
@@ -92,7 +92,7 @@ export declare class GridLocalModel extends HoistModel {
         run: () => void;
     };
     validationDisplayReaction(): {
-        track: () => (boolean | import("../../data/impl/StoreValidator").StoreErrorMap)[];
+        track: () => (boolean | import("../../data").StoreValidationMessagesMap)[];
         run: () => void;
         debounce: number;
     };

package/build/types/data/Field.d.ts

@@ -1,4 +1,5 @@
-import { Rule, RuleLike } from './validation/Rule';
+import { RuleLike } from '@xh/hoist/data/validation/Types';
+import { Rule } from './validation/Rule';
 /**
  * Constructor arguments for a Hoist data package Field.
  */

package/build/types/data/Store.d.ts

@@ -1,7 +1,7 @@
 import { HoistBase, PlainObject, Some } from '@xh/hoist/core';
-import { Field, FieldSpec, Filter, FilterBindTarget, FilterLike, FilterValueSource, StoreRecord, StoreRecordId, StoreRecordOrId } from '@xh/hoist/data';
+import { Field, FieldSpec, Filter, FilterBindTarget, FilterLike, FilterValueSource, StoreRecord, StoreRecordId, StoreRecordOrId, StoreValidationMessagesMap, StoreValidationResultsMap, ValidationResult } from '@xh/hoist/data';
+import { StoreValidator } from '@xh/hoist/data/impl/StoreValidator';
 import { RecordSet } from './impl/RecordSet';
-import { StoreErrorMap, StoreValidator } from './impl/StoreValidator';
 export interface StoreConfig {
     /** Field names, configs, or instances. */
     fields?: Array<string | FieldSpec | Field>;
@@ -339,11 +339,14 @@ export declare class Store extends HoistBase implements FilterBindTarget, Filter
     /** True if the store is empty before filters have been applied */
     get allEmpty(): boolean;
     get maxDepth(): number;
-    get errors(): StoreErrorMap;
+    get errors(): StoreValidationMessagesMap;
+    get validationResults(): StoreValidationResultsMap;
     /** Count of all validation errors for the store. */
     get errorCount(): number;
     /** Array of all errors for this store. */
     get allErrors(): string[];
+    /** Array of all ValidationResults for this store. */
+    get allValidationResults(): ValidationResult[];
     /**
      * Get a record by ID, or null if no matching record found.
      *
@@ -387,7 +390,7 @@ export declare class Store extends HoistBase implements FilterBindTarget, Filter
     get isValid(): boolean;
     /** True if the store is confirmed to be NotValid. */
     get isNotValid(): boolean;
-    /** Recompute validations for all records and return true if the store is valid. */
+    /** Recompute ValidationResults for all records and return true if the store is valid. */
     validateAsync(): Promise<boolean>;
     /** Destroy this store, cleaning up any resources used. */
     destroy(): void;

package/build/types/data/StoreRecord.d.ts

@@ -1,4 +1,5 @@
 import { PlainObject } from '@xh/hoist/core';
+import { ValidationResult } from '@xh/hoist/data/validation/Types';
 import { Store } from './Store';
 import { ValidationState } from './validation/ValidationState';
 import { RecordValidator } from './impl/RecordValidator';
@@ -81,8 +82,12 @@ export declare class StoreRecord {
     get validationState(): ValidationState;
     /** Map of field names to list of errors. */
     get errors(): Record<string, string[]>;
+    /** Map of field names to list of ValidationResults. */
+    get validationResults(): Record<string, ValidationResult[]>;
     /** Array of all errors for this record. */
     get allErrors(): string[];
+    /** Array of all ValidationResults for this record. */
+    get allValidationResults(): ValidationResult[];
     /** Count of all validation errors for the record. */
     get errorCount(): number;
     /** True if any fields are currently recomputing their validation state. */

package/build/types/data/impl/RecordValidator.d.ts

@@ -1,14 +1,13 @@
-import { Field, Rule, StoreRecord, StoreRecordId, ValidationState } from '@xh/hoist/data';
-import { TaskObserver } from '../../core';
+import { Field, RecordValidationMessagesMap, RecordValidationResultsMap, Rule, StoreRecord, StoreRecordId, ValidationResult, ValidationState } from '@xh/hoist/data';
 /**
  * Computes validation state for a StoreRecord.
  * @internal
  */
 export declare class RecordValidator {
     record: StoreRecord;
-    _fieldErrors: RecordErrorMap;
-    _validationTask: TaskObserver;
-    _validationRunId: number;
+    private fieldValidations;
+    private validationTask;
+    private validationRunId;
     get id(): StoreRecordId;
     /** True if the record is confirmed to be Valid. */
     get isValid(): boolean;
@@ -17,7 +16,9 @@ export declare class RecordValidator {
     /** The current validation state of the record. */
     get validationState(): ValidationState;
     /** Map of field names to field-level errors. */
-    get errors(): RecordErrorMap;
+    get errors(): RecordValidationMessagesMap;
+    /** Map of field names to field-level ValidationResults. */
+    get validationResults(): RecordValidationResultsMap;
     /** Count of all validation errors for the record. */
     get errorCount(): number;
     /** True if any fields are currently recomputing their validation state. */
@@ -27,13 +28,11 @@ export declare class RecordValidator {
         record: StoreRecord;
     });
     /**
-     * Recompute validations for the record and return true if valid.
+     * Recompute ValidationResults for the record and return true if valid.
      */
     validateAsync(): Promise<boolean>;
     /** The current validation state for the record. */
     getValidationState(): ValidationState;
-    evaluateRuleAsync(record: StoreRecord, field: Field, rule: Rule): Promise<string[]>;
+    evaluateRuleAsync(record: StoreRecord, field: Field, rule: Rule): Promise<ValidationResult[]>;
     ruleIsActive(record: StoreRecord, field: Field, rule: Rule): boolean;
 }
-/** Map of Field names to Field-level error lists. */
-export type RecordErrorMap = Record<string, string[]>;

package/build/types/data/impl/StoreValidator.d.ts

@@ -1,6 +1,6 @@
 import { HoistBase } from '@xh/hoist/core';
-import { RecordErrorMap, RecordValidator } from './RecordValidator';
-import { ValidationState } from '../validation/ValidationState';
+import { StoreValidationMessagesMap, StoreValidationResultsMap, ValidationState } from '@xh/hoist/data';
+import { RecordValidator } from './RecordValidator';
 import { Store } from '../Store';
 import { StoreRecordId } from '../StoreRecord';
 /**
@@ -16,9 +16,11 @@ export declare class StoreValidator extends HoistBase {
     /** The current validation state of the store. */
     get validationState(): ValidationState;
     /** Map of StoreRecord IDs to StoreRecord-level error maps. */
-    get errors(): StoreErrorMap;
+    get errors(): StoreValidationMessagesMap;
     /** Count of all validation errors for the store. */
     get errorCount(): number;
+    /** Map of StoreRecord IDs to StoreRecord-level ValidationResults maps. */
+    get validationResults(): StoreValidationResultsMap;
     /** True if any records are currently recomputing their validation state. */
     get isPending(): boolean;
     get validators(): RecordValidator[];
@@ -27,13 +29,14 @@ export declare class StoreValidator extends HoistBase {
         store: Store;
     });
     /**
-     * Recompute validations for the store and return true if valid.
+     * Recompute ValidationResults for the store and return true if valid.
      */
     validateAsync(): Promise<boolean>;
     /** @returns The current validation state for the store. */
     getValidationState(): ValidationState;
     /** @returns map of StoreRecord IDs to StoreRecord-level error maps. */
-    getErrorMap(): StoreErrorMap;
+    getErrorMap(): StoreValidationMessagesMap;
+    getValidationResultsMap(): StoreValidationResultsMap;
     /**
      * @param id - ID of RecordValidator (should match record.id)
      */
@@ -43,5 +46,3 @@ export declare class StoreValidator extends HoistBase {
     private validateInChunksAsync;
     private mapValidators;
 }
-/** Map of StoreRecord IDs to StoreRecord-level error maps. */
-export type StoreErrorMap = Record<StoreRecordId, RecordErrorMap>;

package/build/types/data/index.d.ts

@@ -31,3 +31,4 @@ export * from './cube/ViewRowData';
 export * from './validation/constraints';
 export * from './validation/Rule';
 export * from './validation/ValidationState';
+export * from './validation/Types';

package/build/types/data/validation/Rule.d.ts

@@ -1,6 +1,4 @@
-import { Awaitable, PlainObject, Some } from '../../core';
-import { StoreRecord } from '../StoreRecord';
-import { BaseFieldModel } from '../../cmp/form';
+import { Constraint, RuleSpec, ValidationResult, ValidationSeverity, When } from '@xh/hoist/data';
 /**
  * Immutable object representing a validation rule.
  */
@@ -10,42 +8,9 @@ export declare class Rule {
     constructor(spec: RuleSpec);
 }
 /**
- * Function to validate a value.
+ * Utility to determine the maximum severity from a list of ValidationResults.
  *
- * @param fieldState - context w/value for the constraint's target Field.
- * @param allValues - current values for all fields in form, keyed by field name.
- * @returns String(s) or array of strings describing errors, or null or undefined if rule passes
- * successfully. May return a Promise of strings for async validation.
+ * @param validationResults - list of ValidationResults to evaluate.
+ * @returns The highest severity level found, or null if none.
  */
-export type Constraint<T = any> = (fieldState: FieldState<T>, allValues: PlainObject) => Awaitable<Some<string>>;
-/**
- * Function to determine when to perform validation on a value.
- *
- * @param entity - the entity being evaluated.  Typically a field for store validation or
- *      a BaseFieldModel for Form validation.
- * @param allValues - current values for all fields in form or record, keyed by field name.
- * @returns true if this rule is currently active.
- */
-export type When = (entity: any, allValues: PlainObject) => boolean;
-export interface FieldState<T = any> {
-    /** Current value of the field */
-    value: T;
-    /** Name of the field */
-    name: string;
-    /** Display name of the field */
-    displayName: string;
-    /** Record being validated, if validating Store data. */
-    record?: StoreRecord;
-    /** FieldModel being validated, if validating Form data. */
-    fieldModel?: BaseFieldModel;
-}
-export interface RuleSpec {
-    /** Function(s) to perform validation. */
-    check: Some<Constraint>;
-    /**
-     *  Function to determine when this rule is active.
-     *  If not specified rule is considered to be always active.
-     */
-    when?: When;
-}
-export type RuleLike = RuleSpec | Constraint | Rule;
+export declare function maxSeverity(validationResults: ValidationResult[]): ValidationSeverity;

package/build/types/data/validation/Types.d.ts

@@ -0,0 +1,56 @@
+import type { BaseFieldModel } from '@xh/hoist/cmp/form';
+import type { Awaitable, PlainObject, Some } from '@xh/hoist/core';
+import type { Rule, StoreRecord, StoreRecordId } from '@xh/hoist/data';
+/**
+ * Function to validate a value.
+ *
+ * @param fieldState - context w/value for the constraint's target Field.
+ * @param allValues - current values for all fields in form, keyed by field name.
+ * @returns ValidationResult(s) or string(s) describing errors or null / undefined if rule passes.
+ * May return a Promise resolving to the same for async validation.
+ */
+export type Constraint<T = any> = (fieldState: FieldState<T>, allValues: PlainObject) => Awaitable<Some<string | ValidationResult>>;
+/**
+ * Function to determine when to perform validation on a value.
+ *
+ * @param entity - the entity being evaluated.  Typically a field for store validation or
+ *      a BaseFieldModel for Form validation.
+ * @param allValues - current values for all fields in form or record, keyed by field name.
+ * @returns true if this rule is currently active.
+ */
+export type When = (entity: any, allValues: PlainObject) => boolean;
+export interface FieldState<T = any> {
+    /** Current value of the field */
+    value: T;
+    /** Name of the field */
+    name: string;
+    /** Display name of the field */
+    displayName: string;
+    /** Record being validated, if validating Store data. */
+    record?: StoreRecord;
+    /** FieldModel being validated, if validating Form data. */
+    fieldModel?: BaseFieldModel;
+}
+export interface RuleSpec {
+    /** Function(s) to perform validation. */
+    check: Some<Constraint>;
+    /**
+     *  Function to determine when this rule is active.
+     *  If not specified rule is considered to be always active.
+     */
+    when?: When;
+}
+export type RuleLike = RuleSpec | Constraint | Rule;
+export interface ValidationResult {
+    severity: ValidationSeverity;
+    message: string;
+}
+export type ValidationSeverity = 'error' | 'warning' | 'info';
+/** Map of StoreRecord IDs to StoreRecord-level messages maps. */
+export type StoreValidationMessagesMap = Record<StoreRecordId, RecordValidationMessagesMap>;
+/** Map of StoreRecord IDs to StoreRecord-level ValidationResults maps. */
+export type StoreValidationResultsMap = Record<StoreRecordId, RecordValidationResultsMap>;
+/** Map of Field names to Field-level Validation lists. */
+export type RecordValidationResultsMap = Record<string, ValidationResult[]>;
+/** Map of Field names to Field-level validation message lists. */
+export type RecordValidationMessagesMap = Record<string, string[]>;

package/build/types/data/validation/constraints.d.ts

@@ -1,5 +1,5 @@
+import { Constraint } from '@xh/hoist/data';
 import { LocalDate } from '@xh/hoist/utils/datetime';
-import { Constraint } from './Rule';
 /**
  * A set of validation functions to assist in form field validation.
  */

package/build/types/desktop/cmp/appOption/AutoRefreshAppOption.d.ts

@@ -72,14 +72,12 @@ export declare const autoRefreshAppOption: ({ formFieldProps, inputProps }?: Aut
         position?: import("csstype").Property.Position;
         display?: string;
         testId?: string;
-        id?: string | undefined;
-        onError?: import("react").ReactEventHandler<HTMLDivElement>;
-        defaultValue?: string | number | readonly string[] | undefined;
         slot?: string | undefined;
         style?: import("react").CSSProperties | undefined;
         title?: string | undefined;
         hidden?: boolean | undefined;
         defaultChecked?: boolean | undefined;
+        defaultValue?: string | number | readonly string[] | undefined;
         suppressContentEditableWarning?: boolean | undefined;
         suppressHydrationWarning?: boolean | undefined;
         accessKey?: string | undefined;
@@ -89,6 +87,7 @@ export declare const autoRefreshAppOption: ({ formFieldProps, inputProps }?: Aut
         dir?: string | undefined;
         draggable?: (boolean | "true" | "false") | undefined;
         enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined;
+        id?: string | undefined;
         lang?: string | undefined;
         nonce?: string | undefined;
         spellCheck?: (boolean | "true" | "false") | undefined;
@@ -207,6 +206,7 @@ export declare const autoRefreshAppOption: ({ formFieldProps, inputProps }?: Aut
         onInvalidCapture?: import("react").FormEventHandler<HTMLDivElement>;
         onLoad?: import("react").ReactEventHandler<HTMLDivElement>;
         onLoadCapture?: import("react").ReactEventHandler<HTMLDivElement>;
+        onError?: import("react").ReactEventHandler<HTMLDivElement>;
         onErrorCapture?: import("react").ReactEventHandler<HTMLDivElement>;
         onKeyDown?: import("react").KeyboardEventHandler<HTMLDivElement>;
         onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLDivElement>;

package/build/types/desktop/cmp/appOption/ThemeAppOption.d.ts

@@ -70,14 +70,12 @@ export declare const themeAppOption: ({ formFieldProps, inputProps }?: ThemeAppO
         position?: import("csstype").Property.Position;
         display?: string;
         testId?: string;
-        id?: string | undefined;
-        onError?: import("react").ReactEventHandler<HTMLDivElement>;
-        defaultValue?: string | number | readonly string[] | undefined;
         slot?: string | undefined;
         style?: import("react").CSSProperties | undefined;
         title?: string | undefined;
         hidden?: boolean | undefined;
         defaultChecked?: boolean | undefined;
+        defaultValue?: string | number | readonly string[] | undefined;
         suppressContentEditableWarning?: boolean | undefined;
         suppressHydrationWarning?: boolean | undefined;
         accessKey?: string | undefined;
@@ -87,6 +85,7 @@ export declare const themeAppOption: ({ formFieldProps, inputProps }?: ThemeAppO
         dir?: string | undefined;
         draggable?: (boolean | "true" | "false") | undefined;
         enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined;
+        id?: string | undefined;
         lang?: string | undefined;
         nonce?: string | undefined;
         spellCheck?: (boolean | "true" | "false") | undefined;
@@ -205,6 +204,7 @@ export declare const themeAppOption: ({ formFieldProps, inputProps }?: ThemeAppO
         onInvalidCapture?: import("react").FormEventHandler<HTMLDivElement>;
         onLoad?: import("react").ReactEventHandler<HTMLDivElement>;
         onLoadCapture?: import("react").ReactEventHandler<HTMLDivElement>;
+        onError?: import("react").ReactEventHandler<HTMLDivElement>;
         onErrorCapture?: import("react").ReactEventHandler<HTMLDivElement>;
         onKeyDown?: import("react").KeyboardEventHandler<HTMLDivElement>;
         onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLDivElement>;

package/cmp/form/FormModel.ts

@@ -256,7 +256,7 @@ export class FormModel extends HoistModel {
 
     /** True if all fields are valid. */
     get isValid(): boolean {
-        return this.validationState == 'Valid';
+        return this.validationState === 'Valid';
     }
 
     /** List of all validation errors for this form. */
@@ -264,7 +264,7 @@ export class FormModel extends HoistModel {
         return flatMap(this.fields, s => s.allErrors);
     }
 
-    /** Recompute all validations and return true if the form is valid. */
+    /** Recompute all ValidationResults and return true if the form is valid. */
     async validateAsync(opts?: FormValidateOptions): Promise<boolean> {
         const {display = true} = opts ?? {},
             promises = map(this.fields, m => m.validateAsync({display}));