@stapel/search-react 0.1.0

package/dist/default/SearchResultsPane.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Empty, Flex, Spin, Typography } from "antd";
+import { errorCode, matchList, toFlowError, useDescribeFlowError, useT, } from "@stapel/core";
+import { SearchResults } from "../headless/SearchResults.js";
+import { SEARCH_WINDOW_EXCEEDED } from "../i18n/errorsMap.js";
+import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
+import { DegradationNotice } from "./DegradationNotice.js";
+import { ErrorAlert } from "./ErrorAlert.js";
+import { SearchResultCard } from "./SearchResultCard.js";
+import { SearchSkinTheme } from "./theme.js";
+function Count(props) {
+    const t = useT();
+    const page = props.bag.page;
+    if (page === null)
+        return null;
+    return (_jsx(Typography.Text, { type: "secondary", "data-testid": "search-count", children: page.countIsEstimate
+            ? t(SEARCH_I18N_KEYS.resultsCountApproximate, { count: page.count })
+            : t(SEARCH_I18N_KEYS.resultsCountExact, { count: page.count }) }));
+}
+function Pager(props) {
+    const t = useT();
+    const { prev, next, goPrev, goNext } = props.bag;
+    return (_jsxs(Flex, { gap: 8, justify: "center", "data-testid": "search-pager", children: [_jsx(Button, { disabled: !prev.available, title: prev.available ? undefined : t(prev.block.code, prev.block.params), onClick: goPrev, "data-analytics": "none", "data-analytics-reason": "keyset paging is a read, not a flow step", "data-testid": "search-prev", children: t(SEARCH_I18N_KEYS.resultsPrev) }), _jsx(Button, { disabled: !next.available, title: next.available ? undefined : t(next.block.code, next.block.params), onClick: goNext, "data-analytics": "none", "data-analytics-reason": "keyset paging is a read, not a flow step", "data-testid": "search-next", children: t(SEARCH_I18N_KEYS.resultsNext) })] }));
+}
+export function SearchResultsPane(props) {
+    const t = useT();
+    const describe = useDescribeFlowError();
+    const renderCard = props.renderCard;
+    return (_jsx(SearchSkinTheme, { ...(props.mode !== undefined ? { mode: props.mode } : {}), children: _jsx(SearchResults, { ...(props.enabled !== undefined ? { enabled: props.enabled } : {}), children: (bag) => (_jsxs(Flex, { vertical: true, gap: 16, children: [_jsxs(Flex, { justify: "space-between", align: "center", wrap: true, gap: 8, children: [_jsx(Typography.Title, { level: 4, style: { margin: 0 }, children: t(SEARCH_I18N_KEYS.resultsTitle) }), _jsx(Count, { bag: bag })] }), _jsx(DegradationNotice, { degradations: bag.degradations }), matchList(bag.state, {
+                        loading: () => (_jsx(Flex, { justify: "center", style: { padding: 24 }, children: _jsx(Spin, { "data-testid": "search-loading" }) })),
+                        failed: (error) => {
+                            // The window refusal is a DIFFERENT sentence from a failed
+                            // search, and both are different from "nothing found".
+                            const isWindow = errorCode(error) === SEARCH_WINDOW_EXCEEDED;
+                            return (_jsx(ErrorAlert, { testId: isWindow ? "search-window-exceeded" : "search-failed", error: {
+                                    ...describe(toFlowError(error)),
+                                    message: t(isWindow
+                                        ? SEARCH_I18N_KEYS.resultsWindowExceeded
+                                        : SEARCH_I18N_KEYS.resultsLoadFailed),
+                                }, action: _jsx(Button, { size: "small", onClick: bag.refetch, "data-analytics": "none", "data-analytics-reason": "retry of a failed read; no flow to step", children: t(SEARCH_I18N_KEYS.resultsRetry) }) }));
+                        },
+                        empty: () => (_jsx(Empty, { "data-testid": "search-empty", description: t(SEARCH_I18N_KEYS.resultsEmpty) })),
+                        ready: (items) => (_jsx(Flex, { vertical: true, gap: 12, "data-testid": "search-results", children: items.map((item) => (_jsx("div", { children: renderCard !== undefined ? (renderCard(item)) : (_jsx(SearchResultCard, { item: item })) }, item.key))) })),
+                    }), _jsx(Pager, { bag: bag }), props.footer] })) }) }));
+}
+//# sourceMappingURL=SearchResultsPane.js.map

package/dist/default/SearchResultsPane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchResultsPane.js","sourceRoot":"","sources":["../../src/default/SearchResultsPane.tsx"],"names":[],"mappings":";AAgBA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC7D,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,IAAI,GACL,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAgB7C,SAAS,KAAK,CAAC,KAAgC;IAC7C,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IAC5B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,CACL,KAAC,UAAU,CAAC,IAAI,IAAC,IAAI,EAAC,WAAW,iBAAa,cAAc,YACzD,IAAI,CAAC,eAAe;YACnB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YACpE,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,GAChD,CACnB,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,KAAgC;IAC7C,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC;IACjD,OAAO,CACL,MAAC,IAAI,IAAC,GAAG,EAAE,CAAC,EAAE,OAAO,EAAC,QAAQ,iBAAa,cAAc,aACvD,KAAC,MAAM,IACL,QAAQ,EAAE,CAAC,IAAI,CAAC,SAAS,EACzB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzE,OAAO,EAAE,MAAM,oBACA,MAAM,2BACC,0CAA0C,iBACpD,aAAa,YAExB,CAAC,CAAC,gBAAgB,CAAC,WAAW,CAAC,GACzB,EACT,KAAC,MAAM,IACL,QAAQ,EAAE,CAAC,IAAI,CAAC,SAAS,EACzB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EACzE,OAAO,EAAE,MAAM,oBACA,MAAM,2BACC,0CAA0C,iBACpD,aAAa,YAExB,CAAC,CAAC,gBAAgB,CAAC,WAAW,CAAC,GACzB,IACJ,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAEpC,OAAO,CACL,KAAC,eAAe,OAAK,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YACzE,KAAC,aAAa,OAAK,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAC/E,CAAC,GAAG,EAAE,EAAE,CAAC,CACR,MAAC,IAAI,IAAC,QAAQ,QAAC,GAAG,EAAE,EAAE,aACpB,MAAC,IAAI,IAAC,OAAO,EAAC,eAAe,EAAC,KAAK,EAAC,QAAQ,EAAC,IAAI,QAAC,GAAG,EAAE,CAAC,aACtD,KAAC,UAAU,CAAC,KAAK,IAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,YAC7C,CAAC,CAAC,gBAAgB,CAAC,YAAY,CAAC,GAChB,EACnB,KAAC,KAAK,IAAC,GAAG,EAAE,GAAG,GAAI,IACd,EAEP,KAAC,iBAAiB,IAAC,YAAY,EAAE,GAAG,CAAC,YAAY,GAAI,EAEpD,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE;wBACpB,OAAO,EAAE,GAAG,EAAE,CAAC,CACb,KAAC,IAAI,IAAC,OAAO,EAAC,QAAQ,EAAC,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,YAC3C,KAAC,IAAI,mBAAa,gBAAgB,GAAG,GAChC,CACR;wBACD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;4BAChB,2DAA2D;4BAC3D,uDAAuD;4BACvD,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,sBAAsB,CAAC;4BAC7D,OAAO,CACL,KAAC,UAAU,IACT,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,eAAe,EAC7D,KAAK,EAAE;oCACL,GAAG,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;oCAC/B,OAAO,EAAE,CAAC,CACR,QAAQ;wCACN,CAAC,CAAC,gBAAgB,CAAC,qBAAqB;wCACxC,CAAC,CAAC,gBAAgB,CAAC,iBAAiB,CACvC;iCACF,EACD,MAAM,EACJ,KAAC,MAAM,IACL,IAAI,EAAC,OAAO,EACZ,OAAO,EAAE,GAAG,CAAC,OAAO,oBACL,MAAM,2BACC,yCAAyC,YAE9D,CAAC,CAAC,gBAAgB,CAAC,YAAY,CAAC,GAC1B,GAEX,CACH,CAAC;wBACJ,CAAC;wBACD,KAAK,EAAE,GAAG,EAAE,CAAC,CACX,KAAC,KAAK,mBACQ,cAAc,EAC1B,WAAW,EAAE,CAAC,CAAC,gBAAgB,CAAC,YAAY,CAAC,GAC7C,CACH;wBACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAChB,KAAC,IAAI,IAAC,QAAQ,QAAC,GAAG,EAAE,EAAE,iBAAc,gBAAgB,YACjD,KAAK,CAAC,GAAG,CAAC,CAAC,IAAgB,EAAE,EAAE,CAAC,CAC/B,wBACG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAC1B,UAAU,CAAC,IAAI,CAAC,CACjB,CAAC,CAAC,CAAC,CACF,KAAC,gBAAgB,IAAC,IAAI,EAAE,IAAI,GAAI,CACjC,IALO,IAAI,CAAC,GAAG,CAMZ,CACP,CAAC,GACG,CACR;qBACF,CAAC,EAEF,KAAC,KAAK,IAAC,GAAG,EAAE,GAAG,GAAI,EAClB,KAAK,CAAC,MAAM,IACR,CACR,GACa,GACA,CACnB,CAAC;AACJ,CAAC"}

package/dist/default/SortSelect.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The sort control.
+ *
+ * The options are the shipped `SORTS` list, NOT an enum from the schema —
+ * `docs/schema.json` declares none, and a deployment may register more. So a
+ * value the URL already carries that is not in the list is still offered as a
+ * (raw) option rather than silently reset: resetting it would rewrite a
+ * shared link's meaning on load, and the server is the one entitled to refuse
+ * an unknown sort (`error.400.search_unknown_sort`, which names it).
+ *
+ * `sort=distance` needs a centre — the server answers
+ * `error.400.search_sort_needs_center` without one. The option is therefore
+ * DISABLED with the reason named when no geo centre is set, rather than
+ * offered and then refused.
+ */
+import type { ReactElement } from "react";
+export interface SortSelectProps {
+    /** The sort the SERVER applied, shown when the URL names none. */
+    readonly appliedSort?: string | undefined;
+}
+export declare function SortSelect(props: SortSelectProps): ReactElement;
+//# sourceMappingURL=SortSelect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SortSelect.d.ts","sourceRoot":"","sources":["../../src/default/SortSelect.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAe1C,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CAyC/D"}

package/dist/default/SortSelect.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Flex, Select, Typography } from "antd";
+import { useT } from "@stapel/core";
+import { SEARCH_SORTS } from "../api/types.js";
+import { useSearchState } from "../headless/SearchStateProvider.js";
+import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
+const SORT_LABEL_KEY = {
+    relevance: SEARCH_I18N_KEYS.sortRelevance,
+    newest: SEARCH_I18N_KEYS.sortNewest,
+    price_asc: SEARCH_I18N_KEYS.sortPriceAsc,
+    price_desc: SEARCH_I18N_KEYS.sortPriceDesc,
+    distance: SEARCH_I18N_KEYS.sortDistance,
+};
+export function SortSelect(props) {
+    const t = useT();
+    const { state, setSort } = useSearchState();
+    const hasCentre = state.geo !== undefined;
+    const known = new Set(SEARCH_SORTS);
+    const values = state.sort !== undefined && !known.has(state.sort)
+        ? [...SEARCH_SORTS, state.sort]
+        : SEARCH_SORTS;
+    return (_jsxs(Flex, { gap: 8, align: "center", children: [_jsx(Typography.Text, { type: "secondary", children: t(SEARCH_I18N_KEYS.sortLabel) }), _jsx(Select, { "data-testid": "search-sort", style: { minWidth: 180 }, value: state.sort ?? props.appliedSort ?? null, placeholder: t(SEARCH_I18N_KEYS.sortLabel), onChange: (next) => {
+                    setSort(next);
+                }, options: values.map((value) => {
+                    const key = SORT_LABEL_KEY[value];
+                    const needsCentre = value === "distance" && !hasCentre;
+                    return {
+                        value,
+                        label: key !== undefined ? t(key) : value,
+                        disabled: needsCentre,
+                        // A disabled control states its reason (the ActionAvailability
+                        // canon), even inside a select.
+                        ...(needsCentre
+                            ? { title: t("error.400.search_sort_needs_center") }
+                            : {}),
+                    };
+                }) })] }));
+}
+//# sourceMappingURL=SortSelect.js.map

package/dist/default/SortSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SortSelect.js","sourceRoot":"","sources":["../../src/default/SortSelect.tsx"],"names":[],"mappings":";AAgBA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,cAAc,GAAqC;IACvD,SAAS,EAAE,gBAAgB,CAAC,aAAa;IACzC,MAAM,EAAE,gBAAgB,CAAC,UAAU;IACnC,SAAS,EAAE,gBAAgB,CAAC,YAAY;IACxC,UAAU,EAAE,gBAAgB,CAAC,aAAa;IAC1C,QAAQ,EAAE,gBAAgB,CAAC,YAAY;CACxC,CAAC;AAOF,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAE5C,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IACpC,MAAM,MAAM,GACV,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;QAChD,CAAC,CAAC,CAAC,GAAG,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC;QAC/B,CAAC,CAAC,YAAY,CAAC;IAEnB,OAAO,CACL,MAAC,IAAI,IAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAC,QAAQ,aAC1B,KAAC,UAAU,CAAC,IAAI,IAAC,IAAI,EAAC,WAAW,YAC9B,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC,GACd,EAClB,KAAC,MAAM,mBACO,aAAa,EACzB,KAAK,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EACxB,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,WAAW,IAAI,IAAI,EAC9C,WAAW,EAAE,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAC1C,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;oBACjB,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC,EACD,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;oBAC5B,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;oBAClC,MAAM,WAAW,GAAG,KAAK,KAAK,UAAU,IAAI,CAAC,SAAS,CAAC;oBACvD,OAAO;wBACL,KAAK;wBACL,KAAK,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK;wBACzC,QAAQ,EAAE,WAAW;wBACrB,+DAA+D;wBAC/D,gCAAgC;wBAChC,GAAG,CAAC,WAAW;4BACb,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,oCAAoC,CAAC,EAAE;4BACpD,CAAC,CAAC,EAAE,CAAC;qBACR,CAAC;gBACJ,CAAC,CAAC,GACF,IACG,CACR,CAAC;AACJ,CAAC"}

package/dist/default/UrlIssueNotice.d.ts

@@ -0,0 +1,12 @@
+/**
+ * "Part of this link could not be read."
+ *
+ * A shared search is a link somebody typed, edited, or truncated in a chat
+ * app. When the codec cannot read a parameter it reports the fact rather than
+ * dropping it silently — because the silent version WIDENS the search (a
+ * broken `lat` removes the location filter) and the person is then looking at
+ * something other than what was shared, with nothing on screen to say so.
+ */
+import type { ReactElement } from "react";
+export declare function UrlIssueNotice(): ReactElement | null;
+//# sourceMappingURL=UrlIssueNotice.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UrlIssueNotice.d.ts","sourceRoot":"","sources":["../../src/default/UrlIssueNotice.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAM1C,wBAAgB,cAAc,IAAI,YAAY,GAAG,IAAI,CAqBpD"}

package/dist/default/UrlIssueNotice.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Alert } from "antd";
+import { useT } from "@stapel/core";
+import { useSearchState } from "../headless/SearchStateProvider.js";
+import { SEARCH_I18N_KEYS } from "../i18n/keys.js";
+export function UrlIssueNotice() {
+    const t = useT();
+    const { issues } = useSearchState();
+    if (issues.length === 0)
+        return null;
+    return (_jsx(Alert, { type: "warning", showIcon: true, "data-testid": "search-url-issues", message: t(SEARCH_I18N_KEYS.urlIssuesTitle), description: _jsx("ul", { style: { margin: 0, paddingInlineStart: 20 }, children: issues.map((issue) => (_jsx("li", { children: t(issue.messageKey, { param: issue.param }) }, `${issue.param}:${issue.code}`))) }) }));
+}
+//# sourceMappingURL=UrlIssueNotice.js.map

package/dist/default/UrlIssueNotice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrlIssueNotice.js","sourceRoot":"","sources":["../../src/default/UrlIssueNotice.tsx"],"names":[],"mappings":";AAUA,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,UAAU,cAAc;IAC5B,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IACpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,CACL,KAAC,KAAK,IACJ,IAAI,EAAC,SAAS,EACd,QAAQ,uBACI,mBAAmB,EAC/B,OAAO,EAAE,CAAC,CAAC,gBAAgB,CAAC,cAAc,CAAC,EAC3C,WAAW,EACT,aAAI,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,kBAAkB,EAAE,EAAE,EAAE,YAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACrB,uBACG,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,IADrC,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAElC,CACN,CAAC,GACC,GAEP,CACH,CAAC;AACJ,CAAC"}

package/dist/default/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `@stapel/search-react/default` — the antd default skin.
+ *
+ * A SEPARATE entry point on purpose: the main entry is headless and carries
+ * no antd, so a storefront that renders its own cards over `<SearchResults>`
+ * never pays for this bundle (enforced by size-limit and the bundle-purity
+ * test).
+ *
+ * Three override levers, none of which requires forking anything:
+ *
+ *  1. **`renderCard`** — the card slot. A storefront passes
+ *     `<ListingCard>` from `@stapel/listings-react/default`; the generic card
+ *     here is the documented default, not the intended end state (spec §3.7).
+ *  2. **`categoryFeatures`** — the facet-label slot. The server sends
+ *     `{value: count}` and no labels; the schema that names them lives in
+ *     categories, and the container hands it in (spec §6.2 item 2).
+ *  3. **retheming through the §68 token JSON** — every surface wraps itself
+ *     in `<SearchSkinTheme>`, so a host's regenerated `--stapel-*` custom
+ *     properties reach this skin with zero code.
+ */
+export { SearchPage } from "./SearchPage.js";
+export type { SearchPageProps } from "./SearchPage.js";
+export { SearchResultsPane } from "./SearchResultsPane.js";
+export type { SearchResultsPaneProps } from "./SearchResultsPane.js";
+export { FacetPanelPane } from "./FacetPanelPane.js";
+export type { FacetPanelPaneProps } from "./FacetPanelPane.js";
+export { RankingDisclosurePane } from "./RankingDisclosurePane.js";
+export type { RankingDisclosurePaneProps } from "./RankingDisclosurePane.js";
+export { SearchResultCard, GENERIC_CARD_FIELDS } from "./SearchResultCard.js";
+export type { SearchCardProps, SearchCardRenderer } from "./SearchResultCard.js";
+export { DegradationNotice } from "./DegradationNotice.js";
+export type { DegradationNoticeProps } from "./DegradationNotice.js";
+export { UrlIssueNotice } from "./UrlIssueNotice.js";
+export { SortSelect } from "./SortSelect.js";
+export type { SortSelectProps } from "./SortSelect.js";
+export { ErrorAlert } from "./ErrorAlert.js";
+export { SearchSkinTheme } from "./theme.js";
+export type { SearchSkinThemeProps } from "./theme.js";
+export type { ThemeModeProp } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/default/index.js

@@ -0,0 +1,34 @@
+/**
+ * `@stapel/search-react/default` — the antd default skin.
+ *
+ * A SEPARATE entry point on purpose: the main entry is headless and carries
+ * no antd, so a storefront that renders its own cards over `<SearchResults>`
+ * never pays for this bundle (enforced by size-limit and the bundle-purity
+ * test).
+ *
+ * Three override levers, none of which requires forking anything:
+ *
+ *  1. **`renderCard`** — the card slot. A storefront passes
+ *     `<ListingCard>` from `@stapel/listings-react/default`; the generic card
+ *     here is the documented default, not the intended end state (spec §3.7).
+ *  2. **`categoryFeatures`** — the facet-label slot. The server sends
+ *     `{value: count}` and no labels; the schema that names them lives in
+ *     categories, and the container hands it in (spec §6.2 item 2).
+ *  3. **retheming through the §68 token JSON** — every surface wraps itself
+ *     in `<SearchSkinTheme>`, so a host's regenerated `--stapel-*` custom
+ *     properties reach this skin with zero code.
+ */
+// ── surfaces ────────────────────────────────────────────────────────────────
+export { SearchPage } from "./SearchPage.js";
+export { SearchResultsPane } from "./SearchResultsPane.js";
+export { FacetPanelPane } from "./FacetPanelPane.js";
+export { RankingDisclosurePane } from "./RankingDisclosurePane.js";
+// ── parts, exported so a host can compose or wrap one ───────────────────────
+export { SearchResultCard, GENERIC_CARD_FIELDS } from "./SearchResultCard.js";
+export { DegradationNotice } from "./DegradationNotice.js";
+export { UrlIssueNotice } from "./UrlIssueNotice.js";
+export { SortSelect } from "./SortSelect.js";
+export { ErrorAlert } from "./ErrorAlert.js";
+// ── theming ─────────────────────────────────────────────────────────────────
+export { SearchSkinTheme } from "./theme.js";
+//# sourceMappingURL=index.js.map

package/dist/default/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,+EAA+E;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,+EAA+E;AAC/E,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/default/theme.d.ts

@@ -0,0 +1,24 @@
+import type { CSSProperties, ReactElement, ReactNode } from "react";
+import type { ThemeMode } from "@stapel/tokens-antd";
+export interface SearchSkinThemeProps {
+    /**
+     * Light or dark. Defaults to the mode the host's document declares
+     * (`resolveThemeMode()`). Pass explicitly to pin a side.
+     */
+    readonly mode?: ThemeMode;
+    /** Extra styles merged onto the themed root element (layout only — colors
+     * come from the mode). */
+    readonly style?: CSSProperties;
+    readonly children: ReactNode;
+}
+/**
+ * `<SearchSkinTheme/>` — the self-theming wrapper of
+ * `@stapel/search-react/default`. Standalone use is supported (wrap any
+ * composition of the skin's parts once); the shipped surfaces
+ * (`SearchPage`, `SearchResultsPane`, `FacetPanelPane`,
+ * `RankingDisclosurePane`) each already wrap themselves, and nested antd
+ * `ConfigProvider`s merge, so composing them under one `SearchSkinTheme`
+ * stays correct.
+ */
+export declare function SearchSkinTheme(props: SearchSkinThemeProps): ReactElement;
+//# sourceMappingURL=theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/default/theme.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B;8BAC0B;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CAmBzE"}

package/dist/default/theme.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The default skin's INTERNAL theme provider — every `/default` surface wraps
+ * itself in this, so the skin is readable no matter what the host supplies
+ * (tracker #26: a skin set with no internal provider once inherited a theme
+ * bridge serving light-mode values inside a dark document — text on
+ * background at 1.00:1). The theme derives from `@stapel/tokens` via
+ * `@stapel/tokens-antd`'s `toAntdThemeConfig(mode)`; `mode` defaults to what
+ * the HOST's document declares (`resolveThemeMode()` — the `data-theme`
+ * attribute `tokens.css` keys its dark block on), never to a hardcoded side.
+ *
+ * This is also what "override styles" means for this pair: a storefront
+ * retheming through the §68 token JSON regenerates its `--stapel-*` custom
+ * properties and the result page follows with zero code — a far better deal
+ * than a prop-per-colour API, and the reason the skin has none.
+ */
+import { useMemo } from "react";
+import { ConfigProvider } from "antd";
+import { resolveThemeMode, toAntdTheme, toAntdThemeConfig, } from "@stapel/tokens-antd";
+/**
+ * `<SearchSkinTheme/>` — the self-theming wrapper of
+ * `@stapel/search-react/default`. Standalone use is supported (wrap any
+ * composition of the skin's parts once); the shipped surfaces
+ * (`SearchPage`, `SearchResultsPane`, `FacetPanelPane`,
+ * `RankingDisclosurePane`) each already wrap themselves, and nested antd
+ * `ConfigProvider`s merge, so composing them under one `SearchSkinTheme`
+ * stays correct.
+ */
+export function SearchSkinTheme(props) {
+    const mode = props.mode ?? resolveThemeMode();
+    const theme = useMemo(() => toAntdThemeConfig(mode), [mode]);
+    const token = useMemo(() => toAntdTheme(mode), [mode]);
+    return (_jsx(ConfigProvider, { theme: theme, children: _jsx("div", { "data-search-skin-root": true, "data-search-skin-mode": mode, style: {
+                color: token.colorText,
+                backgroundColor: token.colorBgContainer,
+                ...props.style,
+            }, children: props.children }) }));
+}
+//# sourceMappingURL=theme.js.map

package/dist/default/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/default/theme.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAe7B;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,gBAAgB,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,OAAO,CACL,KAAC,cAAc,IAAC,KAAK,EAAE,KAAK,YAC1B,sEAEyB,IAAI,EAC3B,KAAK,EAAE;gBACL,KAAK,EAAE,KAAK,CAAC,SAAS;gBACtB,eAAe,EAAE,KAAK,CAAC,gBAAgB;gBACvC,GAAG,KAAK,CAAC,KAAK;aACf,YAEA,KAAK,CAAC,QAAQ,GACX,GACS,CAClB,CAAC;AACJ,CAAC"}

package/dist/default/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Small shared types for the `/default` skin — kept in one place so every
+ * surface takes the same `mode` prop and re-exports the same error dialect.
+ */
+export type { FlowError } from "@stapel/core";
+import type { ThemeMode } from "@stapel/tokens-antd";
+/** Every `/default` surface accepts a theme mode; absent means "whatever the
+ * host document declares" (`resolveThemeMode()`), never a hardcoded side. */
+export interface ThemeModeProp {
+    readonly mode?: ThemeMode;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/default/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD;6EAC6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;CAC3B"}

package/dist/default/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/default/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/default/types.ts"],"names":[],"mappings":""}

package/dist/headless/FacetPanel.d.ts

@@ -0,0 +1,61 @@
+import type { ReactNode } from "react";
+import type { LoadState } from "@stapel/core";
+import type { FeatureDef } from "@stapel/attributes-react";
+import type { SearchRange } from "../api/types.js";
+import type { FacetGroup } from "../state/facets.js";
+/** The bag `<FacetPanel>` hands its render prop. */
+export interface FacetPanelBag {
+    /**
+     * The facet groups as a state a skin cannot flatten. `empty` means the
+     * search genuinely has no facets to offer (facets off, or no plan for the
+     * category) — it is NOT what a failed query looks like.
+     */
+    readonly state: LoadState<readonly FacetGroup[]>;
+    /**
+     * `true` when the counts came from a SAMPLE because the candidate set
+     * exceeded the backend's cap. The panel must say so — the spec makes this
+     * a first-day requirement, not a banner added after somebody notices the
+     * numbers moving (§12 risk 3).
+     */
+    readonly approximate: boolean;
+    /**
+     * Plan slugs the server dropped at `MAX_FACET_FIELDS`. Reported, not
+     * vanished — the backend's own words. A skin names them; it never renders
+     * a zero in their place.
+     */
+    readonly skipped: readonly string[];
+    /** Slugs that WERE counted. */
+    readonly counted: readonly string[];
+    /** Size of the largest counted set — the number `approximate` is about. */
+    readonly candidates: number;
+    /** Facet values + ranges + geo currently applied. */
+    readonly activeFilters: number;
+    toggle(slug: string, value: string): void;
+    setRange(slug: string, range: SearchRange | null): void;
+    clear(slug: string): void;
+    clearAll(): void;
+}
+/**
+ * Headless facet panel over the CURRENT search.
+ *
+ * It runs the same query as `<SearchResults>` — same state, same key, so
+ * TanStack serves both from one request. That is deliberate: facets and rows
+ * come from one envelope server-side (one query per page is the contract's
+ * stated design), and fetching them separately would put two answers about
+ * one search on the screen at once.
+ *
+ * `categoryFeatures` is the second slot-seam of the pair (spec §6.2 item 2).
+ * The server sends `{value: count}` and no labels, because the labels are
+ * translation keys in the category's own schema. Hand them in and the options
+ * read as words; leave them out and they read as raw index terms — never as
+ * blanks.
+ */
+export declare function FacetPanel(props: {
+    /** From `categories-react`'s `GET /categories/{id}/features/`. */
+    categoryFeatures?: readonly FeatureDef[];
+    /** BCP-47 tag for `date`-typed option labels. Defaults to the runtime's. */
+    locale?: string;
+    enabled?: boolean;
+    children: (bag: FacetPanelBag) => ReactNode;
+}): ReactNode;
+//# sourceMappingURL=FacetPanel.d.ts.map

package/dist/headless/FacetPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FacetPanel.d.ts","sourceRoot":"","sources":["../../src/headless/FacetPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IACjD;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,IAAI,IAAI,CAAC;CAClB;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,SAAS,CAAC;CAC7C,GAAG,SAAS,CAuCZ"}

package/dist/headless/FacetPanel.js

@@ -0,0 +1,57 @@
+import { loadStateFromQuery, mapLoad, useT } from "@stapel/core";
+import { useSearchQuery } from "../model/queries.js";
+import { buildFacetGroups } from "../state/facets.js";
+import { useSearchState } from "./SearchStateProvider.js";
+const EMPTY_META = {
+    approximate: false,
+    candidates: 0,
+    counted: [],
+    skipped: [],
+};
+/**
+ * Headless facet panel over the CURRENT search.
+ *
+ * It runs the same query as `<SearchResults>` — same state, same key, so
+ * TanStack serves both from one request. That is deliberate: facets and rows
+ * come from one envelope server-side (one query per page is the contract's
+ * stated design), and fetching them separately would put two answers about
+ * one search on the screen at once.
+ *
+ * `categoryFeatures` is the second slot-seam of the pair (spec §6.2 item 2).
+ * The server sends `{value: count}` and no labels, because the labels are
+ * translation keys in the category's own schema. Hand them in and the options
+ * read as words; leave them out and they read as raw index terms — never as
+ * blanks.
+ */
+export function FacetPanel(props) {
+    const { state: searchState, setFilter, setRange, clearAll, toggleFilter, activeFilters } = useSearchState();
+    const t = useT();
+    const query = useSearchQuery(searchState, props.enabled !== undefined ? { enabled: props.enabled } : undefined);
+    const envelope = loadStateFromQuery(query);
+    const meta = envelope.status === "ready" ? envelope.data.facet_meta : EMPTY_META;
+    const groups = mapLoad(envelope, (data) => buildFacetGroups({
+        facets: data.facets,
+        meta: data.facet_meta,
+        state: searchState,
+        ...(props.categoryFeatures !== undefined
+            ? { categoryFeatures: props.categoryFeatures }
+            : {}),
+        t,
+        ...(props.locale !== undefined ? { locale: props.locale } : {}),
+    }));
+    return props.children({
+        state: groups,
+        approximate: meta.approximate,
+        skipped: meta.skipped,
+        counted: meta.counted,
+        candidates: meta.candidates,
+        activeFilters,
+        toggle: toggleFilter,
+        setRange,
+        clear: (slug) => {
+            setFilter(slug, []);
+        },
+        clearAll,
+    });
+}
+//# sourceMappingURL=FacetPanel.js.map

package/dist/headless/FacetPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FacetPanel.js","sourceRoot":"","sources":["../../src/headless/FacetPanel.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAIjE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAoC1D,MAAM,UAAU,GAAc;IAC5B,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CAAC,KAO1B;IACC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,GACtF,cAAc,EAAE,CAAC;IACnB,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,KAAK,GAAG,cAAc,CAC1B,WAAW,EACX,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CACrE,CAAC;IAEF,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;IAEjF,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CACxC,gBAAgB,CAAC;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,UAAU;QACrB,KAAK,EAAE,WAAW;QAClB,GAAG,CAAC,KAAK,CAAC,gBAAgB,KAAK,SAAS;YACtC,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QACP,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChE,CAAC,CACH,CAAC;IAEF,OAAO,KAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,aAAa;QACb,MAAM,EAAE,YAAY;QACpB,QAAQ;QACR,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;YACd,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtB,CAAC;QACD,QAAQ;KACT,CAAC,CAAC;AACL,CAAC"}

package/dist/headless/RankingDisclosure.d.ts

@@ -0,0 +1,39 @@
+import type { ReactNode } from "react";
+import type { LoadState } from "@stapel/core";
+import type { RankingResponse, Scorer } from "../api/types.js";
+/** The bag `<RankingDisclosure>` hands its render prop. */
+export interface RankingDisclosureBag {
+    /**
+     * The ranking parameters. `empty` means the deployment declares none — a
+     * legitimate answer for a naive backend, and a different sentence from
+     * "we could not fetch the disclosure".
+     */
+    readonly state: LoadState<readonly Scorer[]>;
+    readonly disclosure: LoadState<RankingResponse>;
+    /**
+     * Parameters the CONFIGURED engine cannot evaluate (`active: false`). They
+     * are listed with their `inactive_reason`, not filtered out: a disclosure
+     * that quietly dropped them would be disclosing a ranking the site does not
+     * actually use — which is the failure mode P2B Art. 5 exists to prevent.
+     */
+    readonly inactive: readonly Scorer[];
+    readonly docType: string | null;
+    readonly backend: string | null;
+    readonly notes: readonly string[];
+    refetch(): void;
+}
+/**
+ * Headless P2B Art. 5 ranking disclosure — "what determines the order of
+ * these results", straight from the backend's scorer registry rather than
+ * from prose somebody has to remember to update.
+ *
+ * Pair this with the DSA Art. 26 half: `SearchItem.promoted` marks the paid
+ * placements in the list itself, and this explains the ordering of everything
+ * else. Neither substitutes for the other.
+ */
+export declare function RankingDisclosure(props: {
+    /** Doc type to disclose. Omitted asks for the deployment's default. */
+    type?: string;
+    children: (bag: RankingDisclosureBag) => ReactNode;
+}): ReactNode;
+//# sourceMappingURL=RankingDisclosure.d.ts.map

package/dist/headless/RankingDisclosure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RankingDisclosure.d.ts","sourceRoot":"","sources":["../../src/headless/RankingDisclosure.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAG/D,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;IAChD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,SAAS,CAAC;CACpD,GAAG,SAAS,CAgBZ"}

package/dist/headless/RankingDisclosure.js

@@ -0,0 +1,28 @@
+import { loadStateFromQuery, mapLoad } from "@stapel/core";
+import { useRankingDisclosure } from "../model/queries.js";
+/**
+ * Headless P2B Art. 5 ranking disclosure — "what determines the order of
+ * these results", straight from the backend's scorer registry rather than
+ * from prose somebody has to remember to update.
+ *
+ * Pair this with the DSA Art. 26 half: `SearchItem.promoted` marks the paid
+ * placements in the list itself, and this explains the ordering of everything
+ * else. Neither substitutes for the other.
+ */
+export function RankingDisclosure(props) {
+    const query = useRankingDisclosure(props.type);
+    const disclosure = loadStateFromQuery(query);
+    const data = disclosure.status === "ready" ? disclosure.data : null;
+    return props.children({
+        state: mapLoad(disclosure, (d) => d.scorers),
+        disclosure,
+        inactive: data === null ? [] : data.scorers.filter((s) => !s.active),
+        docType: data?.doc_type ?? null,
+        backend: data?.backend ?? null,
+        notes: data === null ? [] : data.notes,
+        refetch: () => {
+            void query.refetch();
+        },
+    });
+}
+//# sourceMappingURL=RankingDisclosure.js.map

package/dist/headless/RankingDisclosure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RankingDisclosure.js","sourceRoot":"","sources":["../../src/headless/RankingDisclosure.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAwB3D;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAIjC;IACC,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAEpE,OAAO,KAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAA4B,CAAC;QACjE,UAAU;QACV,QAAQ,EAAE,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACpE,OAAO,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI;QAC/B,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI;QAC9B,KAAK,EAAE,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK;QACtC,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/headless/SearchProvider.d.ts

@@ -0,0 +1,19 @@
+import type { ReactElement, ReactNode } from "react";
+import type { SearchRuntime } from "../model/runtime.js";
+/**
+ * Provides the wired {@link SearchRuntime} to every search hook and headless
+ * component below it. Bring your own visual shell — this component renders
+ * nothing of its own. (Core's `createModuleContext` provider, bound to this
+ * pair — slim wave §21/S2.)
+ *
+ * ```tsx
+ * const runtime = createSearchRuntime({ baseUrl: "/search/api/v1/" });
+ * // give runtime.client to core's <StapelConfigProvider config={{ client }}>
+ * <SearchProvider runtime={runtime}>{app}</SearchProvider>
+ * ```
+ */
+export declare const SearchProvider: (props: {
+    runtime: SearchRuntime;
+    children: ReactNode;
+}) => ReactElement;
+//# sourceMappingURL=SearchProvider.d.ts.map

package/dist/headless/SearchProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchProvider.d.ts","sourceRoot":"","sources":["../../src/headless/SearchProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,KAAK,EAAE;IACnC,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,SAAS,CAAC;CACrB,KAAK,YAA6B,CAAC"}

package/dist/headless/SearchProvider.js

@@ -0,0 +1,15 @@
+import { ModuleProvider } from "../model/context.js";
+/**
+ * Provides the wired {@link SearchRuntime} to every search hook and headless
+ * component below it. Bring your own visual shell — this component renders
+ * nothing of its own. (Core's `createModuleContext` provider, bound to this
+ * pair — slim wave §21/S2.)
+ *
+ * ```tsx
+ * const runtime = createSearchRuntime({ baseUrl: "/search/api/v1/" });
+ * // give runtime.client to core's <StapelConfigProvider config={{ client }}>
+ * <SearchProvider runtime={runtime}>{app}</SearchProvider>
+ * ```
+ */
+export const SearchProvider = ModuleProvider;
+//# sourceMappingURL=SearchProvider.js.map

package/dist/headless/SearchProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchProvider.js","sourceRoot":"","sources":["../../src/headless/SearchProvider.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,cAAc,GAGN,cAAc,CAAC"}