@coveo/atomic 3.34.0-pre.8b1d289c8b → 3.34.0-pre.933691a916

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

@@ -0,0 +1,47 @@
+import type { LitElement, ReactiveController, ReactiveControllerHost } from 'lit';
+import type { ItemRenderingFunction } from "../item-list/item-list-common";
+import type { AnyItem } from "../item-list/unfolded-item";
+import { type ItemDisplayDensity, type ItemDisplayImageSize, type ItemDisplayLayout, ItemLayout } from './display-options';
+export interface ItemLayoutHost extends ReactiveControllerHost {
+    shadowRoot?: ShadowRoot | null;
+}
+export interface LayoutDisplayConfig {
+    display: ItemDisplayLayout;
+    density: ItemDisplayDensity;
+    imageSize: ItemDisplayImageSize;
+}
+export interface ItemLayoutOptions {
+    elementPrefix: string;
+    renderingFunction: () => ItemRenderingFunction<AnyItem> | undefined;
+    content: () => ParentNode | undefined;
+    layoutConfig: () => LayoutDisplayConfig;
+    itemClasses: () => string;
+}
+/**
+ * A reactive controller that manages layout creation and class application for item components.
+ */
+export declare class ItemLayoutController implements ReactiveController {
+    private host;
+    private options;
+    private layoutInstance;
+    constructor(host: ItemLayoutHost & LitElement, options: ItemLayoutOptions);
+    hostConnected(): void;
+    hostUpdated(): void;
+    /**
+     * Gets the current layout instance
+     */
+    getLayout(): ItemLayout | null;
+    /**
+     * Gets combined layout and extra classes
+     */
+    getCombinedClasses(additionalContent?: string): string[];
+    /**
+     * Applies layout classes to a specific element (useful for custom rendering)
+     */
+    applyLayoutClassesToElement(element: HTMLElement, additionalContent?: string): void;
+    private applyLayoutClasses;
+    private createLayout;
+    private hasCustomRenderFunction;
+    private addClassesToElements;
+    private observeAndApplyClasses;
+}

package/dist/types/components/common/no-items/guard.d.ts

@@ -6,7 +6,7 @@ interface NoItemsGuardProps {
     hasResults: boolean;
 }
 declare class NoItemsGuardDirective extends Directive {
-    render({ firstSearchExecuted, isLoading, hasResults }: NoItemsGuardProps, content: () => unknown): typeof nothing | import("lit-html").TemplateResult<1>;
+    render({ firstSearchExecuted, isLoading, hasResults }: NoItemsGuardProps, content: () => unknown): import("lit-html").TemplateResult<1> | typeof nothing;
 }
 export declare const noItemsGuard: (values_0: NoItemsGuardProps, content: () => unknown) => import("lit-html/directive.js").DirectiveResult<typeof NoItemsGuardDirective>;
 export {};

package/dist/types/components/common/refine-modal/guard.d.ts

@@ -6,7 +6,7 @@ export interface RefineToggleGuardProps {
     hasItems: boolean;
 }
 declare class RefineToggleGuardDirective extends Directive {
-    render({ hasError, firstRequestExecuted, hasItems }: RefineToggleGuardProps, content: () => unknown): typeof nothing | import("lit-html").TemplateResult<1>;
+    render({ hasError, firstRequestExecuted, hasItems }: RefineToggleGuardProps, content: () => unknown): import("lit-html").TemplateResult<1> | typeof nothing;
 }
 export declare const refineToggleGuard: (values_0: RefineToggleGuardProps, content: () => unknown) => import("lit-html/directive.js").DirectiveResult<typeof RefineToggleGuardDirective>;
 export {};

package/dist/types/components/common/sort/sort-guard.d.ts

@@ -5,5 +5,5 @@ interface SortGuardProps {
     hasError: boolean;
     isLoading: boolean;
 }
-export declare const sortGuard: ({ firstSearchExecuted, hasError, hasResults, isLoading }: SortGuardProps, sortTemplate: () => TemplateResult) => typeof nothing | TemplateResult | typeof noChange;
+export declare const sortGuard: ({ firstSearchExecuted, hasError, hasResults, isLoading }: SortGuardProps, sortTemplate: () => TemplateResult) => TemplateResult | typeof nothing | typeof noChange;
 export {};

package/dist/types/components/common/validate-props-controller/validate-props-controller.d.ts

@@ -0,0 +1,32 @@
+import type { Schema } from '@coveo/bueno';
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+/**
+ * A reactive controller that validates the props of a Lit component against a
+ * provided Bueno schema.
+ *
+ * It validates the props when the host is connected to the DOM and whenever
+ * the host updates, revalidating only if the props have changed since the last
+ * validation.
+ *
+ * If validation fails, the controller sets the `error` property on the host.
+ */
+export declare class ValidatePropsController<TProps extends Record<string, unknown>> implements ReactiveController {
+    private host;
+    private getProps;
+    private schema;
+    private currentProps?;
+    private previousProps?;
+    /**
+     * Creates a `ValidatePropsController`.
+     *
+     * @param host The host element.
+     * @param getProps A function that returns the current props to validate.
+     * @param schema The Bueno schema to validate the props against.
+     */
+    constructor(host: ReactiveControllerHost & HTMLElement & {
+        error: Error;
+    }, getProps: () => TProps, schema: Schema<TProps>);
+    hostConnected(): void;
+    hostUpdate(): void;
+    private _validateProps;
+}

package/dist/types/components/search/atomic-relevance-inspector/atomic-relevance-inspector.d.ts

@@ -1,15 +1,25 @@
-import { EventEmitter } from '../../../stencil-public-runtime';
-import { Bindings } from '../atomic-search-interface/atomic-search-interface';
+import { LitElement } from 'lit';
+import "../../common/atomic-modal/atomic-modal";
+import type { Bindings } from "../atomic-search-interface/interfaces";
+import type { InitializableComponent } from "../../../decorators/types.js";
 /**
  * The `atomic-relevance-inspector` component is used internally to offer insight on search page relevance, as well as information to help troubleshoot issues during development.
+ *
+ * @internal
  */
-export declare class AtomicRelevanceInspector {
-    /**
-     * The Atomic interface bindings, namely the headless search engine and i18n instances.
-     */
+export declare class AtomicRelevanceInspector extends LitElement implements InitializableComponent<Bindings> {
     bindings: Bindings;
+    error: Error;
     open: boolean;
-    closeRelevanceInspector: EventEmitter<null> | undefined;
-    render(): any;
+    initialize: () => void;
+    disconnectedCallback(): void;
+    render(): import("lit-html").TemplateResult<1>;
+    private handleRelevanceInspectorDoubleClick;
+    private handleCloseRelevanceInspector;
     private get adminHref();
 }
+declare global {
+    interface HTMLElementTagNameMap {
+        'atomic-relevance-inspector': AtomicRelevanceInspector;
+    }
+}

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

@@ -1,13 +1,15 @@
 import { type SearchBox } from '@coveo/headless';
 import { LitElement } from 'lit';
-import type { SearchBoxSuggestions, SearchBoxSuggestionsBindings } from "../../common/suggestions/suggestions-types";
-import type { Bindings } from "../atomic-search-interface/interfaces";
 import type { SearchBoxSuggestionsComponent } from "../../../decorators/types";
+import type { SearchBoxSuggestions, SearchBoxSuggestionsBindings } from '../../common/suggestions/suggestions-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.
+ * 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.
  */
-export declare class AtomicSearchBoxQuerySuggestions extends LitElement implements SearchBoxSuggestionsComponent<Bindings> {
+export declare class AtomicSearchBoxRecentQueries extends LitElement implements SearchBoxSuggestionsComponent<Bindings> {
     bindings: SearchBoxSuggestionsBindings<SearchBox, Bindings>;
+    private recentQueriesList;
+    private storage;
     error: Error;
     /**
      * The SVG icon to display.
@@ -18,21 +20,26 @@ export declare class AtomicSearchBoxQuerySuggestions extends LitElement implemen
      */
     icon?: string;
     /**
-     * The maximum number of suggestions that will be displayed if the user has typed something into the input field.
+     * The maximum number of suggestions to display when the user types in the input field.
      */
     maxWithQuery: number;
     /**
-     * The maximum number of suggestions that will be displayed initially when the input field is empty.
+     * The maximum number of suggestions to display initially, when the input field is empty.
      */
     maxWithoutQuery?: number;
     connectedCallback(): void;
     initialize(): SearchBoxSuggestions;
+    private retrieveLocalStorage;
+    private updateLocalStorage;
+    private warnUser;
+    private disableFeature;
     private renderItems;
+    private renderClear;
     private renderItem;
     render(): import("lit-html").TemplateResult<1>;
 }
 declare global {
     interface HTMLElementTagNameMap {
-        'atomic-search-box-query-suggestions': AtomicSearchBoxQuerySuggestions;
+        'atomic-search-box-recent-queries': AtomicSearchBoxRecentQueries;
     }
 }

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

@@ -3,6 +3,7 @@ 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 "../atomic-relevance-inspector/atomic-relevance-inspector";
 import { type SearchStore } from './store';
 import "../../common/atomic-modal/atomic-modal";
 export type InitializationOptions = SearchEngineConfiguration;
@@ -16,7 +17,6 @@ declare const AtomicSearchInterface_base: typeof LitElement;
 export declare class AtomicSearchInterface extends AtomicSearchInterface_base implements BaseAtomicInterface<SearchEngine> {
     bindings: Bindings;
     error: Error;
-    relevanceInspectorIsOpen: boolean;
     urlManager: UrlManager;
     searchStatus: SearchStatus;
     private unsubscribeUrlManager;
@@ -24,6 +24,7 @@ export declare class AtomicSearchInterface extends AtomicSearchInterface_base im
     private initialized;
     private store;
     private interfaceController;
+    private relevanceInspector?;
     static styles: CSSResultGroup;
     /**
      * A list of non-default fields to include in the query results.
@@ -120,6 +121,9 @@ export declare class AtomicSearchInterface extends AtomicSearchInterface_base im
     disconnectedCallback(): void;
     private handleInitialization;
     scrollToTop(): void;
+    /**
+     * @deprecated provided for backward compatibility. set the 'open' property directly on the relevance inspector instead.
+     */
     closeRelevanceInspector(): void;
     /**
      * Initializes the connection with the headless search engine using options for `accessToken` (required), `organizationId` (required), `environment` (defaults to `prod`), and `renewAccessToken`.
@@ -143,13 +147,12 @@ export declare class AtomicSearchInterface extends AtomicSearchInterface_base im
     updateIconAssetsPath(): void;
     private getBindings;
     private initFieldsToInclude;
+    private updateFieldsToInclude;
     registerFieldsToInclude(): void;
     private initEngine;
     private getSearchConfiguration;
     private get fragment();
     private initUrlManager;
-    private handleRelevanceInspectorDoubleClick;
-    private initRelevanceInspector;
     private initSearchStatus;
     private updateHash;
     private onHashChange;

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

@@ -1,6 +1,7 @@
 export { AtomicPager } from './atomic-pager/atomic-pager.js';
 export { AtomicQuerySummary } from './atomic-query-summary/atomic-query-summary.js';
+export { AtomicRelevanceInspector } from './atomic-relevance-inspector/atomic-relevance-inspector.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 { AtomicSearchBoxRecentQueries } from './atomic-search-box-recent-queries/atomic-search-box-recent-queries.js';
 export { AtomicSearchInterface } from './atomic-search-interface/atomic-search-interface.js';
 export { AtomicSearchLayout } from './atomic-search-layout/atomic-search-layout.js';

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

@@ -1,10 +1,8 @@
 /**
- * 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.
+ * 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 AtomicSearchBoxRecentQueries {
+export declare class AtomicSearchBoxQuerySuggestions {
     private bindings;
-    private recentQueriesList;
-    private storage;
     private host;
     error: Error;
     /**
@@ -18,20 +16,14 @@ export declare class AtomicSearchBoxRecentQueries {
     /**
      * 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;
     componentWillLoad(): void;
-    private renderIcon;
     private initialize;
-    private retrieveLocalStorage;
-    private updateLocalStorage;
-    private warnUser;
-    private disableFeature;
     private renderItems;
-    private renderClear;
     private renderItem;
     render(): any;
 }

package/dist/types/components.d.ts

@@ -20,7 +20,6 @@ import { InsightResultAttachToCaseEvent } from "./components/insight/atomic-insi
 import { RecommendationEngine, InteractiveResult as RecsInteractiveResult, LogLevel as RecsLogLevel, Result as RecsResult, ResultTemplate as RecsResultTemplate, ResultTemplateCondition as RecsResultTemplateCondition } from "@coveo/headless/recommendation";
 import { RecsInitializationOptions } from "./components/recommendations/atomic-recs-interface/atomic-recs-interface";
 import { RecsStore } from "./components/recommendations/atomic-recs-interface/store";
-import { Bindings } from "./components/search/atomic-search-interface/atomic-search-interface";
 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";
@@ -40,7 +39,6 @@ export { InsightResultAttachToCaseEvent } from "./components/insight/atomic-insi
 export { RecommendationEngine, InteractiveResult as RecsInteractiveResult, LogLevel as RecsLogLevel, Result as RecsResult, ResultTemplate as RecsResultTemplate, ResultTemplateCondition as RecsResultTemplateCondition } from "@coveo/headless/recommendation";
 export { RecsInitializationOptions } from "./components/recommendations/atomic-recs-interface/atomic-recs-interface";
 export { RecsStore } from "./components/recommendations/atomic-recs-interface/store";
-export { Bindings } from "./components/search/atomic-search-interface/atomic-search-interface";
 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";
@@ -1821,16 +1819,6 @@ export namespace Components {
          */
         "collapseFacetsAfter": number;
     }
-    /**
-     * The `atomic-relevance-inspector` component is used internally to offer insight on search page relevance, as well as information to help troubleshoot issues during development.
-     */
-    interface AtomicRelevanceInspector {
-        /**
-          * The Atomic interface bindings, namely the headless search engine and i18n instances.
-         */
-        "bindings": Bindings;
-        "open": boolean;
-    }
     /**
      * The `atomic-result` component is used internally by the `atomic-result-list` component.
      */
@@ -2395,9 +2383,9 @@ export namespace Components {
         "setRenderFunction": (resultRenderingFunction: ItemRenderingFunction) => Promise<void>;
     }
     /**
-     * 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.
+     * 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 AtomicSearchBoxRecentQueries {
+    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.
          */
@@ -2405,7 +2393,7 @@ export namespace Components {
         /**
           * 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.
          */
@@ -2827,10 +2815,6 @@ export interface AtomicQuickviewModalCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLAtomicQuickviewModalElement;
 }
-export interface AtomicRelevanceInspectorCustomEvent<T> extends CustomEvent<T> {
-    detail: T;
-    target: HTMLAtomicRelevanceInspectorElement;
-}
 export interface AtomicSearchBoxCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLAtomicSearchBoxElement;
@@ -3642,26 +3626,6 @@ declare global {
         prototype: HTMLAtomicRefineToggleElement;
         new (): HTMLAtomicRefineToggleElement;
     };
-    interface HTMLAtomicRelevanceInspectorElementEventMap {
-        "atomic/relevanceInspector/close": any;
-    }
-    /**
-     * The `atomic-relevance-inspector` component is used internally to offer insight on search page relevance, as well as information to help troubleshoot issues during development.
-     */
-    interface HTMLAtomicRelevanceInspectorElement extends Components.AtomicRelevanceInspector, HTMLStencilElement {
-        addEventListener<K extends keyof HTMLAtomicRelevanceInspectorElementEventMap>(type: K, listener: (this: HTMLAtomicRelevanceInspectorElement, ev: AtomicRelevanceInspectorCustomEvent<HTMLAtomicRelevanceInspectorElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
-        removeEventListener<K extends keyof HTMLAtomicRelevanceInspectorElementEventMap>(type: K, listener: (this: HTMLAtomicRelevanceInspectorElement, ev: AtomicRelevanceInspectorCustomEvent<HTMLAtomicRelevanceInspectorElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
-    }
-    var HTMLAtomicRelevanceInspectorElement: {
-        prototype: HTMLAtomicRelevanceInspectorElement;
-        new (): HTMLAtomicRelevanceInspectorElement;
-    };
     /**
      * The `atomic-result` component is used internally by the `atomic-result-list` component.
      */
@@ -4055,13 +4019,13 @@ declare global {
         new (): HTMLAtomicSearchBoxInstantResultsElement;
     };
     /**
-     * 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.
+     * 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 HTMLAtomicSearchBoxRecentQueriesElement extends Components.AtomicSearchBoxRecentQueries, HTMLStencilElement {
+    interface HTMLAtomicSearchBoxQuerySuggestionsElement extends Components.AtomicSearchBoxQuerySuggestions, HTMLStencilElement {
     }
-    var HTMLAtomicSearchBoxRecentQueriesElement: {
-        prototype: HTMLAtomicSearchBoxRecentQueriesElement;
-        new (): HTMLAtomicSearchBoxRecentQueriesElement;
+    var HTMLAtomicSearchBoxQuerySuggestionsElement: {
+        prototype: HTMLAtomicSearchBoxQuerySuggestionsElement;
+        new (): HTMLAtomicSearchBoxQuerySuggestionsElement;
     };
     /**
      * The `atomic-segmented-facet` displays a horizontal facet of the results for the current query.
@@ -4423,7 +4387,6 @@ declare global {
         "atomic-recs-result-template": HTMLAtomicRecsResultTemplateElement;
         "atomic-refine-modal": HTMLAtomicRefineModalElement;
         "atomic-refine-toggle": HTMLAtomicRefineToggleElement;
-        "atomic-relevance-inspector": HTMLAtomicRelevanceInspectorElement;
         "atomic-result": HTMLAtomicResultElement;
         "atomic-result-badge": HTMLAtomicResultBadgeElement;
         "atomic-result-children": HTMLAtomicResultChildrenElement;
@@ -4456,7 +4419,7 @@ declare global {
         "atomic-result-timespan": HTMLAtomicResultTimespanElement;
         "atomic-search-box": HTMLAtomicSearchBoxElement;
         "atomic-search-box-instant-results": HTMLAtomicSearchBoxInstantResultsElement;
-        "atomic-search-box-recent-queries": HTMLAtomicSearchBoxRecentQueriesElement;
+        "atomic-search-box-query-suggestions": HTMLAtomicSearchBoxQuerySuggestionsElement;
         "atomic-segmented-facet": HTMLAtomicSegmentedFacetElement;
         "atomic-segmented-facet-scrollable": HTMLAtomicSegmentedFacetScrollableElement;
         "atomic-smart-snippet": HTMLAtomicSmartSnippetElement;
@@ -6156,17 +6119,6 @@ declare namespace LocalJSX {
          */
         "collapseFacetsAfter"?: number;
     }
-    /**
-     * The `atomic-relevance-inspector` component is used internally to offer insight on search page relevance, as well as information to help troubleshoot issues during development.
-     */
-    interface AtomicRelevanceInspector {
-        /**
-          * The Atomic interface bindings, namely the headless search engine and i18n instances.
-         */
-        "bindings": Bindings;
-        "onAtomic/relevanceInspector/close"?: (event: AtomicRelevanceInspectorCustomEvent<any>) => void;
-        "open"?: boolean;
-    }
     /**
      * The `atomic-result` component is used internally by the `atomic-result-list` component.
      */
@@ -6704,9 +6656,9 @@ declare namespace LocalJSX {
         "maxResultsPerQuery"?: 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.
+     * 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 AtomicSearchBoxRecentQueries {
+    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.
          */
@@ -7191,7 +7143,6 @@ declare namespace LocalJSX {
         "atomic-recs-result-template": AtomicRecsResultTemplate;
         "atomic-refine-modal": AtomicRefineModal;
         "atomic-refine-toggle": AtomicRefineToggle;
-        "atomic-relevance-inspector": AtomicRelevanceInspector;
         "atomic-result": AtomicResult;
         "atomic-result-badge": AtomicResultBadge;
         "atomic-result-children": AtomicResultChildren;
@@ -7224,7 +7175,7 @@ declare namespace LocalJSX {
         "atomic-result-timespan": AtomicResultTimespan;
         "atomic-search-box": AtomicSearchBox;
         "atomic-search-box-instant-results": AtomicSearchBoxInstantResults;
-        "atomic-search-box-recent-queries": AtomicSearchBoxRecentQueries;
+        "atomic-search-box-query-suggestions": AtomicSearchBoxQuerySuggestions;
         "atomic-segmented-facet": AtomicSegmentedFacet;
         "atomic-segmented-facet-scrollable": AtomicSegmentedFacetScrollable;
         "atomic-smart-snippet": AtomicSmartSnippet;
@@ -7507,10 +7458,6 @@ declare module "@stencil/core" {
              * When this component is added to the `atomic-search-interface`, an `atomic-refine-modal` component is automatically created.
              */
             "atomic-refine-toggle": LocalJSX.AtomicRefineToggle & JSXBase.HTMLAttributes<HTMLAtomicRefineToggleElement>;
-            /**
-             * The `atomic-relevance-inspector` component is used internally to offer insight on search page relevance, as well as information to help troubleshoot issues during development.
-             */
-            "atomic-relevance-inspector": LocalJSX.AtomicRelevanceInspector & JSXBase.HTMLAttributes<HTMLAtomicRelevanceInspectorElement>;
             /**
              * The `atomic-result` component is used internally by the `atomic-result-list` component.
              */
@@ -7733,9 +7680,9 @@ declare module "@stencil/core" {
              */
             "atomic-search-box-instant-results": LocalJSX.AtomicSearchBoxInstantResults & JSXBase.HTMLAttributes<HTMLAtomicSearchBoxInstantResultsElement>;
             /**
-             * 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.
+             * 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-recent-queries": LocalJSX.AtomicSearchBoxRecentQueries & JSXBase.HTMLAttributes<HTMLAtomicSearchBoxRecentQueriesElement>;
+            "atomic-search-box-query-suggestions": LocalJSX.AtomicSearchBoxQuerySuggestions & JSXBase.HTMLAttributes<HTMLAtomicSearchBoxQuerySuggestionsElement>;
             /**
              * The `atomic-segmented-facet` displays a horizontal facet of the results for the current query.
              */

package/dist/types/directives/hierarchical-path.d.ts

@@ -12,7 +12,7 @@ export interface HierarchicalPathProps {
 }
 declare class HierarchicalPathDirective extends Directive {
     constructor(partInfo: PartInfo);
-    render(props: HierarchicalPathProps): string | TemplateResult<1>[] | TemplateResult;
+    render(props: HierarchicalPathProps): string | TemplateResult | TemplateResult<1>[];
     private getEllipsedPath;
 }
 export declare const hierarchicalPath: (props: HierarchicalPathProps) => import("lit-html/directive.js").DirectiveResult<typeof HierarchicalPathDirective>;

package/dist/types/utils/compare-utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Performs a deep equality comparison between two values.
+ * Handles primitives, null/undefined, arrays, and objects.
+ *
+ * @param a - First value to compare
+ * @param b - Second value to compare
+ * @returns true if values are deeply equal, false otherwise
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;