@zonos/elements 1.3.268 → 1.3.269

package/dist/cjs/zonos-collect-finish_6.cjs.entry.js

@@ -3,19 +3,19 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-b1f95d96.js');
-const cart = require('./cart-af7c024e.js');
-const paypal = require('./paypal-6756a0da.js');
-const localization = require('./localization-f897bc45.js');
+const cart = require('./cart-87fbbb5a.js');
+const paypal = require('./paypal-cfe1e8e9.js');
+const localization = require('./localization-a969f224.js');
 const zonosStore = require('./zonosStore-45a87908.js');
 const handleFetch = require('./handleFetch-954f30e1.js');
 const createCustomEvent = require('./createCustomEvent-7b6fad95.js');
 const getBorderRadius = require('./getBorderRadius-fc683d94.js');
 const VarianceTest = require('./VarianceTest-bec00ea8.js');
-const isCollectMobileTablet = require('./isCollectMobileTablet-6014787b.js');
+const isCollectMobileTablet = require('./isCollectMobileTablet-1cb21c59.js');
 const classes = require('./classes-b7918f56.js');
 const ILanguage = require('./ILanguage-98b04442.js');
-const renderCheckoutCurrency = require('./renderCheckoutCurrency-584d50fe.js');
-const placeTestOrder = require('./placeTestOrder-a4874e51.js');
+const renderCheckoutCurrency = require('./renderCheckoutCurrency-5a333d29.js');
+const placeTestOrder = require('./placeTestOrder-613878fb.js');
 const renderFallback = require('./renderFallback-bc20ee20.js');
 require('./isDarkColor-5d6ca405.js');
 require('./isContrastColor-76592c92.js');

package/dist/cjs/zonos-collect.cjs.entry.js

@@ -3,10 +3,10 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-b1f95d96.js');
-const cart = require('./cart-af7c024e.js');
-const isCollectMobileTablet = require('./isCollectMobileTablet-6014787b.js');
-const paypal = require('./paypal-6756a0da.js');
-const localization = require('./localization-f897bc45.js');
+const cart = require('./cart-87fbbb5a.js');
+const isCollectMobileTablet = require('./isCollectMobileTablet-1cb21c59.js');
+const paypal = require('./paypal-cfe1e8e9.js');
+const localization = require('./localization-a969f224.js');
 const zonosStore = require('./zonosStore-45a87908.js');
 const buildCartItemsByTempCart = require('./buildCartItemsByTempCart-edddbf4b.js');
 const handleFetch = require('./handleFetch-954f30e1.js');

package/dist/cjs/zonos-controller.cjs.entry.js

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-b1f95d96.js');
-const cart = require('./cart-af7c024e.js');
-const localization = require('./localization-f897bc45.js');
+const cart = require('./cart-87fbbb5a.js');
+const localization = require('./localization-a969f224.js');
 const zonosStore = require('./zonosStore-45a87908.js');
 const getGenericSettingsOverride = require('./getGenericSettingsOverride-c0ca32b9.js');
 const handleFetch = require('./handleFetch-954f30e1.js');

package/dist/cjs/zonos-country-flag.cjs.entry.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-b1f95d96.js');
-const localization = require('./localization-f897bc45.js');
+const localization = require('./localization-a969f224.js');
 const zonosStore = require('./zonosStore-45a87908.js');
 const classes = require('./classes-b7918f56.js');
 require('./handleFetch-954f30e1.js');

package/dist/cjs/zonos-country-select_4.cjs.entry.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-b1f95d96.js');
-const localization = require('./localization-f897bc45.js');
+const localization = require('./localization-a969f224.js');
 const zonosStore = require('./zonosStore-45a87908.js');
 const formatStringWithLinks = require('./formatStringWithLinks-52341fc7.js');
 const isDarkColor = require('./isDarkColor-5d6ca405.js');

package/dist/cjs/zonos-hello-dialog.cjs.entry.js

@@ -3,11 +3,11 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-b1f95d96.js');
-const localization = require('./localization-f897bc45.js');
+const localization = require('./localization-a969f224.js');
 const zonosStore = require('./zonosStore-45a87908.js');
 const classes = require('./classes-b7918f56.js');
 const formatStringWithLinks = require('./formatStringWithLinks-52341fc7.js');
-const hasInclusivePrice = require('./hasInclusivePrice-0fa6e022.js');
+const hasInclusivePrice = require('./hasInclusivePrice-c86ed1f5.js');
 const getHasMoreSpaceOnRight = require('./getHasMoreSpaceOnRight-4c94667f.js');
 const TaxId = require('./TaxId-12acedde.js');
 require('./handleFetch-954f30e1.js');

package/dist/cjs/zonos-hello.cjs.entry.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-b1f95d96.js');
 const debounce = require('./debounce-7990f5ea.js');
-const localization = require('./localization-f897bc45.js');
+const localization = require('./localization-a969f224.js');
 const zonosStore = require('./zonosStore-45a87908.js');
 const classes = require('./classes-b7918f56.js');
 const handleFetch = require('./handleFetch-954f30e1.js');
@@ -333,49 +333,6 @@ const ZonosHello = class {
                 return hasMoreSpaceOnRight;
             }
         };
-        this.shouldRenderHello = (showLog = true) => {
-            var _a, _b;
-            if (!localization.localizationStore.localizationLoaded) {
-                return false;
-            }
-            const { countryDisplayRules, showForCountries } = zonosStore.zonosStore.helloSettings;
-            const visibilityRules = countryDisplayRules === null || countryDisplayRules === void 0 ? void 0 : countryDisplayRules.widgetVisibility;
-            const selectedCountry = localization.localizationStore.selectedCountryCode;
-            // Resolve behavior: deprecated showForCountries overrides widgetVisibility.behavior
-            // If showForCountries is an array of country codes, treat as legacy explicit list
-            const behavior = Array.isArray(showForCountries)
-                ? showForCountries
-                : (showForCountries !== null && showForCountries !== void 0 ? showForCountries : visibilityRules === null || visibilityRules === void 0 ? void 0 : visibilityRules.behavior);
-            if (showLog && !localization.localizationStore.isShippableCountry) {
-                VarianceTest.log(`Hello: not shippable country - Show for countries: ${behavior}`);
-            }
-            // Legacy: explicit list of country codes from deprecated showForCountries
-            if (Array.isArray(behavior)) {
-                return !!selectedCountry && behavior.includes(selectedCountry);
-            }
-            // Determine base visibility from behavior
-            let isVisible;
-            if (behavior === 'ALL') {
-                isVisible = true;
-            }
-            else {
-                // Default: ONLY_SHIPPABLE
-                isVisible = localization.localizationStore.isShippableCountry;
-            }
-            // Apply includedCountries — force show the widget for these countries
-            if (!isVisible &&
-                selectedCountry &&
-                ((_a = visibilityRules === null || visibilityRules === void 0 ? void 0 : visibilityRules.includedCountries) === null || _a === void 0 ? void 0 : _a.includes(selectedCountry))) {
-                isVisible = true;
-            }
-            // Apply excludedCountries — force hide the widget for these countries
-            if (isVisible &&
-                selectedCountry &&
-                ((_b = visibilityRules === null || visibilityRules === void 0 ? void 0 : visibilityRules.excludedCountries) === null || _b === void 0 ? void 0 : _b.includes(selectedCountry))) {
-                isVisible = false;
-            }
-            return isVisible;
-        };
     }
     showDialogHandler(showDialog) {
         var _a;
@@ -551,7 +508,7 @@ const ZonosHello = class {
         // The  organization name can be changed after init with the updateOrganizationName method.
         // This will cause the element to rerender with the new org name when it changes. (used for preview on dashboard)
         this.peekMessage = this.getHelloPeekMessage(zonosStore.zonosStore.organizationName);
-        const showHello = this.shouldRenderHello() && !!selectedCountryCode;
+        const showHello = localization.shouldShowHelloWidget() && !!selectedCountryCode;
         // If the condition for rendering Hello is met, set the toggle to true to trigger callback, should only trigger once
         if (showHello && !this.isHelloWidgetRendered) {
             this.handleHelloWidgetInitializedState({

package/dist/cjs/zonos-invoice-cart-items_2.cjs.entry.js

@@ -3,11 +3,11 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-b1f95d96.js');
-const cart = require('./cart-af7c024e.js');
-const localization = require('./localization-f897bc45.js');
-const renderCheckoutCurrency = require('./renderCheckoutCurrency-584d50fe.js');
+const cart = require('./cart-87fbbb5a.js');
+const localization = require('./localization-a969f224.js');
+const renderCheckoutCurrency = require('./renderCheckoutCurrency-5a333d29.js');
 const classes = require('./classes-b7918f56.js');
-const invoice = require('./invoice-c2e3f232.js');
+const invoice = require('./invoice-952f32c4.js');
 const renderFallback = require('./renderFallback-bc20ee20.js');
 require('./zonosStore-45a87908.js');
 require('./VarianceTest-bec00ea8.js');

package/dist/cjs/zonos-invoice-finish_5.cjs.entry.js

@@ -3,9 +3,9 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-b1f95d96.js');
-const cart = require('./cart-af7c024e.js');
-const paypal = require('./paypal-6756a0da.js');
-const localization = require('./localization-f897bc45.js');
+const cart = require('./cart-87fbbb5a.js');
+const paypal = require('./paypal-cfe1e8e9.js');
+const localization = require('./localization-a969f224.js');
 const zonosStore = require('./zonosStore-45a87908.js');
 const handleFetch = require('./handleFetch-954f30e1.js');
 const createCustomEvent = require('./createCustomEvent-7b6fad95.js');
@@ -14,9 +14,9 @@ const VarianceTest = require('./VarianceTest-bec00ea8.js');
 const isInvoiceMobileTablet = require('./isInvoiceMobileTablet-dde41e4e.js');
 const classes = require('./classes-b7918f56.js');
 const ILanguage = require('./ILanguage-98b04442.js');
-const invoice = require('./invoice-c2e3f232.js');
-const renderCheckoutCurrency = require('./renderCheckoutCurrency-584d50fe.js');
-const placeTestOrder = require('./placeTestOrder-a4874e51.js');
+const invoice = require('./invoice-952f32c4.js');
+const renderCheckoutCurrency = require('./renderCheckoutCurrency-5a333d29.js');
+const placeTestOrder = require('./placeTestOrder-613878fb.js');
 const renderFallback = require('./renderFallback-bc20ee20.js');
 require('./isDarkColor-5d6ca405.js');
 require('./isContrastColor-76592c92.js');

package/dist/cjs/zonos-invoice.cjs.entry.js

@@ -3,10 +3,10 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-b1f95d96.js');
-const cart = require('./cart-af7c024e.js');
-const invoice = require('./invoice-c2e3f232.js');
-const paypal = require('./paypal-6756a0da.js');
-const localization = require('./localization-f897bc45.js');
+const cart = require('./cart-87fbbb5a.js');
+const invoice = require('./invoice-952f32c4.js');
+const paypal = require('./paypal-cfe1e8e9.js');
+const localization = require('./localization-a969f224.js');
 const zonosStore = require('./zonosStore-45a87908.js');
 const buildCartItemsByTempCart = require('./buildCartItemsByTempCart-edddbf4b.js');
 const handleFetch = require('./handleFetch-954f30e1.js');

package/dist/cjs/zonos-language-select_2.cjs.entry.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-b1f95d96.js');
-const localization = require('./localization-f897bc45.js');
+const localization = require('./localization-a969f224.js');
 const zonosStore = require('./zonosStore-45a87908.js');
 const ILanguage = require('./ILanguage-98b04442.js');
 require('./handleFetch-954f30e1.js');

package/dist/cjs/zonos-policy-consent_2.cjs.entry.js

@@ -3,10 +3,10 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 const index = require('./index-b1f95d96.js');
-const cart = require('./cart-af7c024e.js');
-const localization = require('./localization-f897bc45.js');
+const cart = require('./cart-87fbbb5a.js');
+const localization = require('./localization-a969f224.js');
 const zonosStore = require('./zonosStore-45a87908.js');
-const renderCheckoutCurrency = require('./renderCheckoutCurrency-584d50fe.js');
+const renderCheckoutCurrency = require('./renderCheckoutCurrency-5a333d29.js');
 const getBorderRadius = require('./getBorderRadius-fc683d94.js');
 require('./VarianceTest-bec00ea8.js');
 require('./handleFetch-954f30e1.js');

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

@@ -15,6 +15,7 @@ import { getHelloWidgetSize } from "../../utils/hello/getHelloWidgetSize";
 import { getProductsOnPage } from "../../utils/hello/getProductsOnPage";
 import { getZCountryUrlParam } from "../../utils/hello/getZCountryUrlParam";
 import { setZCountryUrlParam } from "../../utils/hello/setZCountryUrlParam";
+import { shouldShowHelloWidget } from "../../utils/hello/shouldShowHelloWidget";
 import { log } from "../../utils/logging/log";
 import { mergeConfig } from "../../utils/mergeConfig";
 const PEEK_MESSAGE_CLOSE_DELAY_MS = 3000;
@@ -203,49 +204,6 @@ export class ZonosHello {
                 return hasMoreSpaceOnRight;
             }
         };
-        this.shouldRenderHello = (showLog = true) => {
-            var _a, _b;
-            if (!localizationStore.localizationLoaded) {
-                return false;
-            }
-            const { countryDisplayRules, showForCountries } = zonosStore.helloSettings;
-            const visibilityRules = countryDisplayRules === null || countryDisplayRules === void 0 ? void 0 : countryDisplayRules.widgetVisibility;
-            const selectedCountry = localizationStore.selectedCountryCode;
-            // Resolve behavior: deprecated showForCountries overrides widgetVisibility.behavior
-            // If showForCountries is an array of country codes, treat as legacy explicit list
-            const behavior = Array.isArray(showForCountries)
-                ? showForCountries
-                : (showForCountries !== null && showForCountries !== void 0 ? showForCountries : visibilityRules === null || visibilityRules === void 0 ? void 0 : visibilityRules.behavior);
-            if (showLog && !localizationStore.isShippableCountry) {
-                log(`Hello: not shippable country - Show for countries: ${behavior}`);
-            }
-            // Legacy: explicit list of country codes from deprecated showForCountries
-            if (Array.isArray(behavior)) {
-                return !!selectedCountry && behavior.includes(selectedCountry);
-            }
-            // Determine base visibility from behavior
-            let isVisible;
-            if (behavior === 'ALL') {
-                isVisible = true;
-            }
-            else {
-                // Default: ONLY_SHIPPABLE
-                isVisible = localizationStore.isShippableCountry;
-            }
-            // Apply includedCountries — force show the widget for these countries
-            if (!isVisible &&
-                selectedCountry &&
-                ((_a = visibilityRules === null || visibilityRules === void 0 ? void 0 : visibilityRules.includedCountries) === null || _a === void 0 ? void 0 : _a.includes(selectedCountry))) {
-                isVisible = true;
-            }
-            // Apply excludedCountries — force hide the widget for these countries
-            if (isVisible &&
-                selectedCountry &&
-                ((_b = visibilityRules === null || visibilityRules === void 0 ? void 0 : visibilityRules.excludedCountries) === null || _b === void 0 ? void 0 : _b.includes(selectedCountry))) {
-                isVisible = false;
-            }
-            return isVisible;
-        };
     }
     showDialogHandler(showDialog) {
         var _a;
@@ -421,7 +379,7 @@ export class ZonosHello {
         // The  organization name can be changed after init with the updateOrganizationName method.
         // This will cause the element to rerender with the new org name when it changes. (used for preview on dashboard)
         this.peekMessage = this.getHelloPeekMessage(zonosStore.organizationName);
-        const showHello = this.shouldRenderHello() && !!selectedCountryCode;
+        const showHello = shouldShowHelloWidget() && !!selectedCountryCode;
         // If the condition for rendering Hello is met, set the toggle to true to trigger callback, should only trigger once
         if (showHello && !this.isHelloWidgetRendered) {
             this.handleHelloWidgetInitializedState({

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

@@ -9,6 +9,7 @@ import { getInclusivePriceConfigurations } from "../../utils/api/getInclusivePri
 import { getLocaleMessages } from "../../utils/api/getLocaleMessages";
 import { getLocalization } from "../../utils/api/getLocalization";
 import { getShippingZones } from "../../utils/api/getShippingZones";
+import { removeBigcommerceCartShipping } from "../../utils/checkout/removeBigcommerceCartShipping";
 import { handleFetch } from "../../utils/handleFetch";
 import { currencyDisplay } from "../../utils/hello/currencyConversion/currencyDisplay";
 import { getCurrencyCode } from "../../utils/hello/currencyConversion/getCurrencyCode";
@@ -183,6 +184,11 @@ const localizationStoreUpdateSelectedCountryCode = ({ isInitializing, newSelecte
     // because `currencyDisplay` is also invoked from the price-mutation
     // observer in `zonos-hello.tsx`, which fires on every DOM render.
     toggleBigcommerceNativeCurrencySelector();
+    // On the BigCommerce cart page, drop any native domestic shipping quote the
+    // shopper added before switching to an international country so the Grand
+    // Total reflects only subtotal + coupon. No-ops off-cart, off-BigCommerce,
+    // for non-shippable countries, or when the cart has no consignment.
+    void removeBigcommerceCartShipping();
     if (!selectedCountryCode) {
         return;
     }
@@ -360,6 +366,11 @@ const initLocalizationStore = async () => {
             newSelectedCountryCode: 'CA',
         });
     }
-    localizationStore.localizationLoaded = true;
+    if (!localizationStore.localizationLoaded) {
+        localizationStore.localizationLoaded = true;
+        void removeBigcommerceCartShipping();
+        // shouldShowHelloWidget is false because localization is not loaded yet
+        void toggleBigcommerceNativeCurrencySelector();
+    }
 };
 export { initLocalizationStore, localizationDispose, localizationStore, localizationStoreOnChange, localizationStoreUpdateSelectedCountryCode, localizationStoreUpdateSelectedLocale, };

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

@@ -50,6 +50,34 @@ export const fetchBigCommerceCheckout = async (checkoutId) => {
         return null;
     }
 };
+/**
+ * Delete a consignment (a saved shipping selection, e.g. a domestic shipping
+ * quote the shopper added on the cart page) from the active BigCommerce
+ * checkout via the Storefront API. Cookie-authenticated (same-origin), so no
+ * token is needed. Returns the updated checkout on success, or null on
+ * failure.
+ */
+export const deleteBigCommerceConsignment = async (checkoutId, consignmentId) => {
+    try {
+        const response = await fetch(`/api/storefront/checkouts/${checkoutId}/consignments/${consignmentId}`, {
+            credentials: 'same-origin',
+            headers: {
+                Accept: 'application/json',
+                'Content-Type': 'application/json',
+            },
+            method: 'DELETE',
+        });
+        if (!response.ok) {
+            log(`Failed to delete BigCommerce consignment: ${String(response.status)}`, 'error');
+            return null;
+        }
+        return (await response.json());
+    }
+    catch (error) {
+        logError('Error deleting BigCommerce consignment', error);
+        return null;
+    }
+};
 /**
  * Whether the BigCommerce shopper is already logged in. We key off the
  * customer's numeric `id` since the storefront API populates it only for

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

@@ -0,0 +1,83 @@
+import { localizationStore } from "../../store/hello/localization";
+import { deleteBigCommerceConsignment, fetchBigCommerceCheckout, fetchCheckoutId, } from "./bigcommerceStorefrontApi";
+import { shouldShowHelloWidget } from "../hello/shouldShowHelloWidget";
+import { log } from "../logging/log";
+import { logError } from "../logging/logError";
+/**
+ * Guard against overlapping passes. `removeBigcommerceCartShipping` is fired on
+ * every country change; without this flag, rapid country switches could stack
+ * concurrent fetch/DELETE cycles against the same cart before the reload kicks
+ * in.
+ */
+let isRemoving = false;
+/**
+ * On the BigCommerce cart page, drop any native domestic shipping quote the
+ * shopper added before they switched to an international country, then reload
+ * the page.
+ *
+ * The native cart stores a shipping estimate as a consignment on the active
+ * checkout. When Hello is shown the shopper is checking out internationally
+ * through Zonos, so that domestic shipping cost should not linger in the Grand
+ * Total. We delete the consignment(s) and reload so the server re-renders the
+ * cart consistently (subtotal, shipping, and Grand Total all add up).
+ *
+ * No-ops unless all of the following hold: the host is BigCommerce, the shopper
+ * is on the cart page, they are in a shipping zone with Hello shown, and the
+ * active checkout actually has a consignment. Because the reload happens only
+ * when a consignment is found and removed, the freshly-loaded page has none —
+ * so this cannot loop.
+ */
+export const removeBigcommerceCartShipping = async () => {
+    var _a, _b;
+    if (typeof window === 'undefined' || !((_a = window.Zonos) === null || _a === void 0 ? void 0 : _a.isBigCommerce)) {
+        return;
+    }
+    // Only on the cart page and only when Hello is shown — elsewhere there is no
+    // Grand Total to correct. Gate on Hello visibility (not raw shipping-zone
+    // membership) so include/exclude country overrides are respected.
+    if (window.location.pathname !== '/cart.php' ||
+        !localizationStore.isShippableCountry ||
+        !shouldShowHelloWidget(false)) {
+        return;
+    }
+    if (isRemoving) {
+        return;
+    }
+    isRemoving = true;
+    try {
+        const checkoutId = await fetchCheckoutId();
+        if (!checkoutId) {
+            return;
+        }
+        const checkout = await fetchBigCommerceCheckout(checkoutId);
+        const consignmentIds = ((_b = checkout === null || checkout === void 0 ? void 0 : checkout.consignments) !== null && _b !== void 0 ? _b : [])
+            .map(consignment => consignment.id)
+            .filter((id) => !!id);
+        // Nothing to do if there is no domestic shipping quote on the cart.
+        if (!consignmentIds.length) {
+            return;
+        }
+        log(`Removing ${String(consignmentIds.length)} BigCommerce cart consignment(s) for international shopper`, 'info');
+        // `deleteBigCommerceConsignment` resolves to null on failure (it swallows
+        // the error and logs it), so a non-null result means that consignment was
+        // actually removed.
+        const deleteResults = await Promise.all(consignmentIds.map(consignmentId => deleteBigCommerceConsignment(checkoutId, consignmentId)));
+        const removedCount = deleteResults.filter(Boolean).length;
+        // Only reload when at least one consignment was actually removed. If every
+        // DELETE failed, reloading would re-run this on init with the same
+        // consignments still present and trap the shopper in a reload loop.
+        if (!removedCount) {
+            log('No BigCommerce cart consignments were removed; skipping reload to avoid a reload loop', 'warn');
+            return;
+        }
+        // Reload so the server re-renders the cart consistently without the removed
+        // shipping, instead of surgically patching the DOM total.
+        window.location.reload();
+    }
+    catch (error) {
+        logError('Error removing BigCommerce cart shipping consignment', error);
+    }
+    finally {
+        isRemoving = false;
+    }
+};

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

@@ -0,0 +1,61 @@
+import { localizationStore } from "../../store/hello/localization";
+import { zonosStore } from "../../store/zonosStore";
+import { log } from "../logging/log";
+/**
+ * Whether the Hello widget should be shown for the current shopper. This is the
+ * single source of truth for Hello's visibility decision — the `zonos-hello`
+ * component renders by it, and other features (e.g. BigCommerce cart shipping
+ * cleanup) gate on it so their behavior stays in lockstep with what the shopper
+ * actually sees.
+ *
+ * Resolves the configured `widgetVisibility` behavior (with the deprecated
+ * `showForCountries` override) against the selected country and shipping-zone
+ * state, then applies the include/exclude country overrides.
+ *
+ * @param showLog - emit a debug log when the shopper is not in a shipping zone.
+ * Defaults to `true`; pass `false` from non-rendering callers to avoid log
+ * noise.
+ */
+export const shouldShowHelloWidget = (showLog = true) => {
+    var _a, _b;
+    if (!localizationStore.localizationLoaded) {
+        return false;
+    }
+    const { countryDisplayRules, showForCountries } = zonosStore.helloSettings;
+    const visibilityRules = countryDisplayRules === null || countryDisplayRules === void 0 ? void 0 : countryDisplayRules.widgetVisibility;
+    const selectedCountry = localizationStore.selectedCountryCode;
+    // Resolve behavior: deprecated showForCountries overrides widgetVisibility.behavior
+    // If showForCountries is an array of country codes, treat as legacy explicit list
+    const behavior = Array.isArray(showForCountries)
+        ? showForCountries
+        : (showForCountries !== null && showForCountries !== void 0 ? showForCountries : visibilityRules === null || visibilityRules === void 0 ? void 0 : visibilityRules.behavior);
+    if (showLog && !localizationStore.isShippableCountry) {
+        log(`Hello: not shippable country - Show for countries: ${behavior}`);
+    }
+    // Legacy: explicit list of country codes from deprecated showForCountries
+    if (Array.isArray(behavior)) {
+        return !!selectedCountry && behavior.includes(selectedCountry);
+    }
+    // Determine base visibility from behavior
+    let isVisible;
+    if (behavior === 'ALL') {
+        isVisible = true;
+    }
+    else {
+        // Default: ONLY_SHIPPABLE
+        isVisible = localizationStore.isShippableCountry;
+    }
+    // Apply includedCountries — force show the widget for these countries
+    if (!isVisible &&
+        selectedCountry &&
+        ((_a = visibilityRules === null || visibilityRules === void 0 ? void 0 : visibilityRules.includedCountries) === null || _a === void 0 ? void 0 : _a.includes(selectedCountry))) {
+        isVisible = true;
+    }
+    // Apply excludedCountries — force hide the widget for these countries
+    if (isVisible &&
+        selectedCountry &&
+        ((_b = visibilityRules === null || visibilityRules === void 0 ? void 0 : visibilityRules.excludedCountries) === null || _b === void 0 ? void 0 : _b.includes(selectedCountry))) {
+        isVisible = false;
+    }
+    return isVisible;
+};

package/dist/collection/utils/toggleBigcommerceNativeCurrencySelector.js

@@ -1,5 +1,6 @@
 import { localizationStore } from "../components/store/hello/localization";
 import { zonosStore } from "../components/store/zonosStore";
+import { shouldShowHelloWidget } from "../components/utils/hello/shouldShowHelloWidget";
 import { logError } from "../components/utils/logging/logError";
 const HIDE_CLASSNAME = 'z--bc-currency-hide';
 /**
@@ -28,7 +29,7 @@ export const toggleBigcommerceNativeCurrencySelector = () => {
         return;
     }
     const bigcommerceCurrencyCode = document.body.dataset.currencyCode;
-    const shouldHide = localizationStore.isShippableCountry &&
+    const shouldHide = (shouldShowHelloWidget(false) || localizationStore.isShippableCountry) &&
         !!bigcommerceCurrencyCode &&
         bigcommerceCurrencyCode === zonosStore.sourceCurrency;
     try {

package/dist/esm/{cart-68c16805.js → cart-663ef7d5.js}

@@ -1,5 +1,5 @@
 import { c as createStore, z as zonosStore } from './zonosStore-8e19daff.js';
-import { s as storageStore, t as translate, l as localizationStore, e as getOverridenZCountry, f as filterValidTests, b as storageStoreSetEnabledVariantTestKeys } from './localization-8e81b696.js';
+import { s as storageStore, t as translate, l as localizationStore, j as getOverridenZCountry, f as filterValidTests, d as storageStoreSetEnabledVariantTestKeys } from './localization-dc19e8bb.js';
 import { l as log, b as allLogs } from './VarianceTest-572cecf5.js';
 import { h as handleFetch, l as logError, f as fallbackApiList, g as getIsTestMode, a as getIsStagingMode, s as sendErrorLog, j as jsonParse } from './handleFetch-a844cac1.js';
 import { i as isDarkColor } from './isDarkColor-566f04c5.js';

package/dist/esm/{hasInclusivePrice-f1ca1610.js → hasInclusivePrice-f8bd057d.js}

@@ -1,4 +1,4 @@
-import { l as localizationStore } from './localization-8e81b696.js';
+import { l as localizationStore } from './localization-dc19e8bb.js';
 
 /**
  * Since the backend and the frontend are using the same keys,

package/dist/esm/index.js

@@ -131,7 +131,7 @@ const getZonosQaUrl = () => {
         return null;
     }
     const qaUrl = extractZonosQaUrl(window.location.href);
-    const cdnUrl = "https://v1.3.268.js.zonos.com";
+    const cdnUrl = "https://v1.3.269.js.zonos.com";
     // when the qaUrl is not set and the built URL is from the test domain, use the test domain for testing
     if (!qaUrl &&
         (cdnUrl.includes('test.') ||
@@ -379,10 +379,10 @@ const zonosLoadUrl = (() => {
     return null;
 })();
 const startLoadTime = Date.now();
-const ZONOS_URL = "https://v1.3.268.js.zonos.com";
-const JS_DELIVR_ZONOS_URL = zonosLoadUrl || "https://cdn.jsdelivr.net/npm/@zonos/elements@1.3.268";
-const UNPKG_ZONOS_URL = "https://unpkg.com/@zonos/elements@1.3.268";
-const CDNJS_ZONOS_URL = "https://cdnjs.cloudflare.com/ajax/libs/zonos-elements/1.3.268";
+const ZONOS_URL = "https://v1.3.269.js.zonos.com";
+const JS_DELIVR_ZONOS_URL = zonosLoadUrl || "https://cdn.jsdelivr.net/npm/@zonos/elements@1.3.269";
+const UNPKG_ZONOS_URL = "https://unpkg.com/@zonos/elements@1.3.269";
+const CDNJS_ZONOS_URL = "https://cdnjs.cloudflare.com/ajax/libs/zonos-elements/1.3.269";
 const GOOGLE_FONT_URL = 'https://fonts.googleapis.com';
 const GOOGLE_FONT_REGEX = /^https:\/\/fonts\.googleapis\.com/;
 class Zonos {
@@ -400,7 +400,7 @@ Zonos.iframeLogType = typeof window !== 'undefined'
     ? new URLSearchParams(window.location.search).get('iframeLogType')
     : null;
 Zonos.isBigCommerce = false;
-Zonos.releaseDate = "1780932937557";
+Zonos.releaseDate = "1781282532525";
 Zonos.isLegacyCheckout = false;
 Zonos.googleAnalyticId = null;
 Zonos.googleAnalyticReady = false;
@@ -425,7 +425,7 @@ Zonos.isNpm = true;
 Zonos.zonosQaUrl = null;
 Zonos.zonosQaUrlApi = null;
 Zonos.trackEventLogs = [];
-Zonos.version = `v${"1.3.268"}`;
+Zonos.version = `v${"1.3.269"}`;
 Zonos.modeAlerted = false;
 Zonos.cartData = null;
 Zonos.paypal = null;

package/dist/esm/{invoice-d0eadc6a.js → invoice-db7211a6.js}

@@ -1,6 +1,6 @@
 import { c as createStore, z as zonosStore } from './zonosStore-8e19daff.js';
-import { b as stripeStore, K as stripeStoreBuildAddressForPartyCreate, d as cartStore, L as cartStoreUpdateSelectedShippingOption } from './cart-68c16805.js';
-import { s as storageStore } from './localization-8e81b696.js';
+import { b as stripeStore, K as stripeStoreBuildAddressForPartyCreate, d as cartStore, L as cartStoreUpdateSelectedShippingOption } from './cart-663ef7d5.js';
+import { s as storageStore } from './localization-dc19e8bb.js';
 import { h as handleFetch, s as sendErrorLog, l as logError } from './handleFetch-a844cac1.js';
 import { b as allLogs } from './VarianceTest-572cecf5.js';
 

package/dist/esm/{isCollectMobileTablet-11ade63f.js → isCollectMobileTablet-24c912b1.js}

@@ -1,6 +1,6 @@
 import { c as createStore, z as zonosStore } from './zonosStore-8e19daff.js';
-import { b as stripeStore, K as stripeStoreBuildAddressForPartyCreate, d as cartStore, L as cartStoreUpdateSelectedShippingOption } from './cart-68c16805.js';
-import { s as storageStore } from './localization-8e81b696.js';
+import { b as stripeStore, K as stripeStoreBuildAddressForPartyCreate, d as cartStore, L as cartStoreUpdateSelectedShippingOption } from './cart-663ef7d5.js';
+import { s as storageStore } from './localization-dc19e8bb.js';
 import { h as handleFetch, s as sendErrorLog, l as logError } from './handleFetch-a844cac1.js';
 import { b as allLogs } from './VarianceTest-572cecf5.js';