astro-component-kit 0.3.1 → 0.4.1

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

@@ -0,0 +1,253 @@
+---
+/**
+ * HeroTerminal — Developer-focused split hero with an animated terminal showing
+ * install and build commands, plus a copyable install snippet.
+ *
+ * @param {string} eyebrow - Small label above the title.
+ * @param {string} title - Headline.
+ * @param {string} subtitle - Supporting paragraph.
+ * @param {string} command - Install command shown in the copy field.
+ * @param {Array<{type: 'cmd'|'out'|'ok', text: string}>} lines - Terminal transcript.
+ * @param {{label: string, href: string}} primary - Primary CTA.
+ * @param {string} variant - Terminal style (default|glass|minimal).
+ * @param {string} size - Vertical rhythm (sm|md|lg).
+ * @param {string} className - Extra CSS class.
+ */
+interface Line { type: 'cmd' | 'out' | 'ok'; text: string }
+interface Props {
+  eyebrow?: string;
+  title?: string;
+  subtitle?: string;
+  command?: string;
+  lines?: Line[];
+  primary?: { label: string; href: string };
+  variant?: 'default' | 'glass' | 'minimal';
+  size?: 'sm' | 'md' | 'lg';
+  className?: string;
+}
+
+const {
+  eyebrow = 'For developers',
+  title = 'From zero to production in one command',
+  subtitle = 'Scaffold a fully accessible Astro site with sections, charts and design tokens already wired up.',
+  command = 'npm create astro@latest -- --template kit',
+  lines = [
+    { type: 'cmd', text: 'npm create astro@latest -- --template kit' },
+    { type: 'out', text: 'Scaffolding project in ./my-site …' },
+    { type: 'ok', text: '50 sections installed' },
+    { type: 'ok', text: '45 SVG charts installed' },
+    { type: 'cmd', text: 'npm run build' },
+    { type: 'out', text: '12 pages built in 1.84s' },
+    { type: 'ok', text: 'Lighthouse: 100 · 100 · 100 · 100' },
+  ],
+  primary = { label: 'Get started', href: '#' },
+  variant = 'default',
+  size = 'md',
+  className = '',
+} = Astro.props;
+
+const id = `ht-${Math.random().toString(36).slice(2, 8)}`;
+---
+
+<div class="cq-hero-terminal-cq">
+<section class={`ht ht--${variant} ht--${size} ${className}`} aria-labelledby={id}>
+  <div class="ht__inner">
+    <div class="ht__copy">
+      <p class="ht__eyebrow">{eyebrow}</p>
+      <h1 id={id} class="ht__title">{title}</h1>
+      <p class="ht__subtitle">{subtitle}</p>
+      <div class="ht__install">
+        <code class="ht__cmd"><span aria-hidden="true">$ </span>{command}</code>
+        <button type="button" class="ht__copy-btn" data-copy={command} aria-label="Copy install command">
+          <svg class="ht__icon-copy" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><rect x="9" y="9" width="13" height="13" rx="2" /><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" /></svg>
+          <svg class="ht__icon-ok" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" aria-hidden="true"><path d="M20 6 9 17l-5-5" /></svg>
+        </button>
+        <span class="ht__status" role="status" aria-live="polite"></span>
+      </div>
+      <a class="ht__btn" href={primary.href}>
+        {primary.label}
+        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><path d="M5 12h14M13 6l6 6-6 6" /></svg>
+      </a>
+    </div>
+
+    <div class="ht__terminal" role="img" aria-label={`Terminal transcript: ${lines.map((l) => l.text).join('. ')}`}>
+      <div class="ht__bar" aria-hidden="true">
+        <span></span><span></span><span></span>
+        <p>~/my-site — zsh</p>
+      </div>
+      <ol class="ht__lines" aria-hidden="true">
+        {lines.map((l, i) => (
+          <li class={`ht__line ht__line--${l.type}`} style={`--i:${i}`}>
+            {l.type === 'cmd' && <span class="ht__prompt">❯</span>}
+            {l.type === 'ok' && <span class="ht__ok">✓</span>}
+            {l.text}
+          </li>
+        ))}
+        <li class="ht__line ht__cursor" style={`--i:${lines.length}`}><span class="ht__prompt">❯</span><span class="ht__caret"></span></li>
+      </ol>
+    </div>
+  </div>
+</section>
+</div>
+<script>
+  document.querySelectorAll<HTMLButtonElement>('.ht__copy-btn').forEach((btn) => {
+    btn.addEventListener('click', async () => {
+      const status = btn.parentElement?.querySelector('.ht__status');
+      try {
+        await navigator.clipboard.writeText(btn.dataset.copy || '');
+        btn.classList.add('is-copied');
+        if (status) status.textContent = 'Copied to clipboard';
+        setTimeout(() => {
+          btn.classList.remove('is-copied');
+          if (status) status.textContent = '';
+        }, 1800);
+      } catch {
+        if (status) status.textContent = 'Copy failed — select the text manually';
+      }
+    });
+  });
+</script>
+
+<style>
+  .cq-hero-terminal-cq { container-type: inline-size; }
+  .ht {
+    --ht-py: 5.5rem;
+    padding: var(--ht-py) var(--sp-6, 1.5rem);
+    background: radial-gradient(ellipse 50% 60% at 85% 40%, rgba(57, 135, 229, 0.08), transparent 70%), var(--c-bg, #050505);
+  }
+  .ht--sm { --ht-py: 3.5rem; }
+  .ht--lg { --ht-py: 7.5rem; }
+  .ht__inner {
+    max-width: 1180px;
+    margin: 0 auto;
+    display: grid;
+    grid-template-columns: minmax(0, 1fr) minmax(0, 1.1fr);
+    gap: 4rem;
+    align-items: center;
+  }
+  .ht__eyebrow {
+    margin: 0 0 1rem;
+    font-family: var(--font-mono, monospace);
+    font-size: 0.8125rem;
+    color: var(--c-primary-light, #d4a017);
+    letter-spacing: 0.04em;
+  }
+  .ht__title {
+    margin: 0 0 1.25rem;
+    font-size: clamp(2.25rem, 4.5vw, 3.5rem);
+    font-weight: 800;
+    letter-spacing: -0.03em;
+    line-height: 1.08;
+    color: var(--c-text-1, #fff);
+    text-wrap: balance;
+  }
+  .ht__subtitle { margin: 0 0 2rem; font-size: 1.0625rem; line-height: 1.65; color: var(--c-text-2, #a3a3a3); max-width: 520px; }
+  .ht__install {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    max-width: 520px;
+    padding: 0.4rem 0.4rem 0.4rem 1rem;
+    border-radius: var(--r-md, 12px);
+    border: 1px solid var(--c-border, rgb(var(--ink-rgb, 255 255 255) / 0.08));
+    background: rgb(var(--ink-rgb, 255 255 255) / 0.025);
+    margin-bottom: 1.5rem;
+    position: relative;
+  }
+  .ht__cmd {
+    flex: 1;
+    min-width: 0;
+    overflow-x: auto;
+    white-space: nowrap;
+    font-family: var(--font-mono, monospace);
+    font-size: 0.875rem;
+    color: var(--c-text-1, #fff);
+  }
+  .ht__cmd span { color: var(--c-text-3, #737373); }
+  .ht__copy-btn {
+    display: grid;
+    place-items: center;
+    width: 44px;
+    height: 44px;
+    flex-shrink: 0;
+    border: 0;
+    border-radius: var(--r-sm, 8px);
+    background: rgb(var(--ink-rgb, 255 255 255) / 0.05);
+    color: var(--c-text-2, #a3a3a3);
+    cursor: pointer;
+    transition: background 0.2s ease, color 0.2s ease;
+  }
+  .ht__copy-btn:hover { background: rgb(var(--ink-rgb, 255 255 255) / 0.1); color: var(--c-text-1, #fff); }
+  .ht__copy-btn:focus-visible, .ht__btn:focus-visible { outline: 2px solid var(--c-primary-light, #d4a017); outline-offset: 2px; }
+  .ht__icon-ok { display: none; color: var(--chart-pos, #34c38f); }
+  .ht__copy-btn.is-copied .ht__icon-copy { display: none; }
+  .ht__copy-btn.is-copied .ht__icon-ok { display: block; }
+  .ht__status { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); }
+  .ht__btn {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.5rem;
+    min-height: 48px;
+    padding: 0 1.5rem;
+    border-radius: var(--r-md, 12px);
+    background: var(--c-text-1, #fff);
+    color: var(--c-on-primary, #0a0a0a);
+    font-weight: 650;
+    text-decoration: none;
+    transition: transform 0.2s ease;
+  }
+  .ht__btn:hover { transform: translateY(-1px); color: var(--c-on-primary, #0a0a0a); }
+
+  .ht__terminal {
+    border-radius: var(--r-lg, 20px);
+    border: 1px solid rgb(var(--ink-rgb, 255 255 255) / 0.09);
+    background: #0b0b0d;
+    box-shadow: 0 40px 80px -30px rgba(0, 0, 0, 0.8), 0 0 0 1px rgb(var(--ink-rgb, 255 255 255) / 0.02) inset;
+    overflow: hidden;
+  }
+  .ht--glass .ht__terminal { background: rgba(14, 14, 18, 0.6); backdrop-filter: blur(18px); }
+  .ht--minimal .ht__terminal { box-shadow: none; }
+  .ht__bar {
+    display: flex;
+    align-items: center;
+    gap: 0.45rem;
+    padding: 0.85rem 1rem;
+    border-bottom: 1px solid rgb(var(--ink-rgb, 255 255 255) / 0.06);
+  }
+  .ht__bar span { width: 11px; height: 11px; border-radius: 50%; background: rgb(var(--ink-rgb, 255 255 255) / 0.12); }
+  .ht__bar p { margin: 0 auto; font-size: 0.75rem; color: var(--c-text-3, #737373); font-family: var(--font-mono, monospace); transform: translateX(-1.5rem); }
+  .ht__lines {
+    list-style: none;
+    margin: 0;
+    padding: 1.25rem 1.25rem 1.5rem;
+    font-family: var(--font-mono, monospace);
+    font-size: 0.8125rem;
+    line-height: 1.9;
+    min-height: 260px;
+  }
+  .ht__line {
+    display: flex;
+    gap: 0.6rem;
+    opacity: 0;
+    animation: ht-in 0.35s ease forwards;
+    animation-delay: calc(var(--i) * 0.45s + 0.3s);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+  }
+  .ht__line--cmd { color: var(--c-text-1, #fff); }
+  .ht__line--out { color: var(--c-text-3, #8a8a8a); padding-left: 1.2rem; }
+  .ht__line--ok { color: var(--c-text-2, #c4c4c4); padding-left: 1.2rem; }
+  .ht__prompt { color: var(--c-primary-light, #d4a017); }
+  .ht__ok { color: var(--chart-pos, #34c38f); }
+  .ht__caret { width: 8px; height: 1.1em; align-self: center; background: var(--c-text-1, #fff); animation: ht-blink 1s steps(1) infinite; }
+  @keyframes ht-in { from { opacity: 0; transform: translateY(4px); } to { opacity: 1; transform: none; } }
+  @keyframes ht-blink { 50% { opacity: 0; } }
+  @container (max-width: 900px) {
+    .ht__inner { grid-template-columns: minmax(0, 1fr); gap: 3rem; }
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .ht__line { animation: none; opacity: 1; }
+    .ht__caret { animation: none; }
+  }
+</style>

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

@@ -0,0 +1,231 @@
+---
+/**
+ * HeroWaitlist — Pre-launch hero with an accessible email capture form,
+ * inline validation, success state and avatar-stack social proof.
+ *
+ * @param {string} badge - Status pill text (e.g. 'Private beta').
+ * @param {string} title - Headline.
+ * @param {string} subtitle - Supporting paragraph.
+ * @param {string} action - Form action URL (posts `email`).
+ * @param {string} buttonLabel - Submit button text.
+ * @param {string} successMessage - Message after a valid submission.
+ * @param {number} count - Number of people already on the list.
+ * @param {string} variant - Background treatment (default|aurora|minimal).
+ * @param {string} size - Vertical rhythm (sm|md|lg).
+ * @param {string} className - Extra CSS class.
+ */
+interface Props {
+  badge?: string;
+  title?: string;
+  subtitle?: string;
+  action?: string;
+  buttonLabel?: string;
+  successMessage?: string;
+  count?: number;
+  variant?: 'default' | 'aurora' | 'minimal';
+  size?: 'sm' | 'md' | 'lg';
+  className?: string;
+}
+
+const {
+  badge = 'Private beta · Spring 2027',
+  title = 'Analytics that respect your users',
+  subtitle = 'Cookieless, privacy-first insights with beautiful dashboards. Join the waitlist for early access and founder pricing.',
+  action = '#',
+  buttonLabel = 'Join waitlist',
+  successMessage = "You're on the list! Check your inbox to confirm.",
+  count = 4280,
+  variant = 'aurora',
+  size = 'lg',
+  className = '',
+} = Astro.props;
+
+const id = `hw-${Math.random().toString(36).slice(2, 8)}`;
+const initials = ['AK', 'MR', 'JS', 'LP', 'TW'];
+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-hero-waitlist-cq">
+<section class={`hw hw--${variant} hw--${size} ${className}`} aria-labelledby={id}>
+  <div class="hw__aurora" aria-hidden="true"><span></span><span></span><span></span></div>
+  <div class="hw__inner">
+    <span class="hw__badge"><span class="hw__pulse" aria-hidden="true"></span>{badge}</span>
+    <h1 id={id} class="hw__title">{title}</h1>
+    <p class="hw__subtitle">{subtitle}</p>
+
+    <form class="hw__form" action={action} method="post" novalidate data-success={successMessage}>
+      <label for={`${id}-email`} class="hw__sr">Email address</label>
+      <input id={`${id}-email`} class="hw__input" type="email" name="email" placeholder="you@company.com" autocomplete="email" required aria-describedby={`${id}-msg`} />
+      <button class="hw__btn" type="submit">
+        <span>{buttonLabel}</span>
+        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><path d="M5 12h14M13 6l6 6-6 6" /></svg>
+      </button>
+    </form>
+    <p id={`${id}-msg`} class="hw__msg" role="status" aria-live="polite"></p>
+
+    <div class="hw__proof">
+      <div class="hw__avatars" aria-hidden="true">
+        {initials.map((ini, i) => <span style={`background:${hues[i]}`}>{ini}</span>)}
+      </div>
+      <p><strong>{count.toLocaleString('en-US')}+</strong> builders already joined</p>
+    </div>
+  </div>
+</section>
+</div>
+<script>
+  document.querySelectorAll<HTMLFormElement>('.hw__form').forEach((form) => {
+    const input = form.querySelector<HTMLInputElement>('input[type="email"]');
+    const msg = document.getElementById(input?.getAttribute('aria-describedby') || '');
+    form.addEventListener('submit', (e) => {
+      e.preventDefault();
+      if (!input || !msg) return;
+      if (!input.value || !input.checkValidity()) {
+        input.setAttribute('aria-invalid', 'true');
+        msg.dataset.state = 'error';
+        msg.textContent = 'Please enter a valid email address.';
+        input.focus();
+        return;
+      }
+      input.removeAttribute('aria-invalid');
+      msg.dataset.state = 'success';
+      msg.textContent = form.dataset.success || 'Thanks!';
+      form.classList.add('is-done');
+      input.value = '';
+    });
+    input?.addEventListener('input', () => {
+      input.removeAttribute('aria-invalid');
+      if (msg && msg.dataset.state === 'error') msg.textContent = '';
+    });
+  });
+</script>
+
+<style>
+  .cq-hero-waitlist-cq { container-type: inline-size; }
+  .hw {
+    --hw-py: 6rem;
+    position: relative;
+    overflow: hidden;
+    padding: var(--hw-py) var(--sp-6, 1.5rem);
+    background: var(--c-bg, #050505);
+    text-align: center;
+  }
+  .hw--sm { --hw-py: 4rem; }
+  .hw--lg { --hw-py: 8.5rem; }
+  .hw__aurora { position: absolute; inset: 0; pointer-events: none; display: none; }
+  .hw--aurora .hw__aurora { display: block; }
+  .hw__aurora span {
+    position: absolute;
+    width: 40vw;
+    height: 40vw;
+    max-width: 520px;
+    max-height: 520px;
+    border-radius: 50%;
+    filter: blur(90px);
+    opacity: 0.22;
+    animation: hw-float 16s ease-in-out infinite alternate;
+  }
+  .hw__aurora span:nth-child(1) { background: var(--chart-7, #9085e9); top: -10%; left: 10%; }
+  .hw__aurora span:nth-child(2) { background: var(--chart-1, #3987e5); top: 10%; right: 5%; animation-delay: -5s; }
+  .hw__aurora span:nth-child(3) { background: var(--c-primary, #b8860b); bottom: -25%; left: 35%; animation-delay: -10s; }
+  @keyframes hw-float { to { transform: translate(6%, 8%) scale(1.1); } }
+  .hw__inner { position: relative; max-width: 680px; margin: 0 auto; }
+  .hw__badge {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.55rem;
+    padding: 0.4rem 0.9rem;
+    border-radius: var(--r-full, 999px);
+    background: rgb(var(--ink-rgb, 255 255 255) / 0.05);
+    border: 1px solid rgb(var(--ink-rgb, 255 255 255) / 0.09);
+    font-size: 0.8125rem;
+    color: var(--c-text-1, #fff);
+  }
+  .hw__pulse { width: 7px; height: 7px; border-radius: 50%; background: var(--chart-pos, #34c38f); box-shadow: 0 0 0 0 rgba(52, 195, 143, 0.6); animation: hw-pulse 2s infinite; }
+  @keyframes hw-pulse { 70% { box-shadow: 0 0 0 8px rgba(52, 195, 143, 0); } 100% { box-shadow: 0 0 0 0 rgba(52, 195, 143, 0); } }
+  .hw__title {
+    margin: 1.5rem 0 1rem;
+    font-size: clamp(2.4rem, 6vw, 4rem);
+    font-weight: 800;
+    letter-spacing: -0.035em;
+    line-height: 1.05;
+    color: var(--c-text-1, #fff);
+    text-wrap: balance;
+  }
+  .hw__subtitle { margin: 0 auto 2.25rem; max-width: 560px; font-size: 1.0625rem; line-height: 1.65; color: var(--c-text-2, #a3a3a3); }
+  .hw__form {
+    display: flex;
+    gap: 0.5rem;
+    max-width: 480px;
+    margin: 0 auto;
+    padding: 0.4rem;
+    border-radius: var(--r-lg, 16px);
+    background: rgb(var(--ink-rgb, 255 255 255) / 0.04);
+    border: 1px solid rgb(var(--ink-rgb, 255 255 255) / 0.1);
+    backdrop-filter: blur(12px);
+    transition: border-color 0.2s ease;
+  }
+  .hw__form:focus-within { border-color: rgb(var(--ink-rgb, 255 255 255) / 0.28); }
+  .hw__input {
+    flex: 1;
+    min-width: 0;
+    min-height: 48px;
+    padding: 0 0.9rem;
+    border: 0;
+    background: transparent;
+    color: var(--c-text-1, #fff);
+    font-size: 1rem;
+    font-family: inherit;
+  }
+  .hw__input::placeholder { color: var(--c-text-3, #737373); }
+  .hw__input:focus { outline: none; }
+  .hw__input[aria-invalid='true'] { box-shadow: inset 0 -2px 0 var(--chart-neg, #f06a6a); }
+  .hw__btn {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.45rem;
+    min-height: 48px;
+    padding: 0 1.25rem;
+    border: 0;
+    border-radius: var(--r-md, 12px);
+    background: var(--c-text-1, #fff);
+    color: var(--c-on-primary, #0a0a0a);
+    font-weight: 650;
+    font-size: 0.9375rem;
+    font-family: inherit;
+    cursor: pointer;
+    white-space: nowrap;
+    transition: transform 0.2s ease, background 0.2s ease;
+  }
+  .hw__btn:hover { background: var(--c-accent, #fef3c7); }
+  .hw__btn:focus-visible { outline: 2px solid var(--c-primary-light, #d4a017); outline-offset: 2px; }
+  .hw__form.is-done .hw__btn { background: var(--chart-pos, #34c38f); }
+  .hw__msg { min-height: 1.5rem; margin: 0.75rem 0 0; font-size: 0.875rem; }
+  .hw__msg[data-state='error'] { color: #ff9b9b; }
+  .hw__msg[data-state='success'] { color: #7ee2b8; }
+  .hw__proof { display: inline-flex; align-items: center; gap: 0.85rem; margin-top: 1.5rem; }
+  .hw__proof p { margin: 0; font-size: 0.875rem; color: var(--c-text-2, #a3a3a3); }
+  .hw__proof strong { color: var(--c-text-1, #fff); }
+  .hw__avatars { display: flex; }
+  .hw__avatars span {
+    display: grid;
+    place-items: center;
+    width: 32px;
+    height: 32px;
+    margin-left: -8px;
+    border-radius: 50%;
+    border: 2px solid var(--c-bg, #050505);
+    font-size: 0.625rem;
+    font-weight: 700;
+    color: #fff;
+  }
+  .hw__avatars span:first-child { margin-left: 0; }
+  .hw__sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }
+  @container (max-width: 520px) {
+    .hw__form { flex-direction: column; }
+    .hw__btn { justify-content: center; }
+    .hw__proof { flex-direction: column; }
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .hw__aurora span, .hw__pulse { animation: none; }
+  }
+</style>

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

@@ -0,0 +1,180 @@
+---
+/**
+ * HowItWorksSteps — Numbered process section ("How it works") with a connecting
+ * line between steps. Horizontal on desktop, vertical on mobile.
+ *
+ * @param {string} eyebrow - Small label above the heading.
+ * @param {string} title - Section heading.
+ * @param {Array<{title: string, text: string, time?: string}>} steps - Ordered steps.
+ * @param {{label: string, href: string}} cta - Optional CTA under the steps.
+ * @param {string} variant - Step marker style (numbers|dots|cards).
+ * @param {string} size - Vertical rhythm (sm|md|lg).
+ * @param {string} className - Extra CSS class.
+ */
+interface Step { title: string; text: string; time?: string }
+interface Props {
+  eyebrow?: string;
+  title?: string;
+  steps?: Step[];
+  cta?: { label: string; href: string };
+  variant?: 'numbers' | 'dots' | 'cards';
+  size?: 'sm' | 'md' | 'lg';
+  className?: string;
+}
+
+const {
+  eyebrow = 'How it works',
+  title = 'Ship a polished page in four steps',
+  steps = [
+    { title: 'Pick sections', text: 'Browse heroes, features, pricing and more in the catalog.', time: '2 min' },
+    { title: 'Copy the code', text: 'Paste components into your Astro project. No install needed.', time: '1 min' },
+    { title: 'Customize props', text: 'Change copy, colors and data through typed props and tokens.', time: '10 min' },
+    { title: 'Deploy', text: 'Build static HTML and ship to any CDN or edge host.', time: '30 s' },
+  ],
+  cta = { label: 'Start building', href: '#' },
+  variant = 'numbers',
+  size = 'md',
+  className = '',
+} = Astro.props;
+
+const id = `hiw-${Math.random().toString(36).slice(2, 8)}`;
+---
+
+<div class="cq-how-it-works-steps-cq">
+<section class={`hiw hiw--${variant} hiw--${size} ${className}`} aria-labelledby={id} style={`--hiw-n:${steps.length}`}>
+  <div class="hiw__inner">
+    <header class="hiw__head">
+      <p class="hiw__eyebrow">{eyebrow}</p>
+      <h2 id={id} class="hiw__title">{title}</h2>
+    </header>
+    <ol class="hiw__steps">
+      {steps.map((s, i) => (
+        <li class="hiw__step" style={`--i:${i}`}>
+          <span class="hiw__marker" aria-hidden="true">{variant === 'dots' ? '' : String(i + 1).padStart(2, '0')}</span>
+          <div class="hiw__body">
+            <h3 class="hiw__step-title"><span class="hiw__sr">Step {i + 1}: </span>{s.title}</h3>
+            <p class="hiw__text">{s.text}</p>
+            {s.time && (
+              <span class="hiw__time">
+                <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><circle cx="12" cy="12" r="10" /><path d="M12 6v6l4 2" /></svg>
+                {s.time}
+              </span>
+            )}
+          </div>
+        </li>
+      ))}
+    </ol>
+    {cta && (
+      <div class="hiw__cta">
+        <a href={cta.href}>{cta.label}</a>
+      </div>
+    )}
+  </div>
+</section>
+</div>
+<style>
+  .cq-how-it-works-steps-cq { container-type: inline-size; }
+  .hiw {
+    --hiw-py: 5.5rem;
+    padding: var(--hiw-py) var(--sp-6, 1.5rem);
+    background: var(--c-bg, #050505);
+  }
+  .hiw--sm { --hiw-py: 3.5rem; }
+  .hiw--lg { --hiw-py: 7.5rem; }
+  .hiw__inner { max-width: 1180px; margin: 0 auto; }
+  .hiw__head { text-align: center; margin-bottom: 3.5rem; }
+  .hiw__eyebrow { margin: 0 0 0.75rem; font-size: 0.8125rem; font-weight: 650; letter-spacing: 0.08em; text-transform: uppercase; color: var(--c-primary-light, #d4a017); }
+  .hiw__title { margin: 0; font-size: clamp(1.9rem, 4vw, 2.75rem); font-weight: 800; letter-spacing: -0.03em; color: var(--c-text-1, #fff); text-wrap: balance; }
+  .hiw__steps {
+    position: relative;
+    list-style: none;
+    margin: 0;
+    padding: 0;
+    display: grid;
+    grid-template-columns: repeat(var(--hiw-n), minmax(0, 1fr));
+    gap: 2rem;
+  }
+  .hiw__steps::before {
+    content: '';
+    position: absolute;
+    top: 24px;
+    left: calc(100% / var(--hiw-n) / 2);
+    right: calc(100% / var(--hiw-n) / 2);
+    height: 1px;
+    background: linear-gradient(90deg, color-mix(in srgb, var(--c-primary-light, #d4a017) 60%, transparent), rgb(var(--ink-rgb, 255 255 255) / 0.1));
+  }
+  .hiw--cards .hiw__steps::before { display: none; }
+  .hiw__step {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    text-align: center;
+    animation: hiw-in 0.6s ease both;
+    animation-delay: calc(var(--i) * 120ms);
+  }
+  .hiw--cards .hiw__step {
+    align-items: flex-start;
+    text-align: left;
+    padding: 1.5rem;
+    border-radius: var(--r-lg, 20px);
+    background: rgb(var(--ink-rgb, 255 255 255) / 0.025);
+    border: 1px solid var(--c-border, rgb(var(--ink-rgb, 255 255 255) / 0.07));
+  }
+  @keyframes hiw-in { from { opacity: 0; transform: translateY(10px); } }
+  .hiw__marker {
+    position: relative;
+    z-index: 1;
+    display: grid;
+    place-items: center;
+    width: 48px;
+    height: 48px;
+    margin-bottom: 1.25rem;
+    border-radius: 50%;
+    background: var(--c-bg-1, #0a0a0a);
+    border: 1px solid color-mix(in srgb, var(--c-primary-light, #d4a017) 45%, transparent);
+    color: var(--c-primary-light, #d4a017);
+    font-family: var(--font-mono, monospace);
+    font-size: 0.875rem;
+    font-weight: 700;
+    box-shadow: 0 0 0 6px var(--c-bg, #050505);
+  }
+  .hiw--dots .hiw__marker { width: 16px; height: 16px; margin: 16px 0 1.5rem; background: var(--c-primary-light, #d4a017); }
+  .hiw__step-title { margin: 0 0 0.5rem; font-size: 1.125rem; font-weight: 650; color: var(--c-text-1, #fff); }
+  .hiw__text { margin: 0; font-size: 0.9375rem; line-height: 1.6; color: var(--c-text-2, #a3a3a3); }
+  .hiw__time {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.35rem;
+    margin-top: 0.85rem;
+    padding: 0.2rem 0.6rem;
+    border-radius: var(--r-full, 999px);
+    background: rgb(var(--ink-rgb, 255 255 255) / 0.05);
+    font-size: 0.75rem;
+    color: var(--c-text-2, #a3a3a3);
+  }
+  .hiw__sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }
+  .hiw__cta { text-align: center; margin-top: 3rem; }
+  .hiw__cta a {
+    display: inline-flex;
+    align-items: center;
+    min-height: 48px;
+    padding: 0 1.5rem;
+    border-radius: var(--r-md, 12px);
+    background: var(--c-primary-light, #d4a017);
+    color: var(--c-on-primary, #0a0a0a);
+    font-weight: 650;
+    text-decoration: none;
+    transition: background 0.2s ease;
+  }
+  .hiw__cta a:hover { background: var(--c-accent, #fef3c7); color: var(--c-on-primary, #0a0a0a); }
+  .hiw__cta a:focus-visible { outline: 2px solid var(--c-primary-light, #d4a017); outline-offset: 3px; }
+  @container (max-width: 820px) {
+    .hiw__steps { grid-template-columns: 1fr; gap: 1.75rem; }
+    .hiw__steps::before { top: 24px; bottom: 24px; left: 24px; right: auto; width: 1px; height: auto; background: linear-gradient(180deg, color-mix(in srgb, var(--c-primary-light, #d4a017) 60%, transparent), rgb(var(--ink-rgb, 255 255 255) / 0.1)); }
+    .hiw__step { flex-direction: row; align-items: flex-start; text-align: left; gap: 1.25rem; }
+    .hiw__marker { flex-shrink: 0; margin-bottom: 0; }
+    .hiw--dots .hiw__marker { margin: 16px 16px 0; }
+  }
+  @media (prefers-reduced-motion: reduce) { .hiw__step { animation: none; } }
+</style>