@grove-dev/core 0.7.0 → 0.9.0

package/dist/directory-scores.js

@@ -25,40 +25,40 @@ export function scoreTier(n) {
 export function scoreTierLabel(n) {
     switch (scoreTier(n)) {
         case 0:
-            return "Very low";
+            return 'Very low';
         case 1:
-            return "Low";
+            return 'Low';
         case 2:
-            return "Medium";
+            return 'Medium';
         case 3:
-            return "High";
+            return 'High';
         case 4:
-            return "Very high";
+            return 'Very high';
     }
 }
 /** Short numeric label used inline next to a score bar, e.g. "82". */
 export function scoreLabel(n) {
-    if (typeof n !== "number")
-        return "—";
+    if (typeof n !== 'number')
+        return '—';
     return Math.round(n).toString();
 }
 /** Order of score dimensions, used by both list and detail. */
 export const SCORE_DIMENSIONS = [
-    "activity",
-    "maturity",
-    "learning",
-    "contribution",
-    "docs",
-    "overall",
+    'activity',
+    'maturity',
+    'learning',
+    'contribution',
+    'docs',
+    'overall',
 ];
 /** Human-readable label for a score dimension. */
 export const SCORE_LABELS = {
-    activity: "Activity",
-    maturity: "Maturity",
-    learning: "Learning",
-    contribution: "Contribution",
-    docs: "Docs",
-    overall: "Overall",
+    activity: 'Activity',
+    maturity: 'Maturity',
+    learning: 'Learning',
+    contribution: 'Contribution',
+    docs: 'Docs',
+    overall: 'Overall',
 };
 /**
  * Reasoning copy per dimension, surfaced in the detail page so the
@@ -66,11 +66,11 @@ export const SCORE_LABELS = {
  * curation.notes on each item carries the longer story.
  */
 export const SCORE_REASONING = {
-    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.",
+    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.',
 };
 //# sourceMappingURL=directory-scores.js.map

package/dist/directory-scores.js.map

@@ -1 +1 @@
-{"version":3,"file":"directory-scores.js","sourceRoot":"","sources":["../src/directory-scores.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC;IACrB,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC;IACrB,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC;IACrB,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC;IACrB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,QAAQ,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC;YACJ,OAAO,UAAU,CAAC;QACpB,KAAK,CAAC;YACJ,OAAO,KAAK,CAAC;QACf,KAAK,CAAC;YACJ,OAAO,QAAQ,CAAC;QAClB,KAAK,CAAC;YACJ,OAAO,MAAM,CAAC;QAChB,KAAK,CAAC;YACJ,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,UAAU,CAAC,CAAqB;IAC9C,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAClC,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,gBAAgB,GAAwB;IACnD,UAAU;IACV,UAAU;IACV,UAAU;IACV,cAAc;IACd,MAAM;IACN,SAAS;CACV,CAAC;AAEF,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAoC;IAC3D,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoC;IAC9D,QAAQ,EACN,4EAA4E;IAC9E,QAAQ,EACN,iFAAiF;IACnF,QAAQ,EACN,gFAAgF;IAClF,YAAY,EACV,sGAAsG;IACxG,IAAI,EACF,iFAAiF;IACnF,OAAO,EACL,8EAA8E;CACjF,CAAC"}
+{"version":3,"file":"directory-scores.js","sourceRoot":"","sources":["../src/directory-scores.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC;IACrB,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC;IACrB,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC;IACrB,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC;IACrB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,QAAQ,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC;YACJ,OAAO,UAAU,CAAC;QACpB,KAAK,CAAC;YACJ,OAAO,KAAK,CAAC;QACf,KAAK,CAAC;YACJ,OAAO,QAAQ,CAAC;QAClB,KAAK,CAAC;YACJ,OAAO,MAAM,CAAC;QAChB,KAAK,CAAC;YACJ,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,UAAU,CAAC,CAAqB;IAC9C,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAClC,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,gBAAgB,GAAwB;IACnD,UAAU;IACV,UAAU;IACV,UAAU;IACV,cAAc;IACd,MAAM;IACN,SAAS;CACV,CAAC;AAEF,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAoC;IAC3D,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoC;IAC9D,QAAQ,EAAE,4EAA4E;IACtF,QAAQ,EAAE,iFAAiF;IAC3F,QAAQ,EAAE,gFAAgF;IAC1F,YAAY,EACV,sGAAsG;IACxG,IAAI,EAAE,iFAAiF;IACvF,OAAO,EAAE,8EAA8E;CACxF,CAAC"}

package/dist/directory-search.d.ts

@@ -1,4 +1,4 @@
-import type { IndexRecord } from "./schema.js";
+import type { IndexRecord } from './schema.js';
 /**
  * URL-driven filter state for the /items discovery page.
  *
@@ -38,7 +38,7 @@ export declare const SORT_OPTIONS: readonly [{
     readonly value: "alphabetical";
     readonly label: "Alphabetical";
 }];
-export type IndexSort = (typeof SORT_OPTIONS)[number]["value"];
+export type IndexSort = (typeof SORT_OPTIONS)[number]['value'];
 /**
  * Read filters from a URLSearchParams (or anything URLSearchParams-shaped,
  * e.g. the result of `new URL(req.url).searchParams`).
@@ -66,7 +66,7 @@ export declare function totalPages(itemCount: number, pageSize?: number): number
  * component and the client-side rebuild in `DirectoryIndexClient`
  * so the two never drift.
  */
-export declare function paginationPageList(active: number, count: number): Array<number | "ellipsis">;
+export declare function paginationPageList(active: number, count: number): Array<number | 'ellipsis'>;
 /** Resolve the effective sort from a filters object, applying default. */
 export declare function effectiveSort(f: IndexFilters): IndexSort;
 /** Resolve the effective page from a filters object, applying default. */
@@ -160,7 +160,7 @@ export declare function buildFacets(items: IndexRecord[], options?: {
      * in the default count-desc-then-alpha order. Curated tag ids
      * (topics.yml) flow through the `tags` key the same way.
      */
-    order?: Partial<Record<"stacks" | "platforms" | "categories" | "tags" | "licenses", string[]>>;
+    order?: Partial<Record<'stacks' | 'platforms' | 'categories' | 'tags' | 'licenses', string[]>>;
 }): {
     stacks: {
         value: string;

package/dist/directory-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directory-search.d.ts","sourceRoot":"","sources":["../src/directory-search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"directory-search.d.ts","sourceRoot":"","sources":["../src/directory-search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;EAMf,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC;AAoB/D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,eAAe,GAAG,YAAY,CA6BzE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,YAAY,GAAG,eAAe,CAcxE;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAYrD;AAED,2EAA2E;AAC3E,eAAO,MAAM,SAAS,KAAoB,CAAC;AA4C3C,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,EAAE,CAyC9E;AAED,iDAAiD;AACjD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,CAAC,EAAE,CAG/E;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,MAAM,CAE1E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAW5F;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,CAAC,EAAE,YAAY,GAAG,SAAS,CAExD;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,YAAY,GAAG,WAAW,EAAE,CAgHlF;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,EAAE,UAAU,SAAK,GAAG,MAAM,CAGvE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,SAAK,GAAG,MAAM,CAElF;AAED,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,YAAY,EAAE,UAAU,SAAK,GAAG,MAAM,CAE9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,SAAS,CAAC,CAAC;AAEvF,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,YAAY,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,YAAY,EACf,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,aAAa,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9D,UAAU,EAAE,CAkDd;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,CAAC,EAAE,YAAY,EACf,GAAG,EAAE,MAAM,YAAY,EACvB,KAAK,EAAE,MAAM,GACZ,YAAY,CAsBd;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;CAChG;;eAuF2C,MAAM;eAAS,MAAM;;;eAArB,MAAM;eAAS,MAAM;;;eAArB,MAAM;eAAS,MAAM;;;eAArB,MAAM;eAAS,MAAM;;;;;;;eAArB,MAAM;eAAS,MAAM;;EAqBlE"}

package/dist/directory-search.js

@@ -1,27 +1,27 @@
-import { labelDisplay, lensDisplay, statusDisplay } from "./directory-display.js";
+import { labelDisplay, lensDisplay, statusDisplay } from './directory-display.js';
 /** Available sort orders, in UI order. */
 export const SORT_OPTIONS = [
-    { value: "recently-updated", label: "Recently updated" },
-    { value: "most-starred", label: "Most starred" },
-    { value: "recently-added", label: "Recently added" },
-    { value: "best-overall", label: "Best overall" },
-    { value: "alphabetical", label: "Alphabetical" },
+    { value: 'recently-updated', label: 'Recently updated' },
+    { value: 'most-starred', label: 'Most starred' },
+    { value: 'recently-added', label: 'Recently added' },
+    { value: 'best-overall', label: 'Best overall' },
+    { value: 'alphabetical', label: 'Alphabetical' },
 ];
-const DEFAULT_SORT = "recently-updated";
+const DEFAULT_SORT = 'recently-updated';
 const DEFAULT_PAGE = 1;
 const DEFAULT_PAGE_SIZE = 20;
 const KEYS = {
-    q: "q",
-    stacks: "stack",
-    platforms: "platform",
-    categories: "category",
-    tags: "tag",
-    labels: "label",
-    licenses: "license",
-    statuses: "status",
-    lens: "lens",
-    sort: "sort",
-    page: "page",
+    q: 'q',
+    stacks: 'stack',
+    platforms: 'platform',
+    categories: 'category',
+    tags: 'tag',
+    labels: 'label',
+    licenses: 'license',
+    statuses: 'status',
+    lens: 'lens',
+    sort: 'sort',
+    page: 'page',
 };
 /**
  * Read filters from a URLSearchParams (or anything URLSearchParams-shaped,
@@ -30,8 +30,9 @@ const KEYS = {
 export function filtersFromSearchParams(sp) {
     const rawSort = sp.get(KEYS.sort);
     // Backwards-compat: old "most-mature" sort now maps to "best-overall".
-    const normalizedSort = rawSort === "most-mature" ? "best-overall" : rawSort;
-    const sort = normalizedSort && SORT_OPTIONS.some((o) => o.value === normalizedSort)
+    const normalizedSort = rawSort === 'most-mature' ? 'best-overall' : rawSort;
+    const sort = normalizedSort &&
+        SORT_OPTIONS.some((o) => o.value === normalizedSort)
         ? normalizedSort
         : undefined;
     const rawPage = Number(sp.get(KEYS.page));
@@ -46,7 +47,10 @@ export function filtersFromSearchParams(sp) {
         tags: sp.getAll(KEYS.tags).filter(Boolean),
         labels: sp.getAll(KEYS.labels).filter(Boolean),
         licenses: sp.getAll(KEYS.licenses).filter(Boolean),
-        statuses: sp.getAll(KEYS.statuses).flatMap((s) => s.split(",")).filter(Boolean),
+        statuses: sp
+            .getAll(KEYS.statuses)
+            .flatMap((s) => s.split(','))
+            .filter(Boolean),
         ...(lens !== null ? { lens } : {}),
         ...(sort !== undefined ? { sort } : {}),
         ...(page !== undefined ? { page } : {}),
@@ -74,7 +78,7 @@ export function searchParamsFromFilters(f) {
     for (const v of f.licenses ?? [])
         sp.append(KEYS.licenses, v);
     if (f.statuses?.length)
-        sp.set(KEYS.statuses, f.statuses.join(","));
+        sp.set(KEYS.statuses, f.statuses.join(','));
     if (f.lens)
         sp.set(KEYS.lens, f.lens);
     if (f.sort && f.sort !== DEFAULT_SORT)
@@ -105,37 +109,64 @@ export const PAGE_SIZE = DEFAULT_PAGE_SIZE;
  * than vanishing.
  */
 function recordName(record) {
-    return record.kind === "resource" ? record.title : record.name;
+    return record.kind === 'resource' ? record.title : record.name;
 }
 function projectStars(record) {
-    return record.kind === "project" ? record.github?.stars ?? 0 : 0;
+    return record.kind === 'project' ? (record.github?.stars ?? 0) : 0;
 }
 function recordUpdatedAt(record) {
-    if (record.kind === "project")
+    if (record.kind === 'project')
         return record.github?.pushedAt ?? null;
-    if (record.kind === "resource")
+    if (record.kind === 'resource')
         return record.publishedAt ?? null;
     return null;
 }
+/**
+ * When the record joined the directory.
+ *
+ * `addedAt` is the honest answer and the only one a record can state
+ * outright. The two fallbacks exist for records written before the
+ * field did:
+ *
+ *  - `curation.reviewedAt` — what this function used to return on its
+ *    own. It answers "when did a human last review this", not "when
+ *    was this added", so a brand-new record (reviewed: false, no date)
+ *    scored 0 and sank to the bottom of the one sort whose entire job
+ *    is to surface it. Kept only as a second-best signal.
+ *  - `github.createdAt` — the repository's own creation date. Wrong in
+ *    absolute terms (the repo predates the directory entry) but it
+ *    keeps unstamped records in a defensible order instead of a heap.
+ */
 function recordAddedAt(record) {
-    return record.curation?.reviewedAt ?? null;
+    if (record.addedAt)
+        return record.addedAt;
+    if (record.curation?.reviewedAt)
+        return record.curation.reviewedAt;
+    if (record.kind === 'project')
+        return record.github?.createdAt ?? null;
+    return null;
 }
 export function applySort(items, sort) {
     const arr = items.slice();
     const ts = (s) => (s ? new Date(s).valueOf() : 0);
     switch (sort) {
-        case "most-starred":
+        case 'most-starred':
             arr.sort((a, b) => projectStars(b) - projectStars(a));
             break;
-        case "recently-updated":
-            arr.sort((a, b) => ts(recordUpdatedAt(b)) - ts(recordUpdatedAt(a)));
+        // Date sorts break ties by name. Without it every record missing
+        // the key shares score 0 and the tail comes out in whatever order
+        // the index happened to be built in — stable, but arbitrary, and
+        // it reads as a bug to anyone paging that far.
+        case 'recently-updated':
+            arr.sort((a, b) => ts(recordUpdatedAt(b)) - ts(recordUpdatedAt(a)) ||
+                recordName(a).localeCompare(recordName(b)));
             break;
-        case "recently-added":
-            arr.sort((a, b) => ts(recordAddedAt(b)) - ts(recordAddedAt(a)));
+        case 'recently-added':
+            arr.sort((a, b) => ts(recordAddedAt(b)) - ts(recordAddedAt(a)) || recordName(a).localeCompare(recordName(b)));
             break;
-        case "best-overall": {
+        case 'best-overall': {
             const reviewed = (a) => (a.curation?.reviewed ? 1 : 0);
-            const visible = (a) => (a.visibility === "keep" ? 1 : 0);
+            const visible = (a) => (a.visibility === 'keep' ? 1 : 0);
             arr.sort((a, b) => {
                 const reviewedDelta = reviewed(b) - reviewed(a);
                 if (reviewedDelta !== 0)
@@ -147,7 +178,7 @@ export function applySort(items, sort) {
             });
             break;
         }
-        case "alphabetical":
+        case 'alphabetical':
             arr.sort((a, b) => recordName(a).localeCompare(recordName(b)));
             break;
     }
@@ -177,8 +208,8 @@ export function paginationPageList(active, count) {
     const result = [];
     for (const page of sorted) {
         const previous = result.at(-1);
-        if (typeof previous === "number" && page - previous > 1)
-            result.push("ellipsis");
+        if (typeof previous === 'number' && page - previous > 1)
+            result.push('ellipsis');
         result.push(page);
     }
     return result;
@@ -208,37 +239,31 @@ export function filterRecords(items, f) {
     // License ids are case-insensitive (GitHub emits `MIT`, curated ids
     // are lowercase). Normalize the filter side too so `?license=MIT`
     // and `?license=mit` are equivalent.
-    const licenses = f.licenses?.length
-        ? new Set(f.licenses.map((l) => l.toLowerCase()))
-        : null;
+    const licenses = f.licenses?.length ? new Set(f.licenses.map((l) => l.toLowerCase())) : null;
     const statuses = f.statuses?.length ? new Set(f.statuses) : null;
     return items.filter((a) => {
         // Text search — match name, owner, description, category, stack,
         // stacks, platforms, tags, backend, architecture, stateManagement,
         // bestFor, whyListed, license, status.
         if (q) {
-            const repoUrl = a.kind === "project" ? a.repoUrl : a.links.github ?? "";
-            const ownerMatch = /github\.com\/([^/]+)\//.exec(repoUrl ?? "")?.[1]?.toLowerCase() ?? "";
-            const projectFields = a.kind === "project"
+            const repoUrl = a.kind === 'project' ? a.repoUrl : (a.links.github ?? '');
+            const ownerMatch = /github\.com\/([^/]+)\//.exec(repoUrl ?? '')?.[1]?.toLowerCase() ?? '';
+            const projectFields = a.kind === 'project'
                 ? [
                     a.stack,
                     ...a.stacks,
                     ...a.platforms,
                     a.projectType,
-                    a.difficulty ?? "",
-                    a.codebaseSize ?? "",
+                    a.difficulty ?? '',
+                    a.codebaseSize ?? '',
                     ...a.bestFor,
                     ...a.whyListed,
-                    a.github?.license ?? "",
-                    a.health?.status ? statusDisplay(a.health.status) : "",
+                    a.github?.license ?? '',
+                    a.health?.status ? statusDisplay(a.health.status) : '',
                 ]
                 : [];
-            const resourceFields = a.kind === "resource"
-                ? [a.type, a.topic, a.author ?? ""]
-                : [];
-            const entityFields = a.kind === "entity"
-                ? [a.type, a.location ?? "", a.parent ?? ""]
-                : [];
+            const resourceFields = a.kind === 'resource' ? [a.type, a.topic, a.author ?? ''] : [];
+            const entityFields = a.kind === 'entity' ? [a.type, a.location ?? '', a.parent ?? ''] : [];
             const haystack = [
                 recordName(a),
                 ownerMatch,
@@ -249,20 +274,20 @@ export function filterRecords(items, f) {
                 ...resourceFields,
                 ...entityFields,
             ]
-                .join(" ")
+                .join(' ')
                 .toLowerCase();
             if (!haystack.includes(q))
                 return false;
         }
         if (stacks) {
-            if (a.kind !== "project")
+            if (a.kind !== 'project')
                 return false;
             const allStacks = [a.stack, ...a.stacks].filter((stack) => Boolean(stack));
             if (!allStacks.some((s) => stacks.has(s)))
                 return false;
         }
         if (platforms) {
-            if (a.kind !== "project")
+            if (a.kind !== 'project')
                 return false;
             if (!a.platforms.some((p) => platforms.has(p)))
                 return false;
@@ -278,7 +303,7 @@ export function filterRecords(items, f) {
                 return false;
         }
         if (licenses) {
-            if (a.kind !== "project")
+            if (a.kind !== 'project')
                 return false;
             // Curated `licenses` array takes precedence; fall back to the
             // GitHub sync's `github.license.spdx_id` (recorded as the
@@ -294,7 +319,7 @@ export function filterRecords(items, f) {
             // `[]`-suppresses-fallback semantic tested below.
             const curated = (a.licenses ?? []);
             const hasCurated = Array.isArray(a.licenses);
-            const synced = (a.github?.license ?? "").toLowerCase();
+            const synced = (a.github?.license ?? '').toLowerCase();
             const candidates = new Set();
             if (hasCurated) {
                 for (const l of curated)
@@ -309,7 +334,7 @@ export function filterRecords(items, f) {
                 return false;
         }
         if (statuses) {
-            if (a.kind !== "project")
+            if (a.kind !== 'project')
                 return false;
             const status = a.health?.status;
             if (!status || !statuses.has(status))
@@ -323,20 +348,20 @@ export function filterRecords(items, f) {
     });
 }
 /** Serialize filters back to a browsable URL under `pathPrefix`. */
-export function hrefForFilters(f, pathPrefix = "") {
+export function hrefForFilters(f, pathPrefix = '') {
     const params = searchParamsFromFilters(f);
-    return `${pathPrefix}${params.size ? `?${params}` : ""}`;
+    return `${pathPrefix}${params.size ? `?${params}` : ''}`;
 }
 /**
  * URL for a given result page, keeping every other filter. One
  * definition for the server render and the client rebuild — they had
  * drifted as two hand-rolled copies.
  */
-export function hrefForPage(f, page, pathPrefix = "") {
+export function hrefForPage(f, page, pathPrefix = '') {
     return hrefForFilters({ ...f, page }, pathPrefix);
 }
 /** URL that drops every filter but keeps the chosen sort. */
-export function hrefForClearedFilters(f, pathPrefix = "") {
+export function hrefForClearedFilters(f, pathPrefix = '') {
     return hrefForFilters({ sort: f.sort }, pathPrefix);
 }
 /**
@@ -357,18 +382,18 @@ export function pagePathHref(pathPrefix, page) {
 }
 /** Which taxonomy file backs each filter key. `tags` live in topics.yml. */
 const CHIP_TAXONOMY_KIND = {
-    stacks: "stacks",
-    platforms: "platforms",
-    categories: "categories",
-    tags: "topics",
-    licenses: "licenses",
+    stacks: 'stacks',
+    platforms: 'platforms',
+    categories: 'categories',
+    tags: 'topics',
+    licenses: 'licenses',
 };
 const CHIP_PREFIX = {
-    stacks: "Stack",
-    platforms: "Platform",
-    categories: "Category",
-    tags: "Tag",
-    licenses: "License",
+    stacks: 'Stack',
+    platforms: 'Platform',
+    categories: 'Category',
+    tags: 'Tag',
+    licenses: 'License',
 };
 /**
  * Build a flat list of "active filter" chips for display + removal.
@@ -379,48 +404,46 @@ const CHIP_PREFIX = {
  * `Stack: react-native`, the client `Stack: React Native`.
  */
 export function activeFilterChips(f, context = {}) {
-    const { taxonomy, pathPrefix = "" } = context;
+    const { taxonomy, pathPrefix = '' } = context;
     const out = [];
     const display = (key, value) => {
         const kind = CHIP_TAXONOMY_KIND[key];
-        const name = kind
-            ? taxonomy?.[kind]?.find((entry) => entry.id === value)?.name
-            : undefined;
+        const name = kind ? taxonomy?.[kind]?.find((entry) => entry.id === value)?.name : undefined;
         return `${CHIP_PREFIX[key]}: ${name ?? value}`;
     };
     if (f.q && f.q.trim()) {
-        out.push({ key: "q", value: "", label: `“${f.q}”` });
+        out.push({ key: 'q', value: '', label: `“${f.q}”` });
     }
     for (const v of f.stacks ?? []) {
-        out.push({ key: "stacks", value: v, label: display("stacks", v) });
+        out.push({ key: 'stacks', value: v, label: display('stacks', v) });
     }
     for (const v of f.platforms ?? []) {
-        out.push({ key: "platforms", value: v, label: display("platforms", v) });
+        out.push({ key: 'platforms', value: v, label: display('platforms', v) });
     }
     for (const v of f.categories ?? []) {
-        out.push({ key: "categories", value: v, label: display("categories", v) });
+        out.push({ key: 'categories', value: v, label: display('categories', v) });
     }
     for (const v of f.tags ?? []) {
-        out.push({ key: "tags", value: v, label: display("tags", v) });
+        out.push({ key: 'tags', value: v, label: display('tags', v) });
     }
     for (const v of f.labels ?? []) {
-        out.push({ key: "labels", value: v, label: labelDisplay(v) ?? v });
+        out.push({ key: 'labels', value: v, label: labelDisplay(v) ?? v });
     }
     for (const v of f.licenses ?? []) {
-        out.push({ key: "licenses", value: v, label: display("licenses", v) });
+        out.push({ key: 'licenses', value: v, label: display('licenses', v) });
     }
     if (f.lens) {
-        out.push({ key: "lens", value: f.lens, label: lensDisplay(f.lens) });
+        out.push({ key: 'lens', value: f.lens, label: lensDisplay(f.lens) });
     }
     // Status: collapse the "stale,quiet" composite into a single chip.
     if (f.statuses && f.statuses.length) {
-        const joined = f.statuses.join(",");
-        if (joined === "stale,quiet") {
-            out.push({ key: "statuses", value: "stale,quiet", label: statusDisplay("needs-maintainer") });
+        const joined = f.statuses.join(',');
+        if (joined === 'stale,quiet') {
+            out.push({ key: 'statuses', value: 'stale,quiet', label: statusDisplay('needs-maintainer') });
         }
         else {
             for (const v of f.statuses) {
-                out.push({ key: "statuses", value: v, label: statusDisplay(v) });
+                out.push({ key: 'statuses', value: v, label: statusDisplay(v) });
             }
         }
     }
@@ -439,7 +462,7 @@ export function activeFilterChips(f, context = {}) {
  */
 export function removeFilter(f, key, value) {
     let next;
-    if (key === "q" || key === "lens") {
+    if (key === 'q' || key === 'lens') {
         // Scalar filters are removed entirely rather than treated like arrays.
         const { [key]: _drop, ...rest } = f;
         next = rest;
@@ -450,9 +473,7 @@ export function removeFilter(f, key, value) {
             return f;
         // `needs-maintainer` is represented internally by the composite
         // statuses `stale,quiet`, but is displayed as one removable chip.
-        const filtered = key === "statuses" && value === "stale,quiet"
-            ? []
-            : current.filter((v) => v !== value);
+        const filtered = key === 'statuses' && value === 'stale,quiet' ? [] : current.filter((v) => v !== value);
         if (filtered.length === 0) {
             const { [key]: _drop, ...rest } = f;
             next = rest;
@@ -481,15 +502,15 @@ export function buildFacets(items, options) {
         if (!filters)
             return null;
         const next = { ...filters };
-        if (facet === "stacks")
+        if (facet === 'stacks')
             delete next.stacks;
-        if (facet === "platforms")
+        if (facet === 'platforms')
             delete next.platforms;
-        if (facet === "categories")
+        if (facet === 'categories')
             delete next.categories;
-        if (facet === "tags")
+        if (facet === 'tags')
             delete next.tags;
-        if (facet === "licenses")
+        if (facet === 'licenses')
             delete next.licenses;
         return next;
     };
@@ -505,20 +526,20 @@ export function buildFacets(items, options) {
         label: new Map(),
         license: new Map(),
     };
-    const stackScoped = itemsForFacet("stacks");
-    const platformScoped = itemsForFacet("platforms");
-    const categoryScoped = itemsForFacet("categories");
-    const tagScoped = itemsForFacet("tags");
-    const licenseScoped = itemsForFacet("licenses");
+    const stackScoped = itemsForFacet('stacks');
+    const platformScoped = itemsForFacet('platforms');
+    const categoryScoped = itemsForFacet('categories');
+    const tagScoped = itemsForFacet('tags');
+    const licenseScoped = itemsForFacet('licenses');
     for (const a of stackScoped) {
-        if (a.kind === "project") {
+        if (a.kind === 'project') {
             const allStacks = new Set([a.stack, ...a.stacks].filter((stack) => Boolean(stack)));
             for (const s of allStacks)
                 counts.stack.set(s, (counts.stack.get(s) ?? 0) + 1);
         }
     }
     for (const a of platformScoped) {
-        if (a.kind === "project") {
+        if (a.kind === 'project') {
             for (const p of a.platforms)
                 counts.platform.set(p, (counts.platform.get(p) ?? 0) + 1);
         }
@@ -533,15 +554,13 @@ export function buildFacets(items, options) {
         }
     }
     for (const a of licenseScoped) {
-        if (a.kind === "project") {
+        if (a.kind === 'project') {
             // Consult the curated `licenses` array first (lowercased for
             // facet-key consistency), then fall back to the GitHub-synced
             // SPDX id. Mirrors the filterRecords branch so facet counts
             // and filter results can never disagree.
-            const curated = (a.licenses ?? [])
-                .map((l) => l.toLowerCase())
-                .filter(Boolean);
-            const synced = (a.github?.license ?? "").toLowerCase();
+            const curated = (a.licenses ?? []).map((l) => l.toLowerCase()).filter(Boolean);
+            const synced = (a.github?.license ?? '').toLowerCase();
             const ids = curated.length ? curated : synced ? [synced] : [];
             for (const id of ids) {
                 counts.license.set(id, (counts.license.get(id) ?? 0) + 1);