@dynatrace/strato-components 3.12.2 → 3.13.2

package/esm/forms/form/hooks/useInternalFormRegistration.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/forms/form/hooks/useInternalFormRegistration.ts"],
-  "sourcesContent": ["import { useCallback, useEffect, useRef, type RefObject } from 'react';\nimport { useIntl } from 'react-intl';\n\nimport { useFormRuntimeRegistration } from './useFormRuntimeRegistration.js';\nimport { useCallbackRef } from '../../../core/hooks/useCallbackRef.js';\nimport { useId } from '../../../core/hooks/useId.js';\nimport { useFormFieldContext } from '../../forms-core/hooks/useFormFieldContext.js';\nimport { useFormFieldMessagesContext } from '../../forms-core/hooks/useFormFieldMessagesContext.js';\nimport { getI18nValidationState } from '../../forms-core/hooks/useFormFieldValidation.js';\nimport { FormFieldMessagesAction } from '../../forms-core/state/formfield-messages-state-reducer.js';\nimport type { FormControlRef } from '../../shared-types.js';\nimport {\n  type MessageTarget,\n  normalizeMessageTarget,\n} from '../../validation/message-routing.js';\nimport type { ValidationState } from '../../validation/types.js';\nimport { useCustomMessageEmitter } from '../../validation/useCustomMessageEmitter.js';\nimport type { ValidateFieldOptions } from '../form.types.js';\n\nexport interface InternalFormRegistrationOptions<TValue = unknown> {\n  id?: string;\n  name?: string;\n  form?: string;\n  /**\n   * Where this control's native/Strato messages render, from the control's\n   * `_messageTarget` prop. Defaults to the field outlet.\n   */\n  messageTarget?: MessageTarget | MessageTarget[];\n  value?: TValue;\n  controlRef?: RefObject<FormControlRef<HTMLElement> | null>;\n  onValidityChange?: (state: ValidationState) => void;\n  getValue?: () => unknown;\n  focus?: () => void;\n  validateField?: (options: ValidateFieldOptions) => Promise<ValidationState>;\n  resetValidation?: () => void;\n}\n\n/**\n * Internal registration hook for Strato-owned controls. Strato controls compute their\n * own `ValidationState` (native + Strato + custom messages) through the\n * `FormField` message pipeline; this hook hands that pipeline's\n * `validateField` and value/focus accessors to the enclosing `<Form>` so the\n * control participates in submit, aggregation, snapshot, and focus-first-invalid\n * with no per-control runtime of its own.\n *\n * It is the counterpart to the public `useFormRegistration`: same\n * registration primitive, but fed by the Strato validity pipeline instead of a\n * consumer-supplied validator. Returns a `reportValidity` the control tees its\n * live emissions into, or a no-op when there is no enclosing form.\n * @internal\n */\nexport function useInternalFormRegistration<TValue = unknown>(\n  options: InternalFormRegistrationOptions<TValue>,\n): { id: string; onValidityChange: (state: ValidationState) => void } {\n  const {\n    id,\n    name,\n    form,\n    messageTarget,\n    value,\n    controlRef,\n    onValidityChange,\n    getValue,\n    focus,\n    validateField,\n    resetValidation,\n  } = options;\n  const intl = useIntl();\n  const generatedId = useId();\n  const formFieldContext = useFormFieldContext();\n  const { dispatch } = useFormFieldMessagesContext();\n\n  // Publish the control's routing choice into the field context so the two\n  // read-points (the `FormFieldMessages` render filter and the\n  // `useCustomMessageEmitter` emit path) resolve it without per-control logic.\n  const normalizedTarget =\n    messageTarget === undefined\n      ? undefined\n      : normalizeMessageTarget(messageTarget);\n  const messageTargetKey = normalizedTarget?.join(',') ?? '';\n  const normalizedTargetRef = useRef(normalizedTarget);\n  normalizedTargetRef.current = normalizedTarget;\n  useEffect(() => {\n    dispatch?.({\n      type: FormFieldMessagesAction.SETMESSAGETARGET,\n      payload: { messageTarget: normalizedTargetRef.current },\n    });\n  }, [dispatch, messageTargetKey]);\n  const suppressLiveValidityReportRef = useRef(false);\n  const reportValidityRef = useRef<\n    ((state: ValidationState) => void) | undefined\n  >(undefined);\n\n  // Consumers routinely pass a fresh `onValidityChange` on every render (e.g. an\n  // inline arrow). Read it through a stable ref so `handleValidityChange` \u2014 and\n  // the `useCustomMessageEmitter` re-emit effects that depend on it \u2014 keep a\n  // stable identity; otherwise every emitted state re-triggers those effects,\n  // and when the consumer's handler also sets state it becomes an infinite loop.\n  const onValidityChangeStable = useCallbackRef(onValidityChange);\n  const handleValidityChange = useCallback(\n    (state: ValidationState) => {\n      onValidityChangeStable(state);\n      if (!suppressLiveValidityReportRef.current) {\n        reportValidityRef.current?.(state);\n      }\n    },\n    [onValidityChangeStable],\n  );\n  const emitWithCustomMessages = useCustomMessageEmitter(\n    handleValidityChange,\n    () => getI18nValidationState(intl, controlRef?.current?.inputRef, 'manual'),\n  );\n\n  const defaultValidateField = ({ reveal, trigger }: ValidateFieldOptions) => {\n    controlRef?.current?.inputRef?.checkValidity();\n    if (reveal) {\n      dispatch?.({\n        type: FormFieldMessagesAction.SETISTOUCHED,\n        payload: { isTouched: true },\n      });\n    }\n    return emitWithCustomMessages(\n      getI18nValidationState(intl, controlRef?.current?.inputRef, trigger),\n    );\n  };\n\n  const resolvedId =\n    id ??\n    formFieldContext.formFieldId ??\n    // DEPRECATION: APPDEV-18319 - Remove deprecated `controlId`.\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    formFieldContext.controlId ??\n    generatedId;\n\n  const wrappedValidateField = useCallback(\n    async (validateOptions: ValidateFieldOptions) => {\n      suppressLiveValidityReportRef.current = true;\n      try {\n        return await (validateField ?? defaultValidateField)(validateOptions);\n      } finally {\n        suppressLiveValidityReportRef.current = false;\n      }\n    },\n    [defaultValidateField, validateField],\n  );\n\n  const reportValidity = useFormRuntimeRegistration({\n    id: resolvedId,\n    name,\n    form,\n    getValue: getValue ?? (() => value),\n    focus: focus ?? (() => controlRef?.current?.focus?.()),\n    validateField: wrappedValidateField,\n    resetValidation:\n      resetValidation ??\n      (() => {\n        controlRef?.current?.inputRef?.setCustomValidity('');\n        dispatch?.({\n          type: FormFieldMessagesAction.SETISTOUCHED,\n          payload: { isTouched: false, resetShowError: true },\n        });\n      }),\n  });\n\n  reportValidityRef.current = reportValidity;\n\n  return { id: resolvedId, onValidityChange: handleValidityChange };\n}\n"],
+  "sourcesContent": ["import { useCallback, useEffect, useRef, type RefObject } from 'react';\nimport { useIntl } from 'react-intl';\n\nimport { useFormRuntimeRegistration } from './useFormRuntimeRegistration.js';\nimport { useCallbackRef } from '../../../core/hooks/useCallbackRef.js';\nimport { useId } from '../../../core/hooks/useId.js';\nimport { useFormFieldContext } from '../../forms-core/hooks/useFormFieldContext.js';\nimport { useFormFieldMessagesContext } from '../../forms-core/hooks/useFormFieldMessagesContext.js';\nimport { getI18nValidationState } from '../../forms-core/hooks/useFormFieldValidation.js';\nimport { FormFieldMessagesAction } from '../../forms-core/state/formfield-messages-state-reducer.js';\nimport type { FormControlRef } from '../../shared-types.js';\nimport {\n  type MessageTarget,\n  normalizeMessageTarget,\n} from '../../validation/message-routing.js';\nimport type { ValidationState } from '../../validation/types.js';\nimport { useCustomMessageEmitter } from '../../validation/useCustomMessageEmitter.js';\nimport type { ValidateFieldOptions } from '../form.types.js';\n\nexport interface InternalFormRegistrationOptions<TValue = unknown> {\n  id?: string;\n  name?: string;\n  form?: string;\n  /**\n   * Where this control's native/Strato messages render, from the control's\n   * `_messageTarget` prop. Defaults to the field outlet.\n   */\n  messageTarget?: MessageTarget | MessageTarget[];\n  value?: TValue;\n  controlRef?: RefObject<FormControlRef<HTMLElement> | null>;\n  onValidityChange?: (state: ValidationState) => void;\n  getValue?: () => unknown;\n  focus?: () => void;\n  validateField?: (options: ValidateFieldOptions) => Promise<ValidationState>;\n  resetValidation?: () => void;\n}\n\n/**\n * Internal registration hook for Strato-owned controls. Strato controls compute their\n * own `ValidationState` (native + Strato + custom messages) through the\n * `FormField` message pipeline; this hook hands that pipeline's\n * `validateField` and value/focus accessors to the enclosing `<Form>` so the\n * control participates in submit, aggregation, snapshot, and focus-first-invalid\n * with no per-control runtime of its own.\n *\n * It is the counterpart to the public `useFormRegistration`: same\n * registration primitive, but fed by the Strato validity pipeline instead of a\n * consumer-supplied validator. Returns a `reportValidity` the control tees its\n * live emissions into, or a no-op when there is no enclosing form.\n * @internal\n */\nexport function useInternalFormRegistration<TValue = unknown>(\n  options: InternalFormRegistrationOptions<TValue>,\n): { id: string; onValidityChange: (state: ValidationState) => void } {\n  const {\n    id,\n    name,\n    form,\n    messageTarget,\n    value,\n    controlRef,\n    onValidityChange,\n    getValue,\n    focus,\n    validateField,\n    resetValidation,\n  } = options;\n  const intl = useIntl();\n  const generatedId = useId();\n  const formFieldContext = useFormFieldContext();\n  const { dispatch } = useFormFieldMessagesContext();\n\n  // Publish the control's routing choice into the field context so the two\n  // read-points (the `FormFieldMessages` render filter and the\n  // `useCustomMessageEmitter` emit path) resolve it without per-control logic.\n  const normalizedTarget =\n    messageTarget === undefined\n      ? undefined\n      : normalizeMessageTarget(messageTarget);\n  const messageTargetKey = normalizedTarget?.join(',') ?? '';\n  const normalizedTargetRef = useRef(normalizedTarget);\n  normalizedTargetRef.current = normalizedTarget;\n  useEffect(() => {\n    dispatch?.({\n      type: FormFieldMessagesAction.SETMESSAGETARGET,\n      payload: { messageTarget: normalizedTargetRef.current },\n    });\n  }, [dispatch, messageTargetKey]);\n  const suppressLiveValidityReportRef = useRef(false);\n  const reportValidityRef = useRef<\n    ((state: ValidationState) => void) | undefined\n  >(undefined);\n\n  // Consumers routinely pass a fresh `onValidityChange` on every render (e.g. an\n  // inline arrow). Read it through a stable ref so `handleValidityChange` \u2014 and\n  // the `useCustomMessageEmitter` re-emit effects that depend on it \u2014 keep a\n  // stable identity; otherwise every emitted state re-triggers those effects,\n  // and when the consumer's handler also sets state it becomes an infinite loop.\n  const onValidityChangeStable = useCallbackRef(onValidityChange);\n  const handleValidityChange = useCallback(\n    (state: ValidationState) => {\n      onValidityChangeStable(state);\n      if (!suppressLiveValidityReportRef.current) {\n        reportValidityRef.current?.(state);\n      }\n    },\n    [onValidityChangeStable],\n  );\n  const emitWithCustomMessages = useCustomMessageEmitter(\n    handleValidityChange,\n    () => getI18nValidationState(intl, controlRef?.current?.inputRef, 'manual'),\n  );\n\n  const defaultValidateField = ({ reveal, trigger }: ValidateFieldOptions) => {\n    controlRef?.current?.inputRef?.checkValidity();\n    if (reveal) {\n      dispatch?.({\n        type: FormFieldMessagesAction.SETISTOUCHED,\n        payload: { isTouched: true },\n      });\n    }\n    return emitWithCustomMessages(\n      getI18nValidationState(intl, controlRef?.current?.inputRef, trigger),\n    );\n  };\n\n  const resolvedId =\n    id ??\n    formFieldContext.formFieldId ??\n    // DEPRECATION: APPDEV-18319 - Remove deprecated `controlId`.\n    // oxlint-disable-next-line typescript/no-deprecated\n    formFieldContext.controlId ??\n    generatedId;\n\n  const wrappedValidateField = useCallback(\n    async (validateOptions: ValidateFieldOptions) => {\n      suppressLiveValidityReportRef.current = true;\n      try {\n        return await (validateField ?? defaultValidateField)(validateOptions);\n      } finally {\n        suppressLiveValidityReportRef.current = false;\n      }\n    },\n    [defaultValidateField, validateField],\n  );\n\n  const reportValidity = useFormRuntimeRegistration({\n    id: resolvedId,\n    name,\n    form,\n    getValue: getValue ?? (() => value),\n    focus: focus ?? (() => controlRef?.current?.focus?.()),\n    validateField: wrappedValidateField,\n    resetValidation:\n      resetValidation ??\n      (() => {\n        controlRef?.current?.inputRef?.setCustomValidity('');\n        dispatch?.({\n          type: FormFieldMessagesAction.SETISTOUCHED,\n          payload: { isTouched: false, resetShowError: true },\n        });\n      }),\n  });\n\n  reportValidityRef.current = reportValidity;\n\n  return { id: resolvedId, onValidityChange: handleValidityChange };\n}\n"],
   "mappings": "AAAA,SAAS,aAAa,WAAW,cAA8B;AAC/D,SAAS,eAAe;AAExB,SAAS,kCAAkC;AAC3C,SAAS,sBAAsB;AAC/B,SAAS,aAAa;AACtB,SAAS,2BAA2B;AACpC,SAAS,mCAAmC;AAC5C,SAAS,8BAA8B;AACvC,SAAS,+BAA+B;AAExC;AAAA,EAEE;AAAA,OACK;AAEP,SAAS,+BAA+B;AAmCjC,SAAS,4BACd,SACoE;AACpE,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AACJ,QAAM,OAAO,QAAQ;AACrB,QAAM,cAAc,MAAM;AAC1B,QAAM,mBAAmB,oBAAoB;AAC7C,QAAM,EAAE,SAAS,IAAI,4BAA4B;AAKjD,QAAM,mBACJ,kBAAkB,SACd,SACA,uBAAuB,aAAa;AAC1C,QAAM,mBAAmB,kBAAkB,KAAK,GAAG,KAAK;AACxD,QAAM,sBAAsB,OAAO,gBAAgB;AACnD,sBAAoB,UAAU;AAC9B,YAAU,MAAM;AACd,eAAW;AAAA,MACT,MAAM,wBAAwB;AAAA,MAC9B,SAAS,EAAE,eAAe,oBAAoB,QAAQ;AAAA,IACxD,CAAC;AAAA,EACH,GAAG,CAAC,UAAU,gBAAgB,CAAC;AAC/B,QAAM,gCAAgC,OAAO,KAAK;AAClD,QAAM,oBAAoB,OAExB,MAAS;AAOX,QAAM,yBAAyB,eAAe,gBAAgB;AAC9D,QAAM,uBAAuB;AAAA,IAC3B,CAAC,UAA2B;AAC1B,6BAAuB,KAAK;AAC5B,UAAI,CAAC,8BAA8B,SAAS;AAC1C,0BAAkB,UAAU,KAAK;AAAA,MACnC;AAAA,IACF;AAAA,IACA,CAAC,sBAAsB;AAAA,EACzB;AACA,QAAM,yBAAyB;AAAA,IAC7B;AAAA,IACA,MAAM,uBAAuB,MAAM,YAAY,SAAS,UAAU,QAAQ;AAAA,EAC5E;AAEA,QAAM,uBAAuB,CAAC,EAAE,QAAQ,QAAQ,MAA4B;AAC1E,gBAAY,SAAS,UAAU,cAAc;AAC7C,QAAI,QAAQ;AACV,iBAAW;AAAA,QACT,MAAM,wBAAwB;AAAA,QAC9B,SAAS,EAAE,WAAW,KAAK;AAAA,MAC7B,CAAC;AAAA,IACH;AACA,WAAO;AAAA,MACL,uBAAuB,MAAM,YAAY,SAAS,UAAU,OAAO;AAAA,IACrE;AAAA,EACF;AAEA,QAAM,aACJ,MACA,iBAAiB;AAAA;AAAA,EAGjB,iBAAiB,aACjB;AAEF,QAAM,uBAAuB;AAAA,IAC3B,OAAO,oBAA0C;AAC/C,oCAA8B,UAAU;AACxC,UAAI;AACF,eAAO,OAAO,iBAAiB,sBAAsB,eAAe;AAAA,MACtE,UAAE;AACA,sCAA8B,UAAU;AAAA,MAC1C;AAAA,IACF;AAAA,IACA,CAAC,sBAAsB,aAAa;AAAA,EACtC;AAEA,QAAM,iBAAiB,2BAA2B;AAAA,IAChD,IAAI;AAAA,IACJ;AAAA,IACA;AAAA,IACA,UAAU,aAAa,MAAM;AAAA,IAC7B,OAAO,UAAU,MAAM,YAAY,SAAS,QAAQ;AAAA,IACpD,eAAe;AAAA,IACf,iBACE,oBACC,MAAM;AACL,kBAAY,SAAS,UAAU,kBAAkB,EAAE;AACnD,iBAAW;AAAA,QACT,MAAM,wBAAwB;AAAA,QAC9B,SAAS,EAAE,WAAW,OAAO,gBAAgB,KAAK;AAAA,MACpD,CAAC;AAAA,IACH;AAAA,EACJ,CAAC;AAED,oBAAkB,UAAU;AAE5B,SAAO,EAAE,IAAI,YAAY,kBAAkB,qBAAqB;AAClE;",
   "names": []
 }

package/esm/forms/form/runtime/createFormRuntime.js

@@ -26,6 +26,7 @@ const SOURCE_PRIORITY = {
   strato: 1,
   native: 2
 };
+const NO_ERRORS = [];
 function createFormRuntime(getConfig) {
   const config = { validators: [] };
   const controls = /* @__PURE__ */ new Map();
@@ -33,8 +34,8 @@ function createFormRuntime(getConfig) {
   let manualErrors = [];
   let formValidatorErrors = [];
   let isSubmitted = false;
-  let activeValidationRuns = 0;
   let validationRunId = 0;
+  const unsettledRunIds = /* @__PURE__ */ new Set();
   let readConfig = getConfig ?? (() => config);
   const listeners = /* @__PURE__ */ new Set();
   const warnedDuplicateNames = /* @__PURE__ */ new Set();
@@ -51,7 +52,7 @@ function createFormRuntime(getConfig) {
     return [...fieldStates.values()].some(stateIsPending);
   }
   function isPending() {
-    return activeValidationRuns > 0 || hasPendingFields();
+    return unsettledRunIds.has(validationRunId) || hasPendingFields();
   }
   function aggregateErrors() {
     const seen = /* @__PURE__ */ new Set();
@@ -127,7 +128,7 @@ function createFormRuntime(getConfig) {
   async function runValidation(trigger, reveal) {
     const runId = ++validationRunId;
     const runControls = [...controls.values()];
-    activeValidationRuns += 1;
+    unsettledRunIds.add(runId);
     emitValidityChange(trigger);
     notify();
     try {
@@ -156,7 +157,7 @@ function createFormRuntime(getConfig) {
         );
       }
     } finally {
-      activeValidationRuns -= 1;
+      unsettledRunIds.delete(runId);
       emitValidityChange(trigger);
       notify();
     }
@@ -168,7 +169,11 @@ function createFormRuntime(getConfig) {
     validate: () => runValidation("manual", true),
     submit: async () => {
       isSubmitted = true;
+      const submitRunId = validationRunId + 1;
       const status = await runValidation("submit", true);
+      if (validationRunId !== submitRunId) {
+        return buildStatus();
+      }
       if (!status.isValid) {
         focusFirstInvalid(controls, status.errors);
         readConfig().onInvalid?.({
@@ -184,7 +189,7 @@ function createFormRuntime(getConfig) {
     },
     resetValidation: () => {
       validationRunId += 1;
-      activeValidationRuns = 0;
+      unsettledRunIds.clear();
       manualErrors = [];
       formValidatorErrors = [];
       isSubmitted = false;
@@ -247,6 +252,9 @@ function createFormRuntime(getConfig) {
     // signature actually changed — a fresh array on every read forces a re-render and
     // can loop.
     getFormMessages: () => {
+      if (isPending()) {
+        return NO_ERRORS;
+      }
       const current = aggregateErrors().filter(
         (error) => error instanceof FormValidationError || routesTo(error, "form")
       );
@@ -258,6 +266,9 @@ function createFormRuntime(getConfig) {
       return formMessagesCache;
     },
     getFieldMessages: (controlId) => {
+      if (isPending()) {
+        return NO_ERRORS;
+      }
       const current = errorsForField(controlId);
       const signature = errorSetSignature(current);
       const cached = fieldMessagesCache.get(controlId);
@@ -307,7 +318,7 @@ function cloneWithCustomSource(error) {
   });
 }
 function matchesTarget(error, target, validityStateKey) {
-  const routedTo = error instanceof FormValidationError ? error.formId === target : Array.isArray(error.formControlId) ? error.formControlId.includes(target) : error.formControlId === target;
+  const routedTo = error instanceof FormValidationError && error.formId === target || (Array.isArray(error.formControlId) ? error.formControlId.includes(target) : error.formControlId === target);
   if (!routedTo) {
     return false;
   }
@@ -319,6 +330,9 @@ function focusFirstInvalid(controls, errors) {
       (error) => error.formControlId === void 0 ? [] : Array.isArray(error.formControlId) ? error.formControlId : [error.formControlId]
     )
   );
+  if (invalidIds.size === 0) {
+    return;
+  }
   for (const { control } of controls.values()) {
     if (invalidIds.has(control.id)) {
       control.focus();

package/esm/forms/form/runtime/createFormRuntime.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/forms/form/runtime/createFormRuntime.ts"],
-  "sourcesContent": ["import { getStratoLogger } from '../../../core/sdk/sdk-logger.js';\nimport { routesTo } from '../../validation/message-routing.js';\nimport {\n  ValidationError,\n  type ValidationErrorSource,\n  type ValidationState,\n  type ValidationTrigger,\n  type ValidityStateKey,\n} from '../../validation/types.js';\nimport { FormValidationError } from '../form-error-classes.js';\nimport type {\n  ControlRegistrationHandle,\n  FormApi,\n  FormSnapshot,\n  FormStatus,\n  FormValidator,\n  RegisteredControl,\n} from '../form.types.js';\n\n/**\n * Mutable config the `<Form>` component feeds into the runtime on every render.\n * @internal\n */\nexport interface FormRuntimeConfig<TValues = Record<string, unknown>> {\n  formId?: string;\n  validators: FormValidator<TValues>[];\n  onSubmit?: (context: {\n    snapshot: FormSnapshot<TValues>;\n    form: FormApi<TValues>;\n  }) => void;\n  onInvalid?: (context: {\n    snapshot: FormSnapshot<TValues>;\n    status: FormStatus;\n    form: FormApi<TValues>;\n  }) => void;\n  onValidityChange?: (state: ValidationState) => void;\n}\n\n/**\n * The full runtime surface: the public {@link FormApi} plus the internal hooks\n * the `<Form>` component and registered controls use.\n * @internal\n */\nexport interface FormRuntime<TValues = Record<string, unknown>>\n  extends FormApi<TValues> {\n  /** Registers a control and returns its imperative handle. */\n  register: (control: RegisteredControl) => ControlRegistrationHandle;\n  /** Subscribes to any runtime change (for `useSyncExternalStore`). */\n  subscribe: (listener: () => void) => () => void;\n  /** The form-wide errors currently rendered by `<FormMessages>`. */\n  getFormMessages: () => ValidationError[];\n  /** Runtime-owned field errors rendered by `FormFieldMessages`. */\n  getFieldMessages: (controlId: string) => ValidationError[];\n  /**\n   * Replaces the config getter that the runtime calls on each submit/validate.\n   * Called by `<Form>` when an external runtime is supplied via the `form` prop.\n   * Pass `undefined` to revert to the no-op default (e.g. on unmount).\n   * @internal\n   */\n  _bindConfig?: (fn: (() => FormRuntimeConfig<TValues>) | undefined) => void;\n}\n\ntype RegisteredEntry = {\n  control: RegisteredControl;\n  token: symbol;\n};\n\n// Ordinal comparator for building canonical, environment-independent dedup and\n// signature keys. `localeCompare` is locale/ICU-dependent, so it could order\n// non-ASCII ids differently across machines \u2014 these keys must be deterministic.\nfunction compareOrdinal(a: string, b: string): number {\n  return a < b ? -1 : a > b ? 1 : 0;\n}\n\nfunction errorIdentity(error: ValidationError): string {\n  const target = Array.isArray(error.formControlId)\n    ? [...error.formControlId].sort(compareOrdinal).join(',')\n    : error.formControlId ?? '';\n  const formId = error instanceof FormValidationError ? error.formId : '';\n  return `${error.validityStateKey.toString()}|${target}|${formId}`;\n}\n\nfunction errorSignature(error: ValidationError): string {\n  return `${errorIdentity(error)}|${error.message}`;\n}\n\nfunction errorSetSignature(errors: ValidationError[]): string {\n  return errors.map(errorSignature).sort(compareOrdinal).join('\\u0000');\n}\n\nfunction stateIsPending(state: ValidationState): boolean {\n  return state.status === 'pending';\n}\n\nconst SOURCE_PRIORITY: Record<ValidationErrorSource, number> = {\n  custom: 0,\n  strato: 1,\n  native: 2,\n};\n\nexport function createFormRuntime<TValues = Record<string, unknown>>(\n  getConfig?: () => FormRuntimeConfig<TValues>,\n): FormRuntime<TValues> {\n  const config: FormRuntimeConfig<TValues> = { validators: [] };\n  const controls = new Map<string, RegisteredEntry>();\n  const fieldStates = new Map<string, ValidationState>();\n  let manualErrors: ValidationError[] = [];\n  let formValidatorErrors: ValidationError[] = [];\n  let isSubmitted = false;\n  let activeValidationRuns = 0;\n  let validationRunId = 0;\n\n  let readConfig = getConfig ?? (() => config);\n  const listeners = new Set<() => void>();\n  const warnedDuplicateNames = new Set<string>();\n\n  let formMessagesCache: ValidationError[] = [];\n  let formMessagesSignature = '';\n  const fieldMessagesCache = new Map<\n    string,\n    { signature: string; messages: ValidationError[] }\n  >();\n  let lastValiditySignature: string | undefined;\n\n  function notify() {\n    for (const listener of listeners) {\n      listener();\n    }\n  }\n\n  function hasPendingFields(): boolean {\n    return [...fieldStates.values()].some(stateIsPending);\n  }\n\n  function isPending(): boolean {\n    return activeValidationRuns > 0 || hasPendingFields();\n  }\n\n  function aggregateErrors(): ValidationError[] {\n    const seen = new Set<string>();\n    const result: ValidationError[] = [];\n    const push = (error: ValidationError) => {\n      const signature = errorSignature(error);\n      if (!seen.has(signature)) {\n        seen.add(signature);\n        result.push(error);\n      }\n    };\n    for (const state of fieldStates.values()) {\n      state.errors.forEach(push);\n    }\n    formValidatorErrors.forEach(push);\n    manualErrors.forEach(push);\n    return result;\n  }\n\n  function errorsForField(controlId: string): ValidationError[] {\n    const matched = aggregateErrors().filter(\n      (error) => matchesTarget(error, controlId) && routesTo(error, 'field'),\n    );\n    // So a consumer that renders only errors[0] gets a deterministic result.\n    // Sort is stable, so two errors of the same source keep their relative order.\n    return [...matched].sort(\n      (a, b) => SOURCE_PRIORITY[a.source] - SOURCE_PRIORITY[b.source],\n    );\n  }\n\n  function buildStatus(): FormStatus {\n    const errors = aggregateErrors();\n    return {\n      isValid: errors.length === 0,\n      isPending: isPending(),\n      isSubmitted,\n      errors,\n    };\n  }\n\n  function buildSnapshot(): FormSnapshot<TValues> {\n    const values: Record<string, unknown> = {};\n    const fields: FormSnapshot['fields'] = {};\n    for (const { control } of controls.values()) {\n      const key = control.name ?? control.id;\n      if (Object.hasOwn(values, key) && !warnedDuplicateNames.has(key)) {\n        warnedDuplicateNames.add(key);\n        getStratoLogger('Form').warn(\n          `Multiple form controls share the name \"${key}\"; only the last value is kept in the form snapshot.`,\n        );\n      }\n      values[key] = control.getValue();\n      const fieldErrors = errorsForField(control.id);\n      fields[control.id] = {\n        isValid: fieldErrors.length === 0,\n        isTouched: fieldStates.has(control.id),\n        errors: fieldErrors,\n      };\n    }\n    return {\n      values: values as TValues,\n      fields,\n    };\n  }\n\n  function emitValidityChange(trigger: ValidationTrigger) {\n    const errors = aggregateErrors();\n    const signature = `${errors.length === 0 ? 'valid' : 'invalid'}|${\n      isPending() ? 'pending' : 'done'\n    }|${errorSetSignature(errors)}`;\n    // The runtime notifies liberally \u2014 it emits on the way into and out of every\n    // validation run and on every mutation. Collapse to a signature so\n    // `onValidityChange` fires only on real transitions, not identical recomputations.\n    if (signature === lastValiditySignature) {\n      return;\n    }\n    lastValiditySignature = signature;\n    readConfig().onValidityChange?.({\n      status: isPending() ? 'pending' : 'done',\n      trigger,\n      errors,\n    });\n  }\n\n  async function runValidation(\n    trigger: ValidationTrigger,\n    reveal: boolean,\n  ): Promise<FormStatus> {\n    const runId = ++validationRunId;\n    const runControls = [...controls.values()];\n    activeValidationRuns += 1;\n    emitValidityChange(trigger);\n    notify();\n\n    try {\n      const results = await Promise.all(\n        runControls.map(async ({ control, token }) => {\n          const state = await control.validateField({ reveal, trigger });\n          return { id: control.id, token, state };\n        }),\n      );\n\n      if (runId === validationRunId) {\n        for (const { id, token, state } of results) {\n          if (controls.get(id)?.token === token) {\n            fieldStates.set(id, state);\n          }\n        }\n      }\n\n      const snapshot = buildSnapshot();\n      const validatorResults = await Promise.all(\n        readConfig().validators.map((validator) =>\n          runFormValidator(validator, snapshot.values, readConfig().formId),\n        ),\n      );\n\n      if (runId === validationRunId) {\n        formValidatorErrors = validatorResults\n          .flat()\n          .map((error) =>\n            error.source === 'custom' ? error : cloneWithCustomSource(error),\n          );\n      }\n    } finally {\n      activeValidationRuns -= 1;\n      emitValidityChange(trigger);\n      notify();\n    }\n\n    return buildStatus();\n  }\n\n  const api: FormRuntime<TValues> = {\n    getStatus: buildStatus,\n    getSnapshot: buildSnapshot,\n\n    validate: () => runValidation('manual', true),\n\n    submit: async () => {\n      isSubmitted = true;\n      // Consumer-set errors (`setError`) persist across submits; only the\n      // consumer clears them via `clearError` / `resetValidation`. This keeps a\n      // server-side error visible on retry until the consumer removes it.\n      const status = await runValidation('submit', true);\n\n      if (!status.isValid) {\n        focusFirstInvalid(controls, status.errors);\n        readConfig().onInvalid?.({\n          snapshot: buildSnapshot(),\n          status,\n          form: api,\n        });\n      } else {\n        readConfig().onSubmit?.({ snapshot: buildSnapshot(), form: api });\n      }\n      notify();\n      return buildStatus();\n    },\n\n    resetValidation: () => {\n      validationRunId += 1;\n      activeValidationRuns = 0;\n      manualErrors = [];\n      formValidatorErrors = [];\n      isSubmitted = false;\n      fieldStates.clear();\n      for (const { control } of controls.values()) {\n        control.resetValidation?.();\n      }\n      lastValiditySignature = undefined;\n      emitValidityChange('manual');\n      notify();\n    },\n\n    setError: (error) => {\n      const identity = errorIdentity(error);\n      manualErrors = [\n        ...manualErrors.filter(\n          (existing) => errorIdentity(existing) !== identity,\n        ),\n        error,\n      ];\n      emitValidityChange('manual');\n      notify();\n    },\n\n    clearError: (target, validityStateKey) => {\n      manualErrors = manualErrors.filter(\n        (error) => !matchesTarget(error, target, validityStateKey),\n      );\n      emitValidityChange('manual');\n      notify();\n    },\n\n    register: (control) => {\n      // Per-registration token. A control id can be re-registered (remount, or a\n      // duplicate id). Every handle captures its token and no-ops if the live entry's\n      // token differs, so a stale handle's async report/unregister can't clobber the\n      // current registration.\n      const token = Symbol(control.id);\n      controls.set(control.id, { control, token });\n      notify();\n      return {\n        reportValidity: (state) => {\n          if (controls.get(control.id)?.token !== token) {\n            return;\n          }\n          fieldStates.set(control.id, state);\n          emitValidityChange(state.trigger);\n          notify();\n        },\n        unregister: () => {\n          if (controls.get(control.id)?.token !== token) {\n            return;\n          }\n          controls.delete(control.id);\n          fieldStates.delete(control.id);\n          emitValidityChange('manual');\n          notify();\n        },\n      };\n    },\n\n    subscribe: (listener) => {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n\n    // `FormMessages`/`FormFieldMessages` read these via `useSyncExternalStore`, which\n    // compares snapshots by reference. Return the cached array unless the error set's\n    // signature actually changed \u2014 a fresh array on every read forces a re-render and\n    // can loop.\n    getFormMessages: () => {\n      // Form-wide errors: the routing subclass, plus any control's native/Strato\n      // error explicitly routed to the form outlet via `_messageTarget`.\n      const current = aggregateErrors().filter(\n        (error) =>\n          error instanceof FormValidationError || routesTo(error, 'form'),\n      );\n      const signature = errorSetSignature(current);\n      if (signature !== formMessagesSignature) {\n        formMessagesSignature = signature;\n        formMessagesCache = current;\n      }\n      return formMessagesCache;\n    },\n\n    getFieldMessages: (controlId) => {\n      const current = errorsForField(controlId);\n      const signature = errorSetSignature(current);\n      const cached = fieldMessagesCache.get(controlId);\n      if (cached?.signature === signature) {\n        return cached.messages;\n      }\n      fieldMessagesCache.set(controlId, { signature, messages: current });\n      return current;\n    },\n\n    _bindConfig: (fn) => {\n      readConfig = fn ?? (() => config);\n    },\n  };\n\n  return api;\n}\n\nasync function runFormValidator<TValues>(\n  validator: FormValidator<TValues>,\n  values: TValues,\n  formId: string | undefined,\n): Promise<ValidationError[]> {\n  try {\n    return await validator({ values });\n  } catch (cause) {\n    if (formId !== undefined) {\n      return [\n        new FormValidationError('Validation failed.', {\n          formId,\n          cause,\n        }),\n      ];\n    }\n    return [\n      new ValidationError('Validation failed.', { source: 'custom', cause }),\n    ];\n  }\n}\n\nfunction cloneWithCustomSource(error: ValidationError): ValidationError {\n  if (error instanceof FormValidationError) {\n    return new FormValidationError(error.message, {\n      formId: error.formId,\n      validityStateKey: error.validityStateKey,\n      formControlId: error.formControlId,\n      cause: error.cause,\n    });\n  }\n  return new ValidationError(error.message, {\n    source: 'custom',\n    validityStateKey: error.validityStateKey,\n    formControlId: error.formControlId,\n    cause: error.cause,\n  });\n}\n\nfunction matchesTarget(\n  error: ValidationError,\n  target: string,\n  validityStateKey?: ValidityStateKey,\n): boolean {\n  const routedTo =\n    error instanceof FormValidationError\n      ? error.formId === target\n      : Array.isArray(error.formControlId)\n      ? error.formControlId.includes(target)\n      : error.formControlId === target;\n  if (!routedTo) {\n    return false;\n  }\n  return (\n    validityStateKey === undefined ||\n    error.validityStateKey.equals(validityStateKey)\n  );\n}\n\nfunction focusFirstInvalid(\n  controls: Map<string, RegisteredEntry>,\n  errors: ValidationError[],\n) {\n  const invalidIds = new Set(\n    errors.flatMap((error) =>\n      error.formControlId === undefined\n        ? []\n        : Array.isArray(error.formControlId)\n        ? error.formControlId\n        : [error.formControlId],\n    ),\n  );\n  for (const { control } of controls.values()) {\n    if (invalidIds.has(control.id)) {\n      control.focus();\n      return;\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { getStratoLogger } from '../../../core/sdk/sdk-logger.js';\nimport { routesTo } from '../../validation/message-routing.js';\nimport {\n  ValidationError,\n  type ValidationErrorSource,\n  type ValidationState,\n  type ValidationTrigger,\n  type ValidityStateKey,\n} from '../../validation/types.js';\nimport { FormValidationError } from '../form-error-classes.js';\nimport type {\n  ControlRegistrationHandle,\n  FormApi,\n  FormSnapshot,\n  FormStatus,\n  FormValidator,\n  RegisteredControl,\n} from '../form.types.js';\n\n/**\n * Mutable config the `<Form>` component feeds into the runtime on every render.\n * @internal\n */\nexport interface FormRuntimeConfig<TValues = Record<string, unknown>> {\n  formId?: string;\n  validators: FormValidator<TValues>[];\n  onSubmit?: (context: {\n    snapshot: FormSnapshot<TValues>;\n    form: FormApi<TValues>;\n  }) => void;\n  onInvalid?: (context: {\n    snapshot: FormSnapshot<TValues>;\n    status: FormStatus;\n    form: FormApi<TValues>;\n  }) => void;\n  onValidityChange?: (state: ValidationState) => void;\n}\n\n/**\n * The full runtime surface: the public {@link FormApi} plus the internal hooks\n * the `<Form>` component and registered controls use.\n * @internal\n */\nexport interface FormRuntime<\n  TValues = Record<string, unknown>,\n> extends FormApi<TValues> {\n  /** Registers a control and returns its imperative handle. */\n  register: (control: RegisteredControl) => ControlRegistrationHandle;\n  /** Subscribes to any runtime change (for `useSyncExternalStore`). */\n  subscribe: (listener: () => void) => () => void;\n  /** The form-wide errors currently rendered by `<FormMessages>`. */\n  getFormMessages: () => ValidationError[];\n  /** Runtime-owned field errors rendered by `FormFieldMessages`. */\n  getFieldMessages: (controlId: string) => ValidationError[];\n  /**\n   * Replaces the config getter that the runtime calls on each submit/validate.\n   * Called by `<Form>` when an external runtime is supplied via the `form` prop.\n   * Pass `undefined` to revert to the no-op default (e.g. on unmount).\n   * @internal\n   */\n  _bindConfig?: (fn: (() => FormRuntimeConfig<TValues>) | undefined) => void;\n}\n\ntype RegisteredEntry = {\n  control: RegisteredControl;\n  token: symbol;\n};\n\n// Ordinal comparator for building canonical, environment-independent dedup and\n// signature keys. `localeCompare` is locale/ICU-dependent, so it could order\n// non-ASCII ids differently across machines \u2014 these keys must be deterministic.\nfunction compareOrdinal(a: string, b: string): number {\n  return a < b ? -1 : a > b ? 1 : 0;\n}\n\nfunction errorIdentity(error: ValidationError): string {\n  const target = Array.isArray(error.formControlId)\n    ? [...error.formControlId].sort(compareOrdinal).join(',')\n    : (error.formControlId ?? '');\n  const formId = error instanceof FormValidationError ? error.formId : '';\n  return `${error.validityStateKey.toString()}|${target}|${formId}`;\n}\n\nfunction errorSignature(error: ValidationError): string {\n  return `${errorIdentity(error)}|${error.message}`;\n}\n\nfunction errorSetSignature(errors: ValidationError[]): string {\n  return errors.map(errorSignature).sort(compareOrdinal).join('\\u0000');\n}\n\nfunction stateIsPending(state: ValidationState): boolean {\n  return state.status === 'pending';\n}\n\nconst SOURCE_PRIORITY: Record<ValidationErrorSource, number> = {\n  custom: 0,\n  strato: 1,\n  native: 2,\n};\n\nconst NO_ERRORS: ValidationError[] = [];\n\nexport function createFormRuntime<TValues = Record<string, unknown>>(\n  getConfig?: () => FormRuntimeConfig<TValues>,\n): FormRuntime<TValues> {\n  const config: FormRuntimeConfig<TValues> = { validators: [] };\n  const controls = new Map<string, RegisteredEntry>();\n  const fieldStates = new Map<string, ValidationState>();\n  let manualErrors: ValidationError[] = [];\n  let formValidatorErrors: ValidationError[] = [];\n  let isSubmitted = false;\n  let validationRunId = 0;\n  // Run ids currently awaiting their controls/validators. A stale run stays\n  // in here until it settles, but `isPending` only consults the latest run \u2014 see\n  // there for why.\n  const unsettledRunIds = new Set<number>();\n\n  let readConfig = getConfig ?? (() => config);\n  const listeners = new Set<() => void>();\n  const warnedDuplicateNames = new Set<string>();\n\n  let formMessagesCache: ValidationError[] = [];\n  let formMessagesSignature = '';\n  const fieldMessagesCache = new Map<\n    string,\n    { signature: string; messages: ValidationError[] }\n  >();\n  let lastValiditySignature: string | undefined;\n\n  function notify() {\n    for (const listener of listeners) {\n      listener();\n    }\n  }\n\n  function hasPendingFields(): boolean {\n    return [...fieldStates.values()].some(stateIsPending);\n  }\n\n  function isPending(): boolean {\n    // Ignore stale runs still settling in the background \u2014 only the latest\n    // run's pending state should hold the form pending.\n    return unsettledRunIds.has(validationRunId) || hasPendingFields();\n  }\n\n  function aggregateErrors(): ValidationError[] {\n    const seen = new Set<string>();\n    const result: ValidationError[] = [];\n    const push = (error: ValidationError) => {\n      const signature = errorSignature(error);\n      if (!seen.has(signature)) {\n        seen.add(signature);\n        result.push(error);\n      }\n    };\n    for (const state of fieldStates.values()) {\n      state.errors.forEach(push);\n    }\n    formValidatorErrors.forEach(push);\n    manualErrors.forEach(push);\n    return result;\n  }\n\n  function errorsForField(controlId: string): ValidationError[] {\n    const matched = aggregateErrors().filter(\n      (error) => matchesTarget(error, controlId) && routesTo(error, 'field'),\n    );\n    // So a consumer that renders only errors[0] gets a deterministic result.\n    // Sort is stable, so two errors of the same source keep their relative order.\n    return [...matched].sort(\n      (a, b) => SOURCE_PRIORITY[a.source] - SOURCE_PRIORITY[b.source],\n    );\n  }\n\n  function buildStatus(): FormStatus {\n    const errors = aggregateErrors();\n    return {\n      isValid: errors.length === 0,\n      isPending: isPending(),\n      isSubmitted,\n      errors,\n    };\n  }\n\n  function buildSnapshot(): FormSnapshot<TValues> {\n    const values: Record<string, unknown> = {};\n    const fields: FormSnapshot['fields'] = {};\n    for (const { control } of controls.values()) {\n      const key = control.name ?? control.id;\n      if (Object.hasOwn(values, key) && !warnedDuplicateNames.has(key)) {\n        warnedDuplicateNames.add(key);\n        getStratoLogger('Form').warn(\n          `Multiple form controls share the name \"${key}\"; only the last value is kept in the form snapshot.`,\n        );\n      }\n      values[key] = control.getValue();\n      const fieldErrors = errorsForField(control.id);\n      fields[control.id] = {\n        isValid: fieldErrors.length === 0,\n        isTouched: fieldStates.has(control.id),\n        errors: fieldErrors,\n      };\n    }\n    return {\n      values: values as TValues,\n      fields,\n    };\n  }\n\n  function emitValidityChange(trigger: ValidationTrigger) {\n    const errors = aggregateErrors();\n    const signature = `${errors.length === 0 ? 'valid' : 'invalid'}|${\n      isPending() ? 'pending' : 'done'\n    }|${errorSetSignature(errors)}`;\n    // The runtime notifies liberally \u2014 it emits on the way into and out of every\n    // validation run and on every mutation. Collapse to a signature so\n    // `onValidityChange` fires only on real transitions, not identical recomputations.\n    if (signature === lastValiditySignature) {\n      return;\n    }\n    lastValiditySignature = signature;\n    readConfig().onValidityChange?.({\n      status: isPending() ? 'pending' : 'done',\n      trigger,\n      errors,\n    });\n  }\n\n  async function runValidation(\n    trigger: ValidationTrigger,\n    reveal: boolean,\n  ): Promise<FormStatus> {\n    const runId = ++validationRunId;\n    const runControls = [...controls.values()];\n    unsettledRunIds.add(runId);\n    emitValidityChange(trigger);\n    notify();\n\n    try {\n      const results = await Promise.all(\n        runControls.map(async ({ control, token }) => {\n          const state = await control.validateField({ reveal, trigger });\n          return { id: control.id, token, state };\n        }),\n      );\n\n      if (runId === validationRunId) {\n        for (const { id, token, state } of results) {\n          if (controls.get(id)?.token === token) {\n            fieldStates.set(id, state);\n          }\n        }\n      }\n\n      const snapshot = buildSnapshot();\n      const validatorResults = await Promise.all(\n        readConfig().validators.map((validator) =>\n          runFormValidator(validator, snapshot.values, readConfig().formId),\n        ),\n      );\n\n      if (runId === validationRunId) {\n        formValidatorErrors = validatorResults\n          .flat()\n          .map((error) =>\n            error.source === 'custom' ? error : cloneWithCustomSource(error),\n          );\n      }\n    } finally {\n      unsettledRunIds.delete(runId);\n      emitValidityChange(trigger);\n      notify();\n    }\n\n    return buildStatus();\n  }\n\n  const api: FormRuntime<TValues> = {\n    getStatus: buildStatus,\n    getSnapshot: buildSnapshot,\n\n    validate: () => runValidation('manual', true),\n\n    submit: async () => {\n      isSubmitted = true;\n      // Consumer-set errors (`setError`) persist across submits; only the\n      // consumer clears them via `clearError` / `resetValidation`. This keeps a\n      // server-side error visible on retry until the consumer removes it.\n      const submitRunId = validationRunId + 1;\n      const status = await runValidation('submit', true);\n\n      if (validationRunId !== submitRunId) {\n        return buildStatus();\n      }\n\n      if (!status.isValid) {\n        focusFirstInvalid(controls, status.errors);\n        readConfig().onInvalid?.({\n          snapshot: buildSnapshot(),\n          status,\n          form: api,\n        });\n      } else {\n        readConfig().onSubmit?.({ snapshot: buildSnapshot(), form: api });\n      }\n      notify();\n      return buildStatus();\n    },\n\n    resetValidation: () => {\n      validationRunId += 1;\n      unsettledRunIds.clear();\n      manualErrors = [];\n      formValidatorErrors = [];\n      isSubmitted = false;\n      fieldStates.clear();\n      for (const { control } of controls.values()) {\n        control.resetValidation?.();\n      }\n      lastValiditySignature = undefined;\n      emitValidityChange('manual');\n      notify();\n    },\n\n    setError: (error) => {\n      const identity = errorIdentity(error);\n      manualErrors = [\n        ...manualErrors.filter(\n          (existing) => errorIdentity(existing) !== identity,\n        ),\n        error,\n      ];\n      emitValidityChange('manual');\n      notify();\n    },\n\n    clearError: (target, validityStateKey) => {\n      manualErrors = manualErrors.filter(\n        (error) => !matchesTarget(error, target, validityStateKey),\n      );\n      emitValidityChange('manual');\n      notify();\n    },\n\n    register: (control) => {\n      // Per-registration token. A control id can be re-registered (remount, or a\n      // duplicate id). Every handle captures its token and no-ops if the live entry's\n      // token differs, so a stale handle's async report/unregister can't clobber the\n      // current registration.\n      const token = Symbol(control.id);\n      controls.set(control.id, { control, token });\n      notify();\n      return {\n        reportValidity: (state) => {\n          if (controls.get(control.id)?.token !== token) {\n            return;\n          }\n          fieldStates.set(control.id, state);\n          emitValidityChange(state.trigger);\n          notify();\n        },\n        unregister: () => {\n          if (controls.get(control.id)?.token !== token) {\n            return;\n          }\n          controls.delete(control.id);\n          fieldStates.delete(control.id);\n          emitValidityChange('manual');\n          notify();\n        },\n      };\n    },\n\n    subscribe: (listener) => {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n\n    // `FormMessages`/`FormFieldMessages` read these via `useSyncExternalStore`, which\n    // compares snapshots by reference. Return the cached array unless the error set's\n    // signature actually changed \u2014 a fresh array on every read forces a re-render and\n    // can loop.\n    getFormMessages: () => {\n      if (isPending()) {\n        return NO_ERRORS;\n      }\n      // Form-wide errors: the routing subclass, plus any control's native/Strato\n      // error explicitly routed to the form outlet via `_messageTarget`.\n      const current = aggregateErrors().filter(\n        (error) =>\n          error instanceof FormValidationError || routesTo(error, 'form'),\n      );\n      const signature = errorSetSignature(current);\n      if (signature !== formMessagesSignature) {\n        formMessagesSignature = signature;\n        formMessagesCache = current;\n      }\n      return formMessagesCache;\n    },\n\n    getFieldMessages: (controlId) => {\n      if (isPending()) {\n        return NO_ERRORS;\n      }\n      const current = errorsForField(controlId);\n      const signature = errorSetSignature(current);\n      const cached = fieldMessagesCache.get(controlId);\n      if (cached?.signature === signature) {\n        return cached.messages;\n      }\n      fieldMessagesCache.set(controlId, { signature, messages: current });\n      return current;\n    },\n\n    _bindConfig: (fn) => {\n      readConfig = fn ?? (() => config);\n    },\n  };\n\n  return api;\n}\n\nasync function runFormValidator<TValues>(\n  validator: FormValidator<TValues>,\n  values: TValues,\n  formId: string | undefined,\n): Promise<ValidationError[]> {\n  try {\n    return await validator({ values });\n  } catch (cause) {\n    if (formId !== undefined) {\n      return [\n        new FormValidationError('Validation failed.', {\n          formId,\n          cause,\n        }),\n      ];\n    }\n    return [\n      new ValidationError('Validation failed.', { source: 'custom', cause }),\n    ];\n  }\n}\n\nfunction cloneWithCustomSource(error: ValidationError): ValidationError {\n  if (error instanceof FormValidationError) {\n    return new FormValidationError(error.message, {\n      formId: error.formId,\n      validityStateKey: error.validityStateKey,\n      formControlId: error.formControlId,\n      cause: error.cause,\n    });\n  }\n  return new ValidationError(error.message, {\n    source: 'custom',\n    validityStateKey: error.validityStateKey,\n    formControlId: error.formControlId,\n    cause: error.cause,\n  });\n}\n\nfunction matchesTarget(\n  error: ValidationError,\n  target: string,\n  validityStateKey?: ValidityStateKey,\n): boolean {\n  const routedTo =\n    (error instanceof FormValidationError && error.formId === target) ||\n    (Array.isArray(error.formControlId)\n      ? error.formControlId.includes(target)\n      : error.formControlId === target);\n  if (!routedTo) {\n    return false;\n  }\n  return (\n    validityStateKey === undefined ||\n    error.validityStateKey.equals(validityStateKey)\n  );\n}\n\nfunction focusFirstInvalid(\n  controls: Map<string, RegisteredEntry>,\n  errors: ValidationError[],\n) {\n  const invalidIds = new Set(\n    errors.flatMap((error) =>\n      error.formControlId === undefined\n        ? []\n        : Array.isArray(error.formControlId)\n          ? error.formControlId\n          : [error.formControlId],\n    ),\n  );\n  if (invalidIds.size === 0) {\n    // All errors are form-level only (formId, no formControlId). There is no\n    // specific control to target \u2014 the error is shown in FormMessages and no\n    // focus is moved.\n    return;\n  }\n  for (const { control } of controls.values()) {\n    if (invalidIds.has(control.id)) {\n      control.focus();\n      return;\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/esm/forms/forms-core/components/field-set/FieldSet.css

@@ -1,4 +1,4 @@
-._1dphm0f0-3-12-2 {
+._1dphm0f0-3-13-2 {
   appearance: none;
   margin: 0;
   border: none;
@@ -6,7 +6,7 @@
   min-width: 0;
   min-height: 0;
 }
-._1dphm0f1-3-12-2 {
+._1dphm0f1-3-13-2 {
   padding: 0;
   appearance: none;
   margin-bottom: var(--dt-spacings-size-12, 12px);

package/esm/forms/forms-core/components/field-set/FieldSet.sty.js

@@ -1,6 +1,6 @@
 import "./FieldSet.css";
-var fieldset = "_1dphm0f0-3-12-2";
-var legend = "_1dphm0f1-3-12-2";
+var fieldset = "_1dphm0f0-3-13-2";
+var legend = "_1dphm0f1-3-13-2";
 export {
   fieldset,
   legend

package/esm/forms/forms-core/components/field-set/FieldSet.sty.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/forms/forms-core/components/field-set/FieldSet.css.ts"],
-  "sourcesContent": ["import './FieldSet.css';\nexport var fieldset = '_1dphm0f0-3-12-2';\nexport var legend = '_1dphm0f1-3-12-2';"],
+  "sourcesContent": ["import './FieldSet.css';\nexport var fieldset = '_1dphm0f0-3-13-2';\nexport var legend = '_1dphm0f1-3-13-2';"],
   "mappings": "AAAA,OAAO;AACA,IAAI,WAAW;AACf,IAAI,SAAS;",
   "names": []
 }

package/esm/forms/forms-core/components/form-field/FormField.js

@@ -18,7 +18,7 @@ const FormField = /* @__PURE__ */ forwardRef((formFieldProps, forwardedRef) => {
     disabled,
     required,
     readOnly,
-    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    // oxlint-disable-next-line typescript/no-deprecated
     controlId: _controlId,
     className: consumerClassName,
     style: consumerStyle,

package/esm/forms/forms-core/components/form-field/FormField.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/forms/forms-core/components/form-field/FormField.tsx"],
-  "sourcesContent": ["import clsx from 'clsx';\nimport { forwardRef } from 'react';\n\nimport * as styles from './FormField.sty.js';\nimport { FormFieldContextProvider } from './FormFieldContextProvider.js';\nimport { FormFieldMessageContextProvider } from './FormFieldMessageContextProvider.js';\nimport { useBehavioralTrackingProps } from '../../../../core/hooks/useBehavioralTrackingProps.js';\nimport { useId } from '../../../../core/hooks/useId.js';\nimport { AriaDisabledProps } from '../../../../core/types/a11y-props.js';\nimport type { BehaviorTrackingProps } from '../../../../core/types/behavior-tracking-props.js';\nimport { DataTestId } from '../../../../core/types/data-props.js';\nimport { DOMProps } from '../../../../core/types/dom.js';\nimport { MaskingProps } from '../../../../core/types/masking-props.js';\nimport { StylingProps } from '../../../../core/types/styling-props.js';\nimport { WithChildren } from '../../../../core/types/with-children.js';\nimport { mergeProps } from '../../../../core/utils/merge-props.js';\nimport { parseBoolean as _parseBoolean } from '../../../../core/utils/parse-boolean.js';\nimport { Flex } from '../../../../layouts/flex/Flex.js';\nimport type { SharedFormFieldProps } from '../../types/formfield.types.js';\n\nconst COMPONENT_NAME = 'FormField';\n\n/**\n * @public\n */\nexport interface FormFieldProps\n  extends WithChildren,\n    SharedFormFieldProps,\n    StylingProps,\n    DataTestId,\n    MaskingProps,\n    DOMProps,\n    AriaDisabledProps,\n    BehaviorTrackingProps {}\n\n/**\n * The `FormField` component is the outermost layout component of an input\n * component (for example `TextInput`), providing support for displaying a\n * sibling `label` element alongside.\n *\n * It also features responsive design: small containers show the label elements\n * aligned on top of the input. In comparison, wider containers show input elements\n * with their label aligned to the left.\n *\n * The form field is child-agnostic.\n * @public\n */\nexport const FormField = /* @__PURE__ */ forwardRef<\n  HTMLDivElement,\n  FormFieldProps\n>((formFieldProps, forwardedRef) => {\n  const generatedId = useId();\n  const {\n    children,\n    id: propId = generatedId,\n    disabled,\n    required,\n    readOnly,\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    controlId: _controlId,\n    className: consumerClassName,\n    style: consumerStyle,\n    'data-testid': dataTestId,\n    'data-dtrum-mask': dataDtrumMask,\n    'data-dtrum-allow': dataDtrumAllow,\n    'aria-disabled': ariaDisabledProp,\n    ...remainingProps\n  }: FormFieldProps = formFieldProps;\n\n  const [behavioralTrackingProps, restProps] =\n    useBehavioralTrackingProps(remainingProps);\n\n  return (\n    <FormFieldContextProvider\n      formFieldId={propId}\n      disabled={disabled}\n      ariaDisabled={_parseBoolean(ariaDisabledProp)}\n      required={required}\n      readOnly={readOnly}\n    >\n      <FormFieldMessageContextProvider>\n        <Flex\n          ref={forwardedRef}\n          data-testid={dataTestId}\n          data-dtrum-mask={dataDtrumMask}\n          data-dtrum-allow={dataDtrumAllow}\n          className={clsx(styles.formField, consumerClassName)}\n          gap={4}\n          flexDirection=\"column\"\n          style={consumerStyle}\n          {...mergeProps(restProps, behavioralTrackingProps)}\n          data-dt-component={COMPONENT_NAME}\n        >\n          {children}\n        </Flex>\n      </FormFieldMessageContextProvider>\n    </FormFieldContextProvider>\n  );\n});\n\n(FormField as typeof FormField & { displayName: string }).displayName =\n  COMPONENT_NAME;\n"],
-  "mappings": "AAiFQ;AAjFR,OAAO,UAAU;AACjB,SAAS,kBAAkB;AAE3B,YAAY,YAAY;AACxB,SAAS,gCAAgC;AACzC,SAAS,uCAAuC;AAChD,SAAS,kCAAkC;AAC3C,SAAS,aAAa;AAQtB,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB,qBAAqB;AAC9C,SAAS,YAAY;AAGrB,MAAM,iBAAiB;AA2BhB,MAAM,YAA4B,2BAGvC,CAAC,gBAAgB,iBAAiB;AAClC,QAAM,cAAc,MAAM;AAC1B,QAAM;AAAA,IACJ;AAAA,IACA,IAAI,SAAS;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA;AAAA,IAEA,WAAW;AAAA,IACX,WAAW;AAAA,IACX,OAAO;AAAA,IACP,eAAe;AAAA,IACf,mBAAmB;AAAA,IACnB,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,IACjB,GAAG;AAAA,EACL,IAAoB;AAEpB,QAAM,CAAC,yBAAyB,SAAS,IACvC,2BAA2B,cAAc;AAE3C,SACE;AAAA,IAAC;AAAA;AAAA,MACC,aAAa;AAAA,MACb;AAAA,MACA,cAAc,cAAc,gBAAgB;AAAA,MAC5C;AAAA,MACA;AAAA,MAEA,8BAAC,mCACC;AAAA,QAAC;AAAA;AAAA,UACC,KAAK;AAAA,UACL,eAAa;AAAA,UACb,mBAAiB;AAAA,UACjB,oBAAkB;AAAA,UAClB,WAAW,KAAK,OAAO,WAAW,iBAAiB;AAAA,UACnD,KAAK;AAAA,UACL,eAAc;AAAA,UACd,OAAO;AAAA,UACN,GAAG,WAAW,WAAW,uBAAuB;AAAA,UACjD,qBAAmB;AAAA,UAElB;AAAA;AAAA,MACH,GACF;AAAA;AAAA,EACF;AAEJ,CAAC;AAEA,UAAyD,cACxD;",
+  "sourcesContent": ["import clsx from 'clsx';\nimport { forwardRef } from 'react';\n\nimport * as styles from './FormField.sty.js';\nimport { FormFieldContextProvider } from './FormFieldContextProvider.js';\nimport { FormFieldMessageContextProvider } from './FormFieldMessageContextProvider.js';\nimport { useBehavioralTrackingProps } from '../../../../core/hooks/useBehavioralTrackingProps.js';\nimport { useId } from '../../../../core/hooks/useId.js';\nimport { AriaDisabledProps } from '../../../../core/types/a11y-props.js';\nimport type { BehaviorTrackingProps } from '../../../../core/types/behavior-tracking-props.js';\nimport { DataTestId } from '../../../../core/types/data-props.js';\nimport { DOMProps } from '../../../../core/types/dom.js';\nimport { MaskingProps } from '../../../../core/types/masking-props.js';\nimport { StylingProps } from '../../../../core/types/styling-props.js';\nimport { WithChildren } from '../../../../core/types/with-children.js';\nimport { mergeProps } from '../../../../core/utils/merge-props.js';\nimport { parseBoolean as _parseBoolean } from '../../../../core/utils/parse-boolean.js';\nimport { Flex } from '../../../../layouts/flex/Flex.js';\nimport type { SharedFormFieldProps } from '../../types/formfield.types.js';\n\nconst COMPONENT_NAME = 'FormField';\n\n/**\n * @public\n */\nexport interface FormFieldProps\n  extends\n    WithChildren,\n    SharedFormFieldProps,\n    StylingProps,\n    DataTestId,\n    MaskingProps,\n    DOMProps,\n    AriaDisabledProps,\n    BehaviorTrackingProps {}\n\n/**\n * The `FormField` component is the outermost layout component of an input\n * component (for example `TextInput`), providing support for displaying a\n * sibling `label` element alongside.\n *\n * It also features responsive design: small containers show the label elements\n * aligned on top of the input. In comparison, wider containers show input elements\n * with their label aligned to the left.\n *\n * The form field is child-agnostic.\n * @public\n */\nexport const FormField = /* @__PURE__ */ forwardRef<\n  HTMLDivElement,\n  FormFieldProps\n>((formFieldProps, forwardedRef) => {\n  const generatedId = useId();\n  const {\n    children,\n    id: propId = generatedId,\n    disabled,\n    required,\n    readOnly,\n    // oxlint-disable-next-line typescript/no-deprecated\n    controlId: _controlId,\n    className: consumerClassName,\n    style: consumerStyle,\n    'data-testid': dataTestId,\n    'data-dtrum-mask': dataDtrumMask,\n    'data-dtrum-allow': dataDtrumAllow,\n    'aria-disabled': ariaDisabledProp,\n    ...remainingProps\n  }: FormFieldProps = formFieldProps;\n\n  const [behavioralTrackingProps, restProps] =\n    useBehavioralTrackingProps(remainingProps);\n\n  return (\n    <FormFieldContextProvider\n      formFieldId={propId}\n      disabled={disabled}\n      ariaDisabled={_parseBoolean(ariaDisabledProp)}\n      required={required}\n      readOnly={readOnly}\n    >\n      <FormFieldMessageContextProvider>\n        <Flex\n          ref={forwardedRef}\n          data-testid={dataTestId}\n          data-dtrum-mask={dataDtrumMask}\n          data-dtrum-allow={dataDtrumAllow}\n          className={clsx(styles.formField, consumerClassName)}\n          gap={4}\n          flexDirection=\"column\"\n          style={consumerStyle}\n          {...mergeProps(restProps, behavioralTrackingProps)}\n          data-dt-component={COMPONENT_NAME}\n        >\n          {children}\n        </Flex>\n      </FormFieldMessageContextProvider>\n    </FormFieldContextProvider>\n  );\n});\n\n(FormField as typeof FormField & { displayName: string }).displayName =\n  COMPONENT_NAME;\n"],
+  "mappings": "AAkFQ;AAlFR,OAAO,UAAU;AACjB,SAAS,kBAAkB;AAE3B,YAAY,YAAY;AACxB,SAAS,gCAAgC;AACzC,SAAS,uCAAuC;AAChD,SAAS,kCAAkC;AAC3C,SAAS,aAAa;AAQtB,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB,qBAAqB;AAC9C,SAAS,YAAY;AAGrB,MAAM,iBAAiB;AA4BhB,MAAM,YAA4B,2BAGvC,CAAC,gBAAgB,iBAAiB;AAClC,QAAM,cAAc,MAAM;AAC1B,QAAM;AAAA,IACJ;AAAA,IACA,IAAI,SAAS;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA;AAAA,IAEA,WAAW;AAAA,IACX,WAAW;AAAA,IACX,OAAO;AAAA,IACP,eAAe;AAAA,IACf,mBAAmB;AAAA,IACnB,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,IACjB,GAAG;AAAA,EACL,IAAoB;AAEpB,QAAM,CAAC,yBAAyB,SAAS,IACvC,2BAA2B,cAAc;AAE3C,SACE;AAAA,IAAC;AAAA;AAAA,MACC,aAAa;AAAA,MACb;AAAA,MACA,cAAc,cAAc,gBAAgB;AAAA,MAC5C;AAAA,MACA;AAAA,MAEA,8BAAC,mCACC;AAAA,QAAC;AAAA;AAAA,UACC,KAAK;AAAA,UACL,eAAa;AAAA,UACb,mBAAiB;AAAA,UACjB,oBAAkB;AAAA,UAClB,WAAW,KAAK,OAAO,WAAW,iBAAiB;AAAA,UACnD,KAAK;AAAA,UACL,eAAc;AAAA,UACd,OAAO;AAAA,UACN,GAAG,WAAW,WAAW,uBAAuB;AAAA,UACjD,qBAAmB;AAAA,UAElB;AAAA;AAAA,MACH,GACF;AAAA;AAAA,EACF;AAEJ,CAAC;AAEA,UAAyD,cACxD;",
   "names": []
 }

package/esm/forms/forms-core/components/form-field/FormField.sty.js

@@ -1,5 +1,5 @@
 import "./FormField.css";
-var formField = "_mvcxum0-3-12-2";
+var formField = "_mvcxum0-3-13-2";
 export {
   formField
 };

package/esm/forms/forms-core/components/form-field/FormField.sty.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/forms/forms-core/components/form-field/FormField.css.ts"],
-  "sourcesContent": ["import './FormField.css';\nexport var formField = '_mvcxum0-3-12-2';"],
+  "sourcesContent": ["import './FormField.css';\nexport var formField = '_mvcxum0-3-13-2';"],
   "mappings": "AAAA,OAAO;AACA,IAAI,YAAY;",
   "names": []
 }

package/esm/forms/forms-core/components/form-field/FormFieldMessageContextProvider.js

@@ -32,7 +32,7 @@ const FormFieldMessageContextProvider = (formFieldProps) => {
     []
   );
   const legacyFormFieldId = (
-    // eslint-disable-next-line @typescript-eslint/no-deprecated -- APPDEV-18321
+    // oxlint-disable-next-line typescript/no-deprecated -- APPDEV-18321
     formFieldState.formFieldId ?? formFieldState.controlId ?? propId
   );
   const [state, dispatch] = useReducer(formFieldMessageReducerCB, {

package/esm/forms/forms-core/components/form-field/FormFieldMessageContextProvider.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/forms/forms-core/components/form-field/FormFieldMessageContextProvider.tsx"],
-  "sourcesContent": ["import {\n  forwardRef,\n  useCallback,\n  useContext,\n  useEffect,\n  useReducer,\n  type JSXElementConstructor,\n  type ComponentProps,\n  useMemo,\n} from 'react';\n\nimport { useId } from '../../../../core/hooks/useId.js';\nimport { DOMProps } from '../../../../core/types/dom.js';\nimport type { FormControlBaseProps } from '../../../../core/types/form-control-props.js';\nimport { WithChildren } from '../../../../core/types/with-children.js';\nimport { FormContext } from '../../../form/context/FormContext.js';\nimport { FormFieldMessageContext } from '../../contexts/FormFieldMessageContext.js';\nimport { useFormFieldContext } from '../../hooks/useFormFieldContext.js';\nimport { useFormFieldMessagesContext } from '../../hooks/useFormFieldMessagesContext.js';\nimport {\n  FormFieldMessagesAction,\n  formFieldMessagesReducer,\n  type FormFieldMessagesReducerAction,\n} from '../../state/formfield-messages-state-reducer.js';\nimport type { FormFieldMessageContextState } from '../../types/formfield-messages.types.js';\nimport type { SharedFormFieldProps } from '../../types/formfield.types.js';\n\ntype FormFieldMessageContextProviderProps = WithChildren &\n  DOMProps &\n  Pick<SharedFormFieldProps, 'disabled'> & {\n    /** interim solution for the segmentSelector until we introduce proper group errors. */\n    showError?: boolean;\n  };\n\n/**\n * Provides the FormFieldMessages context and handles default values properly, to easily reuse it when needed.\n * @internal\n */\nexport const FormFieldMessageContextProvider = /* @__PURE__ */ (\n  formFieldProps: FormFieldMessageContextProviderProps,\n) => {\n  const generatedId = useId();\n  const messagesContainerId = useId();\n  const formContext = useContext(FormContext);\n  const {\n    children,\n    id: propId = generatedId,\n    disabled: propDisabled,\n    showError: propShowError,\n  }: FormFieldMessageContextProviderProps = formFieldProps;\n\n  const formFieldState = useFormFieldContext();\n\n  const formFieldMessageReducerCB = useCallback(\n    (\n      state: FormFieldMessageContextState,\n      action: FormFieldMessagesReducerAction,\n    ) => formFieldMessagesReducer(state, action),\n    [],\n  );\n\n  const legacyFormFieldId =\n    // eslint-disable-next-line @typescript-eslint/no-deprecated -- APPDEV-18321\n    formFieldState.formFieldId ?? formFieldState.controlId ?? propId;\n\n  const [state, dispatch] = useReducer(formFieldMessageReducerCB, {\n    customMessages: [],\n    formControlMessages: [],\n    showError: false,\n    isTouched: false,\n    isValid: undefined,\n    formFieldId: legacyFormFieldId,\n    formControlId: formFieldState.formControlId ?? legacyFormFieldId,\n    memberFormControlIds: formFieldState.memberFormControlIds,\n  });\n\n  const memberFormControlIdsKey =\n    formFieldState.memberFormControlIds.join('\\u0000');\n\n  useEffect(() => {\n    if (formFieldState.formControlId === undefined) {\n      return;\n    }\n\n    dispatch({\n      type: FormFieldMessagesAction.SETFORMCONTROLID,\n      payload: { formControlId: formFieldState.formControlId },\n    });\n  }, [formFieldState.formControlId]);\n\n  useEffect(() => {\n    for (const formControlId of formFieldState.memberFormControlIds) {\n      dispatch({\n        type: FormFieldMessagesAction.ADDMEMBERFORMCONTROLID,\n        payload: { formControlId },\n      });\n    }\n\n    return () => {\n      for (const formControlId of formFieldState.memberFormControlIds) {\n        dispatch({\n          type: FormFieldMessagesAction.REMOVEMEMBERFORMCONTROLID,\n          payload: { formControlId },\n        });\n      }\n    };\n    // memberFormControlIdsKey captures the actual id list while avoiding an\n    // effect loop from the context array identity changing after each registration.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [memberFormControlIdsKey]);\n\n  const formFieldMessageContextValue = useMemo(\n    () => ({\n      disabled: formFieldState.disabled || propDisabled,\n      controlId: legacyFormFieldId,\n      dispatch,\n      state: {\n        ...state,\n        showError: (propShowError ?? false) || state.showError,\n      },\n      fieldMessagesContainerId: messagesContainerId,\n      formMessagesContainerId: formContext?.formMessagesId,\n      // A control can route its native/Strato messages to the form-wide outlet via\n      // `_messageTarget`. When the field is not among the targets, those messages are\n      // dropped from the inline render here (a pure render-time filter, so they never\n      // flash inline first). Validity is unaffected, and consumer-authored errors\n      // (source 'custom') always stay at the field. With no enclosing <Form>, 'form'\n      // falls back to the field, so nothing is suppressed.\n      routesAwayFromField:\n        formContext !== undefined &&\n        state.messageTarget !== undefined &&\n        !state.messageTarget.includes('field'),\n    }),\n    [\n      formContext,\n      formFieldState.disabled,\n      legacyFormFieldId,\n      propDisabled,\n      dispatch,\n      state,\n      propShowError,\n      messagesContainerId,\n    ],\n  );\n\n  return (\n    <FormFieldMessageContext.Provider value={formFieldMessageContextValue}>\n      {children}\n    </FormFieldMessageContext.Provider>\n  );\n};\n\n/**\n * Function to ensure that a component with props that have generics in their type is always wrapped within a `MessageContextProvider`\n * for form validation outside of a `FormField`.\n * @internal\n */\nexport function withFormFieldMessageContextProviderWithGenerics<\n  ComponentType extends JSXElementConstructor<\n    FormControlBaseProps<TOnChange, TFocusElement>\n  >,\n  TFocusElement extends Element = Element,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TOnChange extends (...args: any[]) => void = (...args: any[]) => void,\n>(OriginalComponent: ComponentType) {\n  type Props = ComponentProps<ComponentType>;\n  type RefType = Props extends { ref?: infer R } ? R : never;\n\n  const WrappedComponent = forwardRef<RefType, Props>((props, forwardedRef) => {\n    const { dispatch } = useFormFieldMessagesContext();\n\n    if (dispatch !== undefined) {\n      // the cast to any was necessary because the RefType and Props type cannot be easily/correctly inferred when we have generics\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      return <OriginalComponent ref={forwardedRef} {...(props as any)} />;\n    }\n\n    const { disabled, id } = props;\n\n    return (\n      <FormFieldMessageContextProvider disabled={disabled} id={id}>\n        {/* the cast to any was necessary because the RefType and Props type cannot be easily/correctly inferred when we have generics */}\n        {/* eslint-disable-next-line @typescript-eslint/no-explicit-any */}\n        <OriginalComponent ref={forwardedRef} {...(props as any)} />\n      </FormFieldMessageContextProvider>\n    );\n  });\n\n  // The cast ensures the returned component retains generics when used in JSX\n  return WrappedComponent as ComponentType;\n}\n\n/**\n * Function to ensure that an element is always wrapped within a MessageContextProvider for form validation outside of a `FormField`.\n * @internal\n */\nexport function withFormFieldMessageContextProvider<\n  PropType extends FormControlBaseProps<TOnChange, TFocusElement>,\n  RefType,\n  TFocusElement extends Element = Element,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TOnChange extends (...args: any[]) => void = (...args: any[]) => void,\n>(OriginalComponent: JSXElementConstructor<PropType>) {\n  const WithFormFieldMessageContextProvider = forwardRef<RefType, PropType>(\n    (props, forwardedRef) => {\n      const { dispatch } = useFormFieldMessagesContext();\n\n      if (dispatch !== undefined) {\n        return <OriginalComponent ref={forwardedRef} {...props} />;\n      }\n\n      const { disabled, id } = props;\n\n      return (\n        <FormFieldMessageContextProvider disabled={disabled} id={id}>\n          <OriginalComponent ref={forwardedRef} {...props} />\n        </FormFieldMessageContextProvider>\n      );\n    },\n  );\n\n  return WithFormFieldMessageContextProvider;\n}\n\n(\n  FormFieldMessageContextProvider as typeof FormFieldMessageContextProvider & {\n    displayName: string;\n  }\n).displayName = 'FormFieldMessageContextProvider';\n"],
+  "sourcesContent": ["import {\n  forwardRef,\n  useCallback,\n  useContext,\n  useEffect,\n  useReducer,\n  type JSXElementConstructor,\n  type ComponentProps,\n  useMemo,\n} from 'react';\n\nimport { useId } from '../../../../core/hooks/useId.js';\nimport { DOMProps } from '../../../../core/types/dom.js';\nimport type { FormControlBaseProps } from '../../../../core/types/form-control-props.js';\nimport { WithChildren } from '../../../../core/types/with-children.js';\nimport { FormContext } from '../../../form/context/FormContext.js';\nimport { FormFieldMessageContext } from '../../contexts/FormFieldMessageContext.js';\nimport { useFormFieldContext } from '../../hooks/useFormFieldContext.js';\nimport { useFormFieldMessagesContext } from '../../hooks/useFormFieldMessagesContext.js';\nimport {\n  FormFieldMessagesAction,\n  formFieldMessagesReducer,\n  type FormFieldMessagesReducerAction,\n} from '../../state/formfield-messages-state-reducer.js';\nimport type { FormFieldMessageContextState } from '../../types/formfield-messages.types.js';\nimport type { SharedFormFieldProps } from '../../types/formfield.types.js';\n\ntype FormFieldMessageContextProviderProps = WithChildren &\n  DOMProps &\n  Pick<SharedFormFieldProps, 'disabled'> & {\n    /** interim solution for the segmentSelector until we introduce proper group errors. */\n    showError?: boolean;\n  };\n\n/**\n * Provides the FormFieldMessages context and handles default values properly, to easily reuse it when needed.\n * @internal\n */\nexport const FormFieldMessageContextProvider = /* @__PURE__ */ (\n  formFieldProps: FormFieldMessageContextProviderProps,\n) => {\n  const generatedId = useId();\n  const messagesContainerId = useId();\n  const formContext = useContext(FormContext);\n  const {\n    children,\n    id: propId = generatedId,\n    disabled: propDisabled,\n    showError: propShowError,\n  }: FormFieldMessageContextProviderProps = formFieldProps;\n\n  const formFieldState = useFormFieldContext();\n\n  const formFieldMessageReducerCB = useCallback(\n    (\n      state: FormFieldMessageContextState,\n      action: FormFieldMessagesReducerAction,\n    ) => formFieldMessagesReducer(state, action),\n    [],\n  );\n\n  const legacyFormFieldId =\n    // oxlint-disable-next-line typescript/no-deprecated -- APPDEV-18321\n    formFieldState.formFieldId ?? formFieldState.controlId ?? propId;\n\n  const [state, dispatch] = useReducer(formFieldMessageReducerCB, {\n    customMessages: [],\n    formControlMessages: [],\n    showError: false,\n    isTouched: false,\n    isValid: undefined,\n    formFieldId: legacyFormFieldId,\n    formControlId: formFieldState.formControlId ?? legacyFormFieldId,\n    memberFormControlIds: formFieldState.memberFormControlIds,\n  });\n\n  const memberFormControlIdsKey =\n    formFieldState.memberFormControlIds.join('\\u0000');\n\n  useEffect(() => {\n    if (formFieldState.formControlId === undefined) {\n      return;\n    }\n\n    dispatch({\n      type: FormFieldMessagesAction.SETFORMCONTROLID,\n      payload: { formControlId: formFieldState.formControlId },\n    });\n  }, [formFieldState.formControlId]);\n\n  useEffect(() => {\n    for (const formControlId of formFieldState.memberFormControlIds) {\n      dispatch({\n        type: FormFieldMessagesAction.ADDMEMBERFORMCONTROLID,\n        payload: { formControlId },\n      });\n    }\n\n    return () => {\n      for (const formControlId of formFieldState.memberFormControlIds) {\n        dispatch({\n          type: FormFieldMessagesAction.REMOVEMEMBERFORMCONTROLID,\n          payload: { formControlId },\n        });\n      }\n    };\n    // memberFormControlIdsKey captures the actual id list while avoiding an\n    // effect loop from the context array identity changing after each registration.\n    // oxlint-disable-next-line react-hooks/exhaustive-deps\n  }, [memberFormControlIdsKey]);\n\n  const formFieldMessageContextValue = useMemo(\n    () => ({\n      disabled: formFieldState.disabled || propDisabled,\n      controlId: legacyFormFieldId,\n      dispatch,\n      state: {\n        ...state,\n        showError: (propShowError ?? false) || state.showError,\n      },\n      fieldMessagesContainerId: messagesContainerId,\n      formMessagesContainerId: formContext?.formMessagesId,\n      // A control can route its native/Strato messages to the form-wide outlet via\n      // `_messageTarget`. When the field is not among the targets, those messages are\n      // dropped from the inline render here (a pure render-time filter, so they never\n      // flash inline first). Validity is unaffected, and consumer-authored errors\n      // (source 'custom') always stay at the field. With no enclosing <Form>, 'form'\n      // falls back to the field, so nothing is suppressed.\n      routesAwayFromField:\n        formContext !== undefined &&\n        state.messageTarget !== undefined &&\n        !state.messageTarget.includes('field'),\n    }),\n    [\n      formContext,\n      formFieldState.disabled,\n      legacyFormFieldId,\n      propDisabled,\n      dispatch,\n      state,\n      propShowError,\n      messagesContainerId,\n    ],\n  );\n\n  return (\n    <FormFieldMessageContext.Provider value={formFieldMessageContextValue}>\n      {children}\n    </FormFieldMessageContext.Provider>\n  );\n};\n\n/**\n * Function to ensure that a component with props that have generics in their type is always wrapped within a `MessageContextProvider`\n * for form validation outside of a `FormField`.\n * @internal\n */\nexport function withFormFieldMessageContextProviderWithGenerics<\n  ComponentType extends JSXElementConstructor<\n    FormControlBaseProps<TOnChange, TFocusElement>\n  >,\n  TFocusElement extends Element = Element,\n  // oxlint-disable-next-line typescript/no-explicit-any\n  TOnChange extends (...args: any[]) => void = (...args: any[]) => void,\n>(OriginalComponent: ComponentType) {\n  type Props = ComponentProps<ComponentType>;\n  type RefType = Props extends { ref?: infer R } ? R : never;\n\n  const WrappedComponent = forwardRef<RefType, Props>((props, forwardedRef) => {\n    const { dispatch } = useFormFieldMessagesContext();\n\n    if (dispatch !== undefined) {\n      // the cast to any was necessary because the RefType and Props type cannot be easily/correctly inferred when we have generics\n      // oxlint-disable-next-line typescript/no-explicit-any\n      return <OriginalComponent ref={forwardedRef} {...(props as any)} />;\n    }\n\n    const { disabled, id } = props;\n\n    return (\n      <FormFieldMessageContextProvider disabled={disabled} id={id}>\n        {/* the cast to any was necessary because the RefType and Props type cannot be easily/correctly inferred when we have generics */}\n        {/* oxlint-disable-next-line typescript/no-explicit-any */}\n        <OriginalComponent ref={forwardedRef} {...(props as any)} />\n      </FormFieldMessageContextProvider>\n    );\n  });\n\n  // The cast ensures the returned component retains generics when used in JSX\n  return WrappedComponent as ComponentType;\n}\n\n/**\n * Function to ensure that an element is always wrapped within a MessageContextProvider for form validation outside of a `FormField`.\n * @internal\n */\nexport function withFormFieldMessageContextProvider<\n  PropType extends FormControlBaseProps<TOnChange, TFocusElement>,\n  RefType,\n  TFocusElement extends Element = Element,\n  // oxlint-disable-next-line typescript/no-explicit-any\n  TOnChange extends (...args: any[]) => void = (...args: any[]) => void,\n>(OriginalComponent: JSXElementConstructor<PropType>) {\n  const WithFormFieldMessageContextProvider = forwardRef<RefType, PropType>(\n    (props, forwardedRef) => {\n      const { dispatch } = useFormFieldMessagesContext();\n\n      if (dispatch !== undefined) {\n        return <OriginalComponent ref={forwardedRef} {...props} />;\n      }\n\n      const { disabled, id } = props;\n\n      return (\n        <FormFieldMessageContextProvider disabled={disabled} id={id}>\n          <OriginalComponent ref={forwardedRef} {...props} />\n        </FormFieldMessageContextProvider>\n      );\n    },\n  );\n\n  return WithFormFieldMessageContextProvider;\n}\n\n(\n  FormFieldMessageContextProvider as typeof FormFieldMessageContextProvider & {\n    displayName: string;\n  }\n).displayName = 'FormFieldMessageContextProvider';\n"],
   "mappings": "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",
   "names": ["state"]
 }

package/esm/forms/forms-core/components/form-field-messages/FormFieldMessageItem.css

@@ -1,17 +1,17 @@
-._16z6rg10-3-12-2 {
+._16z6rg10-3-13-2 {
   font-size: var(--dt-typography-text-small-default-size, 12px);
   line-height: var(--dt-typography-text-small-default-line-height, 1.333333333);
 }
-._16z6rg11-3-12-2 {
+._16z6rg11-3-13-2 {
   color: var(--dt-colors-text-neutral-subdued, #595a7d);
 }
-._16z6rg12-3-12-2 {
+._16z6rg12-3-13-2 {
   color: var(--dt-colors-text-critical-default, #bb0731);
 }
-._16z6rg13-3-12-2 {
+._16z6rg13-3-13-2 {
   color: var(--dt-colors-text-neutral-disabled, #595a7d80);
 }
-._16z6rg14-3-12-2 {
+._16z6rg14-3-13-2 {
   min-width: 0;
   overflow-wrap: break-word;
 }

package/esm/forms/forms-core/components/form-field-messages/FormFieldMessageItem.js

@@ -12,6 +12,7 @@ const FormFieldMessageItem = (props) => {
     message,
     id = generatedId,
     validityStateKey,
+    showImmediately = false,
     ...remainingProps
   } = props;
   const { state, dispatch } = useFormFieldMessagesContext();
@@ -23,6 +24,7 @@ const FormFieldMessageItem = (props) => {
       payload: {
         id,
         variant,
+        ...showImmediately && { showError: variant === "error" },
         ...messageString !== void 0 && { messageText: messageString }
       }
     });
@@ -32,9 +34,9 @@ const FormFieldMessageItem = (props) => {
         payload: { id }
       });
     };
-  }, [variant, id, dispatch, messageString]);
+  }, [variant, id, dispatch, messageString, showImmediately]);
   const hasFormControlRegistration = state.formControlId !== void 0 || state.memberFormControlIds !== void 0 && state.memberFormControlIds.length > 0;
-  if (dispatch && hasFormControlRegistration && !state.showError && variant === "error") {
+  if (!showImmediately && dispatch && hasFormControlRegistration && !state.showError && variant === "error") {
     return null;
   }
   return /* @__PURE__ */ jsx(BaseItem, { variant, id, ...remainingProps, children: children ?? message });

package/esm/forms/forms-core/components/form-field-messages/FormFieldMessageItem.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/forms/forms-core/components/form-field-messages/FormFieldMessageItem.tsx"],
-  "sourcesContent": ["import { useEffect, type ReactNode } from 'react';\n\nimport type { FormFieldMessageBaseItemProps } from './FormFieldMessageBaseItem.js';\nimport { InternalBaseItem as BaseItem } from './FormFieldMessageBaseItem.js';\nimport { useId } from '../../../../core/hooks/useId.js';\nimport { useFormFieldMessagesContext } from '../../hooks/useFormFieldMessagesContext.js';\nimport { FormFieldMessagesAction } from '../../state/formfield-messages-state-reducer.js';\n\n/**\n * @public\n */\nexport type FormFieldMessageItemProps = FormFieldMessageBaseItemProps & {\n  /**\n   * Content of the FormFieldMessage\n   */\n  message?: ReactNode;\n  /**\n   * The validity state key set on the form control element.\n   * The automatically supported errors depend on the keys from the browser API (See https://developer.mozilla.org/en-US/docs/Web/API/ValidityState).\n   * In case the same key is used for additional validation, the message will be overwritten by the default.\n   *\n   */\n  validityStateKey?: string;\n};\n\n/**\n * Renders a FormFieldMessageItem message if given, otherwise renders the provided children.\n * @public\n */\nexport const FormFieldMessageItem = (props: FormFieldMessageItemProps) => {\n  const generatedId = useId();\n  const {\n    children,\n    variant = 'hint',\n    message,\n    id = generatedId,\n    validityStateKey,\n    ...remainingProps\n  } = props;\n\n  const { state, dispatch } = useFormFieldMessagesContext();\n\n  const content = children ?? message;\n  const messageString = typeof content === 'string' ? content : undefined;\n\n  useEffect(() => {\n    dispatch?.({\n      type: FormFieldMessagesAction.ADDMESSAGE,\n      payload: {\n        id,\n        variant,\n        ...(messageString !== undefined && { messageText: messageString }),\n      },\n    });\n\n    return () => {\n      dispatch?.({\n        type: FormFieldMessagesAction.REMOVEMESSAGE,\n        payload: { id },\n      });\n    };\n  }, [variant, id, dispatch, messageString]);\n\n  // Only registered controls use the new validation-message visibility model.\n  const hasFormControlRegistration =\n    state.formControlId !== undefined ||\n    (state.memberFormControlIds !== undefined &&\n      state.memberFormControlIds.length > 0);\n\n  if (\n    dispatch &&\n    hasFormControlRegistration &&\n    !state.showError &&\n    variant === 'error'\n  ) {\n    return null;\n  }\n\n  return (\n    <BaseItem variant={variant} id={id} {...remainingProps}>\n      {children ?? message}\n    </BaseItem>\n  );\n};\n\nFormFieldMessageItem.displayName = 'FormFieldMessageItem';\n"],
-  "mappings": "AA+EI;AA/EJ,SAAS,iBAAiC;AAG1C,SAAS,oBAAoB,gBAAgB;AAC7C,SAAS,aAAa;AACtB,SAAS,mCAAmC;AAC5C,SAAS,+BAA+B;AAuBjC,MAAM,uBAAuB,CAAC,UAAqC;AACxE,QAAM,cAAc,MAAM;AAC1B,QAAM;AAAA,IACJ;AAAA,IACA,UAAU;AAAA,IACV;AAAA,IACA,KAAK;AAAA,IACL;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AAEJ,QAAM,EAAE,OAAO,SAAS,IAAI,4BAA4B;AAExD,QAAM,UAAU,YAAY;AAC5B,QAAM,gBAAgB,OAAO,YAAY,WAAW,UAAU;AAE9D,YAAU,MAAM;AACd,eAAW;AAAA,MACT,MAAM,wBAAwB;AAAA,MAC9B,SAAS;AAAA,QACP;AAAA,QACA;AAAA,QACA,GAAI,kBAAkB,UAAa,EAAE,aAAa,cAAc;AAAA,MAClE;AAAA,IACF,CAAC;AAED,WAAO,MAAM;AACX,iBAAW;AAAA,QACT,MAAM,wBAAwB;AAAA,QAC9B,SAAS,EAAE,GAAG;AAAA,MAChB,CAAC;AAAA,IACH;AAAA,EACF,GAAG,CAAC,SAAS,IAAI,UAAU,aAAa,CAAC;AAGzC,QAAM,6BACJ,MAAM,kBAAkB,UACvB,MAAM,yBAAyB,UAC9B,MAAM,qBAAqB,SAAS;AAExC,MACE,YACA,8BACA,CAAC,MAAM,aACP,YAAY,SACZ;AACA,WAAO;AAAA,EACT;AAEA,SACE,oBAAC,YAAS,SAAkB,IAAS,GAAG,gBACrC,sBAAY,SACf;AAEJ;AAEA,qBAAqB,cAAc;",
+  "sourcesContent": ["import { useEffect, type ReactNode } from 'react';\n\nimport type { FormFieldMessageBaseItemProps } from './FormFieldMessageBaseItem.js';\nimport { InternalBaseItem as BaseItem } from './FormFieldMessageBaseItem.js';\nimport { useId } from '../../../../core/hooks/useId.js';\nimport { useFormFieldMessagesContext } from '../../hooks/useFormFieldMessagesContext.js';\nimport { FormFieldMessagesAction } from '../../state/formfield-messages-state-reducer.js';\n\n/**\n * @public\n */\nexport type FormFieldMessageItemProps = FormFieldMessageBaseItemProps & {\n  /**\n   * Content of the FormFieldMessage\n   */\n  message?: ReactNode;\n  /**\n   * The validity state key set on the form control element.\n   * The automatically supported errors depend on the keys from the browser API (See https://developer.mozilla.org/en-US/docs/Web/API/ValidityState).\n   * In case the same key is used for additional validation, the message will be overwritten by the default.\n   *\n   */\n  validityStateKey?: string;\n  /**\n   * When `true`, an error item is revealed as soon as it mounts and puts the field into\n   * an error state immediately, bypassing the field's normal reveal gate (first blur, overlay\n   * close, or immediate-on-click, depending on the control). Has no effect on hint items.\n   *\n   * @defaultValue false\n   */\n  showImmediately?: boolean;\n};\n\n/**\n * Renders a FormFieldMessageItem message if given, otherwise renders the provided children.\n * @public\n */\nexport const FormFieldMessageItem = (props: FormFieldMessageItemProps) => {\n  const generatedId = useId();\n  const {\n    children,\n    variant = 'hint',\n    message,\n    id = generatedId,\n    validityStateKey,\n    showImmediately = false,\n    ...remainingProps\n  } = props;\n\n  const { state, dispatch } = useFormFieldMessagesContext();\n\n  const content = children ?? message;\n  const messageString = typeof content === 'string' ? content : undefined;\n\n  useEffect(() => {\n    dispatch?.({\n      type: FormFieldMessagesAction.ADDMESSAGE,\n      payload: {\n        id,\n        variant,\n        ...(showImmediately && { showError: variant === 'error' }),\n        ...(messageString !== undefined && { messageText: messageString }),\n      },\n    });\n\n    return () => {\n      dispatch?.({\n        type: FormFieldMessagesAction.REMOVEMESSAGE,\n        payload: { id },\n      });\n    };\n  }, [variant, id, dispatch, messageString, showImmediately]);\n\n  // Only registered controls use the reveal-gated visibility model.\n  const hasFormControlRegistration =\n    state.formControlId !== undefined ||\n    (state.memberFormControlIds !== undefined &&\n      state.memberFormControlIds.length > 0);\n\n  if (\n    !showImmediately &&\n    dispatch &&\n    hasFormControlRegistration &&\n    !state.showError &&\n    variant === 'error'\n  ) {\n    return null;\n  }\n\n  return (\n    <BaseItem variant={variant} id={id} {...remainingProps}>\n      {children ?? message}\n    </BaseItem>\n  );\n};\n\nFormFieldMessageItem.displayName = 'FormFieldMessageItem';\n"],
+  "mappings": "AA0FI;AA1FJ,SAAS,iBAAiC;AAG1C,SAAS,oBAAoB,gBAAgB;AAC7C,SAAS,aAAa;AACtB,SAAS,mCAAmC;AAC5C,SAAS,+BAA+B;AA+BjC,MAAM,uBAAuB,CAAC,UAAqC;AACxE,QAAM,cAAc,MAAM;AAC1B,QAAM;AAAA,IACJ;AAAA,IACA,UAAU;AAAA,IACV;AAAA,IACA,KAAK;AAAA,IACL;AAAA,IACA,kBAAkB;AAAA,IAClB,GAAG;AAAA,EACL,IAAI;AAEJ,QAAM,EAAE,OAAO,SAAS,IAAI,4BAA4B;AAExD,QAAM,UAAU,YAAY;AAC5B,QAAM,gBAAgB,OAAO,YAAY,WAAW,UAAU;AAE9D,YAAU,MAAM;AACd,eAAW;AAAA,MACT,MAAM,wBAAwB;AAAA,MAC9B,SAAS;AAAA,QACP;AAAA,QACA;AAAA,QACA,GAAI,mBAAmB,EAAE,WAAW,YAAY,QAAQ;AAAA,QACxD,GAAI,kBAAkB,UAAa,EAAE,aAAa,cAAc;AAAA,MAClE;AAAA,IACF,CAAC;AAED,WAAO,MAAM;AACX,iBAAW;AAAA,QACT,MAAM,wBAAwB;AAAA,QAC9B,SAAS,EAAE,GAAG;AAAA,MAChB,CAAC;AAAA,IACH;AAAA,EACF,GAAG,CAAC,SAAS,IAAI,UAAU,eAAe,eAAe,CAAC;AAG1D,QAAM,6BACJ,MAAM,kBAAkB,UACvB,MAAM,yBAAyB,UAC9B,MAAM,qBAAqB,SAAS;AAExC,MACE,CAAC,mBACD,YACA,8BACA,CAAC,MAAM,aACP,YAAY,SACZ;AACA,WAAO;AAAA,EACT;AAEA,SACE,oBAAC,YAAS,SAAkB,IAAS,GAAG,gBACrC,sBAAY,SACf;AAEJ;AAEA,qBAAqB,cAAc;",
   "names": []
 }

package/esm/forms/forms-core/components/form-field-messages/FormFieldMessageItem.sty.js

@@ -1,7 +1,7 @@
 import "./FormFieldMessageItem.css";
 import { createRuntimeFn as _7a468 } from "@vanilla-extract/recipes/createRuntimeFn";
-var formFieldMessageItem = _7a468({ defaultClassName: "_16z6rg10-3-12-2", variantClassNames: { variant: { hint: "_16z6rg11-3-12-2", error: "_16z6rg12-3-12-2" }, disabled: { true: "_16z6rg13-3-12-2" } }, defaultVariants: { variant: "hint", disabled: false }, compoundVariants: [] });
-var formFieldMessageItemText = "_16z6rg14-3-12-2";
+var formFieldMessageItem = _7a468({ defaultClassName: "_16z6rg10-3-13-2", variantClassNames: { variant: { hint: "_16z6rg11-3-13-2", error: "_16z6rg12-3-13-2" }, disabled: { true: "_16z6rg13-3-13-2" } }, defaultVariants: { variant: "hint", disabled: false }, compoundVariants: [] });
+var formFieldMessageItemText = "_16z6rg14-3-13-2";
 export {
   formFieldMessageItem,
   formFieldMessageItemText

package/esm/forms/forms-core/components/form-field-messages/FormFieldMessageItem.sty.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/forms/forms-core/components/form-field-messages/FormFieldMessageItem.css.ts"],
-  "sourcesContent": ["import './FormFieldMessageItem.css';\nimport { createRuntimeFn as _7a468 } from '@vanilla-extract/recipes/createRuntimeFn';\nexport var formFieldMessageItem = _7a468({defaultClassName:'_16z6rg10-3-12-2',variantClassNames:{variant:{hint:'_16z6rg11-3-12-2',error:'_16z6rg12-3-12-2'},disabled:{true:'_16z6rg13-3-12-2'}},defaultVariants:{variant:'hint',disabled:false},compoundVariants:[]});\nexport var formFieldMessageItemText = '_16z6rg14-3-12-2';"],
+  "sourcesContent": ["import './FormFieldMessageItem.css';\nimport { createRuntimeFn as _7a468 } from '@vanilla-extract/recipes/createRuntimeFn';\nexport var formFieldMessageItem = _7a468({defaultClassName:'_16z6rg10-3-13-2',variantClassNames:{variant:{hint:'_16z6rg11-3-13-2',error:'_16z6rg12-3-13-2'},disabled:{true:'_16z6rg13-3-13-2'}},defaultVariants:{variant:'hint',disabled:false},compoundVariants:[]});\nexport var formFieldMessageItemText = '_16z6rg14-3-13-2';"],
   "mappings": "AAAA,OAAO;AACP,SAAS,mBAAmB,cAAc;AACnC,IAAI,uBAAuB,OAAO,EAAC,kBAAiB,oBAAmB,mBAAkB,EAAC,SAAQ,EAAC,MAAK,oBAAmB,OAAM,mBAAkB,GAAE,UAAS,EAAC,MAAK,mBAAkB,EAAC,GAAE,iBAAgB,EAAC,SAAQ,QAAO,UAAS,MAAK,GAAE,kBAAiB,CAAC,EAAC,CAAC;AAC7P,IAAI,2BAA2B;",
   "names": []
 }

package/esm/forms/forms-core/components/form-field-messages/FormFieldMessages.css

@@ -1,9 +1,9 @@
-._1l9bja60-3-12-2 {
+._1l9bja60-3-13-2 {
   display: flex;
 }
-._1l9bja60-3-12-2:empty {
+._1l9bja60-3-13-2:empty {
   display: none;
 }
-._1l9bja60-3-12-2[aria-hidden='true'] {
+._1l9bja60-3-13-2[aria-hidden='true'] {
   display: none;
 }

package/esm/forms/forms-core/components/form-field-messages/FormFieldMessages.js

@@ -5,6 +5,7 @@ import {
   forwardRef,
   useContext,
   useEffect,
+  useMemo,
   useSyncExternalStore
 } from "react";
 import { FormFieldMessageItem } from "./FormFieldMessageItem.js";
@@ -12,6 +13,7 @@ import * as styles from "./FormFieldMessages.sty.js";
 import { useBehavioralTrackingProps } from "../../../../core/hooks/useBehavioralTrackingProps.js";
 import { Flex } from "../../../../layouts/flex/Flex.js";
 import { FormContext } from "../../../form/context/FormContext.js";
+import { FormValidationError } from "../../../form/form-error-classes.js";
 import { useFormFieldContext } from "../../hooks/useFormFieldContext.js";
 import { useFormFieldMessagesContext } from "../../hooks/useFormFieldMessagesContext.js";
 import { FormFieldMessagesAction } from "../../state/formfield-messages-state-reducer.js";
@@ -29,6 +31,7 @@ function RuntimeFieldMessageRegistration({
   const { dispatch } = useFormFieldMessagesContext();
   const id = `runtime-${error.validityStateKey.toString()}-${error.message}`;
   useEffect(() => {
+    const source = error instanceof FormValidationError ? "strato" : error.source;
     dispatch?.({
       type: FormFieldMessagesAction.ADDMESSAGE,
       payload: {
@@ -37,7 +40,7 @@ function RuntimeFieldMessageRegistration({
         validityStateKey: error.validityStateKey.toString(),
         messageType: "formcontrol",
         variant: "error",
-        source: error.source,
+        source,
         controlId,
         showError: true
       }
@@ -48,14 +51,7 @@ function RuntimeFieldMessageRegistration({
         payload: { id, messageType: "formcontrol", controlId }
       });
     };
-  }, [
-    controlId,
-    dispatch,
-    error.message,
-    error.source,
-    error.validityStateKey,
-    id
-  ]);
+  }, [controlId, dispatch, error, error.message, error.validityStateKey, id]);
   return null;
 }
 const FormFieldMessagesRoot = /* @__PURE__ */ forwardRef((FormFieldMessageProps, forwardedRef) => {
@@ -102,6 +98,12 @@ const FormFieldMessagesRoot = /* @__PURE__ */ forwardRef((FormFieldMessageProps,
     (msg) => !msg.source || msg.source === activeSource
   );
   const formMessages = state.showError ? visibleErrorMessages : internalHintMessages;
+  const showErrors = !state.isDisabled && (state.showError || (state.isTouched ?? false));
+  const isValid = state.isValid ?? true;
+  const validationState = useMemo(
+    () => ({ showErrors, isValid }),
+    [showErrors, isValid]
+  );
   const hasVisibleErrorsToShow = state.showError && suppressedErrorMessages.length > 0;
   const autoErrorItems = state.showError ? suppressedErrorMessages.map((message) => /* @__PURE__ */ createElement(
     FormFieldMessages.Item,
@@ -114,7 +116,7 @@ const FormFieldMessagesRoot = /* @__PURE__ */ forwardRef((FormFieldMessageProps,
   let content = null;
   let hasConsumerChildren = Boolean(children);
   if (typeof children === "function") {
-    content = children(formMessages);
+    content = children(formMessages, validationState);
     if (content === void 0 || content === null) {
       hasConsumerChildren = false;
     }