@coveo/atomic 3.33.8-pre.7328338555 → 3.33.8-pre.74a50cd6e2

package/dist/esm/{suggestions-common-2b20db26.js → suggestions-events-b7a6f007.js}

@@ -1,6 +1,22 @@
 import { c as closest } from './dom-utils-f6086cd3.js';
 import { b as buildCustomEvent } from './event-utils-8de63ec3.js';
 
+/**
+ * Dispatches an event which retrieves the `SearchBoxSuggestionsBindings` on a configured parent search box.
+ *
+ * @param event Event sent from the registered query suggestions to the parent search box
+ * @param element Element on which to dispatch the event, which must be the child of a configured search box
+ * @param allowedSearchBoxElements Optional array of allowed search box element selectors
+ *
+ * @throws Error if the element is not a child of an allowed search box element
+ */
+const dispatchSearchBoxSuggestionsEvent = (event, element, allowedSearchBoxElements = searchBoxElements) => {
+    const interfaceElement = closest(element, searchBoxElements.join(', '));
+    if (!interfaceElement) {
+        throw new Error(`The "${element.nodeName.toLowerCase()}" component was not handled, as it is not a child of the following elements: ${allowedSearchBoxElements.join(', ')}`);
+    }
+    void dispatchSearchBoxSuggestionsEventEventually(interfaceElement, element, event);
+};
 const searchBoxElements = [
     'atomic-search-box',
     'atomic-insight-search-box',
@@ -18,25 +34,7 @@ const dispatchSearchBoxSuggestionsEventEventually = async (interfaceElement, ele
     }
     element.dispatchEvent(buildCustomEvent('atomic/searchBoxSuggestion/register', event));
 };
-/**
- * Dispatches an event which retrieves the `SearchBoxSuggestionsBindings` on a configured parent search box.
- * @param event Event sent from the registered query suggestions to the parent search box.
- * @param element Element on which to dispatch the event, which must be the child of a configured search box.
- */
-const dispatchSearchBoxSuggestionsEvent = (event, element, allowedSearchBoxElements = searchBoxElements) => {
-    const interfaceElement = closest(element, searchBoxElements.join(', '));
-    if (!interfaceElement) {
-        throw new Error(`The "${element.nodeName.toLowerCase()}" component was not handled, as it is not a child of the following elements: ${allowedSearchBoxElements.join(', ')}`);
-    }
-    void dispatchSearchBoxSuggestionsEventEventually(interfaceElement, element, event);
-};
-function elementHasNoQuery(el) {
-    return !el.query || el.query.trim() === '';
-}
-function elementHasQuery(el) {
-    return !!el.query && el.query.trim() !== '';
-}
 
-export { elementHasNoQuery as a, dispatchSearchBoxSuggestionsEvent as d, elementHasQuery as e };
+export { dispatchSearchBoxSuggestionsEvent as d };
 
-//# sourceMappingURL=suggestions-common-2b20db26.js.map
+//# sourceMappingURL=suggestions-events-b7a6f007.js.map

package/dist/esm/suggestions-events-b7a6f007.js.map

@@ -0,0 +1 @@
+{"file":"suggestions-events-b7a6f007.js","mappings":";;;AAOA;;;;;;;;;MASa,iCAAiC,GAAG,CAI/C,KAA+D,EAC/D,OAAoB,EACpB,2BAA0E,iBAAiB;IAE3F,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACxE,IAAI,CAAC,gBAAgB,EAAE;QACrB,MAAM,IAAI,KAAK,CACb,QAAQ,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,gFAAgF,wBAAwB,CAAC,IAAI,CACjJ,IAAI,CACL,EAAE,CACJ,CAAC;KACH;IACD,KAAK,2CAA2C,CAC9C,gBAAgB,EAChB,OAAO,EACP,KAAK,CACN,CAAC;AACJ,EAAE;AAEF,MAAM,iBAAiB,GAAG;IACxB,mBAAmB;IACnB,2BAA2B;IAC3B,4BAA4B;CACpB,CAAC;AAEX,MAAM,mBAAmB,GAAG,CAAC,SAAkB,KAC7C,gBAAgB,IAAK,SAAwB;IAC5C,SAAwB,CAAC,cAAc,YAAY,OAAO,CAAC;AAE9D,MAAM,2CAA2C,GAAG,OAIlD,gBAAyB,EACzB,OAAoB,EACpB,KAA+D;IAE/D,MAAM,cAAc,CAAC,WAAW,CAAC,gBAAgB,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1E,IAAI,mBAAmB,CAAC,gBAAgB,CAAC,EAAE;QACzC,MAAM,gBAAgB,CAAC,cAAc,CAAC;KACvC;SAAM,IAAI,kBAAkB,IAAI,gBAAgB,EAAE;QACjD,MAAO,gBAAuC,CAAC,gBAAgB,EAAE,CAAC;KACnE;IACD,OAAO,CAAC,aAAa,CACnB,gBAAgB,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAC/D,CAAC;AACJ,CAAC;;;;","names":[],"sources":["src/components/common/suggestions/suggestions-events.ts"],"sourcesContent":["import type {HTMLStencilElement} from '@stencil/core/internal';\nimport type {LitElement} from 'lit';\nimport {closest} from '../../../utils/dom-utils';\nimport {buildCustomEvent} from '../../../utils/event-utils';\nimport type {AnyBindings} from '../interface/bindings';\nimport type {SearchBoxSuggestionsEvent} from './suggestions-types';\n\n/**\n * Dispatches an event which retrieves the `SearchBoxSuggestionsBindings` on a configured parent search box.\n *\n * @param event Event sent from the registered query suggestions to the parent search box\n * @param element Element on which to dispatch the event, which must be the child of a configured search box\n * @param allowedSearchBoxElements Optional array of allowed search box element selectors\n *\n * @throws Error if the element is not a child of an allowed search box element\n */\nexport const dispatchSearchBoxSuggestionsEvent = <\n  SearchBoxController,\n  Bindings = AnyBindings,\n>(\n  event: SearchBoxSuggestionsEvent<SearchBoxController, Bindings>,\n  element: HTMLElement,\n  allowedSearchBoxElements: readonly (typeof searchBoxElements)[number][] = searchBoxElements\n) => {\n  const interfaceElement = closest(element, searchBoxElements.join(', '));\n  if (!interfaceElement) {\n    throw new Error(\n      `The \"${element.nodeName.toLowerCase()}\" component was not handled, as it is not a child of the following elements: ${allowedSearchBoxElements.join(\n        ', '\n      )}`\n    );\n  }\n  void dispatchSearchBoxSuggestionsEventEventually(\n    interfaceElement,\n    element,\n    event\n  );\n};\n\nconst searchBoxElements = [\n  'atomic-search-box',\n  'atomic-insight-search-box',\n  'atomic-commerce-search-box',\n] as const;\n\nconst isLitElementLoosely = (candidate: unknown): candidate is LitElement =>\n  'updateComplete' in (candidate as LitElement) &&\n  (candidate as LitElement).updateComplete instanceof Promise;\n\nconst dispatchSearchBoxSuggestionsEventEventually = async <\n  SearchBoxController,\n  Bindings = AnyBindings,\n>(\n  interfaceElement: Element,\n  element: HTMLElement,\n  event: SearchBoxSuggestionsEvent<SearchBoxController, Bindings>\n) => {\n  await customElements.whenDefined(interfaceElement.nodeName.toLowerCase());\n  if (isLitElementLoosely(interfaceElement)) {\n    await interfaceElement.updateComplete;\n  } else if ('componentOnReady' in interfaceElement) {\n    await (interfaceElement as HTMLStencilElement).componentOnReady();\n  }\n  element.dispatchEvent(\n    buildCustomEvent('atomic/searchBoxSuggestion/register', event)\n  );\n};\n"],"version":3}

package/dist/esm/suggestions-utils-591559a0.js

@@ -0,0 +1,22 @@
+/**
+ * Checks if a search box suggestion element has no query.
+ *
+ * @param el - The search box suggestion element to check
+ * @returns True if the element has no query or the query is whitespace-only
+ */
+function elementHasNoQuery(el) {
+    return !el.query || el.query.trim() === '';
+}
+/**
+ * Checks if a search box suggestion element has a query.
+ *
+ * @param el - The search box suggestion element to check
+ * @returns True if the element has a non-empty, non-whitespace query
+ */
+function elementHasQuery(el) {
+    return !!el.query && el.query.trim() !== '';
+}
+
+export { elementHasQuery as a, elementHasNoQuery as e };
+
+//# sourceMappingURL=suggestions-utils-591559a0.js.map

package/dist/esm/suggestions-utils-591559a0.js.map

@@ -0,0 +1 @@
+{"file":"suggestions-utils-591559a0.js","mappings":"AAEA;;;;;;SAMgB,iBAAiB,CAAC,EAA8B;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7C,CAAC;AAED;;;;;;SAMgB,eAAe,CAAC,EAA8B;IAC5D,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC9C;;;;","names":[],"sources":["src/components/common/suggestions/suggestions-utils.ts"],"sourcesContent":["import type {SearchBoxSuggestionElement} from './suggestions-types';\n\n/**\n * Checks if a search box suggestion element has no query.\n *\n * @param el - The search box suggestion element to check\n * @returns True if the element has no query or the query is whitespace-only\n */\nexport function elementHasNoQuery(el: SearchBoxSuggestionElement): boolean {\n  return !el.query || el.query.trim() === '';\n}\n\n/**\n * Checks if a search box suggestion element has a query.\n *\n * @param el - The search box suggestion element to check\n * @returns True if the element has a non-empty, non-whitespace query\n */\nexport function elementHasQuery(el: SearchBoxSuggestionElement): boolean {\n  return !!el.query && el.query.trim() !== '';\n}\n"],"version":3}

package/dist/esm/version.js

@@ -1,2 +1,2 @@
-export const headlessVersion = '3.31.0';
-export const atomicVersion = '3.33.8-pre.7328338555';
+export const headlessVersion = '3.31.1-pre.74a50cd6e2';
+export const atomicVersion = '3.33.8-pre.74a50cd6e2';

package/dist/types/components/commerce/atomic-commerce-breadbox/atomic-commerce-breadbox.d.ts

@@ -53,8 +53,7 @@ export declare class AtomicCommerceBreadbox extends LitElement implements Initia
     pathLimit: number;
     initialize(): void;
     willUpdate(changedProperties: Map<string, unknown>): void;
-    firstUpdated(): void;
-    updateCompleted(): void;
+    updated(): void;
     private validateProps;
     disconnectedCallback(): void;
     private get breadcrumbs();

package/dist/types/components/commerce/atomic-commerce-interface/atomic-commerce-interface.d.ts

@@ -1,4 +1,5 @@
 import { type CommerceEngine, type CommerceEngineConfiguration, type Context, type LogLevel, type ProductListing, type ProductListingSummaryState, type Search, type SearchSummaryState, type Summary, type UrlManager } from '@coveo/headless/commerce';
+import type { CurrencyCodeISO4217 } from '@coveo/relay-event-types';
 import { type i18n } from 'i18next';
 import { type CSSResultGroup, LitElement } from 'lit';
 import type { CommonBindings } from '../../common/interface/bindings';
@@ -26,7 +27,6 @@ export declare class AtomicCommerceInterface extends AtomicCommerceInterface_bas
     private unsubscribeSummary?;
     private initialized;
     private store;
-    private _mobileBreakpointController;
     private interfaceController;
     static styles: CSSResultGroup;
     /**
@@ -50,7 +50,13 @@ export declare class AtomicCommerceInterface extends AtomicCommerceInterface_bas
     /**
      * The commerce interface language.
      *
-     * Will default to the value set in the Headless engine context if not provided.
+     * Will default to the value set in the Headless engine context if not
+     * provided.
+     *
+     * @deprecated - This property will be removed in the next major version of
+     * Atomic (v4). Rather than using this property, set the initial language
+     * through the engine configuration when calling `initializeWithEngine`, and
+     * update the language as needed using the `updateLocale` method.
      */
     language?: string;
     /**
@@ -63,7 +69,7 @@ export declare class AtomicCommerceInterface extends AtomicCommerceInterface_bas
      */
     reflectStateInUrl: boolean;
     /**
-     * Disable state reflection in the URL parameters.
+     * Whether to disable state reflection in the URL parameters.
      */
     disableStateReflectionInUrl: boolean;
     /**
@@ -101,6 +107,26 @@ export declare class AtomicCommerceInterface extends AtomicCommerceInterface_bas
      * Executes the first request after initializing connection to the headless commerce engine.
      */
     executeFirstRequest(): Promise<void>;
+    /**
+     * Updates the locale settings for the commerce interface and headless commerce
+     * engine. Only the provided parameters will be updated.
+     *
+     * Calling this method affects the localization of the interface as well as
+     * the catalog configuration being used by the Commerce API. If the resulting
+     * language-country-currency combination matches no existing catalog
+     * configuration in your Coveo organization, requests made through the
+     * commerce engine will start failing.
+     *
+     * @param language - (Optional) The IETF language code tag (e.g., `en`).
+     * @param country - (Optional) The ISO-3166-1 country tag (e.g., `US`).
+     * @param currency - (Optional) The ISO-4217 currency code (e.g., `USD`).
+     *
+     * @example
+     * ```typescript
+     * interface.updateLocale('fr', 'CA', 'CAD');
+     * ```
+     */
+    updateLocale(language?: string, country?: string, currency?: CurrencyCodeISO4217): void;
     toggleAnalytics(): void;
     updateIconAssetsPath(): void;
     updateLanguage(): void;
@@ -116,6 +142,7 @@ export declare class AtomicCommerceInterface extends AtomicCommerceInterface_bas
     private initSummary;
     private initUrlManager;
     private internalInitialization;
+    private isNewLocale;
     private onHashChange;
     scrollToTop(): void;
     private updateHash;

package/dist/types/components/commerce/atomic-commerce-recommendation-interface/atomic-commerce-recommendation-interface.d.ts

@@ -103,6 +103,7 @@ export declare class AtomicCommerceRecommendationInterface extends AtomicCommerc
     private initContext;
     private getBindings;
     private initLanguage;
+    private isNewLocale;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/dist/types/components/commerce/atomic-commerce-search-box/atomic-commerce-search-box.d.ts

@@ -137,6 +137,7 @@ export declare class AtomicCommerceSearchBox extends LitElement implements Initi
     private renderSuggestions;
     private renderPanel;
     private renderSuggestion;
+    private renderSlotContent;
     render(): import("lit-html").TemplateResult<1>;
 }
 declare global {

package/dist/types/components/commerce/atomic-commerce-search-box-instant-products/atomic-commerce-search-box-instant-products.d.ts

@@ -2,7 +2,7 @@ import { type Product, type SearchBox } from '@coveo/headless/commerce';
 import { LitElement } from 'lit';
 import type { ItemRenderingFunction } from "../../common/item-list/item-list-common";
 import type { ItemDisplayDensity, ItemDisplayImageSize } from "../../common/layout/display-options";
-import { type SearchBoxSuggestions, type SearchBoxSuggestionsBindings } from "../../common/suggestions/suggestions-common";
+import type { SearchBoxSuggestions, SearchBoxSuggestionsBindings } from "../../common/suggestions/suggestions-types";
 import type { SearchBoxSuggestionsComponent } from "../../../decorators/types";
 import type { CommerceBindings } from '../atomic-commerce-interface/atomic-commerce-interface';
 export type AriaLabelGenerator = (bindings: CommerceBindings, product: Product) => string | undefined;

package/dist/types/components/commerce/atomic-commerce-search-box-query-suggestions/atomic-commerce-search-box-query-suggestions.d.ts

@@ -1,6 +1,6 @@
 import { type SearchBox } from '@coveo/headless/commerce';
 import { LitElement } from 'lit';
-import { type SearchBoxSuggestions, type SearchBoxSuggestionsBindings } from "../../common/suggestions/suggestions-common";
+import type { SearchBoxSuggestions, SearchBoxSuggestionsBindings } from "../../common/suggestions/suggestions-types";
 import type { SearchBoxSuggestionsComponent } from "../../../decorators/types";
 import type { CommerceBindings } from '../atomic-commerce-interface/atomic-commerce-interface';
 /**

package/dist/types/components/commerce/atomic-commerce-search-box-recent-queries/atomic-commerce-search-box-recent-queries.d.ts

@@ -1,7 +1,7 @@
 import { type SearchBox } from '@coveo/headless/commerce';
 import { LitElement } from 'lit';
 import type { SearchBoxSuggestionsComponent } from "../../../decorators/types";
-import { type SearchBoxSuggestions, type SearchBoxSuggestionsBindings } from '../../common/suggestions/suggestions-common';
+import type { SearchBoxSuggestions, SearchBoxSuggestionsBindings } from '../../common/suggestions/suggestions-types';
 import type { CommerceBindings } from '../atomic-commerce-interface/atomic-commerce-interface';
 /**
  * The `atomic-commerce-search-box-recent-queries` component can be added as a child of an `atomic-commerce-search-box` component, allowing for the configuration of recent query suggestions.

package/dist/types/components/common/atomic-suggestion-renderer/atomic-suggestion-renderer.d.ts

@@ -1,5 +1,5 @@
 import { i18n } from 'i18next';
-import { SearchBoxSuggestionElement } from '../suggestions/suggestions-common';
+import { SearchBoxSuggestionElement } from '../suggestions/suggestions-types';
 /**
  * The `atomic-suggestion-renderer` component is used to render individual suggestions. It was created to isolate
  * the rendering logic of the 'content' property of the `SearchBoxSuggestionElement` interface. This property can be Stencil

package/dist/types/components/common/suggestions/instant-item.d.ts

@@ -1,5 +1,5 @@
 import type { i18n } from 'i18next';
-import type { SearchBoxSuggestionElement } from './suggestions-common';
+import type { SearchBoxSuggestionElement } from './suggestions-types';
 export declare const getPartialInstantItemElement: (i18n: i18n, itemTitle: string, itemUniqueId: string) => Pick<SearchBoxSuggestionElement, "ariaLabel" | "key" | "part">;
 export declare const getPartialInstantItemShowAllElement: (i18n: i18n) => Pick<SearchBoxSuggestionElement, "key" | "part" | "ariaLabel">;
 interface InstantItemShowAllButtonProps {

package/dist/types/components/common/suggestions/query-suggestions.d.ts

@@ -1,5 +1,5 @@
 import type { i18n } from 'i18next';
-import type { SearchBoxSuggestionElement } from './suggestions-common.js';
+import type { SearchBoxSuggestionElement } from './suggestions-types.js';
 interface Suggestion {
     highlightedValue: string;
     rawValue: string;

package/dist/types/components/common/suggestions/recent-queries.d.ts

@@ -1,5 +1,5 @@
 import type { i18n } from 'i18next';
-import type { SearchBoxSuggestionElement } from './suggestions-common';
+import type { SearchBoxSuggestionElement } from './suggestions-types';
 export declare const getPartialRecentQueryElement: (value: string, i18n: i18n) => Pick<SearchBoxSuggestionElement, "ariaLabel" | "key" | "query" | "part">;
 export declare const getPartialRecentQueryClearElement: (i18n: i18n) => Pick<SearchBoxSuggestionElement, "ariaLabel" | "key" | "part" | "hideIfLast">;
 export interface RecentQueriesContainerProps {

package/dist/types/components/common/suggestions/stencil-instant-item.d.ts

@@ -1,6 +1,6 @@
 import { FunctionalComponent } from '../../../stencil-public-runtime';
 import { i18n } from 'i18next';
-import { SearchBoxSuggestionElement } from './suggestions-common';
+import { SearchBoxSuggestionElement } from './suggestions-types';
 export declare const getPartialInstantItemElement: (i18n: i18n, itemTitle: string, itemUniqueId: string) => Pick<SearchBoxSuggestionElement, "ariaLabel" | "key" | "part">;
 export declare const getPartialInstantItemShowAllElement: (i18n: i18n) => Pick<SearchBoxSuggestionElement, "key" | "part" | "ariaLabel">;
 interface InstantItemShowAllButtonProps {

package/dist/types/components/common/suggestions/stencil-query-suggestions.d.ts

@@ -1,6 +1,6 @@
 import { FunctionalComponent } from '../../../stencil-public-runtime';
 import { i18n } from 'i18next';
-import { SearchBoxSuggestionElement } from './suggestions-common.js';
+import { SearchBoxSuggestionElement } from './suggestions-types.js';
 interface Suggestion {
     highlightedValue: string;
     rawValue: string;

package/dist/types/components/common/suggestions/stencil-recent-queries.d.ts

@@ -1,6 +1,6 @@
 import { FunctionalComponent } from '../../../stencil-public-runtime';
 import { i18n } from 'i18next';
-import { SearchBoxSuggestionElement } from './suggestions-common';
+import { SearchBoxSuggestionElement } from './suggestions-types';
 export declare const getPartialRecentQueryElement: (value: string, i18n: i18n) => Pick<SearchBoxSuggestionElement, "ariaLabel" | "key" | "query" | "part">;
 export declare const getPartialRecentQueryClearElement: (i18n: i18n) => Pick<SearchBoxSuggestionElement, "ariaLabel" | "key" | "part" | "hideIfLast">;
 export declare const RecentQueriesContainer: FunctionalComponent;

package/dist/types/components/common/suggestions/stencil-suggestion-manager.d.ts

@@ -1,4 +1,4 @@
-import { type SearchBoxSuggestionElement, type SearchBoxSuggestionsBindings, type SearchBoxSuggestionsEvent } from './suggestions-common';
+import type { SearchBoxSuggestionElement, SearchBoxSuggestionsBindings, SearchBoxSuggestionsEvent } from './suggestions-types';
 /**
  * List of suggestions that will be displayed along other lists (e.g recent queries) when the search box's input is selected.
  */

package/dist/types/components/common/suggestions/suggestion-manager.d.ts

@@ -1,5 +1,5 @@
 import type { LitElement } from 'lit';
-import { type SearchBoxSuggestionElement, type SearchBoxSuggestionsBindings, type SearchBoxSuggestionsEvent } from './suggestions-common';
+import type { SearchBoxSuggestionElement, SearchBoxSuggestionsBindings, SearchBoxSuggestionsEvent } from './suggestions-types';
 /**
  * List of suggestions that will be displayed along other lists (e.g recent queries) when the search box's input is selected.
  */

package/dist/types/components/common/suggestions/suggestions-events.d.ts

@@ -0,0 +1,14 @@
+import type { AnyBindings } from '../interface/bindings';
+import type { SearchBoxSuggestionsEvent } from './suggestions-types';
+/**
+ * Dispatches an event which retrieves the `SearchBoxSuggestionsBindings` on a configured parent search box.
+ *
+ * @param event Event sent from the registered query suggestions to the parent search box
+ * @param element Element on which to dispatch the event, which must be the child of a configured search box
+ * @param allowedSearchBoxElements Optional array of allowed search box element selectors
+ *
+ * @throws Error if the element is not a child of an allowed search box element
+ */
+export declare const dispatchSearchBoxSuggestionsEvent: <SearchBoxController, Bindings = AnyBindings>(event: SearchBoxSuggestionsEvent<SearchBoxController, Bindings>, element: HTMLElement, allowedSearchBoxElements?: readonly (typeof searchBoxElements)[number][]) => void;
+declare const searchBoxElements: readonly ["atomic-search-box", "atomic-insight-search-box", "atomic-commerce-search-box"];
+export {};

package/dist/types/components/common/suggestions/{suggestions-common.d.ts → suggestions-types.d.ts}

@@ -68,15 +68,6 @@ export interface SearchBoxSuggestions {
      */
     onSuggestedQueryChange?(q: string): Promise<unknown>;
 }
-/**
- * Event sent from the registered query suggestions to the parent search box.
- */
-export type SearchBoxSuggestionsEvent<SearchBoxController, Bindings = AnyBindings> = (
-/**
- * The bindings passed from the search box to the suggestions.
- */
-bindings: SearchBoxSuggestionsBindings<SearchBoxController, Bindings>) => SearchBoxSuggestions;
-declare const searchBoxElements: readonly ["atomic-search-box", "atomic-insight-search-box", "atomic-commerce-search-box"];
 /**
  * The bindings passed from the search box to the suggestions.
  */
@@ -124,11 +115,10 @@ export type SearchBoxSuggestionsBindings<SearchBoxController, Bindings = AnyBind
     getSuggestionElements(): SearchBoxSuggestionElement[];
 };
 /**
- * Dispatches an event which retrieves the `SearchBoxSuggestionsBindings` on a configured parent search box.
- * @param event Event sent from the registered query suggestions to the parent search box.
- * @param element Element on which to dispatch the event, which must be the child of a configured search box.
+ * Event sent from the registered query suggestions to the parent search box.
  */
-export declare const dispatchSearchBoxSuggestionsEvent: <SearchBoxController, Bindings = AnyBindings>(event: SearchBoxSuggestionsEvent<SearchBoxController, Bindings>, element: HTMLElement, allowedSearchBoxElements?: readonly (typeof searchBoxElements)[number][]) => void;
-export declare function elementHasNoQuery(el: SearchBoxSuggestionElement): boolean;
-export declare function elementHasQuery(el: SearchBoxSuggestionElement): boolean;
-export {};
+export type SearchBoxSuggestionsEvent<SearchBoxController, Bindings = AnyBindings> = (
+/**
+ * The bindings passed from the search box to the suggestions.
+ */
+bindings: SearchBoxSuggestionsBindings<SearchBoxController, Bindings>) => SearchBoxSuggestions;

package/dist/types/components/common/suggestions/suggestions-utils.d.ts

@@ -0,0 +1,15 @@
+import type { SearchBoxSuggestionElement } from './suggestions-types';
+/**
+ * Checks if a search box suggestion element has no query.
+ *
+ * @param el - The search box suggestion element to check
+ * @returns True if the element has no query or the query is whitespace-only
+ */
+export declare function elementHasNoQuery(el: SearchBoxSuggestionElement): boolean;
+/**
+ * Checks if a search box suggestion element has a query.
+ *
+ * @param el - The search box suggestion element to check
+ * @returns True if the element has a non-empty, non-whitespace query
+ */
+export declare function elementHasQuery(el: SearchBoxSuggestionElement): boolean;

package/dist/types/components/search/atomic-search-box/atomic-search-box.d.ts

@@ -2,7 +2,7 @@ import { SearchBox, StandaloneSearchBox } from '@coveo/headless';
 import { EventEmitter } from '../../../stencil-public-runtime';
 import { InitializableComponent } from '../../../utils/initialization-utils';
 import { RedirectionPayload } from '../../common/search-box/redirection-payload';
-import { SearchBoxSuggestionsEvent } from '../../common/suggestions/suggestions-common';
+import type { SearchBoxSuggestionsEvent } from '../../common/suggestions/suggestions-types';
 import { Bindings } from '../atomic-search-interface/atomic-search-interface';
 /**
  * The `atomic-search-box` component creates a search box with built-in support for suggestions.
@@ -161,5 +161,6 @@ export declare class AtomicSearchBox implements InitializableComponent<Bindings>
     private getSearchInputLabel;
     private announceNewActiveSuggestionToScreenReader;
     private announceNewSuggestionsToScreenReader;
+    private renderSlotContent;
     render(): any;
 }

package/dist/types/components/search/atomic-search-interface/atomic-search-interface.d.ts

@@ -1,10 +1,10 @@
 import { type LogLevel, type SearchEngine, type SearchEngineConfiguration, type SearchStatus, type UrlManager } from '@coveo/headless';
 import { type i18n } from 'i18next';
 import { type CSSResultGroup, LitElement } from 'lit';
-import type { CommonBindings, NonceBindings } from '../../common/interface/bindings';
-import { type BaseAtomicInterface } from '../../common/interface/interface-controller';
+import type { CommonBindings, NonceBindings } from "../../common/interface/bindings";
+import { type BaseAtomicInterface } from "../../common/interface/interface-controller";
 import { type SearchStore } from './store';
-import '../../common/atomic-modal/atomic-modal';
+import "../../common/atomic-modal/atomic-modal";
 export type InitializationOptions = SearchEngineConfiguration;
 export type Bindings = CommonBindings<SearchEngine, SearchStore, AtomicSearchInterface> & NonceBindings;
 declare const AtomicSearchInterface_base: typeof LitElement;
@@ -23,7 +23,6 @@ export declare class AtomicSearchInterface extends AtomicSearchInterface_base im
     private unsubscribeSearchStatus;
     private initialized;
     private store;
-    private _mobileBreakpointController;
     private interfaceController;
     static styles: CSSResultGroup;
     /**
@@ -80,7 +79,7 @@ export declare class AtomicSearchInterface extends AtomicSearchInterface_base im
      */
     reflectStateInUrl: boolean;
     /**
-     * Disable state reflection in the URL parameters.
+     * Whether to disable state reflection in the URL parameters.
      */
     disableStateReflectionInUrl: boolean;
     /**
@@ -111,7 +110,7 @@ export declare class AtomicSearchInterface extends AtomicSearchInterface_base im
      */
     enableRelevanceInspector: boolean;
     /**
-     * Disable the relevance inspector shortcut for this interface.
+     * Whether to disable the relevance inspector shortcut for this interface.
      */
     disableRelevanceInspector: boolean;
     private i18Initialized;
@@ -127,7 +126,7 @@ export declare class AtomicSearchInterface extends AtomicSearchInterface_base im
      */
     initialize(options: InitializationOptions): Promise<void>;
     /**
-     * Initializes the connection with an already preconfigured [headless search engine](https://docs.coveo.com/en/headless/latest/reference/modules/Search.html, as opposed to the `initialize` method, which will internally create a new search engine instance.
+     * Initializes the interface using the provided [headless search engine](https://docs.coveo.com/en/headless/latest/reference/modules/Search.html, as opposed to the `initialize` method which internally builds a search engine instance.
      * This bypasses the properties set on the component, such as analytics, searchHub, pipeline, language, timezone & logLevel.
      */
     initializeWithSearchEngine(engine: SearchEngine): Promise<void>;
@@ -149,6 +148,7 @@ export declare class AtomicSearchInterface extends AtomicSearchInterface_base im
     private getSearchConfiguration;
     private get fragment();
     private initUrlManager;
+    private handleRelevanceInspectorDoubleClick;
     private initRelevanceInspector;
     private initSearchStatus;
     private updateHash;

package/dist/types/components/search/search-box-suggestions/atomic-search-box-instant-results/atomic-search-box-instant-results.d.ts

@@ -2,7 +2,7 @@ import { Result, SearchBox } from '@coveo/headless';
 import { InitializableComponent } from '../../../../utils/initialization-utils';
 import { ItemRenderingFunction } from '../../../common/item-list/stencil-item-list-common';
 import { ItemDisplayDensity, ItemDisplayImageSize } from '../../../common/layout/display-options';
-import { SearchBoxSuggestions, SearchBoxSuggestionsBindings } from '../../../common/suggestions/suggestions-common';
+import type { SearchBoxSuggestions, SearchBoxSuggestionsBindings } from '../../../common/suggestions/suggestions-types';
 import { Bindings } from '../../atomic-search-interface/atomic-search-interface';
 export type AriaLabelGenerator = (bindings: Bindings, result: Result) => string | undefined;
 /**

package/dist/types/components.d.ts

@@ -24,7 +24,7 @@ import { Bindings } from "./components/search/atomic-search-interface/atomic-sea
 import { SearchStore } from "./components/search/atomic-search-interface/store";
 import { RedirectionPayload } from "./components/common/search-box/redirection-payload";
 import { AriaLabelGenerator } from "./components/search/search-box-suggestions/atomic-search-box-instant-results/atomic-search-box-instant-results";
-import { SearchBoxSuggestionElement } from "./components/common/suggestions/suggestions-common";
+import { SearchBoxSuggestionElement } from "./components/common/suggestions/suggestions-types";
 export { AutomaticFacet, CategoryFacetSortCriterion, DateFilterRange, DateRangeRequest, FacetResultsMustMatch, FacetSortCriterion, FoldedResult, GeneratedAnswer, GeneratedAnswerCitation, InlineLink, InteractiveCitation, InteractiveResult, NumericFilter, NumericFilterState, RangeFacetRangeAlgorithm, RangeFacetSortCriterion, RelativeDateUnit, Result, ResultTemplate, ResultTemplateCondition, SearchStatus } from "@coveo/headless";
 export { AtomicInterface } from "./utils/initialization-utils";
 export { AnyBindings } from "./components/common/interface/bindings";
@@ -44,7 +44,7 @@ export { Bindings } from "./components/search/atomic-search-interface/atomic-sea
 export { SearchStore } from "./components/search/atomic-search-interface/store";
 export { RedirectionPayload } from "./components/common/search-box/redirection-payload";
 export { AriaLabelGenerator } from "./components/search/search-box-suggestions/atomic-search-box-instant-results/atomic-search-box-instant-results";
-export { SearchBoxSuggestionElement } from "./components/common/suggestions/suggestions-common";
+export { SearchBoxSuggestionElement } from "./components/common/suggestions/suggestions-types";
 export namespace Components {
     /**
      * An automatic facet is a special type of facet generated by the automatic facets feature.

package/dist/types/decorators/types.d.ts

@@ -1,7 +1,7 @@
 import type { LitElement, TemplateResult } from 'lit';
 import type { TemplateResultType } from 'lit/directive-helpers.js';
 import type { AnyBindings } from '../components/common/interface/bindings';
-import type { SearchBoxSuggestions } from '../components/common/suggestions/suggestions-common';
+import type { SearchBoxSuggestions } from '../components/common/suggestions/suggestions-types';
 export type GenericRender<T extends TemplateResultType> = TemplateResult<T>;
 export type RenderGuardDecorator<Component, T extends TemplateResultType, Descriptor = TypedPropertyDescriptor<() => GenericRender<T>>> = (target: Component, propertyKey: 'render', descriptor: Descriptor) => Descriptor;
 /**

package/dist/types/index.d.ts

@@ -5,7 +5,9 @@ export { SelectChildProductEventArgs } from './components/commerce/atomic-produc
 export { productContext } from './components/commerce/product-template-component-utils/stencil-product-template-decorators';
 export { PopoverChildFacet } from './components/common/facets/popover/popover-type';
 export { RedirectionPayload } from './components/common/search-box/redirection-payload';
-export { dispatchSearchBoxSuggestionsEvent, SearchBoxSuggestionElement, SearchBoxSuggestions, SearchBoxSuggestionsBindings, SearchBoxSuggestionsEvent, } from './components/common/suggestions/suggestions-common';
+export { dispatchSearchBoxSuggestionsEvent } from './components/common/suggestions/suggestions-events';
+export type { SearchBoxSuggestionElement, SearchBoxSuggestions, SearchBoxSuggestionsBindings, SearchBoxSuggestionsEvent, } from './components/common/suggestions/suggestions-types';
+export { elementHasNoQuery, elementHasQuery, } from './components/common/suggestions/suggestions-utils';
 export { RecsBindings } from './components/recommendations/atomic-recs-interface/atomic-recs-interface';
 export { Bindings } from './components/search/atomic-search-interface/atomic-search-interface';
 export { resultContext } from './components/search/result-template-components/result-template-decorators';

package/docs/atomic-docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2025-09-24T16:25:18",
+  "timestamp": "2025-09-30T19:26:32",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.20.0",
@@ -15526,10 +15526,10 @@
       "docstring": "",
       "path": "src/components/common/layout/display-options.ts"
     },
-    "src/components/common/suggestions/suggestions-common.ts::SearchBoxSuggestionElement": {
+    "src/components/common/suggestions/suggestions-types.ts::SearchBoxSuggestionElement": {
       "declaration": "export interface SearchBoxSuggestionElement {\n  /**\n   * Stable identity which enables Stencil to reuse DOM elements for better performance.\n   * The best way to pick a key is to use a string that uniquely identifies that list item among its siblings (often your data will already have IDs).\n   */\n  key: string;\n  /**\n   * Rendered content of the element.\n   *\n   * @remarks\n   * The `VNode` type will be deprecated in v4 as we are detaching from Stencil.\n   */\n  content: Element | VNode;\n  /**\n   * Hook called when the selection is selected.\n   * @param e DOM event.\n   */\n  onSelect?(e: Event): void;\n  /**\n   * The query associated with the suggestion which will replace the query in the search box if the suggestion is selected.\n   */\n  query?: string;\n  /**\n   * For improved accessibility, provide this property with additional information.\n   * https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-label\n   */\n  ariaLabel?: string;\n  /**\n   * Adds a specific shadow part attribute that can be selected with the CSS ::part pseudo-element.\n   * https://developer.mozilla.org/en-US/docs/Web/CSS/::part\n   */\n  part?: string;\n  /**\n   * Hide the suggestion if it's the last in the list.\n   */\n  hideIfLast?: boolean;\n}",
       "docstring": "Element which will be rendered in the list of suggestions.",
-      "path": "src/components/common/suggestions/suggestions-common.ts"
+      "path": "src/components/common/suggestions/suggestions-types.ts"
     },
     "../headless/dist/definitions/index.d.ts::RelativeDateUnit": {
       "declaration": "any",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coveo/atomic",
   "type": "module",
-  "version": "3.33.8-pre.7328338555",
+  "version": "3.33.8-pre.74a50cd6e2",
   "description": "A web-component library for building modern UIs interfacing with the Coveo platform",
   "homepage": "https://docs.coveo.com/en/atomic/latest/",
   "repository": {
@@ -81,7 +81,7 @@
   },
   "dependencies": {
     "@coveo/bueno": "1.1.2",
-    "@coveo/headless": "3.31.0",
+    "@coveo/headless": "3.31.1-pre.74a50cd6e2",
     "@lit/context": "1.1.6",
     "@open-wc/lit-helpers": "0.7.0",
     "@popperjs/core": "2.11.8",
@@ -153,7 +153,7 @@
   },
   "peerDependencies": {
     "@coveo/bueno": "1.1.2",
-    "@coveo/headless": "3.31.0",
+    "@coveo/headless": "3.31.1-pre.74a50cd6e2",
     "typescript": ">=5.0.0"
   },
   "peerDependenciesMeta": {

package/dist/atomic/components/suggestions-common.js.map

@@ -1 +0,0 @@
-{"file":"suggestions-common.js","mappings":";;;AA0FA,MAAM,iBAAiB,GAAG;IACxB,mBAAmB;IACnB,2BAA2B;IAC3B,4BAA4B;CACpB,CAAC;AAoDX,MAAM,mBAAmB,GAAG,CAAC,SAAkB,KAC7C,gBAAgB,IAAK,SAAwB;IAC5C,SAAwB,CAAC,cAAc,YAAY,OAAO,CAAC;AAE9D,MAAM,2CAA2C,GAAG,OAIlD,gBAAyB,EACzB,OAAoB,EACpB,KAA+D;IAE/D,MAAM,cAAc,CAAC,WAAW,CAAC,gBAAgB,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1E,IAAI,mBAAmB,CAAC,gBAAgB,CAAC,EAAE;QACzC,MAAM,gBAAgB,CAAC,cAAc,CAAC;KACvC;SAAM,IAAI,kBAAkB,IAAI,gBAAgB,EAAE;QACjD,MAAO,gBAAuC,CAAC,gBAAgB,EAAE,CAAC;KACnE;IACD,OAAO,CAAC,aAAa,CACnB,gBAAgB,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAC/D,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;MAKa,iCAAiC,GAAG,CAI/C,KAA+D,EAC/D,OAAoB,EACpB,2BAA0E,iBAAiB;IAE3F,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,EAAE,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACxE,IAAI,CAAC,gBAAgB,EAAE;QACrB,MAAM,IAAI,KAAK,CACb,QAAQ,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,gFAAgF,wBAAwB,CAAC,IAAI,CACjJ,IAAI,CACL,EAAE,CACJ,CAAC;KACH;IACD,KAAK,2CAA2C,CAC9C,gBAAgB,EAChB,OAAO,EACP,KAAK,CACN,CAAC;AACJ,EAAE;SAEc,iBAAiB,CAAC,EAA8B;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7C,CAAC;SAEe,eAAe,CAAC,EAA8B;IAC5D,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC9C;;;;","names":[],"sources":["src/components/common/suggestions/suggestions-common.ts"],"sourcesContent":["import type {VNode} from '@stencil/core';\nimport type {HTMLStencilElement} from '@stencil/core/internal';\nimport type {LitElement} from 'lit';\nimport {closest} from '../../../utils/dom-utils';\nimport {buildCustomEvent} from '../../../utils/event-utils';\nimport type {AnyBindings} from '../interface/bindings';\n\n/**\n * Element which will be rendered in the list of suggestions.\n */\nexport interface SearchBoxSuggestionElement {\n  /**\n   * Stable identity which enables Stencil to reuse DOM elements for better performance.\n   * The best way to pick a key is to use a string that uniquely identifies that list item among its siblings (often your data will already have IDs).\n   */\n  key: string;\n  /**\n   * Rendered content of the element.\n   *\n   * @remarks\n   * The `VNode` type will be deprecated in v4 as we are detaching from Stencil.\n   */\n  content: Element | VNode;\n  /**\n   * Hook called when the selection is selected.\n   * @param e DOM event.\n   */\n  onSelect?(e: Event): void;\n  /**\n   * The query associated with the suggestion which will replace the query in the search box if the suggestion is selected.\n   */\n  query?: string;\n  /**\n   * For improved accessibility, provide this property with additional information.\n   * https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-label\n   */\n  ariaLabel?: string;\n  /**\n   * Adds a specific shadow part attribute that can be selected with the CSS ::part pseudo-element.\n   * https://developer.mozilla.org/en-US/docs/Web/CSS/::part\n   */\n  part?: string;\n  /**\n   * Hide the suggestion if it's the last in the list.\n   */\n  hideIfLast?: boolean;\n}\n\n/**\n * List of suggestions that will be displayed along other lists (e.g recent queries) when the search box's input is selected.\n */\nexport interface SearchBoxSuggestions {\n  /**\n   * The search box will sort the position of suggestions using this value. The lowest value being first.\n   * By default, the DOM position will be used.\n   */\n  position: number;\n  /**\n   * Whether the suggestions should be listed in the right or left panel. By default, the suggestions are listed in the right panel.\n   */\n  panel?: 'left' | 'right';\n  /**\n   * Method that returns the list of elements which will be rendered in the list of suggestions.\n   */\n  renderItems(): SearchBoxSuggestionElement[];\n  /**\n   * Hook called when the user changes the search box's input value. This can lead to all the query suggestions being updated.\n   */\n  onInput?(): Promise<unknown>;\n  /**\n   * Hook called when the suggested query changes as a user traverses through the list of suggestions.\n   * This is used for instant results, which are rendered based on the current suggested query.\n   * @param q The new suggested query.\n   */\n  onSuggestedQueryChange?(q: string): Promise<unknown>;\n}\n\n/**\n * Event sent from the registered query suggestions to the parent search box.\n */\nexport type SearchBoxSuggestionsEvent<\n  SearchBoxController,\n  Bindings = AnyBindings,\n> = (\n  /**\n   * The bindings passed from the search box to the suggestions.\n   */\n  bindings: SearchBoxSuggestionsBindings<SearchBoxController, Bindings>\n) => SearchBoxSuggestions;\n\nconst searchBoxElements = [\n  'atomic-search-box',\n  'atomic-insight-search-box',\n  'atomic-commerce-search-box',\n] as const;\n\n/**\n * The bindings passed from the search box to the suggestions.\n */\nexport type SearchBoxSuggestionsBindings<\n  SearchBoxController,\n  Bindings = AnyBindings,\n> = Bindings & {\n  /**\n   * The unique id of the search box.\n   */\n  id: string;\n  /**\n   * Whether the search box is [standalone](https://docs.coveo.com/en/atomic/latest/usage/ssb/).\n   */\n  isStandalone: boolean;\n  /**\n   * The search box headless controller.\n   */\n  searchBoxController: SearchBoxController;\n  /**\n   * The number of queries to display when the user interacts with the search box.\n   */\n  numberOfQueries: number;\n  /**\n   * Whether to clear all active query filters when the end user submits a new query from the search box.\n   */\n  clearFilters: boolean;\n  /**\n   * Retrieves the suggested query, meaning the query that would be sent if the search is executed.\n   * The suggested query changes as a user traverses through the list of suggestions.\n   */\n  suggestedQuery(): string;\n  /**\n   * Removes the current suggestions.\n   */\n  clearSuggestions(): void;\n  /**\n   * Triggers update & retrieval of all suggestions.\n   */\n  triggerSuggestions(): void;\n  /**\n   * Retrieves the current suggestions.\n   */\n  getSuggestions(): SearchBoxSuggestions[];\n  /**\n   * Retrieves the current suggestions elements.\n   */\n  getSuggestionElements(): SearchBoxSuggestionElement[];\n};\n\nconst isLitElementLoosely = (candidate: unknown): candidate is LitElement =>\n  'updateComplete' in (candidate as LitElement) &&\n  (candidate as LitElement).updateComplete instanceof Promise;\n\nconst dispatchSearchBoxSuggestionsEventEventually = async <\n  SearchBoxController,\n  Bindings = AnyBindings,\n>(\n  interfaceElement: Element,\n  element: HTMLElement,\n  event: SearchBoxSuggestionsEvent<SearchBoxController, Bindings>\n) => {\n  await customElements.whenDefined(interfaceElement.nodeName.toLowerCase());\n  if (isLitElementLoosely(interfaceElement)) {\n    await interfaceElement.updateComplete;\n  } else if ('componentOnReady' in interfaceElement) {\n    await (interfaceElement as HTMLStencilElement).componentOnReady();\n  }\n  element.dispatchEvent(\n    buildCustomEvent('atomic/searchBoxSuggestion/register', event)\n  );\n};\n\n/**\n * Dispatches an event which retrieves the `SearchBoxSuggestionsBindings` on a configured parent search box.\n * @param event Event sent from the registered query suggestions to the parent search box.\n * @param element Element on which to dispatch the event, which must be the child of a configured search box.\n */\nexport const dispatchSearchBoxSuggestionsEvent = <\n  SearchBoxController,\n  Bindings = AnyBindings,\n>(\n  event: SearchBoxSuggestionsEvent<SearchBoxController, Bindings>,\n  element: HTMLElement,\n  allowedSearchBoxElements: readonly (typeof searchBoxElements)[number][] = searchBoxElements\n) => {\n  const interfaceElement = closest(element, searchBoxElements.join(', '));\n  if (!interfaceElement) {\n    throw new Error(\n      `The \"${element.nodeName.toLowerCase()}\" component was not handled, as it is not a child of the following elements: ${allowedSearchBoxElements.join(\n        ', '\n      )}`\n    );\n  }\n  void dispatchSearchBoxSuggestionsEventEventually(\n    interfaceElement,\n    element,\n    event\n  );\n};\n\nexport function elementHasNoQuery(el: SearchBoxSuggestionElement) {\n  return !el.query || el.query.trim() === '';\n}\n\nexport function elementHasQuery(el: SearchBoxSuggestionElement) {\n  return !!el.query && el.query.trim() !== '';\n}\n"],"version":3}