@stapel/search-react 0.4.0 → 0.8.0

package/dist/default/SearchPage.js

@@ -1,15 +1,198 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Col, Flex, Row } from "antd";
-import { SearchStateProvider } from "../headless/SearchStateProvider.js";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * `<SearchPage>` — the composed screen the nav manifest points at: the query
+ * box, the filters, the sort and the results.
+ *
+ * It composes the panes and owns NO state of its own. The URL is the state,
+ * and it arrives through the `adapter` prop — which is where a host hands in
+ * `useRouterSearchParams()` from `@stapel/search-react/router`, or its own
+ * binding. The page does not reach for a router, so the same component renders
+ * under react-router, under a Next.js app router, and in a test with a plain
+ * `URLSearchParams`.
+ *
+ * The seams a storefront fills: `renderCard` (a `<ListingCard>`),
+ * `categoryFeatures` (from categories-react, for facet labels and range rows),
+ * `renderCategoryFilter` / `renderGeoFilter` (controls other pairs own),
+ * `footer` (the container's own chrome), `filtersHeader` and `resultsHeading`.
+ * None of them is optional behaviour in disguise — every one has a working
+ * default or a visible placeholder.
+ *
+ * ── The screen could not start a search ───────────────────────────────────
+ *
+ * Until this release the page rendered filters, sort and results and NO query
+ * box: `q` reached the state only from the address bar, and `setText` had zero
+ * callers in the repository. A scaffolded app therefore had a search route and
+ * no way to search (audit S-1). `<SearchBox>` is now the first thing on the
+ * page — and it is exported, so a container that puts the real box in its
+ * header can pass `searchBox={false}` and keep exactly one.
+ *
+ * ── On a phone the filters are a sheet ────────────────────────────────────
+ *
+ * The filter column was `xs={24}`: on a 390px screen the entire panel stacked
+ * ABOVE the results, so a person scrolled past every facet to reach the first
+ * card (§83(b), audit S-6). Below the tablet breakpoint the panel now lives
+ * behind a "Filters (N)" button and opens as a bottom sheet through the shared
+ * `SkinDialog`, with the count of what is applied on the button itself.
+ *
+ * ── The filter column is laid out only when there is something in it ──────
+ *
+ * `Col md={7}` was unconditional, and on a deployment whose search plan
+ * declares no facets that spent a quarter of every results page — `/s`, every
+ * category page, every seller page — on an empty-state illustration saying
+ * "no filters for this search". Saying it once is honest; reserving a column
+ * for it on every screen is not a message, it is a hole. The page asks the
+ * facet bag what it has (`useFacetPanel`) and gives the results the whole
+ * width when the answer is nothing AND no other filter control has anything
+ * to show. Note which way the test runs: the column stays for `loading` and
+ * for `failed`, because a panel that has not answered yet is not a panel with
+ * nothing in it, and a layout that reflowed underneath a person mid-load would
+ * be worse than the hole.
+ */
+import { useState } from "react";
+import { Button, Flex } from "antd";
+import { SkinDialog, SkinTheme, useDialogSurface } from "@stapel/tokens-antd/skin";
+import { useT, useTPlural } from "@stapel/core";
+import { spacing } from "@stapel/tokens";
+import { SearchStateProvider, useSearchState } from "../headless/SearchStateProvider.js";
+import { useFacetPanel } from "../headless/FacetPanel.js";
+import { useAppliedCount } from "../headless/useAppliedCount.js";
+import { buildRangeGroups } from "../state/ranges.js";
+import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
 import { FacetPanelPane } from "./FacetPanelPane.js";
+import { FilterChips } from "./FilterChips.js";
+import { PageSizeSelect } from "./PageSizeSelect.js";
+import { SearchBox } from "./SearchBox.js";
 import { SearchResultsPane } from "./SearchResultsPane.js";
 import { SortSelect } from "./SortSelect.js";
-import { SearchSkinTheme } from "./theme.js";
+import { SEARCH_BUILTIN_VIEWS, ViewSwitch, resolveView } from "./ViewSwitch.js";
 import { UrlIssueNotice } from "./UrlIssueNotice.js";
+/**
+ * The desktop filter rail's width.
+ *
+ * A rail, not a half-page. `Col md={7}` gave the panel a SHARE of the page, so
+ * on a wide screen the filters grew with it — the visual pass measured 570 of
+ * 1280px (45%) spent on the controls that narrow a list, next to the list they
+ * narrow. Filters are a fixed instrument: a checkbox column needs the width of
+ * its longest label and nothing more, and every pixel past that comes out of
+ * the results. 280px is that width at the default type step, and it is the
+ * same panel the phone sheet draws — one component, two frames.
+ */
+export const FILTERS_RAIL_WIDTH = 280;
+/**
+ * The rail: fixed width, never squeezed, never grown — and STICKY.
+ *
+ * A catalogue page is thirty cards long and the filters are at the top of it,
+ * so by the fourth row of results the controls that narrow the list are a
+ * screenful above the list they narrow: the only way to change a filter after
+ * scrolling was to scroll back. The rail now stays put while the results move
+ * under it, and scrolls INTERNALLY when its own content is taller than the
+ * window (`overflowY: auto` + a viewport-height cap), which is the one place a
+ * viewport measure is right — the sticky box's height IS the window's.
+ *
+ * `alignSelf: flex-start` is load-bearing: a flex child stretches to the row's
+ * height by default, and a stretched box has nothing to stick to.
+ */
+const RAIL = {
+    flex: `0 0 ${String(FILTERS_RAIL_WIDTH)}px`,
+    maxWidth: FILTERS_RAIL_WIDTH,
+    position: "sticky",
+    top: 0,
+    alignSelf: "flex-start",
+    maxHeight: "100dvh",
+    overflowY: "auto",
+    overscrollBehavior: "contain",
+    // Room for the focus ring of the last control against the scroll edge.
+    paddingBlockEnd: spacing[2],
+};
+/** The results take what is left. `minWidth: 0` so a long word inside a card
+ * cannot push the grid wider than its column. */
+const RESULTS_COLUMN = { flex: "1 1 auto", minWidth: 0 };
+/**
+ * The two columns, inside the state provider — which is where they have to be,
+ * because the layout decision reads the same search the panes read.
+ */
+function SearchPageBody(props) {
+    const t = useT();
+    const tPlural = useTPlural();
+    const { categoryFeatures, locale, filtersHeader } = props;
+    const { state } = useSearchState();
+    const facets = useFacetPanel({
+        ...(categoryFeatures !== undefined ? { categoryFeatures } : {}),
+        ...(locale !== undefined ? { locale } : {}),
+    });
+    const applied = useAppliedCount();
+    const surface = useDialogSurface();
+    const layout = props.filtersLayout ?? (surface === "sheet" ? "sheet" : "column");
+    const [sheetOpen, setSheetOpen] = useState(props.defaultFiltersOpen === true);
+    // How the results are ARRANGED. Component state, not URL state: it changes
+    // how the same answer is drawn, never what the answer is, so it must not
+    // rewrite the meaning of a link somebody shared (`<ViewSwitch>` §the view is
+    // not URL state).
+    const views = props.views ?? SEARCH_BUILTIN_VIEWS;
+    const [viewId, setViewId] = useState(props.defaultView);
+    const view = resolveView(views, viewId) ?? { id: "", labelKey: "" };
+    const changeView = (next) => {
+        setViewId(next);
+        props.onViewChange?.(next);
+    };
+    /**
+     * "Show 25 results", not "Show results".
+     *
+     * The sheet's own button is the only place a person learns what the filters
+     * they just ticked did — the results are behind it. When the engine cannot
+     * say how many there are (`countKind: "unknown"`) the button says so by
+     * saying nothing: a fabricated number on the one control that commits the
+     * change is worse than a generic verb.
+     */
+    const applyLabel = applied.count === null || applied.kind === "unknown"
+        ? t(SEARCH_I18N_KEYS.filtersApply)
+        : tPlural(applied.kind === "at_least"
+            ? SEARCH_I18N_KEYS.filtersShowCountAtLeast
+            : SEARCH_I18N_KEYS.filtersShowCount, { count: applied.count });
+    // "Nothing to filter by" is a LOADED answer of zero facet groups AND no
+    // other control with anything to say — see the header. Every clause is a
+    // control that would otherwise be hidden behind an empty panel: a numeric
+    // range the schema declares, a category or a language the URL carries, a
+    // host slot that is filled.
+    const ranges = buildRangeGroups({
+        state,
+        ...(categoryFeatures !== undefined ? { categoryFeatures } : {}),
+    });
+    const filtersEmpty = facets.state.status === "ready" &&
+        facets.state.data.length === 0 &&
+        facets.activeFilters === 0 &&
+        ranges.length === 0 &&
+        state.category === undefined &&
+        state.lang === undefined &&
+        props.renderCategoryFilter === undefined &&
+        props.renderGeoFilter === undefined &&
+        (props.languages ?? []).length === 0;
+    const showFilters = filtersHeader !== undefined || !filtersEmpty;
+    const panel = (_jsxs(Flex, { vertical: true, gap: spacing[4], children: [filtersHeader, filtersEmpty ? null : (_jsx(FacetPanelPane, { ...(layout === "sheet" ? { heading: null } : {}), ...(categoryFeatures !== undefined ? { categoryFeatures } : {}), ...(locale !== undefined ? { locale } : {}), ...(props.languages !== undefined ? { languages: props.languages } : {}), ...(props.renderCategoryFilter !== undefined
+                    ? { renderCategoryFilter: props.renderCategoryFilter }
+                    : {}), ...(props.renderGeoFilter !== undefined
+                    ? { renderGeoFilter: props.renderGeoFilter }
+                    : {}) }))] }));
+    // The toolbar over the results: how they are ARRANGED, how they are ORDERED,
+    // how many per page — and the surface's own action at the trailing end.
+    const toolbar = (_jsxs(Flex, { align: "center", wrap: true, gap: spacing[3], children: [_jsx(ViewSwitch, { views: views, value: view.id, onChange: changeView }), _jsx(SortSelect, {}), props.pageSize !== false && _jsx(PageSizeSelect, {}), props.resultsAction] }));
+    const results = (_jsx(SearchResultsPane, { toolbar: toolbar, headingLevel: props.resultsHeadingLevel ?? 1, ...(view.render !== undefined ? { renderResults: view.render } : {}), ...(view.layout !== undefined ? { layout: view.layout } : {}), ...(props.renderCard !== undefined ? { renderCard: props.renderCard } : {}), ...(props.footer !== undefined ? { footer: props.footer } : {}), ...(props.resultsHeading !== undefined
+            ? { heading: props.resultsHeading }
+            : {}), ...(props.degradationNotice !== undefined
+            ? { degradationNotice: props.degradationNotice }
+            : {}) }));
+    return (_jsxs(Flex, { vertical: true, gap: spacing[4], "data-testid": "search-page", "data-filters": showFilters ? "on" : "off", "data-filters-layout": layout, children: [props.searchBox !== false && _jsx(SearchBox, {}), props.breadcrumb !== undefined && (_jsx("div", { "data-testid": "search-breadcrumb", children: props.breadcrumb })), _jsx(UrlIssueNotice, {}), showFilters && layout === "sheet" ? (_jsxs(_Fragment, { children: [_jsx(FilterChips, { onOpenAll: () => {
+                            setSheetOpen(true);
+                        }, ...(categoryFeatures !== undefined ? { categoryFeatures } : {}), ...(locale !== undefined ? { locale } : {}), ...(props.renderGeoFilter !== undefined
+                            ? { renderGeoFilter: props.renderGeoFilter }
+                            : {}) }), _jsx(SkinDialog, { open: sheetOpen, onClose: () => {
+                            setSheetOpen(false);
+                        }, title: t(SEARCH_I18N_KEYS.facetsTitle), dismissLabel: t(SEARCH_I18N_KEYS.filtersDismiss), "data-testid": "search-filters-sheet", footer: _jsx(Button, { block: true, type: "primary", "data-testid": "search-filters-apply", "data-analytics": "none", "data-analytics-reason": "the filters are already applied; this closes the sheet", onClick: () => {
+                                setSheetOpen(false);
+                            }, children: applyLabel }), children: panel }), results] })) : showFilters ? (_jsxs(Flex, { align: "flex-start", gap: spacing[5], "data-testid": "search-page-columns", children: [_jsx("div", { style: RAIL, children: panel }), _jsx("div", { style: RESULTS_COLUMN, children: results })] })) : (results)] }));
+}
 export function SearchPage(props) {
-    const { adapter, renderCard, categoryFeatures, locale, footer, degradationNotice, mode, ...parseOptions } = props;
-    return (_jsx(SearchSkinTheme, { ...(mode !== undefined ? { mode } : {}), children: _jsx(SearchStateProvider, { adapter: adapter, ...parseOptions, children: _jsxs(Flex, { vertical: true, gap: 16, "data-testid": "search-page", children: [_jsx(UrlIssueNotice, {}), _jsxs(Row, { gutter: [16, 16], children: [_jsx(Col, { xs: 24, md: 7, children: _jsx(FacetPanelPane, { ...(categoryFeatures !== undefined ? { categoryFeatures } : {}), ...(locale !== undefined ? { locale } : {}) }) }), _jsx(Col, { xs: 24, md: 17, children: _jsx(SearchResultsPane, { toolbar: _jsx(SortSelect, {}), ...(renderCard !== undefined ? { renderCard } : {}), ...(footer !== undefined ? { footer } : {}), ...(degradationNotice !== undefined
-                                        ? { degradationNotice }
-                                        : {}) }) })] })] }) }) }));
+    const { adapter, renderCard, categoryFeatures, locale, searchBox, languages, renderCategoryFilter, renderGeoFilter, footer, filtersHeader, resultsHeading, degradationNotice, filtersLayout, defaultFiltersOpen, pageSize, breadcrumb, views, defaultView, onViewChange, resultsAction, resultsHeadingLevel, mode, ...parseOptions } = props;
+    return (_jsx(SkinTheme, { surface: "base", ...(mode !== undefined ? { mode } : {}), children: _jsx(SearchStateProvider, { adapter: adapter, ...parseOptions, children: _jsx(SearchPageBody, { ...(renderCard !== undefined ? { renderCard } : {}), ...(categoryFeatures !== undefined ? { categoryFeatures } : {}), ...(locale !== undefined ? { locale } : {}), ...(searchBox !== undefined ? { searchBox } : {}), ...(languages !== undefined ? { languages } : {}), ...(renderCategoryFilter !== undefined ? { renderCategoryFilter } : {}), ...(renderGeoFilter !== undefined ? { renderGeoFilter } : {}), ...(footer !== undefined ? { footer } : {}), ...(filtersHeader !== undefined ? { filtersHeader } : {}), ...(resultsHeading !== undefined ? { resultsHeading } : {}), ...(degradationNotice !== undefined ? { degradationNotice } : {}), ...(filtersLayout !== undefined ? { filtersLayout } : {}), ...(defaultFiltersOpen !== undefined ? { defaultFiltersOpen } : {}), ...(pageSize !== undefined ? { pageSize } : {}), ...(breadcrumb !== undefined ? { breadcrumb } : {}), ...(views !== undefined ? { views } : {}), ...(defaultView !== undefined ? { defaultView } : {}), ...(onViewChange !== undefined ? { onViewChange } : {}), ...(resultsAction !== undefined ? { resultsAction } : {}), ...(resultsHeadingLevel !== undefined ? { resultsHeadingLevel } : {}) }) }) }));
 }
 //# sourceMappingURL=SearchPage.js.map

package/dist/default/SearchPage.js.map

@@ -1 +1 @@
-{"version":3,"file":"SearchPage.js","sourceRoot":"","sources":["../../src/default/SearchPage.tsx"],"names":[],"mappings":";AAiBA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAGzE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAiBrD,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,EACJ,OAAO,EACP,UAAU,EACV,gBAAgB,EAChB,MAAM,EACN,MAAM,EACN,iBAAiB,EACjB,IAAI,EACJ,GAAG,YAAY,EAChB,GAAG,KAAK,CAAC;IAEV,OAAO,CACL,KAAC,eAAe,OAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YACvD,KAAC,mBAAmB,IAAC,OAAO,EAAE,OAAO,KAAM,YAAY,YACrD,MAAC,IAAI,IAAC,QAAQ,QAAC,GAAG,EAAE,EAAE,iBAAc,aAAa,aAC/C,KAAC,cAAc,KAAG,EAClB,MAAC,GAAG,IAAC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,aACnB,KAAC,GAAG,IAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,YAChB,KAAC,cAAc,OACT,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAC5D,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAC5C,GACE,EACN,KAAC,GAAG,IAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,YAMjB,KAAC,iBAAiB,IAChB,OAAO,EAAE,KAAC,UAAU,KAAG,KACnB,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAChD,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KACxC,CAAC,iBAAiB,KAAK,SAAS;wCAClC,CAAC,CAAC,EAAE,iBAAiB,EAAE;wCACvB,CAAC,CAAC,EAAE,CAAC,GACP,GACE,IACF,IACD,GACa,GACN,CACnB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"SearchPage.js","sourceRoot":"","sources":["../../src/default/SearchPage.tsx"],"names":[],"mappings":"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"}

package/dist/default/SearchResultCard.d.ts

@@ -1,22 +1,5 @@
-/**
- * The GENERIC card — the fallback behind `renderCard`, and the default the
- * spec (§3.7) says the pair must ship.
- *
- * `SearchItem.card` is a free-form object: "stored row fields, so a result
- * page costs one query". Which fields it holds is the DOC TYPE's business,
- * not search's, so this card reads a small, documented set of conventional
- * names and shows what it finds. A storefront replaces the whole thing by
- * passing `renderCard` and rendering `<ListingCard>` from
- * `@stapel/listings-react/default` — that is the slot seam, and the reason
- * these two L2 pairs never import each other.
- *
- * The ONE thing a replacement card may not drop is the `promoted` marking:
- * DSA Art. 26 makes it mandatory, the serializer puts it on every item under
- * every sort, and a storefront where some lists show it and some do not is
- * legally worse than one that never showed it. `renderCard` receives the whole
- * item so the marking is always reachable, and this default renders it.
- */
 import type { ReactElement, ReactNode } from "react";
+import type { Format } from "@stapel/core";
 import type { SearchItem } from "../api/types.js";
 /** What the card slot is handed. */
 export interface SearchCardProps {
@@ -30,5 +13,23 @@ export type SearchCardRenderer = (item: SearchItem) => ReactNode;
  * belongs in the owning pair's own card.
  */
 export declare const GENERIC_CARD_FIELDS: readonly string[];
+/**
+ * The card's price, written the way money is written.
+ *
+ * `card.price` arrives as a string because the index stores it as one, and
+ * `card.currency` as an ISO 4217 code because that is what a document carries.
+ * Rendered verbatim they read "3200 RUB": no grouping, the code where the
+ * symbol belongs, and the reader doing the arithmetic of where the thousands
+ * are. `Intl` knows all of that per locale, so the code goes in and the
+ * locale's own rendering comes out.
+ *
+ * Two ways this refuses to guess. A `price` that is not a finite number is
+ * passed through UNCHANGED — a doc type may store "on request", and turning
+ * that into `NaN` or into nothing loses what the seller wrote. A `currency`
+ * that is not a three-letter code (or one this runtime rejects) falls back to
+ * the plain grouped number plus the code, which is still better than the raw
+ * pair and never throws inside a render.
+ */
+export declare function formatCardPrice(format: Format, price: string | undefined, currency: string | undefined): string | undefined;
 export declare function SearchResultCard(props: SearchCardProps): ReactElement;
 //# sourceMappingURL=SearchResultCard.d.ts.map

package/dist/default/SearchResultCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SearchResultCard.d.ts","sourceRoot":"","sources":["../../src/default/SearchResultCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAED,wDAAwD;AACxD,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS,CAAC;AAQjE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAMhD,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CA4CrE"}
+{"version":3,"file":"SearchResultCard.d.ts","sourceRoot":"","sources":["../../src/default/SearchResultCard.tsx"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAED,wDAAwD;AACxD,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS,CAAC;AAQjE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAOhD,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CAoBpB;AAiFD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CAgGrE"}

package/dist/default/SearchResultCard.js

@@ -1,6 +1,54 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Card, Flex, Tag, Tooltip, Typography } from "antd";
-import { useT } from "@stapel/core";
+/**
+ * The GENERIC card — the fallback behind `renderCard`, and the default the
+ * spec (§3.7) says the pair must ship.
+ *
+ * `SearchItem.card` is a free-form object: "stored row fields, so a result
+ * page costs one query". Which fields it holds is the DOC TYPE's business,
+ * not search's, so this card reads a small, documented set of conventional
+ * names and shows what it finds. A storefront replaces the whole thing by
+ * passing `renderCard` and rendering `<ListingCard>` from
+ * `@stapel/listings-react/default` — that is the slot seam, and the reason
+ * these two L2 pairs never import each other.
+ *
+ * The ONE thing a replacement card may not drop is the `promoted` marking:
+ * DSA Art. 26 makes it mandatory, the serializer puts it on every item under
+ * every sort, and a storefront where some lists show it and some do not is
+ * legally worse than one that never showed it. `renderCard` receives the whole
+ * item so the marking is always reachable, and this default renders it.
+ *
+ * ── Two things this card used to get wrong ────────────────────────────────
+ *
+ * 1. **It declared `image_url` and drew nothing.** A text-only card in a
+ *    classifieds search is not a card; the field was in `GENERIC_CARD_FIELDS`
+ *    and in no render path. It is drawn now, through `@stapel/image`, so the
+ *    aspect box lands before the network does and a dead URL renders a named
+ *    placeholder instead of the browser's torn-page icon.
+ * 2. **The marking's EXPLANATION was in a `Tooltip`.** Touch has no hover, so
+ *    on the device most of this traffic arrives from, the sentence the law is
+ *    actually about was unreachable — the tag said "Promoted" and nothing on
+ *    screen said what that meant. It is ordinary text under the tag now
+ *    (`stapel/no-tooltip-in-skin`), and the tag itself is a `--stapel-*` role
+ *    rather than an antd preset, because the one legally-mandated marking in
+ *    the pair has to look the same in every skin a deployment builds.
+ * 3. **The tag was white on cream.** `warning-on` is the text colour for the
+ *    SOLID warning fill; over `warning-bg` the readable role is `warning`
+ *    itself. The visual pass measured the one legally-mandated string in the
+ *    package at roughly 1.2:1 — a disclosure nobody can read is the same as
+ *    no disclosure, in both themes.
+ * 4. **The price was a raw amount and an ISO code.** "3200 RUB" is a wire
+ *    value printed as prose: no grouping, no symbol, and the code in the
+ *    reader's face. It goes through core's `useFormat().number` with
+ *    `style: "currency"`, which is the same `Intl` path `@stapel/currencies-
+ *    react`'s `formatMoney` takes — this pair does not depend on that package
+ *    (a search index is not a price book) but it must not invent a second
+ *    way to write money either.
+ */
+import { useMemo } from "react";
+import { Card, Flex, Typography } from "antd";
+import { Image } from "@stapel/image";
+import { useFormat, useT } from "@stapel/core";
+import { cssVar, fontSize, fontWeight, radii, spacing } from "@stapel/tokens";
 import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
 function text(value) {
     if (typeof value === "string" && value.length > 0)
@@ -20,19 +68,144 @@ export const GENERIC_CARD_FIELDS = [
     "currency",
     "location",
     "image_url",
+    "url",
 ];
+/**
+ * The card's price, written the way money is written.
+ *
+ * `card.price` arrives as a string because the index stores it as one, and
+ * `card.currency` as an ISO 4217 code because that is what a document carries.
+ * Rendered verbatim they read "3200 RUB": no grouping, the code where the
+ * symbol belongs, and the reader doing the arithmetic of where the thousands
+ * are. `Intl` knows all of that per locale, so the code goes in and the
+ * locale's own rendering comes out.
+ *
+ * Two ways this refuses to guess. A `price` that is not a finite number is
+ * passed through UNCHANGED — a doc type may store "on request", and turning
+ * that into `NaN` or into nothing loses what the seller wrote. A `currency`
+ * that is not a three-letter code (or one this runtime rejects) falls back to
+ * the plain grouped number plus the code, which is still better than the raw
+ * pair and never throws inside a render.
+ */
+export function formatCardPrice(format, price, currency) {
+    if (price === undefined)
+        return undefined;
+    const amount = Number(price);
+    if (!Number.isFinite(amount))
+        return price;
+    if (currency !== undefined && /^[A-Za-z]{3}$/.test(currency)) {
+        try {
+            const money = format.number(amount, {
+                style: "currency",
+                currency: currency.toUpperCase(),
+                currencyDisplay: "narrowSymbol",
+                maximumFractionDigits: Number.isInteger(amount) ? 0 : 2,
+            });
+            if (money !== null)
+                return money;
+        }
+        catch {
+            // An unsupported currency code: fall through to the grouped number.
+        }
+    }
+    const grouped = format.number(amount);
+    if (grouped === null)
+        return price;
+    return currency === undefined ? grouped : `${grouped} ${currency}`;
+}
+/**
+ * The DSA Art. 26 marking, as a token role.
+ *
+ * `warning` is the §68 dictionary's "look at this, it is not an error" role —
+ * the same one every skin in the fleet resolves from its own theme JSON. The
+ * previous `<Tag color="gold">` was an antd PRESET: it survived a retheme
+ * unchanged, so a deployment with its own palette had one component still
+ * painted in Ant Design's gold, and the one marking that must be recognisable
+ * everywhere was the one thing the design system did not own.
+ */
+const PROMOTED_TAG = {
+    alignSelf: "flex-start",
+    background: cssVar("warning-bg"),
+    // `warning`, not `warning-on`: the latter is the text colour for the SOLID
+    // warning fill (white on light), and over `warning-bg` it is cream on cream.
+    color: cssVar("warning"),
+    fontWeight: fontWeight.medium,
+    border: `1px solid ${cssVar("warning-border")}`,
+    borderRadius: radii.sm,
+    padding: `0 ${String(spacing[2])}px`,
+    fontSize: fontSize.xs.fontSize,
+    lineHeight: `${String(fontSize.md.lineHeight)}px`,
+    whiteSpace: "nowrap",
+};
+/** The photo's box: a 4:3 well the image fills, drawn before it loads. */
+const PHOTO = {
+    width: "100%",
+    aspectRatio: "4 / 3",
+    overflow: "hidden",
+    borderRadius: radii.md,
+    background: cssVar("surface-sunken"),
+};
+/**
+ * A plain `image_url` as the descriptor `<Image>` consumes.
+ *
+ * A doc type that stores a bare URL has no variant ladder and no dimensions —
+ * `source: "link"` is exactly that case, and `<Image>` degrades to the single
+ * URL rather than pretending to shop a tier. A doc type that stores the whole
+ * `StapelImage` snapshot (`card.image`) gets the ladder, blur-up and all.
+ */
+function cardImage(card) {
+    const rich = card["image"];
+    if (rich !== null && typeof rich === "object" && "url" in rich) {
+        return rich;
+    }
+    const url = text(card["image_url"]);
+    if (url === undefined)
+        return undefined;
+    return {
+        source: "link",
+        url,
+        mime: null,
+        width: null,
+        height: null,
+        aspect: null,
+        square: false,
+        preview_b64: null,
+        variants: [],
+    };
+}
+/**
+ * The whole card as ONE tap target.
+ *
+ * A catalogue row is a link — the person taps the picture, the title or the
+ * price and expects the same thing to happen. The card used to have no
+ * clickable anything at all: the entire result page of a storefront that had
+ * not passed `renderCard` was a wall of text with the tap target missing
+ * (class C-NOPRIMARY). `card.url` is the conventional field a doc type stores
+ * it in; without one the card stays exactly what it was, because inventing a
+ * destination is worse than not having one.
+ */
+const CARD_LINK = {
+    color: "inherit",
+    display: "block",
+    textDecoration: "none",
+};
 export function SearchResultCard(props) {
     const t = useT();
+    const format = useFormat();
     const card = props.item.card;
     const title = text(card["title"]) ?? t(SEARCH_I18N_KEYS.resultsUntitled);
-    const price = text(card["price"]);
-    const currency = text(card["currency"]);
+    const price = formatCardPrice(format, text(card["price"]), text(card["currency"]));
+    const href = text(card["url"]);
     const location = text(card["location"]);
     const distance = props.item.distance_km !== null
         ? t(SEARCH_I18N_KEYS.resultsDistanceKm, {
             km: props.item.distance_km.toFixed(1),
         })
         : undefined;
-    return (_jsx(Card, { size: "small", "data-testid": "search-result-card", "data-promoted": props.item.promoted ? "true" : "false", children: _jsxs(Flex, { vertical: true, gap: 4, children: [_jsxs(Flex, { justify: "space-between", align: "start", gap: 8, children: [_jsx(Typography.Text, { strong: true, children: title }), props.item.promoted && (_jsx(Tooltip, { title: t(SEARCH_I18N_KEYS.resultsPromotedHint), children: _jsx(Tag, { color: "gold", "data-testid": "search-result-promoted", children: t(SEARCH_I18N_KEYS.resultsPromoted) }) }))] }), price !== undefined && (_jsx(Typography.Text, { children: currency !== undefined ? `${price} ${currency}` : price })), (location !== undefined || distance !== undefined) && (_jsx(Typography.Text, { type: "secondary", children: [location, distance].filter((v) => v !== undefined).join(" · ") }))] }) }));
+    // Memoised on the two fields it reads: a fresh `meta` identity every render
+    // is a load `<Image>` has to decide is or is not the same one.
+    const image = useMemo(() => cardImage(card), [card]);
+    const body = (_jsxs(Flex, { vertical: true, gap: spacing[2], children: [image !== undefined && (_jsx("div", { style: PHOTO, "data-testid": "search-result-photo", children: _jsx(Image, { meta: image, alt: t(SEARCH_I18N_KEYS.resultsImageAlt, { title }), fit: "cover", style: { width: "100%", height: "100%" } }) })), _jsxs(Flex, { vertical: true, gap: spacing[1], children: [_jsx(Typography.Text, { strong: true, children: title }), price !== undefined && (_jsx(Typography.Text, { strong: true, style: { fontSize: fontSize.lg.fontSize }, "data-testid": "search-result-price", children: price })), (location !== undefined || distance !== undefined) && (_jsx(Typography.Text, { type: "secondary", children: [location, distance].filter((v) => v !== undefined).join(" · ") }))] })] }));
+    return (_jsx(Card, { size: "small", "data-testid": "search-result-card", "data-promoted": props.item.promoted ? "true" : "false", ...(href !== undefined ? { hoverable: true } : {}), styles: { body: { padding: spacing[3] } }, children: _jsxs(Flex, { vertical: true, gap: spacing[2], children: [href === undefined ? (body) : (_jsx("a", { href: href, style: CARD_LINK, "data-testid": "search-result-link", children: body })), props.item.promoted && (_jsxs(Flex, { vertical: true, gap: spacing[1], "data-testid": "search-result-promotion", children: [_jsx("span", { style: PROMOTED_TAG, "data-testid": "search-result-promoted", children: t(SEARCH_I18N_KEYS.resultsPromoted) }), _jsx(Typography.Text, { type: "secondary", style: { fontSize: fontSize.xs.fontSize }, "data-testid": "search-result-promoted-hint", children: t(SEARCH_I18N_KEYS.resultsPromotedHint) })] }))] }) }));
 }
 //# sourceMappingURL=SearchResultCard.js.map

package/dist/default/SearchResultCard.js.map

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

package/dist/default/SearchResultsPane.d.ts

@@ -2,9 +2,9 @@
  * `<SearchResultsPane>` — the antd result page: the count, the degradation
  * banner, the cards, and the keyset controls.
  *
- * Rendered through core's `matchList`, whose FOUR required arms are the point.
- * "Nothing matches this search" is reachable only from a search that actually
- * ran; a 5xx renders "we could not run this search" plus a retry. The
+ * Rendered through the shared substrate's `LoadList`, whose FOUR arms are the
+ * point. "Nothing matches this search" is reachable only from a search that
+ * actually ran; a 5xx renders "we could not run this search" plus a retry. The
  * substitution of one for the other is what cost the 2026-08-09 incident, and
  * the spec's §7.4 negative leg exercises this exact pane against a forced 5xx.
  *
@@ -12,11 +12,23 @@
  * is "narrow the search", not "there is nothing here" — it arrives as a 400
  * with an empty body, which is precisely how it would otherwise render as an
  * empty page.
+ *
+ * ── Two things the pager used to get wrong ────────────────────────────────
+ *
+ * 1. **Its reasons were in `title=`.** A disabled antd Button receives no
+ *    pointer events, so the browser tooltip never fires — on any device — and
+ *    a phone has no hover to begin with. Both buttons are `GatedButton` now:
+ *    the block's reason is ordinary text beside the control and the button's
+ *    `aria-describedby` points at it.
+ * 2. **It rendered when there was nothing to page.** Two dead buttons under an
+ *    empty state is the fleet's C-DEADPAGER defect; the pager now appears only
+ *    when the answer actually has another page in some direction.
  */
 import type { ReactElement, ReactNode } from "react";
 import type { SearchItem } from "../api/types.js";
 import type { DegradationNoticeVariant } from "./DegradationNotice.js";
 import type { SearchCardRenderer } from "./SearchResultCard.js";
+import type { SearchResultsLayout } from "./ViewSwitch.js";
 import type { ThemeModeProp } from "./types.js";
 /**
  * The whole result LAYOUT, for a container that wants its own — a map beside
@@ -26,6 +38,16 @@ import type { ThemeModeProp } from "./types.js";
  * problem.
  */
 export type SearchResultsRenderer = (items: readonly SearchItem[]) => ReactNode;
+/**
+ * The widest a column of results is allowed to get.
+ *
+ * Off the spacing scale and named for it: it is a MEASURE, the reading-width
+ * decision every long page has to take. Without it the pane spread the full
+ * width of whatever it was dropped into — the visual pass measured a 2560px
+ * pane with four cards floating at the top of it and a status row 1350px from
+ * the buttons that act on it (class C-NOMAXW).
+ */
+export declare const RESULTS_MAX_WIDTH = 1120;
 export interface SearchResultsPaneProps extends ThemeModeProp {
     /**
      * The card slot (spec §6.2 item 1). A storefront passes
@@ -45,6 +67,21 @@ export interface SearchResultsPaneProps extends ThemeModeProp {
      * toolbar in here instead of printing a second caption above the pane.
      */
     readonly toolbar?: ReactNode;
+    /**
+     * What this list is CALLED on this surface. Default: "Results".
+     *
+     * The pane owning the heading row is what stops a screen printing two
+     * captions — but "Results" is only the right word when the person performed
+     * a search. A landing's newest-first strip is "Fresh listings"; a seller's
+     * page is "This seller's listings"; a category page's is the category. Every
+     * one of those surfaces had written its own `<Title>` above the pane and got
+     * the pane's "Results" underneath it a moment later — two headings, one
+     * list, on the three busiest screens of the storefront.
+     *
+     * So the name comes IN, to the row that already exists, instead of being
+     * printed a second time above it. Still exactly one heading either way.
+     */
+    readonly heading?: ReactNode;
     /** Rendered under the pager — where the container puts the ranking link. */
     readonly footer?: ReactNode;
     /**
@@ -59,6 +96,27 @@ export interface SearchResultsPaneProps extends ThemeModeProp {
      */
     readonly degradationNotice?: DegradationNoticeVariant;
     readonly enabled?: boolean;
+    /** Widest the column of results may grow (default {@link RESULTS_MAX_WIDTH});
+     * `null` lets the container decide. */
+    readonly maxWidth?: number | null;
+    /**
+     * How the loaded rows are arranged: as many card columns as fit
+     * (`"grid"`, the default) or one wide row each (`"list"`). The view SWITCH
+     * that flips this lives in `<ViewSwitch>`; the pane only draws.
+     *
+     * Ignored when `renderResults` replaces the arrangement entirely.
+     */
+    readonly layout?: SearchResultsLayout;
+    /**
+     * Heading level for the results caption. Default `4`, which is what every
+     * surface that EMBEDS this pane under its own title needs.
+     *
+     * `<SearchPage>` passes `1`: on a results SCREEN the list's name is the
+     * page's heading, and a page whose only heading is an `<h4>` has a document
+     * outline that starts three levels down — the thing a screen reader's
+     * heading list is for.
+     */
+    readonly headingLevel?: 1 | 2 | 3 | 4 | 5;
 }
 export declare function SearchResultsPane(props: SearchResultsPaneProps): ReactElement;
 //# sourceMappingURL=SearchResultsPane.d.ts.map