@stapel/search-react 0.10.0 → 0.12.0

package/dist/headless/useFacetLabels.js

@@ -0,0 +1,129 @@
+/**
+ * The HOST LABEL SEAM — the third source of a facet option's caption, and the
+ * only one that can reach a vocabulary.
+ *
+ * ── The defect ────────────────────────────────────────────────────────────
+ *
+ * A live classified deployment's category schema types `vendor`, `model`,
+ * `memory_size` and `color_ref_select` as `ref_select`: their config carries
+ * no `options` table at all, only a POINTER —
+ * `{"optionsRef": {"level": "Vendor", "vocabulary": "avito-phone-catalog"}}`.
+ * The words live in the vocabulary the pointer names, which is a different
+ * service with a different client. So the two label sources this pair already
+ * has both come up empty: the answer's `facet_labels` because the deployed
+ * server predates stapel-search 0.4.0 and sends no such key, and the schema
+ * because a pointer is not a table. The chips printed `apple`, `128-gb`,
+ * `chernyy` — storage slugs, at buyers.
+ *
+ * This pair must not grow a vocabulary client to fix that: it would tie every
+ * storefront's search to a service it may not run, and the host ALREADY has
+ * that client (`@stapel/attributes-react`'s `VocabularyClientProvider` is
+ * mounted for the composer). So the fetch is the host's and the discipline is
+ * this module's — the same division as `renderGeoFilter` and
+ * `renderCategoryFilter`, one seam lower because what crosses it is data
+ * rather than a control.
+ *
+ * ── Precedence, stated once ───────────────────────────────────────────────
+ *
+ *   1. the answer's `facet_labels`  — the server saw the write-time snapshot;
+ *   2. the feature def's inline `options` table — for the plain `select`
+ *      family, which carries its words with it;
+ *   3. this resolver;
+ *   4. the raw value.
+ *
+ * `buildFacetGroups` has already applied 1 and 2 by the time this hook runs,
+ * and it leaves an option it could not name with `label === value` — which is
+ * what makes "did anyone name this?" answerable without a second lookup. Only
+ * those values are asked about, so the host is never called for a value the
+ * server or the schema already captioned, and a resolver that returns nothing
+ * for a value leaves the raw value on screen. A chip that silently dropped an
+ * option would be worse than one showing a slug: the option is real, it has a
+ * count, and it is the only way to reach those documents.
+ *
+ * ── The fetch discipline ──────────────────────────────────────────────────
+ *
+ * TanStack Query, exactly like the pair's other three reads, and for the four
+ * reasons that made it right there:
+ *
+ *  - **batched per group.** One call per facet slug carrying every unresolved
+ *    value of it, not one call per chip.
+ *  - **cached.** `staleTime: Infinity` — a vocabulary term's caption changes
+ *    when somebody edits the catalogue, not between two clicks on a filter.
+ *  - **deduplicated.** The chip row, the filter panel and the page's layout
+ *    probe each call `useFacetPanel`, so three components ask for the same
+ *    group's captions in one render pass; one query key means one request.
+ *  - **aborted on supersession.** The `signal` is the query's own, so a
+ *    resolver that honours it stops a request whose answer nobody will read.
+ */
+import { useQueries } from "@tanstack/react-query";
+import { mapLoad } from "@stapel/core";
+import { searchQueryKeys } from "../model/queryKeys.js";
+/** One frozen empty list, so a render with no unresolved values is stable. */
+const NO_REQUESTS = [];
+/** The values of one group nobody has named — see the precedence note above. */
+function unresolvedValues(group) {
+    return group.options
+        .filter((option) => option.label === option.value)
+        .map((option) => option.value)
+        .sort((a, b) => a.localeCompare(b));
+}
+function isCaptionMap(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Fill in what the server and the schema could not name, through the host.
+ *
+ * Returns the groups UNCHANGED — same object identity — when there is no
+ * resolver or nothing came back, so a page with the seam unwired pays neither
+ * a request nor a re-render.
+ */
+export function useHostFacetLabels(groups, resolve, locale) {
+    const requests = resolve === undefined || groups.status !== "ready"
+        ? NO_REQUESTS
+        : groups.data
+            .map((group) => ({
+            slug: group.slug,
+            feature: group.feature,
+            values: unresolvedValues(group),
+        }))
+            .filter((request) => request.values.length > 0);
+    const answers = useQueries({
+        queries: requests.map((request) => ({
+            queryKey: searchQueryKeys.facetLabels(request.slug, request.values, locale),
+            queryFn: async ({ signal }) => resolve === undefined ? {} : await resolve(request, { signal }),
+            staleTime: Number.POSITIVE_INFINITY,
+            // A vocabulary that answered 500 answers 500 again a millisecond later,
+            // and three retries only delay the chip's raw value by three round
+            // trips — the same discipline the pair's other reads keep.
+            retry: false,
+        })),
+    });
+    const captions = new Map();
+    requests.forEach((request, index) => {
+        const data = answers[index]?.data;
+        if (isCaptionMap(data))
+            captions.set(request.slug, data);
+    });
+    if (captions.size === 0)
+        return groups;
+    return mapLoad(groups, (list) => list.map((group) => {
+        const named = captions.get(group.slug);
+        if (named === undefined)
+            return group;
+        return {
+            ...group,
+            options: group.options.map((option) => {
+                // Precedence again, enforced rather than assumed: an option whose
+                // label already differs from its value was named by the server or
+                // the schema, and the host does not get to overwrite either.
+                if (option.label !== option.value)
+                    return option;
+                const caption = named[option.value];
+                return caption === undefined || caption.length === 0
+                    ? option
+                    : { ...option, label: caption };
+            }),
+        };
+    }));
+}
+//# sourceMappingURL=useFacetLabels.js.map

package/dist/headless/useFacetLabels.js.map

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

package/dist/headless/useSearchBox.d.ts

@@ -1,4 +1,5 @@
 import type { LoadState } from "@stapel/core";
+import type { SuggestAnswer, SuggestCategory } from "../api/types.js";
 /** What a query box needs to read and move the search text. */
 export interface SearchBoxBag {
     /** What is in the input right now. */
@@ -20,6 +21,42 @@ export interface SearchBoxBag {
     readonly suggestState: LoadState<readonly string[]>;
     /** A suggestion request is in flight for a prefix nothing is shown for yet. */
     readonly suggestLoading: boolean;
+    /**
+     * CATEGORY destinations for the typed prefix, server-ranked by live listing
+     * count — the primary half of the answer (stapel-search 0.7.0).
+     *
+     * Empty on a server that sends no `categories` key, and empty when the
+     * server could not reach a category provider: see
+     * {@link SearchBoxBag.categoriesUnavailable} for why a surface must tell
+     * those two apart from "nothing matched".
+     *
+     * A category with a count of `0` is already filtered out — see
+     * {@link SearchBoxBag.categoryCountsUnknown}.
+     */
+    readonly categories: readonly SuggestCategory[];
+    /**
+     * The server HAS no category provider for this answer
+     * (`degraded: ["category_suggestions"]`), so `categories` being empty says
+     * nothing about the catalogue.
+     *
+     * A surface must render no group at all rather than an empty one: a heading
+     * over nothing is the box telling a person the catalogue has no section by
+     * that name, which is a claim this answer did not make. It is deliberately
+     * NOT a banner either — the reader is mid-word, the terms half still
+     * answers, and a provider being down is the operator's business, the same
+     * ruling `degradationAudience` already applies to an engine shortfall.
+     */
+    readonly categoriesUnavailable: boolean;
+    /**
+     * The counts on {@link SearchBoxBag.categories} are not answers
+     * (`degraded: ["category_rollup"]`): with no ancestry every stored path is
+     * one segment long, so every count would read `0` for a mechanical reason.
+     *
+     * The rows are still real destinations and are still offered; a surface
+     * prints the path and omits the number, because a catalogue of zeros is
+     * worse than a list with no counts.
+     */
+    readonly categoryCountsUnknown: boolean;
     /** Characters a prefix needs before the index is asked. */
     readonly minSuggestChars: number;
     readonly maxLength: number;
@@ -29,6 +66,25 @@ export interface SearchBoxBag {
     submit(value?: string): void;
     /** Empty the box AND the search (an empty `q` is a valid browse). */
     clear(): void;
+    /**
+     * Follow a category suggestion: narrow the SERP to that section.
+     *
+     * Two decisions, both load-bearing.
+     *
+     * The `category` parameter is set to the server's own
+     * {@link SuggestCategory.category} string, VERBATIM. The server joins the
+     * ancestry itself precisely so a client cannot invent a different join and
+     * silently miss, so nothing here rebuilds it from the path or the slug.
+     *
+     * The typed text is CLEARED in the same write. The row promised a count —
+     * "Menswear / Shorts, 1 240 listings" — and that number is the
+     * section's, not the section's intersected with a title search for the word
+     * that found it. Keeping `q` would land a person on strictly fewer results
+     * than the row they tapped had just quoted, which is the row lying about
+     * where it goes. One `patch` call, so it is also one history entry: Back
+     * returns to the search the person typed.
+     */
+    chooseCategory(category: SuggestCategory): void;
 }
 export interface UseSearchBoxOptions {
     readonly debounceMs?: number;
@@ -40,5 +96,20 @@ export interface UseSearchBoxOptions {
     /** How many suggestions to ask for (backend clamps to 25). Default 8. */
     readonly suggestLimit?: number;
 }
+/**
+ * The destinations worth offering out of one answer.
+ *
+ * A category with a count of `0` is a section with nothing in it: following it
+ * lands the buyer on an empty SERP, which is a dead end dressed as a
+ * destination — and the server does return those (it reads the count with a
+ * `0` default and ranks them last), so somebody has to drop them.
+ *
+ * The one exception is `category_rollup`, where EVERY count is `0` because the
+ * ancestry never arrived rather than because the sections are empty. Filtering
+ * on the count there would delete the whole group for a reason that has
+ * nothing to do with what is in the catalogue, so the rows are kept and the
+ * numbers are what the surface omits.
+ */
+export declare function offerableCategories(answer: SuggestAnswer | undefined): readonly SuggestCategory[];
 export declare function useSearchBox(options?: UseSearchBoxOptions): SearchBoxBag;
 //# sourceMappingURL=useSearchBox.d.ts.map

package/dist/headless/useSearchBox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSearchBox.d.ts","sourceRoot":"","sources":["../../src/headless/useSearchBox.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAU9C,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,gDAAgD;IAChD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACpD,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,sEAAsE;IACtE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qEAAqE;IACrE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;kDAC8C;IAC9C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAKD,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAyG5E"}
+{"version":3,"file":"useSearchBox.d.ts","sourceRoot":"","sources":["../../src/headless/useSearchBox.ts"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAM9C,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAUtE,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,gDAAgD;IAChD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACpD,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC;;;;;;;;OAQG;IACH,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,2DAA2D;IAC3D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,sEAAsE;IACtE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qEAAqE;IACrE,KAAK,IAAI,IAAI,CAAC;IACd;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;kDAC8C;IAC9C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAaD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,GAAG,SAAS,GAChC,SAAS,eAAe,EAAE,CAK5B;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAwH5E"}

package/dist/headless/useSearchBox.js

@@ -21,16 +21,65 @@
  *
  * The suggestion list is asked for the DEBOUNCED prefix, not the draft — one
  * request per pause, not per keystroke, on an endpoint the backend throttles.
+ *
+ * ── The box reaches the CATALOGUE, not only the titles ────────────────────
+ *
+ * stapel-search 0.7.0 answers `/suggest` with two halves. Until it did, typing
+ * a word that names a section of the catalogue answered listing titles and
+ * nothing else: on a live classified deployment the search field could not
+ * reach a category at all, and the owner's own navigation canon rules out both
+ * of the usual workarounds — a picker, and a client-side typeahead over the
+ * whole tree.
+ *
+ * The server's answer is neither, and it carries the one thing a client-side
+ * matcher can never have: the number of LIVE listings behind each destination,
+ * computed as one aggregate over the index and equal to what `/query` reports
+ * for the same category. That number is what tells "Menswear / Shorts" from
+ * "Childrenswear / Shorts".
+ *
+ * Everything here is absent-safe. A server that predates 0.7.0 sends no
+ * `categories` key, `suggestCategories` is empty, and the box behaves exactly
+ * as it did — which is not a hypothetical: the key appeared mid-session on a
+ * stand that was redeployed underneath a running client.
  */
 import { useCallback, useEffect, useRef, useState } from "react";
 import { loadStateFromQuery, mapLoad } from "@stapel/core";
+import { SUGGEST_DEGRADED_CATEGORIES, SUGGEST_DEGRADED_ROLLUP, suggestTerms, } from "../api/types.js";
 import { useSearchState } from "./SearchStateProvider.js";
 import { useSuggest } from "../model/queries.js";
 import { SEARCH_BOX_DEBOUNCE_MS, SEARCH_BOX_SUGGEST_DEBOUNCE_MS, SEARCH_QUERY_MAX_CHARS, SUGGEST_MIN_CHARS, } from "../state/limits.js";
 /** One frozen empty list, so a render with no suggestions is a stable value. */
 const NO_SUGGESTIONS = [];
+/** The same, for the categories half. */
+const NO_CATEGORIES = [];
+/** Does this answer name a shortfall? Absent-safe on every older server. */
+function degradedWith(answer, literal) {
+    return answer?.degraded?.includes(literal) === true;
+}
+/**
+ * The destinations worth offering out of one answer.
+ *
+ * A category with a count of `0` is a section with nothing in it: following it
+ * lands the buyer on an empty SERP, which is a dead end dressed as a
+ * destination — and the server does return those (it reads the count with a
+ * `0` default and ranks them last), so somebody has to drop them.
+ *
+ * The one exception is `category_rollup`, where EVERY count is `0` because the
+ * ancestry never arrived rather than because the sections are empty. Filtering
+ * on the count there would delete the whole group for a reason that has
+ * nothing to do with what is in the catalogue, so the rows are kept and the
+ * numbers are what the surface omits.
+ */
+export function offerableCategories(answer) {
+    const categories = answer?.categories;
+    if (categories === undefined || categories.length === 0)
+        return NO_CATEGORIES;
+    if (degradedWith(answer, SUGGEST_DEGRADED_ROLLUP))
+        return categories;
+    return categories.filter((category) => category.count > 0);
+}
 export function useSearchBox(options = {}) {
-    const { state, setText } = useSearchState();
+    const { state, setText, patch } = useSearchState();
     const committed = state.q;
     const debounceMs = options.debounceMs ?? SEARCH_BOX_DEBOUNCE_MS;
     const [draft, setDraftState] = useState(committed);
@@ -98,7 +147,19 @@ export function useSearchBox(options = {}) {
         ...(options.suggestLimit !== undefined ? { limit: options.suggestLimit } : {}),
         enabled: options.suggest !== false,
     });
-    const suggestState = mapLoad(loadStateFromQuery(suggest), (data) => data.items);
+    const suggestState = mapLoad(loadStateFromQuery(suggest), suggestTerms);
+    // The READY answer only. A category row is a navigation control, and one
+    // rendered out of a stale answer would send a person somewhere the current
+    // prefix never named.
+    const answer = suggest.data;
+    const categories = offerableCategories(answer);
+    const chooseCategory = (category) => {
+        setDraftState("");
+        cancel();
+        // One write, so one history entry — see `SearchBoxBag.chooseCategory` for
+        // why the text goes with it.
+        patch({ q: "", category: category.category });
+    };
     return {
         draft,
         committed,
@@ -106,11 +167,15 @@ export function useSearchBox(options = {}) {
         suggestions: suggestState.status === "ready" ? suggestState.data : NO_SUGGESTIONS,
         suggestState,
         suggestLoading: suggest.isLoading && suggest.fetchStatus === "fetching",
+        categories,
+        categoriesUnavailable: degradedWith(answer, SUGGEST_DEGRADED_CATEGORIES),
+        categoryCountsUnknown: degradedWith(answer, SUGGEST_DEGRADED_ROLLUP),
         minSuggestChars: SUGGEST_MIN_CHARS,
         maxLength: SEARCH_QUERY_MAX_CHARS,
         setDraft,
         submit,
         clear,
+        chooseCategory,
     };
 }
 //# sourceMappingURL=useSearchBox.js.map

package/dist/headless/useSearchBox.js.map

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

package/dist/i18n/es.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"es.d.ts","sourceRoot":"","sources":["../../src/i18n/es.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,cA2IhC,CAAC;AAEF,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAE7D"}
+{"version":3,"file":"es.d.ts","sourceRoot":"","sources":["../../src/i18n/es.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAoJhC,CAAC;AAEF,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAE7D"}

package/dist/i18n/es.js

@@ -38,6 +38,9 @@ export const searchI18nBundleEs = {
     "search.box.submit": "Buscar",
     "search.box.clear": "Borrar la búsqueda",
     "search.box.suggestions": "Sugerencias",
+    "search.box.categories": "Secciones",
+    "search.box.category_count.one": "{count} anuncio",
+    "search.box.category_count.other": "{count} anuncios",
     "search.sort.label": "Orden",
     "search.sort.relevance": "Más relevantes",
     "search.sort.newest": "Más recientes",
@@ -58,6 +61,7 @@ export const searchI18nBundleEs = {
     "search.facets.skipped": "Estos filtros no se contaron para esta búsqueda: {slugs}",
     "search.facets.not_counted": "sin contar",
     "search.facets.drill_down_hint": "Cada recuento es lo que obtendrías eligiendo ese valor en lugar del actual.",
+    "search.range.price": "Precio",
     "search.facets.range_from": "Desde",
     "search.facets.range_to": "Hasta",
     "search.facets.range_apply": "Aplicar",
@@ -76,6 +80,7 @@ export const searchI18nBundleEs = {
     "search.filters.dismiss": "Cerrar los filtros",
     "search.filters.chips_label": "Filtros",
     "search.filters.all": "Todos los filtros",
+    "search.filters.short": "Filtros",
     "search.filters.chip_more": ", +{count}",
     "search.category.title": "Categoría",
     "search.category.clear": "Buscar en todo el catálogo",
@@ -116,6 +121,9 @@ export const searchI18nBundleEs = {
     "search.ranking.inactive": "No aplicado: {reason}",
     "search.ranking.notes": "Notas",
     "search.ranking.link": "Cómo se ordenan estos resultados",
+    "search.nav.results": "Buscar",
+    "search.nav.ranking": "Orden de resultados",
+    "search.nav.ranking.short": "Orden",
 };
 /** Register the es bundle. Call AFTER `registerSearchI18n`. */
 export function registerSearchI18nEs(engine) {

package/dist/i18n/es.js.map

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

package/dist/i18n/keys.d.ts

@@ -58,6 +58,22 @@ export declare const SEARCH_I18N_KEYS: {
     readonly boxClear: "search.box.clear";
     /** Accessible name of the suggestion list under the box. */
     readonly boxSuggestions: "search.box.suggestions";
+    /**
+     * The heading over the CATEGORY half of the type-ahead (stapel-search
+     * 0.7.0). The rows under it are DESTINATIONS — a section of the catalogue —
+     * and not, like everything else in the menu, another set of words to search
+     * for; a group with no heading would read as more of the same.
+     */
+    readonly boxCategories: "search.box.categories";
+    /**
+     * "1 240 listings" beside a category row — how many LIVE listings a buyer
+     * would see there, the same number the SERP reports for it.
+     *
+     * A PLURAL FAMILY: render with `tPlural`, never `t`. It counts a noun in
+     * words, so Russian needs its four endings and a single string would be
+     * right only for 5-20 — the exact defect the results count already fixed.
+     */
+    readonly boxCategoryCount: "search.box.category_count";
     readonly sortLabel: "search.sort.label";
     readonly sortRelevance: "search.sort.relevance";
     readonly sortNewest: "search.sort.newest";
@@ -91,6 +107,9 @@ export declare const SEARCH_I18N_KEYS: {
     readonly facetsRangeToAria: "search.facets.range_to_aria";
     /** The reason "Apply" is off: the range reads backwards. */
     readonly facetsRangeInvalid: "search.facets.range_invalid";
+    /** A CORE range axis has no FeatureDef and so no `name` to translate.
+     * `search.range.<slug>`; `price` is the one stapel-search ships. */
+    readonly rangePrice: "search.range.price";
     /** The fold on a long facet group: "Show all (46)". The number is in
      * brackets and not a counted noun, so this is one message and not a plural
      * family — "(1)" never renders, because a group is only folded when the
@@ -112,6 +131,9 @@ export declare const SEARCH_I18N_KEYS: {
     /** The leading, icon-only chip: the whole panel. Icon-only means the name
      * exists ONLY here, so this key is the control's entire accessibility. */
     readonly filtersAll: "search.filters.all";
+    /** The same door, named for a 390px row: the location line's trailing link
+     * sits beside a place name and cannot spend six characters on "All". */
+    readonly filtersShort: "search.filters.short";
     /** A chip filtering on more than one value: "Bosch, +2". Not a plural
      * family — nothing is being counted in words. */
     readonly filtersChipMore: "search.filters.chip_more";
@@ -176,6 +198,32 @@ export declare const SEARCH_I18N_KEYS: {
     readonly rankingInactive: "search.ranking.inactive";
     readonly rankingNotes: "search.ranking.notes";
     readonly rankingLink: "search.ranking.link";
+    /**
+     * What the MENU calls the results screen.
+     *
+     * Separate from `search.results.title` on purpose. That key captions the
+     * list of matches — a heading over rows, which is why it reads "Results" —
+     * and a menu entry pointing at `/s` labelled "Results" tells a visitor
+     * nothing about where they would be going: results of what? The destination
+     * is the search itself. One key, one job; a translator asked to make
+     * "Results" work as both a page heading and a menu label has to pick which
+     * one to get wrong.
+     */
+    readonly navResults: "search.nav.results";
+    /** The menu name of the P2B disclosure PAGE — see {@link navResults} for
+     * why it is not `search.ranking.title`, which is the page's own heading and
+     * a whole sentence. */
+    readonly navRanking: "search.nav.ranking";
+    /**
+     * The compact form for a phone dock — see `NavEntry.shortLabelKey`. A
+     * five-cell dock at 390px gives a destination roughly ten characters, and
+     * "Ranking disclosure" ellipsizes to a fragment there.
+     *
+     * `search.nav.results` needs no short form: it is already one word in every
+     * locale this pair ships, and declaring a short key identical to the long
+     * one only gives a translator two strings to keep in sync.
+     */
+    readonly navRankingShort: "search.nav.ranking.short";
 };
 export type SearchI18nKey = (typeof SEARCH_I18N_KEYS)[keyof typeof SEARCH_I18N_KEYS];
 /**

package/dist/i18n/keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/i18n/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/D;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB;;;;;;;IAS3B;;;;;;;OAOG;;IAEH;kEAC8D;;IAE9D,sEAAsE;;;;;;;IAOtE,yDAAyD;;;;;;;IAOzD,yEAAyE;;;;;;IAQzE,4DAA4D;;;;;;;;;IAa5D;2CACuC;;;;;;;;;;;;IAcvC,oEAAoE;;;;;;;IAOpE;kEAC8D;;;IAG9D,4DAA4D;;IAE5D;;;sCAGkC;;;;IAMlC,2DAA2D;;IAE3D;0BACsB;;IAEtB,uEAAuE;;;IAGvE;mEAC+D;;IAE/D;8EAC0E;;IAE1E;qDACiD;;;;;;;;;IAejD;iFAC6E;;;;;;IAQ7E;;;;;;;;OAQG;;;IAGH;;;;;;;;;;OAUG;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCK,CAAC;AAEX,MAAM,MAAM,aAAa,GACvB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,aAAa,EAM3D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0IrD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAEzD"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/i18n/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/D;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB;;;;;;;IAS3B;;;;;;;OAOG;;IAEH;kEAC8D;;IAE9D,sEAAsE;;;;;;;IAOtE,yDAAyD;;;;;;;IAOzD,yEAAyE;;;;;;IAQzE,4DAA4D;;IAE5D;;;;;OAKG;;IAEH;;;;;;;OAOG;;;;;;;;;IAaH;2CACuC;;;;;;;;;;;;IAcvC,oEAAoE;;;;;;;IAOpE;kEAC8D;;;IAG9D,4DAA4D;;IAE5D;wEACoE;;IAEpE;;;sCAGkC;;;;IAMlC,2DAA2D;;IAE3D;0BACsB;;IAEtB,uEAAuE;;;IAGvE;mEAC+D;;IAE/D;8EAC0E;;IAE1E;4EACwE;;IAExE;qDACiD;;;;;;;;;IAejD;iFAC6E;;;;;;IAQ7E;;;;;;;;OAQG;;;IAGH;;;;;;;;;;OAUG;;;;;;;;;;;;;;;;;;;;;;;;;;IAkCH;;;;;;;;;;OAUG;;IAEH;;2BAEuB;;IAEvB;;;;;;;;OAQG;;CAEK,CAAC;AAEX,MAAM,MAAM,aAAa,GACvB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,aAAa,EAO3D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmJrD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAEzD"}

package/dist/i18n/keys.js

@@ -60,6 +60,22 @@ export const SEARCH_I18N_KEYS = {
     boxClear: "search.box.clear",
     /** Accessible name of the suggestion list under the box. */
     boxSuggestions: "search.box.suggestions",
+    /**
+     * The heading over the CATEGORY half of the type-ahead (stapel-search
+     * 0.7.0). The rows under it are DESTINATIONS — a section of the catalogue —
+     * and not, like everything else in the menu, another set of words to search
+     * for; a group with no heading would read as more of the same.
+     */
+    boxCategories: "search.box.categories",
+    /**
+     * "1 240 listings" beside a category row — how many LIVE listings a buyer
+     * would see there, the same number the SERP reports for it.
+     *
+     * A PLURAL FAMILY: render with `tPlural`, never `t`. It counts a noun in
+     * words, so Russian needs its four endings and a single string would be
+     * right only for 5-20 — the exact defect the results count already fixed.
+     */
+    boxCategoryCount: "search.box.category_count",
     // ── sort ─────────────────────────────────────────────────────────────────
     sortLabel: "search.sort.label",
     sortRelevance: "search.sort.relevance",
@@ -96,6 +112,9 @@ export const SEARCH_I18N_KEYS = {
     facetsRangeToAria: "search.facets.range_to_aria",
     /** The reason "Apply" is off: the range reads backwards. */
     facetsRangeInvalid: "search.facets.range_invalid",
+    /** A CORE range axis has no FeatureDef and so no `name` to translate.
+     * `search.range.<slug>`; `price` is the one stapel-search ships. */
+    rangePrice: "search.range.price",
     /** The fold on a long facet group: "Show all (46)". The number is in
      * brackets and not a counted noun, so this is one message and not a plural
      * family — "(1)" never renders, because a group is only folded when the
@@ -118,6 +137,9 @@ export const SEARCH_I18N_KEYS = {
     /** The leading, icon-only chip: the whole panel. Icon-only means the name
      * exists ONLY here, so this key is the control's entire accessibility. */
     filtersAll: "search.filters.all",
+    /** The same door, named for a 390px row: the location line's trailing link
+     * sits beside a place name and cannot spend six characters on "All". */
+    filtersShort: "search.filters.short",
     /** 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",
@@ -189,6 +211,33 @@ export const SEARCH_I18N_KEYS = {
     rankingInactive: "search.ranking.inactive",
     rankingNotes: "search.ranking.notes",
     rankingLink: "search.ranking.link",
+    // ── nav (the destination's own name, not the page's heading) ─────────────
+    /**
+     * What the MENU calls the results screen.
+     *
+     * Separate from `search.results.title` on purpose. That key captions the
+     * list of matches — a heading over rows, which is why it reads "Results" —
+     * and a menu entry pointing at `/s` labelled "Results" tells a visitor
+     * nothing about where they would be going: results of what? The destination
+     * is the search itself. One key, one job; a translator asked to make
+     * "Results" work as both a page heading and a menu label has to pick which
+     * one to get wrong.
+     */
+    navResults: "search.nav.results",
+    /** The menu name of the P2B disclosure PAGE — see {@link navResults} for
+     * why it is not `search.ranking.title`, which is the page's own heading and
+     * a whole sentence. */
+    navRanking: "search.nav.ranking",
+    /**
+     * The compact form for a phone dock — see `NavEntry.shortLabelKey`. A
+     * five-cell dock at 390px gives a destination roughly ten characters, and
+     * "Ranking disclosure" ellipsizes to a fragment there.
+     *
+     * `search.nav.results` needs no short form: it is already one word in every
+     * locale this pair ships, and declaring a short key identical to the long
+     * one only gives a translator two strings to keep in sync.
+     */
+    navRankingShort: "search.nav.ranking.short",
 };
 /**
  * The keys above that are PLURAL FAMILIES rather than single messages.
@@ -211,6 +260,7 @@ export const SEARCH_I18N_PLURAL_KEYS = [
     SEARCH_I18N_KEYS.resultsCountExact,
     SEARCH_I18N_KEYS.filtersShowCount,
     SEARCH_I18N_KEYS.filtersShowCountAtLeast,
+    SEARCH_I18N_KEYS.boxCategoryCount,
 ];
 /**
  * English fallback bundle for search-react UI keys + backend error codes.
@@ -248,6 +298,9 @@ export const searchI18nBundleEn = {
     "search.box.submit": "Search",
     "search.box.clear": "Clear the search",
     "search.box.suggestions": "Suggestions",
+    "search.box.categories": "Sections",
+    "search.box.category_count.one": "{count} listing",
+    "search.box.category_count.other": "{count} listings",
     "search.sort.label": "Sort",
     "search.sort.relevance": "Most relevant",
     "search.sort.newest": "Newest first",
@@ -268,6 +321,7 @@ export const searchI18nBundleEn = {
     "search.facets.skipped": "These filters were not counted for this search: {slugs}",
     "search.facets.not_counted": "not counted",
     "search.facets.drill_down_hint": "Each count is what you would get by choosing that value instead of the one you have.",
+    "search.range.price": "Price",
     "search.facets.range_from": "From",
     "search.facets.range_to": "To",
     "search.facets.range_apply": "Apply",
@@ -286,6 +340,7 @@ export const searchI18nBundleEn = {
     "search.filters.dismiss": "Close the filters",
     "search.filters.chips_label": "Filters",
     "search.filters.all": "All filters",
+    "search.filters.short": "Filters",
     "search.filters.chip_more": ", +{count}",
     "search.category.title": "Category",
     "search.category.clear": "Search the whole catalogue",
@@ -326,6 +381,9 @@ export const searchI18nBundleEn = {
     "search.ranking.inactive": "Not applied: {reason}",
     "search.ranking.notes": "Notes",
     "search.ranking.link": "How these results are ordered",
+    "search.nav.results": "Search",
+    "search.nav.ranking": "Ranking disclosure",
+    "search.nav.ranking.short": "Ranking",
 };
 /**
  * Register the English bundle into a core i18n engine. Locale bundles ship as