@cloudscape-design/components 3.0.1270 → 3.0.1272

package/prompt-input/core/token-operations.js

@@ -0,0 +1,273 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { isHTMLElement } from '../../internal/utils/dom';
+import { ElementType, SPECIAL_CHARS } from './constants';
+import { findAllParagraphs, findElement, generateTokenId, getTokenType, hasOnlyTrailingBR, isReferenceElementType, stripZeroWidthCharacters, } from './dom-utils';
+import { detectTriggersInText, mergeConsecutiveTextTokens } from './token-utils';
+import { isBreakTextToken, isPinnedReferenceToken, isReferenceToken, isTextNode, isTextToken, isTriggerToken, } from './type-guards';
+export function extractTokensFromDOM(element, menus, portalContainers) {
+    const paragraphs = findAllParagraphs(element);
+    if (paragraphs.length === 0) {
+        return [];
+    }
+    // Special case: single empty paragraph = empty input
+    if (paragraphs.length === 1) {
+        if (hasOnlyTrailingBR(paragraphs[0])) {
+            return [];
+        }
+    }
+    const allTokens = [];
+    paragraphs.forEach((p, pIndex) => {
+        const paragraphTokens = extractTokensFromParagraph(p, menus, portalContainers);
+        if (pIndex > 0) {
+            allTokens.push({ type: 'break', value: SPECIAL_CHARS.NEWLINE });
+        }
+        allTokens.push(...paragraphTokens);
+    });
+    return allTokens;
+}
+/** Extracts tokens from a single paragraph element by processing each child node. */
+function extractTokensFromParagraph(p, menus, portalContainers) {
+    const tokens = Array.from(p.childNodes).flatMap(node => extractTokensFromNode(node, menus, portalContainers));
+    return mergeConsecutiveTextTokens(tokens);
+}
+/** Converts a single DOM node into zero or more tokens. */
+function extractTokensFromNode(node, menus, portalContainers) {
+    if (isTextNode(node)) {
+        const text = stripZeroWidthCharacters(node.textContent || '');
+        return text ? [{ type: 'text', value: text }] : [];
+    }
+    if (!isHTMLElement(node)) {
+        return [];
+    }
+    if (node.tagName === 'BR') {
+        return [];
+    }
+    const tokenType = getTokenType(node);
+    if (tokenType === ElementType.Trigger) {
+        return extractTriggerTokens(node, menus);
+    }
+    if (isReferenceElementType(tokenType)) {
+        return extractReferenceToken(node, tokenType, portalContainers);
+    }
+    // Unknown element — recurse into children
+    return Array.from(node.childNodes).flatMap(child => extractTokensFromNode(child, menus, portalContainers));
+}
+/** Extracts trigger tokens from a trigger DOM element, handling nested triggers. */
+function extractTriggerTokens(node, menus = []) {
+    const tokens = [];
+    const id = node.id;
+    const fullText = node.textContent || '';
+    // Find the earliest trigger character in the text content
+    let triggerCharIndex = -1;
+    let triggerChar = '';
+    for (const menu of menus) {
+        const index = fullText.indexOf(menu.trigger);
+        if (index >= 0 && (triggerCharIndex === -1 || index < triggerCharIndex)) {
+            triggerCharIndex = index;
+            triggerChar = menu.trigger;
+        }
+    }
+    // Text before trigger character (corruption case)
+    if (triggerCharIndex > 0) {
+        tokens.push({ type: 'text', value: fullText.substring(0, triggerCharIndex) });
+    }
+    if (triggerCharIndex >= 0) {
+        const value = fullText.substring(triggerCharIndex + 1);
+        // Check for a nested trigger character in the filter text
+        let nestedTriggerIndex = -1;
+        let nestedTriggerChar = '';
+        for (const menu of menus) {
+            if (menu.useAtStart) {
+                continue;
+            }
+            const index = value.indexOf(menu.trigger);
+            if (index >= 0 && (nestedTriggerIndex === -1 || index < nestedTriggerIndex)) {
+                nestedTriggerIndex = index;
+                nestedTriggerChar = menu.trigger;
+            }
+        }
+        if (nestedTriggerIndex === 0) {
+            // Adjacent trigger characters — first trigger has empty filter, second is a new trigger
+            tokens.push({ type: 'trigger', value: '', triggerChar, id });
+            tokens.push({
+                type: 'trigger',
+                value: value.substring(1),
+                triggerChar: nestedTriggerChar,
+                id: generateTokenId(),
+            });
+        }
+        else if (nestedTriggerIndex > 0 && value[nestedTriggerIndex - 1].trim() === '') {
+            // Split into first trigger, whitespace, and second trigger
+            const firstValue = value.substring(0, nestedTriggerIndex).trim();
+            const spaceBefore = value.substring(firstValue.length, nestedTriggerIndex);
+            const secondValue = value.substring(nestedTriggerIndex + 1);
+            tokens.push({ type: 'trigger', value: firstValue, triggerChar, id });
+            if (spaceBefore) {
+                tokens.push({ type: 'text', value: spaceBefore });
+            }
+            tokens.push({ type: 'trigger', value: secondValue, triggerChar: nestedTriggerChar, id: generateTokenId() });
+        }
+        else {
+            tokens.push({ type: 'trigger', value, triggerChar, id });
+        }
+        // No trigger character found — treat as text
+    }
+    else if (fullText) {
+        tokens.push({ type: 'text', value: fullText });
+    }
+    return tokens;
+}
+/** Extracts reference and surrounding text tokens from a reference DOM element. */
+function extractReferenceToken(node, tokenType, portalContainers) {
+    const tokens = [];
+    // Text from cursor-spot-before
+    const cursorSpotBefore = findElement(node, { tokenType: ElementType.CaretSpotBefore });
+    if (cursorSpotBefore) {
+        const beforeText = stripZeroWidthCharacters(cursorSpotBefore.textContent || '');
+        if (beforeText) {
+            tokens.push({ type: 'text', value: beforeText });
+        }
+    }
+    const instanceId = node.id || '';
+    // Skip orphaned reference wrappers — deleteContents can remove internal
+    // elements while leaving the wrapper shell. A reference is orphaned if
+    // it has no portal container (source of truth for label/value).
+    const portalContainer = portalContainers === null || portalContainers === void 0 ? void 0 : portalContainers.get(instanceId);
+    if (!portalContainer) {
+        // Salvage any text from remaining caret-spots
+        const cursorSpotAfter = findElement(node, { tokenType: ElementType.CaretSpotAfter });
+        if (cursorSpotAfter) {
+            const afterText = stripZeroWidthCharacters(cursorSpotAfter.textContent || '');
+            if (afterText) {
+                tokens.push({ type: 'text', value: afterText });
+            }
+        }
+        return tokens;
+    }
+    const { value, label, menuId } = portalContainer;
+    const token = {
+        type: 'reference',
+        id: instanceId,
+        value,
+        label,
+        menuId,
+    };
+    if (tokenType === ElementType.Pinned) {
+        token.pinned = true;
+    }
+    tokens.push(token);
+    // Text from cursor-spot-after
+    const cursorSpotAfter = findElement(node, { tokenType: ElementType.CaretSpotAfter });
+    if (cursorSpotAfter) {
+        const afterText = stripZeroWidthCharacters(cursorSpotAfter.textContent || '');
+        if (afterText) {
+            tokens.push({ type: 'text', value: afterText });
+        }
+    }
+    return tokens;
+}
+/** Default plain text serialization for tokens. */
+export function getPromptText(tokens) {
+    let result = '';
+    let prevToken = null;
+    for (const token of tokens) {
+        if (isBreakTextToken(token)) {
+            result += '\n';
+            prevToken = token;
+            continue;
+        }
+        let segment;
+        if (isTriggerToken(token)) {
+            segment = token.triggerChar + token.value;
+        }
+        else if (isReferenceToken(token)) {
+            segment = token.label || token.value;
+        }
+        else {
+            segment = token.value;
+        }
+        if (segment.length === 0) {
+            continue;
+        }
+        // Insert a space between a reference and its neighbor when neither side has whitespace
+        const needsSpace = result.length > 0 &&
+            !result.endsWith(' ') &&
+            !result.endsWith('\n') &&
+            !segment.startsWith(' ') &&
+            (isReferenceToken(token) || (prevToken && isReferenceToken(prevToken)));
+        if (needsSpace) {
+            result += ' ';
+        }
+        result += segment;
+        prevToken = token;
+    }
+    return result;
+}
+export function findLastPinnedTokenIndex(tokens) {
+    for (let i = tokens.length - 1; i >= 0; i--) {
+        if (isPinnedReferenceToken(tokens[i])) {
+            return i;
+        }
+    }
+    return -1;
+}
+/** Scans text tokens for trigger characters and converts them to trigger tokens. */
+export function detectTriggersInTokens(tokens, menus, onTriggerDetected, cancelledIds) {
+    const result = [];
+    for (let i = 0; i < tokens.length; i++) {
+        const token = tokens[i];
+        // Skip cancelled triggers — don't re-parse their adjacent text
+        if (isTriggerToken(token) && (cancelledIds === null || cancelledIds === void 0 ? void 0 : cancelledIds.has(token.id))) {
+            result.push(token);
+            continue;
+        }
+        // Collapse empty trigger + adjacent text back into a text token for re-parsing.
+        // Don't fire onTriggerDetected — the trigger already exists.
+        if (isTriggerToken(token) && token.value === '' && i !== tokens.length - 1) {
+            const next = tokens[i + 1];
+            if (isTextToken(next) && next.value.length > 0 && !next.value.startsWith(' ')) {
+                const detected = detectTriggersInText(token.triggerChar + next.value, menus, result);
+                const reusedTrigger = detected.find(isTriggerToken);
+                if (reusedTrigger && token.id) {
+                    reusedTrigger.id = token.id;
+                }
+                result.push(...detected);
+                i++;
+                continue;
+            }
+        }
+        // Merge non-empty trigger + adjacent text when the separator was removed.
+        // Don't fire onTriggerDetected — the trigger already exists.
+        if (isTriggerToken(token) && token.value.length > 0 && i !== tokens.length - 1) {
+            const next = tokens[i + 1];
+            if (isTextToken(next) && next.value.length > 0 && !next.value.startsWith(' ')) {
+                const combined = token.triggerChar + token.value + next.value;
+                const detected = detectTriggersInText(combined, menus, result);
+                const reusedTrigger = detected.find(isTriggerToken);
+                if (reusedTrigger && token.id) {
+                    reusedTrigger.id = token.id;
+                }
+                result.push(...detected);
+                i++;
+                continue;
+            }
+        }
+        if (isTextToken(token)) {
+            result.push(...detectTriggersInText(token.value, menus, result, onTriggerDetected, cancelledIds));
+        }
+        else {
+            result.push(token);
+        }
+    }
+    return result;
+}
+export function processTokens(tokens, config, options, onTriggerDetected, existingCancelledIds) {
+    let result = [...tokens];
+    const cancelledIds = new Set(existingCancelledIds);
+    if (options.detectTriggers && config.menus) {
+        result = detectTriggersInTokens(result, config.menus, onTriggerDetected, cancelledIds);
+    }
+    return { tokens: result, cancelledIds };
+}
+//# sourceMappingURL=token-operations.js.map

package/prompt-input/core/token-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-operations.js","sourceRoot":"","sources":["../../../../src/prompt-input/core/token-operations.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { isHTMLElement } from '../../internal/utils/dom';\nimport type { PromptInputProps } from '../interfaces';\nimport { ElementType, SPECIAL_CHARS } from './constants';\nimport {\n  findAllParagraphs,\n  findElement,\n  generateTokenId,\n  getTokenType,\n  hasOnlyTrailingBR,\n  isReferenceElementType,\n  stripZeroWidthCharacters,\n} from './dom-utils';\nimport { PortalContainer } from './token-renderer';\nimport { detectTriggersInText, mergeConsecutiveTextTokens } from './token-utils';\nimport {\n  isBreakTextToken,\n  isPinnedReferenceToken,\n  isReferenceToken,\n  isTextNode,\n  isTextToken,\n  isTriggerToken,\n} from './type-guards';\n\nexport type UpdateSource = 'user-input' | 'external' | 'menu-selection' | 'internal';\n\nexport interface ShortcutsConfig {\n  menus?: readonly PromptInputProps.MenuDefinition[];\n  tokensToText?: (tokens: readonly PromptInputProps.InputToken[]) => string;\n}\n\nexport function extractTokensFromDOM(\n  element: HTMLElement,\n  menus?: readonly PromptInputProps.MenuDefinition[],\n  portalContainers?: Map<string, PortalContainer>\n): PromptInputProps.InputToken[] {\n  const paragraphs = findAllParagraphs(element);\n\n  if (paragraphs.length === 0) {\n    return [];\n  }\n\n  // Special case: single empty paragraph = empty input\n  if (paragraphs.length === 1) {\n    if (hasOnlyTrailingBR(paragraphs[0])) {\n      return [];\n    }\n  }\n\n  const allTokens: PromptInputProps.InputToken[] = [];\n\n  paragraphs.forEach((p, pIndex) => {\n    const paragraphTokens = extractTokensFromParagraph(p, menus, portalContainers);\n\n    if (pIndex > 0) {\n      allTokens.push({ type: 'break', value: SPECIAL_CHARS.NEWLINE });\n    }\n\n    allTokens.push(...paragraphTokens);\n  });\n\n  return allTokens;\n}\n\n/** Extracts tokens from a single paragraph element by processing each child node. */\nfunction extractTokensFromParagraph(\n  p: HTMLElement,\n  menus?: readonly PromptInputProps.MenuDefinition[],\n  portalContainers?: Map<string, PortalContainer>\n): PromptInputProps.InputToken[] {\n  const tokens = Array.from(p.childNodes).flatMap(node => extractTokensFromNode(node, menus, portalContainers));\n  return mergeConsecutiveTextTokens(tokens);\n}\n\n/** Converts a single DOM node into zero or more tokens. */\nfunction extractTokensFromNode(\n  node: Node,\n  menus?: readonly PromptInputProps.MenuDefinition[],\n  portalContainers?: Map<string, PortalContainer>\n): PromptInputProps.InputToken[] {\n  if (isTextNode(node)) {\n    const text = stripZeroWidthCharacters(node.textContent || '');\n    return text ? [{ type: 'text', value: text }] : [];\n  }\n\n  if (!isHTMLElement(node)) {\n    return [];\n  }\n\n  if (node.tagName === 'BR') {\n    return [];\n  }\n\n  const tokenType = getTokenType(node);\n\n  if (tokenType === ElementType.Trigger) {\n    return extractTriggerTokens(node, menus);\n  }\n\n  if (isReferenceElementType(tokenType)) {\n    return extractReferenceToken(node, tokenType, portalContainers);\n  }\n\n  // Unknown element — recurse into children\n  return Array.from(node.childNodes).flatMap(child => extractTokensFromNode(child, menus, portalContainers));\n}\n\n/** Extracts trigger tokens from a trigger DOM element, handling nested triggers. */\nfunction extractTriggerTokens(\n  node: HTMLElement,\n  menus: readonly PromptInputProps.MenuDefinition[] = []\n): PromptInputProps.InputToken[] {\n  const tokens: PromptInputProps.InputToken[] = [];\n  const id = node.id;\n  const fullText = node.textContent || '';\n\n  // Find the earliest trigger character in the text content\n  let triggerCharIndex = -1;\n  let triggerChar = '';\n\n  for (const menu of menus) {\n    const index = fullText.indexOf(menu.trigger);\n    if (index >= 0 && (triggerCharIndex === -1 || index < triggerCharIndex)) {\n      triggerCharIndex = index;\n      triggerChar = menu.trigger;\n    }\n  }\n\n  // Text before trigger character (corruption case)\n  if (triggerCharIndex > 0) {\n    tokens.push({ type: 'text', value: fullText.substring(0, triggerCharIndex) });\n  }\n\n  if (triggerCharIndex >= 0) {\n    const value = fullText.substring(triggerCharIndex + 1);\n\n    // Check for a nested trigger character in the filter text\n    let nestedTriggerIndex = -1;\n    let nestedTriggerChar = '';\n\n    for (const menu of menus) {\n      if (menu.useAtStart) {\n        continue;\n      }\n      const index = value.indexOf(menu.trigger);\n      if (index >= 0 && (nestedTriggerIndex === -1 || index < nestedTriggerIndex)) {\n        nestedTriggerIndex = index;\n        nestedTriggerChar = menu.trigger;\n      }\n    }\n\n    if (nestedTriggerIndex === 0) {\n      // Adjacent trigger characters — first trigger has empty filter, second is a new trigger\n      tokens.push({ type: 'trigger', value: '', triggerChar, id });\n      tokens.push({\n        type: 'trigger',\n        value: value.substring(1),\n        triggerChar: nestedTriggerChar,\n        id: generateTokenId(),\n      });\n    } else if (nestedTriggerIndex > 0 && value[nestedTriggerIndex - 1].trim() === '') {\n      // Split into first trigger, whitespace, and second trigger\n      const firstValue = value.substring(0, nestedTriggerIndex).trim();\n      const spaceBefore = value.substring(firstValue.length, nestedTriggerIndex);\n      const secondValue = value.substring(nestedTriggerIndex + 1);\n\n      tokens.push({ type: 'trigger', value: firstValue, triggerChar, id });\n      if (spaceBefore) {\n        tokens.push({ type: 'text', value: spaceBefore });\n      }\n      tokens.push({ type: 'trigger', value: secondValue, triggerChar: nestedTriggerChar, id: generateTokenId() });\n    } else {\n      tokens.push({ type: 'trigger', value, triggerChar, id });\n    }\n    // No trigger character found — treat as text\n  } else if (fullText) {\n    tokens.push({ type: 'text', value: fullText });\n  }\n\n  return tokens;\n}\n\n/** Extracts reference and surrounding text tokens from a reference DOM element. */\nfunction extractReferenceToken(\n  node: HTMLElement,\n  tokenType: string | null,\n  portalContainers?: Map<string, PortalContainer>\n): PromptInputProps.InputToken[] {\n  const tokens: PromptInputProps.InputToken[] = [];\n\n  // Text from cursor-spot-before\n  const cursorSpotBefore = findElement(node, { tokenType: ElementType.CaretSpotBefore });\n  if (cursorSpotBefore) {\n    const beforeText = stripZeroWidthCharacters(cursorSpotBefore.textContent || '');\n    if (beforeText) {\n      tokens.push({ type: 'text', value: beforeText });\n    }\n  }\n\n  const instanceId = node.id || '';\n\n  // Skip orphaned reference wrappers — deleteContents can remove internal\n  // elements while leaving the wrapper shell. A reference is orphaned if\n  // it has no portal container (source of truth for label/value).\n  const portalContainer = portalContainers?.get(instanceId);\n  if (!portalContainer) {\n    // Salvage any text from remaining caret-spots\n    const cursorSpotAfter = findElement(node, { tokenType: ElementType.CaretSpotAfter });\n    if (cursorSpotAfter) {\n      const afterText = stripZeroWidthCharacters(cursorSpotAfter.textContent || '');\n      if (afterText) {\n        tokens.push({ type: 'text', value: afterText });\n      }\n    }\n    return tokens;\n  }\n\n  const { value, label, menuId } = portalContainer;\n\n  const token: PromptInputProps.ReferenceToken = {\n    type: 'reference',\n    id: instanceId,\n    value,\n    label,\n    menuId,\n  };\n  if (tokenType === ElementType.Pinned) {\n    token.pinned = true;\n  }\n\n  tokens.push(token);\n\n  // Text from cursor-spot-after\n  const cursorSpotAfter = findElement(node, { tokenType: ElementType.CaretSpotAfter });\n  if (cursorSpotAfter) {\n    const afterText = stripZeroWidthCharacters(cursorSpotAfter.textContent || '');\n    if (afterText) {\n      tokens.push({ type: 'text', value: afterText });\n    }\n  }\n\n  return tokens;\n}\n\n/** Default plain text serialization for tokens. */\nexport function getPromptText(tokens: readonly PromptInputProps.InputToken[]): string {\n  let result = '';\n  let prevToken: PromptInputProps.InputToken | null = null;\n\n  for (const token of tokens) {\n    if (isBreakTextToken(token)) {\n      result += '\\n';\n      prevToken = token;\n      continue;\n    }\n\n    let segment: string;\n    if (isTriggerToken(token)) {\n      segment = token.triggerChar + token.value;\n    } else if (isReferenceToken(token)) {\n      segment = token.label || token.value;\n    } else {\n      segment = (token as PromptInputProps.TextToken).value;\n    }\n\n    if (segment.length === 0) {\n      continue;\n    }\n\n    // Insert a space between a reference and its neighbor when neither side has whitespace\n    const needsSpace =\n      result.length > 0 &&\n      !result.endsWith(' ') &&\n      !result.endsWith('\\n') &&\n      !segment.startsWith(' ') &&\n      (isReferenceToken(token) || (prevToken && isReferenceToken(prevToken)));\n\n    if (needsSpace) {\n      result += ' ';\n    }\n\n    result += segment;\n    prevToken = token;\n  }\n\n  return result;\n}\n\nexport function findLastPinnedTokenIndex(tokens: readonly PromptInputProps.InputToken[]): number {\n  for (let i = tokens.length - 1; i >= 0; i--) {\n    if (isPinnedReferenceToken(tokens[i])) {\n      return i;\n    }\n  }\n  return -1;\n}\n\n/** Scans text tokens for trigger characters and converts them to trigger tokens. */\nexport function detectTriggersInTokens(\n  tokens: readonly PromptInputProps.InputToken[],\n  menus: readonly PromptInputProps.MenuDefinition[],\n  onTriggerDetected?: (detail: PromptInputProps.TriggerDetectedDetail) => boolean,\n  cancelledIds?: Set<string>\n): PromptInputProps.InputToken[] {\n  const result: PromptInputProps.InputToken[] = [];\n\n  for (let i = 0; i < tokens.length; i++) {\n    const token = tokens[i];\n\n    // Skip cancelled triggers — don't re-parse their adjacent text\n    if (isTriggerToken(token) && cancelledIds?.has(token.id)) {\n      result.push(token);\n      continue;\n    }\n\n    // Collapse empty trigger + adjacent text back into a text token for re-parsing.\n    // Don't fire onTriggerDetected — the trigger already exists.\n    if (isTriggerToken(token) && token.value === '' && i !== tokens.length - 1) {\n      const next = tokens[i + 1];\n      if (isTextToken(next) && next.value.length > 0 && !next.value.startsWith(' ')) {\n        const detected = detectTriggersInText(token.triggerChar + next.value, menus, result);\n        const reusedTrigger = detected.find(isTriggerToken);\n        if (reusedTrigger && token.id) {\n          reusedTrigger.id = token.id;\n        }\n        result.push(...detected);\n        i++;\n        continue;\n      }\n    }\n\n    // Merge non-empty trigger + adjacent text when the separator was removed.\n    // Don't fire onTriggerDetected — the trigger already exists.\n    if (isTriggerToken(token) && token.value.length > 0 && i !== tokens.length - 1) {\n      const next = tokens[i + 1];\n      if (isTextToken(next) && next.value.length > 0 && !next.value.startsWith(' ')) {\n        const combined = token.triggerChar + token.value + next.value;\n        const detected = detectTriggersInText(combined, menus, result);\n        const reusedTrigger = detected.find(isTriggerToken);\n        if (reusedTrigger && token.id) {\n          reusedTrigger.id = token.id;\n        }\n        result.push(...detected);\n        i++;\n        continue;\n      }\n    }\n\n    if (isTextToken(token)) {\n      result.push(...detectTriggersInText(token.value, menus, result, onTriggerDetected, cancelledIds));\n    } else {\n      result.push(token);\n    }\n  }\n\n  return result;\n}\n\nexport interface ProcessTokensResult {\n  tokens: PromptInputProps.InputToken[];\n  cancelledIds: Set<string>;\n}\n\nexport function processTokens(\n  tokens: readonly PromptInputProps.InputToken[],\n  config: ShortcutsConfig,\n  options: {\n    source: UpdateSource;\n    detectTriggers?: boolean;\n  },\n  onTriggerDetected?: (detail: PromptInputProps.TriggerDetectedDetail) => boolean,\n  existingCancelledIds?: Set<string>\n): ProcessTokensResult {\n  let result = [...tokens];\n  const cancelledIds = new Set<string>(existingCancelledIds);\n\n  if (options.detectTriggers && config.menus) {\n    result = detectTriggersInTokens(result, config.menus, onTriggerDetected, cancelledIds);\n  }\n\n  return { tokens: result, cancelledIds };\n}\n"]}

package/prompt-input/core/token-renderer.d.ts

@@ -0,0 +1,26 @@
+import { PromptInputProps } from '../interfaces';
+/** Whether the current React version supports token mode (React 18+). */
+export declare const supportsTokenMode: boolean;
+/** A portal target — the DOM element where a reference token's React content is rendered via createPortal. */
+export interface PortalContainer {
+  /** Unique ID matching the token */
+  id: string;
+  /** The DOM element to render the portal into */
+  element: HTMLElement;
+  /** Label for the token */
+  label: string;
+  /** Value for the token */
+  value: string;
+  /** Menu ID the token was selected from */
+  menuId?: string;
+}
+/**
+ * Renders tokens into a contentEditable element using direct DOM manipulation.
+ * Reference tokens are NOT rendered here — instead, their DOM containers are registered
+ * in portalContainers for the parent component to render via ReactDOM.createPortal.
+ */
+export declare function renderTokensToDOM(tokens: readonly PromptInputProps.InputToken[], targetElement: HTMLElement, portalContainers: Map<string, PortalContainer>, existingTriggers?: Map<string, HTMLElement>, cancelledTriggerIds?: Set<string>): {
+  newTriggerElement: HTMLElement | null;
+  lastReferenceWithCaretSpots: HTMLElement | null;
+  triggerElements: Map<string, HTMLElement>;
+};

package/prompt-input/core/token-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-renderer.d.ts","sourceRoot":"","sources":["../../../../src/prompt-input/core/token-renderer.tsx"],"names":[],"mappings":"AA+BA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAajD,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,SAA+B,CAAC;AAE9D,8GAA8G;AAC9G,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,OAAO,EAAE,WAAW,CAAC;IACrB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgFD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,gBAAgB,CAAC,UAAU,EAAE,EAC9C,aAAa,EAAE,WAAW,EAC1B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EAC9C,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAC3C,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAChC;IACD,iBAAiB,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,2BAA2B,EAAE,WAAW,GAAG,IAAI,CAAC;IAChD,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC3C,CAoJA"}

package/prompt-input/core/token-renderer.js

@@ -0,0 +1,230 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+//
+// Token Renderer — Direct DOM manipulation for contentEditable
+//
+// This module renders tokens (text, triggers, references) into a contentEditable element
+// using direct DOM operations instead of React's declarative rendering. This approach is
+// necessary because:
+//
+// 1. React's reconciliation conflicts with contentEditable. When the user types, the browser
+//    mutates the DOM directly. React expects to own the DOM and would overwrite user input
+//    on the next render, causing cursor jumps and lost keystrokes.
+//
+// 2. Reference tokens are atomic inline elements (rendered via React portals into <span>
+//    containers) surrounded by caret spots (zero-width characters). This structure requires
+//    precise DOM control that React's diffing algorithm cannot provide — it would merge
+//    adjacent text nodes, remove "empty" spans, or reorder elements unpredictably.
+//
+// 3. Cursor positioning depends on exact DOM node identity. React may replace a text node
+//    with an equivalent one during reconciliation, which resets the browser's caret position.
+//    By managing DOM nodes directly, we preserve node identity across renders.
+//
+// Reference tokens are rendered via React portals (ReactDOM.createPortal) from the parent
+// component, keeping them in the same React tree for shared context and lifecycle. The
+// token-renderer creates the DOM containers; the parent renders content into them.
+//
+import clsx from 'clsx';
+import { getReactMajorVersion } from '../../internal/utils/react-version';
+import { ElementType, SPECIAL_CHARS } from './constants';
+import { createParagraph, createTrailingBreak, findAllParagraphs, getTokenType, isReferenceElementType, } from './dom-utils';
+import { isBreakTextToken, isReferenceToken, isTextToken, isTriggerToken } from './type-guards';
+import styles from '../styles.css.js';
+/** Whether the current React version supports token mode (React 18+). */
+export const supportsTokenMode = getReactMajorVersion() >= 18;
+function groupTokensIntoParagraphs(tokens) {
+    if (tokens.length === 0) {
+        return [{ tokens: [] }];
+    }
+    const paragraphs = [];
+    let currentParagraph = [];
+    for (let i = 0; i < tokens.length; i++) {
+        const token = tokens[i];
+        if (isBreakTextToken(token)) {
+            const isLeadingBreak = currentParagraph.length === 0;
+            if (isLeadingBreak) {
+                paragraphs.push({ tokens: [] });
+            }
+            else {
+                paragraphs.push({ tokens: currentParagraph });
+                currentParagraph = [];
+            }
+        }
+        else {
+            currentParagraph.push(token);
+        }
+    }
+    paragraphs.push({ tokens: currentParagraph });
+    return paragraphs;
+}
+/** Creates an invisible span with a zero-width character to provide a valid caret position next to reference tokens. */
+function createCaretSpot(type, ownerDoc) {
+    const caretSpot = ownerDoc.createElement('span');
+    caretSpot.setAttribute('data-type', type);
+    caretSpot.setAttribute('contenteditable', 'true');
+    caretSpot.setAttribute('aria-hidden', 'true');
+    caretSpot.appendChild(ownerDoc.createTextNode(SPECIAL_CHARS.ZERO_WIDTH_CHARACTER));
+    return caretSpot;
+}
+function createReferenceWithCaretSpots(token, portalContainers, ownerDoc) {
+    const wrapper = ownerDoc.createElement('span');
+    wrapper.className = styles['reference-wrapper'];
+    wrapper.setAttribute('data-type', token.pinned ? ElementType.Pinned : ElementType.Reference);
+    const instanceId = token.id;
+    wrapper.id = instanceId;
+    const caretSpotBefore = createCaretSpot(ElementType.CaretSpotBefore, ownerDoc);
+    const element = ownerDoc.createElement('span');
+    element.className = styles['token-container'];
+    element.setAttribute('contenteditable', 'false');
+    // Register the container for portal rendering by the parent component.
+    portalContainers.set(instanceId, {
+        id: instanceId,
+        element,
+        label: token.label,
+        value: token.value,
+        menuId: token.menuId,
+    });
+    const caretSpotAfter = createCaretSpot(ElementType.CaretSpotAfter, ownerDoc);
+    wrapper.appendChild(caretSpotBefore);
+    wrapper.appendChild(element);
+    wrapper.appendChild(caretSpotAfter);
+    return wrapper;
+}
+/**
+ * Renders tokens into a contentEditable element using direct DOM manipulation.
+ * Reference tokens are NOT rendered here — instead, their DOM containers are registered
+ * in portalContainers for the parent component to render via ReactDOM.createPortal.
+ */
+export function renderTokensToDOM(tokens, targetElement, portalContainers, existingTriggers, cancelledTriggerIds) {
+    var _a, _b;
+    // Preserve existing portal containers that are still in the DOM.
+    const existingContainers = new Map();
+    portalContainers.forEach((container, instanceId) => {
+        if (container.element.isConnected && targetElement.contains(container.element)) {
+            existingContainers.set(instanceId, container);
+        }
+    });
+    portalContainers.clear();
+    // Use the provided trigger map or start empty for the initial render.
+    const reusableTriggers = new Map(existingTriggers !== null && existingTriggers !== void 0 ? existingTriggers : []);
+    const existingParagraphs = findAllParagraphs(targetElement);
+    const paragraphGroups = groupTokensIntoParagraphs(tokens);
+    const ownerDoc = (_a = targetElement.ownerDocument) !== null && _a !== void 0 ? _a : document;
+    let newTriggerElement = null;
+    let lastReferenceWithCaretSpots = null;
+    const triggerElements = new Map();
+    for (let pIndex = 0; pIndex < paragraphGroups.length; pIndex++) {
+        const paragraphGroup = paragraphGroups[pIndex];
+        let p;
+        if (pIndex < existingParagraphs.length) {
+            p = existingParagraphs[pIndex];
+        }
+        else {
+            p = createParagraph();
+            targetElement.appendChild(p);
+        }
+        const newNodes = [];
+        for (let i = 0; i < paragraphGroup.tokens.length; i++) {
+            const token = paragraphGroup.tokens[i];
+            if (isTextToken(token)) {
+                if (token.value) {
+                    newNodes.push(ownerDoc.createTextNode(token.value));
+                }
+            }
+            else if (isTriggerToken(token)) {
+                let span;
+                const triggerId = token.id;
+                const isNewTrigger = !reusableTriggers.has(triggerId);
+                const hasFilterText = token.value.length > 0;
+                const isCancelled = (_b = cancelledTriggerIds === null || cancelledTriggerIds === void 0 ? void 0 : cancelledTriggerIds.has(triggerId)) !== null && _b !== void 0 ? _b : false;
+                if (reusableTriggers.has(triggerId)) {
+                    span = reusableTriggers.get(triggerId);
+                    reusableTriggers.delete(triggerId);
+                }
+                else {
+                    span = ownerDoc.createElement('span');
+                    span.setAttribute('data-type', ElementType.Trigger);
+                    span.id = triggerId;
+                    span.setAttribute('data-id', triggerId);
+                }
+                const classes = clsx(styles['trigger-base'], hasFilterText && styles['trigger-token']);
+                span.className = classes;
+                span.textContent = token.triggerChar + token.value;
+                newNodes.push(span);
+                triggerElements.set(triggerId, span);
+                if (isNewTrigger && !isCancelled) {
+                    newTriggerElement = span;
+                }
+            }
+            else if (isReferenceToken(token)) {
+                // Check if we can reuse an existing portal container.
+                const existingContainer = token.id ? existingContainers.get(token.id) : undefined;
+                if (existingContainer) {
+                    const existingWrapper = existingContainer.element.parentElement;
+                    if (existingWrapper) {
+                        const tokenType = getTokenType(existingWrapper);
+                        if (isReferenceElementType(tokenType)) {
+                            // Reuse existing container — update props in case they changed.
+                            existingContainer.label = token.label;
+                            existingContainer.value = token.value;
+                            existingContainer.menuId = token.menuId;
+                            portalContainers.set(token.id, existingContainer);
+                            newNodes.push(existingWrapper);
+                            existingContainers.delete(token.id);
+                            lastReferenceWithCaretSpots = existingWrapper;
+                            continue;
+                        }
+                    }
+                }
+                const wrapper = createReferenceWithCaretSpots(token, portalContainers, ownerDoc);
+                newNodes.push(wrapper);
+                lastReferenceWithCaretSpots = wrapper;
+            }
+        }
+        if (newNodes.length === 0) {
+            newNodes.push(createTrailingBreak());
+        }
+        const existingNodes = Array.from(p.childNodes);
+        let nodesMatch = existingNodes.length === newNodes.length;
+        if (nodesMatch) {
+            for (let i = 0; i < newNodes.length; i++) {
+                if (existingNodes[i] !== newNodes[i]) {
+                    nodesMatch = false;
+                    break;
+                }
+            }
+        }
+        if (nodesMatch) {
+            continue;
+        }
+        for (let i = newNodes.length; i < existingNodes.length; i++) {
+            existingNodes[i].remove();
+        }
+        for (let i = 0; i < newNodes.length; i++) {
+            const newNode = newNodes[i];
+            const existingNode = existingNodes[i];
+            if (existingNode === newNode) {
+                continue;
+            }
+            if (existingNode && newNodes.includes(existingNode)) {
+                if (i < p.childNodes.length) {
+                    p.insertBefore(newNode, p.childNodes[i]);
+                }
+                else {
+                    p.appendChild(newNode);
+                }
+            }
+            else if (existingNode) {
+                p.replaceChild(newNode, existingNode);
+            }
+            else {
+                p.appendChild(newNode);
+            }
+        }
+    }
+    while (targetElement.children.length > paragraphGroups.length) {
+        targetElement.removeChild(targetElement.lastChild);
+    }
+    return { newTriggerElement, lastReferenceWithCaretSpots, triggerElements };
+}
+//# sourceMappingURL=token-renderer.js.map

package/prompt-input/core/token-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-renderer.js","sourceRoot":"","sources":["../../../../src/prompt-input/core/token-renderer.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\n//\n// Token Renderer — Direct DOM manipulation for contentEditable\n//\n// This module renders tokens (text, triggers, references) into a contentEditable element\n// using direct DOM operations instead of React's declarative rendering. This approach is\n// necessary because:\n//\n// 1. React's reconciliation conflicts with contentEditable. When the user types, the browser\n//    mutates the DOM directly. React expects to own the DOM and would overwrite user input\n//    on the next render, causing cursor jumps and lost keystrokes.\n//\n// 2. Reference tokens are atomic inline elements (rendered via React portals into <span>\n//    containers) surrounded by caret spots (zero-width characters). This structure requires\n//    precise DOM control that React's diffing algorithm cannot provide — it would merge\n//    adjacent text nodes, remove \"empty\" spans, or reorder elements unpredictably.\n//\n// 3. Cursor positioning depends on exact DOM node identity. React may replace a text node\n//    with an equivalent one during reconciliation, which resets the browser's caret position.\n//    By managing DOM nodes directly, we preserve node identity across renders.\n//\n// Reference tokens are rendered via React portals (ReactDOM.createPortal) from the parent\n// component, keeping them in the same React tree for shared context and lifecycle. The\n// token-renderer creates the DOM containers; the parent renders content into them.\n//\n\nimport clsx from 'clsx';\n\nimport { getReactMajorVersion } from '../../internal/utils/react-version';\nimport { PromptInputProps } from '../interfaces';\nimport { ElementType, SPECIAL_CHARS } from './constants';\nimport {\n  createParagraph,\n  createTrailingBreak,\n  findAllParagraphs,\n  getTokenType,\n  isReferenceElementType,\n} from './dom-utils';\nimport { isBreakTextToken, isReferenceToken, isTextToken, isTriggerToken } from './type-guards';\n\nimport styles from '../styles.css.js';\n\n/** Whether the current React version supports token mode (React 18+). */\nexport const supportsTokenMode = getReactMajorVersion() >= 18;\n\n/** A portal target — the DOM element where a reference token's React content is rendered via createPortal. */\nexport interface PortalContainer {\n  /** Unique ID matching the token */\n  id: string;\n  /** The DOM element to render the portal into */\n  element: HTMLElement;\n  /** Label for the token */\n  label: string;\n  /** Value for the token */\n  value: string;\n  /** Menu ID the token was selected from */\n  menuId?: string;\n}\n\ninterface ParagraphGroup {\n  tokens: PromptInputProps.InputToken[];\n}\n\nfunction groupTokensIntoParagraphs(tokens: readonly PromptInputProps.InputToken[]): ParagraphGroup[] {\n  if (tokens.length === 0) {\n    return [{ tokens: [] }];\n  }\n\n  const paragraphs: ParagraphGroup[] = [];\n  let currentParagraph: PromptInputProps.InputToken[] = [];\n\n  for (let i = 0; i < tokens.length; i++) {\n    const token = tokens[i];\n\n    if (isBreakTextToken(token)) {\n      const isLeadingBreak = currentParagraph.length === 0;\n\n      if (isLeadingBreak) {\n        paragraphs.push({ tokens: [] });\n      } else {\n        paragraphs.push({ tokens: currentParagraph });\n        currentParagraph = [];\n      }\n    } else {\n      currentParagraph.push(token);\n    }\n  }\n\n  paragraphs.push({ tokens: currentParagraph });\n\n  return paragraphs;\n}\n\n/** Creates an invisible span with a zero-width character to provide a valid caret position next to reference tokens. */\nfunction createCaretSpot(type: string, ownerDoc: Document): HTMLSpanElement {\n  const caretSpot = ownerDoc.createElement('span');\n  caretSpot.setAttribute('data-type', type);\n  caretSpot.setAttribute('contenteditable', 'true');\n  caretSpot.setAttribute('aria-hidden', 'true');\n  caretSpot.appendChild(ownerDoc.createTextNode(SPECIAL_CHARS.ZERO_WIDTH_CHARACTER));\n  return caretSpot;\n}\n\nfunction createReferenceWithCaretSpots(\n  token: PromptInputProps.ReferenceToken,\n  portalContainers: Map<string, PortalContainer>,\n  ownerDoc: Document\n): HTMLSpanElement {\n  const wrapper = ownerDoc.createElement('span');\n  wrapper.className = styles['reference-wrapper'];\n  wrapper.setAttribute('data-type', token.pinned ? ElementType.Pinned : ElementType.Reference);\n  const instanceId = token.id;\n  wrapper.id = instanceId;\n\n  const caretSpotBefore = createCaretSpot(ElementType.CaretSpotBefore, ownerDoc);\n  const element = ownerDoc.createElement('span');\n  element.className = styles['token-container'];\n  element.setAttribute('contenteditable', 'false');\n\n  // Register the container for portal rendering by the parent component.\n  portalContainers.set(instanceId, {\n    id: instanceId,\n    element,\n    label: token.label,\n    value: token.value,\n    menuId: token.menuId,\n  });\n\n  const caretSpotAfter = createCaretSpot(ElementType.CaretSpotAfter, ownerDoc);\n\n  wrapper.appendChild(caretSpotBefore);\n  wrapper.appendChild(element);\n  wrapper.appendChild(caretSpotAfter);\n\n  return wrapper;\n}\n\n/**\n * Renders tokens into a contentEditable element using direct DOM manipulation.\n * Reference tokens are NOT rendered here — instead, their DOM containers are registered\n * in portalContainers for the parent component to render via ReactDOM.createPortal.\n */\nexport function renderTokensToDOM(\n  tokens: readonly PromptInputProps.InputToken[],\n  targetElement: HTMLElement,\n  portalContainers: Map<string, PortalContainer>,\n  existingTriggers?: Map<string, HTMLElement>,\n  cancelledTriggerIds?: Set<string>\n): {\n  newTriggerElement: HTMLElement | null;\n  lastReferenceWithCaretSpots: HTMLElement | null;\n  triggerElements: Map<string, HTMLElement>;\n} {\n  // Preserve existing portal containers that are still in the DOM.\n  const existingContainers = new Map<string, PortalContainer>();\n  portalContainers.forEach((container, instanceId) => {\n    if (container.element.isConnected && targetElement.contains(container.element)) {\n      existingContainers.set(instanceId, container);\n    }\n  });\n  portalContainers.clear();\n\n  // Use the provided trigger map or start empty for the initial render.\n  const reusableTriggers = new Map(existingTriggers ?? []);\n\n  const existingParagraphs = findAllParagraphs(targetElement);\n  const paragraphGroups = groupTokensIntoParagraphs(tokens);\n  const ownerDoc = targetElement.ownerDocument ?? document;\n\n  let newTriggerElement: HTMLElement | null = null;\n  let lastReferenceWithCaretSpots: HTMLElement | null = null;\n  const triggerElements = new Map<string, HTMLElement>();\n\n  for (let pIndex = 0; pIndex < paragraphGroups.length; pIndex++) {\n    const paragraphGroup = paragraphGroups[pIndex];\n    let p: HTMLParagraphElement;\n\n    if (pIndex < existingParagraphs.length) {\n      p = existingParagraphs[pIndex];\n    } else {\n      p = createParagraph();\n      targetElement.appendChild(p);\n    }\n\n    const newNodes: Node[] = [];\n\n    for (let i = 0; i < paragraphGroup.tokens.length; i++) {\n      const token = paragraphGroup.tokens[i];\n\n      if (isTextToken(token)) {\n        if (token.value) {\n          newNodes.push(ownerDoc.createTextNode(token.value));\n        }\n      } else if (isTriggerToken(token)) {\n        let span: HTMLElement;\n        const triggerId = token.id;\n        const isNewTrigger = !reusableTriggers.has(triggerId);\n        const hasFilterText = token.value.length > 0;\n        const isCancelled = cancelledTriggerIds?.has(triggerId) ?? false;\n\n        if (reusableTriggers.has(triggerId)) {\n          span = reusableTriggers.get(triggerId)!;\n          reusableTriggers.delete(triggerId);\n        } else {\n          span = ownerDoc.createElement('span');\n          span.setAttribute('data-type', ElementType.Trigger);\n          span.id = triggerId;\n          span.setAttribute('data-id', triggerId);\n        }\n\n        const classes = clsx(styles['trigger-base'], hasFilterText && styles['trigger-token']);\n\n        span.className = classes;\n        span.textContent = token.triggerChar + token.value;\n\n        newNodes.push(span);\n        triggerElements.set(triggerId, span);\n\n        if (isNewTrigger && !isCancelled) {\n          newTriggerElement = span;\n        }\n      } else if (isReferenceToken(token)) {\n        // Check if we can reuse an existing portal container.\n        const existingContainer = token.id ? existingContainers.get(token.id) : undefined;\n        if (existingContainer) {\n          const existingWrapper = existingContainer.element.parentElement;\n          if (existingWrapper) {\n            const tokenType = getTokenType(existingWrapper);\n            if (isReferenceElementType(tokenType)) {\n              // Reuse existing container — update props in case they changed.\n              existingContainer.label = token.label;\n              existingContainer.value = token.value;\n              existingContainer.menuId = token.menuId;\n              portalContainers.set(token.id!, existingContainer);\n\n              newNodes.push(existingWrapper);\n              existingContainers.delete(token.id!);\n              lastReferenceWithCaretSpots = existingWrapper;\n              continue;\n            }\n          }\n        }\n\n        const wrapper = createReferenceWithCaretSpots(token, portalContainers, ownerDoc);\n        newNodes.push(wrapper);\n        lastReferenceWithCaretSpots = wrapper;\n      }\n    }\n\n    if (newNodes.length === 0) {\n      newNodes.push(createTrailingBreak());\n    }\n\n    const existingNodes = Array.from(p.childNodes);\n\n    let nodesMatch = existingNodes.length === newNodes.length;\n    if (nodesMatch) {\n      for (let i = 0; i < newNodes.length; i++) {\n        if (existingNodes[i] !== newNodes[i]) {\n          nodesMatch = false;\n          break;\n        }\n      }\n    }\n\n    if (nodesMatch) {\n      continue;\n    }\n\n    for (let i = newNodes.length; i < existingNodes.length; i++) {\n      existingNodes[i].remove();\n    }\n\n    for (let i = 0; i < newNodes.length; i++) {\n      const newNode = newNodes[i];\n      const existingNode = existingNodes[i];\n\n      if (existingNode === newNode) {\n        continue;\n      }\n\n      if (existingNode && newNodes.includes(existingNode)) {\n        if (i < p.childNodes.length) {\n          p.insertBefore(newNode, p.childNodes[i]);\n        } else {\n          p.appendChild(newNode);\n        }\n      } else if (existingNode) {\n        p.replaceChild(newNode, existingNode);\n      } else {\n        p.appendChild(newNode);\n      }\n    }\n  }\n\n  while (targetElement.children.length > paragraphGroups.length) {\n    targetElement.removeChild(targetElement.lastChild!);\n  }\n\n  return { newTriggerElement, lastReferenceWithCaretSpots, triggerElements };\n}\n"]}