@grove-dev/astro 0.2.20 → 0.3.2

package/src/lib/format.ts

@@ -1,64 +1 @@
-/**
- * Shared formatting helpers used across components.
- *
- * Keep these dependency-free so they can be imported by both server-
- * rendered Astro components and any future client-side scripts.
- */
-
-/**
- * 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: number): string {
-  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: number | null | undefined): string | null {
-  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(iso: string | null | undefined): string {
-  if (!iso) return "—";
-  const d = new Date(iso);
-  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(iso: string | null | undefined): string {
-  if (!iso) return "—";
-  const d = new Date(iso);
-  if (Number.isNaN(d.valueOf())) return iso;
-  return d.toLocaleDateString("en-US", {
-    year: "numeric",
-    month: "short",
-    day: "numeric",
-  });
-}
+export * from "@grove-dev/core";

package/src/lib/lenses.ts

@@ -1,220 +1 @@
-/**
- * Curated lenses for the list page.
- *
- * Two flavors:
- * - "label-based": maps to a single `labels` value (e.g. new / hot / mature).
- *   No extra curation needed — every item already has a label.
- * - "curator-assigned": maps to a `lenses` value on the item. The 5 anchor
- *   items get these populated. Other items will simply not match.
- *
- * The lens id is what shows up in the URL as `?lens=...`. For
- * label-based lenses, the lens id is the same as the label.
- *
- * The 6 lenses in `PRIMARY_LENSES` are rendered as top-row tabs. The rest
- * remain in the union type for URL deep-linking and future use, but are
- * not shown in the UI by default.
- */
-
-export type LensId =
-  // Label-based (tabbed)
-  | "all"
-  | "new"
-  | "hot"
-  | "mature"
-  // Curator-assigned (tabbed)
-  | "good-to-learn"
-  | "production-like"
-  // Available in URL state, but not tabbed
-  | "beginner-friendly"
-  | "contribution-ready"
-  | "launches"
-  // Status-based (available in URL state, not tabbed)
-  | "actively-developed"
-  | "needs-maintainer";
-
-export interface LensDef {
-  id: LensId;
-  label: string;
-  /** Short blurb shown when the lens is active. */
-  description?: string;
-  /** What URL state this lens implies. Empty means no filter. */
-  toParams: () => Record<string, string | string[]>;
-}
-
-export const LENSES: LensDef[] = [
-  { id: "all", label: "All items", description: "Every item in the directory", toParams: () => ({}) },
-  {
-    id: "new",
-    label: "Recently added",
-    description: "Apps recently added to the directory",
-    toParams: () => ({ label: "new" }),
-  },
-  {
-    id: "hot",
-    label: "Trending",
-    description: "Apps with recent activity and attention",
-    toParams: () => ({ label: "hot" }),
-  },
-  {
-    id: "mature",
-    label: "Established",
-    description: "Long-running projects with stable history",
-    toParams: () => ({ label: "mature" }),
-  },
-  {
-    id: "production-like",
-    label: "Production-like",
-    description: "Real items, not toy projects",
-    toParams: () => ({ lens: "production-like" }),
-  },
-  {
-    id: "good-to-learn",
-    label: "Good to learn",
-    description: "Readable codebases with useful patterns",
-    toParams: () => ({ lens: "good-to-learn" }),
-  },
-  // Secondary (URL-only, not rendered as tabs)
-  {
-    id: "beginner-friendly",
-    label: "Beginner friendly",
-    description: "Smaller, readable, easier to understand",
-    toParams: () => ({ lens: "beginner-friendly" }),
-  },
-  {
-    id: "contribution-ready",
-    label: "Contribution ready",
-    description: "Clear issues, active maintainers, license, contribution docs",
-    toParams: () => ({ lens: "contribution-ready" }),
-  },
-  {
-    id: "launches",
-    label: "Launches",
-    description: "Recently launched OSS items seeking feedback",
-    toParams: () => ({ lens: "launches" }),
-  },
-  {
-    id: "actively-developed",
-    label: "Active",
-    description: "Apps with recent commits, releases, and issue activity",
-    toParams: () => ({ status: "active" }),
-  },
-  {
-    id: "needs-maintainer",
-    label: "Needs maintainer",
-    description: "Useful items that need help",
-    toParams: () => ({ status: "stale,quiet" }),
-  },
-];
-
-/**
- * The 6 lenses shown as top-row tabs on /items. Order matters — left to right.
- * Keep this list aligned with what the design calls for: All, signal lenses,
- * and the two curator-assigned lenses that have any matches.
- */
-export const PRIMARY_LENSES: LensId[] = [
-  "all",
-  "new",
-  "hot",
-  "mature",
-  "production-like",
-  "good-to-learn",
-];
-
-export function lensById(id: string | null | undefined): LensDef | undefined {
-  if (!id) return undefined;
-  return LENSES.find((l) => l.id === id);
-}
-
-/**
- * Check whether the current URL search params match a given lens's
- * implied filter state. Used to highlight the active tab when a
- * deep-link uses the underlying filter key (e.g. ?label=hot) rather
- * than the abstract lens id (?lens=hot).
- */
-export function isLensActive(lensId: LensId, sp: URLSearchParams): boolean {
-  if (lensId === "all") {
-    // "All" is active when no lens-shaped filter is present.
-    return !lensFromSearchParams(sp) && !sp.get("label") && !sp.get("status");
-  }
-  const def = lensById(lensId);
-  if (!def) return false;
-  const target = def.toParams();
-  for (const [k, v] of Object.entries(target)) {
-    if (Array.isArray(v)) {
-      if (sp.getAll(k).length !== v.length) return false;
-      for (const item of v) if (!sp.getAll(k).includes(item)) return false;
-    } else {
-      if (sp.get(k) !== v) return false;
-    }
-  }
-  return true;
-}
-
-export function isPrimaryLens(id: string | null | undefined): boolean {
-  if (!id) return false;
-  return PRIMARY_LENSES.includes(id as LensId);
-}
-
-/**
- * Turn a lens's `toParams()` output into a URLSearchParams string
- * (with the existing query preserved, then lens params merged on top).
- */
-export function lensToQuery(id: LensId | null | undefined, current: URLSearchParams): string {
-  if (!id || id === "all") return "";
-  const def = lensById(id);
-  if (!def) return "";
-  const next = new URLSearchParams(current);
-  for (const [k, v] of Object.entries(def.toParams())) {
-    if (Array.isArray(v)) {
-      next.delete(k);
-      for (const item of v) next.append(k, item);
-    } else {
-      next.set(k, v);
-    }
-  }
-  return next.toString();
-}
-
-/**
- * Read a `?lens=...` value from URL search params.
- */
-export function lensFromSearchParams(sp: URLSearchParams): LensId | null {
-  const v = sp.get("lens");
-  if (!v) return null;
-  if (LENSES.some((l) => l.id === v)) return v as LensId;
-  return null;
-}
-
-/**
- * Build a `href` for a lens tab. Per the single-select-view rule,
- * clicking a lens resets the "view" params (lens, label, status, page)
- * and applies only the chosen lens's params. Stack/Platform/Category/
- * License/q/sort/density filters are preserved.
- */
-export function hrefForLens(
-  lensId: LensId | null | undefined,
-  current: URLSearchParams,
-  pathPrefix = "/items",
-): string {
-  const sp = new URLSearchParams(current);
-  sp.delete("lens");
-  sp.delete("label");
-  sp.delete("status");
-  sp.delete("page");
-  if (lensId && lensId !== "all") {
-    const def = lensById(lensId);
-    if (def) {
-      for (const [k, v] of Object.entries(def.toParams())) {
-        if (Array.isArray(v)) {
-          sp.delete(k);
-          for (const item of v) sp.append(k, item);
-        } else {
-          sp.set(k, v);
-        }
-      }
-    }
-  }
-  const qs = sp.toString();
-  const base = pathPrefix.replace(/\/$/, "") || "/";
-  return qs ? `${base}?${qs}` : base;
-}
+export * from "@grove-dev/core";

package/src/lib/repo.ts

@@ -1,32 +1 @@
-/**
- * Parse a GitHub repo URL into its owner and repo components.
- * Returns nulls if the URL doesn't match github.com/{owner}/{repo}.
- *
- * Used in:
- *   - ItemCard avatar fallback (owner avatar via GitHub avatars
- *     API; component name retained for V1 published API stability)
- *   - App detail page (showing owner + repo name in breadcrumb / header)
- *   - Anywhere we need to display "@owner / repo" or link to the owner
- */
-export function getOwnerAndRepoFromRepoUrl(repoUrl: string): {
-  owner: string | null;
-  repo: string | null;
-} {
-  if (!repoUrl || !repoUrl.includes("github.com/")) {
-    return { owner: null, repo: null };
-  }
-  const m = repoUrl.match(/github\.com\/([^/]+)\/([^/?#]+)/);
-  if (!m) return { owner: null, repo: null };
-  const owner = m[1] ?? null;
-  const repo = m[2]?.replace(/\.git$/, "") ?? null;
-  return { owner, repo };
-}
-
-/**
- * Build a GitHub avatar URL for a given owner.
- * Returns null if owner is null/empty.
- */
-export function getOwnerAvatarUrl(owner: string | null, size: number = 80): string | null {
-  if (!owner) return null;
-  return `https://avatars.githubusercontent.com/${owner}?v=4&s=${size}`;
-}
+export * from "@grove-dev/core";

package/src/lib/scores.ts

@@ -1,90 +1 @@
-type AppScores = {
-  activity?: number;
-  maturity?: number;
-  learning?: number;
-  contribution?: number;
-  docs?: number;
-  overall?: number;
-};
-
-/**
- * Format a single score (0-100) into a 0-5 "tier" used by the UI:
- *
- *   0-19  → 0  (very low)
- *   20-39 → 1  (low)
- *   40-59 → 2  (medium)
- *   60-79 → 3  (high)
- *   80-100 → 4 (very high)
- *
- * The list page renders each score as a 4-cell bar; this gives the
- * visual a stable shape regardless of the underlying number.
- */
-export function scoreTier(n: number): 0 | 1 | 2 | 3 | 4 {
-  if (n < 20) return 0;
-  if (n < 40) return 1;
-  if (n < 60) return 2;
-  if (n < 80) return 3;
-  return 4;
-}
-
-/** Compact textual label for a score tier (used in tooltips). */
-export function scoreTierLabel(n: number): string {
-  switch (scoreTier(n)) {
-    case 0:
-      return "Very low";
-    case 1:
-      return "Low";
-    case 2:
-      return "Medium";
-    case 3:
-      return "High";
-    case 4:
-      return "Very high";
-  }
-}
-
-/** Short numeric label used inline next to a score bar, e.g. "82". */
-export function scoreLabel(n: number | undefined): string {
-  if (typeof n !== "number") return "—";
-  return Math.round(n).toString();
-}
-
-/** Order of score dimensions, used by both list and detail. */
-export const SCORE_DIMENSIONS: (keyof AppScores)[] = [
-  "activity",
-  "maturity",
-  "learning",
-  "contribution",
-  "docs",
-  "overall",
-];
-
-/** Human-readable label for a score dimension. */
-export const SCORE_LABELS: Record<keyof AppScores, string> = {
-  activity: "Activity",
-  maturity: "Maturity",
-  learning: "Learning",
-  contribution: "Contribution",
-  docs: "Docs",
-  overall: "Overall",
-};
-
-/**
- * Reasoning copy per dimension, surfaced in the detail page so the
- * numbers don't feel magical. These are intentionally short — the
- * curation.notes on each item carries the longer story.
- */
-export const SCORE_REASONING: Record<keyof AppScores, string> = {
-  activity:
-    "Recent commits, open and merged PRs, issue response time, release cadence.",
-  maturity:
-    "Repo age, stable structure, real-world production usage, contributor stability.",
-  learning:
-    "Codebase readability, useful architecture patterns, comment quality, examples.",
-  contribution:
-    "Open issues, recent merged PRs from new contributors, maintainer responsiveness, contribution guide.",
-  docs:
-    "README quality, architecture docs, contributing guide, examples, code comments.",
-  overall:
-    "Composite judgment — how likely this item is to satisfy a curious developer.",
-};
+export * from "@grove-dev/core";