@cloudscape-design/components 3.0.1270 → 3.0.1272

package/prompt-input/components/textarea-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea-mode.js","sourceRoot":"","sources":["../../../../src/prompt-input/components/textarea-mode.tsx"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,sCAAsC;AAEtC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,oBAAoB,MAAM,6CAA6C,CAAC;AAU/E,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EACnC,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,wBAAwB,GACN;IAClB,OAAO,CACL,oBAAC,oBAAoB,OACf,kBAAkB,EACtB,GAAG,EAAC,UAAU,EACd,aAAa,EAAC,aAAa,EAC3B,gBAAgB,EAAE,wBAAwB,EAC1C,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,SAAS,GACb,CACH,CAAC;AACJ,CAAC","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport React from 'react';\n\nimport WithNativeAttributes from '../../internal/utils/with-native-attributes';\n\n/** Props for when using standard PromptInput. */\ninterface TextareaModeProps {\n  textareaRef: React.RefObject<HTMLTextAreaElement>;\n  controlId?: string;\n  textareaAttributes: React.TextareaHTMLAttributes<HTMLTextAreaElement>;\n  nativeTextareaAttributes?: Record<string, any>;\n}\n\nexport default function TextareaMode({\n  textareaRef,\n  controlId,\n  textareaAttributes,\n  nativeTextareaAttributes,\n}: TextareaModeProps) {\n  return (\n    <WithNativeAttributes\n      {...textareaAttributes}\n      tag=\"textarea\"\n      componentName=\"PromptInput\"\n      nativeAttributes={nativeTextareaAttributes}\n      ref={textareaRef}\n      id={controlId}\n    />\n  );\n}\n"]}

package/prompt-input/components/token-mode.d.ts

@@ -0,0 +1,61 @@
+import React from 'react';
+import { DropdownStatusResult } from '../../internal/components/dropdown-status';
+import { MenuItemsHandlers, MenuItemsState } from '../core/menu-state';
+import { PromptInputProps } from '../interfaces';
+/** Props for the token-mode contentEditable input and its associated menu dropdown. */
+interface TokenModeProps {
+  /** Ref to the contentEditable div */
+  editableElementRef: React.RefObject<HTMLDivElement>;
+  /** Ref to the active trigger element, used to anchor the dropdown */
+  triggerWrapperRef: React.MutableRefObject<HTMLElement | null>;
+  controlId?: string;
+  menuListId: string;
+  menuFooterControlId: string;
+  highlightedMenuOptionId?: string;
+  /** When set, renders a hidden input for native form submission */
+  name?: string;
+  /** Plain text representation of the current tokens */
+  plainTextValue: string;
+  menuIsOpen: boolean;
+  /** True once the trigger element is mounted and ready for dropdown positioning */
+  triggerWrapperReady: boolean;
+  shouldRenderMenuDropdown: boolean;
+  activeMenu: PromptInputProps.MenuDefinition | null;
+  activeTriggerToken: PromptInputProps.TriggerToken | null;
+  menuFilterText: string;
+  menuItemsState: MenuItemsState | null;
+  menuItemsHandlers: MenuItemsHandlers | null;
+  menuDropdownStatus: DropdownStatusResult | null;
+  handleInput: () => void;
+  handleLoadMore: () => void;
+  /** Spread onto the contentEditable div — includes aria attrs, className, and event handlers */
+  editableElementAttributes: React.HTMLAttributes<HTMLDivElement> & {
+    'data-placeholder'?: string;
+  };
+  i18nStrings?: PromptInputProps['i18nStrings'];
+  maxMenuHeight?: number;
+}
+export default function TokenMode({
+  editableElementRef,
+  triggerWrapperRef,
+  controlId,
+  menuListId,
+  menuFooterControlId,
+  highlightedMenuOptionId,
+  name,
+  plainTextValue,
+  menuIsOpen,
+  triggerWrapperReady,
+  shouldRenderMenuDropdown,
+  activeMenu,
+  activeTriggerToken,
+  menuFilterText,
+  menuItemsState,
+  menuItemsHandlers,
+  menuDropdownStatus,
+  maxMenuHeight,
+  handleInput,
+  handleLoadMore,
+  editableElementAttributes
+}: TokenModeProps): JSX.Element;
+export {};

package/prompt-input/components/token-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-mode.d.ts","sourceRoot":"","sources":["../../../../src/prompt-input/components/token-mode.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAMjD,uFAAuF;AACvF,UAAU,cAAc;IACtB,qCAAqC;IACrC,kBAAkB,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IACpD,qEAAqE;IACrE,iBAAiB,EAAE,KAAK,CAAC,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAE9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,kFAAkF;IAClF,mBAAmB,EAAE,OAAO,CAAC;IAC7B,wBAAwB,EAAE,OAAO,CAAC;IAElC,UAAU,EAAE,gBAAgB,CAAC,cAAc,GAAG,IAAI,CAAC;IACnD,kBAAkB,EAAE,gBAAgB,CAAC,YAAY,GAAG,IAAI,CAAC;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,kBAAkB,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAEhD,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,IAAI,CAAC;IAE3B,+FAA+F;IAC/F,yBAAyB,EAAE,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG;QAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;IAEF,WAAW,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAE9C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAChC,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,uBAAuB,EACvB,IAAI,EACJ,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,cAAc,EACd,yBAAyB,GAC1B,EAAE,cAAc,eAkGhB"}

package/prompt-input/components/token-mode.js

@@ -0,0 +1,37 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import React from 'react';
+import clsx from 'clsx';
+import Dropdown from '../../dropdown/internal';
+import DropdownFooter from '../../internal/components/dropdown-footer';
+import MenuDropdown from './menu-dropdown';
+import styles from '../styles.css.js';
+import testutilStyles from '../test-classes/styles.css.js';
+const MENU_MIN_WIDTH = 300;
+export default function TokenMode({ editableElementRef, triggerWrapperRef, controlId, menuListId, menuFooterControlId, highlightedMenuOptionId, name, plainTextValue, menuIsOpen, triggerWrapperReady, shouldRenderMenuDropdown, activeMenu, activeTriggerToken, menuFilterText, menuItemsState, menuItemsHandlers, menuDropdownStatus, maxMenuHeight, handleInput, handleLoadMore, editableElementAttributes, }) {
+    var _a;
+    return (React.createElement(React.Fragment, null,
+        name && React.createElement("input", { type: "hidden", name: name, value: plainTextValue }),
+        React.createElement("div", { className: styles['editable-wrapper'] },
+            React.createElement("div", { id: controlId, ref: editableElementRef, role: "textbox", "aria-multiline": "true", "aria-haspopup": "listbox", "aria-expanded": menuIsOpen && shouldRenderMenuDropdown, contentEditable: !editableElementAttributes['aria-disabled'] && !editableElementAttributes['aria-readonly']
+                    ? 'true'
+                    : 'false', 
+                // React warns when children of a contentEditable element are managed by React.
+                // We suppress this because we intentionally manage the DOM directly via token-renderer
+                // to avoid React's reconciliation conflicting with browser-native editing behavior.
+                suppressContentEditableWarning: true, "aria-controls": menuIsOpen ? menuListId : undefined, "aria-owns": menuIsOpen ? menuListId : undefined, "aria-activedescendant": highlightedMenuOptionId, onInput: handleInput, ...editableElementAttributes, className: clsx(editableElementAttributes.className, testutilStyles['content-editable'], styles['editable-element']) }),
+            React.createElement(Dropdown, { minWidth: MENU_MIN_WIDTH, maxHeight: maxMenuHeight, expandToViewport: true, open: !!(shouldRenderMenuDropdown &&
+                    triggerWrapperReady &&
+                    menuIsOpen &&
+                    menuItemsState &&
+                    (menuItemsState.items.length > 0 || (menuDropdownStatus === null || menuDropdownStatus === void 0 ? void 0 : menuDropdownStatus.content))), trigger: null, triggerRef: triggerWrapperRef, triggerId: activeTriggerToken === null || activeTriggerToken === void 0 ? void 0 : activeTriggerToken.id, contentKey: triggerWrapperReady
+                    ? `trigger-${activeTriggerToken === null || activeTriggerToken === void 0 ? void 0 : activeTriggerToken.id}-${activeTriggerToken === null || activeTriggerToken === void 0 ? void 0 : activeTriggerToken.triggerChar}-${menuItemsState ? menuItemsState.items.length > 0 : false}`
+                    : undefined, 
+                /* istanbul ignore next -- integ test: src/prompt-input/__integ__/prompt-input-token-mode.test.ts > "clicking a menu option inserts reference and retains focus" */
+                onMouseDown: event => {
+                    // Prevent default to stop the dropdown from stealing focus from the contentEditable.
+                    // Without this, clicking a menu option would blur the input before the selection handler fires.
+                    event.preventDefault();
+                }, footer: (menuDropdownStatus === null || menuDropdownStatus === void 0 ? void 0 : menuDropdownStatus.isSticky) && menuDropdownStatus.content ? (React.createElement(DropdownFooter, { id: menuFooterControlId, content: menuDropdownStatus.content, hasItems: menuItemsState ? menuItemsState.items.length >= 1 : false })) : null, content: React.createElement(React.Fragment, null, shouldRenderMenuDropdown && menuItemsState && menuItemsHandlers && activeMenu && (React.createElement(MenuDropdown, { menu: activeMenu, statusType: (_a = activeMenu.statusType) !== null && _a !== void 0 ? _a : 'finished', menuItemsState: menuItemsState, menuItemsHandlers: menuItemsHandlers, highlightedOptionId: highlightedMenuOptionId, highlightText: menuFilterText, listId: menuListId, controlId: controlId !== null && controlId !== void 0 ? controlId : '', handleLoadMore: handleLoadMore, hasDropdownStatus: (menuDropdownStatus === null || menuDropdownStatus === void 0 ? void 0 : menuDropdownStatus.content) !== null, listBottom: !(menuDropdownStatus === null || menuDropdownStatus === void 0 ? void 0 : menuDropdownStatus.isSticky) && (menuDropdownStatus === null || menuDropdownStatus === void 0 ? void 0 : menuDropdownStatus.content) ? (React.createElement(DropdownFooter, { content: menuDropdownStatus.content, id: menuFooterControlId })) : null, ariaDescribedby: (menuDropdownStatus === null || menuDropdownStatus === void 0 ? void 0 : menuDropdownStatus.content) ? menuFooterControlId : undefined }))) }))));
+}
+//# sourceMappingURL=token-mode.js.map

package/prompt-input/components/token-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-mode.js","sourceRoot":"","sources":["../../../../src/prompt-input/components/token-mode.tsx"],"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 React from 'react';\nimport clsx from 'clsx';\n\nimport Dropdown from '../../dropdown/internal';\nimport DropdownFooter from '../../internal/components/dropdown-footer';\nimport { DropdownStatusResult } from '../../internal/components/dropdown-status';\nimport { MenuItemsHandlers, MenuItemsState } from '../core/menu-state';\nimport { PromptInputProps } from '../interfaces';\nimport MenuDropdown from './menu-dropdown';\n\nimport styles from '../styles.css.js';\nimport testutilStyles from '../test-classes/styles.css.js';\n\n/** Props for the token-mode contentEditable input and its associated menu dropdown. */\ninterface TokenModeProps {\n  /** Ref to the contentEditable div */\n  editableElementRef: React.RefObject<HTMLDivElement>;\n  /** Ref to the active trigger element, used to anchor the dropdown */\n  triggerWrapperRef: React.MutableRefObject<HTMLElement | null>;\n\n  controlId?: string;\n  menuListId: string;\n  menuFooterControlId: string;\n  highlightedMenuOptionId?: string;\n\n  /** When set, renders a hidden input for native form submission */\n  name?: string;\n  /** Plain text representation of the current tokens */\n  plainTextValue: string;\n  menuIsOpen: boolean;\n  /** True once the trigger element is mounted and ready for dropdown positioning */\n  triggerWrapperReady: boolean;\n  shouldRenderMenuDropdown: boolean;\n\n  activeMenu: PromptInputProps.MenuDefinition | null;\n  activeTriggerToken: PromptInputProps.TriggerToken | null;\n  menuFilterText: string;\n  menuItemsState: MenuItemsState | null;\n  menuItemsHandlers: MenuItemsHandlers | null;\n  menuDropdownStatus: DropdownStatusResult | null;\n\n  handleInput: () => void;\n  handleLoadMore: () => void;\n\n  /** Spread onto the contentEditable div — includes aria attrs, className, and event handlers */\n  editableElementAttributes: React.HTMLAttributes<HTMLDivElement> & {\n    'data-placeholder'?: string;\n  };\n\n  i18nStrings?: PromptInputProps['i18nStrings'];\n\n  maxMenuHeight?: number;\n}\n\nconst MENU_MIN_WIDTH = 300;\n\nexport default function TokenMode({\n  editableElementRef,\n  triggerWrapperRef,\n  controlId,\n  menuListId,\n  menuFooterControlId,\n  highlightedMenuOptionId,\n  name,\n  plainTextValue,\n  menuIsOpen,\n  triggerWrapperReady,\n  shouldRenderMenuDropdown,\n  activeMenu,\n  activeTriggerToken,\n  menuFilterText,\n  menuItemsState,\n  menuItemsHandlers,\n  menuDropdownStatus,\n  maxMenuHeight,\n  handleInput,\n  handleLoadMore,\n  editableElementAttributes,\n}: TokenModeProps) {\n  return (\n    <>\n      {/* Hidden input enables native form submission with the plain text value when a name is provided */}\n      {name && <input type=\"hidden\" name={name} value={plainTextValue} />}\n      <div className={styles['editable-wrapper']}>\n        <div\n          id={controlId}\n          ref={editableElementRef}\n          role=\"textbox\"\n          aria-multiline=\"true\"\n          aria-haspopup=\"listbox\"\n          aria-expanded={menuIsOpen && shouldRenderMenuDropdown}\n          contentEditable={\n            !editableElementAttributes['aria-disabled'] && !editableElementAttributes['aria-readonly']\n              ? 'true'\n              : 'false'\n          }\n          // React warns when children of a contentEditable element are managed by React.\n          // We suppress this because we intentionally manage the DOM directly via token-renderer\n          // to avoid React's reconciliation conflicting with browser-native editing behavior.\n          suppressContentEditableWarning={true}\n          aria-controls={menuIsOpen ? menuListId : undefined}\n          // aria-owns needed for Safari+VoiceOver to announce activedescendant content\n          aria-owns={menuIsOpen ? menuListId : undefined}\n          aria-activedescendant={highlightedMenuOptionId}\n          onInput={handleInput}\n          {...editableElementAttributes}\n          className={clsx(\n            editableElementAttributes.className,\n            testutilStyles['content-editable'],\n            styles['editable-element']\n          )}\n        />\n        <Dropdown\n          minWidth={MENU_MIN_WIDTH}\n          maxHeight={maxMenuHeight}\n          expandToViewport={true}\n          open={\n            !!(\n              shouldRenderMenuDropdown &&\n              triggerWrapperReady &&\n              menuIsOpen &&\n              menuItemsState &&\n              (menuItemsState.items.length > 0 || menuDropdownStatus?.content)\n            )\n          }\n          trigger={null}\n          triggerRef={triggerWrapperRef}\n          triggerId={activeTriggerToken?.id}\n          contentKey={\n            triggerWrapperReady\n              ? `trigger-${activeTriggerToken?.id}-${activeTriggerToken?.triggerChar}-${menuItemsState ? menuItemsState.items.length > 0 : false}`\n              : undefined\n          }\n          /* istanbul ignore next -- integ test: src/prompt-input/__integ__/prompt-input-token-mode.test.ts > \"clicking a menu option inserts reference and retains focus\" */\n          onMouseDown={event => {\n            // Prevent default to stop the dropdown from stealing focus from the contentEditable.\n            // Without this, clicking a menu option would blur the input before the selection handler fires.\n            event.preventDefault();\n          }}\n          footer={\n            menuDropdownStatus?.isSticky && menuDropdownStatus.content ? (\n              <DropdownFooter\n                id={menuFooterControlId}\n                content={menuDropdownStatus.content}\n                hasItems={menuItemsState ? menuItemsState.items.length >= 1 : false}\n              />\n            ) : null\n          }\n          content={\n            <>\n              {shouldRenderMenuDropdown && menuItemsState && menuItemsHandlers && activeMenu && (\n                <MenuDropdown\n                  menu={activeMenu}\n                  statusType={activeMenu.statusType ?? 'finished'}\n                  menuItemsState={menuItemsState}\n                  menuItemsHandlers={menuItemsHandlers}\n                  highlightedOptionId={highlightedMenuOptionId}\n                  highlightText={menuFilterText}\n                  listId={menuListId}\n                  controlId={controlId ?? ''}\n                  handleLoadMore={handleLoadMore}\n                  hasDropdownStatus={menuDropdownStatus?.content !== null}\n                  listBottom={\n                    !menuDropdownStatus?.isSticky && menuDropdownStatus?.content ? (\n                      <DropdownFooter content={menuDropdownStatus.content} id={menuFooterControlId} />\n                    ) : null\n                  }\n                  ariaDescribedby={menuDropdownStatus?.content ? menuFooterControlId : undefined}\n                />\n              )}\n            </>\n          }\n        />\n      </div>\n    </>\n  );\n}\n"]}

package/prompt-input/core/caret-controller.d.ts

@@ -0,0 +1,73 @@
+import { PromptInputProps } from '../interfaces';
+/** Returns the Selection from the element's owning window, supporting iframe contexts. */
+export declare function getOwnerSelection(element: Node): Selection | null;
+/** Logical lengths for each token type, used for cursor position calculations. */
+export declare const TOKEN_LENGTHS: {
+  readonly REFERENCE: 1;
+  readonly LINE_BREAK: 1;
+  readonly trigger: (filterText: string) => number;
+  readonly text: (content: string) => number;
+};
+/** Calculates the logical cursor position after a given token index. */
+export declare function calculateTokenPosition(tokens: readonly PromptInputProps.InputToken[], upToIndex: number): number;
+/** Calculates the total logical length of all tokens. */
+export declare function calculateTotalTokenLength(tokens: readonly PromptInputProps.InputToken[]): number;
+/** A resolved position within the DOM: a node and an offset into it. */
+interface DOMLocation {
+  node: Node;
+  offset: number;
+}
+/**
+ * Manages caret positioning within a contentEditable element.
+ * Translates between logical token positions and DOM Range/Selection API.
+ */
+export declare class CaretController {
+  private element;
+  private state;
+  constructor(element: HTMLElement);
+  private get ownerDoc();
+  /**
+   * Creates a DOM Range from resolved start/end locations and applies it to the given selection.
+   * Returns the created Range for further use (e.g. scroll-into-view checks).
+   */
+  applyRange(ownerDocument: Document, selection: Selection, startLocation: DOMLocation, endLocation?: DOMLocation): Range;
+  /** Returns the logical length of a DOM node based on its token type. */
+  private getNodeLength;
+  /** Returns the current logical caret position from the DOM selection. */
+  getPosition(): number;
+  /** Finds the trigger element at the current caret position, if any. */
+  findActiveTrigger(): HTMLElement | null;
+  /**
+   * Sets the caret to a logical position, or creates a selection range if end is provided.
+   * Handles smart positioning around atomic reference tokens and scrolls into view.
+   * @param start logical start position
+   * @param end optional logical end position for range selection
+   */
+  setPosition(start: number, end?: number): void;
+  /** Captures the current caret/selection state for later restoration. */
+  capture(): void;
+  /** Returns the captured caret start position, or null if no valid capture exists. */
+  getSavedPosition(): number | null;
+  /** Restores the caret to the previously captured state. */
+  restore(offset?: number): void;
+  /** Overrides the captured state so the next restore() positions to a calculated location.
+   *  Currently used only in tests — consider removing if no production use case emerges.
+   */
+  setCapturedPosition(start: number, end?: number): void;
+  /** Selects all content in the element. */
+  selectAll(): void;
+  /** Positions the caret at the end of a text node. */
+  positionAfterText(textNode: Text): void;
+  /** Moves the caret forward by a logical offset. */
+  moveForward(offset: number): void;
+  /** Moves the caret backward by a logical offset, clamped to 0. */
+  moveBackward(offset: number): void;
+  private calculatePositionFromRange;
+  private findDOMLocation;
+  /** Resolves a DOM location for a specific child node at the given offset within a paragraph. */
+  private resolveChildLocation;
+  private findLocationInParagraph;
+  private countParagraphContent;
+  private countUpToCursor;
+}
+export {};

package/prompt-input/core/caret-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caret-controller.d.ts","sourceRoot":"","sources":["../../../../src/prompt-input/core/caret-controller.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAYjD,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,CAEjE;AAED,kFAAkF;AAClF,eAAO,MAAM,aAAa;;;mCAGF,MAAM;6BACZ,MAAM;CACd,CAAC;AAEX,wEAAwE;AACxE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,gBAAgB,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAehH;AAED,yDAAyD;AACzD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,gBAAgB,CAAC,UAAU,EAAE,GAAG,MAAM,CAEhG;AAQD,wEAAwE;AACxE,UAAU,WAAW;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,KAAK,CAAa;gBAEd,OAAO,EAAE,WAAW;IAKhC,OAAO,KAAK,QAAQ,GAEnB;IAED;;;OAGG;IACH,UAAU,CACR,aAAa,EAAE,QAAQ,EACvB,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,WAAW,EAC1B,WAAW,CAAC,EAAE,WAAW,GACxB,KAAK;IAeR,wEAAwE;IACxE,OAAO,CAAC,aAAa;IAYrB,yEAAyE;IACzE,WAAW,IAAI,MAAM;IAcrB,uEAAuE;IACvE,iBAAiB,IAAI,WAAW,GAAG,IAAI;IAuCvC;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IA0B9C,wEAAwE;IACxE,OAAO,IAAI,IAAI;IAmBf,qFAAqF;IACrF,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAIjC,2DAA2D;IAC3D,OAAO,CAAC,MAAM,SAAI,GAAG,IAAI;IAQzB;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAItD,0CAA0C;IAC1C,SAAS,IAAI,IAAI;IA6BjB,qDAAqD;IACrD,iBAAiB,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI;IAYvC,mDAAmD;IACnD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKjC,kEAAkE;IAClE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKlC,OAAO,CAAC,0BAA0B;IA4BlC,OAAO,CAAC,eAAe;IA8BvB,gGAAgG;IAChG,OAAO,CAAC,oBAAoB;IAqC5B,OAAO,CAAC,uBAAuB;IAmB/B,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,eAAe;CA+DxB"}

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

@@ -0,0 +1,396 @@
+// 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 { findAllParagraphs, findElement, getTokenType, isEmptyState, isReferenceElementType, stripZeroWidthCharacters, } from './dom-utils';
+import { isBreakTextToken, isTextNode, isTextToken, isTriggerToken } from './type-guards';
+/** Returns the Selection from the element's owning window, supporting iframe contexts. */
+export function getOwnerSelection(element) {
+    var _a, _b;
+    return ((_b = (_a = element.ownerDocument) === null || _a === void 0 ? void 0 : _a.defaultView) !== null && _b !== void 0 ? _b : window).getSelection();
+}
+/** Logical lengths for each token type, used for cursor position calculations. */
+export const TOKEN_LENGTHS = {
+    REFERENCE: 1,
+    LINE_BREAK: 1,
+    trigger: (filterText) => 1 + filterText.length,
+    text: (content) => content.length,
+};
+/** Calculates the logical cursor position after a given token index. */
+export function calculateTokenPosition(tokens, upToIndex) {
+    let pos = 0;
+    for (let i = 0; i <= upToIndex && i < tokens.length; i++) {
+        const token = tokens[i];
+        if (isTextToken(token)) {
+            pos += TOKEN_LENGTHS.text(token.value);
+        }
+        else if (isBreakTextToken(token)) {
+            pos += TOKEN_LENGTHS.LINE_BREAK;
+        }
+        else if (isTriggerToken(token)) {
+            pos += TOKEN_LENGTHS.trigger(token.value);
+        }
+        else {
+            pos += TOKEN_LENGTHS.REFERENCE;
+        }
+    }
+    return pos;
+}
+/** Calculates the total logical length of all tokens. */
+export function calculateTotalTokenLength(tokens) {
+    return tokens.length === 0 ? 0 : calculateTokenPosition(tokens, tokens.length - 1);
+}
+/**
+ * Manages caret positioning within a contentEditable element.
+ * Translates between logical token positions and DOM Range/Selection API.
+ */
+export class CaretController {
+    constructor(element) {
+        this.element = element;
+        this.state = { start: 0, end: undefined, isValid: false };
+    }
+    get ownerDoc() {
+        var _a;
+        return (_a = this.element.ownerDocument) !== null && _a !== void 0 ? _a : document;
+    }
+    /**
+     * Creates a DOM Range from resolved start/end locations and applies it to the given selection.
+     * Returns the created Range for further use (e.g. scroll-into-view checks).
+     */
+    applyRange(ownerDocument, selection, startLocation, endLocation) {
+        const range = ownerDocument.createRange();
+        range.setStart(startLocation.node, startLocation.offset);
+        if (endLocation) {
+            range.setEnd(endLocation.node, endLocation.offset);
+        }
+        else {
+            range.collapse(true);
+        }
+        selection.removeAllRanges();
+        selection.addRange(range);
+        return range;
+    }
+    /** Returns the logical length of a DOM node based on its token type. */
+    getNodeLength(node) {
+        const tokenType = isHTMLElement(node) ? getTokenType(node) : null;
+        if (isTextNode(node) || tokenType === ElementType.Trigger) {
+            return TOKEN_LENGTHS.text(node.textContent || '');
+        }
+        else if (tokenType && isReferenceElementType(tokenType)) {
+            return TOKEN_LENGTHS.REFERENCE;
+        }
+        return 0;
+    }
+    /** Returns the current logical caret position from the DOM selection. */
+    getPosition() {
+        const selection = getOwnerSelection(this.element);
+        if (!(selection === null || selection === void 0 ? void 0 : selection.rangeCount)) {
+            return 0;
+        }
+        const range = selection.getRangeAt(0);
+        if (!this.element.contains(range.startContainer)) {
+            return 0;
+        }
+        return this.calculatePositionFromRange(range, false);
+    }
+    /** Finds the trigger element at the current caret position, if any. */
+    findActiveTrigger() {
+        const selection = getOwnerSelection(this.element);
+        if (!(selection === null || selection === void 0 ? void 0 : selection.rangeCount)) {
+            return null;
+        }
+        const range = selection.getRangeAt(0);
+        if (!range.collapsed) {
+            return null;
+        }
+        let node = range.startContainer;
+        // Walk up from cursor to find a trigger ancestor
+        while (node && node !== this.element) {
+            if (isHTMLElement(node) && getTokenType(node) === ElementType.Trigger) {
+                if (isTextNode(range.startContainer) && range.startContainer.parentElement === node) {
+                    // Caret must be after the trigger character (offset > 0) to be considered "in" the trigger
+                    if (range.startOffset > 0) {
+                        return node;
+                    }
+                }
+                else {
+                    return node;
+                }
+            }
+            node = node.parentNode;
+        }
+        // Also check: cursor at offset 0 of a text node right after a trigger
+        if (isTextNode(range.startContainer) && range.startOffset === 0) {
+            const prevSibling = range.startContainer.previousSibling;
+            if (isHTMLElement(prevSibling) && getTokenType(prevSibling) === ElementType.Trigger) {
+                return prevSibling;
+            }
+        }
+        return null;
+    }
+    /**
+     * Sets the caret to a logical position, or creates a selection range if end is provided.
+     * Handles smart positioning around atomic reference tokens and scrolls into view.
+     * @param start logical start position
+     * @param end optional logical end position for range selection
+     */
+    setPosition(start, end) {
+        var _a;
+        const ownerDocument = this.ownerDoc;
+        if (ownerDocument.activeElement !== this.element) {
+            this.element.focus();
+        }
+        const startLocation = this.findDOMLocation(start);
+        if (!startLocation) {
+            return;
+        }
+        const selection = getOwnerSelection(this.element);
+        if (!selection) {
+            return;
+        }
+        const endLocation = end !== undefined && end !== start ? ((_a = this.findDOMLocation(end)) !== null && _a !== void 0 ? _a : undefined) : undefined;
+        this.applyRange(ownerDocument, selection, startLocation, endLocation);
+        this.state = { start, end, isValid: true };
+        ownerDocument.dispatchEvent(new Event('selectionchange'));
+    }
+    /** Captures the current caret/selection state for later restoration. */
+    capture() {
+        const selection = getOwnerSelection(this.element);
+        if (!(selection === null || selection === void 0 ? void 0 : selection.rangeCount)) {
+            this.state = { start: 0, end: undefined, isValid: false };
+            return;
+        }
+        const range = selection.getRangeAt(0);
+        if (!this.element.contains(range.startContainer)) {
+            this.state = { start: 0, end: undefined, isValid: false };
+            return;
+        }
+        const start = this.calculatePositionFromRange(range, false);
+        const end = range.collapsed ? undefined : this.calculatePositionFromRange(range, true);
+        this.state = { start, end, isValid: true };
+    }
+    /** Returns the captured caret start position, or null if no valid capture exists. */
+    getSavedPosition() {
+        return this.state.isValid ? this.state.start : null;
+    }
+    /** Restores the caret to the previously captured state. */
+    restore(offset = 0) {
+        if (!this.state.isValid || this.ownerDoc.activeElement !== this.element) {
+            return;
+        }
+        this.setPosition(this.state.start + offset, this.state.end !== undefined ? this.state.end + offset : undefined);
+    }
+    /** Overrides the captured state so the next restore() positions to a calculated location.
+     *  Currently used only in tests — consider removing if no production use case emerges.
+     */
+    setCapturedPosition(start, end) {
+        this.state = { start, end, isValid: true };
+    }
+    /** Selects all content in the element. */
+    selectAll() {
+        const selection = getOwnerSelection(this.element);
+        if (!selection) {
+            return;
+        }
+        if (isEmptyState(this.element)) {
+            return;
+        }
+        if (this.ownerDoc.activeElement !== this.element) {
+            this.element.focus();
+        }
+        const paragraphs = findAllParagraphs(this.element);
+        if (paragraphs.length === 0) {
+            return;
+        }
+        const firstP = paragraphs[0];
+        const lastP = paragraphs[paragraphs.length - 1];
+        const range = this.ownerDoc.createRange();
+        range.setStart(firstP, 0);
+        range.setEnd(lastP, lastP.childNodes.length);
+        selection.removeAllRanges();
+        selection.addRange(range);
+    }
+    /** Positions the caret at the end of a text node. */
+    positionAfterText(textNode) {
+        var _a;
+        const range = this.ownerDoc.createRange();
+        range.setStart(textNode, ((_a = textNode.textContent) === null || _a === void 0 ? void 0 : _a.length) || 0);
+        range.collapse(true);
+        const selection = getOwnerSelection(this.element);
+        if (selection) {
+            selection.removeAllRanges();
+            selection.addRange(range);
+        }
+    }
+    /** Moves the caret forward by a logical offset. */
+    moveForward(offset) {
+        const currentPos = this.getPosition();
+        this.setPosition(currentPos + offset);
+    }
+    /** Moves the caret backward by a logical offset, clamped to 0. */
+    moveBackward(offset) {
+        const currentPos = this.getPosition();
+        this.setPosition(Math.max(0, currentPos - offset));
+    }
+    calculatePositionFromRange(range, useEnd) {
+        const paragraphs = findAllParagraphs(this.element);
+        if (paragraphs.length === 0) {
+            return 0;
+        }
+        const container = useEnd ? range.endContainer : range.startContainer;
+        const offset = useEnd ? range.endOffset : range.startOffset;
+        let position = 0;
+        for (let pIndex = 0; pIndex < paragraphs.length; pIndex++) {
+            const p = paragraphs[pIndex];
+            if (pIndex > 0) {
+                position += TOKEN_LENGTHS.LINE_BREAK;
+            }
+            if (!p.contains(container)) {
+                position += this.countParagraphContent(p);
+            }
+            else {
+                position += this.countUpToCursor(p, container, offset);
+                break;
+            }
+        }
+        return position;
+    }
+    findDOMLocation(position) {
+        var _a;
+        const paragraphs = findAllParagraphs(this.element);
+        let caretPos = 0;
+        for (let pIndex = 0; pIndex < paragraphs.length; pIndex++) {
+            const p = paragraphs[pIndex];
+            if (pIndex > 0) {
+                caretPos += TOKEN_LENGTHS.LINE_BREAK;
+                if (caretPos >= position) {
+                    return { node: p, offset: 0 };
+                }
+            }
+            const paragraphLength = this.countParagraphContent(p);
+            if (caretPos + paragraphLength >= position) {
+                return this.findLocationInParagraph(p, position - caretPos);
+            }
+            caretPos += paragraphLength;
+        }
+        const lastP = paragraphs[paragraphs.length - 1];
+        if ((lastP === null || lastP === void 0 ? void 0 : lastP.lastChild) && isTextNode(lastP.lastChild)) {
+            return { node: lastP.lastChild, offset: ((_a = lastP.lastChild.textContent) === null || _a === void 0 ? void 0 : _a.length) || 0 };
+        }
+        return lastP ? { node: lastP, offset: lastP.childNodes.length } : null;
+    }
+    /** Resolves a DOM location for a specific child node at the given offset within a paragraph. */
+    resolveChildLocation(p, child, offsetInChild) {
+        if (isTextNode(child)) {
+            return { node: child, offset: offsetInChild };
+        }
+        if (!isHTMLElement(child)) {
+            return { node: p, offset: Array.from(p.childNodes).indexOf(child) };
+        }
+        const tokenType = getTokenType(child);
+        const childIndex = Array.from(p.childNodes).indexOf(child);
+        if (tokenType === ElementType.Trigger) {
+            if (offsetInChild === 0) {
+                return { node: p, offset: childIndex };
+            }
+            const triggerTextNode = child.childNodes[0];
+            if (triggerTextNode && isTextNode(triggerTextNode)) {
+                return { node: triggerTextNode, offset: offsetInChild };
+            }
+            return { node: p, offset: childIndex };
+        }
+        if (isReferenceElementType(tokenType)) {
+            if (offsetInChild === 0) {
+                return { node: p, offset: childIndex };
+            }
+            const nextSibling = child.nextSibling;
+            if (nextSibling) {
+                return isTextNode(nextSibling) ? { node: nextSibling, offset: 0 } : { node: p, offset: childIndex + 1 };
+            }
+            return { node: p, offset: p.childNodes.length };
+        }
+        return { node: p, offset: childIndex };
+    }
+    findLocationInParagraph(p, targetOffset) {
+        var _a;
+        let offsetInParagraph = 0;
+        for (const child of Array.from(p.childNodes)) {
+            const childLength = this.getNodeLength(child);
+            if (offsetInParagraph + childLength >= targetOffset) {
+                return this.resolveChildLocation(p, child, targetOffset - offsetInParagraph);
+            }
+            offsetInParagraph += childLength;
+        }
+        if (p.lastChild && isTextNode(p.lastChild)) {
+            return { node: p.lastChild, offset: ((_a = p.lastChild.textContent) === null || _a === void 0 ? void 0 : _a.length) || 0 };
+        }
+        return { node: p, offset: p.childNodes.length };
+    }
+    countParagraphContent(p) {
+        let count = 0;
+        for (const child of Array.from(p.childNodes)) {
+            count += this.getNodeLength(child);
+        }
+        return count;
+    }
+    countUpToCursor(p, container, offset) {
+        if (container === p) {
+            let count = 0;
+            for (let i = 0; i < offset && i < p.childNodes.length; i++) {
+                count += this.getNodeLength(p.childNodes[i]);
+            }
+            return count;
+        }
+        let count = 0;
+        for (const child of Array.from(p.childNodes)) {
+            if (child === container || child.contains(container)) {
+                if (isTextNode(child)) {
+                    return count + offset;
+                }
+                if (isHTMLElement(child)) {
+                    const tokenType = getTokenType(child);
+                    if (tokenType === ElementType.Trigger) {
+                        const triggerTextNode = child.childNodes[0];
+                        if (triggerTextNode && isTextNode(triggerTextNode) && triggerTextNode === container) {
+                            return count + offset;
+                        }
+                    }
+                    else if (isReferenceElementType(tokenType)) {
+                        const caretSpotBefore = findElement(child, { tokenType: ElementType.CaretSpotBefore });
+                        const caretSpotAfter = findElement(child, { tokenType: ElementType.CaretSpotAfter });
+                        const caretInBefore = caretSpotBefore && (caretSpotBefore === container || caretSpotBefore.contains(container));
+                        const caretInAfter = caretSpotAfter && (caretSpotAfter === container || caretSpotAfter.contains(container));
+                        if (caretInBefore) {
+                            // Caret is in the before-spot: any typed text counts from the start of the reference
+                            const beforeContent = stripZeroWidthCharacters(caretSpotBefore.textContent || '');
+                            if (beforeContent && isTextNode(container)) {
+                                return count + offset;
+                            }
+                            // No real content — caret is logically before the reference
+                            return count;
+                        }
+                        else if (caretInAfter) {
+                            // Caret is in the after-spot: position is after the reference (count it first)
+                            count += TOKEN_LENGTHS.REFERENCE;
+                            const afterContent = stripZeroWidthCharacters(caretSpotAfter.textContent || '');
+                            if (afterContent && isTextNode(container)) {
+                                // offset - 1 because the zero-width character occupies position 0
+                                const contentOffset = Math.max(0, offset - 1);
+                                return count + contentOffset;
+                            }
+                            // No real content — caret is logically after the reference
+                            return count;
+                        }
+                        else {
+                            return count + TOKEN_LENGTHS.REFERENCE;
+                        }
+                    }
+                }
+                return count + this.getNodeLength(child);
+            }
+            count += this.getNodeLength(child);
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=caret-controller.js.map