@dynatrace/strato-components 3.13.3 → 3.14.0

package/esm/forms/forms-core/hooks/useFormControl.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/forms/forms-core/hooks/useFormControl.ts"],
-  "sourcesContent": ["import {\n  useCallback,\n  useEffect,\n  useMemo,\n  useState,\n  type Dispatch,\n  type FocusEventHandler,\n  type ReactNode,\n} from 'react';\n\nimport { useFormFieldContext } from './useFormFieldContext.js';\nimport { useFormFieldMessagesContext } from './useFormFieldMessagesContext.js';\nimport { useFormControlState } from '../../../core/hooks/useFormControlState.js';\nimport { useId } from '../../../core/hooks/useId.js';\n// oxlint-disable-next-line typescript/no-deprecated\nimport type { FormControlState } from '../../../core/types/form-control-state.js';\nimport { parseBoolean } from '../../../core/utils/parse-boolean.js';\nimport {\n  FormFieldMessagesAction,\n  type FormFieldMessagesReducerAction,\n} from '../state/formfield-messages-state-reducer.js';\nimport { FormFieldAction } from '../state/formfield-state-reducer.js';\nimport type { FormFieldMessageContextState } from '../types/formfield-messages.types.js';\n\n/**\n * When validation errors first become visible.\n * - `'immediate'` (default): an error is surfaced as soon as it exists (after\n *   the field is touched). It stays visible and updates live while the user is\n *   editing.\n * - `'after-blur'`: an error becomes visible on blur. While the user is editing\n *   (focus inside), a shown error stays visible until all errors are resolved,\n *   then clears; a new error raised while editing is held back until the next\n *   blur. Used by complex inputs (e.g. `FilterField`) where intermediate values\n *   are expected to be invalid.\n *\n * See `forms/validation/api-proposals/validation-visibility.md`.\n * @internal\n */\nexport type ValidationVisibility = 'immediate' | 'after-blur';\n\n/**\n * Props for `useFormControl`. Mirrors the inputs of the legacy form-control\n * hook stack that Strato controls used to call individually.\n * @internal \u2014 Strato controls only.\n */\nexport interface UseFormControlProps {\n  /** Control id passed directly to the form control. */\n  propId?: string;\n  /** Disabled state passed directly to the form control. */\n  propDisabled?: boolean;\n  /** Aria-disabled state passed directly to the form control. */\n  propAriaDisabled?: boolean | 'true' | 'false';\n  /** Required state passed directly to the form control. */\n  propRequired?: boolean;\n  /** Read-only state passed directly to the form control. */\n  propReadOnly?: boolean;\n  /**\n   * Legacy `controlState` plumbing for hint/error.\n   * Removed by APPDEV-8298.\n   */\n  // oxlint-disable-next-line typescript/no-deprecated\n  controlState?: FormControlState;\n  /**\n   * When validation errors first become visible. Defaults to `'immediate'`.\n   * @internal\n   */\n  validationVisibility?: ValidationVisibility;\n  /**\n   * Control-local validation state used by complex controls while their\n   * message-context update has not rendered yet. This does not replace the\n   * message context; it only lets after-blur visibility react in the same\n   * render as the control's own validation state.\n   * Ignored when `validationVisibility === 'immediate'`.\n   * @internal\n   */\n  hasValidationError?: boolean;\n}\n\n/** @internal */\nexport interface UseFormControlReturnType {\n  id: string;\n  disabled: boolean | undefined;\n  required: boolean | undefined;\n  readOnly: boolean | undefined;\n  ariaDisabled: boolean | undefined;\n  inputProps: { 'aria-describedby'?: string; 'aria-invalid': boolean };\n  hintProps: { id: string; 'aria-live': 'polite' };\n  /** Hint content from the legacy `controlState` prop, if any. */\n  hint: ReactNode;\n  /** True if the control should render error styling right now. Disabled-gated. */\n  showError: boolean;\n  /** Always present (defaults to empty state when no FormField wraps). */\n  messageState: FormFieldMessageContextState;\n  /** Undefined when no FormField wraps the control. */\n  messageDispatch: Dispatch<FormFieldMessagesReducerAction> | undefined;\n  /**\n   * Focus handlers for the element that defines \"the field\". Only\n   * meaningful in `'after-blur'` mode; an empty object otherwise, so callers\n   * can spread it unconditionally.\n   * @internal\n   */\n  focusHandlers: {\n    onFocus?: FocusEventHandler;\n    onBlur?: FocusEventHandler;\n  };\n  /**\n   * Mark the field touched and reveal any error immediately, ignoring focus.\n   * Wire to a control's imperative `validate()` so parent-driven validation\n   * paints the error even while focus is still inside the field. No-op in\n   * `'immediate'` mode.\n   * @internal\n   */\n  markTouched: () => void;\n}\n\n/**\n * Single entry point for Strato controls to wire id, disabled/required/readOnly\n * synchronisation with the FormField context, error/hint plumbing, and ARIA\n * attributes. Has no knowledge of `_Form`; that wiring lives in\n * `useInternalFormRegistration`.\n * @internal \u2014 Strato controls only.\n */\nexport function useFormControl({\n  propId,\n  propDisabled,\n  propAriaDisabled,\n  propRequired,\n  propReadOnly,\n  controlState,\n  validationVisibility = 'immediate',\n  hasValidationError = false,\n}: UseFormControlProps): UseFormControlReturnType {\n  const uniqueId = useId();\n  const {\n    // oxlint-disable-next-line typescript/no-deprecated\n    controlId,\n    formFieldId,\n    required: contextRequired,\n    disabled: contextDisabled,\n    ariaDisabled: contextAriaDisabled,\n    readOnly: contextReadOnly,\n    dispatch: formFieldDispatch,\n    registerFormControlId,\n  } = useFormFieldContext();\n\n  const { state: messageState, dispatch: messageDispatch } =\n    useFormFieldMessagesContext();\n\n  const disabled = propDisabled ?? contextDisabled;\n  const ariaDisabled = parseBoolean(propAriaDisabled) ?? contextAriaDisabled;\n  const required = propRequired ?? contextRequired;\n  const readOnly = propReadOnly ?? contextReadOnly;\n  const legacyFallbackId = formFieldId ?? controlId;\n  const id = propId || legacyFallbackId || uniqueId;\n\n  useEffect(() => {\n    formFieldDispatch?.({\n      type: FormFieldAction.UPDATE,\n      payload: {\n        disabled: propDisabled,\n        required: propRequired,\n        ariaDisabled: parseBoolean(propAriaDisabled),\n        readOnly: propReadOnly,\n      },\n    });\n  }, [\n    formFieldDispatch,\n    propDisabled,\n    propRequired,\n    propAriaDisabled,\n    propReadOnly,\n  ]);\n\n  useEffect(() => {\n    messageDispatch?.({\n      type: FormFieldMessagesAction.DISABLEMESSAGE,\n      payload: { isDisabled: disabled },\n    });\n  }, [disabled, messageDispatch]);\n\n  useEffect(() => registerFormControlId(id), [id, registerFormControlId]);\n\n  useEffect(() => {\n    messageDispatch?.({\n      type: FormFieldMessagesAction.SETFORMCONTROLID,\n      payload: { formControlId: id },\n    });\n  }, [messageDispatch, id]);\n\n  const [hasLegacyHintError, hint] = useFormControlState(controlState);\n\n  const isAfterBlur = validationVisibility === 'after-blur';\n\n  // `after-blur` state machine \u2014 ported from FilterField. `revealed` is sticky:\n  // once an error is shown on blur it stays visible while the user edits, until\n  // every error is resolved; a new error that appears while editing is held\n  // back until the next blur (re-reveal). `markTouched` forces a reveal now,\n  // ignoring focus.\n  const [hasFocusWithin, setHasFocusWithin] = useState(false);\n  const [revealed, setRevealed] = useState(false);\n\n  const hasAnyError =\n    messageState.showError ||\n    hasLegacyHintError ||\n    (isAfterBlur && hasValidationError);\n\n  // Adjust `revealed` during render (React's \"adjusting state on prop change\"\n  // pattern) rather than in an effect, so the visible state is correct on the\n  // same render \u2014 no lag and no race with a `markTouched()` that runs in the\n  // same batch as the error being added.\n  let nextRevealed = revealed;\n  if (isAfterBlur) {\n    if (revealed && !hasAnyError) {\n      nextRevealed = false;\n    } else if (\n      !hasFocusWithin &&\n      (messageState.isTouched ?? false) &&\n      hasAnyError\n    ) {\n      nextRevealed = true;\n    }\n    // The `nextRevealed !== revealed` guard is required because this setter is\n    // called during render (the \"adjusting state on prop change\" pattern above),\n    // NOT from an event handler or effect. React's Object.is bail-out inside\n    // `dispatchSetState` only runs for updates dispatched outside of render;\n    // render-phase updates take a different code path that always schedules\n    // another render pass and never compares against the current state. Calling\n    // `setRevealed(nextRevealed)` unconditionally therefore re-schedules on\n    // every render and trips the \"Too many re-renders\" bail-out. FilterField is\n    // the only `after-blur` consumer and reproduces this immediately on mount.\n    if (nextRevealed !== revealed) {\n      setRevealed(nextRevealed);\n    }\n  }\n\n  // `messageState.showError` bypasses the after-blur gate on its own (e.g. a\n  // `showImmediately` message forces it true before the field is touched) \u2014\n  // mirror that bypass here so the input's error styling matches the message.\n  const showValidationError = isAfterBlur\n    ? (hasAnyError && nextRevealed) || messageState.showError\n    : messageState.showError;\n\n  // Legacy `controlState` has always been an explicit consumer-controlled\n  // visual state. Keep it outside the after-blur reveal gate so existing\n  // consumers can still force an error immediately, even for complex controls.\n  const showError = !disabled && (showValidationError || hasLegacyHintError);\n\n  const hintId = useId();\n  const inputProps = {\n    'aria-describedby': hint ? hintId : undefined,\n    'aria-invalid': showValidationError || hasLegacyHintError,\n  };\n  const hintProps = { id: hintId, 'aria-live': 'polite' as const };\n\n  const focusHandlers = useMemo<UseFormControlReturnType['focusHandlers']>(\n    () =>\n      isAfterBlur\n        ? {\n            onFocus: () => setHasFocusWithin(true),\n            onBlur: (event) => {\n              if (!event.currentTarget.contains(event.relatedTarget)) {\n                setHasFocusWithin(false);\n                messageDispatch?.({\n                  type: FormFieldMessagesAction.SETISTOUCHED,\n                  payload: { isTouched: true },\n                });\n              }\n            },\n          }\n        : {},\n    [isAfterBlur, messageDispatch],\n  );\n\n  const markTouched = useCallback(() => {\n    if (!isAfterBlur) {\n      return;\n    }\n    messageDispatch?.({\n      type: FormFieldMessagesAction.SETISTOUCHED,\n      payload: { isTouched: true },\n    });\n    setRevealed(true);\n  }, [isAfterBlur, messageDispatch]);\n\n  return {\n    id,\n    disabled,\n    required,\n    readOnly,\n    ariaDisabled,\n    inputProps,\n    hintProps,\n    hint,\n    showError,\n    messageState,\n    messageDispatch,\n    focusHandlers,\n    markTouched,\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  useCallback,\n  useEffect,\n  useMemo,\n  useState,\n  type Dispatch,\n  type FocusEventHandler,\n  type ReactNode,\n} from 'react';\n\nimport { useFormFieldContext } from './useFormFieldContext.js';\nimport { useFormFieldMessagesContext } from './useFormFieldMessagesContext.js';\nimport { useFormControlState } from '../../../core/hooks/useFormControlState.js';\nimport { useId } from '../../../core/hooks/useId.js';\n// oxlint-disable-next-line typescript/no-deprecated\nimport type { FormControlState } from '../../../core/types/form-control-state.js';\nimport { parseBoolean } from '../../../core/utils/parse-boolean.js';\nimport {\n  FormFieldMessagesAction,\n  type FormFieldMessagesReducerAction,\n} from '../state/formfield-messages-state-reducer.js';\nimport { FormFieldAction } from '../state/formfield-state-reducer.js';\nimport type { FormFieldMessageContextState } from '../types/formfield-messages.types.js';\n\n/**\n * When validation errors first become visible.\n * - `'immediate'` (default): an error is surfaced as soon as it exists (after\n *   the field is touched). It stays visible and updates live while the user is\n *   editing.\n * - `'after-blur'`: an error becomes visible on blur. While the user is editing\n *   (focus inside), a shown error stays visible until all errors are resolved,\n *   then clears; a new error raised while editing is held back until the next\n *   blur. Used by complex inputs (e.g. `FilterField`) where intermediate values\n *   are expected to be invalid.\n *\n * See `forms/validation/api-proposals/validation-visibility.md`.\n * @internal\n */\nexport type ValidationVisibility = 'immediate' | 'after-blur';\n\n/**\n * Props for `useFormControl`. Mirrors the inputs of the legacy form-control\n * hook stack that Strato controls used to call individually.\n * @internal \u2014 Strato controls only.\n */\nexport interface UseFormControlProps {\n  /** Control id passed directly to the form control. */\n  propId?: string;\n  /** Disabled state passed directly to the form control. */\n  propDisabled?: boolean;\n  /** Aria-disabled state passed directly to the form control. */\n  propAriaDisabled?: boolean | 'true' | 'false';\n  /** Required state passed directly to the form control. */\n  propRequired?: boolean;\n  /** Read-only state passed directly to the form control. */\n  propReadOnly?: boolean;\n  /**\n   * Legacy `controlState` plumbing for hint/error.\n   * Removed by APPDEV-8298.\n   */\n  // oxlint-disable-next-line typescript/no-deprecated\n  controlState?: FormControlState;\n  /**\n   * When validation errors first become visible. Defaults to `'immediate'`.\n   * @internal\n   */\n  validationVisibility?: ValidationVisibility;\n  /**\n   * Control-local validation state used by complex controls while their\n   * message-context update has not rendered yet. This does not replace the\n   * message context; it only lets after-blur visibility react in the same\n   * render as the control's own validation state.\n   * Ignored when `validationVisibility === 'immediate'`.\n   * @internal\n   */\n  hasValidationError?: boolean;\n}\n\n/** @internal */\nexport interface UseFormControlReturnType {\n  id: string;\n  disabled: boolean | undefined;\n  required: boolean | undefined;\n  readOnly: boolean | undefined;\n  ariaDisabled: boolean | undefined;\n  inputProps: { 'aria-describedby'?: string; 'aria-invalid': boolean };\n  hintProps: { id: string; 'aria-live': 'polite' };\n  /** Hint content from the legacy `controlState` prop, if any. */\n  hint: ReactNode;\n  /** True if the control should render error styling right now. Disabled-gated. */\n  showError: boolean;\n  /** Always present (defaults to empty state when no FormField wraps). */\n  messageState: FormFieldMessageContextState;\n  /** Undefined when no FormField wraps the control. */\n  messageDispatch: Dispatch<FormFieldMessagesReducerAction> | undefined;\n  /**\n   * Focus handlers for the element that defines \"the field\". Only\n   * meaningful in `'after-blur'` mode; an empty object otherwise, so callers\n   * can spread it unconditionally.\n   * @internal\n   */\n  focusHandlers: {\n    onFocus?: FocusEventHandler;\n    onBlur?: FocusEventHandler;\n  };\n  /**\n   * Mark the field touched and reveal any error immediately, ignoring focus.\n   * Wire to a control's imperative `validate()` so parent-driven validation\n   * paints the error even while focus is still inside the field. No-op in\n   * `'immediate'` mode.\n   * @internal\n   */\n  markTouched: () => void;\n}\n\n/**\n * Single entry point for Strato controls to wire id, disabled/required/readOnly\n * synchronisation with the FormField context, error/hint plumbing, and ARIA\n * attributes. Has no knowledge of `_Form`; that wiring lives in\n * `useInternalFormRegistration`.\n * @internal \u2014 Strato controls only.\n */\nexport function useFormControl({\n  propId,\n  propDisabled,\n  propAriaDisabled,\n  propRequired,\n  propReadOnly,\n  controlState,\n  validationVisibility = 'immediate',\n  hasValidationError = false,\n}: UseFormControlProps): UseFormControlReturnType {\n  const uniqueId = useId();\n  const {\n    // oxlint-disable-next-line typescript/no-deprecated\n    controlId,\n    formFieldId,\n    required: contextRequired,\n    disabled: contextDisabled,\n    ariaDisabled: contextAriaDisabled,\n    readOnly: contextReadOnly,\n    dispatch: formFieldDispatch,\n    registerFormControlId,\n  } = useFormFieldContext();\n\n  const { state: messageState, dispatch: rawMessageDispatch } =\n    useFormFieldMessagesContext();\n\n  // `controlState` is a self-contained, consumer-controlled visual override.\n  // Isolate it from the message-dispatch/validation system entirely: don't\n  // hand out a dispatch a control could use to pollute the shared\n  // `FormFieldMessages` state, and don't let that shared state leak into this\n  // control's own error/aria display.\n  const messageDispatch = controlState ? undefined : rawMessageDispatch;\n\n  const disabled = propDisabled ?? contextDisabled;\n  const ariaDisabled = parseBoolean(propAriaDisabled) ?? contextAriaDisabled;\n  const required = propRequired ?? contextRequired;\n  const readOnly = propReadOnly ?? contextReadOnly;\n  const legacyFallbackId = formFieldId ?? controlId;\n  const id = propId || legacyFallbackId || uniqueId;\n\n  useEffect(() => {\n    formFieldDispatch?.({\n      type: FormFieldAction.UPDATE,\n      payload: {\n        disabled: propDisabled,\n        required: propRequired,\n        ariaDisabled: parseBoolean(propAriaDisabled),\n        readOnly: propReadOnly,\n      },\n    });\n  }, [\n    formFieldDispatch,\n    propDisabled,\n    propRequired,\n    propAriaDisabled,\n    propReadOnly,\n  ]);\n\n  useEffect(() => {\n    messageDispatch?.({\n      type: FormFieldMessagesAction.DISABLEMESSAGE,\n      payload: { isDisabled: disabled },\n    });\n  }, [disabled, messageDispatch]);\n\n  useEffect(() => registerFormControlId(id), [id, registerFormControlId]);\n\n  useEffect(() => {\n    messageDispatch?.({\n      type: FormFieldMessagesAction.SETFORMCONTROLID,\n      payload: { formControlId: id },\n    });\n  }, [messageDispatch, id]);\n\n  const [showLegacyError, hint] = useFormControlState(controlState);\n\n  const isAfterBlur = validationVisibility === 'after-blur';\n\n  // `after-blur` state machine \u2014 ported from FilterField. `revealed` is sticky:\n  // once an error is shown on blur it stays visible while the user edits, until\n  // every error is resolved; a new error that appears while editing is held\n  // back until the next blur (re-reveal). `markTouched` forces a reveal now,\n  // ignoring focus.\n  const [hasFocusWithin, setHasFocusWithin] = useState(false);\n  const [revealed, setRevealed] = useState(false);\n\n  const hasAnyError =\n    (!controlState && messageState.showError) ||\n    showLegacyError ||\n    (isAfterBlur && hasValidationError);\n\n  // Adjust `revealed` during render (React's \"adjusting state on prop change\"\n  // pattern) rather than in an effect, so the visible state is correct on the\n  // same render \u2014 no lag and no race with a `markTouched()` that runs in the\n  // same batch as the error being added.\n  let nextRevealed = revealed;\n  if (isAfterBlur) {\n    if (revealed && !hasAnyError) {\n      nextRevealed = false;\n    } else if (\n      !hasFocusWithin &&\n      (messageState.isTouched ?? false) &&\n      hasAnyError\n    ) {\n      nextRevealed = true;\n    }\n    // The `nextRevealed !== revealed` guard is required because this setter is\n    // called during render (the \"adjusting state on prop change\" pattern above),\n    // NOT from an event handler or effect. React's Object.is bail-out inside\n    // `dispatchSetState` only runs for updates dispatched outside of render;\n    // render-phase updates take a different code path that always schedules\n    // another render pass and never compares against the current state. Calling\n    // `setRevealed(nextRevealed)` unconditionally therefore re-schedules on\n    // every render and trips the \"Too many re-renders\" bail-out. FilterField is\n    // the only `after-blur` consumer and reproduces this immediately on mount.\n    if (nextRevealed !== revealed) {\n      setRevealed(nextRevealed);\n    }\n  }\n\n  // Legacy `controlState` has always been an explicit consumer-controlled\n  // visual state, exclusive of message-driven validation \u2014 restore that\n  // exclusivity here so `controlState` fully isolates a control from the\n  // shared `FormFieldMessages` state instead of being OR'd with it.\n  // `messageState.showError` bypasses the after-blur gate on its own (e.g. a\n  // `showImmediately` message forces it true before the field is touched) \u2014\n  // mirror that bypass here so the input's error styling matches the message.\n  const showValidationError = controlState\n    ? false\n    : isAfterBlur\n      ? (hasAnyError && nextRevealed) || messageState.showError\n      : messageState.showError;\n\n  const showError = !disabled && (showValidationError || showLegacyError);\n\n  // Also isolate the returned `messageState`: some controls read it directly\n  // (e.g. to seed their own local reducer or ARIA wiring) rather than going\n  // through `showError`/`inputProps` above. When `controlState` is set, hand\n  // out a synthetic state reflecting `controlState`'s own validity instead of\n  // the raw, un-isolated shared state.\n  const resolvedMessageState = useMemo<FormFieldMessageContextState>(\n    () =>\n      controlState\n        ? {\n            errors: [],\n            hints: [],\n            isTouched: false,\n            showError: showLegacyError,\n            isValid: !showLegacyError,\n          }\n        : messageState,\n    [controlState, showLegacyError, messageState],\n  );\n\n  const hintId = useId();\n  const inputProps = {\n    'aria-describedby': hint ? hintId : undefined,\n    'aria-invalid': showValidationError || showLegacyError,\n  };\n  const hintProps = { id: hintId, 'aria-live': 'polite' as const };\n\n  const focusHandlers = useMemo<UseFormControlReturnType['focusHandlers']>(\n    () =>\n      isAfterBlur\n        ? {\n            onFocus: () => {\n              setHasFocusWithin(true);\n              // Clears touched so an error raised while editing stays hidden\n              // until the next blur. Already-shown errors are unaffected.\n              messageDispatch?.({\n                type: FormFieldMessagesAction.SETISTOUCHED,\n                payload: { isTouched: false },\n              });\n            },\n            onBlur: (event) => {\n              if (!event.currentTarget.contains(event.relatedTarget)) {\n                setHasFocusWithin(false);\n                messageDispatch?.({\n                  type: FormFieldMessagesAction.SETISTOUCHED,\n                  payload: { isTouched: true },\n                });\n              }\n            },\n          }\n        : {},\n    [isAfterBlur, messageDispatch],\n  );\n\n  const markTouched = useCallback(() => {\n    if (!isAfterBlur) {\n      return;\n    }\n    messageDispatch?.({\n      type: FormFieldMessagesAction.SETISTOUCHED,\n      payload: { isTouched: true },\n    });\n    setRevealed(true);\n  }, [isAfterBlur, messageDispatch]);\n\n  return {\n    id,\n    disabled,\n    required,\n    readOnly,\n    ariaDisabled,\n    inputProps,\n    hintProps,\n    hint,\n    showError,\n    messageState: resolvedMessageState,\n    messageDispatch,\n    focusHandlers,\n    markTouched,\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/esm/forms/forms-core/hooks/useFormFieldValidation.js

@@ -11,8 +11,8 @@ import {
   useIntl
 } from "react-intl";
 import { useFormFieldMessagesContext } from "./useFormFieldMessagesContext.js";
+import { useFormControlState } from "../../../core/hooks/useFormControlState.js";
 import { useId } from "../../../core/hooks/useId.js";
-import { Text } from "../../../typography/text/Text.js";
 import { useCustomMessageEmitter } from "../../validation/useCustomMessageEmitter.js";
 import { getValidationState } from "../../validation/validation-builders.js";
 import { FormFieldMessagesAction } from "../state/formfield-messages-state-reducer.js";
@@ -206,21 +206,27 @@ function getI18nValidationState(intl, element, trigger) {
     errorType ? getI18nValidationMessage(intl, errorType, element) : void 0
   );
 }
-function useFormFieldValidationAriaProps(ariaLabelingProps = {}) {
+function useFormFieldValidationAriaProps(ariaLabelingProps = {}, controlState) {
   const {
     state,
     fieldMessagesContainerId,
     formMessagesContainerId,
     routesAwayFromField
   } = useFormFieldMessagesContext();
+  const [hasControlStateError] = useFormControlState(controlState);
   const _ariaProps = useMemo(() => {
-    const hasHints = state.customMessages.some((m) => m.variant === "hint") || state.formControlMessages.some((m) => m.variant === "hint");
-    const hasInlineErrors = state.customMessages.some((m) => m.variant === "error") || state.formControlMessages.some(
-      (m) => m.variant === "error" && (!routesAwayFromField || m.source === "custom")
-    );
-    const hasRoutedErrors = routesAwayFromField && state.formControlMessages.some(
-      (m) => m.variant === "error" && m.source !== "custom"
+    if (controlState) {
+      return {
+        "aria-errormessage": void 0,
+        "aria-invalid": hasControlStateError,
+        "aria-describedby": void 0
+      };
+    }
+    const hasHints = state.hints.length > 0;
+    const hasInlineErrors = state.errors.some(
+      ({ error }) => !routesAwayFromField || error.source === "custom"
     );
+    const hasRoutedErrors = routesAwayFromField && state.errors.some(({ error }) => error.source !== "custom");
     const hasInlineContent = hasHints || state.showError && hasInlineErrors;
     let activeErrorContainerId;
     if (state.showError && hasInlineErrors) {
@@ -244,49 +250,51 @@ function useFormFieldValidationAriaProps(ariaLabelingProps = {}) {
   }, [
     routesAwayFromField,
     formMessagesContainerId,
-    state.customMessages,
-    state.formControlMessages,
+    state.errors,
+    state.hints,
     state.showError,
-    fieldMessagesContainerId
+    controlState,
+    hasControlStateError
   ]);
   const ariaProps = getCombinedAriaProps(_ariaProps, ariaLabelingProps);
   return ariaProps;
 }
-function useFormFieldValidation(ref, validationDeps = {}, ariaLabelingProps = {}, controlId, emitValidationStateProp) {
+function useFormFieldValidation(ref, validationDeps = {}, ariaLabelingProps = {}, controlId, emitValidationStateProp, controlState) {
   const { state, dispatch } = useFormFieldMessagesContext();
   const intl = useIntl();
   const errorId = useId();
-  const ariaProps = useFormFieldValidationAriaProps(ariaLabelingProps);
-  const formControlMessagesRef = useRef(state.formControlMessages);
-  formControlMessagesRef.current = state.formControlMessages;
+  const ariaProps = useFormFieldValidationAriaProps(
+    ariaLabelingProps,
+    controlState
+  );
+  const errorsRef = useRef(state.errors);
+  errorsRef.current = state.errors;
   const updateErrorMessages = useCallback(() => {
     const errorType = getErrorType(ref.current?.validity);
-    formControlMessagesRef.current.forEach((message) => {
-      if (message.id === errorId && message.validityStateKey !== errorType && message.validityStateKey !== "customError") {
+    const { errors } = getI18nValidationState(intl, ref.current, "manual");
+    const nextError = errorType ? errors.find((error) => error.validityStateKey.toString() === errorType) : void 0;
+    errorsRef.current.forEach(({ id: messageId, error }) => {
+      const key = error.validityStateKey.toString();
+      if (messageId === errorId && key !== errorType && key !== "customError") {
         dispatch?.({
           type: FormFieldMessagesAction.REMOVEMESSAGE,
           payload: {
-            id: message.id,
-            messageType: "formcontrol",
-            controlId
+            id: messageId,
+            source: error.source
           }
         });
       }
     });
-    if (errorType) {
+    if (nextError) {
       dispatch?.({
         type: FormFieldMessagesAction.ADDMESSAGE,
         payload: {
           id: errorId,
-          message: /* @__PURE__ */ jsx(Text, { textStyle: "small", as: "p", children: getI18nErrorMessage(errorType, ref.current) }),
-          validityStateKey: errorType,
-          messageType: "formcontrol",
-          variant: "error",
-          controlId
+          error: nextError
         }
       });
     }
-  }, [controlId, dispatch, errorId, ref]);
+  }, [dispatch, errorId, intl, ref]);
   const onInvalid = useCallback(
     (event) => {
       updateErrorMessages();
@@ -316,10 +324,28 @@ function useFormFieldValidation(ref, validationDeps = {}, ariaLabelingProps = {}
     updateErrorMessages();
     emitValidationState(getI18nValidationState(intl, ref.current, "change"));
   }, [updateErrorMessages, emitValidationState, intl, ref]);
+  const noop = useCallback(() => void 0, []);
+  const preventBrowserValidation = useCallback(
+    (event) => {
+      event.preventDefault();
+    },
+    []
+  );
   const validationDepsKey = JSON.stringify(validationDeps);
   useEffect(() => {
-    onChange();
-  }, [validationDepsKey, onChange]);
+    if (!controlState) {
+      onChange();
+    }
+  }, [controlState, validationDepsKey, onChange]);
+  if (controlState) {
+    return {
+      ariaProps,
+      onInvalid: preventBrowserValidation,
+      onChange: noop,
+      onBlur: noop,
+      emitValidationState
+    };
+  }
   return {
     ariaProps,
     onInvalid,

package/esm/forms/forms-core/hooks/useFormFieldValidation.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/forms/forms-core/hooks/useFormFieldValidation.tsx"],
-  "sourcesContent": ["import {\n  AriaAttributes,\n  type RefObject,\n  type SyntheticEvent,\n  type ChangeEvent,\n  type FocusEvent,\n  useCallback,\n  useMemo,\n  useEffect,\n  useRef,\n} from 'react';\nimport {\n  FormattedMessage,\n  defineMessages,\n  useIntl,\n  type IntlShape,\n} from 'react-intl';\n\nimport { useFormFieldMessagesContext } from './useFormFieldMessagesContext.js';\nimport { useId } from '../../../core/hooks/useId.js';\nimport { AriaLabelingProps } from '../../../core/types/a11y-props.js';\nimport { Text } from '../../../typography/text/Text.js';\nimport type {\n  ValidationState,\n  ValidationTrigger,\n} from '../../validation/types.js';\nimport { useCustomMessageEmitter } from '../../validation/useCustomMessageEmitter.js';\nimport { getValidationState } from '../../validation/validation-builders.js';\nimport { FormFieldMessagesAction } from '../state/formfield-messages-state-reducer.js';\n\ntype FormFieldElement =\n  | HTMLInputElement\n  | HTMLSelectElement\n  | HTMLTextAreaElement;\n\n/**\n * Getter function to read the error type form the validity state.\n * The validity state values are readonly and can't therefore not be iterated but need to accessed directly instead.\n * https://stackoverflow.com/questions/20891950/html-validation-api-returns-an-empty-object-in-firefox?rq=2\n * @internal\n */\nexport function getErrorType(validityState?: ValidityState) {\n  if (!validityState) {\n    return null;\n  }\n\n  if (validityState.badInput) {\n    return 'badInput';\n  }\n  if (validityState.patternMismatch) {\n    return 'patternMismatch';\n  }\n  if (validityState.rangeOverflow) {\n    return 'rangeOverflow';\n  }\n  if (validityState.rangeUnderflow) {\n    return 'rangeUnderflow';\n  }\n  if (validityState.stepMismatch) {\n    return 'stepMismatch';\n  }\n  if (validityState.tooLong) {\n    return 'tooLong';\n  }\n  if (validityState.tooShort) {\n    return 'tooShort';\n  }\n  if (validityState.typeMismatch) {\n    return 'typeMismatch';\n  }\n  if (validityState.valueMissing) {\n    return 'valueMissing';\n  }\n  /** We don't check for custom error since those should never be automatically updated. */\n  return null;\n}\n\nconst validationMessages = defineMessages({\n  badInput: {\n    id: '/cwiOkubC69MZmRu',\n    defaultMessage: 'Please provide input in a valid format.',\n    description:\n      'Error message for input that the browser is unable to convert, e.g. string for a number input.',\n  },\n  patternMismatch: {\n    id: 'qPeX7AgKbKzBFqGZ',\n    defaultMessage: 'Please match the format requested.',\n    description:\n      \"Error message for input that doesn't follow the requested pattern.\",\n  },\n  rangeOverflow: {\n    id: '14mVeqEFpqD2fpev',\n    defaultMessage: 'Value must be less or equal to {max}.',\n    description: 'Error message for input that value is higher then the max.',\n  },\n  rangeUnderflow: {\n    id: '5XoVjJUQ5b86MLW+',\n    defaultMessage: 'Value must be higher or equal to {min}.',\n    description: 'Error message for input that value is lower then the max.',\n  },\n  stepMismatch: {\n    id: 'MYfVMxPsAgOn8JSP',\n    defaultMessage: 'Value must be a multiple of {step}, starting from {min}.',\n    description:\n      'Only values which are a whole number of steps from the step base are valid. The step base is min if specified, value otherwise, or 0 if neither is provided.',\n  },\n  tooLong: {\n    id: 'JOIA3jQfIIkgnW04',\n    defaultMessage:\n      'Please shorten this text to {maxLength} characters or less.',\n    description: 'Error message for input that is shorter than the maxLength.',\n  },\n  tooShort: {\n    id: 'sJeuQTGrzcMvd6fY',\n    defaultMessage:\n      'Please lengthen this text to {minLength} characters or more.',\n    description: 'Error message for input that is shorter than the minLength.',\n  },\n  typeMismatch: {\n    id: 'fLfhKO8cXlo3vW5M',\n    defaultMessage:\n      'Please provide a value that matches the requested type ({type}).',\n    description:\n      \"Error message for input that doesn't match the expected type.\",\n  },\n  valueMissing: {\n    id: 'laIylhVFbIvEZrxt',\n    defaultMessage: 'Please fill in this field.',\n    description: 'Error message for missing input.',\n  },\n});\n\n/**\n * Internal getter function to return the matching formatted message for\n * each validityStateKey.\n * @internal\n */\nexport function getI18nErrorMessage(\n  key: keyof ValidityState,\n  ref?: FormFieldElement | null,\n) {\n  switch (key) {\n    case 'badInput':\n      return <FormattedMessage {...validationMessages.badInput} />;\n    case 'patternMismatch':\n      return <FormattedMessage {...validationMessages.patternMismatch} />;\n    case 'rangeOverflow':\n      return (\n        <FormattedMessage\n          {...validationMessages.rangeOverflow}\n          values={{ max: ref?.getAttribute('max') }}\n        />\n      );\n    case 'rangeUnderflow':\n      return (\n        <FormattedMessage\n          {...validationMessages.rangeUnderflow}\n          values={{ min: ref?.getAttribute('min') }}\n        />\n      );\n    case 'stepMismatch':\n      return (\n        <FormattedMessage\n          {...validationMessages.stepMismatch}\n          values={{\n            step: ref?.getAttribute('step'),\n            min: ref?.getAttribute('min') ?? '0',\n          }}\n        />\n      );\n    case 'tooLong':\n      return (\n        <FormattedMessage\n          {...validationMessages.tooLong}\n          values={{ maxLength: ref?.getAttribute('maxLength') }}\n        />\n      );\n    case 'tooShort':\n      return (\n        <FormattedMessage\n          {...validationMessages.tooShort}\n          values={{ minLength: ref?.getAttribute('minLength') }}\n        />\n      );\n    case 'typeMismatch':\n      return (\n        <FormattedMessage\n          {...validationMessages.typeMismatch}\n          values={{ type: ref?.getAttribute('type') }}\n        />\n      );\n    case 'valueMissing':\n      return <FormattedMessage {...validationMessages.valueMissing} />;\n    case 'customError':\n    case 'valid':\n    default:\n      return null;\n  }\n}\n\n/**\n * Returns the translated plain-string validation message for a given validity\n * state key. Mirrors the JSX messages in {@link getI18nErrorMessage} using the\n * same descriptors so both the UI and `ValidationError.message` stay in sync.\n *\n * @internal\n */\nexport function getI18nValidationMessage(\n  intl: IntlShape,\n  key: keyof ValidityState,\n  ref?: FormFieldElement | null,\n): string {\n  switch (key) {\n    case 'badInput':\n      return intl.formatMessage(validationMessages.badInput);\n    case 'patternMismatch':\n      return intl.formatMessage(validationMessages.patternMismatch);\n    case 'rangeOverflow':\n      return intl.formatMessage(validationMessages.rangeOverflow, {\n        max: ref?.getAttribute('max'),\n      });\n    case 'rangeUnderflow':\n      return intl.formatMessage(validationMessages.rangeUnderflow, {\n        min: ref?.getAttribute('min'),\n      });\n    case 'stepMismatch':\n      return intl.formatMessage(validationMessages.stepMismatch, {\n        step: ref?.getAttribute('step'),\n        min: ref?.getAttribute('min') ?? '0',\n      });\n    case 'tooLong':\n      return intl.formatMessage(validationMessages.tooLong, {\n        maxLength: ref?.getAttribute('maxLength'),\n      });\n    case 'tooShort':\n      return intl.formatMessage(validationMessages.tooShort, {\n        minLength: ref?.getAttribute('minLength'),\n      });\n    case 'typeMismatch':\n      return intl.formatMessage(validationMessages.typeMismatch, {\n        type: ref?.getAttribute('type'),\n      });\n    case 'valueMissing':\n      return intl.formatMessage(validationMessages.valueMissing);\n    default:\n      return '';\n  }\n}\n\n/**\n * Builds a ValidationState with an i18n message for the current validity of\n * `element`, bypassing the corrupted `element.validationMessage` that\n * `setCustomValidity` produces.\n * @internal\n */\nexport function getI18nValidationState(\n  intl: IntlShape,\n  element: FormFieldElement | null | undefined,\n  trigger: ValidationTrigger,\n): ValidationState {\n  const errorType = getErrorType(element?.validity);\n  return getValidationState(\n    element,\n    trigger,\n    errorType ? getI18nValidationMessage(intl, errorType, element) : undefined,\n  );\n}\n\n/** @internal */\ninterface FormFieldValidationProps {\n  ariaProps: Pick<\n    AriaAttributes,\n    'aria-errormessage' | 'aria-invalid' | 'aria-describedby'\n  >;\n  onInvalid: (event: SyntheticEvent<FormFieldElement>) => void;\n  onChange: (event?: ChangeEvent<FormFieldElement>) => void;\n  onBlur: (event?: FocusEvent<FormFieldElement>) => void;\n  emitValidationState: (state: ValidationState) => ValidationState;\n}\n\n/**\n * Hook to generate ARIA props based on the form field messages\n * @param ariaLabelingProps - ARIA labeling properties\n * @returns ARIA props for the form field\n * @internal\n */\nexport function useFormFieldValidationAriaProps(\n  ariaLabelingProps: AriaLabelingProps = {},\n) {\n  const {\n    state,\n    fieldMessagesContainerId,\n    formMessagesContainerId,\n    routesAwayFromField,\n  } = useFormFieldMessagesContext();\n\n  const _ariaProps = useMemo(() => {\n    const hasHints =\n      state.customMessages.some((m) => m.variant === 'hint') ||\n      state.formControlMessages.some((m) => m.variant === 'hint');\n    // Errors visible in the inline FormFieldMessages container (custom source always stays).\n    const hasInlineErrors =\n      state.customMessages.some((m) => m.variant === 'error') ||\n      state.formControlMessages.some(\n        (m) =>\n          m.variant === 'error' &&\n          (!routesAwayFromField || m.source === 'custom'),\n      );\n    // Native errors routed to the form-wide outlet instead of the inline container.\n    const hasRoutedErrors =\n      routesAwayFromField &&\n      state.formControlMessages.some(\n        (m) => m.variant === 'error' && m.source !== 'custom',\n      );\n    const hasInlineContent = hasHints || (state.showError && hasInlineErrors);\n\n    let activeErrorContainerId: string | undefined;\n    if (state.showError && hasInlineErrors) {\n      activeErrorContainerId = fieldMessagesContainerId;\n    } else if (state.showError && hasRoutedErrors) {\n      activeErrorContainerId = formMessagesContainerId;\n    }\n\n    const ariaDescribedByParts: string[] = [];\n    if (hasInlineContent && fieldMessagesContainerId) {\n      ariaDescribedByParts.push(fieldMessagesContainerId);\n    }\n    if (state.showError && hasRoutedErrors && formMessagesContainerId) {\n      ariaDescribedByParts.push(formMessagesContainerId);\n    }\n    const ariaDescribedBy =\n      ariaDescribedByParts.length > 0\n        ? ariaDescribedByParts.join(' ')\n        : undefined;\n\n    return {\n      'aria-errormessage': activeErrorContainerId,\n      'aria-invalid': state.showError,\n      'aria-describedby': ariaDescribedBy,\n    };\n  }, [\n    routesAwayFromField,\n    formMessagesContainerId,\n    state.customMessages,\n    state.formControlMessages,\n    state.showError,\n    fieldMessagesContainerId,\n  ]);\n  const ariaProps = getCombinedAriaProps(_ariaProps, ariaLabelingProps);\n\n  return ariaProps;\n}\n\n/**\n * @param ref - Reference to the input element\n * @param validationDeps - Values that trigger re-validation when changed (e.g., [required, min, max, pattern]).\n * @param ariaLabelingProps - ARIA labeling properties\n * @param controlId - Optional control ID for message management\n * @internal\n */\nexport function useFormFieldValidation(\n  ref: RefObject<FormFieldElement | null>,\n  validationDeps: Record<string, string | number | boolean | undefined> = {},\n  ariaLabelingProps: AriaLabelingProps = {},\n  controlId?: string,\n  emitValidationStateProp?: (state: ValidationState) => void,\n): FormFieldValidationProps {\n  const { state, dispatch } = useFormFieldMessagesContext();\n  const intl = useIntl();\n  const errorId = useId();\n\n  const ariaProps = useFormFieldValidationAriaProps(ariaLabelingProps);\n\n  // Keep a ref to the current formControlMessages so `updateErrorMessages`\n  // can read the latest list without listing it as a reactive dependency.\n  // If it were a dependency, any dispatch (add/remove message) would recreate\n  // the callback, re-trigger the useEffect below, which would dispatch again \u2014\n  // causing an infinite loop.\n  const formControlMessagesRef = useRef(state.formControlMessages);\n  formControlMessagesRef.current = state.formControlMessages;\n\n  const updateErrorMessages = useCallback(() => {\n    const errorType = getErrorType(ref.current?.validity);\n\n    formControlMessagesRef.current.forEach((message) => {\n      if (\n        message.id === errorId &&\n        message.validityStateKey !== errorType &&\n        message.validityStateKey !== 'customError'\n      ) {\n        dispatch?.({\n          type: FormFieldMessagesAction.REMOVEMESSAGE,\n          payload: {\n            id: message.id,\n            messageType: 'formcontrol',\n            controlId,\n          },\n        });\n      }\n    });\n\n    if (errorType) {\n      dispatch?.({\n        type: FormFieldMessagesAction.ADDMESSAGE,\n        payload: {\n          id: errorId,\n          message: (\n            <Text textStyle=\"small\" as=\"p\">\n              {getI18nErrorMessage(errorType, ref.current)}\n            </Text>\n          ),\n          validityStateKey: errorType,\n          messageType: 'formcontrol',\n          variant: 'error',\n          controlId,\n        },\n      });\n    }\n  }, [controlId, dispatch, errorId, ref]); // formControlMessages intentionally excluded \u2014 read via ref above\n\n  const onInvalid = useCallback(\n    (event: SyntheticEvent<FormFieldElement>) => {\n      updateErrorMessages();\n\n      dispatch?.({\n        type: FormFieldMessagesAction.SETISTOUCHED,\n        payload: { isTouched: true },\n      });\n\n      // Prevents the browser validation pop up.\n      event.preventDefault();\n    },\n    [dispatch, updateErrorMessages],\n  );\n\n  const emitValidationState = useCustomMessageEmitter(\n    emitValidationStateProp,\n    () => getI18nValidationState(intl, ref.current, 'manual'),\n  );\n\n  // Remove once useContainerFocus is correctly implemented and used in all form controls.\n  const onBlur = useCallback(() => {\n    ref.current?.reportValidity();\n    dispatch?.({\n      type: FormFieldMessagesAction.SETISTOUCHED,\n      payload: { isTouched: true },\n    });\n    if (!state.isTouched) {\n      emitValidationState(getI18nValidationState(intl, ref.current, 'blur'));\n    }\n  }, [dispatch, emitValidationState, intl, ref, state.isTouched]);\n\n  const onChange = useCallback(() => {\n    updateErrorMessages();\n    emitValidationState(getI18nValidationState(intl, ref.current, 'change'));\n  }, [updateErrorMessages, emitValidationState, intl, ref]);\n\n  const validationDepsKey = JSON.stringify(validationDeps);\n\n  useEffect(() => {\n    onChange();\n  }, [validationDepsKey, onChange]);\n\n  return {\n    ariaProps,\n    onInvalid,\n    onChange,\n    onBlur,\n    emitValidationState,\n  };\n}\n\n/* @internal - function to combine aria-labelling and validation aria-props correctly. */\nexport function getCombinedAriaProps(\n  validationAriaProps: Pick<\n    AriaAttributes,\n    'aria-errormessage' | 'aria-invalid' | 'aria-describedby'\n  >,\n  labelingProps: AriaLabelingProps,\n) {\n  const {\n    'aria-describedby': validationDescription,\n    ...remainingValidationProps\n  } = validationAriaProps;\n  const { 'aria-describedby': propDescription, ...remainingLabelingProps } =\n    labelingProps;\n\n  if (validationDescription && propDescription) {\n    return {\n      ...remainingLabelingProps,\n      ...remainingValidationProps,\n      'aria-describedby': (\n        validationDescription +\n        ' ' +\n        propDescription\n      ).trim(),\n    };\n  }\n\n  return {\n    ...remainingLabelingProps,\n    ...remainingValidationProps,\n    'aria-describedby': validationDescription ?? propDescription,\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  AriaAttributes,\n  type RefObject,\n  type SyntheticEvent,\n  type ChangeEvent,\n  type FocusEvent,\n  useCallback,\n  useMemo,\n  useEffect,\n  useRef,\n} from 'react';\nimport {\n  FormattedMessage,\n  defineMessages,\n  useIntl,\n  type IntlShape,\n} from 'react-intl';\n\nimport { useFormFieldMessagesContext } from './useFormFieldMessagesContext.js';\nimport { useFormControlState } from '../../../core/hooks/useFormControlState.js';\nimport { useId } from '../../../core/hooks/useId.js';\nimport { AriaLabelingProps } from '../../../core/types/a11y-props.js';\n// oxlint-disable-next-line typescript/no-deprecated\nimport type { FormControlState } from '../../../core/types/form-control-state.js';\nimport type {\n  ValidationState,\n  ValidationTrigger,\n} from '../../validation/types.js';\nimport { useCustomMessageEmitter } from '../../validation/useCustomMessageEmitter.js';\nimport { getValidationState } from '../../validation/validation-builders.js';\nimport { FormFieldMessagesAction } from '../state/formfield-messages-state-reducer.js';\n\ntype FormFieldElement =\n  | HTMLInputElement\n  | HTMLSelectElement\n  | HTMLTextAreaElement;\n\n/**\n * Getter function to read the error type form the validity state.\n * The validity state values are readonly and can't therefore not be iterated but need to accessed directly instead.\n * https://stackoverflow.com/questions/20891950/html-validation-api-returns-an-empty-object-in-firefox?rq=2\n * @internal\n */\nexport function getErrorType(validityState?: ValidityState) {\n  if (!validityState) {\n    return null;\n  }\n\n  if (validityState.badInput) {\n    return 'badInput';\n  }\n  if (validityState.patternMismatch) {\n    return 'patternMismatch';\n  }\n  if (validityState.rangeOverflow) {\n    return 'rangeOverflow';\n  }\n  if (validityState.rangeUnderflow) {\n    return 'rangeUnderflow';\n  }\n  if (validityState.stepMismatch) {\n    return 'stepMismatch';\n  }\n  if (validityState.tooLong) {\n    return 'tooLong';\n  }\n  if (validityState.tooShort) {\n    return 'tooShort';\n  }\n  if (validityState.typeMismatch) {\n    return 'typeMismatch';\n  }\n  if (validityState.valueMissing) {\n    return 'valueMissing';\n  }\n  /** We don't check for custom error since those should never be automatically updated. */\n  return null;\n}\n\nconst validationMessages = defineMessages({\n  badInput: {\n    id: '/cwiOkubC69MZmRu',\n    defaultMessage: 'Please provide input in a valid format.',\n    description:\n      'Error message for input that the browser is unable to convert, e.g. string for a number input.',\n  },\n  patternMismatch: {\n    id: 'qPeX7AgKbKzBFqGZ',\n    defaultMessage: 'Please match the format requested.',\n    description:\n      \"Error message for input that doesn't follow the requested pattern.\",\n  },\n  rangeOverflow: {\n    id: '14mVeqEFpqD2fpev',\n    defaultMessage: 'Value must be less or equal to {max}.',\n    description: 'Error message for input that value is higher then the max.',\n  },\n  rangeUnderflow: {\n    id: '5XoVjJUQ5b86MLW+',\n    defaultMessage: 'Value must be higher or equal to {min}.',\n    description: 'Error message for input that value is lower then the max.',\n  },\n  stepMismatch: {\n    id: 'MYfVMxPsAgOn8JSP',\n    defaultMessage: 'Value must be a multiple of {step}, starting from {min}.',\n    description:\n      'Only values which are a whole number of steps from the step base are valid. The step base is min if specified, value otherwise, or 0 if neither is provided.',\n  },\n  tooLong: {\n    id: 'JOIA3jQfIIkgnW04',\n    defaultMessage:\n      'Please shorten this text to {maxLength} characters or less.',\n    description: 'Error message for input that is shorter than the maxLength.',\n  },\n  tooShort: {\n    id: 'sJeuQTGrzcMvd6fY',\n    defaultMessage:\n      'Please lengthen this text to {minLength} characters or more.',\n    description: 'Error message for input that is shorter than the minLength.',\n  },\n  typeMismatch: {\n    id: 'fLfhKO8cXlo3vW5M',\n    defaultMessage:\n      'Please provide a value that matches the requested type ({type}).',\n    description:\n      \"Error message for input that doesn't match the expected type.\",\n  },\n  valueMissing: {\n    id: 'laIylhVFbIvEZrxt',\n    defaultMessage: 'Please fill in this field.',\n    description: 'Error message for missing input.',\n  },\n});\n\n/**\n * Internal getter function to return the matching formatted message for\n * each validityStateKey.\n * @internal\n */\nexport function getI18nErrorMessage(\n  key: keyof ValidityState,\n  ref?: FormFieldElement | null,\n) {\n  switch (key) {\n    case 'badInput':\n      return <FormattedMessage {...validationMessages.badInput} />;\n    case 'patternMismatch':\n      return <FormattedMessage {...validationMessages.patternMismatch} />;\n    case 'rangeOverflow':\n      return (\n        <FormattedMessage\n          {...validationMessages.rangeOverflow}\n          values={{ max: ref?.getAttribute('max') }}\n        />\n      );\n    case 'rangeUnderflow':\n      return (\n        <FormattedMessage\n          {...validationMessages.rangeUnderflow}\n          values={{ min: ref?.getAttribute('min') }}\n        />\n      );\n    case 'stepMismatch':\n      return (\n        <FormattedMessage\n          {...validationMessages.stepMismatch}\n          values={{\n            step: ref?.getAttribute('step'),\n            min: ref?.getAttribute('min') ?? '0',\n          }}\n        />\n      );\n    case 'tooLong':\n      return (\n        <FormattedMessage\n          {...validationMessages.tooLong}\n          values={{ maxLength: ref?.getAttribute('maxLength') }}\n        />\n      );\n    case 'tooShort':\n      return (\n        <FormattedMessage\n          {...validationMessages.tooShort}\n          values={{ minLength: ref?.getAttribute('minLength') }}\n        />\n      );\n    case 'typeMismatch':\n      return (\n        <FormattedMessage\n          {...validationMessages.typeMismatch}\n          values={{ type: ref?.getAttribute('type') }}\n        />\n      );\n    case 'valueMissing':\n      return <FormattedMessage {...validationMessages.valueMissing} />;\n    case 'customError':\n    case 'valid':\n    default:\n      return null;\n  }\n}\n\n/**\n * Returns the translated plain-string validation message for a given validity\n * state key. Mirrors the JSX messages in {@link getI18nErrorMessage} using the\n * same descriptors so both the UI and `ValidationError.message` stay in sync.\n *\n * @internal\n */\nexport function getI18nValidationMessage(\n  intl: IntlShape,\n  key: keyof ValidityState,\n  ref?: FormFieldElement | null,\n): string {\n  switch (key) {\n    case 'badInput':\n      return intl.formatMessage(validationMessages.badInput);\n    case 'patternMismatch':\n      return intl.formatMessage(validationMessages.patternMismatch);\n    case 'rangeOverflow':\n      return intl.formatMessage(validationMessages.rangeOverflow, {\n        max: ref?.getAttribute('max'),\n      });\n    case 'rangeUnderflow':\n      return intl.formatMessage(validationMessages.rangeUnderflow, {\n        min: ref?.getAttribute('min'),\n      });\n    case 'stepMismatch':\n      return intl.formatMessage(validationMessages.stepMismatch, {\n        step: ref?.getAttribute('step'),\n        min: ref?.getAttribute('min') ?? '0',\n      });\n    case 'tooLong':\n      return intl.formatMessage(validationMessages.tooLong, {\n        maxLength: ref?.getAttribute('maxLength'),\n      });\n    case 'tooShort':\n      return intl.formatMessage(validationMessages.tooShort, {\n        minLength: ref?.getAttribute('minLength'),\n      });\n    case 'typeMismatch':\n      return intl.formatMessage(validationMessages.typeMismatch, {\n        type: ref?.getAttribute('type'),\n      });\n    case 'valueMissing':\n      return intl.formatMessage(validationMessages.valueMissing);\n    default:\n      return '';\n  }\n}\n\n/**\n * Builds a ValidationState with an i18n message for the current validity of\n * `element`, bypassing the corrupted `element.validationMessage` that\n * `setCustomValidity` produces.\n * @internal\n */\nexport function getI18nValidationState(\n  intl: IntlShape,\n  element: FormFieldElement | null | undefined,\n  trigger: ValidationTrigger,\n): ValidationState {\n  const errorType = getErrorType(element?.validity);\n  return getValidationState(\n    element,\n    trigger,\n    errorType ? getI18nValidationMessage(intl, errorType, element) : undefined,\n  );\n}\n\n/** @internal */\ninterface FormFieldValidationProps {\n  ariaProps: Pick<\n    AriaAttributes,\n    'aria-errormessage' | 'aria-invalid' | 'aria-describedby'\n  >;\n  onInvalid: (event: SyntheticEvent<FormFieldElement>) => void;\n  onChange: (event?: ChangeEvent<FormFieldElement>) => void;\n  onBlur: (event?: FocusEvent<FormFieldElement>) => void;\n  emitValidationState: (state: ValidationState) => ValidationState;\n}\n\n/**\n * Hook to generate ARIA props based on the form field messages\n * @param ariaLabelingProps - ARIA labeling properties\n * @param controlState - Legacy `controlState` override. When set, the shared\n * `FormFieldMessages` state is ignored entirely so `controlState` fully\n * isolates the control instead of being mixed with message-driven validation.\n * @returns ARIA props for the form field\n * @internal\n */\nexport function useFormFieldValidationAriaProps(\n  ariaLabelingProps: AriaLabelingProps = {},\n  // oxlint-disable-next-line typescript/no-deprecated\n  controlState?: FormControlState,\n) {\n  const {\n    state,\n    fieldMessagesContainerId,\n    formMessagesContainerId,\n    routesAwayFromField,\n  } = useFormFieldMessagesContext();\n  const [hasControlStateError] = useFormControlState(controlState);\n\n  const _ariaProps = useMemo(() => {\n    if (controlState) {\n      return {\n        'aria-errormessage': undefined,\n        'aria-invalid': hasControlStateError,\n        'aria-describedby': undefined,\n      };\n    }\n\n    const hasHints = state.hints.length > 0;\n    // Errors visible in the inline FormFieldMessages container (custom source always stays).\n    const hasInlineErrors = state.errors.some(\n      ({ error }) => !routesAwayFromField || error.source === 'custom',\n    );\n    // Native/Strato errors routed to the form-wide outlet instead of the inline container.\n    const hasRoutedErrors =\n      routesAwayFromField &&\n      state.errors.some(({ error }) => error.source !== 'custom');\n    const hasInlineContent = hasHints || (state.showError && hasInlineErrors);\n\n    let activeErrorContainerId: string | undefined;\n    if (state.showError && hasInlineErrors) {\n      activeErrorContainerId = fieldMessagesContainerId;\n    } else if (state.showError && hasRoutedErrors) {\n      activeErrorContainerId = formMessagesContainerId;\n    }\n\n    const ariaDescribedByParts: string[] = [];\n    if (hasInlineContent && fieldMessagesContainerId) {\n      ariaDescribedByParts.push(fieldMessagesContainerId);\n    }\n    if (state.showError && hasRoutedErrors && formMessagesContainerId) {\n      ariaDescribedByParts.push(formMessagesContainerId);\n    }\n    const ariaDescribedBy =\n      ariaDescribedByParts.length > 0\n        ? ariaDescribedByParts.join(' ')\n        : undefined;\n\n    return {\n      'aria-errormessage': activeErrorContainerId,\n      'aria-invalid': state.showError,\n      'aria-describedby': ariaDescribedBy,\n    };\n  }, [\n    routesAwayFromField,\n    formMessagesContainerId,\n    state.errors,\n    state.hints,\n    state.showError,\n    controlState,\n    hasControlStateError,\n  ]);\n  const ariaProps = getCombinedAriaProps(_ariaProps, ariaLabelingProps);\n\n  return ariaProps;\n}\n\n/**\n * @param ref - Reference to the input element\n * @param validationDeps - Values that trigger re-validation when changed (e.g., [required, min, max, pattern]).\n * @param ariaLabelingProps - ARIA labeling properties\n * @param controlId - Optional control ID for message management\n * @param emitValidationStateProp - Callback invoked with the current validation state\n * @param controlState - Legacy `controlState` override. When set, all automatic\n * dispatches into the shared `FormFieldMessages` state are skipped so\n * `controlState` fully isolates the control instead of being mixed with\n * message-driven validation.\n * @internal\n */\nexport function useFormFieldValidation(\n  ref: RefObject<FormFieldElement | null>,\n  validationDeps: Record<string, string | number | boolean | undefined> = {},\n  ariaLabelingProps: AriaLabelingProps = {},\n  controlId?: string,\n  emitValidationStateProp?: (state: ValidationState) => void,\n  // oxlint-disable-next-line typescript/no-deprecated\n  controlState?: FormControlState,\n): FormFieldValidationProps {\n  const { state, dispatch } = useFormFieldMessagesContext();\n  const intl = useIntl();\n  const errorId = useId();\n\n  const ariaProps = useFormFieldValidationAriaProps(\n    ariaLabelingProps,\n    controlState,\n  );\n\n  // Keep a ref to the current errors so `updateErrorMessages` can read the\n  // latest list without listing it as a reactive dependency.\n  // If it were a dependency, any dispatch (add/remove message) would recreate\n  // the callback, re-trigger the useEffect below, which would dispatch again \u2014\n  // causing an infinite loop.\n  const errorsRef = useRef(state.errors);\n  errorsRef.current = state.errors;\n\n  const updateErrorMessages = useCallback(() => {\n    const errorType = getErrorType(ref.current?.validity);\n    const { errors } = getI18nValidationState(intl, ref.current, 'manual');\n    const nextError = errorType\n      ? errors.find((error) => error.validityStateKey.toString() === errorType)\n      : undefined;\n\n    errorsRef.current.forEach(({ id: messageId, error }) => {\n      const key = error.validityStateKey.toString();\n      if (messageId === errorId && key !== errorType && key !== 'customError') {\n        dispatch?.({\n          type: FormFieldMessagesAction.REMOVEMESSAGE,\n          payload: {\n            id: messageId,\n            source: error.source,\n          },\n        });\n      }\n    });\n\n    if (nextError) {\n      dispatch?.({\n        type: FormFieldMessagesAction.ADDMESSAGE,\n        payload: {\n          id: errorId,\n          error: nextError,\n        },\n      });\n    }\n  }, [dispatch, errorId, intl, ref]); // state.errors intentionally excluded \u2014 read via ref above\n\n  const onInvalid = useCallback(\n    (event: SyntheticEvent<FormFieldElement>) => {\n      updateErrorMessages();\n\n      dispatch?.({\n        type: FormFieldMessagesAction.SETISTOUCHED,\n        payload: { isTouched: true },\n      });\n\n      // Prevents the browser validation pop up.\n      event.preventDefault();\n    },\n    [dispatch, updateErrorMessages],\n  );\n\n  const emitValidationState = useCustomMessageEmitter(\n    emitValidationStateProp,\n    () => getI18nValidationState(intl, ref.current, 'manual'),\n  );\n\n  // Remove once useContainerFocus is correctly implemented and used in all form controls.\n  const onBlur = useCallback(() => {\n    ref.current?.reportValidity();\n    dispatch?.({\n      type: FormFieldMessagesAction.SETISTOUCHED,\n      payload: { isTouched: true },\n    });\n    if (!state.isTouched) {\n      emitValidationState(getI18nValidationState(intl, ref.current, 'blur'));\n    }\n  }, [dispatch, emitValidationState, intl, ref, state.isTouched]);\n\n  const onChange = useCallback(() => {\n    updateErrorMessages();\n    emitValidationState(getI18nValidationState(intl, ref.current, 'change'));\n  }, [updateErrorMessages, emitValidationState, intl, ref]);\n\n  const noop = useCallback(() => undefined, []);\n\n  const preventBrowserValidation = useCallback(\n    (event: SyntheticEvent<FormFieldElement>) => {\n      event.preventDefault();\n    },\n    [],\n  );\n\n  const validationDepsKey = JSON.stringify(validationDeps);\n\n  useEffect(() => {\n    // Automatic (mount/dep-change) validation is part of the message-dispatch\n    // system this effect feeds into `onChange` \u2014 skip it entirely when\n    // `controlState` isolates the control from that system.\n    if (!controlState) {\n      onChange();\n    }\n  }, [controlState, validationDepsKey, onChange]);\n\n  // `controlState` fully isolates the control from the message-dispatch\n  // system: hand back inert handlers so DOM wiring and imperative callers\n  // can't feed events back into it, instead of checking `controlState`\n  // inside every handler above.\n  if (controlState) {\n    return {\n      ariaProps,\n      onInvalid: preventBrowserValidation,\n      onChange: noop,\n      onBlur: noop,\n      emitValidationState,\n    };\n  }\n\n  return {\n    ariaProps,\n    onInvalid,\n    onChange,\n    onBlur,\n    emitValidationState,\n  };\n}\n\n/**\n * @internal - function to combine aria-labelling and validation aria-props correctly.\n */\nexport function getCombinedAriaProps(\n  validationAriaProps: Pick<\n    AriaAttributes,\n    'aria-errormessage' | 'aria-invalid' | 'aria-describedby'\n  >,\n  labelingProps: AriaLabelingProps,\n) {\n  const {\n    'aria-describedby': validationDescription,\n    ...remainingValidationProps\n  } = validationAriaProps;\n  const { 'aria-describedby': propDescription, ...remainingLabelingProps } =\n    labelingProps;\n\n  if (validationDescription && propDescription) {\n    return {\n      ...remainingLabelingProps,\n      ...remainingValidationProps,\n      'aria-describedby': (\n        validationDescription +\n        ' ' +\n        propDescription\n      ).trim(),\n    };\n  }\n\n  return {\n    ...remainingLabelingProps,\n    ...remainingValidationProps,\n    'aria-describedby': validationDescription ?? propDescription,\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/esm/forms/forms-core/state/formfield-messages-selectors.js

@@ -0,0 +1,20 @@
+function isRuntimeManagedId(id) {
+  return id.startsWith("runtime-");
+}
+function isInternalErrorEntry(entry) {
+  return entry.error.source !== "custom" || isRuntimeManagedId(entry.id);
+}
+function getCustomMessageIds(state) {
+  if (!state) {
+    return [];
+  }
+  const customErrorIds = state.errors.filter((entry) => !isInternalErrorEntry(entry)).map((entry) => entry.id);
+  const customHintIds = state.hints.filter((hint) => hint.source === "custom").map((hint) => hint.id);
+  return [...customErrorIds, ...customHintIds];
+}
+export {
+  getCustomMessageIds,
+  isInternalErrorEntry,
+  isRuntimeManagedId
+};
+//# sourceMappingURL=formfield-messages-selectors.js.map

package/esm/forms/forms-core/state/formfield-messages-selectors.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/forms/forms-core/state/formfield-messages-selectors.ts"],
+  "sourcesContent": ["import type {\n  FormFieldMessageContextState,\n  ValidationErrorEntry,\n} from '../types/formfield-messages.types.js';\n\n/**\n * The id shape `RuntimeFieldMessageRegistration` (in `FormFieldMessages.tsx`)\n * produces for entries it aggregates from `runtime.getFieldMessages()` \u2014\n * native/Strato field-state errors, `setError()` errors, and form-validator\n * errors alike.\n * @internal\n */\nexport function isRuntimeManagedId(id: string): boolean {\n  return id.startsWith('runtime-');\n}\n\n/**\n * Whether an error entry was registered by a control/the framework rather\n * than by the consumer \u2014 used to tell it apart from a consumer `Item`'s.\n *\n * `source !== 'custom'` covers native/Strato errors dispatched directly by a\n * control (e.g. `useFormFieldValidation`'s own native-validity handling,\n * which uses its own id, not the `runtime-` prefix). The `runtime-` id check\n * separately covers `setError()`/form-validator errors aggregated by\n * `RuntimeFieldMessageRegistration` \u2014 those are `source: 'custom'` just like\n * a consumer `Item`, so `source` alone can't make the distinction for them.\n * @internal\n */\nexport function isInternalErrorEntry(entry: ValidationErrorEntry): boolean {\n  return entry.error.source !== 'custom' || isRuntimeManagedId(entry.id);\n}\n\n/**\n * Ids of all messages registered by the consumer rather than by the control\n * itself. Used by controls that clear consumer messages on `resetValidation()`.\n * @internal\n */\nexport function getCustomMessageIds(\n  state: FormFieldMessageContextState | undefined,\n): string[] {\n  if (!state) {\n    return [];\n  }\n\n  const customErrorIds = state.errors\n    .filter((entry) => !isInternalErrorEntry(entry))\n    .map((entry) => entry.id);\n  const customHintIds = state.hints\n    .filter((hint) => hint.source === 'custom')\n    .map((hint) => hint.id);\n\n  return [...customErrorIds, ...customHintIds];\n}\n"],
+  "mappings": "AAYO,SAAS,mBAAmB,IAAqB;AACtD,SAAO,GAAG,WAAW,UAAU;AACjC;AAcO,SAAS,qBAAqB,OAAsC;AACzE,SAAO,MAAM,MAAM,WAAW,YAAY,mBAAmB,MAAM,EAAE;AACvE;AAOO,SAAS,oBACd,OACU;AACV,MAAI,CAAC,OAAO;AACV,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,iBAAiB,MAAM,OAC1B,OAAO,CAAC,UAAU,CAAC,qBAAqB,KAAK,CAAC,EAC9C,IAAI,CAAC,UAAU,MAAM,EAAE;AAC1B,QAAM,gBAAgB,MAAM,MACzB,OAAO,CAAC,SAAS,KAAK,WAAW,QAAQ,EACzC,IAAI,CAAC,SAAS,KAAK,EAAE;AAExB,SAAO,CAAC,GAAG,gBAAgB,GAAG,aAAa;AAC7C;",
+  "names": []
+}