@grove-dev/astro 0.1.5 → 0.2.5

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

@@ -1,66 +1,268 @@
 ---
-import { siteConfig } from "../data/config";
-import BaseLayout from "../components/layout/BaseLayout.astro";
-import Hero from "../components/Hero.astro";
-import WhyThisExists from "../components/WhyThisExists.astro";
-import AppSection from "../components/AppSection.astro";
-import StackGrid from "../components/StackGrid.astro";
-import CategoryGrid from "../components/CategoryGrid.astro";
-import ContributorsGrid from "../components/ContributorsGrid.astro";
-import OriginalCollection from "../components/OriginalCollection.astro";
-
-import { newApps, hotApps, matureApps } from "../data/apps";
-import { stacks } from "../data/stacks";
-import { categories } from "../data/categories";
-import { contributors } from "../data/contributors";
-import { stats } from "../data/stats";
-
-const hotList = hotApps().slice(0, 6);
-const newList = newApps().slice(0, 6);
-const matureList = matureApps().slice(0, 6);
-
-const title = `${siteConfig.name} — A directory of real open-source applications`;
+/**
+ * Home page — the showcase's front door.
+ *
+ * Sections (in order):
+ *   1. Hero                       — brand + search + stats row
+ *   2. WhyThisExists              — 3 short value-prop points
+ *   3. RecordSection "Trending"   — hot lens (stars >= 1000 OR pushed <= 30d)
+ *   4. RecordSection "Recently added" — new lens (pushed <= 7d OR curated "new")
+ *   5. RecordSection "Established" — mature lens (tier=curated, pushed > 365d)
+ *   6. StackGrid                  — browse by stack
+ *   7. CategoryGrid               — browse by category
+ *   8. ContributorsGrid           — top contributors (when available)
+ *   9. OriginalCollection         — origin-card link to the source repo
+ *
+ * Every section is defensive: with 0 records (fresh scaffold) it
+ * renders a graceful empty state instead of throwing.
+ *
+ * V1 source-of-truth types are from `@grove-dev/core`. The slim
+ * `IndexProjectRecord` shape is what the home page consumes (no
+ * `as ProjectRecord` casts); the full `Resource` only flows into
+ * the detail page.
+ */
+import siteConfig from "../../data/generated/site-config.json";
+import { records, fullRecords, projects, indexSlug, itemLabel } from "../data/records";
+import BaseLayout from "@grove-dev/astro/layouts/BaseLayout.astro";
+import Hero from "@grove-dev/astro/components/Hero.astro";
+import WhyThisExists from "@grove-dev/astro/components/WhyThisExists.astro";
+import RecordSection from "@grove-dev/astro/components/RecordSection.astro";
+import StackGrid from "@grove-dev/astro/components/StackGrid.astro";
+import CategoryGrid from "@grove-dev/astro/components/CategoryGrid.astro";
+import ContributorsGrid from "@grove-dev/astro/components/ContributorsGrid.astro";
+import OriginalCollection from "@grove-dev/astro/components/OriginalCollection.astro";
+import { countByCategory, countByStack } from "@grove-dev/astro";
+import { existsSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import type { IndexProjectRecord } from "@grove-dev/core";
+
+const slug = indexSlug();
+const projectKind = projects;
+
+// ── Hero stats ──────────────────────────────────────────────────
+const totalApps = fullRecords.filter((r) => r.kind === "project").length;
+const totalCategories = new Set(projectKind.map((r) => r.category).filter(Boolean))
+  .size;
+const totalStacks = new Set(
+  projectKind.flatMap((r) => [r.stack, ...(r.stacks ?? [])]).filter(Boolean),
+).size;
+const totalContributors = new Set(
+  projectKind
+    .map((r) => {
+      const url = r.repoUrl ?? r.links?.github ?? "";
+      const m = /github\.com\/([^/]+)\//.exec(url);
+      return m?.[1];
+    })
+    .filter(Boolean),
+).size;
+const totalStars = projectKind.reduce(
+  (acc, r) => acc + (r.github?.stars ?? 0),
+  0,
+);
+
+// ── Lens sectioning (Hot / New / Mature) ────────────────────────
+const DAY_MS = 86_400_000;
+function daysSince(iso: string | null | undefined): number {
+  if (!iso) return Infinity;
+  const d = new Date(iso);
+  if (Number.isNaN(d.valueOf())) return Infinity;
+  return (Date.now() - d.valueOf()) / DAY_MS;
+}
+
+const hot = projectKind
+  .filter((r: IndexProjectRecord) => {
+    const stars = r.github?.stars ?? 0;
+    const pushedAt = r.github?.pushedAt ?? null;
+    const pushed = daysSince(pushedAt);
+    const labelledHot = r.curation?.labels?.includes("hot") ?? false;
+    return labelledHot || stars >= 1000 || pushed <= 30;
+  })
+  .slice(0, 6);
+
+const newItems = projectKind
+  .filter((r: IndexProjectRecord) => {
+    const pushedAt = r.github?.pushedAt ?? null;
+    const pushed = daysSince(pushedAt);
+    const labelledNew = r.curation?.labels?.includes("new") ?? false;
+    return pushed <= 7 || labelledNew;
+  })
+  .slice(0, 6);
+
+const mature = projectKind
+  .filter((r: IndexProjectRecord) => {
+    const tier = r.health?.tier;
+    const pushedAt = r.github?.pushedAt ?? null;
+    const pushed = daysSince(pushedAt);
+    return tier === "curated" && pushed > 365;
+  })
+  .slice(0, 6);
+
+// ── Stack / category aggregates ─────────────────────────────────
+const stackCounts = countByStack(projectKind);
+const stacks = [...stackCounts.entries()]
+  .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+  .slice(0, 12)
+  .map(([name, count]) => ({ name, slug: name, count }));
+
+const categoryCounts = countByCategory(projectKind);
+const categories = [...categoryCounts.entries()]
+  .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+  .map(([name, count]) => ({ name, slug: name, count }));
+
+// ── Contributors (best-effort, from records) ────────────────────
+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));
+
+interface ContributorsFile {
+  contributors?: Array<{
+    username: string;
+    name?: string;
+    avatarUrl?: string;
+    profileUrl?: string;
+    contributions?: number;
+  }>;
+}
+
+let contributors: ContributorsFile["contributors"] = [];
+if (contributorsPath) {
+  try {
+    const parsed = JSON.parse(readFileSync(contributorsPath, "utf8")) as ContributorsFile;
+    contributors = parsed.contributors ?? [];
+  } catch {
+    contributors = [];
+  }
+}
+const hasContributors = contributors && contributors.length > 0;
+
+// ── OriginalCollection (repo-stats.json if present) ─────────────
+interface RepoStats {
+  originalRepo?: string;
+  stars?: number;
+  forks?: number;
+  contributors?: number;
+  description?: string;
+}
+let repoStats: RepoStats = {};
+const repoStatsPath = [
+  resolve(here, "..", "..", "data", "generated", "repo-stats.json"),
+  resolve(process.cwd(), "data", "generated", "repo-stats.json"),
+].find((p) => existsSync(p));
+if (repoStatsPath) {
+  try {
+    repoStats = JSON.parse(readFileSync(repoStatsPath, "utf8")) as RepoStats;
+  } catch {
+    repoStats = {};
+  }
+}
+
+const title = `${siteConfig.name} — ${siteConfig.tagline}`;
 const description =
-  "A searchable directory of real open-source applications — organized by stack, category, platform, license, activity, and maturity.";
+  siteConfig.description ?? `A growing community knowledge site powered by Grove.`;
+
+// ── Render-time helpers ─────────────────────────────────────────
+function detailHrefFor(r: IndexProjectRecord): string {
+  return `/${slug}/${r.slug}`;
+}
 ---
 
-<BaseLayout title={title} description={description}>
-      <Hero />
-
-      <WhyThisExists />
-
-      <AppSection
-        id="hot"
-        title="Hot open-source apps"
-        description="Projects gaining stars, activity, or attention recently."
-        apps={hotList}
-        viewAllHref="/apps?label=hot"
-        viewAllLabel="View hot apps"
-      />
-
-      <AppSection
-        id="new"
-        title="New open-source apps"
-        description="Recently added apps from the community."
-        apps={newList}
-        viewAllHref="/apps?label=new"
-        viewAllLabel="View all new"
-      />
-
-      <AppSection
-        id="mature"
-        title="Mature open-source apps"
-        description="Established apps with strong history, active maintainers, and real-world usage."
-        apps={matureList}
-        viewAllHref="/apps?label=mature"
-        viewAllLabel="View mature apps"
-      />
-
-      <StackGrid stacks={stacks} />
-
-      <CategoryGrid categories={categories} />
-
-      <ContributorsGrid contributors={contributors} />
-
-      <OriginalCollection stats={stats} />
+<BaseLayout
+  title={title}
+  description={description}
+  site={siteConfig}
+  submitHref="/submit"
+  submitLabel={`Submit ${itemLabel()}`}
+>
+  <Hero
+    name={siteConfig.name}
+    tagline={siteConfig.tagline}
+    description={description}
+    eyebrow="Curated directory"
+    searchPlaceholder={`Search ${slug}...`}
+    searchHref={`/${slug}`}
+    stats={{
+      apps: totalApps,
+      categories: totalCategories,
+      stacks: totalStacks,
+      contributors: totalContributors || undefined,
+      stars: totalStars || undefined,
+    }}
+    ctas={[
+      { label: `Browse ${slug}`, href: `/${slug}`, variant: "primary" },
+      { label: "About", href: "/about", variant: "outline" },
+    ]}
+  />
+
+  <WhyThisExists />
+
+  <RecordSection
+    id="hot"
+    title="Trending"
+    description="The projects getting attention right now — high-star repos and recently active codebases."
+    items={hot}
+    hrefFor={detailHrefFor}
+    viewAllHref={`/${slug}?lens=hot`}
+    eyebrow="Hot"
+    emptyLabel="No trending projects yet."
+  />
+
+  <RecordSection
+    id="new"
+    title="Recently added"
+    description="Fresh entries — pushed within the last week or carrying the curated 'new' label."
+    items={newItems}
+    hrefFor={detailHrefFor}
+    viewAllHref={`/${slug}?lens=new`}
+    eyebrow="New"
+    emptyLabel="No new projects yet."
+  />
+
+  <RecordSection
+    id="mature"
+    title="Established"
+    description="Long-running curated projects with deep history and stable architecture."
+    items={mature}
+    hrefFor={detailHrefFor}
+    viewAllHref={`/${slug}?lens=mature`}
+    eyebrow="Mature"
+    emptyLabel="No established projects yet."
+  />
+
+  {stacks.length > 0 && (
+    <StackGrid
+      stacks={stacks}
+      pathPrefix={`/${slug}`}
+    />
+  )}
+
+  {categories.length > 0 && (
+    <CategoryGrid
+      categories={categories}
+      pathPrefix={`/${slug}`}
+    />
+  )}
+
+  {hasContributors && (
+    <ContributorsGrid
+      contributors={contributors!}
+      total={contributors!.length}
+      viewAllHref={siteConfig.repoUrl || undefined}
+      viewAllLabel="View on GitHub"
+    />
+  )}
+
+  {repoStats.originalRepo && (
+    <OriginalCollection
+      repoUrl={repoStats.originalRepo}
+      stats={{
+        stars: repoStats.stars,
+        forks: repoStats.forks,
+        contributors: repoStats.contributors,
+        description: repoStats.description,
+      }}
+    />
+  )}
 </BaseLayout>