@coveo/atomic 3.35.0-pre.b3e173655a → 3.35.0-pre.d735e0b324

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

@@ -1,6 +1,7 @@
 import { type SearchBox } from '@coveo/headless/commerce';
 import { LitElement } from 'lit';
 import type { SearchBoxSuggestionsComponent } from "../../../decorators/types";
+import { AriaLiveRegionController } from "../../../utils/accessibility-utils";
 import type { SearchBoxSuggestions, SearchBoxSuggestionsBindings } from '../../common/suggestions/suggestions-types';
 import type { CommerceBindings } from '../atomic-commerce-interface/atomic-commerce-interface';
 /**
@@ -27,6 +28,7 @@ export declare class AtomicCommerceSearchBoxRecentQueries extends LitElement imp
      * The maximum number of suggestions to display initially, when the input field is empty.
      */
     maxWithoutQuery?: number;
+    protected searchBoxAriaMessage: AriaLiveRegionController;
     connectedCallback(): void;
     initialize(): SearchBoxSuggestions;
     private retrieveLocalStorage;

package/dist/types/components/common/breadbox/breadcrumb-button.d.ts

@@ -1,4 +1,5 @@
 import type { i18n } from 'i18next';
+import type { AriaLiveRegionController } from "../../../utils/accessibility-utils";
 import type { FunctionalComponentWithChildren } from "../../../utils/functional-component-utils";
 import type { Breadcrumb } from './breadcrumb-types';
 export interface BreadcrumbButtonProps {
@@ -7,5 +8,6 @@ export interface BreadcrumbButtonProps {
     pathLimit: number;
     breadcrumb: Breadcrumb;
     i18n: i18n;
+    ariaController: AriaLiveRegionController;
 }
 export declare const renderBreadcrumbButton: FunctionalComponentWithChildren<BreadcrumbButtonProps>;

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

@@ -1,14 +1,26 @@
-import { LogLevel as InsightLogLevel, InsightEngine, InsightEngineConfiguration } from '@coveo/headless/insight';
-import { i18n } from 'i18next';
-import { InitializeEvent } from '../../../utils/initialization-utils';
-import { CommonBindings, NonceBindings } from '../../common/interface/bindings';
-import { StencilBaseAtomicInterface } from '../../common/interface/interface-common-stencil';
-import { InsightStore } from './store';
+import { type InsightEngine, type InsightEngineConfiguration, type LogLevel as InsightLogLevel } from '@coveo/headless/insight';
+import { type i18n } from 'i18next';
+import { type CSSResultGroup, LitElement } from 'lit';
+import type { CommonBindings, NonceBindings } from "../../common/interface/bindings";
+import { type BaseAtomicInterface } from "../../common/interface/interface-controller";
+import { type InsightStore } from './store.js';
 export type InsightInitializationOptions = InsightEngineConfiguration;
-export type InsightBindings = CommonBindings<InsightEngine, InsightStore, HTMLAtomicInsightInterfaceElement> & NonceBindings;
-export declare class AtomicInsightInterface implements StencilBaseAtomicInterface<InsightEngine> {
+export type InsightBindings = CommonBindings<InsightEngine, InsightStore, AtomicInsightInterface> & NonceBindings;
+declare const AtomicInsightInterface_base: typeof LitElement;
+/**
+ * The `atomic-insight-interface` component is the parent to all other atomic insight components in an insight page.
+ * It handles the headless insight engine and localization configurations.
+ *
+ * @slot default - The default slot where you can add child components to the interface.
+ * @slot full-search - A slot for components that should be positioned absolutely in the top-right corner.
+ */
+export declare class AtomicInsightInterface extends AtomicInsightInterface_base implements BaseAtomicInterface<InsightEngine> {
+    bindings: InsightBindings;
+    error: Error;
     private initialized;
-    error?: Error;
+    private interfaceController;
+    store: InsightStore;
+    static styles: CSSResultGroup;
     /**
      * The service insight interface headless engine.
      */
@@ -56,55 +68,36 @@ export declare class AtomicInsightInterface implements StencilBaseAtomicInterfac
      * The number of results per page. By default, this is set to `5`.
      */
     resultsPerPage: number;
-    /**
-     * The value to set the [nonce](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/nonce) attribute to on inline script and style elements generated by this interface and its child components.
-     * If your application is served with a Content Security Policy (CSP) that doesn't include the `script-src: 'unsafe-inline'` or `style-src: 'unsafe-inline'` directives,
-     * you should ensure that your application server generates a new nonce on every page load and uses the generated value to set this prop and serve the corresponding CSP response headers
-     * (i.e., script-src 'nonce-<YOUR_GENERATED_NONCE>' and style-src 'nonce-<YOUR_GENERATED_NONCE>').
-     * Otherwise you may see console errors such as
-     *  - Refused to execute inline script because it violates the following Content Security Policy directive: [...]
-     *  - Refused to apply inline style because it violates the following Content Security Policy directive: [...].
-     * When using a nonce, the first import of Atomic should be to import & call the `setNonce` function with the generated nonce value.
-     * @example:
-     * ```html
-     * <script nonce="<YOUR_GENERATED_NONCE>">
-     *  import {setNonce} from '@coveo/atomic';
-     *  setNonce('<YOUR_GENERATED_NONCE>');
-     * </script>
-     * ```
-     */
-    CspNonce?: string;
-    host: HTMLAtomicInsightInterfaceElement;
-    private store;
-    private commonInterfaceHelper;
     private i18Initialized;
-    private componentWillLoadCalledPromise;
-    private componentWillLoadResolver;
     constructor();
     connectedCallback(): void;
-    componentWillLoad(): void;
-    private initResultsPerPage;
-    registerFieldsToInclude(): void;
     /**
      * Initializes the connection with the headless insight engine using options for `accessToken` (required), `organizationId` (required), `environment` (defaults to `prod`), and `renewAccessToken`.
      */
     initialize(options: InsightInitializationOptions): Promise<void>;
     /**
      * Initializes the connection with an already preconfigured headless insight engine.
-     *
      */
     initializeWithInsightEngine(engine: InsightEngine): Promise<void>;
     /**
-     *
      * Executes the first search and logs the interface load event to analytics, after initializing connection to the headless search engine.
      */
     executeFirstSearch(): Promise<void>;
-    updateIconAssetsPath(): void;
-    handleInitialization(event: InitializeEvent): void;
-    updateLanguage(): Promise<void>;
     toggleAnalytics(): void;
-    get bindings(): InsightBindings;
+    updateIconAssetsPath(): void;
+    updateLanguage(): void;
+    disconnectedCallback(): void;
+    render(): import("lit-html").TemplateResult<1>;
+    private getBindings;
+    private handleInitialization;
     private initEngine;
+    private initResultsPerPage;
     private internalInitialization;
-    render(): any;
+    registerFieldsToInclude(): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'atomic-insight-interface': AtomicInsightInterface;
+    }
 }
+export {};

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

@@ -1 +1 @@
-export {};
+export { AtomicInsightInterface } from './atomic-insight-interface/atomic-insight-interface.js';

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

@@ -160,6 +160,7 @@ export declare class AtomicSearchBox implements InitializableComponent<Bindings>
     private isSearchDisabledForEndUser;
     private getSearchInputLabel;
     private announceNewActiveSuggestionToScreenReader;
+    private announceClearSearchBoxToScreenReader;
     private announceNewSuggestionsToScreenReader;
     private renderSlotContent;
     render(): any;

package/dist/types/components.d.ts

@@ -11,13 +11,12 @@ import { AnyBindings } from "./components/common/interface/bindings";
 import { NumberInputType } from "./components/common/facets/facet-number-input/number-input-type";
 import { ItemDisplayBasicLayout, ItemDisplayDensity, ItemDisplayImageSize, ItemDisplayLayout } from "./components/common/layout/display-options";
 import { ItemRenderingFunction } from "./components/common/item-list/stencil-item-list-common";
-import { InsightEngine, FacetSortCriterion as InsightFacetSortCriterion, FoldedResult as InsightFoldedResult, InteractiveResult as InsightInteractiveResult, LogLevel as InsightLogLevel, RangeFacetRangeAlgorithm as InsightRangeFacetRangeAlgorithm, RangeFacetSortCriterion as InsightRangeFacetSortCriterion, Result as InsightResult, ResultTemplate as InsightResultTemplate, ResultTemplateCondition as InsightResultTemplateCondition, UserAction as IUserAction } from "@coveo/headless/insight";
-import { i18n } from "i18next";
-import { InsightInitializationOptions } from "./components/insight/atomic-insight-interface/atomic-insight-interface";
+import { FacetSortCriterion as InsightFacetSortCriterion, FoldedResult as InsightFoldedResult, InteractiveResult as InsightInteractiveResult, RangeFacetRangeAlgorithm as InsightRangeFacetRangeAlgorithm, RangeFacetSortCriterion as InsightRangeFacetSortCriterion, Result as InsightResult, ResultTemplate as InsightResultTemplate, ResultTemplateCondition as InsightResultTemplateCondition, UserAction as IUserAction } from "@coveo/headless/insight";
 import { InsightStore } from "./components/insight/atomic-insight-interface/store";
 import { Actions, InsightResultActionClickedEvent } from "./components/insight/atomic-insight-result-action/atomic-insight-result-action";
 import { InsightResultAttachToCaseEvent } from "./components/insight/atomic-insight-result-attach-to-case-action/atomic-insight-result-attach-to-case-action";
 import { RecommendationEngine, InteractiveResult as RecsInteractiveResult, LogLevel as RecsLogLevel, Result as RecsResult, ResultTemplate as RecsResultTemplate, ResultTemplateCondition as RecsResultTemplateCondition } from "@coveo/headless/recommendation";
+import { i18n } from "i18next";
 import { RecsInitializationOptions } from "./components/recommendations/atomic-recs-interface/atomic-recs-interface";
 import { RecsStore } from "./components/recommendations/atomic-recs-interface/store";
 import { SearchStore } from "./components/search/atomic-search-interface/store";
@@ -30,13 +29,12 @@ export { AnyBindings } from "./components/common/interface/bindings";
 export { NumberInputType } from "./components/common/facets/facet-number-input/number-input-type";
 export { ItemDisplayBasicLayout, ItemDisplayDensity, ItemDisplayImageSize, ItemDisplayLayout } from "./components/common/layout/display-options";
 export { ItemRenderingFunction } from "./components/common/item-list/stencil-item-list-common";
-export { InsightEngine, FacetSortCriterion as InsightFacetSortCriterion, FoldedResult as InsightFoldedResult, InteractiveResult as InsightInteractiveResult, LogLevel as InsightLogLevel, RangeFacetRangeAlgorithm as InsightRangeFacetRangeAlgorithm, RangeFacetSortCriterion as InsightRangeFacetSortCriterion, Result as InsightResult, ResultTemplate as InsightResultTemplate, ResultTemplateCondition as InsightResultTemplateCondition, UserAction as IUserAction } from "@coveo/headless/insight";
-export { i18n } from "i18next";
-export { InsightInitializationOptions } from "./components/insight/atomic-insight-interface/atomic-insight-interface";
+export { FacetSortCriterion as InsightFacetSortCriterion, FoldedResult as InsightFoldedResult, InteractiveResult as InsightInteractiveResult, RangeFacetRangeAlgorithm as InsightRangeFacetRangeAlgorithm, RangeFacetSortCriterion as InsightRangeFacetSortCriterion, Result as InsightResult, ResultTemplate as InsightResultTemplate, ResultTemplateCondition as InsightResultTemplateCondition, UserAction as IUserAction } from "@coveo/headless/insight";
 export { InsightStore } from "./components/insight/atomic-insight-interface/store";
 export { Actions, InsightResultActionClickedEvent } from "./components/insight/atomic-insight-result-action/atomic-insight-result-action";
 export { InsightResultAttachToCaseEvent } from "./components/insight/atomic-insight-result-attach-to-case-action/atomic-insight-result-attach-to-case-action";
 export { RecommendationEngine, InteractiveResult as RecsInteractiveResult, LogLevel as RecsLogLevel, Result as RecsResult, ResultTemplate as RecsResultTemplate, ResultTemplateCondition as RecsResultTemplateCondition } from "@coveo/headless/recommendation";
+export { i18n } from "i18next";
 export { RecsInitializationOptions } from "./components/recommendations/atomic-recs-interface/atomic-recs-interface";
 export { RecsStore } from "./components/recommendations/atomic-recs-interface/store";
 export { SearchStore } from "./components/search/atomic-search-interface/store";
@@ -713,61 +711,6 @@ export namespace Components {
         "clickCallback": () => void;
         "tooltip": string;
     }
-    interface AtomicInsightInterface {
-        /**
-          * The value to set the [nonce](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/nonce) attribute to on inline script and style elements generated by this interface and its child components. If your application is served with a Content Security Policy (CSP) that doesn't include the `script-src: 'unsafe-inline'` or `style-src: 'unsafe-inline'` directives, you should ensure that your application server generates a new nonce on every page load and uses the generated value to set this prop and serve the corresponding CSP response headers (i.e., script-src 'nonce-<YOUR_GENERATED_NONCE>' and style-src 'nonce-<YOUR_GENERATED_NONCE>'). Otherwise you may see console errors such as  - Refused to execute inline script because it violates the following Content Security Policy directive: [...]  - Refused to apply inline style because it violates the following Content Security Policy directive: [...]. When using a nonce, the first import of Atomic should be to import & call the `setNonce` function with the generated nonce value.
-          * @example : ```html <script nonce="<YOUR_GENERATED_NONCE>"> import {setNonce} from '@coveo/atomic'; setNonce('<YOUR_GENERATED_NONCE>'); </script> ```
-         */
-        "CspNonce"?: string;
-        /**
-          * Whether analytics should be enabled.
-         */
-        "analytics": boolean;
-        /**
-          * The service insight interface headless engine.
-         */
-        "engine"?: InsightEngine;
-        /**
-          * Executes the first search and logs the interface load event to analytics, after initializing connection to the headless search engine.
-         */
-        "executeFirstSearch": () => Promise<void>;
-        /**
-          * A list of non-default fields to include in the query results.  Specify the property as an array using a JSON string representation: ```html <atomic-insight-interface fields-to-include='["fieldA", "fieldB"]'></atomic-insight-interface> ```
-         */
-        "fieldsToInclude": string[] | string;
-        /**
-          * The service insight interface i18next instance.
-         */
-        "i18n": i18n;
-        /**
-          * The icon assets path. By default, this will be a relative URL pointing to `./assets`.  Example: "/mypublicpath/icons"
-         */
-        "iconAssetsPath": string;
-        /**
-          * Initializes the connection with the headless insight engine using options for `accessToken` (required), `organizationId` (required), `environment` (defaults to `prod`), and `renewAccessToken`.
-         */
-        "initialize": (options: InsightInitializationOptions) => Promise<void>;
-        /**
-          * Initializes the connection with an already preconfigured headless insight engine.
-         */
-        "initializeWithInsightEngine": (engine: InsightEngine) => Promise<void>;
-        /**
-          * The service insight interface language.
-         */
-        "language": string;
-        /**
-          * The language assets path. By default, this will be a relative URL pointing to `./lang`.  Example: "/mypublicpath/languages"
-         */
-        "languageAssetsPath": string;
-        /**
-          * The severity level of the messages to log in the console.
-         */
-        "logLevel"?: InsightLogLevel;
-        /**
-          * The number of results per page. By default, this is set to `5`.
-         */
-        "resultsPerPage": number;
-    }
     interface AtomicInsightLayout {
         /**
           * Whether the interface should be shown in widget format.
@@ -3097,12 +3040,6 @@ declare global {
         prototype: HTMLAtomicInsightHistoryToggleElement;
         new (): HTMLAtomicInsightHistoryToggleElement;
     };
-    interface HTMLAtomicInsightInterfaceElement extends Components.AtomicInsightInterface, HTMLStencilElement {
-    }
-    var HTMLAtomicInsightInterfaceElement: {
-        prototype: HTMLAtomicInsightInterfaceElement;
-        new (): HTMLAtomicInsightInterfaceElement;
-    };
     interface HTMLAtomicInsightLayoutElement extends Components.AtomicInsightLayout, HTMLStencilElement {
     }
     var HTMLAtomicInsightLayoutElement: {
@@ -4329,7 +4266,6 @@ declare global {
         "atomic-insight-full-search-button": HTMLAtomicInsightFullSearchButtonElement;
         "atomic-insight-generated-answer": HTMLAtomicInsightGeneratedAnswerElement;
         "atomic-insight-history-toggle": HTMLAtomicInsightHistoryToggleElement;
-        "atomic-insight-interface": HTMLAtomicInsightInterfaceElement;
         "atomic-insight-layout": HTMLAtomicInsightLayoutElement;
         "atomic-insight-no-results": HTMLAtomicInsightNoResultsElement;
         "atomic-insight-numeric-facet": HTMLAtomicInsightNumericFacetElement;
@@ -5101,49 +5037,6 @@ declare namespace LocalJSX {
         "clickCallback"?: () => void;
         "tooltip"?: string;
     }
-    interface AtomicInsightInterface {
-        /**
-          * The value to set the [nonce](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/nonce) attribute to on inline script and style elements generated by this interface and its child components. If your application is served with a Content Security Policy (CSP) that doesn't include the `script-src: 'unsafe-inline'` or `style-src: 'unsafe-inline'` directives, you should ensure that your application server generates a new nonce on every page load and uses the generated value to set this prop and serve the corresponding CSP response headers (i.e., script-src 'nonce-<YOUR_GENERATED_NONCE>' and style-src 'nonce-<YOUR_GENERATED_NONCE>'). Otherwise you may see console errors such as  - Refused to execute inline script because it violates the following Content Security Policy directive: [...]  - Refused to apply inline style because it violates the following Content Security Policy directive: [...]. When using a nonce, the first import of Atomic should be to import & call the `setNonce` function with the generated nonce value.
-          * @example : ```html <script nonce="<YOUR_GENERATED_NONCE>"> import {setNonce} from '@coveo/atomic'; setNonce('<YOUR_GENERATED_NONCE>'); </script> ```
-         */
-        "CspNonce"?: string;
-        /**
-          * Whether analytics should be enabled.
-         */
-        "analytics"?: boolean;
-        /**
-          * The service insight interface headless engine.
-         */
-        "engine"?: InsightEngine;
-        /**
-          * A list of non-default fields to include in the query results.  Specify the property as an array using a JSON string representation: ```html <atomic-insight-interface fields-to-include='["fieldA", "fieldB"]'></atomic-insight-interface> ```
-         */
-        "fieldsToInclude"?: string[] | string;
-        /**
-          * The service insight interface i18next instance.
-         */
-        "i18n"?: i18n;
-        /**
-          * The icon assets path. By default, this will be a relative URL pointing to `./assets`.  Example: "/mypublicpath/icons"
-         */
-        "iconAssetsPath"?: string;
-        /**
-          * The service insight interface language.
-         */
-        "language"?: string;
-        /**
-          * The language assets path. By default, this will be a relative URL pointing to `./lang`.  Example: "/mypublicpath/languages"
-         */
-        "languageAssetsPath"?: string;
-        /**
-          * The severity level of the messages to log in the console.
-         */
-        "logLevel"?: InsightLogLevel;
-        /**
-          * The number of results per page. By default, this is set to `5`.
-         */
-        "resultsPerPage"?: number;
-    }
     interface AtomicInsightLayout {
         /**
           * Whether the interface should be shown in widget format.
@@ -7085,7 +6978,6 @@ declare namespace LocalJSX {
         "atomic-insight-full-search-button": AtomicInsightFullSearchButton;
         "atomic-insight-generated-answer": AtomicInsightGeneratedAnswer;
         "atomic-insight-history-toggle": AtomicInsightHistoryToggle;
-        "atomic-insight-interface": AtomicInsightInterface;
         "atomic-insight-layout": AtomicInsightLayout;
         "atomic-insight-no-results": AtomicInsightNoResults;
         "atomic-insight-numeric-facet": AtomicInsightNumericFacet;
@@ -7309,7 +7201,6 @@ declare module "@stencil/core" {
             "atomic-insight-full-search-button": LocalJSX.AtomicInsightFullSearchButton & JSXBase.HTMLAttributes<HTMLAtomicInsightFullSearchButtonElement>;
             "atomic-insight-generated-answer": LocalJSX.AtomicInsightGeneratedAnswer & JSXBase.HTMLAttributes<HTMLAtomicInsightGeneratedAnswerElement>;
             "atomic-insight-history-toggle": LocalJSX.AtomicInsightHistoryToggle & JSXBase.HTMLAttributes<HTMLAtomicInsightHistoryToggleElement>;
-            "atomic-insight-interface": LocalJSX.AtomicInsightInterface & JSXBase.HTMLAttributes<HTMLAtomicInsightInterfaceElement>;
             "atomic-insight-layout": LocalJSX.AtomicInsightLayout & JSXBase.HTMLAttributes<HTMLAtomicInsightLayoutElement>;
             "atomic-insight-no-results": LocalJSX.AtomicInsightNoResults & JSXBase.HTMLAttributes<HTMLAtomicInsightNoResultsElement>;
             "atomic-insight-numeric-facet": LocalJSX.AtomicInsightNumericFacet & JSXBase.HTMLAttributes<HTMLAtomicInsightNumericFacetElement>;

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 | TemplateResult<1>[];
+    render(props: HierarchicalPathProps): string | TemplateResult<1>[] | TemplateResult;
     private getEllipsedPath;
 }
 export declare const hierarchicalPath: (props: HierarchicalPathProps) => import("lit-html/directive.js").DirectiveResult<typeof HierarchicalPathDirective>;