@coveo/atomic 3.33.8-pre.c54adf6755 → 3.33.8-pre.d75d8e5578

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

@@ -1,22 +1,6 @@
 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',
@@ -34,7 +18,25 @@ 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 { dispatchSearchBoxSuggestionsEvent as d };
+export { elementHasNoQuery as a, dispatchSearchBoxSuggestionsEvent as d, elementHasQuery as e };
 
-//# sourceMappingURL=suggestions-events-b7a6f007.js.map
+//# sourceMappingURL=suggestions-common-2b20db26.js.map

package/dist/esm/suggestions-common-2b20db26.js.map

@@ -0,0 +1 @@
+{"file":"suggestions-common-2b20db26.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}

package/dist/esm/version.js

@@ -1,2 +1,2 @@
-export const headlessVersion = '3.31.1-pre.c54adf6755';
-export const atomicVersion = '3.33.8-pre.c54adf6755';
+export const headlessVersion = '3.31.0';
+export const atomicVersion = '3.33.8-pre.d75d8e5578';

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

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

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

@@ -26,6 +26,7 @@ export declare class AtomicCommerceInterface extends AtomicCommerceInterface_bas
     private unsubscribeSummary?;
     private initialized;
     private store;
+    private _mobileBreakpointController;
     private interfaceController;
     static styles: CSSResultGroup;
     /**

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, SearchBoxSuggestionsBindings } from "../../common/suggestions/suggestions-types";
+import { type SearchBoxSuggestions, type SearchBoxSuggestionsBindings } from "../../common/suggestions/suggestions-common";
 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, SearchBoxSuggestionsBindings } from "../../common/suggestions/suggestions-types";
+import { type SearchBoxSuggestions, type SearchBoxSuggestionsBindings } from "../../common/suggestions/suggestions-common";
 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, SearchBoxSuggestionsBindings } from '../../common/suggestions/suggestions-types';
+import { type SearchBoxSuggestions, type SearchBoxSuggestionsBindings } from '../../common/suggestions/suggestions-common';
 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-types';
+import { SearchBoxSuggestionElement } from '../suggestions/suggestions-common';
 /**
  * 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-types';
+import type { SearchBoxSuggestionElement } from './suggestions-common';
 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-types.js';
+import type { SearchBoxSuggestionElement } from './suggestions-common.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-types';
+import type { SearchBoxSuggestionElement } from './suggestions-common';
 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-types';
+import { SearchBoxSuggestionElement } from './suggestions-common';
 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-types.js';
+import { SearchBoxSuggestionElement } from './suggestions-common.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-types';
+import { SearchBoxSuggestionElement } from './suggestions-common';
 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, SearchBoxSuggestionsBindings, SearchBoxSuggestionsEvent } from './suggestions-types';
+import { type SearchBoxSuggestionElement, type SearchBoxSuggestionsBindings, type SearchBoxSuggestionsEvent } from './suggestions-common';
 /**
  * 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, SearchBoxSuggestionsBindings, SearchBoxSuggestionsEvent } from './suggestions-types';
+import { type SearchBoxSuggestionElement, type SearchBoxSuggestionsBindings, type SearchBoxSuggestionsEvent } from './suggestions-common';
 /**
  * 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-types.d.ts → suggestions-common.d.ts}

@@ -68,6 +68,15 @@ 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.
  */
@@ -115,10 +124,11 @@ export type SearchBoxSuggestionsBindings<SearchBoxController, Bindings = AnyBind
     getSuggestionElements(): SearchBoxSuggestionElement[];
 };
 /**
- * Event sent from the registered query suggestions to the parent search box.
+ * 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.
  */
-export type SearchBoxSuggestionsEvent<SearchBoxController, Bindings = AnyBindings> = (
-/**
- * The bindings passed from the search box to the suggestions.
- */
-bindings: SearchBoxSuggestionsBindings<SearchBoxController, Bindings>) => SearchBoxSuggestions;
+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 {};

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 type { SearchBoxSuggestionsEvent } from '../../common/suggestions/suggestions-types';
+import { SearchBoxSuggestionsEvent } from '../../common/suggestions/suggestions-common';
 import { Bindings } from '../atomic-search-interface/atomic-search-interface';
 /**
  * The `atomic-search-box` component creates a search box with built-in support for suggestions.

package/dist/types/components/search/index.d.ts

@@ -1,4 +1,3 @@
 export { AtomicQuerySummary } from './atomic-query-summary/atomic-query-summary.js';
 export { AtomicResultsPerPage } from './atomic-results-per-page/atomic-results-per-page.js';
-export { AtomicSearchBoxQuerySuggestions } from './atomic-search-box-query-suggestions/atomic-search-box-query-suggestions.js';
 export { AtomicSearchLayout } from './atomic-search-layout/atomic-search-layout.js';

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 type { SearchBoxSuggestions, SearchBoxSuggestionsBindings } from '../../../common/suggestions/suggestions-types';
+import { SearchBoxSuggestions, SearchBoxSuggestionsBindings } from '../../../common/suggestions/suggestions-common';
 import { Bindings } from '../../atomic-search-interface/atomic-search-interface';
 export type AriaLabelGenerator = (bindings: Bindings, result: Result) => string | undefined;
 /**

package/dist/types/components/search/{atomic-search-box-query-suggestions → search-box-suggestions/atomic-search-box-query-suggestions}/atomic-search-box-query-suggestions.d.ts

@@ -1,13 +1,10 @@
-import { LitElement } from 'lit';
-import type { LitElementWithError } from "../../../decorators/types";
-import type { Bindings } from '../atomic-search-interface/interfaces';
 /**
  * The `atomic-search-box-query-suggestions` component can be added as a child of an `atomic-search-box` component, allowing for the configuration of query suggestion behavior.
  */
-export declare class AtomicSearchBoxQuerySuggestions extends LitElement implements LitElementWithError {
-    private suggestionsBindings;
+export declare class AtomicSearchBoxQuerySuggestions {
+    private bindings;
+    private host;
     error: Error;
-    bindings: Bindings;
     /**
      * The SVG icon to display.
      *
@@ -19,20 +16,14 @@ export declare class AtomicSearchBoxQuerySuggestions extends LitElement implemen
     /**
      * The maximum number of suggestions that will be displayed if the user has typed something into the input field.
      */
-    maxWithQuery: number;
+    maxWithQuery?: number;
     /**
      * The maximum number of suggestions that will be displayed initially when the input field is empty.
      */
-    maxWithoutQuery: number;
-    initialize(): void;
-    connectedCallback(): void;
-    private initializeQuerySuggestions;
+    maxWithoutQuery?: number;
+    componentWillLoad(): void;
+    private initialize;
     private renderItems;
     private renderItem;
-    render(): import("lit-html").TemplateResult<1>;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        'atomic-search-box-query-suggestions': AtomicSearchBoxQuerySuggestions;
-    }
+    render(): any;
 }

package/dist/types/components.d.ts

@@ -26,7 +26,7 @@ import { RedirectionPayload } from "./components/common/search-box/redirection-p
 import { AriaLabelGenerator } from "./components/search/search-box-suggestions/atomic-search-box-instant-results/atomic-search-box-instant-results";
 import { InitializationOptions } from "./components/search/atomic-search-interface/atomic-search-interface";
 import { StandaloneSearchBoxData } from "./utils/local-storage-utils";
-import { SearchBoxSuggestionElement } from "./components/common/suggestions/suggestions-types";
+import { SearchBoxSuggestionElement } from "./components/common/suggestions/suggestions-common";
 export { AutomaticFacet, CategoryFacetSortCriterion, DateFilterRange, DateRangeRequest, FacetResultsMustMatch, FacetSortCriterion, FoldedResult, GeneratedAnswer, GeneratedAnswerCitation, InlineLink, InteractiveCitation, InteractiveResult, LogLevel, NumericFilter, NumericFilterState, RangeFacetRangeAlgorithm, RangeFacetSortCriterion, RelativeDateUnit, Result, ResultTemplate, ResultTemplateCondition, SearchEngine, SearchStatus } from "@coveo/headless";
 export { AtomicInterface } from "./utils/initialization-utils";
 export { AnyBindings } from "./components/common/interface/bindings";
@@ -48,7 +48,7 @@ export { RedirectionPayload } from "./components/common/search-box/redirection-p
 export { AriaLabelGenerator } from "./components/search/search-box-suggestions/atomic-search-box-instant-results/atomic-search-box-instant-results";
 export { InitializationOptions } from "./components/search/atomic-search-interface/atomic-search-interface";
 export { StandaloneSearchBoxData } from "./utils/local-storage-utils";
-export { SearchBoxSuggestionElement } from "./components/common/suggestions/suggestions-types";
+export { SearchBoxSuggestionElement } from "./components/common/suggestions/suggestions-common";
 export namespace Components {
     /**
      * An automatic facet is a special type of facet generated by the automatic facets feature.
@@ -2415,6 +2415,23 @@ export namespace Components {
          */
         "setRenderFunction": (resultRenderingFunction: ItemRenderingFunction) => Promise<void>;
     }
+    /**
+     * The `atomic-search-box-query-suggestions` component can be added as a child of an `atomic-search-box` component, allowing for the configuration of query suggestion behavior.
+     */
+    interface AtomicSearchBoxQuerySuggestions {
+        /**
+          * The SVG icon to display.  - Use a value that starts with `http://`, `https://`, `./`, or `../`, to fetch and display an icon from a given location. - Use a value that starts with `assets://`, to display an icon from the Atomic package. - Use a stringified SVG to display it directly.
+         */
+        "icon"?: string;
+        /**
+          * The maximum number of suggestions that will be displayed if the user has typed something into the input field.
+         */
+        "maxWithQuery"?: number;
+        /**
+          * The maximum number of suggestions that will be displayed initially when the input field is empty.
+         */
+        "maxWithoutQuery"?: number;
+    }
     /**
      * The `atomic-search-box-recent-queries` component can be added as a child of an `atomic-search-box` component, allowing for the configuration of recent query suggestions.
      */
@@ -4177,6 +4194,15 @@ declare global {
         prototype: HTMLAtomicSearchBoxInstantResultsElement;
         new (): HTMLAtomicSearchBoxInstantResultsElement;
     };
+    /**
+     * The `atomic-search-box-query-suggestions` component can be added as a child of an `atomic-search-box` component, allowing for the configuration of query suggestion behavior.
+     */
+    interface HTMLAtomicSearchBoxQuerySuggestionsElement extends Components.AtomicSearchBoxQuerySuggestions, HTMLStencilElement {
+    }
+    var HTMLAtomicSearchBoxQuerySuggestionsElement: {
+        prototype: HTMLAtomicSearchBoxQuerySuggestionsElement;
+        new (): HTMLAtomicSearchBoxQuerySuggestionsElement;
+    };
     /**
      * The `atomic-search-box-recent-queries` component can be added as a child of an `atomic-search-box` component, allowing for the configuration of recent query suggestions.
      */
@@ -4589,6 +4615,7 @@ declare global {
         "atomic-result-timespan": HTMLAtomicResultTimespanElement;
         "atomic-search-box": HTMLAtomicSearchBoxElement;
         "atomic-search-box-instant-results": HTMLAtomicSearchBoxInstantResultsElement;
+        "atomic-search-box-query-suggestions": HTMLAtomicSearchBoxQuerySuggestionsElement;
         "atomic-search-box-recent-queries": HTMLAtomicSearchBoxRecentQueriesElement;
         "atomic-search-interface": HTMLAtomicSearchInterfaceElement;
         "atomic-segmented-facet": HTMLAtomicSegmentedFacetElement;
@@ -6855,6 +6882,23 @@ declare namespace LocalJSX {
          */
         "maxResultsPerQuery"?: number;
     }
+    /**
+     * The `atomic-search-box-query-suggestions` component can be added as a child of an `atomic-search-box` component, allowing for the configuration of query suggestion behavior.
+     */
+    interface AtomicSearchBoxQuerySuggestions {
+        /**
+          * The SVG icon to display.  - Use a value that starts with `http://`, `https://`, `./`, or `../`, to fetch and display an icon from a given location. - Use a value that starts with `assets://`, to display an icon from the Atomic package. - Use a stringified SVG to display it directly.
+         */
+        "icon"?: string;
+        /**
+          * The maximum number of suggestions that will be displayed if the user has typed something into the input field.
+         */
+        "maxWithQuery"?: number;
+        /**
+          * The maximum number of suggestions that will be displayed initially when the input field is empty.
+         */
+        "maxWithoutQuery"?: number;
+    }
     /**
      * The `atomic-search-box-recent-queries` component can be added as a child of an `atomic-search-box` component, allowing for the configuration of recent query suggestions.
      */
@@ -7443,6 +7487,7 @@ declare namespace LocalJSX {
         "atomic-result-timespan": AtomicResultTimespan;
         "atomic-search-box": AtomicSearchBox;
         "atomic-search-box-instant-results": AtomicSearchBoxInstantResults;
+        "atomic-search-box-query-suggestions": AtomicSearchBoxQuerySuggestions;
         "atomic-search-box-recent-queries": AtomicSearchBoxRecentQueries;
         "atomic-search-interface": AtomicSearchInterface;
         "atomic-segmented-facet": AtomicSegmentedFacet;
@@ -7956,6 +8001,10 @@ declare module "@stencil/core" {
              * This component is not supported on mobile.
              */
             "atomic-search-box-instant-results": LocalJSX.AtomicSearchBoxInstantResults & JSXBase.HTMLAttributes<HTMLAtomicSearchBoxInstantResultsElement>;
+            /**
+             * The `atomic-search-box-query-suggestions` component can be added as a child of an `atomic-search-box` component, allowing for the configuration of query suggestion behavior.
+             */
+            "atomic-search-box-query-suggestions": LocalJSX.AtomicSearchBoxQuerySuggestions & JSXBase.HTMLAttributes<HTMLAtomicSearchBoxQuerySuggestionsElement>;
             /**
              * The `atomic-search-box-recent-queries` component can be added as a child of an `atomic-search-box` component, allowing for the configuration of recent query suggestions.
              */

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-types';
+import type { SearchBoxSuggestions } from '../components/common/suggestions/suggestions-common';
 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,9 +5,7 @@ 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 } 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 { dispatchSearchBoxSuggestionsEvent, SearchBoxSuggestionElement, SearchBoxSuggestions, SearchBoxSuggestionsBindings, SearchBoxSuggestionsEvent, } from './components/common/suggestions/suggestions-common';
 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-26T20:36:58",
+  "timestamp": "2025-09-24T16:10:51",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.20.0",
@@ -12480,12 +12480,14 @@
       "dependents": [],
       "dependencies": [
         "atomic-suggestion-renderer",
-        "atomic-search-box-recent-queries"
+        "atomic-search-box-recent-queries",
+        "atomic-search-box-query-suggestions"
       ],
       "dependencyGraph": {
         "atomic-search-box": [
           "atomic-suggestion-renderer",
-          "atomic-search-box-recent-queries"
+          "atomic-search-box-recent-queries",
+          "atomic-search-box-query-suggestions"
         ]
       }
     },
@@ -12706,6 +12708,103 @@
         ]
       }
     },
+    {
+      "filePath": "src/components/search/search-box-suggestions/atomic-search-box-query-suggestions/atomic-search-box-query-suggestions.tsx",
+      "encapsulation": "shadow",
+      "tag": "atomic-search-box-query-suggestions",
+      "docs": "The `atomic-search-box-query-suggestions` component can be added as a child of an `atomic-search-box` component, allowing for the configuration of query suggestion behavior.",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "icon",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "icon",
+          "reflectToAttr": false,
+          "docs": "The SVG icon to display.\n\n- Use a value that starts with `http://`, `https://`, `./`, or `../`, to fetch and display an icon from a given location.\n- Use a value that starts with `assets://`, to display an icon from the Atomic package.\n- Use a stringified SVG to display it directly.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "maxWithQuery",
+          "type": "number | undefined",
+          "complexType": {
+            "original": "number",
+            "resolved": "number | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "max-with-query",
+          "reflectToAttr": true,
+          "docs": "The maximum number of suggestions that will be displayed if the user has typed something into the input field.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "maxWithoutQuery",
+          "type": "number | undefined",
+          "complexType": {
+            "original": "number",
+            "resolved": "number | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "max-without-query",
+          "reflectToAttr": true,
+          "docs": "The maximum number of suggestions that will be displayed initially when the input field is empty.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [
+        "atomic-search-box"
+      ],
+      "dependencies": [],
+      "dependencyGraph": {
+        "atomic-search-box": [
+          "atomic-search-box-query-suggestions"
+        ]
+      }
+    },
     {
       "filePath": "src/components/search/search-box-suggestions/atomic-search-box-recent-queries/atomic-search-box-recent-queries.tsx",
       "encapsulation": "shadow",
@@ -15990,10 +16089,10 @@
       "docstring": "",
       "path": "src/components/common/layout/display-options.ts"
     },
-    "src/components/common/suggestions/suggestions-types.ts::SearchBoxSuggestionElement": {
+    "src/components/common/suggestions/suggestions-common.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-types.ts"
+      "path": "src/components/common/suggestions/suggestions-common.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.c54adf6755",
+  "version": "3.33.8-pre.d75d8e5578",
   "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.1-pre.c54adf6755",
+    "@coveo/headless": "3.31.0",
     "@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.1-pre.c54adf6755",
+    "@coveo/headless": "3.31.0",
     "typescript": ">=5.0.0"
   },
   "peerDependenciesMeta": {

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

@@ -1 +0,0 @@
-export {};