@proyecto-viviana/solidaria 0.3.0 → 0.4.0

package/dist/_chunk/ariaHideOutside.jsx

@@ -0,0 +1,122 @@
+import { c as getOwnerWindow } from "./focus.jsx";
+//#region src/overlays/ariaHideOutside.ts
+/**
+* Hides all elements in the DOM outside the given targets from screen readers.
+* Based on @react-aria/overlays ariaHideOutside.
+*/
+const supportsInert = typeof HTMLElement !== "undefined" && "inert" in HTMLElement.prototype;
+const refCountMap = /* @__PURE__ */ new WeakMap();
+const observerStack = [];
+/**
+* Hides all elements in the DOM outside the given targets from screen readers using aria-hidden,
+* and returns a function to revert these changes. In addition, changes to the DOM are watched
+* and new elements outside the targets are automatically hidden.
+* @param targets - The elements that should remain visible.
+* @param options - Options for hiding behavior.
+* @returns - A function to restore all hidden elements.
+*/
+function ariaHideOutside(targets, options) {
+	const windowObj = getOwnerWindow(targets?.[0]);
+	const opts = options instanceof windowObj.Element ? { root: options } : options;
+	const root = opts?.root ?? document.body;
+	const shouldUseInert = opts?.shouldUseInert && supportsInert;
+	const visibleNodes = new Set(targets);
+	const hiddenNodes = /* @__PURE__ */ new Set();
+	const getHidden = (element) => {
+		return shouldUseInert && element instanceof windowObj.HTMLElement ? element.inert : element.getAttribute("aria-hidden") === "true";
+	};
+	const setHidden = (element, hidden) => {
+		if (shouldUseInert && element instanceof windowObj.HTMLElement) element.inert = hidden;
+		else if (hidden) element.setAttribute("aria-hidden", "true");
+		else {
+			element.removeAttribute("aria-hidden");
+			if (element instanceof windowObj.HTMLElement) element.inert = false;
+		}
+	};
+	const hide = (node) => {
+		let refCount = refCountMap.get(node) ?? 0;
+		if (getHidden(node) && refCount === 0) return;
+		if (refCount === 0) setHidden(node, true);
+		hiddenNodes.add(node);
+		refCountMap.set(node, refCount + 1);
+	};
+	const walk = (walkRoot) => {
+		for (const element of walkRoot.querySelectorAll("[data-live-announcer], [data-solidaria-top-layer]")) visibleNodes.add(element);
+		const acceptNode = (node) => {
+			if (hiddenNodes.has(node) || visibleNodes.has(node) || node.parentElement && hiddenNodes.has(node.parentElement) && node.parentElement.getAttribute("role") !== "row") return NodeFilter.FILTER_REJECT;
+			for (const target of visibleNodes) if (node.contains(target)) return NodeFilter.FILTER_SKIP;
+			return NodeFilter.FILTER_ACCEPT;
+		};
+		const walker = document.createTreeWalker(walkRoot, NodeFilter.SHOW_ELEMENT, { acceptNode });
+		const acceptRoot = acceptNode(walkRoot);
+		if (acceptRoot === NodeFilter.FILTER_ACCEPT) hide(walkRoot);
+		if (acceptRoot !== NodeFilter.FILTER_REJECT) {
+			let node = walker.nextNode();
+			while (node != null) {
+				hide(node);
+				node = walker.nextNode();
+			}
+		}
+	};
+	if (observerStack.length) observerStack[observerStack.length - 1].disconnect();
+	walk(root);
+	const observer = new MutationObserver((changes) => {
+		for (const change of changes) {
+			if (change.type !== "childList") continue;
+			if (![...visibleNodes, ...hiddenNodes].some((node) => node.contains(change.target))) {
+				for (const node of change.addedNodes) if ((node instanceof HTMLElement || node instanceof SVGElement) && (node.dataset.liveAnnouncer === "true" || node.dataset.solidariaTopLayer === "true")) visibleNodes.add(node);
+				else if (node instanceof Element) walk(node);
+			}
+		}
+	});
+	observer.observe(root, {
+		childList: true,
+		subtree: true
+	});
+	const observerWrapper = {
+		visibleNodes,
+		hiddenNodes,
+		observe() {
+			observer.observe(root, {
+				childList: true,
+				subtree: true
+			});
+		},
+		disconnect() {
+			observer.disconnect();
+		}
+	};
+	observerStack.push(observerWrapper);
+	return () => {
+		observer.disconnect();
+		for (const node of hiddenNodes) {
+			const count = refCountMap.get(node);
+			if (count == null) continue;
+			if (count === 1) {
+				setHidden(node, false);
+				refCountMap.delete(node);
+			} else refCountMap.set(node, count - 1);
+		}
+		if (observerWrapper === observerStack[observerStack.length - 1]) {
+			observerStack.pop();
+			if (observerStack.length) observerStack[observerStack.length - 1].observe();
+		} else observerStack.splice(observerStack.indexOf(observerWrapper), 1);
+	};
+}
+/**
+* Keeps an element visible when aria-hiding is active.
+* Used for elements like live regions that should remain accessible.
+*/
+function keepVisible(element) {
+	const observer = observerStack[observerStack.length - 1];
+	if (observer && !observer.visibleNodes.has(element)) {
+		observer.visibleNodes.add(element);
+		return () => {
+			observer.visibleNodes.delete(element);
+		};
+	}
+}
+//#endregion
+export { keepVisible as n, ariaHideOutside as t };
+
+//# sourceMappingURL=ariaHideOutside.jsx.map

package/dist/_chunk/ariaHideOutside.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"ariaHideOutside.jsx","names":[],"sources":["../../src/overlays/ariaHideOutside.ts"],"sourcesContent":["/**\n * Hides all elements in the DOM outside the given targets from screen readers.\n * Based on @react-aria/overlays ariaHideOutside.\n */\n\nimport { getOwnerWindow } from \"../utils\";\n\nconst supportsInert = typeof HTMLElement !== \"undefined\" && \"inert\" in HTMLElement.prototype;\n\nexport interface AriaHideOutsideOptions {\n  /** The root element to start hiding from. */\n  root?: Element;\n  /** Whether to use the `inert` attribute instead of `aria-hidden`. */\n  shouldUseInert?: boolean;\n}\n\n// Keeps a ref count of all hidden elements. Added to when hiding an element, and\n// subtracted from when showing it again. When it reaches zero, aria-hidden is removed.\nconst refCountMap = new WeakMap<Element, number>();\n\ninterface ObserverWrapper {\n  visibleNodes: Set<Element>;\n  hiddenNodes: Set<Element>;\n  observe: () => void;\n  disconnect: () => void;\n}\n\nconst observerStack: ObserverWrapper[] = [];\n\n/**\n * Hides all elements in the DOM outside the given targets from screen readers using aria-hidden,\n * and returns a function to revert these changes. In addition, changes to the DOM are watched\n * and new elements outside the targets are automatically hidden.\n * @param targets - The elements that should remain visible.\n * @param options - Options for hiding behavior.\n * @returns - A function to restore all hidden elements.\n */\nexport function ariaHideOutside(\n  targets: Element[],\n  options?: AriaHideOutsideOptions | Element,\n): () => void {\n  const windowObj = getOwnerWindow(targets?.[0]);\n  const opts = options instanceof windowObj.Element ? { root: options } : options;\n  const root = opts?.root ?? document.body;\n  const shouldUseInert = opts?.shouldUseInert && supportsInert;\n  const visibleNodes = new Set<Element>(targets);\n  const hiddenNodes = new Set<Element>();\n\n  const getHidden = (element: Element): boolean => {\n    return shouldUseInert && element instanceof windowObj.HTMLElement\n      ? element.inert\n      : element.getAttribute(\"aria-hidden\") === \"true\";\n  };\n\n  const setHidden = (element: Element, hidden: boolean): void => {\n    if (shouldUseInert && element instanceof windowObj.HTMLElement) {\n      element.inert = hidden;\n    } else if (hidden) {\n      element.setAttribute(\"aria-hidden\", \"true\");\n    } else {\n      element.removeAttribute(\"aria-hidden\");\n      if (element instanceof windowObj.HTMLElement) {\n        // We only ever call setHidden with hidden = false when the nodeCount is 1 aka\n        // we are trying to make the element visible to screen readers again, so remove inert as well\n        element.inert = false;\n      }\n    }\n  };\n\n  const hide = (node: Element): void => {\n    let refCount = refCountMap.get(node) ?? 0;\n\n    // If already aria-hidden, and the ref count is zero, then this element\n    // was already hidden and there's nothing for us to do.\n    if (getHidden(node) && refCount === 0) {\n      return;\n    }\n\n    if (refCount === 0) {\n      setHidden(node, true);\n    }\n\n    hiddenNodes.add(node);\n    refCountMap.set(node, refCount + 1);\n  };\n\n  const walk = (walkRoot: Element): void => {\n    // Keep live announcer and top layer elements (e.g. toasts) visible.\n    for (const element of walkRoot.querySelectorAll(\n      \"[data-live-announcer], [data-solidaria-top-layer]\",\n    )) {\n      visibleNodes.add(element);\n    }\n\n    const acceptNode = (node: Element): number => {\n      // Skip this node and its children if it is one of the target nodes, or a live announcer.\n      // Also skip children of already hidden nodes, as aria-hidden is recursive. An exception is\n      // made for elements with role=\"row\" since VoiceOver on iOS has issues hiding elements with role=\"row\".\n      // For that case we want to hide the cells inside as well (https://bugs.webkit.org/show_bug.cgi?id=222623).\n      if (\n        hiddenNodes.has(node) ||\n        visibleNodes.has(node) ||\n        (node.parentElement &&\n          hiddenNodes.has(node.parentElement) &&\n          node.parentElement.getAttribute(\"role\") !== \"row\")\n      ) {\n        return NodeFilter.FILTER_REJECT;\n      }\n\n      // Skip this node but continue to children if one of the targets is inside the node.\n      for (const target of visibleNodes) {\n        if (node.contains(target)) {\n          return NodeFilter.FILTER_SKIP;\n        }\n      }\n\n      return NodeFilter.FILTER_ACCEPT;\n    };\n\n    const walker = document.createTreeWalker(walkRoot, NodeFilter.SHOW_ELEMENT, { acceptNode });\n\n    // TreeWalker does not include the root.\n    const acceptRoot = acceptNode(walkRoot);\n    if (acceptRoot === NodeFilter.FILTER_ACCEPT) {\n      hide(walkRoot);\n    }\n\n    if (acceptRoot !== NodeFilter.FILTER_REJECT) {\n      let node = walker.nextNode() as Element;\n      while (node != null) {\n        hide(node);\n        node = walker.nextNode() as Element;\n      }\n    }\n  };\n\n  // If there is already a MutationObserver listening from a previous call,\n  // disconnect it so the new one takes over.\n  if (observerStack.length) {\n    observerStack[observerStack.length - 1].disconnect();\n  }\n\n  walk(root);\n\n  const observer = new MutationObserver((changes) => {\n    for (const change of changes) {\n      if (change.type !== \"childList\") {\n        continue;\n      }\n\n      // If the parent element of the added nodes is not within one of the targets,\n      // and not already inside a hidden node, hide all of the new children.\n      if (![...visibleNodes, ...hiddenNodes].some((node) => node.contains(change.target))) {\n        for (const node of change.addedNodes) {\n          if (\n            (node instanceof HTMLElement || node instanceof SVGElement) &&\n            (node.dataset.liveAnnouncer === \"true\" || node.dataset.solidariaTopLayer === \"true\")\n          ) {\n            visibleNodes.add(node);\n          } else if (node instanceof Element) {\n            walk(node);\n          }\n        }\n      }\n    }\n  });\n\n  observer.observe(root, { childList: true, subtree: true });\n\n  const observerWrapper: ObserverWrapper = {\n    visibleNodes,\n    hiddenNodes,\n    observe() {\n      observer.observe(root, { childList: true, subtree: true });\n    },\n    disconnect() {\n      observer.disconnect();\n    },\n  };\n\n  observerStack.push(observerWrapper);\n\n  return (): void => {\n    observer.disconnect();\n\n    for (const node of hiddenNodes) {\n      const count = refCountMap.get(node);\n      if (count == null) {\n        continue;\n      }\n      if (count === 1) {\n        setHidden(node, false);\n        refCountMap.delete(node);\n      } else {\n        refCountMap.set(node, count - 1);\n      }\n    }\n\n    // Remove this observer from the stack, and start the previous one.\n    if (observerWrapper === observerStack[observerStack.length - 1]) {\n      observerStack.pop();\n      if (observerStack.length) {\n        observerStack[observerStack.length - 1].observe();\n      }\n    } else {\n      observerStack.splice(observerStack.indexOf(observerWrapper), 1);\n    }\n  };\n}\n\n/**\n * Keeps an element visible when aria-hiding is active.\n * Used for elements like live regions that should remain accessible.\n */\nexport function keepVisible(element: Element): (() => void) | undefined {\n  const observer = observerStack[observerStack.length - 1];\n  if (observer && !observer.visibleNodes.has(element)) {\n    observer.visibleNodes.add(element);\n    return () => {\n      observer.visibleNodes.delete(element);\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/_chunk/autocomplete.js

@@ -0,0 +1,196 @@
+import { createId, getOwnerDocument } from "../ssr/index.js";
+import { createEffect, createSignal, onCleanup } from "solid-js";
+//#region src/autocomplete/createAutocomplete.ts
+/**
+* createAutocomplete - Accessibility hook for autocomplete components
+*
+* Provides keyboard navigation, virtual focus via aria-activedescendant,
+* and filtering capabilities for autocomplete inputs.
+*
+* Based on @react-aria/autocomplete useAutocomplete.
+*/
+function toKeyboardEventInit(e) {
+	return {
+		key: e.key,
+		code: e.code,
+		location: e.location,
+		repeat: e.repeat,
+		isComposing: e.isComposing,
+		ctrlKey: e.ctrlKey,
+		shiftKey: e.shiftKey,
+		altKey: e.altKey,
+		metaKey: e.metaKey,
+		bubbles: e.bubbles,
+		cancelable: e.cancelable
+	};
+}
+const AUTOCOMPLETE_FOCUS_EVENT = "autocomplete:focus";
+const AUTOCOMPLETE_CLEAR_FOCUS_EVENT = "autocomplete:clearfocus";
+/**
+* Provides the behavior and accessibility implementation for an autocomplete component.
+* An autocomplete combines a text input with a collection, allowing users to filter
+* the collection's contents to match a query.
+*
+* @example
+* ```tsx
+* const state = createAutocompleteState({ defaultInputValue: '' });
+* let inputRef, collectionRef;
+*
+* const { inputProps, collectionProps, filter } = createAutocomplete({
+*   inputRef: () => inputRef,
+*   collectionRef: () => collectionRef,
+*   filter: (textValue, inputValue) =>
+*     textValue.toLowerCase().includes(inputValue.toLowerCase()),
+* }, state);
+*
+* return (
+*   <div>
+*     <input ref={inputRef} {...inputProps} />
+*     <ul ref={collectionRef} {...collectionProps}>
+*       {items.filter(item => filter?.(item.name) ?? true).map(item => (
+*         <li key={item.id}>{item.name}</li>
+*       ))}
+*     </ul>
+*   </div>
+* );
+* ```
+*/
+function createAutocomplete(props, state) {
+	const { inputRef, collectionRef, filter, collectionId: collectionIdProp, collectionAriaLabel, disableAutoFocusFirst = false, disableVirtualFocus = false } = props;
+	const collectionId = collectionIdProp ?? createId();
+	const [shouldUseVirtualFocus] = createSignal(!disableVirtualFocus);
+	const [autoFocusOnMount, setAutoFocusOnMount] = createSignal(false);
+	let lastInputType = "";
+	const handleBeforeInput = (e) => {
+		lastInputType = e.inputType || "";
+	};
+	createEffect(() => {
+		const input = inputRef();
+		if (input) {
+			input.addEventListener("beforeinput", handleBeforeInput);
+			onCleanup(() => {
+				input.removeEventListener("beforeinput", handleBeforeInput);
+			});
+		}
+	});
+	const focusFirstItem = () => {
+		const collection = collectionRef();
+		if (!collection) {
+			setAutoFocusOnMount(true);
+			return;
+		}
+		collection.dispatchEvent(new CustomEvent(AUTOCOMPLETE_FOCUS_EVENT, {
+			cancelable: true,
+			bubbles: true,
+			detail: { focusStrategy: "first" }
+		}));
+	};
+	const clearVirtualFocus = (clearFocusKey = false) => {
+		setAutoFocusOnMount(false);
+		state.setFocusedNodeId(null);
+		const collection = collectionRef();
+		if (collection) collection.dispatchEvent(new CustomEvent(AUTOCOMPLETE_CLEAR_FOCUS_EVENT, {
+			cancelable: true,
+			bubbles: true,
+			detail: { clearFocusKey }
+		}));
+	};
+	const onChange = (value) => {
+		if ((lastInputType === "insertText" || lastInputType === "insertCompositionText" || lastInputType === "insertFromComposition") && !disableAutoFocusFirst) focusFirstItem();
+		else if (lastInputType && (lastInputType.includes("insert") || lastInputType.includes("delete") || lastInputType.includes("history"))) clearVirtualFocus(true);
+		state.setInputValue(value);
+	};
+	const onKeyDown = (e) => {
+		if ("isComposing" in e && e.isComposing) return;
+		const focusedNodeId = state.focusedNodeId();
+		const collection = collectionRef();
+		const ownerDocument = getOwnerDocument(inputRef() ?? collection);
+		switch (e.key) {
+			case "Escape":
+				if (e.defaultPrevented) return;
+				break;
+			case " ": return;
+			case "Tab": return;
+			case "ArrowUp":
+			case "ArrowDown":
+			case "Home":
+			case "End":
+			case "PageUp":
+			case "PageDown":
+				e.preventDefault();
+				if (collection) collection.dispatchEvent(new CustomEvent(AUTOCOMPLETE_FOCUS_EVENT, {
+					cancelable: true,
+					bubbles: true
+				}));
+				break;
+			case "ArrowLeft":
+			case "ArrowRight":
+				if (!focusedNodeId) {
+					e.stopPropagation();
+					return;
+				}
+				break;
+			case "Enter":
+				if (focusedNodeId) {
+					const item = ownerDocument?.getElementById(focusedNodeId);
+					if (item) {
+						item.click();
+						e.preventDefault();
+					}
+				}
+				return;
+		}
+		if (!e.defaultPrevented && collection) {
+			e.stopPropagation();
+			let shouldPerformDefaultAction = true;
+			if (focusedNodeId) {
+				const item = ownerDocument?.getElementById(focusedNodeId);
+				if (item) shouldPerformDefaultAction = item.dispatchEvent(new KeyboardEvent(e.type, toKeyboardEventInit(e)));
+			} else shouldPerformDefaultAction = collection.dispatchEvent(new KeyboardEvent(e.type, toKeyboardEventInit(e)));
+			if (shouldPerformDefaultAction && (e.key === "ArrowLeft" || e.key === "ArrowRight")) clearVirtualFocus();
+		}
+	};
+	const onFocus = (e) => {
+		if (!e.isTrusted) return;
+		const focusedNodeId = state.focusedNodeId();
+		if (focusedNodeId) {
+			if (document.getElementById(focusedNodeId)) {}
+		}
+	};
+	const onBlur = (e) => {
+		if (!e.isTrusted) return;
+	};
+	const filterFn = filter ? (textValue) => filter(textValue, state.inputValue()) : void 0;
+	return {
+		inputProps: {
+			value: state.inputValue,
+			onChange,
+			onKeyDown,
+			onFocus,
+			onBlur,
+			get "aria-activedescendant"() {
+				return () => shouldUseVirtualFocus() ? state.focusedNodeId() ?? void 0 : void 0;
+			},
+			"aria-controls": collectionId,
+			"aria-autocomplete": "list",
+			enterKeyHint: "go",
+			autoCorrect: "off",
+			spellCheck: "false",
+			autoComplete: "off"
+		},
+		collectionProps: {
+			id: collectionId,
+			"aria-label": collectionAriaLabel,
+			shouldUseVirtualFocus: shouldUseVirtualFocus(),
+			disallowTypeAhead: shouldUseVirtualFocus(),
+			get autoFocus() {
+				return autoFocusOnMount() ? "first" : false;
+			}
+		},
+		filter: filterFn
+	};
+}
+//#endregion
+export { AUTOCOMPLETE_FOCUS_EVENT as n, createAutocomplete as r, AUTOCOMPLETE_CLEAR_FOCUS_EVENT as t };
+
+//# sourceMappingURL=autocomplete.js.map

package/dist/_chunk/autocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.js","names":["inputEvent"],"sources":["../../src/autocomplete/createAutocomplete.ts"],"sourcesContent":["/**\n * createAutocomplete - Accessibility hook for autocomplete components\n *\n * Provides keyboard navigation, virtual focus via aria-activedescendant,\n * and filtering capabilities for autocomplete inputs.\n *\n * Based on @react-aria/autocomplete useAutocomplete.\n */\n\nimport { createSignal, createEffect, onCleanup, type Accessor } from \"solid-js\";\nimport { createId, getOwnerDocument } from \"../ssr\";\nimport { type AutocompleteState } from \"@proyecto-viviana/solid-stately\";\n\nexport interface CollectionOptions {\n  /** The id of the collection element. */\n  id?: string;\n  /** Accessible label for the collection. */\n  \"aria-label\"?: string;\n  /** Whether the collection items should use virtual focus instead of being focused directly. */\n  shouldUseVirtualFocus: boolean;\n  /** Whether typeahead is disabled. */\n  disallowTypeAhead: boolean;\n  /** Whether and where to focus an item when the collection mounts. */\n  autoFocus?: boolean | \"first\" | \"last\";\n}\n\nexport interface AutocompleteInputProps {\n  /** Current input value. */\n  value: Accessor<string>;\n  /** Handler for input value changes. */\n  onChange: (value: string) => void;\n  /** Handler for key events. */\n  onKeyDown: (e: KeyboardEvent) => void;\n  /** Handler for focus events. */\n  onFocus: (e: FocusEvent) => void;\n  /** Handler for blur events. */\n  onBlur: (e: FocusEvent) => void;\n  /** The id of the currently focused item for aria-activedescendant. */\n  \"aria-activedescendant\": Accessor<string | undefined>;\n  /** The id of the controlled collection. */\n  \"aria-controls\": string;\n  /** Autocomplete type. */\n  \"aria-autocomplete\": \"list\" | \"none\" | \"inline\" | \"both\";\n  /** Enter key hint for mobile keyboards. */\n  enterKeyHint: \"go\";\n  /** Disable autocorrect. */\n  autoCorrect: \"off\";\n  /** Disable spell check. */\n  spellCheck: \"false\";\n  /** Disable browser autocomplete. */\n  autoComplete: \"off\";\n}\n\nexport interface AriaAutocompleteOptions<_T = unknown> {\n  /** Ref accessor for the input element. */\n  inputRef: Accessor<HTMLInputElement | undefined>;\n  /** Ref accessor for the collection element. */\n  collectionRef: Accessor<HTMLElement | undefined>;\n  /** Optional id override for the controlled collection element. */\n  collectionId?: string;\n  /** Optional accessible name for the controlled collection element. */\n  collectionAriaLabel?: string;\n  /**\n   * An optional filter function used to determine if an option should be included.\n   * @param textValue - The text value of the item\n   * @param inputValue - The current input value\n   */\n  filter?: (textValue: string, inputValue: string) => boolean;\n  /**\n   * Whether to focus the first item after filtering.\n   * @default false\n   */\n  disableAutoFocusFirst?: boolean;\n  /**\n   * Whether to disable virtual focus (aria-activedescendant).\n   * @default false\n   */\n  disableVirtualFocus?: boolean;\n}\n\nexport interface AutocompleteAria<_T = unknown> {\n  /** Props for the autocomplete input element. */\n  inputProps: AutocompleteInputProps;\n  /** Props for the collection (ListBox/Menu). */\n  collectionProps: CollectionOptions;\n  /** A filter function that returns if the item should be shown. */\n  filter?: (textValue: string) => boolean;\n}\n\nfunction toKeyboardEventInit(e: KeyboardEvent): KeyboardEventInit {\n  return {\n    key: e.key,\n    code: e.code,\n    location: e.location,\n    repeat: e.repeat,\n    isComposing: e.isComposing,\n    ctrlKey: e.ctrlKey,\n    shiftKey: e.shiftKey,\n    altKey: e.altKey,\n    metaKey: e.metaKey,\n    bubbles: e.bubbles,\n    cancelable: e.cancelable,\n  };\n}\n\n// Custom event names for collection communication\nexport const AUTOCOMPLETE_FOCUS_EVENT = \"autocomplete:focus\";\nexport const AUTOCOMPLETE_CLEAR_FOCUS_EVENT = \"autocomplete:clearfocus\";\n\n/**\n * Provides the behavior and accessibility implementation for an autocomplete component.\n * An autocomplete combines a text input with a collection, allowing users to filter\n * the collection's contents to match a query.\n *\n * @example\n * ```tsx\n * const state = createAutocompleteState({ defaultInputValue: '' });\n * let inputRef, collectionRef;\n *\n * const { inputProps, collectionProps, filter } = createAutocomplete({\n *   inputRef: () => inputRef,\n *   collectionRef: () => collectionRef,\n *   filter: (textValue, inputValue) =>\n *     textValue.toLowerCase().includes(inputValue.toLowerCase()),\n * }, state);\n *\n * return (\n *   <div>\n *     <input ref={inputRef} {...inputProps} />\n *     <ul ref={collectionRef} {...collectionProps}>\n *       {items.filter(item => filter?.(item.name) ?? true).map(item => (\n *         <li key={item.id}>{item.name}</li>\n *       ))}\n *     </ul>\n *   </div>\n * );\n * ```\n */\nexport function createAutocomplete<T = unknown>(\n  props: AriaAutocompleteOptions<T>,\n  state: AutocompleteState,\n): AutocompleteAria<T> {\n  const {\n    inputRef,\n    collectionRef,\n    filter,\n    collectionId: collectionIdProp,\n    collectionAriaLabel,\n    disableAutoFocusFirst = false,\n    disableVirtualFocus = false,\n  } = props;\n\n  const collectionId = collectionIdProp ?? createId();\n  const [shouldUseVirtualFocus] = createSignal(!disableVirtualFocus);\n  // When the first item should be focused but the collection hasn't mounted yet,\n  // defer it by threading autoFocus through collectionProps so the collection\n  // focuses on mount (mirrors upstream's autoFocusOnMount state).\n  const [autoFocusOnMount, setAutoFocusOnMount] = createSignal(false);\n  let lastInputType = \"\";\n\n  // Track the input type for determining focus behavior. We listen to\n  // `beforeinput` (not `input`) so `lastInputType` is set before the input's\n  // `onChange` runs, mirroring @react-aria/autocomplete.\n  const handleBeforeInput = (e: Event) => {\n    const inputEvent = e as InputEvent;\n    lastInputType = inputEvent.inputType || \"\";\n  };\n\n  // Set up beforeinput event listener\n  createEffect(() => {\n    const input = inputRef();\n    if (input) {\n      input.addEventListener(\"beforeinput\", handleBeforeInput);\n      onCleanup(() => {\n        input.removeEventListener(\"beforeinput\", handleBeforeInput);\n      });\n    }\n  });\n\n  // Focus first item in collection\n  const focusFirstItem = () => {\n    const collection = collectionRef();\n    if (!collection) {\n      // Collection isn't mounted yet — defer focusing the first item to mount\n      // time via collectionProps.autoFocus instead of firing a focus event into\n      // a not-yet-rendered collection.\n      setAutoFocusOnMount(true);\n      return;\n    }\n    collection.dispatchEvent(\n      new CustomEvent(AUTOCOMPLETE_FOCUS_EVENT, {\n        cancelable: true,\n        bubbles: true,\n        detail: { focusStrategy: \"first\" },\n      }),\n    );\n  };\n\n  // Clear virtual focus\n  const clearVirtualFocus = (clearFocusKey = false) => {\n    setAutoFocusOnMount(false);\n    state.setFocusedNodeId(null);\n    const collection = collectionRef();\n    if (collection) {\n      collection.dispatchEvent(\n        new CustomEvent(AUTOCOMPLETE_CLEAR_FOCUS_EVENT, {\n          cancelable: true,\n          bubbles: true,\n          detail: { clearFocusKey },\n        }),\n      );\n    }\n  };\n\n  // Handle input value changes\n  const onChange = (value: string) => {\n    // Focus first item when typing forward, clear when backspacing/pasting.\n    // IME composition (e.g. CJK input) reports 'insertCompositionText'/\n    // 'insertFromComposition' instead of 'insertText'; treat those as forward\n    // typing so the first item still gets virtual focus.\n    if (\n      (lastInputType === \"insertText\" ||\n        lastInputType === \"insertCompositionText\" ||\n        lastInputType === \"insertFromComposition\") &&\n      !disableAutoFocusFirst\n    ) {\n      focusFirstItem();\n    } else if (\n      lastInputType &&\n      (lastInputType.includes(\"insert\") ||\n        lastInputType.includes(\"delete\") ||\n        lastInputType.includes(\"history\"))\n    ) {\n      clearVirtualFocus(true);\n    }\n\n    state.setInputValue(value);\n  };\n\n  // Handle keyboard navigation\n  const onKeyDown = (e: KeyboardEvent) => {\n    if (\"isComposing\" in e && e.isComposing) {\n      return;\n    }\n\n    const focusedNodeId = state.focusedNodeId();\n    const collection = collectionRef();\n    const ownerDocument = getOwnerDocument(inputRef() ?? collection);\n\n    switch (e.key) {\n      case \"Escape\":\n        // Let the input handle Escape (e.g., clear value)\n        if (e.defaultPrevented) {\n          return;\n        }\n        break;\n\n      case \" \":\n        // Space shouldn't trigger item action\n        return;\n\n      case \"Tab\":\n        // Let Tab propagate normally for focus management\n        return;\n\n      case \"ArrowUp\":\n      case \"ArrowDown\":\n      case \"Home\":\n      case \"End\":\n      case \"PageUp\":\n      case \"PageDown\": {\n        // Prevent cursor movement in input\n        e.preventDefault();\n\n        // Dispatch focus event to collection\n        if (collection) {\n          collection.dispatchEvent(\n            new CustomEvent(AUTOCOMPLETE_FOCUS_EVENT, {\n              cancelable: true,\n              bubbles: true,\n            }),\n          );\n        }\n        break;\n      }\n\n      case \"ArrowLeft\":\n      case \"ArrowRight\":\n        // With no virtual focus, just let the arrow move the text cursor; stop\n        // propagation so it doesn't leak into the collection. With virtual focus,\n        // fall through to dispatch the key to the focused item below, then clear\n        // the active descendant only after the item has seen it.\n        if (!focusedNodeId) {\n          e.stopPropagation();\n          return;\n        }\n        break;\n\n      case \"Enter\":\n        // Trigger click on focused item\n        if (focusedNodeId) {\n          const item = ownerDocument?.getElementById(focusedNodeId);\n          if (item) {\n            item.click();\n            e.preventDefault();\n          }\n        }\n        return;\n    }\n\n    // Forward keyboard events to the focused item (or the collection when there\n    // is no virtual focus) so the collection can act on them, e.g. onAction.\n    if (!e.defaultPrevented && collection) {\n      e.stopPropagation();\n\n      let shouldPerformDefaultAction = true;\n      if (focusedNodeId) {\n        const item = ownerDocument?.getElementById(focusedNodeId);\n        if (item) {\n          shouldPerformDefaultAction = item.dispatchEvent(\n            new KeyboardEvent(e.type, toKeyboardEventInit(e)),\n          );\n        }\n      } else {\n        shouldPerformDefaultAction = collection.dispatchEvent(\n          new KeyboardEvent(e.type, toKeyboardEventInit(e)),\n        );\n      }\n\n      // After the focused item has seen ArrowLeft/ArrowRight, clear the active\n      // descendant so SR announcements aren't interrupted, but retain the\n      // collection's focused key so navigation restarts where it left off. If\n      // the item consumed the key (e.g. an expandable row collapsing), it\n      // cancels the event and we keep virtual focus.\n      if (shouldPerformDefaultAction && (e.key === \"ArrowLeft\" || e.key === \"ArrowRight\")) {\n        clearVirtualFocus();\n      }\n    }\n  };\n\n  // Handle focus events\n  const onFocus = (e: FocusEvent) => {\n    if (!e.isTrusted) return;\n\n    // Restore virtual focus when refocusing input\n    const focusedNodeId = state.focusedNodeId();\n    if (focusedNodeId) {\n      const item = document.getElementById(focusedNodeId);\n      if (item) {\n        // Item still exists, keep focus on it\n      }\n    }\n  };\n\n  const onBlur = (e: FocusEvent) => {\n    if (!e.isTrusted) return;\n    // Virtual focus blur handling would go here\n  };\n\n  // Create filter function\n  const filterFn = filter\n    ? (textValue: string) => filter(textValue, state.inputValue())\n    : undefined;\n\n  return {\n    inputProps: {\n      value: state.inputValue,\n      onChange,\n      onKeyDown,\n      onFocus,\n      onBlur,\n      get \"aria-activedescendant\"() {\n        return () => (shouldUseVirtualFocus() ? (state.focusedNodeId() ?? undefined) : undefined);\n      },\n      \"aria-controls\": collectionId,\n      \"aria-autocomplete\": \"list\",\n      enterKeyHint: \"go\",\n      autoCorrect: \"off\",\n      spellCheck: \"false\",\n      autoComplete: \"off\",\n    },\n    collectionProps: {\n      id: collectionId,\n      \"aria-label\": collectionAriaLabel,\n      shouldUseVirtualFocus: shouldUseVirtualFocus(),\n      disallowTypeAhead: shouldUseVirtualFocus(),\n      get autoFocus() {\n        return autoFocusOnMount() ? \"first\" : false;\n      },\n    },\n    filter: filterFn,\n  };\n}\n"],"mappings":"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"}

package/dist/_chunk/autocomplete.jsx

@@ -0,0 +1,196 @@
+import { createId, getOwnerDocument } from "../ssr/index.jsx";
+import { createEffect, createSignal, onCleanup } from "solid-js";
+//#region src/autocomplete/createAutocomplete.ts
+/**
+* createAutocomplete - Accessibility hook for autocomplete components
+*
+* Provides keyboard navigation, virtual focus via aria-activedescendant,
+* and filtering capabilities for autocomplete inputs.
+*
+* Based on @react-aria/autocomplete useAutocomplete.
+*/
+function toKeyboardEventInit(e) {
+	return {
+		key: e.key,
+		code: e.code,
+		location: e.location,
+		repeat: e.repeat,
+		isComposing: e.isComposing,
+		ctrlKey: e.ctrlKey,
+		shiftKey: e.shiftKey,
+		altKey: e.altKey,
+		metaKey: e.metaKey,
+		bubbles: e.bubbles,
+		cancelable: e.cancelable
+	};
+}
+const AUTOCOMPLETE_FOCUS_EVENT = "autocomplete:focus";
+const AUTOCOMPLETE_CLEAR_FOCUS_EVENT = "autocomplete:clearfocus";
+/**
+* Provides the behavior and accessibility implementation for an autocomplete component.
+* An autocomplete combines a text input with a collection, allowing users to filter
+* the collection's contents to match a query.
+*
+* @example
+* ```tsx
+* const state = createAutocompleteState({ defaultInputValue: '' });
+* let inputRef, collectionRef;
+*
+* const { inputProps, collectionProps, filter } = createAutocomplete({
+*   inputRef: () => inputRef,
+*   collectionRef: () => collectionRef,
+*   filter: (textValue, inputValue) =>
+*     textValue.toLowerCase().includes(inputValue.toLowerCase()),
+* }, state);
+*
+* return (
+*   <div>
+*     <input ref={inputRef} {...inputProps} />
+*     <ul ref={collectionRef} {...collectionProps}>
+*       {items.filter(item => filter?.(item.name) ?? true).map(item => (
+*         <li key={item.id}>{item.name}</li>
+*       ))}
+*     </ul>
+*   </div>
+* );
+* ```
+*/
+function createAutocomplete(props, state) {
+	const { inputRef, collectionRef, filter, collectionId: collectionIdProp, collectionAriaLabel, disableAutoFocusFirst = false, disableVirtualFocus = false } = props;
+	const collectionId = collectionIdProp ?? createId();
+	const [shouldUseVirtualFocus] = createSignal(!disableVirtualFocus);
+	const [autoFocusOnMount, setAutoFocusOnMount] = createSignal(false);
+	let lastInputType = "";
+	const handleBeforeInput = (e) => {
+		lastInputType = e.inputType || "";
+	};
+	createEffect(() => {
+		const input = inputRef();
+		if (input) {
+			input.addEventListener("beforeinput", handleBeforeInput);
+			onCleanup(() => {
+				input.removeEventListener("beforeinput", handleBeforeInput);
+			});
+		}
+	});
+	const focusFirstItem = () => {
+		const collection = collectionRef();
+		if (!collection) {
+			setAutoFocusOnMount(true);
+			return;
+		}
+		collection.dispatchEvent(new CustomEvent(AUTOCOMPLETE_FOCUS_EVENT, {
+			cancelable: true,
+			bubbles: true,
+			detail: { focusStrategy: "first" }
+		}));
+	};
+	const clearVirtualFocus = (clearFocusKey = false) => {
+		setAutoFocusOnMount(false);
+		state.setFocusedNodeId(null);
+		const collection = collectionRef();
+		if (collection) collection.dispatchEvent(new CustomEvent(AUTOCOMPLETE_CLEAR_FOCUS_EVENT, {
+			cancelable: true,
+			bubbles: true,
+			detail: { clearFocusKey }
+		}));
+	};
+	const onChange = (value) => {
+		if ((lastInputType === "insertText" || lastInputType === "insertCompositionText" || lastInputType === "insertFromComposition") && !disableAutoFocusFirst) focusFirstItem();
+		else if (lastInputType && (lastInputType.includes("insert") || lastInputType.includes("delete") || lastInputType.includes("history"))) clearVirtualFocus(true);
+		state.setInputValue(value);
+	};
+	const onKeyDown = (e) => {
+		if ("isComposing" in e && e.isComposing) return;
+		const focusedNodeId = state.focusedNodeId();
+		const collection = collectionRef();
+		const ownerDocument = getOwnerDocument(inputRef() ?? collection);
+		switch (e.key) {
+			case "Escape":
+				if (e.defaultPrevented) return;
+				break;
+			case " ": return;
+			case "Tab": return;
+			case "ArrowUp":
+			case "ArrowDown":
+			case "Home":
+			case "End":
+			case "PageUp":
+			case "PageDown":
+				e.preventDefault();
+				if (collection) collection.dispatchEvent(new CustomEvent(AUTOCOMPLETE_FOCUS_EVENT, {
+					cancelable: true,
+					bubbles: true
+				}));
+				break;
+			case "ArrowLeft":
+			case "ArrowRight":
+				if (!focusedNodeId) {
+					e.stopPropagation();
+					return;
+				}
+				break;
+			case "Enter":
+				if (focusedNodeId) {
+					const item = ownerDocument?.getElementById(focusedNodeId);
+					if (item) {
+						item.click();
+						e.preventDefault();
+					}
+				}
+				return;
+		}
+		if (!e.defaultPrevented && collection) {
+			e.stopPropagation();
+			let shouldPerformDefaultAction = true;
+			if (focusedNodeId) {
+				const item = ownerDocument?.getElementById(focusedNodeId);
+				if (item) shouldPerformDefaultAction = item.dispatchEvent(new KeyboardEvent(e.type, toKeyboardEventInit(e)));
+			} else shouldPerformDefaultAction = collection.dispatchEvent(new KeyboardEvent(e.type, toKeyboardEventInit(e)));
+			if (shouldPerformDefaultAction && (e.key === "ArrowLeft" || e.key === "ArrowRight")) clearVirtualFocus();
+		}
+	};
+	const onFocus = (e) => {
+		if (!e.isTrusted) return;
+		const focusedNodeId = state.focusedNodeId();
+		if (focusedNodeId) {
+			if (document.getElementById(focusedNodeId)) {}
+		}
+	};
+	const onBlur = (e) => {
+		if (!e.isTrusted) return;
+	};
+	const filterFn = filter ? (textValue) => filter(textValue, state.inputValue()) : void 0;
+	return {
+		inputProps: {
+			value: state.inputValue,
+			onChange,
+			onKeyDown,
+			onFocus,
+			onBlur,
+			get "aria-activedescendant"() {
+				return () => shouldUseVirtualFocus() ? state.focusedNodeId() ?? void 0 : void 0;
+			},
+			"aria-controls": collectionId,
+			"aria-autocomplete": "list",
+			enterKeyHint: "go",
+			autoCorrect: "off",
+			spellCheck: "false",
+			autoComplete: "off"
+		},
+		collectionProps: {
+			id: collectionId,
+			"aria-label": collectionAriaLabel,
+			shouldUseVirtualFocus: shouldUseVirtualFocus(),
+			disallowTypeAhead: shouldUseVirtualFocus(),
+			get autoFocus() {
+				return autoFocusOnMount() ? "first" : false;
+			}
+		},
+		filter: filterFn
+	};
+}
+//#endregion
+export { AUTOCOMPLETE_FOCUS_EVENT as n, createAutocomplete as r, AUTOCOMPLETE_CLEAR_FOCUS_EVENT as t };
+
+//# sourceMappingURL=autocomplete.jsx.map

package/dist/_chunk/autocomplete.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.jsx","names":["inputEvent"],"sources":["../../src/autocomplete/createAutocomplete.ts"],"sourcesContent":["/**\n * createAutocomplete - Accessibility hook for autocomplete components\n *\n * Provides keyboard navigation, virtual focus via aria-activedescendant,\n * and filtering capabilities for autocomplete inputs.\n *\n * Based on @react-aria/autocomplete useAutocomplete.\n */\n\nimport { createSignal, createEffect, onCleanup, type Accessor } from \"solid-js\";\nimport { createId, getOwnerDocument } from \"../ssr\";\nimport { type AutocompleteState } from \"@proyecto-viviana/solid-stately\";\n\nexport interface CollectionOptions {\n  /** The id of the collection element. */\n  id?: string;\n  /** Accessible label for the collection. */\n  \"aria-label\"?: string;\n  /** Whether the collection items should use virtual focus instead of being focused directly. */\n  shouldUseVirtualFocus: boolean;\n  /** Whether typeahead is disabled. */\n  disallowTypeAhead: boolean;\n  /** Whether and where to focus an item when the collection mounts. */\n  autoFocus?: boolean | \"first\" | \"last\";\n}\n\nexport interface AutocompleteInputProps {\n  /** Current input value. */\n  value: Accessor<string>;\n  /** Handler for input value changes. */\n  onChange: (value: string) => void;\n  /** Handler for key events. */\n  onKeyDown: (e: KeyboardEvent) => void;\n  /** Handler for focus events. */\n  onFocus: (e: FocusEvent) => void;\n  /** Handler for blur events. */\n  onBlur: (e: FocusEvent) => void;\n  /** The id of the currently focused item for aria-activedescendant. */\n  \"aria-activedescendant\": Accessor<string | undefined>;\n  /** The id of the controlled collection. */\n  \"aria-controls\": string;\n  /** Autocomplete type. */\n  \"aria-autocomplete\": \"list\" | \"none\" | \"inline\" | \"both\";\n  /** Enter key hint for mobile keyboards. */\n  enterKeyHint: \"go\";\n  /** Disable autocorrect. */\n  autoCorrect: \"off\";\n  /** Disable spell check. */\n  spellCheck: \"false\";\n  /** Disable browser autocomplete. */\n  autoComplete: \"off\";\n}\n\nexport interface AriaAutocompleteOptions<_T = unknown> {\n  /** Ref accessor for the input element. */\n  inputRef: Accessor<HTMLInputElement | undefined>;\n  /** Ref accessor for the collection element. */\n  collectionRef: Accessor<HTMLElement | undefined>;\n  /** Optional id override for the controlled collection element. */\n  collectionId?: string;\n  /** Optional accessible name for the controlled collection element. */\n  collectionAriaLabel?: string;\n  /**\n   * An optional filter function used to determine if an option should be included.\n   * @param textValue - The text value of the item\n   * @param inputValue - The current input value\n   */\n  filter?: (textValue: string, inputValue: string) => boolean;\n  /**\n   * Whether to focus the first item after filtering.\n   * @default false\n   */\n  disableAutoFocusFirst?: boolean;\n  /**\n   * Whether to disable virtual focus (aria-activedescendant).\n   * @default false\n   */\n  disableVirtualFocus?: boolean;\n}\n\nexport interface AutocompleteAria<_T = unknown> {\n  /** Props for the autocomplete input element. */\n  inputProps: AutocompleteInputProps;\n  /** Props for the collection (ListBox/Menu). */\n  collectionProps: CollectionOptions;\n  /** A filter function that returns if the item should be shown. */\n  filter?: (textValue: string) => boolean;\n}\n\nfunction toKeyboardEventInit(e: KeyboardEvent): KeyboardEventInit {\n  return {\n    key: e.key,\n    code: e.code,\n    location: e.location,\n    repeat: e.repeat,\n    isComposing: e.isComposing,\n    ctrlKey: e.ctrlKey,\n    shiftKey: e.shiftKey,\n    altKey: e.altKey,\n    metaKey: e.metaKey,\n    bubbles: e.bubbles,\n    cancelable: e.cancelable,\n  };\n}\n\n// Custom event names for collection communication\nexport const AUTOCOMPLETE_FOCUS_EVENT = \"autocomplete:focus\";\nexport const AUTOCOMPLETE_CLEAR_FOCUS_EVENT = \"autocomplete:clearfocus\";\n\n/**\n * Provides the behavior and accessibility implementation for an autocomplete component.\n * An autocomplete combines a text input with a collection, allowing users to filter\n * the collection's contents to match a query.\n *\n * @example\n * ```tsx\n * const state = createAutocompleteState({ defaultInputValue: '' });\n * let inputRef, collectionRef;\n *\n * const { inputProps, collectionProps, filter } = createAutocomplete({\n *   inputRef: () => inputRef,\n *   collectionRef: () => collectionRef,\n *   filter: (textValue, inputValue) =>\n *     textValue.toLowerCase().includes(inputValue.toLowerCase()),\n * }, state);\n *\n * return (\n *   <div>\n *     <input ref={inputRef} {...inputProps} />\n *     <ul ref={collectionRef} {...collectionProps}>\n *       {items.filter(item => filter?.(item.name) ?? true).map(item => (\n *         <li key={item.id}>{item.name}</li>\n *       ))}\n *     </ul>\n *   </div>\n * );\n * ```\n */\nexport function createAutocomplete<T = unknown>(\n  props: AriaAutocompleteOptions<T>,\n  state: AutocompleteState,\n): AutocompleteAria<T> {\n  const {\n    inputRef,\n    collectionRef,\n    filter,\n    collectionId: collectionIdProp,\n    collectionAriaLabel,\n    disableAutoFocusFirst = false,\n    disableVirtualFocus = false,\n  } = props;\n\n  const collectionId = collectionIdProp ?? createId();\n  const [shouldUseVirtualFocus] = createSignal(!disableVirtualFocus);\n  // When the first item should be focused but the collection hasn't mounted yet,\n  // defer it by threading autoFocus through collectionProps so the collection\n  // focuses on mount (mirrors upstream's autoFocusOnMount state).\n  const [autoFocusOnMount, setAutoFocusOnMount] = createSignal(false);\n  let lastInputType = \"\";\n\n  // Track the input type for determining focus behavior. We listen to\n  // `beforeinput` (not `input`) so `lastInputType` is set before the input's\n  // `onChange` runs, mirroring @react-aria/autocomplete.\n  const handleBeforeInput = (e: Event) => {\n    const inputEvent = e as InputEvent;\n    lastInputType = inputEvent.inputType || \"\";\n  };\n\n  // Set up beforeinput event listener\n  createEffect(() => {\n    const input = inputRef();\n    if (input) {\n      input.addEventListener(\"beforeinput\", handleBeforeInput);\n      onCleanup(() => {\n        input.removeEventListener(\"beforeinput\", handleBeforeInput);\n      });\n    }\n  });\n\n  // Focus first item in collection\n  const focusFirstItem = () => {\n    const collection = collectionRef();\n    if (!collection) {\n      // Collection isn't mounted yet — defer focusing the first item to mount\n      // time via collectionProps.autoFocus instead of firing a focus event into\n      // a not-yet-rendered collection.\n      setAutoFocusOnMount(true);\n      return;\n    }\n    collection.dispatchEvent(\n      new CustomEvent(AUTOCOMPLETE_FOCUS_EVENT, {\n        cancelable: true,\n        bubbles: true,\n        detail: { focusStrategy: \"first\" },\n      }),\n    );\n  };\n\n  // Clear virtual focus\n  const clearVirtualFocus = (clearFocusKey = false) => {\n    setAutoFocusOnMount(false);\n    state.setFocusedNodeId(null);\n    const collection = collectionRef();\n    if (collection) {\n      collection.dispatchEvent(\n        new CustomEvent(AUTOCOMPLETE_CLEAR_FOCUS_EVENT, {\n          cancelable: true,\n          bubbles: true,\n          detail: { clearFocusKey },\n        }),\n      );\n    }\n  };\n\n  // Handle input value changes\n  const onChange = (value: string) => {\n    // Focus first item when typing forward, clear when backspacing/pasting.\n    // IME composition (e.g. CJK input) reports 'insertCompositionText'/\n    // 'insertFromComposition' instead of 'insertText'; treat those as forward\n    // typing so the first item still gets virtual focus.\n    if (\n      (lastInputType === \"insertText\" ||\n        lastInputType === \"insertCompositionText\" ||\n        lastInputType === \"insertFromComposition\") &&\n      !disableAutoFocusFirst\n    ) {\n      focusFirstItem();\n    } else if (\n      lastInputType &&\n      (lastInputType.includes(\"insert\") ||\n        lastInputType.includes(\"delete\") ||\n        lastInputType.includes(\"history\"))\n    ) {\n      clearVirtualFocus(true);\n    }\n\n    state.setInputValue(value);\n  };\n\n  // Handle keyboard navigation\n  const onKeyDown = (e: KeyboardEvent) => {\n    if (\"isComposing\" in e && e.isComposing) {\n      return;\n    }\n\n    const focusedNodeId = state.focusedNodeId();\n    const collection = collectionRef();\n    const ownerDocument = getOwnerDocument(inputRef() ?? collection);\n\n    switch (e.key) {\n      case \"Escape\":\n        // Let the input handle Escape (e.g., clear value)\n        if (e.defaultPrevented) {\n          return;\n        }\n        break;\n\n      case \" \":\n        // Space shouldn't trigger item action\n        return;\n\n      case \"Tab\":\n        // Let Tab propagate normally for focus management\n        return;\n\n      case \"ArrowUp\":\n      case \"ArrowDown\":\n      case \"Home\":\n      case \"End\":\n      case \"PageUp\":\n      case \"PageDown\": {\n        // Prevent cursor movement in input\n        e.preventDefault();\n\n        // Dispatch focus event to collection\n        if (collection) {\n          collection.dispatchEvent(\n            new CustomEvent(AUTOCOMPLETE_FOCUS_EVENT, {\n              cancelable: true,\n              bubbles: true,\n            }),\n          );\n        }\n        break;\n      }\n\n      case \"ArrowLeft\":\n      case \"ArrowRight\":\n        // With no virtual focus, just let the arrow move the text cursor; stop\n        // propagation so it doesn't leak into the collection. With virtual focus,\n        // fall through to dispatch the key to the focused item below, then clear\n        // the active descendant only after the item has seen it.\n        if (!focusedNodeId) {\n          e.stopPropagation();\n          return;\n        }\n        break;\n\n      case \"Enter\":\n        // Trigger click on focused item\n        if (focusedNodeId) {\n          const item = ownerDocument?.getElementById(focusedNodeId);\n          if (item) {\n            item.click();\n            e.preventDefault();\n          }\n        }\n        return;\n    }\n\n    // Forward keyboard events to the focused item (or the collection when there\n    // is no virtual focus) so the collection can act on them, e.g. onAction.\n    if (!e.defaultPrevented && collection) {\n      e.stopPropagation();\n\n      let shouldPerformDefaultAction = true;\n      if (focusedNodeId) {\n        const item = ownerDocument?.getElementById(focusedNodeId);\n        if (item) {\n          shouldPerformDefaultAction = item.dispatchEvent(\n            new KeyboardEvent(e.type, toKeyboardEventInit(e)),\n          );\n        }\n      } else {\n        shouldPerformDefaultAction = collection.dispatchEvent(\n          new KeyboardEvent(e.type, toKeyboardEventInit(e)),\n        );\n      }\n\n      // After the focused item has seen ArrowLeft/ArrowRight, clear the active\n      // descendant so SR announcements aren't interrupted, but retain the\n      // collection's focused key so navigation restarts where it left off. If\n      // the item consumed the key (e.g. an expandable row collapsing), it\n      // cancels the event and we keep virtual focus.\n      if (shouldPerformDefaultAction && (e.key === \"ArrowLeft\" || e.key === \"ArrowRight\")) {\n        clearVirtualFocus();\n      }\n    }\n  };\n\n  // Handle focus events\n  const onFocus = (e: FocusEvent) => {\n    if (!e.isTrusted) return;\n\n    // Restore virtual focus when refocusing input\n    const focusedNodeId = state.focusedNodeId();\n    if (focusedNodeId) {\n      const item = document.getElementById(focusedNodeId);\n      if (item) {\n        // Item still exists, keep focus on it\n      }\n    }\n  };\n\n  const onBlur = (e: FocusEvent) => {\n    if (!e.isTrusted) return;\n    // Virtual focus blur handling would go here\n  };\n\n  // Create filter function\n  const filterFn = filter\n    ? (textValue: string) => filter(textValue, state.inputValue())\n    : undefined;\n\n  return {\n    inputProps: {\n      value: state.inputValue,\n      onChange,\n      onKeyDown,\n      onFocus,\n      onBlur,\n      get \"aria-activedescendant\"() {\n        return () => (shouldUseVirtualFocus() ? (state.focusedNodeId() ?? undefined) : undefined);\n      },\n      \"aria-controls\": collectionId,\n      \"aria-autocomplete\": \"list\",\n      enterKeyHint: \"go\",\n      autoCorrect: \"off\",\n      spellCheck: \"false\",\n      autoComplete: \"off\",\n    },\n    collectionProps: {\n      id: collectionId,\n      \"aria-label\": collectionAriaLabel,\n      shouldUseVirtualFocus: shouldUseVirtualFocus(),\n      disallowTypeAhead: shouldUseVirtualFocus(),\n      get autoFocus() {\n        return autoFocusOnMount() ? \"first\" : false;\n      },\n    },\n    filter: filterFn,\n  };\n}\n"],"mappings":"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"}