@uniformdev/search 0.0.2 → 0.0.3

package/dist/client-DOew5kqb.d.mts

@@ -0,0 +1,99 @@
+type SearchCollection = 'entries' | 'compositions' | 'assets';
+type SearchResponseHighlightObject = {
+    snippet?: string;
+    snippets?: string[];
+    value?: unknown;
+    values?: unknown[];
+    matched_tokens?: unknown;
+};
+type SearchResponseHighlight = {
+    [field: string]: SearchResponseHighlight | SearchResponseHighlightObject;
+};
+type SearchHit = {
+    id: string;
+    _collection: SearchCollection;
+    /** Per-field highlights (nested by field name). Present only when there are matches. */
+    _highlight?: SearchResponseHighlight;
+    /** Per-field highlights (array form, each entry carries a `field`). */
+    _highlights?: unknown[];
+    [key: string]: unknown;
+};
+type Pagination<Item> = {
+    items: Item[];
+    page: number;
+    perPage: number;
+    total: number;
+    totalPages: number;
+};
+type CollectionResult = {
+    data: Pagination<SearchHit>;
+    facets: Facets;
+};
+type FilterByItem = {
+    title: string;
+    value: string;
+};
+type FacetBy = {
+    type: 'select' | 'multiSelect' | 'range';
+    title: string;
+    fieldKey: string;
+};
+type OrderBy = {
+    title: string;
+    field: string;
+    direction: 'ASC' | 'DESC';
+};
+type PageSize = {
+    size: number;
+    /** When set, this size is the initial page size (first `default` wins). */
+    default?: boolean;
+};
+type Facets = {
+    [key: string]: {
+        [key: string]: number;
+    };
+};
+type FilterQuery = {
+    [K: string]: string[];
+};
+type SearchItemConfig = {
+    source: string;
+    type: string;
+    nodeId?: string;
+    urlTemplate?: string;
+    tokenMapping?: Record<string, string>;
+};
+
+interface SearchParams {
+    projectId?: string;
+    page?: number;
+    perPage?: number;
+    filters?: Record<string, unknown>;
+    baseFilterBy?: string;
+    facetBy?: string;
+    queryBy?: string;
+    search?: string;
+    orderBy?: string;
+    locale?: string;
+    maxFacetValues?: number;
+    /** Max typos tolerated per word: 0, 1, or 2. (Typesense `num_typos`.) */
+    maxTypos?: number;
+    /** Minimum word length before a single typo is allowed. (Typesense `min_len_1typo`.) */
+    minLengthFor1Typo?: number;
+    /** Minimum word length before two typos are allowed. (Typesense `min_len_2typo`.) */
+    minLengthFor2Typos?: number;
+    /** If a query returns fewer than this many results, retry with more typos. (Typesense `typo_tokens_threshold`.) */
+    typoFallbackThreshold?: number;
+    /** Rank exact matches above typo-corrected ones. (Typesense `prioritize_exact_match`.) */
+    prioritizeExactMatch?: boolean;
+}
+interface SearchClient {
+    performSearch(params: SearchParams): Promise<CollectionResult>;
+}
+declare function createSearchClient(config: {
+    apiUrl: string;
+    apiKey?: string;
+    projectId?: string;
+}): SearchClient;
+
+export { type CollectionResult as C, type FacetBy as F, type OrderBy as O, type PageSize as P, type SearchHit as S, type Facets as a, type FilterByItem as b, type FilterQuery as c, type Pagination as d, type SearchClient as e, type SearchCollection as f, type SearchItemConfig as g, type SearchParams as h, type SearchResponseHighlight as i, type SearchResponseHighlightObject as j, createSearchClient as k };

package/dist/client-DOew5kqb.d.ts

@@ -0,0 +1,99 @@
+type SearchCollection = 'entries' | 'compositions' | 'assets';
+type SearchResponseHighlightObject = {
+    snippet?: string;
+    snippets?: string[];
+    value?: unknown;
+    values?: unknown[];
+    matched_tokens?: unknown;
+};
+type SearchResponseHighlight = {
+    [field: string]: SearchResponseHighlight | SearchResponseHighlightObject;
+};
+type SearchHit = {
+    id: string;
+    _collection: SearchCollection;
+    /** Per-field highlights (nested by field name). Present only when there are matches. */
+    _highlight?: SearchResponseHighlight;
+    /** Per-field highlights (array form, each entry carries a `field`). */
+    _highlights?: unknown[];
+    [key: string]: unknown;
+};
+type Pagination<Item> = {
+    items: Item[];
+    page: number;
+    perPage: number;
+    total: number;
+    totalPages: number;
+};
+type CollectionResult = {
+    data: Pagination<SearchHit>;
+    facets: Facets;
+};
+type FilterByItem = {
+    title: string;
+    value: string;
+};
+type FacetBy = {
+    type: 'select' | 'multiSelect' | 'range';
+    title: string;
+    fieldKey: string;
+};
+type OrderBy = {
+    title: string;
+    field: string;
+    direction: 'ASC' | 'DESC';
+};
+type PageSize = {
+    size: number;
+    /** When set, this size is the initial page size (first `default` wins). */
+    default?: boolean;
+};
+type Facets = {
+    [key: string]: {
+        [key: string]: number;
+    };
+};
+type FilterQuery = {
+    [K: string]: string[];
+};
+type SearchItemConfig = {
+    source: string;
+    type: string;
+    nodeId?: string;
+    urlTemplate?: string;
+    tokenMapping?: Record<string, string>;
+};
+
+interface SearchParams {
+    projectId?: string;
+    page?: number;
+    perPage?: number;
+    filters?: Record<string, unknown>;
+    baseFilterBy?: string;
+    facetBy?: string;
+    queryBy?: string;
+    search?: string;
+    orderBy?: string;
+    locale?: string;
+    maxFacetValues?: number;
+    /** Max typos tolerated per word: 0, 1, or 2. (Typesense `num_typos`.) */
+    maxTypos?: number;
+    /** Minimum word length before a single typo is allowed. (Typesense `min_len_1typo`.) */
+    minLengthFor1Typo?: number;
+    /** Minimum word length before two typos are allowed. (Typesense `min_len_2typo`.) */
+    minLengthFor2Typos?: number;
+    /** If a query returns fewer than this many results, retry with more typos. (Typesense `typo_tokens_threshold`.) */
+    typoFallbackThreshold?: number;
+    /** Rank exact matches above typo-corrected ones. (Typesense `prioritize_exact_match`.) */
+    prioritizeExactMatch?: boolean;
+}
+interface SearchClient {
+    performSearch(params: SearchParams): Promise<CollectionResult>;
+}
+declare function createSearchClient(config: {
+    apiUrl: string;
+    apiKey?: string;
+    projectId?: string;
+}): SearchClient;
+
+export { type CollectionResult as C, type FacetBy as F, type OrderBy as O, type PageSize as P, type SearchHit as S, type Facets as a, type FilterByItem as b, type FilterQuery as c, type Pagination as d, type SearchClient as e, type SearchCollection as f, type SearchItemConfig as g, type SearchParams as h, type SearchResponseHighlight as i, type SearchResponseHighlightObject as j, createSearchClient as k };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { O as OrderBy } from './client-CtTcEJUy.mjs';
-export { C as CollectionResult, F as FacetBy, a as Facets, b as FilterByItem, c as FilterQuery, P as PageSize, d as Pagination, S as SearchClient, e as SearchCollection, f as SearchHit, g as SearchItemConfig, h as SearchParams, i as createSearchClient } from './client-CtTcEJUy.mjs';
+import { O as OrderBy, S as SearchHit } from './client-DOew5kqb.mjs';
+export { C as CollectionResult, F as FacetBy, a as Facets, b as FilterByItem, c as FilterQuery, P as PageSize, d as Pagination, e as SearchClient, f as SearchCollection, g as SearchItemConfig, h as SearchParams, i as SearchResponseHighlight, j as SearchResponseHighlightObject, k as createSearchClient } from './client-DOew5kqb.mjs';
 
 declare const UNIFORM_SEARCH_QUERY_KEY = "search";
 declare const UNIFORM_SEARCH_PAGE_KEY = "page";
@@ -11,6 +11,21 @@ declare const DEFAULT_PAGE_SIZE = 10;
 declare const buildOrderByQuery: (orderBy: OrderBy) => string;
 declare const getSearchParamsFromUrl: (urlString: string) => Record<string, string | string[]>;
 
+type HighlightMatch = {
+    html?: string;
+    values?: unknown[];
+};
+/**
+ * Resolve the highlight (if any) for a field on a search hit.
+ *
+ * @param hit        A hit returned by `performSearch`.
+ * @param fieldPath  The field name (dot-path for nested fields, e.g. `author.name`).
+ * @param fieldValue The hit's raw value for the field (used to align array highlights).
+ * @returns `{ html }` for a highlighted snippet, `{ values }` for per-item array
+ *          highlights, or `undefined` when the field wasn't matched.
+ */
+declare const getHighlightMatch: (hit: SearchHit, fieldPath: string, fieldValue?: unknown) => HighlightMatch | undefined;
+
 declare function flattenBlockParams<T = Record<string, unknown>>(items: unknown, locale?: string): T[];
 
-export { DEFAULT_PAGE_SIZE, FIRST_PAGE, OrderBy, UNIFORM_SEARCH_ORDER_BY_KEY, UNIFORM_SEARCH_PAGE_KEY, UNIFORM_SEARCH_PAGE_SIZE_KEY, UNIFORM_SEARCH_QUERY_KEY, buildOrderByQuery, flattenBlockParams, getSearchParamsFromUrl };
+export { DEFAULT_PAGE_SIZE, FIRST_PAGE, type HighlightMatch, OrderBy, SearchHit, UNIFORM_SEARCH_ORDER_BY_KEY, UNIFORM_SEARCH_PAGE_KEY, UNIFORM_SEARCH_PAGE_SIZE_KEY, UNIFORM_SEARCH_QUERY_KEY, buildOrderByQuery, flattenBlockParams, getHighlightMatch, getSearchParamsFromUrl };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { O as OrderBy } from './client-CtTcEJUy.js';
-export { C as CollectionResult, F as FacetBy, a as Facets, b as FilterByItem, c as FilterQuery, P as PageSize, d as Pagination, S as SearchClient, e as SearchCollection, f as SearchHit, g as SearchItemConfig, h as SearchParams, i as createSearchClient } from './client-CtTcEJUy.js';
+import { O as OrderBy, S as SearchHit } from './client-DOew5kqb.js';
+export { C as CollectionResult, F as FacetBy, a as Facets, b as FilterByItem, c as FilterQuery, P as PageSize, d as Pagination, e as SearchClient, f as SearchCollection, g as SearchItemConfig, h as SearchParams, i as SearchResponseHighlight, j as SearchResponseHighlightObject, k as createSearchClient } from './client-DOew5kqb.js';
 
 declare const UNIFORM_SEARCH_QUERY_KEY = "search";
 declare const UNIFORM_SEARCH_PAGE_KEY = "page";
@@ -11,6 +11,21 @@ declare const DEFAULT_PAGE_SIZE = 10;
 declare const buildOrderByQuery: (orderBy: OrderBy) => string;
 declare const getSearchParamsFromUrl: (urlString: string) => Record<string, string | string[]>;
 
+type HighlightMatch = {
+    html?: string;
+    values?: unknown[];
+};
+/**
+ * Resolve the highlight (if any) for a field on a search hit.
+ *
+ * @param hit        A hit returned by `performSearch`.
+ * @param fieldPath  The field name (dot-path for nested fields, e.g. `author.name`).
+ * @param fieldValue The hit's raw value for the field (used to align array highlights).
+ * @returns `{ html }` for a highlighted snippet, `{ values }` for per-item array
+ *          highlights, or `undefined` when the field wasn't matched.
+ */
+declare const getHighlightMatch: (hit: SearchHit, fieldPath: string, fieldValue?: unknown) => HighlightMatch | undefined;
+
 declare function flattenBlockParams<T = Record<string, unknown>>(items: unknown, locale?: string): T[];
 
-export { DEFAULT_PAGE_SIZE, FIRST_PAGE, OrderBy, UNIFORM_SEARCH_ORDER_BY_KEY, UNIFORM_SEARCH_PAGE_KEY, UNIFORM_SEARCH_PAGE_SIZE_KEY, UNIFORM_SEARCH_QUERY_KEY, buildOrderByQuery, flattenBlockParams, getSearchParamsFromUrl };
+export { DEFAULT_PAGE_SIZE, FIRST_PAGE, type HighlightMatch, OrderBy, SearchHit, UNIFORM_SEARCH_ORDER_BY_KEY, UNIFORM_SEARCH_PAGE_KEY, UNIFORM_SEARCH_PAGE_SIZE_KEY, UNIFORM_SEARCH_QUERY_KEY, buildOrderByQuery, flattenBlockParams, getHighlightMatch, getSearchParamsFromUrl };

package/dist/index.js

@@ -29,6 +29,7 @@ __export(src_exports, {
   buildOrderByQuery: () => buildOrderByQuery,
   createSearchClient: () => createSearchClient,
   flattenBlockParams: () => flattenBlockParams,
+  getHighlightMatch: () => getHighlightMatch,
   getSearchParamsFromUrl: () => getSearchParamsFromUrl
 });
 module.exports = __toCommonJS(src_exports);
@@ -67,12 +68,12 @@ function createSearchClient(config) {
           body: JSON.stringify(body)
         });
         if (!response.ok) {
-          console.error(`[alex] Search API error: ${response.status}`);
+          console.error(`Search API error: ${response.status}`);
           return emptyResult();
         }
         return response.json();
       } catch (error) {
-        console.error("[alex] Search fetch error:", error);
+        console.error("Search fetch error:", error);
         return emptyResult();
       }
     }
@@ -106,6 +107,50 @@ var getSearchParamsFromUrl = (urlString) => {
   return params;
 };
 
+// src/highlights.ts
+var isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isHighlightLeaf = (value) => isPlainObject(value) && ("snippet" in value || "snippets" in value || "value" in value || "values" in value);
+var unknownToString = (value) => {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    return String(value);
+  }
+  try {
+    return JSON.stringify(value);
+  } catch (e) {
+    return "";
+  }
+};
+var getHighlightMatch = (hit, fieldPath, fieldValue) => {
+  const fieldHighlight = Array.isArray(hit._highlights) ? hit._highlights.find((highlight) => isPlainObject(highlight) && highlight.field === fieldPath) : void 0;
+  if (isPlainObject(fieldHighlight)) {
+    const snippets = fieldHighlight.snippets;
+    if (Array.isArray(snippets)) return { html: snippets.map(unknownToString).join(", ") };
+    const snippet = unknownToString(fieldHighlight.snippet);
+    if (snippet) return { html: snippet };
+    const value = unknownToString(fieldHighlight.value);
+    if (value) return { html: value };
+  }
+  const highlightValue = fieldPath.split(".").reduce((current, pathPart) => {
+    if (!isPlainObject(current)) return void 0;
+    return current[pathPart];
+  }, hit._highlight);
+  if (isHighlightLeaf(highlightValue)) {
+    if (Array.isArray(highlightValue.snippets)) {
+      return { html: highlightValue.snippets.map(unknownToString).join(", ") };
+    }
+    const snippet = unknownToString(highlightValue.snippet);
+    if (snippet) return { html: snippet };
+    if (Array.isArray(highlightValue.values)) return { values: highlightValue.values };
+    if ("value" in highlightValue) return { html: unknownToString(highlightValue.value) };
+  }
+  if (Array.isArray(fieldValue) && Array.isArray(highlightValue)) {
+    return { values: highlightValue };
+  }
+  return void 0;
+};
+
 // src/flattenBlockParams.ts
 function resolveFieldValue(field, locale = "en-us") {
   var _a;
@@ -142,6 +187,7 @@ function flattenBlockParams(items, locale = "en-us") {
   buildOrderByQuery,
   createSearchClient,
   flattenBlockParams,
+  getHighlightMatch,
   getSearchParamsFromUrl
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/client.ts","../src/utils.ts","../src/flattenBlockParams.ts"],"sourcesContent":["export * from './types';\nexport * from './constants';\nexport * from './client';\nexport * from './utils';\nexport * from './flattenBlockParams';\n","export const UNIFORM_SEARCH_QUERY_KEY = 'search';\nexport const UNIFORM_SEARCH_PAGE_KEY = 'page';\nexport const UNIFORM_SEARCH_PAGE_SIZE_KEY = 'pageSize';\nexport const UNIFORM_SEARCH_ORDER_BY_KEY = 'orderBy';\nexport const FIRST_PAGE = 0;\nexport const DEFAULT_PAGE_SIZE = 10;\n","import type { CollectionResult } from './types';\n\nexport interface SearchParams {\n  projectId?: string;\n  page?: number;\n  perPage?: number;\n  filters?: Record<string, unknown>;\n  baseFilterBy?: string;\n  facetBy?: string;\n  queryBy?: string;\n  search?: string;\n  orderBy?: string;\n  locale?: string;\n  maxFacetValues?: number;\n}\n\nexport interface SearchClient {\n  performSearch(params: SearchParams): Promise<CollectionResult>;\n}\n\nconst emptyResult = (): CollectionResult => ({\n  data: { items: [], total: 0, page: 0, perPage: 10, totalPages: 0 },\n  facets: {},\n});\n\nexport function createSearchClient(config: { apiUrl: string; apiKey?: string; projectId?: string }): SearchClient {\n  const baseUrl = config.apiUrl.replace(/\\/+$/, '');\n  return {\n    async performSearch(params) {\n      const headers: Record<string, string> = {\n        'Content-Type': 'application/json',\n      };\n      if (config.apiKey) {\n        headers['x-api-key'] = config.apiKey;\n      }\n\n      const body = {\n        ...params,\n        projectId: params.projectId || config.projectId,\n      };\n\n      try {\n        const response = await fetch(`${baseUrl}/api/search`, {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(body),\n        });\n\n        if (!response.ok) {\n          console.error(`[alex] Search API error: ${response.status}`);\n          return emptyResult();\n        }\n\n        return response.json();\n      } catch (error) {\n        console.error('[alex] Search fetch error:', error);\n        return emptyResult();\n      }\n    },\n  };\n}\n","import type { OrderBy } from './types';\n\nexport const buildOrderByQuery = (orderBy: OrderBy) => {\n  const field = orderBy.field as unknown;\n  // sortByConfig produces an object value: { field: string; direction: 'asc' | 'desc' }\n  if (field && typeof field === 'object' && 'field' in (field as object)) {\n    const sv = field as { field: string; direction: string };\n    return `${sv.field}_${sv.direction.toUpperCase()}`;\n  }\n  // Plain string \"relevance\" or missing direction → no sort\n  if (!field || field === 'relevance') return '';\n  return `${field}_${orderBy.direction ?? 'ASC'}`;\n};\n\nexport const getSearchParamsFromUrl = (urlString: string): Record<string, string | string[]> => {\n  if (!urlString) {\n    return {};\n  }\n\n  const url = new URL(urlString);\n  const params: Record<string, string | string[]> = {};\n\n  url.searchParams.forEach((value, key) => {\n    if (params[key]) {\n      params[key] = Array.isArray(params[key])\n        ? [...(params[key] as string[]), value]\n        : [params[key] as string, value];\n    } else {\n      params[key] = value;\n    }\n  });\n\n  return params;\n};\n","type RawField = {\n  type?: string;\n  value?: unknown;\n  locales?: Record<string, unknown>;\n};\n\ntype RawBlockItem = {\n  type?: string;\n  fields?: Record<string, RawField>;\n};\n\nfunction resolveFieldValue(field: RawField, locale = 'en-us'): unknown {\n  if (!field || typeof field !== 'object') return field;\n\n  if (field.type === '$block' && Array.isArray(field.value)) {\n    return flattenBlockParams(field.value as RawBlockItem[], locale);\n  }\n\n  if (field.locales && typeof field.locales === 'object') {\n    return field.locales[locale] ?? field.value;\n  }\n\n  return field.value;\n}\n\nexport function flattenBlockParams<T = Record<string, unknown>>(\n  items: unknown,\n  locale = 'en-us'\n): T[] {\n  if (!Array.isArray(items)) return [];\n  return items.map(item => {\n    const result: Record<string, unknown> = {};\n    const blockItem = item as RawBlockItem;\n    if (blockItem.fields) {\n      for (const [key, field] of Object.entries(blockItem.fields)) {\n        result[key] = resolveFieldValue(field, locale);\n      }\n    }\n    return result as T;\n  });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/client.ts","../src/utils.ts","../src/highlights.ts","../src/flattenBlockParams.ts"],"sourcesContent":["export * from './types';\nexport * from './constants';\nexport * from './client';\nexport * from './utils';\nexport * from './highlights';\nexport * from './flattenBlockParams';\n","export const UNIFORM_SEARCH_QUERY_KEY = 'search';\nexport const UNIFORM_SEARCH_PAGE_KEY = 'page';\nexport const UNIFORM_SEARCH_PAGE_SIZE_KEY = 'pageSize';\nexport const UNIFORM_SEARCH_ORDER_BY_KEY = 'orderBy';\nexport const FIRST_PAGE = 0;\nexport const DEFAULT_PAGE_SIZE = 10;\n","import type { CollectionResult } from './types';\n\nexport interface SearchParams {\n  projectId?: string;\n  page?: number;\n  perPage?: number;\n  filters?: Record<string, unknown>;\n  baseFilterBy?: string;\n  facetBy?: string;\n  queryBy?: string;\n  search?: string;\n  orderBy?: string;\n  locale?: string;\n  maxFacetValues?: number;\n\n  // ── Typo tolerance (all optional; omitted → the search engine's defaults apply) ──\n  /** Max typos tolerated per word: 0, 1, or 2. (Typesense `num_typos`.) */\n  maxTypos?: number;\n  /** Minimum word length before a single typo is allowed. (Typesense `min_len_1typo`.) */\n  minLengthFor1Typo?: number;\n  /** Minimum word length before two typos are allowed. (Typesense `min_len_2typo`.) */\n  minLengthFor2Typos?: number;\n  /** If a query returns fewer than this many results, retry with more typos. (Typesense `typo_tokens_threshold`.) */\n  typoFallbackThreshold?: number;\n  /** Rank exact matches above typo-corrected ones. (Typesense `prioritize_exact_match`.) */\n  prioritizeExactMatch?: boolean;\n}\n\nexport interface SearchClient {\n  performSearch(params: SearchParams): Promise<CollectionResult>;\n}\n\nconst emptyResult = (): CollectionResult => ({\n  data: { items: [], total: 0, page: 0, perPage: 10, totalPages: 0 },\n  facets: {},\n});\n\nexport function createSearchClient(config: { apiUrl: string; apiKey?: string; projectId?: string }): SearchClient {\n  const baseUrl = config.apiUrl.replace(/\\/+$/, '');\n  return {\n    async performSearch(params) {\n      const headers: Record<string, string> = {\n        'Content-Type': 'application/json',\n      };\n      if (config.apiKey) {\n        headers['x-api-key'] = config.apiKey;\n      }\n\n      const body = {\n        ...params,\n        projectId: params.projectId || config.projectId,\n      };\n\n      try {\n        const response = await fetch(`${baseUrl}/api/search`, {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(body),\n        });\n\n        if (!response.ok) {\n          console.error(`Search API error: ${response.status}`);\n          return emptyResult();\n        }\n\n        return response.json();\n      } catch (error) {\n        console.error('Search fetch error:', error);\n        return emptyResult();\n      }\n    },\n  };\n}\n","import type { OrderBy } from './types';\n\nexport const buildOrderByQuery = (orderBy: OrderBy) => {\n  const field = orderBy.field as unknown;\n  // sortByConfig produces an object value: { field: string; direction: 'asc' | 'desc' }\n  if (field && typeof field === 'object' && 'field' in (field as object)) {\n    const sv = field as { field: string; direction: string };\n    return `${sv.field}_${sv.direction.toUpperCase()}`;\n  }\n  // Plain string \"relevance\" or missing direction → no sort\n  if (!field || field === 'relevance') return '';\n  return `${field}_${orderBy.direction ?? 'ASC'}`;\n};\n\nexport const getSearchParamsFromUrl = (urlString: string): Record<string, string | string[]> => {\n  if (!urlString) {\n    return {};\n  }\n\n  const url = new URL(urlString);\n  const params: Record<string, string | string[]> = {};\n\n  url.searchParams.forEach((value, key) => {\n    if (params[key]) {\n      params[key] = Array.isArray(params[key])\n        ? [...(params[key] as string[]), value]\n        : [params[key] as string, value];\n    } else {\n      params[key] = value;\n    }\n  });\n\n  return params;\n};\n","import type { SearchHit, SearchResponseHighlightObject } from './types';\n\n// Helpers for rendering search highlights returned by `performSearch`. A hit carries\n// highlight data in `_highlight` (nested by field) and/or `_highlights` (array form);\n// `getHighlightMatch` resolves the highlight for a given field into a simple shape the\n// UI can render — `html` (a snippet with the matched terms wrapped in highlight tags,\n// for `dangerouslySetInnerHTML`) or `values` (per-item highlights for array fields).\n\nexport type HighlightMatch = {\n  html?: string;\n  values?: unknown[];\n};\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst isHighlightLeaf = (value: unknown): value is SearchResponseHighlightObject =>\n  isPlainObject(value) &&\n  ('snippet' in value || 'snippets' in value || 'value' in value || 'values' in value);\n\nconst unknownToString = (value: unknown): string => {\n  if (value === null || value === undefined) return '';\n  if (typeof value === 'string') return value;\n  if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {\n    return String(value);\n  }\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return '';\n  }\n};\n\n/**\n * Resolve the highlight (if any) for a field on a search hit.\n *\n * @param hit        A hit returned by `performSearch`.\n * @param fieldPath  The field name (dot-path for nested fields, e.g. `author.name`).\n * @param fieldValue The hit's raw value for the field (used to align array highlights).\n * @returns `{ html }` for a highlighted snippet, `{ values }` for per-item array\n *          highlights, or `undefined` when the field wasn't matched.\n */\nexport const getHighlightMatch = (\n  hit: SearchHit,\n  fieldPath: string,\n  fieldValue?: unknown\n): HighlightMatch | undefined => {\n  const fieldHighlight = Array.isArray(hit._highlights)\n    ? hit._highlights.find((highlight) => isPlainObject(highlight) && highlight.field === fieldPath)\n    : undefined;\n\n  if (isPlainObject(fieldHighlight)) {\n    const snippets = fieldHighlight.snippets;\n    if (Array.isArray(snippets)) return { html: snippets.map(unknownToString).join(', ') };\n    const snippet = unknownToString(fieldHighlight.snippet);\n    if (snippet) return { html: snippet };\n    const value = unknownToString(fieldHighlight.value);\n    if (value) return { html: value };\n  }\n\n  const highlightValue = fieldPath.split('.').reduce<unknown>((current, pathPart) => {\n    if (!isPlainObject(current)) return undefined;\n    return current[pathPart];\n  }, hit._highlight);\n\n  if (isHighlightLeaf(highlightValue)) {\n    if (Array.isArray(highlightValue.snippets)) {\n      return { html: highlightValue.snippets.map(unknownToString).join(', ') };\n    }\n    const snippet = unknownToString(highlightValue.snippet);\n    if (snippet) return { html: snippet };\n    if (Array.isArray(highlightValue.values)) return { values: highlightValue.values };\n    if ('value' in highlightValue) return { html: unknownToString(highlightValue.value) };\n  }\n\n  if (Array.isArray(fieldValue) && Array.isArray(highlightValue)) {\n    return { values: highlightValue };\n  }\n\n  return undefined;\n};\n","type RawField = {\n  type?: string;\n  value?: unknown;\n  locales?: Record<string, unknown>;\n};\n\ntype RawBlockItem = {\n  type?: string;\n  fields?: Record<string, RawField>;\n};\n\nfunction resolveFieldValue(field: RawField, locale = 'en-us'): unknown {\n  if (!field || typeof field !== 'object') return field;\n\n  if (field.type === '$block' && Array.isArray(field.value)) {\n    return flattenBlockParams(field.value as RawBlockItem[], locale);\n  }\n\n  if (field.locales && typeof field.locales === 'object') {\n    return field.locales[locale] ?? field.value;\n  }\n\n  return field.value;\n}\n\nexport function flattenBlockParams<T = Record<string, unknown>>(\n  items: unknown,\n  locale = 'en-us'\n): T[] {\n  if (!Array.isArray(items)) return [];\n  return items.map(item => {\n    const result: Record<string, unknown> = {};\n    const blockItem = item as RawBlockItem;\n    if (blockItem.fields) {\n      for (const [key, field] of Object.entries(blockItem.fields)) {\n        result[key] = resolveFieldValue(field, locale);\n      }\n    }\n    return result as T;\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -36,17 +36,61 @@ function createSearchClient(config) {
           body: JSON.stringify(body)
         });
         if (!response.ok) {
-          console.error(`[alex] Search API error: ${response.status}`);
+          console.error(`Search API error: ${response.status}`);
           return emptyResult();
         }
         return response.json();
       } catch (error) {
-        console.error("[alex] Search fetch error:", error);
+        console.error("Search fetch error:", error);
         return emptyResult();
       }
     }
   };
 }
+
+// src/highlights.ts
+var isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isHighlightLeaf = (value) => isPlainObject(value) && ("snippet" in value || "snippets" in value || "value" in value || "values" in value);
+var unknownToString = (value) => {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    return String(value);
+  }
+  try {
+    return JSON.stringify(value);
+  } catch (e) {
+    return "";
+  }
+};
+var getHighlightMatch = (hit, fieldPath, fieldValue) => {
+  const fieldHighlight = Array.isArray(hit._highlights) ? hit._highlights.find((highlight) => isPlainObject(highlight) && highlight.field === fieldPath) : void 0;
+  if (isPlainObject(fieldHighlight)) {
+    const snippets = fieldHighlight.snippets;
+    if (Array.isArray(snippets)) return { html: snippets.map(unknownToString).join(", ") };
+    const snippet = unknownToString(fieldHighlight.snippet);
+    if (snippet) return { html: snippet };
+    const value = unknownToString(fieldHighlight.value);
+    if (value) return { html: value };
+  }
+  const highlightValue = fieldPath.split(".").reduce((current, pathPart) => {
+    if (!isPlainObject(current)) return void 0;
+    return current[pathPart];
+  }, hit._highlight);
+  if (isHighlightLeaf(highlightValue)) {
+    if (Array.isArray(highlightValue.snippets)) {
+      return { html: highlightValue.snippets.map(unknownToString).join(", ") };
+    }
+    const snippet = unknownToString(highlightValue.snippet);
+    if (snippet) return { html: snippet };
+    if (Array.isArray(highlightValue.values)) return { values: highlightValue.values };
+    if ("value" in highlightValue) return { html: unknownToString(highlightValue.value) };
+  }
+  if (Array.isArray(fieldValue) && Array.isArray(highlightValue)) {
+    return { values: highlightValue };
+  }
+  return void 0;
+};
 export {
   DEFAULT_PAGE_SIZE,
   FIRST_PAGE,
@@ -57,6 +101,7 @@ export {
   buildOrderByQuery,
   createSearchClient,
   flattenBlockParams,
+  getHighlightMatch,
   getSearchParamsFromUrl
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type { CollectionResult } from './types';\n\nexport interface SearchParams {\n  projectId?: string;\n  page?: number;\n  perPage?: number;\n  filters?: Record<string, unknown>;\n  baseFilterBy?: string;\n  facetBy?: string;\n  queryBy?: string;\n  search?: string;\n  orderBy?: string;\n  locale?: string;\n  maxFacetValues?: number;\n}\n\nexport interface SearchClient {\n  performSearch(params: SearchParams): Promise<CollectionResult>;\n}\n\nconst emptyResult = (): CollectionResult => ({\n  data: { items: [], total: 0, page: 0, perPage: 10, totalPages: 0 },\n  facets: {},\n});\n\nexport function createSearchClient(config: { apiUrl: string; apiKey?: string; projectId?: string }): SearchClient {\n  const baseUrl = config.apiUrl.replace(/\\/+$/, '');\n  return {\n    async performSearch(params) {\n      const headers: Record<string, string> = {\n        'Content-Type': 'application/json',\n      };\n      if (config.apiKey) {\n        headers['x-api-key'] = config.apiKey;\n      }\n\n      const body = {\n        ...params,\n        projectId: params.projectId || config.projectId,\n      };\n\n      try {\n        const response = await fetch(`${baseUrl}/api/search`, {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(body),\n        });\n\n        if (!response.ok) {\n          console.error(`[alex] Search API error: ${response.status}`);\n          return emptyResult();\n        }\n\n        return response.json();\n      } catch (error) {\n        console.error('[alex] Search fetch error:', error);\n        return emptyResult();\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAoBA,IAAM,cAAc,OAAyB;AAAA,EAC3C,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,IAAI,YAAY,EAAE;AAAA,EACjE,QAAQ,CAAC;AACX;AAEO,SAAS,mBAAmB,QAA+E;AAChH,QAAM,UAAU,OAAO,OAAO,QAAQ,QAAQ,EAAE;AAChD,SAAO;AAAA,IACL,MAAM,cAAc,QAAQ;AAC1B,YAAM,UAAkC;AAAA,QACtC,gBAAgB;AAAA,MAClB;AACA,UAAI,OAAO,QAAQ;AACjB,gBAAQ,WAAW,IAAI,OAAO;AAAA,MAChC;AAEA,YAAM,OAAO;AAAA,QACX,GAAG;AAAA,QACH,WAAW,OAAO,aAAa,OAAO;AAAA,MACxC;AAEA,UAAI;AACF,cAAM,WAAW,MAAM,MAAM,GAAG,OAAO,eAAe;AAAA,UACpD,QAAQ;AAAA,UACR;AAAA,UACA,MAAM,KAAK,UAAU,IAAI;AAAA,QAC3B,CAAC;AAED,YAAI,CAAC,SAAS,IAAI;AAChB,kBAAQ,MAAM,4BAA4B,SAAS,MAAM,EAAE;AAC3D,iBAAO,YAAY;AAAA,QACrB;AAEA,eAAO,SAAS,KAAK;AAAA,MACvB,SAAS,OAAO;AACd,gBAAQ,MAAM,8BAA8B,KAAK;AACjD,eAAO,YAAY;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/client.ts","../src/highlights.ts"],"sourcesContent":["import type { CollectionResult } from './types';\n\nexport interface SearchParams {\n  projectId?: string;\n  page?: number;\n  perPage?: number;\n  filters?: Record<string, unknown>;\n  baseFilterBy?: string;\n  facetBy?: string;\n  queryBy?: string;\n  search?: string;\n  orderBy?: string;\n  locale?: string;\n  maxFacetValues?: number;\n\n  // ── Typo tolerance (all optional; omitted → the search engine's defaults apply) ──\n  /** Max typos tolerated per word: 0, 1, or 2. (Typesense `num_typos`.) */\n  maxTypos?: number;\n  /** Minimum word length before a single typo is allowed. (Typesense `min_len_1typo`.) */\n  minLengthFor1Typo?: number;\n  /** Minimum word length before two typos are allowed. (Typesense `min_len_2typo`.) */\n  minLengthFor2Typos?: number;\n  /** If a query returns fewer than this many results, retry with more typos. (Typesense `typo_tokens_threshold`.) */\n  typoFallbackThreshold?: number;\n  /** Rank exact matches above typo-corrected ones. (Typesense `prioritize_exact_match`.) */\n  prioritizeExactMatch?: boolean;\n}\n\nexport interface SearchClient {\n  performSearch(params: SearchParams): Promise<CollectionResult>;\n}\n\nconst emptyResult = (): CollectionResult => ({\n  data: { items: [], total: 0, page: 0, perPage: 10, totalPages: 0 },\n  facets: {},\n});\n\nexport function createSearchClient(config: { apiUrl: string; apiKey?: string; projectId?: string }): SearchClient {\n  const baseUrl = config.apiUrl.replace(/\\/+$/, '');\n  return {\n    async performSearch(params) {\n      const headers: Record<string, string> = {\n        'Content-Type': 'application/json',\n      };\n      if (config.apiKey) {\n        headers['x-api-key'] = config.apiKey;\n      }\n\n      const body = {\n        ...params,\n        projectId: params.projectId || config.projectId,\n      };\n\n      try {\n        const response = await fetch(`${baseUrl}/api/search`, {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(body),\n        });\n\n        if (!response.ok) {\n          console.error(`Search API error: ${response.status}`);\n          return emptyResult();\n        }\n\n        return response.json();\n      } catch (error) {\n        console.error('Search fetch error:', error);\n        return emptyResult();\n      }\n    },\n  };\n}\n","import type { SearchHit, SearchResponseHighlightObject } from './types';\n\n// Helpers for rendering search highlights returned by `performSearch`. A hit carries\n// highlight data in `_highlight` (nested by field) and/or `_highlights` (array form);\n// `getHighlightMatch` resolves the highlight for a given field into a simple shape the\n// UI can render — `html` (a snippet with the matched terms wrapped in highlight tags,\n// for `dangerouslySetInnerHTML`) or `values` (per-item highlights for array fields).\n\nexport type HighlightMatch = {\n  html?: string;\n  values?: unknown[];\n};\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst isHighlightLeaf = (value: unknown): value is SearchResponseHighlightObject =>\n  isPlainObject(value) &&\n  ('snippet' in value || 'snippets' in value || 'value' in value || 'values' in value);\n\nconst unknownToString = (value: unknown): string => {\n  if (value === null || value === undefined) return '';\n  if (typeof value === 'string') return value;\n  if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {\n    return String(value);\n  }\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return '';\n  }\n};\n\n/**\n * Resolve the highlight (if any) for a field on a search hit.\n *\n * @param hit        A hit returned by `performSearch`.\n * @param fieldPath  The field name (dot-path for nested fields, e.g. `author.name`).\n * @param fieldValue The hit's raw value for the field (used to align array highlights).\n * @returns `{ html }` for a highlighted snippet, `{ values }` for per-item array\n *          highlights, or `undefined` when the field wasn't matched.\n */\nexport const getHighlightMatch = (\n  hit: SearchHit,\n  fieldPath: string,\n  fieldValue?: unknown\n): HighlightMatch | undefined => {\n  const fieldHighlight = Array.isArray(hit._highlights)\n    ? hit._highlights.find((highlight) => isPlainObject(highlight) && highlight.field === fieldPath)\n    : undefined;\n\n  if (isPlainObject(fieldHighlight)) {\n    const snippets = fieldHighlight.snippets;\n    if (Array.isArray(snippets)) return { html: snippets.map(unknownToString).join(', ') };\n    const snippet = unknownToString(fieldHighlight.snippet);\n    if (snippet) return { html: snippet };\n    const value = unknownToString(fieldHighlight.value);\n    if (value) return { html: value };\n  }\n\n  const highlightValue = fieldPath.split('.').reduce<unknown>((current, pathPart) => {\n    if (!isPlainObject(current)) return undefined;\n    return current[pathPart];\n  }, hit._highlight);\n\n  if (isHighlightLeaf(highlightValue)) {\n    if (Array.isArray(highlightValue.snippets)) {\n      return { html: highlightValue.snippets.map(unknownToString).join(', ') };\n    }\n    const snippet = unknownToString(highlightValue.snippet);\n    if (snippet) return { html: snippet };\n    if (Array.isArray(highlightValue.values)) return { values: highlightValue.values };\n    if ('value' in highlightValue) return { html: unknownToString(highlightValue.value) };\n  }\n\n  if (Array.isArray(fieldValue) && Array.isArray(highlightValue)) {\n    return { values: highlightValue };\n  }\n\n  return undefined;\n};\n"],"mappings":";;;;;;;;;;;;;AAgCA,IAAM,cAAc,OAAyB;AAAA,EAC3C,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,IAAI,YAAY,EAAE;AAAA,EACjE,QAAQ,CAAC;AACX;AAEO,SAAS,mBAAmB,QAA+E;AAChH,QAAM,UAAU,OAAO,OAAO,QAAQ,QAAQ,EAAE;AAChD,SAAO;AAAA,IACL,MAAM,cAAc,QAAQ;AAC1B,YAAM,UAAkC;AAAA,QACtC,gBAAgB;AAAA,MAClB;AACA,UAAI,OAAO,QAAQ;AACjB,gBAAQ,WAAW,IAAI,OAAO;AAAA,MAChC;AAEA,YAAM,OAAO;AAAA,QACX,GAAG;AAAA,QACH,WAAW,OAAO,aAAa,OAAO;AAAA,MACxC;AAEA,UAAI;AACF,cAAM,WAAW,MAAM,MAAM,GAAG,OAAO,eAAe;AAAA,UACpD,QAAQ;AAAA,UACR;AAAA,UACA,MAAM,KAAK,UAAU,IAAI;AAAA,QAC3B,CAAC;AAED,YAAI,CAAC,SAAS,IAAI;AAChB,kBAAQ,MAAM,qBAAqB,SAAS,MAAM,EAAE;AACpD,iBAAO,YAAY;AAAA,QACrB;AAEA,eAAO,SAAS,KAAK;AAAA,MACvB,SAAS,OAAO;AACd,gBAAQ,MAAM,uBAAuB,KAAK;AAC1C,eAAO,YAAY;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AACF;;;AC3DA,IAAM,gBAAgB,CAAC,UACrB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAErE,IAAM,kBAAkB,CAAC,UACvB,cAAc,KAAK,MAClB,aAAa,SAAS,cAAc,SAAS,WAAW,SAAS,YAAY;AAEhF,IAAM,kBAAkB,CAAC,UAA2B;AAClD,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,aAAa,OAAO,UAAU,UAAU;AACxF,WAAO,OAAO,KAAK;AAAA,EACrB;AACA,MAAI;AACF,WAAO,KAAK,UAAU,KAAK;AAAA,EAC7B,SAAQ;AACN,WAAO;AAAA,EACT;AACF;AAWO,IAAM,oBAAoB,CAC/B,KACA,WACA,eAC+B;AAC/B,QAAM,iBAAiB,MAAM,QAAQ,IAAI,WAAW,IAChD,IAAI,YAAY,KAAK,CAAC,cAAc,cAAc,SAAS,KAAK,UAAU,UAAU,SAAS,IAC7F;AAEJ,MAAI,cAAc,cAAc,GAAG;AACjC,UAAM,WAAW,eAAe;AAChC,QAAI,MAAM,QAAQ,QAAQ,EAAG,QAAO,EAAE,MAAM,SAAS,IAAI,eAAe,EAAE,KAAK,IAAI,EAAE;AACrF,UAAM,UAAU,gBAAgB,eAAe,OAAO;AACtD,QAAI,QAAS,QAAO,EAAE,MAAM,QAAQ;AACpC,UAAM,QAAQ,gBAAgB,eAAe,KAAK;AAClD,QAAI,MAAO,QAAO,EAAE,MAAM,MAAM;AAAA,EAClC;AAEA,QAAM,iBAAiB,UAAU,MAAM,GAAG,EAAE,OAAgB,CAAC,SAAS,aAAa;AACjF,QAAI,CAAC,cAAc,OAAO,EAAG,QAAO;AACpC,WAAO,QAAQ,QAAQ;AAAA,EACzB,GAAG,IAAI,UAAU;AAEjB,MAAI,gBAAgB,cAAc,GAAG;AACnC,QAAI,MAAM,QAAQ,eAAe,QAAQ,GAAG;AAC1C,aAAO,EAAE,MAAM,eAAe,SAAS,IAAI,eAAe,EAAE,KAAK,IAAI,EAAE;AAAA,IACzE;AACA,UAAM,UAAU,gBAAgB,eAAe,OAAO;AACtD,QAAI,QAAS,QAAO,EAAE,MAAM,QAAQ;AACpC,QAAI,MAAM,QAAQ,eAAe,MAAM,EAAG,QAAO,EAAE,QAAQ,eAAe,OAAO;AACjF,QAAI,WAAW,eAAgB,QAAO,EAAE,MAAM,gBAAgB,eAAe,KAAK,EAAE;AAAA,EACtF;AAEA,MAAI,MAAM,QAAQ,UAAU,KAAK,MAAM,QAAQ,cAAc,GAAG;AAC9D,WAAO,EAAE,QAAQ,eAAe;AAAA,EAClC;AAEA,SAAO;AACT;","names":[]}

package/dist/react.d.mts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { FC, ReactNode } from 'react';
-import { d as Pagination, f as SearchHit, a as Facets, P as PageSize, F as FacetBy, h as SearchParams, C as CollectionResult, g as SearchItemConfig } from './client-CtTcEJUy.mjs';
+import { d as Pagination, S as SearchHit, a as Facets, P as PageSize, F as FacetBy, h as SearchParams, C as CollectionResult, g as SearchItemConfig } from './client-DOew5kqb.mjs';
 
 interface SearchProviderProps {
     children: ReactNode;
@@ -24,12 +24,21 @@ interface UseSearchReturn {
     pageSize: number;
     setPageSize: (size: number) => void;
     pageSizes: PageSize[];
+    /** Register a component's page-size config (last registration wins). `id` should be
+     *  stable per instance. Used by pagination components that own their config. */
+    registerPageSizes: (id: string, pageSizes: unknown) => void;
+    unregisterPageSizes: (id: string) => void;
     orderByOptions: Array<{
         title: string;
         value: string;
     }>;
     selectedOrderBy: string;
     setOrderBy: (query: string) => void;
+    /** Register a sort component's order-by config (last registration wins). `id` should
+     *  be stable per component instance. Used by sort components that own their config
+     *  (App Router slots) instead of it being passed to the provider. */
+    registerOrderBy: (id: string, orderBy: unknown) => void;
+    unregisterOrderBy: (id: string) => void;
     filterOptions: FacetBy[];
     setFilterOptions: (filters: FacetBy[]) => void;
     /** Additive registration of a single facet option (keyed by fieldKey). Used by facet

package/dist/react.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { FC, ReactNode } from 'react';
-import { d as Pagination, f as SearchHit, a as Facets, P as PageSize, F as FacetBy, h as SearchParams, C as CollectionResult, g as SearchItemConfig } from './client-CtTcEJUy.js';
+import { d as Pagination, S as SearchHit, a as Facets, P as PageSize, F as FacetBy, h as SearchParams, C as CollectionResult, g as SearchItemConfig } from './client-DOew5kqb.js';
 
 interface SearchProviderProps {
     children: ReactNode;
@@ -24,12 +24,21 @@ interface UseSearchReturn {
     pageSize: number;
     setPageSize: (size: number) => void;
     pageSizes: PageSize[];
+    /** Register a component's page-size config (last registration wins). `id` should be
+     *  stable per instance. Used by pagination components that own their config. */
+    registerPageSizes: (id: string, pageSizes: unknown) => void;
+    unregisterPageSizes: (id: string) => void;
     orderByOptions: Array<{
         title: string;
         value: string;
     }>;
     selectedOrderBy: string;
     setOrderBy: (query: string) => void;
+    /** Register a sort component's order-by config (last registration wins). `id` should
+     *  be stable per component instance. Used by sort components that own their config
+     *  (App Router slots) instead of it being passed to the provider. */
+    registerOrderBy: (id: string, orderBy: unknown) => void;
+    unregisterOrderBy: (id: string) => void;
     filterOptions: FacetBy[];
     setFilterOptions: (filters: FacetBy[]) => void;
     /** Additive registration of a single facet option (keyed by fieldKey). Used by facet