@zonos/elements 1.3.288 → 1.3.290

package/dist/collection/components/hello/zonos-hello/zonos-hello.js

@@ -14,6 +14,7 @@ import { getHasMoreSpaceOnRight } from "../../utils/hello/getHasMoreSpaceOnRight
 import { getHelloWidgetSize } from "../../utils/hello/getHelloWidgetSize";
 import { getProductsOnPage } from "../../utils/hello/getProductsOnPage";
 import { getZCountryUrlParam } from "../../utils/hello/getZCountryUrlParam";
+import { resolveHelloFloatPlacement } from "../../utils/hello/resolveHelloFloatPlacement";
 import { setZCountryUrlParam } from "../../utils/hello/setZCountryUrlParam";
 import { shouldShowHelloWidget } from "../../utils/hello/shouldShowHelloWidget";
 import { log } from "../../utils/logging/log";
@@ -224,6 +225,8 @@ export class ZonosHello {
         return localizationStore.helloCountryList;
     }
     componentWillLoad() {
+        // Set before first paint so mobile uses mobile placement, not desktop.
+        this.isMobile = window.innerWidth <= 768;
         const initInterval = setInterval(async () => {
             if (!this.helloRef) {
                 return;
@@ -309,50 +312,19 @@ export class ZonosHello {
         }
     }
     getHelloLocation() {
-        const mobileLocation = this.mobileLocationOverride || zonosStore.helloSettings.mobileLocation;
-        const desktopLocation = this.desktopLocationOverride || zonosStore.helloSettings.desktopLocation;
-        const isMobileWindow = this.isMobile;
-        switch (true) {
-            // Mobile
-            case isMobileWindow: {
-                const isOnLeft = this.animateFromLeftOverride || (mobileLocation === null || mobileLocation === void 0 ? void 0 : mobileLocation.includes('LEFT'));
-                const isOnTop = mobileLocation === null || mobileLocation === void 0 ? void 0 : mobileLocation.includes('TOP');
-                return {
-                    isMobileWindow,
-                    isOnLeft,
-                    isOnTop,
-                    shouldFloat: !!mobileLocation,
-                };
-            }
-            // Desktop
-            default:
-            case !isMobileWindow: {
-                /**
-                 * Float on desktop when `desktopLocationOverride` is set (explicit
-                 * consumer request) OR when no anchor is specified and a
-                 * `desktopLocation` is configured in the store. With an anchor and no
-                 * override, the widget renders inline at the anchor.
-                 */
-                const shouldFloat = !!this.desktopLocationOverride ||
-                    (!zonosStore.helloSettings.anchorElementSelector &&
-                        !!desktopLocation);
-                // When a desktopLocation is set, derive the side deterministically
-                // from it so RIGHT positions resolve to `false` (not `undefined`).
-                // Spatial detection only runs as a fallback when no location is set
-                // (e.g. inline / anchored placement).
-                const isOnLeft = this.animateFromLeftOverride ||
-                    (shouldFloat && desktopLocation
-                        ? desktopLocation.includes('LEFT')
-                        : this.shouldAnimateLeftDesktop());
-                const isOnTop = desktopLocation === null || desktopLocation === void 0 ? void 0 : desktopLocation.includes('TOP');
-                return {
-                    isMobileWindow,
-                    isOnLeft,
-                    isOnTop,
-                    shouldFloat,
-                };
-            }
-        }
+        // Enum @Prop `*LocationOverride` → component*; settings HelloPlacement object → settings*.
+        return resolveHelloFloatPlacement({
+            anchorElementSelector: zonosStore.helloSettings.anchorElementSelector,
+            animateFromLeftOverride: this.animateFromLeftOverride,
+            componentDesktopLocation: this.desktopLocationOverride,
+            componentMobileLocation: this.mobileLocationOverride,
+            desktopLocation: zonosStore.helloSettings.desktopLocation,
+            isMobileWindow: this.isMobile,
+            mobileLocation: zonosStore.helloSettings.mobileLocation,
+            settingsDesktopPlacement: zonosStore.helloSettings.desktopLocationOverride,
+            settingsMobilePlacement: zonosStore.helloSettings.mobileLocationOverride,
+            shouldAnimateLeftDesktop: () => Boolean(this.shouldAnimateLeftDesktop()),
+        });
     }
     handleAppearanceSettingsOverrideChange() {
         var _a;
@@ -372,7 +344,7 @@ export class ZonosHello {
             return null;
         }
         const { selectedCountryCode, targetCurrency } = localizationStore;
-        const { isOnLeft, isOnTop, shouldFloat } = this.getHelloLocation();
+        const { horizontalOffset, isOnLeft, isOnTop, shouldFloat, verticalOffset } = this.getHelloLocation();
         const appearanceSettings = mergeConfig(zonosStore.appearance, this.appearanceSettingsOverride || null);
         const { theme } = appearanceSettings;
         const restrictedItemsOnPage = (_b = this.allRestrictedItems) === null || _b === void 0 ? void 0 : _b.filter(product => this.productsOnPage.some(restriction => restriction.description === product.itemDescription));
@@ -388,7 +360,15 @@ export class ZonosHello {
             });
         }
         const widgetSize = getHelloWidgetSize(zonosStore.helloSettings.widgetSize);
-        return (h(Host, { class: "zonos--hello zonos--elements", "data-theme": theme, style: { '--zonos-elements-hello-widget-size': `${widgetSize}px` } }, showHello && (h("div", { class: classes([
+        const hostStyle = {
+            '--zonos-elements-hello-widget-size': `${widgetSize}px`,
+        };
+        if (horizontalOffset != null && verticalOffset != null) {
+            hostStyle['--zonos-elements-hello-float-inset-x'] =
+                `${horizontalOffset}px`;
+            hostStyle['--zonos-elements-hello-float-inset-y'] = `${verticalOffset}px`;
+        }
+        return (h(Host, { class: "zonos--hello zonos--elements", "data-theme": theme, style: hostStyle }, showHello && (h("div", { class: classes([
                 'zonos--hello-wrapper',
                 shouldFloat && 'zonos--hello-widget-float',
             ]) }, h("button", { class: classes([
@@ -445,11 +425,8 @@ export class ZonosHello {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [{
-                            "name": "default",
-                            "text": "false"
-                        }],
-                    "text": "Force mobile styling instead of media query and use the passed location value"
+                    "tags": [],
+                    "text": "Override the configured mobile floating location (enum). Takes precedence over\n`helloSettings.mobileLocationOverride` (HelloPlacement) and\n`helloSettings.mobileLocation`."
                 },
                 "getter": false,
                 "setter": false,
@@ -475,7 +452,7 @@ export class ZonosHello {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "Override the configured desktop floating location. Takes precedence over\n`helloSettings.desktopLocation` and also drives the peek-message animation\ndirection, so consumers no longer need `animateFromLeftOverride` for\ndesktop positioning."
+                    "text": "Override the configured desktop floating location. Takes precedence over\n`helloSettings.desktopLocationOverride` (HelloPlacement) and\n`helloSettings.desktopLocation`, and also drives the peek-message animation\ndirection, so consumers no longer need `animateFromLeftOverride` for\ndesktop positioning."
                 },
                 "getter": false,
                 "setter": false,

package/dist/collection/components/main/zonos-controller.js

@@ -277,7 +277,7 @@ export class ZonosController {
                 return;
             }
             const hasCartCallback = 
-            // eslint-disable-next-line deprecation/deprecation -- gating Stripe load also honors the legacy callback
+            // eslint-disable-next-line @typescript-eslint/no-deprecated -- gating Stripe load also honors the legacy callback
             typeof ((_e = zonosStore.checkoutSettings) === null || _e === void 0 ? void 0 : _e.buildCartDetail) === 'function' ||
                 typeof ((_f = zonosStore.checkoutSettings) === null || _f === void 0 ? void 0 : _f.createCartId) === 'function';
             // Checkout also runs without merchant cart callbacks when a cart is
@@ -348,7 +348,7 @@ export class ZonosController {
         zonosStore.organizationName = organizationName;
     }
     render() {
-        return h(Host, { key: '12257443495182932a4ca497928398e22f5fb892', class: "zonos--elements" });
+        return h(Host, { key: '1714865012d806892f03e03896ee2f04aa1a729d', class: "zonos--elements" });
     }
     static get is() { return "zonos-controller"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/paypal/zonos-paypal-payment.js

@@ -1,4 +1,3 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
 import { h, Host, } from "@stencil/core";
 import { paypalStoreInitButtons, paypalStoreOnChange, } from "../store/checkout/paypal";
 import { log } from "../utils/logging/log";
@@ -52,7 +51,7 @@ export class ZonosPaypalPayment {
         this.storeUnsubscribeList.forEach(unsubscribe => unsubscribe());
     }
     render() {
-        return (h(Host, { key: '2eb9e7f7acbe26f51c32ceb722f1e59832ac918a', class: "zonos--paypal-payment zonos--elements" }, h("div", { key: '47ad7f3dfdea67dd5e222e6bbba46ed4599680be', class: "zonos--payment-paypal-container" })));
+        return (h(Host, { key: '50cc936c450fb9afeaf488bfce6b15c2b1c29532', class: "zonos--paypal-payment zonos--elements" }, h("div", { key: '5a5f49d4486acb938d4dcffbbc41c15720201f0e', class: "zonos--payment-paypal-container" })));
     }
     static get is() { return "zonos-paypal-payment"; }
     static get encapsulation() { return "scoped"; }

package/dist/collection/components/store/hello/localization.js

@@ -12,8 +12,12 @@ import { getShippingZones } from "../../utils/api/getShippingZones";
 import { removeBigcommerceCartShipping } from "../../utils/checkout/removeBigcommerceCartShipping";
 import { getSupportedLanguages } from "../../utils/getSupportedLanguages";
 import { handleFetch } from "../../utils/handleFetch";
+import { getCountryOverrideStorage, migrateCountryOverrideStorage, setCountryOverrideStorage, } from "../../utils/hello/countryOverrideStorage";
 import { currencyDisplay } from "../../utils/hello/currencyConversion/currencyDisplay";
 import { getCurrencyCode } from "../../utils/hello/currencyConversion/getCurrencyCode";
+import { getZCountryUrlParam } from "../../utils/hello/getZCountryUrlParam";
+import { isCountryInShippingZone } from "../../utils/hello/isCountryInShippingZone";
+import { reconcileRememberedCountryOverride } from "../../utils/hello/reconcileRememberedCountryOverride";
 import { setZCountryUrlParam } from "../../utils/hello/setZCountryUrlParam";
 import { log } from "../../utils/logging/log";
 import { logError } from "../../utils/logging/logError";
@@ -124,19 +128,23 @@ const getNewLocalization = async ({ isInitializing, }) => {
     }
 };
 const getCustomMessages = async () => {
-    log(`Getting custom messages for ${localizationStore.selectedCountryCode}`);
-    if (!localizationStore.selectedCountryCode || !zonosStore.storeId) {
+    const countryCode = localizationStore.selectedCountryCode;
+    log(`Getting custom messages for ${countryCode}`);
+    if (!countryCode || !zonosStore.storeId) {
         return;
     }
     const localeMessages = await getLocaleMessages({
-        countryCode: localizationStore.selectedCountryCode,
+        countryCode,
         localeTo: localizationStore.selectedLocale,
         storeId: zonosStore.storeId,
     });
+    if (localizationStore.selectedCountryCode !== countryCode) {
+        return;
+    }
     const allMessages = localeMessages.flatMap(x => {
         var _a;
         return {
-            countryCode: localizationStore.selectedCountryCode,
+            countryCode,
             message: (_a = x.countryCodesPageMessageLinks.find(Boolean)) === null || _a === void 0 ? void 0 : _a.message.textTo,
             pageName: x.pageName,
         };
@@ -179,17 +187,19 @@ const getValidLocale = (locale) => {
     log(`Locale ${locale} is not offered, falling back to ${fallback === null || fallback === void 0 ? void 0 : fallback.code}`);
     return (fallback === null || fallback === void 0 ? void 0 : fallback.code) || 'en';
 };
-const localizationStoreUpdateSelectedCountryCode = ({ isInitializing, newSelectedCountryCode, }) => {
-    var _a, _b, _c;
+const syncSelectedCountryToPage = (selectedCountryCode) => {
+    var _a;
+    setZCountryUrlParam(selectedCountryCode);
+    (_a = document
+        .querySelector('zonos-hello')) === null || _a === void 0 ? void 0 : _a.setAttribute('z-country', selectedCountryCode);
+};
+const localizationStoreUpdateSelectedCountryCode = ({ isInitializing, newSelectedCountryCode, persistOverride, }) => {
+    var _a;
     log(`Updating selected country code to ${newSelectedCountryCode}`);
     const isFirstTime = !localizationStore.selectedCountryCode;
     localizationStore.selectedCountryCode = getValidCountryCode(newSelectedCountryCode);
-    const { selectedCountryCode, shippingZoneCountries } = localizationStore;
-    const isShippableCountry = !!shippingZoneCountries &&
-        !!selectedCountryCode &&
-        !!shippingZoneCountries[selectedCountryCode] &&
-        // Make sure the country is not in the disabled countries list
-        !zonosStore.disabledCountries.includes(selectedCountryCode);
+    const { selectedCountryCode } = localizationStore;
+    const isShippableCountry = isCountryInShippingZone(selectedCountryCode);
     // update shippable country
     localizationStore.isShippableCountry = isShippableCountry;
     log(`${localizationStore.selectedCountryCode} is a shippable country: ${localizationStore.isShippableCountry}`);
@@ -212,9 +222,10 @@ const localizationStoreUpdateSelectedCountryCode = ({ isInitializing, newSelecte
         return;
     }
     const currencyCode = getCurrencyCode(selectedCountryCode);
-    // Only trigger callback onCountryChange if the country code has been set before
-    if (!isFirstTime) {
-        // Trigger callback onCountryChange
+    const shouldPersistOverride = persistOverride !== null && persistOverride !== void 0 ? persistOverride : !isInitializing;
+    // Only trigger onCountryChange after init — the first apply, and any
+    // reconcile fallback during init, are not shopper-selected changes.
+    if (!isFirstTime && !isInitializing) {
         (_a = zonosStore.onCountryChange) === null || _a === void 0 ? void 0 : _a.call(zonosStore, {
             countryCode: selectedCountryCode,
             currencyCode,
@@ -244,27 +255,24 @@ const localizationStoreUpdateSelectedCountryCode = ({ isInitializing, newSelecte
         localizationStore.countryLandedCost = null;
         localizationStore.inclusivePricingConfigurations = [];
         currencyDisplay();
+    }
+    else {
+        localizationStore.targetCurrency = currencyCode;
+        // Init may apply a remembered country that reconcile then discards. Fetch
+        // exchange rates once after reconcile for the final country instead.
         if (!isInitializing) {
-            void getCustomMessages();
+            void getNewLocalization({ isInitializing: false });
         }
-        // Clear session so the next visit falls back to geolocation, but keep
-        // the current shopper's explicit selection visible in the URL (so a
-        // same-tab reload still honors it) and on the hello element.
-        window.sessionStorage.removeItem('zonos--country');
-        setZCountryUrlParam(selectedCountryCode);
-        (_b = document
-            .querySelector('zonos-hello')) === null || _b === void 0 ? void 0 : _b.setAttribute('z-country', selectedCountryCode);
-        return;
     }
-    localizationStore.targetCurrency = currencyCode;
-    void getNewLocalization({ isInitializing: isInitializing });
     if (!isInitializing) {
         void getCustomMessages();
     }
-    window.sessionStorage.setItem('zonos--country', selectedCountryCode);
-    setZCountryUrlParam(selectedCountryCode);
-    (_c = document
-        .querySelector('zonos-hello')) === null || _c === void 0 ? void 0 : _c.setAttribute('z-country', selectedCountryCode);
+    if (shouldPersistOverride) {
+        setCountryOverrideStorage(selectedCountryCode);
+    }
+    if (!isInitializing) {
+        syncSelectedCountryToPage(selectedCountryCode);
+    }
 };
 const initHelloCountryList = (allCountries) => {
     var _a, _b, _c, _d, _e, _f;
@@ -343,12 +351,25 @@ const localizationStoreUpdateSelectedLocale = (requestedLocale) => {
     localizationStore.selectedLocale = newSelectedLocale;
     translationStoreUpdateLanguage(newSelectedLocale);
     void updateCheckoutSessionLanguage();
-    void getCustomMessages();
+    if (localizationStore.localizationLoaded) {
+        void getCustomMessages();
+    }
 };
 const initLocalizationStore = async () => {
     var _a;
+    migrateCountryOverrideStorage();
+    const urlCountryAtLoad = getZCountryUrlParam();
+    const storedCountryAtLoad = getCountryOverrideStorage();
+    const shouldPrefetchGeo = !!storedCountryAtLoad && !urlCountryAtLoad;
     // all countries from countries.json, shipping zone and localization
-    const [allCountries, shippingZoneCountries, localization] = await Promise.all([getCountries(), getShippingZones(), getLocalization()]);
+    const [allCountries, shippingZoneCountries, localization, geoLocalization] = await Promise.all([
+        getCountries(),
+        getShippingZones(),
+        getLocalization(),
+        shouldPrefetchGeo
+            ? getLocalization({ ignoreCountryOverride: true })
+            : Promise.resolve(undefined),
+    ]);
     // Filter countries to only include countries in the shipping zone
     const filteredCountries = shippingZoneCountries === null || shippingZoneCountries === void 0 ? void 0 : shippingZoneCountries.reduce((acc, countryCode) => {
         const countryInfo = allCountries === null || allCountries === void 0 ? void 0 : allCountries[countryCode];
@@ -367,7 +388,7 @@ const initLocalizationStore = async () => {
     // update selected country code in store
     localizationStoreUpdateSelectedCountryCode({
         isInitializing: true,
-        newSelectedCountryCode: country || null,
+        newSelectedCountryCode: country || storedCountryAtLoad,
     });
     // use locale from params if it exists, otherwise use locale from localization
     const overrideLocale = getOverrideLocale();
@@ -389,10 +410,24 @@ const initLocalizationStore = async () => {
             newSelectedCountryCode: 'CA',
         });
     }
+    const fallbackCountry = await reconcileRememberedCountryOverride({
+        geoCountry: geoLocalization === null || geoLocalization === void 0 ? void 0 : geoLocalization.country,
+        urlCountryAtLoad,
+    });
+    if (fallbackCountry) {
+        localizationStoreUpdateSelectedCountryCode({
+            isInitializing: true,
+            newSelectedCountryCode: fallbackCountry,
+        });
+    }
+    if (localizationStore.selectedCountryCode) {
+        syncSelectedCountryToPage(localizationStore.selectedCountryCode);
+    }
+    void getCustomMessages();
+    void getNewLocalization({ isInitializing: true });
     if (!localizationStore.localizationLoaded) {
         localizationStore.localizationLoaded = true;
         void removeBigcommerceCartShipping();
-        // shouldShowHelloWidget is false because localization is not loaded yet
         void toggleBigcommerceNativeCurrencySelector();
     }
 };

package/dist/collection/components/store/zonosStore.js

@@ -71,9 +71,11 @@ const { dispose: zonosStoreDispose, onChange: zonosStoreOnChange, reset, state:
          * Default to bottom right so hello would float if anchorElementSelector is not set. Otherwise, this will be ignored
          */
         desktopLocation: 'BOTTOM_RIGHT',
+        desktopLocationOverride: null,
         excludedUrlPatterns: [],
         homepageUrlPattern: '',
         mobileLocation: 'BOTTOM_RIGHT',
+        mobileLocationOverride: null,
         mode: 'LIVE',
         notFoundElementFallback: null,
         organization: '',

package/dist/collection/components/stripe/zonos-address/zonos-address.js

@@ -357,11 +357,11 @@ export class ZonosAddress {
             this.isAddressFilled = true;
         }
         // this component loads iframe from the stripe elements and puts here, so we don't need to do anything here
-        return (h(Host, { key: '9b7a5340b839d63c64da03639bdfda5a11a5c25e', class: classes([
+        return (h(Host, { key: '302dafde973c4bf2d847640d8f0e064d88f350f8', class: classes([
                 'zonos--address',
                 'zonos--elements',
                 `zonos--${this.type}-address`,
-            ]) }, this.titleText && (h("zonos-text", { key: '23739f6a48e5698372df2d53098dea6ad1c0559a', class: "zonos--title", type: "semiBoldLabel" }, this.titleText)), h("slot", { key: 'dea4b437eedaad2af2f6bbe3a1e2ae4f0706aa13', name: "below-title" }), this.renderCompanyNameInput(), this.renderTaxIdInput(), this.renderShortAddressCodeInput(), h("div", { key: 'b4be684977a632371b9b6ff4587ccdd7bacc8c67', class: "zonos--address-component" })));
+            ]) }, this.titleText && (h("zonos-text", { key: '706204604ad32eed710e38adbe8133b3384044eb', class: "zonos--title", type: "semiBoldLabel" }, this.titleText)), h("slot", { key: '0edc4c5d6c3ff965be6edbf680acaed892c71a16', name: "below-title" }), this.renderCompanyNameInput(), this.renderTaxIdInput(), this.renderShortAddressCodeInput(), h("div", { key: '6aa6e4e86a76f1081c5af1f2b5f3282dfd91f3c5', class: "zonos--address-component" })));
     }
     static get is() { return "zonos-address"; }
     static get encapsulation() { return "scoped"; }

package/dist/collection/components/stripe/zonos-custom-address/zonos-address-suggestions/zonos-address-suggestions.js

@@ -1,4 +1,3 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
 import { h, Host, } from "@stencil/core";
 import { classes } from "../../../utils/classes";
 import { getBorderRadius } from "../../../utils/getBorderRadius";
@@ -78,9 +77,9 @@ export class ZonosAddressSuggestions {
         return segments;
     }
     render() {
-        return (h(Host, { key: '9de4179f1bd0057ac71d6b9ed646c034035382f7', class: "zonos--address-suggestions", role: "group", style: {
+        return (h(Host, { key: '34018ecc951c0335041e24102329eb83a8d68439', class: "zonos--address-suggestions", role: "group", style: {
                 '--zonos--border-radius': getBorderRadius(),
-            } }, h("ul", { key: '62fa5ed92fafcdd641f9a7eb36e36e62309c9f52', "aria-label": "Suggestions", class: "wrapper", role: "listbox" }, !!this.localSuggestions.length && (h("li", { key: '27c61b5693720d0b33a75385841476787f92b884', "aria-selected": false, class: "powered-by option", role: "option" }, h("div", { key: 'fea9f2e8f65cd50fdf28fc45e18beb8976320f0d', class: "powered-by-container" }, h("zonos-text", { key: '1fec46f543e3673433b6924f7dca1cbd84e0ef16', type: "caption" }, "Suggestions powered by"), h("zonos-text", { key: '7b3fd93c18d4320522d61e07278f5388d14c8bbb', type: "semiBoldLabel" }, "Google")), h("zonos-button", { key: '61a8362ab0514a78dd71eaa9bd638dc8b50e2a9c', "aria-label": "Clear suggestions", icon: h("zonos-icon", { content: RemoveIcon }), noBackground: true, onClick: () => {
+            } }, h("ul", { key: '80433831c875845e57225a1317c430e2626edf9a', "aria-label": "Suggestions", class: "wrapper", role: "listbox" }, !!this.localSuggestions.length && (h("li", { key: '3510ef51b56b1cb0a36334e842792bccc2daeca5', "aria-selected": false, class: "powered-by option", role: "option" }, h("div", { key: '72773af6f9c7e0644ebc5239e4bf585bba6e164a', class: "powered-by-container" }, h("zonos-text", { key: '7fabccbe33cbc8d037dfd25f6e5b0a5bdaf97b2f', type: "caption" }, "Suggestions powered by"), h("zonos-text", { key: '2d88a3b8d7369a44e910ec60f5c7ac0c3f0ce801', type: "semiBoldLabel" }, "Google")), h("zonos-button", { key: '74315c248cc84617d854a3b51d0bad8300c6b762', "aria-label": "Clear suggestions", icon: h("zonos-icon", { content: RemoveIcon }), noBackground: true, onClick: () => {
                 this.localSuggestions = [];
             } }))), this.localSuggestions.map(suggestion => (
         // eslint-disable-next-line jsx-a11y/click-events-have-key-events

package/dist/collection/components/stripe/zonos-custom-address/zonos-custom-address.js

@@ -933,10 +933,10 @@ export class ZonosAddress {
             this.country = localizationStore.selectedCountryCode;
         }
         // this component loads iframe from the stripe elements and puts here, so we don't need to do anything here
-        return (h(Host, { key: 'b4e39a6e92e646f98c0061bf3de8e028c9285556', class: classes([
+        return (h(Host, { key: '9d178094ee341623633d1e3822bd79f254a27e51', class: classes([
                 'zonos--address zonos--elements',
                 `zonos--${this.type}-address`,
-            ]) }, h("zonos-text", { key: '28d21737c78a1b8125c5170c67f214e3f39939ff', class: "zonos--title", type: "semiBoldLabel" }, this.titleText), h("slot", { key: '97357f001b27197b8648d6158b786b153c31a7ba', name: "below-title" }), this.renderCompanyNameInput(), this.renderTaxIdInput(), this.renderShortAddressCodeInput(), this.renderCustomAddressForm()));
+            ]) }, h("zonos-text", { key: 'c36b4ce9b63cce95664894fd8929ffe15807a22a', class: "zonos--title", type: "semiBoldLabel" }, this.titleText), h("slot", { key: '661eab7074f99b6dca52d5f7f546cfbd29322fbf', name: "below-title" }), this.renderCompanyNameInput(), this.renderTaxIdInput(), this.renderShortAddressCodeInput(), this.renderCustomAddressForm()));
     }
     static get is() { return "zonos-custom-address"; }
     static get encapsulation() { return "scoped"; }

package/dist/collection/components/stripe/zonos-link-authentication/zonos-link-authentication.js

@@ -1,4 +1,3 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
 import { h, Host, } from "@stencil/core";
 import { cartStore } from "../../store/checkout/cart";
 import { stripeStore, stripeStoreOnChange, } from "../../store/checkout/stripe";

package/dist/collection/components/utils/api/getLocalization.js

@@ -1,8 +1,8 @@
 import { getOverridenZCountry } from "../getOverridenZCountry";
 import { handleFetch } from "../handleFetch";
-export const getLocalization = async () => {
+export const getLocalization = async ({ ignoreCountryOverride = false, } = {}) => {
     try {
-        const zCountry = getOverridenZCountry();
+        const zCountry = ignoreCountryOverride ? null : getOverridenZCountry();
         const searchParams = new URLSearchParams();
         if (zCountry) {
             searchParams.set('zCountry', zCountry);

package/dist/collection/components/utils/checkout/isShippableCountry.js

@@ -1,18 +1,16 @@
 import { localizationStore } from "../../store/hello/localization";
-import { zonosStore } from "../../store/zonosStore";
+import { isCountryInShippingZone } from "../hello/isCountryInShippingZone";
 import { log } from "../logging/log";
 export const isShippableCountry = (showLog = true, 
 /**
  * If provided, will check if the country is shippable based on the provided country code instead of the Hello selected country code
  */
 providedCountryCode) => {
-    var _a;
     if (!localizationStore.localizationLoaded) {
         return false;
     }
     if (providedCountryCode) {
-        const isProvidedCountryCodeShippableCountry = !!((_a = localizationStore.shippingZoneCountries) === null || _a === void 0 ? void 0 : _a[providedCountryCode]) &&
-            !zonosStore.disabledCountries.includes(providedCountryCode);
+        const isProvidedCountryCodeShippableCountry = isCountryInShippingZone(providedCountryCode);
         if (showLog && !isProvidedCountryCodeShippableCountry) {
             log(`Checkout: ${providedCountryCode} is not a shippable country: ${isProvidedCountryCodeShippableCountry}`);
         }

package/dist/collection/components/utils/checkout/watchBigcommerceDomesticCheckout.js

@@ -48,6 +48,7 @@ export const watchBigcommerceDomesticCheckout = ({ domesticRedirectedBtnSelector
             localizationStoreUpdateSelectedCountryCode({
                 isInitializing: false,
                 newSelectedCountryCode: shippingCountry,
+                persistOverride: false,
             });
             // do nothing if the country is still domestic
             if (!isShippableCountry(false)) {

package/dist/collection/components/utils/checkout/watchImmediateBigcommerceDomesticCheckoutRedirect.js

@@ -80,6 +80,7 @@ const checkLoggedInUserShippingAddress = async ({ onInternationalCheckoutSelecte
     localizationStoreUpdateSelectedCountryCode({
         isInitializing: false,
         newSelectedCountryCode: countryCode,
+        persistOverride: false,
     });
     // Save the shipping address to session storage for the international checkout
     stripeStoreSaveDomesticShippingSession({
@@ -163,6 +164,7 @@ export const watchImmediateBigcommerceDomesticCheckoutRedirect = ({ domesticRedi
         localizationStoreUpdateSelectedCountryCode({
             isInitializing: false,
             newSelectedCountryCode: shippingCountry,
+            persistOverride: false,
         });
         const shippingAddress = {
             address1: '',

package/dist/collection/components/utils/formatDate.js

@@ -1,6 +1,4 @@
-export const formatDate = ({ date, 
-// eslint-disable-next-line sort-keys/sort-keys-fix
-formatOptions = {
+export const formatDate = ({ date, formatOptions = {
     dateStyle: 'full',
 }, }) => {
     // format date to 'Wednesday, May 15, 2024'

package/dist/collection/components/utils/getOverridenZCountry.js

@@ -1,11 +1,9 @@
+import { getCountryOverrideStorage } from "./hello/countryOverrideStorage";
 import { getZCountryUrlParam } from "./hello/getZCountryUrlParam";
 /**
- * Retrieve the zCountry from the URL or session storage.
+ * Retrieve the shopper country override from the URL or remembered storage.
  */
 export const getOverridenZCountry = () => {
     const currentUrl = new URL(window.location.href);
-    // load and use country from session storage when zCountry query param is not present
-    const countryLoadedSession = window.sessionStorage.getItem('zonos--country');
-    const zCountry = getZCountryUrlParam(currentUrl.searchParams) || countryLoadedSession;
-    return zCountry;
+    return (getZCountryUrlParam(currentUrl.searchParams) || getCountryOverrideStorage());
 };

package/dist/collection/components/utils/hello/countryOverrideStorage.js

@@ -0,0 +1,49 @@
+import { isCountryCode } from "./isCountryCode";
+const COUNTRY_OVERRIDE_KEY = 'zonos--country';
+const withBlockedStorage = (run) => {
+    try {
+        run();
+    }
+    catch (_a) {
+        // localStorage/sessionStorage can throw in blocked-storage contexts
+        // (Safari private mode, cross-origin iframes).
+    }
+};
+const clearSessionOverride = () => {
+    window.sessionStorage.removeItem(COUNTRY_OVERRIDE_KEY);
+};
+const readStoredCountry = (storage) => {
+    try {
+        const value = storage.getItem(COUNTRY_OVERRIDE_KEY);
+        if (!value || !isCountryCode(value)) {
+            return null;
+        }
+        return value;
+    }
+    catch (_a) {
+        return null;
+    }
+};
+export const getCountryOverrideStorage = () => {
+    var _a;
+    return (_a = readStoredCountry(window.localStorage)) !== null && _a !== void 0 ? _a : readStoredCountry(window.sessionStorage);
+};
+export const migrateCountryOverrideStorage = () => {
+    withBlockedStorage(() => {
+        if (readStoredCountry(window.localStorage)) {
+            clearSessionOverride();
+        }
+    });
+};
+export const setCountryOverrideStorage = (countryCode) => {
+    withBlockedStorage(() => {
+        window.localStorage.setItem(COUNTRY_OVERRIDE_KEY, countryCode);
+        clearSessionOverride();
+    });
+};
+export const clearCountryOverrideStorage = () => {
+    withBlockedStorage(() => {
+        window.localStorage.removeItem(COUNTRY_OVERRIDE_KEY);
+        clearSessionOverride();
+    });
+};

package/dist/collection/components/utils/hello/getZCountryUrlParam.js

@@ -1,16 +1,12 @@
-const validateCountryCode = (countryCode) => {
-    // Check that the country is two characters and is upper case
-    if (countryCode && /^[A-Z]{2}$/.test(countryCode)) {
-        return countryCode;
-    }
-    return null;
-};
+import { isCountryCode } from "./isCountryCode";
 export const getZCountryUrlParam = (urlParams) => {
     const urlSearchParams = new URLSearchParams(urlParams || window.location.search);
     const getCountryParam = (param) => {
         const country = urlSearchParams.get(param);
-        // Check that the country is two characters and is upper case
-        return validateCountryCode(country);
+        if (country && isCountryCode(country)) {
+            return country;
+        }
+        return null;
     };
     const zCountry = getCountryParam('zCountry');
     // Fallback to legacy 'country'

package/dist/collection/components/utils/hello/isCountryCode.js

@@ -0,0 +1 @@
+export const isCountryCode = (value) => /^[A-Z]{2}$/.test(value);

package/dist/collection/components/utils/hello/isCountryInShippingZone.js

@@ -0,0 +1,8 @@
+import { localizationStore } from "../../store/hello/localization";
+import { zonosStore } from "../../store/zonosStore";
+export const isCountryInShippingZone = (countryCode) => {
+    var _a;
+    return !!countryCode &&
+        !!((_a = localizationStore.shippingZoneCountries) === null || _a === void 0 ? void 0 : _a[countryCode]) &&
+        !zonosStore.disabledCountries.includes(countryCode);
+};

package/dist/collection/components/utils/hello/reconcileRememberedCountryOverride.js

@@ -0,0 +1,37 @@
+import { getLocalization } from "../api/getLocalization";
+import { clearCountryOverrideStorage, getCountryOverrideStorage, } from "./countryOverrideStorage";
+import { getHelloWidgetVisibility } from "./shouldShowHelloWidget";
+/**
+ * Drop a remembered Hello country when widgetVisibility would hide the
+ * widget for it, then fall back to geo.
+ *
+ * Does not mutate the localization store — the caller applies the returned
+ * country. Pass `geoCountry` when init already fetched IP localization so
+ * discard does not wait on a second round trip. Pass `urlCountryAtLoad`
+ * from the URL as it was at page load (before init writes `zCountry` for
+ * URL_PARAM merchants). Do not omit it after a live URL write — the
+ * default is `null`, not the current URL. Storage is cleared when geo
+ * succeeds, or when a load-time URL country won and the stored country
+ * would be hidden.
+ */
+export const reconcileRememberedCountryOverride = async ({ geoCountry, urlCountryAtLoad = null, } = {}) => {
+    const storedCountry = getCountryOverrideStorage();
+    if (!storedCountry) {
+        return null;
+    }
+    if (getHelloWidgetVisibility(false, storedCountry)) {
+        return null;
+    }
+    if (urlCountryAtLoad) {
+        clearCountryOverrideStorage();
+        return null;
+    }
+    const country = geoCountry !== undefined
+        ? geoCountry
+        : (await getLocalization({ ignoreCountryOverride: true })).country;
+    if (!country) {
+        return null;
+    }
+    clearCountryOverrideStorage();
+    return country;
+};