astro-component-kit 0.3.1 → 0.4.1

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

@@ -0,0 +1,91 @@
+---
+/**
+ * ShopValuesMarquee — Brand promise band: an oversized italic marquee followed by numbered
+ * value columns (materials, making, after-care…).
+ *
+ * @param {string[]} words - Marquee words. Empty hides the marquee.
+ * @param {Array<{title: string, text: string}>} values - 2–4 value columns.
+ * @param {number} speed - Marquee loop duration in seconds. Default 36.
+ * @param {string} variant - Style (plain|inverted). Default 'plain'.
+ * @param {string} size - Marquee scale (sm|md|lg). Default 'md'.
+ * @param {string} className - Extra class.
+ *
+ * Accessibility: the marquee is decorative (aria-hidden) and pauses on hover and with reduced
+ * motion; values are a real list with headings.
+ */
+interface Props {
+  words?: string[];
+  values?: Array<{ title: string; text: string }>;
+  speed?: number;
+  variant?: 'plain' | 'inverted';
+  size?: 'sm' | 'md' | 'lg';
+  className?: string;
+}
+
+const {
+  words = ['Made slowly', 'Natural fibres', 'Small workshops', 'Repaired for life'],
+  values = [
+    { title: 'Honest materials', text: 'Linen, wool, organic cotton and stoneware — traceable to the mill and the kiln.' },
+    { title: 'Made in small runs', text: 'Each piece is produced in batches of a few hundred, never mass-manufactured.' },
+    { title: 'Kept for years', text: 'Free repairs on everything we make, and a buy-back for pieces you have outgrown.' },
+  ],
+  speed = 36,
+  variant = 'plain',
+  size = 'md',
+  className = '',
+} = Astro.props;
+---
+
+<section class:list={['svm', `svm--${variant}`, `svm--${size}`, className]} style={`--svm-speed: ${speed}s`}>
+  {words.length > 0 && (
+    <div class="svm__marquee" aria-hidden="true">
+      <div class="svm__track">
+        {[0, 1].map(() => words.map((w) => <span>{w}<i>✺</i></span>))}
+      </div>
+    </div>
+  )}
+  {values.length > 0 && (
+    <ol class="svm__values">
+      {values.map((v, i) => (
+        <li>
+          <span class="svm__num" aria-hidden="true">{String(i + 1).padStart(2, '0')}</span>
+          <h3>{v.title}</h3>
+          <p>{v.text}</p>
+        </li>
+      ))}
+    </ol>
+  )}
+</section>
+
+<style>
+  .svm { container-type: inline-size; --svm-fs: clamp(3rem, 9vw, 7.5rem); color: var(--c-text-1, #fff); overflow: hidden; }
+  .svm--sm { --svm-fs: clamp(2rem, 6vw, 4.5rem); }
+  .svm--lg { --svm-fs: clamp(4rem, 12vw, 10rem); }
+  .svm--inverted { background: var(--c-text-1, #fff); color: var(--c-bg, #050505); }
+  .svm__marquee { border-block: 1px solid currentColor; overflow: hidden; }
+  .svm__track { display: flex; width: max-content; animation: svm-run var(--svm-speed) linear infinite; }
+  .svm:hover .svm__track { animation-play-state: paused; }
+  .svm__track span { display: inline-flex; align-items: center; gap: 0.35em; padding: 0.1em 0 0.15em 0.35em; font-family: var(--font-display, Georgia, 'Times New Roman', serif); font-size: var(--svm-fs); font-style: italic; letter-spacing: -0.04em; line-height: 1.05; white-space: nowrap; }
+  .svm__track i { font-style: normal; font-size: 0.4em; color: var(--shop-accent, var(--c-primary-light, #d4a017)); }
+  @keyframes svm-run { to { transform: translateX(-50%); } }
+
+  .svm__values {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+    margin: 0 auto;
+    max-width: 1440px;
+    padding: clamp(2rem, 5vw, 4rem) clamp(1rem, 3vw, 2.5rem);
+    list-style: none;
+    gap: 0;
+  }
+  .svm__values li { padding: 0 var(--sp-6, 1.5rem) var(--sp-4, 1rem); border-left: 1px solid var(--c-border, rgba(255, 255, 255, 0.12)); }
+  .svm--inverted .svm__values li { border-left-color: rgb(var(--paper-rgb, 5 5 5) / 0.2); }
+  .svm__num { font-size: 0.75rem; font-variant-numeric: tabular-nums; color: var(--shop-accent, var(--c-primary-light, #d4a017)); }
+  .svm__values h3 { margin: var(--sp-3, 0.75rem) 0 var(--sp-2, 0.5rem); font-family: var(--font-display, Georgia, serif); font-size: 1.5rem; font-weight: 400; letter-spacing: -0.02em; }
+  .svm__values p { margin: 0; max-width: 22rem; font-size: 0.92rem; line-height: 1.65; opacity: 0.75; }
+
+  @container (max-width: 640px) {
+    .svm__values li { padding: var(--sp-4, 1rem) 0; border-left: 0; border-top: 1px solid var(--c-border, rgba(255, 255, 255, 0.12)); }
+  }
+  @media (prefers-reduced-motion: reduce) { .svm__track { animation: none; } }
+</style>

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

@@ -0,0 +1,124 @@
+---
+/**
+ * StatsCounterBand — Full-width band of headline numbers that count up when
+ * scrolled into view. Final values are in the HTML, so no-JS and screen
+ * readers always get the real number; motion respects reduced-motion.
+ *
+ * @param {string} title - Optional heading (visually hidden when `hideTitle`).
+ * @param {boolean} hideTitle - Visually hide the heading.
+ * @param {Array<{value: number, prefix?: string, suffix?: string, label: string, decimals?: number}>} stats - Numbers.
+ * @param {string} variant - Band style (divided|cards|plain).
+ * @param {string} size - Vertical rhythm (sm|md|lg).
+ * @param {string} className - Extra CSS class.
+ */
+interface Stat { value: number; prefix?: string; suffix?: string; label: string; decimals?: number }
+interface Props {
+  title?: string;
+  hideTitle?: boolean;
+  stats?: Stat[];
+  variant?: 'divided' | 'cards' | 'plain';
+  size?: 'sm' | 'md' | 'lg';
+  className?: string;
+}
+
+const {
+  title = 'Trusted at scale',
+  hideTitle = false,
+  stats = [
+    { value: 12000, suffix: '+', label: 'Developers using the kit' },
+    { value: 250, suffix: '+', label: 'Components & sections' },
+    { value: 99.98, suffix: '%', label: 'CDN uptime last 12 months', decimals: 2 },
+    { value: 48, prefix: '<', suffix: 'ms', label: 'Median time to first byte' },
+  ],
+  variant = 'divided',
+  size = 'md',
+  className = '',
+} = Astro.props;
+
+const id = `scb-${Math.random().toString(36).slice(2, 8)}`;
+const fmt = (s: Stat) => `${s.prefix ?? ''}${s.value.toLocaleString('en-US', { minimumFractionDigits: s.decimals ?? 0, maximumFractionDigits: s.decimals ?? 0 })}${s.suffix ?? ''}`;
+---
+
+<div class="cq-stats-counter-band-cq">
+<section class={`scb scb--${variant} scb--${size} ${className}`} aria-labelledby={id}>
+  <div class="scb__inner">
+    <h2 id={id} class:list={['scb__title', { 'scb__sr': hideTitle }]}>{title}</h2>
+    <dl class="scb__grid">
+      {stats.map((s) => (
+        <div class="scb__item">
+          <dt class="scb__label">{s.label}</dt>
+          <dd class="scb__value" data-count={s.value} data-decimals={s.decimals ?? 0} data-prefix={s.prefix ?? ''} data-suffix={s.suffix ?? ''}>{fmt(s)}</dd>
+        </div>
+      ))}
+    </dl>
+  </div>
+</section>
+</div>
+<script>
+  const reduce = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+  const els = document.querySelectorAll<HTMLElement>('.scb__value[data-count]');
+  if (!reduce && 'IntersectionObserver' in window) {
+    const io = new IntersectionObserver((entries) => {
+      entries.forEach((entry) => {
+        if (!entry.isIntersecting) return;
+        const el = entry.target as HTMLElement;
+        io.unobserve(el);
+        const target = Number(el.dataset.count);
+        const dec = Number(el.dataset.decimals);
+        const pre = el.dataset.prefix || '';
+        const suf = el.dataset.suffix || '';
+        const final = el.textContent;
+        el.setAttribute('aria-label', final || '');
+        const start = performance.now();
+        const dur = 1400;
+        const tick = (now: number) => {
+          const t = Math.min(1, (now - start) / dur);
+          const eased = 1 - Math.pow(1 - t, 3);
+          const v = target * eased;
+          el.textContent = `${pre}${v.toLocaleString('en-US', { minimumFractionDigits: dec, maximumFractionDigits: dec })}${suf}`;
+          if (t < 1) requestAnimationFrame(tick);
+          else el.textContent = final;
+        };
+        requestAnimationFrame(tick);
+      });
+    }, { threshold: 0.4 });
+    els.forEach((el) => io.observe(el));
+  }
+</script>
+
+<style>
+  .cq-stats-counter-band-cq { container-type: inline-size; }
+  .scb {
+    --scb-py: 4.5rem;
+    padding: var(--scb-py) var(--sp-6, 1.5rem);
+    background: linear-gradient(180deg, transparent, rgb(var(--ink-rgb, 255 255 255) / 0.02) 50%, transparent), var(--c-bg, #050505);
+  }
+  .scb--sm { --scb-py: 3rem; }
+  .scb--lg { --scb-py: 6.5rem; }
+  .scb__inner { max-width: 1180px; margin: 0 auto; }
+  .scb__title { margin: 0 0 2.5rem; text-align: center; font-size: 0.875rem; font-weight: 650; letter-spacing: 0.1em; text-transform: uppercase; color: var(--c-text-2, #a3a3a3); }
+  .scb__sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; margin: 0; }
+  .scb__grid { margin: 0; display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); }
+  .scb__item { display: flex; flex-direction: column-reverse; align-items: center; gap: 0.5rem; padding: 1.5rem 1rem; text-align: center; }
+  .scb--divided .scb__item + .scb__item { border-left: 1px solid rgb(var(--ink-rgb, 255 255 255) / 0.08); }
+  .scb--cards .scb__grid { gap: 1rem; }
+  .scb--cards .scb__item { border-radius: var(--r-lg, 20px); background: rgb(var(--ink-rgb, 255 255 255) / 0.03); border: 1px solid var(--c-border, rgb(var(--ink-rgb, 255 255 255) / 0.07)); }
+  .scb__value {
+    margin: 0;
+    font-size: clamp(2.25rem, 5vw, 3.25rem);
+    font-weight: 800;
+    letter-spacing: -0.04em;
+    line-height: 1;
+    font-variant-numeric: tabular-nums;
+    background: linear-gradient(180deg, var(--c-text-1, #fff), rgb(var(--ink-rgb, 255 255 255) / 0.65));
+    -webkit-background-clip: text;
+    background-clip: text;
+    color: transparent;
+  }
+  .scb__label { font-size: 0.9375rem; color: var(--c-text-2, #a3a3a3); max-width: 220px; }
+  @container (max-width: 640px) {
+    .scb__grid { grid-template-columns: 1fr 1fr; }
+    .scb--divided .scb__item + .scb__item { border-left: 0; }
+    .scb--divided .scb__item:nth-child(even) { border-left: 1px solid rgb(var(--ink-rgb, 255 255 255) / 0.08); }
+  }
+</style>

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

@@ -0,0 +1,85 @@
+---
+/**
+ * StatsDashboardSection — Complete analytics section: heading, KPI tile row and
+ * two charts (trend + ranked breakdown) composed from the kit's SVG charts.
+ *
+ * @param {string} eyebrow - Small label above the heading.
+ * @param {string} title - Section heading.
+ * @param {string} subtitle - Section description.
+ * @param {Array<{label: string, value: string, change: number, trend?: number[], invert?: boolean}>} kpis - KPI tiles.
+ * @param {string} variant - Chart card style (glass|solid|ghost).
+ * @param {string} size - Vertical rhythm (sm|md|lg).
+ * @param {string} className - Extra CSS class.
+ */
+import KpiStatTile from '../charts/KpiStatTile.astro';
+import StackedAreaChart from '../charts/StackedAreaChart.astro';
+import HorizontalBarChart from '../charts/HorizontalBarChart.astro';
+
+interface Kpi { label: string; value: string; change: number; trend?: number[]; invert?: boolean }
+interface Props {
+  eyebrow?: string;
+  title?: string;
+  subtitle?: string;
+  kpis?: Kpi[];
+  variant?: 'glass' | 'solid' | 'ghost';
+  size?: 'sm' | 'md' | 'lg';
+  className?: string;
+}
+
+const {
+  eyebrow = 'Live metrics',
+  title = 'Growth you can see',
+  subtitle = 'Real numbers from teams running on the kit, updated every build.',
+  kpis = [
+    { label: 'Monthly visitors', value: '1.2M', change: 18.4, trend: [60, 64, 70, 72, 80, 88, 95, 104, 120] },
+    { label: 'Conversion rate', value: '4.6%', change: 0.9, trend: [3.4, 3.6, 3.7, 3.9, 4, 4.2, 4.3, 4.5, 4.6] },
+    { label: 'Avg. load time', value: '0.8s', change: -22, invert: true, trend: [1.3, 1.25, 1.1, 1.05, 1, 0.95, 0.9, 0.85, 0.8] },
+    { label: 'Bounce rate', value: '31%', change: -4.2, invert: true, trend: [38, 37, 36, 35, 34, 33, 33, 32, 31] },
+  ],
+  variant = 'glass',
+  size = 'md',
+  className = '',
+} = Astro.props;
+
+const id = `sds-${Math.random().toString(36).slice(2, 8)}`;
+---
+
+<div class="cq-stats-dashboard-section-cq">
+<section class={`sds sds--${size} ${className}`} aria-labelledby={id}>
+  <div class="sds__inner">
+    <header class="sds__head">
+      <p class="sds__eyebrow"><span class="sds__live" aria-hidden="true"></span>{eyebrow}</p>
+      <h2 id={id} class="sds__title">{title}</h2>
+      <p class="sds__subtitle">{subtitle}</p>
+    </header>
+    <div class="sds__kpis">
+      {kpis.map((k) => (
+        <KpiStatTile label={k.label} value={k.value} change={k.change} trend={k.trend} invert={k.invert} period="vs last quarter" variant={variant} size="sm" />
+      ))}
+    </div>
+    <div class="sds__charts">
+      <StackedAreaChart title="Sessions by channel" subtitle="Thousands per month" variant={variant} />
+      <HorizontalBarChart title="Top landing pages" subtitle="Visitors, last 30 days" variant={variant} />
+    </div>
+  </div>
+</section>
+</div>
+<style>
+  .cq-stats-dashboard-section-cq { container-type: inline-size; }
+  .sds {
+    --sds-py: 5.5rem;
+    padding: var(--sds-py) var(--sp-6, 1.5rem);
+    background: radial-gradient(ellipse 60% 40% at 50% 0%, rgba(57, 135, 229, 0.08), transparent 70%), var(--c-bg, #050505);
+  }
+  .sds--sm { --sds-py: 3.5rem; }
+  .sds--lg { --sds-py: 7.5rem; }
+  .sds__inner { max-width: 1180px; margin: 0 auto; display: grid; gap: 1.25rem; }
+  .sds__head { text-align: center; max-width: 640px; margin: 0 auto 1.75rem; }
+  .sds__eyebrow { display: inline-flex; align-items: center; gap: 0.5rem; margin: 0 0 0.75rem; font-size: 0.8125rem; font-weight: 650; letter-spacing: 0.08em; text-transform: uppercase; color: var(--c-text-2, #a3a3a3); }
+  .sds__live { width: 8px; height: 8px; border-radius: 50%; background: var(--chart-pos, #34c38f); box-shadow: 0 0 10px var(--chart-pos, #34c38f); }
+  .sds__title { margin: 0 0 0.75rem; font-size: clamp(1.9rem, 4vw, 2.75rem); font-weight: 800; letter-spacing: -0.03em; color: var(--c-text-1, #fff); }
+  .sds__subtitle { margin: 0; font-size: 1.0625rem; color: var(--c-text-2, #a3a3a3); }
+  .sds__kpis { display: grid; grid-template-columns: repeat(auto-fit, minmax(230px, 1fr)); gap: 1.25rem; }
+  .sds__charts { display: grid; grid-template-columns: 1.4fr 1fr; gap: 1.25rem; }
+  @container (max-width: 900px) { .sds__charts { grid-template-columns: 1fr; } }
+</style>

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

@@ -52,6 +52,7 @@ const stats = [
 ];
 ---
 
+<div class="cq-stats-metric-showcase-cq">
 <section class={`stats-section ${className}`} aria-labelledby="stats-title">
   <div class="stats-bg" aria-hidden="true">
     <div class="stats-glow"></div>
@@ -105,8 +106,9 @@ const stats = [
     </div>
   </div>
 </section>
-
+</div>
 <style>
+  .cq-stats-metric-showcase-cq { container-type: inline-size; }
   .stats-section {
     position: relative;
     padding: var(--sp-20, 5rem) var(--sp-6, 1.5rem);
@@ -185,7 +187,7 @@ const stats = [
   .stat-card {
     background: rgba(15, 23, 42, 0.6);
     backdrop-filter: blur(20px);
-    border: 1px solid rgba(255, 255, 255, 0.08);
+    border: 1px solid rgb(var(--ink-rgb, 255 255 255) / 0.08);
     border-radius: var(--r-xl, 20px);
     padding: 2rem 1.75rem;
     display: flex;
@@ -196,7 +198,7 @@ const stats = [
 
   .stat-card:hover {
     transform: translateY(-4px);
-    border-color: rgba(255, 255, 255, 0.2);
+    border-color: rgb(var(--ink-rgb, 255 255 255) / 0.2);
   }
 
   .stat-top {
@@ -239,7 +241,7 @@ const stats = [
 
   .stat-chart-bar {
     height: 4px;
-    background: rgba(255, 255, 255, 0.08);
+    background: rgb(var(--ink-rgb, 255 255 255) / 0.08);
     border-radius: 9999px;
     overflow: hidden;
   }
@@ -258,7 +260,7 @@ const stats = [
     gap: 2rem;
     padding: 1.25rem 2rem;
     background: rgba(10, 15, 30, 0.8);
-    border: 1px solid rgba(255, 255, 255, 0.08);
+    border: 1px solid rgb(var(--ink-rgb, 255 255 255) / 0.08);
     border-radius: 16px;
     flex-wrap: wrap;
   }
@@ -313,13 +315,13 @@ const stats = [
     font-weight: 600;
   }
 
-  @media (max-width: 1024px) {
+  @container (max-width: 1024px) {
     .stats-grid {
       grid-template-columns: repeat(2, 1fr);
     }
   }
 
-  @media (max-width: 640px) {
+  @container (max-width: 640px) {
     .stats-grid {
       grid-template-columns: 1fr;
     }

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

@@ -60,6 +60,7 @@ const members = [
 ];
 ---
 
+<div class="cq-team-grid-section-cq">
 <section class={`team-section ${className}`} aria-labelledby="team-title">
   <div class="team-bg" aria-hidden="true">
     <div class="team-glow"></div>
@@ -106,8 +107,9 @@ const members = [
     </div>
   </div>
 </section>
-
+</div>
 <style>
+  .cq-team-grid-section-cq { container-type: inline-size; }
   .team-section {
     position: relative;
     padding: var(--sp-20, 5rem) var(--sp-6, 1.5rem);
@@ -186,7 +188,7 @@ const members = [
   .member-card {
     background: rgba(15, 23, 42, 0.55);
     backdrop-filter: blur(20px);
-    border: 1px solid rgba(255, 255, 255, 0.08);
+    border: 1px solid rgb(var(--ink-rgb, 255 255 255) / 0.08);
     border-radius: var(--r-xl, 20px);
     padding: 2rem 1.5rem;
     text-align: center;
@@ -198,7 +200,7 @@ const members = [
 
   .member-card:hover {
     transform: translateY(-4px);
-    border-color: rgba(255, 255, 255, 0.2);
+    border-color: rgb(var(--ink-rgb, 255 255 255) / 0.2);
   }
 
   .member-avatar {
@@ -211,7 +213,7 @@ const members = [
     font-weight: 800;
     color: #fff;
     margin-bottom: 1.25rem;
-    border: 2px solid rgba(255, 255, 255, 0.2);
+    border: 2px solid rgb(var(--ink-rgb, 255 255 255) / 0.2);
     box-shadow: 0 8px 20px rgba(0, 0, 0, 0.4);
   }
 
@@ -246,8 +248,8 @@ const members = [
     width: 34px;
     height: 34px;
     border-radius: 8px;
-    background: rgba(255, 255, 255, 0.05);
-    border: 1px solid rgba(255, 255, 255, 0.08);
+    background: rgb(var(--ink-rgb, 255 255 255) / 0.05);
+    border: 1px solid rgb(var(--ink-rgb, 255 255 255) / 0.08);
     display: flex;
     align-items: center;
     justify-content: center;
@@ -258,8 +260,8 @@ const members = [
 
   .social-icon:hover {
     color: #fff;
-    background: rgba(255, 255, 255, 0.12);
-    border-color: rgba(255, 255, 255, 0.2);
+    background: rgb(var(--ink-rgb, 255 255 255) / 0.12);
+    border-color: rgb(var(--ink-rgb, 255 255 255) / 0.2);
   }
 
   /* Hiring Banner */
@@ -314,13 +316,13 @@ const members = [
     box-shadow: 0 6px 20px rgba(168, 85, 247, 0.45);
   }
 
-  @media (max-width: 1024px) {
+  @container (max-width: 1024px) {
     .team-grid {
       grid-template-columns: repeat(2, 1fr);
     }
   }
 
-  @media (max-width: 640px) {
+  @container (max-width: 640px) {
     .team-grid {
       grid-template-columns: 1fr;
     }

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

@@ -0,0 +1,167 @@
+---
+/**
+ * TestimonialCarousel — Scroll-snap testimonial carousel with previous/next
+ * buttons, keyboard support and no autoplay (respects user control).
+ *
+ * @param {string} title - Section heading.
+ * @param {Array<{quote: string, name: string, role: string, rating?: number}>} items - Testimonials.
+ * @param {string} variant - Card style (glass|solid|quote).
+ * @param {string} size - Vertical rhythm (sm|md|lg).
+ * @param {string} className - Extra CSS class.
+ */
+interface Item { quote: string; name: string; role: string; rating?: number }
+interface Props {
+  title?: string;
+  items?: Item[];
+  variant?: 'glass' | 'solid' | 'quote';
+  size?: 'sm' | 'md' | 'lg';
+  className?: string;
+}
+
+const {
+  title = 'Loved by builders worldwide',
+  items = [
+    { quote: 'We rebuilt our marketing site in two days. The sections are gorgeous and Lighthouse went straight to 100.', name: 'Alicia Gómez', role: 'Head of Growth, Northwind', rating: 5 },
+    { quote: 'The SVG charts replaced a 200 kB library in our dashboard. Same features, zero runtime.', name: 'Marcus Lee', role: 'Staff Engineer, Lumen', rating: 5 },
+    { quote: 'Finally a component kit that takes accessibility seriously. Our audit came back clean.', name: 'Priya Natarajan', role: 'Accessibility Lead, Civic', rating: 5 },
+    { quote: 'Copy, paste, tweak tokens, done. It feels like a design system we built ourselves.', name: 'Tom Becker', role: 'Founder, Driftly', rating: 4 },
+    { quote: 'Our agency ships every client landing page on top of this kit now.', name: 'Sofía Ruiz', role: 'Creative Director, Studio Alba', rating: 5 },
+  ],
+  variant = 'glass',
+  size = 'md',
+  className = '',
+} = Astro.props;
+
+const id = `tc-${Math.random().toString(36).slice(2, 8)}`;
+const initials = (n: string) => n.split(' ').map((p) => p[0]).slice(0, 2).join('');
+const hues = ['var(--chart-1, #3987e5)', 'var(--chart-2, #d95926)', 'var(--chart-3, #199e70)', 'var(--chart-5, #d55181)', 'var(--chart-7, #9085e9)'];
+---
+
+<div class="cq-testimonial-carousel-cq">
+<section class={`tc tc--${variant} tc--${size} ${className}`} aria-labelledby={id} aria-roledescription="carousel" data-tc>
+  <div class="tc__inner">
+    <header class="tc__head">
+      <h2 id={id} class="tc__title">{title}</h2>
+      <div class="tc__controls">
+        <button type="button" class="tc__btn" data-dir="-1" aria-label="Previous testimonials">
+          <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><path d="M15 18l-6-6 6-6" /></svg>
+        </button>
+        <button type="button" class="tc__btn" data-dir="1" aria-label="Next testimonials">
+          <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><path d="M9 18l6-6-6-6" /></svg>
+        </button>
+      </div>
+    </header>
+
+    <ul class="tc__track" tabindex="0" aria-label="Testimonials, scroll horizontally">
+      {items.map((t, i) => (
+        <li class="tc__slide" aria-roledescription="slide" aria-label={`${i + 1} of ${items.length}`}>
+          <figure class="tc__card">
+            {t.rating && (
+              <div class="tc__stars" role="img" aria-label={`${t.rating} out of 5 stars`}>
+                {Array.from({ length: 5 }, (_, s) => (
+                  <svg width="16" height="16" viewBox="0 0 24 24" aria-hidden="true" class={(t.rating ?? 0) > s ? 'is-on' : ''}><path d="m12 2 3.1 6.3 6.9 1-5 4.9 1.2 6.8L12 17.8 5.8 21l1.2-6.8-5-4.9 6.9-1z" fill="currentColor" /></svg>
+                ))}
+              </div>
+            )}
+            <blockquote class="tc__quote"><p>“{t.quote}”</p></blockquote>
+            <figcaption class="tc__author">
+              <span class="tc__avatar" style={`background:${hues[i % hues.length]}`} aria-hidden="true">{initials(t.name)}</span>
+              <span><strong>{t.name}</strong><span class="tc__role">{t.role}</span></span>
+            </figcaption>
+          </figure>
+        </li>
+      ))}
+    </ul>
+  </div>
+</section>
+</div>
+<script>
+  document.querySelectorAll<HTMLElement>('[data-tc]').forEach((root) => {
+    const track = root.querySelector<HTMLElement>('.tc__track');
+    const btns = root.querySelectorAll<HTMLButtonElement>('.tc__btn');
+    if (!track) return;
+    const update = () => {
+      const max = track.scrollWidth - track.clientWidth - 2;
+      btns[0].disabled = track.scrollLeft <= 2;
+      btns[1].disabled = track.scrollLeft >= max;
+    };
+    const step = () => (track.querySelector<HTMLElement>('.tc__slide')?.offsetWidth ?? 300) + 20;
+    btns.forEach((b) => b.addEventListener('click', () => {
+      const reduce = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+      track.scrollBy({ left: Number(b.dataset.dir) * step(), behavior: reduce ? 'auto' : 'smooth' });
+    }));
+    track.addEventListener('scroll', update, { passive: true });
+    window.addEventListener('resize', update);
+    update();
+  });
+</script>
+
+<style>
+  .cq-testimonial-carousel-cq { container-type: inline-size; }
+  .tc {
+    --tc-py: 5.5rem;
+    padding: var(--tc-py) var(--sp-6, 1.5rem);
+    background: var(--c-bg, #050505);
+    overflow: hidden;
+  }
+  .tc--sm { --tc-py: 3.5rem; }
+  .tc--lg { --tc-py: 7.5rem; }
+  .tc__inner { max-width: 1180px; margin: 0 auto; }
+  .tc__head { display: flex; justify-content: space-between; align-items: flex-end; gap: 1.5rem; margin-bottom: 2rem; }
+  .tc__title { margin: 0; font-size: clamp(1.75rem, 4vw, 2.5rem); font-weight: 800; letter-spacing: -0.03em; color: var(--c-text-1, #fff); max-width: 560px; }
+  .tc__controls { display: flex; gap: 0.5rem; flex-shrink: 0; }
+  .tc__btn {
+    display: grid;
+    place-items: center;
+    width: 48px;
+    height: 48px;
+    border-radius: 50%;
+    border: 1px solid rgb(var(--ink-rgb, 255 255 255) / 0.14);
+    background: rgb(var(--ink-rgb, 255 255 255) / 0.03);
+    color: var(--c-text-1, #fff);
+    cursor: pointer;
+    transition: background 0.2s ease, border-color 0.2s ease, opacity 0.2s ease;
+  }
+  .tc__btn:hover:not(:disabled) { background: rgb(var(--ink-rgb, 255 255 255) / 0.08); border-color: rgb(var(--ink-rgb, 255 255 255) / 0.3); }
+  .tc__btn:disabled { opacity: 0.35; cursor: not-allowed; }
+  .tc__btn:focus-visible { outline: 2px solid var(--c-primary-light, #d4a017); outline-offset: 2px; }
+  .tc__track {
+    list-style: none;
+    margin: 0;
+    padding: 0.25rem 0 1rem;
+    display: grid;
+    grid-auto-flow: column;
+    grid-auto-columns: min(380px, 85%);
+    gap: 20px;
+    overflow-x: auto;
+    scroll-snap-type: x mandatory;
+    scrollbar-width: none;
+  }
+  .tc__track::-webkit-scrollbar { display: none; }
+  .tc__track:focus-visible { outline: 2px solid var(--c-primary-light, #d4a017); outline-offset: 4px; border-radius: 12px; }
+  .tc__slide { scroll-snap-align: start; }
+  .tc__card {
+    height: 100%;
+    margin: 0;
+    display: flex;
+    flex-direction: column;
+    gap: 1.25rem;
+    padding: 1.75rem;
+    border-radius: var(--r-lg, 20px);
+    box-sizing: border-box;
+  }
+  .tc--glass .tc__card { background: linear-gradient(160deg, rgb(var(--ink-rgb, 255 255 255) / 0.05), rgb(var(--ink-rgb, 255 255 255) / 0.015)); border: 1px solid var(--c-border, rgb(var(--ink-rgb, 255 255 255) / 0.07)); }
+  .tc--solid .tc__card { background: var(--c-bg-2, #111); border: 1px solid rgb(var(--ink-rgb, 255 255 255) / 0.05); }
+  .tc--quote .tc__card { border-left: 2px solid var(--c-primary-light, #d4a017); border-radius: 0; padding-left: 1.5rem; }
+  .tc__stars { display: flex; gap: 2px; color: rgb(var(--ink-rgb, 255 255 255) / 0.15); }
+  .tc__stars .is-on { color: var(--c-primary-light, #d4a017); }
+  .tc__quote { margin: 0; flex: 1; }
+  .tc__quote p { margin: 0; font-size: 1.0625rem; line-height: 1.6; color: var(--c-text-1, #fff); }
+  .tc__author { display: flex; align-items: center; gap: 0.75rem; font-size: 0.875rem; }
+  .tc__author strong { display: block; color: var(--c-text-1, #fff); font-weight: 650; }
+  .tc__role { display: block; color: var(--c-text-2, #a3a3a3); font-size: 0.8125rem; }
+  .tc__avatar { display: grid; place-items: center; width: 40px; height: 40px; border-radius: 50%; color: #fff; font-weight: 700; font-size: 0.8125rem; flex-shrink: 0; }
+  @container (max-width: 560px) {
+    .tc__head { flex-direction: column; align-items: flex-start; }
+  }
+</style>