@funstack/ui 0.1.0-alpha.0 → 0.1.0-alpha.2

package/dist/combobox/combobox-root.mjs

@@ -0,0 +1,508 @@
+"use client";
+import { createActionDetails } from "../internal/action-details.mjs";
+import { useControllableAction } from "../internal/use-controllable-action.mjs";
+import { resolveStateValue } from "../internal/use-render.mjs";
+import { useDevWarning } from "../internal/use-dev-warning.mjs";
+import { useFormReset } from "../internal/use-form-reset.mjs";
+import { usePopoverRoot } from "../internal/use-popover-root.mjs";
+import { ComboboxContext } from "./combobox-context.mjs";
+import { useCallback, useDeferredValue, useEffect, useId, useInsertionEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { flushSync } from "react-dom";
+//#region src/combobox/combobox-root.tsx
+/** The default announcement (design 6.4; conventions 11: English, always overridable). */
+function defaultComboboxAnnouncement(count) {
+	if (count === 0) return "No results";
+	if (count === 1) return "1 result";
+	return `${count} results`;
+}
+const VALUE_TRANSITION_TYPES = ["fsui-combobox", "fsui-combobox-select"];
+const isDev = process.env.NODE_ENV !== "production";
+function isPopoverOpen(element) {
+	if (element === null) return false;
+	try {
+		return element.matches(":popover-open");
+	} catch {
+		return false;
+	}
+}
+function isThenable(value) {
+	return typeof value === "object" && value !== null && typeof value.then === "function";
+}
+/**
+* Owns the two states of a combobox (design/components/combobox.md 2): the selection (`value`,
+* a transition with `useOptimistic`, like every other value) and the text (`inputValue`, the
+* library's **urgent** lane: `inputValueChangeAction` is called synchronously, outside any
+* transition). The results render from `useDeferredValue(inputValue)`; the active option is
+* urgent virtual focus (`aria-activedescendant`); the listbox is a `popover="auto"` opened by the
+* library with the input as `source`. Renders no DOM, except one `<input type="hidden">` when
+* `name` is given.
+*/
+function ComboboxRoot(props) {
+	const { value, defaultValue, valueChangeAction, inputValue: inputValueProp, defaultInputValue, open, defaultOpen, openChangeAction, allowCustomValue = false, autoHighlight = false, openOnClick = false, loop = false, name, form, disabled = false, children } = props;
+	const id = useId();
+	const ids = useMemo(() => ({
+		input: `${id}-input`,
+		label: `${id}-label`,
+		list: `${id}-list`,
+		optionPrefix: `${id}-option-`
+	}), [id]);
+	const popover = usePopoverRoot({
+		component: "combobox",
+		part: "Combobox.Root",
+		mode: "library",
+		open,
+		defaultOpen,
+		openChangeAction
+	});
+	const propsRef = useRef(props);
+	const popoverRef = useRef(popover);
+	useInsertionEffect(() => {
+		propsRef.current = props;
+		popoverRef.current = popover;
+	});
+	const inputRef = useRef(null);
+	const listRef = useRef(null);
+	const hiddenRef = useRef(null);
+	const [internalText, setInternalText] = useState(() => defaultInputValue ?? inputValueProp ?? "");
+	const text = inputValueProp ?? internalText;
+	const query = useDeferredValue(text);
+	const stale = text !== query;
+	const textRef = useRef(text);
+	useInsertionEffect(() => {
+		textRef.current = text;
+	});
+	const warnedThenable = useRef(false);
+	/** Writes the text (urgent) and calls `inputValueChangeAction` synchronously (design 2.2). */
+	const writeText = useCallback((next, reason, event) => {
+		const latest = propsRef.current;
+		if (latest.inputValue === void 0) setInternalText(next);
+		textRef.current = next;
+		const action = latest.inputValueChangeAction;
+		if (action === void 0) return;
+		const result = action(next, createActionDetails(event, { reason }));
+		if (isDev && !warnedThenable.current && isThenable(result)) {
+			warnedThenable.current = true;
+			console.error("Combobox.Root: `inputValueChangeAction` returned a promise. It is the urgent lane: called synchronously and never awaited. Put async work in `valueChangeAction`, or derive the results from the deferred `query`.");
+		}
+	}, []);
+	const [labels] = useState(() => {
+		const map = /* @__PURE__ */ new Map();
+		const initialValue = value !== void 0 ? value : defaultValue ?? null;
+		if (initialValue !== null) map.set(initialValue, defaultInputValue ?? inputValueProp ?? "");
+		return map;
+	});
+	const labelFor = useCallback((v) => v === null ? "" : labels.get(v) ?? "", [labels]);
+	const dispatchSeq = useRef(0);
+	const [dispatchMeta] = useState(() => /* @__PURE__ */ new WeakMap());
+	const textRecord = useRef(null);
+	const committedRef = useRef(null);
+	const runValueAction = async (next, details) => {
+		const meta = dispatchMeta.get(details);
+		try {
+			await valueChangeAction?.(next, details);
+		} catch (error) {
+			await void 0;
+			const record = textRecord.current;
+			if (meta !== void 0 && record !== null && record.id === meta.id) {
+				textRecord.current = null;
+				if (textRef.current === record.text) writeText(labelFor(committedRef.current), "dismiss", void 0);
+			}
+			throw error;
+		}
+		const record = textRecord.current;
+		if (meta !== void 0 && record !== null && record.id === meta.id) record.settled = true;
+		const current = popoverRef.current;
+		if (meta !== void 0 && meta.close && meta.id === dispatchSeq.current && current.openGeneration() === meta.generation && (meta.text === void 0 || textRef.current === meta.text)) current.requestClose(details.event, "activate");
+	};
+	const selection = useControllableAction({
+		controlled: value,
+		defaultValue,
+		initialValue: null,
+		action: runValueAction,
+		transitionTypes: () => VALUE_TRANSITION_TYPES,
+		warn: {
+			component: "Combobox.Root",
+			prop: "value"
+		}
+	});
+	useInsertionEffect(() => {
+		committedRef.current = selection.committed;
+	});
+	const dispatchValue = (next, event, fields, options) => {
+		const details = createActionDetails(event, fields);
+		const dispatchId = ++dispatchSeq.current;
+		dispatchMeta.set(details, {
+			id: dispatchId,
+			generation: popover.openGeneration(),
+			close: options.close,
+			text: options.text
+		});
+		textRecord.current = options.text === void 0 ? null : {
+			id: dispatchId,
+			value: next,
+			text: options.text,
+			settled: false
+		};
+		selection.dispatch(next, details);
+	};
+	const [registry] = useState(() => /* @__PURE__ */ new Map());
+	const [optionCount, setOptionCount] = useState(0);
+	const [statusCount, setStatusCount] = useState(0);
+	const statusCountRef = useRef(0);
+	const [labelCount, setLabelCount] = useState(0);
+	const warnedDuplicate = useRef(false);
+	const registerOption = useCallback((optionValue, entry) => {
+		const existing = registry.get(optionValue);
+		if (isDev && !warnedDuplicate.current && existing !== void 0 && existing.element !== entry.element && existing.element.isConnected) {
+			warnedDuplicate.current = true;
+			console.error(`Combobox.Option: two options have the value ${JSON.stringify(optionValue)}. Option ids are derived from the value, so they must be unique within one Combobox.`);
+		}
+		registry.set(optionValue, entry);
+		labels.set(optionValue, entry.label ?? (entry.element.textContent ?? "").trim());
+		setOptionCount(registry.size);
+		return () => {
+			if (registry.get(optionValue) === entry) registry.delete(optionValue);
+			setOptionCount(registry.size);
+		};
+	}, [registry, labels]);
+	const registerStatus = useCallback(() => {
+		statusCountRef.current += 1;
+		setStatusCount((count) => count + 1);
+		return () => {
+			statusCountRef.current -= 1;
+			setStatusCount((count) => count - 1);
+		};
+	}, []);
+	const registerLabel = useCallback(() => {
+		setLabelCount((count) => count + 1);
+		return () => setLabelCount((count) => count - 1);
+	}, []);
+	const [activeValue, setActiveValue] = useState(null);
+	const activeRef = useRef(null);
+	const setActive = useCallback((next) => {
+		activeRef.current = next;
+		setActiveValue(next);
+	}, []);
+	const pendingEdge = useRef(null);
+	const autoArmed = useRef(true);
+	const orderedOptions = useCallback(() => {
+		const options = [];
+		for (const [optionValue, entry] of registry) options.push({
+			value: optionValue,
+			...entry
+		});
+		options.sort((a, b) => a.element.compareDocumentPosition(b.element) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1);
+		return options;
+	}, [registry]);
+	const loading = statusCount > 0;
+	const empty = optionCount === 0 && !stale && !loading;
+	useLayoutEffect(() => {
+		const current = activeRef.current;
+		if (!popover.committed) {
+			if (!popover.intended()) pendingEdge.current = null;
+			autoArmed.current = true;
+			if (current !== null) setActive(null);
+			return;
+		}
+		const enabled = orderedOptions().filter((option) => !option.disabled);
+		let next = current;
+		if (pendingEdge.current !== null && enabled.length > 0) {
+			next = (pendingEdge.current === "first" ? enabled[0] : enabled.at(-1)).value;
+			pendingEdge.current = null;
+		} else if (next !== null && !enabled.some((option) => option.value === next)) next = null;
+		if (next !== null) autoArmed.current = false;
+		else if (autoHighlight && autoArmed.current && !stale && enabled.length > 0) {
+			next = enabled[0].value;
+			autoArmed.current = false;
+		}
+		if (next !== current) setActive(next);
+	});
+	const prevCommitted = useRef(selection.committed);
+	useLayoutEffect(() => {
+		const record = textRecord.current;
+		if (record !== null && record.settled && !selection.pending && selection.latestInFlight() === null) {
+			textRecord.current = null;
+			if (selection.committed !== record.value && textRef.current === record.text) writeText(labelFor(selection.committed), "dismiss", void 0);
+		}
+		if (prevCommitted.current !== selection.committed) {
+			prevCommitted.current = selection.committed;
+			const committed = selection.committed;
+			if (committed !== null && textRecord.current === null && !labels.has(committed)) labels.set(committed, textRef.current);
+		}
+	});
+	const state = {
+		value: selection.optimistic,
+		inputValue: text,
+		query,
+		stale,
+		activeValue,
+		open: popover.optimistic,
+		pending: selection.pending || popover.pending,
+		disabled
+	};
+	const lastAnnounced = useRef(null);
+	useEffect(() => {
+		if (!popover.committed) {
+			lastAnnounced.current = null;
+			return;
+		}
+		if (stale || statusCountRef.current > 0) return;
+		const count = registry.size;
+		const key = `${count}\u0000${query}`;
+		if (lastAnnounced.current === key) return;
+		lastAnnounced.current = key;
+		const list = listRef.current;
+		if (list === null || typeof list.ariaNotify !== "function") return;
+		const message = (propsRef.current.announce ?? defaultComboboxAnnouncement)(count, state);
+		if (message !== null) list.ariaNotify(message);
+	});
+	const [mountValue] = useState(value);
+	const [mountText] = useState(inputValueProp);
+	const valueResetTarget = value !== void 0 ? mountValue ?? null : defaultValue ?? null;
+	const inputDefaultValue = inputValueProp !== void 0 ? mountText ?? "" : defaultInputValue ?? "";
+	const [resync, setResync] = useState(0);
+	useLayoutEffect(() => {
+		const input = inputRef.current;
+		if (resync > 0 && input !== null && input.value !== textRef.current) input.value = textRef.current;
+	}, [resync]);
+	const formElement = useMemo(() => ({
+		get current() {
+			return hiddenRef.current ?? inputRef.current;
+		},
+		set current(_ignored) {}
+	}), []);
+	useFormReset(formElement, (event) => {
+		const domText = inputRef.current?.value ?? inputDefaultValue;
+		if (domText !== textRef.current) writeText(domText, "platform", event);
+		setResync((n) => n + 1);
+		if (valueResetTarget !== selection.optimistic) dispatchValue(valueResetTarget, event, {
+			reason: "platform",
+			custom: false
+		}, {
+			close: false,
+			text: void 0
+		});
+	}, () => {
+		const input = inputRef.current;
+		if (input !== null && input.defaultValue !== inputDefaultValue) input.defaultValue = inputDefaultValue;
+	});
+	const reconciled = useRef(false);
+	useLayoutEffect(() => {
+		if (reconciled.current) return;
+		reconciled.current = true;
+		const input = inputRef.current;
+		if (input !== null && input.value !== textRef.current) writeText(input.value, "platform", void 0);
+	}, [writeText]);
+	const [missingText] = useState(() => (value ?? defaultValue ?? null) !== null && inputValueProp === void 0 && defaultInputValue === void 0);
+	useDevWarning(missingText, "Combobox.Root: `value` / `defaultValue` is set but neither `inputValue` nor `defaultInputValue` is: the input will show no text for the selection. The library never derives the text from the value; pass the selected option's label as well.");
+	const accept = (optionValue, event) => {
+		if (disabled) return;
+		const entry = registry.get(optionValue);
+		if (entry === void 0 || entry.disabled) return;
+		const label = entry.label ?? (entry.element.textContent ?? "").trim();
+		labels.set(optionValue, label);
+		pendingEdge.current = null;
+		if (activeRef.current !== optionValue) setActive(optionValue);
+		writeText(label, "activate", event);
+		if (optionValue === selection.optimistic) {
+			popover.requestClose(event, "activate");
+			return;
+		}
+		dispatchValue(optionValue, event, {
+			reason: "activate",
+			custom: false
+		}, {
+			close: true,
+			text: label
+		});
+	};
+	/** Free text as the value (design 5.3). Returns whether it dispatched. */
+	const commitText = (event, close) => {
+		const current = selection.optimistic;
+		const typed = textRef.current;
+		if (typed === labelFor(current)) return false;
+		const next = typed === "" ? null : typed;
+		if (next === current) return false;
+		if (next !== null) labels.set(next, typed);
+		dispatchValue(next, event, {
+			reason: "activate",
+			custom: next !== null
+		}, {
+			close,
+			text: typed
+		});
+		return true;
+	};
+	const clear = (event) => {
+		if (disabled) return;
+		if (textRef.current !== "") writeText("", "activate", event);
+		if (selection.optimistic !== null) dispatchValue(null, event, {
+			reason: "activate",
+			custom: false
+		}, {
+			close: false,
+			text: ""
+		});
+		inputRef.current?.focus();
+	};
+	const typed = (next, event) => {
+		if (disabled) return;
+		writeText(next, "activate", event);
+		pendingEdge.current = null;
+		if (activeRef.current !== null) setActive(null);
+		autoArmed.current = true;
+		popover.requestOpen(event, "activate");
+	};
+	const move = (direction) => {
+		const enabled = orderedOptions().filter((option) => !option.disabled);
+		if (enabled.length === 0) return;
+		const last = enabled.length - 1;
+		const index = enabled.findIndex((option) => option.value === activeRef.current);
+		let next;
+		if (direction === 1) next = index < 0 ? 0 : index >= last ? loop ? 0 : last : index + 1;
+		else next = index < 0 ? last : index <= 0 ? loop ? last : 0 : index - 1;
+		const target = enabled[next];
+		setActive(target.value);
+		if (typeof target.element.scrollIntoView === "function") target.element.scrollIntoView({ block: "nearest" });
+	};
+	const activeEnabled = () => {
+		const current = activeRef.current;
+		if (current === null) return null;
+		const entry = registry.get(current);
+		return entry !== void 0 && !entry.disabled ? current : null;
+	};
+	const keyDown = (event) => {
+		if (disabled || event.ctrlKey || event.metaKey) return false;
+		if (event.isComposing || event.keyCode === 229) return false;
+		const isOpen = isPopoverOpen(popover.popupRef.current);
+		switch (event.key) {
+			case "ArrowDown":
+				event.preventDefault();
+				if (event.altKey) {
+					if (!isOpen) popover.requestOpen(event, "activate");
+				} else if (!isOpen) {
+					pendingEdge.current = "first";
+					popover.requestOpen(event, "activate");
+				} else move(1);
+				return true;
+			case "ArrowUp":
+				event.preventDefault();
+				if (event.altKey) {
+					if (isOpen) {
+						const active = activeEnabled();
+						if (active !== null) accept(active, event);
+						else popover.requestClose(event, "activate");
+					}
+				} else if (!isOpen) {
+					pendingEdge.current = "last";
+					popover.requestOpen(event, "activate");
+				} else move(-1);
+				return true;
+			case "Enter":
+				if (isOpen) {
+					event.preventDefault();
+					const active = activeEnabled();
+					if (active !== null) accept(active, event);
+					else if (allowCustomValue && !commitText(event, true)) popover.requestClose(event, "activate");
+					return true;
+				}
+				if (allowCustomValue) flushSync(() => commitText(event, false));
+				return false;
+			case "Home":
+			case "End":
+			case "ArrowLeft":
+			case "ArrowRight":
+				if (activeRef.current !== null) setActive(null);
+				return false;
+			default: return false;
+		}
+	};
+	/** Focus has left the input and the popup (design 5.4). */
+	const leave = (event) => {
+		if (disabled) return;
+		const popup = popover.popupRef.current;
+		if (popup !== null && isPopoverOpen(popup)) {
+			popover.recordCloseIntent({
+				reason: "dismiss",
+				event
+			});
+			popup.hidePopover();
+		}
+		pendingEdge.current = null;
+		if (allowCustomValue) {
+			commitText(event, false);
+			return;
+		}
+		const label = labelFor(selection.optimistic);
+		if (textRef.current !== label) writeText(label, "dismiss", event);
+	};
+	const leaveRef = useRef(leave);
+	useInsertionEffect(() => {
+		leaveRef.current = leave;
+	});
+	const focusOut = (event) => {
+		const input = inputRef.current;
+		const popup = popover.popupRef.current;
+		const next = event.relatedTarget;
+		if (next instanceof Node) {
+			if (next === input || popup !== null && popup.contains(next)) return;
+			leave(event);
+			return;
+		}
+		if (input === null) return;
+		const doc = input.ownerDocument;
+		setTimeout(() => {
+			if (!doc.hasFocus()) return;
+			const active = doc.activeElement;
+			if (active === input || active !== null && popup !== null && popup.contains(active)) return;
+			if (input.isConnected) leaveRef.current(event);
+		}, 0);
+	};
+	const inputClick = (event) => {
+		if (disabled || !openOnClick) return;
+		popover.requestOpen(event, "activate");
+	};
+	const context = {
+		popover,
+		ids,
+		value: selection.optimistic,
+		valuePending: selection.pending,
+		pending: state.pending,
+		inputValue: text,
+		query,
+		stale,
+		activeValue,
+		empty,
+		loading,
+		hasLabel: labelCount > 0,
+		disabled,
+		inputRef,
+		listRef,
+		registerOption,
+		registerStatus,
+		registerLabel,
+		setActive,
+		accept,
+		clear,
+		typed,
+		keyDown,
+		focusOut,
+		inputClick
+	};
+	return /* @__PURE__ */ jsxs(ComboboxContext, {
+		value: context,
+		children: [name !== void 0 && /* @__PURE__ */ jsx("input", {
+			ref: hiddenRef,
+			type: "hidden",
+			name,
+			form,
+			value: selection.optimistic ?? ""
+		}), resolveStateValue(children, state)]
+	});
+}
+ComboboxRoot.displayName = "ComboboxRoot";
+//#endregion
+export { ComboboxRoot, defaultComboboxAnnouncement };
+
+//# sourceMappingURL=combobox-root.mjs.map

package/dist/combobox/combobox-root.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox-root.mjs","names":[],"sources":["../../src/combobox/combobox-root.tsx"],"sourcesContent":["\"use client\";\nimport {\n  useCallback,\n  useDeferredValue,\n  useEffect,\n  useId,\n  useInsertionEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport { flushSync } from \"react-dom\";\nimport type { ReactNode, RefObject } from \"react\";\nimport { createActionDetails } from \"../internal/action-details.js\";\nimport type {\n  ActionDetails,\n  ChangeAction,\n  ChangeReason,\n  StateValue,\n  UrgentChangeAction,\n} from \"../internal/types.js\";\nimport { useControllableAction } from \"../internal/use-controllable-action.js\";\nimport { useDevWarning } from \"../internal/use-dev-warning.js\";\nimport { useFormReset } from \"../internal/use-form-reset.js\";\nimport type { FormAssociatedElement } from \"../internal/use-form-reset.js\";\nimport { usePopoverRoot } from \"../internal/use-popover-root.js\";\nimport { resolveStateValue } from \"../internal/use-render.js\";\nimport { ComboboxContext } from \"./combobox-context.js\";\nimport type { ComboboxContextValue, ComboboxOptionEntry } from \"./combobox-context.js\";\n\n/** Details passed as the second argument of `Combobox.Root`'s `valueChangeAction`. */\nexport interface ComboboxValueChangeDetails extends ActionDetails {\n  /**\n   * `\"activate\"`: the user accepted an option (Enter, click; `details.event` is the `keydown` or\n   * `click`), committed free text with `allowCustomValue` (Enter: the `keydown`; focus leaving:\n   * the `focusout`), or pressed Clear (`click`).\n   * `\"platform\"`: a form reset (`details.event` is the `reset` event).\n   */\n  readonly reason: ChangeReason;\n  /** `true` when `next` is free text committed under `allowCustomValue`, not an option's value. */\n  readonly custom: boolean;\n}\n\n/** Details passed as the second argument of `Combobox.Root`'s `inputValueChangeAction`. */\nexport interface ComboboxInputValueChangeDetails extends ActionDetails {\n  /**\n   * `\"activate\"`: typing (the `input` event), an accepted option's label, Clear.\n   * `\"dismiss\"`: a revert: focus left with unmatched text, or the selection rolled back.\n   * `\"platform\"`: form reset (the `reset` event), or text found in the input at mount\n   * (`undefined`).\n   */\n  readonly reason: ChangeReason;\n}\n\n/** Details passed as the second argument of `Combobox.Root`'s `openChangeAction`. */\nexport interface ComboboxOpenChangeDetails extends ActionDetails {\n  /**\n   * `\"activate\"`: typing, ArrowDown / ArrowUp / Alt+ArrowDown, the Trigger, a click on the input\n   * with `openOnClick`, an accepted option (the close after it), a foreign `showPopover()`.\n   * `\"dismiss\"`: Escape, light dismiss, focus leaving the combobox, another top-layer element.\n   * `\"platform\"`: the popup was found open on mount (only script can cause it).\n   */\n  readonly reason: ChangeReason;\n}\n\nexport interface ComboboxRootState {\n  /** Optimistic selection. Content rendered from it must not suspend. */\n  readonly value: string | null;\n  /** The text in the input (urgent). */\n  readonly inputValue: string;\n  /** The deferred text the mounted results are for. */\n  readonly query: string;\n  /** `inputValue !== query`: the results shown are for an older text. */\n  readonly stale: boolean;\n  /** The value of the option `aria-activedescendant` points at, or `null`. */\n  readonly activeValue: string | null;\n  /** Optimistic open state. */\n  readonly open: boolean;\n  /** A `valueChangeAction` or `openChangeAction` dispatched through this Combobox is in flight. */\n  readonly pending: boolean;\n  readonly disabled: boolean;\n}\n\nexport interface ComboboxRootProps {\n  /** Controlled selection. `null`: nothing selected. `undefined`: uncontrolled. */\n  value?: string | null;\n  /** Initial selection in uncontrolled mode. Default `null`. */\n  defaultValue?: string | null;\n  /**\n   * Runs inside the Root's transition when the user accepts an option, commits free text\n   * (`allowCustomValue`), presses Clear, or the form resets. Awaited; the listbox closes in the\n   * commit that ends it; a rejection rolls the input text and `data-selected` back and leaves\n   * the listbox open. May be a Server Function. A `setState` after your own `await` needs\n   * `startTransition`.\n   */\n  valueChangeAction?: ChangeAction<string | null, ComboboxValueChangeDetails>;\n\n  /** Controlled input text. `undefined`: uncontrolled. */\n  inputValue?: string;\n  /**\n   * Initial input text. Default `\"\"`. Pass the selected value's label when `defaultValue` is\n   * set: the library never derives the text from the value.\n   */\n  defaultInputValue?: string;\n  /**\n   * The urgent lane: called synchronously, outside any Transition, on every change of the text\n   * (typing, and the library's own writes: an accepted option's label, a revert, Clear, a form\n   * reset, text typed before hydration). Not awaited; nothing is pending for it. A controlled\n   * parent updates its state in the body (an urgent update, which is what a controlled text\n   * input needs).\n   */\n  inputValueChangeAction?: UrgentChangeAction<string, ComboboxInputValueChangeDetails>;\n\n  /** Controlled open state. `undefined`: uncontrolled. */\n  open?: boolean;\n  /** Initial open state when uncontrolled. Opens after hydration. */\n  defaultOpen?: boolean;\n  /**\n   * Awaited for opens and for the close after an accepted option (or the Trigger); a\n   * notification for dismissals (Escape, a click outside, focus leaving).\n   */\n  openChangeAction?: ChangeAction<boolean, ComboboxOpenChangeDetails>;\n\n  /**\n   * Free text is a value: Enter with no active option, or focus leaving with text that is not\n   * the selected option's label, dispatches the text with `details.custom: true` (empty text\n   * dispatches `null`). Default `false`: unmatched text reverts to the selection's label when\n   * focus leaves.\n   */\n  allowCustomValue?: boolean;\n  /**\n   * Make the first enabled option active when the results for an open or an edit settle (APG\n   * \"automatic selection\"). Stale results are never highlighted. Default `false`.\n   */\n  autoHighlight?: boolean;\n  /** Open the listbox on a pointer click in the input (not on focus). Default `false`. */\n  openOnClick?: boolean;\n  /** Wrap from the last option to the first and back with the arrow keys. Default `false`. */\n  loop?: boolean;\n  /**\n   * The message `ariaNotify()` announces on the List when the results settle, from the number\n   * of mounted options. Default (English): `\"No results\"`, `\"1 result\"`, `\"N results\"`. Override\n   * for localisation or a richer message; return `null` to announce nothing. Ignored where\n   * `ariaNotify` is missing.\n   */\n  announce?: (count: number, state: ComboboxRootState) => string | null;\n\n  /** Form participation through a hidden input with this name (value `\"\"` for `null`). */\n  name?: string;\n  /** The `form` attribute of the hidden input. */\n  form?: string;\n  /** Disables the Input, Trigger and Clear; nothing dispatches for user interaction. */\n  disabled?: boolean;\n  children?: StateValue<ReactNode, ComboboxRootState>;\n}\n\n/** The default announcement (design 6.4; conventions 11: English, always overridable). */\nexport function defaultComboboxAnnouncement(count: number): string {\n  if (count === 0) return \"No results\";\n  if (count === 1) return \"1 result\";\n  return `${count} results`;\n}\n\nconst VALUE_TRANSITION_TYPES = [\"fsui-combobox\", \"fsui-combobox-select\"] as const;\n\nconst isDev = process.env.NODE_ENV !== \"production\";\n\nfunction isPopoverOpen(element: Element | null): boolean {\n  if (element === null) return false;\n  try {\n    return element.matches(\":popover-open\");\n  } catch {\n    return false;\n  }\n}\n\nfunction isThenable(value: unknown): boolean {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as { then?: unknown }).then === \"function\"\n  );\n}\n\n/** What a value dispatch carries for the Root's own follow-up (by `details` identity). */\ninterface DispatchMeta {\n  readonly id: number;\n  /** The open this dispatch belongs to (Popover 3.4): a newer open drops the close. */\n  readonly generation: number;\n  /** Close the listbox once the action settled (an accepted option, Enter on free text). */\n  readonly close: boolean;\n  /** The text the library wrote with the dispatch: typing since then keeps the listbox open. */\n  readonly text: string | undefined;\n}\n\n/** The text the library wrote for a user dispatch, reverted if the value does not land. */\ninterface TextRecord {\n  readonly id: number;\n  readonly value: string | null;\n  readonly text: string;\n  settled: boolean;\n}\n\ninterface OrderedOption extends ComboboxOptionEntry {\n  readonly value: string;\n}\n\n/**\n * Owns the two states of a combobox (design/components/combobox.md 2): the selection (`value`,\n * a transition with `useOptimistic`, like every other value) and the text (`inputValue`, the\n * library's **urgent** lane: `inputValueChangeAction` is called synchronously, outside any\n * transition). The results render from `useDeferredValue(inputValue)`; the active option is\n * urgent virtual focus (`aria-activedescendant`); the listbox is a `popover=\"auto\"` opened by the\n * library with the input as `source`. Renders no DOM, except one `<input type=\"hidden\">` when\n * `name` is given.\n */\nexport function ComboboxRoot(props: ComboboxRootProps) {\n  const {\n    value,\n    defaultValue,\n    valueChangeAction,\n    inputValue: inputValueProp,\n    defaultInputValue,\n    open,\n    defaultOpen,\n    openChangeAction,\n    allowCustomValue = false,\n    autoHighlight = false,\n    openOnClick = false,\n    loop = false,\n    name,\n    form,\n    disabled = false,\n    children,\n  } = props;\n\n  const id = useId();\n  const ids = useMemo(\n    () => ({\n      input: `${id}-input`,\n      label: `${id}-label`,\n      list: `${id}-list`,\n      optionPrefix: `${id}-option-`,\n    }),\n    [id],\n  );\n\n  const popover = usePopoverRoot<ComboboxOpenChangeDetails>({\n    component: \"combobox\",\n    part: \"Combobox.Root\",\n    mode: \"library\",\n    open,\n    defaultOpen,\n    openChangeAction,\n  });\n\n  // --- Refs the handlers read after an `await` or from a timer ------------------------------\n\n  const propsRef = useRef(props);\n  const popoverRef = useRef(popover);\n  useInsertionEffect(() => {\n    propsRef.current = props;\n    popoverRef.current = popover;\n  });\n\n  const inputRef = useRef<HTMLInputElement | null>(null);\n  const listRef = useRef<HTMLElement | null>(null);\n  const hiddenRef = useRef<HTMLInputElement | null>(null);\n\n  // --- Text: the urgent lane (design 4) ------------------------------------------------------\n\n  const [internalText, setInternalText] = useState(() => defaultInputValue ?? inputValueProp ?? \"\");\n  const text = inputValueProp ?? internalText;\n  const query = useDeferredValue(text);\n  const stale = text !== query;\n  const textRef = useRef(text);\n  useInsertionEffect(() => {\n    textRef.current = text;\n  });\n\n  const warnedThenable = useRef(false);\n  /** Writes the text (urgent) and calls `inputValueChangeAction` synchronously (design 2.2). */\n  const writeText = useCallback(\n    (next: string, reason: ChangeReason, event: Event | undefined): void => {\n      const latest = propsRef.current;\n      if (latest.inputValue === undefined) setInternalText(next);\n      textRef.current = next;\n      const action = latest.inputValueChangeAction;\n      if (action === undefined) return;\n      const result: unknown = action(next, createActionDetails(event, { reason }));\n      if (isDev && !warnedThenable.current && isThenable(result)) {\n        warnedThenable.current = true;\n        console.error(\n          \"Combobox.Root: `inputValueChangeAction` returned a promise. It is the urgent lane: \" +\n            \"called synchronously and never awaited. Put async work in `valueChangeAction`, or \" +\n            \"derive the results from the deferred `query`.\",\n        );\n      }\n    },\n    [],\n  );\n\n  // --- Labels (design 2.3) -------------------------------------------------------------------\n\n  const [labels] = useState(() => {\n    const map = new Map<string, string>();\n    const initialValue = value !== undefined ? value : (defaultValue ?? null);\n    if (initialValue !== null) map.set(initialValue, defaultInputValue ?? inputValueProp ?? \"\");\n    return map;\n  });\n  const labelFor = useCallback(\n    (v: string | null): string => (v === null ? \"\" : (labels.get(v) ?? \"\")),\n    [labels],\n  );\n\n  // --- Selection: a transition (design 3.1, 5.2) --------------------------------------------\n\n  const dispatchSeq = useRef(0);\n  const [dispatchMeta] = useState(() => new WeakMap<object, DispatchMeta>());\n  const textRecord = useRef<TextRecord | null>(null);\n  const committedRef = useRef<string | null>(null);\n\n  const runValueAction = async (\n    next: string | null,\n    details: ComboboxValueChangeDetails,\n  ): Promise<void> => {\n    const meta = dispatchMeta.get(details);\n    try {\n      await valueChangeAction?.(next, details);\n    } catch (error) {\n      // Walkthrough 4: the text rolls back with the optimistic value. A synchronous throw lands\n      // here inside the Root's `startTransition` callback; yield once so the write (and the\n      // consumer's `inputValueChangeAction`) is urgent, as every text write (conventions 2.6).\n      await undefined;\n      const record = textRecord.current;\n      if (meta !== undefined && record !== null && record.id === meta.id) {\n        textRecord.current = null;\n        if (textRef.current === record.text) {\n          writeText(labelFor(committedRef.current), \"dismiss\", undefined);\n        }\n      }\n      throw error;\n    }\n    const record = textRecord.current;\n    if (meta !== undefined && record !== null && record.id === meta.id) record.settled = true;\n    // Menu decision 3: close in the commit that ends the action, unless a newer dispatch took\n    // over, the user dismissed and re-opened meanwhile, or the user is typing a new search.\n    const current = popoverRef.current;\n    if (\n      meta !== undefined &&\n      meta.close &&\n      meta.id === dispatchSeq.current &&\n      current.openGeneration() === meta.generation &&\n      (meta.text === undefined || textRef.current === meta.text)\n    ) {\n      current.requestClose(details.event, \"activate\");\n    }\n  };\n\n  const selection = useControllableAction<string | null, ComboboxValueChangeDetails>({\n    controlled: value,\n    defaultValue,\n    initialValue: null,\n    action: runValueAction,\n    transitionTypes: () => VALUE_TRANSITION_TYPES,\n    warn: { component: \"Combobox.Root\", prop: \"value\" },\n  });\n  useInsertionEffect(() => {\n    committedRef.current = selection.committed;\n  });\n\n  const dispatchValue = (\n    next: string | null,\n    event: Event | undefined,\n    fields: { reason: ChangeReason; custom: boolean },\n    options: { close: boolean; text: string | undefined },\n  ): void => {\n    const details = createActionDetails(event, fields);\n    const dispatchId = ++dispatchSeq.current;\n    dispatchMeta.set(details, {\n      id: dispatchId,\n      generation: popover.openGeneration(),\n      close: options.close,\n      text: options.text,\n    });\n    textRecord.current =\n      options.text === undefined\n        ? null\n        : { id: dispatchId, value: next, text: options.text, settled: false };\n    selection.dispatch(next, details);\n  };\n\n  // --- Option registry and the active option (design 2, 6.5) --------------------------------\n\n  const [registry] = useState(() => new Map<string, ComboboxOptionEntry>());\n  const [optionCount, setOptionCount] = useState(0);\n  const [statusCount, setStatusCount] = useState(0);\n  // The same count for the announcement effect: the open commit's passive effects can run before\n  // the re-render the Status's registration scheduled (the race `registry` avoids for options).\n  const statusCountRef = useRef(0);\n  const [labelCount, setLabelCount] = useState(0);\n  const warnedDuplicate = useRef(false);\n\n  const registerOption = useCallback(\n    (optionValue: string, entry: ComboboxOptionEntry) => {\n      const existing = registry.get(optionValue);\n      if (\n        isDev &&\n        !warnedDuplicate.current &&\n        existing !== undefined &&\n        existing.element !== entry.element &&\n        existing.element.isConnected\n      ) {\n        warnedDuplicate.current = true;\n        console.error(\n          `Combobox.Option: two options have the value ${JSON.stringify(optionValue)}. ` +\n            \"Option ids are derived from the value, so they must be unique within one Combobox.\",\n        );\n      }\n      registry.set(optionValue, entry);\n      labels.set(optionValue, entry.label ?? (entry.element.textContent ?? \"\").trim());\n      setOptionCount(registry.size);\n      return () => {\n        if (registry.get(optionValue) === entry) registry.delete(optionValue);\n        setOptionCount(registry.size);\n      };\n    },\n    [registry, labels],\n  );\n\n  const registerStatus = useCallback(() => {\n    statusCountRef.current += 1;\n    setStatusCount((count) => count + 1);\n    return () => {\n      statusCountRef.current -= 1;\n      setStatusCount((count) => count - 1);\n    };\n  }, []);\n\n  const registerLabel = useCallback(() => {\n    setLabelCount((count) => count + 1);\n    return () => setLabelCount((count) => count - 1);\n  }, []);\n\n  const [activeValue, setActiveValue] = useState<string | null>(null);\n  const activeRef = useRef<string | null>(null);\n  const setActive = useCallback((next: string | null) => {\n    activeRef.current = next;\n    setActiveValue(next);\n  }, []);\n  // The edge to activate once the open has options (ArrowDown / ArrowUp while closed).\n  const pendingEdge = useRef<\"first\" | \"last\" | null>(null);\n  // `autoHighlight` (APG automatic selection) highlights once per open and once per edit, when\n  // the results for it settle. Home / End / Left / Right clear the active option without\n  // re-arming it, so the caret keys really return visual focus to the input.\n  const autoArmed = useRef(true);\n\n  const orderedOptions = useCallback((): OrderedOption[] => {\n    const options: OrderedOption[] = [];\n    for (const [optionValue, entry] of registry) options.push({ value: optionValue, ...entry });\n    options.sort((a, b) =>\n      a.element.compareDocumentPosition(b.element) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1,\n    );\n    return options;\n  }, [registry]);\n\n  // A Status inside the List is a Suspense fallback: the results are loading (design 6.3).\n  const loading = statusCount > 0;\n  const empty = optionCount === 0 && !stale && !loading;\n\n  // Revalidation (design 6.5): urgent, in a layout effect after every commit; never dispatches.\n  useLayoutEffect(() => {\n    const current = activeRef.current;\n    if (!popover.committed) {\n      // Keep the edge of an open that is on its way (the optimistic commit comes first).\n      if (!popover.intended()) pendingEdge.current = null;\n      autoArmed.current = true;\n      if (current !== null) setActive(null);\n      return;\n    }\n    const enabled = orderedOptions().filter((option) => !option.disabled);\n    let next = current;\n    if (pendingEdge.current !== null && enabled.length > 0) {\n      next = (pendingEdge.current === \"first\" ? enabled[0] : enabled.at(-1))!.value;\n      pendingEdge.current = null;\n    } else if (next !== null && !enabled.some((option) => option.value === next)) {\n      next = null;\n    }\n    if (next !== null) {\n      // Something is active (keys, hover): nothing to highlight for these results.\n      autoArmed.current = false;\n    } else if (autoHighlight && autoArmed.current && !stale && enabled.length > 0) {\n      // Only settled results: a stale list's first option is never auto-highlighted, so a fast\n      // Enter commits the typed text or does nothing (design L5).\n      next = enabled[0]!.value;\n      autoArmed.current = false;\n    }\n    if (next !== current) setActive(next);\n  });\n\n  // The selection did not land (a controlled parent refused it, or the caught-inside variant of\n  // a controlled parent): the text goes back to the committed value's label (design 2.2).\n  // Labels for values set from outside are learnt from the text the consumer passed with them.\n  const prevCommitted = useRef(selection.committed);\n  useLayoutEffect(() => {\n    const record = textRecord.current;\n    if (\n      record !== null &&\n      record.settled &&\n      !selection.pending &&\n      selection.latestInFlight() === null\n    ) {\n      textRecord.current = null;\n      if (selection.committed !== record.value && textRef.current === record.text) {\n        writeText(labelFor(selection.committed), \"dismiss\", undefined);\n      }\n    }\n    if (prevCommitted.current !== selection.committed) {\n      prevCommitted.current = selection.committed;\n      const committed = selection.committed;\n      if (committed !== null && textRecord.current === null && !labels.has(committed)) {\n        labels.set(committed, textRef.current);\n      }\n    }\n  });\n\n  // --- Announcements (design 6.4) -----------------------------------------------------------\n\n  const state: ComboboxRootState = {\n    value: selection.optimistic,\n    inputValue: text,\n    query,\n    stale,\n    activeValue,\n    open: popover.optimistic,\n    pending: selection.pending || popover.pending,\n    disabled,\n  };\n\n  const lastAnnounced = useRef<string | null>(null);\n  useEffect(() => {\n    if (!popover.committed) {\n      lastAnnounced.current = null;\n      return;\n    }\n    if (stale || statusCountRef.current > 0) return;\n    // The registry, not `optionCount`: a commit's passive effects can run before the re-render\n    // that the Options' registration scheduled.\n    const count = registry.size;\n    const key = `${count}\\u0000${query}`;\n    if (lastAnnounced.current === key) return;\n    lastAnnounced.current = key;\n    const list = listRef.current as (HTMLElement & { ariaNotify?: (m: string) => void }) | null;\n    if (list === null || typeof list.ariaNotify !== \"function\") return;\n    const announce = propsRef.current.announce ?? defaultComboboxAnnouncement;\n    const message = announce(count, state);\n    if (message !== null) list.ariaNotify(message);\n  });\n\n  // --- Form: hidden input, reset, mount reconciliation (design 11.1, walkthroughs 10, 11) ----\n\n  const [mountValue] = useState(value);\n  const [mountText] = useState(inputValueProp);\n  // Reset targets (conventions 3.8 rule 6): uncontrolled, the latest default props; controlled,\n  // the mount-time values.\n  const valueResetTarget = value !== undefined ? (mountValue ?? null) : (defaultValue ?? null);\n  const inputDefaultValue =\n    inputValueProp !== undefined ? (mountText ?? \"\") : (defaultInputValue ?? \"\");\n  // After a form reset a controlled parent may not adopt the text: put React's value back into\n  // the DOM (react-dom only does that after its own input events).\n  const [resync, setResync] = useState(0);\n  useLayoutEffect(() => {\n    const input = inputRef.current;\n    if (resync > 0 && input !== null && input.value !== textRef.current) {\n      input.value = textRef.current;\n    }\n  }, [resync]);\n\n  const formElement = useMemo<RefObject<FormAssociatedElement | null>>(\n    () => ({\n      get current() {\n        return hiddenRef.current ?? inputRef.current;\n      },\n      set current(_ignored) {},\n    }),\n    [],\n  );\n  useFormReset(\n    formElement,\n    (event) => {\n      const input = inputRef.current;\n      const domText = input?.value ?? inputDefaultValue;\n      if (domText !== textRef.current) writeText(domText, \"platform\", event);\n      // A controlled parent that does not adopt the text gets the DOM re-synced.\n      setResync((n) => n + 1);\n      if (valueResetTarget !== selection.optimistic) {\n        dispatchValue(\n          valueResetTarget,\n          event,\n          { reason: \"platform\", custom: false },\n          { close: false, text: undefined },\n        );\n      }\n    },\n    () => {\n      // react-dom writes `defaultValue = value` after every update of a controlled input, so the\n      // reset target is written here, right before the browser's reset algorithm reads it.\n      const input = inputRef.current;\n      if (input !== null && input.defaultValue !== inputDefaultValue) {\n        input.defaultValue = inputDefaultValue;\n      }\n    },\n  );\n\n  // Walkthrough 11: react-dom keeps a hydrated text input's DOM value and fires no `onChange`.\n  const reconciled = useRef(false);\n  useLayoutEffect(() => {\n    if (reconciled.current) return;\n    reconciled.current = true;\n    const input = inputRef.current;\n    if (input !== null && input.value !== textRef.current) {\n      writeText(input.value, \"platform\", undefined);\n    }\n  }, [writeText]);\n\n  const [missingText] = useState(\n    () =>\n      (value ?? defaultValue ?? null) !== null &&\n      inputValueProp === undefined &&\n      defaultInputValue === undefined,\n  );\n  useDevWarning(\n    missingText,\n    \"Combobox.Root: `value` / `defaultValue` is set but neither `inputValue` nor \" +\n      \"`defaultInputValue` is: the input will show no text for the selection. The library never \" +\n      \"derives the text from the value; pass the selected option's label as well.\",\n  );\n\n  // --- Interaction (design 5, 8) -------------------------------------------------------------\n\n  const accept = (optionValue: string, event: Event): void => {\n    if (disabled) return;\n    const entry = registry.get(optionValue);\n    if (entry === undefined || entry.disabled) return;\n    const label = entry.label ?? (entry.element.textContent ?? \"\").trim();\n    labels.set(optionValue, label);\n    pendingEdge.current = null;\n    if (activeRef.current !== optionValue) setActive(optionValue);\n    writeText(label, \"activate\", event);\n    // Re-accepting the selected option dispatches nothing and closes (conventions 2.3 item 8).\n    if (optionValue === selection.optimistic) {\n      popover.requestClose(event, \"activate\");\n      return;\n    }\n    dispatchValue(\n      optionValue,\n      event,\n      { reason: \"activate\", custom: false },\n      { close: true, text: label },\n    );\n  };\n\n  /** Free text as the value (design 5.3). Returns whether it dispatched. */\n  const commitText = (event: Event, close: boolean): boolean => {\n    const current = selection.optimistic;\n    const typed = textRef.current;\n    if (typed === labelFor(current)) return false;\n    const next = typed === \"\" ? null : typed;\n    if (next === current) return false;\n    if (next !== null) labels.set(next, typed);\n    dispatchValue(\n      next,\n      event,\n      { reason: \"activate\", custom: next !== null },\n      { close, text: typed },\n    );\n    return true;\n  };\n\n  const clear = (event: Event): void => {\n    if (disabled) return;\n    if (textRef.current !== \"\") writeText(\"\", \"activate\", event);\n    if (selection.optimistic !== null) {\n      dispatchValue(null, event, { reason: \"activate\", custom: false }, { close: false, text: \"\" });\n    }\n    inputRef.current?.focus();\n  };\n\n  const typed = (next: string, event: Event): void => {\n    if (disabled) return;\n    writeText(next, \"activate\", event);\n    pendingEdge.current = null;\n    // APG: editing moves visual focus back to the input; `autoHighlight` picks the first option\n    // again once the results for the new text settle.\n    if (activeRef.current !== null) setActive(null);\n    autoArmed.current = true;\n    popover.requestOpen(event, \"activate\");\n  };\n\n  const move = (direction: 1 | -1): void => {\n    const enabled = orderedOptions().filter((option) => !option.disabled);\n    if (enabled.length === 0) return;\n    const last = enabled.length - 1;\n    const index = enabled.findIndex((option) => option.value === activeRef.current);\n    let next: number;\n    if (direction === 1) next = index < 0 ? 0 : index >= last ? (loop ? 0 : last) : index + 1;\n    else next = index < 0 ? last : index <= 0 ? (loop ? last : 0) : index - 1;\n    const target = enabled[next]!;\n    setActive(target.value);\n    if (typeof target.element.scrollIntoView === \"function\") {\n      target.element.scrollIntoView({ block: \"nearest\" });\n    }\n  };\n\n  const activeEnabled = (): string | null => {\n    const current = activeRef.current;\n    if (current === null) return null;\n    const entry = registry.get(current);\n    return entry !== undefined && !entry.disabled ? current : null;\n  };\n\n  const keyDown = (event: KeyboardEvent): boolean => {\n    if (disabled || event.ctrlKey || event.metaKey) return false;\n    // IME: the key belongs to the composition (Enter commits it, arrows pick a candidate).\n    if (event.isComposing || event.keyCode === 229) return false;\n    // What the user sees, not what is intended: right after Escape the platform has hidden the\n    // popup but its `toggle` (and the library's notification) is still queued, and an open that\n    // is still committing shows nothing yet. Enter must submit and arrows must open in both.\n    const isOpen = isPopoverOpen(popover.popupRef.current);\n    switch (event.key) {\n      case \"ArrowDown\":\n        event.preventDefault();\n        if (event.altKey) {\n          if (!isOpen) popover.requestOpen(event, \"activate\");\n        } else if (!isOpen) {\n          pendingEdge.current = \"first\";\n          popover.requestOpen(event, \"activate\");\n        } else {\n          move(1);\n        }\n        return true;\n      case \"ArrowUp\":\n        event.preventDefault();\n        if (event.altKey) {\n          if (isOpen) {\n            const active = activeEnabled();\n            if (active !== null) accept(active, event);\n            else popover.requestClose(event, \"activate\");\n          }\n        } else if (!isOpen) {\n          pendingEdge.current = \"last\";\n          popover.requestOpen(event, \"activate\");\n        } else {\n          move(-1);\n        }\n        return true;\n      case \"Enter\": {\n        if (isOpen) {\n          // An open listbox means the user is choosing: never submit from here.\n          event.preventDefault();\n          const active = activeEnabled();\n          if (active !== null) accept(active, event);\n          else if (allowCustomValue && !commitText(event, true)) {\n            popover.requestClose(event, \"activate\");\n          }\n          return true;\n        }\n        // Closed: not prevented, so a form still submits. The key's default action (implicit\n        // submission) must see the optimistic hidden value: Firefox submits before React's\n        // scheduled flush of the optimistic render, so it is flushed here (design 5.3).\n        if (allowCustomValue) flushSync(() => commitText(event, false));\n        return false;\n      }\n      case \"Home\":\n      case \"End\":\n      case \"ArrowLeft\":\n      case \"ArrowRight\":\n        // APG: the caret keys move visual focus to the input (not prevented: the caret moves).\n        if (activeRef.current !== null) setActive(null);\n        return false;\n      default:\n        return false;\n    }\n  };\n\n  /** Focus has left the input and the popup (design 5.4). */\n  const leave = (event: Event): void => {\n    // `disabled`: nothing dispatches (disabling a focused input blurs it).\n    if (disabled) return;\n    const popup = popover.popupRef.current;\n    if (popup !== null && isPopoverOpen(popup)) {\n      popover.recordCloseIntent({ reason: \"dismiss\", event });\n      popup.hidePopover();\n    }\n    pendingEdge.current = null;\n    if (allowCustomValue) {\n      commitText(event, false);\n      return;\n    }\n    const label = labelFor(selection.optimistic);\n    if (textRef.current !== label) writeText(label, \"dismiss\", event);\n  };\n  const leaveRef = useRef(leave);\n  useInsertionEffect(() => {\n    leaveRef.current = leave;\n  });\n\n  const focusOut = (event: FocusEvent): void => {\n    const input = inputRef.current;\n    const popup = popover.popupRef.current;\n    const next = event.relatedTarget;\n    if (next instanceof Node) {\n      if (next === input || (popup !== null && popup.contains(next))) return;\n      leave(event);\n      return;\n    }\n    // No related target: the window lost focus (nothing to do), or a click landed on something\n    // that takes no focus (the page itself: focus moved to <body>). Decide after the click.\n    if (input === null) return;\n    const doc = input.ownerDocument;\n    setTimeout(() => {\n      if (!doc.hasFocus()) return;\n      const active = doc.activeElement;\n      if (active === input || (active !== null && popup !== null && popup.contains(active))) {\n        return;\n      }\n      if (input.isConnected) leaveRef.current(event);\n    }, 0);\n  };\n\n  const inputClick = (event: MouseEvent): void => {\n    if (disabled || !openOnClick) return;\n    popover.requestOpen(event, \"activate\");\n  };\n\n  const context: ComboboxContextValue = {\n    popover,\n    ids,\n    value: selection.optimistic,\n    valuePending: selection.pending,\n    pending: state.pending,\n    inputValue: text,\n    query,\n    stale,\n    activeValue,\n    empty,\n    loading,\n    hasLabel: labelCount > 0,\n    disabled,\n    inputRef,\n    listRef,\n    registerOption,\n    registerStatus,\n    registerLabel,\n    setActive,\n    accept,\n    clear,\n    typed,\n    keyDown,\n    focusOut,\n    inputClick,\n  };\n\n  return (\n    <ComboboxContext value={context}>\n      {name !== undefined && (\n        <input\n          ref={hiddenRef}\n          type=\"hidden\"\n          name={name}\n          form={form}\n          value={selection.optimistic ?? \"\"}\n        />\n      )}\n      {resolveStateValue(children, state)}\n    </ComboboxContext>\n  );\n}\n\nComboboxRoot.displayName = \"ComboboxRoot\";\n"],"mappings":"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"}

package/dist/combobox/combobox-trigger.d.mts

@@ -0,0 +1,36 @@
+import { RenderProp, StateValue } from "../internal/types.mjs";
+import { CSSProperties, ComponentPropsWithRef, ReactNode } from "react";
+//#region src/combobox/combobox-trigger.d.ts
+export interface ComboboxTriggerState {
+  /** Optimistic open state. */
+  readonly open: boolean;
+  /** The open (or close) transition is in flight. */
+  readonly pending: boolean;
+  readonly disabled: boolean;
+}
+export interface ComboboxTriggerProps extends Omit<ComponentPropsWithRef<"button">, "onClick" | "onPointerDown" | "onMouseDown" | "onPointerCancel" | "tabIndex" | "aria-expanded" | "aria-controls" | "disabled" | "className" | "style" | "children"> {
+  /** Disables this button; the Root's `disabled` does too. */
+  disabled?: boolean;
+  className?: StateValue<string | undefined, ComboboxTriggerState>;
+  style?: StateValue<CSSProperties | undefined, ComboboxTriggerState>;
+  /** Rendered from optimistic state; must not suspend. */
+  children?: StateValue<ReactNode, ComboboxTriggerState>;
+  /** Should render a `<button>`. */
+  render?: RenderProp<ComponentPropsWithRef<"button">, ComboboxTriggerState>;
+}
+/**
+ * The optional button that toggles the listbox: `<button type="button" tabindex="-1"
+ * aria-expanded aria-controls>` (the APG keeps it out of the Tab sequence; the input is the one
+ * stop). A press does not take focus from the input, and a click focuses the input. No
+ * `commandfor`: the listbox is anchored to the input, never to this button (design 1).
+ *
+ * Owned keys: `type` (on a `<button>`), `tabIndex`, `disabled`, `aria-expanded`,
+ * `aria-controls` (token-merged), `onClick`, `onPointerDown`, `onPointerCancel`, `onMouseDown`,
+ * `data-open`, `data-pending`, `data-disabled`.
+ */
+export declare function ComboboxTrigger({ disabled: ownDisabled, className, style, children, render, ...rest }: ComboboxTriggerProps): ReactNode;
+export declare namespace ComboboxTrigger {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=combobox-trigger.d.mts.map

package/dist/combobox/combobox-trigger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combobox-trigger.d.mts","names":[],"sources":["../../src/combobox/combobox-trigger.tsx"],"mappings":";;;iBAeiB;;WAEN;;WAEA;WACA;;iBAGM,6BAA6B,KAC5C;;EAcA;EACA,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;;EAE9C,WAAW,WAAW,WAAW;;EAEjC,SAAS,WAAW,iCAAiC;;;;;;;;;;;;wBAqCvC,kBACd,UAAU,aACV,WACA,OACA,UACA,WACG,QACF,uBAAoB;yBAPP"}