@grove-dev/astro 0.1.0

package/README.md

@@ -0,0 +1,81 @@
+# `@grove-dev/astro`
+
+> Astro framework adapter for Grove.
+
+A thin layer of Astro components, layouts, and design tokens, on top of the framework-agnostic `@grove-dev/core` and `@grove-dev/ui`. Includes a default `templates/default/` directory that `grove new` copies into a new project.
+
+```bash
+pnpm add @grove-dev/astro
+```
+
+## What it ships
+
+```txt
+src/
+├── components/        # ItemCard, CategoryGrid, HealthBadge, ScoreBars,
+│                      # DirectoryFilters, DirectoryHero, LensTabs,
+│                      # ActiveFilterChips, MethodologyPanel, Pagination,
+│                      # ProjectDetail, SubmitDraft
+├── layouts/           # BaseLayout
+├── styles.css         # design tokens + utility classes
+└── index.ts           # re-exports @grove-dev/ui
+
+templates/
+└── default/           # full Astro starter: pages/, layouts/, public/, data/,
+                       # .github/, astro.config.mjs, tailwind.config.mjs
+```
+
+The package publishes `dist/`, `src/`, and `templates/`. The `templates/` directory is **not** imported by consumers; it is copied by `@grove-dev/cli` at scaffold time.
+
+## Usage in a space
+
+```astro
+---
+import { ItemCard, ScoreBars, HealthBadge, DirectoryFilters } from "@grove-dev/astro";
+import "@grove-dev/astro/styles.css";
+import BaseLayout from "@grove-dev/astro/layouts/BaseLayout.astro";
+import apps from "../data/generated/apps.json";
+---
+<BaseLayout title="My Grove space">
+  <DirectoryFilters facets={...} />
+  {apps.map((app) => <ItemCard item={app} />)}
+</BaseLayout>
+```
+
+Components are imported by path, not through the barrel — that lets `astro check` validate them in their own context. The barrel re-exports `@grove-dev/ui` so generic helpers (`filterRecords`, `slugForCategory`, etc.) are available from the same import.
+
+## Templates
+
+`templates/default/` is a complete Astro starter. It contains:
+
+- `src/pages/` — index, item detail, search, about, methodology, submit, sitemap
+- `src/components/` — layout primitives, page sections
+- `src/data/` — placeholder dataset; replaced by `grove build-data`
+- `src/lib/` — site-specific helpers (no business logic)
+- `public/` — icons, OG image, robots
+- `data/` — empty tree for the gardener to populate
+- `astro.config.mjs`, `tailwind.config.mjs`
+- `.github/` — issue templates
+
+Business logic (filtering, sorting, scoring, faceting) is **imported from `@grove-dev/ui`**, never re-implemented in the template.
+
+## Layering
+
+`@grove-dev/astro` is the third layer of the Grove stack:
+
+1. **`@grove-dev/core`** — schemas, importers, build pipeline (headless).
+2. **`@grove-dev/ui`** — framework-agnostic UI primitives.
+3. **`@grove-dev/astro`** ← you are here — Astro components, layouts, template.
+
+If you need a Svelte or Next.js variant, see `@grove-dev/svelte` and `@grove-dev/nextjs`.
+
+## Development
+
+```bash
+pnpm --filter @grove-dev/astro build
+pnpm --filter @grove-dev/astro check
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @grove-dev/astro — Astro UI primitives for Grove.
+ *
+ * This package only owns Astro components, layouts, styles, and
+ * Astro-specific integrations. Generic filter/sort/stats/score
+ * helpers live in `@grove-dev/ui` and are re-exported from here for
+ * convenience.
+ *
+ * Templates (concrete pages, layouts, public/, .github/) are not
+ * published; they're copied into user projects by `grove new`.
+ */
+export * from "@grove-dev/ui";
+export { default as ItemCard } from "./components/ItemCard.astro";
+export { default as CategoryGrid } from "./components/CategoryGrid.astro";
+export { default as HealthBadge } from "./components/HealthBadge.astro";
+export { default as ScoreBars } from "./components/ScoreBars.astro";
+export { default as DirectoryHero } from "./components/DirectoryHero.astro";
+export { default as DirectoryFilters } from "./components/DirectoryFilters.astro";
+export { default as ActiveFilterChips } from "./components/ActiveFilterChips.astro";
+export { default as LensTabs } from "./components/LensTabs.astro";
+export { default as MethodologyPanel } from "./components/MethodologyPanel.astro";
+export { default as Pagination } from "./components/Pagination.astro";
+export { default as ProjectDetail } from "./components/ProjectDetail.astro";
+export { default as SubmitDraft } from "./components/SubmitDraft.astro";
+export { default as BaseLayout } from "./layouts/BaseLayout.astro";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,eAAe,CAAC;AAE9B,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * @grove-dev/astro — Astro UI primitives for Grove.
+ *
+ * This package only owns Astro components, layouts, styles, and
+ * Astro-specific integrations. Generic filter/sort/stats/score
+ * helpers live in `@grove-dev/ui` and are re-exported from here for
+ * convenience.
+ *
+ * Templates (concrete pages, layouts, public/, .github/) are not
+ * published; they're copied into user projects by `grove new`.
+ */
+export * from "@grove-dev/ui";
+export { default as ItemCard } from "./components/ItemCard.astro";
+export { default as CategoryGrid } from "./components/CategoryGrid.astro";
+export { default as HealthBadge } from "./components/HealthBadge.astro";
+export { default as ScoreBars } from "./components/ScoreBars.astro";
+export { default as DirectoryHero } from "./components/DirectoryHero.astro";
+export { default as DirectoryFilters } from "./components/DirectoryFilters.astro";
+export { default as ActiveFilterChips } from "./components/ActiveFilterChips.astro";
+export { default as LensTabs } from "./components/LensTabs.astro";
+export { default as MethodologyPanel } from "./components/MethodologyPanel.astro";
+export { default as Pagination } from "./components/Pagination.astro";
+export { default as ProjectDetail } from "./components/ProjectDetail.astro";
+export { default as SubmitDraft } from "./components/SubmitDraft.astro";
+export { default as BaseLayout } from "./layouts/BaseLayout.astro";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,eAAe,CAAC;AAE9B,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@grove-dev/astro",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Astro framework adapter for Grove. Components, layouts, design tokens, and a default template.",
+  "license": "MIT",
+  "keywords": [
+    "grove",
+    "astro",
+    "ui",
+    "template",
+    "components",
+    "static-site"
+  ],
+  "homepage": "https://github.com/tortuvshin/grove#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tortuvshin/grove.git",
+    "directory": "packages/astro"
+  },
+  "bugs": {
+    "url": "https://github.com/tortuvshin/grove/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "src",
+    "templates",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles.css": "./src/styles.css",
+    "./components/*": "./src/components/*.astro",
+    "./layouts/*": "./src/layouts/*.astro",
+    "./package.json": "./package.json",
+    "./templates/*": "./templates/*"
+  },
+  "dependencies": {
+    "@grove-dev/core": "0.1.1",
+    "@grove-dev/ui": "0.1.1",
+    "astro": "^6.4.4"
+  },
+  "peerDependencies": {
+    "astro": "^6.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "echo \"No astro package tests yet\""
+  }
+}

package/src/components/ActiveFilterChips.astro

@@ -0,0 +1,20 @@
+---
+import type { DirectoryFilters } from "@grove-dev/ui";
+import { activeFilterChips } from "@grove-dev/ui";
+
+interface Props {
+  filters: DirectoryFilters;
+}
+
+const { filters } = Astro.props;
+const chips = activeFilterChips(filters);
+---
+
+{chips.length > 0 && (
+  <div class="oc-active-chips" aria-label="Active filters">
+    {chips.map((chip) => (
+      <span data-filter-chip={chip.key}>{chip.label}</span>
+    ))}
+    <a href="/projects">Clear all</a>
+  </div>
+)}

package/src/components/CategoryGrid.astro

@@ -0,0 +1,27 @@
+---
+import { slugForCategory } from "@grove-dev/ui";
+
+interface Props {
+  categories: Array<{ name: string; count: number }>;
+}
+
+const { categories } = Astro.props;
+---
+
+<section class="oc-section">
+  <div class="oc-section-header">
+    <div>
+      <p class="oc-eyebrow">Browse</p>
+      <h2>Categories</h2>
+    </div>
+    <a href="/projects">View all</a>
+  </div>
+  <div class="oc-category-grid">
+    {categories.map((category) => (
+      <a class="oc-category-card" href={`/categories/${slugForCategory(category.name)}`}>
+        <span>{category.name}</span>
+        <strong>{category.count}</strong>
+      </a>
+    ))}
+  </div>
+</section>

package/src/components/DirectoryFilters.astro

@@ -0,0 +1,100 @@
+---
+import type { HealthStatus } from "@grove-dev/core";
+
+interface Props {
+  q?: string;
+  category?: string;
+  tag?: string;
+  language?: string;
+  license?: string;
+  health?: string;
+  maintained?: boolean;
+  hideArchived?: boolean;
+  hasRecentRelease?: boolean;
+  categories: string[];
+  tags: string[];
+  languages: string[];
+  licenses: string[];
+  action?: string;
+}
+
+const {
+  q = "",
+  category = "",
+  tag = "",
+  language = "",
+  license = "",
+  health = "all",
+  maintained = false,
+  hideArchived = false,
+  hasRecentRelease = false,
+  categories,
+  tags,
+  languages,
+  licenses,
+  action = "/projects",
+} = Astro.props;
+
+const healthOptions: Array<HealthStatus | "all"> = [
+  "all",
+  "mature",
+  "active",
+  "stale",
+  "needs_review",
+  "inactive",
+  "archived",
+  "unknown",
+];
+---
+
+<form class="oc-filters" action={action} method="get" role="search">
+  <label class="oc-filter-search">
+    <span>Search</span>
+    <input type="search" name="q" value={q} placeholder="Name, description, tag, license..." />
+  </label>
+  <label>
+    <span>Category</span>
+    <select name="category">
+      <option value="">All categories</option>
+      {categories.map((value) => <option value={value} selected={value === category}>{value}</option>)}
+    </select>
+  </label>
+  <label>
+    <span>Health</span>
+    <select name="health">
+      {healthOptions.map((value) => (
+        <option value={value} selected={value === health}>{value.replace(/_/g, " ")}</option>
+      ))}
+    </select>
+  </label>
+  <label>
+    <span>Tag</span>
+    <select name="tag">
+      <option value="">All tags</option>
+      {tags.map((value) => <option value={value} selected={value === tag}>{value}</option>)}
+    </select>
+  </label>
+  <label>
+    <span>Language</span>
+    <select name="language">
+      <option value="">All languages</option>
+      {languages.map((value) => <option value={value} selected={value === language}>{value}</option>)}
+    </select>
+  </label>
+  <label>
+    <span>License</span>
+    <select name="license">
+      <option value="">All licenses</option>
+      {licenses.map((value) => <option value={value} selected={value === license}>{value}</option>)}
+    </select>
+  </label>
+  <div class="oc-filter-toggles">
+    <label><input type="checkbox" name="maintained" value="1" checked={maintained} /> Maintained only</label>
+    <label><input type="checkbox" name="hideArchived" value="1" checked={hideArchived} /> Hide archived</label>
+    <label><input type="checkbox" name="hasRecentRelease" value="1" checked={hasRecentRelease} /> Recent release</label>
+  </div>
+  <div class="oc-filter-actions">
+    <button type="submit">Apply</button>
+    <a href={action}>Reset</a>
+  </div>
+</form>

package/src/components/DirectoryHero.astro

@@ -0,0 +1,32 @@
+---
+import type { DirectoryStats } from "@grove-dev/ui";
+
+interface Props {
+  name: string;
+  tagline: string;
+  stats: DirectoryStats;
+}
+
+const { name, tagline, stats } = Astro.props;
+---
+
+<section class="oc-hero">
+  <div>
+    <p class="oc-eyebrow">Grove</p>
+    <h1>{name}</h1>
+    <p class="oc-lede">{tagline}</p>
+  </div>
+  <form class="oc-hero-search" action="/projects" role="search">
+    <label>
+      <span class="oc-sr-only">Search projects</span>
+      <input type="search" name="q" placeholder="Search projects, tags, licenses..." />
+    </label>
+    <button type="submit">Search</button>
+  </form>
+  <dl class="oc-stats">
+    <div><dt>Projects</dt><dd>{stats.total}</dd></div>
+    <div><dt>Active</dt><dd>{stats.active}</dd></div>
+    <div><dt>Mature</dt><dd>{stats.mature}</dd></div>
+    <div><dt>Needs review</dt><dd>{stats.needsReview}</dd></div>
+  </dl>
+</section>

package/src/components/HealthBadge.astro

@@ -0,0 +1,12 @@
+---
+import type { HealthStatus } from "@grove-dev/core";
+
+interface Props {
+  status?: HealthStatus;
+}
+
+const { status = "unknown" } = Astro.props;
+const label = status.replace(/_/g, " ");
+---
+
+<span class={`oc-health oc-health-${status}`}>{label}</span>

package/src/components/ItemCard.astro

@@ -0,0 +1,41 @@
+---
+import type { CuratedItem, HealthEntry } from "@grove-dev/core";
+import HealthBadge from "./HealthBadge.astro";
+
+interface Props {
+  item: CuratedItem;
+  health?: HealthEntry;
+}
+
+const { item, health } = Astro.props;
+const href = `/projects/${item.id}`;
+const tags = item.taxonomy.tags.slice(0, 4);
+---
+
+<article class="oc-card">
+  <div class="oc-card-header">
+    <div>
+      <h2 class="oc-card-title">
+        <a href={href}>{item.name}</a>
+      </h2>
+      <p class="oc-card-category">{item.taxonomy.category}</p>
+    </div>
+    <HealthBadge status={health?.health.status} />
+  </div>
+  <p class="oc-card-description">{item.description}</p>
+  <div class="oc-card-meta">
+    {health?.github?.stars != null && <span>{health.github.stars.toLocaleString()} stars</span>}
+    {health?.github?.license && <span>{health.github.license}</span>}
+    {health?.github?.language && <span>{health.github.language}</span>}
+  </div>
+  <div class="oc-card-actions">
+    <a href={`/projects/${item.id}`}>Details</a>
+    {item.links.github && <a href={item.links.github}>GitHub</a>}
+    {item.links.docs && <a href={item.links.docs}>Docs</a>}
+  </div>
+  {tags.length > 0 && (
+    <ul class="oc-tags" aria-label="Tags">
+      {tags.map((tag) => <li>{tag}</li>)}
+    </ul>
+  )}
+</article>

package/src/components/LensTabs.astro

@@ -0,0 +1,26 @@
+---
+import { LENSES } from "@grove-dev/ui";
+
+interface Props {
+  current?: string;
+  action?: string;
+}
+
+const { current = "all", action = "/projects" } = Astro.props;
+---
+
+<nav class="oc-lenses" aria-label="Curated lenses">
+  {LENSES.map((lens) => {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(lens.params)) {
+      params.set(key, String(value));
+    }
+    const href = lens.id === "all" ? action : `${action}?${params.toString()}`;
+    const active = current === lens.id || (current === "all" && lens.id === "all");
+    return (
+      <a href={href} data-lens-id={lens.id} aria-current={active ? "page" : undefined} title={lens.description}>
+        {lens.label}
+      </a>
+    );
+  })}
+</nav>

package/src/components/MethodologyPanel.astro

@@ -0,0 +1,20 @@
+---
+---
+
+<section class="oc-methodology">
+  <div>
+    <p class="oc-eyebrow">Methodology</p>
+    <h2>Health is a signal, not an automatic deletion rule.</h2>
+    <p>
+      Grove checks repository activity, archived state, releases, license,
+      adoption, and metadata freshness. Projects can still be kept, highlighted,
+      hidden, or preserved as historical through human curation decisions.
+    </p>
+  </div>
+  <ul>
+    <li>Archived repositories are flagged clearly.</li>
+    <li>Recent commits and releases increase confidence.</li>
+    <li>Missing metadata becomes unknown or needs review.</li>
+    <li>Humans control final visibility in decisions.yml.</li>
+  </ul>
+</section>

package/src/components/Pagination.astro

@@ -0,0 +1,24 @@
+---
+interface Props {
+  page: number;
+  pages: number;
+  base?: string;
+}
+
+const { page, pages, base = "/projects" } = Astro.props;
+
+function href(target: number) {
+  const current = new URL(Astro.url);
+  current.searchParams.set("page", String(target));
+  const query = current.searchParams.toString();
+  return `${base}${query ? `?${query}` : ""}`;
+}
+---
+
+{pages > 1 && (
+  <nav class="oc-pagination" aria-label="Pagination">
+    <a href={href(Math.max(1, page - 1))} aria-disabled={page <= 1 ? "true" : undefined}>Previous</a>
+    <span>Page {page} of {pages}</span>
+    <a href={href(Math.min(pages, page + 1))} aria-disabled={page >= pages ? "true" : undefined}>Next</a>
+  </nav>
+)}