@cloudscape-design/components 3.0.1270 → 3.0.1271

package/prompt-input/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/prompt-input/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B,QAAA,MAAM,WAAW,+FA8ChB,CAAC;AAEF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/prompt-input/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B,QAAA,MAAM,WAAW,wIA8ChB,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/prompt-input/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/prompt-input/index.tsx"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,sCAAsC;AACtC,YAAY,CAAC;AACb,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,gBAAgB,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExE,OAAO,mBAAmB,MAAM,YAAY,CAAC;AAI7C,MAAM,WAAW,GAAG,KAAK,CAAC,UAAU,CAClC,CACE,EACE,YAAY,EACZ,SAAS,EACT,yBAAyB,EACzB,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,oBAAoB,EACpB,OAAO,GAAG,CAAC,EACX,OAAO,GAAG,CAAC,EACX,GAAG,KAAK,EACS,EACnB,GAAoC,EACpC,EAAE;IACF,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,aAAa,EAAE;QACzD,KAAK,EAAE;YACL,QAAQ;YACR,YAAY;YACZ,SAAS;YACT,yBAAyB;YACzB,mBAAmB;YACnB,UAAU;YACV,oBAAoB;YACpB,OAAO;YACP,OAAO;SACR;KACF,CAAC,CAAC;IACH,OAAO,CACL,oBAAC,mBAAmB,IAClB,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,SAAS,EACpB,yBAAyB,EAAE,yBAAyB,EACpD,mBAAmB,EAAE,mBAAmB,EACxC,UAAU,EAAE,UAAU,EACtB,oBAAoB,EAAE,oBAAoB,EAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,KACZ,KAAK,KACL,kBAAkB,EACtB,GAAG,EAAE,GAAG,GACR,CACH,CAAC;AACJ,CAAC,CACF,CAAC;AACF,gBAAgB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAC7C,eAAe,WAAW,CAAC","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\n'use client';\nimport React from 'react';\n\nimport useBaseComponent from '../internal/hooks/use-base-component';\nimport { applyDisplayName } from '../internal/utils/apply-display-name';\nimport { PromptInputProps } from './interfaces';\nimport InternalPromptInput from './internal';\n\nexport { PromptInputProps };\n\nconst PromptInput = React.forwardRef(\n  (\n    {\n      autoComplete,\n      autoFocus,\n      disableBrowserAutocorrect,\n      disableActionButton,\n      spellcheck,\n      readOnly,\n      actionButtonIconName,\n      minRows = 1,\n      maxRows = 3,\n      ...props\n    }: PromptInputProps,\n    ref: React.Ref<PromptInputProps.Ref>\n  ) => {\n    const baseComponentProps = useBaseComponent('PromptInput', {\n      props: {\n        readOnly,\n        autoComplete,\n        autoFocus,\n        disableBrowserAutocorrect,\n        disableActionButton,\n        spellcheck,\n        actionButtonIconName,\n        minRows,\n        maxRows,\n      },\n    });\n    return (\n      <InternalPromptInput\n        readOnly={readOnly}\n        autoComplete={autoComplete}\n        autoFocus={autoFocus}\n        disableBrowserAutocorrect={disableBrowserAutocorrect}\n        disableActionButton={disableActionButton}\n        spellcheck={spellcheck}\n        actionButtonIconName={actionButtonIconName}\n        minRows={minRows}\n        maxRows={maxRows}\n        {...props}\n        {...baseComponentProps}\n        ref={ref}\n      />\n    );\n  }\n);\napplyDisplayName(PromptInput, 'PromptInput');\nexport default PromptInput;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/prompt-input/index.tsx"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,sCAAsC;AACtC,YAAY,CAAC;AACb,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,gBAAgB,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAExE,OAAO,mBAAmB,MAAM,YAAY,CAAC;AAI7C,MAAM,WAAW,GAAG,KAAK,CAAC,UAAU,CAClC,CACE,EACE,YAAY,EACZ,SAAS,EACT,yBAAyB,EACzB,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,oBAAoB,EACpB,OAAO,GAAG,CAAC,EACX,OAAO,GAAG,CAAC,EACX,GAAG,KAAK,EACS,EACnB,GAA6E,EAC7E,EAAE;IACF,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,aAAa,EAAE;QACzD,KAAK,EAAE;YACL,QAAQ;YACR,YAAY;YACZ,SAAS;YACT,yBAAyB;YACzB,mBAAmB;YACnB,UAAU;YACV,oBAAoB;YACpB,OAAO;YACP,OAAO;SACR;KACF,CAAC,CAAC;IACH,OAAO,CACL,oBAAC,mBAAmB,IAClB,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,SAAS,EACpB,yBAAyB,EAAE,yBAAyB,EACpD,mBAAmB,EAAE,mBAAmB,EACxC,UAAU,EAAE,UAAU,EACtB,oBAAoB,EAAE,oBAAoB,EAC1C,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,KACZ,KAAK,KACL,kBAAkB,EACtB,GAAG,EAAE,GAAG,GACR,CACH,CAAC;AACJ,CAAC,CACF,CAAC;AACF,gBAAgB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAC7C,eAAe,WAAW,CAAC","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\n'use client';\nimport React from 'react';\n\nimport useBaseComponent from '../internal/hooks/use-base-component';\nimport { applyDisplayName } from '../internal/utils/apply-display-name';\nimport { PromptInputProps } from './interfaces';\nimport InternalPromptInput from './internal';\n\nexport { PromptInputProps };\n\nconst PromptInput = React.forwardRef(\n  (\n    {\n      autoComplete,\n      autoFocus,\n      disableBrowserAutocorrect,\n      disableActionButton,\n      spellcheck,\n      readOnly,\n      actionButtonIconName,\n      minRows = 1,\n      maxRows = 3,\n      ...props\n    }: PromptInputProps,\n    ref: React.Ref<PromptInputProps.Ref | HTMLTextAreaElement | HTMLInputElement>\n  ) => {\n    const baseComponentProps = useBaseComponent('PromptInput', {\n      props: {\n        readOnly,\n        autoComplete,\n        autoFocus,\n        disableBrowserAutocorrect,\n        disableActionButton,\n        spellcheck,\n        actionButtonIconName,\n        minRows,\n        maxRows,\n      },\n    });\n    return (\n      <InternalPromptInput\n        readOnly={readOnly}\n        autoComplete={autoComplete}\n        autoFocus={autoFocus}\n        disableBrowserAutocorrect={disableBrowserAutocorrect}\n        disableActionButton={disableActionButton}\n        spellcheck={spellcheck}\n        actionButtonIconName={actionButtonIconName}\n        minRows={minRows}\n        maxRows={maxRows}\n        {...props}\n        {...baseComponentProps}\n        ref={ref}\n      />\n    );\n  }\n);\napplyDisplayName(PromptInput, 'PromptInput');\nexport default PromptInput;\n"]}

package/prompt-input/interfaces.d.ts

@@ -1,16 +1,91 @@
+import React from 'react';
+import { BaseDropdownHostProps, OptionsFilteringType } from '../dropdown/interfaces';
 import { IconProps } from '../icon/interfaces';
-import { BaseChangeDetail, BaseInputProps, InputAutoComplete, InputAutoCorrect, InputKeyEvents, InputSpellcheck } from '../input/interfaces';
+import { BaseInputProps, InputAutoCorrect, InputKeyEvents, InputSpellcheck } from '../input/interfaces';
 import { BaseComponentProps } from '../internal/base-component';
+import { DropdownStatusProps } from '../internal/components/dropdown-status';
+import { OptionDefinition, OptionGroup } from '../internal/components/option/interfaces';
 import { FormFieldValidationControlProps } from '../internal/context/form-field-context';
-import { BaseKeyDetail, NonCancelableEventHandler } from '../internal/events';
+import { BaseKeyDetail, CancelableEventHandler, NonCancelableEventHandler } from '../internal/events';
 /**
  * @awsuiSystem core
  */
 import { NativeAttributes } from '../internal/utils/with-native-attributes';
-export interface PromptInputProps extends Omit<BaseInputProps, 'nativeInputAttributes'>, InputKeyEvents, InputAutoCorrect, InputAutoComplete, InputSpellcheck, BaseComponentProps, FormFieldValidationControlProps {
+export interface PromptInputProps extends Omit<BaseInputProps, 'nativeInputAttributes' | 'name' | 'value' | 'onChange'>, InputKeyEvents, InputAutoCorrect, InputSpellcheck, BaseComponentProps, FormFieldValidationControlProps {
+  /**
+   * Specifies the name of the prompt input for form submissions.
+   */
+  name?: string;
+  /**
+   * Specifies whether to enable a browser's autocomplete functionality for this input.
+   * In some cases it might be appropriate to disable autocomplete (for example, for security-sensitive fields).
+   * To use it correctly, set the `name` property.
+   *
+   * You can either provide a boolean value to set the property to "on" or "off", or specify a string value
+   * for the [autocomplete](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete) attribute.
+   *
+   * Note: When `tokens` is defined, autocomplete will not function.
+   */
+  autoComplete?: boolean | string;
+  /**
+   * Specifies the content of the prompt input.
+   *
+   * When `tokens` is not defined:
+   * - This property is required
+   * - Represents the current text content of the textarea
+   *
+   * When `tokens` is defined:
+   * - This property is optional and defaults to empty string
+   * - The actual content is managed via the `tokens` array
+   */
+  value?: string;
+  /**
+   * Specifies the content of the prompt input when using token mode.
+   *
+   * Available types and their properties:
+   * - Text tokens:
+   *   - `value` contains the text content.
+   * - Reference tokens:
+   *   - `id` as the unique identifier, this is auto-generated however when setting `tokens` it is required to provide an ID.
+   *   - `value` contains the reference value.
+   *   - `label` for display (e.g., 'file.txt').
+   *   - `menuId` for the associated menu (optional).
+   *   - `pinned` to render at the start of the input.
+   * - Trigger tokens:
+   *   - `id` as the unique identifier, this is auto-generated however when setting `tokens` it is required to provide an ID.
+   *   - `value` contains the filter text.
+   *   - `triggerChar` for the trigger character.
+   *
+   * When `menus` is defined, you should use `tokens` to control the content instead of `value`.
+   *
+   * Requires React 18.
+   */
+  tokens?: readonly PromptInputProps.InputToken[];
+  /**
+   * Custom function to transform tokens into plain text for the `value` field in `onChange` and `onAction` events
+   * and for the hidden input when `name` is specified.
+   *
+   * If not provided, falls back to a default simple implementation.
+   *
+   * Use this to customize serialization, for example:
+   * - Using `label` instead of `value` for reference tokens
+   * - Adding custom formatting or separators between tokens
+   *
+   * Requires React 18.
+   */
+  tokensToText?: (tokens: readonly PromptInputProps.InputToken[]) => string;
+  /**
+   * Called whenever a user changes the input value (by typing or pasting).
+   * The event `detail` contains the current value as a string and an array of tokens.
+   *
+   * When `tokens` is defined, the `value` is derived from `tokensToText(tokens)` if provided, otherwise from a default simple implementation.
+   */
+  onChange?: NonCancelableEventHandler<PromptInputProps.ChangeDetail>;
   /**
    * Called whenever a user clicks the action button or presses the "Enter" key.
-   * The event `detail` contains the current value of the field.
+   * The event `detail` contains the current value as a string and an array of tokens.
+   *
+   * When `tokens` is defined, the `value` is derived from `tokensToText(tokens)` if provided, otherwise from a default simple implementation.
    */
   onAction?: NonCancelableEventHandler<PromptInputProps.ActionDetail>;
   /**
@@ -53,6 +128,7 @@ export interface PromptInputProps extends Omit<BaseInputProps, 'nativeInputAttri
   /**
    * Adds an aria-label to the action button.
    * @i18n
+   * @deprecated Use `i18nStrings.actionButtonAriaLabel` instead.
    */
   actionButtonAriaLabel?: string;
   /**
@@ -92,6 +168,97 @@ export interface PromptInputProps extends Omit<BaseInputProps, 'nativeInputAttri
    * Determines whether the secondary content area of the input has padding. If true, removes the default padding from the secondary content area.
    */
   disableSecondaryContentPaddings?: boolean;
+  /**
+   * Defines trigger-based menus that appear when the user types a specific character (e.g., `@` or `/`).
+   * Each menu definition maps a trigger character to a list of selectable options.
+   *
+   * Requires React 18.
+   *
+   * #### MenuDefinition
+   * - `id` (string) - Unique identifier for this menu. Used in event callbacks to identify the menu.
+   * - `trigger` (string) - The character that activates this menu (e.g., `@`, `/`, `#`).
+   * - `options` (Option[] | OptionGroup[]) - The selectable items shown in the dropdown.
+   * - `useAtStart` (boolean) - (Optional) When true, the trigger is only detected at the start of the input and after any pinned tokens. Selected options become pinned reference tokens. Defaults to false.
+   * - `filteringType` (`'auto'` | `'manual'`) - (Optional) How filtering is applied. `auto` filters options client-side based on typed text. `manual` disables built-in filtering — use `onMenuFilter` to provide filtered options. Defaults to `auto`.
+   * - `statusType` (`'pending'` | `'loading'` | `'finished'` | `'error'`) - (Optional) The loading status of the menu options. Use with `onMenuLoadItems` for async loading.
+   * - `empty` (string) - (Optional) Text shown when no options match the filter.
+   * - `virtualScroll` (boolean) - (Optional) Enables virtual scrolling for large option lists.
+   */
+  menus?: PromptInputProps.MenuDefinition[];
+  /**
+   * Maximum height of the menu dropdown in pixels.
+   * When not specified, the menu will grow to fit its content.
+   *
+   * Requires React 18.
+   */
+  maxMenuHeight?: number;
+  /**
+   * Called whenever a user selects an option in a menu.
+   *
+   * Requires React 18.
+   */
+  onMenuItemSelect?: NonCancelableEventHandler<PromptInputProps.MenuItemSelectDetail>;
+  /**
+   * Use this event to implement the asynchronous behavior for menus.
+   *
+   * The event is called in the following situations:
+   * - The user scrolls to the end of the list of options, if `statusType` is set to `pending` (pagination).
+   * - The user clicks on the recovery button in the error state.
+   * - The user types after the trigger character.
+   * - The menu is opened.
+   *
+   * The detail object contains the following properties:
+   * - `menuId` - The ID of the menu that triggered the event.
+   * - `filteringText` - The value to use to fetch options (undefined for pagination).
+   * - `firstPage` - Indicates that you should fetch the first page of options.
+   * - `samePage` - Indicates that you should fetch the same page (for example, when clicking recovery button).
+   *
+   * Requires React 18.
+   */
+  onMenuLoadItems?: NonCancelableEventHandler<PromptInputProps.MenuLoadItemsDetail>;
+  /**
+   * Called when the user types to filter options in manual filtering mode for a menu.
+   * Use this to filter the options based on the filtering text.
+   *
+   * The detail object contains:
+   * - `menuId` - The ID of the menu that triggered the event.
+   * - `filteringText` - The text to use for filtering options.
+   *
+   * Requires React 18.
+   */
+  onMenuFilter?: NonCancelableEventHandler<PromptInputProps.MenuFilterDetail>;
+  /**
+   * Called when a trigger character is detected and about to be converted to a trigger token.
+   * This event is cancellable - return `preventDefault()` to prevent the trigger from being created.
+   *
+   * The detail object contains:
+   * - `menuId` - The ID of the menu associated with the trigger.
+   * - `triggerChar` - The trigger character that was detected.
+   * - `position` - The position in the text where the trigger was detected.
+   *
+   * Use this to implement custom validation logic for triggers, such as preventing
+   * triggers that don't meet certain conditions (for example, limiting the amount of references in a prompt).
+   *
+   * Requires React 18.
+   */
+  onTriggerDetected?: CancelableEventHandler<PromptInputProps.TriggerDetectedDetail>;
+  /**
+   * An object containing all the localized strings required by the component.
+   *
+   * - `ariaLabel` (string) - Adds an aria-label to the input element.
+   * - `actionButtonAriaLabel` (string) - Adds an aria-label to the action button.
+   * - `menuErrorIconAriaLabel` (string) - Provides a text alternative for the error icon in the error message in menus.
+   * - `menuRecoveryText` (string) - Specifies the text for the recovery button in menus. The text is displayed next to the error text.
+   * - `menuLoadingText` (string) - Specifies the text to display when menus are in a loading state.
+   * - `menuFinishedText` (string) - Specifies the text to display when menus have finished loading all items.
+   * - `menuErrorText` (string) - Specifies the text to display when menus encounter an error while loading.
+   * - `selectedMenuItemAriaLabel` (string) - Specifies the string that describes an option as being selected.
+   * - `tokenInsertedAriaLabel` ((token: { label?: string; value: string }) => string) - Aria label announced when a reference token is inserted from a menu. Receives the token object with label and value properties.
+   * - `tokenPinnedAriaLabel` ((token: { label?: string; value: string }) => string) - Aria label announced when a reference token is pinned (inserted at the start). Receives the token object with label and value properties.
+   * - `tokenRemovedAriaLabel` ((token: { label?: string; value: string }) => string) - Aria label announced when a reference token is removed. Receives the token object with label and value properties.
+   * @i18n
+   */
+  i18nStrings?: PromptInputProps.I18nStrings;
   /**
    * Attributes to add to the native `textarea` element.
    * Some attributes will be automatically combined with internal attribute values:
@@ -99,20 +266,190 @@ export interface PromptInputProps extends Omit<BaseInputProps, 'nativeInputAttri
    * - Event handlers will be chained, unless the default is prevented.
    *
    * We do not support using this attribute to apply custom styling.
+   * When `tokens` is defined, nativeTextareaAttributes will be ignored.
    *
    * @awsuiSystem core
    */
   nativeTextareaAttributes?: NativeAttributes<React.TextareaHTMLAttributes<HTMLTextAreaElement>>;
   /**
-   * An object containing CSS properties to customize the prompt input's visual appearance.
-   * Refer to the [style](/components/prompt-input/?tabId=style) tab for more details.
    * @awsuiSystem core
    */
   style?: PromptInputProps.Style;
 }
 export declare namespace PromptInputProps {
   type KeyDetail = BaseKeyDetail;
-  type ActionDetail = BaseChangeDetail;
+  interface I18nStrings {
+    actionButtonAriaLabel?: string;
+    menuErrorIconAriaLabel?: string;
+    menuRecoveryText?: string;
+    menuLoadingText?: string;
+    menuFinishedText?: string;
+    menuErrorText?: string;
+    /**
+     * Aria label announced when a reference token is inserted from a menu.
+     * Receives the token object with label and value properties.
+     * @param token The inserted token
+     * @returns The announcement string
+     * @default `${token.label || token.value} inserted`
+     */
+    tokenInsertedAriaLabel?: (token: {
+      label?: string;
+      value: string;
+    }) => string;
+    /**
+     * Aria label announced when a reference token is pinned (inserted at the start).
+     * Receives the token object with label and value properties.
+     * @param token The pinned token
+     * @returns The announcement string
+     * @default `${token.label || token.value} pinned`
+     */
+    tokenPinnedAriaLabel?: (token: {
+      label?: string;
+      value: string;
+    }) => string;
+    /**
+     * Aria label announced when a reference token is removed.
+     * Receives the token object with label and value properties.
+     * @param token The removed token
+     * @returns The announcement string
+     * @default `${token.label || token.value} removed`
+     */
+    tokenRemovedAriaLabel?: (token: {
+      label?: string;
+      value: string;
+    }) => string;
+  }
+  interface TextToken {
+    type: 'text' | 'break';
+    value: string;
+  }
+  interface ReferenceToken {
+    type: 'reference';
+    id: string;
+    label: string;
+    value: string;
+    /**
+     * The ID of the menu this reference was selected from.
+     * Optional — references can exist without being bound to a menu
+     * (e.g., preloaded references from external sources).
+     */
+    menuId?: string;
+    /**
+     * When true, prevents user entered text from being placed before this token.
+     * Typically set for reference tokens from useAtStart menus.
+     */
+    pinned?: boolean;
+  }
+  /**
+   * Token type for menu triggers with filter text.
+   * Represents a trigger character (e.g., "@" or "/") followed by filtering text.
+   * This token type is automatically managed by the component when menus are active.
+   *
+   * - `value`: The filtering text (without the trigger character)
+   * - `triggerChar`: The trigger character that opened the menu
+   */
+  interface TriggerToken {
+    type: 'trigger';
+    value: string;
+    triggerChar: string;
+    id: string;
+  }
+  type InputToken = TextToken | ReferenceToken | TriggerToken;
+  interface ChangeDetail {
+    value: string;
+    tokens?: readonly InputToken[];
+  }
+  interface ActionDetail {
+    value: string;
+    tokens?: readonly InputToken[];
+  }
+  interface MenuItemSelectDetail {
+    menuId: string;
+    option: OptionDefinition;
+  }
+  interface MenuLoadItemsDetail {
+    menuId: string;
+    filteringText?: string;
+    firstPage: boolean;
+    samePage: boolean;
+  }
+  interface MenuFilterDetail {
+    menuId: string;
+    filteringText: string;
+  }
+  interface TriggerDetectedDetail {
+    menuId: string;
+    triggerChar: string;
+    position: number;
+  }
+  interface MenuDefinition extends Pick<DropdownStatusProps, 'empty' | 'statusType'>, Pick<BaseDropdownHostProps, 'virtualScroll'> {
+    /**
+     * The unique identifier for this menu.
+     */
+    id: string;
+    /**
+     * The unique trigger symbol for showing this menu.
+     */
+    trigger: string;
+    /**
+     * Set `useAtStart=true` for menus where a trigger should only be detected at the start of input.
+     * Set this for menus designated to modes or actions.
+     *
+     * Menus with `useAtStart=true` create pinned reference tokens.
+     */
+    useAtStart?: boolean;
+    /**
+     * Specifies an array of options that are displayed to the user as a list.
+     * The options can be grouped using `OptionGroup` objects.
+     *
+     * #### Option
+     * - `value` (string) - The returned value of the option when selected.
+     * - `label` (string) - (Optional) Option text displayed to the user.
+     * - `lang` (string) - (Optional) The language of the option, provided as a BCP 47 language tag.
+     * - `description` (string) - (Optional) Further information about the option that appears below the label.
+     * - `disabled` (boolean) - (Optional) Determines whether the option is disabled.
+     * - `labelTag` (string) - (Optional) A label tag that provides additional guidance, shown next to the label.
+     * - `tags` [string[]] - (Optional) A list of tags giving further guidance about the option.
+     * - `filteringTags` [string[]] - (Optional) A list of additional tags used for automatic filtering.
+     * - `iconName` (string) - (Optional) Specifies the name of an [icon](/components/icon/) to display in the option.
+     * - `iconAriaLabel` (string) - (Optional) Specifies alternate text for the icon. We recommend that you provide this for accessibility.
+     * - `iconAlt` (string) - (Optional) **Deprecated**, replaced by \`iconAriaLabel\`. Specifies alternate text for a custom icon, for use with `iconUrl`.
+     * - `iconUrl` (string) - (Optional) URL of a custom icon.
+     * - `iconSvg` (ReactNode) - (Optional) Custom SVG icon. Equivalent to the `svg` slot of the [icon component](/components/icon/).
+     *
+     * #### OptionGroup
+     * - `label` (string) - Option group text displayed to the user.
+     * - `disabled` (boolean) - (Optional) Determines whether the option group is disabled.
+     * - `options` (Option[]) - (Optional) The options under this group.
+     *
+     * Note: Only one level of option nesting is supported.
+     *
+     * If you want to use the built-in filtering capabilities of this component, provide
+     * a list of all valid options here and they will be automatically filtered based on the user's filtering input.
+     *
+     * Alternatively, you can listen to the `onChange` or `onLoadItems` event and set new options
+     * on your own.
+     */
+    options: (OptionDefinition | OptionGroup)[];
+    /**
+     * Determines how filtering is applied to the list of `options`:
+     *
+     * - `auto` - The component will automatically filter options based on user input.
+     * - `manual` - You will set up `onMenuFilter` event listeners and filter options on your side or request
+     * them from server.
+     *
+     * By default the component will filter the provided `options` based on the value of the filtering input field.
+     * Only options that have a `value`, `label`, `description` or `labelTag` that contains the input value as a substring
+     * are displayed in the list of options.
+     *
+     * If you set this property to `manual`, this default filtering mechanism is disabled and all provided `options` are
+     * displayed in the menu. In that case make sure that you use the `onMenuFilter` event in order
+     * to set the `options` property to the options that are relevant for the user, given the filtering input value.
+     *
+     * Note: Manual filtering doesn't disable match highlighting.
+     **/
+    filteringType?: Exclude<OptionsFilteringType, 'none'>;
+  }
   interface Ref {
     /**
      * Sets input focus on the textarea control.
@@ -130,6 +467,18 @@ export declare namespace PromptInputProps {
      * common pitfalls: https://stackoverflow.com/questions/60129605/is-javascripts-setselectionrange-incompatible-with-react-hooks
      */
     setSelectionRange(start: number | null, end: number | null, direction?: 'forward' | 'backward' | 'none'): void;
+    /**
+     * Inserts text at a specified position. Only supported when `tokens` is defined.
+     * Triggers input events and menu detection.
+     *
+     * When pinned reference tokens are present, `caretStart` and `caretEnd` are automatically
+     * shifted to account for their positions.
+     *
+     * @param text The text to insert.
+     * @param caretStart Position to insert at. Defaults to current caret position or 0.
+     * @param caretEnd Caret position after insertion. Defaults to end of inserted text.
+     */
+    insertText(text: string, caretStart?: number, caretEnd?: number): void;
   }
   interface Style {
     root?: {

package/prompt-input/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/prompt-input/interfaces.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/prompt-input/interfaces.ts"],"names":[],"mappings":"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"}

package/prompt-input/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/prompt-input/interfaces.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { IconProps } from '../icon/interfaces';\nimport {\n  BaseChangeDetail,\n  BaseInputProps,\n  InputAutoComplete,\n  InputAutoCorrect,\n  InputKeyEvents,\n  InputSpellcheck,\n} from '../input/interfaces';\nimport { BaseComponentProps } from '../internal/base-component';\nimport { FormFieldValidationControlProps } from '../internal/context/form-field-context';\nimport { BaseKeyDetail, NonCancelableEventHandler } from '../internal/events';\n/**\n * @awsuiSystem core\n */\nimport { NativeAttributes } from '../internal/utils/with-native-attributes';\n\nexport interface PromptInputProps\n  extends Omit<BaseInputProps, 'nativeInputAttributes'>,\n    InputKeyEvents,\n    InputAutoCorrect,\n    InputAutoComplete,\n    InputSpellcheck,\n    BaseComponentProps,\n    FormFieldValidationControlProps {\n  /**\n   * Called whenever a user clicks the action button or presses the \"Enter\" key.\n   * The event `detail` contains the current value of the field.\n   */\n  onAction?: NonCancelableEventHandler<PromptInputProps.ActionDetail>;\n  /**\n   * Determines what icon to display in the action button.\n   */\n  actionButtonIconName?: IconProps.Name;\n  /**\n   * Specifies the URL of a custom icon. Use this property if the icon you want isn't available.\n   *\n   * If you set both `actionButtonIconUrl` and `actionButtonIconSvg`, `actionButtonIconSvg` will take precedence.\n   */\n  actionButtonIconUrl?: string;\n  /**\n   * Specifies the SVG of a custom icon.\n   *\n   * Use this property if you want your custom icon to inherit colors dictated by variant or hover states.\n   * When this property is set, the component will be decorated with `aria-hidden=\"true\"`. Ensure that the `svg` element:\n   * - has attribute `focusable=\"false\"`.\n   * - has `viewBox=\"0 0 16 16\"`.\n   *\n   * If you set the `svg` element as the root node of the slot, the component will automatically\n   * - set `stroke=\"currentColor\"`, `fill=\"none\"`, and `vertical-align=\"top\"`.\n   * - set the stroke width based on the size of the icon.\n   * - set the width and height of the SVG element based on the size of the icon.\n   *\n   * If you don't want these styles to be automatically set, wrap the `svg` element into a `span`.\n   * You can still set the stroke to `currentColor` to inherit the color of the surrounding elements.\n   *\n   * If you set both `actionButtonIconUrl` and `actionButtonIconSvg`, `iconSvg` will take precedence.\n   *\n   * *Note:* Remember to remove any additional elements (for example: `defs`) and related CSS classes from SVG files exported from design software.\n   * In most cases, they aren't needed, as the `svg` element inherits styles from the icon component.\n   */\n  actionButtonIconSvg?: React.ReactNode;\n  /**\n   * Specifies alternate text for a custom icon. We recommend that you provide this for accessibility.\n   * This property is ignored if you use a predefined icon or if you set your custom icon using the `iconSvg` slot.\n   */\n  actionButtonIconAlt?: string;\n  /**\n   * Adds an aria-label to the action button.\n   * @i18n\n   */\n  actionButtonAriaLabel?: string;\n\n  /**\n   * Specifies whether to disable the action button.\n   */\n  disableActionButton?: boolean;\n\n  /**\n   * Specifies the minimum number of lines of text to set the height to.\n   */\n  minRows?: number;\n\n  /**\n   * Specifies the maximum number of lines of text the textarea will expand to.\n   * Defaults to 3. Use -1 for infinite rows.\n   */\n  maxRows?: number;\n\n  /**\n   * Use this to replace the primary action.\n   * If this is provided then any other `actionButton*` properties will be ignored.\n   * Note that you should still provide an `onAction` function in order to handle keyboard submission.\n   *\n   * @awsuiSystem core\n   */\n  customPrimaryAction?: React.ReactNode;\n\n  /**\n   * Use this slot to add secondary actions to the prompt input.\n   */\n  secondaryActions?: React.ReactNode;\n\n  /**\n   * Use this slot to add secondary content, such as file attachments, to the prompt input.\n   */\n  secondaryContent?: React.ReactNode;\n\n  /**\n   * Determines whether the secondary actions area of the input has padding. If true, removes the default padding from the secondary actions area.\n   */\n  disableSecondaryActionsPaddings?: boolean;\n\n  /**\n   * Determines whether the secondary content area of the input has padding. If true, removes the default padding from the secondary content area.\n   */\n  disableSecondaryContentPaddings?: boolean;\n\n  /**\n   * Attributes to add to the native `textarea` element.\n   * Some attributes will be automatically combined with internal attribute values:\n   * - `className` will be appended.\n   * - Event handlers will be chained, unless the default is prevented.\n   *\n   * We do not support using this attribute to apply custom styling.\n   *\n   * @awsuiSystem core\n   */\n  nativeTextareaAttributes?: NativeAttributes<React.TextareaHTMLAttributes<HTMLTextAreaElement>>;\n\n  /**\n   * An object containing CSS properties to customize the prompt input's visual appearance.\n   * Refer to the [style](/components/prompt-input/?tabId=style) tab for more details.\n   * @awsuiSystem core\n   */\n  style?: PromptInputProps.Style;\n}\n\nexport namespace PromptInputProps {\n  export type KeyDetail = BaseKeyDetail;\n  export type ActionDetail = BaseChangeDetail;\n\n  export interface Ref {\n    /**\n     * Sets input focus on the textarea control.\n     */\n    focus(): void;\n\n    /**\n     * Selects all text in the textarea control.\n     */\n    select(): void;\n\n    /**\n     * Selects a range of text in the textarea control.\n     *\n     * See https://developer.mozilla.org/en-US/docs/Web/API/HTMLTextAreaElement/setSelectionRange\n     * for more details on this method. Be aware that using this method in React has some\n     * common pitfalls: https://stackoverflow.com/questions/60129605/is-javascripts-setselectionrange-incompatible-with-react-hooks\n     */\n    setSelectionRange(start: number | null, end: number | null, direction?: 'forward' | 'backward' | 'none'): void;\n  }\n\n  export interface Style {\n    root?: {\n      backgroundColor?: {\n        default?: string;\n        disabled?: string;\n        focus?: string;\n        hover?: string;\n        readonly?: string;\n      };\n      borderColor?: {\n        default?: string;\n        disabled?: string;\n        focus?: string;\n        hover?: string;\n        readonly?: string;\n      };\n      borderRadius?: string;\n      borderWidth?: string;\n      boxShadow?: {\n        default?: string;\n        disabled?: string;\n        focus?: string;\n        hover?: string;\n        readonly?: string;\n      };\n      color?: {\n        default?: string;\n        disabled?: string;\n        focus?: string;\n        hover?: string;\n        readonly?: string;\n      };\n      fontSize?: string;\n      fontWeight?: string;\n      paddingBlock?: string;\n      paddingInline?: string;\n    };\n    placeholder?: {\n      color?: string;\n      fontSize?: string;\n      fontStyle?: string;\n      fontWeight?: string;\n    };\n  }\n}\n"]}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/prompt-input/interfaces.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport React from 'react';\n\nimport { BaseDropdownHostProps, OptionsFilteringType } from '../dropdown/interfaces';\nimport { IconProps } from '../icon/interfaces';\nimport { BaseInputProps, InputAutoCorrect, InputKeyEvents, InputSpellcheck } from '../input/interfaces';\nimport { BaseComponentProps } from '../internal/base-component';\nimport { DropdownStatusProps } from '../internal/components/dropdown-status';\nimport { OptionDefinition, OptionGroup } from '../internal/components/option/interfaces';\nimport { FormFieldValidationControlProps } from '../internal/context/form-field-context';\nimport { BaseKeyDetail, CancelableEventHandler, NonCancelableEventHandler } from '../internal/events';\n/**\n * @awsuiSystem core\n */\nimport { NativeAttributes } from '../internal/utils/with-native-attributes';\n\nexport interface PromptInputProps\n  extends Omit<BaseInputProps, 'nativeInputAttributes' | 'name' | 'value' | 'onChange'>,\n    InputKeyEvents,\n    InputAutoCorrect,\n    InputSpellcheck,\n    BaseComponentProps,\n    FormFieldValidationControlProps {\n  /**\n   * Specifies the name of the prompt input for form submissions.\n   */\n  name?: string;\n\n  /**\n   * Specifies whether to enable a browser's autocomplete functionality for this input.\n   * In some cases it might be appropriate to disable autocomplete (for example, for security-sensitive fields).\n   * To use it correctly, set the `name` property.\n   *\n   * You can either provide a boolean value to set the property to \"on\" or \"off\", or specify a string value\n   * for the [autocomplete](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete) attribute.\n   *\n   * Note: When `tokens` is defined, autocomplete will not function.\n   */\n  autoComplete?: boolean | string;\n\n  /**\n   * Specifies the content of the prompt input.\n   *\n   * When `tokens` is not defined:\n   * - This property is required\n   * - Represents the current text content of the textarea\n   *\n   * When `tokens` is defined:\n   * - This property is optional and defaults to empty string\n   * - The actual content is managed via the `tokens` array\n   */\n  value?: string;\n\n  /**\n   * Specifies the content of the prompt input when using token mode.\n   *\n   * Available types and their properties:\n   * - Text tokens:\n   *   - `value` contains the text content.\n   * - Reference tokens:\n   *   - `id` as the unique identifier, this is auto-generated however when setting `tokens` it is required to provide an ID.\n   *   - `value` contains the reference value.\n   *   - `label` for display (e.g., 'file.txt').\n   *   - `menuId` for the associated menu (optional).\n   *   - `pinned` to render at the start of the input.\n   * - Trigger tokens:\n   *   - `id` as the unique identifier, this is auto-generated however when setting `tokens` it is required to provide an ID.\n   *   - `value` contains the filter text.\n   *   - `triggerChar` for the trigger character.\n   *\n   * When `menus` is defined, you should use `tokens` to control the content instead of `value`.\n   *\n   * Requires React 18.\n   */\n  tokens?: readonly PromptInputProps.InputToken[];\n\n  /**\n   * Custom function to transform tokens into plain text for the `value` field in `onChange` and `onAction` events\n   * and for the hidden input when `name` is specified.\n   *\n   * If not provided, falls back to a default simple implementation.\n   *\n   * Use this to customize serialization, for example:\n   * - Using `label` instead of `value` for reference tokens\n   * - Adding custom formatting or separators between tokens\n   *\n   * Requires React 18.\n   */\n  tokensToText?: (tokens: readonly PromptInputProps.InputToken[]) => string;\n\n  /**\n   * Called whenever a user changes the input value (by typing or pasting).\n   * The event `detail` contains the current value as a string and an array of tokens.\n   *\n   * When `tokens` is defined, the `value` is derived from `tokensToText(tokens)` if provided, otherwise from a default simple implementation.\n   */\n  onChange?: NonCancelableEventHandler<PromptInputProps.ChangeDetail>;\n\n  /**\n   * Called whenever a user clicks the action button or presses the \"Enter\" key.\n   * The event `detail` contains the current value as a string and an array of tokens.\n   *\n   * When `tokens` is defined, the `value` is derived from `tokensToText(tokens)` if provided, otherwise from a default simple implementation.\n   */\n  onAction?: NonCancelableEventHandler<PromptInputProps.ActionDetail>;\n\n  /**\n   * Determines what icon to display in the action button.\n   */\n  actionButtonIconName?: IconProps.Name;\n\n  /**\n   * Specifies the URL of a custom icon. Use this property if the icon you want isn't available.\n   *\n   * If you set both `actionButtonIconUrl` and `actionButtonIconSvg`, `actionButtonIconSvg` will take precedence.\n   */\n  actionButtonIconUrl?: string;\n\n  /**\n   * Specifies the SVG of a custom icon.\n   *\n   * Use this property if you want your custom icon to inherit colors dictated by variant or hover states.\n   * When this property is set, the component will be decorated with `aria-hidden=\"true\"`. Ensure that the `svg` element:\n   * - has attribute `focusable=\"false\"`.\n   * - has `viewBox=\"0 0 16 16\"`.\n   *\n   * If you set the `svg` element as the root node of the slot, the component will automatically\n   * - set `stroke=\"currentColor\"`, `fill=\"none\"`, and `vertical-align=\"top\"`.\n   * - set the stroke width based on the size of the icon.\n   * - set the width and height of the SVG element based on the size of the icon.\n   *\n   * If you don't want these styles to be automatically set, wrap the `svg` element into a `span`.\n   * You can still set the stroke to `currentColor` to inherit the color of the surrounding elements.\n   *\n   * If you set both `actionButtonIconUrl` and `actionButtonIconSvg`, `iconSvg` will take precedence.\n   *\n   * *Note:* Remember to remove any additional elements (for example: `defs`) and related CSS classes from SVG files exported from design software.\n   * In most cases, they aren't needed, as the `svg` element inherits styles from the icon component.\n   */\n  actionButtonIconSvg?: React.ReactNode;\n\n  /**\n   * Specifies alternate text for a custom icon. We recommend that you provide this for accessibility.\n   * This property is ignored if you use a predefined icon or if you set your custom icon using the `iconSvg` slot.\n   */\n  actionButtonIconAlt?: string;\n\n  /**\n   * Adds an aria-label to the action button.\n   * @i18n\n   * @deprecated Use `i18nStrings.actionButtonAriaLabel` instead.\n   */\n  actionButtonAriaLabel?: string;\n\n  /**\n   * Specifies whether to disable the action button.\n   */\n  disableActionButton?: boolean;\n\n  /**\n   * Specifies the minimum number of lines of text to set the height to.\n   */\n  minRows?: number;\n\n  /**\n   * Specifies the maximum number of lines of text the textarea will expand to.\n   * Defaults to 3. Use -1 for infinite rows.\n   */\n  maxRows?: number;\n\n  /**\n   * Use this to replace the primary action.\n   * If this is provided then any other `actionButton*` properties will be ignored.\n   * Note that you should still provide an `onAction` function in order to handle keyboard submission.\n   *\n   * @awsuiSystem core\n   */\n  customPrimaryAction?: React.ReactNode;\n\n  /**\n   * Use this slot to add secondary actions to the prompt input.\n   */\n  secondaryActions?: React.ReactNode;\n\n  /**\n   * Use this slot to add secondary content, such as file attachments, to the prompt input.\n   */\n  secondaryContent?: React.ReactNode;\n\n  /**\n   * Determines whether the secondary actions area of the input has padding. If true, removes the default padding from the secondary actions area.\n   */\n  disableSecondaryActionsPaddings?: boolean;\n\n  /**\n   * Determines whether the secondary content area of the input has padding. If true, removes the default padding from the secondary content area.\n   */\n  disableSecondaryContentPaddings?: boolean;\n\n  /**\n   * Defines trigger-based menus that appear when the user types a specific character (e.g., `@` or `/`).\n   * Each menu definition maps a trigger character to a list of selectable options.\n   *\n   * Requires React 18.\n   *\n   * #### MenuDefinition\n   * - `id` (string) - Unique identifier for this menu. Used in event callbacks to identify the menu.\n   * - `trigger` (string) - The character that activates this menu (e.g., `@`, `/`, `#`).\n   * - `options` (Option[] | OptionGroup[]) - The selectable items shown in the dropdown.\n   * - `useAtStart` (boolean) - (Optional) When true, the trigger is only detected at the start of the input and after any pinned tokens. Selected options become pinned reference tokens. Defaults to false.\n   * - `filteringType` (`'auto'` | `'manual'`) - (Optional) How filtering is applied. `auto` filters options client-side based on typed text. `manual` disables built-in filtering — use `onMenuFilter` to provide filtered options. Defaults to `auto`.\n   * - `statusType` (`'pending'` | `'loading'` | `'finished'` | `'error'`) - (Optional) The loading status of the menu options. Use with `onMenuLoadItems` for async loading.\n   * - `empty` (string) - (Optional) Text shown when no options match the filter.\n   * - `virtualScroll` (boolean) - (Optional) Enables virtual scrolling for large option lists.\n   */\n  menus?: PromptInputProps.MenuDefinition[];\n\n  /**\n   * Maximum height of the menu dropdown in pixels.\n   * When not specified, the menu will grow to fit its content.\n   *\n   * Requires React 18.\n   */\n  maxMenuHeight?: number;\n\n  /**\n   * Called whenever a user selects an option in a menu.\n   *\n   * Requires React 18.\n   */\n  onMenuItemSelect?: NonCancelableEventHandler<PromptInputProps.MenuItemSelectDetail>;\n\n  /**\n   * Use this event to implement the asynchronous behavior for menus.\n   *\n   * The event is called in the following situations:\n   * - The user scrolls to the end of the list of options, if `statusType` is set to `pending` (pagination).\n   * - The user clicks on the recovery button in the error state.\n   * - The user types after the trigger character.\n   * - The menu is opened.\n   *\n   * The detail object contains the following properties:\n   * - `menuId` - The ID of the menu that triggered the event.\n   * - `filteringText` - The value to use to fetch options (undefined for pagination).\n   * - `firstPage` - Indicates that you should fetch the first page of options.\n   * - `samePage` - Indicates that you should fetch the same page (for example, when clicking recovery button).\n   *\n   * Requires React 18.\n   */\n  onMenuLoadItems?: NonCancelableEventHandler<PromptInputProps.MenuLoadItemsDetail>;\n\n  /**\n   * Called when the user types to filter options in manual filtering mode for a menu.\n   * Use this to filter the options based on the filtering text.\n   *\n   * The detail object contains:\n   * - `menuId` - The ID of the menu that triggered the event.\n   * - `filteringText` - The text to use for filtering options.\n   *\n   * Requires React 18.\n   */\n  onMenuFilter?: NonCancelableEventHandler<PromptInputProps.MenuFilterDetail>;\n\n  /**\n   * Called when a trigger character is detected and about to be converted to a trigger token.\n   * This event is cancellable - return `preventDefault()` to prevent the trigger from being created.\n   *\n   * The detail object contains:\n   * - `menuId` - The ID of the menu associated with the trigger.\n   * - `triggerChar` - The trigger character that was detected.\n   * - `position` - The position in the text where the trigger was detected.\n   *\n   * Use this to implement custom validation logic for triggers, such as preventing\n   * triggers that don't meet certain conditions (for example, limiting the amount of references in a prompt).\n   *\n   * Requires React 18.\n   */\n  onTriggerDetected?: CancelableEventHandler<PromptInputProps.TriggerDetectedDetail>;\n\n  /**\n   * An object containing all the localized strings required by the component.\n   *\n   * - `ariaLabel` (string) - Adds an aria-label to the input element.\n   * - `actionButtonAriaLabel` (string) - Adds an aria-label to the action button.\n   * - `menuErrorIconAriaLabel` (string) - Provides a text alternative for the error icon in the error message in menus.\n   * - `menuRecoveryText` (string) - Specifies the text for the recovery button in menus. The text is displayed next to the error text.\n   * - `menuLoadingText` (string) - Specifies the text to display when menus are in a loading state.\n   * - `menuFinishedText` (string) - Specifies the text to display when menus have finished loading all items.\n   * - `menuErrorText` (string) - Specifies the text to display when menus encounter an error while loading.\n   * - `selectedMenuItemAriaLabel` (string) - Specifies the string that describes an option as being selected.\n   * - `tokenInsertedAriaLabel` ((token: { label?: string; value: string }) => string) - Aria label announced when a reference token is inserted from a menu. Receives the token object with label and value properties.\n   * - `tokenPinnedAriaLabel` ((token: { label?: string; value: string }) => string) - Aria label announced when a reference token is pinned (inserted at the start). Receives the token object with label and value properties.\n   * - `tokenRemovedAriaLabel` ((token: { label?: string; value: string }) => string) - Aria label announced when a reference token is removed. Receives the token object with label and value properties.\n   * @i18n\n   */\n  i18nStrings?: PromptInputProps.I18nStrings;\n\n  /**\n   * Attributes to add to the native `textarea` element.\n   * Some attributes will be automatically combined with internal attribute values:\n   * - `className` will be appended.\n   * - Event handlers will be chained, unless the default is prevented.\n   *\n   * We do not support using this attribute to apply custom styling.\n   * When `tokens` is defined, nativeTextareaAttributes will be ignored.\n   *\n   * @awsuiSystem core\n   */\n  nativeTextareaAttributes?: NativeAttributes<React.TextareaHTMLAttributes<HTMLTextAreaElement>>;\n\n  /**\n   * @awsuiSystem core\n   */\n  style?: PromptInputProps.Style;\n}\n\nexport namespace PromptInputProps {\n  export type KeyDetail = BaseKeyDetail;\n\n  export interface I18nStrings {\n    actionButtonAriaLabel?: string;\n    menuErrorIconAriaLabel?: string;\n    menuRecoveryText?: string;\n    menuLoadingText?: string;\n    menuFinishedText?: string;\n    menuErrorText?: string;\n    /**\n     * Aria label announced when a reference token is inserted from a menu.\n     * Receives the token object with label and value properties.\n     * @param token The inserted token\n     * @returns The announcement string\n     * @default `${token.label || token.value} inserted`\n     */\n    tokenInsertedAriaLabel?: (token: { label?: string; value: string }) => string;\n    /**\n     * Aria label announced when a reference token is pinned (inserted at the start).\n     * Receives the token object with label and value properties.\n     * @param token The pinned token\n     * @returns The announcement string\n     * @default `${token.label || token.value} pinned`\n     */\n    tokenPinnedAriaLabel?: (token: { label?: string; value: string }) => string;\n    /**\n     * Aria label announced when a reference token is removed.\n     * Receives the token object with label and value properties.\n     * @param token The removed token\n     * @returns The announcement string\n     * @default `${token.label || token.value} removed`\n     */\n    tokenRemovedAriaLabel?: (token: { label?: string; value: string }) => string;\n  }\n\n  export interface TextToken {\n    type: 'text' | 'break';\n    value: string;\n  }\n\n  export interface ReferenceToken {\n    type: 'reference';\n    id: string;\n    label: string;\n    value: string;\n    /**\n     * The ID of the menu this reference was selected from.\n     * Optional — references can exist without being bound to a menu\n     * (e.g., preloaded references from external sources).\n     */\n    menuId?: string;\n    /**\n     * When true, prevents user entered text from being placed before this token.\n     * Typically set for reference tokens from useAtStart menus.\n     */\n    pinned?: boolean;\n  }\n\n  /**\n   * Token type for menu triggers with filter text.\n   * Represents a trigger character (e.g., \"@\" or \"/\") followed by filtering text.\n   * This token type is automatically managed by the component when menus are active.\n   *\n   * - `value`: The filtering text (without the trigger character)\n   * - `triggerChar`: The trigger character that opened the menu\n   */\n  export interface TriggerToken {\n    type: 'trigger';\n    value: string;\n    triggerChar: string;\n    id: string;\n  }\n\n  export type InputToken = TextToken | ReferenceToken | TriggerToken;\n\n  export interface ChangeDetail {\n    value: string;\n    tokens?: readonly InputToken[];\n  }\n\n  export interface ActionDetail {\n    value: string;\n    tokens?: readonly InputToken[];\n  }\n\n  export interface MenuItemSelectDetail {\n    menuId: string;\n    option: OptionDefinition;\n  }\n\n  export interface MenuLoadItemsDetail {\n    menuId: string;\n    filteringText?: string;\n    firstPage: boolean;\n    samePage: boolean;\n  }\n\n  export interface MenuFilterDetail {\n    menuId: string;\n    filteringText: string;\n  }\n\n  export interface TriggerDetectedDetail {\n    menuId: string;\n    triggerChar: string;\n    position: number;\n  }\n\n  export interface MenuDefinition\n    extends Pick<DropdownStatusProps, 'empty' | 'statusType'>,\n      Pick<BaseDropdownHostProps, 'virtualScroll'> {\n    /**\n     * The unique identifier for this menu.\n     */\n    id: string;\n\n    /**\n     * The unique trigger symbol for showing this menu.\n     */\n    trigger: string;\n\n    /**\n     * Set `useAtStart=true` for menus where a trigger should only be detected at the start of input.\n     * Set this for menus designated to modes or actions.\n     *\n     * Menus with `useAtStart=true` create pinned reference tokens.\n     */\n    useAtStart?: boolean;\n\n    /**\n     * Specifies an array of options that are displayed to the user as a list.\n     * The options can be grouped using `OptionGroup` objects.\n     *\n     * #### Option\n     * - `value` (string) - The returned value of the option when selected.\n     * - `label` (string) - (Optional) Option text displayed to the user.\n     * - `lang` (string) - (Optional) The language of the option, provided as a BCP 47 language tag.\n     * - `description` (string) - (Optional) Further information about the option that appears below the label.\n     * - `disabled` (boolean) - (Optional) Determines whether the option is disabled.\n     * - `labelTag` (string) - (Optional) A label tag that provides additional guidance, shown next to the label.\n     * - `tags` [string[]] - (Optional) A list of tags giving further guidance about the option.\n     * - `filteringTags` [string[]] - (Optional) A list of additional tags used for automatic filtering.\n     * - `iconName` (string) - (Optional) Specifies the name of an [icon](/components/icon/) to display in the option.\n     * - `iconAriaLabel` (string) - (Optional) Specifies alternate text for the icon. We recommend that you provide this for accessibility.\n     * - `iconAlt` (string) - (Optional) **Deprecated**, replaced by \\`iconAriaLabel\\`. Specifies alternate text for a custom icon, for use with `iconUrl`.\n     * - `iconUrl` (string) - (Optional) URL of a custom icon.\n     * - `iconSvg` (ReactNode) - (Optional) Custom SVG icon. Equivalent to the `svg` slot of the [icon component](/components/icon/).\n     *\n     * #### OptionGroup\n     * - `label` (string) - Option group text displayed to the user.\n     * - `disabled` (boolean) - (Optional) Determines whether the option group is disabled.\n     * - `options` (Option[]) - (Optional) The options under this group.\n     *\n     * Note: Only one level of option nesting is supported.\n     *\n     * If you want to use the built-in filtering capabilities of this component, provide\n     * a list of all valid options here and they will be automatically filtered based on the user's filtering input.\n     *\n     * Alternatively, you can listen to the `onChange` or `onLoadItems` event and set new options\n     * on your own.\n     */\n    options: (OptionDefinition | OptionGroup)[];\n\n    /**\n     * Determines how filtering is applied to the list of `options`:\n     *\n     * - `auto` - The component will automatically filter options based on user input.\n     * - `manual` - You will set up `onMenuFilter` event listeners and filter options on your side or request\n     * them from server.\n     *\n     * By default the component will filter the provided `options` based on the value of the filtering input field.\n     * Only options that have a `value`, `label`, `description` or `labelTag` that contains the input value as a substring\n     * are displayed in the list of options.\n     *\n     * If you set this property to `manual`, this default filtering mechanism is disabled and all provided `options` are\n     * displayed in the menu. In that case make sure that you use the `onMenuFilter` event in order\n     * to set the `options` property to the options that are relevant for the user, given the filtering input value.\n     *\n     * Note: Manual filtering doesn't disable match highlighting.\n     **/\n    filteringType?: Exclude<OptionsFilteringType, 'none'>;\n  }\n\n  export interface Ref {\n    /**\n     * Sets input focus on the textarea control.\n     */\n    focus(): void;\n\n    /**\n     * Selects all text in the textarea control.\n     */\n    select(): void;\n\n    /**\n     * Selects a range of text in the textarea control.\n     *\n     * See https://developer.mozilla.org/en-US/docs/Web/API/HTMLTextAreaElement/setSelectionRange\n     * for more details on this method. Be aware that using this method in React has some\n     * common pitfalls: https://stackoverflow.com/questions/60129605/is-javascripts-setselectionrange-incompatible-with-react-hooks\n     */\n    setSelectionRange(start: number | null, end: number | null, direction?: 'forward' | 'backward' | 'none'): void;\n\n    /**\n     * Inserts text at a specified position. Only supported when `tokens` is defined.\n     * Triggers input events and menu detection.\n     *\n     * When pinned reference tokens are present, `caretStart` and `caretEnd` are automatically\n     * shifted to account for their positions.\n     *\n     * @param text The text to insert.\n     * @param caretStart Position to insert at. Defaults to current caret position or 0.\n     * @param caretEnd Caret position after insertion. Defaults to end of inserted text.\n     */\n    insertText(text: string, caretStart?: number, caretEnd?: number): void;\n  }\n\n  export interface Style {\n    root?: {\n      backgroundColor?: {\n        default?: string;\n        disabled?: string;\n        focus?: string;\n        hover?: string;\n        readonly?: string;\n      };\n      borderColor?: {\n        default?: string;\n        disabled?: string;\n        focus?: string;\n        hover?: string;\n        readonly?: string;\n      };\n      borderRadius?: string;\n      borderWidth?: string;\n      boxShadow?: {\n        default?: string;\n        disabled?: string;\n        focus?: string;\n        hover?: string;\n        readonly?: string;\n      };\n      color?: {\n        default?: string;\n        disabled?: string;\n        focus?: string;\n        hover?: string;\n        readonly?: string;\n      };\n      fontSize?: string;\n      fontWeight?: string;\n      paddingBlock?: string;\n      paddingInline?: string;\n    };\n    placeholder?: {\n      color?: string;\n      fontSize?: string;\n      fontStyle?: string;\n      fontWeight?: string;\n    };\n  }\n}\n"]}

package/prompt-input/internal.d.ts

@@ -3,5 +3,5 @@ import { InternalBaseComponentProps } from '../internal/hooks/use-base-component
 import { SomeRequired } from '../internal/types';
 import { PromptInputProps } from './interfaces';
 interface InternalPromptInputProps extends SomeRequired<PromptInputProps, 'maxRows' | 'minRows'>, InternalBaseComponentProps {}
-declare const InternalPromptInput: React.ForwardRefExoticComponent<InternalPromptInputProps & React.RefAttributes<PromptInputProps.Ref>>;
+declare const InternalPromptInput: React.ForwardRefExoticComponent<InternalPromptInputProps & React.RefAttributes<HTMLInputElement | HTMLTextAreaElement | PromptInputProps.Ref>>;
 export default InternalPromptInput;

package/prompt-input/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../src/prompt-input/internal.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmE,MAAM,OAAO,CAAC;AAWxF,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAMhD,UAAU,wBACR,SAAQ,YAAY,CAAC,gBAAgB,EAAE,SAAS,GAAG,SAAS,CAAC,EAC3D,0BAA0B;CAAG;AAEjC,QAAA,MAAM,mBAAmB,uGAuOxB,CAAC;AAEF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../src/prompt-input/internal.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsD,MAAM,OAAO,CAAC;AAY3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAGlF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAQhD,UAAU,wBACR,SAAQ,YAAY,CAAC,gBAAgB,EAAE,SAAS,GAAG,SAAS,CAAC,EAC3D,0BAA0B;CAAG;AAEjC,QAAA,MAAM,mBAAmB,gJA6axB,CAAC;AAEF,eAAe,mBAAmB,CAAC"}