@lime-bundles/widget 4.1.1 → 4.3.0

package/dist/index.js

@@ -5,6 +5,8 @@ import {
   BUNDLES_FOR_PRODUCT_QUERY,
   CART_CREATE_MUTATION,
   CART_LINES_ADD_MUTATION,
+  CART_LINES_QUERY,
+  CART_LINES_REMOVE_MUTATION,
   SHOP_SETTINGS_QUERY,
   parseMetaobjectBundle,
   observeImpression,
@@ -15,17 +17,38 @@ import {
   hasInContext,
   withInContext,
   isVisibleInMarket,
-  parseOutOfStockBehavior,
-  DEFAULT_OUT_OF_STOCK_BEHAVIOR,
   getVisitorId,
   resolveAbTests
 } from "@lime-bundles/core";
 
+// ../render/src/host.ts
+function intlFormatMoney(currencyCode) {
+  return (cents) => {
+    try {
+      return new Intl.NumberFormat(void 0, {
+        style: "currency",
+        currency: currencyCode
+      }).format(cents / 100);
+    } catch {
+      return currencyCode + " " + (cents / 100).toFixed(2);
+    }
+  };
+}
+var BUNDLE_GID_ATTRIBUTE = "_lime_bundle_gid";
+var BUNDLE_TYPE_ATTRIBUTE = "_lime_bundle_type";
+function bundleLineAttributes(bundleGid, bundleType) {
+  return [
+    { key: BUNDLE_GID_ATTRIBUTE, value: bundleGid },
+    { key: BUNDLE_TYPE_ATTRIBUTE, value: bundleType }
+  ];
+}
+
 // ../render/src/adapt.ts
 import {
   formatUnitPrice,
   isVariantFulfillable,
-  resolveBundleQty
+  resolveBundleQty,
+  stockCapForVariant
 } from "@lime-bundles/core";
 function numericId(gid) {
   const tail = gid.slice(gid.lastIndexOf("/") + 1);
@@ -49,7 +72,10 @@ function adaptVariant(v, requiredQty, fallbackCurrency) {
     price: toCents(v.price?.amount),
     compareAtPrice: toCents(v.compareAtPrice?.amount),
     unitPrice: formatUnitPrice(v.unitPrice, v.unitPriceMeasurement, fallbackCurrency),
-    image: v.image?.url ?? null
+    image: v.image?.url ?? null,
+    // Carried so the picker's stepper cap and cross-slot stock guard can
+    // bind on the headless surface; dropping it here left them capless.
+    inventoryQuantity: stockCapForVariant(v)
   };
 }
 function adaptProduct(product, bundleId, opts) {
@@ -104,6 +130,14 @@ function findVariant(product, variantId) {
   }
   return product.variants[0];
 }
+function resolveSellableVariant(product) {
+  const seeded = findVariant(product, product.selectedVariantId);
+  if (seeded && seeded.available !== false) return seeded;
+  for (let i = 0; i < product.variants.length; i++) {
+    if (product.variants[i].available !== false) return product.variants[i];
+  }
+  return null;
+}
 function findVariantByOptions(product, optionValues) {
   if (!product.variants || !optionValues) return null;
   for (let i = 0; i < product.variants.length; i++) {
@@ -216,28 +250,6 @@ function recalcPricing(container, products, formatMoney) {
   }
 }
 
-// ../render/src/host.ts
-function intlFormatMoney(currencyCode) {
-  return (cents) => {
-    try {
-      return new Intl.NumberFormat(void 0, {
-        style: "currency",
-        currency: currencyCode
-      }).format(cents / 100);
-    } catch {
-      return currencyCode + " " + (cents / 100).toFixed(2);
-    }
-  };
-}
-var BUNDLE_GID_ATTRIBUTE = "_lime_bundle_gid";
-var BUNDLE_TYPE_ATTRIBUTE = "_lime_bundle_type";
-function bundleLineAttributes(bundleGid, bundleType) {
-  return [
-    { key: BUNDLE_GID_ATTRIBUTE, value: bundleGid },
-    { key: BUNDLE_TYPE_ATTRIBUTE, value: bundleType }
-  ];
-}
-
 // ../render/src/product/option-selects.ts
 function bindVariantSelects(row, getProduct, onSelected) {
   const optionSelects = row.querySelectorAll("[data-variant-option]");
@@ -1174,12 +1186,11 @@ function bindDropdowns(root) {
 }
 
 // src/renderers/fixed.ts
-function renderFixedBundle(container, bundle, outOfStockBehavior, onAddToCart, onCleanup) {
+function renderFixedBundle(container, bundle, onAddToCart, onCleanup) {
   const wc = bundle.widgetConfig;
   const products = adaptProducts(bundle);
   if (!products.length) return;
   const oosProducts = products.filter((p) => !p.variants.some((v) => v.available));
-  if (outOfStockBehavior === "hide" && oosProducts.length > 0) return;
   const currency = bundle.products[0]?.priceRange.minVariantPrice.currencyCode ?? "USD";
   const formatMoney = intlFormatMoney(currency);
   const t = DEFAULT_STRINGS;
@@ -1204,7 +1215,9 @@ function renderFixedBundle(container, bundle, outOfStockBehavior, onAddToCart, o
     });
     shell.products.appendChild(row);
     if (isOos) continue;
-    const selected = findVariant(product, product.selectedVariantId);
+    const sellable = resolveSellableVariant(product);
+    if (sellable) product.selectedVariantId = sellable.id;
+    const selected = sellable ?? findVariant(product, product.selectedVariantId);
     hydrateRowControls(row, product, selected);
     applyVariant(row, selected, product, formatMoney);
     bindVariantSelects(
@@ -1799,6 +1812,17 @@ function unlock() {
   window.scrollTo(0, savedY);
 }
 
+// ../render/src/picker/sort.ts
+function sinkAddedRows(list, rowEls, isAdded) {
+  const front = [];
+  const back = [];
+  for (let i = 0; i < rowEls.length; i++) {
+    (isAdded(i) ? back : front).push(rowEls[i]);
+  }
+  for (const el2 of front) list.appendChild(el2);
+  for (const el2 of back) list.appendChild(el2);
+}
+
 // ../render/src/mix-match/modal.ts
 var ALL_TYPES = "__all__";
 var CLOSE_TRANSITION_MS = 300;
@@ -2023,12 +2047,22 @@ function createPickerModal(deps) {
     syncActiveFilterPill();
     if (searchInput) searchInput.value = "";
     filterProducts(searchInput ? searchInput.value : "");
+    if (modalList) {
+      const selectedProductIds = /* @__PURE__ */ Object.create(null);
+      for (const it of items) selectedProductIds[String(it.productId)] = true;
+      sinkAddedRows(
+        modalList,
+        rows.map((r) => r.el),
+        (i) => selectedProductIds[String(eligibleProducts[i].id)] === true
+      );
+      modalList.scrollTop = 0;
+    }
     overlay.style.display = "";
     void overlay.offsetHeight;
     overlay.classList.add("lb-mix-match__modal-overlay--open");
     lock();
     setTimeout(() => {
-      if (searchInput) searchInput.focus();
+      if (closeBtn) closeBtn.focus();
       else modalDialog?.focus();
     }, 50);
   }
@@ -2585,7 +2619,7 @@ function buildPickerModal(opts) {
 }
 
 // src/renderers/mix-match.ts
-function renderMixMatchBundle(container, bundle, outOfStockBehavior, onAddToCart, onCleanup, currentProductHandle) {
+function renderMixMatchBundle(container, bundle, onAddToCart, onCleanup, currentProductHandle) {
   const wc = bundle.widgetConfig;
   const t = DEFAULT_STRINGS;
   const requiredQty = bundle.minQuantity || 1;
@@ -2608,12 +2642,12 @@ function renderMixMatchBundle(container, bundle, outOfStockBehavior, onAddToCart
       compareAtPrice: v.compareAtPrice,
       unitPrice: v.unitPrice,
       image: v.image,
-      inventoryQuantity: null
+      inventoryQuantity: v.inventoryQuantity ?? null
     }))
   }));
   if (!eligibleProducts.length) return;
   const poolUnits = eligibleProducts.filter((p) => p.available).length;
-  if (outOfStockBehavior === "hide" && poolUnits === 0) return;
+  if (poolUnits === 0) return;
   const formatMoney = intlFormatMoney(
     bundle.products[0]?.priceRange.minVariantPrice.currencyCode ?? "USD"
   );
@@ -2776,10 +2810,51 @@ function renderMixMatchBundle(container, bundle, outOfStockBehavior, onAddToCart
 // src/renderers/volume.ts
 import {
   bestValueTierIndex,
+  isVariantFulfillable as isVariantFulfillable2,
+  resolveContextProduct,
   resolveDefaultTierIndex,
-  resolvePopularTierIndex
+  resolvePopularTierIndex,
+  stockCapForVariant as stockCapForVariant2
 } from "@lime-bundles/core";
 
+// ../render/src/volume/stock.ts
+var TIER_OOS_CLASS = "lb-volume__tier--oos";
+function tierQty(el2) {
+  return parseInt(el2.getAttribute("data-tier-qty") ?? "", 10) || 0;
+}
+function tierUnavailable(el2) {
+  return el2.getAttribute("aria-disabled") === "true";
+}
+function applyTierStockState(tierEls, cap) {
+  for (let i = 0; i < tierEls.length; i++) {
+    const el2 = tierEls[i];
+    const unavailable = cap !== null && tierQty(el2) > cap;
+    if (unavailable) {
+      el2.classList.add(TIER_OOS_CLASS);
+      el2.setAttribute("aria-disabled", "true");
+    } else {
+      el2.classList.remove(TIER_OOS_CLASS);
+      el2.removeAttribute("aria-disabled");
+    }
+  }
+}
+function resolveAvailableTierIndex(tierEls, preferred) {
+  const p = tierEls[preferred];
+  if (p && !tierUnavailable(p)) return preferred;
+  for (let i = 0; i < tierEls.length; i++) {
+    if (!tierUnavailable(tierEls[i])) return i;
+  }
+  return -1;
+}
+function stepToAvailableTier(tierEls, from, direction) {
+  let i = from + direction;
+  while (i >= 0 && i < tierEls.length) {
+    if (!tierUnavailable(tierEls[i])) return i;
+    i += direction;
+  }
+  return from;
+}
+
 // ../render/src/volume/pricing.ts
 function calcTierPrice(basePrice, discountType, tierEl) {
   if (discountType === "fixed_amount") {
@@ -2869,15 +2944,16 @@ function selectTier(container, allTiers, basePrice, discountType, index, transla
 }
 
 // src/renderers/volume.ts
-function renderVolumeBundle(container, bundle, outOfStockBehavior, onAddToCart) {
+function renderVolumeBundle(container, bundle, onAddToCart, productContext) {
   const wc = bundle.widgetConfig;
-  const product = bundle.products[0];
+  const product = resolveContextProduct(bundle.products, productContext);
   if (!product) return;
   const variants = product.variants.nodes;
-  const pricingVariant = variants.find((v) => v.availableForSale) ?? variants[0];
+  const minTierQty = Math.min(
+    ...bundle.volumeTiers.map((tier) => tier.minQuantity)
+  );
+  const pricingVariant = variants.find((v) => isVariantFulfillable2(v, minTierQty)) ?? variants.find((v) => v.availableForSale) ?? variants[0];
   if (!pricingVariant) return;
-  const anyAvailable = variants.some((v) => v.availableForSale);
-  if (outOfStockBehavior === "hide" && !anyAvailable) return;
   const basePrice = toCents(pricingVariant.price.amount);
   const discountType = bundle.discountConfig.discountType;
   const formatMoney = intlFormatMoney(product.priceRange.minVariantPrice.currencyCode);
@@ -2928,28 +3004,31 @@ function renderVolumeBundle(container, bundle, outOfStockBehavior, onAddToCart)
   shell.products.replaceWith(group);
   const tierEls = group.querySelectorAll("[data-tier-index]");
   updateAllTierPrices(tierEls, basePrice, discountType, formatMoney);
-  let selectedIndex = defaultIdx;
+  applyTierStockState(tierEls, stockCapForVariant2(pricingVariant));
+  let selectedIndex = resolveAvailableTierIndex(tierEls, defaultIdx);
+  const noTierAvailable = selectedIndex === -1;
+  if (noTierAvailable) selectedIndex = defaultIdx;
   const apply = () => selectTier(shell.root, tierEls, basePrice, discountType, selectedIndex, t, formatMoney);
   group.addEventListener("click", (e) => {
     const el2 = e.target.closest("[data-tier-index]");
-    if (!el2) return;
+    if (!el2 || tierUnavailable(el2)) return;
     selectedIndex = parseInt(el2.getAttribute("data-tier-index") ?? "", 10) || 0;
     apply();
   });
   group.addEventListener("keydown", (e) => {
     if (e.key === "ArrowDown" || e.key === "ArrowRight") {
       e.preventDefault();
-      selectedIndex = Math.min(selectedIndex + 1, tierEls.length - 1);
+      selectedIndex = stepToAvailableTier(tierEls, selectedIndex, 1);
       apply();
       tierEls[selectedIndex].focus();
     } else if (e.key === "ArrowUp" || e.key === "ArrowLeft") {
       e.preventDefault();
-      selectedIndex = Math.max(selectedIndex - 1, 0);
+      selectedIndex = stepToAvailableTier(tierEls, selectedIndex, -1);
       apply();
       tierEls[selectedIndex].focus();
     }
   });
-  if (!anyAvailable) {
+  if (noTierAvailable) {
     shell.cta.disabled = true;
     const label = shell.cta.querySelector("[data-cta-label]");
     if (label) label.textContent = t.outOfStock || "Out of stock";
@@ -3084,7 +3163,7 @@ function buildBogoPlus() {
   plus.innerHTML = '<svg width="12" height="12" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true"><line x1="9" y1="3" x2="9" y2="15" stroke="currentColor" stroke-width="2" stroke-linecap="round"/><line x1="3" y1="9" x2="15" y2="9" stroke="currentColor" stroke-width="2" stroke-linecap="round"/></svg>';
   return plus;
 }
-function renderBogoBundle(container, bundle, outOfStockBehavior, onAddToCart, onCleanup) {
+function renderBogoBundle(container, bundle, onAddToCart, onCleanup) {
   const wc = bundle.widgetConfig;
   const buyProduct = bundle.products.find((p) => p.id === bundle.buyProductId);
   const getProduct = bundle.products.find((p) => p.id === bundle.getProductId);
@@ -3113,7 +3192,6 @@ function renderBogoBundle(container, bundle, outOfStockBehavior, onAddToCart, on
     }
   ];
   const oosCount = sides.filter((s) => !s.variants.some((v) => v.available)).length;
-  if (outOfStockBehavior === "hide" && oosCount > 0) return;
   const formatMoney = intlFormatMoney(
     buyProduct.priceRange.minVariantPrice.currencyCode
   );
@@ -3549,6 +3627,14 @@ function createWizard(deps) {
       rows.push(row);
       modalList.appendChild(row.el);
     }
+    const stepPicks = selections[forStep] || [];
+    const selectedProductIds = /* @__PURE__ */ Object.create(null);
+    for (const it of stepPicks) selectedProductIds[String(it.productId)] = true;
+    sinkAddedRows(
+      modalList,
+      rows.map((r) => r.el),
+      (i) => selectedProductIds[String(pool[i].id)] === true
+    );
     deps.dropdown?.bindAll(modalList);
   }
   function onListClick(e) {
@@ -3711,6 +3797,7 @@ function createWizard(deps) {
     syncActiveFilterPill();
     if (searchInput) searchInput.value = "";
     filterProducts("");
+    if (modalList) modalList.scrollTop = 0;
     buildStepSegments(stepIndex);
     refresh();
     if (modalLive) {
@@ -3734,7 +3821,7 @@ function createWizard(deps) {
     overlay.classList.add("lb-mix-match__modal-overlay--open");
     lock();
     setTimeout(() => {
-      if (searchInput) searchInput.focus();
+      if (closeBtn) closeBtn.focus();
       else modalDialog?.focus();
     }, 50);
   }
@@ -3802,7 +3889,7 @@ function createWizard(deps) {
 }
 
 // src/renderers/multi-step.ts
-function renderMultiStepBundle(container, bundle, outOfStockBehavior, onAddToCart, onCleanup) {
+function renderMultiStepBundle(container, bundle, onAddToCart, onCleanup) {
   const wc = bundle.widgetConfig;
   const t = DEFAULT_STRINGS;
   const rulesMap = mergeRuleMaps(bundle.productRules, bundle.variantRules);
@@ -3835,13 +3922,13 @@ function renderMultiStepBundle(container, bundle, outOfStockBehavior, onAddToCar
           compareAtPrice: v.compareAtPrice,
           unitPrice: v.unitPrice,
           image: v.image,
-          inventoryQuantity: null
+          inventoryQuantity: v.inventoryQuantity ?? null
         }))
       };
     })
   );
-  const anyPickable = pools.some((pool) => pool.some((p) => p.available));
-  if (outOfStockBehavior === "hide" && !anyPickable) return;
+  const everyStepPickable = pools.length > 0 && pools.every((pool) => pool.some((p) => p.available));
+  if (!everyStepPickable) return;
   const formatMoney = intlFormatMoney(
     bundle.products[0]?.priceRange.minVariantPrice.currencyCode ?? "USD"
   );
@@ -5653,7 +5740,7 @@ var BUNDLE_MIX_MATCH_CSS = `/* Lime Bundles \u2014 Mix & Match styles */
   transition: opacity 0.25s ease, background 0.25s ease, color 0.25s ease, border-color 0.25s ease;
 }
 
-.lb-mix-match__modal-add:hover {
+.lb-mix-match__modal-add:hover:not(:disabled) {
   opacity: 0.9;
 }
 
@@ -5768,8 +5855,15 @@ var BUNDLE_MIX_MATCH_CSS = `/* Lime Bundles \u2014 Mix & Match styles */
   color: color-mix(in srgb, var(--lb-picker-text) 70%, transparent);
 }
 
-/* "Done" reuses the picker Add-button styling so it matches the Add buttons. */
+/* "Done" reuses the picker Add-button styling so it matches the Add buttons.
+   The flex centring + min-height pin the footer-button silhouette: the wizard
+   Back (bundle-multi-step.css) copies these metrics so the pair stays
+   equal-height whatever border widths the merchant's picker tokens set. */
 .lb-mix-match__modal-done {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 40px;
   padding: 10px 24px;
   transition: opacity 0.25s ease;
   background: var(--lb-picker-add-bg);
@@ -5783,7 +5877,7 @@ var BUNDLE_MIX_MATCH_CSS = `/* Lime Bundles \u2014 Mix & Match styles */
   cursor: pointer;
 }
 
-.lb-mix-match__modal-done:hover {
+.lb-mix-match__modal-done:hover:not(:disabled) {
   opacity: 0.9;
 }
 
@@ -5793,6 +5887,16 @@ var BUNDLE_MIX_MATCH_CSS = `/* Lime Bundles \u2014 Mix & Match styles */
   box-shadow: none;
 }
 
+/* Disabled Next/Done (wizard step minimum not met) \u2014 same washed-out
+   treatment as a disabled row Add, so an unfinished step reads at a
+   glance. Hover is gated off above; the solid button returns the moment
+   the requirement is met. */
+.lb-mix-match__modal-done:disabled {
+  background: color-mix(in srgb, var(--lb-picker-add-bg) 35%, var(--lb-picker-bg));
+  color: color-mix(in srgb, var(--lb-picker-add-label) 85%, transparent);
+  cursor: not-allowed;
+}
+
 /* Hidden utility for search filtering */
 .lb-hidden {
   display: none !important;
@@ -6049,6 +6153,13 @@ var BUNDLE_VOLUME_CSS = `/* Lime Bundles \u2014 Volume / Quantity Breaks styles
   white-space: nowrap;
   font-variant-numeric: tabular-nums;
 }
+
+/* Tier the selected variant can't cover \u2014 same greyed treatment as an
+   out-of-stock product row, and not selectable. */
+.lb-volume__tier--oos {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
 `;
 var BUNDLE_BOGO_CSS = `/* Lime Bundles \u2014 BOGO (Buy X Get Y) bundle styles */
 
@@ -6217,14 +6328,23 @@ var BUNDLE_MULTI_STEP_CSS = `/**
   justify-self: end;
 }
 
-/* Back \u2014 secondary treatment beside the primary Next/Done (which reuse
-   .lb-mix-match__modal-done). */
+/* Back \u2014 secondary (outlined) treatment beside the primary Next/Done
+   (which reuse .lb-mix-match__modal-done). Same silhouette as Next \u2014
+   metrics copied from the modal-done recipe (padding, type, radius,
+   min-height) \u2014 and picker tokens only: the modal is portaled out of the
+   widget, so the widget vars (--lb-text, --lb-border-*) it previously
+   used don't reliably resolve here and break palette isolation. */
 .lb-multi-step__modal-back {
-  padding: 10px 16px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 40px;
+  padding: 10px 24px;
   background: none;
-  border: var(--lb-border-width) solid var(--lb-border-color);
-  border-radius: var(--lb-radius-sm);
-  color: var(--lb-text);
+  border: var(--lb-picker-border-width) solid var(--lb-picker-border-color);
+  border-radius: var(--lb-picker-radius-sm);
+  box-sizing: border-box;
+  color: var(--lb-picker-text);
   font-family: inherit;
   font-size: 14px;
   font-weight: 600;
@@ -6233,7 +6353,7 @@ var BUNDLE_MULTI_STEP_CSS = `/**
 }
 
 .lb-multi-step__modal-back:hover {
-  background: color-mix(in srgb, var(--lb-text) 5%, transparent);
+  background: color-mix(in srgb, var(--lb-picker-text) 5%, transparent);
 }
 
 .lb-multi-step__modal-back:focus-visible {
@@ -6625,6 +6745,7 @@ var LimeBundleElement = class extends HTMLElement {
     "storefront-token",
     "bundle-gid",
     "product-handle",
+    "product-id",
     "app-url",
     "analytics",
     "locale",
@@ -6663,12 +6784,6 @@ var LimeBundleElement = class extends HTMLElement {
    * `.lb-bundle-widget { ... }` reach the widget's DOM.
    */
   shopCustomCss = null;
-  /**
-   * Shop-wide out-of-stock behaviour, resolved from the `$app` shop metafield
-   * before the first render. Defaults to `show_greyed_out` so a failed or
-   * missing fetch degrades to "bundles still render".
-   */
-  outOfStockBehavior = DEFAULT_OUT_OF_STOCK_BEHAVIOR;
   constructor() {
     super();
     this.shadow = this.attachShadow({ mode: "open" });
@@ -6691,7 +6806,7 @@ var LimeBundleElement = class extends HTMLElement {
   }
   attributeChangedCallback(name, oldValue, newValue) {
     if (oldValue === newValue || !this.isConnected) return;
-    if (name === "bundle-gid" || name === "product-handle" || name === "shop-domain" || name === "storefront-token") {
+    if (name === "bundle-gid" || name === "product-handle" || name === "product-id" || name === "shop-domain" || name === "storefront-token") {
       if (this.shopDomain && this.storefrontToken) {
         this.fetchBundle();
       }
@@ -6709,6 +6824,16 @@ var LimeBundleElement = class extends HTMLElement {
   get productHandleAttr() {
     return this.getAttribute("product-handle") ?? "";
   }
+  /**
+   * The current product's id — full GID (`gid://shopify/Product/123`) or
+   * bare numeric id. Tells multi-product renderers (volume) which of the
+   * bundle's products this embed is standing on; takes precedence over the
+   * handle cascade. Without it (and with no resolvable handle) they bind to
+   * the bundle's first product.
+   */
+  get productIdAttr() {
+    return this.getAttribute("product-id") ?? "";
+  }
   get appUrl() {
     return this.getAttribute("app-url") ?? "";
   }
@@ -6804,9 +6929,6 @@ var LimeBundleElement = class extends HTMLElement {
         const sanitized = sanitizeCustomCss(customCss);
         if (sanitized.ok) this.shopCustomCss = sanitized.css;
       }
-      this.outOfStockBehavior = parseOutOfStockBehavior(
-        shopSettings?.shop?.outOfStockBehavior?.value
-      );
       this.renderBundles();
     } catch (err) {
       if (controller.signal.aborted) return;
@@ -6885,17 +7007,42 @@ var LimeBundleElement = class extends HTMLElement {
     });
     const storage = window.localStorage;
     const key = cartStorageKey(this.shopDomain);
-    const existingCartId = storage?.getItem(key) ?? null;
+    let cartId = storage?.getItem(key) ?? null;
+    const isStaleCartError = (errors) => errors.length > 0 && errors.every((e) => (e.field ?? []).includes("cartId"));
+    const stockCapped = (warnings) => (warnings ?? []).some((w) => w.code === "MERCHANDISE_NOT_ENOUGH_STOCK");
+    const fail = (message) => {
+      this.dispatchEvent(
+        new CustomEvent("lime-bundle:error", {
+          detail: { message, code: "CART_ERROR" },
+          bubbles: true,
+          composed: true
+        })
+      );
+    };
     try {
       let checkoutUrl = null;
-      if (existingCartId) {
+      if (cartId) {
+        cartId = await this.clearAbandonedBundleLines(
+          client,
+          cartId,
+          () => storage?.removeItem(key)
+        );
+      }
+      if (cartId) {
         const res = await client.query(
           CART_LINES_ADD_MUTATION,
-          { cartId: existingCartId, lines }
+          { cartId, lines }
         );
         const payload = res.cartLinesAdd;
         if (payload?.userErrors?.length) {
+          if (!isStaleCartError(payload.userErrors)) {
+            fail(payload.userErrors[0].message);
+            return;
+          }
           storage?.removeItem(key);
+        } else if (stockCapped(payload?.warnings)) {
+          fail("Some items in this bundle are out of stock.");
+          return;
         } else if (payload?.cart) {
           checkoutUrl = payload.cart.checkoutUrl;
         }
@@ -6906,6 +7053,14 @@ var LimeBundleElement = class extends HTMLElement {
           { input: { lines } }
         );
         const payload = res.cartCreate;
+        if (payload?.userErrors?.length) {
+          fail(payload.userErrors[0].message);
+          return;
+        }
+        if (stockCapped(payload?.warnings)) {
+          fail("Some items in this bundle are out of stock.");
+          return;
+        }
         if (payload?.cart) {
           storage?.setItem(key, payload.cart.id);
           checkoutUrl = payload.cart.checkoutUrl;
@@ -6914,13 +7069,7 @@ var LimeBundleElement = class extends HTMLElement {
       if (checkoutUrl) {
         window.location.assign(checkoutUrl);
       } else {
-        this.dispatchEvent(
-          new CustomEvent("lime-bundle:error", {
-            detail: { message: "Cart creation failed", code: "CART_ERROR" },
-            bubbles: true,
-            composed: true
-          })
-        );
+        fail("Cart creation failed");
       }
     } catch (err) {
       this.dispatchEvent(
@@ -6935,6 +7084,42 @@ var LimeBundleElement = class extends HTMLElement {
       );
     }
   }
+  /**
+   * Remove this widget's own earlier lines — the ones tagged with the
+   * `_lime_bundle_gid` attribute — from the saved cart, so a shopper who
+   * clicked add three times while deciding checks out with only what they
+   * just built. Lines without the tag were put in the cart by something
+   * else (the host site, a previous non-widget purchase flow) and are
+   * left alone.
+   *
+   * Returns the cart id when the cart is still usable. Returns null after
+   * calling `dropSavedCart` when it isn't: either the id no longer
+   * resolves (expired or merged on Shopify's side), or the removal itself
+   * failed — in both cases a fresh cart is the only way to guarantee the
+   * checkout matches the shopper's current build.
+   */
+  async clearAbandonedBundleLines(client, cartId, dropSavedCart) {
+    const res = await client.query(CART_LINES_QUERY, {
+      cartId
+    });
+    if (!res.cart) {
+      dropSavedCart();
+      return null;
+    }
+    const abandonedLineIds = res.cart.lines.nodes.filter(
+      (line) => line.attributes.some((attr) => attr.key === BUNDLE_GID_ATTRIBUTE)
+    ).map((line) => line.id);
+    if (abandonedLineIds.length === 0) return cartId;
+    const removal = await client.query(
+      CART_LINES_REMOVE_MUTATION,
+      { cartId, lineIds: abandonedLineIds }
+    );
+    if (removal.cartLinesRemove?.userErrors?.length) {
+      dropSavedCart();
+      return null;
+    }
+    return cartId;
+  }
   reportAddToCartEvent(bundle, lines) {
     if (!this.analyticsEnabled || !this.appUrl) return;
     const quantity = lines.reduce((sum, l) => sum + l.quantity, 0);
@@ -6994,44 +7179,28 @@ var LimeBundleElement = class extends HTMLElement {
       const registerCleanup = (fn) => this.renderCleanups.push(fn);
       switch (bundle.bundleType) {
         case "fixed":
-          renderFixedBundle(
-            container,
-            bundle,
-            this.outOfStockBehavior,
-            dispatch,
-            registerCleanup
-          );
+          renderFixedBundle(container, bundle, dispatch, registerCleanup);
           break;
         case "mix_match":
           renderMixMatchBundle(
             container,
             bundle,
-            this.outOfStockBehavior,
             dispatch,
             registerCleanup,
             this.currentProductHandle
           );
           break;
         case "volume":
-          renderVolumeBundle(container, bundle, this.outOfStockBehavior, dispatch);
+          renderVolumeBundle(container, bundle, dispatch, {
+            productId: this.productIdAttr || null,
+            productHandle: this.currentProductHandle
+          });
           break;
         case "bogo":
-          renderBogoBundle(
-            container,
-            bundle,
-            this.outOfStockBehavior,
-            dispatch,
-            registerCleanup
-          );
+          renderBogoBundle(container, bundle, dispatch, registerCleanup);
           break;
         case "multi_step":
-          renderMultiStepBundle(
-            container,
-            bundle,
-            this.outOfStockBehavior,
-            dispatch,
-            registerCleanup
-          );
+          renderMultiStepBundle(container, bundle, dispatch, registerCleanup);
           break;
       }
       this.shadow.appendChild(container);