OptionaldebounceFetches one page of options; { ok: false } becomes the error state.
OptionalinitialInitial facet selections (facet key → values). Default {}.
OptionalinitialServer-rendered first page, seeding react-query so the list paints
populated instead of pending. react-query scopes initialData to one exact
key, so this applies only to the default view: empty query, first sort
option, no facets. Typing / re-sorting / faceting re-keys and fetches live.
The server that produced it must therefore have called fetchPage with
{ query: "", sort: sortOptions[0].value ?? "", facets: {} }.
Plural noun for the entity, used in error copy (e.g. "customers").
Base react-query key identifying this option source. The debounced query and
active sort are appended internally, so a change to either re-fetches. Two
comboboxes that share a noun but return differently-shaped rows must pass
distinct keys so their caches don't collide.
OptionalsortSort choices; the first is the default. Omit for an unsorted source.
Gap between the last keystroke and the query re-keying. Defaults to DEBOUNCE_MS, which exists to spare the server; pass
0for a client-held source (staticOptionsPage) where there is no round-trip to spare and a debounce only makes a bounded list feel laggier than the plainCommandfiltering it replaces.