@grove-dev/astro 0.2.20 → 0.3.2

package/src/lib/search.ts

@@ -1,418 +1 @@
-import type { IndexRecord } from "@grove-dev/core";
-import { labelDisplay, lensDisplay, statusDisplay } from "./display.js";
-
-/**
- * URL-driven filter state for the /items discovery page.
- *
- * Multi-value fields use repeated keys in the URL: `?stack=Flutter&stack=React+Native`.
- * Empty / undefined fields mean "no filter on this dimension".
- */
-export type IndexFilters = {
-  q?: string;
-  stacks?: string[];
-  platforms?: string[];
-  categories?: string[];
-  labels?: string[];
-  licenses?: string[];
-  statuses?: string[];
-  /** A curated lens (e.g. "good-to-learn", "production-like"). Single value. */
-  lens?: string;
-  /** Sort order. Single value, defaults to "recently-updated". */
-  sort?: IndexSort | undefined;
-  /** 1-based page number. */
-  page?: number | undefined;
-};
-
-/** Available sort orders, in UI order. */
-export const SORT_OPTIONS = [
-  { value: "recently-updated", label: "Recently updated" },
-  { value: "most-starred", label: "Most starred" },
-  { value: "recently-added", label: "Recently added" },
-  { value: "best-overall", label: "Best overall" },
-  { value: "alphabetical", label: "Alphabetical" },
-] as const;
-
-export type IndexSort = (typeof SORT_OPTIONS)[number]["value"];
-
-const DEFAULT_SORT: IndexSort = "recently-updated";
-const DEFAULT_PAGE = 1;
-const DEFAULT_PAGE_SIZE = 20;
-
-const KEYS = {
-  q: "q",
-  stacks: "stack",
-  platforms: "platform",
-  categories: "category",
-  labels: "label",
-  licenses: "license",
-  statuses: "status",
-  lens: "lens",
-  sort: "sort",
-  page: "page",
-} as const;
-
-/**
- * Read filters from a URLSearchParams (or anything URLSearchParams-shaped,
- * e.g. the result of `new URL(req.url).searchParams`).
- */
-export function filtersFromSearchParams(sp: URLSearchParams): IndexFilters {
-  const rawSort = sp.get(KEYS.sort);
-  // Backwards-compat: old "most-mature" sort now maps to "best-overall".
-  const normalizedSort = rawSort === "most-mature" ? "best-overall" : rawSort;
-  const sort: IndexSort | undefined =
-    normalizedSort && (SORT_OPTIONS as readonly { value: string }[]).some((o) => o.value === normalizedSort)
-      ? (normalizedSort as IndexSort)
-      : undefined;
-  const rawPage = Number(sp.get(KEYS.page));
-  const page = Number.isFinite(rawPage) && rawPage >= 1 ? Math.floor(rawPage) : undefined;
-  const q = sp.get(KEYS.q);
-  const lens = sp.get(KEYS.lens);
-  return {
-    ...(q !== null ? { q } : {}),
-    stacks: sp.getAll(KEYS.stacks).filter(Boolean),
-    platforms: sp.getAll(KEYS.platforms).filter(Boolean),
-    categories: sp.getAll(KEYS.categories).filter(Boolean),
-    labels: sp.getAll(KEYS.labels).filter(Boolean),
-    licenses: sp.getAll(KEYS.licenses).filter(Boolean),
-    statuses: sp.getAll(KEYS.statuses).flatMap((s) => s.split(",")).filter(Boolean),
-    ...(lens !== null ? { lens } : {}),
-    ...(sort !== undefined ? { sort } : {}),
-    ...(page !== undefined ? { page } : {}),
-  };
-}
-
-/**
- * Serialize a filters object back to URLSearchParams.
- * Undefined / empty values are dropped. Defaults (sort, page 1, comfortable
- * density) are also dropped to keep URLs short and canonical.
- */
-export function searchParamsFromFilters(f: IndexFilters): URLSearchParams {
-  const sp = new URLSearchParams();
-  if (f.q) sp.set(KEYS.q, f.q);
-  for (const v of f.stacks ?? []) sp.append(KEYS.stacks, v);
-  for (const v of f.platforms ?? []) sp.append(KEYS.platforms, v);
-  for (const v of f.categories ?? []) sp.append(KEYS.categories, v);
-  for (const v of f.labels ?? []) sp.append(KEYS.labels, v);
-  for (const v of f.licenses ?? []) sp.append(KEYS.licenses, v);
-  if (f.statuses?.length) sp.set(KEYS.statuses, f.statuses.join(","));
-  if (f.lens) sp.set(KEYS.lens, f.lens);
-  if (f.sort && f.sort !== DEFAULT_SORT) sp.set(KEYS.sort, f.sort);
-  if (f.page && f.page !== DEFAULT_PAGE) sp.set(KEYS.page, String(f.page));
-  return sp;
-}
-
-/** True if any filter is active (i.e. the result list isn't "all items"). */
-export function hasAnyFilter(f: IndexFilters): boolean {
-  if (f.q && f.q.trim()) return true;
-  if (f.lens) return true;
-  return Boolean(
-    (f.stacks?.length ?? 0) +
-      (f.platforms?.length ?? 0) +
-      (f.categories?.length ?? 0) +
-      (f.labels?.length ?? 0) +
-      (f.licenses?.length ?? 0) +
-      (f.statuses?.length ?? 0),
-  );
-}
-
-/** How many items per page. Constant for now; future versions may vary. */
-export const PAGE_SIZE = DEFAULT_PAGE_SIZE;
-
-/**
- * Sort items in-place-free: returns a new array. Stable for ties.
- * Apps missing the sort key (e.g. no stars) sink to the bottom rather
- * than vanishing.
- */
-function recordName(record: IndexRecord): string {
-  return record.kind === "resource" ? record.title : record.name;
-}
-
-function projectStars(record: IndexRecord): number {
-  return record.kind === "project" ? record.github?.stars ?? 0 : 0;
-}
-
-function recordUpdatedAt(record: IndexRecord): string | null {
-  if (record.kind === "project") return record.github?.pushedAt ?? null;
-  if (record.kind === "resource") return record.publishedAt ?? null;
-  return null;
-}
-
-function recordAddedAt(record: IndexRecord): string | null {
-  return record.curation?.reviewedAt ?? null;
-}
-
-export function applySort(items: IndexRecord[], sort: IndexSort): IndexRecord[] {
-  const arr = items.slice();
-  const ts = (s?: string | null): number => (s ? new Date(s).valueOf() : 0);
-  switch (sort) {
-    case "most-starred":
-      arr.sort((a, b) => projectStars(b) - projectStars(a));
-      break;
-    case "recently-updated":
-      arr.sort((a, b) => ts(recordUpdatedAt(b)) - ts(recordUpdatedAt(a)));
-      break;
-    case "recently-added":
-      arr.sort((a, b) => ts(recordAddedAt(b)) - ts(recordAddedAt(a)));
-      break;
-    case "best-overall": {
-      const reviewed = (a: IndexRecord) => (a.curation?.reviewed ? 1 : 0);
-      const visible = (a: IndexRecord) => (a.visibility === "keep" ? 1 : 0);
-      arr.sort((a, b) => {
-        const reviewedDelta = reviewed(b) - reviewed(a);
-        if (reviewedDelta !== 0) return reviewedDelta;
-        const visibleDelta = visible(b) - visible(a);
-        if (visibleDelta !== 0) return visibleDelta;
-        return projectStars(b) - projectStars(a);
-      });
-      break;
-    }
-    case "alphabetical":
-      arr.sort((a, b) => recordName(a).localeCompare(recordName(b)));
-      break;
-  }
-  return arr;
-}
-
-/** Slice an array for a given page (1-based). */
-export function paginate<T>(items: T[], page: number, pageSize = PAGE_SIZE): T[] {
-  const start = (page - 1) * pageSize;
-  return items.slice(start, start + pageSize);
-}
-
-/** Total number of pages given an item count. Always >= 1. */
-export function totalPages(itemCount: number, pageSize = PAGE_SIZE): number {
-  return Math.max(1, Math.ceil(itemCount / pageSize));
-}
-
-/** Resolve the effective sort from a filters object, applying default. */
-export function effectiveSort(f: IndexFilters): IndexSort {
-  return f.sort ?? DEFAULT_SORT;
-}
-
-/** Resolve the effective page from a filters object, applying default. */
-export function effectivePage(f: IndexFilters): number {
-  return f.page ?? DEFAULT_PAGE;
-}
-
-/**
- * Return the subset of items that match all active filters (AND across
- * dimensions, OR within a dimension).
- *
- * `q` is a case-insensitive substring search across name, owner,
- * description, and category. Other dimensions are exact match.
- */
-export function filterRecords(items: IndexRecord[], f: IndexFilters): IndexRecord[] {
-  const q = f.q?.trim().toLowerCase();
-  const stacks = f.stacks?.length ? new Set(f.stacks) : null;
-  const platforms = f.platforms?.length ? new Set(f.platforms) : null;
-  const categories = f.categories?.length ? new Set(f.categories) : null;
-  const labels = f.labels?.length ? new Set(f.labels) : null;
-  const licenses = f.licenses?.length ? new Set(f.licenses) : null;
-  const statuses = f.statuses?.length ? new Set(f.statuses) : null;
-
-  return items.filter((a) => {
-    // Text search — match name, owner, description, category, stack,
-    // stacks, platforms, tags, backend, architecture, stateManagement,
-    // bestFor, whyListed, license, status.
-    if (q) {
-      const repoUrl = a.kind === "project" ? a.repoUrl : a.links.github ?? "";
-      const ownerMatch =
-        /github\.com\/([^/]+)\//.exec(repoUrl ?? "")?.[1]?.toLowerCase() ?? "";
-      const projectFields =
-        a.kind === "project"
-          ? [
-              a.stack,
-              ...a.stacks,
-              ...a.platforms,
-              a.projectType,
-              a.difficulty ?? "",
-              a.codebaseSize ?? "",
-              ...a.bestFor,
-              ...a.whyListed,
-              a.github?.license ?? "",
-              a.health?.status ? statusDisplay(a.health.status) : "",
-            ]
-          : [];
-      const resourceFields =
-        a.kind === "resource"
-          ? [a.type, a.topic, a.author ?? ""]
-          : [];
-      const entityFields =
-        a.kind === "entity"
-          ? [a.type, a.location ?? "", a.parent ?? ""]
-          : [];
-      const haystack = [
-        recordName(a),
-        ownerMatch,
-        a.description,
-        a.category,
-        ...a.tags,
-        ...projectFields,
-        ...resourceFields,
-        ...entityFields,
-      ]
-        .join(" ")
-        .toLowerCase();
-      if (!haystack.includes(q)) return false;
-    }
-
-    if (stacks) {
-      if (a.kind !== "project") return false;
-      const allStacks = [a.stack, ...a.stacks].filter(
-        (stack): stack is string => Boolean(stack),
-      );
-      if (!allStacks.some((s) => stacks.has(s))) return false;
-    }
-
-    if (platforms) {
-      if (a.kind !== "project") return false;
-      if (!a.platforms.some((p) => platforms.has(p))) return false;
-    }
-
-    if (categories) {
-      if (!categories.has(a.category)) return false;
-    }
-
-    if (labels) {
-      if (!a.curation?.labels?.some((l) => labels.has(l))) return false;
-    }
-
-    if (licenses) {
-      if (a.kind !== "project") return false;
-      const license = a.github?.license;
-      if (!license || !licenses.has(license)) return false;
-    }
-
-    if (statuses) {
-      if (a.kind !== "project") return false;
-      const status = a.health?.status;
-      if (!status || !statuses.has(status)) return false;
-    }
-
-    if (f.lens) {
-      if (!a.curation?.lenses?.includes(f.lens)) return false;
-    }
-
-    return true;
-  });
-}
-
-/** Build a flat list of "active filter" chips for display + removal. */
-export function activeFilterChips(
-  f: IndexFilters,
-): { key: keyof IndexFilters; value: string; label: string }[] {
-  const out: { key: keyof IndexFilters; value: string; label: string }[] = [];
-
-  if (f.q && f.q.trim()) {
-    out.push({ key: "q", value: "", label: `“${f.q}”` });
-  }
-  for (const v of f.stacks ?? []) {
-    out.push({ key: "stacks", value: v, label: `Stack: ${v}` });
-  }
-  for (const v of f.platforms ?? []) {
-    out.push({ key: "platforms", value: v, label: `Platform: ${v}` });
-  }
-  for (const v of f.categories ?? []) {
-    out.push({ key: "categories", value: v, label: `Category: ${v}` });
-  }
-  for (const v of f.labels ?? []) {
-    out.push({ key: "labels", value: v, label: labelDisplay(v) ?? v });
-  }
-  for (const v of f.licenses ?? []) {
-    out.push({ key: "licenses", value: v, label: `License: ${v}` });
-  }
-  if (f.lens) {
-    out.push({ key: "lens", value: f.lens, label: lensDisplay(f.lens) });
-  }
-  // Status: collapse the "stale,quiet" composite into a single chip.
-  if (f.statuses && f.statuses.length) {
-    const joined = f.statuses.join(",");
-    if (joined === "stale,quiet") {
-      out.push({ key: "statuses", value: "stale,quiet", label: statusDisplay("needs-maintainer") });
-    } else {
-      for (const v of f.statuses) {
-        out.push({ key: "statuses", value: v, label: statusDisplay(v) });
-      }
-    }
-  }
-
-  return out;
-}
-
-/**
- * Return a new filters object with one (key, value) removed.
- * - key="q" → clears the search string
- * - multi-value keys → removes the single matching value
- * Used by the "x" button on each active filter chip.
- * Also resets page to 1 so the user doesn't get stranded on a high page
- * that no longer has results.
- */
-export function removeFilter(
-  f: IndexFilters,
-  key: keyof IndexFilters,
-  value: string,
-): IndexFilters {
-  let next: IndexFilters;
-  if (key === "q") {
-    // `q` is `string | undefined` under exactOptionalPropertyTypes; the
-    // cleanest way to drop it is to omit the key entirely (delete-style).
-    const { q: _drop, ...rest } = f;
-    next = rest;
-  } else {
-    const current = f[key] as string[] | undefined;
-    if (!current) return f;
-    const filtered = current.filter((v) => v !== value);
-    if (filtered.length === 0) {
-      const { [key]: _drop, ...rest } = f;
-      next = rest;
-    } else {
-      next = { ...f, [key]: filtered };
-    }
-  }
-  next.page = 1;
-  return next;
-}
-
-/**
- * Build the full list of facet values from the items array, preserving
- * a sensible order (frequency desc, then alphabetical for ties).
- */
-export function buildFacets(items: IndexRecord[]) {
-  const counts = {
-    stack: new Map<string, number>(),
-    platform: new Map<string, number>(),
-    category: new Map<string, number>(),
-    label: new Map<string, number>(),
-    license: new Map<string, number>(),
-  };
-  for (const a of items) {
-    if (a.kind === "project") {
-      const allStacks = new Set(
-        [a.stack, ...a.stacks].filter((stack): stack is string => Boolean(stack)),
-      );
-      for (const s of allStacks) counts.stack.set(s, (counts.stack.get(s) ?? 0) + 1);
-      for (const p of a.platforms) counts.platform.set(p, (counts.platform.get(p) ?? 0) + 1);
-      const license = a.github?.license;
-      if (license) counts.license.set(license, (counts.license.get(license) ?? 0) + 1);
-    }
-    counts.category.set(a.category, (counts.category.get(a.category) ?? 0) + 1);
-    for (const l of a.curation?.labels ?? []) counts.label.set(l, (counts.label.get(l) ?? 0) + 1);
-  }
-  const sortByCountThenName = (m: Map<string, number>) =>
-    [...m.entries()]
-      .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
-      .map(([value, count]) => ({ value, count }));
-  return {
-    stacks: sortByCountThenName(counts.stack),
-    platforms: sortByCountThenName(counts.platform),
-    categories: sortByCountThenName(counts.category),
-    labels: sortByCountThenName(counts.label),
-    licenses: sortByCountThenName(counts.license),
-  };
-}
-
-// ── V1-published API ─────────────────────────────────────────────────
-// `IndexFilters` / `IndexSort` are the canonical V1 names for the
-// filter-state type. The internal functions (filterRecords, applySort,
-// paginate, buildFacets, etc.) operate on the generic `IndexRecord`
-// shape and are intentionally framework-agnostic.
+export * from "@grove-dev/core";

package/src/lib/taxonomy-counts.ts

@@ -1,26 +1 @@
-type TaxonomyRecord = {
-  category?: string;
-  stack?: string;
-  stacks?: string[];
-};
-
-/** Number of items in the directory, per category name. */
-export function countByCategory(items: TaxonomyRecord[] = []): Map<string, number> {
-  const m = new Map<string, number>();
-  for (const a of items) {
-    const k = a.category || "Other";
-    m.set(k, (m.get(k) ?? 0) + 1);
-  }
-  return m;
-}
-
-/** Number of items in the directory, per primary stack. */
-export function countByStack(items: TaxonomyRecord[] = []): Map<string, number> {
-  const m = new Map<string, number>();
-  for (const a of items) {
-    const stacks = new Set([a.stack, ...(a.stacks ?? [])].filter(Boolean) as string[]);
-    if (stacks.size === 0) stacks.add("Other");
-    for (const stack of stacks) m.set(stack, (m.get(stack) ?? 0) + 1);
-  }
-  return m;
-}
+export * from "@grove-dev/core";

package/{templates/default/src/data/records.ts → src/server/directory.ts}

@@ -1,7 +1,7 @@
 /**
  *  Source of truth: `data/generated/records.{full,index,json}` and
  *  `data/generated/site-config.json`, produced at build time by
- *  `grove generate` from `data/records/*.yml` and `grove.config.ts`.
+ *  automatically from `data/records/*.yml` and `grove.config.ts`.
  *
  *  Three flavors of records are written by the generator:
  *
@@ -26,18 +26,19 @@
  *
  *  JSON imports are static at the top of this module so Vite
  *  resolves them at build time. A fresh scaffold that has not yet
- *  run `grove generate` will fail the build with a clear Vite
+ *  complete preparation will fail the build with a clear Vite
  *  resolution error, which is the correct signal — a build that
  *  silently renders an empty directory hides real config mistakes.
  */
-import fullPayload from "../../data/generated/records.full.json";
-import indexPayload from "../../data/generated/records.index.json";
-import siteConfigPayload from "../../data/generated/site-config.json";
+import fullPayload from "@grove/generated/records.full.json";
+import indexPayload from "@grove/generated/records.index.json";
+import siteConfigPayload from "@grove/generated/site-config.json";
 import { existsSync, readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { dirname, resolve } from "node:path";
 import { marked } from "marked";
 import sanitizeHtml from "sanitize-html";
+import { prettySlug } from "../lib/display.js";
 import type {
   ProjectRecord,
   ResourceRecord,
@@ -79,12 +80,39 @@ interface SiteConfigPayload {
     labelSingular?: string;
     labelPlural?: string;
   };
+  taxonomy?: Partial<
+    Record<
+      "categories" | "stacks" | "platforms" | "distributionChannels",
+      Array<{ id: string; name: string }>
+    >
+  >;
   name?: string;
 }
 
-const fullRecordsRaw: Resource[] = (fullPayload as FullPayload).records ?? [];
-const indexRecordsRaw: IndexRecord[] = (indexPayload as IndexPayload).records ?? [];
+const fullRecordsRaw: Resource[] =
+  (fullPayload as unknown as FullPayload).records ?? [];
+const indexRecordsRaw: IndexRecord[] =
+  (indexPayload as unknown as IndexPayload).records ?? [];
 const siteConfigRaw: SiteConfigPayload = siteConfigPayload as SiteConfigPayload;
+const taxonomyMaps = Object.fromEntries(
+  Object.entries(siteConfigRaw.taxonomy ?? {}).map(([kind, entries]) => [
+    kind,
+    new Map((entries ?? []).map((entry) => [entry.id, entry.name])),
+  ]),
+) as Partial<
+  Record<
+    "categories" | "stacks" | "platforms" | "distributionChannels",
+    Map<string, string>
+  >
+>;
+export const taxonomy = siteConfigRaw.taxonomy ?? {};
+
+export function taxonomyLabel(
+  kind: "categories" | "stacks" | "platforms" | "distributionChannels",
+  id: string,
+): string {
+  return taxonomyMaps[kind]?.get(id) ?? prettySlug(id);
+}
 
 /** Full records (every record, all visibility). Use this for the
  *  detail page (where you need `content`, `bestFor`, `whyListed`,
@@ -148,7 +176,7 @@ export function entityBySlug(slug: string): EntityRecord | undefined {
 // route slug, the kind filter, and the human label. Rather than
 // hardcode "project" / "projects" / "kind: project" at every
 // call-site, we derive them once from `site-config.json`'s
-// `blueprintConfig` block (populated by `grove generate`).
+// `blueprintConfig` block (populated by Grove preparation).
 //
 // `indexSlug()` and `itemLabel()` retain their old signatures
 // (zero-arg) so existing pages keep working — they now read from
@@ -224,6 +252,10 @@ export const fullItems: Resource[] = (() => {
   return fullRecords.filter((r) => r.kind === blueprintKind);
 })();
 
+export const fullProjects: ProjectRecord[] = fullRecords.filter(
+  (record): record is ProjectRecord => record.kind === "project",
+);
+
 // ──────────────────────────────────────────────────────────────────────
 // Markdown content rendering (sanitized)
 // ──────────────────────────────────────────────────────────────────────
@@ -316,3 +348,53 @@ for (const r of fullRecords) {
 export function getContentHtml(slug: string): string | null {
   return contentHtmlBySlug.get(slug) ?? null;
 }
+
+/**
+ * Sanitized Markdown for a consumer-authored page under
+ * `content/pages/<page>.md`. Default template pages use this to
+ * accept custom copy while keeping Grove's layout and components.
+ */
+export function getPageContentHtml(page: string): string | null {
+  const candidates = [
+    resolve(here, "..", "..", "content", "pages", `${page}.md`),
+    resolve(here, "..", "..", "..", "content", "pages", `${page}.md`),
+    resolve(process.cwd(), "content", "pages", `${page}.md`),
+  ];
+  const path = candidates.find((candidate) => existsSync(candidate));
+  if (!path) return null;
+
+  try {
+    const markdown = readFileSync(path, "utf8").replace(
+      /^---\r?\n[\s\S]*?\r?\n---\r?\n?/,
+      "",
+    );
+    const rawHtml = marked.parse(markdown, { async: false }) as string;
+    return sanitizeHtml(rawHtml, {
+      allowedTags: [
+        "h1", "h2", "h3", "h4",
+        "p", "br", "hr",
+        "ul", "ol", "li",
+        "strong", "em", "b", "i", "u", "s", "del",
+        "a", "code", "pre", "blockquote", "img",
+      ],
+      allowedAttributes: {
+        a: ["href", "title", "rel", "target"],
+        img: ["src", "alt", "title", "width", "height", "loading"],
+      },
+      allowedSchemes: ["http", "https", "mailto", "tel"],
+      allowedSchemesByTag: {
+        a: ["http", "https", "mailto", "tel"],
+        img: ["http", "https"],
+      },
+      transformTags: {
+        a: sanitizeHtml.simpleTransform("a", {
+          rel: "noopener noreferrer",
+          target: "_blank",
+        }, true),
+      },
+      disallowedTagsMode: "discard",
+    });
+  } catch {
+    return null;
+  }
+}

package/src/server/index.ts

@@ -0,0 +1,2 @@
+export * from "./directory.js";
+export * from "./models.js";