@coveo/atomic 3.33.8-pre.f71538d21f → 3.33.8-pre.fb9007a768

package/dist/esm/atomic-insight-interface.entry.js

@@ -1,7 +1,7 @@
 import { r as registerInstance, s as setNonce, h, H as Host, g as getElement } from './index-3f35faca.js';
 import { m as markParentAsReady } from './init-queue-fbe942c3.js';
 import { buildResultsPerPage, loadFieldActions, buildInsightEngine } from '@coveo/headless/insight';
-import { g as getNextAnalyticsConfig, a as augmentWithExternalMiddleware, b as augmentAnalyticsWithAtomicVersion, C as CommonAtomicInterfaceHelper, i as instance } from './analytics-config-7a822440.js';
+import { g as getNextAnalyticsConfig, a as augmentWithExternalMiddleware, b as augmentAnalyticsWithAtomicVersion, C as CommonAtomicInterfaceHelper, i as instance } from './analytics-config-c66c52a8.js';
 import { A as ArrayProp } from './props-utils-e97ad6bd.js';
 import { D as DEFAULT_MOBILE_BREAKPOINT } from './replace-breakpoint-utils-7a336631.js';
 import { u as unsetLoadingFlag, s as setLoadingFlag, r as registerFacet, g as getFacetElements, w as waitUntilAppLoaded, a as createBaseStore } from './store-015afa83.js';

package/dist/esm/atomic-recs-interface.entry.js

@@ -1,7 +1,7 @@
 import { r as registerInstance, s as setNonce, h, g as getElement } from './index-3f35faca.js';
 import { m as markParentAsReady } from './init-queue-fbe942c3.js';
 import { loadRecommendationActions, loadSearchConfigurationActions, EcommerceDefaultFieldsToInclude, loadFieldActions, buildRecommendationEngine } from '@coveo/headless/recommendation';
-import { g as getNextAnalyticsConfig, c as augmentAnalyticsConfigWithDocument, d as augmentAnalyticsConfigWithAtomicVersion, a as augmentWithExternalMiddleware, b as augmentAnalyticsWithAtomicVersion, C as CommonAtomicInterfaceHelper, i as instance, m as mismatchedInterfaceAndEnginePropError } from './analytics-config-7a822440.js';
+import { g as getNextAnalyticsConfig, c as augmentAnalyticsConfigWithDocument, d as augmentAnalyticsConfigWithAtomicVersion, a as augmentWithExternalMiddleware, b as augmentAnalyticsWithAtomicVersion, C as CommonAtomicInterfaceHelper, i as instance, m as mismatchedInterfaceAndEnginePropError } from './analytics-config-c66c52a8.js';
 import { A as ArrayProp } from './props-utils-e97ad6bd.js';
 import { u as unsetLoadingFlag, s as setLoadingFlag, a as createBaseStore } from './store-015afa83.js';
 import './dayjs.min-d04628c6.js';

package/dist/esm/atomic-search-interface.entry.js

@@ -1,7 +1,7 @@
 import { r as registerInstance, s as setNonce, h, g as getElement } from './index-3f35faca.js';
 import { m as markParentAsReady } from './init-queue-fbe942c3.js';
 import { loadSearchConfigurationActions, loadQueryActions, EcommerceDefaultFieldsToInclude, loadFieldActions, buildSearchEngine, buildUrlManager, buildSearchStatus } from '@coveo/headless';
-import { g as getNextAnalyticsConfig, d as augmentAnalyticsConfigWithAtomicVersion, c as augmentAnalyticsConfigWithDocument, a as augmentWithExternalMiddleware, b as augmentAnalyticsWithAtomicVersion, C as CommonAtomicInterfaceHelper, i as instance, m as mismatchedInterfaceAndEnginePropError } from './analytics-config-7a822440.js';
+import { g as getNextAnalyticsConfig, d as augmentAnalyticsConfigWithAtomicVersion, c as augmentAnalyticsConfigWithDocument, a as augmentWithExternalMiddleware, b as augmentAnalyticsWithAtomicVersion, C as CommonAtomicInterfaceHelper, i as instance, m as mismatchedInterfaceAndEnginePropError } from './analytics-config-c66c52a8.js';
 import { a as StorageItems, S as SafeStorage } from './local-storage-utils-410269e6.js';
 import { A as ArrayProp } from './props-utils-e97ad6bd.js';
 import { D as DEFAULT_MOBILE_BREAKPOINT } from './replace-breakpoint-utils-7a336631.js';

package/dist/esm/version.js

@@ -1,2 +1,2 @@
-export const headlessVersion = '3.31.1-pre.f71538d21f';
-export const atomicVersion = '3.33.8-pre.f71538d21f';
+export const headlessVersion = '3.31.1-pre.fb9007a768';
+export const atomicVersion = '3.33.8-pre.fb9007a768';

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

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

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

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

package/docs/atomic-docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2025-09-26T16:52:20",
+  "timestamp": "2025-09-29T15:39:18",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.20.0",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coveo/atomic",
   "type": "module",
-  "version": "3.33.8-pre.f71538d21f",
+  "version": "3.33.8-pre.fb9007a768",
   "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.f71538d21f",
+    "@coveo/headless": "3.31.1-pre.fb9007a768",
     "@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.f71538d21f",
+    "@coveo/headless": "3.31.1-pre.fb9007a768",
     "typescript": ">=5.0.0"
   },
   "peerDependenciesMeta": {