@lime-bundles/widget 4.1.1 → 4.3.0

package/dist/index.d.cts

@@ -26,6 +26,10 @@ import { BuyerResolver } from '@lime-bundles/core';
  *   3. /products/<handle> segment of window.location.pathname
  *   4. fallthrough: renders nothing, fires `lime-bundle:error`
  *
+ * Multi-product renderers (volume) bind to the product this embed is
+ * standing on: the explicit `product-id` attribute wins, then the handle
+ * cascade above, then the bundle's first product when neither names one.
+ *
  * ## Add-to-cart behaviour
  *
  * Merchants who do nothing get a default: the widget calls Shopify's
@@ -82,12 +86,6 @@ declare class LimeBundleElement extends HTMLElement {
      * `.lb-bundle-widget { ... }` reach the widget's DOM.
      */
     private shopCustomCss;
-    /**
-     * 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".
-     */
-    private outOfStockBehavior;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
@@ -98,6 +96,14 @@ declare class LimeBundleElement extends HTMLElement {
     private get storefrontToken();
     private get bundleGid();
     private get productHandleAttr();
+    /**
+     * 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.
+     */
+    private get productIdAttr();
     private get appUrl();
     private get analyticsEnabled();
     private get country();
@@ -134,6 +140,21 @@ declare class LimeBundleElement extends HTMLElement {
      * instead of creating a new one every click.
      */
     private defaultAddToCart;
+    /**
+     * 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.
+     */
+    private clearAbandonedBundleLines;
     private reportAddToCartEvent;
     private renderBundles;
     private setupImpressionFor;

package/dist/index.d.ts

@@ -26,6 +26,10 @@ import { BuyerResolver } from '@lime-bundles/core';
  *   3. /products/<handle> segment of window.location.pathname
  *   4. fallthrough: renders nothing, fires `lime-bundle:error`
  *
+ * Multi-product renderers (volume) bind to the product this embed is
+ * standing on: the explicit `product-id` attribute wins, then the handle
+ * cascade above, then the bundle's first product when neither names one.
+ *
  * ## Add-to-cart behaviour
  *
  * Merchants who do nothing get a default: the widget calls Shopify's
@@ -82,12 +86,6 @@ declare class LimeBundleElement extends HTMLElement {
      * `.lb-bundle-widget { ... }` reach the widget's DOM.
      */
     private shopCustomCss;
-    /**
-     * 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".
-     */
-    private outOfStockBehavior;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
@@ -98,6 +96,14 @@ declare class LimeBundleElement extends HTMLElement {
     private get storefrontToken();
     private get bundleGid();
     private get productHandleAttr();
+    /**
+     * 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.
+     */
+    private get productIdAttr();
     private get appUrl();
     private get analyticsEnabled();
     private get country();
@@ -134,6 +140,21 @@ declare class LimeBundleElement extends HTMLElement {
      * instead of creating a new one every click.
      */
     private defaultAddToCart;
+    /**
+     * 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.
+     */
+    private clearAbandonedBundleLines;
     private reportAddToCartEvent;
     private renderBundles;
     private setupImpressionFor;