@coveo/atomic 3.33.8-pre.52109a8c79 → 3.33.8-pre.59b23d72e0

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.52109a8c79';
+export const headlessVersion = '3.31.1-pre.59b23d72e0';
+export const atomicVersion = '3.33.8-pre.59b23d72e0';

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

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

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

@@ -118,7 +118,6 @@ export declare class AtomicCommerceInterface extends AtomicCommerceInterface_bas
     private onHashChange;
     scrollToTop(): void;
     private updateHash;
-    private updateMobileBreakpoint;
 }
 declare global {
     interface HTMLElementTagNameMap {

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

@@ -8,19 +8,19 @@ declare const AtomicCommerceLayout_base: import("../../../mixins/mixin-common").
  * @cssprop --atomic-layout-max-search-box-input-width: The maximum width that the search box input will take.
  * @cssprop --atomic-layout-max-search-box-double-suggestions-width: The maximum width that the search box suggestions will take when displaying a double list.
  * @cssprop --atomic-layout-search-box-left-suggestions-width: The width of the left list when displaying a double list.
- *
- * @slot default - The default slot for the layout content.
  */
 export declare class AtomicCommerceLayout extends AtomicCommerceLayout_base {
     static styles: import("lit").CSSResult[];
-    private addStyles;
     error: Error;
     /**
      * The viewport width at which the layout goes from desktop to mobile.
      * E.g., 800px, 65rem.
      */
     mobileBreakpoint: string;
+    private layoutStylesController;
     connectedCallback(): void;
+    private emitBreakpointChangeEvent;
+    onMobileBreakpointChange(): void;
 }
 declare global {
     interface HTMLElementTagNameMap {

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/layout/layout-styles-controller.d.ts

@@ -0,0 +1,22 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+export interface LayoutStylesHost extends ReactiveControllerHost {
+    mobileBreakpoint: string;
+    getRootNode(): Node;
+    id?: string;
+}
+export type StylesBuilderFunction = (host: HTMLElement, mobileBreakpoint: string) => string;
+/**
+ * A reactive controller that manages dynamic layout styles.
+ */
+export declare class LayoutStylesController implements ReactiveController {
+    private host;
+    private dynamicStyleSheet;
+    private stylesBuilder;
+    private componentPrefix;
+    constructor(host: LayoutStylesHost, stylesBuilder: StylesBuilderFunction, componentPrefix: string);
+    hostConnected(): void;
+    /**
+     * Updates the dynamic styles based on the current mobile breakpoint
+     */
+    updateStyles(): void;
+}

package/dist/types/components/common/layout/mobile-breakpoint-controller.d.ts

@@ -0,0 +1,18 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { BaseStore } from "../interface/store";
+/**
+ * A reactive controller that manages mobile breakpoint changes through event communication.
+ * This controller listens for 'atomic-layout-breakpoint-change' events and updates a store
+ * with the new breakpoint value.
+ */
+export declare class MobileBreakpointController implements ReactiveController {
+    private host;
+    private store;
+    private eventListener;
+    constructor(host: ReactiveControllerHost, store: BaseStore<{
+        mobileBreakpoint: string;
+    }>);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private handleBreakpointChange;
+}

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.

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 { 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/search/search-box-suggestions/atomic-search-box-query-suggestions/atomic-search-box-query-suggestions.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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 {
+    private bindings;
+    private host;
+    error: Error;
+    /**
+     * 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;
+    componentWillLoad(): void;
+    private initialize;
+    private renderItems;
+    private renderItem;
+    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-common";
+import { SearchBoxSuggestionElement } from "./components/common/suggestions/suggestions-types";
 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-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.
@@ -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-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';