react-stately 3.44.0 → 3.46.0

package/dist/private/form/useFormValidationState.cjs

@@ -0,0 +1,201 @@
+var $2UakW$react = require("react");
+
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+
+$parcel$export(module.exports, "VALID_VALIDITY_STATE", function () { return $a94d8588145c9b3d$export$aca958c65c314e6c; });
+$parcel$export(module.exports, "DEFAULT_VALIDATION_RESULT", function () { return $a94d8588145c9b3d$export$dad6ae84456c676a; });
+$parcel$export(module.exports, "FormValidationContext", function () { return $a94d8588145c9b3d$export$571b5131b7e65c11; });
+$parcel$export(module.exports, "privateValidationStateProp", function () { return $a94d8588145c9b3d$export$a763b9476acd3eb; });
+$parcel$export(module.exports, "useFormValidationState", function () { return $a94d8588145c9b3d$export$fc1a364ae1f3ff10; });
+$parcel$export(module.exports, "mergeValidation", function () { return $a94d8588145c9b3d$export$75ee7c75d68f5b0e; });
+/*
+ * Copyright 2023 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+const $a94d8588145c9b3d$export$aca958c65c314e6c = {
+    badInput: false,
+    customError: false,
+    patternMismatch: false,
+    rangeOverflow: false,
+    rangeUnderflow: false,
+    stepMismatch: false,
+    tooLong: false,
+    tooShort: false,
+    typeMismatch: false,
+    valueMissing: false,
+    valid: true
+};
+const $a94d8588145c9b3d$var$CUSTOM_VALIDITY_STATE = {
+    ...$a94d8588145c9b3d$export$aca958c65c314e6c,
+    customError: true,
+    valid: false
+};
+const $a94d8588145c9b3d$export$dad6ae84456c676a = {
+    isInvalid: false,
+    validationDetails: $a94d8588145c9b3d$export$aca958c65c314e6c,
+    validationErrors: []
+};
+const $a94d8588145c9b3d$export$571b5131b7e65c11 = (0, $2UakW$react.createContext)({});
+const $a94d8588145c9b3d$export$a763b9476acd3eb = '__reactAriaFormValidationState';
+function $a94d8588145c9b3d$export$fc1a364ae1f3ff10(props) {
+    // Private prop for parent components to pass state to children.
+    if (props[$a94d8588145c9b3d$export$a763b9476acd3eb]) {
+        let { realtimeValidation: realtimeValidation, displayValidation: displayValidation, updateValidation: updateValidation, resetValidation: resetValidation, commitValidation: commitValidation } = props[$a94d8588145c9b3d$export$a763b9476acd3eb];
+        return {
+            realtimeValidation: realtimeValidation,
+            displayValidation: displayValidation,
+            updateValidation: updateValidation,
+            resetValidation: resetValidation,
+            commitValidation: commitValidation
+        };
+    }
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    return $a94d8588145c9b3d$var$useFormValidationStateImpl(props);
+}
+function $a94d8588145c9b3d$var$useFormValidationStateImpl(props) {
+    let { isInvalid: isInvalid, validationState: validationState, name: name, value: value, builtinValidation: builtinValidation, validate: validate, validationBehavior: validationBehavior = 'aria' } = props;
+    // backward compatibility.
+    if (validationState) isInvalid ||= validationState === 'invalid';
+    // If the isInvalid prop is controlled, update validation result in realtime.
+    let controlledError = isInvalid !== undefined ? {
+        isInvalid: isInvalid,
+        validationErrors: [],
+        validationDetails: $a94d8588145c9b3d$var$CUSTOM_VALIDITY_STATE
+    } : null;
+    // Perform custom client side validation.
+    let clientError = (0, $2UakW$react.useMemo)(()=>{
+        if (!validate || value == null) return null;
+        let validateErrors = $a94d8588145c9b3d$var$runValidate(validate, value);
+        return $a94d8588145c9b3d$var$getValidationResult(validateErrors);
+    }, [
+        validate,
+        value
+    ]);
+    if (builtinValidation?.validationDetails.valid) builtinValidation = undefined;
+    // Get relevant server errors from the form.
+    let serverErrors = (0, $2UakW$react.useContext)($a94d8588145c9b3d$export$571b5131b7e65c11);
+    let serverErrorMessages = (0, $2UakW$react.useMemo)(()=>{
+        if (name) return Array.isArray(name) ? name.flatMap((name)=>$a94d8588145c9b3d$var$asArray(serverErrors[name])) : $a94d8588145c9b3d$var$asArray(serverErrors[name]);
+        return [];
+    }, [
+        serverErrors,
+        name
+    ]);
+    // Show server errors when the form gets a new value, and clear when the user changes the value.
+    let [lastServerErrors, setLastServerErrors] = (0, $2UakW$react.useState)(serverErrors);
+    let [isServerErrorCleared, setServerErrorCleared] = (0, $2UakW$react.useState)(false);
+    if (serverErrors !== lastServerErrors) {
+        setLastServerErrors(serverErrors);
+        setServerErrorCleared(false);
+    }
+    let serverError = (0, $2UakW$react.useMemo)(()=>$a94d8588145c9b3d$var$getValidationResult(isServerErrorCleared ? [] : serverErrorMessages), [
+        isServerErrorCleared,
+        serverErrorMessages
+    ]);
+    // Track the next validation state in a ref until commitValidation is called.
+    let nextValidation = (0, $2UakW$react.useRef)($a94d8588145c9b3d$export$dad6ae84456c676a);
+    let [currentValidity, setCurrentValidity] = (0, $2UakW$react.useState)($a94d8588145c9b3d$export$dad6ae84456c676a);
+    let lastError = (0, $2UakW$react.useRef)($a94d8588145c9b3d$export$dad6ae84456c676a);
+    let commitValidation = ()=>{
+        if (!commitQueued) return;
+        setCommitQueued(false);
+        let error = clientError || builtinValidation || nextValidation.current;
+        if (!$a94d8588145c9b3d$var$isEqualValidation(error, lastError.current)) {
+            lastError.current = error;
+            setCurrentValidity(error);
+        }
+    };
+    let [commitQueued, setCommitQueued] = (0, $2UakW$react.useState)(false);
+    (0, $2UakW$react.useEffect)(commitValidation);
+    // realtimeValidation is used to update the native input element's state based on custom validation logic.
+    // displayValidation is the currently displayed validation state that the user sees (e.g. on input change/form submit).
+    // With validationBehavior="aria", all errors are displayed in realtime rather than on submit.
+    let realtimeValidation = controlledError || serverError || clientError || builtinValidation || $a94d8588145c9b3d$export$dad6ae84456c676a;
+    let displayValidation = validationBehavior === 'native' ? controlledError || serverError || currentValidity : controlledError || serverError || clientError || builtinValidation || currentValidity;
+    return {
+        realtimeValidation: realtimeValidation,
+        displayValidation: displayValidation,
+        updateValidation (value) {
+            // If validationBehavior is 'aria', update in realtime. Otherwise, store in a ref until commit.
+            if (validationBehavior === 'aria' && !$a94d8588145c9b3d$var$isEqualValidation(currentValidity, value)) setCurrentValidity(value);
+            else nextValidation.current = value;
+        },
+        resetValidation () {
+            // Update the currently displayed validation state to valid on form reset,
+            // even if the native validity says it isn't. It'll show again on the next form submit.
+            let error = $a94d8588145c9b3d$export$dad6ae84456c676a;
+            if (!$a94d8588145c9b3d$var$isEqualValidation(error, lastError.current)) {
+                lastError.current = error;
+                setCurrentValidity(error);
+            }
+            // Do not commit validation after the next render. This avoids a condition where
+            // useSelect calls commitValidation inside an onReset handler.
+            if (validationBehavior === 'native') setCommitQueued(false);
+            setServerErrorCleared(true);
+        },
+        commitValidation () {
+            // Commit validation state so the user sees it on blur/change/submit. Also clear any server errors.
+            // Wait until after the next render to commit so that the latest value has been validated.
+            if (validationBehavior === 'native') setCommitQueued(true);
+            setServerErrorCleared(true);
+        }
+    };
+}
+function $a94d8588145c9b3d$var$asArray(v) {
+    if (!v) return [];
+    return Array.isArray(v) ? v : [
+        v
+    ];
+}
+function $a94d8588145c9b3d$var$runValidate(validate, value) {
+    if (typeof validate === 'function') {
+        let e = validate(value);
+        if (e && typeof e !== 'boolean') return $a94d8588145c9b3d$var$asArray(e);
+    }
+    return [];
+}
+function $a94d8588145c9b3d$var$getValidationResult(errors) {
+    return errors.length ? {
+        isInvalid: true,
+        validationErrors: errors,
+        validationDetails: $a94d8588145c9b3d$var$CUSTOM_VALIDITY_STATE
+    } : null;
+}
+function $a94d8588145c9b3d$var$isEqualValidation(a, b) {
+    if (a === b) return true;
+    return !!a && !!b && a.isInvalid === b.isInvalid && a.validationErrors.length === b.validationErrors.length && a.validationErrors.every((a, i)=>a === b.validationErrors[i]) && Object.entries(a.validationDetails).every(([k, v])=>b.validationDetails[k] === v);
+}
+function $a94d8588145c9b3d$export$75ee7c75d68f5b0e(...results) {
+    let errors = new Set();
+    let isInvalid = false;
+    let validationDetails = {
+        ...$a94d8588145c9b3d$export$aca958c65c314e6c
+    };
+    for (let v of results){
+        for (let e of v.validationErrors)errors.add(e);
+        // Only these properties apply for checkboxes.
+        isInvalid ||= v.isInvalid;
+        for(let key in validationDetails)validationDetails[key] ||= v.validationDetails[key];
+    }
+    validationDetails.valid = !isInvalid;
+    return {
+        isInvalid: isInvalid,
+        validationErrors: [
+            ...errors
+        ],
+        validationDetails: validationDetails
+    };
+}
+
+
+//# sourceMappingURL=useFormValidationState.cjs.map

package/dist/private/form/useFormValidationState.cjs.map

@@ -0,0 +1 @@
+{"mappings":"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","sources":["packages/react-stately/src/form/useFormValidationState.ts"],"sourcesContent":["/*\n * Copyright 2023 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {Context, createContext, useContext, useEffect, useMemo, useRef, useState} from 'react';\nimport {Validation, ValidationErrors, ValidationFunction, ValidationResult} from '@react-types/shared';\n\nexport const VALID_VALIDITY_STATE: ValidityState = {\n  badInput: false,\n  customError: false,\n  patternMismatch: false,\n  rangeOverflow: false,\n  rangeUnderflow: false,\n  stepMismatch: false,\n  tooLong: false,\n  tooShort: false,\n  typeMismatch: false,\n  valueMissing: false,\n  valid: true\n};\n\nconst CUSTOM_VALIDITY_STATE: ValidityState = {\n  ...VALID_VALIDITY_STATE,\n  customError: true,\n  valid: false\n};\n\nexport const DEFAULT_VALIDATION_RESULT: ValidationResult = {\n  isInvalid: false,\n  validationDetails: VALID_VALIDITY_STATE,\n  validationErrors: []\n};\n\nexport const FormValidationContext: Context<ValidationErrors> = createContext<ValidationErrors>({});\n\n// Private props that we pass from useFormValidationState to children.\n// Ideally we'd use a Symbol for this, but React doesn't support them: https://github.com/facebook/react/issues/7552\n// This needs to be stable across server and client module evaluation for SSR hydration.\nexport const privateValidationStateProp: string = '__reactAriaFormValidationState';\n\ninterface FormValidationProps<T> extends Validation<T> {\n  builtinValidation?: ValidationResult,\n  name?: string | string[],\n  value: T | null\n}\n\nexport interface FormValidationState {\n  /** Realtime validation results, updated as the user edits the value. */\n  realtimeValidation: ValidationResult,\n  /** Currently displayed validation results, updated when the user commits their changes. */\n  displayValidation: ValidationResult,\n  /** Updates the current validation result. Not displayed to the user until `commitValidation` is called. */\n  updateValidation(result: ValidationResult): void,\n  /** Resets the displayed validation state to valid when the user resets the form. */\n  resetValidation(): void,\n  /** Commits the realtime validation so it is displayed to the user. */\n  commitValidation(): void\n}\n\nexport function useFormValidationState<T>(props: FormValidationProps<T>): FormValidationState {\n  // Private prop for parent components to pass state to children.\n  if (props[privateValidationStateProp]) {\n    let {realtimeValidation, displayValidation, updateValidation, resetValidation, commitValidation} = props[privateValidationStateProp] as FormValidationState;\n    return {realtimeValidation, displayValidation, updateValidation, resetValidation, commitValidation};\n  }\n\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  return useFormValidationStateImpl(props);\n}\n\nfunction useFormValidationStateImpl<T>(props: FormValidationProps<T>): FormValidationState {\n  let {isInvalid, validationState, name, value, builtinValidation, validate, validationBehavior = 'aria'} = props;\n\n  // backward compatibility.\n  if (validationState) {\n    isInvalid ||= validationState === 'invalid';\n  }\n\n  // If the isInvalid prop is controlled, update validation result in realtime.\n  let controlledError: ValidationResult | null = isInvalid !== undefined ? {\n    isInvalid,\n    validationErrors: [],\n    validationDetails: CUSTOM_VALIDITY_STATE\n  } : null;\n\n  // Perform custom client side validation.\n  let clientError: ValidationResult | null = useMemo(() => {\n    if (!validate || value == null) {\n      return null;\n    }\n    let validateErrors = runValidate(validate, value);\n    return getValidationResult(validateErrors);\n  }, [validate, value]);\n\n  if (builtinValidation?.validationDetails.valid) {\n    builtinValidation = undefined;\n  }\n\n  // Get relevant server errors from the form.\n  let serverErrors = useContext(FormValidationContext);\n  let serverErrorMessages = useMemo(() => {\n    if (name) {\n      return Array.isArray(name) ? name.flatMap(name => asArray(serverErrors[name])) : asArray(serverErrors[name]);\n    }\n    return [];\n  }, [serverErrors, name]);\n\n  // Show server errors when the form gets a new value, and clear when the user changes the value.\n  let [lastServerErrors, setLastServerErrors] = useState(serverErrors);\n  let [isServerErrorCleared, setServerErrorCleared] = useState(false);\n  if (serverErrors !== lastServerErrors) {\n    setLastServerErrors(serverErrors);\n    setServerErrorCleared(false);\n  }\n\n  let serverError: ValidationResult | null = useMemo(() =>\n    getValidationResult(isServerErrorCleared ? [] : serverErrorMessages),\n    [isServerErrorCleared, serverErrorMessages]\n  );\n\n  // Track the next validation state in a ref until commitValidation is called.\n  let nextValidation = useRef(DEFAULT_VALIDATION_RESULT);\n  let [currentValidity, setCurrentValidity] = useState(DEFAULT_VALIDATION_RESULT);\n\n  let lastError = useRef(DEFAULT_VALIDATION_RESULT);\n  let commitValidation = () => {\n    if (!commitQueued) {\n      return;\n    }\n\n    setCommitQueued(false);\n    let error = clientError || builtinValidation || nextValidation.current;\n    if (!isEqualValidation(error, lastError.current)) {\n      lastError.current = error;\n      setCurrentValidity(error);\n    }\n  };\n\n  let [commitQueued, setCommitQueued] = useState(false);\n  useEffect(commitValidation);\n\n  // realtimeValidation is used to update the native input element's state based on custom validation logic.\n  // displayValidation is the currently displayed validation state that the user sees (e.g. on input change/form submit).\n  // With validationBehavior=\"aria\", all errors are displayed in realtime rather than on submit.\n  let realtimeValidation = controlledError || serverError || clientError || builtinValidation || DEFAULT_VALIDATION_RESULT;\n  let displayValidation = validationBehavior === 'native'\n    ? controlledError || serverError || currentValidity\n    : controlledError || serverError || clientError || builtinValidation || currentValidity;\n\n  return {\n    realtimeValidation,\n    displayValidation,\n    updateValidation(value) {\n      // If validationBehavior is 'aria', update in realtime. Otherwise, store in a ref until commit.\n      if (validationBehavior === 'aria' && !isEqualValidation(currentValidity, value)) {\n        setCurrentValidity(value);\n      } else {\n        nextValidation.current = value;\n      }\n    },\n    resetValidation() {\n      // Update the currently displayed validation state to valid on form reset,\n      // even if the native validity says it isn't. It'll show again on the next form submit.\n      let error = DEFAULT_VALIDATION_RESULT;\n      if (!isEqualValidation(error, lastError.current)) {\n        lastError.current = error;\n        setCurrentValidity(error);\n      }\n\n      // Do not commit validation after the next render. This avoids a condition where\n      // useSelect calls commitValidation inside an onReset handler.\n      if (validationBehavior === 'native') {\n        setCommitQueued(false);\n      }\n\n      setServerErrorCleared(true);\n    },\n    commitValidation() {\n      // Commit validation state so the user sees it on blur/change/submit. Also clear any server errors.\n      // Wait until after the next render to commit so that the latest value has been validated.\n      if (validationBehavior === 'native') {\n        setCommitQueued(true);\n      }\n      setServerErrorCleared(true);\n    }\n  };\n}\n\nfunction asArray<T>(v: T | T[]): T[] {\n  if (!v) {\n    return [];\n  }\n\n  return Array.isArray(v) ? v : [v];\n}\n\nfunction runValidate<T>(validate: ValidationFunction<T>, value: T): string[] {\n  if (typeof validate === 'function') {\n    let e = validate(value);\n    if (e && typeof e !== 'boolean') {\n      return asArray(e);\n    }\n  }\n\n  return [];\n}\n\nfunction getValidationResult(errors: string[]): ValidationResult | null {\n  return errors.length ? {\n    isInvalid: true,\n    validationErrors: errors,\n    validationDetails: CUSTOM_VALIDITY_STATE\n  } : null;\n}\n\nfunction isEqualValidation(a: ValidationResult | null, b: ValidationResult | null): boolean {\n  if (a === b) {\n    return true;\n  }\n\n  return !!a && !!b\n    && a.isInvalid === b.isInvalid\n    && a.validationErrors.length === b.validationErrors.length\n    && a.validationErrors.every((a, i) => a === b.validationErrors[i])\n    && Object.entries(a.validationDetails).every(([k, v]) => b.validationDetails[k] === v);\n}\n\nexport function mergeValidation(...results: ValidationResult[]): ValidationResult {\n  let errors = new Set<string>();\n  let isInvalid = false;\n  let validationDetails = {\n    ...VALID_VALIDITY_STATE\n  };\n\n  for (let v of results) {\n    for (let e of v.validationErrors) {\n      errors.add(e);\n    }\n\n    // Only these properties apply for checkboxes.\n    isInvalid ||= v.isInvalid;\n    for (let key in validationDetails) {\n      validationDetails[key] ||= v.validationDetails[key];\n    }\n  }\n\n  validationDetails.valid = !isInvalid;\n  return {\n    isInvalid,\n    validationErrors: [...errors],\n    validationDetails\n  };\n}\n"],"names":[],"version":3,"file":"useFormValidationState.cjs.map"}

package/dist/private/form/useFormValidationState.js

@@ -0,0 +1,192 @@
+import {createContext as $3uUbI$createContext, useMemo as $3uUbI$useMemo, useContext as $3uUbI$useContext, useState as $3uUbI$useState, useRef as $3uUbI$useRef, useEffect as $3uUbI$useEffect} from "react";
+
+/*
+ * Copyright 2023 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+const $d085204f885ad67a$export$aca958c65c314e6c = {
+    badInput: false,
+    customError: false,
+    patternMismatch: false,
+    rangeOverflow: false,
+    rangeUnderflow: false,
+    stepMismatch: false,
+    tooLong: false,
+    tooShort: false,
+    typeMismatch: false,
+    valueMissing: false,
+    valid: true
+};
+const $d085204f885ad67a$var$CUSTOM_VALIDITY_STATE = {
+    ...$d085204f885ad67a$export$aca958c65c314e6c,
+    customError: true,
+    valid: false
+};
+const $d085204f885ad67a$export$dad6ae84456c676a = {
+    isInvalid: false,
+    validationDetails: $d085204f885ad67a$export$aca958c65c314e6c,
+    validationErrors: []
+};
+const $d085204f885ad67a$export$571b5131b7e65c11 = (0, $3uUbI$createContext)({});
+const $d085204f885ad67a$export$a763b9476acd3eb = '__reactAriaFormValidationState';
+function $d085204f885ad67a$export$fc1a364ae1f3ff10(props) {
+    // Private prop for parent components to pass state to children.
+    if (props[$d085204f885ad67a$export$a763b9476acd3eb]) {
+        let { realtimeValidation: realtimeValidation, displayValidation: displayValidation, updateValidation: updateValidation, resetValidation: resetValidation, commitValidation: commitValidation } = props[$d085204f885ad67a$export$a763b9476acd3eb];
+        return {
+            realtimeValidation: realtimeValidation,
+            displayValidation: displayValidation,
+            updateValidation: updateValidation,
+            resetValidation: resetValidation,
+            commitValidation: commitValidation
+        };
+    }
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    return $d085204f885ad67a$var$useFormValidationStateImpl(props);
+}
+function $d085204f885ad67a$var$useFormValidationStateImpl(props) {
+    let { isInvalid: isInvalid, validationState: validationState, name: name, value: value, builtinValidation: builtinValidation, validate: validate, validationBehavior: validationBehavior = 'aria' } = props;
+    // backward compatibility.
+    if (validationState) isInvalid || (isInvalid = validationState === 'invalid');
+    // If the isInvalid prop is controlled, update validation result in realtime.
+    let controlledError = isInvalid !== undefined ? {
+        isInvalid: isInvalid,
+        validationErrors: [],
+        validationDetails: $d085204f885ad67a$var$CUSTOM_VALIDITY_STATE
+    } : null;
+    // Perform custom client side validation.
+    let clientError = (0, $3uUbI$useMemo)(()=>{
+        if (!validate || value == null) return null;
+        let validateErrors = $d085204f885ad67a$var$runValidate(validate, value);
+        return $d085204f885ad67a$var$getValidationResult(validateErrors);
+    }, [
+        validate,
+        value
+    ]);
+    if (builtinValidation === null || builtinValidation === void 0 ? void 0 : builtinValidation.validationDetails.valid) builtinValidation = undefined;
+    // Get relevant server errors from the form.
+    let serverErrors = (0, $3uUbI$useContext)($d085204f885ad67a$export$571b5131b7e65c11);
+    let serverErrorMessages = (0, $3uUbI$useMemo)(()=>{
+        if (name) return Array.isArray(name) ? name.flatMap((name)=>$d085204f885ad67a$var$asArray(serverErrors[name])) : $d085204f885ad67a$var$asArray(serverErrors[name]);
+        return [];
+    }, [
+        serverErrors,
+        name
+    ]);
+    // Show server errors when the form gets a new value, and clear when the user changes the value.
+    let [lastServerErrors, setLastServerErrors] = (0, $3uUbI$useState)(serverErrors);
+    let [isServerErrorCleared, setServerErrorCleared] = (0, $3uUbI$useState)(false);
+    if (serverErrors !== lastServerErrors) {
+        setLastServerErrors(serverErrors);
+        setServerErrorCleared(false);
+    }
+    let serverError = (0, $3uUbI$useMemo)(()=>$d085204f885ad67a$var$getValidationResult(isServerErrorCleared ? [] : serverErrorMessages), [
+        isServerErrorCleared,
+        serverErrorMessages
+    ]);
+    // Track the next validation state in a ref until commitValidation is called.
+    let nextValidation = (0, $3uUbI$useRef)($d085204f885ad67a$export$dad6ae84456c676a);
+    let [currentValidity, setCurrentValidity] = (0, $3uUbI$useState)($d085204f885ad67a$export$dad6ae84456c676a);
+    let lastError = (0, $3uUbI$useRef)($d085204f885ad67a$export$dad6ae84456c676a);
+    let commitValidation = ()=>{
+        if (!commitQueued) return;
+        setCommitQueued(false);
+        let error = clientError || builtinValidation || nextValidation.current;
+        if (!$d085204f885ad67a$var$isEqualValidation(error, lastError.current)) {
+            lastError.current = error;
+            setCurrentValidity(error);
+        }
+    };
+    let [commitQueued, setCommitQueued] = (0, $3uUbI$useState)(false);
+    (0, $3uUbI$useEffect)(commitValidation);
+    // realtimeValidation is used to update the native input element's state based on custom validation logic.
+    // displayValidation is the currently displayed validation state that the user sees (e.g. on input change/form submit).
+    // With validationBehavior="aria", all errors are displayed in realtime rather than on submit.
+    let realtimeValidation = controlledError || serverError || clientError || builtinValidation || $d085204f885ad67a$export$dad6ae84456c676a;
+    let displayValidation = validationBehavior === 'native' ? controlledError || serverError || currentValidity : controlledError || serverError || clientError || builtinValidation || currentValidity;
+    return {
+        realtimeValidation: realtimeValidation,
+        displayValidation: displayValidation,
+        updateValidation (value) {
+            // If validationBehavior is 'aria', update in realtime. Otherwise, store in a ref until commit.
+            if (validationBehavior === 'aria' && !$d085204f885ad67a$var$isEqualValidation(currentValidity, value)) setCurrentValidity(value);
+            else nextValidation.current = value;
+        },
+        resetValidation () {
+            // Update the currently displayed validation state to valid on form reset,
+            // even if the native validity says it isn't. It'll show again on the next form submit.
+            let error = $d085204f885ad67a$export$dad6ae84456c676a;
+            if (!$d085204f885ad67a$var$isEqualValidation(error, lastError.current)) {
+                lastError.current = error;
+                setCurrentValidity(error);
+            }
+            // Do not commit validation after the next render. This avoids a condition where
+            // useSelect calls commitValidation inside an onReset handler.
+            if (validationBehavior === 'native') setCommitQueued(false);
+            setServerErrorCleared(true);
+        },
+        commitValidation () {
+            // Commit validation state so the user sees it on blur/change/submit. Also clear any server errors.
+            // Wait until after the next render to commit so that the latest value has been validated.
+            if (validationBehavior === 'native') setCommitQueued(true);
+            setServerErrorCleared(true);
+        }
+    };
+}
+function $d085204f885ad67a$var$asArray(v) {
+    if (!v) return [];
+    return Array.isArray(v) ? v : [
+        v
+    ];
+}
+function $d085204f885ad67a$var$runValidate(validate, value) {
+    if (typeof validate === 'function') {
+        let e = validate(value);
+        if (e && typeof e !== 'boolean') return $d085204f885ad67a$var$asArray(e);
+    }
+    return [];
+}
+function $d085204f885ad67a$var$getValidationResult(errors) {
+    return errors.length ? {
+        isInvalid: true,
+        validationErrors: errors,
+        validationDetails: $d085204f885ad67a$var$CUSTOM_VALIDITY_STATE
+    } : null;
+}
+function $d085204f885ad67a$var$isEqualValidation(a, b) {
+    if (a === b) return true;
+    return !!a && !!b && a.isInvalid === b.isInvalid && a.validationErrors.length === b.validationErrors.length && a.validationErrors.every((a, i)=>a === b.validationErrors[i]) && Object.entries(a.validationDetails).every(([k, v])=>b.validationDetails[k] === v);
+}
+function $d085204f885ad67a$export$75ee7c75d68f5b0e(...results) {
+    let errors = new Set();
+    let isInvalid = false;
+    let validationDetails = {
+        ...$d085204f885ad67a$export$aca958c65c314e6c
+    };
+    for (let v of results){
+        var _validationDetails, _key;
+        for (let e of v.validationErrors)errors.add(e);
+        // Only these properties apply for checkboxes.
+        isInvalid || (isInvalid = v.isInvalid);
+        for(let key in validationDetails)(_validationDetails = validationDetails)[_key = key] || (_validationDetails[_key] = v.validationDetails[key]);
+    }
+    validationDetails.valid = !isInvalid;
+    return {
+        isInvalid: isInvalid,
+        validationErrors: [
+            ...errors
+        ],
+        validationDetails: validationDetails
+    };
+}
+
+
+export {$d085204f885ad67a$export$aca958c65c314e6c as VALID_VALIDITY_STATE, $d085204f885ad67a$export$dad6ae84456c676a as DEFAULT_VALIDATION_RESULT, $d085204f885ad67a$export$571b5131b7e65c11 as FormValidationContext, $d085204f885ad67a$export$a763b9476acd3eb as privateValidationStateProp, $d085204f885ad67a$export$fc1a364ae1f3ff10 as useFormValidationState, $d085204f885ad67a$export$75ee7c75d68f5b0e as mergeValidation};
+//# sourceMappingURL=useFormValidationState.js.map

package/dist/private/form/useFormValidationState.js.map

@@ -0,0 +1 @@
+{"mappings":"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","sources":["packages/react-stately/src/form/useFormValidationState.ts"],"sourcesContent":["/*\n * Copyright 2023 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {Context, createContext, useContext, useEffect, useMemo, useRef, useState} from 'react';\nimport {Validation, ValidationErrors, ValidationFunction, ValidationResult} from '@react-types/shared';\n\nexport const VALID_VALIDITY_STATE: ValidityState = {\n  badInput: false,\n  customError: false,\n  patternMismatch: false,\n  rangeOverflow: false,\n  rangeUnderflow: false,\n  stepMismatch: false,\n  tooLong: false,\n  tooShort: false,\n  typeMismatch: false,\n  valueMissing: false,\n  valid: true\n};\n\nconst CUSTOM_VALIDITY_STATE: ValidityState = {\n  ...VALID_VALIDITY_STATE,\n  customError: true,\n  valid: false\n};\n\nexport const DEFAULT_VALIDATION_RESULT: ValidationResult = {\n  isInvalid: false,\n  validationDetails: VALID_VALIDITY_STATE,\n  validationErrors: []\n};\n\nexport const FormValidationContext: Context<ValidationErrors> = createContext<ValidationErrors>({});\n\n// Private props that we pass from useFormValidationState to children.\n// Ideally we'd use a Symbol for this, but React doesn't support them: https://github.com/facebook/react/issues/7552\n// This needs to be stable across server and client module evaluation for SSR hydration.\nexport const privateValidationStateProp: string = '__reactAriaFormValidationState';\n\ninterface FormValidationProps<T> extends Validation<T> {\n  builtinValidation?: ValidationResult,\n  name?: string | string[],\n  value: T | null\n}\n\nexport interface FormValidationState {\n  /** Realtime validation results, updated as the user edits the value. */\n  realtimeValidation: ValidationResult,\n  /** Currently displayed validation results, updated when the user commits their changes. */\n  displayValidation: ValidationResult,\n  /** Updates the current validation result. Not displayed to the user until `commitValidation` is called. */\n  updateValidation(result: ValidationResult): void,\n  /** Resets the displayed validation state to valid when the user resets the form. */\n  resetValidation(): void,\n  /** Commits the realtime validation so it is displayed to the user. */\n  commitValidation(): void\n}\n\nexport function useFormValidationState<T>(props: FormValidationProps<T>): FormValidationState {\n  // Private prop for parent components to pass state to children.\n  if (props[privateValidationStateProp]) {\n    let {realtimeValidation, displayValidation, updateValidation, resetValidation, commitValidation} = props[privateValidationStateProp] as FormValidationState;\n    return {realtimeValidation, displayValidation, updateValidation, resetValidation, commitValidation};\n  }\n\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  return useFormValidationStateImpl(props);\n}\n\nfunction useFormValidationStateImpl<T>(props: FormValidationProps<T>): FormValidationState {\n  let {isInvalid, validationState, name, value, builtinValidation, validate, validationBehavior = 'aria'} = props;\n\n  // backward compatibility.\n  if (validationState) {\n    isInvalid ||= validationState === 'invalid';\n  }\n\n  // If the isInvalid prop is controlled, update validation result in realtime.\n  let controlledError: ValidationResult | null = isInvalid !== undefined ? {\n    isInvalid,\n    validationErrors: [],\n    validationDetails: CUSTOM_VALIDITY_STATE\n  } : null;\n\n  // Perform custom client side validation.\n  let clientError: ValidationResult | null = useMemo(() => {\n    if (!validate || value == null) {\n      return null;\n    }\n    let validateErrors = runValidate(validate, value);\n    return getValidationResult(validateErrors);\n  }, [validate, value]);\n\n  if (builtinValidation?.validationDetails.valid) {\n    builtinValidation = undefined;\n  }\n\n  // Get relevant server errors from the form.\n  let serverErrors = useContext(FormValidationContext);\n  let serverErrorMessages = useMemo(() => {\n    if (name) {\n      return Array.isArray(name) ? name.flatMap(name => asArray(serverErrors[name])) : asArray(serverErrors[name]);\n    }\n    return [];\n  }, [serverErrors, name]);\n\n  // Show server errors when the form gets a new value, and clear when the user changes the value.\n  let [lastServerErrors, setLastServerErrors] = useState(serverErrors);\n  let [isServerErrorCleared, setServerErrorCleared] = useState(false);\n  if (serverErrors !== lastServerErrors) {\n    setLastServerErrors(serverErrors);\n    setServerErrorCleared(false);\n  }\n\n  let serverError: ValidationResult | null = useMemo(() =>\n    getValidationResult(isServerErrorCleared ? [] : serverErrorMessages),\n    [isServerErrorCleared, serverErrorMessages]\n  );\n\n  // Track the next validation state in a ref until commitValidation is called.\n  let nextValidation = useRef(DEFAULT_VALIDATION_RESULT);\n  let [currentValidity, setCurrentValidity] = useState(DEFAULT_VALIDATION_RESULT);\n\n  let lastError = useRef(DEFAULT_VALIDATION_RESULT);\n  let commitValidation = () => {\n    if (!commitQueued) {\n      return;\n    }\n\n    setCommitQueued(false);\n    let error = clientError || builtinValidation || nextValidation.current;\n    if (!isEqualValidation(error, lastError.current)) {\n      lastError.current = error;\n      setCurrentValidity(error);\n    }\n  };\n\n  let [commitQueued, setCommitQueued] = useState(false);\n  useEffect(commitValidation);\n\n  // realtimeValidation is used to update the native input element's state based on custom validation logic.\n  // displayValidation is the currently displayed validation state that the user sees (e.g. on input change/form submit).\n  // With validationBehavior=\"aria\", all errors are displayed in realtime rather than on submit.\n  let realtimeValidation = controlledError || serverError || clientError || builtinValidation || DEFAULT_VALIDATION_RESULT;\n  let displayValidation = validationBehavior === 'native'\n    ? controlledError || serverError || currentValidity\n    : controlledError || serverError || clientError || builtinValidation || currentValidity;\n\n  return {\n    realtimeValidation,\n    displayValidation,\n    updateValidation(value) {\n      // If validationBehavior is 'aria', update in realtime. Otherwise, store in a ref until commit.\n      if (validationBehavior === 'aria' && !isEqualValidation(currentValidity, value)) {\n        setCurrentValidity(value);\n      } else {\n        nextValidation.current = value;\n      }\n    },\n    resetValidation() {\n      // Update the currently displayed validation state to valid on form reset,\n      // even if the native validity says it isn't. It'll show again on the next form submit.\n      let error = DEFAULT_VALIDATION_RESULT;\n      if (!isEqualValidation(error, lastError.current)) {\n        lastError.current = error;\n        setCurrentValidity(error);\n      }\n\n      // Do not commit validation after the next render. This avoids a condition where\n      // useSelect calls commitValidation inside an onReset handler.\n      if (validationBehavior === 'native') {\n        setCommitQueued(false);\n      }\n\n      setServerErrorCleared(true);\n    },\n    commitValidation() {\n      // Commit validation state so the user sees it on blur/change/submit. Also clear any server errors.\n      // Wait until after the next render to commit so that the latest value has been validated.\n      if (validationBehavior === 'native') {\n        setCommitQueued(true);\n      }\n      setServerErrorCleared(true);\n    }\n  };\n}\n\nfunction asArray<T>(v: T | T[]): T[] {\n  if (!v) {\n    return [];\n  }\n\n  return Array.isArray(v) ? v : [v];\n}\n\nfunction runValidate<T>(validate: ValidationFunction<T>, value: T): string[] {\n  if (typeof validate === 'function') {\n    let e = validate(value);\n    if (e && typeof e !== 'boolean') {\n      return asArray(e);\n    }\n  }\n\n  return [];\n}\n\nfunction getValidationResult(errors: string[]): ValidationResult | null {\n  return errors.length ? {\n    isInvalid: true,\n    validationErrors: errors,\n    validationDetails: CUSTOM_VALIDITY_STATE\n  } : null;\n}\n\nfunction isEqualValidation(a: ValidationResult | null, b: ValidationResult | null): boolean {\n  if (a === b) {\n    return true;\n  }\n\n  return !!a && !!b\n    && a.isInvalid === b.isInvalid\n    && a.validationErrors.length === b.validationErrors.length\n    && a.validationErrors.every((a, i) => a === b.validationErrors[i])\n    && Object.entries(a.validationDetails).every(([k, v]) => b.validationDetails[k] === v);\n}\n\nexport function mergeValidation(...results: ValidationResult[]): ValidationResult {\n  let errors = new Set<string>();\n  let isInvalid = false;\n  let validationDetails = {\n    ...VALID_VALIDITY_STATE\n  };\n\n  for (let v of results) {\n    for (let e of v.validationErrors) {\n      errors.add(e);\n    }\n\n    // Only these properties apply for checkboxes.\n    isInvalid ||= v.isInvalid;\n    for (let key in validationDetails) {\n      validationDetails[key] ||= v.validationDetails[key];\n    }\n  }\n\n  validationDetails.valid = !isInvalid;\n  return {\n    isInvalid,\n    validationErrors: [...errors],\n    validationDetails\n  };\n}\n"],"names":[],"version":3,"file":"useFormValidationState.js.map"}

package/dist/private/form/useFormValidationState.mjs

@@ -0,0 +1,191 @@
+import {createContext as $8AuPP$createContext, useMemo as $8AuPP$useMemo, useContext as $8AuPP$useContext, useState as $8AuPP$useState, useRef as $8AuPP$useRef, useEffect as $8AuPP$useEffect} from "react";
+
+/*
+ * Copyright 2023 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+const $fd2148440a13ec26$export$aca958c65c314e6c = {
+    badInput: false,
+    customError: false,
+    patternMismatch: false,
+    rangeOverflow: false,
+    rangeUnderflow: false,
+    stepMismatch: false,
+    tooLong: false,
+    tooShort: false,
+    typeMismatch: false,
+    valueMissing: false,
+    valid: true
+};
+const $fd2148440a13ec26$var$CUSTOM_VALIDITY_STATE = {
+    ...$fd2148440a13ec26$export$aca958c65c314e6c,
+    customError: true,
+    valid: false
+};
+const $fd2148440a13ec26$export$dad6ae84456c676a = {
+    isInvalid: false,
+    validationDetails: $fd2148440a13ec26$export$aca958c65c314e6c,
+    validationErrors: []
+};
+const $fd2148440a13ec26$export$571b5131b7e65c11 = (0, $8AuPP$createContext)({});
+const $fd2148440a13ec26$export$a763b9476acd3eb = '__reactAriaFormValidationState';
+function $fd2148440a13ec26$export$fc1a364ae1f3ff10(props) {
+    // Private prop for parent components to pass state to children.
+    if (props[$fd2148440a13ec26$export$a763b9476acd3eb]) {
+        let { realtimeValidation: realtimeValidation, displayValidation: displayValidation, updateValidation: updateValidation, resetValidation: resetValidation, commitValidation: commitValidation } = props[$fd2148440a13ec26$export$a763b9476acd3eb];
+        return {
+            realtimeValidation: realtimeValidation,
+            displayValidation: displayValidation,
+            updateValidation: updateValidation,
+            resetValidation: resetValidation,
+            commitValidation: commitValidation
+        };
+    }
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    return $fd2148440a13ec26$var$useFormValidationStateImpl(props);
+}
+function $fd2148440a13ec26$var$useFormValidationStateImpl(props) {
+    let { isInvalid: isInvalid, validationState: validationState, name: name, value: value, builtinValidation: builtinValidation, validate: validate, validationBehavior: validationBehavior = 'aria' } = props;
+    // backward compatibility.
+    if (validationState) isInvalid ||= validationState === 'invalid';
+    // If the isInvalid prop is controlled, update validation result in realtime.
+    let controlledError = isInvalid !== undefined ? {
+        isInvalid: isInvalid,
+        validationErrors: [],
+        validationDetails: $fd2148440a13ec26$var$CUSTOM_VALIDITY_STATE
+    } : null;
+    // Perform custom client side validation.
+    let clientError = (0, $8AuPP$useMemo)(()=>{
+        if (!validate || value == null) return null;
+        let validateErrors = $fd2148440a13ec26$var$runValidate(validate, value);
+        return $fd2148440a13ec26$var$getValidationResult(validateErrors);
+    }, [
+        validate,
+        value
+    ]);
+    if (builtinValidation?.validationDetails.valid) builtinValidation = undefined;
+    // Get relevant server errors from the form.
+    let serverErrors = (0, $8AuPP$useContext)($fd2148440a13ec26$export$571b5131b7e65c11);
+    let serverErrorMessages = (0, $8AuPP$useMemo)(()=>{
+        if (name) return Array.isArray(name) ? name.flatMap((name)=>$fd2148440a13ec26$var$asArray(serverErrors[name])) : $fd2148440a13ec26$var$asArray(serverErrors[name]);
+        return [];
+    }, [
+        serverErrors,
+        name
+    ]);
+    // Show server errors when the form gets a new value, and clear when the user changes the value.
+    let [lastServerErrors, setLastServerErrors] = (0, $8AuPP$useState)(serverErrors);
+    let [isServerErrorCleared, setServerErrorCleared] = (0, $8AuPP$useState)(false);
+    if (serverErrors !== lastServerErrors) {
+        setLastServerErrors(serverErrors);
+        setServerErrorCleared(false);
+    }
+    let serverError = (0, $8AuPP$useMemo)(()=>$fd2148440a13ec26$var$getValidationResult(isServerErrorCleared ? [] : serverErrorMessages), [
+        isServerErrorCleared,
+        serverErrorMessages
+    ]);
+    // Track the next validation state in a ref until commitValidation is called.
+    let nextValidation = (0, $8AuPP$useRef)($fd2148440a13ec26$export$dad6ae84456c676a);
+    let [currentValidity, setCurrentValidity] = (0, $8AuPP$useState)($fd2148440a13ec26$export$dad6ae84456c676a);
+    let lastError = (0, $8AuPP$useRef)($fd2148440a13ec26$export$dad6ae84456c676a);
+    let commitValidation = ()=>{
+        if (!commitQueued) return;
+        setCommitQueued(false);
+        let error = clientError || builtinValidation || nextValidation.current;
+        if (!$fd2148440a13ec26$var$isEqualValidation(error, lastError.current)) {
+            lastError.current = error;
+            setCurrentValidity(error);
+        }
+    };
+    let [commitQueued, setCommitQueued] = (0, $8AuPP$useState)(false);
+    (0, $8AuPP$useEffect)(commitValidation);
+    // realtimeValidation is used to update the native input element's state based on custom validation logic.
+    // displayValidation is the currently displayed validation state that the user sees (e.g. on input change/form submit).
+    // With validationBehavior="aria", all errors are displayed in realtime rather than on submit.
+    let realtimeValidation = controlledError || serverError || clientError || builtinValidation || $fd2148440a13ec26$export$dad6ae84456c676a;
+    let displayValidation = validationBehavior === 'native' ? controlledError || serverError || currentValidity : controlledError || serverError || clientError || builtinValidation || currentValidity;
+    return {
+        realtimeValidation: realtimeValidation,
+        displayValidation: displayValidation,
+        updateValidation (value) {
+            // If validationBehavior is 'aria', update in realtime. Otherwise, store in a ref until commit.
+            if (validationBehavior === 'aria' && !$fd2148440a13ec26$var$isEqualValidation(currentValidity, value)) setCurrentValidity(value);
+            else nextValidation.current = value;
+        },
+        resetValidation () {
+            // Update the currently displayed validation state to valid on form reset,
+            // even if the native validity says it isn't. It'll show again on the next form submit.
+            let error = $fd2148440a13ec26$export$dad6ae84456c676a;
+            if (!$fd2148440a13ec26$var$isEqualValidation(error, lastError.current)) {
+                lastError.current = error;
+                setCurrentValidity(error);
+            }
+            // Do not commit validation after the next render. This avoids a condition where
+            // useSelect calls commitValidation inside an onReset handler.
+            if (validationBehavior === 'native') setCommitQueued(false);
+            setServerErrorCleared(true);
+        },
+        commitValidation () {
+            // Commit validation state so the user sees it on blur/change/submit. Also clear any server errors.
+            // Wait until after the next render to commit so that the latest value has been validated.
+            if (validationBehavior === 'native') setCommitQueued(true);
+            setServerErrorCleared(true);
+        }
+    };
+}
+function $fd2148440a13ec26$var$asArray(v) {
+    if (!v) return [];
+    return Array.isArray(v) ? v : [
+        v
+    ];
+}
+function $fd2148440a13ec26$var$runValidate(validate, value) {
+    if (typeof validate === 'function') {
+        let e = validate(value);
+        if (e && typeof e !== 'boolean') return $fd2148440a13ec26$var$asArray(e);
+    }
+    return [];
+}
+function $fd2148440a13ec26$var$getValidationResult(errors) {
+    return errors.length ? {
+        isInvalid: true,
+        validationErrors: errors,
+        validationDetails: $fd2148440a13ec26$var$CUSTOM_VALIDITY_STATE
+    } : null;
+}
+function $fd2148440a13ec26$var$isEqualValidation(a, b) {
+    if (a === b) return true;
+    return !!a && !!b && a.isInvalid === b.isInvalid && a.validationErrors.length === b.validationErrors.length && a.validationErrors.every((a, i)=>a === b.validationErrors[i]) && Object.entries(a.validationDetails).every(([k, v])=>b.validationDetails[k] === v);
+}
+function $fd2148440a13ec26$export$75ee7c75d68f5b0e(...results) {
+    let errors = new Set();
+    let isInvalid = false;
+    let validationDetails = {
+        ...$fd2148440a13ec26$export$aca958c65c314e6c
+    };
+    for (let v of results){
+        for (let e of v.validationErrors)errors.add(e);
+        // Only these properties apply for checkboxes.
+        isInvalid ||= v.isInvalid;
+        for(let key in validationDetails)validationDetails[key] ||= v.validationDetails[key];
+    }
+    validationDetails.valid = !isInvalid;
+    return {
+        isInvalid: isInvalid,
+        validationErrors: [
+            ...errors
+        ],
+        validationDetails: validationDetails
+    };
+}
+
+
+export {$fd2148440a13ec26$export$aca958c65c314e6c as VALID_VALIDITY_STATE, $fd2148440a13ec26$export$dad6ae84456c676a as DEFAULT_VALIDATION_RESULT, $fd2148440a13ec26$export$571b5131b7e65c11 as FormValidationContext, $fd2148440a13ec26$export$a763b9476acd3eb as privateValidationStateProp, $fd2148440a13ec26$export$fc1a364ae1f3ff10 as useFormValidationState, $fd2148440a13ec26$export$75ee7c75d68f5b0e as mergeValidation};
+//# sourceMappingURL=useFormValidationState.mjs.map