@grove-dev/astro 0.2.10 → 0.2.13

package/templates/default/src/pages/apps/index.astro

@@ -0,0 +1,146 @@
+---
+/**
+ * /apps — alternate list URL.
+ *
+ * Mirrors `/[slug]/index.astro` (the blueprint-aware dynamic list
+ * page) at a static URL so the openapps-style `/apps` route works
+ * for project-directory blueprints without per-blueprint forks.
+ *
+ * For non-project blueprints (resource-hub → /resources,
+ * ecosystem-map → /entities), this page redirects to the matching
+ * dynamic route.
+ */
+import { indexSlug, itemLabelPlural, items } from "../../data/records";
+import BaseLayout from "@grove-dev/astro/layouts/BaseLayout.astro";
+import SmartLensTabs from "@grove-dev/astro/components/SmartLensTabs.astro";
+import RefinePanel from "@grove-dev/astro/components/RefinePanel.astro";
+import AppsIndexRow from "@grove-dev/astro/components/AppsIndexRow.astro";
+import ExploreByCategory from "@grove-dev/astro/components/ExploreByCategory.astro";
+import ExploreByStack from "@grove-dev/astro/components/ExploreByStack.astro";
+import siteConfig from "../../../data/generated/site-config.json";
+import {
+  activeFilterChips,
+  applySort,
+  buildFacets,
+  effectivePage,
+  effectiveSort,
+  filterApps,
+  filtersFromSearchParams,
+  paginate,
+  totalPages,
+} from "@grove-dev/astro";
+
+const slug = indexSlug();
+
+// Only render the static /apps route when the active blueprint is
+// project-directory (the openapps-style URL). For other blueprints,
+// redirect to the dynamic `/<slug>/` route.
+if (slug !== "projects") {
+  return Astro.redirect(`/${slug}${Astro.url.search}`);
+}
+
+const total = items.length;
+const filters = filtersFromSearchParams(Astro.url.searchParams);
+const facets = buildFacets(items);
+const sort = effectiveSort(filters);
+const requestedPage = effectivePage(filters);
+const filtered = filterApps(items, filters);
+const sorted = applySort(filtered, sort);
+const pages = totalPages(sorted.length);
+const page = Math.min(requestedPage, pages);
+const visibleItems = paginate(sorted, page);
+const chips = activeFilterChips(filters);
+const itemPlural = itemLabelPlural();
+
+const title = `${itemPlural.charAt(0).toUpperCase()}${itemPlural.slice(1)} — ${siteConfig.name}`;
+const description = `Browse every curated ${itemPlural.replace(/s$/, "")} in the ${siteConfig.name} directory.`;
+---
+
+<BaseLayout title={title} description={description} site={siteConfig}>
+  <section class="grove-section">
+    <div class="grove-container-wide mx-auto px-5 sm:px-7">
+      <header class="mb-6">
+        <span class="text-2xs font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">
+          {itemPlural}
+        </span>
+        <h1 class="m-0 mt-1 text-[1.75rem] sm:text-[2.25rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100">
+          Browse the directory
+        </h1>
+        <p class="m-0 mt-2 max-w-2xl text-base leading-relaxed text-ink-700 dark:text-ink-200">
+          Search and filter every curated {itemPlural.replace(/s$/, "")}. Use the
+          lens tabs to focus on a curated angle, or refine by stack,
+          platform, license, and status.
+        </p>
+      </header>
+
+      <div class="mb-6">
+        <SmartLensTabs
+          currentParams={Astro.url.searchParams}
+          pathPrefix="/apps"
+        />
+      </div>
+
+      <div class="mb-8">
+        <RefinePanel
+          facets={facets}
+          initial={filters}
+          pathPrefix="/apps"
+        />
+      </div>
+
+      {chips.length > 0 && (
+        <ul class="mb-6 flex flex-wrap items-center gap-1.5" aria-label="Active filters">
+          {chips.map((chip) => (
+            <li>
+              <a
+                href={chip.removeHref}
+                class="grove-badge inline-flex items-center gap-1.5 hover:border-ink-300 dark:hover:border-ink-700"
+                title={`Remove filter: ${chip.label}`}
+              >
+                <span>{chip.label}</span>
+                <span aria-hidden="true">×</span>
+              </a>
+            </li>
+          ))}
+        </ul>
+      )}
+
+      {visibleItems.length === 0 ? (
+        <p class="grove-card p-8 text-center text-sm text-ink-500 dark:text-ink-400">
+          No {itemPlural} match these filters. Try clearing a filter or two.
+        </p>
+      ) : (
+        <ul class="m-0 grid list-none grid-cols-1 gap-3 p-0">
+          {visibleItems.map((item) => (
+            <li class="m-0 p-0">
+              <AppsIndexRow record={item as Parameters<typeof AppsIndexRow>[0]["record"]} detailHref={`/apps/${item.slug}`} />
+            </li>
+          ))}
+        </ul>
+      )}
+    </div>
+  </section>
+
+  <ExploreByCategory
+    categories={[
+      ...new Set(
+        items
+          .filter((i) => i.kind === "project")
+          .map((i) => (i as { category?: string }).category ?? "")
+          .filter(Boolean),
+      ),
+    ].map((name) => ({ name, slug: name }))}
+    pathPrefix="/apps"
+  />
+  <ExploreByStack
+    stacks={[
+      ...new Set(
+        items
+          .filter((i) => i.kind === "project")
+          .flatMap((i) => [(i as { stack?: string }).stack ?? "", ...(i as { stacks?: string[] }).stacks])
+          .filter(Boolean),
+      ),
+    ].map((name) => ({ name, slug: name }))}
+    pathPrefix="/apps"
+  />
+</BaseLayout>

package/templates/default/src/pages/contributors.astro

@@ -0,0 +1,184 @@
+---
+/**
+ * Contributors page — full list with per-user contribution counts.
+ *
+ * Generic: works for any blueprint (project-directory, resource-hub,
+ * ecosystem-map) and any source of contributors. Reads from
+ * `data/generated/contributors.json` if present, otherwise renders
+ * a graceful empty state. The file is produced by the
+ * `sync-contributors` GitHub Action (see `.github/workflows/`).
+ *
+ * Falls back to deriving contributors from the records themselves
+ * (record.github.fullName → owner handle) when no JSON file exists,
+ * so a fresh scaffold still shows something useful.
+ */
+import siteConfig from "../../data/generated/site-config.json";
+import BaseLayout from "@grove-dev/astro/layouts/BaseLayout.astro";
+import { projects } from "../data/records";
+import { existsSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+
+interface Contributor {
+  username: string;
+  name?: string;
+  avatarUrl?: string;
+  profileUrl?: string;
+  contributions?: number;
+}
+
+const here = dirname(fileURLToPath(import.meta.url));
+const contributorsPath = [
+  resolve(here, "..", "..", "data", "generated", "contributors.json"),
+  resolve(process.cwd(), "data", "generated", "contributors.json"),
+].find((p) => existsSync(p));
+
+let contributors: Contributor[] = [];
+if (contributorsPath) {
+  try {
+    const parsed = JSON.parse(readFileSync(contributorsPath, "utf8")) as {
+      contributors?: Contributor[];
+    };
+    contributors = parsed.contributors ?? [];
+  } catch {
+    contributors = [];
+  }
+}
+
+// Fallback: derive owners from record.github.fullName when no JSON
+// is present (fresh scaffold before the first sync run).
+if (contributors.length === 0) {
+  const seen = new Map<string, Contributor>();
+  for (const r of projects) {
+    const full = r.github?.fullName;
+    if (!full || !full.includes("/")) continue;
+    const username = full.split("/")[0];
+    if (seen.has(username)) continue;
+    seen.set(username, {
+      username,
+      avatarUrl: `https://avatars.githubusercontent.com/${username}?v=4&s=80`,
+      profileUrl: `https://github.com/${username}`,
+    });
+  }
+  contributors = [...seen.values()].sort((a, b) =>
+    a.username.localeCompare(b.username),
+  );
+}
+
+const total = contributors.length;
+const sorted = [...contributors].sort((a, b) => {
+  const ac = a.contributions ?? 0;
+  const bc = b.contributions ?? 0;
+  if (bc !== ac) return bc - ac;
+  return a.username.localeCompare(b.username);
+});
+
+const title = `Contributors — ${siteConfig.name}`;
+const description =
+  `Every person who has helped build ${siteConfig.name} — from a single line to long-running stewardship.`;
+
+const repoUrl = siteConfig.repoUrl;
+const contributorsGraphHref = repoUrl ? `${repoUrl.replace(/\/$/, "")}/graphs/contributors` : null;
+---
+
+<BaseLayout title={title} description={description} site={siteConfig}>
+  <section class="grove-section">
+    <div class="grove-container-wide mx-auto px-5 py-12 sm:px-7 sm:py-16">
+      <span class="text-2xs font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">
+        Contributors
+      </span>
+      <h1 class="m-0 mt-2 text-[2rem] sm:text-[2.5rem] font-semibold leading-[1.05] tracking-tight text-ink-900 dark:text-ink-100">
+        {total > 0 ? `Showing all ${total} contributors` : "Contributors"}
+      </h1>
+      <p class="m-0 mt-3 max-w-2xl text-base leading-relaxed text-ink-700 dark:text-ink-200">
+        {total > 0
+          ? `Every person who has helped build ${siteConfig.name} — from a single line to long-running stewardship.`
+          : `Contributors will appear here once ${siteConfig.name} syncs its first set of GitHub metadata. The list is auto-generated from ${repoUrl ? repoUrl : "the project's source repository"}.`}
+      </p>
+
+      {contributorsGraphHref && (
+        <p class="m-0 mt-3 text-sm text-ink-500 dark:text-ink-400">
+          <a
+            href={contributorsGraphHref}
+            target="_blank"
+            rel="noopener noreferrer"
+            class="font-medium underline decoration-ink-300 underline-offset-2 hover:decoration-ink-500 dark:decoration-ink-700 dark:hover:decoration-ink-400"
+          >
+            GitHub contributors graph →
+          </a>
+        </p>
+      )}
+    </div>
+  </section>
+
+  {sorted.length === 0 ? (
+    <section class="grove-section">
+      <div class="grove-container mx-auto px-5 pb-16 sm:px-7">
+        <div class="grove-card flex flex-col items-center gap-3 p-8 text-center">
+          <p class="m-0 text-sm text-ink-500 dark:text-ink-400">
+            No contributors synced yet. Once the first sync runs, every
+            contributor avatar lands here.
+          </p>
+        </div>
+      </div>
+    </section>
+  ) : (
+    <section class="grove-section" aria-label="Contributors list">
+      <div class="grove-container-wide mx-auto px-5 pb-16 sm:px-7">
+        <ul
+          class="m-0 grid list-none grid-cols-2 gap-3 p-0 sm:grid-cols-3 md:grid-cols-4 lg:grid-cols-6"
+          aria-label="Contributors"
+        >
+          {sorted.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 grove-card flex flex-col items-center gap-2 p-3 text-center no-underline transition-colors hover:border-ink-300 dark:hover:border-ink-700"
+                  data-event="contributor_click"
+                  data-event-source="contributors_page"
+                >
+                  <img
+                    src={avatar}
+                    alt={c.name ?? c.username}
+                    width="56"
+                    height="56"
+                    loading="lazy"
+                    decoding="async"
+                    class="h-14 w-14 rounded-full border border-ink-200 object-cover dark:border-ink-800"
+                  />
+                  <span class="line-clamp-1 text-sm 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>
+                  <span class="text-2xs text-ink-500 dark:text-ink-400">
+                    @{c.username}
+                  </span>
+                  {typeof c.contributions === "number" && (
+                    <span class="font-mono text-2xs text-ink-400">
+                      {c.contributions.toLocaleString()} contributions
+                    </span>
+                  )}
+                </a>
+              </li>
+            );
+          })}
+        </ul>
+      </div>
+    </section>
+  )}
+</BaseLayout>
+
+<style>
+  .line-clamp-1 {
+    display: -webkit-box;
+    -webkit-line-clamp: 1;
+    -webkit-box-orient: vertical;
+    overflow: hidden;
+  }
+</style>