ferst-core 0.1.0 → 0.2.0

package/components/recipes/Stats.astro

@@ -0,0 +1,124 @@
+---
+/** Stats — a Level-2 recipe: a band of headline numbers over an optional
+ *  heading/intro. Composes the Heading primitive; numbers use the brand accent. */
+import Heading from '../blocks/Heading.astro';
+
+interface Item { value: string; label: string; description?: string }
+interface Props {
+  title?: string;
+  intro?: string;
+  background?: 'none' | 'muted' | 'accent';
+  columns?: 2 | 3 | 4;
+  items?: Item[];
+}
+const { title, intro, background = 'muted', columns = 3, items = [] } = Astro.props;
+---
+
+<section class="b-stats" data-bg={background}>
+  <div class="b-stats__inner">
+    {(title || intro) && (
+      <div class="b-stats__head">
+        {title && <Heading text={title} level={2} align="center" />}
+        {intro && <p class="b-stats__intro">{intro}</p>}
+      </div>
+    )}
+    <div class="b-stats__grid" data-cols={columns}>
+      {items.map((item) => (
+        <div class="b-stats__item">
+          <span class="b-stats__value">{item.value}</span>
+          <span class="b-stats__label">{item.label}</span>
+          {item.description && <span class="b-stats__desc">{item.description}</span>}
+        </div>
+      ))}
+    </div>
+  </div>
+</section>
+
+<style>
+  .b-stats { padding-block: clamp(2.5rem, 6vw, 4rem); }
+  .b-stats[data-bg='muted'] { background: var(--bg-section); }
+  .b-stats[data-bg='accent'] { background: var(--gold-light); }
+  .b-stats__inner {
+    max-width: 72rem;
+    margin-inline: auto;
+    padding-inline: 1rem;
+    display: flex;
+    flex-direction: column;
+    gap: 2rem;
+  }
+  .b-stats__head {
+    max-width: var(--max);
+    margin-inline: auto;
+    text-align: center;
+    display: flex;
+    flex-direction: column;
+    gap: 0.75rem;
+  }
+  .b-stats__intro { margin: 0; color: var(--muted); line-height: 1.6; }
+  .b-stats__grid {
+    display: grid;
+    grid-template-columns: 1fr;
+    gap: 1.5rem 2rem;
+  }
+  @media (min-width: 40em) {
+    .b-stats__grid { grid-template-columns: repeat(2, 1fr); }
+  }
+  @media (min-width: 60em) {
+    .b-stats__grid[data-cols='3'] { grid-template-columns: repeat(3, 1fr); }
+    .b-stats__grid[data-cols='4'] { grid-template-columns: repeat(4, 1fr); }
+  }
+  .b-stats__item {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    text-align: center;
+    gap: 0.35rem;
+  }
+  .b-stats__value {
+    font-family: var(--font-heading);
+    font-weight: 700;
+    font-size: clamp(2.25rem, 1.6rem + 2.6vw, 3.25rem);
+    line-height: 1;
+    color: var(--gold);
+  }
+  .b-stats__label { font-weight: 600; color: var(--fg); }
+  .b-stats__desc { font-size: 0.875rem; color: var(--muted); line-height: 1.5; }
+</style>
+
+<script>
+  // Count-up: numbers tick from 0 to their value when they scroll into view.
+  // Progressive — the final value is server-rendered, so with no JS (or under
+  // reduced-motion) it just shows the number. Non-numeric values (One, Any…) are
+  // left untouched; a leading sign / trailing suffix (+, %, " day") is preserved.
+  const reduce = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+  const values = document.querySelectorAll<HTMLElement>('.b-stats__value');
+  if (!reduce && 'IntersectionObserver' in window && values.length) {
+    const parse = (t: string) => {
+      const m = t.match(/^(\D*)(\d[\d,]*(?:\.\d+)?)(.*)$/);
+      if (!m) return null;
+      const decimals = (m[2].split('.')[1] || '').length;
+      return { pre: m[1], num: parseFloat(m[2].replace(/,/g, '')), suf: m[3], decimals };
+    };
+    const fmt = (n: number, d: number) => (d > 0 ? n.toFixed(d) : Math.round(n).toLocaleString());
+    const run = (el: HTMLElement) => {
+      const final = (el.textContent || '').trim();
+      const p = parse(final);
+      if (!p) return;
+      const dur = 1100;
+      const t0 = performance.now();
+      const tick = (now: number) => {
+        const t = Math.min(1, (now - t0) / dur);
+        const eased = 1 - Math.pow(1 - t, 3);
+        el.textContent = p.pre + fmt(p.num * eased, p.decimals) + p.suf;
+        if (t < 1) requestAnimationFrame(tick);
+        else el.textContent = final;
+      };
+      requestAnimationFrame(tick);
+    };
+    const io = new IntersectionObserver(
+      (entries) => entries.forEach((e) => { if (e.isIntersecting) { run(e.target as HTMLElement); io.unobserve(e.target); } }),
+      { threshold: 0.4 }
+    );
+    values.forEach((v) => io.observe(v));
+  }
+</script>

package/components/recipes/Steps.astro

@@ -0,0 +1,120 @@
+---
+/** Steps — a Level-2 recipe: a numbered process. `horizontal` lays connected
+ *  cards in a row; `vertical` a stacked timeline. Composes Heading + Icon. */
+import Heading from '../blocks/Heading.astro';
+import Icon from '../Icon.astro';
+import { isIconKey } from '../../lib/icons';
+
+interface Item { title: string; text?: string; icon?: string }
+interface Props {
+  title?: string;
+  intro?: string;
+  layout?: 'horizontal' | 'vertical';
+  items?: Item[];
+}
+const { title, intro, layout = 'horizontal', items = [] } = Astro.props;
+---
+
+<section class="b-steps" data-layout={layout}>
+  {(title || intro) && (
+    <div class="b-steps__head">
+      {title && <Heading text={title} level={2} align="center" />}
+      {intro && <p class="b-steps__intro">{intro}</p>}
+    </div>
+  )}
+  <ol class="b-steps__list">
+    {items.map((item, i) => (
+      <li class="b-steps__item">
+        <span class="b-steps__marker" aria-hidden="true">
+          {item.icon && isIconKey(item.icon) ? <Icon name={item.icon} size={20} /> : i + 1}
+        </span>
+        <div class="b-steps__body">
+          <h3 class="b-steps__title">{item.title}</h3>
+          {item.text && <p class="b-steps__text">{item.text}</p>}
+        </div>
+      </li>
+    ))}
+  </ol>
+</section>
+
+<style>
+  .b-steps {
+    display: flex;
+    flex-direction: column;
+    gap: 2rem;
+    max-width: 72rem;
+    margin-inline: auto;
+    padding-inline: 1rem;
+  }
+  .b-steps__head {
+    max-width: var(--max);
+    margin-inline: auto;
+    text-align: center;
+    display: flex;
+    flex-direction: column;
+    gap: 0.75rem;
+  }
+  .b-steps__intro { margin: 0; color: var(--muted); line-height: 1.6; }
+  .b-steps__list {
+    list-style: none;
+    margin: 0;
+    padding: 0;
+    display: grid;
+    gap: 1.5rem;
+  }
+  /* Base (and mobile): marker left, body right. */
+  .b-steps__item {
+    display: flex;
+    gap: 1rem;
+    align-items: flex-start;
+  }
+  .b-steps__marker {
+    flex-shrink: 0;
+    width: 2.5rem;
+    height: 2.5rem;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    border-radius: var(--radius-pill);
+    background: var(--gold);
+    color: var(--text-light);
+    font-family: var(--font-heading);
+    font-weight: 700;
+    font-size: 1.05rem;
+  }
+  .b-steps__title { margin: 0 0 0.35rem; font-size: 1.1rem; color: var(--fg); }
+  .b-steps__text { margin: 0; color: var(--muted); line-height: 1.6; }
+
+  /* Vertical: a centred, stacked timeline. */
+  .b-steps[data-layout='vertical'] .b-steps__list { max-width: 40rem; margin-inline: auto; }
+
+  /* Horizontal (≥48em): connected cards in a row, marker over centred body. */
+  @media (min-width: 48em) {
+    .b-steps[data-layout='horizontal'] .b-steps__list {
+      grid-auto-flow: column;
+      grid-auto-columns: 1fr;
+      gap: 1rem;
+    }
+    .b-steps[data-layout='horizontal'] .b-steps__item {
+      flex-direction: column;
+      align-items: center;
+      text-align: center;
+      gap: 0.85rem;
+      position: relative;
+    }
+    /* Connector from this marker's right edge to the next marker's left edge.
+       The +1.5rem / -2rem account for the 2.5rem marker AND the 1rem grid gap,
+       so the line sits centred between markers (not falling short). */
+    .b-steps[data-layout='horizontal'] .b-steps__item:not(:last-child)::after {
+      content: '';
+      position: absolute;
+      top: calc(1.25rem - 1px);
+      left: calc(50% + 1.5rem);
+      width: calc(100% - 2rem);
+      height: 2px;
+      background: var(--border);
+      z-index: 0;
+    }
+    .b-steps[data-layout='horizontal'] .b-steps__marker { position: relative; z-index: 1; }
+  }
+</style>

package/components/recipes/Tabs.astro

@@ -0,0 +1,133 @@
+---
+/** Tabs — a Level-2 recipe: labelled panels, one open at a time. Progressive:
+ *  the first panel is visible with no JavaScript; a small script adds selection,
+ *  ARIA state and arrow-key navigation. Composes the Heading primitive. */
+import Heading from '../blocks/Heading.astro';
+
+interface Item { label: string; heading?: string; text?: string; image?: { src: string; alt?: string } }
+interface Props {
+  title?: string;
+  items?: Item[];
+}
+const { title, items = [] } = Astro.props;
+const uid = 'tabs-' + Math.random().toString(36).slice(2, 9);
+---
+
+<section class="b-tabs">
+  {title && <Heading text={title} level={2} align="center" />}
+  <div class="b-tabs__inner">
+    <div class="b-tabs__list" role="tablist" aria-label={title ?? 'Tabs'}>
+      {items.map((item, i) => (
+        <button
+          type="button"
+          role="tab"
+          id={`${uid}-tab-${i}`}
+          aria-controls={`${uid}-panel-${i}`}
+          aria-selected={i === 0 ? 'true' : 'false'}
+          tabindex={i === 0 ? 0 : -1}
+          class="b-tabs__tab"
+        >
+          {item.label}
+        </button>
+      ))}
+    </div>
+    {items.map((item, i) => (
+      <div
+        role="tabpanel"
+        id={`${uid}-panel-${i}`}
+        aria-labelledby={`${uid}-tab-${i}`}
+        class="b-tabs__panel"
+        hidden={i !== 0}
+        tabindex="0"
+      >
+        {item.image && (
+          <img class="b-tabs__img" src={item.image.src} alt={item.image.alt ?? ''} loading="lazy" decoding="async" />
+        )}
+        <div class="b-tabs__copy">
+          {item.heading && <h3 class="b-tabs__heading">{item.heading}</h3>}
+          {item.text && <p class="b-tabs__text">{item.text}</p>}
+        </div>
+      </div>
+    ))}
+  </div>
+</section>
+
+<style>
+  .b-tabs {
+    display: flex;
+    flex-direction: column;
+    gap: 1.5rem;
+    max-width: 60rem;
+    margin-inline: auto;
+    padding-inline: 1rem;
+  }
+  .b-tabs__list {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.25rem;
+    border-bottom: 1px solid var(--border);
+  }
+  .b-tabs__tab {
+    appearance: none;
+    background: none;
+    border: none;
+    border-bottom: 2px solid transparent;
+    margin-bottom: -1px;
+    padding: 0.7rem 1rem;
+    font-family: var(--font-heading);
+    font-size: 0.95rem;
+    font-weight: 600;
+    color: var(--muted);
+    cursor: pointer;
+    transition: color 0.15s, border-color 0.15s;
+  }
+  .b-tabs__tab:hover { color: var(--fg); }
+  .b-tabs__tab[aria-selected='true'] { color: var(--gold); border-bottom-color: var(--gold); }
+  .b-tabs__tab:focus-visible { outline: 2px solid var(--gold); outline-offset: 2px; border-radius: 4px; }
+  .b-tabs__panel {
+    display: grid;
+    gap: 1.25rem;
+  }
+  /* A class `display` beats the UA `[hidden]{display:none}` (equal specificity,
+     author origin wins), so make the hidden state explicit — for the first paint
+     and every JS toggle. */
+  .b-tabs__panel[hidden] {
+    display: none;
+  }
+  @media (min-width: 48em) {
+    .b-tabs__panel:has(.b-tabs__img) { grid-template-columns: 1fr 1fr; align-items: center; }
+  }
+  .b-tabs__panel:focus-visible { outline: 2px solid var(--gold); outline-offset: 4px; border-radius: var(--radius-sm); }
+  .b-tabs__img { width: 100%; height: auto; border-radius: var(--radius); }
+  .b-tabs__heading { margin: 0 0 0.5rem; color: var(--fg); }
+  .b-tabs__text { margin: 0; color: var(--muted); line-height: 1.65; }
+</style>
+
+<script>
+  // Wire every tabs group on the page: selection, ARIA state, arrow-key nav.
+  document.querySelectorAll<HTMLElement>('.b-tabs').forEach((root) => {
+    const tabs = Array.from(root.querySelectorAll<HTMLButtonElement>('[role="tab"]'));
+    const panels = Array.from(root.querySelectorAll<HTMLElement>('[role="tabpanel"]'));
+    if (!tabs.length) return;
+
+    function select(index: number, focus = true) {
+      tabs.forEach((tab, i) => {
+        const on = i === index;
+        tab.setAttribute('aria-selected', on ? 'true' : 'false');
+        tab.tabIndex = on ? 0 : -1;
+        panels[i]?.toggleAttribute('hidden', !on);
+      });
+      if (focus) tabs[index]?.focus();
+    }
+
+    tabs.forEach((tab, i) => {
+      tab.addEventListener('click', () => select(i, false));
+      tab.addEventListener('keydown', (e) => {
+        if (e.key === 'ArrowRight' || e.key === 'ArrowDown') { e.preventDefault(); select((i + 1) % tabs.length); }
+        else if (e.key === 'ArrowLeft' || e.key === 'ArrowUp') { e.preventDefault(); select((i - 1 + tabs.length) % tabs.length); }
+        else if (e.key === 'Home') { e.preventDefault(); select(0); }
+        else if (e.key === 'End') { e.preventDefault(); select(tabs.length - 1); }
+      });
+    });
+  });
+</script>

package/components/recipes/Testimonial.astro

@@ -0,0 +1,66 @@
+---
+/** Testimonial — a Level-2 recipe: a centred quotation with author, optional
+ *  role, and optional avatar. */
+interface Props {
+  quote: string;
+  author: string;
+  role?: string;
+  avatar?: { src: string; alt?: string };
+}
+const { quote, author, role, avatar } = Astro.props;
+---
+
+<figure class="b-testimonial">
+  <blockquote class="b-testimonial__quote">{`“${quote}”`}</blockquote>
+  <figcaption class="b-testimonial__by">
+    {avatar && <img class="b-testimonial__avatar" src={avatar.src} alt={avatar.alt ?? ''} loading="lazy" decoding="async" />}
+    <span class="b-testimonial__meta">
+      <span class="b-testimonial__author">{author}</span>
+      {role && <span class="b-testimonial__role">{role}</span>}
+    </span>
+  </figcaption>
+</figure>
+
+<style>
+  .b-testimonial {
+    max-width: var(--max);
+    margin-inline: auto;
+    padding-inline: 1rem;
+    text-align: center;
+    display: flex;
+    flex-direction: column;
+    gap: 1.25rem;
+    align-items: center;
+  }
+  .b-testimonial__quote {
+    margin: 0;
+    font-size: 1.375rem;
+    line-height: 1.5;
+    color: var(--fg);
+    font-style: italic;
+  }
+  .b-testimonial__by {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.75rem;
+  }
+  .b-testimonial__avatar {
+    width: 44px;
+    height: 44px;
+    border-radius: 999px;
+    object-fit: cover;
+  }
+  .b-testimonial__meta {
+    display: flex;
+    flex-direction: column;
+    text-align: left;
+  }
+  .b-testimonial__author {
+    font-weight: 600;
+    color: var(--fg);
+  }
+  .b-testimonial__role {
+    color: var(--muted);
+    font-size: 0.875rem;
+  }
+</style>

package/components/recipes/Tiles.astro

@@ -0,0 +1,248 @@
+---
+/**
+ * Tiles — a Level-2 recipe: a responsive grid of tiles in one of five looks,
+ * chosen with `variant`:
+ *   outline   — stroke only, no shadow (the "wireframe" look)
+ *   elevated  — soft shadow, lifts on hover
+ *   filled    — soft brand-tinted background
+ *   gradient  — brand → derived accent-2 gradient, light text
+ *   image     — full-bleed photo with a legibility scrim, light text
+ *
+ * Radius, stroke and elevation come from the GLOBAL surface tokens (--radius,
+ * --card-border, --shadow-*), so tiles stay consistent with every other card and
+ * a single knob restyles them all. A tile with `href` becomes one big link.
+ * Composes the Icon primitive.
+ */
+import Heading from '../blocks/Heading.astro';
+import Icon from '../Icon.astro';
+import { isIconKey } from '../../lib/icons';
+
+interface Tile {
+  icon?: string;
+  eyebrow?: string;
+  title: string;
+  text?: string;
+  href?: string;
+  image?: { src: string; alt?: string };
+}
+interface Props {
+  title?: string;
+  intro?: string;
+  columns?: 2 | 3 | 4;
+  variant?: 'outline' | 'elevated' | 'filled' | 'gradient' | 'image';
+  spotlight?: boolean;
+  tiles?: Tile[];
+}
+const { title, intro, columns = 3, variant = 'elevated', spotlight = false, tiles = [] } = Astro.props;
+---
+
+<section class="b-tiles">
+  {(title || intro) && (
+    <div class="b-tiles__head">
+      {title && <Heading text={title} level={2} align="center" />}
+      {intro && <p class="b-tiles__intro">{intro}</p>}
+    </div>
+  )}
+  <div class="b-tiles__grid" data-cols={columns} data-variant={variant} data-spotlight={spotlight ? 'true' : 'false'}>
+    {tiles.map((tile) => {
+      const Tag = tile.href ? 'a' : 'div';
+      const bg =
+        variant === 'image' && tile.image
+          ? `--tile-image: url('${tile.image.src}')`
+          : undefined;
+      return (
+        <Tag class="b-tile" href={tile.href} style={bg}>
+          {tile.icon && isIconKey(tile.icon) && (
+            <span class="b-tile__icon"><Icon name={tile.icon} size={26} /></span>
+          )}
+          {tile.eyebrow && <span class="b-tile__eyebrow">{tile.eyebrow}</span>}
+          <h3 class="b-tile__title">{tile.title}</h3>
+          {tile.text && <p class="b-tile__text">{tile.text}</p>}
+          {tile.href && <span class="b-tile__more" aria-hidden="true">Learn more &rarr;</span>}
+        </Tag>
+      );
+    })}
+  </div>
+</section>
+
+<style>
+  .b-tiles {
+    display: flex;
+    flex-direction: column;
+    gap: 2rem;
+    max-width: 72rem;
+    margin-inline: auto;
+    padding-inline: 1rem;
+  }
+  .b-tiles__head {
+    max-width: var(--max);
+    margin-inline: auto;
+    text-align: center;
+    display: flex;
+    flex-direction: column;
+    gap: 0.75rem;
+  }
+  .b-tiles__intro {
+    margin: 0;
+    color: var(--muted);
+    font-size: 1.0625rem;
+    line-height: 1.6;
+  }
+  .b-tiles__grid {
+    display: grid;
+    grid-template-columns: 1fr;
+    gap: 1.25rem;
+  }
+  @media (min-width: 48em) {
+    .b-tiles__grid[data-cols='2'] { grid-template-columns: repeat(2, 1fr); }
+    .b-tiles__grid[data-cols='3'] { grid-template-columns: repeat(3, 1fr); }
+    .b-tiles__grid[data-cols='4'] { grid-template-columns: repeat(2, 1fr); }
+  }
+  @media (min-width: 64em) {
+    .b-tiles__grid[data-cols='4'] { grid-template-columns: repeat(4, 1fr); }
+  }
+
+  /* Base tile — radius/stroke/shadow all from the global surface tokens. */
+  .b-tile {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+    padding: 1.5rem;
+    border-radius: var(--radius);
+    background: var(--bg-surface);
+    color: var(--fg);
+    text-decoration: none;
+    overflow: hidden;
+    isolation: isolate;
+    transition: transform 0.2s ease, box-shadow 0.2s ease, border-color 0.2s ease;
+  }
+
+  /* ── Variants ── */
+  .b-tiles__grid[data-variant='outline'] .b-tile {
+    border: var(--card-border);
+  }
+  .b-tiles__grid[data-variant='elevated'] .b-tile {
+    box-shadow: var(--shadow-md);
+    border: var(--card-border);
+  }
+  .b-tiles__grid[data-variant='filled'] .b-tile {
+    background: var(--gold-light);
+  }
+  .b-tiles__grid[data-variant='gradient'] .b-tile {
+    background: linear-gradient(135deg, var(--gold), var(--accent-2, var(--gold)));
+    color: var(--text-light);
+  }
+  .b-tiles__grid[data-variant='image'] .b-tile {
+    color: #fff;
+    min-height: 15rem;
+    justify-content: flex-end;
+    background: var(--bg-section);
+  }
+  .b-tiles__grid[data-variant='image'] .b-tile::before {
+    content: '';
+    position: absolute;
+    inset: 0;
+    z-index: -1;
+    background-image: linear-gradient(to top, rgba(10, 12, 20, 0.85), rgba(10, 12, 20, 0.15)), var(--tile-image);
+    background-size: cover;
+    background-position: center;
+  }
+
+  /* Hover: only tiles that link lift. */
+  a.b-tile:hover {
+    transform: translateY(-4px);
+  }
+  .b-tiles__grid[data-variant='elevated'] a.b-tile:hover {
+    box-shadow: var(--shadow-lg);
+  }
+  .b-tiles__grid[data-variant='outline'] a.b-tile:hover {
+    border-color: var(--gold);
+  }
+  a.b-tile:focus-visible {
+    outline: 2px solid var(--gold);
+    outline-offset: 2px;
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .b-tile { transition: none; }
+    a.b-tile:hover { transform: none; }
+  }
+
+  .b-tile__icon {
+    display: inline-flex;
+    color: var(--gold);
+    margin-bottom: 0.25rem;
+  }
+  .b-tiles__grid[data-variant='gradient'] .b-tile__icon,
+  .b-tiles__grid[data-variant='image'] .b-tile__icon {
+    color: currentColor;
+  }
+  .b-tile__eyebrow {
+    font-size: 0.75rem;
+    font-weight: 700;
+    letter-spacing: 0.1em;
+    text-transform: uppercase;
+    color: var(--gold);
+  }
+  .b-tiles__grid[data-variant='gradient'] .b-tile__eyebrow,
+  .b-tiles__grid[data-variant='image'] .b-tile__eyebrow {
+    color: currentColor;
+    opacity: 0.85;
+  }
+  .b-tile__title {
+    margin: 0;
+    font-size: 1.2rem;
+    color: inherit;
+  }
+  .b-tile__text {
+    margin: 0;
+    color: var(--muted);
+    line-height: 1.6;
+  }
+  .b-tiles__grid[data-variant='gradient'] .b-tile__text,
+  .b-tiles__grid[data-variant='image'] .b-tile__text,
+  .b-tiles__grid[data-variant='filled'] .b-tile__text {
+    color: inherit;
+    opacity: 0.92;
+  }
+  .b-tile__more {
+    margin-top: auto;
+    padding-top: 0.5rem;
+    font-size: 0.85rem;
+    font-weight: 600;
+    color: var(--gold);
+  }
+  .b-tiles__grid[data-variant='gradient'] .b-tile__more,
+  .b-tiles__grid[data-variant='image'] .b-tile__more {
+    color: currentColor;
+  }
+
+  /* Spotlight — a soft glow that follows the pointer on hover (opt-in). The glow
+     sits above the surface but below the content, so text stays crisp. */
+  .b-tiles__grid[data-spotlight='true'] .b-tile > * { position: relative; z-index: 1; }
+  .b-tiles__grid[data-spotlight='true'] .b-tile::after {
+    content: '';
+    position: absolute;
+    inset: 0;
+    z-index: 0;
+    border-radius: inherit;
+    background: radial-gradient(18rem 18rem at var(--mx, 50%) var(--my, 50%), color-mix(in srgb, var(--gold) 22%, transparent), transparent 60%);
+    opacity: 0;
+    transition: opacity 0.25s ease;
+    pointer-events: none;
+  }
+  .b-tiles__grid[data-spotlight='true'] .b-tile:hover::after { opacity: 1; }
+</style>
+
+<script>
+  // Spotlight: track the pointer over opt-in tiles and drive the glow position.
+  if (!window.matchMedia('(prefers-reduced-motion: reduce)').matches) {
+    document.querySelectorAll<HTMLElement>('.b-tiles__grid[data-spotlight="true"] .b-tile').forEach((tile) => {
+      tile.addEventListener('pointermove', (e) => {
+        const r = tile.getBoundingClientRect();
+        tile.style.setProperty('--mx', `${((e.clientX - r.left) / r.width) * 100}%`);
+        tile.style.setProperty('--my', `${((e.clientY - r.top) / r.height) * 100}%`);
+      });
+    });
+  }
+</script>