ferst-core 0.1.0 → 0.2.0

package/components/DocLayout.astro

@@ -1,292 +0,0 @@
----
-/**
- * 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

@@ -1,164 +0,0 @@
----
-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>

package/components/LatestPostList.astro

@@ -1,64 +0,0 @@
----
-import type { CollectionEntry } from 'astro:content';
-import Card from './Card.astro';
-import PostCard from './PostCard.astro';
-
-interface Props {
-  posts: CollectionEntry<'posts'>[];
-}
-
-const { posts } = Astro.props;
----
-
-<ul class="latest-list">
-  {
-    posts.map((post) => (
-      <li class="latest-list__item">
-        <Card padding="0" class="latest-list__card">
-          <PostCard post={post} withImage />
-        </Card>
-      </li>
-    ))
-  }
-</ul>
-
-<style>
-  .latest-list {
-    list-style: none;
-    padding: 0;
-    margin: 0;
-    display: grid;
-    grid-template-columns: 1fr;
-    gap: 1rem;
-  }
-
-  @media (min-width: 48em) {
-    .latest-list {
-      grid-template-columns: repeat(2, 1fr);
-      gap: 1.25rem;
-    }
-  }
-
-  @media (min-width: 64em) {
-    .latest-list {
-      grid-template-columns: repeat(3, 1fr);
-      gap: 1.5rem;
-    }
-  }
-
-  /* display: grid (not flex/block) so this reliably stretches its one child
-     (.latest-list__card) to the full row height — a plain block wrapper
-     doesn't pass a grid-stretched height down to a nested child the same
-     way. Kept as a separate element from the Card itself so the
-     reveal-on-scroll transform/opacity (armReveal, applied in
-     [...page].astro) doesn't collide with Card's own hover transition on
-     the same element. */
-  .latest-list__item {
-    display: grid;
-  }
-
-  .latest-list__card :global(.post-card) {
-    border-bottom: none;
-    padding: 0;
-  }
-</style>

package/components/PaginationNav.astro

@@ -1,81 +0,0 @@
----
-import Button from './Button.astro';
-
-interface Props {
-  currentPage: number;
-  lastPage: number;
-  prevUrl: string | undefined;
-  nextUrl: string | undefined;
-}
-
-const { currentPage, lastPage, prevUrl, nextUrl } = Astro.props;
----
-
-<nav class="pagination-nav" aria-label="Pagination navigation">
-  <div class="pagination-nav__controls">
-    {prevUrl ? (
-      <Button href={prevUrl} variant="primary" size="sm" rel="prev" class="pagination-nav__btn" style="border-radius: 8px;">
-        ← Prev
-      </Button>
-    ) : (
-      <Button variant="primary" size="sm" disabled aria-disabled="true" class="pagination-nav__btn" style="border-radius: 8px;">
-        ← Prev
-      </Button>
-    )}
-
-    <span class="pagination-nav__info">
-      Page {currentPage} of {lastPage}
-    </span>
-
-    {nextUrl ? (
-      <Button href={nextUrl} variant="primary" size="sm" rel="next" class="pagination-nav__btn" style="border-radius: 8px;">
-        Next →
-      </Button>
-    ) : (
-      <Button variant="primary" size="sm" disabled aria-disabled="true" class="pagination-nav__btn" style="border-radius: 8px;">
-        Next →
-      </Button>
-    )}
-  </div>
-</nav>
-
-<style>
-  .pagination-nav {
-    display: flex;
-    justify-content: center;
-  }
-
-  .pagination-nav__controls {
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    gap: clamp(1.5rem, 3vw, 2.5rem);
-    flex-wrap: wrap;
-  }
-
-  .pagination-nav__info {
-    font-family: 'Inter', sans-serif;
-    font-size: clamp(0.875rem, 1.5vw, 1rem);
-    line-height: 1.4;
-    color: var(--muted);
-    white-space: nowrap;
-  }
-
-  :global([data-theme='dark']) .pagination-nav__info {
-    color: var(--text-light);
-  }
-
-  /* Mobile: tighter spacing */
-  @media (max-width: 47.9375em) {
-    .pagination-nav__controls {
-      gap: 0.75rem;
-    }
-
-    .pagination-nav__info {
-      font-size: 0.8rem;
-      order: 3;
-      width: 100%;
-      text-align: center;
-    }
-  }
-</style>

package/components/PostsToolbar.astro

@@ -1,83 +0,0 @@
----
-interface Props {
-  availableTags: string[];
-  activeTag?: string;
-  tagCounts: Record<string, number>;
-  totalCount: number;
-}
-
-const { availableTags, activeTag = '', tagCounts, totalCount } = Astro.props;
----
-
-<div class="tag-filters" role="group" aria-label="Filter posts by category">
-  <a
-    href="/posts/"
-    class:list={['tag-filter', { active: !activeTag }]}
-    aria-current={!activeTag ? 'true' : undefined}
-  >
-    All Posts ({totalCount})
-  </a>
-
-  {availableTags.map((tag) => (
-    <a
-      href={`/posts/tag/${tag}/`}
-      class:list={['tag-filter', { active: activeTag === tag }]}
-      aria-current={activeTag === tag ? 'true' : undefined}
-    >
-      {tag} ({tagCounts[tag] ?? 0})
-    </a>
-  ))}
-</div>
-
-<style>
-  .tag-filters {
-    display: flex;
-    flex-wrap: wrap;
-    gap: 0.55rem;
-  }
-
-  .tag-filter {
-    font-family: 'Poppins', sans-serif;
-    font-weight: 600;
-    font-size: 0.75rem;
-    letter-spacing: 0.03em;
-    padding: 0.5rem 1rem;
-    border-radius: 999px;
-    background: rgba(200, 151, 58, 0.1);
-    color: var(--fg);
-    border: 1px solid transparent;
-    text-decoration: none;
-    text-transform: capitalize;
-    transition: background 0.15s ease, border-color 0.15s ease, color 0.15s ease;
-  }
-
-  .tag-filter:hover {
-    border-color: var(--gold);
-    color: var(--gold);
-  }
-
-  .tag-filter:focus-visible {
-    outline: 2px solid var(--gold);
-    outline-offset: 2px;
-  }
-
-  .tag-filter.active {
-    background: var(--gold);
-    color: #2A1F12;
-  }
-
-  :global([data-theme='dark']) .tag-filter {
-    background: rgba(255, 255, 255, 0.06);
-    color: var(--text-light);
-  }
-
-  :global([data-theme='dark']) .tag-filter:hover {
-    border-color: var(--gold);
-    color: var(--gold);
-  }
-
-  :global([data-theme='dark']) .tag-filter.active {
-    background: var(--gold);
-    color: #2A1F12;
-  }
-</style>