@runwell/shopify-toolkit 0.17.4 → 0.21.0

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

@@ -0,0 +1,121 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-collection.liquid.
+  Shared by Surface 1 (/bundles dedicated page, mode 'grid') and
+  Surface 6 (collection-page bundles filter chip, mode 'filter_chip').
+
+  Bundle detection: prefers products with the runwell.bundle_mode
+  metafield set; falls back to products tagged 'bundle'.
+
+  See _clients/capital-v/lushi/specs/bundle-system/spec.md sections 5, 8.1, 8.6.
+{%- endcomment -%}
+
+{%- assign mode = section.settings.mode | default: 'grid' -%}
+
+{%- comment -%} Build the bundles list from collection.products if present, otherwise scan all_products. {%- endcomment -%}
+{%- assign source_products = collection.products -%}
+{%- if source_products == blank or source_products.size == 0 -%}
+  {%- assign source_products = all_products -%}
+{%- endif -%}
+
+{%- assign bundles_meta = source_products | where: 'metafields.runwell.bundle_mode' -%}
+{%- assign bundles = bundles_meta -%}
+{%- if bundles == empty or bundles.size == 0 -%}
+  {%- assign bundles = source_products | where: 'tags', 'bundle' -%}
+{%- endif -%}
+
+{%- if mode == 'grid' -%}
+  {%- if settings.bundle_system__surface_1_collection_page_enabled == false -%}
+    {%- comment -%} Tenant has disabled the /bundles page surface. {%- endcomment -%}
+  {%- else -%}
+    <section
+      class="runwell-bundle-collection runwell-bundle-collection--grid color-{{ section.settings.color_scheme }}"
+      style="padding-top: {{ section.settings.padding_top }}px; padding-bottom: {{ section.settings.padding_bottom }}px;"
+    >
+      <div class="runwell-bundle-collection__inner page-width">
+        {%- if section.settings.show_heading -%}
+          <header class="runwell-bundle-collection__heading">
+            <h1 class="runwell-bundle-collection__title">{{ section.settings.title }}</h1>
+            {%- if section.settings.subline != blank -%}
+              <p class="runwell-bundle-collection__subline">{{ section.settings.subline }}</p>
+            {%- endif -%}
+          </header>
+        {%- endif -%}
+
+        <div class="runwell-bundle-collection__grid">
+          {%- for bundle_product in bundles -%}
+            {%- assign card_variant = 'default' -%}
+            {%- if forloop.first and section.settings.feature_first_bundle -%}
+              {%- assign card_variant = 'hero' -%}
+            {%- endif -%}
+            {% render 'runwell-bundle-card', bundle_product: bundle_product, variant: card_variant %}
+          {%- else -%}
+            <p class="runwell-bundle-collection__empty">
+              No bundles configured yet. Add the <code>bundle</code> tag to a product or set the <code>runwell.bundle_mode</code> metafield to surface it here.
+            </p>
+          {%- endfor -%}
+        </div>
+      </div>
+    </section>
+  {%- endif -%}
+
+{%- elsif mode == 'filter_chip' -%}
+  {%- if settings.bundle_system__surface_6_collection_filter_enabled == false -%}
+    {%- comment -%} Tenant has not enabled the collection-page filter surface. {%- endcomment -%}
+  {%- else -%}
+    {%- if bundles and bundles.size > 0 -%}
+      <section
+        class="runwell-bundle-collection runwell-bundle-collection--filter-chip"
+        data-bundle-handles="{%- for b in bundles -%}{{ b.handle }}{%- unless forloop.last -%},{%- endunless -%}{%- endfor -%}"
+      >
+        <button class="runwell-bundle-collection__chip" data-runwell-bundle-filter-chip aria-pressed="false">
+          {{ section.settings.chip_label | default: 'Bundles' }}
+          <span class="runwell-bundle-collection__chip-count">({{ bundles.size }})</span>
+        </button>
+        <div class="runwell-bundle-collection__pinned">
+          {%- for bundle_product in bundles limit: 2 -%}
+            {% render 'runwell-bundle-card', bundle_product: bundle_product, variant: 'compact' %}
+          {%- endfor -%}
+        </div>
+      </section>
+    {%- endif -%}
+  {%- endif -%}
+{%- endif -%}
+
+{{ 'runwell-bundle-system.css' | asset_url | stylesheet_tag }}
+<script src="{{ 'runwell-bundle-system.js' | asset_url }}" defer="defer"></script>
+
+{% schema %}
+{
+  "name": "Bundle collection",
+  "tag": "section",
+  "class": "section-runwell-bundle-collection",
+  "settings": [
+    {
+      "type": "select",
+      "id": "mode",
+      "label": "Layout mode",
+      "options": [
+        { "value": "grid", "label": "Grid (/bundles page)" },
+        { "value": "filter_chip", "label": "Filter chip (collection page)" }
+      ],
+      "default": "grid",
+      "info": "Grid: standalone /bundles page (Surface 1). Filter chip: pinned cards + filter on a collection page (Surface 6)."
+    },
+    { "type": "header", "content": "Grid mode" },
+    { "type": "checkbox", "id": "show_heading", "label": "Show page heading", "default": true },
+    { "type": "text", "id": "title", "label": "Heading", "default": "Bundles" },
+    { "type": "text", "id": "subline", "label": "Subline", "default": "Curated combinations, save more" },
+    { "type": "checkbox", "id": "feature_first_bundle", "label": "Feature first bundle as hero card", "default": true },
+    { "type": "header", "content": "Filter chip mode" },
+    { "type": "text", "id": "chip_label", "label": "Chip label", "default": "Bundles" },
+    { "type": "header", "content": "Layout" },
+    { "type": "color_scheme", "id": "color_scheme", "label": "Color scheme", "default": "scheme-1" },
+    { "type": "range", "id": "padding_top", "label": "Top padding", "min": 0, "max": 160, "step": 4, "default": 64, "unit": "px" },
+    { "type": "range", "id": "padding_bottom", "label": "Bottom padding", "min": 0, "max": 160, "step": 4, "default": 64, "unit": "px" }
+  ],
+  "presets": [
+    { "name": "Bundle: collection grid", "category": "Runwell", "settings": { "mode": "grid" } },
+    { "name": "Bundle: collection filter chip", "category": "Runwell", "settings": { "mode": "filter_chip" } }
+  ]
+}
+{% endschema %}

package/modules/runwell-bundle-system/sections/runwell-bundle-home-stacks.liquid

@@ -0,0 +1,77 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-home-stacks.liquid.
+  Surface 3: home page strip of 3 to 4 featured bundle cards. Editorial
+  pacing for new visitors. Merchant picks the bundles via a comma-
+  separated handle list; v1.5 can upgrade to a multi-product selector.
+
+  See _clients/capital-v/lushi/specs/bundle-system/spec.md sections 5, 8.3.
+{%- endcomment -%}
+
+{%- if settings.bundle_system__surface_3_home_stacks_enabled == false -%}
+  {%- comment -%} Tenant has disabled this surface. {%- endcomment -%}
+{%- else -%}
+  {%- assign picked_handles = section.settings.bundle_handles | split: ',' -%}
+  {%- assign rendered_count = 0 -%}
+
+  <section
+    class="runwell-bundle-home-stacks runwell-bundle-home-stacks--bg-{{ section.settings.bg_band }} color-{{ section.settings.color_scheme }}"
+    style="padding-top: {{ section.settings.padding_top }}px; padding-bottom: {{ section.settings.padding_bottom }}px;"
+  >
+    <div class="runwell-bundle-home-stacks__inner page-width">
+      <p class="runwell-bundle-home-stacks__eyebrow">{{ section.settings.eyebrow }}</p>
+      <h2 class="runwell-bundle-home-stacks__heading">{{ section.settings.heading }}</h2>
+      <div class="runwell-bundle-home-stacks__cards">
+        {%- for raw_handle in picked_handles limit: 4 -%}
+          {%- assign handle = raw_handle | strip -%}
+          {%- assign bundle_product = all_products[handle] -%}
+          {%- if bundle_product != blank -%}
+            {% render 'runwell-bundle-card', bundle_product: bundle_product, variant: 'default' %}
+            {%- assign rendered_count = rendered_count | plus: 1 -%}
+          {%- endif -%}
+        {%- endfor -%}
+        {%- if rendered_count == 0 -%}
+          <p class="runwell-bundle-home-stacks__empty">
+            Add bundle product handles in section settings to populate this strip.
+          </p>
+        {%- endif -%}
+      </div>
+    </div>
+  </section>
+
+  {{ 'runwell-bundle-system.css' | asset_url | stylesheet_tag }}
+{%- endif -%}
+
+{% schema %}
+{
+  "name": "Bundle stacks",
+  "tag": "section",
+  "class": "section-runwell-bundle-home-stacks",
+  "settings": [
+    { "type": "text", "id": "eyebrow", "label": "Eyebrow", "default": "Editor's picks" },
+    { "type": "text", "id": "heading", "label": "Heading", "default": "Curated stacks" },
+    {
+      "type": "textarea",
+      "id": "bundle_handles",
+      "label": "Bundle product handles (comma-separated, max 4)",
+      "info": "Example: morning-stack, recovery-stack, glow-stack"
+    },
+    {
+      "type": "select",
+      "id": "bg_band",
+      "label": "Background",
+      "options": [
+        { "value": "white", "label": "White" },
+        { "value": "oat", "label": "Oat" },
+        { "value": "celadon-tint", "label": "Celadon tint" }
+      ],
+      "default": "white"
+    },
+    { "type": "color_scheme", "id": "color_scheme", "label": "Color scheme", "default": "scheme-1" },
+    { "type": "range", "id": "padding_top", "label": "Top padding", "min": 0, "max": 160, "step": 4, "default": 64, "unit": "px" },
+    { "type": "range", "id": "padding_bottom", "label": "Bottom padding", "min": 0, "max": 160, "step": 4, "default": 64, "unit": "px" }
+  ],
+  "presets": [
+    { "name": "Bundle: curated stacks", "category": "Runwell" }
+  ]
+}
+{% endschema %}

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

@@ -0,0 +1,50 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-pdp-banner.liquid.
+  Surface 5: subtle single-line banner near the buy box on non-bundle
+  PDPs. "Save 17% when bundled. View bundle." Tap routes to the bundle
+  PDP. Picks the first matching bundle (highest savings_pct if multiple).
+
+  See _clients/capital-v/lushi/specs/bundle-system/spec.md sections 5, 8.5.
+{%- endcomment -%}
+
+{%- if settings.bundle_system__surface_5_pdp_banner_enabled == false -%}
+  {%- comment -%} Tenant has disabled this surface. {%- endcomment -%}
+{%- else -%}
+  {%- assign bundle_index = shop.metaobjects.bundle_index.entries.value -%}
+  {%- assign matching_handles = '' -%}
+  {%- if bundle_index and bundle_index.products -%}
+    {%- assign matching_handles = bundle_index.products[product.handle] -%}
+  {%- endif -%}
+
+  {%- if matching_handles and matching_handles.size > 0 -%}
+    {%- assign bundle_handle = matching_handles | first -%}
+    {%- assign bundle_product = all_products[bundle_handle] -%}
+    {%- if bundle_product != blank -%}
+      {%- assign savings_pct = bundle_product.metafields.runwell.bundle_savings_pct.value | default: 15 -%}
+      {%- assign savings_amount = 0 -%}
+      {%- assign template = section.settings.copy_template | default: settings.bundle_system__surface_5_copy_template | default: 'Save {savings_pct}% when bundled' -%}
+      {%- assign copy = template | replace: '{savings_pct}', savings_pct | replace: '{savings_amount}', savings_amount -%}
+
+      <a class="runwell-bundle-pdp-banner" href="{{ bundle_product.url }}" data-bundle-handle="{{ bundle_handle }}">
+        <span class="runwell-bundle-pdp-banner__copy">{{ copy }}</span>
+        <span class="runwell-bundle-pdp-banner__chevron" aria-hidden="true">&rsaquo;</span>
+      </a>
+
+      {{ 'runwell-bundle-system.css' | asset_url | stylesheet_tag }}
+    {%- endif -%}
+  {%- endif -%}
+{%- endif -%}
+
+{% schema %}
+{
+  "name": "Bundle banner",
+  "tag": "section",
+  "class": "section-runwell-bundle-pdp-banner",
+  "settings": [
+    { "type": "text", "id": "copy_template", "label": "Copy template", "default": "Save {savings_pct}% when bundled", "info": "Use {savings_pct} or {savings_amount} placeholders. Leave blank to use the site-wide default." }
+  ],
+  "presets": [
+    { "name": "Bundle: PDP banner", "category": "Runwell" }
+  ]
+}
+{% endschema %}

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

@@ -0,0 +1,72 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-pdp-pairs-with.liquid.
+  Surface 2: PDP "Pairs well with" widget. Renders 1 to N bundle cards
+  on non-bundle PDPs when the current product appears in at least one
+  bundle. Uses the bundle_index shop metaobject for fast reverse lookup
+  (one read).
+
+  Self-suppresses (renders nothing) if no bundles match.
+  See _clients/capital-v/lushi/specs/bundle-system/spec.md sections 5, 7.
+{%- endcomment -%}
+
+{%- if settings.bundle_system__surface_2_pdp_pairs_with_enabled == false -%}
+  {%- comment -%} Tenant has disabled this surface. {%- endcomment -%}
+{%- else -%}
+  {%- assign bundle_index = shop.metaobjects.bundle_index.entries.value -%}
+  {%- assign matching_handles = '' -%}
+  {%- if bundle_index and bundle_index.products -%}
+    {%- assign matching_handles = bundle_index.products[product.handle] -%}
+  {%- endif -%}
+
+  {%- if matching_handles and matching_handles.size > 0 -%}
+    <section
+      class="runwell-bundle-pdp-pairs-with color-{{ section.settings.color_scheme }}"
+      data-product-handle="{{ product.handle }}"
+      style="padding-top: {{ section.settings.padding_top }}px; padding-bottom: {{ section.settings.padding_bottom }}px;"
+    >
+      <div class="runwell-bundle-pdp-pairs-with__inner page-width">
+        <p class="runwell-bundle-pdp-pairs-with__eyebrow">{{ section.settings.eyebrow }}</p>
+        <h3 class="runwell-bundle-pdp-pairs-with__heading">{{ section.settings.heading }}</h3>
+        <div class="runwell-bundle-pdp-pairs-with__cards" data-runwell-card-scroll>
+          {%- assign max_cards = section.settings.max_cards | plus: 0 | default: 2 -%}
+          {%- for handle in matching_handles limit: max_cards -%}
+            {%- assign bundle_product = all_products[handle] -%}
+            {%- if bundle_product != blank -%}
+              {% render 'runwell-bundle-card', bundle_product: bundle_product, variant: 'compact' %}
+            {%- endif -%}
+          {%- endfor -%}
+        </div>
+      </div>
+    </section>
+
+    {{ 'runwell-bundle-system.css' | asset_url | stylesheet_tag }}
+  {%- endif -%}
+{%- endif -%}
+
+{% schema %}
+{
+  "name": "Bundle pairs-with",
+  "tag": "section",
+  "class": "section-runwell-bundle-pdp-pairs-with",
+  "settings": [
+    { "type": "text", "id": "eyebrow", "label": "Eyebrow", "default": "Pairs well with" },
+    { "type": "text", "id": "heading", "label": "Heading", "default": "Complete the routine" },
+    {
+      "type": "select",
+      "id": "max_cards",
+      "label": "Max bundle cards",
+      "options": [
+        { "value": "1", "label": "1" },
+        { "value": "2", "label": "2" }
+      ],
+      "default": "2"
+    },
+    { "type": "color_scheme", "id": "color_scheme", "label": "Color scheme", "default": "scheme-1" },
+    { "type": "range", "id": "padding_top", "label": "Top padding", "min": 0, "max": 100, "step": 4, "default": 32, "unit": "px" },
+    { "type": "range", "id": "padding_bottom", "label": "Bottom padding", "min": 0, "max": 100, "step": 4, "default": 32, "unit": "px" }
+  ],
+  "presets": [
+    { "name": "Bundle: pairs well with", "category": "Runwell" }
+  ]
+}
+{% endschema %}

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

@@ -0,0 +1,105 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-pdp.liquid.
+  Bundle PDP section. Used on templates/product.bundle.json (auto-assigned
+  to products with the runwell.bundle_mode metafield set). Routes to a
+  mode-specific snippet based on bundle_mode.
+
+  See _clients/capital-v/lushi/specs/bundle-system/spec.md sections 3, 5.
+{%- endcomment -%}
+
+{%- comment -%} v2: render runwell-subscription-picker here when bundle_subscription_enabled. Per BS-13 the subscription_* metafields ship in v1 inactive so v2 wires without a schema migration. {%- endcomment -%}
+
+{% render 'runwell-bundle-data', product: product %}
+
+<section
+  class="runwell-bundle-system runwell-bundle-system--mode-{{ bundle_mode | replace: '_', '-' }} color-{{ section.settings.color_scheme }}"
+  style="padding-top: {{ section.settings.padding_top }}px; padding-bottom: {{ section.settings.padding_bottom }}px;"
+>
+  <div class="runwell-bundle-system__inner page-width">
+    <div class="runwell-bundle-system__gallery">
+      {%- if product.featured_image -%}
+        {{ product.featured_image | image_url: width: 800 | image_tag:
+          loading: 'eager',
+          width: product.featured_image.width,
+          height: product.featured_image.height,
+          sizes: '(min-width: 1024px) 50vw, 100vw',
+          class: 'runwell-bundle-system__gallery-image'
+        }}
+      {%- endif -%}
+    </div>
+
+    <div class="runwell-bundle-system__details">
+      {%- if section.settings.sale_prefix != blank -%}
+        <p class="runwell-bundle-system__sale-prefix">{{ section.settings.sale_prefix }}</p>
+      {%- endif -%}
+
+      <h1 class="runwell-bundle-system__title">{{ product.title }}</h1>
+
+      {%- if product.description != blank -%}
+        <div class="runwell-bundle-system__description rte">{{ product.description }}</div>
+      {%- endif -%}
+
+      {%- if bundle_mode == 'quantity_tiers' -%}
+        {% render 'runwell-bundle-quantity-tiers',
+          product: product,
+          bundle_mode: bundle_mode,
+          bundle_pricing_model: bundle_pricing_model,
+          bundle_quantity_tiers: bundle_quantity_tiers,
+          section: section
+        %}
+      {%- elsif bundle_mode == 'multi_product' or bundle_mode == 'mix_match' -%}
+        {% render 'runwell-bundle-multi-product',
+          product: product,
+          bundle_mode: bundle_mode,
+          bundle_pricing_model: bundle_pricing_model,
+          bundle_components: bundle_components,
+          bundle_subtotal: bundle_subtotal,
+          bundle_price: bundle_price,
+          bundle_savings_amount: bundle_savings_amount,
+          bundle_savings_pct: bundle_savings_pct
+        %}
+      {%- endif -%}
+
+      {%- if bundle_fomo_mode != 'none' and bundle_fomo_mode != blank -%}
+        {% render 'runwell-bundle-fomo',
+          bundle_fomo_mode: bundle_fomo_mode,
+          bundle_fomo_cycle_days: bundle_fomo_cycle_days,
+          bundle_fomo_stock_count: bundle_fomo_stock_count
+        %}
+      {%- endif -%}
+
+      {%- if bundle_free_gift_enabled -%}
+        {% render 'runwell-bundle-free-gift',
+          bundle_free_gift_handle: bundle_free_gift_handle
+        %}
+      {%- endif -%}
+
+      {%- if bundle_cross_supplier and bundle_supplier_count > 1 -%}
+        {% render 'runwell-bundle-cross-supplier',
+          bundle_supplier_count: bundle_supplier_count
+        %}
+      {%- endif -%}
+    </div>
+  </div>
+</section>
+
+{{ 'runwell-bundle-system.css' | asset_url | stylesheet_tag }}
+<script src="{{ 'runwell-bundle-system.js' | asset_url }}" defer="defer"></script>
+
+{% schema %}
+{
+  "name": "Bundle PDP",
+  "tag": "section",
+  "class": "section-runwell-bundle-pdp",
+  "settings": [
+    { "type": "text", "id": "sale_prefix", "label": "Sale prefix (above title)", "default": "Limited time offer" },
+    { "type": "color_scheme", "id": "color_scheme", "label": "Color scheme", "default": "scheme-1" },
+    { "type": "range", "id": "padding_top", "label": "Top padding", "min": 0, "max": 100, "step": 4, "default": 40, "unit": "px" },
+    { "type": "range", "id": "padding_bottom", "label": "Bottom padding", "min": 0, "max": 100, "step": 4, "default": 40, "unit": "px" }
+  ],
+  "presets": [
+    { "name": "Bundle PDP", "category": "Runwell" }
+  ],
+  "templates": ["product.bundle"]
+}
+{% endschema %}

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

@@ -0,0 +1,25 @@
+{
+  "$comment": "Theme customizer settings patch. runwell-shopify sync appends this group to tenant config/settings_schema.json. Site-wide defaults; section-level overrides live in each section's schema.",
+  "spec_ref": "_clients/capital-v/lushi/specs/bundle-system/spec.md#10-settings-schema-for-theme-customizer",
+  "name": "Bundle system",
+  "settings": [
+    { "type": "header", "content": "Display surfaces" },
+    { "type": "checkbox", "id": "bundle_system__surface_1_collection_page_enabled", "label": "/bundles collection page", "default": true },
+    { "type": "checkbox", "id": "bundle_system__surface_2_pdp_pairs_with_enabled", "label": "PDP 'Pairs well with' widget", "default": true },
+    { "type": "checkbox", "id": "bundle_system__surface_3_home_stacks_enabled", "label": "Home page curated stacks", "default": true },
+    { "type": "checkbox", "id": "bundle_system__surface_4_cart_drawer_xsell_enabled", "label": "Cart drawer bundle cross-sell", "default": true },
+    { "type": "checkbox", "id": "bundle_system__surface_5_pdp_banner_enabled", "label": "PDP bundle banner", "default": true },
+    { "type": "checkbox", "id": "bundle_system__surface_6_collection_filter_enabled", "label": "Collection page bundles filter", "default": false },
+    { "type": "header", "content": "Default copy" },
+    { "type": "text", "id": "bundle_system__surface_2_eyebrow", "label": "Surface 2 eyebrow", "default": "Pairs well with" },
+    { "type": "text", "id": "bundle_system__surface_2_heading", "label": "Surface 2 heading", "default": "Complete the routine" },
+    { "type": "text", "id": "bundle_system__surface_3_eyebrow", "label": "Surface 3 eyebrow", "default": "Editor's picks" },
+    { "type": "text", "id": "bundle_system__surface_3_heading", "label": "Surface 3 heading", "default": "Curated stacks" },
+    { "type": "text", "id": "bundle_system__surface_4_eyebrow", "label": "Surface 4 eyebrow", "default": "Complete the stack" },
+    { "type": "text", "id": "bundle_system__surface_4_cta", "label": "Surface 4 CTA", "default": "Add bundle and save" },
+    { "type": "text", "id": "bundle_system__surface_5_copy_template", "label": "Surface 5 copy template", "default": "Save {savings_pct}% when bundled" },
+    { "type": "text", "id": "bundle_system__cross_supplier_disclosure", "label": "Cross-supplier disclosure", "default": "This bundle ships in {n} packages." },
+    { "type": "header", "content": "Layout" },
+    { "type": "range", "id": "bundle_system__home_strip_position", "label": "Home strip position (1-10)", "min": 1, "max": 10, "step": 1, "default": 3 }
+  ]
+}

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

@@ -0,0 +1,70 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-card.liquid.
+  Shared bundle card UI used by Surfaces 1, 2, 3, 4, 6.
+
+  Inputs:
+    bundle_product   (the bundle product to render; required)
+    variant          ('compact' | 'default' | 'hero'; default 'default')
+
+  Renders a self-contained card linking to /products/<bundle_handle>.
+  Loads the bundle's metafields locally via runwell-bundle-data so the
+  card has access to savings, supplier count, and component count.
+{%- endcomment -%}
+
+{%- if bundle_product != blank -%}
+  {%- assign card_variant = variant | default: 'default' -%}
+  {%- assign product = bundle_product -%}
+  {% render 'runwell-bundle-data', product: bundle_product %}
+  {%- assign component_count = 0 -%}
+  {%- if bundle_components and bundle_components.size > 0 -%}
+    {%- assign component_count = bundle_components.size -%}
+  {%- endif -%}
+
+  <a
+    href="{{ bundle_product.url }}"
+    class="runwell-bundle-card runwell-bundle-card--{{ card_variant }}"
+    data-bundle-handle="{{ bundle_product.handle }}"
+  >
+    <div class="runwell-bundle-card__media">
+      {%- if bundle_product.featured_image -%}
+        {{ bundle_product.featured_image | image_url: width: 600 | image_tag:
+          width: 300,
+          height: 300,
+          loading: 'lazy',
+          class: 'runwell-bundle-card__image',
+          alt: bundle_product.title,
+          sizes: '(min-width: 1024px) 25vw, 50vw'
+        }}
+      {%- endif -%}
+
+      {%- if bundle_savings_pct > 0 and card_variant != 'compact' -%}
+        <span class="runwell-bundle-card__badge">Save {{ bundle_savings_pct }}%</span>
+      {%- endif -%}
+    </div>
+
+    <div class="runwell-bundle-card__body">
+      <h3 class="runwell-bundle-card__title">{{ bundle_product.title }}</h3>
+
+      {%- if component_count > 0 and card_variant != 'compact' -%}
+        <p class="runwell-bundle-card__meta">
+          {{ component_count }}{% if component_count == 1 %} item{% else %} items{% endif %}
+          {%- if bundle_cross_supplier %} &middot; ships in {{ bundle_supplier_count }} packages{%- endif -%}
+        </p>
+      {%- endif -%}
+
+      <div class="runwell-bundle-card__price-row">
+        <span class="runwell-bundle-card__price">{{ bundle_price | money }}</span>
+        {%- if bundle_subtotal > bundle_price -%}
+          <span class="runwell-bundle-card__strikethrough">{{ bundle_subtotal | money }}</span>
+        {%- endif -%}
+        {%- if bundle_savings_pct > 0 and card_variant == 'compact' -%}
+          <span class="runwell-bundle-card__badge runwell-bundle-card__badge--inline">Save {{ bundle_savings_pct }}%</span>
+        {%- endif -%}
+      </div>
+
+      {%- if card_variant == 'hero' or card_variant == 'default' -%}
+        <span class="runwell-bundle-card__cta button button--secondary">View bundle</span>
+      {%- endif -%}
+    </div>
+  </a>
+{%- endif -%}

package/modules/runwell-bundle-system/snippets/runwell-bundle-cross-supplier.liquid

@@ -0,0 +1,18 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-cross-supplier.liquid.
+  Customer-facing disclosure when a bundle ships from multiple suppliers.
+  Copy template comes from the theme customizer setting
+  bundle_system__cross_supplier_disclosure (default: "This bundle ships
+  in {n} packages."), with {n} replaced by bundle_supplier_count.
+
+  Inputs:
+    bundle_supplier_count
+{%- endcomment -%}
+
+{%- assign template = settings.bundle_system__cross_supplier_disclosure | default: 'This bundle ships in {n} packages.' -%}
+{%- assign disclosure = template | replace: '{n}', bundle_supplier_count -%}
+
+<p class="runwell-bundle-system__cross-supplier" role="note">
+  <span class="runwell-bundle-system__cross-supplier-icon" aria-hidden="true">i</span>
+  <span class="runwell-bundle-system__cross-supplier-text">{{ disclosure }}</span>
+</p>

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

@@ -0,0 +1,67 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-data.liquid.
+  Single read point for all runwell.bundle_* product metafields. Other
+  snippets and sections read the bundle_* Liquid variables this snippet
+  emits. Liquid has no first-class object literal so we emit flat vars
+  (bundle_mode, bundle_quantity_tiers, etc.) into the parent scope.
+
+  Usage:
+    {% render 'runwell-bundle-data', product: product %}
+    {{ bundle_mode }}
+    {% for tier in bundle_quantity_tiers %} ... {% endfor %}
+
+  See _clients/capital-v/lushi/specs/bundle-system/spec.md sections 2.1-2.2.
+{%- endcomment -%}
+
+{%- assign mf = product.metafields.runwell -%}
+
+{%- assign bundle_mode = mf.bundle_mode.value | default: 'multi_product' -%}
+{%- assign bundle_pricing_model = mf.bundle_pricing_model.value | default: 'fixed_price' -%}
+{%- assign bundle_pricing_value = mf.bundle_pricing_value.value -%}
+{%- assign bundle_components = mf.bundle_components.value -%}
+{%- assign bundle_quantity_tiers = mf.bundle_quantity_tiers.value -%}
+{%- assign bundle_show_in_catalog = mf.bundle_show_in_catalog.value | default: true -%}
+{%- assign bundle_surfaces_enabled = mf.bundle_surfaces_enabled.value -%}
+{%- assign bundle_copy = mf.bundle_copy.value -%}
+{%- assign bundle_free_gift_enabled = mf.bundle_free_gift_enabled.value | default: false -%}
+{%- assign bundle_free_gift_handle = mf.bundle_free_gift_handle.value | default: '' -%}
+{%- assign bundle_fomo_mode = mf.bundle_fomo_mode.value | default: 'none' -%}
+{%- assign bundle_fomo_cycle_days = mf.bundle_fomo_cycle_days.value | default: 30 -%}
+{%- assign bundle_fomo_stock_count = mf.bundle_fomo_stock_count.value | default: 0 -%}
+{%- assign bundle_cross_supplier = mf.bundle_cross_supplier.value | default: false -%}
+{%- assign bundle_supplier_count = mf.bundle_supplier_count.value | default: 1 -%}
+{%- assign bundle_savings_pct_pre = mf.bundle_savings_pct.value -%}
+
+{%- comment -%} Compute subtotal for multi_product mode by walking components. {%- endcomment -%}
+{%- assign bundle_subtotal = 0 -%}
+{%- if bundle_components and bundle_components.size > 0 -%}
+  {%- for c in bundle_components -%}
+    {%- assign comp_product = all_products[c.product_handle] -%}
+    {%- assign comp_qty = c.qty | default: 1 -%}
+    {%- assign comp_line = comp_product.price | times: comp_qty -%}
+    {%- assign bundle_subtotal = bundle_subtotal | plus: comp_line -%}
+  {%- endfor -%}
+{%- endif -%}
+
+{%- assign bundle_price = product.price -%}
+{%- assign bundle_savings_amount = 0 -%}
+{%- if bundle_subtotal > bundle_price -%}
+  {%- assign bundle_savings_amount = bundle_subtotal | minus: bundle_price -%}
+{%- endif -%}
+
+{%- assign bundle_savings_pct = 0 -%}
+{%- if bundle_savings_pct_pre -%}
+  {%- assign bundle_savings_pct = bundle_savings_pct_pre -%}
+{%- elsif bundle_subtotal > 0 -%}
+  {%- assign bundle_savings_pct = bundle_savings_amount | times: 100 | divided_by: bundle_subtotal -%}
+{%- endif -%}
+
+{%- comment -%}
+  v2 only fields (BS-13). Parsed but unused in v1.
+    bundle_subscription_enabled, bundle_subscription_interval,
+    bundle_subscription_discount_pct, bundle_subscription_badge_copy.
+{%- endcomment -%}
+{%- assign bundle_subscription_enabled = mf.subscription_enabled.value | default: false -%}
+{%- assign bundle_subscription_interval = mf.subscription_interval.value -%}
+{%- assign bundle_subscription_discount_pct = mf.subscription_discount_pct.value -%}
+{%- assign bundle_subscription_badge_copy = mf.subscription_badge_copy.value | default: '' -%}

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

@@ -0,0 +1,32 @@
+{%- comment -%}
+  runwell-bundle-system: runwell-bundle-fomo.liquid.
+  Countdown ("ends in N days") and scarcity ("X left") strip. Mode driven
+  by bundle_fomo_mode metafield: 'discount' | 'scarcity' | 'both' | 'none'.
+
+  Inputs:
+    bundle_fomo_mode
+    bundle_fomo_cycle_days
+    bundle_fomo_stock_count
+{%- endcomment -%}
+
+<div
+  class="runwell-bundle-system__fomo"
+  data-runwell-fomo
+  data-fomo-mode="{{ bundle_fomo_mode }}"
+  data-fomo-cycle-days="{{ bundle_fomo_cycle_days }}"
+>
+  {%- if bundle_fomo_mode == 'discount' or bundle_fomo_mode == 'both' -%}
+    <p class="runwell-bundle-system__fomo-countdown">
+      <span class="runwell-bundle-system__fomo-label">Offer ends in</span>
+      <span class="runwell-bundle-system__fomo-time" data-runwell-fomo-time>...</span>
+    </p>
+  {%- endif -%}
+
+  {%- if bundle_fomo_mode == 'scarcity' or bundle_fomo_mode == 'both' -%}
+    {%- if bundle_fomo_stock_count > 0 -%}
+      <p class="runwell-bundle-system__fomo-scarcity">
+        Only <strong>{{ bundle_fomo_stock_count }}</strong> left at this price.
+      </p>
+    {%- endif -%}
+  {%- endif -%}
+</div>