@igne-agency/react-web-ui 0.0.0-stage → 0.3.0

package/dist/components/combobox-field/combobox-field.d.ts

@@ -0,0 +1,66 @@
+import type { QueryKey } from "@tanstack/react-query";
+import { type ReactNode } from "react";
+import { type FieldBlurHandler, type FieldProps } from "../field/index.ts";
+import { type ComboboxItems, type ItemQuery } from "./combobox-items.ts";
+import { type ComboboxPopupLabels } from "./combobox-popup-body.tsx";
+import { type ComboboxMode } from "./selection.ts";
+import { type ValueStateLabels } from "./value-state.ts";
+/** Everything a combobox field takes besides its items, its value and how it reads them. */
+export type ComboboxFieldChrome = FieldProps & ComboboxPopupLabels & Readonly<{
+    /** Shown in the control while nothing is chosen. */
+    placeholder?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    /** The form field's name. */
+    name?: string;
+    /** Called when focus leaves the control. */
+    onBlur?: FieldBlurHandler;
+    /** Whether trying a failed load again can help. @default always */
+    retryable?: (error: unknown) => boolean;
+    /** Debounce before a search reaches `onSearchChange`, in ms. @default 300 */
+    searchDelay?: number;
+    /** Applied to the field wrapper, so callers can size the control. */
+    className?: string;
+}>;
+/** How a combobox field reads its items. */
+export type ComboboxDerivations<TItem> = Readonly<{
+    /** A stable identity per item, for keys, selection and form values. */
+    itemKey: (item: TItem) => string;
+    /** An item as plain text: the filter text and its accessible name. @default itemKey */
+    itemToStringLabel?: (item: TItem) => string;
+    /** Renders one item, as a list row and as a chosen value. */
+    children: (item: TItem) => ReactNode;
+}>;
+/**
+ * An `itemQuery` that looks up the values the loaded list does not hold, with
+ * the copy for values it reports gone. Needs `ComboboxItemQueries` above it.
+ */
+export type ComboboxItemLookup<TItem, TData = TItem, TKey extends QueryKey = QueryKey> = Readonly<{
+    itemQuery?: never;
+}> | (Readonly<{
+    itemQuery: ItemQuery<TItem, TData, TKey>;
+}> & ValueStateLabels);
+export type ComboboxFieldProps<TItem, TData = TItem, TKey extends QueryKey = QueryKey> = ComboboxFieldChrome & ComboboxItems<TItem> & ComboboxDerivations<TItem> & ComboboxMode<TItem> & ComboboxItemLookup<TItem, TData, TKey>;
+/**
+ * The assembled combobox: a labelled field whose control shows the selection —
+ * one value, or removable tags under `multiple` — and whose popup holds the
+ * search box and the list. Static `items` are filtered on the client; a paged
+ * `query` is searched on the server, debounced, and loads its next page as the
+ * list nears its end. An `itemQuery` looks up chosen values the list does not
+ * hold, and marks the ones it reports gone.
+ *
+ * @example
+ * <ComboboxField
+ * 	label="Reviewer"
+ * 	optionalLabel="optional"
+ * 	query={reviewersQuery}
+ * 	onSearchChange={setSearch}
+ * 	itemKey={user => user.id}
+ * 	itemToStringLabel={user => user.name}
+ * 	value={reviewer}
+ * 	onValueChange={setReviewer}
+ * 	{...comboboxCopy}>
+ * 	{user => user.name}
+ * </ComboboxField>
+ */
+export declare const ComboboxField: <TItem, TData = TItem, TKey extends QueryKey = QueryKey>(props: ComboboxFieldProps<TItem, TData, TKey>) => ReactNode;

package/dist/components/combobox-field/combobox-field.js

@@ -0,0 +1,527 @@
+import { Field } from "../field/field.js";
+import { fieldStateAttributes } from "../field/field-state.js";
+import { useFieldState } from "../field/use-field-state.js";
+import { detachHiddenInput } from "../field/hidden-input.js";
+import { Combobox } from "./combobox.js";
+import { itemsOf, loadOf, pagedProgress } from "./combobox-items.js";
+import { ComboboxPopupBody } from "./combobox-popup-body.js";
+import { ItemLookupsContext } from "./item-lookups.js";
+import { defaultValues, emitValues, selectedValues } from "./selection.js";
+import { valueStateOf } from "./value-state.js";
+import { ValueStateView, ValueStatesStatus, valueStateName } from "./value-state-view.js";
+import { c } from "react/compiler-runtime";
+import { use, useEffect, useRef, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+// src/components/combobox-field/combobox-field.tsx
+var DEFAULT_SEARCH_DELAY = 300;
+var alwaysRetryable = () => true;
+var FieldBody = (t0) => {
+	const $ = c(112);
+	const { chrome, source, derivations, mode, labels, values, states, onChange } = t0;
+	const { label, description, errors, requiredness, optionalLabel, dirty, touched, pending: t1, placeholder, readOnly, name, onBlur, retryable: t2, searchDelay: t3, className } = chrome;
+	const pending = t1 === void 0 ? false : t1;
+	const retryable = t2 === void 0 ? alwaysRetryable : t2;
+	const searchDelay = t3 === void 0 ? DEFAULT_SEARCH_DELAY : t3;
+	const { itemKey, children: renderItem } = derivations;
+	const itemLabel = derivations.itemToStringLabel ?? itemKey;
+	const ids = Field.useIds();
+	const anchorRef = useRef(null);
+	let t4;
+	if ($[0] !== source) {
+		t4 = itemsOf(source);
+		$[0] = source;
+		$[1] = t4;
+	} else t4 = $[1];
+	const items = t4;
+	let t5;
+	if ($[2] !== retryable || $[3] !== source) {
+		t5 = loadOf(source, retryable);
+		$[2] = retryable;
+		$[3] = source;
+		$[4] = t5;
+	} else t5 = $[4];
+	const load = t5;
+	const t6 = values.length > 0;
+	let t7;
+	if ($[5] !== chrome.disabled || $[6] !== dirty || $[7] !== errors || $[8] !== pending || $[9] !== readOnly || $[10] !== requiredness || $[11] !== t6 || $[12] !== touched) {
+		t7 = {
+			errors,
+			requiredness,
+			dirty,
+			touched,
+			pending,
+			disabled: chrome.disabled,
+			readOnly,
+			filled: t6
+		};
+		$[5] = chrome.disabled;
+		$[6] = dirty;
+		$[7] = errors;
+		$[8] = pending;
+		$[9] = readOnly;
+		$[10] = requiredness;
+		$[11] = t6;
+		$[12] = touched;
+		$[13] = t7;
+	} else t7 = $[13];
+	const field = useFieldState(t7);
+	const { disabled } = field;
+	const [search, setSearch] = useState("");
+	const searchTimer = useRef(void 0);
+	let t8;
+	let t9;
+	if ($[14] === Symbol.for("react.memo_cache_sentinel")) {
+		t8 = () => () => clearTimeout(searchTimer.current);
+		t9 = [];
+		$[14] = t8;
+		$[15] = t9;
+	} else {
+		t8 = $[14];
+		t9 = $[15];
+	}
+	useEffect(t8, t9);
+	let t10;
+	if ($[16] !== source) {
+		t10 = (text, delay) => {
+			const { onSearchChange } = source;
+			if (onSearchChange === void 0) return;
+			clearTimeout(searchTimer.current);
+			searchTimer.current = setTimeout(() => onSearchChange(text), delay);
+		};
+		$[16] = source;
+		$[17] = t10;
+	} else t10 = $[17];
+	const searchServer = t10;
+	const t11 = field.state.pending === true || load.status === "pending";
+	let t12;
+	if ($[18] !== field.state || $[19] !== t11) {
+		t12 = {
+			...field.state,
+			pending: t11
+		};
+		$[18] = field.state;
+		$[19] = t11;
+		$[20] = t12;
+	} else t12 = $[20];
+	const fieldState = t12;
+	let t13;
+	if ($[21] !== itemLabel || $[22] !== labels) {
+		t13 = (state) => valueStateName(state, itemLabel, labels);
+		$[21] = itemLabel;
+		$[22] = labels;
+		$[23] = t13;
+	} else t13 = $[23];
+	const nameOf = t13;
+	let t14;
+	if ($[24] !== itemLabel || $[25] !== labels || $[26] !== renderItem) {
+		t14 = (state_0) => /* @__PURE__ */ jsx(ValueStateView, {
+			state: state_0,
+			renderItem,
+			itemLabel,
+			labels
+		});
+		$[24] = itemLabel;
+		$[25] = labels;
+		$[26] = renderItem;
+		$[27] = t14;
+	} else t14 = $[27];
+	const view = t14;
+	const [first] = states;
+	const t15 = source.query === void 0 ? void 0 : null;
+	let t16;
+	if ($[28] !== itemKey) {
+		t16 = (item, value) => itemKey(item) === itemKey(value);
+		$[28] = itemKey;
+		$[29] = t16;
+	} else t16 = $[29];
+	const t17 = name ?? ids.controlId;
+	let t18;
+	if ($[30] !== readOnly) {
+		t18 = readOnly === true && { open: false };
+		$[30] = readOnly;
+		$[31] = t18;
+	} else t18 = $[31];
+	const t19 = requiredness === "required";
+	let t20;
+	if ($[32] !== searchDelay || $[33] !== searchServer) {
+		t20 = (next, details) => {
+			if (details.reason === "input-change") {
+				setSearch(next);
+				searchServer(next, searchDelay);
+			}
+		};
+		$[32] = searchDelay;
+		$[33] = searchServer;
+		$[34] = t20;
+	} else t20 = $[34];
+	let t21;
+	if ($[35] !== searchServer) {
+		t21 = (open) => {
+			if (!open) {
+				setSearch("");
+				searchServer("", 0);
+			}
+		};
+		$[35] = searchServer;
+		$[36] = t21;
+	} else t21 = $[36];
+	let t22;
+	if ($[37] !== disabled || $[38] !== itemKey || $[39] !== itemLabel || $[40] !== items || $[41] !== readOnly || $[42] !== t15 || $[43] !== t16 || $[44] !== t17 || $[45] !== t18 || $[46] !== t19 || $[47] !== t20 || $[48] !== t21) {
+		t22 = {
+			items,
+			filter: t15,
+			itemToStringLabel: itemLabel,
+			itemToStringValue: itemKey,
+			isItemEqualToValue: t16,
+			name: t17,
+			inputRef: detachHiddenInput,
+			disabled,
+			readOnly,
+			...t18,
+			required: t19,
+			onInputValueChange: t20,
+			onOpenChangeComplete: t21
+		};
+		$[37] = disabled;
+		$[38] = itemKey;
+		$[39] = itemLabel;
+		$[40] = items;
+		$[41] = readOnly;
+		$[42] = t15;
+		$[43] = t16;
+		$[44] = t17;
+		$[45] = t18;
+		$[46] = t19;
+		$[47] = t20;
+		$[48] = t21;
+		$[49] = t22;
+	} else t22 = $[49];
+	const root = t22;
+	let t23;
+	if ($[50] !== label || $[51] !== optionalLabel || $[52] !== requiredness) {
+		t23 = /* @__PURE__ */ jsx(Field.Label, {
+			requiredness,
+			optionalLabel,
+			children: label
+		});
+		$[50] = label;
+		$[51] = optionalLabel;
+		$[52] = requiredness;
+		$[53] = t23;
+	} else t23 = $[53];
+	let t24;
+	if ($[54] !== disabled || $[55] !== fieldState || $[56] !== first || $[57] !== itemKey || $[58] !== mode || $[59] !== nameOf || $[60] !== onBlur || $[61] !== onChange || $[62] !== placeholder || $[63] !== readOnly || $[64] !== states || $[65] !== values || $[66] !== view) {
+		t24 = mode.multiple === true ? /* @__PURE__ */ jsx(Combobox.Control, {
+			ref: anchorRef,
+			state: fieldState,
+			onBlur,
+			tags: first === void 0 ? /* @__PURE__ */ jsx("span", {
+				"aria-hidden": "true",
+				children: placeholder
+			}) : /* @__PURE__ */ jsx(Combobox.Tags, {
+				label: mode.selectedLabel,
+				items: states,
+				itemKey: _temp,
+				itemLabel: nameOf,
+				removeLabel: mode.removeLabel,
+				removeHint: (state_2) => mode.removeHint(nameOf(state_2)),
+				disabled,
+				readOnly,
+				onRemove: (remaining) => {
+					const kept = new Set(remaining.map(_temp2));
+					onChange(values.filter((value_0) => kept.has(itemKey(value_0))));
+				},
+				children: view
+			}),
+			children: first === void 0 ? placeholder : states.map(nameOf).join(", ")
+		}) : /* @__PURE__ */ jsx(Combobox.Control, {
+			ref: anchorRef,
+			state: fieldState,
+			onBlur,
+			children: first === void 0 ? placeholder : view(first)
+		});
+		$[54] = disabled;
+		$[55] = fieldState;
+		$[56] = first;
+		$[57] = itemKey;
+		$[58] = mode;
+		$[59] = nameOf;
+		$[60] = onBlur;
+		$[61] = onChange;
+		$[62] = placeholder;
+		$[63] = readOnly;
+		$[64] = states;
+		$[65] = values;
+		$[66] = view;
+		$[67] = t24;
+	} else t24 = $[67];
+	let t25;
+	if ($[68] !== source) {
+		t25 = pagedProgress(source);
+		$[68] = source;
+		$[69] = t25;
+	} else t25 = $[69];
+	const t26 = source.query === void 0 ? items.length === 0 : search === "";
+	const t27 = mode.multiple === true;
+	let t28;
+	if ($[70] !== chrome || $[71] !== itemKey || $[72] !== load || $[73] !== renderItem || $[74] !== source.query || $[75] !== t25 || $[76] !== t26 || $[77] !== t27) {
+		t28 = /* @__PURE__ */ jsx(ComboboxPopupBody, {
+			copy: chrome,
+			load,
+			paged: t25,
+			pagedQuery: source.query,
+			noOptions: t26,
+			multiple: t27,
+			itemKey,
+			renderItem
+		});
+		$[70] = chrome;
+		$[71] = itemKey;
+		$[72] = load;
+		$[73] = renderItem;
+		$[74] = source.query;
+		$[75] = t25;
+		$[76] = t26;
+		$[77] = t27;
+		$[78] = t28;
+	} else t28 = $[78];
+	let t29;
+	if ($[79] !== label || $[80] !== t28) {
+		t29 = /* @__PURE__ */ jsx(Combobox.Portal, { children: /* @__PURE__ */ jsx(Combobox.Positioner, {
+			anchor: anchorRef,
+			children: /* @__PURE__ */ jsx(Combobox.Popup, {
+				"aria-label": label,
+				children: t28
+			})
+		}) });
+		$[79] = label;
+		$[80] = t28;
+		$[81] = t29;
+	} else t29 = $[81];
+	let t30;
+	if ($[82] !== labels || $[83] !== states) {
+		t30 = labels !== void 0 && /* @__PURE__ */ jsx(ValueStatesStatus, {
+			states,
+			labels
+		});
+		$[82] = labels;
+		$[83] = states;
+		$[84] = t30;
+	} else t30 = $[84];
+	let t31;
+	if ($[85] !== description) {
+		t31 = /* @__PURE__ */ jsx(Field.Description, { children: description });
+		$[85] = description;
+		$[86] = t31;
+	} else t31 = $[86];
+	let t32;
+	if ($[87] !== errors) {
+		t32 = /* @__PURE__ */ jsx(Field.Error, { children: errors });
+		$[87] = errors;
+		$[88] = t32;
+	} else t32 = $[88];
+	let t33;
+	if ($[89] !== t23 || $[90] !== t24 || $[91] !== t29 || $[92] !== t30 || $[93] !== t31 || $[94] !== t32) {
+		t33 = /* @__PURE__ */ jsxs(Fragment$1, { children: [
+			t23,
+			t24,
+			t29,
+			t30,
+			t31,
+			t32
+		] });
+		$[89] = t23;
+		$[90] = t24;
+		$[91] = t29;
+		$[92] = t30;
+		$[93] = t31;
+		$[94] = t32;
+		$[95] = t33;
+	} else t33 = $[95];
+	const parts = t33;
+	const t34 = field.invalid;
+	let t35;
+	if ($[96] !== fieldState) {
+		t35 = fieldStateAttributes(fieldState);
+		$[96] = fieldState;
+		$[97] = t35;
+	} else t35 = $[97];
+	let t36;
+	if ($[98] !== mode.multiple || $[99] !== onChange || $[100] !== parts || $[101] !== root || $[102] !== values) {
+		t36 = mode.multiple === true ? /* @__PURE__ */ jsx(Combobox.Root, {
+			...root,
+			multiple: true,
+			value: [...values],
+			onValueChange: (next_0) => onChange(next_0),
+			children: parts
+		}) : /* @__PURE__ */ jsx(Combobox.Root, {
+			...root,
+			value: values.at(0) ?? null,
+			onValueChange: (next_1) => onChange(next_1 === null ? [] : [next_1]),
+			children: parts
+		});
+		$[98] = mode.multiple;
+		$[99] = onChange;
+		$[100] = parts;
+		$[101] = root;
+		$[102] = values;
+		$[103] = t36;
+	} else t36 = $[103];
+	let t37;
+	if ($[104] !== className || $[105] !== dirty || $[106] !== disabled || $[107] !== field.invalid || $[108] !== t35 || $[109] !== t36 || $[110] !== touched) {
+		t37 = /* @__PURE__ */ jsx(Field.Root, {
+			className,
+			disabled,
+			invalid: t34,
+			dirty,
+			touched,
+			...t35,
+			children: t36
+		});
+		$[104] = className;
+		$[105] = dirty;
+		$[106] = disabled;
+		$[107] = field.invalid;
+		$[108] = t35;
+		$[109] = t36;
+		$[110] = touched;
+		$[111] = t37;
+	} else t37 = $[111];
+	return t37;
+};
+/**
+* The assembled combobox: a labelled field whose control shows the selection —
+* one value, or removable tags under `multiple` — and whose popup holds the
+* search box and the list. Static `items` are filtered on the client; a paged
+* `query` is searched on the server, debounced, and loads its next page as the
+* list nears its end. An `itemQuery` looks up chosen values the list does not
+* hold, and marks the ones it reports gone.
+*
+* @example
+* <ComboboxField
+* 	label="Reviewer"
+* 	optionalLabel="optional"
+* 	query={reviewersQuery}
+* 	onSearchChange={setSearch}
+* 	itemKey={user => user.id}
+* 	itemToStringLabel={user => user.name}
+* 	value={reviewer}
+* 	onValueChange={setReviewer}
+* 	{...comboboxCopy}>
+* 	{user => user.name}
+* </ComboboxField>
+*/
+var ComboboxField = (props) => {
+	const $ = c(21);
+	const { itemKey } = props;
+	const Lookups = use(ItemLookupsContext);
+	let t0;
+	if ($[0] !== props) {
+		t0 = () => defaultValues(props);
+		$[0] = props;
+		$[1] = t0;
+	} else t0 = $[1];
+	const [own, setOwn] = useState(t0);
+	const [picked, setPicked] = useState(_temp3);
+	let asked;
+	let body;
+	let statesOf;
+	let t1;
+	if ($[2] !== itemKey || $[3] !== own || $[4] !== picked || $[5] !== props) {
+		t1 = Symbol.for("react.early_return_sentinel");
+		bb0: {
+			const values = selectedValues(props) ?? own;
+			let t2;
+			if ($[10] !== itemKey) {
+				t2 = (item) => [itemKey(item), item];
+				$[10] = itemKey;
+				$[11] = t2;
+			} else t2 = $[11];
+			const listed = new Map(itemsOf(props).map(t2));
+			const retryable = props.retryable ?? alwaysRetryable;
+			asked = values.map(itemKey).filter((key) => !picked.has(key) && !listed.has(key));
+			const change = (next) => {
+				const added = next.map(itemKey).filter((key_0) => !values.some((value) => itemKey(value) === key_0));
+				if (added.length > 0) setPicked(/* @__PURE__ */ new Set([...picked, ...added]));
+				setOwn(next);
+				emitValues(props, next);
+			};
+			statesOf = (lookups) => {
+				const lookupOf = new Map(asked.map((key_1, index) => [key_1, lookups[index]]));
+				return values.map((item_0) => {
+					const key_2 = itemKey(item_0);
+					return valueStateOf({
+						key: key_2,
+						item: item_0,
+						picked: picked.has(key_2),
+						listed: listed.get(key_2),
+						lookup: lookupOf.get(key_2),
+						retryable
+					});
+				});
+			};
+			body = (states, labels) => /* @__PURE__ */ jsx(FieldBody, {
+				chrome: props,
+				source: props,
+				derivations: props,
+				mode: props,
+				labels,
+				values,
+				states,
+				onChange: change
+			});
+			if (props.itemQuery === void 0) {
+				t1 = body(statesOf([]), void 0);
+				break bb0;
+			}
+		}
+		$[2] = itemKey;
+		$[3] = own;
+		$[4] = picked;
+		$[5] = props;
+		$[6] = asked;
+		$[7] = body;
+		$[8] = statesOf;
+		$[9] = t1;
+	} else {
+		asked = $[6];
+		body = $[7];
+		statesOf = $[8];
+		t1 = $[9];
+	}
+	if (t1 !== Symbol.for("react.early_return_sentinel")) return t1;
+	if (Lookups === null) throw new Error("A ComboboxField with an itemQuery needs a <ComboboxItemQueries> above it.");
+	const labels_0 = props;
+	let t2;
+	if ($[12] !== body || $[13] !== labels_0 || $[14] !== statesOf) {
+		t2 = (lookups_0) => body(statesOf(lookups_0), labels_0);
+		$[12] = body;
+		$[13] = labels_0;
+		$[14] = statesOf;
+		$[15] = t2;
+	} else t2 = $[15];
+	let t3;
+	if ($[16] !== Lookups || $[17] !== asked || $[18] !== props.itemQuery || $[19] !== t2) {
+		t3 = /* @__PURE__ */ jsx(Lookups, {
+			keys: asked,
+			itemQuery: props.itemQuery,
+			children: t2
+		});
+		$[16] = Lookups;
+		$[17] = asked;
+		$[18] = props.itemQuery;
+		$[19] = t2;
+		$[20] = t3;
+	} else t3 = $[20];
+	return t3;
+};
+function _temp(state_1) {
+	return state_1.key;
+}
+function _temp2(state_3) {
+	return state_3.key;
+}
+function _temp3() {
+	return /* @__PURE__ */ new Set();
+}
+export { ComboboxField };

package/dist/components/combobox-field/combobox-items.d.ts

@@ -0,0 +1,80 @@
+import type { DefaultError, QueryKey, UseQueryOptions } from "@tanstack/react-query";
+import { type OptionsLoad } from "../field/index.ts";
+type Page<TItem> = Readonly<{
+    items?: readonly TItem[] | null;
+    totalCount?: number;
+}>;
+/**
+ * A query searched and paged on the server. A `useInfiniteQuery` result over
+ * paginated lists fits.
+ *
+ * @example
+ * const query: PagedQuery<Client> = useInfiniteQuery(clientsQuery(search));
+ */
+export type PagedQuery<TItem> = Readonly<{
+    data: Readonly<{
+        pages: readonly Page<TItem>[];
+    }> | undefined;
+    error: unknown;
+    isFetching: boolean;
+    refetch: () => Promise<unknown>;
+    hasNextPage: boolean;
+    isFetchingNextPage: boolean;
+    fetchNextPage: () => Promise<unknown>;
+}>;
+/**
+ * The query options for one item by its key, such as a generated
+ * `getApiUsersByUserIdOptions`.
+ *
+ * @example
+ * itemQuery: userId => getApiUsersByUserIdOptions({ path: { userId } })
+ */
+export type ItemQuery<TItem, TData = TItem, TKey extends QueryKey = QueryKey> = (key: string) => UseQueryOptions<TData, DefaultError, TItem, TKey>;
+/**
+ * Where a combobox's items come from: a list filtered on the client, with the
+ * load of the query it came from, or a paged query searched on the server.
+ *
+ * @example
+ * const source: ComboboxItems<Client> = { query, onSearchChange: setSearch };
+ */
+export type ComboboxItems<TItem> = Readonly<{
+    items: readonly TItem[];
+    /** How far `items` have loaded, when they come from a query. */
+    load?: OptionsLoad;
+    query?: never;
+    onSearchChange?: never;
+}> | Readonly<{
+    /** The paged query, searched on the server. */
+    query: PagedQuery<TItem>;
+    /** Hands the debounced search text on to the query. */
+    onSearchChange: (search: string) => void;
+    items?: never;
+    load?: never;
+}>;
+/** How far a paged query has got: its match count, and whether it fetches another page. */
+export type PagedProgress = Readonly<{
+    totalCount: number | undefined;
+    isFetchingNextPage: boolean;
+}>;
+/**
+ * The items of a source, as far as they have loaded.
+ *
+ * @example
+ * itemsOf({ items: ["a", "b"] }); // ["a", "b"]
+ */
+export declare const itemsOf: <TItem>(source: ComboboxItems<TItem>) => readonly TItem[];
+/**
+ * The load of a source: a list's own `load`, or the paged query's.
+ *
+ * @example
+ * loadOf({ items: statuses }, () => true); // { status: "success" }
+ */
+export declare const loadOf: <TItem>(source: ComboboxItems<TItem>, retryable: (error: unknown) => boolean) => OptionsLoad;
+/**
+ * A paged query's progress once it holds data, else nothing.
+ *
+ * @example
+ * pagedProgress({ items: statuses }); // undefined
+ */
+export declare const pagedProgress: <TItem>(source: ComboboxItems<TItem>) => PagedProgress | undefined;
+export {};

package/dist/components/combobox-field/combobox-items.js

@@ -0,0 +1,27 @@
+import { OPTIONS_LOADED, optionsLoad } from "../field/options-load.js";
+// src/components/combobox-field/combobox-items.ts
+/**
+* The items of a source, as far as they have loaded.
+*
+* @example
+* itemsOf({ items: ["a", "b"] }); // ["a", "b"]
+*/
+var itemsOf = (source) => source.query === void 0 ? source.items : source.query.data?.pages.flatMap((page) => page.items ?? []) ?? [];
+/**
+* The load of a source: a list's own `load`, or the paged query's.
+*
+* @example
+* loadOf({ items: statuses }, () => true); // { status: "success" }
+*/
+var loadOf = (source, retryable) => source.query === void 0 ? source.load ?? OPTIONS_LOADED : optionsLoad(source.query, retryable);
+/**
+* A paged query's progress once it holds data, else nothing.
+*
+* @example
+* pagedProgress({ items: statuses }); // undefined
+*/
+var pagedProgress = (source) => source.query?.data === void 0 ? void 0 : {
+	totalCount: source.query.data.pages.at(0)?.totalCount,
+	isFetchingNextPage: source.query.isFetchingNextPage
+};
+export { itemsOf, loadOf, pagedProgress };