@grove-dev/astro 0.5.0-next.2 → 0.5.0

package/dist/index.js

@@ -5,7 +5,7 @@
  *  - `default` export: an Astro integration that wires the
  *    `@grove-dev/astro/components/*` and `@grove-dev/astro/layouts/*`
  *    subpath imports into Vite so consumer projects can write:
- *        import ItemCard from "@grove-dev/astro/components/ItemCard.astro";
+ *        import ProjectCard from "@grove-dev/astro/components/ProjectCard.astro";
  *    and have Vite resolve the source `.astro` file (the package's
  *    `dist/` only contains TypeScript helpers, not the components
  *    themselves).
@@ -54,7 +54,7 @@ export default function groveAstro() {
             "astro:config:setup": async ({ config, updateConfig, injectScript }) => {
                 // Alias the components/layouts source directories so
                 // consumer builds can import from
-                //   @grove-dev/astro/components/ItemCard.astro
+                //   @grove-dev/astro/components/ProjectCard.astro
                 // without us shipping a glob-shaped `exports` map that
                 // Vite/Rollup does not expand reliably.
                 const consumerRoot = fileURLToPath(config.root);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/index.d.ts

@@ -8,7 +8,6 @@
  *   - format counts, dates, stars (`lib/format`)
  *   - apply curated lenses / facets / search filters (`lib/lenses`,
  *     `lib/search`)
- *   - render score bars (`lib/scores`)
  *   - compute taxonomy counts at build time (`lib/taxonomy-counts`)
  *   - pretty-print slugs and label/lens/sort/status ids (`lib/display`)
  *
@@ -20,7 +19,6 @@ export * from "./repo.js";
 export * from "./format.js";
 export * from "./lenses.js";
 export * from "./search.js";
-export * from "./scores.js";
 export * from "./taxonomy-counts.js";
 export * from "./display.js";
 export * from "./load-collections.js";

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;AAC7B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,WAAW,CAAC;AAC1B,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

@@ -8,7 +8,6 @@
  *   - format counts, dates, stars (`lib/format`)
  *   - apply curated lenses / facets / search filters (`lib/lenses`,
  *     `lib/search`)
- *   - render score bars (`lib/scores`)
  *   - compute taxonomy counts at build time (`lib/taxonomy-counts`)
  *   - pretty-print slugs and label/lens/sort/status ids (`lib/display`)
  *
@@ -20,7 +19,6 @@ export * from "./repo.js";
 export * from "./format.js";
 export * from "./lenses.js";
 export * from "./search.js";
-export * from "./scores.js";
 export * from "./taxonomy-counts.js";
 export * from "./display.js";
 export * from "./load-collections.js";

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;AAC7B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,WAAW,CAAC;AAC1B,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/ui/button.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Button / chip class builders — the single source for interactive
+ * control styling.
+ *
+ * Plain TS (not an .astro component) on purpose: `DirectoryIndexClient`
+ * rebuilds pagination links and active-filter chips in CLIENT-side JS,
+ * and those class strings must stay byte-identical with the server
+ * render. Both sides import these builders, so they cannot drift.
+ *
+ * Variant semantics (see styles.css):
+ * - `primary`   — the brand action (config `theme.primaryColor`).
+ * - `secondary` — default chrome buttons.
+ * - `outline` / `ghost` — quieter chrome.
+ * - `selected`  — "you are here" state (active filter, current lens,
+ *   current page). Neutral inversion via the `selected` tokens —
+ *   deliberately NOT the brand primary, so green never doubles as a
+ *   selection indicator.
+ */
+export type ButtonVariant = "primary" | "secondary" | "outline" | "ghost" | "selected";
+/** `bare` emits no size classes — pass custom geometry via `extra`. */
+export type ButtonSize = "sm" | "md" | "lg" | "bare";
+export declare function buttonClass(variant?: ButtonVariant, size?: ButtonSize, extra?: string): string;
+/**
+ * Layout extras for pagination controls — shared by `Pagination.astro`
+ * and the client-side pagination rebuild in `DirectoryIndexClient`.
+ */
+export declare const PAGINATION_EXTRA = "min-w-9 px-2 py-1.5 text-2xs";
+/**
+ * Facet filter trigger (the "Stack: Any" dropdown buttons). Includes
+ * the `grove-filter-trigger` hook class because the client script
+ * reassigns the whole className when the active state changes — the
+ * hook must survive that reassignment.
+ */
+export declare function filterTriggerClass(active: boolean): string;
+/**
+ * Lens tab (the All / Hot / Mature row). Same geometry as the filter
+ * trigger; `data-lens-id` targeting keeps its own hook attribute.
+ */
+export declare function lensTabClass(active: boolean): string;
+/**
+ * Active-filter chip (the removable "Stack: Python ×" pills). One
+ * definition for the server render and the client rebuild.
+ */
+export declare function chipClass(extra?: string): string;
+//# sourceMappingURL=button.d.ts.map

package/dist/ui/button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../src/ui/button.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AACvF,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAwBrD,wBAAgB,WAAW,CACzB,OAAO,GAAE,aAA2B,EACpC,IAAI,GAAE,UAAiB,EACvB,KAAK,SAAK,GACT,MAAM,CAER;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,iCAAiC,CAAC;AAE/D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAO1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAMpD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,SAAK,GAAG,MAAM,CAO5C"}

package/dist/ui/button.js

@@ -0,0 +1,82 @@
+/**
+ * Button / chip class builders — the single source for interactive
+ * control styling.
+ *
+ * Plain TS (not an .astro component) on purpose: `DirectoryIndexClient`
+ * rebuilds pagination links and active-filter chips in CLIENT-side JS,
+ * and those class strings must stay byte-identical with the server
+ * render. Both sides import these builders, so they cannot drift.
+ *
+ * Variant semantics (see styles.css):
+ * - `primary`   — the brand action (config `theme.primaryColor`).
+ * - `secondary` — default chrome buttons.
+ * - `outline` / `ghost` — quieter chrome.
+ * - `selected`  — "you are here" state (active filter, current lens,
+ *   current page). Neutral inversion via the `selected` tokens —
+ *   deliberately NOT the brand primary, so green never doubles as a
+ *   selection indicator.
+ */
+const BASE = "inline-flex cursor-pointer items-center justify-center gap-1.5 rounded-[var(--radius)] border border-transparent font-medium leading-none no-underline outline-none transition-colors focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/35";
+/**
+ * `md`/`lg` guarantee a ≥44px hit target on small viewports
+ * (`max-sm:min-h-11`) while keeping the compact desktop height.
+ */
+const SIZES = {
+    sm: "h-8 px-3 text-sm",
+    md: "h-9 px-3 text-sm max-sm:min-h-11",
+    lg: "h-11 px-4 text-sm",
+    bare: "",
+};
+const VARIANTS = {
+    primary: "bg-primary text-primary-foreground hover:bg-primary/90",
+    secondary: "border-border bg-secondary text-foreground hover:bg-accent",
+    outline: "border-border bg-transparent text-foreground hover:bg-accent",
+    ghost: "text-foreground hover:bg-accent",
+    selected: "bg-selected text-selected-foreground hover:bg-selected/90",
+};
+export function buttonClass(variant = "secondary", size = "sm", extra = "") {
+    return [BASE, SIZES[size], VARIANTS[variant], extra].filter(Boolean).join(" ");
+}
+/**
+ * Layout extras for pagination controls — shared by `Pagination.astro`
+ * and the client-side pagination rebuild in `DirectoryIndexClient`.
+ */
+export const PAGINATION_EXTRA = "min-w-9 px-2 py-1.5 text-2xs";
+/**
+ * Facet filter trigger (the "Stack: Any" dropdown buttons). Includes
+ * the `grove-filter-trigger` hook class because the client script
+ * reassigns the whole className when the active state changes — the
+ * hook must survive that reassignment.
+ */
+export function filterTriggerClass(active) {
+    return [
+        "grove-filter-trigger",
+        BASE,
+        "h-9 px-3 text-[0.8125rem] max-sm:min-h-11",
+        active ? `${VARIANTS.selected} hover:text-selected-foreground` : VARIANTS.secondary,
+    ].join(" ");
+}
+/**
+ * Lens tab (the All / Hot / Mature row). Same geometry as the filter
+ * trigger; `data-lens-id` targeting keeps its own hook attribute.
+ */
+export function lensTabClass(active) {
+    return [
+        BASE,
+        "h-9 px-3 text-[0.8125rem] max-sm:min-h-11",
+        active ? `${VARIANTS.selected} hover:text-selected-foreground` : VARIANTS.secondary,
+    ].join(" ");
+}
+/**
+ * Active-filter chip (the removable "Stack: Python ×" pills). One
+ * definition for the server render and the client rebuild.
+ */
+export function chipClass(extra = "") {
+    return [
+        "inline-flex min-h-5 items-center justify-center gap-1 rounded-full border border-transparent bg-secondary px-2 py-0.5 align-middle text-xs font-medium leading-none text-secondary-foreground transition-colors hover:border-ink-400",
+        extra,
+    ]
+        .filter(Boolean)
+        .join(" ");
+}
+//# sourceMappingURL=button.js.map

package/dist/ui/button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.js","sourceRoot":"","sources":["../../src/ui/button.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,MAAM,IAAI,GACR,iQAAiQ,CAAC;AAEpQ;;;GAGG;AACH,MAAM,KAAK,GAA+B;IACxC,EAAE,EAAE,kBAAkB;IACtB,EAAE,EAAE,kCAAkC;IACtC,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,EAAE;CACT,CAAC;AAEF,MAAM,QAAQ,GAAkC;IAC9C,OAAO,EAAE,wDAAwD;IACjE,SAAS,EAAE,4DAA4D;IACvE,OAAO,EAAE,8DAA8D;IACvE,KAAK,EAAE,iCAAiC;IACxC,QAAQ,EAAE,2DAA2D;CACtE,CAAC;AAEF,MAAM,UAAU,WAAW,CACzB,UAAyB,WAAW,EACpC,OAAmB,IAAI,EACvB,KAAK,GAAG,EAAE;IAEV,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAe;IAChD,OAAO;QACL,sBAAsB;QACtB,IAAI;QACJ,2CAA2C;QAC3C,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,iCAAiC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS;KACpF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,OAAO;QACL,IAAI;QACJ,2CAA2C;QAC3C,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,iCAAiC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS;KACpF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAK,GAAG,EAAE;IAClC,OAAO;QACL,sOAAsO;QACtO,KAAK;KACN;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grove-dev/astro",
-  "version": "0.5.0-next.2",
+  "version": "0.5.0",
   "type": "module",
   "description": "Composable Astro UI, data adapters, and integration for Grove directories.",
   "license": "MIT",
@@ -46,9 +46,12 @@
     "./styles.css": "./src/styles.css",
     "./components/*.astro": "./src/components/*.astro",
     "./components/*": "./src/components/*.astro",
+    "./server": "./src/server/index.ts",
+    "./server/*": "./dist/server/*.js",
+    "./ui/*.astro": "./src/ui/*.astro",
+    "./ui/*": "./src/ui/*.ts",
     "./layouts/*.astro": "./src/layouts/*.astro",
-    "./layouts/*": "./src/layouts/*.astro",
-    "./server": "./src/server/index.ts"
+    "./layouts/*": "./src/layouts/*.astro"
   },
   "dependencies": {
     "astro": "^7.1.3",
@@ -56,7 +59,7 @@
     "sanitize-html": "^2.17.5",
     "shiki": "^1.29.2",
     "yaml": "^2.9.0",
-    "@grove-dev/core": "0.5.0-next.2"
+    "@grove-dev/core": "0.5.0"
   },
   "peerDependencies": {
     "astro": "^6.0.0 || ^7.0.0"
@@ -67,6 +70,6 @@
   "scripts": {
     "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
     "check": "tsc -p tsconfig.json --noEmit",
-    "test": "echo \"No astro package tests yet\""
+    "test": "vitest run"
   }
 }

package/src/components/CardGrid.astro

@@ -0,0 +1,41 @@
+---
+/**
+ * CardGrid — the one responsive grid host for card-shaped children.
+ *
+ * Owns the three-column layout every listing surface shares (home
+ * record sections, browse results, collection entries, taxonomy
+ * terms) so pages never re-declare grid classes. Cards are passed
+ * through the default slot, which keeps the grid card-agnostic: any
+ * component that follows the sizing contract (`h-full flex flex-col`
+ * root, package radius/padding tokens) drops in — including new card
+ * types added by consumers.
+ *
+ * Children may be bare cards or `<li>` wrappers; bare children are
+ * valid because the grid renders `role="list"` semantics regardless
+ * (Safari drops list semantics on `list-none` either way).
+ *
+ * `empty` swaps the grid for the `empty` slot so pages keep their
+ * empty-state markup next to the list they describe.
+ */
+interface Props {
+  /** id forwarded to the `<ul>` (client scripts key off it). */
+  id?: string;
+  /** Render the `empty` slot instead of the grid. */
+  empty?: boolean;
+  class?: string;
+}
+
+const { id, empty = false, class: className = "" } = Astro.props;
+---
+
+{empty ? (
+  <slot name="empty" />
+) : (
+  <ul
+    id={id}
+    role="list"
+    class={`m-0 grid list-none grid-cols-1 items-stretch gap-5 p-0 sm:grid-cols-2 lg:grid-cols-3 ${className}`}
+  >
+    <slot />
+  </ul>
+)}

package/src/components/CardIcon.astro

@@ -0,0 +1,67 @@
+---
+/**
+ * CardIcon — the small metadata glyphs shared by every card component
+ * (star, clock, curated check, navigation arrow, external link).
+ *
+ * Extracted so a visual tweak (size, stroke, path) is one edit instead
+ * of a copy-paste hunt across ProjectCard/IndexRow/CollectionRow.
+ * Color comes from `currentColor`; wrap in a colored span (e.g.
+ * `text-amber-500` for the star) to tint.
+ */
+interface Props {
+  name: "star" | "clock" | "curated" | "arrow" | "external";
+  /** Square size in px. Defaults per-glyph to match card typography. */
+  size?: number;
+  class?: string;
+}
+
+const { name, size, class: className = "" } = Astro.props;
+
+const defaults: Record<Props["name"], number> = {
+  star: 13,
+  clock: 11,
+  curated: 10,
+  arrow: 16,
+  external: 10,
+};
+const px = size ?? defaults[name];
+---
+
+{name === "star" && (
+  <svg viewBox="0 0 16 16" width={px} height={px} aria-hidden="true" fill="currentColor" class={className}>
+    <path d="M8 .25a.75.75 0 0 1 .673.418l1.882 3.815 4.21.612a.75.75 0 0 1 .416 1.279l-3.046 2.97.719 4.192a.751.751 0 0 1-1.088.791L8 12.347l-3.766 1.98a.75.75 0 0 1-1.088-.79l.72-4.194L.818 6.374a.75.75 0 0 1 .416-1.28l4.21-.611L7.327.668A.75.75 0 0 1 8 .25Z" />
+  </svg>
+)}
+{name === "clock" && (
+  <svg viewBox="0 0 16 16" width={px} height={px} aria-hidden="true" fill="currentColor" class={className}>
+    <path d="M8 2a6 6 0 1 0 0 12A6 6 0 0 0 8 2Zm0 1.5a4.5 4.5 0 1 1 0 9 4.5 4.5 0 0 1 0-9Zm-.5 1.5a.5.5 0 0 0-1 0v3.25c0 .15.07.29.18.39l1.95 1.65a.5.5 0 0 0 .66-.76L7.5 7.55V5Z" />
+  </svg>
+)}
+{name === "curated" && (
+  <svg viewBox="0 0 16 16" width={px} height={px} aria-hidden="true" fill="currentColor" class={className}>
+    <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>
+)}
+{name === "arrow" && (
+  <svg
+    viewBox="0 0 24 24"
+    width={px}
+    height={px}
+    fill="none"
+    stroke="currentColor"
+    stroke-width="2"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    aria-hidden="true"
+    class={className}
+  >
+    <path d="M5 12h14"></path>
+    <path d="m12 5 7 7-7 7"></path>
+  </svg>
+)}
+{name === "external" && (
+  <svg viewBox="0 0 16 16" width={px} height={px} aria-hidden="true" fill="currentColor" class={className}>
+    <path d="M3.75 2A1.75 1.75 0 0 0 2 3.75v8.5C2 13.216 2.784 14 3.75 14h8.5A1.75 1.75 0 0 0 14 12.25v-3.5a.75.75 0 0 0-1.5 0v3.5a.25.25 0 0 1-.25.25h-8.5a.25.25 0 0 1-.25-.25v-8.5a.25.25 0 0 1 .25-.25h3.5a.75.75 0 0 0 0-1.5h-3.5Z" />
+    <path d="M10 0a.75.75 0 0 0-.75.75v.75h-3a.75.75 0 0 0 0 1.5h3v.75A.75.75 0 0 0 10.75 4.5h2.5A.75.75 0 0 0 14 3.75v-2.5A.75.75 0 0 0 13.25.5H10Z" />
+  </svg>
+)}

package/src/components/CategoryGrid.astro

@@ -1,4 +1,5 @@
 ---
+import { formatCount } from "@grove-dev/core";
 /**
  * CategoryGrid — browse-by-category grid for the home page.
  *
@@ -23,6 +24,12 @@ interface Props {
   /** Hide the section header. */
   bare?: boolean;
   itemLabelPlural?: string;
+  /** Noun pair for count chips — singular fixes "1 projects". */
+  itemNoun?: { singular: string; plural: string };
+  /** Pass 1 when this grid IS the page (`/categories` index). */
+  headingLevel?: 1 | 2;
+  /** Card link builder (defaults to browse filtered by category). */
+  hrefFor?: (slug: string) => string;
 }
 
 const {
@@ -31,9 +38,15 @@ const {
   class: className = "",
   bare = false,
   itemLabelPlural = "items",
+  itemNoun = { singular: "item", plural: "items" },
+  headingLevel = 2,
+  hrefFor,
 } = Astro.props;
 
+const Heading = `h${headingLevel}` as "h1" | "h2";
+
 function buildHref(slug: string): string {
+  if (hrefFor) return hrefFor(slug);
   const base = pathPrefix.replace(/\/$/, "");
   return `${base}?category=${encodeURIComponent(slug)}`;
 }
@@ -50,12 +63,12 @@ function buildHref(slug: string): string {
         <span class="text-2xs font-medium uppercase tracking-wider text-ink-500 dark:text-ink-400">
           Categories
         </span>
-        <h2
+        <Heading
           id="grove-categorygrid-heading"
           class="m-0 mt-1 text-[1.5rem] sm:text-[1.625rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100"
         >
           Browse by category
-        </h2>
+        </Heading>
         <p class="m-0 max-w-[60ch] text-[0.9375rem] text-ink-500 dark:text-ink-400">
           Find {itemLabelPlural} by what they do, not by which stack they use.
         </p>
@@ -72,12 +85,14 @@ function buildHref(slug: string): string {
             >
               <div class="flex min-w-0 flex-1 flex-col gap-0.5">
                 <div class="flex items-center gap-2">
-                  <h3 class="m-0 text-[0.9375rem] font-semibold tracking-tight text-ink-900 group-hover:underline dark:text-ink-100">
+                  {/* Not a heading — see StackGrid: link tiles under a
+                      page h1 must not introduce h3 skips. */}
+                  <span class="m-0 text-[0.9375rem] font-semibold tracking-tight text-ink-900 group-hover:underline dark:text-ink-100">
                     {c.name}
-                  </h3>
+                  </span>
                   {typeof c.count === "number" && (
                     <span class="inline-flex items-center rounded-md border border-ink-200 bg-ink-50 px-1.5 py-0.5 font-mono text-[10px] font-medium text-ink-600 dark:border-ink-800 dark:bg-ink-900/60 dark:text-ink-400">
-                      {c.count} {itemLabelPlural}
+                      {formatCount(c.count, itemNoun)}
                     </span>
                   )}
                 </div>

package/src/components/CollectionCard.astro

@@ -0,0 +1,56 @@
+---
+/**
+ * CollectionCard — card for one collection (not a record): kind
+ * eyebrow, title, description, entry count.
+ *
+ * Extracted from `CollectionIndex` so the collection tile shares the
+ * `ProjectCard` visual language (border, radius, hover lift, tokens)
+ * and stays in sync with the record cards as the design evolves.
+ * Follows the `CardGrid` sizing contract (`h-full flex flex-col`).
+ */
+import { formatCount } from "@grove-dev/core";
+
+interface Props {
+  collection: {
+    slug: string;
+    url: string;
+    kind: string;
+    title: string;
+    description?: string;
+    count: number;
+  };
+  /** Analytics source emitted with `collection_card_click`. */
+  eventSource?: string;
+  /** Noun pair for the entry count (blueprint labels). */
+  countNoun?: { singular: string; plural: string };
+  class?: string;
+}
+
+const {
+  collection: c,
+  eventSource = "collection_index",
+  countNoun = { singular: "item", plural: "items" },
+  class: className = "",
+} = Astro.props;
+---
+
+<a
+  href={c.url}
+  data-event="collection_card_click"
+  data-event-source={eventSource}
+  data-event-item={c.slug}
+  class={`group relative flex h-full min-w-0 flex-col gap-2 rounded-xl border border-ink-200 bg-card p-5 no-underline outline-none transition-[border-color,background-color,transform] duration-150 hover:-translate-y-0.5 hover:border-ink-300 hover:bg-ink-50 focus-visible:border-ink-500 focus-visible:ring-2 focus-visible:ring-ink-900/15 dark:border-ink-800 dark:hover:border-ink-700 dark:hover:bg-ink-900 dark:focus-visible:border-ink-500 dark:focus-visible:ring-ink-100/15 ${className}`}
+>
+  <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="line-clamp-2 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 transition-colors group-hover:text-ink-900 dark:text-ink-400 dark:group-hover:text-ink-100">
+    {formatCount(c.count, countNoun)} →
+  </span>
+</a>

package/src/components/CollectionIndex.astro

@@ -16,8 +16,11 @@
  *  - `<slot name="header-actions">` — custom buttons in header
  *  - `class` — extra class on the outer <section>
  */
+import CardGrid from "./CardGrid.astro";
+import CollectionCard from "./CollectionCard.astro";
 import Container from "../layouts/Container.astro";
 import SectionHeader from "../layouts/SectionHeader.astro";
+import EmptyState from "../ui/EmptyState.astro";
 import type { CollectionIndexModel } from "../server/collections.js";
 
 interface Props {
@@ -32,6 +35,14 @@ interface Props {
   emptyLabel?: string;
   /** Cap the number of cards rendered. Omit for "all". */
   limit?: number;
+  /**
+   * Heading level for the section title. Pass 1 when this component
+   * renders the page's title (the `/collections` index); the default
+   * 2 fits embedded use (homepage teaser).
+   */
+  headingLevel?: 1 | 2;
+  /** Noun pair for the per-card entry counts (blueprint labels). */
+  countNoun?: { singular: string; plural: string };
   class?: string;
 }
 
@@ -45,6 +56,8 @@ const {
   viewAllLabel = "View all",
   emptyLabel = "No collections yet.",
   limit,
+  headingLevel = 2,
+  countNoun,
   class: className = "",
 } = Astro.props;
 
@@ -55,7 +68,7 @@ const headerActions = Astro.slots.has("header-actions");
 <section id={id} class={`py-12 sm:py-16 ${className}`}>
   <Container>
     <div class="mb-6 flex flex-wrap items-end justify-between gap-3">
-      <SectionHeader eyebrow={eyebrow} title={title} description={description} />
+      <SectionHeader eyebrow={eyebrow} title={title} description={description} level={headingLevel} />
       {(viewAllHref || headerActions) && (
         <div class="flex shrink-0 items-center gap-2 pb-2">
           {viewAllHref && (
@@ -72,36 +85,18 @@ const headerActions = Astro.slots.has("header-actions");
     </div>
 
     {cards.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">
-        {emptyLabel}
-      </p>
+      <EmptyState
+        title={emptyLabel}
+        description="Collections are defined in data/collections/*.yml — add a file there and it appears here on the next build."
+      />
     ) : (
-      <ul class="m-0 grid list-none grid-cols-1 gap-3 p-0 sm:grid-cols-2 lg:grid-cols-3">
+      <CardGrid>
         {cards.map((c) => (
           <li class="m-0 p-0">
-            <a
-              href={c.url}
-              data-event="collection_card_click"
-              data-event-source="collection_index"
-              data-event-item={c.slug}
-              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>
+            <CollectionCard collection={c} countNoun={countNoun} />
           </li>
         ))}
-      </ul>
+      </CardGrid>
     )}
   </Container>
 </section>