astro-component-kit 0.3.1 → 0.4.1

package/src/components/lib/sections/ShopLookbook.astro

@@ -0,0 +1,250 @@
+---
+/**
+ * ShopLookbook — "Shop the look": a large editorial image with numbered hotspots. Each hotspot
+ * opens a small product card (name, price, link and add to bag) and highlights it in the side list.
+ *
+ * @param {string} eyebrow - Small label. Default 'Lookbook'.
+ * @param {string} title - Heading (use *asterisks* for italics). Default 'Shop the *look*'.
+ * @param {string} text - Intro copy.
+ * @param {{icon?: string, hue?: number, image?: string, alt?: string}} media - Scene visual.
+ * @param {Array<{x: number, y: number, product: Product, href?: string}>} spots - Hotspots; x/y in % of the image.
+ * @param {string} currency - ISO currency. Default 'EUR'.
+ * @param {string} locale - Number format locale. Default 'en-GB'.
+ * @param {string} cartKey - Cart storage key. Default 'ack-cart'.
+ * @param {string} variant - Layout (image-left|image-right). Default 'image-left'.
+ * @param {string} id - Base id. Default 'lookbook'.
+ * @param {string} className - Extra class.
+ *
+ * Accessibility: hotspots are buttons with full labels and aria-expanded; the same products are
+ * listed as plain links next to the image, so the look is usable without the hotspots.
+ */
+import ProductMedia from '../ecommerce/ProductMedia.astro';
+import { formatMoney } from '../ecommerce/cart-store';
+import type { Product } from '../ecommerce/types';
+
+interface Spot { x: number; y: number; product: Product; href?: string }
+interface Props {
+  eyebrow?: string;
+  title?: string;
+  text?: string;
+  media?: { icon?: string; hue?: number; image?: string; alt?: string };
+  spots?: Spot[];
+  currency?: string;
+  locale?: string;
+  cartKey?: string;
+  variant?: 'image-left' | 'image-right';
+  id?: string;
+  className?: string;
+}
+
+const {
+  eyebrow = 'Lookbook',
+  title = 'Shop the *look*',
+  text = 'A Sunday uniform: a soft overshirt, a tote that goes everywhere and the mug that starts the day.',
+  media = { icon: 'jacket', hue: 22 },
+  spots = [
+    { x: 38, y: 34, product: { slug: 'linen-overshirt', name: 'Linen Overshirt', price: 145, category: 'clothing', icon: 'shirt', hue: 30 } },
+    { x: 66, y: 62, product: { slug: 'field-tote', name: 'Field Tote', price: 120, category: 'bags', icon: 'bag', hue: 18 } },
+    { x: 24, y: 76, product: { slug: 'kiln-mug', name: 'Kiln Mug', price: 32, category: 'objects', icon: 'mug', hue: 14 } },
+  ],
+  currency = 'EUR',
+  locale = 'en-GB',
+  cartKey = 'ack-cart',
+  variant = 'image-left',
+  id = 'lookbook',
+  className = '',
+} = Astro.props;
+
+const money = { currency, locale };
+const parts = title.split(/\*(.+?)\*/g);
+const total = spots.reduce((n, s) => n + s.product.price, 0);
+---
+
+<div class="slb-cq">
+<section class:list={['slb', `slb--${variant}`, className]} data-lookbook>
+  <div class="slb__stage">
+    <ProductMedia image={media.image} alt={media.alt ?? ''} icon={media.icon} hue={media.hue} ratio="4 / 5" variant="soft" size="lg" />
+    {spots.map((s, i) => (
+      <div class="slb__spot" style={`left: ${s.x}%; top: ${s.y}%`}>
+        <button
+          type="button"
+          class="slb__dot"
+          aria-expanded="false"
+          aria-controls={`${id}-pop-${i}`}
+          aria-label={`${i + 1}: ${s.product.name}, ${formatMoney(s.product.price, money)}`}
+          data-spot={i}
+        >{i + 1}</button>
+        <div class:list={['slb__pop', { 'slb__pop--left': s.x > 60 }]} id={`${id}-pop-${i}`} hidden data-pop>
+          <p class="slb__pop-name">{s.product.name}</p>
+          <p class="slb__pop-price">{formatMoney(s.product.price, money)}</p>
+          <div class="slb__pop-actions">
+            <a href={s.href ?? '#'}>View</a>
+            <button
+              type="button"
+              data-add-to-cart={JSON.stringify({ id: s.product.slug, name: s.product.name, price: s.product.price, icon: s.product.icon, hue: s.product.hue, variant: s.product.colors?.[0]?.name })}
+              data-cart-key={cartKey}
+              data-open-cart="false"
+              data-added-label="Added"
+            ><span data-label>Add to bag</span></button>
+          </div>
+        </div>
+      </div>
+    ))}
+  </div>
+
+  <div class="slb__copy">
+    {eyebrow && <p class="slb__eyebrow">{eyebrow}</p>}
+    <h2 class="slb__title">{parts.map((p, i) => (i % 2 ? <em>{p}</em> : p))}</h2>
+    {text && <p class="slb__text">{text}</p>}
+    <ol class="slb__list">
+      {spots.map((s, i) => (
+        <li class="slb__row" data-row={i}>
+          <span class="slb__row-num" aria-hidden="true">{String(i + 1).padStart(2, '0')}</span>
+          <a class="slb__row-name" href={s.href ?? '#'}>{s.product.name}</a>
+          <span class="slb__row-price">{formatMoney(s.product.price, money)}</span>
+        </li>
+      ))}
+    </ol>
+    <p class="slb__total"><span>The complete look</span><strong>{formatMoney(total, money)}</strong></p>
+  </div>
+</section>
+</div>
+
+<script>
+  import { bindAddToCart } from '../ecommerce/cart-store';
+  bindAddToCart(document);
+
+  document.querySelectorAll<HTMLElement>('[data-lookbook]:not([data-bound])').forEach((lb) => {
+    lb.dataset.bound = '';
+    const dots = Array.from(lb.querySelectorAll<HTMLButtonElement>('[data-spot]'));
+    const rows = Array.from(lb.querySelectorAll<HTMLElement>('[data-row]'));
+    const close = () => {
+      dots.forEach((d) => {
+        d.setAttribute('aria-expanded', 'false');
+        const p = document.getElementById(d.getAttribute('aria-controls') || '');
+        if (p) p.hidden = true;
+      });
+      rows.forEach((r) => r.classList.remove('is-active'));
+    };
+    dots.forEach((d, i) => {
+      d.addEventListener('click', (e) => {
+        e.stopPropagation();
+        const open = d.getAttribute('aria-expanded') !== 'true';
+        close();
+        if (!open) return;
+        d.setAttribute('aria-expanded', 'true');
+        const p = document.getElementById(d.getAttribute('aria-controls') || '');
+        if (p) p.hidden = false;
+        rows[i]?.classList.add('is-active');
+      });
+      rows[i]?.addEventListener('mouseenter', () => d.classList.add('is-hint'));
+      rows[i]?.addEventListener('mouseleave', () => d.classList.remove('is-hint'));
+    });
+    document.addEventListener('click', (e) => { if (!lb.contains(e.target as Node)) close(); });
+    lb.addEventListener('keydown', (e) => {
+      if (e.key !== 'Escape') return;
+      const open = dots.find((d) => d.getAttribute('aria-expanded') === 'true');
+      close();
+      open?.focus();
+    });
+  });
+</script>
+
+<style>
+  .slb-cq { container-type: inline-size; }
+  .slb {
+    display: grid;
+    grid-template-columns: minmax(0, 1.1fr) minmax(0, 0.9fr);
+    gap: clamp(1.5rem, 5vw, 5rem);
+    align-items: center;
+    color: var(--c-text-1, #fff);
+  }
+  .slb--image-right .slb__stage { order: 2; }
+  .slb__stage { position: relative; border-radius: var(--r-sm, 2px); }
+  .slb__stage > :global(.p-media) { border-radius: var(--r-sm, 2px); }
+  .slb__spot { position: absolute; z-index: 2; transform: translate(-50%, -50%); }
+  .slb__dot {
+    position: relative;
+    display: grid;
+    place-items: center;
+    width: 40px;
+    height: 40px;
+    border: 0;
+    border-radius: 50%;
+    background: var(--c-text-1, #fff);
+    color: var(--c-bg, #050505);
+    font: inherit;
+    font-size: 0.8rem;
+    font-weight: 700;
+    cursor: pointer;
+    box-shadow: 0 10px 30px -8px rgba(0, 0, 0, 0.6);
+    transition: transform 0.2s ease, background 0.2s ease, color 0.2s ease;
+  }
+  .slb__dot::before { content: ''; position: absolute; inset: -6px; border-radius: 50%; border: 1px solid var(--c-text-1, #fff); opacity: 0.6; animation: slb-ring 2.4s ease-out infinite; }
+  .slb__dot:hover, .slb__dot.is-hint, .slb__dot[aria-expanded='true'] { transform: scale(1.12); background: var(--shop-accent, var(--c-primary-light, #d4a017)); color: var(--c-on-primary, #050505); }
+  @keyframes slb-ring { 0% { transform: scale(0.8); opacity: 0.7; } 100% { transform: scale(1.5); opacity: 0; } }
+
+  .slb__pop {
+    position: absolute;
+    top: 50%;
+    left: calc(100% + 12px);
+    width: 220px;
+    padding: var(--sp-4, 1rem);
+    transform: translateY(-50%);
+    background: var(--c-bg-1, #0a0a0a);
+    border: 1px solid var(--c-border, rgba(255, 255, 255, 0.12));
+    box-shadow: 0 24px 50px -20px rgba(0, 0, 0, 0.6);
+    animation: slb-pop 0.2s ease-out;
+  }
+  .slb__pop--left { left: auto; right: calc(100% + 12px); }
+  .slb__pop[hidden] { display: none; }
+  @keyframes slb-pop { from { opacity: 0; transform: translateY(-46%); } }
+  .slb__pop-name { margin: 0; font-family: var(--font-display, Georgia, serif); font-size: 1.05rem; }
+  .slb__pop-price { margin: 2px 0 var(--sp-3, 0.75rem); font-size: 0.85rem; color: var(--c-text-2, #a3a3a3); }
+  .slb__pop-actions { display: flex; gap: var(--sp-2, 0.5rem); }
+  .slb__pop-actions a, .slb__pop-actions button {
+    flex: 1;
+    display: inline-grid;
+    place-items: center;
+    min-height: 40px;
+    border: 1px solid var(--c-text-1, #fff);
+    border-radius: var(--r-sm, 2px);
+    background: transparent;
+    color: var(--c-text-1, #fff);
+    font: inherit;
+    font-size: 0.75rem;
+    font-weight: 600;
+    letter-spacing: 0.06em;
+    text-transform: uppercase;
+    text-decoration: none;
+    cursor: pointer;
+  }
+  .slb__pop-actions button { background: var(--c-text-1, #fff); color: var(--c-bg, #050505); }
+  .slb__pop-actions button.is-added { background: var(--shop-accent, var(--c-primary-light, #d4a017)); border-color: transparent; color: var(--c-on-primary, #050505); }
+  .slb :is(a, button):focus-visible { outline: 2px solid var(--shop-accent, var(--c-primary-light, #d4a017)); outline-offset: 3px; }
+
+  .slb__eyebrow { margin: 0 0 var(--sp-3, 0.75rem); font-size: 0.72rem; font-weight: 600; letter-spacing: 0.16em; text-transform: uppercase; color: var(--c-text-2, #a3a3a3); }
+  .slb__title { margin: 0; font-family: var(--font-display, Georgia, 'Times New Roman', serif); font-size: clamp(2.4rem, 5.5vw, 4.5rem); font-weight: 400; letter-spacing: -0.04em; line-height: 0.95; }
+  .slb__title em { font-style: italic; color: var(--shop-accent, var(--c-primary-light, #d4a017)); }
+  .slb__text { max-width: 28rem; margin: var(--sp-5, 1.25rem) 0 0; line-height: 1.65; color: var(--c-text-2, #a3a3a3); }
+  .slb__list { margin: var(--sp-8, 2rem) 0 0; padding: 0; list-style: none; border-top: 1px solid var(--c-border, rgba(255, 255, 255, 0.12)); }
+  .slb__row { display: grid; grid-template-columns: 40px 1fr auto; align-items: center; gap: var(--sp-3, 0.75rem); min-height: 56px; border-bottom: 1px solid var(--c-border, rgba(255, 255, 255, 0.12)); transition: background 0.2s ease, padding 0.2s ease; }
+  .slb__row.is-active { background: rgb(var(--ink-rgb, 255 255 255) / 0.05); padding-inline: var(--sp-2, 0.5rem); }
+  .slb__row-num { font-size: 0.75rem; color: var(--c-text-2, #a3a3a3); font-variant-numeric: tabular-nums; }
+  .slb__row-name { font-family: var(--font-display, Georgia, serif); font-size: 1.15rem; color: inherit; text-decoration: none; }
+  .slb__row-name:hover { color: var(--shop-accent, var(--c-primary-light, #d4a017)); }
+  .slb__row-price { font-variant-numeric: tabular-nums; }
+  .slb__total { display: flex; justify-content: space-between; margin: var(--sp-4, 1rem) 0 0; font-size: 0.85rem; color: var(--c-text-2, #a3a3a3); }
+  .slb__total strong { font-size: 1.1rem; color: var(--c-text-1, #fff); }
+
+  @container (max-width: 860px) {
+    .slb { grid-template-columns: 1fr; }
+    .slb--image-right .slb__stage { order: 0; }
+    .slb__pop { left: 50%; top: calc(100% + 10px); transform: translateX(-50%); width: 200px; }
+    .slb__pop--left { right: auto; left: 50%; }
+    @keyframes slb-pop { from { opacity: 0; } }
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .slb__dot::before, .slb__pop { animation: none; }
+  }
+</style>

package/src/components/lib/sections/ShopNewsletterEditorial.astro

@@ -0,0 +1,128 @@
+---
+/**
+ * ShopNewsletterEditorial — Oversized editorial sign-up: large serif statement on one side,
+ * underline-style email field, consent note and inline success/error messages on the other.
+ *
+ * @param {string} title - Statement (use *asterisks* for italics). Default 'Letters from the *studio*'.
+ * @param {string} text - Supporting copy.
+ * @param {string} action - Form action. With '#' the form validates and confirms locally. Default '#'.
+ * @param {string} buttonLabel - Submit label. Default 'Subscribe'.
+ * @param {string} consent - Small print under the field.
+ * @param {string} successText - Message after a valid submit.
+ * @param {string} variant - Style (plain|inverted|accent). Default 'plain'.
+ * @param {string} size - Type scale (sm|md|lg). Default 'md'.
+ * @param {string} id - Base id. Default 'shop-news'.
+ * @param {string} className - Extra class.
+ *
+ * Accessibility: labelled email input with autocomplete, aria-invalid + described error,
+ * messages in a polite live region.
+ */
+interface Props {
+  title?: string;
+  text?: string;
+  action?: string;
+  buttonLabel?: string;
+  consent?: string;
+  successText?: string;
+  variant?: 'plain' | 'inverted' | 'accent';
+  size?: 'sm' | 'md' | 'lg';
+  id?: string;
+  className?: string;
+}
+
+const {
+  title = 'Letters from the *studio*',
+  text = 'One email a month: new pieces before anyone else, the people who make them, and 10% off your first order.',
+  action = '#',
+  buttonLabel = 'Subscribe',
+  consent = 'By subscribing you accept our privacy policy. Unsubscribe in one click.',
+  successText = 'Thank you — your first letter is on its way.',
+  variant = 'plain',
+  size = 'md',
+  id = 'shop-news',
+  className = '',
+} = Astro.props;
+
+const parts = title.split(/\*(.+?)\*/g);
+---
+
+<div class="sne-cq">
+<section class:list={['sne', `sne--${variant}`, `sne--${size}`, className]} aria-labelledby={`${id}-title`}>
+  <h2 class="sne__title" id={`${id}-title`}>{parts.map((p, i) => (i % 2 ? <em>{p}</em> : p))}</h2>
+  <div class="sne__side">
+    {text && <p class="sne__text">{text}</p>}
+    <form class="sne__form" action={action} method="post" novalidate data-news data-success={successText}>
+      <label class="sne__label" for={`${id}-email`}>Email address</label>
+      <div class="sne__field">
+        <input id={`${id}-email`} name="email" type="email" required autocomplete="email" placeholder="you@example.com" aria-describedby={`${id}-msg`} />
+        <button type="submit">{buttonLabel} <span aria-hidden="true">→</span></button>
+      </div>
+      <p class="sne__msg" id={`${id}-msg`} aria-live="polite" data-msg></p>
+      {consent && <p class="sne__consent">{consent}</p>}
+    </form>
+  </div>
+</section>
+</div>
+
+<script>
+  document.querySelectorAll<HTMLFormElement>('form[data-news]:not([data-bound])').forEach((form) => {
+    form.dataset.bound = '';
+    const input = form.querySelector<HTMLInputElement>('input[type="email"]')!;
+    const msg = form.querySelector<HTMLElement>('[data-msg]')!;
+    form.addEventListener('submit', (e) => {
+      const local = form.getAttribute('action') === '#';
+      if (!input.checkValidity()) {
+        e.preventDefault();
+        input.setAttribute('aria-invalid', 'true');
+        msg.dataset.state = 'error';
+        msg.textContent = 'Please enter a valid email address.';
+        input.focus();
+        return;
+      }
+      input.removeAttribute('aria-invalid');
+      if (local) {
+        e.preventDefault();
+        msg.dataset.state = 'ok';
+        msg.textContent = form.dataset.success || 'Subscribed.';
+        form.reset();
+      }
+    });
+  });
+</script>
+
+<style>
+  .sne-cq { container-type: inline-size; }
+  .sne {
+    display: grid;
+    grid-template-columns: minmax(0, 1.2fr) minmax(0, 0.8fr);
+    gap: clamp(1.5rem, 5vw, 5rem);
+    align-items: end;
+    padding: clamp(2.5rem, 6vw, 5rem) clamp(1rem, 3vw, 2.5rem);
+    color: var(--c-text-1, #fff);
+  }
+  .sne--inverted { background: var(--c-text-1, #fff); color: var(--c-bg, #050505); }
+  .sne--accent { background: var(--shop-accent, var(--c-primary-light, #d4a017)); color: var(--c-on-primary, #050505); }
+  .sne__title { margin: 0; font-family: var(--font-display, Georgia, 'Times New Roman', serif); font-size: clamp(2.6rem, 7vw, 6.5rem); font-weight: 400; letter-spacing: -0.045em; line-height: 0.92; text-wrap: balance; }
+  .sne--sm .sne__title { font-size: clamp(2rem, 5vw, 4rem); }
+  .sne--lg .sne__title { font-size: clamp(3rem, 9vw, 8.5rem); }
+  .sne__title em { font-style: italic; color: var(--shop-accent, var(--c-primary-light, #d4a017)); }
+  .sne--accent .sne__title em { color: inherit; text-decoration: underline; text-decoration-thickness: 2px; text-underline-offset: 0.12em; }
+  .sne__text { margin: 0 0 var(--sp-6, 1.5rem); max-width: 26rem; line-height: 1.65; opacity: 0.8; }
+  .sne__label { display: block; margin-bottom: var(--sp-2, 0.5rem); font-size: 0.72rem; font-weight: 600; letter-spacing: 0.14em; text-transform: uppercase; opacity: 0.75; }
+  .sne__field { display: flex; align-items: stretch; border-bottom: 1.5px solid currentColor; }
+  .sne__field input { flex: 1; min-width: 0; min-height: 56px; padding: 0; border: 0; background: transparent; color: inherit; font: inherit; font-size: 1.15rem; outline: none; }
+  .sne__field input::placeholder { color: currentColor; opacity: 0.45; }
+  .sne__field input[aria-invalid='true'] { color: var(--c-danger, #f87171); }
+  .sne__field button { display: inline-flex; align-items: center; gap: 0.5rem; padding: 0 0 0 var(--sp-4, 1rem); border: 0; background: none; color: inherit; font: inherit; font-size: 0.85rem; font-weight: 700; letter-spacing: 0.08em; text-transform: uppercase; cursor: pointer; }
+  .sne__field button:hover { color: var(--shop-accent, var(--c-primary-light, #d4a017)); }
+  .sne--accent .sne__field button:hover { color: inherit; text-decoration: underline; }
+  .sne__field:focus-within { border-bottom-width: 2.5px; }
+  .sne__field button:focus-visible { outline: 2px solid currentColor; outline-offset: 2px; }
+  .sne__msg { min-height: 1.4em; margin: var(--sp-2, 0.5rem) 0 0; font-size: 0.85rem; }
+  .sne__msg[data-state='error'] { color: var(--c-danger, #f87171); }
+  .sne__msg[data-state='ok'] { color: var(--c-success, #34d399); }
+  .sne--accent .sne__msg, .sne--inverted .sne__msg { color: inherit; font-weight: 600; }
+  .sne__consent { margin: var(--sp-2, 0.5rem) 0 0; font-size: 0.75rem; opacity: 0.6; }
+
+  @container (max-width: 860px) { .sne { grid-template-columns: 1fr; } }
+</style>

package/src/components/lib/sections/ShopProductRail.astro

@@ -0,0 +1,150 @@
+---
+/**
+ * ShopProductRail — Horizontal, scroll-snapping product carousel of ProductCardMinimal cards with
+ * numbered items, prev/next buttons and a progress line.
+ *
+ * @param {string} eyebrow - Small label. Default 'Just in'.
+ * @param {string} title - Heading. Default 'New this *week*'.
+ * @param {Product[]} products - Products to show.
+ * @param {string} productBase - Product URL prefix (`${productBase}${slug}/`). Default '#'.
+ * @param {{label: string, href: string}} link - "View all" link (optional).
+ * @param {boolean} numbered - Show "N° 01" on cards. Default true.
+ * @param {string} currency - ISO currency. Default 'EUR'.
+ * @param {string} locale - Number format locale. Default 'en-GB'.
+ * @param {string} cartKey - Cart storage key. Default 'ack-cart'.
+ * @param {string} id - Rail id (unique per page). Default 'product-rail'.
+ * @param {string} size - Card width (sm|md|lg). Default 'md'.
+ * @param {string} className - Extra class.
+ *
+ * Accessibility: the rail is a labelled region (role="region") scrollable with keyboard;
+ * buttons have labels and disable at the ends; snapping is disabled with reduced motion.
+ */
+import ProductCardMinimal from '../ecommerce/ProductCardMinimal.astro';
+import type { Product } from '../ecommerce/types';
+
+interface Props {
+  eyebrow?: string;
+  title?: string;
+  products?: Product[];
+  productBase?: string;
+  link?: { label: string; href: string };
+  numbered?: boolean;
+  currency?: string;
+  locale?: string;
+  cartKey?: string;
+  id?: string;
+  size?: 'sm' | 'md' | 'lg';
+  className?: string;
+}
+
+const {
+  eyebrow = 'Just in',
+  title = 'New this *week*',
+  products = [
+    { slug: 'linen-overshirt', name: 'Linen Overshirt', price: 145, category: 'clothing', badge: 'New', sizes: ['S', 'M', 'L'], colors: [{ name: 'Oat', hex: '#d9cbb3' }, { name: 'Ink', hex: '#22252b' }], icon: 'shirt', hue: 30 },
+    { slug: 'merino-crew', name: 'Merino Crew Knit', price: 160, category: 'clothing', sizes: ['S', 'M', 'L'], colors: [{ name: 'Sage', hex: '#8a9a7b' }], icon: 'jacket', hue: 95 },
+    { slug: 'field-tote', name: 'Field Tote', price: 120, category: 'bags', colors: [{ name: 'Rust', hex: '#9c3d1c' }], icon: 'bag', hue: 18 },
+    { slug: 'ash-vase', name: 'Ash Vase', price: 68, category: 'objects', icon: 'bottle', hue: 40 },
+    { slug: 'dune-loafer', name: 'Dune Loafer', price: 210, category: 'shoes', sizes: ['39', '40', '41', '42'], icon: 'sneaker', hue: 28 },
+  ],
+  productBase = '#',
+  link = { label: 'View all', href: '#' },
+  numbered = true,
+  currency = 'EUR',
+  locale = 'en-GB',
+  cartKey = 'ack-cart',
+  id = 'product-rail',
+  size = 'md',
+  className = '',
+} = Astro.props;
+
+const parts = title.split(/\*(.+?)\*/g);
+const plainTitle = title.replace(/\*/g, '');
+const hrefFor = (slug: string) => (productBase === '#' ? '#' : `${productBase}${slug}/`);
+---
+
+<section class:list={['spr', `spr--${size}`, className]} data-rail>
+  <header class="spr__head">
+    <div>
+      {eyebrow && <p class="spr__eyebrow">{eyebrow}</p>}
+      <h2 class="spr__title">{parts.map((p, i) => (i % 2 ? <em>{p}</em> : p))}</h2>
+    </div>
+    <div class="spr__controls">
+      {link && <a class="spr__all" href={link.href}>{link.label}</a>}
+      <button type="button" class="spr__arrow" aria-label="Previous products" aria-controls={id} data-prev>←</button>
+      <button type="button" class="spr__arrow" aria-label="Next products" aria-controls={id} data-next>→</button>
+    </div>
+  </header>
+  <ul class="spr__track" id={id} role="region" aria-label={plainTitle} tabindex="0" data-track>
+    {products.map((p, i) => (
+      <li class="spr__slide">
+        <ProductCardMinimal product={p} href={hrefFor(p.slug)} index={numbered ? i + 1 : undefined} currency={currency} locale={locale} cartKey={cartKey} />
+      </li>
+    ))}
+  </ul>
+  <div class="spr__progress" aria-hidden="true"><span data-progress></span></div>
+</section>
+
+<script>
+  document.querySelectorAll<HTMLElement>('[data-rail]:not([data-bound])').forEach((rail) => {
+    rail.dataset.bound = '';
+    const track = rail.querySelector<HTMLElement>('[data-track]')!;
+    const prev = rail.querySelector<HTMLButtonElement>('[data-prev]')!;
+    const next = rail.querySelector<HTMLButtonElement>('[data-next]')!;
+    const bar = rail.querySelector<HTMLElement>('[data-progress]')!;
+    const step = () => (track.querySelector<HTMLElement>('.spr__slide')?.offsetWidth ?? 300) + 16;
+    const reduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+    const update = () => {
+      const max = track.scrollWidth - track.clientWidth;
+      prev.disabled = track.scrollLeft <= 2;
+      next.disabled = track.scrollLeft >= max - 2;
+      const visible = track.clientWidth / track.scrollWidth;
+      bar.style.width = `${Math.max(10, visible * 100)}%`;
+      bar.style.transform = `translateX(${max > 0 ? (track.scrollLeft / max) * ((1 / Math.max(visible, 0.1)) - 1) * 100 : 0}%)`;
+    };
+    prev.addEventListener('click', () => track.scrollBy({ left: -step(), behavior: reduced ? 'auto' : 'smooth' }));
+    next.addEventListener('click', () => track.scrollBy({ left: step(), behavior: reduced ? 'auto' : 'smooth' }));
+    track.addEventListener('scroll', update, { passive: true });
+    window.addEventListener('resize', update);
+    update();
+  });
+</script>
+
+<style>
+  .spr { container-type: inline-size; --slide-w: clamp(220px, 24vw, 320px); color: var(--c-text-1, #fff); min-width: 0; }
+  .spr--sm { --slide-w: clamp(180px, 18vw, 240px); }
+  .spr--lg { --slide-w: clamp(260px, 30vw, 420px); }
+  .spr__head { display: flex; align-items: flex-end; justify-content: space-between; gap: var(--sp-4, 1rem); margin-bottom: var(--sp-6, 1.5rem); }
+  .spr__eyebrow { margin: 0 0 var(--sp-2, 0.5rem); font-size: 0.72rem; font-weight: 600; letter-spacing: 0.16em; text-transform: uppercase; color: var(--c-text-2, #a3a3a3); }
+  .spr__title { margin: 0; font-family: var(--font-display, Georgia, 'Times New Roman', serif); font-size: clamp(2rem, 4.5vw, 3.4rem); font-weight: 400; letter-spacing: -0.035em; line-height: 1; }
+  .spr__title em { font-style: italic; color: var(--shop-accent, var(--c-primary-light, #d4a017)); }
+  .spr__controls { display: flex; align-items: center; gap: var(--sp-2, 0.5rem); }
+  .spr__all { margin-right: var(--sp-3, 0.75rem); min-height: 44px; display: inline-flex; align-items: center; font-size: 0.8rem; font-weight: 600; letter-spacing: 0.1em; text-transform: uppercase; color: inherit; text-decoration: underline; text-underline-offset: 5px; }
+  .spr__arrow { width: 48px; height: 48px; border: 1px solid var(--c-border, rgba(255, 255, 255, 0.15)); border-radius: 50%; background: transparent; color: inherit; font-size: 1.1rem; cursor: pointer; transition: background 0.2s ease, color 0.2s ease, opacity 0.2s ease; }
+  .spr__arrow:hover:not(:disabled) { background: var(--c-text-1, #fff); color: var(--c-bg, #050505); }
+  .spr__arrow:disabled { opacity: 0.3; cursor: default; }
+  .spr :is(a, button):focus-visible, .spr__track:focus-visible { outline: 2px solid var(--shop-accent, var(--c-primary-light, #d4a017)); outline-offset: 3px; }
+
+  .spr__track {
+    display: grid;
+    grid-auto-flow: column;
+    grid-auto-columns: var(--slide-w);
+    gap: 16px;
+    margin: 0;
+    padding: 0 0 var(--sp-2, 0.5rem);
+    list-style: none;
+    overflow-x: auto;
+    scroll-snap-type: x mandatory;
+    scrollbar-width: none;
+  }
+  .spr__track::-webkit-scrollbar { display: none; }
+  .spr__slide { scroll-snap-align: start; min-width: 0; }
+  .spr__progress { position: relative; height: 1px; margin-top: var(--sp-5, 1.25rem); background: var(--c-border, rgba(255, 255, 255, 0.15)); overflow: hidden; }
+  .spr__progress span { position: absolute; inset: 0 auto 0 0; height: 100%; background: var(--c-text-1, #fff); transition: transform 0.15s linear; }
+
+  @container (max-width: 640px) {
+    .spr__track { grid-auto-columns: 72%; }
+    .spr__arrow, .spr__all { display: none; }
+  }
+  @media (prefers-reduced-motion: reduce) { .spr__track { scroll-snap-type: none; } }
+</style>

package/src/components/lib/sections/ShopReviewsEditorial.astro

@@ -0,0 +1,133 @@
+---
+/**
+ * ShopReviewsEditorial — Customer voices as one large serif quote at a time, with product
+ * context, star rating, numbered pager and an overall score.
+ *
+ * @param {string} eyebrow - Small label. Default 'Customer notes'.
+ * @param {number} score - Average rating shown on the side. Default 4.9.
+ * @param {number} count - Total reviews. Default 1284.
+ * @param {Array<{quote: string, name: string, place?: string, product?: string, rating?: number}>} reviews - Quotes.
+ * @param {number} interval - Auto-advance in ms (0 = manual only). Default 7000.
+ * @param {string} variant - Style (plain|boxed). Default 'plain'.
+ * @param {string} className - Extra class.
+ *
+ * Accessibility: a labelled carousel region; slides are figures with figcaption; auto-advance
+ * pauses on hover/focus, is off with reduced motion, and pager buttons use aria-current.
+ */
+import ProductRating from '../ecommerce/ProductRating.astro';
+
+interface Review { quote: string; name: string; place?: string; product?: string; rating?: number }
+interface Props {
+  eyebrow?: string;
+  score?: number;
+  count?: number;
+  reviews?: Review[];
+  interval?: number;
+  variant?: 'plain' | 'boxed';
+  className?: string;
+}
+
+const {
+  eyebrow = 'Customer notes',
+  score = 4.9,
+  count = 1284,
+  reviews = [
+    { quote: 'The overshirt has been washed forty times and it only gets softer. It is the first thing I reach for.', name: 'Inés M.', place: 'Valencia', product: 'Linen Overshirt', rating: 5 },
+    { quote: 'Packaging without plastic, a handwritten note, and a mug that feels made for my hands.', name: 'Jonas P.', place: 'Hamburg', product: 'Kiln Mug', rating: 5 },
+    { quote: 'They repaired the strap of my tote for free, two years after I bought it. That is rare.', name: 'Amira S.', place: 'Lyon', product: 'Field Tote', rating: 5 },
+  ],
+  interval = 7000,
+  variant = 'plain',
+  className = '',
+} = Astro.props;
+---
+
+<div class="sre-cq">
+<section class:list={['sre', `sre--${variant}`, className]} aria-roledescription="carousel" aria-label={eyebrow} data-reviews data-interval={interval}>
+  <div class="sre__side">
+    <p class="sre__eyebrow">{eyebrow}</p>
+    <p class="sre__score">{score.toFixed(1)}<span>/5</span></p>
+    <ProductRating value={score} count={count} showValue={false} size="md" />
+  </div>
+  <div class="sre__main">
+    <div class="sre__slides">
+      {reviews.map((r, i) => (
+        <figure class:list={['sre__slide', { 'is-active': i === 0 }]} hidden={i !== 0} aria-roledescription="slide" aria-label={`${i + 1} of ${reviews.length}`} data-slide>
+          <blockquote class="sre__quote"><p>“{r.quote}”</p></blockquote>
+          <figcaption class="sre__by">
+            <strong>{r.name}</strong>{r.place && <span>, {r.place}</span>}
+            {r.product && <span class="sre__product">on {r.product}</span>}
+          </figcaption>
+        </figure>
+      ))}
+    </div>
+    {reviews.length > 1 && (
+      <div class="sre__pager" role="group" aria-label="Choose a review">
+        {reviews.map((_, i) => (
+          <button type="button" class="sre__page" aria-label={`Review ${i + 1}`} aria-current={i === 0 ? 'true' : undefined} data-page={i}>{String(i + 1).padStart(2, '0')}</button>
+        ))}
+      </div>
+    )}
+  </div>
+</section>
+</div>
+
+<script>
+  document.querySelectorAll<HTMLElement>('[data-reviews]:not([data-bound])').forEach((root) => {
+    root.dataset.bound = '';
+    const slides = Array.from(root.querySelectorAll<HTMLElement>('[data-slide]'));
+    const pages = Array.from(root.querySelectorAll<HTMLButtonElement>('[data-page]'));
+    let index = 0;
+    let paused = false;
+    const go = (i: number) => {
+      index = (i + slides.length) % slides.length;
+      slides.forEach((s, n) => { s.hidden = n !== index; s.classList.toggle('is-active', n === index); });
+      pages.forEach((p, n) => { if (n === index) p.setAttribute('aria-current', 'true'); else p.removeAttribute('aria-current'); });
+    };
+    pages.forEach((p, i) => p.addEventListener('click', () => go(i)));
+    root.addEventListener('mouseenter', () => { paused = true; });
+    root.addEventListener('mouseleave', () => { paused = false; });
+    root.addEventListener('focusin', () => { paused = true; });
+    root.addEventListener('focusout', () => { paused = false; });
+    const ms = Number(root.dataset.interval) || 0;
+    if (ms > 0 && slides.length > 1 && !window.matchMedia('(prefers-reduced-motion: reduce)').matches) {
+      window.setInterval(() => { if (!paused && !document.hidden) go(index + 1); }, ms);
+    }
+  });
+</script>
+
+<style>
+  .sre-cq { container-type: inline-size; }
+  .sre {
+    display: grid;
+    grid-template-columns: 240px minmax(0, 1fr);
+    gap: clamp(1.5rem, 5vw, 5rem);
+    padding-block: clamp(2rem, 5vw, 4rem);
+    border-top: 1px solid var(--c-text-1, #fff);
+    color: var(--c-text-1, #fff);
+  }
+  .sre--boxed { padding: clamp(1.5rem, 4vw, 3.5rem); border: 1px solid var(--c-border, rgba(255, 255, 255, 0.12)); background: var(--c-bg-1, #0a0a0a); }
+  .sre__eyebrow { margin: 0 0 var(--sp-4, 1rem); font-size: 0.72rem; font-weight: 600; letter-spacing: 0.16em; text-transform: uppercase; color: var(--c-text-2, #a3a3a3); }
+  .sre__score { margin: 0 0 var(--sp-2, 0.5rem); font-family: var(--font-display, Georgia, 'Times New Roman', serif); font-size: 4.5rem; line-height: 1; letter-spacing: -0.04em; }
+  .sre__score span { font-size: 1.2rem; color: var(--c-text-2, #a3a3a3); }
+  .sre__side :global(.p-rating) { --p-rating-star: var(--shop-accent, var(--c-primary-light, #d4a017)); }
+
+  .sre__slides { display: grid; min-height: 12rem; }
+  .sre__slide { grid-area: 1 / 1; margin: 0; }
+  .sre__slide[hidden] { display: none; }
+  .sre__slide.is-active { animation: sre-in 0.6s cubic-bezier(0.16, 1, 0.3, 1); }
+  @keyframes sre-in { from { opacity: 0; transform: translateY(10px); } }
+  .sre__quote { margin: 0; }
+  .sre__quote p { margin: 0; font-family: var(--font-display, Georgia, 'Times New Roman', serif); font-size: clamp(1.6rem, 3.4vw, 2.8rem); font-weight: 400; font-style: italic; line-height: 1.2; letter-spacing: -0.02em; text-wrap: balance; }
+  .sre__by { margin-top: var(--sp-5, 1.25rem); font-size: 0.9rem; }
+  .sre__by span { color: var(--c-text-2, #a3a3a3); }
+  .sre__product { display: block; margin-top: 2px; font-size: 0.8rem; letter-spacing: 0.06em; text-transform: uppercase; }
+
+  .sre__pager { display: flex; gap: var(--sp-4, 1rem); margin-top: var(--sp-8, 2rem); }
+  .sre__page { min-width: 44px; min-height: 44px; padding: 0; border: 0; border-top: 1px solid var(--c-border, rgba(255, 255, 255, 0.2)); background: none; color: var(--c-text-2, #a3a3a3); font: inherit; font-size: 0.8rem; font-variant-numeric: tabular-nums; text-align: left; cursor: pointer; }
+  .sre__page[aria-current='true'] { border-top: 2px solid var(--shop-accent, var(--c-primary-light, #d4a017)); color: var(--c-text-1, #fff); }
+  .sre__page:focus-visible { outline: 2px solid var(--shop-accent, var(--c-primary-light, #d4a017)); outline-offset: 3px; }
+
+  @container (max-width: 760px) { .sre { grid-template-columns: 1fr; } }
+  @media (prefers-reduced-motion: reduce) { .sre__slide.is-active { animation: none; } }
+</style>