@stapel/search-react 0.21.0 → 0.22.0

package/src/default/FacetGroupControl.tsx

@@ -19,6 +19,11 @@
  *  3. **A 60-option facet is not a list, it is a wall.** Every catalogue has
  *     one — brand, model, city — and printing all of it pushes every group
  *     under it off the screen.
+ *  4. **A vocabulary is not a long list, it is a DICTIONARY.** 418 car makes
+ *     behind "Show all (418)" is a control whose only mode is "read all of
+ *     it": the busiest values, a box, and the rest reachable by typing is the
+ *     only shape that answers "I want a Toyota" in one gesture. See
+ *     {@link isDictionaryFacet}.
  *
  * ── The presentation is DERIVED, never configured here ────────────────────
  *
@@ -59,12 +64,17 @@
  */
 import { useState } from "react";
 import type { CSSProperties, ReactElement } from "react";
-import { Button, Checkbox, Flex, Typography } from "antd";
+import { Button, Checkbox, Flex, Input, Typography } from "antd";
 import { useT } from "@stapel/core";
 import { radii, spacing } from "@stapel/tokens";
-import { featureConfig, featureType } from "@stapel/attributes-react";
+import {
+  VOCABULARY_BACKED_TYPES,
+  featureConfig,
+  featureType,
+} from "@stapel/attributes-react";
 import type { FeatureDef } from "@stapel/attributes-react";
 import type { FacetGroup, FacetOption } from "../state/facets.js";
+import { translitPrefixMatch } from "../state/translit.js";
 import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
 
 /**
@@ -77,8 +87,19 @@ import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
  */
 export const FACET_VISIBLE_OPTIONS = 8;
 
-/** The three shapes a facet group takes. */
-export type FacetGroupShape = "segmented" | "nested" | "checkbox";
+/**
+ * From how many values a group stops being a list and becomes a DICTIONARY —
+ * the same eight, because it is the same fold: past it the group is drawn as
+ * its busiest values plus a box that searches the rest.
+ */
+export const FACET_DICTIONARY_THRESHOLD: number = FACET_VISIBLE_OPTIONS;
+
+/** The four shapes a facet group takes. */
+export type FacetGroupShape =
+  | "segmented"
+  | "nested"
+  | "checkbox"
+  | "dictionary";
 
 /** The option rows of a group, already nested where the schema nests them. */
 export interface FacetOptionNode {
@@ -126,17 +147,52 @@ function singleChoice(feature: FeatureDef | undefined): boolean {
 }
 
 /**
- * Which of the three shapes a group takes.
+ * Is this group a DICTIONARY — a vocabulary's level, too long to scroll?
+ *
+ * Two ways to be one, because the schema is an optional slot and the live
+ * case is the one where it is empty:
+ *
+ *  - the def types the slug `ref_select`/`ref_hierarchical_select`, i.e. its
+ *    config is a POINTER into a vocabulary and there was never an option
+ *    table to draw;
+ *  - there is NO def at all and the answer came back with more values than a
+ *    fold. At a live classified's cars branch the storefront passed an empty
+ *    feature list, so the 418 makes arrived as an unnamed, untyped group of
+ *    418 checkboxes behind "Show all (418)". A box is the only control that
+ *    answers that, and refusing to draw one because the schema is missing
+ *    punishes the buyer for the wiring.
+ *
+ * Either way it takes more than {@link FACET_DICTIONARY_THRESHOLD} EVIDENCE
+ * buckets — values the answer actually counted. A zero-filled option table or
+ * a schema-only tail is a list a person can already read, and a box over it
+ * would search for values no document carries.
+ */
+export function isDictionaryFacet(group: FacetGroup): boolean {
+  const buckets = group.options.filter(
+    (option) => option.count !== null && option.count > 0
+  ).length;
+  if (buckets <= FACET_DICTIONARY_THRESHOLD) return false;
+  const feature = group.feature;
+  if (feature === undefined) return true;
+  const type = featureType(feature);
+  return type !== undefined && VOCABULARY_BACKED_TYPES.includes(type);
+}
+
+/**
+ * Which of the four shapes a group takes.
  *
  * Order matters: a hierarchical facet is nested even when it is single-choice,
- * because losing the tree costs more than losing the pills.
+ * because losing the tree costs more than losing the pills; and a dictionary
+ * is a dictionary before it is a checkbox list, because the checkbox list is
+ * the shape it was drawn as when nobody could pick a make.
  */
 export function facetGroupShape(group: FacetGroup): FacetGroupShape {
   const feature = group.feature;
   if (feature !== undefined && featureType(feature) === "hierarchical_select") {
     return "nested";
   }
-  return singleChoice(feature) ? "segmented" : "checkbox";
+  if (singleChoice(feature)) return "segmented";
+  return isDictionaryFacet(group) ? "dictionary" : "checkbox";
 }
 
 /**
@@ -327,6 +383,142 @@ function ChevronGlyph(props: { readonly open: boolean }): ReactElement {
   );
 }
 
+/**
+ * The list a dictionary scrolls in. A vocabulary level is 418 makes: without
+ * a ceiling the group alone is longer than the rail, and the box that filters
+ * it scrolls off the top of the panel while you type into it.
+ */
+const DICTIONARY_LIST: CSSProperties = {
+  maxBlockSize: 320,
+  overflowY: "auto",
+  // The scroll must not clip a focus ring against the panel's edge.
+  paddingInlineEnd: spacing[1],
+};
+
+/**
+ * A dictionary group: what is CHOSEN, a box, and the busiest values.
+ *
+ * ── Why the chosen values are their own block ─────────────────────────────
+ *
+ * They are the only rows that are not free to leave. A person who filtered by
+ * `Toyota` and then typed `bmw` must still be able to see — and undo — the
+ * filter that is narrowing what they are reading; a checkbox that scrolls out
+ * of the fold takes its own off-switch with it. So the chosen rows sit above
+ * the box, out of the filtered list entirely, and the list below never
+ * repeats them.
+ *
+ * ── The box filters LOCALLY, and matches across alphabets ─────────────────
+ *
+ * The buckets are already on the client — they arrived with the answer — so
+ * the box is a filter over an array and not a request per keystroke.
+ * `translitPrefixMatch` is what makes it usable in a catalogue whose values
+ * are Latin and whose buyers type Cyrillic: a Cyrillic "timberlend" finds
+ * `Timberland`.
+ * It is presentation, exactly like the panel's own search: nothing here
+ * touches the URL, because what a person typed to FIND a filter is not part
+ * of the search they would share.
+ */
+function DictionaryBody(props: {
+  readonly group: FacetGroup;
+  readonly onToggle: (slug: string, value: string) => void;
+  /** How many values before the box has to be used. */
+  readonly visible: number;
+}): ReactElement {
+  const t = useT();
+  const { group } = props;
+  const [needle, setNeedle] = useState("");
+  const [expanded, setExpanded] = useState(false);
+
+  const chosen = group.options.filter((option) => option.selected);
+  const rest = [...group.options.filter((option) => !option.selected)].sort(
+    (a, b) => (b.count ?? 0) - (a.count ?? 0)
+  );
+  const query = needle.trim();
+  const matched =
+    query === ""
+      ? rest
+      : rest.filter(
+          (option) =>
+            translitPrefixMatch(query, option.label) ||
+            translitPrefixMatch(query, option.value)
+        );
+  // The fold only exists while nothing is typed: a query has already narrowed
+  // the list, and hiding its tail behind "Show all" would hide the answer.
+  const folded = query === "" && !expanded && matched.length > props.visible;
+  const shown = folded ? matched.slice(0, props.visible) : matched;
+
+  return (
+    <Flex vertical gap={spacing[1]} data-testid={`facet-dictionary-${group.slug}`}>
+      {chosen.length > 0 && (
+        <Flex
+          vertical
+          gap={spacing[1]}
+          data-testid={`facet-dictionary-chosen-${group.slug}`}
+        >
+          <Typography.Text type="secondary">
+            {t(SEARCH_I18N_KEYS.facetsDictionaryChosen)}
+          </Typography.Text>
+          {chosen.map((option) => (
+            <CheckboxRow
+              key={option.value}
+              group={group}
+              node={{ option, depth: 0 }}
+              onToggle={props.onToggle}
+            />
+          ))}
+        </Flex>
+      )}
+      <Input
+        allowClear
+        size="small"
+        value={needle}
+        placeholder={t(SEARCH_I18N_KEYS.facetsDictionarySearch)}
+        aria-label={t(SEARCH_I18N_KEYS.facetsDictionarySearch)}
+        data-testid={`facet-dictionary-search-${group.slug}`}
+        onChange={(event) => {
+          setNeedle(event.target.value);
+        }}
+      />
+      {shown.length === 0 ? (
+        <Typography.Text
+          type="secondary"
+          data-testid={`facet-dictionary-empty-${group.slug}`}
+        >
+          {t(SEARCH_I18N_KEYS.facetsDictionaryEmpty)}
+        </Typography.Text>
+      ) : (
+        <Flex vertical gap={spacing[1]} style={DICTIONARY_LIST}>
+          {shown.map((option) => (
+            <CheckboxRow
+              key={option.value}
+              group={group}
+              node={{ option, depth: 0 }}
+              onToggle={props.onToggle}
+            />
+          ))}
+        </Flex>
+      )}
+      {query === "" && matched.length > props.visible && (
+        <Button
+          type="link"
+          size="small"
+          style={{ alignSelf: "flex-start", paddingInline: 0 }}
+          data-testid={`facet-more-${group.slug}`}
+          data-analytics="none"
+          data-analytics-reason="expanding a filter group is a read, not a flow step"
+          onClick={() => {
+            setExpanded((was) => !was);
+          }}
+        >
+          {expanded
+            ? t(SEARCH_I18N_KEYS.facetsShowLess)
+            : t(SEARCH_I18N_KEYS.facetsShowAll, { count: matched.length })}
+        </Button>
+      )}
+    </Flex>
+  );
+}
+
 export interface FacetGroupControlProps {
   readonly group: FacetGroup;
   readonly onToggle: (slug: string, value: string) => void;
@@ -386,6 +578,11 @@ export function FacetGroupControl(props: FacetGroupControlProps): ReactElement {
       data-testid={`facet-group-${group.slug}`}
       data-counted={group.counted ? "true" : "false"}
       data-shape={shape}
+      // Who named this heading — `none` means the raw slug is on screen
+      // because the answer sent no label and the schema defines none. It is
+      // drawn (a heading a person cannot read still beats none) and it is
+      // MARKED, so a storefront's own test can refuse to ship it.
+      data-label-source={group.labelSource}
     >
       {props.heading !== false &&
         (disclosure ? (
@@ -421,7 +618,15 @@ export function FacetGroupControl(props: FacetGroupControlProps): ReactElement {
       {/* Closed means NOT RENDERED, not hidden: a hundred `display:none`
           checkboxes are still a hundred stops for a screen reader, and the
           measured rail held 118 of them. */}
-      {open && (
+      {open && shape === "dictionary" && (
+        <DictionaryBody
+          group={group}
+          onToggle={props.onToggle}
+          visible={limit ?? FACET_VISIBLE_OPTIONS}
+        />
+      )}
+
+      {open && shape !== "dictionary" && (
         <>
           {shape === "segmented" ? (
             <Flex wrap gap={spacing[2]}>

package/src/default/PartitionChips.tsx

@@ -0,0 +1,161 @@
+/**
+ * `<PartitionChips>` — the children of a `chips` category, as one row of
+ * single-select chips.
+ *
+ * A partition is a category whose children are not subcategories but one
+ * template split by a value their names express: buy / sell / let / rent,
+ * new / used, for boys / for girls. They keep their
+ * ids, their paths and their URLs — a listing still lands on a child — and
+ * only the PRESENTATION changes: the parent draws a feed, and the children
+ * are a choice above it rather than a grid of tiles the visitor has to pass
+ * through.
+ *
+ * Which categories are a partition is not decided here and not decided by
+ * this pair: `children_as` is a stored, derivable field on the category, and
+ * the storefront hands this component the children it resolved. What this
+ * component owns is that the choice is SINGLE-select and that "all" — the
+ * parent, unnarrowed — is one of the options rather than a way of clearing
+ * the others.
+ *
+ * ── Why a radiogroup and not a row of toggles ─────────────────────────────
+ *
+ * Because exactly one of them is true at a time, and `aria-pressed` buttons
+ * say the opposite: they announce a set of independent switches, so a screen
+ * reader user hears no reason why pressing one released another. A radiogroup
+ * with roving tabindex is the pattern for "one of these": Tab reaches the row
+ * once and lands on the chosen chip, the arrow keys move along it, and the
+ * group's own name says what is being chosen.
+ */
+import { useRef } from "react";
+import type {
+  CSSProperties,
+  KeyboardEvent as ReactKeyboardEvent,
+  ReactElement,
+  ReactNode,
+} from "react";
+import { Button } from "antd";
+import { useT } from "@stapel/core";
+import { radii, spacing } from "@stapel/tokens";
+import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
+
+/** One child of a partitioned category. `path` is the slash-joined id path
+ * the `category` parameter takes — the same string `SearchQueryState.category`
+ * carries, so a host never rebuilds it from ids. */
+export interface PartitionChild {
+  readonly id: number | string;
+  readonly path: string;
+  readonly name: string;
+}
+
+export interface PartitionChipsProps {
+  /** The children, in the order the catalogue declares them. */
+  readonly items: readonly PartitionChild[];
+  /** The chosen child's `path`, or `null` for the parent itself. CONTROLLED:
+   * this row keeps no state, because the choice is a `category` in the URL. */
+  readonly value: string | null;
+  readonly onChange: (path: string | null) => void;
+  /** The first chip's label. Defaults to `search.partition.all`. */
+  readonly allLabel?: ReactNode;
+  /** The row's accessible name. Defaults to `search.partition.label`. */
+  readonly label?: string;
+}
+
+const CHIP: CSSProperties = { borderRadius: radii.full };
+
+const ROW: CSSProperties = {
+  display: "flex",
+  flexWrap: "wrap",
+  gap: spacing[2],
+};
+
+/** The row's cells, as `[value, label]` — the parent first, then the
+ * children in catalogue order. */
+function cells(
+  items: readonly PartitionChild[],
+  allLabel: ReactNode
+): readonly (readonly [string | null, ReactNode])[] {
+  return [
+    [null, allLabel] as const,
+    ...items.map((item) => [item.path, item.name] as const),
+  ];
+}
+
+export function PartitionChips(props: PartitionChipsProps): ReactElement {
+  const t = useT();
+  const row = useRef<HTMLDivElement>(null);
+  const options = cells(
+    props.items,
+    props.allLabel ?? t(SEARCH_I18N_KEYS.partitionAll)
+  );
+
+  /**
+   * Arrow keys move the choice AND the focus, which is what a radiogroup
+   * does: in a single-select row the focused option is the selected one, so
+   * moving focus without choosing would leave the two disagreeing.
+   */
+  const onKeyDown =
+    (index: number) =>
+    (event: ReactKeyboardEvent): void => {
+    const step =
+      event.key === "ArrowRight" || event.key === "ArrowDown"
+        ? 1
+        : event.key === "ArrowLeft" || event.key === "ArrowUp"
+          ? -1
+          : event.key === "Home"
+            ? -index
+            : event.key === "End"
+              ? options.length - 1 - index
+              : 0;
+    if (step === 0) return;
+    event.preventDefault();
+    const next = (index + step + options.length) % options.length;
+    const cell = options[next];
+    if (cell === undefined) return;
+    props.onChange(cell[0]);
+    const buttons = row.current?.querySelectorAll<HTMLElement>('[role="radio"]');
+    buttons?.[next]?.focus();
+  };
+
+  // A `value` naming no cell (a link into a child that has since moved) must
+  // still leave the row reachable by Tab, so the roving stop falls back to the
+  // parent chip rather than vanishing.
+  const active = options.findIndex(([value]) => value === props.value);
+  const stop = active >= 0 ? active : 0;
+
+  return (
+    <div
+      style={ROW}
+      ref={row}
+      role="radiogroup"
+      aria-label={props.label ?? t(SEARCH_I18N_KEYS.partitionLabel)}
+      data-testid="partition-chips"
+    >
+      {options.map(([value, label], index) => {
+        const selected = value === props.value;
+        return (
+          <Button
+            key={value ?? "__all__"}
+            size="small"
+            shape="round"
+            type={selected ? "primary" : "default"}
+            role="radio"
+            aria-checked={selected}
+            // Roving tabindex: the row is ONE Tab stop and it lands on the
+            // chosen chip, not on the first of eight.
+            tabIndex={index === stop ? 0 : -1}
+            style={CHIP}
+            data-testid={`partition-chip-${value ?? "all"}`}
+            data-analytics="none"
+            data-analytics-reason="choosing a section is a read, not a flow step"
+            onKeyDown={onKeyDown(index)}
+            onClick={() => {
+              props.onChange(value);
+            }}
+          >
+            {label}
+          </Button>
+        );
+      })}
+    </div>
+  );
+}

package/src/default/PopularValues.tsx

@@ -0,0 +1,151 @@
+/**
+ * `<PopularValues>` — the busiest values of one facet, printed as words a
+ * person can click, above the results.
+ *
+ * A dictionary facet in the rail answers "narrow this list"; it does not
+ * answer "what is IN this category". On a feed page of a cars leaf the second
+ * question is the one a visitor arrives with, and its answer is already in the
+ * envelope: `Toyota 802` is a bucket and its count. Printed as a multi-column
+ * block it is a table of contents for the category — the eleven makes that
+ * account for most of it, in one glance, each one a filter.
+ *
+ * ── What it is NOT ────────────────────────────────────────────────────────
+ *
+ * Not a replacement for the facet control: it shows the busy head of ONE
+ * group and says so with a link into the whole thing (`onShowAll`). Not a
+ * second source of counts either — the numbers are the answer's own
+ * drill-down counts, the same ones the checkbox rows carry, so a value cannot
+ * read `802` here and `93` in the panel.
+ *
+ * ── Hidden on a phone by a PROP ───────────────────────────────────────────
+ *
+ * `hidden` rather than a media query inside, because whether a 390px screen
+ * has room for a block of forty links is a decision about the PAGE, and the
+ * page is the storefront's. A component that hid itself below some width of
+ * its own choosing would take that decision away from the only surface that
+ * knows what else is on screen — and would still render the DOM, which is
+ * what `display: none` costs a screen reader.
+ */
+import type { CSSProperties, ReactElement, ReactNode } from "react";
+import { Button, Flex, Typography } from "antd";
+import { useT } from "@stapel/core";
+import { spacing } from "@stapel/tokens";
+import type { FacetGroup, FacetOption } from "../state/facets.js";
+import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
+
+/** How many values the block prints before the link into the full control. */
+export const POPULAR_VALUES_LIMIT = 12;
+
+/** How many columns the list flows into. Three fills a desktop content column
+ * without turning a make into a two-line wrap. */
+export const POPULAR_VALUES_COLUMNS = 3;
+
+/** A value with no evidence behind it is not a popular value. Uncounted
+ * options carry `count: null` and are dropped here rather than printed with a
+ * blank where the number belongs — the block IS the numbers. */
+function hasEvidence(option: FacetOption): boolean {
+  return option.count !== null && option.count > 0;
+}
+
+/** The busiest values of the group, count-descending, capped. */
+export function popularOptions(
+  group: FacetGroup,
+  limit: number = POPULAR_VALUES_LIMIT
+): readonly FacetOption[] {
+  return [...group.options.filter(hasEvidence)]
+    .sort((a, b) => (b.count ?? 0) - (a.count ?? 0))
+    .slice(0, limit);
+}
+
+const ROW: CSSProperties = {
+  // `break-inside` keeps a value and its count on one line when the browser
+  // decides where the column ends.
+  breakInside: "avoid",
+  display: "flex",
+  gap: spacing[2],
+  alignItems: "baseline",
+};
+
+export interface PopularValuesProps {
+  /** The group to print — normally the first `ref_select` of the plan. */
+  readonly group: FacetGroup;
+  /** Apply one value. Same signature as the panel's `toggle`, so a host can
+   * hand the facet bag's own function straight in. */
+  readonly onApply: (slug: string, value: string) => void;
+  /** Draw nothing. The phone, decided by the page — see the module note. */
+  readonly hidden?: boolean;
+  /** How many values. Default {@link POPULAR_VALUES_LIMIT}. */
+  readonly limit?: number;
+  /** How many columns. Default {@link POPULAR_VALUES_COLUMNS}. */
+  readonly columns?: number;
+  /** The block's heading. Defaults to the group's own label; `null` draws
+   * none, for a surface that has already named the axis. */
+  readonly heading?: ReactNode;
+  /** Open the full control. Absent draws no link — a link that goes nowhere
+   * is worse than a block that stops. */
+  readonly onShowAll?: () => void;
+}
+
+export function PopularValues(props: PopularValuesProps): ReactElement | null {
+  const t = useT();
+  const { group } = props;
+  if (props.hidden === true) return null;
+  const options = popularOptions(group, props.limit ?? POPULAR_VALUES_LIMIT);
+  if (options.length === 0) return null;
+
+  return (
+    <Flex
+      vertical
+      gap={spacing[2]}
+      data-testid={`popular-values-${group.slug}`}
+      data-label-source={group.labelSource}
+    >
+      {props.heading !== null && (
+        <Typography.Text strong>{props.heading ?? group.label}</Typography.Text>
+      )}
+      <div
+        style={{
+          columnCount: props.columns ?? POPULAR_VALUES_COLUMNS,
+          columnGap: spacing[4],
+        }}
+      >
+        {options.map((option) => (
+          <div key={option.value} style={ROW}>
+            <Button
+              type="link"
+              size="small"
+              style={{ paddingInline: 0, height: "auto" }}
+              data-testid={`popular-value-${group.slug}-${option.value}`}
+              data-analytics="none"
+              data-analytics-reason="a filter is a read, not a flow step"
+              onClick={() => {
+                props.onApply(group.slug, option.value);
+              }}
+            >
+              {option.label}
+            </Button>
+            <Typography.Text
+              type="secondary"
+              data-testid={`popular-count-${group.slug}-${option.value}`}
+            >
+              {option.count}
+            </Typography.Text>
+          </div>
+        ))}
+      </div>
+      {props.onShowAll !== undefined && (
+        <Button
+          type="link"
+          size="small"
+          style={{ alignSelf: "flex-start", paddingInline: 0 }}
+          data-testid={`popular-all-${group.slug}`}
+          data-analytics="none"
+          data-analytics-reason="opening a filter control is a read, not a flow step"
+          onClick={props.onShowAll}
+        >
+          {t(SEARCH_I18N_KEYS.facetsPopularAll)}
+        </Button>
+      )}
+    </Flex>
+  );
+}

package/src/default/index.ts

@@ -72,6 +72,8 @@ export {
   FacetGroupControl,
   facetGroupShape,
   facetOptionNodes,
+  isDictionaryFacet,
+  FACET_DICTIONARY_THRESHOLD,
   FACET_VISIBLE_OPTIONS,
 } from "./FacetGroupControl.js";
 export type {
@@ -80,6 +82,19 @@ export type {
   FacetOptionNode,
 } from "./FacetGroupControl.js";
 
+// ── the browse surfaces a storefront PLACES (this pair does not lay them
+//    out: where a popular-values block or a partition row belongs on a
+//    category page is the page's decision) ──────────────────────────────────
+export {
+  PopularValues,
+  popularOptions,
+  POPULAR_VALUES_COLUMNS,
+  POPULAR_VALUES_LIMIT,
+} from "./PopularValues.js";
+export type { PopularValuesProps } from "./PopularValues.js";
+export { PartitionChips } from "./PartitionChips.js";
+export type { PartitionChild, PartitionChipsProps } from "./PartitionChips.js";
+
 export { FacetPanelPane } from "./FacetPanelPane.js";
 export type {
   FacetPanelPaneProps,

package/src/headless/useFacetLabels.ts

@@ -32,7 +32,7 @@
  *   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
+ * and it marks an option it could not name `labelSource: "none"` — 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
@@ -98,7 +98,7 @@ const NO_REQUESTS: readonly FacetLabelRequest[] = [];
 /** The values of one group nobody has named — see the precedence note above. */
 function unresolvedValues(group: FacetGroup): readonly string[] {
   return group.options
-    .filter((option) => option.label === option.value)
+    .filter((option) => option.labelSource === "none")
     .map((option) => option.value)
     .sort((a, b) => a.localeCompare(b));
 }
@@ -157,14 +157,14 @@ export function useHostFacetLabels(
       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;
+          // Precedence again, enforced rather than assumed: an option the
+          // server or the schema already named is not the host's to
+          // overwrite. The source says so; the strings cannot.
+          if (option.labelSource !== "none") return option;
           const caption = named[option.value];
           return caption === undefined || caption.length === 0
             ? option
-            : { ...option, label: caption };
+            : { ...option, label: caption, labelSource: "host" as const };
         }),
       };
     })

package/src/i18n/es.ts

@@ -93,6 +93,12 @@ export const searchI18nBundleEs: I18nDictionary = {
   "search.facets.show_less": "Ver menos",
   "search.facets.search": "Buscar un filtro",
   "search.facets.search_empty": "Ningún filtro coincide con esto",
+  "search.facets.dictionary_search": "Buscar un valor",
+  "search.facets.dictionary_empty": "Ningún valor coincide con esto",
+  "search.facets.dictionary_chosen": "Elegido",
+  "search.facets.popular_all": "Todos",
+  "search.partition.all": "Todos",
+  "search.partition.label": "Sección",
   "search.facets.match_count.one": "{count} anuncio coincide",
   "search.facets.match_count.other": "{count} anuncios coinciden",
   "search.facets.range_invalid":