@lime-bundles/widget 4.1.1 → 4.3.0

package/README.md

@@ -58,6 +58,7 @@ document.querySelector("lime-bundle").addEventListener(
 | `storefront-token` | ✓ | Storefront Access Token from `/app/settings/headless`. |
 | `bundle-gid` |  | Render one specific bundle. Overrides auto-detect. |
 | `product-handle` |  | Render bundles for this handle. Overrides URL detection. |
+| `product-id` |  | The product this embed is standing on — full GID or bare numeric id. Volume bundles price and sell this product; falls back to the handle cascade, then the bundle's first product. |
 | `app-url` |  | Enables impression + add-to-cart analytics when set. |
 | `analytics` |  | `"false"` suppresses analytics even when `app-url` is set. |
 | `locale` |  | BCP-47 tag forwarded to the Storefront API. |
@@ -67,6 +68,8 @@ document.querySelector("lime-bundle").addEventListener(
 
 **Product resolution** (when `bundle-gid` is absent): explicit `product-handle` → `<meta name="shopify:product-handle">` → `/products/<handle>` URL segment.
 
+**Multi-product binding**: a volume bundle can span several products, and the widget prices and sells the one the shopper is looking at: explicit `product-id` → the handle cascade above → the bundle's first product. On a pinned `bundle-gid` embed outside a `/products/<handle>` URL, set `product-id` (or `product-handle`) or the first product is what gets sold.
+
 Changing any attribute at runtime re-fetches and re-renders.
 
 ### B2B buyer identity (programmatic property only)
@@ -129,7 +132,7 @@ The widget renders its own inline fallback; listen for this event if you want to
 - **Countdown timer.** When a bundle has `endsAt`, the widget ticks live and hides on expiry.
 - **Variant dropdowns.** Products with multiple eligible variants render a `<select>`; switching live-updates the row price and bundle total.
 - **Mix-match picker modal.** Full modal with search, quantity stepper, progress bar, focus trap, and keyboard navigation.
-- **Out-of-stock handling.** Honours `widgetConfig.outOfStockBehavior` (`hide` vs `show_greyed_out`); hides the widget when the bundle is unfulfillable.
+- **Out-of-stock handling.** Sold-out products render greyed out with the CTA locked; a bundle that can't be completed doesn't render.
 - **A/B testing.** Reads the merchant's A/B config, buckets the visitor via a first-party cookie, applies Variant B overrides.
 - **Analytics.** Impression and add-to-cart events fire regardless of whether you override the cart.