@funstack/ui 0.1.0-alpha.4 → 0.1.0-alpha.6

package/dist/internal/use-action-trigger.mjs

@@ -7,19 +7,23 @@ function report(error) {
 	else console.error(error);
 }
 /**
-* The transition of a pure-trigger part: an `action` with no state of its own (`Dialog.Close`,
-* `Popover.Close`, `Menu.Item`; conventions 3.4). Same superseded-rejection surfacing as
-* `useControllableAction`: React keeps only the newest thenable per `useTransition`, so the
-* rejection of a run that a later run superseded would be dropped. The hook catches it and throws
-* it from render, so it reaches the same boundary as the latest run's rejection does.
+* The transition of a pure-trigger part: an `action` with no state of its own (`Button`,
+* `Dialog.Close`, `Popover.Close`, `Menu.Item`; conventions 3.4). Same superseded-rejection
+* surfacing as `useControllableAction`: React keeps only the newest thenable per `useTransition`,
+* so the rejection of a run that a later run superseded would be dropped. The hook catches it and
+* throws it from render, so it reaches the same boundary as the latest run's rejection does.
+*
+* The argument is the options object, or (the older positional form) `openGeneration` alone.
 */
-function useActionTrigger(openGeneration) {
+function useActionTrigger(options) {
+	const { openGeneration, ignoreWhilePending = false } = typeof options === "function" ? { openGeneration: options } : options ?? {};
 	const [supersededError, setSupersededError] = useState(null);
 	const hasSupersededError = useRef(false);
 	if (supersededError !== null) throw supersededError.error;
 	const [pending, startOwnTransition] = useTransition();
 	const latest = useRef(0);
 	const mounted = useRef(false);
+	const inFlight = useRef(0);
 	useEffect(() => {
 		mounted.current = true;
 		return () => {
@@ -27,12 +31,15 @@ function useActionTrigger(openGeneration) {
 		};
 	}, []);
 	const run = (work, then) => {
+		if (ignoreWhilePending && inFlight.current > 0) return false;
+		inFlight.current++;
 		const id = ++latest.current;
 		const generation = openGeneration?.();
 		startOwnTransition(async () => {
 			try {
 				await work();
 			} catch (error) {
+				inFlight.current--;
 				if (id === latest.current) throw error;
 				if (!mounted.current) return;
 				if (hasSupersededError.current) {
@@ -43,9 +50,11 @@ function useActionTrigger(openGeneration) {
 				setSupersededError({ error });
 				return;
 			}
+			inFlight.current--;
 			if (openGeneration !== void 0 && openGeneration() !== generation) return;
 			then?.();
 		});
+		return true;
 	};
 	return {
 		pending,

package/dist/internal/use-action-trigger.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-action-trigger.mjs","names":[],"sources":["../../src/internal/use-action-trigger.ts"],"sourcesContent":["\"use client\";\nimport { useEffect, useRef, useState, useTransition } from \"react\";\n\nexport interface ActionTrigger {\n  /** A run started through this hook is in flight (the part's own transition). */\n  readonly pending: boolean;\n  /**\n   * Runs `work` inside the part's own transition and, once it resolves, `then` (still inside the\n   * transition: a Close part's close, a menu item's close). A rejection skips `then` and reaches\n   * the nearest Error Boundary above the part, also when a later run superseded this one. With\n   * `openGeneration` (the hook's argument), `then` is skipped when a newer open of the overlay\n   * started after the run began.\n   */\n  readonly run: (work: () => unknown, then?: () => void) => void;\n}\n\n/** Reports an error that cannot reach a boundary (conventions 2.4: never swallow). */\nfunction report(error: unknown): void {\n  if (typeof reportError === \"function\") reportError(error);\n  else console.error(error);\n}\n\n/**\n * The transition of a pure-trigger part: an `action` with no state of its own (`Dialog.Close`,\n * `Popover.Close`, `Menu.Item`; conventions 3.4). Same superseded-rejection surfacing as\n * `useControllableAction`: React keeps only the newest thenable per `useTransition`, so the\n * rejection of a run that a later run superseded would be dropped. The hook catches it and throws\n * it from render, so it reaches the same boundary as the latest run's rejection does.\n */\nexport function useActionTrigger(openGeneration?: () => number): ActionTrigger {\n  // Thrown before `useTransition` on purpose (see use-controllable-action.ts): in the retry of\n  // an errored render `useTransition` would suspend on the newer run's pending thenable.\n  const [supersededError, setSupersededError] = useState<{ readonly error: unknown } | null>(null);\n  const hasSupersededError = useRef(false);\n  if (supersededError !== null) throw supersededError.error;\n\n  const [pending, startOwnTransition] = useTransition();\n  const latest = useRef(0);\n  const mounted = useRef(false);\n\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n    };\n  }, []);\n\n  const run = (work: () => unknown, then?: () => void): void => {\n    const id = ++latest.current;\n    // The open this run belongs to (design/components/popover.md, review M2 / PO rule): if the\n    // user dismisses and re-opens while the action runs, its close must not close the new open.\n    const generation = openGeneration?.();\n    startOwnTransition(async () => {\n      try {\n        await work();\n      } catch (error) {\n        // The latest run's rejection takes React's own route to the boundary.\n        if (id === latest.current) throw error;\n        if (!mounted.current) return;\n        if (hasSupersededError.current) {\n          report(error);\n          return;\n        }\n        hasSupersededError.current = true;\n        // After an await, outside the transition: urgent, so the part re-renders and throws.\n        setSupersededError({ error });\n        return;\n      }\n      if (openGeneration !== undefined && openGeneration() !== generation) return;\n      then?.();\n    });\n  };\n\n  return { pending, run };\n}\n"],"mappings":";;;;AAiBA,SAAS,OAAO,OAAsB;CACpC,IAAI,OAAO,gBAAgB,YAAY,YAAY,KAAK;MACnD,QAAQ,MAAM,KAAK;AAC1B;;;;;;;;AASA,SAAgB,iBAAiB,gBAA8C;CAG7E,MAAM,CAAC,iBAAiB,sBAAsB,SAA6C,IAAI;CAC/F,MAAM,qBAAqB,OAAO,KAAK;CACvC,IAAI,oBAAoB,MAAM,MAAM,gBAAgB;CAEpD,MAAM,CAAC,SAAS,sBAAsB,cAAc;CACpD,MAAM,SAAS,OAAO,CAAC;CACvB,MAAM,UAAU,OAAO,KAAK;CAE5B,gBAAgB;EACd,QAAQ,UAAU;EAClB,aAAa;GACX,QAAQ,UAAU;EACpB;CACF,GAAG,CAAC,CAAC;CAEL,MAAM,OAAO,MAAqB,SAA4B;EAC5D,MAAM,KAAK,EAAE,OAAO;EAGpB,MAAM,aAAa,iBAAiB;EACpC,mBAAmB,YAAY;GAC7B,IAAI;IACF,MAAM,KAAK;GACb,SAAS,OAAO;IAEd,IAAI,OAAO,OAAO,SAAS,MAAM;IACjC,IAAI,CAAC,QAAQ,SAAS;IACtB,IAAI,mBAAmB,SAAS;KAC9B,OAAO,KAAK;KACZ;IACF;IACA,mBAAmB,UAAU;IAE7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B;GACF;GACA,IAAI,mBAAmB,KAAA,KAAa,eAAe,MAAM,YAAY;GACrE,OAAO;EACT,CAAC;CACH;CAEA,OAAO;EAAE;EAAS;CAAI;AACxB"}
+{"version":3,"file":"use-action-trigger.mjs","names":[],"sources":["../../src/internal/use-action-trigger.ts"],"sourcesContent":["\"use client\";\nimport { useEffect, useRef, useState, useTransition } from \"react\";\n\nexport interface ActionTriggerOptions {\n  /**\n   * Open generation of the overlay a `then` belongs to: `then` is skipped when a newer open of\n   * the overlay started after the run began.\n   */\n  readonly openGeneration?: (() => number) | undefined;\n  /**\n   * Ignore `run` while a run is in flight (conventions 2.5): `run` returns `false` and starts\n   * nothing. In flight means the hook's synchronous in-flight counter is non-zero (it also sees\n   * two activations in one task, before React re-rendered); the last render's `pending` is not\n   * consulted, so a click in a settled-but-held commit window runs. Default `false`; on for\n   * `Button` (#79) until #81 makes it the only behaviour.\n   */\n  readonly ignoreWhilePending?: boolean | undefined;\n}\n\nexport interface ActionTrigger {\n  /** A run started through this hook is in flight (the part's own transition). */\n  readonly pending: boolean;\n  /**\n   * Runs `work` inside the part's own transition and, once it resolves, `then` (still inside the\n   * transition: a Close part's close, a menu item's close). A rejection skips `then` and reaches\n   * the nearest Error Boundary above the part, also when a later run superseded this one. With\n   * `openGeneration`, `then` is skipped when a newer open of the overlay started after the run\n   * began. Returns `false` when the run was ignored (`ignoreWhilePending`), so the part can\n   * `preventDefault()` the activation, and `true` otherwise.\n   */\n  readonly run: (work: () => unknown, then?: () => void) => boolean;\n}\n\n/** Reports an error that cannot reach a boundary (conventions 2.4: never swallow). */\nfunction report(error: unknown): void {\n  if (typeof reportError === \"function\") reportError(error);\n  else console.error(error);\n}\n\n/**\n * The transition of a pure-trigger part: an `action` with no state of its own (`Button`,\n * `Dialog.Close`, `Popover.Close`, `Menu.Item`; conventions 3.4). Same superseded-rejection\n * surfacing as `useControllableAction`: React keeps only the newest thenable per `useTransition`,\n * so the rejection of a run that a later run superseded would be dropped. The hook catches it and\n * throws it from render, so it reaches the same boundary as the latest run's rejection does.\n *\n * The argument is the options object, or (the older positional form) `openGeneration` alone.\n */\nexport function useActionTrigger(options?: ActionTriggerOptions | (() => number)): ActionTrigger {\n  const { openGeneration, ignoreWhilePending = false }: ActionTriggerOptions =\n    typeof options === \"function\" ? { openGeneration: options } : (options ?? {});\n\n  // Thrown before `useTransition` on purpose (see use-controllable-action.ts): in the retry of\n  // an errored render `useTransition` would suspend on the newer run's pending thenable.\n  const [supersededError, setSupersededError] = useState<{ readonly error: unknown } | null>(null);\n  const hasSupersededError = useRef(false);\n  if (supersededError !== null) throw supersededError.error;\n\n  const [pending, startOwnTransition] = useTransition();\n  const latest = useRef(0);\n  const mounted = useRef(false);\n  // Runs whose work has not settled yet. Updated synchronously, so a second activation in the\n  // same task (React's `pending` is still the stale render value) is seen (conventions 2.5).\n  const inFlight = useRef(0);\n\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n    };\n  }, []);\n\n  const run = (work: () => unknown, then?: () => void): boolean => {\n    // The own counter only, not the rendered `pending` (design/components/button.md 5.2): after\n    // the work settled, a commit held by entanglement must not drop a new activation.\n    if (ignoreWhilePending && inFlight.current > 0) return false;\n    inFlight.current++;\n    const id = ++latest.current;\n    // The open this run belongs to (design/components/popover.md, review M2 / PO rule): if the\n    // user dismisses and re-opens while the action runs, its close must not close the new open.\n    const generation = openGeneration?.();\n    startOwnTransition(async () => {\n      try {\n        await work();\n      } catch (error) {\n        inFlight.current--;\n        // The latest run's rejection takes React's own route to the boundary.\n        if (id === latest.current) throw error;\n        if (!mounted.current) return;\n        if (hasSupersededError.current) {\n          report(error);\n          return;\n        }\n        hasSupersededError.current = true;\n        // After an await, outside the transition: urgent, so the part re-renders and throws.\n        setSupersededError({ error });\n        return;\n      }\n      inFlight.current--;\n      if (openGeneration !== undefined && openGeneration() !== generation) return;\n      then?.();\n    });\n    return true;\n  };\n\n  return { pending, run };\n}\n"],"mappings":";;;;AAkCA,SAAS,OAAO,OAAsB;CACpC,IAAI,OAAO,gBAAgB,YAAY,YAAY,KAAK;MACnD,QAAQ,MAAM,KAAK;AAC1B;;;;;;;;;;AAWA,SAAgB,iBAAiB,SAAgE;CAC/F,MAAM,EAAE,gBAAgB,qBAAqB,UAC3C,OAAO,YAAY,aAAa,EAAE,gBAAgB,QAAQ,IAAK,WAAW,CAAC;CAI7E,MAAM,CAAC,iBAAiB,sBAAsB,SAA6C,IAAI;CAC/F,MAAM,qBAAqB,OAAO,KAAK;CACvC,IAAI,oBAAoB,MAAM,MAAM,gBAAgB;CAEpD,MAAM,CAAC,SAAS,sBAAsB,cAAc;CACpD,MAAM,SAAS,OAAO,CAAC;CACvB,MAAM,UAAU,OAAO,KAAK;CAG5B,MAAM,WAAW,OAAO,CAAC;CAEzB,gBAAgB;EACd,QAAQ,UAAU;EAClB,aAAa;GACX,QAAQ,UAAU;EACpB;CACF,GAAG,CAAC,CAAC;CAEL,MAAM,OAAO,MAAqB,SAA+B;EAG/D,IAAI,sBAAsB,SAAS,UAAU,GAAG,OAAO;EACvD,SAAS;EACT,MAAM,KAAK,EAAE,OAAO;EAGpB,MAAM,aAAa,iBAAiB;EACpC,mBAAmB,YAAY;GAC7B,IAAI;IACF,MAAM,KAAK;GACb,SAAS,OAAO;IACd,SAAS;IAET,IAAI,OAAO,OAAO,SAAS,MAAM;IACjC,IAAI,CAAC,QAAQ,SAAS;IACtB,IAAI,mBAAmB,SAAS;KAC9B,OAAO,KAAK;KACZ;IACF;IACA,mBAAmB,UAAU;IAE7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B;GACF;GACA,SAAS;GACT,IAAI,mBAAmB,KAAA,KAAa,eAAe,MAAM,YAAY;GACrE,OAAO;EACT,CAAC;EACD,OAAO;CACT;CAEA,OAAO;EAAE;EAAS;CAAI;AACxB"}

package/dist/internal/use-field-control.mjs

@@ -1,7 +1,7 @@
 "use client";
 import { dataAttr } from "./data-attr.mjs";
-import { mergeRefs } from "./merge-props.mjs";
 import { useDevWarning } from "./use-dev-warning.mjs";
+import { mergeRefs } from "./merge-props.mjs";
 import { FieldContext } from "./field-context.mjs";
 import { use, useCallback, useLayoutEffect, useMemo, useRef } from "react";
 //#region src/internal/use-field-control.ts

package/dist/internal/use-popover-root.mjs

@@ -1,9 +1,9 @@
 "use client";
 import { createActionDetails } from "./action-details.mjs";
+import { useDevWarning } from "./use-dev-warning.mjs";
 import { transitionTypes } from "./transition-types.mjs";
 import { useLatest } from "./use-latest.mjs";
 import { useControllableAction } from "./use-controllable-action.mjs";
-import { useDevWarning } from "./use-dev-warning.mjs";
 import { useCallback, useId, useMemo, useRef, useState } from "react";
 //#region src/internal/use-popover-root.ts
 function isPopoverOpen(element) {

package/dist/internal/use-render.mjs

@@ -1,6 +1,6 @@
 "use client";
 import { mergeRefs } from "./merge-props.mjs";
-import { renderElement, rendersButton, resolveStateValue } from "./render-element.mjs";
+import { isHostButton, renderElement, rendersButton, resolveStateValue } from "./render-element.mjs";
 import { isValidElement, useMemo } from "react";
 //#region src/internal/use-render.tsx
 /**
@@ -23,6 +23,6 @@ function useRender(options) {
 	});
 }
 //#endregion
-export { rendersButton, resolveStateValue, useRender };
+export { isHostButton, rendersButton, resolveStateValue, useRender };
 
 //# sourceMappingURL=use-render.mjs.map

package/dist/internal/use-render.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-render.mjs","names":[],"sources":["../../src/internal/use-render.tsx"],"sourcesContent":["\"use client\";\nimport { isValidElement, useMemo } from \"react\";\nimport type { ReactNode, Ref } from \"react\";\nimport { mergeRefs } from \"./merge-props.js\";\nimport { renderElement } from \"./render-element.js\";\nimport type { ElementLikeProps, RenderElementOptions } from \"./render-element.js\";\n\nexport { rendersButton, resolveStateValue } from \"./render-element.js\";\nexport type { DataAttributes } from \"./render-element.js\";\n\nexport interface UseRenderOptions<Props extends ElementLikeProps, State> extends Omit<\n  RenderElementOptions<Props, State>,\n  \"ref\"\n> {\n  /** The library's own ref, if the part needs the DOM node. */\n  ref?: Ref<unknown> | undefined;\n}\n\n/**\n * Resolves `render` and the function-form `className` / `style` / `children` of a part against\n * its state and produces the element (conventions 1.2, 1.3, 1.4). The pure work is\n * `renderElement` (`render-element.ts`); this hook adds the memoised ref merge.\n */\nexport function useRender<Props extends ElementLikeProps, State>(\n  options: UseRenderOptions<Props, State>,\n): ReactNode {\n  const { render, props, ref } = options;\n\n  const consumerRef = (props as ElementLikeProps).ref;\n  const elementRef = isValidElement<ElementLikeProps>(render) ? render.props.ref : undefined;\n  // Memoised so that the callback ref keeps its identity across renders and React does not\n  // detach and re-attach the node every time.\n  const mergedRef = useMemo(\n    () => mergeRefs(ref, consumerRef, elementRef),\n    [ref, consumerRef, elementRef],\n  );\n\n  return renderElement<Props, State>({ ...options, ref: mergedRef });\n}\n"],"mappings":";;;;;;;;;;AAuBA,SAAgB,UACd,SACW;CACX,MAAM,EAAE,QAAQ,OAAO,QAAQ;CAE/B,MAAM,cAAe,MAA2B;CAChD,MAAM,aAAa,eAAiC,MAAM,IAAI,OAAO,MAAM,MAAM,KAAA;CAGjF,MAAM,YAAY,cACV,UAAU,KAAK,aAAa,UAAU,GAC5C;EAAC;EAAK;EAAa;CAAU,CAC/B;CAEA,OAAO,cAA4B;EAAE,GAAG;EAAS,KAAK;CAAU,CAAC;AACnE"}
+{"version":3,"file":"use-render.mjs","names":[],"sources":["../../src/internal/use-render.tsx"],"sourcesContent":["\"use client\";\nimport { isValidElement, useMemo } from \"react\";\nimport type { ReactNode, Ref } from \"react\";\nimport { mergeRefs } from \"./merge-props.js\";\nimport { renderElement } from \"./render-element.js\";\nimport type { ElementLikeProps, RenderElementOptions } from \"./render-element.js\";\n\nexport { isHostButton, rendersButton, resolveStateValue } from \"./render-element.js\";\nexport type { DataAttributes } from \"./render-element.js\";\n\nexport interface UseRenderOptions<Props extends ElementLikeProps, State> extends Omit<\n  RenderElementOptions<Props, State>,\n  \"ref\"\n> {\n  /** The library's own ref, if the part needs the DOM node. */\n  ref?: Ref<unknown> | undefined;\n}\n\n/**\n * Resolves `render` and the function-form `className` / `style` / `children` of a part against\n * its state and produces the element (conventions 1.2, 1.3, 1.4). The pure work is\n * `renderElement` (`render-element.ts`); this hook adds the memoised ref merge.\n */\nexport function useRender<Props extends ElementLikeProps, State>(\n  options: UseRenderOptions<Props, State>,\n): ReactNode {\n  const { render, props, ref } = options;\n\n  const consumerRef = (props as ElementLikeProps).ref;\n  const elementRef = isValidElement<ElementLikeProps>(render) ? render.props.ref : undefined;\n  // Memoised so that the callback ref keeps its identity across renders and React does not\n  // detach and re-attach the node every time.\n  const mergedRef = useMemo(\n    () => mergeRefs(ref, consumerRef, elementRef),\n    [ref, consumerRef, elementRef],\n  );\n\n  return renderElement<Props, State>({ ...options, ref: mergedRef });\n}\n"],"mappings":";;;;;;;;;;AAuBA,SAAgB,UACd,SACW;CACX,MAAM,EAAE,QAAQ,OAAO,QAAQ;CAE/B,MAAM,cAAe,MAA2B;CAChD,MAAM,aAAa,eAAiC,MAAM,IAAI,OAAO,MAAM,MAAM,KAAA;CAGjF,MAAM,YAAY,cACV,UAAU,KAAK,aAAa,UAAU,GAC5C;EAAC;EAAK;EAAa;CAAU,CAC/B;CAEA,OAAO,cAA4B;EAAE,GAAG;EAAS,KAAK;CAAU,CAAC;AACnE"}

package/dist/internal/use-roving-focus.mjs

@@ -24,29 +24,56 @@ function isNestedOut(el, root) {
 	for (let node = el; node !== null && node !== root; node = node.parentElement) if (node.getAttribute("role") === "toolbar" || node.hasAttribute("popover") || node.tagName === "DIALOG") return true;
 	return false;
 }
+function isRadio(el) {
+	return el instanceof HTMLInputElement && el.type === "radio";
+}
+/** The unit's representative: its checked radio, else its first (design 17.2 item 2). */
+function representative(unit) {
+	return unit.find((radio) => radio.checked) ?? unit[0];
+}
 /**
-* The items of `root` in DOM order (design 6.2): its focusable descendants minus `:disabled`,
+* The items of `root` (design 6.2 and 17.2): its focusable descendants minus `:disabled`,
 * `inert`, invisible, nested-toolbar / popover / dialog content, and elements whose own
 * `tabindex="-1"` was not written by this engine (`managed`). `aria-disabled` elements are items.
+* Native radios that share a `name` form one unit, represented in `items` by its checked radio
+* (else its first), at the position of the unit's first radio.
 */
-function itemsOf(root, managed) {
-	const items = [];
+function collectItems(root, managed) {
+	const candidates = [];
+	const byName = /* @__PURE__ */ new Map();
+	const units = /* @__PURE__ */ new Map();
 	for (const el of root.querySelectorAll(FOCUSABLE)) {
 		if (el.matches(":disabled")) continue;
 		if (el.closest("[inert]") !== null) continue;
 		if (el.getAttribute("tabindex") === "-1" && !managed.has(el)) continue;
 		if (isNestedOut(el, root)) continue;
 		if (!isVisible(el)) continue;
-		items.push(el);
+		if (isRadio(el)) {
+			const unit = el.name === "" ? void 0 : byName.get(el.name);
+			if (unit !== void 0) {
+				unit.push(el);
+				units.set(el, unit);
+				continue;
+			}
+			const created = [el];
+			if (el.name !== "") byName.set(el.name, created);
+			units.set(el, created);
+		}
+		candidates.push(el);
 	}
-	return items;
+	return {
+		items: candidates.map((el) => {
+			const unit = units.get(el);
+			return unit === void 0 ? el : representative(unit);
+		}),
+		units
+	};
 }
 const BUTTON_LIKE_INPUTS = /* @__PURE__ */ new Set([
 	"button",
 	"submit",
 	"reset",
 	"checkbox",
-	"radio",
 	"image",
 	"color",
 	"file"
@@ -58,10 +85,12 @@ const ARROW_OWNING_ROLES = /* @__PURE__ */ new Set([
 	"slider"
 ]);
 /**
-* An item that owns the arrow keys (design 6.3): text-like `input`s, `textarea`, `select`,
-* `[contenteditable]`, and `role` `textbox` / `combobox` / `spinbutton` / `slider`.
+* An item that owns the arrow keys (design 6.3 and 17.2): text-like `input`s, `textarea`,
+* `select`, `[contenteditable]`, `role` `textbox` / `combobox` / `spinbutton` / `slider`, and a
+* native `input[type=radio]` (its group's own arrows check as they move). A custom
+* `[role="radio"]` is an ordinary item, as it is under native `focusgroup`.
 */
-function isTextEntryItem(el) {
+function ownsArrows(el) {
 	const role = el.getAttribute("role");
 	if (role !== null && ARROW_OWNING_ROLES.has(role)) return true;
 	if (el instanceof HTMLInputElement) return !BUTTON_LIKE_INPUTS.has(el.type);
@@ -114,16 +143,24 @@ function createEngine() {
 			release();
 			return;
 		}
-		const items = itemsOf(root, managed);
-		if (!options.memory) current = focused instanceof HTMLElement && items.includes(focused) ? focused : options.entry(items) ?? null;
-		else if (current === null || !items.includes(current)) current = options.entry(items) ?? null;
-		for (const el of items) {
+		const { items, units } = collectItems(root, managed);
+		/** Every element the engine writes: the items and the other radios of their units. */
+		const all = new Set(items);
+		for (const radio of units.keys()) all.add(radio);
+		/** The item standing for `el`: its unit's representative for a radio, else itself. */
+		const itemOf = (el) => {
+			const unit = units.get(el);
+			return unit === void 0 ? el : representative(unit);
+		};
+		if (!options.memory) current = focused instanceof HTMLElement && all.has(focused) ? focused : options.entry(items) ?? null;
+		else if (current === null || !all.has(current) || !items.includes(itemOf(current))) current = options.entry(items) ?? null;
+		for (const el of all) {
 			if (!managed.has(el)) managed.set(el, el.getAttribute("tabindex"));
 			const want = el === current ? "0" : "-1";
 			if (el.getAttribute("tabindex") !== want) el.setAttribute("tabindex", want);
 		}
 		for (const el of [...managed.keys()]) {
-			if (items.includes(el)) continue;
+			if (all.has(el)) continue;
 			if (!root.contains(el)) restore(el);
 			else if (el.getAttribute("tabindex") !== "-1") el.setAttribute("tabindex", "-1");
 		}
@@ -133,7 +170,8 @@ function createEngine() {
 		if (!active(options) || options.native) return;
 		const target = event.target;
 		if (!(target instanceof HTMLElement)) return;
-		if (!itemsOf(event.currentTarget, managed).includes(target)) return;
+		const { items, units } = collectItems(event.currentTarget, managed);
+		if (!items.includes(target) && !units.has(target)) return;
 		current = target;
 		apply(event.currentTarget, target);
 	};
@@ -149,7 +187,8 @@ function createEngine() {
 		if (!active(options) || options.native) return;
 		const target = event.target;
 		if (!(target instanceof Node)) return;
-		const item = itemsOf(event.currentTarget, managed).find((el) => el.contains(target));
+		const { items, units } = collectItems(event.currentTarget, managed);
+		const item = [...items, ...units.keys()].find((el) => el.contains(target));
 		if (item === void 0) return;
 		current = item;
 		apply(event.currentTarget, options.memory ? item : event.currentTarget.ownerDocument.activeElement);
@@ -161,11 +200,18 @@ function createEngine() {
 		const root = event.currentTarget;
 		const target = event.target;
 		if (!(target instanceof HTMLElement)) return;
-		const items = itemsOf(root, managed);
-		const index = items.indexOf(target);
+		const { items, units } = collectItems(root, managed);
+		const unit = units.get(target);
+		const index = items.indexOf(unit === void 0 ? target : representative(unit));
 		if (index < 0) return;
-		if (isTextEntryItem(target)) {
+		if (ownsArrows(target)) {
 			if (event.key !== "Tab") return;
+			const checked = unit?.find((radio) => radio.checked);
+			if (checked !== void 0 && checked !== target) {
+				event.preventDefault();
+				focusItem(checked);
+				return;
+			}
 			const next = items[index + (event.shiftKey ? -1 : 1)];
 			if (next === void 0) return;
 			event.preventDefault();
@@ -250,6 +296,6 @@ function useRovingFocus(ref, options) {
 	return engine.handlers;
 }
 //#endregion
-export { isTextEntryItem, itemsOf, useRovingFocus };
+export { collectItems, ownsArrows, useRovingFocus };
 
 //# sourceMappingURL=use-roving-focus.mjs.map

package/dist/internal/use-roving-focus.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-roving-focus.mjs","names":[],"sources":["../../src/internal/use-roving-focus.ts"],"sourcesContent":["\"use client\";\nimport { useEffect, useInsertionEffect, useLayoutEffect, useState } from \"react\";\nimport type { FocusEvent, KeyboardEvent, PointerEvent, RefObject } from \"react\";\n\n// The roving-focus engine shared by `Toolbar.Root` and a standalone `ToggleGroup.Root`\n// (design/components/toggle-group.md section 6, conventions 3.2 and 7.4). Items are the focusable\n// descendants of the container, found in the DOM; which one is the Tab stop is urgent library\n// state kept outside React and written to the items as `tabindex` through the DOM.\n\nexport type RovingOrientation = \"horizontal\" | \"vertical\";\n\nexport interface RovingFocusOptions {\n  /** `false`: the engine writes nothing and handles nothing (a ToggleGroup inside a Toolbar). Default `true`. */\n  readonly enabled?: boolean;\n  readonly orientation: RovingOrientation;\n  readonly loop: boolean;\n  /** The native `focusgroup` path is active: write no `tabindex`, handle no navigation key. */\n  readonly native: boolean;\n  /** Which item is the Tab stop when there is no usable memory. */\n  readonly entry: (items: readonly HTMLElement[]) => HTMLElement | undefined;\n  /**\n   * `true`: the last focused item stays the Tab stop after focus leaves (Toolbar). `false`: while\n   * focus is inside, the focused item is the stop (so Tab and Shift+Tab leave the container);\n   * once it leaves, the stop is re-derived from `entry` (ToggleGroup: the pressed Item).\n   */\n  readonly memory: boolean;\n}\n\nexport interface RovingFocusHandlers {\n  readonly onKeyDown: (event: KeyboardEvent<HTMLElement>) => void;\n  readonly onFocus: (event: FocusEvent<HTMLElement>) => void;\n  readonly onBlur: (event: FocusEvent<HTMLElement>) => void;\n  readonly onPointerDown: (event: PointerEvent<HTMLElement>) => void;\n}\n\nconst FOCUSABLE = [\n  \"button\",\n  \"a[href]\",\n  'input:not([type=\"hidden\"])',\n  \"select\",\n  \"textarea\",\n  \"summary\",\n  '[contenteditable]:not([contenteditable=\"false\"])',\n  \"[tabindex]\",\n].join(\",\");\n\nfunction isVisible(el: HTMLElement): boolean {\n  // jsdom has no `checkVisibility`; `hidden` is the part of it a test can observe there.\n  if (typeof el.checkVisibility === \"function\") return el.checkVisibility();\n  return el.closest(\"[hidden]\") === null;\n}\n\n/**\n * Whether `el` or an ancestor below `root` takes it out of `root`'s sequence: a nested toolbar\n * (its own sequence), a popover or a dialog rendered inside the container (a `Menu.Popup`'s items\n * are the menu's).\n */\nfunction isNestedOut(el: HTMLElement, root: HTMLElement): boolean {\n  for (let node: Element | null = el; node !== null && node !== root; node = node.parentElement) {\n    if (\n      node.getAttribute(\"role\") === \"toolbar\" ||\n      node.hasAttribute(\"popover\") ||\n      node.tagName === \"DIALOG\"\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * The items of `root` in DOM order (design 6.2): its focusable descendants minus `:disabled`,\n * `inert`, invisible, nested-toolbar / popover / dialog content, and elements whose own\n * `tabindex=\"-1\"` was not written by this engine (`managed`). `aria-disabled` elements are items.\n */\nexport function itemsOf(root: HTMLElement, managed: { has(el: Element): boolean }): HTMLElement[] {\n  const items: HTMLElement[] = [];\n  for (const el of root.querySelectorAll<HTMLElement>(FOCUSABLE)) {\n    if (el.matches(\":disabled\")) continue;\n    if (el.closest(\"[inert]\") !== null) continue;\n    if (el.getAttribute(\"tabindex\") === \"-1\" && !managed.has(el)) continue;\n    if (isNestedOut(el, root)) continue;\n    if (!isVisible(el)) continue;\n    items.push(el);\n  }\n  return items;\n}\n\nconst BUTTON_LIKE_INPUTS = new Set([\n  \"button\",\n  \"submit\",\n  \"reset\",\n  \"checkbox\",\n  \"radio\",\n  \"image\",\n  \"color\",\n  \"file\",\n]);\nconst ARROW_OWNING_ROLES = new Set([\"textbox\", \"combobox\", \"spinbutton\", \"slider\"]);\n\n/**\n * An item that owns the arrow keys (design 6.3): text-like `input`s, `textarea`, `select`,\n * `[contenteditable]`, and `role` `textbox` / `combobox` / `spinbutton` / `slider`.\n */\nexport function isTextEntryItem(el: Element): boolean {\n  const role = el.getAttribute(\"role\");\n  if (role !== null && ARROW_OWNING_ROLES.has(role)) return true;\n  if (el instanceof HTMLInputElement) return !BUTTON_LIKE_INPUTS.has(el.type);\n  if (el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement) return true;\n  const editable = el.getAttribute(\"contenteditable\");\n  if (editable !== null && editable !== \"false\") return true;\n  return el instanceof HTMLElement && el.isContentEditable === true;\n}\n\ntype Move = \"next\" | \"prev\" | \"first\" | \"last\";\n\nfunction resolveKey(key: string, orientation: RovingOrientation, rtl: boolean): Move | null {\n  switch (key) {\n    case \"Home\":\n      return \"first\";\n    case \"End\":\n      return \"last\";\n    case \"ArrowRight\":\n      return orientation === \"horizontal\" ? (rtl ? \"prev\" : \"next\") : null;\n    case \"ArrowLeft\":\n      return orientation === \"horizontal\" ? (rtl ? \"next\" : \"prev\") : null;\n    case \"ArrowDown\":\n      return orientation === \"vertical\" ? \"next\" : null;\n    case \"ArrowUp\":\n      return orientation === \"vertical\" ? \"prev\" : null;\n    default:\n      return null;\n  }\n}\n\nfunction focusItem(item: HTMLElement): void {\n  // Keyboard focus: the ring shows even where the engine's heuristic would not (as Tabs).\n  item.focus({ focusVisible: true } as FocusOptions);\n}\n\ninterface Engine {\n  /** The options of the last committed render (written from an insertion effect). */\n  readonly setOptions: (options: RovingFocusOptions) => void;\n  /**\n   * Re-derives the Tab stop of `root` and writes `tabindex`. `focused`: the element focus is on,\n   * if any.\n   */\n  readonly apply: (root: HTMLElement | null, focused: Element | null) => void;\n  readonly handlers: RovingFocusHandlers;\n}\n\nfunction createEngine(): Engine {\n  let current: HTMLElement | null = null;\n  let latestOptions: RovingFocusOptions | null = null;\n  /**\n   * Elements this engine wrote `tabindex` on, with the attribute value they had before the first\n   * write (`null`: none). Restored when the engine lets go of an element (native path, element\n   * left the container): React does not re-write a `tabIndex` prop it believes it rendered, so a\n   * `[tabindex=\"0\"]` widget would otherwise become unreachable.\n   */\n  const managed = new Map<HTMLElement, string | null>();\n\n  const restore = (el: HTMLElement) => {\n    const original = managed.get(el);\n    managed.delete(el);\n    if (!el.isConnected || original === undefined) return;\n    if (original === null) el.removeAttribute(\"tabindex\");\n    else el.setAttribute(\"tabindex\", original);\n  };\n\n  const active = (options: RovingFocusOptions | null): options is RovingFocusOptions =>\n    options !== null && options.enabled !== false;\n\n  /** Native path: give back every `tabindex` this engine wrote (a hydration render may have). */\n  const release = () => {\n    for (const el of [...managed.keys()]) restore(el);\n    current = null;\n  };\n\n  const apply = (root: HTMLElement | null, focused: Element | null) => {\n    const options = latestOptions;\n    if (root === null || !active(options)) return;\n    if (options.native) {\n      release();\n      return;\n    }\n    const items = itemsOf(root, managed);\n    if (!options.memory) {\n      current =\n        focused instanceof HTMLElement && items.includes(focused)\n          ? focused\n          : (options.entry(items) ?? null);\n    } else if (current === null || !items.includes(current)) {\n      current = options.entry(items) ?? null;\n    }\n    for (const el of items) {\n      if (!managed.has(el)) managed.set(el, el.getAttribute(\"tabindex\"));\n      const want = el === current ? \"0\" : \"-1\";\n      if (el.getAttribute(\"tabindex\") !== want) el.setAttribute(\"tabindex\", want);\n    }\n    // Elements written before that are no longer items: a stale `0` must not stay a Tab stop\n    // (it would be one again when re-enabled); one that left the container gets its own back.\n    for (const el of [...managed.keys()]) {\n      if (items.includes(el)) continue;\n      if (!root.contains(el)) {\n        restore(el);\n      } else if (el.getAttribute(\"tabindex\") !== \"-1\") {\n        el.setAttribute(\"tabindex\", \"-1\");\n      }\n    }\n  };\n\n  const onFocus = (event: FocusEvent<HTMLElement>) => {\n    const options = latestOptions;\n    if (!active(options) || options.native) return;\n    const target = event.target;\n    if (!(target instanceof HTMLElement)) return;\n    const items = itemsOf(event.currentTarget, managed);\n    if (!items.includes(target)) return;\n    current = target;\n    apply(event.currentTarget, target);\n  };\n\n  const onBlur = (event: FocusEvent<HTMLElement>) => {\n    const options = latestOptions;\n    if (!active(options) || options.native || options.memory) return;\n    // Focus moving to another item is handled by its focus event.\n    const next = event.relatedTarget;\n    if (next instanceof Node && event.currentTarget.contains(next)) return;\n    apply(event.currentTarget, null);\n  };\n\n  const onPointerDown = (event: PointerEvent<HTMLElement>) => {\n    const options = latestOptions;\n    if (!active(options) || options.native) return;\n    const target = event.target;\n    if (!(target instanceof Node)) return;\n    const items = itemsOf(event.currentTarget, managed);\n    // Safari does not focus a button on click; the pointer still makes it the stop.\n    const item = items.find((el) => el.contains(target));\n    if (item === undefined) return;\n    current = item;\n    apply(\n      event.currentTarget,\n      options.memory ? item : event.currentTarget.ownerDocument.activeElement,\n    );\n  };\n\n  const onKeyDown = (event: KeyboardEvent<HTMLElement>) => {\n    if (event.defaultPrevented || event.altKey || event.ctrlKey || event.metaKey) return;\n    const options = latestOptions;\n    // The browser moves focus itself where `focusgroup` is implemented.\n    if (!active(options) || options.native) return;\n    const root = event.currentTarget;\n    const target = event.target;\n    if (!(target instanceof HTMLElement)) return;\n    const items = itemsOf(root, managed);\n    const index = items.indexOf(target);\n    if (index < 0) return;\n\n    if (isTextEntryItem(target)) {\n      // The item keeps its arrows, Home and End; Tab / Shift+Tab move to the next / previous item\n      // while one exists, as Chromium's `focusgroup=\"toolbar\"` does (design 6.3).\n      if (event.key !== \"Tab\") return;\n      const next = items[index + (event.shiftKey ? -1 : 1)];\n      if (next === undefined) return;\n      event.preventDefault();\n      focusItem(next);\n      return;\n    }\n\n    const rtl = options.orientation === \"horizontal\" && getComputedStyle(root).direction === \"rtl\";\n    const move = resolveKey(event.key, options.orientation, rtl);\n    if (move === null) return;\n    event.preventDefault();\n    const last = items.length - 1;\n    let nextIndex: number;\n    switch (move) {\n      case \"first\":\n        nextIndex = 0;\n        break;\n      case \"last\":\n        nextIndex = last;\n        break;\n      case \"next\":\n        nextIndex = index >= last ? (options.loop ? 0 : last) : index + 1;\n        break;\n      case \"prev\":\n        nextIndex = index <= 0 ? (options.loop ? last : 0) : index - 1;\n        break;\n    }\n    const next = items[nextIndex];\n    if (next !== undefined && next !== target) focusItem(next);\n  };\n\n  return {\n    setOptions: (options) => {\n      latestOptions = options;\n    },\n    apply,\n    handlers: { onFocus, onBlur, onPointerDown, onKeyDown },\n  };\n}\n\n/**\n * Roving focus over the focusable descendants of `ref`'s element (design 6.2). Writes `tabindex`\n * (`0` on the Tab stop, `-1` on the other items) from a layout effect after every commit of the\n * calling component, from a `MutationObserver` on the subtree and from focus / pointer events;\n * the items render none. Returns the container's handlers for its library props.\n */\nexport function useRovingFocus(\n  ref: RefObject<HTMLElement | null>,\n  options: RovingFocusOptions,\n): RovingFocusHandlers {\n  const [engine] = useState(createEngine);\n  // Before every layout effect of the same commit (as `useLatest`): handlers and the observer\n  // read the options of the last committed render.\n  useInsertionEffect(() => {\n    engine.setOptions(options);\n  });\n  const enabled = options.enabled !== false;\n\n  // After every commit of the container (a deps-less layout effect).\n  useLayoutEffect(() => {\n    const root = ref.current;\n    engine.apply(root, root?.ownerDocument.activeElement ?? null);\n  });\n\n  // Children that change without the container re-rendering.\n  useEffect(() => {\n    const root = ref.current;\n    if (!enabled || root === null) return;\n    const observer = new MutationObserver(() => {\n      engine.apply(root, root.ownerDocument.activeElement);\n    });\n    observer.observe(root, {\n      childList: true,\n      subtree: true,\n      attributes: true,\n      attributeFilter: [\"disabled\", \"hidden\", \"inert\", \"aria-disabled\"],\n    });\n    return () => {\n      observer.disconnect();\n    };\n  }, [engine, enabled, ref]);\n\n  return engine.handlers;\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-roving-focus.mjs","names":[],"sources":["../../src/internal/use-roving-focus.ts"],"sourcesContent":["\"use client\";\nimport { useEffect, useInsertionEffect, useLayoutEffect, useState } from \"react\";\nimport type { FocusEvent, KeyboardEvent, PointerEvent, RefObject } from \"react\";\n\n// The roving-focus engine shared by `Toolbar.Root` and a standalone `ToggleGroup.Root`\n// (design/components/toggle-group.md section 6, conventions 3.2 and 7.4). Items are the focusable\n// descendants of the container, found in the DOM; which one is the Tab stop is urgent library\n// state kept outside React and written to the items as `tabindex` through the DOM.\n\nexport type RovingOrientation = \"horizontal\" | \"vertical\";\n\nexport interface RovingFocusOptions {\n  /** `false`: the engine writes nothing and handles nothing (a ToggleGroup inside a Toolbar). Default `true`. */\n  readonly enabled?: boolean;\n  readonly orientation: RovingOrientation;\n  readonly loop: boolean;\n  /** The native `focusgroup` path is active: write no `tabindex`, handle no navigation key. */\n  readonly native: boolean;\n  /** Which item is the Tab stop when there is no usable memory. */\n  readonly entry: (items: readonly HTMLElement[]) => HTMLElement | undefined;\n  /**\n   * `true`: the last focused item stays the Tab stop after focus leaves (Toolbar). `false`: while\n   * focus is inside, the focused item is the stop (so Tab and Shift+Tab leave the container);\n   * once it leaves, the stop is re-derived from `entry` (ToggleGroup: the pressed Item).\n   */\n  readonly memory: boolean;\n}\n\nexport interface RovingFocusHandlers {\n  readonly onKeyDown: (event: KeyboardEvent<HTMLElement>) => void;\n  readonly onFocus: (event: FocusEvent<HTMLElement>) => void;\n  readonly onBlur: (event: FocusEvent<HTMLElement>) => void;\n  readonly onPointerDown: (event: PointerEvent<HTMLElement>) => void;\n}\n\nconst FOCUSABLE = [\n  \"button\",\n  \"a[href]\",\n  'input:not([type=\"hidden\"])',\n  \"select\",\n  \"textarea\",\n  \"summary\",\n  '[contenteditable]:not([contenteditable=\"false\"])',\n  \"[tabindex]\",\n].join(\",\");\n\nfunction isVisible(el: HTMLElement): boolean {\n  // jsdom has no `checkVisibility`; `hidden` is the part of it a test can observe there.\n  if (typeof el.checkVisibility === \"function\") return el.checkVisibility();\n  return el.closest(\"[hidden]\") === null;\n}\n\n/**\n * Whether `el` or an ancestor below `root` takes it out of `root`'s sequence: a nested toolbar\n * (its own sequence), a popover or a dialog rendered inside the container (a `Menu.Popup`'s items\n * are the menu's).\n */\nfunction isNestedOut(el: HTMLElement, root: HTMLElement): boolean {\n  for (let node: Element | null = el; node !== null && node !== root; node = node.parentElement) {\n    if (\n      node.getAttribute(\"role\") === \"toolbar\" ||\n      node.hasAttribute(\"popover\") ||\n      node.tagName === \"DIALOG\"\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction isRadio(el: Element): el is HTMLInputElement {\n  return el instanceof HTMLInputElement && el.type === \"radio\";\n}\n\n/** The items of a container, with native radio groups collapsed into units (design 17.2). */\nexport interface RovingItems {\n  /** The toolbar's own destinations in DOM order; a radio unit appears as its representative. */\n  readonly items: HTMLElement[];\n  /**\n   * Every native radio among the candidates → the radios of its unit (same `name` under the\n   * container, DOM order). A radio without a `name` is a unit of one.\n   */\n  readonly units: Map<HTMLElement, readonly HTMLInputElement[]>;\n}\n\n/** The unit's representative: its checked radio, else its first (design 17.2 item 2). */\nfunction representative(unit: readonly HTMLInputElement[]): HTMLInputElement {\n  return unit.find((radio) => radio.checked) ?? unit[0]!;\n}\n\n/**\n * The items of `root` (design 6.2 and 17.2): its focusable descendants minus `:disabled`,\n * `inert`, invisible, nested-toolbar / popover / dialog content, and elements whose own\n * `tabindex=\"-1\"` was not written by this engine (`managed`). `aria-disabled` elements are items.\n * Native radios that share a `name` form one unit, represented in `items` by its checked radio\n * (else its first), at the position of the unit's first radio.\n */\nexport function collectItems(\n  root: HTMLElement,\n  managed: { has(el: Element): boolean },\n): RovingItems {\n  const candidates: HTMLElement[] = [];\n  const byName = new Map<string, HTMLInputElement[]>();\n  const units = new Map<HTMLElement, readonly HTMLInputElement[]>();\n  for (const el of root.querySelectorAll<HTMLElement>(FOCUSABLE)) {\n    if (el.matches(\":disabled\")) continue;\n    if (el.closest(\"[inert]\") !== null) continue;\n    if (el.getAttribute(\"tabindex\") === \"-1\" && !managed.has(el)) continue;\n    if (isNestedOut(el, root)) continue;\n    if (!isVisible(el)) continue;\n    if (isRadio(el)) {\n      // Same form owner assumed: a `form=` attribute that splits a `name` is not handled (v1).\n      const unit = el.name === \"\" ? undefined : byName.get(el.name);\n      if (unit !== undefined) {\n        unit.push(el);\n        units.set(el, unit);\n        continue;\n      }\n      const created = [el];\n      if (el.name !== \"\") byName.set(el.name, created);\n      units.set(el, created);\n    }\n    candidates.push(el);\n  }\n  // `candidates` holds each unit's first radio in its place; swap in the representative.\n  const items = candidates.map((el) => {\n    const unit = units.get(el);\n    return unit === undefined ? el : representative(unit);\n  });\n  return { items, units };\n}\n\n/** {@link collectItems}'s `items`: the container's destinations in DOM order. */\nexport function itemsOf(root: HTMLElement, managed: { has(el: Element): boolean }): HTMLElement[] {\n  return collectItems(root, managed).items;\n}\n\nconst BUTTON_LIKE_INPUTS = new Set([\n  \"button\",\n  \"submit\",\n  \"reset\",\n  \"checkbox\",\n  \"image\",\n  \"color\",\n  \"file\",\n]);\nconst ARROW_OWNING_ROLES = new Set([\"textbox\", \"combobox\", \"spinbutton\", \"slider\"]);\n\n/**\n * An item that owns the arrow keys (design 6.3 and 17.2): text-like `input`s, `textarea`,\n * `select`, `[contenteditable]`, `role` `textbox` / `combobox` / `spinbutton` / `slider`, and a\n * native `input[type=radio]` (its group's own arrows check as they move). A custom\n * `[role=\"radio\"]` is an ordinary item, as it is under native `focusgroup`.\n */\nexport function ownsArrows(el: Element): boolean {\n  const role = el.getAttribute(\"role\");\n  if (role !== null && ARROW_OWNING_ROLES.has(role)) return true;\n  if (el instanceof HTMLInputElement) return !BUTTON_LIKE_INPUTS.has(el.type);\n  if (el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement) return true;\n  const editable = el.getAttribute(\"contenteditable\");\n  if (editable !== null && editable !== \"false\") return true;\n  return el instanceof HTMLElement && el.isContentEditable === true;\n}\n\ntype Move = \"next\" | \"prev\" | \"first\" | \"last\";\n\nfunction resolveKey(key: string, orientation: RovingOrientation, rtl: boolean): Move | null {\n  switch (key) {\n    case \"Home\":\n      return \"first\";\n    case \"End\":\n      return \"last\";\n    case \"ArrowRight\":\n      return orientation === \"horizontal\" ? (rtl ? \"prev\" : \"next\") : null;\n    case \"ArrowLeft\":\n      return orientation === \"horizontal\" ? (rtl ? \"next\" : \"prev\") : null;\n    case \"ArrowDown\":\n      return orientation === \"vertical\" ? \"next\" : null;\n    case \"ArrowUp\":\n      return orientation === \"vertical\" ? \"prev\" : null;\n    default:\n      return null;\n  }\n}\n\nfunction focusItem(item: HTMLElement): void {\n  // Keyboard focus: the ring shows even where the engine's heuristic would not (as Tabs).\n  item.focus({ focusVisible: true } as FocusOptions);\n}\n\ninterface Engine {\n  /** The options of the last committed render (written from an insertion effect). */\n  readonly setOptions: (options: RovingFocusOptions) => void;\n  /**\n   * Re-derives the Tab stop of `root` and writes `tabindex`. `focused`: the element focus is on,\n   * if any.\n   */\n  readonly apply: (root: HTMLElement | null, focused: Element | null) => void;\n  readonly handlers: RovingFocusHandlers;\n}\n\nfunction createEngine(): Engine {\n  let current: HTMLElement | null = null;\n  let latestOptions: RovingFocusOptions | null = null;\n  /**\n   * Elements this engine wrote `tabindex` on, with the attribute value they had before the first\n   * write (`null`: none). Restored when the engine lets go of an element (native path, element\n   * left the container): React does not re-write a `tabIndex` prop it believes it rendered, so a\n   * `[tabindex=\"0\"]` widget would otherwise become unreachable.\n   */\n  const managed = new Map<HTMLElement, string | null>();\n\n  const restore = (el: HTMLElement) => {\n    const original = managed.get(el);\n    managed.delete(el);\n    if (!el.isConnected || original === undefined) return;\n    if (original === null) el.removeAttribute(\"tabindex\");\n    else el.setAttribute(\"tabindex\", original);\n  };\n\n  const active = (options: RovingFocusOptions | null): options is RovingFocusOptions =>\n    options !== null && options.enabled !== false;\n\n  /** Native path: give back every `tabindex` this engine wrote (a hydration render may have). */\n  const release = () => {\n    for (const el of [...managed.keys()]) restore(el);\n    current = null;\n  };\n\n  const apply = (root: HTMLElement | null, focused: Element | null) => {\n    const options = latestOptions;\n    if (root === null || !active(options)) return;\n    if (options.native) {\n      release();\n      return;\n    }\n    const { items, units } = collectItems(root, managed);\n    /** Every element the engine writes: the items and the other radios of their units. */\n    const all = new Set<HTMLElement>(items);\n    for (const radio of units.keys()) all.add(radio);\n    /** The item standing for `el`: its unit's representative for a radio, else itself. */\n    const itemOf = (el: HTMLElement): HTMLElement => {\n      const unit = units.get(el);\n      return unit === undefined ? el : representative(unit);\n    };\n    if (!options.memory) {\n      current =\n        focused instanceof HTMLElement && all.has(focused)\n          ? focused\n          : (options.entry(items) ?? null);\n    } else if (current === null || !all.has(current) || !items.includes(itemOf(current))) {\n      current = options.entry(items) ?? null;\n    }\n    // `current` may be any radio of its unit (focus landed on an unchecked one): `0` on it, `-1`\n    // on the unit's other radios and on every other element (design 17.2 item 5).\n    for (const el of all) {\n      if (!managed.has(el)) managed.set(el, el.getAttribute(\"tabindex\"));\n      const want = el === current ? \"0\" : \"-1\";\n      if (el.getAttribute(\"tabindex\") !== want) el.setAttribute(\"tabindex\", want);\n    }\n    // Elements written before that are no longer items: a stale `0` must not stay a Tab stop\n    // (it would be one again when re-enabled); one that left the container gets its own back.\n    for (const el of [...managed.keys()]) {\n      if (all.has(el)) continue;\n      if (!root.contains(el)) {\n        restore(el);\n      } else if (el.getAttribute(\"tabindex\") !== \"-1\") {\n        el.setAttribute(\"tabindex\", \"-1\");\n      }\n    }\n  };\n\n  const onFocus = (event: FocusEvent<HTMLElement>) => {\n    const options = latestOptions;\n    if (!active(options) || options.native) return;\n    const target = event.target;\n    if (!(target instanceof HTMLElement)) return;\n    const { items, units } = collectItems(event.currentTarget, managed);\n    if (!items.includes(target) && !units.has(target)) return;\n    current = target;\n    apply(event.currentTarget, target);\n  };\n\n  const onBlur = (event: FocusEvent<HTMLElement>) => {\n    const options = latestOptions;\n    if (!active(options) || options.native || options.memory) return;\n    // Focus moving to another item is handled by its focus event.\n    const next = event.relatedTarget;\n    if (next instanceof Node && event.currentTarget.contains(next)) return;\n    apply(event.currentTarget, null);\n  };\n\n  const onPointerDown = (event: PointerEvent<HTMLElement>) => {\n    const options = latestOptions;\n    if (!active(options) || options.native) return;\n    const target = event.target;\n    if (!(target instanceof Node)) return;\n    const { items, units } = collectItems(event.currentTarget, managed);\n    // Safari does not focus a button on click; the pointer still makes it the stop.\n    const item = [...items, ...units.keys()].find((el) => el.contains(target));\n    if (item === undefined) return;\n    current = item;\n    apply(\n      event.currentTarget,\n      options.memory ? item : event.currentTarget.ownerDocument.activeElement,\n    );\n  };\n\n  const onKeyDown = (event: KeyboardEvent<HTMLElement>) => {\n    if (event.defaultPrevented || event.altKey || event.ctrlKey || event.metaKey) return;\n    const options = latestOptions;\n    // The browser moves focus itself where `focusgroup` is implemented.\n    if (!active(options) || options.native) return;\n    const root = event.currentTarget;\n    const target = event.target;\n    if (!(target instanceof HTMLElement)) return;\n    const { items, units } = collectItems(root, managed);\n    const unit = units.get(target);\n    // A radio stands in `items` through its unit's representative.\n    const index = items.indexOf(unit === undefined ? target : representative(unit));\n    if (index < 0) return;\n\n    if (ownsArrows(target)) {\n      // The item keeps its arrows, Home and End; Tab / Shift+Tab move to the next / previous item\n      // while one exists, as Chromium's `focusgroup=\"toolbar\"` does (design 6.3, 17.2 item 4).\n      if (event.key !== \"Tab\") return;\n      // From an unchecked radio whose sibling is checked: that sibling first (only the checked\n      // radio of a group is sequentially focusable natively).\n      const checked = unit?.find((radio) => radio.checked);\n      if (checked !== undefined && checked !== target) {\n        event.preventDefault();\n        focusItem(checked);\n        return;\n      }\n      const next = items[index + (event.shiftKey ? -1 : 1)];\n      if (next === undefined) return;\n      event.preventDefault();\n      focusItem(next);\n      return;\n    }\n\n    const rtl = options.orientation === \"horizontal\" && getComputedStyle(root).direction === \"rtl\";\n    const move = resolveKey(event.key, options.orientation, rtl);\n    if (move === null) return;\n    event.preventDefault();\n    const last = items.length - 1;\n    let nextIndex: number;\n    switch (move) {\n      case \"first\":\n        nextIndex = 0;\n        break;\n      case \"last\":\n        nextIndex = last;\n        break;\n      case \"next\":\n        nextIndex = index >= last ? (options.loop ? 0 : last) : index + 1;\n        break;\n      case \"prev\":\n        nextIndex = index <= 0 ? (options.loop ? last : 0) : index - 1;\n        break;\n    }\n    const next = items[nextIndex];\n    if (next !== undefined && next !== target) focusItem(next);\n  };\n\n  return {\n    setOptions: (options) => {\n      latestOptions = options;\n    },\n    apply,\n    handlers: { onFocus, onBlur, onPointerDown, onKeyDown },\n  };\n}\n\n/**\n * Roving focus over the focusable descendants of `ref`'s element (design 6.2). Writes `tabindex`\n * (`0` on the Tab stop, `-1` on the other items) from a layout effect after every commit of the\n * calling component, from a `MutationObserver` on the subtree and from focus / pointer events;\n * the items render none. Returns the container's handlers for its library props.\n */\nexport function useRovingFocus(\n  ref: RefObject<HTMLElement | null>,\n  options: RovingFocusOptions,\n): RovingFocusHandlers {\n  const [engine] = useState(createEngine);\n  // Before every layout effect of the same commit (as `useLatest`): handlers and the observer\n  // read the options of the last committed render.\n  useInsertionEffect(() => {\n    engine.setOptions(options);\n  });\n  const enabled = options.enabled !== false;\n\n  // After every commit of the container (a deps-less layout effect).\n  useLayoutEffect(() => {\n    const root = ref.current;\n    engine.apply(root, root?.ownerDocument.activeElement ?? null);\n  });\n\n  // Children that change without the container re-rendering.\n  useEffect(() => {\n    const root = ref.current;\n    if (!enabled || root === null) return;\n    const observer = new MutationObserver(() => {\n      engine.apply(root, root.ownerDocument.activeElement);\n    });\n    observer.observe(root, {\n      childList: true,\n      subtree: true,\n      attributes: true,\n      attributeFilter: [\"disabled\", \"hidden\", \"inert\", \"aria-disabled\"],\n    });\n    return () => {\n      observer.disconnect();\n    };\n  }, [engine, enabled, ref]);\n\n  return engine.handlers;\n}\n"],"mappings":"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"}

package/dist/menu/menu-checkbox-item.mjs

@@ -1,10 +1,10 @@
 "use client";
 import { createActionDetails } from "../internal/action-details.mjs";
 import { dataAttr } from "../internal/data-attr.mjs";
-import { transitionTypes } from "../internal/transition-types.mjs";
-import { useControllableAction } from "../internal/use-controllable-action.mjs";
 import { rendersButton } from "../internal/render-element.mjs";
 import { useRender } from "../internal/use-render.mjs";
+import { transitionTypes } from "../internal/transition-types.mjs";
+import { useControllableAction } from "../internal/use-controllable-action.mjs";
 import { closeStackLater, useMenuContext } from "./menu-context.mjs";
 import { useMenuItem } from "./use-menu-item.mjs";
 import { useRef } from "react";

package/dist/menu/menu-group.mjs

@@ -1,6 +1,6 @@
 "use client";
-import { useRender } from "../internal/use-render.mjs";
 import { useDevWarning } from "../internal/use-dev-warning.mjs";
+import { useRender } from "../internal/use-render.mjs";
 import { MenuGroupContext } from "./menu-context.mjs";
 import { use, useId, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/menu/menu-item.mjs

@@ -1,9 +1,9 @@
 "use client";
 import { createActionDetails } from "../internal/action-details.mjs";
 import { dataAttr } from "../internal/data-attr.mjs";
+import { useActionTrigger } from "../internal/use-action-trigger.mjs";
 import { rendersButton } from "../internal/render-element.mjs";
 import { useRender } from "../internal/use-render.mjs";
-import { useActionTrigger } from "../internal/use-action-trigger.mjs";
 import { useMenuContext } from "./menu-context.mjs";
 import { useMenuItem } from "./use-menu-item.mjs";
 //#region src/menu/menu-item.tsx

package/dist/menu/menu-popup.mjs

@@ -1,9 +1,9 @@
 "use client";
+import { ToolbarContext } from "../internal/toolbar-context.mjs";
 import { useTransitionBoundary } from "../internal/transition-boundary.mjs";
 import { mergeRefs } from "../internal/merge-props.mjs";
 import { resolveStateValue } from "../internal/render-element.mjs";
 import { useRender } from "../internal/use-render.mjs";
-import { ToolbarContext } from "../internal/toolbar-context.mjs";
 import { POSITION_TRY_FALLBACKS, positionArea } from "../internal/anchor-position.mjs";
 import { usePopoverPopup } from "../internal/use-popover-popup.mjs";
 import { MenuListContext, useMenuContext } from "./menu-context.mjs";

package/dist/menu/menu-radio-group.mjs

@@ -1,9 +1,9 @@
 "use client";
 import { createActionDetails } from "../internal/action-details.mjs";
 import { dataAttr } from "../internal/data-attr.mjs";
+import { useRender } from "../internal/use-render.mjs";
 import { transitionTypes } from "../internal/transition-types.mjs";
 import { useControllableAction } from "../internal/use-controllable-action.mjs";
-import { useRender } from "../internal/use-render.mjs";
 import { MenuGroupContext, MenuRadioGroupContext } from "./menu-context.mjs";
 import { useId, useMemo, useRef } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/menu/menu-root.mjs

@@ -1,6 +1,6 @@
 "use client";
-import { resolveStateValue } from "../internal/render-element.mjs";
 import { useDevWarning } from "../internal/use-dev-warning.mjs";
+import { resolveStateValue } from "../internal/render-element.mjs";
 import { useDelayedPair } from "../internal/use-delayed-pair.mjs";
 import { usePopoverRoot } from "../internal/use-popover-root.mjs";
 import { MenuContext, MenuListContext } from "./menu-context.mjs";

package/dist/menu/menu-submenu-trigger.mjs

@@ -1,6 +1,6 @@
 "use client";
-import { useRender } from "../internal/use-render.mjs";
 import { useDevWarning } from "../internal/use-dev-warning.mjs";
+import { useRender } from "../internal/use-render.mjs";
 import { usePopoverTrigger } from "../internal/use-popover-trigger.mjs";
 import { useMenuContext } from "./menu-context.mjs";
 import { hasModifier, isRtl } from "./menu-dom.mjs";

package/dist/menu/menu-trigger.mjs

@@ -1,7 +1,7 @@
 "use client";
-import { useRender } from "../internal/use-render.mjs";
 import { useToolbarContext } from "../internal/toolbar-context.mjs";
 import { useDevWarning } from "../internal/use-dev-warning.mjs";
+import { useRender } from "../internal/use-render.mjs";
 import { usePopoverTrigger } from "../internal/use-popover-trigger.mjs";
 import { useMenuContext } from "./menu-context.mjs";
 import { edgeItem, focusItem, hasModifier, isRtl } from "./menu-dom.mjs";

package/dist/number-field/number-field-increment.mjs

@@ -1,8 +1,8 @@
 "use client";
 import { dataAttr } from "../internal/data-attr.mjs";
+import { useDevWarning } from "../internal/use-dev-warning.mjs";
 import { rendersButton } from "../internal/render-element.mjs";
 import { useRender } from "../internal/use-render.mjs";
-import { useDevWarning } from "../internal/use-dev-warning.mjs";
 import { isAtBound } from "./number-field-arithmetic.mjs";
 import { useNumberFieldContext } from "./number-field-context.mjs";
 import { useStepButton } from "./use-step-button.mjs";

package/dist/number-field/number-field-input.mjs

@@ -1,8 +1,8 @@
 "use client";
 import { dataAttr } from "../internal/data-attr.mjs";
+import { useDevWarning } from "../internal/use-dev-warning.mjs";
 import { mergeRefs } from "../internal/merge-props.mjs";
 import { useRender } from "../internal/use-render.mjs";
-import { useDevWarning } from "../internal/use-dev-warning.mjs";
 import { useFieldControl, useMergedRef } from "../internal/use-field-control.mjs";
 import { useNumberFieldContext } from "./number-field-context.mjs";
 import { hiddenText } from "./number-field-root.mjs";

package/dist/number-field/number-field-root.mjs

@@ -1,13 +1,13 @@
 "use client";
 import { createActionDetails } from "../internal/action-details.mjs";
 import { dataAttr } from "../internal/data-attr.mjs";
+import { useActionTrigger } from "../internal/use-action-trigger.mjs";
+import { useDevWarning } from "../internal/use-dev-warning.mjs";
+import { mergeTokenLists } from "../internal/merge-props.mjs";
+import { useRender } from "../internal/use-render.mjs";
 import { transitionTypes } from "../internal/transition-types.mjs";
 import { useLatest } from "../internal/use-latest.mjs";
 import { useControllableAction } from "../internal/use-controllable-action.mjs";
-import { mergeTokenLists } from "../internal/merge-props.mjs";
-import { useRender } from "../internal/use-render.mjs";
-import { useDevWarning } from "../internal/use-dev-warning.mjs";
-import { useActionTrigger } from "../internal/use-action-trigger.mjs";
 import { FieldContext } from "../internal/field-context.mjs";
 import { useFieldValueChange } from "../internal/use-field-control.mjs";
 import { useNativeGroupReconciliation } from "../internal/use-native-group-reconciliation.mjs";

package/dist/popover/popover-close.mjs

@@ -1,9 +1,9 @@
 "use client";
 import { createActionDetails } from "../internal/action-details.mjs";
 import { dataAttr } from "../internal/data-attr.mjs";
+import { useActionTrigger } from "../internal/use-action-trigger.mjs";
 import { rendersButton } from "../internal/render-element.mjs";
 import { useRender } from "../internal/use-render.mjs";
-import { useActionTrigger } from "../internal/use-action-trigger.mjs";
 import { usePopoverContext } from "./popover-context.mjs";
 import { useCallback } from "react";
 //#region src/popover/popover-close.tsx

package/dist/popover/popover-popup.mjs

@@ -1,9 +1,9 @@
 "use client";
+import { ToolbarContext } from "../internal/toolbar-context.mjs";
 import { useTransitionBoundary } from "../internal/transition-boundary.mjs";
+import { useDevWarning } from "../internal/use-dev-warning.mjs";
 import { resolveStateValue } from "../internal/render-element.mjs";
 import { useRender } from "../internal/use-render.mjs";
-import { ToolbarContext } from "../internal/toolbar-context.mjs";
-import { useDevWarning } from "../internal/use-dev-warning.mjs";
 import { POSITION_TRY_FALLBACKS, positionArea } from "../internal/anchor-position.mjs";
 import { PopoverPopupContext, usePopoverContext } from "./popover-context.mjs";
 import { usePopoverPopup } from "../internal/use-popover-popup.mjs";

package/dist/radio-group/radio-group-item.mjs

@@ -1,6 +1,6 @@
 "use client";
-import { useTransitionBoundary } from "../internal/transition-boundary.mjs";
 import { dataAttr } from "../internal/data-attr.mjs";
+import { useTransitionBoundary } from "../internal/transition-boundary.mjs";
 import { useRender } from "../internal/use-render.mjs";
 import { guardCheckableChange, useNativeChecked } from "../internal/use-native-checked.mjs";
 import { syncPresence } from "../internal/sync-presence.mjs";

package/dist/radio-group/radio-group-root.mjs

@@ -1,9 +1,9 @@
 "use client";
 import { createActionDetails } from "../internal/action-details.mjs";
 import { dataAttr } from "../internal/data-attr.mjs";
+import { useRender } from "../internal/use-render.mjs";
 import { transitionTypes } from "../internal/transition-types.mjs";
 import { useControllableAction } from "../internal/use-controllable-action.mjs";
-import { useRender } from "../internal/use-render.mjs";
 import { useFieldControl, useFieldValueChange, useMergedRef } from "../internal/use-field-control.mjs";
 import { RadioGroupContext } from "./radio-group-context.mjs";
 import { useNativeGroupReconciliation } from "../internal/use-native-group-reconciliation.mjs";

package/dist/select/select-root.mjs

@@ -1,9 +1,9 @@
 "use client";
 import { createActionDetails } from "../internal/action-details.mjs";
 import { dataAttr } from "../internal/data-attr.mjs";
+import { useRender } from "../internal/use-render.mjs";
 import { transitionTypes } from "../internal/transition-types.mjs";
 import { useControllableAction } from "../internal/use-controllable-action.mjs";
-import { useRender } from "../internal/use-render.mjs";
 import { fieldInputProps, useFieldControl, useFieldValueChange, useMergedRef } from "../internal/use-field-control.mjs";
 import { SelectContext } from "./select-context.mjs";
 import { useSelectPartRef } from "./select-dom.mjs";

package/dist/slider/slider-root.mjs

@@ -1,14 +1,14 @@
 "use client";
 import { createActionDetails } from "../internal/action-details.mjs";
 import { dataAttr } from "../internal/data-attr.mjs";
-import { transitionTypes } from "../internal/transition-types.mjs";
-import { useLatest } from "../internal/use-latest.mjs";
-import { useControllableAction } from "../internal/use-controllable-action.mjs";
+import { useActionTrigger } from "../internal/use-action-trigger.mjs";
+import { useDevWarning } from "../internal/use-dev-warning.mjs";
 import { mergeTokenLists } from "../internal/merge-props.mjs";
 import { resolveStateValue } from "../internal/render-element.mjs";
 import { useRender } from "../internal/use-render.mjs";
-import { useDevWarning } from "../internal/use-dev-warning.mjs";
-import { useActionTrigger } from "../internal/use-action-trigger.mjs";
+import { transitionTypes } from "../internal/transition-types.mjs";
+import { useLatest } from "../internal/use-latest.mjs";
+import { useControllableAction } from "../internal/use-controllable-action.mjs";
 import { FieldContext } from "../internal/field-context.mjs";
 import { useFieldControl, useFieldValueChange, useMergedRef } from "../internal/use-field-control.mjs";
 import { useNativeGroupReconciliation } from "../internal/use-native-group-reconciliation.mjs";