@grove-dev/astro 0.2.6 → 0.2.13

package/dist/lib/search.d.ts

@@ -1,88 +1,22 @@
+import type { IndexRecord } from "@grove-dev/core";
 /**
- * URL-driven search/filter/sort state for the directory list page.
+ * URL-driven filter state for the /items discovery page.
  *
- * Multi-value fields use repeated keys: `?stack=Flutter&stack=RN`.
- * Single-value fields (q, sort, page, lens) are scalar. Empty
- * / undefined fields mean "no filter on this dimension".
- *
- * The functions here are generic over a record-like shape that
- * carries the index payload (see `toIndexRecord` in
- * `@grove-dev/core`). The list page only needs `name`, `slug`,
- * `description`, `category`, `tags`, `stack`, `stacks`, `platforms`,
- * `repoUrl`, `logoUrl`, `health`, `curation`, and `github.{stars,
- * pushedAt}` — all of which are present in the index projection.
- */
-import type { HealthStatus, ProjectRecord } from "@grove-dev/core";
-import { type LensId } from "./lenses.js";
-/**
- * Subset of `ProjectRecord` the search lib actually reads. Defined
- * inline so the lib works on both full records and the lighter
- * index payload. Use `ProjectRecord` from core when you have it;
- * pass any object that satisfies `Searchable` otherwise.
- *
- * `Searchable` is a superset of `AppLike` (the lens-matching shape
- * in `lib/lenses.ts`) — both interfaces share the same optional
- * field shape, so `Searchable` records can be passed to
- * `applyLens()` and `filterApps()` interchangeably.
+ * Multi-value fields use repeated keys in the URL: `?stack=Flutter&stack=React+Native`.
+ * Empty / undefined fields mean "no filter on this dimension".
  */
-export interface Searchable {
-    slug?: string;
-    name: string;
-    description?: string;
-    category?: string;
-    tags?: string[];
-    stack?: string;
-    stacks?: string[];
-    platforms?: string[];
-    /** Canonical repo URL — used for owner extraction in text search. */
-    repoUrl?: string;
-    logoUrl?: string;
-    /** Curated labels (new, hot, mature, featured). */
-    curation?: {
-        labels?: string[];
-    };
-    /** Health block — drives status filter + tier fallback. */
-    health?: {
-        status?: HealthStatus;
-        tier?: "curated" | "listed" | "experimental" | "hidden";
-        visibility?: "highlight" | "keep" | "needs_review" | "hide" | "remove" | "historical";
-        cleanupCandidate?: boolean;
-    };
-    /** GitHub metadata used for sort + text search. */
-    github?: {
-        stars?: number;
-        forks?: number;
-        pushedAt?: string | null;
-        license?: string | null;
-    };
-    /** Score block — used for "best-overall" sort. */
-    scores?: {
-        activity?: number;
-        maturity?: number;
-        learning?: number;
-        contribution?: number;
-        docs?: number;
-        overall?: number;
-    };
-}
-export type AppsFilters = {
+export type ItemsFilters = {
     q?: string;
-    /** Stack slugs, repeated URL key `stack=`. Matches against `stack` AND `stacks[]`. */
     stacks?: string[];
-    /** Platform slugs, repeated URL key `platform=`. Matches `platforms[]`. */
     platforms?: string[];
-    /** Category names, repeated URL key `category=`. */
     categories?: string[];
-    /** Curated label ids (new/hot/mature/featured), repeated URL key `label=`. */
     labels?: string[];
-    /** SPDX license ids, repeated URL key `license=`. */
     licenses?: string[];
-    /** Health status values, comma-separated repeated URL key `status=`. */
     statuses?: string[];
-    /** A curated lens (single-select view). */
-    lens?: LensId;
+    /** A curated lens (e.g. "good-to-learn", "production-like"). Single value. */
+    lens?: string;
     /** Sort order. Single value, defaults to "recently-updated". */
-    sort?: AppsSort;
+    sort?: ItemsSort;
     /** 1-based page number. */
     page?: number;
 };
@@ -103,72 +37,59 @@ export declare const SORT_OPTIONS: readonly [{
     readonly value: "alphabetical";
     readonly label: "Alphabetical";
 }];
-export type AppsSort = (typeof SORT_OPTIONS)[number]["value"];
-/**
- * How many records per page. Constant for now; future versions may
- * vary per blueprint.
- */
-export declare const PAGE_SIZE = 24;
-/**
- * Read filters from a URLSearchParams (or anything URLSearchParams-
- * shaped, e.g. the result of `new URL(req.url).searchParams`).
- */
-export declare function filtersFromSearchParams(sp: URLSearchParams): AppsFilters;
-/**
- * Serialize a filters object back to URLSearchParams. Undefined /
- * empty values are dropped. Defaults (sort, page 1) are also dropped
- * to keep URLs short and canonical.
- */
-export declare function searchParamsFromFilters(f: AppsFilters): URLSearchParams;
+export type ItemsSort = (typeof SORT_OPTIONS)[number]["value"];
 /**
- * True if any filter is active (i.e. the result list isn't "all
- * records, default sort").
+ * Read filters from a URLSearchParams (or anything URLSearchParams-shaped,
+ * e.g. the result of `new URL(req.url).searchParams`).
  */
-export declare function hasAnyFilter(f: AppsFilters): boolean;
+export declare function filtersFromSearchParams(sp: URLSearchParams): ItemsFilters;
 /**
- * Return the subset of records that match all active filters (AND
- * across dimensions, OR within a dimension).
- *
- * `q` is a case-insensitive substring search across name, owner,
- * description, category, stack/stacks/platforms, tags, and license.
- * Other dimensions are exact match.
- */
-export declare function filterApps<T extends Searchable>(records: T[], f: AppsFilters): T[];
-/**
- * Apply lens → filter → sort pipeline. Lens is applied first because
- * it's a single-select "view" that may be broader or narrower than
- * the regular filter dimensions.
- */
-export declare function pipeline<T extends Searchable>(records: T[], filters: AppsFilters): T[];
-/**
- * Sort records in-place-free: returns a new array. Stable for ties.
- * Records missing the sort key (e.g. no stars) sink to the bottom
- * rather than vanishing.
+ * Serialize a filters object back to URLSearchParams.
+ * Undefined / empty values are dropped. Defaults (sort, page 1, comfortable
+ * density) are also dropped to keep URLs short and canonical.
  */
-export declare function applySort<T extends Searchable>(records: T[], sort: AppsSort): T[];
+export declare function searchParamsFromFilters(f: ItemsFilters): URLSearchParams;
+/** True if any filter is active (i.e. the result list isn't "all items"). */
+export declare function hasAnyFilter(f: ItemsFilters): boolean;
+/** How many items per page. Constant for now; future versions may vary. */
+export declare const PAGE_SIZE = 20;
+export declare function applySort(items: IndexRecord[], sort: ItemsSort): IndexRecord[];
 /** Slice an array for a given page (1-based). */
 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;
 /** Resolve the effective sort from a filters object, applying default. */
-export declare function effectiveSort(f: AppsFilters): AppsSort;
+export declare function effectiveSort(f: ItemsFilters): ItemsSort;
 /** Resolve the effective page from a filters object, applying default. */
-export declare function effectivePage(f: AppsFilters): number;
+export declare function effectivePage(f: ItemsFilters): number;
 /**
- * Return a flat list of active-filter chips for display + removal.
- * Used by the "x" button on each chip in the UI.
+ * Return the subset of items that match all active filters (AND across
+ * dimensions, OR within a dimension).
+ *
+ * `q` is a case-insensitive substring search across name, owner,
+ * description, and category. Other dimensions are exact match.
  */
-export declare function activeFilterChips(f: AppsFilters): {
-    key: keyof AppsFilters;
+export declare function filterItems(items: IndexRecord[], f: ItemsFilters): IndexRecord[];
+/** Build a flat list of "active filter" chips for display + removal. */
+export declare function activeFilterChips(f: ItemsFilters): {
+    key: keyof ItemsFilters;
     value: string;
     label: string;
 }[];
 /**
- * Build the full list of facet values from the record array,
- * preserving a sensible order (frequency desc, then alphabetical
- * for ties).
+ * Return a new filters object with one (key, value) removed.
+ * - key="q" → clears the search string
+ * - multi-value keys → removes the single matching value
+ * Used by the "x" button on each active filter chip.
+ * Also resets page to 1 so the user doesn't get stranded on a high page
+ * that no longer has results.
+ */
+export declare function removeFilter(f: ItemsFilters, key: keyof ItemsFilters, value: string): ItemsFilters;
+/**
+ * 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<T extends Searchable>(records: T[]): {
+export declare function buildFacets(items: IndexRecord[]): {
     stacks: {
         value: string;
         count: number;
@@ -190,10 +111,7 @@ export declare function buildFacets<T extends Searchable>(records: T[]): {
         count: number;
     }[];
 };
-/**
- * Re-export the `ProjectRecord` type so consumers of the search lib
- * can write `import type { ProjectRecord } from "@grove-dev/astro/lib"`
- * without a second import.
- */
-export type { ProjectRecord };
+export declare const filterApps: typeof filterItems;
+export type AppsFilters = ItemsFilters;
+export type AppsSort = ItemsSort;
 //# sourceMappingURL=search.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/lib/search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/lib/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD;;;;;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,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,CAAC;IACjB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,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;AAmB/D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,eAAe,GAAG,YAAY,CAsBzE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,YAAY,GAAG,eAAe,CAaxE;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAWrD;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,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,YAAY,GAAG,WAAW,EAAE,CA8FhF;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,CAqC7D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,CAAC,EAAE,YAAY,EACf,GAAG,EAAE,MAAM,YAAY,EACvB,KAAK,EAAE,MAAM,GACZ,YAAY,CAYd;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;EAgC/C;AASD,eAAO,MAAM,UAAU,oBAAc,CAAC;AACtC,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC;AACvC,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC"}