@grove-dev/astro 0.1.4 → 0.2.2

package/templates/default/src/components/layout/Header.astro

@@ -1,144 +1,43 @@
 ---
-import { siteConfig } from "../../data/config";
-import ThemeToggle from "./ThemeToggle.astro";
-import { stats } from "../../data/stats";
-import { compact } from "../../lib/format";
-
-const githubUrl = stats.originalRepo;
-
-// Nav items. Order is information-architecture: discover → browse → act.
-// `Contributors` is intentionally not a top-level item — it lives lower
-// on the page. The watchlist was removed in v0.1 (see CHANGELOG).
-//
-// All links point to /apps with a filter rather than in-page anchors.
-// This keeps the nav usable from any page (e.g. /about) — anchor links
-// would only work on the home page, leaving /apps and /about with dead
-// links. Category/Stack filters are exposed via the /apps refine panel
-// and the home page's "Browse by stack"/"Browse by category" sections.
-const navItems = [
-  { label: "New", href: "/apps?label=new" },
-  { label: "Hot", href: "/apps?label=hot" },
-  { label: "Categories", href: "/apps" },
-  { label: "Stacks", href: "/apps" },
-  { label: "About", href: "/about" },
-];
-
-const starsLabel = compact(stats.stars);
+import siteConfig from "../../data/generated/site-config.json";
+import { indexSlug } from "../../data/records";
+
+const navItems = siteConfig.nav.length > 0
+  ? siteConfig.nav
+  : [
+      { label: "Home", href: "/" },
+      { label: "Browse", href: `/${indexSlug()}` },
+      { label: "About", href: "/about" },
+      { label: "Submit", href: "/submit" },
+    ];
 ---
 
-<header
-  class="sticky top-0 z-50 border-b border-ink-200 bg-white/85 backdrop-blur dark:border-ink-800 dark:bg-ink-950/85"
->
-  <div
-    class="mx-auto flex max-w-wide items-center gap-6 px-5 py-3 sm:px-7"
-  >
+<header class="border-b border-ink-200 bg-white/85 backdrop-blur dark:border-ink-800 dark:bg-ink-950/85">
+  <div class="mx-auto flex max-w-6xl items-center gap-6 px-5 py-3 sm:px-7">
     <a
       href="/"
-      class="inline-flex items-center gap-2 text-[0.95rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100"
+      class="inline-flex items-center gap-2 text-base font-semibold tracking-tight text-ink-900 dark:text-ink-100"
     >
       <span
         aria-hidden="true"
-        class="inline-block h-[18px] w-[18px] rounded bg-ink-900 dark:bg-ink-100"
+        class="inline-block h-4 w-4 rounded bg-ink-900 dark:bg-ink-100"
       ></span>
       <span>{siteConfig.name}</span>
     </a>
 
     <nav class="hidden flex-1 md:block" aria-label="Primary">
       <ul class="m-0 flex list-none gap-5 p-0">
-        {
-          navItems.map((item) => (
-            <li>
-              <a
-                href={item.href}
-                class="text-[0.875rem] font-medium text-ink-500 transition-colors hover:text-ink-900 dark:text-ink-400 dark:hover:text-ink-100"
-              >
-                {item.label}
-              </a>
-            </li>
-          ))
-        }
+        {navItems.map((item) => (
+          <li>
+            <a
+              href={item.href}
+              class="text-sm font-medium text-ink-500 transition-colors hover:text-ink-900 dark:text-ink-400 dark:hover:text-ink-100"
+            >
+              {item.label}
+            </a>
+          </li>
+        ))}
       </ul>
     </nav>
-
-    <div class="ml-auto flex items-center gap-2">
-      <a
-        href="/submit"
-        class="hidden h-9 items-center gap-1.5 rounded-md border border-ink-200 bg-white px-3 text-[0.875rem] font-medium text-ink-700 transition-colors hover:border-ink-300 hover:bg-ink-50 sm:inline-flex dark:border-ink-800 dark:bg-ink-950 dark:text-ink-300 dark:hover:border-ink-700 dark:hover:bg-ink-900/40"
-      >
-        <svg viewBox="0 0 16 16" width="13" height="13" aria-hidden="true" fill="currentColor">
-          <path d="M7.75 2a.75.75 0 0 1 .75.75v3.5h3.5a.75.75 0 0 1 0 1.5h-3.5v3.5a.75.75 0 0 1-1.5 0v-3.5h-3.5a.75.75 0 0 1 0-1.5h3.5v-3.5A.75.75 0 0 1 7.75 2Z"/>
-        </svg>
-        <span>Submit app</span>
-      </a>
-
-      {/* GitHub button. The star count is rendered as text, not an
-          external badge image, so it works offline, doesn't depend
-          on shields.io, and reflects what we already know (stats.stars). */}
-      <a
-        href={githubUrl}
-        target="_blank"
-        rel="noopener noreferrer"
-        aria-label={`View source on GitHub — ${stats.stars} stars`}
-        title="View source on GitHub"
-        class="inline-flex h-9 items-center divide-x divide-ink-200 overflow-hidden rounded-md border border-ink-200 text-[0.875rem] font-medium transition-colors hover:border-ink-300 hover:bg-ink-50 dark:divide-ink-800 dark:border-ink-800 dark:hover:border-ink-700 dark:hover:bg-ink-900/40"
-      >
-        <span class="flex items-center gap-1.5 px-2.5 py-1.5 text-ink-900 dark:text-ink-100">
-          <svg
-            viewBox="0 0 16 16"
-            width="16"
-            height="16"
-            aria-hidden="true"
-            fill="currentColor"
-          >
-            <path
-              d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38v-1.33c-2.22.48-2.69-1.07-2.69-1.07-.36-.92-.89-1.17-.89-1.17-.73-.5.05-.49.05-.49.8.06 1.23.83 1.23.83.72 1.22 1.87.87 2.33.67.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48v2.19c0 .21.15.46.55.38A8 8 0 0 0 8 0Z"
-            />
-          </svg>
-          <span>Star</span>
-        </span>
-        <span class="flex items-center gap-1 bg-ink-50 px-2 py-1.5 text-ink-700 dark:bg-ink-900/60 dark:text-ink-300">
-          <svg
-            viewBox="0 0 16 16"
-            width="11"
-            height="11"
-            aria-hidden="true"
-            fill="currentColor"
-            class="text-amber-500"
-          >
-            <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>
-          <span class="font-mono">{starsLabel}</span>
-        </span>
-      </a>
-      <ThemeToggle />
-    </div>
   </div>
 </header>
-
-<script>
-  // Smooth-scroll for in-page anchor links (Header nav + Hero CTA).
-  // Works on any <a href="#…"> that points to an existing element on
-  // the current page. External links (e.g. /about, /apps?…) are skipped
-  // because they don't start with "#". Modifier-clicks (Cmd/Ctrl/Shift/
-  // middle) let the browser handle the anchor normally so users can
-  // open the same section in a new tab.
-  document.addEventListener("click", (e) => {
-    if (e.defaultPrevented) return;
-    if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
-    if (e.button !== 0) return; // non-primary mouse button
-    const link = (e.target as HTMLElement).closest<HTMLAnchorElement>(
-      'a[href^="#"]',
-    );
-    if (!link) return;
-    const id = link.getAttribute("href")!;
-    if (id.length <= 1) return; // bare "#" → ignore
-    const target = document.querySelector(id);
-    if (!target) return; // not on this page; let the browser navigate
-    e.preventDefault();
-    target.scrollIntoView({ behavior: "smooth", block: "start" });
-    // Update the URL hash without an extra jump, so back/forward works.
-    history.replaceState(null, "", id);
-  });
-</script>

package/templates/default/src/data/records.ts

@@ -0,0 +1,161 @@
+/**
+ * Source of truth: `data/generated/records.{full,index,json}`,
+ * produced at build time by `grove generate` from
+ * `data/records/*.yml`.
+ *
+ * Three flavors are written by the generator:
+ *
+ *   - `records.full.json`   — every record, all visibility. Carries
+ *     every normalized field (including `content`, `bestFor`,
+ *     `whyListed`, `caveats`, full `github.repository`, ...).
+ *     Use this for the detail page.
+ *   - `records.index.json`  — slim projection, visible-only. Use
+ *     this for the list page and any home-page sectioning.
+ *   - `records.json`        — alias of `records.full.json`.
+ *
+ * The YML files are the human-edited source; this module is a
+ * typed re-export so pages can import the records without parsing
+ * JSON inline. The shape is the V1 discriminated union from
+ * `@grove-dev/core` — records have a `kind` field that selects
+ * `ProjectRecord`, `ResourceRecord`, or `EntityRecord`. Pages cast
+ * to the kind they expect based on the blueprint in
+ * `grove.config.ts`.
+ *
+ * When the JSON files are missing (e.g. before `grove generate`
+ * runs, or in a fresh scaffold with no records) this module falls
+ * back to empty arrays so the Astro build still succeeds — every
+ * page must render a graceful "no records yet" state.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import type { ProjectRecord, ResourceRecord, EntityRecord, Resource } from "@grove-dev/core";
+
+interface RecordsPayload {
+  schemaVersion?: number;
+  blueprint?: string;
+  generatedAt?: string;
+  totalRecords?: number;
+  visibleRecords?: number;
+  records?: Resource[];
+}
+
+function loadGenerated(filename: string): Resource[] {
+  // The Astro build resolves JSON imports from `src/data/*.ts`, but
+  // we want to be defensive about the order of operations: a fresh
+  // scaffold runs `astro build` without first running
+  // `grove generate`, in which case the JSON file does not exist.
+  // Resolve the path relative to this module's URL, then fall back
+  // to an empty list.
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+      resolve(here, "..", "..", "data", "generated", filename),
+      resolve(here, "..", "..", "..", "data", "generated", filename),
+      resolve(process.cwd(), "data", "generated", filename),
+    ];
+    const path = candidates.find((p) => existsSync(p));
+    if (!path) return [];
+    const raw = readFileSync(path, "utf8");
+    const parsed = JSON.parse(raw) as RecordsPayload;
+    return (parsed.records ?? []) as Resource[];
+  } catch {
+    return [];
+  }
+}
+
+const fullRecordsRaw = loadGenerated("records.full.json");
+const indexRecordsRaw = loadGenerated("records.index.json");
+
+/**
+ * Full records (all visibility). Use this for the detail page,
+ * where you need `content`, `bestFor`, `whyListed`, `caveats`,
+ * the full `github.repository` block, etc.
+ */
+export const fullRecords: Resource[] = fullRecordsRaw;
+
+/**
+ * Index-payload records (visible only). Use this for the list
+ * page and any home-page sectioning, where you only need the
+ * slim search-index fields.
+ */
+export const records: Resource[] =
+  indexRecordsRaw.length > 0 ? indexRecordsRaw : fullRecordsRaw;
+
+/** Project-kind records only. */
+export const projects = records.filter(
+  (r): r is ProjectRecord => r.kind === "project",
+);
+
+/** Resource-kind records. */
+export const resources = records.filter(
+  (r): r is ResourceRecord => r.kind === "resource",
+);
+
+/** Entity-kind records. */
+export const entities = records.filter(
+  (r): r is EntityRecord => r.kind === "entity",
+);
+
+const bySlug = new Map(fullRecords.map((r) => [r.slug, r]));
+
+export function recordBySlug(slug: string): Resource | undefined {
+  return bySlug.get(slug);
+}
+
+/**
+ * Generic slug lookup. The spec name is `findRecord`; this is an
+ * alias of `recordBySlug` so consumers can use either spelling.
+ * The two-name pattern matches the rest of the module (we keep
+ * `recordBySlug` for the typed `projectBySlug`/`resourceBySlug`/
+ * `entityBySlug` family, and `findRecord` as the unified entry
+ * point).
+ */
+export function findRecord(slug: string): Resource | undefined {
+  return bySlug.get(slug);
+}
+
+export function projectBySlug(slug: string): ProjectRecord | undefined {
+  const r = bySlug.get(slug);
+  return r && r.kind === "project" ? r : undefined;
+}
+
+export function resourceBySlug(slug: string): ResourceRecord | undefined {
+  const r = bySlug.get(slug);
+  return r && r.kind === "resource" ? r : undefined;
+}
+
+export function entityBySlug(slug: string): EntityRecord | undefined {
+  const r = bySlug.get(slug);
+  return r && r.kind === "entity" ? r : undefined;
+}
+
+/**
+ * Page slug for the directory index page, derived from the
+ * blueprint in `grove.config.ts` (mirrors the helper that used
+ * to live in `data/site-config.ts`).
+ */
+export function indexSlug(blueprint: string | undefined): string {
+  switch (blueprint) {
+    case "resource-hub":
+      return "resources";
+    case "ecosystem-map":
+      return "entities";
+    case "project-directory":
+    default:
+      return "projects";
+  }
+}
+
+/** Human label for items in the UI. */
+export function itemLabel(blueprint: string | undefined): string {
+  switch (blueprint) {
+    case "resource-hub":
+      return "resource";
+    case "ecosystem-map":
+      return "entity";
+    case "project-directory":
+    default:
+      return "project";
+  }
+}

package/templates/default/src/lib/markdown.ts

@@ -0,0 +1,171 @@
+/**
+ * Tiny markdown → HTML converter for page-level content bodies.
+ *
+ * Scope is intentionally narrow: it handles the markdown the
+ * `content/pages/*.md` files actually use (headings, paragraphs,
+ * unordered + ordered lists, fenced code, inline `code` and
+ * links). Anything more elaborate (tables, footnotes, autolinks)
+ * is out of scope — consumers can swap in a real renderer
+ * (marked, remark, ...) by overriding the page-level helper.
+ *
+ * The output is HTML-escaped at the source so a stray `<` in the
+ * markdown file can't break the page. Inline `code` and links are
+ * processed before the escape pass.
+ */
+import { existsSync, readFileSync } from "node:fs";
+
+function escapeHtml(s: string): string {
+  return s
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;");
+}
+
+function renderInline(line: string): string {
+  let out = escapeHtml(line);
+  // Inline code: `…` — render first so its content doesn't get
+  // further processed.
+  out = out.replace(/`([^`]+)`/g, (_, code: string) => `<code>${code}</code>`);
+  // Links: [text](url)
+  out = out.replace(
+    /\[([^\]]+)\]\(([^)]+)\)/g,
+    (_, text: string, url: string) =>
+      `<a href="${url}" class="text-ink-900 underline hover:text-ink-700 dark:text-ink-100 dark:hover:text-white" rel="noopener noreferrer">${text}</a>`,
+  );
+  // Bold: **…**
+  out = out.replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+  // Italic: *…*
+  out = out.replace(/\*([^*]+)\*/g, "<em>$1</em>");
+  return out;
+}
+
+interface Block {
+  type: "h2" | "h3" | "p" | "ul" | "ol" | "pre";
+  lines: string[];
+}
+
+function parseBlocks(md: string): Block[] {
+  const lines = md.split(/\r?\n/);
+  const blocks: Block[] = [];
+  let i = 0;
+  while (i < lines.length) {
+    const line = lines[i];
+    if (!line.trim()) {
+      i++;
+      continue;
+    }
+    if (line.startsWith("## ")) {
+      blocks.push({ type: "h2", lines: [line.slice(3)] });
+      i++;
+      continue;
+    }
+    if (line.startsWith("### ")) {
+      blocks.push({ type: "h3", lines: [line.slice(4)] });
+      i++;
+      continue;
+    }
+    if (line.startsWith("```")) {
+      const buf: string[] = [];
+      i++;
+      while (i < lines.length && !lines[i].startsWith("```")) {
+        buf.push(lines[i]);
+        i++;
+      }
+      i++; // skip closing fence
+      blocks.push({ type: "pre", lines: buf });
+      continue;
+    }
+    if (/^[-*] /.test(line)) {
+      const buf: string[] = [];
+      while (i < lines.length && /^[-*] /.test(lines[i])) {
+        buf.push(lines[i].slice(2));
+        i++;
+      }
+      blocks.push({ type: "ul", lines: buf });
+      continue;
+    }
+    if (/^\d+\. /.test(line)) {
+      const buf: string[] = [];
+      while (i < lines.length && /^\d+\. /.test(lines[i])) {
+        buf.push(lines[i].replace(/^\d+\. /, ""));
+        i++;
+      }
+      blocks.push({ type: "ol", lines: buf });
+      continue;
+    }
+    // Default: paragraph (consume contiguous non-blank lines).
+    const buf: string[] = [line];
+    i++;
+    while (
+      i < lines.length &&
+      lines[i].trim() &&
+      !lines[i].startsWith("## ") &&
+      !lines[i].startsWith("### ") &&
+      !lines[i].startsWith("```") &&
+      !/^[-*] /.test(lines[i]) &&
+      !/^\d+\. /.test(lines[i])
+    ) {
+      buf.push(lines[i]);
+      i++;
+    }
+    blocks.push({ type: "p", lines: buf });
+  }
+  return blocks;
+}
+
+export function renderMarkdown(md: string): string {
+  const blocks = parseBlocks(md);
+  const html: string[] = [];
+  for (const b of blocks) {
+    switch (b.type) {
+      case "h2":
+        html.push(
+          `<h2 class="m-0 mt-10 text-[1.375rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100">${renderInline(b.lines[0])}</h2>`,
+        );
+        break;
+      case "h3":
+        html.push(
+          `<h3 class="m-0 mt-8 text-[1.125rem] font-semibold tracking-tight text-ink-900 dark:text-ink-100">${renderInline(b.lines[0])}</h3>`,
+        );
+        break;
+      case "p":
+        html.push(
+          `<p class="m-0 mt-4 text-[0.9375rem] leading-relaxed text-ink-700 dark:text-ink-200">${b.lines.map(renderInline).join(" ")}</p>`,
+        );
+        break;
+      case "ul":
+        html.push(
+          `<ul class="m-0 mt-4 list-disc space-y-1.5 pl-6 text-[0.9375rem] leading-relaxed text-ink-700 dark:text-ink-200">${b.lines
+            .map((l) => `<li>${renderInline(l)}</li>`)
+            .join("")}</ul>`,
+        );
+        break;
+      case "ol":
+        html.push(
+          `<ol class="m-0 mt-4 list-decimal space-y-1.5 pl-6 text-[0.9375rem] leading-relaxed text-ink-700 dark:text-ink-200">${b.lines
+            .map((l) => `<li>${renderInline(l)}</li>`)
+            .join("")}</ol>`,
+        );
+        break;
+      case "pre":
+        html.push(
+          `<pre class="mt-4 overflow-x-auto rounded-md border border-ink-200 bg-ink-50 p-4 text-xs leading-relaxed text-ink-800 dark:border-ink-800 dark:bg-ink-900/60 dark:text-ink-200"><code>${escapeHtml(b.lines.join("\n"))}</code></pre>`,
+        );
+        break;
+    }
+  }
+  return html.join("\n");
+}
+
+/** Read a markdown file from a list of candidate paths, return null if missing. */
+export function readMarkdownFile(candidates: string[]): string | null {
+  for (const path of candidates) {
+    try {
+      if (!existsSync(path)) continue;
+      return readFileSync(path, "utf8");
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}