@cloudscape-design/components 3.0.1269 → 3.0.1271

package/prompt-input/core/caret-utils.js

@@ -0,0 +1,183 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { isHTMLElement } from '../../internal/utils/dom';
+import { ElementType } from './constants';
+import { getTokenType, isCaretSpotType, isReferenceElementType } from './dom-utils';
+import { isTextNode } from './type-guards';
+// Module-level flag: mouse state is inherently global (one mouse per document)
+// and must be accessible from the standalone normalizeSelection function.
+let isMouseDown = false;
+/** Updates the mouse-down tracking flag used to skip selection normalization during drag. */
+export function setMouseDown(value) {
+    isMouseDown = value;
+}
+/** Returns whether the mouse is currently pressed. */
+export function getMouseDown() {
+    return isMouseDown;
+}
+/**
+ * Checks whether a node is inside a reference element's internals or directly
+ * on the contentEditable div (not inside a paragraph). These are non-typeable
+ * positions where the caret should not rest.
+ */
+export function isNonTypeablePosition(node) {
+    while (node) {
+        if (node.nodeName === 'P') {
+            return false;
+        }
+        if (isHTMLElement(node)) {
+            if (isReferenceElementType(getTokenType(node))) {
+                return true;
+            }
+            if (node.getAttribute('contenteditable') === 'true') {
+                return true;
+            }
+        }
+        node = node.parentNode;
+    }
+    return false;
+}
+/**
+ * Finds the reference wrapper element that contains the given node, if any.
+ * Returns null if the node is not inside a reference element.
+ */
+export function findContainingReference(node) {
+    while (node) {
+        if (node.nodeName === 'P') {
+            return null;
+        }
+        if (isHTMLElement(node) && isReferenceElementType(getTokenType(node))) {
+            return node;
+        }
+        node = node.parentNode;
+    }
+    return null;
+}
+/**
+ * Moves a collapsed caret out of non-typeable positions into the parent paragraph.
+ * Handles caret inside reference element internals (caret spots, token container)
+ * and caret on the contentEditable div itself (clicking on padding).
+ * Some browsers (notably Firefox) may place the caret in these positions on focus
+ * or imprecise clicks.
+ */
+export function normalizeCollapsedCaret(selection) {
+    var _a;
+    if (!(selection === null || selection === void 0 ? void 0 : selection.rangeCount)) {
+        return;
+    }
+    const range = selection.getRangeAt(0);
+    if (!range.collapsed) {
+        return;
+    }
+    const container = range.startContainer;
+    // Walk up from the caret position to find a reference wrapper.
+    let node = isTextNode(container) ? container.parentElement : container;
+    let wrapper = null;
+    let caretSpotType = null;
+    while (node && isHTMLElement(node)) {
+        const tokenType = getTokenType(node);
+        if (isCaretSpotType(tokenType)) {
+            caretSpotType = tokenType;
+        }
+        if (isReferenceElementType(tokenType)) {
+            wrapper = node;
+            break;
+        }
+        node = node.parentElement;
+    }
+    if (!wrapper) {
+        return;
+    }
+    const paragraph = wrapper.parentElement;
+    if (!paragraph) {
+        return;
+    }
+    const wrapperIndex = Array.from(paragraph.childNodes).indexOf(wrapper);
+    // If we know the caret was in the before-spot, position before the wrapper.
+    // Otherwise position after it (after-spot, token container, or wrapper itself).
+    const newOffset = caretSpotType === ElementType.CaretSpotBefore ? wrapperIndex : wrapperIndex + 1;
+    // Guard: skip if the selection is already at the target position.
+    if (range.startContainer === paragraph && range.startOffset === newOffset) {
+        return;
+    }
+    const newRange = ((_a = container.ownerDocument) !== null && _a !== void 0 ? _a : document).createRange();
+    newRange.setStart(paragraph, newOffset);
+    newRange.collapse(true);
+    selection.removeAllRanges();
+    selection.addRange(newRange);
+}
+/** Adjusts non-collapsed selection boundaries to exclude caret spot elements. */
+export function normalizeSelection(selection, skipCaretSpots = false) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    if (!(selection === null || selection === void 0 ? void 0 : selection.rangeCount)) {
+        return;
+    }
+    const range = selection.getRangeAt(0);
+    if (range.collapsed || isMouseDown || skipCaretSpots) {
+        return;
+    }
+    const normalizeBoundary = (container) => {
+        if (!isTextNode(container)) {
+            return null;
+        }
+        const parent = container.parentElement;
+        if (!parent) {
+            return null;
+        }
+        const parentType = getTokenType(parent);
+        if (!isCaretSpotType(parentType)) {
+            return null;
+        }
+        const wrapper = parent.parentElement;
+        if (!wrapper || !isReferenceElementType(getTokenType(wrapper))) {
+            return null;
+        }
+        const paragraph = wrapper.parentElement;
+        if (!paragraph) {
+            return null;
+        }
+        const wrapperIndex = Array.from(paragraph.childNodes).indexOf(wrapper);
+        const newOffset = parentType === ElementType.CaretSpotBefore ? wrapperIndex : wrapperIndex + 1;
+        return { container: paragraph, offset: newOffset };
+    };
+    const normalizedStart = normalizeBoundary(range.startContainer);
+    const normalizedEnd = normalizeBoundary(range.endContainer);
+    if (!normalizedStart && !normalizedEnd) {
+        return;
+    }
+    const newStartContainer = (_a = normalizedStart === null || normalizedStart === void 0 ? void 0 : normalizedStart.container) !== null && _a !== void 0 ? _a : range.startContainer;
+    const newStartOffset = (_b = normalizedStart === null || normalizedStart === void 0 ? void 0 : normalizedStart.offset) !== null && _b !== void 0 ? _b : range.startOffset;
+    const newEndContainer = (_c = normalizedEnd === null || normalizedEnd === void 0 ? void 0 : normalizedEnd.container) !== null && _c !== void 0 ? _c : range.endContainer;
+    const newEndOffset = (_d = normalizedEnd === null || normalizedEnd === void 0 ? void 0 : normalizedEnd.offset) !== null && _d !== void 0 ? _d : range.endOffset;
+    // Guard: skip if the selection already matches the normalized boundaries.
+    // Prevents Safari from entering an infinite selectionchange loop in RTL.
+    if (range.startContainer === newStartContainer &&
+        range.startOffset === newStartOffset &&
+        range.endContainer === newEndContainer &&
+        range.endOffset === newEndOffset) {
+        return;
+    }
+    // Determine if the selection is backward (focus before anchor in document order).
+    // Range always has start <= end, but the user may be selecting in reverse.
+    const isBackward = selection.anchorNode === range.endContainer &&
+        selection.anchorOffset === range.endOffset &&
+        selection.focusNode === range.startContainer &&
+        selection.focusOffset === range.startOffset;
+    if (isBackward) {
+        // Preserve backward direction: collapse to anchor (end), extend to focus (start)
+        const anchorContainer = (_e = normalizedEnd === null || normalizedEnd === void 0 ? void 0 : normalizedEnd.container) !== null && _e !== void 0 ? _e : range.endContainer;
+        const anchorOffset = (_f = normalizedEnd === null || normalizedEnd === void 0 ? void 0 : normalizedEnd.offset) !== null && _f !== void 0 ? _f : range.endOffset;
+        const focusContainer = (_g = normalizedStart === null || normalizedStart === void 0 ? void 0 : normalizedStart.container) !== null && _g !== void 0 ? _g : range.startContainer;
+        const focusOffset = (_h = normalizedStart === null || normalizedStart === void 0 ? void 0 : normalizedStart.offset) !== null && _h !== void 0 ? _h : range.startOffset;
+        selection.collapse(anchorContainer, anchorOffset);
+        selection.extend(focusContainer, focusOffset);
+    }
+    else {
+        const updatedRange = ((_j = range.startContainer.ownerDocument) !== null && _j !== void 0 ? _j : document).createRange();
+        updatedRange.setStart(newStartContainer, newStartOffset);
+        updatedRange.setEnd(newEndContainer, newEndOffset);
+        selection.removeAllRanges();
+        selection.addRange(updatedRange);
+    }
+}
+//# sourceMappingURL=caret-utils.js.map

package/prompt-input/core/caret-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caret-utils.js","sourceRoot":"","sources":["../../../../src/prompt-input/core/caret-utils.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,sCAAsC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,+EAA+E;AAC/E,0EAA0E;AAC1E,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,6FAA6F;AAC7F,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,WAAW,GAAG,KAAK,CAAC;AACtB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,YAAY;IAC1B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAiB;IACrD,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,QAAQ,KAAK,GAAG,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,IAAI,sBAAsB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBAC/C,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,KAAK,MAAM,EAAE,CAAC;gBACpD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAiB;IACvD,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,QAAQ,KAAK,GAAG,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACtE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAA2B;;IACjE,IAAI,CAAC,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,UAAU,CAAA,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAEtC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC;IAEvC,+DAA+D;IAC/D,IAAI,IAAI,GAAgB,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAE,SAAyB,CAAC;IACrG,IAAI,OAAO,GAAuB,IAAI,CAAC;IACvC,IAAI,aAAa,GAAuB,IAAI,CAAC;IAE7C,OAAO,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAErC,IAAI,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,aAAa,GAAG,SAAwB,CAAC;QAC3C,CAAC;QAED,IAAI,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,OAAO,GAAG,IAAI,CAAC;YACf,MAAM;QACR,CAAC;QAED,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC;IACxC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvE,4EAA4E;IAC5E,gFAAgF;IAChF,MAAM,SAAS,GAAG,aAAa,KAAK,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC;IAElG,kEAAkE;IAClE,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAC1E,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,MAAA,SAAS,CAAC,aAAa,mCAAI,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACrE,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,SAAS,CAAC,eAAe,EAAE,CAAC;IAC5B,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,kBAAkB,CAAC,SAA2B,EAAE,iBAA0B,KAAK;;IAC7F,IAAI,CAAC,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,UAAU,CAAA,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAEtC,IAAI,KAAK,CAAC,SAAS,IAAI,WAAW,IAAI,cAAc,EAAE,CAAC;QACrD,OAAO;IACT,CAAC;IAED,MAAM,iBAAiB,GAAG,CAAC,SAAe,EAAE,EAAE;QAC5C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC;QACrC,IAAI,CAAC,OAAO,IAAI,CAAC,sBAAsB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC/D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,UAAU,KAAK,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC;QAE/F,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACrD,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,iBAAiB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAE5D,IAAI,CAAC,eAAe,IAAI,CAAC,aAAa,EAAE,CAAC;QACvC,OAAO;IACT,CAAC;IAED,MAAM,iBAAiB,GAAG,MAAA,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,SAAS,mCAAI,KAAK,CAAC,cAAc,CAAC;IAC7E,MAAM,cAAc,GAAG,MAAA,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,MAAM,mCAAI,KAAK,CAAC,WAAW,CAAC;IACpE,MAAM,eAAe,GAAG,MAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,SAAS,mCAAI,KAAK,CAAC,YAAY,CAAC;IACvE,MAAM,YAAY,GAAG,MAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,MAAM,mCAAI,KAAK,CAAC,SAAS,CAAC;IAE9D,0EAA0E;IAC1E,yEAAyE;IACzE,IACE,KAAK,CAAC,cAAc,KAAK,iBAAiB;QAC1C,KAAK,CAAC,WAAW,KAAK,cAAc;QACpC,KAAK,CAAC,YAAY,KAAK,eAAe;QACtC,KAAK,CAAC,SAAS,KAAK,YAAY,EAChC,CAAC;QACD,OAAO;IACT,CAAC;IAED,kFAAkF;IAClF,2EAA2E;IAC3E,MAAM,UAAU,GACd,SAAS,CAAC,UAAU,KAAK,KAAK,CAAC,YAAY;QAC3C,SAAS,CAAC,YAAY,KAAK,KAAK,CAAC,SAAS;QAC1C,SAAS,CAAC,SAAS,KAAK,KAAK,CAAC,cAAc;QAC5C,SAAS,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,CAAC;IAE9C,IAAI,UAAU,EAAE,CAAC;QACf,iFAAiF;QACjF,MAAM,eAAe,GAAG,MAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,SAAS,mCAAI,KAAK,CAAC,YAAY,CAAC;QACvE,MAAM,YAAY,GAAG,MAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,MAAM,mCAAI,KAAK,CAAC,SAAS,CAAC;QAC9D,MAAM,cAAc,GAAG,MAAA,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,SAAS,mCAAI,KAAK,CAAC,cAAc,CAAC;QAC1E,MAAM,WAAW,GAAG,MAAA,eAAe,aAAf,eAAe,uBAAf,eAAe,CAAE,MAAM,mCAAI,KAAK,CAAC,WAAW,CAAC;QAEjE,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QAClD,SAAS,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,MAAM,YAAY,GAAG,CAAC,MAAA,KAAK,CAAC,cAAc,CAAC,aAAa,mCAAI,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACpF,YAAY,CAAC,QAAQ,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC;QACzD,YAAY,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QACnD,SAAS,CAAC,eAAe,EAAE,CAAC;QAC5B,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;AACH,CAAC","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { isHTMLElement } from '../../internal/utils/dom';\nimport { ElementType } from './constants';\nimport { getTokenType, isCaretSpotType, isReferenceElementType } from './dom-utils';\nimport { isTextNode } from './type-guards';\n\n// Module-level flag: mouse state is inherently global (one mouse per document)\n// and must be accessible from the standalone normalizeSelection function.\nlet isMouseDown = false;\n\n/** Updates the mouse-down tracking flag used to skip selection normalization during drag. */\nexport function setMouseDown(value: boolean): void {\n  isMouseDown = value;\n}\n\n/** Returns whether the mouse is currently pressed. */\nexport function getMouseDown(): boolean {\n  return isMouseDown;\n}\n\n/**\n * Checks whether a node is inside a reference element's internals or directly\n * on the contentEditable div (not inside a paragraph). These are non-typeable\n * positions where the caret should not rest.\n */\nexport function isNonTypeablePosition(node: Node | null): boolean {\n  while (node) {\n    if (node.nodeName === 'P') {\n      return false;\n    }\n    if (isHTMLElement(node)) {\n      if (isReferenceElementType(getTokenType(node))) {\n        return true;\n      }\n      if (node.getAttribute('contenteditable') === 'true') {\n        return true;\n      }\n    }\n    node = node.parentNode;\n  }\n  return false;\n}\n\n/**\n * Finds the reference wrapper element that contains the given node, if any.\n * Returns null if the node is not inside a reference element.\n */\nexport function findContainingReference(node: Node | null): HTMLElement | null {\n  while (node) {\n    if (node.nodeName === 'P') {\n      return null;\n    }\n    if (isHTMLElement(node) && isReferenceElementType(getTokenType(node))) {\n      return node;\n    }\n    node = node.parentNode;\n  }\n  return null;\n}\n\n/**\n * Moves a collapsed caret out of non-typeable positions into the parent paragraph.\n * Handles caret inside reference element internals (caret spots, token container)\n * and caret on the contentEditable div itself (clicking on padding).\n * Some browsers (notably Firefox) may place the caret in these positions on focus\n * or imprecise clicks.\n */\nexport function normalizeCollapsedCaret(selection: Selection | null): void {\n  if (!selection?.rangeCount) {\n    return;\n  }\n\n  const range = selection.getRangeAt(0);\n\n  if (!range.collapsed) {\n    return;\n  }\n\n  const container = range.startContainer;\n\n  // Walk up from the caret position to find a reference wrapper.\n  let node: Node | null = isTextNode(container) ? container.parentElement : (container as HTMLElement);\n  let wrapper: HTMLElement | null = null;\n  let caretSpotType: ElementType | null = null;\n\n  while (node && isHTMLElement(node)) {\n    const tokenType = getTokenType(node);\n\n    if (isCaretSpotType(tokenType)) {\n      caretSpotType = tokenType as ElementType;\n    }\n\n    if (isReferenceElementType(tokenType)) {\n      wrapper = node;\n      break;\n    }\n\n    node = node.parentElement;\n  }\n\n  if (!wrapper) {\n    return;\n  }\n\n  const paragraph = wrapper.parentElement;\n  if (!paragraph) {\n    return;\n  }\n\n  const wrapperIndex = Array.from(paragraph.childNodes).indexOf(wrapper);\n\n  // If we know the caret was in the before-spot, position before the wrapper.\n  // Otherwise position after it (after-spot, token container, or wrapper itself).\n  const newOffset = caretSpotType === ElementType.CaretSpotBefore ? wrapperIndex : wrapperIndex + 1;\n\n  // Guard: skip if the selection is already at the target position.\n  if (range.startContainer === paragraph && range.startOffset === newOffset) {\n    return;\n  }\n\n  const newRange = (container.ownerDocument ?? document).createRange();\n  newRange.setStart(paragraph, newOffset);\n  newRange.collapse(true);\n  selection.removeAllRanges();\n  selection.addRange(newRange);\n}\n\n/** Adjusts non-collapsed selection boundaries to exclude caret spot elements. */\nexport function normalizeSelection(selection: Selection | null, skipCaretSpots: boolean = false): void {\n  if (!selection?.rangeCount) {\n    return;\n  }\n\n  const range = selection.getRangeAt(0);\n\n  if (range.collapsed || isMouseDown || skipCaretSpots) {\n    return;\n  }\n\n  const normalizeBoundary = (container: Node) => {\n    if (!isTextNode(container)) {\n      return null;\n    }\n\n    const parent = container.parentElement;\n    if (!parent) {\n      return null;\n    }\n\n    const parentType = getTokenType(parent);\n    if (!isCaretSpotType(parentType)) {\n      return null;\n    }\n\n    const wrapper = parent.parentElement;\n    if (!wrapper || !isReferenceElementType(getTokenType(wrapper))) {\n      return null;\n    }\n\n    const paragraph = wrapper.parentElement;\n    if (!paragraph) {\n      return null;\n    }\n\n    const wrapperIndex = Array.from(paragraph.childNodes).indexOf(wrapper);\n    const newOffset = parentType === ElementType.CaretSpotBefore ? wrapperIndex : wrapperIndex + 1;\n\n    return { container: paragraph, offset: newOffset };\n  };\n\n  const normalizedStart = normalizeBoundary(range.startContainer);\n  const normalizedEnd = normalizeBoundary(range.endContainer);\n\n  if (!normalizedStart && !normalizedEnd) {\n    return;\n  }\n\n  const newStartContainer = normalizedStart?.container ?? range.startContainer;\n  const newStartOffset = normalizedStart?.offset ?? range.startOffset;\n  const newEndContainer = normalizedEnd?.container ?? range.endContainer;\n  const newEndOffset = normalizedEnd?.offset ?? range.endOffset;\n\n  // Guard: skip if the selection already matches the normalized boundaries.\n  // Prevents Safari from entering an infinite selectionchange loop in RTL.\n  if (\n    range.startContainer === newStartContainer &&\n    range.startOffset === newStartOffset &&\n    range.endContainer === newEndContainer &&\n    range.endOffset === newEndOffset\n  ) {\n    return;\n  }\n\n  // Determine if the selection is backward (focus before anchor in document order).\n  // Range always has start <= end, but the user may be selecting in reverse.\n  const isBackward =\n    selection.anchorNode === range.endContainer &&\n    selection.anchorOffset === range.endOffset &&\n    selection.focusNode === range.startContainer &&\n    selection.focusOffset === range.startOffset;\n\n  if (isBackward) {\n    // Preserve backward direction: collapse to anchor (end), extend to focus (start)\n    const anchorContainer = normalizedEnd?.container ?? range.endContainer;\n    const anchorOffset = normalizedEnd?.offset ?? range.endOffset;\n    const focusContainer = normalizedStart?.container ?? range.startContainer;\n    const focusOffset = normalizedStart?.offset ?? range.startOffset;\n\n    selection.collapse(anchorContainer, anchorOffset);\n    selection.extend(focusContainer, focusOffset);\n  } else {\n    const updatedRange = (range.startContainer.ownerDocument ?? document).createRange();\n    updatedRange.setStart(newStartContainer, newStartOffset);\n    updatedRange.setEnd(newEndContainer, newEndOffset);\n    selection.removeAllRanges();\n    selection.addRange(updatedRange);\n  }\n}\n"]}

package/prompt-input/core/constants.d.ts

@@ -0,0 +1,14 @@
+export declare enum ElementType {
+  Reference = "reference",
+  Pinned = "pinned",
+  CaretSpotBefore = "cursor-spot-before",
+  CaretSpotAfter = "cursor-spot-after",
+  Trigger = "trigger",
+  TrailingBreak = "trailing-break",
+}
+export declare const SPECIAL_CHARS: {
+  ZERO_WIDTH_CHARACTER: string;
+  NEWLINE: string;
+};
+export declare const DEFAULT_MAX_ROWS = 3;
+export declare const NEXT_TICK_TIMEOUT = 0;

package/prompt-input/core/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/prompt-input/core/constants.ts"],"names":[],"mappings":"AAGA,oBAAY,WAAW;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,eAAe,uBAAuB;IACtC,cAAc,sBAAsB;IACpC,OAAO,YAAY;IACnB,aAAa,mBAAmB;CACjC;AAED,eAAO,MAAM,aAAa;;;CAGzB,CAAC;AAEF,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,iBAAiB,IAAI,CAAC"}

package/prompt-input/core/constants.js

@@ -0,0 +1,18 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+export var ElementType;
+(function (ElementType) {
+    ElementType["Reference"] = "reference";
+    ElementType["Pinned"] = "pinned";
+    ElementType["CaretSpotBefore"] = "cursor-spot-before";
+    ElementType["CaretSpotAfter"] = "cursor-spot-after";
+    ElementType["Trigger"] = "trigger";
+    ElementType["TrailingBreak"] = "trailing-break";
+})(ElementType || (ElementType = {}));
+export const SPECIAL_CHARS = {
+    ZERO_WIDTH_CHARACTER: '\u200B',
+    NEWLINE: '\n',
+};
+export const DEFAULT_MAX_ROWS = 3;
+export const NEXT_TICK_TIMEOUT = 0;
+//# sourceMappingURL=constants.js.map

package/prompt-input/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/prompt-input/core/constants.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,sCAAsC;AAEtC,MAAM,CAAN,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,sCAAuB,CAAA;IACvB,gCAAiB,CAAA;IACjB,qDAAsC,CAAA;IACtC,mDAAoC,CAAA;IACpC,kCAAmB,CAAA;IACnB,+CAAgC,CAAA;AAClC,CAAC,EAPW,WAAW,KAAX,WAAW,QAOtB;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,oBAAoB,EAAE,QAAQ;IAC9B,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAClC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport enum ElementType {\n  Reference = 'reference',\n  Pinned = 'pinned',\n  CaretSpotBefore = 'cursor-spot-before',\n  CaretSpotAfter = 'cursor-spot-after',\n  Trigger = 'trigger',\n  TrailingBreak = 'trailing-break',\n}\n\nexport const SPECIAL_CHARS = {\n  ZERO_WIDTH_CHARACTER: '\\u200B',\n  NEWLINE: '\\n',\n};\n\nexport const DEFAULT_MAX_ROWS = 3;\nexport const NEXT_TICK_TIMEOUT = 0;\n"]}

package/prompt-input/core/dom-utils.d.ts

@@ -0,0 +1,60 @@
+import { ElementType } from './constants';
+/** Reads the data-type attribute from an element and returns it as a typed ElementType. */
+export declare function getTokenType(element: HTMLElement): ElementType | null;
+/** Checks if a token type represents a reference element (inline or pinned). */
+export declare function isReferenceElementType(tokenType: ElementType | string | null): boolean;
+/** Inserts a node immediately after a reference node in the DOM. */
+export declare function insertAfter(newNode: Node, referenceNode: Node): void;
+/** Creates a styled paragraph element for the contentEditable container. */
+export declare function createParagraph(ownerDoc?: Document): HTMLParagraphElement;
+/** Creates a trailing BR element used as a placeholder in empty paragraphs. */
+export declare function createTrailingBreak(ownerDoc?: Document): HTMLBRElement;
+/**
+ * Generates a unique ID for DOM elements outside of React context.
+ * Uses the same format as component-toolkit's useRandomId hook, but as a plain
+ * function since token IDs are generated during DOM manipulation (not in React renders).
+ */
+export declare function generateTokenId(): string;
+/** Strips zero-width characters used for cursor positioning. */
+export declare function stripZeroWidthCharacters(text: string): string;
+interface TokenQueryOptions {
+  tokenType?: string | string[];
+  tokenId?: string;
+}
+/** Finds the first element matching the given token type and/or token ID within a container. */
+export declare function findElement(container: HTMLElement, options: TokenQueryOptions): HTMLElement | null;
+/** Returns all paragraph elements within a container. */
+export declare function findAllParagraphs(container: HTMLElement | DocumentFragment): HTMLParagraphElement[];
+/** Checks if an element has no meaningful content (ignoring whitespace and trailing BRs). */
+export declare function isElementEffectivelyEmpty(element: HTMLElement): boolean;
+export declare function hasOnlyTrailingBR(paragraph: HTMLElement): boolean;
+export declare function isEmptyState(element: HTMLElement): boolean;
+/** Resets the element to a single empty paragraph with a trailing BR. */
+export declare function setEmptyState(element: HTMLElement): void;
+/** Checks if a token type represents a caret spot element. */
+export declare function isCaretSpotType(tokenType: ElementType | string | null): boolean;
+export interface AdjacentTokenResult {
+  sibling: Node | null;
+  isReferenceToken: boolean;
+}
+/**
+ * Finds the adjacent sibling node in the given direction and checks if it's a reference token.
+ * @param container the node where the cursor currently sits
+ * @param offset cursor offset within the container
+ * @param direction which direction to look
+ */
+export declare function findAdjacentToken(container: Node, offset: number, direction: 'backward' | 'forward'): AdjacentTokenResult;
+/**
+ * When the caret lands immediately after a trigger element (e.g. at offset 0 of the
+ * next text node, or at the paragraph-level offset right after the trigger), nudge it
+ * inside the trigger's text node so that `findActiveTrigger` detects it correctly.
+ * @param cancelledIds Set of trigger IDs that are cancelled — caret won't be nudged into these.
+ */
+export declare function normalizeCaretIntoTrigger(editableElement: HTMLElement, cancelledIds?: Set<string>): void;
+/**
+ * Scrolls the caret into view within a scrollable contentEditable element.
+ * Inserts a temporary span at the selection to measure position, scrolls if
+ * needed, then removes the span.
+ */
+export declare function scrollCaretIntoView(element: HTMLElement): void;
+export {};

package/prompt-input/core/dom-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-utils.d.ts","sourceRoot":"","sources":["../../../../src/prompt-input/core/dom-utils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AAKzD,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,GAAG,IAAI,CAarE;AACD,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAEtF;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,GAAG,IAAI,CAWpE;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,QAAQ,GAAE,QAAmB,GAAG,oBAAoB,CAInF;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,QAAQ,GAAE,QAAmB,GAAG,aAAa,CAIhF;AAID;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,gEAAgE;AAChE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAeD,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,GAAG,WAAW,GAAG,IAAI,CAGlG;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,WAAW,GAAG,gBAAgB,GAAG,oBAAoB,EAAE,CAEnG;AAED,6FAA6F;AAC7F,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAiBvE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAEjE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAG1D;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAWxD;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,SAAS,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAE/E;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,IAAI,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,UAAU,GAAG,SAAS,GAChC,mBAAmB,CAqBrB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,eAAe,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAuDxG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CA4C9D"}

package/prompt-input/core/dom-utils.js

@@ -0,0 +1,252 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { isHTMLElement } from '../../internal/utils/dom';
+import { getOwnerSelection } from './caret-controller';
+import { ElementType, SPECIAL_CHARS } from './constants';
+import { isBRElement, isTextNode } from './type-guards';
+import styles from '../styles.css.js';
+/** Reads the data-type attribute from an element and returns it as a typed ElementType. */
+export function getTokenType(element) {
+    const value = element.getAttribute('data-type');
+    switch (value) {
+        case ElementType.Reference:
+        case ElementType.Pinned:
+        case ElementType.CaretSpotBefore:
+        case ElementType.CaretSpotAfter:
+        case ElementType.Trigger:
+        case ElementType.TrailingBreak:
+            return value;
+        default:
+            return null;
+    }
+}
+/** Checks if a token type represents a reference element (inline or pinned). */
+export function isReferenceElementType(tokenType) {
+    return tokenType === ElementType.Reference || tokenType === ElementType.Pinned;
+}
+/** Inserts a node immediately after a reference node in the DOM. */
+export function insertAfter(newNode, referenceNode) {
+    const parent = referenceNode.parentNode;
+    if (!parent) {
+        return;
+    }
+    if (referenceNode.nextSibling) {
+        parent.insertBefore(newNode, referenceNode.nextSibling);
+    }
+    else {
+        parent.appendChild(newNode);
+    }
+}
+/** Creates a styled paragraph element for the contentEditable container. */
+export function createParagraph(ownerDoc = document) {
+    const p = ownerDoc.createElement('p');
+    p.className = styles.paragraph;
+    return p;
+}
+/** Creates a trailing BR element used as a placeholder in empty paragraphs. */
+export function createTrailingBreak(ownerDoc = document) {
+    const br = ownerDoc.createElement('br');
+    br.setAttribute('data-id', ElementType.TrailingBreak);
+    return br;
+}
+let idCounter = 0;
+/**
+ * Generates a unique ID for DOM elements outside of React context.
+ * Uses the same format as component-toolkit's useRandomId hook, but as a plain
+ * function since token IDs are generated during DOM manipulation (not in React renders).
+ */
+export function generateTokenId() {
+    return `${idCounter++}-${Date.now()}-${Math.round(Math.random() * 10000)}`;
+}
+/** Strips zero-width characters used for cursor positioning. */
+export function stripZeroWidthCharacters(text) {
+    return text.replace(new RegExp(SPECIAL_CHARS.ZERO_WIDTH_CHARACTER, 'g'), '');
+}
+function buildTokenSelector(options) {
+    const { tokenType = [], tokenId } = options;
+    const types = Array.isArray(tokenType) ? tokenType : [tokenType];
+    let selector = types.length > 0 ? types.map(type => `[data-type="${type}"]`).join(', ') : '';
+    if (tokenId) {
+        selector += `[data-id="${tokenId}"]`;
+    }
+    return selector;
+}
+/** Finds the first element matching the given token type and/or token ID within a container. */
+export function findElement(container, options) {
+    const selector = buildTokenSelector(options);
+    return selector ? container.querySelector(selector) : null;
+}
+/** Returns all paragraph elements within a container. */
+export function findAllParagraphs(container) {
+    return Array.from(container.querySelectorAll('p'));
+}
+/** Checks if an element has no meaningful content (ignoring whitespace and trailing BRs). */
+export function isElementEffectivelyEmpty(element) {
+    if (element.childNodes.length === 0) {
+        return true;
+    }
+    for (const child of Array.from(element.childNodes)) {
+        if (isTextNode(child)) {
+            if (child.textContent && child.textContent.trim() !== '') {
+                return false;
+            }
+        }
+        else if (isBRElement(child)) {
+            continue;
+        }
+        else {
+            return false;
+        }
+    }
+    return true;
+}
+export function hasOnlyTrailingBR(paragraph) {
+    return paragraph.childNodes.length === 1 && isBRElement(paragraph.firstChild);
+}
+export function isEmptyState(element) {
+    const paragraphs = findAllParagraphs(element);
+    return paragraphs.length === 0 || (paragraphs.length === 1 && hasOnlyTrailingBR(paragraphs[0]));
+}
+/** Resets the element to a single empty paragraph with a trailing BR. */
+export function setEmptyState(element) {
+    const paragraphs = findAllParagraphs(element);
+    if (paragraphs.length === 1 && hasOnlyTrailingBR(paragraphs[0])) {
+        return;
+    }
+    element.textContent = '';
+    const p = createParagraph();
+    p.appendChild(createTrailingBreak());
+    element.appendChild(p);
+}
+/** Checks if a token type represents a caret spot element. */
+export function isCaretSpotType(tokenType) {
+    return tokenType === ElementType.CaretSpotBefore || tokenType === ElementType.CaretSpotAfter;
+}
+/**
+ * Finds the adjacent sibling node in the given direction and checks if it's a reference token.
+ * @param container the node where the cursor currently sits
+ * @param offset cursor offset within the container
+ * @param direction which direction to look
+ */
+export function findAdjacentToken(container, offset, direction) {
+    var _a;
+    let sibling = null;
+    if (isTextNode(container)) {
+        const isAtBoundary = direction === 'backward' ? offset === 0 : offset === (((_a = container.textContent) === null || _a === void 0 ? void 0 : _a.length) || 0);
+        if (isAtBoundary) {
+            sibling = direction === 'backward' ? container.previousSibling : container.nextSibling;
+        }
+    }
+    else if (isHTMLElement(container)) {
+        if (direction === 'backward') {
+            sibling = offset > 0 ? container.childNodes[offset - 1] : container.previousSibling;
+        }
+        else {
+            sibling = offset < container.childNodes.length ? container.childNodes[offset] : container.nextSibling;
+        }
+    }
+    const siblingType = isHTMLElement(sibling) ? getTokenType(sibling) : null;
+    const isReferenceToken = isReferenceElementType(siblingType);
+    return { sibling, isReferenceToken };
+}
+/**
+ * When the caret lands immediately after a trigger element (e.g. at offset 0 of the
+ * next text node, or at the paragraph-level offset right after the trigger), nudge it
+ * inside the trigger's text node so that `findActiveTrigger` detects it correctly.
+ * @param cancelledIds Set of trigger IDs that are cancelled — caret won't be nudged into these.
+ */
+export function normalizeCaretIntoTrigger(editableElement, cancelledIds) {
+    var _a, _b;
+    const selection = getOwnerSelection(editableElement);
+    if (!(selection === null || selection === void 0 ? void 0 : selection.rangeCount)) {
+        return;
+    }
+    const range = selection.getRangeAt(0);
+    if (!range.collapsed) {
+        return;
+    }
+    let triggerElement = null;
+    if (isTextNode(range.startContainer) && range.startOffset === 0) {
+        const prevSibling = range.startContainer.previousSibling;
+        if (isHTMLElement(prevSibling) && getTokenType(prevSibling) === ElementType.Trigger) {
+            // Only nudge when the text node is empty — a non-empty node means the
+            // cursor is legitimately positioned at the start of user text.
+            if (!range.startContainer.textContent) {
+                triggerElement = prevSibling;
+            }
+        }
+        // Caret at offset 0 inside a trigger's own text node means the cursor is
+        // right before the trigger symbol. Nudge it to the end of whatever precedes
+        // this trigger — either the previous trigger or a text node boundary.
+        const parent = range.startContainer.parentElement;
+        if (!triggerElement && parent && getTokenType(parent) === ElementType.Trigger) {
+            const paragraph = parent.parentElement;
+            if (paragraph) {
+                const idx = Array.from(paragraph.childNodes).indexOf(parent);
+                if (idx > 0) {
+                    range.setStart(paragraph, idx);
+                    range.collapse(true);
+                }
+            }
+            return;
+        }
+    }
+    else if (range.startContainer === editableElement || isHTMLElement(range.startContainer)) {
+        const container = range.startContainer;
+        const childNodes = Array.from(container.childNodes);
+        const nodeBeforeCaret = childNodes[range.startOffset - 1];
+        if (isHTMLElement(nodeBeforeCaret) && getTokenType(nodeBeforeCaret) === ElementType.Trigger) {
+            triggerElement = nodeBeforeCaret;
+        }
+    }
+    if (triggerElement && !(cancelledIds === null || cancelledIds === void 0 ? void 0 : cancelledIds.has(triggerElement.id))) {
+        const triggerTextNode = triggerElement.childNodes[0];
+        if (isTextNode(triggerTextNode)) {
+            range.setStart(triggerTextNode, (_b = (_a = triggerTextNode.textContent) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0);
+            range.collapse(true);
+        }
+    }
+}
+/**
+ * Scrolls the caret into view within a scrollable contentEditable element.
+ * Inserts a temporary span at the selection to measure position, scrolls if
+ * needed, then removes the span.
+ */
+export function scrollCaretIntoView(element) {
+    var _a, _b, _c, _d, _e;
+    if (element.scrollHeight <= element.clientHeight) {
+        return;
+    }
+    const selection = getOwnerSelection(element);
+    if (!(selection === null || selection === void 0 ? void 0 : selection.rangeCount)) {
+        return;
+    }
+    const ownerDoc = (_a = element.ownerDocument) !== null && _a !== void 0 ? _a : document;
+    const range = selection.getRangeAt(0);
+    const tempSpan = ownerDoc.createElement('span');
+    range.insertNode(tempSpan);
+    const spanRect = tempSpan.getBoundingClientRect();
+    const elementRect = element.getBoundingClientRect();
+    const isOutOfView = spanRect.top < elementRect.top ||
+        spanRect.bottom > elementRect.bottom ||
+        spanRect.left < elementRect.left ||
+        spanRect.right > elementRect.right;
+    if (isOutOfView) {
+        tempSpan.scrollIntoView({ block: 'nearest', inline: 'nearest' });
+    }
+    // Remove the span and merge the split text nodes back together.
+    // insertNode splits a text node into [before, span, after]. After removing
+    // the span, merge "after" into "before" to restore the original text node.
+    const prev = tempSpan.previousSibling;
+    const next = tempSpan.nextSibling;
+    tempSpan.remove();
+    if (prev && next && prev.nodeType === Node.TEXT_NODE && next.nodeType === Node.TEXT_NODE) {
+        const mergeOffset = (_c = (_b = prev.textContent) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0;
+        prev.textContent = ((_d = prev.textContent) !== null && _d !== void 0 ? _d : '') + ((_e = next.textContent) !== null && _e !== void 0 ? _e : '');
+        next.remove();
+        // Place the caret at the merge point
+        range.setStart(prev, mergeOffset);
+        range.collapse(true);
+    }
+}
+//# sourceMappingURL=dom-utils.js.map

package/prompt-input/core/dom-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-utils.js","sourceRoot":"","sources":["../../../../src/prompt-input/core/dom-utils.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { isHTMLElement } from '../../internal/utils/dom';\nimport { getOwnerSelection } from './caret-controller';\nimport { ElementType, SPECIAL_CHARS } from './constants';\nimport { isBRElement, isTextNode } from './type-guards';\n\nimport styles from '../styles.css.js';\n\n/** Reads the data-type attribute from an element and returns it as a typed ElementType. */\nexport function getTokenType(element: HTMLElement): ElementType | null {\n  const value = element.getAttribute('data-type');\n  switch (value) {\n    case ElementType.Reference:\n    case ElementType.Pinned:\n    case ElementType.CaretSpotBefore:\n    case ElementType.CaretSpotAfter:\n    case ElementType.Trigger:\n    case ElementType.TrailingBreak:\n      return value;\n    default:\n      return null;\n  }\n}\n/** Checks if a token type represents a reference element (inline or pinned). */\nexport function isReferenceElementType(tokenType: ElementType | string | null): boolean {\n  return tokenType === ElementType.Reference || tokenType === ElementType.Pinned;\n}\n\n/** Inserts a node immediately after a reference node in the DOM. */\nexport function insertAfter(newNode: Node, referenceNode: Node): void {\n  const parent = referenceNode.parentNode;\n  if (!parent) {\n    return;\n  }\n\n  if (referenceNode.nextSibling) {\n    parent.insertBefore(newNode, referenceNode.nextSibling);\n  } else {\n    parent.appendChild(newNode);\n  }\n}\n\n/** Creates a styled paragraph element for the contentEditable container. */\nexport function createParagraph(ownerDoc: Document = document): HTMLParagraphElement {\n  const p = ownerDoc.createElement('p');\n  p.className = styles.paragraph;\n  return p;\n}\n\n/** Creates a trailing BR element used as a placeholder in empty paragraphs. */\nexport function createTrailingBreak(ownerDoc: Document = document): HTMLBRElement {\n  const br = ownerDoc.createElement('br');\n  br.setAttribute('data-id', ElementType.TrailingBreak);\n  return br;\n}\n\nlet idCounter = 0;\n\n/**\n * Generates a unique ID for DOM elements outside of React context.\n * Uses the same format as component-toolkit's useRandomId hook, but as a plain\n * function since token IDs are generated during DOM manipulation (not in React renders).\n */\nexport function generateTokenId(): string {\n  return `${idCounter++}-${Date.now()}-${Math.round(Math.random() * 10000)}`;\n}\n\n/** Strips zero-width characters used for cursor positioning. */\nexport function stripZeroWidthCharacters(text: string): string {\n  return text.replace(new RegExp(SPECIAL_CHARS.ZERO_WIDTH_CHARACTER, 'g'), '');\n}\n\ninterface TokenQueryOptions {\n  tokenType?: string | string[];\n  tokenId?: string;\n}\n\nfunction buildTokenSelector(options: TokenQueryOptions): string {\n  const { tokenType = [], tokenId } = options;\n  const types = Array.isArray(tokenType) ? tokenType : [tokenType];\n\n  let selector = types.length > 0 ? types.map(type => `[data-type=\"${type}\"]`).join(', ') : '';\n\n  if (tokenId) {\n    selector += `[data-id=\"${tokenId}\"]`;\n  }\n\n  return selector;\n}\n\n/** Finds the first element matching the given token type and/or token ID within a container. */\nexport function findElement(container: HTMLElement, options: TokenQueryOptions): HTMLElement | null {\n  const selector = buildTokenSelector(options);\n  return selector ? container.querySelector<HTMLElement>(selector) : null;\n}\n\n/** Returns all paragraph elements within a container. */\nexport function findAllParagraphs(container: HTMLElement | DocumentFragment): HTMLParagraphElement[] {\n  return Array.from(container.querySelectorAll<HTMLParagraphElement>('p'));\n}\n\n/** Checks if an element has no meaningful content (ignoring whitespace and trailing BRs). */\nexport function isElementEffectivelyEmpty(element: HTMLElement): boolean {\n  if (element.childNodes.length === 0) {\n    return true;\n  }\n\n  for (const child of Array.from(element.childNodes)) {\n    if (isTextNode(child)) {\n      if (child.textContent && child.textContent.trim() !== '') {\n        return false;\n      }\n    } else if (isBRElement(child)) {\n      continue;\n    } else {\n      return false;\n    }\n  }\n  return true;\n}\n\nexport function hasOnlyTrailingBR(paragraph: HTMLElement): boolean {\n  return paragraph.childNodes.length === 1 && isBRElement(paragraph.firstChild);\n}\n\nexport function isEmptyState(element: HTMLElement): boolean {\n  const paragraphs = findAllParagraphs(element);\n  return paragraphs.length === 0 || (paragraphs.length === 1 && hasOnlyTrailingBR(paragraphs[0]));\n}\n\n/** Resets the element to a single empty paragraph with a trailing BR. */\nexport function setEmptyState(element: HTMLElement): void {\n  const paragraphs = findAllParagraphs(element);\n\n  if (paragraphs.length === 1 && hasOnlyTrailingBR(paragraphs[0])) {\n    return;\n  }\n\n  element.textContent = '';\n  const p = createParagraph();\n  p.appendChild(createTrailingBreak());\n  element.appendChild(p);\n}\n\n/** Checks if a token type represents a caret spot element. */\nexport function isCaretSpotType(tokenType: ElementType | string | null): boolean {\n  return tokenType === ElementType.CaretSpotBefore || tokenType === ElementType.CaretSpotAfter;\n}\n\nexport interface AdjacentTokenResult {\n  sibling: Node | null;\n  isReferenceToken: boolean;\n}\n\n/**\n * Finds the adjacent sibling node in the given direction and checks if it's a reference token.\n * @param container the node where the cursor currently sits\n * @param offset cursor offset within the container\n * @param direction which direction to look\n */\nexport function findAdjacentToken(\n  container: Node,\n  offset: number,\n  direction: 'backward' | 'forward'\n): AdjacentTokenResult {\n  let sibling: Node | null = null;\n\n  if (isTextNode(container)) {\n    const isAtBoundary = direction === 'backward' ? offset === 0 : offset === (container.textContent?.length || 0);\n\n    if (isAtBoundary) {\n      sibling = direction === 'backward' ? container.previousSibling : container.nextSibling;\n    }\n  } else if (isHTMLElement(container)) {\n    if (direction === 'backward') {\n      sibling = offset > 0 ? container.childNodes[offset - 1] : container.previousSibling;\n    } else {\n      sibling = offset < container.childNodes.length ? container.childNodes[offset] : container.nextSibling;\n    }\n  }\n\n  const siblingType = isHTMLElement(sibling) ? getTokenType(sibling) : null;\n  const isReferenceToken = isReferenceElementType(siblingType);\n\n  return { sibling, isReferenceToken };\n}\n\n/**\n * When the caret lands immediately after a trigger element (e.g. at offset 0 of the\n * next text node, or at the paragraph-level offset right after the trigger), nudge it\n * inside the trigger's text node so that `findActiveTrigger` detects it correctly.\n * @param cancelledIds Set of trigger IDs that are cancelled — caret won't be nudged into these.\n */\nexport function normalizeCaretIntoTrigger(editableElement: HTMLElement, cancelledIds?: Set<string>): void {\n  const selection = getOwnerSelection(editableElement);\n  if (!selection?.rangeCount) {\n    return;\n  }\n\n  const range = selection.getRangeAt(0);\n  if (!range.collapsed) {\n    return;\n  }\n\n  let triggerElement: HTMLElement | null = null;\n\n  if (isTextNode(range.startContainer) && range.startOffset === 0) {\n    const prevSibling = range.startContainer.previousSibling;\n    if (isHTMLElement(prevSibling) && getTokenType(prevSibling) === ElementType.Trigger) {\n      // Only nudge when the text node is empty — a non-empty node means the\n      // cursor is legitimately positioned at the start of user text.\n      if (!range.startContainer.textContent) {\n        triggerElement = prevSibling;\n      }\n    }\n\n    // Caret at offset 0 inside a trigger's own text node means the cursor is\n    // right before the trigger symbol. Nudge it to the end of whatever precedes\n    // this trigger — either the previous trigger or a text node boundary.\n    const parent = range.startContainer.parentElement;\n    if (!triggerElement && parent && getTokenType(parent) === ElementType.Trigger) {\n      const paragraph = parent.parentElement;\n      if (paragraph) {\n        const idx = Array.from(paragraph.childNodes).indexOf(parent);\n        if (idx > 0) {\n          range.setStart(paragraph, idx);\n          range.collapse(true);\n        }\n      }\n      return;\n    }\n  } else if (range.startContainer === editableElement || isHTMLElement(range.startContainer)) {\n    const container = range.startContainer as HTMLElement;\n    const childNodes = Array.from(container.childNodes);\n    const nodeBeforeCaret = childNodes[range.startOffset - 1];\n\n    if (isHTMLElement(nodeBeforeCaret) && getTokenType(nodeBeforeCaret) === ElementType.Trigger) {\n      triggerElement = nodeBeforeCaret;\n    }\n  }\n\n  if (triggerElement && !cancelledIds?.has(triggerElement.id)) {\n    const triggerTextNode = triggerElement.childNodes[0];\n    if (isTextNode(triggerTextNode)) {\n      range.setStart(triggerTextNode, triggerTextNode.textContent?.length ?? 0);\n      range.collapse(true);\n    }\n  }\n}\n\n/**\n * Scrolls the caret into view within a scrollable contentEditable element.\n * Inserts a temporary span at the selection to measure position, scrolls if\n * needed, then removes the span.\n */\nexport function scrollCaretIntoView(element: HTMLElement): void {\n  if (element.scrollHeight <= element.clientHeight) {\n    return;\n  }\n\n  const selection = getOwnerSelection(element);\n  if (!selection?.rangeCount) {\n    return;\n  }\n\n  const ownerDoc = element.ownerDocument ?? document;\n  const range = selection.getRangeAt(0);\n\n  const tempSpan = ownerDoc.createElement('span');\n  range.insertNode(tempSpan);\n\n  const spanRect = tempSpan.getBoundingClientRect();\n  const elementRect = element.getBoundingClientRect();\n\n  const isOutOfView =\n    spanRect.top < elementRect.top ||\n    spanRect.bottom > elementRect.bottom ||\n    spanRect.left < elementRect.left ||\n    spanRect.right > elementRect.right;\n\n  if (isOutOfView) {\n    tempSpan.scrollIntoView({ block: 'nearest', inline: 'nearest' });\n  }\n\n  // Remove the span and merge the split text nodes back together.\n  // insertNode splits a text node into [before, span, after]. After removing\n  // the span, merge \"after\" into \"before\" to restore the original text node.\n  const prev = tempSpan.previousSibling;\n  const next = tempSpan.nextSibling;\n  tempSpan.remove();\n\n  if (prev && next && prev.nodeType === Node.TEXT_NODE && next.nodeType === Node.TEXT_NODE) {\n    const mergeOffset = prev.textContent?.length ?? 0;\n    prev.textContent = (prev.textContent ?? '') + (next.textContent ?? '');\n    next.remove();\n    // Place the caret at the merge point\n    range.setStart(prev, mergeOffset);\n    range.collapse(true);\n  }\n}\n"]}