@carbon/ai-chat-components 1.12.0-rc.0 → 1.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/custom-elements.json +7789 -7657
  2. package/es/components/prompt-line/autocomplete/index.d.ts +1 -1
  3. package/es/components/prompt-line/autocomplete/src/autocomplete.d.ts +6 -0
  4. package/es/components/prompt-line/autocomplete/src/autocomplete.js +37 -11
  5. package/es/components/prompt-line/autocomplete/src/autocomplete.js.map +1 -1
  6. package/es/components/prompt-line/src/autocomplete-controller-element.d.ts +16 -0
  7. package/es/components/prompt-line/src/autocomplete-controller-element.js +41 -0
  8. package/es/components/prompt-line/src/autocomplete-controller-element.js.map +1 -1
  9. package/es/components/prompt-line/src/autocomplete-controller.js +13 -0
  10. package/es/components/prompt-line/src/autocomplete-controller.js.map +1 -1
  11. package/es/components/prompt-line/src/send-control.d.ts +7 -0
  12. package/es/components/prompt-line/src/send-control.js +53 -5
  13. package/es/components/prompt-line/src/send-control.js.map +1 -1
  14. package/es/components/prompt-line/src/tiptap/carbon-autocomplete.js +20 -20
  15. package/es/components/prompt-line/src/tiptap/carbon-autocomplete.js.map +1 -1
  16. package/es/components/prompt-line/src/tiptap/carbon-mention.js +1 -1
  17. package/es/components/prompt-line/src/tiptap/carbon-mention.js.map +1 -1
  18. package/es/components/prompt-line/src/tiptap/trigger-utils.d.ts +12 -8
  19. package/es/components/prompt-line/src/tiptap/trigger-utils.js +16 -1
  20. package/es/components/prompt-line/src/tiptap/trigger-utils.js.map +1 -1
  21. package/es/react/hooks/useChatAutocomplete.d.ts +5 -0
  22. package/es/react/hooks/useChatAutocomplete.js +26 -1
  23. package/es/react/hooks/useChatAutocomplete.js.map +1 -1
  24. package/es-custom/components/prompt-line/autocomplete/index.d.ts +1 -1
  25. package/es-custom/components/prompt-line/autocomplete/src/autocomplete.d.ts +6 -0
  26. package/es-custom/components/prompt-line/autocomplete/src/autocomplete.js +37 -11
  27. package/es-custom/components/prompt-line/autocomplete/src/autocomplete.js.map +1 -1
  28. package/es-custom/components/prompt-line/src/autocomplete-controller-element.d.ts +16 -0
  29. package/es-custom/components/prompt-line/src/autocomplete-controller-element.js +41 -0
  30. package/es-custom/components/prompt-line/src/autocomplete-controller-element.js.map +1 -1
  31. package/es-custom/components/prompt-line/src/autocomplete-controller.js +13 -0
  32. package/es-custom/components/prompt-line/src/autocomplete-controller.js.map +1 -1
  33. package/es-custom/components/prompt-line/src/send-control.d.ts +7 -0
  34. package/es-custom/components/prompt-line/src/send-control.js +53 -5
  35. package/es-custom/components/prompt-line/src/send-control.js.map +1 -1
  36. package/es-custom/components/prompt-line/src/tiptap/carbon-autocomplete.js +20 -20
  37. package/es-custom/components/prompt-line/src/tiptap/carbon-autocomplete.js.map +1 -1
  38. package/es-custom/components/prompt-line/src/tiptap/carbon-mention.js +1 -1
  39. package/es-custom/components/prompt-line/src/tiptap/carbon-mention.js.map +1 -1
  40. package/es-custom/components/prompt-line/src/tiptap/trigger-utils.d.ts +12 -8
  41. package/es-custom/components/prompt-line/src/tiptap/trigger-utils.js +16 -1
  42. package/es-custom/components/prompt-line/src/tiptap/trigger-utils.js.map +1 -1
  43. package/es-custom/react/hooks/useChatAutocomplete.d.ts +5 -0
  44. package/es-custom/react/hooks/useChatAutocomplete.js +26 -1
  45. package/es-custom/react/hooks/useChatAutocomplete.js.map +1 -1
  46. package/package.json +2 -2
  47. package/telemetry.yml +3 -0
@@ -99,7 +99,7 @@ function buildTriggerExtension(config, build) {
99
99
  },
100
100
  onExit: (props) => {
101
101
  lastQuery = null;
102
- dispatchTriggerChange(props.editor, null);
102
+ dispatchTriggerChange(props.editor, null, name);
103
103
  },
104
104
  onKeyDown: () => false,
105
105
  };
@@ -1 +1 @@
1
- {"version":3,"file":"carbon-mention.js","sources":["../../../../../src/components/prompt-line/src/tiptap/carbon-mention.ts"],"sourcesContent":["/**\n * @license\n *\n * Copyright IBM Corp. 2026\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n/**\n * `carbonMention` and `carbonCommand` factories. Both wrap\n * `@tiptap/extension-mention` with carbon-specific:\n * - chip rendering via `CarbonTokenNodeView` (uses the light-DOM portal\n * handshake so React portal consumers render in light DOM).\n * - extra schema attrs (`value`, `data`, `trigger`) layered on top of\n * Mention's default `id` + `label`.\n * - direct `cds-custom-aichat-trigger-change` dispatch from the suggestion-render\n * lifecycle via the shared `dispatchTriggerChange` helper.\n * - an `onRemove` callback fired when a user edit deletes a token node, the\n * mirror of the suggestion `onSelect` (see the removal ProseMirror plugin).\n *\n * They share an internal builder. The two exports differ only in their\n * default schema-node name (`\"mention\"` vs `\"command\"`), the dispatched\n * trigger type, the default chip color (handled inside the NodeView), and\n * the default for whether the trigger char is stored on inserted nodes —\n * `carbonCommand` defaults to on, `carbonMention` to off, so command chips\n * default to reading as `/summarize` while mention chips stay a bare name.\n * Either default can be overridden per-config (`TriggerSuggestionConfig.\n * showTriggerInChip`) or per-item (`SuggestionItem.showTriggerInChip`, which\n * wins when set — e.g. a single `@` picker mixing people and agents).\n * Each chat supports one mention trigger and one command trigger, because\n * Tiptap resolves extensions by name.\n */\n\nimport type { Editor, Range } from '@tiptap/core';\nimport Mention from '@tiptap/extension-mention';\nimport type { Node as PMNode } from '@tiptap/pm/model';\nimport { Plugin, PluginKey } from '@tiptap/pm/state';\n\nimport { isHostOrigin } from './origin-meta.js';\nimport { CarbonTokenNodeView } from './token-node-view.js';\nimport { dispatchTriggerChange } from './trigger-utils.js';\nimport type { SuggestionItem, TriggerSuggestionConfig } from './types.js';\n\ninterface BuildOptions {\n defaultName: 'mention' | 'command';\n defaultPluginKeyName: string;\n}\n\nfunction buildTriggerExtension(\n config: TriggerSuggestionConfig,\n build: BuildOptions\n) {\n const name = build.defaultName;\n const pluginKey = new PluginKey(`${build.defaultPluginKeyName}_${name}`);\n\n return Mention.extend({\n name,\n\n addAttributes() {\n const parent = (this.parent?.() ?? {}) as Record<string, unknown>;\n return {\n ...parent,\n mentionSuggestionChar: { default: config.trigger },\n value: { default: null },\n // Host custom fields, held in editor state only: they survive the JSON\n // round-trip, undo/redo, and moves within the document, and never\n // reach HTML. Tiptap's default attribute rendering would stringify the\n // object into the markup as \"[object Object]\".\n data: { default: null, renderHTML: () => ({}) },\n trigger: { default: null },\n };\n },\n\n addNodeView() {\n return ({ node, editor }) =>\n new CarbonTokenNodeView(node, editor.view, {\n renderCustomToken: config.renderCustomToken,\n });\n },\n\n addProseMirrorPlugins() {\n const parentPlugins = this.parent?.() ?? [];\n const onRemove = config.onRemove;\n if (!onRemove) {\n return parentPlugins;\n }\n\n // Fire `onRemove` once per token node of this type that leaves the doc\n // via a USER edit. `appendTransaction` records whether the batch was\n // host-origin — `some`, where typing-indicator uses `every` — and the\n // view's `update` runs the diff (after state is applied, so host\n // callbacks never re-enter `dispatch`). Host-origin batches — the\n // framework's post-send clear and any `getEditor()`/`updateContent`\n // mutation — are skipped, symmetric with `onSelect` firing only on user\n // popup selection.\n let lastBatchIsHost = false;\n\n const removalPlugin = new Plugin({\n key: new PluginKey(`${name}_removal`),\n appendTransaction(transactions) {\n lastBatchIsHost = transactions.some((tr) => isHostOrigin(tr));\n return null;\n },\n view: () => ({\n update(view, prevState) {\n if (view.state.doc === prevState.doc || lastBatchIsHost) {\n return;\n }\n const removed = diffRemovedTokens(\n prevState.doc,\n view.state.doc,\n name\n );\n for (const item of removed) {\n onRemove(item);\n }\n },\n }),\n });\n\n return [...parentPlugins, removalPlugin];\n },\n }).configure({\n HTMLAttributes: { 'data-token-type': name },\n suggestion: {\n char: config.trigger,\n pluginKey,\n startOfLine: config.triggerPosition === 'start',\n render: () => {\n let lastQuery: string | null = null;\n return {\n onStart: (props) =>\n emitTrigger(props.editor, name, props.query, props.range, () => {\n lastQuery = props.query;\n }),\n onUpdate: (props) => {\n if (props.query === lastQuery) {\n return;\n }\n lastQuery = props.query;\n emitTrigger(props.editor, name, props.query, props.range);\n },\n onExit: (props) => {\n lastQuery = null;\n dispatchTriggerChange(props.editor, null);\n },\n onKeyDown: () => false,\n };\n },\n },\n });\n}\n\nfunction emitTrigger(\n editor: Editor,\n type: string,\n query: string,\n range: Range,\n postEmit?: () => void\n): void {\n dispatchTriggerChange(editor, {\n type,\n query,\n triggerOffset: range.from,\n });\n postEmit?.();\n}\n\n/**\n * Collect the attrs of every node named `name` in `doc`, grouped by id and\n * kept in document order, so a multiset diff can tell which specific node\n * instances were removed (duplicate chips with the same id are tracked by\n * count, not collapsed).\n */\nfunction collectTokenAttrsById(\n doc: PMNode,\n name: string\n): Map<string, Record<string, unknown>[]> {\n const byId = new Map<string, Record<string, unknown>[]>();\n doc.descendants((node) => {\n if (node.type.name !== name) {\n return;\n }\n const attrs = node.attrs as Record<string, unknown>;\n const id = String(attrs.id);\n const bucket = byId.get(id);\n if (bucket) {\n bucket.push(attrs);\n } else {\n byId.set(id, [attrs]);\n }\n });\n return byId;\n}\n\n/**\n * Reconstruct a {@link SuggestionItem} from a removed token node's attrs.\n * Presentation-only fields were stripped at insert time, so only `id`,\n * `label`, `value`, and any custom fields stashed in `data` survive.\n */\nfunction attrsToItem(attrs: Record<string, unknown>): SuggestionItem {\n // `data` holds whatever a caller put in the node's attrs, and\n // `insertContent()` takes a raw node spec — so a host can land a string or\n // an array here. Spreading either yields index keys ({...'abc'} → {0:'a'}),\n // which would then reach onRemove as if the host had set them.\n const raw = attrs.data;\n const data =\n raw && typeof raw === 'object' && !Array.isArray(raw)\n ? (raw as Record<string, unknown>)\n : {};\n return {\n ...data,\n id: String(attrs.id),\n label: attrs.label as string,\n value: (attrs.value ?? undefined) as string | undefined,\n };\n}\n\n/**\n * Diff token nodes named `name` between `before` and `after`, returning the\n * reconstructed items for each removed node instance (one entry per removed\n * duplicate).\n */\nfunction diffRemovedTokens(\n before: PMNode,\n after: PMNode,\n name: string\n): SuggestionItem[] {\n const beforeById = collectTokenAttrsById(before, name);\n const afterById = collectTokenAttrsById(after, name);\n const removed: SuggestionItem[] = [];\n for (const [id, beforeAttrs] of beforeById) {\n const afterCount = afterById.get(id)?.length ?? 0;\n for (let i = afterCount; i < beforeAttrs.length; i += 1) {\n removed.push(attrsToItem(beforeAttrs[i]));\n }\n }\n return removed;\n}\n\n/**\n * Resolve whether a selected item's chip should be prefixed with the\n * trigger character: the item's own {@link SuggestionItem.showTriggerInChip}\n * wins when set, then the config's\n * {@link TriggerSuggestionConfig.showTriggerInChip}, then the\n * command/mention default.\n */\nexport function resolveShowTriggerInChip(\n item: SuggestionItem,\n config: Pick<TriggerSuggestionConfig, 'showTriggerInChip'>,\n isCommand: boolean\n): boolean {\n return item.showTriggerInChip ?? config.showTriggerInChip ?? isCommand;\n}\n\nexport function carbonMention(config: TriggerSuggestionConfig) {\n return buildTriggerExtension(config, {\n defaultName: 'mention',\n defaultPluginKeyName: 'carbonMentionSuggestion',\n });\n}\n\nexport function carbonCommand(config: TriggerSuggestionConfig) {\n return buildTriggerExtension(config, {\n defaultName: 'command',\n defaultPluginKeyName: 'carbonCommandSuggestion',\n });\n}\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"carbon-mention.js","sources":["../../../../../src/components/prompt-line/src/tiptap/carbon-mention.ts"],"sourcesContent":["/**\n * @license\n *\n * Copyright IBM Corp. 2026\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n/**\n * `carbonMention` and `carbonCommand` factories. Both wrap\n * `@tiptap/extension-mention` with carbon-specific:\n * - chip rendering via `CarbonTokenNodeView` (uses the light-DOM portal\n * handshake so React portal consumers render in light DOM).\n * - extra schema attrs (`value`, `data`, `trigger`) layered on top of\n * Mention's default `id` + `label`.\n * - direct `cds-custom-aichat-trigger-change` dispatch from the suggestion-render\n * lifecycle via the shared `dispatchTriggerChange` helper.\n * - an `onRemove` callback fired when a user edit deletes a token node, the\n * mirror of the suggestion `onSelect` (see the removal ProseMirror plugin).\n *\n * They share an internal builder. The two exports differ only in their\n * default schema-node name (`\"mention\"` vs `\"command\"`), the dispatched\n * trigger type, the default chip color (handled inside the NodeView), and\n * the default for whether the trigger char is stored on inserted nodes —\n * `carbonCommand` defaults to on, `carbonMention` to off, so command chips\n * default to reading as `/summarize` while mention chips stay a bare name.\n * Either default can be overridden per-config (`TriggerSuggestionConfig.\n * showTriggerInChip`) or per-item (`SuggestionItem.showTriggerInChip`, which\n * wins when set — e.g. a single `@` picker mixing people and agents).\n * Each chat supports one mention trigger and one command trigger, because\n * Tiptap resolves extensions by name.\n */\n\nimport type { Editor, Range } from '@tiptap/core';\nimport Mention from '@tiptap/extension-mention';\nimport type { Node as PMNode } from '@tiptap/pm/model';\nimport { Plugin, PluginKey } from '@tiptap/pm/state';\n\nimport { isHostOrigin } from './origin-meta.js';\nimport { CarbonTokenNodeView } from './token-node-view.js';\nimport { dispatchTriggerChange } from './trigger-utils.js';\nimport type { SuggestionItem, TriggerSuggestionConfig } from './types.js';\n\ninterface BuildOptions {\n defaultName: 'mention' | 'command';\n defaultPluginKeyName: string;\n}\n\nfunction buildTriggerExtension(\n config: TriggerSuggestionConfig,\n build: BuildOptions\n) {\n const name = build.defaultName;\n const pluginKey = new PluginKey(`${build.defaultPluginKeyName}_${name}`);\n\n return Mention.extend({\n name,\n\n addAttributes() {\n const parent = (this.parent?.() ?? {}) as Record<string, unknown>;\n return {\n ...parent,\n mentionSuggestionChar: { default: config.trigger },\n value: { default: null },\n // Host custom fields, held in editor state only: they survive the JSON\n // round-trip, undo/redo, and moves within the document, and never\n // reach HTML. Tiptap's default attribute rendering would stringify the\n // object into the markup as \"[object Object]\".\n data: { default: null, renderHTML: () => ({}) },\n trigger: { default: null },\n };\n },\n\n addNodeView() {\n return ({ node, editor }) =>\n new CarbonTokenNodeView(node, editor.view, {\n renderCustomToken: config.renderCustomToken,\n });\n },\n\n addProseMirrorPlugins() {\n const parentPlugins = this.parent?.() ?? [];\n const onRemove = config.onRemove;\n if (!onRemove) {\n return parentPlugins;\n }\n\n // Fire `onRemove` once per token node of this type that leaves the doc\n // via a USER edit. `appendTransaction` records whether the batch was\n // host-origin — `some`, where typing-indicator uses `every` — and the\n // view's `update` runs the diff (after state is applied, so host\n // callbacks never re-enter `dispatch`). Host-origin batches — the\n // framework's post-send clear and any `getEditor()`/`updateContent`\n // mutation — are skipped, symmetric with `onSelect` firing only on user\n // popup selection.\n let lastBatchIsHost = false;\n\n const removalPlugin = new Plugin({\n key: new PluginKey(`${name}_removal`),\n appendTransaction(transactions) {\n lastBatchIsHost = transactions.some((tr) => isHostOrigin(tr));\n return null;\n },\n view: () => ({\n update(view, prevState) {\n if (view.state.doc === prevState.doc || lastBatchIsHost) {\n return;\n }\n const removed = diffRemovedTokens(\n prevState.doc,\n view.state.doc,\n name\n );\n for (const item of removed) {\n onRemove(item);\n }\n },\n }),\n });\n\n return [...parentPlugins, removalPlugin];\n },\n }).configure({\n HTMLAttributes: { 'data-token-type': name },\n suggestion: {\n char: config.trigger,\n pluginKey,\n startOfLine: config.triggerPosition === 'start',\n render: () => {\n let lastQuery: string | null = null;\n return {\n onStart: (props) =>\n emitTrigger(props.editor, name, props.query, props.range, () => {\n lastQuery = props.query;\n }),\n onUpdate: (props) => {\n if (props.query === lastQuery) {\n return;\n }\n lastQuery = props.query;\n emitTrigger(props.editor, name, props.query, props.range);\n },\n onExit: (props) => {\n lastQuery = null;\n dispatchTriggerChange(props.editor, null, name);\n },\n onKeyDown: () => false,\n };\n },\n },\n });\n}\n\nfunction emitTrigger(\n editor: Editor,\n type: string,\n query: string,\n range: Range,\n postEmit?: () => void\n): void {\n dispatchTriggerChange(editor, {\n type,\n query,\n triggerOffset: range.from,\n });\n postEmit?.();\n}\n\n/**\n * Collect the attrs of every node named `name` in `doc`, grouped by id and\n * kept in document order, so a multiset diff can tell which specific node\n * instances were removed (duplicate chips with the same id are tracked by\n * count, not collapsed).\n */\nfunction collectTokenAttrsById(\n doc: PMNode,\n name: string\n): Map<string, Record<string, unknown>[]> {\n const byId = new Map<string, Record<string, unknown>[]>();\n doc.descendants((node) => {\n if (node.type.name !== name) {\n return;\n }\n const attrs = node.attrs as Record<string, unknown>;\n const id = String(attrs.id);\n const bucket = byId.get(id);\n if (bucket) {\n bucket.push(attrs);\n } else {\n byId.set(id, [attrs]);\n }\n });\n return byId;\n}\n\n/**\n * Reconstruct a {@link SuggestionItem} from a removed token node's attrs.\n * Presentation-only fields were stripped at insert time, so only `id`,\n * `label`, `value`, and any custom fields stashed in `data` survive.\n */\nfunction attrsToItem(attrs: Record<string, unknown>): SuggestionItem {\n // `data` holds whatever a caller put in the node's attrs, and\n // `insertContent()` takes a raw node spec — so a host can land a string or\n // an array here. Spreading either yields index keys ({...'abc'} → {0:'a'}),\n // which would then reach onRemove as if the host had set them.\n const raw = attrs.data;\n const data =\n raw && typeof raw === 'object' && !Array.isArray(raw)\n ? (raw as Record<string, unknown>)\n : {};\n return {\n ...data,\n id: String(attrs.id),\n label: attrs.label as string,\n value: (attrs.value ?? undefined) as string | undefined,\n };\n}\n\n/**\n * Diff token nodes named `name` between `before` and `after`, returning the\n * reconstructed items for each removed node instance (one entry per removed\n * duplicate).\n */\nfunction diffRemovedTokens(\n before: PMNode,\n after: PMNode,\n name: string\n): SuggestionItem[] {\n const beforeById = collectTokenAttrsById(before, name);\n const afterById = collectTokenAttrsById(after, name);\n const removed: SuggestionItem[] = [];\n for (const [id, beforeAttrs] of beforeById) {\n const afterCount = afterById.get(id)?.length ?? 0;\n for (let i = afterCount; i < beforeAttrs.length; i += 1) {\n removed.push(attrsToItem(beforeAttrs[i]));\n }\n }\n return removed;\n}\n\n/**\n * Resolve whether a selected item's chip should be prefixed with the\n * trigger character: the item's own {@link SuggestionItem.showTriggerInChip}\n * wins when set, then the config's\n * {@link TriggerSuggestionConfig.showTriggerInChip}, then the\n * command/mention default.\n */\nexport function resolveShowTriggerInChip(\n item: SuggestionItem,\n config: Pick<TriggerSuggestionConfig, 'showTriggerInChip'>,\n isCommand: boolean\n): boolean {\n return item.showTriggerInChip ?? config.showTriggerInChip ?? isCommand;\n}\n\nexport function carbonMention(config: TriggerSuggestionConfig) {\n return buildTriggerExtension(config, {\n defaultName: 'mention',\n defaultPluginKeyName: 'carbonMentionSuggestion',\n });\n}\n\nexport function carbonCommand(config: TriggerSuggestionConfig) {\n return buildTriggerExtension(config, {\n defaultName: 'command',\n defaultPluginKeyName: 'carbonCommandSuggestion',\n });\n}\n"],"names":[],"mappings":"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"}
@@ -12,13 +12,12 @@
12
12
  * bridge extension (per PLAN.md decision 4) — each factory calls this helper
13
13
  * from its own `onStart`/`onUpdate`/`onExit` callbacks.
14
14
  *
15
- * **Concurrent transitions:** if two factories transition in the same
16
- * transaction (rare — would require a host-driven setContent that crosses
17
- * two trigger contexts), each emits independently and listeners observe a
18
- * sequence of detail values. Consumers tracking "current trigger" stay
19
- * correct because the final `onStart`/`onUpdate` wins; `onExit` listeners
20
- * receive a `null` between the two activations only if the previous trigger's
21
- * range was actually exited.
15
+ * **Concurrent transitions:** when two factories transition in the same
16
+ * synchronous turn (e.g. autocomplete exits while mention starts), plugin
17
+ * view updates run in extension-registration order. The later `onExit`
18
+ * (dispatching `null`) must not overwrite the earlier `onStart` from a
19
+ * different plugin. Pass `exitingType` when calling with `null` so the helper
20
+ * can detect and suppress that stale exit.
22
21
  */
23
22
  import type { Editor } from '@tiptap/core';
24
23
  import type { TriggerChangeEventDetail } from './types.js';
@@ -26,8 +25,13 @@ import type { TriggerChangeEventDetail } from './types.js';
26
25
  * Dispatch `cds-custom-aichat-trigger-change` on the editor's DOM if the detail has
27
26
  * changed since the last call for the same editor. No-op transitions are
28
27
  * coalesced.
28
+ *
29
+ * When `detail` is `null` (an `onExit` call), pass `exitingType` so the
30
+ * helper can suppress the exit if another plugin already claimed the trigger
31
+ * in the same synchronous turn — preventing a late `onExit` from overwriting
32
+ * an earlier `onStart` from a different extension.
29
33
  */
30
- export declare function dispatchTriggerChange(editor: Editor, detail: TriggerChangeEventDetail | null): void;
34
+ export declare function dispatchTriggerChange(editor: Editor, detail: TriggerChangeEventDetail | null, exitingType?: string): void;
31
35
  /**
32
36
  * Reset the coalescing state for an editor. Call this when the controller
33
37
  * dismisses a trigger externally (not via the extension) so that the next
@@ -18,9 +18,24 @@ const lastDetailByEditor = new WeakMap();
18
18
  * Dispatch `cds-custom-aichat-trigger-change` on the editor's DOM if the detail has
19
19
  * changed since the last call for the same editor. No-op transitions are
20
20
  * coalesced.
21
+ *
22
+ * When `detail` is `null` (an `onExit` call), pass `exitingType` so the
23
+ * helper can suppress the exit if another plugin already claimed the trigger
24
+ * in the same synchronous turn — preventing a late `onExit` from overwriting
25
+ * an earlier `onStart` from a different extension.
21
26
  */
22
- function dispatchTriggerChange(editor, detail) {
27
+ function dispatchTriggerChange(editor, detail, exitingType) {
23
28
  const previous = lastDetailByEditor.get(editor) ?? null;
29
+ // Suppress a null dispatch when a different plugin already activated in this
30
+ // turn — its onStart updated lastDetail to a non-null value with a different
31
+ // type, so this onExit is stale.
32
+ const isStaleExit = detail === null &&
33
+ exitingType !== undefined &&
34
+ previous !== null &&
35
+ previous.type !== exitingType;
36
+ if (isStaleExit) {
37
+ return;
38
+ }
24
39
  if (areDetailsEqual(previous, detail)) {
25
40
  return;
26
41
  }
@@ -1 +1 @@
1
- {"version":3,"file":"trigger-utils.js","sources":["../../../../../src/components/prompt-line/src/tiptap/trigger-utils.ts"],"sourcesContent":["/**\n * @license\n *\n * Copyright IBM Corp. 2026\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n/**\n * Shared helper for the carbon factories' suggestion-render lifecycles to\n * dispatch `cds-custom-aichat-trigger-change` events directly. There is no central\n * bridge extension (per PLAN.md decision 4) — each factory calls this helper\n * from its own `onStart`/`onUpdate`/`onExit` callbacks.\n *\n * **Concurrent transitions:** if two factories transition in the same\n * transaction (rare — would require a host-driven setContent that crosses\n * two trigger contexts), each emits independently and listeners observe a\n * sequence of detail values. Consumers tracking \"current trigger\" stay\n * correct because the final `onStart`/`onUpdate` wins; `onExit` listeners\n * receive a `null` between the two activations only if the previous trigger's\n * range was actually exited.\n */\n\nimport type { Editor } from '@tiptap/core';\n\nimport type { TriggerChangeEventDetail } from './types.js';\n\nconst lastDetailByEditor = new WeakMap<\n Editor,\n TriggerChangeEventDetail | null\n>();\n\n/**\n * Dispatch `cds-custom-aichat-trigger-change` on the editor's DOM if the detail has\n * changed since the last call for the same editor. No-op transitions are\n * coalesced.\n */\nexport function dispatchTriggerChange(\n editor: Editor,\n detail: TriggerChangeEventDetail | null\n): void {\n const previous = lastDetailByEditor.get(editor) ?? null;\n if (areDetailsEqual(previous, detail)) {\n return;\n }\n lastDetailByEditor.set(editor, detail);\n editor.view.dom.dispatchEvent(\n new CustomEvent('cds-custom-aichat-trigger-change', {\n detail,\n bubbles: true,\n composed: true,\n })\n );\n}\n\n/**\n * Reset the coalescing state for an editor. Call this when the controller\n * dismisses a trigger externally (not via the extension) so that the next\n * `dispatchTriggerChange` call for the same detail re-dispatches instead of\n * being swallowed as a no-op.\n */\nexport function resetTriggerChangeState(editor: Editor): void {\n lastDetailByEditor.delete(editor);\n}\n\nfunction areDetailsEqual(\n a: TriggerChangeEventDetail | null,\n b: TriggerChangeEventDetail | null\n): boolean {\n if (a === null || b === null) {\n return a === b;\n }\n return (\n a.type === b.type &&\n a.query === b.query &&\n a.triggerOffset === b.triggerOffset\n );\n}\n"],"names":[],"mappings":";;;;;;;AAAA;;;;;;;AAOG;AAqBH,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAGnC;AAEH;;;;AAIG;AACG,SAAU,qBAAqB,CACnC,MAAc,EACd,MAAuC,EAAA;IAEvC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI;AACvD,IAAA,IAAI,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;QACrC;IACF;AACA,IAAA,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IACtC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAC3B,IAAI,WAAW,CAAC,2BAA2B,EAAE;QAC3C,MAAM;AACN,QAAA,OAAO,EAAE,IAAI;AACb,QAAA,QAAQ,EAAE,IAAI;AACf,KAAA,CAAC,CACH;AACH;AAEA;;;;;AAKG;AACG,SAAU,uBAAuB,CAAC,MAAc,EAAA;AACpD,IAAA,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC;AACnC;AAEA,SAAS,eAAe,CACtB,CAAkC,EAClC,CAAkC,EAAA;IAElC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE;QAC5B,OAAO,CAAC,KAAK,CAAC;IAChB;AACA,IAAA,QACE,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;AACjB,QAAA,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;AACnB,QAAA,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,aAAa;AAEvC;;"}
1
+ {"version":3,"file":"trigger-utils.js","sources":["../../../../../src/components/prompt-line/src/tiptap/trigger-utils.ts"],"sourcesContent":["/**\n * @license\n *\n * Copyright IBM Corp. 2026\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n/**\n * Shared helper for the carbon factories' suggestion-render lifecycles to\n * dispatch `cds-custom-aichat-trigger-change` events directly. There is no central\n * bridge extension (per PLAN.md decision 4) — each factory calls this helper\n * from its own `onStart`/`onUpdate`/`onExit` callbacks.\n *\n * **Concurrent transitions:** when two factories transition in the same\n * synchronous turn (e.g. autocomplete exits while mention starts), plugin\n * view updates run in extension-registration order. The later `onExit`\n * (dispatching `null`) must not overwrite the earlier `onStart` from a\n * different plugin. Pass `exitingType` when calling with `null` so the helper\n * can detect and suppress that stale exit.\n */\n\nimport type { Editor } from '@tiptap/core';\n\nimport type { TriggerChangeEventDetail } from './types.js';\n\nconst lastDetailByEditor = new WeakMap<\n Editor,\n TriggerChangeEventDetail | null\n>();\n\n/**\n * Dispatch `cds-custom-aichat-trigger-change` on the editor's DOM if the detail has\n * changed since the last call for the same editor. No-op transitions are\n * coalesced.\n *\n * When `detail` is `null` (an `onExit` call), pass `exitingType` so the\n * helper can suppress the exit if another plugin already claimed the trigger\n * in the same synchronous turn — preventing a late `onExit` from overwriting\n * an earlier `onStart` from a different extension.\n */\nexport function dispatchTriggerChange(\n editor: Editor,\n detail: TriggerChangeEventDetail | null,\n exitingType?: string\n): void {\n const previous = lastDetailByEditor.get(editor) ?? null;\n // Suppress a null dispatch when a different plugin already activated in this\n // turn — its onStart updated lastDetail to a non-null value with a different\n // type, so this onExit is stale.\n const isStaleExit =\n detail === null &&\n exitingType !== undefined &&\n previous !== null &&\n previous.type !== exitingType;\n if (isStaleExit) {\n return;\n }\n if (areDetailsEqual(previous, detail)) {\n return;\n }\n lastDetailByEditor.set(editor, detail);\n editor.view.dom.dispatchEvent(\n new CustomEvent('cds-custom-aichat-trigger-change', {\n detail,\n bubbles: true,\n composed: true,\n })\n );\n}\n\n/**\n * Reset the coalescing state for an editor. Call this when the controller\n * dismisses a trigger externally (not via the extension) so that the next\n * `dispatchTriggerChange` call for the same detail re-dispatches instead of\n * being swallowed as a no-op.\n */\nexport function resetTriggerChangeState(editor: Editor): void {\n lastDetailByEditor.delete(editor);\n}\n\nfunction areDetailsEqual(\n a: TriggerChangeEventDetail | null,\n b: TriggerChangeEventDetail | null\n): boolean {\n if (a === null || b === null) {\n return a === b;\n }\n return (\n a.type === b.type &&\n a.query === b.query &&\n a.triggerOffset === b.triggerOffset\n );\n}\n"],"names":[],"mappings":";;;;;;;AAAA;;;;;;;AAOG;AAoBH,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAGnC;AAEH;;;;;;;;;AASG;SACa,qBAAqB,CACnC,MAAc,EACd,MAAuC,EACvC,WAAoB,EAAA;IAEpB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI;;;;AAIvD,IAAA,MAAM,WAAW,GACf,MAAM,KAAK,IAAI;AACf,QAAA,WAAW,KAAK,SAAS;AACzB,QAAA,QAAQ,KAAK,IAAI;AACjB,QAAA,QAAQ,CAAC,IAAI,KAAK,WAAW;IAC/B,IAAI,WAAW,EAAE;QACf;IACF;AACA,IAAA,IAAI,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;QACrC;IACF;AACA,IAAA,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IACtC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAC3B,IAAI,WAAW,CAAC,2BAA2B,EAAE;QAC3C,MAAM;AACN,QAAA,OAAO,EAAE,IAAI;AACb,QAAA,QAAQ,EAAE,IAAI;AACf,KAAA,CAAC,CACH;AACH;AAEA;;;;;AAKG;AACG,SAAU,uBAAuB,CAAC,MAAc,EAAA;AACpD,IAAA,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC;AACnC;AAEA,SAAS,eAAe,CACtB,CAAkC,EAClC,CAAkC,EAAA;IAElC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE;QAC5B,OAAO,CAAC,KAAK,CAAC;IAChB;AACA,IAAA,QACE,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;AACjB,QAAA,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;AACnB,QAAA,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,aAAa;AAEvC;;"}
@@ -42,5 +42,10 @@ export interface UseChatAutocompleteResult {
42
42
  * `null` while no trigger is active.
43
43
  */
44
44
  autocompleteContent: ReactNode;
45
+ /**
46
+ * `true` while the user has navigated into the autocomplete list with arrow
47
+ * keys. Use to disable the prompt send button while a list item is active.
48
+ */
49
+ isListNavigated: boolean;
45
50
  }
46
51
  export declare function useChatAutocomplete(options: UseChatAutocompleteOptions): UseChatAutocompleteResult;
@@ -17,6 +17,7 @@ function useChatAutocomplete(options) {
17
17
  trigger: null,
18
18
  items: [],
19
19
  });
20
+ const [isListNavigated, setIsListNavigated] = React.useState(false);
20
21
  // Keep the controller stable for the hook's lifetime — set in a layout
21
22
  // effect so it's wired before any event handler can fire.
22
23
  const controllerRef = React.useRef(null);
@@ -84,7 +85,13 @@ function useChatAutocomplete(options) {
84
85
  // Register / unregister the rendered list element with the controller so
85
86
  // arrow / Enter / Escape on the editor DOM get forwarded to it.
86
87
  // Also set the max-height CSS variable if provided.
88
+ const navigatedListenerRef = React.useRef(null);
87
89
  const setListElement = React.useCallback((el) => {
90
+ // Remove the previous navigation listener before swapping elements.
91
+ if (navigatedListenerRef.current) {
92
+ navigatedListenerRef.current.el.removeEventListener('cds-custom-aichat-autocomplete-navigated', navigatedListenerRef.current.handler);
93
+ navigatedListenerRef.current = null;
94
+ }
88
95
  controllerRef.current?.setListElement(el);
89
96
  // Pass the editor DOM as anchorElement so outside-click detection on the
90
97
  // autocomplete element doesn't dismiss the list when the user clicks the
@@ -96,6 +103,24 @@ function useChatAutocomplete(options) {
96
103
  if (el && maxHeight) {
97
104
  el.style.setProperty('--cds-aichat-autocomplete-max-height', maxHeight);
98
105
  }
106
+ if (el) {
107
+ const handler = (e) => {
108
+ setIsListNavigated(e.detail
109
+ .navigated);
110
+ };
111
+ el.addEventListener('cds-custom-aichat-autocomplete-navigated', handler);
112
+ navigatedListenerRef.current = { el, handler };
113
+ }
114
+ else {
115
+ setIsListNavigated(false);
116
+ // Fire a synthetic clear event on the prompt-line's shell ancestor so
117
+ // the send-control's internal guard (`_autocompleteListNavigated`) also
118
+ // resets. This covers cases where the list is removed from the DOM
119
+ // without the autocomplete element dispatching its own clear event
120
+ // (e.g. the user deletes the trigger character).
121
+ const shell = promptLineRef.current?.closest('cds-custom-aichat-prompt-line-shell');
122
+ shell?.dispatchEvent(new CustomEvent('cds-custom-aichat-autocomplete-navigated', { detail: { navigated: false }, bubbles: false, composed: false }));
123
+ }
99
124
  }, [maxHeight, promptLineRef]);
100
125
  // Prevent mousedown on the autocomplete container from stealing focus from
101
126
  // the editor.
@@ -133,7 +158,7 @@ function useChatAutocomplete(options) {
133
158
  attached,
134
159
  handleContainerMousedown,
135
160
  ]);
136
- return { onTriggerChange, autocompleteContent };
161
+ return { onTriggerChange, autocompleteContent, isListNavigated };
137
162
  }
138
163
  /** Mounts a host-provided HTMLElement into the React tree at `slot`. */
139
164
  function CustomElementHost({ slot, element, onMount, onMousedown, }) {
@@ -1 +1 @@
1
- {"version":3,"file":"useChatAutocomplete.js","sources":["../../../src/react/hooks/useChatAutocomplete.tsx"],"sourcesContent":["/**\n * @license\n *\n * Copyright IBM Corp. 2026\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n/**\n * React hook for the chat-input autocomplete overlay. Thin wrapper around\n * the framework-agnostic `AutocompleteController` in\n * [../../components/prompt-line/src/autocomplete-controller.ts]. That module\n * holds no Lit and registers no custom element, so reaching the controller\n * costs this hook neither. It still loads `<cds-custom-aichat-autocomplete>` — it\n * renders that list itself — but never\n * `<cds-custom-aichat-autocomplete-controller>`, the other surface on the same\n * class. The controller owns\n * trigger handling, async resolution, and selection routing; this hook\n * adapts those callbacks into React state and returns a JSX node to slot\n * into `<PromptLineShell>`.\n */\n\nimport React from 'react';\nimport ReactDOM from 'react-dom';\nimport type { JSX, ReactNode, RefObject } from 'react';\n\nimport Autocomplete from '../autocomplete.js';\nimport type PromptLineElement from '../../components/prompt-line/src/prompt-line.js';\nimport {\n AutocompleteController,\n itemsToGroups,\n type AutocompleteControllerState,\n} from '../../components/prompt-line/src/autocomplete-controller.js';\nimport type {\n AutocompleteConfig,\n StartersConfig,\n SuggestionItem,\n TriggerChangeEventDetail,\n TriggerSuggestionConfig,\n} from '../../components/prompt-line/src/tiptap/types.js';\n\nexport interface UseChatAutocompleteOptions {\n mention?: TriggerSuggestionConfig;\n command?: TriggerSuggestionConfig;\n autocomplete?: AutocompleteConfig;\n starters?: StartersConfig;\n /** Ref to the slotted `<cds-custom-aichat-prompt-line>`. */\n promptLineRef: RefObject<PromptLineElement | null>;\n /** When true, starter selection inserts the text but does not auto-send. */\n isSendDisabled?: boolean;\n /** Fired after a starter is selected and inserted (used to trigger send). */\n onStarterSelected?: (text: string) => void;\n /**\n * Fired when an autocomplete suggestion item is selected.\n * Called after the controller has already inserted the item.\n */\n onSelectItem?: (item: SuggestionItem) => void;\n /**\n * Fired when the send button inside an autocomplete suggestion item is clicked.\n */\n onSendItem?: (text: string) => void;\n /** Whether the autocomplete is attached to the input (affects corner rounding). */\n attached?: boolean;\n /** Maximum height for the autocomplete popover */\n maxHeight?: string;\n}\n\nexport interface UseChatAutocompleteResult {\n /** Attach to `<PromptLine onTriggerChange={...} />`. */\n onTriggerChange: (\n event: CustomEvent<TriggerChangeEventDetail | null>\n ) => void;\n /**\n * JSX to render with `slot=\"autocomplete-content\"` inside `<PromptLineShell>`.\n * `null` while no trigger is active.\n */\n autocompleteContent: ReactNode;\n}\n\nexport function useChatAutocomplete(\n options: UseChatAutocompleteOptions\n): UseChatAutocompleteResult {\n const {\n mention,\n command,\n autocomplete,\n starters,\n promptLineRef,\n isSendDisabled,\n onStarterSelected,\n onSelectItem,\n onSendItem,\n attached = true,\n maxHeight,\n } = options;\n\n const [state, setState] = React.useState<AutocompleteControllerState>({\n trigger: null,\n items: [],\n });\n\n // Keep the controller stable for the hook's lifetime — set in a layout\n // effect so it's wired before any event handler can fire.\n const controllerRef = React.useRef<AutocompleteController | null>(null);\n // Latest config / callback values; the controller stores its own copies\n // but reading them out of refs avoids re-instantiation churn.\n const onStarterRef = React.useRef(onStarterSelected);\n onStarterRef.current = onStarterSelected;\n const onSelectItemRef = React.useRef(onSelectItem);\n onSelectItemRef.current = onSelectItem;\n const onSendItemRef = React.useRef(onSendItem);\n onSendItemRef.current = onSendItem;\n\n if (!controllerRef.current) {\n controllerRef.current = new AutocompleteController({\n mention,\n command,\n autocomplete,\n starters,\n isSendDisabled,\n onStarterSelected: (text) => onStarterRef.current?.(text),\n onChange: setState,\n });\n }\n\n // Push prop changes into the controller without recreating it.\n React.useEffect(() => {\n controllerRef.current?.setConfigs({\n mention,\n command,\n autocomplete,\n starters,\n isSendDisabled,\n });\n }, [mention, command, autocomplete, starters, isSendDisabled]);\n\n // Keep the controller pointed at the live prompt-line element.\n React.useEffect(() => {\n controllerRef.current?.setPromptLine(promptLineRef.current);\n });\n\n React.useEffect(() => {\n return () => {\n controllerRef.current?.destroy();\n controllerRef.current = null;\n };\n }, []);\n\n const onTriggerChange = React.useCallback(\n (event: CustomEvent<TriggerChangeEventDetail | null>) => {\n // Pin the controller to the current prompt-line ref before handing\n // off the detail — the React caller's ref is authoritative.\n controllerRef.current?.setPromptLine(promptLineRef.current);\n controllerRef.current?.handleTriggerChange(event.detail ?? null);\n },\n [promptLineRef]\n );\n\n const handleSelect = React.useCallback((item: SuggestionItem) => {\n controllerRef.current?.select(item);\n onSelectItemRef.current?.(item);\n }, []);\n\n const isSendDisabledRef = React.useRef(isSendDisabled);\n isSendDisabledRef.current = isSendDisabled;\n\n const handleSend = React.useCallback((text: string) => {\n if (!text || isSendDisabledRef.current) {\n return;\n }\n controllerRef.current?.dismiss(true);\n onSendItemRef.current?.(text);\n }, []);\n\n const dismiss = React.useCallback(() => {\n controllerRef.current?.dismiss();\n }, []);\n\n // Register / unregister the rendered list element with the controller so\n // arrow / Enter / Escape on the editor DOM get forwarded to it.\n // Also set the max-height CSS variable if provided.\n const setListElement = React.useCallback(\n (el: HTMLElement | null) => {\n controllerRef.current?.setListElement(el);\n // Pass the editor DOM as anchorElement so outside-click detection on the\n // autocomplete element doesn't dismiss the list when the user clicks the\n // editor (the editor is not inside the autocomplete element).\n if (el && 'anchorElement' in el) {\n (el as HTMLElement & { anchorElement: Element | null }).anchorElement =\n promptLineRef.current?.getEditor?.()?.view.dom ?? null;\n }\n if (el && maxHeight) {\n el.style.setProperty('--cds-aichat-autocomplete-max-height', maxHeight);\n }\n },\n [maxHeight, promptLineRef]\n );\n\n // Prevent mousedown on the autocomplete container from stealing focus from\n // the editor.\n const handleContainerMousedown = React.useCallback(\n (e: Event | React.MouseEvent) => {\n e.preventDefault();\n },\n []\n );\n\n const autocompleteContent = React.useMemo<ReactNode>(() => {\n if (!state.trigger || state.items.length === 0) {\n return null;\n }\n const { items: flatItems, groups } = itemsToGroups(state.items);\n if (state.renderCustomList) {\n const result = state.renderCustomList({\n items: state.items,\n query: state.trigger.query,\n onDismiss: dismiss,\n onSelect: handleSelect,\n onSend: handleSend,\n });\n if (result == null) {\n return null;\n }\n if (result instanceof HTMLElement) {\n return (\n <CustomElementHost\n slot=\"autocomplete-content\"\n element={result}\n onMount={setListElement}\n onMousedown={handleContainerMousedown}\n />\n );\n }\n return (\n <CustomReactNodePortal\n slot=\"autocomplete-content\"\n node={result as ReactNode}\n onMount={setListElement}\n onMousedown={handleContainerMousedown}\n />\n );\n }\n return (\n <Autocomplete\n ref={setListElement}\n slot=\"autocomplete-content\"\n items={flatItems}\n groups={groups}\n attached={attached}\n disableDirectSend={state.disableDirectSend}\n onDismiss={dismiss}\n onSelect={(e: CustomEvent<{ item: SuggestionItem }>) =>\n handleSelect(e.detail.item)\n }\n onSend={(e: CustomEvent<{ text: string }>) =>\n handleSend(e.detail?.text)\n }\n />\n );\n }, [\n state,\n handleSelect,\n handleSend,\n dismiss,\n setListElement,\n attached,\n handleContainerMousedown,\n ]);\n\n return { onTriggerChange, autocompleteContent };\n}\n\ninterface CustomElementHostProps {\n slot: string;\n element: HTMLElement;\n /** Notify the parent which element is the key-forwarding target. */\n onMount?: (el: HTMLElement | null) => void;\n onMousedown?: (e: React.MouseEvent) => void;\n}\n\n/** Mounts a host-provided HTMLElement into the React tree at `slot`. */\nfunction CustomElementHost({\n slot,\n element,\n onMount,\n onMousedown,\n}: CustomElementHostProps): JSX.Element {\n const containerRef = React.useRef<HTMLDivElement | null>(null);\n React.useEffect(() => {\n const container = containerRef.current;\n if (!container) {\n return undefined;\n }\n container.appendChild(element);\n onMount?.(element);\n return () => {\n onMount?.(null);\n if (element.parentNode === container) {\n container.removeChild(element);\n }\n };\n }, [element, onMount]);\n return (\n <div\n ref={containerRef}\n role=\"presentation\"\n slot={slot}\n onMouseDown={onMousedown}\n />\n );\n}\n\ninterface CustomReactNodePortalProps {\n slot: string;\n node: ReactNode;\n onMount?: (el: HTMLElement | null) => void;\n onMousedown?: (e: MouseEvent) => void;\n}\n\nlet autocompletePortalCounter = 0;\n\n/**\n * Projects a consumer-supplied React node into the page's light DOM via a\n * two-level slot/host pair so external `<style>` tags reach it. The rendered\n * `<div>` is a slot-projected anchor in the shell's `autocomplete-content`\n * slot; a sibling `<div slot=\"…\">` is appended to the chatWrapper (the host\n * of the surrounding shadow root) and receives the React node via\n * `createPortal`. Without this hop the node would mount inside the chat's\n * shadow root, hidden from page CSS.\n */\nfunction CustomReactNodePortal({\n slot,\n node,\n onMount,\n onMousedown,\n}: CustomReactNodePortalProps): JSX.Element {\n const containerRef = React.useRef<HTMLDivElement | null>(null);\n const [hostElement, setHostElement] = React.useState<HTMLElement | null>(\n null\n );\n\n React.useEffect(() => {\n const container = containerRef.current;\n if (!container) {\n return undefined;\n }\n const rootNode = container.getRootNode();\n const chatWrapper =\n rootNode instanceof ShadowRoot ? (rootNode.host as HTMLElement) : null;\n if (!chatWrapper) {\n return undefined;\n }\n\n const slotName = `cds-custom-aichat-autocomplete-${++autocompletePortalCounter}`;\n const slotEl = document.createElement('slot');\n slotEl.setAttribute('name', slotName);\n container.appendChild(slotEl);\n\n const hostEl = document.createElement('div');\n hostEl.setAttribute('slot', slotName);\n if (onMousedown) {\n hostEl.addEventListener('mousedown', onMousedown);\n }\n chatWrapper.appendChild(hostEl);\n\n setHostElement(hostEl);\n return () => {\n onMount?.(null);\n if (onMousedown) {\n hostEl.removeEventListener('mousedown', onMousedown);\n }\n slotEl.remove();\n hostEl.remove();\n setHostElement(null);\n };\n // Empty deps: the slot/host pair is owned by this mount cycle and should\n // not churn as `node` updates — React's portal reconciliation handles\n // those updates in place.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, []);\n\n // After the portal content is committed into hostElement, hand the first\n // child element to the controller. This is typically a custom element (e.g.\n // <cds-custom-aichat-autocomplete>) whose properties (anchorElement, keydown\n // forwarding) only work on the element itself — not on the plain <div>\n // wrapper that createPortal renders into. Custom elements are defined\n // synchronously at module load, so by the time useEffect fires (post-paint)\n // the element is fully upgraded and its properties are available.\n React.useEffect(() => {\n if (!hostElement) {\n return;\n }\n const child = hostElement.firstElementChild as HTMLElement | null;\n onMount?.(child ?? hostElement);\n }, [hostElement, onMount]);\n\n return (\n <div slot={slot} ref={containerRef}>\n {hostElement ? ReactDOM.createPortal(node, hostElement) : null}\n </div>\n );\n}\n"],"names":["_jsx","Autocomplete"],"mappings":"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"}
1
+ {"version":3,"file":"useChatAutocomplete.js","sources":["../../../src/react/hooks/useChatAutocomplete.tsx"],"sourcesContent":["/**\n * @license\n *\n * Copyright IBM Corp. 2026\n *\n * This source code is licensed under the Apache-2.0 license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n/**\n * React hook for the chat-input autocomplete overlay. Thin wrapper around\n * the framework-agnostic `AutocompleteController` in\n * [../../components/prompt-line/src/autocomplete-controller.ts]. That module\n * holds no Lit and registers no custom element, so reaching the controller\n * costs this hook neither. It still loads `<cds-custom-aichat-autocomplete>` — it\n * renders that list itself — but never\n * `<cds-custom-aichat-autocomplete-controller>`, the other surface on the same\n * class. The controller owns\n * trigger handling, async resolution, and selection routing; this hook\n * adapts those callbacks into React state and returns a JSX node to slot\n * into `<PromptLineShell>`.\n */\n\nimport React from 'react';\nimport ReactDOM from 'react-dom';\nimport type { JSX, ReactNode, RefObject } from 'react';\n\nimport Autocomplete from '../autocomplete.js';\nimport type PromptLineElement from '../../components/prompt-line/src/prompt-line.js';\nimport {\n AutocompleteController,\n itemsToGroups,\n type AutocompleteControllerState,\n} from '../../components/prompt-line/src/autocomplete-controller.js';\nimport type { AutocompleteNavigatedEventDetail } from '../../components/prompt-line/autocomplete/src/autocomplete.js';\nimport type {\n AutocompleteConfig,\n StartersConfig,\n SuggestionItem,\n TriggerChangeEventDetail,\n TriggerSuggestionConfig,\n} from '../../components/prompt-line/src/tiptap/types.js';\n\nexport interface UseChatAutocompleteOptions {\n mention?: TriggerSuggestionConfig;\n command?: TriggerSuggestionConfig;\n autocomplete?: AutocompleteConfig;\n starters?: StartersConfig;\n /** Ref to the slotted `<cds-custom-aichat-prompt-line>`. */\n promptLineRef: RefObject<PromptLineElement | null>;\n /** When true, starter selection inserts the text but does not auto-send. */\n isSendDisabled?: boolean;\n /** Fired after a starter is selected and inserted (used to trigger send). */\n onStarterSelected?: (text: string) => void;\n /**\n * Fired when an autocomplete suggestion item is selected.\n * Called after the controller has already inserted the item.\n */\n onSelectItem?: (item: SuggestionItem) => void;\n /**\n * Fired when the send button inside an autocomplete suggestion item is clicked.\n */\n onSendItem?: (text: string) => void;\n /** Whether the autocomplete is attached to the input (affects corner rounding). */\n attached?: boolean;\n /** Maximum height for the autocomplete popover */\n maxHeight?: string;\n}\n\nexport interface UseChatAutocompleteResult {\n /** Attach to `<PromptLine onTriggerChange={...} />`. */\n onTriggerChange: (\n event: CustomEvent<TriggerChangeEventDetail | null>\n ) => void;\n /**\n * JSX to render with `slot=\"autocomplete-content\"` inside `<PromptLineShell>`.\n * `null` while no trigger is active.\n */\n autocompleteContent: ReactNode;\n /**\n * `true` while the user has navigated into the autocomplete list with arrow\n * keys. Use to disable the prompt send button while a list item is active.\n */\n isListNavigated: boolean;\n}\n\nexport function useChatAutocomplete(\n options: UseChatAutocompleteOptions\n): UseChatAutocompleteResult {\n const {\n mention,\n command,\n autocomplete,\n starters,\n promptLineRef,\n isSendDisabled,\n onStarterSelected,\n onSelectItem,\n onSendItem,\n attached = true,\n maxHeight,\n } = options;\n\n const [state, setState] = React.useState<AutocompleteControllerState>({\n trigger: null,\n items: [],\n });\n\n const [isListNavigated, setIsListNavigated] = React.useState(false);\n\n // Keep the controller stable for the hook's lifetime — set in a layout\n // effect so it's wired before any event handler can fire.\n const controllerRef = React.useRef<AutocompleteController | null>(null);\n // Latest config / callback values; the controller stores its own copies\n // but reading them out of refs avoids re-instantiation churn.\n const onStarterRef = React.useRef(onStarterSelected);\n onStarterRef.current = onStarterSelected;\n const onSelectItemRef = React.useRef(onSelectItem);\n onSelectItemRef.current = onSelectItem;\n const onSendItemRef = React.useRef(onSendItem);\n onSendItemRef.current = onSendItem;\n\n if (!controllerRef.current) {\n controllerRef.current = new AutocompleteController({\n mention,\n command,\n autocomplete,\n starters,\n isSendDisabled,\n onStarterSelected: (text) => onStarterRef.current?.(text),\n onChange: setState,\n });\n }\n\n // Push prop changes into the controller without recreating it.\n React.useEffect(() => {\n controllerRef.current?.setConfigs({\n mention,\n command,\n autocomplete,\n starters,\n isSendDisabled,\n });\n }, [mention, command, autocomplete, starters, isSendDisabled]);\n\n // Keep the controller pointed at the live prompt-line element.\n React.useEffect(() => {\n controllerRef.current?.setPromptLine(promptLineRef.current);\n });\n\n React.useEffect(() => {\n return () => {\n controllerRef.current?.destroy();\n controllerRef.current = null;\n };\n }, []);\n\n const onTriggerChange = React.useCallback(\n (event: CustomEvent<TriggerChangeEventDetail | null>) => {\n // Pin the controller to the current prompt-line ref before handing\n // off the detail — the React caller's ref is authoritative.\n controllerRef.current?.setPromptLine(promptLineRef.current);\n controllerRef.current?.handleTriggerChange(event.detail ?? null);\n },\n [promptLineRef]\n );\n\n const handleSelect = React.useCallback((item: SuggestionItem) => {\n controllerRef.current?.select(item);\n onSelectItemRef.current?.(item);\n }, []);\n\n const isSendDisabledRef = React.useRef(isSendDisabled);\n isSendDisabledRef.current = isSendDisabled;\n\n const handleSend = React.useCallback((text: string) => {\n if (!text || isSendDisabledRef.current) {\n return;\n }\n controllerRef.current?.dismiss(true);\n onSendItemRef.current?.(text);\n }, []);\n\n const dismiss = React.useCallback(() => {\n controllerRef.current?.dismiss();\n }, []);\n\n // Register / unregister the rendered list element with the controller so\n // arrow / Enter / Escape on the editor DOM get forwarded to it.\n // Also set the max-height CSS variable if provided.\n const navigatedListenerRef = React.useRef<{\n el: HTMLElement;\n handler: (e: Event) => void;\n } | null>(null);\n\n const setListElement = React.useCallback(\n (el: HTMLElement | null) => {\n // Remove the previous navigation listener before swapping elements.\n if (navigatedListenerRef.current) {\n navigatedListenerRef.current.el.removeEventListener(\n 'cds-custom-aichat-autocomplete-navigated',\n navigatedListenerRef.current.handler\n );\n navigatedListenerRef.current = null;\n }\n\n controllerRef.current?.setListElement(el);\n // Pass the editor DOM as anchorElement so outside-click detection on the\n // autocomplete element doesn't dismiss the list when the user clicks the\n // editor (the editor is not inside the autocomplete element).\n if (el && 'anchorElement' in el) {\n (el as HTMLElement & { anchorElement: Element | null }).anchorElement =\n promptLineRef.current?.getEditor?.()?.view.dom ?? null;\n }\n if (el && maxHeight) {\n el.style.setProperty('--cds-aichat-autocomplete-max-height', maxHeight);\n }\n if (el) {\n const handler = (e: Event) => {\n setIsListNavigated(\n (e as CustomEvent<AutocompleteNavigatedEventDetail>).detail\n .navigated\n );\n };\n el.addEventListener('cds-custom-aichat-autocomplete-navigated', handler);\n navigatedListenerRef.current = { el, handler };\n } else {\n setIsListNavigated(false);\n // Fire a synthetic clear event on the prompt-line's shell ancestor so\n // the send-control's internal guard (`_autocompleteListNavigated`) also\n // resets. This covers cases where the list is removed from the DOM\n // without the autocomplete element dispatching its own clear event\n // (e.g. the user deletes the trigger character).\n const shell = promptLineRef.current?.closest(\n 'cds-custom-aichat-prompt-line-shell'\n );\n shell?.dispatchEvent(\n new CustomEvent<AutocompleteNavigatedEventDetail>(\n 'cds-custom-aichat-autocomplete-navigated',\n { detail: { navigated: false }, bubbles: false, composed: false }\n )\n );\n }\n },\n [maxHeight, promptLineRef]\n );\n\n // Prevent mousedown on the autocomplete container from stealing focus from\n // the editor.\n const handleContainerMousedown = React.useCallback(\n (e: Event | React.MouseEvent) => {\n e.preventDefault();\n },\n []\n );\n\n const autocompleteContent = React.useMemo<ReactNode>(() => {\n if (!state.trigger || state.items.length === 0) {\n return null;\n }\n const { items: flatItems, groups } = itemsToGroups(state.items);\n if (state.renderCustomList) {\n const result = state.renderCustomList({\n items: state.items,\n query: state.trigger.query,\n onDismiss: dismiss,\n onSelect: handleSelect,\n onSend: handleSend,\n });\n if (result == null) {\n return null;\n }\n if (result instanceof HTMLElement) {\n return (\n <CustomElementHost\n slot=\"autocomplete-content\"\n element={result}\n onMount={setListElement}\n onMousedown={handleContainerMousedown}\n />\n );\n }\n return (\n <CustomReactNodePortal\n slot=\"autocomplete-content\"\n node={result as ReactNode}\n onMount={setListElement}\n onMousedown={handleContainerMousedown}\n />\n );\n }\n return (\n <Autocomplete\n ref={setListElement}\n slot=\"autocomplete-content\"\n items={flatItems}\n groups={groups}\n attached={attached}\n disableDirectSend={state.disableDirectSend}\n onDismiss={dismiss}\n onSelect={(e: CustomEvent<{ item: SuggestionItem }>) =>\n handleSelect(e.detail.item)\n }\n onSend={(e: CustomEvent<{ text: string }>) =>\n handleSend(e.detail?.text)\n }\n />\n );\n }, [\n state,\n handleSelect,\n handleSend,\n dismiss,\n setListElement,\n attached,\n handleContainerMousedown,\n ]);\n\n return { onTriggerChange, autocompleteContent, isListNavigated };\n}\n\ninterface CustomElementHostProps {\n slot: string;\n element: HTMLElement;\n /** Notify the parent which element is the key-forwarding target. */\n onMount?: (el: HTMLElement | null) => void;\n onMousedown?: (e: React.MouseEvent) => void;\n}\n\n/** Mounts a host-provided HTMLElement into the React tree at `slot`. */\nfunction CustomElementHost({\n slot,\n element,\n onMount,\n onMousedown,\n}: CustomElementHostProps): JSX.Element {\n const containerRef = React.useRef<HTMLDivElement | null>(null);\n React.useEffect(() => {\n const container = containerRef.current;\n if (!container) {\n return undefined;\n }\n container.appendChild(element);\n onMount?.(element);\n return () => {\n onMount?.(null);\n if (element.parentNode === container) {\n container.removeChild(element);\n }\n };\n }, [element, onMount]);\n return (\n <div\n ref={containerRef}\n role=\"presentation\"\n slot={slot}\n onMouseDown={onMousedown}\n />\n );\n}\n\ninterface CustomReactNodePortalProps {\n slot: string;\n node: ReactNode;\n onMount?: (el: HTMLElement | null) => void;\n onMousedown?: (e: MouseEvent) => void;\n}\n\nlet autocompletePortalCounter = 0;\n\n/**\n * Projects a consumer-supplied React node into the page's light DOM via a\n * two-level slot/host pair so external `<style>` tags reach it. The rendered\n * `<div>` is a slot-projected anchor in the shell's `autocomplete-content`\n * slot; a sibling `<div slot=\"…\">` is appended to the chatWrapper (the host\n * of the surrounding shadow root) and receives the React node via\n * `createPortal`. Without this hop the node would mount inside the chat's\n * shadow root, hidden from page CSS.\n */\nfunction CustomReactNodePortal({\n slot,\n node,\n onMount,\n onMousedown,\n}: CustomReactNodePortalProps): JSX.Element {\n const containerRef = React.useRef<HTMLDivElement | null>(null);\n const [hostElement, setHostElement] = React.useState<HTMLElement | null>(\n null\n );\n\n React.useEffect(() => {\n const container = containerRef.current;\n if (!container) {\n return undefined;\n }\n const rootNode = container.getRootNode();\n const chatWrapper =\n rootNode instanceof ShadowRoot ? (rootNode.host as HTMLElement) : null;\n if (!chatWrapper) {\n return undefined;\n }\n\n const slotName = `cds-custom-aichat-autocomplete-${++autocompletePortalCounter}`;\n const slotEl = document.createElement('slot');\n slotEl.setAttribute('name', slotName);\n container.appendChild(slotEl);\n\n const hostEl = document.createElement('div');\n hostEl.setAttribute('slot', slotName);\n if (onMousedown) {\n hostEl.addEventListener('mousedown', onMousedown);\n }\n chatWrapper.appendChild(hostEl);\n\n setHostElement(hostEl);\n return () => {\n onMount?.(null);\n if (onMousedown) {\n hostEl.removeEventListener('mousedown', onMousedown);\n }\n slotEl.remove();\n hostEl.remove();\n setHostElement(null);\n };\n // Empty deps: the slot/host pair is owned by this mount cycle and should\n // not churn as `node` updates — React's portal reconciliation handles\n // those updates in place.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, []);\n\n // After the portal content is committed into hostElement, hand the first\n // child element to the controller. This is typically a custom element (e.g.\n // <cds-custom-aichat-autocomplete>) whose properties (anchorElement, keydown\n // forwarding) only work on the element itself — not on the plain <div>\n // wrapper that createPortal renders into. Custom elements are defined\n // synchronously at module load, so by the time useEffect fires (post-paint)\n // the element is fully upgraded and its properties are available.\n React.useEffect(() => {\n if (!hostElement) {\n return;\n }\n const child = hostElement.firstElementChild as HTMLElement | null;\n onMount?.(child ?? hostElement);\n }, [hostElement, onMount]);\n\n return (\n <div slot={slot} ref={containerRef}>\n {hostElement ? ReactDOM.createPortal(node, hostElement) : null}\n </div>\n );\n}\n"],"names":["_jsx","Autocomplete"],"mappings":"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"}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@carbon/ai-chat-components",
3
3
  "description": "AI Chat Components",
4
- "version": "1.12.0-rc.0",
4
+ "version": "1.12.0",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
7
7
  "repository": {
@@ -158,5 +158,5 @@
158
158
  "vite": "^8.0.16",
159
159
  "web-dev-server-plugin-lit-css": "^4.0.0"
160
160
  },
161
- "gitHead": "d30211e57c329add14c03c71e52cd4e23ec9651a"
161
+ "gitHead": "b32b6269f10cd0e6187ecf6727b4a389da64a92b"
162
162
  }
package/telemetry.yml CHANGED
@@ -31,6 +31,7 @@ collect:
31
31
  - loading-label
32
32
  - loading-status-message
33
33
  - name
34
+ - oncds-aichat-autocomplete-navigated
34
35
  - oncds-aichat-file-remove
35
36
  - onhistory-item-selected
36
37
  - onhistory-panel-item-input-cancel
@@ -72,6 +73,7 @@ collect:
72
73
  - oncds-aichat-autocomplete-item-selected
73
74
  - oncds-aichat-autocomplete-item-send
74
75
  - oncds-aichat-custom-list-render
76
+ - oncds-aichat-list-navigated
75
77
  - oncds-aichat-starter-selected
76
78
  # cds-aichat-button
77
79
  - is-quick-action
@@ -162,6 +164,7 @@ collect:
162
164
  # cds-aichat-file-upload-item
163
165
  - fallback-label
164
166
  - read-only
167
+ - remove-file-named-label
165
168
  # cds-aichat-file-uploads
166
169
  - file-removed-label
167
170
  - upload-failure-label