@dynatrace/strato-components 3.9.0 → 3.10.1

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/forms/date-time-range-picker/useSelectionInteractionHandlers.ts"],
-  "sourcesContent": ["import {\n  useCallback,\n  useRef,\n  type ClipboardEvent as ReactClipboardEvent,\n  type MouseEvent as ReactMouseEvent,\n  type KeyboardEvent as ReactKeyboardEvent,\n  type RefObject,\n} from 'react';\n\nimport { isExpressionTriggerKey } from './expression-trigger-helpers.js';\nimport { buildTimeframeClipboardText } from './selection-copy-helpers.js';\nimport {\n  extendSelection,\n  extendSelectionToAll,\n  removeContentEditable,\n  getFirstSnapshotHandler,\n  findFirstExpressionFocusTarget,\n  restoreFocusAfterBulkClear,\n  planBulkClear,\n  getPartialExpressionElement,\n  deletePartialExpression,\n  getCrossExpressionElements,\n  deleteCrossExpressionPartial,\n  consumePreRestoreEndpoints,\n  getLastSnapshotHandler,\n} from './selection-helpers.js';\nimport type { DateTimeInputRef } from './types.js';\n\n/**\n * Builds an array of input references from the given refs.\n * @internal\n */\nfunction getInputRefs(\n  dateInputFromRef: RefObject<DateTimeInputRef>,\n  dateInputToRef?: RefObject<DateTimeInputRef>,\n): RefObject<DateTimeInputRef>[] {\n  return [dateInputFromRef, ...(dateInputToRef ? [dateInputToRef] : [])];\n}\n\n/**\n * Hook that provides interaction handlers for selection behavior in date/time pickers.\n * Manages mouse and keyboard interactions including text selection and focus management.\n *\n * @param touchedContainerRef - Reference to the container that should be checked when forwarding focus\n * @param onFocusInput - Callback to focus the appropriate input(s) when needed\n * @param dateInputFromRef - Reference to the \"from\" DateTimeInput imperative handle\n * @param dateInputToRef - Reference to the optional \"to\" DateTimeInput imperative handle\n * @returns Object containing onMouseDown, onKeyDown and onCutCapture event handlers\n *\n * @internal\n */\nexport function useSelectionInteractionHandlers(\n  touchedContainerRef: RefObject<HTMLElement>,\n  onFocusInput: () => void,\n  dateInputFromRef: RefObject<DateTimeInputRef>,\n  dateInputToRef?: RefObject<DateTimeInputRef>,\n): {\n  onMouseDown: (event: ReactMouseEvent<HTMLDivElement>) => void;\n  onKeyDown: (event: ReactKeyboardEvent<HTMLDivElement>) => void;\n  onContextMenu: (event: ReactMouseEvent<HTMLDivElement>) => void;\n  onCutCapture: (event: ReactClipboardEvent<HTMLDivElement>) => void;\n} {\n  // Snapshot the selection at contextmenu time so that\n  // onCutCapture can restore it before running the deletion logic.\n  const contextMenuSelectionRef = useRef<Range | null>(null);\n\n  const onMouseDown = useCallback(\n    (event: ReactMouseEvent<HTMLDivElement>) => {\n      if (event.button !== 0) {\n        return;\n      }\n      // A new left-click starts a new selection; discard any stale contextmenu snapshot\n      // and pre-restore endpoints\n      contextMenuSelectionRef.current = null;\n      consumePreRestoreEndpoints(event.currentTarget);\n      // Only compute the anchor spinbutton for clicks in empty space (not on\n      // a spinbutton element itself). For direct spinbutton clicks the browser's\n      // native anchor is correct and must be preserved for single-element\n      // intra-spinbutton drag to work normally.\n      const root: HTMLElement = event.currentTarget;\n      const triggerElement = event.target;\n      const clickedOnSpinButton =\n        triggerElement instanceof HTMLElement &&\n        triggerElement.hasAttribute('contenteditable');\n      let initialAnchorSpinButton: HTMLElement | null = null;\n      if (!clickedOnSpinButton) {\n        const spinButtons = Array.from(\n          root.querySelectorAll<HTMLElement>('[contenteditable]'),\n        );\n        // Find the rightmost spinbutton whose right edge is at or before the\n        // click x \u2014 that is the spinbutton the drag started on (or the last\n        // one to its left when clicking in empty space).\n        let bestRight = -Infinity;\n        for (const sb of spinButtons) {\n          const rect = sb.getBoundingClientRect();\n          if (rect.right <= event.clientX && rect.right > bestRight) {\n            initialAnchorSpinButton = sb;\n            bestRight = rect.right;\n          }\n        }\n        // Clicked before all spinbuttons \u2192 fall back to the first one.\n        if (initialAnchorSpinButton === null && spinButtons.length > 0) {\n          initialAnchorSpinButton = spinButtons[0] ?? null;\n        }\n      }\n      window.getSelection()?.removeAllRanges();\n      if (root) {\n        removeContentEditable(\n          root,\n          document,\n          'mouseup',\n          (mouseUpEvent: Event, hasMultiElementSelection: boolean) => {\n            if (\n              !hasMultiElementSelection &&\n              mouseUpEvent.target instanceof HTMLElement &&\n              mouseUpEvent.target === triggerElement\n            ) {\n              // If the click landed on a contenteditable element (spin button\n              // or expression input), focus it directly. Otherwise the click\n              // was on the container or a non-interactive child, so forward\n              // focus to the first input.\n              if (mouseUpEvent.target.hasAttribute('contenteditable')) {\n                mouseUpEvent.target.focus();\n              } else {\n                onFocusInput();\n              }\n            }\n          },\n          initialAnchorSpinButton,\n        );\n      }\n    },\n    [onFocusInput],\n  );\n\n  // Shared cut logic for both Ctrl+X and context-menu cut.\n  // Calls setClipboard with the appropriate text, then performs the DOM deletion.\n  const performCut = useCallback(\n    (\n      selection: Selection,\n      pickerRoot: HTMLElement,\n      shouldSetClipboard: boolean,\n    ): void => {\n      const inputRefs = getInputRefs(dateInputFromRef, dateInputToRef);\n\n      if (shouldSetClipboard) {\n        const clipboardText = buildTimeframeClipboardText();\n        if (clipboardText !== null) {\n          navigator.clipboard.writeText(clipboardText).catch(() => {\n            // For now, we silently ignore clipboard write errors.\n          });\n        }\n      }\n\n      const partialExpressionElement = getPartialExpressionElement(\n        selection,\n        inputRefs,\n      );\n      if (partialExpressionElement) {\n        deletePartialExpression(selection, partialExpressionElement);\n        return;\n      }\n\n      const crossExpressionElements = getCrossExpressionElements(\n        selection,\n        inputRefs,\n      );\n      const plan = planBulkClear(\n        selection,\n        inputRefs,\n        consumePreRestoreEndpoints(pickerRoot),\n      );\n\n      if (crossExpressionElements) {\n        const boundaryExpressionRef =\n          crossExpressionElements[0] === crossExpressionElements[1]\n            ? inputRefs.find(\n                (inputRef) =>\n                  inputRef.current?.expressionInputRef ===\n                  crossExpressionElements[0],\n              )\n            : undefined;\n\n        deleteCrossExpressionPartial(selection, crossExpressionElements);\n\n        for (const { inputRef, key } of plan.snapshot) {\n          inputRef.current?.spinButtonHandlers.get(key)?.clearValue(true);\n        }\n        for (const [inputRef, text] of plan.expressionFallbacks) {\n          if (inputRef !== boundaryExpressionRef) {\n            inputRef.current?.setExpressionValue(text);\n          }\n        }\n      } else {\n        for (const { inputRef, key } of plan.snapshot) {\n          inputRef.current?.spinButtonHandlers.get(key)?.clearValue(true);\n        }\n        for (const [inputRef, text] of plan.expressionFallbacks) {\n          inputRef.current?.setExpressionValue(text);\n        }\n        for (const ref of plan.affectedExpressionRefs) {\n          ref.current?.setExpressionValue('');\n        }\n        selection.removeAllRanges();\n      }\n\n      restoreFocusAfterBulkClear(\n        getFirstSnapshotHandler(plan.snapshot),\n        findFirstExpressionFocusTarget(\n          inputRefs,\n          plan.affectedExpressionRefs,\n          plan.expressionFallbacks,\n        ),\n      );\n    },\n    [dateInputFromRef, dateInputToRef],\n  );\n\n  const onKeyDown = useCallback(\n    (event: ReactKeyboardEvent<HTMLDivElement>) => {\n      // Accept either Meta (Mac Cmd) or Ctrl as the modifier key so that the\n      // handler works consistently across platforms and in automated test\n      // environments (e.g. Playwright's Chromium) where the userAgent may not\n      // reliably indicate the OS.\n      const hasModifierKey = event.metaKey === true || event.ctrlKey === true;\n      const pickerRoot = event.currentTarget;\n\n      // If keydown event captures modifier keys by itself or a copy, do nothing\n      if (\n        event.key === 'Shift' ||\n        event.key === 'Control' ||\n        event.key === 'Meta' ||\n        event.key === 'Alt' ||\n        event.key === 'Command'\n      ) {\n        event.preventDefault();\n        return;\n      }\n\n      // Applies the plan returned by planBulkClear: saves undo snapshots,\n      // clears all affected spin buttons and expression inputs, and collapses\n      // the selection.\n      function applyBulkClear(\n        plan: ReturnType<typeof planBulkClear>,\n        selection: Selection,\n      ) {\n        const { snapshot, affectedExpressionRefs, expressionFallbacks } = plan;\n        for (const { inputRef, key } of snapshot) {\n          inputRef.current?.spinButtonHandlers.get(key)?.clearValue(true);\n        }\n        for (const [inputRef, text] of expressionFallbacks) {\n          inputRef.current?.setExpressionValue(text);\n        }\n        for (const ref of affectedExpressionRefs) {\n          ref.current?.setExpressionValue('');\n        }\n        selection.removeAllRanges();\n      }\n\n      // Computes the bulk-clear plan, applies it, and returns focus targets.\n      // Used by delete/backspace and type-to-replace.\n      function bulkClear(\n        selection: Selection,\n        direction: 'forward' | 'backward',\n      ) {\n        const inputRefs = getInputRefs(dateInputFromRef, dateInputToRef);\n\n        if (\n          getPartialExpressionElement(selection, inputRefs) !== null ||\n          getCrossExpressionElements(selection, inputRefs) !== null\n        ) {\n          performCut(selection, pickerRoot, false);\n          return;\n        }\n\n        const plan = planBulkClear(\n          selection,\n          inputRefs,\n          consumePreRestoreEndpoints(pickerRoot),\n        );\n        const nextFocusedElementHandler =\n          direction === 'backward'\n            ? getFirstSnapshotHandler(plan.snapshot)\n            : getLastSnapshotHandler(plan.snapshot);\n        const expressionFocusTarget = findFirstExpressionFocusTarget(\n          inputRefs,\n          plan.affectedExpressionRefs,\n          plan.expressionFallbacks,\n        );\n        applyBulkClear(plan, selection);\n        restoreFocusAfterBulkClear(\n          nextFocusedElementHandler,\n          expressionFocusTarget,\n        );\n      }\n\n      // Handle select all with Ctrl + A\n      if (hasModifierKey && event.key === 'a') {\n        event.preventDefault();\n        if (event.currentTarget instanceof HTMLElement) {\n          // No need to remove contentEditable here: extendSelectionToAll explicitly focuses the first spin button\n          // and then sets the cross-element range with addRange, keeping the focus on the already focused spin button.\n          extendSelectionToAll();\n        }\n        return;\n      }\n\n      // Check if the selection should be expanded with Shift\n      if (\n        event.shiftKey === true &&\n        (event.key === 'ArrowLeft' ||\n          event.key === 'ArrowRight' ||\n          event.key === 'Home' ||\n          event.key === 'End')\n      ) {\n        event.preventDefault();\n        if (event.currentTarget instanceof HTMLElement) {\n          // extendSelection uses setBaseAndExtent internally, which can cross\n          // contenteditable boundaries without needing to strip the attribute.\n          // No removeContentEditable / focus manipulation is needed here.\n          extendSelection(event.key);\n        }\n        return;\n      }\n\n      const isCut = hasModifierKey && event.key === 'x';\n      const isDelete = event.key === 'Backspace' || event.key === 'Delete';\n      const direction = event.key === 'Backspace' ? 'backward' : 'forward';\n\n      if (isCut || isDelete) {\n        const selection = window.getSelection();\n        if (selection && !selection.isCollapsed) {\n          event.preventDefault();\n\n          if (isCut) {\n            // Apply the clear and update focus synchronously BEFORE awaiting the\n            // clipboard write. This ensures the undo snapshot is saved inside the\n            // current synchronous execution context so that a Ctrl+Z fired\n            // immediately afterwards (e.g. in tests wrapped with act()) can always\n            // find a non-empty lastClearedSnapshotRef.\n            performCut(selection, pickerRoot, true);\n          } else {\n            bulkClear(selection, direction);\n          }\n          return;\n        }\n      }\n\n      // When there is a cross-element selection and the user types a printable\n      // character, bulk-clear the selection and forward the key to the anchor\n      // spin button so it can process the character normally.\n      // Intra-element selections (drag within a single spin button) are left\n      // alone \u2014 the spin button's own beforeinput handler deals with those.\n      if (\n        !hasModifierKey &&\n        !event.shiftKey &&\n        event.key.length === 1 &&\n        (isExpressionTriggerKey(event) || /^\\d$/.test(event.key))\n      ) {\n        const selection = window.getSelection();\n        if (\n          selection &&\n          !selection.isCollapsed &&\n          selection.anchorNode !== selection.focusNode\n        ) {\n          event.preventDefault();\n          const inputRefs = getInputRefs(dateInputFromRef, dateInputToRef);\n          const plan = planBulkClear(\n            selection,\n            inputRefs,\n            consumePreRestoreEndpoints(pickerRoot),\n          );\n\n          // When ALL spin buttons of an affected input are cleared (0 survivors),\n          // the input should switch to expression mode \u2014 use the full applyBulkClear\n          // path (same as Delete). Detected by: expression fallbacks will fire AND\n          // the selection starts at the first spin button of its input.\n          // When the first spin button is the survivor (selection starts later),\n          // skip expression fallbacks so the input stays in ISO mode and the typed\n          // character lands in the first selected spin button.\n          const firstEntry = plan.snapshot[0];\n          const firstKey = firstEntry\n            ? [\n                ...(firstEntry.inputRef.current?.spinButtonHandlers.keys() ??\n                  []),\n              ][0]\n            : undefined;\n          const expressionModeWillSwitch =\n            plan.expressionFallbacks.size > 0 && firstEntry?.key === firstKey;\n\n          if (expressionModeWillSwitch) {\n            const firstSpinButtonHandler = getFirstSnapshotHandler(\n              plan.snapshot,\n            );\n            const expressionFocusTarget = findFirstExpressionFocusTarget(\n              inputRefs,\n              plan.affectedExpressionRefs,\n              plan.expressionFallbacks,\n            );\n            applyBulkClear(plan, selection);\n            // Pre-fill the expression input with the typed character. Both this\n            // call and the setExpressionValue('') inside applyBulkClear are\n            // batched by React 18, so the expression input renders with the\n            // character before the rAF in makeFocusAfterBulkClear fires.\n            expressionFocusTarget?.current?.setExpressionValue(event.key);\n            restoreFocusAfterBulkClear(\n              firstSpinButtonHandler,\n              expressionFocusTarget,\n            );\n            return;\n          }\n\n          for (const { inputRef, key } of plan.snapshot) {\n            inputRef.current?.spinButtonHandlers.get(key)?.clearValue(true);\n          }\n          selection.removeAllRanges();\n\n          // Get the handler for the first cleared spin button directly from\n          // the snapshot. We cannot use getFirstSnapshotHandler here because\n          // it intentionally returns undefined for the first/second keys\n          // (designed for post-delete focus), which would swallow the character.\n          const handler = firstEntry\n            ? firstEntry.inputRef.current?.spinButtonHandlers.get(\n                firstEntry.key,\n              )\n            : undefined;\n          if (handler) {\n            handler.element.current?.focus();\n            if (handler.type === 'number') {\n              handler.applyText(event.key, true);\n              const newLength =\n                handler.element.current?.textContent?.length ?? 0;\n              handler.setSelection({ start: newLength, end: newLength });\n            } else {\n              handler.element.current?.dispatchEvent(\n                new KeyboardEvent('keydown', {\n                  key: event.key,\n                  bubbles: true,\n                  cancelable: true,\n                }),\n              );\n            }\n          }\n          return;\n        }\n      }\n\n      // When the container itself has focus (post drag-select, no spin button focused),\n      // intercept ArrowUp / ArrowDown and forward them to the anchor spin button.\n      // This avoids the Firefox visual bug caused by focusing a spin button during\n      // drag-restore \u2014 no focus() is called there, so the container holds focus.\n      if (\n        !event.shiftKey &&\n        !hasModifierKey &&\n        (event.key === 'ArrowUp' || event.key === 'ArrowDown') &&\n        event.target === touchedContainerRef.current\n      ) {\n        const anchorSpinButton = getAnchorSpinButton();\n\n        if (anchorSpinButton !== null) {\n          event.preventDefault();\n          // Focus the spin button. onFocus sees selectionSpansMultipleNodes = true\n          // (the cross-element range is still intact) and skips selectAll().\n          anchorSpinButton.focus();\n          // Dispatch a synthetic keydown to trigger useValueNavigation on the spin button.\n          anchorSpinButton.dispatchEvent(\n            new KeyboardEvent('keydown', {\n              key: event.key,\n              bubbles: true,\n              cancelable: true,\n            }),\n          );\n          return;\n        }\n      }\n\n      // Forward the focus when a key is pressed in this element.\n      // If the container has focus with an active selection (post Cmd+A or drag),\n      // forward to the anchor spin button so the key lands in the right field.\n      // Otherwise fall back to onFocusInput() which focuses the first input.\n      // Skip for modifier+key shortcuts (e.g. Cmd+C): focusing a spin button\n      // collapses Firefox's cross-element selection before the copy event fires.\n      if (event.target === touchedContainerRef.current && !hasModifierKey) {\n        const anchorSpinButton = getAnchorSpinButton();\n\n        if (anchorSpinButton !== null) {\n          anchorSpinButton.focus();\n        } else {\n          onFocusInput();\n        }\n      }\n    },\n    [\n      onFocusInput,\n      touchedContainerRef,\n      dateInputFromRef,\n      dateInputToRef,\n      performCut,\n    ],\n  );\n\n  const onContextMenu = useCallback(\n    (event: ReactMouseEvent<HTMLDivElement>) => {\n      // Clear stale pre-restore endpoints so planBulkClear uses the fresh selection\n      // from this new right-click session rather than a previous multi-element range.\n      consumePreRestoreEndpoints(event.currentTarget);\n      const selection = window.getSelection();\n      contextMenuSelectionRef.current =\n        selection && !selection.isCollapsed && selection.rangeCount > 0\n          ? selection.getRangeAt(0).cloneRange()\n          : null;\n    },\n    [],\n  );\n\n  // Handles native 'cut' from the context menu using synchronous clipboardData.\n  const onCutCapture = useCallback(\n    (event: ReactClipboardEvent<HTMLDivElement>) => {\n      // Restore the selection saved at contextmenu time before reading it.\n      // Firefox may extend or change the selection between right-click and cut.\n      const savedRange = contextMenuSelectionRef.current;\n      contextMenuSelectionRef.current = null;\n      if (savedRange) {\n        const sel = window.getSelection();\n        if (sel) {\n          sel.removeAllRanges();\n          sel.addRange(savedRange);\n        }\n      }\n\n      const selection = window.getSelection();\n      if (!selection || selection.isCollapsed) {\n        return;\n      }\n\n      event.preventDefault();\n\n      const pickerRoot = event.currentTarget;\n      performCut(selection, pickerRoot, true);\n\n      // Clear data-drag-selected marks set during contextmenu.\n      for (const el of pickerRoot.querySelectorAll<HTMLElement>(\n        '[data-drag-selected]',\n      )) {\n        el.removeAttribute('data-drag-selected');\n      }\n    },\n    [performCut],\n  );\n\n  return { onMouseDown, onKeyDown, onContextMenu, onCutCapture };\n}\n\nfunction getAnchorSpinButton(): HTMLElement | null {\n  const anchorNode = window.getSelection()?.anchorNode ?? null;\n  if (anchorNode === null) {\n    return null;\n  }\n\n  return anchorNode.nodeType === Node.TEXT_NODE\n    ? (anchorNode as Text).parentElement?.closest<HTMLElement>(\n        '[contenteditable]',\n      ) ?? null\n    : (anchorNode as HTMLElement | null)?.closest?.('[contenteditable]') ??\n        null;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  useCallback,\n  useRef,\n  type ClipboardEvent as ReactClipboardEvent,\n  type MouseEvent as ReactMouseEvent,\n  type KeyboardEvent as ReactKeyboardEvent,\n  type RefObject,\n} from 'react';\n\nimport { isExpressionTriggerKey } from './expression-trigger-helpers.js';\nimport { buildTimeframeClipboardText } from './selection-copy-helpers.js';\nimport {\n  extendSelection,\n  extendSelectionToAll,\n  removeContentEditable,\n  getFirstSnapshotHandler,\n  findFirstExpressionFocusTarget,\n  restoreFocusAfterBulkClear,\n  planBulkClear,\n  getPartialExpressionElement,\n  deletePartialExpression,\n  getCrossExpressionElements,\n  deleteCrossExpressionPartial,\n  consumePreRestoreEndpoints,\n  peekPreRestoreEndpoints,\n  getLastSnapshotHandler,\n} from './selection-helpers.js';\nimport type { DateTimeInputRef } from './types.js';\n\n/**\n * Builds an array of input references from the given refs.\n * @internal\n */\nfunction getInputRefs(\n  dateInputFromRef: RefObject<DateTimeInputRef | null>,\n  dateInputToRef?: RefObject<DateTimeInputRef | null>,\n): RefObject<DateTimeInputRef | null>[] {\n  return [dateInputFromRef, ...(dateInputToRef ? [dateInputToRef] : [])];\n}\n\n/**\n * Hook that provides interaction handlers for selection behavior in date/time pickers.\n * Manages mouse and keyboard interactions including text selection and focus management.\n *\n * @param touchedContainerRef - Reference to the container that should be checked when forwarding focus\n * @param onFocusInput - Callback to focus the appropriate input(s) when needed\n * @param dateInputFromRef - Reference to the \"from\" DateTimeInput imperative handle\n * @param dateInputToRef - Reference to the optional \"to\" DateTimeInput imperative handle\n * @returns Object containing onMouseDown, onKeyDown and onCutCapture event handlers\n *\n * @internal\n */\nexport function useSelectionInteractionHandlers(\n  touchedContainerRef: RefObject<HTMLElement | null>,\n  onFocusInput: () => void,\n  dateInputFromRef: RefObject<DateTimeInputRef | null>,\n  dateInputToRef?: RefObject<DateTimeInputRef | null>,\n): {\n  onMouseDown: (event: ReactMouseEvent<HTMLDivElement>) => void;\n  onKeyDown: (event: ReactKeyboardEvent<HTMLDivElement>) => void;\n  onContextMenu: (event: ReactMouseEvent<HTMLDivElement>) => void;\n  onCutCapture: (event: ReactClipboardEvent<HTMLDivElement>) => void;\n} {\n  // Snapshot the selection at contextmenu time so that\n  // onCutCapture can restore it before running the deletion logic.\n  const contextMenuSelectionRef = useRef<Range | null>(null);\n\n  const onMouseDown = useCallback(\n    (event: ReactMouseEvent<HTMLDivElement>) => {\n      if (event.button !== 0) {\n        return;\n      }\n      // A new left-click starts a new selection; discard any stale contextmenu snapshot\n      // and pre-restore endpoints\n      contextMenuSelectionRef.current = null;\n      consumePreRestoreEndpoints(event.currentTarget);\n      // Only compute the anchor spinbutton for clicks in empty space (not on\n      // a spinbutton element itself). For direct spinbutton clicks the browser's\n      // native anchor is correct and must be preserved for single-element\n      // intra-spinbutton drag to work normally.\n      const root: HTMLElement = event.currentTarget;\n      const triggerElement = event.target;\n      const clickedOnSpinButton =\n        triggerElement instanceof HTMLElement &&\n        triggerElement.hasAttribute('contenteditable');\n      let initialAnchorSpinButton: HTMLElement | null = null;\n      if (!clickedOnSpinButton) {\n        const spinButtons = Array.from(\n          root.querySelectorAll<HTMLElement>('[contenteditable]'),\n        );\n        // Find the rightmost spinbutton whose right edge is at or before the\n        // click x \u2014 that is the spinbutton the drag started on (or the last\n        // one to its left when clicking in empty space).\n        let bestRight = -Infinity;\n        for (const sb of spinButtons) {\n          const rect = sb.getBoundingClientRect();\n          if (rect.right <= event.clientX && rect.right > bestRight) {\n            initialAnchorSpinButton = sb;\n            bestRight = rect.right;\n          }\n        }\n        // Clicked before all spinbuttons \u2192 fall back to the first one.\n        if (initialAnchorSpinButton === null && spinButtons.length > 0) {\n          initialAnchorSpinButton = spinButtons[0] ?? null;\n        }\n      }\n      window.getSelection()?.removeAllRanges();\n      if (root) {\n        removeContentEditable(\n          root,\n          document,\n          'mouseup',\n          (mouseUpEvent: Event, hasMultiElementSelection: boolean) => {\n            if (\n              !hasMultiElementSelection &&\n              mouseUpEvent.target instanceof HTMLElement &&\n              mouseUpEvent.target === triggerElement\n            ) {\n              // If the click landed on a contenteditable element (spin button\n              // or expression input), focus it directly. Otherwise the click\n              // was on the container or a non-interactive child, so forward\n              // focus to the first input.\n              if (mouseUpEvent.target.hasAttribute('contenteditable')) {\n                mouseUpEvent.target.focus();\n              } else {\n                onFocusInput();\n              }\n            }\n          },\n          initialAnchorSpinButton,\n        );\n      }\n    },\n    [onFocusInput],\n  );\n\n  // Shared cut logic for both Ctrl+X and context-menu cut.\n  // Calls setClipboard with the appropriate text, then performs the DOM deletion.\n  const performCut = useCallback(\n    (\n      selection: Selection,\n      pickerRoot: HTMLElement,\n      shouldSetClipboard: boolean,\n    ): void => {\n      const inputRefs = getInputRefs(dateInputFromRef, dateInputToRef);\n\n      if (shouldSetClipboard) {\n        const clipboardText = buildTimeframeClipboardText();\n        if (clipboardText !== null) {\n          navigator.clipboard.writeText(clipboardText).catch(() => {\n            // For now, we silently ignore clipboard write errors.\n          });\n        }\n      }\n\n      const partialExpressionElement = getPartialExpressionElement(\n        selection,\n        inputRefs,\n      );\n      if (partialExpressionElement) {\n        deletePartialExpression(selection, partialExpressionElement);\n        return;\n      }\n\n      const crossExpressionElements = getCrossExpressionElements(\n        selection,\n        inputRefs,\n      );\n      const plan = planBulkClear(\n        selection,\n        inputRefs,\n        consumePreRestoreEndpoints(pickerRoot),\n      );\n\n      if (crossExpressionElements) {\n        const boundaryExpressionRef =\n          crossExpressionElements[0] === crossExpressionElements[1]\n            ? inputRefs.find(\n                (inputRef) =>\n                  inputRef.current?.expressionInputRef ===\n                  crossExpressionElements[0],\n              )\n            : undefined;\n\n        deleteCrossExpressionPartial(selection, crossExpressionElements);\n\n        for (const { inputRef, key } of plan.snapshot) {\n          inputRef.current?.spinButtonHandlers.get(key)?.clearValue(true);\n        }\n        for (const [inputRef, text] of plan.expressionFallbacks) {\n          if (inputRef !== boundaryExpressionRef) {\n            inputRef.current?.setExpressionValue(text);\n          }\n        }\n      } else {\n        for (const { inputRef, key } of plan.snapshot) {\n          inputRef.current?.spinButtonHandlers.get(key)?.clearValue(true);\n        }\n        for (const [inputRef, text] of plan.expressionFallbacks) {\n          inputRef.current?.setExpressionValue(text);\n        }\n        for (const ref of plan.affectedExpressionRefs) {\n          ref.current?.setExpressionValue('');\n        }\n        selection.removeAllRanges();\n      }\n\n      restoreFocusAfterBulkClear(\n        getFirstSnapshotHandler(plan.snapshot),\n        findFirstExpressionFocusTarget(\n          inputRefs,\n          plan.affectedExpressionRefs,\n          plan.expressionFallbacks,\n        ),\n      );\n    },\n    [dateInputFromRef, dateInputToRef],\n  );\n\n  const onKeyDown = useCallback(\n    (event: ReactKeyboardEvent<HTMLDivElement>) => {\n      // Accept either Meta (Mac Cmd) or Ctrl as the modifier key so that the\n      // handler works consistently across platforms and in automated test\n      // environments (e.g. Playwright's Chromium) where the userAgent may not\n      // reliably indicate the OS.\n      const hasModifierKey = event.metaKey === true || event.ctrlKey === true;\n      const pickerRoot = event.currentTarget;\n\n      // If keydown event captures modifier keys by itself or a copy, do nothing\n      if (\n        event.key === 'Shift' ||\n        event.key === 'Control' ||\n        event.key === 'Meta' ||\n        event.key === 'Alt' ||\n        event.key === 'Command'\n      ) {\n        event.preventDefault();\n        return;\n      }\n\n      // Applies the plan returned by planBulkClear: saves undo snapshots,\n      // clears all affected spin buttons and expression inputs, and collapses\n      // the selection.\n      function applyBulkClear(\n        plan: ReturnType<typeof planBulkClear>,\n        selection: Selection,\n      ) {\n        const { snapshot, affectedExpressionRefs, expressionFallbacks } = plan;\n        for (const { inputRef, key } of snapshot) {\n          inputRef.current?.spinButtonHandlers.get(key)?.clearValue(true);\n        }\n        for (const [inputRef, text] of expressionFallbacks) {\n          inputRef.current?.setExpressionValue(text);\n        }\n        for (const ref of affectedExpressionRefs) {\n          ref.current?.setExpressionValue('');\n        }\n        selection.removeAllRanges();\n      }\n\n      // Computes the bulk-clear plan, applies it, and returns focus targets.\n      // Used by delete/backspace and type-to-replace.\n      function bulkClear(\n        selection: Selection,\n        direction: 'forward' | 'backward',\n      ) {\n        const inputRefs = getInputRefs(dateInputFromRef, dateInputToRef);\n\n        if (\n          getPartialExpressionElement(selection, inputRefs) !== null ||\n          getCrossExpressionElements(selection, inputRefs) !== null\n        ) {\n          performCut(selection, pickerRoot, false);\n          return;\n        }\n\n        const plan = planBulkClear(\n          selection,\n          inputRefs,\n          consumePreRestoreEndpoints(pickerRoot),\n        );\n        const nextFocusedElementHandler =\n          direction === 'backward'\n            ? getFirstSnapshotHandler(plan.snapshot)\n            : getLastSnapshotHandler(plan.snapshot);\n        const expressionFocusTarget = findFirstExpressionFocusTarget(\n          inputRefs,\n          plan.affectedExpressionRefs,\n          plan.expressionFallbacks,\n        );\n        applyBulkClear(plan, selection);\n        restoreFocusAfterBulkClear(\n          nextFocusedElementHandler,\n          expressionFocusTarget,\n        );\n      }\n\n      // Handle select all with Ctrl + A\n      if (hasModifierKey && event.key === 'a') {\n        event.preventDefault();\n        if (event.currentTarget instanceof HTMLElement) {\n          // No need to remove contentEditable here: extendSelectionToAll explicitly focuses the first spin button\n          // and then sets the cross-element range with addRange, keeping the focus on the already focused spin button.\n          extendSelectionToAll();\n        }\n        return;\n      }\n\n      // Check if the selection should be expanded with Shift\n      if (\n        event.shiftKey === true &&\n        (event.key === 'ArrowLeft' ||\n          event.key === 'ArrowRight' ||\n          event.key === 'Home' ||\n          event.key === 'End')\n      ) {\n        event.preventDefault();\n        if (event.currentTarget instanceof HTMLElement) {\n          // extendSelection uses setBaseAndExtent internally, which can cross\n          // contenteditable boundaries without needing to strip the attribute.\n          // No removeContentEditable / focus manipulation is needed here.\n          extendSelection(event.key);\n        }\n        return;\n      }\n\n      const isCut = hasModifierKey && event.key === 'x';\n      const isDelete = event.key === 'Backspace' || event.key === 'Delete';\n      const direction = event.key === 'Backspace' ? 'backward' : 'forward';\n\n      if (isCut || isDelete) {\n        const selection = window.getSelection();\n        // React 19/jsdom can collapse the live cross-contenteditable selection\n        // before this bubble-phase handler runs. The capture-phase restore code\n        // stashes the original endpoints so bulkClear can still operate on the\n        // user's selected range.\n        const preRestoreEndpoints = peekPreRestoreEndpoints(pickerRoot);\n        if (selection && (!selection.isCollapsed || preRestoreEndpoints)) {\n          event.preventDefault();\n\n          if (isCut) {\n            // Apply the clear and update focus synchronously BEFORE awaiting the\n            // clipboard write. This ensures the undo snapshot is saved inside the\n            // current synchronous execution context so that a Ctrl+Z fired\n            // immediately afterwards (e.g. in tests wrapped with act()) can always\n            // find a non-empty lastClearedSnapshotRef.\n            performCut(selection, pickerRoot, true);\n          } else {\n            bulkClear(selection, direction);\n          }\n          return;\n        }\n      }\n\n      // When there is a cross-element selection and the user types a printable\n      // character, bulk-clear the selection and forward the key to the anchor\n      // spin button so it can process the character normally.\n      // Intra-element selections (drag within a single spin button) are left\n      // alone \u2014 the spin button's own beforeinput handler deals with those.\n      if (\n        !hasModifierKey &&\n        !event.shiftKey &&\n        event.key.length === 1 &&\n        (isExpressionTriggerKey(event) || /^\\d$/.test(event.key))\n      ) {\n        const selection = window.getSelection();\n        // See the Delete/Cut branch above: printable replacement needs the same\n        // endpoint fallback when the live selection was collapsed during restore.\n        const preRestoreEndpoints = peekPreRestoreEndpoints(pickerRoot);\n        if (\n          selection &&\n          ((!selection.isCollapsed &&\n            selection.anchorNode !== selection.focusNode) ||\n            preRestoreEndpoints)\n        ) {\n          event.preventDefault();\n          const inputRefs = getInputRefs(dateInputFromRef, dateInputToRef);\n          const plan = planBulkClear(\n            selection,\n            inputRefs,\n            consumePreRestoreEndpoints(pickerRoot),\n          );\n\n          // When ALL spin buttons of an affected input are cleared (0 survivors),\n          // the input should switch to expression mode \u2014 use the full applyBulkClear\n          // path (same as Delete). Detected by: expression fallbacks will fire AND\n          // the selection starts at the first spin button of its input.\n          // When the first spin button is the survivor (selection starts later),\n          // skip expression fallbacks so the input stays in ISO mode and the typed\n          // character lands in the first selected spin button.\n          const firstEntry = plan.snapshot[0];\n          const firstKey = firstEntry\n            ? [\n                ...(firstEntry.inputRef.current?.spinButtonHandlers.keys() ??\n                  []),\n              ][0]\n            : undefined;\n          const expressionModeWillSwitch =\n            plan.expressionFallbacks.size > 0 && firstEntry?.key === firstKey;\n\n          if (expressionModeWillSwitch) {\n            const firstSpinButtonHandler = getFirstSnapshotHandler(\n              plan.snapshot,\n            );\n            const expressionFocusTarget = findFirstExpressionFocusTarget(\n              inputRefs,\n              plan.affectedExpressionRefs,\n              plan.expressionFallbacks,\n            );\n            applyBulkClear(plan, selection);\n            // Pre-fill the expression input with the typed character. Both this\n            // call and the setExpressionValue('') inside applyBulkClear are\n            // batched by React 18, so the expression input renders with the\n            // character before the rAF in makeFocusAfterBulkClear fires.\n            expressionFocusTarget?.current?.setExpressionValue(event.key);\n            restoreFocusAfterBulkClear(\n              firstSpinButtonHandler,\n              expressionFocusTarget,\n            );\n            return;\n          }\n\n          for (const { inputRef, key } of plan.snapshot) {\n            inputRef.current?.spinButtonHandlers.get(key)?.clearValue(true);\n          }\n          selection.removeAllRanges();\n\n          // Get the handler for the first cleared spin button directly from\n          // the snapshot. We cannot use getFirstSnapshotHandler here because\n          // it intentionally returns undefined for the first/second keys\n          // (designed for post-delete focus), which would swallow the character.\n          const handler = firstEntry\n            ? firstEntry.inputRef.current?.spinButtonHandlers.get(\n                firstEntry.key,\n              )\n            : undefined;\n          if (handler) {\n            handler.element.current?.focus();\n            if (handler.type === 'number') {\n              handler.applyText(event.key, true);\n              const newLength =\n                handler.element.current?.textContent?.length ?? 0;\n              handler.setSelection({ start: newLength, end: newLength });\n            } else {\n              handler.element.current?.dispatchEvent(\n                new KeyboardEvent('keydown', {\n                  key: event.key,\n                  bubbles: true,\n                  cancelable: true,\n                }),\n              );\n            }\n          }\n          return;\n        }\n      }\n\n      // When the container itself has focus (post drag-select, no spin button focused),\n      // intercept ArrowUp / ArrowDown and forward them to the anchor spin button.\n      // This avoids the Firefox visual bug caused by focusing a spin button during\n      // drag-restore \u2014 no focus() is called there, so the container holds focus.\n      if (\n        !event.shiftKey &&\n        !hasModifierKey &&\n        (event.key === 'ArrowUp' || event.key === 'ArrowDown') &&\n        event.target === touchedContainerRef.current\n      ) {\n        const anchorSpinButton = getAnchorSpinButton();\n\n        if (anchorSpinButton !== null) {\n          event.preventDefault();\n          // Focus the spin button. onFocus sees selectionSpansMultipleNodes = true\n          // (the cross-element range is still intact) and skips selectAll().\n          anchorSpinButton.focus();\n          // Dispatch a synthetic keydown to trigger useValueNavigation on the spin button.\n          anchorSpinButton.dispatchEvent(\n            new KeyboardEvent('keydown', {\n              key: event.key,\n              bubbles: true,\n              cancelable: true,\n            }),\n          );\n          return;\n        }\n      }\n\n      // Forward the focus when a key is pressed in this element.\n      // If the container has focus with an active selection (post Cmd+A or drag),\n      // forward to the anchor spin button so the key lands in the right field.\n      // Otherwise fall back to onFocusInput() which focuses the first input.\n      // Skip for modifier+key shortcuts (e.g. Cmd+C): focusing a spin button\n      // collapses Firefox's cross-element selection before the copy event fires.\n      if (event.target === touchedContainerRef.current && !hasModifierKey) {\n        const anchorSpinButton = getAnchorSpinButton();\n\n        if (anchorSpinButton !== null) {\n          anchorSpinButton.focus();\n        } else {\n          onFocusInput();\n        }\n      }\n    },\n    [\n      onFocusInput,\n      touchedContainerRef,\n      dateInputFromRef,\n      dateInputToRef,\n      performCut,\n    ],\n  );\n\n  const onContextMenu = useCallback(\n    (event: ReactMouseEvent<HTMLDivElement>) => {\n      // Clear stale pre-restore endpoints so planBulkClear uses the fresh selection\n      // from this new right-click session rather than a previous multi-element range.\n      consumePreRestoreEndpoints(event.currentTarget);\n      const selection = window.getSelection();\n      contextMenuSelectionRef.current =\n        selection && !selection.isCollapsed && selection.rangeCount > 0\n          ? selection.getRangeAt(0).cloneRange()\n          : null;\n    },\n    [],\n  );\n\n  // Handles native 'cut' from the context menu using synchronous clipboardData.\n  const onCutCapture = useCallback(\n    (event: ReactClipboardEvent<HTMLDivElement>) => {\n      // Restore the selection saved at contextmenu time before reading it.\n      // Firefox may extend or change the selection between right-click and cut.\n      const savedRange = contextMenuSelectionRef.current;\n      contextMenuSelectionRef.current = null;\n      if (savedRange) {\n        const sel = window.getSelection();\n        if (sel) {\n          sel.removeAllRanges();\n          sel.addRange(savedRange);\n        }\n      }\n\n      const selection = window.getSelection();\n      if (!selection || selection.isCollapsed) {\n        return;\n      }\n\n      event.preventDefault();\n\n      const pickerRoot = event.currentTarget;\n      performCut(selection, pickerRoot, true);\n\n      // Clear data-drag-selected marks set during contextmenu.\n      for (const el of pickerRoot.querySelectorAll<HTMLElement>(\n        '[data-drag-selected]',\n      )) {\n        el.removeAttribute('data-drag-selected');\n      }\n    },\n    [performCut],\n  );\n\n  return { onMouseDown, onKeyDown, onContextMenu, onCutCapture };\n}\n\nfunction getAnchorSpinButton(): HTMLElement | null {\n  const anchorNode = window.getSelection()?.anchorNode ?? null;\n  if (anchorNode === null) {\n    return null;\n  }\n\n  return anchorNode.nodeType === Node.TEXT_NODE\n    ? (anchorNode as Text).parentElement?.closest<HTMLElement>(\n        '[contenteditable]',\n      ) ?? null\n    : (anchorNode as HTMLElement | null)?.closest?.('[contenteditable]') ??\n        null;\n}\n"],
+  "mappings": "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",
   "names": ["direction"]
 }

package/esm/forms/form/Form.js

@@ -0,0 +1,107 @@
+import { jsx } from "react/jsx-runtime";
+import {
+  forwardRef,
+  useEffect,
+  useMemo,
+  useRef
+} from "react";
+import { FormContext } from "./context/FormContext.js";
+import {
+  createFormRuntime
+} from "./runtime/createFormRuntime.js";
+import { registerFormById } from "./runtime/formRegistry.js";
+import { useAriaLabelingProps } from "../../core/hooks/useAriaLabelingProps.js";
+import { useBehavioralTrackingProps } from "../../core/hooks/useBehavioralTrackingProps.js";
+import { useSafeLayoutEffect } from "../../core/hooks/useSafeLayoutEffect.js";
+const EMPTY_VALIDATORS = [];
+function isFormRuntime(value) {
+  if (value === null || typeof value !== "object") {
+    return false;
+  }
+  const candidate = value;
+  return typeof candidate.register === "function" && typeof candidate.subscribe === "function" && typeof candidate.getFormMessages === "function" && typeof candidate.getFieldMessages === "function";
+}
+const FormRoot = /* @__PURE__ */ forwardRef(function Form(props, forwardedRef) {
+  const {
+    children,
+    id,
+    form,
+    validators = EMPTY_VALIDATORS,
+    onSubmit,
+    onInvalid,
+    onValidityChange,
+    className,
+    style,
+    "data-testid": dataTestId,
+    ...remainingProps
+  } = props;
+  const [behavioralTrackingProps, restProps] = useBehavioralTrackingProps(remainingProps);
+  const ariaLabelingProps = useAriaLabelingProps(restProps);
+  const configRef = useRef({
+    validators: EMPTY_VALIDATORS
+  });
+  configRef.current = {
+    formId: id,
+    validators,
+    onSubmit,
+    onInvalid,
+    onValidityChange
+  };
+  const externalRuntime = isFormRuntime(form) ? form : void 0;
+  const internalRuntimeRef = useRef(
+    void 0
+  );
+  let runtime;
+  if (externalRuntime !== void 0) {
+    runtime = externalRuntime;
+  } else {
+    internalRuntimeRef.current ??= createFormRuntime(
+      () => configRef.current
+    );
+    runtime = internalRuntimeRef.current;
+  }
+  useSafeLayoutEffect(() => {
+    const bindConfig = externalRuntime?._bindConfig;
+    if (!bindConfig) {
+      return;
+    }
+    bindConfig(() => configRef.current);
+    return () => bindConfig(void 0);
+  }, [externalRuntime]);
+  useEffect(() => {
+    if (id === void 0) {
+      return;
+    }
+    return registerFormById(id, runtime);
+  }, [id, runtime]);
+  const contextValue = useMemo(
+    () => ({ runtime, formId: id }),
+    [runtime, id]
+  );
+  const handleSubmit = (event) => {
+    event.preventDefault();
+    void runtime.submit();
+  };
+  return /* @__PURE__ */ jsx(FormContext.Provider, { value: contextValue, children: /* @__PURE__ */ jsx(
+    "form",
+    {
+      ref: forwardedRef,
+      id,
+      noValidate: true,
+      onSubmit: handleSubmit,
+      className,
+      style,
+      "data-testid": dataTestId,
+      ...ariaLabelingProps,
+      ...behavioralTrackingProps,
+      children
+    }
+  ) });
+});
+FormRoot.displayName = "Form";
+const Form2 = FormRoot;
+export {
+  Form2 as Form,
+  isFormRuntime
+};
+//# sourceMappingURL=Form.js.map

package/esm/forms/form/Form.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/forms/form/Form.tsx"],
+  "sourcesContent": ["import {\n  forwardRef,\n  useEffect,\n  useMemo,\n  useRef,\n  type ForwardedRef,\n  type FormEvent,\n  type ReactElement,\n} from 'react';\n\nimport { FormContext, type FormContextValue } from './context/FormContext.js';\nimport type {\n  FormApi,\n  FormInvalidContext,\n  FormSubmitContext,\n  FormValidator,\n} from './form.types.js';\nimport {\n  createFormRuntime,\n  type FormRuntime,\n  type FormRuntimeConfig,\n} from './runtime/createFormRuntime.js';\nimport { registerFormById } from './runtime/formRegistry.js';\nimport { useAriaLabelingProps } from '../../core/hooks/useAriaLabelingProps.js';\nimport { useBehavioralTrackingProps } from '../../core/hooks/useBehavioralTrackingProps.js';\nimport { useSafeLayoutEffect } from '../../core/hooks/useSafeLayoutEffect.js';\nimport type { AriaLabelingProps } from '../../core/types/a11y-props.js';\nimport type { BehaviorTrackingProps } from '../../core/types/behavior-tracking-props.js';\nimport type { DataTestId } from '../../core/types/data-props.js';\nimport type { StylingProps } from '../../core/types/styling-props.js';\nimport { WithChildren } from '../../core/types/with-children.js';\nimport type { ValidationState } from '../validation/types.js';\n\n/**\n * Props for `Form`.\n * @internal\n */\nexport interface FormProps<TValues = Record<string, unknown>>\n  extends WithChildren,\n    StylingProps,\n    DataTestId,\n    AriaLabelingProps,\n    BehaviorTrackingProps {\n  /**\n   * Native form id. Required to associate `FormMessages` or a control from\n   * outside the React subtree via `form=\"\u2026\"`; optional otherwise.\n   */\n  id?: string;\n  /** Form-level validators. Receive the full snapshot and may be async. */\n  validators?: FormValidator<TValues>[];\n  /** Called after successful validation on a submit trigger. */\n  onSubmit?: (context: FormSubmitContext<TValues>) => void;\n  /** Called after failed validation on a submit trigger. */\n  onInvalid?: (context: FormInvalidContext<TValues>) => void;\n  /**\n   * Called when the form's aggregate validation state transitions \u2014 validity\n   * flips, or the set of errors changes. Not called on identical recomputations.\n   */\n  onValidityChange?: (state: ValidationState) => void;\n  /**\n   * Pre-built runtime created by `useForm` or `createForm`. When provided,\n   * the form uses this runtime instead of creating its own, so callers outside\n   * the subtree can drive `submit()`, `setError()`, etc. via the same handle.\n   * @internal\n   */\n  form?: FormApi<TValues>;\n}\n\nconst EMPTY_VALIDATORS: FormValidator<never>[] = [];\n\n/**\n * Narrows a `FormApi` (or unknown value) to a full `FormRuntime` by checking\n * for the runtime-only methods (`register`, `subscribe`, `getFormMessages`,\n * `getFieldMessages`). `useForm` / `createForm` return the underlying runtime\n * widened to `FormApi`, so this succeeds for legitimate handles.\n * @internal\n */\nexport function isFormRuntime<TValues = Record<string, unknown>>(\n  value: unknown,\n): value is FormRuntime<TValues> {\n  if (value === null || typeof value !== 'object') {\n    return false;\n  }\n  const candidate = value as Record<string, unknown>;\n  return (\n    typeof candidate.register === 'function' &&\n    typeof candidate.subscribe === 'function' &&\n    typeof candidate.getFormMessages === 'function' &&\n    typeof candidate.getFieldMessages === 'function'\n  );\n}\n\nconst FormRoot = /* @__PURE__ */ forwardRef(function Form<\n  TValues = Record<string, unknown>,\n>(props: FormProps<TValues>, forwardedRef: ForwardedRef<HTMLFormElement>) {\n  const {\n    children,\n    id,\n    form,\n    validators = EMPTY_VALIDATORS as FormValidator<TValues>[],\n    onSubmit,\n    onInvalid,\n    onValidityChange,\n    className,\n    style,\n    'data-testid': dataTestId,\n    ...remainingProps\n  } = props;\n\n  const [behavioralTrackingProps, restProps] =\n    useBehavioralTrackingProps(remainingProps);\n  const ariaLabelingProps = useAriaLabelingProps(restProps);\n\n  // Keep the runtime's view of the latest props current without mutating it\n  // during render: the runtime reads this ref lazily on submit/validate.\n  const configRef = useRef<FormRuntimeConfig<TValues>>({\n    validators: EMPTY_VALIDATORS as FormValidator<TValues>[],\n  });\n  configRef.current = {\n    formId: id,\n    validators,\n    onSubmit,\n    onInvalid,\n    onValidityChange,\n  };\n\n  const externalRuntime = isFormRuntime<TValues>(form) ? form : undefined;\n\n  // Internal runtime is only created when no external `form` is provided.\n  // If the consumer toggles between defined/undefined across renders the active\n  // runtime identity swaps \u2014 this is a deliberate non-goal for the `_`-prefixed\n  // unstable API; avoid doing it.\n  const internalRuntimeRef = useRef<FormRuntime<TValues> | undefined>(\n    undefined,\n  );\n  let runtime: FormRuntime<TValues>;\n  if (externalRuntime !== undefined) {\n    runtime = externalRuntime;\n  } else {\n    internalRuntimeRef.current ??= createFormRuntime<TValues>(\n      () => configRef.current,\n    );\n    runtime = internalRuntimeRef.current;\n  }\n\n  // Wire the Form's config into an externally-provided runtime. useSafeLayoutEffect\n  // fires before child useEffect registrations, so config is live before any\n  // submit/validate can read it. On unmount the binding is cleared.\n  useSafeLayoutEffect(() => {\n    const bindConfig = externalRuntime?._bindConfig;\n    if (!bindConfig) {\n      return;\n    }\n    bindConfig(() => configRef.current);\n    return () => bindConfig(undefined);\n  }, [externalRuntime]);\n\n  // Expose the runtime under its id so out-of-subtree controls can associate.\n  useEffect(() => {\n    if (id === undefined) {\n      return;\n    }\n    return registerFormById(id, runtime as FormRuntime);\n  }, [id, runtime]);\n\n  const contextValue = useMemo<FormContextValue>(\n    () => ({ runtime: runtime as FormRuntime, formId: id }),\n    [runtime, id],\n  );\n\n  const handleSubmit = (event: FormEvent<HTMLFormElement>) => {\n    // We own validation and submission; keep the browser out of both.\n    event.preventDefault();\n    void runtime.submit();\n  };\n\n  return (\n    <FormContext.Provider value={contextValue}>\n      <form\n        ref={forwardedRef}\n        id={id}\n        noValidate\n        onSubmit={handleSubmit}\n        className={className}\n        style={style}\n        data-testid={dataTestId}\n        {...ariaLabelingProps}\n        {...behavioralTrackingProps}\n      >\n        {children}\n      </form>\n    </FormContext.Provider>\n  );\n});\n\n(FormRoot as typeof FormRoot & { displayName: string }).displayName = 'Form';\n\n/**\n * Aggregates the validation state of the `FormField`s it wraps into a single\n * submit / validity flow, without owning any control values.\n * @internal\n */\nexport const Form = FormRoot as <TValues = Record<string, unknown>>(\n  props: FormProps<TValues> & { ref?: ForwardedRef<HTMLFormElement> },\n) => ReactElement;\n"],
+  "mappings": "AAkLM;AAlLN;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAEP,SAAS,mBAA0C;AAOnD;AAAA,EACE;AAAA,OAGK;AACP,SAAS,wBAAwB;AACjC,SAAS,4BAA4B;AACrC,SAAS,kCAAkC;AAC3C,SAAS,2BAA2B;AA2CpC,MAAM,mBAA2C,CAAC;AAS3C,SAAS,cACd,OAC+B;AAC/B,MAAI,UAAU,QAAQ,OAAO,UAAU,UAAU;AAC/C,WAAO;AAAA,EACT;AACA,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,aAAa,cAC9B,OAAO,UAAU,cAAc,cAC/B,OAAO,UAAU,oBAAoB,cACrC,OAAO,UAAU,qBAAqB;AAE1C;AAEA,MAAM,WAA2B,2BAAW,SAAS,KAEnD,OAA2B,cAA6C;AACxE,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA,aAAa;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,eAAe;AAAA,IACf,GAAG;AAAA,EACL,IAAI;AAEJ,QAAM,CAAC,yBAAyB,SAAS,IACvC,2BAA2B,cAAc;AAC3C,QAAM,oBAAoB,qBAAqB,SAAS;AAIxD,QAAM,YAAY,OAAmC;AAAA,IACnD,YAAY;AAAA,EACd,CAAC;AACD,YAAU,UAAU;AAAA,IAClB,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,QAAM,kBAAkB,cAAuB,IAAI,IAAI,OAAO;AAM9D,QAAM,qBAAqB;AAAA,IACzB;AAAA,EACF;AACA,MAAI;AACJ,MAAI,oBAAoB,QAAW;AACjC,cAAU;AAAA,EACZ,OAAO;AACL,uBAAmB,YAAY;AAAA,MAC7B,MAAM,UAAU;AAAA,IAClB;AACA,cAAU,mBAAmB;AAAA,EAC/B;AAKA,sBAAoB,MAAM;AACxB,UAAM,aAAa,iBAAiB;AACpC,QAAI,CAAC,YAAY;AACf;AAAA,IACF;AACA,eAAW,MAAM,UAAU,OAAO;AAClC,WAAO,MAAM,WAAW,MAAS;AAAA,EACnC,GAAG,CAAC,eAAe,CAAC;AAGpB,YAAU,MAAM;AACd,QAAI,OAAO,QAAW;AACpB;AAAA,IACF;AACA,WAAO,iBAAiB,IAAI,OAAsB;AAAA,EACpD,GAAG,CAAC,IAAI,OAAO,CAAC;AAEhB,QAAM,eAAe;AAAA,IACnB,OAAO,EAAE,SAAiC,QAAQ,GAAG;AAAA,IACrD,CAAC,SAAS,EAAE;AAAA,EACd;AAEA,QAAM,eAAe,CAAC,UAAsC;AAE1D,UAAM,eAAe;AACrB,SAAK,QAAQ,OAAO;AAAA,EACtB;AAEA,SACE,oBAAC,YAAY,UAAZ,EAAqB,OAAO,cAC3B;AAAA,IAAC;AAAA;AAAA,MACC,KAAK;AAAA,MACL;AAAA,MACA,YAAU;AAAA,MACV,UAAU;AAAA,MACV;AAAA,MACA;AAAA,MACA,eAAa;AAAA,MACZ,GAAG;AAAA,MACH,GAAG;AAAA,MAEH;AAAA;AAAA,EACH,GACF;AAEJ,CAAC;AAEA,SAAuD,cAAc;AAO/D,MAAMA,QAAO;",
+  "names": ["Form"]
+}

package/esm/forms/form/FormMessages.js

@@ -0,0 +1,85 @@
+import { jsx } from "react/jsx-runtime";
+import {
+  forwardRef,
+  useContext,
+  useSyncExternalStore
+} from "react";
+import { FormContext } from "./context/FormContext.js";
+import { getFormById, subscribeToFormById } from "./runtime/formRegistry.js";
+import { useBehavioralTrackingProps } from "../../core/hooks/useBehavioralTrackingProps.js";
+import { Container } from "../../layouts/container/Container.js";
+import { Flex } from "../../layouts/flex/Flex.js";
+import { InternalBaseItem as BaseItem } from "../forms-core/components/form-field-messages/FormFieldMessageBaseItem.js";
+const EMPTY_MESSAGES = [];
+const noopSubscribe = () => () => void 0;
+const getEmptyMessages = () => EMPTY_MESSAGES;
+const FormMessages = /* @__PURE__ */ forwardRef(
+  (props, forwardedRef) => {
+    const {
+      as,
+      form,
+      className,
+      style,
+      "data-testid": dataTestId,
+      ...remainingProps
+    } = props;
+    const [behavioralTrackingProps, extraProps] = useBehavioralTrackingProps(remainingProps);
+    const context = useContext(FormContext);
+    const byIdRuntime = useSyncExternalStore(
+      form ? (listener) => subscribeToFormById(form, listener) : noopSubscribe,
+      () => form ? getFormById(form) : void 0
+    );
+    const runtime = context?.runtime ?? byIdRuntime;
+    const messages = useSyncExternalStore(
+      runtime?.subscribe ?? noopSubscribe,
+      runtime?.getFormMessages ?? getEmptyMessages
+    );
+    if (messages.length === 0) {
+      return null;
+    }
+    const items = messages.map((error) => /* @__PURE__ */ jsx(
+      BaseItem,
+      {
+        variant: "error",
+        children: error.message
+      },
+      `${error.validityStateKey.toString()}:${error.message}`
+    ));
+    const commonProps = {
+      "aria-live": "polite",
+      className,
+      style,
+      "data-testid": dataTestId,
+      ...behavioralTrackingProps
+    };
+    if (as !== void 0 && as !== null) {
+      const Wrapper = as;
+      return /* @__PURE__ */ jsx(
+        Wrapper,
+        {
+          ref: forwardedRef,
+          ...extraProps,
+          ...commonProps,
+          children: items
+        }
+      );
+    }
+    return /* @__PURE__ */ jsx(
+      Container,
+      {
+        ref: forwardedRef,
+        color: "critical",
+        variant: "default",
+        padding: 8,
+        ...extraProps,
+        ...commonProps,
+        children: /* @__PURE__ */ jsx(Flex, { flexDirection: "column", gap: 4, children: items })
+      }
+    );
+  }
+);
+FormMessages.displayName = "FormMessages";
+export {
+  FormMessages
+};
+//# sourceMappingURL=FormMessages.js.map

package/esm/forms/form/FormMessages.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/forms/form/FormMessages.tsx"],
+  "sourcesContent": ["import {\n  type ElementType,\n  type Ref,\n  type ReactElement,\n  forwardRef,\n  useContext,\n  useSyncExternalStore,\n} from 'react';\n\nimport { FormContext } from './context/FormContext.js';\nimport { getFormById, subscribeToFormById } from './runtime/formRegistry.js';\nimport { useBehavioralTrackingProps } from '../../core/hooks/useBehavioralTrackingProps.js';\nimport type { BehaviorTrackingProps } from '../../core/types/behavior-tracking-props.js';\nimport type { DataTestId } from '../../core/types/data-props.js';\nimport type { PolymorphicComponentProps } from '../../core/types/polymorph.js';\nimport type { StylingProps } from '../../core/types/styling-props.js';\nimport { Container } from '../../layouts/container/Container.js';\nimport { Flex } from '../../layouts/flex/Flex.js';\nimport { InternalBaseItem as BaseItem } from '../forms-core/components/form-field-messages/FormFieldMessageBaseItem.js';\nimport type { ValidationError } from '../validation/types.js';\n\n/**\n * Own props for `FormMessages`, independent of the wrapper element.\n * @internal\n */\nexport type FormMessagesOwnProps = StylingProps &\n  DataTestId &\n  BehaviorTrackingProps & {\n    /**\n     * Associates with a `<Form>` by id when rendered outside its subtree (same\n     * pattern as a native `<control form=\"\u2026\">`). Reads the nearest `<Form>` via\n     * context when omitted.\n     */\n    form?: string;\n  };\n\n/**\n * Props for `FormMessages`. Defaults to a `Container` wrapper; pass `as` to\n * swap the wrapper element and take full control of layout and styling.\n * @internal\n */\nexport type FormMessagesProps<E extends ElementType = typeof Container> =\n  PolymorphicComponentProps<E, FormMessagesOwnProps>;\n\nconst EMPTY_MESSAGES: ValidationError[] = [];\nconst noopSubscribe = () => () => undefined;\nconst getEmptyMessages = () => EMPTY_MESSAGES;\n\n/**\n * Renders the form-wide errors (`FormValidationError`) of the enclosing \u2014 or\n * `form`-associated \u2014 `<Form>`. Field errors render in each field's\n * `FormFieldMessages`, never here.\n *\n * By default wraps errors in a `Container` with `color=\"critical\"` and\n * `variant=\"default\"`. Pass `as` to replace the wrapper entirely and take full\n * control of layout and styling (e.g. `as={Flex}`).\n * @internal\n */\nexport const FormMessages: <E extends ElementType = typeof Container>(\n  props: FormMessagesProps<E>,\n) => ReactElement | null = /* @__PURE__ */ forwardRef(\n  <E extends ElementType>(\n    props: FormMessagesProps<E>,\n    forwardedRef: typeof props.ref,\n  ) => {\n    const {\n      as,\n      form,\n      className,\n      style,\n      'data-testid': dataTestId,\n      ...remainingProps\n    } = props;\n\n    const [behavioralTrackingProps, extraProps] =\n      useBehavioralTrackingProps(remainingProps);\n\n    const context = useContext(FormContext);\n    const byIdRuntime = useSyncExternalStore(\n      form ? (listener) => subscribeToFormById(form, listener) : noopSubscribe,\n      () => (form ? getFormById(form) : undefined),\n    );\n    const runtime = context?.runtime ?? byIdRuntime;\n\n    const messages = useSyncExternalStore(\n      runtime?.subscribe ?? noopSubscribe,\n      runtime?.getFormMessages ?? getEmptyMessages,\n    );\n\n    if (messages.length === 0) {\n      return null;\n    }\n\n    const items = messages.map((error) => (\n      <BaseItem\n        key={`${error.validityStateKey.toString()}:${error.message}`}\n        variant=\"error\"\n      >\n        {error.message}\n      </BaseItem>\n    ));\n\n    const commonProps = {\n      'aria-live': 'polite' as const,\n      className,\n      style,\n      'data-testid': dataTestId,\n      ...behavioralTrackingProps,\n    };\n\n    if (as !== undefined && as !== null) {\n      const Wrapper = as as ElementType;\n      return (\n        <Wrapper\n          ref={forwardedRef}\n          {...(extraProps as object)}\n          {...commonProps}\n        >\n          {items}\n        </Wrapper>\n      );\n    }\n\n    return (\n      <Container\n        ref={forwardedRef as unknown as Ref<HTMLDivElement>}\n        color=\"critical\"\n        variant=\"default\"\n        padding={8}\n        {...(extraProps as object)}\n        {...commonProps}\n      >\n        <Flex flexDirection=\"column\" gap={4}>\n          {items}\n        </Flex>\n      </Container>\n    );\n  },\n);\n\n(FormMessages as typeof FormMessages & { displayName: string }).displayName =\n  'FormMessages';\n"],
+  "mappings": "AA8FM;AA9FN;AAAA,EAIE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,mBAAmB;AAC5B,SAAS,aAAa,2BAA2B;AACjD,SAAS,kCAAkC;AAK3C,SAAS,iBAAiB;AAC1B,SAAS,YAAY;AACrB,SAAS,oBAAoB,gBAAgB;AA0B7C,MAAM,iBAAoC,CAAC;AAC3C,MAAM,gBAAgB,MAAM,MAAM;AAClC,MAAM,mBAAmB,MAAM;AAYxB,MAAM,eAE8B;AAAA,EACzC,CACE,OACA,iBACG;AACH,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,eAAe;AAAA,MACf,GAAG;AAAA,IACL,IAAI;AAEJ,UAAM,CAAC,yBAAyB,UAAU,IACxC,2BAA2B,cAAc;AAE3C,UAAM,UAAU,WAAW,WAAW;AACtC,UAAM,cAAc;AAAA,MAClB,OAAO,CAAC,aAAa,oBAAoB,MAAM,QAAQ,IAAI;AAAA,MAC3D,MAAO,OAAO,YAAY,IAAI,IAAI;AAAA,IACpC;AACA,UAAM,UAAU,SAAS,WAAW;AAEpC,UAAM,WAAW;AAAA,MACf,SAAS,aAAa;AAAA,MACtB,SAAS,mBAAmB;AAAA,IAC9B;AAEA,QAAI,SAAS,WAAW,GAAG;AACzB,aAAO;AAAA,IACT;AAEA,UAAM,QAAQ,SAAS,IAAI,CAAC,UAC1B;AAAA,MAAC;AAAA;AAAA,QAEC,SAAQ;AAAA,QAEP,gBAAM;AAAA;AAAA,MAHF,GAAG,MAAM,iBAAiB,SAAS,CAAC,IAAI,MAAM,OAAO;AAAA,IAI5D,CACD;AAED,UAAM,cAAc;AAAA,MAClB,aAAa;AAAA,MACb;AAAA,MACA;AAAA,MACA,eAAe;AAAA,MACf,GAAG;AAAA,IACL;AAEA,QAAI,OAAO,UAAa,OAAO,MAAM;AACnC,YAAM,UAAU;AAChB,aACE;AAAA,QAAC;AAAA;AAAA,UACC,KAAK;AAAA,UACJ,GAAI;AAAA,UACJ,GAAG;AAAA,UAEH;AAAA;AAAA,MACH;AAAA,IAEJ;AAEA,WACE;AAAA,MAAC;AAAA;AAAA,QACC,KAAK;AAAA,QACL,OAAM;AAAA,QACN,SAAQ;AAAA,QACR,SAAS;AAAA,QACR,GAAI;AAAA,QACJ,GAAG;AAAA,QAEJ,8BAAC,QAAK,eAAc,UAAS,KAAK,GAC/B,iBACH;AAAA;AAAA,IACF;AAAA,EAEJ;AACF;AAEC,aAA+D,cAC9D;",
+  "names": []
+}

package/esm/forms/form/context/FormContext.js

@@ -0,0 +1,8 @@
+import { createContext } from "react";
+const FormContext = createContext(
+  void 0
+);
+export {
+  FormContext
+};
+//# sourceMappingURL=FormContext.js.map

package/esm/forms/form/context/FormContext.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/forms/form/context/FormContext.ts"],
+  "sourcesContent": ["import { createContext } from 'react';\n\nimport type { FormRuntime } from '../runtime/createFormRuntime.js';\n\n/**\n * Carries the enclosing form runtime down to the controls that register with\n * it. `undefined` when a control is rendered outside any `<Form>` \u2014 controls\n * degrade gracefully to standalone behavior in that case.\n * @internal\n */\nexport interface FormContextValue {\n  /** The runtime the nearest `<Form>` created. */\n  runtime: FormRuntime;\n  /** The nearest `<Form>`'s `id`, if it set one. */\n  formId?: string;\n}\n\n/**\n * @internal\n */\nexport const FormContext = createContext<FormContextValue | undefined>(\n  undefined,\n);\n"],
+  "mappings": "AAAA,SAAS,qBAAqB;AAoBvB,MAAM,cAAc;AAAA,EACzB;AACF;",
+  "names": []
+}

package/esm/forms/form/createForm.js

@@ -0,0 +1,8 @@
+import { createFormRuntime } from "./runtime/createFormRuntime.js";
+function createForm() {
+  return createFormRuntime();
+}
+export {
+  createForm
+};
+//# sourceMappingURL=createForm.js.map

package/esm/forms/form/createForm.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/forms/form/createForm.ts"],
+  "sourcesContent": ["import type { FormApi } from './form.types.js';\nimport { createFormRuntime } from './runtime/createFormRuntime.js';\n\n/**\n * Creates a `FormApi` outside a React render. Use this when you need a form\n * handle in module scope, a non-React callback, or a store that outlives the\n * component. Inside a React component, prefer `_useForm` for a stable\n * reference across renders.\n *\n * Pass the returned handle to the `form` prop of `<Form>` so the component\n * uses this runtime instead of creating its own.\n * @internal\n */\nexport function createForm<\n  TValues = Record<string, unknown>,\n>(): FormApi<TValues> {\n  return createFormRuntime<TValues>() as FormApi<TValues>;\n}\n"],
+  "mappings": "AACA,SAAS,yBAAyB;AAY3B,SAAS,aAEM;AACpB,SAAO,kBAA2B;AACpC;",
+  "names": []
+}

package/esm/forms/form/form-error-classes.js

@@ -0,0 +1,16 @@
+import {
+  ValidationError
+} from "../validation/types.js";
+class FormValidationError extends ValidationError {
+  /** Routing target — the id of the `<Form>` whose `FormMessages` renders this. */
+  formId;
+  constructor(message, options) {
+    super(message, options);
+    this.name = "FormValidationError";
+    this.formId = options.formId;
+  }
+}
+export {
+  FormValidationError
+};
+//# sourceMappingURL=form-error-classes.js.map

package/esm/forms/form/form-error-classes.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/forms/form/form-error-classes.ts"],
+  "sourcesContent": ["import {\n  ValidationError,\n  type ValidationErrorOptions,\n} from '../validation/types.js';\n\n/**\n * A form-wide error that is not tied to any single input \u2014 an authentication\n * failure, a disabled submission, a server-side rejection that applies to the\n * whole form.\n *\n * @remarks\n * Routed by `formId` to the form-wide `FormMessages` outlet under `<Form>`. It\n * is never pushed through `setCustomValidity` because there is no native input\n * for \"the form\". The inherited `formControlId` is typically `undefined`.\n *\n * @internal\n */\nexport class FormValidationError extends ValidationError {\n  /** Routing target \u2014 the id of the `<Form>` whose `FormMessages` renders this. */\n  readonly formId: string;\n\n  constructor(\n    message: string,\n    options: ValidationErrorOptions & { formId: string },\n  ) {\n    super(message, options);\n    this.name = 'FormValidationError';\n    this.formId = options.formId;\n  }\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,OAEK;AAcA,MAAM,4BAA4B,gBAAgB;AAAA;AAAA,EAE9C;AAAA,EAET,YACE,SACA,SACA;AACA,UAAM,SAAS,OAAO;AACtB,SAAK,OAAO;AACZ,SAAK,SAAS,QAAQ;AAAA,EACxB;AACF;",
+  "names": []
+}

package/esm/forms/form/form.types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=form.types.js.map

package/esm/forms/form/form.types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

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

@@ -0,0 +1,13 @@
+import { useRef } from "react";
+import { createForm } from "../createForm.js";
+function useForm() {
+  const ref = useRef(void 0);
+  if (ref.current === void 0) {
+    ref.current = createForm();
+  }
+  return ref.current;
+}
+export {
+  useForm
+};
+//# sourceMappingURL=useForm.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/forms/form/hooks/useForm.ts"],
+  "sourcesContent": ["import { useRef } from 'react';\n\nimport { createForm } from '../createForm.js';\nimport type { FormApi } from '../form.types.js';\n\n/**\n * Creates a stable `FormApi` for the lifetime of the component. The returned\n * handle is the same object on every render \u2014 equivalent to calling\n * `_createForm` once in a `useRef`.\n *\n * Pass it to the `form` prop of `<Form>` so you can call `form.submit()`,\n * `form.setError()`, etc. from anywhere in the tree.\n * @internal\n */\nexport function useForm<TValues = Record<string, unknown>>(): FormApi<TValues> {\n  const ref = useRef<FormApi<TValues> | undefined>(undefined);\n  if (ref.current === undefined) {\n    ref.current = createForm<TValues>();\n  }\n  return ref.current;\n}\n"],
+  "mappings": "AAAA,SAAS,cAAc;AAEvB,SAAS,kBAAkB;AAYpB,SAAS,UAA+D;AAC7E,QAAM,MAAM,OAAqC,MAAS;AAC1D,MAAI,IAAI,YAAY,QAAW;AAC7B,QAAI,UAAU,WAAoB;AAAA,EACpC;AACA,SAAO,IAAI;AACb;",
+  "names": []
+}

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

@@ -0,0 +1,60 @@
+import { useFormRuntimeRegistration } from "./useFormRuntimeRegistration.js";
+import { useFormFieldMessagesContext } from "../../forms-core/hooks/useFormFieldMessagesContext.js";
+import { FormFieldMessagesAction } from "../../forms-core/state/formfield-messages-state-reducer.js";
+import {
+  ValidationError
+} from "../../validation/types.js";
+function useFormRegistration(options) {
+  const { id, name, form, focus, getValue, validate } = options;
+  const { dispatch } = useFormFieldMessagesContext();
+  const reportValidity = useFormRuntimeRegistration({
+    id,
+    name,
+    form,
+    getValue,
+    focus,
+    validateField: async ({ reveal, trigger }) => {
+      const result = await validate?.(getValue());
+      if (reveal) {
+        dispatch?.({
+          type: FormFieldMessagesAction.SETISTOUCHED,
+          payload: { isTouched: true }
+        });
+      }
+      return {
+        status: "done",
+        trigger,
+        errors: toValidationErrors(result, id)
+      };
+    },
+    resetValidation: () => {
+      dispatch?.({
+        type: FormFieldMessagesAction.SETISTOUCHED,
+        payload: { isTouched: false, resetShowError: true }
+      });
+    }
+  });
+  return reportValidity ?? (() => void 0);
+}
+function toValidationErrors(result, id) {
+  if (!result) {
+    return [];
+  }
+  if (typeof result === "string") {
+    return [
+      new ValidationError(result, { source: "custom", formControlId: id })
+    ];
+  }
+  return result.map(
+    (error) => new ValidationError(error.message, {
+      source: "custom",
+      validityStateKey: error.validityStateKey,
+      formControlId: id,
+      cause: error.cause
+    })
+  );
+}
+export {
+  useFormRegistration
+};
+//# sourceMappingURL=useFormRegistration.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/forms/form/hooks/useFormRegistration.ts"],
+  "sourcesContent": ["import { useFormRuntimeRegistration } from './useFormRuntimeRegistration.js';\nimport { useFormFieldMessagesContext } from '../../forms-core/hooks/useFormFieldMessagesContext.js';\nimport { FormFieldMessagesAction } from '../../forms-core/state/formfield-messages-state-reducer.js';\nimport {\n  ValidationError,\n  type ValidationState,\n} from '../../validation/types.js';\nimport type { FormControlValidator } from '../form.types.js';\n\n/**\n * Options for `useFormRegistration`.\n * @internal\n */\nexport interface FormRegistrationOptions<TValue = unknown> {\n  /** Logical form-control id \u2014 matches the input's `id`. */\n  id: string;\n  /** Submit key; the form snapshot keys values by `name ?? id`. */\n  name?: string;\n  /**\n   * Associates with a `<Form>` by id when the control is rendered outside the\n   * form's React subtree (mirrors the native `form=\"\u2026\"` attribute).\n   */\n  form?: string;\n  /**\n   * The underlying input element, reserved for a11y / focus wiring. Accepted\n   * now so the contract is stable; the runtime does not yet consume it \u2014 the\n   * focus/blur wiring that reads it lands with APPDEV-17909.\n   */\n  inputElement?: HTMLElement | null;\n  /** Focuses the control on error (focus-first-invalid). */\n  focus: () => void;\n  /** Reads the control's current value. */\n  getValue: () => TValue;\n  /** Optional per-control validator. */\n  validate?: FormControlValidator<TValue>;\n}\n\n/**\n * Registers a custom (non-Strato) control with the enclosing `<Form>` so it\n * participates in submit, validation, snapshot, and focus-first-invalid. Strato\n * controls do not call this directly \u2014 they register through `FormField`.\n *\n * Returns a `reportValidity` for controls that want to push live validity\n * between submits; ignoring it is fine \u2014 the form pulls each control on submit.\n * @internal\n */\nexport function useFormRegistration<TValue = unknown>(\n  options: FormRegistrationOptions<TValue>,\n): (state: ValidationState) => void {\n  const { id, name, form, focus, getValue, validate } = options;\n  const { dispatch } = useFormFieldMessagesContext();\n\n  const reportValidity = useFormRuntimeRegistration({\n    id,\n    name,\n    form,\n    getValue,\n    focus,\n    validateField: async ({ reveal, trigger }) => {\n      const result = await validate?.(getValue());\n      if (reveal) {\n        dispatch?.({\n          type: FormFieldMessagesAction.SETISTOUCHED,\n          payload: { isTouched: true },\n        });\n      }\n      return {\n        status: 'done',\n        trigger,\n        errors: toValidationErrors(result, id),\n      };\n    },\n    resetValidation: () => {\n      // Consumer-owned controls only reset touched state here; unlike the Strato\n      // path, native `customValidity` clearing is intentionally left to the\n      // consumer's own validator, which owns that element's validity.\n      dispatch?.({\n        type: FormFieldMessagesAction.SETISTOUCHED,\n        payload: { isTouched: false, resetShowError: true },\n      });\n    },\n  });\n\n  return reportValidity ?? (() => undefined);\n}\n\n/** Maps a per-control validator result to the canonical error list. @internal */\nfunction toValidationErrors(\n  result: Awaited<ReturnType<FormControlValidator>> | undefined,\n  id: string,\n): ValidationError[] {\n  if (!result) {\n    return [];\n  }\n  if (typeof result === 'string') {\n    return [\n      new ValidationError(result, { source: 'custom', formControlId: id }),\n    ];\n  }\n  return result.map(\n    (error) =>\n      new ValidationError(error.message, {\n        source: 'custom',\n        validityStateKey: error.validityStateKey,\n        formControlId: id,\n        cause: error.cause,\n      }),\n  );\n}\n"],
+  "mappings": "AAAA,SAAS,kCAAkC;AAC3C,SAAS,mCAAmC;AAC5C,SAAS,+BAA+B;AACxC;AAAA,EACE;AAAA,OAEK;AAwCA,SAAS,oBACd,SACkC;AAClC,QAAM,EAAE,IAAI,MAAM,MAAM,OAAO,UAAU,SAAS,IAAI;AACtD,QAAM,EAAE,SAAS,IAAI,4BAA4B;AAEjD,QAAM,iBAAiB,2BAA2B;AAAA,IAChD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,eAAe,OAAO,EAAE,QAAQ,QAAQ,MAAM;AAC5C,YAAM,SAAS,MAAM,WAAW,SAAS,CAAC;AAC1C,UAAI,QAAQ;AACV,mBAAW;AAAA,UACT,MAAM,wBAAwB;AAAA,UAC9B,SAAS,EAAE,WAAW,KAAK;AAAA,QAC7B,CAAC;AAAA,MACH;AACA,aAAO;AAAA,QACL,QAAQ;AAAA,QACR;AAAA,QACA,QAAQ,mBAAmB,QAAQ,EAAE;AAAA,MACvC;AAAA,IACF;AAAA,IACA,iBAAiB,MAAM;AAIrB,iBAAW;AAAA,QACT,MAAM,wBAAwB;AAAA,QAC9B,SAAS,EAAE,WAAW,OAAO,gBAAgB,KAAK;AAAA,MACpD,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AAED,SAAO,mBAAmB,MAAM;AAClC;AAGA,SAAS,mBACP,QACA,IACmB;AACnB,MAAI,CAAC,QAAQ;AACX,WAAO,CAAC;AAAA,EACV;AACA,MAAI,OAAO,WAAW,UAAU;AAC9B,WAAO;AAAA,MACL,IAAI,gBAAgB,QAAQ,EAAE,QAAQ,UAAU,eAAe,GAAG,CAAC;AAAA,IACrE;AAAA,EACF;AACA,SAAO,OAAO;AAAA,IACZ,CAAC,UACC,IAAI,gBAAgB,MAAM,SAAS;AAAA,MACjC,QAAQ;AAAA,MACR,kBAAkB,MAAM;AAAA,MACxB,eAAe;AAAA,MACf,OAAO,MAAM;AAAA,IACf,CAAC;AAAA,EACL;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,54 @@
+import {
+  useCallback,
+  useContext,
+  useEffect,
+  useRef,
+  useSyncExternalStore
+} from "react";
+import { FormContext } from "../context/FormContext.js";
+import { getFormById, subscribeToFormById } from "../runtime/formRegistry.js";
+const noopSubscribe = () => () => void 0;
+function useFormRuntimeRegistration(options) {
+  const context = useContext(FormContext);
+  const formId = options.form;
+  const byIdRuntime = useSyncExternalStore(
+    useCallback(
+      (onStoreChange) => formId ? subscribeToFormById(formId, onStoreChange) : noopSubscribe(),
+      [formId]
+    ),
+    () => formId ? getFormById(formId) : void 0
+  );
+  const runtime = context?.runtime ?? byIdRuntime;
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const handleRef = useRef(void 0);
+  const { id } = options;
+  useEffect(() => {
+    if (!runtime || id === "") {
+      return;
+    }
+    const handle = runtime.register({
+      id,
+      get name() {
+        return optionsRef.current.name;
+      },
+      getValue: () => optionsRef.current.getValue(),
+      focus: () => optionsRef.current.focus(),
+      validateField: (validateOptions) => optionsRef.current.validateField(validateOptions),
+      resetValidation: () => optionsRef.current.resetValidation?.()
+    });
+    handleRef.current = handle;
+    return () => {
+      handle.unregister();
+      handleRef.current = void 0;
+    };
+  }, [runtime, id]);
+  if (!runtime) {
+    return void 0;
+  }
+  return (state) => handleRef.current?.reportValidity(state);
+}
+export {
+  useFormRuntimeRegistration
+};
+//# sourceMappingURL=useFormRuntimeRegistration.js.map