@grove-dev/astro 0.3.1 → 0.3.2

package/src/template-routes.test.ts

@@ -1,103 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { readFile, stat } from "node:fs/promises";
-import { resolve } from "node:path";
-
-const pagesDir = resolve(import.meta.dirname, "../templates/default/src/pages");
-
-describe("default Astro route configuration", () => {
-  it("ships TypeScript settings that resolve package exports and Node built-ins", async () => {
-    const templateRoot = resolve(pagesDir, "../..");
-    const tsconfig = JSON.parse(
-      await readFile(resolve(templateRoot, "tsconfig.json"), "utf8"),
-    ) as {
-      extends?: string;
-      compilerOptions?: {
-        moduleResolution?: string;
-        types?: string[];
-      };
-    };
-    const manifest = JSON.parse(
-      await readFile(resolve(templateRoot, "package.json"), "utf8"),
-    ) as { devDependencies?: Record<string, string> };
-
-    expect(tsconfig.extends).toBe("astro/tsconfigs/base");
-    expect(tsconfig.compilerOptions?.moduleResolution).toBe("Bundler");
-    expect(tsconfig.compilerOptions?.types).toContain("node");
-    expect(manifest.devDependencies?.["@types/node"]).toMatch(/^\^/);
-  });
-
-  it("treats generated JSON as an untyped boundary before applying payload types", async () => {
-    const recordsModule = await readFile(
-      resolve(pagesDir, "../data/records.ts"),
-      "utf8",
-    );
-
-    expect(recordsModule).toContain(
-      "fullPayload as unknown as FullPayload",
-    );
-  });
-
-  it("derives the directory route from generated site config", async () => {
-    const listPage = await readFile(resolve(pagesDir, "[slug]/index.astro"), "utf8");
-
-    expect(listPage).toContain("siteConfig.blueprintConfig?.routeSlug");
-  });
-
-  it("does not generate the legacy apps alias when apps is canonical", async () => {
-    const aliasPage = await readFile(resolve(pagesDir, "apps/[recordSlug].astro"), "utf8");
-
-    expect(aliasPage).toContain('if (indexSlug() === "apps")');
-    expect(aliasPage).toContain("return []");
-  });
-
-  it("renders consumer-authored about Markdown through the default page", async () => {
-    const aboutPage = await readFile(resolve(pagesDir, "about.astro"), "utf8");
-
-    expect(aboutPage).toContain('getPageContentHtml("about")');
-  });
-
-  it("generates submission drafts accepted by the Grove record schema", async () => {
-    const submitPage = await readFile(resolve(pagesDir, "submit.astro"), "utf8");
-
-    expect(submitPage).toContain('"  type: manual"');
-    expect(submitPage).not.toContain('"  type: github"');
-  });
-
-  it("keeps generic maintenance behavior in Grove instead of consumer scripts", async () => {
-    const templateRoot = resolve(pagesDir, "../..");
-    const manifest = JSON.parse(
-      await readFile(resolve(templateRoot, "package.json"), "utf8"),
-    ) as { scripts?: Record<string, string> };
-    const scriptsDirExists = await stat(resolve(templateRoot, "scripts"))
-      .then(() => true)
-      .catch(() => false);
-
-    expect(manifest.scripts?.["build:llms"]).toBe("grove llms");
-    expect(manifest.scripts?.["sync:contributors"]).toBe(
-      "grove sync contributors",
-    );
-    expect(scriptsDirExists).toBe(false);
-  });
-
-  it("hydrates static list pages with URL-driven search and pagination", async () => {
-    const listPage = await readFile(resolve(pagesDir, "[slug]/index.astro"), "utf8");
-
-    expect(listPage).toContain('id="grove-index-data"');
-    expect(listPage).toContain("function applyClientFilters()");
-    expect(listPage).toContain("const PAGE_SIZE = 20");
-  });
-
-  it("uses generated taxonomy names as display labels", async () => {
-    const recordsModule = await readFile(
-      resolve(pagesDir, "../data/records.ts"),
-      "utf8",
-    );
-    const homePage = await readFile(resolve(pagesDir, "index.astro"), "utf8");
-    const listPage = await readFile(resolve(pagesDir, "[slug]/index.astro"), "utf8");
-
-    expect(recordsModule).toContain("export function taxonomyLabel");
-    expect(recordsModule).toContain("?? prettySlug(id)");
-    expect(homePage).toContain('taxonomyLabel("categories"');
-    expect(listPage).toContain("labelFacetsWithTaxonomy");
-  });
-});

package/src/theme.test.ts

@@ -1,76 +0,0 @@
-import { readFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { describe, expect, it } from "vitest";
-
-const astroTheme = readFileSync(resolve(import.meta.dirname, "styles.css"), "utf8");
-const scaffoldTheme = readFileSync(
-  resolve(import.meta.dirname, "../templates/default/src/styles/global.css"),
-  "utf8",
-);
-const tailwindMarkup = [
-  "components/ItemCard.astro",
-  "layouts/Header.astro",
-  "../templates/default/src/pages/submit.astro",
-].map((file) => readFileSync(resolve(import.meta.dirname, file), "utf8")).join("\n");
-const iconMarkup = readFileSync(
-  resolve(import.meta.dirname, "components/Icon.astro"),
-  "utf8",
-);
-
-describe("Astro theme contract", () => {
-  it("keeps Starlight's light and dark foundation values", () => {
-    expect(astroTheme).toContain("--grove-background: oklch(100% 0 0)");
-    expect(astroTheme).toContain("--grove-foreground: var(--color-ink-950)");
-    expect(astroTheme).toContain("--grove-background: var(--color-ink-950)");
-    expect(astroTheme).toContain("--grove-foreground: var(--color-ink-50)");
-    expect(astroTheme).toContain("--color-ink-50: oklch(98.5% 0 0)");
-    expect(astroTheme).toContain("--color-ink-950: oklch(14.5% 0 0)");
-  });
-
-  it("exposes runtime semantic colors to Tailwind", () => {
-    for (const token of [
-      "background",
-      "foreground",
-      "primary",
-      "secondary",
-      "muted",
-      "accent",
-      "border",
-      "card",
-      "popover",
-    ]) {
-      expect(astroTheme).toContain(`--color-${token}: var(--grove-${token})`);
-    }
-  });
-
-  it("uses the same system and mono font stacks as the docs", () => {
-    expect(astroTheme).toContain(
-      '--font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,',
-    );
-    expect(astroTheme).toContain(
-      "--font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,",
-    );
-    expect(astroTheme).toContain("font-family: var(--font-sans)");
-  });
-
-  it("does not duplicate package-owned foundation tokens in the scaffold", () => {
-    expect(scaffoldTheme).not.toContain("--color-ink-");
-    expect(scaffoldTheme).not.toContain("font-family:");
-    expect(scaffoldTheme).not.toContain("color-scheme:");
-  });
-
-  it("styles components in HTML with Starlight-aligned Tailwind utilities", () => {
-    expect(tailwindMarkup).toContain("rounded-[calc(var(--radius)+0.25rem)]");
-    expect(tailwindMarkup).toContain("rounded-full");
-    expect(tailwindMarkup).toContain("min-h-5");
-    expect(tailwindMarkup).toContain("h-8");
-    expect(tailwindMarkup).toContain("focus-visible:ring-3");
-    expect(astroTheme).not.toContain(".grove-card");
-    expect(astroTheme).not.toContain(".grove-btn");
-  });
-
-  it("falls back to initials when a consumer has no matching icon asset", () => {
-    expect(iconMarkup).toContain("data-grove-icon-fallback-initials");
-    expect(iconMarkup).toContain("onerror=");
-  });
-});

package/templates/default/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,33 +0,0 @@
----
-name: Bug report
-about: Something is broken on the site
-title: "[bug] "
-labels: ["bug"]
-assignees: []
----
-
-## What happened
-
-A clear, concise description of the bug.
-
-## Steps to reproduce
-
-1. Go to '…'
-2. Click on '…'
-3. Scroll down to '…'
-4. See error
-
-## What I expected
-
-A clear, concise description of what you expected to happen.
-
-## What I saw
-
-Screenshots, error messages, console output — anything that helps.
-
-## Environment
-
-- Browser:
-- OS:
-- Page URL:
-- Viewport size (rough):

package/templates/default/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,20 +0,0 @@
----
-name: Feature request
-about: Suggest an improvement to the site
-title: "[feature] "
-labels: ["enhancement"]
-assignees: []
----
-
-## The problem
-
-What's missing or awkward today?
-
-## The proposed solution
-
-What would you like to see? Mockups, links, references — anything
-that helps us understand the shape of the change.
-
-## Alternatives considered
-
-Any other approaches you weighed, and why this one wins.

package/templates/default/.github/ISSUE_TEMPLATE/record_submission.md

@@ -1,48 +0,0 @@
----
-name: Submit a record
-about: Suggest a new entry for the directory
-title: "[submit] "
-labels: ["submission"]
-assignees: []
----
-
-Thanks for taking the time to suggest a new entry! Please fill in the
-template below — the more complete it is, the faster it lands.
-
-**Important:** this issue tracker is for **suggestions**, not for the
-actual data. Once approved, a maintainer will add the record to
-`data/records/<slug>.yml` (or invite you to open a PR).
-
-## 1. Basics
-
-- **Name:**
-- **One-line description:**
-- **Category:** (e.g. Mobile, Web, DevOps, AI/ML)
-- **Primary stack:** (e.g. Flutter, Vue, Go, Python)
-- **Platforms:** (e.g. iOS, Android, Web, Linux, Self-host)
-- **Project type:** (real-app, production, reference, library, tool,
-  demo, template, historical)
-- **Difficulty:** (beginner, intermediate, advanced)
-
-## 2. Links
-
-- **Repository URL:** (the canonical `https://github.com/owner/repo`)
-- **Website / homepage:**
-- **Docs:**
-
-## 3. Why it deserves a spot
-
-A short paragraph — what makes it stand out, what it's good for, who
-should look at it.
-
-## 4. Caveats
-
-Anything we should know about: license quirks, abandoned status,
-paid-only features, etc.
-
-## 5. Checkboxes
-
-- [ ] The repo is **public** on GitHub / another public forge
-- [ ] It's **open source** under an OSI-approved license
-- [ ] It has been **maintained** in the last 12 months
-- [ ] I am **not** the author (or I'm disclosing that I am)

package/templates/default/.github/pull_request_template.md

@@ -1,27 +0,0 @@
-## What this PR does
-
-A short summary of the change. One or two sentences. If it closes an
-issue, write "Closes #123" so it auto-links.
-
-## Why
-
-The motivation. Link to any relevant issues or discussions. If this
-is a UI change, attach a before/after screenshot.
-
-## How to verify
-
-Steps for a reviewer to follow:
-
-1. `pnpm install`
-2. `pnpm exec grove validate`
-3. `pnpm grove:dev` and open `…`
-4. Confirm that `…`
-
-## Checklist
-
-- [ ] `pnpm exec grove validate` passes
-- [ ] `pnpm run build` succeeds locally
-- [ ] For record changes: the `slug` is unique and matches the
-      filename (`data/records/<slug>.yml`)
-- [ ] For new categories / stacks / platforms: the field appears
-      sensibly in `Browse by category` and `Browse by stack`

package/templates/default/.github/workflows/build.yml

@@ -1,53 +0,0 @@
-name: Build
-
-on:
-  push:
-    branches: [main]
-  workflow_dispatch:
-
-jobs:
-  build:
-    name: grove build
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-    permissions:
-      contents: read
-      pages: write
-      id-token: write
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: pnpm/action-setup@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: "24"
-          cache: pnpm
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      # `build` chains build:data + build:sitemap + build:llms + astro build.
-      # Site URL is overridden so sitemap/OG/canonical links resolve to
-      # the deployed URL rather than the placeholder in grove.config.ts.
-      - name: Build site
-        env:
-          SITE_URL: ${{ vars.SITE_URL || github.pages.custom_domain || format('https://{0}.github.io/{1}', github.repository_owner, github.event.repository.name) }}
-        run: pnpm run build
-
-      - name: Setup Pages
-        uses: actions/configure-pages@v5
-
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: ./dist
-
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4
-
-      - name: Summary
-        if: success()
-        run: |
-          echo "✅ Deployed to ${{ steps.deployment.outputs.page_url }}"

package/templates/default/.github/workflows/cleanup-stale-records.yml

@@ -1,46 +0,0 @@
-name: Cleanup stale records
-
-on:
-  schedule:
-    # Monthly — first Monday 05:00 UTC. Cheap enough to run daily
-    # if you want, but most repos don't change status that often.
-    - cron: "0 5 1-7 * 1"
-  workflow_dispatch:
-
-jobs:
-  cleanup:
-    name: grove cleanup stale
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    permissions:
-      contents: read
-      issues: write
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: pnpm/action-setup@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: "24"
-          cache: pnpm
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      # `grove cleanup stale` lists records whose health signals say
-      # they need human review (archived, no commits in 12+ months,
-      # unparseable repo, etc). The report is rendered as a Markdown
-      # summary in the workflow run.
-      - name: Run cleanup report
-        id: report
-        run: pnpm exec grove cleanup stale --report > cleanup-report.md
-
-      - name: Summarise
-        run: |
-          if [ -s cleanup-report.md ]; then
-            echo "## Cleanup candidates" >> $GITHUB_STEP_SUMMARY
-            cat cleanup-report.md >> $GITHUB_STEP_SUMMARY
-          else
-            echo "✅ No records need cleanup." >> $GITHUB_STEP_SUMMARY
-          fi

package/templates/default/.github/workflows/daily-refresh.yml

@@ -1,51 +0,0 @@
-name: Daily records refresh
-
-on:
-  schedule:
-    # Daily — 06:00 UTC. Refreshes stars, forks, and the most
-    # recent commit date for every record so the home page and
-    # /apps filters stay accurate.
-    - cron: "0 6 * * *"
-  workflow_dispatch:
-
-jobs:
-  refresh:
-    name: refresh activity
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-    permissions:
-      contents: write
-      pull-requests: write
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: pnpm/action-setup@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: "24"
-          cache: pnpm
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Refresh activity
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        # `grove sync github` walks every record, fetches the
-        # latest stars/forks/pushed_at, and writes back to the
-        # corresponding yml file. Idempotent — no change if the
-        # record is already up to date.
-        run: pnpm exec grove sync github
-
-      - name: Open PR if records changed
-        uses: peter-evans/create-pull-request@v6
-        with:
-          commit-message: "chore(data): daily records refresh"
-          title: "Daily records refresh"
-          body: |
-            Automated daily refresh of stars, forks, and last-commit
-            timestamps for every record. Generated by the
-            `daily-refresh` workflow.
-          branch: chore/daily-refresh
-          delete-branch: true

package/templates/default/.github/workflows/sync-contributors.yml

@@ -1,51 +0,0 @@
-name: Sync contributors
-
-on:
-  schedule:
-    # Weekly — Sunday 04:00 UTC (after the metadata sync).
-    - cron: "0 4 * * 0"
-  workflow_dispatch:
-
-jobs:
-  sync:
-    name: sync contributors
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: pnpm/action-setup@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: "24"
-          cache: pnpm
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      # Walk the records' repoUrl fields, fetch each repo's
-      # /contributors endpoint, and write a single
-      # `data/generated/contributors.json` (consumed by the home
-      # page and /contributors page). The script lives at the root
-      # of the project — it's not a CLI command because contributor
-      # fan-in is tightly coupled to this directory's git history
-      # and doesn't generalise across forks.
-      - name: Sync contributors from GitHub
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: pnpm exec grove sync contributors
-
-      - name: Commit contributors.json
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          if git diff --quiet data/generated/contributors.json; then
-            echo "No changes to contributors.json"
-          else
-            git add data/generated/contributors.json
-            git commit -m "chore(data): refresh contributors"
-            git push
-          fi

package/templates/default/.github/workflows/sync-github-metadata.yml

@@ -1,56 +0,0 @@
-name: Sync GitHub metadata
-
-on:
-  schedule:
-    # Weekly — Sunday 03:00 UTC. Off-hours so PR validation has the
-    # freshest metadata by Monday morning.
-    - cron: "0 3 * * 0"
-  workflow_dispatch:
-  # Run on push to data/records/** so curators see fresh stars/forks
-  # without waiting for the weekly cron.
-  push:
-    branches: [main]
-    paths:
-      - "data/records/**"
-
-jobs:
-  sync:
-    name: grove sync github
-    runs-on: ubuntu-latest
-    timeout-minutes: 20
-    permissions:
-      contents: write
-      pull-requests: write
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: pnpm/action-setup@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: "24"
-          cache: pnpm
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Sync GitHub metadata
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        # `grove sync github` walks every record, fetches stars/forks/
-        # activity from the GitHub API, and writes a `github` block
-        # back into each record's YAML. Falls back to HTML scraping
-        # when the API rate-limits.
-        run: pnpm exec grove sync github
-
-      - name: Open PR if records changed
-        uses: peter-evans/create-pull-request@v6
-        with:
-          commit-message: "chore(data): sync GitHub metadata"
-          title: "Weekly GitHub metadata sync"
-          body: |
-            Automated weekly sync of stars, forks, activity, and topics
-            for every record. Generated by the `sync-github-metadata`
-            workflow.
-          branch: chore/sync-github-metadata
-          delete-branch: true

package/templates/default/.github/workflows/validate-data.yml

@@ -1,33 +0,0 @@
-name: Validate data
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  validate:
-    name: grove validate
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: pnpm/action-setup@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: "24"
-          cache: pnpm
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Validate records
-        # `grove validate` checks every records/*.yml against the
-        # blueprint schema, plus decisions.yml, taxonomy, and the
-        # health block. --strict fails on warnings, used on the
-        # main branch but not on PRs (where external contributors
-        # may have minor warnings we'd rather flag than block).
-        run: pnpm exec grove validate

package/templates/default/astro.config.mjs

@@ -1,25 +0,0 @@
-// @ts-check
-// SPDX-License-Identifier: MIT
-import { defineConfig } from 'astro/config';
-import tailwindcss from '@tailwindcss/vite';
-import groveAstro from '@grove-dev/astro';
-
-// `site` is the canonical URL the build uses for absolute links
-// (sitemap, OpenGraph, canonical tags, JSON-LD). The CLI injects
-// `grove.config.ts` → `site.url` at scaffold time, but it can also
-// be overridden per-build via the `SITE_URL` env var.
-//
-// The sitemap is generated by the CLI's `grove sitemap` command
-// into `public/sitemap.xml`; the public URL is exactly `/sitemap.xml`
-// (no `-index.xml` suffix).
-export default defineConfig({
-  site: process.env.SITE_URL || 'https://example.com',
-  trailingSlash: 'ignore',
-  integrations: [groveAstro()],
-  vite: {
-    plugins: [tailwindcss()],
-  },
-  build: {
-    format: 'directory',
-  },
-});