react-aria 3.50.0 → 3.52.0

package/dist/private/tokenfield/useTokenField.mjs

@@ -0,0 +1,655 @@
+import {announce as $a46cf152bb926da5$export$a9b970dcc4ae71a9} from "../live-announcer/LiveAnnouncer.mjs";
+import {getActiveElement as $23f2114a1b82827e$export$cd4e5573fbe2b576, nodeContains as $23f2114a1b82827e$export$4282f70798064fe0} from "../utils/shadowdom/DOMFunctions.mjs";
+import {getOwnerDocument as $d447af545b77c9f1$export$b204af158042fbac} from "../utils/domHelpers.mjs";
+import {isMac as $2add3ce32c6007eb$export$9ac100e40613ea10} from "../utils/platform.mjs";
+import {mergeProps as $bbaa08b3cd72f041$export$9d1611c77c2fe928} from "../utils/mergeProps.mjs";
+import {setInteractionModality as $8f5a2122b0992be3$export$8397ddfc504fdb9a} from "../interactions/useFocusVisible.mjs";
+import {useEvent as $600b3cf69ae46262$export$90fc3a17d93f704c} from "../utils/useEvent.mjs";
+import {useField as $191c9b6d48a0a4e2$export$294aa081a6c6f55d} from "../label/useField.mjs";
+import {useFocusable as $d1116acdf220c2da$export$4c014de7c8940b4c} from "../interactions/useFocusable.mjs";
+import {useKeyboard as $8296dad1a4c5e0dc$export$8f71654801c2f7cd} from "../interactions/useKeyboard.mjs";
+import {useLayoutEffect as $c4867b2f328c2698$export$e5c5a5f917a5871c} from "../utils/useLayoutEffect.mjs";
+import {useLocale as $2eb8e6d23f3d0cb0$export$43bb16f9c6d9e3f7} from "../i18n/I18nProvider.mjs";
+import {useMemo as $v4J1t$useMemo, useRef as $v4J1t$useRef, useCallback as $v4J1t$useCallback} from "react";
+import {TokenFieldValue as $v4J1t$TokenFieldValue} from "react-stately/useTokenFieldState";
+
+/*
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing
+ */ 
+
+
+
+
+
+
+
+
+
+
+
+
+
+const $ae4a1f75a9bc78bb$var$CLIPBOARD_MIME_TYPE = 'application/vnd.react-aria.tokens+json';
+function $ae4a1f75a9bc78bb$export$adf3c8de3c7afc8b(props, state, ref) {
+    let { role: role = 'textbox', allowsNewlines: multiline = false, isReadOnly: isReadOnly = false, isDisabled: isDisabled = false, 'aria-details': ariaDetails } = props;
+    let { value: value } = state;
+    let { locale: locale } = (0, $2eb8e6d23f3d0cb0$export$43bb16f9c6d9e3f7)();
+    let graphemeSegmenter = (0, $v4J1t$useMemo)(()=>new Intl.Segmenter(locale, {
+            granularity: 'grapheme'
+        }), [
+        locale
+    ]);
+    let wordSegmenter = (0, $v4J1t$useMemo)(()=>new Intl.Segmenter(locale, {
+            granularity: 'word'
+        }), [
+        locale
+    ]);
+    let dropPosition = (0, $v4J1t$useRef)(null);
+    let transferredData = (0, $v4J1t$useRef)(null);
+    let nextValue = (0, $v4J1t$useRef)(null);
+    let apply = (fn)=>{
+        state.setValue((value)=>{
+            let newValue = fn(value);
+            nextValue.current = newValue;
+            return newValue;
+        });
+    };
+    // Composition events are not cancelable. The browser will mutate the DOM, making it out of sync with React.
+    // To account for this, we prevent React from re-rendering during composition, and track DOM mutations performed
+    // by the browser. When composition ends, we revert the DOM to its original state, and re-render with React.
+    // Mutating the DOM in any way during composition breaks the IME, causing composition to end unexpectedly.
+    // During composition, we still emit updates via onChange to ensure that things like autocomplete work,
+    // but we don't actually re-render to the DOM unless the value changes from what we expect (e.g. inserting a completion).
+    let mutationTracker = $ae4a1f75a9bc78bb$var$useMutationTracker(ref);
+    let startComposition = (0, $v4J1t$useCallback)(()=>{
+        mutationTracker.start();
+        state.setComposing(true);
+    }, [
+        state,
+        mutationTracker
+    ]);
+    let stopComposition = (0, $v4J1t$useCallback)(()=>{
+        mutationTracker.stop();
+        state.setComposing(false);
+    }, [
+        state,
+        mutationTracker
+    ]);
+    (0, $600b3cf69ae46262$export$90fc3a17d93f704c)(ref, 'compositionstart', ()=>{
+        startComposition();
+        let range = window.getSelection()?.getRangeAt(0);
+        if (range) {
+            let [start, end] = $ae4a1f75a9bc78bb$var$rangeToPositions(ref.current, range);
+            // Normalize the range to ensure it is not inside a token, otherwise the browser
+            // will attempt to insert the composed text into the token instead of replacing it.
+            let r = $ae4a1f75a9bc78bb$var$createDOMRange(ref.current, start, end);
+            if (r.startContainer !== range.startContainer || r.startOffset !== range.startOffset) range.setStart(r.startContainer, r.startOffset);
+            if (r.endContainer !== range.endContainer || r.endOffset !== range.endOffset) range.setEnd(r.endContainer, r.endOffset);
+        }
+    });
+    (0, $600b3cf69ae46262$export$90fc3a17d93f704c)(ref, 'compositionend', stopComposition);
+    // If a prop update occurs during composition that doesn't match the expected value,
+    // end composition and re-render the controlled value.
+    (0, $c4867b2f328c2698$export$e5c5a5f917a5871c)(()=>{
+        if (state.isComposing && value !== nextValue.current) stopComposition();
+        nextValue.current = value;
+    });
+    let selectedRange = (0, $v4J1t$useRef)(null);
+    (0, $c4867b2f328c2698$export$e5c5a5f917a5871c)(()=>{
+        if (ref.current && !state.isComposing && value.selectedRange !== selectedRange.current) {
+            // Only move the caret when the field is already focused.
+            if (ref.current === (0, $23f2114a1b82827e$export$cd4e5573fbe2b576)((0, $d447af545b77c9f1$export$b204af158042fbac)(ref.current))) {
+                $ae4a1f75a9bc78bb$export$9cafaa09e78b6e4b(ref.current, value.selectedRange);
+                $ae4a1f75a9bc78bb$var$announceToken(value);
+            }
+            selectedRange.current = value.selectedRange;
+        }
+    });
+    // Handle text editing commands and prevent browser default behavior.
+    (0, $600b3cf69ae46262$export$90fc3a17d93f704c)(ref, 'beforeinput', (e)=>{
+        // Android sometimes doesn't fire a compositionend event before a regular input event.
+        if (state.isComposing && !e.isComposing) stopComposition();
+        let range = e.getTargetRanges()[0];
+        if (!range) {
+            let selection = window.getSelection();
+            if (!selection || selection.rangeCount === 0) return;
+            range = selection.getRangeAt(0);
+        }
+        let [start, end] = $ae4a1f75a9bc78bb$var$rangeToPositions(ref.current, range);
+        // https://www.w3.org/TR/input-events-2/#interface-InputEvent-Attributes
+        switch(e.inputType){
+            case 'insertText':
+            case 'insertReplacementText':
+            case 'insertCompositionText':
+            case 'insertFromComposition':
+            case 'insertFromPaste':
+            case 'insertFromYank':
+            case 'insertFromDrop':
+                {
+                    let data = [
+                        {
+                            type: 'text',
+                            text: e.data ?? ''
+                        }
+                    ];
+                    if (transferredData.current) {
+                        data = transferredData.current;
+                        transferredData.current = null;
+                    } else if (e.dataTransfer) {
+                        let parsed = e.dataTransfer.types.includes($ae4a1f75a9bc78bb$var$CLIPBOARD_MIME_TYPE) ? $ae4a1f75a9bc78bb$var$parseSegments(e.dataTransfer.getData($ae4a1f75a9bc78bb$var$CLIPBOARD_MIME_TYPE)) : null;
+                        if (parsed) data = parsed;
+                        else if (e.dataTransfer.types.includes('text/plain')) data[0].text = e.dataTransfer.getData('text/plain');
+                    }
+                    if (e.inputType === 'insertFromDrop' && dropPosition.current) {
+                        start = end = dropPosition.current;
+                        dropPosition.current = null;
+                    }
+                    if (!multiline) for (let segment of data)segment.text = segment.text.replace(/[\r\n]+/g, ' ');
+                    apply((tokens)=>tokens.replaceRangeWithSegments(start, end, data, // Don't coalesce paste/drop events with other edits.
+                        e.inputType === 'insertText' || e.inputType === 'insertCompositionText' || e.inputType === 'insertFromComposition'));
+                    break;
+                }
+            case 'insertParagraph':
+                if (props.onSubmit) {
+                    props.onSubmit();
+                    break;
+                }
+            case 'insertLineBreak':
+                if (multiline) apply((tokens)=>tokens.replaceRange(start, end, '\n'));
+                break;
+            case 'deleteContentBackward':
+            case 'deleteContentForward':
+            case 'deleteWordBackward':
+            case 'deleteWordForward':
+            case 'deleteHardLineForward':
+            case 'deleteHardLineBackward':
+            case 'deleteSoftLineForward':
+            case 'deleteSoftLineBackward':
+            case 'deleteContent':
+            case 'deleteByCut':
+            case 'deleteCompositionText':
+                if (!range.collapsed && !$ae4a1f75a9bc78bb$var$isSamePosition(start, end)) {
+                    apply((tokens)=>tokens.replaceRange(start, end, ''));
+                    break;
+                }
+                switch(e.inputType){
+                    case 'deleteContentBackward':
+                        apply((tokens)=>tokens.delete(start, graphemeSegmenter, (0, $v4J1t$TokenFieldValue).Direction.Backward));
+                        break;
+                    case 'deleteContentForward':
+                        apply((tokens)=>tokens.delete(start, graphemeSegmenter, (0, $v4J1t$TokenFieldValue).Direction.Forward));
+                        break;
+                    case 'deleteWordBackward':
+                        apply((tokens)=>tokens.delete(start, wordSegmenter, (0, $v4J1t$TokenFieldValue).Direction.Backward));
+                        break;
+                    case 'deleteWordForward':
+                        apply((tokens)=>tokens.delete(start, wordSegmenter, (0, $v4J1t$TokenFieldValue).Direction.Forward));
+                        break;
+                    case 'deleteHardLineForward':
+                    case 'deleteSoftLineForward':
+                        apply((tokens)=>tokens.deleteLine(start, (0, $v4J1t$TokenFieldValue).Direction.Forward));
+                        break;
+                    case 'deleteHardLineBackward':
+                    case 'deleteSoftLineBackward':
+                        apply((tokens)=>tokens.deleteLine(start, (0, $v4J1t$TokenFieldValue).Direction.Backward));
+                        break;
+                }
+                break;
+            case 'deleteByDrag':
+                apply((tokens)=>{
+                    let endOffset = start.index === end.index ? end.offset : tokens.segments[start.index].text.length;
+                    let change = tokens.replaceRange(start, end, '');
+                    if (dropPosition.current && dropPosition.current.index === start.index && dropPosition.current.offset >= start.offset) dropPosition.current.offset -= endOffset - start.offset;
+                    return change;
+                });
+                break;
+        }
+        e.preventDefault();
+    });
+    let writeClipboardData = (e)=>{
+        if ('clipboardData' in e) e.preventDefault();
+        let selection = $ae4a1f75a9bc78bb$export$ca798a7e6e94638c(ref.current);
+        if (!selection) return;
+        let [start, end] = selection;
+        let slice = value.slice(start, end);
+        let dataTransfer = 'clipboardData' in e ? e.clipboardData : e.dataTransfer;
+        dataTransfer?.setData($ae4a1f75a9bc78bb$var$CLIPBOARD_MIME_TYPE, JSON.stringify(slice.segments));
+        dataTransfer?.setData('text/plain', slice.toString());
+        if (e.type === 'cut') apply((tokens)=>tokens.replaceRange(start, end, '', false));
+    };
+    (0, $600b3cf69ae46262$export$90fc3a17d93f704c)(ref, 'copy', writeClipboardData);
+    (0, $600b3cf69ae46262$export$90fc3a17d93f704c)(ref, 'cut', writeClipboardData);
+    (0, $600b3cf69ae46262$export$90fc3a17d93f704c)(ref, 'dragstart', writeClipboardData);
+    (0, $600b3cf69ae46262$export$90fc3a17d93f704c)(ref, 'paste', (e)=>{
+        // Safari doesn't pass the custom clipboard data type to beforeinput dataTransfer so we handle it here.
+        if (e.clipboardData && e.clipboardData.types.includes($ae4a1f75a9bc78bb$var$CLIPBOARD_MIME_TYPE)) transferredData.current = $ae4a1f75a9bc78bb$var$parseSegments(e.clipboardData.getData($ae4a1f75a9bc78bb$var$CLIPBOARD_MIME_TYPE));
+    });
+    // Store the cursor position on drop so we know where to insert when the insertFromDrop event occurs.
+    (0, $600b3cf69ae46262$export$90fc3a17d93f704c)(ref, 'drop', (e)=>{
+        if (typeof document.caretPositionFromPoint === 'function') {
+            let pos = document.caretPositionFromPoint(e.clientX, e.clientY);
+            if (pos) dropPosition.current = $ae4a1f75a9bc78bb$var$getPosition(ref.current, pos.offsetNode, pos.offset);
+        } else if (typeof document.caretRangeFromPoint === 'function') {
+            let range = document.caretRangeFromPoint(e.clientX, e.clientY);
+            if (range) dropPosition.current = $ae4a1f75a9bc78bb$var$getPosition(ref.current, range.startContainer, range.startOffset);
+        }
+        if (e.dataTransfer && e.dataTransfer.types.includes($ae4a1f75a9bc78bb$var$CLIPBOARD_MIME_TYPE)) transferredData.current = $ae4a1f75a9bc78bb$var$parseSegments(e.dataTransfer.getData($ae4a1f75a9bc78bb$var$CLIPBOARD_MIME_TYPE));
+    });
+    $ae4a1f75a9bc78bb$var$useSelectionChange(ref, ()=>{
+        if (state.isComposing) return;
+        value.endCoalescing();
+        // When the cursor moves next to a token, announce it.
+        // Otherwise the screen reader will only announce the first/last character.
+        let range = $ae4a1f75a9bc78bb$export$6ec3e5953919831d(ref.current);
+        if (!range) return;
+        $ae4a1f75a9bc78bb$var$announceToken(value, range);
+        // Update the selected range in the value.
+        state.setValue((value)=>value.withSelectedRange(range));
+    });
+    // Clear selection on blur.
+    (0, $600b3cf69ae46262$export$90fc3a17d93f704c)(ref, 'blur', (e)=>{
+        if (!e.isTrusted) return;
+        let selection = window.getSelection();
+        if (ref.current && selection && selection.containsNode(ref.current, true)) {
+            selection.removeAllRanges();
+            state.setValue((value)=>value.withSelectedRange(new (0, $v4J1t$TokenFieldValue).SelectedRange(value.caretPosition)));
+        }
+    });
+    // Override the default triple click behavior to ensure that tokens get selected.
+    // Some browsers only select the text between tokens instead of the entire line.
+    (0, $600b3cf69ae46262$export$90fc3a17d93f704c)(ref, 'mousedown', (e)=>{
+        if (e.detail === 3) {
+            let selection = $ae4a1f75a9bc78bb$export$ca798a7e6e94638c(ref.current);
+            if (!selection) return;
+            let start = value.findLineBoundary(selection[0], (0, $v4J1t$TokenFieldValue).Direction.Backward);
+            let end = value.findLineBoundary(selection[1], (0, $v4J1t$TokenFieldValue).Direction.Forward);
+            if (start && end) {
+                e.preventDefault();
+                $ae4a1f75a9bc78bb$export$9cafaa09e78b6e4b(ref.current, new (0, $v4J1t$TokenFieldValue).SelectedRange(start, end), true);
+            }
+        }
+    });
+    let moveSelection = (direction, granularity, extend = false)=>{
+        let selection = window.getSelection();
+        if (!selection || selection.rangeCount === 0 || !selection.focusNode || !selection.anchorNode) return false;
+        // Pressing an arrow with a non-empty selection collapses it to the corresponding edge.
+        // The browser handles this natively.
+        if (!extend && !selection.isCollapsed) return false;
+        // Move the caret using the browser's native caret movement (Selection.modify) so that
+        // bidirectional text is handled correctly. Repeat until the position actually changes
+        // to account for the zero width spaces around tokens.
+        let pos = $ae4a1f75a9bc78bb$var$getPosition(ref.current, selection.focusNode, selection.focusOffset);
+        while(true){
+            let { focusNode: focusNode, focusOffset: focusOffset } = selection;
+            selection.modify(extend ? 'extend' : 'move', direction, granularity);
+            if (selection.focusNode === focusNode && selection.focusOffset === focusOffset) return false;
+            let newPos = $ae4a1f75a9bc78bb$var$getPosition(ref.current, selection.focusNode, selection.focusOffset);
+            if (!$ae4a1f75a9bc78bb$var$isSamePosition(pos, newPos)) return true;
+        }
+    };
+    // macOS supports additional keyboard shortcuts for text editing.
+    // We need to handle these manually so they behave consistently with tokens.
+    // https://support.apple.com/en-us/102650#text
+    let macShortcuts = (0, $2add3ce32c6007eb$export$9ac100e40613ea10)() ? {
+        'Control+a': ()=>{
+            return shortcuts.Home();
+        },
+        'Control+e': ()=>{
+            return shortcuts.End();
+        },
+        'Control+f': ()=>{
+            return shortcuts.ArrowRight();
+        },
+        'Control+b': ()=>{
+            return shortcuts.ArrowLeft();
+        }
+    } : {};
+    let mod = (0, $2add3ce32c6007eb$export$9ac100e40613ea10)() ? 'Meta' : 'Control';
+    let wordModKey = (0, $2add3ce32c6007eb$export$9ac100e40613ea10)() ? 'Alt' : 'Control';
+    let shortcuts = {
+        ...macShortcuts,
+        [`${mod}+z`]: ()=>{
+            // If composing, the browser handles undo natively.
+            if (state.isComposing) return false;
+            apply((state)=>state.undo());
+        },
+        [(0, $2add3ce32c6007eb$export$9ac100e40613ea10)() ? 'Shift+Meta+z' : 'Control+y']: ()=>{
+            if (state.isComposing) return false;
+            apply((state)=>state.redo());
+        },
+        ArrowLeft: ()=>{
+            return moveSelection('left', 'character');
+        },
+        [`${wordModKey}+ArrowLeft`]: ()=>{
+            return moveSelection('left', 'word');
+        },
+        'Shift+ArrowLeft': ()=>{
+            return moveSelection('left', 'character', true);
+        },
+        [`Shift+${wordModKey}+ArrowLeft`]: ()=>{
+            return moveSelection('left', 'word', true);
+        },
+        ArrowRight: ()=>{
+            return moveSelection('right', 'character');
+        },
+        [`${wordModKey}+ArrowRight`]: ()=>{
+            return moveSelection('right', 'word');
+        },
+        'Shift+ArrowRight': ()=>{
+            return moveSelection('right', 'character', true);
+        },
+        [`Shift+${wordModKey}+ArrowRight`]: ()=>{
+            return moveSelection('right', 'word', true);
+        },
+        Home: ()=>{
+            // Browsers do not behave consistently when there are tokens.
+            let selection = $ae4a1f75a9bc78bb$export$ca798a7e6e94638c(ref.current);
+            if (!selection) return false;
+            let boundary = value.findLineBoundary(selection[0], (0, $v4J1t$TokenFieldValue).Direction.Backward);
+            if (boundary) {
+                $ae4a1f75a9bc78bb$var$setCursor(ref.current, boundary, true);
+                return true;
+            }
+            return false;
+        },
+        End: ()=>{
+            let selection = $ae4a1f75a9bc78bb$export$ca798a7e6e94638c(ref.current);
+            if (!selection) return false;
+            let boundary = value.findLineBoundary(selection[1], (0, $v4J1t$TokenFieldValue).Direction.Forward);
+            if (boundary) {
+                $ae4a1f75a9bc78bb$var$setCursor(ref.current, boundary, true);
+                return true;
+            }
+            return false;
+        }
+    };
+    // TODO: user provided onKeyDown currently relies on user provided preventDefault to stop submit
+    // maybe can have them specify a format like shortcuts and merge into above?
+    let { keyboardProps: keyboardProps } = (0, $8296dad1a4c5e0dc$export$8f71654801c2f7cd)({
+        isDisabled: isDisabled || isReadOnly,
+        onKeyDown: props.onKeyDown,
+        onKeyUp: props.onKeyUp,
+        shortcuts: shortcuts,
+        allowRepeats: true
+    });
+    let { focusableProps: focusableProps } = (0, $d1116acdf220c2da$export$4c014de7c8940b4c)(props, ref);
+    let { labelProps: labelProps, fieldProps: fieldProps, descriptionProps: descriptionProps } = (0, $191c9b6d48a0a4e2$export$294aa081a6c6f55d)({
+        ...props,
+        labelElementType: 'span'
+    });
+    return {
+        labelProps: {
+            ...labelProps,
+            onClick: ()=>{
+                if (!props.isDisabled) {
+                    ref.current?.focus();
+                    // Show the focus ring so the user knows where focus went
+                    (0, $8f5a2122b0992be3$export$8397ddfc504fdb9a)('keyboard');
+                }
+            }
+        },
+        descriptionProps: descriptionProps,
+        tokenFieldProps: (0, $bbaa08b3cd72f041$export$9d1611c77c2fe928)(focusableProps, keyboardProps, fieldProps, {
+            onPaste: props.onPaste,
+            onCopy: props.onCopy,
+            onCut: props.onCut,
+            contentEditable: !isDisabled && !isReadOnly,
+            suppressContentEditableWarning: true,
+            role: role,
+            'aria-multiline': multiline,
+            'aria-details': ariaDetails,
+            'aria-readonly': isReadOnly,
+            'aria-disabled': isDisabled,
+            style: {
+                whiteSpace: 'pre-wrap'
+            }
+        })
+    };
+}
+function $ae4a1f75a9bc78bb$var$indexOfNode(node) {
+    let index = 0;
+    let n = node;
+    while(n = n.previousSibling)index++;
+    return index;
+}
+function $ae4a1f75a9bc78bb$export$ca798a7e6e94638c(container) {
+    let selection = window.getSelection();
+    if (!selection || selection.rangeCount === 0) return null;
+    let range = selection.getRangeAt(0);
+    return $ae4a1f75a9bc78bb$var$rangeToPositions(container, range);
+}
+function $ae4a1f75a9bc78bb$export$6ec3e5953919831d(container) {
+    let selection = window.getSelection();
+    if (!selection || !selection.anchorNode || !selection.focusNode || !(0, $23f2114a1b82827e$export$4282f70798064fe0)(container, selection.anchorNode) || !(0, $23f2114a1b82827e$export$4282f70798064fe0)(container, selection.focusNode)) return null;
+    let anchor = $ae4a1f75a9bc78bb$var$getPosition(container, selection.anchorNode, selection.anchorOffset, false);
+    let current = $ae4a1f75a9bc78bb$var$getPosition(container, selection.focusNode, selection.focusOffset, !selection.isCollapsed);
+    return new (0, $v4J1t$TokenFieldValue).SelectedRange(anchor, current);
+}
+function $ae4a1f75a9bc78bb$var$rangeToPositions(container, range) {
+    let start = $ae4a1f75a9bc78bb$var$getPosition(container, range.startContainer, range.startOffset, false);
+    let end = $ae4a1f75a9bc78bb$var$getPosition(container, range.endContainer, range.endOffset, !range.collapsed);
+    return [
+        start,
+        end
+    ];
+}
+function $ae4a1f75a9bc78bb$var$getPosition(container, node, offset, isRangeEnd = false) {
+    if (node === container) return {
+        index: offset,
+        offset: 0
+    };
+    let originalNode = node;
+    while(node.parentNode !== container)node = node.parentNode;
+    let index = $ae4a1f75a9bc78bb$var$indexOfNode(node);
+    if (node.nodeType === Node.ELEMENT_NODE) {
+        let tokenNode = node.childNodes[1];
+        let atEnd;
+        let endOffset = 0;
+        if (originalNode === tokenNode) // Cursor is inside the token.
+        atEnd = isRangeEnd || offset > 0;
+        else if (originalNode === node) // Cursor is inside the wrapper element.
+        atEnd = offset > 1;
+        else {
+            // Cursor is on one of the zero width spaces.
+            atEnd = originalNode !== tokenNode.previousSibling;
+            // If the offset is greater than 1, the browser is trying to insert text into
+            // the zero width space node. This will actually end up in the next text node.
+            endOffset = atEnd && offset > 1 ? offset - 1 : 0;
+        }
+        offset = atEnd ? tokenNode?.textContent?.length ?? 0 : 0;
+        // Several positions are equivalent due to the zero width spaces around tokens.
+        // Normalize offset to the end of the preceding text node, or the beginning of the following node.
+        if (offset === 0 && node.previousSibling?.nodeType === Node.TEXT_NODE) {
+            index--;
+            offset = node.previousSibling?.textContent?.length ?? 0;
+        } else if (atEnd) {
+            index++;
+            offset = endOffset;
+        }
+    }
+    return {
+        index: index,
+        offset: offset
+    };
+}
+let $ae4a1f75a9bc78bb$var$isProgrammaticSelectionChange = Symbol('isProgrammaticSelectionChange');
+function $ae4a1f75a9bc78bb$var$setCursor(root, pos, fireEvent = false) {
+    $ae4a1f75a9bc78bb$export$9cafaa09e78b6e4b(root, new (0, $v4J1t$TokenFieldValue).SelectedRange(pos), fireEvent);
+}
+function $ae4a1f75a9bc78bb$export$9cafaa09e78b6e4b(root, selectedRange, fireEvent = false) {
+    let selection = window.getSelection();
+    if (selection) {
+        // Use setBaseAndExtent to preserve the selection direction. A plain Range +
+        // addRange always produces a forward selection and collapses when the
+        // anchor comes after the current position (backward selections).
+        let [anchorNode, anchorOffset] = $ae4a1f75a9bc78bb$var$getDOMPosition(root, selectedRange.anchor);
+        let [focusNode, focusOffset] = $ae4a1f75a9bc78bb$var$getDOMPosition(root, selectedRange.current);
+        root[$ae4a1f75a9bc78bb$var$isProgrammaticSelectionChange] = !fireEvent;
+        // Only set selection if it has changed, because this can clobber the browser's selection direction.
+        if (selection.anchorNode !== anchorNode || selection.anchorOffset !== anchorOffset || selection.focusNode !== focusNode || selection.focusOffset !== focusOffset) selection.setBaseAndExtent(anchorNode, anchorOffset, focusNode, focusOffset);
+    }
+}
+function $ae4a1f75a9bc78bb$export$30729a8cd0694a7c(root, pos) {
+    // Unlike createDOMRange (used for caret/selection placement), this range is only
+    // measured via getBoundingClientRect to position things like an autocomplete popover.
+    // Place the endpoints inside the token's zero width space wrappers so the range has a
+    // valid rect at the token, rather than a collapsed root-level position.
+    let range = document.createRange();
+    let [startContainer, startOffset] = $ae4a1f75a9bc78bb$var$getDOMRectPosition(root, pos);
+    range.setStart(startContainer, startOffset);
+    range.setEnd(startContainer, startOffset);
+    return range;
+}
+function $ae4a1f75a9bc78bb$var$getDOMRectPosition(root, pos) {
+    let child = root.childNodes[pos.index];
+    if (child && child.nodeType === Node.ELEMENT_NODE) {
+        // Place the position inside the zero width space wrappers around the token.
+        if (pos.offset > 0) return [
+            child.lastChild,
+            1
+        ];
+        else return [
+            child.firstChild,
+            0
+        ];
+    }
+    return $ae4a1f75a9bc78bb$var$getDOMPosition(root, pos);
+}
+function $ae4a1f75a9bc78bb$var$createDOMRange(root, start, end) {
+    let range = document.createRange();
+    let [startContainer, startOffset] = $ae4a1f75a9bc78bb$var$getDOMPosition(root, start);
+    let [endContainer, endOffset] = $ae4a1f75a9bc78bb$var$getDOMPosition(root, end);
+    range.setStart(startContainer, startOffset);
+    range.setEnd(endContainer, endOffset);
+    return range;
+}
+function $ae4a1f75a9bc78bb$var$getDOMPosition(root, pos) {
+    let index = Math.max(0, Math.min(root.childNodes.length, pos.index));
+    let child = root.childNodes[index];
+    if (!child) return [
+        root,
+        index
+    ];
+    else if (child.nodeType === Node.ELEMENT_NODE) {
+        // Place the cursor outside the token wrapper element.
+        // This is necessary for composition events.
+        if (pos.offset > 0) return [
+            root,
+            index + 1
+        ];
+        else return [
+            root,
+            index
+        ];
+    } else {
+        let offset = Math.max(0, Math.min(child.textContent?.length ?? 0, pos.offset));
+        return [
+            child,
+            offset
+        ];
+    }
+}
+function $ae4a1f75a9bc78bb$var$isSamePosition(a, b) {
+    return a.index === b.index && a.offset === b.offset;
+}
+// Parse and validate segments from clipboard/drag data. Returns null if the data is not valid
+// JSON or does not match the expected shape, so malformed or untrusted data is ignored rather
+// than throwing or being inserted into the field.
+function $ae4a1f75a9bc78bb$var$parseSegments(json) {
+    try {
+        let data = JSON.parse(json);
+        if (Array.isArray(data) && data.length > 0 && data.every($ae4a1f75a9bc78bb$var$isValidSegment)) return data;
+    } catch  {
+    // Ignore invalid clipboard data.
+    }
+    return null;
+}
+function $ae4a1f75a9bc78bb$var$isValidSegment(segment) {
+    return typeof segment === 'object' && segment != null && (segment.type === 'text' || segment.type === 'token') && typeof segment.text === 'string';
+}
+function $ae4a1f75a9bc78bb$var$useSelectionChange(ref, handler) {
+    (0, $600b3cf69ae46262$export$90fc3a17d93f704c)((0, $v4J1t$useRef)(typeof document !== 'undefined' ? document : null), 'selectionchange', ()=>{
+        if (ref.current && ref.current[$ae4a1f75a9bc78bb$var$isProgrammaticSelectionChange]) {
+            ref.current[$ae4a1f75a9bc78bb$var$isProgrammaticSelectionChange] = false;
+            return;
+        }
+        let selection = window.getSelection();
+        if (!selection || selection.rangeCount === 0 || !ref.current) return;
+        let range = selection.getRangeAt(0);
+        if (range.intersectsNode(ref.current)) handler();
+    });
+}
+function $ae4a1f75a9bc78bb$var$useMutationTracker(ref) {
+    let mutationTracker = (0, $v4J1t$useRef)(null);
+    // Disconnect the mutation observer if the field unmounts mid-composition.
+    (0, $c4867b2f328c2698$export$e5c5a5f917a5871c)(()=>()=>{
+            mutationTracker.current?.();
+            mutationTracker.current = null;
+        }, []);
+    return (0, $v4J1t$useMemo)(()=>({
+            start () {
+                // Android sometimes fires two compositionstart events in a row, without a compositionend.
+                // In that case, reuse the existing tracker.
+                mutationTracker.current ||= $ae4a1f75a9bc78bb$var$trackMutations(ref.current);
+            },
+            stop () {
+                mutationTracker.current?.();
+                mutationTracker.current = null;
+            }
+        }), // eslint-disable-next-line react-hooks/exhaustive-deps - conflicts with compiler
+    []);
+}
+// Tracks mutations to the DOM until the returned function is called,
+// at which point the mutations are reverted.
+function $ae4a1f75a9bc78bb$var$trackMutations(element) {
+    let mutations = [];
+    let observer = new MutationObserver((records)=>{
+        mutations.push(...records);
+    });
+    observer.observe(element, {
+        childList: true,
+        subtree: true,
+        characterData: true,
+        characterDataOldValue: true
+    });
+    return ()=>{
+        mutations.push(...observer.takeRecords());
+        observer.disconnect();
+        for (let record of mutations.reverse())switch(record.type){
+            case 'childList':
+                for (let node of record.removedNodes)record.target.insertBefore(node, record.nextSibling);
+                for (let node of record.addedNodes)record.target.removeChild(node);
+                break;
+            case 'characterData':
+                record.target.nodeValue = record.oldValue;
+                break;
+        }
+    };
+}
+function $ae4a1f75a9bc78bb$var$announceToken(value, range = value.selectedRange) {
+    if (range.isCollapsed) {
+        // Announce adjacent tokens.
+        let segment = value.segments[range.current.index];
+        if (segment && segment.type !== 'token') {
+            if (range.current.offset === 0) segment = value.segments[range.current.index - 1];
+            else if (range.current.offset === segment.text.length) segment = value.segments[range.current.index + 1];
+        }
+        if (segment?.type === 'token') (0, $a46cf152bb926da5$export$a9b970dcc4ae71a9)(segment.text, 'assertive');
+    } else {
+        // Announce token if it is the only thing selected.
+        let selected = value.slice(range.start, range.end).segments;
+        if (selected.length === 1 && selected[0].type === 'token') (0, $a46cf152bb926da5$export$a9b970dcc4ae71a9)(selected[0].text, 'assertive');
+    }
+}
+
+
+export {$ae4a1f75a9bc78bb$export$adf3c8de3c7afc8b as useTokenField, $ae4a1f75a9bc78bb$export$9cafaa09e78b6e4b as setTokenFieldSelection, $ae4a1f75a9bc78bb$export$ca798a7e6e94638c as getSelection, $ae4a1f75a9bc78bb$export$6ec3e5953919831d as getSelectedRange, $ae4a1f75a9bc78bb$export$30729a8cd0694a7c as tokenFieldPositionToDOMRange};
+//# sourceMappingURL=useTokenField.mjs.map