@grove-dev/astro 0.2.14 → 0.2.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grove-dev/astro",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "type": "module",
   "description": "Astro framework adapter for Grove. Components, layouts, design tokens, and a default template.",
   "license": "MIT",
@@ -43,8 +43,8 @@
     "./layouts/*": "./src/layouts/*.astro"
   },
   "dependencies": {
-    "@grove-dev/core": "0.2.14",
-    "@grove-dev/ui": "1.0.4",
+    "@grove-dev/core": "0.2.16",
+    "@grove-dev/ui": "1.0.6",
     "astro": "^6.4.6"
   },
   "peerDependencies": {

package/src/components/ItemCard.astro

@@ -10,10 +10,18 @@
  * /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 both are
- * provided, `href` wins; when only `pathPrefix` is provided, the
- * detail href is `${pathPrefix}/${item.slug}`.
+ * 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 Icon from "./Icon.astro";
@@ -26,12 +34,16 @@ type CardRecord = IndexRecord | Resource | ProjectRecord | IndexProjectRecord;
 interface Props {
   /** V1 API — full Resource/IndexProjectRecord. */
   record?: CardRecord;
-  /** V1 API — full detail-page URL. */
+  /** 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. */
+   *  blueprint routeSlug + slug. Default `"/items"` (V0 leftover). */
   pathPrefix?: string;
   /** When true, show owner/repo below the title. Default true. */
   showOwner?: boolean;
@@ -47,6 +59,7 @@ interface Props {
 const {
   record: recordProp,
   href: hrefProp,
+  routeSlug,
   item: itemProp,
   pathPrefix = "/items",
   showOwner = true,
@@ -62,7 +75,12 @@ 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}`;
 }
@@ -187,6 +205,16 @@ const category = (item as { category?: string }).category;
                 data-event-item={slug}
                 class="relative z-10 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 dark:text-ink-500">@</span>{owner}{repo ? <span class="text-ink-400 dark:text-ink-500">/{repo}</span> : ""}
               </a>
               <span class="mx-1 text-ink-300 dark:text-ink-700">·</span>

package/templates/default/package.json

@@ -25,9 +25,9 @@
   },
   "dependencies": {
     "@astrojs/check": "^0.9.9",
-    "@grove-dev/astro": "0.2.14",
-    "@grove-dev/cli": "0.2.14",
-    "@grove-dev/core": "0.2.14",
+    "@grove-dev/astro": "0.2.16",
+    "@grove-dev/cli": "0.2.16",
+    "@grove-dev/core": "0.2.16",
     "@tailwindcss/vite": "^4.3.0",
     "astro": "^6.4.4",
     "marked": "^18.0.0",

package/templates/default/public/llms-full.txt

@@ -1,6 +1,6 @@
 # example.com — full directory
 
-Generated: 2026-06-13T15:14:22.567Z
+Generated: 2026-06-15T13:49:39.319Z
 Records: 8
 
 ---

package/templates/default/public/sitemap.xml

@@ -2,61 +2,61 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://example.com/</loc>
-    <lastmod>2026-06-13T15:14:22.098Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>daily</changefreq>
     <priority>1.0</priority>
   </url>
   <url>
     <loc>https://example.com/projects</loc>
-    <lastmod>2026-06-13T15:14:22.098Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>daily</changefreq>
     <priority>0.9</priority>
   </url>
   <url>
     <loc>https://example.com/projects/coolify</loc>
-    <lastmod>2026-06-13T15:14:22.098Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/gitea</loc>
-    <lastmod>2026-06-13T15:14:22.098Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/hoppscotch</loc>
-    <lastmod>2026-06-13T15:14:22.098Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/inventree</loc>
-    <lastmod>2026-06-13T15:14:22.098Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/label-studio</loc>
-    <lastmod>2026-06-13T15:14:22.098Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/logseq</loc>
-    <lastmod>2026-06-13T15:14:22.098Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/private-gpt</loc>
-    <lastmod>2026-06-13T15:14:22.098Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>
   <url>
     <loc>https://example.com/projects/wakapi</loc>
-    <lastmod>2026-06-13T15:14:22.098Z</lastmod>
+    <lastmod>2026-06-15T13:49:38.754Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.7</priority>
   </url>

package/templates/default/src/pages/[slug]/[recordSlug].astro

@@ -162,20 +162,51 @@ const languages = extras.github?.languages
 const totalLanguageBytes = Math.max(1, languages.reduce((sum, [, b]) => sum + b, 0));
 
 // ── Kind-aware JSON-LD ─────────────────────────────────────────
+// Mirrors the openapps field set (10+ fields for projects):
+//   name, headline, description, url, codeRepository, sameAs,
+//   programmingLanguage, license, applicationCategory,
+//   operatingSystem, keywords, dateCreated, dateModified,
+//   interactionStatistic, author, isAccessibleForFree.
 let jsonLd: Record<string, unknown>;
 if (isProject && proj) {
+  const sameAs = [repoUrl, homepageUrl].filter((value): value is string =>
+    typeof value === "string" && value.length > 0,
+  );
+  const keywords = (record.tags ?? []).length > 0 ? (record.tags ?? []).join(", ") : undefined;
+  const operatingSystem = (proj.platforms ?? []).length > 0
+    ? (proj.platforms ?? []).join(", ")
+    : undefined;
+  const applicationCategory = (record.category ?? "") || undefined;
+  const dateCreated = (record as { curation?: { reviewedAt?: string } }).curation?.reviewedAt;
+  const dateModified = pushedAt ?? dateCreated;
+  const interactionStatistic = stars > 0
+    ? {
+        "@type": "InteractionCounter",
+        interactionType: { "@type": "LikeAction" },
+        userInteractionCount: stars,
+      }
+    : undefined;
   jsonLd = {
     "@context": "https://schema.org",
     "@type": "SoftwareSourceCode",
     name,
+    headline: name,
     description: record.description ?? undefined,
     url: repoUrl || homepageUrl || undefined,
     codeRepository: repoUrl || undefined,
+    sameAs: sameAs.length > 0 ? sameAs : undefined,
     programmingLanguage: language ?? undefined,
     license: licenseSpdx ?? undefined,
+    applicationCategory,
+    operatingSystem,
+    keywords,
+    dateCreated: dateCreated ?? undefined,
+    dateModified: dateModified ?? undefined,
+    interactionStatistic,
     author: ownerRepo
       ? { "@type": "Organization", name: ownerRepo.owner, url: `https://github.com/${ownerRepo.owner}` }
       : undefined,
+    isAccessibleForFree: true,
   };
 } else if (record.kind === "resource") {
   const resourceSchemaType: Record<string, string> = {
@@ -189,20 +220,25 @@ if (isProject && proj) {
     "@context": "https://schema.org",
     "@type": resourceSchemaType[record.type] ?? "CreativeWork",
     name,
+    headline: name,
     description: record.description || undefined,
     url: homepageUrl || undefined,
     author: record.author ? { "@type": "Person", name: record.author } : undefined,
     datePublished: record.publishedAt || undefined,
+    keywords: (record.tags ?? []).length > 0 ? (record.tags ?? []).join(", ") : undefined,
+    isAccessibleForFree: true,
   };
 } else {
   jsonLd = {
     "@context": "https://schema.org",
     "@type": record.type === "person" ? "Person" : "Organization",
     name,
+    headline: name,
     description: record.description || undefined,
     url: homepageUrl || undefined,
     foundingDate: record.founded || undefined,
     location: record.location || undefined,
+    keywords: (record.tags ?? []).length > 0 ? (record.tags ?? []).join(", ") : undefined,
   };
 }
 ---
@@ -264,6 +300,17 @@ if (isProject && proj) {
                 {labelDisplay(l) ?? prettySlug(l)}
               </span>
             ))}
+            {record.curation?.reviewed && (
+              <span
+                class="inline-flex items-center gap-1 rounded border border-emerald-300/60 bg-emerald-50 px-1.5 py-0.5 text-[10px] font-medium text-emerald-800 dark:border-emerald-800/60 dark:bg-emerald-950/40 dark:text-emerald-300"
+                title="A human curator reviewed this record. (No reviewer name is shown — the framework is reviewer-agnostic; consumers can wire the curation.by field into their own badge component.)"
+              >
+                <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>
+                Curator reviewed
+              </span>
+            )}
             {healthLabel && (
               <span class="grove-badge grove-badge-stale">{healthLabel}</span>
             )}

package/templates/default/src/pages/[slug]/index.astro

@@ -21,6 +21,7 @@ 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 IndexRow from "@grove-dev/astro/components/IndexRow.astro";
+import Pagination from "@grove-dev/astro/components/Pagination.astro";
 import ExploreByCategory from "@grove-dev/astro/components/ExploreByCategory.astro";
 import ExploreByStack from "@grove-dev/astro/components/ExploreByStack.astro";
 import {
@@ -36,6 +37,7 @@ import {
   paginate,
   searchParamsFromFilters,
   sortDisplay,
+  SORT_OPTIONS,
   totalPages,
 } from "@grove-dev/astro";
 
@@ -165,6 +167,7 @@ function hrefForRemove(key: keyof IndexFilters, value: string): string {
       <form
         method="get"
         action={`/${slug}`}
+        id="search-form"
         class="mt-6 flex flex-col gap-2 sm:flex-row"
         role="search"
       >
@@ -178,9 +181,10 @@ function hrefForRemove(key: keyof IndexFilters, value: string): string {
             class="pointer-events-none absolute left-3 top-1/2 -translate-y-1/2 text-ink-400"
             fill="currentColor"
           >
-            <path d="M10.68 11.74a6 6 0 0 1-7.922-8.982 6 6 0 0 1 8.982 7.922l3.04 3.04a.75.75 0 0 1-1.06 1.06l-3.04-3.04ZM11.5 7a4.5 4.5 0 1 0-9 0 4.5 4.5 0 0 0 9 0Z" />
+            <path d="M10.68 11.74a6 6 0 0 1-7.922-8.982 6 6 0 0 1 8.982 7.922l3.04 3.04a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215ZM11.5 7a4.5 4.5 0 1 0-9 0 4.5 4.5 0 0 0 9 0Z" />
           </svg>
           <input
+            id="search-input"
             type="search"
             name="q"
             value={filters.q ?? ""}
@@ -188,7 +192,28 @@ function hrefForRemove(key: keyof IndexFilters, value: string): string {
             class="h-10 w-full rounded-md border border-ink-200 bg-white py-2 pl-9 pr-3 text-sm text-ink-900 placeholder:text-ink-400 focus:border-ink-900 focus:outline-none focus:ring-2 focus:ring-ink-900/10 dark:border-ink-800 dark:bg-ink-950 dark:text-ink-100"
           />
         </label>
-        {filters.sort && <input type="hidden" name="sort" value={filters.sort} />}
+        <label class="relative">
+          <span class="sr-only">{`Sort ${itemLabelPlural()}`}</span>
+          <select
+            id="sort-select"
+            name="sort"
+            class="h-10 cursor-pointer appearance-none rounded-md border border-ink-200 bg-white py-1.5 pl-3 pr-8 text-sm font-medium text-ink-700 transition-colors hover:border-ink-300 focus:border-ink-900 focus:outline-none focus:ring-2 focus:ring-ink-900/10 dark:border-ink-800 dark:bg-ink-950 dark:text-ink-300 dark:hover:border-ink-700 dark:focus:border-ink-100 dark:focus:ring-ink-100/15"
+          >
+            {SORT_OPTIONS.map((o) => (
+              <option value={o.value} selected={o.value === sort}>{o.label}</option>
+            ))}
+          </select>
+          <svg
+            viewBox="0 0 16 16"
+            width="11"
+            height="11"
+            aria-hidden="true"
+            class="pointer-events-none absolute right-2.5 top-1/2 -translate-y-1/2 text-ink-400"
+            fill="currentColor"
+          >
+            <path d="M4.22 6.22a.75.75 0 0 1 1.06 0L8 8.94l2.72-2.72a.75.75 0 1 1 1.06 1.06l-3.25 3.25a.75.75 0 0 1-1.06 0L4.22 7.28a.75.75 0 0 1 0-1.06Z" />
+          </svg>
+        </label>
         <button type="submit" class="grove-btn grove-btn-primary">Search</button>
       </form>
 
@@ -278,7 +303,28 @@ function hrefForRemove(key: keyof IndexFilters, value: string): string {
         </p>
         <a href={`/${slug}`} class="grove-btn grove-btn-outline mt-4">Clear filters</a>
       </div>
-      <nav id="client-pagination" class="mt-8 flex flex-wrap items-center justify-center gap-1.5" aria-label="Pagination"></nav>
+      <nav class="mt-8 flex flex-wrap items-center justify-center gap-1.5" aria-label="Pagination">
+        <Pagination current={page} total={pages} hrefFor={hrefForPage} />
+      </nav>
+    </div>
+  </section>
+
+  <section class="border-t border-ink-200 dark:border-ink-800">
+    <div class="grove-container-wide mx-auto px-5 sm:px-7">
+      <div class="flex flex-col items-center gap-3 py-12 text-center">
+        <h2 class="m-0 text-xl font-semibold tracking-tight text-ink-900 dark:text-ink-100">
+          {`Know a real ${itemLabel()} that belongs here?`}
+        </h2>
+        <p class="m-0 max-w-2xl text-sm text-ink-500 dark:text-ink-400">
+          {`Open a pull request with a YAML file. We review every submission against the bar — no marketing, no tutorials.`}
+        </p>
+        <a
+          href={siteConfig.submitUrl ?? "/submit"}
+          class="grove-btn grove-btn-primary mt-2"
+        >
+          {`Submit ${itemLabel()}`}
+        </a>
+      </div>
     </div>
   </section>
 
@@ -288,6 +334,49 @@ function hrefForRemove(key: keyof IndexFilters, value: string): string {
       var list = document.getElementById("results-list");
       if (!list) return;
 
+      // Sort dropdown: navigate on change so the server re-renders
+      // the sorted list (URL is the source of truth for filters/sort).
+      var sortSelect = document.getElementById("sort-select");
+      if (sortSelect) {
+        sortSelect.addEventListener("change", function () {
+          var params = new URLSearchParams(location.search);
+          if (sortSelect.value && sortSelect.value !== "recently-updated") {
+            params.set("sort", sortSelect.value);
+          } else {
+            params.delete("sort");
+          }
+          params.delete("page");
+          var qs = params.toString();
+          location.assign(qs ? "?" + qs : location.pathname);
+        });
+      }
+
+      // Search: 250ms debounce; pressing Enter still submits
+      // immediately via the form's normal submit handler.
+      var searchInput = document.getElementById("search-input");
+      var searchForm = document.getElementById("search-form");
+      if (searchInput && searchForm) {
+        var debounceTimer = null;
+        var submit = function () {
+          var params = new URLSearchParams(location.search);
+          var term = searchInput.value.trim();
+          if (term) params.set("q", term);
+          else params.delete("q");
+          params.delete("page");
+          var qs = params.toString();
+          location.assign(qs ? "?" + qs : location.pathname);
+        };
+        searchInput.addEventListener("input", function () {
+          if (debounceTimer) window.clearTimeout(debounceTimer);
+          debounceTimer = window.setTimeout(submit, 250);
+        });
+        searchForm.addEventListener("submit", function (event) {
+          event.preventDefault();
+          if (debounceTimer) window.clearTimeout(debounceTimer);
+          submit();
+        });
+      }
+
       function values(params, key) {
         return params.getAll(key).filter(Boolean);
       }
@@ -396,21 +485,9 @@ function hrefForRemove(key: keyof IndexFilters, value: string): string {
           });
         });
 
-        var pager = document.getElementById("client-pagination");
-        if (pager) {
-          pager.innerHTML = "";
-          if (totalPages > 1) {
-            for (var number = 1; number <= totalPages; number += 1) {
-              var link = document.createElement("a");
-              link.href = pageHref(params, number);
-              link.textContent = String(number);
-              link.className = "grove-btn min-w-9 px-2 py-1.5 text-2xs " +
-                (number === page ? "grove-btn-primary" : "grove-btn-outline");
-              if (number === page) link.setAttribute("aria-current", "page");
-              pager.appendChild(link);
-            }
-          }
-        }
+        // Pagination is server-rendered (see <Pagination /> in the
+        // template) so the static HTML contains the page-number
+        // links for SEO. No client-side rendering loop here.
 
         var chipHost = document.getElementById("active-filters");
         if (chipHost) {