@grove-dev/astro 0.5.4 → 0.6.0

package/src/server/seo.test.ts

@@ -0,0 +1,123 @@
+import { describe, expect, it } from "vitest";
+import {
+  absoluteUrl,
+  breadcrumbs,
+  ogPath,
+  recordSeoDescriptor,
+  seoDescription,
+  seoTitle,
+  titleCaseFirst,
+} from "./seo.js";
+
+describe("seoTitle", () => {
+  it("appends the site name with the pipe separator", () => {
+    expect(seoTitle("Collections", "Open Apps")).toBe("Collections | Open Apps");
+  });
+
+  it("skips the suffix when the main part already names the site", () => {
+    expect(seoTitle("Python projects on Open Apps", "Open Apps")).toBe(
+      "Python projects on Open Apps",
+    );
+  });
+
+  it("skips the suffix instead of exceeding the display cap", () => {
+    const long = "A very long record name — with an equally long descriptor attached";
+    expect(seoTitle(long, "Open Apps")).toBe(long);
+  });
+
+  it("falls back to the site name for an empty main part", () => {
+    expect(seoTitle("  ", "Open Apps")).toBe("Open Apps");
+  });
+
+  it("returns the main part unchanged when no site name is given", () => {
+    expect(seoTitle("Collections", "")).toBe("Collections");
+  });
+});
+
+describe("seoDescription", () => {
+  it("prefers the raw text and collapses whitespace", () => {
+    expect(seoDescription("A  spaced\n\ntext.", "fallback")).toBe("A spaced text.");
+  });
+
+  it("uses the fallback when raw is empty", () => {
+    expect(seoDescription(undefined, "The fallback.")).toBe("The fallback.");
+    expect(seoDescription("   ", "The fallback.")).toBe("The fallback.");
+  });
+
+  it("truncates on a word boundary near 160 chars with an ellipsis", () => {
+    const long = "word ".repeat(60).trim();
+    const out = seoDescription(long, "");
+    expect(out.length).toBeLessThanOrEqual(160);
+    expect(out.endsWith("…")).toBe(true);
+    expect(out).not.toMatch(/\swor…$/);
+  });
+});
+
+describe("recordSeoDescriptor", () => {
+  it("uses the summary's first clause when short enough", () => {
+    expect(
+      recordSeoDescriptor({
+        summary: "Self-hosted photo backup. Works offline and syncs later.",
+        singular: "app",
+      }),
+    ).toBe("Self-hosted photo backup");
+  });
+
+  it("falls back to the category phrase when the summary is too long", () => {
+    expect(
+      recordSeoDescriptor({
+        summary:
+          "A very long first clause that keeps going and going far past the cap",
+        categoryLabel: "Photos",
+        singular: "app",
+      }),
+    ).toBe("Open-source Photos app");
+  });
+
+  it("omits the category when it is missing or uncategorized", () => {
+    expect(recordSeoDescriptor({ singular: "project" })).toBe("Open-source project");
+    expect(
+      recordSeoDescriptor({ categoryLabel: "Uncategorized", singular: "project" }),
+    ).toBe("Open-source project");
+  });
+});
+
+describe("titleCaseFirst", () => {
+  it("capitalizes only the first character", () => {
+    expect(titleCaseFirst("projects")).toBe("Projects");
+    expect(titleCaseFirst("")).toBe("");
+  });
+});
+
+describe("ogPath", () => {
+  it("falls back to the static SVG when no generated image exists", () => {
+    // Point at a directory with no public/og at all.
+    expect(ogPath("record", "nothing-here", "/nonexistent-cwd")).toBe("/og-image.svg");
+    expect(ogPath("home", undefined, "/nonexistent-cwd")).toBe("/og-image.svg");
+  });
+});
+
+describe("absoluteUrl", () => {
+  it("joins trailing-slash-safely", () => {
+    expect(absoluteUrl("https://a.com/", "/x/")).toBe("https://a.com/x/");
+    expect(absoluteUrl("https://a.com", "x/")).toBe("https://a.com/x/");
+  });
+});
+
+describe("breadcrumbs", () => {
+  it("builds an absolute BreadcrumbList with trailing slashes", () => {
+    const node = breadcrumbs("https://a.com", [
+      { path: "", name: "Home" },
+      { path: "categories", name: "Categories" },
+      { path: "categories/photos/", name: "Photos" },
+    ]);
+    expect(node["@type"]).toBe("BreadcrumbList");
+    const items = node.itemListElement as Array<{ position: number; name: string; item: string }>;
+    expect(items.map((i) => i.item)).toEqual([
+      "https://a.com/",
+      "https://a.com/categories/",
+      "https://a.com/categories/photos/",
+    ]);
+    expect(items[2]).toMatchObject({ position: 3, name: "Photos" });
+  });
+});

package/src/server/seo.ts

@@ -0,0 +1,141 @@
+/**
+ * SEO primitives — the ONE place page titles, meta descriptions, OG
+ * image paths, and breadcrumb JSON-LD are shaped.
+ *
+ * Every page model funnels through `seoTitle` / `seoDescription`, so
+ * the separator (` | ` before the site name, ` — ` inside the main
+ * part), the length caps, and the truncation rules can never drift
+ * between pages. The pure helpers take every input as an argument —
+ * no generated-data imports — so they are unit-testable in isolation.
+ */
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { breadcrumbSchema, type JsonLdNode } from "@grove-dev/core";
+
+/** Everything a page passes to BaseLayout for its `<head>`. */
+export interface PageSeo {
+  title: string;
+  description: string;
+  /** Root-relative OG image (e.g. "/og/records/langchain.png"). */
+  image?: string;
+  imageAlt?: string;
+  jsonLd?: Record<string, unknown>[];
+  noindex?: boolean;
+}
+
+/** Google truncates titles around 60 chars; suffixing past ~65 only
+ *  buys an ellipsis, so the suffix is skipped instead of clipped. */
+const TITLE_SUFFIX_MAX = 65;
+/** Meta descriptions display up to ~160 chars in search results. */
+const DESCRIPTION_MAX = 160;
+
+/**
+ * Compose `<main> | <siteName>`. The suffix is dropped when the main
+ * part already names the site (taxonomy titles end "... on {Site}")
+ * or when appending it would push the title past the display cap —
+ * a truncated site name is worse than none.
+ */
+export function seoTitle(main: string, siteName: string): string {
+  const cleaned = main.trim();
+  if (!cleaned) return siteName;
+  if (!siteName || cleaned.includes(siteName)) return cleaned;
+  const suffixed = `${cleaned} | ${siteName}`;
+  return suffixed.length <= TITLE_SUFFIX_MAX ? suffixed : cleaned;
+}
+
+/**
+ * Normalize a meta description: prefer `raw`, fall back, collapse
+ * whitespace, and truncate on a word boundary near 160 chars.
+ */
+export function seoDescription(raw: string | undefined, fallback: string): string {
+  const source = (raw ?? "").replace(/\s+/g, " ").trim() || fallback.replace(/\s+/g, " ").trim();
+  if (source.length <= DESCRIPTION_MAX) return source;
+  const cut = source.slice(0, DESCRIPTION_MAX - 1);
+  const lastSpace = cut.lastIndexOf(" ");
+  return `${(lastSpace > 80 ? cut.slice(0, lastSpace) : cut).replace(/[,;:\s]+$/, "")}…`;
+}
+
+/** Capitalize the first character (for titles like "Browse Projects"). */
+export function titleCaseFirst(value: string): string {
+  return value ? value.charAt(0).toUpperCase() + value.slice(1) : value;
+}
+
+/**
+ * Short record descriptor for `<Name> — <descriptor> | <Site>` titles.
+ * Prefers the curator-written summary's first clause when it is short
+ * enough to fit a title; otherwise falls back to a generated
+ * "Open-source <category> <singular>" phrase.
+ */
+export function recordSeoDescriptor(input: {
+  summary?: string;
+  categoryLabel?: string;
+  singular: string;
+}): string {
+  const clause = (input.summary ?? "")
+    .split(/[.!?\n]|\s[—–]\s/)[0]
+    ?.replace(/\s+/g, " ")
+    .trim();
+  if (clause && clause.length > 0 && clause.length <= 45) return clause;
+  const category = input.categoryLabel?.trim();
+  return category && category.toLowerCase() !== "uncategorized"
+    ? `Open-source ${category} ${input.singular}`
+    : `Open-source ${input.singular}`;
+}
+
+export type OgKind =
+  | "home"
+  | "default"
+  | "record"
+  | "collection"
+  | "category"
+  | "stack"
+  | "license";
+
+const OG_DIR: Record<OgKind, string> = {
+  home: "home.png",
+  default: "default.png",
+  record: "records",
+  collection: "collections",
+  category: "categories",
+  stack: "stacks",
+  license: "licenses",
+};
+
+/**
+ * Resolve the OG image URL for a page. Returns the generated
+ * `/og/...png` when the build pipeline produced it, otherwise the
+ * site-wide `/og-image.svg` — so a failed or skipped OG build
+ * degrades to the static default instead of a 404.
+ */
+export function ogPath(kind: OgKind, slug?: string, cwd = process.cwd()): string {
+  const rel =
+    kind === "home" || kind === "default"
+      ? `og/${OG_DIR[kind]}`
+      : slug
+        ? `og/${OG_DIR[kind]}/${slug}.png`
+        : "og/default.png";
+  if (existsSync(resolve(cwd, "public", rel))) return `/${rel}`;
+  // Per-page image missing — try the generated default before the SVG.
+  if (rel !== "og/default.png" && existsSync(resolve(cwd, "public", "og/default.png"))) {
+    return "/og/default.png";
+  }
+  return "/og-image.svg";
+}
+
+/** Join a site-relative path onto the site URL (trailing-slash safe). */
+export function absoluteUrl(siteUrl: string, path: string): string {
+  return `${siteUrl.replace(/\/$/, "")}/${path.replace(/^\//, "")}`;
+}
+
+/**
+ * BreadcrumbList JSON-LD from site-relative paths. Wraps core's
+ * `breadcrumbSchema` so pages pass paths, not absolute URLs.
+ */
+export function breadcrumbs(
+  siteUrl: string,
+  crumbs: Array<{ path: string; name: string }>,
+): JsonLdNode {
+  return breadcrumbSchema(
+    crumbs.map((c) => ({ url: absoluteUrl(siteUrl, c.path.endsWith("/") || c.path === "" ? c.path : `${c.path}/`), name: c.name })),
+  );
+}

package/src/styles.css

@@ -148,8 +148,15 @@
    * grove.config.ts: BaseLayout emits `--grove-container` on <html>
    * and the token falls back to the package default when unset. */
   --container-container: var(--grove-container, 1160px);
-  --container-wide: 1400px;
-  --container-narrow: 720px;
+  /* `wide` is an opt-in escape hatch, not a second site width. It is
+     clamped to the configured container so a wide section can never
+     overhang the header, footer, and the rest of the page — every
+     shell and page template uses `max-w-container`. */
+  --container-wide: min(var(--grove-container, 1400px), 1400px);
+  /* `narrow` is the reading measure for prose pages (about, 404,
+     empty). Clamped for the same reason — a site narrower than 720px
+     should not have its prose pages spill past its own frame. */
+  --container-narrow: min(var(--grove-container, 720px), 720px);
 
   /* ── Border radius scale ──────────────────────────────────────────
    * Driven by `theme.radius` ("none" | "soft" | "round") the same
@@ -943,15 +950,25 @@
     display: block;
   }
 }
-.grove-toc-item { padding: 0; }
+/* Active item: text-color + a left-rail accent on the link's
+ * leading edge. A full pill background reads as a button, not a
+ * nav indicator, so it is reserved for hover; the rail stays put
+ * while the visitor moves between sections. */
+.grove-toc-item > .grove-toc-link {
+  position: relative;
+}
+.grove-toc-link {
+  border-left: 2px solid transparent;
+}
+.grove-toc-item--h3 > .grove-toc-link {
+  border-left-style: dashed;
+}
 .grove-toc-link[data-toc-active] {
-  background-color: var(--color-ink-100, #f0f0f0);
   color: var(--color-ink-900, #1a1a1a);
+  border-left-color: currentColor;
   font-weight: 600;
-  border-radius: 0.375rem;
 }
 .dark .grove-toc-link[data-toc-active] {
-  background-color: var(--color-ink-800, #2a2a2a);
   color: var(--color-ink-100, #f0f0f0);
 }
 

package/src/ui/FilterDrawer.astro

@@ -19,10 +19,17 @@ interface Props {
   label?: string;
   /** Count of active filters shown on the trigger. */
   activeCount?: number;
+  /** URL that clears every filter — offered inside the sheet. */
+  clearHref?: string;
   class?: string;
 }
 
-const { label = "Filters", activeCount = 0, class: className = "" } = Astro.props;
+const {
+  label = "Filters",
+  activeCount = 0,
+  clearHref,
+  class: className = "",
+} = Astro.props;
 ---
 
 <div class={`grove-filter-drawer ${className}`} data-grove-filter-drawer>
@@ -58,11 +65,24 @@ const { label = "Filters", activeCount = 0, class: className = "" } = Astro.prop
     class="m-0 mt-auto w-full max-w-none rounded-t-[calc(var(--radius)+0.5rem)] border-0 bg-surface-overlay p-0 text-foreground backdrop:bg-black/40 md:hidden"
     aria-label={label}
   >
-    <div class="flex items-center justify-between border-b border-border px-4 py-3">
+    <div class="flex items-center justify-between gap-3 border-b border-border px-4 py-3">
       <p class="m-0 text-sm font-semibold">{label}</p>
-      <button type="button" data-drawer-close class={buttonClass("ghost", "sm")}>
-        Done
-      </button>
+      <div class="flex items-center gap-2">
+        {clearHref && (
+          /* Clearing from inside the sheet is the only way out of a
+             stack of filters on mobile — the chips row is behind it. */
+          <a
+            href={clearHref}
+            data-drawer-clear
+            class:list={[buttonClass("ghost", "sm"), activeCount === 0 && "hidden"]}
+          >
+            Clear all
+          </a>
+        )}
+        <button type="button" data-drawer-close class={buttonClass("ghost", "sm")}>
+          Done
+        </button>
+      </div>
     </div>
     <div data-drawer-body class="max-h-[70vh] overflow-y-auto p-4"></div>
   </dialog>

package/src/ui/SearchField.astro

@@ -6,6 +6,11 @@
  * is display copy, not the accessible name. Pass the derived
  * placeholder from `getDirectoryIndexModel().searchPlaceholder` so it
  * only names ENABLED facets.
+ *
+ * `shortcut` renders the `/` hint and wires the global key handler.
+ * The hint is hidden once the field has focus — it is an invitation,
+ * not a persistent label — and on coarse pointers, where there is no
+ * key to press.
  */
 
 interface Props {
@@ -14,6 +19,8 @@ interface Props {
   id?: string;
   value?: string;
   placeholder?: string;
+  /** Show the `/` hint and focus this field when `/` is pressed. */
+  shortcut?: boolean;
   class?: string;
 }
 
@@ -23,11 +30,12 @@ const {
   id = "search-input",
   value = "",
   placeholder,
+  shortcut = false,
   class: className = "",
 } = Astro.props;
 ---
 
-<label class={`relative block ${className}`}>
+<label class={`grove-search relative block ${className}`}>
   <span class="sr-only">{label}</span>
   <svg
     viewBox="0 0 16 16"
@@ -45,6 +53,54 @@ const {
     name={name}
     value={value}
     placeholder={placeholder}
-    class="h-10 w-full rounded-md border border-input bg-background py-2 pl-9 pr-3 text-sm text-foreground placeholder:text-muted-foreground focus:border-ring focus:outline-none focus:ring-2 focus:ring-ring/20"
+    autocomplete="off"
+    data-search-input
+    class="peer h-10 w-full rounded-md border border-input bg-background py-2 pl-9 pr-10 text-sm text-foreground placeholder:text-muted-foreground focus:border-ring focus:outline-none focus:ring-2 focus:ring-ring/20 [&::-webkit-search-cancel-button]:appearance-none"
   />
+  {shortcut && (
+    <kbd
+      data-search-hint
+      aria-hidden="true"
+      class="pointer-events-none absolute right-2 top-1/2 hidden h-6 w-6 -translate-y-1/2 select-none items-center justify-center rounded-md border border-border bg-secondary font-mono text-[11px] leading-none text-muted-foreground peer-focus:!hidden peer-not-placeholder-shown:hidden sm:inline-flex"
+      >/</kbd
+    >
+  )}
+  <button
+    type="button"
+    data-search-clear
+    hidden={!value}
+    aria-label="Clear search"
+    class="absolute right-2 top-1/2 inline-flex h-6 w-6 -translate-y-1/2 cursor-pointer items-center justify-center rounded-full border-0 bg-transparent p-0 text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/35"
+  >
+    <svg viewBox="0 0 16 16" width="12" height="12" aria-hidden="true" fill="currentColor">
+      <path
+        d="M3.72 3.72a.75.75 0 0 1 1.06 0L8 6.94l3.22-3.22a.75.75 0 1 1 1.06 1.06L9.06 8l3.22 3.22a.75.75 0 1 1-1.06 1.06L8 9.06l-3.22 3.22a.75.75 0 0 1-1.06-1.06L6.94 8 3.72 4.78a.75.75 0 0 1 0-1.06Z"
+      />
+    </svg>
+  </button>
 </label>
+
+{shortcut && (
+  <script>
+    // `/` focuses the directory search from anywhere on the page, but
+    // never while the visitor is already typing somewhere — otherwise
+    // the shortcut eats a literal slash out of another field.
+    document.addEventListener("keydown", (event) => {
+      if (event.key !== "/" || event.metaKey || event.ctrlKey || event.altKey) return;
+      const active = document.activeElement as HTMLElement | null;
+      if (
+        active &&
+        (active.tagName === "INPUT" ||
+          active.tagName === "TEXTAREA" ||
+          active.tagName === "SELECT" ||
+          active.isContentEditable)
+      )
+        return;
+      const input = document.querySelector("[data-search-input]");
+      if (!(input instanceof HTMLInputElement)) return;
+      event.preventDefault();
+      input.focus();
+      input.select();
+    });
+  </script>
+)}

package/src/ui/button.test.ts

@@ -41,7 +41,7 @@ describe("button class builders", () => {
       "utf8",
     );
     const serverPage = readFileSync(
-      resolve(import.meta.dirname, "../../../../apps/example/src/pages/[slug]/index.astro"),
+      resolve(import.meta.dirname, "../../../../apps/example/src/components/DirectoryBrowse.astro"),
       "utf8",
     );
     expect(clientSource).toContain("chipClass()");

package/src/ui/button.ts

@@ -57,6 +57,15 @@ export function buttonClass(
  */
 export const PAGINATION_EXTRA = "min-w-9 px-2 py-1.5 text-2xs";
 
+/**
+ * The dead end of a pagination row — "Previous" on page 1.
+ *
+ * Dimming to `opacity-40` put it at 3.37:1 against the dark surface,
+ * which is a contrast failure, not a disabled state. 60% still reads
+ * as unavailable and clears 4.5:1.
+ */
+export const PAGINATION_DISABLED = "pointer-events-none opacity-60";
+
 /**
  * Facet filter trigger (the "Stack: Any" dropdown buttons). Includes
  * the `grove-filter-trigger` hook class because the client script

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

@@ -1,12 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,34 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/src/lib/load-collections.ts

@@ -1,33 +0,0 @@
-import { readFile, readdir } from "node:fs/promises";
-import { join, resolve } from "node:path";
-import { parse as parseYaml } from "yaml";
-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 async function loadCollections(cwd: string): Promise<Collection[]> {
-  const dir = resolve(cwd, "data/collections");
-  let files: string[];
-  try {
-    files = await readdir(dir);
-  } catch (err) {
-    if ((err as NodeJS.ErrnoException).code === "ENOENT") return [];
-    throw err;
-  }
-  const out: Collection[] = [];
-  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 as Collection);
-  }
-  return out;
-}