@lime-bundles/widget 3.3.0 → 3.4.0

package/docs/react-nextjs.md

@@ -316,13 +316,22 @@ useEffect(() => {
 return <span>{formatCountdown(msLeft)}</span>;
 ```
 
-**A/B variant resolution:**
+**A/B variant resolution (link-group model):**
 
 ```tsx
-import { getABTestAssignment, applyABVariantB } from "@lime-bundles/react";
-
-const assignment = await getABTestAssignment(bundle.abTestId!, bundle.id);
-const bundleForRender = assignment?.variant === "B" ? applyABVariantB(bundle) : bundle;
+import { getLinkGroupAssignment } from "@lime-bundles/react";
+
+// Variants under the new model are full duplicate bundles; the primary
+// advertises the variant weight map via `bundle.linkGroup.variants`. The
+// assigner returns one variant's metaobject GID; render that bundle.
+if (bundle.linkGroup?.isPrimary && bundle.linkGroup.variants?.length) {
+  const assignment = await getLinkGroupAssignment(
+    bundle.linkGroup.id,
+    bundle.linkGroup.variants,
+  );
+  // Render the variant whose metaobjectId === assignment.variantMetaobjectId;
+  // fall back to the primary when assignment is null (consent denied).
+}
 ```
 
 **Analytics + consent:**

package/docs/web-component.md

@@ -296,6 +296,6 @@ Every part of the widget a merchant configures in the admin is wired up for you:
 - **Variant dropdowns on fixed bundles.** Products with multiple eligible variants (filtered by the merchant's `selectedVariantIds`) render a `<select>`; switching variants live-updates the row price and the bundle total.
 - **Mix-match picker modal.** Click any empty slot to open the modal; search, quantity stepper, progress bar, and pricing update as selections change. Keyboard: Escape closes, Tab traps inside the modal.
 - **Out-of-stock behaviour.** Honours `widgetConfig.outOfStockBehavior` (`"hide"` removes OOS products from the list; `"show_greyed_out"` renders them disabled). Fixed bundles hide the whole widget when required products are OOS; mix-match hides when the available count can't satisfy `minQuantity`.
-- **A/B test assignment.** The widget bucketises the visitor via `getABTestAssignment` (cookie-persisted, consent-gated) and merges Variant B overrides (title, description, discount, volume tiers) when the visitor lands in B. Honours Shopify's `customerPrivacy` framework or the SDK's `setConsent(true)` helper.
+- **A/B test assignment (link-group model).** When a bundle is the primary of an A/B test, the widget reads the link group's variant weights from `data-link-group-variants`, walks the cumulative FNV-1a weight distribution via `getLinkGroupAssignment`, and renders the assigned variant (which is a real Bundle with its own products, discount, and widget config — not an overlay). Cookie-persisted, consent-gated; honours Shopify's `customerPrivacy` framework or the SDK's `setConsent(true)` helper. Without consent the primary renders and no cookie is written.
 - **Impression + add-to-cart analytics.** Fire on visibility + CTA click regardless of whether the merchant takes over the cart via `preventDefault`. Disable by setting `analytics="false"` or omitting `app-url`.
 - **Purchase attribution.** The `orders/create` webhook ingests `bundle_purchased` events server-side from the `_lime_bundle_gid` cart attribute the widget adds automatically. No `checkout_completed` handler needed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lime-bundles/widget",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "Drop-in <lime-bundle> web component for the Lime Bundles Shopify app. Embed merchant-configured bundles on Hydrogen, Astro, Vue, Svelte, or any JavaScript-enabled headless storefront.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -46,7 +46,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@lime-bundles/core": "^4.2.0"
+    "@lime-bundles/core": "^5.0.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",