@stapel/search-react 0.4.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,196 @@
 # @stapel/search-react
 
+## 0.8.0
+
+### Minor Changes
+
+- 62c70ac: The classified layout, in the default skins.
+
+  Built where the doctrine says the product lives, so every future classified
+  deployment gets it rather than rebuilding it.
+
+  - `shell-react` — `NavDock`, a floating translucent island rather than a flat
+    bar: inset from every edge, real border and shadow, safe-area aware. The
+    glass is progressive enhancement, not the design — the opaque elevated fill
+    is the base and the blur is swapped in only inside an `@supports` for
+    `backdrop-filter`, so text contrast never depends on transparency being
+    available. Destinations are the first five top-level nav entries in the
+    order the manifest already declares, so there is no second selection axis.
+    Real links, `aria-current`, and the badge count folded into each link's
+    accessible name.
+  - `search-react` — a phone gets a scrollable chip row instead of one
+    "Filters" button, each chip opening its own `SkinDialog`, and chips carry
+    the CHOICE rather than the group name. A desktop gets a sticky full-height
+    rail. Both render through one `FacetGroupControl`, so the rail and the
+    sheets cannot drift into two implementations — and a group's shape is
+    derived from the schema keys the composer's editor already reads
+    (`maxSelected: 1` → pills, `hierarchical_select` → indented children)
+    rather than a new presentation flag. Plus a list/grid view switch, which is
+    not URL state because it changes how an answer is drawn and never what it
+    is.
+  - `listings-react` — the whole card is one real anchor: photo, price, title
+    and location inside it, the favourite heart a sibling button outside it so
+    the link cannot swallow it. The separate "open" control is gone and its
+    i18n key is retired. Middle-click, open-in-new-tab and crawlers still work,
+    and the anchor's accessible name is the title alone.
+
+  Parts of the reference layout that do not fit a generic contract are slots
+  with a stated reason rather than invented content: "notify me about new ones"
+  (a saved search has an owner, a schedule and a consent record this pair has
+  none of), the breadcrumb (a walk up a tree search cannot see), and map view
+  (a `SearchView` whose tiles belong to geo-react).
+
+## 0.7.0
+
+### Minor Changes
+
+- 9545a2f: Search: the five blank stories, the phone filter path, money, and the dark scope
+
+  **Five stories rendered nothing.** `results-pane--*` and `filter-panel--*` crashed on
+  `data.items.filter` / `data.facet_meta.skipped` — 15 blank shots, including the designed
+  empty state. The seeded demos wrote the answer into the query cache and `useSearchQuery`
+  sets no `staleTime` (drill-down facets must never serve a stale page), so TanStack
+  refetched on mount and the demo `fetch`, which had no handler for a variant that seeded
+  instead of mocking, replaced the page with `{}`. A seed now mounts as a handler too, and
+  an UNMOCKED path answers 503 rather than an empty 200, so a forgotten handler renders the
+  pane's "we could not run this search" arm instead of a white screen.
+
+  **The phone filter sheet had no visual evidence at all** — the only filter path a phone
+  has, reachable only by a tap. `<SearchPage defaultFiltersOpen>` opens it on mount (for a
+  container that deep-links into the filters), and `search.filter-sheet` photographs it.
+  Its commit button now says **"Show 25+ results"** (`useAppliedCount`, cache-only — no
+  second request), the sheet no longer prints "Filters" twice (`FacetPanelPane heading`),
+  and the opener drops the "(0)" until something is applied.
+
+  **Money.** `3200 RUB` → `₽3,200`, through core's `useFormat().number` with
+  `style: "currency"` — the same `Intl` path `@stapel/currencies-react`'s `formatMoney`
+  takes. Non-numeric prices pass through; an unusable code falls back to a grouped number.
+
+  **Contrast, touch targets, orphans.** The DSA "Promoted" tag was `warning-on` (white)
+  over `warning-bg` (cream) — the one legally mandated string in the package, at ~1.2:1;
+  it is `warning` now, in both themes. Degradation banner lines drop `type="secondary"`
+  (grey on the warning tint failed AA). `size="small"` is gone from the range Apply/Clear,
+  the category/geo/clear-all buttons, so the shared skin's 44px phone control height
+  applies. The range Apply is primary when there is something to apply, not before. An
+  unfilled `renderGeoFilter` no longer leaves a "Location" heading over empty space in a
+  production build, and a facet group with no options draws no heading.
+
+  **Copy.** Scorer slugs are named from the ranking disclosure the pair already fetches
+  (`geo_decay` → "Distance"); skipped facet slugs from the category schema (`power_w` →
+  "Power"); `applies_to_sorts` through the sort control's own labels; the weight tag is
+  labelled; the unreadable-link notice says "price", not `r.price`, and no longer explains
+  `from..to` or `lat`/`lon`. New keys `search.filters.show_count{,_at_least}` (plural
+  families) and `search.limit.from_link`, in en/ru/es.
+
+  **Layout.** The desktop filter rail is a fixed 280px instead of `Col md={7}` (measured at
+  45% of a 1280px page). Result cards carry the photo well filled (`fit` needs a box when
+  the snapshot has no aspect) and the whole row is one link when the doc type stores
+  `card.url`. The three superseded headless debug-dump demos are gone; their components are
+  covered by the skin demos that supersede them.
+
+## 0.6.0
+
+### Minor Changes
+
+- 80617e9: The search page can start a search.
+
+  `setText` had zero callers in the entire repository: the codec carried `q`, the state
+  machine could set it, the request sent it, and no screen could type one. Six of the nine
+  state setters had no control at all. This release is the missing half of the pair.
+
+  - **`<SearchBox>`** — the query box, debounced (350ms, `replace: true`, so ten letters are
+    one history entry), capped at the server's own `MAX_QUERY_CHARS`, with a typeahead over
+    `GET /suggest` — an endpoint that had been typed and unreachable since 0.1. `useSearchBox`
+    is the headless half; `useSuggest` the hook. Exported, so a container's header can mount
+    the same box the page does (`searchBox={false}` then keeps exactly one on screen).
+  - **Range filters** — `r.<slug>=from..to` finally has a control. `state/ranges.ts` decides
+    which rows exist (numeric features of the category schema, plus any slug the URL already
+    constrains); `<RangeFilterRow>` commits on Apply and refuses a backwards range with the
+    reason beside the button instead of returning an empty page.
+  - **Category, location, language and page size** — `renderCategoryFilter` and
+    `renderGeoFilter` are named slots the categories/geo pairs fill, with `SlotPlaceholder`
+    where they are not; either way a constraint that arrived in a shared link now has a control
+    that widens it again (clear the category, adjust or clear the radius). `<LanguageSelect>`
+    and `<PageSizeSelect>` bind `setLanguage` and `setLimit`.
+  - **No reason lives in a hover any more.** The pager, the distance sort and the DSA Art. 26
+    `promoted` explanation were all `title=`/`<Tooltip>` — invisible on every phone and on
+    every disabled button. They are visible text now (`GatedButton`/`GatedControl`, and plain
+    copy under the marking). The pager is absent, not dead, when there is nothing to page.
+  - **The generic card draws `image_url`** through `@stapel/image` (new optional peer), in an
+    aspect box, with the promoted tag on a `--stapel-*` role instead of antd's `gold` preset.
+  - **On a phone the filters are a bottom sheet** behind a "Filters (N)" button, through the
+    shared `SkinDialog`, instead of a full-width panel stacked above the first result.
+  - **The pair's `theme.tsx` and `ErrorAlert.tsx` are deleted** in favour of
+    `@stapel/tokens-antd/skin`'s `SkinTheme` / `ErrorAlert` / `EmptyState` / `LoadList`.
+    `SearchSkinTheme` is no longer exported (pre-1.0 breaking = minor): import `SkinTheme`
+    from the substrate — same props, and a runtime `data-theme` flip repaints it.
+
+  Peers: `@stapel/core >=0.18.0`, `@stapel/tokens-antd >=0.6.0`, `@stapel/image >=0.3.0`
+  (optional — only the `/default` skin needs it). The `/default` size budget moves 13 KB → 16 KB.
+
+### Patch Changes
+
+- 308e3d6: Every `/default` surface is drawn, seeded and photographed.
+
+  The skin shipped in the last release with one demo out of twelve names: the pair could
+  be read in source and not LOOKED at, which is the state §54's gate exists to end. All
+  twelve are covered now, and covered in the state each one is named for.
+
+  - **Eleven new skin demos** — the results pane (found / phone / a search that ran and
+    matched nothing), the filter panel (open, and narrowed by a shared link so every
+    constraint's door-out is visible), the ranking disclosure, the result card (promoted
+    with a photo, and plain), the query box, the sort gate (blocked and open), the page-size
+    ladder, the language filter, the numeric range row, the degradation notice (banner and
+    inline) and the unreadable-link notice. Each imports from `src/default`, each has a
+    `viewport: "phone"` variant, each variant declares the `step` it is seeded at.
+  - **Demos are SEEDED, not fetched** (`DemoSeed` in the demo harness): the answer is written
+    into the query cache under the key the pair's own codec derives, so a variant opens in its
+    state on the first frame instead of photographing the same skeleton under three names.
+    `assertVariantsRenderDistinctly` is wired into the demo suite and enforces it.
+  - **Dedicated suites** for `useSearchBox` (debounce, one history entry per word, the URL
+    winning whenever it moves on its own, the `MAX_QUERY_CHARS` cap), `useSuggest` (the
+    three-character floor, the clamped limit, a refusal that leaves the box typeable, a menu
+    that stays shut on an empty answer) and the range model (which slugs get a row, what the
+    row refuses, and that the reason stands beside the button).
+  - **A render matrix per surface** — each of the four surfaces in phone and desktop, light
+    and dark, asserting the mode is the DOCUMENT's rather than a default baked into the skin,
+    plus the filter surface following the viewport. `setViewport` / `setDocumentTheme` are the
+    test harness helpers the setup file has been pointing at.
+
+  No public API change: `src/` is untouched. The demo registry, manifest and `llms.txt` are
+  regenerated.
+
+## 0.5.0
+
+### Minor Changes
+
+- d778c54: `<SearchPage>` stops laying out a column for filters that do not exist, and
+  stops printing a second heading over the list.
+
+  - The filter column was unconditional. On a deployment whose search plan
+    declares no facets that spent a quarter of `/s`, of every category page and
+    of every seller page on an illustration saying "no filters for this search" —
+    three screens with a hole in them. The page now asks the facet bag what it
+    has and gives the results the whole width when the answer is a LOADED zero.
+    `loading` and `failed` keep the column: a panel that has not answered yet is
+    not a panel with nothing in it, and a layout that reflowed mid-load would be
+    worse than the hole. An active filter keeps it too.
+  - `resultsHeading` / `<SearchResultsPane heading>`: what this surface calls its
+    list. "Results" is only right when the person performed a search — a
+    landing's newest-first strip, a seller's page and a category page each wrote
+    their own caption above the pane and got "Results" underneath it a moment
+    later. The name now goes INTO the heading row that already exists.
+  - `filtersHeader`: a slot at the top of the filter column, for a filter this
+    pair cannot ship. `SearchQueryState` has carried `geo` since 0.2 and
+    `<SortSelect>` already disables "by distance" with the reason "no centre
+    set", but nothing here could ever SET one — turning an address into a
+    coordinate needs a geocoder, and a geocoder is the deployment's. Whatever a
+    host renders here reads and writes the same URL state as the facets beside
+    it.
+  - `useFacetPanel()` is exported: the same bag as `<FacetPanel>`, for a caller
+    that must know what the panel will render before it renders it. A render prop
+    cannot answer a question asked one level up.
+
 ## 0.4.0
 
 ### Minor Changes

package/README.md

@@ -152,7 +152,7 @@ the configured engine cannot evaluate.
 | state (pure) | `parseSearchState`, `writeSearchState`, `patchSearchState`, `toggleFilterValue`, `setFilterValues`, `setRangeValue`, `clearFilters`, `activeFilterCount`, `parseDegradations`, `countIsEstimate`, `buildFacetGroups`, `facetOptionLabel` |
 | model | `createSearchRuntime`, `searchQueryKeys`, `useSearchQuery`, `useRankingDisclosure` |
 | headless | `SearchProvider`, `SearchStateProvider`/`useSearchState`, `SearchResults`, `FacetPanel`, `RankingDisclosure` |
-| `./default` | `SearchPage`, `SearchResultsPane`, `FacetPanelPane`, `RankingDisclosurePane`, `SearchResultCard`, `DegradationNotice`, `UrlIssueNotice`, `SortSelect`, `SearchSkinTheme` |
+| `./default` | `SearchPage`, `SearchResultsPane`, `FacetPanelPane`, `RankingDisclosurePane`, `SearchBox`, `SortSelect`, `PageSizeSelect`, `LanguageSelect`, `SearchResultCard`, `RangeFilterRow`, `DegradationNotice`, `UrlIssueNotice` (the skin themes itself through `SkinTheme` from `@stapel/tokens-antd/skin`; the pair's own `SearchSkinTheme` is gone as of 0.6.0) |
 | `./router` | `useRouterSearchParams` |
 | i18n | `registerSearchI18n` (+ `./i18n/ru`, `./i18n/es`) |
 | errors | `SEARCH_ERRORS`, `explainSearchError`, `SEARCH_WINDOW_EXCEEDED`, `SEARCH_BACKEND_UNAVAILABLE` |

package/dist/default/DegradationNotice.d.ts

@@ -41,6 +41,13 @@ export type DegradationNoticeVariant = "banner" | "inline" | "off";
 export interface DegradationNoticeProps {
     readonly degradations: readonly SearchDegradation[];
     readonly variant?: DegradationNoticeVariant;
+    /**
+     * Names a `scorer:` degradation's slug, when something on the page knows
+     * one. `<SearchResultsPane>` passes the ranking disclosure's own names
+     * (`useScorerNames`); with no answer the slug is printed, which is what a
+     * registry identifier is worth on its own.
+     */
+    readonly scorerName?: (slug: string) => string | undefined;
 }
 export declare function DegradationNotice(props: DegradationNoticeProps): ReactElement | null;
 //# sourceMappingURL=DegradationNotice.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"DegradationNotice.d.ts","sourceRoot":"","sources":["../../src/default/DegradationNotice.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIzD;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC;CAC7C;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,sBAAsB,GAC5B,YAAY,GAAG,IAAI,CA4CrB"}
+{"version":3,"file":"DegradationNotice.d.ts","sourceRoot":"","sources":["../../src/default/DegradationNotice.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAI1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIzD;;;;;;;GAOG;AACH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC5D;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,sBAAsB,GAC5B,YAAY,GAAG,IAAI,CA0DrB"}

package/dist/default/DegradationNotice.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Alert, Flex, Typography } from "antd";
+import { fontSize, spacing } from "@stapel/tokens";
 import { useT } from "@stapel/core";
 import { isCountNuanceOnly } from "../state/degradations.js";
 import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
@@ -13,13 +14,23 @@ export function DegradationNotice(props) {
     // A count nuance is not a degraded search — the count already says "N+".
     if (isCountNuanceOnly(props.degradations))
         return null;
-    const lines = props.degradations.map((degradation) => (_jsx("li", { "data-degradation": degradation.raw, children: _jsx(Typography.Text, { type: "secondary", children: t(degradation.messageKey, {
-                scorer: degradation.scorer ?? "",
-                raw: degradation.raw,
-            }) }) }, degradation.raw)));
+    const say = (degradation) => {
+        const slug = degradation.scorer;
+        return t(degradation.messageKey, {
+            scorer: slug === undefined
+                ? ""
+                : (props.scorerName?.(slug) ?? slug),
+            raw: degradation.raw,
+        });
+    };
+    // NOT `type="secondary"` in the banner: antd paints a warning Alert in the
+    // 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) => (_jsx("li", { "data-degradation": degradation.raw, children: _jsx(Typography.Text, { children: say(degradation) }) }, degradation.raw)));
     if (variant === "inline") {
-        return (_jsxs(Flex, { vertical: true, gap: 2, "data-testid": "search-degraded", "data-variant": "inline", children: [_jsx(Typography.Text, { type: "secondary", style: { fontSize: 12 }, children: t(SEARCH_I18N_KEYS.degradedTitle) }), _jsx("ul", { style: { margin: 0, paddingInlineStart: 20, fontSize: 12 }, children: lines })] }));
+        return (_jsxs(Flex, { vertical: true, gap: spacing[1], "data-testid": "search-degraded", "data-variant": "inline", children: [_jsx(Typography.Text, { type: "secondary", style: { fontSize: fontSize.xs.fontSize }, children: t(SEARCH_I18N_KEYS.degradedTitle) }), _jsx("ul", { style: { margin: 0, paddingInlineStart: spacing[5], fontSize: fontSize.xs.fontSize }, children: props.degradations.map((degradation) => (_jsx("li", { "data-degradation": degradation.raw, children: _jsx(Typography.Text, { type: "secondary", children: say(degradation) }) }, degradation.raw))) })] }));
     }
-    return (_jsx(Alert, { type: "warning", showIcon: true, "data-testid": "search-degraded", "data-variant": "banner", message: t(SEARCH_I18N_KEYS.degradedTitle), description: _jsx("ul", { style: { margin: 0, paddingInlineStart: 20 }, children: lines }) }));
+    return (_jsx(Alert, { type: "warning", showIcon: true, "data-testid": "search-degraded", "data-variant": "banner", title: t(SEARCH_I18N_KEYS.degradedTitle), description: _jsx("ul", { style: { margin: 0, paddingInlineStart: spacing[5] }, children: lines }) }));
 }
 //# sourceMappingURL=DegradationNotice.js.map

package/dist/default/DegradationNotice.js.map

@@ -1 +1 @@
-{"version":3,"file":"DegradationNotice.js","sourceRoot":"","sources":["../../src/default/DegradationNotice.tsx"],"names":[],"mappings":";AA8BA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAiBnD,MAAM,UAAU,iBAAiB,CAC/B,KAA6B;IAE7B,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,OAAO,GAA6B,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC;IACpE,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,yEAAyE;IACzE,IAAI,iBAAiB,CAAC,KAAK,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvD,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CACpD,iCAA4C,WAAW,CAAC,GAAG,YACzD,KAAC,UAAU,CAAC,IAAI,IAAC,IAAI,EAAC,WAAW,YAC9B,CAAC,CAAC,WAAW,CAAC,UAAU,EAAE;gBACzB,MAAM,EAAE,WAAW,CAAC,MAAM,IAAI,EAAE;gBAChC,GAAG,EAAE,WAAW,CAAC,GAAG;aACrB,CAAC,GACc,IANX,WAAW,CAAC,GAAG,CAOnB,CACN,CAAC,CAAC;IAEH,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,CACL,MAAC,IAAI,IAAC,QAAQ,QAAC,GAAG,EAAE,CAAC,iBAAc,iBAAiB,kBAAc,QAAQ,aACxE,KAAC,UAAU,CAAC,IAAI,IAAC,IAAI,EAAC,WAAW,EAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YACtD,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC,GAClB,EAClB,aAAI,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,kBAAkB,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YAC3D,KAAK,GACH,IACA,CACR,CAAC;IACJ,CAAC;IAED,OAAO,CACL,KAAC,KAAK,IACJ,IAAI,EAAC,SAAS,EACd,QAAQ,uBACI,iBAAiB,kBAChB,QAAQ,EACrB,OAAO,EAAE,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAC1C,WAAW,EACT,aAAI,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,kBAAkB,EAAE,EAAE,EAAE,YAAG,KAAK,GAAM,GAEhE,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"DegradationNotice.js","sourceRoot":"","sources":["../../src/default/DegradationNotice.tsx"],"names":[],"mappings":"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"}

package/dist/default/FacetGroupControl.d.ts

@@ -0,0 +1,40 @@
+import type { ReactElement } from "react";
+import type { FacetGroup, FacetOption } from "../state/facets.js";
+/**
+ * How many options a group shows before the rest go behind "Show all".
+ *
+ * Eight is the count at which a group stops being readable at a glance and
+ * starts being a scroll: it is two more than the six the visual pass measured
+ * as the fold on a 390px phone with the sheet's own chrome above it, which
+ * leaves a group of seven whole rather than truncated by one row.
+ */
+export declare const FACET_VISIBLE_OPTIONS = 8;
+/** The three shapes a facet group takes. */
+export type FacetGroupShape = "segmented" | "nested" | "checkbox";
+/** The option rows of a group, already nested where the schema nests them. */
+export interface FacetOptionNode {
+    readonly option: FacetOption;
+    /** 0 for a root option; 1+ for a child of a `hierarchical_select` tree. */
+    readonly depth: number;
+}
+/**
+ * Which of the three shapes a group takes.
+ *
+ * Order matters: a hierarchical facet is nested even when it is single-choice,
+ * because losing the tree costs more than losing the pills.
+ */
+export declare function facetGroupShape(group: FacetGroup): FacetGroupShape;
+/** The group's options in render order, carrying the depth the schema gives. */
+export declare function facetOptionNodes(group: FacetGroup): readonly FacetOptionNode[];
+export interface FacetGroupControlProps {
+    readonly group: FacetGroup;
+    readonly onToggle: (slug: string, value: string) => void;
+    /** Draw the group's own name above its options. `false` for a surface that
+     * has already said it — a per-group sheet whose title IS the group. */
+    readonly heading?: boolean;
+    /** How many options before "Show all". Default {@link FACET_VISIBLE_OPTIONS};
+     * `null` shows every option (a sheet devoted to one group has the room). */
+    readonly visibleOptions?: number | null;
+}
+export declare function FacetGroupControl(props: FacetGroupControlProps): ReactElement;
+//# sourceMappingURL=FacetGroupControl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FacetGroupControl.d.ts","sourceRoot":"","sources":["../../src/default/FacetGroupControl.tsx"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAMzD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGlE;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,4CAA4C;AAC5C,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElE,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAwCD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CAMlE;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,eAAe,EAAE,CAqB9E;AA6FD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD;2EACuE;IACvE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;gFAC4E;IAC5E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CAqE7E"}

package/dist/default/FacetGroupControl.js

@@ -0,0 +1,176 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `<FacetGroupControl>` — ONE facet group, drawn the way its own schema says
+ * it should be drawn.
+ *
+ * Until this release every group was the same thing: a flat column of
+ * checkboxes, however many options it had and whatever the category schema
+ * said about it. That is wrong in three ways a person meets on the first
+ * screen of a real catalogue:
+ *
+ *  1. **A single-choice facet is not a checkbox list.** `maxSelected: 1` is a
+ *     fact the schema already carries, and `@stapel/attributes-react`'s editor
+ *     already reads it to draw a segmented control rather than a set of boxes.
+ *     A filter that says "pick one" with controls that say "pick any" teaches
+ *     the wrong thing before the click and surprises after it.
+ *  2. **A hierarchical facet is not flat.** `hierarchical_select` carries a
+ *     TREE in `config.options`; rendering its values as one alphabetical
+ *     column hides that "Sedan" is under "Cars" and puts a child next to its
+ *     own parent as if they were siblings.
+ *  3. **A 60-option facet is not a list, it is a wall.** Every catalogue has
+ *     one — brand, model, city — and printing all of it pushes every group
+ *     under it off the screen.
+ *
+ * ── The presentation is DERIVED, never configured here ────────────────────
+ *
+ * {@link facetGroupShape} reads the same `config` keys the attributes editor
+ * reads (`maxSelected`, `type`, `options`), so a facet cannot look one way in
+ * the filter and another way in the composer that produced the value. There is
+ * no `presentation` prop on this component and there must not be one: a
+ * per-call-site override is how the two halves drift.
+ *
+ * A group with NO schema (the host passed no `categoryFeatures`, or the slug
+ * is not in it) is a flat checkbox list — the honest default, and the shape
+ * every group had before.
+ */
+import { useState } from "react";
+import { Button, Checkbox, Flex, Typography } from "antd";
+import { useT } from "@stapel/core";
+import { radii, spacing } from "@stapel/tokens";
+import { featureConfig, featureType } from "@stapel/attributes-react";
+import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
+/**
+ * How many options a group shows before the rest go behind "Show all".
+ *
+ * Eight is the count at which a group stops being readable at a glance and
+ * starts being a scroll: it is two more than the six the visual pass measured
+ * as the fold on a 390px phone with the sheet's own chrome above it, which
+ * leaves a group of seven whole rather than truncated by one row.
+ */
+export const FACET_VISIBLE_OPTIONS = 8;
+function numberish(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+/**
+ * The DEPTH of every value a `hierarchical_select` config declares, walked
+ * once — `{value: depth}`.
+ *
+ * The tree lives in `config.options[].children[]` (the same shape
+ * `@stapel/attributes-react`'s `Cascader` reads). The facets themselves arrive
+ * FLAT from the server, because an index term has no parent; the schema is the
+ * only thing that knows one value sits under another.
+ */
+function optionDepths(raw, depth = 0, into = new Map()) {
+    if (!Array.isArray(raw))
+        return into;
+    for (const option of raw) {
+        if (option === null || typeof option !== "object")
+            continue;
+        const entry = option;
+        if (entry.value !== undefined && entry.value !== null) {
+            into.set(String(entry.value), depth);
+        }
+        optionDepths(entry.children, depth + 1, into);
+    }
+    return into;
+}
+/** Is this feature single-choice? The schema's own answer, not a guess. */
+function singleChoice(feature) {
+    if (feature === undefined)
+        return false;
+    // `maxSelected` ABSENT means unlimited — the engine's own default. Reading
+    // an absent key as 1 would turn every unconfigured facet into a radio group.
+    return numberish(featureConfig(feature)["maxSelected"]) === 1;
+}
+/**
+ * Which of the three shapes a group takes.
+ *
+ * Order matters: a hierarchical facet is nested even when it is single-choice,
+ * because losing the tree costs more than losing the pills.
+ */
+export function facetGroupShape(group) {
+    const feature = group.feature;
+    if (feature !== undefined && featureType(feature) === "hierarchical_select") {
+        return "nested";
+    }
+    return singleChoice(feature) ? "segmented" : "checkbox";
+}
+/** The group's options in render order, carrying the depth the schema gives. */
+export function facetOptionNodes(group) {
+    if (facetGroupShape(group) !== "nested" || group.feature === undefined) {
+        return group.options.map((option) => ({ option, depth: 0 }));
+    }
+    const depths = optionDepths(featureConfig(group.feature)["options"]);
+    // Depth alone would leave children beside strangers: the options are
+    // re-ordered so each child follows its own parent, and a value the schema
+    // does not know keeps depth 0 rather than being hidden under someone.
+    const byValue = new Map(group.options.map((option) => [option.value, option]));
+    const out = [];
+    const emitted = new Set();
+    for (const [value, depth] of depths) {
+        const option = byValue.get(value);
+        if (option === undefined)
+            continue;
+        out.push({ option, depth });
+        emitted.add(value);
+    }
+    for (const option of group.options) {
+        if (!emitted.has(option.value))
+            out.push({ option, depth: 0 });
+    }
+    return out;
+}
+/** A count, or the honest "we did not count this". Never a zero standing in
+ * for an absent answer. */
+function OptionCount(props) {
+    const t = useT();
+    return (_jsx(Typography.Text, { type: "secondary", "data-testid": `facet-count-${props.group.slug}-${props.option.value}`, children: props.option.count === null
+            ? t(SEARCH_I18N_KEYS.facetsNotCounted)
+            : props.option.count }));
+}
+/** The indent one level of a hierarchical facet is drawn with. */
+const NEST_STEP = spacing[5];
+function CheckboxRow(props) {
+    const { group, node } = props;
+    return (_jsxs(Flex, { justify: "space-between", align: "center", gap: spacing[2], style: node.depth > 0
+            ? { paddingInlineStart: node.depth * NEST_STEP }
+            : undefined, "data-depth": node.depth, children: [_jsx(Checkbox, { checked: node.option.selected, "data-testid": `facet-option-${group.slug}-${node.option.value}`, "data-analytics": "none", "data-analytics-reason": "a filter is a read, not a flow step", onChange: () => {
+                    props.onToggle(group.slug, node.option.value);
+                }, children: node.option.label }), _jsx(OptionCount, { group: group, option: node.option })] }));
+}
+/**
+ * One pill of a single-choice group.
+ *
+ * A real `<button aria-pressed>` rather than antd's `Segmented`: the count has
+ * to sit inside the pill (a filter without its remaining count is the
+ * drill-down facet turned naive), and `Segmented` takes labels, not rows.
+ * `aria-pressed` is what makes a styled button a TOGGLE to a screen reader
+ * instead of a link-shaped thing that mysteriously changes the page.
+ */
+function OptionPill(props) {
+    const { group, option } = props;
+    const style = { borderRadius: radii.full };
+    return (_jsx(Button, { size: "small", shape: "round", type: option.selected ? "primary" : "default", "aria-pressed": option.selected, style: style, "data-testid": `facet-option-${group.slug}-${option.value}`, "data-analytics": "none", "data-analytics-reason": "a filter is a read, not a flow step", onClick: () => {
+            props.onToggle(group.slug, option.value);
+        }, children: option.count === null ? option.label : `${option.label} ${option.count}` }));
+}
+export function FacetGroupControl(props) {
+    const t = useT();
+    const { group } = props;
+    const [expanded, setExpanded] = useState(false);
+    const shape = facetGroupShape(group);
+    const nodes = facetOptionNodes(group);
+    const limit = props.visibleOptions === null
+        ? null
+        : (props.visibleOptions ?? FACET_VISIBLE_OPTIONS);
+    // A group one row over the limit is not truncated: hiding a single option
+    // behind "Show all (9)" costs a tap to reveal exactly one thing.
+    const collapsible = limit !== null && nodes.length > limit + 1;
+    const shown = collapsible && !expanded ? nodes.slice(0, limit) : nodes;
+    return (_jsxs(Flex, { vertical: true, gap: shape === "segmented" ? spacing[2] : spacing[1], "data-testid": `facet-group-${group.slug}`, "data-counted": group.counted ? "true" : "false", "data-shape": shape, children: [props.heading !== false && (_jsx(Typography.Text, { strong: true, children: group.label })), shape === "segmented" ? (_jsx(Flex, { wrap: true, gap: spacing[2], children: shown.map((node) => (_jsx(OptionPill, { group: group, option: node.option, onToggle: props.onToggle }, node.option.value))) })) : (shown.map((node) => (_jsx(CheckboxRow, { group: group, node: node, onToggle: props.onToggle }, node.option.value)))), collapsible && (_jsx(Button, { type: "link", size: "small", style: { alignSelf: "flex-start", paddingInline: 0 }, "data-testid": `facet-more-${group.slug}`, "data-analytics": "none", "data-analytics-reason": "expanding a filter group is a read, not a flow step", onClick: () => {
+                    setExpanded((was) => !was);
+                }, children: expanded
+                    ? t(SEARCH_I18N_KEYS.facetsShowLess)
+                    : t(SEARCH_I18N_KEYS.facetsShowAll, { count: nodes.length }) }))] }));
+}
+//# sourceMappingURL=FacetGroupControl.js.map

package/dist/default/FacetGroupControl.js.map

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

package/dist/default/FacetPanelPane.d.ts

@@ -1,5 +1,11 @@
 /**
- * `<FacetPanelPane>` — the antd facet panel.
+ * `<FacetPanelPane>` — the antd FILTER panel: everything that narrows a
+ * search, in the order a person narrows it.
+ *
+ * Category → language → location → numeric ranges → facet checkboxes. The last
+ * of those was, for three releases, the only one that existed: six of the nine
+ * state setters had no control at all, so a price range or a location could
+ * only be applied by editing the address bar (audit S-2, S-7).
  *
  * Three things it is obliged to render, all of which a naive panel drops:
  *
@@ -12,15 +18,60 @@
  *  - `skipped` — the slugs the server did not count at all. Their options show
  *    "not counted", never `0`. A silent zero there is the same defect class as
  *    `data ?? []`: a number that looks like an answer and is not one.
+ *
+ * ── Two slots, and why they are slots ─────────────────────────────────────
+ *
+ * `renderCategoryFilter` and `renderGeoFilter` are filled by OTHER pairs:
+ * choosing a category means walking the catalogue tree (`categories-react`),
+ * and turning an address into a coordinate needs a geocoder and a map
+ * (`geo-react`). Neither belongs in a search package, and importing either
+ * would tie a storefront's search to a catalogue it might not have.
+ *
+ * What this panel does NOT do is pretend the slot is optional. An unfilled
+ * slot renders `SlotPlaceholder` in development — a named, visible hole rather
+ * than a silent absence — and, in every build, any constraint the URL already
+ * carries gets a control that REMOVES it. A shared link that narrows to a
+ * category or a point must never leave a person with no way to widen it again.
  */
-import type { ReactElement } from "react";
+import type { ReactElement, ReactNode } from "react";
 import type { FeatureDef } from "@stapel/attributes-react";
+import type { SearchGeo } from "../api/types.js";
 import type { ThemeModeProp } from "./types.js";
+/** What a host's category control is handed. */
+export interface CategoryFilterSlotProps {
+    /** The `root/leaf` path the search is narrowed to, if any. */
+    readonly value: string | undefined;
+    /** `null` widens the search back to the whole catalogue. */
+    readonly onChange: (path: string | null) => void;
+}
+/** What a host's location control is handed. */
+export interface GeoFilterSlotProps {
+    readonly value: SearchGeo | undefined;
+    /** `null` clears the location constraint. */
+    readonly onChange: (geo: SearchGeo | null) => void;
+}
 export interface FacetPanelPaneProps extends ThemeModeProp {
-    /** The category's feature schema — the source of option LABELS. */
+    /** The category's feature schema — the source of option LABELS and of which
+     * slugs get a numeric range row. */
     readonly categoryFeatures?: readonly FeatureDef[];
     readonly locale?: string;
     readonly enabled?: boolean;
+    /** The catalogue picker (`categories-react`'s `CategoryPickerField`, bound
+     * to a path). Unfilled, an active category still gets a "clear" control. */
+    readonly renderCategoryFilter?: (slot: CategoryFilterSlotProps) => ReactNode;
+    /** The location control (`geo-react`). Unfilled, a location that arrived in
+     * the URL still gets its radius and a "clear" control. */
+    readonly renderGeoFilter?: (slot: GeoFilterSlotProps) => ReactNode;
+    /** BCP-47 tags this deployment indexes — see {@link LanguageSelect}. */
+    readonly languages?: readonly string[];
+    /**
+     * What the panel calls itself. `null` draws no title at all — for a surface
+     * that has ALREADY named it, which the phone sheet has: its dialog title and
+     * the panel's own heading both said "Filters", one under the other, in every
+     * shot of the open sheet. The row itself stays either way, because the
+     * "Clear all" control lives in it.
+     */
+    readonly heading?: ReactNode;
 }
 export declare function FacetPanelPane(props: FacetPanelPaneProps): ReactElement;
 //# sourceMappingURL=FacetPanelPane.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FacetPanelPane.d.ts","sourceRoot":"","sources":["../../src/default/FacetPanelPane.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAM3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,mEAAmE;IACnE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAsCD,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAwGvE"}
+{"version":3,"file":"FacetPanelPane.d.ts","sourceRoot":"","sources":["../../src/default/FacetPanelPane.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAkBrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,gDAAgD;AAChD,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAClD;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IACtC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD;wCACoC;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;gFAC4E;IAC5E,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,SAAS,CAAC;IAC7E;8DAC0D;IAC1D,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,SAAS,CAAC;IACnE,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;CAC9B;AAqKD,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CA4IvE"}