@stapel/search-react 0.10.0 → 0.11.0

package/dist/state/ranges.js

@@ -6,13 +6,23 @@
  * the panel only knew how to draw checkboxes. This module is the missing half:
  * which slugs a range row exists for, and what the row is called.
  *
- * ── Where a range row comes from, and why it is not the response ───────────
+ * ── Where a range row comes from ──────────────────────────────────────────
  *
- * A facet answer (`facets: {slug: {value: count}}`) enumerates DISCRETE values;
- * a range is not enumerable and the server never sends one. So the rows come
- * from the CATEGORY SCHEMA — the same `categoryFeatures` slot that gives the
- * checkboxes their labels — filtered to the numeric value types, plus every
- * slug the URL already carries a range for.
+ * A facet answer (`facets: {slug: {value: count}}`) enumerates DISCRETE
+ * values; a range is not enumerable and no bucket is ever sent for one. So
+ * the rows come from two places:
+ *
+ *  - the CATEGORY SCHEMA — the same `categoryFeatures` slot that gives the
+ *    checkboxes their labels — filtered to the numeric value types;
+ *  - the ANSWER's `facet_meta.core_ranges` (stapel-search 0.4.0+), which
+ *    names the range slugs addressing a COLUMN of the document rather than
+ *    an attribute. `price` is the shipped one, and it is why this module
+ *    exists at all: a live classified board offered seven numeric ranges,
+ *    every one of them a shipping or wholesale input, and no price — because
+ *    price is not a category feature anywhere, and a row was only ever drawn
+ *    for a feature.
+ *
+ * Plus every slug the URL already carries a range for.
  *
  * That last clause is the same rule `buildFacetGroups` follows for a filtered
  * slug that fell out of the plan: a constraint that is ACTIVE must always have
@@ -35,6 +45,15 @@ export const RANGE_FEATURE_TYPES = [
     "float",
     "convertible_unit",
 ];
+/**
+ * i18n key for a core axis's own name.
+ *
+ * A core axis has no FeatureDef and therefore no `name` to translate. The
+ * label is this package's, because the axis is this package's.
+ */
+export function coreRangeLabelKey(slug) {
+    return `search.range.${slug}`;
+}
 function num(value) {
     return typeof value === "number" && Number.isFinite(value) ? value : undefined;
 }
@@ -53,17 +72,27 @@ export function isRangeFeature(feature) {
     return type !== undefined && RANGE_FEATURE_TYPES.includes(type);
 }
 /**
- * The range rows for the current search: every numeric feature of the
- * category, in the schema's own order, plus any slug the URL constrains that
- * the schema does not explain.
+ * The range rows for the current search, in the order they should be read:
+ * the CORE axes the answer declares, then every numeric feature of the
+ * category in the schema's own order, then any slug the URL constrains that
+ * neither explains.
+ *
+ * Core first is not cosmetic. On the board this was measured against, the
+ * seven numeric attributes a phone category happens to declare are all
+ * shipping and wholesale inputs; the one number a phone buyer narrows by is
+ * the price, and it belongs above them.
  */
 export function buildRangeGroups(input) {
     const bySlug = new Map();
     for (const feature of input.categoryFeatures ?? [])
         bySlug.set(feature.slug, feature);
-    const slugs = [];
+    const core = new Set(input.coreRanges ?? []);
+    const slugs = [...core];
     for (const feature of input.categoryFeatures ?? []) {
-        if (isRangeFeature(feature))
+        // A core slug shadows a same-named attribute — which is exactly what the
+        // server does with it (`index_schema.CORE_RANGE_FIELDS` reserves the
+        // slug), so drawing both would put two controls over one filter.
+        if (isRangeFeature(feature) && !core.has(feature.slug))
             slugs.push(feature.slug);
     }
     for (const slug of Object.keys(input.state.ranges)) {
@@ -71,20 +100,32 @@ export function buildRangeGroups(input) {
             slugs.push(slug);
     }
     return slugs.map((slug) => {
-        const feature = bySlug.get(slug);
+        const isCore = core.has(slug);
+        const feature = isCore ? undefined : bySlug.get(slug);
         const config = feature === undefined ? {} : featureConfig(feature);
         const applied = input.state.ranges[slug];
         return {
             slug,
-            label: feature === undefined ? slug : translate(input.t, featureName(feature)),
+            label: isCore
+                ? translate(input.t, coreRangeLabelKey(slug))
+                : feature === undefined
+                    ? slug
+                    : translate(input.t, featureName(feature)),
             feature,
             from: applied?.from,
             to: applied?.to,
             min: num(config["min"]),
             max: num(config["max"]),
-            unit: str(config["postfix"]) ?? str(config["unit_m"]) ?? str(config["unit_i"]),
+            // A core money axis carries a CURRENCY, not a unit suffix: "₽" is
+            // formatted from the code for the reader's locale, a unit suffix is a literal
+            // the category author typed.
+            unit: isCore
+                ? undefined
+                : (str(config["postfix"]) ?? str(config["unit_m"]) ?? str(config["unit_i"])),
             step: feature !== undefined && featureType(feature) === "int" ? 1 : undefined,
             active: applied !== undefined,
+            core: isCore,
+            currency: isCore ? str(input.currency) : undefined,
         };
     });
 }

package/dist/state/ranges.js.map

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

package/llms.txt

@@ -1,6 +1,6 @@
-# @stapel/search-react 0.10.0
+# @stapel/search-react 0.11.0
 
-Headless React flow pair for stapel-search (contract >=0.3 <0.4) — business + state, zero visual opinion.
+Headless React flow pair for stapel-search (contract >=0.4 <0.5) — business + state, zero visual opinion.
 Built on @stapel/core: typed client + StapelApiError envelope, auth token refresh,
 verification-403 interception, i18n engine, analytics facade, TanStack Query layer.
 

package/manifest.json

@@ -1,10 +1,10 @@
 {
   "$generated": "by scripts/gen-manifest.mjs — do not edit; drift-gated (pnpm gen:manifest:check)",
   "package": "@stapel/search-react",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "backend": {
     "module": "stapel-search",
-    "contract": ">=0.3 <0.4"
+    "contract": ">=0.4 <0.5"
   },
   "layers": [
     "api",
@@ -763,6 +763,7 @@
     "search.limit.from_link",
     "search.limit.label",
     "search.limit.option",
+    "search.range.price",
     "search.ranking.applies_to",
     "search.ranking.empty",
     "search.ranking.inactive",
@@ -848,11 +849,13 @@
       "buildFacetGroups",
       "buildRangeGroups",
       "clearFilters",
+      "coreRangeLabelKey",
       "countIsEstimate",
       "countKind",
       "countQueryState",
       "createSearchApi",
       "createSearchRuntime",
+      "degradationAudience",
       "degradationMessageKey",
       "explainSearchError",
       "facetOptionLabel",
@@ -864,6 +867,7 @@
       "parseDegradations",
       "parseSearchState",
       "patchSearchState",
+      "readerFacing",
       "registerSearchI18n",
       "searchErrorBundleEn",
       "searchI18nBundleEn",
@@ -908,6 +912,7 @@
       "SearchCountKind",
       "SearchCountState",
       "SearchDegradation",
+      "SearchDegradationAudience",
       "SearchDegradationKind",
       "SearchErrorCode",
       "SearchErrorSpec",

package/nav-manifest.json

@@ -1,6 +1,6 @@
 {
   "package": "@stapel/search-react",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "entries": [
     {
       "id": "search.results",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stapel/search-react",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Headless React pair for stapel-search: a typed query client, TanStack Query hooks, and a URL-first state codec that makes a search shareable by construction (filters, ranges, geo, sort and the keyset cursor all live in the query string). Drill-down facets rendered with their remaining counts and with the server's own honesty flags — approximate, skipped, degraded — never swallowed; keyset pagination with the window refusal named; DSA Art. 26 `promoted` marking carried into every card slot and the P2B Art. 5 ranking disclosure exposed as data. Zero visual opinion in the main entry; an opt-in /default subpath ships the antd skin, and /router binds the codec to react-router's useSearchParams.",
   "license": "MIT",
   "repository": {
@@ -116,11 +116,11 @@
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
     "@stapel/attributes-react": "^0.5.0",
-    "@stapel/core": "^0.20.0",
+    "@stapel/core": "^0.21.0",
     "@stapel/image": "^0.4.2",
-    "@stapel/showcase": "^0.3.0",
     "@stapel/tokens": "^0.6.0",
-    "@stapel/tokens-antd": "^0.9.0"
+    "@stapel/tokens-antd": "^0.10.0",
+    "@stapel/showcase": "^0.3.0"
   },
   "engines": {
     "node": ">=22"

package/src/analytics/generated/events.json

@@ -1,7 +1,7 @@
 {
   "$generated": "by scripts/gen-events.mjs — do not edit; drift-gated (pnpm gen:events:check)",
   "package": "@stapel/search-react",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "defined": [],
   "flows": []
 }

package/src/api/generated/schema.ts

@@ -124,6 +124,14 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        /** @description Captions for one slug's option codes. */
+        FacetLabels: {
+            /** @description True when `values` holds translation KEYS to run through the catalogue; false when it holds literal captions. The reader cannot tell by looking — `b.apple` and `Б/у` are both strings. */
+            translatable: boolean;
+            values: {
+                [key: string]: string;
+            };
+        };
         FacetMeta: {
             /** @description True when counts came from a sample because the candidate set exceeded FACET_CANDIDATE_CAP. */
             approximate: boolean;
@@ -132,6 +140,8 @@ export interface components {
             counted: string[];
             /** @description Plan slugs dropped at MAX_FACET_FIELDS — reported, not vanished. */
             skipped: string[];
+            /** @description Range slugs that address a core document column rather than an attribute (`r.price`). Offer them as filters unconditionally: they exist for every document in every category, which is why they are not in the category's own plan. */
+            core_ranges: string[];
         };
         HealthResponse: {
             backend: string;
@@ -208,6 +218,10 @@ export interface components {
                     [key: string]: number;
                 };
             };
+            /** @description {slug: {translatable, values: {value: caption}}} for slugs whose options are inline in the category schema. Absent for a vocabulary-backed slug: its level lives outside the schema and the plan will not invent a caption it has not read. */
+            facet_labels: {
+                [key: string]: components["schemas"]["FacetLabels"];
+            };
             facet_meta: components["schemas"]["FacetMeta"];
             next_anchor: string | null;
             prev_anchor: string | null;
@@ -222,6 +236,8 @@ export interface components {
             /** @description What the configured engine could not do for this query. */
             degraded: string[];
             backend: string;
+            /** @description The language whose dictionary and analyzer configuration answered — `lang`, else Accept-Language, else DEFAULT_LANGUAGE. When the fallback is wrong the synonym layer silently does not apply, and this field is the only place the answer says so. */
+            language: string;
             sort: string;
             took_ms: number;
         };

package/src/default/DegradationNotice.tsx

@@ -12,27 +12,34 @@
  *
  * ── Two deliberate ways NOT to shout ───────────────────────────────────────
  *
- * 1. **`exact_total` alone never raises a banner.** It is a count NUANCE, not
- *    a failed search: the rows are right, and the single consequence — that
- *    the total is a floor — is already spoken by the count as "N+". A warning
- *    box over a perfectly good result page teaches the reader that the page
- *    is broken, and a banner that cries wolf on every landing page is a
- *    banner nobody reads on the day `category_rollup` appears in it. Beside
- *    any other degradation it renders normally, because the list is then
- *    describing an answer that really is degraded. See
- *    {@link isCountNuanceOnly}.
+ * 1. **A degradation addressed to the OPERATOR never reaches the reader.**
+ *    `typo_tolerance` and `phrase_synonyms` both say, in the shipped ru copy,
+ *    "the search engine in use cannot do this" — a sentence about which
+ *    engine somebody licensed, printed at a person trying to buy a phone. It
+ *    is the same sentence on every query forever, which is what makes it
+ *    invisible by the day `category_rollup` shows up in the same box.
+ *    `exact_total` joins them: the count already says "N+".
+ *
+ *    Measured live on a classified board: a full-screen yellow "synonyms
+ *    were not substituted" between the sort control and the first card, on every
+ *    query, for every buyer. Note what the fix is NOT — the string was not
+ *    deleted and the kind was not special-cased. `readerFacing` names the
+ *    *audience*, so the next engine-capability literal is filtered by the
+ *    same rule instead of growing its own copy of this comment.
  * 2. **`variant`.** A catalogue page wants the banner; a landing page that
  *    shows six cards under a hero has no room for a warning box and passes
- *    `"inline"` (one quiet line) or `"off"`. `"off"` is a decision the
- *    CONTAINER makes about ITS surface — the notice stays the default, and
- *    nothing here silences a degradation for everyone.
+ *    `"inline"` (one quiet line) or `"off"`. `"debug"` is the operator's
+ *    view: everything, unfiltered, for a status page or a support tool.
+ *    `"off"` is a decision the CONTAINER makes about ITS surface — the
+ *    notice stays the default, and nothing here silences a reader-facing
+ *    degradation for everyone.
  */
 import type { ReactElement } from "react";
 import { Alert, Flex, Typography } from "antd";
 import { fontSize, spacing } from "@stapel/tokens";
 import { useT } from "@stapel/core";
 import type { SearchDegradation } from "../api/types.js";
-import { isCountNuanceOnly } from "../state/degradations.js";
+import { readerFacing } from "../state/degradations.js";
 import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
 
 /**
@@ -40,10 +47,12 @@ import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
  *
  * - `"banner"` (default) — an antd warning `Alert` with one line per item.
  * - `"inline"` — the same sentences as quiet secondary text, no box.
+ * - `"debug"` — every degradation including the operator's, for a status page
+ *   or a support tool. The one variant that does not filter by audience.
  * - `"off"` — nothing. For a surface where the notice does not belong at all;
  *   the container that turns it off owns saying so somewhere else.
  */
-export type DegradationNoticeVariant = "banner" | "inline" | "off";
+export type DegradationNoticeVariant = "banner" | "inline" | "debug" | "off";
 
 export interface DegradationNoticeProps {
   readonly degradations: readonly SearchDegradation[];
@@ -63,9 +72,10 @@ export function DegradationNotice(
   const t = useT();
   const variant: DegradationNoticeVariant = props.variant ?? "banner";
   if (variant === "off") return null;
-  if (props.degradations.length === 0) return null;
-  // A count nuance is not a degraded search — the count already says "N+".
-  if (isCountNuanceOnly(props.degradations)) return null;
+  // Everything, or only what this page's reader can act on.
+  const degradations =
+    variant === "debug" ? props.degradations : readerFacing(props.degradations);
+  if (degradations.length === 0) return null;
 
   const say = (degradation: SearchDegradation): string => {
     const slug = degradation.scorer;
@@ -82,7 +92,7 @@ export function DegradationNotice(
   // theme's warning tint, and grey body text on it measured under 3:1 in the
   // visual pass. Inside a coloured box the readable colour is the box's own
   // text colour, which is what a plain `<Typography.Text>` inherits.
-  const lines = props.degradations.map((degradation) => (
+  const lines = degradations.map((degradation) => (
     <li key={degradation.raw} data-degradation={degradation.raw}>
       <Typography.Text>{say(degradation)}</Typography.Text>
     </li>
@@ -95,7 +105,7 @@ export function DegradationNotice(
           {t(SEARCH_I18N_KEYS.degradedTitle)}
         </Typography.Text>
         <ul style={{ margin: 0, paddingInlineStart: spacing[5], fontSize: fontSize.xs.fontSize }}>
-          {props.degradations.map((degradation) => (
+          {degradations.map((degradation) => (
             <li key={degradation.raw} data-degradation={degradation.raw}>
               <Typography.Text type="secondary">{say(degradation)}</Typography.Text>
             </li>
@@ -110,7 +120,7 @@ export function DegradationNotice(
       type="warning"
       showIcon
       data-testid="search-degraded"
-      data-variant="banner"
+      data-variant={variant === "debug" ? "debug" : "banner"}
       title={t(SEARCH_I18N_KEYS.degradedTitle)}
       description={
         <ul style={{ margin: 0, paddingInlineStart: spacing[5] }}>{lines}</ul>

package/src/default/FacetPanelPane.tsx

@@ -306,13 +306,6 @@ function skippedNames(
 export function FacetPanelPane(props: FacetPanelPaneProps): ReactElement {
   const t = useT();
   const { state } = useSearchState();
-  const ranges = buildRangeGroups({
-    state,
-    ...(props.categoryFeatures !== undefined
-      ? { categoryFeatures: props.categoryFeatures }
-      : {}),
-    t,
-  });
 
   return (
     <SkinTheme {...(props.mode !== undefined ? { mode: props.mode } : {})}>
@@ -323,7 +316,24 @@ export function FacetPanelPane(props: FacetPanelPaneProps): ReactElement {
         {...(props.locale !== undefined ? { locale: props.locale } : {})}
         {...(props.enabled !== undefined ? { enabled: props.enabled } : {})}
       >
-        {(bag) => (
+        {(bag) => {
+          // Built INSIDE the bag, because which axes exist is a property of
+          // the ANSWER now: `facet_meta.core_ranges` names the core columns
+          // this server can actually filter on (`r.price`), and the corpus
+          // currency is read off the cards it just returned. Computed
+          // outside, the panel would have had to keep its own list of core
+          // slugs — which is how a board ends up offering a price filter
+          // against a server that answers zero for one.
+          const ranges = buildRangeGroups({
+            state,
+            ...(props.categoryFeatures !== undefined
+              ? { categoryFeatures: props.categoryFeatures }
+              : {}),
+            coreRanges: bag.coreRanges,
+            ...(bag.currency !== undefined ? { currency: bag.currency } : {}),
+            t,
+          });
+          return (
           <Flex vertical gap={spacing[3]} data-testid="search-facets">
             <Flex justify="space-between" align="center" gap={spacing[2]}>
               {props.heading === null ? (
@@ -360,6 +370,25 @@ export function FacetPanelPane(props: FacetPanelPaneProps): ReactElement {
               {...(props.geoLabel !== undefined ? { label: props.geoLabel } : {})}
             />
 
+            {/* Price first. Every numeric row below it is an ATTRIBUTE the
+                category happens to declare — on the phone board this was
+                measured against, all seven of them were parcel dimensions
+                and wholesale packing. The one number a buyer narrows by is
+                the price, and `buildRangeGroups` puts the core axes first. */}
+            {ranges.length > 0 && (
+              <Flex vertical gap={spacing[3]} data-testid="search-ranges">
+                {ranges.map((group) => (
+                  <RangeFilterRow
+                    key={group.slug}
+                    group={group}
+                    onApply={bag.setRange}
+                  />
+                ))}
+              </Flex>
+            )}
+
+            {ranges.length > 0 && <Divider style={{ margin: 0 }} />}
+
             {/* Honesty flags, not failures: the counts ARE approximate and
                 those slugs WERE skipped, and a red box would teach a person
                 the page is broken. `ErrorAlert` is for a read that did not
@@ -383,20 +412,6 @@ export function FacetPanelPane(props: FacetPanelPaneProps): ReactElement {
               />
             )}
 
-            {ranges.length > 0 && (
-              <Flex vertical gap={spacing[3]} data-testid="search-ranges">
-                {ranges.map((group) => (
-                  <RangeFilterRow
-                    key={group.slug}
-                    group={group}
-                    onApply={bag.setRange}
-                  />
-                ))}
-              </Flex>
-            )}
-
-            {ranges.length > 0 && <Divider style={{ margin: 0 }} />}
-
             <LoadList
               state={bag.state}
               testId="facets"
@@ -440,7 +455,8 @@ export function FacetPanelPane(props: FacetPanelPaneProps): ReactElement {
               )}
             </LoadList>
           </Flex>
-        )}
+          );
+        }}
       </FacetPanel>
     </SkinTheme>
   );

package/src/default/FilterChips.tsx

@@ -153,11 +153,16 @@ export function FilterChips(props: FilterChipsProps): ReactElement {
   const surface = useDialogSurface();
   const [open, setOpen] = useState<OpenChip>(null);
 
+  // Same source as the panel's rows, so the phone chip row and the desktop
+  // panel cannot disagree about which axes exist: the core columns come from
+  // the ANSWER (`facet_meta.core_ranges`) and the currency off its cards.
   const ranges = buildRangeGroups({
     state,
     ...(props.categoryFeatures !== undefined
       ? { categoryFeatures: props.categoryFeatures }
       : {}),
+    coreRanges: bag.coreRanges,
+    ...(bag.currency !== undefined ? { currency: bag.currency } : {}),
     t,
   });
   const groups =

package/src/default/RangeFilterRow.tsx

@@ -18,7 +18,7 @@
 import { useRef, useState } from "react";
 import type { ReactElement } from "react";
 import { Button, Flex, InputNumber, Typography } from "antd";
-import { actionAvailable, actionBlocked, useT } from "@stapel/core";
+import { actionAvailable, actionBlocked, useFormat, useT } from "@stapel/core";
 import type { ActionAvailability } from "@stapel/core";
 import { GatedButton } from "@stapel/tokens-antd/skin";
 import { spacing } from "@stapel/tokens";
@@ -40,8 +40,39 @@ function toDraft(value: string | undefined): string {
   return value ?? "";
 }
 
+/**
+ * The suffix a bound field carries: a currency SYMBOL for a money axis, the
+ * category's own unit string otherwise.
+ *
+ * `group.currency` is an ISO 4217 code and `RUB` beside an input is not what
+ * money looks like anywhere; `Intl` knows the symbol per locale, so the code
+ * goes in and «₽» comes out. An unsupported code falls back to the code
+ * itself — still better than nothing, and it never throws inside a render.
+ */
+function boundSuffix(
+  format: ReturnType<typeof useFormat>,
+  group: RangeGroup
+): string | undefined {
+  if (group.currency === undefined) return group.unit;
+  if (!/^[A-Za-z]{3}$/.test(group.currency)) return group.currency;
+  try {
+    const sample = format.number(0, {
+      style: "currency",
+      currency: group.currency.toUpperCase(),
+      currencyDisplay: "narrowSymbol",
+      maximumFractionDigits: 0,
+    });
+    if (sample === null) return group.currency;
+    const symbol = sample.replace(/[\s\u00a0\u202f0-9.,]/g, "");
+    return symbol.length > 0 ? symbol : group.currency;
+  } catch {
+    return group.currency;
+  }
+}
+
 export function RangeFilterRow(props: RangeFilterRowProps): ReactElement {
   const t = useT();
+  const format = useFormat();
   const { group } = props;
   const [from, setFrom] = useState(toDraft(group.from));
   const [to, setTo] = useState(toDraft(group.to));
@@ -71,7 +102,23 @@ export function RangeFilterRow(props: RangeFilterRowProps): ReactElement {
     props.onApply(group.slug, empty ? null : draft);
   };
 
-  const unit = group.unit === undefined ? "" : ` ${group.unit}`;
+  const suffix = boundSuffix(format, group);
+  const unit = suffix === undefined ? "" : ` ${suffix}`;
+  // Thousands grouping inside the field, because a price is read in
+  // thousands: `119000` is a wall of digits and `119 000` is a number. The
+  // parser is digits-only, so whatever the locale's separator turns out to
+  // be, the value that leaves the control is still the one the URL carries.
+  const grouping =
+    group.core
+      ? {
+          formatter: (value: string | number | undefined): string =>
+            value === undefined || value === ""
+              ? ""
+              : (format.number(Number(value)) ?? String(value)),
+          parser: (value: string | undefined): string =>
+            (value ?? "").replace(/[^\d.-]/g, ""),
+        }
+      : {};
 
   return (
     <Flex
@@ -79,8 +126,17 @@ export function RangeFilterRow(props: RangeFilterRowProps): ReactElement {
       gap={spacing[1]}
       data-testid={`facet-range-${group.slug}`}
       data-active={group.active ? "true" : "false"}
+      data-core={group.core ? "true" : "false"}
     >
-      <Typography.Text strong>{group.label}</Typography.Text>
+      {/* The unit lives in the HEADING, not in the fields. It used to live
+          only in an aria-label, so a sighted reader of a money row saw two
+          bare integers and had to infer the currency from the results. antd
+          deprecated `addonAfter` on InputNumber in favour of `Space.Compact`,
+          and two addons plus an Apply button do not survive a 390px row —
+          "Price, RUB" states it once and costs no width. */}
+      <Typography.Text strong data-testid={`facet-range-${group.slug}-label`}>
+        {suffix === undefined ? group.label : `${group.label}, ${suffix}`}
+      </Typography.Text>
       <Flex gap={spacing[2]} align="center" wrap>
         <InputNumber
           value={from === "" ? null : Number(from)}
@@ -90,6 +146,7 @@ export function RangeFilterRow(props: RangeFilterRowProps): ReactElement {
           })}${unit}`}
           data-testid={`facet-range-${group.slug}-from`}
           style={{ minWidth: RANGE_FIELD_MIN_WIDTH }}
+          {...grouping}
           {...(group.min !== undefined ? { min: group.min } : {})}
           {...(group.max !== undefined ? { max: group.max } : {})}
           {...(group.step !== undefined ? { step: group.step } : {})}
@@ -106,6 +163,7 @@ export function RangeFilterRow(props: RangeFilterRowProps): ReactElement {
           })}${unit}`}
           data-testid={`facet-range-${group.slug}-to`}
           style={{ minWidth: RANGE_FIELD_MIN_WIDTH }}
+          {...grouping}
           {...(group.min !== undefined ? { min: group.min } : {})}
           {...(group.max !== undefined ? { max: group.max } : {})}
           {...(group.step !== undefined ? { step: group.step } : {})}