@grove-dev/astro 0.3.2 → 0.4.0

package/dist/lib/index.d.ts

@@ -23,4 +23,5 @@ export * from "./search.js";
 export * from "./scores.js";
 export * from "./taxonomy-counts.js";
 export * from "./display.js";
+export * from "./load-collections.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}

package/dist/lib/index.js

@@ -23,4 +23,5 @@ export * from "./search.js";
 export * from "./scores.js";
 export * from "./taxonomy-counts.js";
 export * from "./display.js";
+export * from "./load-collections.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC"}

package/dist/lib/load-collections.d.ts

@@ -0,0 +1,12 @@
+import type { Collection } from "@grove-dev/core";
+/**
+ * Load all `Collection` YAML files from `<cwd>/data/collections/*.yml`.
+ *
+ * Returns an empty array if the directory does not exist, so callers can
+ * safely render an empty/loading state without having to guard each
+ * invocation site. Parse errors and other unexpected failures are NOT
+ * swallowed — they surface so real problems (malformed YAML, permission
+ * errors, etc.) are visible instead of silently producing empty output.
+ */
+export declare function loadCollections(cwd: string): Promise<Collection[]>;
+//# sourceMappingURL=load-collections.d.ts.map

package/dist/lib/load-collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-collections.d.ts","sourceRoot":"","sources":["../../src/lib/load-collections.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAkBxE"}

package/dist/lib/load-collections.js

@@ -0,0 +1,34 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+/**
+ * Load all `Collection` YAML files from `<cwd>/data/collections/*.yml`.
+ *
+ * Returns an empty array if the directory does not exist, so callers can
+ * safely render an empty/loading state without having to guard each
+ * invocation site. Parse errors and other unexpected failures are NOT
+ * swallowed — they surface so real problems (malformed YAML, permission
+ * errors, etc.) are visible instead of silently producing empty output.
+ */
+export async function loadCollections(cwd) {
+    const dir = resolve(cwd, "data/collections");
+    let files;
+    try {
+        files = await readdir(dir);
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+    const out = [];
+    for (const f of files.filter((f) => f.endsWith(".yml"))) {
+        const raw = parseYaml(await readFile(join(dir, f), "utf8"));
+        if (!raw || typeof raw !== "object") {
+            throw new Error(`Invalid collection YAML: ${f}`);
+        }
+        out.push(raw);
+    }
+    return out;
+}
+//# sourceMappingURL=load-collections.js.map

package/dist/lib/load-collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-collections.js","sourceRoot":"","sources":["../../src/lib/load-collections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IAC7C,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAChE,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACxD,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,GAAiB,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grove-dev/astro",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "type": "module",
   "description": "Composable Astro UI, data adapters, and integration for Grove directories.",
   "license": "MIT",
@@ -51,13 +51,14 @@
     "./server": "./src/server/index.ts"
   },
   "dependencies": {
-    "astro": "^6.4.6",
+    "astro": "^7.1.3",
     "marked": "^18.0.0",
     "sanitize-html": "^2.17.5",
-    "@grove-dev/core": "0.3.2"
+    "yaml": "^2.9.0",
+    "@grove-dev/core": "0.4.0"
   },
   "peerDependencies": {
-    "astro": "^6.0.0"
+    "astro": "^6.0.0 || ^7.0.0"
   },
   "devDependencies": {
     "@types/sanitize-html": "^2.16.0"

package/src/components/CollectionIndex.astro

@@ -0,0 +1,72 @@
+---
+/**
+ * CollectionIndex — renders a grid of every collection defined in
+ * `data/collections/*.yml`. Each card links to the collection's
+ * detail page and shows the entry count.
+ *
+ * Consumes a `CollectionIndexModel` produced by
+ * `getCollectionIndexModel`. Generic: no blueprint-specific copy.
+ */
+import Container from "../layouts/Container.astro";
+import type { CollectionIndexModel } from "../server/collections.js";
+
+interface Props {
+  model: CollectionIndexModel;
+  title?: string;
+  description?: string;
+  class?: string;
+}
+
+const {
+  model,
+  title = "Collections",
+  description = "Curated and generated directories of related items.",
+  class: className = "",
+} = Astro.props;
+---
+
+<section class={`py-12 sm:py-16 ${className}`}>
+  <Container>
+    <header class="mb-6">
+      <span class="text-2xs font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">
+        Browse
+      </span>
+      <h1 class="m-0 mt-1 text-[1.875rem] sm:text-[2.125rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100">
+        {title}
+      </h1>
+      <p class="m-0 mt-2 max-w-[64ch] text-[0.9375rem] text-ink-500 dark:text-ink-400">
+        {description}
+      </p>
+    </header>
+
+    {model.collections.length === 0 ? (
+      <p class="rounded-md border border-dashed border-ink-200 bg-white p-6 text-sm text-ink-500 dark:border-ink-800 dark:bg-ink-950 dark:text-ink-400">
+        No collections yet.
+      </p>
+    ) : (
+      <ul class="m-0 grid list-none grid-cols-1 gap-3 p-0 sm:grid-cols-2 lg:grid-cols-3">
+        {model.collections.map((c) => (
+          <li class="m-0 p-0">
+            <a
+              href={c.url}
+              class="flex h-full flex-col gap-2 rounded-md border border-ink-200 bg-white p-5 transition-colors hover:border-ink-400 dark:border-ink-800 dark:bg-ink-950 dark:hover:border-ink-600"
+            >
+              <span class="text-2xs font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">
+                {c.kind === "curated" ? "Curated" : "Generated"}
+              </span>
+              <span class="text-[1.0625rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100">
+                {c.title}
+              </span>
+              <span class="text-[0.875rem] text-ink-500 dark:text-ink-400">
+                {c.description}
+              </span>
+              <span class="mt-auto pt-2 text-2xs font-medium text-ink-500 dark:text-ink-400">
+                {c.count} {c.count === 1 ? "item" : "items"} →
+              </span>
+            </a>
+          </li>
+        ))}
+      </ul>
+    )}
+  </Container>
+</section>

package/src/components/CollectionPage.astro

@@ -0,0 +1,89 @@
+---
+/**
+ * CollectionPage — renders a single curated/generated collection.
+ *
+ * Consumes a `CollectionPageModel` produced by `getCollectionPageModel`.
+ * Renders the header (title, description, editorial notes), the
+ * matched entries via `CollectionRow`, and a related-collections
+ * section.
+ *
+ * Generic: no blueprint-specific copy. The `eyebrow` prop lets the
+ * consumer pick a label (e.g. "Curated" or "Generated").
+ */
+import CollectionRow from "./CollectionRow.astro";
+import Container from "../layouts/Container.astro";
+import type { CollectionPageModel } from "../server/collections.js";
+
+interface Props {
+  model: CollectionPageModel;
+  eyebrow?: string;
+  class?: string;
+}
+
+const {
+  model,
+  eyebrow = "Collection",
+  class: className = "",
+} = Astro.props;
+---
+
+<section class={`py-12 sm:py-16 ${className}`}>
+  <Container>
+    <header class="mb-6">
+      <span class="text-2xs font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">
+        {eyebrow}
+      </span>
+      <h1 class="m-0 mt-1 text-[1.875rem] sm:text-[2.125rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100">
+        {model.collection.title}
+      </h1>
+      <p class="m-0 mt-2 max-w-[64ch] text-[0.9375rem] text-ink-500 dark:text-ink-400">
+        {model.collection.description}
+      </p>
+      {model.collection.introduction && (
+        <p class="m-0 mt-3 max-w-[64ch] text-[0.9375rem] text-ink-700 dark:text-ink-300">
+          {model.collection.introduction}
+        </p>
+      )}
+      {model.collection.selectionNote && (
+        <p class="m-0 mt-3 max-w-[64ch] text-[0.875rem] font-medium text-ink-700 dark:text-ink-300">
+          <span class="text-2xs font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">Selection criteria · </span>
+          {model.collection.selectionNote}
+        </p>
+      )}
+    </header>
+
+    {model.isEmpty ? (
+      <p class="rounded-md border border-dashed border-ink-200 bg-white p-6 text-sm text-ink-500 dark:border-ink-800 dark:bg-ink-950 dark:text-ink-400">
+        This collection is currently empty.
+      </p>
+    ) : (
+      <ul class="m-0 flex list-none flex-col gap-3 p-0">
+        {model.entries.map((entry, i) => (
+          <li class="m-0 p-0">
+            <CollectionRow entry={entry} eager={i < 2} />
+          </li>
+        ))}
+      </ul>
+    )}
+
+    {model.related.length > 0 && (
+      <section class="mt-12 border-t border-ink-200 pt-8 dark:border-ink-800">
+        <h2 class="m-0 text-[1.125rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100">
+          Related collections
+        </h2>
+        <ul class="m-0 mt-3 flex list-none flex-col gap-2 p-0">
+          {model.related.map((r) => (
+            <li>
+              <a
+                href={r.url}
+                class="text-sm text-ink-700 transition-colors hover:text-ink-900 dark:text-ink-300 dark:hover:text-ink-100"
+              >
+                {r.title} →
+              </a>
+            </li>
+          ))}
+        </ul>
+      </section>
+    )}
+  </Container>
+</section>

package/src/components/CollectionRow.astro

@@ -0,0 +1,109 @@
+---
+/**
+ * CollectionRow — a single entry inside a curated/generated collection.
+ *
+ * Mirrors `IndexRow`'s visual rhythm (avatar, header, description, dl
+ * stats, footer links) but consumes the lighter `CollectionEntry`
+ * shape directly. The existing `IndexRow` is tightly coupled to
+ * `IndexRecord` (which carries `kind`, `repoUrl`, `github`, `bestFor`,
+ * etc.) — collections only have a subset of those fields, so a
+ * dedicated row keeps the contract clean.
+ *
+ * Generic: no blueprint-specific copy. Visual style mirrors IndexRow
+ * so a collection page sitting next to the directory index reads as
+ * the same site.
+ */
+import type { CollectionEntry } from "@grove-dev/core";
+import { formatStars, formatRelative } from "@grove-dev/astro";
+
+interface Props {
+  entry: CollectionEntry;
+  eager?: boolean;
+  class?: string;
+}
+
+const { entry, eager = false, class: className = "" } = Astro.props;
+
+const initials = entry.title
+  .split(/\s+/)
+  .map((word) => word[0])
+  .filter(Boolean)
+  .slice(0, 2)
+  .join("")
+  .toUpperCase();
+const stack = entry.stack ?? "—";
+const stars = entry.stars ?? null;
+const pushedAt = entry.pushedAt ?? null;
+const category = entry.categories?.[0];
+---
+
+<article
+  class={`rounded-[calc(var(--radius)+0.25rem)] border border-ink-200 bg-white shadow-none transition-colors hover:bg-secondary dark:border-ink-800 dark:bg-ink-950 dark:hover:bg-ink-900 group relative flex flex-col gap-3 p-4 ${className}`}
+>
+  <header class="flex items-start gap-3">
+    <a
+      href={entry.url}
+      class="relative z-10 flex shrink-0"
+      aria-label={`Open ${entry.title} details`}
+    >
+      <span class="flex h-11 w-11 items-center justify-center rounded-md border border-ink-200 bg-ink-50 text-sm font-semibold text-ink-700 dark:border-ink-800 dark:bg-ink-900/60 dark:text-ink-300">
+        {initials || "·"}
+      </span>
+    </a>
+    <div class="min-w-0 flex-1">
+      <div class="flex flex-wrap items-baseline gap-x-2 gap-y-0.5">
+        <h3 class="m-0 text-[1.0625rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100">
+          <a href={entry.url} class="relative z-10 hover:underline">{entry.title}</a>
+        </h3>
+        {category && (
+          <span class="text-2xs font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">
+            {category}
+          </span>
+        )}
+      </div>
+      <div class="flex flex-wrap items-center gap-x-1.5 text-2xs text-ink-500 dark:text-ink-400">
+        <span class="font-mono">{stack}</span>
+        {entry.platform?.length ? (
+          <>
+            <span class="text-ink-300 dark:text-ink-700">·</span>
+            <span>{entry.platform.slice(0, 3).join(", ")}</span>
+          </>
+        ) : null}
+        {entry.license ? (
+          <>
+            <span class="text-ink-300 dark:text-ink-700">·</span>
+            <span>{entry.license}</span>
+          </>
+        ) : null}
+      </div>
+    </div>
+  </header>
+
+  <p class="m-0 line-clamp-2 text-[0.8125rem] leading-relaxed text-ink-600 dark:text-ink-300">
+    {entry.description}
+  </p>
+
+  <dl class="grid grid-cols-3 gap-x-3 text-2xs">
+    <div class="flex items-baseline gap-1.5">
+      <dt class="font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">Stars</dt>
+      <dd class="font-mono text-ink-700 dark:text-ink-300">{formatStars(stars) ?? "—"}</dd>
+    </div>
+    <div class="flex items-baseline gap-1.5">
+      <dt class="font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">Updated</dt>
+      <dd class="font-mono text-ink-700 dark:text-ink-300">{formatRelative(pushedAt) ?? "—"}</dd>
+    </div>
+    <div class="flex items-baseline gap-1.5">
+      <dt class="font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">License</dt>
+      <dd class="font-mono text-ink-700 dark:text-ink-300">{entry.license ?? "—"}</dd>
+    </div>
+  </dl>
+
+  <footer class="relative z-10 mt-1 flex items-center gap-2 border-t border-ink-100 pt-2 text-2xs dark:border-ink-900">
+    <a
+      href={entry.url}
+      class="inline-flex h-8 cursor-pointer items-center justify-center gap-1.5 rounded-[var(--radius)] border border-transparent px-3 text-sm font-medium leading-none no-underline outline-none transition-colors focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/35 border-border bg-secondary text-foreground hover:bg-accent px-2 text-2xs"
+    >
+      View details →
+    </a>
+  </footer>
+</article>

package/src/components/CollectionTeaser.astro

@@ -0,0 +1,81 @@
+---
+/**
+ * CollectionTeaser — homepage-friendly subset of `CollectionIndex`.
+ * Renders a horizontal grid of 2-3 collection cards with a "View all"
+ * link in the header. Generic: no blueprint copy.
+ */
+import Container from "../layouts/Container.astro";
+import type { CollectionTeaserModel } from "../server/collections.js";
+
+interface Props {
+  model: CollectionTeaserModel;
+  title?: string;
+  description?: string;
+  viewAllHref?: string;
+  viewAllLabel?: string;
+  class?: string;
+}
+
+const {
+  model,
+  title = "Featured collections",
+  description = "Hand-picked and auto-generated groupings of related items.",
+  viewAllHref = "/collections/",
+  viewAllLabel = "View all collections",
+  class: className = "",
+} = Astro.props;
+---
+
+<section class={`py-12 sm:py-16 ${className}`}>
+  <Container>
+    <div class="mb-6 flex flex-wrap items-end justify-between gap-3">
+      <div>
+        <span class="text-2xs font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">
+          Collections
+        </span>
+        <h2 class="m-0 mt-1 text-[1.5rem] sm:text-[1.625rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100">
+          {title}
+        </h2>
+        <p class="m-0 mt-2 max-w-[60ch] text-[0.9375rem] text-ink-500 dark:text-ink-400">
+          {description}
+        </p>
+      </div>
+      {viewAllHref && (
+        <a
+          href={viewAllHref}
+          class="hidden shrink-0 pb-2 text-2xs font-medium text-ink-500 transition-colors hover:text-ink-900 sm:inline dark:text-ink-400 dark:hover:text-ink-100"
+        >
+          {viewAllLabel} →
+        </a>
+      )}
+    </div>
+
+    {model.collections.length === 0 ? (
+      <p class="m-0 text-sm text-ink-500 dark:text-ink-400">
+        No collections yet.
+      </p>
+    ) : (
+      <div class="grid grid-cols-1 gap-3 sm:grid-cols-2 lg:grid-cols-3">
+        {model.collections.map((c) => (
+          <a
+            href={c.url}
+            class="flex flex-col gap-2 rounded-md border border-ink-200 bg-white p-5 transition-colors hover:border-ink-400 dark:border-ink-800 dark:bg-ink-950 dark:hover:border-ink-600"
+          >
+            <span class="text-2xs font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">
+              {c.kind === "curated" ? "Curated" : "Generated"}
+            </span>
+            <span class="text-[1.0625rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100">
+              {c.title}
+            </span>
+            <span class="text-[0.875rem] text-ink-500 dark:text-ink-400">
+              {c.description}
+            </span>
+            <span class="mt-auto pt-2 text-2xs font-medium text-ink-500 dark:text-ink-400">
+              {c.count} {c.count === 1 ? "item" : "items"} →
+            </span>
+          </a>
+        ))}
+      </div>
+    )}
+  </Container>
+</section>

package/src/components/CurationGrid.astro

@@ -27,9 +27,9 @@ const columns = [
   >
     {columns.map((column) => (
       <div class="rounded-[calc(var(--radius)+0.25rem)] border-0 bg-muted shadow-none transition-colors p-5">
-        <h3 class="m-0 text-sm font-semibold uppercase tracking-wider text-ink-500 dark:text-ink-400">
+        <h2 class="m-0 text-sm font-semibold uppercase tracking-wider text-ink-500 dark:text-ink-400">
           {column.title}
-        </h3>
+        </h2>
         <ul class="mt-3 mb-0 flex list-disc flex-col gap-1.5 pl-5">
           {column.items.map((item) => (
             <li class="text-sm text-ink-700 dark:text-ink-200">{item}</li>

package/src/components/GroveDocumentHead.astro

@@ -0,0 +1,28 @@
+---
+import type { PageDocument } from "@grove-dev/core";
+interface Props {
+  document: PageDocument;
+}
+const { document: doc } = Astro.props;
+---
+<title>{doc.metadata.title}</title>
+<meta name="description" content={doc.metadata.description} />
+<meta name="robots" content={doc.metadata.robots} />
+<link rel="canonical" href={doc.identity.canonical.toString()} />
+{doc.identity.hreflang?.map((lang) => (
+  <link rel="alternate" hreflang={lang} href={doc.identity.canonical.toString()} />
+))}
+<meta property="og:title" content={doc.metadata.openGraph.title} />
+<meta property="og:description" content={doc.metadata.openGraph.description} />
+<meta property="og:url" content={doc.metadata.openGraph.url} />
+<meta property="og:image" content={doc.metadata.openGraph.image} />
+<meta property="og:type" content={doc.metadata.openGraph.type} />
+{doc.metadata.openGraph.siteName && (
+  <meta property="og:site_name" content={doc.metadata.openGraph.siteName} />
+)}
+<meta name="twitter:card" content={doc.metadata.twitter.card} />
+{doc.metadata.twitter.site && <meta name="twitter:site" content={doc.metadata.twitter.site} />}
+{doc.metadata.twitter.creator && <meta name="twitter:creator" content={doc.metadata.twitter.creator} />}
+{doc.structuredData.map((node) => (
+  <script type="application/ld+json" set:html={JSON.stringify(node)} />
+))}

package/src/components/Hero.astro

@@ -230,7 +230,6 @@ const trustStats: { value: string; label: string }[] = [
       {quickFilters.length > 0 && (
         <p
           class="mt-2 text-2xs text-ink-500 dark:text-ink-400 m-0"
-          aria-hidden="true"
         >
           Try{" "}
           {quickFilters.map((f, i) => (

package/src/components/Icon.astro

@@ -63,8 +63,8 @@ interface Props {
    */
   aliases?: Record<string, string>;
   /**
-   * Asset ids supplied by a consumer in addition to Grove's bundled registry.
-   * Unknown stack/platform ids render initials without issuing a failed request.
+   * Optional complete asset registry supplied by a consumer. When omitted,
+   * Grove attempts the configured asset path and falls back on image error.
    */
   available?: string[];
   /**
@@ -124,25 +124,11 @@ function resolveName(raw: string): string {
 }
 
 const resolved = resolveName(name);
-const bundledIcons: Record<"stack" | "platform", Set<string>> = {
-  stack: new Set([
-    "android", "apple", "bun", "capacitor", "clojure", "clojurescript",
-    "dart", "deno", "django", "docker", "firebase", "flutter", "go",
-    "graphql", "ionic", "java", "javascript", "kotlin", "llm", "mongodb",
-    "node.js", "nodejs", "python", "rag", "react", "react-native", "rust",
-    "solidity", "sveltekit", "swift", "tensorflow", "typescript", "vue",
-  ]),
-  platform: new Set([
-    "android", "apple", "chrome", "chromeos", "desktop", "embedded", "ios",
-    "linux", "macos", "ubuntu", "web", "windows",
-  ]),
-};
 const availableIcons = available?.map(slugify);
 const hasAsset =
   category === "brand" ||
-  (availableIcons
-    ? availableIcons.includes(resolved)
-    : bundledIcons[category].has(resolved));
+  availableIcons === undefined ||
+  availableIcons.includes(resolved);
 const effectiveMode: IconMode = resolved === "apple" ? "auto" : mode;
 const platformStackIcons = new Set(["docker"]);
 const textOnlyPlatforms = new Set(["self-host", "self-hosted"]);

package/src/components/IndexRow.astro

@@ -1,7 +1,7 @@
 ---
 import type { IndexRecord } from "@grove-dev/core";
 import Icon from "./Icon.astro";
-import { formatRelative, formatStars, getOwnerAndRepoFromRepoUrl, getOwnerAvatarUrl, statusDisplay } from "@grove-dev/astro";
+import { formatRelative, formatStars, getOwnerAndRepoFromRepoUrl, getOwnerAvatarUrl, projectStackIds, statusDisplay } from "@grove-dev/astro";
 
 interface Props {
   record: IndexRecord;
@@ -23,7 +23,7 @@ const repoHref = project?.repoUrl ?? item.links.github;
 const { owner, repo } = getOwnerAndRepoFromRepoUrl(repoHref ?? "");
 const avatar = project ? project.logoUrl ?? getOwnerAvatarUrl(owner, 80) : undefined;
 const initials = name.split(/\s+/).map((word) => word[0]).filter(Boolean).slice(0, 2).join("").toUpperCase();
-const stacks = project ? [project.stack, ...project.stacks].filter(Boolean) : [];
+const stacks = projectStackIds(project);
 const platforms = project?.platforms ?? [];
 const stars = project?.github?.stars;
 const updatedAt = project?.github?.pushedAt ?? (item.kind === "resource" ? item.publishedAt : null);
@@ -69,9 +69,9 @@ const curated = Boolean(item.curation?.reviewed || (project && (project.bestFor.
   <p class="m-0 line-clamp-2 text-[0.8125rem] leading-relaxed text-ink-600 dark:text-ink-300">{item.description}</p>
 
   <dl class="grid grid-cols-3 gap-x-3 text-2xs">
-    <div class="flex items-baseline gap-1.5"><dt class="font-medium uppercase tracking-wider text-ink-500">Stars</dt><dd class="font-mono text-ink-700 dark:text-ink-300">{formatStars(stars) ?? "—"}</dd></div>
-    <div class="flex items-baseline gap-1.5"><dt class="font-medium uppercase tracking-wider text-ink-500">Updated</dt><dd class="font-mono text-ink-700 dark:text-ink-300">{formatRelative(updatedAt)}</dd></div>
-    <div class="flex items-baseline gap-1.5"><dt class="font-medium uppercase tracking-wider text-ink-500">License</dt><dd class="font-mono text-ink-700 dark:text-ink-300">{license ?? "—"}</dd></div>
+    <div class="flex items-baseline gap-1.5"><dt class="font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">Stars</dt><dd class="font-mono text-ink-700 dark:text-ink-300">{formatStars(stars) ?? "—"}</dd></div>
+    <div class="flex items-baseline gap-1.5"><dt class="font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">Updated</dt><dd class="font-mono text-ink-700 dark:text-ink-300">{formatRelative(updatedAt)}</dd></div>
+    <div class="flex items-baseline gap-1.5"><dt class="font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">License</dt><dd class="font-mono text-ink-700 dark:text-ink-300">{license ?? "—"}</dd></div>
   </dl>
 
   {showChips && (platforms.length > 0 || stacks.length > 0) && (