@grove-dev/astro 0.1.5 → 0.2.5

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/index.d.ts

@@ -1,26 +1,5 @@
-/**
- * @grove-dev/astro — Astro UI primitives for Grove.
- *
- * This package only owns Astro components, layouts, styles, and
- * Astro-specific integrations. Generic filter/sort/stats/score
- * helpers live in `@grove-dev/ui` and are re-exported from here for
- * convenience.
- *
- * Templates (concrete pages, layouts, public/, .github/) are not
- * published; they're copied into user projects by `grove new`.
- */
-export * from "@grove-dev/ui";
-export { default as ItemCard } from "./components/ItemCard.astro";
-export { default as CategoryGrid } from "./components/CategoryGrid.astro";
-export { default as HealthBadge } from "./components/HealthBadge.astro";
-export { default as ScoreBars } from "./components/ScoreBars.astro";
-export { default as DirectoryHero } from "./components/DirectoryHero.astro";
-export { default as DirectoryFilters } from "./components/DirectoryFilters.astro";
-export { default as ActiveFilterChips } from "./components/ActiveFilterChips.astro";
-export { default as LensTabs } from "./components/LensTabs.astro";
-export { default as MethodologyPanel } from "./components/MethodologyPanel.astro";
-export { default as Pagination } from "./components/Pagination.astro";
-export { default as ProjectDetail } from "./components/ProjectDetail.astro";
-export { default as SubmitDraft } from "./components/SubmitDraft.astro";
-export { default as BaseLayout } from "./layouts/BaseLayout.astro";
+import type { AstroIntegration } from "astro";
+export * from "@grove-dev/core";
+export * from "./lib/index.js";
+export default function groveAstro(): AstroIntegration;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,eAAe,CAAC;AAE9B,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAE9C,cAAc,iBAAiB,CAAC;AAMhC,cAAc,gBAAgB,CAAC;AAW/B,MAAM,CAAC,OAAO,UAAU,UAAU,IAAI,gBAAgB,CAuBrD"}

package/dist/index.js

@@ -1,26 +1,60 @@
 /**
- * @grove-dev/astro — Astro UI primitives for Grove.
+ * @grove-dev/astro — Astro framework adapter for Grove.
  *
- * This package only owns Astro components, layouts, styles, and
- * Astro-specific integrations. Generic filter/sort/stats/score
- * helpers live in `@grove-dev/ui` and are re-exported from here for
- * convenience.
- *
- * Templates (concrete pages, layouts, public/, .github/) are not
- * published; they're copied into user projects by `grove new`.
+ * Provides:
+ *  - `default` export: an Astro integration that wires the
+ *    `@grove-dev/astro/components/*` and `@grove-dev/astro/layouts/*`
+ *    subpath imports into Vite so consumer projects can write:
+ *        import ItemCard from "@grove-dev/astro/components/ItemCard.astro";
+ *    and have Vite resolve the source `.astro` file (the package's
+ *    `dist/` only contains TypeScript helpers, not the components
+ *    themselves).
+ *  - Re-exports the framework-agnostic `Resource` types from
+ *    `@grove-dev/core` so the component prop signatures stay
+ *    type-safe without forcing a dependency on the core package
+ *    in every consumer file.
+ *  - Re-exports the generic `lib/` helpers (search, lenses, scores,
+ *    repo, format, display, taxonomy-counts) under a single import
+ *    path so consumers can `import { ... } from "@grove-dev/astro"`.
  */
-export * from "@grove-dev/ui";
-export { default as ItemCard } from "./components/ItemCard.astro";
-export { default as CategoryGrid } from "./components/CategoryGrid.astro";
-export { default as HealthBadge } from "./components/HealthBadge.astro";
-export { default as ScoreBars } from "./components/ScoreBars.astro";
-export { default as DirectoryHero } from "./components/DirectoryHero.astro";
-export { default as DirectoryFilters } from "./components/DirectoryFilters.astro";
-export { default as ActiveFilterChips } from "./components/ActiveFilterChips.astro";
-export { default as LensTabs } from "./components/LensTabs.astro";
-export { default as MethodologyPanel } from "./components/MethodologyPanel.astro";
-export { default as Pagination } from "./components/Pagination.astro";
-export { default as ProjectDetail } from "./components/ProjectDetail.astro";
-export { default as SubmitDraft } from "./components/SubmitDraft.astro";
-export { default as BaseLayout } from "./layouts/BaseLayout.astro";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+export * from "@grove-dev/core";
+// Generic lib helpers — repo URL parsing, formatting, search /
+// facet / sort / paginate, lens application, score tiers, taxonomy
+// counts, and pretty-print display maps. All dependency-free and
+// typed against `@grove-dev/core`.
+export * from "./lib/index.js";
+const here = dirname(fileURLToPath(import.meta.url));
+// `here` is the compiled `dist/` directory. The components and
+// layouts live in the source tree (the `dist/` is for the
+// integration helper only). Walk up one level to reach `src/`
+// before resolving the subpath roots.
+const srcRoot = resolve(here, "..", "src");
+const componentsDir = resolve(srcRoot, "components");
+const layoutsDir = resolve(srcRoot, "layouts");
+export default function groveAstro() {
+    return {
+        name: "@grove-dev/astro",
+        hooks: {
+            "astro:config:setup": ({ updateConfig }) => {
+                // Alias the components/layouts source directories so
+                // consumer builds can import from
+                //   @grove-dev/astro/components/ItemCard.astro
+                // without us shipping a glob-shaped `exports` map that
+                // Vite/Rollup does not expand reliably.
+                updateConfig({
+                    vite: {
+                        resolve: {
+                            alias: {
+                                "@grove-dev/astro/components": componentsDir,
+                                "@grove-dev/astro/layouts": layoutsDir,
+                            },
+                        },
+                    },
+                });
+            },
+        },
+    };
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,eAAe,CAAC;AAE9B,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG7C,cAAc,iBAAiB,CAAC;AAEhC,+DAA+D;AAC/D,mEAAmE;AACnE,iEAAiE;AACjE,mCAAmC;AACnC,cAAc,gBAAgB,CAAC;AAE/B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,+DAA+D;AAC/D,0DAA0D;AAC1D,8DAA8D;AAC9D,sCAAsC;AACtC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3C,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AACrD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAE/C,MAAM,CAAC,OAAO,UAAU,UAAU;IAChC,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE;YACL,oBAAoB,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE;gBACzC,qDAAqD;gBACrD,kCAAkC;gBAClC,+CAA+C;gBAC/C,uDAAuD;gBACvD,wCAAwC;gBACxC,YAAY,CAAC;oBACX,IAAI,EAAE;wBACJ,OAAO,EAAE;4BACP,KAAK,EAAE;gCACL,6BAA6B,EAAE,aAAa;gCAC5C,0BAA0B,EAAE,UAAU;6BACvC;yBACF;qBACF;iBACF,CAAC,CAAC;YACL,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/layouts/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @grove-dev/astro — generic layout components.
+ *
+ * These layouts are the public, framework-agnostic shell used by
+ * every consumer page. They:
+ *
+ *   - take a `site` prop (name, tagline, nav, repoUrl) instead of
+ *     importing a `siteConfig` from a project-local path;
+ *   - compose the standard Header / Footer / Seo / Container /
+ *     SectionHeader / ThemeToggle components;
+ *   - share the `grove-theme` localStorage key for theme state.
+ *
+ * Re-exported as ESM module names. Astro resolves the
+ * `@grove-dev/astro/layouts/*` subpath import from `src/layouts/`
+ * (the package's `dist/` only contains TypeScript helpers, not the
+ * `.astro` files themselves).
+ */
+export { default as BaseLayout } from "./BaseLayout.astro";
+export { default as Container } from "./Container.astro";
+export { default as Footer } from "./Footer.astro";
+export { default as Header } from "./Header.astro";
+export { default as SectionHeader } from "./SectionHeader.astro";
+export { default as Seo } from "./Seo.astro";
+export { default as ThemeToggle } from "./ThemeToggle.astro";
+//# sourceMappingURL=index.d.ts.map

package/dist/layouts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/layouts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/layouts/index.js

@@ -0,0 +1,25 @@
+/**
+ * @grove-dev/astro — generic layout components.
+ *
+ * These layouts are the public, framework-agnostic shell used by
+ * every consumer page. They:
+ *
+ *   - take a `site` prop (name, tagline, nav, repoUrl) instead of
+ *     importing a `siteConfig` from a project-local path;
+ *   - compose the standard Header / Footer / Seo / Container /
+ *     SectionHeader / ThemeToggle components;
+ *   - share the `grove-theme` localStorage key for theme state.
+ *
+ * Re-exported as ESM module names. Astro resolves the
+ * `@grove-dev/astro/layouts/*` subpath import from `src/layouts/`
+ * (the package's `dist/` only contains TypeScript helpers, not the
+ * `.astro` files themselves).
+ */
+export { default as BaseLayout } from "./BaseLayout.astro";
+export { default as Container } from "./Container.astro";
+export { default as Footer } from "./Footer.astro";
+export { default as Header } from "./Header.astro";
+export { default as SectionHeader } from "./SectionHeader.astro";
+export { default as Seo } from "./Seo.astro";
+export { default as ThemeToggle } from "./ThemeToggle.astro";
+//# sourceMappingURL=index.js.map

package/dist/layouts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/layouts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/display.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Display-name helpers for curation labels, statuses, lenses, and
+ * sort options. Internal ids (e.g. "hot", "stale", "production-like")
+ * stay stable for URL state and data files; this module owns the
+ * mapping from id → user-facing string.
+ *
+ * Every export is dependency-free so it can be imported by both
+ * server-rendered Astro components and any client-side script.
+ *
+ * Status ids accept the `HealthStatus` union from `@grove-dev/core`
+ * plus a couple of curated composites (e.g. "needs-maintainer")
+ * that appear in URL state.
+ */
+import type { AppLabel, HealthStatus } from "@grove-dev/core";
+export type LabelId = AppLabel;
+export declare const LABEL_DISPLAY: Record<LabelId, string>;
+/** Pretty-print a slug to Title Case. Used for arbitrary slugs. */
+export declare function prettySlug(slug: string | null | undefined): string;
+/** Returns a human-readable name for a label id, or null if unknown. */
+export declare function labelDisplay(id: string | null | undefined): string | null;
+/**
+ * Canonical status display map. Includes the curated
+ * "needs-maintainer" composite that's emitted by the
+ * `needs-maintainer` lens.
+ */
+export declare const STATUS_DISPLAY: Record<string, string>;
+export declare function statusDisplay(s: HealthStatus | string | null | undefined): string;
+export declare const LENS_DISPLAY: Record<string, string>;
+export declare function lensDisplay(id: string | null | undefined): string;
+export declare const SORT_DISPLAY: Record<string, string>;
+export declare function sortDisplay(id: string | null | undefined): string;
+export declare const STATUS_OPTIONS: string[];
+//# sourceMappingURL=display.d.ts.map

package/dist/lib/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/lib/display.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACb,MAAM,iBAAiB,CAAC;AAGzB,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC;AAE/B,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAKjD,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CASlE;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAMzE;AAGD;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAYjD,CAAC;AAEF,wBAAgB,aAAa,CAC3B,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAC1C,MAAM,CAGR;AAGD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAO/C,CAAC;AAEF,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGjE;AAGD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM/C,CAAC;AAEF,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGjE;AAMD,eAAO,MAAM,cAAc,EAAE,MAAM,EAOlC,CAAC"}

package/dist/lib/display.js

@@ -0,0 +1,104 @@
+/**
+ * Display-name helpers for curation labels, statuses, lenses, and
+ * sort options. Internal ids (e.g. "hot", "stale", "production-like")
+ * stay stable for URL state and data files; this module owns the
+ * mapping from id → user-facing string.
+ *
+ * Every export is dependency-free so it can be imported by both
+ * server-rendered Astro components and any client-side script.
+ *
+ * Status ids accept the `HealthStatus` union from `@grove-dev/core`
+ * plus a couple of curated composites (e.g. "needs-maintainer")
+ * that appear in URL state.
+ */
+export const LABEL_DISPLAY = {
+    new: "Recently added",
+    hot: "Trending",
+    mature: "Established",
+    featured: "Featured",
+};
+/** Pretty-print a slug to Title Case. Used for arbitrary slugs. */
+export function prettySlug(slug) {
+    if (!slug)
+        return "";
+    return slug
+        .replace(/[-_]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .split(" ")
+        .map((w) => (w ? w[0].toUpperCase() + w.slice(1) : ""))
+        .join(" ");
+}
+/** Returns a human-readable name for a label id, or null if unknown. */
+export function labelDisplay(id) {
+    if (!id)
+        return null;
+    if (id in LABEL_DISPLAY) {
+        return LABEL_DISPLAY[id];
+    }
+    return prettySlug(id);
+}
+// ── Status ids (the `health.status` field on a record) ───────────
+/**
+ * Canonical status display map. Includes the curated
+ * "needs-maintainer" composite that's emitted by the
+ * `needs-maintainer` lens.
+ */
+export const STATUS_DISPLAY = {
+    active: "Active",
+    mature: "Mature",
+    stale: "Not recently active",
+    inactive: "Inactive",
+    archived: "Archived",
+    unknown: "Unknown",
+    historical: "Historical",
+    needs_review: "Needs review",
+    quiet: "Quiet",
+    unavailable: "Unavailable",
+    "needs-maintainer": "Needs maintainer",
+};
+export function statusDisplay(s) {
+    if (!s)
+        return STATUS_DISPLAY.unknown;
+    return STATUS_DISPLAY[s] ?? prettySlug(s);
+}
+// ── Lens ids (the curated tabs on /projects) ─────────────────────
+export const LENS_DISPLAY = {
+    all: "All",
+    hot: "Trending",
+    new: "Recently added",
+    mature: "Established",
+    featured: "Featured",
+    "needs-review": "Needs review",
+};
+export function lensDisplay(id) {
+    if (!id)
+        return LENS_DISPLAY.all;
+    return LENS_DISPLAY[id] ?? prettySlug(id);
+}
+// ── Sort ids (the /projects sort dropdown) ───────────────────────
+export const SORT_DISPLAY = {
+    "recently-updated": "Recently updated",
+    "most-starred": "Most starred",
+    "recently-added": "Recently added",
+    "best-overall": "Best overall",
+    alphabetical: "Alphabetical",
+};
+export function sortDisplay(id) {
+    if (!id)
+        return SORT_DISPLAY["recently-updated"];
+    return SORT_DISPLAY[id] ?? prettySlug(id);
+}
+// ── Status option list (used by filter dropdowns) ───────────────
+// "needs-maintainer" is included even though it's a derived/composite
+// status — filter dropdowns and chip rendering need to offer it
+// alongside the raw HealthStatus values.
+export const STATUS_OPTIONS = [
+    "active",
+    "quiet",
+    "stale",
+    "needs-maintainer",
+    "archived",
+    "unknown",
+];
+//# sourceMappingURL=display.js.map

package/dist/lib/display.js.map

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

package/dist/lib/format.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared formatting helpers.
+ *
+ * Dependency-free — importable by both server-rendered Astro
+ * components and any future client-side script. No `Intl`-heavy
+ * calls that would explode the client bundle.
+ */
+/**
+ * Format a number compactly: 1234 → "1.2k", 12345 → "12k", 79 → "79".
+ * Used for hero/header star counts and other large-num displays.
+ */
+export declare function compact(n: number): string;
+/**
+ * Format a star count compactly. Returns `null` when input is not a
+ * finite number, so callers can render "—" without an extra guard.
+ */
+export declare function formatStars(n: number | null | undefined): string | null;
+/**
+ * Format an ISO date as a human "Xd ago" / "Xmo ago" / "Xy ago" string.
+ * Returns "—" for missing or invalid input, and "today" for future
+ * dates (which can happen with bad upstream timestamps).
+ */
+export declare function formatRelative(date: string | null | undefined): string;
+/**
+ * Format an ISO date as a localized short date (e.g. "Jan 5, 2026").
+ * Returns the original string for unparseable input, or "—" when
+ * no value is provided.
+ */
+export declare function formatDate(date: string | null | undefined): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/lib/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAMzC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGvE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CActE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CASlE"}

package/dist/lib/format.js

@@ -0,0 +1,73 @@
+/**
+ * Shared formatting helpers.
+ *
+ * Dependency-free — importable by both server-rendered Astro
+ * components and any future client-side script. No `Intl`-heavy
+ * calls that would explode the client bundle.
+ */
+/**
+ * Format a number compactly: 1234 → "1.2k", 12345 → "12k", 79 → "79".
+ * Used for hero/header star counts and other large-num displays.
+ */
+export function compact(n) {
+    if (n >= 1000) {
+        const k = n / 1000;
+        return (k >= 10 ? Math.round(k).toString() : k.toFixed(1)) + "k";
+    }
+    return n.toString();
+}
+/**
+ * Format a star count compactly. Returns `null` when input is not a
+ * finite number, so callers can render "—" without an extra guard.
+ */
+export function formatStars(n) {
+    if (typeof n !== "number" || !Number.isFinite(n))
+        return null;
+    return compact(n);
+}
+/**
+ * Format an ISO date as a human "Xd ago" / "Xmo ago" / "Xy ago" string.
+ * Returns "—" for missing or invalid input, and "today" for future
+ * dates (which can happen with bad upstream timestamps).
+ */
+export function formatRelative(date) {
+    if (!date)
+        return "—";
+    const d = new Date(date);
+    if (Number.isNaN(d.valueOf()))
+        return "—";
+    const days = Math.floor((Date.now() - d.valueOf()) / (1000 * 60 * 60 * 24));
+    if (days <= 0)
+        return "today";
+    if (days === 1)
+        return "1d ago";
+    if (days < 30)
+        return `${days}d ago`;
+    const months = Math.floor(days / 30);
+    if (months === 1)
+        return "1mo ago";
+    if (months < 12)
+        return `${months}mo ago`;
+    const years = Math.floor(months / 12);
+    if (years === 1)
+        return "1y ago";
+    return `${years}y ago`;
+}
+/**
+ * Format an ISO date as a localized short date (e.g. "Jan 5, 2026").
+ * Returns the original string for unparseable input, or "—" when
+ * no value is provided.
+ */
+export function formatDate(date) {
+    if (!date)
+        return "—";
+    const d = new Date(date);
+    if (Number.isNaN(d.valueOf()))
+        return date;
+    return d.toLocaleDateString("en-US", {
+        year: "numeric",
+        month: "short",
+        day: "numeric",
+    });
+}
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QACd,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACnB,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACnE,CAAC;IACD,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAA4B;IACtD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAA+B;IAC5D,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IACtB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5E,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9B,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChC,IAAI,IAAI,GAAG,EAAE;QAAE,OAAO,GAAG,IAAI,OAAO,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACnC,IAAI,MAAM,GAAG,EAAE;QAAE,OAAO,GAAG,MAAM,QAAQ,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACtC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACjC,OAAO,GAAG,KAAK,OAAO,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAA+B;IACxD,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IACtB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE;QACnC,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,SAAS;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @grove-dev/astro — framework-agnostic lib helpers.
+ *
+ * Re-exports every helper that the showcase component library
+ * (and any future consumer) can use to:
+ *
+ *   - parse GitHub repo URLs (`lib/repo`)
+ *   - format counts, dates, stars (`lib/format`)
+ *   - apply curated lenses / facets / search filters (`lib/lenses`,
+ *     `lib/search`)
+ *   - render score bars (`lib/scores`)
+ *   - compute taxonomy counts at build time (`lib/taxonomy-counts`)
+ *   - pretty-print slugs and label/lens/sort/status ids (`lib/display`)
+ *
+ * All helpers are pure, dependency-free, and typed against
+ * `@grove-dev/core` (specifically `ProjectRecord` for the index
+ * payload and the `Score` / `HealthStatus` unions).
+ */
+export * from "./repo.js";
+export * from "./format.js";
+export * from "./lenses.js";
+export * from "./search.js";
+export * from "./scores.js";
+export * from "./taxonomy-counts.js";
+export * from "./display.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

package/dist/lib/index.js

@@ -0,0 +1,26 @@
+/**
+ * @grove-dev/astro — framework-agnostic lib helpers.
+ *
+ * Re-exports every helper that the showcase component library
+ * (and any future consumer) can use to:
+ *
+ *   - parse GitHub repo URLs (`lib/repo`)
+ *   - format counts, dates, stars (`lib/format`)
+ *   - apply curated lenses / facets / search filters (`lib/lenses`,
+ *     `lib/search`)
+ *   - render score bars (`lib/scores`)
+ *   - compute taxonomy counts at build time (`lib/taxonomy-counts`)
+ *   - pretty-print slugs and label/lens/sort/status ids (`lib/display`)
+ *
+ * All helpers are pure, dependency-free, and typed against
+ * `@grove-dev/core` (specifically `ProjectRecord` for the index
+ * payload and the `Score` / `HealthStatus` unions).
+ */
+export * from "./repo.js";
+export * from "./format.js";
+export * from "./lenses.js";
+export * from "./search.js";
+export * from "./scores.js";
+export * from "./taxonomy-counts.js";
+export * from "./display.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

package/dist/lib/lenses.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Curated lenses for the list / discovery page.
+ *
+ * A lens is a single-select view that translates into a (possibly
+ * empty) URL search-param filter. The 6 lenses below cover the
+ * "what should I look at next?" mental shortcut:
+ *
+ *   - "all"          — no filter
+ *   - "hot"          — recent attention: stars ≥ 1000 OR pushed within 30d
+ *   - "new"          — fresh entries: pushed within 7d OR curated "new" label
+ *   - "mature"       — long-running projects: curated tier AND pushed > 365d ago
+ *   - "featured"     — curated "featured" label
+ *   - "needs-review" — cleanup candidate (stale / archived / etc.)
+ *
+ * The lens id is what shows up in the URL as `?lens=...`. Filter
+ * resolution happens in `lib/search.ts` (`filterApps`).
+ *
+ * Keep this list in sync with `lib/search.ts` and any UI tabs.
+ */
+import type { HealthStatus, ProjectRecord } from "@grove-dev/core";
+export type LensId = "all" | "hot" | "new" | "mature" | "featured" | "needs-review";
+export interface LensDef {
+    id: LensId;
+    label: string;
+    description: string;
+    /**
+     * Returns true when the record matches this lens. Designed to
+     * operate on the index payload (`toIndexRecord`) shape — the
+     * same record the list page already holds — so consumers don't
+     * need to do a second fetch.
+     */
+    match: (record: AppLike) => boolean;
+}
+/**
+ * The shape that lens matching actually reads. Decoupled from
+ * `ProjectRecord` so the search lib can also pass the index payload
+ * (which omits a few heavy fields) and tests can pass minimal
+ * fixtures.
+ */
+export interface AppLike {
+    curation?: {
+        labels?: string[];
+    };
+    health?: {
+        status?: HealthStatus;
+        tier?: "curated" | "listed" | "experimental" | "hidden";
+        cleanupCandidate?: boolean;
+    };
+    github?: {
+        stars?: number;
+        pushedAt?: string | null;
+    };
+}
+export declare const LENSES: LensDef[];
+/**
+ * The lenses rendered as top-row tabs on the list page. Order
+ * matters — left to right. Keep this in sync with what the design
+ * calls for; URL deep-linking accepts any `LensId` even if it's not
+ * in the primary row.
+ */
+export declare const PRIMARY_LENSES: LensId[];
+export declare function lensById(id: string | null | undefined): LensDef | undefined;
+export declare function isPrimaryLens(id: string | null | undefined): id is LensId;
+/**
+ * Resolve the active lens from URL search params. Returns the empty
+ * string when no `lens=...` is set, so callers can treat both
+ * "absent" and "unknown" identically.
+ */
+export declare function lensFromSearchParams(params: URLSearchParams): LensId | "";
+/**
+ * `true` when the URL search params currently reflect this lens's
+ * filter shape. The "all" lens is the implicit "no filter" state —
+ * it's active only when no other lens-shaped params are present.
+ */
+export declare function isLensActive(lensId: LensId, params: URLSearchParams): boolean;
+/**
+ * Build a `href` for a lens tab. Selecting a lens resets the other
+ * "view" params (label, page) and applies only the chosen lens's
+ * filter. Other filters (q, stack, platform, category, sort) are
+ * preserved.
+ *
+ * `pathPrefix` is the URL root for the list page — typically
+ * `/projects` for the project-directory blueprint, `/resources` for
+ * resource-hub, `/entities` for ecosystem-map. Defaults to `/`.
+ */
+export declare function hrefForLens(lensId: LensId, params: URLSearchParams, pathPrefix?: string): string;
+/**
+ * Apply the lens filter to a record array. When `lensId` is
+ * `""` (no lens) or `"all"`, returns the input unchanged.
+ *
+ * Type-parameterized so the same helper works on `ProjectRecord[]`
+ * and on the lighter index payload that list pages ship.
+ */
+export declare function applyLens<T extends AppLike>(records: T[], lensId: LensId | ""): T[];
+export type { ProjectRecord };
+//# sourceMappingURL=lenses.d.ts.map