@grove-dev/astro 0.7.0 → 0.8.0

package/src/components/CollectionPage.astro

@@ -1,128 +0,0 @@
----
-/**
- * CollectionPage — renders a single curated/generated collection.
- *
- * Consumes a `CollectionPageModel` produced by `getCollectionPageModel`.
- * Renders the header via `SectionHeader` (framework consistency),
- * the matched entries via `CollectionRow`, and a related-collections
- * section.
- *
- * Generic: no blueprint-specific copy. Consumers can override
- * `eyebrow`, `title`, `description`; the `<slot name="intro">` is
- * the natural place for editorial intros (markdown rendered with
- * the consumer's content pipeline). `emptyLabel` matches
- * `RecordSection`'s API for empty-state copy.
- */
-import { formatCount } from "@grove-dev/core";
-import CardGrid from "./CardGrid.astro";
-import CollectionRow from "./CollectionRow.astro";
-import Container from "../layouts/Container.astro";
-import SectionHeader from "../layouts/SectionHeader.astro";
-import EmptyState from "../ui/EmptyState.astro";
-import type { CollectionPageModel } from "../server/collections.js";
-
-interface Props {
-  model: CollectionPageModel;
-  /** Override the eyebrow text (default: derived from collection kind). */
-  eyebrow?: string;
-  /** Override the title (default: collection.title). */
-  title?: string;
-  /** Override the description (default: collection.description). */
-  description?: string;
-  /** Default copy when the collection has no matching entries. */
-  emptyLabel?: string;
-  /** Section id (deep link + stable key). */
-  id?: string;
-  /**
-   * Heading level for the collection title. This component IS the
-   * page on collection detail routes, so it defaults to 1.
-   */
-  headingLevel?: 1 | 2;
-  /** Noun pair for the entry count (blueprint labels). */
-  countNoun?: { singular: string; plural: string };
-  class?: string;
-}
-
-const {
-  model,
-  eyebrow,
-  title,
-  description,
-  emptyLabel = "This collection is currently empty.",
-  id,
-  headingLevel = 1,
-  countNoun = { singular: "item", plural: "items" },
-  class: className = "",
-} = Astro.props;
-
-const finalTitle = title ?? model.collection.title;
-const finalDescription = description ?? model.collection.description;
-const finalEyebrow = eyebrow ?? (model.collection.kind === "curated" ? "Curated collection" : "Generated collection");
----
-
-<section id={id} class={`py-12 sm:py-16 ${className}`}>
-  <Container>
-    <SectionHeader eyebrow={finalEyebrow} title={finalTitle} description={finalDescription} level={headingLevel} />
-
-    {/* Editorial context reads as a quiet callout, not metadata
-        shouting in uppercase. */}
-    {model.collection.selectionNote && (
-      <aside class="mb-6 max-w-[64ch] rounded-[var(--radius-lg)] border-l-2 border-border bg-surface-sunken px-4 py-3">
-        <p class="m-0 text-2xs font-medium uppercase tracking-wider text-muted-foreground">
-          Selection criteria
-        </p>
-        <p class="m-0 mt-1 text-[0.875rem] leading-relaxed text-foreground">
-          {model.collection.selectionNote}
-        </p>
-      </aside>
-    )}
-
-    <slot name="intro" />
-
-    {/* Bridges the heading outline: the page title is an h1 and the
-        entry cards render h3 titles — without this h2 Lighthouse
-        flags a heading-order skip. */}
-    <h2 class="sr-only">Entries</h2>
-    <p class="m-0 mb-4 text-2xs font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">
-      {formatCount(model.total, countNoun)}
-    </p>
-
-    {model.isEmpty ? (
-      <EmptyState
-        title={emptyLabel}
-        description="No records currently match this collection's query. The collection fills automatically as matching records are added."
-      />
-    ) : (
-      <CardGrid>
-        {model.entries.map((entry, i) => (
-          <li class="m-0 p-0">
-            <CollectionRow entry={entry} eager={i < 3} />
-          </li>
-        ))}
-      </CardGrid>
-    )}
-
-    {model.related.length > 0 && (
-      <section class="mt-12 border-t border-ink-200 pt-8 dark:border-ink-800">
-        <SectionHeader
-          eyebrow="Related"
-          title="Related collections"
-          description="Other curated groupings of related items."
-          level={2}
-        />
-        <ul class="m-0 grid list-none grid-cols-1 gap-2 p-0 sm:grid-cols-2 lg:grid-cols-4">
-          {model.related.map((r) => (
-            <li class="m-0 p-0">
-              <a
-                href={r.url}
-                class="group flex h-full flex-col gap-1 rounded-md border border-ink-200 bg-white px-3 py-2.5 no-underline transition-colors hover:border-ink-400 dark:border-ink-800 dark:bg-ink-950 dark:hover:border-ink-600"
-              >
-                <span class="text-sm font-medium text-ink-900 group-hover:underline dark:text-ink-100">{r.title}</span>
-              </a>
-            </li>
-          ))}
-        </ul>
-      </section>
-    )}
-  </Container>
-</section>

package/src/components/CollectionRow.astro

@@ -1,81 +0,0 @@
----
-/**
- * CollectionRow — collection-page adapter around the canonical
- * `ProjectCard`.
- *
- * Consumes the lightweight `CollectionEntry` shape directly and maps
- * it onto `ProjectCard`'s explicit props, so a collection page sitting
- * next to the directory index reads as the same site. The historical
- * public props are preserved:
- *
- *  - `entry` — the collection entry (slug, title, description, …)
- *  - `href` — full detail URL; wins over `routeSlug`
- *  - `routeSlug` — blueprint slug (e.g. "projects"); details derived
- *    as `/${routeSlug}/${slug}` when `href` is not provided
- *  - `showChips`, `showLabel` — deprecated no-ops. The card renders
- *    one fixed layout everywhere, so a record cannot look like a
- *    different record depending on the page it appears on.
- *  - `showMeta` — still honoured: it controls whether the *data*
- *    (stars, last-updated) is passed in at all, not how it is drawn
- *  - `class` — extra class on the card root
- *  - `eager` — bypass lazy loading for above-the-fold avatars
- *
- * The repository is reached through the card's `owner/repo` line;
- * there is no separate footer link button.
- *
- * Analytics: emits `data-event="collection_item_click"` /
- * `data-event-source="collection_row"` on the card root, so sites wire
- * one handler in BaseLayout.
- */
-import type { CollectionEntry } from "@grove-dev/core";
-import ProjectCard from "./ProjectCard.astro";
-
-interface Props {
-  entry: CollectionEntry;
-  /** Full detail-page URL. Wins over `routeSlug`. */
-  href?: string;
-  /** Blueprint route slug; detail URL = `/${routeSlug}/${slug}`. */
-  routeSlug?: string;
-  /** @deprecated Ignored — the card renders one fixed layout. */
-  showChips?: boolean;
-  /** Pass stars / last-updated through to the card. Default true. */
-  showMeta?: boolean;
-  /** @deprecated Ignored — see `showChips`. */
-  showLabel?: boolean;
-  eager?: boolean;
-  class?: string;
-}
-
-const {
-  entry,
-  href: hrefProp,
-  routeSlug,
-  showMeta = true,
-  eager = false,
-  class: className = "",
-} = Astro.props;
-
-const slug = entry.slug;
-const base = (routeSlug ?? "").replace(/^\/+|\/+$/g, "");
-const detailHref =
-  typeof hrefProp === "string" && hrefProp.length > 0
-    ? hrefProp
-    : entry.url || (base ? `/${base}/${slug}` : `/${slug}`);
-
-const repoHref = entry.repoHref;
----
-
-<ProjectCard
-  href={detailHref}
-  slug={slug}
-  name={entry.title}
-  description={entry.description ?? ""}
-  repoUrl={repoHref}
-  stars={showMeta ? entry.stars : undefined}
-  pushedAt={showMeta ? entry.pushedAt : undefined}
-  stack={entry.stack}
-  eager={eager}
-  event="collection_item_click"
-  eventSource="collection_row"
-  class={className}
-/>

package/src/components/CollectionTeaser.astro

@@ -1,47 +0,0 @@
----
-/**
- * CollectionTeaser — homepage-friendly subset of `CollectionIndex`.
- *
- * Thin wrapper that defaults `limit` to 3 and sets homepage-friendly
- * "View all collections" link + copy. For custom card counts or
- * different copy, use `CollectionIndex` directly with explicit
- * `limit` and `viewAllHref` props.
- */
-import CollectionIndex from "./CollectionIndex.astro";
-import type { CollectionIndexModel } from "../server/collections.js";
-
-interface Props {
-  model: CollectionIndexModel;
-  title?: string;
-  description?: string;
-  viewAllHref?: string;
-  viewAllLabel?: string;
-  /** Cap the number of cards rendered. Default: 3. */
-  limit?: number;
-  /** Noun pair for the per-card entry counts (blueprint labels). */
-  countNoun?: { singular: string; plural: string };
-  class?: string;
-}
-
-const {
-  model,
-  title = "Featured collections",
-  description = "Hand-picked and auto-generated groupings of related items.",
-  viewAllHref = "/collections/",
-  viewAllLabel = "View all collections",
-  limit = 3,
-  countNoun,
-  class: className,
-} = Astro.props;
----
-
-<CollectionIndex
-  model={model}
-  title={title}
-  description={description}
-  viewAllHref={viewAllHref}
-  viewAllLabel={viewAllLabel}
-  limit={limit}
-  countNoun={countNoun}
-  class={className}
-/>

package/src/components/ContributorsGrid.astro

@@ -1,143 +0,0 @@
----
-/**
- * ContributorsGrid — avatar grid for the home page.
- *
- * Renders a dense grid of contributor avatars with optional name and
- * contribution count. Each tile links to the contributor's profile.
- * No blueprint-specific terms — works for any "people" feed.
- *
- * Empty tiles are skipped. When the list is empty the entire section
- * hides its body but keeps the header (so a "no contributors yet"
- * state can be wired by a consumer via a slot).
- */
-
-interface Contributor {
-  username: string;
-  name?: string;
-  avatarUrl?: string;
-  profileUrl?: string;
-  contributions?: number;
-}
-
-interface Props {
-  contributors: Contributor[];
-  /** Total count to display in the header (e.g. "1,234 contributors"). */
-  total?: number;
-  /** Optional view-all href rendered top-right. */
-  viewAllHref?: string;
-  viewAllLabel?: string;
-  title?: string;
-  description?: string;
-  /** Render per-user contribution counts (config: contributors.showContributionCount). */
-  showContributionCount?: boolean;
-  class?: string;
-}
-
-const {
-  contributors,
-  total,
-  viewAllHref,
-  viewAllLabel = "View all",
-  title = "Built by the community",
-  description = "The people improving this directory through code, curation, and review.",
-  showContributionCount = true,
-  class: className = "",
-} = Astro.props;
-
-function fmt(n: number | undefined): string | null {
-  if (typeof n !== "number" || !Number.isFinite(n)) return null;
-  if (n >= 1000) {
-    const k = n / 1000;
-    return (k >= 10 ? Math.round(k).toString() : k.toFixed(1)) + "k";
-  }
-  return n.toString();
-}
-
-const visible = contributors
-  .filter((c) => c.username)
-  .slice(0, 100);
----
-
-<section
-  class:list={["py-12 sm:py-16", className]}
-  aria-labelledby="grove-contributors-heading"
->
-  <div class="mx-auto w-full max-w-container px-5 sm:px-7">
-    <header class="mb-6 flex flex-wrap items-end justify-between gap-3">
-      <div>
-        <h2
-          id="grove-contributors-heading"
-          class="m-0 text-[1.5rem] sm:text-[1.625rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100"
-        >
-          {title}
-          {typeof total === "number" && (
-            <span class="ml-2 font-mono text-[0.9375rem] font-normal text-ink-500 dark:text-ink-400">
-              ({fmt(total) ?? total})
-            </span>
-          )}
-        </h2>
-        {description && (
-          <p class="m-0 mt-1 max-w-[60ch] text-[0.9375rem] text-ink-500 dark:text-ink-400">
-            {description}
-          </p>
-        )}
-      </div>
-      {viewAllHref && (
-        <a
-          href={viewAllHref}
-          class="text-sm font-medium text-ink-500 hover:text-ink-900 dark:text-ink-400 dark:hover:text-ink-100"
-        >
-          {viewAllLabel} →
-        </a>
-      )}
-    </header>
-
-    {visible.length === 0 ? (
-      <p class="m-0 text-sm text-ink-500 dark:text-ink-400">
-        Community profiles appear after the first repository metadata sync.
-      </p>
-    ) : (
-      <ul
-        class="m-0 grid list-none grid-cols-[repeat(auto-fill,minmax(72px,1fr))] gap-x-3 gap-y-5 p-0"
-        aria-label="Contributors"
-      >
-        {visible.map((c) => {
-          const href = c.profileUrl ?? `https://github.com/${c.username}`;
-          const avatar =
-            c.avatarUrl ??
-            `https://avatars.githubusercontent.com/${c.username}?v=4&s=80`;
-          return (
-            <li class="m-0 p-0">
-              <a
-                href={href}
-                target="_blank"
-                rel="noopener noreferrer"
-                class="group flex flex-col items-center gap-1.5 p-2 text-center no-underline"
-                data-event="contributor_click"
-                data-event-source="contributors_grid"
-              >
-                <img
-                  src={avatar}
-                  alt={c.name ?? c.username}
-                  width="48"
-                  height="48"
-                  loading="lazy"
-                  decoding="async"
-                  class="h-12 w-12 rounded-full border border-ink-200 object-cover dark:border-ink-800"
-                />
-                <span class="line-clamp-1 text-2xs font-medium text-ink-700 group-hover:text-ink-900 dark:text-ink-300 dark:group-hover:text-ink-100">
-                  {c.name ?? c.username}
-                </span>
-                {showContributionCount && typeof c.contributions === "number" && (
-                  <span class="font-mono text-2xs text-ink-400">
-                    {fmt(c.contributions) ?? c.contributions}
-                  </span>
-                )}
-              </a>
-            </li>
-          );
-        })}
-      </ul>
-    )}
-  </div>
-</section>