@cloudscape-design/components 3.0.1270 → 3.0.1271

package/prompt-input/tokens/use-token-mode.d.ts

@@ -0,0 +1,78 @@
+import React from 'react';
+import { useDropdownStatus } from '../../internal/components/dropdown-status';
+import { CaretController } from '../core/caret-controller';
+import { MenuItemsHandlers, MenuItemsState } from '../core/menu-state';
+import { PortalContainer } from '../core/token-renderer';
+import { PromptInputProps } from '../interfaces';
+/** Mutable state shared between the editable tokens hook and event handlers. */
+export interface EditableState {
+  skipNextZeroWidthUpdate: boolean;
+  menuSelectionTokenId: string | null;
+}
+export declare function createEditableState(): EditableState;
+/** Configuration for the useTokenMode hook — all props needed to drive token-mode behavior. */
+export interface UseTokenModeConfig {
+  editableElementRef: React.RefObject<HTMLDivElement>;
+  caretControllerRef: React.MutableRefObject<CaretController | null>;
+  tokens?: readonly PromptInputProps.InputToken[];
+  tokensToText?: (tokens: readonly PromptInputProps.InputToken[]) => string;
+  menus?: readonly PromptInputProps.MenuDefinition[];
+  disabled?: boolean;
+  readOnly?: boolean;
+  autoFocus?: boolean;
+  placeholder?: string;
+  invalid?: boolean;
+  warning?: boolean;
+  ariaLabel?: string;
+  ariaLabelledby?: string;
+  ariaDescribedby?: string;
+  ariaRequired?: boolean;
+  disableBrowserAutocorrect?: boolean;
+  spellcheck?: boolean;
+  onChange: (detail: {
+    value: string;
+    tokens: PromptInputProps.InputToken[];
+  }) => void;
+  onTriggerDetected?: (detail: PromptInputProps.TriggerDetectedDetail) => boolean;
+  onAction?: PromptInputProps['onAction'];
+  onBlur?: PromptInputProps['onBlur'];
+  onFocus?: PromptInputProps['onFocus'];
+  onKeyDown?: PromptInputProps['onKeyDown'];
+  onKeyUp?: PromptInputProps['onKeyUp'];
+  onMenuItemSelect?: PromptInputProps['onMenuItemSelect'];
+  onMenuFilter?: PromptInputProps['onMenuFilter'];
+  onMenuLoadItems?: PromptInputProps['onMenuLoadItems'];
+  i18nStrings?: PromptInputProps['i18nStrings'];
+  adjustInputHeight: () => void;
+}
+/** Return value of useTokenMode — state, handlers, and attributes consumed by TokenMode component. */
+export interface UseTokenModeResult {
+  portalContainersRef: React.MutableRefObject<Map<string, PortalContainer>>;
+  /** Snapshot of portal containers for rendering portals. Updated after each renderTokensToDOM call. */
+  portalContainers: PortalContainer[];
+  /** Portal elements to render — renders Token components into DOM containers via createPortal. */
+  portals: React.ReactPortal[];
+  editableState: EditableState;
+  editableElementAttributes: React.HTMLAttributes<HTMLDivElement> & {
+    'data-placeholder'?: string;
+  };
+  activeTriggerToken: PromptInputProps.TriggerToken | null;
+  activeMenu: PromptInputProps.MenuDefinition | null;
+  menuIsOpen: boolean;
+  menuFilterText: string;
+  triggerWrapperRef: React.MutableRefObject<HTMLElement | null>;
+  triggerWrapperReady: boolean;
+  menuListId: string;
+  menuFooterControlId: string;
+  highlightedMenuOptionId: string | undefined;
+  menuItemsState: MenuItemsState;
+  menuItemsHandlers: MenuItemsHandlers;
+  menuDropdownStatus: ReturnType<typeof useDropdownStatus> | null;
+  shouldRenderMenuDropdown: boolean;
+  handleInput: () => void;
+  handleLoadMore: () => void;
+  tokenOperationAnnouncement: string;
+  markTokensAsSent: (tokens: readonly PromptInputProps.InputToken[]) => void;
+}
+/** Encapsulates all token-mode logic: trigger detection, menu state, keyboard handling, and rendering. */
+export declare function useTokenMode(config: UseTokenModeConfig): UseTokenModeResult;

package/prompt-input/tokens/use-token-mode.d.ts.map

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