@maanlamp/react-web-ui 0.0.0-stage → 0.1.0

package/dist/components/collapsible/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/collapsible/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/components/collapsible/index.js

@@ -0,0 +1 @@
+export { Collapsible } from "./collapsible.js";

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

@@ -0,0 +1,67 @@
+import type { QueryKey } from "@tanstack/react-query";
+import { type FocusEventHandler, type ReactNode } from "react";
+import { 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?: FocusEventHandler<HTMLDivElement>;
+    /** 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;
+//# sourceMappingURL=combobox-field.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"combobox-field.d.ts","sourceRoot":"","sources":["../../../src/components/combobox-field/combobox-field.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,SAAS,EAKd,MAAM,OAAO,CAAC;AAGf,OAAO,EAGN,KAAK,UAAU,EAGf,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,SAAS,EAId,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEN,KAAK,mBAAmB,EACxB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACN,KAAK,YAAY,EAIjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAGN,KAAK,gBAAgB,EAErB,MAAM,kBAAkB,CAAC;AAW1B,4FAA4F;AAC5F,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAC3C,mBAAmB,GACnB,QAAQ,CAAC;IACR,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,CAAC,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAC3C,mEAAmE;IACnE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACxC,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEJ,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,CAAC,KAAK,IAAI,QAAQ,CAAC;IACjD,uEAAuE;IACvE,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC;IACjC,uFAAuF;IACvF,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC;IAC5C,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC;CACrC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAC7B,KAAK,EACL,KAAK,GAAG,KAAK,EACb,IAAI,SAAS,QAAQ,GAAG,QAAQ,IAE9B,QAAQ,CAAC;IAAE,SAAS,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,GAC/B,CAAC,QAAQ,CAAC;IACV,SAAS,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;CACxC,CAAC,GACF,gBAAgB,CAAC,CAAC;AAErB,MAAM,MAAM,kBAAkB,CAC7B,KAAK,EACL,KAAK,GAAG,KAAK,EACb,IAAI,SAAS,QAAQ,GAAG,QAAQ,IAC7B,mBAAmB,GACtB,aAAa,CAAC,KAAK,CAAC,GACpB,mBAAmB,CAAC,KAAK,CAAC,GAC1B,YAAY,CAAC,KAAK,CAAC,GACnB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AAkPxC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,aAAa,GACzB,KAAK,EACL,KAAK,GAAG,KAAK,EACb,IAAI,SAAS,QAAQ,GAAG,QAAQ,SAEzB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAC3C,SAkFF,CAAC"}

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

@@ -0,0 +1,532 @@
+import { normalizeFieldErrors } from "../../lib/forms/errors.js";
+import { useBusyPhase } from "../../lib/hooks/use-busy-phase.js";
+import { detachHiddenInput } from "../field/hidden-input.js";
+import { Field } from "../field/field.js";
+import { fieldStateAttributes } from "../field/field-state.js";
+import { useFormDisabled } from "../form/form-context.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(113);
+	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);
+	const formDisabled = useFormDisabled();
+	const disabled = chrome.disabled === true || formDisabled;
+	let t4;
+	if ($[0] !== pending) {
+		t4 = { busy: pending };
+		$[0] = pending;
+		$[1] = t4;
+	} else t4 = $[1];
+	const phase = useBusyPhase(t4);
+	let t5;
+	if ($[2] !== errors) {
+		t5 = normalizeFieldErrors(errors);
+		$[2] = errors;
+		$[3] = t5;
+	} else t5 = $[3];
+	const invalid = t5.length > 0;
+	let t6;
+	if ($[4] !== source) {
+		t6 = itemsOf(source);
+		$[4] = source;
+		$[5] = t6;
+	} else t6 = $[5];
+	const items = t6;
+	let t7;
+	if ($[6] !== retryable || $[7] !== source) {
+		t7 = loadOf(source, retryable);
+		$[6] = retryable;
+		$[7] = source;
+		$[8] = t7;
+	} else t7 = $[8];
+	const load = t7;
+	const [search, setSearch] = useState("");
+	const searchTimer = useRef(void 0);
+	let t8;
+	let t9;
+	if ($[9] === Symbol.for("react.memo_cache_sentinel")) {
+		t8 = () => () => clearTimeout(searchTimer.current);
+		t9 = [];
+		$[9] = t8;
+		$[10] = t9;
+	} else {
+		t8 = $[9];
+		t9 = $[10];
+	}
+	useEffect(t8, t9);
+	let t10;
+	if ($[11] !== source) {
+		t10 = (text, delay) => {
+			const { onSearchChange } = source;
+			if (onSearchChange === void 0) return;
+			clearTimeout(searchTimer.current);
+			searchTimer.current = setTimeout(() => onSearchChange(text), delay);
+		};
+		$[11] = source;
+		$[12] = t10;
+	} else t10 = $[12];
+	const searchServer = t10;
+	const t11 = values.length > 0;
+	const t12 = phase !== "fresh" || load.status === "pending";
+	let t13;
+	if ($[13] !== dirty || $[14] !== disabled || $[15] !== invalid || $[16] !== readOnly || $[17] !== requiredness || $[18] !== t11 || $[19] !== t12 || $[20] !== touched) {
+		t13 = {
+			disabled,
+			readonly: readOnly,
+			requiredness,
+			invalid,
+			dirty,
+			touched,
+			filled: t11,
+			pending: t12
+		};
+		$[13] = dirty;
+		$[14] = disabled;
+		$[15] = invalid;
+		$[16] = readOnly;
+		$[17] = requiredness;
+		$[18] = t11;
+		$[19] = t12;
+		$[20] = touched;
+		$[21] = t13;
+	} else t13 = $[21];
+	const fieldState = t13;
+	let t14;
+	if ($[22] !== itemLabel || $[23] !== labels) {
+		t14 = (state) => valueStateName(state, itemLabel, labels);
+		$[22] = itemLabel;
+		$[23] = labels;
+		$[24] = t14;
+	} else t14 = $[24];
+	const nameOf = t14;
+	let t15;
+	if ($[25] !== itemLabel || $[26] !== labels || $[27] !== renderItem) {
+		t15 = (state_0) => /* @__PURE__ */ jsx(ValueStateView, {
+			state: state_0,
+			renderItem,
+			itemLabel,
+			labels
+		});
+		$[25] = itemLabel;
+		$[26] = labels;
+		$[27] = renderItem;
+		$[28] = t15;
+	} else t15 = $[28];
+	const view = t15;
+	const [first] = states;
+	const t16 = source.query === void 0 ? void 0 : null;
+	let t17;
+	if ($[29] !== itemKey) {
+		t17 = (item, value) => itemKey(item) === itemKey(value);
+		$[29] = itemKey;
+		$[30] = t17;
+	} else t17 = $[30];
+	const t18 = name ?? ids.controlId;
+	let t19;
+	if ($[31] !== readOnly) {
+		t19 = readOnly === true && { open: false };
+		$[31] = readOnly;
+		$[32] = t19;
+	} else t19 = $[32];
+	const t20 = requiredness === "required";
+	let t21;
+	if ($[33] !== searchDelay || $[34] !== searchServer) {
+		t21 = (next, details) => {
+			if (details.reason === "input-change") {
+				setSearch(next);
+				searchServer(next, searchDelay);
+			}
+		};
+		$[33] = searchDelay;
+		$[34] = searchServer;
+		$[35] = t21;
+	} else t21 = $[35];
+	let t22;
+	if ($[36] !== searchServer) {
+		t22 = (open) => {
+			if (!open) {
+				setSearch("");
+				searchServer("", 0);
+			}
+		};
+		$[36] = searchServer;
+		$[37] = t22;
+	} else t22 = $[37];
+	let t23;
+	if ($[38] !== disabled || $[39] !== itemKey || $[40] !== itemLabel || $[41] !== items || $[42] !== readOnly || $[43] !== t16 || $[44] !== t17 || $[45] !== t18 || $[46] !== t19 || $[47] !== t20 || $[48] !== t21 || $[49] !== t22) {
+		t23 = {
+			items,
+			filter: t16,
+			itemToStringLabel: itemLabel,
+			itemToStringValue: itemKey,
+			isItemEqualToValue: t17,
+			name: t18,
+			inputRef: detachHiddenInput,
+			disabled,
+			readOnly,
+			...t19,
+			required: t20,
+			onInputValueChange: t21,
+			onOpenChangeComplete: t22
+		};
+		$[38] = disabled;
+		$[39] = itemKey;
+		$[40] = itemLabel;
+		$[41] = items;
+		$[42] = readOnly;
+		$[43] = t16;
+		$[44] = t17;
+		$[45] = t18;
+		$[46] = t19;
+		$[47] = t20;
+		$[48] = t21;
+		$[49] = t22;
+		$[50] = t23;
+	} else t23 = $[50];
+	const root = t23;
+	let t24;
+	if ($[51] !== label || $[52] !== optionalLabel || $[53] !== requiredness) {
+		t24 = /* @__PURE__ */ jsx(Field.Label, {
+			requiredness,
+			optionalLabel,
+			children: label
+		});
+		$[51] = label;
+		$[52] = optionalLabel;
+		$[53] = requiredness;
+		$[54] = t24;
+	} else t24 = $[54];
+	let t25;
+	if ($[55] !== disabled || $[56] !== fieldState || $[57] !== first || $[58] !== itemKey || $[59] !== mode || $[60] !== nameOf || $[61] !== onBlur || $[62] !== onChange || $[63] !== placeholder || $[64] !== readOnly || $[65] !== states || $[66] !== values || $[67] !== view) {
+		t25 = 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)
+		});
+		$[55] = disabled;
+		$[56] = fieldState;
+		$[57] = first;
+		$[58] = itemKey;
+		$[59] = mode;
+		$[60] = nameOf;
+		$[61] = onBlur;
+		$[62] = onChange;
+		$[63] = placeholder;
+		$[64] = readOnly;
+		$[65] = states;
+		$[66] = values;
+		$[67] = view;
+		$[68] = t25;
+	} else t25 = $[68];
+	let t26;
+	if ($[69] !== source) {
+		t26 = pagedProgress(source);
+		$[69] = source;
+		$[70] = t26;
+	} else t26 = $[70];
+	const t27 = source.query === void 0 ? items.length === 0 : search === "";
+	const t28 = mode.multiple === true;
+	let t29;
+	if ($[71] !== chrome || $[72] !== itemKey || $[73] !== load || $[74] !== renderItem || $[75] !== source.query || $[76] !== t26 || $[77] !== t27 || $[78] !== t28) {
+		t29 = /* @__PURE__ */ jsx(ComboboxPopupBody, {
+			copy: chrome,
+			load,
+			paged: t26,
+			pagedQuery: source.query,
+			noOptions: t27,
+			multiple: t28,
+			itemKey,
+			renderItem
+		});
+		$[71] = chrome;
+		$[72] = itemKey;
+		$[73] = load;
+		$[74] = renderItem;
+		$[75] = source.query;
+		$[76] = t26;
+		$[77] = t27;
+		$[78] = t28;
+		$[79] = t29;
+	} else t29 = $[79];
+	let t30;
+	if ($[80] !== label || $[81] !== t29) {
+		t30 = /* @__PURE__ */ jsx(Combobox.Portal, { children: /* @__PURE__ */ jsx(Combobox.Positioner, {
+			anchor: anchorRef,
+			children: /* @__PURE__ */ jsx(Combobox.Popup, {
+				"aria-label": label,
+				children: t29
+			})
+		}) });
+		$[80] = label;
+		$[81] = t29;
+		$[82] = t30;
+	} else t30 = $[82];
+	let t31;
+	if ($[83] !== labels || $[84] !== states) {
+		t31 = labels !== void 0 && /* @__PURE__ */ jsx(ValueStatesStatus, {
+			states,
+			labels
+		});
+		$[83] = labels;
+		$[84] = states;
+		$[85] = t31;
+	} else t31 = $[85];
+	let t32;
+	if ($[86] !== description) {
+		t32 = /* @__PURE__ */ jsx(Field.Description, { children: description });
+		$[86] = description;
+		$[87] = t32;
+	} else t32 = $[87];
+	let t33;
+	if ($[88] !== errors) {
+		t33 = /* @__PURE__ */ jsx(Field.Error, { children: errors });
+		$[88] = errors;
+		$[89] = t33;
+	} else t33 = $[89];
+	let t34;
+	if ($[90] !== t24 || $[91] !== t25 || $[92] !== t30 || $[93] !== t31 || $[94] !== t32 || $[95] !== t33) {
+		t34 = /* @__PURE__ */ jsxs(Fragment$1, { children: [
+			t24,
+			t25,
+			t30,
+			t31,
+			t32,
+			t33
+		] });
+		$[90] = t24;
+		$[91] = t25;
+		$[92] = t30;
+		$[93] = t31;
+		$[94] = t32;
+		$[95] = t33;
+		$[96] = t34;
+	} else t34 = $[96];
+	const parts = t34;
+	let t35;
+	if ($[97] !== fieldState) {
+		t35 = fieldStateAttributes(fieldState);
+		$[97] = fieldState;
+		$[98] = t35;
+	} else t35 = $[98];
+	let t36;
+	if ($[99] !== mode.multiple || $[100] !== onChange || $[101] !== parts || $[102] !== root || $[103] !== 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
+		});
+		$[99] = mode.multiple;
+		$[100] = onChange;
+		$[101] = parts;
+		$[102] = root;
+		$[103] = values;
+		$[104] = t36;
+	} else t36 = $[104];
+	let t37;
+	if ($[105] !== className || $[106] !== dirty || $[107] !== disabled || $[108] !== invalid || $[109] !== t35 || $[110] !== t36 || $[111] !== touched) {
+		t37 = /* @__PURE__ */ jsx(Field.Root, {
+			className,
+			disabled,
+			invalid,
+			dirty,
+			touched,
+			...t35,
+			children: t36
+		});
+		$[105] = className;
+		$[106] = dirty;
+		$[107] = disabled;
+		$[108] = invalid;
+		$[109] = t35;
+		$[110] = t36;
+		$[111] = touched;
+		$[112] = t37;
+	} else t37 = $[112];
+	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,81 @@
+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 {};
+//# sourceMappingURL=combobox-items.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"combobox-items.d.ts","sourceRoot":"","sources":["../../../src/components/combobox-field/combobox-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEN,KAAK,WAAW,EAEhB,MAAM,mBAAmB,CAAC;AAE3B,KAAK,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,CAAC,KAAK,IAAI,QAAQ,CAAC;IACxC,IAAI,EACD,QAAQ,CAAC;QAAE,KAAK,EAAE,SAAS,IAAI,CAAC,KAAK,CAAC,EAAE,CAAA;KAAE,CAAC,GAC3C,SAAS,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,aAAa,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,CACpB,KAAK,EACL,KAAK,GAAG,KAAK,EACb,IAAI,SAAS,QAAQ,GAAG,QAAQ,IAC7B,CACH,GAAG,EAAE,MAAM,KACP,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,CAAC,KAAK,IAC5B,QAAQ,CAAC;IACT,KAAK,EAAE,SAAS,KAAK,EAAE,CAAC;IACxB,gEAAgE;IAChE,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,cAAc,CAAC,EAAE,KAAK,CAAC;CACtB,CAAC,GACF,QAAQ,CAAC;IACT,+CAA+C;IAC/C,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IACzB,uDAAuD;IACvD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,CAAC;CACZ,CAAC,CAAC;AAEN,2FAA2F;AAC3F,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IACpC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;CAC5B,CAAC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,UACpB,aAAa,CAAC,KAAK,CAAC,KAC1B,SAAS,KAAK,EAKN,CAAC;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,UACnB,aAAa,CAAC,KAAK,CAAC,aACjB,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,KACpC,WAGqC,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,UAC1B,aAAa,CAAC,KAAK,CAAC,KAC1B,aAAa,GAAG,SAOf,CAAC"}