@stapel/search-react 0.22.0 → 0.24.0

package/CHANGELOG.md

@@ -1,5 +1,161 @@
 # @stapel/search-react
 
+## 0.24.0
+
+### Minor Changes
+
+- 01edcd1: search: the chip row gains an APPLIED mode — one chip per constraint, each beside the control that drops it
+
+  A storefront integrator built this row by hand and asked for it back. On a
+  desktop the filters are a rail two thousand pixels tall, and picking two values
+  left NOTHING between the page header and the first card: the only trace of a
+  choice was a pressed button somewhere inside the column and one "clear all (2)"
+  beside it. Dropping ONE of the two meant scrolling the rail until the same
+  button came back. A constraint on screen must keep the control that removes it,
+  and on that surface neither half was true — the constraint was not on screen
+  and its control was not beside it.
+
+  `<FilterChips>` could not be the answer as it stood. It is a row of OPENERS —
+  one chip per axis, applied or not, each opening its own `SkinDialog` — which is
+  the right shape where the panel is behind a tap and the wrong one where the
+  panel is already drawn: beside an open rail it prints the whole panel twice and
+  still removes nothing without a modal over the results.
+
+  **`mode?: "openers" | "applied"`**, default `openers`, which is byte-for-byte
+  the row that shipped. In `applied`:
+
+  - **one chip per applied VALUE and per applied numeric range**, never one per
+    axis — three chosen brands are three chips and three removals, where an
+    axis-shaped chip would drop all three with one press;
+  - **every caption names the axis AND the value** — "Brand: Bosch", "Price: from
+    100 to 500" — because beside a dozen axes a bare value names nothing. A core
+    money axis prints as money in the currency the answer's own cards carry; an
+    attribute prints its schema unit; the bounds themselves print exactly as the
+    URL carries them, since the wire never promised a number and reformatting one
+    would rewrite the link;
+  - **every chip is a real `<button>`** whose press removes exactly that
+    constraint and whose accessible name says so. Not an antd `Tag closable`,
+    whose close icon is a `<span>` with no tab stop — a constraint a keyboard can
+    read and cannot drop — and not a modal detour;
+  - **the rail's own clear-all**, beside the chips instead of a column-height
+    down the page;
+  - **the same label path as the rail**, stamped on the markup:
+    `data-label-source` for the axis and `data-value-label-source` for the value,
+    each `server | schema | host | none`. A raw index term reaching this row is
+    something a storefront's test can fail on rather than eyeball;
+  - **nothing at all when nothing is applied** — an empty band above the results
+    is furniture — and nothing before the answer lands: both halves of a caption
+    are named by the envelope (`facet_labels`, `facet_meta.core_ranges`), so a row
+    that drew early would caption a chip with a slug and rename it a moment
+    later.
+
+  Both modes read the SAME bag the rail reads (`useFacetPanel`, `buildRangeGroups`
+  over the page's own state), so no two surfaces can disagree about what is
+  applied or about what a value is called.
+
+  **`<SearchPage appliedChips="desktop">`** mounts the row in the results header
+  with one prop. `"desktop"` is the case this exists for — where the rail is on
+  screen; on the phone the opener row below already states every applied filter on
+  its own chip, and a second row would say it twice. `true` draws it in both
+  layouts; omitted, nothing changes.
+
+  `buildAppliedChips`, `rangeChipText`, `rangeLabelSource` and
+  `appliedChipTestId` are exported for a host composing its own row, along with
+  `FilterChipsMode` and the split prop types (`FilterChipsOpenerProps` /
+  `FilterChipsAppliedProps`, unioned as `FilterChipsProps`) — the applied mode
+  takes no `onOpenAll` because it opens nothing.
+
+## 0.23.0
+
+### Minor Changes
+
+- e8d7744: search: the rail is the category's own form, and the axes a seller had to fill are the ones a buyer sees first
+
+  A walk of a live classified's desktop cars page reported three things in one
+  breath, and they turned out to be four faults with one shape: the panel was
+  answering questions the _answer_ had asked, not the ones the _category_ asks.
+
+  **The rail is in SCHEMA order, required first.** It ranked by evidence — the
+  sum of an axis's counts — which is the right question for a phone chip row
+  with room for four and the wrong one for the column a person narrows a
+  catalogue in. On three listings the busiest axis is whichever three values
+  happen to be counted, so the rail opened on condition and colour while the
+  make, the model and the year — the three fields the category marks `mandatory`,
+  i.e. the three every seller had to fill — sat below them. `orderFacetGroupsBySchema`
+  puts pinned slugs first, then the required features in the schema's own order,
+  then the rest in schema order, then what the schema does not name at all in
+  evidence order, because with no schema there is no other order to have. Stable
+  under a click, which a rail that reshuffles as you tick is not. Past
+  `visibleGroups` (default 8) the tail folds under one **All filters (K)**
+  control — never a group you have already chosen a value in, because the control
+  that removes a filter is the one you came back for. `<SearchPage>` gains
+  `partition` (drawn above the price: which half of one template a page is about
+  is not a filter among filters) and `pinnedFacets`.
+
+  **Why the make could vanish.** `facetGroupIsDrawable` is now the one predicate
+  the rail and the chip row share, and it says what the old duplicated
+  `options.length > 0` said without saying WHY: a group with nothing under it is
+  a heading over nothing. The catalogue's `make`, `model`, `generation` and
+  `body_type` are `ref_select` features whose config is a bare `optionsRef`
+  pointer — no option table in the schema and there never will be — so the moment
+  the server's plan does not count one, there is nothing on either side to
+  enumerate and the group leaves the page, while every `select`-typed comfort
+  option (steering side, power steering, heating) draws its own schema table and
+  stays. That is the exact set the walker saw and did not see. The drop is still
+  right — a dead heading helps nobody — and it is no longer SILENT: outside
+  production one `console.warn` names the axis, says which side is missing
+  (uncounted, or a schema that does not define it), and says when the schema
+  calls the axis **required**. Both owners of that wiring fault can now see it
+  from the page. The regression is pinned against the live answer itself, saved
+  as a fixture (`test/liveCars.ts`, captured 2026-09-04): an axis with evidence
+  buckets survives the parent node's EMPTY feature list and a def that names it
+  without typing it.
+
+  **A dictionary outranks the pills, and on desktop it is a FIELD.** The live
+  make axis is `maxSelected: 1` over a 418-value vocabulary, so "pick one" won
+  the shape contest and the control it produced was four hundred pills in a 280px
+  rail — a wall with a different border radius. `facetGroupShape` now asks
+  "dictionary?" before "single-choice?". And on the rail
+  (`dictionaryMode="field"`, which `<SearchPage>` sets for the column layout) a
+  dictionary closes into a select-style field reading its chosen values or _Any_,
+  which opens the searchable list you already had: a real `role="combobox"`
+  button, ArrowDown to open, Escape to close. The phone sheet keeps the list
+  inline — the sheet is already the disclosure.
+
+  **A bounded integer is a picker, not a bare number.** The year was two empty
+  number fields; it is `int` with `min: 1900, max: 2027`, which is 128 values and
+  therefore a list. `RangeGroup.picker` carries it (newest first — a year picker
+  that opens on 1900 is a picker nobody uses) for any `int` feature whose schema
+  declares both bounds and spans at most `RANGE_PICKER_MAX_VALUES` (300), and
+  `<RangeFilterRow>` draws two from/to selects. Typing still works and carries
+  the bounds: a valid in-range number narrows the list, anything else brings the
+  whole list back with the bounds said in words, because a year below the
+  catalogue's floor otherwise does nothing at all, silently. A mileage
+  (`1..1000000`) and the core price stay two typed fields.
+
+  **The rail's scrollbar is in the gutter, not on the filters.**
+  `scrollbar-width: thin` and `scrollbar-gutter: stable` are the standard half
+  and they are not enough: on every overlay-scrollbar platform — a Mac by
+  default, every iOS browser — the bar is painted OVER the content and the gutter
+  reserves nothing, which is why it lay across the checkbox labels. The rail now
+  also declares a classic bar through the WebKit pseudo-elements, with a real
+  width so it displaces rather than overlaps, and every colour a `--stapel-*`
+  custom property so it is the panel's own hairline in both themes rather than a
+  grey that glows in the dark one. `railScrollbarCss()` and `RAIL_CLASS` are
+  exported for a host that lays out its own column.
+
+  **`<PartitionChips variant="segmented">`** is the desktop rail's shape of the
+  same choice: one joined control under its own label instead of a wrapping pill
+  row, which in a 280px column is two ragged lines. The SEMANTICS do not vary
+  with the variant — the same `radiogroup`, the same roving tabindex, the same
+  arrow keys — because a segmented look is a border-radius decision, and swapping
+  in a component that draws joined cells by giving up "exactly one of these is
+  true" would trade the accessible half of the control for the visible half.
+
+  Also: `FacetLabels.label_translatable` is typed. The live answer sends it
+  beside every group label and the pinned `schema.json` does not describe it, so
+  a fixture captured from the wire was a type error.
+
 ## 0.22.0
 
 ### Minor Changes

package/MODULE.md

@@ -207,6 +207,18 @@ Set on `<SearchPage>`, it reaches both filter surfaces: the desktop panel and
 the phone chip row read one `useFacetPanel`, so they cannot print two words for
 one value.
 
+**The gap the seam does not close: EXISTENCE.** `resolveFacetLabels` names
+values; it does not enumerate them. A `ref_select` group the server did not
+count therefore has no options from either side — the answer counted nothing,
+the schema holds a pointer — and `facetGroupIsDrawable` refuses to draw a
+heading over nothing. Measured on a live cars leaf, that is exactly the set a
+buyer misses (make, model, generation, body type) while every `select`-typed
+option keeps its schema table. The client cannot invent the values, so the fix
+is on the other side — the facet plan must count a required vocabulary axis —
+and until it does, the disappearance is reported: one `console.warn` per slug
+outside production, naming the axis, the missing side, and whether the schema
+marks it required.
+
 ## The chip row's order is the row's product
 
 At 390px about four chips fit before the fold. On a live phone category the

package/README.md

@@ -157,6 +157,46 @@ Every `FacetGroup` and every `FacetOption` carries `labelSource:
 "server" | "schema" | "host" | "none"`, so "did anybody actually name this?" is
 answerable without looking at the string.
 
+## The rail is in schema order, required first
+
+The panel used to rank its groups by **evidence** — the sum of an axis's
+counts. That is the right question for a phone chip row with room for four and
+the wrong one for the column a person narrows a catalogue in: on a live cars
+page it opened on *condition* and *colour*, because with three listings the
+busiest axis is whichever three values happen to be counted, while *make*,
+*model* and *year* — the three fields the category marks `mandatory`, i.e. the
+three every seller had to fill — sat below them.
+
+The rail now follows the **category's own order**, in four bands: pinned slugs,
+then `mandatory` features in schema order, then the rest in schema order, then
+whatever the schema does not name at all (evidence order among themselves —
+with no schema there is no other order to have). Stable under a click, which a
+rail that reshuffles as you tick is not.
+
+```tsx
+<SearchPage
+  partition={<PartitionChips variant="segmented" items={children} … />}
+  pinnedFacets={["body_type_ref_select"]}
+/>
+orderFacetGroupsBySchema({ groups, categoryFeatures, pinned })
+```
+
+Past `visibleGroups` (default `FACET_VISIBLE_GROUPS`, 8) the tail folds under
+one **All filters (K)** control — except a group you have already chosen a
+value in, which is never folded away: the control that removes a filter is the
+one you came back for. The phone sheet passes `visibleGroups={null}`; a surface
+devoted to filtering has the room.
+
+`facetGroupIsDrawable(group)` is the one rule the rail and the chip row share
+for "is there anything to draw here". A group with no options is a heading over
+nothing — after `buildFacetGroups` learned to read the schema, what is left in
+that state is a `ref_select` whose config is a bare `optionsRef` pointer and
+which the server did not count, so there is nothing to enumerate from either
+side. It is not drawn, and outside production it is **named**: a
+`console.warn` says which axis went, why, and whether the schema calls it
+required. That is the fault that took *make* off a live cars rail while every
+`select`-typed comfort option drew its own table and stayed.
+
 ## A vocabulary is a dictionary, not a checkbox list
 
 Past eight **evidence buckets** a `ref_select` group (or an untyped group that
@@ -173,11 +213,84 @@ answer — stapel-search caps a vocabulary-backed group at
 this), so a 418-term make dictionary arrives whole and the box has everything
 it filters.
 
+A dictionary outranks the pills, too: the live `make` axis is `maxSelected: 1`
+over a 418-value vocabulary, so "pick one" used to win and the control it drew
+was four hundred pills in a 280px rail.
+
+On the **desktop rail** a dictionary is a select-style FIELD
+(`dictionaryMode="field"`, which `<SearchPage>` sets for the column layout):
+closed it reads the chosen values or *Any*, and it opens the searchable list —
+a real `role="combobox"` button, Enter/Space to open, ArrowDown to open,
+Escape to close. The phone sheet keeps the list inline, because the sheet is
+already the disclosure.
+
 ```tsx
 facetGroupShape(group)   // "segmented" | "nested" | "checkbox" | "dictionary"
 isDictionaryFacet(group) // > FACET_DICTIONARY_THRESHOLD counted buckets
 ```
 
+## A bounded integer is a picker, not a bare number
+
+A year is not a quantity a person computes, it is one of a hundred-odd values,
+and on a live cars page it was two empty number fields. An `int` feature whose
+schema declares both bounds and spans at most `RANGE_PICKER_MAX_VALUES` (300)
+gets `RangeGroup.picker` — the value list, newest first — and
+`<RangeFilterRow>` draws two from/to selects over it. Typing still works and
+carries the bounds: a valid in-range number narrows the list, anything else
+brings the whole list back **with the bounds said in words** ("from 1900 to
+2027"), because a year below the catalogue's floor otherwise does nothing at
+all, silently. A mileage (`1..1000000`) and the core price stay two typed
+fields.
+
+## The applied filters have a row of their own
+
+`<FilterChips>` has two modes. The default, `mode="openers"`, is the phone's
+row: one chip per axis, applied or not, each opening its own picker. Beside a
+desktop rail that shape is wrong twice — it prints the whole panel a second
+time, and no chip in it removes anything without a modal over the results.
+
+`mode="applied"` is the other row, and a page mounts it with one prop:
+
+```tsx
+<SearchPage adapter={adapter} appliedChips="desktop" categoryFeatures={features} />
+```
+
+`"desktop"` draws it only where the rail is on screen (on the phone the opener
+row below already states every applied filter on its own chip); `true` draws it
+in both layouts. `<FilterChips mode="applied" />` mounts the same row anywhere
+a host wants it.
+
+What it draws:
+
+- **one chip per applied VALUE and per applied numeric range**, never one per
+  axis — three chosen brands are three chips and three removals;
+- **each caption names the axis and the value** — "Brand: Bosch", "Price: from
+  100 to 500" — because beside a dozen axes a bare value names nothing. A core
+  money axis prints as money, in the currency the answer's own cards carry;
+- **each chip is a real `<button>`** whose press drops exactly that constraint
+  and whose accessible name says so (an antd `Tag closable` puts the removal in
+  a `<span>` with no tab stop: a constraint a keyboard can read and cannot
+  drop), plus the same clear-all the rail's footer runs;
+- **the label path of the rail**, stamped: `data-label-source` for the axis and
+  `data-value-label-source` for the value, both `server | schema | host | none`;
+- **nothing at all when nothing is applied**, and nothing before the answer
+  lands — a caption that renames itself under the reader is worse than one that
+  arrives a moment later.
+
+`buildAppliedChips`, `rangeChipText`, `rangeLabelSource` and
+`appliedChipTestId` are exported for a host composing its own row.
+
+## The rail's scrollbar is in the gutter, not on the filters
+
+The rail scrolls on its own when it outgrows the window. `scrollbar-width:
+thin` plus `scrollbar-gutter: stable` is the standard half and it is not
+enough: on every overlay-scrollbar platform (a Mac by default, every iOS
+browser) the bar is drawn OVER the content and the gutter reserves nothing. So
+the rail also declares a classic bar through the WebKit pseudo-elements, with a
+real width and every colour a `--stapel-*` custom property, so it is the
+panel's own hairline in both themes. `railScrollbarCss()` and `RAIL_CLASS` are
+exported for a host that lays out its own column.
+
 ## Two browse surfaces the page places
 
 Both are exported from `./default` and neither lays itself out — where they
@@ -194,13 +307,16 @@ not a media query: whether a 390px screen has room is a fact about the page.
 ```
 
 `<PartitionChips>` is the single-select row a `chips` category draws instead of
-a tile grid: `Все | child…` from `{id, path, name}`, controlled (the choice is
-a `category` in the URL), a real `radiogroup` with roving tabindex and arrow
-keys — because exactly one of them is true at a time, and `aria-pressed`
-toggles say the opposite.
+a tile grid: an "all" cell plus one per child, from `{id, path, name}`,
+controlled (the choice is a `category` in the URL), a real `radiogroup` with
+roving tabindex and arrow keys — because exactly one of them is true at a time,
+and `aria-pressed` toggles say the opposite. `variant="segmented"` is the
+desktop rail's shape (one joined control under its own label); the semantics do
+not vary with it.
 
 ```tsx
 <PartitionChips items={children} value={state.category ?? null}
+                variant={isPhone ? "chips" : "segmented"}
                 onChange={(path) => patch({ category: path })} />
 ```
 
@@ -254,10 +370,10 @@ the configured engine cannot evaluate.
 | Layer | Exports |
 |---|---|
 | api | `createSearchApi`, `searchQueryParams`, `SEARCH_SORTS`, wire types |
-| state (pure) | `parseSearchState`, `writeSearchState`, `patchSearchState`, `toggleFilterValue`, `setFilterValues`, `setRangeValue`, `clearFilters`, `activeFilterCount`, `parseDegradations`, `countIsEstimate`, `buildFacetGroups`, `facetOptionLabel`, `translitPrefixMatch`, `translitKey`, `consonantKey` |
+| state (pure) | `parseSearchState`, `writeSearchState`, `patchSearchState`, `toggleFilterValue`, `setFilterValues`, `setRangeValue`, `clearFilters`, `activeFilterCount`, `parseDegradations`, `countIsEstimate`, `buildFacetGroups`, `orderFacetGroupsBySchema`, `facetGroupIsDrawable`, `facetGroupHasEvidence`, `facetOptionLabel`, `translitPrefixMatch`, `translitKey`, `consonantKey` |
 | model | `createSearchRuntime`, `searchQueryKeys`, `useSearchQuery`, `useRankingDisclosure` |
 | headless | `SearchProvider`, `SearchStateProvider`/`useSearchState`, `SearchResults`, `FacetPanel`, `RankingDisclosure` |
-| `./default` | `SearchPage`, `SearchResultsPane`, `FacetPanelPane`, `RankingDisclosurePane`, `SearchBox`, `SortSelect`, `PageSizeSelect`, `LanguageSelect`, `SearchResultCard`, `RangeFilterRow`, `DegradationNotice`, `UrlIssueNotice`, `PopularValues`, `PartitionChips`, `facetGroupShape`, `isDictionaryFacet` (the skin themes itself through `SkinTheme` from `@stapel/tokens-antd/skin`; the pair's own `SearchSkinTheme` is gone as of 0.6.0) |
+| `./default` | `SearchPage`, `SearchResultsPane`, `FacetPanelPane`, `RankingDisclosurePane`, `SearchBox`, `SortSelect`, `PageSizeSelect`, `LanguageSelect`, `SearchResultCard`, `RangeFilterRow`, `DegradationNotice`, `UrlIssueNotice`, `PopularValues`, `PartitionChips`, `FilterChips` (`mode="openers" | "applied"`), `buildAppliedChips`, `facetGroupShape`, `isDictionaryFacet`, `railScrollbarCss`, `RAIL_CLASS`, `FACET_VISIBLE_GROUPS` (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/api/types.d.ts

@@ -28,6 +28,19 @@ export type Schemas = components["schemas"];
  */
 export type FacetLabels = Schemas["FacetLabels"] & {
     readonly label?: string | null;
+    /**
+     * Whether {@link label} is a translation KEY rather than a caption, the way
+     * `translatable` says it for the values.
+     *
+     * Measured on a live answer (`category=141/151`, 2026-09-04): the server
+     * sends it beside every label — a make caption with
+     * `label_translatable: false`, a condition caption with `true` — and the
+     * describe it. Declared, not consumed: this pair passes the group heading
+     * through its translator either way, and a caption that is not a key comes
+     * back unchanged (`translate()` keeps a key it cannot resolve). Typed so a
+     * fixture captured from the wire is not a type error.
+     */
+    readonly label_translatable?: boolean;
 };
 /** `facet_labels` as a whole: `{slug: {label, translatable, values}}`. */
 export type FacetLabelsMap = Readonly<Record<string, FacetLabels>>;

package/dist/api/types.d.ts.map

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

package/dist/api/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAoLA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,sBAAsB,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAiC;IAC5D,OAAO,MAAM,EAAE,KAAK,IAAI,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;AAC9C,CAAC;AAQD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,WAAW;IACX,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,UAAU;CACX,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAiMA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,sBAAsB,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAiC;IAC5D,OAAO,MAAM,EAAE,KAAK,IAAI,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;AAC9C,CAAC;AAQD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,WAAW;IACX,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,UAAU;CACX,CAAC"}

package/dist/default/FacetGroupControl.d.ts

@@ -48,10 +48,20 @@ export declare function isDictionaryFacet(group: FacetGroup): boolean;
 /**
  * Which of the four shapes a group takes.
  *
- * Order matters: a hierarchical facet is nested even when it is single-choice,
- * because losing the tree costs more than losing the pills; and a dictionary
- * is a dictionary before it is a checkbox list, because the checkbox list is
- * the shape it was drawn as when nobody could pick a make.
+ * Order matters, and it changed in one place after a live measurement:
+ *
+ *  - a hierarchical facet is nested even when it is single-choice, because
+ *    losing the tree costs more than losing the pills;
+ *  - a DICTIONARY outranks the pills. The make axis on the live cars leaf
+ *    `maxSelected: 1` over a 418-value vocabulary, so "pick one" won and the
+ *    control it produced was four hundred pills in a 280px rail — a wall
+ *    with a different border radius. Above the fold the shape a person needs
+ *    is a search box, whether or not they may tick two; below it,
+ *    single-choice still means pills, because `isDictionaryFacet` requires
+ *    more than {@link FACET_DICTIONARY_THRESHOLD} counted buckets;
+ *  - and a dictionary is a dictionary before it is a checkbox list, because
+ *    the checkbox list is the shape it was drawn as when nobody could pick a
+ *    make.
  */
 export declare function facetGroupShape(group: FacetGroup): FacetGroupShape;
 /** The group's options in render order, carrying the depth the schema gives. */
@@ -75,6 +85,14 @@ export interface FacetGroupControlProps {
     /** Whether a `collapsible` group STARTS open. Default `true`. The initial
      * value only — the person owns the state after the first click. */
     readonly defaultOpen?: boolean;
+    /**
+     * How a `"dictionary"` group is drawn. `"field"` is the desktop shape — a
+     * select-style field reading its chosen values or "Any", which opens the
+     * searchable list; `"inline"` (the default) keeps the list open, the shape
+     * a phone sheet wants because the sheet is already the disclosure.
+     * Meaningless for the other three shapes.
+     */
+    readonly dictionaryMode?: "field" | "inline";
 }
 export declare function FacetGroupControl(props: FacetGroupControlProps): ReactElement;
 //# sourceMappingURL=FacetGroupControl.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FacetGroupControl.d.ts","sourceRoot":"","sources":["../../src/default/FacetGroupControl.tsx"],"names":[],"mappings":"AAiEA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAUzD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIlE;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAA8B,CAAC;AAExE,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,QAAQ,GACR,UAAU,GACV,YAAY,CAAC;AAEjB,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAwCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAS5D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CAOlE;AAWD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,eAAe,EAAE,CAkC9E;AAwRD,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;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;uEACmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CAmI7E"}
+{"version":3,"file":"FacetGroupControl.d.ts","sourceRoot":"","sources":["../../src/default/FacetGroupControl.tsx"],"names":[],"mappings":"AAiEA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAUzD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIlE;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAA8B,CAAC;AAExE,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,QAAQ,GACR,UAAU,GACV,YAAY,CAAC;AAEjB,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAwCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAS5D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe,CAOlE;AAWD,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,eAAe,EAAE,CAkC9E;AA2XD,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;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;uEACmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC9C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CA2I7E"}

package/dist/default/FacetGroupControl.js

@@ -66,7 +66,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { useState } from "react";
 import { Button, Checkbox, Flex, Input, Typography } from "antd";
 import { useT } from "@stapel/core";
-import { radii, spacing } from "@stapel/tokens";
+import { controls, cssVar, radii, spacing } from "@stapel/tokens";
 import { VOCABULARY_BACKED_TYPES, featureConfig, featureType, } from "@stapel/attributes-react";
 import { translitPrefixMatch } from "../state/translit.js";
 import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
@@ -153,19 +153,29 @@ export function isDictionaryFacet(group) {
 /**
  * Which of the four shapes a group takes.
  *
- * Order matters: a hierarchical facet is nested even when it is single-choice,
- * because losing the tree costs more than losing the pills; and a dictionary
- * is a dictionary before it is a checkbox list, because the checkbox list is
- * the shape it was drawn as when nobody could pick a make.
+ * Order matters, and it changed in one place after a live measurement:
+ *
+ *  - a hierarchical facet is nested even when it is single-choice, because
+ *    losing the tree costs more than losing the pills;
+ *  - a DICTIONARY outranks the pills. The make axis on the live cars leaf
+ *    `maxSelected: 1` over a 418-value vocabulary, so "pick one" won and the
+ *    control it produced was four hundred pills in a 280px rail — a wall
+ *    with a different border radius. Above the fold the shape a person needs
+ *    is a search box, whether or not they may tick two; below it,
+ *    single-choice still means pills, because `isDictionaryFacet` requires
+ *    more than {@link FACET_DICTIONARY_THRESHOLD} counted buckets;
+ *  - and a dictionary is a dictionary before it is a checkbox list, because
+ *    the checkbox list is the shape it was drawn as when nobody could pick a
+ *    make.
  */
 export function facetGroupShape(group) {
     const feature = group.feature;
     if (feature !== undefined && featureType(feature) === "hierarchical_select") {
         return "nested";
     }
-    if (singleChoice(feature))
-        return "segmented";
-    return isDictionaryFacet(group) ? "dictionary" : "checkbox";
+    if (isDictionaryFacet(group))
+        return "dictionary";
+    return singleChoice(feature) ? "segmented" : "checkbox";
 }
 /**
  * Is this node in the group's uncounted tail — an option with no evidence
@@ -339,6 +349,70 @@ function DictionaryBody(props) {
                     ? t(SEARCH_I18N_KEYS.facetsShowLess)
                     : t(SEARCH_I18N_KEYS.facetsShowAll, { count: matched.length }) }))] }));
 }
+/**
+ * The closed face of a dictionary group on DESKTOP: a select-shaped field
+ * that reads what is chosen, or "Any".
+ *
+ * A 418-value vocabulary rendered as a permanently-open box plus a scrolling
+ * list is right in a phone sheet, where the sheet IS the disclosure and there
+ * is one group on screen. In a 280px rail it is the whole rail: the reference
+ * classified draws the make as a field reading "Any" that opens the
+ * searchable list, and every axis under it stays reachable at a glance.
+ *
+ * A native `<button role="combobox">` rather than antd's `Select`, for the
+ * same reason the option pills are native buttons: the list underneath is
+ * this component's — it carries per-option counts, a chosen block and a fold
+ * — and a `Select` that only lends its trigger is a dependency on a popup
+ * layer for a border. `aria-expanded` on a real button is the disclosure
+ * pattern; Escape closes, and the field keeps focus so the next Tab goes
+ * where the person expects.
+ */
+const DICTIONARY_FIELD = {
+    display: "flex",
+    alignItems: "center",
+    gap: spacing[1],
+    inlineSize: "100%",
+    minBlockSize: controls.height,
+    paddingInline: spacing[2],
+    paddingBlock: spacing[1],
+    border: `1px solid ${cssVar("border")}`,
+    borderRadius: cssVar("radius-md"),
+    background: cssVar("surface"),
+    color: "inherit",
+    font: "inherit",
+    textAlign: "start",
+    cursor: "pointer",
+};
+/** The chosen values, or the word for "no constraint on this axis". Never a
+ * count: "3 chosen" makes a person open the field to find out which three. */
+const DICTIONARY_FIELD_TEXT = {
+    flex: "1 1 auto",
+    minInlineSize: 0,
+    overflow: "hidden",
+    textOverflow: "ellipsis",
+    whiteSpace: "nowrap",
+};
+function DictionaryField(props) {
+    const t = useT();
+    const { group } = props;
+    const [open, setOpen] = useState(false);
+    const chosen = group.options.filter((option) => option.selected);
+    const text = chosen.length > 0
+        ? chosen.map((option) => option.label).join(", ")
+        : t(SEARCH_I18N_KEYS.facetsDictionaryAny);
+    return (_jsxs(Flex, { vertical: true, gap: spacing[1], children: [_jsxs("button", { type: "button", role: "combobox", "aria-expanded": open, "aria-haspopup": "listbox", "aria-label": group.label, style: DICTIONARY_FIELD, "data-testid": `facet-dictionary-field-${group.slug}`, "data-chosen": chosen.length, "data-analytics": "none", "data-analytics-reason": "opening a filter group is a read, not a flow step", onKeyDown: (event) => {
+                    if (event.key === "Escape" && open) {
+                        event.preventDefault();
+                        setOpen(false);
+                    }
+                    if (event.key === "ArrowDown" && !open) {
+                        event.preventDefault();
+                        setOpen(true);
+                    }
+                }, onClick: () => {
+                    setOpen((was) => !was);
+                }, children: [_jsx("span", { style: DICTIONARY_FIELD_TEXT, children: text }), _jsx(ChevronGlyph, { open: open })] }), open && (_jsx(DictionaryBody, { group: group, onToggle: props.onToggle, visible: props.visible }))] }));
+}
 export function FacetGroupControl(props) {
     const t = useT();
     const { group } = props;
@@ -367,7 +441,9 @@ export function FacetGroupControl(props) {
     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, "data-label-source": group.labelSource, children: [props.heading !== false &&
                 (disclosure ? (_jsxs("button", { type: "button", style: DISCLOSURE_HEADER, "aria-expanded": open, "data-testid": `facet-toggle-${group.slug}`, "data-analytics": "none", "data-analytics-reason": "opening a filter group is a read, not a flow step", onClick: () => {
                         setOpenState((was) => !was);
-                    }, children: [_jsx(Typography.Text, { strong: true, children: group.label }), group.selected.length > 0 && (_jsx(Typography.Text, { type: "secondary", "data-testid": `facet-toggle-count-${group.slug}`, children: group.selected.length })), _jsx(ChevronGlyph, { open: open })] })) : (_jsx(Typography.Text, { strong: true, children: group.label }))), open && shape === "dictionary" && (_jsx(DictionaryBody, { group: group, onToggle: props.onToggle, visible: limit ?? FACET_VISIBLE_OPTIONS })), open && shape !== "dictionary" && (_jsxs(_Fragment, { children: [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)))), folded && (_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: () => {
+                    }, children: [_jsx(Typography.Text, { strong: true, children: group.label }), group.selected.length > 0 && (_jsx(Typography.Text, { type: "secondary", "data-testid": `facet-toggle-count-${group.slug}`, children: group.selected.length })), _jsx(ChevronGlyph, { open: open })] })) : (_jsx(Typography.Text, { strong: true, children: group.label }))), open &&
+                shape === "dictionary" &&
+                (props.dictionaryMode === "field" ? (_jsx(DictionaryField, { group: group, onToggle: props.onToggle, visible: limit ?? FACET_VISIBLE_OPTIONS })) : (_jsx(DictionaryBody, { group: group, onToggle: props.onToggle, visible: limit ?? FACET_VISIBLE_OPTIONS }))), open && shape !== "dictionary" && (_jsxs(_Fragment, { children: [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)))), folded && (_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)