@grove-dev/astro 0.5.0-next.2 → 0.5.1

package/src/components/ItemCard.astro

@@ -1,324 +0,0 @@
----
-/**
- * ItemCard — compact card for one record on the home page (or any
- * 3-column grid).
- *
- * V1 (published) API: takes `record` (a Resource / IndexProjectRecord)
- * and `href` (the full detail-page URL). The page that calls this
- * component owns the path layout — blueprint-aware consumers
- * (project-directory → /projects/<slug>, resource-hub →
- * /resources/<slug>, ecosystem-map → /entities/<slug>) pass the
- * correct href via `RecordSection`'s `hrefFor` callback.
- *
- * V1 (alternative) API: pass `routeSlug` (e.g. `"projects"`,
- * `"resources"`, `"entities"`) to let the component derive the
- * detail URL itself as `/${routeSlug}/${slug}`. This is a thin
- * alternative to passing `href`; the page-level `hrefFor` callback
- * is still the recommended API.
- *
- * V1 (legacy) API: also accepts `item` + `pathPrefix` as a
- * convenience for callers that haven't migrated. When any of
- * `href` / `routeSlug` / `pathPrefix` is provided, the priority is
- * `href` > `routeSlug` > `pathPrefix`. The `pathPrefix` default
- * is `"/items"` for V0 backwards-compat, but the canonical V1
- * pattern is to pass `routeSlug` (or `href` directly).
- */
-import type { IndexRecord, Resource, ProjectRecord, IndexProjectRecord } from "@grove-dev/core";
-import StackPlatformChips from "./StackPlatformChips.astro";
-import { getOwnerAndRepoFromRepoUrl, getOwnerAvatarUrl, projectStackIds } from "@grove-dev/astro";
-import { formatStars, formatRelative } from "@grove-dev/astro";
-import { statusDisplay } from "@grove-dev/astro";
-import { licenseDisplay } from "@grove-dev/astro";
-
-type CardRecord = IndexRecord | Resource | ProjectRecord | IndexProjectRecord;
-
-interface Props {
-  /** V1 API — full Resource/IndexProjectRecord. */
-  record?: CardRecord;
-  /** V1 API — full detail-page URL. Wins over `routeSlug` / `pathPrefix`. */
-  href?: string;
-  /** V1 API — blueprint route slug (e.g. "projects", "resources",
-   *  "entities"). When `href` is not provided, the detail URL is
-   *  derived as `/${routeSlug}/${slug}`. */
-  routeSlug?: string;
-  /** Legacy API — singular item, equivalent to `record`. */
-  item?: CardRecord;
-  /** Legacy API — URL prefix, equivalent to deriving from
-   *  blueprint routeSlug + slug. Default `"/items"` (V0 leftover). */
-  pathPrefix?: string;
-  /** When true, show owner/repo below the title. Default true. */
-  showOwner?: boolean;
-  /** When false, hide the platform + stack chip row. Default true. */
-  showChips?: boolean;
-  /** When false, hide the curated label. Default true. */
-  showLabel?: boolean;
-  /** When false, hide the stars/updated/license metadata row. */
-  showMeta?: boolean;
-  class?: string;
-}
-
-const {
-  record: recordProp,
-  href: hrefProp,
-  routeSlug,
-  item: itemProp,
-  pathPrefix = "/items",
-  showOwner = true,
-  showChips = true,
-  showLabel = true,
-  showMeta = true,
-  class: className = "",
-} = Astro.props;
-
-// Resolve `item` (legacy) → `record` (V1) and `hrefProp` → final.
-const item: CardRecord = (recordProp ?? itemProp) as CardRecord;
-const slug = (item as { slug: string }).slug;
-let detailHref: string;
-if (typeof hrefProp === "string" && hrefProp.length > 0) {
-  detailHref = hrefProp;
-} else if (typeof routeSlug === "string" && routeSlug.length > 0) {
-  // V1 alternative API: blueprint routeSlug → /<routeSlug>/<slug>.
-  const base = routeSlug.replace(/^\/+|\/+$/g, "");
-  detailHref = base ? `/${base}/${slug}` : `/${slug}`;
-} else {
-  // V0 legacy fallback: explicit `pathPrefix` (default "/items").
-  const base = pathPrefix.replace(/\/$/, "");
-  detailHref = `${base}/${slug}`;
-}
-
-const isProject = item.kind === "project";
-const name = item.kind === "resource" ? (item as { title: string }).title : (item as { name: string }).name;
-const repoHref = isProject
-  ? (item as { repoUrl?: string }).repoUrl
-  : (item as { links: { github?: string } }).links?.github;
-const homepageHref = isProject
-  ? undefined
-  : (item.links as { website?: string; source?: string }).website ??
-    (item.links as { source?: string }).source;
-
-// Curated = at least one of the hand-written fields is filled in.
-const isCurated = Boolean(
-  (item as { curation?: { reviewed?: boolean } }).curation?.reviewed ||
-    (isProject && (
-      ((item as { bestFor?: string[] }).bestFor?.length ?? 0) > 0 ||
-      ((item as { whyListed?: string[] }).whyListed?.length ?? 0) > 0 ||
-      ((item as { caveats?: string[] }).caveats?.length ?? 0) > 0
-    )),
-);
-
-// Initials for placeholder logo.
-const initials = (name ?? "")
-  .split(/\s+/)
-  .map((w) => w[0])
-  .filter(Boolean)
-  .slice(0, 2)
-  .join("")
-  .toUpperCase();
-
-// Logo URL: explicit `logoUrl` (project only) → GitHub owner avatar
-// → initials placeholder.
-const { owner, repo } = getOwnerAndRepoFromRepoUrl(repoHref ?? "");
-const logoUrl = isProject
-  ? (item as { logoUrl?: string }).logoUrl ?? getOwnerAvatarUrl(owner, 80)
-  : undefined;
-
-// Up to 4 platforms + stack chips (project only).
-const platforms = isProject ? (item as { platforms?: string[] }).platforms ?? [] : [];
-const visiblePlatforms = platforms.slice(0, 4);
-const platformOverflow = platforms.length - visiblePlatforms.length;
-
-const allStacks = isProject ? projectStackIds(item as ProjectRecord) : [];
-const visibleStacks = allStacks.slice(0, 3);
-const stackOverflow = allStacks.length - visibleStacks.length;
-
-const stars = isProject ? (item as { github?: { stars?: number } }).github?.stars : undefined;
-const updatedAt = isProject
-  ? (item as { github?: { pushedAt?: string | null } }).github?.pushedAt
-  : (item as { publishedAt?: string | null }).publishedAt;
-const starsLabel = formatStars(stars);
-const updatedLabel = formatRelative(updatedAt);
-const license = isProject ? (item as { github?: { license?: string } }).github?.license : null;
-const status = isProject ? (item as { health?: { status?: string } }).health?.status : undefined;
-
-const externalHref = repoHref ?? homepageHref;
-const statusText = status ? statusDisplay(status as Parameters<typeof statusDisplay>[0]) : "";
-const category = (item as { category?: string }).category;
----
-
-<article
-  class={`rounded-[calc(var(--radius)+0.25rem)] border-0 bg-muted shadow-none transition-colors hover:bg-secondary group relative flex h-full flex-col gap-3 p-4 ${className}`}
->
-  {/* Top row: logo + name + (optional) status + curated mark. */}
-  <header class="flex items-start gap-3">
-    {logoUrl ? (
-      <img
-        src={logoUrl}
-        alt={`${name} avatar`}
-        width="40"
-        height="40"
-        loading="lazy"
-        decoding="async"
-        class="h-10 w-10 shrink-0 rounded-md border border-ink-200 bg-white object-cover dark:border-ink-800 dark:bg-ink-900"
-      />
-    ) : (
-      <span
-        aria-hidden="true"
-        class="flex h-10 w-10 shrink-0 items-center justify-center rounded-md border border-ink-200 bg-ink-50 text-2xs font-semibold text-ink-700 dark:border-ink-800 dark:bg-ink-900/60 dark:text-ink-300"
-      >
-        {initials}
-      </span>
-    )}
-
-    <div class="flex min-w-0 flex-1 flex-col gap-0.5">
-      <h3
-        class="m-0 truncate text-[0.9375rem] font-semibold tracking-tight text-ink-900 group-hover:underline dark:text-ink-100"
-      >
-        {/* Name → detail page (not GitHub repo). */}
-        <a
-          href={detailHref}
-          class="inline-flex min-h-6 min-w-6 items-center text-inherit no-underline"
-        >
-          {name}
-        </a>
-      </h3>
-      {showLabel && (
-        <span class="truncate text-2xs text-ink-500 dark:text-ink-400">
-          {showOwner && owner ? (
-            <>
-              <a
-                href={repoHref}
-                target="_blank"
-                rel="noopener noreferrer"
-                data-event="external_repo_click"
-                data-event-source="card_owner"
-                data-event-item={slug}
-                class="font-mono text-ink-500 hover:text-ink-900 dark:text-ink-400 dark:hover:text-ink-100"
-              >
-                {/* `data-event` and `data-event-*` are forwarding hooks
-                    for downstream analytics. Sites wire their own
-                    gtag/PostHog/Plausible handler in BaseLayout.astro
-                    to read these and forward to their analytics
-                    provider. The V1 names are stable: `data-event` is
-                    the action ("external_repo_click"), `data-event-source`
-                    is the surface ("card_owner" | "card_view_repo" |
-                    "detail_owner" | "detail_view_github" | "detail_homepage"
-                    | "detail_distribution"), and `data-event-item` is
-                    the record slug. */}
-                <span class="text-ink-400">@</span>{owner}{repo ? <span class="text-ink-400">/{repo}</span> : ""}
-              </a>
-              <span class="mx-1 text-ink-300 dark:text-ink-700">·</span>
-              {category}
-              {status && (
-                <>
-                  <span class="mx-1 text-ink-300 dark:text-ink-700">·</span>
-                  <span class="text-ink-500 dark:text-ink-400">{statusText}</span>
-                </>
-              )}
-            </>
-          ) : (
-            <>
-              {category}
-              {status && (
-                <>
-                  <span class="mx-1 text-ink-300 dark:text-ink-700">·</span>
-                  <span class="text-ink-500 dark:text-ink-400">{statusText}</span>
-                </>
-              )}
-            </>
-          )}
-        </span>
-      )}
-    </div>
-
-    {isCurated && showLabel && (
-      <span
-        class="inline-flex shrink-0 items-center gap-1 text-[10px] font-medium uppercase tracking-wider text-emerald-700 dark:text-emerald-400"
-        title="Hand-curated entry: bestFor, whyListed, caveats, or scores are filled in"
-      >
-        <svg viewBox="0 0 16 16" width="10" height="10" aria-hidden="true" fill="currentColor">
-          <path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0Zm3.41 5.09a.75.75 0 0 0-1.06 0L6.75 8.69 5.65 7.59a.75.75 0 1 0-1.06 1.06l1.65 1.65a.75.75 0 0 0 1.06 0l4.11-4.11a.75.75 0 0 0 0-1.06Z"/>
-        </svg>
-        curated
-      </span>
-    )}
-  </header>
-
-  {/* Description */}
-  {item.description && (
-    <p
-      class="m-0 line-clamp-2 text-[0.8125rem] leading-relaxed text-ink-500 dark:text-ink-400"
-    >
-      {item.description}
-    </p>
-  )}
-
-  {/* Metadata row: stars · updated · license — the three signals
-      that answer "is this alive and usable?" at a glance. */}
-  {showMeta && (
-    <div class="flex flex-wrap items-center gap-x-3 gap-y-1 text-2xs text-ink-500 dark:text-ink-400">
-      {starsLabel !== null && (
-        <span class="inline-flex items-center gap-1" title={`${stars ?? 0} stars on GitHub`}>
-          <svg viewBox="0 0 16 16" width="11" height="11" aria-hidden="true" fill="currentColor" class="text-amber-500">
-            <path d="M8 .25a.75.75 0 0 1 .673.418l1.882 3.815 4.21.612a.75.75 0 0 1 .416 1.279l-3.046 2.97.719 4.192a.751.751 0 0 1-1.088.791L8 12.347l-3.766 1.98a.75.75 0 0 1-1.088-.79l.72-4.194L.818 6.374a.75.75 0 0 1 .416-1.28l4.21-.611L7.327.668A.75.75 0 0 1 8 .25Z"/>
-          </svg>
-          <span class="font-mono">{starsLabel}</span>
-        </span>
-      )}
-      {updatedAt && (
-        <span class="inline-flex items-center gap-1" title={`Last updated ${updatedAt}`}>
-          <svg viewBox="0 0 16 16" width="11" height="11" aria-hidden="true" fill="currentColor" class="text-ink-400">
-            <path d="M8 2a6 6 0 1 0 0 12A6 6 0 0 0 8 2Zm0 1.5a4.5 4.5 0 1 1 0 9 4.5 4.5 0 0 1 0-9Zm-.5 1.5a.5.5 0 0 0-1 0v3.25c0 .15.07.29.18.39l1.95 1.65a.5.5 0 0 0 .66-.76L7.5 7.55V5Z"/>
-          </svg>
-          <span class="font-mono">Updated {updatedLabel}</span>
-        </span>
-      )}
-      {license && (
-        <span class="inline-flex items-center gap-1" title={`License: ${license}`}>
-          <span class="font-mono uppercase tracking-wide text-[10px]">{licenseDisplay(license)}</span>
-        </span>
-      )}
-    </div>
-  )}
-
-  {/* Platform + stack chips, pushed to the bottom. Shared with
-      `IndexRow` / `CollectionRow` so the labelled-row pattern is
-      consistent across all card-shaped components. */}
-  {showChips && (
-    <div class="mt-auto">
-      <StackPlatformChips
-        stack={visibleStacks[0]}
-        platform={visiblePlatforms}
-      />
-      {stackOverflow > 0 && (
-        <span class="text-2xs text-ink-400 dark:text-ink-600">+{stackOverflow} more stacks</span>
-      )}
-    </div>
-  )}
-
-  {/* Footer row: View repo + Details links. */}
-  <footer class="mt-1 flex items-center justify-between gap-2 border-t border-ink-100 pt-2 text-2xs dark:border-ink-900">
-    {externalHref && (
-      <a
-        href={externalHref}
-        target="_blank"
-        rel="noopener noreferrer"
-        data-event="external_repo_click"
-        data-event-source="card_view_repo"
-        data-event-item={slug}
-        class="inline-flex items-center gap-1 font-medium text-ink-700 transition-colors hover:text-ink-900 dark:text-ink-300 dark:hover:text-ink-100"
-      >
-        {repoHref ? "View repo" : "Visit source"}
-        <svg viewBox="0 0 16 16" width="10" height="10" aria-hidden="true" fill="currentColor">
-          <path d="M3.75 2A1.75 1.75 0 0 0 2 3.75v8.5C2 13.216 2.784 14 3.75 14h8.5A1.75 1.75 0 0 0 14 12.25v-3.5a.75.75 0 0 0-1.5 0v3.5a.25.25 0 0 1-.25.25h-8.5a.25.25 0 0 1-.25-.25v-8.5a.25.25 0 0 1 .25-.25h3.5a.75.75 0 0 0 0-1.5h-3.5Z"/>
-          <path d="M10 0a.75.75 0 0 0-.75.75v.75h-3a.75.75 0 0 0 0 1.5h3v.75A.75.75 0 0 0 10.75 4.5h2.5A.75.75 0 0 0 14 3.75v-2.5A.75.75 0 0 0 13.25.5H10Z"/>
-        </svg>
-      </a>
-    )}
-    <a
-      href={detailHref}
-      class="inline-flex items-center gap-1 font-medium text-ink-500 transition-colors hover:text-ink-900 dark:text-ink-400 dark:hover:text-ink-100"
-    >
-      Details →
-    </a>
-  </footer>
-</article>

package/src/components/MinimalAbout.astro

@@ -1,82 +0,0 @@
----
-/**
- * MinimalAbout — 3 short points + title, used on the about page.
- *
- * A trimmed-down sibling of `WhyThisExists` with a different layout
- * (no icons, no "0X" counter, vertical list) for text-heavy pages.
- *
- * Generic: every point comes through props.
- */
-
-interface AboutPoint {
-  title: string;
-  body: string;
-}
-
-interface Props {
-  points?: AboutPoint[];
-  title?: string;
-  description?: string;
-  class?: string;
-}
-
-const {
-  points,
-  title = "About this directory",
-  description,
-  class: className = "",
-} = Astro.props;
-
-const defaultPoints: AboutPoint[] = [
-  {
-    title: "Curated, not scraped",
-    body: "Every entry is hand-checked. If something here, it's because someone looked at the source, ran the build, and decided it was worth your time.",
-  },
-  {
-    title: "Plain text all the way down",
-    body: "Records live in plain YAML, content in plain Markdown, and the static output in plain HTML. No database, no JavaScript framework, no CDN with sticky sessions.",
-  },
-  {
-    title: "Free to fork, free to extend",
-    body: "This whole site is one repo. If you want your own copy, fork it. If you want to add a record, open a PR. The directory is the community.",
-  },
-];
-
-const items = points && points.length > 0 ? points : defaultPoints;
----
-
-<section class:list={["py-12 sm:py-16", className]}>
-  <div class="mx-auto w-full max-w-narrow px-5 sm:px-7">
-    <header class="mb-6 flex flex-col gap-2">
-      <h2 class="m-0 text-[1.5rem] sm:text-[1.625rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100">
-        {title}
-      </h2>
-      {description && (
-        <p class="m-0 text-[0.9375rem] text-ink-500 dark:text-ink-400">
-          {description}
-        </p>
-      )}
-    </header>
-
-    <ol class="m-0 flex list-none flex-col gap-5 p-0">
-      {items.map((p, i) => (
-        <li class="flex gap-4">
-          <span
-            aria-hidden="true"
-            class="flex h-7 w-7 flex-shrink-0 items-center justify-center rounded-md border border-ink-200 bg-ink-50 font-mono text-2xs text-ink-500 dark:border-ink-800 dark:bg-ink-900 dark:text-ink-400"
-          >
-            0{i + 1}
-          </span>
-          <div>
-            <h3 class="m-0 text-[1rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100">
-              {p.title}
-            </h3>
-            <p class="m-0 mt-1 text-[0.9375rem] leading-relaxed text-ink-500 dark:text-ink-400">
-              {p.body}
-            </p>
-          </div>
-        </li>
-      ))}
-    </ol>
-  </div>
-</section>

package/src/components/ScoreBars.astro

@@ -1,102 +0,0 @@
----
-/**
- * ScoreBars — 4-bar score visualization.
- *
- * Renders a horizontal 4-cell bar per score dimension. Each cell
- * fills based on the score tier (0..4) computed from a 0-100 value.
- * The 5 dimensions are: activity, maturity, learning, contribution,
- * docs. The "overall" bar is optional and rendered last as a
- * composite when `showOverall` is true.
- *
- * Renders nothing when the record has no score block.
- */
-
-import type { Score } from "@grove-dev/core";
-import { scoreTier, scoreTierLabel, SCORE_LABELS } from "../lib/scores";
-
-interface Props {
-  scores: Score | undefined | null;
-  /** Show the "overall" composite bar. Default true. */
-  showOverall?: boolean;
-  /** Compact mode — no labels next to the bars. */
-  compact?: boolean;
-  class?: string;
-}
-
-const {
-  scores,
-  showOverall = true,
-  compact = false,
-  class: className = "",
-} = Astro.props;
-
-const dimensions: (keyof Score)[] = showOverall
-  ? ["activity", "maturity", "learning", "contribution", "docs", "overall"]
-  : ["activity", "maturity", "learning", "contribution", "docs"];
-
-function dim(n: number | undefined): number {
-  if (typeof n !== "number") return 0;
-  return scoreTier(n);
-}
-
-function label(n: number | undefined): string {
-  if (typeof n !== "number") return "—";
-  return Math.round(n).toString();
-}
----
-
-{scores && (
-  <div
-    class:list={["grove-score-bars flex flex-col gap-2", className]}
-    aria-label="Project scores"
-  >
-    {dimensions.map((d) => {
-      const n = scores[d];
-      const tier = dim(n);
-      return (
-        <div
-          class:list={[
-            "grove-score-row flex items-center gap-2",
-            compact ? "text-2xs" : "text-2xs",
-          ]}
-          title={`${SCORE_LABELS[d]}: ${label(n)} (${scoreTierLabel(typeof n === "number" ? n : 0)})`}
-        >
-          {!compact && (
-            <span class="w-20 flex-shrink-0 font-medium text-ink-700 dark:text-ink-300">
-              {SCORE_LABELS[d]}
-            </span>
-          )}
-          <span
-            class:list={[
-              "grove-score-cells flex gap-0.5",
-              compact ? "w-20" : "w-24",
-            ]}
-            role="img"
-            aria-label={`${SCORE_LABELS[d]}: ${label(n)}`}
-          >
-            {[0, 1, 2, 3, 4].map((i) => (
-              <span
-                class:list={[
-                  "grove-score-cell h-1.5 flex-1 rounded-sm",
-                  i < tier
-                    ? d === "overall"
-                      ? "bg-ink-900 dark:bg-ink-100"
-                      : "bg-ink-700 dark:bg-ink-300"
-                    : "bg-ink-100 dark:bg-ink-900",
-                ]}
-              ></span>
-            ))}
-          </span>
-          <span
-            class:list={[
-              "font-mono text-ink-500 dark:text-ink-400",
-              compact ? "ml-1" : "ml-2 w-7 text-right",
-            ]}
-          >
-            {label(n)}
-          </span>
-        </div>
-      );
-    })}
-  </div>
-)}

package/src/lib/scores.ts

@@ -1 +0,0 @@
-export * from "@grove-dev/core";