@stapel/search-react 0.1.0 → 0.3.0

package/dist/i18n/ru.js

@@ -7,7 +7,7 @@ export { searchErrorBundleRu } from "./generated/errors.ru.gen.js";
  * entry does not import this module — gated by size-limit + the bundle-purity
  * test).
  *
- * This is the storefront's DEFAULT language (darom-storefront verdict F1:
+ * This is the storefront's DEFAULT language (storefront spec verdict F1:
  * ru-first), which is why it is the fullest of the three bundles and why the
  * wording is checked against what a marketplace visitor is actually being
  * told — "counts are approximate" has to sound like an explanation, not an
@@ -30,8 +30,16 @@ export const searchI18nBundleRu = {
     "search.results.load_failed": "Не удалось выполнить поиск.",
     "search.results.empty": "По этому запросу ничего не нашлось.",
     "search.results.retry": "Повторить",
-    "search.results.count_approximate": "Примерно {count} объявлений",
-    "search.results.count_exact": "{count} объявлений",
+    // Four forms, because Russian has four (1 / 2-4 / 5-20 / fractions). One
+    // string here is wrong on most pages the storefront serves.
+    "search.results.count_approximate.one": "Примерно {count} объявление",
+    "search.results.count_approximate.few": "Примерно {count} объявления",
+    "search.results.count_approximate.many": "Примерно {count} объявлений",
+    "search.results.count_approximate.other": "Примерно {count} объявления",
+    "search.results.count_exact.one": "{count} объявление",
+    "search.results.count_exact.few": "{count} объявления",
+    "search.results.count_exact.many": "{count} объявлений",
+    "search.results.count_exact.other": "{count} объявления",
     "search.results.took_ms": "{ms} мс",
     "search.results.next": "Следующая страница",
     "search.results.prev": "Предыдущая страница",

package/dist/i18n/ru.js.map

@@ -1 +1 @@
-{"version":3,"file":"ru.js","sourceRoot":"","sources":["../../src/i18n/ru.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,GAAG,mBAAmB;IAEtB,sBAAsB,EAAE,iCAAiC;IAEzD,sBAAsB,EAAE,YAAY;IACpC,wBAAwB,EAAE,OAAO;IACjC,4BAA4B,EAAE,6BAA6B;IAC3D,sBAAsB,EAAE,qCAAqC;IAC7D,sBAAsB,EAAE,WAAW;IACnC,kCAAkC,EAAE,6BAA6B;IACjE,4BAA4B,EAAE,oBAAoB;IAClD,wBAAwB,EAAE,SAAS;IACnC,qBAAqB,EAAE,oBAAoB;IAC3C,qBAAqB,EAAE,qBAAqB;IAC5C,+BAA+B,EAAE,wBAAwB;IACzD,iCAAiC,EAAE,qBAAqB;IACxD,gCAAgC,EAC9B,uFAAuF;IACzF,yBAAyB,EAAE,cAAc;IACzC,8BAA8B,EAC5B,+GAA+G;IACjH,4BAA4B,EAAE,gBAAgB;IAC9C,yBAAyB,EAAE,cAAc;IACzC,qBAAqB,EAAE,SAAS;IAEhC,mBAAmB,EAAE,YAAY;IACjC,uBAAuB,EAAE,kBAAkB;IAC3C,oBAAoB,EAAE,eAAe;IACrC,uBAAuB,EAAE,iBAAiB;IAC1C,wBAAwB,EAAE,gBAAgB;IAC1C,sBAAsB,EAAE,iBAAiB;IACzC,0BAA0B,EAAE,uBAAuB;IAEnD,qBAAqB,EAAE,SAAS;IAChC,uBAAuB,EAAE,oBAAoB;IAC7C,2BAA2B,EAAE,+BAA+B;IAC5D,qBAAqB,EAAE,gCAAgC;IACvD,qBAAqB,EAAE,UAAU;IACjC,yBAAyB,EAAE,gCAAgC;IAC3D,2BAA2B,EACzB,wFAAwF;IAC1F,uBAAuB,EACrB,uDAAuD;IACzD,2BAA2B,EAAE,cAAc;IAC3C,+BAA+B,EAC7B,6EAA6E;IAC/E,0BAA0B,EAAE,IAAI;IAChC,wBAAwB,EAAE,IAAI;IAC9B,2BAA2B,EAAE,WAAW;IAExC,kBAAkB,EAAE,YAAY;IAChC,sBAAsB,EAAE,mBAAmB;IAC3C,kBAAkB,EAAE,OAAO;IAC3B,gBAAgB,EAAE,sBAAsB;IACxC,mBAAmB,EAAE,sBAAsB;IAE3C,yBAAyB,EAAE,wCAAwC;IACnE,+BAA+B,EAAE,uCAAuC;IACxE,iCAAiC,EAC/B,kDAAkD;IACpD,iCAAiC,EAC/B,kFAAkF;IACpF,kCAAkC,EAChC,wDAAwD;IAE1D,uBAAuB,EAAE,gCAAgC;IACzD,gCAAgC,EAC9B,0EAA0E;IAC5E,iCAAiC,EAC/B,2EAA2E;IAC7E,6BAA6B,EAAE,+CAA+C;IAC9E,oCAAoC,EAAE,oCAAoC;IAC1E,iCAAiC,EAC/B,0EAA0E;IAC5E,wBAAwB,EACtB,4FAA4F;IAC9F,yBAAyB,EACvB,oFAAoF;IAEtF,sBAAsB,EAAE,4BAA4B;IACpD,sBAAsB,EACpB,8EAA8E;IAChF,wBAAwB,EAAE,mCAAmC;IAC7D,4BAA4B,EAAE,8CAA8C;IAC5E,sBAAsB,EAAE,uDAAuD;IAC/E,0BAA0B,EAAE,UAAU;IACtC,uBAAuB,EAAE,KAAK;IAC9B,2BAA2B,EAAE,eAAe;IAC5C,yBAAyB,EAAE,0BAA0B;IACrD,sBAAsB,EAAE,YAAY;IACpC,qBAAqB,EAAE,4BAA4B;CACpD,CAAC;AAEF;yDACyD;AACzD,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"ru.js","sourceRoot":"","sources":["../../src/i18n/ru.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -62,10 +62,11 @@ export { SearchResults } from "./headless/SearchResults.js";
 export type { SearchPageInfo, SearchResultsBag } from "./headless/SearchResults.js";
 export { FacetPanel } from "./headless/FacetPanel.js";
 export type { FacetPanelBag } from "./headless/FacetPanel.js";
+export { useAppliedSort } from "./headless/useAppliedSort.js";
 export { RankingDisclosure } from "./headless/RankingDisclosure.js";
 export type { RankingDisclosureBag } from "./headless/RankingDisclosure.js";
 export { navEntries } from "./nav/manifest.js";
-export { SEARCH_I18N_KEYS, searchI18nBundleEn, registerSearchI18n, } from "./i18n/keys.js";
+export { SEARCH_I18N_KEYS, SEARCH_I18N_PLURAL_KEYS, searchI18nBundleEn, registerSearchI18n, } from "./i18n/keys.js";
 export type { SearchI18nKey } from "./i18n/keys.js";
 export { SEARCH_ERRORS, SEARCH_ERROR_CODES, SEARCH_BACKEND_UNAVAILABLE, SEARCH_WINDOW_EXCEEDED, searchErrorBundleEn, explainSearchError, } from "./i18n/errorsMap.js";
 export type { SearchErrorCode, SearchErrorSpec, Remediation, } from "./i18n/errorsMap.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAGH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACxE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,SAAS,EACT,cAAc,EACd,eAAe,EACf,MAAM,EACN,iBAAiB,EACjB,qBAAqB,EACrB,SAAS,EACT,YAAY,EACZ,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEpG,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EACV,qBAAqB,EACrB,UAAU,EACV,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EACV,aAAa,EACb,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxF,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,wBAAwB,GACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAG5E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,eAAe,EACf,eAAe,EACf,WAAW,GACZ,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -56,11 +56,12 @@ export { SearchProvider } from "./headless/SearchProvider.js";
 export { SearchStateProvider, useSearchState } from "./headless/SearchStateProvider.js";
 export { SearchResults } from "./headless/SearchResults.js";
 export { FacetPanel } from "./headless/FacetPanel.js";
+export { useAppliedSort } from "./headless/useAppliedSort.js";
 export { RankingDisclosure } from "./headless/RankingDisclosure.js";
 // ── nav manifest (the pair's public surface declaration) ─────────────────────
 export { navEntries } from "./nav/manifest.js";
 // ── i18n ─────────────────────────────────────────────────────────────────────
-export { SEARCH_I18N_KEYS, searchI18nBundleEn, registerSearchI18n, } from "./i18n/keys.js";
+export { SEARCH_I18N_KEYS, SEARCH_I18N_PLURAL_KEYS, searchI18nBundleEn, registerSearchI18n, } from "./i18n/keys.js";
 // ── errors map (code → status/params/remediation/en; generated) ──────────────
 export { SEARCH_ERRORS, SEARCH_ERROR_CODES, SEARCH_BACKEND_UNAVAILABLE, SEARCH_WINDOW_EXCEEDED, searchErrorBundleEn, explainSearchError, } from "./i18n/errorsMap.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAmB9C,gFAAgF;AAChF,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAS7B,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEpG,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAOvE,gFAAgF;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAKzD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE1E,gFAAgF;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAMxF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGpE,gFAAgF;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,gFAAgF;AAChF,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,gFAAgF;AAChF,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAmB9C,gFAAgF;AAChF,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAS7B,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEpG,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAOvE,gFAAgF;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAKzD,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE1E,gFAAgF;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAMxF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAGpE,gFAAgF;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,gFAAgF;AAChF,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,gFAAgF;AAChF,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}

package/llms.txt

@@ -1,4 +1,4 @@
-# @stapel/search-react 0.1.0
+# @stapel/search-react 0.3.0
 
 Headless React flow pair for stapel-search (contract >=0.1 <0.2) — business + state, zero visual opinion.
 Built on @stapel/core: typed client + StapelApiError envelope, auth token refresh,

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "$generated": "by scripts/gen-manifest.mjs — do not edit; drift-gated (pnpm gen:manifest:check)",
   "package": "@stapel/search-react",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "backend": {
     "module": "stapel-search",
     "contract": ">=0.1 <0.2"
@@ -532,7 +532,11 @@
     "search.results.blocked.at_end",
     "search.results.blocked.at_start",
     "search.results.count_approximate",
+    "search.results.count_approximate.one",
+    "search.results.count_approximate.other",
     "search.results.count_exact",
+    "search.results.count_exact.one",
+    "search.results.count_exact.other",
     "search.results.distance_km",
     "search.results.empty",
     "search.results.load_failed",
@@ -570,6 +574,7 @@
       "SEARCH_ERRORS",
       "SEARCH_ERROR_CODES",
       "SEARCH_I18N_KEYS",
+      "SEARCH_I18N_PLURAL_KEYS",
       "SEARCH_PARAM",
       "SEARCH_SORTS",
       "SEARCH_WINDOW_EXCEEDED",
@@ -599,6 +604,7 @@
       "setFilterValues",
       "setRangeValue",
       "toggleFilterValue",
+      "useAppliedSort",
       "useRankingDisclosure",
       "useSearchAnalytics",
       "useSearchApi",

package/nav-manifest.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stapel/search-react",
-  "version": "0.1.0",
+  "version": "0.3.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": {
@@ -50,13 +50,6 @@
     "nav-manifest.json",
     "llms.txt"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "tsc -p tsconfig.test.json && vitest run --exclude test/prodBundlePurity.test.ts",
-    "lint": "eslint .",
-    "size": "size-limit",
-    "test:pack": "vitest run test/prodBundlePurity.test.ts"
-  },
   "size-limit": [
     {
       "name": "index — the headless pair (client + hooks + URL codec + facet model): no antd, no react-router",
@@ -106,11 +99,6 @@
   },
   "devDependencies": {
     "@size-limit/preset-small-lib": "^11.2.0",
-    "@stapel/attributes-react": "workspace:^",
-    "@stapel/core": "workspace:^",
-    "@stapel/showcase": "workspace:^",
-    "@stapel/tokens": "workspace:^",
-    "@stapel/tokens-antd": "workspace:^",
     "@tanstack/react-query": "^5.81.0",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.1.0",
@@ -122,12 +110,24 @@
     "react-router": "^7.18.1",
     "size-limit": "^11.2.0",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "@stapel/attributes-react": "^0.2.0",
+    "@stapel/core": "^0.17.0",
+    "@stapel/showcase": "^0.2.0",
+    "@stapel/tokens": "^0.5.0",
+    "@stapel/tokens-antd": "^0.5.0"
   },
   "engines": {
     "node": ">=22"
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "tsc -p tsconfig.test.json && vitest run --exclude test/prodBundlePurity.test.ts",
+    "lint": "eslint .",
+    "size": "size-limit",
+    "test:pack": "vitest run test/prodBundlePurity.test.ts"
   }
-}
+}

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.1.0",
+  "version": "0.3.0",
   "defined": [],
   "flows": []
 }

package/src/default/SearchPage.tsx

@@ -15,13 +15,11 @@
  * optional behaviour in disguise — every one has a working default.
  */
 import type { ReactElement, ReactNode } from "react";
-import { Col, Flex, Row, Typography } from "antd";
-import { useT } from "@stapel/core";
+import { Col, Flex, Row } from "antd";
 import type { FeatureDef } from "@stapel/attributes-react";
 import { SearchStateProvider } from "../headless/SearchStateProvider.js";
 import type { SearchParamsAdapter } from "../headless/SearchStateProvider.js";
 import type { ParseSearchStateOptions } from "../state/urlState.js";
-import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
 import { FacetPanelPane } from "./FacetPanelPane.js";
 import { SearchResultsPane } from "./SearchResultsPane.js";
 import { SortSelect } from "./SortSelect.js";
@@ -42,7 +40,6 @@ export interface SearchPageProps extends ThemeModeProp, ParseSearchStateOptions
 }
 
 export function SearchPage(props: SearchPageProps): ReactElement {
-  const t = useT();
   const {
     adapter,
     renderCard,
@@ -66,18 +63,16 @@ export function SearchPage(props: SearchPageProps): ReactElement {
               />
             </Col>
             <Col xs={24} md={17}>
-              <Flex vertical gap={12}>
-                <Flex justify="space-between" align="center" wrap gap={8}>
-                  <Typography.Text type="secondary">
-                    {t(SEARCH_I18N_KEYS.resultsTitle)}
-                  </Typography.Text>
-                  <SortSelect />
-                </Flex>
-                <SearchResultsPane
-                  {...(renderCard !== undefined ? { renderCard } : {})}
-                  {...(footer !== undefined ? { footer } : {})}
-                />
-              </Flex>
+              {/* ONE heading and ONE sort control. The page used to caption
+                  the toolbar "Results" and then mount a pane whose own heading
+                  says "Results" again — the live /s page printed both, one
+                  above the other. The pane owns the heading row; the page puts
+                  the sort control INTO it. */}
+              <SearchResultsPane
+                toolbar={<SortSelect />}
+                {...(renderCard !== undefined ? { renderCard } : {})}
+                {...(footer !== undefined ? { footer } : {})}
+              />
             </Col>
           </Row>
         </Flex>

package/src/default/SearchResultsPane.tsx

@@ -13,7 +13,7 @@
  * with an empty body, which is precisely how it would otherwise render as an
  * empty page.
  */
-import type { ReactElement, ReactNode } from "react";
+import type { CSSProperties, ReactElement, ReactNode } from "react";
 import { Button, Empty, Flex, Spin, Typography } from "antd";
 import {
   errorCode,
@@ -21,6 +21,7 @@ import {
   toFlowError,
   useDescribeFlowError,
   useT,
+  useTPlural,
 } from "@stapel/core";
 import type { SearchItem } from "../api/types.js";
 import { SearchResults } from "../headless/SearchResults.js";
@@ -34,6 +35,32 @@ import type { SearchCardRenderer } from "./SearchResultCard.js";
 import { SearchSkinTheme } from "./theme.js";
 import type { ThemeModeProp } from "./types.js";
 
+/**
+ * The whole result LAYOUT, for a container that wants its own — a map beside
+ * the list, a masonry wall, a table. It receives the loaded rows; the pane
+ * still owns the four load arms around it, so "nothing found" and "we could
+ * not run this search" stay the pane's sentences rather than the slot's
+ * problem.
+ */
+export type SearchResultsRenderer = (
+  items: readonly SearchItem[]
+) => ReactNode;
+
+/**
+ * The results grid. `auto-fill` + `minmax(280px, 1fr)`: as many columns as fit,
+ * each at least a readable card and never wider than its share — a catalogue
+ * on a 1400px desktop is four columns, not four full-bleed rows, and the same
+ * declaration collapses to one column on a phone with no breakpoint to
+ * maintain. 280px is the width below which the default card's title, price and
+ * location stop fitting on their own lines.
+ */
+const RESULTS_GRID: CSSProperties = {
+  display: "grid",
+  gridTemplateColumns: "repeat(auto-fill, minmax(280px, 1fr))",
+  gap: 12,
+  alignItems: "stretch",
+};
+
 export interface SearchResultsPaneProps extends ThemeModeProp {
   /**
    * The card slot (spec §6.2 item 1). A storefront passes
@@ -42,20 +69,36 @@ export interface SearchResultsPaneProps extends ThemeModeProp {
    * default honours it.
    */
   readonly renderCard?: SearchCardRenderer;
+  /**
+   * The layout slot: replaces the grid entirely, `renderCard` and all. Use it
+   * when the container's arrangement is not "cards in a grid".
+   */
+  readonly renderResults?: SearchResultsRenderer;
+  /**
+   * Rendered beside the count in the heading row — the sort control, a view
+   * switch. The pane owns the heading, so a screen that composes it hands its
+   * toolbar in here instead of printing a second caption above the pane.
+   */
+  readonly toolbar?: ReactNode;
   /** Rendered under the pager — where the container puts the ranking link. */
   readonly footer?: ReactNode;
   readonly enabled?: boolean;
 }
 
 function Count(props: { bag: SearchResultsBag }): ReactElement | null {
-  const t = useT();
+  // A COUNTED sentence: `tPlural` asks Intl.PluralRules for the locale's
+  // category, so Russian gets three different endings for 1, 3 and 17 instead
+  // of the single one that was right for 5-20 and wrong everywhere else.
+  const tPlural = useTPlural();
   const page = props.bag.page;
   if (page === null) return null;
   return (
     <Typography.Text type="secondary" data-testid="search-count">
       {page.countIsEstimate
-        ? t(SEARCH_I18N_KEYS.resultsCountApproximate, { count: page.count })
-        : t(SEARCH_I18N_KEYS.resultsCountExact, { count: page.count })}
+        ? tPlural(SEARCH_I18N_KEYS.resultsCountApproximate, {
+            count: page.count,
+          })
+        : tPlural(SEARCH_I18N_KEYS.resultsCountExact, { count: page.count })}
     </Typography.Text>
   );
 }
@@ -92,7 +135,7 @@ function Pager(props: { bag: SearchResultsBag }): ReactElement {
 export function SearchResultsPane(props: SearchResultsPaneProps): ReactElement {
   const t = useT();
   const describe = useDescribeFlowError();
-  const renderCard = props.renderCard;
+  const { renderCard, renderResults } = props;
 
   return (
     <SearchSkinTheme {...(props.mode !== undefined ? { mode: props.mode } : {})}>
@@ -103,7 +146,10 @@ export function SearchResultsPane(props: SearchResultsPaneProps): ReactElement {
               <Typography.Title level={4} style={{ margin: 0 }}>
                 {t(SEARCH_I18N_KEYS.resultsTitle)}
               </Typography.Title>
-              <Count bag={bag} />
+              <Flex align="center" wrap gap={12}>
+                <Count bag={bag} />
+                {props.toolbar}
+              </Flex>
             </Flex>
 
             <DegradationNotice degradations={bag.degradations} />
@@ -149,17 +195,23 @@ export function SearchResultsPane(props: SearchResultsPaneProps): ReactElement {
                 />
               ),
               ready: (items) => (
-                <Flex vertical gap={12} data-testid="search-results">
-                  {items.map((item: SearchItem) => (
-                    <div key={item.key}>
-                      {renderCard !== undefined ? (
-                        renderCard(item)
-                      ) : (
-                        <SearchResultCard item={item} />
-                      )}
+                <div data-testid="search-results">
+                  {renderResults !== undefined ? (
+                    renderResults(items)
+                  ) : (
+                    <div style={RESULTS_GRID} data-testid="search-results-grid">
+                      {items.map((item: SearchItem) => (
+                        <div key={item.key}>
+                          {renderCard !== undefined ? (
+                            renderCard(item)
+                          ) : (
+                            <SearchResultCard item={item} />
+                          )}
+                        </div>
+                      ))}
                     </div>
-                  ))}
-                </Flex>
+                  )}
+                </div>
               ),
             })}
 

package/src/default/SortSelect.tsx

@@ -17,6 +17,7 @@ import type { ReactElement } from "react";
 import { Flex, Select, Typography } from "antd";
 import { useT } from "@stapel/core";
 import { SEARCH_SORTS } from "../api/types.js";
+import { useAppliedSort } from "../headless/useAppliedSort.js";
 import { useSearchState } from "../headless/SearchStateProvider.js";
 import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
 
@@ -29,19 +30,28 @@ const SORT_LABEL_KEY: Readonly<Record<string, string>> = {
 };
 
 export interface SortSelectProps {
-  /** The sort the SERVER applied, shown when the URL names none. */
+  /** The sort the SERVER applied, shown when the URL names none. Omitted, it
+   * is read from the page already in cache — see {@link useAppliedSort}. */
   readonly appliedSort?: string | undefined;
 }
 
 export function SortSelect(props: SortSelectProps): ReactElement {
   const t = useT();
   const { state, setSort } = useSearchState();
+  // What the control SAYS must be what the results are ordered by. With no
+  // `sort` in the URL the select used to fall through to its placeholder and
+  // show nothing at all, while the server had already sorted the page and
+  // said so in the envelope.
+  const applied = useAppliedSort();
 
+  // What the page is ACTUALLY ordered by: the URL's sort, else the one the
+  // container states, else the one the server reported for the page in cache.
+  const active = state.sort ?? props.appliedSort ?? applied;
   const hasCentre = state.geo !== undefined;
   const known = new Set(SEARCH_SORTS);
   const values =
-    state.sort !== undefined && !known.has(state.sort)
-      ? [...SEARCH_SORTS, state.sort]
+    active !== undefined && !known.has(active)
+      ? [...SEARCH_SORTS, active]
       : SEARCH_SORTS;
 
   return (
@@ -52,8 +62,7 @@ export function SortSelect(props: SortSelectProps): ReactElement {
       <Select<string>
         data-testid="search-sort"
         style={{ minWidth: 180 }}
-        value={state.sort ?? props.appliedSort ?? null}
-        placeholder={t(SEARCH_I18N_KEYS.sortLabel)}
+        value={active ?? null}
         onChange={(next) => {
           setSort(next);
         }}

package/src/default/index.ts

@@ -11,6 +11,8 @@
  *  1. **`renderCard`** — the card slot. A storefront passes
  *     `<ListingCard>` from `@stapel/listings-react/default`; the generic card
  *     here is the documented default, not the intended end state (spec §3.7).
+ *     `renderResults` is the level above it: the whole layout, for a container
+ *     whose arrangement is not "cards in a grid".
  *  2. **`categoryFeatures`** — the facet-label slot. The server sends
  *     `{value: count}` and no labels; the schema that names them lives in
  *     categories, and the container hands it in (spec §6.2 item 2).
@@ -24,7 +26,10 @@ export { SearchPage } from "./SearchPage.js";
 export type { SearchPageProps } from "./SearchPage.js";
 
 export { SearchResultsPane } from "./SearchResultsPane.js";
-export type { SearchResultsPaneProps } from "./SearchResultsPane.js";
+export type {
+  SearchResultsPaneProps,
+  SearchResultsRenderer,
+} from "./SearchResultsPane.js";
 
 export { FacetPanelPane } from "./FacetPanelPane.js";
 export type { FacetPanelPaneProps } from "./FacetPanelPane.js";

package/src/headless/useAppliedSort.ts

@@ -0,0 +1,25 @@
+/**
+ * The sort the SERVER applied to the page currently in cache.
+ *
+ * A search with no `sort` in its URL is still sorted — the backend picks
+ * relevance when there is text and newest when there is not, and says so in
+ * the envelope's `sort`. A control that showed nothing in that case was not
+ * being cautious: it was hiding the answer the response already carried, and
+ * the live /s page rendered a sort box with no value while the results were
+ * plainly in an order.
+ *
+ * `enabled: false` is the whole trick. The key is the one `<SearchResults>`
+ * populates, so this subscribes to the SAME cache entry and re-renders when
+ * the page lands — but it never issues a request of its own, which is what
+ * keeps a control from turning into a second search (including on a pane
+ * mounted with `enabled={false}`, where a request would be exactly the thing
+ * the host switched off).
+ */
+import { useSearchQuery } from "../model/queries.js";
+import { useSearchState } from "./SearchStateProvider.js";
+
+export function useAppliedSort(): string | undefined {
+  const { state } = useSearchState();
+  const query = useSearchQuery(state, { enabled: false });
+  return query.data?.sort;
+}

package/src/i18n/es.ts

@@ -20,8 +20,10 @@ export const searchI18nBundleEs: I18nDictionary = {
   "search.results.load_failed": "No pudimos ejecutar esta búsqueda.",
   "search.results.empty": "No hay nada que coincida con esta búsqueda.",
   "search.results.retry": "Reintentar",
-  "search.results.count_approximate": "Unos {count} resultados",
-  "search.results.count_exact": "{count} resultados",
+  "search.results.count_approximate.one": "Aproximadamente {count} resultado",
+  "search.results.count_approximate.other": "Unos {count} resultados",
+  "search.results.count_exact.one": "{count} resultado",
+  "search.results.count_exact.other": "{count} resultados",
   "search.results.took_ms": "{ms} ms",
   "search.results.next": "Página siguiente",
   "search.results.prev": "Página anterior",

package/src/i18n/keys.ts

@@ -28,9 +28,10 @@ export const SEARCH_I18N_KEYS = {
   resultsLoadFailed: "search.results.load_failed",
   resultsEmpty: "search.results.empty",
   resultsRetry: "search.results.retry",
-  /** "About N results" — the sentence for an ESTIMATED count. */
+  /** "About N results" — the sentence for an ESTIMATED count. A PLURAL
+   * FAMILY: render with `tPlural`, never `t` (see SEARCH_I18N_PLURAL_KEYS). */
   resultsCountApproximate: "search.results.count_approximate",
-  /** "N results" — only when `exact_total` is true. */
+  /** "N results" — only when `exact_total` is true. A PLURAL FAMILY. */
   resultsCountExact: "search.results.count_exact",
   resultsTookMs: "search.results.took_ms",
   resultsNext: "search.results.next",
@@ -111,6 +112,26 @@ export const SEARCH_I18N_KEYS = {
 export type SearchI18nKey =
   (typeof SEARCH_I18N_KEYS)[keyof typeof SEARCH_I18N_KEYS];
 
+/**
+ * The keys above that are PLURAL FAMILIES rather than single messages.
+ *
+ * A family is catalogued as one flat key per CLDR category
+ * (`<family>.one`, `…few`, `…many`, `…other`) and rendered with core's
+ * `tPlural(family, { count })`, which asks `Intl.PluralRules` for the current
+ * locale's category. Which categories a bundle carries is a fact about the
+ * language — `en` needs two, `ru` needs four — so the pair's parity test asks
+ * `Intl.PluralRules` which forms each locale can select and demands exactly
+ * those, rather than checking a list somebody typed.
+ *
+ * The live defect this closes: the Russian estimate sentence was ONE string
+ * doing the work of four, correct only for 5-20 and wrong for every 1, 2, 3
+ * and 4 a result page actually shows.
+ */
+export const SEARCH_I18N_PLURAL_KEYS: readonly SearchI18nKey[] = [
+  SEARCH_I18N_KEYS.resultsCountApproximate,
+  SEARCH_I18N_KEYS.resultsCountExact,
+];
+
 /**
  * English fallback bundle for search-react UI keys + backend error codes.
  * The generated backend texts are spread FIRST so coverage of the error
@@ -126,8 +147,10 @@ export const searchI18nBundleEn: Record<string, string> = {
   "search.results.load_failed": "We could not run this search",
   "search.results.empty": "Nothing matches this search",
   "search.results.retry": "Try again",
-  "search.results.count_approximate": "About {count} results",
-  "search.results.count_exact": "{count} results",
+  "search.results.count_approximate.one": "About {count} result",
+  "search.results.count_approximate.other": "About {count} results",
+  "search.results.count_exact.one": "{count} result",
+  "search.results.count_exact.other": "{count} results",
   "search.results.took_ms": "{ms} ms",
   "search.results.next": "Next page",
   "search.results.prev": "Previous page",

package/src/i18n/ru.ts

@@ -35,8 +35,16 @@ export const searchI18nBundleRu: I18nDictionary = {
   "search.results.load_failed": "Не удалось выполнить поиск.",
   "search.results.empty": "По этому запросу ничего не нашлось.",
   "search.results.retry": "Повторить",
-  "search.results.count_approximate": "Примерно {count} объявлений",
-  "search.results.count_exact": "{count} объявлений",
+  // Four forms, because Russian has four (1 / 2-4 / 5-20 / fractions). One
+  // string here is wrong on most pages the storefront serves.
+  "search.results.count_approximate.one": "Примерно {count} объявление",
+  "search.results.count_approximate.few": "Примерно {count} объявления",
+  "search.results.count_approximate.many": "Примерно {count} объявлений",
+  "search.results.count_approximate.other": "Примерно {count} объявления",
+  "search.results.count_exact.one": "{count} объявление",
+  "search.results.count_exact.few": "{count} объявления",
+  "search.results.count_exact.many": "{count} объявлений",
+  "search.results.count_exact.other": "{count} объявления",
   "search.results.took_ms": "{ms} мс",
   "search.results.next": "Следующая страница",
   "search.results.prev": "Предыдущая страница",

package/src/index.ts

@@ -124,6 +124,7 @@ export { SearchResults } from "./headless/SearchResults.js";
 export type { SearchPageInfo, SearchResultsBag } from "./headless/SearchResults.js";
 export { FacetPanel } from "./headless/FacetPanel.js";
 export type { FacetPanelBag } from "./headless/FacetPanel.js";
+export { useAppliedSort } from "./headless/useAppliedSort.js";
 export { RankingDisclosure } from "./headless/RankingDisclosure.js";
 export type { RankingDisclosureBag } from "./headless/RankingDisclosure.js";
 
@@ -133,6 +134,7 @@ export { navEntries } from "./nav/manifest.js";
 // ── i18n ─────────────────────────────────────────────────────────────────────
 export {
   SEARCH_I18N_KEYS,
+  SEARCH_I18N_PLURAL_KEYS,
   searchI18nBundleEn,
   registerSearchI18n,
 } from "./i18n/keys.js";