ferst-core 0.1.0

package/components/CookiePreferences.astro

@@ -0,0 +1,232 @@
+---
+/**
+ * The site's one real cookie/privacy control, opened by the footer's
+ * "Cookie preferences" button (SiteFooter.astro dispatches
+ * `open-cookie-preferences`).
+ *
+ * There used to also be a general "essential cookies, Got it" notice
+ * (CookieBar.astro) shown on every page. Removed: this site sets no
+ * cookies of its own (local storage only, see /cookie-policy/), so that
+ * notice was pure FYI with no actual decision behind it — and it showed
+ * *alongside* this panel's real toggle when both happened to be
+ * unacknowledged (e.g. after a full localStorage clear), reading as two
+ * redundant cookie popups stacked on screen. The Google Calendar embed
+ * (the site's one real third-party cookie source, see
+ * /cookie-policy/#third-party) is the only place with an actual choice,
+ * so it's the only thing here.
+ */
+---
+
+<div class="cookie-prefs" id="cookie-prefs" aria-label="Cookie preferences">
+  <div class="cookie-prefs__head">
+    <h2>Cookie preferences</h2>
+    <button type="button" class="cookie-prefs__close" id="cookie-prefs-close" aria-label="Close cookie preferences">
+      <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+        <path d="M18 6 6 18M6 6l12 12"></path>
+      </svg>
+    </button>
+  </div>
+
+  <div class="cookie-prefs__row">
+    <div class="cookie-prefs__row-text">
+      <p class="cookie-prefs__row-title">Google Calendar</p>
+      <p class="cookie-prefs__row-desc">Loads the embedded calendar on the <a href="/calendar/">Calendar</a> page. Google may set its own cookies once it's loaded.</p>
+    </div>
+    <button
+      type="button"
+      class="cookie-prefs__switch"
+      id="cookie-prefs-calendar-toggle"
+      role="switch"
+      aria-checked="false"
+      aria-label="Allow Google Calendar embed"
+    >
+      <span class="cookie-prefs__switch-thumb"></span>
+    </button>
+  </div>
+
+  <div class="cookie-prefs__foot">
+    <a href="/cookie-policy/" class="cookie-prefs__link">Cookie policy</a>
+  </div>
+</div>
+
+<style is:global>
+  .cookie-prefs {
+    position: fixed;
+    left: 20px;
+    bottom: 20px;
+    z-index: 200;
+    display: flex;
+    flex-direction: column;
+    gap: 0.9rem;
+    width: min(400px, calc(100vw - 40px));
+    padding: 1.1rem 1.2rem;
+    background: var(--bg-surface);
+    border: 1px solid var(--border);
+    border-radius: 14px;
+    box-shadow: 0 16px 40px rgba(0,0,0,0.18);
+    transform: translateY(12px);
+    opacity: 0;
+    visibility: hidden;
+    transition: transform 0.4s cubic-bezier(0.16, 1, 0.3, 1), opacity 0.4s ease, visibility 0.4s;
+  }
+  .cookie-prefs.visible {
+    transform: translateY(0);
+    opacity: 1;
+    visibility: visible;
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .cookie-prefs { transition: opacity 0.2s ease, visibility 0.2s; transform: none; }
+  }
+
+  .cookie-prefs__head {
+    display: flex;
+    align-items: flex-start;
+    justify-content: space-between;
+    gap: 0.75rem;
+  }
+  .cookie-prefs__head h2 {
+    margin: 0;
+    font-family: 'Poppins', sans-serif;
+    font-size: 0.92rem;
+    font-weight: 600;
+    color: var(--fg);
+  }
+  .cookie-prefs__close {
+    flex-shrink: 0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 26px;
+    height: 26px;
+    padding: 0;
+    background: none;
+    border: none;
+    border-radius: 6px;
+    color: var(--muted);
+    cursor: pointer;
+    transition: background 0.15s ease, color 0.15s ease;
+  }
+  .cookie-prefs__close:hover { background: var(--bg-section); color: var(--fg); }
+  .cookie-prefs__close:focus-visible { outline: 2px solid var(--fg); outline-offset: 2px; }
+
+  .cookie-prefs__row {
+    display: flex;
+    align-items: flex-start;
+    gap: 0.9rem;
+    padding-top: 0.9rem;
+    border-top: 1px solid var(--border);
+  }
+  .cookie-prefs__row-text { min-width: 0; }
+  .cookie-prefs__row-title {
+    margin: 0 0 0.2rem;
+    font-family: 'Poppins', sans-serif;
+    font-size: 0.82rem;
+    font-weight: 600;
+    color: var(--fg);
+  }
+  .cookie-prefs__row-desc {
+    margin: 0;
+    font-family: 'Poppins', sans-serif;
+    font-size: 0.76rem;
+    line-height: 1.5;
+    color: var(--muted);
+  }
+  .cookie-prefs__row-desc a {
+    color: var(--muted);
+    text-decoration: underline;
+    text-underline-offset: 2px;
+  }
+  .cookie-prefs__row-desc a:hover { color: var(--fg); }
+
+  .cookie-prefs__switch {
+    flex-shrink: 0;
+    position: relative;
+    width: 40px;
+    height: 24px;
+    margin-top: 0.1rem;
+    padding: 2px;
+    background: var(--border);
+    border: none;
+    border-radius: 999px;
+    cursor: pointer;
+    transition: background 0.18s ease;
+    touch-action: manipulation;
+  }
+  .cookie-prefs__switch-thumb {
+    display: block;
+    width: 20px;
+    height: 20px;
+    border-radius: 50%;
+    background: var(--bg-surface);
+    box-shadow: 0 1px 2px rgba(0,0,0,0.25);
+    transition: transform 0.18s ease;
+  }
+  .cookie-prefs__switch[aria-checked="true"] { background: var(--gold); }
+  .cookie-prefs__switch[aria-checked="true"] .cookie-prefs__switch-thumb { transform: translateX(16px); }
+  .cookie-prefs__switch:focus-visible {
+    outline: 2px solid var(--fg);
+    outline-offset: 2px;
+  }
+
+  .cookie-prefs__foot {
+    padding-top: 0.9rem;
+    border-top: 1px solid var(--border);
+  }
+  .cookie-prefs__link {
+    font-family: 'Poppins', sans-serif;
+    font-size: 0.78rem;
+    color: var(--muted);
+    text-decoration: underline;
+    text-underline-offset: 2px;
+  }
+  .cookie-prefs__link:hover { color: var(--fg); }
+  .cookie-prefs__link:focus-visible {
+    outline: 2px solid var(--fg);
+    outline-offset: 2px;
+  }
+
+  @media (max-width: 47.9375em) {
+    .cookie-prefs {
+      left: 12px;
+      right: 12px;
+      bottom: 12px;
+      width: auto;
+      padding: 1rem;
+    }
+  }
+</style>
+
+<script>
+  const CALENDAR_KEY = 'calendar-consent';
+
+  const panel = document.getElementById('cookie-prefs') as HTMLElement;
+  const closeBtn = document.getElementById('cookie-prefs-close') as HTMLButtonElement;
+  const calendarToggle = document.getElementById('cookie-prefs-calendar-toggle') as HTMLButtonElement;
+
+  function syncToggle() {
+    const allowed = localStorage.getItem(CALENDAR_KEY) === '1';
+    calendarToggle.setAttribute('aria-checked', String(allowed));
+  }
+
+  function open() {
+    syncToggle();
+    panel.classList.add('visible');
+  }
+
+  function close() {
+    panel.classList.remove('visible');
+  }
+
+  calendarToggle.addEventListener('click', () => {
+    const next = calendarToggle.getAttribute('aria-checked') !== 'true';
+    calendarToggle.setAttribute('aria-checked', String(next));
+    localStorage.setItem(CALENDAR_KEY, next ? '1' : '0');
+    document.dispatchEvent(new CustomEvent('calendar-consent-changed', { detail: { allowed: next } }));
+  });
+
+  closeBtn.addEventListener('click', close);
+  document.addEventListener('keydown', (e) => {
+    if (e.key === 'Escape' && panel.classList.contains('visible')) close();
+  });
+  document.addEventListener('open-cookie-preferences', open);
+</script>

package/components/DocLayout.astro

@@ -0,0 +1,292 @@
+---
+/**
+ * Shared chrome for the site's legal/policy pages (e.g. Privacy, Terms &
+ * Conditions, Accessibility): eyebrow +
+ * title + optional dek/"updated" badge, an optional highlighted callout,
+ * and — once a page has more than one `sections` entry — a sticky "On
+ * this page" rail with scroll-spy, matching the anchor ids of the
+ * <section> elements the page itself supplies via the default slot.
+ *
+ * Deliberately data-driven (an explicit `sections` prop) rather than
+ * auto-walking the slotted h2s at runtime: only 4 pages use this, their
+ * structure rarely changes, and a static id/label pair is simpler and more
+ * robust than id-slugification.
+ */
+import Base from '../layouts/Base.astro';
+
+interface Props {
+  title: string;
+  eyebrow?: string;
+  dek?: string;
+  updated?: string;
+  noteLabel?: string;
+  noteText?: string;
+  sections?: { id: string; label: string }[];
+}
+
+const {
+  title,
+  eyebrow = 'Legal & Policies',
+  dek,
+  updated,
+  noteLabel,
+  noteText,
+  sections = [],
+} = Astro.props;
+
+const showToc = sections.length > 1;
+---
+
+<Base title={title} description={dek} showSecondaryLogo>
+  <div class="doc-page" id="top">
+    <div class="doc-head">
+      <h4>{eyebrow}</h4>
+      <h1>{title}</h1>
+      {dek && <p class="t-lead doc-dek">{dek}</p>}
+      {updated && <span class="doc-updated">Updated {updated}</span>}
+    </div>
+
+    <div class:list={['doc-grid', { 'doc-grid--no-toc': !showToc }]}>
+      {showToc && (
+        <nav class="toc-rail" aria-label="On this page">
+          <p class="toc-label">On this page</p>
+          <ul class="toc-list">
+            {sections.map((s) => (
+              <li><a href={`#${s.id}`} data-toc-link={s.id}>{s.label}</a></li>
+            ))}
+          </ul>
+        </nav>
+      )}
+
+      <div class="doc-body">
+        <slot name="lead" />
+        {(noteLabel || noteText) && (
+          <div class="key-point">
+            <span class="key-point__icon" aria-hidden="true">
+              <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2v20M2 12h20"></path></svg>
+            </span>
+            <div>
+              {noteLabel && <p class="key-point__label">{noteLabel}</p>}
+              {noteText && <p class="key-point__text">{noteText}</p>}
+            </div>
+          </div>
+        )}
+        <slot />
+        {showToc && (
+          <a class="back-to-top" href="#top">
+            <span class="back-to-top__arrow" aria-hidden="true">&uarr;</span> Back to top
+          </a>
+        )}
+      </div>
+    </div>
+  </div>
+</Base>
+
+<style>
+  .doc-page { display: flex; flex-direction: column; }
+
+  .doc-head { max-width: 46rem; }
+  .doc-head h1 { text-align: left; }
+  .doc-dek { color: var(--muted); max-width: 56ch; margin: 0.5rem 0 1rem; }
+
+  .doc-updated {
+    display: inline-flex;
+    align-items: center;
+    font-family: 'Poppins', sans-serif;
+    font-size: 0.65rem;
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 0.08em;
+    color: var(--brown);
+    background: rgba(180, 145, 70, 0.22);
+    border-radius: 4px;
+    padding: 0.2rem 0.5rem;
+    line-height: 1.2;
+  }
+  :global(html[data-theme='dark']) .doc-updated {
+    color: var(--text-light);
+    background: rgba(255, 255, 255, 0.12);
+  }
+
+  .key-point {
+    display: flex;
+    gap: 0.85rem;
+    padding: 1rem 1.15rem;
+    background: rgba(200, 151, 58, 0.1);
+    border: 1px solid rgba(200, 151, 58, 0.35);
+    border-radius: 10px;
+  }
+  :global(html[data-theme='dark']) .key-point {
+    background: rgba(255, 255, 255, 0.045);
+    border-color: rgba(232, 168, 74, 0.35);
+  }
+  .key-point__icon {
+    flex-shrink: 0;
+    width: 28px;
+    height: 28px;
+    border-radius: 8px;
+    background: var(--gold);
+    color: var(--bg-surface);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+  }
+  .key-point__label {
+    font-family: 'Poppins', sans-serif;
+    font-size: 0.7rem;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.08em;
+    color: var(--brown);
+    margin: 0 0 0.25rem;
+  }
+  :global(html[data-theme='dark']) .key-point__label { color: var(--text-light); }
+  .key-point__text { margin: 0; }
+
+  .doc-grid {
+    display: grid;
+    grid-template-columns: 1fr;
+    gap: 2.25rem;
+    align-items: start;
+  }
+  @media (min-width: 62em) {
+    .doc-grid:not(.doc-grid--no-toc) {
+      grid-template-columns: 200px minmax(0, 46rem);
+    }
+  }
+
+  .toc-rail { position: static; }
+  @media (min-width: 62em) {
+    .toc-rail { position: sticky; top: 5.5rem; }
+  }
+  .toc-label {
+    font-family: 'Poppins', sans-serif;
+    font-size: 0.68rem;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.1em;
+    color: var(--text-subtle);
+    margin: 0 0 0.7rem;
+  }
+  .toc-list {
+    list-style: none;
+    margin: 0;
+    padding: 0;
+    display: flex;
+    flex-direction: column;
+    gap: 0.15rem;
+    border-left: 2px solid var(--border);
+  }
+  .toc-list a {
+    display: block;
+    padding: 0.4rem 0 0.4rem 0.85rem;
+    margin-left: -2px;
+    border-left: 2px solid transparent;
+    font-size: 0.85rem;
+    font-weight: 500;
+    color: var(--muted);
+    text-decoration: none;
+  }
+  .toc-list a:hover { color: var(--brown); }
+  :global(html[data-theme='dark']) .toc-list a:hover { color: var(--gold); }
+  .toc-list a.is-active {
+    color: var(--brown);
+    border-left-color: var(--gold);
+    font-weight: 700;
+  }
+  :global(html[data-theme='dark']) .toc-list a.is-active { color: var(--gold); }
+
+  /* Layout does the spacing here (matches .post-detail's technique in
+     posts/[...slug].astro) rather than per-element margins, since the
+     lead slot, the key-point box, and each <section> are siblings of
+     varying content whose own p/li margins are zeroed globally by
+     Base.astro — margin-based spacing between them silently collapsed
+     to nothing without this. */
+  .doc-body {
+    min-width: 0;
+    display: flex;
+    flex-direction: column;
+    gap: clamp(1.1rem, 2vw, 1.5rem);
+  }
+  .doc-body :global(section) {
+    display: flex;
+    flex-direction: column;
+    gap: clamp(0.85rem, 1.5vw, 1.1rem);
+    scroll-margin-top: 5rem;
+  }
+  .doc-body :global(section + section) {
+    margin-top: 1.1rem;
+    padding-top: 2.25rem;
+    border-top: 1px solid var(--border);
+  }
+  .doc-body :global(h2) { margin: 0; text-align: left; }
+  .doc-body :global(ol),
+  .doc-body :global(ul) { margin: 0; padding-left: 1.25rem; }
+  .doc-body :global(ol li),
+  .doc-body :global(ul li) { margin-bottom: 0.75rem; }
+  .doc-body :global(ol li:last-child),
+  .doc-body :global(ul li:last-child) { margin-bottom: 0; }
+  .doc-body :global(li::marker) { color: var(--gold); font-weight: 700; }
+  .doc-body :global(p) { margin: 0; }
+  .doc-body :global(.notice-strap) {
+    font-weight: 700;
+    color: var(--accent);
+    background: var(--gold-light);
+    border-left: 3px solid var(--gold);
+    padding: 0.7rem 0.9rem;
+    border-radius: 0 6px 6px 0;
+    font-size: 0.92rem;
+  }
+  :global(html[data-theme='dark']) .doc-body :global(.notice-strap) { color: var(--text-light); }
+
+  .back-to-top {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.35rem;
+    margin-top: 1.25rem;
+    font-family: 'Poppins', sans-serif;
+    font-size: 0.78rem;
+    font-weight: 700;
+    color: var(--brown);
+    text-transform: uppercase;
+    letter-spacing: 0.06em;
+    transition: color 0.2s ease;
+  }
+  .back-to-top:hover { color: var(--gold); }
+  :global(html[data-theme='dark']) .back-to-top { color: var(--text-light); }
+  :global(html[data-theme='dark']) .back-to-top:hover { color: var(--gold); }
+  .back-to-top__arrow {
+    display: inline-block;
+    transition: transform 0.2s ease;
+  }
+  .back-to-top:hover .back-to-top__arrow { transform: translateY(-3px); }
+  @media (prefers-reduced-motion: reduce) {
+    .back-to-top__arrow { transition: none; }
+    .back-to-top:hover .back-to-top__arrow { transform: none; }
+  }
+</style>
+
+{showToc && (
+  <script>
+    const links = document.querySelectorAll<HTMLAnchorElement>('[data-toc-link]');
+    if (links.length) {
+      const map = new Map<string, HTMLAnchorElement>();
+      links.forEach((l) => {
+        const key = l.dataset.tocLink;
+        if (key) map.set(key, l);
+      });
+      const observer = new IntersectionObserver(
+        (entries) => {
+          entries.forEach((entry) => {
+            const link = map.get(entry.target.id);
+            if (!link || !entry.isIntersecting) return;
+            links.forEach((l) => l.classList.remove('is-active'));
+            link.classList.add('is-active');
+          });
+        },
+        { rootMargin: '-15% 0px -70% 0px' }
+      );
+      document.querySelectorAll('.doc-body section[id]').forEach((s) => observer.observe(s));
+    }
+  </script>
+)}

package/components/GroupCard.astro

@@ -0,0 +1,164 @@
+---
+import Card from './Card.astro';
+import { normalizeMailtoHref } from '../lib/mailLinks';
+
+interface Props {
+  title: string;
+  description: string;
+  icon?: string;
+  contact?: string;
+  contactLabel?: string;
+  linkHref?: string;
+  imageSrc?: string;
+  imageAlt?: string;
+}
+
+const { title, description, contact, contactLabel, linkHref, imageSrc, imageAlt } = Astro.props;
+const trimmedLink = linkHref?.trim();
+const trimmedContact = contact?.trim();
+
+function resolvedGroupHref(): string | undefined {
+  if (trimmedLink) {
+    if (/^https?:\/\//i.test(trimmedLink)) return trimmedLink;
+    if (trimmedLink.startsWith('/') || trimmedLink.startsWith('#')) return trimmedLink;
+    const mail = normalizeMailtoHref(trimmedLink);
+    return mail || undefined;
+  }
+  if (trimmedContact) {
+    const mail = normalizeMailtoHref(trimmedContact);
+    return mail || undefined;
+  }
+}
+
+const resolvedHref = resolvedGroupHref();
+const isExternal = resolvedHref ? /^https?:\/\//.test(resolvedHref) : false;
+const isEmail = resolvedHref ? /^mailto:/.test(resolvedHref) : false;
+---
+
+<Card as="article" padding="0" class="group-card">
+  {imageSrc ? (
+    <img
+      src={imageSrc}
+      alt={imageAlt || title}
+      class="group-card__img"
+      loading="lazy"
+      decoding="async"
+    />
+  ) : (
+    <div class="group-card__placeholder" aria-hidden="true">
+      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" width="48" height="48" aria-hidden="true">
+        <line x1="12" y1="3" x2="12" y2="21"/>
+        <line x1="5" y1="8" x2="19" y2="8"/>
+      </svg>
+    </div>
+  )}
+  <div class="group-card__content">
+    <h3>{title}</h3>
+    <p>{description}</p>
+    {resolvedHref && (
+      <div>
+        <a
+          href={resolvedHref}
+          target={isExternal ? '_blank' : undefined}
+          rel={isExternal ? 'noopener noreferrer' : undefined}
+        >
+          {isEmail && (
+            <svg
+              class="group-card__link-icon"
+              width="14"
+              height="14"
+              viewBox="0 0 24 24"
+              fill="none"
+              stroke="currentColor"
+              stroke-width="2"
+              stroke-linecap="round"
+              stroke-linejoin="round"
+              aria-hidden="true"
+            >
+              <rect x="2" y="4" width="20" height="16" rx="2"></rect>
+              <path d="m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7"></path>
+            </svg>
+          )}
+          {isExternal && (
+            <svg
+              class="group-card__link-icon"
+              width="14"
+              height="14"
+              viewBox="0 0 24 24"
+              fill="none"
+              stroke="currentColor"
+              stroke-width="2"
+              stroke-linecap="round"
+              stroke-linejoin="round"
+              aria-hidden="true"
+            >
+              <path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"></path>
+              <polyline points="15 3 21 3 21 9"></polyline>
+              <line x1="10" y1="14" x2="21" y2="3"></line>
+            </svg>
+          )}
+          {contactLabel || contact}
+        </a>
+      </div>
+    )}
+  </div>
+</Card>
+
+<style>
+  article {
+    margin: 0;
+    height: 100%;
+  }
+
+  .group-card__content {
+    display: flex;
+    flex-direction: column;
+    flex: 1;
+    gap: 0.75rem;
+    padding: 1rem 1.25rem;
+  }
+
+  .group-card__content h3 {
+    margin-block: clamp(0.75rem, 2vw, 1.25rem);
+  }
+
+  .group-card__content > div {
+    margin-top: auto;
+    display: flex;
+    justify-content: flex-end;
+    align-items: flex-end;
+  }
+
+  .group-card__content a {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.375rem;
+  }
+
+  .group-card__content a:hover {
+    color: #755528;
+  }
+
+  :global([data-theme='dark']) .group-card__content a:hover {
+    color: #C8D4C2;
+  }
+
+  img {
+    display: block;
+    width: 100%;
+    aspect-ratio: 16 / 9;
+    object-fit: cover;
+    object-position: center;
+    margin: 0;
+  }
+
+  .group-card__placeholder {
+    width: 100%;
+    aspect-ratio: 16 / 9;
+    background: linear-gradient(135deg, #4A6741 0%, #2C3B2A 100%);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    color: rgba(255, 255, 255, 0.55);
+  }
+</style>