@stapel/search-react 0.15.0 → 0.18.0

package/src/i18n/keys.ts

@@ -138,6 +138,22 @@ export const SEARCH_I18N_KEYS = {
    * tail is longer than one row. */
   facetsShowAll: "search.facets.show_all",
   facetsShowLess: "search.facets.show_less",
+  /** The box that searches the FILTER PANEL itself — drawn from six groups
+   * up, because a panel a person can no longer scan is a panel they have to
+   * query. It narrows presentation only and never touches the URL. */
+  facetsSearch: "search.facets.search",
+  /** Said where the groups were when the panel-search matches none of them.
+   * Distinct from `facetsEmpty`, which says the SEARCH offers no filters —
+   * here the filters exist and the query missed. */
+  facetsSearchEmpty: "search.facets.search_empty",
+  /**
+   * The rail's sticky footer: what the applied filters LEFT — "N listings
+   * match". A PLURAL FAMILY: it counts a noun in words. Desktop filters
+   * apply instantly, so this is feedback, not an apply button; the floor
+   * case (`at_least`) reuses `resultsCountAtLeast` rather than growing a
+   * second family for the same number.
+   */
+  facetsMatchCount: "search.facets.match_count",
 
   // ── the filter panel as a whole (phone sheet + host slots) ───────────────
   filtersOpen: "search.filters.open",
@@ -161,6 +177,9 @@ export const SEARCH_I18N_KEYS = {
   /** A chip filtering on more than one value: "Bosch, +2". Not a plural
    * family — nothing is being counted in words. */
   filtersChipMore: "search.filters.chip_more",
+  /** The chip standing in for the row's capped tail — opens the full panel.
+   * `{count}` is how many chips it hides (D16). */
+  filtersChipOverflow: "search.filters.chips_overflow",
 
   // ── the way OUT of a search that found nothing ───────────────────────────
   /** Caption above the exit buttons. Not a second "nothing found" — that
@@ -308,6 +327,7 @@ export const SEARCH_I18N_PLURAL_KEYS: readonly SearchI18nKey[] = [
   SEARCH_I18N_KEYS.filtersShowCount,
   SEARCH_I18N_KEYS.filtersShowCountAtLeast,
   SEARCH_I18N_KEYS.boxCategoryCount,
+  SEARCH_I18N_KEYS.facetsMatchCount,
 ];
 
 /**
@@ -392,6 +412,10 @@ export const searchI18nBundleEn: Record<string, string> = {
   "search.facets.range_to_aria": "{feature}, up to",
   "search.facets.show_all": "Show all ({count})",
   "search.facets.show_less": "Show fewer",
+  "search.facets.search": "Find a filter",
+  "search.facets.search_empty": "No filter matches this",
+  "search.facets.match_count.one": "{count} listing matches",
+  "search.facets.match_count.other": "{count} listings match",
   "search.facets.range_invalid":
     "“From” is larger than “to”, so nothing could match. Swap them to apply this range.",
 
@@ -406,6 +430,7 @@ export const searchI18nBundleEn: Record<string, string> = {
   "search.filters.all": "All filters",
   "search.filters.short": "Filters",
   "search.filters.chip_more": ", +{count}",
+  "search.filters.chips_overflow": "More · {count}",
 
   "search.empty.exits_title": "Try widening the search",
   "search.empty.up_a_level": "Go up a level",

package/src/i18n/ru.ts

@@ -112,6 +112,12 @@ export const searchI18nBundleRu: I18nDictionary = {
   "search.facets.range_to_aria": "{feature}, до",
   "search.facets.show_all": "Показать все ({count})",
   "search.facets.show_less": "Свернуть",
+  "search.facets.search": "Найти фильтр",
+  "search.facets.search_empty": "Среди фильтров такого нет",
+  "search.facets.match_count.one": "Найдено {count} объявление",
+  "search.facets.match_count.few": "Найдено {count} объявления",
+  "search.facets.match_count.many": "Найдено {count} объявлений",
+  "search.facets.match_count.other": "Найдено {count} объявления",
   "search.facets.range_invalid":
     "«От» больше, чем «до», — под такой диапазон ничего не подойдёт. Поменяйте значения местами.",
 
@@ -130,6 +136,7 @@ export const searchI18nBundleRu: I18nDictionary = {
   "search.filters.all": "Все фильтры",
   "search.filters.short": "Фильтры",
   "search.filters.chip_more": ", +{count}",
+  "search.filters.chips_overflow": "Ещё {count}",
 
   "search.empty.exits_title": "Попробуйте расширить поиск",
   "search.empty.up_a_level": "Подняться на уровень выше",

package/src/state/facets.ts

@@ -31,7 +31,11 @@
  * A slug the server SKIPPED (`facet_meta.skipped`, dropped at
  * `MAX_FACET_FIELDS`) is not counted at all. Its options carry `count: null`,
  * never `0` — "we did not count this" and "there are none" are different
- * sentences and the honest one has to survive to the screen.
+ * sentences and the honest one has to survive to the screen. Its options come
+ * from the CATEGORY SCHEMA, because a count is not a licence to filter: the
+ * server accepts `f.<slug>` whether or not it counted it, so an uncounted
+ * facet is a filter that exists and a number that is missing, not a filter
+ * that does not exist. See {@link buildFacetGroups}.
  *
  * 3. **Not every counted slug is a FILTER.** The plan is built from the leaf
  *    category's feature defs and the counter counts whatever is indexed, so a
@@ -124,6 +128,25 @@ export interface FacetGroup {
   readonly selected: readonly string[];
 }
 
+/**
+ * How many candidate documents carry ANY value of this axis — the evidence
+ * that people actually fill this field in. Uncounted options are `null`
+ * (never `0` — different sentences) and contribute nothing, so a group the
+ * server did not count sums to zero.
+ *
+ * Two surfaces rank by it, for the same reason: the chip row orders its
+ * counted band by coverage (D16 reopen — an imported catalogue gave the
+ * phones leaf option tables for its wholesale plumbing, and schema order put
+ * them ahead of the brand), and the filter panel opens its top-coverage
+ * groups and collapses the rest (the 5717px rail). One definition, or the
+ * two surfaces drift into two opinions about which axes matter.
+ */
+export function facetCoverage(group: FacetGroup): number {
+  let total = 0;
+  for (const option of group.options) total += option.count ?? 0;
+  return total;
+}
+
 export interface BuildFacetGroupsInput {
   /** The envelope's `facets`: `{slug: {value: count}}`. */
   readonly facets: Readonly<Record<string, Readonly<Record<string, number>>>>;
@@ -352,13 +375,37 @@ export function buildFacetGroups(input: BuildFacetGroupsInput): readonly FacetGr
     const push = (value: string): void => {
       if (!values.includes(value)) values.push(value);
     };
-    // Declared order first (closed sets), then whatever else the counter
-    // returned, then anything selected that neither of them mentioned.
-    for (const value of declared) if (value in counts) push(value);
-    const remaining = Object.keys(counts)
-      .filter((value) => !declared.includes(value))
-      .sort((a, b) => (counts[b] ?? 0) - (counts[a] ?? 0) || a.localeCompare(b));
-    for (const value of remaining) push(value);
+    if (counted) {
+      // Declared order first (closed sets), then whatever else the counter
+      // returned, then anything selected that neither of them mentioned.
+      for (const value of declared) if (value in counts) push(value);
+      const remaining = Object.keys(counts)
+        .filter((value) => !declared.includes(value))
+        .sort((a, b) => (counts[b] ?? 0) - (counts[a] ?? 0) || a.localeCompare(b));
+      for (const value of remaining) push(value);
+    } else {
+      // A COUNT IS NOT A LICENCE TO FILTER.
+      //
+      // `counts` is empty here by definition — the counter never looked at
+      // this slug (`facet_meta.skipped`, the plan overrunning
+      // `MAX_FACET_FIELDS`) or the deployment counts nothing at all. Gating
+      // the options on `value in counts` therefore left the facet with NONE,
+      // and a group with no options is dropped by every surface that draws
+      // one. Measured on a live cars leaf: 26 facetable features declared, 12
+      // counted, 14 rendered as a warning naming filters the person could not
+      // then use — while `/query` accepts `f.<slug>` for every one of them.
+      //
+      // So an uncounted facet is built from the SCHEMA: the option table the
+      // category config already carries (`config.options`), or the captions
+      // the answer sent for it. The counts stay `null` below — "nobody
+      // counted this" is still said, in the place it belongs (beside the
+      // option), and it no longer decides whether the filter exists.
+      //
+      // A `ref_select` whose config is a bare `optionsRef` pointer has no
+      // table here and no options to draw; naming that gap is
+      // `MODULE.md`'s job, inventing values would not be.
+      for (const value of declared) push(value);
+    }
     for (const value of selected) push(value);
 
     const labelOptions = {