@grove-dev/astro 0.2.20 → 0.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Turtuvshin Byambaa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/template-routes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=template-routes.test.d.ts.map

package/dist/template-routes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-routes.test.d.ts","sourceRoot":"","sources":["../src/template-routes.test.ts"],"names":[],"mappings":""}

package/dist/template-routes.test.js

@@ -0,0 +1,63 @@
+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"));
+        const manifest = JSON.parse(await readFile(resolve(templateRoot, "package.json"), "utf8"));
+        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"));
+        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");
+    });
+});
+//# sourceMappingURL=template-routes.test.js.map

package/dist/template-routes.test.js.map

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

package/dist/theme.test.js

@@ -8,6 +8,7 @@ const tailwindMarkup = [
     "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)");
@@ -51,5 +52,9 @@ describe("Astro theme contract", () => {
         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=");
+    });
 });
 //# sourceMappingURL=theme.test.js.map

package/dist/theme.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grove-dev/astro",
-  "version": "0.2.20",
+  "version": "0.3.1",
   "type": "module",
   "description": "Astro framework adapter for Grove. Components, layouts, design tokens, and a default template.",
   "license": "MIT",
@@ -43,9 +43,9 @@
     "./layouts/*": "./src/layouts/*.astro"
   },
   "dependencies": {
-    "@grove-dev/core": "0.2.16",
-    "@grove-dev/ui": "1.0.6",
-    "astro": "^6.4.6"
+    "astro": "^6.4.6",
+    "@grove-dev/core": "0.3.1",
+    "@grove-dev/ui": "1.1.1"
   },
   "peerDependencies": {
     "astro": "^6.0.0"

package/src/components/Icon.astro

@@ -145,29 +145,59 @@ const a11y: Record<string, string> = title
       {init || "·"}
     </span>
   ) : mode === "auto" ? (
-    <img
-      src={staticSrc}
-      data-grove-icon
-      data-grove-icon-light={`${baseUrl}-light.svg`}
-      data-grove-icon-dark={`${baseUrl}-dark.svg`}
-      data-grove-icon-fallback={staticSrc}
-      width={size}
-      height={size}
-      alt=""
-      class:list={["inline-block shrink-0 align-middle", className]}
-      {...a11y}
-    />
+    <>
+      <img
+        src={staticSrc}
+        data-grove-icon
+        data-grove-icon-light={`${baseUrl}-light.svg`}
+        data-grove-icon-dark={`${baseUrl}-dark.svg`}
+        data-grove-icon-fallback={staticSrc}
+        width={size}
+        height={size}
+        alt=""
+        class:list={["inline-block shrink-0 align-middle", className]}
+        onerror="this.hidden=true;this.nextElementSibling.hidden=false"
+        {...a11y}
+      />
+      <span
+        hidden
+        data-grove-icon-fallback-initials
+        class:list={[
+          "inline-flex shrink-0 select-none items-center justify-center rounded-sm bg-ink-100 align-middle font-semibold uppercase leading-none text-ink-700 dark:bg-ink-800 dark:text-ink-200",
+          className,
+        ]}
+        style={`width:${size}px;height:${size}px;font-size:${Math.max(10, size - 6)}px;`}
+        {...a11y}
+      >
+        {init || "·"}
+      </span>
+    </>
   ) : (
-    <img
-      src={staticSrc}
-      width={size}
-      height={size}
-      alt=""
-      class:list={["inline-block shrink-0 align-middle", className]}
-      loading="lazy"
-      decoding="async"
-      {...a11y}
-    />
+    <>
+      <img
+        src={staticSrc}
+        width={size}
+        height={size}
+        alt=""
+        class:list={["inline-block shrink-0 align-middle", className]}
+        loading="lazy"
+        decoding="async"
+        onerror="this.hidden=true;this.nextElementSibling.hidden=false"
+        {...a11y}
+      />
+      <span
+        hidden
+        data-grove-icon-fallback-initials
+        class:list={[
+          "inline-flex shrink-0 select-none items-center justify-center rounded-sm bg-ink-100 align-middle font-semibold uppercase leading-none text-ink-700 dark:bg-ink-800 dark:text-ink-200",
+          className,
+        ]}
+        style={`width:${size}px;height:${size}px;font-size:${Math.max(10, size - 6)}px;`}
+        {...a11y}
+      >
+        {init || "·"}
+      </span>
+    </>
   )
 }
 

package/src/template-routes.test.ts

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

@@ -12,6 +12,10 @@ const tailwindMarkup = [
   "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", () => {
@@ -64,4 +68,9 @@ describe("Astro theme contract", () => {
     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/workflows/build.yml

@@ -18,12 +18,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: "24"
           cache: pnpm
 
       - name: Install dependencies

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

@@ -19,12 +19,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: "24"
           cache: pnpm
 
       - name: Install dependencies

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

@@ -20,12 +20,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: "24"
           cache: pnpm
 
       - name: Install dependencies

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

@@ -17,12 +17,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: "24"
           cache: pnpm
 
       - name: Install dependencies
@@ -38,7 +36,7 @@ jobs:
       - name: Sync contributors from GitHub
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: node scripts/sync-contributors.mjs
+        run: pnpm exec grove sync contributors
 
       - name: Commit contributors.json
         run: |

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

@@ -25,12 +25,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: "24"
           cache: pnpm
 
       - name: Install dependencies

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

@@ -15,12 +15,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
-        with:
-          version: 10
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: "24"
           cache: pnpm
 
       - name: Install dependencies

package/templates/default/grove.config.ts

@@ -25,7 +25,7 @@ export default defineConfig({
 
   facets: ["category", "stacks", "platforms", "tags"],
 
-  integrations: {},
+  integrations: { github: false },
 
   theme: {
     primaryColor: "#1f6feb",

package/templates/default/package.json

@@ -13,7 +13,7 @@
     "validate:data": "grove validate",
     "build:data": "grove generate",
     "build:sitemap": "grove sitemap",
-    "build:llms": "node scripts/build-llms.mjs",
+    "build:llms": "grove llms",
     "build": "pnpm run build:data && pnpm run build:sitemap && pnpm run build:llms && astro build",
     "dev": "pnpm run build:data && astro dev",
     "start": "astro dev",
@@ -21,18 +21,23 @@
     "astro": "astro",
     "check": "astro check",
     "sync:github": "grove sync github",
+    "sync:contributors": "grove sync contributors",
     "cleanup": "grove cleanup stale"
   },
   "dependencies": {
     "@astrojs/check": "^0.9.9",
-    "@grove-dev/astro": "0.2.18",
-    "@grove-dev/cli": "0.2.16",
-    "@grove-dev/core": "0.2.16",
+    "@grove-dev/astro": "workspace:*",
+    "@grove-dev/cli": "workspace:*",
+    "@grove-dev/core": "workspace:*",
     "@tailwindcss/vite": "^4.3.0",
     "astro": "^6.4.4",
     "marked": "^18.0.0",
     "sanitize-html": "^2.17.5",
     "tailwindcss": "^4.3.0",
     "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "@types/sanitize-html": "^2.16.0"
   }
 }