@runwell/shopify-toolkit 0.21.0 → 0.23.0

package/lib/init.js

@@ -65,7 +65,7 @@ export async function init(flags) {
     store: 'TODO.myshopify.com',
     theme_path: '.',
     baseline,
-    toolkit_version: '^0.9.0',
+    toolkit_version: '^0.21.0',
     brand: {
       name: client.charAt(0).toUpperCase() + client.slice(1),
       primary: '#1A1A1A',
@@ -76,7 +76,18 @@ export async function init(flags) {
       tagline: ''
     },
     modules: {
-      '_shared/css-tokens': { enabled: true, config: {} }
+      '_shared/css-tokens': { enabled: true, config: {} },
+      'runwell-bundle-system': {
+        enabled: false,
+        config: {
+          surface_1_collection_page_enabled: false,
+          surface_2_pdp_pairs_with_enabled: false,
+          surface_3_home_stacks_enabled: false,
+          surface_4_cart_drawer_xsell_enabled: false,
+          surface_5_pdp_banner_enabled: false,
+          surface_6_collection_filter_enabled: false
+        }
+      }
     }
   };
 

package/modules/INDEX.md

@@ -47,7 +47,7 @@ Total modules: 39.
 | `recently-viewed` | pdp | (native build) | sections:1 assets:2 | eyebrow, heading, background_color | (none) | (none) |
 | `reviews` | social-proof | (native build) | sections:1 assets:1 | heading | (none) | (none) |
 | `risk-reversal` | conversion | (native build) | sections:1 | icon, heading, body, link_label, link_url, background_color, text_color | (none) | (none) |
-| `runwell-bundle-system` | catalog | the legacy bundle-builder module | sections:6 snippets:8 assets:2 | surface_1_collection_page_enabled, surface_2_pdp_pairs_with_enabled, surface_3_home_stacks_enabled, surface_4_cart_drawer_xsell_enabled, surface_5_pdp_banner_enabled, surface_6_collection_filter_enabled, surface_2_eyebrow, surface_2_heading, surface_3_eyebrow, surface_3_heading, surface_4_eyebrow, surface_4_cta, surface_5_copy_template, cross_supplier_disclosure, home_strip_position | (none) | install-shopify-bundles + define-bundle-metafields + create-bundle-index-metaobject + create-first-bundle-product + configure-quantity-tier-discount-function + configure-free-gift-discount + create-bundles-collection-page-template + add-home-stacks-section + add-pdp-pairs-with-section + add-pdp-banner-section + verify-cart-drawer-coordination + rebuild-bundle-index |
+| `runwell-bundle-system` | catalog | the legacy bundle-builder module | sections:6 snippets:13 assets:2 | surface_1_collection_page_enabled, surface_2_pdp_pairs_with_enabled, surface_3_home_stacks_enabled, surface_4_cart_drawer_xsell_enabled, surface_5_pdp_banner_enabled, surface_6_collection_filter_enabled, surface_2_eyebrow, surface_2_heading, surface_3_eyebrow, surface_3_heading, surface_4_eyebrow, surface_4_cta, surface_5_copy_template, cross_supplier_disclosure, home_strip_position | (none) | install-shopify-bundles + define-bundle-metafields + create-bundle-index-metaobject + create-first-bundle-product + configure-byob-mode + configure-quantity-tier-discount-function + configure-free-gift-discount + create-bundles-collection-page-template + add-home-stacks-section + add-pdp-pairs-with-section + add-pdp-banner-section + verify-cart-drawer-coordination + rebuild-bundle-index |
 | `scrolling-ticker` | social-proof | announcement-bar / scrolling-text apps | sections:1 assets:1 | (none) | (none) | (none) |
 | `shipping-bar` | conversion | (native build) | sections:1 | threshold_cents, message_below, message_qualified, message_default, background_color, text_color | (none) | (none) |
 | `social-proof-banner` | social-proof | fixed-text social-proof apps | sections:1 assets:1 | (none) | (none) | (none) |
@@ -269,9 +269,9 @@ Total modules: 39.
 - Category: catalog
 - Replaces: the legacy bundle-builder module
 - What: Configurable bundles engine.
-- Files: sections:6 snippets:8 assets:2
+- Files: sections:6 snippets:13 assets:2
 - Config: surface_1_collection_page_enabled, surface_2_pdp_pairs_with_enabled, surface_3_home_stacks_enabled, surface_4_cart_drawer_xsell_enabled, surface_5_pdp_banner_enabled, surface_6_collection_filter_enabled, surface_2_eyebrow, surface_2_heading, surface_3_eyebrow, surface_3_heading, surface_4_eyebrow, surface_4_cta, surface_5_copy_template, cross_supplier_disclosure, home_strip_position
-- Admin steps: install-shopify-bundles + define-bundle-metafields + create-bundle-index-metaobject + create-first-bundle-product + configure-quantity-tier-discount-function + configure-free-gift-discount + create-bundles-collection-page-template + add-home-stacks-section + add-pdp-pairs-with-section + add-pdp-banner-section + verify-cart-drawer-coordination + rebuild-bundle-index
+- Admin steps: install-shopify-bundles + define-bundle-metafields + create-bundle-index-metaobject + create-first-bundle-product + configure-byob-mode + configure-quantity-tier-discount-function + configure-free-gift-discount + create-bundles-collection-page-template + add-home-stacks-section + add-pdp-pairs-with-section + add-pdp-banner-section + verify-cart-drawer-coordination + rebuild-bundle-index
 
 ### scrolling-ticker
 

package/modules/runwell-bundle-system/admin-metafields.json

@@ -5,8 +5,8 @@
     "namespace": "runwell",
     "owner_type": "PRODUCT",
     "definitions": [
-      { "key": "bundle_mode", "name": "Bundle mode", "type": "single_line_text_field", "validations": [{ "name": "choices", "value": "[\"quantity_tiers\",\"multi_product\",\"mix_match\",\"subscription\"]" }] },
-      { "key": "bundle_pricing_model", "name": "Bundle pricing model", "type": "single_line_text_field", "validations": [{ "name": "choices", "value": "[\"tier_quantity\",\"fixed_price\",\"percent_off_subtotal\",\"dollar_off_subtotal\"]" }] },
+      { "key": "bundle_mode", "name": "Bundle mode", "type": "single_line_text_field", "validations": [{ "name": "choices", "value": "[\"quantity_tiers\",\"multi_product\",\"mix_match\",\"byob\",\"subscription\"]" }] },
+      { "key": "bundle_pricing_model", "name": "Bundle pricing model", "type": "single_line_text_field", "validations": [{ "name": "choices", "value": "[\"tier_quantity\",\"fixed_price\",\"fixed_bundle_price\",\"percent_off_subtotal\",\"dollar_off_subtotal\"]" }] },
       { "key": "bundle_pricing_value", "name": "Bundle pricing value (JSON)", "type": "json", "description": "Shape varies by pricing_model. See spec.md section 2.2." },
       { "key": "bundle_components", "name": "Bundle components (JSON)", "type": "json", "description": "Required for multi_product / mix_match. Array of {product_handle, qty}." },
       { "key": "bundle_quantity_tiers", "name": "Bundle quantity tiers (JSON)", "type": "json", "description": "Required for quantity_tiers. Array of {qty, discount_pct}. Mirrors quantity_breaks schema." },
@@ -21,6 +21,12 @@
       { "key": "bundle_cross_supplier", "name": "Cross-supplier", "type": "boolean", "default": false },
       { "key": "bundle_supplier_count", "name": "Supplier count", "type": "number_integer" },
       { "key": "bundle_savings_pct", "name": "Computed savings percent", "type": "number_decimal", "description": "Precomputed for fast banner / card render. Recomputed by runwell-shopify rebuild-bundle-index." },
+      { "key": "bundle_byob_candidates", "name": "BYOB candidates", "type": "list.product_reference", "description": "Mode C only. Pool of candidate products the customer can pick from.", "v1_5": true },
+      { "key": "bundle_byob_min_picks", "name": "BYOB min picks", "type": "number_integer", "description": "Mode C only. Minimum required selections before ATC enables.", "v1_5": true },
+      { "key": "bundle_byob_max_picks", "name": "BYOB max picks", "type": "number_integer", "description": "Mode C only. Maximum allowed selections.", "v1_5": true },
+      { "key": "bundle_byob_layout", "name": "BYOB picker layout", "type": "single_line_text_field", "validations": [{ "name": "choices", "value": "[\"grid\",\"accordion\",\"radio\"]" }], "description": "Mode C only. Default grid.", "v1_5": true },
+      { "key": "bundle_byob_categories", "name": "BYOB categories", "type": "json", "description": "Mode C only. Optional. Array of {label, handles: [product_handle]} to group candidates.", "v1_5": true },
+      { "key": "bundle_byob_required_handles", "name": "BYOB required handles", "type": "list.product_reference", "description": "Mode C only. Pre-selected, not deselectable.", "v1_5": true },
       { "key": "subscription_enabled", "name": "Subscription enabled (v2)", "type": "boolean", "default": false, "v2_only": true },
       { "key": "subscription_interval", "name": "Subscription interval (JSON, v2)", "type": "json", "v2_only": true },
       { "key": "subscription_discount_pct", "name": "Subscription discount percent (v2)", "type": "number_decimal", "v2_only": true },
@@ -40,6 +46,9 @@
   "cross_field_validation": [
     { "rule": "bundle_quantity_tiers required when bundle_mode == 'quantity_tiers'", "enforced_by": "runwell-shopify qa --bundles" },
     { "rule": "bundle_components required when bundle_mode in ['multi_product','mix_match']", "enforced_by": "runwell-shopify qa --bundles" },
+    { "rule": "bundle_byob_candidates + bundle_byob_min_picks + bundle_byob_max_picks required when bundle_mode == 'byob'", "enforced_by": "runwell-shopify qa --bundles" },
+    { "rule": "bundle_byob_min_picks <= bundle_byob_max_picks", "enforced_by": "runwell-shopify qa --bundles" },
+    { "rule": "bundle_byob_layout == 'radio' requires bundle_byob_categories", "enforced_by": "runwell-shopify qa --bundles" },
     { "rule": "bundle_pricing_value shape matches bundle_pricing_model (see spec.md section 2.2)", "enforced_by": "runwell-shopify qa --bundles" },
     { "rule": "bundle_free_gift_handle required when bundle_free_gift_enabled == true", "enforced_by": "runwell-shopify qa --bundles" }
   ]

package/modules/runwell-bundle-system/assets/runwell-bundle-system.css

@@ -607,6 +607,252 @@
   opacity: 0.7;
 }
 
+/* ---------- Mode C BYOB ---------- */
+
+.runwell-bundle-system__byob-summary {
+  position: sticky;
+  top: 0;
+  z-index: 5;
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 12px;
+  padding: 12px 14px;
+  border-radius: var(--runwell-radius-md, 12px);
+  background: var(--runwell-surface-card, #fff);
+  box-shadow: var(--runwell-shadow-card, 0 2px 8px rgba(0,0,0,0.04));
+  margin-bottom: 16px;
+}
+
+.runwell-bundle-system__byob-counter {
+  margin: 0;
+  font-size: 0.95rem;
+  font-weight: 600;
+  display: flex;
+  align-items: baseline;
+  gap: 4px;
+}
+
+.runwell-bundle-system__byob-counter-of,
+.runwell-bundle-system__byob-counter-label {
+  font-weight: 400;
+  opacity: 0.75;
+  font-size: 0.85rem;
+}
+
+.runwell-bundle-system__byob-pricing {
+  margin-left: auto;
+  display: flex;
+  align-items: baseline;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+
+.runwell-bundle-system__byob-pricing-subtotal {
+  opacity: 0.55;
+  font-size: 0.85rem;
+}
+
+.runwell-bundle-system__byob-pricing-current {
+  font-size: 1.2rem;
+  font-weight: 700;
+}
+
+.runwell-bundle-system__byob-pricing-badge {
+  padding: 4px 10px;
+  font-size: 0.78rem;
+  font-weight: 600;
+  border-radius: 999px;
+  background: var(--runwell-accent, currentColor);
+  color: var(--runwell-cream, #fff);
+}
+
+.runwell-bundle-system__byob-helper {
+  width: 100%;
+  margin: 0;
+  font-size: 0.8rem;
+  opacity: 0.75;
+}
+
+.runwell-bundle-system__byob-picker--grid {
+  display: grid;
+  grid-template-columns: repeat(2, 1fr);
+  gap: 10px;
+}
+
+@media (min-width: 640px) {
+  .runwell-bundle-system__byob-picker--grid {
+    grid-template-columns: repeat(3, 1fr);
+    gap: 12px;
+  }
+}
+
+@media (min-width: 1024px) {
+  .runwell-bundle-system__byob-picker--grid {
+    grid-template-columns: repeat(4, 1fr);
+  }
+}
+
+.runwell-bundle-system__byob-candidate {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  min-height: 44px;
+  padding: 10px;
+  border: 2px solid color-mix(in srgb, currentColor 10%, transparent);
+  border-radius: var(--runwell-radius-md, 12px);
+  background: var(--runwell-surface-card, #fff);
+  cursor: pointer;
+  transition: border-color 120ms ease, background 120ms ease;
+}
+
+.runwell-bundle-system__byob-candidate:hover {
+  border-color: color-mix(in srgb, var(--runwell-accent, currentColor) 50%, transparent);
+}
+
+.runwell-bundle-system__byob-candidate:has(.runwell-bundle-system__byob-input:checked) {
+  border-color: var(--runwell-accent, currentColor);
+  background: color-mix(in srgb, var(--runwell-accent, currentColor) 6%, var(--runwell-surface-card, #fff));
+}
+
+.runwell-bundle-system__byob-candidate--required {
+  border-style: dashed;
+  opacity: 0.95;
+}
+
+.runwell-bundle-system__byob-candidate--unavailable {
+  opacity: 0.55;
+  cursor: not-allowed;
+}
+
+.runwell-bundle-system__byob-input {
+  position: absolute;
+  opacity: 0;
+  pointer-events: none;
+}
+
+.runwell-bundle-system__byob-candidate-thumb {
+  width: 100%;
+  height: auto;
+  aspect-ratio: 1 / 1;
+  object-fit: cover;
+  border-radius: var(--runwell-radius-sm, 4px);
+  display: block;
+}
+
+.runwell-bundle-system__byob-candidate-body {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+
+.runwell-bundle-system__byob-candidate-title {
+  font-size: 0.9rem;
+  font-weight: 600;
+  line-height: 1.3;
+}
+
+.runwell-bundle-system__byob-candidate-price {
+  font-size: 0.85rem;
+  opacity: 0.8;
+}
+
+.runwell-bundle-system__byob-candidate-badge {
+  margin-top: 4px;
+  align-self: flex-start;
+  padding: 2px 8px;
+  font-size: 0.7rem;
+  font-weight: 600;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--runwell-blue, currentColor) 18%, transparent);
+}
+
+.runwell-bundle-system__byob-picker--accordion {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.runwell-bundle-system__byob-accordion {
+  border: 1px solid color-mix(in srgb, currentColor 10%, transparent);
+  border-radius: var(--runwell-radius-md, 12px);
+  background: var(--runwell-surface-card, #fff);
+}
+
+.runwell-bundle-system__byob-accordion-summary {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 14px 16px;
+  min-height: 44px;
+  font-weight: 600;
+  cursor: pointer;
+  list-style: none;
+}
+
+.runwell-bundle-system__byob-accordion-summary::-webkit-details-marker {
+  display: none;
+}
+
+.runwell-bundle-system__byob-accordion-count {
+  margin-left: auto;
+  padding: 2px 10px;
+  font-size: 0.78rem;
+  font-weight: 600;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--runwell-accent, currentColor) 16%, transparent);
+}
+
+.runwell-bundle-system__byob-accordion-body {
+  display: grid;
+  grid-template-columns: repeat(2, 1fr);
+  gap: 10px;
+  padding: 0 16px 16px 16px;
+}
+
+@media (min-width: 768px) {
+  .runwell-bundle-system__byob-accordion-body {
+    grid-template-columns: repeat(3, 1fr);
+  }
+}
+
+.runwell-bundle-system__byob-picker--radio {
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+}
+
+.runwell-bundle-system__byob-radio-group {
+  border: 0;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.runwell-bundle-system__byob-radio-legend {
+  font-size: 0.85rem;
+  font-weight: 600;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+  opacity: 0.75;
+  margin-bottom: 4px;
+}
+
+.runwell-bundle-system__byob-candidate--radio {
+  flex-direction: row;
+  align-items: center;
+  padding: 10px 12px;
+}
+
+.runwell-bundle-system__byob-candidate--radio .runwell-bundle-system__byob-candidate-thumb {
+  width: 56px;
+  height: 56px;
+  aspect-ratio: 1 / 1;
+}
+
 /* ---------- Surface 4: cart drawer bundle cross-sell ---------- */
 
 .runwell-bundle-cart-xsell {

package/modules/runwell-bundle-system/assets/runwell-bundle-system.js

@@ -271,17 +271,174 @@
     });
   }
 
+  /* ---------- Mode C BYOB ---------- */
+
+  function parsePricingValue(raw) {
+    if (raw == null || raw === '') return null;
+    try { return JSON.parse(raw); } catch (e) { return null; }
+  }
+
+  function computeByobPrice(subtotalCents, pricingModel, pricingValue) {
+    if (pricingModel === 'fixed_bundle_price' || pricingModel === 'fixed_price') {
+      const v = typeof pricingValue === 'object' && pricingValue !== null
+        ? (pricingValue.amount || pricingValue.price || 0)
+        : pricingValue;
+      return Math.max(0, parseInt(v, 10) || 0);
+    }
+    if (pricingModel === 'percent_off_subtotal') {
+      const pct = typeof pricingValue === 'object' && pricingValue !== null
+        ? (pricingValue.pct || pricingValue.percent || 0)
+        : pricingValue;
+      const discounted = subtotalCents * (1 - (parseFloat(pct) || 0) / 100);
+      return Math.max(0, Math.round(discounted));
+    }
+    if (pricingModel === 'dollar_off_subtotal') {
+      const off = typeof pricingValue === 'object' && pricingValue !== null
+        ? (pricingValue.amount || pricingValue.off || 0)
+        : pricingValue;
+      return Math.max(0, subtotalCents - (parseInt(off, 10) || 0));
+    }
+    return subtotalCents;
+  }
+
+  function formatByobMoney(cents) {
+    return '$' + (cents / 100).toFixed(2);
+  }
+
+  function initByob() {
+    document
+      .querySelectorAll('[data-runwell-byob-picker]')
+      .forEach(function (picker) {
+        const form = picker.closest('form');
+        if (!form) return;
+        const root = form.parentElement || form;
+        const summary = root.querySelector('[data-runwell-byob-summary]');
+        const atc = form.querySelector('[data-runwell-byob-atc]');
+
+        const layout = picker.dataset.byobLayout;
+        const min = parseInt(picker.dataset.byobMin, 10) || 0;
+        const max = parseInt(picker.dataset.byobMax, 10) || 0;
+        const pricingModel = picker.dataset.byobPricingModel;
+        const pricingValue = parsePricingValue(picker.dataset.byobPricingValue);
+
+        function getSelected() {
+          return Array.from(picker.querySelectorAll('.runwell-bundle-system__byob-input:checked'))
+            .map(function (input) {
+              const label = input.closest('.runwell-bundle-system__byob-candidate');
+              return {
+                handle: label.dataset.handle,
+                price: parseInt(label.dataset.price, 10) || 0,
+                variantId: label.dataset.variantId,
+                category: label.dataset.category || null,
+                input: input
+              };
+            });
+        }
+
+        function updateAccordionCounts() {
+          if (layout !== 'accordion') return;
+          picker.querySelectorAll('.runwell-bundle-system__byob-accordion').forEach(function (acc) {
+            const count = acc.querySelectorAll('.runwell-bundle-system__byob-input:checked').length;
+            const badge = acc.querySelector('[data-runwell-byob-cat-count]');
+            if (badge) badge.textContent = count;
+          });
+        }
+
+        function enforceMax(selected) {
+          if (layout === 'radio') return;
+          if (selected.length <= max) return;
+          const overflow = selected.slice(max);
+          overflow.forEach(function (s) {
+            if (!s.input.disabled) s.input.checked = false;
+          });
+        }
+
+        function render() {
+          let selected = getSelected();
+          enforceMax(selected);
+          selected = getSelected();
+
+          const count = selected.length;
+          const subtotal = selected.reduce(function (acc, s) { return acc + s.price; }, 0);
+          const total = computeByobPrice(subtotal, pricingModel, pricingValue);
+          const savings = Math.max(0, subtotal - total);
+
+          if (summary) {
+            const selEl = summary.querySelector('[data-runwell-byob-selected]');
+            const totalEl = summary.querySelector('[data-runwell-byob-total]');
+            const subEl = summary.querySelector('[data-runwell-byob-subtotal]');
+            const subAmt = summary.querySelector('[data-runwell-byob-subtotal-amount]');
+            const savEl = summary.querySelector('[data-runwell-byob-savings]');
+            const savAmt = summary.querySelector('[data-runwell-byob-savings-amount]');
+            const helper = summary.querySelector('[data-runwell-byob-helper]');
+
+            if (selEl) selEl.textContent = count;
+            if (totalEl) totalEl.textContent = formatByobMoney(total);
+            const isFixed = pricingModel === 'fixed_bundle_price' || pricingModel === 'fixed_price';
+            if (savings > 0 && !isFixed) {
+              if (subEl) { subEl.hidden = false; if (subAmt) subAmt.textContent = formatByobMoney(subtotal); }
+              if (savEl) { savEl.hidden = false; if (savAmt) savAmt.textContent = formatByobMoney(savings); }
+            } else {
+              if (subEl) subEl.hidden = true;
+              if (savEl) savEl.hidden = true;
+            }
+            if (helper) helper.style.display = count >= min ? 'none' : '';
+          }
+
+          if (atc) {
+            const ok = count >= min && count <= max;
+            atc.disabled = !ok;
+          }
+          updateAccordionCounts();
+        }
+
+        picker.addEventListener('change', function (e) {
+          if (!e.target.matches('.runwell-bundle-system__byob-input')) return;
+          render();
+        });
+
+        form.addEventListener('submit', function (e) {
+          const selected = getSelected();
+          if (selected.length < min || selected.length > max) {
+            e.preventDefault();
+            return;
+          }
+          e.preventDefault();
+          const items = selected.map(function (s) {
+            return { id: parseInt(s.variantId, 10), quantity: 1 };
+          });
+          fetch('/cart/add.js', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+            body: JSON.stringify({ items: items })
+          })
+            .then(function (r) { return r.json(); })
+            .then(function () {
+              document.dispatchEvent(new CustomEvent('cart:refresh'));
+              window.location.href = '/cart';
+            })
+            .catch(function () {
+              if (atc) atc.disabled = false;
+            });
+        });
+
+        render();
+      });
+  }
+
   if (document.readyState === 'loading') {
     document.addEventListener('DOMContentLoaded', function () {
       initFomo();
       initTierSync();
       initFilterChip();
       initCartXsell();
+      initByob();
     });
   } else {
     initFomo();
     initTierSync();
     initFilterChip();
     initCartXsell();
+    initByob();
   }
 })();

package/modules/runwell-bundle-system/module.json

@@ -1,6 +1,6 @@
 {
   "name": "runwell-bundle-system",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "category": "catalog",
   "source": "runwell",
   "base": "bundle-system",
@@ -23,7 +23,12 @@
       "snippets/runwell-bundle-cross-supplier.liquid",
       "snippets/runwell-bundle-fomo.liquid",
       "snippets/runwell-bundle-free-gift.liquid",
-      "snippets/runwell-bundle-data.liquid"
+      "snippets/runwell-bundle-data.liquid",
+      "snippets/runwell-bundle-byob-picker.liquid",
+      "snippets/runwell-bundle-byob-picker-grid.liquid",
+      "snippets/runwell-bundle-byob-picker-accordion.liquid",
+      "snippets/runwell-bundle-byob-picker-radio.liquid",
+      "snippets/runwell-bundle-byob-summary.liquid"
     ],
     "assets": [
       "assets/runwell-bundle-system.css",
@@ -74,6 +79,12 @@
       "url": "https://admin.shopify.com/store/{store_handle}/products/new",
       "summary": "Use the Shopify Bundles app to create the bundle (Apps > Bundles > Create). The app creates a bundle product. SKU convention: BUNDLE-<handle>. Then open the bundle product, scroll to Metafields, and fill the runwell.bundle_* fields per the bundle's mode."
     },
+    {
+      "id": "configure-byob-mode",
+      "label": "Configure a BYOB (Mode C) bundle product",
+      "url": "https://admin.shopify.com/store/{store_handle}/products",
+      "summary": "Mode C only. Set bundle_mode = 'byob'. Required: bundle_byob_candidates (list of product references), bundle_byob_min_picks, bundle_byob_max_picks, bundle_pricing_model (fixed_bundle_price / percent_off_subtotal / dollar_off_subtotal), bundle_pricing_value. Optional: bundle_byob_layout (grid default, accordion, radio), bundle_byob_categories (JSON), bundle_byob_required_handles. Install a Shopify Functions discount that mirrors the pricing model so the savings apply at checkout."
+    },
     {
       "id": "configure-quantity-tier-discount-function",
       "label": "Create a Shopify Functions discount for quantity-tier mode (Mode A only)",

package/modules/runwell-bundle-system/qa/v1.5-mobile-qa-checklist.md

@@ -0,0 +1,103 @@
+# v1.5 mobile QA checklist: Mode C BYOB + admin block
+
+Re-validates the storefront at 375 px after Mode C BYOB lands, plus admin block usability on Shopify's mobile admin app. Mirrors BS-14's v1 pass; adds the new v1.5 surfaces.
+
+## Environment
+
+- Real iPhone (iPhone 12 or newer; iOS 17+).
+- Safari for storefront; Shopify mobile admin app for admin block.
+- Staging tenant with at least:
+  - 1 Mode A bundle (Lusha pattern, for regression).
+  - 1 Mode B bundle (Lushi pattern, for regression).
+  - 1 Mode C bundle per layout: grid, accordion, radio.
+
+## Storefront checks (per Mode C layout)
+
+### Grid layout
+
+- [ ] Picker renders at 2 columns at 375 px.
+- [ ] Each candidate card has a 44 px tap target.
+- [ ] Tap toggles selection; checkmark / border state matches the rest of the bundle module.
+- [ ] Live counter updates as you tap.
+- [ ] Subtotal + savings refresh client-side.
+- [ ] ATC stays disabled until min picks reached; enables when in range.
+- [ ] Max-pick cap drops the oldest selection (or refuses the new one, depending on convention).
+- [ ] Required candidates are pre-checked and not deselectable.
+- [ ] Unavailable candidates render disabled, not removed.
+- [ ] Submit posts a multi-line cart add; cart drawer reflects the picks.
+
+### Accordion layout
+
+- [ ] Categories render as `<details>` blocks; first one open by default.
+- [ ] Per-category count badge updates on each pick.
+- [ ] Total picks across categories enforced against bundle_byob_max_picks.
+- [ ] Required candidates ship pre-checked in their parent category.
+
+### Radio layout
+
+- [ ] Each category renders as a radio group; first option pre-selected.
+- [ ] One pick per category enforced (radios).
+- [ ] Total picks equals category count; ATC enables once every category has a pick.
+- [ ] Switching pick within a category updates subtotal + total.
+
+## Storefront regression (v1 surfaces with a Mode C bundle in catalog)
+
+- [ ] /bundles page lists the Mode C bundle alongside Mode A and Mode B.
+- [ ] Bundle card hero variant renders correctly with the BYOB savings badge.
+- [ ] PDP pairs-with widget shows the Mode C bundle when a component is the current PDP.
+- [ ] Home page curated stacks strip includes the Mode C bundle when picked.
+- [ ] Cart drawer cross-sell offers the Mode C bundle when a partial set is in cart.
+- [ ] PDP banner with a Mode C bundle reads "Save N% when bundled".
+
+## Admin block checks (Shopify mobile admin app)
+
+Best-effort: mobile admin is rare; document any limitations.
+
+### Composition panel (BS-205)
+
+- [ ] Mode selector toggles between tier / component / candidate sub-UIs.
+- [ ] Add / remove / reorder works in each mode.
+- [ ] Validation banner surfaces when constraints are violated.
+
+### Pricing panel (BS-206)
+
+- [ ] Pricing model dropdown limits to allowed modes per bundle_mode.
+- [ ] Value editor changes shape with model.
+- [ ] Save disabled when value is empty.
+
+### Surfaces panel (BS-207)
+
+- [ ] All 6 surface toggles render.
+- [ ] Toggle state persists after save.
+
+### Cross-supplier banner (BS-208)
+
+- [ ] Banner appears when components span multiple suppliers.
+- [ ] Mentions the actual supplier count.
+- [ ] Suppresses when count is 1.
+
+### Bundle preview (BS-209)
+
+- [ ] Iframe renders at 375 px.
+- [ ] Preview reflects the saved state (not buffered edits).
+
+## Cross-cutting
+
+- [ ] No horizontal scroll on any storefront surface.
+- [ ] All tap targets >= 44 px.
+- [ ] Total module bytes still under 80 KB (CSS + JS, pre-minification).
+- [ ] No console errors on storefront or admin.
+- [ ] Lighthouse mobile score >= 80 on the BYOB PDP.
+
+## Screenshot capture
+
+Per surface, capture 3 states (default, mid-interaction, validation error).
+
+Path: `runwell-shopify-toolkit/docs/bundle-system/qa/v1.5-screenshots-YYYY-MM-DD/`.
+
+## Sign-off
+
+- [ ] All applicable checks passed.
+- [ ] Screenshots captured and committed.
+- [ ] P1 failures fixed; P2 logged for v1.5 patch.
+- [ ] QA owner + date: ___________________

package/modules/runwell-bundle-system/sections/runwell-bundle-pdp.liquid

@@ -58,6 +58,18 @@
           bundle_savings_amount: bundle_savings_amount,
           bundle_savings_pct: bundle_savings_pct
         %}
+      {%- elsif bundle_mode == 'byob' -%}
+        {% render 'runwell-bundle-byob-picker',
+          product: product,
+          bundle_pricing_model: bundle_pricing_model,
+          bundle_pricing_value: bundle_pricing_value,
+          bundle_byob_candidates: bundle_byob_candidates,
+          bundle_byob_min_picks: bundle_byob_min_picks,
+          bundle_byob_max_picks: bundle_byob_max_picks,
+          bundle_byob_layout: bundle_byob_layout,
+          bundle_byob_categories: bundle_byob_categories,
+          bundle_byob_required_handles: bundle_byob_required_handles
+        %}
       {%- endif -%}
 
       {%- if bundle_fomo_mode != 'none' and bundle_fomo_mode != blank -%}

package/modules/runwell-bundle-system/snippets/runwell-bundle-byob-picker-accordion.liquid

@@ -0,0 +1,84 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-byob-picker-accordion.liquid.
+  Mode C, accordion layout. Candidates grouped by bundle_byob_categories.
+  One category open at a time. Total picks across all categories
+  enforced via JS.
+
+  Inputs:
+    bundle_byob_candidates, bundle_byob_min_picks, bundle_byob_max_picks,
+    bundle_byob_categories ([{label, handles}]),
+    bundle_byob_required_handles, bundle_pricing_model, bundle_pricing_value.
+{%- endcomment -%}
+
+{%- if bundle_byob_categories and bundle_byob_categories.size > 0 -%}
+  {%- assign required_handles = '' -%}
+  {%- if bundle_byob_required_handles -%}
+    {%- capture required_handles -%}
+      {%- for r in bundle_byob_required_handles -%}{{ r.handle }},{%- endfor -%}
+    {%- endcapture -%}
+  {%- endif -%}
+
+  <div
+    class="runwell-bundle-system__byob-picker runwell-bundle-system__byob-picker--accordion"
+    data-runwell-byob-picker
+    data-byob-layout="accordion"
+    data-byob-min="{{ bundle_byob_min_picks }}"
+    data-byob-max="{{ bundle_byob_max_picks }}"
+    data-byob-pricing-model="{{ bundle_pricing_model }}"
+    data-byob-pricing-value="{{ bundle_pricing_value | json | escape }}"
+  >
+    {%- for category in bundle_byob_categories -%}
+      <details class="runwell-bundle-system__byob-accordion" {% if forloop.first %}open{% endif %}>
+        <summary class="runwell-bundle-system__byob-accordion-summary">
+          <span class="runwell-bundle-system__byob-accordion-label">{{ category.label }}</span>
+          <span class="runwell-bundle-system__byob-accordion-count" data-runwell-byob-cat-count>0</span>
+        </summary>
+        <div class="runwell-bundle-system__byob-accordion-body">
+          {%- for handle in category.handles -%}
+            {%- assign candidate = all_products[handle] -%}
+            {%- if candidate != blank -%}
+              {%- assign is_required = false -%}
+              {%- if required_handles contains handle -%}{%- assign is_required = true -%}{%- endif -%}
+              <label
+                class="runwell-bundle-system__byob-candidate{% if is_required %} runwell-bundle-system__byob-candidate--required{% endif %}"
+                data-handle="{{ candidate.handle }}"
+                data-price="{{ candidate.price }}"
+                data-variant-id="{{ candidate.selected_or_first_available_variant.id }}"
+                data-category="{{ category.label | escape }}"
+              >
+                <input
+                  type="checkbox"
+                  class="runwell-bundle-system__byob-input"
+                  name="byob-pick"
+                  value="{{ candidate.handle }}"
+                  {% if is_required %}checked disabled{% endif %}
+                  {% unless candidate.available %}disabled{% endunless %}
+                >
+                <span class="runwell-bundle-system__byob-candidate-media">
+                  {%- if candidate.featured_image -%}
+                    {{ candidate.featured_image | image_url: width: 240 | image_tag:
+                      width: 120,
+                      height: 120,
+                      loading: 'lazy',
+                      class: 'runwell-bundle-system__byob-candidate-thumb',
+                      alt: candidate.title
+                    }}
+                  {%- endif -%}
+                </span>
+                <span class="runwell-bundle-system__byob-candidate-body">
+                  <span class="runwell-bundle-system__byob-candidate-title">{{ candidate.title }}</span>
+                  <span class="runwell-bundle-system__byob-candidate-price">{{ candidate.price | money }}</span>
+                  {%- if is_required -%}
+                    <span class="runwell-bundle-system__byob-candidate-badge">Always included</span>
+                  {%- endif -%}
+                </span>
+              </label>
+            {%- endif -%}
+          {%- endfor -%}
+        </div>
+      </details>
+    {%- endfor -%}
+  </div>
+{%- else -%}
+  <p class="runwell-bundle-system__empty">Accordion layout requires bundle_byob_categories. Falling back to grid layout via runwell-bundle-byob-picker.liquid.</p>
+{%- endif -%}

package/modules/runwell-bundle-system/snippets/runwell-bundle-byob-picker-grid.liquid

@@ -0,0 +1,72 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-byob-picker-grid.liquid.
+  Mode C, default layout. Flat checkbox grid of all candidates. Min/max
+  picks enforced via JS.
+
+  Inputs:
+    bundle_byob_candidates, bundle_byob_min_picks, bundle_byob_max_picks,
+    bundle_byob_required_handles, bundle_pricing_model, bundle_pricing_value.
+{%- endcomment -%}
+
+{%- if bundle_byob_candidates and bundle_byob_candidates.size > 0 -%}
+  {%- assign required_handles = '' -%}
+  {%- if bundle_byob_required_handles -%}
+    {%- capture required_handles -%}
+      {%- for r in bundle_byob_required_handles -%}{{ r.handle }},{%- endfor -%}
+    {%- endcapture -%}
+  {%- endif -%}
+
+  <div
+    class="runwell-bundle-system__byob-picker runwell-bundle-system__byob-picker--grid"
+    data-runwell-byob-picker
+    data-byob-layout="grid"
+    data-byob-min="{{ bundle_byob_min_picks }}"
+    data-byob-max="{{ bundle_byob_max_picks }}"
+    data-byob-pricing-model="{{ bundle_pricing_model }}"
+    data-byob-pricing-value="{{ bundle_pricing_value | json | escape }}"
+  >
+    {%- for candidate in bundle_byob_candidates -%}
+      {%- assign is_required = false -%}
+      {%- if required_handles contains candidate.handle -%}{%- assign is_required = true -%}{%- endif -%}
+      {%- assign is_available = candidate.available | default: true -%}
+
+      <label
+        class="runwell-bundle-system__byob-candidate{% if is_required %} runwell-bundle-system__byob-candidate--required{% endif %}{% unless is_available %} runwell-bundle-system__byob-candidate--unavailable{% endunless %}"
+        data-handle="{{ candidate.handle }}"
+        data-price="{{ candidate.price }}"
+        data-variant-id="{{ candidate.selected_or_first_available_variant.id }}"
+      >
+        <input
+          type="checkbox"
+          class="runwell-bundle-system__byob-input"
+          name="byob-pick"
+          value="{{ candidate.handle }}"
+          {% if is_required %}checked disabled{% endif %}
+          {% unless is_available %}disabled{% endunless %}
+        >
+        <span class="runwell-bundle-system__byob-candidate-media">
+          {%- if candidate.featured_image -%}
+            {{ candidate.featured_image | image_url: width: 240 | image_tag:
+              width: 120,
+              height: 120,
+              loading: 'lazy',
+              class: 'runwell-bundle-system__byob-candidate-thumb',
+              alt: candidate.title
+            }}
+          {%- endif -%}
+        </span>
+        <span class="runwell-bundle-system__byob-candidate-body">
+          <span class="runwell-bundle-system__byob-candidate-title">{{ candidate.title }}</span>
+          <span class="runwell-bundle-system__byob-candidate-price">{{ candidate.price | money }}</span>
+          {%- if is_required -%}
+            <span class="runwell-bundle-system__byob-candidate-badge">Always included</span>
+          {%- elsif is_available == false -%}
+            <span class="runwell-bundle-system__byob-candidate-badge">Sold out</span>
+          {%- endif -%}
+        </span>
+      </label>
+    {%- endfor -%}
+  </div>
+{%- else -%}
+  <p class="runwell-bundle-system__empty">No BYOB candidates configured for this bundle.</p>
+{%- endif -%}

package/modules/runwell-bundle-system/snippets/runwell-bundle-byob-picker-radio.liquid

@@ -0,0 +1,77 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-byob-picker-radio.liquid.
+  Mode C, one-pick-per-category layout. Total picks equals category count.
+  Each category renders as a radio group; total picks across categories
+  is the category count exactly.
+
+  Inputs:
+    bundle_byob_candidates, bundle_byob_categories ([{label, handles}]),
+    bundle_byob_required_handles, bundle_pricing_model, bundle_pricing_value.
+{%- endcomment -%}
+
+{%- if bundle_byob_categories and bundle_byob_categories.size > 0 -%}
+  {%- assign required_handles = '' -%}
+  {%- if bundle_byob_required_handles -%}
+    {%- capture required_handles -%}
+      {%- for r in bundle_byob_required_handles -%}{{ r.handle }},{%- endfor -%}
+    {%- endcapture -%}
+  {%- endif -%}
+  {%- assign cat_count = bundle_byob_categories.size -%}
+
+  <div
+    class="runwell-bundle-system__byob-picker runwell-bundle-system__byob-picker--radio"
+    data-runwell-byob-picker
+    data-byob-layout="radio"
+    data-byob-min="{{ cat_count }}"
+    data-byob-max="{{ cat_count }}"
+    data-byob-pricing-model="{{ bundle_pricing_model }}"
+    data-byob-pricing-value="{{ bundle_pricing_value | json | escape }}"
+  >
+    {%- for category in bundle_byob_categories -%}
+      {%- assign cat_idx = forloop.index -%}
+      <fieldset class="runwell-bundle-system__byob-radio-group">
+        <legend class="runwell-bundle-system__byob-radio-legend">{{ category.label }}</legend>
+        {%- for handle in category.handles -%}
+          {%- assign candidate = all_products[handle] -%}
+          {%- if candidate != blank -%}
+            {%- assign is_required = false -%}
+            {%- if required_handles contains handle -%}{%- assign is_required = true -%}{%- endif -%}
+            <label
+              class="runwell-bundle-system__byob-candidate runwell-bundle-system__byob-candidate--radio{% if is_required %} runwell-bundle-system__byob-candidate--required{% endif %}"
+              data-handle="{{ candidate.handle }}"
+              data-price="{{ candidate.price }}"
+              data-variant-id="{{ candidate.selected_or_first_available_variant.id }}"
+              data-category="{{ category.label | escape }}"
+            >
+              <input
+                type="radio"
+                class="runwell-bundle-system__byob-input"
+                name="byob-pick-cat-{{ cat_idx }}"
+                value="{{ candidate.handle }}"
+                {% if is_required or forloop.first %}checked{% endif %}
+                {% unless candidate.available %}disabled{% endunless %}
+              >
+              <span class="runwell-bundle-system__byob-candidate-media">
+                {%- if candidate.featured_image -%}
+                  {{ candidate.featured_image | image_url: width: 240 | image_tag:
+                    width: 80,
+                    height: 80,
+                    loading: 'lazy',
+                    class: 'runwell-bundle-system__byob-candidate-thumb',
+                    alt: candidate.title
+                  }}
+                {%- endif -%}
+              </span>
+              <span class="runwell-bundle-system__byob-candidate-body">
+                <span class="runwell-bundle-system__byob-candidate-title">{{ candidate.title }}</span>
+                <span class="runwell-bundle-system__byob-candidate-price">{{ candidate.price | money }}</span>
+              </span>
+            </label>
+          {%- endif -%}
+        {%- endfor -%}
+      </fieldset>
+    {%- endfor -%}
+  </div>
+{%- else -%}
+  <p class="runwell-bundle-system__empty">Radio layout requires bundle_byob_categories.</p>
+{%- endif -%}

package/modules/runwell-bundle-system/snippets/runwell-bundle-byob-picker.liquid

@@ -0,0 +1,71 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-byob-picker.liquid.
+  Mode C router. Reads bundle_byob_layout and delegates to one of
+  three layout snippets:
+    - grid (default)
+    - accordion
+    - radio (one pick per category)
+
+  Inputs (all forwarded to the layout snippet):
+    product, bundle_pricing_model, bundle_pricing_value,
+    bundle_byob_candidates, bundle_byob_min_picks, bundle_byob_max_picks,
+    bundle_byob_layout, bundle_byob_categories, bundle_byob_required_handles.
+
+  Fallback: if layout == 'radio' but no categories are set, falls back
+  to grid and emits a console warning client side.
+{%- endcomment -%}
+
+{%- assign layout = bundle_byob_layout | default: 'grid' -%}
+{%- if layout == 'radio' and bundle_byob_categories == blank -%}
+  {%- assign layout = 'grid' -%}
+{%- endif -%}
+
+{% render 'runwell-bundle-byob-summary',
+  bundle_pricing_model: bundle_pricing_model,
+  bundle_pricing_value: bundle_pricing_value,
+  bundle_byob_min_picks: bundle_byob_min_picks,
+  bundle_byob_max_picks: bundle_byob_max_picks
+%}
+
+{%- form 'product', product, class: 'runwell-bundle-system__form runwell-bundle-system__byob-form', novalidate: 'novalidate' -%}
+  {%- if layout == 'grid' -%}
+    {% render 'runwell-bundle-byob-picker-grid',
+      bundle_byob_candidates: bundle_byob_candidates,
+      bundle_byob_min_picks: bundle_byob_min_picks,
+      bundle_byob_max_picks: bundle_byob_max_picks,
+      bundle_byob_required_handles: bundle_byob_required_handles,
+      bundle_pricing_model: bundle_pricing_model,
+      bundle_pricing_value: bundle_pricing_value
+    %}
+  {%- elsif layout == 'accordion' -%}
+    {% render 'runwell-bundle-byob-picker-accordion',
+      bundle_byob_candidates: bundle_byob_candidates,
+      bundle_byob_min_picks: bundle_byob_min_picks,
+      bundle_byob_max_picks: bundle_byob_max_picks,
+      bundle_byob_categories: bundle_byob_categories,
+      bundle_byob_required_handles: bundle_byob_required_handles,
+      bundle_pricing_model: bundle_pricing_model,
+      bundle_pricing_value: bundle_pricing_value
+    %}
+  {%- elsif layout == 'radio' -%}
+    {% render 'runwell-bundle-byob-picker-radio',
+      bundle_byob_candidates: bundle_byob_candidates,
+      bundle_byob_categories: bundle_byob_categories,
+      bundle_byob_required_handles: bundle_byob_required_handles,
+      bundle_pricing_model: bundle_pricing_model,
+      bundle_pricing_value: bundle_pricing_value
+    %}
+  {%- endif -%}
+
+  <input type="hidden" name="id" value="{{ product.selected_or_first_available_variant.id }}">
+
+  <button
+    type="submit"
+    name="add"
+    class="runwell-bundle-system__atc button button--primary button--full-width"
+    data-runwell-byob-atc
+    disabled
+  >
+    <span class="runwell-bundle-system__atc-label">Add to cart</span>
+  </button>
+{%- endform -%}

package/modules/runwell-bundle-system/snippets/runwell-bundle-byob-summary.liquid

@@ -0,0 +1,39 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-byob-summary.liquid.
+  Live counter + price for Mode C BYOB. Numbers update from JS on every
+  selection change. Static fallback on first render shows zeros.
+
+  Inputs:
+    bundle_pricing_model, bundle_pricing_value,
+    bundle_byob_min_picks, bundle_byob_max_picks.
+{%- endcomment -%}
+
+<div
+  class="runwell-bundle-system__byob-summary"
+  data-runwell-byob-summary
+  data-byob-min="{{ bundle_byob_min_picks }}"
+  data-byob-max="{{ bundle_byob_max_picks }}"
+  data-byob-pricing-model="{{ bundle_pricing_model }}"
+  data-byob-pricing-value="{{ bundle_pricing_value | json | escape }}"
+>
+  <p class="runwell-bundle-system__byob-counter" data-runwell-byob-counter>
+    <span data-runwell-byob-selected>0</span>
+    <span class="runwell-bundle-system__byob-counter-of">of</span>
+    <span data-runwell-byob-target>{{ bundle_byob_max_picks }}</span>
+    <span class="runwell-bundle-system__byob-counter-label">selected</span>
+  </p>
+
+  <div class="runwell-bundle-system__byob-pricing">
+    <span class="runwell-bundle-system__byob-pricing-subtotal" data-runwell-byob-subtotal hidden>
+      <s data-runwell-byob-subtotal-amount>{{ 0 | money }}</s>
+    </span>
+    <span class="runwell-bundle-system__byob-pricing-current" data-runwell-byob-total>{{ 0 | money }}</span>
+    <span class="runwell-bundle-system__byob-pricing-badge" data-runwell-byob-savings hidden>
+      Save <span data-runwell-byob-savings-amount></span>
+    </span>
+  </div>
+
+  <p class="runwell-bundle-system__byob-helper" data-runwell-byob-helper>
+    Pick at least <strong>{{ bundle_byob_min_picks }}</strong>{% if bundle_byob_max_picks != bundle_byob_min_picks %}, up to <strong>{{ bundle_byob_max_picks }}</strong>{% endif %} to continue.
+  </p>
+</div>

package/modules/runwell-bundle-system/snippets/runwell-bundle-data.liquid

@@ -32,6 +32,14 @@
 {%- assign bundle_supplier_count = mf.bundle_supplier_count.value | default: 1 -%}
 {%- assign bundle_savings_pct_pre = mf.bundle_savings_pct.value -%}
 
+{%- comment -%} Mode C BYOB metafields (BS-201..BS-203). {%- endcomment -%}
+{%- assign bundle_byob_candidates = mf.bundle_byob_candidates.value -%}
+{%- assign bundle_byob_min_picks = mf.bundle_byob_min_picks.value | default: 1 -%}
+{%- assign bundle_byob_max_picks = mf.bundle_byob_max_picks.value | default: 3 -%}
+{%- assign bundle_byob_layout = mf.bundle_byob_layout.value | default: 'grid' -%}
+{%- assign bundle_byob_categories = mf.bundle_byob_categories.value -%}
+{%- assign bundle_byob_required_handles = mf.bundle_byob_required_handles.value -%}
+
 {%- comment -%} Compute subtotal for multi_product mode by walking components. {%- endcomment -%}
 {%- assign bundle_subtotal = 0 -%}
 {%- if bundle_components and bundle_components.size > 0 -%}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runwell/shopify-toolkit",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "description": "Reusable Shopify theme modules from Runwell. Replaces typically app-driven features (reviews, wishlist, urgency, FAQ, post-purchase upsell, exit popups, free-ship progress, sticky ATC, testimonials, badges, bundles) with native Liquid + JS + CSS that ship across multiple client themes via a config-driven sync CLI.",
   "type": "module",
   "main": "lib/index.js",