@coveo/atomic 3.61.3 → 3.61.5

package/dist/esm/components/common/generated-answer/generated-content-container.js

@@ -1,8 +1,13 @@
 import { html } from "lit";
+import { ifDefined } from "lit/directives/if-defined.js";
 import { renderGeneratedMarkdownContent } from "./generated-content/generated-markdown-content.js";
 import { renderGeneratedTextContent } from "./generated-content/generated-text-content.js";
 const renderGeneratedContentContainer = ({ props })=>(children)=>html`
-    <div part="generated-container">
+    <div
+      part="generated-container"
+      id=${ifDefined(props.id)}
+      aria-busy=${props.isStreaming ? 'true' : 'false'}
+    >
       ${'text/markdown' === props.answerContentFormat ? renderGeneratedMarkdownContent({
             props: {
                 answer: props.answer,

package/dist/esm/components/common/generated-answer/render-answer-content.js

@@ -6,6 +6,7 @@ import { renderShowButton } from "./show-button.js";
 import { renderSourceCitations } from "./source-citations.js";
 import { renderGeneratingAnswerLabel } from "./render-generating-answer-label.js";
 import "../atomic-icon/atomic-icon.js";
+const GENERATED_CONTENT_ID = 'generated-answer-content';
 const renderAnswerContent = ({ props })=>{
     const { i18n, generatedAnswer, collapsible, renderFeedbackAndCopyButtonsSlot, renderCitationsSlot, onRetry, onClickShowButton } = props;
     const { answer, isStreaming, citations, answerContentFormat, expanded, error } = generatedAnswer;
@@ -23,7 +24,8 @@ const renderAnswerContent = ({ props })=>{
         props: {
             answer,
             answerContentFormat,
-            isStreaming: !!isStreaming
+            isStreaming: !!isStreaming,
+            id: collapsible ? GENERATED_CONTENT_ID : void 0
         }
     })(html`
               ${renderSourceCitations({
@@ -51,7 +53,8 @@ const renderAnswerContent = ({ props })=>{
         props: {
             i18n,
             onClick: onClickShowButton,
-            isCollapsed: !expanded
+            isCollapsed: !expanded,
+            controlsId: GENERATED_CONTENT_ID
         }
     }) : nothing}
               </div>

package/dist/esm/components/common/generated-answer/show-button.js

@@ -10,6 +10,7 @@ const renderShowButton = ({ props })=>html`${renderButton({
             part: 'answer-show-button',
             class: 'hidden items-center hover:bg-transparent',
             ariaExpanded: props.isCollapsed ? 'false' : 'true',
+            ariaControls: props.controlsId,
             onClick: props.onClick
         }
     })(html`

package/dist/esm/components/insight/atomic-insight-generated-answer/atomic-insight-generated-answer.js

@@ -135,11 +135,13 @@ class AtomicInsightGeneratedAnswer extends LitElement {
     async copyToClipboard(answer) {
         await this.controller.copyToClipboard(answer, ()=>{
             this.copied = true;
+            this.ariaCopyMessage.message = this.bindings.i18n.t('generated-answer-copied');
             setTimeout(()=>{
                 this.copied = false;
             }, 2000);
         }, ()=>{
             this.copyError = true;
+            this.ariaCopyMessage.message = this.bindings.i18n.t('failed-to-copy-generated-answer');
             setTimeout(()=>{
                 this.copyError = false;
             }, 2000);
@@ -276,7 +278,7 @@ class AtomicInsightGeneratedAnswer extends LitElement {
     constructor(){
         super(), this.DEFAULT_COLLAPSED_HEIGHT = 16, this.MAX_COLLAPSED_HEIGHT = 32, this.MIN_COLLAPSED_HEIGHT = 9, this.REQUIRED_FIELDS_TO_INCLUDE_IN_CITATIONS = [
             'filetype'
-        ], this.withToggle = false, this.collapsible = false, this.maxCollapsedHeight = this.DEFAULT_COLLAPSED_HEIGHT, this.disableCitationAnchoring = false, this.copied = false, this.copyError = false, this.ariaMessage = new AriaLiveRegionController(this, 'generated-answer', false, true), this.ariaErrorMessage = new AriaLiveRegionController(this, 'generated-answer-error', true), this.onGeneratedAnswerStateUpdate = ()=>{
+        ], this.withToggle = false, this.collapsible = false, this.maxCollapsedHeight = this.DEFAULT_COLLAPSED_HEIGHT, this.disableCitationAnchoring = false, this.copied = false, this.copyError = false, this.ariaMessage = new AriaLiveRegionController(this, 'generated-answer', false, true), this.ariaErrorMessage = new AriaLiveRegionController(this, 'generated-answer-error', true), this.ariaCopyMessage = new AriaLiveRegionController(this, 'generated-answer-copy', true), this.onGeneratedAnswerStateUpdate = ()=>{
             if (this.generatedAnswerState.isVisible !== this.controller.data.isVisible) {
                 this.controller.data = {
                     ...this.controller.data,

package/dist/esm/components/search/atomic-generated-answer/atomic-generated-answer.js

@@ -132,6 +132,7 @@ class AtomicGeneratedAnswer extends LitElement {
                 'generated-answer-content-background': this.areFollowUpsEnabled,
                 'agent-scrollable': this.areFollowUpsEnabled
             })}
+                    tabindex=${this.areFollowUpsEnabled ? '0' : nothing}
                   >
                     <article>${this.renderAnswerContent()}</article>
                   </div>
@@ -156,6 +157,9 @@ class AtomicGeneratedAnswer extends LitElement {
       </div>
     `;
     }
+    get shouldAnnounceAnswerStatus() {
+        return !this.areFollowUpsEnabled;
+    }
     get hasNoAnswerGenerated() {
         return this.controller.hasNoAnswerGenerated;
     }
@@ -180,11 +184,13 @@ class AtomicGeneratedAnswer extends LitElement {
     async copyToClipboard(answer) {
         await this.controller.copyToClipboard(answer, ()=>{
             this.copied = true;
+            this.ariaCopyMessage.message = this.bindings.i18n.t('generated-answer-copied');
             setTimeout(()=>{
                 this.copied = false;
             }, 2000);
         }, ()=>{
             this.copyError = true;
+            this.ariaCopyMessage.message = this.bindings.i18n.t('failed-to-copy-generated-answer');
             setTimeout(()=>{
                 this.copyError = false;
             }, 2000);
@@ -379,7 +385,7 @@ class AtomicGeneratedAnswer extends LitElement {
     constructor(){
         super(), this.DEFAULT_COLLAPSED_HEIGHT = 16, this.MAX_COLLAPSED_HEIGHT = 32, this.MIN_COLLAPSED_HEIGHT = 9, this.REQUIRED_FIELDS_TO_INCLUDE_IN_CITATIONS = [
             'filetype'
-        ], this.withToggle = false, this.collapsible = false, this.maxCollapsedHeight = this.DEFAULT_COLLAPSED_HEIGHT, this.disableCitationAnchoring = false, this.tabsIncluded = [], this.tabsExcluded = [], this.copied = false, this.copyError = false, this.ariaMessage = new AriaLiveRegionController(this, 'generated-answer', false, true), this.ariaErrorMessage = new AriaLiveRegionController(this, 'generated-answer-error', true), this.onGeneratedAnswerStateUpdate = ()=>{
+        ], this.withToggle = false, this.collapsible = false, this.maxCollapsedHeight = this.DEFAULT_COLLAPSED_HEIGHT, this.disableCitationAnchoring = false, this.tabsIncluded = [], this.tabsExcluded = [], this.copied = false, this.copyError = false, this.ariaMessage = new AriaLiveRegionController(this, 'generated-answer', false, true), this.ariaErrorMessage = new AriaLiveRegionController(this, 'generated-answer-error', true), this.ariaCopyMessage = new AriaLiveRegionController(this, 'generated-answer-copy', true), this.onGeneratedAnswerStateUpdate = ()=>{
             if (this.generatedAnswerState.isVisible !== this.controller.data.isVisible) {
                 this.controller.data = {
                     ...this.controller.data,
@@ -387,6 +393,7 @@ class AtomicGeneratedAnswer extends LitElement {
                 };
                 this.controller.writeStoredData(this.controller.data);
             }
+            if (!this.shouldAnnounceAnswerStatus) return;
             const status = this.controller.getGeneratedAnswerStatus();
             if (this.controller.isStatusAssertive()) {
                 this.ariaMessage.message = '';

package/dist/esm/components/search/atomic-sort-dropdown/atomic-sort-dropdown.js

@@ -112,6 +112,7 @@ class AtomicSortDropdown extends LitElement {
                 })))}`);
     }
     render() {
+        if (!this.options.length) return html`<slot></slot>`;
         const { hasError, hasResults, firstSearchExecuted, isLoading } = this.searchStatusState;
         return html`
       ${sortGuard({

package/dist/esm/global/environment.js

@@ -3,7 +3,7 @@ function getWindow() {
 }
 function getAtomicEnvironment(headlessVersion) {
     return {
-        version: "3.61.3",
+        version: "3.61.5",
         headlessVersion
     };
 }

package/dist/esm/versions.js

@@ -1,3 +1,3 @@
-const atomicVersion = "3.61.3";
+const atomicVersion = "3.61.5";
 export { version as headlessVersion } from "@coveo/headless/package.json";
 export { atomicVersion };

package/dist/types/components/common/atomic-generated-answer-content/atomic-generated-answer-content.d.ts

@@ -40,8 +40,15 @@ export declare class AtomicGeneratedAnswerContent extends LitElement {
     onCopyToClipboard: (answerId: string) => void;
     private copyState;
     private resetCopyTimeout?;
+    private ariaMessage;
+    private ariaErrorMessage;
+    private ariaCopyMessage;
+    private lastAnnouncedMessage?;
+    private hasObservedAnswer;
     disconnectedCallback(): void;
     render(): TemplateResult;
+    protected updated(): void;
+    private announceAnswerStatus;
     private renderFeedbackAndCopyButtons;
     private copyToClipboard;
     private scheduleCopyReset;

package/dist/types/components/common/generated-answer/answer-announcement.d.ts

@@ -0,0 +1,22 @@
+import type { GeneratedAnswerBase } from '@coveo/headless';
+import type { i18n } from 'i18next';
+export interface AnswerAnnouncement {
+    message: string;
+    assertive: boolean;
+}
+type AnnounceableAnswer = Pick<GeneratedAnswerBase, 'answer' | 'cannotAnswer' | 'error' | 'isLoading' | 'isStreaming'>;
+/**
+ * Computes the screen reader announcement describing the state of a single generated answer.
+ *
+ * The conversational rendering path holds one of these per conversation turn, so each answer
+ * reports its own state instead of relying on the top-level answer state.
+ */
+export declare const getAnswerAnnouncement: (answer: AnnounceableAnswer | undefined, i18n: i18n) => AnswerAnnouncement;
+/**
+ * Whether an answer has finished generating successfully.
+ *
+ * Used to stay silent when an already-completed answer is rendered for the first time, such as
+ * when earlier conversation turns are revealed.
+ */
+export declare const isSettledAnswer: (answer: AnnounceableAnswer | undefined) => boolean;
+export {};

package/dist/types/components/common/generated-answer/generated-content-container.d.ts

@@ -3,5 +3,6 @@ export interface GeneratedContentContainerProps {
     answer?: string;
     answerContentFormat?: string;
     isStreaming: boolean;
+    id?: string;
 }
 export declare const renderGeneratedContentContainer: FunctionalComponentWithChildren<GeneratedContentContainerProps>;

package/dist/types/components/common/generated-answer/show-button.d.ts

@@ -4,6 +4,7 @@ import type { FunctionalComponent } from '../../../utils/functional-component-ut
 export interface ShowButtonProps {
     i18n: i18n;
     isCollapsed: boolean;
+    controlsId?: string;
     onClick: () => void;
 }
 export declare const renderShowButton: FunctionalComponent<ShowButtonProps>;

package/dist/types/components/insight/atomic-insight-generated-answer/atomic-insight-generated-answer.d.ts

@@ -90,6 +90,7 @@ export declare class AtomicInsightGeneratedAnswer extends LitElement implements
     private copyError;
     private ariaMessage;
     private ariaErrorMessage;
+    private ariaCopyMessage;
     constructor();
     initialize(): void;
     disconnectedCallback(): void;

package/dist/types/components/search/atomic-generated-answer/atomic-generated-answer.d.ts

@@ -136,12 +136,14 @@ export declare class AtomicGeneratedAnswer extends LitElement implements Initial
     private copyError;
     private ariaMessage;
     private ariaErrorMessage;
+    private ariaCopyMessage;
     constructor();
     initialize(): void;
     disconnectedCallback(): void;
     protected willUpdate(changedProperties: PropertyValueMap<this>): void;
     render(): import("lit-html").TemplateResult<1> | typeof nothing;
     onGeneratedAnswerStateUpdate: () => void;
+    private get shouldAnnounceAnswerStatus();
     private get hasNoAnswerGenerated();
     private get isAnswerVisible();
     private get toggleTooltip();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coveo/atomic",
-  "version": "3.61.3",
+  "version": "3.61.5",
   "description": "A web-component library for building modern UIs interfacing with the Coveo platform",
   "homepage": "https://docs.coveo.com/en/atomic/latest/",
   "license": "Apache-2.0",
@@ -55,21 +55,21 @@
     "./custom-elements-manifest": "./custom-elements.json"
   },
   "dependencies": {
-    "@coveo/atomic-legacy": "0.1.4",
+    "@coveo/atomic-legacy": "0.1.6",
     "@coveo/bueno": "1.1.9",
-    "@coveo/headless": "3.56.0",
-    "@coveo/relay-event-types": "20.5.1",
+    "@coveo/headless": "3.57.1",
+    "@coveo/relay-event-types": "20.7.1",
     "@lit/context": "1.1.6",
     "@open-wc/lit-helpers": "0.7.0",
     "@popperjs/core": "2.11.8",
-    "@salesforce-ux/design-system": "2.30.7",
+    "@salesforce-ux/design-system": "2.264.1",
     "@stencil/core": "4.20.0",
     "cssnano": "8.0.10",
     "dayjs": "1.11.23",
-    "dompurify": "3.4.14",
+    "dompurify": "3.4.15",
     "escape-html": "1.0.3",
-    "i18next": "26.4.0",
-    "i18next-http-backend": "4.0.1",
+    "i18next": "26.4.2",
+    "i18next-http-backend": "4.0.2",
     "lit": "3.3.3",
     "marked": "12.0.2"
   },
@@ -80,19 +80,19 @@
     "@playwright/test": "1.62.1",
     "@rollup/plugin-replace": "6.0.3",
     "@rslib/core": "0.23.2",
-    "@storybook/addon-a11y": "10.5.8",
-    "@storybook/addon-docs": "10.5.8",
+    "@storybook/addon-a11y": "10.6.0",
+    "@storybook/addon-docs": "10.6.0",
     "@storybook/addon-mcp": "0.7.0",
-    "@storybook/addon-vitest": "10.5.8",
+    "@storybook/addon-vitest": "10.6.0",
     "@storybook/icons": "2.1.0",
-    "@storybook/web-components-vite": "10.5.8",
+    "@storybook/web-components-vite": "10.6.0",
     "@tailwindcss/postcss": "4.3.3",
     "@tailwindcss/vite": "4.3.3",
     "@types/escape-html": "1.0.4",
-    "@types/node": "24.13.3",
+    "@types/node": "24.13.6",
     "@vitest/browser-playwright": "4.1.11",
     "@wc-toolkit/storybook-helpers": "10.5.1",
-    "chromatic": "18.5.0",
+    "chromatic": "18.9.4",
     "handlebars": "4.7.9",
     "lit-html": "3.3.3",
     "local-web-server": "5.4.0",
@@ -100,26 +100,26 @@
     "msw-storybook-addon": "2.0.7",
     "natural-orderby": "5.0.0",
     "playwright": "1.62.1",
-    "postcss": "8.5.26",
+    "postcss": "8.5.28",
     "postcss-load-config": "6.0.1",
-    "prettier": "3.9.6",
+    "prettier": "3.9.8",
     "publint": "0.3.24",
     "puppeteer": "25.9.0",
     "react": "19.2.8",
     "remark-gfm": "4.0.1",
     "shadow-dom-testing-library": "1.14.1",
-    "storybook": "10.5.8",
-    "storybook-addon-pseudo-states": "10.5.8",
+    "storybook": "10.6.0",
+    "storybook-addon-pseudo-states": "10.6.0",
     "tailwindcss": "4.3.3",
     "ts-dedent": "2.3.0",
     "ts-lit-plugin": "2.0.2",
     "typescript": "6.0.3",
-    "vite": "8.2.2",
+    "vite": "8.3.0",
     "vitest": "4.1.11"
   },
   "peerDependencies": {
     "@coveo/bueno": "^1.1.9",
-    "@coveo/headless": "^3.56.0",
+    "@coveo/headless": "^3.57.1",
     "typescript": ">=5.0.0"
   },
   "peerDependenciesMeta": {