@grove-dev/core 0.5.0-next.0 → 0.5.0

package/dist/directory-display.js

@@ -8,10 +8,10 @@
  * server-rendered Astro components and any client-side script.
  */
 export const LABEL_DISPLAY = {
-    new: "Recently added",
-    hot: "Trending",
-    mature: "Established",
-    featured: "Featured",
+    new: 'Recently added',
+    hot: 'Trending',
+    mature: 'Established',
+    featured: 'Featured',
 };
 /** Returns a human-readable name for a label id, or null if unknown. */
 export function labelDisplay(id) {
@@ -26,80 +26,94 @@ export function labelDisplay(id) {
  * to "stale,quiet" in URL state but presents as one chip).
  */
 export const STATUS_DISPLAY = {
-    active: "Active",
-    mature: "Mature",
-    quiet: "Quiet",
-    stale: "Not recently active",
-    inactive: "Inactive",
-    "needs-maintainer": "Needs maintainer",
-    archived: "Archived",
-    historical: "Historical",
-    needs_review: "Needs review",
-    unavailable: "Unavailable",
-    unknown: "Unknown",
+    active: 'Active',
+    mature: 'Mature',
+    quiet: 'Quiet',
+    stale: 'Not recently active',
+    inactive: 'Inactive',
+    'needs-maintainer': 'Needs maintainer',
+    archived: 'Archived',
+    historical: 'Historical',
+    needs_review: 'Needs review',
+    unavailable: 'Unavailable',
+    unknown: 'Unknown',
 };
 export function statusDisplay(s) {
     if (!s)
-        return STATUS_DISPLAY.unknown ?? "";
-    return STATUS_DISPLAY[s] ?? STATUS_DISPLAY.unknown ?? "";
+        return STATUS_DISPLAY.unknown ?? '';
+    return STATUS_DISPLAY[s] ?? STATUS_DISPLAY.unknown ?? '';
 }
 // ── Lens ids (the curated tabs on /items) ────────────────────────────
 export const LENS_DISPLAY = {
-    all: "All items",
-    new: "Recently added",
-    hot: "Trending",
-    mature: "Established",
-    "good-to-learn": "Good to learn",
-    "production-like": "Production-like",
-    "beginner-friendly": "Beginner friendly",
-    "contribution-ready": "Contribution ready",
-    launches: "Launches",
-    "actively-developed": "Active",
-    "needs-maintainer": "Needs maintainer",
+    all: 'All items',
+    new: 'Recently added',
+    hot: 'Trending',
+    mature: 'Established',
+    'good-to-learn': 'Good to learn',
+    'production-like': 'Production-like',
+    'beginner-friendly': 'Beginner friendly',
+    'contribution-ready': 'Contribution ready',
+    launches: 'Launches',
+    'actively-developed': 'Active',
+    'needs-maintainer': 'Needs maintainer',
 };
 export function lensDisplay(id) {
     if (!id)
-        return LENS_DISPLAY.all ?? "All";
+        return LENS_DISPLAY.all ?? 'All';
     return LENS_DISPLAY[id] ?? id;
 }
 // ── Sort ids (the /items sort dropdown) ──────────────────────────────
 export const SORT_DISPLAY = {
-    "recently-updated": "Recently updated",
-    "most-starred": "Most starred",
-    "recently-added": "Recently added",
-    "best-overall": "Best overall",
-    alphabetical: "Alphabetical",
+    '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['recently-updated'] ?? '';
     return SORT_DISPLAY[id] ?? id;
 }
 export function prettySlug(value) {
     if (!value)
-        return "";
+        return '';
     return value
         .split(/[-_]+/)
         .filter(Boolean)
         .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-        .join(" ");
+        .join(' ');
+}
+/**
+ * Up-to-two-letter initials for avatar placeholders (e.g. "Open WebUI"
+ * → "OW"). Shared by every card component so the fallback treatment
+ * stays identical across the directory.
+ */
+export function nameInitials(name) {
+    return (name ?? '')
+        .split(/\s+/)
+        .map((word) => word[0])
+        .filter(Boolean)
+        .slice(0, 2)
+        .join('')
+        .toUpperCase();
 }
 // ── 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 AppStatus values.
 export const STATUS_OPTIONS = [
-    "active",
-    "mature",
-    "quiet",
-    "stale",
-    "inactive",
-    "needs-maintainer",
-    "archived",
-    "historical",
-    "needs_review",
-    "unavailable",
-    "unknown",
+    'active',
+    'mature',
+    'quiet',
+    'stale',
+    'inactive',
+    'needs-maintainer',
+    'archived',
+    'historical',
+    'needs_review',
+    'unavailable',
+    'unknown',
 ];
 // ── GitHub linguist palette ─────────────────────────────────────────
 // Color hex values mirror the GitHub Linguist language palette so a
@@ -107,46 +121,46 @@ export const STATUS_OPTIONS = [
 // project's GitHub page. Anything not in the map falls back to a
 // neutral ink grey. Used by the record-detail sidebar.
 export const LANG_COLORS = {
-    TypeScript: "#3178c6",
-    JavaScript: "#f1e05a",
-    Python: "#3572A5",
-    Go: "#00ADD8",
-    Rust: "#dea584",
-    Ruby: "#701516",
-    Java: "#b07219",
-    Kotlin: "#A97BFF",
-    Swift: "#F05138",
-    C: "#555555",
-    "C++": "#f34b7d",
-    "C#": "#178600",
-    PHP: "#4F5D95",
-    Shell: "#89e051",
-    Bash: "#89e051",
-    HTML: "#e34c26",
-    CSS: "#563d7c",
-    SCSS: "#c6538c",
-    Sass: "#a53b88",
-    Less: "#1d365d",
-    Vue: "#41b883",
-    Svelte: "#ff3e00",
-    Dart: "#00B4AB",
-    Lua: "#000080",
-    Elixir: "#6e4a7e",
-    Haskell: "#5e5086",
-    Scala: "#c22d40",
-    R: "#198CE7",
-    MATLAB: "#e16737",
-    "Jupyter Notebook": "#DA5B0B",
-    MDX: "#fcb32c",
-    Dockerfile: "#384d54",
-    Makefile: "#427819",
-    Perl: "#0298c3",
-    Zig: "#ec915c",
-    Nim: "#ffc200",
-    Erlang: "#B83998",
-    Elm: "#60B5CC",
-    OCaml: "#3be133",
-    "F#": "#b845fc",
+    TypeScript: '#3178c6',
+    JavaScript: '#f1e05a',
+    Python: '#3572A5',
+    Go: '#00ADD8',
+    Rust: '#dea584',
+    Ruby: '#701516',
+    Java: '#b07219',
+    Kotlin: '#A97BFF',
+    Swift: '#F05138',
+    C: '#555555',
+    'C++': '#f34b7d',
+    'C#': '#178600',
+    PHP: '#4F5D95',
+    Shell: '#89e051',
+    Bash: '#89e051',
+    HTML: '#e34c26',
+    CSS: '#563d7c',
+    SCSS: '#c6538c',
+    Sass: '#a53b88',
+    Less: '#1d365d',
+    Vue: '#41b883',
+    Svelte: '#ff3e00',
+    Dart: '#00B4AB',
+    Lua: '#000080',
+    Elixir: '#6e4a7e',
+    Haskell: '#5e5086',
+    Scala: '#c22d40',
+    R: '#198CE7',
+    MATLAB: '#e16737',
+    'Jupyter Notebook': '#DA5B0B',
+    MDX: '#fcb32c',
+    Dockerfile: '#384d54',
+    Makefile: '#427819',
+    Perl: '#0298c3',
+    Zig: '#ec915c',
+    Nim: '#ffc200',
+    Erlang: '#B83998',
+    Elm: '#60B5CC',
+    OCaml: '#3be133',
+    'F#': '#b845fc',
 };
 /**
  * Resolve a GitHub Linguist color for a language name. Returns a
@@ -155,7 +169,29 @@ export const LANG_COLORS = {
  */
 export function langColor(name) {
     if (!name)
-        return "#9ca3af";
-    return LANG_COLORS[name] ?? "#9ca3af";
+        return '#9ca3af';
+    return LANG_COLORS[name] ?? '#9ca3af';
+}
+// ── SPDX license id → human-readable label ──────────────────────────
+// GitHub emits a literal `NOASSERTION` (and the related `OTHER`
+// placeholder) on repositories where the license couldn't be
+// auto-detected. Surfacing the API enum to readers looks like a
+// bug; this helper swaps the placeholder for a plain-English string.
+const LICENSE_PLACEHOLDER_IDS = new Set(['NOASSERTION', 'OTHER', 'NONE', 'UNLICENSED', '']);
+export const LICENSE_NOT_DETECTED = 'License not detected';
+export const LICENSE_OTHER = 'Other';
+/**
+ * Resolve a SPDX id (or GitHub-flavored placeholder) to a
+ * user-facing string. The placeholder ids are collapsed to a
+ * short, neutral phrase; known SPDX ids pass through untouched so
+ * downstream consumers can still match on them.
+ */
+export function licenseDisplay(spdxId) {
+    if (!spdxId)
+        return LICENSE_NOT_DETECTED;
+    if (LICENSE_PLACEHOLDER_IDS.has(spdxId.toUpperCase())) {
+        return spdxId.toUpperCase() === 'OTHER' ? LICENSE_OTHER : LICENSE_NOT_DETECTED;
+    }
+    return spdxId;
 }
 //# sourceMappingURL=directory-display.js.map

package/dist/directory-display.js.map

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

package/dist/directory-facets.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The single facet registry.
+ *
+ * `browse.facets` in grove.config.ts decides WHICH browse dimensions a
+ * site exposes and in WHAT ORDER; this module owns everything else a
+ * facet id means — its filter dimension, display label, URL parameter,
+ * and selection mode. Consumers (schema validation, view models, the
+ * filter UI, the submission form) all read from here so the id list
+ * can't drift into parallel alias tables.
+ */
+/** Canonical facet ids accepted by `browse.facets` (validated by zod). */
+export declare const FACET_IDS: readonly ["category", "stack", "platform", "tags", "license"];
+export type FacetId = (typeof FACET_IDS)[number];
+/** Keys of the `buildFacets()` result / `IndexFilters` dimensions. */
+export type FacetDimension = "categories" | "stacks" | "platforms" | "tags" | "licenses";
+export interface FacetDef {
+    id: FacetId;
+    /** Key into `buildFacets()` output and `IndexFilters`. */
+    dimension: FacetDimension;
+    /** Filter-group display label. */
+    label: string;
+    /** Query parameter (mirrors `KEYS` in directory-search). */
+    urlParam: string;
+    /** Single-select facets render radios and navigate on change. */
+    single: boolean;
+}
+export declare const FACET_DEFS: Record<FacetId, FacetDef>;
+/** Default facet set when `browse.facets` is not configured. */
+export declare const DEFAULT_FACETS: readonly FacetId[];
+/**
+ * Normalize a facet spelling to its canonical id. The config schema
+ * only accepts canonical ids; this alias map keeps runtime consumers
+ * tolerant of the historical singular/plural spellings that may still
+ * exist in generated artifacts.
+ */
+export declare function canonicalFacetId(value: string): FacetId | undefined;
+/**
+ * Resolve a configured facet list into ordered, deduped definitions.
+ * ORDER IS THE CONTRACT: the array order in `browse.facets` is the
+ * order filter groups render in. Unknown ids resolve to nothing here —
+ * the config schema already rejects them at parse time.
+ */
+export declare function configuredFacetDefs(facets?: readonly string[]): FacetDef[];
+//# sourceMappingURL=directory-facets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"directory-facets.d.ts","sourceRoot":"","sources":["../src/directory-facets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,SAAS,+DAAgE,CAAC;AACvF,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,sEAAsE;AACtE,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;AAEzF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ,0DAA0D;IAC1D,SAAS,EAAE,cAAc,CAAC;IAC1B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,CAMhD,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,cAAc,EAAE,SAAS,OAAO,EAAyB,CAAC;AAevE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,EAAE,CAW1E"}

package/dist/directory-facets.js

@@ -0,0 +1,61 @@
+/**
+ * The single facet registry.
+ *
+ * `browse.facets` in grove.config.ts decides WHICH browse dimensions a
+ * site exposes and in WHAT ORDER; this module owns everything else a
+ * facet id means — its filter dimension, display label, URL parameter,
+ * and selection mode. Consumers (schema validation, view models, the
+ * filter UI, the submission form) all read from here so the id list
+ * can't drift into parallel alias tables.
+ */
+/** Canonical facet ids accepted by `browse.facets` (validated by zod). */
+export const FACET_IDS = ["category", "stack", "platform", "tags", "license"];
+export const FACET_DEFS = {
+    category: { id: "category", dimension: "categories", label: "Category", urlParam: "category", single: false },
+    stack: { id: "stack", dimension: "stacks", label: "Stack", urlParam: "stack", single: false },
+    platform: { id: "platform", dimension: "platforms", label: "Platform", urlParam: "platform", single: false },
+    tags: { id: "tags", dimension: "tags", label: "Tag", urlParam: "tag", single: false },
+    license: { id: "license", dimension: "licenses", label: "License", urlParam: "license", single: true },
+};
+/** Default facet set when `browse.facets` is not configured. */
+export const DEFAULT_FACETS = ["category", "tags"];
+const FACET_ALIASES = {
+    category: "category",
+    categories: "category",
+    stack: "stack",
+    stacks: "stack",
+    platform: "platform",
+    platforms: "platform",
+    tag: "tags",
+    tags: "tags",
+    license: "license",
+    licenses: "license",
+};
+/**
+ * Normalize a facet spelling to its canonical id. The config schema
+ * only accepts canonical ids; this alias map keeps runtime consumers
+ * tolerant of the historical singular/plural spellings that may still
+ * exist in generated artifacts.
+ */
+export function canonicalFacetId(value) {
+    return FACET_ALIASES[value];
+}
+/**
+ * Resolve a configured facet list into ordered, deduped definitions.
+ * ORDER IS THE CONTRACT: the array order in `browse.facets` is the
+ * order filter groups render in. Unknown ids resolve to nothing here —
+ * the config schema already rejects them at parse time.
+ */
+export function configuredFacetDefs(facets) {
+    const seen = new Set();
+    const defs = [];
+    for (const raw of facets ?? DEFAULT_FACETS) {
+        const id = canonicalFacetId(raw);
+        if (id && !seen.has(id)) {
+            seen.add(id);
+            defs.push(FACET_DEFS[id]);
+        }
+    }
+    return defs;
+}
+//# sourceMappingURL=directory-facets.js.map

package/dist/directory-facets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-facets.js","sourceRoot":"","sources":["../src/directory-facets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAkBvF,MAAM,CAAC,MAAM,UAAU,GAA8B;IACnD,QAAQ,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE;IAC7G,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;IAC7F,QAAQ,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE;IAC5G,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;IACrF,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;CACvG,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,cAAc,GAAuB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAEvE,MAAM,aAAa,GAA4B;IAC7C,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,UAAU;IACtB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,UAAU;IACrB,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,SAAS;CACpB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA0B;IAC5D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,MAAM,IAAI,cAAc,EAAE,CAAC;QAC3C,MAAM,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/directory-format.d.ts

@@ -20,6 +20,22 @@ export declare function formatStars(n: number | null | undefined): string | null
  * dates (which can happen with bad upstream timestamps).
  */
 export declare function formatRelative(iso: string | null | undefined): string;
+/**
+ * Pick the singular or plural noun for a count. The plural form is
+ * explicit — never derived with a naive `+"s"` — so blueprint labels
+ * with irregular plurals ("entity"/"entities") render correctly.
+ */
+export declare function pluralize(count: number, singular: string, plural: string): string;
+/**
+ * Format a count with its noun: `formatCount(1, {singular: "project",
+ * plural: "projects"})` → "1 project". The noun pair typically comes
+ * from the blueprint labels, so every surface (grids, collection
+ * cards, browse results) counts with the same vocabulary.
+ */
+export declare function formatCount(count: number, noun: {
+    singular: string;
+    plural: string;
+}): string;
 /**
  * Format an ISO date as a localized short date (e.g. "Jan 5, 2026").
  * Returns the original string for unparseable input, or "—" when

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

@@ -1 +1 @@
-{"version":3,"file":"directory-format.d.ts","sourceRoot":"","sources":["../src/directory-format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAcrE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CASjE"}
+{"version":3,"file":"directory-format.d.ts","sourceRoot":"","sources":["../src/directory-format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAcrE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzC,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CASjE"}

package/dist/directory-format.js

@@ -52,6 +52,23 @@ export function formatRelative(iso) {
         return "1y ago";
     return `${years}y ago`;
 }
+/**
+ * Pick the singular or plural noun for a count. The plural form is
+ * explicit — never derived with a naive `+"s"` — so blueprint labels
+ * with irregular plurals ("entity"/"entities") render correctly.
+ */
+export function pluralize(count, singular, plural) {
+    return count === 1 ? singular : plural;
+}
+/**
+ * Format a count with its noun: `formatCount(1, {singular: "project",
+ * plural: "projects"})` → "1 project". The noun pair typically comes
+ * from the blueprint labels, so every surface (grids, collection
+ * cards, browse results) counts with the same vocabulary.
+ */
+export function formatCount(count, noun) {
+    return `${count} ${pluralize(count, noun.singular, noun.plural)}`;
+}
 /**
  * Format an ISO date as a localized short date (e.g. "Jan 5, 2026").
  * Returns the original string for unparseable input, or "—" when

package/dist/directory-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"directory-format.js","sourceRoot":"","sources":["../src/directory-format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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,GAA8B;IAC3D,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,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,GAA8B;IACvD,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1C,OAAO,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE;QACnC,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,SAAS;KACf,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"directory-format.js","sourceRoot":"","sources":["../src/directory-format.ts"],"names":[],"mappings":"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"}

package/dist/directory-search.d.ts

@@ -59,6 +59,14 @@ export declare function applySort(items: IndexRecord[], sort: IndexSort): IndexR
 export declare function paginate<T>(items: T[], page: number, pageSize?: number): T[];
 /** Total number of pages given an item count. Always >= 1. */
 export declare function totalPages(itemCount: number, pageSize?: number): number;
+/**
+ * Windowed page list for pagination controls: all pages when 7 or
+ * fewer, otherwise `1 … active−1 active active+1 … count` with
+ * "ellipsis" markers. Shared by the server-rendered `Pagination`
+ * component and the client-side rebuild in `DirectoryIndexClient`
+ * so the two never drift.
+ */
+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. */
@@ -90,7 +98,28 @@ export declare function removeFilter(f: IndexFilters, key: keyof IndexFilters, v
  * Build the full list of facet values from the items array, preserving
  * a sensible order (frequency desc, then alphabetical for ties).
  */
-export declare function buildFacets(items: IndexRecord[]): {
+export declare function buildFacets(items: IndexRecord[], options?: {
+    curatedTagIds?: string[];
+    /**
+     * When set, facet counts reflect records that satisfy all
+     * current filters *except* the facet being computed. This is the
+     * "intersection count" UX — Platform after Flutter should show
+     * Flutter+Platform counts, not the global Platform count.
+     *
+     * Set to `null` (or omit) to keep the legacy global-count
+     * behavior. The browse page opts in by passing the current
+     * `IndexFilters` minus each facet's filter.
+     */
+    filters?: IndexFilters | null;
+    /**
+     * Taxonomy-owned display order per dimension: an array of ids in
+     * the order the taxonomy YAML declares them. Known ids sort by
+     * that position; ids that exist only in record data append after,
+     * 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[]>>;
+}): {
     stacks: {
         value: string;
         count: number;

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

@@ -1 +1 @@
-{"version":3,"file":"directory-search.d.ts","sourceRoot":"","sources":["../src/directory-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/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,CAyBzE;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;AAyB3C,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,EAAE,CA8B9E;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,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,CAyGlF;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,YAAY,GACd;IAAE,GAAG,EAAE,MAAM,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAwC7D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,CAAC,EAAE,YAAY,EACf,GAAG,EAAE,MAAM,YAAY,EACvB,KAAK,EAAE,MAAM,GACZ,YAAY,CAwBd;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;EAmC/C"}
+{"version":3,"file":"directory-search.d.ts","sourceRoot":"","sources":["../src/directory-search.ts"],"names":[],"mappings":"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"}