@carbon/ai-chat-components 1.11.0 → 1.12.0-rc.1

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 (172) hide show
  1. package/custom-elements.json +2358 -1973
  2. package/es/components/card/src/card-footer.scss.js +1 -1
  3. package/es/components/card/src/card-steps.scss.js +1 -1
  4. package/es/components/card/src/card.scss.js +1 -1
  5. package/es/components/chat-button/src/chat-button.scss.js +1 -1
  6. package/es/components/chat-history/src/history-panel-item-input.js +0 -1
  7. package/es/components/chat-history/src/history-panel-item-input.js.map +1 -1
  8. package/es/components/code-snippet/src/codemirror/language-controller.js +1 -1
  9. package/es/components/code-snippet/src/codemirror/language-controller.js.map +1 -1
  10. package/es/components/file-uploads/src/file-upload-item.d.ts +14 -1
  11. package/es/components/file-uploads/src/file-upload-item.js +78 -2
  12. package/es/components/file-uploads/src/file-upload-item.js.map +1 -1
  13. package/es/components/file-uploads/src/file-uploads.d.ts +29 -4
  14. package/es/components/file-uploads/src/file-uploads.js +69 -16
  15. package/es/components/file-uploads/src/file-uploads.js.map +1 -1
  16. package/es/components/launcher/src/launcher.scss.js +1 -1
  17. package/es/components/prompt-line/autocomplete/index.d.ts +1 -1
  18. package/es/components/prompt-line/autocomplete/src/autocomplete.d.ts +6 -0
  19. package/es/components/prompt-line/autocomplete/src/autocomplete.js +37 -11
  20. package/es/components/prompt-line/autocomplete/src/autocomplete.js.map +1 -1
  21. package/es/components/prompt-line/index.d.ts +3 -2
  22. package/es/components/prompt-line/index.js +2 -1
  23. package/es/components/prompt-line/index.js.map +1 -1
  24. package/es/components/prompt-line/src/__tests__/wait-for-rich.d.ts +20 -0
  25. package/es/components/prompt-line/src/autocomplete-controller-element.d.ts +84 -0
  26. package/es/components/prompt-line/src/autocomplete-controller-element.js +262 -0
  27. package/es/components/prompt-line/src/autocomplete-controller-element.js.map +1 -0
  28. package/es/components/prompt-line/src/autocomplete-controller.d.ts +10 -69
  29. package/es/components/prompt-line/src/autocomplete-controller.js +57 -251
  30. package/es/components/prompt-line/src/autocomplete-controller.js.map +1 -1
  31. package/es/components/prompt-line/src/prompt-line-rich-runtime.js +3 -0
  32. package/es/components/prompt-line/src/prompt-line-rich-runtime.js.map +1 -1
  33. package/es/components/prompt-line/src/prompt-line-shell.scss.js +1 -1
  34. package/es/components/prompt-line/src/prompt-line-textarea-runtime.js +0 -5
  35. package/es/components/prompt-line/src/prompt-line-textarea-runtime.js.map +1 -1
  36. package/es/components/prompt-line/src/prompt-line.js +1 -1
  37. package/es/components/prompt-line/src/prompt-line.js.map +1 -1
  38. package/es/components/prompt-line/src/send-control.d.ts +7 -0
  39. package/es/components/prompt-line/src/send-control.js +53 -5
  40. package/es/components/prompt-line/src/send-control.js.map +1 -1
  41. package/es/components/prompt-line/src/tiptap/build-extensions.js +1 -1
  42. package/es/components/prompt-line/src/tiptap/build-extensions.js.map +1 -1
  43. package/es/components/prompt-line/src/tiptap/carbon-autocomplete.d.ts +5 -6
  44. package/es/components/prompt-line/src/tiptap/carbon-autocomplete.js +24 -48
  45. package/es/components/prompt-line/src/tiptap/carbon-autocomplete.js.map +1 -1
  46. package/es/components/prompt-line/src/tiptap/carbon-mention.js +14 -48
  47. package/es/components/prompt-line/src/tiptap/carbon-mention.js.map +1 -1
  48. package/es/components/prompt-line/src/tiptap/carbon-starter-trigger.js +3 -4
  49. package/es/components/prompt-line/src/tiptap/carbon-starter-trigger.js.map +1 -1
  50. package/es/components/prompt-line/src/tiptap/keymap.d.ts +1 -1
  51. package/es/components/prompt-line/src/tiptap/keymap.js +3 -4
  52. package/es/components/prompt-line/src/tiptap/keymap.js.map +1 -1
  53. package/es/components/prompt-line/src/tiptap/render-token-chip.js +0 -1
  54. package/es/components/prompt-line/src/tiptap/render-token-chip.js.map +1 -1
  55. package/es/components/prompt-line/src/tiptap/resolve-config-items.d.ts +18 -0
  56. package/es/components/prompt-line/src/tiptap/resolve-config-items.js +32 -0
  57. package/es/components/prompt-line/src/tiptap/resolve-config-items.js.map +1 -0
  58. package/es/components/prompt-line/src/tiptap/strip-presentation-fields.d.ts +18 -0
  59. package/es/components/prompt-line/src/tiptap/strip-presentation-fields.js +22 -0
  60. package/es/components/prompt-line/src/tiptap/strip-presentation-fields.js.map +1 -0
  61. package/es/components/prompt-line/src/tiptap/trigger-utils.d.ts +12 -8
  62. package/es/components/prompt-line/src/tiptap/trigger-utils.js +16 -1
  63. package/es/components/prompt-line/src/tiptap/trigger-utils.js.map +1 -1
  64. package/es/components/prompt-line/src/tiptap/types.d.ts +11 -3
  65. package/es/components/toolbar/src/toolbar.d.ts +8 -0
  66. package/es/components/toolbar/src/toolbar.js +65 -19
  67. package/es/components/toolbar/src/toolbar.js.map +1 -1
  68. package/es/components/video-player/src/providers/vimeo-provider.js +1 -1
  69. package/es/components/video-player/src/providers/vimeo-provider.js.map +1 -1
  70. package/es/globals/decorators/carbon-element.js +2 -3
  71. package/es/globals/decorators/carbon-element.js.map +1 -1
  72. package/es/globals/utils/aria-announcer-manager.d.ts +56 -0
  73. package/es/globals/utils/aria-announcer-manager.js +46 -1
  74. package/es/globals/utils/aria-announcer-manager.js.map +1 -1
  75. package/es/globals/utils/focus-utils.js +1 -3
  76. package/es/globals/utils/focus-utils.js.map +1 -1
  77. package/es/globals/utils/iconTransform.d.ts +16 -2
  78. package/es/globals/utils/iconTransform.js +22 -1
  79. package/es/globals/utils/iconTransform.js.map +1 -1
  80. package/es/react/hooks/useChatAutocomplete.d.ts +5 -0
  81. package/es/react/hooks/useChatAutocomplete.js +26 -1
  82. package/es/react/hooks/useChatAutocomplete.js.map +1 -1
  83. package/es/react/markdown.js +0 -1
  84. package/es/react/markdown.js.map +1 -1
  85. package/es/typings/overflow-menu.d.ts +4 -0
  86. package/es-custom/components/card/src/card-footer.scss.js +1 -1
  87. package/es-custom/components/card/src/card-steps.scss.js +1 -1
  88. package/es-custom/components/card/src/card.scss.js +1 -1
  89. package/es-custom/components/chat-button/src/chat-button.scss.js +1 -1
  90. package/es-custom/components/chat-history/src/history-panel-item-input.js +0 -1
  91. package/es-custom/components/chat-history/src/history-panel-item-input.js.map +1 -1
  92. package/es-custom/components/code-snippet/src/codemirror/language-controller.js +1 -1
  93. package/es-custom/components/code-snippet/src/codemirror/language-controller.js.map +1 -1
  94. package/es-custom/components/file-uploads/src/file-upload-item.d.ts +14 -1
  95. package/es-custom/components/file-uploads/src/file-upload-item.js +78 -2
  96. package/es-custom/components/file-uploads/src/file-upload-item.js.map +1 -1
  97. package/es-custom/components/file-uploads/src/file-uploads.d.ts +29 -4
  98. package/es-custom/components/file-uploads/src/file-uploads.js +69 -16
  99. package/es-custom/components/file-uploads/src/file-uploads.js.map +1 -1
  100. package/es-custom/components/launcher/src/launcher.scss.js +1 -1
  101. package/es-custom/components/prompt-line/autocomplete/index.d.ts +1 -1
  102. package/es-custom/components/prompt-line/autocomplete/src/autocomplete.d.ts +6 -0
  103. package/es-custom/components/prompt-line/autocomplete/src/autocomplete.js +37 -11
  104. package/es-custom/components/prompt-line/autocomplete/src/autocomplete.js.map +1 -1
  105. package/es-custom/components/prompt-line/index.d.ts +3 -2
  106. package/es-custom/components/prompt-line/index.js +2 -1
  107. package/es-custom/components/prompt-line/index.js.map +1 -1
  108. package/es-custom/components/prompt-line/src/__tests__/wait-for-rich.d.ts +20 -0
  109. package/es-custom/components/prompt-line/src/autocomplete-controller-element.d.ts +84 -0
  110. package/es-custom/components/prompt-line/src/autocomplete-controller-element.js +262 -0
  111. package/es-custom/components/prompt-line/src/autocomplete-controller-element.js.map +1 -0
  112. package/es-custom/components/prompt-line/src/autocomplete-controller.d.ts +10 -69
  113. package/es-custom/components/prompt-line/src/autocomplete-controller.js +57 -251
  114. package/es-custom/components/prompt-line/src/autocomplete-controller.js.map +1 -1
  115. package/es-custom/components/prompt-line/src/prompt-line-rich-runtime.js +3 -0
  116. package/es-custom/components/prompt-line/src/prompt-line-rich-runtime.js.map +1 -1
  117. package/es-custom/components/prompt-line/src/prompt-line-shell.scss.js +1 -1
  118. package/es-custom/components/prompt-line/src/prompt-line-textarea-runtime.js +0 -5
  119. package/es-custom/components/prompt-line/src/prompt-line-textarea-runtime.js.map +1 -1
  120. package/es-custom/components/prompt-line/src/prompt-line.js +1 -1
  121. package/es-custom/components/prompt-line/src/prompt-line.js.map +1 -1
  122. package/es-custom/components/prompt-line/src/send-control.d.ts +7 -0
  123. package/es-custom/components/prompt-line/src/send-control.js +53 -5
  124. package/es-custom/components/prompt-line/src/send-control.js.map +1 -1
  125. package/es-custom/components/prompt-line/src/tiptap/build-extensions.js +1 -1
  126. package/es-custom/components/prompt-line/src/tiptap/build-extensions.js.map +1 -1
  127. package/es-custom/components/prompt-line/src/tiptap/carbon-autocomplete.d.ts +5 -6
  128. package/es-custom/components/prompt-line/src/tiptap/carbon-autocomplete.js +24 -48
  129. package/es-custom/components/prompt-line/src/tiptap/carbon-autocomplete.js.map +1 -1
  130. package/es-custom/components/prompt-line/src/tiptap/carbon-mention.js +14 -48
  131. package/es-custom/components/prompt-line/src/tiptap/carbon-mention.js.map +1 -1
  132. package/es-custom/components/prompt-line/src/tiptap/carbon-starter-trigger.js +3 -4
  133. package/es-custom/components/prompt-line/src/tiptap/carbon-starter-trigger.js.map +1 -1
  134. package/es-custom/components/prompt-line/src/tiptap/keymap.d.ts +1 -1
  135. package/es-custom/components/prompt-line/src/tiptap/keymap.js +3 -4
  136. package/es-custom/components/prompt-line/src/tiptap/keymap.js.map +1 -1
  137. package/es-custom/components/prompt-line/src/tiptap/render-token-chip.js +0 -1
  138. package/es-custom/components/prompt-line/src/tiptap/render-token-chip.js.map +1 -1
  139. package/es-custom/components/prompt-line/src/tiptap/resolve-config-items.d.ts +18 -0
  140. package/es-custom/components/prompt-line/src/tiptap/resolve-config-items.js +32 -0
  141. package/es-custom/components/prompt-line/src/tiptap/resolve-config-items.js.map +1 -0
  142. package/es-custom/components/prompt-line/src/tiptap/strip-presentation-fields.d.ts +18 -0
  143. package/es-custom/components/prompt-line/src/tiptap/strip-presentation-fields.js +22 -0
  144. package/es-custom/components/prompt-line/src/tiptap/strip-presentation-fields.js.map +1 -0
  145. package/es-custom/components/prompt-line/src/tiptap/trigger-utils.d.ts +12 -8
  146. package/es-custom/components/prompt-line/src/tiptap/trigger-utils.js +16 -1
  147. package/es-custom/components/prompt-line/src/tiptap/trigger-utils.js.map +1 -1
  148. package/es-custom/components/prompt-line/src/tiptap/types.d.ts +11 -3
  149. package/es-custom/components/toolbar/src/toolbar.d.ts +8 -0
  150. package/es-custom/components/toolbar/src/toolbar.js +65 -19
  151. package/es-custom/components/toolbar/src/toolbar.js.map +1 -1
  152. package/es-custom/components/video-player/src/providers/vimeo-provider.js +1 -1
  153. package/es-custom/components/video-player/src/providers/vimeo-provider.js.map +1 -1
  154. package/es-custom/globals/decorators/carbon-element.js +2 -3
  155. package/es-custom/globals/decorators/carbon-element.js.map +1 -1
  156. package/es-custom/globals/utils/aria-announcer-manager.d.ts +56 -0
  157. package/es-custom/globals/utils/aria-announcer-manager.js +46 -1
  158. package/es-custom/globals/utils/aria-announcer-manager.js.map +1 -1
  159. package/es-custom/globals/utils/focus-utils.js +1 -3
  160. package/es-custom/globals/utils/focus-utils.js.map +1 -1
  161. package/es-custom/globals/utils/iconTransform.d.ts +16 -2
  162. package/es-custom/globals/utils/iconTransform.js +22 -1
  163. package/es-custom/globals/utils/iconTransform.js.map +1 -1
  164. package/es-custom/react/hooks/useChatAutocomplete.d.ts +5 -0
  165. package/es-custom/react/hooks/useChatAutocomplete.js +26 -1
  166. package/es-custom/react/hooks/useChatAutocomplete.js.map +1 -1
  167. package/es-custom/react/markdown.js +0 -1
  168. package/es-custom/react/markdown.js.map +1 -1
  169. package/es-custom/typings/overflow-menu.d.ts +4 -0
  170. package/package.json +6 -6
  171. package/scss/_custom-properties.scss +0 -17
  172. package/scss/_tokens-component.scss +1 -2
@@ -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-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-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-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-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-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-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-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-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;;"}
@@ -102,12 +102,20 @@ export interface CustomListProps {
102
102
  */
103
103
  export interface BaseSuggestionConfig {
104
104
  /**
105
- * Static item list or async function called with the current query string.
105
+ * Static item list, or an async function called with the current query
106
+ * string. Resolved by the autocomplete controller once per query change —
107
+ * the Tiptap extensions never call it.
106
108
  */
107
109
  items: SuggestionItem[] | ((query: string) => Promise<SuggestionItem[]> | SuggestionItem[]);
108
- /** Minimum query length before items() is called. Defaults to 0. */
110
+ /**
111
+ * Minimum query length before `items()` is called. Defaults to 0. Applied
112
+ * by the autocomplete controller, which owns resolution for every trigger.
113
+ */
109
114
  minQueryLength?: number;
110
- /** Called after the user selects an item and insertion is complete. */
115
+ /**
116
+ * Called after the user selects an item and the controller has finished
117
+ * inserting it.
118
+ */
111
119
  onSelect?: (item: SuggestionItem) => void;
112
120
  /** Replace the built-in suggestion list UI. */
113
121
  renderCustomList?: (props: CustomListProps) => HTMLElement | unknown;
@@ -27,6 +27,13 @@ export interface Action extends BaseOverflowMenuItem {
27
27
  * When overflow handling is enabled, setting fixed to true will force this action out of the overflow menu.
28
28
  */
29
29
  fixed?: boolean;
30
+ /**
31
+ * Renders this action as a two-state toggle and sets its current state.
32
+ * When `true` or `false`, the button exposes `aria-pressed` and a visible
33
+ * pressed treatment. Omit the field for a plain button with no toggle
34
+ * semantics — `undefined` is intentionally distinct from `false`.
35
+ */
36
+ isSelected?: boolean;
30
37
  }
31
38
  /**
32
39
  * Toolbar.
@@ -54,6 +61,7 @@ declare class CDSAIChatToolbar extends LitElement {
54
61
  connectedCallback(): void;
55
62
  disconnectedCallback(): void;
56
63
  firstUpdated(): void;
64
+ updated(): void;
57
65
  private sortActions;
58
66
  private setupResizeObserver;
59
67
  private getActions;
@@ -86,19 +86,23 @@ let CDSAIChatToolbar = CDSAIChatToolbar_1 = class CDSAIChatToolbar extends LitEl
86
86
  */
87
87
  this.renderIconButton = (action) => {
88
88
  const tooltipAlign = this.isRTL ? 'bottom-start' : 'bottom-end';
89
+ const { isSelected } = action;
89
90
  return html `
90
91
  <cds-icon-button
92
+ align=${tooltipAlign}
93
+ @click=${action.onClick}
91
94
  ?data-fixed=${action.fixed}
95
+ data-pressed=${isSelected !== undefined ? String(isSelected) : nothing}
96
+ ?data-selected=${isSelected === true}
92
97
  data-testid=${action.testId || nothing}
93
- @click=${action.onClick}
98
+ ?disabled=${action.disabled}
99
+ enter-delay-ms="0"
94
100
  href=${action.href || nothing}
95
- target=${action.href ? action.target || '_self' : nothing}
96
- size=${action.size || BUTTON_SIZE.MEDIUM}
97
- align=${tooltipAlign}
101
+ ?isSelected=${isSelected === true}
98
102
  kind="ghost"
99
- enter-delay-ms="0"
100
103
  leave-delay-ms="0"
101
- ?disabled=${action.disabled}>
104
+ size=${action.size || BUTTON_SIZE.MEDIUM}
105
+ target=${action.href ? action.target || '_self' : nothing}>
102
106
  ${iconLoader(action.icon, {
103
107
  slot: 'icon',
104
108
  })}
@@ -122,6 +126,39 @@ let CDSAIChatToolbar = CDSAIChatToolbar_1 = class CDSAIChatToolbar extends LitEl
122
126
  this.setupResizeObserver();
123
127
  }
124
128
  }
129
+ updated() {
130
+ // Carbon's delegatesFocus moves focus to the inner shadow <button>, so
131
+ // ARIA attributes on the host are invisible to assistive tech. Mirror
132
+ // them onto the inner button after each element's update cycle completes.
133
+ void this._patchShadowButtonAttrs('cds-icon-button[data-pressed]', {
134
+ 'aria-pressed': 'data-pressed',
135
+ });
136
+ void this._patchShadowButtonAttrs('cds-overflow-menu-item[role="menuitemcheckbox"]', { role: 'role', 'aria-checked': 'aria-checked' });
137
+ }
138
+ /**
139
+ * Copies attributes from each host element matching `selector` onto its
140
+ * inner shadow `<button>`, after the element's own update cycle completes.
141
+ *
142
+ * @param selector - CSS selector scoped to this shadow root.
143
+ * @param attrMap - `{ targetAttr: sourceAttr }` pairs to copy.
144
+ * @internal
145
+ */
146
+ async _patchShadowButtonAttrs(selector, attrMap) {
147
+ await Promise.all(Array.from(this.shadowRoot?.querySelectorAll(selector) ??
148
+ []).map(async (el) => {
149
+ await el.updateComplete;
150
+ const btn = el.shadowRoot?.querySelector('button');
151
+ if (!btn) {
152
+ return;
153
+ }
154
+ for (const [target, source] of Object.entries(attrMap)) {
155
+ const value = el.getAttribute(source);
156
+ if (value !== null) {
157
+ btn.setAttribute(target, value);
158
+ }
159
+ }
160
+ }));
161
+ }
125
162
  sortActions() {
126
163
  return [...this.actions].sort((a, b) => {
127
164
  if (a.fixed && !b.fixed) {
@@ -273,19 +310,28 @@ let CDSAIChatToolbar = CDSAIChatToolbar_1 = class CDSAIChatToolbar extends LitEl
273
310
  >${CDSAIChatToolbar_1.OVERFLOW_MENU_LABEL}</span
274
311
  >
275
312
  <cds-overflow-menu-body ?flipped=${!this.isRTL}>
276
- ${repeat(hiddenActions, (item) => item.text, (item) => html `
277
- <cds-overflow-menu-item
278
- @click=${item.onClick}
279
- href=${item.href || nothing}
280
- target=${item.href ? item.target || '_self' : nothing}
281
- ?disabled=${item.disabled}
282
- ?danger=${item.danger}
283
- danger-description=${item.dangerDescription || nothing}
284
- ?divider=${item.divider}
285
- data-testid=${item.testId || nothing}>
286
- ${item.text}
287
- </cds-overflow-menu-item>
288
- `)}
313
+ ${repeat(hiddenActions, (item) => item.text, (item) => {
314
+ return html `
315
+ <cds-overflow-menu-item
316
+ @click=${item.onClick}
317
+ href=${item.href || nothing}
318
+ target=${item.href ? item.target || '_self' : nothing}
319
+ ?disabled=${item.disabled}
320
+ ?danger=${item.danger}
321
+ danger-description=${item.dangerDescription || nothing}
322
+ ?divider=${item.divider}
323
+ ?data-selected=${item.isSelected === true}
324
+ role=${item.isSelected !== undefined
325
+ ? 'menuitemcheckbox'
326
+ : nothing}
327
+ aria-checked=${item.isSelected !== undefined
328
+ ? String(item.isSelected)
329
+ : nothing}
330
+ data-testid=${item.testId || nothing}>
331
+ ${item.text}
332
+ </cds-overflow-menu-item>
333
+ `;
334
+ })}
289
335
  </cds-overflow-menu-body>
290
336
  </cds-overflow-menu>
291
337
  `
@@ -1 +1 @@
1
- {"version":3,"file":"toolbar.js","sources":["../../../../src/components/toolbar/src/toolbar.ts"],"sourcesContent":["/*\n * Copyright IBM Corp. 2025, 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 * @license\n */\n\nimport { LitElement, html, nothing } from 'lit';\nimport { property, state, query } from 'lit/decorators.js';\nimport { repeat } from 'lit/directives/repeat.js';\nimport '@carbon/web-components/es/components/button/index.js';\nimport '@carbon/web-components/es/components/overflow-menu/index.js';\nimport { OVERFLOW_MENU_SIZE } from '@carbon/web-components/es/components/overflow-menu/defs.js';\nimport OverflowMenuVertical16 from '@carbon/icons/es/overflow-menu--vertical/16.js';\nimport { iconLoader } from '@carbon/web-components/es/globals/internal/icon-loader.js';\nimport prefix from '../../../globals/settings.js';\nimport commonStyles from '../../../globals/scss/common.scss?lit';\nimport styles from './toolbar.scss?lit';\nimport { CarbonIcon } from '@carbon/web-components/es/globals/internal/icon-loader-utils.js';\nimport { carbonElement } from '../../../globals/decorators/index.js';\nimport '../../truncated-text/index.js';\nimport { BaseOverflowMenuItem } from '../../../typings/overflow-menu.js';\nimport { PageObjectId } from '../../../testing/PageObjectId.js';\n\nconst blockClass = `${prefix}-toolbar`;\nimport { BUTTON_SIZE } from '@carbon/web-components/es/components/button/defs.js';\n\n/**\n * Actions that display in the toolbar.\n * Extends BaseOverflowMenuItem to support all overflow menu item properties\n * including danger variants, dividers, and links (href/target).\n *\n * Actions can be either:\n * - Interactive buttons with onClick handlers\n * - Links with href/target attributes\n */\nexport interface Action extends BaseOverflowMenuItem {\n /**\n * `@carbon/icons` icon for the action.\n */\n icon: CarbonIcon;\n\n /**\n * Size of button. Defaults to BUTTON_SIZE.MEDIUM.\n */\n size?: BUTTON_SIZE;\n\n /**\n * When overflow handling is enabled, setting fixed to true will force this action out of the overflow menu.\n */\n fixed?: boolean;\n}\n\n/**\n * Toolbar.\n *\n * @element cds-aichat-toolbar\n * @slot navigation - Defines the navigation area of the toolbar.\n * @slot title - Defines the title section of the toolbar.\n * @slot fixed-actions - Defines the area for displaying actions that are always visible (not overflowed) in the toolbar.\n * @slot toolbar-ai-label - Defines the area for displaying the AI label in the toolbar.\n *\n */\n@carbonElement(blockClass)\nclass CDSAIChatToolbar extends LitElement {\n /** Whether the component is in RTL mode.\n * @internal\n */\n @state() private isRTL = false;\n\n /** The list of actions. */\n @property({ type: Array, attribute: false, reflect: false })\n actions: Action[] = [];\n\n /** Should actions be overflowing. */\n @property({ type: Boolean, attribute: 'overflow', reflect: true })\n overflow = false;\n\n @property({ type: String })\n titleText?: string;\n\n @property({ type: String })\n nameText?: string;\n\n /** Container holding all action buttons and the overflow menu.\n * @internal\n */\n @query(`.${blockClass}__end`) private container!: HTMLElement;\n @query(`.${blockClass}__actions-container`)\n private actionsContainer!: HTMLElement;\n\n @query(`.${blockClass}__decorator-container`)\n private decoratorContainer!: HTMLElement;\n\n @query(`.${blockClass}__fixed-actions`)\n private fixedActions!: HTMLElement;\n\n @state()\n private containerWidth = 0;\n\n private resizeObserver?: ResizeObserver;\n\n private static readonly OVERFLOW_MENU_LABEL = 'Options';\n\n connectedCallback(): void {\n super.connectedCallback();\n this.addEventListener('keydown', this._handleToolbarKeydown);\n }\n\n disconnectedCallback() {\n this.resizeObserver?.disconnect();\n this.resizeObserver = undefined;\n this.removeEventListener('keydown', this._handleToolbarKeydown);\n super.disconnectedCallback();\n }\n\n firstUpdated() {\n if (this.overflow) {\n this.setupResizeObserver();\n }\n }\n\n private sortActions() {\n return [...this.actions].sort((a, b) => {\n if (a.fixed && !b.fixed) {\n return -1;\n }\n if (!a.fixed && b.fixed) {\n return 1;\n }\n return 0;\n });\n }\n\n private setupResizeObserver() {\n this.resizeObserver?.disconnect();\n this.resizeObserver = new ResizeObserver((entries) => {\n const width = entries[0].contentRect.width;\n if (width !== this.containerWidth) {\n this.containerWidth = width;\n }\n });\n this.resizeObserver.observe(this.container);\n }\n\n private getActions() {\n if (!this.container || this.container.getBoundingClientRect().width === 0) {\n return {\n visibleActions: [],\n hiddenActions: [],\n };\n }\n\n const actionsContainerWidth =\n this.actionsContainer.getBoundingClientRect().width;\n const overflowMenuIconWidth = 40;\n const fixedActionsWidth =\n this.fixedActions.getBoundingClientRect().width || 0;\n const decoratorContainerWidth =\n this.decoratorContainer.getBoundingClientRect().width || 0;\n /**\n * to properly gauge the container width we need to account for some additional variables\n * 1. the size of the overflow menu icon, which should always be a constant\n * 2. the size of any optional fixed width items\n * 3. the size of any optional decorator items\n */\n const containerWidth =\n actionsContainerWidth -\n (overflowMenuIconWidth + fixedActionsWidth + decoratorContainerWidth);\n const children = this.actionsContainer.children;\n let currentWidth = 0;\n const visibleChildren: Element[] = [];\n const hiddenChildren: Element[] = [];\n for (const el of children) {\n const elWidth = el.getBoundingClientRect().width;\n const newWidth = currentWidth + elWidth;\n const widthCheck = newWidth < containerWidth;\n if (widthCheck) {\n currentWidth = newWidth;\n visibleChildren.push(el);\n } else {\n hiddenChildren.push(el);\n }\n }\n const idx = visibleChildren.length;\n const sortedActions = this.sortActions();\n const visibleActions = sortedActions.slice(0, idx);\n const hiddenActions = sortedActions.slice(idx);\n\n return {\n visibleActions,\n hiddenActions,\n };\n }\n\n /**\n * Returns the focused overflow menu item (if exists) by traversing shadow DOM\n */\n private findFocusedOverflowMenuItem(activeElem: Element): Element | null {\n if (activeElem.tagName.toLowerCase() === 'cds-overflow-menu-item') {\n return activeElem;\n }\n\n if (activeElem?.shadowRoot?.activeElement) {\n return this.findFocusedOverflowMenuItem(\n activeElem.shadowRoot.activeElement\n );\n }\n\n return null;\n }\n\n private _handleToolbarKeydown = (event: KeyboardEvent) => {\n if (event.key !== 'ArrowUp' && event.key !== 'ArrowDown') {\n return;\n }\n\n let focusedMenuItem: Element | null = null;\n\n if (document.activeElement) {\n focusedMenuItem = this.findFocusedOverflowMenuItem(\n document.activeElement\n );\n }\n\n if (focusedMenuItem) {\n event.preventDefault();\n const menuBody = focusedMenuItem.closest('cds-overflow-menu-body');\n\n if (!menuBody) {\n return;\n }\n\n const items = Array.from(\n menuBody.querySelectorAll('cds-overflow-menu-item:not([disabled])')\n ) as HTMLElement[];\n\n const currentIndex = items.indexOf(focusedMenuItem as HTMLElement);\n if (currentIndex === -1) {\n return;\n }\n\n const direction = event.key === 'ArrowDown' ? 1 : -1;\n const nextIndex =\n (currentIndex + direction + items.length) % items.length;\n items[nextIndex]?.focus();\n }\n };\n\n /**\n * Renders an action as an icon button.\n * Note: Some Action properties only apply when rendered in overflow menu:\n * - danger/dangerDescription: cds-icon-button doesn't support danger variant\n * - divider: Only applicable in menu context\n */\n private renderIconButton = (action: Action) => {\n const tooltipAlign = this.isRTL ? 'bottom-start' : 'bottom-end';\n\n return html`\n <cds-icon-button\n ?data-fixed=${action.fixed}\n data-testid=${action.testId || nothing}\n @click=${action.onClick}\n href=${action.href || nothing}\n target=${action.href ? action.target || '_self' : nothing}\n size=${action.size || BUTTON_SIZE.MEDIUM}\n align=${tooltipAlign}\n kind=\"ghost\"\n enter-delay-ms=\"0\"\n leave-delay-ms=\"0\"\n ?disabled=${action.disabled}>\n ${iconLoader(action.icon, {\n slot: 'icon',\n })}\n <span slot=\"tooltip-content\">${action.text}</span>\n </cds-icon-button>\n `;\n };\n\n private getOverflowMenuSize(): OVERFLOW_MENU_SIZE {\n return (this.actions?.[0]?.size ||\n OVERFLOW_MENU_SIZE.MEDIUM) as OVERFLOW_MENU_SIZE;\n }\n\n render() {\n const {\n hiddenActions: rawHiddenActions,\n visibleActions: rawVisibleActions,\n } = this.getActions();\n const showOverflowMenu = rawHiddenActions.length > 1;\n const visibleActions = showOverflowMenu\n ? rawVisibleActions\n : [...rawVisibleActions, ...rawHiddenActions];\n const hiddenActions = showOverflowMenu ? rawHiddenActions : [];\n const showInitialActions =\n rawVisibleActions.length === 0 && rawHiddenActions.length === 0;\n\n return html`\n <div data-rounded=\"top\" class=${blockClass}>\n <div data-fixed class=\"${blockClass}__start\">\n <div data-fixed class=\"${blockClass}__navigation\">\n <slot name=\"navigation\"></slot>\n </div>\n\n <div data-fixed class=\"${blockClass}__title\">\n <slot name=\"title\">\n ${\n this.titleText || this.nameText\n ? html`\n <cds-aichat-truncated-text\n lines=\"1\"\n type=\"tooltip\"\n align=${this.isRTL ? 'bottom-end' : 'bottom-start'}\n value=\"${[this.titleText, this.nameText]\n .filter(Boolean)\n .join(' ')}\">\n ${\n this.titleText\n ? html`<span\n data-testid=${PageObjectId.HEADER_TITLE}\n >${this.titleText}</span\n >`\n : nothing\n }\n ${this.titleText && this.nameText ? html`` : nothing}\n ${\n this.nameText\n ? html`<span\n class=\"${blockClass}__name\"\n data-testid=${PageObjectId.HEADER_NAME}\n >${this.nameText}</span\n >`\n : nothing\n }\n </cds-aichat-truncated-text>\n `\n : nothing\n }\n </slot>\n </div>\n </div>\n <div\n class=\"${blockClass}__end\"\n data-rounded=\"top-right\"\n data-floating-menu-container>\n <div class=\"${blockClass}__actions-container\">\n <div class=\"${blockClass}__decorator-container\">\n <slot name=\"decorator\"></slot>\n </div>\n ${repeat(\n showInitialActions ? this.actions : visibleActions,\n (action) => action.text,\n this.renderIconButton\n )}\n ${\n showOverflowMenu\n ? html`\n <cds-overflow-menu\n size=${this.getOverflowMenuSize()}\n align=${this.isRTL ? 'bottom-start' : 'bottom-end'}\n data-offset\n ?data-hidden=${hiddenActions.length === 0}\n kind=\"ghost\"\n close-on-activation\n enter-delay-ms=\"0\"\n leave-delay-ms=\"0\">\n ${iconLoader(OverflowMenuVertical16, {\n class: `${blockClass}-overflow-icon`,\n slot: 'icon',\n })}\n <span slot=\"tooltip-content\"\n >${CDSAIChatToolbar.OVERFLOW_MENU_LABEL}</span\n >\n <cds-overflow-menu-body ?flipped=${!this.isRTL}>\n ${repeat(\n hiddenActions,\n (item) => item.text,\n (item) => html`\n <cds-overflow-menu-item\n @click=${item.onClick}\n href=${item.href || nothing}\n target=${\n item.href ? item.target || '_self' : nothing\n }\n ?disabled=${item.disabled}\n ?danger=${item.danger}\n danger-description=${\n item.dangerDescription || nothing\n }\n ?divider=${item.divider}\n data-testid=${item.testId || nothing}>\n ${item.text}\n </cds-overflow-menu-item>\n `\n )}\n </cds-overflow-menu-body>\n </cds-overflow-menu>\n `\n : nothing\n }\n <div data-fixed class=\"${blockClass}__fixed-actions\">\n <slot name=\"fixed-actions\"></slot>\n </div>\n </div>\n </div>\n </div>\n `;\n }\n\n static styles = [commonStyles, styles];\n}\n\nexport { CDSAIChatToolbar };\nexport default CDSAIChatToolbar;\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"toolbar.js","sources":["../../../../src/components/toolbar/src/toolbar.ts"],"sourcesContent":["/*\n * Copyright IBM Corp. 2025, 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 * @license\n */\n\nimport { LitElement, html, nothing } from 'lit';\nimport { property, state, query } from 'lit/decorators.js';\nimport { repeat } from 'lit/directives/repeat.js';\nimport '@carbon/web-components/es/components/button/index.js';\nimport '@carbon/web-components/es/components/overflow-menu/index.js';\nimport { OVERFLOW_MENU_SIZE } from '@carbon/web-components/es/components/overflow-menu/defs.js';\nimport OverflowMenuVertical16 from '@carbon/icons/es/overflow-menu--vertical/16.js';\nimport { iconLoader } from '@carbon/web-components/es/globals/internal/icon-loader.js';\nimport prefix from '../../../globals/settings.js';\nimport commonStyles from '../../../globals/scss/common.scss?lit';\nimport styles from './toolbar.scss?lit';\nimport { CarbonIcon } from '@carbon/web-components/es/globals/internal/icon-loader-utils.js';\nimport { carbonElement } from '../../../globals/decorators/index.js';\nimport '../../truncated-text/index.js';\nimport { BaseOverflowMenuItem } from '../../../typings/overflow-menu.js';\nimport { PageObjectId } from '../../../testing/PageObjectId.js';\n\nconst blockClass = `${prefix}-toolbar`;\nimport { BUTTON_SIZE } from '@carbon/web-components/es/components/button/defs.js';\n\n/**\n * Actions that display in the toolbar.\n * Extends BaseOverflowMenuItem to support all overflow menu item properties\n * including danger variants, dividers, and links (href/target).\n *\n * Actions can be either:\n * - Interactive buttons with onClick handlers\n * - Links with href/target attributes\n */\nexport interface Action extends BaseOverflowMenuItem {\n /**\n * `@carbon/icons` icon for the action.\n */\n icon: CarbonIcon;\n\n /**\n * Size of button. Defaults to BUTTON_SIZE.MEDIUM.\n */\n size?: BUTTON_SIZE;\n\n /**\n * When overflow handling is enabled, setting fixed to true will force this action out of the overflow menu.\n */\n fixed?: boolean;\n\n /**\n * Renders this action as a two-state toggle and sets its current state.\n * When `true` or `false`, the button exposes `aria-pressed` and a visible\n * pressed treatment. Omit the field for a plain button with no toggle\n * semantics — `undefined` is intentionally distinct from `false`.\n */\n isSelected?: boolean;\n}\n\n/**\n * Toolbar.\n *\n * @element cds-aichat-toolbar\n * @slot navigation - Defines the navigation area of the toolbar.\n * @slot title - Defines the title section of the toolbar.\n * @slot fixed-actions - Defines the area for displaying actions that are always visible (not overflowed) in the toolbar.\n * @slot toolbar-ai-label - Defines the area for displaying the AI label in the toolbar.\n *\n */\n@carbonElement(blockClass)\nclass CDSAIChatToolbar extends LitElement {\n /** Whether the component is in RTL mode.\n * @internal\n */\n @state() private isRTL = false;\n\n /** The list of actions. */\n @property({ type: Array, attribute: false, reflect: false })\n actions: Action[] = [];\n\n /** Should actions be overflowing. */\n @property({ type: Boolean, attribute: 'overflow', reflect: true })\n overflow = false;\n\n @property({ type: String })\n titleText?: string;\n\n @property({ type: String })\n nameText?: string;\n\n /** Container holding all action buttons and the overflow menu.\n * @internal\n */\n @query(`.${blockClass}__end`) private container!: HTMLElement;\n @query(`.${blockClass}__actions-container`)\n private actionsContainer!: HTMLElement;\n\n @query(`.${blockClass}__decorator-container`)\n private decoratorContainer!: HTMLElement;\n\n @query(`.${blockClass}__fixed-actions`)\n private fixedActions!: HTMLElement;\n\n @state()\n private containerWidth = 0;\n\n private resizeObserver?: ResizeObserver;\n\n private static readonly OVERFLOW_MENU_LABEL = 'Options';\n\n connectedCallback(): void {\n super.connectedCallback();\n this.addEventListener('keydown', this._handleToolbarKeydown);\n }\n\n disconnectedCallback() {\n this.resizeObserver?.disconnect();\n this.resizeObserver = undefined;\n this.removeEventListener('keydown', this._handleToolbarKeydown);\n super.disconnectedCallback();\n }\n\n firstUpdated() {\n if (this.overflow) {\n this.setupResizeObserver();\n }\n }\n\n updated() {\n // Carbon's delegatesFocus moves focus to the inner shadow <button>, so\n // ARIA attributes on the host are invisible to assistive tech. Mirror\n // them onto the inner button after each element's update cycle completes.\n void this._patchShadowButtonAttrs('cds-icon-button[data-pressed]', {\n 'aria-pressed': 'data-pressed',\n });\n void this._patchShadowButtonAttrs(\n 'cds-overflow-menu-item[role=\"menuitemcheckbox\"]',\n { role: 'role', 'aria-checked': 'aria-checked' }\n );\n }\n\n /**\n * Copies attributes from each host element matching `selector` onto its\n * inner shadow `<button>`, after the element's own update cycle completes.\n *\n * @param selector - CSS selector scoped to this shadow root.\n * @param attrMap - `{ targetAttr: sourceAttr }` pairs to copy.\n * @internal\n */\n private async _patchShadowButtonAttrs(\n selector: string,\n attrMap: Record<string, string>\n ): Promise<void> {\n await Promise.all(\n Array.from(\n this.shadowRoot?.querySelectorAll<LitElement & HTMLElement>(selector) ??\n []\n ).map(async (el) => {\n await el.updateComplete;\n const btn = el.shadowRoot?.querySelector('button');\n if (!btn) {\n return;\n }\n for (const [target, source] of Object.entries(attrMap)) {\n const value = el.getAttribute(source);\n if (value !== null) {\n btn.setAttribute(target, value);\n }\n }\n })\n );\n }\n\n private sortActions() {\n return [...this.actions].sort((a, b) => {\n if (a.fixed && !b.fixed) {\n return -1;\n }\n if (!a.fixed && b.fixed) {\n return 1;\n }\n return 0;\n });\n }\n\n private setupResizeObserver() {\n this.resizeObserver?.disconnect();\n this.resizeObserver = new ResizeObserver((entries) => {\n const width = entries[0].contentRect.width;\n if (width !== this.containerWidth) {\n this.containerWidth = width;\n }\n });\n this.resizeObserver.observe(this.container);\n }\n\n private getActions() {\n if (!this.container || this.container.getBoundingClientRect().width === 0) {\n return {\n visibleActions: [],\n hiddenActions: [],\n };\n }\n\n const actionsContainerWidth =\n this.actionsContainer.getBoundingClientRect().width;\n const overflowMenuIconWidth = 40;\n const fixedActionsWidth =\n this.fixedActions.getBoundingClientRect().width || 0;\n const decoratorContainerWidth =\n this.decoratorContainer.getBoundingClientRect().width || 0;\n /**\n * to properly gauge the container width we need to account for some additional variables\n * 1. the size of the overflow menu icon, which should always be a constant\n * 2. the size of any optional fixed width items\n * 3. the size of any optional decorator items\n */\n const containerWidth =\n actionsContainerWidth -\n (overflowMenuIconWidth + fixedActionsWidth + decoratorContainerWidth);\n const children = this.actionsContainer.children;\n let currentWidth = 0;\n const visibleChildren: Element[] = [];\n const hiddenChildren: Element[] = [];\n for (const el of children) {\n const elWidth = el.getBoundingClientRect().width;\n const newWidth = currentWidth + elWidth;\n const widthCheck = newWidth < containerWidth;\n if (widthCheck) {\n currentWidth = newWidth;\n visibleChildren.push(el);\n } else {\n hiddenChildren.push(el);\n }\n }\n const idx = visibleChildren.length;\n const sortedActions = this.sortActions();\n const visibleActions = sortedActions.slice(0, idx);\n const hiddenActions = sortedActions.slice(idx);\n\n return {\n visibleActions,\n hiddenActions,\n };\n }\n\n /**\n * Returns the focused overflow menu item (if exists) by traversing shadow DOM\n */\n private findFocusedOverflowMenuItem(activeElem: Element): Element | null {\n if (activeElem.tagName.toLowerCase() === 'cds-overflow-menu-item') {\n return activeElem;\n }\n\n if (activeElem?.shadowRoot?.activeElement) {\n return this.findFocusedOverflowMenuItem(\n activeElem.shadowRoot.activeElement\n );\n }\n\n return null;\n }\n\n private _handleToolbarKeydown = (event: KeyboardEvent) => {\n if (event.key !== 'ArrowUp' && event.key !== 'ArrowDown') {\n return;\n }\n\n let focusedMenuItem: Element | null = null;\n\n if (document.activeElement) {\n focusedMenuItem = this.findFocusedOverflowMenuItem(\n document.activeElement\n );\n }\n\n if (focusedMenuItem) {\n event.preventDefault();\n const menuBody = focusedMenuItem.closest('cds-overflow-menu-body');\n\n if (!menuBody) {\n return;\n }\n\n const items = Array.from(\n menuBody.querySelectorAll('cds-overflow-menu-item:not([disabled])')\n ) as HTMLElement[];\n\n const currentIndex = items.indexOf(focusedMenuItem as HTMLElement);\n if (currentIndex === -1) {\n return;\n }\n\n const direction = event.key === 'ArrowDown' ? 1 : -1;\n const nextIndex =\n (currentIndex + direction + items.length) % items.length;\n items[nextIndex]?.focus();\n }\n };\n\n /**\n * Renders an action as an icon button.\n * Note: Some Action properties only apply when rendered in overflow menu:\n * - danger/dangerDescription: cds-icon-button doesn't support danger variant\n * - divider: Only applicable in menu context\n */\n private renderIconButton = (action: Action) => {\n const tooltipAlign = this.isRTL ? 'bottom-start' : 'bottom-end';\n const { isSelected } = action;\n\n return html`\n <cds-icon-button\n align=${tooltipAlign}\n @click=${action.onClick}\n ?data-fixed=${action.fixed}\n data-pressed=${isSelected !== undefined ? String(isSelected) : nothing}\n ?data-selected=${isSelected === true}\n data-testid=${action.testId || nothing}\n ?disabled=${action.disabled}\n enter-delay-ms=\"0\"\n href=${action.href || nothing}\n ?isSelected=${isSelected === true}\n kind=\"ghost\"\n leave-delay-ms=\"0\"\n size=${action.size || BUTTON_SIZE.MEDIUM}\n target=${action.href ? action.target || '_self' : nothing}>\n ${iconLoader(action.icon, {\n slot: 'icon',\n })}\n <span slot=\"tooltip-content\">${action.text}</span>\n </cds-icon-button>\n `;\n };\n\n private getOverflowMenuSize(): OVERFLOW_MENU_SIZE {\n return (this.actions?.[0]?.size ||\n OVERFLOW_MENU_SIZE.MEDIUM) as OVERFLOW_MENU_SIZE;\n }\n\n render() {\n const {\n hiddenActions: rawHiddenActions,\n visibleActions: rawVisibleActions,\n } = this.getActions();\n const showOverflowMenu = rawHiddenActions.length > 1;\n const visibleActions = showOverflowMenu\n ? rawVisibleActions\n : [...rawVisibleActions, ...rawHiddenActions];\n const hiddenActions = showOverflowMenu ? rawHiddenActions : [];\n const showInitialActions =\n rawVisibleActions.length === 0 && rawHiddenActions.length === 0;\n\n return html`\n <div data-rounded=\"top\" class=${blockClass}>\n <div data-fixed class=\"${blockClass}__start\">\n <div data-fixed class=\"${blockClass}__navigation\">\n <slot name=\"navigation\"></slot>\n </div>\n\n <div data-fixed class=\"${blockClass}__title\">\n <slot name=\"title\">\n ${\n this.titleText || this.nameText\n ? html`\n <cds-aichat-truncated-text\n lines=\"1\"\n type=\"tooltip\"\n align=${this.isRTL ? 'bottom-end' : 'bottom-start'}\n value=\"${[this.titleText, this.nameText]\n .filter(Boolean)\n .join(' ')}\">\n ${\n this.titleText\n ? html`<span\n data-testid=${PageObjectId.HEADER_TITLE}\n >${this.titleText}</span\n >`\n : nothing\n }\n ${this.titleText && this.nameText ? html`` : nothing}\n ${\n this.nameText\n ? html`<span\n class=\"${blockClass}__name\"\n data-testid=${PageObjectId.HEADER_NAME}\n >${this.nameText}</span\n >`\n : nothing\n }\n </cds-aichat-truncated-text>\n `\n : nothing\n }\n </slot>\n </div>\n </div>\n <div\n class=\"${blockClass}__end\"\n data-rounded=\"top-right\"\n data-floating-menu-container>\n <div class=\"${blockClass}__actions-container\">\n <div class=\"${blockClass}__decorator-container\">\n <slot name=\"decorator\"></slot>\n </div>\n ${repeat(\n showInitialActions ? this.actions : visibleActions,\n (action) => action.text,\n this.renderIconButton\n )}\n ${\n showOverflowMenu\n ? html`\n <cds-overflow-menu\n size=${this.getOverflowMenuSize()}\n align=${this.isRTL ? 'bottom-start' : 'bottom-end'}\n data-offset\n ?data-hidden=${hiddenActions.length === 0}\n kind=\"ghost\"\n close-on-activation\n enter-delay-ms=\"0\"\n leave-delay-ms=\"0\">\n ${iconLoader(OverflowMenuVertical16, {\n class: `${blockClass}-overflow-icon`,\n slot: 'icon',\n })}\n <span slot=\"tooltip-content\"\n >${CDSAIChatToolbar.OVERFLOW_MENU_LABEL}</span\n >\n <cds-overflow-menu-body ?flipped=${!this.isRTL}>\n ${repeat(\n hiddenActions,\n (item) => item.text,\n (item) => {\n return html`\n <cds-overflow-menu-item\n @click=${item.onClick}\n href=${item.href || nothing}\n target=${\n item.href ? item.target || '_self' : nothing\n }\n ?disabled=${item.disabled}\n ?danger=${item.danger}\n danger-description=${\n item.dangerDescription || nothing\n }\n ?divider=${item.divider}\n ?data-selected=${item.isSelected === true}\n role=${\n item.isSelected !== undefined\n ? 'menuitemcheckbox'\n : nothing\n }\n aria-checked=${\n item.isSelected !== undefined\n ? String(item.isSelected)\n : nothing\n }\n data-testid=${item.testId || nothing}>\n ${item.text}\n </cds-overflow-menu-item>\n `;\n }\n )}\n </cds-overflow-menu-body>\n </cds-overflow-menu>\n `\n : nothing\n }\n <div data-fixed class=\"${blockClass}__fixed-actions\">\n <slot name=\"fixed-actions\"></slot>\n </div>\n </div>\n </div>\n </div>\n `;\n }\n\n static styles = [commonStyles, styles];\n}\n\nexport { CDSAIChatToolbar };\nexport default CDSAIChatToolbar;\n"],"names":[],"mappings":"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"}
@@ -146,7 +146,7 @@ class VimeoProvider extends BaseProvider {
146
146
  this.triggerError(new Error(this.config.errorMessage || 'Failed to load video'));
147
147
  });
148
148
  }
149
- catch (error) {
149
+ catch (_error) {
150
150
  if (this.iframe) {
151
151
  this.updateAriaAttributes(this.iframe, 'error');
152
152
  }
@@ -1 +1 @@
1
- {"version":3,"file":"vimeo-provider.js","sources":["../../../../../src/components/video-player/src/providers/vimeo-provider.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 * Portions of this code are derived from react-player\n * Copyright (c) 2017 Pete Cook\n * Licensed under the MIT License\n * https://github.com/cookpete/react-player/blob/v2.15.1/LICENSE\n *\n * Vimeo player implementation adapted from:\n * https://github.com/cookpete/react-player/blob/v2.15.1/src/players/Vimeo.js\n */\n\nimport { BaseProvider, ProviderConfig } from './base-provider.js';\nimport { ScriptLoader } from '../../../shared/media-utils/script-loader.js';\n\nconst SDK_URL = 'https://player.vimeo.com/api/player.js';\n\n// Declare Vimeo Player API types\ndeclare global {\n interface Window {\n Vimeo: any;\n }\n}\n\n/**\n * Clean Vimeo URL by removing management paths\n */\nfunction cleanUrl(url: string): string {\n return url.replace('/manage/videos', '');\n}\n\n/**\n * Provider for Vimeo videos using the Vimeo Player API\n */\nexport class VimeoProvider extends BaseProvider {\n private player: any = null;\n private playerContainer: HTMLDivElement | null = null;\n private iframe: HTMLIFrameElement | null = null;\n private isReady = false;\n\n /**\n * Update aria attributes based on state\n */\n protected updateAriaAttributes(\n element: HTMLElement,\n state: 'loading' | 'ready' | 'error'\n ): void {\n element.setAttribute('aria-label', this.getStateLabel(state));\n element.setAttribute('aria-busy', state === 'loading' ? 'true' : 'false');\n }\n\n /**\n * Initialize the provider and load Vimeo Player API\n */\n async init(container: HTMLElement, config: ProviderConfig): Promise<void> {\n await super.init(container, config);\n\n if (!this.container) {\n throw new Error('Container element is required');\n }\n\n // Create container for Vimeo player. Sizing/positioning of the wrapper\n // and the iframe Vimeo inserts inside it are handled by the\n // .cds-aichat--video-player__provider SCSS rules in video-player.scss.\n this.playerContainer = document.createElement('div');\n this.container.appendChild(this.playerContainer);\n\n // Load Vimeo Player API\n await this.loadVimeoAPI();\n }\n\n /**\n * Load the Vimeo Player API script\n */\n private async loadVimeoAPI(): Promise<void> {\n if (window.Vimeo && window.Vimeo.Player) {\n return Promise.resolve();\n }\n\n await ScriptLoader.load(SDK_URL);\n\n // Wait for Vimeo to be available\n return new Promise((resolve, reject) => {\n const checkVimeo = () => {\n if (window.Vimeo && window.Vimeo.Player) {\n resolve();\n } else {\n setTimeout(checkVimeo, 100);\n }\n };\n checkVimeo();\n\n // Timeout after 5 seconds\n setTimeout(() => {\n if (!window.Vimeo || !window.Vimeo.Player) {\n reject(new Error('Vimeo Player API failed to load'));\n }\n }, 5000);\n });\n }\n\n /**\n * Load a Vimeo video URL\n */\n async load(url: string): Promise<void> {\n if (!this.playerContainer) {\n throw new Error('Player container not initialized');\n }\n\n // Wait for API to be ready\n if (!window.Vimeo || !window.Vimeo.Player) {\n await this.loadVimeoAPI();\n }\n\n const cleanedUrl = cleanUrl(url);\n\n try {\n // Create new player\n this.player = new window.Vimeo.Player(this.playerContainer, {\n url: cleanedUrl,\n autoplay: this.config.playing || false,\n controls: true,\n playsinline: true,\n });\n\n // Wait for player to be ready\n await this.player.ready();\n\n // Track the SDK-created iframe for ARIA updates. Its sizing is handled\n // by the .cds-aichat--video-player__provider iframe SCSS rule.\n this.iframe = this.playerContainer.querySelector(\n 'iframe'\n ) as HTMLIFrameElement;\n if (this.iframe) {\n this.updateAriaAttributes(this.iframe, 'loading');\n }\n\n // Set up event listeners\n this.player.on('loaded', () => {\n if (this.iframe) {\n this.updateAriaAttributes(this.iframe, 'ready');\n }\n this.isReady = true;\n this.triggerReady();\n });\n\n this.player.on('play', () => {\n this.triggerPlay();\n });\n\n this.player.on('pause', () => {\n this.triggerPause();\n });\n\n this.player.on('ended', () => {\n this.triggerPause();\n });\n\n this.player.on('error', (_error: any) => {\n if (this.iframe) {\n this.updateAriaAttributes(this.iframe, 'error');\n }\n // Use the generic error message from config\n this.triggerError(\n new Error(this.config.errorMessage || 'Failed to load video')\n );\n });\n } catch (error) {\n if (this.iframe) {\n this.updateAriaAttributes(this.iframe, 'error');\n }\n // Use the generic error message from config\n this.triggerError(\n new Error(this.config.errorMessage || 'Failed to load video')\n );\n }\n }\n\n /**\n * Start or resume playback\n */\n play(): void {\n if (this.player && this.isReady) {\n this.player.play().catch((error: any) => {\n console.warn('Vimeo play was prevented:', error);\n });\n }\n }\n\n /**\n * Pause playback\n */\n pause(): void {\n if (this.player && this.isReady) {\n this.player.pause().catch((error: any) => {\n console.warn('Vimeo pause failed:', error);\n });\n }\n }\n\n /**\n * Clean up the provider\n */\n destroy(): void {\n if (this.player) {\n this.player.destroy().catch((error: any) => {\n console.warn('Vimeo destroy failed:', error);\n });\n this.player = null;\n }\n this.playerContainer = null;\n this.isReady = false;\n super.destroy();\n }\n}\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"vimeo-provider.js","sources":["../../../../../src/components/video-player/src/providers/vimeo-provider.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 * Portions of this code are derived from react-player\n * Copyright (c) 2017 Pete Cook\n * Licensed under the MIT License\n * https://github.com/cookpete/react-player/blob/v2.15.1/LICENSE\n *\n * Vimeo player implementation adapted from:\n * https://github.com/cookpete/react-player/blob/v2.15.1/src/players/Vimeo.js\n */\n\nimport { BaseProvider, ProviderConfig } from './base-provider.js';\nimport { ScriptLoader } from '../../../shared/media-utils/script-loader.js';\n\nconst SDK_URL = 'https://player.vimeo.com/api/player.js';\n\n// Declare Vimeo Player API types\ndeclare global {\n interface Window {\n Vimeo: any;\n }\n}\n\n/**\n * Clean Vimeo URL by removing management paths\n */\nfunction cleanUrl(url: string): string {\n return url.replace('/manage/videos', '');\n}\n\n/**\n * Provider for Vimeo videos using the Vimeo Player API\n */\nexport class VimeoProvider extends BaseProvider {\n private player: any = null;\n private playerContainer: HTMLDivElement | null = null;\n private iframe: HTMLIFrameElement | null = null;\n private isReady = false;\n\n /**\n * Update aria attributes based on state\n */\n protected updateAriaAttributes(\n element: HTMLElement,\n state: 'loading' | 'ready' | 'error'\n ): void {\n element.setAttribute('aria-label', this.getStateLabel(state));\n element.setAttribute('aria-busy', state === 'loading' ? 'true' : 'false');\n }\n\n /**\n * Initialize the provider and load Vimeo Player API\n */\n async init(container: HTMLElement, config: ProviderConfig): Promise<void> {\n await super.init(container, config);\n\n if (!this.container) {\n throw new Error('Container element is required');\n }\n\n // Create container for Vimeo player. Sizing/positioning of the wrapper\n // and the iframe Vimeo inserts inside it are handled by the\n // .cds-aichat--video-player__provider SCSS rules in video-player.scss.\n this.playerContainer = document.createElement('div');\n this.container.appendChild(this.playerContainer);\n\n // Load Vimeo Player API\n await this.loadVimeoAPI();\n }\n\n /**\n * Load the Vimeo Player API script\n */\n private async loadVimeoAPI(): Promise<void> {\n if (window.Vimeo && window.Vimeo.Player) {\n return Promise.resolve();\n }\n\n await ScriptLoader.load(SDK_URL);\n\n // Wait for Vimeo to be available\n return new Promise((resolve, reject) => {\n const checkVimeo = () => {\n if (window.Vimeo && window.Vimeo.Player) {\n resolve();\n } else {\n setTimeout(checkVimeo, 100);\n }\n };\n checkVimeo();\n\n // Timeout after 5 seconds\n setTimeout(() => {\n if (!window.Vimeo || !window.Vimeo.Player) {\n reject(new Error('Vimeo Player API failed to load'));\n }\n }, 5000);\n });\n }\n\n /**\n * Load a Vimeo video URL\n */\n async load(url: string): Promise<void> {\n if (!this.playerContainer) {\n throw new Error('Player container not initialized');\n }\n\n // Wait for API to be ready\n if (!window.Vimeo || !window.Vimeo.Player) {\n await this.loadVimeoAPI();\n }\n\n const cleanedUrl = cleanUrl(url);\n\n try {\n // Create new player\n this.player = new window.Vimeo.Player(this.playerContainer, {\n url: cleanedUrl,\n autoplay: this.config.playing || false,\n controls: true,\n playsinline: true,\n });\n\n // Wait for player to be ready\n await this.player.ready();\n\n // Track the SDK-created iframe for ARIA updates. Its sizing is handled\n // by the .cds-aichat--video-player__provider iframe SCSS rule.\n this.iframe = this.playerContainer.querySelector(\n 'iframe'\n ) as HTMLIFrameElement;\n if (this.iframe) {\n this.updateAriaAttributes(this.iframe, 'loading');\n }\n\n // Set up event listeners\n this.player.on('loaded', () => {\n if (this.iframe) {\n this.updateAriaAttributes(this.iframe, 'ready');\n }\n this.isReady = true;\n this.triggerReady();\n });\n\n this.player.on('play', () => {\n this.triggerPlay();\n });\n\n this.player.on('pause', () => {\n this.triggerPause();\n });\n\n this.player.on('ended', () => {\n this.triggerPause();\n });\n\n this.player.on('error', (_error: any) => {\n if (this.iframe) {\n this.updateAriaAttributes(this.iframe, 'error');\n }\n // Use the generic error message from config\n this.triggerError(\n new Error(this.config.errorMessage || 'Failed to load video')\n );\n });\n } catch (_error) {\n if (this.iframe) {\n this.updateAriaAttributes(this.iframe, 'error');\n }\n // Use the generic error message from config\n this.triggerError(\n new Error(this.config.errorMessage || 'Failed to load video')\n );\n }\n }\n\n /**\n * Start or resume playback\n */\n play(): void {\n if (this.player && this.isReady) {\n this.player.play().catch((error: any) => {\n console.warn('Vimeo play was prevented:', error);\n });\n }\n }\n\n /**\n * Pause playback\n */\n pause(): void {\n if (this.player && this.isReady) {\n this.player.pause().catch((error: any) => {\n console.warn('Vimeo pause failed:', error);\n });\n }\n }\n\n /**\n * Clean up the provider\n */\n destroy(): void {\n if (this.player) {\n this.player.destroy().catch((error: any) => {\n console.warn('Vimeo destroy failed:', error);\n });\n this.player = null;\n }\n this.playerContainer = null;\n this.isReady = false;\n super.destroy();\n }\n}\n"],"names":[],"mappings":"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"}
@@ -17,7 +17,7 @@ const legacyCustomElement = (tagName, clazz) => {
17
17
  try {
18
18
  customElements.define(tagName, clazz);
19
19
  }
20
- catch (error) {
20
+ catch (_error) {
21
21
  // console.warn(`Attempting to re-define ${tagName}`);
22
22
  }
23
23
  // Cast as any because TS doesn't recognize the return type as being a
@@ -25,7 +25,6 @@ const legacyCustomElement = (tagName, clazz) => {
25
25
  // `Constructor<HTMLElement>` for some reason.
26
26
  // `Constructor<HTMLElement>` is helpful to make sure the decorator is
27
27
  // applied to elements however.
28
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
29
28
  return clazz;
30
29
  };
31
30
  const standardCustomElement = (tagName, descriptor) => {
@@ -38,7 +37,7 @@ const standardCustomElement = (tagName, descriptor) => {
38
37
  try {
39
38
  customElements.define(tagName, clazz);
40
39
  }
41
- catch (error) {
40
+ catch (_error) {
42
41
  // console.warn(`Attempting to re-define ${tagName}`);
43
42
  }
44
43
  },
@@ -1 +1 @@
1
- {"version":3,"file":"carbon-element.js","sources":["../../../src/globals/decorators/carbon-element.ts"],"sourcesContent":["/*\n * Copyright IBM Corp. 2025, 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 * @license\n */\n\n/*\n * IMPORTANT: For compatibility with tsickle and the Closure JS compiler, all\n * property decorators (but not class decorators) in this file that have\n * an @ExportDecoratedItems annotation must be defined as a regular function,\n * not an arrow function.\n */\ndeclare type Constructor<T> = {\n new (...args: any[]): T;\n};\ninterface ClassDescriptor {\n kind: 'class';\n elements: ClassElement[];\n finisher?: <T>(clazz: Constructor<T>) => void | Constructor<T>;\n}\ninterface ClassElement {\n kind: 'field' | 'method';\n key: PropertyKey;\n placement: 'static' | 'prototype' | 'own';\n // eslint-disable-next-line @typescript-eslint/ban-types\n initializer?: Function;\n extras?: ClassElement[];\n finisher?: <T>(clazz: Constructor<T>) => void | Constructor<T>;\n descriptor?: PropertyDescriptor;\n}\n\n/**\n * Allow for custom element classes with private constructors\n */\ntype CustomElementClass = Omit<typeof HTMLElement, 'new'>;\n\nconst legacyCustomElement = (tagName: string, clazz: CustomElementClass) => {\n try {\n customElements.define(tagName, clazz as CustomElementConstructor);\n } catch (error) {\n // console.warn(`Attempting to re-define ${tagName}`);\n }\n // Cast as any because TS doesn't recognize the return type as being a\n // subtype of the decorated class when clazz is typed as\n // `Constructor<HTMLElement>` for some reason.\n // `Constructor<HTMLElement>` is helpful to make sure the decorator is\n // applied to elements however.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n return clazz as any;\n};\n\nconst standardCustomElement = (\n tagName: string,\n descriptor: ClassDescriptor\n) => {\n const { kind, elements } = descriptor;\n return {\n kind,\n elements,\n // This callback is called once the class is otherwise fully defined\n finisher(clazz: Constructor<HTMLElement>) {\n try {\n customElements.define(tagName, clazz);\n } catch (error) {\n // console.warn(`Attempting to re-define ${tagName}`);\n }\n },\n };\n};\n\n/**\n * Class decorator factory that defines the decorated class as a custom element.\n *\n * ```js\n * @carbonElement('my-element')\n * class MyElement extends LitElement {\n * render() {\n * return html``;\n * }\n * }\n * ```\n *\n * @param tagName The tag name of the custom element to define.\n */\nexport function carbonElement(tagName: string) {\n return (classOrDescriptor: CustomElementClass | ClassDescriptor) =>\n typeof classOrDescriptor === 'function'\n ? legacyCustomElement(tagName, classOrDescriptor)\n : standardCustomElement(tagName, classOrDescriptor as ClassDescriptor);\n}\n"],"names":[],"mappings":";;;;;;;AAAA;;;;;;;AAOG;AAgCH,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAE,KAAyB,KAAI;AACzE,IAAA,IAAI;AACF,QAAA,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,KAAiC,CAAC;IACnE;IAAE,OAAO,KAAK,EAAE;;IAEhB;;;;;;;AAOA,IAAA,OAAO,KAAY;AACrB,CAAC;AAED,MAAM,qBAAqB,GAAG,CAC5B,OAAe,EACf,UAA2B,KACzB;AACF,IAAA,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,UAAU;IACrC,OAAO;QACL,IAAI;QACJ,QAAQ;;AAER,QAAA,QAAQ,CAAC,KAA+B,EAAA;AACtC,YAAA,IAAI;AACF,gBAAA,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;YACvC;YAAE,OAAO,KAAK,EAAE;;YAEhB;QACF,CAAC;KACF;AACH,CAAC;AAED;;;;;;;;;;;;;AAaG;AACG,SAAU,aAAa,CAAC,OAAe,EAAA;IAC3C,OAAO,CAAC,iBAAuD,KAC7D,OAAO,iBAAiB,KAAK;AAC3B,UAAE,mBAAmB,CAAC,OAAO,EAAE,iBAAiB;AAChD,UAAE,qBAAqB,CAAC,OAAO,EAAE,iBAAoC,CAAC;AAC5E;;"}
1
+ {"version":3,"file":"carbon-element.js","sources":["../../../src/globals/decorators/carbon-element.ts"],"sourcesContent":["/*\n * Copyright IBM Corp. 2025, 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 * @license\n */\n\n/*\n * IMPORTANT: For compatibility with tsickle and the Closure JS compiler, all\n * property decorators (but not class decorators) in this file that have\n * an @ExportDecoratedItems annotation must be defined as a regular function,\n * not an arrow function.\n */\ndeclare type Constructor<T> = {\n new (...args: any[]): T;\n};\ninterface ClassDescriptor {\n kind: 'class';\n elements: ClassElement[];\n finisher?: <T>(clazz: Constructor<T>) => void | Constructor<T>;\n}\ninterface ClassElement {\n kind: 'field' | 'method';\n key: PropertyKey;\n placement: 'static' | 'prototype' | 'own';\n // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n initializer?: Function;\n extras?: ClassElement[];\n finisher?: <T>(clazz: Constructor<T>) => void | Constructor<T>;\n descriptor?: PropertyDescriptor;\n}\n\n/**\n * Allow for custom element classes with private constructors\n */\ntype CustomElementClass = Omit<typeof HTMLElement, 'new'>;\n\nconst legacyCustomElement = (tagName: string, clazz: CustomElementClass) => {\n try {\n customElements.define(tagName, clazz as CustomElementConstructor);\n } catch (_error) {\n // console.warn(`Attempting to re-define ${tagName}`);\n }\n // Cast as any because TS doesn't recognize the return type as being a\n // subtype of the decorated class when clazz is typed as\n // `Constructor<HTMLElement>` for some reason.\n // `Constructor<HTMLElement>` is helpful to make sure the decorator is\n // applied to elements however.\n\n return clazz as any;\n};\n\nconst standardCustomElement = (\n tagName: string,\n descriptor: ClassDescriptor\n) => {\n const { kind, elements } = descriptor;\n return {\n kind,\n elements,\n // This callback is called once the class is otherwise fully defined\n finisher(clazz: Constructor<HTMLElement>) {\n try {\n customElements.define(tagName, clazz);\n } catch (_error) {\n // console.warn(`Attempting to re-define ${tagName}`);\n }\n },\n };\n};\n\n/**\n * Class decorator factory that defines the decorated class as a custom element.\n *\n * ```js\n * @carbonElement('my-element')\n * class MyElement extends LitElement {\n * render() {\n * return html``;\n * }\n * }\n * ```\n *\n * @param tagName The tag name of the custom element to define.\n */\nexport function carbonElement(tagName: string) {\n return (classOrDescriptor: CustomElementClass | ClassDescriptor) =>\n typeof classOrDescriptor === 'function'\n ? legacyCustomElement(tagName, classOrDescriptor)\n : standardCustomElement(tagName, classOrDescriptor as ClassDescriptor);\n}\n"],"names":[],"mappings":";;;;;;;AAAA;;;;;;;AAOG;AAgCH,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAE,KAAyB,KAAI;AACzE,IAAA,IAAI;AACF,QAAA,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,KAAiC,CAAC;IACnE;IAAE,OAAO,MAAM,EAAE;;IAEjB;;;;;;AAOA,IAAA,OAAO,KAAY;AACrB,CAAC;AAED,MAAM,qBAAqB,GAAG,CAC5B,OAAe,EACf,UAA2B,KACzB;AACF,IAAA,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,UAAU;IACrC,OAAO;QACL,IAAI;QACJ,QAAQ;;AAER,QAAA,QAAQ,CAAC,KAA+B,EAAA;AACtC,YAAA,IAAI;AACF,gBAAA,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;YACvC;YAAE,OAAO,MAAM,EAAE;;YAEjB;QACF,CAAC;KACF;AACH,CAAC;AAED;;;;;;;;;;;;;AAaG;AACG,SAAU,aAAa,CAAC,OAAe,EAAA;IAC3C,OAAO,CAAC,iBAAuD,KAC7D,OAAO,iBAAiB,KAAK;AAC3B,UAAE,mBAAmB,CAAC,OAAO,EAAE,iBAAiB;AAChD,UAAE,qBAAqB,CAAC,OAAO,EAAE,iBAAoC,CAAC;AAC5E;;"}
@@ -15,6 +15,51 @@
15
15
  * screen reader is currently reading. Use sparingly.
16
16
  */
17
17
  type AnnouncerPoliteness = 'polite' | 'assertive';
18
+ /**
19
+ * Options for {@link mountAriaAnnouncer}.
20
+ */
21
+ export interface AriaAnnouncerOptions {
22
+ /**
23
+ * Number of polite `aria-live="polite"` regions to create and rotate through.
24
+ * Default `1`. The React `AriaAnnouncerProvider` passes `3` explicitly: in
25
+ * earlier testing FF + JAWS occasionally re-read entire region contents on
26
+ * append; a third region ensures there is always a fresh region for the next
27
+ * announcement.
28
+ */
29
+ politeCount?: number;
30
+ /**
31
+ * Number of `aria-live="assertive"` regions to create.
32
+ * Default 0 (polite-only).
33
+ */
34
+ assertiveCount?: number;
35
+ /**
36
+ * Sets `aria-atomic` on every created region. Default `false`.
37
+ *
38
+ * Note: `aria-atomic` is intentionally left off by default. With it, FF +
39
+ * JAWS read some messages cleanly but Chrome stops announcing buttons inside
40
+ * the region. Without it, FF + JAWS sometimes double-read parts but Chrome
41
+ * handles buttons. The default (off) is the lesser evil.
42
+ */
43
+ ariaAtomic?: boolean;
44
+ }
45
+ /**
46
+ * Handle returned by {@link mountAriaAnnouncer}. Call `disconnect` when the
47
+ * host element is removed from the DOM to cancel pending timers and clean up
48
+ * the created regions.
49
+ */
50
+ export interface AriaAnnouncerHandle {
51
+ /**
52
+ * Queue a message for announcement on the next tick. Multiple same-tick calls
53
+ * for the same politeness are coalesced into a single write. Defaults to
54
+ * `"polite"`; falls back to polite if assertive regions were not created.
55
+ */
56
+ announce(message: string, politeness?: AnnouncerPoliteness): void;
57
+ /**
58
+ * Cancel pending announcements, disconnect the manager, and remove the
59
+ * created live regions from `container`.
60
+ */
61
+ disconnect(): void;
62
+ }
18
63
  /**
19
64
  * Manages ARIA live region announcements for screen readers.
20
65
  *
@@ -59,4 +104,15 @@ export declare class AriaAnnouncerManager {
59
104
  private clearChannel;
60
105
  private doAnnouncements;
61
106
  }
107
+ /**
108
+ * Create visually-hidden `aria-live` regions inside `container`, wire them to
109
+ * a new {@link AriaAnnouncerManager}, and return a handle. The caller is
110
+ * responsible for hiding the container (e.g. with a visually-hidden wrapper or
111
+ * CSS class); this function only creates the live regions themselves.
112
+ *
113
+ * @param container - The element to append the live regions into.
114
+ * @param options - Region counts and aria-atomic setting. All fields have
115
+ * sensible defaults; pass `{}` for a single polite region.
116
+ */
117
+ export declare function mountAriaAnnouncer(container: HTMLElement, options?: AriaAnnouncerOptions): AriaAnnouncerHandle;
62
118
  export {};
@@ -120,6 +120,51 @@ class AriaAnnouncerManager {
120
120
  channel.currentIndex = (channel.currentIndex + 1) % channel.regions.length;
121
121
  }
122
122
  }
123
+ /**
124
+ * Create visually-hidden `aria-live` regions inside `container`, wire them to
125
+ * a new {@link AriaAnnouncerManager}, and return a handle. The caller is
126
+ * responsible for hiding the container (e.g. with a visually-hidden wrapper or
127
+ * CSS class); this function only creates the live regions themselves.
128
+ *
129
+ * @param container - The element to append the live regions into.
130
+ * @param options - Region counts and aria-atomic setting. All fields have
131
+ * sensible defaults; pass `{}` for a single polite region.
132
+ */
133
+ function mountAriaAnnouncer(container, options = {}) {
134
+ const { politeCount = 1, assertiveCount = 0, ariaAtomic = false } = options;
135
+ function createRegion(politeness) {
136
+ const el = document.createElement('div');
137
+ el.setAttribute('aria-live', politeness);
138
+ if (ariaAtomic) {
139
+ el.setAttribute('aria-atomic', 'true');
140
+ }
141
+ container.appendChild(el);
142
+ return el;
143
+ }
144
+ const politeRegions = [];
145
+ for (let i = 0; i < politeCount; i++) {
146
+ politeRegions.push(createRegion('polite'));
147
+ }
148
+ const assertiveRegions = [];
149
+ for (let i = 0; i < assertiveCount; i++) {
150
+ assertiveRegions.push(createRegion('assertive'));
151
+ }
152
+ const manager = new AriaAnnouncerManager();
153
+ manager.connect(politeRegions, assertiveRegions);
154
+ return {
155
+ announce(message, politeness = 'polite') {
156
+ manager.announce(message, politeness);
157
+ },
158
+ disconnect() {
159
+ manager.disconnect();
160
+ [...politeRegions, ...assertiveRegions].forEach((el) => {
161
+ if (el.parentNode) {
162
+ el.parentNode.removeChild(el);
163
+ }
164
+ });
165
+ },
166
+ };
167
+ }
123
168
 
124
- export { AriaAnnouncerManager };
169
+ export { AriaAnnouncerManager, mountAriaAnnouncer };
125
170
  //# sourceMappingURL=aria-announcer-manager.js.map