@dynatrace/strato-components 3.12.1 → 3.13.0

package/esm/forms/date-time-range-picker/DateTimeRangePicker.sty.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/forms/date-time-range-picker/DateTimeRangePicker.css.ts"],
-  "sourcesContent": ["import '../../core/components/app-root/AppRoot.css';\nimport '../../styles/field.css';\nimport '../../styles/textStyle.css';\nimport '../spin-buttons/SpinButton.css';\nimport '../date-time-picker/DateTimePicker.css';\nimport './DateTimeRangePicker.css';\nimport { createRuntimeFn as _7a468 } from '@vanilla-extract/recipes/createRuntimeFn';\nexport var dateTimeInput = '_1vlwkc26-3-12-1';\nexport var dateTimeRange = _7a468({defaultClassName:'_1vlwkc20-3-12-1',variantClassNames:{showError:{true:'_1vlwkc21-3-12-1'},disabled:{true:'_1vlwkc22-3-12-1'},readOnly:{true:'_1vlwkc23-3-12-1'}},defaultVariants:{},compoundVariants:[[{showError:true,readOnly:true},'_1vlwkc24-3-12-1']]});\nexport var scrollContainer = '_1vlwkc25-3-12-1';\nexport var timeframeSeparator = '_1vlwkc27-3-12-1';"],
+  "sourcesContent": ["import '../../core/components/app-root/AppRoot.css';\nimport '../../styles/field.css';\nimport '../../styles/textStyle.css';\nimport '../spin-buttons/SpinButton.css';\nimport '../date-time-picker/DateTimePicker.css';\nimport './DateTimeRangePicker.css';\nimport { createRuntimeFn as _7a468 } from '@vanilla-extract/recipes/createRuntimeFn';\nexport var dateTimeInput = '_1vlwkc26-3-13-0';\nexport var dateTimeRange = _7a468({defaultClassName:'_1vlwkc20-3-13-0',variantClassNames:{showError:{true:'_1vlwkc21-3-13-0'},disabled:{true:'_1vlwkc22-3-13-0'},readOnly:{true:'_1vlwkc23-3-13-0'}},defaultVariants:{},compoundVariants:[[{showError:true,readOnly:true},'_1vlwkc24-3-13-0']]});\nexport var scrollContainer = '_1vlwkc25-3-13-0';\nexport var timeframeSeparator = '_1vlwkc27-3-13-0';"],
   "mappings": "AAAA,OAAO;AACP,OAAO;AACP,OAAO;AACP,OAAO;AACP,OAAO;AACP,OAAO;AACP,SAAS,mBAAmB,cAAc;AACnC,IAAI,gBAAgB;AACpB,IAAI,gBAAgB,OAAO,EAAC,kBAAiB,oBAAmB,mBAAkB,EAAC,WAAU,EAAC,MAAK,mBAAkB,GAAE,UAAS,EAAC,MAAK,mBAAkB,GAAE,UAAS,EAAC,MAAK,mBAAkB,EAAC,GAAE,iBAAgB,CAAC,GAAE,kBAAiB,CAAC,CAAC,EAAC,WAAU,MAAK,UAAS,KAAI,GAAE,kBAAkB,CAAC,EAAC,CAAC;AACxR,IAAI,kBAAkB;AACtB,IAAI,qBAAqB;",
   "names": []
 }

package/esm/forms/date-time-range-picker/hooks/useDateTimeInput.js

@@ -203,7 +203,7 @@ const useDateTimeInput = (props, expressionInputRef) => {
       }
     },
     // no use in adding the expressionInputRef to the dep. array
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+    // oxlint-disable-next-line react-hooks/exhaustive-deps
     []
   );
   const spinButtonHandlersRef = useRef(spinButtonHandlers);

package/esm/forms/date-time-range-picker/hooks/useDateTimeInput.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/forms/date-time-range-picker/hooks/useDateTimeInput.ts"],
-  "sourcesContent": ["import { TZDateMini } from '@date-fns/tz';\nimport {\n  ClipboardEventHandler,\n  FocusEventHandler,\n  FocusEvent as ReactFocusEvent,\n  ReactEventHandler,\n  KeyboardEventHandler as ReactKeyboardEventHandler,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type RefObject,\n} from 'react';\n\nimport {\n  _parseTimeExpression,\n  parseTimeAsTimeValue,\n} from '@dynatrace-sdk/units';\nimport { getTimezone } from '@dynatrace-sdk/user-preferences';\n\nimport { useDateTimeParser } from './useDateTimeParser.js';\nimport { spinExpressionValue } from './useExpressionSpin.js';\nimport { useAriaLabelingProps } from '../../../core/hooks/useAriaLabelingProps.js';\nimport { useControllableState } from '../../../core/hooks/useControllableState.js';\nimport { isEqualTimeValue } from '../../../core/time/helpers.js';\nimport { useDateTimePickerStore } from '../../../core/time/timeframeStore/useTimeframeStore.js';\nimport type { TimeValue } from '../../../core/types/time.js';\nimport { useDateTimePicker } from '../../date-time-picker/hooks/useDateTimePicker.js';\nimport {\n  formatTimeValue,\n  getTimeValue,\n} from '../../forms-core/time/timeParser.js';\nimport { useSelection } from '../../spin-buttons/hooks/useSelection.js';\nimport type { NumberSpinButtonRef } from '../../spin-buttons/number-spin-button/types.js';\nimport type { SpinButtonHandler } from '../../spin-buttons/spin-button-group/types.js';\nimport {\n  captureUndoSnapshot,\n  isContentModifyingKey,\n  normalizeISOInput,\n  parseDateOnlyToISO,\n  parseTimeOnlyToISO,\n  partialDateTimeToISO,\n  tryParsePartialDate,\n  tryParsePartialTime,\n} from '../helpers.js';\nimport {\n  getExpressionCursorOffset,\n  restoreExpressionCursorOffset,\n} from '../selection-helpers.js';\nimport type { DateTimeInputProps, UndoSnapshot } from '../types.js';\n\nfunction isNumberSpinButton(\n  handler: SpinButtonHandler | undefined,\n): handler is NumberSpinButtonRef {\n  return handler?.type === 'number';\n}\n\nconst DATE_PART_TYPES: Set<Intl.DateTimeFormatPart['type']> = new Set([\n  'day',\n  'month',\n  'year',\n]);\nconst TIME_PART_TYPES: Set<Intl.DateTimeFormatPart['type']> = new Set([\n  'hour',\n  'minute',\n  'second',\n  'fractionalSecond',\n  'dayPeriod',\n]);\n\n/**\n * Inserts plain text at the current cursor position, replacing any active selection.\n */\nconst insertTextAtCursor = (text: string) => {\n  const selection = window.getSelection();\n  if (selection?.rangeCount) {\n    const range = selection.getRangeAt(0);\n    range.deleteContents();\n    const textNode = document.createTextNode(text);\n    range.insertNode(textNode);\n    range.setStartAfter(textNode);\n    range.collapse(true);\n    selection.removeAllRanges();\n    selection.addRange(range);\n  }\n};\n\n/**\n * Returns true when at least one non-literal spin button is empty.\n */\nconst hasAnyEmptySpinButton = (\n  handlersRef: RefObject<\n    Map<\n      keyof Intl.DateTimeFormatPartTypesRegistry,\n      SpinButtonHandler | null | undefined\n    >\n  >,\n): boolean =>\n  Array.from(handlersRef.current?.entries() ?? []).some(\n    ([type, handler]) =>\n      handler &&\n      type !== 'literal' &&\n      handler.element.current?.textContent === '',\n  );\n\n/**\n * Pastes text into the expression contenteditable span, either at the cursor\n * position (when the selection is inside the span) or by replacing its content.\n */\nconst pasteIntoExpressionInput = (\n  element: RefObject<HTMLSpanElement | null>,\n  text: string,\n): void => {\n  if (element.current) {\n    const selection = window.getSelection();\n    const range = selection?.rangeCount ? selection.getRangeAt(0) : null;\n\n    if (\n      range &&\n      element.current.contains(range.startContainer) &&\n      element.current.contains(range.endContainer)\n    ) {\n      insertTextAtCursor(text);\n    } else {\n      element.current.textContent = text;\n      moveCursorToEnd(element.current);\n    }\n\n    element.current.dispatchEvent(new InputEvent('input', { bubbles: true }));\n  }\n};\n\n/**\n * Moves the cursor (selection) to the end of the given element's content.\n */\nconst moveCursorToEnd = (element: HTMLSpanElement | null | undefined) => {\n  if (element) {\n    const range = document.createRange();\n    const selection = window.getSelection();\n    range.selectNodeContents(element);\n    range.collapse(false);\n    selection?.removeAllRanges();\n    selection?.addRange(range);\n  }\n};\n\n/*\n * A hook that provides the default functionality for the DateTimeInput picker\n */\nexport const useDateTimeInput = (\n  props: DateTimeInputProps,\n  expressionInputRef: RefObject<HTMLSpanElement | null>,\n) => {\n  const {\n    disabled,\n    readOnly,\n    type,\n    onChange,\n    onLeadingEdge,\n    onTrailingEdge,\n    dateOnlyPasteAnchor = 'startOfDay',\n    onPasteComplete,\n    partialTimeAnchorDate,\n  }: DateTimeInputProps = props;\n  const precision = useDateTimePickerStore((state) =>\n    state.precision !== 'day' ? state.precision : 'milliseconds',\n  );\n\n  const ariaProps = useAriaLabelingProps(props);\n  const { regexDateTimeStart, maxValue, types } = useDateTimeParser({\n    type,\n  });\n  // ? INVESTIGATE: without the generic, building the visreg story viewer and unit-test typechecking fails,\n  // ? but the components:build target still succeeds without any issues -> why?\n  const [value, setValue] = useControllableState<TimeValue | null>(props);\n  const isControlled = props.value !== undefined;\n  const [valueType, setValueType] = useState(value?.type ?? 'expression');\n  const firstRun = useRef(true);\n  // Tracks the previous value content so that a parent re-render that passes a\n  // new object reference with the same content does not trigger formatExpressionValue\n  // and reset DOM edits that haven't propagated through React state yet.\n  const prevValueRef = useRef<TimeValue | null | undefined>(undefined);\n  const [expressionEmpty, setExpressionEmpty] = useState(\n    !expressionInputRef.current?.textContent,\n  );\n  const [inputValue, setInputValue] = useState('');\n  // Skips no-op setInputValue calls in the [value] effect. Passive-effect\n  // writes that React can't bail out on schedule SyncLane commits that\n  // accumulate on rapid keypresses.\n  const lastInputValueRef = useRef(inputValue);\n  lastInputValueRef.current = inputValue;\n  const pasteUndoRef = useRef<{\n    snapshot: UndoSnapshot;\n    focusTarget: Element | null;\n    expressionCursorOffset?: number;\n  } | null>(null);\n\n  useEffect(() => {\n    return () => {\n      pasteUndoRef.current = null;\n    };\n  }, []);\n\n  // Tracks the last valid absoluteDate to pass a stable, parseable ISO string\n  // to useDateTimePicker while props.value temporarily has absoluteDate:'' during\n  // partial spinbutton editing. Keeps useDateTimePicker.value prop unchanged so\n  // its internal useEffect doesn't re-run and clear the spinbuttons.\n  const lastValidAbsoluteDateRef = useRef<string | null>(\n    value?.type === 'iso8601' && value.absoluteDate ? value.absoluteDate : null,\n  );\n  // True only during the requestAnimationFrame window opened by switchToExpressionMode.\n  // Used to suppress stale spinbutton onChange callbacks that fire while the mode\n  // transition is in flight, without blocking legitimate restore/undo calls.\n  const isSwitchingToExpressionRef = useRef(false);\n\n  // Use valueType (local state) not value.type (controlled prop) as the gate \u2014\n  // the controlled prop can temporarily become type:'expression' when the store\n  // echoes back a partial invalid value for validation while we're still in\n  // spinbutton mode.\n  if (\n    valueType === 'iso8601' &&\n    value?.type === 'iso8601' &&\n    value.absoluteDate\n  ) {\n    lastValidAbsoluteDateRef.current = value.absoluteDate;\n  }\n  const spinButtonValue =\n    valueType === 'iso8601' ? lastValidAbsoluteDateRef.current : null;\n\n  // Stores the date parts filled in by a partial paste so the focus can target\n  // the first spin button that was not filled.\n  const pendingFocusPartsRef = useRef<Set<\n    keyof Intl.DateTimeFormatPartTypesRegistry\n  > | null>(null);\n\n  const {\n    spinButtons,\n    handlers: spinButtonHandlers,\n    empty: spinButtonsEmpty,\n    applyDateTime,\n    firstSpinButtonHandler,\n  } = useDateTimePicker({\n    type,\n    precision,\n    disabled,\n    readOnly,\n    valueType,\n    value: spinButtonValue,\n    onChange: (newIsoDateTime) => {\n      const newValue = getTimeValue(newIsoDateTime ?? undefined, precision);\n\n      if (newValue === null || newValue === undefined) {\n        return;\n      }\n\n      // Suppress stale spinbutton callbacks that fire while switchToExpressionMode\n      // is transitioning. Any other caller (e.g. undo restore) is allowed through.\n      if (isSwitchingToExpressionRef.current) {\n        return;\n      }\n\n      if (expressionInputRef.current) {\n        expressionInputRef.current.textContent = '';\n      }\n\n      // If undo (or another caller) pushes a value while we're in expression mode,\n      // switch back to spinbutton mode now.\n      if (valueType !== 'iso8601') {\n        setValueType('iso8601');\n      }\n\n      // Forward invalid values (empty string or unparseable partial locale string)\n      // to onChange so the store validates and shows errors, but skip setValue so\n      // props.value stays stable and spinbuttons are not cleared.\n      if (newIsoDateTime === '' || newValue?.absoluteDate === '') {\n        onChange?.(newValue);\n        return;\n      }\n\n      setInputValue(newValue.value);\n      // only update the value if the newTimeValue differs from the prev. one\n      setValue((prevValue) =>\n        isEqualTimeValue(prevValue, newValue) ? prevValue : newValue,\n      );\n    },\n    ...ariaProps,\n  });\n\n  const empty = useMemo(\n    () => (valueType === 'expression' ? expressionEmpty : spinButtonsEmpty),\n    [valueType, expressionEmpty, spinButtonsEmpty],\n  );\n\n  // Shared state reset when switching (back) to expression mode.\n  const resetToExpressionMode = useCallback(\n    (expressionEmpty = true) => {\n      setValueType('expression');\n      setValue(null);\n      setInputValue('');\n      setExpressionEmpty(expressionEmpty);\n      lastValidAbsoluteDateRef.current = null;\n    },\n    [setValue],\n  );\n\n  // Tracks the last absoluteDate seen by the controlled-value effect.\n  // Used to distinguish a genuine value re-application (absoluteDate changed,\n  // e.g. from '' back to a valid ISO string) from an outdated reference change\n  // (the store re-parsed a sibling field and created a new object with the\n  // same absoluteDate).\n  const prevAbsoluteDateRef = useRef<string | null>(null);\n\n  // Called on onBlur to sanitize the current expression. Declared here (before\n  // the [value] useEffect below) so that React Compiler's immutability analysis\n  // can confirm the reference is available at the time the effect is registered.\n  const formatExpressionValue = useCallback(\n    (value: TimeValue | null) => {\n      if (!expressionInputRef.current) {\n        return;\n      }\n      const formattedValue = value ? formatTimeValue(value) : '';\n      const currentValue = formatTimeValue(\n        expressionInputRef.current?.textContent ?? '',\n      );\n\n      // only update if the current value differs from the new value\n      // don't update the textnode while typing but allow e.g. pasting a new expression\n      if (currentValue !== formattedValue) {\n        expressionInputRef.current.textContent = formattedValue;\n      }\n    },\n    // no use in adding the expressionInputRef to the dep. array\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [],\n  );\n\n  // Keep a ref to the latest spinButtonHandlers so that focus helpers\n  // inside requestAnimationFrame always use the current map.\n  const spinButtonHandlersRef = useRef(spinButtonHandlers);\n  spinButtonHandlersRef.current = spinButtonHandlers;\n\n  // switch input mode based on controlled value change\n  useEffect(() => {\n    const prevValue = prevValueRef.current;\n    prevValueRef.current = value;\n\n    const applyInputValue = (next: string) => {\n      if (lastInputValueRef.current === next) {\n        return;\n      }\n      lastInputValueRef.current = next;\n      // eslint-disable-next-line react-hooks/set-state-in-effect\n      setInputValue(next);\n    };\n\n    if (value?.type === 'iso8601' && !spinButtonsEmpty) {\n      applyInputValue(value.value);\n    }\n\n    // ignore if in uncontrolled mode\n    if (!isControlled || typeof value === 'string') {\n      return;\n    }\n\n    const prevAbsoluteDate = prevAbsoluteDateRef.current;\n    prevAbsoluteDateRef.current = value?.absoluteDate ?? null;\n\n    // reset input if value is null\n    if (!value) {\n      setValueType('expression');\n      formatExpressionValue(null);\n      const input = expressionInputRef.current?.textContent;\n      setExpressionEmpty(input === '');\n      applyDateTime(null);\n      lastValidAbsoluteDateRef.current = null;\n      return;\n    }\n\n    // Skip values with empty absoluteDate: partial/invalid intermediate states\n    // forwarded to the store for validation only. The spinbuttons manage their\n    // own display; reacting here would switch to 'expression' mode and call\n    // formatExpressionValue, clearing the display.\n    if (value.absoluteDate === '') {\n      return;\n    }\n\n    // apply value to expression\n    // the spinbutton update is handled within the useSpinButton hook internally\n    if (valueType !== value.type) {\n      setValueType(value.type);\n    }\n    applyInputValue(value.value);\n    if (value.type === 'expression') {\n      // Only reformat the DOM when the expression content has actually changed.\n      // A parent re-render that produces a new object reference with the same\n      // value (e.g. due to a sibling input's state update) must not overwrite\n      // DOM edits (e.g. partial cross-expression deletion) that haven't yet\n      // propagated back through React state.\n      if (!isEqualTimeValue(prevValue ?? null, value)) {\n        formatExpressionValue(value);\n      }\n      setExpressionEmpty(value.value === '');\n    } else if (\n      value.type === 'iso8601' &&\n      hasAnyEmptySpinButton(spinButtonHandlersRef) &&\n      prevAbsoluteDate !== value.absoluteDate\n    ) {\n      applyDateTime(value.absoluteDate);\n    }\n    // only react to outside value changes\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [value]);\n\n  // Focuses the first spin button that is still empty, or the last spin button when\n  // everything is filled in.\n  const focusFirstUnfilledSpinButton = useCallback(\n    (filledParts: Set<keyof Intl.DateTimeFormatPartTypesRegistry>) => {\n      const handlers = spinButtonHandlersRef.current;\n      for (const [type, handler] of handlers) {\n        if (\n          handler &&\n          type !== 'literal' &&\n          !filledParts.has(\n            type as keyof Intl.DateTimeFormatPartTypesRegistry,\n          ) &&\n          handler.element.current?.textContent === ''\n        ) {\n          handler.element.current?.focus();\n          return;\n        }\n      }\n      // Fallback: focus the last spin button when everything is filled.\n      let lastHandler: SpinButtonHandler | null = null;\n      for (const [, handler] of handlers) {\n        if (handler) {\n          lastHandler = handler;\n        }\n      }\n      lastHandler?.element?.current?.focus();\n    },\n    [],\n  );\n\n  // Focus the first unfilled spin button after a partial paste triggers a mode switch.\n  useEffect(() => {\n    const filledParts = pendingFocusPartsRef.current;\n    if (!filledParts || valueType !== 'iso8601') {\n      return;\n    }\n    pendingFocusPartsRef.current = null;\n\n    requestAnimationFrame(() => {\n      focusFirstUnfilledSpinButton(filledParts);\n    });\n  }, [valueType, focusFirstUnfilledSpinButton]);\n\n  const { selectAll: expressionInputSelectAll } =\n    useSelection(expressionInputRef);\n\n  // handles input events on the expression contenteditable span\n  const expressionInputHandler: ReactEventHandler<HTMLSpanElement> =\n    useCallback(() => {\n      if (!expressionInputRef.current) {\n        return;\n      }\n\n      const input = expressionInputRef.current.textContent ?? '';\n\n      // Remove <br> added by browser in contenteditable to ensure placeholder works\n      if (expressionInputRef.current.innerHTML === '<br>') {\n        expressionInputRef.current.innerHTML = '';\n      }\n\n      // fallback to expression if text content is removed\n      if (input === '') {\n        setValueType('expression');\n        setValue(null);\n        setExpressionEmpty(true);\n        return;\n      }\n\n      setExpressionEmpty(false);\n\n      // if the input starts like a valid datetime for the current locale, switch to the datetime picker\n      const [, carryOver] = regexDateTimeStart.exec(input) ?? [];\n      if (Number.parseInt(carryOver) <= maxValue) {\n        setValueType('iso8601');\n\n        // clear all spinbuttons\n        applyDateTime(null);\n        lastValidAbsoluteDateRef.current = null;\n\n        // get a cleaned and sorted list of spinbutton handlers\n        const sortedHandlers = types\n          .filter((type) => type !== 'literal')\n          .map((type) => spinButtonHandlers.get(type))\n          .filter(Boolean) as SpinButtonHandler[];\n        const [carryOverSB, focusSB] = sortedHandlers;\n\n        // carry over entered value to the next number spinbutton\n        isNumberSpinButton(carryOverSB) &&\n          carryOverSB.applyText(carryOver, true);\n\n        // clear expression input content\n        expressionInputRef.current.textContent = '';\n\n        // set focus after switch to expression mode happened\n        requestAnimationFrame(() => {\n          // set focus to second spinbutton\n          focusSB?.element.current?.focus();\n        });\n        return;\n      }\n\n      // If the user types a number followed by \":\", switch to the datetime picker\n      // with the anchor date pre-filled and the typed hour applied, then focus the\n      // minute spin button so the user can continue typing the time.\n      // The anchor date defaults to today but can be overridden via `partialTimeAnchorDate`\n      if (type !== 'date') {\n        const colonMatch = /^(\\d{1,2}):$/.exec(input);\n        if (colonMatch) {\n          const hour = Number.parseInt(colonMatch[1]);\n          if (hour <= 23) {\n            const base = partialTimeAnchorDate\n              ? new TZDateMini(partialTimeAnchorDate, getTimezone())\n              : TZDateMini.tz(getTimezone());\n            const iso = TZDateMini.tz(\n              getTimezone(),\n              base.getFullYear(),\n              base.getMonth(),\n              base.getDate(),\n              hour,\n              0,\n              0,\n              0,\n            ).toISOString();\n\n            const partsToUpdate = new Set<\n              keyof Intl.DateTimeFormatPartTypesRegistry\n            >(['day', 'month', 'year', 'hour']);\n\n            setValueType('iso8601');\n            expressionInputRef.current.textContent = '';\n            applyDateTime(iso, partsToUpdate);\n\n            requestAnimationFrame(() => {\n              focusFirstUnfilledSpinButton(partsToUpdate);\n            });\n            return;\n          }\n        }\n      }\n\n      // If the copied text contains the formatted date in the user's locale (e.g.,\n      // \"12/24/2024\" or \"25.12.2024\"), switch to iso8601 mode and apply the parsed date\n      // fields to the spin buttons.\n      const typedPartialDate = tryParsePartialDate(input);\n      if (typedPartialDate) {\n        const dateResult = partialDateTimeToISO(typedPartialDate, null);\n        if (dateResult) {\n          setValueType('iso8601');\n          expressionInputRef.current.textContent = '';\n          applyDateTime(dateResult.iso, dateResult.partsToUpdate);\n\n          requestAnimationFrame(() =>\n            focusFirstUnfilledSpinButton(dateResult.partsToUpdate ?? new Set()),\n          );\n          return;\n        }\n      }\n\n      // if input is a valid expression, update the internal value state\n      const newValue = getTimeValue(input, precision) ?? null;\n\n      if (newValue?.absoluteDate === '') {\n        onChange?.(newValue);\n      }\n      // only update the value if the newTimeValue differs from the prev. one\n      setValue((prevValue) =>\n        isEqualTimeValue(prevValue, newValue) ? prevValue : newValue,\n      );\n\n      setInputValue(input);\n    }, [\n      expressionInputRef,\n      regexDateTimeStart,\n      maxValue,\n      partialTimeAnchorDate,\n      precision,\n      type,\n      setValue,\n      applyDateTime,\n      focusFirstUnfilledSpinButton,\n      types,\n      spinButtonHandlers,\n      onChange,\n    ]);\n\n  // select expression text content on focus\n  const expressionOnFocusHandler: FocusEventHandler<HTMLSpanElement> =\n    useCallback(\n      (event: ReactFocusEvent<HTMLSpanElement>) => {\n        // If the current selection spans multiple nodes (e.g. a drag-select or\n        // Cmd+A across multiple spin buttons / expression inputs), don't collapse\n        // it to just this expression input.\n        const selection = window.getSelection();\n        const selectionSpansMultipleNodes =\n          selection !== null &&\n          selection.anchorNode !== selection.focusNode &&\n          selection.toString().length > 0;\n\n        // Also skip if we are in the middle of a programmatic focus + setBaseAndExtent\n        // (guarded by data-restoring-selection on the .strato-inputgroup root).\n        const isRestoringSelection =\n          (event.target as HTMLElement)\n            .closest('.strato-inputgroup')\n            ?.hasAttribute('data-restoring-selection') ?? false;\n\n        // Skip if the user already has a non-collapsed selection inside this\n        // expression input (e.g. drag-select or Shift+arrow within one field).\n        // Calling selectAll() here would override that intended partial selection.\n        const expressionInputEl = event.target as HTMLElement;\n        const hasPartialSelectionWithin =\n          selection !== null &&\n          !selection.isCollapsed &&\n          expressionInputEl.contains(selection.anchorNode) &&\n          expressionInputEl.contains(selection.focusNode);\n\n        if (\n          selectionSpansMultipleNodes ||\n          isRestoringSelection ||\n          hasPartialSelectionWithin\n        ) {\n          return;\n        }\n\n        expressionInputSelectAll();\n      },\n      [expressionInputSelectAll],\n    );\n\n  // sanitize textnode if content is an expression\n  const expressionOnBlurHandler: FocusEventHandler<HTMLSpanElement> =\n    useCallback(() => {\n      if (expressionInputRef.current && value?.type === 'expression') {\n        const currentExpressionInput =\n          expressionInputRef.current.textContent ?? '';\n        const isValidExpression = _parseTimeExpression(\n          currentExpressionInput.trim(),\n        );\n\n        if (isValidExpression) {\n          expressionInputRef.current.textContent = formatTimeValue(value);\n        }\n      }\n\n      // eslint annoyingly wants to add the ref to the dependency list\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [value]);\n\n  // Shared paste logic used by both the DOM paste event handler and the\n  // imperative pasteText method on DateTimeInputRef. Returns true when the\n  // paste was handled (caller should preventDefault), false to let native\n  // paste proceed (step 4: digits in iso8601 mode).\n  const pasteText = useCallback(\n    (text: string, skipUndoCapture = false): boolean => {\n      if (readOnly) {\n        return false;\n      }\n\n      let trimmedData = normalizeISOInput(text.trim());\n      if (!trimmedData) {\n        return true;\n      }\n\n      // Pre-parse locale-specific partial date/time for normalization and step 5.\n      const partialDate = tryParsePartialDate(trimmedData);\n      const partialTime = tryParsePartialTime(trimmedData);\n      const partialResult =\n        partialDate || partialTime\n          ? partialDateTimeToISO(partialDate, partialTime)\n          : null;\n\n      // When the result is complete (no partsToUpdate), normalize to ISO so\n      // the existing ISO checks (steps 1\u20133) can handle it.\n      if (partialResult && !partialResult.partsToUpdate) {\n        trimmedData = partialResult.iso;\n      }\n\n      // Capture undo snapshot before any state mutations unless the caller\n      // already owns the snapshot (e.g. range-level paste handler).\n      if (!skipUndoCapture) {\n        const snapshot = captureUndoSnapshot(\n          spinButtonHandlers,\n          expressionInputRef.current,\n          value,\n          valueType,\n        );\n\n        pasteUndoRef.current = {\n          snapshot,\n          focusTarget: document.activeElement,\n          expressionCursorOffset: expressionInputRef.current\n            ? getExpressionCursorOffset(expressionInputRef.current)\n            : undefined,\n        };\n      }\n\n      // 1. Date-only paste (e.g. \"2025-01-01\")\n      // 2. Time-only paste (e.g. \"02:00Z\", \"14:30:00\")\n      const dateOnly = parseDateOnlyToISO(trimmedData, dateOnlyPasteAnchor);\n      const timeOnly = parseTimeOnlyToISO(trimmedData);\n      const date = dateOnly ?? timeOnly;\n\n      if (date) {\n        setValueType('iso8601');\n        // When spinbuttons are empty (expression mode), apply all parts so the\n        // full date is filled in.  When parts are already populated, only\n        // overwrite the date or time group that matches the pasted value.\n        let partsFilter: Set<Intl.DateTimeFormatPart['type']> | undefined;\n        if (!spinButtonsEmpty) {\n          partsFilter = dateOnly ? DATE_PART_TYPES : TIME_PART_TYPES;\n        }\n        applyDateTime(date, partsFilter);\n\n        // When only a subset of parts was applied, focus the first empty spin\n        // button instead of advancing. When all parts were applied skip the check.\n        if (partsFilter && hasAnyEmptySpinButton(spinButtonHandlersRef)) {\n          focusFirstUnfilledSpinButton(partsFilter);\n        } else {\n          onPasteComplete?.();\n        }\n\n        return true;\n      }\n\n      // 3. Full ISO datetime or expression (e.g. \"2025-01-01T02:00Z\", \"now()-1h\")\n      const nextValue = parseTimeAsTimeValue(\n        trimmedData,\n        TZDateMini.tz(getTimezone()).getTime(),\n        precision,\n      );\n\n      if (nextValue) {\n        setValueType(nextValue.type);\n        if (nextValue.type === 'expression') {\n          formatExpressionValue(nextValue);\n          moveCursorToEnd(expressionInputRef.current);\n          setValue(nextValue);\n        } else {\n          applyDateTime(nextValue.absoluteDate);\n        }\n        onPasteComplete?.();\n        return true;\n      }\n\n      // 4. Allow numbers to be pasted into the spin buttons\n      if (valueType === 'iso8601' && /^\\d+$/.test(trimmedData)) {\n        return false;\n      }\n\n      // 5. Partial date/time paste (e.g. \"25.12\", \"14:30\", \"25.12.2024 14:30\")\n      // partialResult was pre-computed above the ISO checks.\n      if (partialResult?.partsToUpdate) {\n        const { iso, partsToUpdate } = partialResult;\n        setValueType('iso8601');\n        applyDateTime(iso, partsToUpdate);\n\n        // Clear any spin button that was not explicitly present in the pasted\n        // text (i.e. was a placeholder token or simply absent). This ensures\n        // paste always overwrites: fields not carried by the pasted value are\n        // emptied rather than left at their previous content.\n        for (const [key, handler] of spinButtonHandlersRef.current) {\n          if (handler && !partsToUpdate.has(key)) {\n            handler.clearValue(true);\n          }\n        }\n\n        if (hasAnyEmptySpinButton(spinButtonHandlersRef)) {\n          requestAnimationFrame(() => {\n            focusFirstUnfilledSpinButton(partsToUpdate);\n          });\n        } else {\n          onPasteComplete?.();\n        }\n\n        return true;\n      }\n\n      // 6. Fallback: switch to expression mode and paste the raw string.\n      if (valueType === 'expression') {\n        if (expressionInputRef.current) {\n          pasteIntoExpressionInput(expressionInputRef, trimmedData);\n        }\n      } else {\n        setValueType('expression');\n        if (expressionInputRef.current) {\n          expressionInputRef.current.textContent = trimmedData;\n          expressionInputRef.current.focus();\n          moveCursorToEnd(expressionInputRef.current);\n          expressionInputRef.current.dispatchEvent(\n            new InputEvent('input', { bubbles: true }),\n          );\n        }\n      }\n\n      return true;\n    },\n    [\n      readOnly,\n      spinButtonHandlers,\n      expressionInputRef,\n      value,\n      dateOnlyPasteAnchor,\n      precision,\n      valueType,\n      setValue,\n      onPasteComplete,\n      formatExpressionValue,\n      applyDateTime,\n      spinButtonsEmpty,\n      focusFirstUnfilledSpinButton,\n    ],\n  );\n\n  // clipboard paste handler. apply clipboard content if formatted correctly\n  const onPaste: ClipboardEventHandler<HTMLSpanElement> = useCallback(\n    (event) => {\n      const data = event.clipboardData?.getData('text/plain');\n      if (!data) {\n        event.preventDefault();\n        return;\n      }\n      if (pasteText(data)) {\n        event.preventDefault();\n      }\n    },\n    [pasteText],\n  );\n\n  // Ctrl+Z / Cmd+Z handler to undo a paste operation.\n  const onPasteUndoKeyDown: ReactKeyboardEventHandler<HTMLSpanElement> =\n    useCallback(\n      (event) => {\n        const isCtrlZ = (event.ctrlKey || event.metaKey) && event.key === 'z';\n\n        if (!isCtrlZ) {\n          // Invalidates the paste snapshot for any other input.\n          if (pasteUndoRef.current && isContentModifyingKey(event)) {\n            pasteUndoRef.current = null;\n          }\n          return;\n        }\n\n        if (!pasteUndoRef.current) {\n          // No paste to undo \u2014 block native browser contenteditable undo.\n          event.preventDefault();\n          event.stopPropagation();\n          return;\n        }\n\n        const { snapshot, focusTarget, expressionCursorOffset } =\n          pasteUndoRef.current;\n        pasteUndoRef.current = null;\n\n        event.preventDefault();\n        event.stopPropagation();\n\n        // Restore value type first so the correct UI mode is rendered.\n        setValueType(snapshot.valueType);\n\n        if (snapshot.valueType === 'iso8601') {\n          // Restore spin button values from the snapshot.\n          snapshot.spinButtonTexts.forEach((text, type) => {\n            const handler = spinButtonHandlers.get(type) ?? null;\n            if (!handler) {\n              return;\n            }\n            if (text === '') {\n              handler.clearValue(true);\n            } else if (handler.type === 'number') {\n              handler.applyText(text, true);\n            } else {\n              handler.searchValue(text[0] ?? '', true);\n            }\n          });\n        } else {\n          // Restore expression text content.\n          if (expressionInputRef.current) {\n            expressionInputRef.current.textContent = snapshot.expressionText;\n          }\n          setExpressionEmpty(snapshot.expressionText === '');\n        }\n\n        setValue(snapshot.value);\n        setInputValue(snapshot.value?.value ?? '');\n\n        requestAnimationFrame(() => {\n          // Restore focus after the mode-switch re-render.\n          if (\n            focusTarget instanceof HTMLElement &&\n            focusTarget !== document.activeElement\n          ) {\n            focusTarget.focus();\n          }\n\n          // Restore cursor position in the expression input\n          if (\n            snapshot.valueType === 'expression' &&\n            expressionCursorOffset !== undefined &&\n            expressionInputRef.current\n          ) {\n            restoreExpressionCursorOffset(\n              expressionInputRef.current,\n              expressionCursorOffset,\n            );\n          }\n        });\n      },\n      [\n        spinButtonHandlers,\n        expressionInputRef,\n        setValue,\n        setValueType,\n        setExpressionEmpty,\n        setInputValue,\n      ],\n    );\n\n  // Handle keyboard events on the expression input: prevent Enter and spin on ArrowUp/ArrowDown\n  const expressionOnKeyDownHandler: ReactKeyboardEventHandler<HTMLSpanElement> =\n    useCallback(\n      (event) => {\n        if (event.key === 'Enter') {\n          event.preventDefault();\n          return;\n        }\n\n        if (\n          onLeadingEdge &&\n          event.key === 'Backspace' &&\n          (expressionInputRef.current?.textContent ?? '') === ''\n        ) {\n          event.preventDefault();\n          requestAnimationFrame(() => onLeadingEdge?.());\n          return;\n        }\n\n        if (\n          onTrailingEdge &&\n          event.key === 'Delete' &&\n          (expressionInputRef.current?.textContent ?? '') === ''\n        ) {\n          event.preventDefault();\n          requestAnimationFrame(() => onTrailingEdge?.());\n          return;\n        }\n\n        if (event.key === 'ArrowLeft' && onLeadingEdge) {\n          const selection = window.getSelection();\n          // If cursor is at the start (offset 0), navigate to the previous input\n          if (selection?.anchorOffset === 0 && selection?.focusOffset === 0) {\n            onLeadingEdge();\n            event.preventDefault();\n            return;\n          }\n        }\n\n        if (event.key === 'ArrowRight') {\n          const selection = window.getSelection();\n          const textContent = expressionInputRef.current?.textContent ?? '';\n          // If cursor is at the end, navigate to the next input\n          if (selection?.anchorOffset === textContent.length) {\n            onTrailingEdge?.();\n            event.preventDefault();\n            return;\n          }\n        }\n\n        if (\n          (event.key === 'ArrowUp' || event.key === 'ArrowDown') &&\n          !disabled &&\n          !readOnly\n        ) {\n          const element = expressionInputRef.current;\n          if (!element) {\n            return;\n          }\n\n          const currentText = element.textContent ?? '';\n          if (!currentText.trim()) {\n            return;\n          }\n\n          const direction: 1 | -1 = event.key === 'ArrowUp' ? 1 : -1;\n          const newText = spinExpressionValue(currentText, direction);\n\n          if (newText === null) {\n            return;\n          }\n\n          event.preventDefault();\n\n          // Preserve cursor position\n          const selection = window.getSelection();\n          const cursorOffset = selection?.focusOffset ?? 0;\n\n          // Update the text content and fire the input handler\n          element.textContent = newText;\n\n          // Restore cursor position (clamped to new text length)\n          requestAnimationFrame(() => {\n            const textNode = element.firstChild;\n            if (textNode && selection) {\n              const newOffset = Math.min(cursorOffset, newText.length);\n              const range = document.createRange();\n              range.setStart(textNode, newOffset);\n              range.collapse(true);\n              selection.removeAllRanges();\n              selection.addRange(range);\n            }\n          });\n\n          // Trigger the input handler to propagate the value change\n          element.dispatchEvent(new Event('input', { bubbles: true }));\n        }\n      },\n      [onLeadingEdge, expressionInputRef, disabled, readOnly, onTrailingEdge],\n    );\n\n  // focus the first spinbutton or the expression input based on the current input mode\n  const focus = useCallback(() => {\n    switch (valueType) {\n      case 'expression':\n        expressionInputRef.current?.focus();\n        break;\n      case 'iso8601':\n        firstSpinButtonHandler?.element?.current?.focus();\n        break;\n    }\n    // no need to pass the refs as dependency\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [valueType, firstSpinButtonHandler]);\n\n  /**\n   * Clears all spin buttons, switches to expression mode, and seeds the\n   * expression input with the provided text. Used when a bulk-delete leaves\n   * exactly one spin button filled \u2014 that remaining value is carried over as\n   * the expression seed rather than leaving a partial date.\n   */\n  const switchToExpressionMode = useCallback(\n    (text: string) => {\n      // setExpressionValue is an imperative expression-mode transition. Do not\n      // parse the text through getTimeValue here: numeric fallback text such as\n      // \"01\" can otherwise be treated as an ISO value and switch the input back\n      // to spin-button mode while a bulk clear is still settling.\n      const parsedValue = parseTimeAsTimeValue(\n        text,\n        TZDateMini.tz(getTimezone()).getTime(),\n        precision,\n      );\n      const newValue: TimeValue | null =\n        text !== ''\n          ? {\n              absoluteDate: parsedValue?.absoluteDate ?? '',\n              value: text,\n              type: 'expression',\n            }\n          : null;\n\n      for (const handler of spinButtonHandlers.values()) {\n        handler?.clearValue(false);\n        if (handler?.element.current) {\n          handler.element.current.textContent = '';\n        }\n      }\n\n      setInputValue(text);\n\n      if (valueType === 'expression') {\n        // Already in expression mode \u2014 apply synchronously so the next\n        // keypress is not dropped by a deferred rAF write.\n        setValue(newValue);\n        setExpressionEmpty(text === '');\n        if (expressionInputRef.current) {\n          expressionInputRef.current.textContent = text;\n        }\n        return;\n      }\n\n      // Suppress stale spinbutton callbacks during the transition;\n      // cleared after the rAF so undo calls are not blocked.\n      isSwitchingToExpressionRef.current = true;\n      // Update the backing value synchronously. If this waits for rAF, React 19\n      // can flush the previous ISO value first and rehydrate the cleared spin\n      // buttons before the expression input receives its fallback text.\n      setValue(newValue);\n      setExpressionEmpty(text === '');\n      setValueType('expression');\n      requestAnimationFrame(() => {\n        if (expressionInputRef.current) {\n          expressionInputRef.current.textContent = text;\n        }\n        isSwitchingToExpressionRef.current = false;\n      });\n    },\n    [expressionInputRef, precision, setValue, spinButtonHandlers, valueType],\n  );\n\n  // first initialization of the uncontrolled expression value on component mount\n  useEffect(() => {\n    if (isControlled || value?.type !== 'expression') {\n      return;\n    }\n    formatExpressionValue(value);\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  // if the spinbuttons are empty ...\n  useEffect(() => {\n    // Don't run the empty spinbutton check on component mount.\n    if (firstRun.current) {\n      firstRun.current = false;\n      return;\n    }\n\n    // ... switch to expression input\n    if (valueType === 'iso8601' && spinButtonsEmpty) {\n      // eslint-disable-next-line react-hooks/set-state-in-effect\n      resetToExpressionMode();\n\n      // wait until the expression input is visible to set the focus\n      setTimeout(() => {\n        expressionInputRef?.current?.focus();\n      });\n    }\n    // only react on empty state changes\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [spinButtonsEmpty]);\n\n  useEffect(() => {\n    if (valueType !== 'expression') {\n      return;\n    }\n\n    if (empty) {\n      // eslint-disable-next-line react-hooks/set-state-in-effect\n      setInputValue('');\n      return;\n    }\n\n    if (expressionInputRef.current?.textContent) {\n      setInputValue(expressionInputRef.current?.textContent); // fixes validating initial expression value in the DateTimeRangePicker\n    }\n    // valueType can be excluded because empty already depends on it\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [empty]);\n\n  return {\n    empty,\n    spinButtons,\n    spinButtonHandlers,\n    value,\n    valueType,\n    inputValue,\n    expressionInputHandler,\n    expressionOnFocusHandler,\n    expressionOnBlurHandler,\n    expressionOnKeyDownHandler,\n    onPaste,\n    pasteText,\n    onPasteUndoKeyDown,\n    clearPasteUndo: () => {\n      pasteUndoRef.current = null;\n    },\n    focus,\n    switchToExpressionMode,\n    setInputValue,\n  };\n};\n"],
+  "sourcesContent": ["import { TZDateMini } from '@date-fns/tz';\nimport {\n  ClipboardEventHandler,\n  FocusEventHandler,\n  FocusEvent as ReactFocusEvent,\n  ReactEventHandler,\n  KeyboardEventHandler as ReactKeyboardEventHandler,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type RefObject,\n} from 'react';\n\nimport {\n  _parseTimeExpression,\n  parseTimeAsTimeValue,\n} from '@dynatrace-sdk/units';\nimport { getTimezone } from '@dynatrace-sdk/user-preferences';\n\nimport { useDateTimeParser } from './useDateTimeParser.js';\nimport { spinExpressionValue } from './useExpressionSpin.js';\nimport { useAriaLabelingProps } from '../../../core/hooks/useAriaLabelingProps.js';\nimport { useControllableState } from '../../../core/hooks/useControllableState.js';\nimport { isEqualTimeValue } from '../../../core/time/helpers.js';\nimport { useDateTimePickerStore } from '../../../core/time/timeframeStore/useTimeframeStore.js';\nimport type { TimeValue } from '../../../core/types/time.js';\nimport { useDateTimePicker } from '../../date-time-picker/hooks/useDateTimePicker.js';\nimport {\n  formatTimeValue,\n  getTimeValue,\n} from '../../forms-core/time/timeParser.js';\nimport { useSelection } from '../../spin-buttons/hooks/useSelection.js';\nimport type { NumberSpinButtonRef } from '../../spin-buttons/number-spin-button/types.js';\nimport type { SpinButtonHandler } from '../../spin-buttons/spin-button-group/types.js';\nimport {\n  captureUndoSnapshot,\n  isContentModifyingKey,\n  normalizeISOInput,\n  parseDateOnlyToISO,\n  parseTimeOnlyToISO,\n  partialDateTimeToISO,\n  tryParsePartialDate,\n  tryParsePartialTime,\n} from '../helpers.js';\nimport {\n  getExpressionCursorOffset,\n  restoreExpressionCursorOffset,\n} from '../selection-helpers.js';\nimport type { DateTimeInputProps, UndoSnapshot } from '../types.js';\n\nfunction isNumberSpinButton(\n  handler: SpinButtonHandler | undefined,\n): handler is NumberSpinButtonRef {\n  return handler?.type === 'number';\n}\n\nconst DATE_PART_TYPES: Set<Intl.DateTimeFormatPart['type']> = new Set([\n  'day',\n  'month',\n  'year',\n]);\nconst TIME_PART_TYPES: Set<Intl.DateTimeFormatPart['type']> = new Set([\n  'hour',\n  'minute',\n  'second',\n  'fractionalSecond',\n  'dayPeriod',\n]);\n\n/**\n * Inserts plain text at the current cursor position, replacing any active selection.\n */\nconst insertTextAtCursor = (text: string) => {\n  const selection = window.getSelection();\n  if (selection?.rangeCount) {\n    const range = selection.getRangeAt(0);\n    range.deleteContents();\n    const textNode = document.createTextNode(text);\n    range.insertNode(textNode);\n    range.setStartAfter(textNode);\n    range.collapse(true);\n    selection.removeAllRanges();\n    selection.addRange(range);\n  }\n};\n\n/**\n * Returns true when at least one non-literal spin button is empty.\n */\nconst hasAnyEmptySpinButton = (\n  handlersRef: RefObject<\n    Map<\n      keyof Intl.DateTimeFormatPartTypesRegistry,\n      SpinButtonHandler | null | undefined\n    >\n  >,\n): boolean =>\n  Array.from(handlersRef.current?.entries() ?? []).some(\n    ([type, handler]) =>\n      handler &&\n      type !== 'literal' &&\n      handler.element.current?.textContent === '',\n  );\n\n/**\n * Pastes text into the expression contenteditable span, either at the cursor\n * position (when the selection is inside the span) or by replacing its content.\n */\nconst pasteIntoExpressionInput = (\n  element: RefObject<HTMLSpanElement | null>,\n  text: string,\n): void => {\n  if (element.current) {\n    const selection = window.getSelection();\n    const range = selection?.rangeCount ? selection.getRangeAt(0) : null;\n\n    if (\n      range &&\n      element.current.contains(range.startContainer) &&\n      element.current.contains(range.endContainer)\n    ) {\n      insertTextAtCursor(text);\n    } else {\n      element.current.textContent = text;\n      moveCursorToEnd(element.current);\n    }\n\n    element.current.dispatchEvent(new InputEvent('input', { bubbles: true }));\n  }\n};\n\n/**\n * Moves the cursor (selection) to the end of the given element's content.\n */\nconst moveCursorToEnd = (element: HTMLSpanElement | null | undefined) => {\n  if (element) {\n    const range = document.createRange();\n    const selection = window.getSelection();\n    range.selectNodeContents(element);\n    range.collapse(false);\n    selection?.removeAllRanges();\n    selection?.addRange(range);\n  }\n};\n\n/*\n * A hook that provides the default functionality for the DateTimeInput picker\n */\nexport const useDateTimeInput = (\n  props: DateTimeInputProps,\n  expressionInputRef: RefObject<HTMLSpanElement | null>,\n) => {\n  const {\n    disabled,\n    readOnly,\n    type,\n    onChange,\n    onLeadingEdge,\n    onTrailingEdge,\n    dateOnlyPasteAnchor = 'startOfDay',\n    onPasteComplete,\n    partialTimeAnchorDate,\n  }: DateTimeInputProps = props;\n  const precision = useDateTimePickerStore((state) =>\n    state.precision !== 'day' ? state.precision : 'milliseconds',\n  );\n\n  const ariaProps = useAriaLabelingProps(props);\n  const { regexDateTimeStart, maxValue, types } = useDateTimeParser({\n    type,\n  });\n  // ? INVESTIGATE: without the generic, building the visreg story viewer and unit-test typechecking fails,\n  // ? but the components:build target still succeeds without any issues -> why?\n  const [value, setValue] = useControllableState<TimeValue | null>(props);\n  const isControlled = props.value !== undefined;\n  const [valueType, setValueType] = useState(value?.type ?? 'expression');\n  const firstRun = useRef(true);\n  // Tracks the previous value content so that a parent re-render that passes a\n  // new object reference with the same content does not trigger formatExpressionValue\n  // and reset DOM edits that haven't propagated through React state yet.\n  const prevValueRef = useRef<TimeValue | null | undefined>(undefined);\n  const [expressionEmpty, setExpressionEmpty] = useState(\n    !expressionInputRef.current?.textContent,\n  );\n  const [inputValue, setInputValue] = useState('');\n  // Skips no-op setInputValue calls in the [value] effect. Passive-effect\n  // writes that React can't bail out on schedule SyncLane commits that\n  // accumulate on rapid keypresses.\n  const lastInputValueRef = useRef(inputValue);\n  lastInputValueRef.current = inputValue;\n  const pasteUndoRef = useRef<{\n    snapshot: UndoSnapshot;\n    focusTarget: Element | null;\n    expressionCursorOffset?: number;\n  } | null>(null);\n\n  useEffect(() => {\n    return () => {\n      pasteUndoRef.current = null;\n    };\n  }, []);\n\n  // Tracks the last valid absoluteDate to pass a stable, parseable ISO string\n  // to useDateTimePicker while props.value temporarily has absoluteDate:'' during\n  // partial spinbutton editing. Keeps useDateTimePicker.value prop unchanged so\n  // its internal useEffect doesn't re-run and clear the spinbuttons.\n  const lastValidAbsoluteDateRef = useRef<string | null>(\n    value?.type === 'iso8601' && value.absoluteDate ? value.absoluteDate : null,\n  );\n  // True only during the requestAnimationFrame window opened by switchToExpressionMode.\n  // Used to suppress stale spinbutton onChange callbacks that fire while the mode\n  // transition is in flight, without blocking legitimate restore/undo calls.\n  const isSwitchingToExpressionRef = useRef(false);\n\n  // Use valueType (local state) not value.type (controlled prop) as the gate \u2014\n  // the controlled prop can temporarily become type:'expression' when the store\n  // echoes back a partial invalid value for validation while we're still in\n  // spinbutton mode.\n  if (\n    valueType === 'iso8601' &&\n    value?.type === 'iso8601' &&\n    value.absoluteDate\n  ) {\n    lastValidAbsoluteDateRef.current = value.absoluteDate;\n  }\n  const spinButtonValue =\n    valueType === 'iso8601' ? lastValidAbsoluteDateRef.current : null;\n\n  // Stores the date parts filled in by a partial paste so the focus can target\n  // the first spin button that was not filled.\n  const pendingFocusPartsRef = useRef<Set<\n    keyof Intl.DateTimeFormatPartTypesRegistry\n  > | null>(null);\n\n  const {\n    spinButtons,\n    handlers: spinButtonHandlers,\n    empty: spinButtonsEmpty,\n    applyDateTime,\n    firstSpinButtonHandler,\n  } = useDateTimePicker({\n    type,\n    precision,\n    disabled,\n    readOnly,\n    valueType,\n    value: spinButtonValue,\n    onChange: (newIsoDateTime) => {\n      const newValue = getTimeValue(newIsoDateTime ?? undefined, precision);\n\n      if (newValue === null || newValue === undefined) {\n        return;\n      }\n\n      // Suppress stale spinbutton callbacks that fire while switchToExpressionMode\n      // is transitioning. Any other caller (e.g. undo restore) is allowed through.\n      if (isSwitchingToExpressionRef.current) {\n        return;\n      }\n\n      if (expressionInputRef.current) {\n        expressionInputRef.current.textContent = '';\n      }\n\n      // If undo (or another caller) pushes a value while we're in expression mode,\n      // switch back to spinbutton mode now.\n      if (valueType !== 'iso8601') {\n        setValueType('iso8601');\n      }\n\n      // Forward invalid values (empty string or unparseable partial locale string)\n      // to onChange so the store validates and shows errors, but skip setValue so\n      // props.value stays stable and spinbuttons are not cleared.\n      if (newIsoDateTime === '' || newValue?.absoluteDate === '') {\n        onChange?.(newValue);\n        return;\n      }\n\n      setInputValue(newValue.value);\n      // only update the value if the newTimeValue differs from the prev. one\n      setValue((prevValue) =>\n        isEqualTimeValue(prevValue, newValue) ? prevValue : newValue,\n      );\n    },\n    ...ariaProps,\n  });\n\n  const empty = useMemo(\n    () => (valueType === 'expression' ? expressionEmpty : spinButtonsEmpty),\n    [valueType, expressionEmpty, spinButtonsEmpty],\n  );\n\n  // Shared state reset when switching (back) to expression mode.\n  const resetToExpressionMode = useCallback(\n    (expressionEmpty = true) => {\n      setValueType('expression');\n      setValue(null);\n      setInputValue('');\n      setExpressionEmpty(expressionEmpty);\n      lastValidAbsoluteDateRef.current = null;\n    },\n    [setValue],\n  );\n\n  // Tracks the last absoluteDate seen by the controlled-value effect.\n  // Used to distinguish a genuine value re-application (absoluteDate changed,\n  // e.g. from '' back to a valid ISO string) from an outdated reference change\n  // (the store re-parsed a sibling field and created a new object with the\n  // same absoluteDate).\n  const prevAbsoluteDateRef = useRef<string | null>(null);\n\n  // Called on onBlur to sanitize the current expression. Declared here (before\n  // the [value] useEffect below) so that React Compiler's immutability analysis\n  // can confirm the reference is available at the time the effect is registered.\n  const formatExpressionValue = useCallback(\n    (value: TimeValue | null) => {\n      if (!expressionInputRef.current) {\n        return;\n      }\n      const formattedValue = value ? formatTimeValue(value) : '';\n      const currentValue = formatTimeValue(\n        expressionInputRef.current?.textContent ?? '',\n      );\n\n      // only update if the current value differs from the new value\n      // don't update the textnode while typing but allow e.g. pasting a new expression\n      if (currentValue !== formattedValue) {\n        expressionInputRef.current.textContent = formattedValue;\n      }\n    },\n    // no use in adding the expressionInputRef to the dep. array\n    // oxlint-disable-next-line react-hooks/exhaustive-deps\n    [],\n  );\n\n  // Keep a ref to the latest spinButtonHandlers so that focus helpers\n  // inside requestAnimationFrame always use the current map.\n  const spinButtonHandlersRef = useRef(spinButtonHandlers);\n  spinButtonHandlersRef.current = spinButtonHandlers;\n\n  // switch input mode based on controlled value change\n  useEffect(() => {\n    const prevValue = prevValueRef.current;\n    prevValueRef.current = value;\n\n    const applyInputValue = (next: string) => {\n      if (lastInputValueRef.current === next) {\n        return;\n      }\n      lastInputValueRef.current = next;\n      // oxlint-disable-next-line react-hooks/set-state-in-effect\n      setInputValue(next);\n    };\n\n    if (value?.type === 'iso8601' && !spinButtonsEmpty) {\n      applyInputValue(value.value);\n    }\n\n    // ignore if in uncontrolled mode\n    if (!isControlled || typeof value === 'string') {\n      return;\n    }\n\n    const prevAbsoluteDate = prevAbsoluteDateRef.current;\n    prevAbsoluteDateRef.current = value?.absoluteDate ?? null;\n\n    // reset input if value is null\n    if (!value) {\n      setValueType('expression');\n      formatExpressionValue(null);\n      const input = expressionInputRef.current?.textContent;\n      setExpressionEmpty(input === '');\n      applyDateTime(null);\n      lastValidAbsoluteDateRef.current = null;\n      return;\n    }\n\n    // Skip values with empty absoluteDate: partial/invalid intermediate states\n    // forwarded to the store for validation only. The spinbuttons manage their\n    // own display; reacting here would switch to 'expression' mode and call\n    // formatExpressionValue, clearing the display.\n    if (value.absoluteDate === '') {\n      return;\n    }\n\n    // apply value to expression\n    // the spinbutton update is handled within the useSpinButton hook internally\n    if (valueType !== value.type) {\n      setValueType(value.type);\n    }\n    applyInputValue(value.value);\n    if (value.type === 'expression') {\n      // Only reformat the DOM when the expression content has actually changed.\n      // A parent re-render that produces a new object reference with the same\n      // value (e.g. due to a sibling input's state update) must not overwrite\n      // DOM edits (e.g. partial cross-expression deletion) that haven't yet\n      // propagated back through React state.\n      if (!isEqualTimeValue(prevValue ?? null, value)) {\n        formatExpressionValue(value);\n      }\n      setExpressionEmpty(value.value === '');\n    } else if (\n      value.type === 'iso8601' &&\n      hasAnyEmptySpinButton(spinButtonHandlersRef) &&\n      prevAbsoluteDate !== value.absoluteDate\n    ) {\n      applyDateTime(value.absoluteDate);\n    }\n    // only react to outside value changes\n    // oxlint-disable-next-line react-hooks/exhaustive-deps\n  }, [value]);\n\n  // Focuses the first spin button that is still empty, or the last spin button when\n  // everything is filled in.\n  const focusFirstUnfilledSpinButton = useCallback(\n    (filledParts: Set<keyof Intl.DateTimeFormatPartTypesRegistry>) => {\n      const handlers = spinButtonHandlersRef.current;\n      for (const [type, handler] of handlers) {\n        if (\n          handler &&\n          type !== 'literal' &&\n          !filledParts.has(\n            type as keyof Intl.DateTimeFormatPartTypesRegistry,\n          ) &&\n          handler.element.current?.textContent === ''\n        ) {\n          handler.element.current?.focus();\n          return;\n        }\n      }\n      // Fallback: focus the last spin button when everything is filled.\n      let lastHandler: SpinButtonHandler | null = null;\n      for (const [, handler] of handlers) {\n        if (handler) {\n          lastHandler = handler;\n        }\n      }\n      lastHandler?.element?.current?.focus();\n    },\n    [],\n  );\n\n  // Focus the first unfilled spin button after a partial paste triggers a mode switch.\n  useEffect(() => {\n    const filledParts = pendingFocusPartsRef.current;\n    if (!filledParts || valueType !== 'iso8601') {\n      return;\n    }\n    pendingFocusPartsRef.current = null;\n\n    requestAnimationFrame(() => {\n      focusFirstUnfilledSpinButton(filledParts);\n    });\n  }, [valueType, focusFirstUnfilledSpinButton]);\n\n  const { selectAll: expressionInputSelectAll } =\n    useSelection(expressionInputRef);\n\n  // handles input events on the expression contenteditable span\n  const expressionInputHandler: ReactEventHandler<HTMLSpanElement> =\n    useCallback(() => {\n      if (!expressionInputRef.current) {\n        return;\n      }\n\n      const input = expressionInputRef.current.textContent ?? '';\n\n      // Remove <br> added by browser in contenteditable to ensure placeholder works\n      if (expressionInputRef.current.innerHTML === '<br>') {\n        expressionInputRef.current.innerHTML = '';\n      }\n\n      // fallback to expression if text content is removed\n      if (input === '') {\n        setValueType('expression');\n        setValue(null);\n        setExpressionEmpty(true);\n        return;\n      }\n\n      setExpressionEmpty(false);\n\n      // if the input starts like a valid datetime for the current locale, switch to the datetime picker\n      const [, carryOver] = regexDateTimeStart.exec(input) ?? [];\n      if (Number.parseInt(carryOver) <= maxValue) {\n        setValueType('iso8601');\n\n        // clear all spinbuttons\n        applyDateTime(null);\n        lastValidAbsoluteDateRef.current = null;\n\n        // get a cleaned and sorted list of spinbutton handlers\n        const sortedHandlers = types\n          .filter((type) => type !== 'literal')\n          .map((type) => spinButtonHandlers.get(type))\n          .filter(Boolean) as SpinButtonHandler[];\n        const [carryOverSB, focusSB] = sortedHandlers;\n\n        // carry over entered value to the next number spinbutton\n        isNumberSpinButton(carryOverSB) &&\n          carryOverSB.applyText(carryOver, true);\n\n        // clear expression input content\n        expressionInputRef.current.textContent = '';\n\n        // set focus after switch to expression mode happened\n        requestAnimationFrame(() => {\n          // set focus to second spinbutton\n          focusSB?.element.current?.focus();\n        });\n        return;\n      }\n\n      // If the user types a number followed by \":\", switch to the datetime picker\n      // with the anchor date pre-filled and the typed hour applied, then focus the\n      // minute spin button so the user can continue typing the time.\n      // The anchor date defaults to today but can be overridden via `partialTimeAnchorDate`\n      if (type !== 'date') {\n        const colonMatch = /^(\\d{1,2}):$/.exec(input);\n        if (colonMatch) {\n          const hour = Number.parseInt(colonMatch[1]);\n          if (hour <= 23) {\n            const base = partialTimeAnchorDate\n              ? new TZDateMini(partialTimeAnchorDate, getTimezone())\n              : TZDateMini.tz(getTimezone());\n            const iso = TZDateMini.tz(\n              getTimezone(),\n              base.getFullYear(),\n              base.getMonth(),\n              base.getDate(),\n              hour,\n              0,\n              0,\n              0,\n            ).toISOString();\n\n            const partsToUpdate = new Set<\n              keyof Intl.DateTimeFormatPartTypesRegistry\n            >(['day', 'month', 'year', 'hour']);\n\n            setValueType('iso8601');\n            expressionInputRef.current.textContent = '';\n            applyDateTime(iso, partsToUpdate);\n\n            requestAnimationFrame(() => {\n              focusFirstUnfilledSpinButton(partsToUpdate);\n            });\n            return;\n          }\n        }\n      }\n\n      // If the copied text contains the formatted date in the user's locale (e.g.,\n      // \"12/24/2024\" or \"25.12.2024\"), switch to iso8601 mode and apply the parsed date\n      // fields to the spin buttons.\n      const typedPartialDate = tryParsePartialDate(input);\n      if (typedPartialDate) {\n        const dateResult = partialDateTimeToISO(typedPartialDate, null);\n        if (dateResult) {\n          setValueType('iso8601');\n          expressionInputRef.current.textContent = '';\n          applyDateTime(dateResult.iso, dateResult.partsToUpdate);\n\n          requestAnimationFrame(() =>\n            focusFirstUnfilledSpinButton(dateResult.partsToUpdate ?? new Set()),\n          );\n          return;\n        }\n      }\n\n      // if input is a valid expression, update the internal value state\n      const newValue = getTimeValue(input, precision) ?? null;\n\n      if (newValue?.absoluteDate === '') {\n        onChange?.(newValue);\n      }\n      // only update the value if the newTimeValue differs from the prev. one\n      setValue((prevValue) =>\n        isEqualTimeValue(prevValue, newValue) ? prevValue : newValue,\n      );\n\n      setInputValue(input);\n    }, [\n      expressionInputRef,\n      regexDateTimeStart,\n      maxValue,\n      partialTimeAnchorDate,\n      precision,\n      type,\n      setValue,\n      applyDateTime,\n      focusFirstUnfilledSpinButton,\n      types,\n      spinButtonHandlers,\n      onChange,\n    ]);\n\n  // select expression text content on focus\n  const expressionOnFocusHandler: FocusEventHandler<HTMLSpanElement> =\n    useCallback(\n      (event: ReactFocusEvent<HTMLSpanElement>) => {\n        // If the current selection spans multiple nodes (e.g. a drag-select or\n        // Cmd+A across multiple spin buttons / expression inputs), don't collapse\n        // it to just this expression input.\n        const selection = window.getSelection();\n        const selectionSpansMultipleNodes =\n          selection !== null &&\n          selection.anchorNode !== selection.focusNode &&\n          selection.toString().length > 0;\n\n        // Also skip if we are in the middle of a programmatic focus + setBaseAndExtent\n        // (guarded by data-restoring-selection on the .strato-inputgroup root).\n        const isRestoringSelection =\n          (event.target as HTMLElement)\n            .closest('.strato-inputgroup')\n            ?.hasAttribute('data-restoring-selection') ?? false;\n\n        // Skip if the user already has a non-collapsed selection inside this\n        // expression input (e.g. drag-select or Shift+arrow within one field).\n        // Calling selectAll() here would override that intended partial selection.\n        const expressionInputEl = event.target as HTMLElement;\n        const hasPartialSelectionWithin =\n          selection !== null &&\n          !selection.isCollapsed &&\n          expressionInputEl.contains(selection.anchorNode) &&\n          expressionInputEl.contains(selection.focusNode);\n\n        if (\n          selectionSpansMultipleNodes ||\n          isRestoringSelection ||\n          hasPartialSelectionWithin\n        ) {\n          return;\n        }\n\n        expressionInputSelectAll();\n      },\n      [expressionInputSelectAll],\n    );\n\n  // sanitize textnode if content is an expression\n  const expressionOnBlurHandler: FocusEventHandler<HTMLSpanElement> =\n    useCallback(() => {\n      if (expressionInputRef.current && value?.type === 'expression') {\n        const currentExpressionInput =\n          expressionInputRef.current.textContent ?? '';\n        const isValidExpression = _parseTimeExpression(\n          currentExpressionInput.trim(),\n        );\n\n        if (isValidExpression) {\n          expressionInputRef.current.textContent = formatTimeValue(value);\n        }\n      }\n\n      // eslint annoyingly wants to add the ref to the dependency list\n      // oxlint-disable-next-line react-hooks/exhaustive-deps\n    }, [value]);\n\n  // Shared paste logic used by both the DOM paste event handler and the\n  // imperative pasteText method on DateTimeInputRef. Returns true when the\n  // paste was handled (caller should preventDefault), false to let native\n  // paste proceed (step 4: digits in iso8601 mode).\n  const pasteText = useCallback(\n    (text: string, skipUndoCapture = false): boolean => {\n      if (readOnly) {\n        return false;\n      }\n\n      let trimmedData = normalizeISOInput(text.trim());\n      if (!trimmedData) {\n        return true;\n      }\n\n      // Pre-parse locale-specific partial date/time for normalization and step 5.\n      const partialDate = tryParsePartialDate(trimmedData);\n      const partialTime = tryParsePartialTime(trimmedData);\n      const partialResult =\n        partialDate || partialTime\n          ? partialDateTimeToISO(partialDate, partialTime)\n          : null;\n\n      // When the result is complete (no partsToUpdate), normalize to ISO so\n      // the existing ISO checks (steps 1\u20133) can handle it.\n      if (partialResult && !partialResult.partsToUpdate) {\n        trimmedData = partialResult.iso;\n      }\n\n      // Capture undo snapshot before any state mutations unless the caller\n      // already owns the snapshot (e.g. range-level paste handler).\n      if (!skipUndoCapture) {\n        const snapshot = captureUndoSnapshot(\n          spinButtonHandlers,\n          expressionInputRef.current,\n          value,\n          valueType,\n        );\n\n        pasteUndoRef.current = {\n          snapshot,\n          focusTarget: document.activeElement,\n          expressionCursorOffset: expressionInputRef.current\n            ? getExpressionCursorOffset(expressionInputRef.current)\n            : undefined,\n        };\n      }\n\n      // 1. Date-only paste (e.g. \"2025-01-01\")\n      // 2. Time-only paste (e.g. \"02:00Z\", \"14:30:00\")\n      const dateOnly = parseDateOnlyToISO(trimmedData, dateOnlyPasteAnchor);\n      const timeOnly = parseTimeOnlyToISO(trimmedData);\n      const date = dateOnly ?? timeOnly;\n\n      if (date) {\n        setValueType('iso8601');\n        // When spinbuttons are empty (expression mode), apply all parts so the\n        // full date is filled in.  When parts are already populated, only\n        // overwrite the date or time group that matches the pasted value.\n        let partsFilter: Set<Intl.DateTimeFormatPart['type']> | undefined;\n        if (!spinButtonsEmpty) {\n          partsFilter = dateOnly ? DATE_PART_TYPES : TIME_PART_TYPES;\n        }\n        applyDateTime(date, partsFilter);\n\n        // When only a subset of parts was applied, focus the first empty spin\n        // button instead of advancing. When all parts were applied skip the check.\n        if (partsFilter && hasAnyEmptySpinButton(spinButtonHandlersRef)) {\n          focusFirstUnfilledSpinButton(partsFilter);\n        } else {\n          onPasteComplete?.();\n        }\n\n        return true;\n      }\n\n      // 3. Full ISO datetime or expression (e.g. \"2025-01-01T02:00Z\", \"now()-1h\")\n      const nextValue = parseTimeAsTimeValue(\n        trimmedData,\n        TZDateMini.tz(getTimezone()).getTime(),\n        precision,\n      );\n\n      if (nextValue) {\n        setValueType(nextValue.type);\n        if (nextValue.type === 'expression') {\n          formatExpressionValue(nextValue);\n          moveCursorToEnd(expressionInputRef.current);\n          setValue(nextValue);\n        } else {\n          applyDateTime(nextValue.absoluteDate);\n        }\n        onPasteComplete?.();\n        return true;\n      }\n\n      // 4. Allow numbers to be pasted into the spin buttons\n      if (valueType === 'iso8601' && /^\\d+$/.test(trimmedData)) {\n        return false;\n      }\n\n      // 5. Partial date/time paste (e.g. \"25.12\", \"14:30\", \"25.12.2024 14:30\")\n      // partialResult was pre-computed above the ISO checks.\n      if (partialResult?.partsToUpdate) {\n        const { iso, partsToUpdate } = partialResult;\n        setValueType('iso8601');\n        applyDateTime(iso, partsToUpdate);\n\n        // Clear any spin button that was not explicitly present in the pasted\n        // text (i.e. was a placeholder token or simply absent). This ensures\n        // paste always overwrites: fields not carried by the pasted value are\n        // emptied rather than left at their previous content.\n        for (const [key, handler] of spinButtonHandlersRef.current) {\n          if (handler && !partsToUpdate.has(key)) {\n            handler.clearValue(true);\n          }\n        }\n\n        if (hasAnyEmptySpinButton(spinButtonHandlersRef)) {\n          requestAnimationFrame(() => {\n            focusFirstUnfilledSpinButton(partsToUpdate);\n          });\n        } else {\n          onPasteComplete?.();\n        }\n\n        return true;\n      }\n\n      // 6. Fallback: switch to expression mode and paste the raw string.\n      if (valueType === 'expression') {\n        if (expressionInputRef.current) {\n          pasteIntoExpressionInput(expressionInputRef, trimmedData);\n        }\n      } else {\n        setValueType('expression');\n        if (expressionInputRef.current) {\n          expressionInputRef.current.textContent = trimmedData;\n          expressionInputRef.current.focus();\n          moveCursorToEnd(expressionInputRef.current);\n          expressionInputRef.current.dispatchEvent(\n            new InputEvent('input', { bubbles: true }),\n          );\n        }\n      }\n\n      return true;\n    },\n    [\n      readOnly,\n      spinButtonHandlers,\n      expressionInputRef,\n      value,\n      dateOnlyPasteAnchor,\n      precision,\n      valueType,\n      setValue,\n      onPasteComplete,\n      formatExpressionValue,\n      applyDateTime,\n      spinButtonsEmpty,\n      focusFirstUnfilledSpinButton,\n    ],\n  );\n\n  // clipboard paste handler. apply clipboard content if formatted correctly\n  const onPaste: ClipboardEventHandler<HTMLSpanElement> = useCallback(\n    (event) => {\n      const data = event.clipboardData?.getData('text/plain');\n      if (!data) {\n        event.preventDefault();\n        return;\n      }\n      if (pasteText(data)) {\n        event.preventDefault();\n      }\n    },\n    [pasteText],\n  );\n\n  // Ctrl+Z / Cmd+Z handler to undo a paste operation.\n  const onPasteUndoKeyDown: ReactKeyboardEventHandler<HTMLSpanElement> =\n    useCallback(\n      (event) => {\n        const isCtrlZ = (event.ctrlKey || event.metaKey) && event.key === 'z';\n\n        if (!isCtrlZ) {\n          // Invalidates the paste snapshot for any other input.\n          if (pasteUndoRef.current && isContentModifyingKey(event)) {\n            pasteUndoRef.current = null;\n          }\n          return;\n        }\n\n        if (!pasteUndoRef.current) {\n          // No paste to undo \u2014 block native browser contenteditable undo.\n          event.preventDefault();\n          event.stopPropagation();\n          return;\n        }\n\n        const { snapshot, focusTarget, expressionCursorOffset } =\n          pasteUndoRef.current;\n        pasteUndoRef.current = null;\n\n        event.preventDefault();\n        event.stopPropagation();\n\n        // Restore value type first so the correct UI mode is rendered.\n        setValueType(snapshot.valueType);\n\n        if (snapshot.valueType === 'iso8601') {\n          // Restore spin button values from the snapshot.\n          snapshot.spinButtonTexts.forEach((text, type) => {\n            const handler = spinButtonHandlers.get(type) ?? null;\n            if (!handler) {\n              return;\n            }\n            if (text === '') {\n              handler.clearValue(true);\n            } else if (handler.type === 'number') {\n              handler.applyText(text, true);\n            } else {\n              handler.searchValue(text[0] ?? '', true);\n            }\n          });\n        } else {\n          // Restore expression text content.\n          if (expressionInputRef.current) {\n            expressionInputRef.current.textContent = snapshot.expressionText;\n          }\n          setExpressionEmpty(snapshot.expressionText === '');\n        }\n\n        setValue(snapshot.value);\n        setInputValue(snapshot.value?.value ?? '');\n\n        requestAnimationFrame(() => {\n          // Restore focus after the mode-switch re-render.\n          if (\n            focusTarget instanceof HTMLElement &&\n            focusTarget !== document.activeElement\n          ) {\n            focusTarget.focus();\n          }\n\n          // Restore cursor position in the expression input\n          if (\n            snapshot.valueType === 'expression' &&\n            expressionCursorOffset !== undefined &&\n            expressionInputRef.current\n          ) {\n            restoreExpressionCursorOffset(\n              expressionInputRef.current,\n              expressionCursorOffset,\n            );\n          }\n        });\n      },\n      [\n        spinButtonHandlers,\n        expressionInputRef,\n        setValue,\n        setValueType,\n        setExpressionEmpty,\n        setInputValue,\n      ],\n    );\n\n  // Handle keyboard events on the expression input: prevent Enter and spin on ArrowUp/ArrowDown\n  const expressionOnKeyDownHandler: ReactKeyboardEventHandler<HTMLSpanElement> =\n    useCallback(\n      (event) => {\n        if (event.key === 'Enter') {\n          event.preventDefault();\n          return;\n        }\n\n        if (\n          onLeadingEdge &&\n          event.key === 'Backspace' &&\n          (expressionInputRef.current?.textContent ?? '') === ''\n        ) {\n          event.preventDefault();\n          requestAnimationFrame(() => onLeadingEdge?.());\n          return;\n        }\n\n        if (\n          onTrailingEdge &&\n          event.key === 'Delete' &&\n          (expressionInputRef.current?.textContent ?? '') === ''\n        ) {\n          event.preventDefault();\n          requestAnimationFrame(() => onTrailingEdge?.());\n          return;\n        }\n\n        if (event.key === 'ArrowLeft' && onLeadingEdge) {\n          const selection = window.getSelection();\n          // If cursor is at the start (offset 0), navigate to the previous input\n          if (selection?.anchorOffset === 0 && selection?.focusOffset === 0) {\n            onLeadingEdge();\n            event.preventDefault();\n            return;\n          }\n        }\n\n        if (event.key === 'ArrowRight') {\n          const selection = window.getSelection();\n          const textContent = expressionInputRef.current?.textContent ?? '';\n          // If cursor is at the end, navigate to the next input\n          if (selection?.anchorOffset === textContent.length) {\n            onTrailingEdge?.();\n            event.preventDefault();\n            return;\n          }\n        }\n\n        if (\n          (event.key === 'ArrowUp' || event.key === 'ArrowDown') &&\n          !disabled &&\n          !readOnly\n        ) {\n          const element = expressionInputRef.current;\n          if (!element) {\n            return;\n          }\n\n          const currentText = element.textContent ?? '';\n          if (!currentText.trim()) {\n            return;\n          }\n\n          const direction: 1 | -1 = event.key === 'ArrowUp' ? 1 : -1;\n          const newText = spinExpressionValue(currentText, direction);\n\n          if (newText === null) {\n            return;\n          }\n\n          event.preventDefault();\n\n          // Preserve cursor position\n          const selection = window.getSelection();\n          const cursorOffset = selection?.focusOffset ?? 0;\n\n          // Update the text content and fire the input handler\n          element.textContent = newText;\n\n          // Restore cursor position (clamped to new text length)\n          requestAnimationFrame(() => {\n            const textNode = element.firstChild;\n            if (textNode && selection) {\n              const newOffset = Math.min(cursorOffset, newText.length);\n              const range = document.createRange();\n              range.setStart(textNode, newOffset);\n              range.collapse(true);\n              selection.removeAllRanges();\n              selection.addRange(range);\n            }\n          });\n\n          // Trigger the input handler to propagate the value change\n          element.dispatchEvent(new Event('input', { bubbles: true }));\n        }\n      },\n      [onLeadingEdge, expressionInputRef, disabled, readOnly, onTrailingEdge],\n    );\n\n  // focus the first spinbutton or the expression input based on the current input mode\n  const focus = useCallback(() => {\n    switch (valueType) {\n      case 'expression':\n        expressionInputRef.current?.focus();\n        break;\n      case 'iso8601':\n        firstSpinButtonHandler?.element?.current?.focus();\n        break;\n    }\n    // no need to pass the refs as dependency\n    // oxlint-disable-next-line react-hooks/exhaustive-deps\n  }, [valueType, firstSpinButtonHandler]);\n\n  /**\n   * Clears all spin buttons, switches to expression mode, and seeds the\n   * expression input with the provided text. Used when a bulk-delete leaves\n   * exactly one spin button filled \u2014 that remaining value is carried over as\n   * the expression seed rather than leaving a partial date.\n   */\n  const switchToExpressionMode = useCallback(\n    (text: string) => {\n      // setExpressionValue is an imperative expression-mode transition. Do not\n      // parse the text through getTimeValue here: numeric fallback text such as\n      // \"01\" can otherwise be treated as an ISO value and switch the input back\n      // to spin-button mode while a bulk clear is still settling.\n      const parsedValue = parseTimeAsTimeValue(\n        text,\n        TZDateMini.tz(getTimezone()).getTime(),\n        precision,\n      );\n      const newValue: TimeValue | null =\n        text !== ''\n          ? {\n              absoluteDate: parsedValue?.absoluteDate ?? '',\n              value: text,\n              type: 'expression',\n            }\n          : null;\n\n      for (const handler of spinButtonHandlers.values()) {\n        handler?.clearValue(false);\n        if (handler?.element.current) {\n          handler.element.current.textContent = '';\n        }\n      }\n\n      setInputValue(text);\n\n      if (valueType === 'expression') {\n        // Already in expression mode \u2014 apply synchronously so the next\n        // keypress is not dropped by a deferred rAF write.\n        setValue(newValue);\n        setExpressionEmpty(text === '');\n        if (expressionInputRef.current) {\n          expressionInputRef.current.textContent = text;\n        }\n        return;\n      }\n\n      // Suppress stale spinbutton callbacks during the transition;\n      // cleared after the rAF so undo calls are not blocked.\n      isSwitchingToExpressionRef.current = true;\n      // Update the backing value synchronously. If this waits for rAF, React 19\n      // can flush the previous ISO value first and rehydrate the cleared spin\n      // buttons before the expression input receives its fallback text.\n      setValue(newValue);\n      setExpressionEmpty(text === '');\n      setValueType('expression');\n      requestAnimationFrame(() => {\n        if (expressionInputRef.current) {\n          expressionInputRef.current.textContent = text;\n        }\n        isSwitchingToExpressionRef.current = false;\n      });\n    },\n    [expressionInputRef, precision, setValue, spinButtonHandlers, valueType],\n  );\n\n  // first initialization of the uncontrolled expression value on component mount\n  useEffect(() => {\n    if (isControlled || value?.type !== 'expression') {\n      return;\n    }\n    formatExpressionValue(value);\n    // oxlint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  // if the spinbuttons are empty ...\n  useEffect(() => {\n    // Don't run the empty spinbutton check on component mount.\n    if (firstRun.current) {\n      firstRun.current = false;\n      return;\n    }\n\n    // ... switch to expression input\n    if (valueType === 'iso8601' && spinButtonsEmpty) {\n      // eslint-disable-next-line react-hooks/set-state-in-effect\n      resetToExpressionMode();\n\n      // wait until the expression input is visible to set the focus\n      setTimeout(() => {\n        expressionInputRef?.current?.focus();\n      });\n    }\n    // only react on empty state changes\n    // oxlint-disable-next-line react-hooks/exhaustive-deps\n  }, [spinButtonsEmpty]);\n\n  useEffect(() => {\n    if (valueType !== 'expression') {\n      return;\n    }\n\n    if (empty) {\n      // eslint-disable-next-line react-hooks/set-state-in-effect\n      setInputValue('');\n      return;\n    }\n\n    if (expressionInputRef.current?.textContent) {\n      setInputValue(expressionInputRef.current?.textContent); // fixes validating initial expression value in the DateTimeRangePicker\n    }\n    // valueType can be excluded because empty already depends on it\n    // oxlint-disable-next-line react-hooks/exhaustive-deps\n  }, [empty]);\n\n  return {\n    empty,\n    spinButtons,\n    spinButtonHandlers,\n    value,\n    valueType,\n    inputValue,\n    expressionInputHandler,\n    expressionOnFocusHandler,\n    expressionOnBlurHandler,\n    expressionOnKeyDownHandler,\n    onPaste,\n    pasteText,\n    onPasteUndoKeyDown,\n    clearPasteUndo: () => {\n      pasteUndoRef.current = null;\n    },\n    focus,\n    switchToExpressionMode,\n    setInputValue,\n  };\n};\n"],
   "mappings": "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",
   "names": ["expressionEmpty", "value", "type"]
 }

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

@@ -68,7 +68,7 @@ function useInternalFormRegistration(options) {
     );
   };
   const resolvedId = id ?? formFieldContext.formFieldId ?? // DEPRECATION: APPDEV-18319 - Remove deprecated `controlId`.
-  // eslint-disable-next-line @typescript-eslint/no-deprecated
+  // oxlint-disable-next-line typescript/no-deprecated
   formFieldContext.controlId ?? generatedId;
   const wrappedValidateField = useCallback(
     async (validateOptions) => {

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-1 {
+._1dphm0f0-3-13-0 {
   appearance: none;
   margin: 0;
   border: none;
@@ -6,7 +6,7 @@
   min-width: 0;
   min-height: 0;
 }
-._1dphm0f1-3-12-1 {
+._1dphm0f1-3-13-0 {
   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-1";
-var legend = "_1dphm0f1-3-12-1";
+var fieldset = "_1dphm0f0-3-13-0";
+var legend = "_1dphm0f1-3-13-0";
 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-1';\nexport var legend = '_1dphm0f1-3-12-1';"],
+  "sourcesContent": ["import './FieldSet.css';\nexport var fieldset = '_1dphm0f0-3-13-0';\nexport var legend = '_1dphm0f1-3-13-0';"],
   "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,