@stapel/search-react 0.4.0 → 0.8.0

package/dist/default/RangeFilterRow.d.ts

@@ -0,0 +1,12 @@
+import type { ReactElement } from "react";
+import type { SearchRange } from "../api/types.js";
+import type { RangeGroup } from "../state/ranges.js";
+/** Floor width of one bound field, so two of them fit a 390px phone row. */
+export declare const RANGE_FIELD_MIN_WIDTH = 96;
+export interface RangeFilterRowProps {
+    readonly group: RangeGroup;
+    /** `null` clears the slug's range entirely. */
+    readonly onApply: (slug: string, range: SearchRange | null) => void;
+}
+export declare function RangeFilterRow(props: RangeFilterRowProps): ReactElement;
+//# sourceMappingURL=RangeFilterRow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RangeFilterRow.d.ts","sourceRoot":"","sources":["../../src/default/RangeFilterRow.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAM1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;CACrE;AAMD,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAyGvE"}

package/dist/default/RangeFilterRow.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * One numeric range row — "Price: from ___ to ___".
+ *
+ * The pair could encode `r.price=100..500`, round-trip it through the URL and
+ * send it, and had no control that produced one. A marketplace without a price
+ * range filter is not a marketplace (audit S-2), and this is the row that fixes
+ * it; `state/ranges.ts` decides which rows exist.
+ *
+ * ── Why it is applied by a button and not by typing ───────────────────────
+ *
+ * A facet checkbox commits on click because a click is a finished thought. A
+ * range is TWO fields, and committing each keystroke would run a search for
+ * `1`, `10`, `100` on the way to `1000` — three wrong result pages, three
+ * history entries' worth of churn, and a facet panel that reshuffles under the
+ * hand still typing. So the row holds a draft and commits on Apply (or Enter),
+ * which is also what makes "from > to" refusable instead of merely empty.
+ */
+import { useRef, useState } from "react";
+import { Button, Flex, InputNumber, Typography } from "antd";
+import { actionAvailable, actionBlocked, useT } from "@stapel/core";
+import { GatedButton } from "@stapel/tokens-antd/skin";
+import { spacing } from "@stapel/tokens";
+import { isRangeUsable } from "../state/ranges.js";
+import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
+/** Floor width of one bound field, so two of them fit a 390px phone row. */
+export const RANGE_FIELD_MIN_WIDTH = 96;
+function toDraft(value) {
+    return value ?? "";
+}
+export function RangeFilterRow(props) {
+    const t = useT();
+    const { group } = props;
+    const [from, setFrom] = useState(toDraft(group.from));
+    const [to, setTo] = useState(toDraft(group.to));
+    // The URL is still the state: when it moves on its own — Back, a shared
+    // link, "clear all" — the draft follows it rather than keeping a number the
+    // results are no longer about.
+    const applied = useRef(`${toDraft(group.from)}..${toDraft(group.to)}`);
+    const current = `${toDraft(group.from)}..${toDraft(group.to)}`;
+    if (applied.current !== current) {
+        applied.current = current;
+        if (from !== toDraft(group.from))
+            setFrom(toDraft(group.from));
+        if (to !== toDraft(group.to))
+            setTo(toDraft(group.to));
+    }
+    const draft = {
+        ...(from !== "" ? { from } : {}),
+        ...(to !== "" ? { to } : {}),
+    };
+    const usable = isRangeUsable(draft);
+    const empty = from === "" && to === "";
+    const apply = usable
+        ? actionAvailable()
+        : actionBlocked(SEARCH_I18N_KEYS.facetsRangeInvalid);
+    const commit = () => {
+        if (!usable)
+            return;
+        props.onApply(group.slug, empty ? null : draft);
+    };
+    const unit = group.unit === undefined ? "" : ` ${group.unit}`;
+    return (_jsxs(Flex, { vertical: true, gap: spacing[1], "data-testid": `facet-range-${group.slug}`, "data-active": group.active ? "true" : "false", children: [_jsx(Typography.Text, { strong: true, children: group.label }), _jsxs(Flex, { gap: spacing[2], align: "center", wrap: true, children: [_jsx(InputNumber, { value: from === "" ? null : Number(from), placeholder: t(SEARCH_I18N_KEYS.facetsRangeFrom), "aria-label": `${t(SEARCH_I18N_KEYS.facetsRangeFromAria, {
+                            feature: group.label,
+                        })}${unit}`, "data-testid": `facet-range-${group.slug}-from`, style: { minWidth: RANGE_FIELD_MIN_WIDTH }, ...(group.min !== undefined ? { min: group.min } : {}), ...(group.max !== undefined ? { max: group.max } : {}), ...(group.step !== undefined ? { step: group.step } : {}), onChange: (value) => {
+                            setFrom(value === null || value === undefined ? "" : String(value));
+                        }, onPressEnter: commit }), _jsx(InputNumber, { value: to === "" ? null : Number(to), placeholder: t(SEARCH_I18N_KEYS.facetsRangeTo), "aria-label": `${t(SEARCH_I18N_KEYS.facetsRangeToAria, {
+                            feature: group.label,
+                        })}${unit}`, "data-testid": `facet-range-${group.slug}-to`, style: { minWidth: RANGE_FIELD_MIN_WIDTH }, ...(group.min !== undefined ? { min: group.min } : {}), ...(group.max !== undefined ? { max: group.max } : {}), ...(group.step !== undefined ? { step: group.step } : {}), onChange: (value) => {
+                            setTo(value === null || value === undefined ? "" : String(value));
+                        }, onPressEnter: commit }), _jsx(GatedButton, { gate: apply, type: usable && !empty ? "primary" : "default", testId: `facet-range-${group.slug}-apply`, "data-analytics": "none", "data-analytics-reason": "a filter is a read, not a flow step", onClick: commit, children: t(SEARCH_I18N_KEYS.facetsRangeApply) }), group.active && (_jsx(Button, { "data-testid": `facet-range-${group.slug}-clear`, "data-analytics": "none", "data-analytics-reason": "a filter is a read, not a flow step", onClick: () => {
+                            props.onApply(group.slug, null);
+                        }, children: t(SEARCH_I18N_KEYS.facetsRangeClear) }))] })] }));
+}
+//# sourceMappingURL=RangeFilterRow.js.map

package/dist/default/RangeFilterRow.js.map

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

package/dist/default/RankingDisclosurePane.d.ts

@@ -13,5 +13,10 @@ export interface RankingDisclosurePaneProps extends ThemeModeProp {
     /** Doc type to disclose; omitted asks for the deployment's default. */
     readonly type?: string;
 }
+/**
+ * The widest a disclosure column may grow. A statutory text is a READING
+ * surface: past this it stops being a paragraph and becomes a banner.
+ */
+export declare const RANKING_MAX_WIDTH = 720;
 export declare function RankingDisclosurePane(props: RankingDisclosurePaneProps): ReactElement;
 //# sourceMappingURL=RankingDisclosurePane.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RankingDisclosurePane.d.ts","sourceRoot":"","sources":["../../src/default/RankingDisclosurePane.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAQ1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,0BAA2B,SAAQ,aAAa;IAC/D,uEAAuE;IACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,YAAY,CAyFd"}
+{"version":3,"file":"RankingDisclosurePane.d.ts","sourceRoot":"","sources":["../../src/default/RankingDisclosurePane.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAc1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,0BAA2B,SAAQ,aAAa;IAC/D,uEAAuE;IACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,YAAY,CA6Gd"}

package/dist/default/RankingDisclosurePane.js

@@ -1,23 +1,23 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Empty, Flex, List, Spin, Tag, Typography } from "antd";
-import { matchList, toFlowError, useDescribeFlowError, useT } from "@stapel/core";
+import { Flex, List, Tag, Typography } from "antd";
+import { useFormat, useT } from "@stapel/core";
+import { EmptyState, ErrorAlert, LoadList, SkinTheme, } from "@stapel/tokens-antd/skin";
+import { fontSize, spacing } from "@stapel/tokens";
 import { RankingDisclosure } from "../headless/RankingDisclosure.js";
 import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
-import { ErrorAlert } from "./ErrorAlert.js";
-import { SearchSkinTheme } from "./theme.js";
+import { sortLabel } from "./sortLabels.js";
+/**
+ * The widest a disclosure column may grow. A statutory text is a READING
+ * surface: past this it stops being a paragraph and becomes a banner.
+ */
+export const RANKING_MAX_WIDTH = 720;
 export function RankingDisclosurePane(props) {
     const t = useT();
-    const describe = useDescribeFlowError();
-    return (_jsx(SearchSkinTheme, { ...(props.mode !== undefined ? { mode: props.mode } : {}), children: _jsx(RankingDisclosure, { ...(props.type !== undefined ? { type: props.type } : {}), children: (bag) => (_jsxs(Flex, { vertical: true, gap: 12, "data-testid": "search-ranking", children: [_jsx(Typography.Title, { level: 4, style: { margin: 0 }, children: t(SEARCH_I18N_KEYS.rankingTitle) }), _jsx(Typography.Paragraph, { type: "secondary", style: { margin: 0 }, children: t(SEARCH_I18N_KEYS.rankingIntro) }), matchList(bag.state, {
-                        loading: () => (_jsx(Flex, { justify: "center", style: { padding: 16 }, children: _jsx(Spin, { "data-testid": "ranking-loading" }) })),
-                        failed: (error) => (_jsx(ErrorAlert, { testId: "ranking-failed", error: {
-                                ...describe(toFlowError(error)),
-                                message: t(SEARCH_I18N_KEYS.rankingLoadFailed),
-                            } })),
-                        empty: () => (_jsx(Empty, { "data-testid": "ranking-empty", description: t(SEARCH_I18N_KEYS.rankingEmpty) })),
-                        ready: (scorers) => (_jsx(List, { "data-testid": "ranking-list", dataSource: [...scorers], renderItem: (scorer) => (_jsx(List.Item, { "data-scorer": scorer.slug, children: _jsxs(Flex, { vertical: true, gap: 2, style: { width: "100%" }, children: [_jsxs(Flex, { justify: "space-between", align: "center", gap: 8, children: [_jsx(Typography.Text, { strong: true, children: t(scorer.description_key) }), _jsx(Tag, { children: scorer.weight })] }), _jsx(Typography.Text, { type: "secondary", children: scorer.description }), _jsxs(Typography.Text, { type: "secondary", style: { fontSize: 12 }, children: [t(SEARCH_I18N_KEYS.rankingAppliesTo), ": ", scorer.applies_to_sorts.join(", ")] }), !scorer.active && (_jsx(Typography.Text, { type: "warning", "data-testid": "ranking-inactive", children: t(SEARCH_I18N_KEYS.rankingInactive, {
+    const format = useFormat();
+    return (_jsx(SkinTheme, { surface: "base", ...(props.mode !== undefined ? { mode: props.mode } : {}), style: { width: "100%", maxWidth: RANKING_MAX_WIDTH }, children: _jsx(RankingDisclosure, { ...(props.type !== undefined ? { type: props.type } : {}), children: (bag) => (_jsxs(Flex, { vertical: true, gap: spacing[3], "data-testid": "search-ranking", children: [_jsx(Typography.Title, { level: 4, style: { margin: 0 }, children: t(SEARCH_I18N_KEYS.rankingTitle) }), _jsx(Typography.Paragraph, { type: "secondary", style: { margin: 0 }, children: t(SEARCH_I18N_KEYS.rankingIntro) }), _jsx(LoadList, { state: bag.state, testId: "ranking", skeletonRows: 4, onRetry: bag.refetch, empty: _jsx(EmptyState, { compact: true, title: t(SEARCH_I18N_KEYS.rankingEmpty), testId: "ranking-empty" }), failed: (error) => (_jsx(ErrorAlert, { testId: "ranking-failed", thrown: error, message: t(SEARCH_I18N_KEYS.rankingLoadFailed), onRetry: bag.refetch })), children: (scorers) => (_jsx(List, { "data-testid": "ranking-list", dataSource: [...scorers], renderItem: (scorer) => (_jsx(List.Item, { "data-scorer": scorer.slug, children: _jsxs(Flex, { vertical: true, gap: spacing[1], style: { width: "100%" }, children: [_jsxs(Flex, { justify: "space-between", align: "center", gap: spacing[2], children: [_jsx(Typography.Text, { strong: true, children: t(scorer.description_key) }), _jsxs(Tag, { children: [t(SEARCH_I18N_KEYS.rankingWeight), " ", format.number(scorer.weight) ?? scorer.weight] })] }), _jsx(Typography.Text, { type: "secondary", children: scorer.description }), _jsxs(Typography.Text, { type: "secondary", style: { fontSize: fontSize.xs.fontSize }, children: [t(SEARCH_I18N_KEYS.rankingAppliesTo), ": ", scorer.applies_to_sorts
+                                                    .map((sort) => sortLabel(t, sort))
+                                                    .join(", ")] }), !scorer.active && (_jsx(Typography.Text, { type: "warning", "data-testid": "ranking-inactive", children: t(SEARCH_I18N_KEYS.rankingInactive, {
                                                 reason: scorer.inactive_reason,
-                                            }) }))] }) }, scorer.slug)) })),
-                    }), bag.notes.length > 0 && (_jsxs(Flex, { vertical: true, gap: 2, children: [_jsx(Typography.Text, { strong: true, children: t(SEARCH_I18N_KEYS.rankingNotes) }), bag.notes.map((note) => (_jsx(Typography.Text, { type: "secondary", children: note }, note)))] }))] })) }) }));
+                                            }) }))] }) }, scorer.slug)) })) }), bag.notes.length > 0 && (_jsxs(Flex, { vertical: true, gap: spacing[1], children: [_jsx(Typography.Text, { strong: true, children: t(SEARCH_I18N_KEYS.rankingNotes) }), bag.notes.map((note) => (_jsx(Typography.Text, { type: "secondary", children: note }, note)))] }))] })) }) }));
 }
 //# sourceMappingURL=RankingDisclosurePane.js.map

package/dist/default/RankingDisclosurePane.js.map

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

package/dist/default/SearchBox.d.ts

@@ -0,0 +1,13 @@
+import type { ReactElement } from "react";
+import type { UseSearchBoxOptions } from "../headless/useSearchBox.js";
+import type { ThemeModeProp } from "./types.js";
+export interface SearchBoxProps extends ThemeModeProp, UseSearchBoxOptions {
+    /** Override the placeholder — a category page says what it searches. */
+    readonly placeholder?: string;
+    /** Render the submit button beside the field. Default `true`: on a phone
+     * keyboard "search" is not always offered, and a visible button is. */
+    readonly submitButton?: boolean;
+    readonly autoFocus?: boolean;
+}
+export declare function SearchBox(props: SearchBoxProps): ReactElement;
+//# sourceMappingURL=SearchBox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SearchBox.d.ts","sourceRoot":"","sources":["../../src/default/SearchBox.tsx"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAM1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,cAAe,SAAQ,aAAa,EAAE,mBAAmB;IACxE,wEAAwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;2EACuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CAgF7D"}

package/dist/default/SearchBox.js

@@ -0,0 +1,67 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `<SearchBox>` — the control this pair shipped a search page without.
+ *
+ * `setText` existed from the first release and had ZERO callers in the whole
+ * repository: the URL codec could carry `q`, the state machine could set it,
+ * the request sent it — and nothing on any screen could type one. A results
+ * page reachable only by editing the address bar is not a search feature, so
+ * this is the blocker of the pair's audit (S-1) and the reason the page is now
+ * a screen rather than a viewer.
+ *
+ * ── What it does, and what it refuses to do ───────────────────────────────
+ *
+ *  - **Types into a draft, searches after a pause.** `useSearchBox` owns the
+ *    debounce and the URL round-trip; this file is the antd shape of it.
+ *  - **Suggests from the INDEX.** `GET /suggest` returns title prefixes out of
+ *    the catalogue — never a query log, because stapel-search keeps none — so
+ *    every suggestion is a search that has results. The endpoint was typed and
+ *    unreachable for three releases (S-8).
+ *  - **Never grows a "no results" dropdown.** With nothing to suggest the menu
+ *    stays shut: an empty popover under a half-typed word says "there is
+ *    nothing" about a search that has not run.
+ *  - **Caps the input at the server's own limit** (200 chars), so
+ *    `error.400.search_query_too_long` is a refusal this control cannot cause.
+ *
+ * Exported from `/default` so a container can mount it in the header —
+ * `nav/manifest.ts` calls `/s` "a navigation TARGET reached from the header's
+ * search box", and this is that box. It needs the same `<SearchStateProvider>`
+ * as everything else; a header outside one renders `<SearchPage>`'s copy.
+ */
+import { useState } from "react";
+import { AutoComplete, Button, Flex, Input } from "antd";
+import { useT } from "@stapel/core";
+import { SkinTheme } from "@stapel/tokens-antd/skin";
+import { spacing } from "@stapel/tokens";
+import { useSearchBox } from "../headless/useSearchBox.js";
+import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
+export function SearchBox(props) {
+    const t = useT();
+    const { mode, placeholder, submitButton, autoFocus, ...boxOptions } = props;
+    const box = useSearchBox(boxOptions);
+    const [open, setOpen] = useState(false);
+    const options = box.suggestions.map((value) => ({ value }));
+    return (_jsx(SkinTheme, { surface: "bare", ...(mode !== undefined ? { mode } : {}), "data-testid": "search-box", children: _jsxs(Flex, { gap: spacing[2], align: "center", wrap: false, children: [_jsx(AutoComplete, { value: box.draft, options: options, 
+                    // Shut whenever there is nothing to say — see the header. The
+                    // open state is the skin's, not antd's: the prop that reports the
+                    // menu opening was renamed between antd 5 and 6 and this package
+                    // supports both, so nothing here asks antd when to open.
+                    open: open && options.length > 0, style: { flex: 1, minWidth: 0 }, onSelect: (value) => {
+                        setOpen(false);
+                        box.submit(value);
+                    }, onChange: (value) => {
+                        setOpen(true);
+                        box.setDraft(value);
+                    }, children: _jsx(Input, { allowClear: {
+                            clearIcon: (_jsx("span", { "aria-label": t(SEARCH_I18N_KEYS.boxClear), role: "img", children: "×" })),
+                        }, autoFocus: autoFocus === true, maxLength: box.maxLength, "aria-label": t(SEARCH_I18N_KEYS.boxLabel), placeholder: placeholder ?? t(SEARCH_I18N_KEYS.boxPlaceholder), "data-testid": "search-box-input", "data-analytics": "none", "data-analytics-reason": "typing a query is a read, not a flow step", onPressEnter: () => {
+                            setOpen(false);
+                            box.submit();
+                        }, onBlur: () => {
+                            setOpen(false);
+                        } }) }), submitButton !== false && (_jsx(Button, { type: "primary", "data-testid": "search-box-submit", "data-analytics": "none", "data-analytics-reason": "running a search is a read, not a flow step", onClick: () => {
+                        setOpen(false);
+                        box.submit();
+                    }, children: t(SEARCH_I18N_KEYS.boxSubmit) }))] }) }));
+}
+//# sourceMappingURL=SearchBox.js.map

package/dist/default/SearchBox.js.map

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

package/dist/default/SearchPage.d.ts

@@ -1,26 +1,26 @@
-/**
- * `<SearchPage>` — the composed screen the nav manifest points at: filters on
- * the left, sort and results on the right, the ranking link in the footer.
- *
- * It composes the two 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 three seams a storefront fills (spec §6.2 items 1–3): `renderCard`
- * (a `<ListingCard>`), `categoryFeatures` (from categories-react, for facet
- * labels), and `footer` (the container's own chrome). None of them is
- * optional behaviour in disguise — every one has a working default.
- */
 import type { ReactElement, ReactNode } from "react";
 import type { FeatureDef } from "@stapel/attributes-react";
 import type { SearchParamsAdapter } from "../headless/SearchStateProvider.js";
 import type { ParseSearchStateOptions } from "../state/urlState.js";
+import type { CategoryFilterSlotProps, GeoFilterSlotProps } from "./FacetPanelPane.js";
+import type { SearchView } from "./ViewSwitch.js";
 import type { DegradationNoticeVariant } from "./DegradationNotice.js";
 import type { SearchCardRenderer } from "./SearchResultCard.js";
 import type { ThemeModeProp } from "./types.js";
+/** Where the filters live: beside the results, or behind a button in a sheet. */
+export type SearchFiltersLayout = "column" | "sheet";
+/**
+ * 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 declare const FILTERS_RAIL_WIDTH = 280;
 export interface SearchPageProps extends ThemeModeProp, ParseSearchStateOptions {
     /** The URL binding. `useRouterSearchParams()` from `./router` is the
      * react-router one. */
@@ -28,11 +28,89 @@ export interface SearchPageProps extends ThemeModeProp, ParseSearchStateOptions
     readonly renderCard?: SearchCardRenderer;
     readonly categoryFeatures?: readonly FeatureDef[];
     readonly locale?: string;
+    /** Render the query box at the top. `false` for a container whose HEADER
+     * already mounts `<SearchBox>` — one box per screen, not two. */
+    readonly searchBox?: boolean;
+    /** BCP-47 tags this deployment indexes, for the language filter. */
+    readonly languages?: readonly string[];
+    /** The catalogue picker slot — see {@link FacetPanelPaneProps}. */
+    readonly renderCategoryFilter?: (slot: CategoryFilterSlotProps) => ReactNode;
+    /** The location control slot (`geo-react`). */
+    readonly renderGeoFilter?: (slot: GeoFilterSlotProps) => ReactNode;
     /** Container chrome under the results — e.g. the ranking-disclosure link. */
     readonly footer?: ReactNode;
+    /**
+     * Rendered at the TOP of the filter column, above everything else.
+     *
+     * The slot exists for a filter this pair cannot ship and has no named seam
+     * for. Whatever a host renders here reads and writes the same URL state as
+     * the facets beside it (`useSearchState()`), so it is a filter in every
+     * sense that matters and not a decoration bolted on top.
+     */
+    readonly filtersHeader?: ReactNode;
+    /** What this surface calls its result list. See
+     * {@link SearchResultsPaneProps.heading}. */
+    readonly resultsHeading?: ReactNode;
     /** How the results surface says what the engine could not do (default
      * `"banner"`). Handed straight to `<SearchResultsPane>`. */
     readonly degradationNotice?: DegradationNoticeVariant;
+    /**
+     * Force the filter surface instead of reading the viewport. For tests and
+     * for a host that renders the page inside a phone-width container that is
+     * not the viewport — not an escape hatch for "I prefer a column on phones".
+     */
+    readonly filtersLayout?: SearchFiltersLayout;
+    /**
+     * Open the phone filter sheet on mount.
+     *
+     * For a container that deep-links INTO the filters ("Refine this search"
+     * from a category page), and for the story that photographs the sheet —
+     * a state reached only by a tap is a state nothing outside a browser has
+     * ever seen. The person still closes it; this is the initial value, not a
+     * controlled one.
+     */
+    readonly defaultFiltersOpen?: boolean;
+    /** Offer a page-size control beside the sort. Default `true`. */
+    readonly pageSize?: boolean;
+    /**
+     * The trail above the heading — "Home / Cars / Sedans".
+     *
+     * A SLOT, because a breadcrumb is a walk up the CATEGORY tree and the tree
+     * belongs to `categories-react`; a search package knows the `category`
+     * parameter's value and nothing about its ancestors. Rendered above the
+     * results heading, inside the results column, so it sits over the list it
+     * describes rather than over the whole two-column page.
+     */
+    readonly breadcrumb?: ReactNode;
+    /**
+     * The arrangements the view switch offers. Default: the pair's own list and
+     * grid. A deployment adds its own — `{ id: "map", labelKey, icon, render }`
+     * — and the switch treats it like the two that ship; see {@link SearchView}.
+     *
+     * A single view draws no switch at all.
+     */
+    readonly views?: readonly SearchView[];
+    /** Which arrangement the page opens in. Default: the first of `views`. */
+    readonly defaultView?: string;
+    /** Told when the arrangement changes, for a host that remembers it. The
+     * view is NOT url state — see `<ViewSwitch>` for why. */
+    readonly onViewChange?: (id: string) => void;
+    /**
+     * The action at the trailing end of the results toolbar — conventionally
+     * "notify me about new ones".
+     *
+     * A SLOT, and it cannot be anything else: saving a search and mailing its
+     * new hits is a subscription with an owner, a schedule and a consent record,
+     * none of which this pair has. What the pair CAN state is where such a
+     * control belongs and that the page keeps room for it.
+     */
+    readonly resultsAction?: ReactNode;
+    /**
+     * Heading level for the results caption. Default `1` — on a results SCREEN
+     * the list's name is the page's heading. A container that already prints its
+     * own `<h1>` above this page passes a lower level.
+     */
+    readonly resultsHeadingLevel?: 1 | 2 | 3 | 4 | 5;
 }
 export declare function SearchPage(props: SearchPageProps): ReactElement;
 //# sourceMappingURL=SearchPage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SearchPage.d.ts","sourceRoot":"","sources":["../../src/default/SearchPage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAIpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,eAAgB,SAAQ,aAAa,EAAE,uBAAuB;IAC7E;2BACuB;IACvB,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B;gEAC4D;IAC5D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;CACvD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CA4C/D"}
+{"version":3,"file":"SearchPage.d.ts","sourceRoot":"","sources":["../../src/default/SearchPage.tsx"],"names":[],"mappings":"AAkDA,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAIpE,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAO7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,iFAAiF;AACjF,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAiCtC,MAAM,WAAW,eAAgB,SAAQ,aAAa,EAAE,uBAAuB;IAC7E;2BACuB;IACvB,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;qEACiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,mEAAmE;IACnE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,SAAS,CAAC;IAC7E,+CAA+C;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,SAAS,CAAC;IACnE,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IACnC;iDAC6C;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC;IACpC;gEAC4D;IAC5D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IACtD;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAC7C;;;;;;;;OAQG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;6DACyD;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAClD;AAmOD,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CAuD/D"}